chrome-tools 1.1.6 → 1.1.8

package/dist/src/core/sql.js

@@ -0,0 +1,4 @@
+/** Builds a SQL LIKE pattern with wildcard characters escaped for literal matching. */
+export function sqlLikePattern(term) {
+    return `%${term.replace(/([%_\\])/g, "\\$1")}%`;
+}

package/dist/src/index.d.ts

@@ -11,7 +11,7 @@
  * const profiles  = discoverProfiles();
  */
 export { getDefaultChromeDir, discoverProfiles, getProfileMetadata, getProfileStates, resolveProfilePath, resolveTargetProfiles, detectInstalledBrowsers, type DiscoveredProfile, type ProfileMetadata, type ProfileState, type ResolveProfilesOptions, type InstalledBrowser, } from "./core/chrome.js";
-export { BROWSERS, listBrowsers, resolveBrowser, getActiveBrowser, setActiveBrowser, type BrowserId, type BrowserDescriptor, } from "./core/browsers.js";
+export { BROWSERS, listBrowsers, resolveBrowser, requireBrowser, getActiveBrowser, setActiveBrowser, type BrowserId, type BrowserDescriptor, } from "./core/browsers.js";
 export { selectPlatform, getPlatformChromeDir, deriveEncryptionKey, decryptValue, decryptValueBuffer, clearKeyCache, type ChromePlatform, } from "./core/platform/index.js";
 export { getKeychainPassword, getChromeKeychainPassword, clearKeychainCache, setKeychainPasswordProvider, getKeychainPasswordProvider, type KeychainPasswordProvider, } from "./core/keychain.js";
 export { chromeTimeToDate, } from "./core/crypto.js";

package/dist/src/index.js

@@ -1 +1,34 @@
-export{getDefaultChromeDir,discoverProfiles,getProfileMetadata,getProfileStates,resolveProfilePath,resolveTargetProfiles,detectInstalledBrowsers}from"./core/chrome.js";export{BROWSERS,listBrowsers,resolveBrowser,getActiveBrowser,setActiveBrowser}from"./core/browsers.js";export{selectPlatform,getPlatformChromeDir,deriveEncryptionKey,decryptValue,decryptValueBuffer,clearKeyCache}from"./core/platform/index.js";export{getKeychainPassword,getChromeKeychainPassword,clearKeychainCache,setKeychainPasswordProvider,getKeychainPasswordProvider}from"./core/keychain.js";export{chromeTimeToDate}from"./core/crypto.js";export{queryDatabase,tableExists}from"./core/db.js";export{getPasswords}from"./modules/passwords.js";export{getBookmarks}from"./modules/bookmarks.js";export{getHistory,getSearchTerms}from"./modules/history.js";export{getCookies}from"./modules/cookies.js";export{getLocalStorage}from"./modules/local-storage.js";export{getAutofillEntries,getCreditCards,getAddresses}from"./modules/autofill.js";export{getDownloads}from"./modules/downloads.js";export{getExtensions}from"./modules/extensions.js";export{getSearchEngines}from"./modules/search-engines.js";export{getTopSites}from"./modules/top-sites.js";
+/**
+ * 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();
+ */
+// Core utilities
+export { getDefaultChromeDir, discoverProfiles, getProfileMetadata, getProfileStates, resolveProfilePath, resolveTargetProfiles, detectInstalledBrowsers, } from "./core/chrome.js";
+// Browser registry & selection (all Chromium-based browsers)
+export { BROWSERS, listBrowsers, resolveBrowser, requireBrowser, getActiveBrowser, setActiveBrowser, } from "./core/browsers.js";
+// Platform-aware decryption (macOS / Windows / Linux)
+export { selectPlatform, getPlatformChromeDir, deriveEncryptionKey, decryptValue, decryptValueBuffer, clearKeyCache, } from "./core/platform/index.js";
+// macOS Keychain helpers (macOS-only). `getKeychainPassword` takes a Safe
+// Storage service name; `getChromeKeychainPassword` is the Chrome-specific alias.
+export { getKeychainPassword, getChromeKeychainPassword, clearKeychainCache, setKeychainPasswordProvider, getKeychainPasswordProvider, } from "./core/keychain.js";
+export { chromeTimeToDate, } from "./core/crypto.js";
+export { queryDatabase, tableExists, } from "./core/db.js";
+// Feature modules
+export { getPasswords } from "./modules/passwords.js";
+export { getBookmarks } from "./modules/bookmarks.js";
+export { getHistory, getSearchTerms } from "./modules/history.js";
+export { getCookies } from "./modules/cookies.js";
+export { getLocalStorage } from "./modules/local-storage.js";
+export { getAutofillEntries, getCreditCards, getAddresses } from "./modules/autofill.js";
+export { getDownloads } from "./modules/downloads.js";
+export { getExtensions } from "./modules/extensions.js";
+export { getSearchEngines } from "./modules/search-engines.js";
+export { getTopSites } from "./modules/top-sites.js";

package/dist/src/modules/autofill.d.ts

@@ -1,7 +1,5 @@
-export interface AutofillOptions {
-    chromeDir?: string;
-    profile?: string;
-    browser?: string;
+import { type ResolveProfilesOptions } from "../core/chrome.js";
+export interface AutofillOptions extends ResolveProfilesOptions {
     search?: string;
     limit?: number;
 }
@@ -13,10 +11,7 @@ export interface AutofillEntry {
     dateLastUsed: string;
     count: number;
 }
-export interface CreditCardOptions {
-    chromeDir?: string;
-    profile?: string;
-    browser?: string;
+export interface CreditCardOptions extends ResolveProfilesOptions {
     decryptionKey?: Buffer;
 }
 export interface CreditCardEntry {
@@ -31,10 +26,7 @@ export interface CreditCardEntry {
     useCount: number;
     dateModified: string;
 }
-export interface AddressOptions {
-    chromeDir?: string;
-    profile?: string;
-    browser?: string;
+export interface AddressOptions extends ResolveProfilesOptions {
 }
 export interface AddressEntry {
     profile: string;
@@ -58,7 +50,7 @@ export interface AddressEntry {
  * @param options - Filtering and targeting options.
  * @returns Array of autofill entries.
  */
-export declare function getAutofillEntries({ chromeDir, profile, browser, search, limit, }?: AutofillOptions): AutofillEntry[];
+export 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.
@@ -66,11 +58,11 @@ export declare function getAutofillEntries({ chromeDir, profile, browser, search
  * @param options - Targeting options.
  * @returns Array of credit card entries.
  */
-export declare function getCreditCards({ chromeDir, profile, browser, decryptionKey }?: CreditCardOptions): CreditCardEntry[];
+export 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.
  */
-export declare function getAddresses({ chromeDir, profile, browser }?: AddressOptions): AddressEntry[];
+export declare function getAddresses({ chromeDir, profilePath, profile, browser }?: AddressOptions): AddressEntry[];

package/dist/src/modules/autofill.js

@@ -1 +1,170 @@
-import{join as e}from"node:path";import{resolveTargetProfiles as t}from"../core/chrome.js";import{deriveEncryptionKey as o,decryptValue as n}from"../core/platform/index.js";import{chromeTimeToDate as r}from"../core/crypto.js";import{queryDatabase as i,tableExists as a}from"../core/db.js";export function getAutofillEntries({chromeDir:o,profile:n,browser:d,search:c,limit:s=100}={}){const u=t({chromeDir:o,profile:n,browser:d}),l=[];for(const t of u){const o=e(t.path,"Web Data");try{if(!a(o,"autofill"))continue;let e="SELECT name, value, date_created, date_last_used, count\n                 FROM autofill ORDER BY date_last_used DESC";s&&(e+=` LIMIT ${parseInt(s,10)}`);const n=i(o,e);for(const e of n){const o={profile:t.name,name:e.name||"",value:e.value||"",dateCreated:r(e.date_created?1000000n*BigInt(e.date_created)+11644473600000000n:0),dateLastUsed:r(e.date_last_used?1000000n*BigInt(e.date_last_used)+11644473600000000n:0),count:e.count||0};if(c){const e=c.toLowerCase();if(!(o.name&&o.name.toLowerCase().includes(e)||o.value&&o.value.toLowerCase().includes(e)))continue}l.push(o)}}catch{}}return l}export function getCreditCards({chromeDir:d,profile:c,browser:s,decryptionKey:u}={}){const l=t({chromeDir:d,profile:c,browser:s}),f=u||o(),m=[];for(const t of l){const o=e(t.path,"Web Data");try{if(!a(o,"credit_cards"))continue;const e=i(o,"SELECT guid, name_on_card, expiration_month, expiration_year,\n                card_number_encrypted, date_modified, origin, use_count,\n                use_date, nickname\n         FROM credit_cards ORDER BY use_date DESC");for(const o of e){let e="";o.card_number_encrypted&&(e=n(o.card_number_encrypted,f)),m.push({profile:t.name,guid:o.guid||"",nameOnCard:o.name_on_card||"",expirationMonth:o.expiration_month||0,expirationYear:o.expiration_year||0,cardNumber:e,nickname:o.nickname||"",origin:o.origin||"",useCount:o.use_count||0,dateModified:r(o.date_modified?1000000n*BigInt(o.date_modified)+11644473600000000n:0)})}}catch{}}return m}export function getAddresses({chromeDir:o,profile:n,browser:d}={}){const c=t({chromeDir:o,profile:n,browser:d}),s=[];for(const t of c){const o=e(t.path,"Web Data");try{if(!a(o,"autofill_profiles"))continue;const e=i(o,"SELECT guid, company_name, street_address, dependent_locality,\n                city, state, zipcode, country_code, date_modified,\n                origin, use_count, use_date, language_code\n         FROM autofill_profiles ORDER BY use_date DESC");let n=[],d=[],c=[];try{a(o,"autofill_profile_names")&&(n=i(o,"SELECT guid, first_name, middle_name, last_name, full_name FROM autofill_profile_names"))}catch{}try{a(o,"autofill_profile_emails")&&(d=i(o,"SELECT guid, email FROM autofill_profile_emails"))}catch{}try{a(o,"autofill_profile_phones")&&(c=i(o,"SELECT guid, number FROM autofill_profile_phones"))}catch{}const u=new Map;for(const e of n)u.set(e.guid,e.full_name||[e.first_name,e.middle_name,e.last_name].filter(Boolean).join(" "));const l=new Map;for(const e of d)l.set(e.guid,e.email||"");const f=new Map;for(const e of c)f.set(e.guid,e.number||"");for(const o of e)s.push({profile:t.name,guid:o.guid||"",fullName:u.get(o.guid)||"",email:l.get(o.guid)||"",phone:f.get(o.guid)||"",companyName:o.company_name||"",streetAddress:o.street_address||"",city:o.city||"",state:o.state||"",zipcode:o.zipcode||"",countryCode:o.country_code||"",origin:o.origin||"",useCount:o.use_count||0,dateModified:r(o.date_modified?1000000n*BigInt(o.date_modified)+11644473600000000n:0)})}catch{}}return s}
+import { join } from "node:path";
+import { resolveTargetProfiles } from "../core/chrome.js";
+import { deriveEncryptionKey, decryptValue } from "../core/platform/index.js";
+import { chromeTimeToDate } from "../core/crypto.js";
+import { queryDatabase } from "../core/db.js";
+import { limitResults, normalizeLimit } from "../core/limit.js";
+import { sqlLikePattern } from "../core/sql.js";
+/**
+ * Retrieves autofill entries from Chrome's Web Data database.
+ *
+ * @param options - Filtering and targeting options.
+ * @returns Array of autofill entries.
+ */
+export function getAutofillEntries({ chromeDir, profilePath, profile, browser, search, limit = 100, } = {}) {
+    const profiles = resolveTargetProfiles({ chromeDir, profilePath, profile, browser });
+    const results = [];
+    const rowLimit = normalizeLimit(limit);
+    for (const p of profiles) {
+        const dbPath = join(p.path, "Web Data");
+        try {
+            // Apply search in SQL before LIMIT so older matches are not truncated away.
+            let sql = `SELECT name, value, date_created, date_last_used, count FROM autofill`;
+            const params = [];
+            if (search) {
+                sql += ` WHERE IFNULL(name, '') LIKE ? ESCAPE '\\' OR IFNULL(value, '') LIKE ? ESCAPE '\\'`;
+                const like = sqlLikePattern(search);
+                params.push(like, like);
+            }
+            sql += ` ORDER BY date_last_used DESC`;
+            if (rowLimit) {
+                sql += ` LIMIT ${rowLimit}`;
+            }
+            const rows = queryDatabase(dbPath, sql, params);
+            for (const row of rows) {
+                results.push({
+                    profile: p.name,
+                    name: row.name || "",
+                    value: row.value || "",
+                    dateCreated: chromeTimeToDate(row.date_created ? BigInt(row.date_created) * 1000000n + 11644473600000000n : 0),
+                    dateLastUsed: chromeTimeToDate(row.date_last_used ? BigInt(row.date_last_used) * 1000000n + 11644473600000000n : 0),
+                    count: row.count || 0,
+                });
+            }
+        }
+        catch {
+            // Skip profiles with errors
+        }
+    }
+    return limitResults(results, limit);
+}
+/**
+ * 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.
+ */
+export function getCreditCards({ chromeDir, profilePath, profile, browser, decryptionKey, } = {}) {
+    const userDataDir = profilePath || chromeDir;
+    const profiles = resolveTargetProfiles({ chromeDir, profilePath, profile, browser });
+    // Pass user-data dir so Windows reads Local State from the same tree as the profiles.
+    let derivedKey = decryptionKey;
+    const results = [];
+    for (const p of profiles) {
+        const dbPath = join(p.path, "Web Data");
+        try {
+            const rows = queryDatabase(dbPath, `SELECT guid, name_on_card, expiration_month, expiration_year,
+                card_number_encrypted, date_modified, origin, use_count,
+                nickname
+         FROM credit_cards ORDER BY use_date DESC`);
+            for (const row of rows) {
+                let cardNumber = "";
+                if (row.card_number_encrypted?.length > 0) {
+                    cardNumber = decryptValue(row.card_number_encrypted, derivedKey ??= deriveEncryptionKey(userDataDir, browser));
+                }
+                results.push({
+                    profile: p.name,
+                    guid: row.guid || "",
+                    nameOnCard: row.name_on_card || "",
+                    expirationMonth: row.expiration_month || 0,
+                    expirationYear: row.expiration_year || 0,
+                    cardNumber,
+                    nickname: row.nickname || "",
+                    origin: row.origin || "",
+                    useCount: row.use_count || 0,
+                    dateModified: chromeTimeToDate(row.date_modified ? BigInt(row.date_modified) * 1000000n + 11644473600000000n : 0),
+                });
+            }
+        }
+        catch {
+            // Skip profiles with errors
+        }
+    }
+    return results;
+}
+/**
+ * Retrieves saved addresses from Chrome's Web Data database.
+ *
+ * @param options - Targeting options.
+ * @returns Array of address entries.
+ */
+export function getAddresses({ chromeDir, profilePath, profile, browser } = {}) {
+    const profiles = resolveTargetProfiles({ chromeDir, profilePath, profile, browser });
+    const results = [];
+    for (const p of profiles) {
+        const dbPath = join(p.path, "Web Data");
+        try {
+            const profileRows = queryDatabase(dbPath, `SELECT guid, company_name, street_address,
+                city, state, zipcode, country_code, date_modified,
+                origin, use_count
+         FROM autofill_profiles ORDER BY use_date DESC`);
+            // Try to join with names, emails, and phones
+            let nameRows = [];
+            let emailRows = [];
+            let phoneRows = [];
+            try {
+                nameRows = queryDatabase(dbPath, `SELECT guid, first_name, middle_name, last_name, full_name FROM autofill_profile_names`);
+            }
+            catch {
+                /* ignore */
+            }
+            try {
+                emailRows = queryDatabase(dbPath, `SELECT guid, email FROM autofill_profile_emails`);
+            }
+            catch {
+                /* ignore */
+            }
+            try {
+                phoneRows = queryDatabase(dbPath, `SELECT guid, number FROM autofill_profile_phones`);
+            }
+            catch {
+                /* ignore */
+            }
+            const nameMap = new Map();
+            for (const n of nameRows) {
+                nameMap.set(n.guid, n.full_name || [n.first_name, n.middle_name, n.last_name].filter(Boolean).join(" "));
+            }
+            const emailMap = new Map();
+            for (const e of emailRows) {
+                emailMap.set(e.guid, e.email || "");
+            }
+            const phoneMap = new Map();
+            for (const ph of phoneRows) {
+                phoneMap.set(ph.guid, ph.number || "");
+            }
+            for (const row of profileRows) {
+                results.push({
+                    profile: p.name,
+                    guid: row.guid || "",
+                    fullName: nameMap.get(row.guid) || "",
+                    email: emailMap.get(row.guid) || "",
+                    phone: phoneMap.get(row.guid) || "",
+                    companyName: row.company_name || "",
+                    streetAddress: row.street_address || "",
+                    city: row.city || "",
+                    state: row.state || "",
+                    zipcode: row.zipcode || "",
+                    countryCode: row.country_code || "",
+                    origin: row.origin || "",
+                    useCount: row.use_count || 0,
+                    dateModified: chromeTimeToDate(row.date_modified ? BigInt(row.date_modified) * 1000000n + 11644473600000000n : 0),
+                });
+            }
+        }
+        catch {
+            // Skip profiles with errors
+        }
+    }
+    return results;
+}

package/dist/src/modules/bookmarks.d.ts

@@ -1,7 +1,5 @@
-export interface BookmarkOptions {
-    chromeDir?: string;
-    profile?: string;
-    browser?: string;
+import { type ResolveProfilesOptions } from "../core/chrome.js";
+export interface BookmarkOptions extends ResolveProfilesOptions {
     folder?: string;
     search?: string;
 }
@@ -21,4 +19,4 @@ export interface BookmarkEntry {
  * @param options - Options for filtering and targeting.
  * @returns Filtered bookmark entries.
  */
-export declare function getBookmarks({ chromeDir, profile, folder, search, browser }?: BookmarkOptions): BookmarkEntry[];
+export declare function getBookmarks({ chromeDir, profilePath, profile, folder, search, browser, }?: BookmarkOptions): BookmarkEntry[];

package/dist/src/modules/bookmarks.js

@@ -1 +1,83 @@
-import{existsSync as o,readFileSync as r}from"node:fs";import{join as e}from"node:path";import{resolveTargetProfiles as t}from"../core/chrome.js";import{chromeTimeToDate as s}from"../core/crypto.js";function n(o){return o&&"0"!==o?s(BigInt(o)):"N/A"}function i(o,r=""){const e=[];if(!o)return e;const t=r?`${r}/${o.name||""}`:o.name||"";if("url"===o.type&&e.push({title:o.name||"",url:o.url||"",folder:r,dateAdded:n(o.date_added),dateLastUsed:n(o.date_last_used),id:o.id,guid:o.guid||""}),o.children&&Array.isArray(o.children))for(const r of o.children)e.push(...i(r,t));return e}export function getBookmarks({chromeDir:s,profile:n,folder:c,search:f,browser:d}={}){const a=t({chromeDir:s,profile:n,browser:d}),l=[];for(const t of a){const s=e(t.path,"Bookmarks");if(o(s))try{const o=r(s,"utf-8"),e=JSON.parse(o).roots;if(!e)continue;const n=["bookmark_bar","other","synced"];for(const o of n)if(e[o]){const r=i(e[o],"");for(const o of r)o.profile=t.name,l.push(o)}}catch{}}let u=l;if(c){const o=c.toLowerCase();u=u.filter(r=>r.folder.toLowerCase().includes(o))}if(f){const o=f.toLowerCase();u=u.filter(r=>r.title.toLowerCase().includes(o)||r.url.toLowerCase().includes(o))}return u}
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { resolveTargetProfiles } from "../core/chrome.js";
+import { chromeTimeToDate } from "../core/crypto.js";
+/**
+ * Recursively flattens the bookmark tree into a flat array.
+ *
+ * @param node - Bookmark tree node.
+ * @param folderPath - Current folder path for context.
+ * @returns Array of flattened bookmark entries.
+ */
+function flattenBookmarks(node, folderPath = "") {
+    const results = [];
+    if (!node)
+        return results;
+    const currentPath = folderPath
+        ? `${folderPath}/${node.name || ""}`
+        : node.name || "";
+    if (node.type === "url") {
+        results.push({
+            title: node.name || "",
+            url: node.url || "",
+            folder: folderPath,
+            dateAdded: chromeTimeToDate(node.date_added),
+            dateLastUsed: chromeTimeToDate(node.date_last_used),
+            id: node.id,
+            guid: node.guid || "",
+        });
+    }
+    if (node.children && Array.isArray(node.children)) {
+        for (const child of node.children) {
+            results.push(...flattenBookmarks(child, currentPath));
+        }
+    }
+    return results;
+}
+/**
+ * Reads and parses bookmarks from Chrome's Bookmarks JSON file.
+ *
+ * @param options - Options for filtering and targeting.
+ * @returns Filtered bookmark entries.
+ */
+export function getBookmarks({ chromeDir, profilePath, profile, folder, search, browser, } = {}) {
+    const profiles = resolveTargetProfiles({ chromeDir, profilePath, profile, browser });
+    const results = [];
+    for (const p of profiles) {
+        const bookmarksPath = join(p.path, "Bookmarks");
+        if (!existsSync(bookmarksPath))
+            continue;
+        try {
+            const raw = readFileSync(bookmarksPath, "utf-8");
+            const data = JSON.parse(raw);
+            const roots = data.roots;
+            if (!roots)
+                continue;
+            // Flatten all root bookmark folders
+            const rootNames = ["bookmark_bar", "other", "synced"];
+            for (const rootName of rootNames) {
+                if (roots[rootName]) {
+                    const bookmarks = flattenBookmarks(roots[rootName], "");
+                    for (const bm of bookmarks) {
+                        bm.profile = p.name;
+                        results.push(bm);
+                    }
+                }
+            }
+        }
+        catch {
+            // Skip profiles with parse errors
+        }
+    }
+    let filtered = results;
+    if (folder) {
+        const term = folder.toLowerCase();
+        filtered = filtered.filter((b) => b.folder.toLowerCase().includes(term));
+    }
+    if (search) {
+        const term = search.toLowerCase();
+        filtered = filtered.filter((b) => b.title.toLowerCase().includes(term) ||
+            b.url.toLowerCase().includes(term));
+    }
+    return filtered;
+}

package/dist/src/modules/cookies.d.ts

@@ -1,7 +1,5 @@
-export interface CookieOptions {
-    chromeDir?: string;
-    profile?: string;
-    browser?: string;
+import { type ResolveProfilesOptions } from "../core/chrome.js";
+export interface CookieOptions extends ResolveProfilesOptions {
     domain?: string;
     url?: string;
     decrypt?: boolean;
@@ -32,7 +30,7 @@ declare function pathMatch(urlPath: string, cookiePath: string): boolean;
  * @param options - Targeting and filtering options.
  * @returns Array of cookie entries.
  */
-export declare function getCookies({ chromeDir, profile, browser, domain, url, decrypt, limit, decryptionKey, }?: CookieOptions): CookieEntry[];
+export declare function getCookies({ chromeDir, profilePath, profile, browser, domain, url, decrypt, limit, decryptionKey, }?: CookieOptions): CookieEntry[];
 export declare const _test: {
     parseURL: typeof parseURL;
     getPossibleHostKeys: typeof getPossibleHostKeys;

package/dist/src/modules/cookies.js

@@ -1 +1,157 @@
-import{join as t}from"node:path";import{createHash as e}from"node:crypto";import{resolveTargetProfiles as o}from"../core/chrome.js";import{deriveEncryptionKey as n,decryptValueBuffer as s}from"../core/platform/index.js";import{chromeTimeToDate as r}from"../core/crypto.js";import{queryDatabase as i,tableExists as c}from"../core/db.js";function a(t,o,n){const r=s(t,o);if(!Buffer.isBuffer(r))return r;const i=e("sha256").update(n).digest();return(r.length>=i.length&&r.subarray(0,i.length).equals(i)?r.subarray(i.length):r).toString("utf-8")}function u(t){if(!t)return null;try{return new URL(t)}catch{try{if(!/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(t))return new URL("https://"+t)}catch{}}return null}function p(t){const e=new Set;e.add(t),e.add("."+t);const o=t.split(".");for(let t=1;t<o.length;t++){const n=o.slice(t).join(".");e.add(n),e.add("."+n)}return Array.from(e)}function h(t,e){return t===e||!(!e.startsWith(".")||t!==e.slice(1)&&!t.endsWith(e))}function l(t,e){const o=t||"/",n=e||"/";return"/"===n||(o===n||!(!o.startsWith(n)||!n.endsWith("/")&&"/"!==o[n.length]))}export function getCookies({chromeDir:e,profile:s,browser:f,domain:m,url:d,decrypt:y=!0,limit:_=100,decryptionKey:g}={}){const k=o({chromeDir:e,profile:s,browser:f}),j=y?g||n():null,x=[],R=u(d);for(const e of k){const o=t(e.path,"Cookies");try{if(!c(o,"cookies"))continue;let t="SELECT host_key, name, value, encrypted_value, path,\n                        expires_utc, is_secure, is_httponly, samesite,\n                        creation_utc, last_access_utc\n                 FROM cookies";const n=[],s=[];if(m)n.push("host_key LIKE ?"),s.push(`%${m}%`);else if(R){const t=p(R.hostname),e=t.map(()=>"?").join(", ");n.push(`host_key IN (${e})`),s.push(...t)}n.length>0&&(t+=` WHERE ${n.join(" AND ")}`),t+=" ORDER BY host_key, name",_&&!d&&(t+=` LIMIT ${parseInt(_,10)}`);const u=i(o,t,s);for(const t of u){if(R){if(!h(R.hostname,t.host_key||""))continue;if(!l(R.pathname||"/",t.path||"/"))continue;if(t.is_secure&&"https:"!==R.protocol)continue}let o=t.value||"";!o&&t.encrypted_value&&j&&(o=a(t.encrypted_value,j,t.host_key||"")),x.push({profile:e.name,domain:t.host_key||"",name:t.name||"",value:o,path:t.path||"/",expires:r(t.expires_utc||0),secure:Boolean(t.is_secure),httpOnly:Boolean(t.is_httponly),sameSite:["unspecified","lax","strict","none"][t.samesite]||"unspecified",created:r(t.creation_utc||0),lastAccessed:r(t.last_access_utc||0)})}}catch{}}return _&&d?x.slice(0,parseInt(_,10)):x}export const _test={parseURL:u,getPossibleHostKeys:p,domainMatch:h,pathMatch:l};
+import { join } from "node:path";
+import { createHash } from "node:crypto";
+import { resolveTargetProfiles } from "../core/chrome.js";
+import { deriveEncryptionKey, decryptValueBuffer } from "../core/platform/index.js";
+import { chromeTimeToDate } from "../core/crypto.js";
+import { queryDatabase } from "../core/db.js";
+import { limitResults, normalizeLimit } from "../core/limit.js";
+function decodeCookieValue(encryptedValue, derivedKey, hostKey) {
+    const decrypted = decryptValueBuffer(encryptedValue, derivedKey);
+    if (!Buffer.isBuffer(decrypted)) {
+        return decrypted;
+    }
+    const hostHash = createHash("sha256").update(hostKey).digest();
+    const valueBytes = decrypted.length >= hostHash.length && decrypted.subarray(0, hostHash.length).equals(hostHash)
+        ? decrypted.subarray(hostHash.length)
+        : decrypted;
+    return valueBytes.toString("utf-8");
+}
+function parseURL(urlStr) {
+    if (!urlStr)
+        return null;
+    try {
+        return new URL(urlStr);
+    }
+    catch {
+        try {
+            // If it doesn't have a protocol, prepend https://
+            if (!/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(urlStr)) {
+                return new URL("https://" + urlStr);
+            }
+        }
+        catch {
+            // Ignore
+        }
+    }
+    return null;
+}
+function getPossibleHostKeys(hostname) {
+    const keys = new Set();
+    keys.add(hostname);
+    keys.add("." + hostname);
+    const parts = hostname.split(".");
+    for (let i = 1; i < parts.length; i++) {
+        const suffix = parts.slice(i).join(".");
+        keys.add(suffix);
+        keys.add("." + suffix);
+    }
+    return Array.from(keys);
+}
+function domainMatch(hostname, hostKey) {
+    if (hostname === hostKey) {
+        return true;
+    }
+    if (hostKey.startsWith(".")) {
+        if (hostname === hostKey.slice(1) || hostname.endsWith(hostKey)) {
+            return true;
+        }
+    }
+    return false;
+}
+function pathMatch(urlPath, cookiePath) {
+    const uPath = urlPath || "/";
+    const cPath = cookiePath || "/";
+    if (cPath === "/") {
+        return true;
+    }
+    if (uPath === cPath) {
+        return true;
+    }
+    if (uPath.startsWith(cPath)) {
+        if (cPath.endsWith("/") || uPath[cPath.length] === "/") {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * 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.
+ */
+export function getCookies({ chromeDir, profilePath, profile, browser, domain, url, decrypt = true, limit = 100, decryptionKey, } = {}) {
+    const userDataDir = profilePath || chromeDir;
+    const profiles = resolveTargetProfiles({ chromeDir, profilePath, profile, browser });
+    let derivedKey = decryptionKey;
+    const results = [];
+    const parsedUrl = parseURL(url);
+    const rowLimit = normalizeLimit(limit);
+    for (const p of profiles) {
+        const dbPath = join(p.path, "Cookies");
+        try {
+            let sql = `SELECT host_key, name, value, encrypted_value, path,
+                        expires_utc, is_secure, is_httponly, samesite,
+                        creation_utc, last_access_utc
+                 FROM cookies`;
+            const conditions = [];
+            const params = [];
+            if (domain) {
+                conditions.push(`host_key LIKE ?`);
+                params.push(`%${domain}%`);
+            }
+            else if (parsedUrl) {
+                const hostKeys = getPossibleHostKeys(parsedUrl.hostname);
+                const placeholders = hostKeys.map(() => "?").join(", ");
+                conditions.push(`host_key IN (${placeholders})`);
+                params.push(...hostKeys);
+            }
+            if (conditions.length > 0) {
+                sql += ` WHERE ${conditions.join(" AND ")}`;
+            }
+            sql += ` ORDER BY host_key, name`;
+            if (rowLimit && !url) {
+                sql += ` LIMIT ${rowLimit}`;
+            }
+            const rows = queryDatabase(dbPath, sql, params);
+            for (const row of rows) {
+                if (parsedUrl) {
+                    if (!domainMatch(parsedUrl.hostname, row.host_key || ""))
+                        continue;
+                    if (!pathMatch(parsedUrl.pathname || "/", row.path || "/"))
+                        continue;
+                    if (row.is_secure && parsedUrl.protocol !== "https:")
+                        continue;
+                }
+                let cookieValue = row.value || "";
+                if (!cookieValue && row.encrypted_value?.length > 0 && decrypt) {
+                    cookieValue = decodeCookieValue(row.encrypted_value, derivedKey ??= deriveEncryptionKey(userDataDir, browser), row.host_key || "");
+                }
+                results.push({
+                    profile: p.name,
+                    domain: row.host_key || "",
+                    name: row.name || "",
+                    value: cookieValue,
+                    path: row.path || "/",
+                    expires: chromeTimeToDate(row.expires_utc || 0),
+                    secure: Boolean(row.is_secure),
+                    httpOnly: Boolean(row.is_httponly),
+                    sameSite: ["unspecified", "lax", "strict", "none"][row.samesite] || "unspecified",
+                    created: chromeTimeToDate(row.creation_utc || 0),
+                    lastAccessed: chromeTimeToDate(row.last_access_utc || 0),
+                });
+            }
+        }
+        catch {
+            // Skip profiles with errors
+        }
+    }
+    return limitResults(results, limit);
+}
+export const _test = {
+    parseURL,
+    getPossibleHostKeys,
+    domainMatch,
+    pathMatch,
+};

package/dist/src/modules/downloads.d.ts

@@ -1,7 +1,5 @@
-export interface DownloadOptions {
-    chromeDir?: string;
-    profile?: string;
-    browser?: string;
+import { type ResolveProfilesOptions } from "../core/chrome.js";
+export interface DownloadOptions extends ResolveProfilesOptions {
     search?: string;
     limit?: number;
 }
@@ -26,4 +24,4 @@ export interface DownloadEntry {
  * @param options - Targeting, filtering, and limit options.
  * @returns Array of download entries.
  */
-export declare function getDownloads({ chromeDir, profile, browser, search, limit, }?: DownloadOptions): DownloadEntry[];
+export declare function getDownloads({ chromeDir, profilePath, profile, browser, search, limit, }?: DownloadOptions): DownloadEntry[];