@bernierllc/backoff-retry 0.1.1

package/dist/retry-manager.d.ts

@@ -0,0 +1,74 @@
+import { RetryOptions, RetryState, RetryManagerConfig, RetryResult, RetryMetrics } from './types';
+/**
+ * Main retry manager with storage and memory protection
+ */
+export declare class RetryManager {
+    private config;
+    private storage;
+    private memoryProtection;
+    private metrics;
+    constructor(config?: Partial<RetryManagerConfig>);
+    /**
+     * Execute a function with retry logic and persistent state
+     */
+    executeWithRetry<T>(id: string, fn: () => Promise<T>, options?: Partial<RetryOptions>): Promise<RetryResult<T>>;
+    /**
+     * Execute retry with backoff (original function from plans)
+     */
+    retryWithBackoff<T>(fn: () => Promise<T>, options: RetryOptions): Promise<T>;
+    /**
+     * Get retry state for a specific ID
+     */
+    getRetryState(id: string): Promise<RetryState | null>;
+    /**
+     * List all retry states (optionally filtered by prefix)
+     */
+    listRetryStates(prefix?: string): Promise<RetryState[]>;
+    /**
+     * Cancel a retry operation
+     */
+    cancelRetry(id: string): Promise<void>;
+    /**
+     * Clear all retry states
+     */
+    clearAll(): Promise<void>;
+    /**
+     * Get retry metrics
+     */
+    getMetrics(): RetryMetrics;
+    /**
+     * Get memory protection stats
+     */
+    getMemoryStats(): {
+        currentUsage: number;
+        maxUsage: number;
+        usagePercentage: number;
+        trend: number;
+        historySize: number;
+    };
+    /**
+     * Cleanup resources
+     */
+    destroy(): void;
+    /**
+     * Create initial retry state
+     */
+    private createInitialState;
+    /**
+     * Calculate delay for next retry
+     */
+    private calculateDelay;
+    /**
+     * Update metrics
+     */
+    private updateMetrics;
+    /**
+     * Sleep utility
+     */
+    private sleep;
+}
+/**
+ * Factory function to create a retry manager with default configuration
+ */
+export declare function createRetryManager(config?: Partial<RetryManagerConfig>): RetryManager;
+//# sourceMappingURL=retry-manager.d.ts.map

package/dist/retry-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-manager.d.ts","sourceRoot":"","sources":["../src/retry-manager.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,WAAW,EACX,YAAY,EAEb,MAAM,SAAS,CAAC;AAIjB;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,gBAAgB,CAA0B;IAClD,OAAO,CAAC,OAAO,CAMb;gBAEU,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC;IAiBhD;;OAEG;IACG,gBAAgB,CAAC,CAAC,EACtB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAC9B,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IA4F1B;;OAEG;IACG,gBAAgB,CAAC,CAAC,EACtB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,CAAC,CAAC;IAuCb;;OAEG;IACG,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAI3D;;OAEG;IACG,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAI7D;;OAEG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS5C;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B;;OAEG;IACH,UAAU,IAAI,YAAY;IAI1B;;OAEG;IACH,cAAc;;;;;;;IAId;;OAEG;IACH,OAAO,IAAI,IAAI;IAIf;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACH,OAAO,CAAC,cAAc;IAetB;;OAEG;IACH,OAAO,CAAC,aAAa;IAiBrB;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,YAAY,CAErF"}

package/dist/retry-manager.js

@@ -0,0 +1,258 @@
+"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.RetryManager = void 0;
+exports.createRetryManager = createRetryManager;
+const memory_protection_1 = require("./memory-protection");
+const storage_1 = require("./storage");
+/**
+ * Main retry manager with storage and memory protection
+ */
+class RetryManager {
+    constructor(config) {
+        this.metrics = {
+            totalRetries: 0,
+            successfulRetries: 0,
+            failedRetries: 0,
+            averageRetryTime: 0,
+            memoryUsage: 0
+        };
+        this.config = {
+            storage: config?.storage || (0, storage_1.createStorageAdapter)(),
+            memoryProtection: config?.memoryProtection || memory_protection_1.DEFAULT_MEMORY_PROTECTION_CONFIG,
+            defaultOptions: config?.defaultOptions || {
+                maxRetries: 5,
+                initialDelayMs: 1000,
+                maxDelayMs: 30000,
+                backoffFactor: 2,
+                jitter: true
+            }
+        };
+        this.storage = this.config.storage;
+        this.memoryProtection = new memory_protection_1.MemoryProtectionManager(this.config.memoryProtection);
+    }
+    /**
+     * Execute a function with retry logic and persistent state
+     */
+    async executeWithRetry(id, fn, options) {
+        const startTime = Date.now();
+        const mergedOptions = {
+            maxRetries: 5,
+            initialDelayMs: 1000,
+            ...this.config.defaultOptions,
+            ...options
+        };
+        // Check memory protection
+        if (!this.memoryProtection.checkMemoryUsage()) {
+            throw new Error('Memory usage exceeded limits');
+        }
+        // Get existing state or create new one
+        let state = await this.storage.get(id) || this.createInitialState(id, mergedOptions);
+        // Check if operation was cancelled
+        if (state.status === 'failed' && state.error?.message === 'Retry cancelled') {
+            return {
+                success: false,
+                error: state.error,
+                attempts: state.attempt,
+                totalTime: Date.now() - startTime
+            };
+        }
+        try {
+            const result = await fn();
+            // Success - update state and clean up
+            state.status = 'completed';
+            state.attempt = state.attempt + 1;
+            state.lastAttempt = new Date();
+            await this.storage.set(id, state);
+            const totalTime = Date.now() - startTime;
+            this.updateMetrics(true, totalTime);
+            return {
+                success: true,
+                data: result,
+                attempts: state.attempt,
+                totalTime
+            };
+        }
+        catch (error) {
+            state.attempt = state.attempt + 1;
+            state.lastAttempt = new Date();
+            state.error = error;
+            if (state.attempt >= mergedOptions.maxRetries ||
+                (mergedOptions.shouldRetry && !mergedOptions.shouldRetry(error))) {
+                // Final failure
+                state.status = 'failed';
+                await this.storage.set(id, state);
+                const totalTime = Date.now() - startTime;
+                this.updateMetrics(false, totalTime);
+                if (mergedOptions.onFailure) {
+                    mergedOptions.onFailure(error);
+                }
+                return {
+                    success: false,
+                    error,
+                    attempts: state.attempt,
+                    totalTime
+                };
+            }
+            // Calculate next retry delay
+            const delay = this.calculateDelay(state.attempt, mergedOptions);
+            state.delay = delay;
+            state.nextRetry = new Date(Date.now() + delay);
+            state.status = 'retrying';
+            await this.storage.set(id, state);
+            if (mergedOptions.onRetry) {
+                mergedOptions.onRetry(state.attempt, delay, error);
+            }
+            // Wait for delay
+            await this.sleep(delay);
+            // Recursive retry
+            return this.executeWithRetry(id, fn, options);
+        }
+    }
+    /**
+     * Execute retry with backoff (original function from plans)
+     */
+    async retryWithBackoff(fn, options) {
+        const { maxRetries, initialDelayMs, maxDelayMs = 10000, backoffFactor = 2, jitter = true, shouldRetry = () => true, onRetry, onFailure, } = options;
+        let attempt = 0;
+        let delay = initialDelayMs;
+        while (attempt < maxRetries) {
+            try {
+                return await fn();
+            }
+            catch (err) {
+                attempt++;
+                if (attempt >= maxRetries || !shouldRetry(err)) {
+                    if (onFailure)
+                        onFailure(err);
+                    throw err;
+                }
+                let actualDelay = delay;
+                if (jitter) {
+                    // Add random jitter: +/- 50%
+                    const jitterAmount = Math.random() * delay * 0.5;
+                    actualDelay = delay - delay * 0.25 + jitterAmount;
+                }
+                if (onRetry)
+                    onRetry(attempt, actualDelay, err);
+                await this.sleep(actualDelay);
+                delay = Math.min(delay * backoffFactor, maxDelayMs);
+            }
+        }
+        // Should never reach here
+        throw new Error('retryWithBackoff: Exceeded max retries');
+    }
+    /**
+     * Get retry state for a specific ID
+     */
+    async getRetryState(id) {
+        return this.storage.get(id);
+    }
+    /**
+     * List all retry states (optionally filtered by prefix)
+     */
+    async listRetryStates(prefix) {
+        return this.storage.list(prefix);
+    }
+    /**
+     * Cancel a retry operation
+     */
+    async cancelRetry(id) {
+        const state = await this.storage.get(id);
+        if (state && (state.status === 'retrying' || state.status === 'pending')) {
+            state.status = 'failed';
+            state.error = new Error('Retry cancelled');
+            await this.storage.set(id, state);
+        }
+    }
+    /**
+     * Clear all retry states
+     */
+    async clearAll() {
+        await this.storage.clear();
+    }
+    /**
+     * Get retry metrics
+     */
+    getMetrics() {
+        return { ...this.metrics };
+    }
+    /**
+     * Get memory protection stats
+     */
+    getMemoryStats() {
+        return this.memoryProtection.getStats();
+    }
+    /**
+     * Cleanup resources
+     */
+    destroy() {
+        this.memoryProtection.destroy();
+    }
+    /**
+     * Create initial retry state
+     */
+    createInitialState(id, options) {
+        return {
+            id,
+            attempt: 0,
+            lastAttempt: new Date(),
+            nextRetry: new Date(),
+            delay: options.initialDelayMs,
+            maxRetries: options.maxRetries,
+            status: 'pending',
+            metadata: {}
+        };
+    }
+    /**
+     * Calculate delay for next retry
+     */
+    calculateDelay(attempt, options) {
+        let delay = options.initialDelayMs * Math.pow(options.backoffFactor || 2, attempt - 1);
+        if (options.maxDelayMs) {
+            delay = Math.min(delay, options.maxDelayMs);
+        }
+        if (options.jitter) {
+            const jitterAmount = Math.random() * delay * 0.5;
+            delay = delay - delay * 0.25 + jitterAmount;
+        }
+        return delay;
+    }
+    /**
+     * Update metrics
+     */
+    updateMetrics(success, duration) {
+        this.metrics.totalRetries++;
+        if (success) {
+            this.metrics.successfulRetries++;
+        }
+        else {
+            this.metrics.failedRetries++;
+        }
+        // Update average retry time
+        const totalTime = this.metrics.averageRetryTime * (this.metrics.totalRetries - 1) + duration;
+        this.metrics.averageRetryTime = totalTime / this.metrics.totalRetries;
+        // Update memory usage
+        this.metrics.memoryUsage = this.memoryProtection.getStats().currentUsage;
+    }
+    /**
+     * Sleep utility
+     */
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+}
+exports.RetryManager = RetryManager;
+/**
+ * Factory function to create a retry manager with default configuration
+ */
+function createRetryManager(config) {
+    return new RetryManager(config);
+}
+//# sourceMappingURL=retry-manager.js.map

package/dist/retry-manager.js.map

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

package/dist/storage.d.ts

@@ -0,0 +1,38 @@
+import { StorageAdapter, RetryState } from './types';
+/**
+ * In-memory storage adapter with LRU eviction
+ */
+export declare class MemoryStorageAdapter implements StorageAdapter {
+    private storage;
+    private maxSize;
+    private accessOrder;
+    constructor(maxSize?: number);
+    get(id: string): Promise<RetryState | null>;
+    set(id: string, state: RetryState): Promise<void>;
+    delete(id: string): Promise<void>;
+    list(prefix?: string): Promise<RetryState[]>;
+    clear(): Promise<void>;
+    private updateAccessOrder;
+    private evictOldest;
+}
+/**
+ * Redis storage adapter with fallback to memory
+ */
+export declare class RedisStorageAdapter implements StorageAdapter {
+    private redis;
+    private memoryFallback;
+    private useFallback;
+    private prefix;
+    constructor(redisClient?: any, prefix?: string);
+    private getKey;
+    get(id: string): Promise<RetryState | null>;
+    set(id: string, state: RetryState): Promise<void>;
+    delete(id: string): Promise<void>;
+    list(prefix?: string): Promise<RetryState[]>;
+    clear(): Promise<void>;
+}
+/**
+ * Factory function to create appropriate storage adapter based on environment
+ */
+export declare function createStorageAdapter(): StorageAdapter;
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErD;;GAEG;AACH,qBAAa,oBAAqB,YAAW,cAAc;IACzD,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAgB;gBAEvB,OAAO,GAAE,MAAa;IAI5B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAS3C,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IASjD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAU5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,WAAW;CAMpB;AAED;;GAEG;AACH,qBAAa,mBAAoB,YAAW,cAAc;IACxD,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,MAAM,CAAS;gBAEX,WAAW,CAAC,EAAE,GAAG,EAAE,MAAM,GAAE,MAAiB;IAMxD,OAAO,CAAC,MAAM;IAIR,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAqB3C,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAejD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAcjC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IA2B5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAgB7B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAmBrD"}

package/dist/storage.js

@@ -0,0 +1,197 @@
+"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.RedisStorageAdapter = exports.MemoryStorageAdapter = void 0;
+exports.createStorageAdapter = createStorageAdapter;
+/**
+ * In-memory storage adapter with LRU eviction
+ */
+class MemoryStorageAdapter {
+    constructor(maxSize = 1000) {
+        this.storage = new Map();
+        this.accessOrder = [];
+        this.maxSize = maxSize;
+    }
+    async get(id) {
+        const state = this.storage.get(id);
+        if (state) {
+            // Update access order for LRU
+            this.updateAccessOrder(id);
+        }
+        return state || null;
+    }
+    async set(id, state) {
+        if (this.storage.size >= this.maxSize) {
+            this.evictOldest();
+        }
+        this.storage.set(id, state);
+        this.updateAccessOrder(id);
+    }
+    async delete(id) {
+        this.storage.delete(id);
+        const index = this.accessOrder.indexOf(id);
+        if (index > -1) {
+            this.accessOrder.splice(index, 1);
+        }
+    }
+    async list(prefix) {
+        const states = [];
+        for (const [id, state] of this.storage.entries()) {
+            if (!prefix || id.startsWith(prefix)) {
+                states.push(state);
+            }
+        }
+        return states;
+    }
+    async clear() {
+        this.storage.clear();
+        this.accessOrder = [];
+    }
+    updateAccessOrder(id) {
+        const index = this.accessOrder.indexOf(id);
+        if (index > -1) {
+            this.accessOrder.splice(index, 1);
+        }
+        this.accessOrder.push(id);
+    }
+    evictOldest() {
+        if (this.accessOrder.length > 0) {
+            const oldestId = this.accessOrder.shift();
+            this.storage.delete(oldestId);
+        }
+    }
+}
+exports.MemoryStorageAdapter = MemoryStorageAdapter;
+/**
+ * Redis storage adapter with fallback to memory
+ */
+class RedisStorageAdapter {
+    constructor(redisClient, prefix = 'retry:') {
+        this.useFallback = false;
+        this.redis = redisClient;
+        this.memoryFallback = new MemoryStorageAdapter();
+        this.prefix = prefix;
+    }
+    getKey(id) {
+        return `${this.prefix}${id}`;
+    }
+    async get(id) {
+        if (this.useFallback || !this.redis) {
+            return this.memoryFallback.get(id);
+        }
+        try {
+            const data = await this.redis.get(this.getKey(id));
+            if (!data)
+                return null;
+            const state = JSON.parse(data);
+            // Convert date strings back to Date objects
+            state.lastAttempt = new Date(state.lastAttempt);
+            state.nextRetry = new Date(state.nextRetry);
+            return state;
+        }
+        catch (error) {
+            console.warn('Redis get failed, falling back to memory:', error);
+            this.useFallback = true;
+            return this.memoryFallback.get(id);
+        }
+    }
+    async set(id, state) {
+        if (this.useFallback || !this.redis) {
+            return this.memoryFallback.set(id, state);
+        }
+        try {
+            const serialized = JSON.stringify(state);
+            await this.redis.set(this.getKey(id), serialized, 'EX', 3600); // 1 hour TTL
+        }
+        catch (error) {
+            console.warn('Redis set failed, falling back to memory:', error);
+            this.useFallback = true;
+            return this.memoryFallback.set(id, state);
+        }
+    }
+    async delete(id) {
+        if (this.useFallback || !this.redis) {
+            return this.memoryFallback.delete(id);
+        }
+        try {
+            await this.redis.del(this.getKey(id));
+        }
+        catch (error) {
+            console.warn('Redis delete failed, falling back to memory:', error);
+            this.useFallback = true;
+            return this.memoryFallback.delete(id);
+        }
+    }
+    async list(prefix) {
+        if (this.useFallback || !this.redis) {
+            return this.memoryFallback.list(prefix);
+        }
+        try {
+            const pattern = prefix ? `${this.prefix}${prefix}*` : `${this.prefix}*`;
+            const keys = await this.redis.keys(pattern);
+            const states = [];
+            for (const key of keys) {
+                const data = await this.redis.get(key);
+                if (data) {
+                    const state = JSON.parse(data);
+                    state.lastAttempt = new Date(state.lastAttempt);
+                    state.nextRetry = new Date(state.nextRetry);
+                    states.push(state);
+                }
+            }
+            return states;
+        }
+        catch (error) {
+            console.warn('Redis list failed, falling back to memory:', error);
+            this.useFallback = true;
+            return this.memoryFallback.list(prefix);
+        }
+    }
+    async clear() {
+        if (this.useFallback || !this.redis) {
+            return this.memoryFallback.clear();
+        }
+        try {
+            const keys = await this.redis.keys(`${this.prefix}*`);
+            if (keys.length > 0) {
+                await this.redis.del(...keys);
+            }
+        }
+        catch (error) {
+            console.warn('Redis clear failed, falling back to memory:', error);
+            this.useFallback = true;
+            return this.memoryFallback.clear();
+        }
+    }
+}
+exports.RedisStorageAdapter = RedisStorageAdapter;
+/**
+ * Factory function to create appropriate storage adapter based on environment
+ */
+function createStorageAdapter() {
+    const storageType = process.env.RETRY_STORAGE_TYPE || 'memory';
+    switch (storageType.toLowerCase()) {
+        case 'redis':
+            try {
+                const redis = require('redis');
+                const client = redis.createClient({
+                    url: process.env.REDIS_URL || 'redis://localhost:6379'
+                });
+                return new RedisStorageAdapter(client);
+            }
+            catch (error) {
+                console.warn('Redis not available, falling back to memory storage');
+                return new MemoryStorageAdapter();
+            }
+        case 'memory':
+        default:
+            return new MemoryStorageAdapter();
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,54 @@
+export interface RetryOptions {
+    maxRetries: number;
+    initialDelayMs: number;
+    maxDelayMs?: number;
+    backoffFactor?: number;
+    jitter?: boolean;
+    shouldRetry?: (err: any) => boolean;
+    onRetry?: (attempt: number, delay: number, err: any) => void;
+    onFailure?: (err: any) => void;
+}
+export interface RetryState {
+    id: string;
+    attempt: number;
+    lastAttempt: Date;
+    nextRetry: Date;
+    delay: number;
+    maxRetries: number;
+    status: 'pending' | 'retrying' | 'completed' | 'failed';
+    error?: any;
+    metadata?: Record<string, any>;
+}
+export interface StorageAdapter {
+    get(id: string): Promise<RetryState | null>;
+    set(id: string, state: RetryState): Promise<void>;
+    delete(id: string): Promise<void>;
+    list(prefix?: string): Promise<RetryState[]>;
+    clear(): Promise<void>;
+}
+export interface MemoryProtectionConfig {
+    maxMemoryUsage: number;
+    maxRetryStates: number;
+    cleanupInterval: number;
+    evictionPolicy: 'lru' | 'fifo' | 'random';
+}
+export interface RetryManagerConfig {
+    storage: StorageAdapter;
+    memoryProtection?: MemoryProtectionConfig;
+    defaultOptions?: Partial<RetryOptions>;
+}
+export interface RetryResult<T> {
+    success: boolean;
+    data?: T;
+    error?: any;
+    attempts: number;
+    totalTime: number;
+}
+export interface RetryMetrics {
+    totalRetries: number;
+    successfulRetries: number;
+    failedRetries: number;
+    averageRetryTime: number;
+    memoryUsage: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC;IACpC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC;IAC7D,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,IAAI,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAC;IACxD,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAC5C,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC7C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;CAC3C;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,cAAc,CAAC;IACxB,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAC1C,cAAc,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/types.js

@@ -0,0 +1,10 @@
+"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 });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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