crudadmin 0.3.0__tar.gz → 0.3.2__tar.gz

{crudadmin-0.3.0 → crudadmin-0.3.2}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: crudadmin
-Version: 0.3.0
+Version: 0.3.2
 Summary: FastAPI-based admin interface with authentication, event logging and CRUD operations
-Project-URL: Homepage, https://github.com/igorbenav/crudadmin
-Project-URL: Documentation, https://igorbenav.github.io/crudadmin
-Project-URL: Repository, https://github.com/igorbenav/crudadmin
-Project-URL: Issues, https://github.com/igorbenav/crudadmin/issues
-Project-URL: Changelog, https://github.com/igorbenav/crudadmin/releases
+Project-URL: Homepage, https://github.com/benavlabs/crudadmin
+Project-URL: Documentation, https://benavlabs.github.io/crudadmin
+Project-URL: Repository, https://github.com/benavlabs/crudadmin
+Project-URL: Issues, https://github.com/benavlabs/crudadmin/issues
+Project-URL: Changelog, https://github.com/benavlabs/crudadmin/releases
 Author-email: Igor Benav <igor.magalhaes.r@gmail.com>
 License-File: LICENSE
 Classifier: Development Status :: 3 - Alpha
@@ -27,11 +27,11 @@ Classifier: Topic :: Internet :: WWW/HTTP
 Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
 Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
 Classifier: Typing :: Typed
-Requires-Python: >=3.9
+Requires-Python: >=3.9.2
 Requires-Dist: aiosqlite>=0.20.0
 Requires-Dist: bcrypt>=4.2.1
 Requires-Dist: fastapi>=0.115.6
-Requires-Dist: fastcrud>=0.15.5
+Requires-Dist: fastcrud>=0.15.12
 Requires-Dist: greenlet>=3.1.1
 Requires-Dist: jinja2>=3.1.5
 Requires-Dist: pydantic-settings>=2.6.1
@@ -88,7 +88,7 @@ Description-Content-Type: text/markdown
 # CRUDAdmin
 
 <p align="center">
-  <a href="https://igorbenav.github.io/crudadmin/">
+  <a href="https://benavlabs.github.io/crudadmin/">
     <img src="docs/assets/CRUDAdmin.png" alt="CRUDAdmin logo" width="45%" height="auto">
   </a>
 </p>
@@ -98,8 +98,8 @@ Description-Content-Type: text/markdown
 </p>
 
 <p align="center">
-<a href="https://github.com/igorbenav/crudadmin/actions/workflows/tests.yml">
-  <img src="https://github.com/igorbenav/crudadmin/actions/workflows/tests.yml/badge.svg" alt="Tests"/>
+<a href="https://github.com/benavlabs/crudadmin/actions/workflows/tests.yml">
+  <img src="https://github.com/benavlabs/crudadmin/actions/workflows/tests.yml/badge.svg" alt="Tests"/>
 </a>
 <a href="https://pypi.org/project/crudadmin/">
   <img src="https://img.shields.io/pypi/v/crudadmin?color=%2334D058&label=pypi%20package" alt="PyPi Version"/>
@@ -113,7 +113,7 @@ Description-Content-Type: text/markdown
 
 **CRUDAdmin** is a robust admin interface generator for **FastAPI** applications, offering secure authentication, comprehensive event tracking, and essential monitoring features. Built with [FastCRUD](https://github.com/benavlabs/fastcrud) and HTMX, it helps you create production-ready admin panels with minimal configuration.
 
-**Documentation**: [https://igorbenav.github.io/crudadmin/](https://igorbenav.github.io/crudadmin/)
+**Documentation**: [https://benavlabs.github.io/crudadmin/](https://benavlabs.github.io/crudadmin/)
 
 > [!WARNING]  
 > CRUDAdmin is still experimental. While actively developed and tested, APIs may change between versions. Upgrade with caution in production environments, always carefuly reading the changelog.
@@ -127,6 +127,16 @@ Description-Content-Type: text/markdown
 - **🔍 Advanced Filtering**: Type-aware field filtering, search, and pagination with bulk operations
 - **🌗 Modern UI**: Clean, responsive interface built with HTMX and [FastCRUD](https://github.com/benavlabs/fastcrud)
 
+## Video Preview
+
+<p align="center">To see what CRUDAdmin dashboard actually looks like in practice, watch the video demo on youtube:</p>
+<p align="center">
+  <a href="https://www.youtube.com/watch?v=THLdUbDQ9yM">
+    <img src="docs/assets/youtube-preview.png" alt="Watch CRUDAdmin Dashboard Demo on Youtube" width="75%" height="auto"/>
+  </a>
+</p>
+<br>
+
 ## Quick Start
 
 ### Installation
@@ -161,11 +171,15 @@ from .user import (
 
 # Database setup
 engine = create_async_engine("sqlite+aiosqlite:///app.db")
-session = AsyncSession(engine)
+
+# Create database session dependency
+async def get_session():
+    async with AsyncSession(engine) as session:
+        yield session
 
 # Create admin interface
 admin = CRUDAdmin(
-    session=session,
+    session=get_session,
     SECRET_KEY="your-secret-key-here",
     initial_admin={
         "username": "admin",
@@ -208,12 +222,12 @@ Navigate to `/admin` to access your admin interface with:
 
 ### Development (Default)
 ```python
-admin = CRUDAdmin(session=session, SECRET_KEY="key")  # Memory backend
+admin = CRUDAdmin(session=get_session, SECRET_KEY="key")  # Memory backend
 ```
 
 ### Production with Redis
 ```python
-admin = CRUDAdmin(session=session, SECRET_KEY="key").use_redis_sessions(
+admin = CRUDAdmin(session=get_session, SECRET_KEY="key").use_redis_sessions(
     redis_url="redis://localhost:6379"
 )
 ```
@@ -221,7 +235,7 @@ admin = CRUDAdmin(session=session, SECRET_KEY="key").use_redis_sessions(
 ### Production with Security Features
 ```python
 admin = CRUDAdmin(
-    session=session,
+    session=get_session,
     SECRET_KEY=SECRET_KEY,
     # Security features
     allowed_ips=["10.0.0.1"],
@@ -260,11 +274,16 @@ admin = CRUDAdmin(
 
 ## Documentation
 
-- **[Quick Start](https://igorbenav.github.io/crudadmin/quick-start/)**: Get up and running in 5 minutes
-- **[Usage Guide](https://igorbenav.github.io/crudadmin/usage/overview/)**: Complete usage documentation
-- **[API Reference](https://igorbenav.github.io/crudadmin/api/overview/)**: Full API documentation
-- **[Advanced Topics](https://igorbenav.github.io/crudadmin/advanced/overview/)**: Production features and configurations
+- **[Quick Start](https://benavlabs.github.io/crudadmin/quick-start/)**: Get up and running in 5 minutes
+- **[Usage Guide](https://benavlabs.github.io/crudadmin/usage/overview/)**: Complete usage documentation
+- **[API Reference](https://benavlabs.github.io/crudadmin/api/overview/)**: Full API documentation
+- **[Advanced Topics](https://benavlabs.github.io/crudadmin/advanced/overview/)**: Production features and configurations
 
 ## License
 
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+<hr>
+<a href="https://benav.io">
+  <img src="docs/assets/benav_labs_banner.png" alt="Powered by Benav Labs - benav.io"/>
+</a>

{crudadmin-0.3.0 → crudadmin-0.3.2}/README.md

@@ -1,7 +1,7 @@
 # CRUDAdmin
 
 <p align="center">
-  <a href="https://igorbenav.github.io/crudadmin/">
+  <a href="https://benavlabs.github.io/crudadmin/">
     <img src="docs/assets/CRUDAdmin.png" alt="CRUDAdmin logo" width="45%" height="auto">
   </a>
 </p>
@@ -11,8 +11,8 @@
 </p>
 
 <p align="center">
-<a href="https://github.com/igorbenav/crudadmin/actions/workflows/tests.yml">
-  <img src="https://github.com/igorbenav/crudadmin/actions/workflows/tests.yml/badge.svg" alt="Tests"/>
+<a href="https://github.com/benavlabs/crudadmin/actions/workflows/tests.yml">
+  <img src="https://github.com/benavlabs/crudadmin/actions/workflows/tests.yml/badge.svg" alt="Tests"/>
 </a>
 <a href="https://pypi.org/project/crudadmin/">
   <img src="https://img.shields.io/pypi/v/crudadmin?color=%2334D058&label=pypi%20package" alt="PyPi Version"/>
@@ -26,7 +26,7 @@
 
 **CRUDAdmin** is a robust admin interface generator for **FastAPI** applications, offering secure authentication, comprehensive event tracking, and essential monitoring features. Built with [FastCRUD](https://github.com/benavlabs/fastcrud) and HTMX, it helps you create production-ready admin panels with minimal configuration.
 
-**Documentation**: [https://igorbenav.github.io/crudadmin/](https://igorbenav.github.io/crudadmin/)
+**Documentation**: [https://benavlabs.github.io/crudadmin/](https://benavlabs.github.io/crudadmin/)
 
 > [!WARNING]  
 > CRUDAdmin is still experimental. While actively developed and tested, APIs may change between versions. Upgrade with caution in production environments, always carefuly reading the changelog.
@@ -40,6 +40,16 @@
 - **🔍 Advanced Filtering**: Type-aware field filtering, search, and pagination with bulk operations
 - **🌗 Modern UI**: Clean, responsive interface built with HTMX and [FastCRUD](https://github.com/benavlabs/fastcrud)
 
+## Video Preview
+
+<p align="center">To see what CRUDAdmin dashboard actually looks like in practice, watch the video demo on youtube:</p>
+<p align="center">
+  <a href="https://www.youtube.com/watch?v=THLdUbDQ9yM">
+    <img src="docs/assets/youtube-preview.png" alt="Watch CRUDAdmin Dashboard Demo on Youtube" width="75%" height="auto"/>
+  </a>
+</p>
+<br>
+
 ## Quick Start
 
 ### Installation
@@ -74,11 +84,15 @@ from .user import (
 
 # Database setup
 engine = create_async_engine("sqlite+aiosqlite:///app.db")
-session = AsyncSession(engine)
+
+# Create database session dependency
+async def get_session():
+    async with AsyncSession(engine) as session:
+        yield session
 
 # Create admin interface
 admin = CRUDAdmin(
-    session=session,
+    session=get_session,
     SECRET_KEY="your-secret-key-here",
     initial_admin={
         "username": "admin",
@@ -121,12 +135,12 @@ Navigate to `/admin` to access your admin interface with:
 
 ### Development (Default)
 ```python
-admin = CRUDAdmin(session=session, SECRET_KEY="key")  # Memory backend
+admin = CRUDAdmin(session=get_session, SECRET_KEY="key")  # Memory backend
 ```
 
 ### Production with Redis
 ```python
-admin = CRUDAdmin(session=session, SECRET_KEY="key").use_redis_sessions(
+admin = CRUDAdmin(session=get_session, SECRET_KEY="key").use_redis_sessions(
     redis_url="redis://localhost:6379"
 )
 ```
@@ -134,7 +148,7 @@ admin = CRUDAdmin(session=session, SECRET_KEY="key").use_redis_sessions(
 ### Production with Security Features
 ```python
 admin = CRUDAdmin(
-    session=session,
+    session=get_session,
     SECRET_KEY=SECRET_KEY,
     # Security features
     allowed_ips=["10.0.0.1"],
@@ -173,11 +187,16 @@ admin = CRUDAdmin(
 
 ## Documentation
 
-- **[Quick Start](https://igorbenav.github.io/crudadmin/quick-start/)**: Get up and running in 5 minutes
-- **[Usage Guide](https://igorbenav.github.io/crudadmin/usage/overview/)**: Complete usage documentation
-- **[API Reference](https://igorbenav.github.io/crudadmin/api/overview/)**: Full API documentation
-- **[Advanced Topics](https://igorbenav.github.io/crudadmin/advanced/overview/)**: Production features and configurations
+- **[Quick Start](https://benavlabs.github.io/crudadmin/quick-start/)**: Get up and running in 5 minutes
+- **[Usage Guide](https://benavlabs.github.io/crudadmin/usage/overview/)**: Complete usage documentation
+- **[API Reference](https://benavlabs.github.io/crudadmin/api/overview/)**: Full API documentation
+- **[Advanced Topics](https://benavlabs.github.io/crudadmin/advanced/overview/)**: Production features and configurations
 
 ## License
 
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+<hr>
+<a href="https://benav.io">
+  <img src="docs/assets/benav_labs_banner.png" alt="Powered by Benav Labs - benav.io"/>
+</a>

{crudadmin-0.3.0 → crudadmin-0.3.2}/crudadmin/admin_interface/crud_admin.py

@@ -5,6 +5,7 @@ from collections.abc import Awaitable, Callable
 from datetime import UTC, datetime, timedelta
 from typing import (
     Any,
+    AsyncGenerator,
     Dict,
     List,
     Optional,
@@ -84,7 +85,7 @@ class CRUDAdmin:
         - Token-based authentication
 
     Args:
-        session: Async SQLAlchemy session for database operations
+        session: Async SQLAlchemy session dependency function that yields sessions
         SECRET_KEY: Secret key for session management and cookie signing. Generate securely using:
             **Python one-liner (recommended)**
             python -c "import secrets; print(secrets.token_urlsafe(32))"
@@ -151,11 +152,15 @@ class CRUDAdmin:
 
         # Setup database
         engine = create_async_engine("sqlite+aiosqlite:///app.db")
-        session = AsyncSession(engine)
+
+        # Create database session dependency
+        async def get_session():
+            async with AsyncSession(engine) as session:
+                yield session
 
         # Create admin interface
         admin = CRUDAdmin(
-            session=session,
+            session=get_session,
             SECRET_KEY=SECRET_KEY,
             initial_admin={
                 "username": "admin",
@@ -167,7 +172,7 @@ class CRUDAdmin:
         Production setup with security features:
         ```python
         admin = CRUDAdmin(
-            session=session,
+            session=get_session,
             SECRET_KEY=SECRET_KEY,
             # Security features
             allowed_ips=["10.0.0.1", "10.0.0.2"],
@@ -187,7 +192,7 @@ class CRUDAdmin:
         Session management configuration:
         ```python
         admin = CRUDAdmin(
-            session=session,
+            session=get_session,
             SECRET_KEY=SECRET_KEY,
             # Session management settings
             max_sessions_per_user=5,
@@ -269,7 +274,7 @@ class CRUDAdmin:
         Event tracking and audit logs:
         ```python
         admin = CRUDAdmin(
-            session=session,
+            session=get_session,
             SECRET_KEY=SECRET_KEY,
             track_events=True,  # Enable event tracking
             # Custom admin database for logs
@@ -286,7 +291,7 @@ class CRUDAdmin:
 
     def __init__(
         self,
-        session: AsyncSession,
+        session: Callable[[], AsyncGenerator[AsyncSession, None]],
         SECRET_KEY: str,
         mount_path: Optional[str] = "/admin",
         theme: Optional[str] = "dark-theme",
@@ -446,7 +451,7 @@ class CRUDAdmin:
             Manual initialization:
             ```python
             admin = CRUDAdmin(
-                session=async_session,
+                session=get_session,
                 SECRET_KEY="key",
                 setup_on_initialization=False
             )
@@ -789,8 +794,8 @@ class CRUDAdmin:
         model: Type[DeclarativeBase],
         create_schema: Type[BaseModel],
         update_schema: Type[BaseModel],
-        update_internal_schema: Optional[Type[BaseModel]],
-        delete_schema: Optional[Type[BaseModel]],
+        update_internal_schema: Optional[Type[BaseModel]] = None,
+        delete_schema: Optional[Type[BaseModel]] = None,
         include_in_models: bool = True,
         allowed_actions: Optional[set[str]] = None,
         password_transformer: Optional[Any] = None,

{crudadmin-0.3.0 → crudadmin-0.3.2}/crudadmin/core/db.py

@@ -59,7 +59,7 @@ class DatabaseConfig:
     def __init__(
         self,
         base: Type[DeclarativeBase],
-        session: AsyncSession,
+        session: Callable[[], AsyncGenerator[AsyncSession, None]],
         admin_db_url: Optional[str] = None,
         admin_db_path: Optional[str] = None,
         admin_user: Optional[Type[DeclarativeBase]] = None,
@@ -88,7 +88,7 @@ class DatabaseConfig:
         ] = None,
     ) -> None:
         self.base: Type[DeclarativeBase] = base
-        self.session: AsyncSession = session
+        self.session: Callable[[], AsyncGenerator[AsyncSession, None]] = session
 
         if admin_db_url is None:
             if admin_db_path is None:
@@ -197,8 +197,8 @@ class DatabaseConfig:
         """Get a session for the admin database."""
         return self.admin_session
 
-    def get_app_session(self) -> AsyncSession:
-        """Get a session for the main application database."""
+    def get_app_session(self) -> Callable[[], AsyncGenerator[AsyncSession, None]]:
+        """Get a session dependency for the main application database."""
         return self.session
 
     def get_primary_key(self, model: Type[DeclarativeBase]) -> Optional[str]:

crudadmin-0.3.2/crudadmin/session/schemas.py

@@ -0,0 +1,153 @@
+from datetime import UTC, datetime
+from enum import Enum
+from typing import Any, Optional
+from uuid import uuid4
+
+from pydantic import BaseModel, Field, field_validator
+
+from ..core.schemas.timestamp import TimestampSchema
+
+
+class DeviceType(str, Enum):
+    """Device type enumeration"""
+
+    MOBILE = "mobile"
+    TABLET = "tablet"
+    DESKTOP = "desktop"
+    UNKNOWN = "unknown"
+
+
+class BaseSession(BaseModel):
+    """Common base fields for all session types."""
+
+    user_id: int = Field(
+        ..., description="The ID of the user associated with the session."
+    )
+
+    session_id: str = Field(
+        default_factory=lambda: str(uuid4()), description="Unique session identifier"
+    )
+    ip_address: str = Field(..., description="Client IP address")
+    user_agent: str = Field(..., description="Client user agent string")
+    device_info: dict[str, Any] = Field(
+        default_factory=dict, description="Additional device information"
+    )
+    is_active: bool = Field(default=True, description="Whether session is active")
+
+    @field_validator("ip_address")
+    @classmethod
+    def validate_ip_address(cls, ip: str) -> str:
+        """Validate IP address format."""
+        import ipaddress
+
+        try:
+            ipaddress.ip_address(ip)
+        except ValueError as err:
+            raise ValueError("Invalid IP Address format") from err
+        return ip
+
+
+class SessionData(BaseSession):
+    """Common session data for any user session."""
+
+    metadata: dict[str, Any] = Field(
+        default_factory=dict, description="Additional session metadata"
+    )
+    created_at: datetime = Field(
+        default_factory=lambda: datetime.now(UTC),
+        description="Session creation timestamp",
+    )
+    last_activity: datetime = Field(
+        default_factory=lambda: datetime.now(UTC), description="Last activity timestamp"
+    )
+
+
+class SessionCreate(SessionData):
+    """Schema for creating a new session."""
+
+    pass
+
+
+class SessionUpdate(BaseModel):
+    """Schema for updating a session."""
+
+    last_activity: Optional[datetime] = None
+    is_active: Optional[bool] = None
+    metadata: Optional[dict[str, Any]] = None
+
+
+class UserAgentInfo(BaseModel):
+    """User agent information parsed from the User-Agent header."""
+
+    browser: str = Field(..., description="Browser name")
+    browser_version: str = Field(..., description="Browser version")
+    os: str = Field(..., description="Operating System")
+    device: str
+    is_mobile: bool
+    is_tablet: bool
+    is_pc: bool
+
+
+class CSRFToken(BaseModel):
+    """CSRF token data."""
+
+    token: str
+    user_id: int
+    session_id: str
+    created_at: datetime = Field(default_factory=lambda: datetime.now(UTC))
+    expires_at: datetime
+
+
+class AdminSession(TimestampSchema, BaseSession):
+    """Full AdminSession schema with all fields."""
+
+    id: int
+    session_metadata: dict[str, Any] = Field(
+        default_factory=dict, description="admin specific session metadata"
+    )
+
+
+class AdminSessionRead(BaseSession):
+    """Schema for reading AdminSession data."""
+
+    id: int
+    session_metadata: dict[str, Any]
+    created_at: datetime
+    last_activity: datetime
+    is_active: bool
+
+
+class AdminSessionCreate(BaseSession):
+    """Schema for creating AdminSession in database."""
+
+    created_at: datetime = Field(default_factory=lambda: datetime.now(UTC))
+    last_activity: datetime = Field(default_factory=lambda: datetime.now(UTC))
+    session_metadata: dict[str, Any] = Field(default_factory=dict)
+
+
+class AdminSessionUpdate(BaseModel):
+    """Schema for updating AdminSession."""
+
+    last_activity: Optional[datetime] = None
+    is_active: Optional[bool] = None
+    session_metadata: Optional[dict[str, Any]] = None
+
+
+class AdminSessionUpdateInternal(AdminSessionUpdate):
+    """Internal schema for AdminSession updates."""
+
+    updated_at: Optional[datetime] = Field(default_factory=lambda: datetime.now(UTC))
+
+
+__all__ = [
+    "SessionData",
+    "SessionCreate",
+    "SessionUpdate",
+    "UserAgentInfo",
+    "CSRFToken",
+    "AdminSession",
+    "AdminSessionRead",
+    "AdminSessionCreate",
+    "AdminSessionUpdate",
+    "AdminSessionUpdateInternal",
+]

{crudadmin-0.3.0 → crudadmin-0.3.2}/pyproject.toml

@@ -1,9 +1,9 @@
 [project]
 name = "crudadmin"
-version = "0.3.0"
+version = "0.3.2"
 description = "FastAPI-based admin interface with authentication, event logging and CRUD operations"
 readme = "README.md"
-requires-python = ">=3.9"
+requires-python = ">=3.9.2"
 authors = [
     { name = "Igor Benav", email = "igor.magalhaes.r@gmail.com" }
 ]
@@ -30,7 +30,6 @@ classifiers = [
 dependencies = [
     "bcrypt>=4.2.1",
     "fastapi>=0.115.6",
-    "fastcrud>=0.15.5",
     "jinja2>=3.1.5",
     "pydantic[email]>=2.10.4",
     "pydantic-settings>=2.6.1",
@@ -40,6 +39,7 @@ dependencies = [
     "user-agents>=2.2.0",
     "aiosqlite>=0.20.0",
     "greenlet>=3.1.1",
+    "fastcrud>=0.15.12",
 ]
 
 [tool.hatch.build.targets.sdist]
@@ -52,17 +52,12 @@ include = ["crudadmin/", "LICENSE"]
 requires = ["hatchling"]
 build-backend = "hatchling.build"
 
-[dependency-groups]
-dev = [
-    "types-redis>=4.6.0.20241004",
-]
-
 [project.urls]
-Homepage = "https://github.com/igorbenav/crudadmin"
-Documentation = "https://igorbenav.github.io/crudadmin"
-Repository = "https://github.com/igorbenav/crudadmin"
-Issues = "https://github.com/igorbenav/crudadmin/issues"
-Changelog = "https://github.com/igorbenav/crudadmin/releases"
+Homepage = "https://github.com/benavlabs/crudadmin"
+Documentation = "https://benavlabs.github.io/crudadmin"
+Repository = "https://github.com/benavlabs/crudadmin"
+Issues = "https://github.com/benavlabs/crudadmin/issues"
+Changelog = "https://github.com/benavlabs/crudadmin/releases"
 
 [project.optional-dependencies]
 standard = [
@@ -113,6 +108,12 @@ test = [
     "redis>=6.2.0",
 ]
 
+[dependency-groups]
+dev = [
+    "crudadmin",
+    "crudadmin[standard,redis,memcached,postgres,mysql,dev]"
+]
+
 [tool.pytest.ini_options]
 minversion = "6.0"
 addopts = "-ra -q --strict-markers --strict-config"

crudadmin-0.3.0/crudadmin/session/schemas.py

@@ -1,128 +0,0 @@
-from datetime import UTC, datetime
-from typing import Any, Optional
-from uuid import uuid4
-
-from pydantic import BaseModel, Field
-
-from ..core.schemas.timestamp import TimestampSchema
-
-
-class SessionData(BaseModel):
-    """Common base data for any user session."""
-
-    user_id: int
-    session_id: str = Field(default_factory=lambda: str(uuid4()))
-    ip_address: str
-    user_agent: str
-    device_info: dict[str, Any] = Field(default_factory=dict)
-    created_at: datetime = Field(default_factory=lambda: datetime.now(UTC))
-    last_activity: datetime = Field(default_factory=lambda: datetime.now(UTC))
-    is_active: bool = True
-    metadata: dict[str, Any] = Field(default_factory=dict)
-
-
-class SessionCreate(SessionData):
-    """Schema for creating a new session."""
-
-    pass
-
-
-class SessionUpdate(BaseModel):
-    """Schema for updating a session."""
-
-    last_activity: Optional[datetime] = None
-    is_active: Optional[bool] = None
-    metadata: Optional[dict[str, Any]] = None
-
-
-class UserAgentInfo(BaseModel):
-    """User agent information parsed from the User-Agent header."""
-
-    browser: str
-    browser_version: str
-    os: str
-    device: str
-    is_mobile: bool
-    is_tablet: bool
-    is_pc: bool
-
-
-class CSRFToken(BaseModel):
-    """CSRF token data."""
-
-    token: str
-    user_id: int
-    session_id: str
-    created_at: datetime = Field(default_factory=lambda: datetime.now(UTC))
-    expires_at: datetime
-
-
-class AdminSessionBase(BaseModel):
-    """Base schema for AdminSession."""
-
-    user_id: int
-    session_id: str
-    ip_address: str
-    user_agent: str
-    device_info: dict[str, Any] = Field(default_factory=dict)
-    session_metadata: dict[str, Any] = Field(default_factory=dict)
-    is_active: bool = True
-
-
-class AdminSession(TimestampSchema, AdminSessionBase):
-    """Full AdminSession schema with all fields."""
-
-    id: int
-    created_at: datetime
-    last_activity: datetime
-
-
-class AdminSessionRead(BaseModel):
-    """Schema for reading AdminSession data."""
-
-    id: int
-    user_id: int
-    session_id: str
-    ip_address: str
-    user_agent: str
-    device_info: dict[str, Any]
-    session_metadata: dict[str, Any]
-    created_at: datetime
-    last_activity: datetime
-    is_active: bool
-
-
-class AdminSessionCreate(AdminSessionBase):
-    """Schema for creating AdminSession in database."""
-
-    created_at: datetime = Field(default_factory=lambda: datetime.now(UTC))
-    last_activity: datetime = Field(default_factory=lambda: datetime.now(UTC))
-
-
-class AdminSessionUpdate(BaseModel):
-    """Schema for updating AdminSession."""
-
-    last_activity: Optional[datetime] = None
-    is_active: Optional[bool] = None
-    session_metadata: Optional[dict[str, Any]] = None
-
-
-class AdminSessionUpdateInternal(AdminSessionUpdate):
-    """Internal schema for AdminSession updates."""
-
-    updated_at: Optional[datetime] = Field(default_factory=lambda: datetime.now(UTC))
-
-
-__all__ = [
-    "SessionData",
-    "SessionCreate",
-    "SessionUpdate",
-    "UserAgentInfo",
-    "CSRFToken",
-    "AdminSessionBase",
-    "AdminSession",
-    "AdminSessionRead",
-    "AdminSessionCreate",
-    "AdminSessionUpdate",
-    "AdminSessionUpdateInternal",
-]