@flrande/browserctl 0.5.0 → 0.6.0

package/apps/browserctl/src/e2e.test.ts

@@ -1,103 +0,0 @@
-import { afterEach, beforeEach, describe, expect, it } from "vitest";
-
-import { stopDaemon } from "./daemon-client";
-import { EXIT_CODES, runCli } from "./main";
-import { reserveLoopbackPort } from "./test-port";
-
-const TEST_SESSION_ID = "session:e2e";
-let testDaemonPort = 0;
-
-function createIoCapture() {
-  const state = {
-    stdout: "",
-    stderr: ""
-  };
-
-  return {
-    state,
-    io: {
-      stdout: {
-        write(content: string) {
-          state.stdout += content;
-        }
-      },
-      stderr: {
-        write(content: string) {
-          state.stderr += content;
-        }
-      }
-    }
-  };
-}
-
-function parseJsonLine(state: { stdout: string }): Record<string, unknown> {
-  return JSON.parse(state.stdout.trim()) as Record<string, unknown>;
-}
-
-beforeEach(async () => {
-  testDaemonPort = await reserveLoopbackPort();
-  process.env.BROWSERCTL_DAEMON_PORT = String(testDaemonPort);
-  process.env.BROWSERD_MANAGED_LOCAL_ENABLED = "false";
-  process.env.BROWSERD_DEFAULT_DRIVER = "managed";
-  process.env.BROWSERD_CHROME_RELAY_MODE = "cdp";
-  await stopDaemon(testDaemonPort);
-});
-
-afterEach(async () => {
-  await stopDaemon(testDaemonPort);
-  delete process.env.BROWSERCTL_DAEMON_PORT;
-  delete process.env.BROWSERD_MANAGED_LOCAL_ENABLED;
-  delete process.env.BROWSERD_DEFAULT_DRIVER;
-  delete process.env.BROWSERD_CHROME_RELAY_MODE;
-});
-
-describe("browserctl e2e", () => {
-  it("reuses daemon state across multiple commands in the same session", async () => {
-    const startCapture = createIoCapture();
-    const startExitCode = await runCli(["daemon-start", "--json"], startCapture.io);
-
-    expect(startExitCode).toBe(EXIT_CODES.OK);
-    const startPayload = parseJsonLine(startCapture.state);
-    expect(startPayload.ok).toBe(true);
-    const startData = startPayload.data as Record<string, unknown>;
-    expect(startData.running).toBe(true);
-    expect(startData.port).toBe(testDaemonPort);
-
-    const openCapture = createIoCapture();
-    const openExitCode = await runCli(
-      ["tab-open", "--session", TEST_SESSION_ID, "https://example.com", "--json"],
-      openCapture.io
-    );
-
-    expect(openExitCode).toBe(EXIT_CODES.OK);
-    const openPayload = parseJsonLine(openCapture.state);
-    expect(openPayload.ok).toBe(true);
-    const openData = openPayload.data as Record<string, unknown>;
-    expect(openData.driver).toBe("managed");
-    const targetId = openData.targetId;
-    expect(typeof targetId).toBe("string");
-
-    const listCapture = createIoCapture();
-    const listExitCode = await runCli(["tabs", "--session", TEST_SESSION_ID, "--json"], listCapture.io);
-
-    expect(listExitCode).toBe(EXIT_CODES.OK);
-    const listPayload = parseJsonLine(listCapture.state);
-    expect(listPayload.ok).toBe(true);
-    const listData = listPayload.data as { tabs: string[] };
-    expect(listData.tabs).toContain(targetId);
-
-    const consoleCapture = createIoCapture();
-    const consoleExitCode = await runCli(
-      ["console-list", "--session", TEST_SESSION_ID, String(targetId), "--json"],
-      consoleCapture.io
-    );
-    expect(consoleExitCode).toBe(EXIT_CODES.OK);
-    const consolePayload = parseJsonLine(consoleCapture.state);
-    expect(consolePayload.ok).toBe(true);
-    expect(consolePayload.data).toMatchObject({
-      driver: "managed",
-      targetId,
-      entries: []
-    });
-  }, 20_000);
-});

package/apps/browserctl/src/main.dispatch.test.ts

@@ -1,461 +0,0 @@
-import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
-
-import * as a11ySnapshotCommand from "./commands/a11y-snapshot";
-import * as consoleListCommand from "./commands/console-list";
-import * as cookieClearCommand from "./commands/cookie-clear";
-import * as cookieGetCommand from "./commands/cookie-get";
-import * as cookieSetCommand from "./commands/cookie-set";
-import * as daemonClient from "./daemon-client";
-import * as dialogArmCommand from "./commands/dialog-arm";
-import * as domQueryAllCommand from "./commands/dom-query-all";
-import * as domQueryCommand from "./commands/dom-query";
-import * as downloadTriggerCommand from "./commands/download-trigger";
-import * as downloadWaitCommand from "./commands/download-wait";
-import * as elementScreenshotCommand from "./commands/element-screenshot";
-import * as frameListCommand from "./commands/frame-list";
-import * as frameSnapshotCommand from "./commands/frame-snapshot";
-import * as harExportCommand from "./commands/har-export";
-import * as networkListCommand from "./commands/network-list";
-import * as networkWaitForCommand from "./commands/network-wait-for";
-import * as profileListCommand from "./commands/profile-list";
-import * as profileUseCommand from "./commands/profile-use";
-import * as responseBodyCommand from "./commands/response-body";
-import * as sessionDropCommand from "./commands/session-drop";
-import * as sessionListCommand from "./commands/session-list";
-import * as snapshotCommand from "./commands/snapshot";
-import * as storageGetCommand from "./commands/storage-get";
-import * as storageSetCommand from "./commands/storage-set";
-import * as tabCloseCommand from "./commands/tab-close";
-import * as tabFocusCommand from "./commands/tab-focus";
-import * as tabOpenCommand from "./commands/tab-open";
-import * as traceGetCommand from "./commands/trace-get";
-import * as uploadArmCommand from "./commands/upload-arm";
-import * as waitElementCommand from "./commands/wait-element";
-import * as waitTextCommand from "./commands/wait-text";
-import * as waitUrlCommand from "./commands/wait-url";
-import { EXIT_CODES, runCli } from "./main";
-
-function createIoCapture() {
-  const state = {
-    stdout: "",
-    stderr: ""
-  };
-
-  return {
-    state,
-    io: {
-      stdout: {
-        write(content: string) {
-          state.stdout += content;
-        }
-      },
-      stderr: {
-        write(content: string) {
-          state.stderr += content;
-        }
-      }
-    }
-  };
-}
-
-const ORIGINAL_BROWSERCTL_AUTH_TOKEN = process.env.BROWSERCTL_AUTH_TOKEN;
-const ORIGINAL_BROWSERCTL_BROWSER = process.env.BROWSERCTL_BROWSER;
-
-type DispatchCase = {
-  command: string;
-  commandArgs: string[];
-  moduleRef: Record<string, unknown>;
-  handlerName: string;
-};
-
-type MemoryDispatchCase = {
-  command: string;
-  commandArgs: string[];
-  expectedTool: string;
-  expectedArgs: Record<string, unknown>;
-};
-
-const COMMAND_DISPATCH_CASES: DispatchCase[] = [
-  {
-    command: "a11y-snapshot",
-    commandArgs: ["target:1"],
-    moduleRef: a11ySnapshotCommand as unknown as Record<string, unknown>,
-    handlerName: "runA11ySnapshotCommand"
-  },
-  {
-    command: "console-list",
-    commandArgs: ["target:1"],
-    moduleRef: consoleListCommand as unknown as Record<string, unknown>,
-    handlerName: "runConsoleListCommand"
-  },
-  {
-    command: "cookie-clear",
-    commandArgs: ["target:1"],
-    moduleRef: cookieClearCommand as unknown as Record<string, unknown>,
-    handlerName: "runCookieClearCommand"
-  },
-  {
-    command: "cookie-get",
-    commandArgs: ["target:1"],
-    moduleRef: cookieGetCommand as unknown as Record<string, unknown>,
-    handlerName: "runCookieGetCommand"
-  },
-  {
-    command: "cookie-set",
-    commandArgs: ["target:1", "sid", "abc"],
-    moduleRef: cookieSetCommand as unknown as Record<string, unknown>,
-    handlerName: "runCookieSetCommand"
-  },
-  {
-    command: "dialog-arm",
-    commandArgs: ["target:1"],
-    moduleRef: dialogArmCommand as unknown as Record<string, unknown>,
-    handlerName: "runDialogArmCommand"
-  },
-  {
-    command: "dom-query",
-    commandArgs: ["target:1", "#root"],
-    moduleRef: domQueryCommand as unknown as Record<string, unknown>,
-    handlerName: "runDomQueryCommand"
-  },
-  {
-    command: "dom-query-all",
-    commandArgs: ["target:1", ".item"],
-    moduleRef: domQueryAllCommand as unknown as Record<string, unknown>,
-    handlerName: "runDomQueryAllCommand"
-  },
-  {
-    command: "download-trigger",
-    commandArgs: ["target:1"],
-    moduleRef: downloadTriggerCommand as unknown as Record<string, unknown>,
-    handlerName: "runDownloadTriggerCommand"
-  },
-  {
-    command: "download-wait",
-    commandArgs: ["target:1"],
-    moduleRef: downloadWaitCommand as unknown as Record<string, unknown>,
-    handlerName: "runDownloadWaitCommand"
-  },
-  {
-    command: "element-screenshot",
-    commandArgs: ["target:1", "#hero"],
-    moduleRef: elementScreenshotCommand as unknown as Record<string, unknown>,
-    handlerName: "runElementScreenshotCommand"
-  },
-  {
-    command: "frame-list",
-    commandArgs: ["target:1"],
-    moduleRef: frameListCommand as unknown as Record<string, unknown>,
-    handlerName: "runFrameListCommand"
-  },
-  {
-    command: "frame-snapshot",
-    commandArgs: ["target:1", "frame:0"],
-    moduleRef: frameSnapshotCommand as unknown as Record<string, unknown>,
-    handlerName: "runFrameSnapshotCommand"
-  },
-  {
-    command: "har-export",
-    commandArgs: ["target:1"],
-    moduleRef: harExportCommand as unknown as Record<string, unknown>,
-    handlerName: "runHarExportCommand"
-  },
-  {
-    command: "network-list",
-    commandArgs: ["target:1"],
-    moduleRef: networkListCommand as unknown as Record<string, unknown>,
-    handlerName: "runNetworkListCommand"
-  },
-  {
-    command: "network-wait-for",
-    commandArgs: ["target:1", "/api", "1000"],
-    moduleRef: networkWaitForCommand as unknown as Record<string, unknown>,
-    handlerName: "runNetworkWaitForCommand"
-  },
-  {
-    command: "profile-list",
-    commandArgs: [],
-    moduleRef: profileListCommand as unknown as Record<string, unknown>,
-    handlerName: "runProfileListCommand"
-  },
-  {
-    command: "profile-use",
-    commandArgs: ["managed"],
-    moduleRef: profileUseCommand as unknown as Record<string, unknown>,
-    handlerName: "runProfileUseCommand"
-  },
-  {
-    command: "response-body",
-    commandArgs: ["target:1", "request:1"],
-    moduleRef: responseBodyCommand as unknown as Record<string, unknown>,
-    handlerName: "runResponseBodyCommand"
-  },
-  {
-    command: "session-drop",
-    commandArgs: ["tenant-a:job-1"],
-    moduleRef: sessionDropCommand as unknown as Record<string, unknown>,
-    handlerName: "runSessionDropCommand"
-  },
-  {
-    command: "session-list",
-    commandArgs: ["--tenant", "ops", "--limit", "10"],
-    moduleRef: sessionListCommand as unknown as Record<string, unknown>,
-    handlerName: "runSessionListCommand"
-  },
-  {
-    command: "snapshot",
-    commandArgs: ["target:1"],
-    moduleRef: snapshotCommand as unknown as Record<string, unknown>,
-    handlerName: "runSnapshotCommand"
-  },
-  {
-    command: "storage-get",
-    commandArgs: ["target:1", "local", "theme"],
-    moduleRef: storageGetCommand as unknown as Record<string, unknown>,
-    handlerName: "runStorageGetCommand"
-  },
-  {
-    command: "storage-set",
-    commandArgs: ["target:1", "local", "theme", "dark"],
-    moduleRef: storageSetCommand as unknown as Record<string, unknown>,
-    handlerName: "runStorageSetCommand"
-  },
-  {
-    command: "tab-close",
-    commandArgs: ["target:1"],
-    moduleRef: tabCloseCommand as unknown as Record<string, unknown>,
-    handlerName: "runTabCloseCommand"
-  },
-  {
-    command: "tab-focus",
-    commandArgs: ["target:1"],
-    moduleRef: tabFocusCommand as unknown as Record<string, unknown>,
-    handlerName: "runTabFocusCommand"
-  },
-  {
-    command: "tab-open",
-    commandArgs: ["https://example.com"],
-    moduleRef: tabOpenCommand as unknown as Record<string, unknown>,
-    handlerName: "runTabOpenCommand"
-  },
-  {
-    command: "trace-get",
-    commandArgs: ["--limit", "10"],
-    moduleRef: traceGetCommand as unknown as Record<string, unknown>,
-    handlerName: "runTraceGetCommand"
-  },
-  {
-    command: "wait-element",
-    commandArgs: ["target:1", "#root", "1500"],
-    moduleRef: waitElementCommand as unknown as Record<string, unknown>,
-    handlerName: "runWaitElementCommand"
-  },
-  {
-    command: "wait-text",
-    commandArgs: ["target:1", "ready"],
-    moduleRef: waitTextCommand as unknown as Record<string, unknown>,
-    handlerName: "runWaitTextCommand"
-  },
-  {
-    command: "wait-url",
-    commandArgs: ["target:1", "/dashboard"],
-    moduleRef: waitUrlCommand as unknown as Record<string, unknown>,
-    handlerName: "runWaitUrlCommand"
-  },
-  {
-    command: "upload-arm",
-    commandArgs: ["target:1", "upload.txt"],
-    moduleRef: uploadArmCommand as unknown as Record<string, unknown>,
-    handlerName: "runUploadArmCommand"
-  }
-];
-
-const MEMORY_DISPATCH_CASES: MemoryDispatchCase[] = [
-  {
-    command: "memory-status",
-    commandArgs: [],
-    expectedTool: "browser.memory.status",
-    expectedArgs: {
-      sessionId: "cli:local"
-    }
-  },
-  {
-    command: "memory-mode-set",
-    commandArgs: ["ask"],
-    expectedTool: "browser.memory.mode.set",
-    expectedArgs: {
-      sessionId: "cli:local",
-      mode: "ask"
-    }
-  },
-  {
-    command: "memory-resolve",
-    commandArgs: ["forum.example", "open_profile"],
-    expectedTool: "browser.memory.resolve",
-    expectedArgs: {
-      sessionId: "cli:local",
-      domain: "forum.example",
-      profileId: "default",
-      intentKey: "open_profile"
-    }
-  },
-  {
-    command: "memory-upsert",
-    commandArgs: [
-      "forum.example",
-      "open_profile",
-      "--signals-json",
-      "[{\"kind\":\"urlPattern\",\"value\":\"/profile\"}]",
-      "--confidence",
-      "0.9",
-      "--confirmed"
-    ],
-    expectedTool: "browser.memory.upsert",
-    expectedArgs: {
-      sessionId: "cli:local",
-      domain: "forum.example",
-      profileId: "default",
-      intentKey: "open_profile",
-      signals: [{ kind: "urlPattern", value: "/profile" }],
-      confidence: 0.9,
-      confirmed: true
-    }
-  },
-  {
-    command: "memory-list",
-    commandArgs: ["--domain", "forum.example", "--profile-id", "managed", "--intent-key", "open_profile"],
-    expectedTool: "browser.memory.list",
-    expectedArgs: {
-      sessionId: "cli:local",
-      domain: "forum.example",
-      profileId: "managed",
-      intentKey: "open_profile"
-    }
-  },
-  {
-    command: "memory-inspect",
-    commandArgs: ["memory:1"],
-    expectedTool: "browser.memory.inspect",
-    expectedArgs: {
-      sessionId: "cli:local",
-      id: "memory:1"
-    }
-  },
-  {
-    command: "memory-delete",
-    commandArgs: ["memory:1"],
-    expectedTool: "browser.memory.delete",
-    expectedArgs: {
-      sessionId: "cli:local",
-      id: "memory:1"
-    }
-  },
-  {
-    command: "memory-purge",
-    commandArgs: [],
-    expectedTool: "browser.memory.purge",
-    expectedArgs: {
-      sessionId: "cli:local"
-    }
-  },
-  {
-    command: "memory-ttl-set",
-    commandArgs: ["7"],
-    expectedTool: "browser.memory.ttl.set",
-    expectedArgs: {
-      sessionId: "cli:local",
-      ttlDays: 7
-    }
-  }
-];
-
-afterEach(() => {
-  vi.restoreAllMocks();
-  if (ORIGINAL_BROWSERCTL_AUTH_TOKEN === undefined) {
-    delete process.env.BROWSERCTL_AUTH_TOKEN;
-  } else {
-    process.env.BROWSERCTL_AUTH_TOKEN = ORIGINAL_BROWSERCTL_AUTH_TOKEN;
-  }
-
-  if (ORIGINAL_BROWSERCTL_BROWSER === undefined) {
-    delete process.env.BROWSERCTL_BROWSER;
-  } else {
-    process.env.BROWSERCTL_BROWSER = ORIGINAL_BROWSERCTL_BROWSER;
-  }
-});
-
-beforeEach(() => {
-  delete process.env.BROWSERCTL_AUTH_TOKEN;
-  delete process.env.BROWSERCTL_BROWSER;
-});
-
-describe("cli dispatch matrix", () => {
-  it.each(COMMAND_DISPATCH_CASES)(
-    "dispatches $command to $handlerName",
-    async ({ command, commandArgs, moduleRef, handlerName }) => {
-      const handler = moduleRef[handlerName] as ((args: string[]) => Promise<unknown>) | undefined;
-      if (typeof handler !== "function") {
-        throw new Error(`Expected ${handlerName} to be a function.`);
-      }
-
-      const handlerSpy = vi.spyOn(moduleRef as Record<string, (...args: unknown[]) => unknown>, handlerName)
-        .mockResolvedValue({ ok: true });
-      const { io, state } = createIoCapture();
-
-      const exitCode = await runCli([command, ...commandArgs], io);
-
-      expect(exitCode).toBe(EXIT_CODES.OK);
-      expect(state.stderr).toBe("");
-      expect(state.stdout).toMatch(new RegExp(`^${command}: `));
-      expect(handlerSpy).toHaveBeenCalledTimes(1);
-      expect(handlerSpy).toHaveBeenCalledWith(commandArgs);
-    }
-  );
-
-  it("dispatches daemon-stop through daemon client", async () => {
-    const stopSpy = vi.spyOn(daemonClient, "stopDaemon").mockResolvedValue({
-      stopped: true,
-      port: 41337,
-      pid: 12345
-    });
-    const { io, state } = createIoCapture();
-
-    const exitCode = await runCli(["daemon-stop", "--json"], io);
-
-    expect(exitCode).toBe(EXIT_CODES.OK);
-    expect(stopSpy).toHaveBeenCalledTimes(1);
-    expect(JSON.parse(state.stdout)).toEqual({
-      ok: true,
-      command: "daemon-stop",
-      data: {
-        stopped: true,
-        port: 41337,
-        pid: 12345
-      }
-    });
-  });
-
-  it.each(MEMORY_DISPATCH_CASES)(
-    "dispatches $command to $expectedTool",
-    async ({ command, commandArgs, expectedTool, expectedArgs }) => {
-      const callDaemonToolSpy = vi.spyOn(daemonClient, "callDaemonTool").mockResolvedValue({
-        ok: true
-      });
-      const { io, state } = createIoCapture();
-
-      const exitCode = await runCli([command, ...commandArgs, "--json"], io);
-
-      expect(exitCode).toBe(EXIT_CODES.OK);
-      expect(state.stderr).toBe("");
-      expect(callDaemonToolSpy).toHaveBeenCalledTimes(1);
-      expect(callDaemonToolSpy).toHaveBeenCalledWith(expectedTool, expectedArgs);
-      expect(JSON.parse(state.stdout)).toEqual({
-        ok: true,
-        command,
-        data: {
-          ok: true
-        }
-      });
-    }
-  );
-});