@nativesquare/soma 0.8.0 → 0.9.1

package/dist/component/garmin/transform/dailies.js.map

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

package/dist/component/garmin/transform/epochs.d.ts

@@ -0,0 +1,13 @@
+import type { SomaDaily } from "../../validators/daily.js";
+import type { ClientEpoch } from "../types/wellnessApi/types.gen.js";
+/**
+ * Transform a Garmin epoch summary push item into a Soma Daily document shape.
+ *
+ * Epoch summaries represent 15-minute time slices of wellness monitoring data.
+ * They are ingested into the `daily` table via `ingestDaily`,
+ * keyed by `metadata.start_time + metadata.end_time`.
+ *
+ * Returns `null` when no meaningful data is present.
+ */
+export declare function transformEpoch(epoch: ClientEpoch): SomaDaily | null;
+//# sourceMappingURL=epochs.d.ts.map

package/dist/component/garmin/transform/epochs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"epochs.d.ts","sourceRoot":"","sources":["../../../../src/component/garmin/transform/epochs.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAErE;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI,CA+BnE"}

package/dist/component/garmin/transform/epochs.js

@@ -0,0 +1,76 @@
+// ─── Epochs Transformer ──────────────────────────────────────────────────────
+// Transforms a Garmin epoch summary push item into the Soma Daily schema shape.
+// Epoch summaries are 15-minute wellness monitoring records with per-activity-type
+// granularity (steps, distance, calories, MET). They are ingested into the daily
+// table just like daily summaries.
+/**
+ * Transform a Garmin epoch summary push item into a Soma Daily document shape.
+ *
+ * Epoch summaries represent 15-minute time slices of wellness monitoring data.
+ * They are ingested into the `daily` table via `ingestDaily`,
+ * keyed by `metadata.start_time + metadata.end_time`.
+ *
+ * Returns `null` when no meaningful data is present.
+ */
+export function transformEpoch(epoch) {
+    const startMs = (epoch.startTimeInSeconds ?? 0) * 1000;
+    const endMs = startMs + (epoch.durationInSeconds ?? 0) * 1000;
+    const activeDurations = buildActiveDurationsData(epoch);
+    const calories = buildCaloriesData(epoch);
+    const distance = buildDistanceData(epoch);
+    const met = buildMETData(epoch);
+    // Skip if there's no meaningful data at all
+    if (activeDurations == null &&
+        calories == null &&
+        distance == null &&
+        met == null) {
+        return null;
+    }
+    return {
+        metadata: {
+            start_time: new Date(startMs).toISOString(),
+            end_time: new Date(endMs).toISOString(),
+            upload_type: 1, // Automatic
+        },
+        active_durations_data: activeDurations,
+        calories_data: calories,
+        distance_data: distance,
+        MET_data: met,
+    };
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function buildActiveDurationsData(epoch) {
+    if (epoch.activeTimeInSeconds == null) {
+        return undefined;
+    }
+    return {
+        activity_seconds: epoch.activeTimeInSeconds,
+    };
+}
+function buildCaloriesData(epoch) {
+    if (epoch.activeKilocalories == null) {
+        return undefined;
+    }
+    return {
+        net_activity_calories: epoch.activeKilocalories,
+        total_burned_calories: epoch.activeKilocalories,
+    };
+}
+function buildDistanceData(epoch) {
+    if (epoch.distanceInMeters == null && epoch.steps == null) {
+        return undefined;
+    }
+    return {
+        distance_meters: epoch.distanceInMeters,
+        steps: epoch.steps,
+    };
+}
+function buildMETData(epoch) {
+    if (epoch.met == null) {
+        return undefined;
+    }
+    return {
+        avg_level: epoch.met,
+    };
+}
+//# sourceMappingURL=epochs.js.map

package/dist/component/garmin/transform/epochs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"epochs.js","sourceRoot":"","sources":["../../../../src/component/garmin/transform/epochs.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,gFAAgF;AAChF,mFAAmF;AACnF,iFAAiF;AACjF,mCAAmC;AAKnC;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,KAAkB;IAC/C,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,kBAAkB,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IACvD,MAAM,KAAK,GAAG,OAAO,GAAG,CAAC,KAAK,CAAC,iBAAiB,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IAE9D,MAAM,eAAe,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IAEhC,4CAA4C;IAC5C,IACE,eAAe,IAAI,IAAI;QACvB,QAAQ,IAAI,IAAI;QAChB,QAAQ,IAAI,IAAI;QAChB,GAAG,IAAI,IAAI,EACX,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,QAAQ,EAAE;YACR,UAAU,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE;YAC3C,QAAQ,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE;YACvC,WAAW,EAAE,CAAC,EAAE,YAAY;SAC7B;QAED,qBAAqB,EAAE,eAAe;QACtC,aAAa,EAAE,QAAQ;QACvB,aAAa,EAAE,QAAQ;QACvB,QAAQ,EAAE,GAAG;KACd,CAAC;AACJ,CAAC;AAED,iFAAiF;AAEjF,SAAS,wBAAwB,CAAC,KAAkB;IAClD,IAAI,KAAK,CAAC,mBAAmB,IAAI,IAAI,EAAE,CAAC;QACtC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,gBAAgB,EAAE,KAAK,CAAC,mBAAmB;KAC5C,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAkB;IAC3C,IAAI,KAAK,CAAC,kBAAkB,IAAI,IAAI,EAAE,CAAC;QACrC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,qBAAqB,EAAE,KAAK,CAAC,kBAAkB;QAC/C,qBAAqB,EAAE,KAAK,CAAC,kBAAkB;KAChD,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAkB;IAC3C,IAAI,KAAK,CAAC,gBAAgB,IAAI,IAAI,IAAI,KAAK,CAAC,KAAK,IAAI,IAAI,EAAE,CAAC;QAC1D,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,eAAe,EAAE,KAAK,CAAC,gBAAgB;QACvC,KAAK,EAAE,KAAK,CAAC,KAAK;KACnB,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,KAAkB;IACtC,IAAI,KAAK,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;QACtB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,GAAG;KACrB,CAAC;AACJ,CAAC"}

package/dist/component/garmin/transform/healthSnapshot.d.ts

@@ -0,0 +1,12 @@
+import type { SomaDaily } from "../../validators/daily.js";
+import type { ClientHealthSnapshot } from "../types/wellnessApi/types.gen.js";
+/**
+ * Transform a Garmin Health Snapshot push item into a Soma Daily document shape.
+ *
+ * Health Snapshot summaries contain epoch-level readings for heart rate, stress,
+ * SpO2, respiration, and HRV over a ~2-minute window.
+ *
+ * Returns `null` when no meaningful data is present.
+ */
+export declare function transformHealthSnapshot(snapshot: ClientHealthSnapshot): SomaDaily | null;
+//# sourceMappingURL=healthSnapshot.d.ts.map

package/dist/component/garmin/transform/healthSnapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"healthSnapshot.d.ts","sourceRoot":"","sources":["../../../../src/component/garmin/transform/healthSnapshot.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAE9E;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,oBAAoB,GAC7B,SAAS,GAAG,IAAI,CAkClB"}

package/dist/component/garmin/transform/healthSnapshot.js

@@ -0,0 +1,111 @@
+// ─── Health Snapshot Transformer ─────────────────────────────────────────────
+// Transforms a Garmin Health Snapshot push item into the Soma Daily schema shape.
+//
+// Health Snapshots are 2-minute sessions containing heart rate, stress, SpO2,
+// respiration, and HRV data. We map these into the Daily model since the data
+// types (HR, stress, oxygen, respiration) align with Daily's sub-fields.
+/**
+ * Transform a Garmin Health Snapshot push item into a Soma Daily document shape.
+ *
+ * Health Snapshot summaries contain epoch-level readings for heart rate, stress,
+ * SpO2, respiration, and HRV over a ~2-minute window.
+ *
+ * Returns `null` when no meaningful data is present.
+ */
+export function transformHealthSnapshot(snapshot) {
+    const startMs = (snapshot.startTimeInSeconds ?? 0) * 1000;
+    const endMs = startMs + (snapshot.durationInSeconds ?? 0) * 1000;
+    const summaries = snapshot.summaries;
+    if (!summaries || summaries.length === 0)
+        return null;
+    const heartRate = buildHeartRateData(snapshot);
+    const stress = buildStressData(snapshot);
+    const oxygen = buildOxygenData(snapshot);
+    const respiration = buildRespirationData(snapshot);
+    // Skip if there's no meaningful data at all
+    if (heartRate == null &&
+        stress == null &&
+        oxygen == null &&
+        respiration == null) {
+        return null;
+    }
+    return {
+        metadata: {
+            start_time: new Date(startMs).toISOString(),
+            end_time: new Date(endMs).toISOString(),
+            upload_type: 1, // Automatic
+        },
+        heart_rate_data: heartRate,
+        stress_data: stress,
+        oxygen_data: oxygen,
+        respiration_data: respiration,
+    };
+}
+function findSummary(snapshot, type) {
+    return snapshot.summaries?.find((s) => s.summaryType === type);
+}
+function buildHeartRateData(snapshot) {
+    const hr = findSummary(snapshot, "heart_rate");
+    const rmssd = findSummary(snapshot, "rmssd_hrv");
+    const sdrr = findSummary(snapshot, "sdrr_hrv");
+    if (!hr && !rmssd && !sdrr)
+        return undefined;
+    const hasSummary = hr?.avgValue != null || hr?.maxValue != null || hr?.minValue != null;
+    const hasHrvSummary = rmssd?.avgValue != null || sdrr?.avgValue != null;
+    const hrSamples = hr?.epochSummaries && Object.keys(hr.epochSummaries).length > 0
+        ? buildEpochSamples(snapshot.startTimeInSeconds, hr.epochSummaries, (bpm) => ({ bpm }))
+        : undefined;
+    return {
+        summary: hasSummary || hasHrvSummary
+            ? {
+                avg_hr_bpm: hr?.avgValue,
+                max_hr_bpm: hr?.maxValue,
+                min_hr_bpm: hr?.minValue,
+                avg_hrv_rmssd: rmssd?.avgValue,
+                avg_hrv_sdnn: sdrr?.avgValue,
+            }
+            : undefined,
+        detailed: hrSamples && hrSamples.length > 0
+            ? { hr_samples: hrSamples }
+            : undefined,
+    };
+}
+function buildStressData(snapshot) {
+    const stress = findSummary(snapshot, "stress");
+    if (!stress)
+        return undefined;
+    return {
+        avg_stress_level: stress.avgValue,
+        max_stress_level: stress.maxValue,
+    };
+}
+function buildOxygenData(snapshot) {
+    const spo2 = findSummary(snapshot, "spo2");
+    if (!spo2)
+        return undefined;
+    return {
+        avg_saturation_percentage: spo2.avgValue,
+    };
+}
+function buildRespirationData(snapshot) {
+    const resp = findSummary(snapshot, "respiration");
+    if (!resp)
+        return undefined;
+    return {
+        breaths_data: {
+            avg_breaths_per_min: resp.avgValue,
+            max_breaths_per_min: resp.maxValue,
+            min_breaths_per_min: resp.minValue,
+        },
+    };
+}
+/**
+ * Convert Garmin epoch-keyed summaries into timestamped samples.
+ */
+function buildEpochSamples(startTimeInSeconds, epochs, mapValue) {
+    return Object.entries(epochs).map(([offset, value]) => ({
+        timestamp: new Date(((startTimeInSeconds ?? 0) + parseInt(offset, 10)) * 1000).toISOString(),
+        ...mapValue(value),
+    }));
+}
+//# sourceMappingURL=healthSnapshot.js.map

package/dist/component/garmin/transform/healthSnapshot.js.map

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

package/dist/component/garmin/transform/hrvSummary.d.ts

@@ -0,0 +1,12 @@
+import type { SomaDaily } from "../../validators/daily.js";
+import type { ClientHrvSummary } from "../types/wellnessApi/types.gen.js";
+/**
+ * Transform a Garmin HRV summary push item into a partial Soma Daily shape.
+ *
+ * HRV summaries are ingested into the `daily` table via `ingestDaily`,
+ * enriching the daily record with HRV-specific heart rate data.
+ *
+ * Returns `null` when no meaningful HRV data is present.
+ */
+export declare function transformHRVSummary(hrv: ClientHrvSummary): SomaDaily | null;
+//# sourceMappingURL=hrvSummary.d.ts.map

package/dist/component/garmin/transform/hrvSummary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hrvSummary.d.ts","sourceRoot":"","sources":["../../../../src/component/garmin/transform/hrvSummary.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAE1E;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,gBAAgB,GAAG,SAAS,GAAG,IAAI,CAwC3E"}

package/dist/{garmin/hrv.js → component/garmin/transform/hrvSummary.js}

@@ -1,39 +1,39 @@
-// ─── HRV Transformer ─────────────────────────────────────────────────────────
-// Transforms Garmin HRV summary data into fields that enrich a Soma Daily record.
+// ─── HRV Summary Transformer ─────────────────────────────────────────────────
+// Transforms a Garmin HRV summary push item into a partial Soma Daily schema
+// shape. HRV data enriches daily records with heart_rate_data (HRV fields).
 /**
- * Transform a Garmin HRV summary into heart rate data fields for a Soma Daily.
+ * Transform a Garmin HRV summary push item into a partial Soma Daily shape.
  *
- * This produces a partial daily shape that can be merged into a matching
- * daily record by date.
+ * HRV summaries are ingested into the `daily` table via `ingestDaily`,
+ * enriching the daily record with HRV-specific heart rate data.
  *
- * @param hrv - The Garmin HRV summary from the Health API
- * @returns Partial Soma Daily heart_rate_data fields
+ * Returns `null` when no meaningful HRV data is present.
  */
-export function transformHRV(hrv) {
+export function transformHRVSummary(hrv) {
     const startMs = (hrv.startTimeInSeconds ?? 0) * 1000;
     const endMs = startMs + (hrv.durationInSeconds ?? 0) * 1000;
     const hasSummary = hrv.lastNightAvg != null || hrv.lastNight5MinHigh != null;
     const hasSamples = hrv.hrvValues != null && Object.keys(hrv.hrvValues).length > 0;
     if (!hasSummary && !hasSamples) {
-        return {
-            calendar_date: hrv.calendarDate,
-            heart_rate_data: undefined,
-        };
+        return null;
     }
     const startTime = hrv.startTimeInSeconds ?? 0;
     const hrvSamples = hasSamples
-        ? Object.entries(hrv.hrvValues).map(([offset, rmssd]) => ({
+        ? Object.entries(hrv.hrvValues ?? {}).map(([offset, rmssd]) => ({
             timestamp: new Date((startTime + parseInt(offset, 10)) * 1000).toISOString(),
             hrv_rmssd: rmssd,
         }))
         : undefined;
     return {
-        calendar_date: hrv.calendarDate,
+        metadata: {
+            start_time: new Date(startMs).toISOString(),
+            end_time: new Date(endMs).toISOString(),
+            upload_type: 1, // Automatic
+        },
         heart_rate_data: {
             summary: hasSummary
                 ? {
                     avg_hrv_rmssd: hrv.lastNightAvg,
-                    max_hrv_rmssd: hrv.lastNight5MinHigh,
                 }
                 : undefined,
             detailed: hrvSamples && hrvSamples.length > 0
@@ -42,4 +42,4 @@ export function transformHRV(hrv) {
         },
     };
 }
-//# sourceMappingURL=hrv.js.map
+//# sourceMappingURL=hrvSummary.js.map

package/dist/component/garmin/transform/hrvSummary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hrvSummary.js","sourceRoot":"","sources":["../../../../src/component/garmin/transform/hrvSummary.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,6EAA6E;AAC7E,4EAA4E;AAK5E;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAqB;IACvD,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,kBAAkB,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IACrD,MAAM,KAAK,GAAG,OAAO,GAAG,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IAE5D,MAAM,UAAU,GAAG,GAAG,CAAC,YAAY,IAAI,IAAI,IAAI,GAAG,CAAC,iBAAiB,IAAI,IAAI,CAAC;IAC7E,MAAM,UAAU,GACd,GAAG,CAAC,SAAS,IAAI,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAEjE,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,SAAS,GAAG,GAAG,CAAC,kBAAkB,IAAI,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,UAAU;QAC3B,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;YAC9D,SAAS,EAAE,IAAI,IAAI,CACjB,CAAC,SAAS,GAAG,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,CAC1C,CAAC,WAAW,EAAE;YACf,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;QACH,CAAC,CAAC,SAAS,CAAC;IAEd,OAAO;QACL,QAAQ,EAAE;YACR,UAAU,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE;YAC3C,QAAQ,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE;YACvC,WAAW,EAAE,CAAC,EAAE,YAAY;SAC7B;QACD,eAAe,EAAE;YACf,OAAO,EAAE,UAAU;gBACjB,CAAC,CAAC;oBACA,aAAa,EAAE,GAAG,CAAC,YAAY;iBAChC;gBACD,CAAC,CAAC,SAAS;YACb,QAAQ,EACN,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;gBACjC,CAAC,CAAC,EAAE,iBAAiB,EAAE,UAAU,EAAE;gBACnC,CAAC,CAAC,SAAS;SAChB;KACF,CAAC;AACJ,CAAC"}

package/dist/component/garmin/transform/manuallyUpdatedActivities.d.ts

@@ -0,0 +1,11 @@
+import type { SomaActivity } from "../../validators/activity.js";
+import type { ClientActivity } from "../types/wellnessApi/types.gen.js";
+/**
+ * Transform a Garmin manually updated activity into a Soma Activity shape.
+ *
+ * Per the Garmin API, manually updated activities always have `manual: true`.
+ * We enforce `upload_type: 2` regardless, since these items are by definition
+ * manual edits from Garmin Connect.
+ */
+export declare function transformManuallyUpdatedActivity(activity: ClientActivity): SomaActivity;
+//# sourceMappingURL=manuallyUpdatedActivities.d.ts.map

package/dist/component/garmin/transform/manuallyUpdatedActivities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manuallyUpdatedActivities.d.ts","sourceRoot":"","sources":["../../../../src/component/garmin/transform/manuallyUpdatedActivities.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAGxE;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,cAAc,GACvB,YAAY,CAOd"}

package/dist/component/garmin/transform/manuallyUpdatedActivities.js

@@ -0,0 +1,20 @@
+// ─── Manually Updated Activity Transformer ───────────────────────────────────
+// Transforms a Garmin manually updated activity into the Soma Activity schema.
+//
+// Manually updated activities share the same data model as regular activities,
+// so we delegate to transformActivity but force upload_type = 2 (manual).
+import { transformActivity } from "./activity.js";
+/**
+ * Transform a Garmin manually updated activity into a Soma Activity shape.
+ *
+ * Per the Garmin API, manually updated activities always have `manual: true`.
+ * We enforce `upload_type: 2` regardless, since these items are by definition
+ * manual edits from Garmin Connect.
+ */
+export function transformManuallyUpdatedActivity(activity) {
+    const result = transformActivity(activity);
+    // Force manual upload type — these are always user-edited on Garmin Connect
+    result.metadata.upload_type = 2;
+    return result;
+}
+//# sourceMappingURL=manuallyUpdatedActivities.js.map

package/dist/component/garmin/transform/manuallyUpdatedActivities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manuallyUpdatedActivities.js","sourceRoot":"","sources":["../../../../src/component/garmin/transform/manuallyUpdatedActivities.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,+EAA+E;AAC/E,EAAE;AACF,+EAA+E;AAC/E,0EAA0E;AAI1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,UAAU,gCAAgC,CAC9C,QAAwB;IAExB,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAE3C,4EAA4E;IAC5E,MAAM,CAAC,QAAQ,CAAC,WAAW,GAAG,CAAC,CAAC;IAEhC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/{garmin/maps/activity-type.d.ts → component/garmin/transform/maps/activityType.d.ts}

@@ -3,4 +3,4 @@
  * Returns Terra "Other" (108) for unknown types.
  */
 export declare function mapActivityType(activityType: string): number;
-//# sourceMappingURL=activity-type.d.ts.map
+//# sourceMappingURL=activityType.d.ts.map

package/dist/component/garmin/transform/maps/activityType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activityType.d.ts","sourceRoot":"","sources":["../../../../../src/component/garmin/transform/maps/activityType.ts"],"names":[],"mappings":"AA6GA;;;GAGG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE5D"}

package/dist/{garmin/maps/activity-type.js → component/garmin/transform/maps/activityType.js}

@@ -96,4 +96,4 @@ const activityTypeMap = {
 export function mapActivityType(activityType) {
     return activityTypeMap[activityType] ?? 108;
 }
-//# sourceMappingURL=activity-type.js.map
+//# sourceMappingURL=activityType.js.map

package/dist/component/garmin/transform/maps/activityType.js.map

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

package/dist/{garmin/maps/sleep-level.d.ts → component/garmin/transform/maps/sleepLevel.d.ts}

@@ -3,4 +3,4 @@
  * Returns 0 (Unknown) for unrecognized stages.
  */
 export declare function mapSleepLevel(stage: string): number;
-//# sourceMappingURL=sleep-level.d.ts.map
+//# sourceMappingURL=sleepLevel.d.ts.map

package/dist/component/garmin/transform/maps/sleepLevel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleepLevel.d.ts","sourceRoot":"","sources":["../../../../../src/component/garmin/transform/maps/sleepLevel.ts"],"names":[],"mappings":"AAeA;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/{garmin/maps/sleep-level.js → component/garmin/transform/maps/sleepLevel.js}

@@ -18,4 +18,4 @@ const sleepLevelMap = {
 export function mapSleepLevel(stage) {
     return sleepLevelMap[stage] ?? 0;
 }
-//# sourceMappingURL=sleep-level.js.map
+//# sourceMappingURL=sleepLevel.js.map

package/dist/component/garmin/transform/maps/sleepLevel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleepLevel.js","sourceRoot":"","sources":["../../../../../src/component/garmin/transform/maps/sleepLevel.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,oEAAoE;AACpE,EAAE;AACF,oEAAoE;AACpE,4DAA4D;AAC5D,EAAE;AACF,uFAAuF;AAEvF,MAAM,aAAa,GAA2B;IAC5C,IAAI,EAAE,CAAC,EAAI,oBAAoB;IAC/B,KAAK,EAAE,CAAC,EAAG,sBAAsB;IACjC,GAAG,EAAE,CAAC,EAAK,kBAAkB;IAC7B,KAAK,EAAE,CAAC,EAAG,sBAAsB;CAClC,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC"}

package/dist/component/garmin/transform/menstrualCycleTracking.d.ts

@@ -0,0 +1,10 @@
+import type { SomaMenstruation } from "../../validators/menstruation.js";
+import type { ClientSummarizedMenstrualCycle } from "../types/wellnessApi/types.gen.js";
+/**
+ * Transform a Garmin MCT push item into a Soma Menstruation document shape.
+ *
+ * MCT records are ingested into the `menstruation` table via
+ * `ingestMenstruation`, keyed by `metadata.start_time + metadata.end_time`.
+ */
+export declare function transformMenstrualCycleTracking(data: ClientSummarizedMenstrualCycle): SomaMenstruation;
+//# sourceMappingURL=menstrualCycleTracking.d.ts.map

package/dist/component/garmin/transform/menstrualCycleTracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menstrualCycleTracking.d.ts","sourceRoot":"","sources":["../../../../src/component/garmin/transform/menstrualCycleTracking.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,mCAAmC,CAAC;AAExF;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,8BAA8B,GAAG,gBAAgB,CA8BtG"}

package/dist/{garmin/menstruation.js → component/garmin/transform/menstrualCycleTracking.js}

@@ -1,20 +1,24 @@
-// ─── Menstruation Transformer ────────────────────────────────────────────────
-// Transforms Garmin menstrual cycle data into the Soma Menstruation schema shape.
+// ─── Menstrual Cycle Tracking Transformer ────────────────────────────────────
+// Transforms a Garmin MCT (Women's Health API) push item into the Soma
+// Menstruation schema shape.
+//
+// MCT summaries contain cycle schedule data (phase, length, fertile window,
+// pregnancy snapshot). We map these into the Menstruation model's
+// menstruation_data fields.
 /**
- * Transform a Garmin menstrual cycle record into a Soma Menstruation document shape.
+ * Transform a Garmin MCT push item into a Soma Menstruation document shape.
  *
- * @param data - The Garmin menstrual cycle data from the Health API
- * @returns Soma Menstruation fields (without connectionId/userId)
+ * MCT records are ingested into the `menstruation` table via
+ * `ingestMenstruation`, keyed by `metadata.start_time + metadata.end_time`.
  */
-export function transformMenstruation(data) {
-    // Spec uses periodStartDate (date string like "2021-01-04")
+export function transformMenstrualCycleTracking(data) {
     const dateStr = data.periodStartDate;
     const startTime = dateStr
         ? `${dateStr}T00:00:00.000Z`
-        : undefined;
+        : new Date(0).toISOString();
     const endTime = dateStr
         ? `${dateStr}T23:59:59.999Z`
-        : undefined;
+        : new Date(0).toISOString();
     return {
         metadata: {
             start_time: startTime,
@@ -22,17 +26,18 @@ export function transformMenstruation(data) {
         },
         menstruation_data: {
             day_in_cycle: data.dayInCycle,
-            // Spec has currentPhaseType (string) replacing deprecated currentPhase (int)
             current_phase: data.currentPhaseType?.toLowerCase(),
             length_of_current_phase_days: data.lengthOfCurrentPhase,
             days_until_next_phase: data.daysUntilNextPhase,
             period_length_days: data.periodLength,
             predicted_cycle_length_days: data.predictedCycleLength,
-            cycle_length_days: data.cycleLength,
+            cycle_length_days: data.cycleLength != null
+                ? String(data.cycleLength)
+                : undefined,
             is_predicted_cycle: data.isPredictedCycle != null
                 ? String(data.isPredictedCycle)
                 : undefined,
         },
     };
 }
-//# sourceMappingURL=menstruation.js.map
+//# sourceMappingURL=menstrualCycleTracking.js.map

package/dist/component/garmin/transform/menstrualCycleTracking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menstrualCycleTracking.js","sourceRoot":"","sources":["../../../../src/component/garmin/transform/menstrualCycleTracking.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,uEAAuE;AACvE,6BAA6B;AAC7B,EAAE;AACF,4EAA4E;AAC5E,kEAAkE;AAClE,4BAA4B;AAK5B;;;;;GAKG;AACH,MAAM,UAAU,+BAA+B,CAAC,IAAoC;IAClF,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC;IACrC,MAAM,SAAS,GAAG,OAAO;QACvB,CAAC,CAAC,GAAG,OAAO,gBAAgB;QAC5B,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,OAAO;QACrB,CAAC,CAAC,GAAG,OAAO,gBAAgB;QAC5B,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAE9B,OAAO;QACL,QAAQ,EAAE;YACR,UAAU,EAAE,SAAS;YACrB,QAAQ,EAAE,OAAO;SAClB;QAED,iBAAiB,EAAE;YACjB,YAAY,EAAE,IAAI,CAAC,UAAU;YAC7B,aAAa,EAAE,IAAI,CAAC,gBAAgB,EAAE,WAAW,EAAE;YACnD,4BAA4B,EAAE,IAAI,CAAC,oBAAoB;YACvD,qBAAqB,EAAE,IAAI,CAAC,kBAAkB;YAC9C,kBAAkB,EAAE,IAAI,CAAC,YAAY;YACrC,2BAA2B,EAAE,IAAI,CAAC,oBAAoB;YACtD,iBAAiB,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI;gBACzC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC;gBAC1B,CAAC,CAAC,SAAS;YACb,kBAAkB,EAAE,IAAI,CAAC,gBAAgB,IAAI,IAAI;gBAC/C,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC;gBAC/B,CAAC,CAAC,SAAS;SACd;KACF,CAAC;AACJ,CAAC"}

package/dist/component/garmin/transform/moveIQ.d.ts

@@ -0,0 +1,14 @@
+import type { ClientAutoActivityMoveIq } from "../types/wellnessApi/types.gen.js";
+import type { SomaActivity } from "../../validators/activity.js";
+/**
+ * Transform a Garmin Move IQ event into a Soma Activity document shape.
+ *
+ * Move IQ activityType values are lowercase (e.g. "running", "cycling"),
+ * unlike regular activities which use uppercase. We normalise to uppercase
+ * before mapping.
+ *
+ * The returned object is ready to be spread into an `ingestActivity` call
+ * alongside `connectionId` and `userId`.
+ */
+export declare function transformMoveIQ(event: ClientAutoActivityMoveIq): SomaActivity;
+//# sourceMappingURL=moveIQ.d.ts.map

package/dist/component/garmin/transform/moveIQ.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moveIQ.d.ts","sourceRoot":"","sources":["../../../../src/component/garmin/transform/moveIQ.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAElF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAEjE;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,wBAAwB,GAAG,YAAY,CA0B7E"}

package/dist/component/garmin/transform/moveIQ.js

@@ -0,0 +1,41 @@
+// ─── Move IQ Transformer ─────────────────────────────────────────────────────
+// Transforms a Garmin Move IQ event into the Soma Activity schema shape.
+//
+// Move IQ events are auto-detected activities (e.g. walking, running, cycling)
+// recognised by the Garmin device without user interaction. They are lightweight
+// — no GPS, heart rate, or calorie data — just type, duration, and device.
+import { mapActivityType } from "./maps/activityType.js";
+/**
+ * Transform a Garmin Move IQ event into a Soma Activity document shape.
+ *
+ * Move IQ activityType values are lowercase (e.g. "running", "cycling"),
+ * unlike regular activities which use uppercase. We normalise to uppercase
+ * before mapping.
+ *
+ * The returned object is ready to be spread into an `ingestActivity` call
+ * alongside `connectionId` and `userId`.
+ */
+export function transformMoveIQ(event) {
+    const startMs = (event.startTimeInSeconds ?? 0) * 1000;
+    const endMs = startMs + (event.durationInSeconds ?? 0) * 1000;
+    const startDate = new Date(startMs).toISOString();
+    const endDate = new Date(endMs).toISOString();
+    // Move IQ activityType is lowercase; mapActivityType expects uppercase
+    const activityType = (event.activityType ?? "OTHER").toUpperCase();
+    return {
+        metadata: {
+            summary_id: event.summaryId ?? `moveiq-${event.startTimeInSeconds}`,
+            start_time: startDate,
+            end_time: endDate,
+            type: mapActivityType(activityType),
+            upload_type: 1, // device-detected
+        },
+        active_durations_data: {
+            activity_seconds: event.durationInSeconds,
+        },
+        device_data: event.deviceName
+            ? { name: event.deviceName }
+            : undefined,
+    };
+}
+//# sourceMappingURL=moveIQ.js.map

package/dist/component/garmin/transform/moveIQ.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"moveIQ.js","sourceRoot":"","sources":["../../../../src/component/garmin/transform/moveIQ.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,yEAAyE;AACzE,EAAE;AACF,+EAA+E;AAC/E,iFAAiF;AACjF,2EAA2E;AAG3E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGzD;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,KAA+B;IAC7D,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,kBAAkB,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IACvD,MAAM,KAAK,GAAG,OAAO,GAAG,CAAC,KAAK,CAAC,iBAAiB,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IAC9D,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IAClD,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IAE9C,uEAAuE;IACvE,MAAM,YAAY,GAAG,CAAC,KAAK,CAAC,YAAY,IAAI,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IAEnE,OAAO;QACL,QAAQ,EAAE;YACR,UAAU,EAAE,KAAK,CAAC,SAAS,IAAI,UAAU,KAAK,CAAC,kBAAkB,EAAE;YACnE,UAAU,EAAE,SAAS;YACrB,QAAQ,EAAE,OAAO;YACjB,IAAI,EAAE,eAAe,CAAC,YAAY,CAAC;YACnC,WAAW,EAAE,CAAC,EAAE,kBAAkB;SACnC;QAED,qBAAqB,EAAE;YACrB,gBAAgB,EAAE,KAAK,CAAC,iBAAiB;SAC1C;QAED,WAAW,EAAE,KAAK,CAAC,UAAU;YAC3B,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,UAAU,EAAE;YAC5B,CAAC,CAAC,SAAS;KACd,CAAC;AACJ,CAAC"}

package/dist/{garmin → component/garmin/transform}/plannedWorkout.d.ts

@@ -1,5 +1,5 @@
-import type { GarminWorkout } from "./types.js";
-type SomaPlannedWorkout = Record<string, any>;
+import type { SomaPlannedWorkout } from "../../validators/plannedWorkout.js";
+import type { WorkoutV2 } from "../types/trainingApiWorkouts/types.gen.js";
 /**
  * Transform a Soma planned workout document into a Garmin Training API V2
  * workout payload ready for `POST /workoutportal/workout/v2`.
@@ -7,6 +7,5 @@ type SomaPlannedWorkout = Record<string, any>;
  * @param somaWorkout - The planned workout document from the Soma DB
  * @param providerName - Name shown to the user in Garmin Connect (20 chars max)
  */
-export declare function transformPlannedWorkoutToGarmin(somaWorkout: SomaPlannedWorkout, providerName: string): GarminWorkout;
-export {};
+export declare function transformPlannedWorkoutToGarmin(somaWorkout: SomaPlannedWorkout, providerName: string): WorkoutV2;
 //# sourceMappingURL=plannedWorkout.d.ts.map

package/dist/component/garmin/transform/plannedWorkout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plannedWorkout.d.ts","sourceRoot":"","sources":["../../../../src/component/garmin/transform/plannedWorkout.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,EACV,SAAS,EAIV,MAAM,2CAA2C,CAAC;AAInD;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,kBAAkB,EAC/B,YAAY,EAAE,MAAM,GACnB,SAAS,CAwBX"}