feat: rename client classes to WorkOSClient / AsyncWorkOSClient

Regenerate SDK with Client suffix restored on all client classes.
Also fixes hand-maintained files (session, passwordless, vault,
public_client) and adds TYPE_CHECKING imports for forward-ref
return types. Updates migration guide accordingly.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: gjtorikian

docs/V6_MIGRATION_GUIDE.md

@@ -2,14 +2,14 @@
 
 """WorkOS Python SDK."""
 
-from ._client import AsyncWorkOS, WorkOS
+from ._client import AsyncWorkOSClient, WorkOSClient
 from ._errors import WorkOSError
 from ._pagination import AsyncPage, ListMetadata, SyncPage
 from ._types import RequestOptions
 
 __all__ = [
-    "WorkOS",
-    "AsyncWorkOS",
+    "WorkOSClient",
+    "AsyncWorkOSClient",
     "WorkOSError",
     "SyncPage",
     "AsyncPage",

src/workos/__init__.py

@@ -66,7 +66,7 @@
 RETRY_MULTIPLIER = 2
 
 
-class _BaseWorkOS:
+class _BaseWorkOSClient:
     """Shared WorkOS client implementation."""
 
     def __init__(
@@ -140,7 +140,7 @@ def _calculate_retry_delay(
         attempt: int, retry_after: Optional[str] = None
     ) -> float:
         """Calculate retry delay with exponential backoff and jitter."""
-        parsed_retry_after = _BaseWorkOS._parse_retry_after(retry_after)
+        parsed_retry_after = _BaseWorkOSClient._parse_retry_after(retry_after)
         if parsed_retry_after is not None:
             return parsed_retry_after
         delay = min(INITIAL_RETRY_DELAY * (RETRY_MULTIPLIER**attempt), MAX_RETRY_DELAY)
@@ -253,7 +253,7 @@ def _raise_error(response: httpx.Response) -> None:
         error_class = STATUS_CODE_TO_ERROR.get(response.status_code)
         if error_class:
             if error_class is RateLimitExceededError:
-                retry_after = _BaseWorkOS._parse_retry_after(
+                retry_after = _BaseWorkOSClient._parse_retry_after(
                     response.headers.get("Retry-After")
                 )
                 raise RateLimitExceededError(
@@ -320,7 +320,7 @@ def _raise_error(response: httpx.Response) -> None:
         )
 
 
-class WorkOS(_BaseWorkOS):
+class WorkOSClient(_BaseWorkOSClient):
     """Synchronous WorkOS API client."""
 
     def __init__(
@@ -362,7 +362,7 @@ def close(self) -> None:
         """Close the underlying HTTP client and release resources."""
         self._client.close()
 
-    def __enter__(self) -> "WorkOS":
+    def __enter__(self) -> "WorkOSClient":
         return self
 
     def __exit__(self, exc_type: Any, exc_val: Any, exc_tb: Any) -> None:
@@ -579,7 +579,7 @@ def _fetch(*, after: Optional[str] = None) -> SyncPage[D]:
         return SyncPage(data=items, list_metadata=list_metadata, _fetch_page=_fetch)
 
 
-class AsyncWorkOS(_BaseWorkOS):
+class AsyncWorkOSClient(_BaseWorkOSClient):
     """Asynchronous WorkOS API client."""
 
     def __init__(
@@ -621,7 +621,7 @@ async def close(self) -> None:
         """Close the underlying HTTP client and release resources."""
         await self._client.aclose()
 
-    async def __aenter__(self) -> "AsyncWorkOS":
+    async def __aenter__(self) -> "AsyncWorkOSClient":
         return self
 
     async def __aexit__(self, exc_type: Any, exc_val: Any, exc_tb: Any) -> None:

src/workos/_client.py

@@ -5,7 +5,7 @@
 from typing import TYPE_CHECKING, Any, Dict, Optional, Union
 
 if TYPE_CHECKING:
-    from .._client import AsyncWorkOS, WorkOS
+    from .._client import AsyncWorkOSClient, WorkOSClient
 
 from .._types import RequestOptions, enum_value
 from .models import IntentOptions, PortalLinkResponse
@@ -15,7 +15,7 @@
 class AdminPortal:
     """Admin Portal API resources."""
 
-    def __init__(self, client: "WorkOS") -> None:
+    def __init__(self, client: "WorkOSClient") -> None:
         self._client = client
 
     def generate_link(
@@ -85,7 +85,7 @@ def generate_link(
 class AsyncAdminPortal:
     """Admin Portal API resources (async)."""
 
-    def __init__(self, client: "AsyncWorkOS") -> None:
+    def __init__(self, client: "AsyncWorkOSClient") -> None:
         self._client = client
 
     async def generate_link(

src/workos/admin_portal/_resource.py

@@ -5,7 +5,7 @@
 from typing import TYPE_CHECKING, Any, Dict, List, Optional, Union
 
 if TYPE_CHECKING:
-    from .._client import AsyncWorkOS, WorkOS
+    from .._client import AsyncWorkOSClient, WorkOSClient
 
 from .._types import RequestOptions, enum_value
 from .models import ApiKey, ApiKeyValidationResponse, ApiKeyWithValue
@@ -16,7 +16,7 @@
 class ApiKeys:
     """Api Keys API resources."""
 
-    def __init__(self, client: "WorkOS") -> None:
+    def __init__(self, client: "WorkOSClient") -> None:
         self._client = client
 
     def create_validations(
@@ -176,7 +176,7 @@ def create_organization_api_keys(
 class AsyncApiKeys:
     """Api Keys API resources (async)."""
 
-    def __init__(self, client: "AsyncWorkOS") -> None:
+    def __init__(self, client: "AsyncWorkOSClient") -> None:
         self._client = client
 
     async def create_validations(

src/workos/api_keys/_resource.py

@@ -5,7 +5,7 @@
 from typing import TYPE_CHECKING, Any, Dict, List, Optional, Union
 
 if TYPE_CHECKING:
-    from .._client import AsyncWorkOS, WorkOS
+    from .._client import AsyncWorkOSClient, WorkOSClient
 
 from .._types import RequestOptions, enum_value
 from .models import (
@@ -25,7 +25,7 @@
 class AuditLogs:
     """Audit Logs API resources."""
 
-    def __init__(self, client: "WorkOS") -> None:
+    def __init__(self, client: "WorkOSClient") -> None:
         self._client = client
 
     def list_organization_audit_logs_retention(
@@ -380,7 +380,7 @@ def get_export(
 class AsyncAuditLogs:
     """Audit Logs API resources (async)."""
 
-    def __init__(self, client: "AsyncWorkOS") -> None:
+    def __init__(self, client: "AsyncWorkOSClient") -> None:
         self._client = client
 
     async def list_organization_audit_logs_retention(

src/workos/audit_logs/_resource.py

@@ -5,7 +5,7 @@
 from typing import TYPE_CHECKING, Any, Dict, List, Optional, Union
 
 if TYPE_CHECKING:
-    from .._client import AsyncWorkOS, WorkOS
+    from .._client import AsyncWorkOSClient, WorkOSClient
 
 from .._types import RequestOptions, enum_value
 from .models import (
@@ -26,7 +26,7 @@
 class Authorization:
     """Authorization API resources."""
 
-    def __init__(self, client: "WorkOS") -> None:
+    def __init__(self, client: "WorkOSClient") -> None:
         self._client = client
 
     def check_organization_membership(
@@ -1580,7 +1580,7 @@ def delete_permission(
 class AsyncAuthorization:
     """Authorization API resources (async)."""
 
-    def __init__(self, client: "AsyncWorkOS") -> None:
+    def __init__(self, client: "AsyncWorkOSClient") -> None:
         self._client = client
 
     async def check_organization_membership(

src/workos/authorization/_resource.py

@@ -5,7 +5,7 @@
 from typing import TYPE_CHECKING, Any, Dict, List, Optional, Union, cast
 
 if TYPE_CHECKING:
-    from .._client import AsyncWorkOS, WorkOS
+    from .._client import AsyncWorkOSClient, WorkOSClient
 
 from .._types import RequestOptions, enum_value
 from .models import (
@@ -26,7 +26,7 @@
 class Connect:
     """Connect API resources."""
 
-    def __init__(self, client: "WorkOS") -> None:
+    def __init__(self, client: "WorkOSClient") -> None:
         self._client = client
 
     def complete_oauth2(
@@ -446,7 +446,7 @@ def delete_client_secret(
 class AsyncConnect:
     """Connect API resources (async)."""
 
-    def __init__(self, client: "AsyncWorkOS") -> None:
+    def __init__(self, client: "AsyncWorkOSClient") -> None:
         self._client = client
 
     async def complete_oauth2(

src/workos/connect/_resource.py

@@ -5,7 +5,7 @@
 from typing import TYPE_CHECKING, Optional, Union
 
 if TYPE_CHECKING:
-    from .._client import AsyncWorkOS, WorkOS
+    from .._client import AsyncWorkOSClient, WorkOSClient
 
 from .._types import RequestOptions, enum_value
 from .models import Directory, DirectoryGroup, DirectoryUserWithGroups
@@ -16,7 +16,7 @@
 class DirectorySync:
     """Directory Sync API resources."""
 
-    def __init__(self, client: "WorkOS") -> None:
+    def __init__(self, client: "WorkOSClient") -> None:
         self._client = client
 
     def list_directories(
@@ -309,7 +309,7 @@ def get_directory_user(
 class AsyncDirectorySync:
     """Directory Sync API resources (async)."""
 
-    def __init__(self, client: "AsyncWorkOS") -> None:
+    def __init__(self, client: "AsyncWorkOSClient") -> None:
         self._client = client
 
     async def list_directories(

src/workos/directory_sync/_resource.py

@@ -5,7 +5,7 @@
 from typing import TYPE_CHECKING, List, Optional, Union
 
 if TYPE_CHECKING:
-    from .._client import AsyncWorkOS, WorkOS
+    from .._client import AsyncWorkOSClient, WorkOSClient
 
 from .._types import RequestOptions, enum_value
 from .models import EventSchema
@@ -16,7 +16,7 @@
 class Events:
     """Events API resources."""
 
-    def __init__(self, client: "WorkOS") -> None:
+    def __init__(self, client: "WorkOSClient") -> None:
         self._client = client
 
     def list_events(
@@ -83,7 +83,7 @@ def list_events(
 class AsyncEvents:
     """Events API resources (async)."""
 
-    def __init__(self, client: "AsyncWorkOS") -> None:
+    def __init__(self, client: "AsyncWorkOSClient") -> None:
         self._client = client
 
     async def list_events(