feat(browser): expand browser control surface

src/browser/client-actions-observe.ts

@@ -1,6 +1,13 @@
-import type { BrowserActionPathResult } from "./client-actions-types.js";
+import type {
+  BrowserActionPathResult,
+  BrowserActionTargetOk,
+} from "./client-actions-types.js";
 import { fetchBrowserJson } from "./client-fetch.js";
-import type { BrowserConsoleMessage } from "./pw-session.js";
+import type {
+  BrowserConsoleMessage,
+  BrowserNetworkRequest,
+  BrowserPageError,
+} from "./pw-session.js";
 
 function buildProfileQuery(profile?: string): string {
   return profile ? `?profile=${encodeURIComponent(profile)}` : "";
@@ -34,3 +41,100 @@ export async function browserPdfSave(
     timeoutMs: 20000,
   });
 }
+
+export async function browserPageErrors(
+  baseUrl: string,
+  opts: { targetId?: string; clear?: boolean; profile?: string } = {},
+): Promise<{ ok: true; targetId: string; errors: BrowserPageError[] }> {
+  const q = new URLSearchParams();
+  if (opts.targetId) q.set("targetId", opts.targetId);
+  if (typeof opts.clear === "boolean") q.set("clear", String(opts.clear));
+  if (opts.profile) q.set("profile", opts.profile);
+  const suffix = q.toString() ? `?${q.toString()}` : "";
+  return await fetchBrowserJson<{
+    ok: true;
+    targetId: string;
+    errors: BrowserPageError[];
+  }>(`${baseUrl}/errors${suffix}`, { timeoutMs: 20000 });
+}
+
+export async function browserRequests(
+  baseUrl: string,
+  opts: {
+    targetId?: string;
+    filter?: string;
+    clear?: boolean;
+    profile?: string;
+  } = {},
+): Promise<{ ok: true; targetId: string; requests: BrowserNetworkRequest[] }> {
+  const q = new URLSearchParams();
+  if (opts.targetId) q.set("targetId", opts.targetId);
+  if (opts.filter) q.set("filter", opts.filter);
+  if (typeof opts.clear === "boolean") q.set("clear", String(opts.clear));
+  if (opts.profile) q.set("profile", opts.profile);
+  const suffix = q.toString() ? `?${q.toString()}` : "";
+  return await fetchBrowserJson<{
+    ok: true;
+    targetId: string;
+    requests: BrowserNetworkRequest[];
+  }>(`${baseUrl}/requests${suffix}`, { timeoutMs: 20000 });
+}
+
+export async function browserTraceStart(
+  baseUrl: string,
+  opts: {
+    targetId?: string;
+    screenshots?: boolean;
+    snapshots?: boolean;
+    sources?: boolean;
+    profile?: string;
+  } = {},
+): Promise<BrowserActionTargetOk> {
+  const q = buildProfileQuery(opts.profile);
+  return await fetchBrowserJson<BrowserActionTargetOk>(
+    `${baseUrl}/trace/start${q}`,
+    {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        targetId: opts.targetId,
+        screenshots: opts.screenshots,
+        snapshots: opts.snapshots,
+        sources: opts.sources,
+      }),
+      timeoutMs: 20000,
+    },
+  );
+}
+
+export async function browserTraceStop(
+  baseUrl: string,
+  opts: { targetId?: string; path?: string; profile?: string } = {},
+): Promise<BrowserActionPathResult> {
+  const q = buildProfileQuery(opts.profile);
+  return await fetchBrowserJson<BrowserActionPathResult>(
+    `${baseUrl}/trace/stop${q}`,
+    {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ targetId: opts.targetId, path: opts.path }),
+      timeoutMs: 20000,
+    },
+  );
+}
+
+export async function browserHighlight(
+  baseUrl: string,
+  opts: { ref: string; targetId?: string; profile?: string },
+): Promise<BrowserActionTargetOk> {
+  const q = buildProfileQuery(opts.profile);
+  return await fetchBrowserJson<BrowserActionTargetOk>(
+    `${baseUrl}/highlight${q}`,
+    {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ targetId: opts.targetId, ref: opts.ref }),
+      timeoutMs: 20000,
+    },
+  );
+}