feat!: regenerate the SDK from the enhanced generator

.dockerignore

@@ -2,5 +2,6 @@
 *
 
 # Include only the essential files needed for building the library
-!composer.*
+!composer.json
+!composer.lock
 !lib/

.editorconfig

@@ -3,11 +3,9 @@ root = true
 [*]
 charset = utf-8
 indent_style = space
-indent_size = 2
 end_of_line = lf
 trim_trailing_whitespace = true
 insert_final_newline = true
-max_line_length = 120
 
 [*.php]
-indent_size = 4
+indent_size = 4

.github/workflows/autofix.yml

@@ -34,7 +34,7 @@ jobs:
       - name: Setup PHP
         uses: shivammathur/setup-php@cf4cade2721270509d5b1c766ab3549210a39a2a # v2
         with:
-          php-version: '8.3'
+          php-version: '8.5'
           coverage: none
 
       - name: Install Dependencies

.github/workflows/integration.yml

@@ -19,7 +19,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        php-version: [ '8.3', '8.4', '8.5' ]
+        php-version: [ '8.5' ]
       fail-fast: false
 
     steps:

.github/workflows/linting.yml

@@ -39,7 +39,7 @@ jobs:
       - name: Setup PHP
         uses: shivammathur/setup-php@cf4cade2721270509d5b1c766ab3549210a39a2a # v2
         with:
-          php-version: '8.3'
+          php-version: '8.5'
 
       - name: Install Dependencies
         run: composer install --no-progress --no-interaction --prefer-dist --optimize-autoloader --no-scripts

.github/workflows/qodana.yml

@@ -53,7 +53,6 @@ jobs:
       - name: Run Qodana
         uses: JetBrains/qodana-action@201551778d1453e36c5c0aa26f89a94775cb1acc # v2025.1
         with:
-          args: --baseline,.qodana/qodana.sarif.json
           push-fixes: true
         env:
           QODANA_TOKEN: ${{ secrets.QODANA_TOKEN }}

.github/workflows/release.yml

@@ -44,7 +44,7 @@ jobs:
       - name: Setup PHP
         uses: shivammathur/setup-php@cf4cade2721270509d5b1c766ab3549210a39a2a # v2
         with:
-          php-version: '8.3'
+          php-version: '8.5'
 
       - name: Run semantic-release
         uses: mridang/action-semantic-release@v2

.github/workflows/test.yml

@@ -30,13 +30,15 @@ jobs:
       - name: Setup PHP
         uses: shivammathur/setup-php@cf4cade2721270509d5b1c766ab3549210a39a2a # v2
         with:
-          php-version: '8.3'
+          php-version: '8.5'
 
       - name: Install Dependencies
         run: composer install --no-progress --no-interaction --prefer-dist --optimize-autoloader --no-scripts
 
       - name: Run Tests
         run: composer test
+        env:
+          XDEBUG_MODE: coverage
 
       - name: Generate coverage report
         uses: mridang/action-test-reporter@v1

.github/workflows/typecheck.yml

@@ -33,7 +33,7 @@ jobs:
       - name: Setup PHP
         uses: shivammathur/setup-php@cf4cade2721270509d5b1c766ab3549210a39a2a # v2
         with:
-          php-version: '8.3'
+          php-version: '8.5'
 
       - name: Install Dependencies
         run: composer install --no-progress --no-interaction --prefer-dist --optimize-autoloader --no-scripts

.gitignore

@@ -1,24 +1,24 @@
-# ref: https://github.com/github/gitignore/blob/master/Composer.gitignore
-
-composer.phar
+# Composer dependencies
 /vendor/
 
-# Commit your application's lock file https://getcomposer.org/doc/01-basic-usage.md#commit-your-composer-lock-file-to-version-control
-# You may choose to ignore a library lock file http://getcomposer.org/doc/02-libraries.md#lock-file
-# composer.lock
-
-# php-cs-fixer cache
-.php_cs.cache
-.php-cs-fixer.cache
+# Composer lock file
+composer.lock
 
 # PHPUnit cache
-.phpunit
+.phpunit.cache/
+.phpunit.result.cache
 
-.env
+# Tool caches
+.phpcsf
+.phpstan/
+devbox.d/
 
-devbox.json
-devbox.lock
-.devbox
-package.xml
+# Coverage output
+.out/
+
+# Local secrets / test credentials (never commit)
+.env
 
-.claude
+# Local Claude Code state (never commit)
+.claude/worktrees/
+.claude/settings.local.json

.openapi-generator-ignore

@@ -0,0 +1,71 @@
+# Keep-list: files the generator must NOT overwrite, and the Makefile's
+# `prune` step must NOT delete. Everything else is generator-owned.
+# Sections are shared across all six SDK repos for harmony; sort each
+# section alphabetically (case-insensitive) and keep `!` negations
+# immediately after the broad pattern they refine.
+
+# --- bespoke authenticators (ported onto the generated auth interfaces) ---
+lib/Auth/ClientCredentialsAuthenticator.php
+lib/Auth/ClientCredentialsAuthenticatorBuilder.php
+lib/Auth/NoAuthAuthenticator.php
+lib/Auth/OAuthAuthenticator.php
+lib/Auth/OAuthAuthenticatorBuilder.php
+lib/Auth/OpenId.php
+lib/Auth/PersonalAccessTokenAuthenticator.php
+lib/Auth/WebTokenAuthenticator.php
+lib/Auth/WebTokenAuthenticatorBuilder.php
+
+# --- bespoke tests + fixtures the generator does not emit ---
+etc/
+spec/
+tests/Auth/ClientCredentialsAuthenticatorTest.php
+tests/Auth/NoAuthAuthenticatorTest.php
+tests/Auth/OAuthAuthenticatorTestCase.php
+tests/Auth/PersonalAccessAuthenticatorTest.php
+tests/Auth/WebTokenAuthenticatorTest.php
+tests/fixtures/
+tests/ZitadelTest.php
+
+# --- repo identity + docs (team-owned) ---
+LICENSE
+phpstan.neon
+phpunit.xml
+README.md
+SECURITY.md
+VERSIONING.md
+
+# --- house tooling (team-owned) ---
+.claude/
+.commitlintrc.json
+.dockerignore
+.editorconfig
+.github/
+.gitignore
+.idea/
+.pre-commit-config.yaml
+.releaserc.json
+composer-unused.php
+devbox.json
+devbox.lock
+Dockerfile
+lefthook.yml
+qodana.yaml
+
+# --- build / package config (team-owned) ---
+composer.json
+composer.lock
+composer.phar
+
+# --- generation tooling we added ---
+.openapi-generator-ignore
+Makefile
+proc.yml
+
+# --- generator bookkeeping (FILES manifest + VERSION; rewritten by the
+#     generator but keep-listed so prune does not orphan them — the FILES
+#     manifest does not list itself, so it would otherwise be deleted) ---
+# Only the two bookkeeping files, named individually: excluding the whole
+# directory also excluded DEV-DEPENDENCIES, which the generator must write
+# so this repo's package manifest can stay in step with what its tests import.
+.openapi-generator/FILES
+.openapi-generator/VERSION

.openapi-generator/DEV-DEPENDENCIES

@@ -0,0 +1,4 @@
+nyholm/psr7 ^1.8  # Psr18ApiClientUnitTest
+open-telemetry/sdk ^1.0  # TraceContextUtilTest
+pestphp/pest ^4.0  # every generated test
+testcontainers/testcontainers ^1.0  # the container bootstrap