@vorionsys/platform-core 0.1.0

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

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

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

package/dist/common/adapters/types.js

@@ -0,0 +1,11 @@
+/**
+ * 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
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/common/adapters/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/common/alerts.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Critical Alert Definitions
+ *
+ * Defines alerting rules for trust-critical operations across all Vorion services.
+ * These alerts are consumed by monitoring backends (Grafana, PagerDuty, etc.)
+ * and exported as OpenTelemetry metric-based alerts.
+ *
+ * Priority levels:
+ *   P0 — Immediate: Data integrity at risk (proof chain, signatures)
+ *   P1 — Urgent: Security/trust degradation (auth failures, scoring latency)
+ *   P2 — Important: Service health (error rates, circuit breakers)
+ *   P3 — Warning: Performance (latency budgets, queue depth)
+ */
+export interface AlertRule {
+    /** Unique alert identifier */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Priority level (P0-P3) */
+    priority: 'P0' | 'P1' | 'P2' | 'P3';
+    /** Description of what this alert detects */
+    description: string;
+    /** Metric name to evaluate */
+    metric: string;
+    /** Condition operator */
+    operator: 'gt' | 'lt' | 'gte' | 'lte' | 'eq';
+    /** Threshold value */
+    threshold: number;
+    /** Evaluation window in seconds */
+    windowSeconds: number;
+    /** Notification channels */
+    channels: ('pagerduty' | 'slack' | 'email' | 'webhook')[];
+    /** Tags for routing and filtering */
+    tags: string[];
+}
+/**
+ * Critical alert rules for the Vorion ecosystem.
+ */
+export declare const ALERT_RULES: AlertRule[];
+export type AlertCallback = (rule: AlertRule, currentValue: number) => void;
+/**
+ * Register a callback for when an alert fires.
+ */
+export declare function onAlert(callback: AlertCallback): void;
+/**
+ * Evaluate a metric value against all matching alert rules.
+ */
+export declare function evaluateAlerts(metricName: string, value: number): void;
+/**
+ * Get all alert rules for a specific priority.
+ */
+export declare function getAlertsByPriority(priority: AlertRule['priority']): AlertRule[];
+/**
+ * Get all alert rules tagged with a specific tag.
+ */
+export declare function getAlertsByTag(tag: string): AlertRule[];
+//# sourceMappingURL=alerts.d.ts.map