apcore-js 0.18.0 → 0.20.0

package/dist/observability/error-history.d.ts

@@ -1,33 +1,62 @@
 /**
- * Error history with ring-buffer eviction and deduplication.
+ * Error history with SHA-256 fingerprinting, min-heap O(log N) eviction,
+ * and pluggable observability storage.
  */
 import { ModuleError } from '../errors.js';
+import { type ObservabilityStore } from './store.js';
+import { type StorageBackend } from './storage.js';
 export interface ErrorEntry {
     readonly moduleId: string;
     readonly code: string;
     readonly message: string;
     readonly aiGuidance: string | null;
     readonly timestamp: string;
+    readonly fingerprint: string;
     count: number;
     firstOccurred: string;
     lastOccurred: string;
 }
+/** Replace ephemeral values with placeholders before fingerprint hashing. */
+export declare function normalizeMessage(msg: string): string;
+/** Compute SHA-256(error_code:module_id:normalized_message) as 64-char hex. */
+export declare function computeFingerprint(errorCode: string, moduleId: string, message: string): string;
+export interface ErrorHistoryOptions {
+    maxEntriesPerModule?: number;
+    maxTotalEntries?: number;
+    store?: ObservabilityStore;
+    /** Pluggable key/value storage backend (Issue #43 §1). Optional. */
+    storage?: StorageBackend;
+}
 /**
- * Ring buffer storing recent error details per module.
- * Supports deduplication by (code, message) within each module,
- * per-module eviction, and global total eviction.
+ * Thread-safe error tracker with min-heap O(log N) eviction and SHA-256 deduplication.
+ *
+ * Data structures:
+ *   _fpIndex: fingerprint → ErrorEntry          O(1) dedup lookup
+ *   _moduleIndex: module_id → ErrorEntry[]      O(1) module lookup
+ *   _heap: min-heap keyed on (lastOccurred, seq) O(log N) eviction of oldest
+ *
+ * Lazy deletion: stale heap items (from dedup timestamp refreshes) are skipped on pop.
  */
 export declare class ErrorHistory {
     private readonly _maxEntriesPerModule;
     private readonly _maxTotalEntries;
-    private readonly _entries;
-    constructor(maxEntriesPerModule?: number, maxTotalEntries?: number);
+    private readonly _store;
+    private readonly _storage;
+    private readonly _fpIndex;
+    private readonly _moduleIndex;
+    private readonly _heap;
+    private _seq;
+    constructor(options?: ErrorHistoryOptions);
+    get store(): ObservabilityStore;
+    /** The pluggable storage backend (Issue #43 §1). */
+    get storage(): StorageBackend;
     record(moduleId: string, error: ModuleError): void;
     get(moduleId: string, limit?: number): ErrorEntry[];
+    getAll(limit?: number): ErrorEntry[];
     clear(): void;
     clearModule(moduleId: string): void;
-    getAll(limit?: number): ErrorEntry[];
     private _evictModule;
     private _evictTotal;
+    private _popOldest;
 }
 //# sourceMappingURL=error-history.d.ts.map

package/dist/observability/error-history.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-history.d.ts","sourceRoot":"","sources":["../../src/observability/error-history.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwC;gBAErD,mBAAmB,GAAE,MAAW,EAAE,eAAe,GAAE,MAAa;IAK5E,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI;IAgClD,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE;IAMnD,KAAK,IAAI,IAAI;IAIb,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAInC,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE;IASpC,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,WAAW;CA0BpB"}
+{"version":3,"file":"error-history.d.ts","sourceRoot":"","sources":["../../src/observability/error-history.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAA8B,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAE3E,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAMD,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAcpD;AAED,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAI/F;AAsED,MAAM,WAAW,mBAAmB;IAClC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,oEAAoE;IACpE,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED;;;;;;;;;GASG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsC;IAC/D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwC;IACrE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0B;IAChD,OAAO,CAAC,IAAI,CAAK;gBAEL,OAAO,GAAE,mBAAwB;IAO7C,IAAI,KAAK,IAAI,kBAAkB,CAE9B;IAED,oDAAoD;IACpD,IAAI,OAAO,IAAI,cAAc,CAE5B;IAED,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI;IAyClD,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE;IAMnD,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE;IAMpC,KAAK,IAAI,IAAI;IAMb,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAUnC,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,UAAU;CAmBnB"}

package/dist/observability/error-history.js

@@ -1,30 +1,128 @@
 /**
- * Error history with ring-buffer eviction and deduplication.
+ * Error history with SHA-256 fingerprinting, min-heap O(log N) eviction,
+ * and pluggable observability storage.
  */
+import { createHash } from 'node:crypto';
+import { InMemoryObservabilityStore } from './store.js';
+import { InMemoryStorageBackend } from './storage.js';
+// ---------------------------------------------------------------------------
+// Message normalization and fingerprint computation
+// ---------------------------------------------------------------------------
+/** Replace ephemeral values with placeholders before fingerprint hashing. */
+export function normalizeMessage(msg) {
+    // Step 1: UUID patterns (8-4-4-4-12 hex)
+    msg = msg.replace(/[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}/g, '<UUID>');
+    // Step 2: ISO 8601 timestamps (before integers to protect 4-digit years)
+    msg = msg.replace(/\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})?)?/g, '<TIMESTAMP>');
+    // Step 3: integers >= 4 digits
+    msg = msg.replace(/\b\d{4,}\b/g, '<ID>');
+    return msg.trim().toLowerCase();
+}
+/** Compute SHA-256(error_code:module_id:normalized_message) as 64-char hex. */
+export function computeFingerprint(errorCode, moduleId, message) {
+    const normalized = normalizeMessage(message);
+    const raw = `${errorCode}:${moduleId}:${normalized}`;
+    return createHash('sha256').update(raw, 'utf8').digest('hex');
+}
+function heapCompare(a, b) {
+    if (a[0] < b[0])
+        return -1;
+    if (a[0] > b[0])
+        return 1;
+    return a[1] - b[1];
+}
+class MinHeap {
+    _data = [];
+    get size() {
+        return this._data.length;
+    }
+    push(item) {
+        this._data.push(item);
+        this._siftUp(this._data.length - 1);
+    }
+    pop() {
+        if (this._data.length === 0)
+            return undefined;
+        const top = this._data[0];
+        const last = this._data.pop();
+        if (this._data.length > 0) {
+            this._data[0] = last;
+            this._siftDown(0);
+        }
+        return top;
+    }
+    _siftUp(idx) {
+        while (idx > 0) {
+            const parent = Math.floor((idx - 1) / 2);
+            if (heapCompare(this._data[idx], this._data[parent]) < 0) {
+                [this._data[idx], this._data[parent]] = [this._data[parent], this._data[idx]];
+                idx = parent;
+            }
+            else
+                break;
+        }
+    }
+    _siftDown(idx) {
+        const n = this._data.length;
+        while (true) {
+            let smallest = idx;
+            const left = 2 * idx + 1;
+            const right = 2 * idx + 2;
+            if (left < n && heapCompare(this._data[left], this._data[smallest]) < 0) {
+                smallest = left;
+            }
+            if (right < n && heapCompare(this._data[right], this._data[smallest]) < 0) {
+                smallest = right;
+            }
+            if (smallest === idx)
+                break;
+            [this._data[idx], this._data[smallest]] = [this._data[smallest], this._data[idx]];
+            idx = smallest;
+        }
+    }
+}
 /**
- * Ring buffer storing recent error details per module.
- * Supports deduplication by (code, message) within each module,
- * per-module eviction, and global total eviction.
+ * Thread-safe error tracker with min-heap O(log N) eviction and SHA-256 deduplication.
+ *
+ * Data structures:
+ *   _fpIndex: fingerprint → ErrorEntry          O(1) dedup lookup
+ *   _moduleIndex: module_id → ErrorEntry[]      O(1) module lookup
+ *   _heap: min-heap keyed on (lastOccurred, seq) O(log N) eviction of oldest
+ *
+ * Lazy deletion: stale heap items (from dedup timestamp refreshes) are skipped on pop.
  */
 export class ErrorHistory {
     _maxEntriesPerModule;
     _maxTotalEntries;
-    _entries = new Map();
-    constructor(maxEntriesPerModule = 50, maxTotalEntries = 1000) {
-        this._maxEntriesPerModule = maxEntriesPerModule;
-        this._maxTotalEntries = maxTotalEntries;
+    _store;
+    _storage;
+    _fpIndex = new Map();
+    _moduleIndex = new Map();
+    _heap = new MinHeap();
+    _seq = 0;
+    constructor(options = {}) {
+        this._maxEntriesPerModule = options.maxEntriesPerModule ?? 50;
+        this._maxTotalEntries = options.maxTotalEntries ?? 1000;
+        this._store = options.store ?? new InMemoryObservabilityStore();
+        this._storage = options.storage ?? new InMemoryStorageBackend();
+    }
+    get store() {
+        return this._store;
+    }
+    /** The pluggable storage backend (Issue #43 §1). */
+    get storage() {
+        return this._storage;
     }
     record(moduleId, error) {
         const now = new Date().toISOString();
-        let moduleEntries = this._entries.get(moduleId);
-        if (!moduleEntries) {
-            moduleEntries = [];
-            this._entries.set(moduleId, moduleEntries);
-        }
-        const existing = moduleEntries.find((e) => e.code === error.code && e.message === error.message);
-        if (existing) {
+        const fp = computeFingerprint(error.code, moduleId, error.message);
+        const existing = this._fpIndex.get(fp);
+        if (existing !== undefined) {
             existing.count++;
             existing.lastOccurred = now;
+            this._seq++;
+            this._heap.push([now, this._seq, existing]);
+            this._store.recordError(existing);
             return;
         }
         const entry = {
@@ -33,63 +131,84 @@ export class ErrorHistory {
             message: error.message,
             aiGuidance: error.aiGuidance,
             timestamp: now,
+            fingerprint: fp,
             count: 1,
             firstOccurred: now,
             lastOccurred: now,
         };
-        moduleEntries.push(entry);
-        this._evictModule(moduleEntries);
+        this._fpIndex.set(fp, entry);
+        const moduleEntries = this._moduleIndex.get(moduleId);
+        if (moduleEntries !== undefined) {
+            moduleEntries.push(entry);
+        }
+        else {
+            this._moduleIndex.set(moduleId, [entry]);
+        }
+        this._seq++;
+        this._heap.push([now, this._seq, entry]);
+        this._evictModule(moduleId);
         this._evictTotal();
+        this._store.recordError(entry);
     }
     get(moduleId, limit) {
-        const moduleEntries = this._entries.get(moduleId) ?? [];
+        const moduleEntries = this._moduleIndex.get(moduleId) ?? [];
         const result = [...moduleEntries].reverse();
         return limit !== undefined ? result.slice(0, limit) : result;
     }
+    getAll(limit) {
+        const all = [...this._fpIndex.values()];
+        all.sort((a, b) => (a.lastOccurred > b.lastOccurred ? -1 : 1));
+        return limit !== undefined ? all.slice(0, limit) : all;
+    }
     clear() {
-        this._entries.clear();
+        this._fpIndex.clear();
+        this._moduleIndex.clear();
+        this._store.clear();
     }
     clearModule(moduleId) {
-        this._entries.delete(moduleId);
-    }
-    getAll(limit) {
-        const all = [];
-        for (const entries of this._entries.values()) {
-            all.push(...entries);
+        const entries = this._moduleIndex.get(moduleId);
+        if (entries !== undefined) {
+            for (const entry of entries) {
+                this._fpIndex.delete(entry.fingerprint);
+            }
+            this._moduleIndex.delete(moduleId);
         }
-        all.sort((a, b) => (a.lastOccurred > b.lastOccurred ? -1 : 1));
-        return limit !== undefined ? all.slice(0, limit) : all;
     }
-    _evictModule(moduleEntries) {
-        while (moduleEntries.length > this._maxEntriesPerModule) {
-            moduleEntries.shift();
+    _evictModule(moduleId) {
+        const entries = this._moduleIndex.get(moduleId);
+        if (entries === undefined)
+            return;
+        while (entries.length > this._maxEntriesPerModule) {
+            const evicted = entries.shift();
+            this._fpIndex.delete(evicted.fingerprint);
+        }
+        if (entries.length === 0) {
+            this._moduleIndex.delete(moduleId);
         }
     }
     _evictTotal() {
-        let total = 0;
-        for (const entries of this._entries.values()) {
-            total += entries.length;
+        while (this._fpIndex.size > this._maxTotalEntries) {
+            this._popOldest();
         }
-        while (total > this._maxTotalEntries) {
-            let oldestEntry = null;
-            let oldestModuleId = null;
-            for (const [mid, entries] of this._entries) {
-                if (entries.length > 0) {
-                    const candidate = entries[0];
-                    if (oldestEntry === null || candidate.lastOccurred < oldestEntry.lastOccurred) {
-                        oldestEntry = candidate;
-                        oldestModuleId = mid;
+    }
+    _popOldest() {
+        while (this._heap.size > 0) {
+            const item = this._heap.pop();
+            const [ts, , entry] = item;
+            // Lazy deletion: skip if already evicted OR if entry was updated by dedup
+            if (this._fpIndex.has(entry.fingerprint) && entry.lastOccurred === ts) {
+                this._fpIndex.delete(entry.fingerprint);
+                const moduleEntries = this._moduleIndex.get(entry.moduleId);
+                if (moduleEntries !== undefined) {
+                    const idx = moduleEntries.indexOf(entry);
+                    if (idx >= 0)
+                        moduleEntries.splice(idx, 1);
+                    if (moduleEntries.length === 0) {
+                        this._moduleIndex.delete(entry.moduleId);
                     }
                 }
+                return;
             }
-            if (oldestModuleId === null)
-                break;
-            const entries = this._entries.get(oldestModuleId);
-            entries.shift();
-            if (entries.length === 0) {
-                this._entries.delete(oldestModuleId);
-            }
-            total--;
         }
     }
 }

package/dist/observability/error-history.js.map

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

package/dist/observability/index.d.ts

@@ -1,9 +1,20 @@
-export { TracingMiddleware, StdoutExporter, InMemoryExporter, OTLPExporter, createSpan } from './tracing.js';
+export { TracingMiddleware, StdoutExporter, InMemoryExporter, OTLPExporter, createSpan, } from './tracing.js';
 export type { Span, SpanExporter } from './tracing.js';
 export { MetricsCollector, MetricsMiddleware } from './metrics.js';
-export { ContextLogger, ObsLoggingMiddleware } from './context-logger.js';
-export { ErrorHistory } from './error-history.js';
-export type { ErrorEntry } from './error-history.js';
+export type { MetricsCollectorOptions } from './metrics.js';
+export { ContextLogger, ObsLoggingMiddleware, RedactionConfig, DEFAULT_REDACTION_FIELD_PATTERNS, } from './context-logger.js';
+export { ErrorHistory, normalizeMessage, computeFingerprint } from './error-history.js';
+export type { ErrorEntry, ErrorHistoryOptions } from './error-history.js';
 export { UsageCollector, UsageMiddleware, bucketKey } from './usage.js';
-export type { UsageRecord, CallerUsageSummary, HourlyBucket, ModuleUsageSummary, ModuleUsageDetail } from './usage.js';
+export { NoopUsageExporter, PeriodicUsageExporter } from './usage-exporter.js';
+export type { UsageExporter } from './usage-exporter.js';
+export type { UsageRecord, CallerUsageSummary, HourlyBucket, ModuleUsageSummary, ModuleUsageDetail, UsageCollectorOptions, } from './usage.js';
+export { InMemoryObservabilityStore } from './store.js';
+export type { ObservabilityStore, MetricPoint } from './store.js';
+export { InMemoryStorageBackend } from './storage.js';
+export type { StorageBackend } from './storage.js';
+export { BatchSpanProcessor, SimpleSpanProcessor } from './batch-span-processor.js';
+export type { SpanProcessor, BatchSpanProcessorOptions } from './batch-span-processor.js';
+export { PrometheusExporter } from './prometheus-exporter.js';
+export type { PrometheusExporterStartOptions } from './prometheus-exporter.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/observability/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC7G,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACxE,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,UAAU,GACX,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACnE,YAAY,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,gCAAgC,GACjC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxF,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AACxD,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACpF,YAAY,EAAE,aAAa,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAC1F,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,YAAY,EAAE,8BAA8B,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/observability/index.js

@@ -1,6 +1,11 @@
-export { TracingMiddleware, StdoutExporter, InMemoryExporter, OTLPExporter, createSpan } from './tracing.js';
+export { TracingMiddleware, StdoutExporter, InMemoryExporter, OTLPExporter, createSpan, } from './tracing.js';
 export { MetricsCollector, MetricsMiddleware } from './metrics.js';
-export { ContextLogger, ObsLoggingMiddleware } from './context-logger.js';
-export { ErrorHistory } from './error-history.js';
+export { ContextLogger, ObsLoggingMiddleware, RedactionConfig, DEFAULT_REDACTION_FIELD_PATTERNS, } from './context-logger.js';
+export { ErrorHistory, normalizeMessage, computeFingerprint } from './error-history.js';
 export { UsageCollector, UsageMiddleware, bucketKey } from './usage.js';
+export { NoopUsageExporter, PeriodicUsageExporter } from './usage-exporter.js';
+export { InMemoryObservabilityStore } from './store.js';
+export { InMemoryStorageBackend } from './storage.js';
+export { BatchSpanProcessor, SimpleSpanProcessor } from './batch-span-processor.js';
+export { PrometheusExporter } from './prometheus-exporter.js';
 //# sourceMappingURL=index.js.map

package/dist/observability/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE7G,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,UAAU,GACX,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEnE,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,gCAAgC,GACjC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExF,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAU/E,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAExD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEtD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/observability/metrics-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metrics-utils.d.ts","sourceRoot":"","sources":["../../src/observability/metrics-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,eAAO,MAAM,kBAAkB,8BAA8B,CAAC;AAC9D,eAAO,MAAM,uBAAuB,mCAAmC,CAAC;AAMxE;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGtE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,gBAAgB,EAAE,gBAAgB,EAClC,QAAQ,EAAE,MAAM,GACf;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAiB/D;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,gBAAgB,EAAE,gBAAgB,EAClC,QAAQ,EAAE,MAAM,GACf;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CA8BhD"}
+{"version":3,"file":"metrics-utils.d.ts","sourceRoot":"","sources":["../../src/observability/metrics-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,eAAO,MAAM,kBAAkB,8BAA8B,CAAC;AAC9D,eAAO,MAAM,uBAAuB,mCAAmC,CAAC;AAGxE;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGtE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,gBAAgB,EAAE,gBAAgB,EAClC,QAAQ,EAAE,MAAM,GACf;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAiB/D;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,gBAAgB,EAAE,gBAAgB,EAClC,QAAQ,EAAE,MAAM,GACf;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CA+BhD"}

package/dist/observability/metrics-utils.js

@@ -3,9 +3,6 @@
  */
 export const METRIC_CALLS_TOTAL = 'apcore_module_calls_total';
 export const METRIC_DURATION_SECONDS = 'apcore_module_duration_seconds';
-const DEFAULT_HISTOGRAM_BUCKETS = [
-    0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1.0, 2.5, 5.0, 10.0, 30.0, 60.0,
-];
 /**
  * Check if a metric key's labels contain an exact module_id match.
  * Keys have the format: "metric_name|module_id=foo,status=bar"
@@ -54,8 +51,9 @@ export function estimateP99FromHistogram(metricsCollector, moduleId) {
     const avgLatencyMs = countVal > 0 ? (sumVal / countVal) * 1000 : 0;
     let p99LatencyMs = 0;
     if (countVal > 0 && histograms.buckets) {
+        const buckets = metricsCollector.buckets;
         const target = countVal * 0.99;
-        for (const b of DEFAULT_HISTOGRAM_BUCKETS) {
+        for (const b of buckets) {
             const bkey = `${durationKey}|${b}`;
             const cumCount = histograms.buckets[bkey] ?? 0;
             if (cumCount >= target) {
@@ -64,7 +62,7 @@ export function estimateP99FromHistogram(metricsCollector, moduleId) {
             }
         }
         // All observations exceed the largest bucket
-        p99LatencyMs = DEFAULT_HISTOGRAM_BUCKETS[DEFAULT_HISTOGRAM_BUCKETS.length - 1] * 1000;
+        p99LatencyMs = (buckets[buckets.length - 1] ?? 0) * 1000;
     }
     return { avgLatencyMs, p99LatencyMs };
 }

package/dist/observability/metrics-utils.js.map

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

package/dist/observability/metrics.d.ts

@@ -3,14 +3,28 @@
  */
 import type { Context } from '../context.js';
 import { Middleware } from '../middleware/base.js';
+import { type ObservabilityStore } from './store.js';
+import { type StorageBackend } from './storage.js';
+export interface MetricsCollectorOptions {
+    buckets?: number[];
+    store?: ObservabilityStore;
+    /** Pluggable key/value storage backend (Issue #43 §1). Optional. */
+    storage?: StorageBackend;
+}
 export declare class MetricsCollector {
     static readonly DEFAULT_BUCKETS: number[];
     private _buckets;
+    private readonly _store;
+    private readonly _storage;
     private _counters;
     private _histogramSums;
     private _histogramCounts;
     private _histogramBuckets;
-    constructor(buckets?: number[]);
+    constructor(optionsOrBuckets?: MetricsCollectorOptions | number[]);
+    get store(): ObservabilityStore;
+    /** The pluggable storage backend (Issue #43 §1). */
+    get storage(): StorageBackend;
+    get buckets(): readonly number[];
     increment(name: string, labels: Record<string, string>, amount?: number): void;
     observe(name: string, labels: Record<string, string>, value: number): void;
     snapshot(): Record<string, unknown>;

package/dist/observability/metrics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/observability/metrics.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAYnD,qBAAa,gBAAgB;IAC3B,MAAM,CAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,EAAE,CAEvC;IAEF,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,cAAc,CAAkC;IACxD,OAAO,CAAC,gBAAgB,CAAkC;IAC1D,OAAO,CAAC,iBAAiB,CAAkC;gBAE/C,OAAO,CAAC,EAAE,MAAM,EAAE;IAI9B,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAE,MAAU,GAAG,IAAI;IAKjF,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAkB1E,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAWnC,KAAK,IAAI,IAAI;IAOb,gBAAgB,IAAI,MAAM;IAsD1B,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAItD,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAI1D,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI;CAGjE;AAwBD,qBAAa,iBAAkB,SAAQ,UAAU;IAC/C,OAAO,CAAC,UAAU,CAAmB;gBAEzB,SAAS,EAAE,gBAAgB;IAK9B,MAAM,CACb,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE,OAAO,GACf,IAAI;IAOE,KAAK,CACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE,OAAO,GACf,IAAI;IAUE,OAAO,CACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,OAAO,GACf,IAAI;CAWR"}
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/observability/metrics.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAA8B,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAY3E,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,oEAAoE;IACpE,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,qBAAa,gBAAgB;IAC3B,MAAM,CAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,EAAE,CAEvC;IAEF,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,cAAc,CAAkC;IACxD,OAAO,CAAC,gBAAgB,CAAkC;IAC1D,OAAO,CAAC,iBAAiB,CAAkC;gBAE/C,gBAAgB,CAAC,EAAE,uBAAuB,GAAG,MAAM,EAAE;IAajE,IAAI,KAAK,IAAI,kBAAkB,CAE9B;IAED,oDAAoD;IACpD,IAAI,OAAO,IAAI,cAAc,CAE5B;IAED,IAAI,OAAO,IAAI,SAAS,MAAM,EAAE,CAE/B;IAED,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAE,MAAU,GAAG,IAAI;IAKjF,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAkB1E,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAWnC,KAAK,IAAI,IAAI;IAOb,gBAAgB,IAAI,MAAM;IAsD1B,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAItD,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAI1D,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI;CAGjE;AAmCD,qBAAa,iBAAkB,SAAQ,UAAU;IAC/C,OAAO,CAAC,UAAU,CAAmB;gBAEzB,SAAS,EAAE,gBAAgB;IAK9B,MAAM,CACb,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE,OAAO,GACf,IAAI;IAOE,KAAK,CACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE,OAAO,GACf,IAAI;IAUE,OAAO,CACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,OAAO,GACf,IAAI;CAWR"}

package/dist/observability/metrics.js

@@ -3,6 +3,8 @@
  */
 import { ModuleError } from '../errors.js';
 import { Middleware } from '../middleware/base.js';
+import { InMemoryObservabilityStore } from './store.js';
+import { InMemoryStorageBackend } from './storage.js';
 const DESCRIPTIONS = {
     apcore_module_calls_total: 'Total module calls',
     apcore_module_errors_total: 'Total module errors',
@@ -16,12 +18,34 @@ export class MetricsCollector {
         0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1.0, 2.5, 5.0, 10.0, 30.0, 60.0,
     ];
     _buckets;
+    _store;
+    _storage;
     _counters = new Map();
     _histogramSums = new Map();
     _histogramCounts = new Map();
     _histogramBuckets = new Map();
-    constructor(buckets) {
-        this._buckets = buckets ? [...buckets].sort((a, b) => a - b) : [...MetricsCollector.DEFAULT_BUCKETS];
+    constructor(optionsOrBuckets) {
+        if (Array.isArray(optionsOrBuckets)) {
+            this._buckets = [...optionsOrBuckets].sort((a, b) => a - b);
+            this._store = new InMemoryObservabilityStore();
+            this._storage = new InMemoryStorageBackend();
+        }
+        else {
+            const buckets = optionsOrBuckets?.buckets;
+            this._buckets = buckets ? [...buckets].sort((a, b) => a - b) : [...MetricsCollector.DEFAULT_BUCKETS];
+            this._store = optionsOrBuckets?.store ?? new InMemoryObservabilityStore();
+            this._storage = optionsOrBuckets?.storage ?? new InMemoryStorageBackend();
+        }
+    }
+    get store() {
+        return this._store;
+    }
+    /** The pluggable storage backend (Issue #43 §1). */
+    get storage() {
+        return this._storage;
+    }
+    get buckets() {
+        return this._buckets;
     }
     increment(name, labels, amount = 1) {
         const key = `${name}|${labelsKey(labels)}`;
@@ -125,6 +149,16 @@ function parseLabels(lk) {
     }
     return result;
 }
+/**
+ * Escape a Prometheus exposition-format label value per
+ * https://prometheus.io/docs/instrumenting/exposition_formats/ :
+ *   backslash -> \\, double-quote -> \", newline -> \n.
+ * Without this, any label value containing `"`, `\` or `\n` silently breaks
+ * the exposition format and breaks downstream parsers.
+ */
+function escapeLabelValue(value) {
+    return value.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\n/g, '\\n');
+}
 function formatLabels(labels) {
     const entries = Object.entries(labels);
     if (entries.length === 0)
@@ -136,7 +170,7 @@ function formatLabels(labels) {
             return -1;
         return a.localeCompare(b);
     });
-    const pairs = sorted.map(([k, v]) => `${k}="${v}"`).join(',');
+    const pairs = sorted.map(([k, v]) => `${k}="${escapeLabelValue(v)}"`).join(',');
     return `{${pairs}}`;
 }
 export class MetricsMiddleware extends Middleware {