ci: regenerated with OpenAPI Doc , Speakeasy CLI 1.447.0

.speakeasy/gen.yaml

@@ -39,6 +39,7 @@ php:
     svcName: openapi
   license: MIT License
   maxMethodParams: 3
+  methodArguments: infer-optional-args
   namespace: Shippo\API
   outputModelSuffix: output
   packageName: shippo/shippo-php

.speakeasy/workflow.lock

@@ -1,18 +1,26 @@
-speakeasyVersion: 1.310.0
+speakeasyVersion: 1.447.0
 sources:
     openapi:
         sourceNamespace: openapi
-        sourceRevisionDigest: sha256:3099fc4c926ab05099ea5c4cbb918e6423a03874cea38c8791efa7efbe6c5706
-        sourceBlobDigest: sha256:234f83b39101f22af624857db75abc2440fbe9c279d457ab0a7c8a393245cab1
+        sourceRevisionDigest: sha256:3ed89e9688199620eeaf27fdc08f9408ab9cbc2f8faf60be178c10093f495626
+        sourceBlobDigest: sha256:8c66d55b10c00886e8fd1f2b6ea6b233bccf17f622fed046dcf302d5da3f91f5
         tags:
             - latest
+            - speakeasy-sdk-regen-1731434842
+            - "2018-02-08"
 targets:
     my-first-target:
         source: openapi
         sourceNamespace: openapi
         sourceRevisionDigest: sha256:3099fc4c926ab05099ea5c4cbb918e6423a03874cea38c8791efa7efbe6c5706
         sourceBlobDigest: sha256:234f83b39101f22af624857db75abc2440fbe9c279d457ab0a7c8a393245cab1
-        outLocation: /Users/mike.lueders/dev/shippo-php-sdk
+    php:
+        source: openapi
+        sourceNamespace: openapi
+        sourceRevisionDigest: sha256:3ed89e9688199620eeaf27fdc08f9408ab9cbc2f8faf60be178c10093f495626
+        sourceBlobDigest: sha256:8c66d55b10c00886e8fd1f2b6ea6b233bccf17f622fed046dcf302d5da3f91f5
+        codeSamplesNamespace: openapi-code-samples
+        codeSamplesRevisionDigest: sha256:5c7a248b47fc516df91c80f42177c123c857133f8f1ce4f812d3b04c055ea8a4
 workflow:
     workflowVersion: 1.0.0
     speakeasyVersion: latest
@@ -23,6 +31,14 @@ workflow:
             registry:
                 location: registry.speakeasyapi.dev/shippo/shippo/openapi
     targets:
-        my-first-target:
+        php:
             target: php
             source: openapi
+            publish:
+                packagist:
+                    username: [email protected]
+                    token: $packagist_token
+            codeSamples:
+                registry:
+                    location: registry.speakeasyapi.dev/shippo/shippo/openapi-code-samples
+                blocking: false

.speakeasy/workflow.yaml

@@ -14,3 +14,7 @@ targets:
             packagist:
                 username: [email protected]
                 token: $packagist_token
+        codeSamples:
+            registry:
+                location: registry.speakeasyapi.dev/shippo/shippo/openapi-code-samples
+            blocking: false

CONTRIBUTING.md

@@ -0,0 +1,26 @@
+# Contributing to This Repository
+
+Thank you for your interest in contributing to this repository. Please note that this repository contains generated code. As such, we do not accept direct changes or pull requests. Instead, we encourage you to follow the guidelines below to report issues and suggest improvements.
+
+## How to Report Issues
+
+If you encounter any bugs or have suggestions for improvements, please open an issue on GitHub. When reporting an issue, please provide as much detail as possible to help us reproduce the problem. This includes:
+
+- A clear and descriptive title
+- Steps to reproduce the issue
+- Expected and actual behavior
+- Any relevant logs, screenshots, or error messages
+- Information about your environment (e.g., operating system, software versions)
+    - For example can be collected using the `npx envinfo` command from your terminal if you have Node.js installed
+
+## Issue Triage and Upstream Fixes
+
+We will review and triage issues as quickly as possible. Our goal is to address bugs and incorporate improvements in the upstream source code. Fixes will be included in the next generation of the generated code.
+
+## Contact
+
+If you have any questions or need further assistance, please feel free to reach out by opening an issue.
+
+Thank you for your understanding and cooperation!
+
+The Maintainers

README.md

@@ -34,26 +34,9 @@ Shippo external API.: Use this API to integrate with the Shippo service
 
 The SDK relies on [Composer](https://getcomposer.org/) to manage its dependencies.
 
-To install the SDK first add the below to your `composer.json` file:
-
-```json
-{
-    "repositories": [
-        {
-            "type": "github",
-            "url": "<UNSET>.git"
-        }
-    ],
-    "require": {
-        "Shippo": "*"
-    }
-}
-```
-
-Then run the following command:
-
+To install the SDK and add it as a dependency to an existing `composer.json` file:
 ```bash
-composer update
+composer require "shippo/shippo-php"
 ```
 <!-- End SDK Installation [installation] -->
 
@@ -314,7 +297,7 @@ use Shippo\API;
 $security = '<YOUR_API_KEY_HERE>';
 
 $sdk = API\Shippo::builder()
-    ->setServerURL("https://api.goshippo.com")
+    ->setServerURL('https://api.goshippo.com')
     ->setShippoApiVersion('2018-02-08')
     ->setSecurity($security)->build();
 

RELEASES.md

@@ -0,0 +1,11 @@
+
+
+## 2024-11-26 16:00:28
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.447.0 (2.463.0) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [php v3.0.0-alpha] .
+### Releases
+- [Composer v3.0.0-alpha] https://packagist.org/packages/shippo/shippo-php#v3.0.0-alpha - .

USAGE.md

@@ -1,32 +1,28 @@
 <!-- Start SDK Example Usage [usage] -->
 ```php
-<?php
-
 declare(strict_types=1);
 
 require 'vendor/autoload.php';
 
 use Shippo\API;
-use Shippo\API\Models\Components;
-use Shippo\API\Models\Operations;
 
-$security = new Components\Security();
-$security->apiKeyHeader = '<YOUR_API_KEY_HERE>';
+$security = '<YOUR_API_KEY_HERE>';
 
-$sdk = API\ShippoSDK::builder()
+$sdk = API\Shippo::builder()
     ->setShippoApiVersion('2018-02-08')
-    ->setSecurity($security)
-    ->build();
+    ->setSecurity($security)->build();
 
-try {
-    $response = $sdk->addresses->list(768578, 99895, '2018-02-08');
 
-    if ($response->addressPaginatedList !== null) {
-        // handle response
-    }
-} catch (Throwable $e) {
-    // handle exception
-}
 
+$response = $sdk->addresses->list(
+    page: 1,
+    results: 5,
+    shippoApiVersion: '2018-02-08'
+
+);
+
+if ($response->addressPaginatedList !== null) {
+    // handle response
+}
 ```
 <!-- End SDK Example Usage [usage] -->

composer.json

@@ -1,5 +1,5 @@
 {
-  "name": "shippo/api",
+  "name": "shippo/shippo-php",
   "type": "library",
   "autoload": {
     "psr-4": {
@@ -9,26 +9,31 @@
   "license": "MIT",
   "require": {
     "php": "^8.2",
+    "galbar/jsonpath": "^3.0",
     "guzzlehttp/guzzle": "^7.0",
-    "jms/serializer": "^3.22"
+    "speakeasy/serializer": "^4.0.0",
+    "brick/date-time": "^0.7.0",
+    "phpdocumentor/type-resolver": "^1.8",
+    "brick/math": "^0.12.1"
   },
   "require-dev": {
-    "laravel/pint": "^1.15",
-    "phpstan/phpstan": "^1.9",
+    "laravel/pint": "^1.18.1",
+    "phpstan/phpstan": "^1.12",
     "phpunit/phpunit": "^10",
-    "rector/rector": "^0.18.13",
+    "rector/rector": "^0.19",
     "roave/security-advisories": "dev-latest"
   },
   "minimum-stability": "stable",
   "prefer-stable": true,
   "config": {
     "optimize-autoloader": true,
     "classmap-authoritative": true,
-    "sort-packages": true
+    "sort-packages": true,
+    "process-timeout": 60
   },
   "scripts": {
     "test": [
-      "./vendor/bin/phpunit --testdox"
+      "./vendor/bin/phpunit --testdox --display-warnings --colors=always"
     ],
     "stan": [
       "./vendor/bin/phpstan analyse --memory-limit=2g"