@nativesquare/soma 0.10.0 → 0.10.2

package/dist/component/garmin/public.d.ts

@@ -2,17 +2,13 @@ import type { Id } from "../_generated/dataModel";
 /**
  * Generate a Garmin OAuth 2.0 authorization URL with PKCE.
  *
- * If `userId` is provided, the PKCE code verifier and state are stored in the
- * component's `pendingOAuth` table so that `completeGarminOAuth` can look
- * them up automatically when the callback fires. This is the recommended
- * flow when using `registerRoutes`.
- *
- * If `userId` is omitted, the host app must store the returned `codeVerifier`
- * itself and pass it to `connectGarmin` manually.
+ * The PKCE code verifier and state are stored in the component's
+ * `pendingOAuth` table so that `completeGarminOAuth` can look them up
+ * automatically when the callback fires via `registerRoutes`.
  */
 export declare const getGarminAuthUrl: import("convex/server").RegisteredAction<"public", {
-    userId?: string | undefined;
     redirectUri?: string | undefined;
+    userId: string;
     clientId: string;
 }, Promise<{
     authUrl: string;
@@ -20,52 +16,240 @@ export declare const getGarminAuthUrl: import("convex/server").RegisteredAction<
     codeVerifier: string;
 }>>;
 /**
- * Exchange an authorization code for tokens + initial sync.
+ * Complete a Garmin OAuth 2.0 flow using stored pending state.
  *
- * Used in the manual flow where the host app stores the code verifier
- * and handles the callback itself.
+ * Called internally by `registerRoutes` — the callback handler calls
+ * this with the `code` and `state` from the redirect. The action looks
+ * up the pending state (codeVerifier, userId) stored during
+ * `getGarminAuthUrl`, exchanges for tokens, creates the connection,
+ * stores tokens, and cleans up the pending entry.
+ *
+ * The host app is responsible for calling `syncGarmin` afterwards.
  */
-export declare const connectGarmin: import("convex/server").RegisteredAction<"public", {
+export declare const completeGarminOAuth: import("convex/server").RegisteredAction<"public", {
     redirectUri?: string | undefined;
-    userId: string;
+    state: string;
     clientId: string;
     clientSecret: string;
     code: string;
-    codeVerifier: string;
 }, Promise<{
     connectionId: Id<"connections">;
     userId: string;
-    synced: Record<string, number>;
-    errors: Array<{
-        type: string;
-        id: string;
-        error: string;
-    }>;
 }>>;
 /**
- * Complete a Garmin OAuth 2.0 flow using stored pending state.
+ * Disconnect a user from Garmin.
  *
- * Used by `registerRoutes` — the callback handler calls this with the
- * `code` and `state` from the redirect. The action looks up the pending
- * state (codeVerifier, userId) stored during `getGarminAuthUrl`,
- * exchanges for tokens, creates the connection, syncs data, and
- * cleans up the pending entry.
+ * Deregisters the user via the Garmin API (best-effort), deletes stored
+ * tokens, and sets the connection to inactive.
  */
-export declare const completeGarminOAuth: import("convex/server").RegisteredAction<"public", {
-    redirectUri?: string | undefined;
-    state: string;
+export declare const disconnectGarmin: import("convex/server").RegisteredAction<"public", {
+    userId: string;
+}, Promise<null>>;
+export declare const pullActivities: import("convex/server").RegisteredAction<"public", {
+    endTimeInSeconds?: number | undefined;
+    startTimeInSeconds?: number | undefined;
+    userId: string;
     clientId: string;
     clientSecret: string;
-    code: string;
 }, Promise<{
-    connectionId: Id<"connections">;
+    synced: {
+        activities: number;
+    };
+    errors: {
+        type: "activity";
+        id: string;
+        error: string;
+    }[];
+}>>;
+export declare const pullDailies: import("convex/server").RegisteredAction<"public", {
+    endTimeInSeconds?: number | undefined;
+    startTimeInSeconds?: number | undefined;
+    userId: string;
+    clientId: string;
+    clientSecret: string;
+}, Promise<{
+    synced: {
+        dailies: number;
+    };
+    errors: {
+        type: string;
+        id: string;
+        error: string;
+    }[];
+}>>;
+export declare const pullSleep: import("convex/server").RegisteredAction<"public", {
+    endTimeInSeconds?: number | undefined;
+    startTimeInSeconds?: number | undefined;
+    userId: string;
+    clientId: string;
+    clientSecret: string;
+}, Promise<{
+    synced: {
+        sleep: number;
+    };
+    errors: {
+        type: string;
+        id: string;
+        error: string;
+    }[];
+}>>;
+export declare const pullBody: import("convex/server").RegisteredAction<"public", {
+    endTimeInSeconds?: number | undefined;
+    startTimeInSeconds?: number | undefined;
+    userId: string;
+    clientId: string;
+    clientSecret: string;
+}, Promise<{
+    synced: {
+        body: number;
+    };
+    errors: {
+        type: string;
+        id: string;
+        error: string;
+    }[];
+}>>;
+export declare const pullMenstruation: import("convex/server").RegisteredAction<"public", {
+    endTimeInSeconds?: number | undefined;
+    startTimeInSeconds?: number | undefined;
+    userId: string;
+    clientId: string;
+    clientSecret: string;
+}, Promise<{
+    synced: {
+        menstruation: number;
+    };
+    errors: {
+        type: string;
+        id: string;
+        error: string;
+    }[];
+}>>;
+export declare const pullBloodPressures: import("convex/server").RegisteredAction<"public", {
+    endTimeInSeconds?: number | undefined;
+    startTimeInSeconds?: number | undefined;
+    userId: string;
+    clientId: string;
+    clientSecret: string;
+}, Promise<{
+    synced: {
+        bloodPressures: number;
+    };
+    errors: {
+        type: string;
+        id: string;
+        error: string;
+    }[];
+}>>;
+export declare const pullSkinTemperature: import("convex/server").RegisteredAction<"public", {
+    endTimeInSeconds?: number | undefined;
+    startTimeInSeconds?: number | undefined;
+    userId: string;
+    clientId: string;
+    clientSecret: string;
+}, Promise<{
+    synced: {
+        skinTemp: number;
+    };
+    errors: {
+        type: string;
+        id: string;
+        error: string;
+    }[];
+}>>;
+export declare const pullUserMetrics: import("convex/server").RegisteredAction<"public", {
+    endTimeInSeconds?: number | undefined;
+    startTimeInSeconds?: number | undefined;
     userId: string;
+    clientId: string;
+    clientSecret: string;
+}, Promise<{
+    synced: {
+        userMetrics: number;
+    };
+    errors: {
+        type: string;
+        id: string;
+        error: string;
+    }[];
+}>>;
+export declare const pullHRV: import("convex/server").RegisteredAction<"public", {
+    endTimeInSeconds?: number | undefined;
+    startTimeInSeconds?: number | undefined;
+    userId: string;
+    clientId: string;
+    clientSecret: string;
+}, Promise<{
+    synced: {
+        hrv: number;
+    };
+    errors: {
+        type: string;
+        id: string;
+        error: string;
+    }[];
+}>>;
+export declare const pullStressDetails: import("convex/server").RegisteredAction<"public", {
+    endTimeInSeconds?: number | undefined;
+    startTimeInSeconds?: number | undefined;
+    userId: string;
+    clientId: string;
+    clientSecret: string;
+}, Promise<{
+    synced: {
+        stressDetails: number;
+    };
+    errors: {
+        type: string;
+        id: string;
+        error: string;
+    }[];
+}>>;
+export declare const pullPulseOx: import("convex/server").RegisteredAction<"public", {
+    endTimeInSeconds?: number | undefined;
+    startTimeInSeconds?: number | undefined;
+    userId: string;
+    clientId: string;
+    clientSecret: string;
+}, Promise<{
+    synced: {
+        pulseOx: number;
+    };
+    errors: {
+        type: string;
+        id: string;
+        error: string;
+    }[];
+}>>;
+export declare const pullRespiration: import("convex/server").RegisteredAction<"public", {
+    endTimeInSeconds?: number | undefined;
+    startTimeInSeconds?: number | undefined;
+    userId: string;
+    clientId: string;
+    clientSecret: string;
+}, Promise<{
+    synced: {
+        respiration: number;
+    };
+    errors: {
+        type: string;
+        id: string;
+        error: string;
+    }[];
+}>>;
+export declare const pullAll: import("convex/server").RegisteredAction<"public", {
+    endTimeInSeconds?: number | undefined;
+    startTimeInSeconds?: number | undefined;
+    userId: string;
+    clientId: string;
+    clientSecret: string;
+}, Promise<{
     synced: Record<string, number>;
-    errors: Array<{
+    errors: {
         type: string;
         id: string;
         error: string;
-    }>;
+    }[];
 }>>;
 /**
  * Incremental Garmin sync for an already-connected user.
@@ -87,38 +271,10 @@ export declare const syncGarmin: import("convex/server").RegisteredAction<"publi
         error: string;
     }>;
 }>>;
-/**
- * Disconnect a user from Garmin.
- *
- * Deregisters the user via the Garmin API (best-effort), deletes stored
- * tokens, and sets the connection to inactive.
- */
-export declare const disconnectGarmin: import("convex/server").RegisteredAction<"public", {
-    userId: string;
-}, Promise<null>>;
-/**
- * Push a planned workout from Soma's DB to Garmin Connect.
- *
- * Reads the planned workout document, transforms it to Garmin Training API V2
- * format, creates the workout at Garmin, and optionally schedules it if a
- * `planned_date` is set in the metadata.
- *
- * Returns the Garmin workout ID and schedule ID (if scheduled).
- */
-export declare const pushPlannedWorkout: import("convex/server").RegisteredAction<"public", {
-    workoutProvider?: string | undefined;
-    userId: string;
-    clientId: string;
-    clientSecret: string;
-    plannedWorkoutId: string;
-}, Promise<{
-    garminWorkoutId: number;
-    garminScheduleId: number | null;
-}>>;
 /**
  * Fetch and ingest all Garmin wellness data types for a time range.
  *
- * Called by the public actions (connectGarmin, completeGarminOAuth, syncGarmin)
+ * Called by syncGarmin after obtaining a valid access token.
  * after obtaining a valid access token.
  */
 export declare const syncAllTypes: import("convex/server").RegisteredAction<"public", {
@@ -148,4 +304,23 @@ export declare const syncAllTypes: import("convex/server").RegisteredAction<"pub
         error: string;
     }[];
 }>>;
+/**
+ * Push a planned workout from Soma's DB to Garmin Connect.
+ *
+ * Reads the planned workout document, transforms it to Garmin Training API V2
+ * format, creates the workout at Garmin, and optionally schedules it if a
+ * `planned_date` is set in the metadata.
+ *
+ * Returns the Garmin workout ID and schedule ID (if scheduled).
+ */
+export declare const pushPlannedWorkout: import("convex/server").RegisteredAction<"public", {
+    workoutProvider?: string | undefined;
+    userId: string;
+    clientId: string;
+    clientSecret: string;
+    plannedWorkoutId: string;
+}, Promise<{
+    garminWorkoutId: number;
+    garminScheduleId: number | null;
+}>>;
 //# sourceMappingURL=public.d.ts.map

package/dist/component/garmin/public.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../../src/component/garmin/public.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAO,EAAE,EAAE,MAAM,yBAAyB,CAAC;AAyDvD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;GA6B3B,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,aAAa;;;;;;;;kBAUR,EAAE,CAAC,aAAa,CAAC;YACvB,MAAM;YACN,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;YACtB,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;GA6D5D,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB;;;;;;;kBASd,EAAE,CAAC,aAAa,CAAC;YACvB,MAAM;YACN,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;YACtB,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;GAkF5D,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,UAAU;;;;;;;YASX,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;YACtB,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;GA0F5D,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB;;iBAuC3B,CAAC;AAIH;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB;;;;;;;qBAQ0B,MAAM;sBAAoB,MAAM,GAAG,IAAI;GA6H9F,CAAC;AAIH;;;;;GAKG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;cAsBO,MAAM;YAAM,MAAM;eAAS,MAAM;;GAmU/D,CAAC"}
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../../src/component/garmin/public.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAO,EAAE,EAAE,MAAM,yBAAyB,CAAC;AAyDvD;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;GA2B3B,CAAC;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB;;;;;;;kBASd,EAAE,CAAC,aAAa,CAAC;YACvB,MAAM;GA4DhB,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB;;iBAuC3B,CAAC;AAIH,eAAO,MAAM,cAAc;;;;;;;;;;;cAuBK,UAAU;YAAM,MAAM;eAAS,MAAM;;GA4CnE,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;;;;;;;cAiBQ,MAAM;YAAM,MAAM;eAAS,MAAM;;GAsB/D,CAAC;AAEH,eAAO,MAAM,SAAS;;;;;;;;;;;cAiBU,MAAM;YAAM,MAAM;eAAS,MAAM;;GAqB/D,CAAC;AAEH,eAAO,MAAM,QAAQ;;;;;;;;;;;cAiBW,MAAM;YAAM,MAAM;eAAS,MAAM;;GAsB/D,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;cAiBG,MAAM;YAAM,MAAM;eAAS,MAAM;;GAqB/D,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;cAiBC,MAAM;YAAM,MAAM;eAAS,MAAM;;GAsB/D,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;cAiBA,MAAM;YAAM,MAAM;eAAS,MAAM;;GAsB/D,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;cAiBI,MAAM;YAAM,MAAM;eAAS,MAAM;;GAsB/D,CAAC;AAEH,eAAO,MAAM,OAAO;;;;;;;;;;;cAiBY,MAAM;YAAM,MAAM;eAAS,MAAM;;GAsB/D,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;cAiBE,MAAM;YAAM,MAAM;eAAS,MAAM;;GAsB/D,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;;;;;;;cAiBQ,MAAM;YAAM,MAAM;eAAS,MAAM;;GAsB/D,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;cAiBI,MAAM;YAAM,MAAM;eAAS,MAAM;;GAsB/D,CAAC;AAEH,eAAO,MAAM,OAAO;;;;;;;;;cA+BY,MAAM;YAAM,MAAM;eAAS,MAAM;;GAgB/D,CAAC;AACH;;;;;GAKG;AAEH,eAAO,MAAM,UAAU;;;;;;;YASX,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;YACtB,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;GA0F5D,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;cAsBO,MAAM;YAAM,MAAM;eAAS,MAAM;;GAmU/D,CAAC;AAIH;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB;;;;;;;qBAQ0B,MAAM;sBAAoB,MAAM,GAAG,IAAI;GA6H9F,CAAC"}