@nativesquare/soma 0.8.0 → 0.9.1

package/src/component/validators/activity.ts

@@ -1,3 +1,4 @@
+import type { Infer } from "convex/values";
 import { v } from "convex/values";
 import {
   calorieSample,
@@ -214,3 +215,7 @@ export const activityValidator = {
     }),
   ),
 };
+
+/** Data-only shape (no connectionId / userId). */
+type ActivityData = Omit<typeof activityValidator, "connectionId" | "userId">;
+export type SomaActivity = Infer<ReturnType<typeof v.object<ActivityData>>>;

package/src/component/validators/body.ts

@@ -1,3 +1,4 @@
+import type { Infer } from "convex/values";
 import { v } from "convex/values";
 import {
   bloodPressureSample,
@@ -112,3 +113,7 @@ export const bodyValidator = {
     }),
   ),
 };
+
+/** Data-only shape (no connectionId / userId). */
+type BodyData = Omit<typeof bodyValidator, "connectionId" | "userId">;
+export type SomaBody = Infer<ReturnType<typeof v.object<BodyData>>>;

package/src/component/validators/daily.ts

@@ -1,3 +1,4 @@
+import type { Infer } from "convex/values";
 import { v } from "convex/values";
 import {
   activityLevelSample,
@@ -186,3 +187,7 @@ export const dailyValidator = {
     }),
   ),
 };
+
+/** Data-only shape (no connectionId / userId). */
+type DailyData = Omit<typeof dailyValidator, "connectionId" | "userId">;
+export type SomaDaily = Infer<ReturnType<typeof v.object<DailyData>>>;

package/src/component/validators/menstruation.ts

@@ -1,4 +1,4 @@
-import { v } from "convex/values";
+import { type Infer, v } from "convex/values";
 import { menstruationFlowSample } from "./samples.js";
 
 // ─── Menstruation ────────────────────────────────────────────────────────────
@@ -34,3 +34,7 @@ export const menstruationValidator = {
     }),
   ),
 };
+
+/** Data-only shape (no connectionId / userId). */
+type MenstruationData = Omit<typeof menstruationValidator, "connectionId" | "userId">;
+export type SomaMenstruation = Infer<ReturnType<typeof v.object<MenstruationData>>>;

package/src/component/validators/plannedWorkout.ts

@@ -1,3 +1,4 @@
+import type { Infer } from "convex/values";
 import { v } from "convex/values";
 
 // ─── PlannedWorkoutStepTarget ────────────────────────────────────────────────
@@ -112,3 +113,7 @@ export const plannedWorkoutValidator = {
     provider_schedule_id: v.optional(v.string()),
   }),
 };
+
+/** Data-only shape (no connectionId / userId). */
+type PlannedWorkoutData = Omit<typeof plannedWorkoutValidator, "connectionId" | "userId">;
+export type SomaPlannedWorkout = Infer<ReturnType<typeof v.object<PlannedWorkoutData>>>;

package/src/validators.ts

@@ -41,8 +41,14 @@
 import { v } from "convex/values";
 import { connectionValidator as _connectionValidator } from "./component/validators/connection.js";
 import { athleteValidator as _athleteValidator } from "./component/validators/athlete.js";
-import { activityValidator as _activityValidator } from "./component/validators/activity.js";
-import { bodyValidator as _bodyValidator } from "./component/validators/body.js";
+import {
+  activityValidator as _activityValidator,
+  type SomaActivity,
+} from "./component/validators/activity.js";
+import {
+  bodyValidator as _bodyValidator,
+  type SomaBody,
+} from "./component/validators/body.js";
 import { dailyValidator as _dailyValidator } from "./component/validators/daily.js";
 import { sleepValidator as _sleepValidator } from "./component/validators/sleep.js";
 import { menstruationValidator as _menstruationValidator } from "./component/validators/menstruation.js";
@@ -87,3 +93,7 @@ export const sleepData = stripConnection(_sleepValidator);
 export const menstruationData = stripConnection(_menstruationValidator);
 export const nutritionData = stripConnection(_nutritionValidator);
 export const plannedWorkoutData = stripConnection(_plannedWorkoutValidator);
+
+// ─── Soma types ─────────────────────────────────────────────────────────────
+
+export type { SomaActivity, SomaBody };

package/dist/component/garmin.d.ts

@@ -1,366 +0,0 @@
-export declare const storePendingOAuth: import("convex/server").RegisteredMutation<"internal", {
-    userId: string;
-    provider: string;
-    state: string;
-    codeVerifier: string;
-}, Promise<null>>;
-export declare const getPendingOAuth: import("convex/server").RegisteredQuery<"internal", {
-    state: string;
-}, Promise<{
-    _id: import("convex/values").GenericId<"pendingOAuth">;
-    _creationTime: number;
-    userId: string;
-    provider: string;
-    state: string;
-    codeVerifier: string;
-    createdAt: number;
-} | null>>;
-export declare const deletePendingOAuth: import("convex/server").RegisteredMutation<"internal", {
-    state: string;
-}, Promise<null>>;
-/**
- * Store OAuth 2.0 tokens for a Garmin connection.
- * Upserts by connectionId — one token record per connection.
- */
-export declare const storeTokens: import("convex/server").RegisteredMutation<"internal", {
-    connectionId: import("convex/values").GenericId<"connections">;
-    accessToken: string;
-    refreshToken: string;
-    expiresAt: number;
-}, Promise<null>>;
-/**
- * Get stored tokens for a connection.
- */
-export declare const getTokens: import("convex/server").RegisteredQuery<"internal", {
-    connectionId: import("convex/values").GenericId<"connections">;
-}, Promise<{
-    _id: import("convex/values").GenericId<"providerTokens">;
-    _creationTime: number;
-    refreshToken?: string | undefined;
-    expiresAt?: number | undefined;
-    connectionId: import("convex/values").GenericId<"connections">;
-    accessToken: string;
-} | null>>;
-/**
- * Delete stored tokens for a connection.
- */
-export declare const deleteTokens: import("convex/server").RegisteredMutation<"internal", {
-    connectionId: import("convex/values").GenericId<"connections">;
-}, Promise<null>>;
-/**
- * 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.
- */
-export declare const getGarminAuthUrl: import("convex/server").RegisteredAction<"public", {
-    userId?: string | undefined;
-    redirectUri?: string | undefined;
-    clientId: string;
-}, Promise<{
-    authUrl: string;
-    state: string;
-    codeVerifier: string;
-}>>;
-/**
- * Exchange an authorization code for tokens + initial sync.
- *
- * Used in the manual flow where the host app stores the code verifier
- * and handles the callback itself.
- */
-export declare const connectGarmin: import("convex/server").RegisteredAction<"public", {
-    redirectUri?: string | undefined;
-    userId: string;
-    codeVerifier: string;
-    clientId: string;
-    clientSecret: string;
-    code: string;
-}, Promise<{
-    connectionId: any;
-    synced: {
-        activities: number;
-        dailies: number;
-        sleep: number;
-        body: number;
-        menstruation: number;
-        bloodPressures: number;
-        skinTemp: number;
-        userMetrics: number;
-        hrv: number;
-        stressDetails: number;
-        pulseOx: number;
-        respiration: number;
-    };
-    errors: {
-        type: string;
-        id: string;
-        error: string;
-    }[];
-}>>;
-/**
- * Complete a Garmin OAuth 2.0 flow using stored pending state.
- *
- * 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.
- */
-export declare const completeGarminOAuth: import("convex/server").RegisteredAction<"public", {
-    redirectUri?: string | undefined;
-    state: string;
-    clientId: string;
-    clientSecret: string;
-    code: string;
-}, Promise<{
-    connectionId: any;
-    synced: {
-        activities: number;
-        dailies: number;
-        sleep: number;
-        body: number;
-        menstruation: number;
-        bloodPressures: number;
-        skinTemp: number;
-        userMetrics: number;
-        hrv: number;
-        stressDetails: number;
-        pulseOx: number;
-        respiration: number;
-    };
-    errors: {
-        type: string;
-        id: string;
-        error: string;
-    }[];
-}>>;
-/**
- * Incremental Garmin sync for an already-connected user.
- *
- * Looks up the stored tokens, refreshes if expired, and syncs all data
- * types for the specified time range (defaults to last 30 days).
- */
-export declare const syncGarmin: import("convex/server").RegisteredAction<"public", {
-    startTimeInSeconds?: number | undefined;
-    endTimeInSeconds?: number | undefined;
-    userId: string;
-    clientId: string;
-    clientSecret: string;
-}, Promise<{
-    synced: {
-        activities: number;
-        dailies: number;
-        sleep: number;
-        body: number;
-        menstruation: number;
-        bloodPressures: number;
-        skinTemp: number;
-        userMetrics: number;
-        hrv: number;
-        stressDetails: number;
-        pulseOx: number;
-        respiration: number;
-    };
-    errors: {
-        type: string;
-        id: string;
-        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;
-}>>;
-/**
- * Handle a webhook for Garmin activities (push or ping mode).
- *
- * Push mode: receives full GarminActivity objects, transforms, and ingests.
- * Ping mode: receives notifications, fetches data from the Garmin API, transforms, and ingests.
- */
-export declare const handleGarminWebhookActivities: import("convex/server").RegisteredAction<"public", {
-    payload: any;
-}, Promise<{
-    processed: number;
-    errors: {
-        type: string;
-        id: string;
-        error: string;
-    }[];
-}>>;
-/**
- * Handle a webhook for Garmin daily summaries (push or ping mode).
- */
-export declare const handleGarminWebhookDailies: import("convex/server").RegisteredAction<"public", {
-    payload: any;
-}, Promise<{
-    processed: number;
-    errors: {
-        type: string;
-        id: string;
-        error: string;
-    }[];
-}>>;
-/**
- * Handle a webhook for Garmin sleep summaries (push or ping mode).
- */
-export declare const handleGarminWebhookSleeps: import("convex/server").RegisteredAction<"public", {
-    payload: any;
-}, Promise<{
-    processed: number;
-    errors: {
-        type: string;
-        id: string;
-        error: string;
-    }[];
-}>>;
-/**
- * Handle a webhook for Garmin body composition summaries (push or ping mode).
- */
-export declare const handleGarminWebhookBody: import("convex/server").RegisteredAction<"public", {
-    payload: any;
-}, Promise<{
-    processed: number;
-    errors: {
-        type: string;
-        id: string;
-        error: string;
-    }[];
-}>>;
-/**
- * Handle a webhook for Garmin menstrual cycle tracking (push or ping mode).
- */
-export declare const handleGarminWebhookMenstruation: import("convex/server").RegisteredAction<"public", {
-    payload: any;
-}, Promise<{
-    processed: number;
-    errors: {
-        type: string;
-        id: string;
-        error: string;
-    }[];
-}>>;
-/**
- * Handle a webhook for Garmin blood pressure summaries (push or ping mode).
- */
-export declare const handleGarminWebhookBloodPressures: import("convex/server").RegisteredAction<"public", {
-    payload: any;
-}, Promise<{
-    processed: number;
-    errors: {
-        type: string;
-        id: string;
-        error: string;
-    }[];
-}>>;
-/**
- * Handle a webhook for Garmin skin temperature summaries (push or ping mode).
- */
-export declare const handleGarminWebhookSkinTemp: import("convex/server").RegisteredAction<"public", {
-    payload: any;
-}, Promise<{
-    processed: number;
-    errors: {
-        type: string;
-        id: string;
-        error: string;
-    }[];
-}>>;
-/**
- * Handle a webhook for Garmin user metrics (push or ping mode).
- */
-export declare const handleGarminWebhookUserMetrics: import("convex/server").RegisteredAction<"public", {
-    payload: any;
-}, Promise<{
-    processed: number;
-    errors: {
-        type: string;
-        id: string;
-        error: string;
-    }[];
-}>>;
-/**
- * Handle a webhook for Garmin HRV summaries (push or ping mode).
- * Enriches daily records with heart_rate_data.
- */
-export declare const handleGarminWebhookHRV: import("convex/server").RegisteredAction<"public", {
-    payload: any;
-}, Promise<{
-    processed: number;
-    errors: {
-        type: string;
-        id: string;
-        error: string;
-    }[];
-}>>;
-/**
- * Handle a webhook for Garmin stress detail summaries (push or ping mode).
- * Enriches daily records with stress_data.
- */
-export declare const handleGarminWebhookStressDetails: import("convex/server").RegisteredAction<"public", {
-    payload: any;
-}, Promise<{
-    processed: number;
-    errors: {
-        type: string;
-        id: string;
-        error: string;
-    }[];
-}>>;
-/**
- * Handle a webhook for Garmin pulse oximetry (SpO2) summaries (push or ping mode).
- * Enriches daily records with oxygen_data.
- */
-export declare const handleGarminWebhookPulseOx: import("convex/server").RegisteredAction<"public", {
-    payload: any;
-}, Promise<{
-    processed: number;
-    errors: {
-        type: string;
-        id: string;
-        error: string;
-    }[];
-}>>;
-/**
- * Handle a webhook for Garmin respiration summaries (push or ping mode).
- * Enriches daily records with respiration_data.
- */
-export declare const handleGarminWebhookRespiration: import("convex/server").RegisteredAction<"public", {
-    payload: any;
-}, Promise<{
-    processed: number;
-    errors: {
-        type: string;
-        id: string;
-        error: string;
-    }[];
-}>>;
-//# sourceMappingURL=garmin.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"garmin.d.ts","sourceRoot":"","sources":["../../src/component/garmin.ts"],"names":[],"mappings":"AAqEA,eAAO,MAAM,iBAAiB;;;;;iBAe5B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;UAoB1B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;iBAa7B,CAAC;AAIH;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;iBAiCtB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;;;UAqBpB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,YAAY;;iBAgBvB,CAAC;AAIH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;GAkC3B,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;cAsmCI,MAAM;YAAM,MAAM;eAAS,MAAM;;GA3hC7D,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;cAghCF,MAAM;YAAM,MAAM;eAAS,MAAM;;GAx7B7D,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;cAg7BO,MAAM;YAAM,MAAM;eAAS,MAAM;;GA30B7D,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB;;iBAwC3B,CAAC;AAIH;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;GA2H7B,CAAC;AAcH;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B;;;;;cA6cZ,MAAM;YAAM,MAAM;eAAS,MAAM;;GA9b7D,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;cAybT,MAAM;YAAM,MAAM;eAAS,MAAM;;GAza7D,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;cAoaR,MAAM;YAAM,MAAM;eAAS,MAAM;;GApZ7D,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;cA+YN,MAAM;YAAM,MAAM;eAAS,MAAM;;GA5X7D,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,+BAA+B;;;;;cAuXd,MAAM;YAAM,MAAM;eAAS,MAAM;;GAvW7D,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iCAAiC;;;;;cAkWhB,MAAM;YAAM,MAAM;eAAS,MAAM;;GA/U7D,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;;cA0UV,MAAM;YAAM,MAAM;eAAS,MAAM;;GA1T7D,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,8BAA8B;;;;;cAqTb,MAAM;YAAM,MAAM;eAAS,MAAM;;GArS7D,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;cA+RL,MAAM;YAAM,MAAM;eAAS,MAAM;;GAnQ7D,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,gCAAgC;;;;;cA6Pf,MAAM;YAAM,MAAM;eAAS,MAAM;;GAjO7D,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;;;cA2NT,MAAM;YAAM,MAAM;eAAS,MAAM;;GA/L7D,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,8BAA8B;;;;;cAyLb,MAAM;YAAM,MAAM;eAAS,MAAM;;GA/J7D,CAAC"}