@cubenest/rrweb-core 0.1.0-alpha.0

package/dist/network/web-request.js

@@ -0,0 +1,294 @@
+// chrome.webRequest network adapter — Task 1.7.
+//
+// Subscribes to the chrome.webRequest event family from the extension
+// service worker. P2/peek owns the listener; we accept the event source as
+// a parameter rather than reading `chrome.webRequest` off a global so the
+// substrate stays environment-agnostic.
+//
+// chrome.webRequest reports an HTTP exchange across multiple events:
+//
+//   - onBeforeRequest      — request URL + method + body (limited)
+//   - onSendHeaders        — final request headers (after browser merging)
+//   - onHeadersReceived    — response headers, status
+//   - onCompleted          — terminal success: cache hint + size + final ts
+//   - onErrorOccurred      — terminal failure: error string
+//
+// We correlate by `requestId` (chrome.webRequest's own monotonic id, scoped
+// to a profile). Bodies are NOT accessible via chrome.webRequest in MV3 —
+// the `requestBody` field is only populated by `onBeforeRequest` and only
+// for form-encoded payloads, but our adapter doesn't depend on it: we
+// surface what the transport gives us, and `responseBody` is always
+// undefined here.
+import { redactBody, redactNetworkHeaders } from '../masking';
+// ────────────────────────────────────────────────────────────────────────────
+// chrome.webRequest payload narrowing
+// ────────────────────────────────────────────────────────────────────────────
+function readNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+function readString(value) {
+    return typeof value === 'string' ? value : undefined;
+}
+/**
+ * chrome.webRequest serializes headers as `{ name, value }[]` (preserving
+ * insertion order). We collapse to a plain record — the masking module
+ * already handles case-insensitive matching, so the lossy collapse is
+ * cheap and matches the CDP path's shape.
+ */
+function readHeaderArray(value) {
+    if (!Array.isArray(value))
+        return {};
+    const out = {};
+    for (const item of value) {
+        if (item === null || typeof item !== 'object')
+            continue;
+        const entry = item;
+        const name = readString(entry.name);
+        if (name === undefined)
+            continue;
+        // chrome.webRequest may expose `binaryValue` for non-UTF-8 headers; we
+        // ignore those (they're rare in practice — bodies/cookies aside).
+        const headerValue = readString(entry.value);
+        if (headerValue !== undefined)
+            out[name] = headerValue;
+    }
+    return out;
+}
+/**
+ * chrome.webRequest's `requestBody` field shape on `onBeforeRequest`:
+ *   { formData?: Record<string, string[]>, raw?: { bytes: ArrayBuffer }[] }
+ *
+ * `formData` is the only field that's safely textual. We serialize it to a
+ * stable querystring-like representation so the redactor has something to
+ * scan; `raw` is left alone (binary).
+ */
+function readRequestBody(value) {
+    if (value === null || typeof value !== 'object')
+        return undefined;
+    const formData = value.formData;
+    if (formData === null || typeof formData !== 'object')
+        return undefined;
+    const parts = [];
+    for (const [key, values] of Object.entries(formData)) {
+        if (!Array.isArray(values))
+            continue;
+        for (const v of values) {
+            if (typeof v === 'string')
+                parts.push(`${key}=${v}`);
+        }
+    }
+    return parts.length > 0 ? parts.join('&') : undefined;
+}
+/**
+ * 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 function createWebRequestNetworkAdapter(source, options = {}) {
+    const filter = options.filter ?? { urls: ['<all_urls>'] };
+    const maxBodyBytes = options.maxBodyBytes ?? 1024 * 1024;
+    const extraInfo = options.extraInfoSpec ?? {};
+    const onBeforeRequestExtra = extraInfo.onBeforeRequest ?? ['requestBody'];
+    const onSendHeadersExtra = extraInfo.onSendHeaders ?? ['requestHeaders'];
+    const onHeadersReceivedExtra = extraInfo.onHeadersReceived ?? ['responseHeaders'];
+    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);
+    };
+    // ──────────────────────────────────────────────────────────────────────
+    // onBeforeRequest — emit CapturedRequest with whatever we know now.
+    //
+    // chrome.webRequest's `timeStamp` is already in ms epoch.
+    // ──────────────────────────────────────────────────────────────────────
+    // biome-ignore lint/suspicious/noExplicitAny: webRequest's per-event payload is documented separately.
+    const beforeRequestListener = (details) => {
+        if (details === null || typeof details !== 'object')
+            return;
+        const requestId = readString(details.requestId);
+        if (requestId === undefined)
+            return;
+        const startTs = readNumber(details.timeStamp) ?? Date.now();
+        const requestBodyRaw = readRequestBody(details.requestBody);
+        const requestBody = requestBodyRaw !== undefined
+            ? redactBody(requestBodyRaw, { maxLengthBytes: maxBodyBytes })
+            : undefined;
+        const captured = {
+            id: requestId,
+            ts: startTs,
+            url: readString(details.url) ?? '',
+            method: readString(details.method) ?? 'GET',
+            // onBeforeRequest doesn't carry headers — they arrive on onSendHeaders.
+            // We start with an empty record; onSendHeaders upgrades the entry.
+            headers: {},
+            ...(requestBody !== undefined ? { requestBody } : {}),
+            ...(readString(details.type) !== undefined
+                ? { resourceType: readString(details.type) }
+                : {}),
+        };
+        inFlight.set(requestId, {
+            startTs,
+            request: captured,
+            headersUpgraded: false,
+        });
+        emitRequest(captured);
+    };
+    source.onBeforeRequest.addListener(beforeRequestListener, filter, onBeforeRequestExtra);
+    // ──────────────────────────────────────────────────────────────────────
+    // onSendHeaders — final request headers. We mutate the in-flight record
+    // so a later request-emission won't lose them; we DO NOT re-emit the
+    // request (consumers expect one onRequest event per exchange).
+    // ──────────────────────────────────────────────────────────────────────
+    // biome-ignore lint/suspicious/noExplicitAny: webRequest's per-event payload is documented separately.
+    const sendHeadersListener = (details) => {
+        if (details === null || typeof details !== 'object')
+            return;
+        const requestId = readString(details.requestId);
+        if (requestId === undefined)
+            return;
+        const entry = inFlight.get(requestId);
+        if (entry === undefined)
+            return;
+        const headers = redactNetworkHeaders(readHeaderArray(details.requestHeaders));
+        entry.request = { ...entry.request, headers };
+        entry.headersUpgraded = true;
+    };
+    source.onSendHeaders.addListener(sendHeadersListener, filter, onSendHeadersExtra);
+    // ──────────────────────────────────────────────────────────────────────
+    // onHeadersReceived — record response status + headers; defer emission
+    // until onCompleted (matches the CDP path, which also defers).
+    // ──────────────────────────────────────────────────────────────────────
+    // biome-ignore lint/suspicious/noExplicitAny: webRequest's per-event payload is documented separately.
+    const headersReceivedListener = (details) => {
+        if (details === null || typeof details !== 'object')
+            return;
+        const requestId = readString(details.requestId);
+        if (requestId === undefined)
+            return;
+        const entry = inFlight.get(requestId);
+        if (entry === undefined)
+            return;
+        const headers = redactNetworkHeaders(readHeaderArray(details.responseHeaders));
+        entry.pendingResponse = {
+            status: readNumber(details.statusCode) ?? 0,
+            ...(readString(details.statusLine) !== undefined
+                ? { statusText: readString(details.statusLine) }
+                : {}),
+            headers,
+        };
+    };
+    source.onHeadersReceived.addListener(headersReceivedListener, filter, onHeadersReceivedExtra);
+    // ──────────────────────────────────────────────────────────────────────
+    // onCompleted — terminal success. Emit CapturedResponse.
+    // ──────────────────────────────────────────────────────────────────────
+    // biome-ignore lint/suspicious/noExplicitAny: webRequest's per-event payload is documented separately.
+    const completedListener = (details) => {
+        if (details === null || typeof details !== 'object')
+            return;
+        const requestId = readString(details.requestId);
+        if (requestId === undefined)
+            return;
+        const entry = inFlight.get(requestId);
+        if (entry === undefined)
+            return;
+        const ts = readNumber(details.timeStamp) ?? Date.now();
+        const durationMs = Math.max(0, ts - entry.startTs);
+        const encodedSize = readNumber(details.responseSize);
+        const fromCache = details.fromCache === true;
+        const pending = entry.pendingResponse ?? {
+            status: readNumber(details.statusCode) ?? 0,
+            headers: {},
+        };
+        const captured = {
+            id: requestId,
+            ts,
+            status: pending.status,
+            ...(pending.statusText !== undefined ? { statusText: pending.statusText } : {}),
+            headers: pending.headers,
+            fromCache,
+            ...(encodedSize !== undefined ? { encodedSize } : {}),
+            durationMs,
+        };
+        inFlight.delete(requestId);
+        emitResponse(captured);
+    };
+    source.onCompleted.addListener(completedListener, filter);
+    // ──────────────────────────────────────────────────────────────────────
+    // onErrorOccurred — terminal failure. Emit CapturedResponse with
+    // errorText AND a parallel onError event.
+    // ──────────────────────────────────────────────────────────────────────
+    // biome-ignore lint/suspicious/noExplicitAny: webRequest's per-event payload is documented separately.
+    const errorOccurredListener = (details) => {
+        if (details === null || typeof details !== 'object')
+            return;
+        const requestId = readString(details.requestId);
+        if (requestId === undefined)
+            return;
+        const entry = inFlight.get(requestId);
+        const ts = readNumber(details.timeStamp) ?? Date.now();
+        const errorText = readString(details.error) ?? 'unknown';
+        const durationMs = entry !== undefined ? Math.max(0, ts - entry.startTs) : undefined;
+        const fromCache = details.fromCache === true;
+        const pending = entry?.pendingResponse ?? { status: 0, headers: {} };
+        const captured = {
+            id: requestId,
+            ts,
+            status: pending.status,
+            ...(pending.statusText !== undefined ? { statusText: pending.statusText } : {}),
+            headers: pending.headers,
+            fromCache,
+            ...(durationMs !== undefined ? { durationMs } : {}),
+            errorText,
+        };
+        inFlight.delete(requestId);
+        emitResponse(captured);
+        emitError({ id: requestId, ts, errorText });
+    };
+    source.onErrorOccurred.addListener(errorOccurredListener, filter);
+    // ──────────────────────────────────────────────────────────────────────
+    // 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() {
+            source.onBeforeRequest.removeListener(beforeRequestListener);
+            source.onSendHeaders.removeListener(sendHeadersListener);
+            source.onHeadersReceived.removeListener(headersReceivedListener);
+            source.onCompleted.removeListener(completedListener);
+            source.onErrorOccurred.removeListener(errorOccurredListener);
+            requestHandlers.clear();
+            responseHandlers.clear();
+            errorHandlers.clear();
+            inFlight.clear();
+        },
+    };
+}
+//# sourceMappingURL=web-request.js.map

package/dist/network/web-request.js.map

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

package/dist/persistence/index.d.ts

@@ -0,0 +1,3 @@
+export { createSessionStore } from './store';
+export type { SessionChunk, SessionStore, SessionStoreOptions } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/persistence/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC"}

package/dist/persistence/index.js

@@ -0,0 +1,11 @@
+// Public barrel for the IndexedDB persistence module.
+//
+// Locked surface per IMPLEMENTATION_PLAN.md Public API contract (line 726):
+//
+//   export { createSessionStore, type SessionChunk } from './persistence';
+//
+// The factory + companion `SessionStore` / `SessionStoreOptions` types
+// are re-exported so consumers can declare-and-pass without reaching
+// into `./store` directly.
+export { createSessionStore } from './store';
+//# sourceMappingURL=index.js.map

package/dist/persistence/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/persistence/index.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,EAAE;AACF,4EAA4E;AAC5E,EAAE;AACF,2EAA2E;AAC3E,EAAE;AACF,uEAAuE;AACvE,qEAAqE;AACrE,2BAA2B;AAE3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC"}

package/dist/persistence/store.d.ts

@@ -0,0 +1,18 @@
+import type { SessionStore, SessionStoreOptions } from './types';
+/**
+ * Open an IDB-backed chunk store for a session.
+ *
+ * The returned `SessionStore` is scoped to `sessionId`; all read/write
+ * operations are filtered by it. Multiple stores for different sessions
+ * can be opened concurrently — they share the same DB connection's
+ * keyspace but are isolated by the composite key.
+ *
+ * @param sessionId  non-empty session identifier; used as the first
+ *                   component of every chunk's composite key
+ * @param options    optional overrides (dbName, storeName, IDBFactory)
+ * @throws {Error} if `sessionId` is empty / non-string, or if no
+ *                 `IDBFactory` is available (`globalThis.indexedDB`
+ *                 undefined and `options.indexedDB` not provided)
+ */
+export declare function createSessionStore(sessionId: string, options?: SessionStoreOptions): Promise<SessionStore>;
+//# sourceMappingURL=store.d.ts.map

package/dist/persistence/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/persistence/store.ts"],"names":[],"mappings":"AAsCA,OAAO,KAAK,EAAgB,YAAY,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAkG/E;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,YAAY,CAAC,CAwNvB"}