npm - @flrande/browserctl - Versions diffs - 0.1.0 - Mend

@flrande/browserctl 0.1.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 (90) hide show

package/LICENSE +21 -0
package/README-CN.md +1155 -0
package/README.md +1155 -0
package/apps/browserctl/src/commands/a11y-snapshot.ts +20 -0
package/apps/browserctl/src/commands/act.ts +20 -0
package/apps/browserctl/src/commands/common.test.ts +87 -0
package/apps/browserctl/src/commands/common.ts +191 -0
package/apps/browserctl/src/commands/console-list.ts +20 -0
package/apps/browserctl/src/commands/cookie-clear.ts +18 -0
package/apps/browserctl/src/commands/cookie-get.ts +18 -0
package/apps/browserctl/src/commands/cookie-set.ts +22 -0
package/apps/browserctl/src/commands/dialog-arm.ts +20 -0
package/apps/browserctl/src/commands/dom-query-all.ts +18 -0
package/apps/browserctl/src/commands/dom-query.ts +18 -0
package/apps/browserctl/src/commands/download-trigger.ts +22 -0
package/apps/browserctl/src/commands/download-wait.test.ts +67 -0
package/apps/browserctl/src/commands/download-wait.ts +27 -0
package/apps/browserctl/src/commands/element-screenshot.ts +20 -0
package/apps/browserctl/src/commands/frame-list.ts +16 -0
package/apps/browserctl/src/commands/frame-snapshot.ts +18 -0
package/apps/browserctl/src/commands/network-wait-for.ts +100 -0
package/apps/browserctl/src/commands/profile-list.ts +16 -0
package/apps/browserctl/src/commands/profile-use.ts +18 -0
package/apps/browserctl/src/commands/response-body.ts +24 -0
package/apps/browserctl/src/commands/screenshot.ts +16 -0
package/apps/browserctl/src/commands/snapshot.ts +16 -0
package/apps/browserctl/src/commands/status.ts +10 -0
package/apps/browserctl/src/commands/storage-get.ts +20 -0
package/apps/browserctl/src/commands/storage-set.ts +22 -0
package/apps/browserctl/src/commands/tab-close.ts +20 -0
package/apps/browserctl/src/commands/tab-focus.ts +20 -0
package/apps/browserctl/src/commands/tab-open.ts +19 -0
package/apps/browserctl/src/commands/tabs.ts +13 -0
package/apps/browserctl/src/commands/upload-arm.ts +26 -0
package/apps/browserctl/src/daemon-client.test.ts +253 -0
package/apps/browserctl/src/daemon-client.ts +632 -0
package/apps/browserctl/src/e2e.test.ts +99 -0
package/apps/browserctl/src/main.test.ts +215 -0
package/apps/browserctl/src/main.ts +372 -0
package/apps/browserctl/src/smoke.test.ts +16 -0
package/apps/browserctl/src/smoke.ts +5 -0
package/apps/browserd/src/bootstrap.ts +432 -0
package/apps/browserd/src/chrome-relay-extension-bridge.test.ts +275 -0
package/apps/browserd/src/chrome-relay-extension-bridge.ts +506 -0
package/apps/browserd/src/container.ts +1531 -0
package/apps/browserd/src/main.test.ts +864 -0
package/apps/browserd/src/main.ts +7 -0
package/bin/browserctl.cjs +21 -0
package/bin/browserd.cjs +21 -0
package/extensions/chrome-relay/README.md +36 -0
package/extensions/chrome-relay/background.js +1687 -0
package/extensions/chrome-relay/manifest.json +15 -0
package/extensions/chrome-relay/popup.html +369 -0
package/extensions/chrome-relay/popup.js +972 -0
package/package.json +51 -0
package/packages/core/src/bootstrap.test.ts +10 -0
package/packages/core/src/driver-registry.test.ts +45 -0
package/packages/core/src/driver-registry.ts +22 -0
package/packages/core/src/driver.ts +47 -0
package/packages/core/src/index.ts +5 -0
package/packages/core/src/ref-cache.test.ts +61 -0
package/packages/core/src/ref-cache.ts +28 -0
package/packages/core/src/session-store.test.ts +49 -0
package/packages/core/src/session-store.ts +33 -0
package/packages/core/src/types.ts +9 -0
package/packages/driver-chrome-relay/src/chrome-relay-driver.test.ts +634 -0
package/packages/driver-chrome-relay/src/chrome-relay-driver.ts +2206 -0
package/packages/driver-chrome-relay/src/chrome-relay-extension-runtime.test.ts +264 -0
package/packages/driver-chrome-relay/src/chrome-relay-extension-runtime.ts +521 -0
package/packages/driver-chrome-relay/src/index.ts +26 -0
package/packages/driver-managed/src/index.ts +22 -0
package/packages/driver-managed/src/managed-driver.test.ts +59 -0
package/packages/driver-managed/src/managed-driver.ts +125 -0
package/packages/driver-managed/src/managed-local-driver.test.ts +506 -0
package/packages/driver-managed/src/managed-local-driver.ts +2021 -0
package/packages/driver-remote-cdp/src/index.ts +19 -0
package/packages/driver-remote-cdp/src/remote-cdp-driver.test.ts +617 -0
package/packages/driver-remote-cdp/src/remote-cdp-driver.ts +2042 -0
package/packages/protocol/src/envelope.test.ts +25 -0
package/packages/protocol/src/envelope.ts +31 -0
package/packages/protocol/src/errors.test.ts +17 -0
package/packages/protocol/src/errors.ts +11 -0
package/packages/protocol/src/index.ts +3 -0
package/packages/protocol/src/tools.ts +3 -0
package/packages/transport-mcp-stdio/src/index.ts +3 -0
package/packages/transport-mcp-stdio/src/sdk-server.ts +139 -0
package/packages/transport-mcp-stdio/src/server.test.ts +281 -0
package/packages/transport-mcp-stdio/src/server.ts +183 -0
package/packages/transport-mcp-stdio/src/tool-map.ts +67 -0
package/scripts/smoke.ps1 +127 -0

package/packages/driver-chrome-relay/src/chrome-relay-extension-runtime.test.ts ADDED Viewed

@@ -0,0 +1,264 @@
+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();
+  });
+});