@bernierllc/backoff-retry 0.1.1 → 0.3.0

package/dist/storage/backend-selector.js

@@ -0,0 +1,466 @@
+"use strict";
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageBackendSelector = void 0;
+const memory_storage_1 = require("./memory-storage");
+const redis_storage_1 = require("./redis-storage");
+const postgresql_storage_1 = require("./postgresql-storage");
+const redis_cluster_storage_1 = require("./redis-cluster-storage");
+/**
+ * Storage backend selector that implements priority-based fallback logic
+ */
+class StorageBackendSelector {
+    constructor() {
+        this.backendInfo = [];
+        this.config = this.getDefaultConfig();
+    }
+    /**
+     * Get the default storage backend configuration with priority order
+     */
+    getDefaultConfig() {
+        return [
+            {
+                priority: 1,
+                type: 'postgresql',
+                enabled: true,
+                fallbackTo: ['mongodb', 'redis-cluster', 'redis', 'memory']
+            },
+            {
+                priority: 2,
+                type: 'mongodb',
+                enabled: true,
+                fallbackTo: ['redis-cluster', 'redis', 'memory']
+            },
+            {
+                priority: 3,
+                type: 'redis-cluster',
+                enabled: true,
+                fallbackTo: ['redis', 'memory']
+            },
+            {
+                priority: 4,
+                type: 'redis',
+                enabled: true,
+                fallbackTo: ['memory']
+            },
+            {
+                priority: 5,
+                type: 'memory',
+                enabled: true,
+                fallbackTo: []
+            }
+        ];
+    }
+    /**
+     * Detect environment variables for each backend type
+     */
+    detectEnvironmentVariables() {
+        // PostgreSQL detection
+        const postgresqlConfig = this.config.find(c => c.type === 'postgresql');
+        if (postgresqlConfig) {
+            const envVars = ['DATABASE_URL', 'POSTGRES_URL', 'POSTGRES_CONNECTION_STRING'];
+            for (const envVar of envVars) {
+                if (process.env[envVar]) {
+                    postgresqlConfig.connectionString = process.env[envVar];
+                    break;
+                }
+            }
+        }
+        // MongoDB detection
+        const mongodbConfig = this.config.find(c => c.type === 'mongodb');
+        if (mongodbConfig) {
+            const envVars = ['MONGODB_URL', 'MONGO_URL', 'MONGODB_CONNECTION_STRING'];
+            for (const envVar of envVars) {
+                if (process.env[envVar]) {
+                    mongodbConfig.connectionString = process.env[envVar];
+                    break;
+                }
+            }
+        }
+        // Redis Cluster detection
+        const redisClusterConfig = this.config.find(c => c.type === 'redis-cluster');
+        if (redisClusterConfig) {
+            const envVars = ['REDIS_CLUSTER_URL', 'REDIS_CLUSTER_NODES'];
+            for (const envVar of envVars) {
+                if (process.env[envVar]) {
+                    redisClusterConfig.connectionString = process.env[envVar];
+                    break;
+                }
+            }
+        }
+        // Redis detection
+        const redisConfig = this.config.find(c => c.type === 'redis');
+        if (redisConfig) {
+            const envVars = ['REDIS_URL', 'REDIS_CONNECTION_STRING'];
+            for (const envVar of envVars) {
+                if (process.env[envVar]) {
+                    redisConfig.connectionString = process.env[envVar];
+                    break;
+                }
+            }
+        }
+        // Handle manual overrides
+        this.handleManualOverrides();
+    }
+    /**
+     * Handle manual override environment variables
+     */
+    handleManualOverrides() {
+        // Force specific storage type
+        if (process.env.BACKOFF_RETRY_STORAGE_TYPE) {
+            const forcedType = process.env.BACKOFF_RETRY_STORAGE_TYPE;
+            this.config.forEach(config => {
+                config.enabled = config.type === forcedType;
+            });
+        }
+        // Override priority order
+        if (process.env.BACKOFF_RETRY_STORAGE_PRIORITY) {
+            const priorityOrder = process.env.BACKOFF_RETRY_STORAGE_PRIORITY.split(',');
+            // First, set priorities for mentioned types
+            priorityOrder.forEach((type, index) => {
+                const config = this.config.find(c => c.type === type.trim());
+                if (config) {
+                    config.priority = index + 1;
+                }
+            });
+            // Then, set lower priorities for types not mentioned
+            const mentionedTypes = priorityOrder.map(t => t.trim());
+            let nextPriority = priorityOrder.length + 1;
+            this.config.forEach(config => {
+                if (!mentionedTypes.includes(config.type)) {
+                    config.priority = nextPriority++;
+                }
+            });
+        }
+        // Disable specific backends
+        if (process.env.BACKOFF_RETRY_STORAGE_DISABLE) {
+            const disabledTypes = process.env.BACKOFF_RETRY_STORAGE_DISABLE.split(',');
+            disabledTypes.forEach(type => {
+                const config = this.config.find(c => c.type === type.trim());
+                if (config) {
+                    config.enabled = false;
+                }
+            });
+        }
+    }
+    /**
+     * Test connection to a storage backend
+     */
+    async testConnection(backend) {
+        const startTime = Date.now();
+        try {
+            switch (backend.type) {
+                case 'postgresql':
+                    return await this.testPostgreSQLConnection(backend);
+                case 'mongodb':
+                    return await this.testMongoDBConnection(backend);
+                case 'redis-cluster':
+                    return await this.testRedisClusterConnection(backend);
+                case 'redis':
+                    return await this.testRedisConnection(backend);
+                case 'memory':
+                    return await this.testMemoryConnection(backend);
+                default:
+                    return {
+                        success: false,
+                        error: `Unknown backend type: ${backend.type}`
+                    };
+            }
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error',
+                latency: Date.now() - startTime
+            };
+        }
+    }
+    /**
+     * Test PostgreSQL connection
+     */
+    async testPostgreSQLConnection(backend) {
+        if (!backend.connectionString) {
+            return {
+                success: false,
+                error: 'No PostgreSQL connection string provided'
+            };
+        }
+        try {
+            // Validate the connection string format
+            const isValidUrl = backend.connectionString.startsWith('postgresql://') ||
+                backend.connectionString.startsWith('postgres://');
+            if (!isValidUrl) {
+                return {
+                    success: false,
+                    error: 'Invalid PostgreSQL connection string format'
+                };
+            }
+            // Test actual connection by creating a temporary storage instance
+            const tempStorage = new postgresql_storage_1.PostgreSQLStorage(backend.connectionString, backend.options);
+            const isConnected = await tempStorage.testConnection();
+            await tempStorage.close();
+            if (!isConnected) {
+                return {
+                    success: false,
+                    error: 'Failed to connect to PostgreSQL database'
+                };
+            }
+            return {
+                success: true,
+                latency: 0,
+                capabilities: ['persistent', 'acid', 'transactions', 'advanced-querying', 'jsonb', 'indexing']
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'PostgreSQL connection test failed'
+            };
+        }
+    }
+    /**
+     * Test MongoDB connection
+     */
+    async testMongoDBConnection(backend) {
+        if (!backend.connectionString) {
+            return {
+                success: false,
+                error: 'No MongoDB connection string provided'
+            };
+        }
+        try {
+            // Validate connection string format
+            const isValidUrl = backend.connectionString.startsWith('mongodb://') ||
+                backend.connectionString.startsWith('mongodb+srv://');
+            if (!isValidUrl) {
+                return {
+                    success: false,
+                    error: 'Invalid MongoDB connection string format'
+                };
+            }
+            return {
+                success: true,
+                latency: 0,
+                capabilities: ['persistent', 'flexible-schema', 'horizontal-scaling', 'aggregation']
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'MongoDB connection test failed'
+            };
+        }
+    }
+    /**
+     * Test Redis Cluster connection
+     */
+    async testRedisClusterConnection(backend) {
+        if (!backend.connectionString) {
+            return {
+                success: false,
+                error: 'No Redis Cluster connection string provided'
+            };
+        }
+        try {
+            // Validate connection string format
+            const isValidUrl = backend.connectionString.startsWith('redis://') ||
+                backend.connectionString.startsWith('rediss://');
+            if (!isValidUrl) {
+                return {
+                    success: false,
+                    error: 'Invalid Redis Cluster connection string format'
+                };
+            }
+            // Test actual connection by creating a temporary storage instance
+            const tempStorage = new redis_cluster_storage_1.RedisClusterStorage(backend.connectionString, backend.options);
+            const isConnected = await tempStorage.testConnection();
+            await tempStorage.close();
+            if (!isConnected) {
+                return {
+                    success: false,
+                    error: 'Failed to connect to Redis Cluster'
+                };
+            }
+            return {
+                success: true,
+                latency: 0,
+                capabilities: ['persistent', 'high-availability', 'distributed', 'fast-access', 'auto-failover', 'load-balancing']
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Redis Cluster connection test failed'
+            };
+        }
+    }
+    /**
+     * Test Redis connection
+     */
+    async testRedisConnection(backend) {
+        if (!backend.connectionString) {
+            return {
+                success: false,
+                error: 'No Redis connection string provided'
+            };
+        }
+        try {
+            // Validate connection string format
+            const isValidUrl = backend.connectionString.startsWith('redis://') ||
+                backend.connectionString.startsWith('rediss://');
+            if (!isValidUrl) {
+                return {
+                    success: false,
+                    error: 'Invalid Redis connection string format'
+                };
+            }
+            return {
+                success: true,
+                latency: 0,
+                capabilities: ['persistent', 'fast-access', 'simple-setup']
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Redis connection test failed'
+            };
+        }
+    }
+    /**
+     * Test Memory connection (always available)
+     */
+    async testMemoryConnection(backend) {
+        return {
+            success: true,
+            latency: 0,
+            capabilities: ['fast-access', 'simple-setup', 'no-persistence']
+        };
+    }
+    /**
+     * Select the best available storage backend
+     */
+    async selectBackend() {
+        // Detect environment variables
+        this.detectEnvironmentVariables();
+        // Sort by priority (lowest number = highest priority)
+        const sortedConfig = this.config.sort((a, b) => a.priority - b.priority);
+        // Test each backend in priority order
+        for (const backend of sortedConfig) {
+            if (!backend.enabled) {
+                this.backendInfo.push({
+                    type: backend.type,
+                    priority: backend.priority,
+                    available: false,
+                    connectionString: backend.connectionString,
+                    testResult: {
+                        success: false,
+                        error: 'Backend disabled'
+                    }
+                });
+                continue;
+            }
+            const testResult = await this.testConnection(backend);
+            this.backendInfo.push({
+                type: backend.type,
+                priority: backend.priority,
+                available: testResult.success,
+                connectionString: backend.connectionString,
+                testResult
+            });
+            if (testResult.success) {
+                const createdBackend = await this.createBackend(backend);
+                if (createdBackend) {
+                    this.selectedBackend = createdBackend;
+                    return this.selectedBackend;
+                }
+                else {
+                    // Backend test passed but creation failed (not implemented)
+                    this.backendInfo[this.backendInfo.length - 1].available = false;
+                    this.backendInfo[this.backendInfo.length - 1].testResult = {
+                        success: false,
+                        error: `${backend.type} storage not yet implemented`
+                    };
+                }
+            }
+        }
+        // If no backend is available, create memory backend as fallback
+        this.selectedBackend = new memory_storage_1.MemoryStorage();
+        return this.selectedBackend;
+    }
+    /**
+     * Create a storage backend instance
+     */
+    async createBackend(backend) {
+        switch (backend.type) {
+            case 'postgresql':
+                if (!backend.connectionString) {
+                    throw new Error('PostgreSQL connection string required');
+                }
+                return new postgresql_storage_1.PostgreSQLStorage(backend.connectionString, backend.options);
+            case 'mongodb':
+                // TODO: Implement MongoDB storage
+                // For now, return null to indicate this backend is not available
+                return null;
+            case 'redis-cluster':
+                if (!backend.connectionString) {
+                    throw new Error('Redis Cluster connection string required');
+                }
+                return new redis_cluster_storage_1.RedisClusterStorage(backend.connectionString, backend.options);
+            case 'redis':
+                if (!backend.connectionString) {
+                    throw new Error('Redis connection string required');
+                }
+                return new redis_storage_1.RedisStorage(backend.connectionString, backend.options);
+            case 'memory':
+                return new memory_storage_1.MemoryStorage();
+            default:
+                throw new Error(`Unknown backend type: ${backend.type}`);
+        }
+    }
+    /**
+     * Get information about all tested backends
+     */
+    getBackendInfo() {
+        return this.backendInfo;
+    }
+    /**
+     * Get the currently selected backend
+     */
+    getSelectedBackend() {
+        return this.selectedBackend;
+    }
+    /**
+     * Get the configuration for all backends
+     */
+    getConfig() {
+        return this.config;
+    }
+    /**
+     * Update the configuration for a specific backend
+     */
+    updateConfig(type, updates) {
+        const config = this.config.find(c => c.type === type);
+        if (config) {
+            Object.assign(config, updates);
+        }
+    }
+    /**
+     * Cleanup resources and close connections
+     */
+    async cleanup() {
+        if (this.selectedBackend) {
+            await this.selectedBackend.close();
+            this.selectedBackend = undefined;
+        }
+        this.backendInfo = [];
+    }
+}
+exports.StorageBackendSelector = StorageBackendSelector;
+//# sourceMappingURL=backend-selector.js.map

package/dist/storage/backend-selector.js.map

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

package/dist/storage/index.d.ts

@@ -0,0 +1,7 @@
+export * from './memory-storage';
+export * from './redis-storage';
+export * from './postgresql-storage';
+export * from './redis-cluster-storage';
+export * from './backend-selector';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAQA,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC"}

package/dist/storage/index.js

@@ -0,0 +1,30 @@
+"use strict";
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./memory-storage"), exports);
+__exportStar(require("./redis-storage"), exports);
+__exportStar(require("./postgresql-storage"), exports);
+__exportStar(require("./redis-cluster-storage"), exports);
+__exportStar(require("./backend-selector"), exports);
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":";AAAA;;;;;;EAME;;;;;;;;;;;;;;;;AAEF,mDAAiC;AACjC,kDAAgC;AAChC,uDAAqC;AACrC,0DAAwC;AACxC,qDAAmC;AACnC,0CAAwB"}

package/dist/storage/memory-storage.d.ts

@@ -0,0 +1,55 @@
+import { RetryState } from '../types';
+import { StorageBackend, StorageStats } from './types';
+/**
+ * In-memory storage backend for retry states
+ */
+export declare class MemoryStorage implements StorageBackend {
+    private storage;
+    private lastAccess;
+    private lastWrite;
+    /**
+     * Store a retry state
+     */
+    set(key: string, value: RetryState): Promise<void>;
+    /**
+     * Get a retry state
+     */
+    get(key: string): Promise<RetryState | null>;
+    /**
+     * Delete a retry state
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * List all retry states
+     */
+    list(): Promise<RetryState[]>;
+    /**
+     * Clear all retry states
+     */
+    clear(): Promise<void>;
+    /**
+     * Get storage statistics
+     */
+    getStats(): Promise<StorageStats>;
+    /**
+     * Test the connection (always true for memory storage)
+     */
+    testConnection(): Promise<boolean>;
+    /**
+     * Close the connection (no-op for memory storage)
+     */
+    close(): Promise<void>;
+    /**
+     * Get the underlying Map for direct access (use with caution)
+     */
+    getStorageMap(): Map<string, RetryState>;
+    /**
+     * Get the number of stored items
+     */
+    getSize(): number;
+    /**
+     * Check if a key exists
+     */
+    has(key: string): boolean;
+}
+//# sourceMappingURL=memory-storage.d.ts.map

package/dist/storage/memory-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-storage.d.ts","sourceRoot":"","sources":["../../src/storage/memory-storage.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvD;;GAEG;AACH,qBAAa,aAAc,YAAW,cAAc;IAClD,OAAO,CAAC,OAAO,CAAsC;IACrD,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,SAAS,CAAoB;IAErC;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxD;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAKlD;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAKnC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC;IAmBvC;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAIxC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;OAEG;IACH,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC;IAIxC;;OAEG;IACH,OAAO,IAAI,MAAM;IAIjB;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CAG1B"}