@nativesquare/soma 0.8.0 → 0.9.1

package/src/garmin/sleep.test.ts

@@ -1,109 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { transformSleep } from "./sleep.js";
-import type { GarminSleepExtended } from "./types.js";
-
-const baseSleep: GarminSleepExtended = {
-  userId: "garmin_user_1",
-  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: GarminSleepExtended = {
-      ...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: GarminSleepExtended = {
-      ...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: GarminSleepExtended = {
-      ...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();
-  });
-});

package/src/garmin/sleep.ts

@@ -1,176 +0,0 @@
-// ─── Sleep Transformer ───────────────────────────────────────────────────────
-// Transforms a Garmin sleep session into the Soma Sleep schema shape.
-
-import type { GarminSleepExtended, GarminTimeRange } from "./types.js";
-import { mapSleepLevel } from "./maps/sleep-level.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 function transformSleep(sleep: GarminSleepExtended) {
-  const startMs = (sleep.startTimeInSeconds ?? 0) * 1000;
-  const endMs = startMs + (sleep.durationInSeconds ?? 0) * 1000;
-
-  const uploadTypeMap: Record<string, number> = {
-    ENHANCED_FINAL: 2,      // Automatic
-    ENHANCED_TENTATIVE: 4,  // Indeterminate
-    AUTO_FINAL: 2,          // Automatic
-    AUTO_TENTATIVE: 4,      // Indeterminate
-    MANUAL: 1,              // Manual
-    DEVICE: 2,              // From device
-  };
-
-  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: GarminSleepExtended) {
-  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: GarminSleepExtended) {
-  if (!sleep.sleepLevelsMap) return undefined;
-
-  const samples: Array<{ timestamp: string; level: number }> = [];
-
-  for (const [stage, levels] of Object.entries(sleep.sleepLevelsMap)) {
-    if (!levels) continue;
-    const terraLevel = mapSleepLevel(stage);
-
-    for (const level of levels as GarminTimeRange[]) {
-      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 buildHeartRateData(sleep: GarminSleepExtended) {
-  if (
-    !sleep.timeOffsetHeartRateSamples ||
-    Object.keys(sleep.timeOffsetHeartRateSamples).length === 0
-  ) {
-    return undefined;
-  }
-
-  const startTime = sleep.startTimeInSeconds ?? 0;
-  const hrSamples = Object.entries(sleep.timeOffsetHeartRateSamples).map(
-    ([offset, bpm]) => ({
-      timestamp: new Date(
-        (startTime + parseInt(offset, 10)) * 1000,
-      ).toISOString(),
-      bpm,
-    }),
-  );
-
-  return {
-    detailed: { hr_samples: hrSamples },
-  };
-}
-
-function buildRespirationData(sleep: GarminSleepExtended) {
-  const hasBreathSummary =
-    sleep.averageRespirationInBreathsPerMinute != null;
-  const hasBreathSamples =
-    sleep.timeOffsetSleepRespiration != null &&
-    Object.keys(sleep.timeOffsetSleepRespiration).length > 0;
-  // Check both spec field (timeOffsetSleepSpo2) and extended field
-  const spo2Map = sleep.timeOffsetSleepSpo2 ?? sleep.timeOffsetSpo2Values;
-  const hasSpO2Samples =
-    spo2Map != null && Object.keys(spo2Map).length > 0;
-
-  if (!hasBreathSummary && !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(spo2Map!).map(([offset, pct]) => ({
-        timestamp: new Date(
-          (startTime + 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,
-  };
-}

package/src/garmin/stressDetails.ts

@@ -1,71 +0,0 @@
-// ─── Stress Details Transformer ──────────────────────────────────────────────
-// Transforms Garmin stress detail data into fields that enrich a Soma Daily record.
-
-import type { GarminStressDetail } from "./types.js";
-
-export type StressDetailsData = ReturnType<typeof transformStressDetails>;
-
-/**
- * Transform a Garmin stress detail record into stress data fields for a Soma Daily.
- *
- * This produces a partial daily shape that can be merged into a matching
- * daily record by date.
- *
- * @param stress - The Garmin stress detail data from the Health API
- * @returns Partial Soma Daily stress_data fields
- */
-export function transformStressDetails(stress: GarminStressDetail) {
-  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 {
-      calendar_date: stress.calendarDate,
-      stress_data: undefined,
-    };
-  }
-
-  const startTime = stress.startTimeInSeconds ?? 0;
-
-  const stressSamples = hasStressSamples
-    ? Object.entries(stress.timeOffsetStressLevelValues!).map(
-        ([offset, level]) => ({
-          timestamp: new Date(
-            (startTime + parseInt(offset, 10)) * 1000,
-          ).toISOString(),
-          level,
-        }),
-      )
-    : undefined;
-
-  const bodyBatterySamples = hasBodyBatterySamples
-    ? Object.entries(stress.timeOffsetBodyBatteryValues!).map(
-        ([offset, level]) => ({
-          timestamp: new Date(
-            (startTime + parseInt(offset, 10)) * 1000,
-          ).toISOString(),
-          level,
-        }),
-      )
-    : undefined;
-
-  return {
-    calendar_date: stress.calendarDate,
-    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,
-    },
-  };
-}