@chronicle.app/moves-app 0.3.0 → 0.5.0

package/dist/connectors/MovesExtractor.d.ts

@@ -1,4 +1,4 @@
-import { Extractor, Record } from '@chronicle.app/etl';
+import { Extractor, Record, type KindSurvey, type Survey, type SurveyOptions } from '@chronicle.app/etl';
 import { z } from 'zod';
 import MovesTransformer from './MovesTransformer.js';
 export declare class MovesExtractor extends Extractor<typeof MovesExtractor> {
@@ -28,6 +28,15 @@ export declare class MovesExtractor extends Extractor<typeof MovesExtractor> {
     }>;
     extract(): AsyncGenerator<Record>;
     determineCount(): Promise<number | null>;
+    /**
+     * The places and moves a run reads, and when they started, from every day
+     * in range: the export has no index, so each day is read. A segment that
+     * spans midnight is in both days' files, and counts once, as a run reads it.
+     */
+    survey(options?: SurveyOptions): Promise<{
+        places: KindSurvey;
+        moves: KindSurvey;
+    } & Survey>;
     private selectFrom;
     private readDays;
     private resolveInput;

package/dist/connectors/MovesExtractor.js

@@ -1,4 +1,4 @@
-import { Extractor, selfAgent } from '@chronicle.app/etl';
+import { Extractor, countMonth, selfAgent, } from '@chronicle.app/etl';
 import { readFile, readdir, stat } from 'node:fs/promises';
 import { join } from 'node:path';
 import { z } from 'zod';
@@ -68,30 +68,53 @@ export class MovesExtractor extends Extractor {
         }
     }
     async determineCount() {
-        const config = this.config;
         try {
-            const seen = new Set();
-            for await (const day of this.readDays(config.input)) {
-                for (const segment of day.segments ?? []) {
-                    for (const item of this.selectFrom(segment)) {
-                        const start = parseMovesTime(item.data.startTime);
-                        if (!start)
-                            continue;
-                        if (config.since && start < config.since)
-                            continue;
-                        if (config.until && start > config.until)
-                            continue;
-                        seen.add(`${item.recordType}:${start.toISOString()}`);
-                    }
-                }
-            }
+            const { places, moves } = await this.survey();
+            const total = places.count + moves.count;
             const limit = this.getEffectiveLimit();
-            return limit === null ? seen.size : Math.min(seen.size, limit);
+            return limit === null ? total : Math.min(total, limit);
         }
         catch {
             return null;
         }
     }
+    /**
+     * The places and moves a run reads, and when they started, from every day
+     * in range: the export has no index, so each day is read. A segment that
+     * spans midnight is in both days' files, and counts once, as a run reads it.
+     */
+    async survey(options = {}) {
+        const config = this.config;
+        const kind = () => ({ count: 0, ...(options.byMonth && { byMonth: {} }) });
+        const kinds = { places: kind(), moves: kind() };
+        const seen = new Set();
+        for await (const day of this.readDays(config.input)) {
+            for (const segment of day.segments ?? []) {
+                for (const item of this.selectFrom(segment)) {
+                    const start = parseMovesTime(item.data.startTime);
+                    if (!start)
+                        continue;
+                    if (config.since && start < config.since)
+                        continue;
+                    if (config.until && start > config.until)
+                        continue;
+                    const marker = `${item.recordType}:${start.toISOString()}`;
+                    if (seen.has(marker))
+                        continue;
+                    seen.add(marker);
+                    const counted = kinds[item.recordType];
+                    counted.count++;
+                    if (!counted.earliest || start < counted.earliest)
+                        counted.earliest = start;
+                    if (!counted.latest || start > counted.latest)
+                        counted.latest = start;
+                    if (counted.byMonth)
+                        countMonth(counted.byMonth, start);
+                }
+            }
+        }
+        return kinds;
+    }
     // The records a segment yields. A stay is one record. Movement splits into
     // its legs — each carries a single mode of travel, its own distance, and its
     // own track, which is what a Journey holds. A leg recorded while at a place

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chronicle.app/moves-app",
-  "version": "0.3.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 the location storyline from a Moves data export",
   "devDependencies": {
-    "@chronicle.app/etl": "0.3.0",
-    "@chronicle.app/schema": "0.3.0",
-    "@chronicle.app/tsconfig": "0.3.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"
   },