dominus-sdk-python-dev 2.1.8__py3-none-any.whl → 2.3.0__py3-none-any.whl

dominus/__init__.py

@@ -4,29 +4,36 @@ CB Dominus SDK - Ultra-flat async SDK for CareBridge Services
 Ultra-Flat API:
     from dominus import dominus
 
-    # Secrets (root level)
+    # Secrets (root level shortcuts)
     value = await dominus.get("DB_URL")
     await dominus.upsert("KEY", "value")
 
-    # Auth (root level)
-    await dominus.add_user(username="john", password="secret", role_id="...")
-    await dominus.add_scope(slug="read", display_name="Read", tenant_category_id=1)
-    result = await dominus.verify_user_password(username="john", password="secret")
+    # Database (namespace-based)
+    tables = await dominus.db.tables()
+    rows = await dominus.db.query("users", filters={"status": "active"})
+    await dominus.db.insert("users", {"name": "John"})
 
-    # SQL data - app schema (root level)
-    tables = await dominus.list_tables()
-    rows = await dominus.query_table("users")
-    await dominus.insert_row("users", {"name": "John"})
+    # Auth (namespace-based)
+    users = await dominus.auth.list_users()
+    await dominus.auth.create_user(username="john", email="j@ex.com", password="secret")
+
+    # DDL (namespace-based)
+    await dominus.ddl.create_table("public", "users", [{"name": "id", "type": "UUID"}])
+
+    # Files (namespace-based)
+    result = await dominus.files.upload(data=file_bytes, filename="report.pdf", category="reports")
 
-    # SQL data - secure schema (secure namespace)
-    rows = await dominus.secure.query_table("patients")
-    await dominus.secure.insert_row("patients", {"mrn": "12345"})
+    # Secure table access with audit logging
+    rows = await dominus.db_secure.query("patients", context=SecureAccessContext(
+        reason="Reviewing chart",
+        actor=user_id
+    ))
 
-    # Schema DDL - app schema (root level)
-    await dominus.add_table("users", [{"name": "id", "type": "UUID"}])
+    # Admin operations
+    await dominus.admin.reseed_admin_category()
 
-    # Schema DDL - secure schema (secure namespace)
-    await dominus.secure.add_table("patients", [...])
+    # Portal authentication
+    session = await dominus.portal.login("user@example.com", "password", "tenant-id")
 
     # Open DSN
     dsn = await dominus.open.dsn()
@@ -34,14 +41,68 @@ Ultra-Flat API:
     # Health
     status = await dominus.health.check()
 
-Backward Compatible String API:
+Backward Compatible APIs:
+    # String-based API
     result = await dominus("secrets.get", key="DB_URL")
+
+    # Flat API (root level shortcuts for common operations)
+    await dominus.list_tables()
+    await dominus.query_table("users")
+    await dominus.insert_row("users", {"name": "John"})
+
+Crypto Helpers:
+    from dominus import hash_password, hash_psk, generate_token
+    hashed = hash_password("secret")
 """
-from .start import dominus
+from .start import dominus, Dominus
 from .helpers.core import DominusResponse
 
-__version__ = "0.3.0"
+# Export crypto helpers
+from .helpers.crypto import (
+    hash_password,
+    verify_password,
+    hash_psk,
+    verify_psk,
+    generate_psk_local,
+    hash_token,
+    generate_token,
+)
+
+# Export namespace classes for type hints
+from .namespaces.db import DbNamespace
+from .namespaces.auth import AuthNamespace
+from .namespaces.ddl import DdlNamespace
+from .namespaces.files import FilesNamespace
+from .namespaces.portal import PortalNamespace
+from .namespaces.admin import AdminNamespace
+from .namespaces.secure import SecureNamespace, SecureAccessContext
+
+# Export cache utilities
+from .helpers.cache import dominus_cache
+
+__version__ = "2.2.0"
 __all__ = [
+    # Main SDK instance
     "dominus",
+    "Dominus",
     "DominusResponse",
+    # Crypto helpers
+    "hash_password",
+    "verify_password",
+    "hash_psk",
+    "verify_psk",
+    "generate_psk_local",
+    "hash_token",
+    "generate_token",
+    # Namespace classes (for type hints)
+    "DbNamespace",
+    "AuthNamespace",
+    "DdlNamespace",
+    "FilesNamespace",
+    "PortalNamespace",
+    "AdminNamespace",
+    "SecureNamespace",
+    "SecureAccessContext",
+    # Cache utilities
+    "dominus_cache",
 ]

dominus/config/__init__.py

@@ -1,24 +1,24 @@
 """SDK Configuration"""
 from .endpoints import (
+    BASE_URL,
     SOVEREIGN_URL,
     ARCHITECT_URL,
     ORCHESTRATOR_URL,
     WARDEN_URL,
+    get_base_url,
     get_service_url,
     get_architect_url,
     get_sovereign_url,
-    PROJECT_NUMBER,
-    REGION,
 )
 
 __all__ = [
+    "BASE_URL",
     "SOVEREIGN_URL",
     "ARCHITECT_URL",
     "ORCHESTRATOR_URL",
     "WARDEN_URL",
+    "get_base_url",
     "get_service_url",
     "get_architect_url",
     "get_sovereign_url",
-    "PROJECT_NUMBER",
-    "REGION",
 ]

dominus/config/endpoints.py

@@ -4,12 +4,20 @@ Dominus Orchestrator Endpoints
 Single backend URL for all services. The SDK now targets dominus-orchestrator
 which consolidates all service functionality.
 
+Configuration:
+    Set DOMINUS_BASE_URL environment variable to override the default URL.
+    Example: export DOMINUS_BASE_URL=http://localhost:5000
+
 Usage:
-    from dominus.config.endpoints import BASE_URL
+    from dominus.config.endpoints import BASE_URL, get_base_url
 """
+import os
+
+# Default Dominus Orchestrator Production URL
+_DEFAULT_BASE_URL = "https://dominus-orchestrator-production-775398158805.us-east4.run.app"
 
-# Dominus Orchestrator Production URL
-BASE_URL = "https://dominus-orchestrator-production-775398158805.us-east4.run.app"
+# Base URL (can be overridden via DOMINUS_BASE_URL environment variable)
+BASE_URL = os.environ.get("DOMINUS_BASE_URL", _DEFAULT_BASE_URL)
 
 # Legacy aliases (all point to orchestrator now) - DEPRECATED
 SOVEREIGN_URL = BASE_URL
@@ -19,8 +27,13 @@ WARDEN_URL = BASE_URL
 
 
 def get_base_url() -> str:
-    """Get the dominus-orchestrator base URL."""
-    return BASE_URL
+    """
+    Get the dominus-orchestrator base URL.
+
+    Returns the value of DOMINUS_BASE_URL environment variable if set,
+    otherwise returns the default production URL.
+    """
+    return os.environ.get("DOMINUS_BASE_URL", _DEFAULT_BASE_URL)
 
 
 # DEPRECATED - use get_base_url()

dominus/namespaces/admin.py

@@ -0,0 +1,58 @@
+"""
+Admin Namespace - Infrastructure and administrative operations.
+
+Provides admin-level operations for seeding and resetting data.
+"""
+from typing import Any, Dict, TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from ..start import Dominus
+
+
+class AdminNamespace:
+    """
+    Administrative operations namespace.
+
+    Provides infrastructure-level operations like reseeding admin data
+    and resetting schemas.
+
+    Usage:
+        # Reseed admin category with default data
+        result = await dominus.admin.reseed_admin_category()
+
+        # Reset and reseed admin category
+        result = await dominus.admin.reset_admin_category()
+    """
+
+    def __init__(self, client: "Dominus"):
+        self._client = client
+
+    async def reseed_admin_category(self) -> Dict[str, Any]:
+        """
+        Reseed the admin category with default data.
+
+        Adds default scopes, roles, and navigation items to the admin
+        tenant category without dropping existing data.
+
+        Returns:
+            Dict with success status, message, and seeded_entities
+        """
+        return await self._client._request(
+            endpoint="/api/admin/reseed",
+            method="POST"
+        )
+
+    async def reset_admin_category(self) -> Dict[str, Any]:
+        """
+        Reset and reseed the admin category.
+
+        Drops all data from admin schemas and reseeds with default data.
+        WARNING: This is a destructive operation.
+
+        Returns:
+            Dict with success status, message, and operations
+        """
+        return await self._client._request(
+            endpoint="/api/admin/reset",
+            method="POST"
+        )