Fix indirect recursive DTO reference generation

Author: jlevers

resources/models/seller/finances/v2024-06-19.json

@@ -14,14 +14,16 @@
 
 final class Breakdown extends Dto
 {
+    protected static array $complexArrayTypes = ['breakdowns' => Breakdown::class];
+
     /**
      * @param  ?string  $breakdownType  The type of charge.
      * @param  ?Currency  $breakdownAmount  A currency type and amount.
-     * @param  ?Breakdown  $breakdowns  Breakdown provides details regarding the money movement under the financial transaction. Breakdowns get categorized further into breakdown types, breakdown amounts, and further breakdowns into a hierarchical structure.
+     * @param  Breakdown[]|null  $breakdowns  A list of breakdowns that detail how the total amount is calculated for the transaction.
      */
     public function __construct(
         public ?string $breakdownType = null,
         public ?Currency $breakdownAmount = null,
-        public ?Breakdown $breakdowns = null,
+        public ?array $breakdowns = null,
     ) {}
 }

src/Seller/FinancesV20240619/Dto/Breakdown.php

@@ -0,0 +1,23 @@
+<?php
+
+/**
+ * This file is auto-generated by Saloon SDK Generator
+ * Generator: Crescat\SaloonSdkGenerator\Generators\DtoGenerator
+ * Do not modify it directly.
+ */
+
+declare(strict_types=1);
+
+namespace SellingPartnerApi\Seller\FinancesV20240619\Dto;
+
+use SellingPartnerApi\Dto;
+
+final class BusinessContext extends Dto
+{
+    /**
+     * @param  ?string  $storeName  The store name associated with the transaction.
+     */
+    public function __construct(
+        public ?string $storeName = null,
+    ) {}
+}

src/Seller/FinancesV20240619/Dto/BusinessContext.php

@@ -15,7 +15,7 @@
 final class Context extends Dto
 {
     /**
-     * @param  ?string  $storeName  Store name related to transaction.
+     * @param  ?string  $storeName  The store name associated with the transaction.
      * @param  ?string  $orderType  Order type of the transaction.
      * @param  ?string  $channel  Channel details of related transaction.
      * @param  ?string  $asin  Amazon Standard Identification Number (ASIN) of the item.

src/Seller/FinancesV20240619/Dto/Context.php

@@ -24,7 +24,7 @@ final class Item extends Dto
      * @param  ?string  $description  Description of items in the transaction
      * @param  ItemRelatedIdentifier[]|null  $relatedIdentifiers  Related Business identifiers of the item in Transaction.
      * @param  ?Currency  $totalAmount  A currency type and amount.
-     * @param  Breakdown[]|null  $breakdowns  List of breakdowns which will provide the details on how the total amount is calculated for the financial transaction.
+     * @param  Breakdown[]|null  $breakdowns  A list of breakdowns that detail how the total amount is calculated for the transaction.
      * @param  Context[]|null  $contexts  List of additional Information about the item.
      */
     public function __construct(

src/Seller/FinancesV20240619/Dto/Item.php

@@ -15,7 +15,7 @@
 final class MarketplaceDetails extends Dto
 {
     /**
-     * @param  ?string  $marketplaceId  The identifier of the marketplace where the transaction was made.
+     * @param  ?string  $marketplaceId  The identifier of the marketplace where the transaction occurred. The marketplace ID is the globally unique identifier of a marketplace. To find the ID for your marketplace, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).
      * @param  ?string  $marketplaceName  The name of the marketplace where the transaction occurred.
      *
      * Example: 'Amazon.com','Amazon.in'

src/Seller/FinancesV20240619/Dto/MarketplaceDetails.php

@@ -17,7 +17,7 @@ final class SellingPartnerMetadata extends Dto
     /**
      * @param  ?string  $sellingPartnerId  Unique seller identifier.
      * @param  ?string  $accountType  Account type of transaction.
-     * @param  ?string  $marketplaceId  Marketplace identifier of transaction.
+     * @param  ?string  $marketplaceId  The identifier of the marketplace where the transaction occurred. The marketplace ID is the globally unique identifier of a marketplace. To find the ID for your marketplace, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).
      */
     public function __construct(
         public ?string $sellingPartnerId = null,

src/Seller/FinancesV20240619/Dto/SellingPartnerMetadata.php

@@ -36,7 +36,7 @@ final class Transaction extends Dto
      *
      * * `DEFERRED`: the transaction is currently deferred.
      * * `RELEASED`: the transaction is currently released.
-     * * `DEFERRED_RELEASED`: the transaction was deferred in the past, but is now released. Deferred transactions will have their status updated to `DEFERRED_RELEASED` when released.
+     * * `DEFERRED_RELEASED`: the transaction was deferred in the past, but is now released. The status of a deferred transaction is updated to `DEFERRED_RELEASED` when the transaction is released.
      * @param  ?string  $description  Describes the reasons for the transaction.
      *
      * Example: 'Order Payment','Refund Order'
@@ -45,7 +45,7 @@ final class Transaction extends Dto
      * @param  ?MarketplaceDetails  $marketplaceDetails  Information about the marketplace where the transaction occurred.
      * @param  Item[]|null  $items  List of items in the transaction
      * @param  Context[]|null  $contexts  List of additional Information about the item.
-     * @param  Breakdown[]|null  $breakdowns  List of breakdowns which will provide the details on how the total amount is calculated for the financial transaction.
+     * @param  Breakdown[]|null  $breakdowns  A list of breakdowns that detail how the total amount is calculated for the transaction.
      */
     public function __construct(
         public ?SellingPartnerMetadata $sellingPartnerMetadata = null,

src/Seller/FinancesV20240619/Dto/Transaction.php

@@ -0,0 +1,27 @@
+<?php
+
+/**
+ * This file is auto-generated by Saloon SDK Generator
+ * Generator: Crescat\SaloonSdkGenerator\Generators\DtoGenerator
+ * Do not modify it directly.
+ */
+
+declare(strict_types=1);
+
+namespace SellingPartnerApi\Seller\FinancesV20240619\Dto;
+
+use SellingPartnerApi\Dto;
+
+final class TransactionsPayload extends Dto
+{
+    protected static array $complexArrayTypes = ['transactions' => Transaction::class];
+
+    /**
+     * @param  ?string  $nextToken  When present and not empty, pass this string token in the next request to return the next response page.
+     * @param  Transaction[]|null  $transactions  Contains transactions within a given time period.
+     */
+    public function __construct(
+        public ?string $nextToken = null,
+        public ?array $transactions = null,
+    ) {}
+}

src/Seller/FinancesV20240619/Dto/TransactionsPayload.php

@@ -25,15 +25,23 @@ class ListTransactions extends Request
     protected Method $method = Method::GET;
 
     /**
-     * @param  \DateTimeInterface  $postedAfter  A date used for selecting transactions posted after (or at) a specified time. The date-time must be no later than two minutes before the request was submitted, in ISO 8601 date time format.
+     * @param  \DateTimeInterface  $postedAfter  The response includes financial events posted on or after this date. This date must be in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date-time format. The date-time must be more than two minutes before the time of the request.
      * @param  ?\DateTimeInterface  $postedBefore  A date used for selecting transactions posted before (but not at) a specified time. The date-time must be later than PostedAfter and no later than two minutes before the request was submitted, in ISO 8601 date time format. If PostedAfter and PostedBefore are more than 180 days apart, no transactions are returned. You must specify the PostedAfter parameter if you specify the PostedBefore parameter. Default: Now minus two minutes.
-     * @param  ?string  $marketplaceId  A string token used to select Marketplace ID.
+     * @param  ?string  $marketplaceId  The identifier of the marketplace from which you want to retrieve transactions. The marketplace ID is the globally unique identifier of a marketplace. To find the ID for your marketplace, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).
+     * @param  ?string  $transactionStatus  The status of the transaction.
+     *
+     * **Possible values:**
+     *
+     * * `DEFERRED`: the transaction is currently deferred.
+     * * `RELEASED`: the transaction is currently released.
+     * * `DEFERRED_RELEASED`: the transaction was deferred in the past, but is now released. The status of a deferred transaction is updated to `DEFERRED_RELEASED` when the transaction is released.
      * @param  ?string  $nextToken  A string token returned in the response of your previous request.
      */
     public function __construct(
         protected \DateTimeInterface $postedAfter,
         protected ?\DateTimeInterface $postedBefore = null,
         protected ?string $marketplaceId = null,
+        protected ?string $transactionStatus = null,
         protected ?string $nextToken = null,
     ) {}
 
@@ -60,6 +68,7 @@ public function defaultQuery(): array
             'postedAfter' => $this->postedAfter?->format('Y-m-d\TH:i:s\Z'),
             'postedBefore' => $this->postedBefore?->format('Y-m-d\TH:i:s\Z'),
             'marketplaceId' => $this->marketplaceId,
+            'transactionStatus' => $this->transactionStatus,
             'nextToken' => $this->nextToken,
         ]);
     }