@softprobe/softprobe-js 2.0.0

package/dist/core/identifier.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Pure identifier builders for capture/replay matching.
+ * Keys must be built identically in capture and replay (design §6.2).
+ */
+/**
+ * HTTP identifier: "METHOD url" (method uppercased).
+ * @example httpIdentifier('POST', 'https://a/b') => 'POST https://a/b'
+ */
+export declare function httpIdentifier(method: string, url: string): string;
+/**
+ * Redis identifier: "CMD arg1 arg2 ..." (cmd uppercased, args joined by space).
+ * @example redisIdentifier('get', ['k']) => 'GET k'
+ */
+export declare function redisIdentifier(cmd: string, args: string[]): string;
+/**
+ * Postgres identifier: pass-through of SQL string (normalization deferred).
+ * Must be consistent in capture and replay; optional normalizeSql later.
+ */
+export declare function pgIdentifier(sql: string): string;
+//# sourceMappingURL=identifier.d.ts.map

package/dist/core/identifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifier.d.ts","sourceRoot":"","sources":["../../src/core/identifier.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAEnE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD"}

package/dist/core/identifier.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * Pure identifier builders for capture/replay matching.
+ * Keys must be built identically in capture and replay (design §6.2).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.httpIdentifier = httpIdentifier;
+exports.redisIdentifier = redisIdentifier;
+exports.pgIdentifier = pgIdentifier;
+/**
+ * HTTP identifier: "METHOD url" (method uppercased).
+ * @example httpIdentifier('POST', 'https://a/b') => 'POST https://a/b'
+ */
+function httpIdentifier(method, url) {
+    return `${method.toUpperCase()} ${url}`;
+}
+/**
+ * Redis identifier: "CMD arg1 arg2 ..." (cmd uppercased, args joined by space).
+ * @example redisIdentifier('get', ['k']) => 'GET k'
+ */
+function redisIdentifier(cmd, args) {
+    return `${cmd.toUpperCase()} ${args.join(' ')}`.trim();
+}
+/**
+ * Postgres identifier: pass-through of SQL string (normalization deferred).
+ * Must be consistent in capture and replay; optional normalizeSql later.
+ */
+function pgIdentifier(sql) {
+    return sql;
+}
+//# sourceMappingURL=identifier.js.map

package/dist/core/identifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifier.js","sourceRoot":"","sources":["../../src/core/identifier.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAMH,wCAEC;AAMD,0CAEC;AAMD,oCAEC;AAtBD;;;GAGG;AACH,SAAgB,cAAc,CAAC,MAAc,EAAE,GAAW;IACxD,OAAO,GAAG,MAAM,CAAC,WAAW,EAAE,IAAI,GAAG,EAAE,CAAC;AAC1C,CAAC;AAED;;;GAGG;AACH,SAAgB,eAAe,CAAC,GAAW,EAAE,IAAc;IACzD,OAAO,GAAG,GAAG,CAAC,WAAW,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;AACzD,CAAC;AAED;;;GAGG;AACH,SAAgB,YAAY,CAAC,GAAW;IACtC,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Foundation package surface.
+ */
+export * from './contracts';
+export * from './runtime';
+export * from './context';
+export * from './cassette';
+export * from './bindings';
+export * from './identifier';
+export * from './matcher';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,27 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Foundation package surface.
+ */
+__exportStar(require("./contracts"), exports);
+__exportStar(require("./runtime"), exports);
+__exportStar(require("./context"), exports);
+__exportStar(require("./cassette"), exports);
+__exportStar(require("./bindings"), exports);
+__exportStar(require("./identifier"), exports);
+__exportStar(require("./matcher"), exports);
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;GAEG;AACH,8CAA4B;AAC5B,4CAA0B;AAC1B,4CAA0B;AAC1B,6CAA2B;AAC3B,6CAA2B;AAC3B,+CAA6B;AAC7B,4CAA0B"}

package/dist/core/matcher/extract-key.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Key extraction and candidate filtering for default matcher (design §7.3).
+ * Derives { protocol, identifier } from a span; filters outbound records by key.
+ */
+import type { MatcherFn, SoftprobeCassetteRecord } from '../../types/schema';
+/** Key used for flat matching: protocol + identifier. */
+export type SpanKey = {
+    protocol: 'postgres' | 'redis' | 'http';
+    identifier: string;
+};
+/** Span-like with readable attributes (OTel Span or test span). */
+type ReadableSpan = {
+    attributes?: Record<string, unknown>;
+} | undefined;
+/**
+ * Extracts matching key from a span using PostgresSpan, RedisSpan, and HttpSpan.
+ * Returns the first non-null fromSpan result as { protocol, identifier }; unknown span yields null.
+ */
+export declare function extractKeyFromSpan(span: ReadableSpan): SpanKey | null;
+/**
+ * Returns only outbound records whose protocol and identifier match the key.
+ */
+export declare function filterOutboundCandidates(records: SoftprobeCassetteRecord[], key: SpanKey): SoftprobeCassetteRecord[];
+/**
+ * Per-key call sequence for default matcher: tracks the next candidate index
+ * per (protocol, identifier). getAndIncrement returns the current index and advances.
+ */
+export declare class CallSeq {
+    private next;
+    /**
+     * Returns the current index for this key and increments for the next call.
+     */
+    getAndIncrement(key: SpanKey): number;
+}
+/**
+ * Returns a MatcherFn that uses extractKeyFromSpan, filterOutboundCandidates,
+ * and CallSeq to pick an outbound record and return MOCK with its responsePayload.
+ */
+export declare function createDefaultMatcher(): MatcherFn;
+export {};
+//# sourceMappingURL=extract-key.d.ts.map

package/dist/core/matcher/extract-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-key.d.ts","sourceRoot":"","sources":["../../../src/core/matcher/extract-key.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAEV,SAAS,EACT,uBAAuB,EACxB,MAAM,oBAAoB,CAAC;AAK5B,yDAAyD;AACzD,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,EAAE,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,mEAAmE;AACnE,KAAK,YAAY,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,SAAS,CAAC;AAEzE;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,GAAG,IAAI,CAWrE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,uBAAuB,EAAE,EAClC,GAAG,EAAE,OAAO,GACX,uBAAuB,EAAE,CAO3B;AAMD;;;GAGG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,IAAI,CAA6B;IAEzC;;OAEG;IACH,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM;CAMtC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,SAAS,CAYhD"}

package/dist/core/matcher/extract-key.js

@@ -0,0 +1,80 @@
+"use strict";
+/**
+ * Key extraction and candidate filtering for default matcher (design §7.3).
+ * Derives { protocol, identifier } from a span; filters outbound records by key.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CallSeq = void 0;
+exports.extractKeyFromSpan = extractKeyFromSpan;
+exports.filterOutboundCandidates = filterOutboundCandidates;
+exports.createDefaultMatcher = createDefaultMatcher;
+const postgres_span_1 = require("../bindings/postgres-span");
+const redis_span_1 = require("../bindings/redis-span");
+const http_span_1 = require("../bindings/http-span");
+/**
+ * Extracts matching key from a span using PostgresSpan, RedisSpan, and HttpSpan.
+ * Returns the first non-null fromSpan result as { protocol, identifier }; unknown span yields null.
+ */
+function extractKeyFromSpan(span) {
+    const pg = postgres_span_1.PostgresSpan.fromSpan(span);
+    if (pg)
+        return { protocol: 'postgres', identifier: pg.identifier };
+    const redis = redis_span_1.RedisSpan.fromSpan(span);
+    if (redis)
+        return { protocol: 'redis', identifier: redis.identifier };
+    const http = http_span_1.HttpSpan.fromSpan(span);
+    if (http)
+        return { protocol: 'http', identifier: http.identifier };
+    return null;
+}
+/**
+ * Returns only outbound records whose protocol and identifier match the key.
+ */
+function filterOutboundCandidates(records, key) {
+    return records.filter((r) => r.type === 'outbound' &&
+        r.protocol === key.protocol &&
+        r.identifier === key.identifier);
+}
+function seqKey(key) {
+    return `${key.protocol}::${key.identifier}`;
+}
+/**
+ * Per-key call sequence for default matcher: tracks the next candidate index
+ * per (protocol, identifier). getAndIncrement returns the current index and advances.
+ */
+class CallSeq {
+    constructor() {
+        this.next = new Map();
+    }
+    /**
+     * Returns the current index for this key and increments for the next call.
+     */
+    getAndIncrement(key) {
+        const k = seqKey(key);
+        const idx = this.next.get(k) ?? 0;
+        this.next.set(k, idx + 1);
+        return idx;
+    }
+}
+exports.CallSeq = CallSeq;
+/**
+ * Returns a MatcherFn that uses extractKeyFromSpan, filterOutboundCandidates,
+ * and CallSeq to pick an outbound record and return MOCK with its responsePayload.
+ */
+function createDefaultMatcher() {
+    const callSeq = new CallSeq();
+    return (span, records) => {
+        const key = extractKeyFromSpan(span);
+        if (!key)
+            return { action: 'CONTINUE' };
+        const candidates = filterOutboundCandidates(records, key);
+        if (candidates.length === 0)
+            return { action: 'CONTINUE' };
+        const idx = callSeq.getAndIncrement(key);
+        if (idx >= candidates.length)
+            return { action: 'CONTINUE' };
+        const record = candidates[idx];
+        return { action: 'MOCK', payload: record?.responsePayload, traceId: record?.traceId };
+    };
+}
+//# sourceMappingURL=extract-key.js.map

package/dist/core/matcher/extract-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-key.js","sourceRoot":"","sources":["../../../src/core/matcher/extract-key.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAwBH,gDAWC;AAKD,4DAUC;AA4BD,oDAYC;AAnFD,6DAAyD;AACzD,uDAAmD;AACnD,qDAAiD;AAWjD;;;GAGG;AACH,SAAgB,kBAAkB,CAAC,IAAkB;IACnD,MAAM,EAAE,GAAG,4BAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,EAAE;QAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,CAAC,UAAU,EAAE,CAAC;IAEnE,MAAM,KAAK,GAAG,sBAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,KAAK;QAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC;IAEtE,MAAM,IAAI,GAAG,oBAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,IAAI;QAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;IAEnE,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAgB,wBAAwB,CACtC,OAAkC,EAClC,GAAY;IAEZ,OAAO,OAAO,CAAC,MAAM,CACnB,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,IAAI,KAAK,UAAU;QACrB,CAAC,CAAC,QAAQ,KAAK,GAAG,CAAC,QAAQ;QAC3B,CAAC,CAAC,UAAU,KAAK,GAAG,CAAC,UAAU,CAClC,CAAC;AACJ,CAAC;AAED,SAAS,MAAM,CAAC,GAAY;IAC1B,OAAO,GAAG,GAAG,CAAC,QAAQ,KAAK,GAAG,CAAC,UAAU,EAAE,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAa,OAAO;IAApB;QACU,SAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IAW3C,CAAC;IATC;;OAEG;IACH,eAAe,CAAC,GAAY;QAC1B,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;QAC1B,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AAZD,0BAYC;AAED;;;GAGG;AACH,SAAgB,oBAAoB;IAClC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAC9B,OAAO,CAAC,IAAI,EAAE,OAAO,EAAiB,EAAE;QACtC,MAAM,GAAG,GAAG,kBAAkB,CAAC,IAAoB,CAAC,CAAC;QACrD,IAAI,CAAC,GAAG;YAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QACxC,MAAM,UAAU,GAAG,wBAAwB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC1D,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QAC3D,MAAM,GAAG,GAAG,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,GAAG,IAAI,UAAU,CAAC,MAAM;YAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QAC5D,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IACxF,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/matcher/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shared matcher contracts and implementations.
+ */
+export { SemanticMatcher } from './matcher';
+export { SoftprobeMatcher } from './softprobe-matcher';
+export { CallSeq, createDefaultMatcher, extractKeyFromSpan, filterOutboundCandidates, type SpanKey, } from './extract-key';
+export { buildBySpanIdIndex, createTopologyMatcher, filterCandidatesByKey, getLiveParentName, selectLineagePool, } from './topology';
+export { getRecordsForTrace } from './store-accessor';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/matcher/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/matcher/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EACL,OAAO,EACP,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,OAAO,GACb,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/core/matcher/index.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRecordsForTrace = exports.selectLineagePool = exports.getLiveParentName = exports.filterCandidatesByKey = exports.createTopologyMatcher = exports.buildBySpanIdIndex = exports.filterOutboundCandidates = exports.extractKeyFromSpan = exports.createDefaultMatcher = exports.CallSeq = exports.SoftprobeMatcher = exports.SemanticMatcher = void 0;
+/**
+ * Shared matcher contracts and implementations.
+ */
+var matcher_1 = require("./matcher");
+Object.defineProperty(exports, "SemanticMatcher", { enumerable: true, get: function () { return matcher_1.SemanticMatcher; } });
+var softprobe_matcher_1 = require("./softprobe-matcher");
+Object.defineProperty(exports, "SoftprobeMatcher", { enumerable: true, get: function () { return softprobe_matcher_1.SoftprobeMatcher; } });
+var extract_key_1 = require("./extract-key");
+Object.defineProperty(exports, "CallSeq", { enumerable: true, get: function () { return extract_key_1.CallSeq; } });
+Object.defineProperty(exports, "createDefaultMatcher", { enumerable: true, get: function () { return extract_key_1.createDefaultMatcher; } });
+Object.defineProperty(exports, "extractKeyFromSpan", { enumerable: true, get: function () { return extract_key_1.extractKeyFromSpan; } });
+Object.defineProperty(exports, "filterOutboundCandidates", { enumerable: true, get: function () { return extract_key_1.filterOutboundCandidates; } });
+var topology_1 = require("./topology");
+Object.defineProperty(exports, "buildBySpanIdIndex", { enumerable: true, get: function () { return topology_1.buildBySpanIdIndex; } });
+Object.defineProperty(exports, "createTopologyMatcher", { enumerable: true, get: function () { return topology_1.createTopologyMatcher; } });
+Object.defineProperty(exports, "filterCandidatesByKey", { enumerable: true, get: function () { return topology_1.filterCandidatesByKey; } });
+Object.defineProperty(exports, "getLiveParentName", { enumerable: true, get: function () { return topology_1.getLiveParentName; } });
+Object.defineProperty(exports, "selectLineagePool", { enumerable: true, get: function () { return topology_1.selectLineagePool; } });
+var store_accessor_1 = require("./store-accessor");
+Object.defineProperty(exports, "getRecordsForTrace", { enumerable: true, get: function () { return store_accessor_1.getRecordsForTrace; } });
+//# sourceMappingURL=index.js.map

package/dist/core/matcher/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/matcher/index.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,qCAA4C;AAAnC,0GAAA,eAAe,OAAA;AACxB,yDAAuD;AAA9C,qHAAA,gBAAgB,OAAA;AACzB,6CAMuB;AALrB,sGAAA,OAAO,OAAA;AACP,mHAAA,oBAAoB,OAAA;AACpB,iHAAA,kBAAkB,OAAA;AAClB,uHAAA,wBAAwB,OAAA;AAG1B,uCAMoB;AALlB,8GAAA,kBAAkB,OAAA;AAClB,iHAAA,qBAAqB,OAAA;AACrB,iHAAA,qBAAqB,OAAA;AACrB,6GAAA,iBAAiB,OAAA;AACjB,6GAAA,iBAAiB,OAAA;AAEnB,mDAAsD;AAA7C,oHAAA,kBAAkB,OAAA"}

package/dist/core/matcher/matcher.d.ts

@@ -0,0 +1,25 @@
+import type { ReadableSpan } from '@opentelemetry/sdk-trace-base';
+import type { MatchRequest, CustomMatcherFn } from '../../types/schema';
+export declare class SemanticMatcher {
+    private readonly recordedSpans;
+    /** Tracks call count per (protocol, identifier, liveParentName) for sequential N+1 resolution. */
+    private readonly callSequenceMap;
+    /** User-registered matchers evaluated before the default tree-matching algorithm. */
+    private readonly customMatchers;
+    constructor(recordedSpans: ReadableSpan[]);
+    /**
+     * Registers a custom matcher. Custom matchers are run before the default tree-matching logic.
+     * - MOCK: return the given payload (no tree matching, no network).
+     * - CONTINUE: fall through to tree matching; the call is still replayed from the recording.
+     * - PASSTHROUGH: request live network for this call; in strict mode throws (not allowed).
+     */
+    addMatcher(fn: CustomMatcherFn): void;
+    /**
+     * Finds a recorded span that matches the live request by protocol and identifier,
+     * and optionally by lineage: the recorded span's parent name matches the current
+     * active OpenTelemetry span's name (semantic tree matching).
+     * Custom matchers are evaluated first; if any returns MOCK, that payload is returned; if any returns PASSTHROUGH, throws.
+     */
+    findMatch(request: MatchRequest): unknown;
+}
+//# sourceMappingURL=matcher.d.ts.map

package/dist/core/matcher/matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.d.ts","sourceRoot":"","sources":["../../../src/core/matcher/matcher.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAQxE,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiB;IAC/C,kGAAkG;IAClG,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA6B;IAC7D,qFAAqF;IACrF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyB;gBAE5C,aAAa,EAAE,YAAY,EAAE;IAIzC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,EAAE,eAAe,GAAG,IAAI;IAIrC;;;;;OAKG;IACH,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;CA0D1C"}

package/dist/core/matcher/matcher.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SemanticMatcher = void 0;
+const api_1 = require("@opentelemetry/api");
+const RESPONSE_BODY_KEY = 'softprobe.response.body';
+const PROTOCOL_KEY = 'softprobe.protocol';
+const IDENTIFIER_KEY = 'softprobe.identifier';
+// This is obsolete, we should use the new matcher instead
+// Deprecated: use SoftprobeMatcher instead
+class SemanticMatcher {
+    constructor(recordedSpans) {
+        /** Tracks call count per (protocol, identifier, liveParentName) for sequential N+1 resolution. */
+        this.callSequenceMap = new Map();
+        /** User-registered matchers evaluated before the default tree-matching algorithm. */
+        this.customMatchers = [];
+        this.recordedSpans = recordedSpans;
+    }
+    /**
+     * Registers a custom matcher. Custom matchers are run before the default tree-matching logic.
+     * - MOCK: return the given payload (no tree matching, no network).
+     * - CONTINUE: fall through to tree matching; the call is still replayed from the recording.
+     * - PASSTHROUGH: request live network for this call; in strict mode throws (not allowed).
+     */
+    addMatcher(fn) {
+        this.customMatchers.push(fn);
+    }
+    /**
+     * Finds a recorded span that matches the live request by protocol and identifier,
+     * and optionally by lineage: the recorded span's parent name matches the current
+     * active OpenTelemetry span's name (semantic tree matching).
+     * Custom matchers are evaluated first; if any returns MOCK, that payload is returned; if any returns PASSTHROUGH, throws.
+     */
+    findMatch(request) {
+        for (const matcher of this.customMatchers) {
+            const result = matcher(request, this.recordedSpans);
+            if (result.action === 'MOCK')
+                return result.payload;
+            if (result.action === 'PASSTHROUGH') {
+                throw new Error('[Softprobe] Network Passthrough not allowed in strict mode');
+            }
+        }
+        const candidates = this.recordedSpans.filter((span) => span.attributes[PROTOCOL_KEY] === request.protocol &&
+            span.attributes[IDENTIFIER_KEY] === request.identifier);
+        if (candidates.length === 0) {
+            throw new Error(`[Softprobe] No recorded traces found for ${request.protocol}: ${request.identifier}`);
+        }
+        const liveSpan = api_1.trace.getActiveSpan();
+        const liveParentName = liveSpan && typeof liveSpan.name === 'string'
+            ? liveSpan.name
+            : 'root';
+        const lineageMatches = candidates.filter((candidate) => {
+            const parentSpanId = candidate.parentSpanId;
+            if (parentSpanId == null)
+                return liveParentName === 'root';
+            const candidateParent = this.recordedSpans.find((s) => s.spanContext().spanId === parentSpanId);
+            return candidateParent != null && candidateParent.name === liveParentName;
+        });
+        let matched;
+        if (lineageMatches.length > 0) {
+            const sequenceKey = `${request.protocol}-${request.identifier}-${liveParentName}`;
+            const currentCount = this.callSequenceMap.get(sequenceKey) ?? 0;
+            // Wrap-around: if call count exceeds number of lineage matches, reuse the first match
+            matched = lineageMatches[currentCount] ?? lineageMatches[0];
+            this.callSequenceMap.set(sequenceKey, currentCount + 1);
+        }
+        else {
+            // Flat match: no lineage context, so we do not update callSequenceMap; always return first candidate.
+            matched = candidates[0];
+        }
+        const raw = matched.attributes[RESPONSE_BODY_KEY];
+        if (typeof raw !== 'string') {
+            throw new Error('[Softprobe] Missing or invalid softprobe.response.body on matched span');
+        }
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            throw new Error('[Softprobe] Invalid or non-JSON softprobe.response.body on matched span');
+        }
+    }
+}
+exports.SemanticMatcher = SemanticMatcher;
+//# sourceMappingURL=matcher.js.map

package/dist/core/matcher/matcher.js.map

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

package/dist/core/matcher/softprobe-matcher.d.ts

@@ -0,0 +1,41 @@
+import type { MatcherAction, MatcherFn, SoftprobeCassetteRecord } from '../../types/schema';
+export declare class SoftprobeMatcher {
+    /** Matcher functions run in registration order; first non-CONTINUE wins. */
+    private fns;
+    /** Cassette records for this replay context (one trace). Set by SoftprobeContext.run(REPLAY). */
+    private records;
+    /** Appends a matcher function. Fns are run in registration order. */
+    use(fn: MatcherFn): void;
+    /** Removes all registered matcher fns. */
+    clear(): void;
+    /**
+     * Sets the cassette records for this context. Called by SoftprobeContext.run(REPLAY)
+     * after loading from storage so each matcher fn receives them in match().
+     */
+    _setRecords(records: SoftprobeCassetteRecord[]): void;
+    /**
+     * Returns the records for this replay context (context-scoped).
+     * Used by getRecordsForTrace when the active context has a matcher, so HTTP replay
+     * (MSW interceptor) reads from context instead of a global cache.
+     */
+    _getRecords(): SoftprobeCassetteRecord[];
+    /**
+     * Returns the trace id for the current request (from first record).
+     * Used when context/span do not propagate to fetch so the interceptor can identify the trace.
+     */
+    _getTraceId(): string | undefined;
+    /**
+     * Returns the inbound record's responsePayload.body, with .http extracted when present.
+     * Used by HTTP replay (MSW interceptor) so the mock response body matches the recorded inbound and diff passes.
+     */
+    _getInboundHttpBody(): unknown;
+    /**
+     * Runs registered matcher fns in order against the current active span (or spanOverride).
+     * Returns the first non-CONTINUE action (MOCK or PASSTHROUGH), or CONTINUE if all fns continue.
+     * Each fn receives the span and this context's records (design §7.1).
+     */
+    match(spanOverride?: import('@opentelemetry/api').Span | {
+        attributes?: Record<string, unknown>;
+    }): MatcherAction;
+}
+//# sourceMappingURL=softprobe-matcher.d.ts.map

package/dist/core/matcher/softprobe-matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"softprobe-matcher.d.ts","sourceRoot":"","sources":["../../../src/core/matcher/softprobe-matcher.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE5F,qBAAa,gBAAgB;IAC3B,4EAA4E;IAC5E,OAAO,CAAC,GAAG,CAAmB;IAC9B,iGAAiG;IACjG,OAAO,CAAC,OAAO,CAAiC;IAEhD,qEAAqE;IACrE,GAAG,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI;IAIxB,0CAA0C;IAC1C,KAAK,IAAI,IAAI;IAIb;;;OAGG;IACH,WAAW,CAAC,OAAO,EAAE,uBAAuB,EAAE,GAAG,IAAI;IAIrD;;;;OAIG;IACH,WAAW,IAAI,uBAAuB,EAAE;IAIxC;;;OAGG;IACH,WAAW,IAAI,MAAM,GAAG,SAAS;IAIjC;;;OAGG;IACH,mBAAmB,IAAI,OAAO;IAoB9B;;;;OAIG;IACH,KAAK,CAAC,YAAY,CAAC,EAAE,OAAO,oBAAoB,EAAE,IAAI,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,aAAa;CAQlH"}

package/dist/core/matcher/softprobe-matcher.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SoftprobeMatcher = void 0;
+/**
+ * SoftprobeMatcher: per-context replay matcher for outbound calls.
+ *
+ * One instance is created per SoftprobeContext.run(REPLAY) and stored in the OTel context
+ * for that request. It holds the cassette records for that trace and runs a list of MatcherFn
+ * in order; match() returns the first non-CONTINUE action (MOCK or PASSTHROUGH).
+ *
+ * Design §7.1: use(fn) appends; matchers do not execute passthrough. Records are context-scoped
+ * (loaded from the cassette for this run's traceId).
+ */
+const api_1 = require("@opentelemetry/api");
+class SoftprobeMatcher {
+    constructor() {
+        /** Matcher functions run in registration order; first non-CONTINUE wins. */
+        this.fns = [];
+        /** Cassette records for this replay context (one trace). Set by SoftprobeContext.run(REPLAY). */
+        this.records = [];
+    }
+    /** Appends a matcher function. Fns are run in registration order. */
+    use(fn) {
+        this.fns.push(fn);
+    }
+    /** Removes all registered matcher fns. */
+    clear() {
+        this.fns = [];
+    }
+    /**
+     * Sets the cassette records for this context. Called by SoftprobeContext.run(REPLAY)
+     * after loading from storage so each matcher fn receives them in match().
+     */
+    _setRecords(records) {
+        this.records = records;
+    }
+    /**
+     * Returns the records for this replay context (context-scoped).
+     * Used by getRecordsForTrace when the active context has a matcher, so HTTP replay
+     * (MSW interceptor) reads from context instead of a global cache.
+     */
+    _getRecords() {
+        return this.records;
+    }
+    /**
+     * Returns the trace id for the current request (from first record).
+     * Used when context/span do not propagate to fetch so the interceptor can identify the trace.
+     */
+    _getTraceId() {
+        return this.records[0]?.traceId;
+    }
+    /**
+     * Returns the inbound record's responsePayload.body, with .http extracted when present.
+     * Used by HTTP replay (MSW interceptor) so the mock response body matches the recorded inbound and diff passes.
+     */
+    _getInboundHttpBody() {
+        const inbound = this.records.find((r) => r.type === 'inbound');
+        const payload = inbound?.responsePayload;
+        const body = payload?.body;
+        if (body == null)
+            return undefined;
+        const parsed = typeof body === 'string'
+            ? (() => {
+                try {
+                    return JSON.parse(body);
+                }
+                catch {
+                    return undefined;
+                }
+            })()
+            : body;
+        return parsed && typeof parsed === 'object' && 'http' in parsed
+            ? parsed.http
+            : undefined;
+    }
+    /**
+     * Runs registered matcher fns in order against the current active span (or spanOverride).
+     * Returns the first non-CONTINUE action (MOCK or PASSTHROUGH), or CONTINUE if all fns continue.
+     * Each fn receives the span and this context's records (design §7.1).
+     */
+    match(spanOverride) {
+        const span = (api_1.trace.getActiveSpan() ?? spanOverride);
+        for (const fn of this.fns) {
+            const r = fn(span, this.records);
+            if (r.action !== 'CONTINUE')
+                return r;
+        }
+        return { action: 'CONTINUE' };
+    }
+}
+exports.SoftprobeMatcher = SoftprobeMatcher;
+//# sourceMappingURL=softprobe-matcher.js.map

package/dist/core/matcher/softprobe-matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"softprobe-matcher.js","sourceRoot":"","sources":["../../../src/core/matcher/softprobe-matcher.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;GASG;AACH,4CAA2C;AAG3C,MAAa,gBAAgB;IAA7B;QACE,4EAA4E;QACpE,QAAG,GAAgB,EAAE,CAAC;QAC9B,iGAAiG;QACzF,YAAO,GAA8B,EAAE,CAAC;IA0ElD,CAAC;IAxEC,qEAAqE;IACrE,GAAG,CAAC,EAAa;QACf,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpB,CAAC;IAED,0CAA0C;IAC1C,KAAK;QACH,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;IAChB,CAAC;IAED;;;OAGG;IACH,WAAW,CAAC,OAAkC;QAC5C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;;OAGG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC;IAClC,CAAC;IAED;;;OAGG;IACH,mBAAmB;QACjB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;QAC/D,MAAM,OAAO,GAAG,OAAO,EAAE,eAAiD,CAAC;QAC3E,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,CAAC;QAC3B,IAAI,IAAI,IAAI,IAAI;YAAE,OAAO,SAAS,CAAC;QACnC,MAAM,MAAM,GACV,OAAO,IAAI,KAAK,QAAQ;YACtB,CAAC,CAAC,CAAC,GAAG,EAAE;gBACJ,IAAI,CAAC;oBACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC1B,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,SAAS,CAAC;gBACnB,CAAC;YACH,CAAC,CAAC,EAAE;YACN,CAAC,CAAC,IAAI,CAAC;QACX,OAAO,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,IAAI,MAAM;YAC7D,CAAC,CAAE,MAA4B,CAAC,IAAI;YACpC,CAAC,CAAC,SAAS,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,YAA2F;QAC/F,MAAM,IAAI,GAAG,CAAC,WAAK,CAAC,aAAa,EAAE,IAAI,YAAY,CAAkD,CAAC;QACtG,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YAC1B,MAAM,CAAC,GAAG,EAAE,CAAC,IAAyC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YACtE,IAAI,CAAC,CAAC,MAAM,KAAK,UAAU;gBAAE,OAAO,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAChC,CAAC;CACF;AA9ED,4CA8EC"}

package/dist/core/matcher/store-accessor.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Replay-mode record store accessor. Records are context-scoped only: the matcher
+ * in the active OTel context holds the loaded records for that request (created by
+ * SoftprobeContext.run(REPLAY)). No global cache. Task 15.3.1.
+ * Task 13.10: Load via Cassette (getOrCreateCassette) only; no loadNdjson.
+ */
+import type { SoftprobeCassetteRecord } from '../../types/schema';
+/**
+ * Returns recorded cassette records for the given traceId from the active context only.
+ * The matcher is created and seeded by SoftprobeContext.run(REPLAY); only the framework creates matchers.
+ * Returns [] when there is no active matcher with records. Compares traceIds in lowercase (W3C traceparent).
+ */
+export declare function getRecordsForTrace(traceId: string): SoftprobeCassetteRecord[];
+//# sourceMappingURL=store-accessor.d.ts.map

package/dist/core/matcher/store-accessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-accessor.d.ts","sourceRoot":"","sources":["../../../src/core/matcher/store-accessor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAIlE;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,uBAAuB,EAAE,CAQ7E"}

package/dist/core/matcher/store-accessor.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Replay-mode record store accessor. Records are context-scoped only: the matcher
+ * in the active OTel context holds the loaded records for that request (created by
+ * SoftprobeContext.run(REPLAY)). No global cache. Task 15.3.1.
+ * Task 13.10: Load via Cassette (getOrCreateCassette) only; no loadNdjson.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRecordsForTrace = getRecordsForTrace;
+const context_1 = require("../../context");
+/**
+ * Returns recorded cassette records for the given traceId from the active context only.
+ * The matcher is created and seeded by SoftprobeContext.run(REPLAY); only the framework creates matchers.
+ * Returns [] when there is no active matcher with records. Compares traceIds in lowercase (W3C traceparent).
+ */
+function getRecordsForTrace(traceId) {
+    const normalized = traceId.toLowerCase();
+    const matcher = context_1.SoftprobeContext.getMatcher();
+    if (matcher && '_getRecords' in matcher && typeof matcher._getRecords === 'function') {
+        const contextRecords = matcher._getRecords();
+        return contextRecords.filter((r) => (r.traceId ?? '').toLowerCase() === normalized);
+    }
+    return [];
+}
+//# sourceMappingURL=store-accessor.js.map

package/dist/core/matcher/store-accessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-accessor.js","sourceRoot":"","sources":["../../../src/core/matcher/store-accessor.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAYH,gDAQC;AAhBD,2CAAiD;AAGjD;;;;GAIG;AACH,SAAgB,kBAAkB,CAAC,OAAe;IAChD,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,0BAAgB,CAAC,UAAU,EAAE,CAAC;IAC9C,IAAI,OAAO,IAAI,aAAa,IAAI,OAAO,IAAI,OAAQ,OAA4B,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;QAC3G,MAAM,cAAc,GAAI,OAA4B,CAAC,WAAW,EAAE,CAAC;QACnE,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,UAAU,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}