feat!: regenerate PHP SDK from the OpenAPI spec#351
Merged
gjtorikian merged 27 commits intonext-majorfrom Apr 9, 2026
Merged
Conversation
…ookVerification, Actions, SessionManager, PKCEHelper) Adds all missing non-spec endpoint handlers and helper modules: - Passwordless: createSession, sendSession - Vault: 10 KV/key endpoints + client-side AES-GCM encrypt/decrypt - WebhookVerification: verifyEvent, verifyHeader, signature primitives (H01, H02) - Actions: verifyHeader, constructAction, signResponse (H03) - SessionManager: seal/unseal, session auth, refresh, JWKS (H04-H07, H13) - PKCEHelper: PKCE utilities, AuthKit/SSO PKCE URLs, code exchange, public client factory (H08-H11, H15, H16, H19) All files marked with @oagen-ignore-file to survive regeneration. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Actions, WebhookVerification: suppress property.onlyWritten for $client (reserved for future HTTP endpoints) - SessionManager: use strict base64_decode to fix always-false comparison Also includes regenerated WorkOS.php with non-spec service accessors. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
HttpClient, PaginatedResponse, RequestOptions, exception hierarchy, Webhook/WebhookResponse utilities, and TestHelper are now hand-maintained and will no longer be overwritten by oagen regeneration. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Eliminates the deprecation warning about config file detection when passing '.' as a path argument. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Previously 13 tests were skipped due to complex parameter requirements or missing fixtures. All tests now pass with proper model construction and complete fixture coverage. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
gjtorikian
changed the title
Regenerated from spec changes: extracted DirectoryUser/EventContext schemas, SlimRole refs, limit type number->integer, RoleList ref. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
birdcar
approved these changes
Apr 9, 2026
Contributor
birdcar
left a comment
birdcar
left a comment
There was a problem hiding this comment.
I took a look at this and ran it through it's paces / was involved in suggested fixes along the way.
I vote ship it 
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
This branch brings the PHP SDK onto the new v5 surface and runtime.
WorkOSclient with lazy product/service accessors instead of direct top-level class constructionHttpClient,RequestOptions, retry behavior, and granular exception types with request metadataPaginatedResourceand destructured list responses with typedPaginatedResponsemodels plus auto-pagination helpersDateTimeImmutablehydrationRBAC->authorization(),Portal->adminPortal(),MFA->multiFactorAuth(), session helpers ->SessionManager, and separate webhook CRUD from verificationapiKeys(),connect(),events(),featureFlags(),organizationDomains(),pipes(),radar(),actions(),pkce(), expandedvault(), and session management helpersdocs/V5_MIGRATION_GUIDE.mdto document the breaking changes and upgrade path from v4Validation:
composer testcomposer typecheckDocumentation
Does this require changes to the WorkOS Docs? E.g. the API Reference or code snippets need updates.
Migration details are included in
docs/V5_MIGRATION_GUIDE.md. External docs and code snippets should be updated to match the v5 client architecture and renamed APIs before release.