chrome-tools 1.1.15 → 1.1.18

package/dist/bin/cli.js

@@ -1,590 +0,0 @@
-#!/usr/bin/env node
-/**
- * chrome-tools CLI
- *
- * A comprehensive command-line interface for extracting Chrome browser data on
- * macOS, Windows, and Linux.
- * Supports subcommands and shortcut flags for quick access to all data types.
- */
-import { readFileSync } from "node:fs";
-import { Command, InvalidArgumentError } from "commander";
-import chalk from "chalk";
-import Table from "cli-table3";
-import { discoverProfiles, getProfileMetadata, getProfileStates, getDirectorySize, detectInstalledBrowsers } from "../src/core/chrome.js";
-import { setActiveBrowser, getActiveBrowser, isKeychainAccessDenied } from "../src/core/platform/index.js";
-import { describePasswordStores, getPasswords } from "../src/modules/passwords.js";
-import { getBookmarks } from "../src/modules/bookmarks.js";
-import { getHistory, getSearchTerms } from "../src/modules/history.js";
-import { getCookies } from "../src/modules/cookies.js";
-import { getLocalStorage } from "../src/modules/local-storage.js";
-import { getAutofillEntries, getCreditCards, getAddresses } from "../src/modules/autofill.js";
-import { getDownloads } from "../src/modules/downloads.js";
-import { getExtensions } from "../src/modules/extensions.js";
-import { getSearchEngines } from "../src/modules/search-engines.js";
-import { getTopSites } from "../src/modules/top-sites.js";
-// Resolved lazily per-invocation (inside handlers, after the active browser is
-// chosen) so `--browser` can drive the default profile path.
-const defaultProfilePath = process.env.PROFILE_PATH || undefined;
-const defaultProfileName = process.env.PROFILE_NAME || undefined;
-const defaultBrowser = process.env.BROWSER || process.env.CHROME_BROWSER || undefined;
-// ─── Output Helpers ──────────────────────────────────────────────────────────
-function outputJSON(data) {
-    console.log(JSON.stringify(data, null, 2));
-}
-function makeTable(headers, colWidths) {
-    return new Table({
-        head: headers.map((h) => chalk.bold.white(h)),
-        colWidths,
-        wordWrap: true,
-        style: { border: ["grey"], head: [] },
-    });
-}
-/**
- * Prints a prominent, friendly "No keychain access" message for a denied/locked
- * Keychain authorization. macOS itself shows the access prompt when we read the
- * key — this explains what happened when that prompt is denied or unavailable.
- * Returns true if the error was a keychain-access denial (and was handled here).
- */
-function reportKeychainDenied(err) {
-    if (!isKeychainAccessDenied(err))
-        return false;
-    console.error(chalk.red.bold("\n🔑 No keychain access\n"));
-    console.error(chalk.yellow("chrome-tools couldn't read the browser's encryption key from your macOS\n" +
-        "Keychain, so passwords and other encrypted data can't be decrypted."));
-    // The typed error already carries actionable, cause-specific guidance.
-    console.error(chalk.dim("\n" + err.message + "\n"));
-    return true;
-}
-function printCount(label, count) {
-    if (count === 0) {
-        console.log(chalk.yellow(`\n⚠ No ${label} found.\n`));
-    }
-    else {
-        console.log(chalk.green(`\n✔ Found ${count} ${label}.\n`));
-    }
-}
-function renderResults(opts, results, title, label, headers, widths, toRow) {
-    if (emit(opts, results))
-        return;
-    if (results.length === 0)
-        return printCount(label, 0);
-    console.log(chalk.bold(`\n${title}:\n`));
-    const table = makeTable(headers, widths);
-    for (const result of results)
-        table.push(toRow(result));
-    console.log(table.toString());
-    printCount(label, results.length);
-}
-function errorMessage(err) {
-    return err instanceof Error ? err.message : String(err);
-}
-// When set (during `--all-browsers --json`), handlers route their JSON payload
-// here instead of printing, so we can emit a single combined document.
-let _jsonCollector = null;
-/**
- * Emits a handler's results. Returns true when output was handled here (JSON or
- * collected), letting the caller skip its human-readable table rendering.
- */
-function emit(opts, results) {
-    if (_jsonCollector) {
-        _jsonCollector.push({ browser: getActiveBrowser().name, results });
-        return true;
-    }
-    if (opts.json) {
-        outputJSON(results);
-        return true;
-    }
-    return false;
-}
-/**
- * Runs a single data handler for every installed Chromium browser, reusing the
- * handler's own rendering. Human output gets a per-browser section header; JSON
- * output is collected into one combined array.
- */
-function runAll(handler, opts) {
-    const installed = detectInstalledBrowsers();
-    if (installed.length === 0) {
-        if (opts.json)
-            return outputJSON([]);
-        console.log(chalk.yellow("\n⚠ No supported Chromium browsers found on this machine.\n"));
-        return;
-    }
-    // --all-browsers spans browsers with different dirs, so a fixed --profile-path
-    // makes no sense; let each browser resolve its own default.
-    const perBrowserOpts = {
-        ...opts,
-        browser: undefined,
-        profilePath: undefined,
-    };
-    const previousBrowser = getActiveBrowser();
-    _jsonCollector = opts.json ? [] : null;
-    try {
-        for (const b of installed) {
-            setActiveBrowser(b.browser.id);
-            if (!opts.json) {
-                console.log(chalk.bold.magenta(`\n══════════ ${b.browser.name} ══════════`));
-            }
-            try {
-                handler(perBrowserOpts);
-            }
-            catch (err) {
-                if (_jsonCollector) {
-                    _jsonCollector.push({ browser: b.browser.name, results: { error: errorMessage(err) } });
-                }
-                else if (isKeychainAccessDenied(err)) {
-                    console.log(chalk.red(`  🔑 No keychain access — skipped (${err.service}).`));
-                    console.log(chalk.dim(`  ${err.message.split("\n").join("\n  ")}`));
-                }
-                else {
-                    console.log(chalk.red(`  ⚠ Skipped: ${errorMessage(err)}`));
-                }
-            }
-        }
-        if (_jsonCollector)
-            outputJSON(_jsonCollector);
-    }
-    finally {
-        _jsonCollector = null;
-        setActiveBrowser(previousBrowser.id);
-    }
-}
-/**
- * Resolves the effective scope (browser + path + profile) from a command's
- * options, applying environment fallbacks with the right precedence:
- *
- *   - A typed `--profile-path` / `--profile` always wins.
- *   - When a browser is explicitly scoped (`--browser`, `--all-browsers`, or a
- *     `BROWSER`/`CHROME_BROWSER` env var), the legacy `PROFILE_PATH` /
- *     `PROFILE_NAME` env defaults are ignored — they point at one specific
- *     Chrome dir and would otherwise mask the chosen browser's own location.
- *   - Otherwise (the classic single-browser setup), `PROFILE_PATH` /
- *     `PROFILE_NAME` apply as before.
- */
-function scopeFromCli(cmd) {
-    const opts = cmd.optsWithGlobals();
-    const browserScoped = Boolean(opts.browser) || Boolean(opts.allBrowsers) || Boolean(defaultBrowser);
-    opts.browser = opts.browser || defaultBrowser || undefined;
-    if (!opts.profilePath) {
-        opts.profilePath = browserScoped ? undefined : defaultProfilePath;
-    }
-    if (!opts.profile) {
-        opts.profile = browserScoped ? undefined : defaultProfileName;
-    }
-    return opts;
-}
-/**
- * Central entry point for data handlers: applies `--browser` (single) or fans
- * out across `--all-browsers`.
- */
-function dispatch(handler, opts) {
-    if (opts.allBrowsers) {
-        runAll(handler, opts);
-        return;
-    }
-    setActiveBrowser(opts.browser);
-    handler(opts);
-}
-// ─── Browsers Command ─────────────────────────────────────────────────────────
-function handleBrowsers(opts) {
-    const detected = detectInstalledBrowsers({ includeMissing: true });
-    if (opts.json) {
-        return outputJSON(detected.map((d) => ({
-            id: d.browser.id,
-            name: d.browser.name,
-            installed: d.installed,
-            profileCount: d.profileCount,
-            path: d.chromeDir,
-            safeStorageLabel: d.browser.safeStorageLabel,
-        })));
-    }
-    const installed = detected.filter((d) => d.installed);
-    console.log(chalk.bold(`\n🌐 Supported browsers (${installed.length} installed):\n`));
-    const table = makeTable(["Browser", "Id", "Installed", "Profiles", "Path"], [20, 14, 11, 9, 50]);
-    for (const d of detected) {
-        table.push([
-            chalk.white(d.browser.name),
-            chalk.cyan(d.browser.id),
-            d.installed ? chalk.green("✓") : chalk.dim("✗"),
-            d.installed ? chalk.yellow(String(d.profileCount)) : chalk.dim("—"),
-            chalk.dim(d.chromeDir),
-        ]);
-    }
-    console.log(table.toString());
-}
-// ─── Shared Options ──────────────────────────────────────────────────────────
-function addCommonOptions(cmd) {
-    return cmd
-        .option("--profile-path <path>", "Custom browser User Data Path (overrides --browser)")
-        .option("--profile <name>", "Target a specific profile")
-        .option("--browser <name>", "Browser to read (chrome, edge, brave, comet, vivaldi, opera, chromium…)")
-        .option("--all-browsers", "Read from every installed Chromium browser")
-        .option("--json", "Output as JSON");
-}
-function addSearchOption(cmd) {
-    return cmd.option("--search <term>", "Filter results (case-insensitive)");
-}
-function addLimitOption(cmd, defaultLimit = 100) {
-    return cmd.option("--limit <n>", "Limit number of results", parseLimit, defaultLimit);
-}
-function parseLimit(value) {
-    const limit = Number(value);
-    if (!Number.isSafeInteger(limit) || limit < 0) {
-        throw new InvalidArgumentError("Limit must be a non-negative integer.");
-    }
-    return limit;
-}
-// ─── Program Setup ───────────────────────────────────────────────────────────
-const program = new Command();
-const pkg = JSON.parse(readFileSync(new URL("../../package.json", import.meta.url), "utf8"));
-program
-    .name("chrome-tools")
-    .description(chalk.bold.cyan("Chrome Data Toolkit") +
-    chalk.dim(" — Extract passwords, bookmarks, history, cookies, and more from Chrome on macOS, Windows, and Linux"))
-    .version(pkg.version)
-    .option("--passwords", "Shortcut: list saved passwords")
-    .option("--bookmarks", "Shortcut: list bookmarks")
-    .option("--local-storage", "Shortcut: list localStorage entries")
-    .option("--profiles", "Shortcut: list profiles")
-    .option("--browsers", "Shortcut: list supported / installed browsers")
-    .option("--size", "Show each profile's size on disk when listing profiles (slower)");
-addCommonOptions(program)
-    .option("--search <term>", "Filter results (for shortcut flags)")
-    .option("--limit <n>", "Limit results (for shortcut flags)", parseLimit)
-    .action((opts, cmd) => {
-    // Default action when no subcommand is given.
-    const o = scopeFromCli(cmd);
-    if (o.browsers) {
-        handleBrowsers(o);
-    }
-    else if (o.passwords) {
-        dispatch(handlePasswords, o);
-    }
-    else if (o.bookmarks) {
-        dispatch(handleBookmarks, o);
-    }
-    else if (o.localStorage) {
-        dispatch(handleLocalStorage, o);
-    }
-    else {
-        // Default (including --profiles shortcut): list profiles.
-        dispatch(handleProfiles, o);
-    }
-});
-// ─── Profiles Command ───────────────────────────────────────────────────────
-const profilesCmd = program
-    .command("profiles")
-    .description("List Chrome profiles");
-addCommonOptions(profilesCmd)
-    .option("--size", "Compute and show each profile's size on disk (slower)")
-    .action((opts, cmd) => {
-    dispatch(handleProfiles, scopeFromCli(cmd));
-});
-const statesCmd = profilesCmd
-    .command("states")
-    .description("Show detailed profile states with available data files");
-addCommonOptions(statesCmd).action((opts, cmd) => dispatch(handleProfileStates, scopeFromCli(cmd)));
-// ─── Browsers Command ─────────────────────────────────────────────────────────
-const browsersCmd = program
-    .command("browsers")
-    .description("List supported browsers and detect which are installed");
-browsersCmd
-    .option("--json", "Output as JSON")
-    .action((opts, cmd) => handleBrowsers(scopeFromCli(cmd)));
-function handleProfiles(opts) {
-    const profiles = discoverProfiles(opts.profilePath);
-    const metadata = getProfileMetadata(opts.profilePath);
-    const withSize = Boolean(opts.size);
-    if (opts.json) {
-        const metaMap = new Map(metadata.map((m) => [m.directory, m]));
-        const enriched = profiles.map((p) => ({
-            ...p,
-            ...metaMap.get(p.name),
-            ...(withSize ? { sizeBytes: getDirectorySize(p.path) } : {}),
-        }));
-        emit(opts, enriched);
-        return;
-    }
-    if (profiles.length === 0) {
-        console.log(chalk.yellow("\n⚠ No Chrome profiles found.\n"));
-        return;
-    }
-    const metaMap = new Map(metadata.map((m) => [m.directory, m]));
-    console.log(chalk.bold(`\n📁 Discovered ${profiles.length} profile(s):\n`));
-    const headers = withSize
-        ? ["Directory", "Display Name", "Email", "Size", "Path"]
-        : ["Directory", "Display Name", "Email", "Path"];
-    const widths = withSize ? [16, 22, 30, 10, 42] : [16, 22, 30, 50];
-    const table = makeTable(headers, widths);
-    for (const p of profiles) {
-        const meta = metaMap.get(p.name);
-        const row = [
-            chalk.cyan(p.name),
-            chalk.white(meta?.name || p.name),
-            chalk.dim(meta?.email || "—"),
-        ];
-        if (withSize) {
-            row.push(chalk.yellow(formatBytes(getDirectorySize(p.path))));
-        }
-        row.push(chalk.dim(p.path));
-        table.push(row);
-    }
-    console.log(table.toString());
-    printCount("profile(s)", profiles.length);
-}
-function handleProfileStates(opts) {
-    const states = getProfileStates(opts.profilePath);
-    if (opts.json) {
-        emit(opts, states);
-        return;
-    }
-    if (states.length === 0) {
-        console.log(chalk.yellow("\n⚠ No Chrome profiles found.\n"));
-        return;
-    }
-    console.log(chalk.bold(`\n📊 Profile States (${states.length} profile(s)):\n`));
-    for (const state of states) {
-        console.log(chalk.bold.cyan(`  ${state.displayName}`) + chalk.dim(` (${state.directory})`));
-        if (state.email) {
-            console.log(chalk.dim(`    Email: ${state.email}`));
-        }
-        console.log(chalk.dim(`    Path:  ${state.path}`));
-        const files = state.dataFiles;
-        const available = Object.entries(files)
-            .filter(([, exists]) => exists)
-            .map(([name]) => name);
-        const missing = Object.entries(files)
-            .filter(([, exists]) => !exists)
-            .map(([name]) => name);
-        console.log(`    Available: ${available.map((f) => chalk.green(f)).join(", ") || chalk.dim("none")}`);
-        if (missing.length > 0) {
-            console.log(`    Missing:   ${missing.map((f) => chalk.dim(f)).join(", ")}`);
-        }
-        console.log();
-    }
-}
-// ─── Passwords Command ──────────────────────────────────────────────────────
-const passwordsCmd = program.command("passwords").description("List saved passwords");
-addSearchOption(addCommonOptions(passwordsCmd))
-    .option("--diagnose", "Report the stores that would be read — profile, file, row count, and any read error — instead of the passwords themselves")
-    .action((opts, cmd) => dispatch(handlePasswords, scopeFromCli(cmd)));
-function handlePasswords(opts) {
-    if (opts.diagnose)
-        return diagnosePasswords(opts);
-    const results = getPasswords(opts);
-    if (emit(opts, results))
-        return;
-    if (results.length === 0) {
-        return printCount("passwords", 0);
-    }
-    console.log(chalk.bold("\n🔑 Saved Passwords:\n"));
-    const showProfile = new Set(results.map((r) => r.profile)).size > 1;
-    // Always show the source (device vs account) — it explains where each entry
-    // lives and why a device-only listing can look empty when sync is on.
-    const head = ["Source", "URL", "Username", "Password", "Last Used"];
-    const widths = [9, 42, 24, 22, 20];
-    if (showProfile) {
-        head.unshift("Profile");
-        widths.unshift(12);
-    }
-    const table = makeTable(head, widths);
-    for (const r of results) {
-        const row = [
-            chalk.blue(r.source ?? "?"),
-            chalk.cyan(r.url),
-            chalk.green(r.username || "<empty>"),
-            chalk.yellow(r.password || "<empty>"),
-            chalk.dim(r.lastUsed),
-        ];
-        if (showProfile)
-            row.unshift(chalk.magenta(r.profile));
-        table.push(row);
-    }
-    console.log(table.toString());
-    printCount("password(s)", results.length);
-}
-/**
- * Explains an empty listing. A store that cannot be opened is skipped silently
- * during a normal read, which leaves "no passwords found" meaning either
- * "none saved" or "none readable" — this separates the two. Counts and errors
- * only: nothing here is decrypted.
- */
-function diagnosePasswords(opts) {
-    const reports = describePasswordStores(opts);
-    if (emit(opts, reports))
-        return;
-    if (reports.length === 0) {
-        console.log(chalk.yellow("\n⚠ No profiles found to read.\n"));
-        return;
-    }
-    console.log(chalk.bold("\n🔎 Password stores:\n"));
-    const table = makeTable(["Root", "Profile", "Store", "Exists", "Rows", "Error"], [34, 12, 24, 7, 6, 40]);
-    for (const r of reports) {
-        table.push([
-            chalk.dim(r.root),
-            r.profile,
-            chalk.blue(r.file),
-            r.exists ? "yes" : chalk.yellow("no"),
-            r.rows === null ? chalk.red("?") : String(r.rows),
-            r.error ? chalk.red(r.error) : "",
-        ]);
-    }
-    console.log(table.toString());
-    console.log();
-}
-// ─── Bookmarks Command ──────────────────────────────────────────────────────
-const bookmarksCmd = program.command("bookmarks").description("List bookmarks");
-addSearchOption(addCommonOptions(bookmarksCmd))
-    .option("--folder <name>", "Filter by folder name")
-    .action((opts, cmd) => dispatch(handleBookmarks, scopeFromCli(cmd)));
-function handleBookmarks(opts) {
-    renderResults(opts, getBookmarks(opts), "📚 Bookmarks", "bookmark(s)", ["Title", "URL", "Folder", "Date Added"], [30, 50, 25, 20], (r) => [
-        chalk.white(r.title),
-        chalk.cyan(r.url),
-        chalk.dim(r.folder || "/"),
-        chalk.dim(r.dateAdded),
-    ]);
-}
-// ─── History Command ─────────────────────────────────────────────────────────
-const historyCmd = program.command("history").description("List browsing history");
-addSearchOption(addLimitOption(addCommonOptions(historyCmd))).action((opts, cmd) => dispatch((mergedOpts) => {
-    renderResults(mergedOpts, getHistory(mergedOpts), "🕐 Browsing History", "history entry(ies)", ["URL", "Title", "Visits", "Last Visit"], [50, 30, 8, 22], (r) => [
-        chalk.cyan(r.url),
-        chalk.white(r.title || "—"),
-        chalk.yellow(String(r.visitCount)),
-        chalk.dim(r.lastVisit),
-    ]);
-}, scopeFromCli(cmd)));
-// ─── Search Terms Command ────────────────────────────────────────────────────
-const searchTermsCmd = program.command("search-terms").description("List search terms from history");
-addLimitOption(addCommonOptions(searchTermsCmd)).action((opts, cmd) => dispatch((mergedOpts) => {
-    renderResults(mergedOpts, getSearchTerms(mergedOpts), "🔍 Search Terms", "search term(s)", ["Term", "URL"], [40, 80], (r) => [chalk.white(r.term), chalk.dim(r.url)]);
-}, scopeFromCli(cmd)));
-// ─── Cookies Command ─────────────────────────────────────────────────────────
-const cookiesCmd = program.command("cookies").description("List cookies (encrypted values decrypted)");
-addLimitOption(addCommonOptions(cookiesCmd))
-    .option("--domain <domain>", "Filter by domain")
-    .option("--url <url>", "Filter by URL with path")
-    .option("--no-decrypt", "Skip decryption of encrypted values")
-    .action((opts, cmd) => dispatch((mergedOpts) => {
-    renderResults(mergedOpts, getCookies(mergedOpts), "🍪 Cookies", "cookie(s)", ["Domain", "Name", "Value", "Secure", "Expires"], [30, 25, 30, 8, 22], (r) => [
-        chalk.cyan(r.domain),
-        chalk.white(r.name),
-        chalk.dim(truncate(r.value, 50)),
-        r.secure ? chalk.green("✓") : chalk.dim("✗"),
-        chalk.dim(r.expires),
-    ]);
-}, scopeFromCli(cmd)));
-// ─── Local Storage Command ──────────────────────────────────────────────────
-const localStorageCmd = program.command("local-storage").description("List localStorage entries");
-addSearchOption(addLimitOption(addCommonOptions(localStorageCmd)))
-    .option("--origin <origin>", "Filter by origin")
-    .option("--url <url>", "Filter by URL origin")
-    .option("--key <key>", "Filter by localStorage key")
-    .action((opts, cmd) => dispatch(handleLocalStorage, scopeFromCli(cmd)));
-function handleLocalStorage(opts) {
-    renderResults(opts, getLocalStorage(opts), "💾 localStorage", "localStorage entries", ["Origin", "Key", "Value"], [36, 28, 46], (r) => [
-        chalk.cyan(r.origin),
-        chalk.white(r.key),
-        chalk.dim(truncate(r.value, 80)),
-    ]);
-}
-// ─── Autofill Command ────────────────────────────────────────────────────────
-const autofillCmd = program.command("autofill").description("List autofill entries");
-addSearchOption(addLimitOption(addCommonOptions(autofillCmd))).action((opts, cmd) => dispatch((mergedOpts) => {
-    renderResults(mergedOpts, getAutofillEntries(mergedOpts), "📝 Autofill Entries", "autofill entry(ies)", ["Field Name", "Value", "Count", "Last Used"], [25, 40, 8, 22], (r) => [
-        chalk.cyan(r.name),
-        chalk.white(r.value),
-        chalk.yellow(String(r.count)),
-        chalk.dim(r.dateLastUsed),
-    ]);
-}, scopeFromCli(cmd)));
-// ─── Credit Cards Command ────────────────────────────────────────────────────
-const creditCardsCmd = program.command("credit-cards").description("List saved credit cards");
-addCommonOptions(creditCardsCmd).action((opts, cmd) => dispatch((mergedOpts) => {
-    renderResults(mergedOpts, getCreditCards(mergedOpts), "💳 Saved Credit Cards", "credit card(s)", ["Name on Card", "Card Number", "Expires", "Nickname"], [25, 25, 14, 20], (r) => [
-        chalk.white(r.nameOnCard || "—"),
-        chalk.yellow(r.cardNumber || "—"),
-        chalk.dim(`${r.expirationMonth}/${r.expirationYear}`),
-        chalk.dim(r.nickname || "—"),
-    ]);
-}, scopeFromCli(cmd)));
-// ─── Addresses Command ───────────────────────────────────────────────────────
-const addressesCmd = program.command("addresses").description("List saved addresses");
-addCommonOptions(addressesCmd).action((opts, cmd) => dispatch((mergedOpts) => {
-    renderResults(mergedOpts, getAddresses(mergedOpts), "🏠 Saved Addresses", "address(es)", ["Name", "Email", "Phone", "Address", "City/State/Zip"], [20, 25, 16, 30, 25], (r) => [
-        chalk.white(r.fullName || "—"),
-        chalk.cyan(r.email || "—"),
-        chalk.dim(r.phone || "—"),
-        chalk.white(r.streetAddress || "—"),
-        chalk.dim([r.city, r.state, r.zipcode].filter(Boolean).join(", ") || "—"),
-    ]);
-}, scopeFromCli(cmd)));
-// ─── Downloads Command ───────────────────────────────────────────────────────
-const downloadsCmd = program.command("downloads").description("List download history");
-addSearchOption(addLimitOption(addCommonOptions(downloadsCmd))).action((opts, cmd) => dispatch((mergedOpts) => {
-    renderResults(mergedOpts, getDownloads(mergedOpts), "⬇️  Download History", "download(s)", ["File", "URL", "Size", "State", "Date"], [35, 40, 12, 12, 20], (r) => [
-        chalk.white(r.targetPath ? r.targetPath.split(/[\\/]/).pop() || "" : "—"),
-        chalk.cyan(truncate(r.url, 60)),
-        chalk.dim(r.totalBytes > 0 ? formatBytes(r.totalBytes) : "—"),
-        r.state === "complete" ? chalk.green(r.state) : chalk.yellow(r.state),
-        chalk.dim(r.startTime),
-    ]);
-}, scopeFromCli(cmd)));
-// ─── Extensions Command ─────────────────────────────────────────────────────
-const extensionsCmd = program.command("extensions").description("List installed extensions");
-addSearchOption(addCommonOptions(extensionsCmd)).action((opts, cmd) => dispatch((mergedOpts) => {
-    renderResults(mergedOpts, getExtensions(mergedOpts), "🧩 Installed Extensions", "extension(s)", ["Name", "Version", "ID", "Enabled", "Webstore"], [30, 12, 36, 9, 9], (r) => [
-        chalk.white(r.name),
-        chalk.dim(r.version),
-        chalk.dim(r.id),
-        r.enabled ? chalk.green("✓") : chalk.red("✗"),
-        r.fromWebstore ? chalk.green("✓") : chalk.dim("✗"),
-    ]);
-}, scopeFromCli(cmd)));
-// ─── Search Engines Command ─────────────────────────────────────────────────
-const searchEnginesCmd = program.command("search-engines").description("List configured search engines");
-addCommonOptions(searchEnginesCmd).action((opts, cmd) => dispatch((mergedOpts) => {
-    renderResults(mergedOpts, getSearchEngines(mergedOpts), "🔎 Search Engines", "search engine(s)", ["Name", "Keyword", "URL", "Active"], [20, 16, 60, 8], (r) => [
-        chalk.white(r.name),
-        chalk.cyan(r.keyword),
-        chalk.dim(truncate(r.url, 80)),
-        r.isActive ? chalk.green("✓") : chalk.dim("✗"),
-    ]);
-}, scopeFromCli(cmd)));
-// ─── Top Sites Command ──────────────────────────────────────────────────────
-const topSitesCmd = program.command("top-sites").description("List top sites");
-addCommonOptions(topSitesCmd).action((opts, cmd) => dispatch((mergedOpts) => {
-    renderResults(mergedOpts, getTopSites(mergedOpts), "⭐ Top Sites", "top site(s)", ["Rank", "Title", "URL"], [8, 30, 80], (r) => [
-        chalk.yellow(String(r.rank + 1)),
-        chalk.white(r.title || "—"),
-        chalk.cyan(r.url),
-    ]);
-}, scopeFromCli(cmd)));
-// ─── Utilities ───────────────────────────────────────────────────────────────
-function formatBytes(bytes) {
-    if (bytes === 0)
-        return "0 B";
-    const units = ["B", "KB", "MB", "GB", "TB"];
-    const i = Math.floor(Math.log(bytes) / Math.log(1024));
-    return `${(bytes / Math.pow(1024, i)).toFixed(1)} ${units[i]}`;
-}
-function truncate(value, maxLength) {
-    if (!value)
-        return "—";
-    return value.length > maxLength ? value.slice(0, maxLength) + "…" : value;
-}
-// ─── Run ─────────────────────────────────────────────────────────────────────
-try {
-    program.parse();
-}
-catch (err) {
-    // Print a clean, actionable message instead of dumping the minified source and
-    // a Node stack trace for expected failures (bad --browser, keychain denial, …).
-    // Set DEBUG=1 to see the full stack.
-    if (!reportKeychainDenied(err)) {
-        console.error(chalk.red(`\n✖ ${errorMessage(err)}\n`));
-    }
-    if (process.env.DEBUG)
-        console.error(err);
-    process.exit(1);
-}

package/dist/src/core/browsers.d.ts

@@ -1,73 +0,0 @@
-/**
- * Chromium-browser registry — the single source of truth for what differs
- * between Chromium-based browsers (Chrome, Edge, Brave, Comet, …).
- *
- * Every supported browser is a Chromium fork, so the *decryption* is identical
- * per OS (AES-128-CBC + PBKDF2 on macOS/Linux, AES-256-GCM + DPAPI on Windows).
- * Only two things vary by browser:
- *   1. the default profile data directory, and
- *   2. the OS-keystore "Safe Storage" label (macOS Keychain service name /
- *      Linux Secret Service application).
- *
- * "Browser" is therefore a small dimension orthogonal to "platform": the
- * platform backends (darwin/win32/linux) receive a browser descriptor and stay
- * otherwise unchanged.
- */
-export type BrowserId = "chrome" | "chrome-beta" | "chrome-canary" | "chromium" | "edge" | "brave" | "comet" | "vivaldi" | "opera";
-/** Subpaths to a browser's User Data dir, relative to each OS's app-data base. */
-export interface BrowserDirs {
-    /** Under `~/Library/Application Support`. */
-    darwin: string;
-    /** Under the selected Windows app-data root. Includes any `User Data` segment. */
-    win32: string;
-    /** Windows application-data root. Chromium browsers normally use Local. */
-    win32Base?: "local" | "roaming";
-    /** Under `$XDG_CONFIG_HOME` (or `~/.config`). */
-    linux: string;
-}
-export interface BrowserDescriptor {
-    /** Stable identifier used on the CLI (`--browser <id>`) and in the API. */
-    readonly id: BrowserId;
-    /** Human-readable display name, e.g. "Microsoft Edge". */
-    readonly name: string;
-    /** Extra names accepted on the CLI (case-insensitive), e.g. "msedge". */
-    readonly aliases?: readonly string[];
-    /**
-     * macOS Keychain service name (a.k.a. the "<Browser> Safe Storage" item) used
-     * as the basis for the AES key. Also reused as a human label in messages.
-     */
-    readonly safeStorageLabel: string;
-    /** Linux Secret Service `application` attribute used by `secret-tool lookup`. */
-    readonly linuxSecretApp?: string;
-    /** Per-OS User Data subpaths. */
-    readonly dirs: BrowserDirs;
-}
-/**
- * Supported browsers. macOS paths/labels are verified; a few Windows/Linux
- * paths for niche browsers (Comet, Opera) are best-effort and easy to correct —
- * each is a single edit here, with no other code change required.
- */
-export declare const BROWSERS: Record<BrowserId, BrowserDescriptor>;
-/** All supported browsers, in a stable display order. */
-export declare function listBrowsers(): BrowserDescriptor[];
-/**
- * Resolves a browser by id, display name, or alias (case-insensitive).
- * @returns The descriptor, or `null` if unrecognized.
- */
-export declare function resolveBrowser(idOrName: string): BrowserDescriptor | null;
-/** Resolves a browser or throws an actionable error without changing global state. */
-export declare function requireBrowser(idOrName: string): BrowserDescriptor;
-/** The browser currently targeted by dir/key lookups. Defaults to Chrome. */
-export declare function getActiveBrowser(): BrowserDescriptor;
-/**
- * Sets the active browser for subsequent dir/key lookups.
- *
- * Caches in the platform backends are keyed by their real inputs (Keychain
- * service label, chromeDir, Linux secret app), so switching browsers never
- * returns a stale key — no cache flush is needed here.
- *
- * @param idOrName - Browser id/name/alias. Empty/undefined resets to Chrome.
- * @returns The now-active descriptor.
- * @throws If `idOrName` is non-empty but unrecognized.
- */
-export declare function setActiveBrowser(idOrName?: string): BrowserDescriptor;