@descryy/runtime-external-service-observation 0.2.0 → 0.3.1

package/LICENSE

@@ -0,0 +1,6 @@
+Copyright (c) Descry
+
+All rights reserved. This software is proprietary and confidential.
+No license, express or implied, to reproduce, distribute, modify, or
+create derivative works is granted except as explicitly agreed in
+writing.

package/dist/collector-version.d.ts

@@ -1,10 +1,3 @@
-/**
- * `Evidence.collectorVersion`'s source for every collector in this package:
- * this package's own `package.json` "version", read from the artifact
- * itself rather than hand-duplicated into a second string that can drift
- * from what actually shipped. Same idea as `nodeVersion` elsewhere in this
- * repo (`process.version`, always known, never probed) applied to a
- * package instead of the Node runtime.
- */
+/** `Evidence.collectorVersion` for this package's collectors. Read from `package.json`, not hand-duplicated, so it can't drift from what shipped. */
 export declare const COLLECTOR_VERSION: string;
 //# sourceMappingURL=collector-version.d.ts.map

package/dist/collector-version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collector-version.d.ts","sourceRoot":"","sources":["../src/collector-version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,eAAO,MAAM,iBAAiB,EAAE,MAA6E,CAAC"}
+{"version":3,"file":"collector-version.d.ts","sourceRoot":"","sources":["../src/collector-version.ts"],"names":[],"mappings":"AAAA,qJAAqJ;AAMrJ,eAAO,MAAM,iBAAiB,EAAE,MAA6E,CAAC"}

package/dist/collector-version.js

@@ -1,11 +1,4 @@
-/**
- * `Evidence.collectorVersion`'s source for every collector in this package:
- * this package's own `package.json` "version", read from the artifact
- * itself rather than hand-duplicated into a second string that can drift
- * from what actually shipped. Same idea as `nodeVersion` elsewhere in this
- * repo (`process.version`, always known, never probed) applied to a
- * package instead of the Node runtime.
- */
+/** `Evidence.collectorVersion` for this package's collectors. Read from `package.json`, not hand-duplicated, so it can't drift from what shipped. */
 import { createRequire } from "node:module";
 const require = createRequire(import.meta.url);
 export const COLLECTOR_VERSION = require("../package.json").version;

package/dist/collector-version.js.map

@@ -1 +1 @@
-{"version":3,"file":"collector-version.js","sourceRoot":"","sources":["../src/collector-version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,MAAM,CAAC,MAAM,iBAAiB,GAAY,OAAO,CAAC,iBAAiB,CAAkC,CAAC,OAAO,CAAC"}
+{"version":3,"file":"collector-version.js","sourceRoot":"","sources":["../src/collector-version.ts"],"names":[],"mappings":"AAAA,qJAAqJ;AAErJ,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,MAAM,CAAC,MAAM,iBAAiB,GAAY,OAAO,CAAC,iBAAiB,CAAkC,CAAC,OAAO,CAAC"}

package/dist/fetch-instrumentation.d.ts

@@ -1,61 +1,36 @@
 /**
  * `--import`-loaded preload: patches `globalThis.fetch` before the target
- * application's own code runs, so every real outbound call the application
- * issues through the bare global `fetch` is observed — proven directly (a
- * probe script, not assumed): Node's global `fetch` is a single, mutable
- * binding on `globalThis`, so a `--import` preload reassigning it here and
- * an application's completely independent, later call to bare `fetch(...)`
- * resolve to the same function. Same singleton-timing argument
- * `sqlite-instrumentation.ts` (`@descryy/runtime-database-observation`,
- * RT-141) already established for `node:sqlite`'s prototype, applied to a
- * different kind of global.
+ * application's code runs, so every outbound call through the bare global
+ * is observed. Node's global `fetch` is a single mutable binding on
+ * `globalThis`, so a preload reassigning it and a later app call resolve to
+ * the same function — same singleton-timing argument as
+ * `sqlite-instrumentation.ts` (RT-141), applied to a different global.
  *
- * **Read, not write.** The wrapper calls the original `fetch` with the
- * exact, untouched arguments it received — nothing about what leaves the
- * process changes. Request/response bodies are never read here: `status`
- * comes off the resolved `Response` before any body access, and describing
- * the outbound request (`method`/`url`/headers) is done via the same
- * `Request`/`Headers` normalisation `fetch` itself would do, on a
- * side channel, not by touching the body stream passed to the real call.
+ * Read, not write: the wrapper calls the original `fetch` with untouched
+ * arguments. Bodies are never read — `status` comes off the resolved
+ * `Response` before any body access.
  *
- * Deliberately minimal and import-free, like `sqlite-instrumentation.ts` and
- * `test-runner`'s own `reporter.ts` — this runs inside the OBSERVED process,
- * loaded by absolute path via `node --import`, never through this package's
- * normal dependency graph. Interpretation (service identity, correlation
- * ids) happens on the collector side, in the observing process, not here —
- * this only captures.
+ * Deliberately minimal and import-free, like `sqlite-instrumentation.ts` —
+ * runs inside the OBSERVED process, loaded by absolute path via
+ * `node --import`, never through this package's normal dependency graph.
+ * Interpretation happens on the collector side; this only captures.
  *
- * **The call-site stack is captured here and nowhere else.** It is the one
- * fact only this process can supply: by the time the marker line reaches a
- * collector it is text on a pipe, which is exactly why
- * `ExternalRequestCollector` reported `stackTrace: null` for as long as this
- * preload captured none. `observe_runtime`'s own header records the
- * consequence — a backend-only run "resolves both kinds of node and writes no
- * edge", because an edge needs a caller and an endpoint named by ONE
- * observation and this one named only the endpoint. Capturing the stack at
- * the call site is what makes an outbound call able to name its own caller.
+ * The call-site stack is captured here and nowhere else — it's the one
+ * fact only this process can supply (by the time the marker reaches a
+ * collector it's just text on a pipe). Capturing it here is what makes an
+ * outbound call able to name its own caller. Raw text, deliberately
+ * unparsed — parsing V8's format belongs in the observing process
+ * (`@descryy/runtime-adapter-typescript`).
  *
- * Raw text, deliberately unparsed. Parsing V8's format is
- * `@descryy/runtime-adapter-typescript`'s job and belongs in the observing
- * process, the same read-here/interpret-there split every marker in this
- * repository already uses.
+ * Cost: `new Error()` on every outbound call, in a process that opted into
+ * observation by loading this preload. `Error.stackTraceLimit` is left as
+ * the app set it — raising it would mean writing to the observed process's
+ * own config.
  *
- * The cost, stated rather than discovered: `new Error()` on every outbound
- * call. That is a stack capture per request in a process that has opted into
- * being observed by loading this preload; `Error.stackTraceLimit` is left
- * exactly as the application set it, because raising it would be this file
- * writing to the observed process's own configuration, which the paragraph
- * above forbids.
- *
- * The marker prefix and the captured shape live in `request-marker.ts`, not
- * here: this module has a module-scope effect and nothing that merely needs
- * the vocabulary may be made to import it. See that file for the measurement
- * behind that rule.
- *
- * One line of structured JSON per request, prefixed exactly like
- * `sqlite-instrumentation.ts`'s own `DESCRY_DB_QUERY {json}` convention,
- * itself following the benchmark harness's `BENCH_RESULT {json}` precedent
- * (RT-072): scraping prose measures the prose, so nothing here is prose.
+ * Marker prefix and shape live in `request-marker.ts`, not here, since this
+ * module has a module-scope effect. One line of structured JSON per
+ * request, matching `sqlite-instrumentation.ts`'s `DESCRY_DB_QUERY {json}`
+ * convention (RT-072): scraping prose measures the prose.
  */
 export {};
 //# sourceMappingURL=fetch-instrumentation.d.ts.map

package/dist/fetch-instrumentation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-instrumentation.d.ts","sourceRoot":"","sources":["../src/fetch-instrumentation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG"}
+{"version":3,"file":"fetch-instrumentation.d.ts","sourceRoot":"","sources":["../src/fetch-instrumentation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG"}

package/dist/fetch-instrumentation.js

@@ -1,75 +1,47 @@
 /**
  * `--import`-loaded preload: patches `globalThis.fetch` before the target
- * application's own code runs, so every real outbound call the application
- * issues through the bare global `fetch` is observed — proven directly (a
- * probe script, not assumed): Node's global `fetch` is a single, mutable
- * binding on `globalThis`, so a `--import` preload reassigning it here and
- * an application's completely independent, later call to bare `fetch(...)`
- * resolve to the same function. Same singleton-timing argument
- * `sqlite-instrumentation.ts` (`@descryy/runtime-database-observation`,
- * RT-141) already established for `node:sqlite`'s prototype, applied to a
- * different kind of global.
+ * application's code runs, so every outbound call through the bare global
+ * is observed. Node's global `fetch` is a single mutable binding on
+ * `globalThis`, so a preload reassigning it and a later app call resolve to
+ * the same function — same singleton-timing argument as
+ * `sqlite-instrumentation.ts` (RT-141), applied to a different global.
  *
- * **Read, not write.** The wrapper calls the original `fetch` with the
- * exact, untouched arguments it received — nothing about what leaves the
- * process changes. Request/response bodies are never read here: `status`
- * comes off the resolved `Response` before any body access, and describing
- * the outbound request (`method`/`url`/headers) is done via the same
- * `Request`/`Headers` normalisation `fetch` itself would do, on a
- * side channel, not by touching the body stream passed to the real call.
+ * Read, not write: the wrapper calls the original `fetch` with untouched
+ * arguments. Bodies are never read — `status` comes off the resolved
+ * `Response` before any body access.
  *
- * Deliberately minimal and import-free, like `sqlite-instrumentation.ts` and
- * `test-runner`'s own `reporter.ts` — this runs inside the OBSERVED process,
- * loaded by absolute path via `node --import`, never through this package's
- * normal dependency graph. Interpretation (service identity, correlation
- * ids) happens on the collector side, in the observing process, not here —
- * this only captures.
+ * Deliberately minimal and import-free, like `sqlite-instrumentation.ts` —
+ * runs inside the OBSERVED process, loaded by absolute path via
+ * `node --import`, never through this package's normal dependency graph.
+ * Interpretation happens on the collector side; this only captures.
  *
- * **The call-site stack is captured here and nowhere else.** It is the one
- * fact only this process can supply: by the time the marker line reaches a
- * collector it is text on a pipe, which is exactly why
- * `ExternalRequestCollector` reported `stackTrace: null` for as long as this
- * preload captured none. `observe_runtime`'s own header records the
- * consequence — a backend-only run "resolves both kinds of node and writes no
- * edge", because an edge needs a caller and an endpoint named by ONE
- * observation and this one named only the endpoint. Capturing the stack at
- * the call site is what makes an outbound call able to name its own caller.
+ * The call-site stack is captured here and nowhere else — it's the one
+ * fact only this process can supply (by the time the marker reaches a
+ * collector it's just text on a pipe). Capturing it here is what makes an
+ * outbound call able to name its own caller. Raw text, deliberately
+ * unparsed — parsing V8's format belongs in the observing process
+ * (`@descryy/runtime-adapter-typescript`).
  *
- * Raw text, deliberately unparsed. Parsing V8's format is
- * `@descryy/runtime-adapter-typescript`'s job and belongs in the observing
- * process, the same read-here/interpret-there split every marker in this
- * repository already uses.
+ * Cost: `new Error()` on every outbound call, in a process that opted into
+ * observation by loading this preload. `Error.stackTraceLimit` is left as
+ * the app set it — raising it would mean writing to the observed process's
+ * own config.
  *
- * The cost, stated rather than discovered: `new Error()` on every outbound
- * call. That is a stack capture per request in a process that has opted into
- * being observed by loading this preload; `Error.stackTraceLimit` is left
- * exactly as the application set it, because raising it would be this file
- * writing to the observed process's own configuration, which the paragraph
- * above forbids.
- *
- * The marker prefix and the captured shape live in `request-marker.ts`, not
- * here: this module has a module-scope effect and nothing that merely needs
- * the vocabulary may be made to import it. See that file for the measurement
- * behind that rule.
- *
- * One line of structured JSON per request, prefixed exactly like
- * `sqlite-instrumentation.ts`'s own `DESCRY_DB_QUERY {json}` convention,
- * itself following the benchmark harness's `BENCH_RESULT {json}` precedent
- * (RT-072): scraping prose measures the prose, so nothing here is prose.
+ * Marker prefix and shape live in `request-marker.ts`, not here, since this
+ * module has a module-scope effect. One line of structured JSON per
+ * request, matching `sqlite-instrumentation.ts`'s `DESCRY_DB_QUERY {json}`
+ * convention (RT-072): scraping prose measures the prose.
  */
-import { REQUEST_MARKER } from "./request-marker.js";
-/** This module's own location, in both shapes a V8 frame can print it: an ESM frame stringifies a `file://` URL, a CJS one a plain path. */
+import { REQUEST_MARKER, FETCH_BINDING_FAILURE_MARKER } from "./request-marker.js";
+/** This module's own location, in both shapes a V8 frame prints it: ESM stringifies a `file://` URL, CJS a plain path. */
 const SELF_URL = import.meta.url;
 const SELF_PATH = SELF_URL.startsWith("file://") ? SELF_URL.slice("file://".length) : SELF_URL;
 /**
- * Frames belonging to this file are dropped **by file, not by count**.
- * `primaryFrameIndex` is 0 for every V8 stack this project parses, so a
- * single surviving wrapper frame would make every downstream resolution
- * point at the instrumentation instead of at the code under observation --
- * a failure that produces confident, well-formed, entirely wrong answers
- * rather than an error. Matching on `import.meta.url` also survives this
- * module being loaded from `.js` (the compiled preload, how it actually
- * runs) or `.ts` (type stripping, how a test may run it).
+ * Frames from this file are dropped **by file, not by count** — a
+ * surviving wrapper frame would make every downstream resolution point at
+ * the instrumentation instead of the observed code (`primaryFrameIndex` is
+ * 0 for every V8 stack this project parses). Matching `import.meta.url`
+ * survives this being loaded as `.js` (real) or `.ts` (test).
  */
 function callSiteStack() {
     const raw = new Error().stack;
@@ -78,8 +50,8 @@ function callSiteStack() {
     const lines = raw.split("\n");
     const header = lines[0] ?? "Error";
     const frames = lines.slice(1).filter((line) => !line.includes(SELF_URL) && !line.includes(SELF_PATH));
-    // Nothing but our own frames: no application call site was captured, which
-    // is `null` rather than a header line pretending to be a stack.
+    // Nothing but our own frames: `null` rather than a header line pretending
+    // to be a stack.
     if (frames.length === 0)
         return null;
     return [header, ...frames].join("\n");
@@ -93,12 +65,7 @@ function headersToObject(headers) {
         out[name] = value;
     return out;
 }
-/**
- * `url`/`method`/`requestHeaders` off the call's own arguments, without
- * touching the body -- a `Request` object already carries these structured;
- * a `(input, init)` pair is normalised the same way `fetch` itself would,
- * via the real `Headers` constructor rather than hand-parsed.
- */
+/** `url`/`method`/`requestHeaders` off the call's own arguments, without touching the body. Normalised via the real `Headers` constructor, not hand-parsed. */
 function describeRequest(input, init) {
     if (input instanceof Request) {
         return { url: input.url, method: input.method, requestHeaders: headersToObject(input.headers) };
@@ -107,31 +74,38 @@ function describeRequest(input, init) {
     const method = (init?.method ?? "GET").toUpperCase();
     return { url, method, requestHeaders: headersToObject(new Headers(init?.headers)) };
 }
-// Guards against double-patching if this module is somehow loaded twice
-// (e.g. both `--import` and a transitive re-import) -- the second pass
-// would otherwise wrap an already-wrapped fetch and double-emit. Same
-// guard shape as sqlite-instrumentation.ts's own PATCHED symbol.
+// Guards against double-patching if loaded twice (double-emit otherwise).
+// Same guard shape as sqlite-instrumentation.ts's PATCHED symbol.
 const PATCHED = Symbol.for("descry.external-service-observation.fetch-patched");
 const target = globalThis;
 if (target[PATCHED] !== true) {
     target[PATCHED] = true;
     const original = globalThis.fetch;
-    globalThis.fetch = async function patchedFetch(input, init) {
-        const described = describeRequest(input, init);
-        // Captured BEFORE the call, not in the handlers below: after `await` the
-        // application's own frames are gone from the stack.
-        const stack = callSiteStack();
-        const start = performance.now();
-        try {
-            const response = await original(input, init);
-            emit({ ...described, status: response.status, durationMs: performance.now() - start, success: true, error: null, stack });
-            return response;
-        }
-        catch (error) {
-            const detail = error instanceof Error ? `${error.name}: ${error.message}` : String(error);
-            emit({ ...described, status: null, durationMs: performance.now() - start, success: false, error: detail, stack });
-            throw error;
-        }
-    };
+    // C-F6: previously unchecked — `original` could be `undefined` (old Node,
+    // `--no-experimental-fetch`), and every real call would then throw
+    // "original is not a function", indistinguishable from a real network
+    // error. Disclosed here instead via a distinct marker line; the wrapper
+    // is never installed.
+    if (typeof original !== "function") {
+        process.stdout.write(`${FETCH_BINDING_FAILURE_MARKER} ${JSON.stringify({ reason: `globalThis.fetch was ${typeof original}, not a function -- no real fetch to instrument` })}\n`);
+    }
+    else {
+        globalThis.fetch = async function patchedFetch(input, init) {
+            const described = describeRequest(input, init);
+            // Captured BEFORE the call: after `await` the app's frames are gone.
+            const stack = callSiteStack();
+            const start = performance.now();
+            try {
+                const response = await original(input, init);
+                emit({ ...described, status: response.status, durationMs: performance.now() - start, success: true, error: null, stack });
+                return response;
+            }
+            catch (error) {
+                const detail = error instanceof Error ? `${error.name}: ${error.message}` : String(error);
+                emit({ ...described, status: null, durationMs: performance.now() - start, success: false, error: detail, stack });
+                throw error;
+            }
+        };
+    }
 }
 //# sourceMappingURL=fetch-instrumentation.js.map

package/dist/fetch-instrumentation.js.map

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

package/dist/header-correlation.d.ts

@@ -1,18 +1,11 @@
 /**
- * Correlation-id extraction from real HTTP headers — the same mechanism and
- * the same closed set of header names as `extractHeaderCorrelationIds`
- * (`@descryhq-wq/runtime-browser`'s `network-correlation.ts`).
+ * Correlation-id extraction from real HTTP headers — same mechanism and
+ * header names as `@descryy/runtime-browser`'s `network-correlation.ts`.
  *
- * **Duplicated on purpose, not imported.** `browser` depends on Playwright
- * to launch and drive a real browser — a real, heavy dependency this
- * package has no other reason to carry, for a page-automation concern
- * entirely unrelated to instrumenting a backend process's own outbound
- * `fetch`. The function itself is small, pure, and reads a closed,
- * unlikely-to-change set of conventional header names — the case this
- * project's own `symbol.ts` distinguishes from (`toRepoRelative` is
- * *shared* because its two callers must translate identically); these two
- * copies have no such constraint, and importing across a Playwright
- * dependency to avoid ten lines would be the worse coupling.
+ * Duplicated on purpose, not imported: `browser` depends on Playwright, a
+ * heavy dependency this package has no other reason to carry. The function
+ * is small, pure, and reads a closed set of header names — importing across
+ * Playwright to avoid ten lines would be the worse coupling.
  */
 export interface HeaderCorrelationIds {
     readonly traceId: string | null;

package/dist/header-correlation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"header-correlation.d.ts","sourceRoot":"","sources":["../src/header-correlation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAUD,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,oBAAoB,CAS3G"}
+{"version":3,"file":"header-correlation.d.ts","sourceRoot":"","sources":["../src/header-correlation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAUD,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,oBAAoB,CAS3G"}

package/dist/header-correlation.js

@@ -1,18 +1,11 @@
 /**
- * Correlation-id extraction from real HTTP headers — the same mechanism and
- * the same closed set of header names as `extractHeaderCorrelationIds`
- * (`@descryhq-wq/runtime-browser`'s `network-correlation.ts`).
+ * Correlation-id extraction from real HTTP headers — same mechanism and
+ * header names as `@descryy/runtime-browser`'s `network-correlation.ts`.
  *
- * **Duplicated on purpose, not imported.** `browser` depends on Playwright
- * to launch and drive a real browser — a real, heavy dependency this
- * package has no other reason to carry, for a page-automation concern
- * entirely unrelated to instrumenting a backend process's own outbound
- * `fetch`. The function itself is small, pure, and reads a closed,
- * unlikely-to-change set of conventional header names — the case this
- * project's own `symbol.ts` distinguishes from (`toRepoRelative` is
- * *shared* because its two callers must translate identically); these two
- * copies have no such constraint, and importing across a Playwright
- * dependency to avoid ten lines would be the worse coupling.
+ * Duplicated on purpose, not imported: `browser` depends on Playwright, a
+ * heavy dependency this package has no other reason to carry. The function
+ * is small, pure, and reads a closed set of header names — importing across
+ * Playwright to avoid ten lines would be the worse coupling.
  */
 const TRACEPARENT_PATTERN = /^([0-9a-f]{2})-([0-9a-f]{32})-([0-9a-f]{16})-([0-9a-f]{2})$/i;
 function firstHeader(headers, names) {

package/dist/header-correlation.js.map

@@ -1 +1 @@
-{"version":3,"file":"header-correlation.js","sourceRoot":"","sources":["../src/header-correlation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,mBAAmB,GAAG,8DAA8D,CAAC;AAO3F,SAAS,WAAW,CAAC,OAAyC,EAAE,KAAwB;IACtF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;IAC5D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,OAAyC;IACnF,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,EAAE,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;IACzE,MAAM,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAE3G,OAAO;QACL,OAAO,EAAE,eAAe,IAAI,UAAU;QACtC,SAAS,EAAE,WAAW,CAAC,OAAO,EAAE,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;KAChE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"header-correlation.js","sourceRoot":"","sources":["../src/header-correlation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,mBAAmB,GAAG,8DAA8D,CAAC;AAO3F,SAAS,WAAW,CAAC,OAAyC,EAAE,KAAwB;IACtF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;IAC5D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,OAAyC;IACnF,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,EAAE,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;IACzE,MAAM,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAE3G,OAAO;QACL,OAAO,EAAE,eAAe,IAAI,UAAU;QACtC,SAAS,EAAE,WAAW,CAAC,OAAO,EAAE,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;KAChE,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-export { REQUEST_MARKER, type CapturedRequest } from "./request-marker.ts";
-export { parseRequestLine } from "./request-line-parser.ts";
+export { REQUEST_MARKER, FETCH_BINDING_FAILURE_MARKER, type CapturedRequest } from "./request-marker.ts";
+export { parseRequestLine, parseFetchBindingFailureLine } from "./request-line-parser.ts";
 export { extractServiceIdentity } from "./service-identity.ts";
 export { extractHeaderCorrelationIds, type HeaderCorrelationIds } from "./header-correlation.ts";
 export type { ExternalRequestCollectorOptions } from "./request-collector.ts";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,2BAA2B,EAAE,KAAK,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAEjG,YAAY,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,EAAE,8BAA8B,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,4BAA4B,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACzG,OAAO,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAC1F,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,2BAA2B,EAAE,KAAK,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAEjG,YAAY,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,EAAE,8BAA8B,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -1,11 +1,9 @@
-// Deliberately NOT from `fetch-instrumentation.ts`: that module replaces
-// `globalThis.fetch` at module scope, and re-exporting a constant out of it
-// put that patch into every consumer of this package -- `query-marker.ts`'s
-// measured defect, which this package still had. The preload is loaded by
-// absolute path via `node --import`, inside the observed process, never
-// through this dependency graph.
-export { REQUEST_MARKER } from "./request-marker.js";
-export { parseRequestLine } from "./request-line-parser.js";
+// Deliberately NOT from `fetch-instrumentation.ts` — that module patches
+// `globalThis.fetch` at module scope; re-exporting from it would leak the
+// patch into every consumer (`query-marker.ts`'s measured defect). The
+// preload loads by absolute path via `node --import`, never through here.
+export { REQUEST_MARKER, FETCH_BINDING_FAILURE_MARKER } from "./request-marker.js";
+export { parseRequestLine, parseFetchBindingFailureLine } from "./request-line-parser.js";
 export { extractServiceIdentity } from "./service-identity.js";
 export { extractHeaderCorrelationIds } from "./header-correlation.js";
 export { createExternalRequestCollector, FETCH_PRELOAD_MODULE_PATH } from "./request-collector.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,4EAA4E;AAC5E,4EAA4E;AAC5E,0EAA0E;AAC1E,wEAAwE;AACxE,iCAAiC;AACjC,OAAO,EAAE,cAAc,EAAwB,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,2BAA2B,EAA6B,MAAM,yBAAyB,CAAC;AAGjG,OAAO,EAAE,8BAA8B,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,0EAA0E;AAC1E,uEAAuE;AACvE,0EAA0E;AAC1E,OAAO,EAAE,cAAc,EAAE,4BAA4B,EAAwB,MAAM,qBAAqB,CAAC;AACzG,OAAO,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAC1F,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,2BAA2B,EAA6B,MAAM,yBAAyB,CAAC;AAGjG,OAAO,EAAE,8BAA8B,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/request-collector.d.ts

@@ -1,57 +1,34 @@
 /**
- * `ExternalRequestCollector` (plan §18 / checklist §18): translates
- * `fetch-instrumentation.ts`'s captured requests into `EXTERNAL_REQUEST`
- * Evidence. Same shape as `DatabaseQueryCollector`
- * (`@descryy/runtime-database-observation`, RT-141) deliberately — a
- * `ProcessOutputSource` in, `Evidence` out, streaming-first, a collector
- * failure reported as evidence rather than swallowed — but for a different
- * marker on the same stream.
+ * `ExternalRequestCollector`: translates `fetch-instrumentation.ts`'s
+ * captured requests into `EXTERNAL_REQUEST` Evidence. Same shape as
+ * `DatabaseQueryCollector` (RT-141) — `ProcessOutputSource` in, `Evidence`
+ * out, failures reported as evidence — for a different marker on the same
+ * stream.
  *
- * **What this collector does not do, named rather than silently absent:**
- * no request/response body capture (the preload never reads either stream —
- * see `fetch-instrumentation.ts`'s own "read, not write" note), no
- * provider classification beyond a request's own hostname
- * (`service-identity.ts`), and `graphNodeId` is always null — no resolver
- * from a captured hostname to any graph node exists (nothing in the 15
- * canonical node types names an external service). All real §18 rows, left
- * open rather than guessed at, matching `DatabaseQueryCollector`'s own
- * disclosure of the same shape of gap.
+ * Does NOT: capture request/response bodies (preload never reads either
+ * stream), classify providers beyond hostname (`service-identity.ts`), or
+ * set `graphNodeId` (no resolver from a hostname to any of the 15 canonical
+ * node types exists). Disclosed gaps, matching `DatabaseQueryCollector`'s own.
  *
- * ## The call-site stack, and why the parser is injected
- *
- * `stackTrace` used to be hard-null here, and `observe_runtime`'s own header
- * gave the reason: *"it parses a log line the application printed and a
- * printed line carries no stack."* The line is this package's own marker and
- * the preload that writes it runs inside the calling process, so the stack
- * was always available — nobody had captured it. It is captured now
- * (`fetch-instrumentation.ts`), and this collector attaches it.
- *
- * Parsing it is **not** this package's job. V8's `Error.stack` format is one
- * language's, and this collector observes the marker protocol, which is not.
- * So a `StackTraceParser` is an option, supplied by whoever knows which
- * runtime is being observed — `RuntimeAdapter.stackTraceParser` is exactly
- * that value, already on the seam. Omitted, this collector behaves exactly as
- * it did before the capture existed and **says so** in `capabilities()`:
- * `stackCapture: unavailable`, with the reason. A half-wired capability that
- * quietly reports nothing is the failure mode this project's honest-
- * degradation rule exists to prevent.
+ * `stackTrace` is parsed via an injected `StackTraceParser` — parsing V8's
+ * format is not this package's job, so the observed runtime's own parser
+ * (`RuntimeAdapter.stackTraceParser`) is supplied by the caller. Omitted,
+ * `capabilities()` reports `stackCapture: unavailable` with the reason
+ * rather than silently reporting nothing.
  */
 import type { Collector } from "@descryy/runtime-contracts";
 import type { ProcessOutputSource, StackTraceParser } from "@descryy/runtime-backend-observation";
-/** Absolute path to the compiled preload, for a caller building `node --import <this> <app>`. Never imported directly -- loaded by Node itself, in the observed process, before that process's own code runs. */
+/** Absolute path to the compiled preload, for `node --import <this> <app>`. Never imported directly — loaded by Node in the observed process. */
 export declare const FETCH_PRELOAD_MODULE_PATH: string;
 export interface ExternalRequestCollectorOptions {
     readonly source: ProcessOutputSource;
-    /** Which owned system this collector's evidence should be attributed to (plan §16.7). Null when not applicable. */
+    /** Which owned system this evidence should be attributed to. Null when not applicable. */
     readonly service?: string;
     /**
-     * The observed runtime's own stack parser — `RuntimeAdapter.stackTraceParser`.
-     * Supplied by a caller that knows which language it launched; this package
-     * knows no language and must not (the IR boundary rule, one layer down).
-     *
-     * Omitted means captured stacks are not parsed and `stackTrace` stays
-     * `null`, which `capabilities()` reports as `stackCapture: unavailable`
-     * rather than leaving a reader to infer it from an absence.
+     * The observed runtime's own stack parser (`RuntimeAdapter.stackTraceParser`)
+     * — this package knows no language and must not (IR boundary rule).
+     * Omitted means `stackTrace` stays `null`, reported by `capabilities()`
+     * as `stackCapture: unavailable` rather than left to infer.
      */
     readonly stackTraceParser?: StackTraceParser;
 }

package/dist/request-collector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request-collector.d.ts","sourceRoot":"","sources":["../src/request-collector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAGH,OAAO,KAAK,EAAE,SAAS,EAA+F,MAAM,4BAA4B,CAAC;AACzJ,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAOlG,iNAAiN;AACjN,eAAO,MAAM,yBAAyB,QAAwE,CAAC;AAE/G,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,mHAAmH;IACnH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;;;;OAQG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CAC9C;AAmCD,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,+BAA+B,GAAG,SAAS,CA+GlG"}
+{"version":3,"file":"request-collector.d.ts","sourceRoot":"","sources":["../src/request-collector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EAAE,SAAS,EAA+F,MAAM,4BAA4B,CAAC;AACzJ,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAOlG,iJAAiJ;AACjJ,eAAO,MAAM,yBAAyB,QAAwE,CAAC;AAE/G,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,0FAA0F;IAC1F,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;OAKG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CAC9C;AAgCD,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,+BAA+B,GAAG,SAAS,CAyJlG"}