@amalgm/browser 0.1.0

package/dist/src/drivers/electron/native/adblock/index.js

@@ -0,0 +1,153 @@
+import { Request } from '@ghostery/adblocker';
+import path from 'node:path';
+import { loadAdBlockEngine } from './cache.js';
+import { installCosmeticHandlers } from './cosmetics.js';
+import { AdBlockAllowlist } from './settings.js';
+import { isNativeAdBlockDisabled } from './policy.js';
+export { isAdBlockCacheFresh } from './cache.js';
+export { adBlockHostname, isNativeAdBlockDisabled } from './policy.js';
+export class NativeAdBlocker {
+    options;
+    engine = null;
+    loading;
+    installed;
+    readyPromise = Promise.resolve();
+    removeCosmetics;
+    counts = new Map();
+    timers = new Map();
+    allowlist;
+    disabled;
+    constructor(options) {
+        this.options = options;
+        this.disabled = options.disabled ?? isNativeAdBlockDisabled();
+        this.loading = !this.disabled;
+        this.allowlist = new AdBlockAllowlist(options.settingsPath);
+    }
+    cosmeticPreloadPath() {
+        return this.disabled ? null : this.options.preloadPath || path.join(import.meta.dirname, 'preload.js');
+    }
+    install(session) {
+        if (this.installed === session)
+            return;
+        this.installed = session;
+        if (this.disabled) {
+            this.options.onReady();
+            return;
+        }
+        this.readyPromise = this.initialize();
+        this.removeCosmetics = installCosmeticHandlers({
+            engine: () => this.engine,
+            ready: () => this.readyPromise,
+            resolvePage: this.options.resolvePage,
+            allowlist: this.allowlist,
+        });
+        session.webRequest.onBeforeRequest({ urls: ['http://*/*', 'https://*/*'] }, (details, callback) => {
+            const page = details.webContentsId ? this.options.resolvePage(details.webContentsId) : null;
+            if (!page || !this.engine || !this.allowlist.enabled(page.hostname) || details.resourceType === 'mainFrame') {
+                callback({});
+                return;
+            }
+            const request = Request.fromRawDetails({
+                requestId: String(details.id), tabId: page.webContentsId, url: details.url,
+                sourceUrl: details.referrer || page.url, type: details.resourceType, _originalRequestDetails: details,
+            });
+            if (this.engine.config.guessRequestTypeFromUrl && request.type === 'other')
+                request.guessTypeOfRequest();
+            const result = this.engine.match(request);
+            if (result.redirect) {
+                this.blocked(page);
+                callback({ redirectURL: result.redirect.dataUrl });
+                return;
+            }
+            if (result.rewrite?.url) {
+                this.blocked(page);
+                callback({ redirectURL: result.rewrite.url });
+                return;
+            }
+            if (result.match) {
+                this.blocked(page);
+                callback({ cancel: true });
+                return;
+            }
+            callback({});
+        });
+        session.webRequest.onHeadersReceived({ urls: ['http://*/*', 'https://*/*'] }, (details, callback) => {
+            const page = details.webContentsId ? this.options.resolvePage(details.webContentsId) : null;
+            if (!page || !this.engine || !this.allowlist.enabled(page.hostname)
+                || !['mainFrame', 'subFrame'].includes(details.resourceType)) {
+                callback({});
+                return;
+            }
+            const request = Request.fromRawDetails({
+                requestId: String(details.id), tabId: page.webContentsId, url: details.url,
+                sourceUrl: details.referrer || page.url, type: details.resourceType, _originalRequestDetails: details,
+            });
+            const directive = this.engine.getCSPDirectives(request);
+            if (!directive) {
+                callback({});
+                return;
+            }
+            const headers = { ...(details.responseHeaders || {}) };
+            const policies = [directive];
+            for (const [name, values] of Object.entries(headers)) {
+                if (name.toLowerCase() !== 'content-security-policy')
+                    continue;
+                policies.push(...values);
+                delete headers[name];
+            }
+            headers['content-security-policy'] = [policies.join(';')];
+            callback({ responseHeaders: headers });
+        });
+    }
+    status(webContentsId, guestId) {
+        const page = this.options.resolvePage(webContentsId);
+        const hostname = page?.hostname || '';
+        return {
+            guestId,
+            available: !this.disabled && this.engine !== null,
+            loading: this.loading,
+            enabled: !this.disabled && this.allowlist.enabled(hostname),
+            hostname,
+            blockedCount: this.counts.get(guestId) || 0,
+        };
+    }
+    setHostEnabled(hostname, enabled) { this.allowlist.setEnabled(hostname, enabled); }
+    publish(webContentsId, guestId) { this.options.onStatus(this.status(webContentsId, guestId)); }
+    resetGuest(guestId) { this.counts.set(guestId, 0); this.clearTimer(guestId); }
+    forgetGuest(guestId) { this.resetGuest(guestId); this.counts.delete(guestId); }
+    dispose() {
+        this.installed?.webRequest.onBeforeRequest(null);
+        this.installed?.webRequest.onHeadersReceived(null);
+        this.installed = undefined;
+        this.engine = null;
+        this.removeCosmetics?.();
+        for (const timer of this.timers.values())
+            clearTimeout(timer);
+        this.timers.clear();
+    }
+    async initialize() {
+        try {
+            this.engine = await loadAdBlockEngine(this.options.cachePath, this.options.fetch);
+        }
+        finally {
+            this.loading = false;
+            this.options.onReady();
+        }
+    }
+    blocked(page) {
+        this.counts.set(page.guestId, (this.counts.get(page.guestId) || 0) + 1);
+        if (this.timers.has(page.guestId))
+            return;
+        this.timers.set(page.guestId, setTimeout(() => {
+            this.timers.delete(page.guestId);
+            this.options.onStatus(this.status(page.webContentsId, page.guestId));
+        }, 250));
+    }
+    clearTimer(guestId) {
+        const timer = this.timers.get(guestId);
+        if (timer)
+            clearTimeout(timer);
+        this.timers.delete(guestId);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/src/drivers/electron/native/adblock/index.js.map

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

package/dist/src/drivers/electron/native/adblock/policy.d.ts

@@ -0,0 +1,2 @@
+export declare function adBlockHostname(value: string): string;
+export declare function isNativeAdBlockDisabled(value?: string | undefined): boolean;

package/dist/src/drivers/electron/native/adblock/policy.js

@@ -0,0 +1,12 @@
+export function adBlockHostname(value) {
+    try {
+        return new URL(value).hostname.toLowerCase();
+    }
+    catch {
+        return '';
+    }
+}
+export function isNativeAdBlockDisabled(value = process.env.AMALGM_BROWSER_ADBLOCK) {
+    return /^(0|false|no|off)$/i.test(String(value || '').trim());
+}
+//# sourceMappingURL=policy.js.map

package/dist/src/drivers/electron/native/adblock/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../../../../../src/drivers/electron/native/adblock/policy.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,IAAI,CAAC;QAAC,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IAAC,CAAC;IACrD,MAAM,CAAC;QAAC,OAAO,EAAE,CAAC;IAAC,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB;IAChF,OAAO,qBAAqB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AAChE,CAAC"}

package/dist/src/drivers/electron/native/adblock/preload.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/drivers/electron/native/adblock/preload.js

@@ -0,0 +1,131 @@
+import { ipcRenderer } from 'electron';
+const COSMETIC_INJECTION_CHANNEL = '@ghostery/adblocker/inject-cosmetic-filters';
+const MUTATION_OBSERVER_CHANNEL = '@ghostery/adblocker/is-mutation-observer-enabled';
+const IGNORED_TAGS = new Set(['br', 'head', 'link', 'meta', 'script', 'style', 's']);
+const MUTATION_DEBOUNCE_MS = 25;
+const MUTATION_MAX_WAIT_MS = 1_000;
+const MUTATION_ELEMENT_LIMIT = 512;
+// Sandboxed preloads can only require a small Electron-provided module set, so
+// this monitor intentionally stays self-contained instead of importing a DOM
+// helper from node_modules.
+if (window === window.top && !window.location.href.startsWith('devtools://')) {
+    const knownClasses = new Set();
+    const knownHrefs = new Set();
+    const knownIds = new Set();
+    const pendingElements = new Set();
+    let observer = null;
+    let debounceTimer = null;
+    let maxWaitTimer = null;
+    const inject = (features) => {
+        void ipcRenderer
+            .invoke(COSMETIC_INJECTION_CHANNEL, window.location.href, features)
+            .catch(() => undefined);
+    };
+    const clearTimers = () => {
+        if (debounceTimer)
+            clearTimeout(debounceTimer);
+        if (maxWaitTimer)
+            clearTimeout(maxWaitTimer);
+        debounceTimer = null;
+        maxWaitTimer = null;
+    };
+    const addNewValue = (value, known, additions) => {
+        if (!value || known.has(value))
+            return;
+        known.add(value);
+        additions.push(value);
+    };
+    const collectFeatures = (roots) => {
+        const classes = [];
+        const hrefs = [];
+        const ids = [];
+        const visited = new Set();
+        for (const root of roots) {
+            const elements = [
+                root,
+                ...Array.from(root.querySelectorAll('[id], [class], [href]')),
+            ];
+            for (const element of elements) {
+                if (visited.has(element))
+                    continue;
+                visited.add(element);
+                if (IGNORED_TAGS.has(element.tagName.toLowerCase()))
+                    continue;
+                addNewValue(element.getAttribute('id'), knownIds, ids);
+                addNewValue(element.getAttribute('href'), knownHrefs, hrefs);
+                for (const className of Array.from(element.classList)) {
+                    addNewValue(className, knownClasses, classes);
+                }
+            }
+        }
+        if (classes.length || hrefs.length || ids.length) {
+            inject({ classes, hrefs, ids, lifecycle: 'dom-update' });
+        }
+    };
+    const flushPendingElements = () => {
+        clearTimers();
+        if (!pendingElements.size)
+            return;
+        const elements = [...pendingElements];
+        pendingElements.clear();
+        collectFeatures(elements);
+    };
+    const scheduleFlush = () => {
+        if (!maxWaitTimer) {
+            maxWaitTimer = setTimeout(flushPendingElements, MUTATION_MAX_WAIT_MS);
+        }
+        if (debounceTimer)
+            clearTimeout(debounceTimer);
+        debounceTimer = setTimeout(flushPendingElements, MUTATION_DEBOUNCE_MS);
+    };
+    const queueElement = (node) => {
+        if (node.nodeType === Node.ELEMENT_NODE) {
+            pendingElements.add(node);
+        }
+    };
+    const startMonitoring = () => {
+        if (observer || !document.documentElement)
+            return;
+        observer = new MutationObserver((mutations) => {
+            for (const mutation of mutations) {
+                if (mutation.type === 'attributes') {
+                    queueElement(mutation.target);
+                }
+                else {
+                    mutation.addedNodes.forEach(queueElement);
+                }
+            }
+            if (pendingElements.size > MUTATION_ELEMENT_LIMIT) {
+                flushPendingElements();
+            }
+            else if (pendingElements.size) {
+                scheduleFlush();
+            }
+        });
+        observer.observe(document.documentElement, {
+            attributes: true,
+            attributeFilter: ['class', 'id', 'href'],
+            childList: true,
+            subtree: true,
+        });
+    };
+    inject();
+    window.addEventListener('DOMContentLoaded', () => {
+        if (document.documentElement)
+            collectFeatures([document.documentElement]);
+        void ipcRenderer
+            .invoke(MUTATION_OBSERVER_CHANNEL)
+            .then((enabled) => {
+            if (enabled)
+                startMonitoring();
+        })
+            .catch(() => undefined);
+    }, { once: true, passive: true });
+    window.addEventListener('unload', () => {
+        observer?.disconnect();
+        observer = null;
+        pendingElements.clear();
+        clearTimers();
+    }, { once: true, passive: true });
+}
+//# sourceMappingURL=preload.js.map

package/dist/src/drivers/electron/native/adblock/preload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preload.js","sourceRoot":"","sources":["../../../../../../src/drivers/electron/native/adblock/preload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,MAAM,0BAA0B,GAAG,6CAA6C,CAAC;AACjF,MAAM,yBAAyB,GAAG,kDAAkD,CAAC;AACrF,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;AACrF,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAChC,MAAM,oBAAoB,GAAG,KAAK,CAAC;AACnC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AASnC,+EAA+E;AAC/E,6EAA6E;AAC7E,4BAA4B;AAC5B,IAAI,MAAM,KAAK,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;IAC7E,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IACvC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,MAAM,eAAe,GAAG,IAAI,GAAG,EAAW,CAAC;IAC3C,IAAI,QAAQ,GAA4B,IAAI,CAAC;IAC7C,IAAI,aAAa,GAAyC,IAAI,CAAC;IAC/D,IAAI,YAAY,GAAyC,IAAI,CAAC;IAE9D,MAAM,MAAM,GAAG,CAAC,QAA2B,EAAE,EAAE;QAC7C,KAAK,WAAW;aACb,MAAM,CAAC,0BAA0B,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;aAClE,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC5B,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,GAAG,EAAE;QACvB,IAAI,aAAa;YAAE,YAAY,CAAC,aAAa,CAAC,CAAC;QAC/C,IAAI,YAAY;YAAE,YAAY,CAAC,YAAY,CAAC,CAAC;QAC7C,aAAa,GAAG,IAAI,CAAC;QACrB,YAAY,GAAG,IAAI,CAAC;IACtB,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,CAClB,KAAoB,EACpB,KAAkB,EAClB,SAAmB,EACnB,EAAE;QACF,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO;QACvC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjB,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC,CAAC;IAEF,MAAM,eAAe,GAAG,CAAC,KAAgB,EAAE,EAAE;QAC3C,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAa,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAW,CAAC;QAEnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG;gBACf,IAAI;gBACJ,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAU,uBAAuB,CAAC,CAAC;aACvE,CAAC;YACF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAC/B,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;oBAAE,SAAS;gBACnC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBACrB,IAAI,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;oBAAE,SAAS;gBAE9D,WAAW,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;gBACvD,WAAW,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;gBAC7D,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;oBACtD,WAAW,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;gBAChD,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YACjD,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,oBAAoB,GAAG,GAAG,EAAE;QAChC,WAAW,EAAE,CAAC;QACd,IAAI,CAAC,eAAe,CAAC,IAAI;YAAE,OAAO;QAClC,MAAM,QAAQ,GAAG,CAAC,GAAG,eAAe,CAAC,CAAC;QACtC,eAAe,CAAC,KAAK,EAAE,CAAC;QACxB,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,GAAG,EAAE;QACzB,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,YAAY,GAAG,UAAU,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,CAAC;QACxE,CAAC;QACD,IAAI,aAAa;YAAE,YAAY,CAAC,aAAa,CAAC,CAAC;QAC/C,aAAa,GAAG,UAAU,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,CAAC;IACzE,CAAC,CAAC;IAEF,MAAM,YAAY,GAAG,CAAC,IAAU,EAAE,EAAE;QAClC,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC;YACxC,eAAe,CAAC,GAAG,CAAC,IAAe,CAAC,CAAC;QACvC,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,eAAe,GAAG,GAAG,EAAE;QAC3B,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,eAAe;YAAE,OAAO;QAClD,QAAQ,GAAG,IAAI,gBAAgB,CAAC,CAAC,SAAS,EAAE,EAAE;YAC5C,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;gBACjC,IAAI,QAAQ,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;oBACnC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBAChC,CAAC;qBAAM,CAAC;oBACN,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;gBAC5C,CAAC;YACH,CAAC;YAED,IAAI,eAAe,CAAC,IAAI,GAAG,sBAAsB,EAAE,CAAC;gBAClD,oBAAoB,EAAE,CAAC;YACzB,CAAC;iBAAM,IAAI,eAAe,CAAC,IAAI,EAAE,CAAC;gBAChC,aAAa,EAAE,CAAC;YAClB,CAAC;QACH,CAAC,CAAC,CAAC;QACH,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,eAAe,EAAE;YACzC,UAAU,EAAE,IAAI;YAChB,eAAe,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC;YACxC,SAAS,EAAE,IAAI;YACf,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,MAAM,EAAE,CAAC;IACT,MAAM,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAC/C,IAAI,QAAQ,CAAC,eAAe;YAAE,eAAe,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC;QAC1E,KAAK,WAAW;aACb,MAAM,CAAC,yBAAyB,CAAC;aACjC,IAAI,CAAC,CAAC,OAAgB,EAAE,EAAE;YACzB,IAAI,OAAO;gBAAE,eAAe,EAAE,CAAC;QACjC,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC5B,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAElC,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,GAAG,EAAE;QACrC,QAAQ,EAAE,UAAU,EAAE,CAAC;QACvB,QAAQ,GAAG,IAAI,CAAC;QAChB,eAAe,CAAC,KAAK,EAAE,CAAC;QACxB,WAAW,EAAE,CAAC;IAChB,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;AACpC,CAAC"}

package/dist/src/drivers/electron/native/adblock/settings.d.ts

@@ -0,0 +1,9 @@
+export declare class AdBlockAllowlist {
+    readonly file: string;
+    private readonly paused;
+    private write;
+    constructor(file: string);
+    enabled(hostname: string): boolean;
+    setEnabled(hostname: string, enabled: boolean): void;
+    settled(): Promise<void>;
+}

package/dist/src/drivers/electron/native/adblock/settings.js

@@ -0,0 +1,37 @@
+import fs from 'node:fs';
+import { writeAtomic } from './cache.js';
+export class AdBlockAllowlist {
+    file;
+    paused;
+    write = Promise.resolve();
+    constructor(file) {
+        this.file = file;
+        this.paused = read(file);
+    }
+    enabled(hostname) { return Boolean(hostname) && !this.paused.has(normalize(hostname)); }
+    setEnabled(hostname, enabled) {
+        const value = normalize(hostname);
+        if (!value)
+            return;
+        if (enabled)
+            this.paused.delete(value);
+        else
+            this.paused.add(value);
+        const pausedHosts = [...this.paused].sort();
+        this.write = this.write.then(() => writeAtomic(this.file, `${JSON.stringify({ pausedHosts }, null, 2)}\n`));
+    }
+    settled() { return this.write; }
+}
+function read(file) {
+    try {
+        const value = JSON.parse(fs.readFileSync(file, 'utf8'));
+        return new Set(Array.isArray(value.pausedHosts)
+            ? value.pausedHosts.filter((item) => typeof item === 'string').map(normalize).filter(Boolean)
+            : []);
+    }
+    catch {
+        return new Set();
+    }
+}
+function normalize(value) { return value.trim().toLowerCase(); }
+//# sourceMappingURL=settings.js.map

package/dist/src/drivers/electron/native/adblock/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../../../../../src/drivers/electron/native/adblock/settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,OAAO,gBAAgB;IAIN;IAHJ,MAAM,CAAc;IAC7B,KAAK,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAElC,YAAqB,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;QAAI,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IAAC,CAAC;IAEhE,OAAO,CAAC,QAAgB,IAAa,OAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAEzG,UAAU,CAAC,QAAgB,EAAE,OAAgB;QAC3C,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,IAAI,OAAO;YAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;;YAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpE,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9G,CAAC;IAED,OAAO,KAAoB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;CAChD;AAED,SAAS,IAAI,CAAC,IAAY;IACxB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAA8B,CAAC;QACrF,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC;YAC7C,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;YAC7G,CAAC,CAAC,EAAE,CAAC,CAAC;IACV,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,IAAI,GAAG,EAAE,CAAC;IAAC,CAAC;AAC/B,CAAC;AAED,SAAS,SAAS,CAAC,KAAa,IAAY,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,4 @@
+export declare const LEGACY_BROWSER_SURFACE_PROTOCOL = 5;
+export declare const NATIVE_BROWSER_SURFACE_PROTOCOL = 6;
+export declare function nativeBrowserSurfacesEnabled(value?: string | undefined): boolean;
+export declare function browserSurfaceProtocol(): number;

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

@@ -0,0 +1,9 @@
+export const LEGACY_BROWSER_SURFACE_PROTOCOL = 5;
+export const NATIVE_BROWSER_SURFACE_PROTOCOL = 6;
+export function nativeBrowserSurfacesEnabled(value = process.env.AMALGM_BROWSER_WCV) {
+    return !/^(0|false|no|off)$/i.test(String(value || '').trim());
+}
+export function browserSurfaceProtocol() {
+    return nativeBrowserSurfacesEnabled() ? NATIVE_BROWSER_SURFACE_PROTOCOL : LEGACY_BROWSER_SURFACE_PROTOCOL;
+}
+//# sourceMappingURL=config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../../src/drivers/electron/native/config.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC;AACjD,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC;AAEjD,MAAM,UAAU,4BAA4B,CAAC,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB;IACjF,OAAO,CAAC,qBAAqB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,4BAA4B,EAAE,CAAC,CAAC,CAAC,+BAA+B,CAAC,CAAC,CAAC,+BAA+B,CAAC;AAC5G,CAAC"}

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

@@ -0,0 +1,174 @@
+export declare const BROWSER_IPC: {
+    readonly registerGuest: "browser:register-guest";
+    readonly surfaceCreate: "browser:surface-create";
+    readonly surfaceUpdate: "browser:surface-update";
+    readonly surfaceDestroy: "browser:surface-destroy";
+    readonly surfaceCommand: "browser:surface-command";
+    readonly surfaceCapture: "browser:surface-capture";
+    readonly surfaceState: "browser:surface-state";
+    readonly contextMenu: "browser:context-menu";
+    readonly contextAction: "browser:context-action";
+    readonly permissionRequest: "browser:permission-request";
+    readonly permissionResponse: "browser:permission-response";
+    readonly download: "browser:download";
+    readonly downloadAction: "browser:download-action";
+    readonly adBlockStatus: "browser:ad-block-status";
+    readonly adBlockGetStatus: "browser:ad-block-get-status";
+    readonly adBlockSetEnabled: "browser:ad-block-set-enabled";
+    readonly shortcut: "browser:shortcut";
+};
+export type BrowserShellCapabilities = {
+    readonly version: number;
+    readonly webContentsView: boolean;
+    readonly securePopups: boolean;
+    readonly nativeAdBlocking: boolean;
+    readonly agentSurfaceBridge: boolean;
+};
+export type BrowserShortcut = 'focus-location' | 'new-tab' | 'close-tab' | 'find' | 'reload' | 'zoom-in' | 'zoom-out' | 'zoom-reset';
+export type BrowserGuestRegistration = {
+    guestId: number;
+    tabId: string;
+    isAutomation: boolean;
+};
+export type BrowserSurfaceBounds = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+export type BrowserSurfaceCreateRequest = {
+    surfaceId: string;
+    tabId: string;
+    url: string;
+    isAutomation: boolean;
+    automationSessionId?: string;
+};
+export type BrowserSurfaceUpdateRequest = {
+    surfaceId: string;
+    bounds: BrowserSurfaceBounds;
+    visible: boolean;
+    scale: number;
+    isAutomation: boolean;
+};
+export type BrowserSurfaceFindResult = {
+    activeMatch: number;
+    matches: number;
+};
+export type BrowserSurfaceLoadError = {
+    code: number;
+    description: string;
+    url: string;
+};
+export type BrowserSurfaceState = {
+    surfaceId: string;
+    guestId: number;
+    ready: boolean;
+    url: string;
+    title: string;
+    favicons: string[];
+    isLoading: boolean;
+    canGoBack: boolean;
+    canGoForward: boolean;
+    zoomFactor: number;
+    findResult: BrowserSurfaceFindResult;
+    loadError: BrowserSurfaceLoadError | null;
+};
+export type BrowserSurfaceCommandRequest = {
+    surfaceId: string;
+    command: 'navigate';
+    url: string;
+} | {
+    surfaceId: string;
+    command: 'back' | 'forward' | 'reload' | 'focus';
+} | {
+    surfaceId: string;
+    command: 'find';
+    query: string;
+    forward: boolean;
+    findNext: boolean;
+} | {
+    surfaceId: string;
+    command: 'stop-find';
+    action: 'clearSelection' | 'keepSelection' | 'activateSelection';
+} | {
+    surfaceId: string;
+    command: 'set-zoom';
+    factor: number;
+};
+export type BrowserContextMenuPayload = {
+    requestId: string;
+    guestId: number;
+    x: number;
+    y: number;
+    pageUrl: string;
+    linkUrl: string;
+    linkText: string;
+    srcUrl: string;
+    mediaType: 'none' | 'image' | 'audio' | 'video' | 'canvas' | 'file' | 'plugin';
+    hasImageContents: boolean;
+    selectionText: string;
+    isEditable: boolean;
+    misspelledWord: string;
+    dictionarySuggestions: string[];
+    editFlags: {
+        canUndo: boolean;
+        canRedo: boolean;
+        canCut: boolean;
+        canCopy: boolean;
+        canPaste: boolean;
+        canDelete: boolean;
+        canSelectAll: boolean;
+    };
+};
+export type BrowserContextAction = 'back' | 'forward' | 'reload' | 'cut' | 'copy' | 'paste' | 'select-all' | 'copy-link' | 'copy-image' | 'copy-image-address' | 'open-link-new-tab' | 'open-link-external' | 'save-link' | 'save-image' | 'search-selection' | 'replace-misspelling' | 'inspect';
+export type BrowserContextActionRequest = {
+    requestId: string;
+    guestId: number;
+    action: BrowserContextAction;
+    value?: string;
+};
+export type BrowserPermissionPayload = {
+    requestId: string;
+    guestId: number;
+    origin: string;
+    permission: string;
+    mediaTypes: string[];
+};
+export type BrowserPermissionResponse = {
+    requestId: string;
+    allow: boolean;
+};
+export type BrowserDownloadState = 'starting' | 'progressing' | 'completed' | 'cancelled' | 'interrupted';
+export type BrowserDownloadPayload = {
+    id: string;
+    guestId: number;
+    filename: string;
+    savePath: string;
+    url: string;
+    receivedBytes: number;
+    totalBytes: number;
+    percent: number | null;
+    state: BrowserDownloadState;
+    canResume: boolean;
+    startedAt: number;
+};
+export type BrowserDownloadActionRequest = {
+    id: string;
+    action: 'cancel' | 'resume' | 'open' | 'show' | 'remove';
+};
+export type BrowserAdBlockStatus = {
+    guestId: number;
+    available: boolean;
+    loading: boolean;
+    enabled: boolean;
+    hostname: string;
+    blockedCount: number;
+};
+export type BrowserAdBlockSetRequest = {
+    guestId: number;
+    enabled: boolean;
+};
+export type BrowserShortcutPayload = {
+    guestId: number | null;
+    command: BrowserShortcut;
+};

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

@@ -0,0 +1,20 @@
+export const BROWSER_IPC = {
+    registerGuest: 'browser:register-guest',
+    surfaceCreate: 'browser:surface-create',
+    surfaceUpdate: 'browser:surface-update',
+    surfaceDestroy: 'browser:surface-destroy',
+    surfaceCommand: 'browser:surface-command',
+    surfaceCapture: 'browser:surface-capture',
+    surfaceState: 'browser:surface-state',
+    contextMenu: 'browser:context-menu',
+    contextAction: 'browser:context-action',
+    permissionRequest: 'browser:permission-request',
+    permissionResponse: 'browser:permission-response',
+    download: 'browser:download',
+    downloadAction: 'browser:download-action',
+    adBlockStatus: 'browser:ad-block-status',
+    adBlockGetStatus: 'browser:ad-block-get-status',
+    adBlockSetEnabled: 'browser:ad-block-set-enabled',
+    shortcut: 'browser:shortcut',
+};
+//# sourceMappingURL=contracts.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../../../src/drivers/electron/native/contracts.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,aAAa,EAAE,wBAAwB;IACvC,aAAa,EAAE,wBAAwB;IACvC,aAAa,EAAE,wBAAwB;IACvC,cAAc,EAAE,yBAAyB;IACzC,cAAc,EAAE,yBAAyB;IACzC,cAAc,EAAE,yBAAyB;IACzC,YAAY,EAAE,uBAAuB;IACrC,WAAW,EAAE,sBAAsB;IACnC,aAAa,EAAE,wBAAwB;IACvC,iBAAiB,EAAE,4BAA4B;IAC/C,kBAAkB,EAAE,6BAA6B;IACjD,QAAQ,EAAE,kBAAkB;IAC5B,cAAc,EAAE,yBAAyB;IACzC,aAAa,EAAE,yBAAyB;IACxC,gBAAgB,EAAE,6BAA6B;IAC/C,iBAAiB,EAAE,8BAA8B;IACjD,QAAQ,EAAE,kBAAkB;CACpB,CAAC"}

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

@@ -0,0 +1,7 @@
+export declare function parseUrl(value: string): URL | null;
+export declare function isAllowedWebUrl(value: string): boolean;
+export declare function isAllowedExternalUrl(value: string): boolean;
+export declare function permissionOrigin(requestingUrl: string, fallbackUrl: string): string;
+export declare function shouldOpenAsTab(disposition: string): boolean;
+export declare function safeDownloadFilename(value: string): string;
+export declare function nextAvailableDownloadPath(downloadsDirectory: string, filename: string, exists: (candidate: string) => boolean): string;

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

@@ -0,0 +1,43 @@
+import path from 'path';
+const WEB_PROTOCOLS = new Set(['http:', 'https:', 'about:']);
+const EXTERNAL_PROTOCOLS = new Set(['mailto:', 'tel:']);
+export function parseUrl(value) {
+    try {
+        return new URL(value);
+    }
+    catch {
+        return null;
+    }
+}
+export function isAllowedWebUrl(value) {
+    const parsed = parseUrl(value);
+    return Boolean(parsed && WEB_PROTOCOLS.has(parsed.protocol));
+}
+export function isAllowedExternalUrl(value) {
+    const parsed = parseUrl(value);
+    return Boolean(parsed && EXTERNAL_PROTOCOLS.has(parsed.protocol));
+}
+export function permissionOrigin(requestingUrl, fallbackUrl) {
+    const parsed = parseUrl(requestingUrl) ?? parseUrl(fallbackUrl);
+    return parsed?.origin && parsed.origin !== 'null' ? parsed.origin : '';
+}
+export function shouldOpenAsTab(disposition) {
+    return disposition === 'foreground-tab' || disposition === 'background-tab';
+}
+export function safeDownloadFilename(value) {
+    const filename = path.basename(String(value || '').trim());
+    return filename && filename !== '.' && filename !== '..' ? filename : 'download';
+}
+export function nextAvailableDownloadPath(downloadsDirectory, filename, exists) {
+    const safeName = safeDownloadFilename(filename);
+    const extension = path.extname(safeName);
+    const stem = path.basename(safeName, extension);
+    let candidate = path.join(downloadsDirectory, safeName);
+    let suffix = 1;
+    while (exists(candidate)) {
+        candidate = path.join(downloadsDirectory, `${stem} (${suffix})${extension}`);
+        suffix += 1;
+    }
+    return candidate;
+}
+//# sourceMappingURL=policy.js.map