dominus-sdk-python-dev 2.1.6__py3-none-any.whl → 2.1.7__py3-none-any.whl

dominus/__init__.py

@@ -1,47 +1,47 @@
-"""
-CB Dominus SDK - Ultra-flat async SDK for CareBridge Services
-
-Ultra-Flat API:
-    from dominus import dominus
-
-    # Secrets (root level)
-    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")
-
-    # SQL data - app schema (root level)
-    tables = await dominus.list_tables()
-    rows = await dominus.query_table("users")
-    await dominus.insert_row("users", {"name": "John"})
-
-    # SQL data - secure schema (secure namespace)
-    rows = await dominus.secure.query_table("patients")
-    await dominus.secure.insert_row("patients", {"mrn": "12345"})
-
-    # Schema DDL - app schema (root level)
-    await dominus.add_table("users", [{"name": "id", "type": "UUID"}])
-
-    # Schema DDL - secure schema (secure namespace)
-    await dominus.secure.add_table("patients", [...])
-
-    # Open DSN
-    dsn = await dominus.open.dsn()
-
-    # Health
-    status = await dominus.health.check()
-
-Backward Compatible String API:
-    result = await dominus("secrets.get", key="DB_URL")
-"""
-from .start import dominus
-from .helpers.core import DominusResponse
-
-__version__ = "0.3.0"
-__all__ = [
-    "dominus",
-    "DominusResponse",
-]
+"""
+CB Dominus SDK - Ultra-flat async SDK for CareBridge Services
+
+Ultra-Flat API:
+    from dominus import dominus
+
+    # Secrets (root level)
+    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")
+
+    # SQL data - app schema (root level)
+    tables = await dominus.list_tables()
+    rows = await dominus.query_table("users")
+    await dominus.insert_row("users", {"name": "John"})
+
+    # SQL data - secure schema (secure namespace)
+    rows = await dominus.secure.query_table("patients")
+    await dominus.secure.insert_row("patients", {"mrn": "12345"})
+
+    # Schema DDL - app schema (root level)
+    await dominus.add_table("users", [{"name": "id", "type": "UUID"}])
+
+    # Schema DDL - secure schema (secure namespace)
+    await dominus.secure.add_table("patients", [...])
+
+    # Open DSN
+    dsn = await dominus.open.dsn()
+
+    # Health
+    status = await dominus.health.check()
+
+Backward Compatible String API:
+    result = await dominus("secrets.get", key="DB_URL")
+"""
+from .start import dominus
+from .helpers.core import DominusResponse
+
+__version__ = "0.3.0"
+__all__ = [
+    "dominus",
+    "DominusResponse",
+]

dominus/config/__init__.py

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

dominus/config/endpoints.py

@@ -1,39 +1,39 @@
-"""
-Dominus Orchestrator Endpoints
-
-Single backend URL for all services. The SDK now targets dominus-orchestrator
-which consolidates all service functionality.
-
-Usage:
-    from dominus.config.endpoints import BASE_URL
-"""
-
-# Dominus Orchestrator Production URL
-BASE_URL = "https://dominus-orchestrator-production-775398158805.us-east4.run.app"
-
-# Legacy aliases (all point to orchestrator now) - DEPRECATED
-SOVEREIGN_URL = BASE_URL
-ARCHITECT_URL = BASE_URL
-ORCHESTRATOR_URL = BASE_URL
-WARDEN_URL = BASE_URL
-
-
-def get_base_url() -> str:
-    """Get the dominus-orchestrator base URL."""
-    return BASE_URL
-
-
-# DEPRECATED - use get_base_url()
-def get_sovereign_url(environment: str = None) -> str:
-    """Deprecated: Use get_base_url() instead."""
-    return BASE_URL
-
-
-def get_architect_url(environment: str = None) -> str:
-    """Deprecated: Use get_base_url() instead."""
-    return BASE_URL
-
-
-def get_service_url(service: str, environment: str = None) -> str:
-    """Deprecated: Use get_base_url() instead. All services are now consolidated."""
-    return BASE_URL
+"""
+Dominus Orchestrator Endpoints
+
+Single backend URL for all services. The SDK now targets dominus-orchestrator
+which consolidates all service functionality.
+
+Usage:
+    from dominus.config.endpoints import BASE_URL
+"""
+
+# Dominus Orchestrator Production URL
+BASE_URL = "https://dominus-orchestrator-production-775398158805.us-east4.run.app"
+
+# Legacy aliases (all point to orchestrator now) - DEPRECATED
+SOVEREIGN_URL = BASE_URL
+ARCHITECT_URL = BASE_URL
+ORCHESTRATOR_URL = BASE_URL
+WARDEN_URL = BASE_URL
+
+
+def get_base_url() -> str:
+    """Get the dominus-orchestrator base URL."""
+    return BASE_URL
+
+
+# DEPRECATED - use get_base_url()
+def get_sovereign_url(environment: str = None) -> str:
+    """Deprecated: Use get_base_url() instead."""
+    return BASE_URL
+
+
+def get_architect_url(environment: str = None) -> str:
+    """Deprecated: Use get_base_url() instead."""
+    return BASE_URL
+
+
+def get_service_url(service: str, environment: str = None) -> str:
+    """Deprecated: Use get_base_url() instead. All services are now consolidated."""
+    return BASE_URL

dominus/errors.py

@@ -1,201 +1,201 @@
-"""
-Dominus SDK Error Classes
-
-Custom exceptions for the Dominus SDK with structured error information.
-"""
-from typing import Any, Dict, Optional
-
-
-class DominusError(Exception):
-    """
-    Base exception for all Dominus SDK errors.
-
-    Provides structured error information including HTTP status codes,
-    error messages, and optional details from the backend.
-
-    Attributes:
-        message: Human-readable error message
-        status_code: HTTP status code (if applicable)
-        details: Additional error details from backend
-        endpoint: The endpoint that was called (if applicable)
-    """
-
-    def __init__(
-        self,
-        message: str,
-        status_code: Optional[int] = None,
-        details: Optional[Dict[str, Any]] = None,
-        endpoint: Optional[str] = None
-    ):
-        self.message = message
-        self.status_code = status_code
-        self.details = details or {}
-        self.endpoint = endpoint
-        super().__init__(self.message)
-
-    def __str__(self) -> str:
-        parts = [self.message]
-        if self.status_code:
-            parts.append(f"(status {self.status_code})")
-        if self.endpoint:
-            parts.append(f"at {self.endpoint}")
-        return " ".join(parts)
-
-    def __repr__(self) -> str:
-        return (
-            f"DominusError(message={self.message!r}, "
-            f"status_code={self.status_code}, "
-            f"details={self.details!r}, "
-            f"endpoint={self.endpoint!r})"
-        )
-
-
-class AuthenticationError(DominusError):
-    """Raised when authentication fails (invalid token, expired JWT, etc.)."""
-
-    def __init__(
-        self,
-        message: str = "Authentication failed",
-        status_code: int = 401,
-        details: Optional[Dict[str, Any]] = None,
-        endpoint: Optional[str] = None
-    ):
-        super().__init__(message, status_code, details, endpoint)
-
-
-class AuthorizationError(DominusError):
-    """Raised when authorization fails (insufficient permissions)."""
-
-    def __init__(
-        self,
-        message: str = "Permission denied",
-        status_code: int = 403,
-        details: Optional[Dict[str, Any]] = None,
-        endpoint: Optional[str] = None
-    ):
-        super().__init__(message, status_code, details, endpoint)
-
-
-class NotFoundError(DominusError):
-    """Raised when a requested resource is not found."""
-
-    def __init__(
-        self,
-        message: str = "Resource not found",
-        status_code: int = 404,
-        details: Optional[Dict[str, Any]] = None,
-        endpoint: Optional[str] = None
-    ):
-        super().__init__(message, status_code, details, endpoint)
-
-
-class ValidationError(DominusError):
-    """Raised when request validation fails."""
-
-    def __init__(
-        self,
-        message: str = "Validation failed",
-        status_code: int = 400,
-        details: Optional[Dict[str, Any]] = None,
-        endpoint: Optional[str] = None
-    ):
-        super().__init__(message, status_code, details, endpoint)
-
-
-class ConflictError(DominusError):
-    """Raised when there's a conflict (duplicate key, version mismatch, etc.)."""
-
-    def __init__(
-        self,
-        message: str = "Conflict",
-        status_code: int = 409,
-        details: Optional[Dict[str, Any]] = None,
-        endpoint: Optional[str] = None
-    ):
-        super().__init__(message, status_code, details, endpoint)
-
-
-class ServiceError(DominusError):
-    """Raised when a backend service error occurs."""
-
-    def __init__(
-        self,
-        message: str = "Service error",
-        status_code: int = 500,
-        details: Optional[Dict[str, Any]] = None,
-        endpoint: Optional[str] = None
-    ):
-        super().__init__(message, status_code, details, endpoint)
-
-
-class ConnectionError(DominusError):
-    """Raised when connection to the backend fails."""
-
-    def __init__(
-        self,
-        message: str = "Connection failed",
-        status_code: Optional[int] = None,
-        details: Optional[Dict[str, Any]] = None,
-        endpoint: Optional[str] = None
-    ):
-        super().__init__(message, status_code, details, endpoint)
-
-
-class TimeoutError(DominusError):
-    """Raised when a request times out."""
-
-    def __init__(
-        self,
-        message: str = "Request timed out",
-        status_code: Optional[int] = None,
-        details: Optional[Dict[str, Any]] = None,
-        endpoint: Optional[str] = None
-    ):
-        super().__init__(message, status_code, details, endpoint)
-
-
-class SecureTableError(DominusError):
-    """Raised when accessing a secure table without providing a reason."""
-
-    def __init__(
-        self,
-        message: str = "Access to secure table requires 'reason' parameter",
-        status_code: int = 403,
-        details: Optional[Dict[str, Any]] = None,
-        endpoint: Optional[str] = None
-    ):
-        super().__init__(message, status_code, details, endpoint)
-
-
-def raise_for_status(
-    status_code: int,
-    message: str,
-    details: Optional[Dict[str, Any]] = None,
-    endpoint: Optional[str] = None
-) -> None:
-    """
-    Raise appropriate DominusError subclass based on status code.
-
-    Args:
-        status_code: HTTP status code
-        message: Error message
-        details: Optional error details
-        endpoint: Optional endpoint that was called
-
-    Raises:
-        Appropriate DominusError subclass
-    """
-    error_classes = {
-        400: ValidationError,
-        401: AuthenticationError,
-        403: AuthorizationError,
-        404: NotFoundError,
-        409: ConflictError,
-        500: ServiceError,
-        502: ServiceError,
-        503: ServiceError,
-        504: TimeoutError,
-    }
-
-    error_class = error_classes.get(status_code, DominusError)
-    raise error_class(message, status_code, details, endpoint)
+"""
+Dominus SDK Error Classes
+
+Custom exceptions for the Dominus SDK with structured error information.
+"""
+from typing import Any, Dict, Optional
+
+
+class DominusError(Exception):
+    """
+    Base exception for all Dominus SDK errors.
+
+    Provides structured error information including HTTP status codes,
+    error messages, and optional details from the backend.
+
+    Attributes:
+        message: Human-readable error message
+        status_code: HTTP status code (if applicable)
+        details: Additional error details from backend
+        endpoint: The endpoint that was called (if applicable)
+    """
+
+    def __init__(
+        self,
+        message: str,
+        status_code: Optional[int] = None,
+        details: Optional[Dict[str, Any]] = None,
+        endpoint: Optional[str] = None
+    ):
+        self.message = message
+        self.status_code = status_code
+        self.details = details or {}
+        self.endpoint = endpoint
+        super().__init__(self.message)
+
+    def __str__(self) -> str:
+        parts = [self.message]
+        if self.status_code:
+            parts.append(f"(status {self.status_code})")
+        if self.endpoint:
+            parts.append(f"at {self.endpoint}")
+        return " ".join(parts)
+
+    def __repr__(self) -> str:
+        return (
+            f"DominusError(message={self.message!r}, "
+            f"status_code={self.status_code}, "
+            f"details={self.details!r}, "
+            f"endpoint={self.endpoint!r})"
+        )
+
+
+class AuthenticationError(DominusError):
+    """Raised when authentication fails (invalid token, expired JWT, etc.)."""
+
+    def __init__(
+        self,
+        message: str = "Authentication failed",
+        status_code: int = 401,
+        details: Optional[Dict[str, Any]] = None,
+        endpoint: Optional[str] = None
+    ):
+        super().__init__(message, status_code, details, endpoint)
+
+
+class AuthorizationError(DominusError):
+    """Raised when authorization fails (insufficient permissions)."""
+
+    def __init__(
+        self,
+        message: str = "Permission denied",
+        status_code: int = 403,
+        details: Optional[Dict[str, Any]] = None,
+        endpoint: Optional[str] = None
+    ):
+        super().__init__(message, status_code, details, endpoint)
+
+
+class NotFoundError(DominusError):
+    """Raised when a requested resource is not found."""
+
+    def __init__(
+        self,
+        message: str = "Resource not found",
+        status_code: int = 404,
+        details: Optional[Dict[str, Any]] = None,
+        endpoint: Optional[str] = None
+    ):
+        super().__init__(message, status_code, details, endpoint)
+
+
+class ValidationError(DominusError):
+    """Raised when request validation fails."""
+
+    def __init__(
+        self,
+        message: str = "Validation failed",
+        status_code: int = 400,
+        details: Optional[Dict[str, Any]] = None,
+        endpoint: Optional[str] = None
+    ):
+        super().__init__(message, status_code, details, endpoint)
+
+
+class ConflictError(DominusError):
+    """Raised when there's a conflict (duplicate key, version mismatch, etc.)."""
+
+    def __init__(
+        self,
+        message: str = "Conflict",
+        status_code: int = 409,
+        details: Optional[Dict[str, Any]] = None,
+        endpoint: Optional[str] = None
+    ):
+        super().__init__(message, status_code, details, endpoint)
+
+
+class ServiceError(DominusError):
+    """Raised when a backend service error occurs."""
+
+    def __init__(
+        self,
+        message: str = "Service error",
+        status_code: int = 500,
+        details: Optional[Dict[str, Any]] = None,
+        endpoint: Optional[str] = None
+    ):
+        super().__init__(message, status_code, details, endpoint)
+
+
+class ConnectionError(DominusError):
+    """Raised when connection to the backend fails."""
+
+    def __init__(
+        self,
+        message: str = "Connection failed",
+        status_code: Optional[int] = None,
+        details: Optional[Dict[str, Any]] = None,
+        endpoint: Optional[str] = None
+    ):
+        super().__init__(message, status_code, details, endpoint)
+
+
+class TimeoutError(DominusError):
+    """Raised when a request times out."""
+
+    def __init__(
+        self,
+        message: str = "Request timed out",
+        status_code: Optional[int] = None,
+        details: Optional[Dict[str, Any]] = None,
+        endpoint: Optional[str] = None
+    ):
+        super().__init__(message, status_code, details, endpoint)
+
+
+class SecureTableError(DominusError):
+    """Raised when accessing a secure table without providing a reason."""
+
+    def __init__(
+        self,
+        message: str = "Access to secure table requires 'reason' parameter",
+        status_code: int = 403,
+        details: Optional[Dict[str, Any]] = None,
+        endpoint: Optional[str] = None
+    ):
+        super().__init__(message, status_code, details, endpoint)
+
+
+def raise_for_status(
+    status_code: int,
+    message: str,
+    details: Optional[Dict[str, Any]] = None,
+    endpoint: Optional[str] = None
+) -> None:
+    """
+    Raise appropriate DominusError subclass based on status code.
+
+    Args:
+        status_code: HTTP status code
+        message: Error message
+        details: Optional error details
+        endpoint: Optional endpoint that was called
+
+    Raises:
+        Appropriate DominusError subclass
+    """
+    error_classes = {
+        400: ValidationError,
+        401: AuthenticationError,
+        403: AuthorizationError,
+        404: NotFoundError,
+        409: ConflictError,
+        500: ServiceError,
+        502: ServiceError,
+        503: ServiceError,
+        504: TimeoutError,
+    }
+
+    error_class = error_classes.get(status_code, DominusError)
+    raise error_class(message, status_code, details, endpoint)

dominus/helpers/__init__.py

@@ -1,2 +1,2 @@
-"""Helper modules for CB Dominus SDK - Internal use only"""
-
+"""Helper modules for CB Dominus SDK - Internal use only"""
+