craftdriver 1.3.0 → 1.5.0

package/dist/lib/electronRemote.js

@@ -0,0 +1,406 @@
+/**
+ * `browser.electron` — the optional Electron **main-process** capability
+ * namespace. Deliberately not an `ElectronApp` class: the renderer stays on the
+ * ordinary `Browser` API; this adds only what the DOM surface can't reach.
+ *
+ * `executeMain(fn, ...args)` runs `fn(electron, ...args)` in the app's main
+ * process (Node context, full `electron` module) and returns its JSON-
+ * serializable result. It's named `executeMain` — not `execute` — so the process
+ * boundary is loud at every call site: `browser.evaluate()` runs in the renderer,
+ * `browser.electron.executeMain()` in the powerful main process. (WDIO calls this
+ * `browser.electron.execute`; the rename is a one-time migration cost.)
+ */
+import { CraftdriverError, ErrorCode } from './errors.js';
+import { ElectronMainBridge } from './electronMainBridge.js';
+import { ElectronMainLogMonitor, } from './electronMainLogs.js';
+import { ElectronDialogMockHandle, validateDialogResult, } from './electronDialogMock.js';
+import { ElectronMockHandle, validateMockTarget, } from './electronMock.js';
+import { executeDeeplinkCommand, getPlatformCommand, resolveDeeplinkUrl, validateDeeplinkUrl, } from './electronDeeplink.js';
+import { readInspectArgumentsFuse } from './electronFuses.js';
+function assertJsonSerializable(value, path = 'arg', stack = new Set()) {
+    if (value === null || typeof value === 'string' || typeof value === 'boolean')
+        return;
+    if (typeof value === 'number') {
+        if (Number.isFinite(value))
+            return;
+        throw new CraftdriverError(ErrorCode.EVAL_BAD_ARG, `executeMain(fn, ...args): ${path} must be a finite JSON number.`, { detail: { path, argType: 'number' } });
+    }
+    if (Array.isArray(value)) {
+        if (stack.has(value)) {
+            throw new CraftdriverError(ErrorCode.EVAL_BAD_ARG, `executeMain(fn, ...args): ${path} contains a circular reference.`, { detail: { path, argType: 'array' } });
+        }
+        stack.add(value);
+        try {
+            value.forEach((item, index) => assertJsonSerializable(item, `${path}[${index}]`, stack));
+        }
+        finally {
+            stack.delete(value);
+        }
+        return;
+    }
+    if (typeof value === 'object') {
+        const proto = Object.getPrototypeOf(value);
+        if (proto !== Object.prototype && proto !== null) {
+            throw new CraftdriverError(ErrorCode.EVAL_BAD_ARG, `executeMain(fn, ...args): ${path} must be a plain JSON object.`, { detail: { path, argType: proto?.constructor?.name ?? 'object' } });
+        }
+        const obj = value;
+        if (stack.has(obj)) {
+            throw new CraftdriverError(ErrorCode.EVAL_BAD_ARG, `executeMain(fn, ...args): ${path} contains a circular reference.`, { detail: { path, argType: 'object' } });
+        }
+        stack.add(obj);
+        try {
+            for (const [key, item] of Object.entries(obj)) {
+                assertJsonSerializable(item, `${path}.${key}`, stack);
+            }
+        }
+        finally {
+            stack.delete(obj);
+        }
+        return;
+    }
+    throw new CraftdriverError(ErrorCode.EVAL_BAD_ARG, `executeMain(fn, ...args): ${path} of type "${typeof value}" is not JSON-serializable.`, { detail: { path, argType: typeof value } });
+}
+/**
+ * Run code in the Electron main process via `browser.electron.executeMain`.
+ * Named `executeMain` (not WDIO's `execute`) so the process boundary is loud:
+ * `browser.evaluate()` is the renderer, `executeMain()` the main process.
+ */
+export class ElectronRemote {
+    #bridge;
+    #connect;
+    #appBinaryPath;
+    #userDataDir;
+    #mainLogs = new ElectronMainLogMonitor();
+    #dialogMocks = new Map();
+    #apiMocks = new Map();
+    /** `connect` is undefined for non-Electron sessions or when `mainProcess` wasn't enabled. */
+    constructor(connect, options) {
+        this.#connect = connect;
+        this.#appBinaryPath = options?.appBinaryPath;
+    }
+    /**
+     * Captured **main-process** console output and errors — the main-process
+     * counterpart to `browser.logs`. Populated from launch when the session was
+     * started with `electron: { mainProcess: true }` (empty otherwise). See
+     * {@link ElectronMainLogMonitor}.
+     *
+     * ```ts
+     * await browser.electron.executeMain((electron) => console.log('ready', electron.app.getName()));
+     * const [entry] = browser.electron.mainLogs.getLogs();
+     * ```
+     */
+    get mainLogs() {
+        return this.#mainLogs;
+    }
+    /**
+     * Open the main-process bridge now (rather than lazily on first `executeMain`)
+     * so `mainLogs` captures from launch. No-op without a main-process inspector;
+     * best-effort — the caller (Browser.launch) swallows failures so a disabled
+     * inspector fuse never breaks renderer automation.
+     */
+    async connect() {
+        if (!this.#connect)
+            return;
+        await this.#ensureConnected();
+    }
+    /**
+     * Run `fn` in the Electron **main process**. `fn` receives the `electron`
+     * module first, then your `args` (which must be JSON-serializable). The return
+     * value is passed back by value, so it must be JSON-serializable too.
+     *
+     * ```ts
+     * const version = await browser.electron.executeMain(
+     *   (electron) => electron.app.getVersion(),
+     * );
+     * ```
+     */
+    async executeMain(fn, ...args) {
+        if (!this.#connect) {
+            throw new CraftdriverError(ErrorCode.ELECTRON_MAIN_UNAVAILABLE, 'Electron main-process access is not available for this session.', {
+                hint: 'Launch with `electron: { mainProcess: true }` to enable it. Browser sessions, and ' +
+                    'Electron launches without that flag, do not expose the main process.',
+            });
+        }
+        if (typeof fn !== 'function') {
+            throw new CraftdriverError(ErrorCode.INVALID_ARGUMENT, 'executeMain(fn, ...args): fn must be a function.');
+        }
+        // Args cross the wire as a JSON literal. Validate recursively instead of
+        // relying on JSON.stringify(), which silently turns values like undefined,
+        // functions, Symbols, NaN, and Infinity into null inside arrays/objects.
+        args.forEach((arg, index) => assertJsonSerializable(arg, `arg[${index}]`));
+        const bridge = await this.#ensureConnected();
+        return bridge.executeMain(fn.toString(), args);
+    }
+    /**
+     * Replace any `electron.<api>.<fn>` **main-process** method with a scripted
+     * return value and call recorder. The general primitive behind the typed
+     * {@link mockDialog} convenience — reach for it for `shell.openExternal`,
+     * `app.getPath`, `safeStorage.encryptString`, and other Electron APIs.
+     *
+     * The app is not modified: the replacement lives in its main process for this
+     * session and is restored by `mock.restore()` or `browser.quit()`. The scripted
+     * value is returned **as-is** (not wrapped in a Promise), so it works for both
+     * synchronous methods and `await`ed asynchronous ones. Provide the resolved
+     * value for an async method; recorded call args and the return value must be
+     * JSON-serializable.
+     *
+     * ```ts
+     * const openExternal = await browser.electron.mock('shell', 'openExternal', true);
+     * await browser.click(By.testId('open-docs'));
+     * expect(await openExternal.getCalls()).toEqual([{ args: ['https://example.com/docs'] }]);
+     * ```
+     */
+    async mock(api, fn, returnValue) {
+        validateMockTarget(api, fn);
+        const key = `${api}.${fn}`;
+        if (this.#apiMocks.has(key)) {
+            throw new CraftdriverError(ErrorCode.STATE_INVALID, `electron.${key} is already mocked. Restore that mock before replacing it.`);
+        }
+        const id = `${Date.now()}-${Math.random().toString(36).slice(2)}`;
+        // `undefined` can't cross executeMain's JSON-arg validation, so carry a
+        // presence flag and a JSON-safe placeholder; the callback restores undefined.
+        const hasResult = returnValue !== undefined;
+        await this.executeMain((electron, apiName, funcName, mockId, resultPresent, scriptedResult) => {
+            const registryKey = Symbol.for('craftdriver.electron.apiMocks');
+            const globals = globalThis;
+            const registry = (globals[registryKey] ??= Object.create(null));
+            const entryKey = `${apiName}.${funcName}`;
+            if (registry[entryKey])
+                throw new Error(`Mock ${entryKey} is already active.`);
+            const namespace = electron[apiName];
+            if (!namespace || typeof namespace !== 'object') {
+                throw new Error(`electron.${apiName} is not available in this Electron build.`);
+            }
+            const original = namespace[funcName];
+            if (typeof original !== 'function') {
+                throw new Error(`electron.${entryKey} is not a function in this Electron build.`);
+            }
+            const jsonSafe = (value, seen = new WeakSet()) => {
+                if (value === null || typeof value === 'string' || typeof value === 'boolean')
+                    return value;
+                if (typeof value === 'number')
+                    return Number.isFinite(value) ? value : String(value);
+                if (typeof value !== 'object')
+                    return `[${typeof value}]`;
+                if (seen.has(value))
+                    return '[Circular]';
+                seen.add(value);
+                try {
+                    if (Array.isArray(value))
+                        return value.map((item) => jsonSafe(item, seen));
+                    const proto = Object.getPrototypeOf(value);
+                    if (proto !== Object.prototype && proto !== null) {
+                        return `[${proto?.constructor?.name ?? 'Object'}]`;
+                    }
+                    const copy = {};
+                    for (const [name, item] of Object.entries(value))
+                        copy[name] = jsonSafe(item, seen);
+                    return copy;
+                }
+                finally {
+                    seen.delete(value);
+                }
+            };
+            const entry = {
+                id: mockId,
+                original: original,
+                calls: [],
+                result: resultPresent ? scriptedResult : undefined,
+                replacement: undefined,
+            };
+            const replacement = (...args) => {
+                entry.calls.push({ args: args.map((a) => jsonSafe(a)) });
+                // Return a fresh clone so a caller mutating the result can't corrupt the
+                // scripted value for later calls. Returned as-is (sync), so both sync and
+                // awaited-async callers see the value.
+                return entry.result === undefined ? undefined : JSON.parse(JSON.stringify(entry.result));
+            };
+            entry.replacement = replacement;
+            registry[entryKey] = entry;
+            namespace[funcName] = replacement;
+        }, api, fn, id, hasResult, hasResult ? returnValue : null);
+        const mock = new ElectronMockHandle(this, api, fn, id, () => {
+            this.#apiMocks.delete(key);
+        });
+        this.#apiMocks.set(key, mock);
+        return mock;
+    }
+    /**
+     * Open a custom-protocol **deep link** (`myapp://…`) against the running app,
+     * exactly as the OS would when another app or the browser hands off the URL —
+     * so your app's real `open-url` (macOS) / `second-instance` (Windows, Linux)
+     * handler runs. Fire-and-forget: it resolves once the OS launcher is spawned;
+     * assert the effect through your app afterwards (e.g. `waitForLog`, a renderer
+     * assertion, or `executeMain`).
+     *
+     * Your app must register the protocol (`app.setAsDefaultProtocolClient(...)`)
+     * and take the single-instance lock. On Windows and Linux a raw deep link would
+     * spawn a *second* instance; craftdriver appends the running app's user-data dir
+     * as a `userData` query parameter so the second instance can route the URL to
+     * the test instance (auto-detected via the main process when available).
+     *
+     * ```ts
+     * await browser.electron.triggerDeeplink('myapp://open?file=test.txt');
+     * const entry = await browser.electron.mainLogs.waitForLog((l) => l.text.includes('open-url'));
+     * ```
+     */
+    async triggerDeeplink(url) {
+        const platform = process.platform;
+        // Validate before any detection work so a bad URL fails fast and identically
+        // on every platform.
+        validateDeeplinkUrl(url);
+        // Windows/Linux need the running app's user-data dir to route the URL to this
+        // instance; detect it once (best-effort) via the main process, then cache it.
+        let userDataDir = this.#userDataDir;
+        if (!userDataDir && (platform === 'win32' || platform === 'linux') && this.#connect) {
+            try {
+                userDataDir = await this.executeMain((electron) => electron.app.getPath('userData'));
+                this.#userDataDir = userDataDir;
+            }
+            catch {
+                // Fall through: without it the deep link may open a fresh instance. The
+                // command still runs; the caller's post-assertion will reveal a miss.
+            }
+        }
+        const finalUrl = resolveDeeplinkUrl(url, platform, userDataDir);
+        const { command, args } = getPlatformCommand(finalUrl, platform, this.#appBinaryPath);
+        await executeDeeplinkCommand(command, args);
+    }
+    async mockDialog(method, result) {
+        if (!['showOpenDialog', 'showSaveDialog', 'showMessageBox'].includes(method)) {
+            throw new CraftdriverError(ErrorCode.INVALID_ARGUMENT, `Unsupported Electron dialog method "${String(method)}".`, {
+                hint: 'Use showOpenDialog, showSaveDialog, or showMessageBox.',
+                detail: { method },
+            });
+        }
+        validateDialogResult(method, result);
+        if (this.#dialogMocks.has(method)) {
+            throw new CraftdriverError(ErrorCode.STATE_INVALID, `electron.dialog.${method} is already mocked. Restore that mock before replacing it.`);
+        }
+        const id = `${Date.now()}-${Math.random().toString(36).slice(2)}`;
+        await this.executeMain((electron, dialogMethod, mockId, scriptedResult) => {
+            const methodName = dialogMethod;
+            const key = Symbol.for('craftdriver.electron.dialogMocks');
+            const globals = globalThis;
+            const registry = (globals[key] ??= Object.create(null));
+            if (registry[methodName])
+                throw new Error(`Dialog mock ${methodName} is already active.`);
+            const dialog = electron
+                .dialog;
+            const original = dialog[methodName];
+            if (typeof original !== 'function') {
+                throw new Error(`electron.dialog.${methodName} is not available in this Electron build.`);
+            }
+            const entry = {
+                id: mockId,
+                original,
+                calls: [],
+                result: scriptedResult,
+                replacement: undefined,
+            };
+            const jsonSafe = (value, seen = new WeakSet()) => {
+                if (value === null || typeof value === 'string' || typeof value === 'boolean')
+                    return value;
+                if (typeof value === 'number')
+                    return Number.isFinite(value) ? value : String(value);
+                if (typeof value !== 'object')
+                    return `[${typeof value}]`;
+                if (seen.has(value))
+                    return '[Circular]';
+                seen.add(value);
+                try {
+                    if (Array.isArray(value))
+                        return value.map((item) => jsonSafe(item, seen));
+                    const proto = Object.getPrototypeOf(value);
+                    if (proto !== Object.prototype && proto !== null) {
+                        return `[${proto?.constructor?.name ?? 'Object'}]`;
+                    }
+                    const copy = {};
+                    for (const [name, item] of Object.entries(value))
+                        copy[name] = jsonSafe(item, seen);
+                    return copy;
+                }
+                finally {
+                    seen.delete(value);
+                }
+            };
+            const replacement = (...args) => {
+                const options = args.length > 1 ? args[1] : args[0];
+                entry.calls.push({ options: jsonSafe(options) });
+                return Promise.resolve(JSON.parse(JSON.stringify(entry.result)));
+            };
+            entry.replacement = replacement;
+            registry[methodName] = entry;
+            dialog[methodName] = replacement;
+        }, method, id, result);
+        const mock = new ElectronDialogMockHandle(this, method, id, () => {
+            this.#dialogMocks.delete(method);
+        });
+        this.#dialogMocks.set(method, mock);
+        return mock;
+    }
+    async #ensureConnected() {
+        if (!this.#bridge) {
+            const bridge = new ElectronMainBridge(this.#connect.host, this.#connect.port);
+            try {
+                await bridge.connect();
+                // Route CDP Runtime events into the log monitor, then enable the domain.
+                // Order matters: the listener must be armed before Runtime.enable so the
+                // inspector's replayed console backlog is captured, not dropped.
+                bridge.onEvent((method, params) => {
+                    if (method === 'Runtime.consoleAPICalled') {
+                        this.#mainLogs.ingestConsoleEvent(params);
+                    }
+                    else if (method === 'Runtime.exceptionThrown') {
+                        this.#mainLogs.ingestExceptionEvent(params);
+                    }
+                });
+                await bridge.enableRuntime();
+            }
+            catch (error) {
+                await bridge.close().catch(() => { });
+                throw this.#enrichUnreachable(error);
+            }
+            this.#bridge = bridge;
+        }
+        return this.#bridge;
+    }
+    /**
+     * When the main-process inspector is unreachable, read the app's
+     * `EnableNodeCliInspectArguments` fuse: if it's provably disabled/removed, upgrade
+     * the generic "inspector unreachable" into a precise, actionable error. Any other
+     * status (enabled, or unreadable) leaves the original error — which already names
+     * the fuse as the likely cause — untouched.
+     */
+    #enrichUnreachable(error) {
+        if (!CraftdriverError.is(error, ErrorCode.ELECTRON_MAIN_UNAVAILABLE))
+            return error;
+        const status = readInspectArgumentsFuse(this.#appBinaryPath);
+        if (status !== 'disabled' && status !== 'removed')
+            return error;
+        return new CraftdriverError(ErrorCode.ELECTRON_MAIN_UNAVAILABLE, `This Electron build has the EnableNodeCliInspectArguments fuse ${status}, so its main ` +
+            'process cannot be reached — browser.electron.executeMain / mock / mockDialog / mainLogs ' +
+            'are unavailable. Renderer automation is unaffected.', {
+            cause: error,
+            hint: 'Package a test build with the EnableNodeCliInspectArguments fuse enabled (the default) ' +
+                'before code signing; a disabled fuse cannot be changed after signing.',
+            detail: {
+                fuse: 'EnableNodeCliInspectArguments',
+                fuseStatus: status,
+                appBinaryPath: this.#appBinaryPath,
+            },
+        });
+    }
+    /** Close the underlying inspector connection. Called from `Browser.quit()`. */
+    async close() {
+        for (const mock of [...this.#dialogMocks.values(), ...this.#apiMocks.values()]) {
+            await mock.restore().catch(() => { });
+        }
+        this.#dialogMocks.clear();
+        this.#apiMocks.clear();
+        const bridge = this.#bridge;
+        this.#bridge = undefined;
+        await bridge?.close();
+    }
+}
+//# sourceMappingURL=electronRemote.js.map

package/dist/lib/electronRemote.js.map

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

package/dist/lib/electronVersions.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Electron → Chromium major-version map, used to resolve a matching
+ * Chrome-for-Testing chromedriver from an app's Electron version — so an Electron
+ * user can drop the `electron-chromedriver` dependency (see
+ * {@link resolveElectronChromeDriverInfo}).
+ *
+ * WHY A VENDORED MAP (not the `electron-to-chromium` package WDIO uses):
+ * craftdriver ships an intentionally tiny dependency surface, and Electron is an
+ * optional target — pulling a data package into every install (or making users
+ * install one) to serve a niche feature isn't worth it. The chromedriver
+ * downloader only needs the Chromium **major** to pick a compatible driver
+ * (`downloadChromedriver` matches within a major), and Electron bumps its
+ * Chromium major roughly quarterly, so this table is small and slow-moving.
+ *
+ * MAINTENANCE: add one row per new Electron major. Source of truth for a pair is
+ * the `electron-to-chromium` package or https://electronjs.org/headers/index.json
+ * (both list the exact Chromium each Electron release bundles). An unmapped
+ * version fails with actionable guidance rather than guessing, so a missing row
+ * is a clear error, never a wrong driver.
+ *
+ * COVERAGE NOTE: Chrome for Testing only publishes chromedriver for Chromium
+ * >= 115 (Electron >= 26), and a brand-new Chromium major can lag CfT by weeks.
+ * Mapping a version whose Chromium isn't in CfT yet still fails at download with
+ * CfT's own "no chromedriver found" error — pin `electron-chromedriver` or an
+ * explicit `chromedriverPath` for those.
+ */
+/**
+ * Map an Electron version to the Chromium **major** it bundles, or `undefined`
+ * when the version is malformed or not in the vendored table. Pure — no I/O.
+ */
+export declare function chromiumMajorForElectron(electronVersion: string): number | undefined;
+/** The Electron majors this build knows how to map, ascending — for diagnostics. */
+export declare function knownElectronMajors(): number[];
+//# sourceMappingURL=electronVersions.d.ts.map

package/dist/lib/electronVersions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"electronVersions.d.ts","sourceRoot":"","sources":["../../src/lib/electronVersions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAkDH;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIpF;AAED,oFAAoF;AACpF,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAI9C"}

package/dist/lib/electronVersions.js

@@ -0,0 +1,90 @@
+/**
+ * Electron → Chromium major-version map, used to resolve a matching
+ * Chrome-for-Testing chromedriver from an app's Electron version — so an Electron
+ * user can drop the `electron-chromedriver` dependency (see
+ * {@link resolveElectronChromeDriverInfo}).
+ *
+ * WHY A VENDORED MAP (not the `electron-to-chromium` package WDIO uses):
+ * craftdriver ships an intentionally tiny dependency surface, and Electron is an
+ * optional target — pulling a data package into every install (or making users
+ * install one) to serve a niche feature isn't worth it. The chromedriver
+ * downloader only needs the Chromium **major** to pick a compatible driver
+ * (`downloadChromedriver` matches within a major), and Electron bumps its
+ * Chromium major roughly quarterly, so this table is small and slow-moving.
+ *
+ * MAINTENANCE: add one row per new Electron major. Source of truth for a pair is
+ * the `electron-to-chromium` package or https://electronjs.org/headers/index.json
+ * (both list the exact Chromium each Electron release bundles). An unmapped
+ * version fails with actionable guidance rather than guessing, so a missing row
+ * is a clear error, never a wrong driver.
+ *
+ * COVERAGE NOTE: Chrome for Testing only publishes chromedriver for Chromium
+ * >= 115 (Electron >= 26), and a brand-new Chromium major can lag CfT by weeks.
+ * Mapping a version whose Chromium isn't in CfT yet still fails at download with
+ * CfT's own "no chromedriver found" error — pin `electron-chromedriver` or an
+ * explicit `chromedriverPath` for those.
+ */
+/**
+ * Electron major → bundled Chromium major. Kept as majors because the CfT
+ * chromedriver selection is major-scoped; a driver is compatible across a
+ * Chromium major, so the exact build isn't needed to pick the right one.
+ */
+const ELECTRON_MAJOR_TO_CHROMIUM_MAJOR = {
+    // Historical, CfT-covered range (Chromium >= 115). Verified against
+    // electron-to-chromium.
+    26: 116,
+    27: 118,
+    28: 120,
+    29: 122,
+    30: 124,
+    31: 126,
+    32: 128,
+    33: 130,
+    34: 132,
+    35: 134,
+    36: 136,
+    37: 138,
+    38: 140,
+    // 39 verified live: Fiddler Everywhere 7.8 is Electron 39.8.6 / Chromium 142
+    // (read from its Electron Framework), driven end-to-end. 40–42 follow the exact
+    // +2-Chromium-major-per-Electron-major cadence this table holds across 26→43
+    // (37→138, 38→140, 39→142, … 43→150); re-verify against electron-to-chromium
+    // when an app pins one.
+    39: 142,
+    40: 144,
+    41: 146,
+    42: 148,
+    // craftdriver's own compatibility target (see docs/electron.md): Electron
+    // 43.1.0 bundles Chromium 150. Verified end-to-end: CfT publishes a matching
+    // chromedriver (150.0.7871.115), so `electron: { version: '43.1.0' }` resolves
+    // a matching driver with no electron-chromedriver dependency.
+    43: 150,
+};
+/**
+ * Parse the leading integer major from an Electron version string
+ * (`'43.1.0'` → 43, `'37'` → 37). Returns `undefined` for anything without a
+ * numeric leading component.
+ */
+function electronMajor(version) {
+    const match = /^\s*(\d+)/.exec(version);
+    if (!match)
+        return undefined;
+    return Number.parseInt(match[1], 10);
+}
+/**
+ * Map an Electron version to the Chromium **major** it bundles, or `undefined`
+ * when the version is malformed or not in the vendored table. Pure — no I/O.
+ */
+export function chromiumMajorForElectron(electronVersion) {
+    const major = electronMajor(electronVersion);
+    if (major === undefined)
+        return undefined;
+    return ELECTRON_MAJOR_TO_CHROMIUM_MAJOR[major];
+}
+/** The Electron majors this build knows how to map, ascending — for diagnostics. */
+export function knownElectronMajors() {
+    return Object.keys(ELECTRON_MAJOR_TO_CHROMIUM_MAJOR)
+        .map((k) => Number.parseInt(k, 10))
+        .sort((a, b) => a - b);
+}
+//# sourceMappingURL=electronVersions.js.map

package/dist/lib/electronVersions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"electronVersions.js","sourceRoot":"","sources":["../../src/lib/electronVersions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH;;;;GAIG;AACH,MAAM,gCAAgC,GAAqC;IACzE,oEAAoE;IACpE,wBAAwB;IACxB,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,GAAG;IACP,6EAA6E;IAC7E,gFAAgF;IAChF,6EAA6E;IAC7E,6EAA6E;IAC7E,wBAAwB;IACxB,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,GAAG;IACP,0EAA0E;IAC1E,6EAA6E;IAC7E,+EAA+E;IAC/E,8DAA8D;IAC9D,EAAE,EAAE,GAAG;CACR,CAAC;AAEF;;;;GAIG;AACH,SAAS,aAAa,CAAC,OAAe;IACpC,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,eAAuB;IAC9D,MAAM,KAAK,GAAG,aAAa,CAAC,eAAe,CAAC,CAAC;IAC7C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,OAAO,gCAAgC,CAAC,KAAK,CAAC,CAAC;AACjD,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,mBAAmB;IACjC,OAAO,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC;SACjD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;SAClC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAC3B,CAAC"}

package/dist/lib/errors.d.ts

@@ -39,6 +39,33 @@ export declare const ErrorCode: {
     readonly STATE_INVALID: "STATE_INVALID";
     /** Driver-level / transport-level failure surfaced to the caller. */
     readonly DRIVER_ERROR: "DRIVER_ERROR";
+    /**
+     * The resolved chromedriver doesn't match the Electron app before a session is
+     * created — wrong bundled-Chromium major or wrong CPU arch. `detail.kind`
+     * distinguishes `'chromium-major'` from `'arch'`.
+     */
+    readonly ELECTRON_DRIVER_MISMATCH: "ELECTRON_DRIVER_MISMATCH";
+    /**
+     * The Electron app process exited during session creation ("Chrome instance
+     * exited"). `detail`/`hint` carry the diagnosed likely cause (macOS
+     * signing/Gatekeeper, Linux sandbox) plus the chromedriver output tail.
+     */
+    readonly ELECTRON_LAUNCH_FAILED: "ELECTRON_LAUNCH_FAILED";
+    /**
+     * `browser.electron.executeMain(...)` couldn't reach the app's main process —
+     * main-process access wasn't enabled (`electron: { mainProcess: true }`), the
+     * session isn't an Electron one, or the Node inspector is unavailable (e.g. the
+     * `EnableNodeCliInspectArguments` fuse is disabled). `hint` names the fix.
+     */
+    readonly ELECTRON_MAIN_UNAVAILABLE: "ELECTRON_MAIN_UNAVAILABLE";
+    /** The `executeMain(...)` callback threw inside the Electron main process. */
+    readonly ELECTRON_MAIN_THREW: "ELECTRON_MAIN_THREW";
+    /**
+     * `browser.electron.triggerDeeplink(url)` could not open the custom-protocol URL —
+     * an invalid/`http(s)`/`file` URL (use {@link INVALID_ARGUMENT}'s sibling check),
+     * an unsupported platform, or the OS `open`/`gio`/`rundll32` launcher failed.
+     */
+    readonly ELECTRON_DEEPLINK_FAILED: "ELECTRON_DEEPLINK_FAILED";
 };
 export type ErrorCodeName = keyof typeof ErrorCode;
 export type ErrorCodeValue = (typeof ErrorCode)[ErrorCodeName];

package/dist/lib/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS;IACpB,+DAA+D;;IAE/D,yEAAyE;;IAEzE,wGAAwG;;IAExG,kEAAkE;;IAElE,0EAA0E;;IAE1E,kEAAkE;;IAElE,2DAA2D;;IAE3D,4DAA4D;;IAE5D,2DAA2D;;IAE3D,iDAAiD;;IAEjD,iFAAiF;;IAEjF,6EAA6E;;IAE7E,uGAAuG;;IAEvG,kFAAkF;;IAElF,qEAAqE;;CAE7D,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,SAAS,CAAC;AACnD,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,aAAa,CAAC,CAAC;AAE/D,MAAM,WAAW,uBAAuB;IACtC,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,8DAA8D;IAC9D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;GASG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;gBAEX,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,uBAAuB;IAQpF,wDAAwD;IACxD,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,GAAG,IAAI,gBAAgB;CAIxE;AAqBD,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACvB,OAAO,CAAC,CAAC,CAAC,CAQZ"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS;IACpB,+DAA+D;;IAE/D,yEAAyE;;IAEzE,wGAAwG;;IAExG,kEAAkE;;IAElE,0EAA0E;;IAE1E,kEAAkE;;IAElE,2DAA2D;;IAE3D,4DAA4D;;IAE5D,2DAA2D;;IAE3D,iDAAiD;;IAEjD,iFAAiF;;IAEjF,6EAA6E;;IAE7E,uGAAuG;;IAEvG,kFAAkF;;IAElF,qEAAqE;;IAErE;;;;OAIG;;IAEH;;;;OAIG;;IAEH;;;;;OAKG;;IAEH,8EAA8E;;IAE9E;;;;OAIG;;CAEK,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,SAAS,CAAC;AACnD,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,aAAa,CAAC,CAAC;AAE/D,MAAM,WAAW,uBAAuB;IACtC,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,8DAA8D;IAC9D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;GASG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;gBAEX,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,uBAAuB;IAQpF,wDAAwD;IACxD,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,GAAG,IAAI,gBAAgB;CAIxE;AAqBD,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACvB,OAAO,CAAC,CAAC,CAAC,CAQZ"}

package/dist/lib/errors.js

@@ -39,6 +39,33 @@ export const ErrorCode = {
     STATE_INVALID: 'STATE_INVALID',
     /** Driver-level / transport-level failure surfaced to the caller. */
     DRIVER_ERROR: 'DRIVER_ERROR',
+    /**
+     * The resolved chromedriver doesn't match the Electron app before a session is
+     * created — wrong bundled-Chromium major or wrong CPU arch. `detail.kind`
+     * distinguishes `'chromium-major'` from `'arch'`.
+     */
+    ELECTRON_DRIVER_MISMATCH: 'ELECTRON_DRIVER_MISMATCH',
+    /**
+     * The Electron app process exited during session creation ("Chrome instance
+     * exited"). `detail`/`hint` carry the diagnosed likely cause (macOS
+     * signing/Gatekeeper, Linux sandbox) plus the chromedriver output tail.
+     */
+    ELECTRON_LAUNCH_FAILED: 'ELECTRON_LAUNCH_FAILED',
+    /**
+     * `browser.electron.executeMain(...)` couldn't reach the app's main process —
+     * main-process access wasn't enabled (`electron: { mainProcess: true }`), the
+     * session isn't an Electron one, or the Node inspector is unavailable (e.g. the
+     * `EnableNodeCliInspectArguments` fuse is disabled). `hint` names the fix.
+     */
+    ELECTRON_MAIN_UNAVAILABLE: 'ELECTRON_MAIN_UNAVAILABLE',
+    /** The `executeMain(...)` callback threw inside the Electron main process. */
+    ELECTRON_MAIN_THREW: 'ELECTRON_MAIN_THREW',
+    /**
+     * `browser.electron.triggerDeeplink(url)` could not open the custom-protocol URL —
+     * an invalid/`http(s)`/`file` URL (use {@link INVALID_ARGUMENT}'s sibling check),
+     * an unsupported platform, or the OS `open`/`gio`/`rundll32` launcher failed.
+     */
+    ELECTRON_DEEPLINK_FAILED: 'ELECTRON_DEEPLINK_FAILED',
 };
 /**
  * Base class for every error thrown from the public API.