small fixes

Signed-off-by: Maurice Preuß (envoyr) <hello@envoyr.com>

composer.json

@@ -13,7 +13,7 @@
     }
   ],
   "require": {
-    "php": "^8.0",
+    "php": "^8.1",
     "ext-json": "*",
     "illuminate/support": "^11.0|^12.0",
     "illuminate/console": "^11.0|^12.0",

src/Id/Concerns/MagicProperties.php

@@ -6,12 +6,34 @@ use stdClass;
 
 trait MagicProperties
 {
-    protected function setMagicProperties(stdClass $data): void
+    protected function setMagicProperties(stdClass|array $data): void
     {
-        foreach ($data as $key => $value) {
+        foreach ((object)$data as $key => $value) {
             if (!property_exists($this, $key)) {
                 $this->{$key} = $value;
             }
         }
     }
+
+    /**
+     * Magic getter: return null for undefined properties
+     *
+     * @param string $name
+     * @return mixed|null
+     */
+    public function __get(string $name)
+    {
+        return null;
+    }
+
+    /**
+     * Magic isset: return false for undefined properties
+     *
+     * @param string $name
+     * @return bool
+     */
+    public function __isset(string $name): bool
+    {
+        return false;
+    }
 }

src/Id/Concerns/ManagesInvoices.php

@@ -17,9 +17,9 @@ trait ManagesInvoices
      * @throws RequestRequiresClientIdException
      * @throws GuzzleException
      */
-    public function invoices(): Invoices
+    public function invoices(array $parameters = []): Invoices
     {
-        return (new Invoices($this->request('GET', 'v1/invoices')))
+        return (new Invoices($this->request('GET', 'v1/invoices', [], $parameters)))
             ->setBillable($this);
     }
 }

src/Id/Concerns/ManagesOrders.php

@@ -18,9 +18,9 @@ trait ManagesOrders
      * @throws RequestRequiresClientIdException
      * @throws GuzzleException
      */
-    public function orders(): Orders
+    public function orders(array $parameters = []): Orders
     {
-        return (new Orders($this->request('GET', 'v1/orders')))
+        return (new Orders($this->request('GET', 'v1/orders', [], $parameters)))
             ->setBillable($this);
     }
 }

src/Id/Resources/BaseCollection.php

@@ -2,11 +2,14 @@
 
 namespace Anikeen\Id\Resources;
 
+use Anikeen\Id\Concerns\MagicProperties;
 use Anikeen\Id\Result;
 use JsonSerializable;
 
 abstract class BaseCollection implements JsonSerializable
 {
+    use MagicProperties;
+
     public function __construct(protected Result $result)
     {
         //

src/Id/Resources/Order.php

@@ -102,13 +102,12 @@ class Order extends BaseResource
     /**
      * Get order items from given order.
      *
-     * @param string $orderId The order ID.
      * @throws RequestRequiresClientIdException
      * @throws GuzzleException
      */
-    public function orderItems(string $orderId): OrderItems
+    public function orderItems(array $parameters = []): OrderItems
     {
-        return (new OrderItems($this->billable->request('GET', sprintf('v1/orders/%s/items', $this->id))))
+        return (new OrderItems($this->billable->request('GET', sprintf('v1/orders/%s/items', $this->id), [], $parameters)))
             ->setBillable($this->billable)
             ->setParent($this);
     }

src/Id/Resources/PaymentMethod.php

@@ -4,6 +4,9 @@ namespace Anikeen\Id\Resources;
 
 use Anikeen\Id\Concerns\HasBillable;
 
+/**
+ * @property string $id
+ */
 class PaymentMethod extends BaseResource
 {
     use HasBillable;

src/Id/Resources/PaymentMethods.php

@@ -11,6 +11,8 @@ class PaymentMethods extends BaseCollection
 {
     use HasBillable;
 
+    private ?PaymentMethod $cachedDefaultPaymentMethod = null;
+
     /**
      * Check if current user has at least one payment method.
      *
@@ -30,8 +32,24 @@ class PaymentMethods extends BaseCollection
      */
     public function defaultPaymentMethod(): PaymentMethod
     {
-        return (new PaymentMethod($this->billable->request('GET', 'v1/payment-methods/default')))
+        if ($this->cachedDefaultPaymentMethod === null) {
-            ->setBillable($this->billable);
+            $this->cachedDefaultPaymentMethod = (new PaymentMethod(
+                $this->billable->request('GET', 'v1/payment-methods/default')
+            ))->setBillable($this->billable);
+        }
+
+        return $this->cachedDefaultPaymentMethod;
+    }
+
+    /**
+     * Check if the current user has a default payment method.
+     *
+     * @throws RequestRequiresClientIdException
+     * @throws GuzzleException
+     */
+    public function hasDefaultPaymentMethod(): bool
+    {
+        return $this->defaultPaymentMethod()?->id !== null;
     }
 
     /**

src/Id/Resources/Subscription.php

@@ -8,6 +8,12 @@ use GuzzleHttp\Exception\GuzzleException;
 
 /**
  * @property string $id
+ * @property string $name
+ * @property string $description
+ * @property string $status
+ * @property string $unit
+ * @property float $price
+ * @property string $ends_at
  */
 class Subscription extends BaseResource
 {