easy-mcp-nest 0.3.0 → 0.4.0

package/dist/core/observability/metrics.service.js

@@ -0,0 +1,124 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetricsService = void 0;
+const common_1 = require("@nestjs/common");
+const logger_util_1 = require("../utils/logger.util");
+let MetricsService = class MetricsService {
+    toolMetrics = new Map();
+    requestCount = 0;
+    activeRequests = 0;
+    startTime = Date.now();
+    onModuleInit() {
+        logger_util_1.logger.info("MetricsService", "Metrics collection initialized", {
+            component: "Observability",
+        });
+    }
+    recordToolStart(toolName) {
+        const startTime = Date.now();
+        this.activeRequests++;
+        this.requestCount++;
+        return () => {
+            const executionTime = Date.now() - startTime;
+            this.activeRequests--;
+            const metrics = this.toolMetrics.get(toolName) || {
+                toolName,
+                executionCount: 0,
+                totalExecutionTime: 0,
+                errorCount: 0,
+            };
+            metrics.executionCount++;
+            metrics.totalExecutionTime += executionTime;
+            metrics.lastExecutionTime = Date.now();
+            this.toolMetrics.set(toolName, metrics);
+        };
+    }
+    recordToolError(toolName) {
+        const metrics = this.toolMetrics.get(toolName) || {
+            toolName,
+            executionCount: 0,
+            totalExecutionTime: 0,
+            errorCount: 0,
+        };
+        metrics.errorCount++;
+        this.toolMetrics.set(toolName, metrics);
+    }
+    getToolMetrics(toolName) {
+        return this.toolMetrics.get(toolName);
+    }
+    getAllToolMetrics() {
+        return Array.from(this.toolMetrics.values());
+    }
+    getAverageExecutionTime(toolName) {
+        const metrics = this.toolMetrics.get(toolName);
+        if (!metrics || metrics.executionCount === 0) {
+            return 0;
+        }
+        return metrics.totalExecutionTime / metrics.executionCount;
+    }
+    getErrorRate(toolName) {
+        const metrics = this.toolMetrics.get(toolName);
+        if (!metrics || metrics.executionCount === 0) {
+            return 0;
+        }
+        return metrics.errorCount / metrics.executionCount;
+    }
+    getServerMetrics() {
+        return {
+            totalRequests: this.requestCount,
+            activeRequests: this.activeRequests,
+            uptime: Date.now() - this.startTime,
+            toolCount: this.toolMetrics.size,
+        };
+    }
+    getPrometheusMetrics() {
+        const lines = [];
+        const serverMetrics = this.getServerMetrics();
+        lines.push(`# HELP mcp_server_total_requests Total number of requests`);
+        lines.push(`# TYPE mcp_server_total_requests counter`);
+        lines.push(`mcp_server_total_requests ${serverMetrics.totalRequests}`);
+        lines.push(`# HELP mcp_server_active_requests Current number of active requests`);
+        lines.push(`# TYPE mcp_server_active_requests gauge`);
+        lines.push(`mcp_server_active_requests ${serverMetrics.activeRequests}`);
+        lines.push(`# HELP mcp_server_uptime_seconds Server uptime in seconds`);
+        lines.push(`# TYPE mcp_server_uptime_seconds gauge`);
+        lines.push(`mcp_server_uptime_seconds ${Math.floor(serverMetrics.uptime / 1000)}`);
+        for (const metrics of this.toolMetrics.values()) {
+            const toolName = metrics.toolName.replace(/[^a-zA-Z0-9_]/g, "_");
+            lines.push(`# HELP mcp_tool_executions_total Total number of tool executions`);
+            lines.push(`# TYPE mcp_tool_executions_total counter`);
+            lines.push(`mcp_tool_executions_total{tool="${toolName}"} ${metrics.executionCount}`);
+            lines.push(`# HELP mcp_tool_execution_time_seconds Total execution time in seconds`);
+            lines.push(`# TYPE mcp_tool_execution_time_seconds counter`);
+            lines.push(`mcp_tool_execution_time_seconds{tool="${toolName}"} ${metrics.totalExecutionTime / 1000}`);
+            lines.push(`# HELP mcp_tool_errors_total Total number of tool errors`);
+            lines.push(`# TYPE mcp_tool_errors_total counter`);
+            lines.push(`mcp_tool_errors_total{tool="${toolName}"} ${metrics.errorCount}`);
+            const avgTime = this.getAverageExecutionTime(metrics.toolName);
+            lines.push(`# HELP mcp_tool_avg_execution_time_seconds Average execution time in seconds`);
+            lines.push(`# TYPE mcp_tool_avg_execution_time_seconds gauge`);
+            lines.push(`mcp_tool_avg_execution_time_seconds{tool="${toolName}"} ${avgTime / 1000}`);
+            const errorRate = this.getErrorRate(metrics.toolName);
+            lines.push(`# HELP mcp_tool_error_rate Error rate (0.0 to 1.0)`);
+            lines.push(`# TYPE mcp_tool_error_rate gauge`);
+            lines.push(`mcp_tool_error_rate{tool="${toolName}"} ${errorRate}`);
+        }
+        return lines.join("\n");
+    }
+    reset() {
+        this.toolMetrics.clear();
+        this.requestCount = 0;
+        this.activeRequests = 0;
+        this.startTime = Date.now();
+    }
+};
+exports.MetricsService = MetricsService;
+exports.MetricsService = MetricsService = __decorate([
+    (0, common_1.Injectable)()
+], MetricsService);
+//# sourceMappingURL=metrics.service.js.map

package/dist/core/observability/metrics.service.js.map

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

package/dist/core/observability/tracing.service.d.ts

@@ -0,0 +1,12 @@
+export interface TraceContext {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    startTime: number;
+}
+export declare class TracingService {
+    createTraceContext(parentTraceId?: string, parentSpanId?: string): TraceContext;
+    private validateTraceId;
+    extractTraceContext(headers?: Record<string, any>): TraceContext | undefined;
+    createChildSpan(parent: TraceContext): TraceContext;
+}

package/dist/core/observability/tracing.service.js

@@ -0,0 +1,88 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TracingService = void 0;
+const common_1 = require("@nestjs/common");
+const crypto_1 = require("crypto");
+function generateUUID() {
+    if (typeof crypto_1.randomUUID === "function") {
+        return (0, crypto_1.randomUUID)();
+    }
+    if (typeof crypto !== "undefined" && crypto.getRandomValues) {
+        const bytes = new Uint8Array(16);
+        crypto.getRandomValues(bytes);
+        bytes[6] = (bytes[6] & 0x0f) | 0x40;
+        bytes[8] = (bytes[8] & 0x3f) | 0x80;
+        const hex = Array.from(bytes)
+            .map((b) => b.toString(16).padStart(2, "0"))
+            .join("");
+        return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20, 32)}`;
+    }
+    return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+        const r = (Math.random() * 16) | 0;
+        const v = c === "x" ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
+}
+let TracingService = class TracingService {
+    createTraceContext(parentTraceId, parentSpanId) {
+        return {
+            traceId: parentTraceId || generateUUID(),
+            spanId: generateUUID(),
+            parentSpanId,
+            startTime: Date.now(),
+        };
+    }
+    validateTraceId(traceId) {
+        if (!traceId || typeof traceId !== "string") {
+            return null;
+        }
+        let sanitized = traceId.replace(/[\x00-\x1F\x7F-\x9F\n\r]/g, "");
+        const MAX_TRACE_ID_LENGTH = 128;
+        if (sanitized.length > MAX_TRACE_ID_LENGTH) {
+            return null;
+        }
+        if (!/^[a-zA-Z0-9_-]{1,128}$/.test(sanitized)) {
+            return null;
+        }
+        return sanitized;
+    }
+    extractTraceContext(headers) {
+        if (!headers) {
+            return undefined;
+        }
+        const traceId = headers["x-trace-id"] || headers["trace-id"];
+        const spanId = headers["x-span-id"] || headers["span-id"];
+        const parentSpanId = headers["x-parent-span-id"] || headers["parent-span-id"];
+        const validatedTraceId = traceId ? this.validateTraceId(traceId) : null;
+        if (!validatedTraceId) {
+            return undefined;
+        }
+        const validatedSpanId = spanId ? this.validateTraceId(spanId) : null;
+        const validatedParentSpanId = parentSpanId ? this.validateTraceId(parentSpanId) : null;
+        return {
+            traceId: validatedTraceId,
+            spanId: validatedSpanId || generateUUID(),
+            parentSpanId: validatedParentSpanId || undefined,
+            startTime: Date.now(),
+        };
+    }
+    createChildSpan(parent) {
+        return {
+            traceId: parent.traceId,
+            spanId: generateUUID(),
+            parentSpanId: parent.spanId,
+            startTime: Date.now(),
+        };
+    }
+};
+exports.TracingService = TracingService;
+exports.TracingService = TracingService = __decorate([
+    (0, common_1.Injectable)()
+], TracingService);
+//# sourceMappingURL=tracing.service.js.map

package/dist/core/observability/tracing.service.js.map

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

package/dist/core/progress/progress-notifier.service.d.ts

@@ -0,0 +1,16 @@
+import type { IInterfaceLayer } from "../../interface/interface.interface";
+export type ProgressCallback = (progress: {
+    progress: number;
+    total?: number;
+    message?: string;
+}) => void;
+export declare class ProgressNotifierService {
+    private interfaceLayer?;
+    private progressTokens;
+    private nextTokenId;
+    constructor(interfaceLayer?: IInterfaceLayer | undefined);
+    createProgressCallback(requestId: string | number | null): ProgressCallback;
+    private getOrCreateProgressToken;
+    private sendProgress;
+    cleanup(requestId: string | number | null): void;
+}

package/dist/core/progress/progress-notifier.service.js

@@ -0,0 +1,96 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProgressNotifierService = void 0;
+const common_1 = require("@nestjs/common");
+const constants_1 = require("../../config/constants");
+const logger_util_1 = require("../utils/logger.util");
+let ProgressNotifierService = class ProgressNotifierService {
+    interfaceLayer;
+    progressTokens = new Map();
+    nextTokenId = 0;
+    constructor(interfaceLayer) {
+        this.interfaceLayer = interfaceLayer;
+    }
+    createProgressCallback(requestId) {
+        if (requestId === null || requestId === undefined) {
+            return () => { };
+        }
+        const progressToken = this.getOrCreateProgressToken(requestId);
+        return (progress) => {
+            this.sendProgress(requestId, progressToken, progress);
+        };
+    }
+    getOrCreateProgressToken(requestId) {
+        if (!this.progressTokens.has(requestId)) {
+            const token = `progress_${this.nextTokenId++}_${Date.now()}`;
+            this.progressTokens.set(requestId, token);
+        }
+        return this.progressTokens.get(requestId);
+    }
+    sendProgress(requestId, progressToken, progress) {
+        if (!this.interfaceLayer) {
+            logger_util_1.logger.debug("ProgressNotifierService", "Progress update", {
+                component: "ProgressNotifier",
+                requestId,
+                progress: progress.progress,
+                message: progress.message,
+            });
+            return;
+        }
+        const clampedProgress = Math.max(0, Math.min(1, progress.progress));
+        const notification = {
+            jsonrpc: "2.0",
+            method: "notifications/progress",
+            params: {
+                progressToken,
+                progress: clampedProgress,
+                ...(progress.total !== undefined && { total: progress.total }),
+                ...(progress.message && { message: progress.message }),
+            },
+        };
+        try {
+            if (this.interfaceLayer.sendNotification) {
+                this.interfaceLayer.sendNotification(notification);
+            }
+            else {
+                logger_util_1.logger.debug("ProgressNotifierService", "Progress notification", {
+                    component: "ProgressNotifier",
+                    requestId,
+                    notification,
+                });
+            }
+        }
+        catch (error) {
+            logger_util_1.logger.error("ProgressNotifierService", "Failed to send progress notification", {
+                component: "ProgressNotifier",
+                requestId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    cleanup(requestId) {
+        if (requestId !== null && requestId !== undefined) {
+            this.progressTokens.delete(requestId);
+        }
+    }
+};
+exports.ProgressNotifierService = ProgressNotifierService;
+exports.ProgressNotifierService = ProgressNotifierService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Optional)()),
+    __param(0, (0, common_1.Inject)(constants_1.INTERFACE_LAYER_TOKEN)),
+    __metadata("design:paramtypes", [Object])
+], ProgressNotifierService);
+//# sourceMappingURL=progress-notifier.service.js.map

package/dist/core/progress/progress-notifier.service.js.map

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

package/dist/core/rate-limiting/rate-limit.interface.d.ts

@@ -0,0 +1,11 @@
+import { RateLimitConfig } from "../../decorators/mcp-tool.decorator";
+export type { RateLimitConfig };
+export interface RateLimitEntry {
+    count: number;
+    resetTime: number;
+}
+export interface RateLimitResult {
+    allowed: boolean;
+    remaining: number;
+    resetTime: number;
+}

package/dist/core/rate-limiting/rate-limit.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=rate-limit.interface.js.map

package/dist/core/rate-limiting/rate-limit.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.interface.js","sourceRoot":"","sources":["../../../src/core/rate-limiting/rate-limit.interface.ts"],"names":[],"mappings":""}

package/dist/core/rate-limiting/rate-limiter.service.d.ts

@@ -0,0 +1,13 @@
+import { OnModuleInit, OnModuleDestroy } from "@nestjs/common";
+import { RateLimitConfig, RateLimitResult } from "./rate-limit.interface";
+export declare class RateLimiterService implements OnModuleInit, OnModuleDestroy {
+    private rateLimiters;
+    private cleanupInterval?;
+    private static readonly MAX_ENTRIES_PER_TOOL;
+    private static readonly CLEANUP_INTERVAL_MS;
+    onModuleInit(): void;
+    onModuleDestroy(): void;
+    checkRateLimit(toolName: string, identifier: string, config: RateLimitConfig): RateLimitResult;
+    cleanup(): void;
+    reset(toolName?: string): void;
+}

package/dist/core/rate-limiting/rate-limiter.service.js

@@ -0,0 +1,147 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var RateLimiterService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RateLimiterService = void 0;
+const common_1 = require("@nestjs/common");
+const logger_util_1 = require("../utils/logger.util");
+const sanitize_util_1 = require("../utils/sanitize.util");
+function parseTimeWindow(window) {
+    const match = window.match(/^(\d+)([smhd])$/);
+    if (!match) {
+        logger_util_1.logger.warn("RateLimiterService", `Invalid time window format: ${window}. Using default 1 minute`, {
+            component: "RateLimiter",
+            invalidWindow: window,
+        });
+        return 60 * 1000;
+    }
+    const value = parseInt(match[1], 10);
+    const unit = match[2];
+    if (isNaN(value) || value <= 0) {
+        logger_util_1.logger.warn("RateLimiterService", `Invalid time window value: ${value}. Using default 1 minute`, {
+            component: "RateLimiter",
+            invalidValue: value,
+        });
+        return 60 * 1000;
+    }
+    const multipliers = {
+        s: 1000,
+        m: 60 * 1000,
+        h: 60 * 60 * 1000,
+        d: 24 * 60 * 60 * 1000,
+    };
+    const multiplier = multipliers[unit];
+    if (!multiplier) {
+        logger_util_1.logger.warn("RateLimiterService", `Invalid time window unit: ${unit}. Using default 1 minute`, {
+            component: "RateLimiter",
+            invalidUnit: unit,
+        });
+        return 60 * 1000;
+    }
+    return value * multiplier;
+}
+let RateLimiterService = class RateLimiterService {
+    static { RateLimiterService_1 = this; }
+    rateLimiters = new Map();
+    cleanupInterval;
+    static MAX_ENTRIES_PER_TOOL = 10000;
+    static CLEANUP_INTERVAL_MS = 5 * 60 * 1000;
+    onModuleInit() {
+        this.cleanupInterval = setInterval(() => {
+            this.cleanup();
+        }, RateLimiterService_1.CLEANUP_INTERVAL_MS);
+    }
+    onModuleDestroy() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = undefined;
+        }
+    }
+    checkRateLimit(toolName, identifier, config) {
+        try {
+            const windowMs = parseTimeWindow(config.window);
+            const now = Date.now();
+            if (!this.rateLimiters.has(toolName)) {
+                this.rateLimiters.set(toolName, new Map());
+            }
+            const toolLimiter = this.rateLimiters.get(toolName);
+            if (toolLimiter.size >= RateLimiterService_1.MAX_ENTRIES_PER_TOOL) {
+                const entries = Array.from(toolLimiter.entries());
+                const expired = entries.filter(([, entry]) => entry.resetTime < now);
+                if (expired.length > 0) {
+                    expired.forEach(([id]) => toolLimiter.delete(id));
+                }
+                else {
+                    const sorted = entries.sort(([, a], [, b]) => a.resetTime - b.resetTime);
+                    const toRemove = Math.floor(sorted.length * 0.1);
+                    sorted.slice(0, toRemove).forEach(([id]) => toolLimiter.delete(id));
+                }
+            }
+            let entry = toolLimiter.get(identifier);
+            if (!entry || entry.resetTime < now) {
+                entry = {
+                    count: 0,
+                    resetTime: now + windowMs,
+                };
+                toolLimiter.set(identifier, entry);
+            }
+            if (entry.count >= config.max) {
+                return {
+                    allowed: false,
+                    remaining: 0,
+                    resetTime: entry.resetTime,
+                };
+            }
+            entry.count++;
+            return {
+                allowed: true,
+                remaining: config.max - entry.count,
+                resetTime: entry.resetTime,
+            };
+        }
+        catch (error) {
+            logger_util_1.logger.error("RateLimiterService", "Rate limit check failed", {
+                component: "RateLimiter",
+                toolName: (0, sanitize_util_1.sanitizeActorId)(toolName),
+                identifier: (0, sanitize_util_1.sanitizeActorId)(identifier),
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return {
+                allowed: false,
+                remaining: 0,
+                resetTime: Date.now() + 60000,
+            };
+        }
+    }
+    cleanup() {
+        const now = Date.now();
+        for (const [toolName, toolLimiter] of this.rateLimiters.entries()) {
+            for (const [identifier, entry] of toolLimiter.entries()) {
+                if (entry.resetTime < now) {
+                    toolLimiter.delete(identifier);
+                }
+            }
+            if (toolLimiter.size === 0) {
+                this.rateLimiters.delete(toolName);
+            }
+        }
+    }
+    reset(toolName) {
+        if (toolName) {
+            this.rateLimiters.delete(toolName);
+        }
+        else {
+            this.rateLimiters.clear();
+        }
+    }
+};
+exports.RateLimiterService = RateLimiterService;
+exports.RateLimiterService = RateLimiterService = RateLimiterService_1 = __decorate([
+    (0, common_1.Injectable)()
+], RateLimiterService);
+//# sourceMappingURL=rate-limiter.service.js.map

package/dist/core/rate-limiting/rate-limiter.service.js.map

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

package/dist/core/resilience/circuit-breaker.interface.d.ts

@@ -0,0 +1,15 @@
+export type CircuitState = "closed" | "open" | "half-open";
+export interface CircuitBreakerConfig {
+    errorThreshold: number;
+    timeWindow: number;
+    minRequests: number;
+    halfOpenTimeout: number;
+}
+export interface CircuitBreakerState {
+    state: CircuitState;
+    failures: number;
+    successes: number;
+    lastFailureTime?: number;
+    lastSuccessTime?: number;
+    nextAttemptTime?: number;
+}

package/dist/core/resilience/circuit-breaker.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=circuit-breaker.interface.js.map

package/dist/core/resilience/circuit-breaker.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.interface.js","sourceRoot":"","sources":["../../../src/core/resilience/circuit-breaker.interface.ts"],"names":[],"mappings":""}

package/dist/core/resilience/circuit-breaker.service.d.ts

@@ -0,0 +1,11 @@
+import { CircuitBreakerConfig, CircuitState } from "./circuit-breaker.interface";
+export declare class CircuitBreakerService {
+    private circuits;
+    private configs;
+    private getCircuit;
+    isOpen(toolName: string, config?: CircuitBreakerConfig): boolean;
+    recordSuccess(toolName: string): void;
+    recordFailure(toolName: string): void;
+    getState(toolName: string): CircuitState;
+    reset(toolName?: string): void;
+}