@nativesquare/soma 0.7.3 → 0.9.0

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 { GarminHealthSnapshot } from "../types/garmin.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: GarminHealthSnapshot): 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,oBAAoB,CAAC;AAE/D;;;;;;;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 { GarminHRVSummary } from "../types/garmin.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: GarminHRVSummary): 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,oBAAoB,CAAC;AAE3D;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,gBAAgB,GAAG,SAAS,GAAG,IAAI,CAwC3E"}

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

@@ -0,0 +1,45 @@
+// ─── 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 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 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 null;
+    }
+    const startTime = hrv.startTimeInSeconds ?? 0;
+    const hrvSamples = hasSamples
+        ? Object.entries(hrv.hrvValues).map(([offset, rmssd]) => ({
+            timestamp: new Date((startTime + parseInt(offset, 10)) * 1000).toISOString(),
+            hrv_rmssd: rmssd,
+        }))
+        : undefined;
+    return {
+        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,
+                }
+                : undefined,
+            detailed: hrvSamples && hrvSamples.length > 0
+                ? { hrv_samples_rmssd: hrvSamples }
+                : undefined,
+        },
+    };
+}
+//# 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,SAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;YACvD,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;QACL,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;oBACE,aAAa,EAAE,GAAG,CAAC,YAAY;iBAChC;gBACH,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 { GarminActivity } from "../types/garmin.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: GarminActivity): 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,oBAAoB,CAAC;AAGzD;;;;;;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/component/garmin/transform/menstrualCycleTracking.d.ts

@@ -0,0 +1,10 @@
+import type { SomaMenstruation } from "../../validators/menstruation.js";
+import type { GarminMenstrualCycleTracking } from "../types/garmin.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: GarminMenstrualCycleTracking): 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,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAEvE;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,4BAA4B,GAAG,gBAAgB,CA8BpG"}

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

@@ -0,0 +1,43 @@
+// ─── 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 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 function transformMenstrualCycleTracking(data) {
+    const dateStr = data.periodStartDate;
+    const startTime = dateStr
+        ? `${dateStr}T00:00:00.000Z`
+        : new Date(0).toISOString();
+    const endTime = dateStr
+        ? `${dateStr}T23:59:59.999Z`
+        : new Date(0).toISOString();
+    return {
+        metadata: {
+            start_time: startTime,
+            end_time: endTime,
+        },
+        menstruation_data: {
+            day_in_cycle: data.dayInCycle,
+            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 != null
+                ? String(data.cycleLength)
+                : undefined,
+            is_predicted_cycle: data.isPredictedCycle != null
+                ? String(data.isPredictedCycle)
+                : undefined,
+        },
+    };
+}
+//# 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,IAAkC;IAChF,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,17 @@
+import type { z } from "zod";
+import type { zClientAutoActivityMoveIq } from "../types/zod/zod.gen.js";
+import type { SomaActivity } from "../../validators/activity.js";
+type GarminMoveIQEvent = z.infer<typeof zClientAutoActivityMoveIq>;
+/**
+ * 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: GarminMoveIQEvent): SomaActivity;
+export {};
+//# 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,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAEzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAEjE,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAEnE;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY,CA0BtE"}

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 "../../../garmin/maps/activity-type.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;AAI3E,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAKxE;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,KAAwB;IACtD,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/component/garmin/transform/pulseOx.d.ts

@@ -0,0 +1,12 @@
+import type { SomaDaily } from "../../validators/daily.js";
+import type { GarminPulseOx } from "../types/garmin.js";
+/**
+ * Transform a Garmin Pulse Ox push item into a Soma Daily document shape.
+ *
+ * Pulse Ox summaries 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 transformPulseOx(pulseOx: GarminPulseOx): SomaDaily | null;
+//# sourceMappingURL=pulseOx.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pulseOx.d.ts","sourceRoot":"","sources":["../../../../src/component/garmin/transform/pulseOx.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,GAAG,IAAI,CAoBzE"}

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

@@ -0,0 +1,46 @@
+// ─── Pulse Ox Transformer ────────────────────────────────────────────────────
+// Transforms a Garmin Pulse Ox push item into the Soma Daily schema shape.
+//
+// Pulse Ox summaries contain SpO2 (blood oxygen saturation) readings
+// throughout the day. We map these into the Daily model's oxygen_data field.
+/**
+ * Transform a Garmin Pulse Ox push item into a Soma Daily document shape.
+ *
+ * Pulse Ox summaries 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 transformPulseOx(pulseOx) {
+    const startMs = (pulseOx.startTimeInSeconds ?? 0) * 1000;
+    const endMs = startMs + (pulseOx.durationInSeconds ?? 0) * 1000;
+    const oxygenData = buildOxygenData(pulseOx);
+    if (oxygenData == null) {
+        return null;
+    }
+    return {
+        metadata: {
+            start_time: new Date(startMs).toISOString(),
+            end_time: new Date(endMs).toISOString(),
+            upload_type: 1, // Automatic
+        },
+        oxygen_data: oxygenData,
+    };
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function buildOxygenData(pulseOx) {
+    const hasSamples = pulseOx.timeOffsetSpo2Values != null &&
+        Object.keys(pulseOx.timeOffsetSpo2Values).length > 0;
+    if (!hasSamples) {
+        return undefined;
+    }
+    const startTime = pulseOx.startTimeInSeconds ?? 0;
+    const samples = Object.entries(pulseOx.timeOffsetSpo2Values).map(([offset, percentage]) => ({
+        timestamp: new Date((startTime + parseInt(offset, 10)) * 1000).toISOString(),
+        percentage,
+    }));
+    return {
+        saturation_samples: samples.length > 0 ? samples : undefined,
+    };
+}
+//# sourceMappingURL=pulseOx.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pulseOx.js","sourceRoot":"","sources":["../../../../src/component/garmin/transform/pulseOx.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,2EAA2E;AAC3E,EAAE;AACF,qEAAqE;AACrE,6EAA6E;AAK7E;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAsB;IACrD,MAAM,OAAO,GAAG,CAAC,OAAO,CAAC,kBAAkB,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IACzD,MAAM,KAAK,GACT,OAAO,GAAG,CAAC,OAAO,CAAC,iBAAiB,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IAEpD,MAAM,UAAU,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAE5C,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;QACvB,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,WAAW,EAAE,UAAU;KACxB,CAAC;AACJ,CAAC;AAED,iFAAiF;AAEjF,SAAS,eAAe,CAAC,OAAsB;IAC7C,MAAM,UAAU,GACd,OAAO,CAAC,oBAAoB,IAAI,IAAI;QACpC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAEvD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,kBAAkB,IAAI,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,oBAAqB,CAAC,CAAC,GAAG,CAC/D,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC;QACzB,SAAS,EAAE,IAAI,IAAI,CACjB,CAAC,SAAS,GAAG,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,CAC1C,CAAC,WAAW,EAAE;QACf,UAAU;KACX,CAAC,CACH,CAAC;IAEF,OAAO;QACL,kBAAkB,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;KAC7D,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,12 @@
+import type { SomaDaily } from "../../validators/daily.js";
+import type { GarminRespiration } from "../types/garmin.js";
+/**
+ * Transform a Garmin Respiration push item into a Soma Daily document shape.
+ *
+ * Respiration summaries 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 transformRespiration(resp: GarminRespiration): SomaDaily | null;
+//# sourceMappingURL=respiration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"respiration.d.ts","sourceRoot":"","sources":["../../../../src/component/garmin/transform/respiration.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,SAAS,GAAG,IAAI,CAoB9E"}

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

@@ -0,0 +1,54 @@
+// ─── Respiration Transformer ─────────────────────────────────────────────────
+// Transforms a Garmin Respiration push item into the Soma Daily schema shape.
+//
+// Respiration summaries contain breathing rate readings throughout the day.
+// We map these into the Daily model's respiration_data field.
+/**
+ * Transform a Garmin Respiration push item into a Soma Daily document shape.
+ *
+ * Respiration summaries 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 transformRespiration(resp) {
+    const startMs = (resp.startTimeInSeconds ?? 0) * 1000;
+    const endMs = startMs + (resp.durationInSeconds ?? 0) * 1000;
+    const respirationData = buildRespirationData(resp);
+    if (respirationData == null) {
+        return null;
+    }
+    return {
+        metadata: {
+            start_time: new Date(startMs).toISOString(),
+            end_time: new Date(endMs).toISOString(),
+            upload_type: 1, // Automatic
+        },
+        respiration_data: respirationData,
+    };
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function buildRespirationData(resp) {
+    const hasSamples = resp.timeOffsetEpochToBreaths != null &&
+        Object.keys(resp.timeOffsetEpochToBreaths).length > 0;
+    if (!hasSamples) {
+        return undefined;
+    }
+    const startTime = resp.startTimeInSeconds ?? 0;
+    const samples = Object.entries(resp.timeOffsetEpochToBreaths).map(([offset, breaths_per_min]) => ({
+        timestamp: new Date((startTime + parseInt(offset, 10)) * 1000).toISOString(),
+        breaths_per_min,
+    }));
+    // Compute summary stats from samples
+    const values = samples.map((s) => s.breaths_per_min);
+    const avg = values.reduce((sum, v) => sum + v, 0) / values.length;
+    return {
+        breaths_data: {
+            avg_breaths_per_min: Math.round(avg * 10) / 10,
+            min_breaths_per_min: Math.min(...values),
+            max_breaths_per_min: Math.max(...values),
+            samples: samples.length > 0 ? samples : undefined,
+        },
+    };
+}
+//# sourceMappingURL=respiration.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"respiration.js","sourceRoot":"","sources":["../../../../src/component/garmin/transform/respiration.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,8EAA8E;AAC9E,EAAE;AACF,4EAA4E;AAC5E,8DAA8D;AAK9D;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAuB;IAC1D,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IACtD,MAAM,KAAK,GACT,OAAO,GAAG,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IAEjD,MAAM,eAAe,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAEnD,IAAI,eAAe,IAAI,IAAI,EAAE,CAAC;QAC5B,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,gBAAgB,EAAE,eAAe;KAClC,CAAC;AACJ,CAAC;AAED,iFAAiF;AAEjF,SAAS,oBAAoB,CAAC,IAAuB;IACnD,MAAM,UAAU,GACd,IAAI,CAAC,wBAAwB,IAAI,IAAI;QACrC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAExD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,kBAAkB,IAAI,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,wBAAyB,CAAC,CAAC,GAAG,CAChE,CAAC,CAAC,MAAM,EAAE,eAAe,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9B,SAAS,EAAE,IAAI,IAAI,CACjB,CAAC,SAAS,GAAG,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,CAC1C,CAAC,WAAW,EAAE;QACf,eAAe;KAChB,CAAC,CACH,CAAC;IAEF,qCAAqC;IACrC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;IAElE,OAAO;QACL,YAAY,EAAE;YACZ,mBAAmB,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,EAAE;YAC9C,mBAAmB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;YACxC,mBAAmB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;YACxC,OAAO,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;SAClD;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,12 @@
+import type { SomaBody } from "../../validators/body.js";
+import type { GarminSkinTemperature } from "../types/garmin.js";
+/**
+ * Transform a Garmin Skin Temperature push item into a Soma Body document shape.
+ *
+ * Skin temperature records are ingested into the `body` table via `ingestBody`,
+ * keyed by `metadata.start_time + metadata.end_time`.
+ *
+ * Returns `null` when no meaningful temperature data is present.
+ */
+export declare function transformSkinTemperature(skinTemp: GarminSkinTemperature): SomaBody | null;
+//# sourceMappingURL=skinTemperature.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skinTemperature.d.ts","sourceRoot":"","sources":["../../../../src/component/garmin/transform/skinTemperature.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhE;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,QAAQ,GAAG,IAAI,CAyBzF"}