@softprobe/softprobe-js 2.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"topology.d.ts","sourceRoot":"","sources":["../../../src/core/matcher/topology.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAiB,SAAS,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC5F,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/core/matcher/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/core/matcher/topology.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topology.js","sourceRoot":"","sources":["../../../src/core/matcher/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/core/runtime/architecture-guard.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Returns true when source text contains a forbidden instrumentation import for the given scope.
+ */
+export declare function hasForbiddenImport(source: string, scope: 'core' | 'instrumentation'): boolean;
+/**
+ * Scans repository source layout for architecture violations described by Task 2.10.
+ */
+export declare function collectArchitectureViolations(): string[];
+//# sourceMappingURL=architecture-guard.d.ts.map

package/dist/core/runtime/architecture-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"architecture-guard.d.ts","sourceRoot":"","sources":["../../../src/core/runtime/architecture-guard.ts"],"names":[],"mappings":"AAaA;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,iBAAiB,GAAG,OAAO,CAK7F;AAED;;GAEG;AACH,wBAAgB,6BAA6B,IAAI,MAAM,EAAE,CA+DxD"}

package/dist/core/runtime/architecture-guard.js

@@ -0,0 +1,131 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasForbiddenImport = hasForbiddenImport;
+exports.collectArchitectureViolations = collectArchitectureViolations;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const SRC_ROOT = node_path_1.default.resolve(__dirname, '..', '..');
+const INSTRUMENTATIONS_ROOT = node_path_1.default.join(SRC_ROOT, 'instrumentations');
+const CORE_ROOT = node_path_1.default.join(SRC_ROOT, 'core');
+const LEGACY_RETIREMENT_DIRS = [
+    node_path_1.default.join(SRC_ROOT, 'bindings'),
+    node_path_1.default.join(SRC_ROOT, 'capture'),
+    node_path_1.default.join(SRC_ROOT, 'replay'),
+];
+/**
+ * Returns true when source text contains a forbidden instrumentation import for the given scope.
+ */
+function hasForbiddenImport(source, scope) {
+    if (scope === 'core') {
+        return /from\s+['\"][^'\"]*(instrumentations\/|capture\/|replay\/|bindings\/)/.test(source);
+    }
+    return /from\s+['\"][^'\"]*instrumentations\/(?!common\/)/.test(source);
+}
+/**
+ * Scans repository source layout for architecture violations described by Task 2.10.
+ */
+function collectArchitectureViolations() {
+    const violations = [];
+    const coreFiles = collectTsFiles(CORE_ROOT);
+    for (const file of coreFiles) {
+        const imports = collectImportSpecifiers(node_fs_1.default.readFileSync(file, 'utf8'));
+        for (const specifier of imports) {
+            if (!specifier.startsWith('.'))
+                continue;
+            const resolved = resolveToTsPath(file, specifier);
+            if (resolved) {
+                const normalizedPath = normalized(resolved);
+                if (normalizedPath.includes('/src/instrumentations/')) {
+                    violations.push(`core-imports-instrumentation: ${relative(file)} -> ${specifier}`);
+                }
+                else if (normalizedPath.includes('/src/capture/')
+                    || normalizedPath.includes('/src/replay/')
+                    || normalizedPath.includes('/src/bindings/')) {
+                    violations.push(`core-imports-legacy: ${relative(file)} -> ${specifier}`);
+                }
+            }
+        }
+    }
+    const packageDirs = node_fs_1.default
+        .readdirSync(INSTRUMENTATIONS_ROOT, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory() && entry.name !== 'common')
+        .map((entry) => node_path_1.default.join(INSTRUMENTATIONS_ROOT, entry.name));
+    for (const packageDir of packageDirs) {
+        const packageName = node_path_1.default.basename(packageDir);
+        const files = collectTsFiles(packageDir);
+        for (const file of files) {
+            const imports = collectImportSpecifiers(node_fs_1.default.readFileSync(file, 'utf8'));
+            for (const specifier of imports) {
+                if (!specifier.startsWith('.'))
+                    continue;
+                const resolved = resolveToTsPath(file, specifier);
+                if (!resolved)
+                    continue;
+                const normalizedPath = normalized(resolved);
+                if (normalizedPath.includes('/src/bindings/')
+                    || normalizedPath.includes('/src/capture/')
+                    || normalizedPath.includes('/src/replay/')) {
+                    violations.push(`instrumentation-imports-legacy-helper: ${relative(file)} -> ${specifier}`);
+                    continue;
+                }
+                if (!normalizedPath.includes('/src/instrumentations/'))
+                    continue;
+                if (normalizedPath.includes('/src/instrumentations/common/'))
+                    continue;
+                if (normalizedPath.includes(`/src/instrumentations/${packageName}/`))
+                    continue;
+                violations.push(`instrumentation-cross-package-import: ${relative(file)} -> ${specifier}`);
+            }
+        }
+    }
+    for (const legacyDir of LEGACY_RETIREMENT_DIRS) {
+        const files = collectTsFiles(legacyDir);
+        for (const file of files) {
+            violations.push(`legacy-path-retired: ${relative(file)}`);
+        }
+    }
+    return violations;
+}
+function collectTsFiles(dir) {
+    if (!node_fs_1.default.existsSync(dir))
+        return [];
+    const out = [];
+    for (const entry of node_fs_1.default.readdirSync(dir, { withFileTypes: true })) {
+        const absolutePath = node_path_1.default.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            out.push(...collectTsFiles(absolutePath));
+            continue;
+        }
+        if (entry.isFile() && absolutePath.endsWith('.ts') && !absolutePath.includes('/__tests__/')) {
+            out.push(absolutePath);
+        }
+    }
+    return out;
+}
+function collectImportSpecifiers(source) {
+    const out = [];
+    const regex = /from\s+['\"]([^'\"]+)['\"]/g;
+    for (const match of source.matchAll(regex)) {
+        out.push(match[1]);
+    }
+    return out;
+}
+function resolveToTsPath(fromFile, specifier) {
+    const candidate = node_path_1.default.resolve(node_path_1.default.dirname(fromFile), specifier);
+    const candidates = [candidate, `${candidate}.ts`, node_path_1.default.join(candidate, 'index.ts')];
+    for (const file of candidates) {
+        if (node_fs_1.default.existsSync(file))
+            return file;
+    }
+    return null;
+}
+function normalized(filePath) {
+    return filePath.replace(/\\/g, '/');
+}
+function relative(filePath) {
+    return normalized(node_path_1.default.relative(SRC_ROOT, filePath));
+}
+//# sourceMappingURL=architecture-guard.js.map

package/dist/core/runtime/architecture-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"architecture-guard.js","sourceRoot":"","sources":["../../../src/core/runtime/architecture-guard.ts"],"names":[],"mappings":";;;;;AAgBA,gDAKC;AAKD,sEA+DC;AAzFD,sDAAyB;AACzB,0DAA6B;AAE7B,MAAM,QAAQ,GAAG,mBAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACrD,MAAM,qBAAqB,GAAG,mBAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;AACtE,MAAM,SAAS,GAAG,mBAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAE9C,MAAM,sBAAsB,GAAG;IAC7B,mBAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC/B,mBAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC9B,mBAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC;CAC9B,CAAC;AAEF;;GAEG;AACH,SAAgB,kBAAkB,CAAC,MAAc,EAAE,KAAiC;IAClF,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACrB,OAAO,uEAAuE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9F,CAAC;IACD,OAAO,mDAAmD,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC1E,CAAC;AAED;;GAEG;AACH,SAAgB,6BAA6B;IAC3C,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,MAAM,SAAS,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IAC5C,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,uBAAuB,CAAC,iBAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QACvE,KAAK,MAAM,SAAS,IAAI,OAAO,EAAE,CAAC;YAChC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,SAAS;YACzC,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAClD,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,cAAc,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;gBAC5C,IAAI,cAAc,CAAC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,CAAC;oBACtD,UAAU,CAAC,IAAI,CAAC,iCAAiC,QAAQ,CAAC,IAAI,CAAC,OAAO,SAAS,EAAE,CAAC,CAAC;gBACrF,CAAC;qBAAM,IACL,cAAc,CAAC,QAAQ,CAAC,eAAe,CAAC;uBACrC,cAAc,CAAC,QAAQ,CAAC,cAAc,CAAC;uBACvC,cAAc,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAC5C,CAAC;oBACD,UAAU,CAAC,IAAI,CAAC,wBAAwB,QAAQ,CAAC,IAAI,CAAC,OAAO,SAAS,EAAE,CAAC,CAAC;gBAC5E,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,iBAAE;SACnB,WAAW,CAAC,qBAAqB,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SAC3D,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;SACjE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,mBAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAEhE,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,MAAM,WAAW,GAAG,mBAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC9C,MAAM,KAAK,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;QACzC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,uBAAuB,CAAC,iBAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;YACvE,KAAK,MAAM,SAAS,IAAI,OAAO,EAAE,CAAC;gBAChC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC;oBAAE,SAAS;gBACzC,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;gBAClD,IAAI,CAAC,QAAQ;oBAAE,SAAS;gBACxB,MAAM,cAAc,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;gBAC5C,IACE,cAAc,CAAC,QAAQ,CAAC,gBAAgB,CAAC;uBACtC,cAAc,CAAC,QAAQ,CAAC,eAAe,CAAC;uBACxC,cAAc,CAAC,QAAQ,CAAC,cAAc,CAAC,EAC1C,CAAC;oBACD,UAAU,CAAC,IAAI,CAAC,0CAA0C,QAAQ,CAAC,IAAI,CAAC,OAAO,SAAS,EAAE,CAAC,CAAC;oBAC5F,SAAS;gBACX,CAAC;gBACD,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,wBAAwB,CAAC;oBAAE,SAAS;gBACjE,IAAI,cAAc,CAAC,QAAQ,CAAC,+BAA+B,CAAC;oBAAE,SAAS;gBACvE,IAAI,cAAc,CAAC,QAAQ,CAAC,yBAAyB,WAAW,GAAG,CAAC;oBAAE,SAAS;gBAC/E,UAAU,CAAC,IAAI,CAAC,yCAAyC,QAAQ,CAAC,IAAI,CAAC,OAAO,SAAS,EAAE,CAAC,CAAC;YAC7F,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,MAAM,SAAS,IAAI,sBAAsB,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;QACxC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,UAAU,CAAC,IAAI,CAAC,wBAAwB,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,cAAc,CAAC,GAAW;IACjC,IAAI,CAAC,iBAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,GAAG,GAAa,EAAE,CAAC;IAEzB,KAAK,MAAM,KAAK,IAAI,iBAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACjE,MAAM,YAAY,GAAG,mBAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,GAAG,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC;YAC1C,SAAS;QACX,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YAC5F,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,uBAAuB,CAAC,MAAc;IAC7C,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,KAAK,GAAG,6BAA6B,CAAC;IAE5C,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3C,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,eAAe,CAAC,QAAgB,EAAE,SAAiB;IAC1D,MAAM,SAAS,GAAG,mBAAI,CAAC,OAAO,CAAC,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,CAAC;IAClE,MAAM,UAAU,GAAG,CAAC,SAAS,EAAE,GAAG,SAAS,KAAK,EAAE,mBAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;IACpF,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,IAAI,iBAAE,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;IACvC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,UAAU,CAAC,QAAgB;IAClC,OAAO,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,QAAQ,CAAC,QAAgB;IAChC,OAAO,UAAU,CAAC,mBAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;AACvD,CAAC"}

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

@@ -0,0 +1,6 @@
+/**
+ * Shared runtime helpers used by instrumentation packages.
+ */
+export { resolveRequestStorage } from '../cassette/request-storage';
+export { resolveRequestStorageForContext } from '../cassette/context-request-storage';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/runtime/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,+BAA+B,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/core/runtime/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveRequestStorageForContext = exports.resolveRequestStorage = void 0;
+/**
+ * Shared runtime helpers used by instrumentation packages.
+ */
+var request_storage_1 = require("../cassette/request-storage");
+Object.defineProperty(exports, "resolveRequestStorage", { enumerable: true, get: function () { return request_storage_1.resolveRequestStorage; } });
+var context_request_storage_1 = require("../cassette/context-request-storage");
+Object.defineProperty(exports, "resolveRequestStorageForContext", { enumerable: true, get: function () { return context_request_storage_1.resolveRequestStorageForContext; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/runtime/index.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,+DAAoE;AAA3D,wHAAA,qBAAqB,OAAA;AAC9B,+EAAsF;AAA7E,0IAAA,+BAA+B,OAAA"}

package/dist/identifier.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Legacy compatibility re-export for identifier helpers.
+ */
+export { httpIdentifier, redisIdentifier, pgIdentifier } from './core/identifier';
+//# sourceMappingURL=identifier.d.ts.map

package/dist/identifier.d.ts.map

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

package/dist/identifier.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pgIdentifier = exports.redisIdentifier = exports.httpIdentifier = void 0;
+/**
+ * Legacy compatibility re-export for identifier helpers.
+ */
+var identifier_1 = require("./core/identifier");
+Object.defineProperty(exports, "httpIdentifier", { enumerable: true, get: function () { return identifier_1.httpIdentifier; } });
+Object.defineProperty(exports, "redisIdentifier", { enumerable: true, get: function () { return identifier_1.redisIdentifier; } });
+Object.defineProperty(exports, "pgIdentifier", { enumerable: true, get: function () { return identifier_1.pgIdentifier; } });
+//# sourceMappingURL=identifier.js.map

package/dist/identifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifier.js","sourceRoot":"","sources":["../src/identifier.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,gDAAkF;AAAzE,4GAAA,cAAc,OAAA;AAAE,6GAAA,eAAe,OAAA;AAAE,0GAAA,YAAY,OAAA"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Public API for the Softprobe package. Design §4.2.
+ */
+export * from './api';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,OAAO,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Public API for the Softprobe package. Design §4.2.
+ */
+__exportStar(require("./api"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;GAEG;AACH,wCAAsB"}

package/dist/init.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Boot entry: softprobe/init.
+ * Must be imported first (before OTel). Reads config from .softprobe/config.yml
+ * (or SOFTPROBE_CONFIG_PATH) and seeds global state. Design §4.1, §11.
+ * Mode and cassette location come from config only (cassetteDirectory or cassettePath; no env fallback).
+ * Task 13.1: when cassetteDirectory is set, init does not create or pass a single-file cassette.
+ *
+ * Instrumentation is always the same for all modes: mutators and replay patches are applied once.
+ * Wrappers (pg, redis, http via MSW) take action at runtime based on SoftprobeContext.getMode().
+ * All replay patches are applied here so the app only needs to load init before OTel (one-line init; design §4.1).
+ */
+declare const pathModule: any;
+declare const ConfigManager: any;
+declare const SoftprobeContext: any;
+declare const configPath: string;
+declare const applyAutoInstrumentationMutator: any;
+declare const applyFrameworkMutators: any;
+declare const setupHttpReplayInterceptor: any;
+declare const setupPostgresReplay: any;
+declare const setupRedisReplay: any, applyRedisReplay: any;
+//# sourceMappingURL=init.d.ts.map

package/dist/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,QAAA,MAAM,UAAU,KAAkB,CAAC;AACnC,QAAA,MAAQ,aAAa,KAAuC,CAAC;AAC7D,QAAA,MAAQ,gBAAgB,KAAyB,CAAC;AAElD,QAAA,MAAM,UAAU,QAAiE,CAAC;AA6BlF,QAAA,MAAQ,+BAA+B,KAAwC,CAAC;AAChF,QAAA,MAAQ,sBAAsB,KAAkD,CAAC;AACjF,QAAA,MAAQ,0BAA0B,KAAwC,CAAC;AAC3E,QAAA,MAAQ,mBAAmB,KAA2C,CAAC;AACvE,QAAA,MAAQ,gBAAgB,OAAE,gBAAgB,KAAwC,CAAC"}

package/dist/init.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * Boot entry: softprobe/init.
+ * Must be imported first (before OTel). Reads config from .softprobe/config.yml
+ * (or SOFTPROBE_CONFIG_PATH) and seeds global state. Design §4.1, §11.
+ * Mode and cassette location come from config only (cassetteDirectory or cassettePath; no env fallback).
+ * Task 13.1: when cassetteDirectory is set, init does not create or pass a single-file cassette.
+ *
+ * Instrumentation is always the same for all modes: mutators and replay patches are applied once.
+ * Wrappers (pg, redis, http via MSW) take action at runtime based on SoftprobeContext.getMode().
+ * All replay patches are applied here so the app only needs to load init before OTel (one-line init; design §4.1).
+ */
+const pathModule = require('path');
+const { ConfigManager } = require('./config/config-manager');
+const { SoftprobeContext } = require('./context');
+const configPath = process.env.SOFTPROBE_CONFIG_PATH ?? './.softprobe/config.yml';
+try {
+    const mgr = new ConfigManager(configPath);
+    const g = mgr.get();
+    const cassetteDirectory = g.cassetteDirectory ??
+        (typeof g.cassettePath === 'string' && g.cassettePath ? pathModule.dirname(g.cassettePath) : undefined);
+    SoftprobeContext.initGlobal({
+        mode: g.mode,
+        cassetteDirectory,
+        storage: undefined,
+        strictReplay: g.replay?.strictReplay,
+        strictComparison: g.replay?.strictComparison,
+    });
+}
+catch {
+    SoftprobeContext.initGlobal({
+        mode: 'PASSTHROUGH',
+        cassetteDirectory: undefined,
+        storage: undefined,
+        strictReplay: false,
+        strictComparison: false,
+    });
+}
+const { applyAutoInstrumentationMutator } = require('./bootstrap/otel/mutator');
+const { applyFrameworkMutators } = require('./bootstrap/otel/framework-mutator');
+const { setupHttpReplayInterceptor } = require('./instrumentations/fetch');
+const { setupPostgresReplay } = require('./instrumentations/postgres');
+const { setupRedisReplay, applyRedisReplay } = require('./instrumentations/redis');
+applyAutoInstrumentationMutator();
+applyFrameworkMutators();
+// Redis: wrap attachCommands before redis is ever loaded (e.g. by OTel during sdk.start()).
+setupRedisReplay();
+setupHttpReplayInterceptor();
+setupPostgresReplay();
+applyRedisReplay(require('redis'));
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;AAEH,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AACnC,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;AAC7D,MAAM,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;AAElD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,yBAAyB,CAAC;AAClF,IAAI,CAAC;IACH,MAAM,GAAG,GAAG,IAAI,aAAa,CAAC,UAAU,CAAC,CAAC;IAC1C,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,EAKhB,CAAC;IACF,MAAM,iBAAiB,GACrB,CAAC,CAAC,iBAAiB;QACnB,CAAC,OAAO,CAAC,CAAC,YAAY,KAAK,QAAQ,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC1G,gBAAgB,CAAC,UAAU,CAAC;QAC1B,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,iBAAiB;QACjB,OAAO,EAAE,SAAS;QAClB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,YAAY;QACpC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,gBAAgB;KAC7C,CAAC,CAAC;AACL,CAAC;AAAC,MAAM,CAAC;IACP,gBAAgB,CAAC,UAAU,CAAC;QAC1B,IAAI,EAAE,aAAa;QACnB,iBAAiB,EAAE,SAAS;QAC5B,OAAO,EAAE,SAAS;QAClB,YAAY,EAAE,KAAK;QACnB,gBAAgB,EAAE,KAAK;KACxB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,EAAE,+BAA+B,EAAE,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;AAChF,MAAM,EAAE,sBAAsB,EAAE,GAAG,OAAO,CAAC,oCAAoC,CAAC,CAAC;AACjF,MAAM,EAAE,0BAA0B,EAAE,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;AAC3E,MAAM,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAAC;AACvE,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;AAEnF,+BAA+B,EAAE,CAAC;AAClC,sBAAsB,EAAE,CAAC;AACzB,4FAA4F;AAC5F,gBAAgB,EAAE,CAAC;AACnB,0BAA0B,EAAE,CAAC;AAC7B,mBAAmB,EAAE,CAAC;AACtB,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC"}

package/dist/instrumentations/common/http/context-headers.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shared HTTP header helpers for instrumentation packages.
+ */
+export type HeaderMap = Record<string, string | string[] | undefined>;
+/**
+ * Returns a normalized lower-case header map from mixed-case input keys.
+ */
+export declare function normalizeHeaderMap(headers: HeaderMap | undefined): HeaderMap;
+//# sourceMappingURL=context-headers.d.ts.map

package/dist/instrumentations/common/http/context-headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-headers.d.ts","sourceRoot":"","sources":["../../../../src/instrumentations/common/http/context-headers.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;AAEtE;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAS5E"}

package/dist/instrumentations/common/http/context-headers.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeHeaderMap = normalizeHeaderMap;
+/**
+ * Returns a normalized lower-case header map from mixed-case input keys.
+ */
+function normalizeHeaderMap(headers) {
+    if (!headers)
+        return {};
+    const normalized = {};
+    for (const [key, value] of Object.entries(headers)) {
+        normalized[key.toLowerCase()] = value;
+    }
+    return normalized;
+}
+//# sourceMappingURL=context-headers.js.map

package/dist/instrumentations/common/http/context-headers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-headers.js","sourceRoot":"","sources":["../../../../src/instrumentations/common/http/context-headers.ts"],"names":[],"mappings":";;AAQA,gDASC;AAZD;;GAEG;AACH,SAAgB,kBAAkB,CAAC,OAA8B;IAC/D,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,MAAM,UAAU,GAAc,EAAE,CAAC;IAEjC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,UAAU,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,GAAG,KAAK,CAAC;IACxC,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/instrumentations/common/http/inbound-capture.d.ts

@@ -0,0 +1,17 @@
+export type QueueInboundResponsePayload = {
+    status: number;
+    body: unknown;
+    identifier: string;
+    /** Parsed request body when middleware is placed after body-parser (Task 14.3.1). */
+    requestBody?: unknown;
+};
+/**
+ * Queues an inbound HTTP response for capture. Writes one NDJSON record via the capture store.
+ * Uses active span context for traceId/spanId when not provided in payload.
+ */
+export declare function queueInboundResponse(traceId: string, payload: QueueInboundResponsePayload): void;
+/** Engine object for design alignment; used by Express and Fastify. */
+export declare const CaptureEngine: {
+    queueInboundResponse: typeof queueInboundResponse;
+};
+//# sourceMappingURL=inbound-capture.d.ts.map

package/dist/instrumentations/common/http/inbound-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-capture.d.ts","sourceRoot":"","sources":["../../../../src/instrumentations/common/http/inbound-capture.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,2BAA2B,GAAG;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,qFAAqF;IACrF,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,2BAA2B,GACnC,IAAI,CAwBN;AAED,uEAAuE;AACvE,eAAO,MAAM,aAAa;;CAEzB,CAAC"}

package/dist/instrumentations/common/http/inbound-capture.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CaptureEngine = void 0;
+exports.queueInboundResponse = queueInboundResponse;
+const api_1 = require("@opentelemetry/api");
+const context_1 = require("../../../context");
+const identifier_1 = require("../../../core/identifier");
+/**
+ * Queues an inbound HTTP response for capture. Writes one NDJSON record via the capture store.
+ * Uses active span context for traceId/spanId when not provided in payload.
+ */
+function queueInboundResponse(traceId, payload) {
+    const span = api_1.trace.getActiveSpan();
+    const spanId = span?.spanContext().spanId ?? '';
+    const [method, ...urlParts] = payload.identifier.split(' ');
+    const url = urlParts.join(' ') || '/';
+    const cassette = context_1.SoftprobeContext.getCassette();
+    if (context_1.SoftprobeContext.getMode() !== 'CAPTURE' || !cassette)
+        return;
+    const record = {
+        version: '4.1',
+        traceId,
+        spanId,
+        timestamp: new Date().toISOString(),
+        type: 'inbound',
+        protocol: 'http',
+        identifier: (0, identifier_1.httpIdentifier)(method, url),
+        responsePayload: {
+            statusCode: payload.status,
+            body: payload.body,
+        },
+        ...(payload.requestBody !== undefined && { requestPayload: { body: payload.requestBody } }),
+    };
+    const tid = context_1.SoftprobeContext.getTraceId();
+    void cassette.saveRecord(tid ? { ...record, traceId: tid } : record).catch(() => { });
+}
+/** Engine object for design alignment; used by Express and Fastify. */
+exports.CaptureEngine = {
+    queueInboundResponse,
+};
+//# sourceMappingURL=inbound-capture.js.map

package/dist/instrumentations/common/http/inbound-capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-capture.js","sourceRoot":"","sources":["../../../../src/instrumentations/common/http/inbound-capture.ts"],"names":[],"mappings":";;;AAiBA,oDA2BC;AA5CD,4CAA2C;AAE3C,8CAAoD;AACpD,yDAA0D;AAU1D;;;GAGG;AACH,SAAgB,oBAAoB,CAClC,OAAe,EACf,OAAoC;IAEpC,MAAM,IAAI,GAAG,WAAK,CAAC,aAAa,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,IAAI,EAAE,WAAW,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC;IAEhD,MAAM,CAAC,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC5D,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC;IACtC,MAAM,QAAQ,GAAG,0BAAgB,CAAC,WAAW,EAAE,CAAC;IAChD,IAAI,0BAAgB,CAAC,OAAO,EAAE,KAAK,SAAS,IAAI,CAAC,QAAQ;QAAE,OAAO;IAClE,MAAM,MAAM,GAA4B;QACtC,OAAO,EAAE,KAAK;QACd,OAAO;QACP,MAAM;QACN,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,MAAM;QAChB,UAAU,EAAE,IAAA,2BAAc,EAAC,MAAM,EAAE,GAAG,CAAC;QACvC,eAAe,EAAE;YACf,UAAU,EAAE,OAAO,CAAC,MAAM;YAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;SACnB;QACD,GAAG,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,cAAc,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;KAC5F,CAAC;IACF,MAAM,GAAG,GAAG,0BAAgB,CAAC,UAAU,EAAE,CAAC;IAC1C,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;AACvF,CAAC;AAED,uEAAuE;AAC1D,QAAA,aAAa,GAAG;IAC3B,oBAAoB;CACrB,CAAC"}

package/dist/instrumentations/common/http/inbound-record.d.ts

@@ -0,0 +1,28 @@
+/**
+ * HTTP inbound capture: write one NDJSON record per inbound request/response.
+ * Design §10.4: Inbound HTTP — request body + response status/body.
+ * Single record embeds both requestPayload and responsePayload when available.
+ * Task 14.3.1: requestPayload.body is populated from req.body when Express
+ * middleware is placed after body-parser (via queueInboundResponse.requestBody).
+ */
+import type { CassetteStore } from '../../../store/cassette-store';
+export type WriteInboundHttpOptions = {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    spanName?: string;
+    method: string;
+    url: string;
+    /** Request body (optional). */
+    requestBody?: unknown;
+    /** Response status code (optional). */
+    statusCode?: number;
+    /** Response body (optional). */
+    responseBody?: unknown;
+};
+/**
+ * Writes one inbound HTTP cassette record. Include requestBody for request capture,
+ * and statusCode/responseBody when the response is available (same record).
+ */
+export declare function writeInboundHttpRecord(store: CassetteStore, options: WriteInboundHttpOptions): void;
+//# sourceMappingURL=inbound-record.d.ts.map

package/dist/instrumentations/common/http/inbound-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-record.d.ts","sourceRoot":"","sources":["../../../../src/instrumentations/common/http/inbound-record.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAInE,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,+BAA+B;IAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,uBAAuB,GAC/B,IAAI,CAoCN"}

package/dist/instrumentations/common/http/inbound-record.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * HTTP inbound capture: write one NDJSON record per inbound request/response.
+ * Design §10.4: Inbound HTTP — request body + response status/body.
+ * Single record embeds both requestPayload and responsePayload when available.
+ * Task 14.3.1: requestPayload.body is populated from req.body when Express
+ * middleware is placed after body-parser (via queueInboundResponse.requestBody).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeInboundHttpRecord = writeInboundHttpRecord;
+const identifier_1 = require("../../../core/identifier");
+/**
+ * Writes one inbound HTTP cassette record. Include requestBody for request capture,
+ * and statusCode/responseBody when the response is available (same record).
+ */
+function writeInboundHttpRecord(store, options) {
+    const { traceId, spanId, parentSpanId, spanName, method, url, requestBody, statusCode, responseBody, } = options;
+    const record = {
+        version: '4.1',
+        traceId,
+        spanId,
+        parentSpanId,
+        spanName,
+        timestamp: new Date().toISOString(),
+        type: 'inbound',
+        protocol: 'http',
+        identifier: (0, identifier_1.httpIdentifier)(method, url),
+    };
+    if (requestBody !== undefined) {
+        record.requestPayload = { body: requestBody };
+    }
+    if (statusCode !== undefined) {
+        record.responsePayload = {
+            statusCode,
+            body: responseBody,
+        };
+    }
+    store.saveRecord(record);
+}
+//# sourceMappingURL=inbound-record.js.map