auth0-python 5.0.0b0__py3-none-any.whl → 5.2.0__py3-none-any.whl

auth0/authentication/base.py

@@ -2,11 +2,10 @@ from __future__ import annotations
 
 from typing import Any
 
+from .client_authentication import add_client_authentication
 from .rest import RestClient, RestClientOptions
 from .types import RequestData, TimeoutType
 
-from .client_authentication import add_client_authentication
-
 UNKNOWN_ERROR = "a0.sdk.internal.unknown"
 
 
@@ -22,6 +21,9 @@ class AuthenticationBase:
         telemetry (bool, optional): Enable or disable telemetry (defaults to True)
         timeout (float or tuple, optional): Change the requests connect and read timeout. Pass a tuple to specify both values separately or a float to set both to it. (defaults to 5.0 for both)
         protocol (str, optional): Useful for testing. (defaults to 'https')
+        client_info (dict, optional): Custom telemetry data for the Auth0-Client header.
+            When provided, overrides the default SDK telemetry. Useful for wrapper
+            SDKs that need to identify themselves. Ignored when telemetry is False.
     """
 
     def __init__(
@@ -34,6 +36,7 @@ class AuthenticationBase:
         telemetry: bool = True,
         timeout: TimeoutType = 5.0,
         protocol: str = "https",
+        client_info: dict[str, Any] | None = None,
     ) -> None:
         self.domain = domain
         self.client_id = client_id
@@ -43,7 +46,9 @@ class AuthenticationBase:
         self.protocol = protocol
         self.client = RestClient(
             None,
-            options=RestClientOptions(telemetry=telemetry, timeout=timeout, retries=0),
+            options=RestClientOptions(
+                telemetry=telemetry, timeout=timeout, retries=0, client_info=client_info
+            ),
         )
 
     def _add_client_authentication(self, payload: dict[str, Any]) -> dict[str, Any]:

auth0/authentication/rest.py

@@ -10,7 +10,6 @@ from typing import TYPE_CHECKING, Any, Mapping
 from urllib.parse import urlencode
 
 import requests
-
 from .exceptions import Auth0Error, RateLimitError
 from .types import RequestData, TimeoutType
 
@@ -38,6 +37,13 @@ class RestClientOptions:
             times using an exponential backoff strategy, before
             raising a RateLimitError exception. 10 retries max.
             (defaults to 3)
+        client_info (dict, optional): Custom telemetry data to send
+            in the Auth0-Client header instead of the default SDK
+            info. Useful for wrapper SDKs that need to identify
+            themselves. When provided, this dict is JSON-encoded
+            and base64-encoded as the header value. Ignored when
+            telemetry is False.
+            (defaults to None)
     """
 
     def __init__(
@@ -45,10 +51,12 @@ class RestClientOptions:
         telemetry: bool = True,
         timeout: TimeoutType = 5.0,
         retries: int = 3,
+        client_info: dict[str, Any] | None = None,
     ) -> None:
         self.telemetry = telemetry
         self.timeout = timeout
         self.retries = retries
+        self.client_info = client_info
 
 
 class RestClient:
@@ -94,17 +102,20 @@ class RestClient:
 
         if options.telemetry:
             py_version = platform.python_version()
-            version = sys.modules["auth0"].__version__
 
-            auth0_client = dumps(
-                {
+            if options.client_info is not None:
+                auth0_client_dict = options.client_info
+            else:
+                version = sys.modules["auth0"].__version__
+                auth0_client_dict = {
                     "name": "auth0-python",
                     "version": version,
                     "env": {
                         "python": py_version,
                     },
                 }
-            ).encode("utf-8")
+
+            auth0_client = dumps(auth0_client_dict).encode("utf-8")
 
             self.base_headers.update(
                 {

auth0/management/__init__.py

@@ -1215,6 +1215,7 @@ if typing.TYPE_CHECKING:
     from .client import AsyncAuth0, Auth0
     from .environment import Auth0Environment
     from .event_streams import EventStreamsCreateRequest
+    from .management_client import AsyncManagementClient, ManagementClient
     from .version import __version__
 _dynamic_imports: typing.Dict[str, str] = {
     "Action": ".types",
@@ -3340,6 +3341,8 @@ __all__ = [
     "LogStreamSumoEnum",
     "LogStreamSumoResponseSchema",
     "LogStreamSumoSink",
+    "ManagementClient",
+    "AsyncManagementClient",
     "MdlPresentationProperties",
     "MdlPresentationRequest",
     "MdlPresentationRequestProperties",

auth0/management/actions/__init__.py

@@ -6,9 +6,10 @@ import typing
 from importlib import import_module
 
 if typing.TYPE_CHECKING:
-    from . import executions, triggers, versions
+    from . import executions, modules, triggers, versions
 _dynamic_imports: typing.Dict[str, str] = {
     "executions": ".executions",
+    "modules": ".modules",
     "triggers": ".triggers",
     "versions": ".versions",
 }
@@ -35,4 +36,4 @@ def __dir__():
     return sorted(lazy_attrs)
 
 
-__all__ = ["executions", "triggers", "versions"]
+__all__ = ["executions", "modules", "triggers", "versions"]

auth0/management/actions/client.py

@@ -8,6 +8,7 @@ from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
 from ..core.pagination import AsyncPager, SyncPager
 from ..core.request_options import RequestOptions
 from ..types.action import Action
+from ..types.action_module_reference import ActionModuleReference
 from ..types.action_secret_request import ActionSecretRequest
 from ..types.action_trigger import ActionTrigger
 from ..types.action_trigger_type_enum import ActionTriggerTypeEnum
@@ -23,6 +24,7 @@ from .raw_client import AsyncRawActionsClient, RawActionsClient
 
 if typing.TYPE_CHECKING:
     from .executions.client import AsyncExecutionsClient, ExecutionsClient
+    from .modules.client import AsyncModulesClient, ModulesClient
     from .triggers.client import AsyncTriggersClient, TriggersClient
     from .versions.client import AsyncVersionsClient, VersionsClient
 # this is used as the default value for optional parameters
@@ -35,6 +37,7 @@ class ActionsClient:
         self._client_wrapper = client_wrapper
         self._versions: typing.Optional[VersionsClient] = None
         self._executions: typing.Optional[ExecutionsClient] = None
+        self._modules: typing.Optional[ModulesClient] = None
         self._triggers: typing.Optional[TriggersClient] = None
 
     @property
@@ -124,13 +127,14 @@ class ActionsClient:
     def create(
         self,
         *,
-        name: str = "my-action",
+        name: str,
         supported_triggers: typing.Sequence[ActionTrigger],
-        code: typing.Optional[str] = "module.exports = () => {}",
+        code: typing.Optional[str] = OMIT,
         dependencies: typing.Optional[typing.Sequence[ActionVersionDependency]] = OMIT,
-        runtime: typing.Optional[str] = "node22",
+        runtime: typing.Optional[str] = OMIT,
         secrets: typing.Optional[typing.Sequence[ActionSecretRequest]] = OMIT,
-        deploy: typing.Optional[bool] = False,
+        modules: typing.Optional[typing.Sequence[ActionModuleReference]] = OMIT,
+        deploy: typing.Optional[bool] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> CreateActionResponseContent:
         """
@@ -156,6 +160,9 @@ class ActionsClient:
         secrets : typing.Optional[typing.Sequence[ActionSecretRequest]]
             The list of secrets that are included in an action or a version of an action.
 
+        modules : typing.Optional[typing.Sequence[ActionModuleReference]]
+            The list of action modules and their versions used by this action.
+
         deploy : typing.Optional[bool]
             True if the action should be deployed after creation.
 
@@ -190,6 +197,7 @@ class ActionsClient:
             dependencies=dependencies,
             runtime=runtime,
             secrets=secrets,
+            modules=modules,
             deploy=deploy,
             request_options=request_options,
         )
@@ -266,12 +274,13 @@ class ActionsClient:
         self,
         id: str,
         *,
-        name: typing.Optional[str] = "my-action",
+        name: typing.Optional[str] = OMIT,
         supported_triggers: typing.Optional[typing.Sequence[ActionTrigger]] = OMIT,
-        code: typing.Optional[str] = "module.exports = () => {}",
+        code: typing.Optional[str] = OMIT,
         dependencies: typing.Optional[typing.Sequence[ActionVersionDependency]] = OMIT,
-        runtime: typing.Optional[str] = "node22",
+        runtime: typing.Optional[str] = OMIT,
         secrets: typing.Optional[typing.Sequence[ActionSecretRequest]] = OMIT,
+        modules: typing.Optional[typing.Sequence[ActionModuleReference]] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> UpdateActionResponseContent:
         """
@@ -300,6 +309,9 @@ class ActionsClient:
         secrets : typing.Optional[typing.Sequence[ActionSecretRequest]]
             The list of secrets that are included in an action or a version of an action.
 
+        modules : typing.Optional[typing.Sequence[ActionModuleReference]]
+            The list of action modules and their versions used by this action.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -327,6 +339,7 @@ class ActionsClient:
             dependencies=dependencies,
             runtime=runtime,
             secrets=secrets,
+            modules=modules,
             request_options=request_options,
         )
         return _response.data
@@ -416,6 +429,14 @@ class ActionsClient:
             self._executions = ExecutionsClient(client_wrapper=self._client_wrapper)
         return self._executions
 
+    @property
+    def modules(self):
+        if self._modules is None:
+            from .modules.client import ModulesClient  # noqa: E402
+
+            self._modules = ModulesClient(client_wrapper=self._client_wrapper)
+        return self._modules
+
     @property
     def triggers(self):
         if self._triggers is None:
@@ -431,6 +452,7 @@ class AsyncActionsClient:
         self._client_wrapper = client_wrapper
         self._versions: typing.Optional[AsyncVersionsClient] = None
         self._executions: typing.Optional[AsyncExecutionsClient] = None
+        self._modules: typing.Optional[AsyncModulesClient] = None
         self._triggers: typing.Optional[AsyncTriggersClient] = None
 
     @property
@@ -529,13 +551,14 @@ class AsyncActionsClient:
     async def create(
         self,
         *,
-        name: str = "my-action",
+        name: str,
         supported_triggers: typing.Sequence[ActionTrigger],
-        code: typing.Optional[str] = "module.exports = () => {}",
+        code: typing.Optional[str] = OMIT,
         dependencies: typing.Optional[typing.Sequence[ActionVersionDependency]] = OMIT,
-        runtime: typing.Optional[str] = "node22",
+        runtime: typing.Optional[str] = OMIT,
         secrets: typing.Optional[typing.Sequence[ActionSecretRequest]] = OMIT,
-        deploy: typing.Optional[bool] = False,
+        modules: typing.Optional[typing.Sequence[ActionModuleReference]] = OMIT,
+        deploy: typing.Optional[bool] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> CreateActionResponseContent:
         """
@@ -561,6 +584,9 @@ class AsyncActionsClient:
         secrets : typing.Optional[typing.Sequence[ActionSecretRequest]]
             The list of secrets that are included in an action or a version of an action.
 
+        modules : typing.Optional[typing.Sequence[ActionModuleReference]]
+            The list of action modules and their versions used by this action.
+
         deploy : typing.Optional[bool]
             True if the action should be deployed after creation.
 
@@ -603,6 +629,7 @@ class AsyncActionsClient:
             dependencies=dependencies,
             runtime=runtime,
             secrets=secrets,
+            modules=modules,
             deploy=deploy,
             request_options=request_options,
         )
@@ -697,12 +724,13 @@ class AsyncActionsClient:
         self,
         id: str,
         *,
-        name: typing.Optional[str] = "my-action",
+        name: typing.Optional[str] = OMIT,
         supported_triggers: typing.Optional[typing.Sequence[ActionTrigger]] = OMIT,
-        code: typing.Optional[str] = "module.exports = () => {}",
+        code: typing.Optional[str] = OMIT,
         dependencies: typing.Optional[typing.Sequence[ActionVersionDependency]] = OMIT,
-        runtime: typing.Optional[str] = "node22",
+        runtime: typing.Optional[str] = OMIT,
         secrets: typing.Optional[typing.Sequence[ActionSecretRequest]] = OMIT,
+        modules: typing.Optional[typing.Sequence[ActionModuleReference]] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> UpdateActionResponseContent:
         """
@@ -731,6 +759,9 @@ class AsyncActionsClient:
         secrets : typing.Optional[typing.Sequence[ActionSecretRequest]]
             The list of secrets that are included in an action or a version of an action.
 
+        modules : typing.Optional[typing.Sequence[ActionModuleReference]]
+            The list of action modules and their versions used by this action.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -766,6 +797,7 @@ class AsyncActionsClient:
             dependencies=dependencies,
             runtime=runtime,
             secrets=secrets,
+            modules=modules,
             request_options=request_options,
         )
         return _response.data
@@ -871,6 +903,14 @@ class AsyncActionsClient:
             self._executions = AsyncExecutionsClient(client_wrapper=self._client_wrapper)
         return self._executions
 
+    @property
+    def modules(self):
+        if self._modules is None:
+            from .modules.client import AsyncModulesClient  # noqa: E402
+
+            self._modules = AsyncModulesClient(client_wrapper=self._client_wrapper)
+        return self._modules
+
     @property
     def triggers(self):
         if self._triggers is None:

auth0/management/{attack_protection/brute_force_protection/types → actions/modules}/__init__.py

@@ -6,14 +6,8 @@ import typing
 from importlib import import_module
 
 if typing.TYPE_CHECKING:
-    from .update_brute_force_settings_request_content_mode import UpdateBruteForceSettingsRequestContentMode
-    from .update_brute_force_settings_request_content_shields_item import (
-        UpdateBruteForceSettingsRequestContentShieldsItem,
-    )
-_dynamic_imports: typing.Dict[str, str] = {
-    "UpdateBruteForceSettingsRequestContentMode": ".update_brute_force_settings_request_content_mode",
-    "UpdateBruteForceSettingsRequestContentShieldsItem": ".update_brute_force_settings_request_content_shields_item",
-}
+    from . import versions
+_dynamic_imports: typing.Dict[str, str] = {"versions": ".versions"}
 
 
 def __getattr__(attr_name: str) -> typing.Any:
@@ -37,4 +31,4 @@ def __dir__():
     return sorted(lazy_attrs)
 
 
-__all__ = ["UpdateBruteForceSettingsRequestContentMode", "UpdateBruteForceSettingsRequestContentShieldsItem"]
+__all__ = ["versions"]