Module session_id

adaptive_pipeline_domain::value_objects

Module session_id 

Source
Expand description

§Session Identifier Value Object - Session Management Infrastructure

This module provides a comprehensive session identifier value object that implements type-safe session identification, session lifecycle management, and security context tracking for the adaptive pipeline system’s session management infrastructure.

§Overview

The session identifier system provides:

  • Type-Safe Session Identification: Strongly-typed session identifiers with validation
  • Session Lifecycle Management: ULID-based time-ordered creation sequence for session tracking
  • Security Context Tracking: Natural ordering for session security and audit trails
  • Cross-Platform Compatibility: Consistent representation across languages and systems
  • Serialization: Comprehensive serialization across storage backends and APIs
  • Session Validation: Session-specific validation with expiration and business rules

§Key Features

§1. Type-Safe Session Management

Strongly-typed session identifiers with comprehensive validation:

  • Compile-Time Safety: Cannot be confused with other entity IDs
  • Domain Semantics: Clear intent in function signatures and APIs
  • Runtime Validation: Session-specific validation rules with expiration
  • Future Evolution: Extensible for session-specific methods

§2. Session Lifecycle and Security

ULID-based temporal ordering for session lifecycle management:

  • Time-Ordered Creation: Natural chronological ordering of sessions
  • Session Tracking: Complete chronological history of session events
  • Security Context: Comprehensive audit trails for session security
  • Expiration Management: Built-in expiration validation for session security

§3. Cross-Platform Compatibility

Consistent session identification across platforms:

  • JSON Serialization: Standard JSON representation
  • Database Storage: Optimized database storage patterns
  • API Integration: RESTful API compatibility
  • Multi-Language: Consistent interface across languages

§Usage Examples

§Basic Session ID Creation and Management

§Session Lifecycle and Security Tracking

§Session Batch Operations and Utilities

§Serialization and Cross-Platform Usage

§Session Management Features

§Session Expiration

Sessions support flexible expiration management:

  • Configurable Timeout: Customizable session timeout periods
  • Automatic Validation: Built-in expiration checking in validation
  • Security Best Practice: Prevents stale session usage
  • Lifecycle Management: Support for session lifecycle policies

§Session Utilities

  • Batch Operations: Efficient batch validation and filtering
  • Lifecycle Tracking: Complete session lifecycle management
  • Security Filtering: Active/expired session filtering
  • Time-Based Sorting: Natural chronological ordering

§Performance Characteristics

  • Creation Time: ~2μs for new session ID generation
  • Validation Time: ~3μs for session ID validation (includes expiration check)
  • Serialization: ~3μs for JSON serialization
  • Memory Usage: ~32 bytes per session ID instance
  • Thread Safety: Immutable value objects are fully thread-safe

§Cross-Platform Compatibility

  • Rust: SessionId newtype wrapper with full validation
  • Go: SessionID struct with equivalent interface
  • JSON: String representation of ULID for API compatibility
  • Database: TEXT column with ULID string storage

Modules§

session_id_utils
Utility functions for session ID operations

Structs§

SessionId
Session identifier value object for type-safe session management