mdb-engine 0.2.0__py3-none-any.whl → 0.2.3__py3-none-any.whl

mdb_engine/auth/utils.py

@@ -11,7 +11,7 @@ import logging
 import re
 import uuid
 from datetime import datetime
-from typing import Any, Dict, List, Optional, Tuple
+from typing import Any
 
 import bcrypt
 from fastapi import Request, Response
@@ -43,7 +43,7 @@ def _detect_browser(user_agent: str) -> str:
     return "unknown"
 
 
-def _detect_os_and_device_type(user_agent: str) -> Tuple[str, str]:
+def _detect_os_and_device_type(user_agent: str) -> tuple[str, str]:
     """Detect OS and device type from user agent string."""
     if not user_agent:
         return "unknown", "desktop"
@@ -64,7 +64,7 @@ def _detect_os_and_device_type(user_agent: str) -> Tuple[str, str]:
     return "unknown", "desktop"
 
 
-def get_device_info(request: Request) -> Dict[str, Any]:
+def get_device_info(request: Request) -> dict[str, Any]:
     """
     Extract device information from request.
 
@@ -236,15 +236,15 @@ async def check_password_breach(password: str) -> bool:
 
 def validate_password_strength(
     password: str,
-    min_length: Optional[int] = None,
-    require_uppercase: Optional[bool] = None,
-    require_lowercase: Optional[bool] = None,
-    require_numbers: Optional[bool] = None,
-    require_special: Optional[bool] = None,
-    min_entropy_bits: Optional[int] = None,
-    check_common_passwords: Optional[bool] = None,
-    config: Optional[Dict[str, Any]] = None,
-) -> Tuple[bool, List[str]]:
+    min_length: int | None = None,
+    require_uppercase: bool | None = None,
+    require_lowercase: bool | None = None,
+    require_numbers: bool | None = None,
+    require_special: bool | None = None,
+    min_entropy_bits: int | None = None,
+    check_common_passwords: bool | None = None,
+    config: dict[str, Any] | None = None,
+) -> tuple[bool, list[str]]:
     """
     Validate password strength with configurable rules.
 
@@ -338,9 +338,9 @@ def validate_password_strength(
 
 async def validate_password_strength_async(
     password: str,
-    config: Optional[Dict[str, Any]] = None,
-    check_breaches: Optional[bool] = None,
-) -> Tuple[bool, List[str]]:
+    config: dict[str, Any] | None = None,
+    check_breaches: bool | None = None,
+) -> tuple[bool, list[str]]:
     """
     Async version of validate_password_strength with breach checking.
 
@@ -404,10 +404,10 @@ async def login_user(
     email: str,
     password: str,
     db,
-    config: Optional[Dict[str, Any]] = None,
+    config: dict[str, Any] | None = None,
     remember_me: bool = False,
-    redirect_url: Optional[str] = None,
-) -> Dict[str, Any]:
+    redirect_url: str | None = None,
+) -> dict[str, Any]:
     """
     Handle user login with automatic token generation and cookie setting.
 
@@ -571,8 +571,8 @@ def _validate_email_format(email: str) -> bool:
 
 
 def _get_password_policy_from_config(
-    request: Request, config: Optional[Dict[str, Any]]
-) -> Optional[Dict[str, Any]]:
+    request: Request, config: dict[str, Any] | None
+) -> dict[str, Any] | None:
     """Get password policy from config or request."""
     if config:
         security = config.get("security", {})
@@ -585,8 +585,8 @@ def _get_password_policy_from_config(
 
 
 async def _create_user_document(
-    email: str, password: str, extra_data: Optional[Dict[str, Any]]
-) -> Dict[str, Any]:
+    email: str, password: str, extra_data: dict[str, Any] | None
+) -> dict[str, Any]:
     """Create user document with hashed password."""
     password_hash = bcrypt.hashpw(password.encode("utf-8"), bcrypt.gensalt())
     user_doc = {
@@ -600,9 +600,7 @@ async def _create_user_document(
     return user_doc
 
 
-def _create_registration_response(
-    user_doc: Dict[str, Any], redirect_url: Optional[str]
-) -> Response:
+def _create_registration_response(user_doc: dict[str, Any], redirect_url: str | None) -> Response:
     """Create response for registration."""
     if redirect_url:
         return RedirectResponse(url=redirect_url, status_code=302)
@@ -622,10 +620,10 @@ async def register_user(
     email: str,
     password: str,
     db,
-    config: Optional[Dict[str, Any]] = None,
-    extra_data: Optional[Dict[str, Any]] = None,
-    redirect_url: Optional[str] = None,
-) -> Dict[str, Any]:
+    config: dict[str, Any] | None = None,
+    extra_data: dict[str, Any] | None = None,
+    redirect_url: str | None = None,
+) -> dict[str, Any]:
     """
     Handle user registration with automatic token generation.
 
@@ -710,7 +708,7 @@ async def register_user(
         return {"success": False, "error": "Registration failed. Please try again."}
 
 
-async def _get_user_id_from_request(request: Request, user_id: Optional[str]) -> Optional[str]:
+async def _get_user_id_from_request(request: Request, user_id: str | None) -> str | None:
     """Extract user_id from request if not provided."""
     if user_id:
         return user_id
@@ -773,9 +771,7 @@ async def _revoke_session(request: Request) -> None:
             await session_mgr.revoke_session_by_refresh_token(refresh_jti)
 
 
-async def logout_user(
-    request: Request, response: Response, user_id: Optional[str] = None
-) -> Response:
+async def logout_user(request: Request, response: Response, user_id: str | None = None) -> Response:
     """
     Handle user logout with token revocation and cookie clearing.
 

mdb_engine/cli/commands/generate.py

@@ -17,7 +17,7 @@ This module is part of MDB_ENGINE - MongoDB Engine.
 
 import json
 from pathlib import Path
-from typing import Any, Dict, List, Optional
+from typing import Any
 
 import click
 
@@ -210,7 +210,7 @@ class AppGenerator:
         output_dir: Path = Path("."),
         multi_site: bool = False,
         enable_ray: bool = False,
-        read_scopes: Optional[List[str]] = None,
+        read_scopes: list[str] | None = None,
     ) -> Path:
         """
         Generate a new app with proper structure.
@@ -283,10 +283,10 @@ class AppGenerator:
         description: str,
         multi_site: bool,
         enable_ray: bool,
-        read_scopes: List[str],
-    ) -> Dict[str, Any]:
+        read_scopes: list[str],
+    ) -> dict[str, Any]:
         """Generate manifest.json content."""
-        manifest: Dict[str, Any] = {
+        manifest: dict[str, Any] = {
             "schema_version": CURRENT_SCHEMA_VERSION,
             "slug": app_slug,
             "name": app_name,
@@ -476,7 +476,7 @@ def generate_manifest(
             )
 
         # Generate template manifest
-        manifest: Dict[str, Any] = {
+        manifest: dict[str, Any] = {
             "schema_version": CURRENT_SCHEMA_VERSION,
             "slug": slug,
             "name": name,

mdb_engine/cli/utils.py

@@ -8,12 +8,12 @@ This module is part of MDB_ENGINE - MongoDB Engine.
 
 import json
 from pathlib import Path
-from typing import Any, Dict
+from typing import Any
 
 import click
 
 
-def load_manifest_file(file_path: Path) -> Dict[str, Any]:
+def load_manifest_file(file_path: Path) -> dict[str, Any]:
     """
     Load a manifest JSON file.
 
@@ -36,7 +36,7 @@ def load_manifest_file(file_path: Path) -> Dict[str, Any]:
         raise click.ClickException(f"Invalid JSON in manifest file: {e}") from e
 
 
-def save_manifest_file(file_path: Path, manifest: Dict[str, Any]) -> None:
+def save_manifest_file(file_path: Path, manifest: dict[str, Any]) -> None:
     """
     Save a manifest dictionary to a JSON file.
 
@@ -54,7 +54,7 @@ def save_manifest_file(file_path: Path, manifest: Dict[str, Any]) -> None:
         raise click.ClickException(f"Failed to write manifest file: {e}") from e
 
 
-def format_manifest_output(manifest: Dict[str, Any], format_type: str) -> str:
+def format_manifest_output(manifest: dict[str, Any], format_type: str) -> str:
     """
     Format manifest for output.
 

mdb_engine/config.py

@@ -7,7 +7,6 @@ with direct parameters as before.
 """
 
 import os
-from typing import Optional
 
 try:
     from pydantic import BaseSettings, Field
@@ -46,12 +45,12 @@ class EngineConfig:
 
     def __init__(
         self,
-        mongo_uri: Optional[str] = None,
-        db_name: Optional[str] = None,
-        max_pool_size: Optional[int] = None,
-        min_pool_size: Optional[int] = None,
-        server_selection_timeout_ms: Optional[int] = None,
-        authz_cache_ttl: Optional[int] = None,
+        mongo_uri: str | None = None,
+        db_name: str | None = None,
+        max_pool_size: int | None = None,
+        min_pool_size: int | None = None,
+        server_selection_timeout_ms: int | None = None,
+        authz_cache_ttl: int | None = None,
     ):
         """
         Initialize configuration.

mdb_engine/core/app_registration.py

@@ -10,8 +10,9 @@ This module is part of MDB_ENGINE - MongoDB Engine.
 import asyncio
 import logging
 import time
+from collections.abc import Callable
 from pathlib import Path
-from typing import TYPE_CHECKING, Any, Callable, Dict, List, Optional, Tuple
+from typing import TYPE_CHECKING, Any, Optional
 
 from jsonschema import SchemaError
 from jsonschema import ValidationError as JsonSchemaValidationError
@@ -58,11 +59,11 @@ class AppRegistrationManager:
         self._mongo_db = mongo_db
         self.manifest_validator = manifest_validator
         self.manifest_parser = manifest_parser
-        self._apps: Dict[str, Dict[str, Any]] = {}
+        self._apps: dict[str, dict[str, Any]] = {}
 
     async def validate_manifest(
         self, manifest: "ManifestDict"
-    ) -> Tuple[bool, Optional[str], Optional[List[str]]]:
+    ) -> tuple[bool, str | None, list[str] | None]:
         """
         Validate a manifest against the schema.
 
@@ -115,13 +116,12 @@ class AppRegistrationManager:
     async def register_app(
         self,
         manifest: "ManifestDict",
-        create_indexes_callback: Optional[Callable[[str, "ManifestDict"], Any]] = None,
-        seed_data_callback: Optional[Callable[[str, Dict[str, List[Dict[str, Any]]]], Any]] = None,
-        initialize_memory_callback: Optional[Callable[[str, Dict[str, Any]], Any]] = None,
-        register_websockets_callback: Optional[Callable[[str, Dict[str, Any]], Any]] = None,
-        setup_observability_callback: Optional[
-            Callable[[str, "ManifestDict", Dict[str, Any]], Any]
-        ] = None,
+        create_indexes_callback: Callable[[str, "ManifestDict"], Any] | None = None,
+        seed_data_callback: Callable[[str, dict[str, list[dict[str, Any]]]], Any] | None = None,
+        initialize_memory_callback: Callable[[str, dict[str, Any]], Any] | None = None,
+        register_websockets_callback: Callable[[str, dict[str, Any]], Any] | None = None,
+        setup_observability_callback: Callable[[str, "ManifestDict", dict[str, Any]], Any]
+        | None = None,
     ) -> bool:
         """
         Register an app from its manifest.
@@ -142,7 +142,7 @@ class AppRegistrationManager:
         """
         start_time = time.time()
 
-        slug: Optional[str] = manifest.get("slug")
+        slug: str | None = manifest.get("slug")
         if not slug:
             contextual_logger.error(
                 "Cannot register app: missing 'slug' in manifest",
@@ -359,7 +359,7 @@ class AppRegistrationManager:
         """
         return self._apps.get(slug)
 
-    def list_apps(self) -> List[str]:
+    def list_apps(self) -> list[str]:
         """
         List all registered app slugs.
 

mdb_engine/core/app_secrets.py

@@ -13,7 +13,6 @@ import base64
 import logging
 import secrets
 from datetime import datetime
-from typing import Optional
 
 from motor.motor_asyncio import AsyncIOMotorDatabase
 from pymongo.errors import OperationFailure, PyMongoError
@@ -188,7 +187,7 @@ class AppSecretsManager:
             logger.warning(f"Secret verification failed for app '{app_slug}'")
         return result
 
-    async def get_app_secret(self, app_slug: str) -> Optional[str]:
+    async def get_app_secret(self, app_slug: str) -> str | None:
         """
         Get decrypted app secret (for rotation purposes only).
 

mdb_engine/core/connection.py

@@ -9,7 +9,6 @@ This module is part of MDB_ENGINE - MongoDB Engine.
 
 import logging
 import time
-from typing import Optional
 
 from motor.motor_asyncio import AsyncIOMotorClient, AsyncIOMotorDatabase
 from pymongo.errors import ConnectionFailure, ServerSelectionTimeoutError
@@ -57,8 +56,8 @@ class ConnectionManager:
         self.min_pool_size = min_pool_size
 
         # Connection state
-        self._mongo_client: Optional[AsyncIOMotorClient] = None
-        self._mongo_db: Optional[AsyncIOMotorDatabase] = None
+        self._mongo_client: AsyncIOMotorClient | None = None
+        self._mongo_db: AsyncIOMotorDatabase | None = None
         self._initialized: bool = False
 
     async def initialize(self) -> None:
@@ -242,7 +241,7 @@ class ConnectionManager:
         self._mongo_db = None
 
     @mongo_db.setter
-    def mongo_db(self, value: Optional[AsyncIOMotorDatabase]) -> None:
+    def mongo_db(self, value: AsyncIOMotorDatabase | None) -> None:
         """Allow setting mongo_db property for testing purposes."""
         self._mongo_db = value
 

mdb_engine/core/encryption.py

@@ -19,7 +19,6 @@ import base64
 import logging
 import os
 import secrets
-from typing import Tuple
 
 import cryptography.exceptions
 from cryptography.hazmat.primitives.ciphers.aead import AESGCM
@@ -121,7 +120,7 @@ class EnvelopeEncryptionService:
         """
         return secrets.token_bytes(AES_KEY_SIZE)
 
-    def encrypt_secret(self, secret: str, master_key: bytes | None = None) -> Tuple[bytes, bytes]:
+    def encrypt_secret(self, secret: str, master_key: bytes | None = None) -> tuple[bytes, bytes]:
         """
         Encrypt a secret using envelope encryption.
 

mdb_engine/core/engine.py

@@ -28,9 +28,10 @@ Usage:
 import logging
 import os
 import secrets
+from collections.abc import Awaitable, Callable
 from contextlib import asynccontextmanager
 from pathlib import Path
-from typing import TYPE_CHECKING, Any, Awaitable, Callable, Dict, List, Optional, Tuple
+from typing import TYPE_CHECKING, Any, Optional
 
 from motor.motor_asyncio import AsyncIOMotorClient
 from pymongo.errors import PyMongoError
@@ -94,7 +95,7 @@ class MongoDBEngine:
         self,
         mongo_uri: str,
         db_name: str,
-        manifests_dir: Optional[Path] = None,
+        manifests_dir: Path | None = None,
         authz_provider: Optional["AuthorizationProvider"] = None,
         max_pool_size: int = DEFAULT_MAX_POOL_SIZE,
         min_pool_size: int = DEFAULT_MIN_POOL_SIZE,
@@ -142,17 +143,17 @@ class MongoDBEngine:
         self.manifest_parser = ManifestParser()
 
         # Initialize managers (will be set up after connection is established)
-        self._app_registration_manager: Optional[AppRegistrationManager] = None
-        self._index_manager: Optional[IndexManager] = None
-        self._service_initializer: Optional[ServiceInitializer] = None
-        self._encryption_service: Optional[EnvelopeEncryptionService] = None
-        self._app_secrets_manager: Optional[AppSecretsManager] = None
+        self._app_registration_manager: AppRegistrationManager | None = None
+        self._index_manager: IndexManager | None = None
+        self._service_initializer: ServiceInitializer | None = None
+        self._encryption_service: EnvelopeEncryptionService | None = None
+        self._app_secrets_manager: AppSecretsManager | None = None
 
         # Store app read_scopes mapping for validation
-        self._app_read_scopes: Dict[str, List[str]] = {}
+        self._app_read_scopes: dict[str, list[str]] = {}
 
         # Store app token cache for auto-retrieval
-        self._app_token_cache: Dict[str, str] = {}
+        self._app_token_cache: dict[str, str] = {}
 
     async def initialize(self) -> None:
         """
@@ -300,9 +301,9 @@ class MongoDBEngine:
     def get_scoped_db(
         self,
         app_slug: str,
-        app_token: Optional[str] = None,
-        read_scopes: Optional[List[str]] = None,
-        write_scope: Optional[str] = None,
+        app_token: str | None = None,
+        read_scopes: list[str] | None = None,
+        write_scope: str | None = None,
         auto_index: bool = True,
     ) -> ScopedMongoWrapper:
         """
@@ -435,9 +436,9 @@ class MongoDBEngine:
     async def get_scoped_db_async(
         self,
         app_slug: str,
-        app_token: Optional[str] = None,
-        read_scopes: Optional[List[str]] = None,
-        write_scope: Optional[str] = None,
+        app_token: str | None = None,
+        read_scopes: list[str] | None = None,
+        write_scope: str | None = None,
         auto_index: bool = True,
     ) -> ScopedMongoWrapper:
         """
@@ -540,7 +541,7 @@ class MongoDBEngine:
 
     async def validate_manifest(
         self, manifest: "ManifestDict"
-    ) -> Tuple[bool, Optional[str], Optional[List[str]]]:
+    ) -> tuple[bool, str | None, list[str] | None]:
         """
         Validate a manifest against the schema.
 
@@ -604,16 +605,16 @@ class MongoDBEngine:
             if self._index_manager and create_indexes:
                 await self._index_manager.create_app_indexes(slug, manifest)
 
-        async def seed_data_callback(slug: str, initial_data: Dict[str, Any]) -> None:
+        async def seed_data_callback(slug: str, initial_data: dict[str, Any]) -> None:
             if self._service_initializer:
                 await self._service_initializer.seed_initial_data(slug, initial_data)
 
-        async def initialize_memory_callback(slug: str, memory_config: Dict[str, Any]) -> None:
+        async def initialize_memory_callback(slug: str, memory_config: dict[str, Any]) -> None:
             if self._service_initializer:
                 await self._service_initializer.initialize_memory_service(slug, memory_config)
 
         async def register_websockets_callback(
-            slug: str, websockets_config: Dict[str, Any]
+            slug: str, websockets_config: dict[str, Any]
         ) -> None:
             if self._service_initializer:
                 await self._service_initializer.register_websockets(slug, websockets_config)
@@ -621,7 +622,7 @@ class MongoDBEngine:
         async def setup_observability_callback(
             slug: str,
             manifest: "ManifestDict",
-            observability_config: Dict[str, Any],
+            observability_config: dict[str, Any],
         ) -> None:
             if self._service_initializer:
                 await self._service_initializer.setup_observability(
@@ -665,7 +666,7 @@ class MongoDBEngine:
 
         return result
 
-    def get_websocket_config(self, slug: str) -> Optional[Dict[str, Any]]:
+    def get_websocket_config(self, slug: str) -> dict[str, Any] | None:
         """
         Get WebSocket configuration for an app.
 
@@ -851,7 +852,7 @@ class MongoDBEngine:
             raise RuntimeError("MongoDBEngine not initialized. Call initialize() first.")
         return await self._app_registration_manager.get_manifest(slug)
 
-    def get_memory_service(self, slug: str) -> Optional[Any]:
+    def get_memory_service(self, slug: str) -> Any | None:
         """
         Get Mem0 memory service for an app.
 
@@ -875,7 +876,7 @@ class MongoDBEngine:
             return self._service_initializer.get_memory_service(slug)
         return None
 
-    def get_embedding_service(self, slug: str) -> Optional[Any]:
+    def get_embedding_service(self, slug: str) -> Any | None:
         """
         Get EmbeddingService for an app.
 
@@ -900,7 +901,7 @@ class MongoDBEngine:
         return get_embedding_service_for_app(slug, self)
 
     @property
-    def _apps(self) -> Dict[str, Any]:
+    def _apps(self) -> dict[str, Any]:
         """
         Get the apps dictionary (for backward compatibility with tests).
 
@@ -914,7 +915,7 @@ class MongoDBEngine:
             raise RuntimeError("MongoDBEngine not initialized. Call initialize() first.")
         return self._app_registration_manager._apps
 
-    def list_apps(self) -> List[str]:
+    def list_apps(self) -> list[str]:
         """
         List all registered app slugs.
 
@@ -958,9 +959,9 @@ class MongoDBEngine:
 
     def __exit__(
         self,
-        exc_type: Optional[type[BaseException]],
-        exc_val: Optional[BaseException],
-        exc_tb: Optional[Any],
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: Any | None,
     ) -> None:
         """
         Context manager exit (synchronous).
@@ -991,9 +992,9 @@ class MongoDBEngine:
 
     async def __aexit__(
         self,
-        exc_type: Optional[type[BaseException]],
-        exc_val: Optional[BaseException],
-        exc_tb: Optional[Any],
+        exc_type: type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: Any | None,
     ) -> None:
         """
         Async context manager exit.
@@ -1007,7 +1008,7 @@ class MongoDBEngine:
         """
         await self.shutdown()
 
-    async def get_health_status(self) -> Dict[str, Any]:
+    async def get_health_status(self) -> dict[str, Any]:
         """
         Get health status of the MongoDB Engine.
 
@@ -1069,7 +1070,7 @@ class MongoDBEngine:
 
         return await health_checker.check_all()
 
-    def get_metrics(self) -> Dict[str, Any]:
+    def get_metrics(self) -> dict[str, Any]:
         """
         Get metrics for the MongoDB Engine.
 
@@ -1089,13 +1090,11 @@ class MongoDBEngine:
         self,
         slug: str,
         manifest: Path,
-        title: Optional[str] = None,
-        on_startup: Optional[
-            Callable[["FastAPI", "MongoDBEngine", Dict[str, Any]], Awaitable[None]]
-        ] = None,
-        on_shutdown: Optional[
-            Callable[["FastAPI", "MongoDBEngine", Dict[str, Any]], Awaitable[None]]
-        ] = None,
+        title: str | None = None,
+        on_startup: Callable[["FastAPI", "MongoDBEngine", dict[str, Any]], Awaitable[None]]
+        | None = None,
+        on_shutdown: Callable[["FastAPI", "MongoDBEngine", dict[str, Any]], Awaitable[None]]
+        | None = None,
         **fastapi_kwargs: Any,
     ) -> "FastAPI":
         """
@@ -1170,7 +1169,7 @@ class MongoDBEngine:
         app_title = title or pre_manifest.get("name", slug)
 
         # State that will be populated during initialization
-        app_manifest: Dict[str, Any] = {}
+        app_manifest: dict[str, Any] = {}
         is_multi_site = False
 
         @asynccontextmanager
@@ -1506,7 +1505,7 @@ class MongoDBEngine:
     async def _initialize_shared_user_pool(
         self,
         app: "FastAPI",
-        manifest: Optional[Dict[str, Any]] = None,
+        manifest: dict[str, Any] | None = None,
     ) -> None:
         """
         Initialize shared user pool, audit log, and set them on app.state.
@@ -1644,7 +1643,7 @@ class MongoDBEngine:
 
         return _lifespan
 
-    async def auto_retrieve_app_token(self, slug: str) -> Optional[str]:
+    async def auto_retrieve_app_token(self, slug: str) -> str | None:
         """
         Auto-retrieve app token from environment or database.
 
@@ -1697,7 +1696,7 @@ class MongoDBEngine:
         )
         return None
 
-    def get_app_token(self, slug: str) -> Optional[str]:
+    def get_app_token(self, slug: str) -> str | None:
         """
         Get cached app token for a slug.