chrome-tools 1.1.16 → 1.2.1

package/dist/index.d.ts

@@ -1,629 +1,29 @@
 /**
- * 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.
- */
-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. */
-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;
-}
-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.
- */
-declare const BROWSERS: Record<BrowserId, BrowserDescriptor>;
-/** All supported browsers, in a stable display order. */
-declare function listBrowsers(): BrowserDescriptor[];
-/**
- * Resolves a browser by id, display name, or alias (case-insensitive).
- * @returns The descriptor, or `null` if unrecognized.
- */
-declare function resolveBrowser(idOrName: string): BrowserDescriptor | null;
-/** Resolves a browser or throws an actionable error without changing global state. */
-declare function requireBrowser(idOrName: string): BrowserDescriptor;
-/** The browser currently targeted by dir/key lookups. Defaults to Chrome. */
-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.
- */
-declare function setActiveBrowser(idOrName?: string): BrowserDescriptor;
-
-interface DiscoveredProfile {
-    name: string;
-    path: string;
-}
-interface ProfileMetadata {
-    directory: string;
-    name: string;
-    gaiaName: string;
-    userName: string;
-    email: string;
-    avatarIcon: string;
-    isUsingDefaultName: boolean;
-    isEphemeral: boolean;
-    activeTime: number;
-}
-interface ProfileState {
-    directory: string;
-    path: string;
-    displayName: string;
-    gaiaName: string;
-    email: string;
-    avatarIcon: string;
-    isEphemeral: boolean;
-    activeTime: number;
-    dataFiles: Record<string, boolean>;
-}
-interface ResolveProfilesOptions {
-    profilePath?: string;
-    chromeDir?: string;
-    profile?: string;
-    /** Target a specific browser (id/name/alias). Applied only when provided. */
-    browser?: string;
-}
-/**
- * Returns the default Chrome User Data directory for the current OS.
- * Delegates to the active platform backend (macOS/Windows/Linux).
- * @returns The absolute path to Chrome's User Data.
- */
-declare function getDefaultChromeDir(browser?: string | BrowserDescriptor): string;
-interface InstalledBrowser {
-    /** Registry descriptor for the detected browser. */
-    browser: BrowserDescriptor;
-    /** Absolute path to this browser's default User Data directory. */
-    chromeDir: string;
-    /** Whether the data directory exists on disk. */
-    installed: boolean;
-    /** Number of discovered profiles (0 when not installed). */
-    profileCount: number;
-}
-/**
- * Probes every supported browser for an on-disk profile directory.
- *
- * @param options.includeMissing - When true, also returns browsers with no data
- *   directory (installed: false). Defaults to false (installed browsers only).
- * @returns One entry per matching browser.
- */
-declare function detectInstalledBrowsers({ includeMissing }?: {
-    includeMissing?: boolean;
-}): InstalledBrowser[];
-/**
- * Scans the Chrome User Data directory for profile subdirectories.
- * A directory is considered a profile if it contains at least one known data file.
- *
- * Also handles "flat" layouts (e.g. some Opera installs, or when `chromeDir`
- * already points at a single profile folder): if no child profiles are found
- * but the user-data directory itself has profile indicators, it is returned
- * as a single profile.
- *
- * @param chromeDir - Chrome User Data path. Defaults to standard macOS location.
- * @returns Discovered profiles with name and absolute path.
- */
-declare function discoverProfiles(chromeDir?: string): DiscoveredProfile[];
-/**
- * Parses the Chrome "Local State" JSON file to extract profile metadata.
- * Returns enriched profile info including display name, email, avatar, etc.
- *
- * @param chromeDir - Chrome User Data path.
- * @returns Profile metadata objects.
- */
-declare function getProfileMetadata(chromeDir?: string): ProfileMetadata[];
-/**
- * Combines filesystem profile discovery with Local State metadata
- * to provide a comprehensive view of each profile's state.
- *
- * @param chromeDir - Chrome User Data path.
- * @returns Enriched profile state objects.
- */
-declare function getProfileStates(chromeDir?: string): ProfileState[];
-/**
- * Resolves a profile name to its directory path.
- *
- * @param chromeDir - Chrome User Data path.
- * @param profileName - Profile directory name (e.g., "Default", "Profile 1").
- * @returns Absolute path to profile directory, or null if not found.
- */
-declare function resolveProfilePath(chromeDir: string, profileName: string): string | null;
-/**
- * Helper to get the profiles to operate on based on options.
- * If a specific profile is specified, returns only that one.
- * Otherwise returns all discovered profiles.
- *
- * @param options - Resolution options.
- * @returns Array of targeted profiles.
- */
-declare function resolveTargetProfiles({ profilePath, chromeDir, profile, browser, }?: ResolveProfilesOptions): DiscoveredProfile[];
-
-/**
- * The platform-specific backend contract.
- *
- * Everything that differs between operating systems is bundled here because the
- * three concerns are coupled — a Windows key only works with the Windows cipher,
- * etc. Each backend (darwin/win32/linux) implements this once; the rest of the
- * codebase stays platform-agnostic and talks to the selected backend through the
- * facades in `./index.ts`.
- */
-interface ChromePlatform {
-    /** Node platform identifier this backend handles (e.g. "darwin", "win32", "linux"). */
-    readonly name: string;
-    /** Absolute path to Chrome's User Data directory for this OS. */
-    getDefaultChromeDir(browser?: BrowserDescriptor): string;
-    /**
-     * Returns the symmetric key used to decrypt this profile's secrets, ready to
-     * hand to {@link decrypt}. May read the OS key store and is cached internally.
-     *
-     * @param chromeDir - User Data dir, needed on platforms (Windows) where the
-     *   key lives inside `Local State`. Defaults to {@link getDefaultChromeDir}.
-     * @throws An actionable Error if the key cannot be obtained.
-     */
-    getDecryptionKey(chromeDir?: string, browser?: BrowserDescriptor): Buffer;
-    /**
-     * Returns the App-Bound Encryption key for Chrome 127+ on Windows.
-     * Only the win32 backend implements this; others return `undefined`.
-     *
-     * @param chromeDir - User Data dir containing the `Local State` file.
-     * @param browser - Browser to target (needed to select the COM CLSID).
-     * @returns The decrypted 32-byte AES key, or `undefined` if ABE is
-     *   unavailable or unsupported on this platform.
-     */
-    getAppBoundKey?(chromeDir?: string, browser?: BrowserDescriptor): Buffer | undefined;
-    /**
-     * Decrypts a single Chrome `v10`/`v11`/`v20` blob using this platform's
-     * scheme (AES-128-CBC on macOS/Linux, AES-256-GCM on Windows).
-     *
-     * @returns The plaintext bytes, or a `<...>` placeholder string on a
-     *   recognized but undecryptable blob (never throws).
-     */
-    decrypt(blob: Buffer, key: Buffer): Buffer | string;
-    /** Clears any cached key material. Useful for tests / re-authentication. */
-    clearCache(): void;
-}
-
-type KeychainPasswordProvider = (service: string) => string;
-/**
- * Returns the current global keychain password provider hook.
- */
-declare function getKeychainPasswordProvider(): KeychainPasswordProvider | null;
-/**
- * Sets the global keychain password provider hook, allowing downstream apps (like Electron)
- * to intercept keychain password lookups and resolve them (e.g. via native node-keytar).
- */
-declare function setKeychainPasswordProvider(provider: KeychainPasswordProvider | null): void;
-/**
- * Retrieves a browser's "Safe Storage" password from the macOS Keychain.
- * Caches the result per service for subsequent calls within the same process.
- *
- * @param service - Keychain service name, e.g. "Chrome Safe Storage".
- * @returns The raw keychain password.
- * @throws If the password could not be retrieved.
- */
-declare function getKeychainPassword(service?: string): string;
-/**
- * Backward-compatible alias for {@link getKeychainPassword} using Chrome's item.
- * @deprecated Prefer {@link getKeychainPassword} with an explicit service name.
- */
-declare function getChromeKeychainPassword(): string;
-/**
- * Clears cached keychain data for all browsers. Useful for testing or
- * re-authentication.
- */
-declare function clearKeychainCache(): void;
-
-/**
- * Platform selection + facades.
- *
- * This is the ONLY place that reads `process.platform`. Everything else in the
- * codebase imports the facades below (`getPlatformChromeDir`, `deriveEncryptionKey`,
- * `decryptValue`, `decryptValueBuffer`, `clearKeyCache`) and stays OS-agnostic.
- */
-
-/**
- * Returns the backend for the current OS, cached after first call.
- * @throws On an unsupported platform.
- */
-declare function selectPlatform(): ChromePlatform;
-/** Default Chrome User Data directory for the current OS. */
-declare function getPlatformChromeDir(browser?: string | BrowserDescriptor): string;
-/**
- * Returns the symmetric key for decrypting this profile's secrets.
- * @param chromeDir - Needed on Windows, where the key lives in `Local State`.
- */
-declare function deriveEncryptionKey(chromeDir?: string, browser?: string | BrowserDescriptor): Buffer;
-/** Decrypts a Chrome blob and returns the plaintext bytes (or a placeholder string). */
-declare function decryptValueBuffer(blob: Buffer | Uint8Array | null | undefined, key: Buffer): Buffer | string;
-/** Decrypts a Chrome blob and returns the plaintext as a UTF-8 string. */
-declare function decryptValue(blob: Buffer | Uint8Array | null | undefined, key: Buffer): string;
-/** Clears the active backend's cached key material. */
-declare function clearKeyCache(): void;
-
-/**
- * Converts a Chrome/Webkit timestamp (microseconds since 1601-01-01)
- * to a readable local Date string.
- *
- * @param chromeTimestamp - Timestamp in microseconds.
- * @returns Human-readable date-time string, or "N/A".
- */
-declare function chromeTimeToDate(chromeTimestamp: bigint | number | string | null | undefined): string;
-
-/**
- * Creates a transactionally consistent snapshot of a Chrome SQLite database,
- * executes a query against it, and cleans up. `VACUUM INTO` reads through
- * SQLite itself, so live WAL contents are included without racing raw file
- * copies while Chrome is writing. A store the browser holds exclusively cannot
- * be opened that way at all, and falls back to a file copy (see below).
- *
- * @param dbFilePath - Absolute path to the Chrome database file.
- * @param sql - SQL query to execute.
- * @param params - Bound parameters for the query.
- * @returns Query result rows.
- * @throws If the file doesn't exist or query fails.
- */
-declare function queryDatabase(dbFilePath: string, sql: string, params?: unknown[]): any[];
-/**
- * Checks whether a specific table exists in the given database file.
- *
- * @param dbFilePath - Absolute path to the database file.
- * @param tableName - Name of the table to check.
- * @returns True if the table exists.
- */
-declare function tableExists(dbFilePath: string, tableName: string): boolean;
-
-interface PasswordOptions extends ResolveProfilesOptions {
-    search?: string;
-    decryptionKey?: Buffer;
-}
-/** Which on-disk store a password came from. */
-type PasswordSource = "device" | "account";
-interface PasswordEntry {
-    profile: string;
-    /** "device" = local "Login Data"; "account" = synced "Login Data For Account". */
-    source?: PasswordSource;
-    url?: string;
-    username?: string;
-    password?: string;
-    lastUsed?: string;
-    error?: string;
-}
-/** What a single password store looked like when it was read. */
-interface PasswordStoreReport {
-    /** The User Data directory searched; "default" when the platform picked it. */
-    root: string;
-    profile: string;
-    /** "Login Data" (device) or "Login Data For Account" (synced). */
-    file: string;
-    source: PasswordSource;
-    exists: boolean;
-    /** Rows in `logins`, before any search filter. Null when the read failed. */
-    rows: number | null;
-    /** Why the read failed, when it did. No credential value is ever included. */
-    error?: string;
-}
-/**
- * Reports what a `getPasswords` call would read, and what it could not.
- *
- * `getPasswords` skips a store it cannot open — a missing file, a schema it does
- * not know, a database another process is holding — and an empty result cannot
- * tell "nothing saved here" from "could not look". This runs the same profile
- * resolution and opens the same databases, and answers with row counts and
- * errors only. It decrypts nothing, so no password value can escape through it.
- */
-declare function describePasswordStores({ chromeDir, profilePath, profile, browser, }?: PasswordOptions): PasswordStoreReport[];
-/**
- * Extracts and decrypts saved passwords from Chrome's password databases.
- * Reads both the device-local and account-synced stores, labelling each entry
- * with its `source` (no de-duplication across the two).
- *
- * @param options - Options for profile selection and filtering.
- * @returns Array of decrypted password entries.
- */
-declare function getPasswords({ chromeDir, profilePath, profile, search, browser, decryptionKey, }?: PasswordOptions): PasswordEntry[];
-
-interface BookmarkOptions extends ResolveProfilesOptions {
-    folder?: string;
-    search?: string;
-}
-interface BookmarkEntry {
-    profile?: string;
-    title: string;
-    url: string;
-    folder: string;
-    dateAdded: string;
-    dateLastUsed: string;
-    id?: string;
-    guid?: string;
-}
-/**
- * Reads and parses bookmarks from Chrome's Bookmarks JSON file.
- *
- * @param options - Options for filtering and targeting.
- * @returns Filtered bookmark entries.
- */
-declare function getBookmarks({ chromeDir, profilePath, profile, folder, search, browser, }?: BookmarkOptions): BookmarkEntry[];
-
-interface HistoryOptions extends ResolveProfilesOptions {
-    search?: string;
-    limit?: number;
-}
-interface HistoryEntry {
-    profile: string;
-    url: string;
-    title: string;
-    visitCount: number;
-    lastVisit: string;
-}
-interface SearchTermOptions extends ResolveProfilesOptions {
-    limit?: number;
-}
-interface SearchTermEntry {
-    profile: string;
-    term: string;
-    url: string;
-}
-/**
- * Retrieves browsing history from Chrome's History database.
- *
- * @param options - Filtering and targeting options.
- * @returns Array of history entries.
- */
-declare function getHistory({ chromeDir, profilePath, profile, search, limit, browser, }?: HistoryOptions): HistoryEntry[];
-/**
- * Retrieves search terms from Chrome's History database.
- *
- * @param options - Targeting and limit options.
- * @returns Array of search term entries.
- */
-declare function getSearchTerms({ chromeDir, profilePath, profile, limit, browser, }?: SearchTermOptions): SearchTermEntry[];
-
-interface CookieOptions extends ResolveProfilesOptions {
-    domain?: string;
-    url?: string;
-    decrypt?: boolean;
-    limit?: number;
-    decryptionKey?: Buffer;
-}
-interface CookieEntry {
-    profile: string;
-    domain: string;
-    name: string;
-    value: string;
-    path: string;
-    expires: string;
-    secure: boolean;
-    httpOnly: boolean;
-    sameSite: string;
-    created: string;
-    lastAccessed: string;
-}
-/**
- * Extracts cookies from Chrome's Cookies database.
- * Encrypted values are decrypted using the same mechanism as passwords.
- *
- * @param options - Targeting and filtering options.
- * @returns Array of cookie entries.
- */
-declare function getCookies({ chromeDir, profilePath, profile, browser, domain, url, decrypt, limit, decryptionKey, }?: CookieOptions): CookieEntry[];
-
-interface LocalStorageOptions extends ResolveProfilesOptions {
-    origin?: string;
-    url?: string;
-    key?: string;
-    search?: string;
-    limit?: number;
-}
-interface LocalStorageEntry {
-    profile: string;
-    origin: string;
-    key: string;
-    value: string;
-}
-/**
- * Reads localStorage key/value pairs from Chrome's Local Storage LevelDB store.
- *
- * @param options - Targeting and filtering options.
- * @returns Array of localStorage entries.
- */
-declare function getLocalStorage({ chromeDir, profilePath, profile, browser, origin, url, key, search, limit, }?: LocalStorageOptions): LocalStorageEntry[];
-
-interface AutofillOptions extends ResolveProfilesOptions {
-    search?: string;
-    limit?: number;
-}
-interface AutofillEntry {
-    profile: string;
-    name: string;
-    value: string;
-    dateCreated: string;
-    dateLastUsed: string;
-    count: number;
-}
-interface CreditCardOptions extends ResolveProfilesOptions {
-    decryptionKey?: Buffer;
-}
-interface CreditCardEntry {
-    profile: string;
-    guid: string;
-    nameOnCard: string;
-    expirationMonth: number;
-    expirationYear: number;
-    cardNumber: string;
-    nickname: string;
-    origin: string;
-    useCount: number;
-    dateModified: string;
-}
-interface AddressOptions extends ResolveProfilesOptions {
-}
-interface AddressEntry {
-    profile: string;
-    guid: string;
-    fullName: string;
-    email: string;
-    phone: string;
-    companyName: string;
-    streetAddress: string;
-    city: string;
-    state: string;
-    zipcode: string;
-    countryCode: string;
-    origin: string;
-    useCount: number;
-    dateModified: string;
-}
-/**
- * Retrieves autofill entries from Chrome's Web Data database.
- *
- * @param options - Filtering and targeting options.
- * @returns Array of autofill entries.
- */
-declare function getAutofillEntries({ chromeDir, profilePath, profile, browser, search, limit, }?: AutofillOptions): AutofillEntry[];
-/**
- * Retrieves saved credit cards from Chrome's Web Data database.
- * Card numbers are encrypted and will be decrypted.
- *
- * @param options - Targeting options.
- * @returns Array of credit card entries.
- */
-declare function getCreditCards({ chromeDir, profilePath, profile, browser, decryptionKey, }?: CreditCardOptions): CreditCardEntry[];
-/**
- * Retrieves saved addresses from Chrome's Web Data database.
- *
- * @param options - Targeting options.
- * @returns Array of address entries.
- */
-declare function getAddresses({ chromeDir, profilePath, profile, browser }?: AddressOptions): AddressEntry[];
-
-interface DownloadOptions extends ResolveProfilesOptions {
-    search?: string;
-    limit?: number;
-}
-interface DownloadEntry {
-    profile: string;
-    targetPath: string;
-    url: string;
-    siteUrl: string;
-    referrer: string;
-    totalBytes: number;
-    receivedBytes: number;
-    mimeType: string;
-    state: string;
-    dangerType: string;
-    opened: boolean;
-    startTime: string;
-    endTime: string;
-}
-/**
- * Retrieves download history from Chrome's History database.
- *
- * @param options - Targeting, filtering, and limit options.
- * @returns Array of download entries.
- */
-declare function getDownloads({ chromeDir, profilePath, profile, browser, search, limit, }?: DownloadOptions): DownloadEntry[];
-
-interface ExtensionOptions extends ResolveProfilesOptions {
-    search?: string;
-}
-interface ExtensionEntry {
-    profile: string;
-    id: string;
-    name: string;
-    version: string;
-    description: string;
-    enabled: boolean;
-    homepageUrl: string;
-    updateUrl: string;
-    installTime: string;
-    fromWebstore: boolean;
-    location: number;
-}
-/**
- * Retrieves installed Chrome extensions from the Preferences JSON file.
- *
- * @param options - Targeting and filtering options.
- * @returns Array of extension entries.
- */
-declare function getExtensions({ chromeDir, profilePath, profile, search, browser, }?: ExtensionOptions): ExtensionEntry[];
-
-interface SearchEngineOptions extends ResolveProfilesOptions {
-}
-interface SearchEngineEntry {
-    profile: string;
-    id: number;
-    name: string;
-    keyword: string;
-    url: string;
-    suggestionsUrl: string;
-    faviconUrl: string;
-    isDefault: boolean;
-    isActive: boolean;
-}
-/**
- * Retrieves search engines configured in Chrome from the Web Data database.
- *
- * @param options - Targeting options.
- * @returns Array of search engine entries.
- */
-declare function getSearchEngines({ chromeDir, profilePath, profile, browser, }?: SearchEngineOptions): SearchEngineEntry[];
-
-interface TopSiteOptions extends ResolveProfilesOptions {
-}
-interface TopSiteEntry {
-    profile: string;
-    url: string;
-    title: string;
-    rank: number;
-    redirects: string;
-}
-/**
- * Retrieves top sites from Chrome's Top Sites database.
- *
- * @param options - Targeting options.
- * @returns Array of top site entries.
- */
-declare function getTopSites({ chromeDir, profilePath, profile, browser }?: TopSiteOptions): TopSiteEntry[];
-
-export { BROWSERS, chromeTimeToDate, clearKeyCache, clearKeychainCache, decryptValue, decryptValueBuffer, deriveEncryptionKey, describePasswordStores, detectInstalledBrowsers, discoverProfiles, getActiveBrowser, getAddresses, getAutofillEntries, getBookmarks, getChromeKeychainPassword, getCookies, getCreditCards, getDefaultChromeDir, getDownloads, getExtensions, getHistory, getKeychainPassword, getKeychainPasswordProvider, getLocalStorage, getPasswords, getPlatformChromeDir, getProfileMetadata, getProfileStates, getSearchEngines, getSearchTerms, getTopSites, listBrowsers, queryDatabase, requireBrowser, resolveBrowser, resolveProfilePath, resolveTargetProfiles, selectPlatform, setActiveBrowser, setKeychainPasswordProvider, tableExists };
-export type { AddressEntry, AddressOptions, AutofillEntry, AutofillOptions, BookmarkEntry, BookmarkOptions, BrowserDescriptor, BrowserId, ChromePlatform, CookieEntry, CookieOptions, CreditCardEntry, CreditCardOptions, DiscoveredProfile, DownloadEntry, DownloadOptions, ExtensionEntry, ExtensionOptions, HistoryEntry, HistoryOptions, InstalledBrowser, KeychainPasswordProvider, LocalStorageEntry, LocalStorageOptions, PasswordEntry, PasswordOptions, PasswordSource, PasswordStoreReport, ProfileMetadata, ProfileState, ResolveProfilesOptions, SearchEngineEntry, SearchEngineOptions, SearchTermEntry, SearchTermOptions, TopSiteEntry, TopSiteOptions };
+ * chrome-tools — Public API
+ *
+ * This module re-exports all feature modules for use as a Node.js library.
+ *
+ * @example
+ * import { getPasswords, getBookmarks, discoverProfiles } from 'chrome-tools';
+ *
+ * const passwords = getPasswords({ profile: 'Default' });
+ * const bookmarks = getBookmarks({ search: 'github' });
+ * const profiles  = discoverProfiles();
+ */
+export { getDefaultChromeDir, discoverProfiles, getProfileMetadata, getProfileStates, resolveProfilePath, resolveTargetProfiles, detectInstalledBrowsers, type DiscoveredProfile, type ProfileMetadata, type ProfileState, type ResolveProfilesOptions, type InstalledBrowser, } from "./chromium/profiles.js";
+export { BROWSERS, listBrowsers, resolveBrowser, requireBrowser, getActiveBrowser, setActiveBrowser, type BrowserId, type BrowserDescriptor, } from "./chromium/browsers.js";
+export { selectPlatform, getPlatformChromeDir, deriveEncryptionKey, decryptValue, decryptValueBuffer, clearKeyCache, type ChromePlatform, } from "./platform/index.js";
+export { getKeychainPassword, getChromeKeychainPassword, clearKeychainCache, setKeychainPasswordProvider, getKeychainPasswordProvider, type KeychainPasswordProvider, } from "./core/keychain.js";
+export { chromeTimeToDate, } from "./core/crypto.js";
+export { queryDatabase, tableExists, } from "./storage/sqlite.js";
+export { describePasswordStores, getPasswords, type PasswordEntry, type PasswordOptions, type PasswordSource, type PasswordStoreReport, } from "./modules/passwords.js";
+export { getBookmarks, type BookmarkEntry, type BookmarkOptions, } from "./modules/bookmarks.js";
+export { getHistory, getSearchTerms, type HistoryEntry, type HistoryOptions, type SearchTermEntry, type SearchTermOptions, } from "./modules/history.js";
+export { getCookies, type CookieEntry, type CookieOptions } from "./modules/cookies.js";
+export { getLocalStorage, type LocalStorageEntry, type LocalStorageOptions } from "./modules/local-storage.js";
+export { getAutofillEntries, getCreditCards, getAddresses, type AddressEntry, type AddressOptions, type AutofillEntry, type AutofillOptions, type CreditCardEntry, type CreditCardOptions, } from "./modules/autofill.js";
+export { getDownloads, type DownloadEntry, type DownloadOptions, } from "./modules/downloads.js";
+export { getExtensions, type ExtensionEntry, type ExtensionOptions, } from "./modules/extensions.js";
+export { getSearchEngines, type SearchEngineEntry, type SearchEngineOptions, } from "./modules/search-engines.js";
+export { getTopSites, type TopSiteEntry, type TopSiteOptions, } from "./modules/top-sites.js";
+export type { ProfileReadDiagnostic, ProfileReadReporter, StoreReadIssue } from "./storage/errors.js";