import { describe, expect, it } from "vitest"; import { CdpCaptureEvents } from "../../../src/browser/CdpCaptureEvents.js"; import { CdpTargetDocument } from "../../../src/browser/CdpTargetDocument.js"; import { inspectWebPageInputSchema } from "../../../src/domain/browserObservation.js"; import { CDP_CAPTURE_SCRIPT_METADATA_LIMITS } from "../../../src/browser/CdpCaptureEventTypes.js"; import { receiveCdpEvent } from "../../../src/browser/CdpConnection.js"; describe("CDP script metadata admission", () => { const origin = "https://app.example"; const emit = ( events: CdpCaptureEvents, scriptId: string, sourceMapURL?: unknown, ) => events.ingest( receiveCdpEvent({ method: "Debugger.scriptParsed", params: { scriptId, url: `${origin}/app.js`, sourceMapURL }, }), ); const mapPath = (size: number) => `/maps/${"x".repeat(size)}.map`; const mebibyte = 1024 * 1024; const resourceExclusions = (events: CdpCaptureEvents) => events.completeness .snapshot() .excluded.filter(({ reason }) => reason === "resource_budget_exhausted"); it("retains an invalid source-map declaration as unknown", () => { const events = captureEvents(); events.beginAuthorizedFrame(new CdpTargetDocument({ frameId: "frame-1" })); for (const [scriptId, sourceMapURL] of [ ["bad", null], ["absent", undefined], ["empty", ""], ] as const) { emit(events, scriptId, sourceMapURL); expect(events.scripts.get(scriptId)?.sourceMapUrl).toBeNull(); } expect(events.completeness.snapshot().excluded).toContainEqual({ section: "source_maps", reason: "invalid_protocol_value", count: 1, }); }); it("reclaims replaced map bytes and starts each document with a fresh budget", () => { const events = captureEvents(); events.beginAuthorizedFrame(new CdpTargetDocument({ frameId: "frame-1" })); const expectMap = (id: string, payloadBytes: number) => { const url = events.scripts.get(id)?.sourceMapUrl; expect(url?.length).toBe(`${origin}/maps/.map`.length + payloadBytes); expect(url?.endsWith(".map")).toBe(true); }; emit(events, "same-id", mapPath(3 * mebibyte)); emit(events, "same-id", mapPath(2 * mebibyte)); emit(events, "next-id", mapPath(mebibyte)); expectMap("same-id", 2 * mebibyte); expectMap("next-id", mebibyte); expect(events.retainedScriptMetadataBytes).toBeLessThanOrEqual( CDP_CAPTURE_SCRIPT_METADATA_LIMITS.retainedBytes, ); emit(events, "normalized-url", `${"./".repeat(1_200_000)}map.js.map`); expect(events.scripts.get("normalized-url")?.sourceMapUrl).toBe( `${origin}/map.js.map`, ); events.beginAuthorizedFrame(new CdpTargetDocument({ frameId: "frame-2" })); emit(events, "new-document", mapPath(5 * mebibyte)); expect(events.scripts.get("new-document")?.sourceMapUrl).toBeNull(); emit(events, "new-document", mapPath(mebibyte)); expectMap("new-document", mebibyte); events.recordScriptMetadataBudgetExclusions(); expect(resourceExclusions(events)).toEqual([]); events.beginAuthorizedFrame(new CdpTargetDocument({ frameId: "frame-3" })); emit(events, "new-document", mapPath(3 * mebibyte)); expectMap("new-document", 3 * mebibyte); emit(events, "map-overflow", mapPath(2 * mebibyte)); expect(events.scripts.get("map-overflow")?.sourceMapUrl).toBeNull(); events.recordScriptMetadataBudgetExclusions(); expect(resourceExclusions(events)).toEqual([ { section: "source_maps", reason: "resource_budget_exhausted", count: 1 }, ]); }); it("rejects oversized metadata and excess records at independent boundaries", () => { const events = captureEvents(); events.beginAuthorizedFrame(new CdpTargetDocument({ frameId: "frame-1" })); const { retainedBytes, scripts } = CDP_CAPTURE_SCRIPT_METADATA_LIMITS; const oversized = "x".repeat(retainedBytes + 1); emit(events, oversized); expect(events.scripts.has(oversized)).toBe(false); for (let index = 0; index < scripts; index += 1) emit(events, `script-${String(index)}`); expect(events.scripts.size).toBe(scripts); expect(events.scripts.has(`script-${String(scripts - 1)}`)).toBe(true); expect(events.retainedScriptMetadataBytes).toBeLessThan(retainedBytes); emit(events, "record-overflow", "/maps/overflow.map"); expect(events.scripts.has("record-overflow")).toBe(false); expect(events.scriptMetadataBudgetOmissionsById.size).toBe(0); events.recordScriptMetadataBudgetExclusions(); expect(resourceExclusions(events)).toEqual([ { section: "scripts", reason: "resource_budget_exhausted", count: 2 }, { section: "source_maps", reason: "resource_budget_exhausted", count: 1 }, ]); }); }); const captureEvents = (): CdpCaptureEvents => new CdpCaptureEvents( inspectWebPageInputSchema.parse({ cdp_endpoint: "http://127.0.0.1:9222", allowed_origins: ["https://app.example"], target_id: "page", observation_ms: 0, }), new Set(["https://app.example"]), ); it.each([ { name: "absent auxiliary data", auxiliary: undefined, frame: "frame-1", invalid: false, }, { name: "conflicting frame", auxiliary: { frameId: "other-frame" }, frame: null, invalid: true, }, { name: "empty frame", auxiliary: { frameId: "" }, frame: null, invalid: true, }, { name: "null frame", auxiliary: { frameId: null }, frame: null, invalid: true, }, { name: "numeric frame", auxiliary: { frameId: 7 }, frame: null, invalid: true, }, { name: "malformed auxiliary data", auxiliary: null, frame: null, invalid: true, }, ])( "keeps script ownership uncertain for $name", ({ auxiliary, frame, invalid }) => { const events = captureEvents(); events.beginAuthorizedFrame(new CdpTargetDocument({ frameId: "frame-1" })); events.ingest( receiveCdpEvent({ method: "Runtime.executionContextCreated", params: { context: { id: 7, auxData: { frameId: "frame-1" } } }, }), ); events.ingest( receiveCdpEvent({ method: "Debugger.scriptParsed", params: { scriptId: "script", url: "https://app.example/app.js", executionContextId: 7, ...(auxiliary === undefined ? {} : { executionContextAuxData: auxiliary }), }, }), ); const script = events.scripts.get("script"); if (script === undefined) throw new Error("Expected retained script metadata"); expect(script.frameId).toBe(frame); expect(events.frameForScript(script, new Set(["frame-1"]))).toBe(frame); expect( events.completeness .snapshot() .excluded.filter(({ section }) => section === "scripts"), ).toEqual( invalid ? [{ section: "scripts", reason: "invalid_protocol_value", count: 1 }] : [], ); }, ); it("rejects an empty script ID before retaining its metadata", () => { const events = captureEvents(); events.beginAuthorizedFrame(new CdpTargetDocument({ frameId: "frame-1" })); events.ingest( receiveCdpEvent({ method: "Debugger.scriptParsed", params: { scriptId: "", url: "https://app.example/app.js" }, }), ); expect(events.scripts.size).toBe(0); expect(events.retainedScriptMetadataBytes).toBe(0); expect(events.completeness.snapshot().excluded).toContainEqual({ section: "scripts", reason: "invalid_protocol_value", count: 1, }); });