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

package/src/types/PhysicalSummary.ts

@@ -0,0 +1,84 @@
+import type {
+  ActivityLevelGranularData,
+  ElevationGranularData,
+  FloorsClimbedGranularData,
+  HrGranularData,
+  SaturationGranularData,
+  HrvRmssdGranularData,
+  HrvSdnnGranularData,
+  TraveledDistanceGranularData,
+  StepsGranularData,
+  SwimmingDistanceGranularData,
+  Vo2GranularData,
+} from './SummaryTypes';
+
+export interface ActiveStepsGranularData {
+  dateTime: string;
+  intervalDurationSeconds: number;
+  activeSteps: number;
+}
+
+export interface StressGranularData {
+  dateTime: string;
+  stressScore: number;
+}
+
+export interface PhysicalSummary {
+  dateTime: string;
+  sourceOfData: string;
+  wasTheUserUnderPhysicalActivity: boolean;
+  activeSeconds: number | null;
+  restSeconds: number | null;
+  lowIntensitySeconds: number | null;
+  moderateIntensitySeconds: number | null;
+  vigorousIntensitySeconds: number | null;
+  inactivitySeconds: number | null;
+  activityLevelGranularData: ActivityLevelGranularData[] | null;
+  continuousInactivePeriods: number | null;
+  caloriesNetIntakeKcal: number | null;
+  caloriesExpenditureKcal: number | null;
+  caloriesNetActiveKcal: number | null;
+  caloriesBasalMetabolicRateKcal: number | null;
+  steps: number | null;
+  stepsGranularData: StepsGranularData[] | null;
+  activeSteps: number | null;
+  activeStepsGranularData: ActiveStepsGranularData[] | null;
+  walkedDistanceMeters: number | null;
+  traveledDistanceMeters: number | null;
+  traveledDistanceGranularData: TraveledDistanceGranularData[] | null;
+  floorsClimbed: number | null;
+  floorsClimbedGranularData: FloorsClimbedGranularData[] | null;
+  elevationAvgAltitudeMeters: number | null;
+  elevationMinimumAltitudeMeters: number | null;
+  elevationMaximumAltitudeMeters: number | null;
+  elevationLossActualAltitudeMeters: number | null;
+  elevationGainActualAltitudeMeters: number | null;
+  elevationPlannedGainMeters: number | null;
+  elevationGranularData: ElevationGranularData[] | null;
+  swimmingNumStrokes: number | null;
+  swimmingNumLaps: number | null;
+  swimmingPoolLengthMeters: number | null;
+  swimmingTotalDistanceMeters: number | null;
+  swimmingDistanceGranularData: SwimmingDistanceGranularData[] | null;
+  hrMaximumBpm: number | null;
+  hrMinimumBpm: number | null;
+  hrAvgBpm: number | null;
+  hrRestingBpm: number | null;
+  hrGranularData: HrGranularData[] | null;
+  hrvAvgRmssd: number | null;
+  hrvAvgSdnn: number | null;
+  hrvSdnnGranularData: HrvSdnnGranularData[] | null;
+  hrvRmssdGranularData: HrvRmssdGranularData[] | null;
+  saturationAvgPercentage: number | null;
+  saturationGranularData: SaturationGranularData[] | null;
+  vo2MaxMlPerMinPerKg: number | null;
+  vo2GranularData: Vo2GranularData[] | null;
+  stressAtRestDurationSeconds: number | null;
+  stressDurationSeconds: number | null;
+  lowStressDurationSeconds: number | null;
+  mediumStressDurationSeconds: number | null;
+  highStressDurationSeconds: number | null;
+  stressGranularData: StressGranularData[] | null;
+  stressAvgLevel: number | null;
+  stressMaximumLevel: number | null;
+}

package/src/types/Rook.ts

@@ -0,0 +1,8 @@
+export type RookConfig = {
+  environment: string;
+  clientUUID: string;
+  password: string;
+  enableLogs: boolean;
+  enableEventsBackgroundSync: boolean;
+  enableBackground: boolean;
+};

package/src/types/SDKSources.ts

@@ -0,0 +1,5 @@
+export enum SDKDataSource {
+  HEALTH_CONNECT = 'HEALTH_CONNECT',
+  SAMSUNG_HEALTH = 'SAMSUNG_HEALTH',
+  APPLE_HEALTH = 'APPLE_HEALTH',
+}

package/src/types/SamsungHealthPermissions.ts

@@ -0,0 +1,16 @@
+export enum SamsungHealthPermission {
+  ACTIVITY_SUMMARY = 'ACTIVITY_SUMMARY',
+  BODY_TEMPERATURE = 'BODY_TEMPERATURE',
+  BLOOD_GLUCOSE = 'BLOOD_GLUCOSE',
+  BLOOD_OXYGEN = 'BLOOD_OXYGEN',
+  BLOOD_PRESSURE = 'BLOOD_PRESSURE',
+  BODY_COMPOSITION = 'BODY_COMPOSITION',
+  EXERCISE = 'EXERCISE',
+  EXERCISE_LOCATION = 'EXERCISE_LOCATION',
+  FLOORS_CLIMBED = 'FLOORS_CLIMBED',
+  HEART_RATE = 'HEART_RATE',
+  NUTRITION = 'NUTRITION',
+  SLEEP = 'SLEEP',
+  STEPS = 'STEPS',
+  WATER_INTAKE = 'WATER_INTAKE',
+}

package/src/types/SleepSummary.ts

@@ -0,0 +1,66 @@
+import type {
+  HrGranularData,
+  SaturationGranularData,
+  HrvRmssdGranularData,
+  HrvSdnnGranularData,
+  TemperatureObject,
+  TemperatureGranularData,
+} from './SummaryTypes';
+
+export interface BreathingGranularData {
+  dateTime: string;
+  breathsPerMin: number;
+}
+
+export interface SnoringGranularData {
+  dateTime: string;
+  intervalDurationSeconds: number;
+  snoringEventsCount: number;
+}
+
+export interface SleepSummary {
+  dateTime: string;
+  sourceOfData: string;
+  wasTheUserUnderPhysicalActivity: boolean;
+  sleepStartDateTime: string;
+  sleepEndDateTime: string;
+  sleepDate: string;
+  sleepDurationSeconds: number | null;
+  timeInBedSeconds: number | null;
+  lightSleepDurationSeconds: number | null;
+  remSleepDurationSeconds: number | null;
+  deepSleepDurationSeconds: number | null;
+  timeToFallAsleepSeconds: number | null;
+  timeAwakeDuringSleepSeconds: number | null;
+  sleepQualityRating1To5Score: number | null;
+  sleepEfficiency1To100Score: number | null;
+  sleepGoalSeconds: number | null;
+  sleepContinuity1To5Score: number | null;
+  sleepContinuity1To5Rating: number | null;
+  hrMaximumBpm: number | null;
+  hrMinimumBpm: number | null;
+  hrAvgBpm: number | null;
+  hrRestingBpm: number | null;
+  hrBasalBpm: number | null;
+  hrGranularData: HrGranularData[] | null;
+  hrvAvgRmssd: number | null;
+  hrvAvgSdnn: number | null;
+  hrvSdnnGranularData: HrvSdnnGranularData[] | null;
+  hrvRmssdGranularData: HrvRmssdGranularData[] | null;
+  temperatureMinimum: TemperatureObject | null;
+  temperatureAvg: TemperatureObject | null;
+  temperatureMaximum: TemperatureObject | null;
+  temperatureGranularData: TemperatureGranularData[] | null;
+  temperatureDelta: TemperatureObject | null;
+  breathsMinimumPerMin: number | null;
+  breathsAvgPerMin: number | null;
+  breathsMaximumPerMin: number | null;
+  breathingGranularData: BreathingGranularData[] | null;
+  snoringEventsCount: number | null;
+  snoringDurationTotalSeconds: number | null;
+  snoringGranularData: SnoringGranularData[] | null;
+  saturationAvgPercentage: number | null;
+  saturationMinimumPercentage: number | null;
+  saturationMaximumPercentage: number | null;
+  saturationGranularData: SaturationGranularData[] | null;
+}

package/src/types/SummaryTypes.ts

@@ -0,0 +1,70 @@
+export interface ActivityLevelGranularData {
+  dateTime: string;
+  activityLevel: number;
+}
+
+export interface ElevationGranularData {
+  dateTime: string;
+  intervalDurationSeconds: number;
+  elevationChangeMeters: number;
+}
+
+export interface FloorsClimbedGranularData {
+  dateTime: string;
+  intervalDurationSeconds: number;
+  floorsClimbed: number;
+}
+
+export interface HrGranularData {
+  dateTime: string;
+  hrBpm: number;
+}
+
+export interface HrvSdnnGranularData {
+  dateTime: string;
+  hrvSdnn: number;
+}
+
+export interface HrvRmssdGranularData {
+  dateTime: string;
+  hrvRmssd: number;
+}
+
+export interface SaturationGranularData {
+  dateTime: string;
+  saturationPercentage: number;
+}
+
+export interface Vo2GranularData {
+  dateTime: string;
+  vo2MlPerMinPerKg: number;
+}
+
+export interface TemperatureObject {
+  temperatureCelsius: number;
+  measurementType: string;
+}
+
+export interface TemperatureGranularData {
+  dateTime: string;
+  temperatureCelsius: number;
+  measurementType: string;
+}
+
+export interface TraveledDistanceGranularData {
+  dateTime: string;
+  intervalDurationSeconds: number;
+  traveledDistanceMeters: number;
+}
+
+export interface StepsGranularData {
+  dateTime: string;
+  intervalDurationSeconds: number;
+  steps: number;
+}
+
+export interface SwimmingDistanceGranularData {
+  dateTime: string;
+  intervalDurationSeconds: number;
+  swimmingDistanceMeters: number;
+}

package/src/types/SyncTypes.ts

@@ -0,0 +1,63 @@
+import { SDKDataSource } from './SDKSources';
+
+export type SyncParams = {
+  date: string;
+  summary?: SyncSummaryType;
+  sources: SDKDataSource[];
+};
+
+export type SyncEventParams = {
+  date: string;
+  sources: SDKDataSource[];
+  event:
+    | SharedHealthEvents
+    | UniqueAppleHealthEvents
+    | UniqueSamsungHealthEvents
+    | UniqueHealthConnectEvents;
+};
+
+export type SyncSummaryType = 'sleep' | 'body' | 'physical';
+
+export type SyncResult = {
+  healthConnect?: SyncSourceResult;
+  appleHealth?: SyncSourceResult;
+  samsungHealth?: SyncSourceResult;
+};
+
+export type RookError = {
+  code: string;
+  message: string;
+};
+
+export type SyncSourceResult = {
+  status: boolean;
+  error: Error | { domain: string } | RookError;
+};
+
+export type Callback = (result: SyncResult) => void;
+
+export enum SharedHealthEvents {
+  ACTIVITY = 'ACTIVITY',
+  HEART_RATE = 'HEART_RATE',
+  OXYGENATION = 'OXYGENATION',
+  BLOOD_PRESSURE = 'BLOOD_PRESSURE',
+  BLOOD_GLUCOSE = 'BLOOD_GLUCOSE',
+  CALORIES = 'CALORIES',
+  STEPS = 'STEPS',
+  BODY_METRICS = 'BODY_METRICS',
+}
+
+export enum UniqueHealthConnectEvents {
+  TEMPERATURE = 'TEMPERATURE',
+  HYDRATION = 'HYDRATION',
+  NUTRITION = 'NUTRITION',
+}
+
+export enum UniqueSamsungHealthEvents {
+  HYDRATION = 'HYDRATION',
+  NUTRITION = 'NUTRITION',
+}
+
+export enum UniqueAppleHealthEvents {
+  TEMPERATURE = 'TEMPERATURE',
+}

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/{lib/commonjs/utils/isModuleReady.js → src/utils/isModuleReady.ts}

@@ -1,19 +1,13 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.isModuleReady = void 0;
 /**
  * The function `isModuleReady` checks if a module is ready and throws an error if it is not.
  * @param {boolean} ready - The `ready` parameter in the `isModuleReady` function is a boolean value
  * that indicates whether a certain module or hook is ready for use. If `ready` is `true`, it means the
  * module is ready, and if `ready` is `false`, it means the module is not
  */
-const isModuleReady = ready => {
+export const isModuleReady = (ready: boolean): void => {
   if (!ready) {
-    throw new Error('The hook is not ready, please check your credentials and link of the package');
+    throw new Error(
+      'The hook is not ready, please check your credentials and link of the package'
+    );
   }
 };
-exports.isModuleReady = isModuleReady;
-//# sourceMappingURL=isModuleReady.js.map

package/src/utils/isRunningOnAndroid.ts

@@ -0,0 +1,10 @@
+import { Platform } from 'react-native';
+
+const ERROR_MESSAGE =
+  'This method is only available on Android because it is not supported on iOS';
+
+export default () => {
+  if (Platform.OS !== 'android') {
+    throw new Error(ERROR_MESSAGE);
+  }
+};

package/src/utils/isRunningOniOS.ts

@@ -0,0 +1,10 @@
+import { Platform } from 'react-native';
+
+const ERROR_MESSAGE =
+  'This method is only available on iOS because it is not supported on Android';
+
+export const isRunningOniOS = () => {
+  if (Platform.OS !== 'ios') {
+    throw new Error(ERROR_MESSAGE);
+  }
+};

package/{lib/commonjs/utils/isValidDate.js → src/utils/isValidDate.ts}

@@ -1,19 +1,16 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.isValidZonedDateTime = exports.isValidDate = void 0;
 /**
  * The isValidDate function in TypeScript validates if a given date string is in the format YYYY-MM-DD.
  * @param {string} date - The `isValidDate` function you provided checks if a given date string is in
  * the format `YYYY-MM-DD`. If the date string does not match this format, it throws an error
  * indicating the correct format.
  */
-const isValidDate = date => {
+export const isValidDate = (date: string) => {
   const regex = /^\d{4}-\d{2}-\d{2}$/;
+
   if (!regex.test(date)) {
-    throw new Error(`Invalid format: ${date}, the correct format is YYYY-MM-DD`);
+    throw new Error(
+      `Invalid format: ${date}, the correct format is YYYY-MM-DD`
+    );
   }
 };
 
@@ -24,12 +21,15 @@ const isValidDate = date => {
  * - 2026-02-23T12:00:00+01:00
  * - 2026-02-23T12:00:00.000-06:00
  */
-exports.isValidDate = isValidDate;
-const isValidZonedDateTime = date => {
+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})$/;
+  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)`);
+    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
@@ -37,5 +37,3 @@ const isValidZonedDateTime = date => {
     throw new Error(`Invalid date value: ${date}`);
   }
 };
-exports.isValidZonedDateTime = isValidZonedDateTime;
-//# sourceMappingURL=isValidDate.js.map

package/android/src/main/AndroidManifestNew.xml

@@ -1,36 +0,0 @@
-<manifest xmlns:android="http://schemas.android.com/apk/res/android">
-  <queries>
-    <package android:name="com.google.android.apps.healthdata"/>
-  </queries>
-
-  <uses-permission android:name="android.permission.ACTIVITY_RECOGNITION"/>
-  <uses-permission android:name="android.permission.FOREGROUND_SERVICE"/>
-  <uses-permission android:name="android.permission.FOREGROUND_SERVICE_HEALTH"/>
-  <uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>
-  <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"/>
-
-  <uses-permission android:name="android.permission.health.READ_SLEEP"/>
-  <uses-permission android:name="android.permission.health.READ_STEPS"/>
-  <uses-permission android:name="android.permission.health.READ_DISTANCE"/>
-  <uses-permission android:name="android.permission.health.READ_FLOORS_CLIMBED"/>
-  <uses-permission android:name="android.permission.health.READ_ELEVATION_GAINED"/>
-  <uses-permission android:name="android.permission.health.READ_OXYGEN_SATURATION"/>
-  <uses-permission android:name="android.permission.health.READ_VO2_MAX"/>
-  <uses-permission android:name="android.permission.health.READ_TOTAL_CALORIES_BURNED"/>
-  <uses-permission android:name="android.permission.health.READ_ACTIVE_CALORIES_BURNED"/>
-  <uses-permission android:name="android.permission.health.READ_HEART_RATE"/>
-  <uses-permission android:name="android.permission.health.READ_RESTING_HEART_RATE"/>
-  <uses-permission android:name="android.permission.health.READ_HEART_RATE_VARIABILITY"/>
-  <uses-permission android:name="android.permission.health.READ_EXERCISE"/>
-  <uses-permission android:name="android.permission.health.READ_SPEED"/>
-  <uses-permission android:name="android.permission.health.READ_WEIGHT"/>
-  <uses-permission android:name="android.permission.health.READ_HEIGHT"/>
-  <uses-permission android:name="android.permission.health.READ_BLOOD_GLUCOSE"/>
-  <uses-permission android:name="android.permission.health.READ_BLOOD_PRESSURE"/>
-  <uses-permission android:name="android.permission.health.READ_HYDRATION"/>
-  <uses-permission android:name="android.permission.health.READ_BODY_TEMPERATURE"/>
-  <uses-permission android:name="android.permission.health.READ_RESPIRATORY_RATE"/>
-  <uses-permission android:name="android.permission.health.READ_NUTRITION"/>
-  <uses-permission android:name="android.permission.health.READ_MENSTRUATION"/>
-  <uses-permission android:name="android.permission.health.READ_POWER"/>
-</manifest>

package/android/src/main/java/com/rooksdk/modules/RookBackgroundSyncModule.kt

@@ -1,99 +0,0 @@
-package com.rooksdk.modules
-
-import com.facebook.react.bridge.Promise
-import com.facebook.react.bridge.ReactApplicationContext
-import com.facebook.react.bridge.ReactContextBaseJavaModule
-import com.facebook.react.bridge.ReactMethod
-import com.rookmotion.rook.sdk.RookBackgroundSyncManager
-import com.rookmotion.rook.sdk.domain.exception.HCException
-import io.tryrook.api.sources.domain.exception.ApiException
-import kotlinx.coroutines.CoroutineScope
-import kotlinx.coroutines.Dispatchers
-import kotlinx.coroutines.SupervisorJob
-import kotlinx.coroutines.launch
-
-class RookBackgroundSyncModule (reactContext: ReactApplicationContext) : ReactContextBaseJavaModule(reactContext) {
-
-  private val backgroundSyncManager = RookBackgroundSyncManager(reactContext)
-
-  private val scope: CoroutineScope by lazy {
-    CoroutineScope(SupervisorJob() + Dispatchers.Main)
-  }
-
-  override fun getName(): String {
-    return "RookBackgroundModule"
-  }
-
-  /**
-   * Schedules the background synchronization of health data using Rook.
-   *
-   * This function enables automatic background data synchronization with Rook.
-   * It ensures that health data is periodically fetched and sent to Rook’s API
-   * based on the defined configuration.
-   *
-   * If the scheduling is successful, the promise resolves with "SUCCESS".
-   * If an error occurs, the promise rejects with an error message.
-   *
-   * @param promise A React Native promise that resolves when the sync is scheduled successfully or rejects with an error.
-   */
-  @ReactMethod
-  fun scheduleBackgroundSync(enableLogs: Boolean, promise: Promise) {
-    try {
-      backgroundSyncManager.schedule(enableLogs)
-      promise.resolve(true)
-    }
-    catch (e: Exception) {
-      if (e is HCException) {
-        promise.reject(e.code.toString(), e.message, e)
-      } else {
-        promise.reject("1001", e.message, e)
-      }
-    }
-
-  }
-
-  /**
-   * Cancels the scheduled background synchronization of health data.
-   *
-   * This function stops the automatic background sync previously scheduled using Rook.
-   * It ensures that no further health data is fetched and sent until scheduled again.
-   *
-   * If the cancellation is successful, the promise resolves with "SUCCESS".
-   * If an error occurs, the promise rejects with an error message.
-   *
-   * @param promise A React Native promise that resolves when the sync is canceled successfully or rejects with an error.
-   */
-  @ReactMethod
-  fun cancelBackgroundSync(promise: Promise) {
-    scope.launch {
-      try {
-        backgroundSyncManager.cancel()
-        promise.resolve(true)
-      } catch (e: Exception) {
-        if (e is HCException) {
-          promise.reject(e.code.toString(), e.message, e)
-        } else {
-          promise.reject("1001", e.message, e)
-        }
-      }
-    }
-  }
-
-@ReactMethod
-  fun isBackgroundSyncEnabled(promise: Promise) {
-    scope.launch {
-      backgroundSyncManager.isScheduled().fold(
-        {
-          promise.resolve(it)
-        },
-        {
-          if (it is HCException) {
-            promise.reject(it.code.toString(), it.message, it)
-          } else {
-            promise.reject("1001", it.message, it)
-          }
-        }
-      )
-    }
-  }
-}