@cubenest/rrweb-core 0.1.0-alpha.0

package/dist/network/cdp.js

@@ -0,0 +1,282 @@
+// CDP network adapter — Task 1.7.
+//
+// Subscribes to the four CDP `Network.*` events that together describe an
+// HTTP exchange:
+//
+//   - Network.requestWillBeSent — emit `CapturedRequest`
+//   - Network.responseReceived — record the response shape (we don't emit
+//     yet, because CDP fires loadingFinished afterwards with the size +
+//     final timestamp; deferring emission lets us populate `durationMs`
+//     and `encodedSize` in one pass).
+//   - Network.loadingFinished — finalize + emit `CapturedResponse`
+//   - Network.loadingFailed — emit a `CapturedResponse` with `errorText`,
+//     and (when registered) a parallel `onError` event.
+//
+// Why this adapter doesn't import a CDP client: same load-bearing reason as
+// the screenshot adapter — the substrate has to be transport-agnostic, and
+// every framework (WDIO/Playwright/Cypress) already owns a CDP session.
+// We accept a `CDPNetworkEventSource` shape and call `.on(event, handler)`.
+//
+// Body fetching is opt-in. Real-environment cost: `Network.getResponseBody`
+// keeps response bodies pinned in memory in the renderer until called,
+// which is why CDP defaults to NOT retaining them. Products turn it on
+// when they want the bodies and accept the memory tax.
+import { redactBody, redactNetworkHeaders } from '../masking';
+function readNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+function readString(value) {
+    return typeof value === 'string' ? value : undefined;
+}
+function readRecord(value) {
+    if (value === null || typeof value !== 'object')
+        return {};
+    const out = {};
+    for (const [k, v] of Object.entries(value)) {
+        if (typeof v === 'string')
+            out[k] = v;
+    }
+    return out;
+}
+/**
+ * Convert a CDP monotonic timestamp (seconds since process start) to an
+ * approximate wall-clock ms epoch using a request-time offset. Falls back
+ * to `Date.now()` when neither side has the data we need — losing a few
+ * ms of precision in exchange for a usable timestamp every time.
+ */
+function deriveTs(startTs, startMonotonic, eventMonotonic) {
+    if (startMonotonic !== undefined && eventMonotonic !== undefined) {
+        return startTs + (eventMonotonic - startMonotonic) * 1000;
+    }
+    return Date.now();
+}
+/**
+ * Build a `NetworkCaptureAdapter` that consumes CDP `Network.*` events.
+ *
+ * The adapter installs its own subscriptions on `source` and tracks
+ * in-flight requests in an internal `Map` keyed by CDP `requestId`. The
+ * map is cleared lazily as terminal events arrive; calling `dispose()`
+ * unsubscribes all four CDP listeners and drops any remaining entries.
+ *
+ * @param source A `CDPNetworkEventSource` (typically a thin wrapper around
+ *               the CDP client owned by the calling framework).
+ * @param options `{ captureResponseBodies?, maxBodyBytes? }`.
+ */
+export function createCDPNetworkAdapter(source, options = {}) {
+    const captureBodies = options.captureResponseBodies ?? false;
+    const maxBodyBytes = options.maxBodyBytes ?? 1024 * 1024;
+    const inFlight = new Map();
+    const requestHandlers = new Set();
+    const responseHandlers = new Set();
+    const errorHandlers = new Set();
+    const emitRequest = (req) => {
+        for (const h of requestHandlers)
+            h(req);
+    };
+    const emitResponse = (res) => {
+        for (const h of responseHandlers)
+            h(res);
+    };
+    const emitError = (err) => {
+        for (const h of errorHandlers)
+            h(err);
+    };
+    // ──────────────────────────────────────────────────────────────────────
+    // Network.requestWillBeSent
+    // ──────────────────────────────────────────────────────────────────────
+    const unsubRequest = source.on('Network.requestWillBeSent', (params) => {
+        if (params === null || typeof params !== 'object')
+            return;
+        const p = params;
+        const requestId = readString(p.requestId);
+        if (requestId === undefined)
+            return;
+        const reqObj = (p.request ?? {});
+        // `wallTime` is in seconds (CDP convention); we store ms epoch.
+        const wallTime = readNumber(p.wallTime);
+        const startTs = wallTime !== undefined ? wallTime * 1000 : Date.now();
+        const startMonotonic = readNumber(p.timestamp);
+        const rawHeaders = readRecord(reqObj.headers);
+        const headers = redactNetworkHeaders(rawHeaders);
+        const initiatorObj = (p.initiator ?? undefined);
+        const initiator = readString(initiatorObj?.url) ?? readString(initiatorObj?.type) ?? undefined;
+        const rawBody = readString(reqObj.postData);
+        const requestBody = rawBody !== undefined ? redactBody(rawBody, { maxLengthBytes: maxBodyBytes }) : undefined;
+        const captured = {
+            id: requestId,
+            ts: startTs,
+            url: readString(reqObj.url) ?? '',
+            method: readString(reqObj.method) ?? 'GET',
+            headers,
+            ...(requestBody !== undefined ? { requestBody } : {}),
+            ...(initiator !== undefined ? { initiator } : {}),
+            ...(readString(p.type) !== undefined ? { resourceType: readString(p.type) } : {}),
+        };
+        inFlight.set(requestId, {
+            startTs,
+            startMonotonic,
+            request: captured,
+        });
+        emitRequest(captured);
+    });
+    // ──────────────────────────────────────────────────────────────────────
+    // Network.responseReceived — record metadata; defer emission until
+    // loadingFinished so we can fill durationMs + encodedSize in one pass.
+    // ──────────────────────────────────────────────────────────────────────
+    const unsubResponseReceived = source.on('Network.responseReceived', (params) => {
+        if (params === null || typeof params !== 'object')
+            return;
+        const p = params;
+        const requestId = readString(p.requestId);
+        if (requestId === undefined)
+            return;
+        const entry = inFlight.get(requestId);
+        if (entry === undefined)
+            return; // out-of-order or pre-attach event
+        const respObj = (p.response ?? {});
+        const rawHeaders = readRecord(respObj.headers);
+        const fromCache = respObj.fromDiskCache === true ||
+            respObj.fromServiceWorker === true ||
+            respObj.fromPrefetchCache === true;
+        entry.response = {
+            status: readNumber(respObj.status) ?? 0,
+            ...(readString(respObj.statusText) !== undefined
+                ? { statusText: readString(respObj.statusText) }
+                : {}),
+            headers: redactNetworkHeaders(rawHeaders),
+            fromCache,
+            ...(readString(respObj.mimeType) !== undefined
+                ? { mimeType: readString(respObj.mimeType) }
+                : {}),
+        };
+    });
+    // ──────────────────────────────────────────────────────────────────────
+    // Network.loadingFinished — terminal success; emit CapturedResponse.
+    // ──────────────────────────────────────────────────────────────────────
+    const unsubLoadingFinished = source.on('Network.loadingFinished', (params) => {
+        if (params === null || typeof params !== 'object')
+            return;
+        const p = params;
+        const requestId = readString(p.requestId);
+        if (requestId === undefined)
+            return;
+        const entry = inFlight.get(requestId);
+        if (entry === undefined)
+            return;
+        const finishMonotonic = readNumber(p.timestamp);
+        const ts = deriveTs(entry.startTs, entry.startMonotonic, finishMonotonic);
+        const durationMs = Math.max(0, ts - entry.startTs);
+        const encodedSize = readNumber(p.encodedDataLength);
+        const response = entry.response ?? {
+            status: 0,
+            headers: {},
+            fromCache: false,
+        };
+        // We resolve the response body separately so a failure here doesn't
+        // block emission of the terminal event. The fetch is fire-and-forget
+        // from the caller's perspective (we await before emitting, but errors
+        // are swallowed — the response shape stays correct without the body).
+        const finalize = (responseBody) => {
+            const captured = {
+                id: requestId,
+                ts,
+                status: response.status,
+                ...(response.statusText !== undefined ? { statusText: response.statusText } : {}),
+                headers: response.headers,
+                ...(responseBody !== undefined ? { responseBody } : {}),
+                fromCache: response.fromCache,
+                ...(encodedSize !== undefined ? { encodedSize } : {}),
+                durationMs,
+            };
+            inFlight.delete(requestId);
+            emitResponse(captured);
+        };
+        if (captureBodies && source.getResponseBody !== undefined) {
+            void source
+                .getResponseBody(requestId)
+                .then((reply) => {
+                // Skip binary payloads — we'd have to base64-decode + sniff the
+                // mime to do anything useful with them, and the masking module
+                // operates on strings.
+                if (reply.base64Encoded) {
+                    finalize(undefined);
+                    return;
+                }
+                finalize(redactBody(reply.body, { maxLengthBytes: maxBodyBytes }));
+            })
+                .catch(() => {
+                // CDP rejects `getResponseBody` for several legitimate reasons
+                // (preflight responses, redirects, ‘no data’ for 204s). Swallow
+                // and emit without a body — the metadata is still useful.
+                finalize(undefined);
+            });
+        }
+        else {
+            finalize(undefined);
+        }
+    });
+    // ──────────────────────────────────────────────────────────────────────
+    // Network.loadingFailed — terminal failure; emit CapturedResponse with
+    // errorText AND (when subscribed) the parallel onError event.
+    // ──────────────────────────────────────────────────────────────────────
+    const unsubLoadingFailed = source.on('Network.loadingFailed', (params) => {
+        if (params === null || typeof params !== 'object')
+            return;
+        const p = params;
+        const requestId = readString(p.requestId);
+        if (requestId === undefined)
+            return;
+        const entry = inFlight.get(requestId);
+        const errorText = readString(p.errorText) ?? 'unknown';
+        const failMonotonic = readNumber(p.timestamp);
+        const startTs = entry?.startTs ?? Date.now();
+        const ts = entry !== undefined ? deriveTs(startTs, entry.startMonotonic, failMonotonic) : startTs;
+        const durationMs = entry !== undefined ? Math.max(0, ts - startTs) : undefined;
+        const response = entry?.response ?? {
+            status: 0,
+            headers: {},
+            fromCache: false,
+        };
+        const captured = {
+            id: requestId,
+            ts,
+            status: response.status,
+            ...(response.statusText !== undefined ? { statusText: response.statusText } : {}),
+            headers: response.headers,
+            fromCache: response.fromCache,
+            ...(durationMs !== undefined ? { durationMs } : {}),
+            errorText,
+        };
+        inFlight.delete(requestId);
+        emitResponse(captured);
+        emitError({ id: requestId, ts, errorText });
+    });
+    // ──────────────────────────────────────────────────────────────────────
+    // Adapter surface
+    // ──────────────────────────────────────────────────────────────────────
+    return {
+        onRequest(handler) {
+            requestHandlers.add(handler);
+            return () => requestHandlers.delete(handler);
+        },
+        onResponse(handler) {
+            responseHandlers.add(handler);
+            return () => responseHandlers.delete(handler);
+        },
+        onError(handler) {
+            errorHandlers.add(handler);
+            return () => errorHandlers.delete(handler);
+        },
+        async dispose() {
+            unsubRequest();
+            unsubResponseReceived();
+            unsubLoadingFinished();
+            unsubLoadingFailed();
+            requestHandlers.clear();
+            responseHandlers.clear();
+            errorHandlers.clear();
+            inFlight.clear();
+        },
+    };
+}
+//# sourceMappingURL=cdp.js.map

package/dist/network/cdp.js.map

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

package/dist/network/index.d.ts

@@ -0,0 +1,4 @@
+export type { CapturedRequest, CapturedResponse, NetworkCaptureAdapter } from './types';
+export { createCDPNetworkAdapter, type CDPNetworkEventSource, type CDPNetworkOptions, } from './cdp';
+export { createWebRequestNetworkAdapter, type WebRequestEvent, type WebRequestEventSource, type WebRequestNetworkOptions, } from './web-request';
+//# sourceMappingURL=index.d.ts.map

package/dist/network/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/network/index.ts"],"names":[],"mappings":"AAYA,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AACxF,OAAO,EACL,uBAAuB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,GACvB,MAAM,OAAO,CAAC;AACf,OAAO,EACL,8BAA8B,EAC9B,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,GAC9B,MAAM,eAAe,CAAC"}

package/dist/network/index.js

@@ -0,0 +1,14 @@
+// Public barrel for the network capture module.
+//
+// Locked surface per IMPLEMENTATION_PLAN.md Public API contract
+// (lines 698-700):
+//
+//   export type { CapturedRequest, CapturedResponse, NetworkCaptureAdapter } from './network';
+//   export { createCDPNetworkAdapter, createWebRequestNetworkAdapter } from './network';
+//
+// The transport-shape types (`CDPNetworkEventSource`,
+// `WebRequestEventSource`) and option types are re-exported so consumers
+// can declare-and-pass without importing internal paths.
+export { createCDPNetworkAdapter, } from './cdp';
+export { createWebRequestNetworkAdapter, } from './web-request';
+//# sourceMappingURL=index.js.map

package/dist/network/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/network/index.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,EAAE;AACF,gEAAgE;AAChE,mBAAmB;AACnB,EAAE;AACF,+FAA+F;AAC/F,yFAAyF;AACzF,EAAE;AACF,sDAAsD;AACtD,yEAAyE;AACzE,yDAAyD;AAGzD,OAAO,EACL,uBAAuB,GAGxB,MAAM,OAAO,CAAC;AACf,OAAO,EACL,8BAA8B,GAI/B,MAAM,eAAe,CAAC"}

package/dist/network/types.d.ts

@@ -0,0 +1,133 @@
+/**
+ * A single in-flight (or about-to-be-sent) HTTP request, observed at the
+ * `requestWillBeSent`-equivalent moment of each transport.
+ *
+ * Emitted by `NetworkCaptureAdapter.onRequest`. Headers are already redacted
+ * via `redactNetworkHeaders`; `requestBody`, when present, is already passed
+ * through `redactBody` (type-tagged token replacement + 1 MB cap).
+ */
+export interface CapturedRequest {
+    /**
+     * Unique request id — the transport-native identifier (CDP `requestId`
+     * or chrome.webRequest `requestId`), reused verbatim so downstream
+     * consumers can correlate request/response without a substrate-side map.
+     */
+    id: string;
+    /** Wall-clock time (ms since epoch) when the request started. */
+    ts: number;
+    /** Fully-qualified request URL. */
+    url: string;
+    /** HTTP method — `'GET'`, `'POST'`, `'PUT'`, … */
+    method: string;
+    /**
+     * Request headers, already passed through `redactNetworkHeaders` (deny-list
+     * applied; non-sensitive names preserved with original casing).
+     */
+    headers: Record<string, string>;
+    /**
+     * Request body — already passed through `redactBody` (PII regex bank +
+     * 1 MB truncation cap). Present only when the transport exposes a textual
+     * body for the request; omitted otherwise (binary bodies, multipart, or
+     * any transport that can't surface the bytes).
+     */
+    requestBody?: string;
+    /**
+     * Initiator hint — typically `'script'`, `'parser'`, `'other'`, or a URL
+     * pointing at the script that scheduled the request. CDP populates this
+     * natively; the webRequest adapter leaves it undefined (no equivalent
+     * field).
+     */
+    initiator?: string;
+    /**
+     * Resource type, as reported by the transport. CDP vocabulary (e.g.
+     * `'Document'`, `'XHR'`, `'Fetch'`, `'Image'`) differs from
+     * chrome.webRequest's (e.g. `'main_frame'`, `'xmlhttprequest'`); we pass
+     * through verbatim so downstream tooling sees the original signal.
+     */
+    resourceType?: string;
+}
+/**
+ * The terminal observation of an HTTP exchange — either a successful response
+ * (`status` populated, `errorText` undefined) or a failure
+ * (`errorText` populated, `status` may be `0`). Bodies and headers are
+ * already redacted as for `CapturedRequest`.
+ */
+export interface CapturedResponse {
+    /** Matches the `id` of the corresponding `CapturedRequest`. */
+    id: string;
+    /** Wall-clock time (ms since epoch) when the response was observed. */
+    ts: number;
+    /** HTTP status code. `0` on network failure when no response was received. */
+    status: number;
+    /** HTTP status text (e.g. `'OK'`, `'Not Found'`). Optional — not all transports surface it. */
+    statusText?: string;
+    /** Response headers, already passed through `redactNetworkHeaders`. */
+    headers: Record<string, string>;
+    /**
+     * Response body, already passed through `redactBody`. Only populated by
+     * `createCDPNetworkAdapter` when `captureResponseBodies: true` AND the
+     * caller wired a `getResponseBody` fetcher (and the body is textual).
+     * Never populated by `createWebRequestNetworkAdapter` — chrome.webRequest
+     * cannot access response bodies in MV3.
+     */
+    responseBody?: string;
+    /** `true` when the response was served from the HTTP cache. */
+    fromCache: boolean;
+    /**
+     * Number of bytes on the wire (post-compression), when the transport
+     * reports it. CDP fills this from `Network.loadingFinished.encodedDataLength`;
+     * chrome.webRequest fills it from `onCompleted.responseSize`.
+     */
+    encodedSize?: number;
+    /** Elapsed time from request start to this observation, in ms, when known. */
+    durationMs?: number;
+    /**
+     * Populated when the transport reports a transport-layer error
+     * (CDP `Network.loadingFailed.errorText`, chrome.webRequest `onErrorOccurred.error`).
+     * Mutually exclusive with a normal response in practice — when present,
+     * the adapter emits this via `onResponse` rather than firing a separate
+     * `onError` event, so consumers get a single terminal record per exchange.
+     * (The optional `onError` channel is offered for products that want a
+     * second signal; it carries the same id/ts/errorText.)
+     */
+    errorText?: string;
+}
+/**
+ * Common surface for network capture. Both factories
+ * (`createCDPNetworkAdapter`, `createWebRequestNetworkAdapter`) return this
+ * shape; the only intended difference is which transport drives the
+ * underlying subscription.
+ *
+ * Handler registration is additive: each `on*` call returns an unsubscribe
+ * function specific to that handler. `dispose()` is a single shot — it
+ * tears down ALL transport subscriptions for the adapter.
+ */
+export interface NetworkCaptureAdapter {
+    /**
+     * Subscribe to `CapturedRequest` emissions. The returned function removes
+     * THIS handler without affecting other registered handlers.
+     */
+    onRequest(handler: (req: CapturedRequest) => void): () => void;
+    /**
+     * Subscribe to `CapturedResponse` emissions. Same unsubscribe semantics
+     * as `onRequest`.
+     */
+    onResponse(handler: (res: CapturedResponse) => void): () => void;
+    /**
+     * Optional dedicated channel for transport-layer errors. Adapters that
+     * surface errors only via `CapturedResponse.errorText` may leave this
+     * undefined; adapters that fire a parallel error stream populate it.
+     */
+    onError?(handler: (err: {
+        id: string;
+        ts: number;
+        errorText: string;
+    }) => void): () => void;
+    /**
+     * Tear down all underlying transport subscriptions. Idempotent. Returning
+     * a promise so future adapters that flush async resources can do so
+     * cleanly under the same contract.
+     */
+    dispose?(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/network/types.ts"],"names":[],"mappings":"AAkCA;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,EAAE,EAAE,MAAM,CAAC;IACX,iEAAiE;IACjE,EAAE,EAAE,MAAM,CAAC;IACX,mCAAmC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+DAA+D;IAC/D,EAAE,EAAE,MAAM,CAAC;IACX,uEAAuE;IACvE,EAAE,EAAE,MAAM,CAAC;IACX,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAC;IACf,+FAA+F;IAC/F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,SAAS,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC/D;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACjE;;;;OAIG;IACH,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC5F;;;;OAIG;IACH,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B"}

package/dist/network/types.js

@@ -0,0 +1,35 @@
+// Network capture abstraction — Task 1.7.
+//
+// ADR-0002: both products consume the same downstream API, only the
+// transport differs. P1/tracelane subscribes to CDP `Network.*` via a
+// WebDriver-supplied CDP session; P2/peek subscribes to
+// `chrome.webRequest.*` from the extension service worker.
+//
+// The shapes below are the contract — `createCDPNetworkAdapter` and
+// `createWebRequestNetworkAdapter` MUST produce structurally identical
+// `CapturedRequest`/`CapturedResponse` records (a cross-adapter equality
+// test in `network.test.ts` is the regression guard). Field availability
+// differs only in the well-documented cases:
+//
+//   - `requestBody`     — both transports can populate when present.
+//   - `responseBody`    — CDP only (chrome.webRequest can't access bodies
+//                         in MV3); CDP also requires opt-in via
+//                         `CDPNetworkOptions.captureResponseBodies`.
+//   - `initiator`       — CDP exposes it natively; chrome.webRequest does
+//                         not (left undefined on the webRequest path).
+//   - `resourceType`    — both transports expose this, but the vocabulary
+//                         is transport-native (CDP: `Document`, `XHR`,
+//                         `Fetch`, …; chrome.webRequest: `main_frame`,
+//                         `xmlhttprequest`, …). We pass through verbatim
+//                         and document the difference — re-mapping would
+//                         throw away signal.
+//   - `encodedSize`     — both transports populate when available (CDP
+//                         via `Network.loadingFinished.encodedDataLength`;
+//                         chrome.webRequest via the `responseSize` field
+//                         on `onCompleted`).
+//
+// All sensitive material (headers + bodies) is redacted INSIDE the adapter
+// before reaching the consumer's handler — see
+// `redactNetworkHeaders`/`redactBody` from the masking module.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/network/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/network/types.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,EAAE;AACF,oEAAoE;AACpE,sEAAsE;AACtE,wDAAwD;AACxD,2DAA2D;AAC3D,EAAE;AACF,oEAAoE;AACpE,uEAAuE;AACvE,yEAAyE;AACzE,yEAAyE;AACzE,6CAA6C;AAC7C,EAAE;AACF,qEAAqE;AACrE,0EAA0E;AAC1E,gEAAgE;AAChE,qEAAqE;AACrE,0EAA0E;AAC1E,uEAAuE;AACvE,0EAA0E;AAC1E,uEAAuE;AACvE,uEAAuE;AACvE,yEAAyE;AACzE,yEAAyE;AACzE,6CAA6C;AAC7C,uEAAuE;AACvE,2EAA2E;AAC3E,yEAAyE;AACzE,6CAA6C;AAC7C,EAAE;AACF,2EAA2E;AAC3E,+CAA+C;AAC/C,+DAA+D"}

package/dist/network/web-request.d.ts

@@ -0,0 +1,76 @@
+import type { NetworkCaptureAdapter } from './types';
+/**
+ * The chrome.webRequest event family we depend on, narrowed to just the
+ * `.addListener` / `.removeListener` shape. Each listener payload is
+ * `any` at the wire level — the Chrome API documents the shapes per-event,
+ * and the type-narrowing happens inside the adapter via small runtime
+ * checks (`readString` / `readNumber` / `readHeaders`).
+ *
+ * We accept this shape (rather than `chrome.webRequest` directly) so the
+ * substrate (a) typechecks outside an extension context, (b) is trivially
+ * testable with hand-built fakes, and (c) gives the product the option of
+ * wrapping the API with telemetry / permission checks.
+ */
+export interface WebRequestEvent {
+    addListener(cb: (d: any) => void, filter?: unknown, extraInfoSpec?: string[]): void;
+    removeListener(cb: (d: any) => void): void;
+}
+/**
+ * Aggregate of the five chrome.webRequest events we subscribe to.
+ *
+ * The product-side wrapper typically exposes `chrome.webRequest` directly
+ * (it already matches this shape), but tests inject hand-built fakes.
+ */
+export interface WebRequestEventSource {
+    onBeforeRequest: WebRequestEvent;
+    onSendHeaders: WebRequestEvent;
+    onHeadersReceived: WebRequestEvent;
+    onCompleted: WebRequestEvent;
+    onErrorOccurred: WebRequestEvent;
+}
+/**
+ * Factory-time options for `createWebRequestNetworkAdapter`.
+ */
+export interface WebRequestNetworkOptions {
+    /**
+     * chrome.webRequest URL/types filter, forwarded verbatim to each
+     * `.addListener` call. Defaults to `{ urls: ['<all_urls>'] }` so the
+     * adapter sees everything; products typically narrow this to reduce
+     * load.
+     */
+    filter?: {
+        urls: string[];
+        types?: string[];
+    };
+    /**
+     * Body cap forwarded to `redactBody` for the (rare) cases where
+     * `onBeforeRequest` exposes a textual request body. Defaults to 1 MB.
+     */
+    maxBodyBytes?: number;
+    /**
+     * `extraInfoSpec` passed to `onSendHeaders.addListener` /
+     * `onHeadersReceived.addListener`. chrome.webRequest requires
+     * `['responseHeaders']` to surface response headers and
+     * `['requestHeaders']` for the final request-header set. The adapter
+     * sets sensible defaults; callers can override (for example, to add
+     * `'extraHeaders'` when capturing CORS-restricted headers).
+     */
+    extraInfoSpec?: {
+        onBeforeRequest?: string[];
+        onSendHeaders?: string[];
+        onHeadersReceived?: string[];
+    };
+}
+/**
+ * Build a `NetworkCaptureAdapter` that consumes chrome.webRequest events.
+ *
+ * The adapter installs five listeners on `source`, all gated by
+ * `options.filter` (defaulting to `{ urls: ['<all_urls>'] }`). On
+ * `dispose()` every listener is removed and the in-flight map is cleared.
+ *
+ * @param source A `WebRequestEventSource` — typically the global
+ *               `chrome.webRequest` itself.
+ * @param options `{ filter?, maxBodyBytes?, extraInfoSpec? }`.
+ */
+export declare function createWebRequestNetworkAdapter(source: WebRequestEventSource, options?: WebRequestNetworkOptions): NetworkCaptureAdapter;
+//# sourceMappingURL=web-request.d.ts.map

package/dist/network/web-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-request.d.ts","sourceRoot":"","sources":["../../src/network/web-request.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAqC,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAExF;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,eAAe;IAE9B,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,IAAI,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAEpF,cAAc,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI,CAAC;CAC5C;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,eAAe,EAAE,eAAe,CAAC;IACjC,aAAa,EAAE,eAAe,CAAC;IAC/B,iBAAiB,EAAE,eAAe,CAAC;IACnC,WAAW,EAAE,eAAe,CAAC;IAC7B,eAAe,EAAE,eAAe,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;;OAKG;IACH,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC9C;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE;QACd,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QACzB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;KAC9B,CAAC;CACH;AA0ED;;;;;;;;;;GAUG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,qBAAqB,EAC7B,OAAO,GAAE,wBAA6B,GACrC,qBAAqB,CAyMvB"}