@amalgm/browser 0.1.0

package/dist/src/drivers/electron/advertisement.js

@@ -0,0 +1,57 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { LOOPBACK_ORIGIN_HOSTNAMES } from '@amalgm/core/transport';
+import { BrowserError } from '../../errors.js';
+import { BROWSER_SURFACE_PROTOCOL } from './contracts.js';
+export function writeHostAdvertisement(options) {
+    const protocol = options.protocol || BROWSER_SURFACE_PROTOCOL;
+    const pid = options.pid || process.pid;
+    if (!isLoopbackCdpUrl(options.cdpUrl)) {
+        throw new BrowserError('INVALID_INPUT', 'Electron Browser CDP advertisement must use loopback.');
+    }
+    const data = {
+        browserSurfaceProtocol: protocol,
+        browserSurfaceTargetType: protocol === 5 ? 'webview' : 'page',
+        browserSurfaceTargetTypes: protocol === 5 ? ['webview'] : ['page', 'webview'],
+        cdp: { url: options.cdpUrl, port: options.cdpPort },
+        ...(protocol === 5 ? { cdpUrl: options.cdpUrl, cdpPort: options.cdpPort } : {}),
+        ...(options.label ? { label: options.label } : {}),
+        pid,
+        startedAt: options.startedAt || new Date().toISOString(),
+    };
+    const temporary = `${options.file}.${pid}.${Date.now()}.tmp`;
+    fs.mkdirSync(path.dirname(options.file), { recursive: true, mode: 0o700 });
+    try {
+        fs.writeFileSync(temporary, `${JSON.stringify(data, null, 2)}\n`, { mode: 0o600 });
+        fs.renameSync(temporary, options.file);
+        fs.chmodSync(options.file, 0o600);
+    }
+    catch (error) {
+        fs.rmSync(temporary, { force: true });
+        throw error;
+    }
+}
+export function removeHostAdvertisement(file, pid = process.pid) {
+    try {
+        const value = JSON.parse(fs.readFileSync(file, 'utf8'));
+        if (value.pid !== pid)
+            return false;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return false;
+    }
+    fs.rmSync(file, { force: true });
+    return true;
+}
+export function isLoopbackCdpUrl(value) {
+    try {
+        const url = new URL(value);
+        return ['http:', 'https:', 'ws:', 'wss:'].includes(url.protocol)
+            && LOOPBACK_ORIGIN_HOSTNAMES.includes(url.hostname);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=advertisement.js.map

package/dist/src/drivers/electron/advertisement.js.map

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

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

@@ -0,0 +1,45 @@
+import type { BrowserAction, BrowserActionResult, BrowserCapability, BrowserRuntimeContext, BrowserSession } from '../../types.js';
+export declare const BROWSER_SESSION_PARTITION = "persist:amalgm-browser";
+export declare const BROWSER_SURFACE_PROTOCOL = 6;
+export declare const BROWSER_SURFACE_PROTOCOLS: readonly [5, 6];
+export interface ElectronSurfaceIdentity {
+    surfaceId: string;
+    browserSessionId: string;
+    stamp: string;
+    protocol: number;
+    targetType: 'page' | 'webview';
+}
+export interface ElectronSurfaceState {
+    identity: ElectronSurfaceIdentity;
+    url: string;
+    title: string;
+    focused: boolean;
+    visible: boolean;
+    bounds: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}
+export interface ElectronVisibleHost {
+    readonly capabilities: readonly BrowserCapability[];
+    requestSurface(input: {
+        session: BrowserSession;
+        markerUrl: string;
+        stamp: string;
+        context: BrowserRuntimeContext;
+    }): Promise<ElectronSurfaceIdentity>;
+    execute(input: {
+        identity: ElectronSurfaceIdentity;
+        action: BrowserAction;
+        context: BrowserRuntimeContext;
+    }): Promise<BrowserActionResult>;
+    inspect(identity: ElectronSurfaceIdentity): Promise<ElectronSurfaceState | null>;
+    retire(identity: ElectronSurfaceIdentity): Promise<void>;
+    saveState?(identity: ElectronSurfaceIdentity): Promise<unknown>;
+    loadState?(identity: ElectronSurfaceIdentity, state: unknown): Promise<void>;
+    startScreencast?(identity: ElectronSurfaceIdentity, onFrame: (png: Buffer) => void, signal?: AbortSignal): Promise<() => Promise<void>>;
+}
+export declare function surfaceStamp(sessionId: string): string;
+export declare function markerUrl(sessionId: string): string;

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

@@ -0,0 +1,10 @@
+export const BROWSER_SESSION_PARTITION = 'persist:amalgm-browser';
+export const BROWSER_SURFACE_PROTOCOL = 6;
+export const BROWSER_SURFACE_PROTOCOLS = [5, BROWSER_SURFACE_PROTOCOL];
+export function surfaceStamp(sessionId) {
+    return `amalgm-browser:${sessionId}`;
+}
+export function markerUrl(sessionId) {
+    return `about:blank#amalgm-bsid-${encodeURIComponent(sessionId)}`;
+}
+//# sourceMappingURL=contracts.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../../src/drivers/electron/contracts.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,yBAAyB,GAAG,wBAAwB,CAAC;AAClE,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAC1C,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,EAAE,wBAAwB,CAAU,CAAC;AA2ChF,MAAM,UAAU,YAAY,CAAC,SAAiB;IAC5C,OAAO,kBAAkB,SAAS,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,SAAiB;IACzC,OAAO,2BAA2B,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC;AACpE,CAAC"}

package/dist/src/drivers/electron/cookie-adapter.d.ts

@@ -0,0 +1,17 @@
+import type { Cookies } from 'electron';
+import type { BrowserCookie, BrowserCookieAdapter, BrowserCookieMutation } from '../../cookies/types.js';
+export declare const ELECTRON_COOKIE_ADAPTER_ID = "electron:default-session";
+export declare class ElectronCookieAdapter implements BrowserCookieAdapter {
+    private readonly cookies;
+    readonly id = "electron:default-session";
+    readonly supportsPartitionedCookies = false;
+    constructor(cookies: Cookies);
+    read(): Promise<BrowserCookie[]>;
+    apply(input: {
+        upserts: BrowserCookie[];
+        deletes: BrowserCookieMutation['deletes'];
+        versionToken: string;
+        signal?: AbortSignal;
+    }): Promise<void>;
+    subscribe(changed: () => void): () => void;
+}

package/dist/src/drivers/electron/cookie-adapter.js

@@ -0,0 +1,69 @@
+export const ELECTRON_COOKIE_ADAPTER_ID = 'electron:default-session';
+export class ElectronCookieAdapter {
+    cookies;
+    id = ELECTRON_COOKIE_ADAPTER_ID;
+    supportsPartitionedCookies = false;
+    constructor(cookies) {
+        this.cookies = cookies;
+    }
+    async read() {
+        return (await this.cookies.get({})).map(fromElectron);
+    }
+    async apply(input) {
+        input.signal?.throwIfAborted();
+        for (const cookie of input.upserts) {
+            input.signal?.throwIfAborted();
+            if (!cookie.partitionKey)
+                await this.cookies.set(toElectron(cookie));
+        }
+        for (const cookie of input.deletes || []) {
+            input.signal?.throwIfAborted();
+            if (cookie.partitionKey)
+                continue;
+            await Promise.all([
+                this.cookies.remove(cookieUrl(cookie.domain, cookie.path, false), cookie.name),
+                this.cookies.remove(cookieUrl(cookie.domain, cookie.path, true), cookie.name),
+            ]);
+        }
+    }
+    subscribe(changed) {
+        const listener = (_event, _cookie, _cause, _removed) => changed();
+        this.cookies.on('changed', listener);
+        return () => this.cookies.off('changed', listener);
+    }
+}
+function fromElectron(cookie) {
+    return {
+        name: cookie.name,
+        value: cookie.value,
+        domain: cookie.domain || '',
+        path: cookie.path || '/',
+        ...(typeof cookie.expirationDate === 'number' && cookie.expirationDate >= 0
+            ? { expires: cookie.expirationDate } : {}),
+        httpOnly: Boolean(cookie.httpOnly),
+        secure: Boolean(cookie.secure),
+        sameSite: cookie.sameSite === 'strict' ? 'Strict'
+            : cookie.sameSite === 'no_restriction' ? 'None' : 'Lax',
+    };
+}
+function toElectron(cookie) {
+    const hostOnly = !cookie.domain.startsWith('.');
+    return {
+        url: cookieUrl(cookie.domain, cookie.path, Boolean(cookie.secure) || cookie.sameSite === 'None'),
+        name: cookie.name,
+        value: cookie.value,
+        path: cookie.path || '/',
+        secure: Boolean(cookie.secure),
+        httpOnly: Boolean(cookie.httpOnly),
+        sameSite: cookie.sameSite === 'Strict' ? 'strict'
+            : cookie.sameSite === 'None' ? 'no_restriction' : 'lax',
+        ...(!hostOnly ? { domain: cookie.domain } : {}),
+        ...(typeof cookie.expires === 'number' ? { expirationDate: cookie.expires } : {}),
+    };
+}
+function cookieUrl(domain, path, secure) {
+    const host = domain.trim().toLowerCase().replace(/^\.+/, '');
+    const normalizedPath = String(path || '/').startsWith('/') ? path || '/' : `/${path}`;
+    return `${secure ? 'https' : 'http'}://${host}${normalizedPath}`;
+}
+//# sourceMappingURL=cookie-adapter.js.map

package/dist/src/drivers/electron/cookie-adapter.js.map

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

package/dist/src/drivers/electron/driver.d.ts

@@ -0,0 +1,19 @@
+import type { BrowserDriver, BrowserDriverSession } from '../../ports.js';
+import type { BrowserAction, BrowserActionResult } from '../../types.js';
+import { type ElectronVisibleHost } from './contracts.js';
+export declare class ElectronBrowserDriver implements BrowserDriver {
+    readonly host: ElectronVisibleHost;
+    readonly kind: "electron";
+    readonly capabilities: import("../../types.js").BrowserCapability[];
+    private readonly identities;
+    constructor(host: ElectronVisibleHost);
+    open(input: BrowserDriverSession): Promise<void>;
+    execute(input: BrowserDriverSession, action: BrowserAction): Promise<BrowserActionResult>;
+    close(input: BrowserDriverSession): Promise<void>;
+    saveState(input: BrowserDriverSession): Promise<unknown>;
+    loadState(input: BrowserDriverSession, state: unknown): Promise<void>;
+    startScreencast(input: BrowserDriverSession, onFrame: (png: Buffer) => void): Promise<() => Promise<void>>;
+    private bind;
+    private verified;
+    private reattachOnce;
+}

package/dist/src/drivers/electron/driver.js

@@ -0,0 +1,115 @@
+import { BrowserError } from '../../errors.js';
+import { BROWSER_SURFACE_PROTOCOLS, markerUrl, surfaceStamp, } from './contracts.js';
+export class ElectronBrowserDriver {
+    host;
+    kind = 'electron';
+    capabilities;
+    identities = new Map();
+    constructor(host) {
+        this.host = host;
+        this.capabilities = [...host.capabilities];
+    }
+    async open(input) {
+        const identity = await this.bind(input);
+        this.identities.set(input.session.id, identity);
+    }
+    async execute(input, action) {
+        let identity;
+        try {
+            identity = await this.verified(input);
+        }
+        catch (error) {
+            const previous = this.identities.get(input.session.id);
+            if (!previous || !isMissingSurface(error))
+                throw error;
+            identity = await this.reattachOnce(input, previous);
+        }
+        try {
+            return await this.host.execute({ identity, action, context: input.context });
+        }
+        catch (error) {
+            if (!isSurfaceLoss(error))
+                throw error;
+            identity = await this.reattachOnce(input, identity);
+            return this.host.execute({ identity, action, context: input.context });
+        }
+    }
+    async close(input) {
+        const identity = this.identities.get(input.session.id);
+        this.identities.delete(input.session.id);
+        if (identity)
+            await this.host.retire(identity);
+    }
+    async saveState(input) {
+        const identity = await this.verified(input);
+        if (!this.host.saveState)
+            throw new BrowserError('CAPABILITY_UNSUPPORTED', 'Electron host cannot save auth state.');
+        return this.host.saveState(identity);
+    }
+    async loadState(input, state) {
+        const identity = await this.verified(input);
+        if (!this.host.loadState)
+            throw new BrowserError('CAPABILITY_UNSUPPORTED', 'Electron host cannot load auth state.');
+        await this.host.loadState(identity, state);
+    }
+    async startScreencast(input, onFrame) {
+        const identity = await this.verified(input);
+        if (!this.host.startScreencast)
+            throw new BrowserError('CAPABILITY_UNSUPPORTED', 'Electron host cannot record its page.');
+        return this.host.startScreencast(identity, onFrame, input.context.signal);
+    }
+    async bind(input) {
+        const identity = await this.host.requestSurface({
+            session: input.session,
+            markerUrl: markerUrl(input.session.id),
+            stamp: surfaceStamp(input.session.id),
+            context: input.context,
+        });
+        assertIdentity(identity, input.session.id);
+        return identity;
+    }
+    async verified(input) {
+        const identity = this.identities.get(input.session.id);
+        if (!identity)
+            throw new BrowserError('SURFACE_IDENTITY_FAILED', 'Visible surface is not bound.', { reason: 'unbound' });
+        const state = await this.host.inspect(identity);
+        if (!state)
+            throw new BrowserError('SURFACE_IDENTITY_FAILED', 'Visible surface was lost.', { reason: 'lost' });
+        if (!sameIdentity(state.identity, identity)) {
+            throw new BrowserError('SURFACE_IDENTITY_FAILED', 'Visible surface identity did not match.', { reason: 'mismatch' });
+        }
+        return identity;
+    }
+    async reattachOnce(input, previous) {
+        const next = await this.bind(input);
+        if (next.surfaceId !== previous.surfaceId && next.stamp !== previous.stamp) {
+            throw new BrowserError('SURFACE_IDENTITY_FAILED', 'Visible surface reattachment returned an unrelated page.');
+        }
+        this.identities.set(input.session.id, next);
+        return next;
+    }
+}
+function assertIdentity(identity, sessionId) {
+    if (identity.browserSessionId !== sessionId
+        || identity.stamp !== surfaceStamp(sessionId)
+        || !BROWSER_SURFACE_PROTOCOLS.includes(identity.protocol)) {
+        throw new BrowserError('SURFACE_IDENTITY_FAILED', 'Electron host returned an incompatible surface identity.');
+    }
+}
+function sameIdentity(left, right) {
+    return left.surfaceId === right.surfaceId
+        && left.browserSessionId === right.browserSessionId
+        && left.stamp === right.stamp
+        && left.protocol === right.protocol;
+}
+function isSurfaceLoss(error) {
+    return error instanceof BrowserError
+        && error.code === 'SURFACE_IDENTITY_FAILED'
+        && error.details?.reason === 'lost';
+}
+function isMissingSurface(error) {
+    return error instanceof BrowserError
+        && error.code === 'SURFACE_IDENTITY_FAILED'
+        && error.details?.reason === 'lost';
+}
+//# sourceMappingURL=driver.js.map

package/dist/src/drivers/electron/driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../../../../src/drivers/electron/driver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C,OAAO,EACL,yBAAyB,EACzB,SAAS,EACT,YAAY,GAGb,MAAM,gBAAgB,CAAC;AAExB,MAAM,OAAO,qBAAqB;IAKX;IAJZ,IAAI,GAAG,UAAmB,CAAC;IAC3B,YAAY,CAAC;IACL,UAAU,GAAG,IAAI,GAAG,EAAmC,CAAC;IAEzE,YAAqB,IAAyB;QAAzB,SAAI,GAAJ,IAAI,CAAqB;QAC5C,IAAI,CAAC,YAAY,GAAG,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAA2B;QACpC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAA2B,EAAE,MAAqB;QAC9D,IAAI,QAAiC,CAAC;QACtC,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACvD,IAAI,CAAC,QAAQ,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC;gBAAE,MAAM,KAAK,CAAC;YACvD,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;gBAAE,MAAM,KAAK,CAAC;YACvC,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;YACpD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAA2B;QACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACvD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACzC,IAAI,QAAQ;YAAE,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAA2B;QACzC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,YAAY,CAAC,wBAAwB,EAAE,uCAAuC,CAAC,CAAC;QACpH,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAA2B,EAAE,KAAc;QACzD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,YAAY,CAAC,wBAAwB,EAAE,uCAAuC,CAAC,CAAC;QACpH,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,KAA2B,EAAE,OAA8B;QAC/E,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe;YAAE,MAAM,IAAI,YAAY,CAAC,wBAAwB,EAAE,uCAAuC,CAAC,CAAC;QAC1H,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5E,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,KAA2B;QAC5C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC;YAC9C,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YACtC,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YACrC,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;QACH,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC3C,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAC,KAA2B;QAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACvD,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,YAAY,CACnC,yBAAyB,EAAE,+BAA+B,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAClF,CAAC;QACF,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAChD,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,YAAY,CAChC,yBAAyB,EAAE,2BAA2B,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAC3E,CAAC;QACF,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,YAAY,CACpB,yBAAyB,EAAE,yCAAyC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAC7F,CAAC;QACJ,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,KAAK,CAAC,YAAY,CACxB,KAA2B,EAC3B,QAAiC;QAEjC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,IAAI,CAAC,SAAS,KAAK,QAAQ,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,KAAK,EAAE,CAAC;YAC3E,MAAM,IAAI,YAAY,CAAC,yBAAyB,EAAE,0DAA0D,CAAC,CAAC;QAChH,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,SAAS,cAAc,CAAC,QAAiC,EAAE,SAAiB;IAC1E,IAAI,QAAQ,CAAC,gBAAgB,KAAK,SAAS;WACtC,QAAQ,CAAC,KAAK,KAAK,YAAY,CAAC,SAAS,CAAC;WAC1C,CAAE,yBAA+C,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnF,MAAM,IAAI,YAAY,CAAC,yBAAyB,EAAE,0DAA0D,CAAC,CAAC;IAChH,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,IAA6B,EAAE,KAA8B;IACjF,OAAO,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS;WACpC,IAAI,CAAC,gBAAgB,KAAK,KAAK,CAAC,gBAAgB;WAChD,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK;WAC1B,IAAI,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,CAAC;AACxC,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,KAAK,YAAY,YAAY;WAC/B,KAAK,CAAC,IAAI,KAAK,yBAAyB;WACxC,KAAK,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;AACxC,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,OAAO,KAAK,YAAY,YAAY;WAC/B,KAAK,CAAC,IAAI,KAAK,yBAAyB;WACxC,KAAK,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;AACxC,CAAC"}

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

@@ -0,0 +1,4 @@
+import { FiltersEngine } from '@ghostery/adblocker';
+export declare function isAdBlockCacheFresh(mtimeMs: number, now?: number): boolean;
+export declare function loadAdBlockEngine(cachePath: string, fetchImpl?: typeof globalThis.fetch): Promise<FiltersEngine | null>;
+export declare function writeAtomic(file: string, data: Uint8Array | string): Promise<void>;

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

@@ -0,0 +1,54 @@
+import { FiltersEngine } from '@ghostery/adblocker';
+import fs from 'node:fs';
+import path from 'node:path';
+const MAX_AGE_MS = 7 * 24 * 60 * 60_000;
+const DOWNLOAD_TIMEOUT_MS = 15_000;
+export function isAdBlockCacheFresh(mtimeMs, now = Date.now()) {
+    return Number.isFinite(mtimeMs) && now - mtimeMs <= MAX_AGE_MS;
+}
+export async function loadAdBlockEngine(cachePath, fetchImpl) {
+    const cached = await readCache(cachePath);
+    if (cached && isAdBlockCacheFresh(cached.mtimeMs)) {
+        try {
+            return FiltersEngine.deserialize(cached.data);
+        }
+        catch { /* refresh the unreadable cache */ }
+    }
+    try {
+        const engine = await FiltersEngine.fromPrebuiltAdsAndTracking((url) => (fetchImpl || globalThis.fetch)(url, { signal: AbortSignal.timeout(DOWNLOAD_TIMEOUT_MS) }));
+        await writeAtomic(cachePath, engine.serialize()).catch(() => undefined);
+        return engine;
+    }
+    catch {
+        if (!cached)
+            return null;
+        try {
+            return FiltersEngine.deserialize(cached.data);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+async function readCache(file) {
+    try {
+        const [data, stat] = await Promise.all([fs.promises.readFile(file), fs.promises.stat(file)]);
+        return { data, mtimeMs: stat.mtimeMs };
+    }
+    catch {
+        return null;
+    }
+}
+export async function writeAtomic(file, data) {
+    await fs.promises.mkdir(path.dirname(file), { recursive: true, mode: 0o700 });
+    const temporary = `${file}.${process.pid}.${Date.now()}.tmp`;
+    try {
+        await fs.promises.writeFile(temporary, data, { mode: 0o600 });
+        await fs.promises.rename(temporary, file);
+    }
+    catch (error) {
+        await fs.promises.rm(temporary, { force: true });
+        throw error;
+    }
+}
+//# sourceMappingURL=cache.js.map

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

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

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

@@ -0,0 +1,11 @@
+import type { FiltersEngine } from '@ghostery/adblocker';
+import type { BrowserAdBlockPage } from './index.js';
+import type { AdBlockAllowlist } from './settings.js';
+export declare const COSMETIC_INJECTION_CHANNEL = "@ghostery/adblocker/inject-cosmetic-filters";
+export declare const MUTATION_OBSERVER_CHANNEL = "@ghostery/adblocker/is-mutation-observer-enabled";
+export declare function installCosmeticHandlers(input: {
+    engine(): FiltersEngine | null;
+    ready(): Promise<void>;
+    resolvePage(id: number): BrowserAdBlockPage | null;
+    allowlist: AdBlockAllowlist;
+}): () => void;

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

@@ -0,0 +1,45 @@
+import { ipcMain } from 'electron';
+import { parse as parseDomain } from 'tldts-experimental';
+export const COSMETIC_INJECTION_CHANNEL = '@ghostery/adblocker/inject-cosmetic-filters';
+export const MUTATION_OBSERVER_CHANNEL = '@ghostery/adblocker/is-mutation-observer-enabled';
+export function installCosmeticHandlers(input) {
+    ipcMain.handle(MUTATION_OBSERVER_CHANNEL, async (event) => {
+        await input.ready();
+        const page = input.resolvePage(event.sender.id);
+        return Boolean(page && input.engine()?.config.enableMutationObserver && input.allowlist.enabled(page.hostname));
+    });
+    ipcMain.handle(COSMETIC_INJECTION_CHANNEL, async (event, _url, update) => {
+        await input.ready();
+        const page = input.resolvePage(event.sender.id);
+        const engine = input.engine();
+        if (!page || !engine || !input.allowlist.enabled(page.hostname) || event.sender.isDestroyed())
+            return;
+        const parsed = parseDomain(page.url);
+        const first = update === undefined;
+        const result = engine.getCosmeticsFilters({
+            url: page.url,
+            hostname: page.hostname,
+            domain: parsed.domain || page.hostname,
+            classes: update?.classes,
+            hrefs: update?.hrefs,
+            ids: update?.ids,
+            getBaseRules: first,
+            getInjectionRules: first,
+            getExtendedRules: false,
+            getRulesFromHostname: first,
+            getRulesFromDOM: !first,
+            callerContext: { frameId: event.frameId, processId: event.processId, lifecycle: update?.lifecycle },
+        });
+        if (result.active === false)
+            return;
+        if (result.styles)
+            await event.sender.insertCSS(result.styles, { cssOrigin: 'user' });
+        for (const script of result.scripts)
+            await event.sender.executeJavaScript(script, true).catch(() => undefined);
+    });
+    return () => {
+        ipcMain.removeHandler(COSMETIC_INJECTION_CHANNEL);
+        ipcMain.removeHandler(MUTATION_OBSERVER_CHANNEL);
+    };
+}
+//# sourceMappingURL=cosmetics.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cosmetics.js","sourceRoot":"","sources":["../../../../../../src/drivers/electron/native/adblock/cosmetics.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,KAAK,IAAI,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAI1D,MAAM,CAAC,MAAM,0BAA0B,GAAG,6CAA6C,CAAC;AACxF,MAAM,CAAC,MAAM,yBAAyB,GAAG,kDAAkD,CAAC;AAS5F,MAAM,UAAU,uBAAuB,CAAC,KAKvC;IACC,OAAO,CAAC,MAAM,CAAC,yBAAyB,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QACxD,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;QACpB,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAChD,OAAO,OAAO,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,sBAAsB,IAAI,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClH,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,MAAM,CAAC,0BAA0B,EAAE,KAAK,EAAE,KAAK,EAAE,IAAY,EAAE,MAAuB,EAAE,EAAE;QAChG,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;QACpB,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QAC9B,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE;YAAE,OAAO;QACtG,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,KAAK,GAAG,MAAM,KAAK,SAAS,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,CAAC,mBAAmB,CAAC;YACxC,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ;YACtC,OAAO,EAAE,MAAM,EAAE,OAAO;YACxB,KAAK,EAAE,MAAM,EAAE,KAAK;YACpB,GAAG,EAAE,MAAM,EAAE,GAAG;YAChB,YAAY,EAAE,KAAK;YACnB,iBAAiB,EAAE,KAAK;YACxB,gBAAgB,EAAE,KAAK;YACvB,oBAAoB,EAAE,KAAK;YAC3B,eAAe,EAAE,CAAC,KAAK;YACvB,aAAa,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE;SACpG,CAAC,CAAC;QACH,IAAI,MAAM,CAAC,MAAM,KAAK,KAAK;YAAE,OAAO;QACpC,IAAI,MAAM,CAAC,MAAM;YAAE,MAAM,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QACtF,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO;YAAE,MAAM,KAAK,CAAC,MAAM,CAAC,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACjH,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,EAAE;QACV,OAAO,CAAC,aAAa,CAAC,0BAA0B,CAAC,CAAC;QAClD,OAAO,CAAC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACnD,CAAC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,44 @@
+import type { Session } from 'electron';
+import type { BrowserAdBlockStatus } from '../contracts.js';
+export { isAdBlockCacheFresh } from './cache.js';
+export { adBlockHostname, isNativeAdBlockDisabled } from './policy.js';
+export interface BrowserAdBlockPage {
+    guestId: number;
+    webContentsId: number;
+    hostname: string;
+    url: string;
+}
+export interface NativeAdBlockerOptions {
+    cachePath: string;
+    settingsPath: string;
+    preloadPath?: string;
+    resolvePage(webContentsId: number): BrowserAdBlockPage | null;
+    onStatus(status: BrowserAdBlockStatus): void;
+    onReady(): void;
+    disabled?: boolean;
+    fetch?: typeof globalThis.fetch;
+}
+export declare class NativeAdBlocker {
+    readonly options: NativeAdBlockerOptions;
+    private engine;
+    private loading;
+    private installed;
+    private readyPromise;
+    private removeCosmetics?;
+    private readonly counts;
+    private readonly timers;
+    private readonly allowlist;
+    private readonly disabled;
+    constructor(options: NativeAdBlockerOptions);
+    cosmeticPreloadPath(): string | null;
+    install(session: Session): void;
+    status(webContentsId: number, guestId: number): BrowserAdBlockStatus;
+    setHostEnabled(hostname: string, enabled: boolean): void;
+    publish(webContentsId: number, guestId: number): void;
+    resetGuest(guestId: number): void;
+    forgetGuest(guestId: number): void;
+    dispose(): void;
+    private initialize;
+    private blocked;
+    private clearTimer;
+}