@nativesquare/soma 0.8.0 → 0.9.0

package/src/client/index.ts

@@ -1,6 +1,6 @@
 import type { ComponentApi } from "../component/_generated/component.js";
 import type { ActionCtx, MutationCtx, QueryCtx } from "./types.js";
-import { httpActionGeneric, type HttpRouter } from "convex/server";
+import { httpActionGeneric, type FunctionReference, type HttpRouter } from "convex/server";
 import { buildAuthUrl } from "../strava/auth.js";
 
 export type SomaComponent = ComponentApi;
@@ -9,7 +9,7 @@ export type SomaComponent = ComponentApi;
 // Used by `registerRoutes` as defaults. Override per-provider in the opts.
 
 export const STRAVA_CALLBACK_PATH = "/api/strava/callback";
-export const GARMIN_CALLBACK_PATH = "/api/garmin/callback";
+export const GARMIN_OAUTH_CALLBACK_PATH = "/api/garmin/callback";
 export const GARMIN_WEBHOOK_BASE_PATH = "/api/garmin/webhook";
 
 /**
@@ -866,7 +866,7 @@ export class Soma {
     },
   ) {
     const config = this.requireGarminConfig();
-    return await ctx.runAction(this.component.garmin.pushPlannedWorkout, {
+    return await ctx.runAction(this.component.garmin.public.pushPlannedWorkout, {
       ...args,
       clientId: config.clientId,
       clientSecret: config.clientSecret,
@@ -942,7 +942,7 @@ export class Soma {
     args: { userId: string; code: string; includeStreams?: boolean },
   ) {
     const config = this.requireStravaConfig();
-    return await ctx.runAction(this.component.strava.connectStrava, {
+    return await ctx.runAction(this.component.strava.public.connectStrava, {
       ...args,
       clientId: config.clientId,
       clientSecret: config.clientSecret,
@@ -977,7 +977,7 @@ export class Soma {
     args: { userId: string; includeStreams?: boolean; after?: number },
   ) {
     const config = this.requireStravaConfig();
-    return await ctx.runAction(this.component.strava.syncStrava, {
+    return await ctx.runAction(this.component.strava.public.syncStrava, {
       ...args,
       clientId: config.clientId,
       clientSecret: config.clientSecret,
@@ -1009,7 +1009,7 @@ export class Soma {
     args: { userId: string },
   ) {
     const config = this.requireStravaConfig();
-    return await ctx.runAction(this.component.strava.disconnectStrava, {
+    return await ctx.runAction(this.component.strava.public.disconnectStrava, {
       ...args,
       clientId: config.clientId,
       clientSecret: config.clientSecret,
@@ -1055,7 +1055,7 @@ export class Soma {
     opts: { redirectUri?: string; userId?: string },
   ) {
     const config = this.requireGarminConfig();
-    return await ctx.runAction(this.component.garmin.getGarminAuthUrl, {
+    return await ctx.runAction(this.component.garmin.public.getGarminAuthUrl, {
       clientId: config.clientId,
       redirectUri: opts.redirectUri,
       userId: opts.userId,
@@ -1103,7 +1103,7 @@ export class Soma {
     },
   ) {
     const config = this.requireGarminConfig();
-    return await ctx.runAction(this.component.garmin.connectGarmin, {
+    return await ctx.runAction(this.component.garmin.public.connectGarmin, {
       ...args,
       clientId: config.clientId,
       clientSecret: config.clientSecret,
@@ -1128,7 +1128,7 @@ export class Soma {
     args: { code: string; state: string; redirectUri?: string },
   ) {
     const config = this.requireGarminConfig();
-    return await ctx.runAction(this.component.garmin.completeGarminOAuth, {
+    return await ctx.runAction(this.component.garmin.public.completeGarminOAuth, {
       ...args,
       clientId: config.clientId,
       clientSecret: config.clientSecret,
@@ -1167,7 +1167,7 @@ export class Soma {
     },
   ) {
     const config = this.requireGarminConfig();
-    return await ctx.runAction(this.component.garmin.syncGarmin, {
+    return await ctx.runAction(this.component.garmin.public.syncGarmin, {
       ...args,
       clientId: config.clientId,
       clientSecret: config.clientSecret,
@@ -1197,137 +1197,7 @@ export class Soma {
     ctx: ActionCtx,
     args: { userId: string },
   ) {
-    return await ctx.runAction(this.component.garmin.disconnectGarmin, args);
-  }
-
-  // ── Garmin Webhook Handlers ──────────────────────────────────────────────
-  // For host apps that handle webhook routes manually instead of using
-  // registerRoutes. Pass the raw JSON body from the Garmin POST request.
-
-  /**
-   * Handle a Garmin activities webhook (push mode).
-   *
-   * @param ctx - Convex action context
-   * @param payload - The raw JSON body from Garmin's POST (array of GarminActivity)
-   */
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  private get garminApi(): any { return this.component.garmin; }
-
-  async handleGarminWebhookActivities(ctx: ActionCtx, payload: unknown) {
-    return await ctx.runAction(
-      this.garminApi.handleGarminWebhookActivities,
-      { payload },
-    );
-  }
-
-  /**
-   * Handle a Garmin dailies webhook (push mode).
-   */
-  async handleGarminWebhookDailies(ctx: ActionCtx, payload: unknown) {
-    return await ctx.runAction(
-      this.garminApi.handleGarminWebhookDailies,
-      { payload },
-    );
-  }
-
-  /**
-   * Handle a Garmin sleeps webhook (push mode).
-   */
-  async handleGarminWebhookSleeps(ctx: ActionCtx, payload: unknown) {
-    return await ctx.runAction(
-      this.garminApi.handleGarminWebhookSleeps,
-      { payload },
-    );
-  }
-
-  /**
-   * Handle a Garmin body composition webhook (push mode).
-   */
-  async handleGarminWebhookBody(ctx: ActionCtx, payload: unknown) {
-    return await ctx.runAction(
-      this.garminApi.handleGarminWebhookBody,
-      { payload },
-    );
-  }
-
-  /**
-   * Handle a Garmin menstrual cycle tracking webhook (push mode).
-   */
-  async handleGarminWebhookMenstruation(ctx: ActionCtx, payload: unknown) {
-    return await ctx.runAction(
-      this.garminApi.handleGarminWebhookMenstruation,
-      { payload },
-    );
-  }
-
-  /**
-   * Handle a Garmin blood pressure webhook (push mode).
-   */
-  async handleGarminWebhookBloodPressures(ctx: ActionCtx, payload: unknown) {
-    return await ctx.runAction(
-      this.garminApi.handleGarminWebhookBloodPressures,
-      { payload },
-    );
-  }
-
-  /**
-   * Handle a Garmin skin temperature webhook (push mode).
-   */
-  async handleGarminWebhookSkinTemp(ctx: ActionCtx, payload: unknown) {
-    return await ctx.runAction(
-      this.garminApi.handleGarminWebhookSkinTemp,
-      { payload },
-    );
-  }
-
-  /**
-   * Handle a Garmin user metrics webhook (push mode).
-   */
-  async handleGarminWebhookUserMetrics(ctx: ActionCtx, payload: unknown) {
-    return await ctx.runAction(
-      this.garminApi.handleGarminWebhookUserMetrics,
-      { payload },
-    );
-  }
-
-  /**
-   * Handle a Garmin HRV webhook (push mode).
-   */
-  async handleGarminWebhookHRV(ctx: ActionCtx, payload: unknown) {
-    return await ctx.runAction(
-      this.garminApi.handleGarminWebhookHRV,
-      { payload },
-    );
-  }
-
-  /**
-   * Handle a Garmin stress details webhook (push mode).
-   */
-  async handleGarminWebhookStressDetails(ctx: ActionCtx, payload: unknown) {
-    return await ctx.runAction(
-      this.garminApi.handleGarminWebhookStressDetails,
-      { payload },
-    );
-  }
-
-  /**
-   * Handle a Garmin pulse oximetry webhook (push mode).
-   */
-  async handleGarminWebhookPulseOx(ctx: ActionCtx, payload: unknown) {
-    return await ctx.runAction(
-      this.garminApi.handleGarminWebhookPulseOx,
-      { payload },
-    );
-  }
-
-  /**
-   * Handle a Garmin respiration webhook (push mode).
-   */
-  async handleGarminWebhookRespiration(ctx: ActionCtx, payload: unknown) {
-    return await ctx.runAction(
-      this.garminApi.handleGarminWebhookRespiration,
-      { payload },
-    );
+    return await ctx.runAction(this.component.garmin.public.disconnectGarmin, args);
   }
 }
 
@@ -1481,7 +1351,7 @@ export function registerRoutes(
         if (!userId) {
           return new Response(
             "Missing state parameter (userId). Pass the userId as the state " +
-              "parameter when building the Strava auth URL.",
+            "parameter when building the Strava auth URL.",
             { status: 400 },
           );
         }
@@ -1494,13 +1364,13 @@ export function registerRoutes(
         if (!clientId || !clientSecret) {
           return new Response(
             "Strava credentials not configured. Set STRAVA_CLIENT_ID and " +
-              "STRAVA_CLIENT_SECRET environment variables, or pass them to registerRoutes.",
+            "STRAVA_CLIENT_SECRET environment variables, or pass them to registerRoutes.",
             { status: 500 },
           );
         }
 
         try {
-          await ctx.runAction(component.strava.connectStrava, {
+          await ctx.runAction(component.strava.public.connectStrava, {
             userId,
             code,
             clientId,
@@ -1531,7 +1401,7 @@ export function registerRoutes(
 
   if (registerAll || opts?.garmin) {
     const garmin = opts?.garmin ?? {};
-    const path = garmin.path ?? GARMIN_CALLBACK_PATH;
+    const path = garmin.path ?? GARMIN_OAUTH_CALLBACK_PATH;
 
     http.route({
       path,
@@ -1549,7 +1419,7 @@ export function registerRoutes(
         if (!state) {
           return new Response(
             "Missing state parameter. Ensure the state was included " +
-              "when building the Garmin auth URL.",
+            "when building the Garmin auth URL.",
             { status: 400 },
           );
         }
@@ -1562,13 +1432,13 @@ export function registerRoutes(
         if (!clientId || !clientSecret) {
           return new Response(
             "Garmin credentials not configured. Set GARMIN_CLIENT_ID and " +
-              "GARMIN_CLIENT_SECRET environment variables, or pass them to registerRoutes.",
+            "GARMIN_CLIENT_SECRET environment variables, or pass them to registerRoutes.",
             { status: 500 },
           );
         }
 
         try {
-          await ctx.runAction(component.garmin.completeGarminOAuth, {
+          await ctx.runAction(component.garmin.public.completeGarminOAuth, {
             code,
             state,
             clientId,
@@ -1595,38 +1465,37 @@ export function registerRoutes(
       }),
     });
 
-    // ── Garmin Webhook Routes (Push Mode) ──────────────────────────────────
+    // ── Garmin Webhook Routes ──────────────────────────────────
     if (garmin.webhook !== false) {
       const webhookBase =
         (garmin.webhook && garmin.webhook.basePath) ?? GARMIN_WEBHOOK_BASE_PATH;
 
-      // eslint-disable-next-line @typescript-eslint/no-explicit-any
-      const garminApi = component.garmin as any;
       const webhookRoutes: Array<{
         suffix: string;
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        action: any;
+        action: FunctionReference<"action", "internal", { payload: any }>;
       }> = [
-        // ACTIVITY category
-        { suffix: "/activities", action: garminApi.handleGarminWebhookActivities },
-        { suffix: "/activity-details", action: garminApi.handleGarminWebhookActivities },
-        { suffix: "/manually-updated-activities", action: garminApi.handleGarminWebhookActivities },
-        { suffix: "/move-iq", action: garminApi.handleGarminWebhookActivities },
-        // HEALTH category
-        { suffix: "/dailies", action: garminApi.handleGarminWebhookDailies },
-        { suffix: "/sleeps", action: garminApi.handleGarminWebhookSleeps },
-        { suffix: "/hrv", action: garminApi.handleGarminWebhookHRV },
-        { suffix: "/stress-details", action: garminApi.handleGarminWebhookStressDetails },
-        { suffix: "/pulse-ox", action: garminApi.handleGarminWebhookPulseOx },
-        { suffix: "/respiration", action: garminApi.handleGarminWebhookRespiration },
-        // BODY category
-        { suffix: "/body", action: garminApi.handleGarminWebhookBody },
-        { suffix: "/blood-pressures", action: garminApi.handleGarminWebhookBloodPressures },
-        { suffix: "/skin-temp", action: garminApi.handleGarminWebhookSkinTemp },
-        { suffix: "/user-metrics", action: garminApi.handleGarminWebhookUserMetrics },
-        // WOMEN_HEALTH category
-        { suffix: "/menstruation", action: garminApi.handleGarminWebhookMenstruation },
-      ];
+          // ACTIVITY category
+          { suffix: "/activities", action: component.garmin.webhooks.handleGarminWebhookActivities },
+          { suffix: "/activity-details", action: component.garmin.webhooks.handleGarminWebhookActivityDetails },
+          { suffix: "/manually-updated-activities", action: component.garmin.webhooks.handleGarminWebhookManuallyUpdatedActivities },
+          { suffix: "/move-iq", action: component.garmin.webhooks.handleGarminWebhookMoveIQ },
+          // HEALTH category
+          { suffix: "/blood-pressures", action: component.garmin.webhooks.handleGarminWebhookBloodPressures },
+          { suffix: "/body-compositions", action: component.garmin.webhooks.handleGarminWebhookBodyCompositions },
+          { suffix: "/dailies", action: component.garmin.webhooks.handleGarminWebhookDailies },
+          { suffix: "/epochs", action: component.garmin.webhooks.handleGarminWebhookEpochs },
+          { suffix: "/health-snapshot", action: component.garmin.webhooks.handleGarminWebhookHealthSnapshot },
+          { suffix: "/sleeps", action: component.garmin.webhooks.handleGarminWebhookSleeps },
+          { suffix: "/hrv", action: component.garmin.webhooks.handleGarminWebhookHRVSummary },
+          { suffix: "/stress", action: component.garmin.webhooks.handleGarminWebhookStress },
+          { suffix: "/pulse-ox", action: component.garmin.webhooks.handleGarminWebhookPulseOx },
+          { suffix: "/respiration", action: component.garmin.webhooks.handleGarminWebhookRespiration },
+          { suffix: "/skin-temp", action: component.garmin.webhooks.handleGarminWebhookSkinTemp },
+          { suffix: "/user-metrics", action: component.garmin.webhooks.handleGarminWebhookUserMetrics },
+          // WOMEN_HEALTH category
+          { suffix: "/menstrual-cycle-tracking", action: component.garmin.webhooks.handleGarminWebhookMenstrualCycleTracking },
+        ];
 
       for (const route of webhookRoutes) {
         http.route({

package/src/component/_generated/api.ts

@@ -8,10 +8,56 @@
  * @module
  */
 
-import type * as garmin from "../garmin.js";
+import type * as garmin_auth from "../garmin/auth.js";
+import type * as garmin_client from "../garmin/client.js";
+import type * as garmin_private from "../garmin/private.js";
+import type * as garmin_public from "../garmin/public.js";
+import type * as garmin_schemas_activity from "../garmin/schemas/activity.js";
+import type * as garmin_schemas_activityDetails from "../garmin/schemas/activityDetails.js";
+import type * as garmin_schemas_bloodPressure from "../garmin/schemas/bloodPressure.js";
+import type * as garmin_schemas_bodyCompositions from "../garmin/schemas/bodyCompositions.js";
+import type * as garmin_schemas_dailies from "../garmin/schemas/dailies.js";
+import type * as garmin_schemas_epochs from "../garmin/schemas/epochs.js";
+import type * as garmin_schemas_healthSnapshot from "../garmin/schemas/healthSnapshot.js";
+import type * as garmin_schemas_hrvSummary from "../garmin/schemas/hrvSummary.js";
+import type * as garmin_schemas_manuallyUpdatedActivities from "../garmin/schemas/manuallyUpdatedActivities.js";
+import type * as garmin_schemas_menstrualCycleTracking from "../garmin/schemas/menstrualCycleTracking.js";
+import type * as garmin_schemas_moveIQ from "../garmin/schemas/moveIQ.js";
+import type * as garmin_schemas_pulseOx from "../garmin/schemas/pulseOx.js";
+import type * as garmin_schemas_respiration from "../garmin/schemas/respiration.js";
+import type * as garmin_schemas_skinTemperature from "../garmin/schemas/skinTemperature.js";
+import type * as garmin_schemas_sleeps from "../garmin/schemas/sleeps.js";
+import type * as garmin_schemas_stress from "../garmin/schemas/stress.js";
+import type * as garmin_schemas_userMetrics from "../garmin/schemas/userMetrics.js";
+import type * as garmin_transform_activity from "../garmin/transform/activity.js";
+import type * as garmin_transform_activityDetails from "../garmin/transform/activityDetails.js";
+import type * as garmin_transform_bloodPressure from "../garmin/transform/bloodPressure.js";
+import type * as garmin_transform_bodyCompositions from "../garmin/transform/bodyCompositions.js";
+import type * as garmin_transform_dailies from "../garmin/transform/dailies.js";
+import type * as garmin_transform_epochs from "../garmin/transform/epochs.js";
+import type * as garmin_transform_healthSnapshot from "../garmin/transform/healthSnapshot.js";
+import type * as garmin_transform_hrvSummary from "../garmin/transform/hrvSummary.js";
+import type * as garmin_transform_manuallyUpdatedActivities from "../garmin/transform/manuallyUpdatedActivities.js";
+import type * as garmin_transform_maps_activityType from "../garmin/transform/maps/activityType.js";
+import type * as garmin_transform_maps_sleepLevel from "../garmin/transform/maps/sleepLevel.js";
+import type * as garmin_transform_menstrualCycleTracking from "../garmin/transform/menstrualCycleTracking.js";
+import type * as garmin_transform_moveIQ from "../garmin/transform/moveIQ.js";
+import type * as garmin_transform_plannedWorkout from "../garmin/transform/plannedWorkout.js";
+import type * as garmin_transform_pulseOx from "../garmin/transform/pulseOx.js";
+import type * as garmin_transform_respiration from "../garmin/transform/respiration.js";
+import type * as garmin_transform_skinTemperature from "../garmin/transform/skinTemperature.js";
+import type * as garmin_transform_sleeps from "../garmin/transform/sleeps.js";
+import type * as garmin_transform_stress from "../garmin/transform/stress.js";
+import type * as garmin_transform_userMetrics from "../garmin/transform/userMetrics.js";
+import type * as garmin_types_trainingApiWorkouts_client_index from "../garmin/types/trainingApiWorkouts/client/index.js";
+import type * as garmin_types_trainingApiWorkouts_index from "../garmin/types/trainingApiWorkouts/index.js";
+import type * as garmin_types_wellnessApi_client_index from "../garmin/types/wellnessApi/client/index.js";
+import type * as garmin_types_wellnessApi_index from "../garmin/types/wellnessApi/index.js";
+import type * as garmin_webhooks from "../garmin/webhooks.js";
 import type * as private_ from "../private.js";
 import type * as public_ from "../public.js";
-import type * as strava from "../strava.js";
+import type * as strava_private from "../strava/private.js";
+import type * as strava_public from "../strava/public.js";
 import type * as validators_activity from "../validators/activity.js";
 import type * as validators_athlete from "../validators/athlete.js";
 import type * as validators_body from "../validators/body.js";
@@ -34,10 +80,56 @@ import type {
 import { anyApi, componentsGeneric } from "convex/server";
 
 const fullApi: ApiFromModules<{
-  garmin: typeof garmin;
+  "garmin/auth": typeof garmin_auth;
+  "garmin/client": typeof garmin_client;
+  "garmin/private": typeof garmin_private;
+  "garmin/public": typeof garmin_public;
+  "garmin/schemas/activity": typeof garmin_schemas_activity;
+  "garmin/schemas/activityDetails": typeof garmin_schemas_activityDetails;
+  "garmin/schemas/bloodPressure": typeof garmin_schemas_bloodPressure;
+  "garmin/schemas/bodyCompositions": typeof garmin_schemas_bodyCompositions;
+  "garmin/schemas/dailies": typeof garmin_schemas_dailies;
+  "garmin/schemas/epochs": typeof garmin_schemas_epochs;
+  "garmin/schemas/healthSnapshot": typeof garmin_schemas_healthSnapshot;
+  "garmin/schemas/hrvSummary": typeof garmin_schemas_hrvSummary;
+  "garmin/schemas/manuallyUpdatedActivities": typeof garmin_schemas_manuallyUpdatedActivities;
+  "garmin/schemas/menstrualCycleTracking": typeof garmin_schemas_menstrualCycleTracking;
+  "garmin/schemas/moveIQ": typeof garmin_schemas_moveIQ;
+  "garmin/schemas/pulseOx": typeof garmin_schemas_pulseOx;
+  "garmin/schemas/respiration": typeof garmin_schemas_respiration;
+  "garmin/schemas/skinTemperature": typeof garmin_schemas_skinTemperature;
+  "garmin/schemas/sleeps": typeof garmin_schemas_sleeps;
+  "garmin/schemas/stress": typeof garmin_schemas_stress;
+  "garmin/schemas/userMetrics": typeof garmin_schemas_userMetrics;
+  "garmin/transform/activity": typeof garmin_transform_activity;
+  "garmin/transform/activityDetails": typeof garmin_transform_activityDetails;
+  "garmin/transform/bloodPressure": typeof garmin_transform_bloodPressure;
+  "garmin/transform/bodyCompositions": typeof garmin_transform_bodyCompositions;
+  "garmin/transform/dailies": typeof garmin_transform_dailies;
+  "garmin/transform/epochs": typeof garmin_transform_epochs;
+  "garmin/transform/healthSnapshot": typeof garmin_transform_healthSnapshot;
+  "garmin/transform/hrvSummary": typeof garmin_transform_hrvSummary;
+  "garmin/transform/manuallyUpdatedActivities": typeof garmin_transform_manuallyUpdatedActivities;
+  "garmin/transform/maps/activityType": typeof garmin_transform_maps_activityType;
+  "garmin/transform/maps/sleepLevel": typeof garmin_transform_maps_sleepLevel;
+  "garmin/transform/menstrualCycleTracking": typeof garmin_transform_menstrualCycleTracking;
+  "garmin/transform/moveIQ": typeof garmin_transform_moveIQ;
+  "garmin/transform/plannedWorkout": typeof garmin_transform_plannedWorkout;
+  "garmin/transform/pulseOx": typeof garmin_transform_pulseOx;
+  "garmin/transform/respiration": typeof garmin_transform_respiration;
+  "garmin/transform/skinTemperature": typeof garmin_transform_skinTemperature;
+  "garmin/transform/sleeps": typeof garmin_transform_sleeps;
+  "garmin/transform/stress": typeof garmin_transform_stress;
+  "garmin/transform/userMetrics": typeof garmin_transform_userMetrics;
+  "garmin/types/trainingApiWorkouts/client/index": typeof garmin_types_trainingApiWorkouts_client_index;
+  "garmin/types/trainingApiWorkouts/index": typeof garmin_types_trainingApiWorkouts_index;
+  "garmin/types/wellnessApi/client/index": typeof garmin_types_wellnessApi_client_index;
+  "garmin/types/wellnessApi/index": typeof garmin_types_wellnessApi_index;
+  "garmin/webhooks": typeof garmin_webhooks;
   private: typeof private_;
   public: typeof public_;
-  strava: typeof strava;
+  "strava/private": typeof strava_private;
+  "strava/public": typeof strava_public;
   "validators/activity": typeof validators_activity;
   "validators/athlete": typeof validators_athlete;
   "validators/body": typeof validators_body;