dominus-sdk-python-dev 2.3.0__tar.gz → 2.4.0__tar.gz

{dominus_sdk_python_dev-2.3.0 → dominus_sdk_python_dev-2.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dominus-sdk-python-dev
-Version: 2.3.0
+Version: 2.4.0
 Summary: Python SDK for the Dominus Orchestrator Platform
 Author-email: CareBridge Systems <dev@carebridge.io>
 License: Proprietary
@@ -417,8 +417,8 @@ from dominus import (
     ConflictError,
     ServiceError,
     SecureTableError,
-    ConnectionError,
-    TimeoutError,
+    DominusConnectionError,  # Renamed to avoid shadowing built-in
+    DominusTimeoutError,     # Renamed to avoid shadowing built-in
 )
 
 try:
@@ -445,6 +445,7 @@ except DominusError as e:
 
 | Error | Status | Description |
 |-------|--------|-------------|
+| `DominusError` | - | Base class for all SDK errors |
 | `AuthenticationError` | 401 | Invalid or missing token |
 | `AuthorizationError` | 403 | Insufficient permissions |
 | `NotFoundError` | 404 | Resource not found |
@@ -452,8 +453,8 @@ except DominusError as e:
 | `ConflictError` | 409 | Duplicate or version conflict |
 | `ServiceError` | 5xx | Backend service error |
 | `SecureTableError` | 403 | Missing reason for secure table |
-| `ConnectionError` | - | Network connection failed |
-| `TimeoutError` | 504 | Request timed out |
+| `DominusConnectionError` | - | Network connection failed |
+| `DominusTimeoutError` | 504 | Request timed out |
 
 ## Configuration
 
@@ -551,10 +552,13 @@ async def get_all_users(page_size: int = 100):
 
 ## Version
 
-**v2.1.6** - Latest release with navigation routes and page scope methods
+**v2.4.0** - Full namespace parity with Node.js SDK
 
 ### Changelog
 
+- **v2.4.0** - Full parity with Node.js SDK: all namespaces properly initialized, error classes exported, cache utilities exposed
+- **v2.3.0** - Add comprehensive auth namespace with 100+ methods
+- **v2.2.0** - Add DDL schema builder and migration methods
 - **v2.1.6** - Fix navigation routes and add page scope methods
 - **v2.1.5** - Add PSK-only client login
 - **v2.1.4** - Make `tenant_id` optional in login methods

{dominus_sdk_python_dev-2.3.0 → dominus_sdk_python_dev-2.4.0}/README.md

@@ -386,8 +386,8 @@ from dominus import (
     ConflictError,
     ServiceError,
     SecureTableError,
-    ConnectionError,
-    TimeoutError,
+    DominusConnectionError,  # Renamed to avoid shadowing built-in
+    DominusTimeoutError,     # Renamed to avoid shadowing built-in
 )
 
 try:
@@ -414,6 +414,7 @@ except DominusError as e:
 
 | Error | Status | Description |
 |-------|--------|-------------|
+| `DominusError` | - | Base class for all SDK errors |
 | `AuthenticationError` | 401 | Invalid or missing token |
 | `AuthorizationError` | 403 | Insufficient permissions |
 | `NotFoundError` | 404 | Resource not found |
@@ -421,8 +422,8 @@ except DominusError as e:
 | `ConflictError` | 409 | Duplicate or version conflict |
 | `ServiceError` | 5xx | Backend service error |
 | `SecureTableError` | 403 | Missing reason for secure table |
-| `ConnectionError` | - | Network connection failed |
-| `TimeoutError` | 504 | Request timed out |
+| `DominusConnectionError` | - | Network connection failed |
+| `DominusTimeoutError` | 504 | Request timed out |
 
 ## Configuration
 
@@ -520,10 +521,13 @@ async def get_all_users(page_size: int = 100):
 
 ## Version
 
-**v2.1.6** - Latest release with navigation routes and page scope methods
+**v2.4.0** - Full namespace parity with Node.js SDK
 
 ### Changelog
 
+- **v2.4.0** - Full parity with Node.js SDK: all namespaces properly initialized, error classes exported, cache utilities exposed
+- **v2.3.0** - Add comprehensive auth namespace with 100+ methods
+- **v2.2.0** - Add DDL schema builder and migration methods
 - **v2.1.6** - Fix navigation routes and add page scope methods
 - **v2.1.5** - Add PSK-only client login
 - **v2.1.4** - Make `tenant_id` optional in login methods

{dominus_sdk_python_dev-2.3.0 → dominus_sdk_python_dev-2.4.0}/dominus/__init__.py

@@ -8,6 +8,10 @@ Ultra-Flat API:
     value = await dominus.get("DB_URL")
     await dominus.upsert("KEY", "value")
 
+    # Secrets namespace
+    value = await dominus.secrets.get("DB_URL")
+    await dominus.secrets.upsert("KEY", "value")
+
     # Database (namespace-based)
     tables = await dominus.db.tables()
     rows = await dominus.db.query("users", filters={"status": "active"})
@@ -23,6 +27,16 @@ Ultra-Flat API:
     # Files (namespace-based)
     result = await dominus.files.upload(data=file_bytes, filename="report.pdf", category="reports")
 
+    # Redis caching
+    await dominus.redis.set("key", "value", ttl=3600)
+    value = await dominus.redis.get("key")
+
+    # Logging
+    await dominus.logs.info("Operation complete", {"user_id": user_id})
+
+    # Email
+    await dominus.courier.send("welcome", to="user@example.com", from_email="hello@app.com", model={})
+
     # Secure table access with audit logging
     rows = await dominus.db_secure.query("patients", context=SecureAccessContext(
         reason="Reviewing chart",
@@ -35,11 +49,14 @@ Ultra-Flat API:
     # Portal authentication
     session = await dominus.portal.login("user@example.com", "password", "tenant-id")
 
-    # Open DSN
+    # Open DSN and raw SQL
     dsn = await dominus.open.dsn()
+    result = await dominus.open.execute("SELECT * FROM users WHERE id = $1", {"1": user_id})
 
     # Health
     status = await dominus.health.check()
+    await dominus.health.ping()
+    await dominus.health.warmup()
 
 Backward Compatible APIs:
     # String-based API
@@ -76,11 +93,37 @@ from .namespaces.files import FilesNamespace
 from .namespaces.portal import PortalNamespace
 from .namespaces.admin import AdminNamespace
 from .namespaces.secure import SecureNamespace, SecureAccessContext
+from .namespaces.secrets import SecretsNamespace
+from .namespaces.redis import RedisNamespace
+from .namespaces.logs import LogsNamespace
+from .namespaces.courier import CourierNamespace
+from .namespaces.health import HealthNamespace
+from .namespaces.open import OpenNamespace
+
+# Export cache and resilience utilities
+from .helpers.cache import (
+    dominus_cache,
+    CircuitBreaker,
+    DominusCache,
+    orchestrator_circuit_breaker,
+    exponential_backoff_with_jitter,
+)
 
-# Export cache utilities
-from .helpers.cache import dominus_cache
+# Export error classes
+from .errors import (
+    DominusError,
+    AuthenticationError,
+    AuthorizationError,
+    NotFoundError,
+    ValidationError,
+    ConflictError,
+    ServiceError,
+    SecureTableError,
+    ConnectionError as DominusConnectionError,
+    TimeoutError as DominusTimeoutError,
+)
 
-__version__ = "2.2.0"
+__version__ = "2.4.0"
 __all__ = [
     # Main SDK instance
     "dominus",
@@ -103,6 +146,27 @@ __all__ = [
     "AdminNamespace",
     "SecureNamespace",
     "SecureAccessContext",
-    # Cache utilities
+    "SecretsNamespace",
+    "RedisNamespace",
+    "LogsNamespace",
+    "CourierNamespace",
+    "HealthNamespace",
+    "OpenNamespace",
+    # Cache and resilience utilities
     "dominus_cache",
+    "CircuitBreaker",
+    "DominusCache",
+    "orchestrator_circuit_breaker",
+    "exponential_backoff_with_jitter",
+    # Error classes
+    "DominusError",
+    "AuthenticationError",
+    "AuthorizationError",
+    "NotFoundError",
+    "ValidationError",
+    "ConflictError",
+    "ServiceError",
+    "SecureTableError",
+    "DominusConnectionError",
+    "DominusTimeoutError",
 ]

{dominus_sdk_python_dev-2.3.0 → dominus_sdk_python_dev-2.4.0}/dominus/helpers/cache.py

@@ -1,7 +1,12 @@
 """
 Internal cache with automatic encryption and circuit breaker.
 
-NOT exposed to SDK users - internal use only.
+Exports:
+    - CircuitBreaker: Circuit breaker class for resilience
+    - DominusCache: Encrypted cache class
+    - dominus_cache: Singleton cache instance
+    - orchestrator_circuit_breaker: Circuit breaker for orchestrator
+    - exponential_backoff_with_jitter: Backoff calculation utility
 """
 import time
 import json
@@ -181,12 +186,15 @@ class DominusCache:
         return count
 
 
-# Internal singletons - NOT exported to users
+# Singleton instances
 dominus_cache = DominusCache(default_ttl=300)
 
-# Circuit breakers for different services (prevents retry storms)
-sovereign_circuit_breaker = CircuitBreaker(
+# Circuit breaker for orchestrator (prevents retry storms)
+orchestrator_circuit_breaker = CircuitBreaker(
     failure_threshold=5,    # Open after 5 consecutive failures
     recovery_timeout=30.0,  # Try again after 30 seconds
     half_open_max_calls=1   # Allow 1 test call in half-open state
 )
+
+# Backward compatibility alias
+sovereign_circuit_breaker = orchestrator_circuit_breaker

{dominus_sdk_python_dev-2.3.0 → dominus_sdk_python_dev-2.4.0}/dominus/start.py

@@ -251,31 +251,6 @@ class SecureNamespace:
         )
 
 
-class OpenNamespace:
-    """Open user namespace - Returns DSN string for dominus_open database."""
-
-    def __init__(self, _execute_command):
-        self._execute = _execute_command
-
-    async def dsn(self) -> str:
-        """
-        Get the full DSN connection string for open_user role.
-
-        Returns the complete PostgreSQL connection URI for the dominus_open
-        database that can be used directly by clients to connect.
-        """
-        return await self._execute("sql.open.get_dsn")
-
-
-class HealthNamespace:
-    """Health check operations namespace."""
-
-    def __init__(self, _execute_command):
-        self._execute = _execute_command
-
-    async def check(self) -> Dict[str, Any]:
-        """Check health of all services."""
-        return await self._execute("health.check")
 
 
 class Dominus:
@@ -324,10 +299,8 @@ class Dominus:
 
         self._execute = _execute_command
 
-        # Initialize minimal namespaces
+        # Initialize legacy flat API namespaces (backward compatibility)
         self.secure = SecureNamespace(_execute_command)
-        self.open = OpenNamespace(_execute_command)
-        self.health = HealthNamespace(_execute_command)
 
         # Initialize portal namespace (needs client reference for _request)
         from .namespaces.portal import PortalNamespace
@@ -337,22 +310,36 @@ class Dominus:
         from .namespaces.fastapi import FastAPINamespace
         self.fastapi = FastAPINamespace(self)
 
-        # Initialize full namespaces (matching Node.js SDK pattern)
+        # Initialize all namespaces (matching Node.js SDK pattern)
         from .namespaces.db import DbNamespace
         from .namespaces.auth import AuthNamespace
         from .namespaces.ddl import DdlNamespace
         from .namespaces.files import FilesNamespace
         from .namespaces.admin import AdminNamespace
         from .namespaces.secure import SecureNamespace as SecureNS
-
+        from .namespaces.secrets import SecretsNamespace
+        from .namespaces.redis import RedisNamespace
+        from .namespaces.logs import LogsNamespace
+        from .namespaces.courier import CourierNamespace
+        from .namespaces.health import HealthNamespace
+        from .namespaces.open import OpenNamespace
+
+        # Core namespaces
         self.db = DbNamespace(self)
         self.auth = AuthNamespace(self)
         self.ddl = DdlNamespace(self)
         self.files = FilesNamespace(self)
         self.admin = AdminNamespace(self)
 
-        # Note: self.secure is already defined above as the flat API namespace
-        # The proper SecureNS namespace is available as dominus.db_secure for direct access
+        # Additional namespaces (Node.js SDK parity)
+        self.secrets = SecretsNamespace(self)
+        self.redis = RedisNamespace(self)
+        self.logs = LogsNamespace(self)
+        self.courier = CourierNamespace(self)
+        self.health = HealthNamespace(self)
+        self.open = OpenNamespace(self)
+
+        # Secure namespace with proper audit context support
         self.db_secure = SecureNS(self)
 
         # Cache for JWT public key

{dominus_sdk_python_dev-2.3.0 → dominus_sdk_python_dev-2.4.0}/dominus_sdk_python_dev.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dominus-sdk-python-dev
-Version: 2.3.0
+Version: 2.4.0
 Summary: Python SDK for the Dominus Orchestrator Platform
 Author-email: CareBridge Systems <dev@carebridge.io>
 License: Proprietary
@@ -417,8 +417,8 @@ from dominus import (
     ConflictError,
     ServiceError,
     SecureTableError,
-    ConnectionError,
-    TimeoutError,
+    DominusConnectionError,  # Renamed to avoid shadowing built-in
+    DominusTimeoutError,     # Renamed to avoid shadowing built-in
 )
 
 try:
@@ -445,6 +445,7 @@ except DominusError as e:
 
 | Error | Status | Description |
 |-------|--------|-------------|
+| `DominusError` | - | Base class for all SDK errors |
 | `AuthenticationError` | 401 | Invalid or missing token |
 | `AuthorizationError` | 403 | Insufficient permissions |
 | `NotFoundError` | 404 | Resource not found |
@@ -452,8 +453,8 @@ except DominusError as e:
 | `ConflictError` | 409 | Duplicate or version conflict |
 | `ServiceError` | 5xx | Backend service error |
 | `SecureTableError` | 403 | Missing reason for secure table |
-| `ConnectionError` | - | Network connection failed |
-| `TimeoutError` | 504 | Request timed out |
+| `DominusConnectionError` | - | Network connection failed |
+| `DominusTimeoutError` | 504 | Request timed out |
 
 ## Configuration
 
@@ -551,10 +552,13 @@ async def get_all_users(page_size: int = 100):
 
 ## Version
 
-**v2.1.6** - Latest release with navigation routes and page scope methods
+**v2.4.0** - Full namespace parity with Node.js SDK
 
 ### Changelog
 
+- **v2.4.0** - Full parity with Node.js SDK: all namespaces properly initialized, error classes exported, cache utilities exposed
+- **v2.3.0** - Add comprehensive auth namespace with 100+ methods
+- **v2.2.0** - Add DDL schema builder and migration methods
 - **v2.1.6** - Fix navigation routes and add page scope methods
 - **v2.1.5** - Add PSK-only client login
 - **v2.1.4** - Make `tenant_id` optional in login methods

{dominus_sdk_python_dev-2.3.0 → dominus_sdk_python_dev-2.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "dominus-sdk-python-dev"
-version = "2.3.0"
+version = "2.4.0"
 description = "Python SDK for the Dominus Orchestrator Platform"
 readme = "README.md"
 requires-python = ">=3.9"