@nativesquare/soma 0.3.0 → 0.5.0

package/dist/garmin/daily.js

@@ -0,0 +1,143 @@
+// ─── Daily Transformer ───────────────────────────────────────────────────────
+// Transforms a Garmin daily wellness summary into the Soma Daily schema shape.
+/**
+ * Transform a Garmin daily summary into a Soma Daily document shape.
+ *
+ * @param daily - The Garmin daily summary from the Health API
+ * @returns Soma Daily fields (without connectionId/userId)
+ */
+export function transformDaily(daily) {
+    const startMs = daily.startTimeInSeconds * 1000;
+    const endMs = startMs + daily.durationInSeconds * 1000;
+    return {
+        metadata: {
+            start_time: new Date(startMs).toISOString(),
+            end_time: new Date(endMs).toISOString(),
+            upload_type: 1, // Automatic
+        },
+        active_durations_data: buildActiveDurationsData(daily),
+        calories_data: buildCaloriesData(daily),
+        distance_data: buildDistanceData(daily),
+        heart_rate_data: buildHeartRateData(daily),
+        oxygen_data: buildOxygenData(daily),
+        stress_data: buildStressData(daily),
+    };
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function buildActiveDurationsData(daily) {
+    if (daily.activeTimeInSeconds == null &&
+        daily.moderateIntensityDurationInSeconds == null &&
+        daily.vigorousIntensityDurationInSeconds == null) {
+        return undefined;
+    }
+    return {
+        activity_seconds: daily.activeTimeInSeconds,
+        moderate_intensity_seconds: daily.moderateIntensityDurationInSeconds,
+        vigorous_intensity_seconds: daily.vigorousIntensityDurationInSeconds,
+    };
+}
+function buildCaloriesData(daily) {
+    if (daily.activeKilocalories == null && daily.bmrKilocalories == null) {
+        return undefined;
+    }
+    const total = (daily.activeKilocalories ?? 0) + (daily.bmrKilocalories ?? 0);
+    return {
+        net_activity_calories: daily.activeKilocalories,
+        BMR_calories: daily.bmrKilocalories,
+        total_burned_calories: total || undefined,
+    };
+}
+function buildDistanceData(daily) {
+    if (daily.distanceInMeters == null &&
+        daily.steps == null &&
+        daily.floorsClimbed == null) {
+        return undefined;
+    }
+    return {
+        distance_meters: daily.distanceInMeters,
+        steps: daily.steps,
+        floors_climbed: daily.floorsClimbed,
+    };
+}
+function buildHeartRateData(daily) {
+    const hasSummary = daily.averageHeartRateInBeatsPerMinute != null ||
+        daily.maxHeartRateInBeatsPerMinute != null ||
+        daily.restingHeartRateInBeatsPerMinute != null;
+    const hasSamples = daily.timeOffsetHeartRateSamples != null &&
+        Object.keys(daily.timeOffsetHeartRateSamples).length > 0;
+    if (!hasSummary && !hasSamples)
+        return undefined;
+    const hrSamples = hasSamples
+        ? buildTimeOffsetSamples(daily.startTimeInSeconds, daily.timeOffsetHeartRateSamples, (bpm) => ({ bpm }))
+        : undefined;
+    return {
+        summary: hasSummary
+            ? {
+                avg_hr_bpm: daily.averageHeartRateInBeatsPerMinute,
+                max_hr_bpm: daily.maxHeartRateInBeatsPerMinute,
+                min_hr_bpm: daily.minHeartRateInBeatsPerMinute,
+                resting_hr_bpm: daily.restingHeartRateInBeatsPerMinute,
+            }
+            : undefined,
+        detailed: hrSamples && hrSamples.length > 0
+            ? { hr_samples: hrSamples }
+            : undefined,
+    };
+}
+function buildOxygenData(daily) {
+    if (daily.averageSpo2Value == null && daily.timeOffsetSpo2Values == null) {
+        return undefined;
+    }
+    const samples = daily.timeOffsetSpo2Values != null
+        ? buildTimeOffsetSamples(daily.startTimeInSeconds, daily.timeOffsetSpo2Values, (pct) => ({ percentage: pct }))
+        : undefined;
+    return {
+        avg_saturation_percentage: daily.averageSpo2Value,
+        saturation_samples: samples && samples.length > 0 ? samples : undefined,
+    };
+}
+function buildStressData(daily) {
+    const hasStress = daily.averageStressLevel != null ||
+        daily.maxStressLevel != null ||
+        daily.stressDurationInSeconds != null;
+    const hasStressSamples = daily.timeOffsetStressLevelValues != null &&
+        Object.keys(daily.timeOffsetStressLevelValues).length > 0;
+    const hasBodyBatterySamples = daily.timeOffsetBodyBatteryValues != null &&
+        Object.keys(daily.timeOffsetBodyBatteryValues).length > 0;
+    if (!hasStress && !hasStressSamples && !hasBodyBatterySamples) {
+        return undefined;
+    }
+    const stressSamples = hasStressSamples
+        ? buildTimeOffsetSamples(daily.startTimeInSeconds, daily.timeOffsetStressLevelValues, (level) => ({ level }))
+        : undefined;
+    const bodyBatterySamples = hasBodyBatterySamples
+        ? buildTimeOffsetSamples(daily.startTimeInSeconds, daily.timeOffsetBodyBatteryValues, (level) => ({ level }))
+        : undefined;
+    return {
+        avg_stress_level: daily.averageStressLevel,
+        max_stress_level: daily.maxStressLevel,
+        stress_duration_seconds: daily.stressDurationInSeconds,
+        rest_stress_duration_seconds: daily.restStressDurationInSeconds,
+        activity_stress_duration_seconds: daily.activityStressDurationInSeconds,
+        low_stress_duration_seconds: daily.lowStressDurationInSeconds,
+        medium_stress_duration_seconds: daily.mediumStressDurationInSeconds,
+        high_stress_duration_seconds: daily.highStressDurationInSeconds,
+        samples: stressSamples && stressSamples.length > 0 ? stressSamples : undefined,
+        body_battery_samples: bodyBatterySamples && bodyBatterySamples.length > 0
+            ? bodyBatterySamples
+            : undefined,
+    };
+}
+/**
+ * Convert Garmin offset-keyed time-series data into timestamped samples.
+ *
+ * Garmin sends time-series as `{ [offsetSeconds]: value }` maps.
+ * This converts to `{ timestamp: ISO-8601, ...fields }[]`.
+ */
+function buildTimeOffsetSamples(startTimeInSeconds, offsets, mapValue) {
+    return Object.entries(offsets).map(([offset, value]) => ({
+        timestamp: new Date((startTimeInSeconds + parseInt(offset, 10)) * 1000).toISOString(),
+        ...mapValue(value),
+    }));
+}
+//# sourceMappingURL=daily.js.map

package/dist/garmin/daily.js.map

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

package/dist/garmin/index.d.ts

@@ -0,0 +1,20 @@
+export { transformActivity } from "./activity.js";
+export type { ActivityData } from "./activity.js";
+export { transformDaily } from "./daily.js";
+export type { DailyData } from "./daily.js";
+export { transformSleep } from "./sleep.js";
+export type { SleepData } from "./sleep.js";
+export { transformBody } from "./body.js";
+export type { BodyData } from "./body.js";
+export { transformMenstruation } from "./menstruation.js";
+export type { MenstruationData } from "./menstruation.js";
+export { mapActivityType } from "./maps/activity-type.js";
+export { mapSleepLevel } from "./maps/sleep-level.js";
+export { GarminClient, GarminApiError } from "./client.js";
+export type { GarminClientOptions, TimeRangeParams } from "./client.js";
+export { getRequestToken, getAccessToken, buildOAuthSignature, buildOAuthHeader, percentEncode, generateNonce, getTimestamp, } from "./auth.js";
+export type { GetRequestTokenOptions, GetAccessTokenOptions, } from "./auth.js";
+export { syncAll, syncActivities, syncDailies, syncSleep, syncBody, syncMenstruation, } from "./sync.js";
+export type { SyncOptions, SyncResult, SyncAllResult, } from "./sync.js";
+export type { GarminActivity, GarminActivityLap, GarminActivitySample, GarminDailySummary, GarminSleep, GarminSleepLevel, GarminBodyComposition, GarminMenstrualCycleData, GarminUserProfile, GarminActivityType, GarminOAuthRequestTokenResponse, GarminOAuthAccessTokenResponse, GarminWebhookPayload, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/garmin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/garmin/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,YAAY,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGtD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC3D,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGxE,OAAO,EACL,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,YAAY,GACb,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,OAAO,EACP,cAAc,EACd,WAAW,EACX,SAAS,EACT,QAAQ,EACR,gBAAgB,GACjB,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,WAAW,EACX,UAAU,EACV,aAAa,GACd,MAAM,WAAW,CAAC;AAGnB,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,WAAW,EACX,gBAAgB,EAChB,qBAAqB,EACrB,wBAAwB,EACxB,iBAAiB,EACjB,kBAAkB,EAClB,+BAA+B,EAC/B,8BAA8B,EAC9B,oBAAoB,GACrB,MAAM,YAAY,CAAC"}

package/dist/garmin/index.js

@@ -0,0 +1,21 @@
+// ─── @nativesquare/soma/garmin ───────────────────────────────────────────────
+// Garmin Health API → Soma schema transformers, API client, OAuth helpers, and sync.
+//
+// Uses the Web Crypto API for OAuth 1.0a HMAC-SHA1 signing.
+// Compatible with both the Convex V8 runtime and Node.js environments.
+// ── Transformers ─────────────────────────────────────────────────────────────
+export { transformActivity } from "./activity.js";
+export { transformDaily } from "./daily.js";
+export { transformSleep } from "./sleep.js";
+export { transformBody } from "./body.js";
+export { transformMenstruation } from "./menstruation.js";
+// ── Enum Maps ────────────────────────────────────────────────────────────────
+export { mapActivityType } from "./maps/activity-type.js";
+export { mapSleepLevel } from "./maps/sleep-level.js";
+// ── API Client ───────────────────────────────────────────────────────────────
+export { GarminClient, GarminApiError } from "./client.js";
+// ── OAuth Helpers ────────────────────────────────────────────────────────────
+export { getRequestToken, getAccessToken, buildOAuthSignature, buildOAuthHeader, percentEncode, generateNonce, getTimestamp, } from "./auth.js";
+// ── Sync Helpers ─────────────────────────────────────────────────────────────
+export { syncAll, syncActivities, syncDailies, syncSleep, syncBody, syncMenstruation, } from "./sync.js";
+//# sourceMappingURL=index.js.map

package/dist/garmin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/garmin/index.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,qFAAqF;AACrF,EAAE;AACF,4DAA4D;AAC5D,uEAAuE;AAEvE,gFAAgF;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGlD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,gFAAgF;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,gFAAgF;AAChF,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG3D,gFAAgF;AAChF,OAAO,EACL,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,YAAY,GACb,MAAM,WAAW,CAAC;AAMnB,gFAAgF;AAChF,OAAO,EACL,OAAO,EACP,cAAc,EACd,WAAW,EACX,SAAS,EACT,QAAQ,EACR,gBAAgB,GACjB,MAAM,WAAW,CAAC"}

package/dist/garmin/maps/activity-type.d.ts

@@ -0,0 +1,7 @@
+import type { GarminActivityType } from "../types.js";
+/**
+ * Map a Garmin activity type string to the Terra ActivityType enum.
+ * Returns Terra "Other" (108) for unknown types.
+ */
+export declare function mapActivityType(activityType: GarminActivityType): number;
+//# sourceMappingURL=activity-type.d.ts.map

package/dist/garmin/maps/activity-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-type.d.ts","sourceRoot":"","sources":["../../../src/garmin/maps/activity-type.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAsGtD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,kBAAkB,GAAG,MAAM,CAExE"}

package/dist/garmin/maps/activity-type.js

@@ -0,0 +1,98 @@
+// ─── Garmin ActivityType → Terra ActivityType ─────────────────────────────────
+// Maps Garmin activity type strings to Terra's ActivityType numeric enum
+// used by the Soma schema.
+//
+// Garmin values: Garmin Health API activity type strings
+// Terra values:  https://docs.tryterra.co/reference/health-and-fitness-api/data-models#activitytype
+const activityTypeMap = {
+    // ── Running ─────────────────────────────────────────────────────────────
+    // Terra Running = 8
+    RUNNING: 8,
+    INDOOR_RUNNING: 8,
+    TRAIL_RUNNING: 8,
+    TREADMILL_RUNNING: 8,
+    // ── Cycling ─────────────────────────────────────────────────────────────
+    // Terra Biking = 1
+    CYCLING: 1,
+    INDOOR_CYCLING: 1,
+    MOUNTAIN_BIKING: 1,
+    GRAVEL_CYCLING: 1,
+    VIRTUAL_RIDE: 1,
+    // ── Walking ─────────────────────────────────────────────────────────────
+    // Terra Walking = 7
+    WALKING: 7,
+    // ── Hiking ──────────────────────────────────────────────────────────────
+    // Terra Hiking = 35
+    HIKING: 35,
+    // ── Swimming ────────────────────────────────────────────────────────────
+    // Terra Swimming = 82
+    SWIMMING: 82,
+    OPEN_WATER_SWIMMING: 82,
+    LAP_SWIMMING: 82,
+    POOL_SWIMMING: 82,
+    // ── Gym / Fitness ───────────────────────────────────────────────────────
+    STRENGTH_TRAINING: 80, // Terra Strength Training
+    YOGA: 100, // Terra Yoga
+    PILATES: 49, // Terra Pilates
+    CARDIO: 108, // Terra Other
+    ELLIPTICAL: 25, // Terra Elliptical
+    STAIR_CLIMBING: 78, // Terra Stair Climbing Machine
+    CROSSFIT: 113, // Terra Crossfit
+    HIIT: 114, // Terra HIIT
+    FITNESS_EQUIPMENT: 108, // Terra Other
+    BREATHWORK: 108, // Terra Other
+    // ── Snow Sports ─────────────────────────────────────────────────────────
+    CROSS_COUNTRY_SKIING: 67, // Terra Cross Country Skiing
+    ALPINE_SKIING: 66, // Terra Alpine Skiing
+    SNOWBOARDING: 73, // Terra Snowboarding
+    SNOWSHOEING: 74, // Terra Snowshoeing
+    // ── Water Sports ────────────────────────────────────────────────────────
+    ROWING: 53, // Terra Rowing
+    INDOOR_ROWING: 53, // Terra Rowing
+    KAYAKING: 40, // Terra Kayaking
+    CANOEING: 22, // Terra Canoeing
+    SAILING: 59, // Terra Sailing
+    SURFING: 81, // Terra Surfing
+    KITESURFING: 41, // Terra Kitesurfing
+    WINDSURFING: 99, // Terra Windsurfing
+    PADDLEBOARDING: 129, // Terra Paddling
+    // ── Skating ─────────────────────────────────────────────────────────────
+    SKATING: 62, // Terra Skating
+    INLINE_SKATING: 62, // Terra Skating
+    // ── Racket Sports ───────────────────────────────────────────────────────
+    TENNIS: 87, // Terra Tennis
+    TABLE_TENNIS: 85, // Terra Table Tennis
+    BADMINTON: 10, // Terra Badminton
+    RACQUETBALL: 51, // Terra Racquetball
+    SQUASH: 76, // Terra Squash
+    // ── Climbing ────────────────────────────────────────────────────────────
+    ROCK_CLIMBING: 52, // Terra Rock Climbing
+    BOULDERING: 52, // Terra Rock Climbing
+    // ── Team Sports ─────────────────────────────────────────────────────────
+    SOCCER: 29, // Terra English Football
+    BASKETBALL: 11, // Terra Basketball
+    VOLLEYBALL: 94, // Terra Volleyball
+    CRICKET: 23, // Terra Cricket
+    RUGBY: 57, // Terra Rugby
+    // ── Combat Sports ───────────────────────────────────────────────────────
+    BOXING: 16, // Terra Boxing
+    MARTIAL_ARTS: 44, // Terra Martial Arts
+    // ── Golf ────────────────────────────────────────────────────────────────
+    GOLF: 32, // Terra Golf
+    // ── Accessibility ───────────────────────────────────────────────────────
+    HANDCYCLING: 14, // Terra Handbiking
+    WHEELCHAIR_PUSH_WALKING: 98, // Terra Wheelchair
+    WHEELCHAIR_PUSH_RUNNING: 98, // Terra Wheelchair
+    // ── Other ───────────────────────────────────────────────────────────────
+    OTHER: 108, // Terra Other
+    MULTI_SPORT: 108, // Terra Other
+    FLOOR_CLIMBING: 78, // Terra Stair Climbing Machine
+};
+/**
+ * Map a Garmin activity type string to the Terra ActivityType enum.
+ * Returns Terra "Other" (108) for unknown types.
+ */
+export function mapActivityType(activityType) {
+    return activityTypeMap[activityType] ?? 108;
+}
+//# sourceMappingURL=activity-type.js.map

package/dist/garmin/maps/activity-type.js.map

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

package/dist/garmin/maps/sleep-level.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Map a Garmin sleep stage name to the Terra SleepLevel enum.
+ * Returns 0 (Unknown) for unrecognized stages.
+ */
+export declare function mapSleepLevel(stage: string): number;
+//# sourceMappingURL=sleep-level.d.ts.map

package/dist/garmin/maps/sleep-level.d.ts.map

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

package/dist/garmin/maps/sleep-level.js

@@ -0,0 +1,21 @@
+// ─── Garmin Sleep Stage → Terra SleepLevel ────────────────────────────────────
+// Maps Garmin sleep stage names to Terra's SleepLevel numeric enum.
+//
+// Garmin provides sleep levels as named map keys in sleepLevelsMap:
+//   { deep: [...], light: [...], rem: [...], awake: [...] }
+//
+// Terra SleepLevel: 0=Unknown, 1=Awake, 2=Sleeping, 3=OutOfBed, 4=Light, 5=Deep, 6=REM
+const sleepLevelMap = {
+    deep: 5, // Deep → Terra Deep
+    light: 4, // Light → Terra Light
+    rem: 6, // REM → Terra REM
+    awake: 1, // Awake → Terra Awake
+};
+/**
+ * Map a Garmin sleep stage name to the Terra SleepLevel enum.
+ * Returns 0 (Unknown) for unrecognized stages.
+ */
+export function mapSleepLevel(stage) {
+    return sleepLevelMap[stage] ?? 0;
+}
+//# sourceMappingURL=sleep-level.js.map

package/dist/garmin/maps/sleep-level.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep-level.js","sourceRoot":"","sources":["../../../src/garmin/maps/sleep-level.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/garmin/menstruation.d.ts

@@ -0,0 +1,23 @@
+import type { GarminMenstrualCycleData } from "./types.js";
+export type MenstruationData = ReturnType<typeof transformMenstruation>;
+/**
+ * Transform a Garmin menstrual cycle record into a Soma Menstruation document shape.
+ *
+ * @param data - The Garmin menstrual cycle data from the Health API
+ * @returns Soma Menstruation fields (without connectionId/userId)
+ */
+export declare function transformMenstruation(data: GarminMenstrualCycleData): {
+    metadata: {
+        start_time: string;
+        end_time: string;
+    };
+    menstruation_data: {
+        day_in_cycle: number | undefined;
+        current_phase: string | undefined;
+        length_of_current_phase_days: number | undefined;
+        period_length_days: number | undefined;
+        predicted_cycle_length_days: number | undefined;
+        is_predicted_cycle: string | undefined;
+    };
+};
+//# sourceMappingURL=menstruation.d.ts.map

package/dist/garmin/menstruation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menstruation.d.ts","sourceRoot":"","sources":["../../src/garmin/menstruation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE3D,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAExE;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,wBAAwB;;;;;;;;;;;;;EA4BnE"}

package/dist/garmin/menstruation.js

@@ -0,0 +1,34 @@
+// ─── Menstruation Transformer ────────────────────────────────────────────────
+// Transforms Garmin menstrual cycle data into the Soma Menstruation schema shape.
+/**
+ * Transform a Garmin menstrual cycle record into a Soma Menstruation document shape.
+ *
+ * @param data - The Garmin menstrual cycle data from the Health API
+ * @returns Soma Menstruation fields (without connectionId/userId)
+ */
+export function transformMenstruation(data) {
+    const dateStr = data.calendarDate;
+    const startTime = data.startTimeInSeconds
+        ? new Date(data.startTimeInSeconds * 1000).toISOString()
+        : `${dateStr}T00:00:00.000Z`;
+    const endTime = data.startTimeInSeconds
+        ? new Date((data.startTimeInSeconds + 86400) * 1000).toISOString()
+        : `${dateStr}T23:59:59.999Z`;
+    return {
+        metadata: {
+            start_time: startTime,
+            end_time: endTime,
+        },
+        menstruation_data: {
+            day_in_cycle: data.dayInCycle,
+            current_phase: data.currentPhase?.toLowerCase(),
+            length_of_current_phase_days: data.lengthOfCurrentPhase,
+            period_length_days: data.periodLength,
+            predicted_cycle_length_days: data.predictedCycleLength,
+            is_predicted_cycle: data.isPredictedCycle != null
+                ? String(data.isPredictedCycle)
+                : undefined,
+        },
+    };
+}
+//# sourceMappingURL=menstruation.js.map

package/dist/garmin/menstruation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menstruation.js","sourceRoot":"","sources":["../../src/garmin/menstruation.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,kFAAkF;AAMlF;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAA8B;IAClE,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC;IAClC,MAAM,SAAS,GAAG,IAAI,CAAC,kBAAkB;QACvC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE;QACxD,CAAC,CAAC,GAAG,OAAO,gBAAgB,CAAC;IAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,kBAAkB;QACrC,CAAC,CAAC,IAAI,IAAI,CACN,CAAC,IAAI,CAAC,kBAAkB,GAAG,KAAK,CAAC,GAAG,IAAI,CACzC,CAAC,WAAW,EAAE;QACjB,CAAC,CAAC,GAAG,OAAO,gBAAgB,CAAC;IAE/B,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,YAAY,EAAE,WAAW,EAAE;YAC/C,4BAA4B,EAAE,IAAI,CAAC,oBAAoB;YACvD,kBAAkB,EAAE,IAAI,CAAC,YAAY;YACrC,2BAA2B,EAAE,IAAI,CAAC,oBAAoB;YACtD,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/garmin/sleep.d.ts

@@ -0,0 +1,62 @@
+import type { GarminSleep } from "./types.js";
+export type SleepData = ReturnType<typeof transformSleep>;
+/**
+ * Transform a Garmin sleep session into a Soma Sleep document shape.
+ *
+ * @param sleep - The Garmin sleep data from the Health API
+ * @returns Soma Sleep fields (without connectionId/userId)
+ */
+export declare function transformSleep(sleep: GarminSleep): {
+    metadata: {
+        summary_id: string;
+        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;
+            duration_unmeasurable_sleep_seconds: number | undefined;
+        };
+        hypnogram_samples: {
+            timestamp: string;
+            level: number;
+        }[] | undefined;
+    };
+    heart_rate_data: {
+        detailed: {
+            hr_samples: {
+                timestamp: string;
+                bpm: number;
+            }[];
+        };
+    } | undefined;
+    respiration_data: {
+        breaths_data: {
+            avg_breaths_per_min: number | undefined;
+            min_breaths_per_min: number | undefined;
+            max_breaths_per_min: number | undefined;
+            samples: {
+                timestamp: string;
+                breaths_per_min: number;
+            }[] | undefined;
+        } | undefined;
+        oxygen_saturation_data: {
+            avg_saturation_percentage: number | undefined;
+            samples: {
+                timestamp: string;
+                percentage: number;
+            }[];
+        } | undefined;
+    } | undefined;
+};
+//# sourceMappingURL=sleep.d.ts.map

package/dist/garmin/sleep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../../src/garmin/sleep.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAoB,MAAM,YAAY,CAAC;AAGhE,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAE1D;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;uBAyDb,MAAM;mBAAS,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA/BxD"}

package/dist/garmin/sleep.js

@@ -0,0 +1,125 @@
+// ─── Sleep Transformer ───────────────────────────────────────────────────────
+// Transforms a Garmin sleep session into the Soma Sleep schema shape.
+import { mapSleepLevel } from "./maps/sleep-level.js";
+/**
+ * Transform a Garmin sleep session into a Soma Sleep document shape.
+ *
+ * @param sleep - The Garmin sleep data from the Health API
+ * @returns Soma Sleep fields (without connectionId/userId)
+ */
+export function transformSleep(sleep) {
+    const startMs = sleep.startTimeInSeconds * 1000;
+    const endMs = startMs + sleep.durationInSeconds * 1000;
+    const uploadTypeMap = {
+        ENHANCED_FINAL: 2, // Automatic
+        ENHANCED_TENTATIVE: 4, // Indeterminate
+        AUTO_FINAL: 2, // Automatic
+        AUTO_TENTATIVE: 4, // Indeterminate
+        MANUAL: 1, // Manual
+    };
+    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),
+        heart_rate_data: buildHeartRateData(sleep),
+        respiration_data: buildRespirationData(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) {
+            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 buildHeartRateData(sleep) {
+    if (!sleep.timeOffsetHeartRateSamples ||
+        Object.keys(sleep.timeOffsetHeartRateSamples).length === 0) {
+        return undefined;
+    }
+    const hrSamples = Object.entries(sleep.timeOffsetHeartRateSamples).map(([offset, bpm]) => ({
+        timestamp: new Date((sleep.startTimeInSeconds + parseInt(offset, 10)) * 1000).toISOString(),
+        bpm,
+    }));
+    return {
+        detailed: { hr_samples: hrSamples },
+    };
+}
+function buildRespirationData(sleep) {
+    const hasBreathSummary = sleep.averageRespirationInBreathsPerMinute != null;
+    const hasBreathSamples = sleep.timeOffsetSleepRespiration != null &&
+        Object.keys(sleep.timeOffsetSleepRespiration).length > 0;
+    const hasSpO2Samples = sleep.timeOffsetSpo2Values != null &&
+        Object.keys(sleep.timeOffsetSpo2Values).length > 0;
+    if (!hasBreathSummary && !hasBreathSamples && !hasSpO2Samples) {
+        return undefined;
+    }
+    const breathSamples = hasBreathSamples
+        ? Object.entries(sleep.timeOffsetSleepRespiration).map(([offset, rate]) => ({
+            timestamp: new Date((sleep.startTimeInSeconds + parseInt(offset, 10)) * 1000).toISOString(),
+            breaths_per_min: rate,
+        }))
+        : undefined;
+    const spo2Samples = hasSpO2Samples
+        ? Object.entries(sleep.timeOffsetSpo2Values).map(([offset, pct]) => ({
+            timestamp: new Date((sleep.startTimeInSeconds + parseInt(offset, 10)) * 1000).toISOString(),
+            percentage: pct,
+        }))
+        : undefined;
+    return {
+        breaths_data: hasBreathSummary || (breathSamples && breathSamples.length > 0)
+            ? {
+                avg_breaths_per_min: sleep.averageRespirationInBreathsPerMinute,
+                min_breaths_per_min: sleep.lowestRespirationInBreathsPerMinute,
+                max_breaths_per_min: sleep.highestRespirationInBreathsPerMinute,
+                samples: breathSamples && breathSamples.length > 0
+                    ? breathSamples
+                    : undefined,
+            }
+            : undefined,
+        oxygen_saturation_data: spo2Samples && spo2Samples.length > 0
+            ? {
+                avg_saturation_percentage: sleep.averageSpo2Value,
+                samples: spo2Samples,
+            }
+            : undefined,
+    };
+}
+//# sourceMappingURL=sleep.js.map

package/dist/garmin/sleep.js.map

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