@nativesquare/soma 0.7.3 → 0.9.0

package/src/component/garmin/schemas/activity.ts

@@ -0,0 +1,40 @@
+// ─── Activity Webhook Zod Schemas ───────────────────────────────────────────
+// Runtime validation schemas for Garmin Activity webhook payloads.
+//
+// The base schema (zClientActivity) is auto-generated from the OpenAPI spec.
+// We extend it here with webhook-specific fields (userId, userAccessToken)
+
+import { z } from "zod";
+import { zClientActivity } from "../types/wellnessApi/zod.gen.js";
+
+// ─── Push Mode ──────────────────────────────────────────────────────────────
+// Push payloads contain full activity data plus webhook envelope fields.
+
+export const garminActivityPushItemSchema = zClientActivity.extend({
+  // Webhook envelope fields
+  userId: z.string(),
+  userAccessToken: z.string().optional(),
+  // Override bigint → number (openapi-ts maps int64 to bigint in zod)
+  activityId: z.coerce.number().optional(),
+});
+
+export const garminActivityPushPayloadSchema = z.object({
+  activities: z.array(garminActivityPushItemSchema),
+});
+
+// ─── Ping Mode ──────────────────────────────────────────────────────────────
+// Ping payloads are lightweight notifications — not in any OpenAPI spec.
+
+export const garminActivityPingItemSchema = z.object({
+  userId: z.string(),
+  callbackURL: z.string().optional(), // absent for deregistration notifications
+});
+
+export const garminActivityPingPayloadSchema = z.object({
+  activities: z.array(garminActivityPingItemSchema),
+});
+
+// ─── Inferred Types ─────────────────────────────────────────────────────────
+
+export type GarminActivityPushItem = z.infer<typeof garminActivityPushItemSchema>;
+export type GarminActivityPingItem = z.infer<typeof garminActivityPingItemSchema>;

package/src/component/garmin/schemas/activityDetails.ts

@@ -0,0 +1,45 @@
+// ─── Activity Details Webhook Zod Schemas ────────────────────────────────────
+// Runtime validation schemas for Garmin Activity Details webhook payloads.
+//
+// The base schema (zClientActivityDetail) is auto-generated from the OpenAPI spec.
+// We extend it here with webhook-specific fields (userId required, userAccessToken).
+
+import { z } from "zod";
+import { zClientActivity, zClientActivityDetail } from "../types/wellnessApi/zod.gen.js";
+
+// ─── Push Mode ──────────────────────────────────────────────────────────────
+// Push payloads contain full activity detail data plus webhook envelope fields.
+
+export const garminActivityDetailsPushItemSchema = zClientActivityDetail.extend({
+  // Webhook envelope fields — userId is required in push payloads
+  userId: z.string(),
+  userAccessToken: z.string().optional(),
+  // Override bigint → number (openapi-ts maps int64 to bigint in zod)
+  activityId: z.coerce.number().optional(),
+  summary: zClientActivity.extend({ activityId: z.coerce.number().optional() }).optional(),
+});
+
+export const garminActivityDetailsPushPayloadSchema = z.object({
+  activityDetails: z.array(garminActivityDetailsPushItemSchema),
+});
+
+// ─── Ping Mode ──────────────────────────────────────────────────────────────
+// Ping payloads are lightweight notifications — not in any OpenAPI spec.
+
+export const garminActivityDetailsPingItemSchema = z.object({
+  userId: z.string(),
+  callbackURL: z.string().optional(), // absent for deregistration notifications
+});
+
+export const garminActivityDetailsPingPayloadSchema = z.object({
+  activityDetails: z.array(garminActivityDetailsPingItemSchema),
+});
+
+// ─── Inferred Types ─────────────────────────────────────────────────────────
+
+export type GarminActivityDetailsPushItem = z.infer<
+  typeof garminActivityDetailsPushItemSchema
+>;
+export type GarminActivityDetailsPingItem = z.infer<
+  typeof garminActivityDetailsPingItemSchema
+>;

package/src/component/garmin/schemas/bloodPressure.ts

@@ -0,0 +1,38 @@
+// ─── Blood Pressure Webhook Zod Schemas ──────────────────────────────────────
+// Runtime validation schemas for Garmin Blood Pressure webhook payloads.
+//
+// The base schema (zClientBloodPressure) is auto-generated from the OpenAPI spec.
+// We extend it here with webhook-specific fields (userId, userAccessToken)
+
+import { z } from "zod";
+import { zClientBloodPressure } from "../types/wellnessApi/zod.gen.js";
+
+// ─── Push Mode ──────────────────────────────────────────────────────────────
+// Push payloads contain full blood pressure data plus webhook envelope fields.
+
+export const garminBloodPressurePushItemSchema = zClientBloodPressure.extend({
+  // Webhook envelope fields
+  userId: z.string(),
+  userAccessToken: z.string().optional(),
+});
+
+export const garminBloodPressurePushPayloadSchema = z.object({
+  bloodPressures: z.array(garminBloodPressurePushItemSchema),
+});
+
+// ─── Ping Mode ──────────────────────────────────────────────────────────────
+// Ping payloads are lightweight notifications — not in any OpenAPI spec.
+
+export const garminBloodPressurePingItemSchema = z.object({
+  userId: z.string(),
+  callbackURL: z.string().optional(), // absent for deregistration notifications
+});
+
+export const garminBloodPressurePingPayloadSchema = z.object({
+  bloodPressures: z.array(garminBloodPressurePingItemSchema),
+});
+
+// ─── Inferred Types ─────────────────────────────────────────────────────────
+
+export type GarminBloodPressurePushItem = z.infer<typeof garminBloodPressurePushItemSchema>;
+export type GarminBloodPressurePingItem = z.infer<typeof garminBloodPressurePingItemSchema>;

package/src/component/garmin/schemas/bodyCompositions.ts

@@ -0,0 +1,38 @@
+// ─── Body Compositions Webhook Zod Schemas ───────────────────────────────────
+// Runtime validation schemas for Garmin Body Composition webhook payloads.
+//
+// The base schema (zClientBodyComp) is auto-generated from the OpenAPI spec.
+// We extend it here with webhook-specific fields (userId, userAccessToken)
+
+import { z } from "zod";
+import { zClientBodyComp } from "../types/wellnessApi/zod.gen.js";
+
+// ─── Push Mode ──────────────────────────────────────────────────────────────
+// Push payloads contain full body composition data plus webhook envelope fields.
+
+export const garminBodyCompositionsPushItemSchema = zClientBodyComp.extend({
+  // Webhook envelope fields
+  userId: z.string(),
+  userAccessToken: z.string().optional(),
+});
+
+export const garminBodyCompositionsPushPayloadSchema = z.object({
+  bodyComps: z.array(garminBodyCompositionsPushItemSchema),
+});
+
+// ─── Ping Mode ──────────────────────────────────────────────────────────────
+// Ping payloads are lightweight notifications — not in any OpenAPI spec.
+
+export const garminBodyCompositionsPingItemSchema = z.object({
+  userId: z.string(),
+  callbackURL: z.string().optional(), // absent for deregistration notifications
+});
+
+export const garminBodyCompositionsPingPayloadSchema = z.object({
+  bodyComps: z.array(garminBodyCompositionsPingItemSchema),
+});
+
+// ─── Inferred Types ─────────────────────────────────────────────────────────
+
+export type GarminBodyCompositionsPushItem = z.infer<typeof garminBodyCompositionsPushItemSchema>;
+export type GarminBodyCompositionsPingItem = z.infer<typeof garminBodyCompositionsPingItemSchema>;

package/src/component/garmin/schemas/dailies.ts

@@ -0,0 +1,38 @@
+// ─── Dailies Webhook Zod Schemas ─────────────────────────────────────────────
+// Runtime validation schemas for Garmin Daily Summary webhook payloads.
+//
+// The base schema (zClientDaily) is auto-generated from the OpenAPI spec.
+// We extend it here with webhook-specific fields (userId, userAccessToken)
+
+import { z } from "zod";
+import { zClientDaily } from "../types/wellnessApi/zod.gen.js";
+
+// ─── Push Mode ──────────────────────────────────────────────────────────────
+// Push payloads contain full daily summary data plus webhook envelope fields.
+
+export const garminDailiesPushItemSchema = zClientDaily.extend({
+  // Webhook envelope fields
+  userId: z.string(),
+  userAccessToken: z.string().optional(),
+});
+
+export const garminDailiesPushPayloadSchema = z.object({
+  dailies: z.array(garminDailiesPushItemSchema),
+});
+
+// ─── Ping Mode ──────────────────────────────────────────────────────────────
+// Ping payloads are lightweight notifications — not in any OpenAPI spec.
+
+export const garminDailiesPingItemSchema = z.object({
+  userId: z.string(),
+  callbackURL: z.string().optional(), // absent for deregistration notifications
+});
+
+export const garminDailiesPingPayloadSchema = z.object({
+  dailies: z.array(garminDailiesPingItemSchema),
+});
+
+// ─── Inferred Types ─────────────────────────────────────────────────────────
+
+export type GarminDailiesPushItem = z.infer<typeof garminDailiesPushItemSchema>;
+export type GarminDailiesPingItem = z.infer<typeof garminDailiesPingItemSchema>;

package/src/component/garmin/schemas/epochs.ts

@@ -0,0 +1,38 @@
+// ─── Epochs Webhook Zod Schemas ──────────────────────────────────────────────
+// Runtime validation schemas for Garmin Epoch Summary webhook payloads.
+//
+// The base schema (zClientEpoch) is auto-generated from the OpenAPI spec.
+// We extend it here with webhook-specific fields (userId, userAccessToken)
+
+import { z } from "zod";
+import { zClientEpoch } from "../types/wellnessApi/zod.gen.js";
+
+// ─── Push Mode ──────────────────────────────────────────────────────────────
+// Push payloads contain full epoch summary data plus webhook envelope fields.
+
+export const garminEpochPushItemSchema = zClientEpoch.extend({
+  // Webhook envelope fields
+  userId: z.string(),
+  userAccessToken: z.string().optional(),
+});
+
+export const garminEpochPushPayloadSchema = z.object({
+  epochs: z.array(garminEpochPushItemSchema),
+});
+
+// ─── Ping Mode ──────────────────────────────────────────────────────────────
+// Ping payloads are lightweight notifications — not in any OpenAPI spec.
+
+export const garminEpochPingItemSchema = z.object({
+  userId: z.string(),
+  callbackURL: z.string().optional(), // absent for deregistration notifications
+});
+
+export const garminEpochPingPayloadSchema = z.object({
+  epochs: z.array(garminEpochPingItemSchema),
+});
+
+// ─── Inferred Types ─────────────────────────────────────────────────────────
+
+export type GarminEpochPushItem = z.infer<typeof garminEpochPushItemSchema>;
+export type GarminEpochPingItem = z.infer<typeof garminEpochPingItemSchema>;

package/src/component/garmin/schemas/healthSnapshot.ts

@@ -0,0 +1,38 @@
+// ─── Health Snapshot Webhook Zod Schemas ─────────────────────────────────────
+// Runtime validation schemas for Garmin Health Snapshot webhook payloads.
+//
+// The base schema (zClientHealthSnapshot) is auto-generated from the OpenAPI spec.
+// We extend it here with webhook-specific fields (userId, userAccessToken)
+
+import { z } from "zod";
+import { zClientHealthSnapshot } from "../types/wellnessApi/zod.gen.js";
+
+// ─── Push Mode ──────────────────────────────────────────────────────────────
+// Push payloads contain full health snapshot data plus webhook envelope fields.
+
+export const garminHealthSnapshotPushItemSchema = zClientHealthSnapshot.extend({
+  // Webhook envelope fields
+  userId: z.string(),
+  userAccessToken: z.string().optional(),
+});
+
+export const garminHealthSnapshotPushPayloadSchema = z.object({
+  healthSnapshot: z.array(garminHealthSnapshotPushItemSchema),
+});
+
+// ─── Ping Mode ──────────────────────────────────────────────────────────────
+// Ping payloads are lightweight notifications — not in any OpenAPI spec.
+
+export const garminHealthSnapshotPingItemSchema = z.object({
+  userId: z.string(),
+  callbackURL: z.string().optional(), // absent for deregistration notifications
+});
+
+export const garminHealthSnapshotPingPayloadSchema = z.object({
+  healthSnapshot: z.array(garminHealthSnapshotPingItemSchema),
+});
+
+// ─── Inferred Types ─────────────────────────────────────────────────────────
+
+export type GarminHealthSnapshotPushItem = z.infer<typeof garminHealthSnapshotPushItemSchema>;
+export type GarminHealthSnapshotPingItem = z.infer<typeof garminHealthSnapshotPingItemSchema>;

package/src/component/garmin/schemas/hrvSummary.ts

@@ -0,0 +1,38 @@
+// ─── HRV Summary Webhook Zod Schemas ─────────────────────────────────────────
+// Runtime validation schemas for Garmin HRV Summary webhook payloads.
+//
+// The base schema (zClientHrvSummary) is auto-generated from the OpenAPI spec.
+// We extend it here with webhook-specific fields (userId, userAccessToken)
+
+import { z } from "zod";
+import { zClientHrvSummary } from "../types/wellnessApi/zod.gen.js";
+
+// ─── Push Mode ──────────────────────────────────────────────────────────────
+// Push payloads contain full HRV summary data plus webhook envelope fields.
+
+export const garminHRVSummaryPushItemSchema = zClientHrvSummary.extend({
+  // Webhook envelope fields — userId is required in push mode
+  userId: z.string(),
+  userAccessToken: z.string().optional(),
+});
+
+export const garminHRVSummaryPushPayloadSchema = z.object({
+  hrv: z.array(garminHRVSummaryPushItemSchema),
+});
+
+// ─── Ping Mode ──────────────────────────────────────────────────────────────
+// Ping payloads are lightweight notifications — not in any OpenAPI spec.
+
+export const garminHRVSummaryPingItemSchema = z.object({
+  userId: z.string(),
+  callbackURL: z.string().optional(), // absent for deregistration notifications
+});
+
+export const garminHRVSummaryPingPayloadSchema = z.object({
+  hrv: z.array(garminHRVSummaryPingItemSchema),
+});
+
+// ─── Inferred Types ─────────────────────────────────────────────────────────
+
+export type GarminHRVSummaryPushItem = z.infer<typeof garminHRVSummaryPushItemSchema>;
+export type GarminHRVSummaryPingItem = z.infer<typeof garminHRVSummaryPingItemSchema>;

package/src/component/garmin/schemas/manuallyUpdatedActivities.ts

@@ -0,0 +1,49 @@
+// ─── Manually Updated Activities Webhook Zod Schemas ────────────────────────
+// Runtime validation schemas for Garmin Manually Updated Activities webhook payloads.
+//
+// Manually updated activities share the same data model as regular activities
+// (zClientActivity), but are always manual edits from Garmin Connect.
+
+import { z } from "zod";
+import { zClientActivity } from "../types/wellnessApi/zod.gen.js";
+
+// ─── Push Mode ──────────────────────────────────────────────────────────────
+// Push payloads contain full activity data plus webhook envelope fields.
+
+export const garminManuallyUpdatedActivitiesPushItemSchema =
+  zClientActivity.extend({
+    // Webhook envelope fields
+    userId: z.string(),
+    userAccessToken: z.string().optional(),
+    // Override bigint → number (openapi-ts maps int64 to bigint in zod)
+    activityId: z.coerce.number().optional(),
+  });
+
+export const garminManuallyUpdatedActivitiesPushPayloadSchema = z.object({
+  manuallyUpdatedActivities: z.array(
+    garminManuallyUpdatedActivitiesPushItemSchema,
+  ),
+});
+
+// ─── Ping Mode ──────────────────────────────────────────────────────────────
+// Ping payloads are lightweight notifications — not in any OpenAPI spec.
+
+export const garminManuallyUpdatedActivitiesPingItemSchema = z.object({
+  userId: z.string(),
+  callbackURL: z.string().optional(), // absent for deregistration notifications
+});
+
+export const garminManuallyUpdatedActivitiesPingPayloadSchema = z.object({
+  manuallyUpdatedActivities: z.array(
+    garminManuallyUpdatedActivitiesPingItemSchema,
+  ),
+});
+
+// ─── Inferred Types ─────────────────────────────────────────────────────────
+
+export type GarminManuallyUpdatedActivitiesPushItem = z.infer<
+  typeof garminManuallyUpdatedActivitiesPushItemSchema
+>;
+export type GarminManuallyUpdatedActivitiesPingItem = z.infer<
+  typeof garminManuallyUpdatedActivitiesPingItemSchema
+>;

package/src/component/garmin/schemas/menstrualCycleTracking.ts

@@ -0,0 +1,39 @@
+// ─── Menstrual Cycle Tracking Webhook Zod Schemas ─────────────────────────────
+// Runtime validation schemas for Garmin MCT (Women's Health API) webhook payloads.
+//
+// The base schema (zClientSummarizedMenstrualCycle) is auto-generated from the
+// OpenAPI spec. We extend it here with webhook-specific fields (userId,
+// userAccessToken).
+
+import { z } from "zod";
+import { zClientSummarizedMenstrualCycle } from "../types/wellnessApi/zod.gen.js";
+
+// ─── Push Mode ──────────────────────────────────────────────────────────────
+// Push payloads contain full MCT data plus webhook envelope fields.
+
+export const garminMenstrualCycleTrackingPushItemSchema = zClientSummarizedMenstrualCycle.extend({
+  // Webhook envelope fields
+  userId: z.string(),
+  userAccessToken: z.string().optional(),
+});
+
+export const garminMenstrualCycleTrackingPushPayloadSchema = z.object({
+  mct: z.array(garminMenstrualCycleTrackingPushItemSchema),
+});
+
+// ─── Ping Mode ──────────────────────────────────────────────────────────────
+// Ping payloads are lightweight notifications — not in any OpenAPI spec.
+
+export const garminMenstrualCycleTrackingPingItemSchema = z.object({
+  userId: z.string(),
+  callbackURL: z.string().optional(), // absent for deregistration notifications
+});
+
+export const garminMenstrualCycleTrackingPingPayloadSchema = z.object({
+  mct: z.array(garminMenstrualCycleTrackingPingItemSchema),
+});
+
+// ─── Inferred Types ─────────────────────────────────────────────────────────
+
+export type GarminMenstrualCycleTrackingPushItem = z.infer<typeof garminMenstrualCycleTrackingPushItemSchema>;
+export type GarminMenstrualCycleTrackingPingItem = z.infer<typeof garminMenstrualCycleTrackingPingItemSchema>;

package/src/component/garmin/schemas/moveIQ.ts

@@ -0,0 +1,38 @@
+// ─── Move IQ Webhook Zod Schemas ─────────────────────────────────────────────
+// Runtime validation schemas for Garmin Move IQ webhook payloads.
+//
+// The base schema (zClientAutoActivityMoveIq) is auto-generated from the OpenAPI spec.
+// We extend it here with webhook-specific fields (userId required, userAccessToken).
+
+import { z } from "zod";
+import { zClientAutoActivityMoveIq } from "../types/wellnessApi/zod.gen.js";
+
+// ─── Push Mode ──────────────────────────────────────────────────────────────
+// Push payloads contain full Move IQ data plus webhook envelope fields.
+
+export const garminMoveIQPushItemSchema = zClientAutoActivityMoveIq.extend({
+  // Webhook envelope fields — userId is required in push payloads
+  userId: z.string(),
+  userAccessToken: z.string().optional(),
+});
+
+export const garminMoveIQPushPayloadSchema = z.object({
+  moveIQActivities: z.array(garminMoveIQPushItemSchema),
+});
+
+// ─── Ping Mode ──────────────────────────────────────────────────────────────
+// Ping payloads are lightweight notifications — not in any OpenAPI spec.
+
+export const garminMoveIQPingItemSchema = z.object({
+  userId: z.string(),
+  callbackURL: z.string().optional(), // absent for deregistration notifications
+});
+
+export const garminMoveIQPingPayloadSchema = z.object({
+  moveIQActivities: z.array(garminMoveIQPingItemSchema),
+});
+
+// ─── Inferred Types ─────────────────────────────────────────────────────────
+
+export type GarminMoveIQPushItem = z.infer<typeof garminMoveIQPushItemSchema>;
+export type GarminMoveIQPingItem = z.infer<typeof garminMoveIQPingItemSchema>;

package/src/component/garmin/schemas/pulseOx.ts

@@ -0,0 +1,39 @@
+// ─── Pulse Ox Webhook Zod Schemas ────────────────────────────────────────────
+// Runtime validation schemas for Garmin Pulse Ox webhook payloads.
+//
+// The base schema (zClientDailySpo2Acclimation) is auto-generated from the
+// OpenAPI spec. We extend it here with webhook-specific fields (userId,
+// userAccessToken).
+
+import { z } from "zod";
+import { zClientDailySpo2Acclimation } from "../types/wellnessApi/zod.gen.js";
+
+// ─── Push Mode ──────────────────────────────────────────────────────────────
+// Push payloads contain full pulse ox data plus webhook envelope fields.
+
+export const garminPulseOxPushItemSchema = zClientDailySpo2Acclimation.extend({
+  // Webhook envelope fields
+  userId: z.string(),
+  userAccessToken: z.string().optional(),
+});
+
+export const garminPulseOxPushPayloadSchema = z.object({
+  pulseox: z.array(garminPulseOxPushItemSchema),
+});
+
+// ─── Ping Mode ──────────────────────────────────────────────────────────────
+// Ping payloads are lightweight notifications — not in any OpenAPI spec.
+
+export const garminPulseOxPingItemSchema = z.object({
+  userId: z.string(),
+  callbackURL: z.string().optional(), // absent for deregistration notifications
+});
+
+export const garminPulseOxPingPayloadSchema = z.object({
+  pulseox: z.array(garminPulseOxPingItemSchema),
+});
+
+// ─── Inferred Types ─────────────────────────────────────────────────────────
+
+export type GarminPulseOxPushItem = z.infer<typeof garminPulseOxPushItemSchema>;
+export type GarminPulseOxPingItem = z.infer<typeof garminPulseOxPingItemSchema>;

package/src/component/garmin/schemas/respiration.ts

@@ -0,0 +1,39 @@
+// ─── Respiration Webhook Zod Schemas ─────────────────────────────────────────
+// Runtime validation schemas for Garmin Respiration webhook payloads.
+//
+// The base schema (zClientRespiration) is auto-generated from the
+// OpenAPI spec. We extend it here with webhook-specific fields (userId,
+// userAccessToken).
+
+import { z } from "zod";
+import { zClientRespiration } from "../types/wellnessApi/zod.gen.js";
+
+// ─── Push Mode ──────────────────────────────────────────────────────────────
+// Push payloads contain full respiration data plus webhook envelope fields.
+
+export const garminRespirationPushItemSchema = zClientRespiration.extend({
+  // Webhook envelope fields
+  userId: z.string(),
+  userAccessToken: z.string().optional(),
+});
+
+export const garminRespirationPushPayloadSchema = z.object({
+  allDayRespiration: z.array(garminRespirationPushItemSchema),
+});
+
+// ─── Ping Mode ──────────────────────────────────────────────────────────────
+// Ping payloads are lightweight notifications — not in any OpenAPI spec.
+
+export const garminRespirationPingItemSchema = z.object({
+  userId: z.string(),
+  callbackURL: z.string().optional(), // absent for deregistration notifications
+});
+
+export const garminRespirationPingPayloadSchema = z.object({
+  allDayRespiration: z.array(garminRespirationPingItemSchema),
+});
+
+// ─── Inferred Types ─────────────────────────────────────────────────────────
+
+export type GarminRespirationPushItem = z.infer<typeof garminRespirationPushItemSchema>;
+export type GarminRespirationPingItem = z.infer<typeof garminRespirationPingItemSchema>;

package/src/component/garmin/schemas/skinTemperature.ts

@@ -0,0 +1,39 @@
+// ─── Skin Temperature Webhook Zod Schemas ────────────────────────────────────
+// Runtime validation schemas for Garmin Skin Temperature webhook payloads.
+//
+// The base schema (zClientSkinTemp) is auto-generated from the
+// OpenAPI spec. We extend it here with webhook-specific fields (userId,
+// userAccessToken).
+
+import { z } from "zod";
+import { zClientSkinTemp } from "../types/wellnessApi/zod.gen.js";
+
+// ─── Push Mode ──────────────────────────────────────────────────────────────
+// Push payloads contain full skin temperature data plus webhook envelope fields.
+
+export const garminSkinTemperaturePushItemSchema = zClientSkinTemp.extend({
+  // Webhook envelope fields
+  userId: z.string(),
+  userAccessToken: z.string().optional(),
+});
+
+export const garminSkinTemperaturePushPayloadSchema = z.object({
+  skinTemp: z.array(garminSkinTemperaturePushItemSchema),
+});
+
+// ─── Ping Mode ──────────────────────────────────────────────────────────────
+// Ping payloads are lightweight notifications — not in any OpenAPI spec.
+
+export const garminSkinTemperaturePingItemSchema = z.object({
+  userId: z.string(),
+  callbackURL: z.string().optional(), // absent for deregistration notifications
+});
+
+export const garminSkinTemperaturePingPayloadSchema = z.object({
+  skinTemp: z.array(garminSkinTemperaturePingItemSchema),
+});
+
+// ─── Inferred Types ─────────────────────────────────────────────────────────
+
+export type GarminSkinTemperaturePushItem = z.infer<typeof garminSkinTemperaturePushItemSchema>;
+export type GarminSkinTemperaturePingItem = z.infer<typeof garminSkinTemperaturePingItemSchema>;

package/src/component/garmin/schemas/sleeps.ts

@@ -0,0 +1,38 @@
+// ─── Sleeps Webhook Zod Schemas ──────────────────────────────────────────────
+// Runtime validation schemas for Garmin Sleep Summary webhook payloads.
+//
+// The base schema (zClientSleep) is auto-generated from the OpenAPI spec.
+// We extend it here with webhook-specific fields (userId, userAccessToken)
+
+import { z } from "zod";
+import { zClientSleep } from "../types/wellnessApi/zod.gen.js";
+
+// ─── Push Mode ──────────────────────────────────────────────────────────────
+// Push payloads contain full sleep summary data plus webhook envelope fields.
+
+export const garminSleepsPushItemSchema = zClientSleep.extend({
+  // Webhook envelope fields
+  userId: z.string(),
+  userAccessToken: z.string().optional(),
+});
+
+export const garminSleepsPushPayloadSchema = z.object({
+  sleeps: z.array(garminSleepsPushItemSchema),
+});
+
+// ─── Ping Mode ──────────────────────────────────────────────────────────────
+// Ping payloads are lightweight notifications — not in any OpenAPI spec.
+
+export const garminSleepsPingItemSchema = z.object({
+  userId: z.string(),
+  callbackURL: z.string().optional(), // absent for deregistration notifications
+});
+
+export const garminSleepsPingPayloadSchema = z.object({
+  sleeps: z.array(garminSleepsPingItemSchema),
+});
+
+// ─── Inferred Types ─────────────────────────────────────────────────────────
+
+export type GarminSleepsPushItem = z.infer<typeof garminSleepsPushItemSchema>;
+export type GarminSleepsPingItem = z.infer<typeof garminSleepsPingItemSchema>;