@amalgm/browser 0.1.0

package/dist/src/drivers/electron/native/shell/sites.js

@@ -0,0 +1,119 @@
+import { shell } from 'electron';
+import { BROWSER_IPC } from '../contracts.js';
+import { isAllowedExternalUrl, isAllowedWebUrl, shouldOpenAsTab } from '../policy.js';
+import { popupWindowOptions, send, shortcutForInput } from './helpers.js';
+export class BrowserSiteManager {
+    options;
+    sites = new Map();
+    automationEmbedders = new Map();
+    constructor(options) {
+        this.options = options;
+    }
+    get(webContentsId) { return this.sites.get(webContentsId); }
+    values() { return this.sites.values(); }
+    forRootGuest(guestId) {
+        return this.sites.get(guestId)
+            ?? [...this.sites.values()].find((site) => site.rootGuestId === guestId)
+            ?? null;
+    }
+    configure(site) {
+        this.sites.set(site.contents.id, site);
+        try {
+            site.contents.setBackgroundThrottling(!site.isAutomation);
+        }
+        catch { }
+        if (site.isAutomation) {
+            site.isAutomation = false;
+            this.updateAutomation(site, true);
+        }
+        this.configurePopups(site);
+        site.contents.on('will-navigate', (event, url) => {
+            if (isAllowedWebUrl(url))
+                return;
+            event.preventDefault();
+            if (isAllowedExternalUrl(url))
+                void shell.openExternal(url);
+        });
+        site.contents.on('did-navigate', () => {
+            if (site.contents.id === site.rootGuestId) {
+                this.options.adBlocker.publish(site.contents.id, site.rootGuestId);
+            }
+        });
+        site.contents.on('did-start-navigation', (_event, _url, sameDocument, mainFrame) => {
+            if (!sameDocument && mainFrame && site.contents.id === site.rootGuestId) {
+                this.options.adBlocker.resetGuest(site.rootGuestId);
+                this.options.adBlocker.publish(site.contents.id, site.rootGuestId);
+            }
+        });
+        site.contents.on('context-menu', (_event, params) => this.options.contextMenus.show(site, params));
+        site.contents.on('before-input-event', (event, input) => {
+            const command = shortcutForInput(input);
+            if (!command)
+                return;
+            event.preventDefault();
+            send(site.embedder, BROWSER_IPC.shortcut, { guestId: site.rootGuestId, command });
+        });
+        site.contents.once('destroyed', () => this.remove(site));
+    }
+    updateAutomation(site, isAutomation) {
+        if (site.isAutomation === isAutomation)
+            return;
+        site.isAutomation = isAutomation;
+        try {
+            site.contents.setBackgroundThrottling(!isAutomation);
+        }
+        catch { }
+        const current = this.automationEmbedders.get(site.embedder.id) ?? 0;
+        const next = Math.max(0, current + (isAutomation ? 1 : -1));
+        if (next > 0)
+            this.automationEmbedders.set(site.embedder.id, next);
+        else
+            this.automationEmbedders.delete(site.embedder.id);
+        try {
+            site.embedder.setBackgroundThrottling(next === 0);
+        }
+        catch { }
+    }
+    dispose() {
+        this.sites.clear();
+        this.automationEmbedders.clear();
+    }
+    configurePopups(site) {
+        site.contents.setWindowOpenHandler((details) => {
+            const url = details.url || 'about:blank';
+            if (shouldOpenAsTab(details.disposition) && isAllowedWebUrl(url)) {
+                send(site.embedder, 'new-browser-tab', url);
+                return { action: 'deny' };
+            }
+            if (isAllowedExternalUrl(url)) {
+                void shell.openExternal(url);
+                return { action: 'deny' };
+            }
+            if (!isAllowedWebUrl(url))
+                return { action: 'deny' };
+            return {
+                action: 'allow',
+                outlivesOpener: false,
+                overrideBrowserWindowOptions: popupWindowOptions(this.options.adBlocker.cosmeticPreloadPath(), this.options.browserSession),
+            };
+        });
+        site.contents.on('did-create-window', (window) => this.configure({
+            contents: window.webContents,
+            embedder: site.embedder,
+            rootGuestId: site.rootGuestId,
+            tabId: site.tabId,
+            isAutomation: false,
+        }));
+    }
+    remove(site) {
+        this.sites.delete(site.contents.id);
+        if (site.isAutomation)
+            this.updateAutomation(site, false);
+        if (site.contents.id === site.rootGuestId)
+            this.options.adBlocker.forgetGuest(site.rootGuestId);
+    }
+}
+export function shellSite(contents, embedder, tabId, isAutomation) {
+    return { contents, embedder, rootGuestId: contents.id, tabId, isAutomation };
+}
+//# sourceMappingURL=sites.js.map

package/dist/src/drivers/electron/native/shell/sites.js.map

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

package/dist/src/drivers/electron/native/shell/types.d.ts

@@ -0,0 +1,13 @@
+import type { WebContents } from 'electron';
+export type ShellSite = {
+    contents: WebContents;
+    embedder: WebContents;
+    rootGuestId: number;
+    tabId: string | null;
+    isAutomation: boolean;
+};
+export interface ShellSites {
+    get(webContentsId: number): ShellSite | undefined;
+    forRootGuest(guestId: number): ShellSite | null;
+    values(): IterableIterator<ShellSite>;
+}

package/dist/src/drivers/electron/native/shell/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/drivers/electron/native/shell/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../src/drivers/electron/native/shell/types.ts"],"names":[],"mappings":""}

package/dist/src/drivers/electron/native/shell.d.ts

@@ -0,0 +1,14 @@
+import { type WebContents, type WebPreferences } from 'electron';
+import { type BrowserShortcut } from './contracts.js';
+export type BrowserShell = {
+    hardenWebview(webPreferences: WebPreferences, params: Record<string, string>): boolean;
+    attachGuest(embedder: WebContents, guest: WebContents): void;
+    sendShortcut(target: WebContents | null, command: BrowserShortcut): void;
+    dispose(): void;
+};
+export type BrowserShellOptions = {
+    isTrustedAppUrl(url: string): boolean;
+    isDev: boolean;
+    adBlockFetch?: typeof globalThis.fetch;
+};
+export declare function createBrowserShell(options: BrowserShellOptions): BrowserShell;

package/dist/src/drivers/electron/native/shell.js

@@ -0,0 +1,115 @@
+import path from 'node:path';
+import { app, ipcMain } from 'electron';
+import { BROWSER_IPC } from './contracts.js';
+import { NativeAdBlocker, adBlockHostname } from './adblock/index.js';
+import { nativeBrowserSurfacesEnabled } from './config.js';
+import { isAllowedWebUrl } from './policy.js';
+import { BROWSER_SESSION_PARTITION, getBrowserSession } from './session.js';
+import { createBrowserSurfaceController } from './surface-controller.js';
+import { BrowserAdBlockIpc } from './shell/adblock-ipc.js';
+import { BrowserContextMenuController } from './shell/context-menu.js';
+import { BrowserDownloadController } from './shell/downloads.js';
+import { send } from './shell/helpers.js';
+import { BrowserPermissionController } from './shell/permissions.js';
+import { BrowserSiteManager, shellSite } from './shell/sites.js';
+const AUTOMATION_MARKER = 'amalgm-bsid-';
+export function createBrowserShell(options) {
+    let sites;
+    const adBlockDirectory = path.join(app.getPath('userData'), 'browser', 'adblock');
+    const adBlocker = new NativeAdBlocker({
+        cachePath: path.join(adBlockDirectory, 'engine.bin'),
+        settingsPath: path.join(adBlockDirectory, 'settings.json'),
+        resolvePage(webContentsId) {
+            const site = sites?.get(webContentsId);
+            if (!site || site.contents.isDestroyed())
+                return null;
+            const url = site.contents.getURL();
+            const hostname = adBlockHostname(url);
+            return hostname ? { guestId: site.rootGuestId, webContentsId, hostname, url } : null;
+        },
+        onStatus(status) {
+            const site = sites?.forRootGuest(status.guestId);
+            if (site)
+                send(site.embedder, BROWSER_IPC.adBlockStatus, status);
+        },
+        onReady() {
+            for (const site of sites?.values() ?? []) {
+                if (site.contents.id === site.rootGuestId)
+                    adBlocker.publish(site.contents.id, site.rootGuestId);
+            }
+        },
+        ...(options.adBlockFetch ? { fetch: options.adBlockFetch } : {}),
+    });
+    const browserSession = getBrowserSession();
+    const contextMenus = new BrowserContextMenuController(options.isDev);
+    sites = new BrowserSiteManager({ browserSession, adBlocker, contextMenus });
+    const permissions = new BrowserPermissionController(browserSession, sites, options.isTrustedAppUrl);
+    const downloads = new BrowserDownloadController(browserSession, sites);
+    const adBlockIpc = new BrowserAdBlockIpc(adBlocker, sites);
+    adBlocker.install(browserSession);
+    const surfaceController = nativeBrowserSurfacesEnabled()
+        ? createBrowserSurfaceController({
+            browserSession,
+            cosmeticPreloadPath: () => adBlocker.cosmeticPreloadPath(),
+            isAllowedUrl: isAllowedWebUrl,
+            onSurfaceCreated(surface) {
+                sites?.configure(shellSite(surface.contents, surface.embedder, surface.tabId, surface.isAutomation));
+                adBlocker.publish(surface.contents.id, surface.contents.id);
+            },
+            onAutomationChanged(contents, isAutomation) {
+                const site = sites?.get(contents.id);
+                if (site)
+                    sites?.updateAutomation(site, isAutomation);
+            },
+        })
+        : null;
+    const registerGuest = (event, registration) => {
+        if (!registration || !Number.isInteger(registration.guestId))
+            return;
+        const site = sites?.get(registration.guestId);
+        if (!site || site.embedder.id !== event.sender.id)
+            return;
+        site.tabId = String(registration.tabId || '');
+        sites?.updateAutomation(site, registration.isAutomation === true);
+        adBlocker.publish(site.contents.id, site.rootGuestId);
+    };
+    ipcMain.on(BROWSER_IPC.registerGuest, registerGuest);
+    return {
+        hardenWebview(webPreferences, params) {
+            if (!isAllowedWebUrl(params.src || 'about:blank'))
+                return false;
+            const preload = adBlocker.cosmeticPreloadPath();
+            if (preload)
+                webPreferences.preload = preload;
+            else
+                delete webPreferences.preload;
+            webPreferences.partition = BROWSER_SESSION_PARTITION;
+            webPreferences.nodeIntegration = false;
+            webPreferences.nodeIntegrationInSubFrames = false;
+            webPreferences.contextIsolation = true;
+            webPreferences.sandbox = true;
+            webPreferences.webSecurity = true;
+            webPreferences.webviewTag = false;
+            webPreferences.allowRunningInsecureContent = false;
+            return true;
+        },
+        attachGuest(embedder, guest) {
+            sites?.configure(shellSite(guest, embedder, null, guest.getURL().includes(AUTOMATION_MARKER)));
+        },
+        sendShortcut(target, command) {
+            if (target && !target.isDestroyed())
+                send(target, BROWSER_IPC.shortcut, { guestId: null, command });
+        },
+        dispose() {
+            surfaceController?.dispose();
+            ipcMain.off(BROWSER_IPC.registerGuest, registerGuest);
+            permissions.dispose();
+            downloads.dispose();
+            adBlockIpc.dispose();
+            contextMenus.dispose();
+            sites?.dispose();
+            adBlocker.dispose();
+        },
+    };
+}
+//# sourceMappingURL=shell.js.map

package/dist/src/drivers/electron/native/shell.js.map

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

package/dist/src/drivers/electron/native/surface/commands.d.ts

@@ -0,0 +1,4 @@
+import type { BrowserSurfaceCommandRequest, BrowserSurfaceState } from '../contracts.js';
+import type { SurfacePresentation } from './presentation.js';
+import type { SurfaceRecord } from './types.js';
+export declare function executeSurfaceCommand(record: SurfaceRecord, request: BrowserSurfaceCommandRequest, presentation: SurfacePresentation, isAllowedUrl: (url: string) => boolean): BrowserSurfaceState;

package/dist/src/drivers/electron/native/surface/commands.js

@@ -0,0 +1,49 @@
+import { stateFor } from './state.js';
+const MIN_ZOOM = 0.5;
+const MAX_ZOOM = 3;
+export function executeSurfaceCommand(record, request, presentation, isAllowedUrl) {
+    const contents = record.view.webContents;
+    switch (request.command) {
+        case 'navigate':
+            if (!isAllowedUrl(request.url))
+                return stateFor(record);
+            record.loadError = null;
+            if (contents.getURL() !== request.url)
+                void contents.loadURL(request.url).catch(() => { });
+            break;
+        case 'back':
+            if (contents.navigationHistory.canGoBack())
+                contents.navigationHistory.goBack();
+            break;
+        case 'forward':
+            if (contents.navigationHistory.canGoForward())
+                contents.navigationHistory.goForward();
+            break;
+        case 'reload':
+            contents.reload();
+            break;
+        case 'focus':
+            contents.focus();
+            break;
+        case 'find':
+            if (!request.query) {
+                contents.stopFindInPage('clearSelection');
+                record.findResult = { activeMatch: 0, matches: 0 };
+            }
+            else {
+                contents.findInPage(request.query, { forward: request.forward, findNext: request.findNext });
+            }
+            break;
+        case 'stop-find':
+            contents.stopFindInPage(request.action);
+            break;
+        case 'set-zoom':
+            if (Number.isFinite(request.factor)) {
+                record.zoomFactor = Math.max(MIN_ZOOM, Math.min(MAX_ZOOM, request.factor));
+                presentation.applyZoom(record);
+            }
+            break;
+    }
+    return stateFor(record);
+}
+//# sourceMappingURL=commands.js.map

package/dist/src/drivers/electron/native/surface/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../../../../../src/drivers/electron/native/surface/commands.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,MAAM,QAAQ,GAAG,GAAG,CAAC;AACrB,MAAM,QAAQ,GAAG,CAAC,CAAC;AAEnB,MAAM,UAAU,qBAAqB,CACnC,MAAqB,EACrB,OAAqC,EACrC,YAAiC,EACjC,YAAsC;IAEtC,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC;IACzC,QAAQ,OAAO,CAAC,OAAO,EAAE,CAAC;QACxB,KAAK,UAAU;YACb,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC;gBAAE,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC;YACxD,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC;YACxB,IAAI,QAAQ,CAAC,MAAM,EAAE,KAAK,OAAO,CAAC,GAAG;gBAAE,KAAK,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAC1F,MAAM;QACR,KAAK,MAAM;YACT,IAAI,QAAQ,CAAC,iBAAiB,CAAC,SAAS,EAAE;gBAAE,QAAQ,CAAC,iBAAiB,CAAC,MAAM,EAAE,CAAC;YAChF,MAAM;QACR,KAAK,SAAS;YACZ,IAAI,QAAQ,CAAC,iBAAiB,CAAC,YAAY,EAAE;gBAAE,QAAQ,CAAC,iBAAiB,CAAC,SAAS,EAAE,CAAC;YACtF,MAAM;QACR,KAAK,QAAQ;YAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;YAAC,MAAM;QACxC,KAAK,OAAO;YAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;YAAC,MAAM;QACtC,KAAK,MAAM;YACT,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;gBACnB,QAAQ,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC;gBAC1C,MAAM,CAAC,UAAU,GAAG,EAAE,WAAW,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;YACrD,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC/F,CAAC;YACD,MAAM;QACR,KAAK,WAAW;YAAE,QAAQ,CAAC,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAAC,MAAM;QACjE,KAAK,UAAU;YACb,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBACpC,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;gBAC3E,YAAY,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACjC,CAAC;YACD,MAAM;IACV,CAAC;IACD,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC1B,CAAC"}

package/dist/src/drivers/electron/native/surface/create.d.ts

@@ -0,0 +1,4 @@
+import { type WebContents } from 'electron';
+import type { BrowserSurfaceCreateRequest } from '../contracts.js';
+import type { BrowserSurfaceControllerOptions, SurfaceRecord } from './types.js';
+export declare function createSurfaceRecord(sender: WebContents, request: BrowserSurfaceCreateRequest, options: BrowserSurfaceControllerOptions): SurfaceRecord | null;

package/dist/src/drivers/electron/native/surface/create.js

@@ -0,0 +1,46 @@
+import { BrowserWindow, WebContentsView } from 'electron';
+import { validSurfaceId } from './state.js';
+export function createSurfaceRecord(sender, request, options) {
+    const owner = BrowserWindow.fromWebContents(sender);
+    if (!owner || owner.isDestroyed())
+        return null;
+    const preload = options.cosmeticPreloadPath();
+    const view = new WebContentsView({
+        webPreferences: {
+            session: options.browserSession,
+            nodeIntegration: false,
+            nodeIntegrationInSubFrames: false,
+            contextIsolation: true,
+            sandbox: true,
+            webSecurity: true,
+            webviewTag: false,
+            allowRunningInsecureContent: false,
+            ...(preload ? { preload } : {}),
+        },
+    });
+    view.setBackgroundColor('#ffffff');
+    view.setVisible(false);
+    owner.contentView.addChildView(view);
+    return {
+        surfaceId: request.surfaceId,
+        tabId: String(request.tabId || ''),
+        view,
+        owner,
+        embedder: sender,
+        isAutomation: request.isAutomation === true,
+        automationSessionId: validSurfaceId(request.automationSessionId) ? request.automationSessionId : null,
+        parkingWindow: null,
+        parent: 'owner',
+        bounds: { x: 0, y: 0, width: 0, height: 0 },
+        requestedVisible: false,
+        displayScale: 1,
+        zoomFactor: 1,
+        ready: false,
+        title: '',
+        favicons: [],
+        findResult: { activeMatch: 0, matches: 0 },
+        loadError: null,
+        disposed: false,
+    };
+}
+//# sourceMappingURL=create.js.map

package/dist/src/drivers/electron/native/surface/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../../../../src/drivers/electron/native/surface/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAoB,MAAM,UAAU,CAAC;AAE5E,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C,MAAM,UAAU,mBAAmB,CACjC,MAAmB,EACnB,OAAoC,EACpC,OAAwC;IAExC,MAAM,KAAK,GAAG,aAAa,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IACpD,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,WAAW,EAAE;QAAE,OAAO,IAAI,CAAC;IAC/C,MAAM,OAAO,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAC9C,MAAM,IAAI,GAAG,IAAI,eAAe,CAAC;QAC/B,cAAc,EAAE;YACd,OAAO,EAAE,OAAO,CAAC,cAAc;YAC/B,eAAe,EAAE,KAAK;YACtB,0BAA0B,EAAE,KAAK;YACjC,gBAAgB,EAAE,IAAI;YACtB,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,IAAI;YACjB,UAAU,EAAE,KAAK;YACjB,2BAA2B,EAAE,KAAK;YAClC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChC;KACF,CAAC,CAAC;IACH,IAAI,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACnC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACvB,KAAK,CAAC,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACrC,OAAO;QACL,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;QAClC,IAAI;QACJ,KAAK;QACL,QAAQ,EAAE,MAAM;QAChB,YAAY,EAAE,OAAO,CAAC,YAAY,KAAK,IAAI;QAC3C,mBAAmB,EAAE,cAAc,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,IAAI;QACrG,aAAa,EAAE,IAAI;QACnB,MAAM,EAAE,OAAO;QACf,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;QAC3C,gBAAgB,EAAE,KAAK;QACvB,YAAY,EAAE,CAAC;QACf,UAAU,EAAE,CAAC;QACb,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE;QAC1C,SAAS,EAAE,IAAI;QACf,QAAQ,EAAE,KAAK;KAChB,CAAC;AACJ,CAAC"}

package/dist/src/drivers/electron/native/surface/events.d.ts

@@ -0,0 +1,3 @@
+import type { SurfacePresentation } from './presentation.js';
+import type { SurfaceRecord } from './types.js';
+export declare function configureSurfaceEvents(record: SurfaceRecord, presentation: SurfacePresentation, sendState: () => void, destroyed: () => void): void;

package/dist/src/drivers/electron/native/surface/events.js

@@ -0,0 +1,55 @@
+export function configureSurfaceEvents(record, presentation, sendState, destroyed) {
+    const contents = record.view.webContents;
+    contents.on('did-start-loading', () => {
+        record.ready = false;
+        record.loadError = null;
+        sendState();
+    });
+    contents.on('did-stop-loading', () => {
+        record.ready = true;
+        presentation.apply(record);
+        sendState();
+    });
+    contents.on('dom-ready', () => {
+        record.ready = true;
+        presentation.applyZoom(record);
+        stampAutomationIdentity(record);
+        presentation.apply(record);
+        sendState();
+    });
+    contents.on('page-title-updated', (_event, title) => { record.title = title; sendState(); });
+    contents.on('page-favicon-updated', (_event, favicons) => { record.favicons = [...favicons]; sendState(); });
+    contents.on('did-navigate', () => {
+        record.loadError = null;
+        stampAutomationIdentity(record);
+        sendState();
+    });
+    contents.on('did-navigate-in-page', (_event, _url, mainFrame) => {
+        if (!mainFrame)
+            return;
+        record.loadError = null;
+        stampAutomationIdentity(record);
+        sendState();
+    });
+    contents.on('did-fail-load', (_event, code, description, url, mainFrame) => {
+        if (!mainFrame || code === -3)
+            return;
+        record.loadError = { code, description, url };
+        sendState();
+    });
+    contents.on('found-in-page', (_event, result) => {
+        record.findResult = {
+            activeMatch: Number(result.activeMatchOrdinal) || 0,
+            matches: Number(result.matches) || 0,
+        };
+        sendState();
+    });
+    contents.once('destroyed', destroyed);
+}
+function stampAutomationIdentity(record) {
+    const contents = record.view.webContents;
+    if (!record.automationSessionId || contents.isDestroyed())
+        return;
+    void contents.executeJavaScript(`window.__amalgmBsid = ${JSON.stringify(record.automationSessionId)};`).catch(() => { });
+}
+//# sourceMappingURL=events.js.map

package/dist/src/drivers/electron/native/surface/events.js.map

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

package/dist/src/drivers/electron/native/surface/presentation.d.ts

@@ -0,0 +1,15 @@
+import type { SurfaceRecord } from './types.js';
+export declare const PARKED_VIEWPORT: {
+    width: number;
+    height: number;
+};
+export declare class SurfacePresentation {
+    detach(record: SurfaceRecord): void;
+    applyZoom(record: SurfaceRecord): void;
+    apply(record: SurfaceRecord): void;
+    destroyParking(record: SurfaceRecord): void;
+    private show;
+    private hide;
+    private park;
+    private parkingWindow;
+}

package/dist/src/drivers/electron/native/surface/presentation.js

@@ -0,0 +1,87 @@
+import { BaseWindow } from 'electron';
+export const PARKED_VIEWPORT = { width: 1440, height: 900 };
+const PARKING_ORIGIN = -10_000;
+const MAX_ZOOM = 3;
+export class SurfacePresentation {
+    detach(record) {
+        if (record.parent === 'owner' && !record.owner.isDestroyed()) {
+            record.owner.contentView.removeChildView(record.view);
+        }
+        if (record.parent === 'parking' && record.parkingWindow && !record.parkingWindow.isDestroyed()) {
+            record.parkingWindow.contentView.removeChildView(record.view);
+        }
+        record.parent = null;
+    }
+    applyZoom(record) {
+        const contents = record.view.webContents;
+        if (contents.isDestroyed())
+            return;
+        const scale = record.parent === 'parking' ? 1 : record.displayScale;
+        const factor = Math.max(0.1, Math.min(MAX_ZOOM, record.zoomFactor * scale));
+        if (Math.abs(contents.getZoomFactor() - factor) >= 0.001)
+            contents.setZoomFactor(factor);
+    }
+    apply(record) {
+        const hasArea = record.bounds.width > 0 && record.bounds.height > 0;
+        if (record.requestedVisible && hasArea)
+            this.show(record);
+        else
+            this.hide(record);
+    }
+    destroyParking(record) {
+        if (record.parkingWindow && !record.parkingWindow.isDestroyed())
+            record.parkingWindow.destroy();
+        record.parkingWindow = null;
+    }
+    show(record) {
+        if (record.parent !== 'owner') {
+            this.detach(record);
+            record.owner.contentView.addChildView(record.view);
+            record.parent = 'owner';
+            record.parkingWindow?.hide();
+        }
+        else {
+            record.owner.contentView.addChildView(record.view);
+        }
+        record.view.setBounds(record.bounds);
+        record.view.setVisible(true);
+        this.applyZoom(record);
+    }
+    hide(record) {
+        if (record.isAutomation) {
+            this.park(record);
+            return;
+        }
+        if (record.parent !== 'owner') {
+            this.detach(record);
+            record.owner.contentView.addChildView(record.view);
+            record.parent = 'owner';
+        }
+        record.view.setVisible(false);
+    }
+    park(record) {
+        const parkingWindow = this.parkingWindow(record);
+        if (record.parent !== 'parking') {
+            this.detach(record);
+            parkingWindow.contentView.addChildView(record.view);
+            record.parent = 'parking';
+        }
+        record.view.setBounds({ x: 0, y: 0, ...PARKED_VIEWPORT });
+        record.view.setVisible(true);
+        this.applyZoom(record);
+        parkingWindow.showInactive();
+    }
+    parkingWindow(record) {
+        if (record.parkingWindow && !record.parkingWindow.isDestroyed())
+            return record.parkingWindow;
+        record.parkingWindow = new BaseWindow({
+            show: false, x: PARKING_ORIGIN, y: PARKING_ORIGIN, ...PARKED_VIEWPORT,
+            focusable: true, skipTaskbar: true, hiddenInMissionControl: true,
+            frame: false, hasShadow: false, closable: false, minimizable: false,
+            maximizable: false, movable: false, resizable: false, fullscreenable: false,
+            roundedCorners: false, backgroundColor: '#ffffff',
+        });
+        return record.parkingWindow;
+    }
+}
+//# sourceMappingURL=presentation.js.map

package/dist/src/drivers/electron/native/surface/presentation.js.map

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

package/dist/src/drivers/electron/native/surface/state.d.ts

@@ -0,0 +1,7 @@
+import type { BrowserWindow } from 'electron';
+import type { BrowserSurfaceBounds, BrowserSurfaceState } from '../contracts.js';
+import type { SurfaceRecord } from './types.js';
+export declare function validSurfaceId(value: unknown): value is string;
+export declare function normalizeBounds(bounds: BrowserSurfaceBounds, owner: BrowserWindow): BrowserSurfaceBounds | null;
+export declare function stateFor(record: SurfaceRecord): BrowserSurfaceState;
+export declare function withDeadline<T>(promise: Promise<T>, timeoutMs: number): Promise<T>;