@nativesquare/soma 0.7.3 → 0.9.0

package/src/component/private.ts

@@ -34,6 +34,27 @@ export const getConnectionByProvider = internalQuery({
   },
 });
 
+/**
+ * Get a connection by provider's external user ID + provider (internal).
+ * Used by webhook handlers to map Garmin's userId to a Soma connection.
+ */
+export const getConnectionByProviderUserId = internalQuery({
+  args: {
+    providerUserId: v.string(),
+    provider: v.string(),
+  },
+  handler: async (ctx, args) => {
+    return await ctx.db
+      .query("connections")
+      .withIndex("by_providerUserId_provider", (q) =>
+        q
+          .eq("providerUserId", args.providerUserId)
+          .eq("provider", args.provider),
+      )
+      .first();
+  },
+});
+
 /**
  * Update the lastDataUpdate timestamp after a successful sync.
  */

package/src/component/public.ts

@@ -17,6 +17,7 @@ const connectionDoc = v.object({
   _creationTime: v.number(),
   userId: v.string(),
   provider: v.string(),
+  providerUserId: v.optional(v.string()),
   active: v.optional(v.boolean()),
   lastDataUpdate: v.optional(v.string()),
 });
@@ -33,6 +34,7 @@ export const connect = mutation({
   args: {
     userId: v.string(),
     provider: v.string(),
+    providerUserId: v.optional(v.string()),
   },
   returns: v.id("connections"),
   handler: async (ctx, args) => {
@@ -44,8 +46,13 @@ export const connect = mutation({
       .first();
 
     if (existing) {
-      if (!existing.active) {
-        await ctx.db.patch(existing._id, { active: true });
+      const patch: Record<string, unknown> = {};
+      if (!existing.active) patch.active = true;
+      if (args.providerUserId && !existing.providerUserId) {
+        patch.providerUserId = args.providerUserId;
+      }
+      if (Object.keys(patch).length > 0) {
+        await ctx.db.patch(existing._id, patch);
       }
       return existing._id;
     }
@@ -53,6 +60,7 @@ export const connect = mutation({
     return await ctx.db.insert("connections", {
       userId: args.userId,
       provider: args.provider,
+      providerUserId: args.providerUserId,
       active: true,
     });
   },
@@ -142,6 +150,7 @@ export const listConnections = query({
 export const updateConnection = mutation({
   args: {
     connectionId: v.id("connections"),
+    providerUserId: v.optional(v.string()),
     active: v.optional(v.boolean()),
     lastDataUpdate: v.optional(v.string()),
   },

package/src/component/schema.ts

@@ -29,7 +29,8 @@ export default defineSchema({
   connections: defineTable(connectionValidator)
     .index("by_userId", ["userId"])
     .index("by_provider", ["provider"])
-    .index("by_userId_provider", ["userId", "provider"]),
+    .index("by_userId_provider", ["userId", "provider"])
+    .index("by_providerUserId_provider", ["providerUserId", "provider"]),
 
   // ── Athletes ───────────────────────────────────────────────────────────────
   // User profile/identifying information from the provider.

package/src/component/strava/private.ts

@@ -0,0 +1,89 @@
+// ─── Internal Token CRUD ─────────────────────────────────────────────────────
+// These are only callable from within the component (actions in this file).
+
+import { v } from "convex/values";
+import {
+  internalMutation,
+  internalQuery,
+} from "../_generated/server";
+
+/**
+ * Store or update OAuth tokens for a connection.
+ * Upserts by connectionId — one token record per connection.
+ */
+export const storeTokens = internalMutation({
+  args: {
+    connectionId: v.id("connections"),
+    accessToken: v.string(),
+    refreshToken: v.string(),
+    expiresAt: v.number(),
+  },
+  returns: v.null(),
+  handler: async (ctx, args) => {
+    const existing = await ctx.db
+      .query("providerTokens")
+      .withIndex("by_connectionId", (q) =>
+        q.eq("connectionId", args.connectionId),
+      )
+      .first();
+
+    if (existing) {
+      await ctx.db.patch(existing._id, {
+        accessToken: args.accessToken,
+        refreshToken: args.refreshToken,
+        expiresAt: args.expiresAt,
+      });
+      return null;
+    }
+
+    await ctx.db.insert("providerTokens", args);
+    return null;
+  },
+});
+
+/**
+ * Get stored tokens for a connection.
+ */
+export const getTokens = internalQuery({
+  args: { connectionId: v.id("connections") },
+  returns: v.union(
+    v.object({
+      _id: v.id("providerTokens"),
+      _creationTime: v.number(),
+      connectionId: v.id("connections"),
+      accessToken: v.string(),
+      refreshToken: v.optional(v.string()),
+      expiresAt: v.optional(v.number()),
+    }),
+    v.null(),
+  ),
+  handler: async (ctx, args) => {
+    return await ctx.db
+      .query("providerTokens")
+      .withIndex("by_connectionId", (q) =>
+        q.eq("connectionId", args.connectionId),
+      )
+      .first();
+  },
+});
+
+/**
+ * Delete stored tokens for a connection.
+ */
+export const deleteTokens = internalMutation({
+  args: { connectionId: v.id("connections") },
+  returns: v.null(),
+  handler: async (ctx, args) => {
+    const existing = await ctx.db
+      .query("providerTokens")
+      .withIndex("by_connectionId", (q) =>
+        q.eq("connectionId", args.connectionId),
+      )
+      .first();
+
+    if (existing) {
+      await ctx.db.delete(existing._id);
+    }
+    return null;
+  },
+});