@bernierllc/backoff-retry 0.1.1 → 0.3.1

package/dist/security/security-manager.js

@@ -0,0 +1,417 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SecurityManager = exports.DEFAULT_SECURITY_CONFIG = void 0;
+const events_1 = require("events");
+// Dynamic import for crypto-js to make it optional
+let CryptoJS = null;
+/**
+ * Default security configuration
+ */
+exports.DEFAULT_SECURITY_CONFIG = {
+    encryption: {
+        enabled: false,
+        algorithm: 'AES-256-CBC',
+        keyEnvVar: 'BACKOFF_RETRY_ENCRYPTION_KEY'
+    },
+    accessControl: {
+        enabled: false,
+        roles: ['admin', 'user', 'readonly'],
+        permissions: {
+            admin: ['read', 'write', 'delete', 'clear', 'configure'],
+            user: ['read', 'write'],
+            readonly: ['read']
+        },
+        defaultRole: 'user'
+    },
+    auditLogging: {
+        enabled: false,
+        level: 'basic',
+        includeSensitiveData: false,
+        maxLogSize: 1000
+    },
+    rateLimiting: {
+        enabled: false,
+        maxRequestsPerMinute: 100,
+        maxRequestsPerHour: 1000,
+        windowMs: 60000
+    }
+};
+/**
+ * Security Manager for handling encryption, access control, and audit logging
+ */
+class SecurityManager extends events_1.EventEmitter {
+    constructor(config = {}) {
+        super();
+        this.auditLog = [];
+        this.rateLimitStore = new Map();
+        this.encryptionKey = null;
+        this.config = { ...exports.DEFAULT_SECURITY_CONFIG, ...config };
+        // For encryption, validate immediately if enabled to catch errors synchronously
+        if (this.config.encryption?.enabled) {
+            this.validateEncryptionConfig();
+            // Still initialize asynchronously for actual setup
+            this.initializeSecurity();
+        }
+    }
+    /**
+     * Validate encryption configuration synchronously
+     */
+    validateEncryptionConfig() {
+        // Get encryption key
+        this.encryptionKey = this.config.encryption?.key ||
+            process.env[this.config.encryption?.keyEnvVar || 'BACKOFF_RETRY_ENCRYPTION_KEY'] ||
+            null;
+        if (!this.encryptionKey) {
+            throw new Error('Encryption key not provided. Set BACKOFF_RETRY_ENCRYPTION_KEY environment variable or provide key in config.');
+        }
+        // Validate key length (minimum 32 characters for AES-256)
+        if (this.encryptionKey.length < 32) {
+            throw new Error('Encryption key must be at least 32 characters long for AES-256.');
+        }
+    }
+    /**
+     * Initialize security features
+     */
+    async initializeSecurity() {
+        if (this.config.encryption?.enabled) {
+            await this.initializeEncryption();
+        }
+    }
+    /**
+     * Initialize encryption
+     */
+    async initializeEncryption() {
+        try {
+            // Dynamic import of crypto-js
+            if (!CryptoJS) {
+                CryptoJS = await Promise.resolve().then(() => __importStar(require('crypto-js')));
+            }
+            // Key validation is already done in validateEncryptionConfig()
+            // Just emit the initialization event
+            this.emit('encryption_initialized', { algorithm: this.config.encryption?.algorithm || 'AES-256-CBC' });
+        }
+        catch (error) {
+            this.emit('encryption_error', { error: error instanceof Error ? error.message : 'Unknown error' });
+            throw error;
+        }
+    }
+    /**
+     * Encrypt retry state data
+     */
+    async encryptData(data) {
+        if (!this.config.encryption?.enabled || !this.encryptionKey) {
+            return JSON.stringify(data);
+        }
+        try {
+            const jsonData = JSON.stringify(data);
+            const encrypted = CryptoJS.AES.encrypt(jsonData, this.encryptionKey).toString();
+            return encrypted;
+        }
+        catch (error) {
+            this.emit('encryption_error', { error: error instanceof Error ? error.message : 'Unknown error' });
+            throw new Error(`Failed to encrypt data: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Decrypt retry state data
+     */
+    async decryptData(encryptedData) {
+        if (!this.config.encryption?.enabled || !this.encryptionKey) {
+            return JSON.parse(encryptedData);
+        }
+        try {
+            const decrypted = CryptoJS.AES.decrypt(encryptedData, this.encryptionKey);
+            const jsonData = decrypted.toString(CryptoJS.enc.Utf8);
+            return JSON.parse(jsonData);
+        }
+        catch (error) {
+            this.emit('decryption_error', { error: error instanceof Error ? error.message : 'Unknown error' });
+            throw new Error(`Failed to decrypt data: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Check access permissions
+     */
+    checkAccess(accessControl, action, resource) {
+        if (!this.config.accessControl?.enabled) {
+            return true; // No access control enabled
+        }
+        const { userRole, permissions } = accessControl;
+        const allowedPermissions = this.config.accessControl?.permissions?.[userRole] || [];
+        // Check if user has the required permission
+        if (!allowedPermissions.includes(action)) {
+            this.logAudit({
+                userId: accessControl.userId,
+                userRole,
+                action,
+                resource,
+                success: false,
+                details: { reason: 'Insufficient permissions', requiredPermission: action }
+            });
+            return false;
+        }
+        this.logAudit({
+            userId: accessControl.userId,
+            userRole,
+            action,
+            resource,
+            success: true
+        });
+        return true;
+    }
+    /**
+     * Check rate limiting
+     */
+    checkRateLimit(identifier, limit = this.config.rateLimiting?.maxRequestsPerMinute || 100) {
+        if (!this.config.rateLimiting?.enabled) {
+            return true; // No rate limiting enabled
+        }
+        const now = new Date();
+        const windowMs = this.config.rateLimiting?.windowMs || 60000;
+        const windowStart = new Date(now.getTime() - windowMs);
+        // Get or create rate limit info
+        let rateLimitInfo = this.rateLimitStore.get(identifier);
+        if (!rateLimitInfo || rateLimitInfo.windowStart < windowStart) {
+            rateLimitInfo = {
+                requests: 0,
+                windowStart: now,
+                limit
+            };
+        }
+        // Check if limit exceeded
+        if (rateLimitInfo.requests >= rateLimitInfo.limit) {
+            this.logAudit({
+                action: 'rate_limit_exceeded',
+                resource: identifier,
+                success: false,
+                details: {
+                    requests: rateLimitInfo.requests,
+                    limit: rateLimitInfo.limit,
+                    windowStart: rateLimitInfo.windowStart
+                }
+            });
+            return false;
+        }
+        // Increment request count
+        rateLimitInfo.requests++;
+        this.rateLimitStore.set(identifier, rateLimitInfo);
+        return true;
+    }
+    /**
+     * Log audit entry
+     */
+    logAudit(entry) {
+        if (!this.config.auditLogging?.enabled) {
+            return;
+        }
+        const auditEntry = {
+            id: this.generateId(),
+            timestamp: new Date(),
+            ...entry
+        };
+        // Add to audit log
+        this.auditLog.push(auditEntry);
+        // Maintain log size limit
+        if (this.auditLog.length > (this.config.auditLogging?.maxLogSize || 1000)) {
+            this.auditLog.shift();
+        }
+        // Emit audit event
+        this.emit('audit_log', auditEntry);
+        // Emit specific events based on action
+        if (entry.success) {
+            this.emit('audit_success', auditEntry);
+        }
+        else {
+            this.emit('audit_failure', auditEntry);
+        }
+    }
+    /**
+     * Get audit log entries
+     */
+    getAuditLog(limit = 100, offset = 0) {
+        return this.auditLog
+            .slice(offset, offset + limit)
+            .reverse(); // Most recent first
+    }
+    /**
+     * Get audit log entries by user
+     */
+    getAuditLogByUser(userId, limit = 100) {
+        return this.auditLog
+            .filter(entry => entry.userId === userId)
+            .slice(-limit)
+            .reverse();
+    }
+    /**
+     * Get audit log entries by action
+     */
+    getAuditLogByAction(action, limit = 100) {
+        return this.auditLog
+            .filter(entry => entry.action === action)
+            .slice(-limit)
+            .reverse();
+    }
+    /**
+     * Get audit statistics
+     */
+    getAuditStats() {
+        const totalEntries = this.auditLog.length;
+        const successCount = this.auditLog.filter(entry => entry.success).length;
+        const failureCount = totalEntries - successCount;
+        const actionStats = this.auditLog.reduce((stats, entry) => {
+            stats[entry.action] = (stats[entry.action] || 0) + 1;
+            return stats;
+        }, {});
+        const userStats = this.auditLog.reduce((stats, entry) => {
+            const userId = entry.userId || 'anonymous';
+            stats[userId] = (stats[userId] || 0) + 1;
+            return stats;
+        }, {});
+        return {
+            totalEntries,
+            successCount,
+            failureCount,
+            successRate: totalEntries > 0 ? (successCount / totalEntries) * 100 : 0,
+            actionStats,
+            userStats,
+            timeRange: {
+                start: this.auditLog[0]?.timestamp,
+                end: this.auditLog[this.auditLog.length - 1]?.timestamp
+            }
+        };
+    }
+    /**
+     * Clear audit log
+     */
+    clearAuditLog() {
+        this.auditLog = [];
+        this.emit('audit_log_cleared');
+    }
+    /**
+     * Get rate limit information
+     */
+    getRateLimitInfo(identifier) {
+        return this.rateLimitStore.get(identifier) || null;
+    }
+    /**
+     * Reset rate limit for an identifier
+     */
+    resetRateLimit(identifier) {
+        this.rateLimitStore.delete(identifier);
+        this.emit('rate_limit_reset', { identifier });
+    }
+    /**
+     * Get security configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Update security configuration
+     */
+    updateConfig(newConfig) {
+        this.config = { ...this.config, ...newConfig };
+        this.emit('config_updated', { config: this.config });
+    }
+    /**
+     * Check if encryption is enabled
+     */
+    isEncryptionEnabled() {
+        return this.config.encryption?.enabled === true;
+    }
+    /**
+     * Check if access control is enabled
+     */
+    isAccessControlEnabled() {
+        return this.config.accessControl?.enabled === true;
+    }
+    /**
+     * Check if audit logging is enabled
+     */
+    isAuditLoggingEnabled() {
+        return this.config.auditLogging?.enabled === true;
+    }
+    /**
+     * Check if rate limiting is enabled
+     */
+    isRateLimitingEnabled() {
+        return this.config.rateLimiting?.enabled === true;
+    }
+    /**
+     * Generate unique ID for audit entries
+     */
+    generateId() {
+        return `audit_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+    }
+    /**
+     * Get security status
+     */
+    getSecurityStatus() {
+        return {
+            encryption: {
+                enabled: this.isEncryptionEnabled(),
+                algorithm: this.config.encryption?.algorithm,
+                keyConfigured: !!this.encryptionKey
+            },
+            accessControl: {
+                enabled: this.isAccessControlEnabled(),
+                roles: this.config.accessControl?.roles || [],
+                permissions: this.config.accessControl?.permissions || {}
+            },
+            auditLogging: {
+                enabled: this.isAuditLoggingEnabled(),
+                level: this.config.auditLogging?.level,
+                logSize: this.auditLog.length,
+                maxLogSize: this.config.auditLogging?.maxLogSize
+            },
+            rateLimiting: {
+                enabled: this.isRateLimitingEnabled(),
+                activeLimits: this.rateLimitStore.size,
+                maxRequestsPerMinute: this.config.rateLimiting?.maxRequestsPerMinute,
+                maxRequestsPerHour: this.config.rateLimiting?.maxRequestsPerHour
+            }
+        };
+    }
+}
+exports.SecurityManager = SecurityManager;
+//# sourceMappingURL=security-manager.js.map

package/dist/security/security-manager.js.map

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

package/dist/storage/backend-selector.d.ts

@@ -0,0 +1,96 @@
+import { StorageBackend } from './types';
+export interface StorageBackendConfig {
+    priority: number;
+    type: 'postgresql' | 'mongodb' | 'redis-cluster' | 'redis' | 'memory';
+    enabled: boolean;
+    connectionString?: string;
+    options?: Record<string, any>;
+    fallbackTo?: string[];
+}
+export interface StorageBackendTestResult {
+    success: boolean;
+    error?: string;
+    latency?: number;
+    capabilities?: string[];
+}
+export interface StorageBackendInfo {
+    type: string;
+    priority: number;
+    available: boolean;
+    connectionString?: string;
+    testResult?: StorageBackendTestResult;
+}
+/**
+ * Storage backend selector that implements priority-based fallback logic
+ */
+export declare class StorageBackendSelector {
+    private config;
+    private selectedBackend?;
+    private backendInfo;
+    constructor();
+    /**
+     * Get the default storage backend configuration with priority order
+     */
+    private getDefaultConfig;
+    /**
+     * Detect environment variables for each backend type
+     */
+    private detectEnvironmentVariables;
+    /**
+     * Handle manual override environment variables
+     */
+    private handleManualOverrides;
+    /**
+     * Test connection to a storage backend
+     */
+    private testConnection;
+    /**
+     * Test PostgreSQL connection
+     */
+    private testPostgreSQLConnection;
+    /**
+     * Test MongoDB connection
+     */
+    private testMongoDBConnection;
+    /**
+     * Test Redis Cluster connection
+     */
+    private testRedisClusterConnection;
+    /**
+     * Test Redis connection
+     */
+    private testRedisConnection;
+    /**
+     * Test Memory connection (always available)
+     */
+    private testMemoryConnection;
+    /**
+     * Select the best available storage backend
+     */
+    selectBackend(): Promise<StorageBackend>;
+    /**
+     * Create a storage backend instance
+     */
+    private createBackend;
+    /**
+     * Get information about all tested backends
+     */
+    getBackendInfo(): StorageBackendInfo[];
+    /**
+     * Get the currently selected backend
+     */
+    getSelectedBackend(): StorageBackend | undefined;
+    /**
+     * Get the configuration for all backends
+     */
+    getConfig(): StorageBackendConfig[];
+    /**
+     * Update the configuration for a specific backend
+     */
+    updateConfig(type: StorageBackendConfig['type'], updates: Partial<StorageBackendConfig>): void;
+    /**
+     * Cleanup resources and close connections
+     */
+    cleanup(): Promise<void>;
+}
+//# sourceMappingURL=backend-selector.d.ts.map

package/dist/storage/backend-selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-selector.d.ts","sourceRoot":"","sources":["../../src/storage/backend-selector.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,YAAY,GAAG,SAAS,GAAG,eAAe,GAAG,OAAO,GAAG,QAAQ,CAAC;IACtE,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,wBAAwB,CAAC;CACvC;AAED;;GAEG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,eAAe,CAAC,CAAiB;IACzC,OAAO,CAAC,WAAW,CAA4B;;IAM/C;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAmCxB;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAqDlC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA4C7B;;OAEG;YACW,cAAc;IA8B5B;;OAEG;YACW,wBAAwB;IA6CtC;;OAEG;YACW,qBAAqB;IAiCnC;;OAEG;YACW,0BAA0B;IA6CxC;;OAEG;YACW,mBAAmB;IAiCjC;;OAEG;YACW,oBAAoB;IAQlC;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,cAAc,CAAC;IAsD9C;;OAEG;YACW,aAAa;IA4B3B;;OAEG;IACH,cAAc,IAAI,kBAAkB,EAAE;IAItC;;OAEG;IACH,kBAAkB,IAAI,cAAc,GAAG,SAAS;IAIhD;;OAEG;IACH,SAAS,IAAI,oBAAoB,EAAE;IAInC;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI;IAO9F;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAO/B"}