@softprobe/softprobe-js 2.0.0

package/dist/instrumentations/fetch/replay.js

@@ -0,0 +1,259 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleHttpReplayRequest = handleHttpReplayRequest;
+exports.setupHttpReplayInterceptor = setupHttpReplayInterceptor;
+const stream_1 = require("stream");
+const interceptors_1 = require("@mswjs/interceptors");
+const ClientRequest_1 = require("@mswjs/interceptors/ClientRequest");
+const fetch_1 = require("@mswjs/interceptors/fetch");
+const api_1 = require("@opentelemetry/api");
+const context_1 = require("../../context");
+const config_manager_1 = require("../../config/config-manager");
+const identifier_1 = require("../../core/identifier");
+const http_span_1 = require("../../core/bindings/http-span");
+const stream_tap_1 = require("../common/http/stream-tap");
+const DEFAULT_MAX_PAYLOAD_SIZE = 1048576;
+let cachedMaxPayloadSize = null;
+function getCaptureMaxPayloadSize() {
+    if (cachedMaxPayloadSize != null)
+        return cachedMaxPayloadSize;
+    try {
+        const cfg = new config_manager_1.ConfigManager();
+        const n = cfg.get().capture?.maxPayloadSize;
+        cachedMaxPayloadSize = typeof n === 'number' && n > 0 ? n : DEFAULT_MAX_PAYLOAD_SIZE;
+    }
+    catch {
+        cachedMaxPayloadSize = DEFAULT_MAX_PAYLOAD_SIZE;
+    }
+    return cachedMaxPayloadSize;
+}
+let cachedConfig = null;
+let cachedConfigInitFailed = false;
+function shouldIgnoreFromConfig(url) {
+    if (cachedConfigInitFailed)
+        return false;
+    try {
+        if (cachedConfig == null)
+            cachedConfig = new config_manager_1.ConfigManager();
+        return cachedConfig.shouldIgnore(url);
+    }
+    catch {
+        cachedConfigInitFailed = true;
+        return false;
+    }
+}
+function jsonErrorResponse(message, details) {
+    const payload = details ? { error: message, details } : { error: message };
+    return new Response(JSON.stringify(payload), {
+        status: 500,
+        headers: {
+            'x-softprobe-error': 'true',
+            'content-type': 'application/json',
+        },
+    });
+}
+/** Serializes body for mock response. Returns '{}' when body is missing so consumer .json() does not throw. */
+function toTextBody(body) {
+    if (typeof body === 'string')
+        return body;
+    if (body == null)
+        return '{}';
+    return JSON.stringify(body);
+}
+/**
+ * CAPTURE branch: perform request with bypass fetch, tap response body via tapReadableStream,
+ * build outbound record, saveRecord (fire-and-forget), respondWith(tapped response).
+ */
+async function handleCaptureRequest(request, controller, bypassFetch) {
+    const method = (request.method ?? 'GET').toUpperCase();
+    const url = typeof request.url === 'string' ? request.url : String(request.url);
+    const identifier = (0, identifier_1.httpIdentifier)(method, url);
+    const span = api_1.trace.getActiveSpan();
+    const ctx = span?.spanContext();
+    const traceId = ctx?.traceId ?? '';
+    const spanId = ctx?.spanId ?? '';
+    const parentSpanId = span && 'parentSpanId' in span ? span.parentSpanId : undefined;
+    const spanName = span && 'name' in span ? span.name : undefined;
+    // Capture cassette/traceId before any await so async callbacks (e.g. getCaptured().then) still have them (Task 13.11).
+    const cassette = context_1.SoftprobeContext.getCassette();
+    const softprobeTraceId = context_1.SoftprobeContext.getTraceId();
+    const urlString = typeof url === 'string' ? url : String(url);
+    let response;
+    try {
+        const input = urlString.startsWith('http:') || urlString.startsWith('https:') ? new URL(urlString) : urlString;
+        response = await bypassFetch(input, {
+            method: request.method ?? 'GET',
+            headers: request.headers,
+            body: request.body ?? undefined,
+            duplex: request.duplex,
+        });
+    }
+    catch (err) {
+        const details = err instanceof Error ? err.message : String(err);
+        controller.respondWith(jsonErrorResponse('Softprobe Capture fetch failed', details));
+        return;
+    }
+    if (!response.body) {
+        controller.respondWith(response);
+        if (context_1.SoftprobeContext.getMode() === 'CAPTURE' && cassette) {
+            const rec = {
+                version: '4.1',
+                traceId,
+                spanId,
+                parentSpanId,
+                spanName,
+                timestamp: new Date().toISOString(),
+                type: 'outbound',
+                protocol: 'http',
+                identifier,
+                responsePayload: { statusCode: response.status },
+            };
+            void cassette.saveRecord(softprobeTraceId ? { ...rec, traceId: softprobeTraceId } : rec).catch(() => { });
+        }
+        return;
+    }
+    const maxPayloadSize = getCaptureMaxPayloadSize();
+    const fromWeb = stream_1.Readable.fromWeb;
+    const toWeb = stream_1.Readable.toWeb;
+    if (typeof fromWeb === 'function' && typeof toWeb === 'function') {
+        try {
+            const nodeReadable = fromWeb(response.body);
+            const { readable, getCaptured } = (0, stream_tap_1.tapReadableStream)(nodeReadable, { maxPayloadSize });
+            const webStream = toWeb(readable);
+            const newResponse = new Response(webStream, {
+                status: response.status,
+                statusText: response.statusText,
+                headers: response.headers,
+            });
+            controller.respondWith(newResponse);
+            getCaptured()
+                .then((captured) => {
+                if (context_1.SoftprobeContext.getMode() !== 'CAPTURE' || !cassette)
+                    return;
+                const bodyStr = captured.body.toString('utf8');
+                const rec = {
+                    version: '4.1',
+                    traceId,
+                    spanId,
+                    parentSpanId,
+                    spanName,
+                    timestamp: new Date().toISOString(),
+                    type: 'outbound',
+                    protocol: 'http',
+                    identifier,
+                    responsePayload: {
+                        statusCode: response.status,
+                        body: bodyStr,
+                        ...(captured.truncated && { truncated: true }),
+                    },
+                };
+                void cassette.saveRecord(softprobeTraceId ? { ...rec, traceId: softprobeTraceId } : rec).catch(() => { });
+            })
+                .catch(() => { });
+        }
+        catch {
+            controller.respondWith(response);
+        }
+    }
+    else {
+        response
+            .clone()
+            .text()
+            .then((bodyText) => {
+            if (context_1.SoftprobeContext.getMode() !== 'CAPTURE' || !cassette)
+                return;
+            const capped = bodyText.length > maxPayloadSize ? bodyText.slice(0, maxPayloadSize) : bodyText;
+            const rec = {
+                version: '4.1',
+                traceId,
+                spanId,
+                parentSpanId,
+                spanName,
+                timestamp: new Date().toISOString(),
+                type: 'outbound',
+                protocol: 'http',
+                identifier,
+                responsePayload: {
+                    statusCode: response.status,
+                    body: capped,
+                    ...(bodyText.length > maxPayloadSize && { truncated: true }),
+                },
+            };
+            void cassette.saveRecord(softprobeTraceId ? { ...rec, traceId: softprobeTraceId } : rec).catch(() => { });
+        })
+            .catch(() => { });
+        controller.respondWith(response);
+    }
+}
+async function handleHttpReplayRequest(event, options = {}) {
+    const { request, controller } = event;
+    try {
+        const url = typeof request.url === 'string' ? request.url : String(request.url);
+        const shouldIgnore = options.shouldIgnoreUrl ?? shouldIgnoreFromConfig;
+        if (shouldIgnore(url))
+            return;
+        if (context_1.SoftprobeContext.getMode() === 'CAPTURE' && options.bypassFetch) {
+            await handleCaptureRequest(request, controller, options.bypassFetch);
+            return;
+        }
+        /** Task 18.2.2: use active context mode to decide MOCK vs PASSTHROUGH; only run matcher when REPLAY. */
+        if (context_1.SoftprobeContext.getMode() !== 'REPLAY')
+            return;
+        const method = (request.method ?? 'GET').toUpperCase();
+        const identifier = (0, identifier_1.httpIdentifier)(method, url);
+        http_span_1.HttpSpan.tagRequest(method, url, undefined, api_1.trace.getActiveSpan() ?? undefined);
+        const matcher = context_1.SoftprobeContext.active().matcher;
+        const match = matcher?.match?.bind(matcher);
+        if (!match) {
+            throw new Error('Softprobe replay matcher is required in REPLAY mode');
+        }
+        const result = match({
+            attributes: {
+                'softprobe.protocol': 'http',
+                'softprobe.identifier': identifier,
+            },
+        });
+        if (result.action === 'MOCK') {
+            const payload = (result.payload ?? {});
+            controller.respondWith(new Response(toTextBody(payload.body), {
+                status: payload.status ?? payload.statusCode ?? 200,
+                headers: payload.headers,
+            }));
+            return;
+        }
+        if (result.action === 'PASSTHROUGH')
+            return;
+        if (context_1.SoftprobeContext.getStrictReplay()) {
+            controller.respondWith(jsonErrorResponse('[Softprobe] No recorded traces found for http request'));
+        }
+        // CONTINUE + DEV: leave request untouched (passthrough)
+    }
+    catch (err) {
+        const details = err instanceof Error ? err.message : String(err);
+        event.controller.respondWith(jsonErrorResponse('Softprobe Replay Error', details));
+    }
+}
+function getBypassFetch() {
+    try {
+        const undici = require('undici');
+        if (typeof undici.fetch === 'function')
+            return undici.fetch;
+    }
+    catch {
+        /* undici not available */
+    }
+    return globalThis.fetch;
+}
+function setupHttpReplayInterceptor(options = {}) {
+    const bypassFetch = options.bypassFetch ?? getBypassFetch();
+    const interceptor = new interceptors_1.BatchInterceptor({
+        name: 'softprobe-http-replay',
+        interceptors: [new ClientRequest_1.ClientRequestInterceptor(), new fetch_1.FetchInterceptor()],
+    });
+    interceptor.on('request', ({ request, controller }) => {
+        void handleHttpReplayRequest({ request, controller }, { ...options, bypassFetch: options.bypassFetch ?? bypassFetch });
+    });
+    interceptor.apply();
+    return interceptor;
+}
+//# sourceMappingURL=replay.js.map

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

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

package/dist/instrumentations/postgres/capture.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Capture hooks for Postgres. Pairs with replay/postgres.ts (same protocol & identifier).
+ * Design §3.1, §5.3: hooks align with @opentelemetry/instrumentation-pg contracts.
+ * Design §10.4: query result rows written to NDJSON outbound record via CassetteStore.
+ *
+ * Unlike Redis/undici where a single responseHook receives both request and response
+ * info, instrumentation-pg splits them into separate hooks:
+ *   requestHook(span, { query: { text, values?, name? }, connection })
+ *   responseHook(span, { data: { rows, rowCount, command, ... } })
+ */
+/** Query info passed to the pg requestHook. Contract: PgRequestHookInformation. */
+export interface PgQueryInfo {
+    query: {
+        text: string;
+        name?: string;
+        values?: unknown[];
+    };
+    connection?: {
+        database?: string;
+        host?: string;
+        port?: number;
+        user?: string;
+    };
+}
+/** Result info passed to the pg responseHook. Contract: PgResponseHookInformation. */
+export interface PgResultInfo {
+    data: {
+        rows?: unknown[];
+        rowCount?: number | null;
+        command?: string;
+    };
+}
+export declare const PG_INSTRUMENTATION_NAME = "@opentelemetry/instrumentation-pg";
+/**
+ * Builds the requestHook for Postgres instrumentation.
+ * Sets softprobe.protocol, softprobe.identifier (SQL text), and softprobe.request.body
+ * (query text + values) on the span.
+ */
+export declare function buildPostgresRequestHook(): (span: unknown, queryInfo: unknown) => void;
+/**
+ * Builds the responseHook for Postgres instrumentation.
+ * Sets softprobe.response.body on the span and, when a capture store is set,
+ * writes an outbound SoftprobeCassetteRecord with responsePayload.rows (Task 10.4.1).
+ */
+export declare function buildPostgresResponseHook(): (span: unknown, result: unknown) => void;
+//# sourceMappingURL=capture.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../../src/instrumentations/postgres/capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,mFAAmF;AACnF,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IAC3D,UAAU,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACjF;AAED,sFAAsF;AACtF,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACxE;AAED,eAAO,MAAM,uBAAuB,sCAAsC,CAAC;AAW3E;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,KAAK,IAAI,CAatF;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CA8BpF"}

package/dist/instrumentations/postgres/capture.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * Capture hooks for Postgres. Pairs with replay/postgres.ts (same protocol & identifier).
+ * Design §3.1, §5.3: hooks align with @opentelemetry/instrumentation-pg contracts.
+ * Design §10.4: query result rows written to NDJSON outbound record via CassetteStore.
+ *
+ * Unlike Redis/undici where a single responseHook receives both request and response
+ * info, instrumentation-pg splits them into separate hooks:
+ *   requestHook(span, { query: { text, values?, name? }, connection })
+ *   responseHook(span, { data: { rows, rowCount, command, ... } })
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PG_INSTRUMENTATION_NAME = void 0;
+exports.buildPostgresRequestHook = buildPostgresRequestHook;
+exports.buildPostgresResponseHook = buildPostgresResponseHook;
+const context_1 = require("../../context");
+exports.PG_INSTRUMENTATION_NAME = '@opentelemetry/instrumentation-pg';
+/**
+ * Builds the requestHook for Postgres instrumentation.
+ * Sets softprobe.protocol, softprobe.identifier (SQL text), and softprobe.request.body
+ * (query text + values) on the span.
+ */
+function buildPostgresRequestHook() {
+    return (span, queryInfo) => {
+        const s = span;
+        const info = queryInfo;
+        const text = info?.query?.text ?? '';
+        s.setAttribute('softprobe.protocol', 'postgres');
+        s.setAttribute('softprobe.identifier', text);
+        s.setAttribute('softprobe.request.body', JSON.stringify({ text, values: info?.query?.values ?? [] }));
+    };
+}
+/**
+ * Builds the responseHook for Postgres instrumentation.
+ * Sets softprobe.response.body on the span and, when a capture store is set,
+ * writes an outbound SoftprobeCassetteRecord with responsePayload.rows (Task 10.4.1).
+ */
+function buildPostgresResponseHook() {
+    return (span, result) => {
+        const s = span;
+        const info = result;
+        const data = info?.data ?? {};
+        const responseBody = { rows: data.rows ?? [], rowCount: data.rowCount ?? 0, command: data.command };
+        if (s.setAttribute) {
+            s.setAttribute('softprobe.response.body', JSON.stringify(responseBody));
+        }
+        const ctx = s.spanContext?.() ?? { traceId: '', spanId: '' };
+        const attrs = s.attributes ?? {};
+        const record = {
+            version: '4.1',
+            traceId: ctx.traceId,
+            spanId: ctx.spanId,
+            parentSpanId: s.parentSpanId,
+            spanName: s.name,
+            timestamp: new Date().toISOString(),
+            type: 'outbound',
+            protocol: 'postgres',
+            identifier: attrs['softprobe.identifier'] ?? '',
+            responsePayload: { rows: data.rows ?? [], rowCount: data.rowCount ?? 0, command: data.command },
+        };
+        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/postgres/capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.js","sourceRoot":"","sources":["../../../src/instrumentations/postgres/capture.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAgCH,4DAaC;AAOD,8DA8BC;AA/ED,2CAAiD;AAapC,QAAA,uBAAuB,GAAG,mCAAmC,CAAC;AAW3E;;;;GAIG;AACH,SAAgB,wBAAwB;IACtC,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE;QACzB,MAAM,CAAC,GAAG,IAA+D,CAAC;QAC1E,MAAM,IAAI,GAAG,SAAwB,CAAC;QACtC,MAAM,IAAI,GAAG,IAAI,EAAE,KAAK,EAAE,IAAI,IAAI,EAAE,CAAC;QAErC,CAAC,CAAC,YAAY,CAAC,oBAAoB,EAAE,UAAU,CAAC,CAAC;QACjD,CAAC,CAAC,YAAY,CAAC,sBAAsB,EAAE,IAAI,CAAC,CAAC;QAC7C,CAAC,CAAC,YAAY,CACZ,wBAAwB,EACxB,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,IAAI,EAAE,EAAE,CAAC,CAC5D,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAgB,yBAAyB;IACvC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;QACtB,MAAM,CAAC,GAAG,IAA0E,CAAC;QACrF,MAAM,IAAI,GAAG,MAAsB,CAAC;QACpC,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;QAC9B,MAAM,YAAY,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QACpG,IAAI,CAAC,CAAC,YAAY,EAAE,CAAC;YACnB,CAAC,CAAC,YAAY,CAAC,yBAAyB,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC;QAC1E,CAAC;QAED,MAAM,GAAG,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QAC7D,MAAM,KAAK,GAAG,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC;QACjC,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,UAAU;YACpB,UAAU,EAAG,KAAK,CAAC,sBAAsB,CAAY,IAAI,EAAE;YAC3D,eAAe,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE;SAChG,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/postgres/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Postgres instrumentation package entry point.
+ */
+export { PG_INSTRUMENTATION_NAME, buildPostgresRequestHook, buildPostgresResponseHook, } from './capture';
+export { applyPostgresReplay, setupPostgresReplay } from './replay';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/instrumentations/postgres/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC"}

package/dist/instrumentations/postgres/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupPostgresReplay = exports.applyPostgresReplay = exports.buildPostgresResponseHook = exports.buildPostgresRequestHook = exports.PG_INSTRUMENTATION_NAME = void 0;
+/**
+ * Postgres instrumentation package entry point.
+ */
+var capture_1 = require("./capture");
+Object.defineProperty(exports, "PG_INSTRUMENTATION_NAME", { enumerable: true, get: function () { return capture_1.PG_INSTRUMENTATION_NAME; } });
+Object.defineProperty(exports, "buildPostgresRequestHook", { enumerable: true, get: function () { return capture_1.buildPostgresRequestHook; } });
+Object.defineProperty(exports, "buildPostgresResponseHook", { enumerable: true, get: function () { return capture_1.buildPostgresResponseHook; } });
+var replay_1 = require("./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=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/instrumentations/postgres/index.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,qCAImB;AAHjB,kHAAA,uBAAuB,OAAA;AACvB,mHAAA,wBAAwB,OAAA;AACxB,oHAAA,yBAAyB,OAAA;AAE3B,mCAAoE;AAA3D,6GAAA,mBAAmB,OAAA;AAAE,6GAAA,mBAAmB,OAAA"}

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

@@ -0,0 +1,20 @@
+/**
+ * Postgres replay: patches pg.Client.prototype.query so that under replay context
+ * calls are resolved by the SemanticMatcher (no live network). Pairs with capture
+ * Task 4.2; identifier = query text per design §3.1, §6.
+ */
+/**
+ * Patches a pg module so connect is no-op and query uses matcher. Idempotent.
+ * Exported so init can call it from a require hook and patch whichever module first requires 'pg' (Task 16.3.1).
+ */
+export declare function applyPostgresReplay(pg: {
+    Client: {
+        prototype: Record<string, unknown>;
+    };
+}): void;
+/**
+ * Sets up Postgres replay. Called from init so patches are in place before OTel.
+ * Idempotent when already applied. OTel may wrap on top when sdk.start() runs.
+ */
+export declare function setupPostgresReplay(): void;
+//# sourceMappingURL=replay.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../../../src/instrumentations/postgres/replay.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE;IAAE,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAA;CAAE,GAAG,IAAI,CAuIhG;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAQ1C"}

package/dist/instrumentations/postgres/replay.js

@@ -0,0 +1,163 @@
+"use strict";
+/**
+ * Postgres replay: patches pg.Client.prototype.query so that under replay context
+ * calls are resolved by the SemanticMatcher (no live network). Pairs with capture
+ * Task 4.2; identifier = query text per design §3.1, §6.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyPostgresReplay = applyPostgresReplay;
+exports.setupPostgresReplay = setupPostgresReplay;
+const shimmer_1 = __importDefault(require("shimmer"));
+const api_1 = require("@opentelemetry/api");
+const context_1 = require("../../context");
+const postgres_span_1 = require("../../core/bindings/postgres-span");
+const SOFTPROBE_WRAPPED_MARKER = '__softprobeWrapped';
+/**
+ * Patches a pg module so connect is no-op and query uses matcher. Idempotent.
+ * Exported so init can call it from a require hook and patch whichever module first requires 'pg' (Task 16.3.1).
+ */
+function applyPostgresReplay(pg) {
+    const existingQuery = pg.Client.prototype.query;
+    if (existingQuery[SOFTPROBE_WRAPPED_MARKER])
+        return;
+    const connectKey = 'connect';
+    const existingConnect = pg.Client.prototype[connectKey];
+    if (typeof pg.Client.prototype[connectKey] === 'function' && !existingConnect?.__softprobeConnect) {
+        const origConnect = pg.Client.prototype[connectKey];
+        // Use Object.defineProperty (NOT shimmer.wrap) so OTel does NOT detect __wrapped and strip us.
+        // OTel's isWrapped() checks __wrapped; without it, OTel wraps our function instead of
+        // replacing it. Call chain: OTel wrapper → our wrapper → original connect.
+        const patchedConnect = function wrappedConnect(...args) {
+            if (context_1.SoftprobeContext.getMode() === 'REPLAY')
+                return Promise.resolve();
+            return origConnect.apply(this, args);
+        };
+        patchedConnect.__softprobeConnect = true;
+        Object.defineProperty(pg.Client.prototype, connectKey, {
+            configurable: true,
+            writable: true,
+            value: patchedConnect,
+        });
+    }
+    // end() must not touch the network when we never connected (Task 16.3.1). OTel does not wrap
+    // end(), so shimmer is safe here.
+    const endKey = 'end';
+    const existingEnd = pg.Client.prototype[endKey];
+    if (typeof pg.Client.prototype[endKey] === 'function' && !existingEnd?.__softprobeEndNoop) {
+        shimmer_1.default.wrap(pg.Client.prototype, endKey, (originalEnd) => function wrappedEnd(...args) {
+            if (context_1.SoftprobeContext.getMode() === 'REPLAY')
+                return Promise.resolve();
+            return originalEnd.apply(this, args);
+        });
+        pg.Client.prototype[endKey].__softprobeEndNoop = true;
+    }
+    // Use Object.defineProperty (NOT shimmer.wrap) so OTel does NOT detect __wrapped and strip us.
+    // OTel wraps our patchedQuery with its span-creating wrapper; our wrapper stays in the chain.
+    // Call chain: OTel query wrapper → our patchedQuery → original query.
+    const origQuery = pg.Client.prototype.query;
+    const patchedQuery = function wrappedQuery(...args) {
+        const matcher = context_1.SoftprobeContext.active().matcher;
+        const mode = context_1.SoftprobeContext.getMode();
+        const strictReplay = context_1.SoftprobeContext.getStrictReplay();
+        if (!matcher) {
+            if (mode === 'REPLAY' && strictReplay) {
+                const replayErr = new Error('Softprobe replay: no match for pg.query');
+                const lastArg = args[args.length - 1];
+                const cb = typeof lastArg === 'function' ? lastArg : undefined;
+                if (cb) {
+                    process.nextTick(() => cb(replayErr));
+                    return undefined;
+                }
+                return Promise.reject(replayErr);
+            }
+            return origQuery.apply(this, args);
+        }
+        const config = args[0];
+        const queryString = typeof config === 'string' ? config : config?.text;
+        if (typeof queryString !== 'string') {
+            return origQuery.apply(this, args);
+        }
+        // Support both promise and callback style (design §9.1: callback is last arg).
+        const lastArg = args[args.length - 1];
+        const cb = typeof lastArg === 'function' ? lastArg : undefined;
+        const valsArray = Array.isArray(args[1]) ? args[1] : undefined;
+        postgres_span_1.PostgresSpan.tagQuery(queryString, valsArray, api_1.trace.getActiveSpan() ?? undefined);
+        let payload;
+        const softprobeMatcher = matcher;
+        if (typeof softprobeMatcher.match === 'function') {
+            const r = softprobeMatcher.match({
+                attributes: {
+                    'softprobe.protocol': 'postgres',
+                    'softprobe.identifier': queryString,
+                    ...(valsArray !== undefined && { 'softprobe.request.body': JSON.stringify(valsArray) }),
+                },
+            });
+            if (r.action === 'MOCK') {
+                payload = r.payload;
+            }
+            else if (r.action === 'PASSTHROUGH') {
+                return origQuery.apply(this, args);
+            }
+            else {
+                if (strictReplay) {
+                    const strictErr = new Error('Softprobe replay: no match for pg.query');
+                    if (cb) {
+                        process.nextTick(() => cb(strictErr));
+                        return undefined;
+                    }
+                    return Promise.reject(strictErr);
+                }
+                return origQuery.apply(this, args);
+            }
+        }
+        else {
+            try {
+                payload = matcher.findMatch({
+                    protocol: 'postgres',
+                    identifier: queryString,
+                    requestBody: valsArray,
+                });
+            }
+            catch (err) {
+                if (strictReplay) {
+                    const strictErr = new Error('Softprobe replay: no match for pg.query');
+                    if (cb) {
+                        process.nextTick(() => cb(strictErr));
+                        return undefined;
+                    }
+                    return Promise.reject(strictErr);
+                }
+                return origQuery.apply(this, args);
+            }
+        }
+        const rows = Array.isArray(payload) ? payload : payload?.rows ?? [];
+        const rowCount = payload?.rowCount ?? rows.length;
+        const mockedResult = { rows, rowCount, command: 'SELECT', oid: 0, fields: [] };
+        if (cb) {
+            process.nextTick(() => cb(null, mockedResult));
+            return undefined;
+        }
+        return Promise.resolve(mockedResult);
+    };
+    patchedQuery[SOFTPROBE_WRAPPED_MARKER] = true;
+    Object.defineProperty(pg.Client.prototype, 'query', {
+        configurable: true,
+        writable: true,
+        value: patchedQuery,
+    });
+}
+/**
+ * Sets up Postgres replay. Called from init so patches are in place before OTel.
+ * Idempotent when already applied. OTel may wrap on top when sdk.start() runs.
+ */
+function setupPostgresReplay() {
+    const pg = require('pg');
+    const existingQuery = pg.Client.prototype.query;
+    if (existingQuery[SOFTPROBE_WRAPPED_MARKER])
+        return;
+    applyPostgresReplay(pg);
+}
+//# sourceMappingURL=replay.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"replay.js","sourceRoot":"","sources":["../../../src/instrumentations/postgres/replay.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;AAeH,kDAuIC;AAMD,kDAQC;AAlKD,sDAA8B;AAC9B,4CAA2C;AAG3C,2CAAiD;AACjD,qEAAiE;AAEjE,MAAM,wBAAwB,GAAG,oBAAoB,CAAC;AAEtD;;;GAGG;AACH,SAAgB,mBAAmB,CAAC,EAAsD;IACxF,MAAM,aAAa,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,KAAiD,CAAC;IAC5F,IAAI,aAAa,CAAC,wBAAwB,CAAC;QAAE,OAAO;IAEpD,MAAM,UAAU,GAAG,SAAkB,CAAC;IACtC,MAAM,eAAe,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAqC,CAAC;IAC5F,IAAI,OAAO,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,UAAU,IAAI,CAAC,eAAe,EAAE,kBAAkB,EAAE,CAAC;QAClG,MAAM,WAAW,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAoC,CAAC;QACvF,+FAA+F;QAC/F,sFAAsF;QACtF,2EAA2E;QAC3E,MAAM,cAAc,GAAG,SAAS,cAAc,CAAgB,GAAG,IAAe;YAC9E,IAAI,0BAAgB,CAAC,OAAO,EAAE,KAAK,QAAQ;gBAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;YACtE,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACvC,CAAC,CAAC;QACD,cAA6D,CAAC,kBAAkB,GAAG,IAAI,CAAC;QACzF,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,UAAU,EAAE;YACrD,YAAY,EAAE,IAAI;YAClB,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,cAAc;SACtB,CAAC,CAAC;IACL,CAAC;IACD,6FAA6F;IAC7F,kCAAkC;IAClC,MAAM,MAAM,GAAG,KAAc,CAAC;IAC9B,MAAM,WAAW,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAqC,CAAC;IACpF,IAAI,OAAO,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,WAAW,EAAE,kBAAkB,EAAE,CAAC;QAC1F,iBAAO,CAAC,IAAI,CACV,EAAE,CAAC,MAAM,CAAC,SAAS,EACnB,MAAM,EACN,CAAC,WAA4C,EAAE,EAAE,CAC/C,SAAS,UAAU,CAAgB,GAAG,IAAe;YACnD,IAAI,0BAAgB,CAAC,OAAO,EAAE,KAAK,QAAQ;gBAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;YACtE,OAAQ,WAA4C,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACzE,CAAC,CACJ,CAAC;QACD,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAsC,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAC9F,CAAC;IAED,+FAA+F;IAC/F,8FAA8F;IAC9F,sEAAsE;IACtE,MAAM,SAAS,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,KAAwC,CAAC;IAC/E,MAAM,YAAY,GAAG,SAAS,YAAY,CAAgB,GAAG,IAAe;QACtE,MAAM,OAAO,GAAG,0BAAgB,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC;QAClD,MAAM,IAAI,GAAG,0BAAgB,CAAC,OAAO,EAAE,CAAC;QACxC,MAAM,YAAY,GAAG,0BAAgB,CAAC,eAAe,EAAE,CAAC;QACxD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,IAAI,IAAI,KAAK,QAAQ,IAAI,YAAY,EAAE,CAAC;gBACtC,MAAM,SAAS,GAAG,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;gBACvE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBACtC,MAAM,EAAE,GAAG,OAAO,OAAO,KAAK,UAAU,CAAC,CAAC,CAAE,OAAsD,CAAC,CAAC,CAAC,SAAS,CAAC;gBAC/G,IAAI,EAAE,EAAE,CAAC;oBACP,OAAO,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;oBACtC,OAAO,SAAS,CAAC;gBACnB,CAAC;gBACD,OAAO,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACnC,CAAC;YACD,OAAO,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACrC,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACvB,MAAM,WAAW,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAE,MAA4B,EAAE,IAAI,CAAC;QAC9F,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;YACpC,OAAO,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACrC,CAAC;QAED,+EAA+E;QAC/E,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACtC,MAAM,EAAE,GAAG,OAAO,OAAO,KAAK,UAAU,CAAC,CAAC,CAAE,OAAsD,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/G,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAE/D,4BAAY,CAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,EAAE,WAAK,CAAC,aAAa,EAAE,IAAI,SAAS,CAAC,CAAC;QAElF,IAAI,OAAgB,CAAC;QACrB,MAAM,gBAAgB,GAAG,OAA2B,CAAC;QACrD,IAAI,OAAO,gBAAgB,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YACjD,MAAM,CAAC,GAAG,gBAAgB,CAAC,KAAK,CAAC;gBAC/B,UAAU,EAAE;oBACV,oBAAoB,EAAE,UAAU;oBAChC,sBAAsB,EAAE,WAAW;oBACnC,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,wBAAwB,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;iBACxF;aACF,CAAC,CAAC;YACH,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBACxB,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;YACtB,CAAC;iBAAM,IAAI,CAAC,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;gBACtC,OAAO,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACrC,CAAC;iBAAM,CAAC;gBACN,IAAI,YAAY,EAAE,CAAC;oBACjB,MAAM,SAAS,GAAG,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;oBACvE,IAAI,EAAE,EAAE,CAAC;wBACP,OAAO,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAE,EAAiD,CAAC,SAAS,CAAC,CAAC,CAAC;wBACtF,OAAO,SAAS,CAAC;oBACnB,CAAC;oBACD,OAAO,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBACnC,CAAC;gBACD,OAAO,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,CAAC;gBACH,OAAO,GAAI,OAA2B,CAAC,SAAS,CAAC;oBAC/C,QAAQ,EAAE,UAAU;oBACpB,UAAU,EAAE,WAAW;oBACvB,WAAW,EAAE,SAAS;iBACvB,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,YAAY,EAAE,CAAC;oBACjB,MAAM,SAAS,GAAG,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;oBACvE,IAAI,EAAE,EAAE,CAAC;wBACP,OAAO,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAE,EAAiD,CAAC,SAAS,CAAC,CAAC,CAAC;wBACtF,OAAO,SAAS,CAAC;oBACnB,CAAC;oBACD,OAAO,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBACnC,CAAC;gBACD,OAAO,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QAED,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAE,OAAgC,EAAE,IAAI,IAAI,EAAE,CAAC;QAC9F,MAAM,QAAQ,GAAI,OAAiC,EAAE,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC;QAC7E,MAAM,YAAY,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QAE/E,IAAI,EAAE,EAAE,CAAC;YACP,OAAO,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAE,EAAiD,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC;YAC/F,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC3C,CAAC,CAAC;IACD,YAAmD,CAAC,wBAAwB,CAAC,GAAG,IAAI,CAAC;IACtF,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE;QAClD,YAAY,EAAE,IAAI;QAClB,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,YAAY;KACpB,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,SAAgB,mBAAmB;IACjC,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,MAAM,aAAa,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,KAGzC,CAAC;IACF,IAAI,aAAa,CAAC,wBAAwB,CAAC;QAAE,OAAO;IACpD,mBAAmB,CAAC,EAAE,CAAC,CAAC;AAC1B,CAAC"}

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

@@ -0,0 +1,20 @@
+/**
+ * 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
+ */
+export declare const 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.
+ */
+export declare function buildRedisResponseHook(): (...args: unknown[]) => void;
+//# sourceMappingURL=capture.d.ts.map