@chronicle.app/google-reader 0.3.0 → 0.4.0

package/README.md

@@ -22,7 +22,7 @@ reader-archive/
 
 Each stream JSON has an `items` array. Items carry `id`, `title`, a microsecond `timestampUsec` string, and `categories` such as `user/123/state/com.google/read`. Optional `alternate`, `content`/`summary`, and `annotations` supply article URLs, bodies, and notes. Other archive files are ignored; this plugin does not parse OPML, ZIP files, preferences, or separate friend-activity files.
 
-The archive owner's ID comes from `user_id` in `data/user-info.json`; `user_name` and `email` provide optional profile details. Use `--user-id 123` to explicitly select your account, including when user info is missing. This also restricts stream filenames to that user. Only that account's states and annotations become actions, and only that account is linked to `@me`. The owner also links to a `google-account` identity using the Reader user ID and, when matching user info supplies an email, an `email` identity keyed by that address. These `sameAs` references resolve to the same entity on import; no email identity is inferred when the address is missing.
+The archive owner's ID comes from `user_id` in `data/user-info.json`; `user_name` and `email` provide optional profile details. Use `--user-id 123` to explicitly select your account, including when user info is missing. This also restricts stream filenames to that user. Only that account's states and annotations become actions, and only that account is linked to `@me`. When matching user info supplies an email, the owner also links to an `email` identity and a `google-account` identity, both keyed by that address, as Gmail, Google Calendar, and Chrome key you. These `sameAs` references resolve to the same entity on import; no email identity is inferred when the address is missing.
 
 `--since` and `--until` are inclusive bounds on the item's `timestampUsec`. `--limit` caps matching raw items across all files, not generated actions; `0` means unlimited. Files are processed in filename order, not chronological order. Invalid stream JSON or item timestamps fail the extraction rather than silently dropping a file.
 

package/dist/connectors/GoogleReaderTransformer.js

@@ -1,14 +1,11 @@
 import { ChronicleTransformer, selfAgent } from '@chronicle.app/etl';
+import { googleAccount } from '@chronicle.app/google';
 export default class GoogleReaderTransformer extends ChronicleTransformer {
     async transform(record) {
-        this.logger.debug('Transforming google-reader record', {
-            recordType: record.extraction.recordType,
-        });
         const actions = [];
         if (record.extraction.recordType === 'stream-contents') {
             actions.push(...this.buildStreamContentActions(record));
         }
-        this.logger.verboseInfo(`Generated ${actions.length} actions from google-reader record`);
         return actions;
     }
     buildStreamContentActions(record) {
@@ -92,23 +89,20 @@ export default class GoogleReaderTransformer extends ChronicleTransformer {
         const profile = userInfo?.user_id === userId ? userInfo : null;
         const email = profile?.email?.trim() || undefined;
         const name = profile?.user_name;
-        const sameAs = [];
-        if (email) {
-            sameAs.push({
-                '@type': 'Agent',
-                '@key': ['@type', 'source', 'handle'],
-                source: 'email',
-                handle: email,
-                ...(name && { name }),
-            });
-        }
-        sameAs.push({
-            '@type': 'Agent',
-            '@key': ['@type', 'source', 'sourceId'],
-            source: 'google-account',
-            sourceId: userId,
-            ...(name && { name }),
-        });
+        // Your address, and the Google account it is, keyed by that address as
+        // Gmail, Google Calendar, and Chrome key it.
+        const sameAs = email
+            ? [
+                {
+                    '@type': 'Agent',
+                    '@key': ['@type', 'source', 'handle'],
+                    source: 'email',
+                    handle: email.toLowerCase(),
+                    ...(name && { name }),
+                },
+                googleAccount(email),
+            ]
+            : [];
         return selfAgent({
             type: 'Agent',
             source: 'google-reader',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chronicle.app/google-reader",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
@@ -22,9 +22,9 @@
   "type": "module",
   "description": "Import personal actions from Google Reader archive streams",
   "devDependencies": {
-    "@chronicle.app/etl": "0.3.0",
-    "@chronicle.app/schema": "0.3.0",
-    "@chronicle.app/tsconfig": "0.3.0",
+    "@chronicle.app/etl": "0.4.0",
+    "@chronicle.app/schema": "0.4.0",
+    "@chronicle.app/tsconfig": "0.4.0",
     "@types/node": "^22.10.1",
     "typescript": "^5.7.2"
   },
@@ -39,6 +39,7 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
+    "@chronicle.app/google": "0.4.0",
     "zod": "^3.24.1"
   },
   "peerDependencies": {