@mongrov/analytics 0.1.0-alpha.1 → 0.1.0-alpha.7

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

@@ -0,0 +1,28 @@
+/**
+ * Firmware composition mapper (T-09).
+ *
+ * Invokes every sub-mapper and produces a `MappedBatch` in one call. Empty
+ * firmware sections (undefined / empty array / absent `ring`) resolve to
+ * empty output arrays — no throw.
+ *
+ * The composition module owns the two SCD-2 outputs (device_config inserts
+ * vs. device_config closes). For flushing, callers use:
+ *   - `batch.device_config` — new inserts
+ *   - `batch.device_config_closes` — SCD-2 close directives
+ *
+ * See `.specifica/features/analytics-sync/spec.md` §Firmware mapper for the
+ * shape contract.
+ */
+import { type RingConfigClose } from './ring-config';
+import type { DeviceConfigRow, FirmwareExport, MappedBatch, MapperContext } from './types';
+export interface MapFirmwareOptions {
+    /** Override for deterministic tests. Defaults to `new Date()`. */
+    now?: Date;
+    /** SCD-2 prior-config map — see `mapRingConfig`. */
+    activePriorConfigs?: ReadonlyMap<string, DeviceConfigRow>;
+}
+export interface FirmwareMappedBatch extends MappedBatch {
+    device_config_closes: RingConfigClose[];
+}
+export declare function mapFirmwareExport(fw: FirmwareExport, ctx: MapperContext, opts?: MapFirmwareOptions): FirmwareMappedBatch;
+//# sourceMappingURL=firmware.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"firmware.d.ts","sourceRoot":"","sources":["../../../src/sync/mapper/firmware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,eAAe,CAAA;AAInE,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,WAAW,EACX,aAAa,EACd,MAAM,SAAS,CAAA;AAEhB,MAAM,WAAW,kBAAkB;IACjC,kEAAkE;IAClE,GAAG,CAAC,EAAE,IAAI,CAAA;IACV,oDAAoD;IACpD,kBAAkB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;CAC1D;AAED,MAAM,WAAW,mBAAoB,SAAQ,WAAW;IACtD,oBAAoB,EAAE,eAAe,EAAE,CAAA;CACxC;AAED,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,cAAc,EAClB,GAAG,EAAE,aAAa,EAClB,IAAI,GAAE,kBAAuB,GAC5B,mBAAmB,CAuBrB"}

package/dist/sync/mapper/firmware.js

@@ -0,0 +1,43 @@
+/**
+ * Firmware composition mapper (T-09).
+ *
+ * Invokes every sub-mapper and produces a `MappedBatch` in one call. Empty
+ * firmware sections (undefined / empty array / absent `ring`) resolve to
+ * empty output arrays — no throw.
+ *
+ * The composition module owns the two SCD-2 outputs (device_config inserts
+ * vs. device_config closes). For flushing, callers use:
+ *   - `batch.device_config` — new inserts
+ *   - `batch.device_config_closes` — SCD-2 close directives
+ *
+ * See `.specifica/features/analytics-sync/spec.md` §Firmware mapper for the
+ * shape contract.
+ */
+import { mapActivity } from './activity';
+import { mapBattery } from './battery';
+import { mapHeartRate } from './heart-rate';
+import { mapHrv } from './hrv';
+import { mapRingConfig } from './ring-config';
+import { reconstructSleepSessions } from './sleep';
+import { mapSpo2 } from './spo2';
+import { mapTemperature } from './temperature';
+export function mapFirmwareExport(fw, ctx, opts = {}) {
+    const activity = mapActivity(fw.activitydetails ?? [], ctx);
+    const sleep = reconstructSleepSessions(fw.sleep_processed ?? [], ctx);
+    const config = mapRingConfig(fw.ring ?? { automaticMonitoringData: [] }, ctx, opts);
+    return {
+        hrv: mapHrv(fw.hrv_table ?? [], ctx),
+        heart_rate: mapHeartRate(fw.heartrate ?? [], ctx),
+        spo2: mapSpo2(fw.spo2 ?? [], ctx),
+        temperature: mapTemperature(fw.temperature_table ?? [], ctx),
+        activity: activity.activity,
+        activity_bucket: activity.activity_bucket,
+        sleep_session: sleep.sleep_session,
+        sleep_stage: sleep.sleep_stage,
+        sleep_raw: sleep.sleep_raw,
+        device_event: mapBattery(fw.battery_table ?? [], ctx),
+        device_config: config.inserts,
+        device_config_closes: config.closes,
+    };
+}
+//# sourceMappingURL=firmware.js.map

package/dist/sync/mapper/firmware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"firmware.js","sourceRoot":"","sources":["../../../src/sync/mapper/firmware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,aAAa,EAAwB,MAAM,eAAe,CAAA;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAmB9C,MAAM,UAAU,iBAAiB,CAC/B,EAAkB,EAClB,GAAkB,EAClB,OAA2B,EAAE;IAE7B,MAAM,QAAQ,GAAG,WAAW,CAAC,EAAE,CAAC,eAAe,IAAI,EAAE,EAAE,GAAG,CAAC,CAAA;IAC3D,MAAM,KAAK,GAAG,wBAAwB,CAAC,EAAE,CAAC,eAAe,IAAI,EAAE,EAAE,GAAG,CAAC,CAAA;IACrE,MAAM,MAAM,GAAG,aAAa,CAC1B,EAAE,CAAC,IAAI,IAAI,EAAE,uBAAuB,EAAE,EAAE,EAAE,EAC1C,GAAG,EACH,IAAI,CACL,CAAA;IAED,OAAO;QACL,GAAG,EAAE,MAAM,CAAC,EAAE,CAAC,SAAS,IAAI,EAAE,EAAE,GAAG,CAAC;QACpC,UAAU,EAAE,YAAY,CAAC,EAAE,CAAC,SAAS,IAAI,EAAE,EAAE,GAAG,CAAC;QACjD,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,GAAG,CAAC;QACjC,WAAW,EAAE,cAAc,CAAC,EAAE,CAAC,iBAAiB,IAAI,EAAE,EAAE,GAAG,CAAC;QAC5D,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,eAAe,EAAE,QAAQ,CAAC,eAAe;QACzC,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,YAAY,EAAE,UAAU,CAAC,EAAE,CAAC,aAAa,IAAI,EAAE,EAAE,GAAG,CAAC;QACrD,aAAa,EAAE,MAAM,CAAC,OAAO;QAC7B,oBAAoB,EAAE,MAAM,CAAC,MAAM;KACpC,CAAA;AACH,CAAC"}

package/dist/sync/mapper/heart-rate.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Heart-rate mapper (T-03).
+ *
+ * Firmware column rename: `singleHR` → `bpm`. No sentinel handling: the ring
+ * firmware simply omits rows when it has no valid reading, so any row that
+ * makes it here is a valid measurement.
+ */
+import type { FirmwareHRRow, HeartRateRow, MapperContext } from './types';
+export declare function mapHeartRate(rows: readonly FirmwareHRRow[], ctx: MapperContext): HeartRateRow[];
+//# sourceMappingURL=heart-rate.d.ts.map

package/dist/sync/mapper/heart-rate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heart-rate.d.ts","sourceRoot":"","sources":["../../../src/sync/mapper/heart-rate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAEzE,wBAAgB,YAAY,CAC1B,IAAI,EAAE,SAAS,aAAa,EAAE,EAC9B,GAAG,EAAE,aAAa,GACjB,YAAY,EAAE,CAShB"}

package/dist/sync/mapper/heart-rate.js

@@ -0,0 +1,19 @@
+/**
+ * Heart-rate mapper (T-03).
+ *
+ * Firmware column rename: `singleHR` → `bpm`. No sentinel handling: the ring
+ * firmware simply omits rows when it has no valid reading, so any row that
+ * makes it here is a valid measurement.
+ */
+import { parseTimestamp } from './time';
+export function mapHeartRate(rows, ctx) {
+    return rows.map(row => ({
+        ts: parseTimestamp(row.timestamp),
+        brand: ctx.brand,
+        family_id: ctx.familyId,
+        user_id: ctx.userId,
+        device_id: ctx.deviceId,
+        bpm: row.singleHR,
+    }));
+}
+//# sourceMappingURL=heart-rate.js.map

package/dist/sync/mapper/heart-rate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heart-rate.js","sourceRoot":"","sources":["../../../src/sync/mapper/heart-rate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAA;AAGvC,MAAM,UAAU,YAAY,CAC1B,IAA8B,EAC9B,GAAkB;IAElB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtB,EAAE,EAAE,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC;QACjC,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,SAAS,EAAE,GAAG,CAAC,QAAQ;QACvB,OAAO,EAAE,GAAG,CAAC,MAAM;QACnB,SAAS,EAAE,GAAG,CAAC,QAAQ;QACvB,GAAG,EAAE,GAAG,CAAC,QAAQ;KAClB,CAAC,CAAC,CAAA;AACL,CAAC"}

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

@@ -0,0 +1,22 @@
+/**
+ * HRV mapper (T-02).
+ *
+ * Firmware `hrv_table` rows carry HRV, stress, and — reused as a physical
+ * carrier — BP + vascular aging. The BP + vascular fields are `collected_only`
+ * (spec.md §Firmware fidelity preserved / analytics-core §Metric metadata) and
+ * we keep them on the `hrv` row so they aren't lost, but sentinel zeros must
+ * still be normalised to NULL for downstream queries.
+ *
+ * Sentinel rules (per `.specifica/features/analytics-sync/spec.md` §Firmware
+ * mapper):
+ *   - `heartRate === 0` → NULL   (0 bpm is not a valid measurement)
+ *   - `systolicBP === 0` → NULL
+ *   - `diastolicBP === 0` → NULL
+ *   - `vascularAging === 0` → NULL
+ *   - `hrv === 0` is *not* a sentinel — firmware genuinely reports 0 when RR
+ *     variance is below floor; kept as-is
+ *   - `stress === 0` is likewise valid
+ */
+import type { FirmwareHRVRow, HrvRow, MapperContext } from './types';
+export declare function mapHrv(rows: readonly FirmwareHRVRow[], ctx: MapperContext): HrvRow[];
+//# sourceMappingURL=hrv.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hrv.d.ts","sourceRoot":"","sources":["../../../src/sync/mapper/hrv.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAEpE,wBAAgB,MAAM,CACpB,IAAI,EAAE,SAAS,cAAc,EAAE,EAC/B,GAAG,EAAE,aAAa,GACjB,MAAM,EAAE,CAiBV"}

package/dist/sync/mapper/hrv.js

@@ -0,0 +1,56 @@
+/**
+ * HRV mapper (T-02).
+ *
+ * Firmware `hrv_table` rows carry HRV, stress, and — reused as a physical
+ * carrier — BP + vascular aging. The BP + vascular fields are `collected_only`
+ * (spec.md §Firmware fidelity preserved / analytics-core §Metric metadata) and
+ * we keep them on the `hrv` row so they aren't lost, but sentinel zeros must
+ * still be normalised to NULL for downstream queries.
+ *
+ * Sentinel rules (per `.specifica/features/analytics-sync/spec.md` §Firmware
+ * mapper):
+ *   - `heartRate === 0` → NULL   (0 bpm is not a valid measurement)
+ *   - `systolicBP === 0` → NULL
+ *   - `diastolicBP === 0` → NULL
+ *   - `vascularAging === 0` → NULL
+ *   - `hrv === 0` is *not* a sentinel — firmware genuinely reports 0 when RR
+ *     variance is below floor; kept as-is
+ *   - `stress === 0` is likewise valid
+ */
+import { parseTimestamp } from './time';
+export function mapHrv(rows, ctx) {
+    const out = [];
+    for (const row of rows) {
+        out.push({
+            ts: parseTimestamp(row.timestamp),
+            brand: ctx.brand,
+            family_id: ctx.familyId,
+            user_id: ctx.userId,
+            device_id: ctx.deviceId,
+            hrv_ms: nullable(row.hrv),
+            stress: nullable(row.stress),
+            systolic_bp: sentinel(row.systolicBP),
+            diastolic_bp: sentinel(row.diastolicBP),
+            vascular_aging: sentinel(row.vascularAging),
+        });
+    }
+    return out;
+}
+/**
+ * `undefined` → NULL. Zero passes through — used for fields where 0 is a valid
+ * observed value (`hrv_ms`, `stress`).
+ */
+function nullable(v) {
+    return v === undefined ? null : v;
+}
+/**
+ * Firmware sentinel handling: 0 → NULL, undefined → NULL. Used for fields
+ * where 0 cannot represent a valid measurement (BP, vascular aging, HR carrier
+ * on the HRV row).
+ */
+function sentinel(v) {
+    if (v === undefined || v === 0)
+        return null;
+    return v;
+}
+//# sourceMappingURL=hrv.js.map

package/dist/sync/mapper/hrv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hrv.js","sourceRoot":"","sources":["../../../src/sync/mapper/hrv.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAA;AAGvC,MAAM,UAAU,MAAM,CACpB,IAA+B,EAC/B,GAAkB;IAElB,MAAM,GAAG,GAAa,EAAE,CAAA;IACxB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,GAAG,CAAC,IAAI,CAAC;YACP,EAAE,EAAE,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC;YACjC,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,SAAS,EAAE,GAAG,CAAC,QAAQ;YACvB,OAAO,EAAE,GAAG,CAAC,MAAM;YACnB,SAAS,EAAE,GAAG,CAAC,QAAQ;YACvB,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;YACzB,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC;YAC5B,WAAW,EAAE,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC;YACrC,YAAY,EAAE,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC;YACvC,cAAc,EAAE,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC;SAC5C,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;GAGG;AACH,SAAS,QAAQ,CAAC,CAAqB;IACrC,OAAO,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;AACnC,CAAC;AAED;;;;GAIG;AACH,SAAS,QAAQ,CAAC,CAAqB;IACrC,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAC3C,OAAO,CAAC,CAAA;AACV,CAAC"}

package/dist/sync/mapper/ring-config.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Ring config mapper (T-08).
+ *
+ * Firmware `ring.automaticMonitoringData[]` describes which metrics the ring
+ * currently samples (interval + active hours). We store these as SCD-2-style
+ * rows in `device_config`, with `valid_from = now()` and `valid_to = null` on
+ * the new insert.
+ *
+ * Closing prior config (SCD-2 semantics):
+ *   The mapper accepts an optional `activePriorConfigs` map keyed by metric
+ *   name. For every metric that shows up in the new firmware snapshot, if a
+ *   prior config was open, the mapper emits a `close` entry so the flusher
+ *   can `UPDATE ... SET valid_to = now()` before the INSERT lands. Metrics
+ *   present in the prior map but absent from the new firmware are left open
+ *   (the ring is silent on them, not disabling them).
+ *
+ * The mapper stays pure: no engine access, no clock reads beyond the
+ * injected `now` (defaults to `new Date()` for production).
+ */
+import type { DeviceConfigRow, FirmwareRingConfig, MapperContext } from './types';
+export interface RingConfigClose {
+    metric: string;
+    valid_to: Date;
+}
+export interface MapRingConfigResult {
+    inserts: DeviceConfigRow[];
+    closes: RingConfigClose[];
+}
+export declare function mapRingConfig(fw: FirmwareRingConfig, ctx: MapperContext, opts?: {
+    now?: Date;
+    activePriorConfigs?: ReadonlyMap<string, DeviceConfigRow>;
+}): MapRingConfigResult;
+//# sourceMappingURL=ring-config.d.ts.map

package/dist/sync/mapper/ring-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ring-config.d.ts","sourceRoot":"","sources":["../../../src/sync/mapper/ring-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EACV,eAAe,EAEf,kBAAkB,EAClB,aAAa,EACd,MAAM,SAAS,CAAA;AAEhB,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,IAAI,CAAA;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,eAAe,EAAE,CAAA;IAC1B,MAAM,EAAE,eAAe,EAAE,CAAA;CAC1B;AAED,wBAAgB,aAAa,CAC3B,EAAE,EAAE,kBAAkB,EACtB,GAAG,EAAE,aAAa,EAClB,IAAI,GAAE;IACJ,GAAG,CAAC,EAAE,IAAI,CAAA;IACV,kBAAkB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;CACrD,GACL,mBAAmB,CAerB"}

package/dist/sync/mapper/ring-config.js

@@ -0,0 +1,48 @@
+/**
+ * Ring config mapper (T-08).
+ *
+ * Firmware `ring.automaticMonitoringData[]` describes which metrics the ring
+ * currently samples (interval + active hours). We store these as SCD-2-style
+ * rows in `device_config`, with `valid_from = now()` and `valid_to = null` on
+ * the new insert.
+ *
+ * Closing prior config (SCD-2 semantics):
+ *   The mapper accepts an optional `activePriorConfigs` map keyed by metric
+ *   name. For every metric that shows up in the new firmware snapshot, if a
+ *   prior config was open, the mapper emits a `close` entry so the flusher
+ *   can `UPDATE ... SET valid_to = now()` before the INSERT lands. Metrics
+ *   present in the prior map but absent from the new firmware are left open
+ *   (the ring is silent on them, not disabling them).
+ *
+ * The mapper stays pure: no engine access, no clock reads beyond the
+ * injected `now` (defaults to `new Date()` for production).
+ */
+export function mapRingConfig(fw, ctx, opts = {}) {
+    const now = opts.now ?? new Date();
+    const prior = opts.activePriorConfigs ?? new Map();
+    const inserts = [];
+    const closes = [];
+    for (const window of fw.automaticMonitoringData ?? []) {
+        inserts.push(toRow(window, ctx, now));
+        if (prior.has(window.metric)) {
+            closes.push({ metric: window.metric, valid_to: now });
+        }
+    }
+    return { inserts, closes };
+}
+function toRow(window, ctx, now) {
+    return {
+        ts: now,
+        brand: ctx.brand,
+        family_id: ctx.familyId,
+        user_id: ctx.userId,
+        device_id: ctx.deviceId,
+        metric: window.metric,
+        interval_minutes: window.interval_minutes,
+        start_hour: window.start_hour,
+        end_hour: window.end_hour,
+        valid_from: now,
+        valid_to: null,
+    };
+}
+//# sourceMappingURL=ring-config.js.map

package/dist/sync/mapper/ring-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ring-config.js","sourceRoot":"","sources":["../../../src/sync/mapper/ring-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAmBH,MAAM,UAAU,aAAa,CAC3B,EAAsB,EACtB,GAAkB,EAClB,OAGI,EAAE;IAEN,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAA;IAClC,MAAM,KAAK,GAAG,IAAI,CAAC,kBAAkB,IAAI,IAAI,GAAG,EAA2B,CAAA;IAE3E,MAAM,OAAO,GAAsB,EAAE,CAAA;IACrC,MAAM,MAAM,GAAsB,EAAE,CAAA;IAEpC,KAAK,MAAM,MAAM,IAAI,EAAE,CAAC,uBAAuB,IAAI,EAAE,EAAE,CAAC;QACtD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAA;QACrC,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAA;QACvD,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAA;AAC5B,CAAC;AAED,SAAS,KAAK,CACZ,MAAgC,EAChC,GAAkB,EAClB,GAAS;IAET,OAAO;QACL,EAAE,EAAE,GAAG;QACP,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,SAAS,EAAE,GAAG,CAAC,QAAQ;QACvB,OAAO,EAAE,GAAG,CAAC,MAAM;QACnB,SAAS,EAAE,GAAG,CAAC,QAAQ;QACvB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,UAAU,EAAE,GAAG;QACf,QAAQ,EAAE,IAAI;KACf,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,32 @@
+/**
+ * Sleep reconstruction mapper (T-06).
+ *
+ * Firmware `sleep_processed` emits per-block rows tagged with a `start`
+ * (session start), `end`, `block_type` (primary / light / deep / rem / ...),
+ * `confidence` (0..1), and per-block `timestamp` (block instant). Multiple
+ * blocks share the same `start` when they belong to the same sleep session.
+ *
+ * Reconstruction rules (spec.md §Firmware mapper + tasks.md T-06):
+ *   - Group rows by `start`.
+ *   - A session is included if AT LEAST ONE block in the group has
+ *     `block_type === 'primary'` AND `confidence >= 0.7`. This filters
+ *     day-time naps and low-confidence noise.
+ *   - Session boundaries: `start_ts` = earliest block ts in the group;
+ *     `end_ts` = latest block ts + 1 minute (block ts marks start of the
+ *     1-min block).
+ *   - `session_id` = stable hash of `user_id + start_ts.toISOString()`.
+ *   - `night_of` = 6pm-6pm rule applied to `start_ts` (see `time.ts`).
+ *   - Stages: one row per firmware block that passed the primary+confidence
+ *     filter, carrying `session_id`, `block_type`, and `confidence`.
+ *   - Raw: every input row is preserved verbatim in `sleep_raw` (payload
+ *     column) regardless of the primary/confidence filter, so downstream
+ *     reprocessing can revisit sessions with new heuristics.
+ */
+import type { FirmwareSleepRow, MapperContext, SleepRawRow, SleepSessionRow, SleepStageRow } from './types';
+export interface ReconstructSleepResult {
+    sleep_session: SleepSessionRow[];
+    sleep_stage: SleepStageRow[];
+    sleep_raw: SleepRawRow[];
+}
+export declare function reconstructSleepSessions(rows: readonly FirmwareSleepRow[], ctx: MapperContext): ReconstructSleepResult;
+//# sourceMappingURL=sleep.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../../../src/sync/mapper/sleep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,eAAe,EACf,aAAa,EACd,MAAM,SAAS,CAAA;AAMhB,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,eAAe,EAAE,CAAA;IAChC,WAAW,EAAE,aAAa,EAAE,CAAA;IAC5B,SAAS,EAAE,WAAW,EAAE,CAAA;CACzB;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,SAAS,gBAAgB,EAAE,EACjC,GAAG,EAAE,aAAa,GACjB,sBAAsB,CAyExB"}

package/dist/sync/mapper/sleep.js

@@ -0,0 +1,103 @@
+/**
+ * Sleep reconstruction mapper (T-06).
+ *
+ * Firmware `sleep_processed` emits per-block rows tagged with a `start`
+ * (session start), `end`, `block_type` (primary / light / deep / rem / ...),
+ * `confidence` (0..1), and per-block `timestamp` (block instant). Multiple
+ * blocks share the same `start` when they belong to the same sleep session.
+ *
+ * Reconstruction rules (spec.md §Firmware mapper + tasks.md T-06):
+ *   - Group rows by `start`.
+ *   - A session is included if AT LEAST ONE block in the group has
+ *     `block_type === 'primary'` AND `confidence >= 0.7`. This filters
+ *     day-time naps and low-confidence noise.
+ *   - Session boundaries: `start_ts` = earliest block ts in the group;
+ *     `end_ts` = latest block ts + 1 minute (block ts marks start of the
+ *     1-min block).
+ *   - `session_id` = stable hash of `user_id + start_ts.toISOString()`.
+ *   - `night_of` = 6pm-6pm rule applied to `start_ts` (see `time.ts`).
+ *   - Stages: one row per firmware block that passed the primary+confidence
+ *     filter, carrying `session_id`, `block_type`, and `confidence`.
+ *   - Raw: every input row is preserved verbatim in `sleep_raw` (payload
+ *     column) regardless of the primary/confidence filter, so downstream
+ *     reprocessing can revisit sessions with new heuristics.
+ */
+import { computeNightOf, parseTimestamp } from './time';
+const MINUTE_MS = 60000;
+const PRIMARY = 'primary';
+const CONFIDENCE_FLOOR = 0.7;
+export function reconstructSleepSessions(rows, ctx) {
+    const sleep_session = [];
+    const sleep_stage = [];
+    const sleep_raw = [];
+    // Raw pass — all input rows preserved verbatim for reprocessing.
+    for (const row of rows) {
+        sleep_raw.push({
+            ts: parseTimestamp(row.timestamp),
+            brand: ctx.brand,
+            family_id: ctx.familyId,
+            user_id: ctx.userId,
+            device_id: ctx.deviceId,
+            payload: row,
+        });
+    }
+    // Group by `start`.
+    const bySession = new Map();
+    for (const row of rows) {
+        const bucket = bySession.get(row.start);
+        if (bucket)
+            bucket.push(row);
+        else
+            bySession.set(row.start, [row]);
+    }
+    for (const [startKey, blocks] of bySession) {
+        // Session must contain a primary block above the confidence floor to be
+        // counted as a real sleep session (as opposed to a nap or noise).
+        const hasQualifyingPrimary = blocks.some(b => b.block_type === PRIMARY && b.confidence >= CONFIDENCE_FLOOR);
+        if (!hasQualifyingPrimary)
+            continue;
+        const blockInstants = blocks.map(b => parseTimestamp(b.timestamp));
+        const startTs = new Date(Math.min(...blockInstants.map(d => d.getTime())));
+        // Sessions extend to the end of the last block (blocks are 1-min wide by
+        // convention — firmware doc §Sleep processing).
+        const endTs = new Date(Math.max(...blockInstants.map(d => d.getTime())) + MINUTE_MS);
+        const nightOf = computeNightOf(startTs, ctx.userTimezone);
+        const sessionId = makeSessionId(ctx.userId, startTs);
+        sleep_session.push({
+            ts: startTs,
+            brand: ctx.brand,
+            family_id: ctx.familyId,
+            user_id: ctx.userId,
+            device_id: ctx.deviceId,
+            session_id: sessionId,
+            start_ts: startTs,
+            end_ts: endTs,
+            night_of: nightOf,
+        });
+        for (let i = 0; i < blocks.length; i++) {
+            const b = blocks[i];
+            sleep_stage.push({
+                ts: blockInstants[i],
+                brand: ctx.brand,
+                family_id: ctx.familyId,
+                user_id: ctx.userId,
+                device_id: ctx.deviceId,
+                session_id: sessionId,
+                stage: b.block_type,
+                confidence: b.confidence,
+            });
+        }
+        // Reference `startKey` to silence "unused" if TS ever tightens loop typing.
+        void startKey;
+    }
+    return { sleep_session, sleep_stage, sleep_raw };
+}
+/**
+ * Stable, non-cryptographic session id: `<userId>:<startIso>`. Deterministic
+ * so re-imports don't produce duplicates; carries enough context to survive
+ * cross-user joins without collision at the user's cardinality.
+ */
+function makeSessionId(userId, startTs) {
+    return `${userId}:${startTs.toISOString()}`;
+}
+//# sourceMappingURL=sleep.js.map

package/dist/sync/mapper/sleep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.js","sourceRoot":"","sources":["../../../src/sync/mapper/sleep.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,9 @@
+/**
+ * SpO2 mapper (T-04).
+ *
+ * Column rename: `automaticSpo2Data` → `spo2`. No sentinel handling — firmware
+ * omits invalid reads. Values are integer percentages, 0..100.
+ */
+import type { FirmwareSpO2Row, MapperContext, Spo2Row } from './types';
+export declare function mapSpo2(rows: readonly FirmwareSpO2Row[], ctx: MapperContext): Spo2Row[];
+//# sourceMappingURL=spo2.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spo2.d.ts","sourceRoot":"","sources":["../../../src/sync/mapper/spo2.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEtE,wBAAgB,OAAO,CACrB,IAAI,EAAE,SAAS,eAAe,EAAE,EAChC,GAAG,EAAE,aAAa,GACjB,OAAO,EAAE,CASX"}

package/dist/sync/mapper/spo2.js

@@ -0,0 +1,18 @@
+/**
+ * SpO2 mapper (T-04).
+ *
+ * Column rename: `automaticSpo2Data` → `spo2`. No sentinel handling — firmware
+ * omits invalid reads. Values are integer percentages, 0..100.
+ */
+import { parseTimestamp } from './time';
+export function mapSpo2(rows, ctx) {
+    return rows.map(row => ({
+        ts: parseTimestamp(row.timestamp),
+        brand: ctx.brand,
+        family_id: ctx.familyId,
+        user_id: ctx.userId,
+        device_id: ctx.deviceId,
+        spo2: row.automaticSpo2Data,
+    }));
+}
+//# sourceMappingURL=spo2.js.map

package/dist/sync/mapper/spo2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spo2.js","sourceRoot":"","sources":["../../../src/sync/mapper/spo2.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAA;AAGvC,MAAM,UAAU,OAAO,CACrB,IAAgC,EAChC,GAAkB;IAElB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtB,EAAE,EAAE,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC;QACjC,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,SAAS,EAAE,GAAG,CAAC,QAAQ;QACvB,OAAO,EAAE,GAAG,CAAC,MAAM;QACnB,SAAS,EAAE,GAAG,CAAC,QAAQ;QACvB,IAAI,EAAE,GAAG,CAAC,iBAAiB;KAC5B,CAAC,CAAC,CAAA;AACL,CAAC"}

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

@@ -0,0 +1,10 @@
+/**
+ * Temperature mapper (T-04).
+ *
+ * Column rename: `temperature` → `temp_c`. Firmware emits whole-degree
+ * Celsius (limitation of the ring); we preserve as-is — downstream aggregation
+ * (e.g. daily average) is expected to smooth the discretisation.
+ */
+import type { FirmwareTempRow, MapperContext, TemperatureRow } from './types';
+export declare function mapTemperature(rows: readonly FirmwareTempRow[], ctx: MapperContext): TemperatureRow[];
+//# sourceMappingURL=temperature.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"temperature.d.ts","sourceRoot":"","sources":["../../../src/sync/mapper/temperature.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7E,wBAAgB,cAAc,CAC5B,IAAI,EAAE,SAAS,eAAe,EAAE,EAChC,GAAG,EAAE,aAAa,GACjB,cAAc,EAAE,CASlB"}

package/dist/sync/mapper/temperature.js

@@ -0,0 +1,19 @@
+/**
+ * Temperature mapper (T-04).
+ *
+ * Column rename: `temperature` → `temp_c`. Firmware emits whole-degree
+ * Celsius (limitation of the ring); we preserve as-is — downstream aggregation
+ * (e.g. daily average) is expected to smooth the discretisation.
+ */
+import { parseTimestamp } from './time';
+export function mapTemperature(rows, ctx) {
+    return rows.map(row => ({
+        ts: parseTimestamp(row.timestamp),
+        brand: ctx.brand,
+        family_id: ctx.familyId,
+        user_id: ctx.userId,
+        device_id: ctx.deviceId,
+        temp_c: row.temperature,
+    }));
+}
+//# sourceMappingURL=temperature.js.map

package/dist/sync/mapper/temperature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"temperature.js","sourceRoot":"","sources":["../../../src/sync/mapper/temperature.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAA;AAGvC,MAAM,UAAU,cAAc,CAC5B,IAAgC,EAChC,GAAkB;IAElB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtB,EAAE,EAAE,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC;QACjC,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,SAAS,EAAE,GAAG,CAAC,QAAQ;QACvB,OAAO,EAAE,GAAG,CAAC,MAAM;QACnB,SAAS,EAAE,GAAG,CAAC,QAAQ;QACvB,MAAM,EAAE,GAAG,CAAC,WAAW;KACxB,CAAC,CAAC,CAAA;AACL,CAAC"}

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

@@ -0,0 +1,49 @@
+/**
+ * Firmware timestamp + timezone utilities (T-01).
+ *
+ * Firmware exports ring readings in a `"YYYY.MM.DD HH:MM:SS"` string, wall-clock
+ * UTC. The mapper needs two operations:
+ *
+ *   1. `parseTimestamp(fwStr)` — turn the firmware string into an ISO instant.
+ *   2. `computeNightOf(ts, tz)` — assign a reading to a sleep-night bucket via
+ *      the 6pm-6pm local rule (readings between 18:00 local of day D and 18:00
+ *      local of D+1 belong to `night_of = D`).
+ *
+ * The `night_of` computation must be timezone-aware because the rule is defined
+ * in the user's IANA timezone (`ctx.userTimezone`), and DST transitions can
+ * shift the wall-clock boundary. We defer to `date-fns-tz` for the IANA math.
+ *
+ * See `.specifica/features/analytics-sync/spec.md` §Firmware mapper for the
+ * timestamp contract and `design.md` §sync/mapper/firmware.ts for the module
+ * shape.
+ */
+/**
+ * Parse a firmware timestamp string into a `Date` (ISO instant, UTC).
+ *
+ * Contract: input is UTC wall-clock (`"2026.06.17 03:15:00"` = 03:15 UTC).
+ *
+ * @throws {Error} if the string does not match `"YYYY.MM.DD HH:MM:SS"`.
+ */
+export declare function parseTimestamp(fwStr: string): Date;
+/**
+ * Assign an instant to a sleep-night bucket in the user's timezone.
+ *
+ * Rule (spec.md §Firmware mapper):
+ *   Readings whose local (in `tz`) wall-clock is in the interval
+ *     `[D 18:00, D+1 18:00)`
+ *   are attributed to `night_of = D`.
+ *
+ * Returned as a UTC `Date` at midnight of `D` in the user's timezone. This
+ * matches the `DATE` column shape in `sleep_session.night_of` and lets
+ * `date_trunc`/`GROUP BY` queries stay timezone-honest.
+ *
+ * DST handling:
+ *   - Spring-forward gap (02:00 becomes 03:00): a reading in the vanished hour
+ *     is treated as the following instant by `date-fns-tz`, so the boundary is
+ *     preserved.
+ *   - Fall-back double hour (01:00 occurs twice): both occurrences share the
+ *     same local wall-clock and therefore the same `night_of`. This is the
+ *     desired behavior — the user experiences one continuous night.
+ */
+export declare function computeNightOf(ts: Date, tz: string): Date;
+//# sourceMappingURL=time.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../../src/sync/mapper/time.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAaH;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAqBlD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAmCzD"}