@freshguard/freshguard-core 0.11.2

package/dist/resilience/retry-policy.js

@@ -0,0 +1,423 @@
+import { createComponentLogger } from '../observability/logger.js';
+import { createComponentMetrics } from '../observability/metrics.js';
+export class RetryExhaustedError extends Error {
+    attempts;
+    totalDuration;
+    lastError;
+    constructor(attempts, totalDuration, lastError) {
+        const message = `Retry exhausted after ${attempts.length} attempts (${totalDuration}ms). Last error: ${lastError.message}`;
+        super(message);
+        this.name = 'RetryExhaustedError';
+        this.attempts = attempts;
+        this.totalDuration = totalDuration;
+        this.lastError = lastError;
+    }
+}
+export class AttemptTimeoutError extends Error {
+    attemptNumber;
+    timeout;
+    constructor(attemptNumber, timeout) {
+        super(`Attempt ${attemptNumber} timed out after ${timeout}ms`);
+        this.name = 'AttemptTimeoutError';
+        this.attemptNumber = attemptNumber;
+        this.timeout = timeout;
+    }
+}
+const DEFAULT_CONFIG = {
+    maxAttempts: 3,
+    baseDelay: 100,
+    maxDelay: 5000,
+    backoffMultiplier: 2,
+    enableJitter: true,
+    logger: createComponentLogger('retry-policy'),
+    metrics: createComponentMetrics('retry-policy'),
+    enableDetailedLogging: false
+};
+export const DATABASE_RETRY_CONFIG = {
+    maxAttempts: 5,
+    baseDelay: 200,
+    maxDelay: 10000,
+    backoffMultiplier: 2,
+    enableJitter: true,
+    attemptTimeout: 30000,
+    retryCondition: (error) => {
+        const retryableErrors = [
+            'connection',
+            'timeout',
+            'network',
+            'econnreset',
+            'enotfound',
+            'temporarily unavailable',
+            'service unavailable'
+        ];
+        const message = error.message.toLowerCase();
+        return retryableErrors.some(pattern => message.includes(pattern));
+    }
+};
+export const API_RETRY_CONFIG = {
+    maxAttempts: 3,
+    baseDelay: 1000,
+    maxDelay: 8000,
+    backoffMultiplier: 2,
+    enableJitter: true,
+    attemptTimeout: 10000,
+    retryCondition: (error, attempt) => {
+        if (error.message.includes('status')) {
+            const statusMatch = /status\s+(\d+)/i.exec(error.message);
+            if (statusMatch?.[1]) {
+                const status = parseInt(statusMatch[1]);
+                return status >= 500 && status < 600;
+            }
+        }
+        const networkErrors = ['timeout', 'network', 'connection'];
+        const hasNetworkError = networkErrors.some(pattern => error.message.toLowerCase().includes(pattern));
+        return hasNetworkError && attempt <= 2;
+    }
+};
+function calculateDelay(attempt, baseDelay, maxDelay, multiplier, enableJitter) {
+    const exponentialDelay = Math.min(baseDelay * Math.pow(multiplier, attempt - 1), maxDelay);
+    if (enableJitter) {
+        const jitter = Math.random() * 0.1 * exponentialDelay;
+        return Math.floor(exponentialDelay + (Math.random() > 0.5 ? jitter : -jitter));
+    }
+    return exponentialDelay;
+}
+function defaultRetryCondition(error, _attempt) {
+    const nonRetryableErrors = [
+        'validation',
+        'authentication',
+        'authorization',
+        'permission',
+        'forbidden',
+        'not found',
+        'bad request'
+    ];
+    const message = error.message.toLowerCase();
+    const errorName = error.name.toLowerCase();
+    return !nonRetryableErrors.some(pattern => message.includes(pattern) || errorName.includes(pattern));
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+async function executeWithTimeout(fn, timeoutMs, attemptNumber = 1) {
+    if (timeoutMs <= 0) {
+        return fn();
+    }
+    const controller = new AbortController();
+    let timedOut = false;
+    const timeoutId = setTimeout(() => {
+        timedOut = true;
+        controller.abort();
+    }, timeoutMs);
+    try {
+        let result;
+        try {
+            result = await fn(controller.signal);
+        }
+        catch (sigError) {
+            result = await fn();
+        }
+        return result;
+    }
+    catch (error) {
+        if (timedOut || controller.signal.aborted) {
+            throw new AttemptTimeoutError(attemptNumber, timeoutMs);
+        }
+        throw error;
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+}
+export class RetryPolicy {
+    config;
+    logger;
+    metrics;
+    enableDetailedLogging;
+    stats = {
+        totalExecutions: 0,
+        successfulExecutions: 0,
+        failedExecutions: 0,
+        totalAttempts: 0,
+        averageAttempts: 0,
+        averageDuration: 0,
+        successRate: 0,
+        lastExecutionTime: null
+    };
+    constructor(config = {}) {
+        this.config = {
+            ...DEFAULT_CONFIG,
+            retryCondition: config.retryCondition || defaultRetryCondition,
+            delayFunction: config.delayFunction || ((attempt, baseDelay, maxDelay) => calculateDelay(attempt, baseDelay, maxDelay, DEFAULT_CONFIG.backoffMultiplier, DEFAULT_CONFIG.enableJitter)),
+            attemptTimeout: config.attemptTimeout || 0,
+            name: config.name || 'RetryPolicy',
+            maxAttempts: config.maxAttempts || DEFAULT_CONFIG.maxAttempts,
+            baseDelay: config.baseDelay || DEFAULT_CONFIG.baseDelay,
+            maxDelay: config.maxDelay || DEFAULT_CONFIG.maxDelay,
+            backoffMultiplier: config.backoffMultiplier || DEFAULT_CONFIG.backoffMultiplier,
+            enableJitter: config.enableJitter !== undefined ? config.enableJitter : DEFAULT_CONFIG.enableJitter
+        };
+        this.logger = config.logger || createComponentLogger('retry-policy');
+        this.metrics = config.metrics || createComponentMetrics('retry_policy');
+        this.enableDetailedLogging = config.enableDetailedLogging !== false;
+        if (this.config.maxAttempts < 1) {
+            throw new Error('maxAttempts must be at least 1');
+        }
+        if (this.config.baseDelay < 0) {
+            throw new Error('baseDelay cannot be negative');
+        }
+        if (this.config.maxDelay < this.config.baseDelay) {
+            throw new Error('maxDelay must be >= baseDelay');
+        }
+        this.logger.info('Retry policy initialized', {
+            policyName: this.config.name,
+            maxAttempts: this.config.maxAttempts,
+            baseDelay: this.config.baseDelay,
+            maxDelay: this.config.maxDelay,
+            backoffMultiplier: this.config.backoffMultiplier,
+            enableJitter: this.config.enableJitter
+        });
+    }
+    async execute(fn) {
+        const result = await this.executeWithResult(fn);
+        if (result.success && result.data !== undefined) {
+            return result.data;
+        }
+        else {
+            throw result.error || new Error('Retry failed with unknown error');
+        }
+    }
+    async executeWithResult(fn) {
+        const attempts = [];
+        const startTime = Date.now();
+        this.stats.totalExecutions++;
+        this.stats.lastExecutionTime = new Date();
+        if (this.enableDetailedLogging) {
+            this.logger.debug('Starting retry execution', {
+                policyName: this.config.name,
+                maxAttempts: this.config.maxAttempts
+            });
+        }
+        for (let attempt = 1; attempt <= this.config.maxAttempts; attempt++) {
+            const attemptStartTime = new Date();
+            let attemptEndTime = null;
+            let error = null;
+            let result;
+            try {
+                if (this.config.attemptTimeout && this.config.attemptTimeout > 0) {
+                    result = await executeWithTimeout(fn, this.config.attemptTimeout, attempt);
+                }
+                else {
+                    result = await fn();
+                }
+                attemptEndTime = new Date();
+                const attemptInfo = {
+                    attempt,
+                    startTime: attemptStartTime,
+                    endTime: attemptEndTime,
+                    duration: attemptEndTime.getTime() - attemptStartTime.getTime(),
+                    error: null,
+                    delay: 0,
+                    success: true
+                };
+                attempts.push(attemptInfo);
+                const totalDuration = Date.now() - startTime;
+                this.logger.info('Retry execution succeeded', {
+                    policyName: this.config.name,
+                    attempt,
+                    duration: attemptInfo.duration,
+                    totalDuration,
+                    success: true
+                });
+                this.metrics.recordRetryAttempt(this.config.name, attempt, attemptInfo.duration, true, true);
+                this.updateStats(attempts, totalDuration, true);
+                return {
+                    success: true,
+                    data: result,
+                    attempts,
+                    totalDuration,
+                    totalAttempts: attempt
+                };
+            }
+            catch (err) {
+                error = err;
+                attemptEndTime = new Date();
+                const attemptInfo = {
+                    attempt,
+                    startTime: attemptStartTime,
+                    endTime: attemptEndTime,
+                    duration: attemptEndTime.getTime() - attemptStartTime.getTime(),
+                    error,
+                    delay: 0,
+                    success: false
+                };
+                const willRetry = attempt < this.config.maxAttempts && this.config.retryCondition(error, attempt);
+                if (willRetry) {
+                    const delay = this.config.delayFunction(attempt, this.config.baseDelay, this.config.maxDelay);
+                    attemptInfo.delay = delay;
+                    attempts.push(attemptInfo);
+                    this.logger.warn('Retry attempt failed, will retry', {
+                        policyName: this.config.name,
+                        attempt,
+                        duration: attemptInfo.duration,
+                        errorType: error.constructor.name,
+                        errorMessage: error.message,
+                        delay,
+                        nextAttempt: attempt + 1,
+                        maxAttempts: this.config.maxAttempts
+                    });
+                    this.metrics.recordRetryAttempt(this.config.name, attempt, attemptInfo.duration, false, false);
+                    await sleep(delay);
+                }
+                else {
+                    attempts.push(attemptInfo);
+                    if (attempt >= this.config.maxAttempts) {
+                        this.logger.error('Retry attempts exhausted', {
+                            policyName: this.config.name,
+                            attempt,
+                            duration: attemptInfo.duration,
+                            errorType: error.constructor.name,
+                            errorMessage: error.message,
+                            totalAttempts: this.config.maxAttempts
+                        });
+                    }
+                    else {
+                        this.logger.info('Retry not attempted due to retry condition', {
+                            policyName: this.config.name,
+                            attempt,
+                            errorType: error.constructor.name,
+                            errorMessage: error.message
+                        });
+                    }
+                    this.metrics.recordRetryAttempt(this.config.name, attempt, attemptInfo.duration, false, true);
+                    break;
+                }
+            }
+        }
+        const totalDuration = Date.now() - startTime;
+        this.updateStats(attempts, totalDuration, false);
+        const lastError = attempts[attempts.length - 1]?.error || new Error('Unknown error');
+        const retryExhaustedError = new RetryExhaustedError(attempts, totalDuration, lastError);
+        this.logger.error('Retry execution failed after all attempts', {
+            policyName: this.config.name,
+            totalAttempts: attempts.length,
+            totalDuration,
+            lastErrorType: lastError.constructor.name,
+            lastErrorMessage: lastError.message,
+            success: false
+        });
+        return {
+            success: false,
+            error: retryExhaustedError,
+            attempts,
+            totalDuration,
+            totalAttempts: attempts.length
+        };
+    }
+    updateStats(attempts, totalDuration, success) {
+        this.stats.totalAttempts += attempts.length;
+        if (success) {
+            this.stats.successfulExecutions++;
+        }
+        else {
+            this.stats.failedExecutions++;
+        }
+        this.stats.averageAttempts = this.stats.totalAttempts / this.stats.totalExecutions;
+        this.stats.averageDuration = ((this.stats.averageDuration * (this.stats.totalExecutions - 1) + totalDuration) /
+            this.stats.totalExecutions);
+        this.stats.successRate = (this.stats.successfulExecutions / this.stats.totalExecutions) * 100;
+    }
+    getStats() {
+        return {
+            ...this.stats,
+            averageAttempts: Math.round(this.stats.averageAttempts * 100) / 100,
+            averageDuration: Math.round(this.stats.averageDuration * 100) / 100,
+            successRate: Math.round(this.stats.successRate * 100) / 100
+        };
+    }
+    resetStats() {
+        this.stats = {
+            totalExecutions: 0,
+            successfulExecutions: 0,
+            failedExecutions: 0,
+            totalAttempts: 0,
+            averageAttempts: 0,
+            averageDuration: 0,
+            successRate: 0,
+            lastExecutionTime: null
+        };
+    }
+    getConfig() {
+        return {
+            ...this.config,
+            logger: this.logger,
+            metrics: this.metrics
+        };
+    }
+    withConfig(config) {
+        return new RetryPolicy({ ...this.config, ...config });
+    }
+}
+export async function executeWithRetry(fn, config) {
+    const policy = new RetryPolicy(config);
+    return policy.execute(fn);
+}
+export async function executeWithDatabaseRetry(fn) {
+    const policy = new RetryPolicy(DATABASE_RETRY_CONFIG);
+    return policy.execute(fn);
+}
+export async function executeWithApiRetry(fn) {
+    const policy = new RetryPolicy(API_RETRY_CONFIG);
+    return policy.execute(fn);
+}
+export class RetryPolicyRegistry {
+    policies = new Map();
+    register(name, config) {
+        const policy = new RetryPolicy({ ...config, name });
+        this.policies.set(name, policy);
+        return policy;
+    }
+    get(name) {
+        return this.policies.get(name);
+    }
+    getOrCreate(name, config) {
+        let policy = this.policies.get(name);
+        if (!policy) {
+            policy = new RetryPolicy({ ...(config || {}), name });
+            this.policies.set(name, policy);
+        }
+        return policy;
+    }
+    getAllPolicies() {
+        return new Map(this.policies);
+    }
+    getAllStats() {
+        const stats = {};
+        for (const [name, policy] of this.policies) {
+            stats[name] = policy.getStats();
+        }
+        return stats;
+    }
+    resetAllStats() {
+        for (const policy of this.policies.values()) {
+            policy.resetStats();
+        }
+    }
+    remove(name) {
+        return this.policies.delete(name);
+    }
+    clear() {
+        this.policies.clear();
+    }
+}
+export const defaultRetryPolicyRegistry = new RetryPolicyRegistry();
+defaultRetryPolicyRegistry.register('database', DATABASE_RETRY_CONFIG);
+defaultRetryPolicyRegistry.register('api', API_RETRY_CONFIG);
+defaultRetryPolicyRegistry.register('default', {
+    maxAttempts: 3,
+    baseDelay: 100,
+    maxDelay: 5000,
+    backoffMultiplier: 2,
+    enableJitter: true
+});
+//# sourceMappingURL=retry-policy.js.map

package/dist/resilience/retry-policy.js.map

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

package/dist/resilience/timeout-manager.d.ts

@@ -0,0 +1,97 @@
+export interface TimeoutConfig {
+    duration: number;
+    name?: string;
+    parent?: TimeoutManager;
+    message?: string;
+    propagateToChildren?: boolean;
+}
+export interface TimeoutResult<T> {
+    success: boolean;
+    data?: T;
+    error?: Error;
+    duration: number;
+    timedOut: boolean;
+    cancelled: boolean;
+}
+export interface TimeoutStats {
+    totalExecutions: number;
+    successfulExecutions: number;
+    timeoutCount: number;
+    cancelledCount: number;
+    averageDuration: number;
+    maxDuration: number;
+    minDuration: number;
+    timeoutRate: number;
+    lastExecutionTime: Date | null;
+}
+export interface ActiveTimeout {
+    id: string;
+    name: string;
+    startTime: Date;
+    duration: number;
+    controller: AbortController;
+    parent?: TimeoutManager;
+    children: Set<TimeoutManager>;
+}
+export declare class OperationTimeoutError extends Error {
+    readonly duration: number;
+    readonly operationName: string;
+    readonly timestamp: Date;
+    constructor(duration: number, operationName: string, customMessage?: string);
+}
+export declare class OperationCancelledError extends Error {
+    readonly operationName: string;
+    readonly timestamp: Date;
+    readonly reason: string;
+    constructor(operationName: string, reason?: string);
+}
+export declare class TimeoutManager {
+    private readonly controller;
+    private timeoutId;
+    private readonly config;
+    private startTime;
+    private endTime;
+    private readonly children;
+    private timeoutFired;
+    private stats;
+    constructor(config: TimeoutConfig);
+    execute<T>(fn: (signal: AbortSignal) => Promise<T>): Promise<T>;
+    executeWithResult<T>(fn: (signal: AbortSignal) => Promise<T>): Promise<TimeoutResult<T>>;
+    static executeWithTimeout<T>(fn: (signal: AbortSignal) => Promise<T>, duration: number, name?: string): Promise<T>;
+    static executeWithTimeoutResult<T>(fn: (signal: AbortSignal) => Promise<T>, duration: number, name?: string): Promise<TimeoutResult<T>>;
+    createChild(config: Omit<TimeoutConfig, 'parent'>): TimeoutManager;
+    addChild(child: TimeoutManager): void;
+    removeChild(child: TimeoutManager): void;
+    cancel(reason?: string): void;
+    private timeout;
+    private cleanup;
+    private updateStats;
+    isAborted(): boolean;
+    getSignal(): AbortSignal;
+    getConfig(): TimeoutConfig;
+    getStats(): TimeoutStats;
+    resetStats(): void;
+    getActiveTimeout(): ActiveTimeout | null;
+    getRemainingTime(): number;
+    getElapsedTime(): number;
+}
+export declare class TimeoutRegistry {
+    private readonly timeouts;
+    private readonly activeTimeouts;
+    create(name: string, config: Omit<TimeoutConfig, 'name'>): TimeoutManager;
+    get(name: string): TimeoutManager | undefined;
+    getOrCreate(name: string, config: Omit<TimeoutConfig, 'name'>): TimeoutManager;
+    remove(name: string): boolean;
+    getAllTimeouts(): Map<string, TimeoutManager>;
+    getActiveTimeouts(): Map<string, ActiveTimeout>;
+    getAllStats(): Record<string, TimeoutStats>;
+    cancelAll(reason?: string): void;
+    resetAllStats(): void;
+    clear(): void;
+}
+export declare function withTimeout<T>(fn: (signal: AbortSignal) => Promise<T>, timeoutMs: number, name?: string): Promise<T>;
+export declare function withTimeoutResult<T>(fn: (signal: AbortSignal) => Promise<T>, timeoutMs: number, name?: string): Promise<TimeoutResult<T>>;
+export declare function createDatabaseTimeout(operationName: string): TimeoutManager;
+export declare function createApiTimeout(operationName: string): TimeoutManager;
+export declare const defaultTimeoutRegistry: TimeoutRegistry;
+//# sourceMappingURL=timeout-manager.d.ts.map

package/dist/resilience/timeout-manager.d.ts.map

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