@mongrov/analytics 0.23.2 → 0.25.0

package/dist/sync/sleep-derive.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Derived sleep — the correction step every batch cycle runs before
+ * `batch:complete` (sleep-correction §3).
+ *
+ * `sleep_raw` is written like any sensor table. Sessions and stages are not:
+ * they are derived from it by the validated correction pipeline, night by
+ * night, and written back into the SAME batch, so a `context: 'asleep'` rule
+ * woken by `batch:complete` sees corrected sleep, never raw minutes.
+ *
+ * Raw rows can arrive by three flush paths (scheduled cycle, manual flush,
+ * size/age triggers), so the deriver does not hang off any one flush: it
+ * notes every enqueued `sleep_raw` range, and the next batch cycle corrects
+ * all pending nights after its flushes land.
+ *
+ * Night replace (principle 66 as amended): a corrected night's END moves as
+ * later data arrives, and the principle-25 id moves with it, so a night is
+ * DELETEd locally before its new rows are written. Nights that come back with
+ * no primary block are left alone — replacing a night with nothing on a
+ * partial sync would erase sleep the next sync restores.
+ *
+ * Local only. Rows already pushed to a remote catalog are not rewritten; that
+ * needs a server-side answer before cloud sync is switched on.
+ */
+import type { HybridDuckDB } from '../core/engine';
+import type { SensorBuffer } from './buffer';
+import type { BatchFlusher, FlushReason } from './flusher';
+import type { SchedulerLogger } from './scheduler';
+export interface SleepDeriverDeps {
+    engine: HybridDuckDB;
+    buffer: SensorBuffer;
+    flusher: BatchFlusher;
+    /** The user's IANA zone (the factory's `resolveTimezone`). */
+    resolveTimezone: (userId: string) => Promise<string>;
+    /** Baseline lookback. v3.1 production: 30 days. */
+    lookbackDays?: number;
+    now?: () => number;
+    logger?: SchedulerLogger;
+    localCatalog?: string;
+}
+export interface SleepDeriver {
+    /** Record an enqueued `sleep_raw` batch so the next cycle corrects its nights. */
+    noteRaw: (batch: {
+        brand: string;
+        familyId: string;
+        userId: string;
+        deviceId: string;
+        rows: ReadonlyArray<Record<string, unknown>>;
+    }) => void;
+    /** (user, device) ranges still waiting for a cycle. */
+    pendingCount: () => number;
+    /** Correct every pending range and write its nights into `batchId`. Never throws. */
+    derive: (batchId: string, reason: FlushReason) => Promise<void>;
+}
+export declare function createSleepDeriver(deps: SleepDeriverDeps): SleepDeriver;
+//# sourceMappingURL=sleep-derive.d.ts.map

package/dist/sync/sleep-derive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep-derive.d.ts","sourceRoot":"","sources":["../../src/sync/sleep-derive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAE1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAiBlD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,YAAY,CAAA;IACpB,MAAM,EAAE,YAAY,CAAA;IACpB,OAAO,EAAE,YAAY,CAAA;IACrB,8DAA8D;IAC9D,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IACpD,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,eAAe,CAAA;IACxB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,kFAAkF;IAClF,OAAO,EAAE,CAAC,KAAK,EAAE;QACf,KAAK,EAAE,MAAM,CAAA;QACb,QAAQ,EAAE,MAAM,CAAA;QAChB,MAAM,EAAE,MAAM,CAAA;QACd,QAAQ,EAAE,MAAM,CAAA;QAChB,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;KAC7C,KAAK,IAAI,CAAA;IACV,uDAAuD;IACvD,YAAY,EAAE,MAAM,MAAM,CAAA;IAC1B,qFAAqF;IACrF,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAChE;AA8CD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,YAAY,CAuHvE"}

package/dist/sync/sleep-derive.js

@@ -0,0 +1,180 @@
+/**
+ * Derived sleep — the correction step every batch cycle runs before
+ * `batch:complete` (sleep-correction §3).
+ *
+ * `sleep_raw` is written like any sensor table. Sessions and stages are not:
+ * they are derived from it by the validated correction pipeline, night by
+ * night, and written back into the SAME batch, so a `context: 'asleep'` rule
+ * woken by `batch:complete` sees corrected sleep, never raw minutes.
+ *
+ * Raw rows can arrive by three flush paths (scheduled cycle, manual flush,
+ * size/age triggers), so the deriver does not hang off any one flush: it
+ * notes every enqueued `sleep_raw` range, and the next batch cycle corrects
+ * all pending nights after its flushes land.
+ *
+ * Night replace (principle 66 as amended): a corrected night's END moves as
+ * later data arrives, and the principle-25 id moves with it, so a night is
+ * DELETEd locally before its new rows are written. Nights that come back with
+ * no primary block are left alone — replacing a night with nothing on a
+ * partial sync would erase sleep the next sync restores.
+ *
+ * Local only. Rows already pushed to a remote catalog are not rewritten; that
+ * needs a server-side answer before cloud sync is switched on.
+ */
+import { sessionsFromCorrected } from './mapper/sleep';
+import { computeNightOf } from './mapper/time';
+import { correctSleepNights, nightsForEpochs } from './sleep-correction/orchestrate';
+import { stagingViewsSql } from './sleep-correction/staging';
+const SIX_HOURS = 6 * 3600;
+function epochOf(ts) {
+    if (ts instanceof Date)
+        return Math.floor(ts.getTime() / 1000);
+    if (typeof ts === 'number')
+        return Math.floor(ts > 1e12 ? ts / 1000 : ts);
+    if (typeof ts === 'string') {
+        const ms = Date.parse(ts.includes('T') ? ts : `${ts.replace(' ', 'T')}Z`);
+        return Number.isFinite(ms) ? Math.floor(ms / 1000) : null;
+    }
+    return null;
+}
+/** The `night_of` value a session starting inside this window is stored with. */
+function storedNightOf(windowStart, timeZone) {
+    return computeNightOf(new Date((windowStart + 60) * 1000), timeZone).toISOString().slice(0, 10);
+}
+/** Every 6pm→6pm night between two instants, inclusive. */
+function nightsBetween(minEpoch, maxEpoch, timeZone) {
+    const probes = [];
+    for (let e = minEpoch; e < maxEpoch; e += SIX_HOURS)
+        probes.push(e);
+    probes.push(maxEpoch);
+    return nightsForEpochs(probes, timeZone);
+}
+function DELETE_STAGES_SQL(catalog) {
+    return `
+DELETE FROM ${catalog}.main.sleep_stage
+WHERE session_id IN (
+  SELECT session_id FROM ${catalog}.main.sleep_session
+  WHERE brand = $brand AND family_id = $family_id AND user_id = $user_id
+    AND device_id = $device_id AND night_of = CAST($night AS DATE)
+)`;
+}
+function DELETE_SESSIONS_SQL(catalog) {
+    return `
+DELETE FROM ${catalog}.main.sleep_session
+WHERE brand = $brand AND family_id = $family_id AND user_id = $user_id
+  AND device_id = $device_id AND night_of = CAST($night AS DATE)`;
+}
+export function createSleepDeriver(deps) {
+    const pending = new Map();
+    const catalog = deps.localCatalog ?? 'memory';
+    const now = deps.now ?? (() => Date.now());
+    const lookbackDays = deps.lookbackDays ?? 30;
+    async function replaceNight(ctx, night) {
+        const params = {
+            brand: ctx.brand,
+            family_id: ctx.familyId,
+            user_id: ctx.userId,
+            device_id: ctx.deviceId,
+            night,
+        };
+        await deps.engine.execute(DELETE_STAGES_SQL(catalog), params);
+        await deps.engine.execute(DELETE_SESSIONS_SQL(catalog), params);
+    }
+    async function deriveRange(p) {
+        const timeZone = await deps.resolveTimezone(p.userId);
+        const ctx = {
+            brand: p.brand,
+            familyId: p.familyId,
+            userId: p.userId,
+            deviceId: p.deviceId,
+            userTimezone: timeZone,
+        };
+        for (const sql of stagingViewsSql({ ...ctx, localCatalog: catalog }))
+            await deps.engine.execute(sql);
+        const result = await correctSleepNights(deps.engine, {
+            nights: nightsBetween(p.minEpoch, p.maxEpoch, timeZone),
+            timeZone,
+            cutoffEpoch: Math.floor(now() / 1000) - lookbackDays * 86400,
+        });
+        const sessions = [];
+        const stages = [];
+        for (const n of result.nights) {
+            if (n.status === 'failed')
+                deps.logger?.warn('sync.sleep-derive: night failed; previous rows kept', { night: n.night, err: n.error });
+            if (n.status !== 'ok' || !n.rows)
+                continue;
+            const out = sessionsFromCorrected(n.rows, ctx, { settleMin: n.settleMin });
+            if (out.sleep_session.length === 0)
+                continue;
+            // Two conventions meet here. v3.1 names a night by its MORNING date
+            // (window Jun 17 18:00 → Jun 18 18:00 is "2026-06-18"); `night_of` is
+            // the mapper's evening date, stored as the UTC date of `computeNightOf`.
+            // Deleting by `n.night` would wipe the FOLLOWING night — so the key is
+            // derived exactly as the writer derives it, from inside the window.
+            const nights = new Set([
+                storedNightOf(n.windowStart, timeZone),
+                ...out.sleep_session.map(s => s.night_of.toISOString().slice(0, 10)),
+            ]);
+            for (const night of nights)
+                await replaceNight(ctx, night);
+            sessions.push(...out.sleep_session);
+            stages.push(...out.sleep_stage);
+        }
+        return { sessions, stages };
+    }
+    return {
+        noteRaw(batch) {
+            let min = Number.POSITIVE_INFINITY;
+            let max = Number.NEGATIVE_INFINITY;
+            for (const row of batch.rows) {
+                const e = epochOf(row.ts);
+                if (e == null)
+                    continue;
+                if (e < min)
+                    min = e;
+                if (e > max)
+                    max = e;
+            }
+            if (!Number.isFinite(min))
+                return;
+            const key = `${batch.brand}|${batch.familyId}|${batch.userId}|${batch.deviceId}`;
+            const prev = pending.get(key);
+            pending.set(key, {
+                brand: batch.brand,
+                familyId: batch.familyId,
+                userId: batch.userId,
+                deviceId: batch.deviceId,
+                minEpoch: prev ? Math.min(prev.minEpoch, min) : min,
+                maxEpoch: prev ? Math.max(prev.maxEpoch, max) : max,
+            });
+        },
+        pendingCount: () => pending.size,
+        async derive(batchId, reason) {
+            if (pending.size === 0)
+                return;
+            const ranges = [...pending.values()];
+            pending.clear();
+            for (const p of ranges) {
+                try {
+                    const { sessions, stages } = await deriveRange(p);
+                    const tenant = { brand: p.brand, familyId: p.familyId, userId: p.userId, deviceId: p.deviceId };
+                    if (sessions.length > 0)
+                        await deps.buffer.push({ table: 'sleep_session', ...tenant, rows: sessions });
+                    if (stages.length > 0)
+                        await deps.buffer.push({ table: 'sleep_stage', ...tenant, rows: stages });
+                }
+                catch (err) {
+                    deps.logger?.warn('sync.sleep-derive: correction failed; raw sleep kept, nights unchanged', {
+                        userId: p.userId,
+                        deviceId: p.deviceId,
+                        err: err instanceof Error ? err.message : String(err),
+                    });
+                }
+            }
+            // Land the derived rows inside this batch, so batch:complete follows them.
+            await deps.flusher.flush('sleep_session', reason, batchId);
+            await deps.flusher.flush('sleep_stage', reason, batchId);
+        },
+    };
+}
+//# sourceMappingURL=sleep-derive.js.map

package/dist/sync/sleep-derive.js.map

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

package/dist/tools/impls/anomaly.js

@@ -9,7 +9,7 @@ export const detectAnomalyInputSchema = z.object({
 const METRIC_SPECS = {
     hrv_ms: {
         sql: lookbackDays => `SELECT date_trunc('day', ts)::VARCHAR AS day, AVG(hrv_ms)::DOUBLE AS value
-       FROM v_hrv
+       FROM v_hrv_clean
        WHERE user_id = $userId AND brand = $brand AND family_id = $familyId
          AND hrv_ms IS NOT NULL
          AND ts >= now() - INTERVAL (${lookbackDays}) DAY

package/dist/tools/impls/compare.js

@@ -9,7 +9,7 @@ export const compareTrendInputSchema = z.object({
 const METRIC_SPECS = {
     hrv_ms: {
         sql: (windowDays, offsetDays) => `SELECT AVG(hrv_ms)::DOUBLE AS value
-       FROM v_hrv
+       FROM v_hrv_clean
        WHERE user_id = $userId AND brand = $brand AND family_id = $familyId
          AND hrv_ms IS NOT NULL
          AND ts >= now() - INTERVAL (${windowDays + offsetDays}) DAY

package/dist/tools/impls/hrv.js

@@ -6,7 +6,7 @@ export const getHRVInputSchema = z.object({
 });
 export const getHRV = async (input, ctx) => {
     const rows = await ctx.analytics.execute(`SELECT date_trunc('day', ts)::VARCHAR AS day, AVG(hrv_ms)::DOUBLE AS avg_hrv
-     FROM v_hrv
+     FROM v_hrv_clean
      WHERE user_id = $userId AND brand = $brand AND family_id = $familyId
        AND ts >= now() - INTERVAL (CAST($days AS BIGINT)) DAY
        AND hrv_ms IS NOT NULL

package/dist/tools/impls/spo2.js

@@ -39,7 +39,7 @@ export const getSpO2 = async (input, ctx) => {
             AVG(m.spo2)::DOUBLE AS avg_spo2,
             MIN(m.spo2)::DOUBLE AS min_spo2,
             COUNT(*) FILTER (WHERE m.spo2 < ${LOW_MOMENT_THRESHOLD})::INTEGER AS low_moment_count
-     FROM v_spo2 m
+     FROM v_spo2_clean m
      INNER JOIN v_sleep_session s
         ON s.user_id = m.user_id
        AND s.brand = m.brand

package/dist/tools/impls/temperature.js

@@ -25,7 +25,7 @@ export const getTemperature = async (input, ctx) => {
             AVG(temp_c)::DOUBLE AS avg_temp,
             MAX(temp_c)::DOUBLE AS hi_temp,
             MIN(temp_c)::DOUBLE AS lo_temp
-     FROM v_temperature
+     FROM v_temperature_clean
      WHERE user_id = $userId AND brand = $brand AND family_id = $familyId
        AND ts >= now() - INTERVAL (CAST($days AS BIGINT)) DAY
        AND temp_c IS NOT NULL

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mongrov/analytics",
-  "version": "0.23.2",
+  "version": "0.25.0",
   "sideEffects": false,
   "description": "DuckDB + R2 Iceberg local analytics for @mongrov apps",
   "license": "MIT",
@@ -61,7 +61,7 @@
   ],
   "peerDependencies": {
     "@modelcontextprotocol/sdk": ">=1.20.0",
-    "@mongrov/types": "^0.9.0",
+    "@mongrov/types": "^0.10.0",
     "ai": ">=4",
     "react": ">=19",
     "react-native": ">=0.81",
@@ -108,7 +108,7 @@
     "vitest": "^2.1.9",
     "zod": "^3.23.8",
     "@mongrov/db": "0.3.0",
-    "@mongrov/types": "0.9.0"
+    "@mongrov/types": "0.10.0"
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",