@amalgm/browser 0.1.0

package/dist/src/profiles/service.js

@@ -0,0 +1,89 @@
+import { BrowserError } from '../errors.js';
+import { safeId } from '../ids.js';
+export class BrowserProfileStore {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    create(input) {
+        const id = safeId(input.id || this.options.generate());
+        if (this.find(id))
+            throw new BrowserError('CONFLICT', `Browser profile ${id} already exists.`);
+        return this.ensure(id, input.kind || 'durable', input.name);
+    }
+    list() { return this.options.registry.snapshot().profiles; }
+    get(id) {
+        const profile = this.find(id);
+        if (!profile)
+            throw new BrowserError('NOT_FOUND', `Browser profile ${id} does not exist.`);
+        return profile;
+    }
+    update(id, patch) {
+        const profile = this.get(id);
+        const updated = {
+            ...profile,
+            ...(patch.name !== undefined ? { name: patch.name.trim() || profile.name } : {}),
+            ...(patch.kind !== undefined ? { kind: patch.kind } : {}),
+            updatedAt: this.options.now(),
+        };
+        this.options.registry.putProfile(updated);
+        this.options.publish(updated.id);
+        return updated;
+    }
+    inspect(id, sessions, referenced) {
+        return {
+            profile: this.get(id),
+            live: sessions.some((session) => session.profileId === id && !isFinished(session)),
+            referenced: referenced.has(id),
+            locked: this.options.directories?.isLocked(id) || false,
+        };
+    }
+    delete(id, sessions) {
+        if (sessions.some((session) => session.profileId === id && !isFinished(session))) {
+            throw new BrowserError('CONFLICT', `Browser profile ${id} belongs to a live session.`);
+        }
+        if (this.options.directories?.isLocked(id)) {
+            throw new BrowserError('CONFLICT', `Browser profile ${id} has a live Chromium lock.`);
+        }
+        this.options.directories?.remove(id);
+        this.options.registry.deleteProfile(id);
+    }
+    prune(maxAgeMs, referenced, sessions) {
+        const cutoff = Date.parse(this.options.now()) - maxAgeMs;
+        const live = new Set(sessions.filter((session) => !isFinished(session)).map((session) => session.profileId));
+        const removed = this.list().filter((profile) => profile.kind === 'ephemeral'
+            && !live.has(profile.id)
+            && !referenced.has(profile.id)
+            && !this.options.directories?.isLocked(profile.id)
+            && Math.max(Date.parse(profile.lastUsedAt), this.options.directories?.lastTouchedAt(profile.id) || 0) < cutoff)
+            .map((profile) => profile.id);
+        for (const id of removed) {
+            this.options.directories?.remove(id);
+            this.options.registry.deleteProfile(id);
+        }
+        return removed;
+    }
+    ensure(idValue, kind, name = idValue) {
+        const id = safeId(idValue);
+        const existing = this.find(id);
+        if (existing)
+            return existing;
+        const now = this.options.now();
+        const profile = { id, name, kind, createdAt: now, updatedAt: now, lastUsedAt: now };
+        this.options.registry.putProfile(profile);
+        this.options.publish(id);
+        return profile;
+    }
+    touch(id) {
+        const profile = this.get(id);
+        const now = this.options.now();
+        this.options.registry.putProfile({ ...profile, updatedAt: now, lastUsedAt: now });
+    }
+    find(id) {
+        return this.list().find((profile) => profile.id === safeId(id));
+    }
+}
+function isFinished(session) {
+    return session.status === 'closed' || session.status === 'failed';
+}
+//# sourceMappingURL=service.js.map

package/dist/src/profiles/service.js.map

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

package/dist/src/recording/encoder.d.ts

@@ -0,0 +1,22 @@
+export interface EncoderResult {
+    frames: number;
+    videoSeconds: number;
+    wallSeconds: number;
+    forced: boolean;
+    framesReceived: number;
+    skippedTicks: number;
+    warning?: string;
+}
+export declare class WebmEncoder {
+    readonly binary: string;
+    readonly file: string;
+    readonly fps: number;
+    private child?;
+    private sampler?;
+    private startedAt;
+    constructor(binary: string, file: string, fps: number);
+    start(): Promise<void>;
+    frame(png: Buffer): void;
+    stop(): Promise<EncoderResult>;
+    force(): void;
+}

package/dist/src/recording/encoder.js

@@ -0,0 +1,89 @@
+import { spawn } from 'node:child_process';
+import { BrowserError } from '../errors.js';
+import { deadline } from '../drivers/cdp/client.js';
+import { LatestFrameSampler } from './sampler.js';
+export class WebmEncoder {
+    binary;
+    file;
+    fps;
+    child;
+    sampler;
+    startedAt = 0;
+    constructor(binary, file, fps) {
+        this.binary = binary;
+        this.file = file;
+        this.fps = fps;
+    }
+    async start() {
+        const child = spawn(this.binary, encoderArgs(this.file, this.fps), { stdio: ['pipe', 'ignore', 'pipe'] });
+        this.child = child;
+        await new Promise((resolve, reject) => {
+            const ready = setTimeout(resolve, 100);
+            child.once('error', (error) => { clearTimeout(ready); reject(error); });
+            child.once('spawn', () => { clearTimeout(ready); resolve(); });
+        }).catch((error) => {
+            throw new BrowserError('PROCESS_FAILED', `ffmpeg failed to start: ${error.message}`);
+        });
+        child.stderr.on('data', () => undefined);
+        child.stdin.on('error', () => undefined);
+        this.sampler = new LatestFrameSampler(this.fps, (frame, onDrain) => {
+            const ready = child.stdin.write(frame);
+            if (!ready)
+                child.stdin.once('drain', onDrain);
+            return ready;
+        });
+        this.startedAt = Date.now();
+        this.sampler.start();
+    }
+    frame(png) { this.sampler?.push(png); }
+    async stop() {
+        if (!this.child)
+            throw new BrowserError('CONFLICT', 'Encoder was not started.');
+        this.sampler?.stop();
+        this.sampler?.tick();
+        const wallSeconds = Math.max(0, (Date.now() - this.startedAt) / 1_000);
+        const stats = this.sampler?.stats || { received: 0, encoded: 0, skippedTicks: 0 };
+        if (!stats.encoded) {
+            this.child.kill('SIGKILL');
+            await onceClosed(this.child).catch(() => undefined);
+            throw new BrowserError('PROCESS_FAILED', 'Recording produced no page frames.');
+        }
+        this.child.stdin.end();
+        let forced = false;
+        try {
+            await deadline(onceClosed(this.child), 10_000, 'encoder flush');
+        }
+        catch {
+            forced = true;
+            this.child.kill('SIGKILL');
+            await onceClosed(this.child).catch(() => undefined);
+        }
+        return {
+            frames: stats.encoded,
+            framesReceived: stats.received,
+            skippedTicks: stats.skippedTicks,
+            videoSeconds: stats.encoded / this.fps,
+            wallSeconds,
+            forced,
+            ...(forced ? { warning: 'Encoder exceeded its flush deadline and was terminated; the partial WebM may still be playable.' } : {}),
+        };
+    }
+    force() {
+        this.sampler?.stop();
+        this.child?.kill('SIGKILL');
+    }
+}
+function encoderArgs(file, fps) {
+    return [
+        '-y', '-f', 'image2pipe', '-framerate', String(fps), '-c:v', 'png', '-i', 'pipe:0',
+        '-filter_complex', '[0:v]format=rgba,split[fg1][fg2];[fg1]drawbox=color=white:t=fill[bg];[bg][fg2]overlay=format=auto,pad=ceil(iw/2)*2:ceil(ih/2)*2,format=yuv420p',
+        '-c:v', 'libvpx-vp9', '-deadline', 'realtime', '-cpu-used', '8', '-lag-in-frames', '0',
+        '-auto-alt-ref', '0', '-cluster_time_limit', '1000', '-cluster_size_limit', '2097152', '-f', 'webm', file,
+    ];
+}
+function onceClosed(child) {
+    if (child.exitCode !== null || child.signalCode !== null)
+        return Promise.resolve();
+    return new Promise((resolve) => child.once('close', () => resolve()));
+}
+//# sourceMappingURL=encoder.js.map

package/dist/src/recording/encoder.js.map

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

package/dist/src/recording/sampler.d.ts

@@ -0,0 +1,18 @@
+export interface SamplerStats {
+    received: number;
+    encoded: number;
+    skippedTicks: number;
+}
+export declare class LatestFrameSampler {
+    readonly fps: number;
+    readonly write: (frame: Buffer, onDrain: () => void) => boolean;
+    readonly stats: SamplerStats;
+    private latest?;
+    private blocked;
+    private timer;
+    constructor(fps: number, write: (frame: Buffer, onDrain: () => void) => boolean);
+    push(frame: Buffer): void;
+    tick(): boolean;
+    start(): void;
+    stop(): void;
+}

package/dist/src/recording/sampler.js

@@ -0,0 +1,33 @@
+export class LatestFrameSampler {
+    fps;
+    write;
+    stats = { received: 0, encoded: 0, skippedTicks: 0 };
+    latest;
+    blocked = false;
+    timer;
+    constructor(fps, write) {
+        this.fps = fps;
+        this.write = write;
+    }
+    push(frame) { this.stats.received += 1; this.latest = frame; }
+    tick() {
+        if (!this.latest)
+            return false;
+        if (this.blocked) {
+            this.stats.skippedTicks += 1;
+            return false;
+        }
+        const ready = this.write(this.latest, () => { this.blocked = false; });
+        this.stats.encoded += 1;
+        this.blocked = !ready;
+        return true;
+    }
+    start() {
+        if (this.timer)
+            return;
+        this.timer = setInterval(() => this.tick(), 1_000 / this.fps);
+    }
+    stop() { if (this.timer)
+        clearInterval(this.timer); this.timer = undefined; }
+}
+//# sourceMappingURL=sampler.js.map

package/dist/src/recording/sampler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sampler.js","sourceRoot":"","sources":["../../../src/recording/sampler.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,kBAAkB;IAOlB;IACA;IAPF,KAAK,GAAiB,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;IACpE,MAAM,CAAU;IAChB,OAAO,GAAG,KAAK,CAAC;IAChB,KAAK,CAA6B;IAE1C,YACW,GAAW,EACX,KAAsD;QADtD,QAAG,GAAH,GAAG,CAAQ;QACX,UAAK,GAAL,KAAK,CAAiD;IAC9D,CAAC;IAEJ,IAAI,CAAC,KAAa,IAAU,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC;IAE5E,IAAI;QACF,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAC/B,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAAC,IAAI,CAAC,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC;YAAC,OAAO,KAAK,CAAC;QAAC,CAAC;QACjE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACvE,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO;QACvB,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IAChE,CAAC;IAED,IAAI,KAAW,IAAI,IAAI,CAAC,KAAK;QAAE,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC;CACpF"}

package/dist/src/recording/service.d.ts

@@ -0,0 +1,27 @@
+import type { BrowserArtifactStore, BrowserRegistry, ProcessLauncher } from '../ports.js';
+import type { BrowserService } from '../service.js';
+import type { BrowserRecording, BrowserRuntimeContext } from '../types.js';
+export declare class BrowserRecordingService {
+    readonly browser: BrowserService;
+    readonly registry: BrowserRegistry;
+    readonly artifacts: BrowserArtifactStore;
+    readonly launcher: ProcessLauncher;
+    readonly binary: string;
+    readonly now: () => Date;
+    private readonly active;
+    constructor(browser: BrowserService, registry: BrowserRegistry, artifacts: BrowserArtifactStore, launcher: ProcessLauncher, binary?: string, now?: () => Date);
+    list(): BrowserRecording[];
+    activeRecordings(): BrowserRecording[];
+    get(id: string): BrowserRecording;
+    start(input: {
+        sessionId: string;
+        name?: string;
+        fps?: number;
+        context?: BrowserRuntimeContext;
+    }): Promise<BrowserRecording>;
+    stop(sessionId: string): Promise<BrowserRecording>;
+    forceStop(sessionId: string): Promise<void>;
+    isActive(sessionId: string): boolean;
+    private recoverOrphans;
+    private verifyEncoder;
+}

package/dist/src/recording/service.js

@@ -0,0 +1,180 @@
+import fs from 'node:fs';
+import { BrowserError } from '../errors.js';
+import { newId, safeId } from '../ids.js';
+import { ffmpegBinary } from '../drivers/headless/executable.js';
+import { WebmEncoder } from './encoder.js';
+import { deadline } from '../drivers/cdp/client.js';
+import { waitForRecordingFrame } from './source.js';
+import { pidIsRunning } from '../runtime-selector.js';
+export class BrowserRecordingService {
+    browser;
+    registry;
+    artifacts;
+    launcher;
+    binary;
+    now;
+    active = new Map();
+    constructor(browser, registry, artifacts, launcher, binary = ffmpegBinary(), now = () => new Date()) {
+        this.browser = browser;
+        this.registry = registry;
+        this.artifacts = artifacts;
+        this.launcher = launcher;
+        this.binary = binary;
+        this.now = now;
+        this.recoverOrphans();
+    }
+    list() { return this.registry.snapshot().recordings; }
+    activeRecordings() { return this.list().filter((recording) => recording.status === 'active'); }
+    get(id) {
+        const recording = this.list().find((value) => value.id === safeId(id));
+        if (!recording)
+            throw new BrowserError('NOT_FOUND', `Browser recording ${id} does not exist.`);
+        return recording;
+    }
+    async start(input) {
+        if (this.active.has(input.sessionId) || this.activeRecordings().some((value) => value.sessionId === input.sessionId)) {
+            throw new BrowserError('CONFLICT', `Session ${input.sessionId} already has an active recording.`);
+        }
+        const context = input.context || {};
+        const session = this.browser.getSession(input.sessionId);
+        if (!session.capabilities.includes('recording')) {
+            throw new BrowserError('CAPABILITY_UNSUPPORTED', `${session.backend} cannot record page imagery.`);
+        }
+        const driver = this.browser.options.drivers[session.backend];
+        if (!driver.startScreencast)
+            throw new BrowserError('CAPABILITY_UNSUPPORTED', `${session.backend} cannot record page imagery.`);
+        await this.verifyEncoder(context.signal);
+        const fps = Math.min(Math.max(Math.round(input.fps || 15), 1), 30);
+        const file = await this.artifacts.resolve({
+            kind: 'recording',
+            name: input.name || input.sessionId,
+            extension: 'webm',
+            context,
+        });
+        let pending;
+        let acceptFirst;
+        const firstFrame = new Promise((resolve) => { acceptFirst = resolve; });
+        let encoder;
+        const stopSource = await driver.startScreencast({ session, context }, (frame) => {
+            pending = frame;
+            acceptFirst?.(frame);
+            acceptFirst = undefined;
+            encoder?.frame(frame);
+        });
+        try {
+            await waitForRecordingFrame(firstFrame, context.signal);
+        }
+        catch (error) {
+            await deadline(stopSource(), 2_000, 'recording source stop').catch(() => undefined);
+            throw error;
+        }
+        encoder = new WebmEncoder(this.binary, file, fps);
+        try {
+            await encoder.start();
+        }
+        catch (error) {
+            await stopSource();
+            throw error;
+        }
+        if (pending)
+            encoder.frame(pending);
+        const recording = {
+            id: safeId(newId('recording')),
+            sessionId: session.id,
+            ownerPid: process.pid,
+            status: 'active',
+            fps,
+            createdAt: this.now().toISOString(),
+        };
+        this.registry.putRecording(recording);
+        this.active.set(session.id, { recording, file, encoder, stopSource, context });
+        await this.browser.publish({ type: 'recording.started', sessionId: session.id, profileId: session.profileId, recordingId: recording.id });
+        return recording;
+    }
+    async stop(sessionId) {
+        const current = this.active.get(sessionId);
+        if (!current) {
+            const persisted = this.activeRecordings().find((value) => value.sessionId === sessionId);
+            if (persisted)
+                throw new BrowserError('CONFLICT', `Recording ${persisted.id} belongs to another Browser process.`);
+            throw new BrowserError('NOT_FOUND', `Session ${sessionId} has no active recording.`);
+        }
+        this.active.delete(sessionId);
+        await deadline(current.stopSource(), 2_000, 'recording source stop').catch(() => undefined);
+        try {
+            const result = await current.encoder.stop();
+            const artifact = await this.artifacts.inspect(current.file, 'recording', 'video/webm');
+            const stopped = {
+                ...current.recording,
+                status: 'stopped',
+                stoppedAt: this.now().toISOString(),
+                frames: result.frames,
+                framesReceived: result.framesReceived,
+                skippedTicks: result.skippedTicks,
+                videoSeconds: result.videoSeconds,
+                wallSeconds: result.wallSeconds,
+                artifact,
+                ...(result.warning ? { warning: result.warning } : {}),
+            };
+            this.registry.putRecording(stopped);
+            await this.browser.publish({
+                type: 'recording.stopped', sessionId, profileId: this.browser.getSession(sessionId).profileId,
+                recordingId: stopped.id,
+            });
+            return stopped;
+        }
+        catch (error) {
+            await fs.promises.rm(current.file, { force: true });
+            const failed = { ...current.recording, status: 'failed', stoppedAt: this.now().toISOString(), warning: error.message };
+            this.registry.putRecording(failed);
+            throw error;
+        }
+    }
+    async forceStop(sessionId) {
+        const current = this.active.get(sessionId);
+        if (!current) {
+            const persisted = this.activeRecordings().find((value) => value.sessionId === sessionId);
+            if (persisted)
+                throw new BrowserError('CONFLICT', `Recording ${persisted.id} belongs to another Browser process.`);
+            return;
+        }
+        this.active.delete(sessionId);
+        current.encoder.force();
+        await deadline(current.stopSource(), 2_000, 'recording source stop').catch(() => undefined);
+        await fs.promises.rm(current.file, { force: true });
+        this.registry.putRecording({
+            ...current.recording,
+            status: 'failed',
+            stoppedAt: this.now().toISOString(),
+            warning: 'Recording was force-stopped.',
+        });
+    }
+    isActive(sessionId) {
+        return this.active.has(sessionId) || this.activeRecordings().some((value) => value.sessionId === sessionId);
+    }
+    recoverOrphans() {
+        for (const recording of this.activeRecordings()) {
+            if (recording.ownerPid && pidIsRunning(recording.ownerPid))
+                continue;
+            this.registry.putRecording({
+                ...recording,
+                status: 'failed',
+                stoppedAt: this.now().toISOString(),
+                warning: 'Recording owner process ended before the recording stopped.',
+            });
+        }
+    }
+    async verifyEncoder(signal) {
+        const result = await this.launcher.run({
+            command: this.binary,
+            args: ['-version'],
+            cwd: process.cwd(),
+            ...(signal ? { signal } : {}),
+            timeoutMs: 5_000,
+            outputLimit: 4_000,
+        }).catch((error) => { throw new BrowserError('PROCESS_FAILED', `ffmpeg is unavailable: ${error.message}`); });
+        if (result.code !== 0)
+            throw new BrowserError('PROCESS_FAILED', 'ffmpeg is unavailable.');
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/src/recording/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../../src/recording/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAIzB,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAUtD,MAAM,OAAO,uBAAuB;IAIvB;IACA;IACA;IACA;IACA;IACA;IARM,MAAM,GAAG,IAAI,GAAG,EAA2B,CAAC;IAE7D,YACW,OAAuB,EACvB,QAAyB,EACzB,SAA+B,EAC/B,QAAyB,EACzB,SAAS,YAAY,EAAE,EACvB,MAAkB,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE;QALlC,YAAO,GAAP,OAAO,CAAgB;QACvB,aAAQ,GAAR,QAAQ,CAAiB;QACzB,cAAS,GAAT,SAAS,CAAsB;QAC/B,aAAQ,GAAR,QAAQ,CAAiB;QACzB,WAAM,GAAN,MAAM,CAAiB;QACvB,QAAG,GAAH,GAAG,CAA+B;QACzC,IAAI,CAAC,cAAc,EAAE,CAAC;IAAC,CAAC;IAE5B,IAAI,KAAyB,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IAC1E,gBAAgB,KAAyB,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC;IACnH,GAAG,CAAC,EAAU;QACZ,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACvE,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,YAAY,CAAC,WAAW,EAAE,qBAAqB,EAAE,kBAAkB,CAAC,CAAC;QAC/F,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAKX;QACC,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;YACrH,MAAM,IAAI,YAAY,CAAC,UAAU,EAAE,WAAW,KAAK,CAAC,SAAS,mCAAmC,CAAC,CAAC;QACpG,CAAC;QACD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACzD,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,YAAY,CAAC,wBAAwB,EAAE,GAAG,OAAO,CAAC,OAAO,8BAA8B,CAAC,CAAC;QACrG,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC7D,IAAI,CAAC,MAAM,CAAC,eAAe;YAAE,MAAM,IAAI,YAAY,CAAC,wBAAwB,EAAE,GAAG,OAAO,CAAC,OAAO,8BAA8B,CAAC,CAAC;QAChI,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACnE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YACxC,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,SAAS;YACnC,SAAS,EAAE,MAAM;YACjB,OAAO;SACR,CAAC,CAAC;QACH,IAAI,OAA2B,CAAC;QAChC,IAAI,WAAkD,CAAC;QACvD,MAAM,UAAU,GAAG,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE,GAAG,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAChF,IAAI,OAAgC,CAAC;QACrC,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE;YAC9E,OAAO,GAAG,KAAK,CAAC;YAChB,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC;YACrB,WAAW,GAAG,SAAS,CAAC;YACxB,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC,CAAC,CAAC;QACH,IAAI,CAAC;YAAC,MAAM,qBAAqB,CAAC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAAC,CAAC;QAChE,OAAO,KAAK,EAAE,CAAC;YAAC,MAAM,QAAQ,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,uBAAuB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAAC,MAAM,KAAK,CAAC;QAAC,CAAC;QACnH,OAAO,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;QAClD,IAAI,CAAC;YAAC,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QAAC,CAAC;QAC9B,OAAO,KAAK,EAAE,CAAC;YAAC,MAAM,UAAU,EAAE,CAAC;YAAC,MAAM,KAAK,CAAC;QAAC,CAAC;QAClD,IAAI,OAAO;YAAE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACpC,MAAM,SAAS,GAAqB;YAClC,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAC9B,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,QAAQ,EAAE,OAAO,CAAC,GAAG;YACrB,MAAM,EAAE,QAAQ;YAChB,GAAG;YACH,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/E,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1I,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAAiB;QAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC;YACzF,IAAI,SAAS;gBAAE,MAAM,IAAI,YAAY,CAAC,UAAU,EAAE,aAAa,SAAS,CAAC,EAAE,sCAAsC,CAAC,CAAC;YACnH,MAAM,IAAI,YAAY,CAAC,WAAW,EAAE,WAAW,SAAS,2BAA2B,CAAC,CAAC;QACvF,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC9B,MAAM,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,uBAAuB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC5F,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAC5C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;YACvF,MAAM,OAAO,GAAqB;gBAChC,GAAG,OAAO,CAAC,SAAS;gBACpB,MAAM,EAAE,SAAS;gBACjB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;gBACnC,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,cAAc,EAAE,MAAM,CAAC,cAAc;gBACrC,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,QAAQ;gBACR,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACvD,CAAC;YACF,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;YACpC,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;gBACzB,IAAI,EAAE,mBAAmB,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,SAAS;gBAC7F,WAAW,EAAE,OAAO,CAAC,EAAE;aACxB,CAAC,CAAC;YACH,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACpD,MAAM,MAAM,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,QAAiB,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,EAAE,OAAO,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC;YAC3I,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YACnC,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,SAAiB;QAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC;YACzF,IAAI,SAAS;gBAAE,MAAM,IAAI,YAAY,CAAC,UAAU,EAAE,aAAa,SAAS,CAAC,EAAE,sCAAsC,CAAC,CAAC;YACnH,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC9B,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACxB,MAAM,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,uBAAuB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC5F,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;YACzB,GAAG,OAAO,CAAC,SAAS;YACpB,MAAM,EAAE,QAAQ;YAChB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;YACnC,OAAO,EAAE,8BAA8B;SACxC,CAAC,CAAC;IACL,CAAC;IAED,QAAQ,CAAC,SAAiB;QACxB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC;IAC9G,CAAC;IAEO,cAAc;QACpB,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,gBAAgB,EAAE,EAAE,CAAC;YAChD,IAAI,SAAS,CAAC,QAAQ,IAAI,YAAY,CAAC,SAAS,CAAC,QAAQ,CAAC;gBAAE,SAAS;YACrE,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;gBACzB,GAAG,SAAS;gBACZ,MAAM,EAAE,QAAQ;gBAChB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;gBACnC,OAAO,EAAE,6DAA6D;aACvE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,MAAoB;QAC9C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YACrC,OAAO,EAAE,IAAI,CAAC,MAAM;YACpB,IAAI,EAAE,CAAC,UAAU,CAAC;YAClB,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;YAClB,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7B,SAAS,EAAE,KAAK;YAChB,WAAW,EAAE,KAAK;SACnB,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,GAAG,MAAM,IAAI,YAAY,CAAC,gBAAgB,EAAE,0BAA2B,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzH,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC;YAAE,MAAM,IAAI,YAAY,CAAC,gBAAgB,EAAE,wBAAwB,CAAC,CAAC;IAC5F,CAAC;CACF"}

package/dist/src/recording/source.d.ts

@@ -0,0 +1 @@
+export declare function waitForRecordingFrame(frame: Promise<Buffer>, signal?: AbortSignal, timeoutMs?: number): Promise<Buffer>;

package/dist/src/recording/source.js

@@ -0,0 +1,21 @@
+import { BrowserError } from '../errors.js';
+import { deadline } from '../drivers/cdp/client.js';
+export async function waitForRecordingFrame(frame, signal, timeoutMs = 5_000) {
+    if (!signal)
+        return deadline(frame, timeoutMs, 'first page recording frame');
+    if (signal.aborted)
+        throw new BrowserError('ABORTED', 'Recording capture was cancelled.');
+    let abort;
+    const cancelled = new Promise((_resolve, reject) => {
+        abort = () => reject(new BrowserError('ABORTED', 'Recording capture was cancelled.'));
+        signal.addEventListener('abort', abort, { once: true });
+    });
+    try {
+        return await deadline(Promise.race([frame, cancelled]), timeoutMs, 'first page recording frame');
+    }
+    finally {
+        if (abort)
+            signal.removeEventListener('abort', abort);
+    }
+}
+//# sourceMappingURL=source.js.map

package/dist/src/recording/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../../src/recording/source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAAsB,EACtB,MAAoB,EACpB,SAAS,GAAG,KAAK;IAEjB,IAAI,CAAC,MAAM;QAAE,OAAO,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,4BAA4B,CAAC,CAAC;IAC7E,IAAI,MAAM,CAAC,OAAO;QAAE,MAAM,IAAI,YAAY,CAAC,SAAS,EAAE,kCAAkC,CAAC,CAAC;IAC1F,IAAI,KAA+B,CAAC;IACpC,MAAM,SAAS,GAAG,IAAI,OAAO,CAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;QACxD,KAAK,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC,SAAS,EAAE,kCAAkC,CAAC,CAAC,CAAC;QACtF,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IACH,IAAI,CAAC;QAAC,OAAO,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,EAAE,SAAS,EAAE,4BAA4B,CAAC,CAAC;IAAC,CAAC;YACjG,CAAC;QAAC,IAAI,KAAK;YAAE,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAAC,CAAC;AACpE,CAAC"}

package/dist/src/recording.d.ts

@@ -0,0 +1,3 @@
+export { BrowserRecordingService } from './recording/service.js';
+export { WebmEncoder, type EncoderResult } from './recording/encoder.js';
+export { LatestFrameSampler, type SamplerStats } from './recording/sampler.js';

package/dist/src/recording.js

@@ -0,0 +1,4 @@
+export { BrowserRecordingService } from './recording/service.js';
+export { WebmEncoder } from './recording/encoder.js';
+export { LatestFrameSampler } from './recording/sampler.js';
+//# sourceMappingURL=recording.js.map

package/dist/src/recording.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording.js","sourceRoot":"","sources":["../../src/recording.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,WAAW,EAAsB,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAqB,MAAM,wBAAwB,CAAC"}

package/dist/src/registry.d.ts

@@ -0,0 +1,15 @@
+import type { BrowserAuthBundle, BrowserLoginSession, BrowserProfile, BrowserRecording, BrowserSession } from './types.js';
+import type { BrowserRegistry, BrowserRegistrySnapshot } from './ports.js';
+export declare class MemoryBrowserRegistry implements BrowserRegistry {
+    protected data: BrowserRegistrySnapshot;
+    constructor(initial?: BrowserRegistrySnapshot);
+    snapshot(): BrowserRegistrySnapshot;
+    putProfile(value: BrowserProfile): void;
+    deleteProfile(id: string): void;
+    putSession(value: BrowserSession): void;
+    deleteSession(id: string): void;
+    putRecording(value: BrowserRecording): void;
+    putAuthBundle(value: BrowserAuthBundle): void;
+    deleteAuthBundle(id: string): void;
+    putLoginSession(value: BrowserLoginSession): void;
+}

package/dist/src/registry.js

@@ -0,0 +1,46 @@
+function emptySnapshot() {
+    return {
+        schemaVersion: 1,
+        profiles: [],
+        sessions: [],
+        recordings: [],
+        authBundles: [],
+        loginSessions: [],
+    };
+}
+function replaceById(items, value) {
+    return [...items.filter((item) => item.id !== value.id), value]
+        .sort((left, right) => left.id.localeCompare(right.id));
+}
+export class MemoryBrowserRegistry {
+    data;
+    constructor(initial = emptySnapshot()) {
+        this.data = structuredClone(initial);
+    }
+    snapshot() { return structuredClone(this.data); }
+    putProfile(value) {
+        this.data.profiles = replaceById(this.data.profiles, value);
+    }
+    deleteProfile(id) {
+        this.data.profiles = this.data.profiles.filter((value) => value.id !== id);
+    }
+    putSession(value) {
+        this.data.sessions = replaceById(this.data.sessions, value);
+    }
+    deleteSession(id) {
+        this.data.sessions = this.data.sessions.filter((value) => value.id !== id);
+    }
+    putRecording(value) {
+        this.data.recordings = replaceById(this.data.recordings, value);
+    }
+    putAuthBundle(value) {
+        this.data.authBundles = replaceById(this.data.authBundles, value);
+    }
+    deleteAuthBundle(id) {
+        this.data.authBundles = this.data.authBundles.filter((value) => value.id !== id);
+    }
+    putLoginSession(value) {
+        this.data.loginSessions = replaceById(this.data.loginSessions, value);
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/src/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/registry.ts"],"names":[],"mappings":"AASA,SAAS,aAAa;IACpB,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,EAAE;QACd,WAAW,EAAE,EAAE;QACf,aAAa,EAAE,EAAE;KAClB,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAA2B,KAAU,EAAE,KAAQ;IACjE,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC;SAC5D,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,OAAO,qBAAqB;IACtB,IAAI,CAA0B;IAExC,YAAY,UAAmC,aAAa,EAAE;QAC5D,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,QAAQ,KAA8B,OAAO,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAE1E,UAAU,CAAC,KAAqB;QAC9B,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC9D,CAAC;IACD,aAAa,CAAC,EAAU;QACtB,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,UAAU,CAAC,KAAqB;QAC9B,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC9D,CAAC;IACD,aAAa,CAAC,EAAU;QACtB,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,YAAY,CAAC,KAAuB;QAClC,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAClE,CAAC;IACD,aAAa,CAAC,KAAwB;QACpC,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IACpE,CAAC;IACD,gBAAgB,CAAC,EAAU;QACzB,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACnF,CAAC;IACD,eAAe,CAAC,KAA0B;QACxC,IAAI,CAAC,IAAI,CAAC,aAAa,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IACxE,CAAC;CACF"}

package/dist/src/runtime-selector.d.ts

@@ -0,0 +1,12 @@
+import type { BrowserRuntimeSelector } from './ports.js';
+import type { BrowserBackendKind, BrowserHostAdvertisement, BrowserRuntimeContext } from './types.js';
+export declare const ELECTRON_SURFACE_PROTOCOLS: readonly [5, 6];
+export declare function pidIsRunning(pid: number): boolean;
+export declare function bridgeFileCandidates(env?: NodeJS.ProcessEnv): string[];
+export declare function readHostAdvertisement(files?: string[]): BrowserHostAdvertisement | null;
+export declare class DefaultRuntimeSelector implements BrowserRuntimeSelector {
+    readonly advertisement: () => BrowserHostAdvertisement | null;
+    readonly env: NodeJS.ProcessEnv;
+    constructor(advertisement?: () => BrowserHostAdvertisement | null, env?: NodeJS.ProcessEnv);
+    select(context: BrowserRuntimeContext): BrowserBackendKind;
+}