react-native-rook-sdk 4.0.0-beta.2 → 5.0.0-beta.0

package/src/types/HCMealData.ts

@@ -0,0 +1,114 @@
+import { type WriteNutrition, MealDataType } from './WriteNutrition';
+
+/**
+ * Interface representing nutrition and meal data for Health Connect.
+ * * Note: All gram values have a range of [0.0 - 100.0] unless specified otherwise.
+ * Energy and macro values have a range of [0.0 - 100,000.0].
+ */
+export interface HCMealData {
+  /** ISO-8601 formatted string (e.g., new Date().toISOString()) */
+  startDateTime: string;
+  /** ISO-8601 formatted string (e.g., new Date().toISOString()) */
+  endDateTime: string;
+  /** Name of the meal or food item */
+  name: string;
+  /** Category of the meal */
+  type: MealDataType;
+
+  // Macros & Energy (Range: 0.0 to 100,000.0)
+  energyKcal?: number;
+  energyFromFatKcal?: number;
+  dietaryFiberGrams?: number;
+  monounsaturatedFatGrams?: number;
+  polyunsaturatedFatGrams?: number;
+  proteinGrams?: number;
+  saturatedFatGrams?: number;
+  sugarGrams?: number;
+  totalCarbohydrateGrams?: number;
+  totalFatGrams?: number;
+  transFatGrams?: number;
+  unsaturatedFatGrams?: number;
+
+  // Micro-nutrients & Minerals (Range: 0.0 to 100.0)
+  biotinGrams?: number;
+  caffeineGrams?: number;
+  calciumGrams?: number;
+  chlorideGrams?: number;
+  cholesterolGrams?: number;
+  chromiumGrams?: number;
+  copperGrams?: number;
+  folateGrams?: number;
+  folicAcidGrams?: number;
+  iodineGrams?: number;
+  ironGrams?: number;
+  magnesiumGrams?: number;
+  manganeseGrams?: number;
+  molybdenumGrams?: number;
+  niacinGrams?: number;
+  pantothenicAcidGrams?: number;
+  phosphorusGrams?: number;
+  potassiumGrams?: number;
+  riboflavinGrams?: number;
+  seleniumGrams?: number;
+  sodiumGrams?: number;
+  thiaminGrams?: number;
+  vitaminAGrams?: number;
+  vitaminB12Grams?: number;
+  vitaminB6Grams?: number;
+  vitaminCGrams?: number;
+  vitaminDGrams?: number;
+  vitaminEGrams?: number;
+  vitaminKGrams?: number;
+  zincGrams?: number;
+}
+
+export const parseWriteNutritionToHC = (data: WriteNutrition): HCMealData => {
+  return {
+    name: data.name,
+    startDateTime: data.date,
+    endDateTime: data.date,
+    type: data.mealType ?? MealDataType.SNACK,
+    biotinGrams: data.biotin,
+    caffeineGrams: data.caffeine,
+    calciumGrams: data.calcium,
+    energyKcal: data.calories,
+    energyFromFatKcal: data.caloriesFromFat,
+    chlorideGrams: data.chloride,
+    cholesterolGrams: data.cholesterol,
+    chromiumGrams: data.chromium,
+    copperGrams: data.copper,
+    dietaryFiberGrams: data.dietaryFiber,
+    folateGrams: data.folate,
+    folicAcidGrams: data.folicAcid,
+    iodineGrams: data.iodine,
+    ironGrams: data.iron,
+    magnesiumGrams: data.magnesium,
+    manganeseGrams: data.manganese,
+    molybdenumGrams: data.molybdenum,
+    monounsaturatedFatGrams: data.monounsaturatedFat,
+    niacinGrams: data.niacin,
+    pantothenicAcidGrams: data.pantothenicAcid,
+    phosphorusGrams: data.phosphorus,
+    polyunsaturatedFatGrams: data.polyunsaturatedFat,
+    potassiumGrams: data.potassium,
+    proteinGrams: data.protein,
+    riboflavinGrams: data.riboflavin,
+    saturatedFatGrams: data.saturatedFat,
+    seleniumGrams: data.selenium,
+    sodiumGrams: data.sodium,
+    sugarGrams: data.sugar,
+    thiaminGrams: data.thiamin,
+    totalCarbohydrateGrams: data.totalCarbohydrates,
+    totalFatGrams: data.totalFat,
+    transFatGrams: data.transFat,
+    unsaturatedFatGrams: data.unsaturatedFat,
+    vitaminAGrams: data.vitaminA,
+    vitaminB12Grams: data.vitaminB12,
+    vitaminB6Grams: data.vitaminB6,
+    vitaminCGrams: data.vitaminC,
+    vitaminDGrams: data.vitaminD,
+    vitaminEGrams: data.vitaminE,
+    vitaminKGrams: data.vitaminK,
+    zincGrams: data.zinc,
+  };
+};

package/src/types/WriteNutrition.ts

@@ -0,0 +1,66 @@
+/**
+ * Represents the type of meal consumed.
+ * These strings must match the Kotlin HCMealDataType enum.
+ */
+export enum MealDataType {
+  BREAKFAST = 'BREAKFAST',
+  LUNCH = 'LUNCH',
+  DINNER = 'DINNER',
+  SNACK = 'SNACK',
+}
+
+export interface WriteNutrition {
+  // Metadata
+  name: string;
+  date: string; // Must be ISO-8601
+  mealType?: MealDataType;
+
+  // Apple Health specific root values
+  amount?: number;
+  unit?: number;
+
+  // Unified Nutrients (Flat list)
+  biotin?: number;
+  caffeine?: number;
+  calcium?: number;
+  calories?: number;
+  caloriesFromFat?: number;
+  chloride?: number;
+  cholesterol?: number;
+  chromium?: number;
+  copper?: number;
+  dietaryFiber?: number;
+  folate?: number;
+  folicAcid?: number;
+  iodine?: number;
+  iron?: number;
+  magnesium?: number;
+  manganese?: number;
+  molybdenum?: number;
+  monounsaturatedFat?: number;
+  niacin?: number;
+  pantothenicAcid?: number;
+  phosphorus?: number;
+  polyunsaturatedFat?: number;
+  potassium?: number;
+  protein?: number;
+  riboflavin?: number;
+  saturatedFat?: number;
+  selenium?: number;
+  sodium?: number;
+  sugar?: number;
+  thiamin?: number;
+  totalCarbohydrates?: number;
+  totalFat?: number;
+  transFat?: number;
+  unsaturatedFat?: number;
+  vitaminA?: number;
+  vitaminB12?: number;
+  vitaminB6?: number;
+  vitaminC?: number;
+  vitaminD?: number;
+  vitaminE?: number;
+  vitaminK?: number;
+  water?: number; // iOS specific
+  zinc?: number;
+}

package/src/utils/isValidDate.ts

@@ -13,3 +13,27 @@ export const isValidDate = (date: string) => {
     );
   }
 };
+
+/**
+ * Validates that a string is a full ISO-8601 date-time with a timezone.
+ * Examples of valid formats:
+ * - 2026-02-23T12:00:00Z
+ * - 2026-02-23T12:00:00+01:00
+ * - 2026-02-23T12:00:00.000-06:00
+ */
+export const isValidZonedDateTime = (date: string) => {
+  // Regex for ISO 8601 with Timezone
+  const isoRegex =
+    /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})$/;
+
+  if (!isoRegex.test(date)) {
+    throw new Error(
+      `Invalid format: ${date}. Expected ISO-8601 with Timezone (e.g., YYYY-MM-DDTHH:mm:ssZ or YYYY-MM-DDTHH:mm:ss+HH:mm)`
+    );
+  }
+
+  // Also verify it's a valid calendar date
+  if (isNaN(Date.parse(date))) {
+    throw new Error(`Invalid date value: ${date}`);
+  }
+};