processcube-etw-library 2026.1.22.131318b0__tar.gz → 2026.1.29.71849b0__tar.gz

{processcube_etw_library-2026.1.22.131318b0/src/processcube_etw_library.egg-info → processcube_etw_library-2026.1.29.71849b0}/PKG-INFO

@@ -1,14 +1,15 @@
 Metadata-Version: 2.4
 Name: processcube-etw-library
-Version: 2026.1.22.131318b0
+Version: 2026.1.29.71849b0
 Summary: A library to create ETW apps with the ProcessCube platform.
 Author-email: Jeremy Hill <jeremy.hill@profection.de>
 License: MIT
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
+Requires-Dist: async-lru>=2.1.0
+Requires-Dist: dataclasses-json>=0.6.7
 Requires-Dist: fastapi[standard]>=0.128.0
 Requires-Dist: oauth2-client>=1.4.2
-Requires-Dist: processcube-client>=5.0.0
 Requires-Dist: tenacity>=9.1.2
 
 # ProcessCube ETW Library
@@ -27,15 +28,16 @@ uv add processcube-etw-library
 
 The library uses environment variables for configuration. You can set these in your environment or in a `.env` file in your project root.
 
-| Variable                             | Default                                | Description                                      |
-| ------------------------------------ | -------------------------------------- | ------------------------------------------------ |
-| `PROCESSCUBE_ENGINE_URL`             | `http://localhost:56000`               | URL of the ProcessCube Engine                    |
-| `PROCESSCUBE_AUTHORITY_URL`          | Auto-discovered from engine            | URL of the ProcessCube Authority (OAuth server)  |
-| `PROCESSCUBE_ETW_CLIENT_ID`          | `test_etw`                             | OAuth client ID for the External Task Worker     |
-| `PROCESSCUBE_ETW_CLIENT_SECRET`      | `3ef62eb3-fe49-4c2c-ba6f-73e4d234321b` | OAuth client secret for the External Task Worker |
-| `PROCESSCUBE_ETW_CLIENT_SCOPES`      | `engine_etw`                           | OAuth scopes for the External Task Worker        |
-| `MAX_GET_OAUTH_ACCESS_TOKEN_RETRIES` | `10`                                   | Maximum retries for obtaining OAuth access token |
-| `ENVIRONMENT`                        | `development`                          | Environment mode (`development` or `production`) |
+| Variable                                         | Default                                | Description                                             |
+| ------------------------------------------------ | -------------------------------------- | ------------------------------------------------------- |
+| `PROCESSCUBE_ENGINE_URL`                         | `http://localhost:56000`               | URL of the ProcessCube Engine                           |
+| `PROCESSCUBE_AUTHORITY_URL`                      | Auto-discovered from engine            | URL of the ProcessCube Authority (OAuth server)         |
+| `PROCESSCUBE_ETW_CLIENT_ID`                      | `test_etw`                             | OAuth client ID for the External Task Worker            |
+| `PROCESSCUBE_ETW_CLIENT_SECRET`                  | `3ef62eb3-fe49-4c2c-ba6f-73e4d234321b` | OAuth client secret for the External Task Worker        |
+| `PROCESSCUBE_ETW_CLIENT_SCOPES`                  | `engine_etw`                           | OAuth scopes for the External Task Worker               |
+| `PROCESSCUBE_MAX_GET_OAUTH_ACCESS_TOKEN_RETRIES` | `10`                                   | Maximum retries for obtaining OAuth access token        |
+| `PROCESSCUBE_ETW_LONG_POLLING_TIMEOUT_IN_MS`     | `60000`                                | Long polling timeout in milliseconds for external tasks |
+| `ENVIRONMENT`                                    | `development`                          | Environment mode (`development` or `production`)        |
 
 #### Example `.env` File
 

{processcube_etw_library-2026.1.22.131318b0 → processcube_etw_library-2026.1.29.71849b0}/README.md

@@ -14,15 +14,16 @@ uv add processcube-etw-library
 
 The library uses environment variables for configuration. You can set these in your environment or in a `.env` file in your project root.
 
-| Variable                             | Default                                | Description                                      |
-| ------------------------------------ | -------------------------------------- | ------------------------------------------------ |
-| `PROCESSCUBE_ENGINE_URL`             | `http://localhost:56000`               | URL of the ProcessCube Engine                    |
-| `PROCESSCUBE_AUTHORITY_URL`          | Auto-discovered from engine            | URL of the ProcessCube Authority (OAuth server)  |
-| `PROCESSCUBE_ETW_CLIENT_ID`          | `test_etw`                             | OAuth client ID for the External Task Worker     |
-| `PROCESSCUBE_ETW_CLIENT_SECRET`      | `3ef62eb3-fe49-4c2c-ba6f-73e4d234321b` | OAuth client secret for the External Task Worker |
-| `PROCESSCUBE_ETW_CLIENT_SCOPES`      | `engine_etw`                           | OAuth scopes for the External Task Worker        |
-| `MAX_GET_OAUTH_ACCESS_TOKEN_RETRIES` | `10`                                   | Maximum retries for obtaining OAuth access token |
-| `ENVIRONMENT`                        | `development`                          | Environment mode (`development` or `production`) |
+| Variable                                         | Default                                | Description                                             |
+| ------------------------------------------------ | -------------------------------------- | ------------------------------------------------------- |
+| `PROCESSCUBE_ENGINE_URL`                         | `http://localhost:56000`               | URL of the ProcessCube Engine                           |
+| `PROCESSCUBE_AUTHORITY_URL`                      | Auto-discovered from engine            | URL of the ProcessCube Authority (OAuth server)         |
+| `PROCESSCUBE_ETW_CLIENT_ID`                      | `test_etw`                             | OAuth client ID for the External Task Worker            |
+| `PROCESSCUBE_ETW_CLIENT_SECRET`                  | `3ef62eb3-fe49-4c2c-ba6f-73e4d234321b` | OAuth client secret for the External Task Worker        |
+| `PROCESSCUBE_ETW_CLIENT_SCOPES`                  | `engine_etw`                           | OAuth scopes for the External Task Worker               |
+| `PROCESSCUBE_MAX_GET_OAUTH_ACCESS_TOKEN_RETRIES` | `10`                                   | Maximum retries for obtaining OAuth access token        |
+| `PROCESSCUBE_ETW_LONG_POLLING_TIMEOUT_IN_MS`     | `60000`                                | Long polling timeout in milliseconds for external tasks |
+| `ENVIRONMENT`                                    | `development`                          | Environment mode (`development` or `production`)        |
 
 #### Example `.env` File
 

{processcube_etw_library-2026.1.22.131318b0 → processcube_etw_library-2026.1.29.71849b0}/pyproject.toml

@@ -11,9 +11,10 @@ authors = [{ name = "Jeremy Hill", email = "jeremy.hill@profection.de" }]
 license = { text = "MIT" }
 requires-python = ">=3.12"
 dependencies = [
+    "async-lru>=2.1.0",
+    "dataclasses-json>=0.6.7",
     "fastapi[standard]>=0.128.0",
     "oauth2-client>=1.4.2",
-    "processcube-client>=5.0.0",
     "tenacity>=9.1.2",
 ]
 
@@ -21,7 +22,9 @@ dependencies = [
 override-dependencies = ["nest-asyncio>=1.6.0"]
 
 [tool.setuptools]
-packages = ["processcube_etw_library"]
 package-dir = { "" = "src" }
 
+[tool.setuptools.packages.find]
+where = ["src"]
+
 [tool.setuptools_scm]

{processcube_etw_library-2026.1.22.131318b0 → processcube_etw_library-2026.1.29.71849b0}/src/processcube_etw_library/__init__.py

@@ -1,8 +1,9 @@
 # Prevent nest_asyncio from patching asyncio.run() in processcube_client - it breaks uvicorn's loop_factory
-import nest_asyncio
-nest_asyncio.apply = lambda *args, **kwargs: None
+# import nest_asyncio
 
-from .health import (
+# nest_asyncio.apply = lambda *args, **kwargs: None
+
+from .health import (  # noqa: E402
     create_url_health_check,
     HealthCheck,
     HealthCheckModel,
@@ -10,8 +11,8 @@ from .health import (
     HealthConditionInfo,
     LivezResponse,
 )
-from .etw_app import new_external_task_worker_app
-from .settings import load_settings, load_settings
+from .etw_app import new_external_task_worker_app  # noqa: E402
+from .settings import load_settings, ETWSettings  # noqa: E402
 
 __all__ = [
     "create_url_health_check",
@@ -22,4 +23,5 @@ __all__ = [
     "LivezResponse",
     "new_external_task_worker_app",
     "load_settings",
+    "ETWSettings",
 ]

{processcube_etw_library-2026.1.22.131318b0 → processcube_etw_library-2026.1.29.71849b0}/src/processcube_etw_library/create_external_task_client.py

@@ -1,4 +1,4 @@
-from processcube_client.external_task import ExternalTaskClient
+from .processcube_client.external_task import ExternalTaskClient
 
 from .identity_provider import IdentityProvider
 from .settings import load_settings
@@ -11,7 +11,9 @@ def create_external_task_client() -> ExternalTaskClient:
     client_name = settings.processcube_etw_client_id
     client_secret = settings.processcube_etw_client_secret
     client_scopes = settings.processcube_etw_client_scopes
-    max_get_oauth_access_token_retries = settings.max_get_oauth_access_token_retries
+    max_get_oauth_access_token_retries = (
+        settings.processcube_max_get_oauth_access_token_retries
+    )
 
     identity_provider = IdentityProvider(
         authority_url,

{processcube_etw_library-2026.1.22.131318b0 → processcube_etw_library-2026.1.29.71849b0}/src/processcube_etw_library/etw_app.py

@@ -6,16 +6,17 @@ from typing import Callable, Optional
 from fastapi import FastAPI
 import uvicorn
 
+from .settings import load_settings
 from .health import (
     add_built_in_health_checks,
     HealthCheck,
     HealthCheckRegistry,
-    setup_health_routes
-    )
+    setup_health_routes,
+)
 from .create_external_task_client import create_external_task_client
 from .server_config import get_server_config
 from .typed_handler import create_typed_handler_wrapper
-from processcube_client.external_task import ExternalTaskClient
+from .processcube_client.external_task import ExternalTaskClient
 
 
 class ExternalTaskWorkerApp:
@@ -67,13 +68,25 @@ class ExternalTaskWorkerApp:
     def subscribe_to_external_task_for_topic(
         self, topic: str, handler: Callable, **options
     ) -> None:
-        self._etw_client.subscribe_to_external_task_topic(topic, handler, **options)
+        settings = load_settings()
+        self._etw_client.subscribe_to_external_task_topic(
+            topic,
+            handler,
+            long_polling_timeout_in_ms=settings.processcube_etw_long_polling_timeout_in_ms,
+            **options,
+        )
 
     def subscribe_to_external_task_for_topic_typed(
         self, topic: str, handler: Callable, **options
     ) -> None:
+        settings = load_settings()
         wrapper = create_typed_handler_wrapper(handler)
-        self._etw_client.subscribe_to_external_task_topic(topic, wrapper, **options)
+        self._etw_client.subscribe_to_external_task_topic(
+            topic,
+            wrapper,
+            long_polling_timeout_in_ms=settings.processcube_etw_long_polling_timeout_in_ms,
+            **options,
+        )
 
     def add_health_check(self, check: HealthCheck) -> None:
         self._health_registry.register(check)

{processcube_etw_library-2026.1.22.131318b0 → processcube_etw_library-2026.1.29.71849b0}/src/processcube_etw_library/health/built_in.py

@@ -7,8 +7,7 @@ def add_built_in_health_checks(registry: HealthCheckRegistry) -> None:
     settings = load_settings()
 
     engine_url = (
-        settings.processcube_engine_url.strip("/")
-        + "/atlas_engine/api/v1/info"
+        settings.processcube_engine_url.strip("/") + "/atlas_engine/api/v1/info"
     )
 
     authority_url = (
@@ -18,7 +17,7 @@ def add_built_in_health_checks(registry: HealthCheckRegistry) -> None:
 
     registry.register(
         HealthCheck(
-            create_url_health_check(engine_url),
+            create_url_health_check(engine_url, use_cache=True, ttl=300),
             service_name="ProcessCube Engine",
             tags=["core", "backend"],
             comments=["Checks if the ProcessCube Engine is reachable"],
@@ -26,7 +25,7 @@ def add_built_in_health_checks(registry: HealthCheckRegistry) -> None:
     )
     registry.register(
         HealthCheck(
-            create_url_health_check(authority_url),
+            create_url_health_check(authority_url, use_cache=True, ttl=300),
             service_name="ProcessCube Authority",
             tags=["core", "auth"],
             comments=["Checks if the ProcessCube Authority is reachable"],

{processcube_etw_library-2026.1.22.131318b0 → processcube_etw_library-2026.1.29.71849b0}/src/processcube_etw_library/health/check.py

@@ -2,6 +2,7 @@ from collections.abc import Awaitable, Callable
 from datetime import timedelta
 from time import perf_counter
 import inspect
+from async_lru import alru_cache
 
 import httpx
 
@@ -10,6 +11,7 @@ from .models import HealthCheckResult
 
 type HealthCheckCondition = Callable[[], bool | Awaitable[bool]]
 
+
 class HealthCheck:
     def __init__(
         self,
@@ -36,10 +38,18 @@ class HealthCheck:
         return HealthCheckResult(healthy=healthy, time_taken=timedelta(seconds=elapsed))
 
 
-def create_url_health_check(url: str, timeout: float = 5.0) -> HealthCheckCondition:
-    async def check():
+def create_url_health_check(
+    url: str, timeout: float = 5.0, use_cache: bool = False, ttl: int = 60
+) -> HealthCheckCondition:
+    @alru_cache(maxsize=128, ttl=ttl)
+    async def check_cached():
+        async with httpx.AsyncClient() as client:
+            response = await client.get(url, timeout=timeout)
+            return response.status_code == 200
+
+    async def check_no_cache():
         async with httpx.AsyncClient() as client:
             response = await client.get(url, timeout=timeout)
-            return True if response.status_code == 200 else False
+            return response.status_code == 200
 
-    return check
+    return check_cached if use_cache else check_no_cache

{processcube_etw_library-2026.1.22.131318b0 → processcube_etw_library-2026.1.29.71849b0}/src/processcube_etw_library/identity_provider.py

@@ -27,7 +27,6 @@ def log_failed_attempt(retry_state):
 
 
 class IdentityProvider:
-
     def __init__(
         self,
         authority_url: str,
@@ -51,7 +50,6 @@ class IdentityProvider:
         return self._access_token_caller()
 
     def _prepare_get_access_token_caller(self):
-
         @retry(
             stop=stop_after_attempt(self._max_get_oauth_access_token_retries),
             wait=wait_exponential(multiplier=1, min=2, max=30),

processcube_etw_library-2026.1.29.71849b0/src/processcube_etw_library/processcube_client/__init__.py

@@ -0,0 +1,22 @@
+from .client_factory import ClientFactory
+from .app_info import AppInfoClient
+from .event import EventClient
+from .external_task import ClientWrapper, ExternalTaskClient
+from .flow_node_instance import FlowNodeInstanceClient
+from .notification import NotificationClient
+from .process_instance import ProcessInstanceClient
+from .process_definition import ProcessDefinitionClient
+from .user_task import UserTaskClient
+
+__all__ = ['ClientFactory',
+    'AppInfoClient',
+    'EventClient',
+    'ClientWrapper',
+    'ExternalTaskClient',
+    'FlowNodeInstanceClient',
+    'NotificationClient',
+    'ProcessInstanceClient',
+    'ProcessDefinitionClient',
+    'UserTaskClient',
+]
+

processcube_etw_library-2026.1.29.71849b0/src/processcube_etw_library/processcube_client/app_info/__init__.py

@@ -0,0 +1 @@
+from .app_info_client import AppInfoClient

processcube_etw_library-2026.1.29.71849b0/src/processcube_etw_library/processcube_client/app_info/app_info_client.py

@@ -0,0 +1,36 @@
+import logging
+
+from ..core.base_client import BaseClient, run_async_in_sync_context
+
+logger = logging.getLogger(__name__)
+
+
+class AppInfoClient(BaseClient):
+    def __init__(self, url, session=None, identity=None):
+        super(AppInfoClient, self).__init__(url, session, identity)
+
+    async def __get_info(self):
+        url = f"/atlas_engine/api/v1/info"
+
+        result = await self.do_get(url)
+
+        return result
+
+    def get_info(self):
+        logger.info(f"Connection to atlas engine at url '{self._url}'.")
+        logger.info(f"Get info of the atlas engine.")
+
+        return run_async_in_sync_context(self.__get_info())
+
+    async def __get_authority(self):
+        url = f"/atlas_engine/api/v1/authority"
+
+        result = await self.do_get(url)
+
+        return result
+
+    def get_authority(self):
+        logger.info(f"Connection to atlas engine at url '{self._url}'.")
+        logger.info(f"Get info of the authority of the atlas engine.")
+
+        return run_async_in_sync_context(self.__get_authority())

processcube_etw_library-2026.1.29.71849b0/src/processcube_etw_library/processcube_client/client_factory.py

@@ -0,0 +1,37 @@
+from .app_info import AppInfoClient
+from .event import EventClient
+from .external_task import ClientWrapper
+from .flow_node_instance import FlowNodeInstanceClient
+from .notification import NotificationClient
+from .process_instance import ProcessInstanceClient
+from .process_definition import ProcessDefinitionClient
+from .user_task import UserTaskClient
+
+
+class ClientFactory:
+    def __init__(self):
+        pass
+
+    def create_app_info_client(self, engine_url):
+        return AppInfoClient(engine_url)
+
+    def create_event_client(self, engine_url):
+        return EventClient(engine_url)
+
+    def create_external_task_client(self, engine_url):
+        return ClientWrapper(engine_url)
+
+    def create_flow_node_instance_client(self, engine_url):
+        return FlowNodeInstanceClient(engine_url)
+
+    def create_notification_client(self, engine_url):
+        return NotificationClient(engine_url)
+
+    def create_process_instance_client(self, engine_url):
+        return ProcessInstanceClient(engine_url)
+
+    def create_process_definition_client(self, engine_url):
+        return ProcessDefinitionClient(engine_url)
+
+    def create_user_task_client(self, engine_url):
+        return UserTaskClient(engine_url)

processcube_etw_library-2026.1.29.71849b0/src/processcube_etw_library/processcube_client/core/__init__.py

@@ -0,0 +1,2 @@
+from .base_client import BaseClient
+from .loop_helper import LoopHelper, get_or_create_loop, ensure_has_loop

processcube_etw_library-2026.1.29.71849b0/src/processcube_etw_library/processcube_client/core/api/__init__.py

@@ -0,0 +1,13 @@
+from .client import Client
+
+from .helpers.application_info import ApplicationInfo
+from .helpers.data_object_instances import DataObjectInstanceHandler, DataObjectInstancesQuery, DataObjectInstanceResponse
+from .helpers.empty_tasks import EmptyTaskHandler, EmptyTaskQuery, EmptyTaskResponse
+from .helpers.events import EventsHandler, MessageTriggerRequest
+from .helpers.process_definitions import ProcessDefinitionUploadPayload, ProcessDefinitionHandler
+from .helpers.process_instances import ProcessInstanceHandler, ProcessInstanceQueryRequest, ProcessInstanceQueryResponse
+from .helpers.process_models import ProcessStartResponse, ProcessStartRequest, StartCallbackType
+from .helpers.external_tasks import FetchAndLockRequestPayload, ExternalTask, FinishExternalTaskRequestPayload
+from .helpers.flow_node_instances import FlowNodeInstanceHandler, FlowNodeInstanceResponse, FlowNodeInstancesQuery
+from .helpers.manual_tasks import ManualTaskHandler, ManualTaskQuery, ManualTaskResponse
+from .helpers.user_tasks import UserTaskHandler, UserTaskQuery, UserTaskResponse, ReserveUserTaskRequest

processcube_etw_library-2026.1.29.71849b0/src/processcube_etw_library/processcube_client/core/api/base_client.py

@@ -0,0 +1,235 @@
+"""
+Base client for ProcessCube® API handlers.
+
+This module provides the base HTTP client functionality used by all handler classes.
+"""
+
+import json
+import logging
+from typing import Any, Callable, Dict, Optional, Protocol
+from urllib.parse import urljoin
+
+import requests
+
+
+class IsDataclass(Protocol):
+    """Protocol for dataclass type checking."""
+
+    __dataclass_fields__: Dict
+
+
+class BaseClient:
+    """
+    Base HTTP client for ProcessCube® API communication.
+
+    This class provides low-level HTTP methods (GET, POST, PUT, DELETE) with
+    automatic authentication header injection.
+
+    Args:
+        url: Base URL of the ProcessCube® Engine
+        identity: Optional callable that returns identity dict with 'token' key
+        api_version: API version to use (default: "v1")
+    """
+
+    def __init__(
+        self,
+        url: str,
+        identity: Optional[Callable[[], Dict[str, str]]] = None,
+        api_version: str = "v1",
+    ):
+        """
+        Initialize the BaseClient.
+
+        Args:
+            url: Base URL of the ProcessCube® Engine (e.g., "http://localhost:56100")
+            identity: Optional callable returning dict with 'token' key.
+                     If None, uses default dummy token: ZHVtbXlfdG9rZW4=
+            api_version: API version to use (default: "v1")
+        """
+        self._base_url = url.rstrip("/")
+        self._api_version = api_version
+        self.logger = logging.getLogger(__name__)
+
+        if identity is not None:
+            self._identity = identity
+        else:
+            # Default identity with dummy token from Swagger spec
+            self._identity = lambda: {"token": "ZHVtbXlfdG9rZW4="}
+
+    def _build_url(self, path: str) -> str:
+        """
+        Build the full API URL from a path.
+
+        According to Swagger spec, the API is at:
+        /atlas_engine/api/v1/...
+
+        Args:
+            path: API endpoint path (e.g., "process_models")
+
+        Returns:
+            Full URL to the API endpoint
+
+        Example:
+            >>> client._build_url("process_models")
+            'http://localhost:56100/atlas_engine/api/v1/process_models'
+        """
+        # Remove leading slash from path
+        path = path.lstrip("/")
+
+        # Build API path according to Swagger spec
+        api_path = f"atlas_engine/api/{self._api_version}/{path}"
+
+        # Use urljoin for proper URL construction
+        return urljoin(self._base_url + "/", api_path)
+
+    def do_get(self, path: str, options: Optional[Dict] = None) -> Any:
+        """
+        Execute a GET request.
+
+        Args:
+            path: API endpoint path
+            options: Optional request options (can contain 'headers')
+
+        Returns:
+            Parsed JSON response
+
+        Raises:
+            requests.HTTPError: On HTTP errors
+        """
+        options = options or {}
+        headers = self._get_default_headers()
+        headers.update(options.get("headers", {}))
+        headers.update(self._get_auth_headers())
+
+        request_url = self._build_url(path)
+
+        self.logger.debug(f"GET {request_url}")
+        response = requests.get(request_url, headers=headers)
+        response.raise_for_status()
+
+        return response.json()
+
+    def do_delete(self, path: str, options: Optional[Dict] = None) -> None:
+        """
+        Execute a DELETE request.
+
+        Args:
+            path: API endpoint path
+            options: Optional request options (can contain 'headers')
+
+        Raises:
+            requests.HTTPError: On HTTP errors
+        """
+        options = options or {}
+        headers = self._get_default_headers()
+        headers.update(options.get("headers", {}))
+        headers.update(self._get_auth_headers())
+
+        request_url = self._build_url(path)
+
+        self.logger.debug(f"DELETE {request_url}")
+        response = requests.delete(request_url, headers=headers)
+        response.raise_for_status()
+
+    def do_post(
+        self, path: str, payload: IsDataclass, options: Optional[Dict] = None
+    ) -> Any:
+        """
+        Execute a POST request.
+
+        Args:
+            path: API endpoint path
+            payload: Dataclass payload to send
+            options: Optional request options (can contain 'headers')
+
+        Returns:
+            Parsed JSON response if status is 200, empty dict otherwise
+
+        Raises:
+            requests.HTTPError: On HTTP errors
+        """
+        options = options or {}
+        headers = self._get_default_headers()
+        headers.update(options.get("headers", {}))
+        headers.update(self._get_auth_headers())
+
+        request_url = self._build_url(path)
+        json_payload = json.dumps(payload)
+
+        self.logger.debug(f"POST {request_url}")
+        response = requests.post(request_url, json_payload, headers=headers)
+        response.raise_for_status()
+
+        if response.status_code == 200:
+            return response.json()
+        return {}
+
+    def do_put(
+        self, path: str, payload: IsDataclass, options: Optional[Dict] = None
+    ) -> Any:
+        """
+        Execute a PUT request.
+
+        Args:
+            path: API endpoint path
+            payload: Dataclass payload to send
+            options: Optional request options (can contain 'headers')
+
+        Returns:
+            Parsed JSON response if status is 200, empty dict otherwise
+
+        Raises:
+            requests.HTTPError: On HTTP errors
+        """
+        options = options or {}
+        headers = self._get_default_headers()
+        headers.update(options.get("headers", {}))
+        headers.update(self._get_auth_headers())
+
+        request_url = self._build_url(path)
+        json_payload = json.dumps(payload)
+
+        self.logger.debug(f"PUT {request_url}")
+        response = requests.put(request_url, json_payload, headers=headers)
+        response.raise_for_status()
+
+        if response.status_code == 200:
+            return response.json()
+        return {}
+
+    def _get_auth_headers(self) -> Dict[str, str]:
+        """
+        Build authentication headers.
+
+        Returns:
+            Dict with Authorization header
+        """
+        identity = self._get_identity()
+        token = identity["token"]
+        return {"Authorization": f"Bearer {token}"}
+
+    def _get_default_headers(self) -> Dict[str, str]:
+        """
+        Get default headers for all requests.
+
+        Returns:
+            Dict with default headers
+        """
+        return {"Content-Type": "application/json"}
+
+    def _get_identity(self) -> Dict[str, str]:
+        """
+        Get the current identity.
+
+        Returns:
+            Identity dict with 'token' key
+        """
+        identity = self._identity
+
+        if callable(self._identity):
+            identity = self._identity()
+
+        return identity
+
+
+__all__ = ["BaseClient", "IsDataclass"]