@nativesquare/soma 0.9.2 → 0.9.3

package/package.json

@@ -6,7 +6,7 @@
   "bugs": {
     "url": "https://github.com/NativeSquare/soma/issues"
   },
-  "version": "0.9.2",
+  "version": "0.9.3",
   "license": "Apache-2.0",
   "keywords": [
     "convex",

package/src/client/index.ts

@@ -1282,6 +1282,8 @@ export interface GarminWebhookEvent {
   dataType: string;
   processed: number;
   errors: Array<{ type: string; id: string; error: string }>;
+  /** Users whose data was affected by this webhook. */
+  affectedUsers: Array<{ userId: string; connectionId: string }>;
 }
 
 // ─── Garmin Route Options ───────────────────────────────────────────────────
@@ -1603,7 +1605,7 @@ export function registerRoutes(
               return new Response("Invalid JSON body", { status: 400 });
             }
 
-            let result: { processed: number; errors: Array<{ type: string; id: string; error: string }> } | undefined;
+            let result: { processed: number; errors: Array<{ type: string; id: string; error: string }>; affectedUsers: Array<{ userId: string; connectionId: string }> } | undefined;
             try {
               result = await ctx.runAction(route.action, { payload }) as typeof result;
             } catch (error) {
@@ -1620,6 +1622,7 @@ export function registerRoutes(
                 dataType,
                 processed: result.processed,
                 errors: result.errors,
+                affectedUsers: result.affectedUsers,
               };
 
               const specificHandler = webhookCfg.events?.[dataType];

package/src/component/garmin/private.ts

@@ -325,7 +325,7 @@ export const processActivityPingPayload = internalAction({
     console.log(
       `[garmin:webhook:activities] Ping mode not yet implemented, acknowledging ${activities.length} items`,
     );
-    return { processed: 0, errors: [] };
+    return { processed: 0, errors: [], affectedUsers: [] };
   },
 });
 
@@ -416,7 +416,7 @@ export const processActivityDetailsPingPayload = internalAction({
     console.log(
       `[garmin:webhook:activityDetails] Ping mode not yet implemented, acknowledging ${activityDetails.length} items`,
     );
-    return { processed: 0, errors: [] };
+    return { processed: 0, errors: [], affectedUsers: [] };
   },
 });
 
@@ -507,7 +507,7 @@ export const processManuallyUpdatedActivitiesPingPayload = internalAction({
     console.log(
       `[garmin:webhook:manuallyUpdatedActivities] Ping mode not yet implemented, acknowledging ${manuallyUpdatedActivities.length} items`,
     );
-    return { processed: 0, errors: [] };
+    return { processed: 0, errors: [], affectedUsers: [] };
   },
 });
 
@@ -600,7 +600,7 @@ export const processMoveIQPingPayload = internalAction({
     console.log(
       `[garmin:webhook:moveIQ] Ping mode not yet implemented, acknowledging ${moveIQActivities.length} items`,
     );
-    return { processed: 0, errors: [] };
+    return { processed: 0, errors: [], affectedUsers: [] };
   },
 });
 
@@ -692,7 +692,7 @@ export const processBloodPressurePingPayload = internalAction({
     console.log(
       `[garmin:webhook:bloodPressures] Ping mode not yet implemented, acknowledging ${bloodPressures.length} items`,
     );
-    return { processed: 0, errors: [] };
+    return { processed: 0, errors: [], affectedUsers: [] };
   },
 });
 
@@ -784,7 +784,7 @@ export const processBodyCompositionsPingPayload = internalAction({
     console.log(
       `[garmin:webhook:bodyCompositions] Ping mode not yet implemented, acknowledging ${bodyComps.length} items`,
     );
-    return { processed: 0, errors: [] };
+    return { processed: 0, errors: [], affectedUsers: [] };
   },
 });
 
@@ -876,7 +876,7 @@ export const processDailiesPingPayload = internalAction({
     console.log(
       `[garmin:webhook:dailies] Ping mode not yet implemented, acknowledging ${dailies.length} items`,
     );
-    return { processed: 0, errors: [] };
+    return { processed: 0, errors: [], affectedUsers: [] };
   },
 });
 
@@ -968,7 +968,7 @@ export const processHealthSnapshotPingPayload = internalAction({
     console.log(
       `[garmin:webhook:healthSnapshot] Ping mode not yet implemented, acknowledging ${healthSnapshot.length} items`,
     );
-    return { processed: 0, errors: [] };
+    return { processed: 0, errors: [], affectedUsers: [] };
   },
 });
 
@@ -1060,7 +1060,7 @@ export const processHRVSummaryPingPayload = internalAction({
     console.log(
       `[garmin:webhook:hrvSummary] Ping mode not yet implemented, acknowledging ${hrv.length} items`,
     );
-    return { processed: 0, errors: [] };
+    return { processed: 0, errors: [], affectedUsers: [] };
   },
 });
 
@@ -1152,7 +1152,7 @@ export const processEpochPingPayload = internalAction({
     console.log(
       `[garmin:webhook:epochs] Ping mode not yet implemented, acknowledging ${epochs.length} items`,
     );
-    return { processed: 0, errors: [] };
+    return { processed: 0, errors: [], affectedUsers: [] };
   },
 });
 
@@ -1244,7 +1244,7 @@ export const processPulseOxPingPayload = internalAction({
     console.log(
       `[garmin:webhook:pulseOx] Ping mode not yet implemented, acknowledging ${pulseox.length} items`,
     );
-    return { processed: 0, errors: [] };
+    return { processed: 0, errors: [], affectedUsers: [] };
   },
 });
 
@@ -1336,7 +1336,7 @@ export const processRespirationPingPayload = internalAction({
     console.log(
       `[garmin:webhook:respiration] Ping mode not yet implemented, acknowledging ${allDayRespiration.length} items`,
     );
-    return { processed: 0, errors: [] };
+    return { processed: 0, errors: [], affectedUsers: [] };
   },
 });
 
@@ -1428,7 +1428,7 @@ export const processStressPingPayload = internalAction({
     console.log(
       `[garmin:webhook:stressDetails] Ping mode not yet implemented, acknowledging ${stressDetails.length} items`,
     );
-    return { processed: 0, errors: [] };
+    return { processed: 0, errors: [], affectedUsers: [] };
   },
 });
 
@@ -1520,7 +1520,7 @@ export const processSkinTemperaturePingPayload = internalAction({
     console.log(
       `[garmin:webhook:skinTemperature] Ping mode not yet implemented, acknowledging ${skinTemp.length} items`,
     );
-    return { processed: 0, errors: [] };
+    return { processed: 0, errors: [], affectedUsers: [] };
   },
 });
 
@@ -1609,7 +1609,7 @@ export const processSleepsPingPayload = internalAction({
     console.log(
       `[garmin:webhook:sleeps] Ping mode not yet implemented, acknowledging ${sleeps.length} items`,
     );
-    return { processed: 0, errors: [] };
+    return { processed: 0, errors: [], affectedUsers: [] };
   },
 });
 
@@ -1701,7 +1701,7 @@ export const processUserMetricsPingPayload = internalAction({
     console.log(
       `[garmin:webhook:userMetrics] Ping mode not yet implemented, acknowledging ${userMetrics.length} items`,
     );
-    return { processed: 0, errors: [] };
+    return { processed: 0, errors: [], affectedUsers: [] };
   },
 });
 
@@ -1792,7 +1792,7 @@ export const processMenstrualCycleTrackingPingPayload = internalAction({
     console.log(
       `[garmin:webhook:menstrualCycleTracking] Ping mode not yet implemented, acknowledging ${mct.length} items`,
     );
-    return { processed: 0, errors: [] };
+    return { processed: 0, errors: [], affectedUsers: [] };
   },
 });
 

package/src/component/garmin/webhooks.ts

@@ -106,6 +106,7 @@ function isWebhookPushMode(payload: unknown): boolean {
 type WebhookResult = {
   processed: number;
   errors: Array<{ type: string; id: string; error: string }>;
+  affectedUsers: Array<{ userId: string; connectionId: string }>;
 };
 
 type ProcessResult = {
@@ -126,6 +127,7 @@ async function ingestAndUpdate(
   let processed = 0;
   const errors = [...result.errors];
   const connectionsToUpdate = new Set<string>();
+  const userMap = new Map<string, { userId: string; connectionId: string }>();
 
   for (const item of result.items) {
     try {
@@ -136,6 +138,10 @@ async function ingestAndUpdate(
       } as never);
       processed++;
       connectionsToUpdate.add(item.connectionId);
+      userMap.set(`${item.userId}:${item.connectionId}`, {
+        userId: item.userId,
+        connectionId: item.connectionId,
+      });
     } catch (err) {
       errors.push({
         type: "ingest",
@@ -152,7 +158,7 @@ async function ingestAndUpdate(
     } as never);
   }
 
-  return { processed, errors };
+  return { processed, errors, affectedUsers: [...userMap.values()] };
 }
 
 // ─── Webhook Handlers ────────────────────────────────────────────────────────
@@ -185,7 +191,7 @@ export const handleGarminWebhookActivities = action({
     console.warn(
       `[garmin:webhook:activities] Payload matched neither ping nor push schema`,
     );
-    return { processed: 0, errors: [] };
+    return { processed: 0, errors: [], affectedUsers: [] };
   },
 });
 
@@ -225,7 +231,7 @@ export const handleGarminWebhookActivityDetails = action({
     console.warn(
       `[garmin:webhook:activityDetails] Payload matched neither ping nor push schema`,
     );
-    return { processed: 0, errors: [] };
+    return { processed: 0, errors: [], affectedUsers: [] };
   },
 });
 
@@ -271,7 +277,7 @@ export const handleGarminWebhookManuallyUpdatedActivities = action({
     console.warn(
       `[garmin:webhook:manuallyUpdatedActivities] Payload matched neither ping nor push schema`,
     );
-    return { processed: 0, errors: [] };
+    return { processed: 0, errors: [], affectedUsers: [] };
   },
 });
 
@@ -311,7 +317,7 @@ export const handleGarminWebhookMoveIQ = action({
     console.warn(
       `[garmin:webhook:moveIQ] Payload matched neither ping nor push schema`,
     );
-    return { processed: 0, errors: [] };
+    return { processed: 0, errors: [], affectedUsers: [] };
   },
 });
 
@@ -351,7 +357,7 @@ export const handleGarminWebhookBloodPressures = action({
     console.warn(
       `[garmin:webhook:bloodPressures] Payload matched neither ping nor push schema`,
     );
-    return { processed: 0, errors: [] };
+    return { processed: 0, errors: [], affectedUsers: [] };
   },
 });
 
@@ -391,7 +397,7 @@ export const handleGarminWebhookBodyCompositions = action({
     console.warn(
       `[garmin:webhook:bodyCompositions] Payload matched neither ping nor push schema`,
     );
-    return { processed: 0, errors: [] };
+    return { processed: 0, errors: [], affectedUsers: [] };
   },
 });
 
@@ -431,7 +437,7 @@ export const handleGarminWebhookDailies = action({
     console.warn(
       `[garmin:webhook:dailies] Payload matched neither ping nor push schema`,
     );
-    return { processed: 0, errors: [] };
+    return { processed: 0, errors: [], affectedUsers: [] };
   },
 });
 
@@ -471,7 +477,7 @@ export const handleGarminWebhookEpochs = action({
     console.warn(
       `[garmin:webhook:epochs] Payload matched neither ping nor push schema`,
     );
-    return { processed: 0, errors: [] };
+    return { processed: 0, errors: [], affectedUsers: [] };
   },
 });
 
@@ -511,7 +517,7 @@ export const handleGarminWebhookHealthSnapshot = action({
     console.warn(
       `[garmin:webhook:healthSnapshot] Payload matched neither ping nor push schema`,
     );
-    return { processed: 0, errors: [] };
+    return { processed: 0, errors: [], affectedUsers: [] };
   },
 });
 
@@ -553,7 +559,7 @@ export const handleGarminWebhookSleeps = action({
     console.warn(
       `[garmin:webhook:sleeps] Payload matched neither ping nor push schema`,
     );
-    return { processed: 0, errors: [] };
+    return { processed: 0, errors: [], affectedUsers: [] };
   },
 });
 
@@ -595,7 +601,7 @@ export const handleGarminWebhookSkinTemp = action({
     console.warn(
       `[garmin:webhook:skinTemperature] Payload matched neither ping nor push schema`,
     );
-    return { processed: 0, errors: [] };
+    return { processed: 0, errors: [], affectedUsers: [] };
   },
 });
 
@@ -637,7 +643,7 @@ export const handleGarminWebhookUserMetrics = action({
     console.warn(
       `[garmin:webhook:userMetrics] Payload matched neither ping nor push schema`,
     );
-    return { processed: 0, errors: [] };
+    return { processed: 0, errors: [], affectedUsers: [] };
   },
 });
 
@@ -679,7 +685,7 @@ export const handleGarminWebhookMenstrualCycleTracking = action({
     console.warn(
       `[garmin:webhook:menstrualCycleTracking] Payload matched neither ping nor push schema`,
     );
-    return { processed: 0, errors: [] };
+    return { processed: 0, errors: [], affectedUsers: [] };
   },
 });
 
@@ -721,7 +727,7 @@ export const handleGarminWebhookHRVSummary = action({
     console.warn(
       `[garmin:webhook:hrvSummary] Payload matched neither ping nor push schema`,
     );
-    return { processed: 0, errors: [] };
+    return { processed: 0, errors: [], affectedUsers: [] };
   },
 });
 
@@ -763,7 +769,7 @@ export const handleGarminWebhookStress = action({
     console.warn(
       `[garmin:webhook:stressDetails] Payload matched neither ping nor push schema`,
     );
-    return { processed: 0, errors: [] };
+    return { processed: 0, errors: [], affectedUsers: [] };
   },
 });
 
@@ -805,7 +811,7 @@ export const handleGarminWebhookPulseOx = action({
     console.warn(
       `[garmin:webhook:pulseOx] Payload matched neither ping nor push schema`,
     );
-    return { processed: 0, errors: [] };
+    return { processed: 0, errors: [], affectedUsers: [] };
   },
 });
 
@@ -847,6 +853,6 @@ export const handleGarminWebhookRespiration = action({
     console.warn(
       `[garmin:webhook:respiration] Payload matched neither ping nor push schema`,
     );
-    return { processed: 0, errors: [] };
+    return { processed: 0, errors: [], affectedUsers: [] };
   },
 });