@vorionsys/security 1.0.0

package/dist/common/adapters/memory-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-session.js","sourceRoot":"","sources":["../../../src/common/adapters/memory-session.ts"],"names":[],"mappings":"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"}

package/dist/common/adapters/provider.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Adapter Provider
+ *
+ * Factory that creates appropriate adapters based on configuration and
+ * Redis availability. Supports both Redis-backed and in-memory implementations.
+ *
+ * Features:
+ * - Automatic Redis availability detection
+ * - Singleton pattern for adapter instances
+ * - Health check support
+ * - Graceful fallback to memory when Redis is unavailable
+ *
+ * @packageDocumentation
+ */
+import type { AdapterProvider, IQueueAdapter, ICacheAdapter, ILockAdapter, ISessionStoreAdapter, IRateLimitAdapter } from './types.js';
+/**
+ * Provider configuration
+ */
+export interface AdapterProviderConfig {
+    /** Force memory mode even if Redis is available */
+    forceMemoryMode?: boolean;
+    /** Redis connection timeout in milliseconds */
+    redisConnectionTimeoutMs?: number;
+}
+/**
+ * Get the adapter provider singleton
+ */
+export declare function getAdapterProvider(config?: AdapterProviderConfig): AdapterProvider;
+/**
+ * Create a new adapter provider instance (for testing)
+ */
+export declare function createAdapterProvider(config?: AdapterProviderConfig): AdapterProvider & {
+    shutdown(): Promise<void>;
+};
+/**
+ * Reset the singleton provider (for testing)
+ */
+export declare function resetAdapterProvider(): Promise<void>;
+/**
+ * Convenience function to get adapters directly
+ */
+export declare function getQueueAdapter(name: string): IQueueAdapter;
+export declare function getCacheAdapter(): ICacheAdapter;
+export declare function getLockAdapter(): ILockAdapter;
+export declare function getSessionStoreAdapter(): ISessionStoreAdapter;
+export declare function getRateLimitAdapter(): IRateLimitAdapter;
+//# sourceMappingURL=provider.d.ts.map

package/dist/common/adapters/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/common/adapters/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EACV,eAAe,EAEf,aAAa,EACb,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAWpB;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,mDAAmD;IACnD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,+CAA+C;IAC/C,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAoUD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,eAAe,CAKlF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,eAAe,GAAG;IAAE,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAErH;AAED;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAK1D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAE3D;AAED,wBAAgB,eAAe,IAAI,aAAa,CAE/C;AAED,wBAAgB,cAAc,IAAI,YAAY,CAE7C;AAED,wBAAgB,sBAAsB,IAAI,oBAAoB,CAE7D;AAED,wBAAgB,mBAAmB,IAAI,iBAAiB,CAEvD"}

package/dist/common/adapters/provider.js

@@ -0,0 +1,347 @@
+/**
+ * Adapter Provider
+ *
+ * Factory that creates appropriate adapters based on configuration and
+ * Redis availability. Supports both Redis-backed and in-memory implementations.
+ *
+ * Features:
+ * - Automatic Redis availability detection
+ * - Singleton pattern for adapter instances
+ * - Health check support
+ * - Graceful fallback to memory when Redis is unavailable
+ *
+ * @packageDocumentation
+ */
+import { createLogger } from '../logger.js';
+import { getConfig } from '../config.js';
+// Import memory implementations
+import { createMemoryQueueAdapter } from './memory-queue.js';
+import { createMemoryCacheAdapter } from './memory-cache.js';
+import { createMemoryLockAdapter } from './memory-lock.js';
+import { createMemorySessionStoreAdapter } from './memory-session.js';
+import { createMemoryRateLimitAdapter } from './memory-ratelimit.js';
+const logger = createLogger({ component: 'adapter-provider' });
+/**
+ * Default configuration
+ */
+const DEFAULT_CONFIG = {
+    forceMemoryMode: false,
+    redisConnectionTimeoutMs: 5000,
+};
+/**
+ * Main adapter provider implementation
+ */
+class DefaultAdapterProvider {
+    config;
+    redisAvailable = null;
+    redisCheckPromise = null;
+    // Singleton instances
+    queueAdapters = new Map();
+    cacheAdapter = null;
+    lockAdapter = null;
+    sessionStoreAdapter = null;
+    rateLimitAdapter = null;
+    // Memory adapter instances for cleanup
+    memoryCacheAdapter = null;
+    memoryLockAdapter = null;
+    memorySessionAdapter = null;
+    memoryRateLimitAdapter = null;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        // Check if lite mode is enabled
+        const appConfig = getConfig();
+        if (appConfig.lite?.enabled && appConfig.lite?.redisOptional) {
+            logger.info({}, 'Lite mode enabled with optional Redis');
+        }
+    }
+    /**
+     * Get a queue adapter by name
+     */
+    getQueueAdapter(name) {
+        let adapter = this.queueAdapters.get(name);
+        if (!adapter) {
+            if (this.shouldUseMemory()) {
+                adapter = createMemoryQueueAdapter(name);
+                logger.debug({ queueName: name }, 'Created memory queue adapter');
+            }
+            else {
+                // Redis queue adapter would be created here
+                // For now, fall back to memory
+                adapter = createMemoryQueueAdapter(name);
+                logger.debug({ queueName: name }, 'Created memory queue adapter (Redis not implemented in adapter)');
+            }
+            this.queueAdapters.set(name, adapter);
+        }
+        return adapter;
+    }
+    /**
+     * Get the cache adapter
+     */
+    getCacheAdapter() {
+        if (!this.cacheAdapter) {
+            if (this.shouldUseMemory()) {
+                this.memoryCacheAdapter = createMemoryCacheAdapter();
+                this.cacheAdapter = this.memoryCacheAdapter;
+                logger.debug({}, 'Created memory cache adapter');
+            }
+            else {
+                // Redis cache adapter would be created here
+                // For now, fall back to memory
+                this.memoryCacheAdapter = createMemoryCacheAdapter();
+                this.cacheAdapter = this.memoryCacheAdapter;
+                logger.debug({}, 'Created memory cache adapter (Redis not implemented in adapter)');
+            }
+        }
+        return this.cacheAdapter;
+    }
+    /**
+     * Get the lock adapter
+     */
+    getLockAdapter() {
+        if (!this.lockAdapter) {
+            if (this.shouldUseMemory()) {
+                this.memoryLockAdapter = createMemoryLockAdapter();
+                this.lockAdapter = this.memoryLockAdapter;
+                logger.debug({}, 'Created memory lock adapter');
+            }
+            else {
+                // Redis lock adapter would be created here
+                // For now, fall back to memory
+                this.memoryLockAdapter = createMemoryLockAdapter();
+                this.lockAdapter = this.memoryLockAdapter;
+                logger.debug({}, 'Created memory lock adapter (Redis not implemented in adapter)');
+            }
+        }
+        return this.lockAdapter;
+    }
+    /**
+     * Get the session store adapter
+     */
+    getSessionStoreAdapter() {
+        if (!this.sessionStoreAdapter) {
+            if (this.shouldUseMemory()) {
+                this.memorySessionAdapter = createMemorySessionStoreAdapter();
+                this.sessionStoreAdapter = this.memorySessionAdapter;
+                logger.debug({}, 'Created memory session store adapter');
+            }
+            else {
+                // Redis session adapter would be created here
+                // For now, fall back to memory
+                this.memorySessionAdapter = createMemorySessionStoreAdapter();
+                this.sessionStoreAdapter = this.memorySessionAdapter;
+                logger.debug({}, 'Created memory session store adapter (Redis not implemented in adapter)');
+            }
+        }
+        return this.sessionStoreAdapter;
+    }
+    /**
+     * Get the rate limit adapter
+     */
+    getRateLimitAdapter() {
+        if (!this.rateLimitAdapter) {
+            if (this.shouldUseMemory()) {
+                this.memoryRateLimitAdapter = createMemoryRateLimitAdapter();
+                this.rateLimitAdapter = this.memoryRateLimitAdapter;
+                logger.debug({}, 'Created memory rate limit adapter');
+            }
+            else {
+                // Redis rate limit adapter would be created here
+                // For now, fall back to memory
+                this.memoryRateLimitAdapter = createMemoryRateLimitAdapter();
+                this.rateLimitAdapter = this.memoryRateLimitAdapter;
+                logger.debug({}, 'Created memory rate limit adapter (Redis not implemented in adapter)');
+            }
+        }
+        return this.rateLimitAdapter;
+    }
+    /**
+     * Check if Redis is available
+     */
+    isRedisAvailable() {
+        // If we haven't checked yet, return false (conservative default)
+        if (this.redisAvailable === null) {
+            // Trigger async check
+            void this.checkRedisAvailability();
+            return false;
+        }
+        return this.redisAvailable;
+    }
+    /**
+     * Get health status of the adapter system
+     */
+    async getHealthStatus() {
+        const startTime = Date.now();
+        const redisAvailable = await this.checkRedisAvailability();
+        const latencyMs = Date.now() - startTime;
+        const appConfig = getConfig();
+        const liteMode = appConfig.lite?.enabled && appConfig.lite?.redisOptional;
+        const useMemory = this.config.forceMemoryMode || liteMode || !redisAvailable;
+        return {
+            redis: {
+                available: redisAvailable,
+                latencyMs: redisAvailable ? latencyMs : undefined,
+                error: !redisAvailable ? 'Redis connection failed or not configured' : undefined,
+            },
+            mode: useMemory ? 'memory' : 'redis',
+        };
+    }
+    /**
+     * Shutdown all adapters and clean up resources
+     */
+    async shutdown() {
+        logger.info({}, 'Shutting down adapter provider');
+        // Close all queue adapters
+        for (const [name, adapter] of this.queueAdapters) {
+            try {
+                await adapter.close();
+                logger.debug({ queueName: name }, 'Queue adapter closed');
+            }
+            catch (error) {
+                logger.error({ error, queueName: name }, 'Error closing queue adapter');
+            }
+        }
+        this.queueAdapters.clear();
+        // Stop memory adapters
+        if (this.memoryCacheAdapter) {
+            this.memoryCacheAdapter.stop();
+            this.memoryCacheAdapter = null;
+        }
+        if (this.memoryLockAdapter) {
+            this.memoryLockAdapter.stop();
+            this.memoryLockAdapter = null;
+        }
+        if (this.memorySessionAdapter) {
+            this.memorySessionAdapter.stop();
+            this.memorySessionAdapter = null;
+        }
+        if (this.memoryRateLimitAdapter) {
+            this.memoryRateLimitAdapter.stop();
+            this.memoryRateLimitAdapter = null;
+        }
+        // Clear references
+        this.cacheAdapter = null;
+        this.lockAdapter = null;
+        this.sessionStoreAdapter = null;
+        this.rateLimitAdapter = null;
+        logger.info({}, 'Adapter provider shutdown complete');
+    }
+    /**
+     * Determine if memory mode should be used
+     */
+    shouldUseMemory() {
+        // Check forced memory mode
+        if (this.config.forceMemoryMode) {
+            return true;
+        }
+        // Check lite mode configuration
+        const appConfig = getConfig();
+        if (appConfig.lite?.enabled && appConfig.lite?.redisOptional) {
+            // In lite mode with optional Redis, use memory if Redis is not available
+            if (this.redisAvailable === false) {
+                return true;
+            }
+            // If we haven't checked Redis yet, default to memory
+            if (this.redisAvailable === null) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Check Redis availability
+     */
+    async checkRedisAvailability() {
+        // Return cached result if available
+        if (this.redisAvailable !== null) {
+            return this.redisAvailable;
+        }
+        // Deduplicate concurrent checks
+        if (this.redisCheckPromise) {
+            return this.redisCheckPromise;
+        }
+        this.redisCheckPromise = this.doRedisCheck();
+        try {
+            this.redisAvailable = await this.redisCheckPromise;
+        }
+        finally {
+            this.redisCheckPromise = null;
+        }
+        return this.redisAvailable;
+    }
+    /**
+     * Perform actual Redis availability check
+     */
+    async doRedisCheck() {
+        try {
+            // Dynamically import Redis to avoid errors when not configured
+            const { getRedis } = await import('../redis.js');
+            const redis = getRedis();
+            // Try a simple PING with timeout
+            const pingPromise = redis.ping();
+            const timeoutPromise = new Promise((_, reject) => {
+                setTimeout(() => reject(new Error('Redis check timeout')), this.config.redisConnectionTimeoutMs);
+            });
+            const result = await Promise.race([pingPromise, timeoutPromise]);
+            if (result === 'PONG') {
+                logger.info({}, 'Redis is available');
+                return true;
+            }
+            logger.warn({ result }, 'Unexpected Redis PING response');
+            return false;
+        }
+        catch (error) {
+            logger.info({ error: error instanceof Error ? error.message : 'Unknown error' }, 'Redis is not available, using memory adapters');
+            return false;
+        }
+    }
+}
+// =============================================================================
+// SINGLETON MANAGEMENT
+// =============================================================================
+/**
+ * Singleton provider instance
+ */
+let providerInstance = null;
+/**
+ * Get the adapter provider singleton
+ */
+export function getAdapterProvider(config) {
+    if (!providerInstance) {
+        providerInstance = new DefaultAdapterProvider(config);
+    }
+    return providerInstance;
+}
+/**
+ * Create a new adapter provider instance (for testing)
+ */
+export function createAdapterProvider(config) {
+    return new DefaultAdapterProvider(config);
+}
+/**
+ * Reset the singleton provider (for testing)
+ */
+export async function resetAdapterProvider() {
+    if (providerInstance) {
+        await providerInstance.shutdown();
+        providerInstance = null;
+    }
+}
+/**
+ * Convenience function to get adapters directly
+ */
+export function getQueueAdapter(name) {
+    return getAdapterProvider().getQueueAdapter(name);
+}
+export function getCacheAdapter() {
+    return getAdapterProvider().getCacheAdapter();
+}
+export function getLockAdapter() {
+    return getAdapterProvider().getLockAdapter();
+}
+export function getSessionStoreAdapter() {
+    return getAdapterProvider().getSessionStoreAdapter();
+}
+export function getRateLimitAdapter() {
+    return getAdapterProvider().getRateLimitAdapter();
+}
+//# sourceMappingURL=provider.js.map

package/dist/common/adapters/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../src/common/adapters/provider.ts"],"names":[],"mappings":"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"}

package/dist/common/adapters/types.d.ts

@@ -0,0 +1,247 @@
+/**
+ * Adapter Interfaces for Redis Optionality
+ *
+ * These interfaces define contracts for queue, cache, lock, session,
+ * and rate limiting functionality. They can be implemented by either
+ * Redis-backed or in-memory backends, allowing Vorion to run without Redis.
+ *
+ * @packageDocumentation
+ */
+import type { Session, CreateSessionInput } from '../../security/session-store.js';
+export type { Session, CreateSessionInput };
+/**
+ * Options for adding a job to a queue
+ */
+export interface QueueJobOptions {
+    /** Delay in milliseconds before the job becomes active */
+    delay?: number;
+    /** Number of retry attempts */
+    attempts?: number;
+    /** Backoff configuration for retries */
+    backoff?: {
+        type: 'exponential' | 'fixed';
+        delay: number;
+    };
+    /** Job priority (lower = higher priority) */
+    priority?: number;
+    /** Custom job ID (for deduplication) */
+    jobId?: string;
+}
+/**
+ * Job counts by status
+ */
+export interface JobCounts {
+    waiting: number;
+    active: number;
+    completed: number;
+    failed: number;
+    delayed: number;
+}
+/**
+ * Job representation passed to handlers
+ */
+export interface Job<T = unknown> {
+    id: string;
+    data: T;
+    attemptsMade: number;
+}
+/**
+ * Job handler function type
+ */
+export type JobHandler<T = unknown> = (job: Job<T>) => Promise<void>;
+/**
+ * Queue adapter interface for job processing
+ */
+export interface IQueueAdapter {
+    /**
+     * Add a job to the queue
+     * @returns Job ID
+     */
+    add<T>(name: string, data: T, options?: QueueJobOptions): Promise<string>;
+    /**
+     * Register a handler for processing jobs
+     */
+    process<T>(handler: JobHandler<T>): void;
+    /**
+     * Get job counts by status
+     */
+    getJobCounts(): Promise<JobCounts>;
+    /**
+     * Close the queue and stop processing
+     */
+    close(): Promise<void>;
+}
+/**
+ * Cache adapter interface for key-value storage with TTL
+ */
+export interface ICacheAdapter {
+    /**
+     * Get a value from cache
+     * @returns The cached value or null if not found/expired
+     */
+    get<T>(key: string): Promise<T | null>;
+    /**
+     * Set a value in cache
+     * @param ttlSeconds - Time-to-live in seconds (optional)
+     */
+    set<T>(key: string, value: T, ttlSeconds?: number): Promise<void>;
+    /**
+     * Delete a key from cache
+     */
+    del(key: string): Promise<void>;
+    /**
+     * Check if a key exists in cache
+     */
+    exists(key: string): Promise<boolean>;
+    /**
+     * Get keys matching a pattern
+     * Supports glob patterns: * (any characters), ? (single character)
+     */
+    keys(pattern: string): Promise<string[]>;
+}
+/**
+ * Options for acquiring a lock
+ */
+export interface LockOptions {
+    /** Lock TTL in milliseconds */
+    ttlMs?: number;
+    /** Number of retry attempts to acquire the lock */
+    retryCount?: number;
+    /** Delay between retry attempts in milliseconds */
+    retryDelayMs?: number;
+}
+/**
+ * Result of a lock acquisition attempt
+ */
+export interface LockResult {
+    /** Whether the lock was acquired */
+    acquired: boolean;
+    /** Unique lock identifier (required for release/extend) */
+    lockId?: string;
+}
+/**
+ * Lock adapter interface for distributed locking
+ */
+export interface ILockAdapter {
+    /**
+     * Attempt to acquire a lock
+     */
+    acquire(key: string, options?: LockOptions): Promise<LockResult>;
+    /**
+     * Release a lock
+     * @param key - Lock key
+     * @param lockId - Lock identifier from acquire result
+     * @returns true if released, false if not owned or already expired
+     */
+    release(key: string, lockId: string): Promise<boolean>;
+    /**
+     * Extend a lock's TTL
+     * @param key - Lock key
+     * @param lockId - Lock identifier from acquire result
+     * @param additionalMs - Additional time in milliseconds
+     * @returns true if extended, false if not owned or already expired
+     */
+    extend(key: string, lockId: string, additionalMs: number): Promise<boolean>;
+}
+/**
+ * Session store adapter interface
+ */
+export interface ISessionStoreAdapter {
+    /**
+     * Create a new session
+     */
+    create(input: CreateSessionInput): Promise<Session>;
+    /**
+     * Get a session by ID
+     * @returns The session or null if not found/expired
+     */
+    get(sessionId: string): Promise<Session | null>;
+    /**
+     * Delete a session permanently
+     */
+    delete(sessionId: string): Promise<boolean>;
+    /**
+     * Revoke a session (marks as revoked but keeps briefly for detection)
+     */
+    revoke(sessionId: string, reason: string, revokedBy: string): Promise<boolean>;
+    /**
+     * Get all active sessions for a user
+     */
+    getUserSessions(userId: string): Promise<Session[]>;
+}
+/**
+ * Result of a rate limit check
+ */
+export interface RateLimitResult {
+    /** Whether the request is allowed */
+    allowed: boolean;
+    /** Remaining requests in the window */
+    remaining: number;
+    /** Unix timestamp when the window resets */
+    resetAt: number;
+}
+/**
+ * Rate limit adapter interface
+ */
+export interface IRateLimitAdapter {
+    /**
+     * Check and consume rate limit
+     * @param key - Rate limit key (e.g., tenant:intentType)
+     * @param limit - Maximum requests per window
+     * @param windowSeconds - Window size in seconds
+     */
+    checkLimit(key: string, limit: number, windowSeconds: number): Promise<RateLimitResult>;
+    /**
+     * Get current rate limit status without consuming
+     */
+    getStatus(key: string, limit: number, windowSeconds: number): Promise<RateLimitResult>;
+    /**
+     * Reset rate limit for a key
+     */
+    reset(key: string): Promise<void>;
+}
+/**
+ * Health status for the adapter system
+ */
+export interface AdapterHealthStatus {
+    redis: {
+        available: boolean;
+        latencyMs?: number;
+        error?: string;
+    };
+    mode: 'redis' | 'memory';
+}
+/**
+ * Adapter provider interface for getting adapter instances
+ */
+export interface AdapterProvider {
+    /**
+     * Get a queue adapter by name
+     */
+    getQueueAdapter(name: string): IQueueAdapter;
+    /**
+     * Get the cache adapter
+     */
+    getCacheAdapter(): ICacheAdapter;
+    /**
+     * Get the lock adapter
+     */
+    getLockAdapter(): ILockAdapter;
+    /**
+     * Get the session store adapter
+     */
+    getSessionStoreAdapter(): ISessionStoreAdapter;
+    /**
+     * Get the rate limit adapter
+     */
+    getRateLimitAdapter(): IRateLimitAdapter;
+    /**
+     * Check if Redis is available
+     */
+    isRedisAvailable(): boolean;
+    /**
+     * Get health status of the adapter system
+     */
+    getHealthStatus(): Promise<AdapterHealthStatus>;
+}
+//# sourceMappingURL=types.d.ts.map