feat: add missing API methods, local-auth client_credentials support & bug fixes

README.md

@@ -18,6 +18,14 @@ Install the SDK via Composer:
 composer require upsun/upsun-sdk-php
 ```
 
+> **Important**:
+> This SDK relies on PSR interfaces and requires a **PSR-18 HTTP client** implementation at runtime.
+> If your project does not already provide one, install a compatible client, for example:
+>
+> ```bash
+> composer require symfony/http-client
+> ```
+
 Then include Composer's autoloader in your PHP application:
 
 ```php
@@ -26,9 +34,13 @@ require __DIR__ . '/vendor/autoload.php';
 
 ## Authentication
 
-You will need an [Upsun API token](https://docs.upsun.com/administration/cli/api-tokens.html) to use this SDK.
+You will need an [Upsun API token](https://developer.upsun.com/cli/api-tokens) to use this SDK.
 Store it securely, preferably in an environment variable.
 
+### With an API token (default)
+
+Use this outside of an Upsun runtime, authenticating with your API token.
+
 ```php
 use Upsun\UpsunConfig;
 use Upsun\UpsunClient;
@@ -37,6 +49,24 @@ $config = new UpsunConfig(apiToken: getenv('UPSUN_API_TOKEN'));
 $upsunClient = new UpsunClient($config);
 ```
 
+### With the local token service (inside an Upsun container)
+
+Inside an Upsun runtime container, a local token service is exposed on
+`http://localhost:8200`. Point `auth_url` to `UpsunConfig::LOCAL_AUTH` and the SDK
+authenticates with the `client_credentials` grant automatically (no API token
+required). You may optionally request a token lifetime via `tokenTtl` (60-900 seconds).
+
+```php
+use Upsun\UpsunConfig;
+use Upsun\UpsunClient;
+
+$config = new UpsunConfig(
+    auth_url: UpsunConfig::LOCAL_AUTH,
+    tokenTtl: 900, // optional, 60-900 seconds
+);
+$upsunClient = new UpsunClient($config);
+```
+
 ## Usage
 
 ### Example: List organizations
@@ -72,7 +102,7 @@ composer install
 
 The SDK is built as follows:
 
-* From the [JSON specs of our API](https://docs.upsun.com/api/openapispec-upsun.json)
+* From the [JSON specs of our API](https://meta.upsun.com/openapi-spec)
 * Using [``@openapitools/openapi-generator-cli``](https://www.npmjs.com/package/%40openapitools/openapi-generator-cli)
 * Which generates:
   * PHP **Models** (in `src/Model/`)
@@ -82,7 +112,7 @@ The SDK is built as follows:
 ### Regenerating API & Model classes
 
 API and Model classes are generated using [openapi-generator-cli](https://openapi-generator.tech)
-from the [Upsun OpenAPI spec](https://docs.upsun.com/api/openapispec-upsun.json).
+from the [Upsun OpenAPI spec](https://meta.upsun.com/openapi-spec).
 
 ```bash
 composer run spec:install