@chronicle.app/imessage 0.2.0 → 0.4.0

package/README.md

@@ -1,8 +1,8 @@
 # @chronicle.app/imessage
 
-Read `chat.db` with `ImessageExtractor`, then emit MessageAction/Message records with `ImessageTransformer`. `input` defaults to the macOS Messages database; use a consistent backup for exported data. The connection is read-only via built-in `node:sqlite`. Date windows are exclusive, records newest-first, and `limit: 0` means unlimited.
+Read `chat.db` with `ImessageExtractor`, then emit MessageAction/Message records with `ImessageTransformer`. `input` defaults to the macOS Messages database; use a consistent backup for exported data. Reading it needs Full Disk Access for the app that runs Chronicle (Terminal, iTerm, your editor): System Settings → Privacy & Security → Full Disk Access. Without it the run stops with that hint, not SQLite's `unable to open database file`. The connection is read-only via built-in `node:sqlite`. Date windows are exclusive, records newest-first, and `limit: 0` means unlimited.
 
-Automatic iCloud account and AddressBook enrichment comes from `@chronicle.app/icloud`. `includeContactNames: false` skips contacts. An explicit `account` object (or null) lets callers describe exported data without host account lookup. Transformer config can inject `lookupContact` for exported contacts. Missing permissions/account/contact data fall back to source-local identity and unlabelled participants.
+Automatic iCloud account and AddressBook enrichment comes from `@chronicle.app/icloud`. `includeContactNames: false` skips contacts. An explicit `account` object (or null) lets callers describe exported data without host account lookup. Transformer config can inject `lookupContact` for exported contacts. Missing permissions/account/contact data fall back to source-local identity and unlabelled participants. When no identifier for the account owner is available, the owner is left out of the agent and recipients.
 
 Attachments are local file references with MIME metadata, not copied bytes. Missing files are skipped. Attributed-body decoding retains the existing heuristic; it is not a complete typedstream decoder. Raw records preserve the source blob, and large integer timestamps are decimal strings so serialization is safe.
 

package/dist/connectors/ImessageTransformer.d.ts

@@ -26,6 +26,7 @@ export default class ImessageTransformer extends ChronicleTransformer {
      * more than once keeps its first spelling.
      */
     private emailIdentities;
+    /** The account owner, or null when no identifier for them is available. */
     private buildMyIdentity;
     private buildMyPhoneIdentity;
     private determineAgentAndRecipients;

package/dist/connectors/ImessageTransformer.js

@@ -23,7 +23,7 @@ export default class ImessageTransformer extends ChronicleTransformer {
             sourceId: record.context.guid, // Use GUID instead of ROWID
             '@key': ['source', 'sourceId', '@type'],
             object: this.buildMessage(record, recipients),
-            agent,
+            ...(agent && { agent }),
         };
         return [obj];
     }
@@ -102,15 +102,18 @@ export default class ImessageTransformer extends ChronicleTransformer {
             '@key': ['@type', 'source', 'handle'],
         }));
     }
+    /** The account owner, or null when no identifier for them is available. */
     async buildMyIdentity(record) {
         const { service } = record.context;
         const agentSource = this.getAgentSource(service);
         const identity = agentSource === 'icloud'
-            ? (await buildICloudPersonSchema(record.context.myIcloudAccount))
+            ? await buildICloudPersonSchema(record.context.myIcloudAccount)
             : this.buildMyPhoneIdentity(record);
+        if (!identity)
+            return null;
         // Tag the account owner as self. The iCloud branch (buildICloudPersonSchema)
         // already self-tags, so add `@me` only when it isn't already present.
-        const sameAs = identity?.sameAs ?? [];
+        const sameAs = identity.sameAs ?? [];
         return { ...identity, sameAs: sameAs.includes('@me') ? sameAs : [...sameAs, '@me'] };
     }
     buildMyPhoneIdentity(record) {
@@ -141,22 +144,18 @@ export default class ImessageTransformer extends ChronicleTransformer {
                 '@key': ['@type', 'source', 'handle'],
             };
         }
-        // Last resort - no unique info available
-        return {
-            '@type': 'Person',
-            source: 'phone',
-            '@key': ['@type', 'source'],
-        };
+        // No identifier for me: a bare phone Person would merge every such owner.
+        return null;
     }
     determineAgentAndRecipients(record, participants, myIdentity) {
         const isFromMe = record.context.isFromMe === 1;
         if (isFromMe) {
             // I sent the message - I'm the agent, everyone else are recipients
-            const recipients = myIdentity.handle
+            const recipients = myIdentity?.handle
                 ? participants.filter(p => p.handle !== myIdentity.handle)
                 : participants; // If I have no handle (SMS fallback), all participants are recipients
             return {
-                agent: myIdentity,
+                agent: myIdentity ?? undefined,
                 recipients,
             };
         }
@@ -169,12 +168,15 @@ export default class ImessageTransformer extends ChronicleTransformer {
             const agentSource = this.getAgentSource(record.context.service);
             return {
                 agent: this.buildParticipantAgent(record, agentSource, handleIdText),
-                recipients: [myIdentity],
+                recipients: myIdentity ? [myIdentity] : [],
             };
         }
         return {
             agent,
-            recipients: [...participants.filter(p => p.handle !== agent.handle), myIdentity],
+            recipients: [
+                ...participants.filter(p => p.handle !== agent.handle),
+                ...(myIdentity ? [myIdentity] : []),
+            ],
         };
     }
     getServiceSource(_service) {
@@ -202,7 +204,7 @@ export default class ImessageTransformer extends ChronicleTransformer {
                 const filePath = this.resolveAttachmentPath(attachment.filename);
                 // Check if file exists
                 if (!fs.existsSync(filePath)) {
-                    console.warn(`Attachment file not found: ${filePath}`);
+                    this.logger.warn('Attachment file not found', { file: filePath });
                     continue;
                 }
                 // MIME drives the media object @type (ImageObject vs DocumentObject…).
@@ -226,7 +228,10 @@ export default class ImessageTransformer extends ChronicleTransformer {
                 mediaObjects.push(mediaObject);
             }
             catch (error) {
-                console.warn(`Failed to process attachment ${attachment.filename}:`, error);
+                this.logger.warn('Failed to process attachment', {
+                    file: attachment.filename,
+                    error: String(error),
+                });
             }
         }
         return mediaObjects;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chronicle.app/imessage",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
@@ -19,9 +19,9 @@
   "type": "module",
   "description": "Chronicle imessage extraction plugin",
   "devDependencies": {
-    "@chronicle.app/etl": "0.2.0",
-    "@chronicle.app/schema": "0.2.0",
-    "@chronicle.app/tsconfig": "0.2.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"
   },
@@ -36,8 +36,8 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@chronicle.app/etl-sqlite": "0.2.0",
-    "@chronicle.app/icloud": "0.2.0",
+    "@chronicle.app/etl-sqlite": "0.4.0",
+    "@chronicle.app/icloud": "0.4.0",
     "zod": "^3.24.1"
   },
   "peerDependencies": {
@@ -54,7 +54,25 @@
     }
   },
   "chronicle": {
-    "plugin": true
-  },
-  "oclif": {}
+    "plugin": true,
+    "sources": {
+      "imessage": {
+        "strategies": {
+          "app-db": {
+            "delivery": "local",
+            "recordTypes": [
+              "messages"
+            ],
+            "default": true
+          }
+        },
+        "platforms": [
+          "darwin"
+        ],
+        "requires": [
+          "full-disk-access"
+        ]
+      }
+    }
+  }
 }