@nativesquare/soma 0.7.3 → 0.9.0

package/src/garmin/types.ts

@@ -1,480 +0,0 @@
-// ─── Garmin Health API Response Types ────────────────────────────────────────
-// TypeScript interfaces representing Garmin Health API data shapes.
-// Derived from the Garmin Connect Developer Program documentation.
-//
-// These types define the CONTRACT for data coming from the Garmin API.
-// They are used by transformers, the API client, and OAuth helpers.
-
-// ─── Activity ─────────────────────────────────────────────────────────────────
-
-export interface GarminActivity {
-  userId: string;
-  userAccessToken: string;
-  summaryId: string;
-  activityId: number;
-  activityName?: string;
-  activityType: string;
-  durationInSeconds: number;
-  startTimeInSeconds: number;
-  startTimeOffsetInSeconds: number;
-  deviceName?: string;
-  manual?: boolean;
-
-  // Distance
-  distanceInMeters?: number;
-  elevationGainInMeters?: number;
-  elevationLossInMeters?: number;
-
-  // Calories
-  activeKilocalories?: number;
-  bmrKilocalories?: number;
-
-  // Heart rate
-  averageHeartRateInBeatsPerMinute?: number;
-  maxHeartRateInBeatsPerMinute?: number;
-
-  // Speed / pace
-  averageSpeedInMetersPerSecond?: number;
-  maxSpeedInMetersPerSecond?: number;
-  averagePaceInMinutesPerKilometer?: number;
-  maxPaceInMinutesPerKilometer?: number;
-
-  // Cadence
-  averageRunCadenceInStepsPerMinute?: number;
-  maxRunCadenceInStepsPerMinute?: number;
-  averageBikeCadenceInRoundsPerMinute?: number;
-  maxBikeCadenceInRoundsPerMinute?: number;
-
-  // Power
-  averagePowerInWatts?: number;
-  maxPowerInWatts?: number;
-  normalizedPowerInWatts?: number;
-
-  // Swimming
-  numberOfActiveLengths?: number;
-  poolLengthInMeters?: number;
-  averageSwimCadenceInStrokesPerMinute?: number;
-
-  // Position
-  startingLatitudeInDegree?: number;
-  startingLongitudeInDegree?: number;
-
-  // Steps
-  steps?: number;
-
-  // Laps
-  laps?: GarminActivityLap[];
-
-  // Samples (time-series)
-  samples?: GarminActivitySample[];
-}
-
-export interface GarminActivityLap {
-  startTimeInSeconds: number;
-  airTemperatureCelsius?: number;
-  heartRate?: number;
-  totalDistanceInMeters?: number;
-  timerDurationInSeconds: number;
-  maxSpeed?: number;
-}
-
-export interface GarminActivitySample {
-  startTimeInSeconds?: number;
-  latitudeInDegree?: number;
-  longitudeInDegree?: number;
-  elevationInMeters?: number;
-  heartRate?: number;
-  speedMetersPerSecond?: number;
-  bikeCadenceInRPM?: number;
-  runCadenceInStepsPerMinute?: number;
-  powerInWatts?: number;
-  timerDurationInSeconds?: number;
-}
-
-// ─── Daily Summary ──────────────────────────────────────────────────────────
-
-export interface GarminDailySummary {
-  userId: string;
-  userAccessToken: string;
-  summaryId: string;
-  calendarDate: string; // "YYYY-MM-DD"
-  startTimeInSeconds: number;
-  startTimeOffsetInSeconds: number;
-  durationInSeconds: number;
-
-  // Activity
-  steps?: number;
-  distanceInMeters?: number;
-  floorsClimbed?: number;
-  activeTimeInSeconds?: number;
-  activeKilocalories?: number;
-  bmrKilocalories?: number;
-  moderateIntensityDurationInSeconds?: number;
-  vigorousIntensityDurationInSeconds?: number;
-  intensityDurationGoalInSeconds?: number;
-
-  // Heart rate
-  minHeartRateInBeatsPerMinute?: number;
-  maxHeartRateInBeatsPerMinute?: number;
-  averageHeartRateInBeatsPerMinute?: number;
-  restingHeartRateInBeatsPerMinute?: number;
-  timeOffsetHeartRateSamples?: Record<string, number>;
-
-  // Stress
-  averageStressLevel?: number;
-  maxStressLevel?: number;
-  stressDurationInSeconds?: number;
-  restStressDurationInSeconds?: number;
-  activityStressDurationInSeconds?: number;
-  lowStressDurationInSeconds?: number;
-  mediumStressDurationInSeconds?: number;
-  highStressDurationInSeconds?: number;
-  timeOffsetStressLevelValues?: Record<string, number>;
-
-  // Body battery
-  timeOffsetBodyBatteryValues?: Record<string, number>;
-
-  // Pulse Ox
-  averageSpo2Value?: number;
-  lowestSpo2Value?: number;
-  latestSpo2Value?: number;
-  timeOffsetSpo2Values?: Record<string, number>;
-
-  // Respiration
-  averageRespirationInBreathsPerMinute?: number;
-  lowestRespirationInBreathsPerMinute?: number;
-  highestRespirationInBreathsPerMinute?: number;
-  timeOffsetRespirationSamples?: Record<string, number>;
-}
-
-// ─── Sleep ──────────────────────────────────────────────────────────────────
-
-export interface GarminSleep {
-  userId: string;
-  userAccessToken: string;
-  summaryId: string;
-  calendarDate: string;
-  startTimeInSeconds: number;
-  startTimeOffsetInSeconds: number;
-  durationInSeconds: number;
-  unmeasurableSleepInSeconds?: number;
-
-  // Sleep stages
-  deepSleepDurationInSeconds?: number;
-  lightSleepDurationInSeconds?: number;
-  remSleepInSeconds?: number;
-  awakeDurationInSeconds?: number;
-
-  // Nap
-  totalNapDurationInSeconds?: number;
-
-  // Validation
-  validation: "ENHANCED_TENTATIVE" | "ENHANCED_FINAL" | "AUTO_TENTATIVE" | "AUTO_FINAL" | "MANUAL" | string;
-
-  // Respiration
-  averageRespirationInBreathsPerMinute?: number;
-  lowestRespirationInBreathsPerMinute?: number;
-  highestRespirationInBreathsPerMinute?: number;
-  timeOffsetSleepRespiration?: Record<string, number>;
-
-  // SpO2
-  averageSpo2Value?: number;
-  lowestSpo2Value?: number;
-  highestSpo2Value?: number;
-  timeOffsetSpo2Values?: Record<string, number>;
-
-  // Sleep levels (time-series)
-  sleepLevelsMap?: {
-    deep?: GarminSleepLevel[];
-    light?: GarminSleepLevel[];
-    rem?: GarminSleepLevel[];
-    awake?: GarminSleepLevel[];
-  };
-
-  // Heart rate
-  timeOffsetHeartRateSamples?: Record<string, number>;
-}
-
-export interface GarminSleepLevel {
-  startTimeInSeconds: number;
-  endTimeInSeconds: number;
-}
-
-// ─── Body Composition ───────────────────────────────────────────────────────
-
-export interface GarminBodyComposition {
-  userId: string;
-  userAccessToken: string;
-  summaryId?: string;
-  measurementTimeInSeconds: number;
-  measurementTimeOffsetInSeconds?: number;
-
-  muscleMassInGrams?: number;
-  boneMassInGrams?: number;
-  bodyWaterInPercent?: number;
-  bodyFatInPercent?: number;
-  bodyMassIndex?: number;
-  weightInGrams?: number;
-}
-
-// ─── Menstrual Cycle ────────────────────────────────────────────────────────
-
-export interface GarminMenstrualCycleData {
-  userId: string;
-  userAccessToken: string;
-  summaryId?: string;
-  calendarDate: string;
-  startTimeInSeconds?: number;
-  startTimeOffsetInSeconds?: number;
-
-  dayInCycle?: number;
-  currentPhase?: string;
-  lengthOfCurrentPhase?: number;
-  periodLength?: number;
-  predictedCycleLength?: number;
-  isPredictedCycle?: boolean;
-}
-
-// ─── User Profile ───────────────────────────────────────────────────────────
-// Limited profile info available from the Garmin Health API.
-
-export interface GarminUserProfile {
-  userId: string;
-  displayName?: string;
-  weight?: number;
-  height?: number;
-  birthDate?: string;
-  gender?: string;
-}
-
-// ─── Garmin Activity Type ───────────────────────────────────────────────────
-// Known Garmin activity type strings from the API.
-
-export type GarminActivityType =
-  | "RUNNING"
-  | "INDOOR_RUNNING"
-  | "TRAIL_RUNNING"
-  | "TREADMILL_RUNNING"
-  | "CYCLING"
-  | "INDOOR_CYCLING"
-  | "MOUNTAIN_BIKING"
-  | "GRAVEL_CYCLING"
-  | "VIRTUAL_RIDE"
-  | "WALKING"
-  | "HIKING"
-  | "SWIMMING"
-  | "OPEN_WATER_SWIMMING"
-  | "LAP_SWIMMING"
-  | "POOL_SWIMMING"
-  | "STRENGTH_TRAINING"
-  | "YOGA"
-  | "PILATES"
-  | "CARDIO"
-  | "ELLIPTICAL"
-  | "STAIR_CLIMBING"
-  | "ROWING"
-  | "INDOOR_ROWING"
-  | "CROSS_COUNTRY_SKIING"
-  | "ALPINE_SKIING"
-  | "SNOWBOARDING"
-  | "SNOWSHOEING"
-  | "SKATING"
-  | "INLINE_SKATING"
-  | "GOLF"
-  | "TENNIS"
-  | "TABLE_TENNIS"
-  | "BADMINTON"
-  | "RACQUETBALL"
-  | "SQUASH"
-  | "PADDLEBOARDING"
-  | "KAYAKING"
-  | "CANOEING"
-  | "SAILING"
-  | "SURFING"
-  | "KITESURFING"
-  | "WINDSURFING"
-  | "ROCK_CLIMBING"
-  | "BOULDERING"
-  | "SOCCER"
-  | "BASKETBALL"
-  | "VOLLEYBALL"
-  | "CRICKET"
-  | "RUGBY"
-  | "BOXING"
-  | "MARTIAL_ARTS"
-  | "CROSSFIT"
-  | "HIIT"
-  | "BREATHWORK"
-  | "FLOOR_CLIMBING"
-  | "HANDCYCLING"
-  | "WHEELCHAIR_PUSH_WALKING"
-  | "WHEELCHAIR_PUSH_RUNNING"
-  | "OTHER"
-  | "MULTI_SPORT"
-  | "FITNESS_EQUIPMENT"
-  | (string & {});
-
-// ─── OAuth 2.0 ──────────────────────────────────────────────────────────────
-
-export interface GarminOAuth2TokenResponse {
-  access_token: string;
-  refresh_token: string;
-  expires_in: number;
-  token_type: string;
-  scope: string;
-  refresh_token_expires_in: number;
-}
-
-// ─── Training API V2 Types ──────────────────────────────────────────────────
-// Types for the Garmin Connect Training API V2 (workout import/scheduling).
-
-export type GarminWorkoutSport =
-  | "RUNNING"
-  | "CYCLING"
-  | "LAP_SWIMMING"
-  | "STRENGTH_TRAINING"
-  | "CARDIO_TRAINING"
-  | "GENERIC"
-  | "YOGA"
-  | "PILATES"
-  | "MULTI_SPORT"
-  | (string & {});
-
-export type GarminStepIntensity =
-  | "REST"
-  | "WARMUP"
-  | "COOLDOWN"
-  | "RECOVERY"
-  | "ACTIVE"
-  | "INTERVAL"
-  | "MAIN"
-  | (string & {});
-
-export type GarminDurationType =
-  | "TIME"
-  | "DISTANCE"
-  | "HR_LESS_THAN"
-  | "HR_GREATER_THAN"
-  | "CALORIES"
-  | "OPEN"
-  | "POWER_LESS_THAN"
-  | "POWER_GREATER_THAN"
-  | "TIME_AT_VALID_CDA"
-  | "FIXED_REST"
-  | "REPS"
-  | "FIXED_REPETITION"
-  | "REPETITION_SWIM_CSS_OFFSET"
-  | (string & {});
-
-export type GarminTargetType =
-  | "SPEED"
-  | "HEART_RATE"
-  | "CADENCE"
-  | "POWER"
-  | "GRADE"
-  | "RESISTANCE"
-  | "POWER_3S"
-  | "POWER_10S"
-  | "POWER_30S"
-  | "POWER_LAP"
-  | "SPEED_LAP"
-  | "HEART_RATE_LAP"
-  | "OPEN"
-  | "PACE"
-  | (string & {});
-
-export type GarminRepeatType =
-  | "REPEAT_UNTIL_STEPS_CMPLT"
-  | "REPEAT_UNTIL_TIME"
-  | "REPEAT_UNTIL_DISTANCE"
-  | "REPEAT_UNTIL_CALORIES"
-  | "REPEAT_UNTIL_HR_LESS_THAN"
-  | "REPEAT_UNTIL_HR_GREATER_THAN"
-  | "REPEAT_UNTIL_POWER_LESS_THAN"
-  | "REPEAT_UNTIL_POWER_GREATER_THAN"
-  | "REPEAT_UNTIL_POWER_LAST_LAP_LESS_THAN"
-  | "REPEAT_UNTIL_MAX_POWER_LAST_LAP_LESS_THAN"
-  | (string & {});
-
-export interface GarminWorkoutStep {
-  type: "WorkoutStep";
-  stepId?: number;
-  stepOrder: number;
-  intensity: GarminStepIntensity;
-  description?: string | null;
-  durationType: GarminDurationType;
-  durationValue?: number | null;
-  durationValueType?: string | null;
-  targetType?: GarminTargetType | null;
-  targetValue?: number | null;
-  targetValueLow?: number | null;
-  targetValueHigh?: number | null;
-  targetValueType?: string | null;
-  secondaryTargetType?: string | null;
-  secondaryTargetValue?: number | null;
-  secondaryTargetValueLow?: number | null;
-  secondaryTargetValueHigh?: number | null;
-  secondaryTargetValueType?: string | null;
-  strokeType?: string | null;
-  drillType?: string | null;
-  equipmentType?: string | null;
-  exerciseCategory?: string | null;
-  exerciseName?: string | null;
-  weightValue?: number | null;
-  weightDisplayUnit?: string | null;
-}
-
-export interface GarminWorkoutRepeatStep {
-  type: "WorkoutRepeatStep";
-  stepId?: number;
-  stepOrder: number;
-  repeatType: GarminRepeatType;
-  repeatValue: number;
-  skipLastRestStep?: boolean;
-  steps: Array<GarminWorkoutStep | GarminWorkoutRepeatStep>;
-}
-
-export interface GarminWorkoutSegment {
-  segmentOrder: number;
-  sport: GarminWorkoutSport;
-  poolLength?: number | null;
-  poolLengthUnit?: string | null;
-  estimatedDurationInSecs?: number | null;
-  estimatedDistanceInMeters?: number | null;
-  steps: Array<GarminWorkoutStep | GarminWorkoutRepeatStep>;
-}
-
-export interface GarminWorkout {
-  workoutId?: number;
-  ownerId?: number | null;
-  workoutName: string;
-  description?: string | null;
-  updatedDate?: string;
-  createdDate?: string;
-  sport: GarminWorkoutSport;
-  estimatedDurationInSecs?: number | null;
-  estimatedDistanceInMeters?: number | null;
-  poolLength?: number | null;
-  poolLengthUnit?: string | null;
-  workoutProvider: string;
-  workoutSourceId: string;
-  isSessionTransitionEnabled?: boolean;
-  segments: GarminWorkoutSegment[];
-}
-
-export interface GarminWorkoutSchedule {
-  scheduleId?: number;
-  workoutId: number;
-  date: string;
-}
-
-// ─── API Response Wrappers ──────────────────────────────────────────────────
-
-export interface GarminWebhookPayload {
-  activities?: Array<{ userId: string; summaryId: string; callbackURL: string }>;
-  activityDetails?: Array<{ userId: string; summaryId: string; callbackURL: string }>;
-  dailies?: Array<{ userId: string; summaryId: string; callbackURL: string }>;
-  sleeps?: Array<{ userId: string; summaryId: string; callbackURL: string }>;
-  bodyComps?: Array<{ userId: string; summaryId: string; callbackURL: string }>;
-  stressDetails?: Array<{ userId: string; summaryId: string; callbackURL: string }>;
-}