@marktoflow/integrations 2.0.2 → 2.0.4-alpha.1

package/dist/reliability/circuit-breaker.js

@@ -0,0 +1,164 @@
+/**
+ * Circuit Breaker for integration reliability.
+ *
+ * Prevents cascading failures by tracking error rates per service
+ * and short-circuiting requests when a service is unhealthy.
+ *
+ * States:
+ * - CLOSED: Normal operation, requests pass through
+ * - OPEN: Service is failing, requests are rejected immediately
+ * - HALF_OPEN: Testing if service has recovered (limited requests allowed)
+ */
+import { IntegrationRequestError } from './errors.js';
+const DEFAULT_OPTIONS = {
+    failureThreshold: 5,
+    resetTimeout: 30_000,
+    successThreshold: 2,
+    failureWindow: 60_000,
+};
+export class CircuitBreakerRegistry {
+    circuits = new Map();
+    options;
+    onStateChange;
+    constructor(options = {}) {
+        this.options = {
+            failureThreshold: options.failureThreshold ?? DEFAULT_OPTIONS.failureThreshold,
+            resetTimeout: options.resetTimeout ?? DEFAULT_OPTIONS.resetTimeout,
+            successThreshold: options.successThreshold ?? DEFAULT_OPTIONS.successThreshold,
+            failureWindow: options.failureWindow ?? DEFAULT_OPTIONS.failureWindow,
+        };
+        this.onStateChange = options.onStateChange;
+    }
+    /**
+     * Check if a request to the given service should be allowed.
+     * Throws immediately if circuit is open.
+     */
+    allowRequest(service) {
+        const circuit = this.getCircuit(service);
+        const now = Date.now();
+        switch (circuit.state) {
+            case 'closed':
+                return; // Allow
+            case 'open': {
+                // Check if reset timeout has elapsed
+                if (now - circuit.openedAt >= this.options.resetTimeout) {
+                    this.transition(service, circuit, 'half_open');
+                    return; // Allow probe request
+                }
+                throw new IntegrationRequestError({
+                    service,
+                    action: 'circuit_breaker',
+                    message: `Circuit breaker is open for ${service} — too many recent failures. Retry after ${Math.ceil((circuit.openedAt + this.options.resetTimeout - now) / 1000)}s`,
+                    retryable: true,
+                    retryAfter: Math.ceil((circuit.openedAt + this.options.resetTimeout - now) / 1000),
+                });
+            }
+            case 'half_open':
+                return; // Allow probe request
+        }
+    }
+    /**
+     * Record a successful request.
+     */
+    recordSuccess(service) {
+        const circuit = this.getCircuit(service);
+        if (circuit.state === 'half_open') {
+            circuit.successes++;
+            if (circuit.successes >= this.options.successThreshold) {
+                this.transition(service, circuit, 'closed');
+            }
+        }
+    }
+    /**
+     * Record a failed request.
+     */
+    recordFailure(service) {
+        const circuit = this.getCircuit(service);
+        const now = Date.now();
+        if (circuit.state === 'half_open') {
+            // Any failure in half-open reopens the circuit
+            this.transition(service, circuit, 'open');
+            return;
+        }
+        // Add failure timestamp and prune old ones
+        circuit.failures.push(now);
+        circuit.failures = circuit.failures.filter((t) => now - t < this.options.failureWindow);
+        circuit.lastFailureAt = now;
+        if (circuit.failures.length >= this.options.failureThreshold) {
+            this.transition(service, circuit, 'open');
+        }
+    }
+    /**
+     * Get current state of a service's circuit.
+     */
+    getState(service) {
+        return this.getCircuit(service).state;
+    }
+    /**
+     * Get stats for all circuits.
+     */
+    getStats() {
+        const stats = {};
+        const now = Date.now();
+        for (const [service, circuit] of this.circuits) {
+            const recentFailures = circuit.failures.filter((t) => now - t < this.options.failureWindow).length;
+            stats[service] = { state: circuit.state, recentFailures };
+        }
+        return stats;
+    }
+    /**
+     * Reset a specific service's circuit to closed.
+     */
+    reset(service) {
+        this.circuits.delete(service);
+    }
+    /**
+     * Reset all circuits.
+     */
+    resetAll() {
+        this.circuits.clear();
+    }
+    getCircuit(service) {
+        let circuit = this.circuits.get(service);
+        if (!circuit) {
+            circuit = {
+                state: 'closed',
+                failures: [],
+                successes: 0,
+                lastFailureAt: 0,
+                openedAt: 0,
+            };
+            this.circuits.set(service, circuit);
+        }
+        return circuit;
+    }
+    transition(service, circuit, to) {
+        const from = circuit.state;
+        circuit.state = to;
+        if (to === 'open') {
+            circuit.openedAt = Date.now();
+            circuit.successes = 0;
+        }
+        else if (to === 'closed') {
+            circuit.failures = [];
+            circuit.successes = 0;
+        }
+        else if (to === 'half_open') {
+            circuit.successes = 0;
+        }
+        this.onStateChange?.(service, from, to);
+    }
+}
+/** Global circuit breaker registry shared across all integrations */
+let _globalRegistry;
+export function getCircuitBreakerRegistry(options) {
+    if (!_globalRegistry) {
+        _globalRegistry = new CircuitBreakerRegistry(options);
+    }
+    return _globalRegistry;
+}
+export function resetCircuitBreakerRegistry() {
+    _globalRegistry?.resetAll();
+    _globalRegistry = undefined;
+}
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/reliability/circuit-breaker.js.map

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

package/dist/reliability/index.d.ts

@@ -4,7 +4,9 @@
  * Provides input validation, retry, timeout, rate limiting,
  * and error normalization for all integrations.
  */
-export { wrapIntegration, type WrapperOptions, type ActionCallOptions, } from './wrapper.js';
+export { wrapIntegration, createTimeoutSignal, type WrapperOptions, type ActionCallOptions, } from './wrapper.js';
 export { IntegrationRequestError, normalizeError, type IntegrationError, } from './errors.js';
+export { CircuitBreakerRegistry, getCircuitBreakerRegistry, resetCircuitBreakerRegistry, type CircuitState, type CircuitBreakerOptions, } from './circuit-breaker.js';
+export { RateLimiterRegistry, getRateLimiterRegistry, resetRateLimiterRegistry, KNOWN_RATE_LIMITS, type RateLimitConfig, } from './rate-limiter.js';
 export { slackSchemas, githubSchemas, gmailSchemas, notionSchemas, jiraSchemas, discordSchemas, linearSchemas, } from './schemas/index.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/reliability/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,WAAW,EACX,cAAc,EACd,aAAa,GACd,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/reliability/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,2BAA2B,EAC3B,KAAK,YAAY,EACjB,KAAK,qBAAqB,GAC3B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,EACxB,iBAAiB,EACjB,KAAK,eAAe,GACrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,WAAW,EACX,cAAc,EACd,aAAa,GACd,MAAM,oBAAoB,CAAC"}

package/dist/reliability/index.js

@@ -4,7 +4,9 @@
  * Provides input validation, retry, timeout, rate limiting,
  * and error normalization for all integrations.
  */
-export { wrapIntegration, } from './wrapper.js';
+export { wrapIntegration, createTimeoutSignal, } from './wrapper.js';
 export { IntegrationRequestError, normalizeError, } from './errors.js';
+export { CircuitBreakerRegistry, getCircuitBreakerRegistry, resetCircuitBreakerRegistry, } from './circuit-breaker.js';
+export { RateLimiterRegistry, getRateLimiterRegistry, resetRateLimiterRegistry, KNOWN_RATE_LIMITS, } from './rate-limiter.js';
 export { slackSchemas, githubSchemas, gmailSchemas, notionSchemas, jiraSchemas, discordSchemas, linearSchemas, } from './schemas/index.js';
 //# sourceMappingURL=index.js.map

package/dist/reliability/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/reliability/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,eAAe,GAGhB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,uBAAuB,EACvB,cAAc,GAEf,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,WAAW,EACX,cAAc,EACd,aAAa,GACd,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/reliability/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,eAAe,EACf,mBAAmB,GAGpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,uBAAuB,EACvB,cAAc,GAEf,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,2BAA2B,GAG5B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,EACxB,iBAAiB,GAElB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,WAAW,EACX,cAAc,EACd,aAAa,GACd,MAAM,oBAAoB,CAAC"}

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

@@ -0,0 +1,62 @@
+/**
+ * Proactive rate limiter for integration reliability.
+ *
+ * Prevents 429 errors by tracking request rates per service
+ * and queuing/delaying requests that would exceed known limits.
+ *
+ * Uses a token bucket algorithm with configurable refill rates.
+ */
+export interface RateLimitConfig {
+    /** Maximum requests per window */
+    maxRequests: number;
+    /** Window duration in ms */
+    windowMs: number;
+    /** Strategy when limit is reached: 'queue' waits, 'reject' throws (default: 'queue') */
+    strategy?: 'queue' | 'reject';
+    /** Maximum queue size before rejecting (default: 100) */
+    maxQueueSize?: number;
+}
+/** Well-known rate limits for popular services */
+export declare const KNOWN_RATE_LIMITS: Record<string, RateLimitConfig>;
+export declare class RateLimiterRegistry {
+    private buckets;
+    private configs;
+    private timers;
+    constructor(overrides?: Record<string, RateLimitConfig>);
+    /**
+     * Configure rate limit for a specific service.
+     */
+    configure(service: string, config: RateLimitConfig): void;
+    /**
+     * Acquire a token for the given service.
+     * Resolves immediately if tokens available, queues or rejects otherwise.
+     */
+    acquire(service: string): Promise<void>;
+    /**
+     * Release a token (optional — for manual flow control).
+     */
+    release(service: string): void;
+    /**
+     * Get current rate limit status for a service.
+     */
+    getStatus(service: string): {
+        available: number;
+        max: number;
+        queued: number;
+        refillRate: number;
+    } | null;
+    /**
+     * Update limits based on response headers (Retry-After, X-RateLimit-*).
+     */
+    updateFromHeaders(service: string, headers: Record<string, string>): void;
+    /**
+     * Clean up timers.
+     */
+    destroy(): void;
+    private refill;
+    private drainQueue;
+    private ensureDrainTimer;
+}
+export declare function getRateLimiterRegistry(overrides?: Record<string, RateLimitConfig>): RateLimiterRegistry;
+export declare function resetRateLimiterRegistry(): void;
+//# sourceMappingURL=rate-limiter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/reliability/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,wFAAwF;IACxF,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC9B,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,kDAAkD;AAClD,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAW7D,CAAC;AAUF,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,OAAO,CAAgD;IAC/D,OAAO,CAAC,MAAM,CAAqD;gBAEvD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC;IAYvD;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI;IAmBzD;;;OAGG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuC7C;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAO9B;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG;QAC1B,SAAS,EAAE,MAAM,CAAC;QAClB,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,IAAI;IAYR;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAazE;;OAEG;IACH,OAAO,IAAI,IAAI;IAef,OAAO,CAAC,MAAM;IAQd,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,gBAAgB;CAiBzB;AAKD,wBAAgB,sBAAsB,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,mBAAmB,CAKvG;AAED,wBAAgB,wBAAwB,IAAI,IAAI,CAG/C"}

package/dist/reliability/rate-limiter.js

@@ -0,0 +1,194 @@
+/**
+ * Proactive rate limiter for integration reliability.
+ *
+ * Prevents 429 errors by tracking request rates per service
+ * and queuing/delaying requests that would exceed known limits.
+ *
+ * Uses a token bucket algorithm with configurable refill rates.
+ */
+import { IntegrationRequestError } from './errors.js';
+/** Well-known rate limits for popular services */
+export const KNOWN_RATE_LIMITS = {
+    slack: { maxRequests: 50, windowMs: 60_000 },
+    github: { maxRequests: 5000, windowMs: 3_600_000 },
+    gmail: { maxRequests: 250, windowMs: 1_000 },
+    discord: { maxRequests: 50, windowMs: 1_000 },
+    notion: { maxRequests: 3, windowMs: 1_000 },
+    linear: { maxRequests: 50, windowMs: 60_000 },
+    stripe: { maxRequests: 100, windowMs: 1_000 },
+    sendgrid: { maxRequests: 600, windowMs: 60_000 },
+    trello: { maxRequests: 100, windowMs: 10_000 },
+    shopify: { maxRequests: 40, windowMs: 1_000 },
+};
+export class RateLimiterRegistry {
+    buckets = new Map();
+    configs = new Map();
+    timers = new Map();
+    constructor(overrides) {
+        // Load known defaults, allow overrides
+        for (const [service, config] of Object.entries(KNOWN_RATE_LIMITS)) {
+            this.configure(service, config);
+        }
+        if (overrides) {
+            for (const [service, config] of Object.entries(overrides)) {
+                this.configure(service, config);
+            }
+        }
+    }
+    /**
+     * Configure rate limit for a specific service.
+     */
+    configure(service, config) {
+        const full = {
+            maxRequests: config.maxRequests,
+            windowMs: config.windowMs,
+            strategy: config.strategy ?? 'queue',
+            maxQueueSize: config.maxQueueSize ?? 100,
+        };
+        this.configs.set(service, full);
+        const refillRate = config.maxRequests / config.windowMs;
+        this.buckets.set(service, {
+            tokens: config.maxRequests,
+            maxTokens: config.maxRequests,
+            refillRate,
+            lastRefillAt: Date.now(),
+            queue: [],
+        });
+    }
+    /**
+     * Acquire a token for the given service.
+     * Resolves immediately if tokens available, queues or rejects otherwise.
+     */
+    async acquire(service) {
+        const bucket = this.buckets.get(service);
+        if (!bucket)
+            return; // No rate limit configured — allow
+        this.refill(bucket);
+        if (bucket.tokens >= 1) {
+            bucket.tokens -= 1;
+            return;
+        }
+        const config = this.configs.get(service);
+        if (config.strategy === 'reject') {
+            throw new IntegrationRequestError({
+                service,
+                action: 'rate_limiter',
+                message: `Rate limit reached for ${service} (${config.maxRequests} requests per ${config.windowMs}ms)`,
+                retryable: true,
+                retryAfter: Math.ceil((1 / bucket.refillRate) / 1000),
+            });
+        }
+        // Queue strategy — wait for a token
+        if (bucket.queue.length >= config.maxQueueSize) {
+            throw new IntegrationRequestError({
+                service,
+                action: 'rate_limiter',
+                message: `Rate limit queue full for ${service} (${config.maxQueueSize} pending requests)`,
+                retryable: true,
+            });
+        }
+        return new Promise((resolve, reject) => {
+            bucket.queue.push({ resolve, reject });
+            this.ensureDrainTimer(service, bucket);
+        });
+    }
+    /**
+     * Release a token (optional — for manual flow control).
+     */
+    release(service) {
+        const bucket = this.buckets.get(service);
+        if (!bucket)
+            return;
+        bucket.tokens = Math.min(bucket.tokens + 1, bucket.maxTokens);
+        this.drainQueue(bucket);
+    }
+    /**
+     * Get current rate limit status for a service.
+     */
+    getStatus(service) {
+        const bucket = this.buckets.get(service);
+        if (!bucket)
+            return null;
+        this.refill(bucket);
+        return {
+            available: Math.floor(bucket.tokens),
+            max: bucket.maxTokens,
+            queued: bucket.queue.length,
+            refillRate: bucket.refillRate * 1000, // tokens per second
+        };
+    }
+    /**
+     * Update limits based on response headers (Retry-After, X-RateLimit-*).
+     */
+    updateFromHeaders(service, headers) {
+        const remaining = headers['x-ratelimit-remaining'] ?? headers['X-RateLimit-Remaining'];
+        if (remaining !== undefined) {
+            const bucket = this.buckets.get(service);
+            if (bucket) {
+                const count = parseInt(remaining, 10);
+                if (!isNaN(count)) {
+                    bucket.tokens = Math.min(count, bucket.maxTokens);
+                }
+            }
+        }
+    }
+    /**
+     * Clean up timers.
+     */
+    destroy() {
+        for (const timer of this.timers.values()) {
+            clearInterval(timer);
+        }
+        this.timers.clear();
+        // Reject all queued requests
+        for (const bucket of this.buckets.values()) {
+            for (const waiter of bucket.queue) {
+                waiter.reject(new Error('Rate limiter destroyed'));
+            }
+            bucket.queue = [];
+        }
+    }
+    refill(bucket) {
+        const now = Date.now();
+        const elapsed = now - bucket.lastRefillAt;
+        const tokensToAdd = elapsed * bucket.refillRate;
+        bucket.tokens = Math.min(bucket.tokens + tokensToAdd, bucket.maxTokens);
+        bucket.lastRefillAt = now;
+    }
+    drainQueue(bucket) {
+        while (bucket.queue.length > 0 && bucket.tokens >= 1) {
+            bucket.tokens -= 1;
+            const waiter = bucket.queue.shift();
+            waiter.resolve();
+        }
+    }
+    ensureDrainTimer(service, bucket) {
+        if (this.timers.has(service))
+            return;
+        const intervalMs = Math.max(10, Math.ceil(1 / bucket.refillRate));
+        const timer = setInterval(() => {
+            this.refill(bucket);
+            this.drainQueue(bucket);
+            if (bucket.queue.length === 0) {
+                clearInterval(timer);
+                this.timers.delete(service);
+            }
+        }, intervalMs);
+        if (timer.unref)
+            timer.unref();
+        this.timers.set(service, timer);
+    }
+}
+/** Global rate limiter registry */
+let _globalLimiter;
+export function getRateLimiterRegistry(overrides) {
+    if (!_globalLimiter) {
+        _globalLimiter = new RateLimiterRegistry(overrides);
+    }
+    return _globalLimiter;
+}
+export function resetRateLimiterRegistry() {
+    _globalLimiter?.destroy();
+    _globalLimiter = undefined;
+}
+//# sourceMappingURL=rate-limiter.js.map

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

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

package/dist/reliability/wrapper.d.ts

@@ -24,6 +24,10 @@ export interface WrapperOptions {
     maxRetryDelay?: number;
     /** Zod schemas for input validation per action */
     inputSchemas?: Record<string, z.ZodTypeAny>;
+    /** Enable circuit breaker for this service (default: true) */
+    circuitBreaker?: boolean;
+    /** Enable proactive rate limiting (default: true) */
+    rateLimiter?: boolean;
 }
 export interface ActionCallOptions {
     /** Override timeout for this call */
@@ -43,4 +47,9 @@ export interface ActionCallOptions {
  * remain accessible. Only function calls get wrapped.
  */
 export declare function wrapIntegration<T extends object>(service: string, sdk: T, options?: Omit<WrapperOptions, 'service'>): T;
+/**
+ * Create an AbortSignal that triggers after the given timeout.
+ * Useful for passing to fetch() or other cancellable operations.
+ */
+export declare function createTimeoutSignal(timeoutMs: number): AbortSignal;
 //# sourceMappingURL=wrapper.d.ts.map

package/dist/reliability/wrapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wrapper.d.ts","sourceRoot":"","sources":["../../src/reliability/wrapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,iBAAiB;IAChC,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAgBD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,EAC9C,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,CAAC,EACN,OAAO,GAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAM,GAC5C,CAAC,CAYH"}
+{"version":3,"file":"wrapper.d.ts","sourceRoot":"","sources":["../../src/reliability/wrapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;IAC5C,8DAA8D;IAC9D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,qDAAqD;IACrD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAgBD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,EAC9C,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,CAAC,EACN,OAAO,GAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAM,GAC5C,CAAC,CAcH;AAgOD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAMlE"}

package/dist/reliability/wrapper.js

@@ -9,6 +9,8 @@
  * - Rate limit awareness
  */
 import { IntegrationRequestError, normalizeError } from './errors.js';
+import { getCircuitBreakerRegistry } from './circuit-breaker.js';
+import { getRateLimiterRegistry } from './rate-limiter.js';
 // ============================================================================
 // Defaults
 // ============================================================================
@@ -38,6 +40,8 @@ export function wrapIntegration(service, sdk, options = {}) {
         initialRetryDelay: options.initialRetryDelay ?? DEFAULT_INITIAL_RETRY_DELAY,
         maxRetryDelay: options.maxRetryDelay ?? DEFAULT_MAX_RETRY_DELAY,
         inputSchemas: options.inputSchemas ?? {},
+        circuitBreaker: options.circuitBreaker ?? true,
+        rateLimiter: options.rateLimiter ?? true,
     };
     return createProxy(sdk, opts, '');
 }
@@ -79,6 +83,11 @@ function createProxy(target, opts, path) {
 }
 function createWrappedFunction(thisArg, fn, opts, actionPath) {
     return async (...args) => {
+        // 0. Circuit breaker check
+        if (opts.circuitBreaker) {
+            const registry = getCircuitBreakerRegistry();
+            registry.allowRequest(opts.service); // Throws if circuit is open
+        }
         // 1. Input validation
         const schema = opts.inputSchemas[actionPath];
         if (schema && args.length > 0 && args[0] && typeof args[0] === 'object') {
@@ -92,7 +101,13 @@ function createWrappedFunction(thisArg, fn, opts, actionPath) {
                 });
             }
         }
-        // 2. Retry loop with timeout
+        // 2. Proactive rate limiting
+        if (opts.rateLimiter) {
+            await getRateLimiterRegistry().acquire(opts.service);
+        }
+        // 3. Retry loop with timeout
+        // Circuit breaker records are per-request, not per-attempt,
+        // to avoid fighting with retry logic.
         let lastError;
         const maxAttempts = opts.maxRetries + 1;
         for (let attempt = 0; attempt < maxAttempts; attempt++) {
@@ -103,6 +118,10 @@ function createWrappedFunction(thisArg, fn, opts, actionPath) {
             }
             try {
                 const result = await withTimeout(fn.apply(thisArg, args), opts.timeout, opts.service, actionPath);
+                // Record success once per request (not per attempt)
+                if (opts.circuitBreaker) {
+                    getCircuitBreakerRegistry().recordSuccess(opts.service);
+                }
                 return result;
             }
             catch (error) {
@@ -114,10 +133,17 @@ function createWrappedFunction(thisArg, fn, opts, actionPath) {
                     ? opts.retryOn.includes(lastError.statusCode)
                     : lastError.retryable;
                 if (!shouldRetry) {
+                    // Non-retryable failure — record and throw
+                    if (opts.circuitBreaker) {
+                        getCircuitBreakerRegistry().recordFailure(opts.service);
+                    }
                     throw lastError;
                 }
-                // Last attempt — throw
+                // Last attempt — record failure and throw
                 if (attempt === maxAttempts - 1) {
+                    if (opts.circuitBreaker) {
+                        getCircuitBreakerRegistry().recordFailure(opts.service);
+                    }
                     throw lastError;
                 }
             }
@@ -153,22 +179,46 @@ async function withTimeout(promise, timeoutMs, service, action) {
     if (!promise || typeof promise.then !== 'function') {
         return promise;
     }
+    const controller = new AbortController();
     return new Promise((resolve, reject) => {
+        let settled = false;
         const timer = setTimeout(() => {
-            reject(new IntegrationRequestError({
-                service,
-                action,
-                message: `Request timed out after ${timeoutMs}ms`,
-                retryable: true,
-            }));
+            if (!settled) {
+                settled = true;
+                controller.abort();
+                reject(new IntegrationRequestError({
+                    service,
+                    action,
+                    message: `Request timed out after ${timeoutMs}ms`,
+                    retryable: true,
+                }));
+            }
         }, timeoutMs);
         promise.then((result) => {
-            clearTimeout(timer);
-            resolve(result);
+            if (!settled) {
+                settled = true;
+                clearTimeout(timer);
+                resolve(result);
+            }
         }, (error) => {
-            clearTimeout(timer);
-            reject(error);
+            if (!settled) {
+                settled = true;
+                clearTimeout(timer);
+                reject(error);
+            }
         });
     });
 }
+/**
+ * Create an AbortSignal that triggers after the given timeout.
+ * Useful for passing to fetch() or other cancellable operations.
+ */
+export function createTimeoutSignal(timeoutMs) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    // Prevent timer from keeping the process alive
+    if (timer.unref)
+        timer.unref();
+    return controller.signal;
+}
 //# sourceMappingURL=wrapper.js.map