@mongrov/analytics 0.6.0 → 0.8.0

package/dist/sync/mapper/schema.d.ts

@@ -0,0 +1,669 @@
+/**
+ * Zod contract for the firmware export payload (principle 60 — firmware
+ * fixture governance).
+ *
+ * Models `FirmwareExport` from `./types.ts` EXACTLY, with `.strict()` on
+ * every object so unknown keys fail parsing. This is the CI gate: when the
+ * firmware team lands a new versioned fixture, any key the mapper doesn't
+ * know about surfaces as a test failure — a PR-blocking event that forces a
+ * deliberate schema + mapper update instead of a silent drop.
+ *
+ * `FIRMWARE_EXPORT_KEY_PATHS` is the same contract expressed as a key-path
+ * set (`heartrate`, `heartrate[].timestamp`, ...) for the fixture key-diff
+ * test in `__tests__/schema.test.ts`. Keep both in lockstep with
+ * `FirmwareExport` — the key-diff test asserts the fixture corpus exercises
+ * exactly this set.
+ */
+import { z } from 'zod';
+export declare const firmwareHRRowSchema: z.ZodObject<{
+    timestamp: z.ZodString;
+    singleHR: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    timestamp: string;
+    singleHR: number;
+}, {
+    timestamp: string;
+    singleHR: number;
+}>;
+export declare const firmwareHRVRowSchema: z.ZodObject<{
+    timestamp: z.ZodString;
+    hrv: z.ZodOptional<z.ZodNumber>;
+    stress: z.ZodOptional<z.ZodNumber>;
+    heartRate: z.ZodOptional<z.ZodNumber>;
+    systolicBP: z.ZodOptional<z.ZodNumber>;
+    diastolicBP: z.ZodOptional<z.ZodNumber>;
+    vascularAging: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    timestamp: string;
+    hrv?: number | undefined;
+    stress?: number | undefined;
+    heartRate?: number | undefined;
+    systolicBP?: number | undefined;
+    diastolicBP?: number | undefined;
+    vascularAging?: number | undefined;
+}, {
+    timestamp: string;
+    hrv?: number | undefined;
+    stress?: number | undefined;
+    heartRate?: number | undefined;
+    systolicBP?: number | undefined;
+    diastolicBP?: number | undefined;
+    vascularAging?: number | undefined;
+}>;
+export declare const firmwareSpO2RowSchema: z.ZodObject<{
+    timestamp: z.ZodString;
+    automaticSpo2Data: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    timestamp: string;
+    automaticSpo2Data: number;
+}, {
+    timestamp: string;
+    automaticSpo2Data: number;
+}>;
+export declare const firmwareTempRowSchema: z.ZodObject<{
+    timestamp: z.ZodString;
+    temperature: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    temperature: number;
+    timestamp: string;
+}, {
+    temperature: number;
+    timestamp: string;
+}>;
+export declare const firmwareActivityRowSchema: z.ZodObject<{
+    timestamp: z.ZodString;
+    step: z.ZodNumber;
+    calories: z.ZodNumber;
+    distance: z.ZodNumber;
+    arraySteps: z.ZodArray<z.ZodNumber, "many">;
+}, "strict", z.ZodTypeAny, {
+    calories: number;
+    timestamp: string;
+    step: number;
+    distance: number;
+    arraySteps: number[];
+}, {
+    calories: number;
+    timestamp: string;
+    step: number;
+    distance: number;
+    arraySteps: number[];
+}>;
+export declare const firmwareSleepRowSchema: z.ZodObject<{
+    start: z.ZodString;
+    end: z.ZodString;
+    block_type: z.ZodString;
+    confidence: z.ZodNumber;
+    timestamp: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    start: string;
+    timestamp: string;
+    end: string;
+    block_type: string;
+    confidence: number;
+}, {
+    start: string;
+    timestamp: string;
+    end: string;
+    block_type: string;
+    confidence: number;
+}>;
+export declare const firmwareBatteryRowSchema: z.ZodObject<{
+    timestamp: z.ZodString;
+    battery: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    timestamp: string;
+    battery: number;
+}, {
+    timestamp: string;
+    battery: number;
+}>;
+export declare const firmwareWeekdaysSchema: z.ZodObject<{
+    sunday: z.ZodBoolean;
+    monday: z.ZodBoolean;
+    Tuesday: z.ZodBoolean;
+    Wednesday: z.ZodBoolean;
+    Thursday: z.ZodBoolean;
+    Friday: z.ZodBoolean;
+    Saturday: z.ZodBoolean;
+}, "strict", z.ZodTypeAny, {
+    sunday: boolean;
+    monday: boolean;
+    Tuesday: boolean;
+    Wednesday: boolean;
+    Thursday: boolean;
+    Friday: boolean;
+    Saturday: boolean;
+}, {
+    sunday: boolean;
+    monday: boolean;
+    Tuesday: boolean;
+    Wednesday: boolean;
+    Thursday: boolean;
+    Friday: boolean;
+    Saturday: boolean;
+}>;
+/**
+ * Mirrors `AutomaticMonitoring_J2301A` from the JStyle SDK. `dataType` is
+ * the firmware enum (1=heartRate, 2=spo2, 3=temperature, 4=HRV) and is
+ * translated away at the mapper boundary — see `mapper/ring-config.ts`.
+ */
+export declare const firmwareMonitoringWindowSchema: z.ZodObject<{
+    dataType: z.ZodNumber;
+    intervalTime: z.ZodNumber;
+    startTime_Hour: z.ZodNumber;
+    startTime_Minutes: z.ZodNumber;
+    endTime_Hour: z.ZodNumber;
+    endTime_Minutes: z.ZodNumber;
+    weeks: z.ZodObject<{
+        sunday: z.ZodBoolean;
+        monday: z.ZodBoolean;
+        Tuesday: z.ZodBoolean;
+        Wednesday: z.ZodBoolean;
+        Thursday: z.ZodBoolean;
+        Friday: z.ZodBoolean;
+        Saturday: z.ZodBoolean;
+    }, "strict", z.ZodTypeAny, {
+        sunday: boolean;
+        monday: boolean;
+        Tuesday: boolean;
+        Wednesday: boolean;
+        Thursday: boolean;
+        Friday: boolean;
+        Saturday: boolean;
+    }, {
+        sunday: boolean;
+        monday: boolean;
+        Tuesday: boolean;
+        Wednesday: boolean;
+        Thursday: boolean;
+        Friday: boolean;
+        Saturday: boolean;
+    }>;
+    mode: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    weeks: {
+        sunday: boolean;
+        monday: boolean;
+        Tuesday: boolean;
+        Wednesday: boolean;
+        Thursday: boolean;
+        Friday: boolean;
+        Saturday: boolean;
+    };
+    dataType: number;
+    intervalTime: number;
+    startTime_Hour: number;
+    startTime_Minutes: number;
+    endTime_Hour: number;
+    endTime_Minutes: number;
+    mode?: number | undefined;
+}, {
+    weeks: {
+        sunday: boolean;
+        monday: boolean;
+        Tuesday: boolean;
+        Wednesday: boolean;
+        Thursday: boolean;
+        Friday: boolean;
+        Saturday: boolean;
+    };
+    dataType: number;
+    intervalTime: number;
+    startTime_Hour: number;
+    startTime_Minutes: number;
+    endTime_Hour: number;
+    endTime_Minutes: number;
+    mode?: number | undefined;
+}>;
+export declare const firmwareRingConfigSchema: z.ZodObject<{
+    automaticMonitoringData: z.ZodArray<z.ZodObject<{
+        dataType: z.ZodNumber;
+        intervalTime: z.ZodNumber;
+        startTime_Hour: z.ZodNumber;
+        startTime_Minutes: z.ZodNumber;
+        endTime_Hour: z.ZodNumber;
+        endTime_Minutes: z.ZodNumber;
+        weeks: z.ZodObject<{
+            sunday: z.ZodBoolean;
+            monday: z.ZodBoolean;
+            Tuesday: z.ZodBoolean;
+            Wednesday: z.ZodBoolean;
+            Thursday: z.ZodBoolean;
+            Friday: z.ZodBoolean;
+            Saturday: z.ZodBoolean;
+        }, "strict", z.ZodTypeAny, {
+            sunday: boolean;
+            monday: boolean;
+            Tuesday: boolean;
+            Wednesday: boolean;
+            Thursday: boolean;
+            Friday: boolean;
+            Saturday: boolean;
+        }, {
+            sunday: boolean;
+            monday: boolean;
+            Tuesday: boolean;
+            Wednesday: boolean;
+            Thursday: boolean;
+            Friday: boolean;
+            Saturday: boolean;
+        }>;
+        mode: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        weeks: {
+            sunday: boolean;
+            monday: boolean;
+            Tuesday: boolean;
+            Wednesday: boolean;
+            Thursday: boolean;
+            Friday: boolean;
+            Saturday: boolean;
+        };
+        dataType: number;
+        intervalTime: number;
+        startTime_Hour: number;
+        startTime_Minutes: number;
+        endTime_Hour: number;
+        endTime_Minutes: number;
+        mode?: number | undefined;
+    }, {
+        weeks: {
+            sunday: boolean;
+            monday: boolean;
+            Tuesday: boolean;
+            Wednesday: boolean;
+            Thursday: boolean;
+            Friday: boolean;
+            Saturday: boolean;
+        };
+        dataType: number;
+        intervalTime: number;
+        startTime_Hour: number;
+        startTime_Minutes: number;
+        endTime_Hour: number;
+        endTime_Minutes: number;
+        mode?: number | undefined;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    automaticMonitoringData: {
+        weeks: {
+            sunday: boolean;
+            monday: boolean;
+            Tuesday: boolean;
+            Wednesday: boolean;
+            Thursday: boolean;
+            Friday: boolean;
+            Saturday: boolean;
+        };
+        dataType: number;
+        intervalTime: number;
+        startTime_Hour: number;
+        startTime_Minutes: number;
+        endTime_Hour: number;
+        endTime_Minutes: number;
+        mode?: number | undefined;
+    }[];
+}, {
+    automaticMonitoringData: {
+        weeks: {
+            sunday: boolean;
+            monday: boolean;
+            Tuesday: boolean;
+            Wednesday: boolean;
+            Thursday: boolean;
+            Friday: boolean;
+            Saturday: boolean;
+        };
+        dataType: number;
+        intervalTime: number;
+        startTime_Hour: number;
+        startTime_Minutes: number;
+        endTime_Hour: number;
+        endTime_Minutes: number;
+        mode?: number | undefined;
+    }[];
+}>;
+export declare const firmwareExportSchema: z.ZodObject<{
+    $comment: z.ZodOptional<z.ZodString>;
+    heartrate: z.ZodArray<z.ZodObject<{
+        timestamp: z.ZodString;
+        singleHR: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        timestamp: string;
+        singleHR: number;
+    }, {
+        timestamp: string;
+        singleHR: number;
+    }>, "many">;
+    hrv_table: z.ZodArray<z.ZodObject<{
+        timestamp: z.ZodString;
+        hrv: z.ZodOptional<z.ZodNumber>;
+        stress: z.ZodOptional<z.ZodNumber>;
+        heartRate: z.ZodOptional<z.ZodNumber>;
+        systolicBP: z.ZodOptional<z.ZodNumber>;
+        diastolicBP: z.ZodOptional<z.ZodNumber>;
+        vascularAging: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        timestamp: string;
+        hrv?: number | undefined;
+        stress?: number | undefined;
+        heartRate?: number | undefined;
+        systolicBP?: number | undefined;
+        diastolicBP?: number | undefined;
+        vascularAging?: number | undefined;
+    }, {
+        timestamp: string;
+        hrv?: number | undefined;
+        stress?: number | undefined;
+        heartRate?: number | undefined;
+        systolicBP?: number | undefined;
+        diastolicBP?: number | undefined;
+        vascularAging?: number | undefined;
+    }>, "many">;
+    spo2: z.ZodArray<z.ZodObject<{
+        timestamp: z.ZodString;
+        automaticSpo2Data: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        timestamp: string;
+        automaticSpo2Data: number;
+    }, {
+        timestamp: string;
+        automaticSpo2Data: number;
+    }>, "many">;
+    temperature_table: z.ZodArray<z.ZodObject<{
+        timestamp: z.ZodString;
+        temperature: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        temperature: number;
+        timestamp: string;
+    }, {
+        temperature: number;
+        timestamp: string;
+    }>, "many">;
+    activitydetails: z.ZodArray<z.ZodObject<{
+        timestamp: z.ZodString;
+        step: z.ZodNumber;
+        calories: z.ZodNumber;
+        distance: z.ZodNumber;
+        arraySteps: z.ZodArray<z.ZodNumber, "many">;
+    }, "strict", z.ZodTypeAny, {
+        calories: number;
+        timestamp: string;
+        step: number;
+        distance: number;
+        arraySteps: number[];
+    }, {
+        calories: number;
+        timestamp: string;
+        step: number;
+        distance: number;
+        arraySteps: number[];
+    }>, "many">;
+    sleep_processed: z.ZodArray<z.ZodObject<{
+        start: z.ZodString;
+        end: z.ZodString;
+        block_type: z.ZodString;
+        confidence: z.ZodNumber;
+        timestamp: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        start: string;
+        timestamp: string;
+        end: string;
+        block_type: string;
+        confidence: number;
+    }, {
+        start: string;
+        timestamp: string;
+        end: string;
+        block_type: string;
+        confidence: number;
+    }>, "many">;
+    battery_table: z.ZodArray<z.ZodObject<{
+        timestamp: z.ZodString;
+        battery: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        timestamp: string;
+        battery: number;
+    }, {
+        timestamp: string;
+        battery: number;
+    }>, "many">;
+    ring: z.ZodObject<{
+        automaticMonitoringData: z.ZodArray<z.ZodObject<{
+            dataType: z.ZodNumber;
+            intervalTime: z.ZodNumber;
+            startTime_Hour: z.ZodNumber;
+            startTime_Minutes: z.ZodNumber;
+            endTime_Hour: z.ZodNumber;
+            endTime_Minutes: z.ZodNumber;
+            weeks: z.ZodObject<{
+                sunday: z.ZodBoolean;
+                monday: z.ZodBoolean;
+                Tuesday: z.ZodBoolean;
+                Wednesday: z.ZodBoolean;
+                Thursday: z.ZodBoolean;
+                Friday: z.ZodBoolean;
+                Saturday: z.ZodBoolean;
+            }, "strict", z.ZodTypeAny, {
+                sunday: boolean;
+                monday: boolean;
+                Tuesday: boolean;
+                Wednesday: boolean;
+                Thursday: boolean;
+                Friday: boolean;
+                Saturday: boolean;
+            }, {
+                sunday: boolean;
+                monday: boolean;
+                Tuesday: boolean;
+                Wednesday: boolean;
+                Thursday: boolean;
+                Friday: boolean;
+                Saturday: boolean;
+            }>;
+            mode: z.ZodOptional<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            weeks: {
+                sunday: boolean;
+                monday: boolean;
+                Tuesday: boolean;
+                Wednesday: boolean;
+                Thursday: boolean;
+                Friday: boolean;
+                Saturday: boolean;
+            };
+            dataType: number;
+            intervalTime: number;
+            startTime_Hour: number;
+            startTime_Minutes: number;
+            endTime_Hour: number;
+            endTime_Minutes: number;
+            mode?: number | undefined;
+        }, {
+            weeks: {
+                sunday: boolean;
+                monday: boolean;
+                Tuesday: boolean;
+                Wednesday: boolean;
+                Thursday: boolean;
+                Friday: boolean;
+                Saturday: boolean;
+            };
+            dataType: number;
+            intervalTime: number;
+            startTime_Hour: number;
+            startTime_Minutes: number;
+            endTime_Hour: number;
+            endTime_Minutes: number;
+            mode?: number | undefined;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        automaticMonitoringData: {
+            weeks: {
+                sunday: boolean;
+                monday: boolean;
+                Tuesday: boolean;
+                Wednesday: boolean;
+                Thursday: boolean;
+                Friday: boolean;
+                Saturday: boolean;
+            };
+            dataType: number;
+            intervalTime: number;
+            startTime_Hour: number;
+            startTime_Minutes: number;
+            endTime_Hour: number;
+            endTime_Minutes: number;
+            mode?: number | undefined;
+        }[];
+    }, {
+        automaticMonitoringData: {
+            weeks: {
+                sunday: boolean;
+                monday: boolean;
+                Tuesday: boolean;
+                Wednesday: boolean;
+                Thursday: boolean;
+                Friday: boolean;
+                Saturday: boolean;
+            };
+            dataType: number;
+            intervalTime: number;
+            startTime_Hour: number;
+            startTime_Minutes: number;
+            endTime_Hour: number;
+            endTime_Minutes: number;
+            mode?: number | undefined;
+        }[];
+    }>;
+}, "strict", z.ZodTypeAny, {
+    spo2: {
+        timestamp: string;
+        automaticSpo2Data: number;
+    }[];
+    heartrate: {
+        timestamp: string;
+        singleHR: number;
+    }[];
+    hrv_table: {
+        timestamp: string;
+        hrv?: number | undefined;
+        stress?: number | undefined;
+        heartRate?: number | undefined;
+        systolicBP?: number | undefined;
+        diastolicBP?: number | undefined;
+        vascularAging?: number | undefined;
+    }[];
+    temperature_table: {
+        temperature: number;
+        timestamp: string;
+    }[];
+    activitydetails: {
+        calories: number;
+        timestamp: string;
+        step: number;
+        distance: number;
+        arraySteps: number[];
+    }[];
+    sleep_processed: {
+        start: string;
+        timestamp: string;
+        end: string;
+        block_type: string;
+        confidence: number;
+    }[];
+    battery_table: {
+        timestamp: string;
+        battery: number;
+    }[];
+    ring: {
+        automaticMonitoringData: {
+            weeks: {
+                sunday: boolean;
+                monday: boolean;
+                Tuesday: boolean;
+                Wednesday: boolean;
+                Thursday: boolean;
+                Friday: boolean;
+                Saturday: boolean;
+            };
+            dataType: number;
+            intervalTime: number;
+            startTime_Hour: number;
+            startTime_Minutes: number;
+            endTime_Hour: number;
+            endTime_Minutes: number;
+            mode?: number | undefined;
+        }[];
+    };
+    $comment?: string | undefined;
+}, {
+    spo2: {
+        timestamp: string;
+        automaticSpo2Data: number;
+    }[];
+    heartrate: {
+        timestamp: string;
+        singleHR: number;
+    }[];
+    hrv_table: {
+        timestamp: string;
+        hrv?: number | undefined;
+        stress?: number | undefined;
+        heartRate?: number | undefined;
+        systolicBP?: number | undefined;
+        diastolicBP?: number | undefined;
+        vascularAging?: number | undefined;
+    }[];
+    temperature_table: {
+        temperature: number;
+        timestamp: string;
+    }[];
+    activitydetails: {
+        calories: number;
+        timestamp: string;
+        step: number;
+        distance: number;
+        arraySteps: number[];
+    }[];
+    sleep_processed: {
+        start: string;
+        timestamp: string;
+        end: string;
+        block_type: string;
+        confidence: number;
+    }[];
+    battery_table: {
+        timestamp: string;
+        battery: number;
+    }[];
+    ring: {
+        automaticMonitoringData: {
+            weeks: {
+                sunday: boolean;
+                monday: boolean;
+                Tuesday: boolean;
+                Wednesday: boolean;
+                Thursday: boolean;
+                Friday: boolean;
+                Saturday: boolean;
+            };
+            dataType: number;
+            intervalTime: number;
+            startTime_Hour: number;
+            startTime_Minutes: number;
+            endTime_Hour: number;
+            endTime_Minutes: number;
+            mode?: number | undefined;
+        }[];
+    };
+    $comment?: string | undefined;
+}>;
+export type FirmwareExportParsed = z.infer<typeof firmwareExportSchema>;
+/**
+ * Every key-path the schema knows about. Array elements are flattened as
+ * `section[].key`. Used by the fixture key-diff test (principle 60).
+ */
+export declare const FIRMWARE_EXPORT_KEY_PATHS: ReadonlySet<string>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/sync/mapper/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/sync/mapper/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AASvB,eAAO,MAAM,mBAAmB;;;;;;;;;EAGrB,CAAA;AAEX,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;EAQtB,CAAA;AAEX,eAAO,MAAM,qBAAqB;;;;;;;;;EAGvB,CAAA;AAEX,eAAO,MAAM,qBAAqB;;;;;;;;;EAGvB,CAAA;AAEX,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;EAM3B,CAAA;AAEX,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;EAMxB,CAAA;AAEX,eAAO,MAAM,wBAAwB;;;;;;;;;EAG1B,CAAA;AAEX,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;EAQxB,CAAA;AAEX;;;;GAIG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAShC,CAAA;AAEX,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE1B,CAAA;AAEX,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYtB,CAAA;AAEX,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AASvE;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,WAAW,CAAC,MAAM,CAsDxD,CAAA"}