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

@flrande/browserctl 0.5.0-dev.22.1 → 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 -59
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 -512
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 -1522
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-chrome-relay/src/chrome-relay-extension-runtime.test.ts DELETED Viewed

@@ -1,264 +0,0 @@
-import { describe, expect, it, vi } from "vitest";
-import { createChromeRelayExtensionRuntime } from "./chrome-relay-extension-runtime";
-type InvokeResult = Record<string, unknown> | undefined;
-type InvokeStub = ReturnType<typeof vi.fn<[string, Record<string, unknown> | undefined], Promise<InvokeResult>>>;
-function createInvokeStub(): InvokeStub {
-  return vi.fn(async (_method, _params) => ({}));
-}
-describe("createChromeRelayExtensionRuntime", () => {
-  it("throws when extension bridge is not connected", async () => {
-    const invoke = createInvokeStub();
-    const runtime = createChromeRelayExtensionRuntime({
-      transport: {
-        invoke,
-        isConnected: () => false
-      }
-    });
-    await expect(runtime.connectOverCDP("http://127.0.0.1:9223")).rejects.toThrowError(
-      "Chrome relay extension is not connected."
-    );
-    expect(invoke).toHaveBeenCalledTimes(0);
-  });
-  it("routes page operations to extension transport methods", async () => {
-    const invoke = vi.fn(async (method: string, params?: Record<string, unknown>) => {
-      if (method === "tab.open") {
-        return {
-          tabId: 11,
-          url: params?.url,
-          title: "Opened"
-        };
-      }
-      if (method === "tab.info") {
-        return {
-          tabId: 11,
-          url: "https://example.com/next",
-          title: "Info title"
-        };
-      }
-      if (method === "tab.snapshot") {
-        return {
-          tabId: 11,
-          url: "https://example.com/next",
-          title: "Snapshot title",
-          html: "<html data-from=\"extension\" />"
-        };
-      }
-      if (method === "tab.screenshot") {
-        return {
-          tabId: 11,
-          mimeType: "image/png",
-          encoding: "base64",
-          imageBase64: "AAEC",
-          width: 1200,
-          height: 800
-        };
-      }
-      return {
-        ok: true
-      };
-    });
-    const runtime = createChromeRelayExtensionRuntime({
-      transport: {
-        invoke,
-        isConnected: () => true
-      }
-    });
-    const browser = await runtime.connectOverCDP("http://127.0.0.1:9223");
-    const context = browser.contexts()[0];
-    if (context === undefined) {
-      throw new Error("Expected browser context.");
-    }
-    const page = await context.newPage();
-    await page.goto("https://example.com/start");
-    await page.bringToFront();
-    await page.locator("#submit").click();
-    await page.locator("#name").fill("BrowserCtl");
-    await page.locator("#query").type("hello");
-    await page.keyboard?.press("Enter");
-    expect(page.url()).toBe("https://example.com/start");
-    await expect(page.title()).resolves.toBe("Info title");
-    await expect(page.content()).resolves.toBe("<html data-from=\"extension\" />");
-    await expect(page.screenshot?.()).resolves.toEqual({
-      mimeType: "image/png",
-      encoding: "base64",
-      imageBase64: "AAEC",
-      width: 1200,
-      height: 800
-    });
-    await page.close();
-    expect(invoke).toHaveBeenCalledWith("tab.open", { url: "https://example.com/start" });
-    expect(invoke).toHaveBeenCalledWith("tab.focus", { tabId: 11 });
-    expect(invoke).toHaveBeenCalledWith("tab.act", {
-      tabId: 11,
-      action: { type: "click", payload: { selector: "#submit" } }
-    });
-    expect(invoke).toHaveBeenCalledWith("tab.act", {
-      tabId: 11,
-      action: { type: "fill", payload: { selector: "#name", value: "BrowserCtl" } }
-    });
-    expect(invoke).toHaveBeenCalledWith("tab.act", {
-      tabId: 11,
-      action: { type: "type", payload: { selector: "#query", text: "hello" } }
-    });
-    expect(invoke).toHaveBeenCalledWith("tab.act", {
-      tabId: 11,
-      action: { type: "press", payload: { key: "Enter" } }
-    });
-    expect(invoke).toHaveBeenCalledWith("tab.info", { tabId: 11 });
-    expect(invoke).toHaveBeenCalledWith("tab.snapshot", { tabId: 11 });
-    expect(invoke).toHaveBeenCalledWith("tab.screenshot", { tabId: 11 });
-    expect(invoke).toHaveBeenCalledWith("tab.close", { tabId: 11 });
-  });
-  it("throws when extension does not return a numeric tab id", async () => {
-    const invoke = vi.fn(async (method: string) => {
-      if (method === "tab.open") {
-        return {
-          tabId: "bad"
-        };
-      }
-      return {};
-    });
-    const runtime = createChromeRelayExtensionRuntime({
-      transport: {
-        invoke,
-        isConnected: () => true
-      }
-    });
-    const browser = await runtime.connectOverCDP("http://127.0.0.1:9223");
-    const context = browser.contexts()[0];
-    if (context === undefined) {
-      throw new Error("Expected browser context.");
-    }
-    const page = await context.newPage();
-    await expect(page.goto("https://example.com/fail")).rejects.toThrowError(
-      "Extension relay response is missing numeric tabId for tab.open."
-    );
-  });
-  it("maps transport events to page console/response listeners", async () => {
-    let onEventListener:
-      | ((event: {
-          kind: "console" | "response";
-          tabId: number;
-          entry?: { type: string; text: string };
-          response?: {
-            requestId: string;
-            url: string;
-            status: number;
-            method: string;
-            resourceType: string;
-            body: string;
-            encoding: "utf8" | "base64";
-          };
-        }) => void)
-      | undefined;
-    const invoke = vi.fn(async (method: string, params?: Record<string, unknown>) => {
-      if (method === "tab.open") {
-        return {
-          tabId: 22,
-          url: params?.url,
-          title: "Opened"
-        };
-      }
-      return {
-        ok: true
-      };
-    });
-    const runtime = createChromeRelayExtensionRuntime({
-      transport: {
-        invoke,
-        isConnected: () => true,
-        onEvent: (listener) => {
-          onEventListener = listener;
-          return () => {
-            onEventListener = undefined;
-          };
-        }
-      }
-    });
-    const browser = await runtime.connectOverCDP("http://127.0.0.1:9223");
-    const context = browser.contexts()[0];
-    if (context === undefined) {
-      throw new Error("Expected browser context.");
-    }
-    const page = await context.newPage();
-    await page.goto("https://example.com/events");
-    const consoleListener = vi.fn();
-    const responseListener = vi.fn();
-    page.on?.("console", consoleListener);
-    page.on?.("response", responseListener);
-    onEventListener?.({
-      kind: "console",
-      tabId: 22,
-      entry: {
-        type: "warning",
-        text: "extension console event"
-      }
-    });
-    onEventListener?.({
-      kind: "response",
-      tabId: 22,
-      response: {
-        requestId: "request:extension:22:1",
-        url: "https://example.com/api/items",
-        status: 200,
-        method: "GET",
-        resourceType: "xhr",
-        body: "{\"ok\":true}",
-        encoding: "utf8"
-      }
-    });
-    expect(consoleListener).toHaveBeenCalledTimes(1);
-    const consoleMessage = consoleListener.mock.calls[0]?.[0] as {
-      type(): string;
-      text(): string;
-    };
-    expect(consoleMessage.type()).toBe("warning");
-    expect(consoleMessage.text()).toBe("extension console event");
-    expect(responseListener).toHaveBeenCalledTimes(1);
-    const responseMessage = responseListener.mock.calls[0]?.[0] as {
-      url(): string;
-      status(): number;
-      request(): {
-        method(): string;
-        resourceType(): string | undefined;
-      };
-      text(): Promise<string>;
-    };
-    expect(responseMessage.url()).toBe("https://example.com/api/items");
-    expect(responseMessage.status()).toBe(200);
-    expect(responseMessage.request().method()).toBe("GET");
-    expect(responseMessage.request().resourceType()).toBe("xhr");
-    await expect(responseMessage.text()).resolves.toBe("{\"ok\":true}");
-    await browser.close();
-    expect(onEventListener).toBeUndefined();
-  });
-});