@nativesquare/soma 0.7.3 → 0.9.0

package/src/component/_generated/component.ts

@@ -24,108 +24,215 @@ import type { FunctionReference } from "convex/server";
 export type ComponentApi<Name extends string | undefined = string | undefined> =
   {
     garmin: {
-      completeGarminOAuth: FunctionReference<
-        "action",
-        "internal",
-        {
-          clientId: string;
-          clientSecret: string;
-          code: string;
-          redirectUri?: string;
-          state: string;
-        },
-        {
-          connectionId: string;
-          errors: Array<{ error: string; id: string; type: string }>;
-          synced: {
-            activities: number;
-            body: number;
-            dailies: number;
-            menstruation: number;
-            sleep: number;
-          };
-        },
-        Name
-      >;
-      connectGarmin: FunctionReference<
-        "action",
-        "internal",
-        {
-          clientId: string;
-          clientSecret: string;
-          code: string;
-          codeVerifier: string;
-          redirectUri?: string;
-          userId: string;
-        },
-        {
-          connectionId: string;
-          errors: Array<{ error: string; id: string; type: string }>;
-          synced: {
-            activities: number;
-            body: number;
-            dailies: number;
-            menstruation: number;
-            sleep: number;
-          };
-        },
-        Name
-      >;
-      disconnectGarmin: FunctionReference<
-        "action",
-        "internal",
-        { userId: string },
-        null,
-        Name
-      >;
-      getGarminAuthUrl: FunctionReference<
-        "action",
-        "internal",
-        { clientId: string; redirectUri?: string; userId?: string },
-        { authUrl: string; codeVerifier: string; state: string },
-        Name
-      >;
-      pushPlannedWorkout: FunctionReference<
-        "action",
-        "internal",
-        {
-          clientId: string;
-          clientSecret: string;
-          plannedWorkoutId: string;
-          userId: string;
-          workoutProvider?: string;
-        },
-        { garminScheduleId: number | null; garminWorkoutId: number },
-        Name
-      >;
-      syncGarmin: FunctionReference<
-        "action",
-        "internal",
-        {
-          clientId: string;
-          clientSecret: string;
-          endTimeInSeconds?: number;
-          startTimeInSeconds?: number;
-          userId: string;
-        },
-        {
-          errors: Array<{ error: string; id: string; type: string }>;
-          synced: {
-            activities: number;
-            body: number;
-            dailies: number;
-            menstruation: number;
-            sleep: number;
-          };
-        },
-        Name
-      >;
+      public: {
+        completeGarminOAuth: FunctionReference<
+          "action",
+          "internal",
+          {
+            clientId: string;
+            clientSecret: string;
+            code: string;
+            redirectUri?: string;
+            state: string;
+          },
+          any,
+          Name
+        >;
+        connectGarmin: FunctionReference<
+          "action",
+          "internal",
+          {
+            clientId: string;
+            clientSecret: string;
+            code: string;
+            codeVerifier: string;
+            redirectUri?: string;
+            userId: string;
+          },
+          any,
+          Name
+        >;
+        disconnectGarmin: FunctionReference<
+          "action",
+          "internal",
+          { userId: string },
+          any,
+          Name
+        >;
+        getGarminAuthUrl: FunctionReference<
+          "action",
+          "internal",
+          { clientId: string; redirectUri?: string; userId?: string },
+          any,
+          Name
+        >;
+        pushPlannedWorkout: FunctionReference<
+          "action",
+          "internal",
+          {
+            clientId: string;
+            clientSecret: string;
+            plannedWorkoutId: string;
+            userId: string;
+            workoutProvider?: string;
+          },
+          any,
+          Name
+        >;
+        syncAllTypes: FunctionReference<
+          "action",
+          "internal",
+          {
+            accessToken: string;
+            connectionId: string;
+            uploadEndTimeInSeconds: number;
+            uploadStartTimeInSeconds: number;
+            userId: string;
+          },
+          any,
+          Name
+        >;
+        syncGarmin: FunctionReference<
+          "action",
+          "internal",
+          {
+            clientId: string;
+            clientSecret: string;
+            endTimeInSeconds?: number;
+            startTimeInSeconds?: number;
+            userId: string;
+          },
+          any,
+          Name
+        >;
+      };
+      webhooks: {
+        handleGarminWebhookActivities: FunctionReference<
+          "action",
+          "internal",
+          { payload: any },
+          any,
+          Name
+        >;
+        handleGarminWebhookActivityDetails: FunctionReference<
+          "action",
+          "internal",
+          { payload: any },
+          any,
+          Name
+        >;
+        handleGarminWebhookBloodPressures: FunctionReference<
+          "action",
+          "internal",
+          { payload: any },
+          any,
+          Name
+        >;
+        handleGarminWebhookBodyCompositions: FunctionReference<
+          "action",
+          "internal",
+          { payload: any },
+          any,
+          Name
+        >;
+        handleGarminWebhookDailies: FunctionReference<
+          "action",
+          "internal",
+          { payload: any },
+          any,
+          Name
+        >;
+        handleGarminWebhookEpochs: FunctionReference<
+          "action",
+          "internal",
+          { payload: any },
+          any,
+          Name
+        >;
+        handleGarminWebhookHealthSnapshot: FunctionReference<
+          "action",
+          "internal",
+          { payload: any },
+          any,
+          Name
+        >;
+        handleGarminWebhookHRVSummary: FunctionReference<
+          "action",
+          "internal",
+          { payload: any },
+          any,
+          Name
+        >;
+        handleGarminWebhookManuallyUpdatedActivities: FunctionReference<
+          "action",
+          "internal",
+          { payload: any },
+          any,
+          Name
+        >;
+        handleGarminWebhookMenstrualCycleTracking: FunctionReference<
+          "action",
+          "internal",
+          { payload: any },
+          any,
+          Name
+        >;
+        handleGarminWebhookMoveIQ: FunctionReference<
+          "action",
+          "internal",
+          { payload: any },
+          any,
+          Name
+        >;
+        handleGarminWebhookPulseOx: FunctionReference<
+          "action",
+          "internal",
+          { payload: any },
+          any,
+          Name
+        >;
+        handleGarminWebhookRespiration: FunctionReference<
+          "action",
+          "internal",
+          { payload: any },
+          any,
+          Name
+        >;
+        handleGarminWebhookSkinTemp: FunctionReference<
+          "action",
+          "internal",
+          { payload: any },
+          any,
+          Name
+        >;
+        handleGarminWebhookSleeps: FunctionReference<
+          "action",
+          "internal",
+          { payload: any },
+          any,
+          Name
+        >;
+        handleGarminWebhookStress: FunctionReference<
+          "action",
+          "internal",
+          { payload: any },
+          any,
+          Name
+        >;
+        handleGarminWebhookUserMetrics: FunctionReference<
+          "action",
+          "internal",
+          { payload: any },
+          any,
+          Name
+        >;
+      };
     };
     public: {
       connect: FunctionReference<
         "mutation",
         "internal",
-        { provider: string; userId: string },
+        { provider: string; providerUserId?: string; userId: string },
         string,
         Name
       >;
@@ -167,6 +274,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
           active?: boolean;
           lastDataUpdate?: string;
           provider: string;
+          providerUserId?: string;
           userId: string;
         },
         Name
@@ -181,6 +289,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
           active?: boolean;
           lastDataUpdate?: string;
           provider: string;
+          providerUserId?: string;
           userId: string;
         },
         Name
@@ -827,6 +936,14 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
             }>;
             vo2max_ml_per_min_per_kg?: number;
           };
+          respiration_data?: {
+            breaths_data?: {
+              avg_breaths_per_min?: number;
+              max_breaths_per_min?: number;
+              min_breaths_per_min?: number;
+              samples?: Array<{ breaths_per_min?: number; timestamp?: string }>;
+            };
+          };
           scores?: {
             activity?: number;
             biological_age?: number;
@@ -1069,6 +1186,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
             planned_date?: string;
             pool_length_meters?: number;
             provider?: string;
+            provider_schedule_id?: string;
+            provider_workout_id?: string;
             type?: string;
           };
           steps?: Array<{
@@ -1310,6 +1429,7 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
           active?: boolean;
           lastDataUpdate?: string;
           provider: string;
+          providerUserId?: string;
           userId: string;
         }>,
         Name
@@ -1515,58 +1635,65 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
       updateConnection: FunctionReference<
         "mutation",
         "internal",
-        { active?: boolean; connectionId: string; lastDataUpdate?: string },
-        null,
-        Name
-      >;
-    };
-    strava: {
-      connectStrava: FunctionReference<
-        "action",
-        "internal",
-        {
-          baseUrl?: string;
-          clientId: string;
-          clientSecret: string;
-          code: string;
-          includeStreams?: boolean;
-          userId: string;
-        },
         {
+          active?: boolean;
           connectionId: string;
-          errors: Array<{ activityId: number; error: string }>;
-          synced: number;
-        },
-        Name
-      >;
-      disconnectStrava: FunctionReference<
-        "action",
-        "internal",
-        {
-          baseUrl?: string;
-          clientId: string;
-          clientSecret: string;
-          userId: string;
+          lastDataUpdate?: string;
+          providerUserId?: string;
         },
         null,
         Name
       >;
-      syncStrava: FunctionReference<
-        "action",
-        "internal",
-        {
-          after?: number;
-          baseUrl?: string;
-          clientId: string;
-          clientSecret: string;
-          includeStreams?: boolean;
-          userId: string;
-        },
-        {
-          errors: Array<{ activityId: number; error: string }>;
-          synced: number;
-        },
-        Name
-      >;
+    };
+    strava: {
+      public: {
+        connectStrava: FunctionReference<
+          "action",
+          "internal",
+          {
+            baseUrl?: string;
+            clientId: string;
+            clientSecret: string;
+            code: string;
+            includeStreams?: boolean;
+            userId: string;
+          },
+          {
+            connectionId: string;
+            errors: Array<{ activityId: number; error: string }>;
+            synced: number;
+          },
+          Name
+        >;
+        disconnectStrava: FunctionReference<
+          "action",
+          "internal",
+          {
+            baseUrl?: string;
+            clientId: string;
+            clientSecret: string;
+            userId: string;
+          },
+          null,
+          Name
+        >;
+        syncStrava: FunctionReference<
+          "action",
+          "internal",
+          {
+            after?: number;
+            baseUrl?: string;
+            clientId: string;
+            clientSecret: string;
+            includeStreams?: boolean;
+            userId: string;
+          },
+          {
+            errors: Array<{ activityId: number; error: string }>;
+            synced: number;
+          },
+          Name
+        >;
+      };
     };
   };

package/src/{garmin → component/garmin}/auth.ts

@@ -2,7 +2,14 @@
 // Pure helper functions for the Garmin OAuth 2.0 PKCE flow.
 // Uses the Web Crypto API for SHA-256 challenge generation and global `fetch`.
 
-import type { GarminOAuth2TokenResponse } from "./types.js";
+export interface GarminOAuth2TokenResponse {
+  access_token: string;
+  refresh_token: string;
+  expires_in: number;
+  token_type: string;
+  scope: string;
+  refresh_token_expires_in: number;
+}
 
 const AUTH_URL = "https://connect.garmin.com/oauth2Confirm";
 const TOKEN_URL =

package/src/component/garmin/client.ts

@@ -0,0 +1,39 @@
+// ─── Garmin API Helpers ──────────────────────────────────────────────────────
+// Shared utilities for calling the Garmin Health & Training APIs.
+// Both APIs use the auto-generated @hey-api/openapi-ts SDK.
+
+import { createClient, createConfig } from "./types/wellnessApi/client/index.js";
+import {
+  createClient as createTrainingApiClient,
+  createConfig as createTrainingApiConfig,
+} from "./types/trainingApiWorkouts/client/index.js";
+
+// ─── Wellness API Client ────────────────────────────────────────────────────
+
+/**
+ * Create a configured wellness API client with Bearer auth.
+ *
+ * Each call creates a lightweight client instance — no connection pooling or
+ * shared state. Safe to create per-request.
+ */
+export function createWellnessClient(accessToken: string) {
+  return createClient(createConfig({
+    baseUrl: "https://apis.garmin.com/wellness-api",
+    headers: { Authorization: `Bearer ${accessToken}` },
+  }));
+}
+
+// ─── Training API Client ────────────────────────────────────────────────────
+
+/**
+ * Create a configured training API client with Bearer auth.
+ *
+ * Same lightweight pattern as the wellness client. Used for workout CRUD
+ * and schedule operations.
+ */
+export function createTrainingClient(accessToken: string) {
+  return createTrainingApiClient(createTrainingApiConfig({
+    baseUrl: "https://apis.garmin.com",
+    headers: { Authorization: `Bearer ${accessToken}` },
+  }));
+}