valentina-python-client 2.5.0__tar.gz → 2.7.0__tar.gz

{valentina_python_client-2.5.0 → valentina_python_client-2.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: valentina-python-client
-Version: 2.5.0
+Version: 2.7.0
 Summary: Async Python client library for the Valentina Noir API
 Author: Nate Landau
 Author-email: Nate Landau <github@natenate.org>

{valentina_python_client-2.5.0 → valentina_python_client-2.7.0}/pyproject.toml

@@ -16,7 +16,7 @@
     name = "valentina-python-client"
     readme = "README.md"
     requires-python = ">=3.13"
-    version = "2.5.0"
+    version = "2.7.0"
 
     [project.optional-dependencies]
         testing = ["polyfactory>=3.3.0"]
@@ -37,7 +37,7 @@
         "commitizen>=4.16.3",
         "coverage>=7.14.1",
         "duty>=1.9.0",
-        "prek>=0.4.3",
+        "prek>=0.4.4",
         "pytest-anyio>=0.0.0",
         "pytest-clarity>=1.0.1",
         "pytest-cov>=7.1.0",
@@ -48,14 +48,14 @@
         "pytest-xdist>=3.8.0",
         "pytest>=9.0.3",
         "respx>=0.23.1",
-        "ruff>=0.15.15",
+        "ruff>=0.15.16",
         "shellcheck-py>=0.11.0.1",
-        "ty>=0.0.42",
-        "typos>=1.47.0",
+        "ty>=0.0.44",
+        "typos>=1.47.2",
         "vulture>=2.16",
         "yamllint>=1.38.0",
     ]
-    docs = ["zensical>=0.0.43"]
+    docs = ["zensical>=0.0.44"]
 
 [tool.commitizen]
     bump_message               = "bump(release): v$current_version → v$new_version"
@@ -132,6 +132,7 @@
         ]
         per-file-ignores = { "src/vclient/_sync/**" = [
             "C416",    # Unnecessary list comprehension (AST unparser artifact)
+            "C901",    # Function too complex (noqa stripped by AST codegen)
             "D",       # Docstring formatting (AST unparser doesn't preserve style)
             "E501",    # Line too long
             "ERA001",  # Commented-out code false positives

{valentina_python_client-2.5.0 → valentina_python_client-2.7.0}/src/vclient/__init__.py

@@ -50,10 +50,10 @@ from vclient._sync import (  # noqa: E402
     sync_dicerolls_service,
     sync_dictionary_service,
     sync_global_admin_service,
+    sync_identity_service,
     sync_options_service,
     sync_system_service,
     sync_user_lookup_service,
-    sync_user_self_registration_service,
     sync_users_service,
 )
 from vclient.client import VClient  # noqa: E402
@@ -70,10 +70,10 @@ from vclient.registry import (  # noqa: E402
     dicerolls_service,
     dictionary_service,
     global_admin_service,
+    identity_service,
     options_service,
     system_service,
     user_lookup_service,
-    user_self_registration_service,
     users_service,
 )
 
@@ -92,6 +92,7 @@ __all__ = (
     "dicerolls_service",
     "dictionary_service",
     "global_admin_service",
+    "identity_service",
     "options_service",
     "sync_books_service",
     "sync_campaigns_service",
@@ -105,15 +106,14 @@ __all__ = (
     "sync_dicerolls_service",
     "sync_dictionary_service",
     "sync_global_admin_service",
+    "sync_identity_service",
     "sync_options_service",
     "sync_system_service",
     "sync_user_lookup_service",
-    "sync_user_self_registration_service",
     "sync_users_service",
     "system_service",
     "user_lookup_service",
-    "user_self_registration_service",
     "users_service",
 )
 
-__version__ = "2.5.0"
+__version__ = "2.7.0"

{valentina_python_client-2.5.0 → valentina_python_client-2.7.0}/src/vclient/_codegen.py

@@ -26,10 +26,10 @@ RENAME_CLASSES: dict[str, str] = {
     "DicerollService": "SyncDicerollService",
     "DictionaryService": "SyncDictionaryService",
     "GlobalAdminService": "SyncGlobalAdminService",
+    "IdentityService": "SyncIdentityService",
     "OptionsService": "SyncOptionsService",
     "SystemService": "SyncSystemService",
     "UserLookupService": "SyncUserLookupService",
-    "UserSelfRegistrationService": "SyncUserSelfRegistrationService",
     "UsersService": "SyncUsersService",
     "VClient": "SyncVClient",
     "FakeVClient": "SyncFakeVClient",
@@ -39,6 +39,7 @@ FACTORY_RENAMES: dict[str, str] = {
     "companies_service": "sync_companies_service",
     "developer_service": "sync_developer_service",
     "global_admin_service": "sync_global_admin_service",
+    "identity_service": "sync_identity_service",
     "system_service": "sync_system_service",
     "users_service": "sync_users_service",
     "campaigns_service": "sync_campaigns_service",
@@ -52,7 +53,6 @@ FACTORY_RENAMES: dict[str, str] = {
     "options_service": "sync_options_service",
     "character_autogen_service": "sync_character_autogen_service",
     "user_lookup_service": "sync_user_lookup_service",
-    "user_self_registration_service": "sync_user_self_registration_service",
     "configure_default_client": "sync_configure_default_client",
     "clear_default_client": "sync_clear_default_client",
     "default_client": "sync_default_client",
@@ -78,7 +78,7 @@ IMPORT_REWRITES: dict[str, str] = {
     "vclient.services.options": "vclient._sync.services.options",
     "vclient.services.character_autogen": "vclient._sync.services.character_autogen",
     "vclient.services.user_lookup": "vclient._sync.services.user_lookup",
-    "vclient.services.user_self_registration": "vclient._sync.services.user_self_registration",
+    "vclient.services.identity": "vclient._sync.services.identity",
     "vclient.registry": "vclient._sync.registry",
     "vclient.testing._client": "vclient._sync.testing._client",
 }
@@ -311,10 +311,10 @@ def _write_sync_init(path: Path) -> None:
         "    sync_dicerolls_service,",
         "    sync_dictionary_service,",
         "    sync_global_admin_service,",
+        "    sync_identity_service,",
         "    sync_options_service,",
         "    sync_system_service,",
         "    sync_user_lookup_service,",
-        "    sync_user_self_registration_service,",
         "    sync_users_service,",
         ")",
         "",
@@ -335,10 +335,10 @@ def _write_sync_init(path: Path) -> None:
         '    "sync_dicerolls_service",',
         '    "sync_dictionary_service",',
         '    "sync_global_admin_service",',
+        '    "sync_identity_service",',
         '    "sync_options_service",',
         '    "sync_system_service",',
         '    "sync_user_lookup_service",',
-        '    "sync_user_self_registration_service",',
         '    "sync_users_service",',
         "]",
         "",

{valentina_python_client-2.5.0 → valentina_python_client-2.7.0}/src/vclient/_sync/__init__.py

@@ -17,10 +17,10 @@ from vclient._sync.registry import (
     sync_dicerolls_service,
     sync_dictionary_service,
     sync_global_admin_service,
+    sync_identity_service,
     sync_options_service,
     sync_system_service,
     sync_user_lookup_service,
-    sync_user_self_registration_service,
     sync_users_service,
 )
 
@@ -41,9 +41,9 @@ __all__ = [
     "sync_dicerolls_service",
     "sync_dictionary_service",
     "sync_global_admin_service",
+    "sync_identity_service",
     "sync_options_service",
     "sync_system_service",
     "sync_user_lookup_service",
-    "sync_user_self_registration_service",
     "sync_users_service",
 ]

{valentina_python_client-2.5.0 → valentina_python_client-2.7.0}/src/vclient/_sync/client.py

@@ -35,10 +35,10 @@ if TYPE_CHECKING:
         SyncDicerollService,
         SyncDictionaryService,
         SyncGlobalAdminService,
+        SyncIdentityService,
         SyncOptionsService,
         SyncSystemService,
         SyncUserLookupService,
-        SyncUserSelfRegistrationService,
         SyncUsersService,
     )
 
@@ -322,31 +322,30 @@ class SyncVClient:
             self, company_id=self._resolve_company_id(company_id), on_behalf_of=on_behalf_of
         )
 
-    def user_self_registration(
-        self, *, company_id: str | None = None
-    ) -> "SyncUserSelfRegistrationService":
-        """Get a SyncUserSelfRegistrationService scoped to a specific company.
+    def identity(self, *, company_id: str | None = None) -> "SyncIdentityService":
+        """Get a company-scoped SyncIdentityService.
 
-        Handles user self-registration via SSO onboarding. Does not require
-        an acting user — only developer API key authentication.
+        Resolves verified provider logins (Apple/Google ID tokens,
+        Discord/GitHub access tokens) to canonical users. Does not require
+        an acting user, only developer API key authentication.
 
         Args:
-            company_id: The ID of the company to register users in. If not
+            company_id: The ID of the company to resolve identities in. If not
                 provided, uses the default_company_id from config.
 
         Returns:
-            A SyncUserSelfRegistrationService instance.
+            An SyncIdentityService instance.
 
         Raises:
             ValueError: If no company_id provided and no default configured.
 
         Example:
-            >>> registration = client.user_self_registration()
-            >>> user = await registration.register(username="alice", email="a@b.com")
+            >>> identity = client.identity()
+            >>> result = await identity.identify(provider="google", token="<id-token>")
         """
-        from vclient._sync.services.user_self_registration import SyncUserSelfRegistrationService
+        from vclient._sync.services.identity import SyncIdentityService
 
-        return SyncUserSelfRegistrationService(self, self._resolve_company_id(company_id))
+        return SyncIdentityService(self, self._resolve_company_id(company_id))
 
     def campaigns(
         self, on_behalf_of: str, *, company_id: str | None = None

{valentina_python_client-2.5.0 → valentina_python_client-2.7.0}/src/vclient/_sync/registry.py

@@ -36,10 +36,10 @@ if TYPE_CHECKING:
         SyncDicerollService,
         SyncDictionaryService,
         SyncGlobalAdminService,
+        SyncIdentityService,
         SyncOptionsService,
         SyncSystemService,
         SyncUserLookupService,
-        SyncUserSelfRegistrationService,
         SyncUsersService,
     )
 _default_client: "SyncVClient | None" = None
@@ -195,7 +195,7 @@ def sync_user_lookup_service() -> "SyncUserLookupService":
     """Create a SyncUserLookupService using the default client.
 
     Discover which companies a person has a user record in by searching
-    via email, Discord ID, Google ID, or GitHub ID.
+    via email, Discord ID, Google ID, GitHub ID, or Apple ID.
 
     Returns:
         SyncUserLookupService: A service instance for cross-company user lookup.
@@ -242,20 +242,19 @@ def sync_users_service(on_behalf_of: str, *, company_id: str | None = None) -> "
     return sync_default_client().users(on_behalf_of, company_id=company_id)
 
 
-def sync_user_self_registration_service(
-    *, company_id: str | None = None
-) -> "SyncUserSelfRegistrationService":
-    """Create a SyncUserSelfRegistrationService using the default client.
+def sync_identity_service(*, company_id: str | None = None) -> "SyncIdentityService":
+    """Create a company-scoped SyncIdentityService using the default client.
 
-    Handles user self-registration via SSO onboarding. Does not require
-    an acting user — only developer API key authentication.
+    Resolves verified provider logins (Apple/Google ID tokens, Discord/GitHub
+    access tokens) to canonical users. Does not require an acting user, only
+    developer API key authentication.
 
     Args:
-        company_id: The ID of the company to register users in. If not
+        company_id: The ID of the company to resolve identities in. If not
             provided, uses the default_company_id from the client config.
 
     Returns:
-        SyncUserSelfRegistrationService: A service instance for user self-registration.
+        SyncIdentityService: A service instance for identity resolution.
 
     Raises:
         RuntimeError: If no default client has been configured.
@@ -263,11 +262,11 @@ def sync_user_self_registration_service(
 
     Example:
         ```python
-        registration = sync_user_self_registration_service()
-        user = await registration.register(username="alice", email="a@b.com")
+        identity = sync_identity_service()
+        result = await identity.identify(provider="google", token="<id-token>")
         ```
     """
-    return sync_default_client().user_self_registration(company_id=company_id)
+    return sync_default_client().identity(company_id=company_id)
 
 
 def sync_campaigns_service(

{valentina_python_client-2.5.0 → valentina_python_client-2.7.0}/src/vclient/_sync/services/__init__.py

@@ -14,10 +14,10 @@ from .developers import SyncDeveloperService
 from .dicerolls import SyncDicerollService
 from .dictionary import SyncDictionaryService
 from .global_admin import SyncGlobalAdminService
+from .identity import SyncIdentityService
 from .options import SyncOptionsService
 from .system import SyncSystemService
 from .user_lookup import SyncUserLookupService
-from .user_self_registration import SyncUserSelfRegistrationService
 from .users import SyncUsersService
 
 __all__ = [
@@ -34,9 +34,9 @@ __all__ = [
     "SyncDicerollService",
     "SyncDictionaryService",
     "SyncGlobalAdminService",
+    "SyncIdentityService",
     "SyncOptionsService",
     "SyncSystemService",
     "SyncUserLookupService",
-    "SyncUserSelfRegistrationService",
     "SyncUsersService",
 ]

{valentina_python_client-2.5.0 → valentina_python_client-2.7.0}/src/vclient/_sync/services/base.py

@@ -31,6 +31,7 @@ from vclient.exceptions import (
     RateLimitError,
     RequestValidationError,
     ServerError,
+    UnprocessableEntityError,
     ValidationError,
 )
 from vclient.models.pagination import PaginatedResponse
@@ -278,6 +279,7 @@ class SyncBaseService:
             NotFoundError: For 404 responses.
             ValidationError: For 400 responses.
             ConflictError: For 409 responses.
+            UnprocessableEntityError: For 422 responses.
             RateLimitError: For 429 responses.
             ServerError: For 5xx responses.
             APIError: For other error responses.
@@ -287,10 +289,12 @@ class SyncBaseService:
         status_code = response.status_code
         try:
             response_data = response.json()
-            message = response_data.get("detail", response.text)
-        except (ValueError, KeyError, TypeError):
+        except ValueError:
+            response_data = {}
+        if not isinstance(response_data, dict):
             response_data = {}
-            message = response.text or f"HTTP {status_code}"
+        detail = response_data.get("detail")
+        message = detail if isinstance(detail, str) else response.text or f"HTTP {status_code}"
         self._inject_request_id_fallback(response_data, response)
         error_logger = logger.bind(
             method=method,
@@ -320,6 +324,9 @@ class SyncBaseService:
         if status_code == 409:
             error_logger.warning("Return 409 conflict")
             raise ConflictError(message, status_code, response_data)
+        if status_code == 422:
+            error_logger.warning("Reject with unprocessable entity error")
+            raise UnprocessableEntityError(message, status_code, response_data)
         if HTTP_500_INTERNAL_SERVER_ERROR <= status_code < HTTP_600_UPPER_BOUND:
             raise ServerError(message, status_code, response_data)
         raise APIError(message, status_code, response_data)

{valentina_python_client-2.5.0 → valentina_python_client-2.7.0}/src/vclient/_sync/services/developers.py

@@ -41,7 +41,9 @@ class SyncDeveloperService(SyncBaseService):
         Args:
             request: A MeDeveloperUpdate model, OR pass fields as keyword arguments.
             **kwargs: Fields for MeDeveloperUpdate if request is not provided.
-                Accepts: username (str | None), email (str | None).
+                Accepts: username (str | None), email (str | None),
+                provider_audiences (ProviderAudiences | None): per-provider OIDC
+                audience allowlists ({"apple": [...], "google": [...]}).
 
         Returns:
             The updated MeDeveloper object.

{valentina_python_client-2.5.0 → valentina_python_client-2.7.0}/src/vclient/_sync/services/global_admin.py

@@ -188,7 +188,9 @@ class SyncGlobalAdminService(SyncBaseService):
             request: A DeveloperUpdate model, OR pass fields as keyword arguments.
             **kwargs: Fields for DeveloperUpdate if request is not provided.
                 Accepts: username (str | None), email (str | None),
-                is_global_admin (bool | None).
+                is_global_admin (bool | None),
+                provider_audiences (ProviderAudiences | None): per-provider OIDC
+                audience allowlists ({"apple": [...], "google": [...]}).
 
         Returns:
             The updated Developer object.

valentina_python_client-2.7.0/src/vclient/_sync/services/identity.py

@@ -0,0 +1,78 @@
+# AUTO-GENERATED — do not edit. Run 'uv run duty generate_sync' to regenerate.
+"""Service for verified identity resolution."""
+
+from typing import TYPE_CHECKING
+
+from vclient._sync.services.base import SyncBaseService
+from vclient.endpoints import Endpoints
+from vclient.models import IdentityResolution, UserIdentifyDTO
+
+if TYPE_CHECKING:
+    from vclient._sync.client import SyncVClient
+
+
+class SyncIdentityService(SyncBaseService):
+    """Service for resolving verified provider logins to canonical users.
+
+    Forward the credential obtained from a provider's own login flow (an OIDC
+    ID token for apple/google, an OAuth access token for discord/github). The
+    API verifies the credential with the provider and resolves the user in
+    order: match by provider ID, auto-link by provider-verified email, or
+    create a new UNAPPROVED user.
+
+    This service does not require an acting user (no On-Behalf-Of header).
+    Authentication is via developer API key only.
+
+    Example:
+        >>> async with SyncVClient() as client:
+        ...     identity = client.identity()
+        ...     result = await identity.identify(provider="google", token="<id-token>")
+        ...     print(result.resolution, result.user.id)
+    """
+
+    def __init__(self, client: "SyncVClient", company_id: str) -> None:
+        """Initialize the service scoped to a specific company.
+
+        Args:
+            client: The SyncVClient instance to use for requests.
+            company_id: The ID of the company to resolve identities in.
+        """
+        super().__init__(client)
+        self._company_id = company_id
+
+    def _format_endpoint(self, endpoint: str, **kwargs: str) -> str:
+        """Format an endpoint with the scoped company_id plus any extra params."""
+        return endpoint.format(company_id=self._company_id, **kwargs)
+
+    def identify(self, request: UserIdentifyDTO | None = None, **kwargs) -> IdentityResolution:
+        """Resolve a verified provider login to a canonical user.
+
+        The returned ``resolution`` field reports which path the API took:
+        ``matched`` (an existing user holds this provider identity), ``linked``
+        (the identity was auto-linked onto an existing user by provider-verified
+        email), or ``created`` (a new UNAPPROVED user was registered).
+
+        Args:
+            request: A UserIdentifyDTO model, OR pass fields as keyword arguments.
+            **kwargs: Fields for UserIdentifyDTO if request is not provided.
+                Accepts: provider (IdentityProvider, required), token (str,
+                required), username (str | None), email (str | None). The
+                username and email apply only when a new user is created;
+                email is required there only if the provider supplied none.
+
+        Returns:
+            The IdentityResolution with the resolved user.
+
+        Raises:
+            RequestValidationError: If the input parameters fail client-side validation.
+            UnprocessableEntityError: If the provider token fails verification
+                (code TOKEN_VERIFICATION_FAILED) or creation needs an email the
+                provider did not supply (code EMAIL_REQUIRED).
+            ServerError: If the provider is unreachable (503, code PROVIDER_UNAVAILABLE).
+        """
+        body = request if request is not None else self._validate_request(UserIdentifyDTO, **kwargs)
+        response = self._post(
+            self._format_endpoint(Endpoints.AUTH_IDENTIFY),
+            json=body.model_dump(exclude_none=True, exclude_unset=True, mode="json"),
+        )
+        return IdentityResolution.model_validate(response.json())

{valentina_python_client-2.5.0 → valentina_python_client-2.7.0}/src/vclient/_sync/services/user_lookup.py

@@ -10,7 +10,7 @@ class SyncUserLookupService(SyncBaseService):
     """Service for looking up users across companies.
 
     Discover which companies a person has a user record in by searching
-    via email, Discord ID, Google ID, or GitHub ID.
+    via email, Discord ID, Google ID, GitHub ID, or Apple ID.
 
     Example:
         >>> async with SyncVClient() as client:
@@ -66,3 +66,15 @@ class SyncUserLookupService(SyncBaseService):
         """
         response = self._get(Endpoints.USERS_LOOKUP, params={"github_id": github_id})
         return [UserLookupResult.model_validate(item) for item in response.json()]
+
+    def by_apple_id(self, apple_id: str) -> list[UserLookupResult]:
+        """Look up a user by Apple profile ID.
+
+        Args:
+            apple_id: Apple profile ID to search for.
+
+        Returns:
+            List of companies where a matching user was found. Empty list if no matches.
+        """
+        response = self._get(Endpoints.USERS_LOOKUP, params={"apple_id": apple_id})
+        return [UserLookupResult.model_validate(item) for item in response.json()]

{valentina_python_client-2.5.0 → valentina_python_client-2.7.0}/src/vclient/_sync/services/users.py

@@ -6,7 +6,7 @@ from collections.abc import Iterator, Sequence
 from typing import TYPE_CHECKING
 
 from vclient._sync.services.base import SyncBaseService
-from vclient.constants import DEFAULT_PAGE_LIMIT, UserInclude, UserRole
+from vclient.constants import DEFAULT_PAGE_LIMIT, IdentityProvider, UserInclude, UserRole
 from vclient.endpoints import Endpoints
 from vclient.models import (
     Asset,
@@ -23,6 +23,7 @@ from vclient.models import (
     UserApproveDTO,
     UserCreate,
     UserDetail,
+    UserIdentityLinkDTO,
     UserMergeDTO,
     UserUpdate,
     _ExperienceAddRemove,
@@ -172,6 +173,41 @@ class SyncUsersService(SyncBaseService):
         )
         return User.model_validate(response.json())
 
+    def link_identity(self, user_id: str, *, provider: IdentityProvider, token: str) -> User:
+        """Attach an additional verified provider identity to a user.
+
+        Use for "connect your account" settings flows: a user already
+        authenticated via one provider presents a credential from a second
+        provider, which the API verifies and links to the same user. Only the
+        acting user themselves or a company ADMIN may link identities.
+        Re-linking the same identity is idempotent and refreshes the stored
+        profile.
+
+        Args:
+            user_id: The ID of the user receiving the identity.
+            provider: The identity provider that issued the credential.
+            token: The provider credential (OIDC ID token for apple/google,
+                OAuth access token for discord/github).
+
+        Returns:
+            The updated User object.
+
+        Raises:
+            RequestValidationError: If the input parameters fail client-side validation.
+            AuthorizationError: If the acting user is neither the target user nor an admin.
+            ConflictError: If the identity belongs to another user, or the user
+                already has a different identity from this provider
+                (code IDENTITY_ALREADY_LINKED).
+            UnprocessableEntityError: If the provider token fails verification
+                (code TOKEN_VERIFICATION_FAILED).
+        """
+        body = self._validate_request(UserIdentityLinkDTO, provider=provider, token=token)
+        response = self._post(
+            self._format_endpoint(Endpoints.USER_IDENTITIES, user_id=user_id),
+            json=body.model_dump(exclude_none=True, exclude_unset=True, mode="json"),
+        )
+        return User.model_validate(response.json())
+
     def get_page(
         self,
         *,
@@ -275,20 +311,22 @@ class SyncUsersService(SyncBaseService):
     def create(self, request: UserCreate | None = None, **kwargs) -> User:
         """Create a new user within a company.
 
-        The user is automatically added to the company's user list. The Discord profile
-        is optional and is not used for authentication but is included for Discord bot
-        integration.
+        The user is automatically added to the company's user list.
 
-        The initial ``role`` cannot be ``UNAPPROVED`` (use :meth:`register` for SSO
-        onboarding) or ``DEACTIVATED`` (not a creation path); either will surface as
-        ``ValidationError``.
+        Provider identities (Discord, Google, GitHub, Apple) cannot be set here;
+        any provider-profile values passed are silently ignored. Resolve them
+        through the verified identity endpoints instead
+        (:meth:`SyncIdentityService.identify` or :meth:`SyncUsersService.link_identity`).
+
+        The initial ``role`` cannot be ``UNAPPROVED`` or ``DEACTIVATED`` (not a
+        creation path); either will surface as ``ValidationError``.
 
         Args:
             request: A UserCreate model, OR pass fields as keyword arguments.
             **kwargs: Fields for UserCreate if request is not provided.
                 Accepts: username (str, required), email (str, required),
                 role (UserRole, required),
-                discord_profile (DiscordProfile | None).
+                name_first (str | None), name_last (str | None).
 
         Returns:
             The newly created User object.
@@ -322,9 +360,14 @@ class SyncUsersService(SyncBaseService):
             user_id: The ID of the user to update.
             request: A UserUpdate model, OR pass fields as keyword arguments.
             **kwargs: Fields for UserUpdate if request is not provided.
-                Accepts: name (str | None), email (str | None),
+                Accepts: username (str | None), email (str | None),
                 role (UserRole | None),
-                discord_profile (DiscordProfile | None).
+                name_first (str | None), name_last (str | None).
+
+        Provider identities (Discord, Google, GitHub, Apple) cannot be changed
+        here; any provider-profile values passed are silently ignored. Resolve
+        them through the verified identity endpoints instead
+        (:meth:`SyncIdentityService.identify` or :meth:`SyncUsersService.link_identity`).
 
         Returns:
             The updated User object.

{valentina_python_client-2.5.0 → valentina_python_client-2.7.0}/src/vclient/_sync/testing/_client.py

@@ -164,6 +164,7 @@ class SyncFakeVClient(SyncVClient):
         *,
         status_code: int,
         detail: str | None = None,
+        code: str | None = None,
         params: dict[str, str] | None = None,
     ) -> None:
         """Override a route to return an error response.
@@ -172,6 +173,9 @@ class SyncFakeVClient(SyncVClient):
             route: A ``RouteSpec`` from the ``Routes`` class identifying the endpoint.
             status_code: The HTTP status code to return.
             detail: Optional error detail message. Defaults to ``"Error {status_code}"``.
+            code: Optional machine-readable error code, an RFC 9457 extension
+                member exposed as ``APIError.code`` (e.g.
+                ``"TOKEN_VERIFICATION_FAILED"``). Omitted from the body when not set.
             params: Optional path parameter values to match against. When set,
                 the error override only applies to requests whose URL path segments
                 match all specified values.
@@ -182,4 +186,6 @@ class SyncFakeVClient(SyncVClient):
             "detail": detail or f"Error {status_code}",
             "request_id": request_id,
         }
+        if code is not None:
+            body["code"] = code
         self._router.add_route(method, pattern, json=body, status_code=status_code, params=params)