@superblocksteam/telemetry 2.0.83-next.1

package/dist/node/log-processor.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Policy-Aware Log Processor
+ *
+ * Wraps a delegate LogRecordProcessor to provide:
+ * 1. Export mode filtering (LOCAL_ONLY, ERRORS_ONLY, INFO_AND_ABOVE)
+ * 2. Severity level filtering
+ * 3. Log body and attribute sanitization
+ *
+ * @see https://github.com/superblocksteam/engineering/blob/main/projects/o11y-refactor/epics/epic-c4-logging-strategy.md
+ */
+import type { LogRecordProcessor, ReadableLogRecord } from "@opentelemetry/sdk-logs";
+import type { Context } from "@opentelemetry/api";
+import { TelemetryPolicy } from "../types/policy.js";
+/**
+ * Controls what logs are exported via OTEL.
+ */
+export declare enum LogExportMode {
+    /** No log export - local stdout/stderr only */
+    LOCAL_ONLY = "local_only",
+    /** Export WARN/ERROR/FATAL only (default for cloud-prem) */
+    ERRORS_ONLY = "errors_only",
+    /** Export INFO and above (not recommended for cloud-prem) */
+    INFO_AND_ABOVE = "info_and_above"
+}
+/**
+ * Logging-specific policy configuration.
+ */
+export interface LoggingPolicyConfig {
+    /** What logs to export */
+    exportMode: LogExportMode;
+    /** Maximum log level for local retention */
+    localMaxLevel: "trace" | "debug" | "info" | "warn" | "error" | "fatal";
+    /** Regex patterns to redact from log content */
+    redactPatterns: RegExp[];
+    /** Fields to never include in exported logs */
+    forbiddenFields: Set<string>;
+}
+/**
+ * Get logging policy based on telemetry policy.
+ *
+ * @param policy - Telemetry policy
+ * @returns Logging policy configuration
+ */
+export declare function getLoggingPolicy(policy: TelemetryPolicy): LoggingPolicyConfig;
+/**
+ * Log processor that filters and sanitizes logs based on policy.
+ *
+ * This processor:
+ * 1. Blocks all logs if exportMode is LOCAL_ONLY
+ * 2. Filters by severity level based on exportMode
+ * 3. Sanitizes log body and attributes before forwarding
+ */
+export declare class PolicyAwareLogProcessor implements LogRecordProcessor {
+    private readonly policy;
+    private readonly delegate;
+    constructor(policy: LoggingPolicyConfig, delegate: LogRecordProcessor);
+    /**
+     * Called when a log record is emitted.
+     */
+    onEmit(logRecord: ReadableLogRecord, context?: Context): void;
+    /**
+     * Sanitize a log record for export.
+     * Mutates the log record in place to preserve OTEL SDK internal state.
+     */
+    private sanitizeLogRecord;
+    /**
+     * Check if a string contains a stack trace.
+     */
+    private containsStackTrace;
+    /**
+     * Sanitize log attributes.
+     */
+    private sanitizeAttributes;
+    /**
+     * Shutdown the processor.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Force flush pending logs.
+     */
+    forceFlush(): Promise<void>;
+}
+//# sourceMappingURL=log-processor.d.ts.map

package/dist/node/log-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-processor.d.ts","sourceRoot":"","sources":["../../src/node/log-processor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAiB,MAAM,oBAAoB,CAAC;AAepE;;GAEG;AACH,oBAAY,aAAa;IACvB,+CAA+C;IAC/C,UAAU,eAAe;IACzB,4DAA4D;IAC5D,WAAW,gBAAgB;IAC3B,6DAA6D;IAC7D,cAAc,mBAAmB;CAClC;AAMD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,0BAA0B;IAC1B,UAAU,EAAE,aAAa,CAAC;IAC1B,4CAA4C;IAC5C,aAAa,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IACvE,gDAAgD;IAChD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,+CAA+C;IAC/C,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC9B;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,mBAAmB,CAyC7E;AAuDD;;;;;;;GAOG;AACH,qBAAa,uBAAwB,YAAW,kBAAkB;IAChE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;gBAElC,MAAM,EAAE,mBAAmB,EAAE,QAAQ,EAAE,kBAAkB;IAKrE;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI;IAsB7D;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAuCzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAyC1B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAGlC"}

package/dist/node/log-processor.js

@@ -0,0 +1,266 @@
+"use strict";
+/**
+ * Policy-Aware Log Processor
+ *
+ * Wraps a delegate LogRecordProcessor to provide:
+ * 1. Export mode filtering (LOCAL_ONLY, ERRORS_ONLY, INFO_AND_ABOVE)
+ * 2. Severity level filtering
+ * 3. Log body and attribute sanitization
+ *
+ * @see https://github.com/superblocksteam/engineering/blob/main/projects/o11y-refactor/epics/epic-c4-logging-strategy.md
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PolicyAwareLogProcessor = exports.LogExportMode = void 0;
+exports.getLoggingPolicy = getLoggingPolicy;
+const policy_js_1 = require("../types/policy.js");
+const policy_evaluator_js_1 = require("../common/policy-evaluator.js");
+const log_sanitizer_js_1 = require("../common/log-sanitizer.js");
+const shared_1 = require("@superblocksteam/shared");
+// ============================================================================
+// Log Export Mode
+// ============================================================================
+/**
+ * Controls what logs are exported via OTEL.
+ */
+var LogExportMode;
+(function (LogExportMode) {
+    /** No log export - local stdout/stderr only */
+    LogExportMode["LOCAL_ONLY"] = "local_only";
+    /** Export WARN/ERROR/FATAL only (default for cloud-prem) */
+    LogExportMode["ERRORS_ONLY"] = "errors_only";
+    /** Export INFO and above (not recommended for cloud-prem) */
+    LogExportMode["INFO_AND_ABOVE"] = "info_and_above";
+})(LogExportMode || (exports.LogExportMode = LogExportMode = {}));
+/**
+ * Get logging policy based on telemetry policy.
+ *
+ * @param policy - Telemetry policy
+ * @returns Logging policy configuration
+ */
+function getLoggingPolicy(policy) {
+    const evaluator = new policy_evaluator_js_1.TelemetryPolicyEvaluator(policy);
+    // Check if Tier 2 export is allowed
+    const canExportTier2 = evaluator.isExportEnabled(policy_js_1.TelemetryTier.TIER_2_OPERATIONAL);
+    if (!canExportTier2) {
+        return {
+            exportMode: LogExportMode.LOCAL_ONLY,
+            localMaxLevel: "debug",
+            redactPatterns: [],
+            forbiddenFields: log_sanitizer_js_1.TIER1_FORBIDDEN_LOG_FIELDS,
+        };
+    }
+    // Cloud-prem: export errors only, with full sanitization
+    if (policy.deploymentType === shared_1.DeploymentTypeEnum.CLOUD_PREM) {
+        return {
+            exportMode: LogExportMode.ERRORS_ONLY,
+            localMaxLevel: "debug",
+            redactPatterns: [
+                // JWTs
+                /\b[A-Za-z0-9-_]{20,}\.[A-Za-z0-9-_]{20,}\.[A-Za-z0-9-_]{20,}\b/g,
+                // Bearer tokens
+                /(\bbearer\s+)[a-zA-Z0-9\-._~+/]+=*/gi,
+                // API keys
+                /(\bapi[_\s]?key[:\s=]+)[a-zA-Z0-9\-._~+/]+=*/gi,
+            ],
+            forbiddenFields: log_sanitizer_js_1.TIER1_FORBIDDEN_LOG_FIELDS,
+        };
+    }
+    // Cloud: more permissive (INFO and above)
+    return {
+        exportMode: LogExportMode.INFO_AND_ABOVE,
+        localMaxLevel: "debug",
+        redactPatterns: [],
+        forbiddenFields: new Set(), // Cloud can export more
+    };
+}
+// ============================================================================
+// Severity Level Utilities
+// ============================================================================
+/**
+ * OTEL severity numbers:
+ * 1-4: TRACE
+ * 5-8: DEBUG
+ * 9-12: INFO
+ * 13-16: WARN
+ * 17-20: ERROR
+ * 21-24: FATAL
+ */
+function getSeverityName(severityNumber) {
+    if (!severityNumber)
+        return "info";
+    if (severityNumber <= 4)
+        return "trace";
+    if (severityNumber <= 8)
+        return "debug";
+    if (severityNumber <= 12)
+        return "info";
+    if (severityNumber <= 16)
+        return "warn";
+    if (severityNumber <= 20)
+        return "error";
+    return "fatal";
+}
+/**
+ * Check if a severity level should be exported based on export mode.
+ */
+function shouldExportSeverity(severityNumber, mode) {
+    if (mode === LogExportMode.LOCAL_ONLY) {
+        return false;
+    }
+    const severity = getSeverityName(severityNumber);
+    if (mode === LogExportMode.ERRORS_ONLY) {
+        return severity === "warn" || severity === "error" || severity === "fatal";
+    }
+    // INFO_AND_ABOVE
+    return (severity === "info" ||
+        severity === "warn" ||
+        severity === "error" ||
+        severity === "fatal");
+}
+// ============================================================================
+// Policy-Aware Log Processor
+// ============================================================================
+/**
+ * Log processor that filters and sanitizes logs based on policy.
+ *
+ * This processor:
+ * 1. Blocks all logs if exportMode is LOCAL_ONLY
+ * 2. Filters by severity level based on exportMode
+ * 3. Sanitizes log body and attributes before forwarding
+ */
+class PolicyAwareLogProcessor {
+    policy;
+    delegate;
+    constructor(policy, delegate) {
+        this.policy = policy;
+        this.delegate = delegate;
+    }
+    /**
+     * Called when a log record is emitted.
+     */
+    onEmit(logRecord, context) {
+        // Check if export mode allows this log
+        if (this.policy.exportMode === LogExportMode.LOCAL_ONLY) {
+            return; // Don't export anything
+        }
+        // Check if severity level should be exported
+        if (!shouldExportSeverity(logRecord.severityNumber, this.policy.exportMode)) {
+            return;
+        }
+        // Sanitize the log record in place before forwarding
+        // The logRecord is actually an SdkLogRecord at runtime, we mutate it directly
+        this.sanitizeLogRecord(logRecord);
+        // Forward to delegate - cast is safe because logRecord is SdkLogRecord at runtime
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        this.delegate.onEmit(logRecord, context);
+    }
+    /**
+     * Sanitize a log record for export.
+     * Mutates the log record in place to preserve OTEL SDK internal state.
+     */
+    sanitizeLogRecord(logRecord) {
+        // Sanitize body - mutate in place
+        if (typeof logRecord.body === "string") {
+            // Apply policy-specific redact patterns first
+            let sanitizedBody = logRecord.body;
+            for (const pattern of this.policy.redactPatterns) {
+                pattern.lastIndex = 0; // Reset regex state
+                sanitizedBody = sanitizedBody.replace(pattern, "[REDACTED]");
+            }
+            // Check for stack traces
+            if (this.containsStackTrace(sanitizedBody)) {
+                // Use setAttribute pattern for LogRecord mutation
+                logRecord.body =
+                    (0, log_sanitizer_js_1.redactStackTrace)(sanitizedBody);
+            }
+            else {
+                logRecord.body =
+                    (0, log_sanitizer_js_1.sanitizeLogMessage)(sanitizedBody);
+            }
+        }
+        else if (logRecord.body && typeof logRecord.body === "object") {
+            logRecord.body = (0, log_sanitizer_js_1.sanitizeLogObject)(logRecord.body);
+        }
+        // Sanitize attributes - mutate in place
+        const attrs = logRecord.attributes;
+        if (attrs) {
+            const sanitizedAttributes = this.sanitizeAttributes(attrs);
+            // Clear and repopulate attributes
+            for (const key of Object.keys(attrs)) {
+                delete attrs[key];
+            }
+            for (const [key, value] of Object.entries(sanitizedAttributes)) {
+                attrs[key] = value;
+            }
+        }
+    }
+    /**
+     * Check if a string contains a stack trace.
+     */
+    containsStackTrace(text) {
+        // Node.js stack traces
+        if (/at .+\(.+:\d+:\d+\)/.test(text))
+            return true;
+        // Go stack traces
+        if (/goroutine \d+ \[.+\]:/.test(text))
+            return true;
+        // Python stack traces
+        if (/File ".+", line \d+/.test(text))
+            return true;
+        // Java stack traces
+        if (/at \w+\.\w+\(.+\.java:\d+\)/.test(text))
+            return true;
+        return false;
+    }
+    /**
+     * Sanitize log attributes.
+     */
+    sanitizeAttributes(attributes) {
+        if (!attributes) {
+            return {};
+        }
+        const sanitized = {};
+        for (const [key, value] of Object.entries(attributes)) {
+            const lowerKey = key.toLowerCase();
+            // Skip forbidden fields (exact match from policy)
+            if (this.policy.forbiddenFields.has(lowerKey)) {
+                continue;
+            }
+            // Skip fields matching secret field patterns (word-boundary aware)
+            if ((0, log_sanitizer_js_1.isSecretField)(key)) {
+                continue;
+            }
+            // Sanitize string values
+            if (typeof value === "string") {
+                // Apply policy-specific redact patterns
+                let sanitizedValue = value;
+                for (const pattern of this.policy.redactPatterns) {
+                    pattern.lastIndex = 0;
+                    sanitizedValue = sanitizedValue.replace(pattern, "[REDACTED]");
+                }
+                sanitized[key] = (0, log_sanitizer_js_1.sanitizeLogMessage)(sanitizedValue);
+            }
+            else if (value && typeof value === "object") {
+                sanitized[key] = (0, log_sanitizer_js_1.sanitizeLogObject)(value);
+            }
+            else {
+                sanitized[key] = value;
+            }
+        }
+        return sanitized;
+    }
+    /**
+     * Shutdown the processor.
+     */
+    async shutdown() {
+        return this.delegate.shutdown();
+    }
+    /**
+     * Force flush pending logs.
+     */
+    async forceFlush() {
+        return this.delegate.forceFlush();
+    }
+}
+exports.PolicyAwareLogProcessor = PolicyAwareLogProcessor;
+//# sourceMappingURL=log-processor.js.map

package/dist/node/log-processor.js.map

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

package/dist/node/metrics-client.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Metrics Client for Node.js Telemetry
+ *
+ * Provides a simple interface for recording metrics via OpenTelemetry.
+ * This is the recommended way to record metrics in services using the telemetry package.
+ */
+import type { Meter } from "@opentelemetry/api";
+/**
+ * Labels for metrics (key-value pairs).
+ */
+export type Labels = Record<string, string | number>;
+/**
+ * Handle for a counter metric.
+ */
+export interface CounterHandle {
+    inc(labels?: Labels, value?: number): void;
+}
+/**
+ * Handle for a gauge metric.
+ */
+export interface GaugeHandle {
+    set(labels: Labels, value: number): void;
+}
+/**
+ * Handle for a histogram metric.
+ */
+export interface HistogramHandle {
+    observe(labels: Labels, value: number): void;
+}
+/**
+ * Metrics client that provides a unified interface for recording OTEL metrics.
+ */
+export declare class MetricsClient {
+    private readonly meter;
+    private counters;
+    private histograms;
+    private gaugeValues;
+    constructor(meter: Meter);
+    /**
+     * Creates or retrieves a counter and returns a handle.
+     */
+    counter(name: string): CounterHandle;
+    /**
+     * Creates or retrieves a gauge and returns a handle.
+     * Note: OTEL gauges are async/observable, so we store the value and emit via callback.
+     * Values are automatically expired after 5 minutes to prevent unbounded memory growth.
+     */
+    gauge(name: string): GaugeHandle;
+    /**
+     * Creates or retrieves a histogram and returns a handle.
+     */
+    histogram(name: string): HistogramHandle;
+    /**
+     * Increments a counter by name (creates if not exists).
+     */
+    incCounter(name: string, labels?: Labels, value?: number): void;
+    /**
+     * Sets a gauge value by name (creates if not exists).
+     */
+    setGauge(name: string, labels: Labels, value: number): void;
+    /**
+     * Observes a histogram value by name (creates if not exists).
+     */
+    observeHistogram(name: string, labels: Labels, value: number): void;
+}
+//# sourceMappingURL=metrics-client.d.ts.map

package/dist/node/metrics-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-client.d.ts","sourceRoot":"","sources":["../../src/node/metrics-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAkC,MAAM,oBAAoB,CAAC;AAEhF;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;AAoHrD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9C;AAED;;GAEG;AACH,qBAAa,aAAa;IAMZ,OAAO,CAAC,QAAQ,CAAC,KAAK;IALlC,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,UAAU,CAAgC;IAElD,OAAO,CAAC,WAAW,CAAkC;gBAExB,KAAK,EAAE,KAAK;IAEzC;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa;IAapC;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW;IA2BhC;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe;IAaxC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,IAAI;IAIlE;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAI3D;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;CAGpE"}

package/dist/node/metrics-client.js

@@ -0,0 +1,193 @@
+"use strict";
+/**
+ * Metrics Client for Node.js Telemetry
+ *
+ * Provides a simple interface for recording metrics via OpenTelemetry.
+ * This is the recommended way to record metrics in services using the telemetry package.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetricsClient = void 0;
+/**
+ * Converts Labels to OTEL Attributes.
+ */
+function labelsToAttributes(labels) {
+    if (!labels)
+        return {};
+    const attributes = {};
+    for (const [key, value] of Object.entries(labels)) {
+        attributes[key] = String(value);
+    }
+    return attributes;
+}
+/**
+ * TTL configuration for gauge values.
+ */
+const GAUGE_TTL_MS = 5 * 60 * 1000; // 5 minutes
+const GAUGE_MAX_ENTRIES = 10_000; // Max entries per gauge to prevent unbounded growth
+const GAUGE_CLEANUP_INTERVAL_MS = 60 * 1000; // Cleanup every minute
+/**
+ * TTL-based map for gauge values with automatic cleanup.
+ */
+class TTLGaugeMap {
+    ttlMs;
+    maxEntries;
+    entries = new Map();
+    cleanupTimer = null;
+    constructor(ttlMs = GAUGE_TTL_MS, maxEntries = GAUGE_MAX_ENTRIES) {
+        this.ttlMs = ttlMs;
+        this.maxEntries = maxEntries;
+        // Start periodic cleanup
+        this.cleanupTimer = setInterval(() => this.cleanup(), GAUGE_CLEANUP_INTERVAL_MS);
+        // Don't prevent Node.js from exiting
+        this.cleanupTimer.unref();
+    }
+    set(labelsKey, value) {
+        // If at max capacity, remove oldest entry
+        if (this.entries.size >= this.maxEntries && !this.entries.has(labelsKey)) {
+            this.evictOldest();
+        }
+        this.entries.set(labelsKey, {
+            value,
+            updatedAt: Date.now(),
+        });
+    }
+    /**
+     * Gets all non-expired entries.
+     */
+    getAll() {
+        const now = Date.now();
+        const result = new Map();
+        for (const [key, entry] of this.entries) {
+            if (now - entry.updatedAt <= this.ttlMs) {
+                result.set(key, entry.value);
+            }
+        }
+        return result;
+    }
+    /**
+     * Removes expired entries.
+     */
+    cleanup() {
+        const now = Date.now();
+        for (const [key, entry] of this.entries) {
+            if (now - entry.updatedAt > this.ttlMs) {
+                this.entries.delete(key);
+            }
+        }
+    }
+    /**
+     * Evicts the oldest entry when at max capacity.
+     */
+    evictOldest() {
+        let oldestKey = null;
+        let oldestTime = Infinity;
+        for (const [key, entry] of this.entries) {
+            if (entry.updatedAt < oldestTime) {
+                oldestTime = entry.updatedAt;
+                oldestKey = key;
+            }
+        }
+        if (oldestKey) {
+            this.entries.delete(oldestKey);
+        }
+    }
+    /**
+     * Stops the cleanup timer.
+     */
+    destroy() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = null;
+        }
+    }
+}
+/**
+ * Metrics client that provides a unified interface for recording OTEL metrics.
+ */
+class MetricsClient {
+    meter;
+    counters = new Map();
+    histograms = new Map();
+    // Gauges use TTL-based maps to prevent unbounded memory growth
+    gaugeValues = new Map();
+    constructor(meter) {
+        this.meter = meter;
+    }
+    /**
+     * Creates or retrieves a counter and returns a handle.
+     */
+    counter(name) {
+        if (!this.counters.has(name)) {
+            this.counters.set(name, this.meter.createCounter(name));
+        }
+        const counter = this.counters.get(name);
+        return {
+            inc: (labels, value = 1) => {
+                counter.add(value, labelsToAttributes(labels));
+            },
+        };
+    }
+    /**
+     * Creates or retrieves a gauge and returns a handle.
+     * Note: OTEL gauges are async/observable, so we store the value and emit via callback.
+     * Values are automatically expired after 5 minutes to prevent unbounded memory growth.
+     */
+    gauge(name) {
+        if (!this.gaugeValues.has(name)) {
+            const ttlMap = new TTLGaugeMap();
+            this.gaugeValues.set(name, ttlMap);
+            // Create an observable gauge that reads from the TTL map
+            this.meter.createObservableGauge(name, {}).addCallback((result) => {
+                const ttlMapRef = this.gaugeValues.get(name);
+                if (ttlMapRef) {
+                    // getAll() only returns non-expired entries
+                    for (const [labelsKey, value] of ttlMapRef.getAll()) {
+                        const labels = JSON.parse(labelsKey);
+                        result.observe(value, labelsToAttributes(labels));
+                    }
+                }
+            });
+        }
+        return {
+            set: (labels, value) => {
+                const ttlMap = this.gaugeValues.get(name);
+                const labelsKey = JSON.stringify(labels);
+                ttlMap.set(labelsKey, value);
+            },
+        };
+    }
+    /**
+     * Creates or retrieves a histogram and returns a handle.
+     */
+    histogram(name) {
+        if (!this.histograms.has(name)) {
+            this.histograms.set(name, this.meter.createHistogram(name));
+        }
+        const histogram = this.histograms.get(name);
+        return {
+            observe: (labels, value) => {
+                histogram.record(value, labelsToAttributes(labels));
+            },
+        };
+    }
+    /**
+     * Increments a counter by name (creates if not exists).
+     */
+    incCounter(name, labels, value = 1) {
+        this.counter(name).inc(labels, value);
+    }
+    /**
+     * Sets a gauge value by name (creates if not exists).
+     */
+    setGauge(name, labels, value) {
+        this.gauge(name).set(labels, value);
+    }
+    /**
+     * Observes a histogram value by name (creates if not exists).
+     */
+    observeHistogram(name, labels, value) {
+        this.histogram(name).observe(labels, value);
+    }
+}
+exports.MetricsClient = MetricsClient;
+//# sourceMappingURL=metrics-client.js.map

package/dist/node/metrics-client.js.map

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