@softprobe/softprobe-js 2.0.0

package/dist/replay/matcher.js.map

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

package/dist/replay/postgres.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Legacy compatibility re-export for Postgres replay instrumentation.
+ */
+export { applyPostgresReplay, setupPostgresReplay } from '../instrumentations/postgres/replay';
+//# sourceMappingURL=postgres.d.ts.map

package/dist/replay/postgres.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../../src/replay/postgres.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/replay/postgres.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupPostgresReplay = exports.applyPostgresReplay = void 0;
+/**
+ * Legacy compatibility re-export for Postgres replay instrumentation.
+ */
+var replay_1 = require("../instrumentations/postgres/replay");
+Object.defineProperty(exports, "applyPostgresReplay", { enumerable: true, get: function () { return replay_1.applyPostgresReplay; } });
+Object.defineProperty(exports, "setupPostgresReplay", { enumerable: true, get: function () { return replay_1.setupPostgresReplay; } });
+//# sourceMappingURL=postgres.js.map

package/dist/replay/postgres.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.js","sourceRoot":"","sources":["../../src/replay/postgres.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,8DAA+F;AAAtF,6GAAA,mBAAmB,OAAA;AAAE,6GAAA,mBAAmB,OAAA"}

package/dist/replay/redis.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Legacy compatibility re-export for Redis replay instrumentation.
+ */
+export { applyRedisReplay, setupRedisReplay } from '../instrumentations/redis/replay';
+//# sourceMappingURL=redis.d.ts.map

package/dist/replay/redis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../src/replay/redis.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/replay/redis.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupRedisReplay = exports.applyRedisReplay = void 0;
+/**
+ * Legacy compatibility re-export for Redis replay instrumentation.
+ */
+var replay_1 = require("../instrumentations/redis/replay");
+Object.defineProperty(exports, "applyRedisReplay", { enumerable: true, get: function () { return replay_1.applyRedisReplay; } });
+Object.defineProperty(exports, "setupRedisReplay", { enumerable: true, get: function () { return replay_1.setupRedisReplay; } });
+//# sourceMappingURL=redis.js.map

package/dist/replay/redis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.js","sourceRoot":"","sources":["../../src/replay/redis.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,2DAAsF;AAA7E,0GAAA,gBAAgB,OAAA;AAAE,0GAAA,gBAAgB,OAAA"}

package/dist/replay/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/replay/softprobe-matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"softprobe-matcher.d.ts","sourceRoot":"","sources":["../../src/replay/softprobe-matcher.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAEzF,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/replay/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/replay/softprobe-matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"softprobe-matcher.js","sourceRoot":"","sources":["../../src/replay/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/replay/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/replay/store-accessor.d.ts.map

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

package/dist/replay/store-accessor.js

@@ -0,0 +1,26 @@
+"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();
+    const replayMatcher = matcher;
+    if (replayMatcher && typeof replayMatcher._getRecords === 'function') {
+        const contextRecords = replayMatcher._getRecords();
+        return contextRecords.filter((r) => (r.traceId ?? '').toLowerCase() === normalized);
+    }
+    return [];
+}
+//# sourceMappingURL=store-accessor.js.map

package/dist/replay/store-accessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-accessor.js","sourceRoot":"","sources":["../../src/replay/store-accessor.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAaH,gDASC;AAlBD,wCAA8C;AAI9C;;;;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,MAAM,aAAa,GAAG,OAAyC,CAAC;IAChE,IAAI,aAAa,IAAI,OAAO,aAAa,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;QACrE,MAAM,cAAc,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC;QACnD,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"}

package/dist/replay/topology.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Topology-aware matching helpers (design §7.4).
+ * Read live parent name; build bySpanId index; filter candidates; createTopologyMatcher.
+ */
+import type { MatcherFn, SoftprobeCassetteRecord } from '../types/schema';
+import { type SpanKey } from './extract-key';
+/** Span-like with optional internal _parentSpanName (test or OTel plumbing). */
+type SpanWithParent = {
+    _parentSpanName?: string;
+} | undefined;
+/**
+ * Returns the live parent span name for topology matching.
+ * If the span has _parentSpanName (set by instrumentation or tests), returns it; otherwise "root".
+ */
+export declare function getLiveParentName(span: SpanWithParent): string;
+/**
+ * Builds a map from spanId to record for lineage lookup (design §7.4).
+ * Enables looking up a record's parent via bySpanId.get(record.parentSpanId).
+ */
+export declare function buildBySpanIdIndex(records: SoftprobeCassetteRecord[]): Map<string, SoftprobeCassetteRecord>;
+/**
+ * Filters records to outbound candidates matching protocol+identifier (design §7.4).
+ * Same semantics as flat matcher's filterOutboundCandidates.
+ */
+export declare function filterCandidatesByKey(records: SoftprobeCassetteRecord[], key: SpanKey): SoftprobeCassetteRecord[];
+/**
+ * Prefers candidates whose recorded parent spanName matches live parent (design §7.4).
+ * Returns lineageMatches when non-empty, otherwise returns all candidates (fallback pool).
+ */
+export declare function selectLineagePool(candidates: SoftprobeCassetteRecord[], bySpanId: Map<string, SoftprobeCassetteRecord>, liveParentName: string): SoftprobeCassetteRecord[];
+/**
+ * Returns a MatcherFn that prefers candidates whose recorded parent spanName matches
+ * the live parent, with per-(protocol, identifier, liveParentName) call sequencing (design §7.4).
+ */
+export declare function createTopologyMatcher(): MatcherFn;
+export {};
+//# sourceMappingURL=topology.d.ts.map

package/dist/replay/topology.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topology.d.ts","sourceRoot":"","sources":["../../src/replay/topology.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAiB,SAAS,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AACzF,OAAO,EAGL,KAAK,OAAO,EACb,MAAM,eAAe,CAAC;AAEvB,gFAAgF;AAChF,KAAK,cAAc,GAAG;IAAE,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAC;AAE/D;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAE9D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,uBAAuB,EAAE,GACjC,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAEtC;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,uBAAuB,EAAE,EAClC,GAAG,EAAE,OAAO,GACX,uBAAuB,EAAE,CAE3B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,uBAAuB,EAAE,EACrC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,EAC9C,cAAc,EAAE,MAAM,GACrB,uBAAuB,EAAE,CAO3B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,SAAS,CAsBjD"}

package/dist/replay/topology.js

@@ -0,0 +1,72 @@
+"use strict";
+/**
+ * Topology-aware matching helpers (design §7.4).
+ * Read live parent name; build bySpanId index; filter candidates; createTopologyMatcher.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLiveParentName = getLiveParentName;
+exports.buildBySpanIdIndex = buildBySpanIdIndex;
+exports.filterCandidatesByKey = filterCandidatesByKey;
+exports.selectLineagePool = selectLineagePool;
+exports.createTopologyMatcher = createTopologyMatcher;
+const extract_key_1 = require("./extract-key");
+/**
+ * Returns the live parent span name for topology matching.
+ * If the span has _parentSpanName (set by instrumentation or tests), returns it; otherwise "root".
+ */
+function getLiveParentName(span) {
+    return span?._parentSpanName ?? 'root';
+}
+/**
+ * Builds a map from spanId to record for lineage lookup (design §7.4).
+ * Enables looking up a record's parent via bySpanId.get(record.parentSpanId).
+ */
+function buildBySpanIdIndex(records) {
+    return new Map(records.map((r) => [r.spanId, r]));
+}
+/**
+ * Filters records to outbound candidates matching protocol+identifier (design §7.4).
+ * Same semantics as flat matcher's filterOutboundCandidates.
+ */
+function filterCandidatesByKey(records, key) {
+    return (0, extract_key_1.filterOutboundCandidates)(records, key);
+}
+/**
+ * Prefers candidates whose recorded parent spanName matches live parent (design §7.4).
+ * Returns lineageMatches when non-empty, otherwise returns all candidates (fallback pool).
+ */
+function selectLineagePool(candidates, bySpanId, liveParentName) {
+    const lineageMatches = candidates.filter((c) => {
+        if (!c.parentSpanId)
+            return liveParentName === 'root';
+        const parent = bySpanId.get(c.parentSpanId);
+        return (parent?.spanName ?? 'root') === liveParentName;
+    });
+    return lineageMatches.length > 0 ? lineageMatches : candidates;
+}
+/**
+ * Returns a MatcherFn that prefers candidates whose recorded parent spanName matches
+ * the live parent, with per-(protocol, identifier, liveParentName) call sequencing (design §7.4).
+ */
+function createTopologyMatcher() {
+    const callSeq = new Map();
+    return (span, records) => {
+        const key = (0, extract_key_1.extractKeyFromSpan)(span);
+        if (!key)
+            return { action: 'CONTINUE' };
+        const liveParentName = getLiveParentName(span);
+        const candidates = filterCandidatesByKey(records, key);
+        if (candidates.length === 0)
+            return { action: 'CONTINUE' };
+        const bySpanId = buildBySpanIdIndex(records);
+        const pool = selectLineagePool(candidates, bySpanId, liveParentName);
+        const seqKey = `${key.protocol}::${key.identifier}::${liveParentName}`;
+        const n = callSeq.get(seqKey) ?? 0;
+        const picked = pool[n];
+        callSeq.set(seqKey, n + 1);
+        if (!picked)
+            return { action: 'CONTINUE' };
+        return { action: 'MOCK', payload: picked.responsePayload };
+    };
+}
+//# sourceMappingURL=topology.js.map

package/dist/replay/topology.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topology.js","sourceRoot":"","sources":["../../src/replay/topology.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAgBH,8CAEC;AAMD,gDAIC;AAMD,sDAKC;AAMD,8CAWC;AAMD,sDAsBC;AAjFD,+CAIuB;AAKvB;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,IAAoB;IACpD,OAAQ,IAAY,EAAE,eAAe,IAAI,MAAM,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,SAAgB,kBAAkB,CAChC,OAAkC;IAElC,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC;AAED;;;GAGG;AACH,SAAgB,qBAAqB,CACnC,OAAkC,EAClC,GAAY;IAEZ,OAAO,IAAA,sCAAwB,EAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,SAAgB,iBAAiB,CAC/B,UAAqC,EACrC,QAA8C,EAC9C,cAAsB;IAEtB,MAAM,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QAC7C,IAAI,CAAC,CAAC,CAAC,YAAY;YAAE,OAAO,cAAc,KAAK,MAAM,CAAC;QACtD,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;QAC5C,OAAO,CAAC,MAAM,EAAE,QAAQ,IAAI,MAAM,CAAC,KAAK,cAAc,CAAC;IACzD,CAAC,CAAC,CAAC;IACH,OAAO,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,UAAU,CAAC;AACjE,CAAC;AAED;;;GAGG;AACH,SAAgB,qBAAqB;IACnC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE1C,OAAO,CAAC,IAAI,EAAE,OAAO,EAAiB,EAAE;QACtC,MAAM,GAAG,GAAG,IAAA,gCAAkB,EAAC,IAAgD,CAAC,CAAC;QACjF,IAAI,CAAC,GAAG;YAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QAExC,MAAM,cAAc,GAAG,iBAAiB,CAAC,IAAsB,CAAC,CAAC;QACjE,MAAM,UAAU,GAAG,qBAAqB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACvD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QAE3D,MAAM,QAAQ,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,iBAAiB,CAAC,UAAU,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;QAErE,MAAM,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,KAAK,GAAG,CAAC,UAAU,KAAK,cAAc,EAAE,CAAC;QACvE,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3B,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QAE3C,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,eAAe,EAAE,CAAC;IAC7D,CAAC,CAAC;AACJ,CAAC"}

package/dist/store/cassette-store.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Single-threaded FIFO queue that appends NDJSON lines to a file.
+ * Used as the capture side-channel; payloads are not stored in span attributes.
+ */
+import type { SoftprobeCassetteRecord } from '../types/schema';
+export type CassetteStoreOptions = {
+    /** When set, enqueue drops lines once queue reaches this size and increments drop count. */
+    maxQueueSize?: number;
+};
+/**
+ * CassetteStore enqueues NDJSON lines and flushes them to a file in order.
+ */
+export declare class CassetteStore {
+    private readonly path;
+    private readonly queue;
+    private readonly maxQueueSize;
+    private dropCount;
+    private readonly _boundFlushOnExit;
+    constructor(outputPath: string, options?: CassetteStoreOptions);
+    /** Appends a line (one JSON record) to the FIFO queue. Drops and counts if at maxQueueSize. */
+    enqueue(line: string): void;
+    /** Returns the number of lines dropped due to maxQueueSize. */
+    getDropCount(): number;
+    /**
+     * Serializes a cassette record as one JSON line. The line is queued for flush;
+     * flush joins with newline so the file has exactly one JSON per line.
+     */
+    saveRecord(record: SoftprobeCassetteRecord): void;
+    /** Writes all queued lines to the output file in order, then clears the queue. */
+    flush(): void;
+    /**
+     * Best-effort flush on exit. Registered for SIGINT/SIGTERM; safe to call directly (e.g. in tests).
+     */
+    flushOnExit(): void;
+}
+//# sourceMappingURL=cassette-store.d.ts.map

package/dist/store/cassette-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cassette-store.d.ts","sourceRoot":"","sources":["../../src/store/cassette-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE/D,MAAM,MAAM,oBAAoB,GAAG;IACjC,4FAA4F;IAC5F,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAa;gBAEnC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB;IAQlE,+FAA+F;IAC/F,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAW3B,+DAA+D;IAC/D,YAAY,IAAI,MAAM;IAItB;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI;IAIjD,kFAAkF;IAClF,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,WAAW,IAAI,IAAI;CAOpB"}

package/dist/store/cassette-store.js

@@ -0,0 +1,66 @@
+"use strict";
+/**
+ * Single-threaded FIFO queue that appends NDJSON lines to a file.
+ * Used as the capture side-channel; payloads are not stored in span attributes.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CassetteStore = void 0;
+const fs_1 = __importDefault(require("fs"));
+/**
+ * CassetteStore enqueues NDJSON lines and flushes them to a file in order.
+ */
+class CassetteStore {
+    constructor(outputPath, options = {}) {
+        this.queue = [];
+        this.dropCount = 0;
+        this.path = outputPath;
+        this.maxQueueSize = options.maxQueueSize;
+        this._boundFlushOnExit = this.flushOnExit.bind(this);
+        process.on('SIGINT', this._boundFlushOnExit);
+        process.on('SIGTERM', this._boundFlushOnExit);
+    }
+    /** Appends a line (one JSON record) to the FIFO queue. Drops and counts if at maxQueueSize. */
+    enqueue(line) {
+        if (this.maxQueueSize !== undefined &&
+            this.queue.length >= this.maxQueueSize) {
+            this.dropCount += 1;
+            return;
+        }
+        this.queue.push(line);
+    }
+    /** Returns the number of lines dropped due to maxQueueSize. */
+    getDropCount() {
+        return this.dropCount;
+    }
+    /**
+     * Serializes a cassette record as one JSON line. The line is queued for flush;
+     * flush joins with newline so the file has exactly one JSON per line.
+     */
+    saveRecord(record) {
+        this.enqueue(JSON.stringify(record));
+    }
+    /** Writes all queued lines to the output file in order, then clears the queue. */
+    flush() {
+        if (this.queue.length === 0)
+            return;
+        const content = this.queue.join('\n') + (this.queue.length ? '\n' : '');
+        fs_1.default.appendFileSync(this.path, content, 'utf8');
+        this.queue.length = 0;
+    }
+    /**
+     * Best-effort flush on exit. Registered for SIGINT/SIGTERM; safe to call directly (e.g. in tests).
+     */
+    flushOnExit() {
+        try {
+            this.flush();
+        }
+        catch {
+            // best-effort: avoid throwing on process exit
+        }
+    }
+}
+exports.CassetteStore = CassetteStore;
+//# sourceMappingURL=cassette-store.js.map

package/dist/store/cassette-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cassette-store.js","sourceRoot":"","sources":["../../src/store/cassette-store.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;AAEH,4CAAoB;AASpB;;GAEG;AACH,MAAa,aAAa;IAOxB,YAAY,UAAkB,EAAE,UAAgC,EAAE;QALjD,UAAK,GAAa,EAAE,CAAC;QAE9B,cAAS,GAAG,CAAC,CAAC;QAIpB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QACzC,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrD,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC7C,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAChD,CAAC;IAED,+FAA+F;IAC/F,OAAO,CAAC,IAAY;QAClB,IACE,IAAI,CAAC,YAAY,KAAK,SAAS;YAC/B,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,YAAY,EACtC,CAAC;YACD,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;YACpB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,+DAA+D;IAC/D,YAAY;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;;;OAGG;IACH,UAAU,CAAC,MAA+B;QACxC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IACvC,CAAC;IAED,kFAAkF;IAClF,KAAK;QACH,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACxE,YAAE,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAC9C,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,WAAW;QACT,IAAI,CAAC;YACH,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC;QAAC,MAAM,CAAC;YACP,8CAA8C;QAChD,CAAC;IACH,CAAC;CACF;AA1DD,sCA0DC"}

package/dist/types/schema.d.ts

@@ -0,0 +1,114 @@
+import type { Span } from '@opentelemetry/api';
+import type { ReadableSpan } from '@opentelemetry/sdk-trace-base';
+/**
+ * Result of a custom matcher:
+ * - MOCK: return the given payload; no tree matching, no network.
+ * - CONTINUE: fall through to default tree matching; the call is still replayed from the recording (no live network).
+ * - PASSTHROUGH: request that this call go to the live network; in strict mode the engine throws (not allowed).
+ */
+export type MatcherResult = {
+    action: 'MOCK';
+    payload: unknown;
+} | {
+    action: 'CONTINUE';
+} | {
+    action: 'PASSTHROUGH';
+};
+/**
+ * V4 matcher result: discriminated union. Wrappers branch on action; only MOCK carries payload.
+ * Design §7.1: first non-CONTINUE wins; matchers do not execute passthrough.
+ */
+export type MatcherAction = {
+    action: 'MOCK';
+    payload: unknown;
+    traceId?: string;
+} | {
+    action: 'PASSTHROUGH';
+} | {
+    action: 'CONTINUE';
+};
+/**
+ * V4 matcher function: (span, records) => MatcherAction. Used by SoftprobeMatcher list.
+ * Design §7.1: first non-CONTINUE return wins; matchers do not execute passthrough.
+ * Input contract: span attributes are the canonical source for matching keys
+ * (e.g. `softprobe.protocol`, `softprobe.identifier`). Raw dependency call args
+ * are expected to be transformed into span attributes by wrappers/instrumentation.
+ */
+export type MatcherFn = (span: Span | undefined, records: SoftprobeCassetteRecord[]) => MatcherAction;
+/** Custom matcher function. Evaluated before default tree matching. */
+export type CustomMatcherFn = (liveRequest: MatchRequest, recordedSpans: ReadableSpan[]) => MatcherResult;
+export interface SoftprobeAttributes {
+    'softprobe.protocol': 'http' | 'postgres' | 'redis' | 'amqp';
+    'softprobe.identifier': string;
+    'softprobe.request.body'?: string;
+    'softprobe.response.body'?: string;
+}
+/** Runtime execution mode for Softprobe context. */
+export type SoftprobeMode = 'CAPTURE' | 'REPLAY' | 'PASSTHROUGH';
+/**
+ * Cassette storage interface: pure read/write only (Task 13.7).
+ * loadTrace() reads all records for this trace; saveRecord(record) appends one;
+ * flush?() drains pending writes when present. Bound to one traceId at creation.
+ */
+export interface Cassette {
+    loadTrace(): Promise<SoftprobeCassetteRecord[]>;
+    saveRecord(record: SoftprobeCassetteRecord): Promise<void>;
+    flush?(): Promise<void>;
+}
+/**
+ * Options for SoftprobeContext.run().
+ * When storage is omitted, cassetteDirectory (from options or global) and traceId are used to get-or-create a cassette (Task 13.5).
+ */
+export interface SoftprobeRunOptions {
+    mode: SoftprobeMode;
+    /** Optional; when omitted and cassetteDirectory + traceId are set, context get-or-creates a cassette per traceId. */
+    storage?: Cassette;
+    traceId: string;
+    /** Optional directory for per-trace cassette files; when not set, global default from init is used. */
+    cassetteDirectory?: string;
+    strictReplay?: boolean;
+    strictComparison?: boolean;
+    matcher?: MatcherFn;
+}
+/** V4.1 protocol discriminator (cassette + bindings). */
+export type Protocol = 'http' | 'postgres' | 'redis' | 'amqp' | 'grpc';
+/** V4.1 cassette record direction. */
+export type RecordType = 'inbound' | 'outbound' | 'metadata';
+/**
+ * V4.1 NDJSON cassette record: identity, topology, direction, matching keys, optional payloads.
+ * Payloads are side-channel only (not in span attributes).
+ */
+export type SoftprobeCassetteRecord = {
+    version: '4.1';
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    spanName?: string;
+    timestamp: string;
+    type: RecordType;
+    protocol: Protocol;
+    identifier: string;
+    requestPayload?: unknown;
+    responsePayload?: unknown;
+    statusCode?: number;
+    error?: {
+        message: string;
+        stack?: string;
+    };
+};
+/**
+ * Minimal runtime guard for V4.1 cassette records. Returns true only when
+ * the object has version "4.1" (does not validate other required keys).
+ */
+export declare function isCassetteRecord(obj: unknown): obj is SoftprobeCassetteRecord;
+/** V3 side-channel cassette file format. */
+export interface SoftprobeCassette {
+    version: '3.0';
+    records: SoftprobeCassetteRecord[];
+}
+export interface MatchRequest {
+    protocol: string;
+    identifier: string;
+    requestBody?: unknown;
+}
+//# sourceMappingURL=schema.d.ts.map

package/dist/types/schema.d.ts.map

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

package/dist/types/schema.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isCassetteRecord = isCassetteRecord;
+/**
+ * Minimal runtime guard for V4.1 cassette records. Returns true only when
+ * the object has version "4.1" (does not validate other required keys).
+ */
+function isCassetteRecord(obj) {
+    return (typeof obj === 'object' &&
+        obj !== null &&
+        obj.version === '4.1');
+}
+//# sourceMappingURL=schema.js.map

package/dist/types/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/types/schema.ts"],"names":[],"mappings":";;AA4GA,4CAMC;AAVD;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,GAAY;IAC3C,OAAO,CACL,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACX,GAA+B,CAAC,OAAO,KAAK,KAAK,CACnD,CAAC;AACJ,CAAC"}