dev3000 0.0.189 → 0.0.192

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (183) hide show
  1. package/README.md +101 -12
  2. package/dist/cdp-monitor.d.ts +10 -0
  3. package/dist/cdp-monitor.d.ts.map +1 -1
  4. package/dist/cdp-monitor.js +28 -4
  5. package/dist/cdp-monitor.js.map +1 -1
  6. package/dist/runtime/bridge.d.ts +2 -0
  7. package/dist/runtime/bridge.d.ts.map +1 -1
  8. package/dist/runtime/bridge.js +74 -0
  9. package/dist/runtime/bridge.js.map +1 -1
  10. package/dist/runtime/browser-capture.d.ts +117 -0
  11. package/dist/runtime/browser-capture.d.ts.map +1 -0
  12. package/dist/runtime/browser-capture.js +274 -0
  13. package/dist/runtime/browser-capture.js.map +1 -0
  14. package/dist/runtime/browser-compare.d.ts +91 -0
  15. package/dist/runtime/browser-compare.d.ts.map +1 -0
  16. package/dist/runtime/browser-compare.js +129 -0
  17. package/dist/runtime/browser-compare.js.map +1 -0
  18. package/dist/runtime/browser-events.d.ts +3 -2
  19. package/dist/runtime/browser-events.d.ts.map +1 -1
  20. package/dist/runtime/browser-events.js +11 -53
  21. package/dist/runtime/browser-events.js.map +1 -1
  22. package/dist/runtime/browser-metrics.d.ts +148 -0
  23. package/dist/runtime/browser-metrics.d.ts.map +1 -0
  24. package/dist/runtime/browser-metrics.js +243 -0
  25. package/dist/runtime/browser-metrics.js.map +1 -0
  26. package/dist/runtime/chrome-isolation.d.ts +4 -2
  27. package/dist/runtime/chrome-isolation.d.ts.map +1 -1
  28. package/dist/runtime/chrome-isolation.js +24 -35
  29. package/dist/runtime/chrome-isolation.js.map +1 -1
  30. package/dist/runtime/cli.js +67 -2
  31. package/dist/runtime/cli.js.map +1 -1
  32. package/dist/runtime/desktop-mcp.d.ts +216 -0
  33. package/dist/runtime/desktop-mcp.d.ts.map +1 -0
  34. package/dist/runtime/desktop-mcp.js +258 -0
  35. package/dist/runtime/desktop-mcp.js.map +1 -0
  36. package/dist/runtime/git-identity.d.ts +17 -0
  37. package/dist/runtime/git-identity.d.ts.map +1 -0
  38. package/dist/runtime/git-identity.js +41 -0
  39. package/dist/runtime/git-identity.js.map +1 -0
  40. package/dist/runtime/github-publish.d.ts +31 -0
  41. package/dist/runtime/github-publish.d.ts.map +1 -0
  42. package/dist/runtime/github-publish.js +237 -0
  43. package/dist/runtime/github-publish.js.map +1 -0
  44. package/dist/runtime/harness.d.ts +14 -3
  45. package/dist/runtime/harness.d.ts.map +1 -1
  46. package/dist/runtime/harness.js +55 -7
  47. package/dist/runtime/harness.js.map +1 -1
  48. package/dist/runtime/managed-cdp.d.ts +10 -0
  49. package/dist/runtime/managed-cdp.d.ts.map +1 -0
  50. package/dist/runtime/managed-cdp.js +80 -0
  51. package/dist/runtime/managed-cdp.js.map +1 -0
  52. package/dist/runtime/mcp-stdio.d.ts +17 -0
  53. package/dist/runtime/mcp-stdio.d.ts.map +1 -0
  54. package/dist/runtime/mcp-stdio.js +99 -0
  55. package/dist/runtime/mcp-stdio.js.map +1 -0
  56. package/dist/runtime/network-evidence.d.ts +28 -0
  57. package/dist/runtime/network-evidence.d.ts.map +1 -0
  58. package/dist/runtime/network-evidence.js +291 -0
  59. package/dist/runtime/network-evidence.js.map +1 -0
  60. package/dist/runtime/package-manager.d.ts +13 -0
  61. package/dist/runtime/package-manager.d.ts.map +1 -0
  62. package/dist/runtime/package-manager.js +69 -0
  63. package/dist/runtime/package-manager.js.map +1 -0
  64. package/dist/runtime/runtime.d.ts +7 -0
  65. package/dist/runtime/runtime.d.ts.map +1 -1
  66. package/dist/runtime/runtime.js +54 -30
  67. package/dist/runtime/runtime.js.map +1 -1
  68. package/dist/runtime/sandbox-agent.d.ts +5 -0
  69. package/dist/runtime/sandbox-agent.d.ts.map +1 -1
  70. package/dist/runtime/sandbox-agent.js +32 -0
  71. package/dist/runtime/sandbox-agent.js.map +1 -1
  72. package/dist/runtime/sandbox-cleanup.d.ts +14 -0
  73. package/dist/runtime/sandbox-cleanup.d.ts.map +1 -0
  74. package/dist/runtime/sandbox-cleanup.js +77 -0
  75. package/dist/runtime/sandbox-cleanup.js.map +1 -0
  76. package/dist/runtime/sandbox-command.d.ts +1 -0
  77. package/dist/runtime/sandbox-command.d.ts.map +1 -1
  78. package/dist/runtime/sandbox-command.js +39 -9
  79. package/dist/runtime/sandbox-command.js.map +1 -1
  80. package/dist/runtime/sandbox-context.d.ts +5 -0
  81. package/dist/runtime/sandbox-context.d.ts.map +1 -0
  82. package/dist/runtime/sandbox-context.js +42 -0
  83. package/dist/runtime/sandbox-context.js.map +1 -0
  84. package/dist/runtime/sandbox-fx-resume.d.ts +11 -0
  85. package/dist/runtime/sandbox-fx-resume.d.ts.map +1 -0
  86. package/dist/runtime/sandbox-fx-resume.js +45 -0
  87. package/dist/runtime/sandbox-fx-resume.js.map +1 -0
  88. package/dist/runtime/sandbox-gateway.d.ts +17 -0
  89. package/dist/runtime/sandbox-gateway.d.ts.map +1 -0
  90. package/dist/runtime/sandbox-gateway.js +34 -0
  91. package/dist/runtime/sandbox-gateway.js.map +1 -0
  92. package/dist/runtime/sandbox-git.d.ts +19 -0
  93. package/dist/runtime/sandbox-git.d.ts.map +1 -0
  94. package/dist/runtime/sandbox-git.js +42 -0
  95. package/dist/runtime/sandbox-git.js.map +1 -0
  96. package/dist/runtime/sandbox-github.d.ts +10 -0
  97. package/dist/runtime/sandbox-github.d.ts.map +1 -0
  98. package/dist/runtime/sandbox-github.js +35 -0
  99. package/dist/runtime/sandbox-github.js.map +1 -0
  100. package/dist/runtime/sandbox-local-harness.d.ts +34 -0
  101. package/dist/runtime/sandbox-local-harness.d.ts.map +1 -0
  102. package/dist/runtime/sandbox-local-harness.js +151 -0
  103. package/dist/runtime/sandbox-local-harness.js.map +1 -0
  104. package/dist/runtime/sandbox-ports.d.ts +6 -0
  105. package/dist/runtime/sandbox-ports.d.ts.map +1 -0
  106. package/dist/runtime/sandbox-ports.js +11 -0
  107. package/dist/runtime/sandbox-ports.js.map +1 -0
  108. package/dist/runtime/sandbox-preview.d.ts +14 -0
  109. package/dist/runtime/sandbox-preview.d.ts.map +1 -0
  110. package/dist/runtime/sandbox-preview.js +96 -0
  111. package/dist/runtime/sandbox-preview.js.map +1 -0
  112. package/dist/runtime/sandbox-process.d.ts +11 -0
  113. package/dist/runtime/sandbox-process.d.ts.map +1 -0
  114. package/dist/runtime/sandbox-process.js +77 -0
  115. package/dist/runtime/sandbox-process.js.map +1 -0
  116. package/dist/runtime/sandbox-proxy.d.ts +2 -0
  117. package/dist/runtime/sandbox-proxy.d.ts.map +1 -1
  118. package/dist/runtime/sandbox-proxy.js +75 -20
  119. package/dist/runtime/sandbox-proxy.js.map +1 -1
  120. package/dist/runtime/sandbox-recovery.d.ts +4 -0
  121. package/dist/runtime/sandbox-recovery.d.ts.map +1 -0
  122. package/dist/runtime/sandbox-recovery.js +36 -0
  123. package/dist/runtime/sandbox-recovery.js.map +1 -0
  124. package/dist/runtime/sandbox-sessions.d.ts +8 -1
  125. package/dist/runtime/sandbox-sessions.d.ts.map +1 -1
  126. package/dist/runtime/sandbox-sessions.js +20 -2
  127. package/dist/runtime/sandbox-sessions.js.map +1 -1
  128. package/dist/runtime/sandbox-setup.d.ts +5 -0
  129. package/dist/runtime/sandbox-setup.d.ts.map +1 -0
  130. package/dist/runtime/sandbox-setup.js +62 -0
  131. package/dist/runtime/sandbox-setup.js.map +1 -0
  132. package/dist/runtime/sandbox-shell.d.ts +27 -0
  133. package/dist/runtime/sandbox-shell.d.ts.map +1 -0
  134. package/dist/runtime/sandbox-shell.js +169 -0
  135. package/dist/runtime/sandbox-shell.js.map +1 -0
  136. package/dist/runtime/sandbox-watch.d.ts +11 -0
  137. package/dist/runtime/sandbox-watch.d.ts.map +1 -0
  138. package/dist/runtime/sandbox-watch.js +30 -0
  139. package/dist/runtime/sandbox-watch.js.map +1 -0
  140. package/dist/runtime/sandbox-workspace.d.ts +125 -0
  141. package/dist/runtime/sandbox-workspace.d.ts.map +1 -0
  142. package/dist/runtime/sandbox-workspace.js +205 -0
  143. package/dist/runtime/sandbox-workspace.js.map +1 -0
  144. package/dist/runtime/sandbox.d.ts +21 -2
  145. package/dist/runtime/sandbox.d.ts.map +1 -1
  146. package/dist/runtime/sandbox.js +473 -207
  147. package/dist/runtime/sandbox.js.map +1 -1
  148. package/dist/runtime/session.d.ts +1 -1
  149. package/dist/runtime/session.d.ts.map +1 -1
  150. package/dist/runtime/session.js +3 -3
  151. package/dist/runtime/session.js.map +1 -1
  152. package/dist/runtime/terminal.d.ts +19 -0
  153. package/dist/runtime/terminal.d.ts.map +1 -0
  154. package/dist/runtime/terminal.js +60 -0
  155. package/dist/runtime/terminal.js.map +1 -0
  156. package/dist/runtime/workspace-client.d.ts +2 -0
  157. package/dist/runtime/workspace-client.d.ts.map +1 -0
  158. package/dist/runtime/workspace-client.js +46 -0
  159. package/dist/runtime/workspace-client.js.map +1 -0
  160. package/package.json +2 -1
  161. package/scripts/eve/README.md +341 -0
  162. package/scripts/eve/agent/agent.ts +12 -0
  163. package/scripts/eve/agent/channels/eve.ts +23 -0
  164. package/scripts/eve/agent/instructions.md +53 -0
  165. package/scripts/eve/agent/sandbox.ts +34 -0
  166. package/scripts/eve/build-cache.mjs +18 -0
  167. package/scripts/eve/build-cache.test.mjs +32 -0
  168. package/scripts/eve/client.mjs +229 -0
  169. package/scripts/eve/connection.mjs +89 -0
  170. package/scripts/eve/conversation.mjs +91 -0
  171. package/scripts/eve/conversation.test.mjs +113 -0
  172. package/scripts/eve/fixture-agent.ts +101 -0
  173. package/scripts/eve/images.mjs +84 -0
  174. package/scripts/eve/launch.mjs +277 -0
  175. package/scripts/eve/model-command.mjs +21 -0
  176. package/scripts/eve/reconnect.mjs +22 -0
  177. package/scripts/eve/reconnect.test.mjs +41 -0
  178. package/scripts/eve/settings.mjs +33 -0
  179. package/scripts/eve/supervisor.mjs +41 -0
  180. package/scripts/eve/tui-client.mjs +234 -0
  181. package/scripts/eve/tui-input.mjs +114 -0
  182. package/scripts/eve/verify.mjs +575 -0
  183. package/skills/d3k/SKILL.md +60 -5
@@ -0,0 +1,274 @@
1
+ import { createHash, randomUUID } from "node:crypto";
2
+ import { mkdir, open, writeFile } from "node:fs/promises";
3
+ import { isAbsolute, join } from "node:path";
4
+ import { metricsObserverScript, snapshotScript, summarizeBrowserMetrics } from "./browser-metrics.js";
5
+ import { connectManagedCdp } from "./managed-cdp.js";
6
+ import { safeNetworkUrl } from "./network-evidence.js";
7
+ const delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
8
+ export function parseCaptureOptions(args) {
9
+ const url = args[0];
10
+ const options = {};
11
+ for (let index = 1; index < args.length; index += 2) {
12
+ const name = args[index];
13
+ const value = args[index + 1];
14
+ if (!["--output", "--runs", "--settle-ms", "--ready", "--actions"].includes(name) ||
15
+ value === undefined ||
16
+ options[name] !== undefined)
17
+ throw new Error("Use browser capture URL --output ABSOLUTE_DIRECTORY [--runs 3] [--ready CSS] [--settle-ms 1000] [--actions JSON]");
18
+ options[name] = value;
19
+ }
20
+ const parsed = new URL(url);
21
+ if (!["http:", "https:"].includes(parsed.protocol) || parsed.username || parsed.password)
22
+ throw new Error("Capture URL must use HTTP(S) without embedded credentials");
23
+ if (!options["--output"] || !isAbsolute(options["--output"]))
24
+ throw new Error("Capture requires an absolute output directory");
25
+ const runs = Number(options["--runs"] ?? 3);
26
+ const settleMs = Number(options["--settle-ms"] ?? 1000);
27
+ if (!Number.isInteger(runs) || runs < 1 || runs > 5)
28
+ throw new Error("Capture runs must be 1–5");
29
+ if (!Number.isInteger(settleMs) || settleMs < 250 || settleMs > 5000)
30
+ throw new Error("Capture settle-ms must be 250–5000");
31
+ const actions = JSON.parse(options["--actions"] || "[]");
32
+ if (!Array.isArray(actions) || actions.length > 10)
33
+ throw new Error("Capture supports up to ten actions");
34
+ for (const action of actions) {
35
+ if (!action || typeof action !== "object" || Object.keys(action).length !== 1)
36
+ throw new Error("Invalid capture action");
37
+ if ("scroll" in action) {
38
+ if (!Number.isInteger(action.scroll) || Math.abs(action.scroll) > 5000 || !action.scroll)
39
+ throw new Error("Scroll must be a nonzero pixel distance within ±5000");
40
+ }
41
+ else if ("click" in action || "waitFor" in action) {
42
+ const selector = "click" in action ? action.click : action.waitFor;
43
+ if (typeof selector !== "string" || !selector.trim() || selector.length > 2000)
44
+ throw new Error("Actions require a CSS selector");
45
+ }
46
+ else
47
+ throw new Error("Actions support click, scroll and waitFor");
48
+ }
49
+ return { url: parsed.href, output: options["--output"], runs, settleMs, ready: options["--ready"], actions };
50
+ }
51
+ async function evaluate(cdp, expression) {
52
+ const result = await cdp.send("Runtime.evaluate", { expression, returnByValue: true });
53
+ if (result.exceptionDetails)
54
+ throw new Error("Page evaluation failed during capture");
55
+ return result.result?.value;
56
+ }
57
+ /** Bounded aggregate probes; animation gaps measure main-thread scheduling, not compositor frame loss. */
58
+ export function jankObserverScript(key) {
59
+ return `(() => {
60
+ const state = { visibility: document.visibilityState, frames: 0, maxFrameGapMs: 0, gapsOver50Ms: 0, maxInteractionMs: null, longAnimationFrames: null };
61
+ globalThis[${JSON.stringify(key)}] = state;
62
+ let previous, frame; const observers = [];
63
+ function tick(now) { if (previous !== undefined) { const gap = now - previous; state.maxFrameGapMs = Math.max(state.maxFrameGapMs, gap); if (gap > 50) state.gapsOver50Ms++; } previous = now; state.frames++; frame = requestAnimationFrame(tick); }
64
+ frame = requestAnimationFrame(tick);
65
+ if (PerformanceObserver.supportedEntryTypes.includes('long-animation-frame')) {
66
+ state.longAnimationFrames = { count: 0, totalBlockingMs: 0, maxDurationMs: 0, slowestScripts: [] };
67
+ const observer = new PerformanceObserver(list => { for (const entry of list.getEntries()) {
68
+ state.longAnimationFrames.count++; state.longAnimationFrames.totalBlockingMs += entry.blockingDuration; state.longAnimationFrames.maxDurationMs = Math.max(state.longAnimationFrames.maxDurationMs, entry.duration);
69
+ for (const script of entry.scripts || []) state.longAnimationFrames.slowestScripts.push({durationMs:script.duration, sourceUrl:(script.sourceURL || '').slice(0,4000), functionName:(script.sourceFunctionName || '').slice(0,200), sourceCharPosition:script.sourceCharPosition});
70
+ state.longAnimationFrames.slowestScripts.sort((a,b)=>b.durationMs-a.durationMs); state.longAnimationFrames.slowestScripts.length = Math.min(5,state.longAnimationFrames.slowestScripts.length);
71
+ } });
72
+ observer.observe({type: 'long-animation-frame', buffered: true}); observers.push(observer);
73
+ }
74
+ if (PerformanceObserver.supportedEntryTypes.includes('event')) {
75
+ const observer = new PerformanceObserver(list => { for (const entry of list.getEntries()) if (entry.interactionId) state.maxInteractionMs = Math.max(state.maxInteractionMs || 0, entry.duration); });
76
+ observer.observe({type: 'event', buffered: true, durationThreshold: 16}); observers.push(observer);
77
+ }
78
+ document.addEventListener('visibilitychange', visibility);
79
+ function visibility() { if (document.visibilityState !== 'visible') state.visibility = 'hidden-during-capture'; }
80
+ state.dispose = () => { cancelAnimationFrame(frame); for (const observer of observers) observer.disconnect(); document.removeEventListener('visibilitychange', visibility); delete globalThis[${JSON.stringify(key)}]; };
81
+ })()`;
82
+ }
83
+ async function waitFor(cdp, expression) {
84
+ const deadline = performance.now() + 15000;
85
+ while (!(await evaluate(cdp, expression))) {
86
+ if (performance.now() >= deadline)
87
+ throw new Error("Capture readiness timed out after 15000ms");
88
+ await delay(100);
89
+ }
90
+ }
91
+ async function navigate(cdp, options) {
92
+ const previousOrigin = await evaluate(cdp, "performance.timeOrigin");
93
+ const result = await cdp.send("Page.navigate", { url: options.url });
94
+ if (result.errorText)
95
+ throw new Error(`Capture navigation failed: ${result.errorText}`);
96
+ await waitFor(cdp, `location.href !== 'about:blank' && document.readyState === 'complete' && performance.timeOrigin !== ${JSON.stringify(previousOrigin)}`);
97
+ if (options.ready)
98
+ await waitFor(cdp, `!!document.querySelector(${JSON.stringify(options.ready)})`);
99
+ }
100
+ async function performActions(cdp, actions) {
101
+ for (const action of actions) {
102
+ if ("waitFor" in action) {
103
+ await waitFor(cdp, `!!document.querySelector(${JSON.stringify(action.waitFor)})`);
104
+ }
105
+ else if ("scroll" in action) {
106
+ const point = (await evaluate(cdp, `({x:innerWidth/2,y:innerHeight/2})`));
107
+ await cdp.send("Input.dispatchMouseEvent", { type: "mouseWheel", ...point, deltaX: 0, deltaY: action.scroll });
108
+ }
109
+ else {
110
+ const point = (await evaluate(cdp, `(() => { const elements = document.querySelectorAll(${JSON.stringify(action.click)}); if (elements.length !== 1) return null; const element = elements[0]; element.scrollIntoView({block:'center',behavior:'instant'}); const r = element.getBoundingClientRect(); const x = r.x+r.width/2, y = r.y+r.height/2; const hit = document.elementFromPoint(x,y); return r.width && r.height && hit && (hit === element || element.contains(hit)) ? {x,y} : null; })()`));
111
+ if (!point)
112
+ throw new Error(`Capture click needs one visible, unobstructed match: ${action.click}`);
113
+ await cdp.send("Input.dispatchMouseEvent", { type: "mousePressed", ...point, button: "left", clickCount: 1 });
114
+ await cdp.send("Input.dispatchMouseEvent", { type: "mouseReleased", ...point, button: "left", clickCount: 1 });
115
+ }
116
+ await delay(250);
117
+ }
118
+ }
119
+ /** Stream to a new file with a hard size cap; the browser needs no output-path access. */
120
+ export async function saveRecording(cdp, path) {
121
+ const { stream } = await cdp.send("Page.stopScreenRecording");
122
+ if (typeof stream !== "string" || !stream)
123
+ throw new Error("Chrome returned no recording stream");
124
+ let file;
125
+ let bytes = 0;
126
+ try {
127
+ file = await open(path, "wx", 0o600);
128
+ while (true) {
129
+ const result = await cdp.send("IO.read", { handle: stream, size: 1024 * 1024 });
130
+ if (typeof result.data !== "string")
131
+ throw new Error("Invalid Chrome recording chunk");
132
+ const chunk = Buffer.from(result.data, result.base64Encoded ? "base64" : "utf8");
133
+ bytes += chunk.length;
134
+ if (bytes > 128 * 1024 * 1024)
135
+ throw new Error("Recording exceeded 128MiB; reduce the scenario duration");
136
+ await file.writeFile(chunk);
137
+ if (result.eof)
138
+ break;
139
+ }
140
+ if (!bytes)
141
+ throw new Error("Chrome returned an empty recording");
142
+ return bytes;
143
+ }
144
+ finally {
145
+ await file?.close();
146
+ await cdp.send("IO.close", { handle: stream }).catch(() => { });
147
+ }
148
+ }
149
+ export async function captureBrowserLoading(args, invoke, connect = connectManagedCdp) {
150
+ const options = parseCaptureOptions(args);
151
+ // A new directory prevents overwriting baseline evidence or mixing old and new runs.
152
+ await mkdir(options.output, { mode: 0o700 });
153
+ const connection = await connect(invoke);
154
+ let runDeadline = Number.POSITIVE_INFINITY;
155
+ const cdp = {
156
+ close: connection.close,
157
+ send: async (method, params) => {
158
+ if (performance.now() > runDeadline)
159
+ throw new Error("Capture exceeded the 60000ms run limit");
160
+ return connection.send(method, params);
161
+ }
162
+ };
163
+ const key = `__d3kCapture_${randomUUID().replaceAll("-", "")}`;
164
+ const jankKey = `${key}_jank`;
165
+ let installed;
166
+ let recording = false;
167
+ try {
168
+ const browser = await cdp.send("Browser.getVersion");
169
+ await cdp.send("Page.enable");
170
+ await cdp.send("Page.bringToFront");
171
+ installed = String((await cdp.send("Page.addScriptToEvaluateOnNewDocument", {
172
+ source: `${metricsObserverScript(key)};${jankObserverScript(jankKey)}`
173
+ })).identifier);
174
+ // Warm the dev server and HTTP cache equally before each capture set; cookies are untouched.
175
+ await navigate(cdp, options);
176
+ await delay(options.settleMs);
177
+ const runs = [];
178
+ for (let run = 1; run <= options.runs; run++) {
179
+ await cdp.send("Page.navigate", { url: "about:blank" });
180
+ await waitFor(cdp, `location.href === 'about:blank'`);
181
+ const recordingRequestedAt = performance.now();
182
+ runDeadline = recordingRequestedAt + 60000;
183
+ try {
184
+ await cdp.send("Page.startScreenRecording", {
185
+ frameRate: 60,
186
+ maxWidth: 1920,
187
+ maxHeight: 1080,
188
+ captureArea: "target",
189
+ audio: false
190
+ });
191
+ }
192
+ catch (error) {
193
+ throw new Error(`Native recording unavailable in ${String(browser.product)}; Chrome 153+ with Page.startScreenRecording is required. ${String(error)}`);
194
+ }
195
+ recording = true;
196
+ await delay(150);
197
+ const triggerOffsetMs = performance.now() - recordingRequestedAt;
198
+ await navigate(cdp, options);
199
+ await delay(options.settleMs);
200
+ const documentOrigin = await evaluate(cdp, "performance.timeOrigin");
201
+ await performActions(cdp, options.actions);
202
+ await delay(options.settleMs);
203
+ if ((await evaluate(cdp, "performance.timeOrigin")) !== documentOrigin)
204
+ throw new Error("An action navigated to a new document; capture that page as a separate scenario");
205
+ const snapshot = JSON.parse(String(await evaluate(cdp, snapshotScript(key))));
206
+ const details = await evaluate(cdp, `JSON.stringify({jank:globalThis[${JSON.stringify(jankKey)}],viewport:{width:innerWidth,height:innerHeight,dpr:devicePixelRatio},url:location.href})`);
207
+ const context = JSON.parse(String(details));
208
+ for (const script of context.jank?.longAnimationFrames?.slowestScripts || []) {
209
+ script.sourceUrl = safeNetworkUrl(script.sourceUrl);
210
+ }
211
+ if (!snapshot.observation || !context.jank)
212
+ throw new Error("Capture observers were lost; retry the scenario");
213
+ if (context.jank.visibility !== "visible")
214
+ throw new Error("Capture tab was hidden; keep it visible and retry");
215
+ const video = `run-${run}.mp4`;
216
+ const bytes = await saveRecording(cdp, join(options.output, video));
217
+ recording = false;
218
+ runs.push({
219
+ video,
220
+ bytes,
221
+ triggerOffsetMs,
222
+ viewport: context.viewport,
223
+ metrics: summarizeBrowserMetrics(snapshot, {}),
224
+ jank: context.jank
225
+ });
226
+ runDeadline = Number.POSITIVE_INFINITY;
227
+ }
228
+ const manifest = {
229
+ version: 1,
230
+ capturedAt: new Date().toISOString(),
231
+ scenario: {
232
+ url: safeNetworkUrl(options.url),
233
+ identity: createHash("sha256").update(options.url).digest("hex"),
234
+ ready: options.ready ?? null,
235
+ actions: options.actions,
236
+ settleMs: options.settleMs,
237
+ warmups: 1,
238
+ cache: "existing-profile-warmed",
239
+ throttling: "unchanged",
240
+ frameRate: 60
241
+ },
242
+ browser: browser.product,
243
+ runs,
244
+ notes: [
245
+ "Local lab measurements, not field Core Web Vitals or a performance guarantee.",
246
+ "Video trigger offsets are estimates from CDP request timing, not frame-exact synchronization.",
247
+ "Animation gaps measure main-thread scheduling, not dropped compositor frames. maxInteractionMs is an observed Event Timing maximum, not INP; null can mean no qualifying event.",
248
+ "Use matching production builds for performance conclusions; dev compilation, HMR, machine load, cache and network state can change results.",
249
+ "Videos contain visible page data. Capture is explicit; delete the output directory when it is no longer needed."
250
+ ]
251
+ };
252
+ await writeFile(join(options.output, "capture.json"), JSON.stringify(manifest, null, 2), {
253
+ flag: "wx",
254
+ mode: 0o600
255
+ });
256
+ return { output: options.output, ...manifest };
257
+ }
258
+ finally {
259
+ runDeadline = Number.POSITIVE_INFINITY;
260
+ if (recording)
261
+ await cdp
262
+ .send("Page.stopScreenRecording")
263
+ .then(async ({ stream }) => {
264
+ if (stream)
265
+ await cdp.send("IO.close", { handle: stream });
266
+ })
267
+ .catch(() => { });
268
+ if (installed)
269
+ await cdp.send("Page.removeScriptToEvaluateOnNewDocument", { identifier: installed }).catch(() => { });
270
+ await evaluate(cdp, `globalThis[${JSON.stringify(key)}]?.dispose();globalThis[${JSON.stringify(jankKey)}]?.dispose()`).catch(() => { });
271
+ cdp.close();
272
+ }
273
+ }
274
+ //# sourceMappingURL=browser-capture.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"browser-capture.js","sourceRoot":"","sources":["../../src/runtime/browser-capture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACpD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACzD,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AACrG,OAAO,EAAsB,iBAAiB,EAAmB,MAAM,kBAAkB,CAAA;AACzF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAWtD,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA;AAErF,MAAM,UAAU,mBAAmB,CAAC,IAAc;IAChD,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;IACnB,MAAM,OAAO,GAA2B,EAAE,CAAA;IAC1C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAA;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;QAC7B,IACE,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;YAC7E,KAAK,KAAK,SAAS;YACnB,OAAO,CAAC,IAAI,CAAC,KAAK,SAAS;YAE3B,MAAM,IAAI,KAAK,CACb,kHAAkH,CACnH,CAAA;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAA;IACvB,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;IAC3B,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ;QACtF,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAA;IAC9E,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAA;IAClE,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA;IAC3C,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,CAAA;IACvD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAA;IAChG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,GAAG,IAAI,QAAQ,GAAG,IAAI;QAClE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAA;IACvD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,IAAI,CAAa,CAAA;IACpE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAA;IACzG,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC;YAC3E,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;QAC3C,IAAI,QAAQ,IAAI,MAAM,EAAE,CAAC;YACvB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM;gBACtF,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAA;QAC3E,CAAC;aAAM,IAAI,OAAO,IAAI,MAAM,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;YACpD,MAAM,QAAQ,GAAG,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAA;YAClE,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,QAAQ,CAAC,MAAM,GAAG,IAAI;gBAC5E,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAA;QACrD,CAAC;;YAAM,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAA;IACrE,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAA;AAC9G,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,GAAe,EAAE,UAAkB;IACzD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,UAAU,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAA;IACtF,IAAI,MAAM,CAAC,gBAAgB;QAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAA;IACrF,OAAQ,MAAM,CAAC,MAA6B,EAAE,KAAK,CAAA;AACrD,CAAC;AAED,0GAA0G;AAC1G,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,OAAO;;iBAEQ,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;oMAmBgK,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;OAChN,CAAA;AACP,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,GAAe,EAAE,UAAkB;IACxD,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAA;IAC1C,OAAO,CAAC,CAAC,MAAM,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC;QAC1C,IAAI,WAAW,CAAC,GAAG,EAAE,IAAI,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAA;QAC/F,MAAM,KAAK,CAAC,GAAG,CAAC,CAAA;IAClB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,GAAe,EAAE,OAAuB;IAC9D,MAAM,cAAc,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,wBAAwB,CAAC,CAAA;IACpE,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;IACpE,IAAI,MAAM,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,MAAM,CAAC,SAAS,EAAE,CAAC,CAAA;IACvF,MAAM,OAAO,CACX,GAAG,EACH,uGAAuG,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE,CACxI,CAAA;IACD,IAAI,OAAO,CAAC,KAAK;QAAE,MAAM,OAAO,CAAC,GAAG,EAAE,4BAA4B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;AACrG,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,GAAe,EAAE,OAAiB;IAC9D,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;YACxB,MAAM,OAAO,CAAC,GAAG,EAAE,4BAA4B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QACnF,CAAC;aAAM,IAAI,QAAQ,IAAI,MAAM,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,CAAC,MAAM,QAAQ,CAAC,GAAG,EAAE,oCAAoC,CAAC,CAA6B,CAAA;YACrG,MAAM,GAAG,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAA;QAChH,CAAC;aAAM,CAAC;YACN,MAAM,KAAK,GAAG,CAAC,MAAM,QAAQ,CAC3B,GAAG,EACH,uDAAuD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,+WAA+W,CACnc,CAAoC,CAAA;YACrC,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,wDAAwD,MAAM,CAAC,KAAK,EAAE,CAAC,CAAA;YACnG,MAAM,GAAG,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAA;YAC7G,MAAM,GAAG,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAA;QAChH,CAAC;QACD,MAAM,KAAK,CAAC,GAAG,CAAC,CAAA;IAClB,CAAC;AACH,CAAC;AAED,0FAA0F;AAC1F,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAe,EAAE,IAAY;IAC/D,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAA;IAC7D,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;IACjG,IAAI,IAAkD,CAAA;IACtD,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAA;QACpC,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,CAAC,CAAA;YAC/E,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAA;YACtF,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;YAChF,KAAK,IAAI,KAAK,CAAC,MAAM,CAAA;YACrB,IAAI,KAAK,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAA;YACzG,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;YAC3B,IAAI,MAAM,CAAC,GAAG;gBAAE,MAAK;QACvB,CAAC;QACD,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAA;QACjE,OAAO,KAAK,CAAA;IACd,CAAC;YAAS,CAAC;QACT,MAAM,IAAI,EAAE,KAAK,EAAE,CAAA;QACnB,MAAM,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IAChE,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAAc,EAAE,MAAqB,EAAE,OAAO,GAAG,iBAAiB;IAC5G,MAAM,OAAO,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAA;IACzC,qFAAqF;IACrF,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IAC5C,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;IACxC,IAAI,WAAW,GAAG,MAAM,CAAC,iBAAiB,CAAA;IAC1C,MAAM,GAAG,GAAe;QACtB,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YAC7B,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,WAAW;gBAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAA;YAC9F,OAAO,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QACxC,CAAC;KACF,CAAA;IACD,MAAM,GAAG,GAAG,gBAAgB,UAAU,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAA;IAC9D,MAAM,OAAO,GAAG,GAAG,GAAG,OAAO,CAAA;IAC7B,IAAI,SAA6B,CAAA;IACjC,IAAI,SAAS,GAAG,KAAK,CAAA;IACrB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAA;QACpD,MAAM,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;QAC7B,MAAM,GAAG,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAA;QACnC,SAAS,GAAG,MAAM,CAChB,CACE,MAAM,GAAG,CAAC,IAAI,CAAC,uCAAuC,EAAE;YACtD,MAAM,EAAE,GAAG,qBAAqB,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,OAAO,CAAC,EAAE;SACvE,CAAC,CACH,CAAC,UAAU,CACb,CAAA;QACD,6FAA6F;QAC7F,MAAM,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QAC5B,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QAC7B,MAAM,IAAI,GAAG,EAAE,CAAA;QACf,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC;YAC7C,MAAM,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,CAAA;YACvD,MAAM,OAAO,CAAC,GAAG,EAAE,iCAAiC,CAAC,CAAA;YACrD,MAAM,oBAAoB,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;YAC9C,WAAW,GAAG,oBAAoB,GAAG,KAAK,CAAA;YAC1C,IAAI,CAAC;gBACH,MAAM,GAAG,CAAC,IAAI,CAAC,2BAA2B,EAAE;oBAC1C,SAAS,EAAE,EAAE;oBACb,QAAQ,EAAE,IAAI;oBACd,SAAS,EAAE,IAAI;oBACf,WAAW,EAAE,QAAQ;oBACrB,KAAK,EAAE,KAAK;iBACb,CAAC,CAAA;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CACb,mCAAmC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,6DAA6D,MAAM,CAAC,KAAK,CAAC,EAAE,CACvI,CAAA;YACH,CAAC;YACD,SAAS,GAAG,IAAI,CAAA;YAChB,MAAM,KAAK,CAAC,GAAG,CAAC,CAAA;YAChB,MAAM,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,oBAAoB,CAAA;YAChE,MAAM,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;YAC5B,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;YAC7B,MAAM,cAAc,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,wBAAwB,CAAC,CAAA;YACpE,MAAM,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;YAC1C,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;YAC7B,IAAI,CAAC,MAAM,QAAQ,CAAC,GAAG,EAAE,wBAAwB,CAAC,CAAC,KAAK,cAAc;gBACpE,MAAM,IAAI,KAAK,CAAC,iFAAiF,CAAC,CAAA;YACpG,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;YAC7E,MAAM,OAAO,GAAG,MAAM,QAAQ,CAC5B,GAAG,EACH,mCAAmC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,2FAA2F,CACtJ,CAAA;YACD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;YAC3C,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,IAAI,EAAE,mBAAmB,EAAE,cAAc,IAAI,EAAE,EAAE,CAAC;gBAC7E,MAAM,CAAC,SAAS,GAAG,cAAc,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;YACrD,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,WAAW,IAAI,CAAC,OAAO,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAA;YAC9G,IAAI,OAAO,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;YAC/G,MAAM,KAAK,GAAG,OAAO,GAAG,MAAM,CAAA;YAC9B,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAA;YACnE,SAAS,GAAG,KAAK,CAAA;YACjB,IAAI,CAAC,IAAI,CAAC;gBACR,KAAK;gBACL,KAAK;gBACL,eAAe;gBACf,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,OAAO,EAAE,uBAAuB,CAAC,QAAQ,EAAE,EAAE,CAAC;gBAC9C,IAAI,EAAE,OAAO,CAAC,IAAI;aACnB,CAAC,CAAA;YACF,WAAW,GAAG,MAAM,CAAC,iBAAiB,CAAA;QACxC,CAAC;QACD,MAAM,QAAQ,GAAG;YACf,OAAO,EAAE,CAAC;YACV,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpC,QAAQ,EAAE;gBACR,GAAG,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC;gBAChC,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;gBAChE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,IAAI;gBAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,OAAO,EAAE,CAAC;gBACV,KAAK,EAAE,yBAAyB;gBAChC,UAAU,EAAE,WAAW;gBACvB,SAAS,EAAE,EAAE;aACd;YACD,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,IAAI;YACJ,KAAK,EAAE;gBACL,+EAA+E;gBAC/E,+FAA+F;gBAC/F,iLAAiL;gBACjL,6IAA6I;gBAC7I,iHAAiH;aAClH;SACF,CAAA;QACD,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;YACvF,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,KAAK;SACZ,CAAC,CAAA;QACF,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAA;IAChD,CAAC;YAAS,CAAC;QACT,WAAW,GAAG,MAAM,CAAC,iBAAiB,CAAA;QACtC,IAAI,SAAS;YACX,MAAM,GAAG;iBACN,IAAI,CAAC,0BAA0B,CAAC;iBAChC,IAAI,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;gBACzB,IAAI,MAAM;oBAAE,MAAM,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;YAC5D,CAAC,CAAC;iBACD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QACpB,IAAI,SAAS;YAAE,MAAM,GAAG,CAAC,IAAI,CAAC,0CAA0C,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QACpH,MAAM,QAAQ,CACZ,GAAG,EACH,cAAc,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,2BAA2B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,cAAc,CAClG,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QACjB,GAAG,CAAC,KAAK,EAAE,CAAA;IACb,CAAC;AACH,CAAC"}
@@ -0,0 +1,91 @@
1
+ interface Run {
2
+ video: string;
3
+ triggerOffsetMs: number;
4
+ viewport: {
5
+ width: number;
6
+ height: number;
7
+ dpr: number;
8
+ };
9
+ metrics: {
10
+ url: string;
11
+ webVitals: {
12
+ lcp: {
13
+ valueMs: number;
14
+ } | null;
15
+ cls: number | null;
16
+ };
17
+ paint: {
18
+ fcpMs: number | null;
19
+ };
20
+ navigation: {
21
+ ttfbMs: number | null;
22
+ };
23
+ longTasks: {
24
+ totalMs: number;
25
+ } | null;
26
+ };
27
+ jank: {
28
+ maxFrameGapMs: number;
29
+ maxInteractionMs: number | null;
30
+ longAnimationFrames: {
31
+ totalBlockingMs: number;
32
+ } | null;
33
+ };
34
+ }
35
+ interface Capture {
36
+ version: number;
37
+ browser: string;
38
+ scenario: unknown;
39
+ runs: Run[];
40
+ }
41
+ export declare function distribution(values: Array<number | null | undefined>): {
42
+ observed: number;
43
+ median: number | null;
44
+ min: number;
45
+ max: number | null;
46
+ };
47
+ export declare function compareCaptures(before: Capture, after: Capture): {
48
+ comparable: boolean;
49
+ warnings: string[];
50
+ metrics: {
51
+ name: string;
52
+ before: {
53
+ observed: number;
54
+ median: number | null;
55
+ min: number;
56
+ max: number | null;
57
+ };
58
+ after: {
59
+ observed: number;
60
+ median: number | null;
61
+ min: number;
62
+ max: number | null;
63
+ };
64
+ medianDelta: number | null;
65
+ }[];
66
+ notes: string[];
67
+ };
68
+ export declare function compareBrowserCaptures(args: string[]): Promise<{
69
+ comparable: boolean;
70
+ warnings: string[];
71
+ metrics: {
72
+ name: string;
73
+ before: {
74
+ observed: number;
75
+ median: number | null;
76
+ min: number;
77
+ max: number | null;
78
+ };
79
+ after: {
80
+ observed: number;
81
+ median: number | null;
82
+ min: number;
83
+ max: number | null;
84
+ };
85
+ medianDelta: number | null;
86
+ }[];
87
+ notes: string[];
88
+ output: string;
89
+ }>;
90
+ export {};
91
+ //# sourceMappingURL=browser-compare.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"browser-compare.d.ts","sourceRoot":"","sources":["../../src/runtime/browser-compare.ts"],"names":[],"mappings":"AAGA,UAAU,GAAG;IACX,KAAK,EAAE,MAAM,CAAA;IACb,eAAe,EAAE,MAAM,CAAA;IACvB,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;IACxD,OAAO,EAAE;QACP,GAAG,EAAE,MAAM,CAAA;QACX,SAAS,EAAE;YAAE,GAAG,EAAE;gBAAE,OAAO,EAAE,MAAM,CAAA;aAAE,GAAG,IAAI,CAAC;YAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,CAAA;QAClE,KAAK,EAAE;YAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,CAAA;QAC/B,UAAU,EAAE;YAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,CAAA;QACrC,SAAS,EAAE;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAA;KACtC,CAAA;IACD,IAAI,EAAE;QACJ,aAAa,EAAE,MAAM,CAAA;QACrB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;QAC/B,mBAAmB,EAAE;YAAE,eAAe,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAA;KACxD,CAAA;CACF;AACD,UAAU,OAAO;IACf,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,OAAO,CAAA;IACjB,IAAI,EAAE,GAAG,EAAE,CAAA;CACZ;AAYD,wBAAgB,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAMjE,QAAQ;IACR,MAAM;IAKN,GAAG;IACH,GAAG;EAEN;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;EA6C9D;AASD,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;GAgD1D"}
@@ -0,0 +1,129 @@
1
+ import { readFile, writeFile } from "node:fs/promises";
2
+ import { dirname, isAbsolute, join, relative } from "node:path";
3
+ const measures = [
4
+ ["LCP (ms)", (run) => run.metrics.webVitals.lcp?.valueMs],
5
+ ["CLS", (run) => run.metrics.webVitals.cls],
6
+ ["FCP (ms)", (run) => run.metrics.paint.fcpMs],
7
+ ["TTFB (ms)", (run) => run.metrics.navigation.ttfbMs],
8
+ ["Long tasks total (ms)", (run) => run.metrics.longTasks?.totalMs],
9
+ ["Long animation frame blocking (ms)", (run) => run.jank.longAnimationFrames?.totalBlockingMs],
10
+ ["Max animation gap (ms)", (run) => run.jank.maxFrameGapMs],
11
+ ["Max observed interaction (ms)", (run) => run.jank.maxInteractionMs]
12
+ ];
13
+ export function distribution(values) {
14
+ const available = values
15
+ .filter((value) => typeof value === "number" && Number.isFinite(value))
16
+ .sort((a, b) => a - b);
17
+ const middle = Math.floor(available.length / 2);
18
+ return {
19
+ observed: available.length,
20
+ median: available.length
21
+ ? available.length % 2
22
+ ? available[middle]
23
+ : (available[middle - 1] + available[middle]) / 2
24
+ : null,
25
+ min: available[0] ?? null,
26
+ max: available.at(-1) ?? null
27
+ };
28
+ }
29
+ export function compareCaptures(before, after) {
30
+ for (const capture of [before, after]) {
31
+ if (capture.version !== 1 || !capture.runs?.length || capture.runs.length > 5)
32
+ throw new Error("Expected a d3k capture.json with 1–5 complete runs");
33
+ for (const run of capture.runs) {
34
+ if (!/^run-[1-5]\.mp4$/.test(run.video) ||
35
+ !Number.isFinite(run.triggerOffsetMs) ||
36
+ run.triggerOffsetMs < 0 ||
37
+ !run.viewport ||
38
+ !run.metrics ||
39
+ !run.jank)
40
+ throw new Error("Invalid capture run");
41
+ }
42
+ }
43
+ const warnings = [];
44
+ if (before.browser !== after.browser)
45
+ warnings.push("Chrome versions differ");
46
+ if (JSON.stringify(before.scenario) !== JSON.stringify(after.scenario))
47
+ warnings.push("Scenario settings differ");
48
+ const viewports = [...before.runs, ...after.runs].map((run) => JSON.stringify(run.viewport));
49
+ if (new Set(viewports).size !== 1)
50
+ warnings.push("Viewport or device scale changed");
51
+ if (new Set([...before.runs, ...after.runs].map((run) => run.metrics.url)).size !== 1)
52
+ warnings.push("Final page URLs differ; check redirects and authentication");
53
+ if (before.runs.length !== after.runs.length)
54
+ warnings.push("Run counts differ");
55
+ if (Math.min(before.runs.length, after.runs.length) < 3)
56
+ warnings.push("Fewer than three runs; repeat before drawing performance conclusions");
57
+ return {
58
+ comparable: warnings.length === 0,
59
+ warnings,
60
+ metrics: measures.map(([name, extract]) => {
61
+ const a = distribution(before.runs.map(extract));
62
+ const b = distribution(after.runs.map(extract));
63
+ return {
64
+ name,
65
+ before: a,
66
+ after: b,
67
+ medianDelta: a.median === null || b.median === null ? null : b.median - a.median
68
+ };
69
+ }),
70
+ notes: [
71
+ "Positive deltas indicate an increase; no automatic pass/fail is inferred from a few local runs.",
72
+ "Matching settings do not establish matching CPU load, caches or network conditions. Compare production builds for performance decisions.",
73
+ "Interaction maxima are not INP. Main-thread animation gaps are not compositor dropped-frame counts. Missing values are unavailable, not zero."
74
+ ]
75
+ };
76
+ }
77
+ function escapeHtml(value) {
78
+ return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;");
79
+ }
80
+ function json(value) {
81
+ return JSON.stringify(value).replaceAll("<", "\\u003c");
82
+ }
83
+ export async function compareBrowserCaptures(args) {
84
+ if (args.length !== 4 || args[2] !== "--output" || !args.every((value, index) => index === 2 || isAbsolute(value)))
85
+ throw new Error("Use browser compare ABSOLUTE_BEFORE_DIR ABSOLUTE_AFTER_DIR --output ABSOLUTE_REPORT.html");
86
+ const [beforeDir, afterDir, , output] = args;
87
+ const before = JSON.parse(await readFile(join(beforeDir, "capture.json"), "utf8"));
88
+ const after = JSON.parse(await readFile(join(afterDir, "capture.json"), "utf8"));
89
+ const comparison = compareCaptures(before, after);
90
+ const captures = [before, after].map((capture, index) => capture.runs.map((run) => ({
91
+ src: relative(dirname(output), join(index ? afterDir : beforeDir, run.video))
92
+ .split("/")
93
+ .map(encodeURIComponent)
94
+ .join("/"),
95
+ trigger: run.triggerOffsetMs / 1000
96
+ })));
97
+ const format = (value) => (value === null ? "unavailable" : Number(value.toFixed(3)).toString());
98
+ const range = (value) => `${format(value.median)} (${format(value.min)}–${format(value.max)}; n=${value.observed})`;
99
+ const html = `<!doctype html><meta charset="utf-8"><title>d3k loading comparison</title>
100
+ <style>body{margin:32px;background:#111;color:#eee;font:15px system-ui}h1{font-size:24px}p{color:#aaa;max-width:1000px}.videos{display:grid;grid-template-columns:1fr 1fr;gap:16px}video{width:100%;background:#222}button,select{background:#222;color:#eee;border:1px solid #666;padding:8px;margin-right:12px}input{width:45%;vertical-align:middle}table{border-collapse:collapse;width:100%;margin-top:24px}td,th{text-align:left;padding:10px;border-bottom:1px solid #333}#error{color:#ddd}@media(max-width:700px){.videos{grid-template-columns:1fr}}</style>
101
+ <h1>Loading comparison</h1><p>Same elapsed time from navigation (estimated CDP alignment). Completed videos hold their final frame. Medians below summarize every run; parentheses show min–max and observed count. These are local lab measurements.</p>
102
+ ${comparison.warnings.length ? `<p>Check comparability: ${comparison.warnings.map(escapeHtml).join("; ")}.</p>` : ""}
103
+ <div class="videos"><section><h2>Before <select id="beforeRun"></select></h2><video muted playsinline preload="auto"></video></section><section><h2>After <select id="afterRun"></select></h2><video muted playsinline preload="auto"></video></section></div>
104
+ <p><button id="play" disabled>Play</button><select id="speed"><option value="1">1×</option><option value="0.5">0.5×</option><option value="0.25">0.25×</option></select><input id="seek" aria-label="Elapsed time" type="range" min="0" max="10" step="0.016"><span id="time">0 ms</span></p><p id="error"></p>
105
+ <table><thead><tr><th>Metric</th><th>Before: median (range)</th><th>After: median (range)</th><th>Median change</th></tr></thead><tbody>${comparison.metrics.map((row) => `<tr><td>${escapeHtml(row.name)}</td><td>${range(row.before)}</td><td>${range(row.after)}</td><td>${format(row.medianDelta)}</td></tr>`).join("")}</tbody></table>
106
+ ${comparison.notes.map((note) => `<p>${escapeHtml(note)}</p>`).join("")}
107
+ <script>
108
+ const captures=${json(captures)}, videos=[...document.querySelectorAll('video')], picks=[document.querySelector('#beforeRun'),document.querySelector('#afterRun')], seek=document.querySelector('#seek'), play=document.querySelector('#play'), speed=document.querySelector('#speed');
109
+ let elapsed=0,playing=false,previous=0,generation=0,loading;const blobs=[];
110
+ const selected=i=>captures[i][Number(picks[i].value)];
111
+ function render(force=false){videos.forEach((v,i)=>{const at=Math.max(0,Math.min((v.duration||0)-0.001,selected(i).trigger+elapsed));if(force||Math.abs(v.currentTime-at)>0.12)v.currentTime=at;v.playbackRate=Number(speed.value);if(playing&&at<(v.duration||0)-0.002){if(v.paused)v.play().catch(()=>{document.querySelector('#error').textContent='Playback failed. This browser may not support AV1 MP4; open the report in Chrome.'});}else v.pause();});seek.value=elapsed;document.querySelector('#time').textContent=Math.round(elapsed*1000)+' ms';play.textContent=playing?'Pause':'Play';}
112
+ function limit(){return Math.max(0,...videos.map((v,i)=>(v.duration||0)-selected(i).trigger));}
113
+ async function choose(){
114
+ const current=++generation;playing=false;elapsed=0;play.disabled=true;seek.disabled=true;document.querySelector('#error').textContent='Loading videos…';loading?.abort();loading=new AbortController();
115
+ videos.forEach(v=>{v.pause();v.removeAttribute('src');v.load();});blobs.splice(0).forEach(url=>URL.revokeObjectURL(url));
116
+ try{await Promise.all(videos.map(async(v,i)=>{let src=selected(i).src;
117
+ if(location.protocol!=='file:'){const response=await fetch(src,{signal:loading.signal});if(!response.ok)throw Error('Video fetch failed');const blob=await response.blob();if(current!==generation)return;src=URL.createObjectURL(blob);blobs.push(src);}
118
+ if(current===generation)v.src=src;
119
+ }));}catch(error){if(current===generation&&error.name!=='AbortError')document.querySelector('#error').textContent='Unable to load videos. Keep the report beside its capture directories.';}
120
+ }
121
+ picks.forEach((pick,i)=>{captures[i].forEach((_,n)=>pick.add(new Option('Run '+(n+1),String(n))));pick.onchange=choose;});
122
+ videos.forEach(v=>{v.onloadedmetadata=()=>{if(videos.every(video=>Number.isFinite(video.duration)&&video.duration>0)){seek.max=limit();play.disabled=false;seek.disabled=false;document.querySelector('#error').textContent='';render(true);}};v.onerror=()=>document.querySelector('#error').textContent='Unable to load AV1 video. Keep the report beside its capture directories and open it in Chrome.';});
123
+ play.onclick=()=>{if(elapsed>=limit())elapsed=0;playing=!playing;previous=performance.now();render(true);};seek.oninput=()=>{elapsed=Number(seek.value);render(true);};speed.onchange=()=>render();
124
+ function tick(now){if(playing){elapsed=Math.min(limit(),elapsed+(now-previous)/1000*Number(speed.value));if(elapsed>=limit())playing=false;render();}previous=now;requestAnimationFrame(tick);}choose();requestAnimationFrame(tick);
125
+ </script>`;
126
+ await writeFile(output, html, { flag: "wx", mode: 0o600 });
127
+ return { output, ...comparison };
128
+ }
129
+ //# sourceMappingURL=browser-compare.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"browser-compare.js","sourceRoot":"","sources":["../../src/runtime/browser-compare.ts"],"names":[],"mappings":"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"}
@@ -1,5 +1,6 @@
1
1
  import type { CDPEvent } from "../cdp-monitor.js";
2
+ import { type NetworkEvidenceOptions } from "./network-evidence.js";
2
3
  import type { Timeline } from "./timeline.js";
3
- /** Keep useful CDP fields, never request headers, cookies, or request/response bodies. */
4
- export declare function recordBrowserEvent(timeline: Timeline, event: CDPEvent): void;
4
+ /** Collect browser context and bounded, redacted network evidence in the same timeline. */
5
+ export declare function createBrowserEventRecorder(timeline: Timeline, options: NetworkEvidenceOptions): (event: CDPEvent) => void;
5
6
  //# sourceMappingURL=browser-events.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"browser-events.d.ts","sourceRoot":"","sources":["../../src/runtime/browser-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAE7C,0FAA0F;AAC1F,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,CAsE5E"}
1
+ {"version":3,"file":"browser-events.d.ts","sourceRoot":"","sources":["../../src/runtime/browser-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAmB,KAAK,sBAAsB,EAAkB,MAAM,uBAAuB,CAAA;AACpG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAE7C,2FAA2F;AAC3F,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,sBAAsB,GAC9B,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAK3B"}
@@ -1,5 +1,13 @@
1
- /** Keep useful CDP fields, never request headers, cookies, or request/response bodies. */
2
- export function recordBrowserEvent(timeline, event) {
1
+ import { NetworkEvidence, safeNetworkUrl } from "./network-evidence.js";
2
+ /** Collect browser context and bounded, redacted network evidence in the same timeline. */
3
+ export function createBrowserEventRecorder(timeline, options) {
4
+ const network = new NetworkEvidence(timeline, options);
5
+ return (event) => {
6
+ if (!network.record(event))
7
+ recordBrowserEvent(timeline, event);
8
+ };
9
+ }
10
+ function recordBrowserEvent(timeline, event) {
3
11
  const p = event.params;
4
12
  const base = { source: "browser", data: { method: event.method, target: event.sessionId } };
5
13
  if (event.method === "Runtime.consoleAPICalled") {
@@ -23,65 +31,15 @@ export function recordBrowserEvent(timeline, event) {
23
31
  data: { ...base.data, url: details.url, stack: details.stackTrace }
24
32
  });
25
33
  }
26
- else if (event.method === "Network.requestWillBeSent") {
27
- const request = p.request;
28
- timeline.append({
29
- ...base,
30
- level: "info",
31
- kind: "request",
32
- message: `${request.method} ${safeUrl(request.url)}`,
33
- data: { ...base.data, requestId: p.requestId, url: safeUrl(request.url), httpMethod: request.method }
34
- });
35
- }
36
- else if (event.method === "Network.responseReceived") {
37
- const response = p.response;
38
- timeline.append({
39
- ...base,
40
- level: response.status >= 400 ? "error" : "info",
41
- kind: "response",
42
- message: `${response.status} ${safeUrl(response.url)}`,
43
- data: {
44
- ...base.data,
45
- requestId: p.requestId,
46
- url: safeUrl(response.url),
47
- status: response.status,
48
- mimeType: response.mimeType
49
- }
50
- });
51
- }
52
- else if (event.method === "Network.loadingFailed") {
53
- timeline.append({
54
- ...base,
55
- level: p.canceled ? "info" : "error",
56
- kind: "network-failure",
57
- message: String(p.errorText || "Request failed"),
58
- data: { ...base.data, requestId: p.requestId, canceled: p.canceled }
59
- });
60
- }
61
34
  else if (event.method === "Page.frameNavigated") {
62
35
  const frame = p.frame;
63
36
  timeline.append({
64
37
  ...base,
65
38
  level: "info",
66
39
  kind: "navigation",
67
- message: safeUrl(frame.url),
40
+ message: safeNetworkUrl(frame.url),
68
41
  data: { ...base.data, frameId: frame.id }
69
42
  });
70
43
  }
71
44
  }
72
- function safeUrl(value) {
73
- try {
74
- const url = new URL(value);
75
- url.username = "";
76
- url.password = "";
77
- // URLs can contain access tokens; query values aren't needed for correlation.
78
- if (url.search)
79
- url.search = "?redacted";
80
- url.hash = "";
81
- return url.toString();
82
- }
83
- catch {
84
- return value.slice(0, 1024);
85
- }
86
- }
87
45
  //# sourceMappingURL=browser-events.js.map