Sync API spec with SDK (#7)

Author: vifer

CHANGELOG.md

@@ -8,6 +8,16 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 Check our main [developer changelog](https://developer.paddle.com/?utm_source=dx&utm_medium=paddle-php-sdk) for information about changes to the Paddle Billing platform, the Paddle API, and other developer tools.
 
+## [0.2.1] - 2024-01-24
+
+### Added
+
+- Added `importMeta` to product, price, address, business, customer, discount and subscription entities
+- Added `creditToBalance` to `transaction.details.payoutTotals` and `transaction.details.totals`
+- Added `origin` query parameter to list transactions, see [related changelog](https://developer.paddle.com/changelog/2023/filter-transactions-origin?utm_source=dx&utm_medium=paddle-php-sdk).
+- Added `available_payment_methods` to transaction with includes entity
+- Added `email` query parameter to list customers, see [related changelog](https://developer.paddle.com/changelog/2024/filter-customers-email#filter-customers-by-email-address?utm_source=dx&utm_medium=paddle-php-sdk)
+
 ## [0.2.0] - 2024-01-23
 
 ### Changed
@@ -25,10 +35,10 @@ Check our main [developer changelog](https://developer.paddle.com/?utm_source=dx
 
 ### Added
 
-- Added `available_payment_methods` to [transaction preview and pricing preview](https://developer.paddle.com/changelog/2023/available-payment-methods?utm_source=dx&utm_medium=paddle-node-sdk)
-- Added non-catalog items to [subscriptions](https://developer.paddle.com/changelog/2023/bill-custom-items-one-time-subscription-charge?utm_source=dx&utm_medium=paddle-node-sdk)
-- Added non catalog items to [transactions](https://developer.paddle.com/changelog/2023/add-custom-items-transaction?utm_source=dx&utm_medium=paddle-node-sdk)
-- Added `on_payment_failure` to [subscriptions](https://developer.paddle.com/changelog/2023/payment-failure-behavior-update-subscription?utm_source=dx&utm_medium=paddle-node-sdk)
+- Added `available_payment_methods` to [transaction preview and pricing preview](https://developer.paddle.com/changelog/2023/available-payment-methods?utm_source=dx&utm_medium=paddle-php-sdk)
+- Added non-catalog items to [subscriptions](https://developer.paddle.com/changelog/2023/bill-custom-items-one-time-subscription-charge?utm_source=dx&utm_medium=paddle-php-sdk)
+- Added non catalog items to [transactions](https://developer.paddle.com/changelog/2023/add-custom-items-transaction?utm_source=dx&utm_medium=paddle-php-sdk)
+- Added `on_payment_failure` to [subscriptions](https://developer.paddle.com/changelog/2023/payment-failure-behavior-update-subscription?utm_source=dx&utm_medium=paddle-php-sdk)
 
 ### Fixed
 

src/Client.php

@@ -51,7 +51,7 @@
 
 class Client
 {
-    private const SDK_VERSION = '0.2.0';
+    private const SDK_VERSION = '0.2.1';
 
     public readonly LoggerInterface $logger;
     public readonly Options $options;

src/Entities/Address.php

@@ -13,6 +13,7 @@
 
 use Paddle\SDK\Entities\Shared\CountryCode;
 use Paddle\SDK\Entities\Shared\CustomData;
+use Paddle\SDK\Entities\Shared\ImportMeta;
 use Paddle\SDK\Entities\Shared\Status;
 
 class Address implements Entity
@@ -30,6 +31,7 @@ public function __construct(
         public Status $status,
         public \DateTimeInterface $createdAt,
         public \DateTimeInterface $updatedAt,
+        public ImportMeta|null $importMeta,
     ) {
     }
 
@@ -48,6 +50,7 @@ public static function from(array $data): self
             status: Status::from($data['status']),
             createdAt: DateTime::from($data['created_at']),
             updatedAt: DateTime::from($data['updated_at']),
+            importMeta: isset($data['import_meta']) ? ImportMeta::from($data['import_meta']) : null,
         );
     }
 }

src/Entities/Business.php

@@ -13,6 +13,7 @@
 
 use Paddle\SDK\Entities\Shared\Contacts;
 use Paddle\SDK\Entities\Shared\CustomData;
+use Paddle\SDK\Entities\Shared\ImportMeta;
 use Paddle\SDK\Entities\Shared\Status;
 
 class Business implements Entity
@@ -30,6 +31,7 @@ public function __construct(
         public \DateTimeInterface $createdAt,
         public \DateTimeInterface $updatedAt,
         public CustomData|null $customData,
+        public ImportMeta|null $importMeta,
     ) {
     }
 
@@ -45,6 +47,7 @@ public static function from(array $data): self
             createdAt: DateTime::from($data['created_at']),
             updatedAt: DateTime::from($data['updated_at']),
             customData: isset($data['custom_data']) ? new CustomData($data['custom_data']) : null,
+            importMeta: isset($data['import_meta']) ? ImportMeta::from($data['import_meta']) : null,
         );
     }
 }

src/Entities/Customer.php

@@ -12,6 +12,7 @@
 namespace Paddle\SDK\Entities;
 
 use Paddle\SDK\Entities\Shared\CustomData;
+use Paddle\SDK\Entities\Shared\ImportMeta;
 use Paddle\SDK\Entities\Shared\Status;
 
 class Customer implements Entity
@@ -26,6 +27,7 @@ public function __construct(
         public string $locale,
         public \DateTimeInterface $createdAt,
         public \DateTimeInterface $updatedAt,
+        public ImportMeta|null $importMeta,
     ) {
     }
 
@@ -41,6 +43,7 @@ public static function from(array $data): self
             locale: $data['locale'],
             createdAt: DateTime::from($data['created_at']),
             updatedAt: DateTime::from($data['updated_at']),
+            importMeta: isset($data['import_meta']) ? ImportMeta::from($data['import_meta']) : null,
         );
     }
 }

src/Entities/Discount.php

@@ -14,6 +14,7 @@
 use Paddle\SDK\Entities\Discount\DiscountStatus;
 use Paddle\SDK\Entities\Discount\DiscountType;
 use Paddle\SDK\Entities\Shared\CurrencyCode;
+use Paddle\SDK\Entities\Shared\ImportMeta;
 
 class Discount implements Entity
 {
@@ -34,6 +35,7 @@ public function __construct(
         public int $timesUsed,
         public \DateTimeInterface $createdAt,
         public \DateTimeInterface $updatedAt,
+        public ImportMeta|null $importMeta,
     ) {
     }
 
@@ -56,6 +58,7 @@ public static function from(array $data): self
             timesUsed: $data['times_used'],
             createdAt: DateTime::from($data['created_at']),
             updatedAt: DateTime::from($data['updated_at']),
+            importMeta: isset($data['import_meta']) ? ImportMeta::from($data['import_meta']) : null,
         );
     }
 }

src/Entities/Price.php

@@ -13,6 +13,7 @@
 
 use Paddle\SDK\Entities\Shared\CatalogType;
 use Paddle\SDK\Entities\Shared\CustomData;
+use Paddle\SDK\Entities\Shared\ImportMeta;
 use Paddle\SDK\Entities\Shared\Money;
 use Paddle\SDK\Entities\Shared\PriceQuantity;
 use Paddle\SDK\Entities\Shared\Status;
@@ -39,6 +40,7 @@ public function __construct(
         public PriceQuantity $quantity,
         public Status $status,
         public CustomData|null $customData,
+        public ImportMeta|null $importMeta,
     ) {
     }
 
@@ -61,6 +63,7 @@ public static function from(array $data): self
             quantity: PriceQuantity::from($data['quantity']),
             status: Status::from($data['status']),
             customData: isset($data['custom_data']) ? new CustomData($data['custom_data']) : null,
+            importMeta: isset($data['import_meta']) ? ImportMeta::from($data['import_meta']) : null,
         );
     }
 }

src/Entities/Product.php

@@ -13,6 +13,7 @@
 
 use Paddle\SDK\Entities\Shared\CatalogType;
 use Paddle\SDK\Entities\Shared\CustomData;
+use Paddle\SDK\Entities\Shared\ImportMeta;
 use Paddle\SDK\Entities\Shared\Status;
 use Paddle\SDK\Entities\Shared\TaxCategory;
 
@@ -28,6 +29,7 @@ public function __construct(
         public CustomData|null $customData,
         public Status $status,
         public \DateTimeInterface|null $createdAt,
+        public ImportMeta|null $importMeta,
     ) {
     }
 
@@ -43,6 +45,7 @@ public static function from(array $data): self
             customData: isset($data['custom_data']) ? new CustomData($data['custom_data']) : null,
             status: Status::from($data['status']),
             createdAt: isset($data['created_at']) ? DateTime::from($data['created_at']) : null,
+            importMeta: isset($data['import_meta']) ? ImportMeta::from($data['import_meta']) : null,
         );
     }
 }

src/Entities/Shared/ImportMeta.php

@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * |------
+ * | ! Generated code !
+ * | Altering this code will result in changes being overwritten |
+ * |-------------------------------------------------------------|.
+ */
+
+namespace Paddle\SDK\Entities\Shared;
+
+class ImportMeta
+{
+    public function __construct(
+        public readonly string|null $externalId,
+        public readonly string $importedFrom,
+    ) {
+    }
+
+    public static function from(array $data): self
+    {
+        return new self(
+            externalId: $data['external_id'] ?? null,
+            importedFrom: $data['imported_from'],
+        );
+    }
+}

src/Entities/Shared/TransactionPayoutTotals.php

@@ -24,22 +24,24 @@ public function __construct(
         public string $fee,
         public string $earnings,
         public CurrencyCodePayouts $currencyCode,
+        public string $creditToBalance,
     ) {
     }
 
     public static function from(array $data): self
     {
         return new self(
-            $data['subtotal'],
-            $data['discount'],
-            $data['tax'],
-            $data['total'],
-            $data['credit'],
-            $data['balance'],
-            $data['grand_total'],
-            $data['fee'] ?? null,
-            $data['earnings'] ?? null,
-            CurrencyCodePayouts::from($data['currency_code']),
+            subtotal: $data['subtotal'],
+            discount: $data['discount'],
+            tax: $data['tax'],
+            total: $data['total'],
+            credit: $data['credit'],
+            balance: $data['balance'],
+            grandTotal: $data['grand_total'],
+            fee: $data['fee'] ?? null,
+            earnings: $data['earnings'] ?? null,
+            currencyCode: CurrencyCodePayouts::from($data['currency_code']),
+            creditToBalance: $data['credit_to_balance'],
         );
     }
 }