@softprobe/softprobe-js 2.0.0

package/dist/instrumentations/redis/capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../../src/instrumentations/redis/capture.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,eAAO,MAAM,0BAA0B,2CAA2C,CAAC;AAUnF;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAqCrE"}

package/dist/instrumentations/redis/capture.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * Capture hook for Redis. Pairs with replay/redis.ts (same protocol & identifier).
+ * Design §3.1, §5.3: responseHook contract must match @opentelemetry/instrumentation-redis-4.
+ * Design §10.5: when capture store is set, writes outbound record with responsePayload.
+ *
+ * Actual contract (from types.d.ts):
+ *   responseHook(span: Span, cmdName: string, cmdArgs: Array<string|Buffer>, response: unknown): void
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REDIS_INSTRUMENTATION_NAME = void 0;
+exports.buildRedisResponseHook = buildRedisResponseHook;
+const identifier_1 = require("../../core/identifier");
+const context_1 = require("../../context");
+exports.REDIS_INSTRUMENTATION_NAME = '@opentelemetry/instrumentation-redis-4';
+/**
+ * Builds the responseHook for Redis instrumentation.
+ * Sets softprobe.protocol: 'redis', identifier (command + args), and
+ * request/response on spans per design §3.1.
+ * When a capture store is set, writes an outbound SoftprobeCassetteRecord (Task 10.5.1).
+ *
+ * The instrumentation calls: responseHook(span, cmdName, cmdArgs, response).
+ * We declare the return type loosely so it can be stored via injectHook.
+ */
+function buildRedisResponseHook() {
+    return (span, cmdName, cmdArgs, response) => {
+        const s = span;
+        const cmd = (cmdName != null ? String(cmdName) : 'UNKNOWN').toUpperCase();
+        const args = Array.isArray(cmdArgs)
+            ? cmdArgs.map((a) => (a != null ? String(a) : ''))
+            : [];
+        const identifier = (0, identifier_1.redisIdentifier)(cmd, args);
+        s.setAttribute?.('softprobe.protocol', 'redis');
+        s.setAttribute?.('softprobe.identifier', identifier);
+        if (args.length > 0) {
+            s.setAttribute?.('softprobe.request.body', JSON.stringify(args));
+        }
+        if (typeof response !== 'undefined') {
+            s.setAttribute?.('softprobe.response.body', JSON.stringify(response));
+        }
+        const ctx = s.spanContext?.() ?? { traceId: '', spanId: '' };
+        const record = {
+            version: '4.1',
+            traceId: ctx.traceId,
+            spanId: ctx.spanId,
+            parentSpanId: s.parentSpanId,
+            spanName: s.name,
+            timestamp: new Date().toISOString(),
+            type: 'outbound',
+            protocol: 'redis',
+            identifier,
+            responsePayload: response,
+        };
+        const cassette = context_1.SoftprobeContext.getCassette();
+        if (context_1.SoftprobeContext.getMode() === 'CAPTURE' && cassette) {
+            const tid = context_1.SoftprobeContext.getTraceId();
+            void cassette.saveRecord(tid ? { ...record, traceId: tid } : record).catch(() => { });
+        }
+    };
+}
+//# sourceMappingURL=capture.js.map

package/dist/instrumentations/redis/capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.js","sourceRoot":"","sources":["../../../src/instrumentations/redis/capture.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAyBH,wDAqCC;AA3DD,sDAAwD;AACxD,2CAAiD;AAEpC,QAAA,0BAA0B,GAAG,wCAAwC,CAAC;AAUnF;;;;;;;;GAQG;AACH,SAAgB,sBAAsB;IACpC,OAAO,CAAC,IAAa,EAAE,OAAgB,EAAE,OAAgB,EAAE,QAAiB,EAAE,EAAE;QAC9E,MAAM,CAAC,GAAG,IAA0E,CAAC;QACrF,MAAM,GAAG,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QAC1E,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YACjC,CAAC,CAAE,OAA+B,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC3E,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,UAAU,GAAG,IAAA,4BAAe,EAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAE9C,CAAC,CAAC,YAAY,EAAE,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;QAChD,CAAC,CAAC,YAAY,EAAE,CAAC,sBAAsB,EAAE,UAAU,CAAC,CAAC;QACrD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,CAAC,CAAC,YAAY,EAAE,CAAC,wBAAwB,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;YACpC,CAAC,CAAC,YAAY,EAAE,CAAC,yBAAyB,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;QACxE,CAAC;QAED,MAAM,GAAG,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QAC7D,MAAM,MAAM,GAA4B;YACtC,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,YAAY,EAAE,CAAC,CAAC,YAAY;YAC5B,QAAQ,EAAE,CAAC,CAAC,IAAI;YAChB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE,OAAO;YACjB,UAAU;YACV,eAAe,EAAE,QAAQ;SAC1B,CAAC;QACF,MAAM,QAAQ,GAAG,0BAAgB,CAAC,WAAW,EAAE,CAAC;QAChD,IAAI,0BAAgB,CAAC,OAAO,EAAE,KAAK,SAAS,IAAI,QAAQ,EAAE,CAAC;YACzD,MAAM,GAAG,GAAG,0BAAgB,CAAC,UAAU,EAAE,CAAC;YAC1C,KAAK,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACvF,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/instrumentations/redis/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Redis instrumentation package entry point.
+ */
+export { REDIS_INSTRUMENTATION_NAME, buildRedisResponseHook } from './capture';
+export { applyRedisReplay, setupRedisReplay } from './replay';
+//# sourceMappingURL=index.d.ts.map

package/dist/instrumentations/redis/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/instrumentations/redis/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC"}

package/dist/instrumentations/redis/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupRedisReplay = exports.applyRedisReplay = exports.buildRedisResponseHook = exports.REDIS_INSTRUMENTATION_NAME = void 0;
+/**
+ * Redis instrumentation package entry point.
+ */
+var capture_1 = require("./capture");
+Object.defineProperty(exports, "REDIS_INSTRUMENTATION_NAME", { enumerable: true, get: function () { return capture_1.REDIS_INSTRUMENTATION_NAME; } });
+Object.defineProperty(exports, "buildRedisResponseHook", { enumerable: true, get: function () { return capture_1.buildRedisResponseHook; } });
+var replay_1 = require("./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=index.js.map

package/dist/instrumentations/redis/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/instrumentations/redis/index.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,qCAA+E;AAAtE,qHAAA,0BAA0B,OAAA;AAAE,iHAAA,sBAAsB,OAAA;AAC3D,mCAA8D;AAArD,0GAAA,gBAAgB,OAAA;AAAE,0GAAA,gBAAgB,OAAA"}

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

@@ -0,0 +1,24 @@
+/**
+ * Redis replay: patches Redis client so that under replay context commands are
+ * resolved by matcher actions (no live network). Pairs with capture Task 4.5;
+ * identifier = command + args per design §3.1, §6.3.
+ *
+ * We wrap the commander's attachCommands so that the executor passed to each
+ * command (get, set, etc.) is our wrapper; the client captures that executor in
+ * a closure when the module loads, so we must patch before the client loads.
+ */
+/**
+ * Sets up Redis replay by wrapping the commander's attachCommands so the
+ * executor used by get/set/etc. is our wrapper (matcher-aware). Must run
+ * before the redis client module is loaded so the closure captures our wrapper.
+ */
+export declare function setupRedisReplay(): void;
+/**
+ * Wraps createClient so every new client gets connect/quit no-ops as instance own-properties.
+ * Using instance-level patching (not prototype) makes it immune to OTel re-patching the redis
+ * module at sdk.start(), which creates new Commander prototype objects that would bypass a
+ * prototype-level patch applied before sdk.start().
+ * Idempotent. Exported so init can call it from a require hook (Task 16.3.1).
+ */
+export declare function applyRedisReplay(redis: Record<string, unknown>): void;
+//# sourceMappingURL=replay.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../../../src/instrumentations/redis/replay.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmBH;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CA+HvC;AAgCD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAgBrE"}

package/dist/instrumentations/redis/replay.js

@@ -0,0 +1,173 @@
+"use strict";
+/**
+ * Redis replay: patches Redis client so that under replay context commands are
+ * resolved by matcher actions (no live network). Pairs with capture Task 4.5;
+ * identifier = command + args per design §3.1, §6.3.
+ *
+ * We wrap the commander's attachCommands so that the executor passed to each
+ * command (get, set, etc.) is our wrapper; the client captures that executor in
+ * a closure when the module loads, so we must patch before the client loads.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupRedisReplay = setupRedisReplay;
+exports.applyRedisReplay = applyRedisReplay;
+const api_1 = require("@opentelemetry/api");
+const shimmer_1 = __importDefault(require("shimmer"));
+const redis_span_1 = require("../../core/bindings/redis-span");
+const context_1 = require("../../context");
+/**
+ * Builds the same identifier string as the Redis capture hook (capture/redis.ts):
+ * command name (uppercase) plus args joined by space.
+ */
+function buildIdentifier(redisArgs) {
+    if (!Array.isArray(redisArgs) || redisArgs.length === 0)
+        return '';
+    const cmd = (redisArgs[0] != null ? String(redisArgs[0]) : 'UNKNOWN').toUpperCase();
+    const rest = redisArgs.slice(1).map((a) => (a != null ? String(a) : ''));
+    return [cmd, ...rest].join(' ').trim();
+}
+/**
+ * Sets up Redis replay by wrapping the commander's attachCommands so the
+ * executor used by get/set/etc. is our wrapper (matcher-aware). Must run
+ * before the redis client module is loaded so the closure captures our wrapper.
+ */
+function setupRedisReplay() {
+    const commanderModule = require('@redis/client/dist/lib/commander');
+    const { transformCommandArguments, transformCommandReply } = commanderModule;
+    if (!transformCommandArguments || !transformCommandReply)
+        return;
+    shimmer_1.default.wrap(commanderModule, 'attachCommands', (originalAttachCommands) => (config) => {
+        const cfg = config;
+        const originalExecutor = cfg.executor;
+        const wrappedConfig = {
+            ...cfg,
+            executor: function patchedExecutor(command, args, _name) {
+                const matcher = context_1.SoftprobeContext.active().matcher;
+                const mode = context_1.SoftprobeContext.getMode();
+                const strictReplay = context_1.SoftprobeContext.getStrictReplay();
+                if (mode === 'REPLAY' && !matcher && strictReplay) {
+                    return Promise.reject(new Error('Softprobe replay: no match for redis command'));
+                }
+                const { args: redisArgs } = transformCommandArguments(command, args);
+                const cmd = (redisArgs[0] != null ? String(redisArgs[0]) : 'UNKNOWN').toUpperCase();
+                if (mode === 'REPLAY' && (cmd === 'QUIT' || cmd === 'DISCONNECT')) {
+                    return Promise.resolve('OK');
+                }
+                if (!matcher) {
+                    return originalExecutor.call(this, command, args, _name);
+                }
+                const cmdArgs = redisArgs.slice(1).map((a) => (a != null ? String(a) : ''));
+                redis_span_1.RedisSpan.tagCommand(cmd, cmdArgs, api_1.trace.getActiveSpan() ?? undefined);
+                const identifier = buildIdentifier(redisArgs);
+                let payload;
+                const softprobeMatcher = matcher;
+                if (typeof softprobeMatcher.match === 'function') {
+                    const r = softprobeMatcher.match?.({
+                        attributes: {
+                            'softprobe.protocol': 'redis',
+                            'softprobe.identifier': identifier,
+                            'softprobe.redis.cmd': cmd,
+                            'softprobe.request.body': JSON.stringify(redisArgs),
+                        },
+                    });
+                    if (r.action === 'MOCK') {
+                        payload = r.payload;
+                    }
+                    else if (r.action === 'PASSTHROUGH') {
+                        return originalExecutor.call(this, command, args, _name);
+                    }
+                    else if (strictReplay) {
+                        return Promise.reject(new Error('Softprobe replay: no match for redis command'));
+                    }
+                    else {
+                        // CONTINUE + DEV: passthrough (design §9.3)
+                        return originalExecutor.call(this, command, args, _name);
+                    }
+                }
+                else {
+                    try {
+                        payload = matcher.findMatch({
+                            protocol: 'redis',
+                            identifier,
+                            requestBody: redisArgs,
+                        });
+                    }
+                    catch (err) {
+                        if (strictReplay) {
+                            return Promise.reject(new Error('Softprobe replay: no match for redis command'));
+                        }
+                        // CONTINUE + DEV: passthrough (design §9.3)
+                        return originalExecutor.call(this, command, args, _name);
+                    }
+                }
+                if (typeof payload === 'undefined') {
+                    if (strictReplay) {
+                        return Promise.reject(new Error('Softprobe replay: no match for redis command'));
+                    }
+                    // CONTINUE + DEV: passthrough (design §9.3)
+                    return originalExecutor.call(this, command, args, _name);
+                }
+                const preserved = redisArgs?.preserve;
+                return Promise.resolve(transformCommandReply(command, payload, preserved));
+            },
+        };
+        return originalAttachCommands(wrappedConfig);
+    });
+    // Ensure client module loads after our patch so attachCommands uses our wrapper
+    try {
+        const redis = require('redis');
+        applyRedisReplay(redis);
+    }
+    catch {
+        // redis optional; tests will require it
+    }
+}
+/**
+ * Wraps connect/quit/QUIT on a single Redis client instance as own properties.
+ * Own-property wrappers shadow the prototype and survive any prototype-chain reshuffling
+ * caused by OTel's module re-patching at sdk.start().
+ */
+function applyInstanceNoops(client) {
+    if (typeof client.connect === 'function') {
+        const orig = client.connect;
+        client.connect = function (...args) {
+            if (context_1.SoftprobeContext.getMode() === 'REPLAY')
+                return Promise.resolve();
+            return orig.apply(this, args);
+        };
+    }
+    const noopQuitFn = (orig) => function (...args) {
+        if (context_1.SoftprobeContext.getMode() === 'REPLAY')
+            return Promise.resolve('OK');
+        return orig.apply(this, args);
+    };
+    if (typeof client.quit === 'function')
+        client.quit = noopQuitFn(client.quit);
+    if (typeof client.QUIT === 'function')
+        client.QUIT = noopQuitFn(client.QUIT);
+}
+const SOFTPROBE_CREATE_CLIENT_WRAPPED = '__softprobeCreateClientWrapped';
+/**
+ * Wraps createClient so every new client gets connect/quit no-ops as instance own-properties.
+ * Using instance-level patching (not prototype) makes it immune to OTel re-patching the redis
+ * module at sdk.start(), which creates new Commander prototype objects that would bypass a
+ * prototype-level patch applied before sdk.start().
+ * Idempotent. Exported so init can call it from a require hook (Task 16.3.1).
+ */
+function applyRedisReplay(redis) {
+    const target = redis.createClient != null ? redis : redis.default;
+    if (!target)
+        return;
+    if (target.createClient?.[SOFTPROBE_CREATE_CLIENT_WRAPPED])
+        return;
+    shimmer_1.default.wrap(target, 'createClient', (original) => function (...args) {
+        const client = original.apply(this, args);
+        applyInstanceNoops(client);
+        return client;
+    });
+    target.createClient[SOFTPROBE_CREATE_CLIENT_WRAPPED] = true;
+}
+//# sourceMappingURL=replay.js.map

package/dist/instrumentations/redis/replay.js.map

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

package/dist/replay/express.d.ts

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

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

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

package/dist/replay/express.js

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

package/dist/replay/express.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.js","sourceRoot":"","sources":["../../src/replay/express.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,6DAA8E;AAArE,kHAAA,wBAAwB,OAAA"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"extract-key.d.ts","sourceRoot":"","sources":["../../src/replay/extract-key.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAEV,SAAS,EACT,uBAAuB,EACxB,MAAM,iBAAiB,CAAC;AAKzB,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/replay/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("../core/bindings/postgres-span");
+const redis_span_1 = require("../core/bindings/redis-span");
+const http_span_1 = require("../core/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/replay/extract-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-key.js","sourceRoot":"","sources":["../../src/replay/extract-key.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAwBH,gDAWC;AAKD,4DAUC;AA4BD,oDAYC;AAnFD,kEAA8D;AAC9D,4DAAwD;AACxD,0DAAsD;AAWtD;;;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/replay/fastify.d.ts

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

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

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

package/dist/replay/fastify.js

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

package/dist/replay/fastify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fastify.js","sourceRoot":"","sources":["../../src/replay/fastify.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,6DAAsF;AAA7E,0HAAA,gCAAgC,OAAA"}

package/dist/replay/http.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Legacy compatibility re-export for HTTP/fetch replay instrumentation.
+ */
+export { handleHttpReplayRequest, setupHttpReplayInterceptor } from '../instrumentations/fetch/replay';
+//# sourceMappingURL=http.d.ts.map

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

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

package/dist/replay/http.js

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

package/dist/replay/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/replay/http.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,2DAAuG;AAA9F,iHAAA,uBAAuB,OAAA;AAAE,oHAAA,0BAA0B,OAAA"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.d.ts","sourceRoot":"","sources":["../../src/replay/matcher.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAQrE,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/replay/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