@webmcp-bridge/playwright 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 holon-run
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/attach.d.ts

@@ -0,0 +1,9 @@
+/**
+ * This module attaches the WebMCP bridge into a Playwright page and wires tool calls to a Node-side adapter.
+ * It depends on core bridge types and Playwright page hooks for init script injection and exposed callbacks.
+ */
+import type { Page } from "playwright";
+import type { PlaywrightBridgeOptions, PlaywrightBridgeSession } from "./types.js";
+export declare function attachBridge(page: Page, options: PlaywrightBridgeOptions): Promise<PlaywrightBridgeSession>;
+export declare function detachBridge(page: Page): Promise<void>;
+//# sourceMappingURL=attach.d.ts.map

package/dist/attach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach.d.ts","sourceRoot":"","sources":["../src/attach.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,EACV,uBAAuB,EACvB,uBAAuB,EAExB,MAAM,YAAY,CAAC;AAgFpB,wBAAsB,YAAY,CAChC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,uBAAuB,CAAC,CAuDlC;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAO5D"}

package/dist/attach.js

@@ -0,0 +1,135 @@
+/**
+ * This module attaches the WebMCP bridge into a Playwright page and wires tool calls to a Node-side adapter.
+ * It depends on core bridge types and Playwright page hooks for init script injection and exposed callbacks.
+ */
+import { randomUUID } from "node:crypto";
+const SESSIONS = new WeakMap();
+const INJECT_SCRIPT = String.raw `
+(() => {
+  const navAny = navigator;
+  const globalAny = window;
+  const hasNative =
+    navAny &&
+    navAny.modelContext &&
+    typeof navAny.modelContext.registerTool === "function" &&
+    typeof navAny.modelContext.unregisterTool === "function";
+  if (hasNative) {
+    globalAny.__WEBMCP_BRIDGE_MODE__ = "native";
+    return;
+  }
+
+  const tools = new Map();
+  const contexts = [];
+
+  const modelContext = {
+    provideContext: async (context) => {
+      contexts.push(context || {});
+    },
+    clearContext: async () => {
+      contexts.splice(0, contexts.length);
+      tools.clear();
+    },
+    registerTool: async (tool) => {
+      const name = tool && typeof tool.name === "string" ? tool.name : "";
+      if (!name) {
+        throw new Error("tool.name is required");
+      }
+      if (tools.has(name)) {
+        throw new Error("tool already registered");
+      }
+      tools.set(name, tool);
+    },
+    unregisterTool: async (name) => {
+      tools.delete(String(name || ""));
+    },
+    callTool: async (name, input) => {
+      const local = tools.get(String(name || ""));
+      if (local && typeof local.execute === "function") {
+        return await local.execute(input || {});
+      }
+      if (typeof globalAny.__WEBMCP_BRIDGE_CALL__ !== "function") {
+        throw new Error("bridge call handler missing");
+      }
+      return await globalAny.__WEBMCP_BRIDGE_CALL__(String(name || ""), input || {});
+    },
+  };
+
+  try {
+    Object.defineProperty(navAny, "modelContext", {
+      configurable: true,
+      enumerable: false,
+      writable: false,
+      value: modelContext,
+    });
+  } catch {
+    navAny.modelContext = modelContext;
+  }
+  globalAny.__webmcpBridge = {
+    list: () =>
+      Array.from(tools.values()).map((tool) => ({
+        name: tool.name,
+        description: tool.description || "",
+        inputSchema: tool.inputSchema || { type: "object" },
+        annotations: tool.annotations || {},
+      })),
+    invoke: async (name, input) => {
+      return await modelContext.callTool(String(name || ""), input || {});
+    },
+  };
+  globalAny.__WEBMCP_BRIDGE_MODE__ = "shim";
+})();
+`;
+export async function attachBridge(page, options) {
+    const existing = SESSIONS.get(page);
+    if (existing) {
+        return existing.session;
+    }
+    const preferNative = options.preferNative ?? true;
+    const reinjectOnNavigate = options.reinjectOnNavigate ?? true;
+    const adapter = options.adapter;
+    await adapter.start?.({ page });
+    const exposedName = `__WEBMCP_BRIDGE_CALL__${randomUUID().replaceAll("-", "")}`;
+    await page.exposeFunction(exposedName, async (name, input) => {
+        return await adapter.callTool({ name, input }, { page });
+    });
+    const bindScript = `window.__WEBMCP_BRIDGE_CALL__ = window.${exposedName};`;
+    await page.addInitScript(INJECT_SCRIPT);
+    await page.addInitScript(bindScript);
+    await page.evaluate(INJECT_SCRIPT);
+    await page.evaluate(bindScript);
+    const mode = await page.evaluate(() => {
+        const globalAny = window;
+        return globalAny.__WEBMCP_BRIDGE_MODE__ ?? "shim";
+    });
+    const onNavigate = async () => {
+        await page.evaluate(bindScript);
+    };
+    if (reinjectOnNavigate) {
+        page.on("framenavigated", () => {
+            void onNavigate();
+        });
+    }
+    const session = {
+        id: randomUUID(),
+        mode: preferNative && mode === "native" ? "native" : "shim",
+        page,
+        adapter,
+    };
+    const cleanup = async () => {
+        if (reinjectOnNavigate) {
+            page.removeAllListeners("framenavigated");
+        }
+        await adapter.stop?.({ page });
+    };
+    SESSIONS.set(page, { session, cleanup });
+    return session;
+}
+export async function detachBridge(page) {
+    const existing = SESSIONS.get(page);
+    if (!existing) {
+        return;
+    }
+    await existing.cleanup();
+    SESSIONS.delete(page);
+}
+//# sourceMappingURL=attach.js.map

package/dist/attach.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach.js","sourceRoot":"","sources":["../src/attach.ts"],"names":[],"mappings":"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"}

package/dist/gateway.d.ts

@@ -0,0 +1,9 @@
+/**
+ * This module provides a native-first WebMCP page gateway with polyfill and adapter-shim fallback wiring.
+ * It depends on Playwright page APIs and shared bridge types so local-mcp can call browser WebMCP uniformly.
+ */
+import type { Page } from "playwright";
+import type { CreateWebMcpPageGatewayOptions, WebMcpPageGateway } from "./types.js";
+export declare function createWebMcpPageGateway(page: Page, options?: CreateWebMcpPageGatewayOptions): Promise<WebMcpPageGateway>;
+export declare function closeWebMcpPageGateway(page: Page): Promise<void>;
+//# sourceMappingURL=gateway.d.ts.map

package/dist/gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../src/gateway.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,EACV,8BAA8B,EAE9B,iBAAiB,EAElB,MAAM,YAAY,CAAC;AA4GpB,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,8BAA8B,GACvC,OAAO,CAAC,iBAAiB,CAAC,CAkJ5B;AAED,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAOtE"}

package/dist/gateway.js

@@ -0,0 +1,237 @@
+/**
+ * This module provides a native-first WebMCP page gateway with polyfill and adapter-shim fallback wiring.
+ * It depends on Playwright page APIs and shared bridge types so local-mcp can call browser WebMCP uniformly.
+ */
+import { randomUUID } from "node:crypto";
+const INJECT_SCRIPT = String.raw `
+(() => {
+  const navAny = navigator;
+  const globalAny = window;
+  const hasNative =
+    navAny &&
+    navAny.modelContext &&
+    typeof navAny.modelContext.registerTool === "function" &&
+    typeof navAny.modelContext.unregisterTool === "function";
+
+  if (hasNative) {
+    globalAny.__webmcpBridge = {
+      list: async () => {
+        if (typeof navAny.modelContext.listTools === "function") {
+          const nativeTools = await navAny.modelContext.listTools();
+          return Array.isArray(nativeTools) ? nativeTools : [];
+        }
+        return [];
+      },
+      invoke: async (name, input) => {
+        if (typeof navAny.modelContext.callTool !== "function") {
+          throw new Error("native modelContext callTool is not available");
+        }
+        return await navAny.modelContext.callTool(String(name || ""), input || {});
+      },
+    };
+    globalAny.__WEBMCP_BRIDGE_MODE__ = "native";
+    return;
+  }
+
+  const tools = new Map();
+  const contexts = [];
+
+  const modelContext = {
+    provideContext: async (context) => {
+      contexts.push(context || {});
+    },
+    clearContext: async () => {
+      contexts.splice(0, contexts.length);
+      tools.clear();
+    },
+    registerTool: async (tool) => {
+      const name = tool && typeof tool.name === "string" ? tool.name : "";
+      if (!name) {
+        throw new Error("tool.name is required");
+      }
+      if (tools.has(name)) {
+        throw new Error("tool already registered");
+      }
+      tools.set(name, tool);
+    },
+    unregisterTool: async (name) => {
+      tools.delete(String(name || ""));
+    },
+    callTool: async (name, input) => {
+      const local = tools.get(String(name || ""));
+      if (local && typeof local.execute === "function") {
+        return await local.execute(input || {});
+      }
+      if (typeof globalAny.__WEBMCP_BRIDGE_CALL__ !== "function") {
+        throw new Error("bridge call handler missing");
+      }
+      return await globalAny.__WEBMCP_BRIDGE_CALL__(String(name || ""), input || {});
+    },
+  };
+
+  try {
+    Object.defineProperty(navAny, "modelContext", {
+      configurable: true,
+      enumerable: false,
+      writable: false,
+      value: modelContext,
+    });
+  } catch {
+    navAny.modelContext = modelContext;
+  }
+
+  globalAny.__webmcpBridge = {
+    list: async () =>
+      Array.from(tools.values()).map((tool) => {
+        const output = {
+          name: tool.name,
+          inputSchema: tool.inputSchema || { type: "object" },
+          annotations: tool.annotations || {},
+        };
+        if (typeof tool.description === "string" && tool.description.trim()) {
+          return { ...output, description: tool.description };
+        }
+        return output;
+      }),
+    invoke: async (name, input) => {
+      return await modelContext.callTool(String(name || ""), input || {});
+    },
+  };
+
+  globalAny.__WEBMCP_BRIDGE_MODE__ = "polyfill";
+})();
+`;
+const SESSIONS = new WeakMap();
+export async function createWebMcpPageGateway(page, options) {
+    const existing = SESSIONS.get(page);
+    if (existing) {
+        return existing.gateway;
+    }
+    const fallbackAdapter = options?.fallbackAdapter;
+    const preferNative = options?.preferNative ?? true;
+    const reinjectOnNavigate = options?.reinjectOnNavigate ?? true;
+    let fallbackStarted = false;
+    let fallbackStartPromise;
+    const ensureFallbackStarted = async () => {
+        if (!fallbackAdapter || fallbackStarted) {
+            return;
+        }
+        if (!fallbackStartPromise) {
+            fallbackStartPromise = (async () => {
+                await fallbackAdapter.start?.({ page });
+                fallbackStarted = true;
+            })();
+        }
+        await fallbackStartPromise;
+    };
+    const exposedName = `__WEBMCP_BRIDGE_CALL__${randomUUID().replaceAll("-", "")}`;
+    await page.exposeFunction(exposedName, async (name, input) => {
+        if (!fallbackAdapter) {
+            return {
+                error: {
+                    code: "NOT_SUPPORTED",
+                    message: "fallback adapter is not configured",
+                },
+            };
+        }
+        await ensureFallbackStarted();
+        return await fallbackAdapter.callTool({ name, input }, { page });
+    });
+    const bindScript = `window.__WEBMCP_BRIDGE_CALL__ = window.${exposedName};`;
+    await page.addInitScript(INJECT_SCRIPT);
+    await page.addInitScript(bindScript);
+    await page.evaluate(INJECT_SCRIPT);
+    await page.evaluate(bindScript);
+    const detectedMode = await page.evaluate(() => {
+        const globalAny = window;
+        return globalAny.__WEBMCP_BRIDGE_MODE__ ?? "polyfill";
+    });
+    const mode = preferNative && detectedMode === "native"
+        ? "native"
+        : fallbackAdapter
+            ? "adapter-shim"
+            : "polyfill";
+    if (mode === "adapter-shim") {
+        await ensureFallbackStarted();
+    }
+    const rebindOnNavigate = () => {
+        void page.evaluate(bindScript).catch(() => {
+            // Ignore transient navigation races; the init script will rebind on next document.
+        });
+    };
+    if (reinjectOnNavigate) {
+        page.on("framenavigated", rebindOnNavigate);
+    }
+    const gateway = {
+        id: randomUUID(),
+        mode,
+        page,
+        listTools: async () => {
+            if (mode === "adapter-shim" && fallbackAdapter) {
+                await ensureFallbackStarted();
+                const adapterTools = await fallbackAdapter.listTools({ page });
+                return adapterTools.map((tool) => ({
+                    ...tool,
+                    inputSchema: tool.inputSchema ?? { type: "object" },
+                }));
+            }
+            return await page.evaluate(async () => {
+                const globalAny = window;
+                const list = globalAny.__webmcpBridge?.list;
+                if (typeof list !== "function") {
+                    return [];
+                }
+                const tools = await list();
+                return Array.isArray(tools) ? tools : [];
+            });
+        },
+        callTool: async (name, input) => {
+            const payload = {
+                callName: name,
+                callInput: input,
+            };
+            const result = await page.evaluate(async ({ callName, callInput }) => {
+                const globalAny = window;
+                const invoke = globalAny.__webmcpBridge?.invoke;
+                if (typeof invoke !== "function") {
+                    throw new Error("WebMCP bridge invoke handler missing");
+                }
+                return await invoke(String(callName || ""), callInput ?? {});
+            }, payload);
+            return result;
+        },
+        close: async () => {
+            const session = SESSIONS.get(page);
+            if (!session) {
+                return;
+            }
+            await session.cleanup();
+            SESSIONS.delete(page);
+        },
+    };
+    const cleanup = async () => {
+        if (reinjectOnNavigate) {
+            const pageEvents = page;
+            if (typeof pageEvents.removeListener === "function") {
+                pageEvents.removeListener("framenavigated", rebindOnNavigate);
+            }
+            else if (typeof pageEvents.removeAllListeners === "function") {
+                pageEvents.removeAllListeners("framenavigated");
+            }
+        }
+        if (fallbackStarted) {
+            await fallbackAdapter?.stop?.({ page });
+        }
+    };
+    SESSIONS.set(page, { gateway, cleanup });
+    return gateway;
+}
+export async function closeWebMcpPageGateway(page) {
+    const session = SESSIONS.get(page);
+    if (!session) {
+        return;
+    }
+    await session.cleanup();
+    SESSIONS.delete(page);
+}
+//# sourceMappingURL=gateway.js.map

package/dist/gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.js","sourceRoot":"","sources":["../src/gateway.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * This module exposes Playwright gateway public APIs.
+ * It depends on type and gateway modules to provide browser WebMCP integration entrypoints.
+ */
+export * from "./types.js";
+export * from "./gateway.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+/**
+ * This module exposes Playwright gateway public APIs.
+ * It depends on type and gateway modules to provide browser WebMCP integration entrypoints.
+ */
+export * from "./types.js";
+export * from "./gateway.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,59 @@
+/**
+ * This module defines Playwright WebMCP gateway and fallback adapter contracts.
+ * It is depended on by gateway lifecycle implementation and adapter packages.
+ */
+import type { JsonValue } from "@webmcp-bridge/core";
+import type { Page } from "playwright";
+export type WebMcpToolDefinition = {
+    name: string;
+    description?: string;
+    inputSchema?: JsonValue;
+    annotations?: {
+        readOnlyHint?: boolean;
+    };
+};
+export type AdapterManifest = {
+    id: string;
+    displayName: string;
+    version: string;
+    bridgeApiVersion: string;
+    defaultUrl?: string;
+    hostPatterns: string[];
+    authProbeTool?: string;
+};
+export type SiteAdapter = {
+    name: string;
+    listTools: (context: {
+        page: Page;
+    }) => Promise<Array<WebMcpToolDefinition>>;
+    callTool: (request: {
+        name: string;
+        input: JsonValue;
+    }, context: {
+        page: Page;
+    }) => Promise<JsonValue>;
+    start?: (context: {
+        page: Page;
+    }) => Promise<void>;
+    stop?: (context: {
+        page: Page;
+    }) => Promise<void>;
+};
+export type SiteAdapterModule = {
+    manifest: AdapterManifest;
+    createAdapter: () => SiteAdapter;
+};
+export type CreateWebMcpPageGatewayOptions = {
+    fallbackAdapter?: SiteAdapter;
+    preferNative?: boolean;
+    reinjectOnNavigate?: boolean;
+};
+export type WebMcpPageGateway = {
+    id: string;
+    mode: "native" | "polyfill" | "adapter-shim";
+    page: Page;
+    listTools: () => Promise<WebMcpToolDefinition[]>;
+    callTool: (name: string, input: JsonValue) => Promise<JsonValue>;
+    close: () => Promise<void>;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,WAAW,CAAC,EAAE;QACZ,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,KAAK,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAC7E,QAAQ,EAAE,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,CAAA;KAAE,EAAE,OAAO,EAAE;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACvG,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,eAAe,CAAC;IAC1B,aAAa,EAAE,MAAM,WAAW,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,eAAe,CAAC,EAAE,WAAW,CAAC;IAC9B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,cAAc,CAAC;IAC7C,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,EAAE,MAAM,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC;IACjD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACjE,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,CAAC"}

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * This module defines Playwright WebMCP gateway and fallback adapter contracts.
+ * It is depended on by gateway lifecycle implementation and adapter packages.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@webmcp-bridge/playwright",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "playwright": "^1.58.2",
+    "@webmcp-bridge/core": "0.1.0"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  }
+}