npm - @flrande/browserctl - Versions diffs - 0.5.0 → 0.6.0 - Mend

@flrande/browserctl 0.5.0 → 0.6.0

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 (136) hide show

package/dist/client.d.ts +34 -0
package/dist/client.js +138 -0
package/dist/commandRegistry.d.ts +16 -0
package/dist/commandRegistry.js +21 -0
package/dist/help.d.ts +4 -0
package/dist/help.js +24 -0
package/dist/index.d.ts +3 -0
package/dist/index.js +23 -0
package/dist/runCli.d.ts +5 -0
package/dist/runCli.js +170 -0
package/package.json +32 -57
package/INSTALL-CN.md +0 -92
package/INSTALL.md +0 -92
package/LICENSE +0 -21
package/README-CN.md +0 -69
package/README.md +0 -69
package/apps/browserctl/src/commands/a11y-snapshot.ts +0 -20
package/apps/browserctl/src/commands/act.test.ts +0 -71
package/apps/browserctl/src/commands/act.ts +0 -64
package/apps/browserctl/src/commands/command-wrappers.test.ts +0 -688
package/apps/browserctl/src/commands/common.test.ts +0 -87
package/apps/browserctl/src/commands/common.ts +0 -191
package/apps/browserctl/src/commands/console-list.test.ts +0 -102
package/apps/browserctl/src/commands/console-list.ts +0 -108
package/apps/browserctl/src/commands/cookie-clear.ts +0 -18
package/apps/browserctl/src/commands/cookie-get.ts +0 -18
package/apps/browserctl/src/commands/cookie-set.ts +0 -22
package/apps/browserctl/src/commands/dialog-arm.ts +0 -20
package/apps/browserctl/src/commands/dom-query-all.ts +0 -18
package/apps/browserctl/src/commands/dom-query.ts +0 -18
package/apps/browserctl/src/commands/download-trigger.ts +0 -22
package/apps/browserctl/src/commands/download-wait.test.ts +0 -67
package/apps/browserctl/src/commands/download-wait.ts +0 -27
package/apps/browserctl/src/commands/element-screenshot.ts +0 -20
package/apps/browserctl/src/commands/frame-list.ts +0 -16
package/apps/browserctl/src/commands/frame-snapshot.ts +0 -18
package/apps/browserctl/src/commands/har-export.test.ts +0 -112
package/apps/browserctl/src/commands/har-export.ts +0 -120
package/apps/browserctl/src/commands/memory-delete.ts +0 -20
package/apps/browserctl/src/commands/memory-inspect.ts +0 -20
package/apps/browserctl/src/commands/memory-list.ts +0 -90
package/apps/browserctl/src/commands/memory-mode-set.ts +0 -29
package/apps/browserctl/src/commands/memory-purge.ts +0 -16
package/apps/browserctl/src/commands/memory-resolve.ts +0 -56
package/apps/browserctl/src/commands/memory-status.ts +0 -16
package/apps/browserctl/src/commands/memory-ttl-set.ts +0 -28
package/apps/browserctl/src/commands/memory-upsert.ts +0 -142
package/apps/browserctl/src/commands/network-list.test.ts +0 -110
package/apps/browserctl/src/commands/network-list.ts +0 -112
package/apps/browserctl/src/commands/network-wait-for.test.ts +0 -90
package/apps/browserctl/src/commands/network-wait-for.ts +0 -100
package/apps/browserctl/src/commands/profile-list.ts +0 -16
package/apps/browserctl/src/commands/profile-use.ts +0 -18
package/apps/browserctl/src/commands/response-body.ts +0 -24
package/apps/browserctl/src/commands/screenshot.ts +0 -16
package/apps/browserctl/src/commands/session-drop.test.ts +0 -36
package/apps/browserctl/src/commands/session-drop.ts +0 -16
package/apps/browserctl/src/commands/session-list.test.ts +0 -81
package/apps/browserctl/src/commands/session-list.ts +0 -70
package/apps/browserctl/src/commands/snapshot.ts +0 -16
package/apps/browserctl/src/commands/status.ts +0 -10
package/apps/browserctl/src/commands/storage-get.ts +0 -20
package/apps/browserctl/src/commands/storage-set.ts +0 -22
package/apps/browserctl/src/commands/tab-close.ts +0 -20
package/apps/browserctl/src/commands/tab-focus.ts +0 -20
package/apps/browserctl/src/commands/tab-open.ts +0 -19
package/apps/browserctl/src/commands/tabs.ts +0 -13
package/apps/browserctl/src/commands/trace-get.test.ts +0 -61
package/apps/browserctl/src/commands/trace-get.ts +0 -62
package/apps/browserctl/src/commands/upload-arm.ts +0 -26
package/apps/browserctl/src/commands/wait-element.test.ts +0 -80
package/apps/browserctl/src/commands/wait-element.ts +0 -76
package/apps/browserctl/src/commands/wait-text.test.ts +0 -110
package/apps/browserctl/src/commands/wait-text.ts +0 -93
package/apps/browserctl/src/commands/wait-url.test.ts +0 -80
package/apps/browserctl/src/commands/wait-url.ts +0 -76
package/apps/browserctl/src/daemon-client.test.ts +0 -253
package/apps/browserctl/src/daemon-client.ts +0 -632
package/apps/browserctl/src/e2e.test.ts +0 -103
package/apps/browserctl/src/main.dispatch.test.ts +0 -461
package/apps/browserctl/src/main.test.ts +0 -334
package/apps/browserctl/src/main.ts +0 -957
package/apps/browserctl/src/smoke.e2e.test.ts +0 -97
package/apps/browserctl/src/test-port.ts +0 -26
package/apps/browserd/src/bootstrap.ts +0 -432
package/apps/browserd/src/chrome-relay-extension-bridge.test.ts +0 -250
package/apps/browserd/src/chrome-relay-extension-bridge.ts +0 -506
package/apps/browserd/src/container.ts +0 -3088
package/apps/browserd/src/main.test.ts +0 -1436
package/apps/browserd/src/main.ts +0 -7
package/apps/browserd/src/test-port.ts +0 -26
package/apps/browserd/src/tool-matrix.test.ts +0 -887
package/bin/browserctl.cjs +0 -21
package/bin/browserd.cjs +0 -21
package/extensions/chrome-relay/README-CN.md +0 -39
package/extensions/chrome-relay/README.md +0 -39
package/extensions/chrome-relay/background.js +0 -1687
package/extensions/chrome-relay/manifest.json +0 -15
package/extensions/chrome-relay/popup.html +0 -369
package/extensions/chrome-relay/popup.js +0 -972
package/packages/core/src/bootstrap.test.ts +0 -10
package/packages/core/src/driver-registry.test.ts +0 -45
package/packages/core/src/driver-registry.ts +0 -22
package/packages/core/src/driver.ts +0 -47
package/packages/core/src/index.ts +0 -6
package/packages/core/src/navigation-memory.test.ts +0 -259
package/packages/core/src/navigation-memory.ts +0 -360
package/packages/core/src/ref-cache.test.ts +0 -61
package/packages/core/src/ref-cache.ts +0 -28
package/packages/core/src/session-store.test.ts +0 -82
package/packages/core/src/session-store.ts +0 -138
package/packages/core/src/types.ts +0 -9
package/packages/driver-chrome-relay/src/chrome-relay-driver.test.ts +0 -744
package/packages/driver-chrome-relay/src/chrome-relay-driver.ts +0 -2429
package/packages/driver-chrome-relay/src/chrome-relay-extension-runtime.test.ts +0 -264
package/packages/driver-chrome-relay/src/chrome-relay-extension-runtime.ts +0 -521
package/packages/driver-chrome-relay/src/index.ts +0 -26
package/packages/driver-managed/src/index.ts +0 -22
package/packages/driver-managed/src/managed-driver.test.ts +0 -183
package/packages/driver-managed/src/managed-driver.ts +0 -341
package/packages/driver-managed/src/managed-local-driver.test.ts +0 -608
package/packages/driver-managed/src/managed-local-driver.ts +0 -2243
package/packages/driver-remote-cdp/src/index.ts +0 -19
package/packages/driver-remote-cdp/src/remote-cdp-driver.test.ts +0 -727
package/packages/driver-remote-cdp/src/remote-cdp-driver.ts +0 -2264
package/packages/protocol/src/envelope.test.ts +0 -25
package/packages/protocol/src/envelope.ts +0 -31
package/packages/protocol/src/errors.test.ts +0 -17
package/packages/protocol/src/errors.ts +0 -11
package/packages/protocol/src/index.ts +0 -3
package/packages/protocol/src/tools.ts +0 -3
package/packages/transport-mcp-stdio/src/index.ts +0 -3
package/packages/transport-mcp-stdio/src/sdk-server.ts +0 -139
package/packages/transport-mcp-stdio/src/server.test.ts +0 -281
package/packages/transport-mcp-stdio/src/server.ts +0 -183
package/packages/transport-mcp-stdio/src/tool-map.ts +0 -84

package/packages/driver-managed/src/managed-driver.test.ts DELETED Viewed

@@ -1,183 +0,0 @@
-import { once } from "node:events";
-import { createServer, type IncomingMessage, type ServerResponse } from "node:http";
-import type { AddressInfo } from "node:net";
-import { describe, expect, it } from "vitest";
-import { createManagedDriver } from "./index";
-describe("createManagedDriver", () => {
-  it("returns status with managed kind", async () => {
-    const driver = createManagedDriver();
-    const status = await driver.status();
-    expect(status.kind).toBe("managed");
-  });
-  it("openTab creates a target and listTabs reflects it", async () => {
-    const driver = createManagedDriver();
-    expect(await driver.listTabs()).toEqual([]);
-    const firstTarget = await driver.openTab("https://example.com/a");
-    const secondTarget = await driver.openTab("https://example.com/b");
-    expect(firstTarget).not.toBe(secondTarget);
-    expect(await driver.listTabs()).toEqual([firstTarget, secondTarget]);
-  });
-  it("closeTab removes the target from listTabs", async () => {
-    const driver = createManagedDriver();
-    const firstTarget = await driver.openTab("https://example.com/a");
-    const secondTarget = await driver.openTab("https://example.com/b");
-    await driver.closeTab(firstTarget);
-    expect(await driver.listTabs()).toEqual([secondTarget]);
-  });
-  it("isolates tabs by profile", async () => {
-    const driver = createManagedDriver();
-    const alphaProfile = "profile:alpha";
-    const betaProfile = "profile:beta";
-    const alphaTarget = await driver.openTab("https://example.com/alpha", alphaProfile);
-    const betaTarget = await driver.openTab("https://example.com/beta", betaProfile);
-    expect(await driver.listTabs(alphaProfile)).toEqual([alphaTarget]);
-    expect(await driver.listTabs(betaProfile)).toEqual([betaTarget]);
-    expect(await driver.listTabs(alphaProfile)).not.toContain(betaTarget);
-    expect(await driver.listTabs(betaProfile)).not.toContain(alphaTarget);
-  });
-  it("focusTab uses targetId within the selected profile", async () => {
-    const driver = createManagedDriver();
-    const profile = "profile:alpha";
-    const target = await driver.openTab("https://example.com/alpha", profile);
-    await expect(driver.focusTab(target, profile)).resolves.toBeUndefined();
-    await expect(driver.focusTab(target, "profile:beta")).rejects.toThrowError(
-      `Unknown targetId: ${target} (profile: profile:beta)`
-    );
-  });
-  it("tracks local URL/html state for navigate/login/download flows", async () => {
-    function sendHtml(response: ServerResponse, route: string): void {
-      response.statusCode = 200;
-      response.setHeader("content-type", "text/html; charset=utf-8");
-      response.end(`<!doctype html><h1>Mock</h1><p>Route: ${route}</p>`);
-    }
-    const server = createServer((request: IncomingMessage, response: ServerResponse) => {
-      if (request.url === "/app" && request.method === "GET") {
-        sendHtml(response, "/app");
-        return;
-      }
-      if (request.url === "/app/cart" && request.method === "GET") {
-        sendHtml(response, "/app/cart");
-        return;
-      }
-      if (request.url === "/api/login" && request.method === "POST") {
-        response.statusCode = 200;
-        response.setHeader("set-cookie", "mock_session=test; Path=/; HttpOnly");
-        response.setHeader("content-type", "application/json; charset=utf-8");
-        response.end(JSON.stringify({ ok: true }));
-        return;
-      }
-      if (request.url === "/download/orders.csv" && request.method === "GET") {
-        response.statusCode = 200;
-        response.setHeader("content-type", "text/csv; charset=utf-8");
-        response.end("order_id,total\n1,42\n");
-        return;
-      }
-      response.statusCode = 404;
-      response.end("not-found");
-    });
-    server.listen(0, "127.0.0.1");
-    await once(server, "listening");
-    const address = server.address();
-    if (address === null || typeof address === "string") {
-      throw new Error("Expected server address info to be available.");
-    }
-    const baseUrl = `http://127.0.0.1:${(address as AddressInfo).port}`;
-    const driver = createManagedDriver();
-    try {
-      const targetId = await driver.openTab(`${baseUrl}/app`);
-      const initialSnapshot = await driver.snapshot(targetId);
-      expect(initialSnapshot).toMatchObject({
-        hasTarget: true,
-        url: `${baseUrl}/app`
-      });
-      expect(initialSnapshot).toMatchObject({
-        html: expect.stringContaining("Route: /app")
-      });
-      const loginResult = await driver.act(
-        {
-          type: "login",
-          payload: { path: "/api/login" }
-        },
-        targetId
-      );
-      expect(loginResult).toMatchObject({
-        actionType: "login",
-        targetKnown: true,
-        ok: true,
-        executed: true
-      });
-      const navigateResult = await driver.act(
-        {
-          type: "navigate",
-          payload: { path: "/app/cart" }
-        },
-        targetId
-      );
-      expect(navigateResult).toMatchObject({
-        actionType: "navigate",
-        targetKnown: true,
-        ok: true,
-        executed: true
-      });
-      const postNavigateSnapshot = await driver.snapshot(targetId);
-      expect(postNavigateSnapshot).toMatchObject({
-        hasTarget: true,
-        url: `${baseUrl}/app/cart`
-      });
-      expect(postNavigateSnapshot).toMatchObject({
-        html: expect.stringContaining("Route: /app/cart")
-      });
-      const prepareDownloadResult = await driver.act(
-        {
-          type: "prepare-download",
-          payload: { path: "/download/orders.csv" }
-        },
-        targetId
-      );
-      expect(prepareDownloadResult).toMatchObject({
-        actionType: "prepare-download",
-        targetKnown: true,
-        ok: true,
-        executed: true
-      });
-      await expect(
-        driver.waitDownload(targetId, undefined, "C:\\downloads\\orders.csv")
-      ).resolves.toEqual({
-        path: "C:\\downloads\\orders.csv"
-      });
-    } finally {
-      server.close();
-    }
-  });
-});

package/packages/driver-managed/src/managed-driver.ts DELETED Viewed

@@ -1,341 +0,0 @@
-import type { BrowserDriver } from "../../core/src/driver";
-import type { ProfileId, TargetId } from "../../core/src/types";
-export type ManagedDriverStatus = {
-  kind: "managed";
-  connected: true;
-};
-const DEFAULT_PROFILE_ID: ProfileId = "profile:managed:default";
-type ManagedTab = {
-  url: string;
-  html: string;
-  cookieHeader?: string;
-  pendingDownloadUrl?: string;
-};
-type ManagedProfileState = {
-  nextTargetNumber: number;
-  tabs: Map<TargetId, ManagedTab>;
-  tabOrder: TargetId[];
-  focusedTargetId?: TargetId;
-};
-function resolveProfileId(profile?: ProfileId): ProfileId {
-  return profile ?? DEFAULT_PROFILE_ID;
-}
-function createTargetId(profileId: ProfileId, targetNumber: number): TargetId {
-  return `target:managed:${profileId}:${targetNumber}`;
-}
-function createProfileState(): ManagedProfileState {
-  return {
-    nextTargetNumber: 1,
-    tabs: new Map<TargetId, ManagedTab>(),
-    tabOrder: []
-  };
-}
-function isObjectRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function parseCookieHeader(response: Response): string | undefined {
-  const rawSetCookie = response.headers.get("set-cookie");
-  if (rawSetCookie === null) {
-    return undefined;
-  }
-  const [cookieSegment] = rawSetCookie.split(";");
-  const cookieHeader = cookieSegment.trim();
-  return cookieHeader.length > 0 ? cookieHeader : undefined;
-}
-function readPayloadString(
-  payload: Record<string, unknown>,
-  fieldName: string
-): string | undefined {
-  const value = payload[fieldName];
-  return typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
-}
-async function requestTab(
-  tab: ManagedTab,
-  url: string,
-  init: RequestInit
-): Promise<void> {
-  const headers = new Headers(init.headers ?? {});
-  if (tab.cookieHeader !== undefined && !headers.has("cookie")) {
-    headers.set("cookie", tab.cookieHeader);
-  }
-  const response = await fetch(url, {
-    ...init,
-    headers
-  });
-  const cookieHeader = parseCookieHeader(response);
-  if (cookieHeader !== undefined) {
-    tab.cookieHeader = cookieHeader;
-  }
-  const body = await response.text();
-  if (!response.ok) {
-    throw new Error(`${init.method ?? "GET"} ${url} failed with ${response.status}`);
-  }
-  tab.url = response.url;
-  tab.html = body;
-}
-export function createManagedDriver(): BrowserDriver<ManagedDriverStatus> {
-  const profileStates = new Map<ProfileId, ManagedProfileState>();
-  function getOrCreateProfileState(profileId: ProfileId): ManagedProfileState {
-    const existingState = profileStates.get(profileId);
-    if (existingState !== undefined) {
-      return existingState;
-    }
-    const createdState = createProfileState();
-    profileStates.set(profileId, createdState);
-    return createdState;
-  }
-  function requireTargetInProfile(profileId: ProfileId, targetId: TargetId): ManagedProfileState {
-    const profileState = profileStates.get(profileId);
-    if (profileState === undefined || !profileState.tabs.has(targetId)) {
-      throw new Error(`Unknown targetId: ${targetId} (profile: ${profileId})`);
-    }
-    return profileState;
-  }
-  return {
-    status: async () => ({ kind: "managed", connected: true }),
-    listProfiles: async () => {
-      const knownProfiles = new Set<ProfileId>([DEFAULT_PROFILE_ID]);
-      for (const profileId of profileStates.keys()) {
-        knownProfiles.add(profileId);
-      }
-      return Array.from(knownProfiles).sort();
-    },
-    listTabs: async (profile) => {
-      const profileId = resolveProfileId(profile);
-      const profileState = profileStates.get(profileId);
-      return profileState === undefined ? [] : [...profileState.tabOrder];
-    },
-    openTab: async (url, profile) => {
-      const profileId = resolveProfileId(profile);
-      const profileState = getOrCreateProfileState(profileId);
-      const targetId = createTargetId(profileId, profileState.nextTargetNumber);
-      profileState.nextTargetNumber += 1;
-      const tab: ManagedTab = {
-        url,
-        html: ""
-      };
-      profileState.tabs.set(targetId, tab);
-      profileState.tabOrder.push(targetId);
-      if (profileState.focusedTargetId === undefined) {
-        profileState.focusedTargetId = targetId;
-      }
-      try {
-        await requestTab(tab, url, { method: "GET" });
-      } catch {
-        // Keep managed driver deterministic even when URL is unreachable.
-      }
-      return targetId;
-    },
-    focusTab: async (targetId, profile) => {
-      const profileId = resolveProfileId(profile);
-      const profileState = requireTargetInProfile(profileId, targetId);
-      profileState.focusedTargetId = targetId;
-    },
-    closeTab: async (targetId, profile) => {
-      const profileId = resolveProfileId(profile);
-      const profileState = requireTargetInProfile(profileId, targetId);
-      profileState.tabs.delete(targetId);
-      profileState.tabOrder = profileState.tabOrder.filter((existingTargetId) => existingTargetId !== targetId);
-      if (profileState.focusedTargetId === targetId) {
-        profileState.focusedTargetId = profileState.tabOrder[0];
-      }
-    },
-    snapshot: async (targetId, profile) => {
-      const profileId = resolveProfileId(profile);
-      const tab = profileStates.get(profileId)?.tabs.get(targetId);
-      if (tab === undefined) {
-        return {
-          kind: "managed",
-          profile: profileId,
-          targetId,
-          hasTarget: false
-        };
-      }
-      return {
-        kind: "managed",
-        profile: profileId,
-        targetId,
-        hasTarget: true,
-        url: tab.url,
-        html: tab.html
-      };
-    },
-    act: async (action, targetId, profile) => {
-      const profileId = resolveProfileId(profile);
-      const tab = profileStates.get(profileId)?.tabs.get(targetId);
-      if (tab === undefined) {
-        return {
-          actionType: action.type,
-          profile: profileId,
-          targetId,
-          targetKnown: false,
-          ok: false,
-          executed: false
-        };
-      }
-      const payload = isObjectRecord(action.payload) ? action.payload : {};
-      if (action.type === "navigate" || action.type === "goto") {
-        const nextUrlValue = readPayloadString(payload, "url") ?? readPayloadString(payload, "path");
-        if (nextUrlValue === undefined) {
-          return {
-            actionType: action.type,
-            profile: profileId,
-            targetId,
-            targetKnown: true,
-            ok: false,
-            executed: true,
-            error: "action.payload.url or action.payload.path is required for navigate action."
-          };
-        }
-        const nextUrl = new URL(nextUrlValue, tab.url).toString();
-        try {
-          await requestTab(tab, nextUrl, { method: "GET" });
-        } catch (error) {
-          return {
-            actionType: action.type,
-            profile: profileId,
-            targetId,
-            targetKnown: true,
-            ok: false,
-            executed: true,
-            error: error instanceof Error ? error.message : String(error)
-          };
-        }
-        return {
-          actionType: action.type,
-          profile: profileId,
-          targetId,
-          targetKnown: true,
-          ok: true,
-          executed: true,
-          data: {
-            url: tab.url
-          }
-        };
-      }
-      if (action.type === "login") {
-        const loginPath = readPayloadString(payload, "path") ?? "/api/login";
-        const loginUrl = new URL(loginPath, tab.url).toString();
-        try {
-          await requestTab(tab, loginUrl, { method: "POST" });
-        } catch (error) {
-          return {
-            actionType: action.type,
-            profile: profileId,
-            targetId,
-            targetKnown: true,
-            ok: false,
-            executed: true,
-            error: error instanceof Error ? error.message : String(error)
-          };
-        }
-        return {
-          actionType: action.type,
-          profile: profileId,
-          targetId,
-          targetKnown: true,
-          ok: true,
-          executed: true
-        };
-      }
-      if (action.type === "prepare-download") {
-        const downloadPath = readPayloadString(payload, "path");
-        if (downloadPath === undefined) {
-          return {
-            actionType: action.type,
-            profile: profileId,
-            targetId,
-            targetKnown: true,
-            ok: false,
-            executed: true,
-            error: "action.payload.path is required for prepare-download action."
-          };
-        }
-        tab.pendingDownloadUrl = new URL(downloadPath, tab.url).toString();
-        return {
-          actionType: action.type,
-          profile: profileId,
-          targetId,
-          targetKnown: true,
-          ok: true,
-          executed: true,
-          data: {
-            url: tab.pendingDownloadUrl
-          }
-        };
-      }
-      return {
-        actionType: action.type,
-        profile: profileId,
-        targetId,
-        targetKnown: true,
-        ok: true,
-        executed: false
-      };
-    },
-    armUpload: async () => {},
-    armDialog: async () => {},
-    waitDownload: async (targetId, profile, path) => {
-      const profileId = resolveProfileId(profile);
-      const tab = profileStates.get(profileId)?.tabs.get(targetId);
-      if (tab === undefined) {
-        throw new Error(`Unknown targetId: ${targetId} (profile: ${profileId})`);
-      }
-      if (tab.pendingDownloadUrl !== undefined) {
-        const headers = new Headers();
-        if (tab.cookieHeader !== undefined) {
-          headers.set("cookie", tab.cookieHeader);
-        }
-        try {
-          await fetch(tab.pendingDownloadUrl, {
-            method: "GET",
-            headers
-          });
-        } finally {
-          tab.pendingDownloadUrl = undefined;
-        }
-      }
-      return { path: path ?? "managed-download.bin" };
-    },
-    triggerDownload: async () => {}
-  };
-}