@flrande/browserctl 0.5.0 → 0.6.0

package/apps/browserctl/src/commands/common.test.ts

@@ -1,87 +0,0 @@
-import { afterEach, describe, expect, it } from "vitest";
-
-import {
-  DAEMON_STARTUP_ARGUMENT,
-  buildToolArguments,
-  parseCommandContext
-} from "./common";
-
-const ORIGINAL_AUTH_TOKEN = process.env.BROWSERCTL_AUTH_TOKEN;
-const ORIGINAL_BROWSER = process.env.BROWSERCTL_BROWSER;
-
-afterEach(() => {
-  if (ORIGINAL_AUTH_TOKEN === undefined) {
-    delete process.env.BROWSERCTL_AUTH_TOKEN;
-  } else {
-    process.env.BROWSERCTL_AUTH_TOKEN = ORIGINAL_AUTH_TOKEN;
-  }
-
-  if (ORIGINAL_BROWSER === undefined) {
-    delete process.env.BROWSERCTL_BROWSER;
-    return;
-  }
-
-  process.env.BROWSERCTL_BROWSER = ORIGINAL_BROWSER;
-});
-
-describe("parseCommandContext", () => {
-  it("uses BROWSERCTL_AUTH_TOKEN by default", () => {
-    process.env.BROWSERCTL_AUTH_TOKEN = "env-token";
-
-    const context = parseCommandContext(["target:1"]);
-
-    expect(context.authToken).toBe("env-token");
-    expect(context.positional).toEqual(["target:1"]);
-  });
-
-  it("allows --token to override the environment token", () => {
-    process.env.BROWSERCTL_AUTH_TOKEN = "env-token";
-
-    const context = parseCommandContext(["--token", "cli-token", "target:1"]);
-
-    expect(context.authToken).toBe("cli-token");
-    expect(context.positional).toEqual(["target:1"]);
-  });
-
-  it("throws when --token is missing a value", () => {
-    expect(() => parseCommandContext(["--token"])).toThrow("Missing value for --token.");
-  });
-
-  it("supports --browser edge preset and forwards daemon startup metadata", () => {
-    const context = parseCommandContext(["--browser", "edge", "target:1"]);
-
-    expect(context.daemonStartup).toEqual({
-      managedLocal: {
-        browserName: "chromium",
-        channel: "msedge"
-      }
-    });
-    expect(buildToolArguments(context)).toMatchObject({
-      [DAEMON_STARTUP_ARGUMENT]: {
-        managedLocal: {
-          browserName: "chromium",
-          channel: "msedge"
-        }
-      }
-    });
-  });
-
-  it("supports BROWSERCTL_BROWSER env preset", () => {
-    process.env.BROWSERCTL_BROWSER = "edge";
-
-    const context = parseCommandContext(["target:1"]);
-
-    expect(context.daemonStartup).toEqual({
-      managedLocal: {
-        browserName: "chromium",
-        channel: "msedge"
-      }
-    });
-  });
-
-  it("throws on unsupported --browser values", () => {
-    expect(() => parseCommandContext(["--browser", "opera"])).toThrow(
-      "Invalid value for --browser: opera. Supported values: chromium, chrome, edge."
-    );
-  });
-});

package/apps/browserctl/src/commands/common.ts

@@ -1,191 +0,0 @@
-export type ManagedLocalBrowserPreset = "chromium" | "chrome" | "edge";
-
-export type DaemonStartupConfig = {
-  managedLocal: {
-    browserName: "chromium";
-    channel?: string;
-  };
-};
-
-export type CommandContext = {
-  sessionId: string;
-  profile?: string;
-  authToken?: string;
-  daemonStartup?: DaemonStartupConfig;
-  positional: string[];
-};
-
-export const DAEMON_STARTUP_ARGUMENT = "__browserctlDaemonStartup";
-
-const DEFAULT_SESSION_ID = "cli:local";
-const SUPPORTED_BROWSER_PRESETS = new Set<ManagedLocalBrowserPreset>([
-  "chromium",
-  "chrome",
-  "edge"
-]);
-
-function resolveAuthToken(value: string | undefined): string | undefined {
-  if (value === undefined) {
-    return undefined;
-  }
-
-  const trimmedValue = value.trim();
-  return trimmedValue.length > 0 ? trimmedValue : undefined;
-}
-
-function requireValue(args: string[], index: number, option: string): string {
-  const value = args[index + 1];
-  if (value === undefined || value.startsWith("--")) {
-    throw new Error(`Missing value for ${option}.`);
-  }
-
-  return value;
-}
-
-function parseBrowserPreset(
-  value: string | undefined,
-  optionName: string
-): ManagedLocalBrowserPreset | undefined {
-  if (value === undefined) {
-    return undefined;
-  }
-
-  const normalizedValue = value.trim().toLowerCase();
-  if (normalizedValue.length === 0) {
-    return undefined;
-  }
-
-  if (SUPPORTED_BROWSER_PRESETS.has(normalizedValue as ManagedLocalBrowserPreset)) {
-    return normalizedValue as ManagedLocalBrowserPreset;
-  }
-
-  throw new Error(
-    `Invalid value for ${optionName}: ${value}. Supported values: chromium, chrome, edge.`
-  );
-}
-
-function resolveDaemonStartupConfig(
-  browserPreset: ManagedLocalBrowserPreset | undefined
-): DaemonStartupConfig | undefined {
-  if (browserPreset === undefined) {
-    return undefined;
-  }
-
-  if (browserPreset === "edge") {
-    return {
-      managedLocal: {
-        browserName: "chromium",
-        channel: "msedge"
-      }
-    };
-  }
-
-  if (browserPreset === "chrome") {
-    return {
-      managedLocal: {
-        browserName: "chromium",
-        channel: "chrome"
-      }
-    };
-  }
-
-  return {
-    managedLocal: {
-      browserName: "chromium"
-    }
-  };
-}
-
-export function parseCommandContext(args: string[]): CommandContext {
-  const positional: string[] = [];
-  let sessionId = DEFAULT_SESSION_ID;
-  let profile: string | undefined;
-  let authToken = resolveAuthToken(process.env.BROWSERCTL_AUTH_TOKEN);
-  let browserPreset = parseBrowserPreset(process.env.BROWSERCTL_BROWSER, "BROWSERCTL_BROWSER");
-
-  for (let index = 0; index < args.length; index += 1) {
-    const token = args[index];
-
-    if (token === "--session") {
-      sessionId = requireValue(args, index, "--session");
-      index += 1;
-      continue;
-    }
-
-    if (token === "--profile") {
-      profile = requireValue(args, index, "--profile");
-      index += 1;
-      continue;
-    }
-
-    if (token === "--token") {
-      authToken = resolveAuthToken(requireValue(args, index, "--token"));
-      if (authToken === undefined) {
-        throw new Error("Missing value for --token.");
-      }
-
-      index += 1;
-      continue;
-    }
-
-    if (token === "--browser") {
-      browserPreset = parseBrowserPreset(requireValue(args, index, "--browser"), "--browser");
-      index += 1;
-      continue;
-    }
-
-    if (token === "--") {
-      positional.push(...args.slice(index + 1));
-      break;
-    }
-
-    positional.push(token);
-  }
-
-  return {
-    sessionId,
-    profile,
-    authToken,
-    daemonStartup: resolveDaemonStartupConfig(browserPreset),
-    positional
-  };
-}
-
-export function buildToolArguments(
-  context: CommandContext,
-  args: Record<string, unknown> = {}
-): Record<string, unknown> {
-  const baseArguments: Record<string, unknown> = {
-    sessionId: context.sessionId
-  };
-
-  if (context.profile !== undefined) {
-    baseArguments.profile = context.profile;
-  }
-
-  if (context.authToken !== undefined) {
-    baseArguments.authToken = context.authToken;
-  }
-
-  if (context.daemonStartup !== undefined) {
-    baseArguments[DAEMON_STARTUP_ARGUMENT] = context.daemonStartup;
-  }
-
-  return {
-    ...baseArguments,
-    ...args
-  };
-}
-
-export function requirePositionalArg(
-  context: CommandContext,
-  index: number,
-  name: string
-): string {
-  const value = context.positional[index];
-  if (value === undefined) {
-    throw new Error(`Missing required argument: ${name}.`);
-  }
-
-  return value;
-}

package/apps/browserctl/src/commands/console-list.test.ts

@@ -1,102 +0,0 @@
-import { afterEach, describe, expect, it, vi } from "vitest";
-
-const { callDaemonToolMock } = vi.hoisted(() => ({
-  callDaemonToolMock: vi.fn()
-}));
-
-vi.mock("../daemon-client", () => ({
-  callDaemonTool: callDaemonToolMock
-}));
-
-import { runConsoleListCommand } from "./console-list";
-
-afterEach(() => {
-  callDaemonToolMock.mockReset();
-});
-
-describe("runConsoleListCommand", () => {
-  it("forwards filter options", async () => {
-    callDaemonToolMock.mockResolvedValue({ ok: true });
-
-    await runConsoleListCommand([
-      "target:1",
-      "--type",
-      "error",
-      "--contains",
-      "timeout",
-      "--since",
-      "2026-01-01T00:00:00.000Z",
-      "--limit",
-      "20"
-    ]);
-
-    expect(callDaemonToolMock).toHaveBeenCalledTimes(1);
-    expect(callDaemonToolMock).toHaveBeenCalledWith("browser.console.list", {
-      sessionId: "cli:local",
-      targetId: "target:1",
-      type: "error",
-      contains: "timeout",
-      since: "2026-01-01T00:00:00.000Z",
-      limit: 20
-    });
-  });
-
-  it.each([
-    {
-      label: "--type",
-      args: ["target:1", "--type"],
-      message: "Missing value for --type."
-    },
-    {
-      label: "--contains",
-      args: ["target:1", "--contains"],
-      message: "Missing value for --contains."
-    },
-    {
-      label: "--since",
-      args: ["target:1", "--since"],
-      message: "Missing value for --since."
-    },
-    {
-      label: "--limit",
-      args: ["target:1", "--limit"],
-      message: "Missing value for --limit."
-    }
-  ])("throws when $label is missing a value", async ({ args, message }) => {
-    await expect(runConsoleListCommand(args)).rejects.toThrow(message);
-    expect(callDaemonToolMock).not.toHaveBeenCalled();
-  });
-
-  it.each([
-    {
-      label: "empty --type",
-      args: ["target:1", "--type", " "],
-      message: "--type must be a non-empty string."
-    },
-    {
-      label: "empty --contains",
-      args: ["target:1", "--contains", " "],
-      message: "--contains must be a non-empty string."
-    },
-    {
-      label: "invalid --limit",
-      args: ["target:1", "--limit", "0"],
-      message: "--limit must be a positive integer."
-    },
-    {
-      label: "non-strict --limit text",
-      args: ["target:1", "--limit", "20rows"],
-      message: "--limit must be a positive integer."
-    }
-  ])("throws on invalid option value: $label", async ({ args, message }) => {
-    await expect(runConsoleListCommand(args)).rejects.toThrow(message);
-    expect(callDaemonToolMock).not.toHaveBeenCalled();
-  });
-
-  it("throws on unknown option token", async () => {
-    await expect(runConsoleListCommand(["target:1", "--unknown"]))
-      .rejects.toThrow("Unknown console-list option: --unknown");
-
-    expect(callDaemonToolMock).not.toHaveBeenCalled();
-  });
-});

package/apps/browserctl/src/commands/console-list.ts

@@ -1,108 +0,0 @@
-import { callDaemonTool } from "../daemon-client";
-import { buildToolArguments, parseCommandContext, requirePositionalArg } from "./common";
-
-export type ConsoleListCommandResult = {
-  driver: string;
-  targetId: string;
-  entries: unknown[];
-};
-
-function parsePositiveInteger(value: string, optionName: string): number {
-  const normalized = value.trim();
-  if (!/^[1-9]\d*$/.test(normalized)) {
-    throw new Error(`${optionName} must be a positive integer.`);
-  }
-
-  return Number.parseInt(normalized, 10);
-}
-
-function parseConsoleOptions(tokens: string[]): {
-  type?: string;
-  contains?: string;
-  since?: string;
-  limit?: number;
-} {
-  let type: string | undefined;
-  let contains: string | undefined;
-  let since: string | undefined;
-  let limit: number | undefined;
-
-  for (let index = 0; index < tokens.length; index += 1) {
-    const token = tokens[index];
-
-    if (token === "--type") {
-      const value = tokens[index + 1];
-      if (value === undefined) {
-        throw new Error("Missing value for --type.");
-      }
-      const trimmed = value.trim();
-      if (trimmed.length === 0) {
-        throw new Error("--type must be a non-empty string.");
-      }
-      type = trimmed;
-      index += 1;
-      continue;
-    }
-
-    if (token === "--contains") {
-      const value = tokens[index + 1];
-      if (value === undefined) {
-        throw new Error("Missing value for --contains.");
-      }
-      const trimmed = value.trim();
-      if (trimmed.length === 0) {
-        throw new Error("--contains must be a non-empty string.");
-      }
-      contains = trimmed;
-      index += 1;
-      continue;
-    }
-
-    if (token === "--since") {
-      const value = tokens[index + 1];
-      if (value === undefined) {
-        throw new Error("Missing value for --since.");
-      }
-      const trimmed = value.trim();
-      if (trimmed.length === 0) {
-        throw new Error("--since must be a non-empty ISO timestamp.");
-      }
-      since = trimmed;
-      index += 1;
-      continue;
-    }
-
-    if (token === "--limit") {
-      const value = tokens[index + 1];
-      if (value === undefined) {
-        throw new Error("Missing value for --limit.");
-      }
-      limit = parsePositiveInteger(value, "--limit");
-      index += 1;
-      continue;
-    }
-
-    throw new Error(`Unknown console-list option: ${token}`);
-  }
-
-  return {
-    ...(type !== undefined ? { type } : {}),
-    ...(contains !== undefined ? { contains } : {}),
-    ...(since !== undefined ? { since } : {}),
-    ...(limit !== undefined ? { limit } : {})
-  };
-}
-
-export async function runConsoleListCommand(args: string[]): Promise<ConsoleListCommandResult> {
-  const context = parseCommandContext(args);
-  const targetId = requirePositionalArg(context, 0, "targetId");
-  const options = parseConsoleOptions(context.positional.slice(1));
-
-  return await callDaemonTool<ConsoleListCommandResult>(
-    "browser.console.list",
-    buildToolArguments(context, {
-      targetId,
-      ...options
-    })
-  );
-}

package/apps/browserctl/src/commands/cookie-clear.ts

@@ -1,18 +0,0 @@
-import { callDaemonTool } from "../daemon-client";
-import { buildToolArguments, parseCommandContext, requirePositionalArg } from "./common";
-
-export type CookieClearCommandResult = Record<string, unknown>;
-
-export async function runCookieClearCommand(args: string[]): Promise<CookieClearCommandResult> {
-  const context = parseCommandContext(args);
-  const targetId = requirePositionalArg(context, 0, "targetId");
-  const name = context.positional[1];
-
-  return await callDaemonTool<CookieClearCommandResult>(
-    "browser.cookie.clear",
-    buildToolArguments(context, {
-      targetId,
-      ...(typeof name === "string" && name.trim().length > 0 ? { name: name.trim() } : {})
-    })
-  );
-}

package/apps/browserctl/src/commands/cookie-get.ts

@@ -1,18 +0,0 @@
-import { callDaemonTool } from "../daemon-client";
-import { buildToolArguments, parseCommandContext, requirePositionalArg } from "./common";
-
-export type CookieGetCommandResult = Record<string, unknown>;
-
-export async function runCookieGetCommand(args: string[]): Promise<CookieGetCommandResult> {
-  const context = parseCommandContext(args);
-  const targetId = requirePositionalArg(context, 0, "targetId");
-  const name = context.positional[1];
-
-  return await callDaemonTool<CookieGetCommandResult>(
-    "browser.cookie.get",
-    buildToolArguments(context, {
-      targetId,
-      ...(typeof name === "string" && name.trim().length > 0 ? { name: name.trim() } : {})
-    })
-  );
-}

package/apps/browserctl/src/commands/cookie-set.ts

@@ -1,22 +0,0 @@
-import { callDaemonTool } from "../daemon-client";
-import { buildToolArguments, parseCommandContext, requirePositionalArg } from "./common";
-
-export type CookieSetCommandResult = Record<string, unknown>;
-
-export async function runCookieSetCommand(args: string[]): Promise<CookieSetCommandResult> {
-  const context = parseCommandContext(args);
-  const targetId = requirePositionalArg(context, 0, "targetId");
-  const name = requirePositionalArg(context, 1, "name");
-  const value = requirePositionalArg(context, 2, "value");
-  const url = context.positional[3];
-
-  return await callDaemonTool<CookieSetCommandResult>(
-    "browser.cookie.set",
-    buildToolArguments(context, {
-      targetId,
-      name,
-      value,
-      ...(typeof url === "string" && url.trim().length > 0 ? { url: url.trim() } : {})
-    })
-  );
-}

package/apps/browserctl/src/commands/dialog-arm.ts

@@ -1,20 +0,0 @@
-import { callDaemonTool } from "../daemon-client";
-import { buildToolArguments, parseCommandContext, requirePositionalArg } from "./common";
-
-export type DialogArmCommandResult = {
-  driver: string;
-  targetId: string;
-  armed: boolean;
-};
-
-export async function runDialogArmCommand(args: string[]): Promise<DialogArmCommandResult> {
-  const context = parseCommandContext(args);
-  const targetId = requirePositionalArg(context, 0, "targetId");
-
-  return await callDaemonTool<DialogArmCommandResult>(
-    "browser.dialog.arm",
-    buildToolArguments(context, {
-      targetId
-    })
-  );
-}

package/apps/browserctl/src/commands/dom-query-all.ts

@@ -1,18 +0,0 @@
-import { callDaemonTool } from "../daemon-client";
-import { buildToolArguments, parseCommandContext, requirePositionalArg } from "./common";
-
-export type DomQueryAllCommandResult = Record<string, unknown>;
-
-export async function runDomQueryAllCommand(args: string[]): Promise<DomQueryAllCommandResult> {
-  const context = parseCommandContext(args);
-  const targetId = requirePositionalArg(context, 0, "targetId");
-  const selector = requirePositionalArg(context, 1, "selector");
-
-  return await callDaemonTool<DomQueryAllCommandResult>(
-    "browser.dom.queryAll",
-    buildToolArguments(context, {
-      targetId,
-      selector
-    })
-  );
-}

package/apps/browserctl/src/commands/dom-query.ts

@@ -1,18 +0,0 @@
-import { callDaemonTool } from "../daemon-client";
-import { buildToolArguments, parseCommandContext, requirePositionalArg } from "./common";
-
-export type DomQueryCommandResult = Record<string, unknown>;
-
-export async function runDomQueryCommand(args: string[]): Promise<DomQueryCommandResult> {
-  const context = parseCommandContext(args);
-  const targetId = requirePositionalArg(context, 0, "targetId");
-  const selector = requirePositionalArg(context, 1, "selector");
-
-  return await callDaemonTool<DomQueryCommandResult>(
-    "browser.dom.query",
-    buildToolArguments(context, {
-      targetId,
-      selector
-    })
-  );
-}

package/apps/browserctl/src/commands/download-trigger.ts

@@ -1,22 +0,0 @@
-import { callDaemonTool } from "../daemon-client";
-import { buildToolArguments, parseCommandContext, requirePositionalArg } from "./common";
-
-export type DownloadTriggerCommandResult = {
-  driver: string;
-  targetId: string;
-  triggered: boolean;
-};
-
-export async function runDownloadTriggerCommand(
-  args: string[]
-): Promise<DownloadTriggerCommandResult> {
-  const context = parseCommandContext(args);
-  const targetId = requirePositionalArg(context, 0, "targetId");
-
-  return await callDaemonTool<DownloadTriggerCommandResult>(
-    "browser.download.trigger",
-    buildToolArguments(context, {
-      targetId
-    })
-  );
-}

package/apps/browserctl/src/commands/download-wait.test.ts

@@ -1,67 +0,0 @@
-import { afterEach, describe, expect, it, vi } from "vitest";
-
-const { callDaemonToolMock } = vi.hoisted(() => ({
-  callDaemonToolMock: vi.fn()
-}));
-
-vi.mock("../daemon-client", () => ({
-  callDaemonTool: callDaemonToolMock
-}));
-
-import { runDownloadWaitCommand } from "./download-wait";
-
-const ORIGINAL_AUTH_TOKEN = process.env.BROWSERCTL_AUTH_TOKEN;
-
-afterEach(() => {
-  callDaemonToolMock.mockReset();
-
-  if (ORIGINAL_AUTH_TOKEN === undefined) {
-    delete process.env.BROWSERCTL_AUTH_TOKEN;
-    return;
-  }
-
-  process.env.BROWSERCTL_AUTH_TOKEN = ORIGINAL_AUTH_TOKEN;
-});
-
-describe("runDownloadWaitCommand", () => {
-  it("forwards optional download path when provided", async () => {
-    callDaemonToolMock.mockResolvedValue({
-      driver: "managed",
-      targetId: "target:1",
-      download: {}
-    });
-
-    await runDownloadWaitCommand(["target:1", "downloads/file.bin"]);
-
-    expect(callDaemonToolMock).toHaveBeenCalledTimes(1);
-    expect(callDaemonToolMock).toHaveBeenCalledWith(
-      "browser.download.wait",
-      expect.objectContaining({
-        sessionId: "cli:local",
-        targetId: "target:1",
-        path: "downloads/file.bin"
-      })
-    );
-  });
-
-  it("uses --token over environment token", async () => {
-    process.env.BROWSERCTL_AUTH_TOKEN = "env-token";
-    callDaemonToolMock.mockResolvedValue({
-      driver: "managed",
-      targetId: "target:1",
-      download: {}
-    });
-
-    await runDownloadWaitCommand(["--token", "cli-token", "target:1"]);
-
-    expect(callDaemonToolMock).toHaveBeenCalledTimes(1);
-    expect(callDaemonToolMock).toHaveBeenCalledWith(
-      "browser.download.wait",
-      expect.objectContaining({
-        sessionId: "cli:local",
-        targetId: "target:1",
-        authToken: "cli-token"
-      })
-    );
-  });
-});