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

package/dist/sync/mapper/time.js

@@ -0,0 +1,107 @@
+/**
+ * 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.
+ */
+import { formatInTimeZone, fromZonedTime } from 'date-fns-tz';
+/**
+ * Match `"YYYY.MM.DD HH:MM:SS"` exactly. Firmware writes UTC into this shape.
+ *
+ * We accept a single-digit month/day/hour/minute/second tolerantly because the
+ * ring firmware has been observed to omit leading zeros on some fields.
+ */
+const FIRMWARE_TIMESTAMP_RE = /^(\d{4})\.(\d{1,2})\.(\d{1,2}) (\d{1,2}):(\d{1,2}):(\d{1,2})$/;
+/**
+ * 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 function parseTimestamp(fwStr) {
+    if (typeof fwStr !== 'string') {
+        throw new TypeError(`parseTimestamp: expected string, got ${typeof fwStr}`);
+    }
+    const match = fwStr.match(FIRMWARE_TIMESTAMP_RE);
+    if (!match) {
+        throw new Error(`parseTimestamp: unrecognised firmware timestamp shape: ${JSON.stringify(fwStr)}`);
+    }
+    const [, y, m, d, hh, mm, ss] = match;
+    const iso = `${y}-${pad(m)}-${pad(d)}T${pad(hh)}:${pad(mm)}:${pad(ss)}.000Z`;
+    const parsed = new Date(iso);
+    if (Number.isNaN(parsed.getTime())) {
+        throw new Error(`parseTimestamp: produced an invalid Date from ${JSON.stringify(fwStr)}`);
+    }
+    return parsed;
+}
+/**
+ * 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 function computeNightOf(ts, tz) {
+    if (!(ts instanceof Date) || Number.isNaN(ts.getTime())) {
+        throw new TypeError('computeNightOf: ts must be a valid Date');
+    }
+    if (typeof tz !== 'string' || tz.length === 0) {
+        throw new TypeError('computeNightOf: tz must be a non-empty IANA string');
+    }
+    // `formatInTimeZone` is unambiguous: it renders `ts` as wall-clock in `tz`
+    // regardless of the JS runtime's local zone. `toZonedTime` semantics changed
+    // in v3 (returns a Date whose *local* methods reflect zoned time), so we
+    // avoid it here in favour of pure string extraction.
+    const localDate = formatInTimeZone(ts, tz, 'yyyy-MM-dd'); // e.g. '2026-06-17'
+    const localHour = Number(formatInTimeZone(ts, tz, 'HH')); // 0..23
+    const [y, m, d] = localDate.split('-').map(Number);
+    // If before 18:00 local, roll back one day. Use UTC arithmetic so we get
+    // safe rollover across month/year boundaries without accidentally consulting
+    // the runtime's local timezone.
+    let nightY = y;
+    let nightM = m;
+    let nightD = d;
+    if (localHour < 18) {
+        const rolled = new Date(Date.UTC(y, m - 1, d - 1));
+        nightY = rolled.getUTCFullYear();
+        nightM = rolled.getUTCMonth() + 1;
+        nightD = rolled.getUTCDate();
+    }
+    // Build the local-midnight ISO string for the night's day, then convert to
+    // the equivalent UTC instant via `fromZonedTime`.
+    const isoLocalMidnight = `${nightY.toString().padStart(4, '0')}-${nightM
+        .toString()
+        .padStart(2, '0')}-${nightD.toString().padStart(2, '0')}T00:00:00.000`;
+    return fromZonedTime(isoLocalMidnight, tz);
+}
+function pad(n) {
+    return n.length === 1 ? `0${n}` : n;
+}
+//# sourceMappingURL=time.js.map

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

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

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

@@ -0,0 +1,152 @@
+/**
+ * Firmware and mapped-row types shared across every mapper module.
+ *
+ * Firmware shapes (`Firmware*Row`, `FirmwareExport`, `FirmwareRingConfig`) are
+ * *input* — they mirror the JSON the ring firmware emits at sync time.
+ *
+ * Row shapes (`HrvRow`, `HeartRateRow`, ...) are *output* — they match the
+ * warehouse DDL in `core/schemas.ts`. Every mapper is a pure function from
+ * `Firmware*Row[]` (+ `MapperContext`) to `<Row>[]`.
+ *
+ * See `.specifica/features/analytics-sync/spec.md` §Firmware mapper and
+ * `.specifica/features/analytics-core/spec.md` §Table schema.
+ */
+export interface MapperContext {
+    brand: string;
+    familyId: string;
+    userId: string;
+    deviceId: string;
+    /** IANA timezone string, e.g. 'America/Los_Angeles'. */
+    userTimezone: string;
+}
+export interface FirmwareHRVRow {
+    timestamp: string;
+    hrv?: number;
+    stress?: number;
+    /** Sentinel 0 → NULL. Preserved as collected_only. */
+    heartRate?: number;
+    systolicBP?: number;
+    diastolicBP?: number;
+    vascularAging?: number;
+}
+export interface FirmwareHRRow {
+    timestamp: string;
+    singleHR: number;
+}
+export interface FirmwareSpO2Row {
+    timestamp: string;
+    automaticSpo2Data: number;
+}
+export interface FirmwareTempRow {
+    timestamp: string;
+    temperature: number;
+}
+export interface FirmwareActivityRow {
+    timestamp: string;
+    step: number;
+    calories: number;
+    distance: number;
+    arraySteps: number[];
+}
+export interface FirmwareSleepRow {
+    start: string;
+    end: string;
+    block_type: string;
+    confidence: number;
+    timestamp: string;
+}
+export interface FirmwareBatteryRow {
+    timestamp: string;
+    battery: number;
+}
+export interface FirmwareRingConfig {
+    automaticMonitoringData: FirmwareMonitoringWindow[];
+}
+export interface FirmwareMonitoringWindow {
+    metric: string;
+    interval_minutes: number;
+    start_hour: number;
+    end_hour: number;
+}
+export interface FirmwareExport {
+    heartrate: FirmwareHRRow[];
+    hrv_table: FirmwareHRVRow[];
+    spo2: FirmwareSpO2Row[];
+    temperature_table: FirmwareTempRow[];
+    activitydetails: FirmwareActivityRow[];
+    sleep_processed: FirmwareSleepRow[];
+    battery_table: FirmwareBatteryRow[];
+    ring: FirmwareRingConfig;
+}
+interface BaseRow {
+    ts: Date;
+    brand: string;
+    family_id: string;
+    user_id: string;
+    device_id: string;
+}
+export interface HrvRow extends BaseRow {
+    hrv_ms: number | null;
+    stress: number | null;
+    systolic_bp: number | null;
+    diastolic_bp: number | null;
+    vascular_aging: number | null;
+}
+export interface HeartRateRow extends BaseRow {
+    bpm: number;
+}
+export interface Spo2Row extends BaseRow {
+    spo2: number;
+}
+export interface TemperatureRow extends BaseRow {
+    temp_c: number;
+}
+export interface ActivityRow extends BaseRow {
+    steps: number;
+}
+export interface ActivityBucketRow extends BaseRow {
+    steps: number;
+    calories: number;
+    distance_km: number;
+}
+export interface SleepSessionRow extends BaseRow {
+    session_id: string;
+    start_ts: Date;
+    end_ts: Date;
+    night_of: Date;
+}
+export interface SleepStageRow extends BaseRow {
+    session_id: string;
+    stage: string;
+    confidence: number;
+}
+export interface SleepRawRow extends BaseRow {
+    payload: FirmwareSleepRow;
+}
+export interface DeviceEventRow extends BaseRow {
+    event_type: string;
+    payload: Record<string, unknown>;
+}
+export interface DeviceConfigRow extends BaseRow {
+    metric: string;
+    interval_minutes: number;
+    start_hour: number;
+    end_hour: number;
+    valid_from: Date;
+    valid_to: Date | null;
+}
+export interface MappedBatch {
+    hrv: HrvRow[];
+    heart_rate: HeartRateRow[];
+    spo2: Spo2Row[];
+    temperature: TemperatureRow[];
+    activity: ActivityRow[];
+    activity_bucket: ActivityBucketRow[];
+    sleep_session: SleepSessionRow[];
+    sleep_stage: SleepStageRow[];
+    sleep_raw: SleepRawRow[];
+    device_event: DeviceEventRow[];
+    device_config: DeviceConfigRow[];
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/sync/mapper/types.js

@@ -0,0 +1,15 @@
+/**
+ * Firmware and mapped-row types shared across every mapper module.
+ *
+ * Firmware shapes (`Firmware*Row`, `FirmwareExport`, `FirmwareRingConfig`) are
+ * *input* — they mirror the JSON the ring firmware emits at sync time.
+ *
+ * Row shapes (`HrvRow`, `HeartRateRow`, ...) are *output* — they match the
+ * warehouse DDL in `core/schemas.ts`. Every mapper is a pure function from
+ * `Firmware*Row[]` (+ `MapperContext`) to `<Row>[]`.
+ *
+ * See `.specifica/features/analytics-sync/spec.md` §Firmware mapper and
+ * `.specifica/features/analytics-core/spec.md` §Table schema.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/sync/mapper/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/sync/overflow.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Overflow store (T-11).
+ *
+ * Persistent tail of the sensor buffer. When the in-memory ring exceeds its
+ * byte budget, chunks spill to the KVStore keyed by
+ *   `sync:overflow:{table}:{seq}`
+ *
+ * A per-table manifest at `sync:overflow:{table}:manifest` holds the ordered
+ * list of live seq numbers so we can drain / count / clear without a
+ * `list()` op on KVStore. The manifest is kept in-memory too — hydrated once
+ * per table on first access and mutated in lock-step with the KV writes.
+ *
+ * Ordering guarantee: seq numbers are monotonic per table, so a FIFO drain
+ * over the manifest reproduces enqueue order.
+ */
+import type { KVStore } from '../core/types';
+import type { BufferEntry } from './types';
+export declare class OverflowStore {
+    #private;
+    constructor(kv: KVStore);
+    push(table: string, entry: BufferEntry): Promise<void>;
+    /**
+     * Drain up to `limit` entries in FIFO order. Reads + deletes them from KV
+     * and updates the manifest. If `limit` is omitted, drains everything.
+     */
+    drain(table: string, limit?: number): Promise<BufferEntry[]>;
+    count(table: string): Promise<number>;
+    clear(table: string): Promise<void>;
+}
+//# sourceMappingURL=overflow.d.ts.map

package/dist/sync/overflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overflow.d.ts","sourceRoot":"","sources":["../../src/sync/overflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAoB1C,qBAAa,aAAa;;gBAIZ,EAAE,EAAE,OAAO;IAIjB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAW5D;;;OAGG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA4B5D,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKrC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CA6B1C"}

package/dist/sync/overflow.js

@@ -0,0 +1,114 @@
+/**
+ * Overflow store (T-11).
+ *
+ * Persistent tail of the sensor buffer. When the in-memory ring exceeds its
+ * byte budget, chunks spill to the KVStore keyed by
+ *   `sync:overflow:{table}:{seq}`
+ *
+ * A per-table manifest at `sync:overflow:{table}:manifest` holds the ordered
+ * list of live seq numbers so we can drain / count / clear without a
+ * `list()` op on KVStore. The manifest is kept in-memory too — hydrated once
+ * per table on first access and mutated in lock-step with the KV writes.
+ *
+ * Ordering guarantee: seq numbers are monotonic per table, so a FIFO drain
+ * over the manifest reproduces enqueue order.
+ */
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _OverflowStore_instances, _OverflowStore_kv, _OverflowStore_tables, _OverflowStore_hydrate;
+const KEY_PREFIX = 'sync:overflow';
+function chunkKey(table, seq) {
+    return `${KEY_PREFIX}:${table}:${seq}`;
+}
+function manifestKey(table) {
+    return `${KEY_PREFIX}:${table}:manifest`;
+}
+export class OverflowStore {
+    constructor(kv) {
+        _OverflowStore_instances.add(this);
+        _OverflowStore_kv.set(this, void 0);
+        _OverflowStore_tables.set(this, new Map());
+        __classPrivateFieldSet(this, _OverflowStore_kv, kv, "f");
+    }
+    async push(table, entry) {
+        const state = await __classPrivateFieldGet(this, _OverflowStore_instances, "m", _OverflowStore_hydrate).call(this, table);
+        const seq = state.nextSeq++;
+        state.seqs.push(seq);
+        await __classPrivateFieldGet(this, _OverflowStore_kv, "f").set(chunkKey(table, seq), entry);
+        await __classPrivateFieldGet(this, _OverflowStore_kv, "f").set(manifestKey(table), {
+            seqs: state.seqs,
+            nextSeq: state.nextSeq,
+        });
+    }
+    /**
+     * Drain up to `limit` entries in FIFO order. Reads + deletes them from KV
+     * and updates the manifest. If `limit` is omitted, drains everything.
+     */
+    async drain(table, limit) {
+        const state = await __classPrivateFieldGet(this, _OverflowStore_instances, "m", _OverflowStore_hydrate).call(this, table);
+        const take = limit ?? state.seqs.length;
+        if (take <= 0 || state.seqs.length === 0)
+            return [];
+        const drained = [];
+        const seqsToRemove = state.seqs.slice(0, take);
+        for (const seq of seqsToRemove) {
+            const entry = await __classPrivateFieldGet(this, _OverflowStore_kv, "f").get(chunkKey(table, seq));
+            if (entry)
+                drained.push(entry);
+            await __classPrivateFieldGet(this, _OverflowStore_kv, "f").delete(chunkKey(table, seq));
+        }
+        state.seqs = state.seqs.slice(take);
+        if (state.seqs.length === 0) {
+            // Reset nextSeq so a re-fill after a full drain doesn't leak counter
+            // growth. Manifest is deleted rather than persisted as empty.
+            state.nextSeq = 0;
+            await __classPrivateFieldGet(this, _OverflowStore_kv, "f").delete(manifestKey(table));
+        }
+        else {
+            await __classPrivateFieldGet(this, _OverflowStore_kv, "f").set(manifestKey(table), {
+                seqs: state.seqs,
+                nextSeq: state.nextSeq,
+            });
+        }
+        return drained;
+    }
+    async count(table) {
+        const state = await __classPrivateFieldGet(this, _OverflowStore_instances, "m", _OverflowStore_hydrate).call(this, table);
+        return state.seqs.length;
+    }
+    async clear(table) {
+        const state = await __classPrivateFieldGet(this, _OverflowStore_instances, "m", _OverflowStore_hydrate).call(this, table);
+        for (const seq of state.seqs) {
+            await __classPrivateFieldGet(this, _OverflowStore_kv, "f").delete(chunkKey(table, seq));
+        }
+        state.seqs = [];
+        state.nextSeq = 0;
+        await __classPrivateFieldGet(this, _OverflowStore_kv, "f").delete(manifestKey(table));
+    }
+}
+_OverflowStore_kv = new WeakMap(), _OverflowStore_tables = new WeakMap(), _OverflowStore_instances = new WeakSet(), _OverflowStore_hydrate = async function _OverflowStore_hydrate(table) {
+    let state = __classPrivateFieldGet(this, _OverflowStore_tables, "f").get(table);
+    if (state && state.hydrated)
+        return state;
+    if (!state) {
+        state = { seqs: [], nextSeq: 0, hydrated: false };
+        __classPrivateFieldGet(this, _OverflowStore_tables, "f").set(table, state);
+    }
+    const manifest = await __classPrivateFieldGet(this, _OverflowStore_kv, "f").get(manifestKey(table));
+    if (manifest && Array.isArray(manifest.seqs)) {
+        state.seqs = [...manifest.seqs];
+        state.nextSeq = Number.isFinite(manifest.nextSeq) ? manifest.nextSeq : 0;
+    }
+    state.hydrated = true;
+    return state;
+};
+//# sourceMappingURL=overflow.js.map

package/dist/sync/overflow.js.map

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

package/dist/sync/pusher.d.ts

@@ -0,0 +1,59 @@
+/**
+ * R2 pusher (T-17 + T-18).
+ *
+ * Pushes per-table deltas from the local DuckDB warehouse to the attached R2
+ * Iceberg zone. Each table push:
+ *   1. Reads the push watermark for `(brand, familyId, table)`.
+ *   2. Computes the max `ts` currently in local for that filter.
+ *   3. Issues `INSERT INTO <remote>.<table> SELECT * FROM <local>.<table>
+ *      WHERE ts > $watermark AND family_id = $familyId`.
+ *   4. On success, advances the watermark to the max `ts` observed.
+ *
+ * Auth recovery (spec §R2 pusher): a 401 triggers `refreshToken()` and one
+ * retry. Other errors preserve the watermark so nothing is lost.
+ *
+ * Parallel push (T-18): `pushAll(tables, ctx)` fans out via
+ * `Promise.allSettled` so per-table failures don't hold up the rest.
+ */
+import type { HybridDuckDB } from '../core/engine';
+import type { AttachContext } from '../core/types';
+import { SyncError } from './errors';
+import type { PushEmitter } from './events';
+import type { WatermarkStore } from './watermark';
+export interface PushResult {
+    table: string;
+    rowsPushed: number;
+    ok: boolean;
+    error?: SyncError;
+}
+export interface R2PusherConfig {
+    engine: HybridDuckDB;
+    watermark: WatermarkStore;
+    /** Refresh the attach token on 401. Called once per push before retrying. */
+    refreshToken?: () => Promise<void>;
+    /**
+     * Detects a 401 from an arbitrary thrown value. Defaults to a `.message`
+     * substring match on '401' or 'unauthorized'.
+     */
+    is401?: (err: unknown) => boolean;
+    /**
+     * SQL name builders. Defaults follow the warehouse convention:
+     *   local  = `main.<table>`
+     *   remote = `zone_<familyId>.<table>`
+     * Override if the warehouse module produces different aliases.
+     */
+    localTable?: (ctx: AttachContext, table: string) => string;
+    remoteTable?: (ctx: AttachContext, table: string) => string;
+    /**
+     * Optional event-bus adapter. Emits `${table}:sync_complete` after each
+     * successful push. See `events.ts` / `bindPushEvents()`.
+     */
+    emit?: PushEmitter;
+}
+export declare class R2Pusher {
+    #private;
+    constructor(config: R2PusherConfig);
+    push(table: string, ctx: AttachContext): Promise<PushResult>;
+    pushAll(tables: readonly string[], ctx: AttachContext): Promise<PushResult[]>;
+}
+//# sourceMappingURL=pusher.d.ts.map

package/dist/sync/pusher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pusher.d.ts","sourceRoot":"","sources":["../../src/sync/pusher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACpC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,EAAE,EAAE,OAAO,CAAA;IACX,KAAK,CAAC,EAAE,SAAS,CAAA;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,YAAY,CAAA;IACpB,SAAS,EAAE,cAAc,CAAA;IACzB,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAClC;;;OAGG;IACH,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAA;IACjC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;IAC1D,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;IAC3D;;;OAGG;IACH,IAAI,CAAC,EAAE,WAAW,CAAA;CACnB;AAYD,qBAAa,QAAQ;;gBASP,MAAM,EAAE,cAAc;IAU5B,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;IAwB5D,OAAO,CACX,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,GAAG,EAAE,aAAa,GACjB,OAAO,CAAC,UAAU,EAAE,CAAC;CAkEzB"}

package/dist/sync/pusher.js

@@ -0,0 +1,115 @@
+/**
+ * R2 pusher (T-17 + T-18).
+ *
+ * Pushes per-table deltas from the local DuckDB warehouse to the attached R2
+ * Iceberg zone. Each table push:
+ *   1. Reads the push watermark for `(brand, familyId, table)`.
+ *   2. Computes the max `ts` currently in local for that filter.
+ *   3. Issues `INSERT INTO <remote>.<table> SELECT * FROM <local>.<table>
+ *      WHERE ts > $watermark AND family_id = $familyId`.
+ *   4. On success, advances the watermark to the max `ts` observed.
+ *
+ * Auth recovery (spec §R2 pusher): a 401 triggers `refreshToken()` and one
+ * retry. Other errors preserve the watermark so nothing is lost.
+ *
+ * Parallel push (T-18): `pushAll(tables, ctx)` fans out via
+ * `Promise.allSettled` so per-table failures don't hold up the rest.
+ */
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _R2Pusher_instances, _R2Pusher_engine, _R2Pusher_watermark, _R2Pusher_refreshToken, _R2Pusher_is401, _R2Pusher_localTable, _R2Pusher_remoteTable, _R2Pusher_emit, _R2Pusher_pushOrCatch, _R2Pusher_pushOnce, _R2Pusher_toFailure;
+import { SyncError } from './errors';
+const DEFAULT_IS_401 = (err) => {
+    if (!err || typeof err !== 'object')
+        return false;
+    const msg = String(err.message ?? '').toLowerCase();
+    return msg.includes('401') || msg.includes('unauthorized');
+};
+const DEFAULT_LOCAL = (_c, table) => `main.${table}`;
+const DEFAULT_REMOTE = (c, table) => `zone_${c.tenantId}.${table}`;
+export class R2Pusher {
+    constructor(config) {
+        _R2Pusher_instances.add(this);
+        _R2Pusher_engine.set(this, void 0);
+        _R2Pusher_watermark.set(this, void 0);
+        _R2Pusher_refreshToken.set(this, void 0);
+        _R2Pusher_is401.set(this, void 0);
+        _R2Pusher_localTable.set(this, void 0);
+        _R2Pusher_remoteTable.set(this, void 0);
+        _R2Pusher_emit.set(this, void 0);
+        __classPrivateFieldSet(this, _R2Pusher_engine, config.engine, "f");
+        __classPrivateFieldSet(this, _R2Pusher_watermark, config.watermark, "f");
+        __classPrivateFieldSet(this, _R2Pusher_refreshToken, config.refreshToken, "f");
+        __classPrivateFieldSet(this, _R2Pusher_is401, config.is401 ?? DEFAULT_IS_401, "f");
+        __classPrivateFieldSet(this, _R2Pusher_localTable, config.localTable ?? DEFAULT_LOCAL, "f");
+        __classPrivateFieldSet(this, _R2Pusher_remoteTable, config.remoteTable ?? DEFAULT_REMOTE, "f");
+        __classPrivateFieldSet(this, _R2Pusher_emit, config.emit, "f");
+    }
+    async push(table, ctx) {
+        const result = await __classPrivateFieldGet(this, _R2Pusher_instances, "m", _R2Pusher_pushOrCatch).call(this, table, ctx);
+        __classPrivateFieldGet(this, _R2Pusher_emit, "f")?.call(this, result);
+        return result;
+    }
+    async pushAll(tables, ctx) {
+        const settled = await Promise.allSettled(tables.map(t => this.push(t, ctx)));
+        return settled.map((r, i) => {
+            if (r.status === 'fulfilled')
+                return r.value;
+            const err = r.reason instanceof SyncError
+                ? r.reason
+                : new SyncError('push_failed', 'push rejected', r.reason);
+            return { table: tables[i], rowsPushed: 0, ok: false, error: err };
+        });
+    }
+}
+_R2Pusher_engine = new WeakMap(), _R2Pusher_watermark = new WeakMap(), _R2Pusher_refreshToken = new WeakMap(), _R2Pusher_is401 = new WeakMap(), _R2Pusher_localTable = new WeakMap(), _R2Pusher_remoteTable = new WeakMap(), _R2Pusher_emit = new WeakMap(), _R2Pusher_instances = new WeakSet(), _R2Pusher_pushOrCatch = async function _R2Pusher_pushOrCatch(table, ctx) {
+    try {
+        return await __classPrivateFieldGet(this, _R2Pusher_instances, "m", _R2Pusher_pushOnce).call(this, table, ctx);
+    }
+    catch (err) {
+        if (__classPrivateFieldGet(this, _R2Pusher_is401, "f").call(this, err) && __classPrivateFieldGet(this, _R2Pusher_refreshToken, "f")) {
+            try {
+                await __classPrivateFieldGet(this, _R2Pusher_refreshToken, "f").call(this);
+                return await __classPrivateFieldGet(this, _R2Pusher_instances, "m", _R2Pusher_pushOnce).call(this, table, ctx);
+            }
+            catch (retryErr) {
+                return __classPrivateFieldGet(this, _R2Pusher_instances, "m", _R2Pusher_toFailure).call(this, table, retryErr, 'token_expired');
+            }
+        }
+        return __classPrivateFieldGet(this, _R2Pusher_instances, "m", _R2Pusher_toFailure).call(this, table, err, 'push_failed');
+    }
+}, _R2Pusher_pushOnce = async function _R2Pusher_pushOnce(table, ctx) {
+    const watermark = await __classPrivateFieldGet(this, _R2Pusher_watermark, "f").get(ctx.brand, ctx.tenantId, table, 'push');
+    const local = __classPrivateFieldGet(this, _R2Pusher_localTable, "f").call(this, ctx, table);
+    const remote = __classPrivateFieldGet(this, _R2Pusher_remoteTable, "f").call(this, ctx, table);
+    // Max ts to advance the watermark to. Null result → no new rows.
+    const maxRows = await __classPrivateFieldGet(this, _R2Pusher_engine, "f").execute(`SELECT MAX(ts) AS max_ts, COUNT(*) AS row_count FROM ${local} WHERE ts > $watermark AND family_id = $familyId`, { watermark: watermark.toISOString(), familyId: ctx.tenantId });
+    const first = maxRows[0];
+    const rowCount = Number(first?.row_count ?? 0);
+    if (rowCount === 0) {
+        return { table, rowsPushed: 0, ok: true };
+    }
+    await __classPrivateFieldGet(this, _R2Pusher_engine, "f").execute(`INSERT INTO ${remote} SELECT * FROM ${local} WHERE ts > $watermark AND family_id = $familyId`, { watermark: watermark.toISOString(), familyId: ctx.tenantId });
+    if (first?.max_ts) {
+        const nextWatermark = new Date(first.max_ts);
+        if (!Number.isNaN(nextWatermark.getTime())) {
+            await __classPrivateFieldGet(this, _R2Pusher_watermark, "f").advance(ctx.brand, ctx.tenantId, table, 'push', nextWatermark);
+        }
+    }
+    return { table, rowsPushed: rowCount, ok: true };
+}, _R2Pusher_toFailure = function _R2Pusher_toFailure(table, cause, code) {
+    const err = cause instanceof SyncError
+        ? cause
+        : new SyncError(code, `push failed for ${table}`, cause);
+    return { table, rowsPushed: 0, ok: false, error: err };
+};
+//# sourceMappingURL=pusher.js.map

package/dist/sync/pusher.js.map

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