@nativesquare/soma 0.10.2 → 0.12.0

package/dist/client/garmin.d.ts

@@ -0,0 +1,287 @@
+import type { SomaComponent } from "./index.js";
+import type { ActionCtx, SomaGarminConfig } from "./types.js";
+export declare class SomaGarmin {
+    private component;
+    private requireConfig;
+    constructor(component: SomaComponent, requireConfig: () => SomaGarminConfig);
+    /**
+     * Generate a Garmin OAuth 2.0 authorization URL with PKCE.
+     *
+     * The state and code verifier are stored inside the component automatically,
+     * and the callback handler registered by `registerRoutes` completes
+     * the flow without further host-app intervention.
+     *
+     * @param ctx - Action context from the host app
+     * @param opts.userId - The host app's user identifier
+     * @param opts.redirectUri - Optional override for the OAuth callback URL
+     * @returns `{ authUrl, state }`
+     *
+     * @example
+     * ```ts
+     * const { authUrl } = await soma.garmin.getAuthUrl(ctx, {
+     *   userId: "user_123",
+     *   redirectUri: "https://your-app.convex.site/api/garmin/callback",
+     * });
+     * // Redirect user to authUrl — the callback is handled automatically
+     * ```
+     */
+    getAuthUrl(ctx: ActionCtx, opts: {
+        userId: string;
+        redirectUri?: string;
+    }): Promise<any>;
+    /**
+     * Disconnect a user from Garmin.
+     *
+     * Deregisters the user at Garmin (best-effort), deletes stored tokens,
+     * and sets the connection to inactive.
+     *
+     * @param ctx - Action context from the host app
+     * @param args.userId - The host app's user identifier
+     *
+     * @example
+     * ```ts
+     * await soma.garmin.disconnect(ctx, { userId: "user_123" });
+     * ```
+     */
+    disconnect(ctx: ActionCtx, args: {
+        userId: string;
+    }): Promise<any>;
+    /**
+     * Pull activity summaries from Garmin.
+     *
+     * Fetches activities, transforms them into the normalized Soma schema,
+     * and ingests them with automatic deduplication.
+     *
+     * @param ctx - Action context from the host app
+     * @param args.userId - The host app's user identifier
+     * @param args.startTimeInSeconds - Optional Unix epoch lower bound
+     * @param args.endTimeInSeconds - Optional Unix epoch upper bound
+     */
+    pullActivities(ctx: ActionCtx, args: {
+        userId: string;
+        startTimeInSeconds?: number;
+        endTimeInSeconds?: number;
+    }): Promise<any>;
+    /**
+     * Pull daily wellness summaries from Garmin.
+     *
+     * @param ctx - Action context from the host app
+     * @param args.userId - The host app's user identifier
+     * @param args.startTimeInSeconds - Optional Unix epoch lower bound
+     * @param args.endTimeInSeconds - Optional Unix epoch upper bound
+     */
+    pullDailies(ctx: ActionCtx, args: {
+        userId: string;
+        startTimeInSeconds?: number;
+        endTimeInSeconds?: number;
+    }): Promise<any>;
+    /**
+     * Pull sleep summaries from Garmin.
+     *
+     * @param ctx - Action context from the host app
+     * @param args.userId - The host app's user identifier
+     * @param args.startTimeInSeconds - Optional Unix epoch lower bound
+     * @param args.endTimeInSeconds - Optional Unix epoch upper bound
+     */
+    pullSleep(ctx: ActionCtx, args: {
+        userId: string;
+        startTimeInSeconds?: number;
+        endTimeInSeconds?: number;
+    }): Promise<any>;
+    /**
+     * Pull body composition data from Garmin.
+     *
+     * @param ctx - Action context from the host app
+     * @param args.userId - The host app's user identifier
+     * @param args.startTimeInSeconds - Optional Unix epoch lower bound
+     * @param args.endTimeInSeconds - Optional Unix epoch upper bound
+     */
+    pullBody(ctx: ActionCtx, args: {
+        userId: string;
+        startTimeInSeconds?: number;
+        endTimeInSeconds?: number;
+    }): Promise<any>;
+    /**
+     * Pull menstrual cycle tracking data from Garmin.
+     *
+     * @param ctx - Action context from the host app
+     * @param args.userId - The host app's user identifier
+     * @param args.startTimeInSeconds - Optional Unix epoch lower bound
+     * @param args.endTimeInSeconds - Optional Unix epoch upper bound
+     */
+    pullMenstruation(ctx: ActionCtx, args: {
+        userId: string;
+        startTimeInSeconds?: number;
+        endTimeInSeconds?: number;
+    }): Promise<any>;
+    /**
+     * Pull blood pressure readings from Garmin.
+     *
+     * @param ctx - Action context from the host app
+     * @param args.userId - The host app's user identifier
+     * @param args.startTimeInSeconds - Optional Unix epoch lower bound
+     * @param args.endTimeInSeconds - Optional Unix epoch upper bound
+     */
+    pullBloodPressures(ctx: ActionCtx, args: {
+        userId: string;
+        startTimeInSeconds?: number;
+        endTimeInSeconds?: number;
+    }): Promise<any>;
+    /**
+     * Pull skin temperature data from Garmin.
+     *
+     * @param ctx - Action context from the host app
+     * @param args.userId - The host app's user identifier
+     * @param args.startTimeInSeconds - Optional Unix epoch lower bound
+     * @param args.endTimeInSeconds - Optional Unix epoch upper bound
+     */
+    pullSkinTemperature(ctx: ActionCtx, args: {
+        userId: string;
+        startTimeInSeconds?: number;
+        endTimeInSeconds?: number;
+    }): Promise<any>;
+    /**
+     * Pull user metrics (VO2 max, fitness age, etc.) from Garmin.
+     *
+     * @param ctx - Action context from the host app
+     * @param args.userId - The host app's user identifier
+     * @param args.startTimeInSeconds - Optional Unix epoch lower bound
+     * @param args.endTimeInSeconds - Optional Unix epoch upper bound
+     */
+    pullUserMetrics(ctx: ActionCtx, args: {
+        userId: string;
+        startTimeInSeconds?: number;
+        endTimeInSeconds?: number;
+    }): Promise<any>;
+    /**
+     * Pull heart rate variability (HRV) summaries from Garmin.
+     *
+     * @param ctx - Action context from the host app
+     * @param args.userId - The host app's user identifier
+     * @param args.startTimeInSeconds - Optional Unix epoch lower bound
+     * @param args.endTimeInSeconds - Optional Unix epoch upper bound
+     */
+    pullHRV(ctx: ActionCtx, args: {
+        userId: string;
+        startTimeInSeconds?: number;
+        endTimeInSeconds?: number;
+    }): Promise<any>;
+    /**
+     * Pull stress detail data from Garmin.
+     *
+     * @param ctx - Action context from the host app
+     * @param args.userId - The host app's user identifier
+     * @param args.startTimeInSeconds - Optional Unix epoch lower bound
+     * @param args.endTimeInSeconds - Optional Unix epoch upper bound
+     */
+    pullStressDetails(ctx: ActionCtx, args: {
+        userId: string;
+        startTimeInSeconds?: number;
+        endTimeInSeconds?: number;
+    }): Promise<any>;
+    /**
+     * Pull pulse oximetry (SpO2) data from Garmin.
+     *
+     * @param ctx - Action context from the host app
+     * @param args.userId - The host app's user identifier
+     * @param args.startTimeInSeconds - Optional Unix epoch lower bound
+     * @param args.endTimeInSeconds - Optional Unix epoch upper bound
+     */
+    pullPulseOx(ctx: ActionCtx, args: {
+        userId: string;
+        startTimeInSeconds?: number;
+        endTimeInSeconds?: number;
+    }): Promise<any>;
+    /**
+     * Pull respiration (breathing rate) data from Garmin.
+     *
+     * @param ctx - Action context from the host app
+     * @param args.userId - The host app's user identifier
+     * @param args.startTimeInSeconds - Optional Unix epoch lower bound
+     * @param args.endTimeInSeconds - Optional Unix epoch upper bound
+     */
+    pullRespiration(ctx: ActionCtx, args: {
+        userId: string;
+        startTimeInSeconds?: number;
+        endTimeInSeconds?: number;
+    }): Promise<any>;
+    /**
+     * Pull all supported data types from Garmin in a single call.
+     *
+     * Equivalent to calling every individual `pull*` method. Automatically
+     * refreshes the access token if expired.
+     *
+     * @param ctx - Action context from the host app
+     * @param args.userId - The host app's user identifier
+     * @param args.startTimeInSeconds - Optional Unix epoch lower bound
+     * @param args.endTimeInSeconds - Optional Unix epoch upper bound
+     *
+     * @example
+     * ```ts
+     * await soma.garmin.pullAll(ctx, { userId: "user_123" });
+     * ```
+     */
+    pullAll(ctx: ActionCtx, args: {
+        userId: string;
+        startTimeInSeconds?: number;
+        endTimeInSeconds?: number;
+    }): Promise<any>;
+    /**
+     * Push a planned workout to Garmin Connect.
+     *
+     * Creates the workout on the user's Garmin account from a planned
+     * workout stored in Soma.
+     *
+     * @param ctx - Action context from the host app
+     * @param args.userId - The host app's user identifier
+     * @param args.plannedWorkoutId - The Soma planned workout document ID
+     * @param args.workoutProvider - Optional provider identifier for the workout source
+     */
+    pushWorkout(ctx: ActionCtx, args: {
+        userId: string;
+        plannedWorkoutId: string;
+        workoutProvider?: string;
+    }): Promise<any>;
+    /**
+     * Schedule a planned workout on the user's Garmin calendar.
+     *
+     * The workout must already exist on Garmin (via `pushWorkout`).
+     *
+     * @param ctx - Action context from the host app
+     * @param args.userId - The host app's user identifier
+     * @param args.plannedWorkoutId - The Soma planned workout document ID
+     * @param args.date - Optional target date (YYYY-MM-DD); defaults to the workout's planned_date
+     */
+    pushSchedule(ctx: ActionCtx, args: {
+        userId: string;
+        plannedWorkoutId: string;
+        date?: string;
+    }): Promise<any>;
+    /**
+     * Delete a planned workout from Garmin Connect.
+     *
+     * Removes the workout from the user's Garmin account.
+     *
+     * @param ctx - Action context from the host app
+     * @param args.userId - The host app's user identifier
+     * @param args.plannedWorkoutId - The Soma planned workout document ID
+     */
+    deleteWorkout(ctx: ActionCtx, args: {
+        userId: string;
+        plannedWorkoutId: string;
+    }): Promise<any>;
+    /**
+     * Remove a scheduled workout from the user's Garmin calendar.
+     *
+     * Unschedules the workout without deleting the workout itself.
+     *
+     * @param ctx - Action context from the host app
+     * @param args.userId - The host app's user identifier
+     * @param args.plannedWorkoutId - The Soma planned workout document ID
+     */
+    deleteSchedule(ctx: ActionCtx, args: {
+        userId: string;
+        plannedWorkoutId: string;
+    }): Promise<any>;
+}
+//# sourceMappingURL=garmin.d.ts.map

package/dist/client/garmin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"garmin.d.ts","sourceRoot":"","sources":["../../src/client/garmin.ts"],"names":[],"mappings":"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"}

package/dist/client/garmin.js

@@ -0,0 +1,345 @@
+export class SomaGarmin {
+    component;
+    requireConfig;
+    constructor(component, requireConfig) {
+        this.component = component;
+        this.requireConfig = requireConfig;
+    }
+    /**
+     * Generate a Garmin OAuth 2.0 authorization URL with PKCE.
+     *
+     * The state and code verifier are stored inside the component automatically,
+     * and the callback handler registered by `registerRoutes` completes
+     * the flow without further host-app intervention.
+     *
+     * @param ctx - Action context from the host app
+     * @param opts.userId - The host app's user identifier
+     * @param opts.redirectUri - Optional override for the OAuth callback URL
+     * @returns `{ authUrl, state }`
+     *
+     * @example
+     * ```ts
+     * const { authUrl } = await soma.garmin.getAuthUrl(ctx, {
+     *   userId: "user_123",
+     *   redirectUri: "https://your-app.convex.site/api/garmin/callback",
+     * });
+     * // Redirect user to authUrl — the callback is handled automatically
+     * ```
+     */
+    async getAuthUrl(ctx, opts) {
+        const config = this.requireConfig();
+        return await ctx.runAction(this.component.garmin.public.getGarminAuthUrl, {
+            clientId: config.clientId,
+            redirectUri: opts.redirectUri,
+            userId: opts.userId,
+        });
+    }
+    /**
+     * Disconnect a user from Garmin.
+     *
+     * Deregisters the user at Garmin (best-effort), deletes stored tokens,
+     * and sets the connection to inactive.
+     *
+     * @param ctx - Action context from the host app
+     * @param args.userId - The host app's user identifier
+     *
+     * @example
+     * ```ts
+     * await soma.garmin.disconnect(ctx, { userId: "user_123" });
+     * ```
+     */
+    async disconnect(ctx, args) {
+        return await ctx.runAction(this.component.garmin.public.disconnectGarmin, args);
+    }
+    /**
+     * Pull activity summaries from Garmin.
+     *
+     * Fetches activities, transforms them into the normalized Soma schema,
+     * and ingests them with automatic deduplication.
+     *
+     * @param ctx - Action context from the host app
+     * @param args.userId - The host app's user identifier
+     * @param args.startTimeInSeconds - Optional Unix epoch lower bound
+     * @param args.endTimeInSeconds - Optional Unix epoch upper bound
+     */
+    async pullActivities(ctx, args) {
+        const config = this.requireConfig();
+        return await ctx.runAction(this.component.garmin.public.pullActivities, {
+            ...args,
+            clientId: config.clientId,
+            clientSecret: config.clientSecret,
+        });
+    }
+    /**
+     * Pull daily wellness summaries from Garmin.
+     *
+     * @param ctx - Action context from the host app
+     * @param args.userId - The host app's user identifier
+     * @param args.startTimeInSeconds - Optional Unix epoch lower bound
+     * @param args.endTimeInSeconds - Optional Unix epoch upper bound
+     */
+    async pullDailies(ctx, args) {
+        const config = this.requireConfig();
+        return await ctx.runAction(this.component.garmin.public.pullDailies, {
+            ...args,
+            clientId: config.clientId,
+            clientSecret: config.clientSecret,
+        });
+    }
+    /**
+     * Pull sleep summaries from Garmin.
+     *
+     * @param ctx - Action context from the host app
+     * @param args.userId - The host app's user identifier
+     * @param args.startTimeInSeconds - Optional Unix epoch lower bound
+     * @param args.endTimeInSeconds - Optional Unix epoch upper bound
+     */
+    async pullSleep(ctx, args) {
+        const config = this.requireConfig();
+        return await ctx.runAction(this.component.garmin.public.pullSleep, {
+            ...args,
+            clientId: config.clientId,
+            clientSecret: config.clientSecret,
+        });
+    }
+    /**
+     * Pull body composition data from Garmin.
+     *
+     * @param ctx - Action context from the host app
+     * @param args.userId - The host app's user identifier
+     * @param args.startTimeInSeconds - Optional Unix epoch lower bound
+     * @param args.endTimeInSeconds - Optional Unix epoch upper bound
+     */
+    async pullBody(ctx, args) {
+        const config = this.requireConfig();
+        return await ctx.runAction(this.component.garmin.public.pullBody, {
+            ...args,
+            clientId: config.clientId,
+            clientSecret: config.clientSecret,
+        });
+    }
+    /**
+     * Pull menstrual cycle tracking data from Garmin.
+     *
+     * @param ctx - Action context from the host app
+     * @param args.userId - The host app's user identifier
+     * @param args.startTimeInSeconds - Optional Unix epoch lower bound
+     * @param args.endTimeInSeconds - Optional Unix epoch upper bound
+     */
+    async pullMenstruation(ctx, args) {
+        const config = this.requireConfig();
+        return await ctx.runAction(this.component.garmin.public.pullMenstruation, {
+            ...args,
+            clientId: config.clientId,
+            clientSecret: config.clientSecret,
+        });
+    }
+    /**
+     * Pull blood pressure readings from Garmin.
+     *
+     * @param ctx - Action context from the host app
+     * @param args.userId - The host app's user identifier
+     * @param args.startTimeInSeconds - Optional Unix epoch lower bound
+     * @param args.endTimeInSeconds - Optional Unix epoch upper bound
+     */
+    async pullBloodPressures(ctx, args) {
+        const config = this.requireConfig();
+        return await ctx.runAction(this.component.garmin.public.pullBloodPressures, {
+            ...args,
+            clientId: config.clientId,
+            clientSecret: config.clientSecret,
+        });
+    }
+    /**
+     * Pull skin temperature data from Garmin.
+     *
+     * @param ctx - Action context from the host app
+     * @param args.userId - The host app's user identifier
+     * @param args.startTimeInSeconds - Optional Unix epoch lower bound
+     * @param args.endTimeInSeconds - Optional Unix epoch upper bound
+     */
+    async pullSkinTemperature(ctx, args) {
+        const config = this.requireConfig();
+        return await ctx.runAction(this.component.garmin.public.pullSkinTemperature, {
+            ...args,
+            clientId: config.clientId,
+            clientSecret: config.clientSecret,
+        });
+    }
+    /**
+     * Pull user metrics (VO2 max, fitness age, etc.) from Garmin.
+     *
+     * @param ctx - Action context from the host app
+     * @param args.userId - The host app's user identifier
+     * @param args.startTimeInSeconds - Optional Unix epoch lower bound
+     * @param args.endTimeInSeconds - Optional Unix epoch upper bound
+     */
+    async pullUserMetrics(ctx, args) {
+        const config = this.requireConfig();
+        return await ctx.runAction(this.component.garmin.public.pullUserMetrics, {
+            ...args,
+            clientId: config.clientId,
+            clientSecret: config.clientSecret,
+        });
+    }
+    /**
+     * Pull heart rate variability (HRV) summaries from Garmin.
+     *
+     * @param ctx - Action context from the host app
+     * @param args.userId - The host app's user identifier
+     * @param args.startTimeInSeconds - Optional Unix epoch lower bound
+     * @param args.endTimeInSeconds - Optional Unix epoch upper bound
+     */
+    async pullHRV(ctx, args) {
+        const config = this.requireConfig();
+        return await ctx.runAction(this.component.garmin.public.pullHRV, {
+            ...args,
+            clientId: config.clientId,
+            clientSecret: config.clientSecret,
+        });
+    }
+    /**
+     * Pull stress detail data from Garmin.
+     *
+     * @param ctx - Action context from the host app
+     * @param args.userId - The host app's user identifier
+     * @param args.startTimeInSeconds - Optional Unix epoch lower bound
+     * @param args.endTimeInSeconds - Optional Unix epoch upper bound
+     */
+    async pullStressDetails(ctx, args) {
+        const config = this.requireConfig();
+        return await ctx.runAction(this.component.garmin.public.pullStressDetails, {
+            ...args,
+            clientId: config.clientId,
+            clientSecret: config.clientSecret,
+        });
+    }
+    /**
+     * Pull pulse oximetry (SpO2) data from Garmin.
+     *
+     * @param ctx - Action context from the host app
+     * @param args.userId - The host app's user identifier
+     * @param args.startTimeInSeconds - Optional Unix epoch lower bound
+     * @param args.endTimeInSeconds - Optional Unix epoch upper bound
+     */
+    async pullPulseOx(ctx, args) {
+        const config = this.requireConfig();
+        return await ctx.runAction(this.component.garmin.public.pullPulseOx, {
+            ...args,
+            clientId: config.clientId,
+            clientSecret: config.clientSecret,
+        });
+    }
+    /**
+     * Pull respiration (breathing rate) data from Garmin.
+     *
+     * @param ctx - Action context from the host app
+     * @param args.userId - The host app's user identifier
+     * @param args.startTimeInSeconds - Optional Unix epoch lower bound
+     * @param args.endTimeInSeconds - Optional Unix epoch upper bound
+     */
+    async pullRespiration(ctx, args) {
+        const config = this.requireConfig();
+        return await ctx.runAction(this.component.garmin.public.pullRespiration, {
+            ...args,
+            clientId: config.clientId,
+            clientSecret: config.clientSecret,
+        });
+    }
+    /**
+     * Pull all supported data types from Garmin in a single call.
+     *
+     * Equivalent to calling every individual `pull*` method. Automatically
+     * refreshes the access token if expired.
+     *
+     * @param ctx - Action context from the host app
+     * @param args.userId - The host app's user identifier
+     * @param args.startTimeInSeconds - Optional Unix epoch lower bound
+     * @param args.endTimeInSeconds - Optional Unix epoch upper bound
+     *
+     * @example
+     * ```ts
+     * await soma.garmin.pullAll(ctx, { userId: "user_123" });
+     * ```
+     */
+    async pullAll(ctx, args) {
+        const config = this.requireConfig();
+        return await ctx.runAction(this.component.garmin.public.pullAll, {
+            ...args,
+            clientId: config.clientId,
+            clientSecret: config.clientSecret,
+        });
+    }
+    /**
+     * Push a planned workout to Garmin Connect.
+     *
+     * Creates the workout on the user's Garmin account from a planned
+     * workout stored in Soma.
+     *
+     * @param ctx - Action context from the host app
+     * @param args.userId - The host app's user identifier
+     * @param args.plannedWorkoutId - The Soma planned workout document ID
+     * @param args.workoutProvider - Optional provider identifier for the workout source
+     */
+    async pushWorkout(ctx, args) {
+        const config = this.requireConfig();
+        return await ctx.runAction(this.component.garmin.public.pushWorkout, {
+            ...args,
+            clientId: config.clientId,
+            clientSecret: config.clientSecret,
+        });
+    }
+    /**
+     * Schedule a planned workout on the user's Garmin calendar.
+     *
+     * The workout must already exist on Garmin (via `pushWorkout`).
+     *
+     * @param ctx - Action context from the host app
+     * @param args.userId - The host app's user identifier
+     * @param args.plannedWorkoutId - The Soma planned workout document ID
+     * @param args.date - Optional target date (YYYY-MM-DD); defaults to the workout's planned_date
+     */
+    async pushSchedule(ctx, args) {
+        const config = this.requireConfig();
+        return await ctx.runAction(this.component.garmin.public.pushSchedule, {
+            ...args,
+            clientId: config.clientId,
+            clientSecret: config.clientSecret,
+        });
+    }
+    /**
+     * Delete a planned workout from Garmin Connect.
+     *
+     * Removes the workout from the user's Garmin account.
+     *
+     * @param ctx - Action context from the host app
+     * @param args.userId - The host app's user identifier
+     * @param args.plannedWorkoutId - The Soma planned workout document ID
+     */
+    async deleteWorkout(ctx, args) {
+        const config = this.requireConfig();
+        return await ctx.runAction(this.component.garmin.public.deleteWorkout, {
+            ...args,
+            clientId: config.clientId,
+            clientSecret: config.clientSecret,
+        });
+    }
+    /**
+     * Remove a scheduled workout from the user's Garmin calendar.
+     *
+     * Unschedules the workout without deleting the workout itself.
+     *
+     * @param ctx - Action context from the host app
+     * @param args.userId - The host app's user identifier
+     * @param args.plannedWorkoutId - The Soma planned workout document ID
+     */
+    async deleteSchedule(ctx, args) {
+        const config = this.requireConfig();
+        return await ctx.runAction(this.component.garmin.public.deleteSchedule, {
+            ...args,
+            clientId: config.clientId,
+            clientSecret: config.clientSecret,
+        });
+    }
+}
+//# sourceMappingURL=garmin.js.map

package/dist/client/garmin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"garmin.js","sourceRoot":"","sources":["../../src/client/garmin.ts"],"names":[],"mappings":"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"}