@workglow/electron 0.2.32

package/dist/ElectronBackend.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @license
+ * Copyright 2025 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { CDPBrowserBackend } from "@workglow/browser-control/task";
+import type { BrowserConnectOptions, DialogAction, DialogInfo, DownloadOptions, DownloadResult, ElementRef, IBrowserContext, NavigateOptions, ScreenshotOptions, TabInfo, WaitOptions } from "@workglow/browser-control/task";
+/**
+ * IBrowserContext implementation using Electron's native webContents + CDP.
+ *
+ * This file is only imported from the Electron main process. It must NOT be
+ * included in browser/bun/node entry points.
+ *
+ * Session isolation is achieved via `session.fromPartition(partitionString)`
+ * scoped to projectId + profileName.
+ */
+export declare class ElectronBackend extends CDPBrowserBackend implements IBrowserContext {
+    /** @type {AnyBrowserWindow} Electron BrowserWindow instance */
+    private _window;
+    /** @type {AnyWebContents} Electron webContents instance */
+    private _webContents;
+    private _connected;
+    private _dialogHandler;
+    protected readonly backendName = "ElectronBackend";
+    /**
+     * Send a Chrome DevTools Protocol command via the Electron debugger.
+     * @param method CDP method name (e.g. "DOM.getBoxModel")
+     * @param params CDP parameters
+     */
+    protected cdp(method: string, params?: Record<string, unknown>): Promise<unknown>;
+    protected evaluateInPage<T>(script: string): Promise<T>;
+    connect(options?: BrowserConnectOptions): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+    private get wc();
+    navigate(url: string, _options?: NavigateOptions): Promise<void>;
+    goBack(_options?: NavigateOptions): Promise<void>;
+    goForward(_options?: NavigateOptions): Promise<void>;
+    reload(_options?: NavigateOptions): Promise<void>;
+    currentUrl(): Promise<string>;
+    title(): Promise<string>;
+    content(): Promise<string>;
+    evaluate<T>(expression: string): Promise<T>;
+    screenshot(options?: ScreenshotOptions): Promise<Buffer>;
+    download(trigger: () => Promise<void>, options?: DownloadOptions): Promise<DownloadResult>;
+    onDialog(handler: (info: DialogInfo) => DialogAction | Promise<DialogAction>): void;
+    tabs(): Promise<readonly TabInfo[]>;
+    switchTab(_tabId: string): Promise<void>;
+    newTab(url?: string): Promise<TabInfo>;
+    closeTab(_tabId: string): Promise<void>;
+    waitForNavigation(options?: NavigateOptions): Promise<void>;
+    waitForSelector(selector: string, options?: WaitOptions): Promise<ElementRef>;
+    waitForIdle(options?: WaitOptions): Promise<void>;
+}
+//# sourceMappingURL=ElectronBackend.d.ts.map

package/dist/ElectronBackend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElectronBackend.d.ts","sourceRoot":"","sources":["../src/ElectronBackend.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,KAAK,EACV,qBAAqB,EACrB,YAAY,EACZ,UAAU,EACV,eAAe,EACf,cAAc,EACd,UAAU,EACV,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,OAAO,EACP,WAAW,EACZ,MAAM,gCAAgC,CAAC;AAwCxC;;;;;;;;GAQG;AACH,qBAAa,eAAgB,SAAQ,iBAAkB,YAAW,eAAe;IAC/E,+DAA+D;IAC/D,OAAO,CAAC,OAAO,CAAiC;IAEhD,2DAA2D;IAC3D,OAAO,CAAC,YAAY,CAA+B;IAEnD,OAAO,CAAC,UAAU,CAAS;IAG3B,OAAO,CAAC,cAAc,CACf;IAEP,SAAS,CAAC,QAAQ,CAAC,WAAW,qBAAqB;IAMnD;;;;OAIG;IACH,UAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAK1F;IAMD,UAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAE5D;IAMK,OAAO,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CA6ChE;IAEK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAmBhC;IAED,WAAW,IAAI,OAAO,CAErB;IAMD,OAAO,KAAK,EAAE,GAKb;IAMK,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzE;IAEK,MAAM,CAAC,QAAQ,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAG1D;IAEK,SAAS,CAAC,QAAQ,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAG7D;IAEK,MAAM,CAAC,QAAQ,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAG1D;IAEK,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAElC;IAEK,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAE7B;IAMK,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAE/B;IAMK,QAAQ,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAEhD;IAMK,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CASjE;IAMK,QAAQ,CACZ,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAC5B,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC,CA6CzB;IAMD,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAkClF;IAMK,IAAI,IAAI,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAIxC;IAEK,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7C;IAEK,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAS3C;IAEK,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG5C;IAMK,iBAAiB,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAYpE;IAEK,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAiBtF;IAEK,WAAW,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAY1D;CAUF"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2026 Steven Roussey <sroussey@gmail.com>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./ElectronBackend";
+//# 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;;;;GAIG;AAEH,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,247 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined")
+    return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/ElectronBackend.ts
+import { sleep } from "@workglow/util";
+import { CDPBrowserBackend } from "@workglow/browser-control/task";
+var electronModule = null;
+async function getElectron() {
+  if (!electronModule) {
+    electronModule = await new Function("m", "return import(m)")("electron");
+  }
+  return electronModule;
+}
+
+class ElectronBackend extends CDPBrowserBackend {
+  _window = null;
+  _webContents = null;
+  _connected = false;
+  _dialogHandler = null;
+  backendName = "ElectronBackend";
+  async cdp(method, params = {}) {
+    if (!this._webContents) {
+      throw new Error("ElectronBackend: not connected — call connect() first");
+    }
+    return this._webContents.debugger.sendCommand(method, params);
+  }
+  async evaluateInPage(script) {
+    return this.wc.executeJavaScript(script);
+  }
+  async connect(options = {}) {
+    const electron = await getElectron();
+    const { BrowserWindow, session: electronSession } = electron;
+    const { projectId = "default", profileName = "default", headless = false } = options;
+    const partitionString = `persist:${projectId}:${profileName}`;
+    const sess = electronSession.fromPartition(partitionString);
+    this._window = new BrowserWindow({
+      width: 1280,
+      height: 800,
+      show: !headless,
+      webPreferences: {
+        session: sess,
+        nodeIntegration: false,
+        contextIsolation: true
+      }
+    });
+    this._webContents = this._window.webContents;
+    try {
+      this._webContents.debugger.attach("1.3");
+    } catch {}
+    await this.cdp("Accessibility.enable");
+    this._webContents.on("select-client-certificate", (_event, _url, _list, callback) => {
+      callback(undefined);
+    });
+    this._webContents.on("will-prevent-unload", (event) => {
+      event.preventDefault();
+    });
+    this._connected = true;
+  }
+  async disconnect() {
+    this._connected = false;
+    try {
+      if (this._webContents) {
+        try {
+          this._webContents.debugger.detach();
+        } catch {}
+      }
+      if (this._window && !this._window.isDestroyed()) {
+        this._window.close();
+      }
+    } finally {
+      this._window = null;
+      this._webContents = null;
+      this._refMap.clear();
+      this._refCounter.count = 0;
+    }
+  }
+  isConnected() {
+    return this._connected && this._window !== null && !this._window.isDestroyed();
+  }
+  get wc() {
+    if (!this._webContents || !this._connected) {
+      throw new Error("ElectronBackend: not connected — call connect() first");
+    }
+    return this._webContents;
+  }
+  async navigate(url, _options = {}) {
+    await this.wc.loadURL(url);
+  }
+  async goBack(_options = {}) {
+    this.wc.navigationHistory.goBack();
+    await this.waitForNavigation();
+  }
+  async goForward(_options = {}) {
+    this.wc.navigationHistory.goForward();
+    await this.waitForNavigation();
+  }
+  async reload(_options = {}) {
+    this.wc.reload();
+    await this.waitForNavigation();
+  }
+  async currentUrl() {
+    return this.wc.getURL();
+  }
+  async title() {
+    return this.wc.getTitle();
+  }
+  async content() {
+    return this.wc.executeJavaScript("document.documentElement.outerHTML");
+  }
+  async evaluate(expression) {
+    return this.wc.executeJavaScript(expression);
+  }
+  async screenshot(options = {}) {
+    const { format = "png", quality } = options;
+    const image = await this.wc.capturePage();
+    if (format === "jpeg") {
+      return image.toJPEG(quality ?? 90);
+    }
+    return image.toPNG();
+  }
+  async download(trigger, options = {}) {
+    const os = await import("node:os");
+    const downloadDir = os.tmpdir();
+    const timeout = options.timeout ?? 30000;
+    await this.cdp("Browser.setDownloadBehavior", {
+      behavior: "allow",
+      downloadPath: downloadDir
+    });
+    let downloadPath = "";
+    let suggestedFilename = "";
+    const downloadPromise = new Promise((resolve, reject) => {
+      const timer = setTimeout(() => {
+        reject(new Error("ElectronBackend: download timed out"));
+      }, timeout);
+      const handler = (_event, item, _webContents) => {
+        suggestedFilename = item.getFilename ? item.getFilename() : "download";
+        item.once?.("done", (_e, state) => {
+          clearTimeout(timer);
+          if (state === "completed") {
+            downloadPath = item.getSavePath ? item.getSavePath() : downloadDir + "/" + suggestedFilename;
+          }
+          resolve();
+        });
+      };
+      this.wc.session.once("will-download", handler);
+    });
+    await trigger();
+    await downloadPromise;
+    if (!downloadPath) {
+      throw new Error("ElectronBackend: download failed — no path received");
+    }
+    return { path: downloadPath, suggestedFilename };
+  }
+  onDialog(handler) {
+    this._dialogHandler = handler;
+    this.cdp("Page.enable").then(() => {
+      this.wc.debugger.on("message", async (_event, method, params) => {
+        if (method !== "Page.javascriptDialogOpening")
+          return;
+        const info = {
+          type: params.type,
+          message: params.message,
+          defaultValue: params.defaultPrompt || undefined
+        };
+        if (this._dialogHandler) {
+          const action = await this._dialogHandler(info);
+          const accept = action.accept;
+          const promptText = accept && "promptText" in action ? action.promptText : undefined;
+          await this.cdp("Page.handleJavaScriptDialog", {
+            accept,
+            ...promptText !== undefined && { promptText }
+          });
+        } else {
+          await this.cdp("Page.handleJavaScriptDialog", { accept: false });
+        }
+      });
+    });
+  }
+  async tabs() {
+    const url = this.wc.getURL();
+    const title = this.wc.getTitle();
+    return [{ tabId: "0", url, title }];
+  }
+  async switchTab(_tabId) {}
+  async newTab(url) {
+    if (url) {
+      await this.navigate(url);
+    }
+    return {
+      tabId: "0",
+      url: this.wc.getURL(),
+      title: this.wc.getTitle()
+    };
+  }
+  async closeTab(_tabId) {
+    await this.disconnect();
+  }
+  async waitForNavigation(options = {}) {
+    const timeout = options.timeout ?? 30000;
+    return new Promise((resolve, reject) => {
+      const timer = setTimeout(() => {
+        reject(new Error("ElectronBackend: waitForNavigation timed out"));
+      }, timeout);
+      this.wc.once("did-finish-load", () => {
+        clearTimeout(timer);
+        resolve();
+      });
+    });
+  }
+  async waitForSelector(selector, options = {}) {
+    const timeout = options.timeout ?? 30000;
+    const interval = 100;
+    const deadline = Date.now() + timeout;
+    while (Date.now() < deadline) {
+      const found = await this.wc.executeJavaScript(`!!document.querySelector(${JSON.stringify(selector)})`);
+      if (found) {
+        const ref = await this.querySelector(selector);
+        if (ref)
+          return ref;
+      }
+      await sleep(interval);
+    }
+    throw new Error(`ElectronBackend: waitForSelector timed out for "${selector}"`);
+  }
+  async waitForIdle(options = {}) {
+    const timeout = options.timeout ?? 30000;
+    const interval = 100;
+    const deadline = Date.now() + timeout;
+    while (Date.now() < deadline) {
+      const ready = await this.wc.executeJavaScript(`document.readyState === "complete"`);
+      if (ready)
+        return;
+      await sleep(interval);
+    }
+    throw new Error("ElectronBackend: waitForIdle timed out");
+  }
+}
+export {
+  ElectronBackend
+};
+
+//# debugId=C66266ED378CDCB864756E2164756E21

package/dist/index.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/ElectronBackend.ts"],
+  "sourcesContent": [
+    "/**\n * @license\n * Copyright 2025 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { sleep } from \"@workglow/util\";\nimport { CDPBrowserBackend } from \"@workglow/browser-control/task\";\nimport type {\n  BrowserConnectOptions,\n  DialogAction,\n  DialogInfo,\n  DownloadOptions,\n  DownloadResult,\n  ElementRef,\n  IBrowserContext,\n  NavigateOptions,\n  ScreenshotOptions,\n  TabInfo,\n  WaitOptions,\n} from \"@workglow/browser-control/task\";\n\n// ---------------------------------------------------------------------------\n// Electron types (not imported at module level — lazy optional dependency)\n// ---------------------------------------------------------------------------\n\n/** @type {import(\"electron\").BrowserWindow} */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype AnyBrowserWindow = any;\n\n/** @type {import(\"electron\").WebContents} */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype AnyWebContents = any;\n\n// ---------------------------------------------------------------------------\n// Lazy Electron loader\n// ---------------------------------------------------------------------------\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nlet electronModule: Record<string, any> | null = null;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nasync function getElectron(): Promise<Record<string, any>> {\n  if (!electronModule) {\n    // Dynamic import keeps electron as a true optional dependency.\n    // The `Function` cast avoids a static \"cannot find module\" TS error\n    // when electron types are not installed in the current environment.\n    // eslint-disable-next-line @typescript-eslint/no-implied-eval\n    electronModule = (await new Function(\"m\", \"return import(m)\")(\"electron\")) as Record<\n      string,\n      any\n    >;\n  }\n  return electronModule;\n}\n\n// ---------------------------------------------------------------------------\n// ElectronBackend\n// ---------------------------------------------------------------------------\n\n/**\n * IBrowserContext implementation using Electron's native webContents + CDP.\n *\n * This file is only imported from the Electron main process. It must NOT be\n * included in browser/bun/node entry points.\n *\n * Session isolation is achieved via `session.fromPartition(partitionString)`\n * scoped to projectId + profileName.\n */\nexport class ElectronBackend extends CDPBrowserBackend implements IBrowserContext {\n  /** @type {AnyBrowserWindow} Electron BrowserWindow instance */\n  private _window: AnyBrowserWindow | null = null;\n\n  /** @type {AnyWebContents} Electron webContents instance */\n  private _webContents: AnyWebContents | null = null;\n\n  private _connected = false;\n\n  // Dialog handler\n  private _dialogHandler: ((info: DialogInfo) => DialogAction | Promise<DialogAction>) | null =\n    null;\n\n  protected readonly backendName = \"ElectronBackend\";\n\n  // ---------------------------------------------------------------------------\n  // CDP helper\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Send a Chrome DevTools Protocol command via the Electron debugger.\n   * @param method CDP method name (e.g. \"DOM.getBoxModel\")\n   * @param params CDP parameters\n   */\n  protected async cdp(method: string, params: Record<string, unknown> = {}): Promise<unknown> {\n    if (!this._webContents) {\n      throw new Error(\"ElectronBackend: not connected — call connect() first\");\n    }\n    return this._webContents.debugger.sendCommand(method, params);\n  }\n\n  // ---------------------------------------------------------------------------\n  // evaluateInPage (abstract from CDPBrowserBackend)\n  // ---------------------------------------------------------------------------\n\n  protected async evaluateInPage<T>(script: string): Promise<T> {\n    return this.wc.executeJavaScript(script);\n  }\n\n  // ---------------------------------------------------------------------------\n  // Lifecycle\n  // ---------------------------------------------------------------------------\n\n  async connect(options: BrowserConnectOptions = {}): Promise<void> {\n    const electron = await getElectron();\n    const { BrowserWindow, session: electronSession } = electron;\n\n    const { projectId = \"default\", profileName = \"default\", headless = false } = options;\n\n    const partitionString = `persist:${projectId}:${profileName}`;\n    const sess = electronSession.fromPartition(partitionString);\n\n    this._window = new BrowserWindow({\n      width: 1280,\n      height: 800,\n      show: !headless,\n      webPreferences: {\n        session: sess,\n        nodeIntegration: false,\n        contextIsolation: true,\n      },\n    }) as AnyBrowserWindow;\n\n    this._webContents = this._window.webContents as AnyWebContents;\n\n    // Attach CDP debugger\n    try {\n      this._webContents.debugger.attach(\"1.3\");\n    } catch {\n      // Already attached or version not supported — continue\n    }\n\n    // Enable Accessibility domain\n    await this.cdp(\"Accessibility.enable\");\n\n    // Wire dialog handler\n    this._webContents.on(\n      \"select-client-certificate\",\n      (_event: unknown, _url: unknown, _list: unknown, callback: (cert: unknown) => void) => {\n        callback(undefined);\n      }\n    );\n\n    this._webContents.on(\"will-prevent-unload\", (event: { preventDefault: () => void }) => {\n      event.preventDefault();\n    });\n\n    this._connected = true;\n  }\n\n  async disconnect(): Promise<void> {\n    this._connected = false;\n    try {\n      if (this._webContents) {\n        try {\n          this._webContents.debugger.detach();\n        } catch {\n          // Ignore detach errors\n        }\n      }\n      if (this._window && !this._window.isDestroyed()) {\n        this._window.close();\n      }\n    } finally {\n      this._window = null;\n      this._webContents = null;\n      this._refMap.clear();\n      this._refCounter.count = 0;\n    }\n  }\n\n  isConnected(): boolean {\n    return this._connected && this._window !== null && !this._window.isDestroyed();\n  }\n\n  // ---------------------------------------------------------------------------\n  // Internal helpers\n  // ---------------------------------------------------------------------------\n\n  private get wc(): AnyWebContents {\n    if (!this._webContents || !this._connected) {\n      throw new Error(\"ElectronBackend: not connected — call connect() first\");\n    }\n    return this._webContents;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Navigation\n  // ---------------------------------------------------------------------------\n\n  async navigate(url: string, _options: NavigateOptions = {}): Promise<void> {\n    await this.wc.loadURL(url);\n  }\n\n  async goBack(_options: NavigateOptions = {}): Promise<void> {\n    this.wc.navigationHistory.goBack();\n    await this.waitForNavigation();\n  }\n\n  async goForward(_options: NavigateOptions = {}): Promise<void> {\n    this.wc.navigationHistory.goForward();\n    await this.waitForNavigation();\n  }\n\n  async reload(_options: NavigateOptions = {}): Promise<void> {\n    this.wc.reload();\n    await this.waitForNavigation();\n  }\n\n  async currentUrl(): Promise<string> {\n    return this.wc.getURL();\n  }\n\n  async title(): Promise<string> {\n    return this.wc.getTitle();\n  }\n\n  // ---------------------------------------------------------------------------\n  // Content extraction\n  // ---------------------------------------------------------------------------\n\n  async content(): Promise<string> {\n    return this.wc.executeJavaScript(\"document.documentElement.outerHTML\") as Promise<string>;\n  }\n\n  // ---------------------------------------------------------------------------\n  // JS evaluation\n  // ---------------------------------------------------------------------------\n\n  async evaluate<T>(expression: string): Promise<T> {\n    return this.wc.executeJavaScript(expression) as Promise<T>;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Capture\n  // ---------------------------------------------------------------------------\n\n  async screenshot(options: ScreenshotOptions = {}): Promise<Buffer> {\n    const { format = \"png\", quality } = options;\n\n    const image = await this.wc.capturePage();\n\n    if (format === \"jpeg\") {\n      return image.toJPEG(quality ?? 90) as Buffer;\n    }\n    return image.toPNG() as Buffer;\n  }\n\n  // ---------------------------------------------------------------------------\n  // File operations\n  // ---------------------------------------------------------------------------\n\n  async download(\n    trigger: () => Promise<void>,\n    options: DownloadOptions = {}\n  ): Promise<DownloadResult> {\n    const os = await import(\"node:os\");\n    const downloadDir = os.tmpdir();\n    const timeout = options.timeout ?? 30_000;\n\n    // Set up download behavior via CDP\n    await this.cdp(\"Browser.setDownloadBehavior\", {\n      behavior: \"allow\",\n      downloadPath: downloadDir,\n    });\n\n    let downloadPath = \"\";\n    let suggestedFilename = \"\";\n\n    // Listen for download completion.\n    // Electron's will-download signature: (event, item, webContents)\n    const downloadPromise = new Promise<void>((resolve, reject) => {\n      const timer = setTimeout(() => {\n        reject(new Error(\"ElectronBackend: download timed out\"));\n      }, timeout);\n\n      const handler = (_event: unknown, item: AnyWebContents, _webContents: unknown) => {\n        // item is a DownloadItem\n        suggestedFilename = item.getFilename ? item.getFilename() : \"download\";\n        item.once?.(\"done\", (_e: unknown, state: string) => {\n          clearTimeout(timer);\n          if (state === \"completed\") {\n            downloadPath = item.getSavePath\n              ? item.getSavePath()\n              : downloadDir + \"/\" + suggestedFilename;\n          }\n          resolve();\n        });\n      };\n      this.wc.session.once(\"will-download\", handler);\n    });\n\n    await trigger();\n    await downloadPromise;\n\n    if (!downloadPath) {\n      throw new Error(\"ElectronBackend: download failed — no path received\");\n    }\n\n    return { path: downloadPath, suggestedFilename };\n  }\n\n  // ---------------------------------------------------------------------------\n  // Dialogs\n  // ---------------------------------------------------------------------------\n\n  onDialog(handler: (info: DialogInfo) => DialogAction | Promise<DialogAction>): void {\n    this._dialogHandler = handler;\n\n    // Use CDP Page.javascriptDialogOpening to intercept alert/confirm/prompt dialogs.\n    // This requires Page domain to be enabled.\n    void this.cdp(\"Page.enable\").then(() => {\n      this.wc.debugger.on(\n        \"message\",\n        async (_event: unknown, method: string, params: Record<string, unknown>) => {\n          if (method !== \"Page.javascriptDialogOpening\") return;\n\n          const info: DialogInfo = {\n            type: params.type as DialogInfo[\"type\"],\n            message: params.message as string,\n            defaultValue: (params.defaultPrompt as string) || undefined,\n          };\n\n          if (this._dialogHandler) {\n            const action = await this._dialogHandler(info);\n            const accept = action.accept;\n            const promptText =\n              accept && \"promptText\" in action\n                ? (action as { accept: true; promptText?: string }).promptText\n                : undefined;\n            await this.cdp(\"Page.handleJavaScriptDialog\", {\n              accept,\n              ...(promptText !== undefined && { promptText }),\n            });\n          } else {\n            await this.cdp(\"Page.handleJavaScriptDialog\", { accept: false });\n          }\n        }\n      );\n    });\n  }\n\n  // ---------------------------------------------------------------------------\n  // Tabs (simplified single-window model)\n  // ---------------------------------------------------------------------------\n\n  async tabs(): Promise<readonly TabInfo[]> {\n    const url = this.wc.getURL();\n    const title = this.wc.getTitle();\n    return [{ tabId: \"0\", url, title }];\n  }\n\n  async switchTab(_tabId: string): Promise<void> {\n    // Single-window model: no-op\n  }\n\n  async newTab(url?: string): Promise<TabInfo> {\n    if (url) {\n      await this.navigate(url);\n    }\n    return {\n      tabId: \"0\",\n      url: this.wc.getURL(),\n      title: this.wc.getTitle(),\n    };\n  }\n\n  async closeTab(_tabId: string): Promise<void> {\n    // Single-window model: closing the tab means closing the window\n    await this.disconnect();\n  }\n\n  // ---------------------------------------------------------------------------\n  // Wait\n  // ---------------------------------------------------------------------------\n\n  async waitForNavigation(options: NavigateOptions = {}): Promise<void> {\n    const timeout = options.timeout ?? 30_000;\n    return new Promise<void>((resolve, reject) => {\n      const timer = setTimeout(() => {\n        reject(new Error(\"ElectronBackend: waitForNavigation timed out\"));\n      }, timeout);\n\n      this.wc.once(\"did-finish-load\", () => {\n        clearTimeout(timer);\n        resolve();\n      });\n    });\n  }\n\n  async waitForSelector(selector: string, options: WaitOptions = {}): Promise<ElementRef> {\n    const timeout = options.timeout ?? 30_000;\n    const interval = 100;\n    const deadline = Date.now() + timeout;\n\n    while (Date.now() < deadline) {\n      const found = await this.wc.executeJavaScript(\n        `!!document.querySelector(${JSON.stringify(selector)})`\n      );\n      if (found) {\n        const ref = await this.querySelector(selector);\n        if (ref) return ref;\n      }\n      await sleep(interval);\n    }\n\n    throw new Error(`ElectronBackend: waitForSelector timed out for \"${selector}\"`);\n  }\n\n  async waitForIdle(options: WaitOptions = {}): Promise<void> {\n    const timeout = options.timeout ?? 30_000;\n    const interval = 100;\n    const deadline = Date.now() + timeout;\n\n    while (Date.now() < deadline) {\n      const ready = await this.wc.executeJavaScript(`document.readyState === \"complete\"`);\n      if (ready) return;\n      await sleep(interval);\n    }\n\n    throw new Error(\"ElectronBackend: waitForIdle timed out\");\n  }\n\n  // ---------------------------------------------------------------------------\n  // Optional capabilities\n  // ---------------------------------------------------------------------------\n  //\n  // networkRequests and consoleMessages are intentionally undefined: this\n  // backend does not implement them. The IBrowserContext contract is that\n  // optional methods are either fully implemented or undefined — never\n  // empty-stub functions that defeat feature detection.\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "C66266ED378CDCB864756E2164756E21",
+  "names": []
+}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@workglow/electron",
+  "type": "module",
+  "sideEffects": false,
+  "version": "0.2.32",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/workglow-dev/workglow.git",
+    "directory": "providers/electron"
+  },
+  "description": "Electron native-webContents browser backend for @workglow/browser-control.",
+  "scripts": {
+    "watch": "concurrently -c 'auto' 'bun:watch-*'",
+    "watch-code": "bun build --watch --no-clear-screen --sourcemap=external --packages=external --root ./src --outdir ./dist ./src/index.ts",
+    "watch-types": "tsc --watch --preserveWatchOutput",
+    "build-package": "concurrently -c 'auto' -n 'code,types' 'bun run build-code' 'bun run build-types'",
+    "build-js": "bun run build-code",
+    "build-clean": "rm -fr dist/* tsconfig.tsbuildinfo",
+    "build-code": "bun build --sourcemap=external --packages=external --root ./src --outdir ./dist ./src/index.ts",
+    "build-types": "rm -f tsconfig.tsbuildinfo && tsgo",
+    "lint": "eslint . --ext ts,tsx --report-unused-disable-directives --max-warnings 0",
+    "test": "bun test"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "electron": "^42.0.0"
+  },
+  "peerDependencies": {
+    "@workglow/browser-control": "0.2.32",
+    "@workglow/util": "0.2.32"
+  },
+  "peerDependenciesMeta": {
+    "@workglow/browser-control": {
+      "optional": false
+    },
+    "@workglow/util": {
+      "optional": false
+    }
+  },
+  "devDependencies": {
+    "@workglow/browser-control": "0.2.32",
+    "@workglow/util": "0.2.32"
+  },
+  "files": [
+    "dist",
+    "src/**/*.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}