@chronicle.app/arc-timeline 0.4.0 → 0.5.0

package/dist/connectors/ArcTimelineExtractor.d.ts

@@ -1,4 +1,4 @@
-import { Extractor, Record } from '@chronicle.app/etl';
+import { Extractor, Record, type Survey, type SurveyOptions } from '@chronicle.app/etl';
 import { z } from 'zod';
 import ArcTimelineTransformer from './ArcTimelineTransformer.js';
 export declare class ArcTimelineExtractor extends Extractor<typeof ArcTimelineExtractor> {
@@ -30,6 +30,12 @@ export declare class ArcTimelineExtractor extends Extractor<typeof ArcTimelineEx
         limit?: number | undefined;
     }>;
     extract(): AsyncGenerator<Record>;
+    /**
+     * The visits and travels a run reads, and when they started, from every
+     * day file in range. A survey keeps only each item's id and start, one day
+     * at a time, where a run holds every item and then reads trips' samples.
+     */
+    survey(options?: SurveyOptions): Promise<Survey>;
     private resolvePerson;
     private loadSamples;
     determineCount(): Promise<number | null>;

package/dist/connectors/ArcTimelineExtractor.js

@@ -1,5 +1,5 @@
-import { Extractor } from '@chronicle.app/etl';
-import { buildICloudPersonSchema } from '@chronicle.app/icloud';
+import { Extractor, countMonth, } from '@chronicle.app/etl';
+import { buildICloudPersonSchema } from '@chronicle.app/apple';
 import { readFile, readdir } from 'node:fs/promises';
 import { join } from 'node:path';
 import { gunzipSync } from 'node:zlib';
@@ -119,6 +119,47 @@ export class ArcTimelineExtractor extends Extractor {
             }
         }
     }
+    /**
+     * The visits and travels a run reads, and when they started, from every
+     * day file in range. A survey keeps only each item's id and start, one day
+     * at a time, where a run holds every item and then reads trips' samples.
+     */
+    async survey(options = {}) {
+        const config = this.config;
+        const dir = await this.findDailyDir(config.input);
+        const sinceKey = config.since ? dayKey(config.since) : undefined;
+        const untilKey = config.until ? dayKey(config.until) : undefined;
+        const seen = new Set();
+        const visits = { count: 0, ...(options.byMonth && { byMonth: {} }) };
+        const travels = { count: 0, ...(options.byMonth && { byMonth: {} }) };
+        // Named by day, newest first, so a range skips whole files as a run does.
+        for (const { path, key } of await this.listDayFiles(dir)) {
+            if (sinceKey && key < sinceKey)
+                break;
+            if (untilKey && key > untilKey)
+                continue;
+            for (const item of (await this.readDayFile(path)).items) {
+                const { base } = item;
+                if (!base || base.deleted || seen.has(base.id))
+                    continue;
+                const start = new Date(base.startDate);
+                if ((config.since && start < config.since) || (config.until && start > config.until))
+                    continue;
+                const kind = item.visit || base.isVisit ? visits : item.trip ? travels : undefined;
+                if (!kind)
+                    continue;
+                seen.add(base.id);
+                kind.count++;
+                if (!kind.earliest || start < kind.earliest)
+                    kind.earliest = start;
+                if (!kind.latest || start > kind.latest)
+                    kind.latest = start;
+                if (kind.byMonth)
+                    countMonth(kind.byMonth, start);
+            }
+        }
+        return { visits, travels };
+    }
     // The person whose timeline this is: an explicit `--identity` override, else
     // the macOS iCloud account (so Arc data merges onto the same person as other
     // iCloud-sourced data). An override is keyed the same way, so it merges too.

package/dist/connectors/ArcTimelineTransformer.js

@@ -47,9 +47,9 @@ export default class ArcTimelineTransformer extends ChronicleTransformer {
         };
         const action = {
             '@type': 'TravelAction',
-            '@key': ['@type', 'source', 'sourceId'],
+            // Keyed by the journey it made, which has the timeline item's ID.
+            '@key': ['@type', 'source', 'result.sourceId'],
             source: 'arc',
-            sourceId: item.base.id,
             agent: person,
             result: journey,
             startTime: new Date(item.base.startDate),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chronicle.app/arc-timeline",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
@@ -22,9 +22,9 @@
   "type": "module",
   "description": "Chronicle plugin for location tracking data from Arc timeline database",
   "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"
   },
@@ -39,7 +39,7 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@chronicle.app/icloud": "0.4.0",
+    "@chronicle.app/apple": "0.5.0",
     "zod": "^3.24.1"
   },
   "peerDependencies": {
@@ -66,7 +66,12 @@
               "visits",
               "travels"
             ],
-            "default": true
+            "default": true,
+            "locations": [
+              {
+                "path": "~/Library/Mobile Documents/iCloud~com~bigpaua~Arc-Timeline-Editor/Documents/Exports"
+              }
+            ]
           }
         },
         "platforms": [