@claude-flow/shared 3.0.0-alpha.1

package/dist/resilience/rate-limiter.d.ts

@@ -0,0 +1,168 @@
+/**
+ * Rate Limiter
+ *
+ * Production-ready rate limiting implementations.
+ *
+ * @module v3/shared/resilience/rate-limiter
+ */
+/**
+ * Rate limiter options
+ */
+export interface RateLimiterOptions {
+    /** Maximum requests allowed in the window */
+    maxRequests: number;
+    /** Time window in milliseconds */
+    windowMs: number;
+    /** Enable sliding window (vs fixed window) */
+    slidingWindow?: boolean;
+    /** Key generator for per-key limiting */
+    keyGenerator?: (context: unknown) => string;
+    /** Skip limiter for certain requests */
+    skip?: (context: unknown) => boolean;
+    /** Handler when rate limit is exceeded */
+    onRateLimited?: (key: string, remaining: number, resetAt: Date) => void;
+}
+/**
+ * Rate limit result
+ */
+export interface RateLimitResult {
+    allowed: boolean;
+    remaining: number;
+    resetAt: Date;
+    retryAfter: number;
+    total: number;
+    used: number;
+}
+/**
+ * Base Rate Limiter interface
+ */
+export interface RateLimiter {
+    /** Check if request is allowed */
+    check(key?: string): RateLimitResult;
+    /** Consume a request token */
+    consume(key?: string): RateLimitResult;
+    /** Reset a specific key or all keys */
+    reset(key?: string): void;
+    /** Get current status */
+    status(key?: string): RateLimitResult;
+}
+/**
+ * Sliding Window Rate Limiter
+ *
+ * Uses sliding window algorithm for smooth rate limiting.
+ *
+ * @example
+ * const limiter = new SlidingWindowRateLimiter({
+ *   maxRequests: 100,
+ *   windowMs: 60000, // 100 requests per minute
+ * });
+ *
+ * const result = limiter.consume('user-123');
+ * if (!result.allowed) {
+ *   throw new Error(`Rate limited. Retry in ${result.retryAfter}ms`);
+ * }
+ */
+export declare class SlidingWindowRateLimiter implements RateLimiter {
+    private readonly options;
+    private readonly requests;
+    private cleanupInterval?;
+    constructor(options: RateLimiterOptions);
+    /**
+     * Check if a request would be allowed without consuming
+     */
+    check(key?: string): RateLimitResult;
+    /**
+     * Consume a request token
+     */
+    consume(key?: string): RateLimitResult;
+    /**
+     * Reset rate limit for a key
+     */
+    reset(key?: string): void;
+    /**
+     * Get current status
+     */
+    status(key?: string): RateLimitResult;
+    /**
+     * Cleanup resources
+     */
+    destroy(): void;
+    /**
+     * Clean old entries for a specific key
+     */
+    private cleanupKey;
+    /**
+     * Clean all old entries
+     */
+    private cleanup;
+    /**
+     * Get reset time based on oldest entry
+     */
+    private getResetTime;
+    /**
+     * Get retry after time in ms
+     */
+    private getRetryAfter;
+}
+/**
+ * Token Bucket Rate Limiter
+ *
+ * Uses token bucket algorithm for burst-friendly rate limiting.
+ *
+ * @example
+ * const limiter = new TokenBucketRateLimiter({
+ *   maxRequests: 10, // bucket size
+ *   windowMs: 1000,  // refill interval
+ * });
+ */
+export declare class TokenBucketRateLimiter implements RateLimiter {
+    private readonly options;
+    private readonly buckets;
+    private cleanupInterval?;
+    constructor(options: RateLimiterOptions);
+    /**
+     * Check if a request would be allowed
+     */
+    check(key?: string): RateLimitResult;
+    /**
+     * Consume a token
+     */
+    consume(key?: string): RateLimitResult;
+    /**
+     * Reset bucket for a key
+     */
+    reset(key?: string): void;
+    /**
+     * Get current status
+     */
+    status(key?: string): RateLimitResult;
+    /**
+     * Cleanup resources
+     */
+    destroy(): void;
+    /**
+     * Get or create bucket for key
+     */
+    private getBucket;
+    /**
+     * Refill tokens based on elapsed time
+     */
+    private refill;
+    /**
+     * Clean inactive buckets
+     */
+    private cleanup;
+}
+/**
+ * Rate limiter middleware for Express-like frameworks
+ */
+export declare function createRateLimiterMiddleware(limiter: RateLimiter): (req: {
+    ip?: string;
+    headers?: Record<string, string>;
+}, res: {
+    status: (code: number) => {
+        json: (body: unknown) => void;
+    };
+    setHeader: (name: string, value: string) => void;
+}, next: () => void) => void;
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/resilience/rate-limiter.d.ts.map

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

package/dist/resilience/rate-limiter.js

@@ -0,0 +1,314 @@
+/**
+ * Rate Limiter
+ *
+ * Production-ready rate limiting implementations.
+ *
+ * @module v3/shared/resilience/rate-limiter
+ */
+/**
+ * Sliding Window Rate Limiter
+ *
+ * Uses sliding window algorithm for smooth rate limiting.
+ *
+ * @example
+ * const limiter = new SlidingWindowRateLimiter({
+ *   maxRequests: 100,
+ *   windowMs: 60000, // 100 requests per minute
+ * });
+ *
+ * const result = limiter.consume('user-123');
+ * if (!result.allowed) {
+ *   throw new Error(`Rate limited. Retry in ${result.retryAfter}ms`);
+ * }
+ */
+export class SlidingWindowRateLimiter {
+    options;
+    requests = new Map();
+    cleanupInterval;
+    constructor(options) {
+        this.options = {
+            slidingWindow: true,
+            ...options,
+        };
+        // Periodic cleanup of old entries
+        this.cleanupInterval = setInterval(() => {
+            this.cleanup();
+        }, this.options.windowMs);
+    }
+    /**
+     * Check if a request would be allowed without consuming
+     */
+    check(key = 'default') {
+        this.cleanupKey(key);
+        const entries = this.requests.get(key) || [];
+        return {
+            allowed: entries.length < this.options.maxRequests,
+            remaining: Math.max(0, this.options.maxRequests - entries.length),
+            resetAt: this.getResetTime(entries),
+            retryAfter: this.getRetryAfter(entries),
+            total: this.options.maxRequests,
+            used: entries.length,
+        };
+    }
+    /**
+     * Consume a request token
+     */
+    consume(key = 'default') {
+        // Clean old entries first
+        this.cleanupKey(key);
+        let entries = this.requests.get(key);
+        if (!entries) {
+            entries = [];
+            this.requests.set(key, entries);
+        }
+        // Check if allowed
+        if (entries.length >= this.options.maxRequests) {
+            const result = {
+                allowed: false,
+                remaining: 0,
+                resetAt: this.getResetTime(entries),
+                retryAfter: this.getRetryAfter(entries),
+                total: this.options.maxRequests,
+                used: entries.length,
+            };
+            this.options.onRateLimited?.(key, 0, result.resetAt);
+            return result;
+        }
+        // Add new entry
+        entries.push({ timestamp: Date.now(), key });
+        return {
+            allowed: true,
+            remaining: this.options.maxRequests - entries.length,
+            resetAt: this.getResetTime(entries),
+            retryAfter: 0,
+            total: this.options.maxRequests,
+            used: entries.length,
+        };
+    }
+    /**
+     * Reset rate limit for a key
+     */
+    reset(key) {
+        if (key) {
+            this.requests.delete(key);
+        }
+        else {
+            this.requests.clear();
+        }
+    }
+    /**
+     * Get current status
+     */
+    status(key = 'default') {
+        return this.check(key);
+    }
+    /**
+     * Cleanup resources
+     */
+    destroy() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = undefined;
+        }
+        this.requests.clear();
+    }
+    /**
+     * Clean old entries for a specific key
+     */
+    cleanupKey(key) {
+        const entries = this.requests.get(key);
+        if (!entries)
+            return;
+        const cutoff = Date.now() - this.options.windowMs;
+        const filtered = entries.filter((e) => e.timestamp >= cutoff);
+        if (filtered.length === 0) {
+            this.requests.delete(key);
+        }
+        else if (filtered.length !== entries.length) {
+            this.requests.set(key, filtered);
+        }
+    }
+    /**
+     * Clean all old entries
+     */
+    cleanup() {
+        for (const key of this.requests.keys()) {
+            this.cleanupKey(key);
+        }
+    }
+    /**
+     * Get reset time based on oldest entry
+     */
+    getResetTime(entries) {
+        if (entries.length === 0) {
+            return new Date(Date.now() + this.options.windowMs);
+        }
+        const oldest = entries[0];
+        return new Date(oldest.timestamp + this.options.windowMs);
+    }
+    /**
+     * Get retry after time in ms
+     */
+    getRetryAfter(entries) {
+        if (entries.length < this.options.maxRequests) {
+            return 0;
+        }
+        const oldest = entries[0];
+        const resetAt = oldest.timestamp + this.options.windowMs;
+        return Math.max(0, resetAt - Date.now());
+    }
+}
+/**
+ * Token Bucket Rate Limiter
+ *
+ * Uses token bucket algorithm for burst-friendly rate limiting.
+ *
+ * @example
+ * const limiter = new TokenBucketRateLimiter({
+ *   maxRequests: 10, // bucket size
+ *   windowMs: 1000,  // refill interval
+ * });
+ */
+export class TokenBucketRateLimiter {
+    options;
+    buckets = new Map();
+    cleanupInterval;
+    constructor(options) {
+        this.options = options;
+        // Periodic cleanup
+        this.cleanupInterval = setInterval(() => {
+            this.cleanup();
+        }, this.options.windowMs * 10);
+    }
+    /**
+     * Check if a request would be allowed
+     */
+    check(key = 'default') {
+        this.refill(key);
+        const bucket = this.getBucket(key);
+        return {
+            allowed: bucket.tokens >= 1,
+            remaining: Math.floor(bucket.tokens),
+            resetAt: new Date(bucket.lastRefill + this.options.windowMs),
+            retryAfter: bucket.tokens >= 1 ? 0 : this.options.windowMs,
+            total: this.options.maxRequests,
+            used: this.options.maxRequests - Math.floor(bucket.tokens),
+        };
+    }
+    /**
+     * Consume a token
+     */
+    consume(key = 'default') {
+        this.refill(key);
+        const bucket = this.getBucket(key);
+        if (bucket.tokens < 1) {
+            const result = {
+                allowed: false,
+                remaining: 0,
+                resetAt: new Date(bucket.lastRefill + this.options.windowMs),
+                retryAfter: this.options.windowMs,
+                total: this.options.maxRequests,
+                used: this.options.maxRequests,
+            };
+            this.options.onRateLimited?.(key, 0, result.resetAt);
+            return result;
+        }
+        bucket.tokens -= 1;
+        return {
+            allowed: true,
+            remaining: Math.floor(bucket.tokens),
+            resetAt: new Date(bucket.lastRefill + this.options.windowMs),
+            retryAfter: 0,
+            total: this.options.maxRequests,
+            used: this.options.maxRequests - Math.floor(bucket.tokens),
+        };
+    }
+    /**
+     * Reset bucket for a key
+     */
+    reset(key) {
+        if (key) {
+            this.buckets.delete(key);
+        }
+        else {
+            this.buckets.clear();
+        }
+    }
+    /**
+     * Get current status
+     */
+    status(key = 'default') {
+        return this.check(key);
+    }
+    /**
+     * Cleanup resources
+     */
+    destroy() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = undefined;
+        }
+        this.buckets.clear();
+    }
+    /**
+     * Get or create bucket for key
+     */
+    getBucket(key) {
+        let bucket = this.buckets.get(key);
+        if (!bucket) {
+            bucket = { tokens: this.options.maxRequests, lastRefill: Date.now() };
+            this.buckets.set(key, bucket);
+        }
+        return bucket;
+    }
+    /**
+     * Refill tokens based on elapsed time
+     */
+    refill(key) {
+        const bucket = this.getBucket(key);
+        const now = Date.now();
+        const elapsed = now - bucket.lastRefill;
+        if (elapsed >= this.options.windowMs) {
+            // Full refill after window
+            const intervals = Math.floor(elapsed / this.options.windowMs);
+            bucket.tokens = Math.min(this.options.maxRequests, bucket.tokens + intervals * this.options.maxRequests);
+            bucket.lastRefill = now;
+        }
+    }
+    /**
+     * Clean inactive buckets
+     */
+    cleanup() {
+        const cutoff = Date.now() - this.options.windowMs * 10;
+        for (const [key, bucket] of this.buckets) {
+            if (bucket.lastRefill < cutoff && bucket.tokens >= this.options.maxRequests) {
+                this.buckets.delete(key);
+            }
+        }
+    }
+}
+/**
+ * Rate limiter middleware for Express-like frameworks
+ */
+export function createRateLimiterMiddleware(limiter) {
+    return (req, res, next) => {
+        // Get key from IP or header
+        const key = req.ip || req.headers?.['x-forwarded-for'] || 'anonymous';
+        const result = limiter.consume(key);
+        // Set rate limit headers
+        res.setHeader('X-RateLimit-Limit', String(result.total));
+        res.setHeader('X-RateLimit-Remaining', String(result.remaining));
+        res.setHeader('X-RateLimit-Reset', String(Math.ceil(result.resetAt.getTime() / 1000)));
+        if (!result.allowed) {
+            res.setHeader('Retry-After', String(Math.ceil(result.retryAfter / 1000)));
+            res.status(429).json({
+                error: 'Too Many Requests',
+                retryAfter: result.retryAfter,
+                resetAt: result.resetAt.toISOString(),
+            });
+            return;
+        }
+        next();
+    };
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/resilience/rate-limiter.js.map

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

package/dist/resilience/retry.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Retry with Exponential Backoff
+ *
+ * Production-ready retry logic with jitter, max retries, and error filtering.
+ *
+ * @module v3/shared/resilience/retry
+ */
+/**
+ * Retry options
+ */
+export interface RetryOptions {
+    /** Maximum number of retry attempts (default: 3) */
+    maxAttempts: number;
+    /** Initial delay in milliseconds (default: 100) */
+    initialDelay: number;
+    /** Maximum delay in milliseconds (default: 10000) */
+    maxDelay: number;
+    /** Backoff multiplier (default: 2) */
+    backoffMultiplier: number;
+    /** Jitter factor 0-1 to randomize delays (default: 0.1) */
+    jitter: number;
+    /** Timeout for each attempt in milliseconds (default: 30000) */
+    timeout: number;
+    /** Errors that should trigger a retry (default: all errors) */
+    retryableErrors?: (error: Error) => boolean;
+    /** Callback for each retry attempt */
+    onRetry?: (error: Error, attempt: number, delay: number) => void;
+}
+/**
+ * Retry result
+ */
+export interface RetryResult<T> {
+    success: boolean;
+    result?: T;
+    attempts: number;
+    totalTime: number;
+    errors: Error[];
+}
+/**
+ * Retry error with attempt history
+ */
+export declare class RetryError extends Error {
+    readonly attempts: number;
+    readonly errors: Error[];
+    readonly totalTime: number;
+    constructor(message: string, attempts: number, errors: Error[], totalTime: number);
+}
+/**
+ * Retry a function with exponential backoff
+ *
+ * @param fn Function to retry
+ * @param options Retry configuration
+ * @returns Result with success/failure and metadata
+ *
+ * @example
+ * const result = await retry(
+ *   () => fetchData(),
+ *   { maxAttempts: 5, initialDelay: 200 }
+ * );
+ *
+ * if (result.success) {
+ *   console.log('Data:', result.result);
+ * } else {
+ *   console.log('Failed after', result.attempts, 'attempts');
+ * }
+ */
+export declare function retry<T>(fn: () => Promise<T>, options?: Partial<RetryOptions>): Promise<RetryResult<T>>;
+/**
+ * Wrap a function with retry behavior
+ *
+ * @param fn Function to wrap
+ * @param options Retry configuration
+ * @returns Wrapped function that retries on failure
+ */
+export declare function withRetry<T extends (...args: unknown[]) => Promise<unknown>>(fn: T, options?: Partial<RetryOptions>): (...args: Parameters<T>) => Promise<RetryResult<Awaited<ReturnType<T>>>>;
+/**
+ * Common retryable error predicates
+ */
+export declare const RetryableErrors: {
+    /** Network errors (ECONNRESET, ETIMEDOUT, etc.) */
+    network: (error: Error) => boolean;
+    /** Rate limit errors (429) */
+    rateLimit: (error: Error) => boolean;
+    /** Server errors (5xx) */
+    serverError: (error: Error) => boolean;
+    /** Transient errors (network + rate limit + 5xx) */
+    transient: (error: Error) => boolean;
+    /** All errors are retryable */
+    all: () => boolean;
+};
+//# sourceMappingURL=retry.d.ts.map

package/dist/resilience/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/resilience/retry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IAEpB,mDAAmD;IACnD,YAAY,EAAE,MAAM,CAAC;IAErB,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IAEjB,sCAAsC;IACtC,iBAAiB,EAAE,MAAM,CAAC;IAE1B,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IAEf,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAEhB,+DAA+D;IAC/D,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;IAE5C,sCAAsC;IACtC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAClE;AAED;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,CAAC,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;aAGjB,QAAQ,EAAE,MAAM;aAChB,MAAM,EAAE,KAAK,EAAE;aACf,SAAS,EAAE,MAAM;gBAHjC,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,KAAK,EAAE,EACf,SAAS,EAAE,MAAM;CAKpC;AAcD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAC3B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,OAAO,CAAC,YAAY,CAAM,GAClC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAyDzB;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,EAC1E,EAAE,EAAE,CAAC,EACL,OAAO,GAAE,OAAO,CAAC,YAAY,CAAM,GAClC,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAI1E;AAsBD;;GAEG;AACH,eAAO,MAAM,eAAe;IAC1B,mDAAmD;qBAClC,KAAK,KAAG,OAAO;IAKhC,8BAA8B;uBACX,KAAK,KAAG,OAAO;IAIlC,0BAA0B;yBACL,KAAK,KAAG,OAAO;IAIpC,oDAAoD;uBACjC,KAAK,KAAG,OAAO;IAQlC,+BAA+B;eACtB,OAAO;CACjB,CAAC"}