chrome-tools 1.1.6 → 1.1.8

package/dist/src/modules/downloads.js

@@ -1 +1,80 @@
-import{join as e}from"node:path";import{resolveTargetProfiles as t}from"../core/chrome.js";import{chromeTimeToDate as r}from"../core/crypto.js";import{queryDatabase as o,tableExists as n}from"../core/db.js";const a={0:"in_progress",1:"complete",2:"cancelled",3:"interrupted"},s={0:"not_dangerous",1:"dangerous_file",2:"dangerous_url",3:"dangerous_content",4:"maybe_dangerous_content",5:"uncommon_content",6:"user_validated",7:"dangerous_host",8:"potentially_unwanted",9:"allowlisted_by_policy"};export function getDownloads({chromeDir:i,profile:_,browser:l,search:d,limit:c=100}={}){const m=t({chromeDir:i,profile:_,browser:l}),p=[];for(const t of m){const i=e(t.path,"History");try{if(!n(i,"downloads"))continue;let e="SELECT id, target_path, tab_url, total_bytes, received_bytes,\n                        start_time, end_time, mime_type, original_mime_type,\n                        state, danger_type, opened, referrer, site_url\n                 FROM downloads ORDER BY start_time DESC";c&&(e+=` LIMIT ${parseInt(c,10)}`);const _=o(i,e);for(const e of _){const o={profile:t.name,targetPath:e.target_path||"",url:e.tab_url||"",siteUrl:e.site_url||"",referrer:e.referrer||"",totalBytes:e.total_bytes||0,receivedBytes:e.received_bytes||0,mimeType:e.mime_type||e.original_mime_type||"",state:a[e.state]||`unknown(${e.state})`,dangerType:s[e.danger_type]||`unknown(${e.danger_type})`,opened:Boolean(e.opened),startTime:r(e.start_time||0),endTime:r(e.end_time||0)};if(d){const e=d.toLowerCase();if(!(o.targetPath&&o.targetPath.toLowerCase().includes(e)||o.url&&o.url.toLowerCase().includes(e)))continue}p.push(o)}}catch{}}return p}
+import { join } from "node:path";
+import { resolveTargetProfiles } from "../core/chrome.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";
+/** Maps Chrome download state integers to human-readable strings. */
+const DOWNLOAD_STATES = {
+    0: "in_progress",
+    1: "complete",
+    2: "cancelled",
+    3: "interrupted",
+};
+/** Maps Chrome download danger type integers to strings. */
+const DANGER_TYPES = {
+    0: "not_dangerous",
+    1: "dangerous_file",
+    2: "dangerous_url",
+    3: "dangerous_content",
+    4: "maybe_dangerous_content",
+    5: "uncommon_content",
+    6: "user_validated",
+    7: "dangerous_host",
+    8: "potentially_unwanted",
+    9: "allowlisted_by_policy",
+};
+/**
+ * Retrieves download history from Chrome's History database.
+ *
+ * @param options - Targeting, filtering, and limit options.
+ * @returns Array of download entries.
+ */
+export function getDownloads({ 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, "History");
+        try {
+            // Apply search in SQL before LIMIT so older matches are not truncated away.
+            let sql = `SELECT target_path, tab_url, total_bytes, received_bytes,
+                        start_time, end_time, mime_type, original_mime_type,
+                        state, danger_type, opened, referrer, site_url
+                 FROM downloads`;
+            const params = [];
+            if (search) {
+                sql += ` WHERE IFNULL(target_path, '') LIKE ? ESCAPE '\\'
+                    OR IFNULL(tab_url, '') LIKE ? ESCAPE '\\'`;
+                const like = sqlLikePattern(search);
+                params.push(like, like);
+            }
+            sql += ` ORDER BY start_time DESC`;
+            if (rowLimit) {
+                sql += ` LIMIT ${rowLimit}`;
+            }
+            const rows = queryDatabase(dbPath, sql, params);
+            for (const row of rows) {
+                results.push({
+                    profile: p.name,
+                    targetPath: row.target_path || "",
+                    url: row.tab_url || "",
+                    siteUrl: row.site_url || "",
+                    referrer: row.referrer || "",
+                    totalBytes: row.total_bytes || 0,
+                    receivedBytes: row.received_bytes || 0,
+                    mimeType: row.mime_type || row.original_mime_type || "",
+                    state: DOWNLOAD_STATES[row.state] || `unknown(${row.state})`,
+                    dangerType: DANGER_TYPES[row.danger_type] || `unknown(${row.danger_type})`,
+                    opened: Boolean(row.opened),
+                    startTime: chromeTimeToDate(row.start_time || 0),
+                    endTime: chromeTimeToDate(row.end_time || 0),
+                });
+            }
+        }
+        catch {
+            // Skip profiles with errors
+        }
+    }
+    return limitResults(results, limit);
+}

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

@@ -1,7 +1,5 @@
-export interface ExtensionOptions {
-    chromeDir?: string;
-    profile?: string;
-    browser?: string;
+import { type ResolveProfilesOptions } from "../core/chrome.js";
+export interface ExtensionOptions extends ResolveProfilesOptions {
     search?: string;
 }
 export interface ExtensionEntry {
@@ -23,4 +21,4 @@ export interface ExtensionEntry {
  * @param options - Targeting and filtering options.
  * @returns Array of extension entries.
  */
-export declare function getExtensions({ chromeDir, profile, search, browser }?: ExtensionOptions): ExtensionEntry[];
+export declare function getExtensions({ chromeDir, profilePath, profile, search, browser, }?: ExtensionOptions): ExtensionEntry[];

package/dist/src/modules/extensions.js

@@ -1 +1,71 @@
-import{existsSync as e,readFileSync as o}from"node:fs";import{join as t}from"node:path";import{resolveTargetProfiles as n}from"../core/chrome.js";export function getExtensions({chromeDir:r,profile:i,search:s,browser:c}={}){const a=n({chromeDir:r,profile:i,browser:c}),f=[];for(const n of a){let r=null;for(const i of["Secure Preferences","Preferences"]){const s=t(n.path,i);if(e(s))try{r=JSON.parse(o(s,"utf-8"));break}catch{continue}}if(!r)continue;const i=r?.extensions?.settings;if(i&&"object"==typeof i)for(const[e,o]of Object.entries(i)){const t=o;if(5===t.location||10===t.location)continue;const r=t.manifest||{},i={profile:n.name,id:e,name:r.name||t.name||e,version:r.version||t.version||"unknown",description:r.description||"",enabled:1===t.state,homepageUrl:r.homepage_url||"",updateUrl:r.update_url||"",installTime:t.install_time||"",fromWebstore:t.from_webstore||!1,location:t.location||0};if(i.name.startsWith("__MSG_")&&(i.name=e),i.description.startsWith("__MSG_")&&(i.description=""),s){const e=s.toLowerCase();if(!(i.name&&i.name.toLowerCase().includes(e)||i.id&&i.id.toLowerCase().includes(e)))continue}f.push(i)}}return f}
+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, profilePath, profile, search, browser, } = {}) {
+    const profiles = resolveTargetProfiles({ chromeDir, profilePath, profile, browser });
+    const results = [];
+    for (const p of profiles) {
+        // Prefer Secure Preferences, but continue to Preferences if it has no settings.
+        let settings = null;
+        for (const filename of ["Secure Preferences", "Preferences"]) {
+            const prefsPath = join(p.path, filename);
+            if (existsSync(prefsPath)) {
+                try {
+                    const prefs = JSON.parse(readFileSync(prefsPath, "utf-8"));
+                    const candidate = prefs?.extensions?.settings;
+                    if (candidate && typeof candidate === "object") {
+                        settings = candidate;
+                        break;
+                    }
+                }
+                catch {
+                    continue;
+                }
+            }
+        }
+        if (!settings)
+            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

@@ -1,7 +1,5 @@
-export interface HistoryOptions {
-    chromeDir?: string;
-    profile?: string;
-    browser?: string;
+import { type ResolveProfilesOptions } from "../core/chrome.js";
+export interface HistoryOptions extends ResolveProfilesOptions {
     search?: string;
     limit?: number;
 }
@@ -12,10 +10,7 @@ export interface HistoryEntry {
     visitCount: number;
     lastVisit: string;
 }
-export interface SearchTermOptions {
-    chromeDir?: string;
-    profile?: string;
-    browser?: string;
+export interface SearchTermOptions extends ResolveProfilesOptions {
     limit?: number;
 }
 export interface SearchTermEntry {
@@ -29,11 +24,11 @@ export interface SearchTermEntry {
  * @param options - Filtering and targeting options.
  * @returns Array of history entries.
  */
-export declare function getHistory({ chromeDir, profile, search, limit, browser }?: HistoryOptions): HistoryEntry[];
+export 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.
  */
-export declare function getSearchTerms({ chromeDir, profile, limit, browser }?: SearchTermOptions): SearchTermEntry[];
+export declare function getSearchTerms({ chromeDir, profilePath, profile, limit, browser, }?: SearchTermOptions): SearchTermEntry[];

package/dist/src/modules/history.js

@@ -1 +1,83 @@
-import{join as t}from"node:path";import{resolveTargetProfiles as r}from"../core/chrome.js";import{chromeTimeToDate as o}from"../core/crypto.js";import{queryDatabase as e,tableExists as i}from"../core/db.js";export function getHistory({chromeDir:s,profile:c,search:n,limit:l=100,browser:u}={}){const m=r({chromeDir:s,profile:c,browser:u}),f=[];for(const r of m){const s=t(r.path,"History");try{if(!i(s,"urls"))continue;let t="SELECT url, title, visit_count, last_visit_time\n                 FROM urls ORDER BY last_visit_time DESC";l&&(t+=` LIMIT ${parseInt(l,10)}`);const c=e(s,t);for(const t of c){const e={profile:r.name,url:t.url,title:t.title||"",visitCount:t.visit_count||0,lastVisit:o(t.last_visit_time||0)};if(n){const t=n.toLowerCase();if(!(e.url&&e.url.toLowerCase().includes(t)||e.title&&e.title.toLowerCase().includes(t)))continue}f.push(e)}}catch{}}return f}export function getSearchTerms({chromeDir:o,profile:s,limit:c=100,browser:n}={}){const l=r({chromeDir:o,profile:s,browser:n}),u=[];for(const r of l){const o=t(r.path,"History");try{if(!i(o,"keyword_search_terms"))continue;let t="SELECT kst.term, u.url\n                 FROM keyword_search_terms kst\n                 JOIN urls u ON kst.url_id = u.id\n                 ORDER BY u.last_visit_time DESC";c&&(t+=` LIMIT ${parseInt(c,10)}`);const s=e(o,t);for(const t of s)u.push({profile:r.name,term:t.term||"",url:t.url||""})}catch{}}return u}
+import { join } from "node:path";
+import { resolveTargetProfiles } from "../core/chrome.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 browsing history from Chrome's History database.
+ *
+ * @param options - Filtering and targeting options.
+ * @returns Array of history entries.
+ */
+export function getHistory({ chromeDir, profilePath, profile, search, limit = 100, browser, } = {}) {
+    const profiles = resolveTargetProfiles({ chromeDir, profilePath, profile, browser });
+    const results = [];
+    const rowLimit = normalizeLimit(limit);
+    for (const p of profiles) {
+        const dbPath = join(p.path, "History");
+        try {
+            // Apply search in SQL before LIMIT so older matches are not truncated away.
+            let sql = `SELECT url, title, visit_count, last_visit_time FROM urls`;
+            const params = [];
+            if (search) {
+                sql += ` WHERE url LIKE ? ESCAPE '\\' OR IFNULL(title, '') LIKE ? ESCAPE '\\'`;
+                const like = sqlLikePattern(search);
+                params.push(like, like);
+            }
+            sql += ` ORDER BY last_visit_time DESC`;
+            if (rowLimit) {
+                sql += ` LIMIT ${rowLimit}`;
+            }
+            const rows = queryDatabase(dbPath, sql, params);
+            for (const row of rows) {
+                results.push({
+                    profile: p.name,
+                    url: row.url,
+                    title: row.title || "",
+                    visitCount: row.visit_count || 0,
+                    lastVisit: chromeTimeToDate(row.last_visit_time || 0),
+                });
+            }
+        }
+        catch {
+            // Skip profiles with errors
+        }
+    }
+    return limitResults(results, limit);
+}
+/**
+ * Retrieves search terms from Chrome's History database.
+ *
+ * @param options - Targeting and limit options.
+ * @returns Array of search term entries.
+ */
+export function getSearchTerms({ chromeDir, profilePath, profile, limit = 100, browser, } = {}) {
+    const profiles = resolveTargetProfiles({ chromeDir, profilePath, profile, browser });
+    const results = [];
+    const rowLimit = normalizeLimit(limit);
+    for (const p of profiles) {
+        const dbPath = join(p.path, "History");
+        try {
+            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 (rowLimit) {
+                sql += ` LIMIT ${rowLimit}`;
+            }
+            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 limitResults(results, limit);
+}

package/dist/src/modules/local-storage.d.ts

@@ -1,7 +1,5 @@
-export interface LocalStorageOptions {
-    chromeDir?: string;
-    profile?: string;
-    browser?: string;
+import { type ResolveProfilesOptions } from "../core/chrome.js";
+export interface LocalStorageOptions extends ResolveProfilesOptions {
     origin?: string;
     url?: string;
     key?: string;
@@ -26,7 +24,7 @@ interface RawLevelDBRecord {
  * @param options - Targeting and filtering options.
  * @returns Array of localStorage entries.
  */
-export declare function getLocalStorage({ chromeDir, profile, browser, origin, url, key, search, limit, }?: LocalStorageOptions): LocalStorageEntry[];
+export declare function getLocalStorage({ chromeDir, profilePath, profile, browser, origin, url, key, search, limit, }?: LocalStorageOptions): LocalStorageEntry[];
 declare function parseLocalStorageRecord(rawKey: Buffer, rawValue: Buffer): {
     origin: string;
     key: string;