camou 0.1.0

package/dist/camoufox/installer.js

@@ -0,0 +1,291 @@
+import { createWriteStream } from 'node:fs';
+import { chmod, cp, mkdtemp, readdir, rename, rm, stat, writeFile } from 'node:fs/promises';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { Writable } from 'node:stream';
+import extract from 'extract-zip';
+import { buildDoctorHints, buildDoctorVersionChecks, inspectBrowserBundle, inspectSharedLibraries } from '../doctor/diagnostics.js';
+import { ensureDir } from '../state/store.js';
+import { InstallError } from '../util/errors.js';
+import { buildExpectedAssetName, getPlatformTarget, normalizeReleaseVersion } from '../util/platform.js';
+import { probeCamoufoxLaunch } from './launcher.js';
+import { listInstalledBrowsers, removeInstalledBrowser, resolveInstalledBrowser, setInstalledBrowser } from './registry.js';
+const DEFAULT_RELEASE_REPOS = ['daijro/camoufox', 'camoufox/camoufox'];
+const require = createRequire(import.meta.url);
+async function fetchJson(url) {
+    const headers = {
+        'user-agent': 'camou',
+        accept: 'application/vnd.github+json',
+    };
+    if (process.env.GITHUB_TOKEN) {
+        headers.authorization = `Bearer ${process.env.GITHUB_TOKEN}`;
+    }
+    const response = await fetch(url, { headers });
+    if (!response.ok) {
+        throw new InstallError(`GitHub request failed with ${response.status} for ${url}.`);
+    }
+    return response.json();
+}
+export async function resolveRelease(version) {
+    const target = getPlatformTarget();
+    const normalizedVersion = version ? normalizeReleaseVersion(version) : undefined;
+    const expectedAssetName = normalizedVersion
+        ? buildExpectedAssetName(normalizedVersion, target)
+        : undefined;
+    for (const repo of DEFAULT_RELEASE_REPOS) {
+        const apiUrl = version
+            ? `https://api.github.com/repos/${repo}/releases`
+            : `https://api.github.com/repos/${repo}/releases/latest`;
+        const payload = await fetchJson(apiUrl);
+        const releases = Array.isArray(payload) ? payload : [payload];
+        for (const release of releases) {
+            const releaseVersion = normalizeReleaseVersion(release.tag_name);
+            if (normalizedVersion && releaseVersion !== normalizedVersion) {
+                continue;
+            }
+            const assetName = expectedAssetName ?? buildExpectedAssetName(releaseVersion, target);
+            const asset = release.assets.find((candidate) => candidate.name === assetName);
+            if (!asset) {
+                continue;
+            }
+            return {
+                repo,
+                tag: release.tag_name,
+                version: releaseVersion,
+                assetName: asset.name,
+                assetUrl: asset.browser_download_url,
+                prerelease: release.prerelease ?? false,
+            };
+        }
+    }
+    throw new InstallError(version
+        ? `Unable to find Camoufox release ${version} for this platform.`
+        : 'Unable to find a compatible Camoufox release for this platform.');
+}
+function splitReleaseVersion(version) {
+    const separatorIndex = version.lastIndexOf('-');
+    if (separatorIndex <= 0 || separatorIndex === version.length - 1) {
+        throw new InstallError(`Unable to split Camoufox release version: ${version}`);
+    }
+    return {
+        version: version.slice(0, separatorIndex),
+        build: version.slice(separatorIndex + 1),
+    };
+}
+async function writeVersionMetadata(rootDir, release) {
+    const parsed = splitReleaseVersion(release.version);
+    await writeFile(path.join(rootDir, 'version.json'), `${JSON.stringify({
+        version: parsed.version,
+        build: parsed.build,
+        prerelease: release.prerelease,
+    }, null, 2)}\n`, 'utf8');
+}
+async function downloadAsset(url, targetFile, logger) {
+    const headers = { 'user-agent': 'camou' };
+    if (process.env.GITHUB_TOKEN) {
+        headers.authorization = `Bearer ${process.env.GITHUB_TOKEN}`;
+    }
+    const response = await fetch(url, { headers });
+    if (!response.ok || !response.body) {
+        throw new InstallError(`Failed to download ${url}.`, { status: response.status });
+    }
+    logger?.info('Downloading Camoufox release', { url });
+    const stream = createWriteStream(targetFile);
+    await response.body.pipeTo(Writable.toWeb(stream));
+}
+async function findExecutablePath(rootDir, expectedRelativePath) {
+    const directPath = path.join(rootDir, expectedRelativePath);
+    try {
+        await stat(directPath);
+        return directPath;
+    }
+    catch {
+        // Continue into recursive search.
+    }
+    const queue = [rootDir];
+    while (queue.length > 0) {
+        const current = queue.shift();
+        if (!current) {
+            continue;
+        }
+        const entries = await readdir(current, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(current, entry.name);
+            if (entry.isDirectory()) {
+                queue.push(fullPath);
+                continue;
+            }
+            if (path.basename(expectedRelativePath) === entry.name) {
+                return fullPath;
+            }
+        }
+    }
+    throw new InstallError(`Unable to find extracted Camoufox executable inside ${rootDir}.`);
+}
+async function makeExecutable(filePath) {
+    if (process.platform !== 'win32') {
+        await chmod(filePath, 0o755);
+    }
+}
+async function moveDirectory(sourceDir, targetDir) {
+    try {
+        await rename(sourceDir, targetDir);
+    }
+    catch (error) {
+        if (!(error instanceof Error) || !('code' in error) || error.code !== 'EXDEV') {
+            throw error;
+        }
+        await cp(sourceDir, targetDir, { recursive: true });
+        await rm(sourceDir, { recursive: true, force: true });
+    }
+}
+export async function installCamoufox(paths, options) {
+    const target = getPlatformTarget();
+    const logger = options?.logger;
+    const release = await resolveRelease(options?.version);
+    const existing = await resolveInstalledBrowser(paths, release.version);
+    if (existing && !options?.force) {
+        logger?.info('Camoufox version already installed', { version: release.version });
+        return release;
+    }
+    await ensureDir(path.join(paths.browsersDir, 'official'));
+    const tempRoot = await mkdtemp(path.join(paths.camoufoxCacheDir, 'install-'));
+    const archivePath = path.join(tempRoot, release.assetName);
+    const extractDir = path.join(tempRoot, 'extract');
+    const finalDir = path.join(paths.browsersDir, 'official', release.version);
+    try {
+        await downloadAsset(release.assetUrl, archivePath, logger);
+        await ensureDir(extractDir);
+        logger?.info('Extracting Camoufox release', { archivePath });
+        await extract(archivePath, { dir: extractDir });
+        const executablePath = await findExecutablePath(extractDir, target.executableRelativePath);
+        if (options?.force) {
+            await rm(finalDir, { recursive: true, force: true });
+        }
+        await moveDirectory(extractDir, finalDir);
+        await writeVersionMetadata(finalDir, release);
+        const finalExecutablePath = path.join(finalDir, path.relative(extractDir, executablePath));
+        await makeExecutable(finalExecutablePath);
+        await setInstalledBrowser(paths, {
+            version: release.version,
+            tag: release.tag,
+            sourceRepo: release.repo,
+            assetName: release.assetName,
+            assetUrl: release.assetUrl,
+            rootDir: finalDir,
+            executablePath: finalExecutablePath,
+            installedAt: new Date().toISOString(),
+            platform: target.os,
+            arch: target.arch,
+        }, true);
+        logger?.info('Installed Camoufox release', { version: release.version, executablePath: finalExecutablePath });
+        return release;
+    }
+    catch (error) {
+        throw error instanceof InstallError
+            ? error
+            : new InstallError('Failed to install Camoufox.', undefined, error);
+    }
+    finally {
+        await rm(tempRoot, { recursive: true, force: true });
+    }
+}
+export async function removeCamoufox(paths, version, logger) {
+    const existing = await resolveInstalledBrowser(paths, version);
+    if (!existing) {
+        throw new InstallError(`Camoufox version ${version} is not installed.`);
+    }
+    await rm(existing.rootDir, { recursive: true, force: true });
+    await removeInstalledBrowser(paths, version);
+    logger?.info('Removed Camoufox release', { version });
+}
+function getPlaywrightCoreVersion() {
+    try {
+        const playwrightPackage = require('playwright-core/package.json');
+        return playwrightPackage.version;
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function inspectCamoufoxInstall(paths, version, logger) {
+    try {
+        return {
+            playwrightCoreVersion: getPlaywrightCoreVersion(),
+            launchCheck: await probeCamoufoxLaunch(paths, version, logger),
+        };
+    }
+    catch (error) {
+        return {
+            playwrightCoreVersion: getPlaywrightCoreVersion(),
+            launchCheck: {
+                attempted: false,
+                success: false,
+                version,
+                error: {
+                    message: error instanceof Error ? error.message : String(error),
+                },
+            },
+        };
+    }
+}
+export async function doctorCamoufox(paths, logger) {
+    const installedBrowsers = await listInstalledBrowsers(paths);
+    const platform = getPlatformTarget();
+    const inspections = new Map();
+    for (const install of installedBrowsers.installs) {
+        inspections.set(install.version, await inspectCamoufoxInstall(paths, install.version, logger));
+    }
+    const currentBrowser = installedBrowsers.currentVersion
+        ? installedBrowsers.installs.find((install) => install.version === installedBrowsers.currentVersion)
+        : undefined;
+    const currentInspection = currentBrowser
+        ? inspections.get(currentBrowser.version)
+        : {
+            playwrightCoreVersion: getPlaywrightCoreVersion(),
+            launchCheck: {
+                attempted: false,
+                success: false,
+                error: {
+                    message: 'No active Camoufox version selected.',
+                },
+            },
+        };
+    const bundleCheck = await inspectBrowserBundle(currentBrowser, platform);
+    const sharedLibraryCheck = await inspectSharedLibraries(currentBrowser, platform);
+    const installedVersions = buildDoctorVersionChecks({
+        installedVersions: installedBrowsers.installs,
+        currentVersion: installedBrowsers.currentVersion,
+        probes: new Map(Array.from(inspections.entries()).map(([version, inspection]) => [version, inspection.launchCheck])),
+    });
+    const hints = buildDoctorHints({
+        platform,
+        installed: installedBrowsers.installs.length > 0,
+        currentVersion: currentBrowser?.version,
+        launchCheck: currentInspection?.launchCheck,
+        bundleCheck,
+        sharedLibraryCheck,
+    });
+    return {
+        platform,
+        playwrightCoreVersion: currentInspection?.playwrightCoreVersion,
+        camoufoxCacheDir: paths.camoufoxCacheDir,
+        installed: installedBrowsers.installs.length > 0,
+        healthy: installedBrowsers.installs.length > 0 &&
+            Boolean(currentInspection?.launchCheck.success) &&
+            bundleCheck.missingRequiredFiles.length === 0 &&
+            sharedLibraryCheck.missingLibraries.length === 0,
+        currentVersion: currentBrowser?.version,
+        executablePath: currentBrowser?.executablePath,
+        installedVersions,
+        launchCheck: currentInspection?.launchCheck,
+        bundleCheck,
+        sharedLibraryCheck,
+        hints,
+        runtimeDir: paths.runtimeDir,
+        socketPath: paths.daemonSocketPath,
+        host: paths.daemonHost,
+        port: paths.daemonPort,
+    };
+}
+//# sourceMappingURL=installer.js.map

package/dist/camoufox/installer.js.map

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

package/dist/camoufox/launcher.d.ts

@@ -0,0 +1,22 @@
+import { type BrowserContext } from 'playwright-core';
+import type { CamoucliPaths, SessionPaths } from '../state/paths.js';
+import type { Logger } from '../util/log.js';
+import { type LaunchInput, type ResolvedLaunchConfig } from './config.js';
+export interface LaunchedSession {
+    context: BrowserContext;
+    browserVersion: string;
+    installPath: string;
+    sessionPaths: SessionPaths;
+    resolvedConfig: ResolvedLaunchConfig;
+}
+export interface BrowserLaunchProbe {
+    attempted: boolean;
+    success: boolean;
+    version?: string | undefined;
+    executablePath?: string | undefined;
+    error?: {
+        message: string;
+    } | undefined;
+}
+export declare function launchPersistentCamoufox(paths: CamoucliPaths, sessionName: string, input: LaunchInput, logger?: Logger): Promise<LaunchedSession>;
+export declare function probeCamoufoxLaunch(paths: CamoucliPaths, version?: string, logger?: Logger): Promise<BrowserLaunchProbe>;

package/dist/camoufox/launcher.js

@@ -0,0 +1,105 @@
+import { mkdtemp, rm } from 'node:fs/promises';
+import path from 'node:path';
+import { firefox } from 'playwright-core';
+import { ensureSessionPaths } from '../state/paths.js';
+import { SessionError } from '../util/errors.js';
+import { requireInstalledBrowser, resolveInstalledBrowser } from './registry.js';
+import { buildCamouConfigEnv } from './env.js';
+import { resolveLaunchConfig } from './config.js';
+import { validateCamouConfig } from './validation.js';
+function stripAnsi(input) {
+    return input.replace(/\u001B\[[0-9;]*m/g, '');
+}
+function summarizeLaunchError(error) {
+    const message = stripAnsi(error instanceof Error ? error.message : String(error));
+    return (message
+        .split('\n')
+        .map((line) => line.trim())
+        .find(Boolean) ?? 'Unknown launch error.');
+}
+export async function launchPersistentCamoufox(paths, sessionName, input, logger) {
+    const browser = await requireInstalledBrowser(paths, input.browser);
+    const sessionPaths = await ensureSessionPaths(paths, sessionName);
+    const resolvedConfig = await resolveLaunchConfig(input);
+    await validateCamouConfig(resolvedConfig.camouConfig, browser.rootDir);
+    const options = {
+        executablePath: browser.executablePath,
+        headless: resolvedConfig.headless,
+        env: buildCamouConfigEnv(resolvedConfig.camouConfig),
+        firefoxUserPrefs: resolvedConfig.firefoxUserPrefs,
+        downloadsPath: sessionPaths.downloadsDir,
+        ...(resolvedConfig.proxy ? { proxy: resolvedConfig.proxy } : {}),
+        ...(resolvedConfig.locale ? { locale: resolvedConfig.locale } : {}),
+        ...(resolvedConfig.timezoneId ? { timezoneId: resolvedConfig.timezoneId } : {}),
+        ...(resolvedConfig.viewport ? { viewport: resolvedConfig.viewport } : {}),
+    };
+    logger?.info('Launching persistent Camoufox session', {
+        sessionName,
+        executablePath: browser.executablePath,
+        headless: resolvedConfig.headless,
+    });
+    try {
+        const context = await firefox.launchPersistentContext(sessionPaths.profileDir, options);
+        return {
+            context,
+            browserVersion: browser.version,
+            installPath: browser.executablePath,
+            sessionPaths,
+            resolvedConfig,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (/profile|lock|in use|access denied/i.test(message)) {
+            throw new SessionError(`Browser profile for session ${sessionName} appears to be locked by another process. Stop the other browser or use a different session name.`, { sessionName, profileDir: sessionPaths.profileDir }, error);
+        }
+        throw error;
+    }
+}
+export async function probeCamoufoxLaunch(paths, version, logger) {
+    const browser = await resolveInstalledBrowser(paths, version);
+    if (!browser) {
+        return {
+            attempted: false,
+            success: false,
+            error: {
+                message: 'No installed Camoufox browser found.',
+            },
+        };
+    }
+    const profileDir = await mkdtemp(path.join(paths.camoufoxCacheDir, 'doctor-profile-'));
+    try {
+        logger?.info('Running Camoufox launch probe', {
+            version: browser.version,
+            executablePath: browser.executablePath,
+        });
+        const context = await firefox.launchPersistentContext(profileDir, {
+            executablePath: browser.executablePath,
+            headless: true,
+            env: buildCamouConfigEnv({}),
+            firefoxUserPrefs: {},
+        });
+        await context.close();
+        return {
+            attempted: true,
+            success: true,
+            version: browser.version,
+            executablePath: browser.executablePath,
+        };
+    }
+    catch (error) {
+        return {
+            attempted: true,
+            success: false,
+            version: browser.version,
+            executablePath: browser.executablePath,
+            error: {
+                message: summarizeLaunchError(error),
+            },
+        };
+    }
+    finally {
+        await rm(profileDir, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=launcher.js.map

package/dist/camoufox/launcher.js.map

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

package/dist/camoufox/prefs.d.ts

@@ -0,0 +1,5 @@
+import { z } from 'zod';
+export declare const firefoxUserPrefsSchema: z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+export type FirefoxUserPrefs = z.infer<typeof firefoxUserPrefsSchema>;
+export declare function parseFirefoxUserPrefs(input: unknown): FirefoxUserPrefs;
+export declare function mergeFirefoxUserPrefs(...prefs: Array<FirefoxUserPrefs | undefined>): FirefoxUserPrefs;

package/dist/camoufox/prefs.js

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+import { ValidationError } from '../util/errors.js';
+const prefValueSchema = z.union([
+    z.string(),
+    z.number(),
+    z.boolean(),
+]);
+export const firefoxUserPrefsSchema = z.record(z.string(), prefValueSchema);
+export function parseFirefoxUserPrefs(input) {
+    const parsed = firefoxUserPrefsSchema.safeParse(input);
+    if (!parsed.success) {
+        throw new ValidationError('Firefox user prefs must be a JSON object.');
+    }
+    return parsed.data;
+}
+export function mergeFirefoxUserPrefs(...prefs) {
+    return prefs.reduce((accumulator, current) => {
+        if (!current) {
+            return accumulator;
+        }
+        return {
+            ...accumulator,
+            ...current,
+        };
+    }, {});
+}
+//# sourceMappingURL=prefs.js.map

package/dist/camoufox/prefs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefs.js","sourceRoot":"","sources":["../../src/camoufox/prefs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC;IAC9B,CAAC,CAAC,MAAM,EAAE;IACV,CAAC,CAAC,MAAM,EAAE;IACV,CAAC,CAAC,OAAO,EAAE;CACZ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC;AAI5E,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,MAAM,MAAM,GAAG,sBAAsB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACvD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,eAAe,CAAC,2CAA2C,CAAC,CAAC;IACzE,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAAG,KAA0C;IACjF,OAAO,KAAK,CAAC,MAAM,CAAmB,CAAC,WAAW,EAAE,OAAO,EAAE,EAAE;QAC7D,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,OAAO;YACL,GAAG,WAAW;YACd,GAAG,OAAO;SACX,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;AACT,CAAC"}

package/dist/camoufox/presets.d.ts

@@ -0,0 +1,14 @@
+import type { FirefoxUserPrefs } from './prefs.js';
+export interface CamoufoxPresetDefinition {
+    name: string;
+    description: string;
+    camouConfig: Record<string, unknown>;
+    firefoxUserPrefs: FirefoxUserPrefs;
+}
+export interface ResolvedPresetBundle {
+    presetNames: string[];
+    camouConfig: Record<string, unknown>;
+    firefoxUserPrefs: FirefoxUserPrefs;
+}
+export declare function listCamoufoxPresets(): CamoufoxPresetDefinition[];
+export declare function resolveCamoufoxPresets(presetNames: string[] | undefined): ResolvedPresetBundle;

package/dist/camoufox/presets.js

@@ -0,0 +1,73 @@
+import { ValidationError } from '../util/errors.js';
+const CACHE_PREFS = {
+    'browser.cache.disk.smart_size.enabled': true,
+    'browser.cache.disk_cache_ssl': true,
+    'browser.cache.memory.enable': true,
+    'browser.sessionhistory.max_entries': 10,
+    'browser.sessionhistory.max_total_viewers': -1,
+};
+const PRESETS = {
+    default: {
+        name: 'default',
+        description: 'Baseline Camoufox launch with no additional config overrides.',
+        camouConfig: {},
+        firefoxUserPrefs: {},
+    },
+    cache: {
+        name: 'cache',
+        description: 'Enable Firefox cache/session history prefs used by the Python library.',
+        camouConfig: {},
+        firefoxUserPrefs: CACHE_PREFS,
+    },
+    'low-bandwidth': {
+        name: 'low-bandwidth',
+        description: 'Reduce network-heavy assets by blocking images and speculative requests.',
+        camouConfig: {},
+        firefoxUserPrefs: {
+            'network.http.speculative-parallel-limit': 0,
+            'permissions.default.image': 2,
+        },
+    },
+    'disable-coop': {
+        name: 'disable-coop',
+        description: 'Relax Cross-Origin-Opener-Policy isolation for troublesome embedded flows.',
+        camouConfig: {},
+        firefoxUserPrefs: {
+            'browser.tabs.remote.useCrossOriginOpenerPolicy': false,
+        },
+    },
+};
+export function listCamoufoxPresets() {
+    return Object.values(PRESETS);
+}
+export function resolveCamoufoxPresets(presetNames) {
+    if (!presetNames || presetNames.length === 0) {
+        return {
+            presetNames: [],
+            camouConfig: {},
+            firefoxUserPrefs: {},
+        };
+    }
+    const normalizedNames = [...new Set(presetNames.map((presetName) => presetName.trim()).filter(Boolean))];
+    const bundle = {
+        presetNames: normalizedNames,
+        camouConfig: {},
+        firefoxUserPrefs: {},
+    };
+    for (const presetName of normalizedNames) {
+        const preset = PRESETS[presetName];
+        if (!preset) {
+            throw new ValidationError(`Unknown preset: ${presetName}. Available presets: ${listCamoufoxPresets().map((item) => item.name).join(', ')}`);
+        }
+        bundle.camouConfig = {
+            ...bundle.camouConfig,
+            ...preset.camouConfig,
+        };
+        bundle.firefoxUserPrefs = {
+            ...bundle.firefoxUserPrefs,
+            ...preset.firefoxUserPrefs,
+        };
+    }
+    return bundle;
+}
+//# sourceMappingURL=presets.js.map

package/dist/camoufox/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../../src/camoufox/presets.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAepD,MAAM,WAAW,GAAqB;IACpC,uCAAuC,EAAE,IAAI;IAC7C,8BAA8B,EAAE,IAAI;IACpC,6BAA6B,EAAE,IAAI;IACnC,oCAAoC,EAAE,EAAE;IACxC,0CAA0C,EAAE,CAAC,CAAC;CAC/C,CAAC;AAEF,MAAM,OAAO,GAA6C;IACxD,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,+DAA+D;QAC5E,WAAW,EAAE,EAAE;QACf,gBAAgB,EAAE,EAAE;KACrB;IACD,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,wEAAwE;QACrF,WAAW,EAAE,EAAE;QACf,gBAAgB,EAAE,WAAW;KAC9B;IACD,eAAe,EAAE;QACf,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,0EAA0E;QACvF,WAAW,EAAE,EAAE;QACf,gBAAgB,EAAE;YAChB,yCAAyC,EAAE,CAAC;YAC5C,2BAA2B,EAAE,CAAC;SAC/B;KACF;IACD,cAAc,EAAE;QACd,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,4EAA4E;QACzF,WAAW,EAAE,EAAE;QACf,gBAAgB,EAAE;YAChB,gDAAgD,EAAE,KAAK;SACxD;KACF;CACF,CAAC;AAEF,MAAM,UAAU,mBAAmB;IACjC,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,WAAiC;IACtE,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7C,OAAO;YACL,WAAW,EAAE,EAAE;YACf,WAAW,EAAE,EAAE;YACf,gBAAgB,EAAE,EAAE;SACrB,CAAC;IACJ,CAAC;IAED,MAAM,eAAe,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACzG,MAAM,MAAM,GAAyB;QACnC,WAAW,EAAE,eAAe;QAC5B,WAAW,EAAE,EAAE;QACf,gBAAgB,EAAE,EAAE;KACrB,CAAC;IAEF,KAAK,MAAM,UAAU,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,eAAe,CACvB,mBAAmB,UAAU,wBAAwB,mBAAmB,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACjH,CAAC;QACJ,CAAC;QAED,MAAM,CAAC,WAAW,GAAG;YACnB,GAAG,MAAM,CAAC,WAAW;YACrB,GAAG,MAAM,CAAC,WAAW;SACtB,CAAC;QACF,MAAM,CAAC,gBAAgB,GAAG;YACxB,GAAG,MAAM,CAAC,gBAAgB;YAC1B,GAAG,MAAM,CAAC,gBAAgB;SAC3B,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/camoufox/registry.d.ts

@@ -0,0 +1,30 @@
+import type { CamoucliPaths } from '../state/paths.js';
+import { type PlatformArch, type PlatformOs } from '../util/platform.js';
+export interface BrowserInstallRecord {
+    version: string;
+    tag: string;
+    sourceRepo: string;
+    assetName: string;
+    assetUrl: string;
+    rootDir: string;
+    executablePath: string;
+    installedAt: string;
+    platform: PlatformOs;
+    arch: PlatformArch;
+}
+export interface BrowserRegistry {
+    currentVersion?: string | undefined;
+    installs: Record<string, BrowserInstallRecord>;
+}
+export interface BrowserInstallListing {
+    currentVersion?: string | undefined;
+    installs: BrowserInstallRecord[];
+}
+export declare function loadBrowserRegistry(paths: CamoucliPaths): Promise<BrowserRegistry>;
+export declare function saveBrowserRegistry(paths: CamoucliPaths, registry: BrowserRegistry): Promise<void>;
+export declare function setInstalledBrowser(paths: CamoucliPaths, record: BrowserInstallRecord, makeCurrent?: boolean): Promise<BrowserRegistry>;
+export declare function setCurrentBrowser(paths: CamoucliPaths, version: string): Promise<BrowserRegistry>;
+export declare function removeInstalledBrowser(paths: CamoucliPaths, version: string): Promise<BrowserRegistry>;
+export declare function resolveInstalledBrowser(paths: CamoucliPaths, version?: string): Promise<BrowserInstallRecord | undefined>;
+export declare function listInstalledBrowsers(paths: CamoucliPaths): Promise<BrowserInstallListing>;
+export declare function requireInstalledBrowser(paths: CamoucliPaths, version?: string): Promise<BrowserInstallRecord>;