@provide-io/telemetry 0.2.2

package/dist/fingerprint.js

@@ -0,0 +1,50 @@
+// SPDX-FileCopyrightText: Copyright (c) 2025-2026 provide.io llc. All rights reserved.
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Stable error fingerprinting — generates a 12-char hex hash from
+ * exception type + top 3 stack frames (file:function, no line numbers).
+ *
+ * Cross-language compatible: same error in Python and TypeScript produces
+ * the same fingerprint when the call path is equivalent.
+ */
+import { shortHash12 } from './hash';
+/**
+ * Parse an Error stack trace into normalized frames: `basename:function`.
+ * Returns at most 3 frames (most recent).
+ */
+function extractFrames(stack) {
+    // Stryker disable next-line ConditionalExpression -- equivalent: falsy stack always yields no frames
+    if (!stack)
+        return [];
+    const frames = [];
+    // V8: "at functionName (filename:line:col)" or "at filename:line:col"
+    // Stryker disable next-line Regex -- \s+ vs \s and trailing \d+ vs \d are equivalent for real stacks
+    const v8Re = /at\s+(?:(.+?)\s+\()?(.*?):\d+:\d+\)?/g;
+    // SpiderMonkey/JSC: "functionName@filename:line:col"
+    // Stryker disable next-line Regex -- trailing \d+ vs \d is equivalent for file extraction
+    const smRe = /(.+?)@(.*?):\d+:\d+/g;
+    for (const re of [v8Re, smRe]) {
+        let match;
+        while ((match = re.exec(stack)) !== null) {
+            const func = String(match[1] || '').toLowerCase();
+            const file = String(match[2] || '');
+            const parts = file.split('/');
+            const last = parts[parts.length - 1] || '';
+            const winParts = last.split('\\');
+            const leaf = winParts[winParts.length - 1] || '';
+            const basename = leaf.replace(/\.[^.]+$/, '').toLowerCase();
+            if (basename) {
+                frames.push(`${basename}:${func}`);
+            }
+        }
+    }
+    return frames.slice(-3);
+}
+/**
+ * Compute a stable 12-char hex fingerprint for an error.
+ */
+export function computeErrorFingerprint(errorName, stack) {
+    const parts = [errorName.toLowerCase()];
+    parts.push(...extractFrames(stack));
+    return shortHash12(parts.join(':'));
+}

package/dist/hash.d.ts

@@ -0,0 +1,8 @@
+export declare function sha256Hex(input: string): string;
+export declare function shortHash12(input: string): string;
+/**
+ * Generate `numBytes` random bytes and return them as a lowercase hex string.
+ * Uses the Web Crypto API (available in Node.js 15+, browsers, and edge runtimes).
+ */
+export declare function randomHex(numBytes: number): string;
+//# sourceMappingURL=hash.d.ts.map

package/dist/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AA8BA,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAyE/C;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIlD"}

package/dist/hash.js

@@ -0,0 +1,102 @@
+// SPDX-FileCopyrightText: Copyright (c) 2025-2026 provide.io llc. All rights reserved.
+// SPDX-License-Identifier: Apache-2.0
+const INITIAL_HASH = [
+    0x6a09e667, 0xbb67ae85, 0x3c6ef372, 0xa54ff53a, 0x510e527f, 0x9b05688c, 0x1f83d9ab, 0x5be0cd19,
+];
+const ROUND_CONSTANTS = [
+    0x428a2f98, 0x71374491, 0xb5c0fbcf, 0xe9b5dba5, 0x3956c25b, 0x59f111f1, 0x923f82a4, 0xab1c5ed5,
+    0xd807aa98, 0x12835b01, 0x243185be, 0x550c7dc3, 0x72be5d74, 0x80deb1fe, 0x9bdc06a7, 0xc19bf174,
+    0xe49b69c1, 0xefbe4786, 0x0fc19dc6, 0x240ca1cc, 0x2de92c6f, 0x4a7484aa, 0x5cb0a9dc, 0x76f988da,
+    0x983e5152, 0xa831c66d, 0xb00327c8, 0xbf597fc7, 0xc6e00bf3, 0xd5a79147, 0x06ca6351, 0x14292967,
+    0x27b70a85, 0x2e1b2138, 0x4d2c6dfc, 0x53380d13, 0x650a7354, 0x766a0abb, 0x81c2c92e, 0x92722c85,
+    0xa2bfe8a1, 0xa81a664b, 0xc24b8b70, 0xc76c51a3, 0xd192e819, 0xd6990624, 0xf40e3585, 0x106aa070,
+    0x19a4c116, 0x1e376c08, 0x2748774c, 0x34b0bcb5, 0x391c0cb3, 0x4ed8aa4a, 0x5b9cca4f, 0x682e6ff3,
+    0x748f82ee, 0x78a5636f, 0x84c87814, 0x8cc70208, 0x90befffa, 0xa4506ceb, 0xbef9a3f7, 0xc67178f2,
+];
+function add32(...values) {
+    let sum = 0;
+    for (const value of values) {
+        sum = (sum + (value >>> 0)) >>> 0;
+    }
+    return sum;
+}
+function rotateRight(value, bits) {
+    return (value >>> bits) | (value << (32 - bits));
+}
+export function sha256Hex(input) {
+    const bytes = new TextEncoder().encode(input);
+    const bitLength = bytes.length * 8;
+    const paddedLength = Math.ceil((bytes.length + 9) / 64) * 64;
+    const padded = new Uint8Array(paddedLength);
+    padded.set(bytes);
+    padded[bytes.length] = 0x80;
+    const view = new DataView(padded.buffer);
+    // Stryker disable next-line ArithmeticOperator: highBits is always 0 for inputs under 512 MB — division vs multiplication both produce 0 after ToUint32 coercion
+    const highBits = Math.floor(bitLength / 0x100000000);
+    const lowBits = bitLength >>> 0;
+    // Stryker disable next-line BooleanLiteral: highBits is 0 for all testable inputs — big-endian vs little-endian of 0 is identical
+    view.setUint32(paddedLength - 8, highBits, false);
+    view.setUint32(paddedLength - 4, lowBits, false);
+    const words = new Uint32Array(64);
+    let [h0, h1, h2, h3, h4, h5, h6, h7] = INITIAL_HASH;
+    for (let offset = 0; offset < paddedLength; offset += 64) {
+        for (let i = 0; i < 16; i++) {
+            words[i] = view.getUint32(offset + i * 4, false);
+        }
+        // Stryker disable next-line EqualityOperator: Uint32Array(64) silently ignores writes to index 64 — the extra iteration is a no-op
+        for (let i = 16; i < 64; i++) {
+            const w15 = words[i - 15];
+            const w2 = words[i - 2];
+            const sigma0 = rotateRight(w15, 7) ^ rotateRight(w15, 18) ^ (w15 >>> 3);
+            const sigma1 = rotateRight(w2, 17) ^ rotateRight(w2, 19) ^ (w2 >>> 10);
+            words[i] = add32(words[i - 16], sigma0, words[i - 7], sigma1);
+        }
+        let a = h0;
+        let b = h1;
+        let c = h2;
+        let d = h3;
+        let e = h4;
+        let f = h5;
+        let g = h6;
+        let h = h7;
+        for (let i = 0; i < 64; i++) {
+            const sum1 = rotateRight(e, 6) ^ rotateRight(e, 11) ^ rotateRight(e, 25);
+            const choose = (e & f) ^ (~e & g);
+            const temp1 = add32(h, sum1, choose, ROUND_CONSTANTS[i], words[i]);
+            const sum0 = rotateRight(a, 2) ^ rotateRight(a, 13) ^ rotateRight(a, 22);
+            const majority = (a & b) ^ (a & c) ^ (b & c);
+            const temp2 = add32(sum0, majority);
+            h = g;
+            g = f;
+            f = e;
+            e = add32(d, temp1);
+            d = c;
+            c = b;
+            b = a;
+            a = add32(temp1, temp2);
+        }
+        h0 = add32(h0, a);
+        h1 = add32(h1, b);
+        h2 = add32(h2, c);
+        h3 = add32(h3, d);
+        h4 = add32(h4, e);
+        h5 = add32(h5, f);
+        h6 = add32(h6, g);
+        h7 = add32(h7, h);
+    }
+    return [h0, h1, h2, h3, h4, h5, h6, h7]
+        .map((word) => word.toString(16).padStart(8, '0'))
+        .join('');
+}
+export function shortHash12(input) {
+    return sha256Hex(input).slice(0, 12);
+}
+/**
+ * Generate `numBytes` random bytes and return them as a lowercase hex string.
+ * Uses the Web Crypto API (available in Node.js 15+, browsers, and edge runtimes).
+ */
+export function randomHex(numBytes) {
+    const bytes = new Uint8Array(numBytes);
+    crypto.getRandomValues(bytes);
+    return Array.from(bytes, (b) => b.toString(16).padStart(2, '0')).join('');
+}

package/dist/health.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Internal self-observability counters — mirrors Python provide.telemetry.health.
+ * Canonical 25-field layout: 8 per signal (logs, traces, metrics) + 1 global.
+ */
+export interface HealthSnapshot {
+    logsEmitted: number;
+    logsDropped: number;
+    exportFailuresLogs: number;
+    retriesLogs: number;
+    exportLatencyMsLogs: number;
+    asyncBlockingRiskLogs: number;
+    circuitStateLogs: string;
+    circuitOpenCountLogs: number;
+    tracesEmitted: number;
+    tracesDropped: number;
+    exportFailuresTraces: number;
+    retriesTraces: number;
+    exportLatencyMsTraces: number;
+    asyncBlockingRiskTraces: number;
+    circuitStateTraces: string;
+    circuitOpenCountTraces: number;
+    metricsEmitted: number;
+    metricsDropped: number;
+    exportFailuresMetrics: number;
+    retriesMetrics: number;
+    exportLatencyMsMetrics: number;
+    asyncBlockingRiskMetrics: number;
+    circuitStateMetrics: string;
+    circuitOpenCountMetrics: number;
+    setupError: string | null;
+}
+/** Numeric fields that live in the mutable _state object (not derived circuit fields). */
+type NumericHealthField = 'logsEmitted' | 'logsDropped' | 'tracesEmitted' | 'tracesDropped' | 'metricsEmitted' | 'metricsDropped' | 'exportFailuresLogs' | 'exportFailuresTraces' | 'exportFailuresMetrics' | 'retriesLogs' | 'retriesTraces' | 'retriesMetrics' | 'exportLatencyMsLogs' | 'exportLatencyMsTraces' | 'exportLatencyMsMetrics' | 'asyncBlockingRiskLogs' | 'asyncBlockingRiskTraces' | 'asyncBlockingRiskMetrics';
+type CircuitStateResult = {
+    state: string;
+    openCount: number;
+    cooldownRemainingMs: number;
+};
+type CircuitStateFn = (signal: string) => CircuitStateResult;
+/** Called by resilience module to register the getCircuitState function. */
+export declare function _registerCircuitStateFn(fn: CircuitStateFn): void;
+export declare function getHealthSnapshot(): HealthSnapshot;
+export declare function setSetupError(error: string | null): void;
+export declare function _incrementHealth(field: NumericHealthField, by?: number): void;
+/** Map a signal name to the per-signal export-failures field. */
+export declare function _exportFailuresField(signal: string): 'exportFailuresLogs' | 'exportFailuresTraces' | 'exportFailuresMetrics';
+/** Map a signal name to the per-signal retries field. */
+export declare function _retriesField(signal: string): 'retriesLogs' | 'retriesTraces' | 'retriesMetrics';
+/** Map a signal name to the per-signal export latency field. */
+export declare function _exportLatencyField(signal: string): 'exportLatencyMsLogs' | 'exportLatencyMsTraces' | 'exportLatencyMsMetrics';
+export declare function _recordExportLatency(signal: string, ms: number): void;
+export declare function _resetHealthForTests(): void;
+export {};
+//# sourceMappingURL=health.d.ts.map

package/dist/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"AAGA;;;GAGG;AAEH,MAAM,WAAW,cAAc;IAE7B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAE7B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,uBAAuB,EAAE,MAAM,CAAC;IAChC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sBAAsB,EAAE,MAAM,CAAC;IAE/B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,wBAAwB,EAAE,MAAM,CAAC;IACjC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,uBAAuB,EAAE,MAAM,CAAC;IAEhC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,0FAA0F;AAC1F,KAAK,kBAAkB,GACnB,aAAa,GACb,aAAa,GACb,eAAe,GACf,eAAe,GACf,gBAAgB,GAChB,gBAAgB,GAChB,oBAAoB,GACpB,sBAAsB,GACtB,uBAAuB,GACvB,aAAa,GACb,eAAe,GACf,gBAAgB,GAChB,qBAAqB,GACrB,uBAAuB,GACvB,wBAAwB,GACxB,uBAAuB,GACvB,yBAAyB,GACzB,0BAA0B,CAAC;AA2B/B,KAAK,kBAAkB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,MAAM,CAAA;CAAE,CAAC;AAC5F,KAAK,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,kBAAkB,CAAC;AAS7D,4EAA4E;AAC5E,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI,CAEhE;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CAclD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAExD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,EAAE,EAAE,GAAE,MAAU,GAAG,IAAI,CAEhF;AAED,iEAAiE;AACjE,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,GACb,oBAAoB,GAAG,sBAAsB,GAAG,uBAAuB,CAIzE;AAED,yDAAyD;AACzD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,eAAe,GAAG,gBAAgB,CAIhG;AAED,gEAAgE;AAChE,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,GACb,qBAAqB,GAAG,uBAAuB,GAAG,wBAAwB,CAI5E;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAErE;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAoB3C"}

package/dist/health.js

@@ -0,0 +1,102 @@
+// SPDX-FileCopyrightText: Copyright (c) 2025-2026 provide.io llc. All rights reserved.
+// SPDX-License-Identifier: Apache-2.0
+let _setupError = null;
+const _state = {
+    logsEmitted: 0,
+    logsDropped: 0,
+    tracesEmitted: 0,
+    tracesDropped: 0,
+    metricsEmitted: 0,
+    metricsDropped: 0,
+    exportFailuresLogs: 0,
+    exportFailuresTraces: 0,
+    exportFailuresMetrics: 0,
+    retriesLogs: 0,
+    retriesTraces: 0,
+    retriesMetrics: 0,
+    exportLatencyMsLogs: 0,
+    exportLatencyMsTraces: 0,
+    exportLatencyMsMetrics: 0,
+    asyncBlockingRiskLogs: 0,
+    asyncBlockingRiskTraces: 0,
+    asyncBlockingRiskMetrics: 0,
+};
+const _defaultCircuitState = {
+    state: 'closed',
+    openCount: 0,
+    cooldownRemainingMs: 0,
+};
+let _circuitStateFn = () => _defaultCircuitState;
+/** Called by resilience module to register the getCircuitState function. */
+export function _registerCircuitStateFn(fn) {
+    _circuitStateFn = fn;
+}
+export function getHealthSnapshot() {
+    const csLogs = _circuitStateFn('logs');
+    const csTraces = _circuitStateFn('traces');
+    const csMetrics = _circuitStateFn('metrics');
+    return {
+        ..._state,
+        circuitStateLogs: csLogs.state,
+        circuitStateTraces: csTraces.state,
+        circuitStateMetrics: csMetrics.state,
+        circuitOpenCountLogs: csLogs.openCount,
+        circuitOpenCountTraces: csTraces.openCount,
+        circuitOpenCountMetrics: csMetrics.openCount,
+        setupError: _setupError,
+    };
+}
+export function setSetupError(error) {
+    _setupError = error;
+}
+export function _incrementHealth(field, by = 1) {
+    _state[field] += by;
+}
+/** Map a signal name to the per-signal export-failures field. */
+export function _exportFailuresField(signal) {
+    if (signal === 'traces')
+        return 'exportFailuresTraces';
+    if (signal === 'metrics')
+        return 'exportFailuresMetrics';
+    return 'exportFailuresLogs';
+}
+/** Map a signal name to the per-signal retries field. */
+export function _retriesField(signal) {
+    if (signal === 'traces')
+        return 'retriesTraces';
+    if (signal === 'metrics')
+        return 'retriesMetrics';
+    return 'retriesLogs';
+}
+/** Map a signal name to the per-signal export latency field. */
+export function _exportLatencyField(signal) {
+    if (signal === 'traces')
+        return 'exportLatencyMsTraces';
+    if (signal === 'metrics')
+        return 'exportLatencyMsMetrics';
+    return 'exportLatencyMsLogs';
+}
+export function _recordExportLatency(signal, ms) {
+    _state[_exportLatencyField(signal)] = ms;
+}
+export function _resetHealthForTests() {
+    _state.logsEmitted = 0;
+    _state.logsDropped = 0;
+    _state.tracesEmitted = 0;
+    _state.tracesDropped = 0;
+    _state.metricsEmitted = 0;
+    _state.metricsDropped = 0;
+    _state.exportFailuresLogs = 0;
+    _state.exportFailuresTraces = 0;
+    _state.exportFailuresMetrics = 0;
+    _state.retriesLogs = 0;
+    _state.retriesTraces = 0;
+    _state.retriesMetrics = 0;
+    _state.exportLatencyMsLogs = 0;
+    _state.exportLatencyMsTraces = 0;
+    _state.exportLatencyMsMetrics = 0;
+    _state.asyncBlockingRiskLogs = 0;
+    _state.asyncBlockingRiskTraces = 0;
+    _state.asyncBlockingRiskMetrics = 0;
+    _setupError = null;
+}

package/dist/index.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @provide-io/telemetry — TypeScript structured logging + OTEL
+ *
+ * Feature parity with the Python provide.telemetry package.
+ *
+ * Quick start:
+ *   import { setupTelemetry, getLogger, bindContext } from '@provide-io/telemetry';
+ *
+ *   setupTelemetry({ serviceName: 'my-app', logLevel: 'debug' });
+ *   const log = getLogger('api');
+ *   log.info({ event: 'request_ok', method: 'GET', path: '/api/v1/users', status: 200 });
+ */
+export { setupTelemetry, applyConfigPolicies, getConfig, configFromEnv, parseOtlpHeaders, redactConfig, version, __version__, } from './config';
+export type { TelemetryConfig, RuntimeOverrides } from './config';
+export { getLogger, logger } from './logger';
+export type { Logger } from './logger';
+export { bindContext, unbindContext, clearContext, getContext, runWithContext, bindSessionContext, getSessionId, clearSessionContext, } from './context';
+export { computeErrorFingerprint } from './fingerprint';
+export { formatPretty, supportsColor } from './pretty';
+export { counter, gauge, histogram, getMeter, CounterInstrument, GaugeInstrument, HistogramInstrument, } from './metrics';
+export type { Counter, Histogram, Meter, MetricOptions, UpDownCounter } from './metrics';
+export { withTrace, traceDecorator as trace, getActiveTraceIds, getTracer, tracer, setTraceContext, getTraceContext, } from './tracing';
+export { registerOtelProviders } from './otel';
+export { sanitize, DEFAULT_SANITIZE_FIELDS, sanitizePayload, registerPiiRule, getPiiRules, replacePiiRules, resetPiiRulesForTests, } from './pii';
+export type { MaskMode, PIIRule, SanitizePayloadOptions } from './pii';
+export { TelemetryError, ConfigurationError } from './exceptions';
+export { getHealthSnapshot, setSetupError } from './health';
+export type { HealthSnapshot } from './health';
+export { setQueuePolicy, getQueuePolicy, tryAcquire, release } from './backpressure';
+export type { QueuePolicy, QueueTicket } from './backpressure';
+export { OVERFLOW_VALUE, registerCardinalityLimit, getCardinalityLimits, clearCardinalityLimits, guardAttributes, } from './cardinality';
+export type { CardinalityLimit } from './cardinality';
+export { setSamplingPolicy, getSamplingPolicy, shouldSample } from './sampling';
+export type { SamplingPolicy } from './sampling';
+export { setExporterPolicy, getExporterPolicy, runWithResilience, getCircuitState, TelemetryTimeoutError, } from './resilience';
+export type { ExporterPolicy, CircuitState } from './resilience';
+export { EventSchemaError, event, eventName, validateEventName, validateRequiredKeys, } from './schema';
+export type { EventRecord } from './schema';
+export { recordRedMetrics, recordUseMetrics, classifyError } from './slo';
+export type { ErrorClassification } from './slo';
+export { extractW3cContext, bindPropagationContext, clearPropagationContext, getActivePropagationContext, } from './propagation';
+export type { PropagationContext } from './propagation';
+export { getRuntimeConfig, updateRuntimeConfig, reloadRuntimeFromEnv, reconfigureTelemetry, } from './runtime';
+export { resetTelemetryState, resetTraceContext, telemetryTestPlugin } from './testing';
+export type { ConsentLevel } from './consent';
+export { setConsentLevel, getConsentLevel, shouldAllow, loadConsentFromEnv, resetConsentForTests, } from './consent';
+export type { DataClass, ClassificationRule, ClassificationPolicy } from './classification';
+export { registerClassificationRules, setClassificationPolicy, getClassificationPolicy, resetClassificationForTests, } from './classification';
+export type { RedactionReceipt } from './receipts';
+export { enableReceipts, getEmittedReceiptsForTests, resetReceiptsForTests } from './receipts';
+export { shutdownTelemetry } from './shutdown';
+//# 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":"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"}

package/dist/index.js

@@ -0,0 +1,59 @@
+// SPDX-FileCopyrightText: Copyright (c) 2025-2026 provide.io llc. All rights reserved.
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * @provide-io/telemetry — TypeScript structured logging + OTEL
+ *
+ * Feature parity with the Python provide.telemetry package.
+ *
+ * Quick start:
+ *   import { setupTelemetry, getLogger, bindContext } from '@provide-io/telemetry';
+ *
+ *   setupTelemetry({ serviceName: 'my-app', logLevel: 'debug' });
+ *   const log = getLogger('api');
+ *   log.info({ event: 'request_ok', method: 'GET', path: '/api/v1/users', status: 200 });
+ */
+// Config + setup
+export { setupTelemetry, applyConfigPolicies, getConfig, configFromEnv, parseOtlpHeaders, redactConfig, version, __version__, } from './config';
+// Logger
+export { getLogger, logger } from './logger';
+// Context binding (mirrors Python bind_context / unbind_context / clear_context)
+export { bindContext, unbindContext, clearContext, getContext, runWithContext, bindSessionContext, getSessionId, clearSessionContext, } from './context';
+// Error fingerprinting (mirrors Python add_error_fingerprint processor)
+export { computeErrorFingerprint } from './fingerprint';
+// Pretty ANSI renderer (mirrors Python PrettyRenderer)
+export { formatPretty, supportsColor } from './pretty';
+// Metrics (mirrors Python counter / gauge / histogram)
+export { counter, gauge, histogram, getMeter, CounterInstrument, GaugeInstrument, HistogramInstrument, } from './metrics';
+// Tracing (mirrors Python @trace decorator)
+export { withTrace, traceDecorator as trace, getActiveTraceIds, getTracer, tracer, setTraceContext, getTraceContext, } from './tracing';
+// Optional OTEL SDK wiring (call after setupTelemetry to activate exporters)
+export { registerOtelProviders } from './otel';
+// PII sanitization utilities
+export { sanitize, DEFAULT_SANITIZE_FIELDS, sanitizePayload, registerPiiRule, getPiiRules, replacePiiRules, resetPiiRulesForTests, } from './pii';
+// Exceptions
+export { TelemetryError, ConfigurationError } from './exceptions';
+// Health
+export { getHealthSnapshot, setSetupError } from './health';
+// Backpressure
+export { setQueuePolicy, getQueuePolicy, tryAcquire, release } from './backpressure';
+// Cardinality
+export { OVERFLOW_VALUE, registerCardinalityLimit, getCardinalityLimits, clearCardinalityLimits, guardAttributes, } from './cardinality';
+// Sampling
+export { setSamplingPolicy, getSamplingPolicy, shouldSample } from './sampling';
+// Resilience
+export { setExporterPolicy, getExporterPolicy, runWithResilience, getCircuitState, TelemetryTimeoutError, } from './resilience';
+// Schema
+export { EventSchemaError, event, eventName, validateEventName, validateRequiredKeys, } from './schema';
+// SLO
+export { recordRedMetrics, recordUseMetrics, classifyError } from './slo';
+// Propagation
+export { extractW3cContext, bindPropagationContext, clearPropagationContext, getActivePropagationContext, } from './propagation';
+// Runtime reconfiguration
+export { getRuntimeConfig, updateRuntimeConfig, reloadRuntimeFromEnv, reconfigureTelemetry, } from './runtime';
+// Test utilities
+export { resetTelemetryState, resetTraceContext, telemetryTestPlugin } from './testing';
+export { setConsentLevel, getConsentLevel, shouldAllow, loadConsentFromEnv, resetConsentForTests, } from './consent';
+export { registerClassificationRules, setClassificationPolicy, getClassificationPolicy, resetClassificationForTests, } from './classification';
+export { enableReceipts, getEmittedReceiptsForTests, resetReceiptsForTests } from './receipts';
+// Shutdown
+export { shutdownTelemetry } from './shutdown';

package/dist/logger.d.ts

@@ -0,0 +1,28 @@
+/** Public Logger interface — consumers should type against this, not pino.Logger. */
+export interface Logger {
+    trace(obj: Record<string, unknown>, msg?: string): void;
+    debug(obj: Record<string, unknown>, msg?: string): void;
+    info(obj: Record<string, unknown>, msg?: string): void;
+    warn(obj: Record<string, unknown>, msg?: string): void;
+    error(obj: Record<string, unknown>, msg?: string): void;
+    /** Create a child logger with additional bound fields. */
+    child(bindings: Record<string, unknown>): Logger;
+}
+/**
+ * Build the write hook that enriches, sanitizes, captures, and optionally
+ * emits each log record.  Config is read dynamically on every invocation so
+ * that resetTelemetryState() + setupTelemetry() changes take effect without
+ * needing to rebuild the hook closure.
+ */
+export declare function makeWriteHook(): (obj: object) => void;
+/**
+ * Return a logger for the given name.
+ * Name appears as the `name` field in every log record.
+ * Mirrors Python: get_logger(name)
+ */
+export declare function getLogger(name?: string): Logger;
+/** Reset the root logger (forces re-creation with current config on next call). */
+export declare function _resetRootLogger(): void;
+/** Module-level lazy singleton logger. Mirrors Python: logger = get_logger('default'). */
+export declare const logger: Logger;
+//# 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":"AAoCA,qFAAqF;AACrF,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxD,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxD,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvD,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvD,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxD,0DAA0D;IAC1D,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;CAClD;AAKD;;;;;GAKG;AACH,wBAAgB,aAAa,KAEnB,KAAK,MAAM,KAAG,IAAI,CA8G3B;AA+ED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAgB/C;AAED,mFAAmF;AAEnF,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED,0FAA0F;AAE1F,eAAO,MAAM,MAAM,EAAE,MAOpB,CAAC"}