Correct templates so that optional request method params are nullable. (#702)

Author: jasonhebert

.github/workflows/automatino-pr-description-validate.yml

@@ -1,8 +1,8 @@
 name: "Automation - PR Description Validate"
 
 on:
-  pull_request:
-    types: ["opened", "edited", "reopened", "ready_for_review"]
+  pull_request_target:
+    types: ["opened", "edited", "reopened", "ready_for_review", "synchronize"]
 
 jobs:
   automation:

.github/workflows/automation-changelog-release.yml

@@ -2,11 +2,10 @@ name: "Automation - Changelog Release"
 
 on:
   push:
-    tags:
-      - '*'
+    tags: [ '*' ]
 
 jobs:
   automation:
     uses: aeon-php/actions/.github/workflows/automation-changelog-release.yml@main
     secrets:
-      automation_github_token: "${{ secrets.GITHUB_TOKEN }}"
+      automation_github_token: "${{ secrets.ACCESS_TOKEN }}"

.github/workflows/automation-changelog-update.yml

@@ -1,6 +1,7 @@
 name: "Automation - Changelog Update"
 
 on:
+  workflow_dispatch:
   push:
     branches:
       - "6.x"
@@ -9,4 +10,4 @@ jobs:
   automation:
     uses: aeon-php/actions/.github/workflows/automation-changelog-update.yml@main
     secrets:
-      automation_github_token: "${{ secrets.GITHUB_TOKEN }}"
+      automation_github_token: "${{ secrets.ACCESS_TOKEN }}"

.github/workflows/automation-release-description-update.yml

@@ -9,4 +9,4 @@ jobs:
   automation:
     uses: aeon-php/actions/.github/workflows/automation-release-description-update.yml@main
     secrets:
-      automation_github_token: "${{ secrets.GITHUB_TOKEN }}"
+      automation_github_token: "${{ secrets.ACCESS_TOKEN }}"

.github/workflows/docs.yml

@@ -14,7 +14,7 @@ jobs:
 
     steps:
       - name: "Checkout"
-        uses: "actions/checkout@v2"
+        uses: "actions/checkout@v4"
 
       - name: "MD Link Linter"
         uses: "docker://norberttech/md-link-linter:latest"

.github/workflows/test-suite.yml

@@ -16,7 +16,7 @@ jobs:
 
     steps:
       - name: "Checkout"
-        uses: "actions/checkout@v2"
+        uses: "actions/checkout@v4"
 
       - name: "Install PHP"
         uses: "shivammathur/setup-php@v2"
@@ -32,7 +32,7 @@ jobs:
           echo "::set-output name=dir::$(composer config cache-files-dir)"
 
       - name: "Cache Composer dependencies"
-        uses: "actions/cache@v2"
+        uses: "actions/cache@v4"
         with:
           path: |
             ${{ steps.composer-cache.outputs.dir }}
@@ -62,7 +62,7 @@ jobs:
 
     steps:
       - name: "Checkout"
-        uses: "actions/checkout@v2"
+        uses: "actions/checkout@v4"
 
       - name: "Install PHP"
         uses: "shivammathur/setup-php@v2"
@@ -78,7 +78,7 @@ jobs:
           echo "::set-output name=dir::$(composer config cache-files-dir)"
 
       - name: "Cache Composer dependencies"
-        uses: "actions/cache@v2"
+        uses: "actions/cache@v4"
         with:
           path: |
             ${{ steps.composer-cache.outputs.dir }}

.github/workflows/update-models.yml

@@ -20,7 +20,7 @@ jobs:
 
     steps:
       - name: "Checkout"
-        uses: "actions/checkout@v2"
+        uses: "actions/checkout@v4"
 
       - name: "Install PHP"
         uses: "shivammathur/setup-php@v2"
@@ -30,7 +30,7 @@ jobs:
           ini-values: memory_limit=-1
 
       - name: "Cache dependencies"
-        uses: "actions/cache@v2"
+        uses: "actions/cache@v4"
         with:
           path: |
             ~/.composer/cache

resources/php-amazon-selling-partner-api/api.mustache

@@ -189,7 +189,7 @@ final {{#operations}}class {{packageName}}SDK implements {{packageName}}SDKInter
      * @param AccessToken $accessToken
      * @param string $region
 {{#allParams}}
-     * @param {{{dataType}}}{{^required}}{{#defaultValue}}{{/defaultValue}}{{^defaultValue}}|null{{/defaultValue}}{{/required}} ${{paramName}} {{#description}} {{description}}{{/description}} {{#required}}(required){{/required}}{{^required}}(optional{{#defaultValue}}, default to {{{.}}}{{/defaultValue}}){{/required}}
+     * @param {{{dataType}}}{{^required}}|null{{/required}} ${{paramName}} {{#description}} {{description}}{{/description}} {{#required}}(required){{/required}}{{^required}}(optional{{#defaultValue}}, default to {{{.}}}{{/defaultValue}}){{/required}}
 {{/allParams}}
      *
      * @throws \{{invokerPackage}}\Exception\InvalidArgumentException

resources/php-amazon-selling-partner-api/api_interface.mustache

@@ -47,7 +47,7 @@ use Psr\Http\Message\RequestInterface;
     * @param AccessToken $accessToken
     * @param string $region
     {{#allParams}}
-    * @param {{{dataType}}}{{^required}}{{#defaultValue}}{{/defaultValue}}{{^defaultValue}}|null{{/defaultValue}}{{/required}} ${{paramName}} {{#description}} {{description}}{{/description}}{{^description}} {{paramName}}{{/description}} {{#required}}(required){{/required}}{{^required}}(optional{{#defaultValue}}, default to {{{.}}}{{/defaultValue}}){{/required}}
+    * @param {{{dataType}}}{{^required}}|null{{/required}} ${{paramName}} {{#description}} {{description}}{{/description}}{{^description}} {{paramName}}{{/description}} {{#required}}(required){{/required}}{{^required}}(optional{{#defaultValue}}, default to {{{.}}}{{/defaultValue}}){{/required}}
     {{/allParams}}
     *
     * @throws ApiException on non-2xx response

src/AmazonPHP/SellingPartner/Api/AwdApi/WarehousingAndDistributionSDK.php

@@ -344,12 +344,12 @@ public function listInboundShipments(AccessToken $accessToken, string $region, ?
      * @param null|string $shipment_status Filter by inbound shipment status. (optional)
      * @param null|\DateTimeInterface $updated_after List the inbound shipments that were updated after a certain time (inclusive). The date must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format. (optional)
      * @param null|\DateTimeInterface $updated_before List the inbound shipments that were updated before a certain time (inclusive). The date must be in <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> format. (optional)
-     * @param int $max_results Maximum number of results to return. (optional, default to 25)
+     * @param null|int $max_results Maximum number of results to return. (optional, default to 25)
      * @param null|string $next_token Token to retrieve the next set of paginated results. (optional)
      *
      * @throws \AmazonPHP\SellingPartner\Exception\InvalidArgumentException
      */
-    public function listInboundShipmentsRequest(AccessToken $accessToken, string $region, ?string $sort_by = null, ?string $sort_order = null, ?string $shipment_status = null, ?\DateTimeInterface $updated_after = null, ?\DateTimeInterface $updated_before = null, int $max_results = 25, ?string $next_token = null) : RequestInterface
+    public function listInboundShipmentsRequest(AccessToken $accessToken, string $region, ?string $sort_by = null, ?string $sort_order = null, ?string $shipment_status = null, ?\DateTimeInterface $updated_after = null, ?\DateTimeInterface $updated_before = null, ?int $max_results = 25, ?string $next_token = null) : RequestInterface
     {
         if ($max_results !== null && $max_results > 200) {
             throw new InvalidArgumentException('invalid value for "$max_results" when calling AwdApi.listInboundShipments, must be smaller than or equal to 200.');
@@ -589,11 +589,11 @@ public function listInventory(AccessToken $accessToken, string $region, ?string
      * @param null|string $sort_order Sort the response in `ASCENDING` or `DESCENDING` order. (optional)
      * @param null|string $details Set to `SHOW` to return summaries with additional inventory details. Defaults to `HIDE,` which returns only inventory summary totals. (optional)
      * @param null|string $next_token Token to retrieve the next set of paginated results. (optional)
-     * @param int $max_results Maximum number of results to return. (optional, default to 25)
+     * @param null|int $max_results Maximum number of results to return. (optional, default to 25)
      *
      * @throws \AmazonPHP\SellingPartner\Exception\InvalidArgumentException
      */
-    public function listInventoryRequest(AccessToken $accessToken, string $region, ?string $sku = null, ?string $sort_order = null, ?string $details = null, ?string $next_token = null, int $max_results = 25) : RequestInterface
+    public function listInventoryRequest(AccessToken $accessToken, string $region, ?string $sku = null, ?string $sort_order = null, ?string $details = null, ?string $next_token = null, ?int $max_results = 25) : RequestInterface
     {
         if ($max_results !== null && $max_results > 200) {
             throw new InvalidArgumentException('invalid value for "$max_results" when calling AwdApi.listInventory, must be smaller than or equal to 200.');