@nativesquare/soma 0.8.0 → 0.9.0

package/src/component/_generated/component.ts

@@ -24,243 +24,209 @@ 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;
-            bloodPressures: number;
-            body: number;
-            dailies: number;
-            hrv: number;
-            menstruation: number;
-            pulseOx: number;
-            respiration: number;
-            skinTemp: number;
-            sleep: number;
-            stressDetails: number;
-            userMetrics: 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;
-            bloodPressures: number;
-            body: number;
-            dailies: number;
-            hrv: number;
-            menstruation: number;
-            pulseOx: number;
-            respiration: number;
-            skinTemp: number;
-            sleep: number;
-            stressDetails: number;
-            userMetrics: 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
-      >;
-      handleGarminWebhookActivities: FunctionReference<
-        "action",
-        "internal",
-        { payload: any },
-        {
-          errors: Array<{ error: string; id: string; type: string }>;
-          processed: number;
-        },
-        Name
-      >;
-      handleGarminWebhookBloodPressures: FunctionReference<
-        "action",
-        "internal",
-        { payload: any },
-        {
-          errors: Array<{ error: string; id: string; type: string }>;
-          processed: number;
-        },
-        Name
-      >;
-      handleGarminWebhookBody: FunctionReference<
-        "action",
-        "internal",
-        { payload: any },
-        {
-          errors: Array<{ error: string; id: string; type: string }>;
-          processed: number;
-        },
-        Name
-      >;
-      handleGarminWebhookDailies: FunctionReference<
-        "action",
-        "internal",
-        { payload: any },
-        {
-          errors: Array<{ error: string; id: string; type: string }>;
-          processed: number;
-        },
-        Name
-      >;
-      handleGarminWebhookHRV: FunctionReference<
-        "action",
-        "internal",
-        { payload: any },
-        {
-          errors: Array<{ error: string; id: string; type: string }>;
-          processed: number;
-        },
-        Name
-      >;
-      handleGarminWebhookMenstruation: FunctionReference<
-        "action",
-        "internal",
-        { payload: any },
-        {
-          errors: Array<{ error: string; id: string; type: string }>;
-          processed: number;
-        },
-        Name
-      >;
-      handleGarminWebhookPulseOx: FunctionReference<
-        "action",
-        "internal",
-        { payload: any },
-        {
-          errors: Array<{ error: string; id: string; type: string }>;
-          processed: number;
-        },
-        Name
-      >;
-      handleGarminWebhookRespiration: FunctionReference<
-        "action",
-        "internal",
-        { payload: any },
-        {
-          errors: Array<{ error: string; id: string; type: string }>;
-          processed: number;
-        },
-        Name
-      >;
-      handleGarminWebhookSkinTemp: FunctionReference<
-        "action",
-        "internal",
-        { payload: any },
-        {
-          errors: Array<{ error: string; id: string; type: string }>;
-          processed: number;
-        },
-        Name
-      >;
-      handleGarminWebhookSleeps: FunctionReference<
-        "action",
-        "internal",
-        { payload: any },
-        {
-          errors: Array<{ error: string; id: string; type: string }>;
-          processed: number;
-        },
-        Name
-      >;
-      handleGarminWebhookStressDetails: FunctionReference<
-        "action",
-        "internal",
-        { payload: any },
-        {
-          errors: Array<{ error: string; id: string; type: string }>;
-          processed: number;
-        },
-        Name
-      >;
-      handleGarminWebhookUserMetrics: FunctionReference<
-        "action",
-        "internal",
-        { payload: any },
-        {
-          errors: Array<{ error: string; id: string; type: string }>;
-          processed: number;
-        },
-        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;
-            bloodPressures: number;
-            body: number;
-            dailies: number;
-            hrv: number;
-            menstruation: number;
-            pulseOx: number;
-            respiration: number;
-            skinTemp: number;
-            sleep: number;
-            stressDetails: number;
-            userMetrics: 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<
@@ -1680,52 +1646,54 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
       >;
     };
     strava: {
-      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
-      >;
+      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}` },
+  }));
+}