@nativesquare/soma 0.8.0 → 0.9.0

package/src/garmin/activity.test.ts

@@ -1,170 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { transformActivity } from "./activity.js";
-import type { GarminActivityExtended } from "./types.js";
-
-const baseActivity: GarminActivityExtended = {
-  userId: "garmin_user_1",
-  summaryId: "summary_12345",
-  activityId: 12345,
-  activityName: "Morning Run",
-  activityType: "RUNNING",
-  durationInSeconds: 3600,
-  startTimeInSeconds: 1700000000,
-  startTimeOffsetInSeconds: -18000,
-};
-
-describe("transformActivity", () => {
-  it("maps metadata correctly", () => {
-    const result = transformActivity(baseActivity);
-
-    expect(result.metadata.summary_id).toBe("summary_12345");
-    expect(result.metadata.start_time).toBe("2023-11-14T22:13:20.000Z");
-    expect(result.metadata.end_time).toBe("2023-11-14T23:13:20.000Z");
-    expect(result.metadata.type).toBe(8); // RUNNING → Terra Running
-    expect(result.metadata.upload_type).toBe(1); // Automatic
-    expect(result.metadata.name).toBe("Morning Run");
-  });
-
-  it("maps manual upload type", () => {
-    const manual = { ...baseActivity, manual: true };
-    const result = transformActivity(manual);
-    expect(result.metadata.upload_type).toBe(2);
-  });
-
-  it("maps duration data", () => {
-    const result = transformActivity(baseActivity);
-    expect(result.active_durations_data.activity_seconds).toBe(3600);
-  });
-
-  it("maps calories data", () => {
-    const withCalories: GarminActivityExtended = {
-      ...baseActivity,
-      activeKilocalories: 450,
-      bmrKilocalories: 75,
-    };
-    const result = transformActivity(withCalories);
-
-    expect(result.calories_data).toBeDefined();
-    expect(result.calories_data!.net_activity_calories).toBe(450);
-    expect(result.calories_data!.BMR_calories).toBe(75);
-    expect(result.calories_data!.total_burned_calories).toBe(525);
-  });
-
-  it("returns undefined calories_data when no calorie fields present", () => {
-    const result = transformActivity(baseActivity);
-    expect(result.calories_data).toBeUndefined();
-  });
-
-  it("maps distance data", () => {
-    const withDistance: GarminActivityExtended = {
-      ...baseActivity,
-      distanceInMeters: 10000,
-      elevationGainInMeters: 150,
-      elevationLossInMeters: 120,
-      steps: 12000,
-    };
-    const result = transformActivity(withDistance);
-
-    expect(result.distance_data).toBeDefined();
-    expect(result.distance_data!.summary!.distance_meters).toBe(10000);
-    expect(result.distance_data!.summary!.steps).toBe(12000);
-    expect(result.distance_data!.summary!.elevation!.gain_actual_meters).toBe(150);
-  });
-
-  it("maps heart rate summary", () => {
-    const withHR: GarminActivityExtended = {
-      ...baseActivity,
-      averageHeartRateInBeatsPerMinute: 155,
-      maxHeartRateInBeatsPerMinute: 185,
-    };
-    const result = transformActivity(withHR);
-
-    expect(result.heart_rate_data).toBeDefined();
-    expect(result.heart_rate_data!.summary!.avg_hr_bpm).toBe(155);
-    expect(result.heart_rate_data!.summary!.max_hr_bpm).toBe(185);
-  });
-
-  it("maps movement data with speed and cadence", () => {
-    const withMovement: GarminActivityExtended = {
-      ...baseActivity,
-      averageSpeedInMetersPerSecond: 3.5,
-      maxSpeedInMetersPerSecond: 5.2,
-      averageRunCadenceInStepsPerMinute: 170,
-      maxRunCadenceInStepsPerMinute: 190,
-    };
-    const result = transformActivity(withMovement);
-
-    expect(result.movement_data).toBeDefined();
-    expect(result.movement_data!.avg_speed_meters_per_second).toBe(3.5);
-    expect(result.movement_data!.max_speed_meters_per_second).toBe(5.2);
-    expect(result.movement_data!.avg_cadence_rpm).toBe(170);
-    expect(result.movement_data!.max_cadence_rpm).toBe(190);
-  });
-
-  it("maps device data", () => {
-    const withDevice: GarminActivityExtended = {
-      ...baseActivity,
-      deviceName: "Garmin Forerunner 265",
-    };
-    const result = transformActivity(withDevice);
-
-    expect(result.device_data).toBeDefined();
-    expect(result.device_data!.name).toBe("Garmin Forerunner 265");
-  });
-
-  it("maps position data", () => {
-    const withPosition: GarminActivityExtended = {
-      ...baseActivity,
-      startingLatitudeInDegree: 37.7749,
-      startingLongitudeInDegree: -122.4194,
-    };
-    const result = transformActivity(withPosition);
-
-    expect(result.position_data).toBeDefined();
-    expect(result.position_data!.start_pos_lat_lng_deg).toEqual([37.7749, -122.4194]);
-  });
-
-  it("maps power data", () => {
-    const withPower: GarminActivityExtended = {
-      ...baseActivity,
-      activityType: "CYCLING",
-      averagePowerInWatts: 200,
-      maxPowerInWatts: 450,
-    };
-    const result = transformActivity(withPower);
-
-    expect(result.power_data).toBeDefined();
-    expect(result.power_data!.avg_watts).toBe(200);
-    expect(result.power_data!.max_watts).toBe(450);
-  });
-
-  it("maps lap data", () => {
-    const withLaps: GarminActivityExtended = {
-      ...baseActivity,
-      laps: [
-        {
-          startTimeInSeconds: 1700000000,
-        },
-        {
-          startTimeInSeconds: 1700000600,
-        },
-      ],
-    };
-    const result = transformActivity(withLaps);
-
-    expect(result.lap_data).toBeDefined();
-    expect(result.lap_data!.laps).toHaveLength(2);
-    expect(result.lap_data!.laps![0].start_time).toBe(
-      new Date(1700000000 * 1000).toISOString(),
-    );
-  });
-
-  it("uses summaryId as summary_id and falls back to activityId", () => {
-    const withoutSummaryId = {
-      ...baseActivity,
-      summaryId: undefined as unknown as string,
-    };
-    const result = transformActivity(withoutSummaryId);
-    expect(result.metadata.summary_id).toBe("12345");
-  });
-});

package/src/garmin/activity.ts

@@ -1,265 +0,0 @@
-// ─── Activity Transformer ────────────────────────────────────────────────────
-// Transforms a Garmin activity into the Soma Activity schema shape.
-
-import type { GarminActivityExtended, GarminLap, GarminSample } from "./types.js";
-import { mapActivityType } from "./maps/activity-type.js";
-
-export type ActivityData = ReturnType<typeof transformActivity>;
-
-/**
- * Transform a Garmin activity into a Soma Activity document shape.
- *
- * Accepts both activity summaries (from `/rest/activities`) and detailed
- * activities (from `/rest/activityDetails` or webhook payloads) which
- * include laps, samples, and power data.
- *
- * The returned object is ready to be spread into an `ingestActivity` call
- * alongside `connectionId` and `userId`.
- */
-export function transformActivity(activity: GarminActivityExtended) {
-  const startMs = (activity.startTimeInSeconds ?? 0) * 1000;
-  const endMs = startMs + (activity.durationInSeconds ?? 0) * 1000;
-  const startDate = new Date(startMs).toISOString();
-  const endDate = new Date(endMs).toISOString();
-
-  return {
-    metadata: {
-      summary_id: activity.summaryId ?? String(activity.activityId),
-      start_time: startDate,
-      end_time: endDate,
-      type: mapActivityType(activity.activityType ?? "OTHER"),
-      upload_type: activity.manual ? 2 : 1,
-      name: activity.activityName,
-    },
-
-    active_durations_data: {
-      activity_seconds: activity.durationInSeconds,
-    },
-
-    calories_data: buildCaloriesData(activity),
-
-    device_data: activity.deviceName
-      ? { name: activity.deviceName }
-      : undefined,
-
-    distance_data: buildDistanceData(activity),
-
-    heart_rate_data: buildHeartRateData(activity),
-
-    movement_data: buildMovementData(activity),
-
-    position_data: buildPositionData(activity),
-
-    power_data: buildPowerData(activity),
-
-    lap_data: buildLapData(activity),
-  };
-}
-
-// ─── Helpers ──────────────────────────────────────────────────────────────────
-
-function buildCaloriesData(activity: GarminActivityExtended) {
-  if (
-    activity.activeKilocalories == null &&
-    activity.bmrKilocalories == null
-  ) {
-    return undefined;
-  }
-
-  const total =
-    (activity.activeKilocalories ?? 0) + (activity.bmrKilocalories ?? 0);
-
-  return {
-    net_activity_calories: activity.activeKilocalories,
-    BMR_calories: activity.bmrKilocalories,
-    total_burned_calories: total || undefined,
-  };
-}
-
-function buildDistanceData(activity: GarminActivityExtended) {
-  // Spec uses totalElevationGainInMeters; webhooks may use elevationGainInMeters
-  const elevGain = activity.totalElevationGainInMeters ?? activity.elevationGainInMeters;
-  const elevLoss = activity.totalElevationLossInMeters ?? activity.elevationLossInMeters;
-
-  if (activity.distanceInMeters == null && elevGain == null) {
-    return undefined;
-  }
-
-  return {
-    summary: {
-      distance_meters: activity.distanceInMeters,
-      steps: activity.steps,
-      elevation:
-        elevGain != null
-          ? {
-              gain_actual_meters: elevGain,
-              loss_actual_meters: elevLoss,
-            }
-          : undefined,
-    },
-  };
-}
-
-function buildHeartRateData(activity: GarminActivityExtended) {
-  const hasHrSummary =
-    activity.averageHeartRateInBeatsPerMinute != null ||
-    activity.maxHeartRateInBeatsPerMinute != null;
-  const hasSamples = activity.samples && activity.samples.length > 0;
-
-  if (!hasHrSummary && !hasSamples) return undefined;
-
-  const hrSamples = hasSamples
-    ? activity.samples!
-        .filter((s: GarminSample) => s.heartRate != null && s.startTimeInSeconds != null)
-        .map((s: GarminSample) => ({
-          timestamp: new Date(s.startTimeInSeconds! * 1000).toISOString(),
-          bpm: s.heartRate!,
-        }))
-    : undefined;
-
-  return {
-    summary: hasHrSummary
-      ? {
-          avg_hr_bpm: activity.averageHeartRateInBeatsPerMinute,
-          max_hr_bpm: activity.maxHeartRateInBeatsPerMinute,
-        }
-      : undefined,
-    detailed:
-      hrSamples && hrSamples.length > 0
-        ? { hr_samples: hrSamples }
-        : undefined,
-  };
-}
-
-function buildMovementData(activity: GarminActivityExtended) {
-  const avgCadence =
-    activity.averageRunCadenceInStepsPerMinute ??
-    activity.averageBikeCadenceInRoundsPerMinute;
-  const maxCadence =
-    activity.maxRunCadenceInStepsPerMinute ??
-    activity.maxBikeCadenceInRoundsPerMinute;
-
-  const hasMovement =
-    activity.averageSpeedInMetersPerSecond != null ||
-    activity.maxSpeedInMetersPerSecond != null ||
-    avgCadence != null;
-
-  const hasSamples = activity.samples && activity.samples.length > 0;
-
-  if (!hasMovement && !hasSamples) return undefined;
-
-  const speedSamples = hasSamples
-    ? activity.samples!
-        .filter(
-          (s: GarminSample) =>
-            s.speedMetersPerSecond != null && s.startTimeInSeconds != null,
-        )
-        .map((s: GarminSample) => ({
-          timestamp: new Date(s.startTimeInSeconds! * 1000).toISOString(),
-          speed_meters_per_second: s.speedMetersPerSecond!,
-        }))
-    : undefined;
-
-  const cadenceSamples = hasSamples
-    ? activity.samples!
-        .filter(
-          (s: GarminSample) =>
-            (s.stepsPerMinute != null ||
-              s.bikeCadenceInRPM != null) &&
-            s.startTimeInSeconds != null,
-        )
-        .map((s: GarminSample) => ({
-          timestamp: new Date(s.startTimeInSeconds! * 1000).toISOString(),
-          cadence_rpm:
-            s.stepsPerMinute ?? s.bikeCadenceInRPM ?? 0,
-        }))
-    : undefined;
-
-  return {
-    avg_speed_meters_per_second: activity.averageSpeedInMetersPerSecond,
-    max_speed_meters_per_second: activity.maxSpeedInMetersPerSecond,
-    avg_pace_minutes_per_kilometer: activity.averagePaceInMinutesPerKilometer,
-    max_pace_minutes_per_kilometer: activity.maxPaceInMinutesPerKilometer,
-    avg_cadence_rpm: avgCadence,
-    max_cadence_rpm: maxCadence,
-    speed_samples:
-      speedSamples && speedSamples.length > 0 ? speedSamples : undefined,
-    cadence_samples:
-      cadenceSamples && cadenceSamples.length > 0
-        ? cadenceSamples
-        : undefined,
-  };
-}
-
-function buildPositionData(activity: GarminActivityExtended) {
-  const hasStartPos =
-    activity.startingLatitudeInDegree != null &&
-    activity.startingLongitudeInDegree != null;
-  const hasSamples = activity.samples && activity.samples.length > 0;
-
-  if (!hasStartPos && !hasSamples) return undefined;
-
-  const positionSamples = hasSamples
-    ? activity.samples!
-        .filter(
-          (s: GarminSample) =>
-            s.latitudeInDegree != null &&
-            s.longitudeInDegree != null &&
-            s.startTimeInSeconds != null,
-        )
-        .map((s: GarminSample) => ({
-          timestamp: new Date(s.startTimeInSeconds! * 1000).toISOString(),
-          coords_lat_lng_deg: [s.latitudeInDegree!, s.longitudeInDegree!],
-        }))
-    : undefined;
-
-  return {
-    start_pos_lat_lng_deg: hasStartPos
-      ? [
-          activity.startingLatitudeInDegree!,
-          activity.startingLongitudeInDegree!,
-        ]
-      : undefined,
-    position_samples:
-      positionSamples && positionSamples.length > 0
-        ? positionSamples
-        : undefined,
-  };
-}
-
-function buildPowerData(activity: GarminActivityExtended) {
-  const hasPowerSummary =
-    activity.averagePowerInWatts != null ||
-    activity.maxPowerInWatts != null;
-  const hasSamples = activity.samples && activity.samples.length > 0;
-
-  if (!hasPowerSummary && !hasSamples) return undefined;
-
-  const powerSamples = hasSamples
-    ? activity.samples!
-        .filter(
-          (s: GarminSample) => s.powerInWatts != null && s.startTimeInSeconds != null,
-        )
-        .map((s: GarminSample) => ({
-          timestamp: new Date(s.startTimeInSeconds! * 1000).toISOString(),
-          watts: s.powerInWatts!,
-        }))
-    : undefined;
-
-  return {
-    avg_watts: activity.averagePowerInWatts,
-    max_watts: activity.maxPowerInWatts,
-    power_samples:
-      powerSamples && powerSamples.length > 0 ? powerSamples : undefined,
-  };
-}
-
-function buildLapData(activity: GarminActivityExtended) {
-  if (!activity.laps || activity.laps.length === 0) return undefined;
-
-  return {
-    laps: activity.laps.map((lap: GarminLap) => ({
-      start_time: new Date((lap.startTimeInSeconds ?? 0) * 1000).toISOString(),
-    })),
-  };
-}

package/src/garmin/auth.test.ts

@@ -1,103 +0,0 @@
-import { describe, expect, it } from "vitest";
-import {
-  generateCodeVerifier,
-  generateCodeChallenge,
-  generateState,
-  buildAuthUrl,
-} from "./auth.js";
-
-describe("generateCodeVerifier", () => {
-  it("returns a 64-character string by default", () => {
-    const verifier = generateCodeVerifier();
-    expect(verifier).toHaveLength(64);
-  });
-
-  it("only contains valid PKCE characters", () => {
-    const verifier = generateCodeVerifier();
-    expect(verifier).toMatch(/^[A-Za-z0-9\-._~]+$/);
-  });
-
-  it("respects custom length", () => {
-    const verifier = generateCodeVerifier(128);
-    expect(verifier).toHaveLength(128);
-  });
-
-  it("generates unique values", () => {
-    const v1 = generateCodeVerifier();
-    const v2 = generateCodeVerifier();
-    expect(v1).not.toBe(v2);
-  });
-});
-
-describe("generateState", () => {
-  it("returns a 64-character hex string", () => {
-    const state = generateState();
-    expect(state).toHaveLength(64);
-    expect(state).toMatch(/^[0-9a-f]+$/);
-  });
-
-  it("generates unique values", () => {
-    const s1 = generateState();
-    const s2 = generateState();
-    expect(s1).not.toBe(s2);
-  });
-});
-
-describe("generateCodeChallenge", () => {
-  it("produces a base64url-encoded string", async () => {
-    const verifier = generateCodeVerifier();
-    const challenge = await generateCodeChallenge(verifier);
-    expect(challenge).toMatch(/^[A-Za-z0-9\-_]+$/);
-    expect(challenge).not.toContain("+");
-    expect(challenge).not.toContain("/");
-    expect(challenge).not.toContain("=");
-  });
-
-  it("produces different challenges for different verifiers", async () => {
-    const c1 = await generateCodeChallenge("verifier_one_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa");
-    const c2 = await generateCodeChallenge("verifier_two_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa");
-    expect(c1).not.toBe(c2);
-  });
-
-  it("produces consistent challenges for the same verifier", async () => {
-    const verifier = "consistent_verifier_test_aaaaaaaaaaaaaaaaaa";
-    const c1 = await generateCodeChallenge(verifier);
-    const c2 = await generateCodeChallenge(verifier);
-    expect(c1).toBe(c2);
-  });
-});
-
-describe("buildAuthUrl", () => {
-  it("builds a valid authorization URL with required params", () => {
-    const url = buildAuthUrl({
-      clientId: "test-client-id",
-      codeChallenge: "test-challenge",
-    });
-
-    expect(url).toContain("https://connect.garmin.com/oauth2Confirm?");
-    expect(url).toContain("client_id=test-client-id");
-    expect(url).toContain("response_type=code");
-    expect(url).toContain("code_challenge=test-challenge");
-    expect(url).toContain("code_challenge_method=S256");
-  });
-
-  it("includes optional redirect_uri", () => {
-    const url = buildAuthUrl({
-      clientId: "test-client-id",
-      codeChallenge: "test-challenge",
-      redirectUri: "https://example.com/callback",
-    });
-
-    expect(url).toContain("redirect_uri=https%3A%2F%2Fexample.com%2Fcallback");
-  });
-
-  it("includes optional state", () => {
-    const url = buildAuthUrl({
-      clientId: "test-client-id",
-      codeChallenge: "test-challenge",
-      state: "my-state-value",
-    });
-
-    expect(url).toContain("state=my-state-value");
-  });
-});

package/src/garmin/body.ts

@@ -1,59 +0,0 @@
-// ─── Body Transformer ────────────────────────────────────────────────────────
-// Transforms Garmin body composition data into the Soma Body schema shape.
-
-import type { GarminBodyComposition } from "./types.js";
-
-export type BodyData = ReturnType<typeof transformBody>;
-
-/**
- * Transform a Garmin body composition record into a Soma Body document shape.
- *
- * @param body - The Garmin body composition data from the Health API
- * @returns Soma Body fields (without connectionId/userId)
- */
-export function transformBody(body: GarminBodyComposition) {
-  const measurementMs = (body.measurementTimeInSeconds ?? 0) * 1000;
-  const timestamp = new Date(measurementMs).toISOString();
-
-  return {
-    metadata: {
-      start_time: timestamp,
-      end_time: timestamp,
-    },
-
-    measurements_data: buildMeasurementsData(body, timestamp),
-  };
-}
-
-// ─── Helpers ──────────────────────────────────────────────────────────────────
-
-function buildMeasurementsData(
-  body: GarminBodyComposition,
-  timestamp: string,
-) {
-  if (
-    body.weightInGrams == null &&
-    body.bodyFatInPercent == null &&
-    body.bodyMassIndex == null &&
-    body.muscleMassInGrams == null &&
-    body.boneMassInGrams == null &&
-    body.bodyWaterInPercent == null
-  ) {
-    return undefined;
-  }
-
-  return {
-    measurements: [
-      {
-        measurement_time: timestamp,
-        weight_kg:
-          body.weightInGrams != null ? body.weightInGrams / 1000 : undefined,
-        BMI: body.bodyMassIndex,
-        bodyfat_percentage: body.bodyFatInPercent,
-        muscle_mass_g: body.muscleMassInGrams,
-        bone_mass_g: body.boneMassInGrams,
-        water_percentage: body.bodyWaterInPercent,
-      },
-    ],
-  };
-}