@chronicle.app/chrome 0.4.0 → 0.5.0

package/dist/connectors/ChromeExtractor.d.ts

@@ -1,4 +1,4 @@
-import { Record } from '@chronicle.app/etl';
+import { Record, type Survey, type SurveyOptions } from '@chronicle.app/etl';
 import { SqliteExtractor } from '@chronicle.app/etl-sqlite';
 import ChromeTransformer from './ChromeTransformer.js';
 /** A link followed or a form submitted, from one page to the visit's. */
@@ -59,5 +59,7 @@ export declare class ChromeExtractor extends SqliteExtractor<typeof ChromeExtrac
     private navigation;
     private visit;
     determineCount(): Promise<number | null>;
+    /** The visits a run reads and when, with how many pages they were to. */
+    survey(options?: SurveyOptions): Promise<Survey | null>;
 }
 //# sourceMappingURL=ChromeExtractor.d.ts.map

package/dist/connectors/ChromeExtractor.js

@@ -1,8 +1,8 @@
 import { constants as fsConstants, copyFileSync, mkdtempSync, rmSync, statSync } from 'node:fs';
 import { homedir, tmpdir } from 'node:os';
 import { dirname, join } from 'node:path';
-import { EXIT_CODES, ExtractorError, delay } from '@chronicle.app/etl';
-import { SqliteExtractor, allRows, chromeToUnixMsSql, getRow, iterateRows, timeRangeConditions, unixMsToChromeTimestamp, } from '@chronicle.app/etl-sqlite';
+import { EXIT_CODES, ExtractorError, delay, } from '@chronicle.app/etl';
+import { SqliteExtractor, allRows, chromeToUnixMsSql, countsByMonth, getRow, iterateRows, monthSql, timeRangeConditions, unixMsToChromeTimestamp, } from '@chronicle.app/etl-sqlite';
 import { z } from 'zod';
 import ChromeTransformer from './ChromeTransformer.js';
 import { readChromeAccount } from './profile.js';
@@ -251,6 +251,30 @@ export class ChromeExtractor extends SqliteExtractor {
             return null;
         }
     }
+    /** The visits a run reads and when, with how many pages they were to. */
+    async survey(options = {}) {
+        if (!this.db)
+            return null;
+        const { where, values } = this.visitFilter();
+        const row = this.db
+            .prepare(`SELECT COUNT(*) AS n, MIN(${visitTime}) AS first, MAX(${visitTime}) AS last,
+          COUNT(DISTINCT urls.id) AS pages ${ChromeExtractor.FROM} WHERE ${where}`)
+            .get(...values);
+        const byMonth = options.byMonth &&
+            countsByMonth(this.db
+                .prepare(`SELECT ${monthSql(`${visitTime} / 1000`)} AS month, COUNT(*) AS n
+            ${ChromeExtractor.FROM} WHERE ${where} GROUP BY month`)
+                .all(...values));
+        return {
+            views: {
+                count: row.n,
+                ...(row.first !== null && { earliest: new Date(row.first) }),
+                ...(row.last !== null && { latest: new Date(row.last) }),
+                ...(byMonth && { byMonth }),
+                measures: [{ key: 'pages', label: 'pages', value: row.pages }],
+            },
+        };
+    }
 }
 /**
  * History's size and modification time while it holds only saved changes,

package/dist/connectors/ChromeLocator.d.ts

@@ -0,0 +1,13 @@
+import { Locator, type Candidate, type LocationMatch } from '@chronicle.app/etl';
+/**
+ * Chrome's profiles, named as its profile menu names them, with the account
+ * each is signed in to. The profile list in `Local State` decides which
+ * folders are profiles, since Chrome keeps others beside them, like
+ * `System Profile`, that no one browses in.
+ */
+export declare class ChromeLocator extends Locator {
+    static source: string;
+    static strategy: string;
+    locate(matches: LocationMatch[]): AsyncGenerator<Candidate>;
+}
+//# sourceMappingURL=ChromeLocator.d.ts.map

package/dist/connectors/ChromeLocator.js

@@ -0,0 +1,40 @@
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { Locator } from '@chronicle.app/etl';
+import { readChromeAccount } from './profile.js';
+/** Chrome's profiles by folder, with the name each shows in Chrome's profile menu. */
+function readProfiles(localStatePath) {
+    try {
+        const profiles = JSON.parse(readFileSync(localStatePath, 'utf8'))?.profile?.info_cache;
+        return profiles && typeof profiles === 'object' ? profiles : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Chrome's profiles, named as its profile menu names them, with the account
+ * each is signed in to. The profile list in `Local State` decides which
+ * folders are profiles, since Chrome keeps others beside them, like
+ * `System Profile`, that no one browses in.
+ */
+export class ChromeLocator extends Locator {
+    static source = 'chrome';
+    static strategy = 'app-db';
+    async *locate(matches) {
+        for (const match of matches) {
+            const profile = String(match.options.profile);
+            const profileDir = dirname(match.path);
+            const profiles = readProfiles(join(dirname(profileDir), 'Local State'));
+            if (profiles && !profiles[profile])
+                continue;
+            const name = profiles?.[profile]?.name || profile;
+            const account = readChromeAccount(join(profileDir, 'Preferences'));
+            yield {
+                label: account ? `${name} (${account.email})` : name,
+                config: { profile },
+                path: match.path,
+            };
+        }
+    }
+}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export { ChromeExtractor } from './connectors/ChromeExtractor.js';
+export { ChromeLocator } from './connectors/ChromeLocator.js';
 export { default as ChromeTransformer } from './connectors/ChromeTransformer.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,3 +1,4 @@
 // Export extractors for plugin scanning
 export { ChromeExtractor } from './connectors/ChromeExtractor.js';
+export { ChromeLocator } from './connectors/ChromeLocator.js';
 export { default as ChromeTransformer } from './connectors/ChromeTransformer.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chronicle.app/chrome",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
@@ -20,9 +20,9 @@
   "type": "module",
   "description": "Chronicle Chrome browsing history plugin",
   "devDependencies": {
-    "@chronicle.app/etl": "0.4.0",
-    "@chronicle.app/schema": "0.4.0",
-    "@chronicle.app/tsconfig": "0.4.0",
+    "@chronicle.app/etl": "0.5.0",
+    "@chronicle.app/schema": "0.5.0",
+    "@chronicle.app/tsconfig": "0.5.0",
     "@types/node": "^22.10.1",
     "typescript": "^5.7.2"
   },
@@ -37,8 +37,8 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@chronicle.app/etl-sqlite": "0.4.0",
-    "@chronicle.app/google": "0.4.0",
+    "@chronicle.app/etl-sqlite": "0.5.0",
+    "@chronicle.app/google": "0.5.0",
     "zod": "^3.24.1"
   },
   "peerDependencies": {
@@ -64,13 +64,30 @@
             "recordTypes": [
               "views"
             ],
-            "default": true
+            "default": true,
+            "locations": [
+              {
+                "path": "~/Library/Application Support/Google/Chrome/{profile}/History",
+                "platforms": [
+                  "darwin"
+                ]
+              },
+              {
+                "path": "~/.config/google-chrome/{profile}/History",
+                "platforms": [
+                  "linux"
+                ]
+              }
+            ]
           }
         },
         "platforms": [
           "darwin",
           "linux",
           "win32"
+        ],
+        "requires": [
+          "full-disk-access"
         ]
       }
     }