@nativesquare/soma 0.3.0 → 0.5.0

package/src/garmin/daily.ts

@@ -0,0 +1,211 @@
+// ─── Daily Transformer ───────────────────────────────────────────────────────
+// Transforms a Garmin daily wellness summary into the Soma Daily schema shape.
+
+import type { GarminDailySummary } from "./types.js";
+
+export type DailyData = ReturnType<typeof transformDaily>;
+
+/**
+ * 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: GarminDailySummary) {
+  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: GarminDailySummary) {
+  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: GarminDailySummary) {
+  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: GarminDailySummary) {
+  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: GarminDailySummary) {
+  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: GarminDailySummary) {
+  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: GarminDailySummary) {
+  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<T extends Record<string, unknown>>(
+  startTimeInSeconds: number,
+  offsets: Record<string, number>,
+  mapValue: (value: number) => T,
+): Array<{ timestamp: string } & T> {
+  return Object.entries(offsets).map(([offset, value]) => ({
+    timestamp: new Date(
+      (startTimeInSeconds + parseInt(offset, 10)) * 1000,
+    ).toISOString(),
+    ...mapValue(value),
+  }));
+}

package/src/garmin/index.ts

@@ -0,0 +1,76 @@
+// ─── @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 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";
+
+// ── Enum Maps ────────────────────────────────────────────────────────────────
+export { mapActivityType } from "./maps/activity-type.js";
+export { mapSleepLevel } from "./maps/sleep-level.js";
+
+// ── API Client ───────────────────────────────────────────────────────────────
+export { GarminClient, GarminApiError } from "./client.js";
+export type { GarminClientOptions, TimeRangeParams } from "./client.js";
+
+// ── OAuth Helpers ────────────────────────────────────────────────────────────
+export {
+  getRequestToken,
+  getAccessToken,
+  buildOAuthSignature,
+  buildOAuthHeader,
+  percentEncode,
+  generateNonce,
+  getTimestamp,
+} from "./auth.js";
+export type {
+  GetRequestTokenOptions,
+  GetAccessTokenOptions,
+} from "./auth.js";
+
+// ── Sync Helpers ─────────────────────────────────────────────────────────────
+export {
+  syncAll,
+  syncActivities,
+  syncDailies,
+  syncSleep,
+  syncBody,
+  syncMenstruation,
+} from "./sync.js";
+export type {
+  SyncOptions,
+  SyncResult,
+  SyncAllResult,
+} from "./sync.js";
+
+// ── Types ────────────────────────────────────────────────────────────────────
+export type {
+  GarminActivity,
+  GarminActivityLap,
+  GarminActivitySample,
+  GarminDailySummary,
+  GarminSleep,
+  GarminSleepLevel,
+  GarminBodyComposition,
+  GarminMenstrualCycleData,
+  GarminUserProfile,
+  GarminActivityType,
+  GarminOAuthRequestTokenResponse,
+  GarminOAuthAccessTokenResponse,
+  GarminWebhookPayload,
+} from "./types.js";

package/src/garmin/maps/activity-type.test.ts

@@ -0,0 +1,78 @@
+import { describe, expect, it } from "vitest";
+import { mapActivityType } from "./activity-type.js";
+
+describe("mapActivityType", () => {
+  it("maps running types to Terra Running (8)", () => {
+    expect(mapActivityType("RUNNING")).toBe(8);
+    expect(mapActivityType("INDOOR_RUNNING")).toBe(8);
+    expect(mapActivityType("TRAIL_RUNNING")).toBe(8);
+    expect(mapActivityType("TREADMILL_RUNNING")).toBe(8);
+  });
+
+  it("maps cycling types to Terra Biking (1)", () => {
+    expect(mapActivityType("CYCLING")).toBe(1);
+    expect(mapActivityType("INDOOR_CYCLING")).toBe(1);
+    expect(mapActivityType("MOUNTAIN_BIKING")).toBe(1);
+    expect(mapActivityType("GRAVEL_CYCLING")).toBe(1);
+    expect(mapActivityType("VIRTUAL_RIDE")).toBe(1);
+  });
+
+  it("maps WALKING to Terra Walking (7)", () => {
+    expect(mapActivityType("WALKING")).toBe(7);
+  });
+
+  it("maps HIKING to Terra Hiking (35)", () => {
+    expect(mapActivityType("HIKING")).toBe(35);
+  });
+
+  it("maps swimming types to Terra Swimming (82)", () => {
+    expect(mapActivityType("SWIMMING")).toBe(82);
+    expect(mapActivityType("OPEN_WATER_SWIMMING")).toBe(82);
+    expect(mapActivityType("LAP_SWIMMING")).toBe(82);
+    expect(mapActivityType("POOL_SWIMMING")).toBe(82);
+  });
+
+  it("maps snow sports correctly", () => {
+    expect(mapActivityType("ALPINE_SKIING")).toBe(66);
+    expect(mapActivityType("CROSS_COUNTRY_SKIING")).toBe(67);
+    expect(mapActivityType("SNOWBOARDING")).toBe(73);
+    expect(mapActivityType("SNOWSHOEING")).toBe(74);
+  });
+
+  it("maps water sports correctly", () => {
+    expect(mapActivityType("ROWING")).toBe(53);
+    expect(mapActivityType("INDOOR_ROWING")).toBe(53);
+    expect(mapActivityType("KAYAKING")).toBe(40);
+    expect(mapActivityType("SAILING")).toBe(59);
+    expect(mapActivityType("SURFING")).toBe(81);
+    expect(mapActivityType("KITESURFING")).toBe(41);
+  });
+
+  it("maps racket sports correctly", () => {
+    expect(mapActivityType("TENNIS")).toBe(87);
+    expect(mapActivityType("TABLE_TENNIS")).toBe(85);
+    expect(mapActivityType("BADMINTON")).toBe(10);
+    expect(mapActivityType("SQUASH")).toBe(76);
+  });
+
+  it("maps gym/fitness activities correctly", () => {
+    expect(mapActivityType("STRENGTH_TRAINING")).toBe(80);
+    expect(mapActivityType("CROSSFIT")).toBe(113);
+    expect(mapActivityType("YOGA")).toBe(100);
+    expect(mapActivityType("PILATES")).toBe(49);
+    expect(mapActivityType("HIIT")).toBe(114);
+    expect(mapActivityType("ELLIPTICAL")).toBe(25);
+    expect(mapActivityType("STAIR_CLIMBING")).toBe(78);
+  });
+
+  it("maps team sports correctly", () => {
+    expect(mapActivityType("SOCCER")).toBe(29);
+    expect(mapActivityType("BASKETBALL")).toBe(11);
+    expect(mapActivityType("VOLLEYBALL")).toBe(94);
+  });
+
+  it("returns Terra Other (108) for unknown types", () => {
+    expect(mapActivityType("UNKNOWN_SPORT" as never)).toBe(108);
+    expect(mapActivityType("" as never)).toBe(108);
+  });
+});

package/src/garmin/maps/activity-type.ts

@@ -0,0 +1,116 @@
+// ─── 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
+
+import type { GarminActivityType } from "../types.js";
+
+const activityTypeMap: Record<string, number> = {
+  // ── 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: GarminActivityType): number {
+  return activityTypeMap[activityType] ?? 108;
+}

package/src/garmin/maps/sleep-level.ts

@@ -0,0 +1,22 @@
+// ─── 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: Record<string, number> = {
+  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: string): number {
+  return sleepLevelMap[stage] ?? 0;
+}

package/src/garmin/menstruation.ts

@@ -0,0 +1,42 @@
+// ─── Menstruation Transformer ────────────────────────────────────────────────
+// Transforms Garmin menstrual cycle data into the Soma Menstruation schema shape.
+
+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 function transformMenstruation(data: GarminMenstrualCycleData) {
+  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,
+    },
+  };
+}

package/src/garmin/sleep.test.ts

@@ -0,0 +1,110 @@
+import { describe, expect, it } from "vitest";
+import { transformSleep } from "./sleep.js";
+import type { GarminSleep } from "./types.js";
+
+const baseSleep: GarminSleep = {
+  userId: "garmin_user_1",
+  userAccessToken: "token",
+  summaryId: "sleep_001",
+  calendarDate: "2023-11-14",
+  startTimeInSeconds: 1700000000,
+  startTimeOffsetInSeconds: -18000,
+  durationInSeconds: 28800, // 8 hours
+  validation: "ENHANCED_FINAL",
+};
+
+describe("transformSleep", () => {
+  it("maps metadata correctly", () => {
+    const result = transformSleep(baseSleep);
+
+    expect(result.metadata.summary_id).toBe("sleep_001");
+    expect(result.metadata.start_time).toBe("2023-11-14T22:13:20.000Z");
+    expect(result.metadata.end_time).toBe("2023-11-15T06:13:20.000Z");
+    expect(result.metadata.upload_type).toBe(2); // ENHANCED_FINAL → Automatic
+  });
+
+  it("maps manual upload type", () => {
+    const manual = { ...baseSleep, validation: "MANUAL" as const };
+    const result = transformSleep(manual);
+    expect(result.metadata.upload_type).toBe(1);
+  });
+
+  it("maps tentative as indeterminate", () => {
+    const tentative = { ...baseSleep, validation: "AUTO_TENTATIVE" as const };
+    const result = transformSleep(tentative);
+    expect(result.metadata.upload_type).toBe(4);
+  });
+
+  it("maps sleep stage durations", () => {
+    const withStages: GarminSleep = {
+      ...baseSleep,
+      deepSleepDurationInSeconds: 7200,
+      lightSleepDurationInSeconds: 14400,
+      remSleepInSeconds: 5400,
+      awakeDurationInSeconds: 1800,
+    };
+    const result = transformSleep(withStages);
+
+    const durations = result.sleep_durations_data;
+    expect(durations.asleep.duration_deep_sleep_state_seconds).toBe(7200);
+    expect(durations.asleep.duration_light_sleep_state_seconds).toBe(14400);
+    expect(durations.asleep.duration_REM_sleep_state_seconds).toBe(5400);
+    expect(durations.asleep.duration_asleep_state_seconds).toBe(27000);
+    expect(durations.awake!.duration_awake_state_seconds).toBe(1800);
+    expect(durations.other!.duration_in_bed_seconds).toBe(28800);
+  });
+
+  it("maps sleep levels hypnogram", () => {
+    const withLevels: GarminSleep = {
+      ...baseSleep,
+      sleepLevelsMap: {
+        deep: [
+          { startTimeInSeconds: 1700003600, endTimeInSeconds: 1700007200 },
+        ],
+        light: [
+          { startTimeInSeconds: 1700000000, endTimeInSeconds: 1700003600 },
+        ],
+        rem: [
+          { startTimeInSeconds: 1700010800, endTimeInSeconds: 1700014400 },
+        ],
+        awake: [
+          { startTimeInSeconds: 1700007200, endTimeInSeconds: 1700010800 },
+        ],
+      },
+    };
+    const result = transformSleep(withLevels);
+    const samples = result.sleep_durations_data.hypnogram_samples;
+
+    expect(samples).toBeDefined();
+    expect(samples).toHaveLength(4);
+    // Sorted by timestamp
+    expect(samples![0].level).toBe(4); // Light
+    expect(samples![1].level).toBe(5); // Deep
+    expect(samples![2].level).toBe(1); // Awake
+    expect(samples![3].level).toBe(6); // REM
+  });
+
+  it("maps respiration data", () => {
+    const withResp: GarminSleep = {
+      ...baseSleep,
+      averageRespirationInBreathsPerMinute: 16,
+      lowestRespirationInBreathsPerMinute: 12,
+      highestRespirationInBreathsPerMinute: 22,
+      timeOffsetSleepRespiration: {
+        "0": 16,
+        "3600": 14,
+        "7200": 12,
+      },
+    };
+    const result = transformSleep(withResp);
+
+    expect(result.respiration_data).toBeDefined();
+    expect(result.respiration_data!.breaths_data!.avg_breaths_per_min).toBe(16);
+    expect(result.respiration_data!.breaths_data!.samples).toHaveLength(3);
+  });
+
+  it("returns undefined respiration_data when no respiration fields", () => {
+    const result = transformSleep(baseSleep);
+    expect(result.respiration_data).toBeUndefined();
+  });
+});