@mongrov/analytics 0.23.1 → 0.24.0

package/dist/sync/sleep-correction/night.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Per-night offsets from the user's IANA zone (principle 24).
+ *
+ * v3.1 passed one fixed device offset (`getTzOffsetHours()`) for every night,
+ * so on the nights either side of a DST change the 18:00→18:00 window sat an
+ * hour off. The port asks the zone what offset is in force at the START of
+ * each night's window — 18:00 local on the previous day — and hands that to
+ * the v3.1 arithmetic unchanged.
+ *
+ * Offsets are read for INSTANTS via `formatInTimeZone(…, 'xxx')`. Not
+ * date-fns-tz's `getTimezoneOffset(zone, date)`: that reads the Date's fields
+ * as a wall-clock time in the zone, so `2026-03-08T02:00Z` (Mar 7 18:00 PST)
+ * comes back as −7 — 02:00 is the spring-forward wall time. Measured; the
+ * spring-forward test pins it.
+ */
+/** UTC offset (ms) in force at the instant `epochMs` in `timeZone`. */
+export declare function offsetAtInstantMs(timeZone: string, epochMs: number): number;
+/** UTC offset (hours) in force at 18:00 local on the day before `nightIso`. */
+export declare function nightOffsetHours(nightIso: string, timeZone: string): number;
+/** The night's epoch window plus the offset it was computed with. */
+export declare function nightWindow(nightIso: string, timeZone: string): {
+    windowStart: number;
+    windowEnd: number;
+    tzOffsetHours: number;
+};
+//# sourceMappingURL=night.d.ts.map

package/dist/sync/sleep-correction/night.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"night.d.ts","sourceRoot":"","sources":["../../../src/sync/sleep-correction/night.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAQH,uEAAuE;AACvE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAa3E;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAO3E;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAGnE"}

package/dist/sync/sleep-correction/night.js

@@ -0,0 +1,48 @@
+/**
+ * Per-night offsets from the user's IANA zone (principle 24).
+ *
+ * v3.1 passed one fixed device offset (`getTzOffsetHours()`) for every night,
+ * so on the nights either side of a DST change the 18:00→18:00 window sat an
+ * hour off. The port asks the zone what offset is in force at the START of
+ * each night's window — 18:00 local on the previous day — and hands that to
+ * the v3.1 arithmetic unchanged.
+ *
+ * Offsets are read for INSTANTS via `formatInTimeZone(…, 'xxx')`. Not
+ * date-fns-tz's `getTimezoneOffset(zone, date)`: that reads the Date's fields
+ * as a wall-clock time in the zone, so `2026-03-08T02:00Z` (Mar 7 18:00 PST)
+ * comes back as −7 — 02:00 is the spring-forward wall time. Measured; the
+ * spring-forward test pins it.
+ */
+import { formatInTimeZone } from 'date-fns-tz';
+import { computeNightEpochs } from './classify';
+const OFFSET_RE = /^([+-])(\d{2}):(\d{2})$/;
+/** UTC offset (ms) in force at the instant `epochMs` in `timeZone`. */
+export function offsetAtInstantMs(timeZone, epochMs) {
+    let text;
+    try {
+        text = formatInTimeZone(new Date(epochMs), timeZone, 'xxx');
+    }
+    catch {
+        throw new Error(`sleep-correction: unknown time zone ${JSON.stringify(timeZone)}`);
+    }
+    const m = OFFSET_RE.exec(text);
+    if (!m)
+        throw new Error(`sleep-correction: unreadable offset ${JSON.stringify(text)} for ${timeZone}`);
+    const ms = (Number(m[2]) * 60 + Number(m[3])) * 60000;
+    return m[1] === '-' ? -ms : ms;
+}
+/** UTC offset (hours) in force at 18:00 local on the day before `nightIso`. */
+export function nightOffsetHours(nightIso, timeZone) {
+    const [y, m, d] = nightIso.split('-').map(Number);
+    // Local 18:00 as if it were UTC; one correction by the offset near that
+    // instant lands on the true local 18:00, and the offset there is the answer.
+    const wall = Date.UTC(y, m - 1, d - 1, 18);
+    const guess = offsetAtInstantMs(timeZone, wall);
+    return offsetAtInstantMs(timeZone, wall - guess) / 3600000;
+}
+/** The night's epoch window plus the offset it was computed with. */
+export function nightWindow(nightIso, timeZone) {
+    const tzOffsetHours = nightOffsetHours(nightIso, timeZone);
+    return { ...computeNightEpochs(nightIso, tzOffsetHours), tzOffsetHours };
+}
+//# sourceMappingURL=night.js.map

package/dist/sync/sleep-correction/night.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"night.js","sourceRoot":"","sources":["../../../src/sync/sleep-correction/night.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAE9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAE/C,MAAM,SAAS,GAAG,yBAAyB,CAAA;AAE3C,uEAAuE;AACvE,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,OAAe;IACjE,IAAI,IAAY,CAAA;IAChB,IAAI,CAAC;QACH,IAAI,GAAG,gBAAgB,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAA;IAC7D,CAAC;IACD,MAAM,CAAC;QACL,MAAM,IAAI,KAAK,CAAC,uCAAuC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;IACpF,CAAC;IACD,MAAM,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC9B,IAAI,CAAC,CAAC;QACJ,MAAM,IAAI,KAAK,CAAC,uCAAuC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,QAAQ,EAAE,CAAC,CAAA;IAChG,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAM,CAAA;IACtD,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;AAChC,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,QAAgB;IACjE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IACjD,wEAAwE;IACxE,6EAA6E;IAC7E,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAA;IAC1C,MAAM,KAAK,GAAG,iBAAiB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;IAC/C,OAAO,iBAAiB,CAAC,QAAQ,EAAE,IAAI,GAAG,KAAK,CAAC,GAAG,OAAS,CAAA;AAC9D,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,WAAW,CACzB,QAAgB,EAChB,QAAgB;IAEhB,MAAM,aAAa,GAAG,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IAC1D,OAAO,EAAE,GAAG,kBAAkB,CAAC,QAAQ,EAAE,aAAa,CAAC,EAAE,aAAa,EAAE,CAAA;AAC1E,CAAC"}

package/dist/sync/sleep-correction/orchestrate.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Correct every night a sync touched — v3.1's post-sync loop, per night.
+ *
+ * As v3.1: the HR tier and sleeping-HR percentiles are computed once per run,
+ * then each night gets its window, Phase 2 + 3, and the port's two scalars.
+ * Unlike v3.1, each night's window uses the offset its own zone had at its
+ * 18:00 (see `night.ts`), not one fixed device offset.
+ *
+ * A night that throws is reported `failed` and the rest continue — the spec's
+ * containment rule: a failed night keeps whatever rows it already had; it
+ * never blocks the batch. Writing the results (night-scoped replace) is the
+ * caller's job (sleep-correction tasks §3).
+ */
+import type { ClassifiedRow } from './classify';
+import type { SqlRunner } from './correct';
+import type { SleepRelations } from './sql';
+export interface CorrectSleepInput {
+    /** 'YYYY-MM-DD' nights (6pm → 6pm), e.g. from `nightsForEpochs`. */
+    nights: string[];
+    /** The user's IANA zone. */
+    timeZone: string;
+    /** Baseline lookback start (epoch seconds) — production: now − 30 d. */
+    cutoffEpoch: number;
+    relations?: SleepRelations;
+}
+export interface NightOutcome {
+    night: string;
+    windowStart: number;
+    windowEnd: number;
+    tzOffsetHours: number;
+    status: 'ok' | 'no_firmware_sleep' | 'no_phase2_rows' | 'failed';
+    rows?: ClassifiedRow[];
+    settleMin?: number | null;
+    recoveredMin?: number;
+    error?: string;
+}
+export interface CorrectSleepResult {
+    hrIntervalMin: number;
+    p75: number;
+    p90: number;
+    nights: NightOutcome[];
+}
+export declare function correctSleepNights(db: SqlRunner, input: CorrectSleepInput): Promise<CorrectSleepResult>;
+/**
+ * The nights (6pm → 6pm local) that a set of instants falls in — which nights
+ * a sync batch touched. Same attribution as v3.1's harness `nightOf`: shift to
+ * local time, add 6 h so 18:00 lands on midnight, take the date.
+ */
+export declare function nightsForEpochs(epochs: Iterable<number>, timeZone: string): string[];
+//# sourceMappingURL=orchestrate.d.ts.map

package/dist/sync/sleep-correction/orchestrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrate.d.ts","sourceRoot":"","sources":["../../../src/sync/sleep-correction/orchestrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AAM3C,MAAM,WAAW,iBAAiB;IAChC,oEAAoE;IACpE,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAA;IAChB,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,cAAc,CAAA;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,IAAI,GAAG,mBAAmB,GAAG,gBAAgB,GAAG,QAAQ,CAAA;IAChE,IAAI,CAAC,EAAE,aAAa,EAAE,CAAA;IACtB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAA;IACrB,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,YAAY,EAAE,CAAA;CACvB;AAED,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA2B7G;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAOpF"}

package/dist/sync/sleep-correction/orchestrate.js

@@ -0,0 +1,57 @@
+/**
+ * Correct every night a sync touched — v3.1's post-sync loop, per night.
+ *
+ * As v3.1: the HR tier and sleeping-HR percentiles are computed once per run,
+ * then each night gets its window, Phase 2 + 3, and the port's two scalars.
+ * Unlike v3.1, each night's window uses the offset its own zone had at its
+ * 18:00 (see `night.ts`), not one fixed device offset.
+ *
+ * A night that throws is reported `failed` and the rest continue — the spec's
+ * containment rule: a failed night keeps whatever rows it already had; it
+ * never blocks the batch. Writing the results (night-scoped replace) is the
+ * caller's job (sleep-correction tasks §3).
+ */
+import { correctNight, detectHrTier, globalBaselines } from './correct';
+import { nightWindow, offsetAtInstantMs } from './night';
+import { computeSettleMin, recoveredMinutes } from './settle';
+export async function correctSleepNights(db, input) {
+    const hrIntervalMin = await detectHrTier(db, input.relations);
+    const { p75, p90 } = await globalBaselines(db, input.cutoffEpoch, input.relations);
+    const nights = [];
+    for (const night of input.nights) {
+        const w = nightWindow(night, input.timeZone);
+        try {
+            const res = await correctNight(db, { ...w, hrIntervalMin, p75, p90, relations: input.relations });
+            if (res.status !== 'ok') {
+                nights.push({ night, ...w, status: res.status });
+                continue;
+            }
+            nights.push({
+                night,
+                ...w,
+                status: 'ok',
+                rows: res.rows,
+                settleMin: computeSettleMin(res.rows, res.vitals, hrIntervalMin),
+                recoveredMin: recoveredMinutes(res.rows),
+            });
+        }
+        catch (e) {
+            nights.push({ night, ...w, status: 'failed', error: e instanceof Error ? e.message : String(e) });
+        }
+    }
+    return { hrIntervalMin, p75, p90, nights };
+}
+/**
+ * The nights (6pm → 6pm local) that a set of instants falls in — which nights
+ * a sync batch touched. Same attribution as v3.1's harness `nightOf`: shift to
+ * local time, add 6 h so 18:00 lands on midnight, take the date.
+ */
+export function nightsForEpochs(epochs, timeZone) {
+    const out = new Set();
+    for (const e of epochs) {
+        const offsetMs = offsetAtInstantMs(timeZone, e * 1000);
+        out.add(new Date(e * 1000 + offsetMs + 6 * 3600000).toISOString().slice(0, 10));
+    }
+    return [...out].sort();
+}
+//# sourceMappingURL=orchestrate.js.map

package/dist/sync/sleep-correction/orchestrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrate.js","sourceRoot":"","sources":["../../../src/sync/sleep-correction/orchestrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AACvE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AACxD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AA+B7D,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,EAAa,EAAE,KAAwB;IAC9E,MAAM,aAAa,GAAG,MAAM,YAAY,CAAC,EAAE,EAAE,KAAK,CAAC,SAAS,CAAC,CAAA;IAC7D,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,MAAM,eAAe,CAAC,EAAE,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,CAAA;IAElF,MAAM,MAAM,GAAmB,EAAE,CAAA;IACjC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjC,MAAM,CAAC,GAAG,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAA;QAC5C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,aAAa,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAA;YACjG,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;gBACxB,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAA;gBAChD,SAAQ;YACV,CAAC;YACD,MAAM,CAAC,IAAI,CAAC;gBACV,KAAK;gBACL,GAAG,CAAC;gBACJ,MAAM,EAAE,IAAI;gBACZ,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,SAAS,EAAE,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC;gBAChE,YAAY,EAAE,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC;aACzC,CAAC,CAAA;QACJ,CAAC;QACD,OAAO,CAAC,EAAE,CAAC;YACT,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;QACnG,CAAC;IACH,CAAC;IACD,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,CAAA;AAC5C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,MAAwB,EAAE,QAAgB;IACxE,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAA;IAC7B,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,iBAAiB,CAAC,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC,CAAA;QACtD,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,QAAQ,GAAG,CAAC,GAAG,OAAS,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;IACnF,CAAC;IACD,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE,CAAA;AACxB,CAAC"}

package/dist/sync/sleep-correction/settle.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `settle_min` and `recovered_min` — the two per-night scalars the port adds
+ * to v3.1 (sleep-correction spec; registry §2.6; ruling R-C).
+ *
+ * settle_min: minutes from bed (the first primary minute) until the first HR
+ * sample at or below `night_min × 1.05` after which HR stays at or below that
+ * level for 15 minutes. `night_min` is the lowest HR inside the primary block.
+ * Null when it never settles, when there is no primary block, and — R-C — when
+ * the HR tier is coarser than 10 min: a 30-min cadence cannot support a
+ * minutes-resolution claim.
+ *
+ * Two readings of "stays for 15 minutes" the registry leaves open, decided
+ * here conservatively: every sample in [t, t + 15 min] must be at or below the
+ * level, and the data must actually reach t + 15 min — a run cut off by the end
+ * of the block is unconfirmed, not settled.
+ */
+import type { ClassifiedRow, VitalSample } from './classify';
+export declare const SETTLE_HR_FACTOR = 1.05;
+export declare const SETTLE_SUSTAIN_SEC = 900;
+export declare const SETTLE_MAX_TIER_MIN = 10;
+export declare function computeSettleMin(rows: ClassifiedRow[], vitals: VitalSample[], hrIntervalMin: number): number | null;
+/** Primary minutes that came from HR recovery (envelope/gap), not firmware. */
+export declare function recoveredMinutes(rows: ClassifiedRow[]): number;
+//# sourceMappingURL=settle.d.ts.map

package/dist/sync/sleep-correction/settle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settle.d.ts","sourceRoot":"","sources":["../../../src/sync/sleep-correction/settle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAI5D,eAAO,MAAM,gBAAgB,OAAO,CAAA;AACpC,eAAO,MAAM,kBAAkB,MAAM,CAAA;AACrC,eAAO,MAAM,mBAAmB,KAAK,CAAA;AAErC,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,aAAa,EAAE,EACrB,MAAM,EAAE,WAAW,EAAE,EACrB,aAAa,EAAE,MAAM,GACpB,MAAM,GAAG,IAAI,CAmCf;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,MAAM,CAE9D"}

package/dist/sync/sleep-correction/settle.js

@@ -0,0 +1,59 @@
+/**
+ * `settle_min` and `recovered_min` — the two per-night scalars the port adds
+ * to v3.1 (sleep-correction spec; registry §2.6; ruling R-C).
+ *
+ * settle_min: minutes from bed (the first primary minute) until the first HR
+ * sample at or below `night_min × 1.05` after which HR stays at or below that
+ * level for 15 minutes. `night_min` is the lowest HR inside the primary block.
+ * Null when it never settles, when there is no primary block, and — R-C — when
+ * the HR tier is coarser than 10 min: a 30-min cadence cannot support a
+ * minutes-resolution claim.
+ *
+ * Two readings of "stays for 15 minutes" the registry leaves open, decided
+ * here conservatively: every sample in [t, t + 15 min] must be at or below the
+ * level, and the data must actually reach t + 15 min — a run cut off by the end
+ * of the block is unconfirmed, not settled.
+ */
+import { parseDateStr } from './classify';
+export const SETTLE_HR_FACTOR = 1.05;
+export const SETTLE_SUSTAIN_SEC = 900;
+export const SETTLE_MAX_TIER_MIN = 10;
+export function computeSettleMin(rows, vitals, hrIntervalMin) {
+    if (hrIntervalMin > SETTLE_MAX_TIER_MIN)
+        return null;
+    const primary = rows.filter(r => r.block_type === 'primary').map(r => parseDateStr(r.date));
+    if (!primary.length)
+        return null;
+    const bed = Math.min(...primary);
+    const end = Math.max(...primary);
+    const hr = vitals
+        .filter(v => v.kind === 'hr' && Number.isFinite(v.value) && v.value > 0 && v.epoch >= bed && v.epoch <= end)
+        .map(v => ({ e: v.epoch, v: v.value }))
+        .sort((a, b) => a.e - b.e);
+    if (!hr.length)
+        return null;
+    const level = Math.min(...hr.map(h => h.v)) * SETTLE_HR_FACTOR;
+    const last = hr[hr.length - 1].e;
+    for (let i = 0; i < hr.length; i++) {
+        if (hr[i].v > level)
+            continue;
+        const until = hr[i].e + SETTLE_SUSTAIN_SEC;
+        if (last < until)
+            return null; // not enough data left to confirm any later run either
+        let held = true;
+        for (let j = i; j < hr.length && hr[j].e <= until; j++) {
+            if (hr[j].v > level) {
+                held = false;
+                break;
+            }
+        }
+        if (held)
+            return Math.round((hr[i].e - bed) / 60);
+    }
+    return null;
+}
+/** Primary minutes that came from HR recovery (envelope/gap), not firmware. */
+export function recoveredMinutes(rows) {
+    return rows.filter(r => r.block_type === 'primary' && (r.source === 'envelope' || r.source === 'gap')).length;
+}
+//# sourceMappingURL=settle.js.map

package/dist/sync/sleep-correction/settle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settle.js","sourceRoot":"","sources":["../../../src/sync/sleep-correction/settle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEzC,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAA;AACpC,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAA;AACrC,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAA;AAErC,MAAM,UAAU,gBAAgB,CAC9B,IAAqB,EACrB,MAAqB,EACrB,aAAqB;IAErB,IAAI,aAAa,GAAG,mBAAmB;QACrC,OAAO,IAAI,CAAA;IACb,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;IAC3F,IAAI,CAAC,OAAO,CAAC,MAAM;QACjB,OAAO,IAAI,CAAA;IACb,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAA;IAChC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAA;IAEhC,MAAM,EAAE,GAAG,MAAM;SACd,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC;SAC3G,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;SACtC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IAC5B,IAAI,CAAC,EAAE,CAAC,MAAM;QACZ,OAAO,IAAI,CAAA;IAEb,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAA;IAC9D,MAAM,IAAI,GAAG,EAAE,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK;YACjB,SAAQ;QACV,MAAM,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAA;QAC1C,IAAI,IAAI,GAAG,KAAK;YACd,OAAO,IAAI,CAAA,CAAC,uDAAuD;QACrE,IAAI,IAAI,GAAG,IAAI,CAAA;QACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YACvD,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC;gBACpB,IAAI,GAAG,KAAK,CAAA;gBACZ,MAAK;YACP,CAAC;QACH,CAAC;QACD,IAAI,IAAI;YACN,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC,CAAA;IAC3C,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,gBAAgB,CAAC,IAAqB;IACpD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,IAAI,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,MAAM,CAAA;AAC/G,CAAC"}

package/dist/sync/sleep-correction/sql.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Sleep correction — Phase 2 SQL, ported from DataFusion to DuckDB.
+ *
+ * Source: ziva_app `sleepCorrectionLayer.ts` v3.1. The query SHAPE is kept as
+ * v3.1 wrote it — same CTEs, same self-joins, same UNION ALL offset generator
+ * — so a diff against the original reads as a list of dialect changes only:
+ *
+ *   - `TO_CHAR(TO_TIMESTAMP(d), fmt)` → `strftime(make_timestamp(d * 1000000), fmt)`.
+ *     make_timestamp is naive UTC; `to_timestamp()` would be TIMESTAMPTZ and
+ *     render in the session zone, breaking Phase 3's UTC parse.
+ *   - `APPROX_PERCENTILE_CONT` → `quantile_cont` (exact). Expect ~1-unit
+ *     drift on the tier/p75/p90 scalars; never retune constants to hide it.
+ *   - The unused nested-window `session_start` column is dropped (DuckDB
+ *     rejects nested windows; the final `start` recomputes it anyway).
+ *   - Confidence literals are CAST to DOUBLE — DuckDB types `0.90` as DECIMAL,
+ *     DataFusion as Float64.
+ *
+ * Numbers are inlined, as v3.1 does: every value is computed by this module
+ * (epochs, tier, percentiles), never user input, and inlining sidesteps
+ * react-native-duckdb's untyped-param bind (zivaone_app#70). `num()` refuses
+ * anything non-finite.
+ *
+ * Relations are the v3.1 raw firmware shapes: sleep(date, quality, start,
+ * "unitLength"), heartrate(date, "singleHR"), activity(date, step), epochs in
+ * seconds. Production supplies staging views over the warehouse; the parity
+ * harness supplies tables loaded from captures.
+ */
+export interface SleepRelations {
+    sleep: string;
+    heartrate: string;
+    activity: string;
+}
+export declare const DEFAULT_RELATIONS: SleepRelations;
+/** Once per sync. `hr_interval_minutes` is 5, 10 or 30 (v3.1 CASE, NULL ⇒ 30). */
+export declare function detectHrTierSql(r?: SleepRelations): string;
+/** Once per sync. Sleeping-HR p90 / p75 since `cutoffEpoch`; 120 when empty. */
+export declare function globalBaselinesSql(cutoffEpoch: number, r?: SleepRelations): string;
+/** Per night, before Phase 2: zero firmware sleep ⇒ skip the night entirely. */
+export declare function hasSleepDataSql(windowStart: number, windowEnd: number, r?: SleepRelations): string;
+/** Phase 2 — envelope extension, gap recovery and session stitching. */
+export declare function correctNightSql(windowStart: number, windowEnd: number, hrIntervalMin: number, globalP75: number, globalP90: number, r?: SleepRelations): string;
+/** Phase 3 input — HR + step samples for the Step 5.6 END refinement. */
+export declare function morningVitalsSql(windowStart: number, windowEnd: number, r?: SleepRelations): string;
+//# sourceMappingURL=sql.d.ts.map

package/dist/sync/sleep-correction/sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql.d.ts","sourceRoot":"","sources":["../../../src/sync/sleep-correction/sql.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAmBH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,eAAO,MAAM,iBAAiB,EAAE,cAI/B,CAAA;AAgBD,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,CAAC,GAAE,cAAkC,GAAG,MAAM,CAyB7E;AAED,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC,GAAE,cAAkC,GAAG,MAAM,CAarG;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,GAAE,cAAkC,GAAG,MAAM,CAOrH;AAED,wEAAwE;AACxE,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,CAAC,GAAE,cAAkC,GACpC,MAAM,CA2NR;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,GAAE,cAAkC,GAAG,MAAM,CAWtH"}