@marktoflow/integrations 2.0.4-alpha.1 → 2.0.4

package/dist/adapters/claude-agent-hooks.d.ts

@@ -1,176 +0,0 @@
-/**
- * Claude Agent SDK Hooks for marktoflow
- *
- * Provides pre-built hook configurations for common use cases:
- * - Audit logging
- * - Cost tracking
- * - Approval workflows
- * - File change monitoring
- * - Security enforcement
- */
-import { HookCallback, HookEvent, ToolPermissionHandler } from './claude-agent-types.js';
-/**
- * Audit log entry
- */
-export interface AuditLogEntry {
-    timestamp: Date;
-    event: HookEvent;
-    toolName?: string;
-    toolInput?: Record<string, unknown>;
-    toolResponse?: string;
-    sessionId?: string;
-    error?: string;
-    duration?: number;
-    metadata?: Record<string, unknown>;
-}
-/**
- * Audit logger interface
- */
-export interface AuditLogger {
-    log(entry: AuditLogEntry): Promise<void>;
-    flush(): Promise<void>;
-}
-/**
- * Console audit logger (default)
- */
-export declare class ConsoleAuditLogger implements AuditLogger {
-    private prefix;
-    constructor(prefix?: string);
-    log(entry: AuditLogEntry): Promise<void>;
-    flush(): Promise<void>;
-}
-/**
- * File audit logger
- */
-export declare class FileAuditLogger implements AuditLogger {
-    private filePath;
-    private buffer;
-    private bufferSize;
-    constructor(filePath: string, bufferSize?: number);
-    log(entry: AuditLogEntry): Promise<void>;
-    flush(): Promise<void>;
-}
-/**
- * Create audit logging hooks
- */
-export declare function createAuditHooks(logger?: AuditLogger): Partial<Record<HookEvent, HookCallback[]>>;
-/**
- * Cost tracker for monitoring spending
- */
-export interface CostTracker {
-    /** Current total cost in USD */
-    totalCostUsd: number;
-    /** Cost per model */
-    costByModel: Record<string, number>;
-    /** Tool execution counts */
-    toolCounts: Record<string, number>;
-    /** Start time */
-    startTime: Date;
-    /** Number of API calls */
-    apiCalls: number;
-}
-/**
- * Cost tracking callback
- */
-export type CostCallback = (tracker: CostTracker) => void | Promise<void>;
-/**
- * Create a cost tracker
- */
-export declare function createCostTracker(): CostTracker;
-/**
- * Create cost tracking hooks
- */
-export declare function createCostTrackingHooks(tracker: CostTracker, callbacks?: {
-    onToolUse?: CostCallback;
-    onBudgetWarning?: CostCallback;
-    budgetWarningThreshold?: number;
-}): Partial<Record<HookEvent, HookCallback[]>>;
-/**
- * Approval request
- */
-export interface ApprovalRequest {
-    toolName: string;
-    toolInput: Record<string, unknown>;
-    reason?: string;
-}
-/**
- * Approval handler
- */
-export type ApprovalHandler = (request: ApprovalRequest) => Promise<boolean>;
-/**
- * Create approval workflow hooks
- */
-export declare function createApprovalHooks(approvalHandler: ApprovalHandler, toolsRequiringApproval?: string[]): Partial<Record<HookEvent, HookCallback[]>>;
-/**
- * File change record
- */
-export interface FileChange {
-    timestamp: Date;
-    operation: 'read' | 'write' | 'edit';
-    filePath: string;
-    toolInput?: Record<string, unknown>;
-}
-/**
- * File change callback
- */
-export type FileChangeCallback = (change: FileChange) => void | Promise<void>;
-/**
- * Create file monitoring hooks
- */
-export declare function createFileMonitoringHooks(callback: FileChangeCallback): Partial<Record<HookEvent, HookCallback[]>>;
-/**
- * Security policy for tool execution
- */
-export interface SecurityPolicy {
-    /** Blocked file patterns (glob) */
-    blockedPaths?: string[];
-    /** Blocked commands (regex) */
-    blockedCommands?: string[];
-    /** Allowed working directories */
-    allowedDirectories?: string[];
-    /** Maximum file size for writes (bytes) */
-    maxFileSize?: number;
-    /** Block network access */
-    blockNetwork?: boolean;
-}
-/**
- * Create a security-enforcing permission handler
- */
-export declare function createSecurityPermissionHandler(policy: SecurityPolicy): ToolPermissionHandler;
-/**
- * Preset hook configurations for common use cases
- */
-export declare const PresetHooks: {
-    /**
-     * Development mode - permissive with logging
-     */
-    development: (logger?: AuditLogger) => {
-        PreToolUse?: HookCallback[] | undefined;
-        PostToolUse?: HookCallback[] | undefined;
-        PostToolUseFailure?: HookCallback[] | undefined;
-        PermissionRequest?: HookCallback[] | undefined;
-        SessionStart?: HookCallback[] | undefined;
-        SessionEnd?: HookCallback[] | undefined;
-        Stop?: HookCallback[] | undefined;
-    };
-    /**
-     * Production mode - strict with approval and monitoring
-     */
-    production: (approvalHandler: ApprovalHandler, logger?: AuditLogger) => Partial<Record<HookEvent, HookCallback[]>>;
-    /**
-     * CI/CD mode - automated with cost tracking
-     */
-    cicd: (costTracker: CostTracker, maxBudget?: number) => Partial<Record<HookEvent, HookCallback[]>>;
-    /**
-     * Secure mode - strict security with file monitoring
-     */
-    secure: (policy: SecurityPolicy, fileChangeCallback?: FileChangeCallback) => {
-        hooks: Partial<Record<HookEvent, HookCallback[]>>;
-        canUseTool: ToolPermissionHandler;
-    };
-};
-/**
- * Merge multiple hook configurations
- */
-export declare function mergeHooks(...hookConfigs: Array<Partial<Record<HookEvent, HookCallback[]>>>): Partial<Record<HookEvent, HookCallback[]>>;
-//# sourceMappingURL=claude-agent-hooks.d.ts.map

package/dist/reliability/circuit-breaker.d.ts

@@ -1,67 +0,0 @@
-/**
- * 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)
- */
-export type CircuitState = 'closed' | 'open' | 'half_open';
-export interface CircuitBreakerOptions {
-    /** Number of failures before opening circuit (default: 5) */
-    failureThreshold?: number;
-    /** Time in ms before attempting recovery (default: 30000) */
-    resetTimeout?: number;
-    /** Number of successful requests in half-open to close circuit (default: 2) */
-    successThreshold?: number;
-    /** Time window in ms for counting failures (default: 60000) */
-    failureWindow?: number;
-    /** Called when circuit state changes */
-    onStateChange?: (service: string, from: CircuitState, to: CircuitState) => void;
-}
-export declare class CircuitBreakerRegistry {
-    private circuits;
-    private options;
-    private onStateChange?;
-    constructor(options?: CircuitBreakerOptions);
-    /**
-     * Check if a request to the given service should be allowed.
-     * Throws immediately if circuit is open.
-     */
-    allowRequest(service: string): void;
-    /**
-     * Record a successful request.
-     */
-    recordSuccess(service: string): void;
-    /**
-     * Record a failed request.
-     */
-    recordFailure(service: string): void;
-    /**
-     * Get current state of a service's circuit.
-     */
-    getState(service: string): CircuitState;
-    /**
-     * Get stats for all circuits.
-     */
-    getStats(): Record<string, {
-        state: CircuitState;
-        recentFailures: number;
-    }>;
-    /**
-     * Reset a specific service's circuit to closed.
-     */
-    reset(service: string): void;
-    /**
-     * Reset all circuits.
-     */
-    resetAll(): void;
-    private getCircuit;
-    private transition;
-}
-export declare function getCircuitBreakerRegistry(options?: CircuitBreakerOptions): CircuitBreakerRegistry;
-export declare function resetCircuitBreakerRegistry(): void;
-//# sourceMappingURL=circuit-breaker.d.ts.map

package/dist/reliability/circuit-breaker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../src/reliability/circuit-breaker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAE3D,MAAM,WAAW,qBAAqB;IACpC,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,+DAA+D;IAC/D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,YAAY,KAAK,IAAI,CAAC;CACjF;AAiBD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,OAAO,CAAyD;IACxE,OAAO,CAAC,aAAa,CAAC,CAAyC;gBAEnD,OAAO,GAAE,qBAA0B;IAU/C;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IA4BnC;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAWpC;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAsBpC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY;IAIvC;;OAEG;IACH,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,YAAY,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;IAc3E;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5B;;OAEG;IACH,QAAQ,IAAI,IAAI;IAIhB,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,UAAU;CAgBnB;AAKD,wBAAgB,yBAAyB,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,sBAAsB,CAKjG;AAED,wBAAgB,2BAA2B,IAAI,IAAI,CAGlD"}

package/dist/reliability/circuit-breaker.js

@@ -1,164 +0,0 @@
-/**
- * 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

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

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

@@ -1,62 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,194 +0,0 @@
-/**
- * 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