feat(browser): add native action commands

src/browser/client-actions-observe.ts

@@ -0,0 +1,207 @@
+import type {
+  BrowserActionOk,
+  BrowserActionPathResult,
+} from "./client-actions-types.js";
+import { fetchBrowserJson } from "./client-fetch.js";
+import type {
+  BrowserConsoleMessage,
+  BrowserNetworkRequest,
+} from "./pw-session.js";
+
+export async function browserConsoleMessages(
+  baseUrl: string,
+  opts: { level?: string; targetId?: string } = {},
+): Promise<{ ok: true; messages: BrowserConsoleMessage[]; targetId: string }> {
+  const q = new URLSearchParams();
+  if (opts.level) q.set("level", opts.level);
+  if (opts.targetId) q.set("targetId", opts.targetId);
+  const suffix = q.toString() ? `?${q.toString()}` : "";
+  return await fetchBrowserJson<{
+    ok: true;
+    messages: BrowserConsoleMessage[];
+    targetId: string;
+  }>(`${baseUrl}/console${suffix}`, { timeoutMs: 20000 });
+}
+
+export async function browserNetworkRequests(
+  baseUrl: string,
+  opts: { includeStatic?: boolean; targetId?: string } = {},
+): Promise<{ ok: true; requests: BrowserNetworkRequest[]; targetId: string }> {
+  const q = new URLSearchParams();
+  if (opts.includeStatic) q.set("includeStatic", "true");
+  if (opts.targetId) q.set("targetId", opts.targetId);
+  const suffix = q.toString() ? `?${q.toString()}` : "";
+  return await fetchBrowserJson<{
+    ok: true;
+    requests: BrowserNetworkRequest[];
+    targetId: string;
+  }>(`${baseUrl}/network${suffix}`, { timeoutMs: 20000 });
+}
+
+export async function browserStartTracing(
+  baseUrl: string,
+  opts: { targetId?: string } = {},
+): Promise<BrowserActionOk> {
+  return await fetchBrowserJson<BrowserActionOk>(`${baseUrl}/trace/start`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ targetId: opts.targetId }),
+    timeoutMs: 20000,
+  });
+}
+
+export async function browserStopTracing(
+  baseUrl: string,
+  opts: { targetId?: string } = {},
+): Promise<BrowserActionPathResult> {
+  return await fetchBrowserJson<BrowserActionPathResult>(
+    `${baseUrl}/trace/stop`,
+    {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ targetId: opts.targetId }),
+      timeoutMs: 20000,
+    },
+  );
+}
+
+export async function browserPdfSave(
+  baseUrl: string,
+  opts: { targetId?: string } = {},
+): Promise<BrowserActionPathResult> {
+  return await fetchBrowserJson<BrowserActionPathResult>(`${baseUrl}/pdf`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ targetId: opts.targetId }),
+    timeoutMs: 20000,
+  });
+}
+
+export async function browserVerifyElementVisible(
+  baseUrl: string,
+  opts: { role: string; accessibleName: string; targetId?: string },
+): Promise<BrowserActionOk> {
+  return await fetchBrowserJson<BrowserActionOk>(`${baseUrl}/verify/element`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({
+      role: opts.role,
+      accessibleName: opts.accessibleName,
+      targetId: opts.targetId,
+    }),
+    timeoutMs: 20000,
+  });
+}
+
+export async function browserVerifyTextVisible(
+  baseUrl: string,
+  opts: { text: string; targetId?: string },
+): Promise<BrowserActionOk> {
+  return await fetchBrowserJson<BrowserActionOk>(`${baseUrl}/verify/text`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ text: opts.text, targetId: opts.targetId }),
+    timeoutMs: 20000,
+  });
+}
+
+export async function browserVerifyListVisible(
+  baseUrl: string,
+  opts: { ref: string; items: string[]; targetId?: string },
+): Promise<BrowserActionOk> {
+  return await fetchBrowserJson<BrowserActionOk>(`${baseUrl}/verify/list`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({
+      ref: opts.ref,
+      items: opts.items,
+      targetId: opts.targetId,
+    }),
+    timeoutMs: 20000,
+  });
+}
+
+export async function browserVerifyValue(
+  baseUrl: string,
+  opts: { ref: string; type: string; value?: string; targetId?: string },
+): Promise<BrowserActionOk> {
+  return await fetchBrowserJson<BrowserActionOk>(`${baseUrl}/verify/value`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({
+      ref: opts.ref,
+      type: opts.type,
+      value: opts.value,
+      targetId: opts.targetId,
+    }),
+    timeoutMs: 20000,
+  });
+}
+
+export async function browserMouseMove(
+  baseUrl: string,
+  opts: { x: number; y: number; targetId?: string },
+): Promise<BrowserActionOk> {
+  return await fetchBrowserJson<BrowserActionOk>(`${baseUrl}/mouse/move`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ x: opts.x, y: opts.y, targetId: opts.targetId }),
+    timeoutMs: 20000,
+  });
+}
+
+export async function browserMouseClick(
+  baseUrl: string,
+  opts: { x: number; y: number; button?: string; targetId?: string },
+): Promise<BrowserActionOk> {
+  return await fetchBrowserJson<BrowserActionOk>(`${baseUrl}/mouse/click`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({
+      x: opts.x,
+      y: opts.y,
+      button: opts.button,
+      targetId: opts.targetId,
+    }),
+    timeoutMs: 20000,
+  });
+}
+
+export async function browserMouseDrag(
+  baseUrl: string,
+  opts: {
+    startX: number;
+    startY: number;
+    endX: number;
+    endY: number;
+    targetId?: string;
+  },
+): Promise<BrowserActionOk> {
+  return await fetchBrowserJson<BrowserActionOk>(`${baseUrl}/mouse/drag`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({
+      startX: opts.startX,
+      startY: opts.startY,
+      endX: opts.endX,
+      endY: opts.endY,
+      targetId: opts.targetId,
+    }),
+    timeoutMs: 20000,
+  });
+}
+
+export async function browserGenerateLocator(
+  baseUrl: string,
+  opts: { ref: string },
+): Promise<{ ok: true; locator: string }> {
+  return await fetchBrowserJson<{ ok: true; locator: string }>(
+    `${baseUrl}/locator`,
+    {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ ref: opts.ref }),
+      timeoutMs: 20000,
+    },
+  );
+}