@typokit/otel 0.1.4

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { StructuredLogger } from "./logger.js";
+export { redactFields } from "./redact.js";
+export { OtelLogSink, createOtelLogSink } from "./log-bridge.js";
+export { Tracer, Span, ConsoleSpanExporter, OtlpSpanExporter, NoopSpanExporter, createRequestTracer, resolveTracingConfig, createExporter, generateTraceId, generateSpanId, } from "./tracing.js";
+export { MetricsCollector, ConsoleMetricExporter, OtlpMetricExporter, NoopMetricExporter, resolveMetricsConfig, createMetricExporter, createMetricsCollector, } from "./metrics.js";
+export type { LogLevel, LogEntry, LoggingConfig, LogSink, LogMetadata, SpanData, SpanStatus, SpanExporter, TracingConfig, TelemetryConfig, MetricsConfig, MetricLabels, MetricData, MetricExporter, HistogramDataPoint, GaugeDataPoint, CounterDataPoint, } 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":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EACL,MAAM,EACN,IAAI,EACJ,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,OAAO,EACP,WAAW,EACX,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,aAAa,EACb,eAAe,EACf,aAAa,EACb,YAAY,EACZ,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+// @typokit/otel — Structured Logger & Observability
+export { StructuredLogger } from "./logger.js";
+export { redactFields } from "./redact.js";
+export { OtelLogSink, createOtelLogSink } from "./log-bridge.js";
+export { Tracer, Span, ConsoleSpanExporter, OtlpSpanExporter, NoopSpanExporter, createRequestTracer, resolveTracingConfig, createExporter, generateTraceId, generateSpanId, } from "./tracing.js";
+export { MetricsCollector, ConsoleMetricExporter, OtlpMetricExporter, NoopMetricExporter, resolveMetricsConfig, createMetricExporter, createMetricsCollector, } from "./metrics.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,oDAAoD;AAEpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EACL,MAAM,EACN,IAAI,EACJ,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,cAAc,CAAC"}

package/dist/log-bridge.d.ts

@@ -0,0 +1,22 @@
+import type { LogEntry, LogSink, TelemetryConfig } from "./types.js";
+/**
+ * OTel log sink that pushes structured log entries to an OTLP-compatible
+ * collector via HTTP POST. Includes trace context (traceId, spanId) for
+ * correlation with distributed traces.
+ */
+export declare class OtelLogSink implements LogSink {
+    private readonly endpoint;
+    private readonly serviceName;
+    constructor(options?: {
+        endpoint?: string;
+        serviceName?: string;
+    });
+    write(entry: LogEntry): void;
+    private buildAttributes;
+}
+/**
+ * Creates an OtelLogSink if tracing is configured and enabled.
+ * Returns undefined if tracing is not configured (opt-in behavior).
+ */
+export declare function createOtelLogSink(telemetry?: TelemetryConfig): OtelLogSink | undefined;
+//# sourceMappingURL=log-bridge.d.ts.map

package/dist/log-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-bridge.d.ts","sourceRoot":"","sources":["../src/log-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAsBrE;;;;GAIG;AACH,qBAAa,WAAY,YAAW,OAAO;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE;IAKjE,KAAK,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAuD5B,OAAO,CAAC,eAAe;CAoCxB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,CAAC,EAAE,eAAe,GAC1B,WAAW,GAAG,SAAS,CAczB"}

package/dist/log-bridge.js

@@ -0,0 +1,128 @@
+import { resolveTracingConfig } from "./tracing.js";
+// OTel severity numbers per spec (https://opentelemetry.io/docs/specs/otel/logs/data-model/#severity-fields)
+const SEVERITY_NUMBER = {
+    trace: 1,
+    debug: 5,
+    info: 9,
+    warn: 13,
+    error: 17,
+    fatal: 21,
+};
+const SEVERITY_TEXT = {
+    trace: "TRACE",
+    debug: "DEBUG",
+    info: "INFO",
+    warn: "WARN",
+    error: "ERROR",
+    fatal: "FATAL",
+};
+/**
+ * OTel log sink that pushes structured log entries to an OTLP-compatible
+ * collector via HTTP POST. Includes trace context (traceId, spanId) for
+ * correlation with distributed traces.
+ */
+export class OtelLogSink {
+    endpoint;
+    serviceName;
+    constructor(options) {
+        this.endpoint = options?.endpoint ?? "http://localhost:4318/v1/logs";
+        this.serviceName = options?.serviceName ?? "typokit";
+    }
+    write(entry) {
+        const fetchFn = globalThis.fetch;
+        if (!fetchFn)
+            return;
+        const timeUnixNano = new Date(entry.timestamp).getTime() * 1_000_000;
+        const attributes = this.buildAttributes(entry);
+        const logRecord = {
+            timeUnixNano,
+            severityNumber: SEVERITY_NUMBER[entry.level] ?? 9,
+            severityText: SEVERITY_TEXT[entry.level] ?? "INFO",
+            body: { stringValue: entry.message },
+            attributes,
+        };
+        // Include trace context for correlation
+        if (entry.traceId) {
+            logRecord["traceId"] = entry.traceId;
+        }
+        if (entry.data?.["spanId"]) {
+            logRecord["spanId"] = String(entry.data["spanId"]);
+        }
+        const payload = {
+            resourceLogs: [
+                {
+                    resource: {
+                        attributes: [
+                            { key: "service.name", value: { stringValue: this.serviceName } },
+                        ],
+                    },
+                    scopeLogs: [
+                        {
+                            scope: { name: "@typokit/otel" },
+                            logRecords: [logRecord],
+                        },
+                    ],
+                },
+            ],
+        };
+        // Fire-and-forget POST to OTLP endpoint
+        fetchFn(this.endpoint, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(payload),
+        }).catch(() => {
+            // Silently ignore export failures
+        });
+    }
+    buildAttributes(entry) {
+        const attrs = [];
+        if (entry.route) {
+            attrs.push({ key: "route", value: { stringValue: entry.route } });
+        }
+        if (entry.phase) {
+            attrs.push({ key: "phase", value: { stringValue: entry.phase } });
+        }
+        if (entry.requestId) {
+            attrs.push({ key: "requestId", value: { stringValue: entry.requestId } });
+        }
+        if (entry.serverAdapter) {
+            attrs.push({
+                key: "serverAdapter",
+                value: { stringValue: entry.serverAdapter },
+            });
+        }
+        // Include any extra data fields as attributes
+        if (entry.data) {
+            for (const [key, val] of Object.entries(entry.data)) {
+                if (key === "spanId")
+                    continue; // Already used as top-level field
+                if (val !== undefined && val !== null) {
+                    attrs.push({
+                        key: `data.${key}`,
+                        value: { stringValue: String(val) },
+                    });
+                }
+            }
+        }
+        return attrs;
+    }
+}
+/**
+ * Creates an OtelLogSink if tracing is configured and enabled.
+ * Returns undefined if tracing is not configured (opt-in behavior).
+ */
+export function createOtelLogSink(telemetry) {
+    if (!telemetry)
+        return undefined;
+    const tracingConfig = resolveTracingConfig(telemetry);
+    if (!tracingConfig.enabled)
+        return undefined;
+    const endpoint = tracingConfig.endpoint
+        ? tracingConfig.endpoint.replace(/\/v1\/traces\/?$/, "/v1/logs")
+        : "http://localhost:4318/v1/logs";
+    return new OtelLogSink({
+        endpoint,
+        serviceName: tracingConfig.serviceName,
+    });
+}
+//# sourceMappingURL=log-bridge.js.map

package/dist/log-bridge.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,28 @@
+import type { Logger } from "@typokit/types";
+import type { LogEntry, LoggingConfig, LogMetadata, LogSink } from "./types.js";
+/** Default sink: writes structured JSON to stdout */
+export declare class StdoutSink implements LogSink {
+    write(entry: LogEntry): void;
+}
+/**
+ * StructuredLogger implements the Logger interface from @typokit/types.
+ * Automatically enriches log entries with request metadata and supports
+ * field redaction and configurable log levels.
+ */
+export declare class StructuredLogger implements Logger {
+    private readonly minLevel;
+    private readonly redactPatterns;
+    private readonly metadata;
+    private readonly sinks;
+    constructor(config?: LoggingConfig, metadata?: LogMetadata, sinks?: LogSink[]);
+    trace(message: string, data?: Record<string, unknown>): void;
+    debug(message: string, data?: Record<string, unknown>): void;
+    info(message: string, data?: Record<string, unknown>): void;
+    warn(message: string, data?: Record<string, unknown>): void;
+    error(message: string, data?: Record<string, unknown>): void;
+    fatal(message: string, data?: Record<string, unknown>): void;
+    /** Create a child logger with additional/overridden metadata */
+    child(metadata: Partial<LogMetadata>): StructuredLogger;
+    private log;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAEV,QAAQ,EACR,aAAa,EACb,WAAW,EACX,OAAO,EACR,MAAM,YAAY,CAAC;AAIpB,qDAAqD;AACrD,qBAAa,UAAW,YAAW,OAAO;IACxC,KAAK,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;CAY7B;AAoBD;;;;GAIG;AACH,qBAAa,gBAAiB,YAAW,MAAM;IAC7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAW;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;gBAGhC,MAAM,CAAC,EAAE,aAAa,EACtB,QAAQ,CAAC,EAAE,WAAW,EACtB,KAAK,CAAC,EAAE,OAAO,EAAE;IASnB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D,gEAAgE;IAChE,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,gBAAgB;IAWvD,OAAO,CAAC,GAAG;CAsCZ"}

package/dist/logger.js

@@ -0,0 +1,100 @@
+import { LOG_LEVELS } from "./types.js";
+import { redactFields } from "./redact.js";
+/** Default sink: writes structured JSON to stdout */
+export class StdoutSink {
+    write(entry) {
+        const output = JSON.stringify(entry);
+        // Use globalThis to avoid @types/node dependency
+        const proc = globalThis.process;
+        if (proc?.stdout?.write) {
+            proc.stdout.write(output + "\n");
+        }
+    }
+}
+const LEVEL_PRIORITY = {
+    trace: 0,
+    debug: 1,
+    info: 2,
+    warn: 3,
+    error: 4,
+    fatal: 5,
+};
+function isProduction() {
+    const proc = globalThis.process;
+    return proc?.env?.["NODE_ENV"] === "production";
+}
+/**
+ * StructuredLogger implements the Logger interface from @typokit/types.
+ * Automatically enriches log entries with request metadata and supports
+ * field redaction and configurable log levels.
+ */
+export class StructuredLogger {
+    minLevel;
+    redactPatterns;
+    metadata;
+    sinks;
+    constructor(config, metadata, sinks) {
+        const defaultLevel = isProduction() ? "info" : "debug";
+        this.minLevel = LEVEL_PRIORITY[config?.level ?? defaultLevel];
+        this.redactPatterns = config?.redact ?? [];
+        this.metadata = metadata ?? {};
+        this.sinks = sinks ?? [new StdoutSink()];
+    }
+    trace(message, data) {
+        this.log("trace", message, data);
+    }
+    debug(message, data) {
+        this.log("debug", message, data);
+    }
+    info(message, data) {
+        this.log("info", message, data);
+    }
+    warn(message, data) {
+        this.log("warn", message, data);
+    }
+    error(message, data) {
+        this.log("error", message, data);
+    }
+    fatal(message, data) {
+        this.log("fatal", message, data);
+    }
+    /** Create a child logger with additional/overridden metadata */
+    child(metadata) {
+        return new StructuredLogger({
+            level: LOG_LEVELS[this.minLevel],
+            redact: this.redactPatterns,
+        }, { ...this.metadata, ...metadata }, this.sinks);
+    }
+    log(level, message, data) {
+        if (LEVEL_PRIORITY[level] < this.minLevel)
+            return;
+        const redactedData = data && this.redactPatterns.length > 0
+            ? redactFields(data, this.redactPatterns)
+            : data;
+        const entry = {
+            level,
+            message,
+            timestamp: new Date().toISOString(),
+            ...(redactedData !== undefined ? { data: redactedData } : {}),
+            ...(this.metadata.traceId !== undefined
+                ? { traceId: this.metadata.traceId }
+                : {}),
+            ...(this.metadata.route !== undefined
+                ? { route: this.metadata.route }
+                : {}),
+            ...(this.metadata.phase !== undefined
+                ? { phase: this.metadata.phase }
+                : {}),
+            ...(this.metadata.requestId !== undefined
+                ? { requestId: this.metadata.requestId }
+                : {}),
+            ...(this.metadata.serverAdapter !== undefined
+                ? { serverAdapter: this.metadata.serverAdapter }
+                : {}),
+        };
+        for (const sink of this.sinks) {
+            sink.write(entry);
+        }
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/metrics.d.ts

@@ -0,0 +1,62 @@
+import type { MetricsConfig, MetricLabels, MetricData, MetricExporter, HistogramDataPoint, CounterDataPoint, TelemetryConfig } from "./types.js";
+/** Exports metrics to stdout as structured JSON (dev mode) */
+export declare class ConsoleMetricExporter implements MetricExporter {
+    export(metrics: MetricData[]): void;
+}
+/** No-op exporter that silently discards metrics */
+export declare class NoopMetricExporter implements MetricExporter {
+    export(_metrics: MetricData[]): void;
+}
+/** Exports metrics to an OTLP-compatible HTTP endpoint */
+export declare class OtlpMetricExporter implements MetricExporter {
+    private readonly endpoint;
+    constructor(endpoint?: string);
+    export(metrics: MetricData[]): void;
+}
+/**
+ * MetricsCollector records and stores request metrics.
+ * It manages three metric instruments:
+ * - http.server.request.duration (histogram) — request latency in ms
+ * - http.server.active_requests (gauge) — currently in-flight requests
+ * - http.server.error_count (counter) — error responses (status >= 400)
+ */
+export declare class MetricsCollector {
+    private readonly enabled;
+    private readonly exporter;
+    private readonly serviceName;
+    private readonly durations;
+    private readonly errors;
+    private activeRequests;
+    private readonly activeGaugeSnapshots;
+    constructor(options?: {
+        enabled?: boolean;
+        exporter?: MetricExporter;
+        serviceName?: string;
+    });
+    /** Record the start of a request (increments active_requests gauge) */
+    requestStart(): void;
+    /** Record the end of a request with its duration and labels */
+    requestEnd(labels: MetricLabels, durationMs: number): void;
+    /** Get current active request count */
+    getActiveRequests(): number;
+    /** Get the service name */
+    getServiceName(): string;
+    /** Get all recorded duration data points */
+    getDurations(): HistogramDataPoint[];
+    /** Get all recorded error counter data points */
+    getErrors(): CounterDataPoint[];
+    /** Flush all collected metrics to the exporter */
+    flush(): void;
+    /** Reset all collected metrics */
+    reset(): void;
+}
+/** Resolves a TelemetryConfig into a normalized MetricsConfig */
+export declare function resolveMetricsConfig(telemetry?: TelemetryConfig): MetricsConfig;
+/** Creates the appropriate MetricExporter from config */
+export declare function createMetricExporter(config: MetricsConfig): MetricExporter;
+/**
+ * Creates a MetricsCollector configured from TelemetryConfig.
+ * This is the main entry point for request-level metrics.
+ */
+export declare function createMetricsCollector(telemetry?: TelemetryConfig, exporterOverride?: MetricExporter): MetricsCollector;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,UAAU,EACV,cAAc,EACd,kBAAkB,EAElB,gBAAgB,EAChB,eAAe,EAChB,MAAM,YAAY,CAAC;AAIpB,8DAA8D;AAC9D,qBAAa,qBAAsB,YAAW,cAAc;IAC1D,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI;CAapC;AAED,oDAAoD;AACpD,qBAAa,kBAAmB,YAAW,cAAc;IACvD,MAAM,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,IAAI;CAGrC;AAED,0DAA0D;AAC1D,qBAAa,kBAAmB,YAAW,cAAc;IACvD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,QAAQ,CAAC,EAAE,MAAM;IAI7B,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI;CA4EpC;AAuBD;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IAErC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4B;IACtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAwB;gBAEjD,OAAO,CAAC,EAAE;QACpB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,QAAQ,CAAC,EAAE,cAAc,CAAC;QAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB;IAMD,uEAAuE;IACvE,YAAY,IAAI,IAAI;IAKpB,+DAA+D;IAC/D,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IA+B1D,uCAAuC;IACvC,iBAAiB,IAAI,MAAM;IAI3B,2BAA2B;IAC3B,cAAc,IAAI,MAAM;IAIxB,4CAA4C;IAC5C,YAAY,IAAI,kBAAkB,EAAE;IAIpC,iDAAiD;IACjD,SAAS,IAAI,gBAAgB,EAAE;IAI/B,kDAAkD;IAClD,KAAK,IAAI,IAAI;IAkCb,kCAAkC;IAClC,KAAK,IAAI,IAAI;CAMd;AAID,iEAAiE;AACjE,wBAAgB,oBAAoB,CAClC,SAAS,CAAC,EAAE,eAAe,GAC1B,aAAa,CA6Bf;AAED,yDAAyD;AACzD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,cAAc,CAQ1E;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,CAAC,EAAE,eAAe,EAC3B,gBAAgB,CAAC,EAAE,cAAc,GAChC,gBAAgB,CASlB"}

package/dist/metrics.js

@@ -0,0 +1,260 @@
+// ─── Metric Exporters ────────────────────────────────────────
+/** Exports metrics to stdout as structured JSON (dev mode) */
+export class ConsoleMetricExporter {
+    export(metrics) {
+        const proc = globalThis.process;
+        for (const metric of metrics) {
+            const output = JSON.stringify({ ...metric, exportKind: "metric" });
+            if (proc?.stdout?.write) {
+                proc.stdout.write(output + "\n");
+            }
+        }
+    }
+}
+/** No-op exporter that silently discards metrics */
+export class NoopMetricExporter {
+    export(_metrics) {
+        // intentionally empty
+    }
+}
+/** Exports metrics to an OTLP-compatible HTTP endpoint */
+export class OtlpMetricExporter {
+    endpoint;
+    constructor(endpoint) {
+        this.endpoint = endpoint ?? "http://localhost:4318/v1/metrics";
+    }
+    export(metrics) {
+        const fetchFn = globalThis.fetch;
+        if (fetchFn) {
+            const payload = {
+                resourceMetrics: [
+                    {
+                        resource: { attributes: [] },
+                        scopeMetrics: [
+                            {
+                                scope: { name: "@typokit/otel" },
+                                metrics: metrics.map((m) => ({
+                                    name: m.name,
+                                    ...(m.type === "histogram"
+                                        ? {
+                                            histogram: {
+                                                dataPoints: m.dataPoints.map((dp) => ({
+                                                    attributes: labelsToAttributes(dp.labels),
+                                                    startTimeUnixNano: new Date(dp.timestamp).getTime() * 1_000_000,
+                                                    timeUnixNano: new Date(dp.timestamp).getTime() * 1_000_000,
+                                                    sum: dp.value,
+                                                    count: 1,
+                                                })),
+                                            },
+                                        }
+                                        : m.type === "gauge"
+                                            ? {
+                                                gauge: {
+                                                    dataPoints: m.dataPoints.map((dp) => ({
+                                                        attributes: labelsToAttributes(dp.labels),
+                                                        timeUnixNano: new Date(dp.timestamp).getTime() * 1_000_000,
+                                                        asInt: dp.value,
+                                                    })),
+                                                },
+                                            }
+                                            : {
+                                                sum: {
+                                                    dataPoints: m.dataPoints.map((dp) => ({
+                                                        attributes: labelsToAttributes(dp.labels),
+                                                        startTimeUnixNano: new Date(dp.timestamp).getTime() * 1_000_000,
+                                                        timeUnixNano: new Date(dp.timestamp).getTime() * 1_000_000,
+                                                        asInt: dp.value,
+                                                    })),
+                                                    isMonotonic: true,
+                                                },
+                                            }),
+                                })),
+                            },
+                        ],
+                    },
+                ],
+            };
+            fetchFn(this.endpoint, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify(payload),
+            }).catch(() => {
+                // Silently ignore export failures
+            });
+        }
+    }
+}
+function labelsToAttributes(labels) {
+    const attrs = [];
+    if (labels.route !== undefined) {
+        attrs.push({ key: "http.route", value: { stringValue: labels.route } });
+    }
+    if (labels.method !== undefined) {
+        attrs.push({ key: "http.method", value: { stringValue: labels.method } });
+    }
+    if (labels.status !== undefined) {
+        attrs.push({ key: "http.status_code", value: { intValue: labels.status } });
+    }
+    return attrs;
+}
+// ─── Metrics Collector ───────────────────────────────────────
+/**
+ * MetricsCollector records and stores request metrics.
+ * It manages three metric instruments:
+ * - http.server.request.duration (histogram) — request latency in ms
+ * - http.server.active_requests (gauge) — currently in-flight requests
+ * - http.server.error_count (counter) — error responses (status >= 400)
+ */
+export class MetricsCollector {
+    enabled;
+    exporter;
+    serviceName;
+    durations = [];
+    errors = [];
+    activeRequests = 0;
+    activeGaugeSnapshots = [];
+    constructor(options) {
+        this.enabled = options?.enabled ?? true;
+        this.exporter = options?.exporter ?? new NoopMetricExporter();
+        this.serviceName = options?.serviceName ?? "typokit";
+    }
+    /** Record the start of a request (increments active_requests gauge) */
+    requestStart() {
+        if (!this.enabled)
+            return;
+        this.activeRequests++;
+    }
+    /** Record the end of a request with its duration and labels */
+    requestEnd(labels, durationMs) {
+        if (!this.enabled)
+            return;
+        this.activeRequests = Math.max(0, this.activeRequests - 1);
+        const timestamp = new Date().toISOString();
+        // Record duration histogram data point
+        this.durations.push({
+            labels,
+            value: durationMs,
+            timestamp,
+        });
+        // Record active requests gauge snapshot
+        this.activeGaugeSnapshots.push({
+            labels: {},
+            value: this.activeRequests,
+            timestamp,
+        });
+        // Record error counter if status >= 400
+        if (labels.status >= 400) {
+            this.errors.push({
+                labels,
+                value: 1,
+                timestamp,
+            });
+        }
+    }
+    /** Get current active request count */
+    getActiveRequests() {
+        return this.activeRequests;
+    }
+    /** Get the service name */
+    getServiceName() {
+        return this.serviceName;
+    }
+    /** Get all recorded duration data points */
+    getDurations() {
+        return [...this.durations];
+    }
+    /** Get all recorded error counter data points */
+    getErrors() {
+        return [...this.errors];
+    }
+    /** Flush all collected metrics to the exporter */
+    flush() {
+        if (!this.enabled)
+            return;
+        const metrics = [];
+        if (this.durations.length > 0) {
+            metrics.push({
+                name: "http.server.request.duration",
+                type: "histogram",
+                dataPoints: [...this.durations],
+            });
+        }
+        if (this.activeGaugeSnapshots.length > 0) {
+            metrics.push({
+                name: "http.server.active_requests",
+                type: "gauge",
+                dataPoints: [...this.activeGaugeSnapshots],
+            });
+        }
+        if (this.errors.length > 0) {
+            metrics.push({
+                name: "http.server.error_count",
+                type: "counter",
+                dataPoints: [...this.errors],
+            });
+        }
+        if (metrics.length > 0) {
+            this.exporter.export(metrics);
+        }
+    }
+    /** Reset all collected metrics */
+    reset() {
+        this.durations.length = 0;
+        this.errors.length = 0;
+        this.activeGaugeSnapshots.length = 0;
+        this.activeRequests = 0;
+    }
+}
+// ─── Config Resolution ───────────────────────────────────────
+/** Resolves a TelemetryConfig into a normalized MetricsConfig */
+export function resolveMetricsConfig(telemetry) {
+    if (!telemetry) {
+        return { enabled: true, exporter: "console" };
+    }
+    if (typeof telemetry.metrics === "boolean") {
+        return {
+            enabled: telemetry.metrics,
+            exporter: telemetry.exporter ?? "console",
+            endpoint: telemetry.endpoint,
+            serviceName: telemetry.serviceName,
+        };
+    }
+    if (typeof telemetry.metrics === "object") {
+        return {
+            enabled: telemetry.metrics.enabled ?? true,
+            exporter: telemetry.metrics.exporter ?? telemetry.exporter ?? "console",
+            endpoint: telemetry.metrics.endpoint ?? telemetry.endpoint,
+            serviceName: telemetry.metrics.serviceName ?? telemetry.serviceName,
+        };
+    }
+    return {
+        enabled: true,
+        exporter: telemetry.exporter ?? "console",
+        endpoint: telemetry.endpoint,
+        serviceName: telemetry.serviceName,
+    };
+}
+/** Creates the appropriate MetricExporter from config */
+export function createMetricExporter(config) {
+    if (!config.enabled) {
+        return new NoopMetricExporter();
+    }
+    if (config.exporter === "otlp") {
+        return new OtlpMetricExporter(config.endpoint);
+    }
+    return new ConsoleMetricExporter();
+}
+/**
+ * Creates a MetricsCollector configured from TelemetryConfig.
+ * This is the main entry point for request-level metrics.
+ */
+export function createMetricsCollector(telemetry, exporterOverride) {
+    const config = resolveMetricsConfig(telemetry);
+    const exporter = exporterOverride ?? createMetricExporter(config);
+    return new MetricsCollector({
+        exporter,
+        serviceName: config.serviceName,
+        enabled: config.enabled,
+    });
+}
+//# sourceMappingURL=metrics.js.map