@nativesquare/soma 0.1.2 → 0.3.0

package/dist/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../src/validators.ts"],"names":[],"mappings":"AAkEA,eAAO,MAAM,mBAAmB;;;;;CAAuB,CAAC;AACxD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;CAAwC,CAAC;AACtE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAyC,CAAC;AACxE,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAqC,CAAC;AAChE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAsC,CAAC;AAClE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAAkC,CAAC;AACxD,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAAmC,CAAC;AAC1D,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAAmC,CAAC;AAC1D,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAA0C,CAAC;AACxE,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAAuC,CAAC;AAClE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAA4C,CAAC"}

package/dist/validators.js

@@ -0,0 +1,78 @@
+// ─── Soma Validators ─────────────────────────────────────────────────────────
+// Re-exports the Convex validators for each Soma table so host apps can use
+// them for type-safe argument validation in their own mutations.
+//
+// Two flavors are exported for each table:
+//
+//   *Validator  — Full validator including connectionId (v.string()) and userId.
+//                 Use when the mutation args map 1:1 to a soma.ingestX() call.
+//
+//   *Data       — Data-only validator (no connectionId/userId).
+//                 Use when connection is resolved server-side and the client
+//                 only sends the health data payload.
+//
+// ─── Examples ────────────────────────────────────────────────────────────────
+//
+// Direct ingest (client provides connectionId):
+//
+//   import { activityValidator } from "@nativesquare/soma/validators";
+//
+//   export const storeActivity = mutation({
+//     args: activityValidator,
+//     handler: async (ctx, args) => {
+//       await soma.ingestActivity(ctx, args);
+//     },
+//   });
+//
+// Batch sync (connection resolved server-side):
+//
+//   import { activityData } from "@nativesquare/soma/validators";
+//
+//   export const syncHealthKit = mutation({
+//     args: { activities: v.array(v.object(activityData)) },
+//     handler: async (ctx, args) => {
+//       const connectionId = await soma.connect(ctx, { userId, provider: "HEALTHKIT" });
+//       for (const activity of args.activities) {
+//         await soma.ingestActivity(ctx, { connectionId, userId, ...activity });
+//       }
+//     },
+//   });
+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 { 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";
+import { nutritionValidator as _nutritionValidator } from "./component/validators/nutrition.js";
+import { plannedWorkoutValidator as _plannedWorkoutValidator } from "./component/validators/plannedWorkout.js";
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+const asString = { connectionId: v.string() };
+function stripConnection(validator) {
+    const { connectionId, userId, ...rest } = validator;
+    return rest;
+}
+// ─── Full validators (connectionId as v.string() + userId) ───────────────────
+export const connectionValidator = _connectionValidator;
+export const athleteValidator = { ..._athleteValidator, ...asString };
+export const activityValidator = { ..._activityValidator, ...asString };
+export const bodyValidator = { ..._bodyValidator, ...asString };
+export const dailyValidator = { ..._dailyValidator, ...asString };
+export const sleepValidator = { ..._sleepValidator, ...asString };
+export const menstruationValidator = { ..._menstruationValidator, ...asString };
+export const nutritionValidator = { ..._nutritionValidator, ...asString };
+export const plannedWorkoutValidator = {
+    ..._plannedWorkoutValidator,
+    ...asString,
+};
+// ─── Data-only validators (no connectionId / userId) ─────────────────────────
+export const athleteData = stripConnection(_athleteValidator);
+export const activityData = stripConnection(_activityValidator);
+export const bodyData = stripConnection(_bodyValidator);
+export const dailyData = stripConnection(_dailyValidator);
+export const sleepData = stripConnection(_sleepValidator);
+export const menstruationData = stripConnection(_menstruationValidator);
+export const nutritionData = stripConnection(_nutritionValidator);
+export const plannedWorkoutData = stripConnection(_plannedWorkoutValidator);
+//# sourceMappingURL=validators.js.map

package/dist/validators.js.map

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

package/package.json

@@ -6,7 +6,7 @@
   "bugs": {
     "url": "https://github.com/NativeSquare/soma/issues"
   },
-  "version": "0.1.2",
+  "version": "0.3.0",
   "license": "Apache-2.0",
   "keywords": [
     "convex",
@@ -53,6 +53,14 @@
       "types": "./dist/healthkit/index.d.ts",
       "default": "./dist/healthkit/index.js"
     },
+    "./strava": {
+      "types": "./dist/strava/index.d.ts",
+      "default": "./dist/strava/index.js"
+    },
+    "./validators": {
+      "types": "./dist/validators.d.ts",
+      "default": "./dist/validators.js"
+    },
     "./test": "./src/test.ts",
     "./_generated/component.js": {
       "types": "./dist/component/_generated/component.d.ts"

package/src/client/index.ts

@@ -1,8 +1,29 @@
 import type { ComponentApi } from "../component/_generated/component.js";
-import type { MutationCtx, QueryCtx } from "./types.js";
+import type { ActionCtx, MutationCtx, QueryCtx } from "./types.js";
+import { buildAuthUrl } from "../strava/auth.js";
 
 export type SomaComponent = ComponentApi;
 
+/**
+ * Configuration for the Strava integration.
+ *
+ * If not provided to the constructor, the Soma class will attempt to
+ * read `STRAVA_CLIENT_ID`, `STRAVA_CLIENT_SECRET`, and `STRAVA_BASE_URL`
+ * from environment variables automatically.
+ */
+export interface SomaStravaConfig {
+  /** Your Strava application's Client ID. */
+  clientId: string;
+  /** Your Strava application's Client Secret. */
+  clientSecret: string;
+  /**
+   * Base URL of the Strava API (without `/api/v3` suffix).
+   * Defaults to `https://www.strava.com`.
+   * Override to point at a mock server during development.
+   */
+  baseUrl?: string;
+}
+
 /**
  * Client class for the @nativesquare/soma Convex component.
  *
@@ -18,20 +39,63 @@ export type SomaComponent = ComponentApi;
  * import { Soma } from "@nativesquare/soma";
  * import { components } from "./_generated/api";
  *
+ * // Zero config if env vars are set in Convex dashboard:
+ * //   STRAVA_CLIENT_ID, STRAVA_CLIENT_SECRET, STRAVA_BASE_URL (optional)
  * const soma = new Soma(components.soma);
  *
+ * // Or with explicit Strava config:
+ * // const soma = new Soma(components.soma, {
+ * //   strava: { clientId: "...", clientSecret: "...", baseUrl: "..." },
+ * // });
+ *
  * // Connect a user to a provider:
  * const connectionId = await soma.connect(ctx, {
  *   userId: "user_123",
  *   provider: "GARMIN",
  * });
  *
- * // List all connections:
- * const connections = await soma.listConnections(ctx, { userId: "user_123" });
+ * // Connect via Strava (handles OAuth, token storage, and initial sync):
+ * const result = await soma.connectStrava(ctx, { userId: "user_123", code: "..." });
  * ```
  */
 export class Soma {
-  constructor(public component: SomaComponent) { }
+  private stravaConfig?: SomaStravaConfig;
+
+  constructor(
+    public component: SomaComponent,
+    options?: { strava?: SomaStravaConfig },
+  ) {
+    this.stravaConfig = options?.strava ?? this.readStravaEnv();
+  }
+
+  /**
+   * Read Strava config from environment variables.
+   * Returns undefined if the required vars are not set.
+   */
+  private readStravaEnv(): SomaStravaConfig | undefined {
+    const clientId = process.env.STRAVA_CLIENT_ID;
+    const clientSecret = process.env.STRAVA_CLIENT_SECRET;
+    if (!clientId || !clientSecret) return undefined;
+    return {
+      clientId,
+      clientSecret,
+      baseUrl: process.env.STRAVA_BASE_URL,
+    };
+  }
+
+  /**
+   * Get the resolved Strava config, or throw a clear error if not configured.
+   */
+  private requireStravaConfig(): SomaStravaConfig {
+    if (!this.stravaConfig) {
+      throw new Error(
+        "Strava is not configured. Either set STRAVA_CLIENT_ID and " +
+        "STRAVA_CLIENT_SECRET environment variables in the Convex dashboard, " +
+        "or pass { strava: { clientId, clientSecret } } to the Soma constructor.",
+      );
+    }
+    return this.stravaConfig;
+  }
 
   // ─── Connect / Disconnect ───────────────────────────────────────────────────
 
@@ -612,6 +676,150 @@ export class Soma {
   ) {
     return await ctx.runQuery(this.component.public.getAthlete, args);
   }
+
+  // ─── Strava Integration ──────────────────────────────────────────────────────
+  // High-level methods that handle OAuth, token storage, and data syncing
+  // for Strava. Requires Strava credentials to be configured either via
+  // environment variables or the constructor.
+
+  /**
+   * Build the Strava OAuth authorization URL.
+   *
+   * This is a pure computation (no DB or HTTP calls), so it doesn't need
+   * a Convex context. Redirect the user to this URL to begin the OAuth flow.
+   *
+   * @param opts.redirectUri - The URL Strava will redirect to after authorization
+   * @param opts.scope - Comma-separated Strava OAuth scopes (default: "read,activity:read_all,profile:read_all")
+   * @param opts.state - Optional state parameter for CSRF protection
+   * @returns The authorization URL string
+   *
+   * @example
+   * ```ts
+   * const url = soma.getStravaAuthUrl({
+   *   redirectUri: "https://your-app.com/api/strava/callback",
+   * });
+   * ```
+   */
+  getStravaAuthUrl(opts: {
+    redirectUri: string;
+    scope?: string;
+    state?: string;
+  }): string {
+    const config = this.requireStravaConfig();
+    return buildAuthUrl({
+      clientId: config.clientId,
+      redirectUri: opts.redirectUri,
+      scope: opts.scope,
+      state: opts.state,
+      baseUrl: config.baseUrl,
+    });
+  }
+
+  /**
+   * Handle the Strava OAuth callback.
+   *
+   * Exchanges the authorization code for tokens, creates/reactivates the
+   * Soma connection, stores tokens securely in the component, syncs the
+   * athlete profile, and syncs all activities.
+   *
+   * Call this from your OAuth callback endpoint after receiving the `code`
+   * query parameter from Strava.
+   *
+   * @param ctx - Action context from the host app
+   * @param args.userId - The host app's user identifier
+   * @param args.code - The authorization code from the OAuth callback
+   * @param args.includeStreams - Fetch detailed streams per activity (default: false)
+   * @returns `{ connectionId, synced, errors }`
+   *
+   * @example
+   * ```ts
+   * export const handleStravaCallback = action({
+   *   args: { userId: v.string(), code: v.string() },
+   *   handler: async (ctx, { userId, code }) => {
+   *     return await soma.connectStrava(ctx, { userId, code });
+   *   },
+   * });
+   * ```
+   */
+  async connectStrava(
+    ctx: ActionCtx,
+    args: { userId: string; code: string; includeStreams?: boolean },
+  ) {
+    const config = this.requireStravaConfig();
+    return await ctx.runAction(this.component.strava.connectStrava, {
+      ...args,
+      clientId: config.clientId,
+      clientSecret: config.clientSecret,
+      baseUrl: config.baseUrl,
+    });
+  }
+
+  /**
+   * Sync activities from Strava for an already-connected user.
+   *
+   * Automatically refreshes the access token if expired. Fetches the
+   * athlete profile and activities, transforms them, and ingests into Soma.
+   *
+   * @param ctx - Action context from the host app
+   * @param args.userId - The host app's user identifier
+   * @param args.includeStreams - Fetch detailed streams per activity (default: false)
+   * @param args.after - Only sync activities after this Unix epoch timestamp (for incremental sync)
+   * @returns `{ synced, errors }`
+   *
+   * @example
+   * ```ts
+   * export const syncStrava = action({
+   *   args: { userId: v.string() },
+   *   handler: async (ctx, { userId }) => {
+   *     return await soma.syncStrava(ctx, { userId, includeStreams: true });
+   *   },
+   * });
+   * ```
+   */
+  async syncStrava(
+    ctx: ActionCtx,
+    args: { userId: string; includeStreams?: boolean; after?: number },
+  ) {
+    const config = this.requireStravaConfig();
+    return await ctx.runAction(this.component.strava.syncStrava, {
+      ...args,
+      clientId: config.clientId,
+      clientSecret: config.clientSecret,
+      baseUrl: config.baseUrl,
+    });
+  }
+
+  /**
+   * Disconnect a user from Strava.
+   *
+   * Revokes the token at Strava (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
+   * export const disconnectStrava = action({
+   *   args: { userId: v.string() },
+   *   handler: async (ctx, { userId }) => {
+   *     await soma.disconnectStrava(ctx, { userId });
+   *   },
+   * });
+   * ```
+   */
+  async disconnectStrava(
+    ctx: ActionCtx,
+    args: { userId: string },
+  ) {
+    const config = this.requireStravaConfig();
+    return await ctx.runAction(this.component.strava.disconnectStrava, {
+      ...args,
+      clientId: config.clientId,
+      clientSecret: config.clientSecret,
+      baseUrl: config.baseUrl,
+    });
+  }
 }
 
 // ─── Shared Types ────────────────────────────────────────────────────────────

package/src/component/_generated/api.ts

@@ -10,6 +10,7 @@
 
 import type * as private_ from "../private.js";
 import type * as public_ from "../public.js";
+import type * as strava from "../strava.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,6 +35,7 @@ import { anyApi, componentsGeneric } from "convex/server";
 const fullApi: ApiFromModules<{
   private: typeof private_;
   public: typeof public_;
+  strava: typeof strava;
   "validators/activity": typeof validators_activity;
   "validators/athlete": typeof validators_athlete;
   "validators/body": typeof validators_body;

package/src/component/_generated/component.ts

@@ -1293,4 +1293,53 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
         Name
       >;
     };
+    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
+      >;
+    };
   };

package/src/component/schema.ts

@@ -113,4 +113,15 @@ export default defineSchema({
     .index("by_connectionId", ["connectionId"])
     .index("by_userId", ["userId"])
     .index("by_userId_plannedDate", ["userId", "metadata.planned_date"]),
+
+  // ── Provider Tokens ────────────────────────────────────────────────────────
+  // OAuth tokens for cloud-based providers (Strava, Garmin, etc.).
+  // Stored separately from connections to keep the connection table
+  // provider-agnostic. One token record per connection.
+  providerTokens: defineTable({
+    connectionId: v.id("connections"),
+    accessToken: v.string(),
+    refreshToken: v.string(),
+    expiresAt: v.number(), // Unix epoch seconds
+  }).index("by_connectionId", ["connectionId"]),
 });