@push.rocks/smartregistry 2.2.3 → 2.3.0

package/dist_ts/rubygems/index.js

@@ -4,5 +4,6 @@
  */
 export * from './interfaces.rubygems.js';
 export * from './classes.rubygemsregistry.js';
+export { RubygemsUpstream } from './classes.rubygemsupstream.js';
 export * as rubygemsHelpers from './helpers.rubygems.js';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9ydWJ5Z2Vtcy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7O0dBR0c7QUFFSCxjQUFjLDBCQUEwQixDQUFDO0FBQ3pDLGNBQWMsK0JBQStCLENBQUM7QUFDOUMsT0FBTyxLQUFLLGVBQWUsTUFBTSx1QkFBdUIsQ0FBQyJ9
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9ydWJ5Z2Vtcy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7O0dBR0c7QUFFSCxjQUFjLDBCQUEwQixDQUFDO0FBQ3pDLGNBQWMsK0JBQStCLENBQUM7QUFDOUMsT0FBTyxFQUFFLGdCQUFnQixFQUFFLE1BQU0sK0JBQStCLENBQUM7QUFDakUsT0FBTyxLQUFLLGVBQWUsTUFBTSx1QkFBdUIsQ0FBQyJ9

package/dist_ts/upstream/classes.baseupstream.d.ts

@@ -0,0 +1,112 @@
+import * as plugins from '../plugins.js';
+import type { IUpstreamRegistryConfig, IUpstreamAuthConfig, IUpstreamCacheConfig, IUpstreamResilienceConfig, IUpstreamResult, IUpstreamFetchContext, IProtocolUpstreamConfig, IUpstreamScopeRule, TCircuitState } from './interfaces.upstream.js';
+import { CircuitBreaker } from './classes.circuitbreaker.js';
+import { UpstreamCache } from './classes.upstreamcache.js';
+/**
+ * Base class for protocol-specific upstream implementations.
+ *
+ * Provides:
+ * - Multi-upstream routing with priority
+ * - Scope-based filtering (glob patterns)
+ * - Authentication handling
+ * - Circuit breaker per upstream
+ * - Caching with TTL
+ * - Retry with exponential backoff
+ * - 429 rate limit handling
+ */
+export declare abstract class BaseUpstream {
+    /** Protocol name for logging */
+    protected abstract readonly protocolName: string;
+    /** Upstream configuration */
+    protected readonly config: IProtocolUpstreamConfig;
+    /** Resolved cache configuration */
+    protected readonly cacheConfig: IUpstreamCacheConfig;
+    /** Resolved resilience configuration */
+    protected readonly resilienceConfig: IUpstreamResilienceConfig;
+    /** Circuit breakers per upstream */
+    protected readonly circuitBreakers: Map<string, CircuitBreaker>;
+    /** Upstream cache */
+    protected readonly cache: UpstreamCache;
+    /** Logger instance */
+    protected readonly logger: plugins.smartlog.Smartlog;
+    constructor(config: IProtocolUpstreamConfig, logger?: plugins.smartlog.Smartlog);
+    /**
+     * Check if upstream is enabled.
+     */
+    isEnabled(): boolean;
+    /**
+     * Get all configured upstreams.
+     */
+    getUpstreams(): IUpstreamRegistryConfig[];
+    /**
+     * Get circuit breaker state for an upstream.
+     */
+    getCircuitState(upstreamId: string): TCircuitState | null;
+    /**
+     * Get cache statistics.
+     */
+    getCacheStats(): import("./classes.upstreamcache.js").ICacheStats;
+    /**
+     * Fetch a resource from upstreams.
+     * Tries upstreams in priority order, respecting circuit breakers and scope rules.
+     */
+    fetch(context: IUpstreamFetchContext): Promise<IUpstreamResult | null>;
+    /**
+     * Invalidate cache for a resource pattern.
+     */
+    invalidateCache(pattern: RegExp): number;
+    /**
+     * Clear all cache entries.
+     */
+    clearCache(): void;
+    /**
+     * Stop the upstream (cleanup resources).
+     */
+    stop(): void;
+    /**
+     * Get upstreams that apply to a resource, sorted by priority.
+     */
+    protected getApplicableUpstreams(resource: string): IUpstreamRegistryConfig[];
+    /**
+     * Check if a resource matches scope rules.
+     * Empty rules = match all.
+     */
+    protected matchesScopeRules(resource: string, rules?: IUpstreamScopeRule[]): boolean;
+    /**
+     * Fetch from a specific upstream with retry logic.
+     */
+    protected fetchFromUpstream(upstream: IUpstreamRegistryConfig, context: IUpstreamFetchContext): Promise<IUpstreamResult>;
+    /**
+     * Execute a single HTTP request to an upstream.
+     */
+    protected executeRequest(upstream: IUpstreamRegistryConfig, context: IUpstreamFetchContext, timeoutMs: number): Promise<Omit<IUpstreamResult, 'upstreamId' | 'fromCache' | 'latencyMs'>>;
+    /**
+     * Build the full URL for an upstream request.
+     * Subclasses can override for protocol-specific URL building.
+     */
+    protected buildUpstreamUrl(upstream: IUpstreamRegistryConfig, context: IUpstreamFetchContext): string;
+    /**
+     * Build headers including authentication.
+     */
+    protected buildHeaders(upstream: IUpstreamRegistryConfig, context: IUpstreamFetchContext): Record<string, string>;
+    /**
+     * Add authentication headers based on auth config.
+     */
+    protected addAuthHeaders(headers: Record<string, string>, auth: IUpstreamAuthConfig): void;
+    /**
+     * Check if an error should not be retried.
+     */
+    protected isNonRetryableError(error: unknown): boolean;
+    /**
+     * Calculate backoff delay with exponential backoff and jitter.
+     */
+    protected calculateBackoffDelay(attempt: number, baseDelayMs: number, maxDelayMs: number): number;
+    /**
+     * Sleep for a specified duration.
+     */
+    protected sleep(ms: number): Promise<void>;
+    /**
+     * Revalidate cache in background.
+     */
+    protected revalidateInBackground(context: IUpstreamFetchContext, upstreams: IUpstreamRegistryConfig[]): Promise<void>;
+}

package/dist_ts/upstream/classes.baseupstream.js

@@ -0,0 +1,409 @@
+import * as plugins from '../plugins.js';
+import { DEFAULT_CACHE_CONFIG, DEFAULT_RESILIENCE_CONFIG, } from './interfaces.upstream.js';
+import { CircuitBreaker, CircuitOpenError, withCircuitBreaker } from './classes.circuitbreaker.js';
+import { UpstreamCache } from './classes.upstreamcache.js';
+/**
+ * Base class for protocol-specific upstream implementations.
+ *
+ * Provides:
+ * - Multi-upstream routing with priority
+ * - Scope-based filtering (glob patterns)
+ * - Authentication handling
+ * - Circuit breaker per upstream
+ * - Caching with TTL
+ * - Retry with exponential backoff
+ * - 429 rate limit handling
+ */
+export class BaseUpstream {
+    /** Upstream configuration */
+    config;
+    /** Resolved cache configuration */
+    cacheConfig;
+    /** Resolved resilience configuration */
+    resilienceConfig;
+    /** Circuit breakers per upstream */
+    circuitBreakers = new Map();
+    /** Upstream cache */
+    cache;
+    /** Logger instance */
+    logger;
+    constructor(config, logger) {
+        this.config = config;
+        this.cacheConfig = { ...DEFAULT_CACHE_CONFIG, ...config.cache };
+        this.resilienceConfig = { ...DEFAULT_RESILIENCE_CONFIG, ...config.resilience };
+        this.cache = new UpstreamCache(this.cacheConfig);
+        this.logger = logger || new plugins.smartlog.Smartlog({
+            logContext: {
+                company: 'smartregistry',
+                companyunit: 'upstream',
+                environment: 'production',
+                runtime: 'node',
+            }
+        });
+        // Initialize circuit breakers for each upstream
+        for (const upstream of config.upstreams) {
+            const upstreamResilience = { ...this.resilienceConfig, ...upstream.resilience };
+            this.circuitBreakers.set(upstream.id, new CircuitBreaker(upstream.id, upstreamResilience));
+        }
+    }
+    /**
+     * Check if upstream is enabled.
+     */
+    isEnabled() {
+        return this.config.enabled;
+    }
+    /**
+     * Get all configured upstreams.
+     */
+    getUpstreams() {
+        return this.config.upstreams;
+    }
+    /**
+     * Get circuit breaker state for an upstream.
+     */
+    getCircuitState(upstreamId) {
+        const breaker = this.circuitBreakers.get(upstreamId);
+        return breaker ? breaker.getState() : null;
+    }
+    /**
+     * Get cache statistics.
+     */
+    getCacheStats() {
+        return this.cache.getStats();
+    }
+    /**
+     * Fetch a resource from upstreams.
+     * Tries upstreams in priority order, respecting circuit breakers and scope rules.
+     */
+    async fetch(context) {
+        if (!this.config.enabled) {
+            return null;
+        }
+        // Check cache first
+        const cached = this.cache.get(context);
+        if (cached && !cached.stale) {
+            return {
+                success: true,
+                status: 200,
+                headers: cached.headers,
+                body: cached.data,
+                upstreamId: cached.upstreamId,
+                fromCache: true,
+                latencyMs: 0,
+            };
+        }
+        // Check for negative cache (recent 404)
+        if (this.cache.hasNegative(context)) {
+            return {
+                success: false,
+                status: 404,
+                headers: {},
+                upstreamId: 'cache',
+                fromCache: true,
+                latencyMs: 0,
+            };
+        }
+        // Get applicable upstreams sorted by priority
+        const applicableUpstreams = this.getApplicableUpstreams(context.resource);
+        if (applicableUpstreams.length === 0) {
+            return null;
+        }
+        // If we have stale cache, return it immediately and revalidate in background
+        if (cached?.stale && this.cacheConfig.staleWhileRevalidate) {
+            // Fire and forget revalidation
+            this.revalidateInBackground(context, applicableUpstreams);
+            return {
+                success: true,
+                status: 200,
+                headers: cached.headers,
+                body: cached.data,
+                upstreamId: cached.upstreamId,
+                fromCache: true,
+                latencyMs: 0,
+            };
+        }
+        // Try each upstream in order
+        let lastError = null;
+        for (const upstream of applicableUpstreams) {
+            const breaker = this.circuitBreakers.get(upstream.id);
+            if (!breaker)
+                continue;
+            try {
+                const result = await withCircuitBreaker(breaker, () => this.fetchFromUpstream(upstream, context));
+                // Cache successful responses
+                if (result.success && result.body) {
+                    this.cache.set(context, Buffer.isBuffer(result.body) ? result.body : Buffer.from(JSON.stringify(result.body)), result.headers['content-type'] || 'application/octet-stream', result.headers, upstream.id);
+                }
+                // Cache 404 responses
+                if (result.status === 404) {
+                    this.cache.setNegative(context, upstream.id);
+                }
+                return result;
+            }
+            catch (error) {
+                if (error instanceof CircuitOpenError) {
+                    this.logger.log('debug', `Circuit open for upstream ${upstream.id}, trying next`);
+                }
+                else {
+                    this.logger.log('warn', `Upstream ${upstream.id} failed: ${error.message}`);
+                }
+                lastError = error;
+                // Continue to next upstream
+            }
+        }
+        // All upstreams failed
+        if (lastError) {
+            this.logger.log('error', `All upstreams failed for ${context.resource}: ${lastError.message}`);
+        }
+        return null;
+    }
+    /**
+     * Invalidate cache for a resource pattern.
+     */
+    invalidateCache(pattern) {
+        return this.cache.invalidatePattern(pattern);
+    }
+    /**
+     * Clear all cache entries.
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+    /**
+     * Stop the upstream (cleanup resources).
+     */
+    stop() {
+        this.cache.stop();
+    }
+    /**
+     * Get upstreams that apply to a resource, sorted by priority.
+     */
+    getApplicableUpstreams(resource) {
+        return this.config.upstreams
+            .filter(upstream => {
+            if (!upstream.enabled)
+                return false;
+            // Check circuit breaker
+            const breaker = this.circuitBreakers.get(upstream.id);
+            if (breaker && !breaker.canRequest())
+                return false;
+            // Check scope rules
+            return this.matchesScopeRules(resource, upstream.scopeRules);
+        })
+            .sort((a, b) => a.priority - b.priority);
+    }
+    /**
+     * Check if a resource matches scope rules.
+     * Empty rules = match all.
+     */
+    matchesScopeRules(resource, rules) {
+        if (!rules || rules.length === 0) {
+            return true;
+        }
+        // Process rules in order
+        // Start with default exclude (nothing matches)
+        let matched = false;
+        for (const rule of rules) {
+            const isMatch = plugins.minimatch(resource, rule.pattern);
+            if (isMatch) {
+                matched = rule.action === 'include';
+            }
+        }
+        return matched;
+    }
+    /**
+     * Fetch from a specific upstream with retry logic.
+     */
+    async fetchFromUpstream(upstream, context) {
+        const upstreamResilience = { ...this.resilienceConfig, ...upstream.resilience };
+        const startTime = Date.now();
+        let lastError = null;
+        for (let attempt = 0; attempt <= upstreamResilience.maxRetries; attempt++) {
+            try {
+                const result = await this.executeRequest(upstream, context, upstreamResilience.timeoutMs);
+                return {
+                    ...result,
+                    upstreamId: upstream.id,
+                    fromCache: false,
+                    latencyMs: Date.now() - startTime,
+                };
+            }
+            catch (error) {
+                lastError = error;
+                // Don't retry on 4xx errors (except 429)
+                if (this.isNonRetryableError(error)) {
+                    break;
+                }
+                // Calculate delay with exponential backoff and jitter
+                if (attempt < upstreamResilience.maxRetries) {
+                    const delay = this.calculateBackoffDelay(attempt, upstreamResilience.retryDelayMs, upstreamResilience.retryMaxDelayMs);
+                    await this.sleep(delay);
+                }
+            }
+        }
+        throw lastError || new Error('Request failed');
+    }
+    /**
+     * Execute a single HTTP request to an upstream.
+     */
+    async executeRequest(upstream, context, timeoutMs) {
+        // Build the full URL
+        const url = this.buildUpstreamUrl(upstream, context);
+        // Build headers with auth
+        const headers = this.buildHeaders(upstream, context);
+        // Make the request using SmartRequest
+        const request = plugins.smartrequest.SmartRequest.create()
+            .url(url)
+            .method(context.method)
+            .headers(headers)
+            .timeout(timeoutMs)
+            .handle429Backoff({ maxRetries: 3, fallbackDelay: 1000, maxWaitTime: 30000 });
+        // Add query params if present
+        if (Object.keys(context.query).length > 0) {
+            request.query(context.query);
+        }
+        let response;
+        switch (context.method.toUpperCase()) {
+            case 'GET':
+                response = await request.get();
+                break;
+            case 'HEAD':
+                // SmartRequest doesn't have head(), use options
+                response = await request.method('HEAD').get();
+                break;
+            default:
+                response = await request.get();
+        }
+        // Parse response
+        const responseHeaders = {};
+        for (const [key, value] of Object.entries(response.headers)) {
+            responseHeaders[key.toLowerCase()] = Array.isArray(value) ? value[0] : value;
+        }
+        let body;
+        const contentType = responseHeaders['content-type'] || '';
+        if (response.ok) {
+            if (contentType.includes('application/json')) {
+                body = await response.json();
+            }
+            else {
+                const arrayBuffer = await response.arrayBuffer();
+                body = Buffer.from(arrayBuffer);
+            }
+        }
+        return {
+            success: response.ok,
+            status: response.status,
+            headers: responseHeaders,
+            body,
+        };
+    }
+    /**
+     * Build the full URL for an upstream request.
+     * Subclasses can override for protocol-specific URL building.
+     */
+    buildUpstreamUrl(upstream, context) {
+        // Remove leading slash if URL already has trailing slash
+        let path = context.path;
+        if (upstream.url.endsWith('/') && path.startsWith('/')) {
+            path = path.slice(1);
+        }
+        return `${upstream.url}${path}`;
+    }
+    /**
+     * Build headers including authentication.
+     */
+    buildHeaders(upstream, context) {
+        const headers = { ...context.headers };
+        // Remove host header (will be set by HTTP client)
+        delete headers['host'];
+        // Add authentication
+        this.addAuthHeaders(headers, upstream.auth);
+        return headers;
+    }
+    /**
+     * Add authentication headers based on auth config.
+     */
+    addAuthHeaders(headers, auth) {
+        switch (auth.type) {
+            case 'basic':
+                if (auth.username && auth.password) {
+                    const credentials = Buffer.from(`${auth.username}:${auth.password}`).toString('base64');
+                    headers['authorization'] = `Basic ${credentials}`;
+                }
+                break;
+            case 'bearer':
+                if (auth.token) {
+                    headers['authorization'] = `Bearer ${auth.token}`;
+                }
+                break;
+            case 'api-key':
+                if (auth.token) {
+                    const headerName = auth.headerName || 'authorization';
+                    headers[headerName.toLowerCase()] = auth.token;
+                }
+                break;
+            case 'none':
+            default:
+                // No authentication
+                break;
+        }
+    }
+    /**
+     * Check if an error should not be retried.
+     */
+    isNonRetryableError(error) {
+        // Check for HTTP status errors
+        if (error && typeof error === 'object' && 'status' in error) {
+            const status = error.status;
+            // Don't retry 4xx errors except 429 (rate limited)
+            if (status >= 400 && status < 500 && status !== 429) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Calculate backoff delay with exponential backoff and jitter.
+     */
+    calculateBackoffDelay(attempt, baseDelayMs, maxDelayMs) {
+        // Exponential backoff: delay = base * 2^attempt
+        const exponentialDelay = baseDelayMs * Math.pow(2, attempt);
+        // Cap at max delay
+        const cappedDelay = Math.min(exponentialDelay, maxDelayMs);
+        // Add jitter (±25%)
+        const jitter = cappedDelay * 0.25 * (Math.random() * 2 - 1);
+        return Math.floor(cappedDelay + jitter);
+    }
+    /**
+     * Sleep for a specified duration.
+     */
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    /**
+     * Revalidate cache in background.
+     */
+    async revalidateInBackground(context, upstreams) {
+        try {
+            for (const upstream of upstreams) {
+                const breaker = this.circuitBreakers.get(upstream.id);
+                if (!breaker || !breaker.canRequest())
+                    continue;
+                try {
+                    const result = await withCircuitBreaker(breaker, () => this.fetchFromUpstream(upstream, context));
+                    if (result.success && result.body) {
+                        this.cache.set(context, Buffer.isBuffer(result.body) ? result.body : Buffer.from(JSON.stringify(result.body)), result.headers['content-type'] || 'application/octet-stream', result.headers, upstream.id);
+                        return; // Successfully revalidated
+                    }
+                }
+                catch {
+                    // Continue to next upstream
+                }
+            }
+        }
+        catch (error) {
+            this.logger.log('debug', `Background revalidation failed: ${error.message}`);
+        }
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5iYXNldXBzdHJlYW0uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy91cHN0cmVhbS9jbGFzc2VzLmJhc2V1cHN0cmVhbS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGVBQWUsQ0FBQztBQVl6QyxPQUFPLEVBQ0wsb0JBQW9CLEVBQ3BCLHlCQUF5QixHQUMxQixNQUFNLDBCQUEwQixDQUFDO0FBQ2xDLE9BQU8sRUFBRSxjQUFjLEVBQUUsZ0JBQWdCLEVBQUUsa0JBQWtCLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUNuRyxPQUFPLEVBQUUsYUFBYSxFQUFFLE1BQU0sNEJBQTRCLENBQUM7QUFFM0Q7Ozs7Ozs7Ozs7O0dBV0c7QUFDSCxNQUFNLE9BQWdCLFlBQVk7SUFJaEMsNkJBQTZCO0lBQ1YsTUFBTSxDQUEwQjtJQUVuRCxtQ0FBbUM7SUFDaEIsV0FBVyxDQUF1QjtJQUVyRCx3Q0FBd0M7SUFDckIsZ0JBQWdCLENBQTRCO0lBRS9ELG9DQUFvQztJQUNqQixlQUFlLEdBQWdDLElBQUksR0FBRyxFQUFFLENBQUM7SUFFNUUscUJBQXFCO0lBQ0YsS0FBSyxDQUFnQjtJQUV4QyxzQkFBc0I7SUFDSCxNQUFNLENBQTRCO0lBRXJELFlBQVksTUFBK0IsRUFBRSxNQUFrQztRQUM3RSxJQUFJLENBQUMsTUFBTSxHQUFHLE1BQU0sQ0FBQztRQUNyQixJQUFJLENBQUMsV0FBVyxHQUFHLEVBQUUsR0FBRyxvQkFBb0IsRUFBRSxHQUFHLE1BQU0sQ0FBQyxLQUFLLEVBQUUsQ0FBQztRQUNoRSxJQUFJLENBQUMsZ0JBQWdCLEdBQUcsRUFBRSxHQUFHLHlCQUF5QixFQUFFLEdBQUcsTUFBTSxDQUFDLFVBQVUsRUFBRSxDQUFDO1FBQy9FLElBQUksQ0FBQyxLQUFLLEdBQUcsSUFBSSxhQUFhLENBQUMsSUFBSSxDQUFDLFdBQVcsQ0FBQyxDQUFDO1FBQ2pELElBQUksQ0FBQyxNQUFNLEdBQUcs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

package/dist_ts/upstream/classes.circuitbreaker.d.ts

@@ -0,0 +1,111 @@
+import type { TCircuitState, IUpstreamResilienceConfig } from './interfaces.upstream.js';
+/**
+ * Circuit breaker implementation for upstream resilience.
+ *
+ * States:
+ * - CLOSED: Normal operation, requests pass through
+ * - OPEN: Circuit is tripped, requests fail fast
+ * - HALF_OPEN: Testing if upstream has recovered
+ *
+ * Transitions:
+ * - CLOSED → OPEN: When failure count exceeds threshold
+ * - OPEN → HALF_OPEN: After reset timeout expires
+ * - HALF_OPEN → CLOSED: On successful request
+ * - HALF_OPEN → OPEN: On failed request
+ */
+export declare class CircuitBreaker {
+    /** Unique identifier for logging and metrics */
+    readonly id: string;
+    /** Current circuit state */
+    private state;
+    /** Count of consecutive failures */
+    private failureCount;
+    /** Timestamp when circuit was opened */
+    private openedAt;
+    /** Number of successful requests in half-open state */
+    private halfOpenSuccesses;
+    /** Configuration */
+    private readonly config;
+    /** Number of successes required to close circuit from half-open */
+    private readonly halfOpenThreshold;
+    constructor(id: string, config?: Partial<IUpstreamResilienceConfig>);
+    /**
+     * Get current circuit state.
+     */
+    getState(): TCircuitState;
+    /**
+     * Check if circuit allows requests.
+     * Returns true if requests should be allowed.
+     */
+    canRequest(): boolean;
+    /**
+     * Record a successful request.
+     * May transition circuit from HALF_OPEN to CLOSED.
+     */
+    recordSuccess(): void;
+    /**
+     * Record a failed request.
+     * May transition circuit from CLOSED/HALF_OPEN to OPEN.
+     */
+    recordFailure(): void;
+    /**
+     * Force circuit to open state.
+     * Useful for manual intervention or external health checks.
+     */
+    forceOpen(): void;
+    /**
+     * Force circuit to closed state.
+     * Useful for manual intervention after fixing upstream issues.
+     */
+    forceClose(): void;
+    /**
+     * Reset circuit to initial state.
+     */
+    reset(): void;
+    /**
+     * Get circuit metrics for monitoring.
+     */
+    getMetrics(): ICircuitBreakerMetrics;
+    /**
+     * Transition to a new state with proper cleanup.
+     */
+    private transitionTo;
+}
+/**
+ * Metrics for circuit breaker monitoring.
+ */
+export interface ICircuitBreakerMetrics {
+    /** Circuit breaker identifier */
+    id: string;
+    /** Current state */
+    state: TCircuitState;
+    /** Number of consecutive failures */
+    failureCount: number;
+    /** When circuit was opened (null if never opened) */
+    openedAt: Date | null;
+    /** Milliseconds until circuit transitions to half-open (0 if not open) */
+    timeUntilHalfOpen: number;
+    /** Number of successes in half-open state */
+    halfOpenSuccesses: number;
+    /** Failure threshold for opening circuit */
+    threshold: number;
+    /** Reset timeout in milliseconds */
+    resetMs: number;
+}
+/**
+ * Execute a function with circuit breaker protection.
+ *
+ * @param breaker The circuit breaker to use
+ * @param fn The async function to execute
+ * @param fallback Optional fallback function when circuit is open
+ * @returns The result of fn or fallback
+ * @throws CircuitOpenError if circuit is open and no fallback provided
+ */
+export declare function withCircuitBreaker<T>(breaker: CircuitBreaker, fn: () => Promise<T>, fallback?: () => Promise<T>): Promise<T>;
+/**
+ * Error thrown when circuit is open and no fallback is provided.
+ */
+export declare class CircuitOpenError extends Error {
+    readonly circuitId: string;
+    constructor(circuitId: string);
+}