Add FulfillmentInbound V0 back to the library (#645)

Add @deprecated and deprecation notice to API methods marked as such.
Adjust tests and ObjectSerializer to account for the FulfillmentInbound V0 API.

Author: jasonhebert

README.md

@@ -91,10 +91,10 @@ Some minor adjustments were made in the template files for models/api.
 [6.x](https://github.com/amazon-php/sp-api-sdk/tree/6.x) comes with changes to the Fulfillment Inbound API as well as other additions and removals.
 - Additions
   - Fulfillment Inbound API v2024-03-20
+    - This is a major change. The ```v2024-03-20``` version takes the place of the ```V0``` version in namespace whereas the ```V0``` version SDK is now ```FulfillmentInboundV0SDK``` and the ```V0``` models are within the ```Model\FulfillmentInboundV0``` directory.
   - Amazon Warehousing and Distribution API v2024-05-09
   - Application Management API v2023-11-30
 - Removals
-  - Fulfillment Inbound API v0
   - Authorization API
   - FBA Small and Light API
     - You can retrieve the new fees for affected products by using the Product Fees API and/or the relevant FBA and Referral Fee reports.
@@ -108,6 +108,7 @@ Some minor adjustments were made in the template files for models/api.
 - [CatalogItemSDK](/src/AmazonPHP/SellingPartner/Api/CatalogApi/CatalogItemSDK.php)
 - [FBAInboundSDK](/src/AmazonPHP/SellingPartner/Api/FbaInboundApi/FBAInboundSDK.php)
 - [FBAInventorySDK](/src/AmazonPHP/SellingPartner/Api/FbaInventoryApi/FBAInventorySDK.php)
+- [FulfillmentInboundV0SDK](/src/AmazonPHP/SellingPartner/Api/FbaInboundApi/FulfillmentInboundV0SDK.php)
 - [FulfillmentInboundSDK](/src/AmazonPHP/SellingPartner/Api/FbaInboundApi/FulfillmentInboundSDK.php)
 - [FeedsSDK](/src/AmazonPHP/SellingPartner/Api/FeedsApi/FeedsSDK.php)
 - [FinancesSDK](/src/AmazonPHP/SellingPartner/Api/DefaultApi/FinancesSDK.php)

bin/generate.sh

@@ -47,6 +47,14 @@ docker run --user "$(id -u)":"$(id -g)" --rm -v "${PWD}:/sp-api" openapitools/op
     --language-specific-primitives \\DateTimeInterface \
     --type-mappings date=\\DateTimeInterface,Date=\\DateTimeInterface,DateTime=\\DateTimeInterface
 
+docker run --user "$(id -u)":"$(id -g)" --rm -v "${PWD}:/sp-api" openapitools/openapi-generator-cli generate \
+    -i https://raw.githubusercontent.com/amzn/selling-partner-api-models/main/models/fulfillment-inbound-api-model/fulfillmentInboundV0.json \
+    -c /sp-api/config/generator-fulfillment-inbound-v0.yaml \
+    --global-property models,apis,apiDocs=false,modelDocs=false,modelTests=false,apiTests=false,supportingFiles=false \
+    -o /sp-api \
+    --language-specific-primitives \\DateTimeInterface \
+    --type-mappings date=\\DateTimeInterface,Date=\\DateTimeInterface,DateTime=\\DateTimeInterface
+
 docker run --user "$(id -u)":"$(id -g)" --rm -v "${PWD}:/sp-api" openapitools/openapi-generator-cli generate \
     -i https://raw.githubusercontent.com/amzn/selling-partner-api-models/main/models/fulfillment-inbound-api-model/fulfillmentInbound_2024-03-20.json \
     -c /sp-api/config/generator-fulfillment-inbound.yaml \

config/generator-fulfillment-inbound-v0.yaml

@@ -0,0 +1,14 @@
+generatorName: php
+templateDir: sp-api/resources/php-amazon-selling-partner-api
+additionalProperties:
+  invokerPackage: AmazonPHP\SellingPartner
+  srcBasePath: src/AmazonPHP/SellingPartner
+  modelPackage: Model\FulfillmentInboundV0
+  packageName: FulfillmentInboundV0
+files:
+  api.mustache:
+    templateType: API
+    destinationFilename: /FulfillmentInboundV0SDK.php
+  api_interface.mustache:
+    templateType: API
+    destinationFilename: /FulfillmentInboundV0SDKInterface.php

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

@@ -66,14 +66,18 @@ final {{#operations}}class {{packageName}}SDK implements {{packageName}}SDKInter
 {{#allParams}}
      * @param {{{dataType}}}{{^required}}|null{{/required}} ${{paramName}} {{#description}} {{description}}{{/description}}{{^description}} {{paramName}}{{/description}} {{#required}}(required){{/required}}{{^required}}(optional{{#defaultValue}}, default to {{{.}}}{{/defaultValue}}){{/required}}
 {{/allParams}}
-     *
+     *{{#isDeprecated}}
+     * @deprecated
+     *{{/isDeprecated}}
      * @throws ApiException on non-2xx response
      * @throws InvalidArgumentException
      * @return {{#returnType}}{{returnType}}{{/returnType}}{{^returnType}}null{{/returnType}}
      */
     public function {{operationId}}(AccessToken $accessToken, string $region{{^vendorExtensions.x-group-parameters}}{{#allParams}}, ${{paramName}}{{^required}} = {{#defaultValue}}{{{.}}}{{/defaultValue}}{{^defaultValue}}null{{/defaultValue}}{{/required}}{{^-last}}{{/-last}}{{/allParams}}{{/vendorExtensions.x-group-parameters}}{{#vendorExtensions.x-group-parameters}}, $associative_array{{/vendorExtensions.x-group-parameters}})
     {
-        $request = $this->{{operationId}}Request($accessToken, $region{{^vendorExtensions.x-group-parameters}}{{#allParams}}, ${{paramName}}{{^-last}}{{/-last}}{{/allParams}}{{/vendorExtensions.x-group-parameters}}{{#vendorExtensions.x-group-parameters}}, $associative_array{{/vendorExtensions.x-group-parameters}});
+        {{#isDeprecated}}trigger_error('Method ' . __METHOD__ . ' is deprecated', E_USER_DEPRECATED);
+
+        {{/isDeprecated}}$request = $this->{{operationId}}Request($accessToken, $region{{^vendorExtensions.x-group-parameters}}{{#allParams}}, ${{paramName}}{{^-last}}{{/-last}}{{/allParams}}{{/vendorExtensions.x-group-parameters}}{{#vendorExtensions.x-group-parameters}}, $associative_array{{/vendorExtensions.x-group-parameters}});
 
         $this->configuration->extensions()->preRequest('{{packageName}}', '{{operationId}}', $request);