@gomcp/analytics 0.1.0

package/dist/exporters/custom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom.d.ts","sourceRoot":"","sources":["../../src/exporters/custom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE7D;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,UAAU,GACb,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAQ5C"}

package/dist/exporters/custom.js

@@ -0,0 +1,15 @@
+/**
+ * Wraps a user-provided export function, catching errors to prevent
+ * exporter failures from disrupting the MCP server.
+ */
+export function createCustomExporter(fn) {
+    return async (events) => {
+        try {
+            await fn(events);
+        }
+        catch (err) {
+            console.error("[McpAnalytics] Custom exporter error:", err);
+        }
+    };
+}
+//# sourceMappingURL=custom.js.map

package/dist/exporters/custom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom.js","sourceRoot":"","sources":["../../src/exporters/custom.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,EAAc;IAEd,OAAO,KAAK,EAAE,MAAM,EAAE,EAAE;QACtB,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC;QACnB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,uCAAuC,EAAE,GAAG,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/exporters/json.d.ts

@@ -0,0 +1,6 @@
+import type { JsonConfig, ToolCallEvent } from "../types.js";
+/**
+ * JSON exporter: appends events as JSONL (one JSON object per line) to a file.
+ */
+export declare function createJsonExporter(config: JsonConfig): (events: ToolCallEvent[]) => Promise<void>;
+//# sourceMappingURL=json.d.ts.map

package/dist/exporters/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/exporters/json.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE7D;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,UAAU,GACjB,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAM5C"}

package/dist/exporters/json.js

@@ -0,0 +1,13 @@
+import { appendFile } from "node:fs/promises";
+/**
+ * JSON exporter: appends events as JSONL (one JSON object per line) to a file.
+ */
+export function createJsonExporter(config) {
+    return async (events) => {
+        if (events.length === 0)
+            return;
+        const lines = events.map((e) => JSON.stringify(e)).join("\n") + "\n";
+        await appendFile(config.path, lines, "utf-8");
+    };
+}
+//# sourceMappingURL=json.js.map

package/dist/exporters/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/exporters/json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAI9C;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAkB;IAElB,OAAO,KAAK,EAAE,MAAM,EAAE,EAAE;QACtB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAChC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QACrE,MAAM,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC,CAAC;AACJ,CAAC"}

package/dist/exporters/otlp.d.ts

@@ -0,0 +1,9 @@
+import type { OtlpConfig, ToolCallEvent } from "../types.js";
+/**
+ * OTLP exporter: sends tool call events as OpenTelemetry spans.
+ *
+ * Uses dynamic imports so that @opentelemetry/* packages are only loaded
+ * when this exporter is actually used.
+ */
+export declare function createOtlpExporter(config: OtlpConfig): (events: ToolCallEvent[]) => Promise<void>;
+//# sourceMappingURL=otlp.d.ts.map

package/dist/exporters/otlp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otlp.d.ts","sourceRoot":"","sources":["../../src/exporters/otlp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE7D;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,UAAU,GACjB,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAgB5C"}

package/dist/exporters/otlp.js

@@ -0,0 +1,83 @@
+/**
+ * OTLP exporter: sends tool call events as OpenTelemetry spans.
+ *
+ * Uses dynamic imports so that @opentelemetry/* packages are only loaded
+ * when this exporter is actually used.
+ */
+export function createOtlpExporter(config) {
+    // Lazy-initialized tracer
+    let tracerPromise;
+    return async (events) => {
+        if (events.length === 0)
+            return;
+        if (!tracerPromise) {
+            tracerPromise = initTracer(config);
+        }
+        const tracer = await tracerPromise;
+        for (const event of events) {
+            tracer.exportEvent(event);
+        }
+        await tracer.flush();
+    };
+}
+async function initTracer(config) {
+    // Dynamic imports — these only resolve if the user has @opentelemetry installed
+    const { trace, SpanStatusCode } = await import("@opentelemetry/api");
+    let tracer;
+    let otlpExporter;
+    if (config.useGlobalProvider) {
+        // Use the global tracer provider (e.g. dd-trace registers itself here)
+        tracer = trace.getTracer("@gomcp/analytics");
+    }
+    else {
+        // Create an isolated provider with OTLP HTTP exporter
+        const { BasicTracerProvider, SimpleSpanProcessor } = await import("@opentelemetry/sdk-trace-base");
+        const { OTLPTraceExporter } = await import("@opentelemetry/exporter-trace-otlp-http");
+        otlpExporter = new OTLPTraceExporter({
+            url: config.endpoint,
+            headers: config.headers,
+        });
+        const provider = new BasicTracerProvider({
+            spanProcessors: [
+                new SimpleSpanProcessor(otlpExporter),
+            ],
+        });
+        tracer = provider.getTracer("@gomcp/analytics");
+    }
+    return {
+        exportEvent(event) {
+            const span = tracer.startSpan("mcp.tool_call", {
+                startTime: new Date(event.timestamp),
+                attributes: {
+                    "mcp.tool.name": event.toolName,
+                    "mcp.tool.duration_ms": event.durationMs,
+                    "mcp.tool.success": event.success,
+                    "mcp.tool.input_size": event.inputSize,
+                    "mcp.tool.output_size": event.outputSize,
+                    ...(event.sessionId && { "mcp.session.id": event.sessionId }),
+                    ...(event.errorMessage && {
+                        "mcp.tool.error_message": event.errorMessage,
+                    }),
+                    ...(event.errorCode !== undefined && {
+                        "mcp.tool.error_code": event.errorCode,
+                    }),
+                    ...Object.fromEntries(Object.entries(event.metadata ?? {}).map(([k, v]) => [
+                        `mcp.meta.${k}`,
+                        v,
+                    ])),
+                },
+            });
+            if (!event.success) {
+                span.setStatus({
+                    code: SpanStatusCode.ERROR,
+                    message: event.errorMessage,
+                });
+            }
+            span.end(new Date(event.timestamp + event.durationMs));
+        },
+        async flush() {
+            await otlpExporter?.forceFlush?.();
+        },
+    };
+}
+//# sourceMappingURL=otlp.js.map

package/dist/exporters/otlp.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { McpAnalytics } from "./analytics.js";
+export type { AnalyticsConfig, AnalyticsSnapshot, ExporterFn, InstrumentedTransport, JsonConfig, OtlpConfig, ToolCallEvent, ToolStats, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,qBAAqB,EACrB,UAAU,EACV,UAAU,EACV,aAAa,EACb,SAAS,GACV,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { McpAnalytics } from "./analytics.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/middleware.d.ts

@@ -0,0 +1,14 @@
+import type { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
+import type { Collector } from "./collector.js";
+import type { InstrumentedTransport } from "./types.js";
+/**
+ * Wraps a Transport to intercept tools/call requests and their responses,
+ * recording metrics to the Collector.
+ */
+export declare function instrumentTransport(transport: Transport, collector: Collector, sampleRate: number, globalMetadata?: Record<string, string>, tracing?: boolean): InstrumentedTransport;
+/**
+ * Wraps a tool handler function to record metrics.
+ * Works with McpServer.tool() callback pattern.
+ */
+export declare function wrapToolHandler<TArgs extends unknown[], TResult>(toolName: string, handler: (...args: TArgs) => TResult | Promise<TResult>, collector: Collector, sampleRate: number, globalMetadata?: Record<string, string>, tracing?: boolean): (...args: TArgs) => Promise<TResult>;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAE/E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAOhD,OAAO,KAAK,EAAiB,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAwCvE;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,MAAM,EAClB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACvC,OAAO,CAAC,EAAE,OAAO,GAChB,qBAAqB,CAwHvB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,SAAS,OAAO,EAAE,EAAE,OAAO,EAC9D,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EACvD,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,MAAM,EAClB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACvC,OAAO,CAAC,EAAE,OAAO,GAChB,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,CAiDtC"}

package/dist/middleware.js

@@ -0,0 +1,184 @@
+import { startToolSpan, endToolSpan, withSpanContext, } from "./tracing.js";
+import { byteSize } from "./utils.js";
+/**
+ * Checks if a JSON-RPC message is a request (has `id` and `method`).
+ */
+function isRequest(msg) {
+    return "id" in msg && "method" in msg;
+}
+/**
+ * Checks if a JSON-RPC message is a response with a result.
+ */
+function isResultResponse(msg) {
+    return "id" in msg && "result" in msg;
+}
+/**
+ * Checks if a JSON-RPC message is an error response.
+ */
+function isErrorResponse(msg) {
+    return "id" in msg && "error" in msg;
+}
+/**
+ * Wraps a Transport to intercept tools/call requests and their responses,
+ * recording metrics to the Collector.
+ */
+export function instrumentTransport(transport, collector, sampleRate, globalMetadata, tracing) {
+    const pending = new Map();
+    // Intercept incoming messages (requests from client)
+    const origOnMessage = transport.onmessage;
+    // We need to intercept onmessage being set (since the server sets it after we wrap)
+    // The pattern: wrap the transport so that when server sets onmessage, we inject our interceptor
+    const proxy = new Proxy(transport, {
+        // eslint-disable-next-line sonarjs/no-invariant-returns -- Proxy set traps must always return true
+        set(target, prop, value) {
+            if (prop === "onmessage" && typeof value === "function") {
+                const userHandler = value;
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                target.onmessage = (message, extra) => {
+                    // Intercept incoming tools/call requests
+                    if (isRequest(message) && message.method === "tools/call") {
+                        // eslint-disable-next-line sonarjs/pseudo-random -- intentional for perf sampling, not security
+                        if (Math.random() < sampleRate) {
+                            const params = message.params;
+                            const toolName = params?.name ?? "unknown";
+                            const inputSize = byteSize(params?.arguments);
+                            const pendingCall = {
+                                toolName,
+                                startTime: Date.now(),
+                                inputSize,
+                            };
+                            pending.set(message.id, pendingCall);
+                            // Start a tracing span (async, fire-and-forget into the pending map)
+                            if (tracing) {
+                                startToolSpan(toolName, {
+                                    "mcp.tool.input_size": inputSize,
+                                }).then((span) => {
+                                    const entry = pending.get(message.id);
+                                    if (entry && span) {
+                                        entry.tracing = span;
+                                    }
+                                });
+                            }
+                        }
+                    }
+                    userHandler(message, extra);
+                };
+                return true;
+            }
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            target[prop] = value;
+            return true;
+        },
+        get(target, prop, receiver) {
+            if (prop === "send") {
+                // Intercept outgoing messages (responses from server)
+                return async (message, options) => {
+                    if ("id" in message) {
+                        const id = message.id;
+                        const call = pending.get(id);
+                        if (call) {
+                            pending.delete(id);
+                            const success = isResultResponse(message);
+                            const errorMessage = isErrorResponse(message)
+                                ? message.error.message
+                                : undefined;
+                            let outputPayload;
+                            if (isResultResponse(message)) {
+                                outputPayload = message.result;
+                            }
+                            else if (isErrorResponse(message)) {
+                                outputPayload = message.error;
+                            }
+                            const event = {
+                                toolName: call.toolName,
+                                sessionId: target.sessionId,
+                                timestamp: call.startTime,
+                                durationMs: Date.now() - call.startTime,
+                                success,
+                                inputSize: call.inputSize,
+                                outputSize: byteSize(outputPayload),
+                                ...(isErrorResponse(message) && {
+                                    errorMessage,
+                                    errorCode: message.error
+                                        .code,
+                                }),
+                                ...(globalMetadata && { metadata: globalMetadata }),
+                            };
+                            collector.record(event);
+                            // End the tracing span
+                            if (call.tracing) {
+                                endToolSpan(call.tracing, success, errorMessage);
+                            }
+                        }
+                    }
+                    return target.send.call(target, message, options);
+                };
+            }
+            const value = Reflect.get(target, prop, receiver);
+            if (typeof value === "function") {
+                return value.bind(target);
+            }
+            return value;
+        },
+    });
+    // If onmessage was already set before we wrapped, re-apply through our proxy
+    if (origOnMessage) {
+        proxy.onmessage = origOnMessage;
+    }
+    return proxy;
+}
+/**
+ * Wraps a tool handler function to record metrics.
+ * Works with McpServer.tool() callback pattern.
+ */
+export function wrapToolHandler(toolName, handler, collector, sampleRate, globalMetadata, tracing) {
+    return async (...args) => {
+        const shouldSample = Math.random() < sampleRate; // eslint-disable-line sonarjs/pseudo-random -- intentional for perf sampling, not security
+        if (!shouldSample) {
+            return handler(...args);
+        }
+        const startTime = Date.now();
+        const inputSize = byteSize(args[0]);
+        // Start a tracing span if enabled
+        const tracingSpan = tracing
+            ? await startToolSpan(toolName, { "mcp.tool.input_size": inputSize })
+            : undefined;
+        try {
+            // Run handler within span context so downstream calls become children
+            const result = tracingSpan
+                ? await withSpanContext(tracingSpan, () => handler(...args))
+                : await handler(...args);
+            const event = {
+                toolName,
+                timestamp: startTime,
+                durationMs: Date.now() - startTime,
+                success: true,
+                inputSize,
+                outputSize: byteSize(result),
+                ...(globalMetadata && { metadata: globalMetadata }),
+            };
+            collector.record(event);
+            if (tracingSpan)
+                endToolSpan(tracingSpan, true);
+            return result;
+        }
+        catch (err) {
+            const errorMessage = err instanceof Error ? err.message : String(err);
+            const event = {
+                toolName,
+                timestamp: startTime,
+                durationMs: Date.now() - startTime,
+                success: false,
+                errorMessage,
+                inputSize,
+                outputSize: 0,
+                ...(globalMetadata && { metadata: globalMetadata }),
+            };
+            collector.record(event);
+            if (tracingSpan)
+                endToolSpan(tracingSpan, false, errorMessage);
+            throw err;
+        }
+    };
+}
+//# sourceMappingURL=middleware.js.map

package/dist/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,aAAa,EACb,WAAW,EACX,eAAe,GAEhB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;GAEG;AACH,SAAS,SAAS,CAAC,GAAmB;IAKpC,OAAO,IAAI,IAAI,GAAG,IAAI,QAAQ,IAAI,GAAG,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CACvB,GAAmB;IAEnB,OAAO,IAAI,IAAI,GAAG,IAAI,QAAQ,IAAI,GAAG,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,GAAmB;IAI1C,OAAO,IAAI,IAAI,GAAG,IAAI,OAAO,IAAI,GAAG,CAAC;AACvC,CAAC;AASD;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,SAAoB,EACpB,SAAoB,EACpB,UAAkB,EAClB,cAAuC,EACvC,OAAiB;IAEjB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAgC,CAAC;IAExD,qDAAqD;IACrD,MAAM,aAAa,GAAG,SAAS,CAAC,SAAS,CAAC;IAE1C,oFAAoF;IACpF,gGAAgG;IAChG,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,SAAS,EAAE;QACjC,mGAAmG;QACnG,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK;YACrB,IAAI,IAAI,KAAK,WAAW,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;gBACxD,MAAM,WAAW,GAAG,KAAK,CAAC;gBAC1B,8DAA8D;gBAC7D,MAAc,CAAC,SAAS,GAAG,CAC1B,OAAuB,EACvB,KAAe,EACf,EAAE;oBACF,yCAAyC;oBACzC,IAAI,SAAS,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;wBAC1D,gGAAgG;wBAChG,IAAI,IAAI,CAAC,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;4BAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,MAEV,CAAC;4BACd,MAAM,QAAQ,GAAG,MAAM,EAAE,IAAI,IAAI,SAAS,CAAC;4BAC3C,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;4BAC9C,MAAM,WAAW,GAAgB;gCAC/B,QAAQ;gCACR,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gCACrB,SAAS;6BACV,CAAC;4BACF,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;4BAErC,qEAAqE;4BACrE,IAAI,OAAO,EAAE,CAAC;gCACZ,aAAa,CAAC,QAAQ,EAAE;oCACtB,qBAAqB,EAAE,SAAS;iCACjC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;oCACf,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;oCACtC,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;wCAClB,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;oCACvB,CAAC;gCACH,CAAC,CAAC,CAAC;4BACL,CAAC;wBACH,CAAC;oBACH,CAAC;oBACD,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;gBAC9B,CAAC,CAAC;gBACF,OAAO,IAAI,CAAC;YACd,CAAC;YACD,8DAA8D;YAC7D,MAAc,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;YAC9B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ;YACxB,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;gBACpB,sDAAsD;gBACtD,OAAO,KAAK,EAAE,OAAuB,EAAE,OAAiB,EAAE,EAAE;oBAC1D,IAAI,IAAI,IAAI,OAAO,EAAE,CAAC;wBACpB,MAAM,EAAE,GAAI,OAAmC,CAAC,EAAE,CAAC;wBACnD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;wBAC7B,IAAI,IAAI,EAAE,CAAC;4BACT,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;4BACnB,MAAM,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;4BAC1C,MAAM,YAAY,GAAG,eAAe,CAAC,OAAO,CAAC;gCAC3C,CAAC,CAAE,OAA0C,CAAC,KAAK,CAAC,OAAO;gCAC3D,CAAC,CAAC,SAAS,CAAC;4BAEd,IAAI,aAAsB,CAAC;4BAC3B,IAAI,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;gCAC9B,aAAa,GAAI,OAA+B,CAAC,MAAM,CAAC;4BAC1D,CAAC;iCAAM,IAAI,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;gCACpC,aAAa,GAAI,OAA8B,CAAC,KAAK,CAAC;4BACxD,CAAC;4BAED,MAAM,KAAK,GAAkB;gCAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;gCACvB,SAAS,EAAE,MAAM,CAAC,SAAS;gCAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;gCACzB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS;gCACvC,OAAO;gCACP,SAAS,EAAE,IAAI,CAAC,SAAS;gCACzB,UAAU,EAAE,QAAQ,CAAC,aAAa,CAAC;gCACnC,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,IAAI;oCAC9B,YAAY;oCACZ,SAAS,EAAG,OAAuC,CAAC,KAAK;yCACtD,IAAI;iCACR,CAAC;gCACF,GAAG,CAAC,cAAc,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;6BACpD,CAAC;4BACF,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;4BAExB,uBAAuB;4BACvB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gCACjB,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;4BACnD,CAAC;wBACH,CAAC;oBACH,CAAC;oBACD,OAAQ,MAAM,CAAC,IAAwC,CAAC,IAAI,CAC1D,MAAM,EACN,OAAO,EACP,OAAO,CACR,CAAC;gBACJ,CAAC,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;YAClD,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;gBAChC,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC5B,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;KACF,CAAC,CAAC;IAEH,6EAA6E;IAC7E,IAAI,aAAa,EAAE,CAAC;QAClB,KAAK,CAAC,SAAS,GAAG,aAAa,CAAC;IAClC,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAgB,EAChB,OAAuD,EACvD,SAAoB,EACpB,UAAkB,EAClB,cAAuC,EACvC,OAAiB;IAEjB,OAAO,KAAK,EAAE,GAAG,IAAW,EAAE,EAAE;QAC9B,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,2FAA2F;QAC5I,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;QAC1B,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAEpC,kCAAkC;QAClC,MAAM,WAAW,GAAG,OAAO;YACzB,CAAC,CAAC,MAAM,aAAa,CAAC,QAAQ,EAAE,EAAE,qBAAqB,EAAE,SAAS,EAAE,CAAC;YACrE,CAAC,CAAC,SAAS,CAAC;QAEd,IAAI,CAAC;YACH,sEAAsE;YACtE,MAAM,MAAM,GAAG,WAAW;gBACxB,CAAC,CAAC,MAAM,eAAe,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;gBAC5D,CAAC,CAAC,MAAM,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;YAC3B,MAAM,KAAK,GAAkB;gBAC3B,QAAQ;gBACR,SAAS,EAAE,SAAS;gBACpB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;gBAClC,OAAO,EAAE,IAAI;gBACb,SAAS;gBACT,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC;gBAC5B,GAAG,CAAC,cAAc,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;aACpD,CAAC;YACF,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACxB,IAAI,WAAW;gBAAE,WAAW,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;YAChD,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,YAAY,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACtE,MAAM,KAAK,GAAkB;gBAC3B,QAAQ;gBACR,SAAS,EAAE,SAAS;gBACpB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;gBAClC,OAAO,EAAE,KAAK;gBACd,YAAY;gBACZ,SAAS;gBACT,UAAU,EAAE,CAAC;gBACb,GAAG,CAAC,cAAc,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;aACpD,CAAC;YACF,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACxB,IAAI,WAAW;gBAAE,WAAW,CAAC,WAAW,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;YAC/D,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/tracing.d.ts

@@ -0,0 +1,37 @@
+/**
+ * OpenTelemetry span helpers for MCP tool call tracing.
+ *
+ * Uses dynamic import so @opentelemetry/api is only loaded when tracing is enabled.
+ * When dd-trace (or any OTel-based APM) is configured as the global tracer provider,
+ * spans created here automatically appear as children in the existing trace context.
+ */
+type Attribute = string | number | boolean;
+interface OtelSpan {
+    setAttribute(key: string, value: Attribute): void;
+    setStatus(status: {
+        code: number;
+        message?: string;
+    }): void;
+    end(): void;
+}
+type OtelContext = Record<string, unknown>;
+export interface TracingSpan {
+    span: OtelSpan;
+    context: OtelContext;
+}
+/**
+ * Start an OpenTelemetry span for a tool call using the global tracer provider.
+ * Returns undefined if @opentelemetry/api is not available.
+ */
+export declare function startToolSpan(toolName: string, attributes?: Record<string, Attribute>): Promise<TracingSpan | undefined>;
+/**
+ * End a tool span, setting error status if the call failed.
+ */
+export declare function endToolSpan(tracing: TracingSpan, success: boolean, errorMessage?: string): void;
+/**
+ * Run a function within the context of a span, so downstream OTel-instrumented
+ * calls become children of this span.
+ */
+export declare function withSpanContext<T>(tracing: TracingSpan, fn: () => T | Promise<T>): Promise<T>;
+export {};
+//# sourceMappingURL=tracing.d.ts.map

package/dist/tracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../src/tracing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAI3C,UAAU,QAAQ;IAChB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IAClD,SAAS,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5D,GAAG,IAAI,IAAI,CAAC;CACb;AAED,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAsC3C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,WAAW,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GACrC,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAalC;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,OAAO,EAChB,YAAY,CAAC,EAAE,MAAM,GACpB,IAAI,CAQN;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACrC,OAAO,EAAE,WAAW,EACpB,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACvB,OAAO,CAAC,CAAC,CAAC,CAIZ"}

package/dist/tracing.js

@@ -0,0 +1,67 @@
+/**
+ * OpenTelemetry span helpers for MCP tool call tracing.
+ *
+ * Uses dynamic import so @opentelemetry/api is only loaded when tracing is enabled.
+ * When dd-trace (or any OTel-based APM) is configured as the global tracer provider,
+ * spans created here automatically appear as children in the existing trace context.
+ */
+let otelApi;
+let otelLoadFailed = false;
+/**
+ * Lazily load @opentelemetry/api. Returns undefined if the package is not installed.
+ */
+async function getOtelApi() {
+    if (otelApi)
+        return otelApi;
+    if (otelLoadFailed)
+        return undefined;
+    try {
+        const api = await import("@opentelemetry/api");
+        otelApi = api;
+        return otelApi;
+    }
+    catch {
+        otelLoadFailed = true;
+        return undefined;
+    }
+}
+/**
+ * Start an OpenTelemetry span for a tool call using the global tracer provider.
+ * Returns undefined if @opentelemetry/api is not available.
+ */
+export async function startToolSpan(toolName, attributes) {
+    const api = await getOtelApi();
+    if (!api)
+        return undefined;
+    const tracer = api.trace.getTracer("@gomcp/analytics");
+    const span = tracer.startSpan("mcp.tool_call", {
+        attributes: {
+            "mcp.tool.name": toolName,
+            ...attributes,
+        },
+    });
+    return { span, context: api.context.active() };
+}
+/**
+ * End a tool span, setting error status if the call failed.
+ */
+export function endToolSpan(tracing, success, errorMessage) {
+    if (!success && otelApi) {
+        tracing.span.setStatus({
+            code: otelApi.SpanStatusCode.ERROR,
+            message: errorMessage,
+        });
+    }
+    tracing.span.end();
+}
+/**
+ * Run a function within the context of a span, so downstream OTel-instrumented
+ * calls become children of this span.
+ */
+export async function withSpanContext(tracing, fn) {
+    const api = otelApi;
+    if (!api)
+        return fn();
+    return api.context.with(tracing.context, fn);
+}
+//# sourceMappingURL=tracing.js.map

package/dist/tracing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.js","sourceRoot":"","sources":["../src/tracing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA8BH,IAAI,OAA4B,CAAC;AACjC,IAAI,cAAc,GAAG,KAAK,CAAC;AAE3B;;GAEG;AACH,KAAK,UAAU,UAAU;IACvB,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAC5B,IAAI,cAAc;QAAE,OAAO,SAAS,CAAC;IAErC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAC/C,OAAO,GAAG,GAAyB,CAAC;QACpC,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,cAAc,GAAG,IAAI,CAAC;QACtB,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAOD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAgB,EAChB,UAAsC;IAEtC,MAAM,GAAG,GAAG,MAAM,UAAU,EAAE,CAAC;IAC/B,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAE3B,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,eAAe,EAAE;QAC7C,UAAU,EAAE;YACV,eAAe,EAAE,QAAQ;YACzB,GAAG,UAAU;SACd;KACF,CAAC,CAAC;IAEH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CACzB,OAAoB,EACpB,OAAgB,EAChB,YAAqB;IAErB,IAAI,CAAC,OAAO,IAAI,OAAO,EAAE,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;YACrB,IAAI,EAAE,OAAO,CAAC,cAAc,CAAC,KAAK;YAClC,OAAO,EAAE,YAAY;SACtB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAoB,EACpB,EAAwB;IAExB,MAAM,GAAG,GAAG,OAAO,CAAC;IACpB,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,EAAE,CAAC;IACtB,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAC/C,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,98 @@
+import type { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
+/**
+ * A single tool call event recorded by the collector.
+ */
+export interface ToolCallEvent {
+    /** Tool name from the tools/call request */
+    toolName: string;
+    /** Session ID from the transport, if available */
+    sessionId?: string;
+    /** Unix timestamp in milliseconds when the call started */
+    timestamp: number;
+    /** Duration in milliseconds */
+    durationMs: number;
+    /** Whether the call completed successfully */
+    success: boolean;
+    /** Error message if the call failed */
+    errorMessage?: string;
+    /** JSON-RPC error code if applicable */
+    errorCode?: number;
+    /** Size of serialized input arguments in bytes */
+    inputSize: number;
+    /** Size of serialized output in bytes */
+    outputSize: number;
+    /** User-provided metadata */
+    metadata?: Record<string, string>;
+}
+/**
+ * Aggregated stats for a single tool.
+ */
+export interface ToolStats {
+    count: number;
+    errorCount: number;
+    errorRate: number;
+    p50Ms: number;
+    p95Ms: number;
+    p99Ms: number;
+    avgMs: number;
+    lastCalledAt: number;
+}
+/**
+ * Snapshot of all analytics data.
+ */
+export interface AnalyticsSnapshot {
+    totalCalls: number;
+    totalErrors: number;
+    errorRate: number;
+    uptimeMs: number;
+    tools: Record<string, ToolStats>;
+}
+/**
+ * Custom exporter function signature.
+ */
+export type ExporterFn = (events: ToolCallEvent[]) => Promise<void>;
+/**
+ * OTLP exporter configuration.
+ */
+export interface OtlpConfig {
+    endpoint: string;
+    headers?: Record<string, string>;
+    /** When true, use the global TracerProvider instead of creating an isolated one.
+     *  This is useful when dd-trace or another APM registers as the global OTel provider. */
+    useGlobalProvider?: boolean;
+}
+/**
+ * JSON file exporter configuration.
+ */
+export interface JsonConfig {
+    path: string;
+}
+/**
+ * Configuration for McpAnalytics.
+ */
+export interface AnalyticsConfig {
+    /** Built-in exporter name or a custom export function */
+    exporter: "console" | "json" | "otlp" | ExporterFn;
+    /** OTLP configuration (required when exporter is "otlp") */
+    otlp?: OtlpConfig;
+    /** JSON file configuration (required when exporter is "json") */
+    json?: JsonConfig;
+    /** Fraction of calls to sample (0.0 to 1.0). Default: 1.0 */
+    sampleRate?: number;
+    /** How often to flush batched events in ms. Default: 5000 */
+    flushIntervalMs?: number;
+    /** Maximum events to keep in the ring buffer. Default: 10000 */
+    maxBufferSize?: number;
+    /** User-provided metadata added to every event */
+    metadata?: Record<string, string>;
+    /** Enable OpenTelemetry span creation during tool execution.
+     *  When true, uses the global tracer provider (compatible with dd-trace, etc.)
+     *  Default: false */
+    tracing?: boolean;
+}
+/**
+ * A transport that has been instrumented with analytics.
+ * Same interface as Transport — can be used anywhere a Transport is expected.
+ */
+export type InstrumentedTransport = Transport;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAE/E;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;6FACyF;IACzF,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,QAAQ,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;IACnD,4DAA4D;IAC5D,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,iEAAiE;IACjE,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC;;yBAEqB;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,SAAS,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/utils.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Returns the byte length of a string (UTF-8).
+ */
+export declare function byteSize(value: unknown): number;
+/**
+ * Compute a percentile from a sorted array of numbers.
+ * Uses linear interpolation between the closest ranks.
+ */
+export declare function percentile(sorted: number[], p: number): number;
+/**
+ * Insert a value into an already-sorted array (ascending), maintaining sort order.
+ */
+export declare function sortedInsert(arr: number[], value: number): void;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAI/C;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAY9D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAY/D"}