@nativesquare/soma 0.18.0 → 0.18.1

package/dist/component/garmin/private.js

@@ -45,7 +45,11 @@ import { transformMenstrualCycleTracking } from "./transform/menstrualCycleTrack
  * and transforms each activity. Does not write to the database.
  */
 export const processActivityPushPayload = internalAction({
-    args: { payload: v.any() },
+    args: {
+        payload: v.any(),
+        // Only consumed by push processors; ping processors ignore it.
+        rawPassthrough: v.optional(v.boolean()),
+    },
     handler: async (ctx, args) => {
         const { activities } = garminActivityPushPayloadSchema.parse(args.payload);
         const items = [];
@@ -85,7 +89,9 @@ export const processActivityPushPayload = internalAction({
             }
             for (const item of userItems) {
                 try {
-                    const data = transformActivity(item);
+                    const data = args.rawPassthrough
+                        ? item
+                        : transformActivity(item);
                     items.push({ connectionId: connection._id, userId: connection.userId, data });
                 }
                 catch (err) {
@@ -106,7 +112,11 @@ export const processActivityPushPayload = internalAction({
  * Stub — acknowledges the notification without fetching data.
  */
 export const processActivityPingPayload = internalAction({
-    args: { payload: v.any() },
+    args: {
+        payload: v.any(),
+        // Only consumed by push processors; ping processors ignore it.
+        rawPassthrough: v.optional(v.boolean()),
+    },
     handler: async (_ctx, args) => {
         const { activities } = garminActivityPingPayloadSchema.parse(args.payload);
         console.log(`[garmin:webhook:activities] Ping mode not yet implemented, acknowledging ${activities.length} items`);
@@ -121,7 +131,11 @@ export const processActivityPingPayload = internalAction({
  * Does not write to the database.
  */
 export const processActivityDetailsPushPayload = internalAction({
-    args: { payload: v.any() },
+    args: {
+        payload: v.any(),
+        // Only consumed by push processors; ping processors ignore it.
+        rawPassthrough: v.optional(v.boolean()),
+    },
     handler: async (ctx, args) => {
         const { activityDetails } = garminActivityDetailsPushPayloadSchema.parse(args.payload);
         const items = [];
@@ -161,7 +175,9 @@ export const processActivityDetailsPushPayload = internalAction({
             }
             for (const item of userItems) {
                 try {
-                    const data = transformActivityDetails(item);
+                    const data = args.rawPassthrough
+                        ? item
+                        : transformActivityDetails(item);
                     items.push({ connectionId: connection._id, userId: connection.userId, data });
                 }
                 catch (err) {
@@ -182,7 +198,11 @@ export const processActivityDetailsPushPayload = internalAction({
  * Stub — acknowledges the notification without fetching data.
  */
 export const processActivityDetailsPingPayload = internalAction({
-    args: { payload: v.any() },
+    args: {
+        payload: v.any(),
+        // Only consumed by push processors; ping processors ignore it.
+        rawPassthrough: v.optional(v.boolean()),
+    },
     handler: async (_ctx, args) => {
         const { activityDetails } = garminActivityDetailsPingPayloadSchema.parse(args.payload);
         console.log(`[garmin:webhook:activityDetails] Ping mode not yet implemented, acknowledging ${activityDetails.length} items`);
@@ -196,7 +216,11 @@ export const processActivityDetailsPingPayload = internalAction({
  * and transforms each activity. Does not write to the database.
  */
 export const processManuallyUpdatedActivitiesPushPayload = internalAction({
-    args: { payload: v.any() },
+    args: {
+        payload: v.any(),
+        // Only consumed by push processors; ping processors ignore it.
+        rawPassthrough: v.optional(v.boolean()),
+    },
     handler: async (ctx, args) => {
         const { manuallyUpdatedActivities } = garminManuallyUpdatedActivitiesPushPayloadSchema.parse(args.payload);
         const items = [];
@@ -236,7 +260,9 @@ export const processManuallyUpdatedActivitiesPushPayload = internalAction({
             }
             for (const item of userItems) {
                 try {
-                    const data = transformManuallyUpdatedActivity(item);
+                    const data = args.rawPassthrough
+                        ? item
+                        : transformManuallyUpdatedActivity(item);
                     items.push({ connectionId: connection._id, userId: connection.userId, data });
                 }
                 catch (err) {
@@ -257,7 +283,11 @@ export const processManuallyUpdatedActivitiesPushPayload = internalAction({
  * Stub — acknowledges the notification without fetching data.
  */
 export const processManuallyUpdatedActivitiesPingPayload = internalAction({
-    args: { payload: v.any() },
+    args: {
+        payload: v.any(),
+        // Only consumed by push processors; ping processors ignore it.
+        rawPassthrough: v.optional(v.boolean()),
+    },
     handler: async (_ctx, args) => {
         const { manuallyUpdatedActivities } = garminManuallyUpdatedActivitiesPingPayloadSchema.parse(args.payload);
         console.log(`[garmin:webhook:manuallyUpdatedActivities] Ping mode not yet implemented, acknowledging ${manuallyUpdatedActivities.length} items`);
@@ -272,7 +302,11 @@ export const processManuallyUpdatedActivitiesPingPayload = internalAction({
  * Does not write to the database.
  */
 export const processMoveIQPushPayload = internalAction({
-    args: { payload: v.any() },
+    args: {
+        payload: v.any(),
+        // Only consumed by push processors; ping processors ignore it.
+        rawPassthrough: v.optional(v.boolean()),
+    },
     handler: async (ctx, args) => {
         const { moveIQActivities } = garminMoveIQPushPayloadSchema.parse(args.payload);
         const items = [];
@@ -312,7 +346,9 @@ export const processMoveIQPushPayload = internalAction({
             }
             for (const item of userItems) {
                 try {
-                    const data = transformMoveIQ(item);
+                    const data = args.rawPassthrough
+                        ? item
+                        : transformMoveIQ(item);
                     items.push({ connectionId: connection._id, userId: connection.userId, data });
                 }
                 catch (err) {
@@ -333,7 +369,11 @@ export const processMoveIQPushPayload = internalAction({
  * Stub — acknowledges the notification without fetching data.
  */
 export const processMoveIQPingPayload = internalAction({
-    args: { payload: v.any() },
+    args: {
+        payload: v.any(),
+        // Only consumed by push processors; ping processors ignore it.
+        rawPassthrough: v.optional(v.boolean()),
+    },
     handler: async (_ctx, args) => {
         const { moveIQActivities } = garminMoveIQPingPayloadSchema.parse(args.payload);
         console.log(`[garmin:webhook:moveIQ] Ping mode not yet implemented, acknowledging ${moveIQActivities.length} items`);
@@ -347,7 +387,11 @@ export const processMoveIQPingPayload = internalAction({
  * and transforms each record. Does not write to the database.
  */
 export const processBloodPressurePushPayload = internalAction({
-    args: { payload: v.any() },
+    args: {
+        payload: v.any(),
+        // Only consumed by push processors; ping processors ignore it.
+        rawPassthrough: v.optional(v.boolean()),
+    },
     handler: async (ctx, args) => {
         const { bloodPressures } = garminBloodPressurePushPayloadSchema.parse(args.payload);
         const items = [];
@@ -387,7 +431,9 @@ export const processBloodPressurePushPayload = internalAction({
             }
             for (const item of userItems) {
                 try {
-                    const data = transformBloodPressure(item);
+                    const data = args.rawPassthrough
+                        ? item
+                        : transformBloodPressure(item);
                     if (data == null)
                         continue;
                     items.push({ connectionId: connection._id, userId: connection.userId, data });
@@ -410,7 +456,11 @@ export const processBloodPressurePushPayload = internalAction({
  * Stub — acknowledges the notification without fetching data.
  */
 export const processBloodPressurePingPayload = internalAction({
-    args: { payload: v.any() },
+    args: {
+        payload: v.any(),
+        // Only consumed by push processors; ping processors ignore it.
+        rawPassthrough: v.optional(v.boolean()),
+    },
     handler: async (_ctx, args) => {
         const { bloodPressures } = garminBloodPressurePingPayloadSchema.parse(args.payload);
         console.log(`[garmin:webhook:bloodPressures] Ping mode not yet implemented, acknowledging ${bloodPressures.length} items`);
@@ -424,7 +474,11 @@ export const processBloodPressurePingPayload = internalAction({
  * and transforms each record. Does not write to the database.
  */
 export const processBodyCompositionsPushPayload = internalAction({
-    args: { payload: v.any() },
+    args: {
+        payload: v.any(),
+        // Only consumed by push processors; ping processors ignore it.
+        rawPassthrough: v.optional(v.boolean()),
+    },
     handler: async (ctx, args) => {
         const { bodyComps } = garminBodyCompositionsPushPayloadSchema.parse(args.payload);
         const items = [];
@@ -464,7 +518,9 @@ export const processBodyCompositionsPushPayload = internalAction({
             }
             for (const item of userItems) {
                 try {
-                    const data = transformBodyComposition(item);
+                    const data = args.rawPassthrough
+                        ? item
+                        : transformBodyComposition(item);
                     if (data == null)
                         continue;
                     items.push({ connectionId: connection._id, userId: connection.userId, data });
@@ -487,7 +543,11 @@ export const processBodyCompositionsPushPayload = internalAction({
  * Stub — acknowledges the notification without fetching data.
  */
 export const processBodyCompositionsPingPayload = internalAction({
-    args: { payload: v.any() },
+    args: {
+        payload: v.any(),
+        // Only consumed by push processors; ping processors ignore it.
+        rawPassthrough: v.optional(v.boolean()),
+    },
     handler: async (_ctx, args) => {
         const { bodyComps } = garminBodyCompositionsPingPayloadSchema.parse(args.payload);
         console.log(`[garmin:webhook:bodyCompositions] Ping mode not yet implemented, acknowledging ${bodyComps.length} items`);
@@ -501,7 +561,11 @@ export const processBodyCompositionsPingPayload = internalAction({
  * and transforms each record. Does not write to the database.
  */
 export const processDailiesPushPayload = internalAction({
-    args: { payload: v.any() },
+    args: {
+        payload: v.any(),
+        // Only consumed by push processors; ping processors ignore it.
+        rawPassthrough: v.optional(v.boolean()),
+    },
     handler: async (ctx, args) => {
         const { dailies } = garminDailiesPushPayloadSchema.parse(args.payload);
         const items = [];
@@ -541,7 +605,9 @@ export const processDailiesPushPayload = internalAction({
             }
             for (const item of userItems) {
                 try {
-                    const data = transformDailies(item);
+                    const data = args.rawPassthrough
+                        ? item
+                        : transformDailies(item);
                     if (data == null)
                         continue;
                     items.push({ connectionId: connection._id, userId: connection.userId, data });
@@ -564,7 +630,11 @@ export const processDailiesPushPayload = internalAction({
  * Stub — acknowledges the notification without fetching data.
  */
 export const processDailiesPingPayload = internalAction({
-    args: { payload: v.any() },
+    args: {
+        payload: v.any(),
+        // Only consumed by push processors; ping processors ignore it.
+        rawPassthrough: v.optional(v.boolean()),
+    },
     handler: async (_ctx, args) => {
         const { dailies } = garminDailiesPingPayloadSchema.parse(args.payload);
         console.log(`[garmin:webhook:dailies] Ping mode not yet implemented, acknowledging ${dailies.length} items`);
@@ -578,7 +648,11 @@ export const processDailiesPingPayload = internalAction({
  * and transforms each record. Does not write to the database.
  */
 export const processHealthSnapshotPushPayload = internalAction({
-    args: { payload: v.any() },
+    args: {
+        payload: v.any(),
+        // Only consumed by push processors; ping processors ignore it.
+        rawPassthrough: v.optional(v.boolean()),
+    },
     handler: async (ctx, args) => {
         const { healthSnapshot } = garminHealthSnapshotPushPayloadSchema.parse(args.payload);
         const items = [];
@@ -618,7 +692,9 @@ export const processHealthSnapshotPushPayload = internalAction({
             }
             for (const item of userItems) {
                 try {
-                    const data = transformHealthSnapshot(item);
+                    const data = args.rawPassthrough
+                        ? item
+                        : transformHealthSnapshot(item);
                     if (data == null)
                         continue;
                     items.push({ connectionId: connection._id, userId: connection.userId, data });
@@ -641,7 +717,11 @@ export const processHealthSnapshotPushPayload = internalAction({
  * Stub — acknowledges the notification without fetching data.
  */
 export const processHealthSnapshotPingPayload = internalAction({
-    args: { payload: v.any() },
+    args: {
+        payload: v.any(),
+        // Only consumed by push processors; ping processors ignore it.
+        rawPassthrough: v.optional(v.boolean()),
+    },
     handler: async (_ctx, args) => {
         const { healthSnapshot } = garminHealthSnapshotPingPayloadSchema.parse(args.payload);
         console.log(`[garmin:webhook:healthSnapshot] Ping mode not yet implemented, acknowledging ${healthSnapshot.length} items`);
@@ -655,7 +735,11 @@ export const processHealthSnapshotPingPayload = internalAction({
  * and transforms each record. Does not write to the database.
  */
 export const processHRVSummaryPushPayload = internalAction({
-    args: { payload: v.any() },
+    args: {
+        payload: v.any(),
+        // Only consumed by push processors; ping processors ignore it.
+        rawPassthrough: v.optional(v.boolean()),
+    },
     handler: async (ctx, args) => {
         const { hrv } = garminHRVSummaryPushPayloadSchema.parse(args.payload);
         const items = [];
@@ -695,7 +779,9 @@ export const processHRVSummaryPushPayload = internalAction({
             }
             for (const item of userItems) {
                 try {
-                    const data = transformHRVSummary(item);
+                    const data = args.rawPassthrough
+                        ? item
+                        : transformHRVSummary(item);
                     if (data == null)
                         continue;
                     items.push({ connectionId: connection._id, userId: connection.userId, data });
@@ -718,7 +804,11 @@ export const processHRVSummaryPushPayload = internalAction({
  * Stub — acknowledges the notification without fetching data.
  */
 export const processHRVSummaryPingPayload = internalAction({
-    args: { payload: v.any() },
+    args: {
+        payload: v.any(),
+        // Only consumed by push processors; ping processors ignore it.
+        rawPassthrough: v.optional(v.boolean()),
+    },
     handler: async (_ctx, args) => {
         const { hrv } = garminHRVSummaryPingPayloadSchema.parse(args.payload);
         console.log(`[garmin:webhook:hrvSummary] Ping mode not yet implemented, acknowledging ${hrv.length} items`);
@@ -732,7 +822,11 @@ export const processHRVSummaryPingPayload = internalAction({
  * resolves connections, and transforms each record. Does not write to the database.
  */
 export const processEpochPushPayload = internalAction({
-    args: { payload: v.any() },
+    args: {
+        payload: v.any(),
+        // Only consumed by push processors; ping processors ignore it.
+        rawPassthrough: v.optional(v.boolean()),
+    },
     handler: async (ctx, args) => {
         const { epochs } = garminEpochPushPayloadSchema.parse(args.payload);
         const items = [];
@@ -772,7 +866,9 @@ export const processEpochPushPayload = internalAction({
             }
             for (const item of userItems) {
                 try {
-                    const data = transformEpoch(item);
+                    const data = args.rawPassthrough
+                        ? item
+                        : transformEpoch(item);
                     if (data == null)
                         continue;
                     items.push({ connectionId: connection._id, userId: connection.userId, data });
@@ -795,7 +891,11 @@ export const processEpochPushPayload = internalAction({
  * Stub — acknowledges the notification without fetching data.
  */
 export const processEpochPingPayload = internalAction({
-    args: { payload: v.any() },
+    args: {
+        payload: v.any(),
+        // Only consumed by push processors; ping processors ignore it.
+        rawPassthrough: v.optional(v.boolean()),
+    },
     handler: async (_ctx, args) => {
         const { epochs } = garminEpochPingPayloadSchema.parse(args.payload);
         console.log(`[garmin:webhook:epochs] Ping mode not yet implemented, acknowledging ${epochs.length} items`);
@@ -809,7 +909,11 @@ export const processEpochPingPayload = internalAction({
  * and transforms each record. Does not write to the database.
  */
 export const processPulseOxPushPayload = internalAction({
-    args: { payload: v.any() },
+    args: {
+        payload: v.any(),
+        // Only consumed by push processors; ping processors ignore it.
+        rawPassthrough: v.optional(v.boolean()),
+    },
     handler: async (ctx, args) => {
         const { pulseox } = garminPulseOxPushPayloadSchema.parse(args.payload);
         const items = [];
@@ -849,7 +953,9 @@ export const processPulseOxPushPayload = internalAction({
             }
             for (const item of userItems) {
                 try {
-                    const data = transformPulseOx(item);
+                    const data = args.rawPassthrough
+                        ? item
+                        : transformPulseOx(item);
                     if (data == null)
                         continue;
                     items.push({ connectionId: connection._id, userId: connection.userId, data });
@@ -872,7 +978,11 @@ export const processPulseOxPushPayload = internalAction({
  * Stub — acknowledges the notification without fetching data.
  */
 export const processPulseOxPingPayload = internalAction({
-    args: { payload: v.any() },
+    args: {
+        payload: v.any(),
+        // Only consumed by push processors; ping processors ignore it.
+        rawPassthrough: v.optional(v.boolean()),
+    },
     handler: async (_ctx, args) => {
         const { pulseox } = garminPulseOxPingPayloadSchema.parse(args.payload);
         console.log(`[garmin:webhook:pulseOx] Ping mode not yet implemented, acknowledging ${pulseox.length} items`);
@@ -886,7 +996,11 @@ export const processPulseOxPingPayload = internalAction({
  * and transforms each record. Does not write to the database.
  */
 export const processRespirationPushPayload = internalAction({
-    args: { payload: v.any() },
+    args: {
+        payload: v.any(),
+        // Only consumed by push processors; ping processors ignore it.
+        rawPassthrough: v.optional(v.boolean()),
+    },
     handler: async (ctx, args) => {
         const { allDayRespiration } = garminRespirationPushPayloadSchema.parse(args.payload);
         const items = [];
@@ -926,7 +1040,9 @@ export const processRespirationPushPayload = internalAction({
             }
             for (const item of userItems) {
                 try {
-                    const data = transformRespiration(item);
+                    const data = args.rawPassthrough
+                        ? item
+                        : transformRespiration(item);
                     if (data == null)
                         continue;
                     items.push({ connectionId: connection._id, userId: connection.userId, data });
@@ -949,7 +1065,11 @@ export const processRespirationPushPayload = internalAction({
  * Stub — acknowledges the notification without fetching data.
  */
 export const processRespirationPingPayload = internalAction({
-    args: { payload: v.any() },
+    args: {
+        payload: v.any(),
+        // Only consumed by push processors; ping processors ignore it.
+        rawPassthrough: v.optional(v.boolean()),
+    },
     handler: async (_ctx, args) => {
         const { allDayRespiration } = garminRespirationPingPayloadSchema.parse(args.payload);
         console.log(`[garmin:webhook:respiration] Ping mode not yet implemented, acknowledging ${allDayRespiration.length} items`);
@@ -963,7 +1083,11 @@ export const processRespirationPingPayload = internalAction({
  * and transforms each record. Does not write to the database.
  */
 export const processStressPushPayload = internalAction({
-    args: { payload: v.any() },
+    args: {
+        payload: v.any(),
+        // Only consumed by push processors; ping processors ignore it.
+        rawPassthrough: v.optional(v.boolean()),
+    },
     handler: async (ctx, args) => {
         const { stressDetails } = garminStressPushPayloadSchema.parse(args.payload);
         const items = [];
@@ -1003,7 +1127,9 @@ export const processStressPushPayload = internalAction({
             }
             for (const item of userItems) {
                 try {
-                    const data = transformStress(item);
+                    const data = args.rawPassthrough
+                        ? item
+                        : transformStress(item);
                     if (data == null)
                         continue;
                     items.push({ connectionId: connection._id, userId: connection.userId, data });
@@ -1026,7 +1152,11 @@ export const processStressPushPayload = internalAction({
  * Stub — acknowledges the notification without fetching data.
  */
 export const processStressPingPayload = internalAction({
-    args: { payload: v.any() },
+    args: {
+        payload: v.any(),
+        // Only consumed by push processors; ping processors ignore it.
+        rawPassthrough: v.optional(v.boolean()),
+    },
     handler: async (_ctx, args) => {
         const { stressDetails } = garminStressPingPayloadSchema.parse(args.payload);
         console.log(`[garmin:webhook:stressDetails] Ping mode not yet implemented, acknowledging ${stressDetails.length} items`);
@@ -1040,7 +1170,11 @@ export const processStressPingPayload = internalAction({
  * and transforms each record. Does not write to the database.
  */
 export const processSkinTemperaturePushPayload = internalAction({
-    args: { payload: v.any() },
+    args: {
+        payload: v.any(),
+        // Only consumed by push processors; ping processors ignore it.
+        rawPassthrough: v.optional(v.boolean()),
+    },
     handler: async (ctx, args) => {
         const { skinTemp } = garminSkinTemperaturePushPayloadSchema.parse(args.payload);
         const items = [];
@@ -1080,7 +1214,9 @@ export const processSkinTemperaturePushPayload = internalAction({
             }
             for (const item of userItems) {
                 try {
-                    const data = transformSkinTemperature(item);
+                    const data = args.rawPassthrough
+                        ? item
+                        : transformSkinTemperature(item);
                     if (data == null)
                         continue;
                     items.push({ connectionId: connection._id, userId: connection.userId, data });
@@ -1103,7 +1239,11 @@ export const processSkinTemperaturePushPayload = internalAction({
  * Stub — acknowledges the notification without fetching data.
  */
 export const processSkinTemperaturePingPayload = internalAction({
-    args: { payload: v.any() },
+    args: {
+        payload: v.any(),
+        // Only consumed by push processors; ping processors ignore it.
+        rawPassthrough: v.optional(v.boolean()),
+    },
     handler: async (_ctx, args) => {
         const { skinTemp } = garminSkinTemperaturePingPayloadSchema.parse(args.payload);
         console.log(`[garmin:webhook:skinTemperature] Ping mode not yet implemented, acknowledging ${skinTemp.length} items`);
@@ -1117,7 +1257,11 @@ export const processSkinTemperaturePingPayload = internalAction({
  * and transforms each sleep record. Does not write to the database.
  */
 export const processSleepsPushPayload = internalAction({
-    args: { payload: v.any() },
+    args: {
+        payload: v.any(),
+        // Only consumed by push processors; ping processors ignore it.
+        rawPassthrough: v.optional(v.boolean()),
+    },
     handler: async (ctx, args) => {
         const { sleeps } = garminSleepsPushPayloadSchema.parse(args.payload);
         const items = [];
@@ -1157,7 +1301,9 @@ export const processSleepsPushPayload = internalAction({
             }
             for (const item of userItems) {
                 try {
-                    const data = transformSleeps(item);
+                    const data = args.rawPassthrough
+                        ? item
+                        : transformSleeps(item);
                     items.push({ connectionId: connection._id, userId: connection.userId, data });
                 }
                 catch (err) {
@@ -1178,7 +1324,11 @@ export const processSleepsPushPayload = internalAction({
  * Stub — acknowledges the notification without fetching data.
  */
 export const processSleepsPingPayload = internalAction({
-    args: { payload: v.any() },
+    args: {
+        payload: v.any(),
+        // Only consumed by push processors; ping processors ignore it.
+        rawPassthrough: v.optional(v.boolean()),
+    },
     handler: async (_ctx, args) => {
         const { sleeps } = garminSleepsPingPayloadSchema.parse(args.payload);
         console.log(`[garmin:webhook:sleeps] Ping mode not yet implemented, acknowledging ${sleeps.length} items`);
@@ -1192,7 +1342,11 @@ export const processSleepsPingPayload = internalAction({
  * and transforms each user metrics record. Does not write to the database.
  */
 export const processUserMetricsPushPayload = internalAction({
-    args: { payload: v.any() },
+    args: {
+        payload: v.any(),
+        // Only consumed by push processors; ping processors ignore it.
+        rawPassthrough: v.optional(v.boolean()),
+    },
     handler: async (ctx, args) => {
         const { userMetrics } = garminUserMetricsPushPayloadSchema.parse(args.payload);
         const items = [];
@@ -1232,7 +1386,9 @@ export const processUserMetricsPushPayload = internalAction({
             }
             for (const item of userItems) {
                 try {
-                    const data = transformUserMetrics(item);
+                    const data = args.rawPassthrough
+                        ? item
+                        : transformUserMetrics(item);
                     if (data == null)
                         continue;
                     items.push({ connectionId: connection._id, userId: connection.userId, data });
@@ -1255,7 +1411,11 @@ export const processUserMetricsPushPayload = internalAction({
  * Stub — acknowledges the notification without fetching data.
  */
 export const processUserMetricsPingPayload = internalAction({
-    args: { payload: v.any() },
+    args: {
+        payload: v.any(),
+        // Only consumed by push processors; ping processors ignore it.
+        rawPassthrough: v.optional(v.boolean()),
+    },
     handler: async (_ctx, args) => {
         const { userMetrics } = garminUserMetricsPingPayloadSchema.parse(args.payload);
         console.log(`[garmin:webhook:userMetrics] Ping mode not yet implemented, acknowledging ${userMetrics.length} items`);
@@ -1269,7 +1429,11 @@ export const processUserMetricsPingPayload = internalAction({
  * and transforms each record. Does not write to the database.
  */
 export const processMenstrualCycleTrackingPushPayload = internalAction({
-    args: { payload: v.any() },
+    args: {
+        payload: v.any(),
+        // Only consumed by push processors; ping processors ignore it.
+        rawPassthrough: v.optional(v.boolean()),
+    },
     handler: async (ctx, args) => {
         const { mct } = garminMenstrualCycleTrackingPushPayloadSchema.parse(args.payload);
         const items = [];
@@ -1309,7 +1473,9 @@ export const processMenstrualCycleTrackingPushPayload = internalAction({
             }
             for (const item of userItems) {
                 try {
-                    const data = transformMenstrualCycleTracking(item);
+                    const data = args.rawPassthrough
+                        ? item
+                        : transformMenstrualCycleTracking(item);
                     items.push({ connectionId: connection._id, userId: connection.userId, data });
                 }
                 catch (err) {
@@ -1330,7 +1496,11 @@ export const processMenstrualCycleTrackingPushPayload = internalAction({
  * Stub — acknowledges the notification without fetching data.
  */
 export const processMenstrualCycleTrackingPingPayload = internalAction({
-    args: { payload: v.any() },
+    args: {
+        payload: v.any(),
+        // Only consumed by push processors; ping processors ignore it.
+        rawPassthrough: v.optional(v.boolean()),
+    },
     handler: async (_ctx, args) => {
         const { mct } = garminMenstrualCycleTrackingPingPayloadSchema.parse(args.payload);
         console.log(`[garmin:webhook:menstrualCycleTracking] Ping mode not yet implemented, acknowledging ${mct.length} items`);