@nativesquare/soma 0.8.0 → 0.9.0

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

@@ -0,0 +1,38 @@
+// ─── Skin Temperature Transformer ────────────────────────────────────────────
+// Transforms a Garmin Skin Temperature push item into the Soma Body schema shape.
+//
+// Skin temperature summaries contain the average deviation of the user's
+// skin temperature during their sleep window. We map this into the Body
+// model's temperature_data.skin_temperature_samples field.
+/**
+ * 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 function transformSkinTemperature(skinTemp) {
+    const startMs = (skinTemp.startTimeInSeconds ?? 0) * 1000;
+    const endMs = startMs + (skinTemp.durationInSeconds ?? 0) * 1000;
+    const startTime = new Date(startMs).toISOString();
+    const endTime = new Date(endMs).toISOString();
+    if (skinTemp.avgDeviationCelsius == null) {
+        return null;
+    }
+    return {
+        metadata: {
+            start_time: startTime,
+            end_time: endTime,
+        },
+        temperature_data: {
+            skin_temperature_samples: [
+                {
+                    timestamp: startTime,
+                    temperature_celsius: skinTemp.avgDeviationCelsius,
+                },
+            ],
+        },
+    };
+}
+//# sourceMappingURL=skinTemperature.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skinTemperature.js","sourceRoot":"","sources":["../../../../src/component/garmin/transform/skinTemperature.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,kFAAkF;AAClF,EAAE;AACF,yEAAyE;AACzE,wEAAwE;AACxE,2DAA2D;AAK3D;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CAAC,QAA+B;IACtE,MAAM,OAAO,GAAG,CAAC,QAAQ,CAAC,kBAAkB,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IAC1D,MAAM,KAAK,GAAG,OAAO,GAAG,CAAC,QAAQ,CAAC,iBAAiB,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IACjE,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,IAAI,QAAQ,CAAC,mBAAmB,IAAI,IAAI,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,QAAQ,EAAE;YACR,UAAU,EAAE,SAAS;YACrB,QAAQ,EAAE,OAAO;SAClB;QAED,gBAAgB,EAAE;YAChB,wBAAwB,EAAE;gBACxB;oBACE,SAAS,EAAE,SAAS;oBACpB,mBAAmB,EAAE,QAAQ,CAAC,mBAAmB;iBAClD;aACF;SACF;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,55 @@
+import type { GarminSleep } from "../types/garmin.js";
+/**
+ * Transform a Garmin sleep summary push item into a Soma Sleep document shape.
+ *
+ * Sleep summaries are ingested into the `sleep` table via `ingestSleep`,
+ * keyed by `metadata.summary_id`.
+ *
+ * The returned object is ready to be spread into an `ingestSleep` call
+ * alongside `connectionId` and `userId`.
+ */
+export declare function transformSleeps(sleep: GarminSleep): {
+    metadata: {
+        summary_id: string | undefined;
+        start_time: string;
+        end_time: string;
+        upload_type: number;
+    };
+    sleep_durations_data: {
+        asleep: {
+            duration_asleep_state_seconds: number | undefined;
+            duration_deep_sleep_state_seconds: number | undefined;
+            duration_light_sleep_state_seconds: number | undefined;
+            duration_REM_sleep_state_seconds: number | undefined;
+        };
+        awake: {
+            duration_awake_state_seconds: number | undefined;
+        };
+        other: {
+            duration_in_bed_seconds: number | undefined;
+            duration_unmeasurable_sleep_seconds: number | undefined;
+        };
+        hypnogram_samples: {
+            timestamp: string;
+            level: number;
+        }[] | undefined;
+    };
+    respiration_data: {
+        breaths_data: {
+            samples: {
+                timestamp: string;
+                breaths_per_min: number;
+            }[];
+        } | undefined;
+        oxygen_saturation_data: {
+            samples: {
+                timestamp: string;
+                percentage: number;
+            }[];
+        } | undefined;
+    } | undefined;
+    scores: {
+        sleep: number;
+    } | undefined;
+};
+//# sourceMappingURL=sleeps.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sleeps.d.ts","sourceRoot":"","sources":["../../../../src/component/garmin/transform/sleeps.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAOtD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;uBA+Dd,MAAM;mBAAS,MAAM;;;;;;;;;;;;;;;;;;;;EA/BxD"}

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

@@ -0,0 +1,120 @@
+// ─── Sleeps Transformer ──────────────────────────────────────────────────────
+// Transforms a Garmin sleep summary push item into the Soma Sleep schema shape.
+import { mapSleepLevel } from "../../../garmin/maps/sleep-level.js";
+/**
+ * Transform a Garmin sleep summary push item into a Soma Sleep document shape.
+ *
+ * Sleep summaries are ingested into the `sleep` table via `ingestSleep`,
+ * keyed by `metadata.summary_id`.
+ *
+ * The returned object is ready to be spread into an `ingestSleep` call
+ * alongside `connectionId` and `userId`.
+ */
+export function transformSleeps(sleep) {
+    const startMs = (sleep.startTimeInSeconds ?? 0) * 1000;
+    const endMs = startMs +
+        ((sleep.durationInSeconds ?? 0) + (sleep.awakeDurationInSeconds ?? 0)) *
+            1000;
+    const uploadTypeMap = {
+        ENHANCED_FINAL: 2,
+        ENHANCED_TENTATIVE: 4,
+        AUTO_FINAL: 2,
+        AUTO_TENTATIVE: 4,
+        AUTO_MANUAL: 2,
+        MANUAL: 1,
+        DEVICE: 2,
+        OFF_WRIST: 0,
+    };
+    return {
+        metadata: {
+            summary_id: sleep.summaryId,
+            start_time: new Date(startMs).toISOString(),
+            end_time: new Date(endMs).toISOString(),
+            upload_type: uploadTypeMap[sleep.validation ?? ""] ?? 0,
+        },
+        sleep_durations_data: buildSleepDurationsData(sleep),
+        respiration_data: buildRespirationData(sleep),
+        scores: buildScoresData(sleep),
+    };
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function buildSleepDurationsData(sleep) {
+    const totalAsleep = (sleep.deepSleepDurationInSeconds ?? 0) +
+        (sleep.lightSleepDurationInSeconds ?? 0) +
+        (sleep.remSleepInSeconds ?? 0);
+    return {
+        asleep: {
+            duration_asleep_state_seconds: totalAsleep || undefined,
+            duration_deep_sleep_state_seconds: sleep.deepSleepDurationInSeconds,
+            duration_light_sleep_state_seconds: sleep.lightSleepDurationInSeconds,
+            duration_REM_sleep_state_seconds: sleep.remSleepInSeconds,
+        },
+        awake: {
+            duration_awake_state_seconds: sleep.awakeDurationInSeconds,
+        },
+        other: {
+            duration_in_bed_seconds: sleep.durationInSeconds,
+            duration_unmeasurable_sleep_seconds: sleep.unmeasurableSleepInSeconds,
+        },
+        hypnogram_samples: buildHypnogramSamples(sleep),
+    };
+}
+function buildHypnogramSamples(sleep) {
+    if (!sleep.sleepLevelsMap)
+        return undefined;
+    const samples = [];
+    for (const [stage, levels] of Object.entries(sleep.sleepLevelsMap)) {
+        if (!levels)
+            continue;
+        const terraLevel = mapSleepLevel(stage);
+        for (const level of levels) {
+            if (level.startTimeInSeconds == null)
+                continue;
+            samples.push({
+                timestamp: new Date(level.startTimeInSeconds * 1000).toISOString(),
+                level: terraLevel,
+            });
+        }
+    }
+    samples.sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+    return samples.length > 0 ? samples : undefined;
+}
+function buildRespirationData(sleep) {
+    const hasBreathSamples = sleep.timeOffsetSleepRespiration != null &&
+        Object.keys(sleep.timeOffsetSleepRespiration).length > 0;
+    const hasSpO2Samples = sleep.timeOffsetSleepSpo2 != null &&
+        Object.keys(sleep.timeOffsetSleepSpo2).length > 0;
+    if (!hasBreathSamples && !hasSpO2Samples) {
+        return undefined;
+    }
+    const startTime = sleep.startTimeInSeconds ?? 0;
+    const breathSamples = hasBreathSamples
+        ? Object.entries(sleep.timeOffsetSleepRespiration).map(([offset, rate]) => ({
+            timestamp: new Date((startTime + parseInt(offset, 10)) * 1000).toISOString(),
+            breaths_per_min: rate,
+        }))
+        : undefined;
+    const spo2Samples = hasSpO2Samples
+        ? Object.entries(sleep.timeOffsetSleepSpo2).map(([offset, pct]) => ({
+            timestamp: new Date((startTime + parseInt(offset, 10)) * 1000).toISOString(),
+            percentage: pct,
+        }))
+        : undefined;
+    return {
+        breaths_data: breathSamples && breathSamples.length > 0
+            ? { samples: breathSamples }
+            : undefined,
+        oxygen_saturation_data: spo2Samples && spo2Samples.length > 0
+            ? { samples: spo2Samples }
+            : undefined,
+    };
+}
+function buildScoresData(sleep) {
+    const overallScore = sleep.overallSleepScore?.value;
+    if (overallScore == null)
+        return undefined;
+    return {
+        sleep: overallScore,
+    };
+}
+//# sourceMappingURL=sleeps.js.map

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

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

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

@@ -0,0 +1,12 @@
+import type { SomaDaily } from "../../validators/daily.js";
+import type { GarminStress } from "../types/garmin.js";
+/**
+ * Transform a Garmin Stress Details push item into a Soma Daily document shape.
+ *
+ * Stress records are ingested into the `daily` table via `ingestDaily`,
+ * keyed by `metadata.start_time + metadata.end_time`.
+ *
+ * Returns `null` when no meaningful stress data is present.
+ */
+export declare function transformStress(stress: GarminStress): SomaDaily | null;
+//# sourceMappingURL=stress.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stress.d.ts","sourceRoot":"","sources":["../../../../src/component/garmin/transform/stress.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,IAAI,CA2DtE"}

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

@@ -0,0 +1,56 @@
+// ─── Stress Details Transformer ──────────────────────────────────────────────
+// Transforms a Garmin Stress Details push item into the Soma Daily schema shape.
+//
+// Stress details summaries contain 3-minute stress level averages and body
+// battery values throughout the day. We map these into the Daily model's
+// stress_data field.
+/**
+ * Transform a Garmin Stress Details push item into a Soma Daily document shape.
+ *
+ * Stress records are ingested into the `daily` table via `ingestDaily`,
+ * keyed by `metadata.start_time + metadata.end_time`.
+ *
+ * Returns `null` when no meaningful stress data is present.
+ */
+export function transformStress(stress) {
+    const hasSummary = stress.averageStressLevel != null || stress.maxStressLevel != null;
+    const hasStressSamples = stress.timeOffsetStressLevelValues != null &&
+        Object.keys(stress.timeOffsetStressLevelValues).length > 0;
+    const hasBodyBatterySamples = stress.timeOffsetBodyBatteryValues != null &&
+        Object.keys(stress.timeOffsetBodyBatteryValues).length > 0;
+    if (!hasSummary && !hasStressSamples && !hasBodyBatterySamples) {
+        return null;
+    }
+    const startSeconds = stress.startTimeInSeconds ?? 0;
+    const durationSeconds = stress.durationInSeconds ?? 86400;
+    const startTime = new Date(startSeconds * 1000).toISOString();
+    const endTime = new Date((startSeconds + durationSeconds) * 1000).toISOString();
+    const stressSamples = hasStressSamples
+        ? Object.entries(stress.timeOffsetStressLevelValues).map(([offset, level]) => ({
+            timestamp: new Date((startSeconds + parseInt(offset, 10)) * 1000).toISOString(),
+            level,
+        }))
+        : undefined;
+    const bodyBatterySamples = hasBodyBatterySamples
+        ? Object.entries(stress.timeOffsetBodyBatteryValues).map(([offset, level]) => ({
+            timestamp: new Date((startSeconds + parseInt(offset, 10)) * 1000).toISOString(),
+            level,
+        }))
+        : undefined;
+    return {
+        metadata: {
+            start_time: startTime,
+            end_time: endTime,
+            upload_type: 1,
+        },
+        stress_data: {
+            avg_stress_level: stress.averageStressLevel,
+            max_stress_level: stress.maxStressLevel,
+            samples: stressSamples && stressSamples.length > 0 ? stressSamples : undefined,
+            body_battery_samples: bodyBatterySamples && bodyBatterySamples.length > 0
+                ? bodyBatterySamples
+                : undefined,
+        },
+    };
+}
+//# sourceMappingURL=stress.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stress.js","sourceRoot":"","sources":["../../../../src/component/garmin/transform/stress.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,iFAAiF;AACjF,EAAE;AACF,2EAA2E;AAC3E,yEAAyE;AACzE,qBAAqB;AAKrB;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,MAAoB;IAClD,MAAM,UAAU,GACd,MAAM,CAAC,kBAAkB,IAAI,IAAI,IAAI,MAAM,CAAC,cAAc,IAAI,IAAI,CAAC;IACrE,MAAM,gBAAgB,GACpB,MAAM,CAAC,2BAA2B,IAAI,IAAI;QAC1C,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,2BAA2B,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAC7D,MAAM,qBAAqB,GACzB,MAAM,CAAC,2BAA2B,IAAI,IAAI;QAC1C,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,2BAA2B,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAE7D,IAAI,CAAC,UAAU,IAAI,CAAC,gBAAgB,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC/D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,CAAC,kBAAkB,IAAI,CAAC,CAAC;IACpD,MAAM,eAAe,GAAG,MAAM,CAAC,iBAAiB,IAAI,KAAK,CAAC;IAC1D,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9D,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,CAAC,YAAY,GAAG,eAAe,CAAC,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IAEhF,MAAM,aAAa,GAAG,gBAAgB;QACpC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,2BAA4B,CAAC,CAAC,GAAG,CACrD,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;YACpB,SAAS,EAAE,IAAI,IAAI,CACjB,CAAC,YAAY,GAAG,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,CAC7C,CAAC,WAAW,EAAE;YACf,KAAK;SACN,CAAC,CACH;QACH,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,kBAAkB,GAAG,qBAAqB;QAC9C,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,2BAA4B,CAAC,CAAC,GAAG,CACrD,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;YACpB,SAAS,EAAE,IAAI,IAAI,CACjB,CAAC,YAAY,GAAG,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,CAC7C,CAAC,WAAW,EAAE;YACf,KAAK;SACN,CAAC,CACH;QACH,CAAC,CAAC,SAAS,CAAC;IAEd,OAAO;QACL,QAAQ,EAAE;YACR,UAAU,EAAE,SAAS;YACrB,QAAQ,EAAE,OAAO;YACjB,WAAW,EAAE,CAAC;SACf;QAED,WAAW,EAAE;YACX,gBAAgB,EAAE,MAAM,CAAC,kBAAkB;YAC3C,gBAAgB,EAAE,MAAM,CAAC,cAAc;YACvC,OAAO,EACL,aAAa,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS;YACvE,oBAAoB,EAClB,kBAAkB,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC;gBACjD,CAAC,CAAC,kBAAkB;gBACpB,CAAC,CAAC,SAAS;SAChB;KACF,CAAC;AACJ,CAAC"}

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

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

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

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

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

@@ -0,0 +1,48 @@
+// ─── User Metrics Transformer ────────────────────────────────────────────────
+// Transforms a Garmin User Metrics push item into the Soma Body schema shape.
+//
+// User Metrics summaries contain VO2 Max, VO2 Max Cycling, fitness age, and
+// an enhanced flag. We map these into the Body model's oxygen_data and
+// measurements_data fields.
+/**
+ * Transform a Garmin User Metrics push item into a Soma Body document shape.
+ *
+ * User metrics records are ingested into the `body` table via `ingestBody`,
+ * keyed by `metadata.start_time + metadata.end_time`.
+ *
+ * Returns `null` when no meaningful metrics data is present.
+ */
+export function transformUserMetrics(metrics) {
+    const dateStr = metrics.calendarDate;
+    const startTime = dateStr
+        ? `${dateStr}T00:00:00.000Z`
+        : new Date(0).toISOString();
+    const endTime = dateStr
+        ? `${dateStr}T23:59:59.999Z`
+        : new Date(0).toISOString();
+    const hasVo2 = metrics.vo2Max != null || metrics.vo2MaxCycling != null;
+    const hasFitnessAge = metrics.fitnessAge != null;
+    if (!hasVo2 && !hasFitnessAge) {
+        return null;
+    }
+    return {
+        metadata: {
+            start_time: startTime,
+            end_time: endTime,
+        },
+        oxygen_data: hasVo2
+            ? { vo2max_ml_per_min_per_kg: metrics.vo2Max ?? metrics.vo2MaxCycling }
+            : undefined,
+        measurements_data: hasFitnessAge
+            ? {
+                measurements: [
+                    {
+                        measurement_time: startTime,
+                        estimated_fitness_age: String(metrics.fitnessAge),
+                    },
+                ],
+            }
+            : undefined,
+    };
+}
+//# sourceMappingURL=userMetrics.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"userMetrics.js","sourceRoot":"","sources":["../../../../src/component/garmin/transform/userMetrics.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,8EAA8E;AAC9E,EAAE;AACF,4EAA4E;AAC5E,uEAAuE;AACvE,4BAA4B;AAK5B;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA0B;IAC7D,MAAM,OAAO,GAAG,OAAO,CAAC,YAAY,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,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,IAAI,OAAO,CAAC,aAAa,IAAI,IAAI,CAAC;IACvE,MAAM,aAAa,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC;IAEjD,IAAI,CAAC,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,QAAQ,EAAE;YACR,UAAU,EAAE,SAAS;YACrB,QAAQ,EAAE,OAAO;SAClB;QAED,WAAW,EAAE,MAAM;YACjB,CAAC,CAAC,EAAE,wBAAwB,EAAE,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,aAAa,EAAE;YACvE,CAAC,CAAC,SAAS;QAEb,iBAAiB,EAAE,aAAa;YAC9B,CAAC,CAAC;gBACE,YAAY,EAAE;oBACZ;wBACE,gBAAgB,EAAE,SAAS;wBAC3B,qBAAqB,EAAE,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC;qBAClD;iBACF;aACF;YACH,CAAC,CAAC,SAAS;KACd,CAAC;AACJ,CAAC"}

package/dist/component/garmin/types/garmin.d.ts

@@ -0,0 +1,21 @@
+import type { z } from "zod";
+import type { zClientActivity, zClientActivityDetail, zClientAutoActivityMoveIq, zClientBloodPressure, zClientBodyComp, zClientDaily, zClientDailySpo2Acclimation, zClientEpoch, zClientHealthSnapshot, zClientHrvSummary, zClientLap, zClientRespiration, zClientSkinTemp, zClientSleep, zClientStress, zClientSummarizedMenstrualCycle, zClientUserMetrics, zSample } from "./zod/zod.gen.js";
+export type GarminActivity = z.infer<typeof zClientActivity>;
+export type GarminActivityDetail = z.infer<typeof zClientActivityDetail>;
+export type GarminDaily = z.infer<typeof zClientDaily>;
+export type GarminEpoch = z.infer<typeof zClientEpoch>;
+export type GarminHealthSnapshot = z.infer<typeof zClientHealthSnapshot>;
+export type GarminHRVSummary = z.infer<typeof zClientHrvSummary>;
+export type GarminPulseOx = z.infer<typeof zClientDailySpo2Acclimation>;
+export type GarminSample = z.infer<typeof zSample>;
+export type GarminLap = z.infer<typeof zClientLap>;
+export type GarminBloodPressure = z.infer<typeof zClientBloodPressure>;
+export type GarminBodyComposition = z.infer<typeof zClientBodyComp>;
+export type GarminMoveIQEvent = z.infer<typeof zClientAutoActivityMoveIq>;
+export type GarminRespiration = z.infer<typeof zClientRespiration>;
+export type GarminSkinTemperature = z.infer<typeof zClientSkinTemp>;
+export type GarminSleep = z.infer<typeof zClientSleep>;
+export type GarminStress = z.infer<typeof zClientStress>;
+export type GarminUserMetrics = z.infer<typeof zClientUserMetrics>;
+export type GarminMenstrualCycleTracking = z.infer<typeof zClientSummarizedMenstrualCycle>;
+//# sourceMappingURL=garmin.d.ts.map

package/dist/component/garmin/types/garmin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"garmin.d.ts","sourceRoot":"","sources":["../../../../src/component/garmin/types/garmin.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EACV,eAAe,EACf,qBAAqB,EACrB,yBAAyB,EACzB,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,2BAA2B,EAC3B,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EACjB,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,aAAa,EACb,+BAA+B,EAC/B,kBAAkB,EAClB,OAAO,EACR,MAAM,kBAAkB,CAAC;AAE1B,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAC7D,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACzE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AACvD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AACvD,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACzE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AACjE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AACxE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,OAAO,CAAC,CAAC;AACnD,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AACnD,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACvE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACpE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC1E,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACnE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACpE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AACvD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACzD,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACnE,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC"}

package/dist/component/garmin/types/garmin.js

@@ -0,0 +1,6 @@
+// ─── Garmin Types ────────────────────────────────────────────────────────────
+// Friendly type aliases for the auto-generated Zod schemas from the Garmin
+// Wellness API OpenAPI spec. Import these instead of writing inline z.infer<>
+// in every file.
+export {};
+//# sourceMappingURL=garmin.js.map

package/dist/component/garmin/types/garmin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"garmin.js","sourceRoot":"","sources":["../../../../src/component/garmin/types/garmin.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,2EAA2E;AAC3E,8EAA8E;AAC9E,iBAAiB"}