@nativesquare/soma 0.16.2 → 0.16.3

package/src/component/_generated/api.ts

@@ -56,6 +56,7 @@ import type * as garmin_types_wellnessApi_index from "../garmin/types/wellnessAp
 import type * as garmin_utils from "../garmin/utils.js";
 import type * as garmin_webhooks from "../garmin/webhooks.js";
 import type * as healthkit_index from "../healthkit/index.js";
+import type * as healthkit_public from "../healthkit/public.js";
 import type * as healthkit_transform_activity from "../healthkit/transform/activity.js";
 import type * as healthkit_transform_athlete from "../healthkit/transform/athlete.js";
 import type * as healthkit_transform_body from "../healthkit/transform/body.js";
@@ -68,6 +69,7 @@ import type * as healthkit_transform_nutrition from "../healthkit/transform/nutr
 import type * as healthkit_transform_sleep from "../healthkit/transform/sleep.js";
 import type * as healthkit_transform_utils from "../healthkit/transform/utils.js";
 import type * as healthkit_types from "../healthkit/types.js";
+import type * as healthkit_validators from "../healthkit/validators.js";
 import type * as private_ from "../private.js";
 import type * as public_ from "../public.js";
 import type * as strava_auth from "../strava/auth.js";
@@ -151,6 +153,7 @@ const fullApi: ApiFromModules<{
   "garmin/utils": typeof garmin_utils;
   "garmin/webhooks": typeof garmin_webhooks;
   "healthkit/index": typeof healthkit_index;
+  "healthkit/public": typeof healthkit_public;
   "healthkit/transform/activity": typeof healthkit_transform_activity;
   "healthkit/transform/athlete": typeof healthkit_transform_athlete;
   "healthkit/transform/body": typeof healthkit_transform_body;
@@ -163,6 +166,7 @@ const fullApi: ApiFromModules<{
   "healthkit/transform/sleep": typeof healthkit_transform_sleep;
   "healthkit/transform/utils": typeof healthkit_transform_utils;
   "healthkit/types": typeof healthkit_types;
+  "healthkit/validators": typeof healthkit_validators;
   private: typeof private_;
   public: typeof public_;
   "strava/auth": typeof strava_auth;

package/src/component/_generated/component.ts

@@ -407,6 +407,418 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
         >;
       };
     };
+    healthkit: {
+      public: {
+        connect: FunctionReference<
+          "mutation",
+          "internal",
+          { userId: string },
+          string,
+          Name
+        >;
+        disconnect: FunctionReference<
+          "mutation",
+          "internal",
+          { userId: string },
+          null,
+          Name
+        >;
+        syncActivities: FunctionReference<
+          "mutation",
+          "internal",
+          {
+            userId: string;
+            workouts: Array<{
+              device?: {
+                hardwareVersion?: string;
+                manufacturer?: string;
+                model?: string;
+                name?: string;
+                softwareVersion?: string;
+              };
+              duration: number;
+              endDate: string;
+              heartRateSamples?: Array<{
+                device?: {
+                  hardwareVersion?: string;
+                  manufacturer?: string;
+                  model?: string;
+                  name?: string;
+                  softwareVersion?: string;
+                };
+                endDate: string;
+                sampleType: string;
+                source?: { bundleIdentifier: string; name: string };
+                startDate: string;
+                unit: string;
+                uuid: string;
+                value: number;
+              }>;
+              routeData?: Array<{
+                locations: Array<{
+                  altitude?: number;
+                  latitude: number;
+                  longitude: number;
+                  timestamp: string;
+                }>;
+              }>;
+              source?: { bundleIdentifier: string; name: string };
+              startDate: string;
+              totalDistance?: number;
+              totalEnergyBurned?: number;
+              totalFlightsClimbed?: number;
+              totalSwimmingStrokeCount?: number;
+              uuid: string;
+              workoutActivityType: number;
+            }>;
+          },
+          {
+            data: { activities: number };
+            errors: Array<{ id: string; message: string; type: string }>;
+          },
+          Name
+        >;
+        syncAll: FunctionReference<
+          "mutation",
+          "internal",
+          {
+            bodySamples?: Array<{
+              device?: {
+                hardwareVersion?: string;
+                manufacturer?: string;
+                model?: string;
+                name?: string;
+                softwareVersion?: string;
+              };
+              endDate: string;
+              sampleType: string;
+              source?: { bundleIdentifier: string; name: string };
+              startDate: string;
+              unit: string;
+              uuid: string;
+              value: number;
+            }>;
+            bodyTimeRange?: { end_time: string; start_time: string };
+            characteristics?: {
+              biologicalSex?: "female" | "male" | "other" | "notSet";
+              bloodType?: string;
+              dateOfBirth?: string;
+              fitzpatrickSkinType?: number;
+              wheelchairUse?: boolean;
+            };
+            dailySamples?: Array<{
+              device?: {
+                hardwareVersion?: string;
+                manufacturer?: string;
+                model?: string;
+                name?: string;
+                softwareVersion?: string;
+              };
+              endDate: string;
+              sampleType: string;
+              source?: { bundleIdentifier: string; name: string };
+              startDate: string;
+              unit: string;
+              uuid: string;
+              value: number;
+            }>;
+            dailySummaries?: Array<{
+              activeEnergyBurned: number;
+              activeEnergyBurnedGoal: number;
+              appleExerciseTime: number;
+              appleExerciseTimeGoal: number;
+              appleStandHours: number;
+              appleStandHoursGoal: number;
+              dateComponents: { day: number; month: number; year: number };
+            }>;
+            dailyTimeRange?: { end_time: string; start_time: string };
+            menstruationSamples?: Array<{
+              device?: {
+                hardwareVersion?: string;
+                manufacturer?: string;
+                model?: string;
+                name?: string;
+                softwareVersion?: string;
+              };
+              endDate: string;
+              sampleType: string;
+              source?: { bundleIdentifier: string; name: string };
+              startDate: string;
+              uuid: string;
+              value: number;
+            }>;
+            menstruationTimeRange?: { end_time: string; start_time: string };
+            nutritionSamples?: Array<{
+              device?: {
+                hardwareVersion?: string;
+                manufacturer?: string;
+                model?: string;
+                name?: string;
+                softwareVersion?: string;
+              };
+              endDate: string;
+              sampleType: string;
+              source?: { bundleIdentifier: string; name: string };
+              startDate: string;
+              unit: string;
+              uuid: string;
+              value: number;
+            }>;
+            nutritionTimeRange?: { end_time: string; start_time: string };
+            sleepSessions?: Array<
+              Array<{
+                device?: {
+                  hardwareVersion?: string;
+                  manufacturer?: string;
+                  model?: string;
+                  name?: string;
+                  softwareVersion?: string;
+                };
+                endDate: string;
+                sampleType: string;
+                source?: { bundleIdentifier: string; name: string };
+                startDate: string;
+                uuid: string;
+                value: number;
+              }>
+            >;
+            userId: string;
+            workouts?: Array<{
+              device?: {
+                hardwareVersion?: string;
+                manufacturer?: string;
+                model?: string;
+                name?: string;
+                softwareVersion?: string;
+              };
+              duration: number;
+              endDate: string;
+              heartRateSamples?: Array<{
+                device?: {
+                  hardwareVersion?: string;
+                  manufacturer?: string;
+                  model?: string;
+                  name?: string;
+                  softwareVersion?: string;
+                };
+                endDate: string;
+                sampleType: string;
+                source?: { bundleIdentifier: string; name: string };
+                startDate: string;
+                unit: string;
+                uuid: string;
+                value: number;
+              }>;
+              routeData?: Array<{
+                locations: Array<{
+                  altitude?: number;
+                  latitude: number;
+                  longitude: number;
+                  timestamp: string;
+                }>;
+              }>;
+              source?: { bundleIdentifier: string; name: string };
+              startDate: string;
+              totalDistance?: number;
+              totalEnergyBurned?: number;
+              totalFlightsClimbed?: number;
+              totalSwimmingStrokeCount?: number;
+              uuid: string;
+              workoutActivityType: number;
+            }>;
+          },
+          {
+            data: Record<string, number>;
+            errors: Array<{ id: string; message: string; type: string }>;
+          },
+          Name
+        >;
+        syncAthlete: FunctionReference<
+          "mutation",
+          "internal",
+          {
+            characteristics: {
+              biologicalSex?: "female" | "male" | "other" | "notSet";
+              bloodType?: string;
+              dateOfBirth?: string;
+              fitzpatrickSkinType?: number;
+              wheelchairUse?: boolean;
+            };
+            userId: string;
+          },
+          {
+            data: { athletes: number };
+            errors: Array<{ id: string; message: string; type: string }>;
+          },
+          Name
+        >;
+        syncBody: FunctionReference<
+          "mutation",
+          "internal",
+          {
+            samples: Array<{
+              device?: {
+                hardwareVersion?: string;
+                manufacturer?: string;
+                model?: string;
+                name?: string;
+                softwareVersion?: string;
+              };
+              endDate: string;
+              sampleType: string;
+              source?: { bundleIdentifier: string; name: string };
+              startDate: string;
+              unit: string;
+              uuid: string;
+              value: number;
+            }>;
+            timeRange?: { end_time: string; start_time: string };
+            userId: string;
+          },
+          {
+            data: { body: number };
+            errors: Array<{ id: string; message: string; type: string }>;
+          },
+          Name
+        >;
+        syncDaily: FunctionReference<
+          "mutation",
+          "internal",
+          {
+            samples: Array<{
+              device?: {
+                hardwareVersion?: string;
+                manufacturer?: string;
+                model?: string;
+                name?: string;
+                softwareVersion?: string;
+              };
+              endDate: string;
+              sampleType: string;
+              source?: { bundleIdentifier: string; name: string };
+              startDate: string;
+              unit: string;
+              uuid: string;
+              value: number;
+            }>;
+            timeRange?: { end_time: string; start_time: string };
+            userId: string;
+          },
+          {
+            data: { daily: number };
+            errors: Array<{ id: string; message: string; type: string }>;
+          },
+          Name
+        >;
+        syncDailyFromSummary: FunctionReference<
+          "mutation",
+          "internal",
+          {
+            summaries: Array<{
+              activeEnergyBurned: number;
+              activeEnergyBurnedGoal: number;
+              appleExerciseTime: number;
+              appleExerciseTimeGoal: number;
+              appleStandHours: number;
+              appleStandHoursGoal: number;
+              dateComponents: { day: number; month: number; year: number };
+            }>;
+            userId: string;
+          },
+          {
+            data: { daily: number };
+            errors: Array<{ id: string; message: string; type: string }>;
+          },
+          Name
+        >;
+        syncMenstruation: FunctionReference<
+          "mutation",
+          "internal",
+          {
+            samples: Array<{
+              device?: {
+                hardwareVersion?: string;
+                manufacturer?: string;
+                model?: string;
+                name?: string;
+                softwareVersion?: string;
+              };
+              endDate: string;
+              sampleType: string;
+              source?: { bundleIdentifier: string; name: string };
+              startDate: string;
+              uuid: string;
+              value: number;
+            }>;
+            timeRange?: { end_time: string; start_time: string };
+            userId: string;
+          },
+          {
+            data: { menstruation: number };
+            errors: Array<{ id: string; message: string; type: string }>;
+          },
+          Name
+        >;
+        syncNutrition: FunctionReference<
+          "mutation",
+          "internal",
+          {
+            samples: Array<{
+              device?: {
+                hardwareVersion?: string;
+                manufacturer?: string;
+                model?: string;
+                name?: string;
+                softwareVersion?: string;
+              };
+              endDate: string;
+              sampleType: string;
+              source?: { bundleIdentifier: string; name: string };
+              startDate: string;
+              unit: string;
+              uuid: string;
+              value: number;
+            }>;
+            timeRange?: { end_time: string; start_time: string };
+            userId: string;
+          },
+          {
+            data: { nutrition: number };
+            errors: Array<{ id: string; message: string; type: string }>;
+          },
+          Name
+        >;
+        syncSleep: FunctionReference<
+          "mutation",
+          "internal",
+          {
+            sessions: Array<
+              Array<{
+                device?: {
+                  hardwareVersion?: string;
+                  manufacturer?: string;
+                  model?: string;
+                  name?: string;
+                  softwareVersion?: string;
+                };
+                endDate: string;
+                sampleType: string;
+                source?: { bundleIdentifier: string; name: string };
+                startDate: string;
+                uuid: string;
+                value: number;
+              }>
+            >;
+            userId: string;
+          },
+          {
+            data: { sleep: number };
+            errors: Array<{ id: string; message: string; type: string }>;
+          },
+          Name
+        >;
+      };
+    };
     public: {
       connect: FunctionReference<
         "mutation",

package/src/component/healthkit/index.ts

@@ -1,46 +1,74 @@
-// ─── @nativesquare/soma/healthkit ─────────────────────────────────────────────
-// Apple HealthKit → Soma schema transformers.
-//
-// Pure TypeScript functions with zero runtime dependencies.
-// Compatible with any HealthKit library (react-native-health, expo-health, etc.)
-
-// ── Transformers ─────────────────────────────────────────────────────────────
-export { transformWorkout } from "./transform/activity.js";
-export { transformSleep } from "./transform/sleep.js";
-export { transformBody } from "./transform/body.js";
-export { transformDaily, transformDailyFromSummary } from "./transform/daily.js";
-export { transformNutrition } from "./transform/nutrition.js";
-export { transformMenstruation } from "./transform/menstruation.js";
-export { transformAthlete } from "./transform/athlete.js";
-
-// ── Enum Maps ────────────────────────────────────────────────────────────────
-export { mapActivityType } from "./transform/maps/activityType.js";
-export { mapSleepLevel, isAsleepCategory } from "./transform/maps/sleepLevel.js";
-export { mapMenstruationFlow } from "./transform/maps/menstruationFlow.js";
-
-// ── Types ────────────────────────────────────────────────────────────────────
-export type {
-  HKQuantitySample,
-  HKCategorySample,
-  HKWorkout,
-  HKWorkoutRoute,
-  HKActivitySummary,
-  HKDevice,
-  HKSource,
-  HKCharacteristics,
-  HKBiologicalSex,
-  HKQuantityTypeIdentifier,
-  HKCategoryTypeIdentifier,
-  HKSleepCategoryValue,
-  HKMenstrualFlowCategoryValue,
-} from "./types.js";
-
-export { HKSleepCategory, HKMenstrualFlowCategory } from "./types.js";
-
-// ── Utilities ────────────────────────────────────────────────────────────────
-export {
-  diffSeconds,
-  dayRange,
-  sampleTimeRange,
-  buildDeviceData,
-} from "./transform/utils.js";
+// ─── @nativesquare/soma/healthkit ─────────────────────────────────────────────
+// Apple HealthKit → Soma schema transformers.
+//
+// Pure TypeScript functions with zero runtime dependencies.
+// Compatible with any HealthKit library (react-native-health, expo-health, etc.)
+
+// ── Transformers ─────────────────────────────────────────────────────────────
+export { transformWorkout } from "./transform/activity.js";
+export { transformSleep } from "./transform/sleep.js";
+export { transformBody } from "./transform/body.js";
+export { transformDaily, transformDailyFromSummary } from "./transform/daily.js";
+export { transformNutrition } from "./transform/nutrition.js";
+export { transformMenstruation } from "./transform/menstruation.js";
+export { transformAthlete } from "./transform/athlete.js";
+
+// ── Enum Maps ────────────────────────────────────────────────────────────────
+export { mapActivityType } from "./transform/maps/activityType.js";
+export { mapSleepLevel, isAsleepCategory } from "./transform/maps/sleepLevel.js";
+export { mapMenstruationFlow } from "./transform/maps/menstruationFlow.js";
+
+// ── Types ────────────────────────────────────────────────────────────────────
+export type {
+  HKQuantitySample,
+  HKCategorySample,
+  HKWorkout,
+  HKWorkoutRoute,
+  HKActivitySummary,
+  HKDevice,
+  HKSource,
+  HKCharacteristics,
+  HKBiologicalSex,
+  HKQuantityTypeIdentifier,
+  HKCategoryTypeIdentifier,
+  HKSleepCategoryValue,
+  HKMenstrualFlowCategoryValue,
+} from "./types.js";
+
+export { HKSleepCategory, HKMenstrualFlowCategory } from "./types.js";
+
+// ── Utilities ────────────────────────────────────────────────────────────────
+export {
+  diffSeconds,
+  dayRange,
+  sampleTimeRange,
+  buildDeviceData,
+} from "./transform/utils.js";
+
+// ── Validators ───────────────────────────────────────────────────────────────
+// Convex validators for HealthKit input shapes. Use as `args:` on your own
+// public mutations to get type-safe validation of HK data flowing from the
+// React Native client into Soma.
+export {
+  hkDeviceValidator,
+  hkSourceValidator,
+  hkQuantitySampleValidator,
+  hkCategorySampleValidator,
+  hkWorkoutRouteValidator,
+  hkWorkoutValidator,
+  hkActivitySummaryValidator,
+  hkCharacteristicsValidator,
+  hkBiologicalSexValidator,
+  hkSleepCategoryValueValidator,
+  hkMenstrualFlowCategoryValueValidator,
+  timeRangeValidator,
+  syncActivitiesArgs,
+  syncSleepArgs,
+  syncBodyArgs,
+  syncDailyArgs,
+  syncDailyFromSummaryArgs,
+  syncNutritionArgs,
+  syncMenstruationArgs,
+  syncAthleteArgs,
+  syncAllHealthKitArgs,
+} from "./validators.js";