@kingstinct/react-native-healthkit 4.4.0 → 4.4.1

package/src/index.ios.tsx

@@ -4,23 +4,25 @@ import Native, {
   EventEmitter,
   HKQuantityTypeIdentifier,
   HKUnit,
+  HKCategoryTypeIdentifier,
 } from './native-types'
 
 import type {
+  HKSampleTypeIdentifier,
   HKCategorySampleRaw,
-  HKCategoryTypeIdentifier,
   HKCategoryValueForIdentifier,
   HKCharacteristicTypeIdentifier,
   HKCorrelationRaw,
   HKCorrelationTypeIdentifier,
   HKQuantitySampleRaw,
-  HKSampleTypeIdentifier,
   HKUnitSI,
   HKUnitSIPrefix,
   HKWorkoutRaw,
   MetadataMapperForCategoryIdentifier,
   ReadPermissions,
   WritePermissions,
+  HealthkitAuthorization,
+  HKAuthorizationRequestStatus,
 } from './native-types'
 import type {
   GenericQueryOptions,
@@ -45,6 +47,7 @@ import type {
   SaveWorkoutSampleFn,
   SubscribeToChangesFn,
 } from './types'
+import type { ValueOf } from 'type-fest'
 
 const getPreferredUnit: GetPreferredUnitFn = async (type) => {
   const [unit] = await getPreferredUnits([type])
@@ -234,7 +237,7 @@ const getMostRecentCategorySample: GetMostRecentCategorySampleFn = async (
   return samples[0]
 }
 
-function useSubscribeToChanges<TIdentifier extends HKSampleTypeIdentifier>(
+function useSubscribeToChanges<TIdentifier extends ValueOf<typeof HKSampleTypeIdentifier>>(
   identifier: TIdentifier,
   onChange: () => void,
 ): void {
@@ -252,6 +255,8 @@ function useSubscribeToChanges<TIdentifier extends HKSampleTypeIdentifier>(
   }, [identifier, onChange])
 }
 
+useSubscribeToChanges(HKCategoryTypeIdentifier.appleStandHour, () => {})
+
 function useMostRecentCategorySample<
   TCategory extends HKCategoryTypeIdentifier
 >(identifier: TCategory) {
@@ -350,8 +355,8 @@ const queryStatisticsForQuantity: QueryStatisticsForQuantityFn = async (
 }
 
 const requestAuthorization = async (
-  read: readonly (HKCharacteristicTypeIdentifier | HKSampleTypeIdentifier)[],
-  write: readonly HKSampleTypeIdentifier[] = [],
+  read: readonly ValueOf<typeof HealthkitAuthorization>[],
+  write: readonly ValueOf<typeof HKSampleTypeIdentifier>[] = [],
 ): Promise<boolean> => {
   const readPermissions = read.reduce((obj, cur) => ({ ...obj, [cur]: true }), {} as ReadPermissions)
 
@@ -366,8 +371,8 @@ const getDateOfBirth = async () => {
 }
 
 const getRequestStatusForAuthorization = async (
-  read: readonly (HKCharacteristicTypeIdentifier | HKSampleTypeIdentifier)[],
-  write: readonly HKSampleTypeIdentifier[] = [],
+  read: readonly (HKCharacteristicTypeIdentifier | ValueOf<typeof HKSampleTypeIdentifier>)[],
+  write: readonly (ValueOf<typeof HKSampleTypeIdentifier>)[] = [],
 ) => {
   const readPermissions = read.reduce((obj, cur) => ({ ...obj, [cur]: true }), {} as ReadPermissions)
 
@@ -578,6 +583,37 @@ const Healthkit: ReactNativeHealthkit = {
   useMostRecentWorkout,
 
   useSubscribeToChanges,
+
+  useIsHealthDataAvailable: () => {
+    const [isAvailable, setIsAvailable] = useState<boolean | null>(null)
+    useEffect(() => {
+      const init = async () => {
+        const res = await Native.isHealthDataAvailable()
+        setIsAvailable(res)
+      }
+      void init()
+    }, [])
+    return isAvailable
+  },
+  useHealthkitAuthorization: (read, write) => {
+    const [status, setStatus] = useState<HKAuthorizationRequestStatus | null>(null)
+    const refreshAuthStatus = useCallback(async () => {
+      const auth = await getRequestStatusForAuthorization(read, write)
+      setStatus(auth)
+      return auth
+    }, [])
+
+    const request = useCallback(async () => {
+      await requestAuthorization(read, write)
+      return refreshAuthStatus()
+    }, [])
+
+    useEffect(() => {
+      void refreshAuthStatus()
+    }, [])
+
+    return [status, request]
+  },
 }
 
 export * from './native-types'

package/src/index.tsx

@@ -1,49 +1,66 @@
 import { Platform } from 'react-native'
 
+import {
+  HKAuthorizationRequestStatus, HKBiologicalSex, HKBloodType, HKFitzpatrickSkinType, HKUnit, HKWheelchairUse,
+} from './native-types'
+
 import type { ReactNativeHealthkit } from './types'
 
-const notAvailableError = `Platform "${
+const notAvailableError = `[@kingstinct/react-native-healthkit] Platform "${
   Platform.OS
-}" not supported, use isHealthDataAvailable to check for availability before using it`
+}" not supported`
 
-const UnavailableFn = () => {
-  throw new Error(notAvailableError)
+function UnavailableFn<T = unknown>(retVal: T) {
+  return () => {
+    console.warn(notAvailableError)
+    return retVal
+  }
 }
 
 const Healthkit: ReactNativeHealthkit = {
-  authorizationStatusFor: UnavailableFn,
-  buildUnitWithPrefix: UnavailableFn,
-  disableAllBackgroundDelivery: UnavailableFn,
-  disableBackgroundDelivery: UnavailableFn,
-  enableBackgroundDelivery: UnavailableFn,
-  getBiologicalSex: UnavailableFn,
-  getBloodType: UnavailableFn,
-  getDateOfBirth: UnavailableFn,
-  getFitzpatrickSkinType: UnavailableFn,
-  getMostRecentCategorySample: UnavailableFn,
-  getMostRecentQuantitySample: UnavailableFn,
-  getMostRecentWorkout: UnavailableFn,
-  getPreferredUnit: UnavailableFn,
-  getPreferredUnits: UnavailableFn,
-  getRequestStatusForAuthorization: UnavailableFn,
-  getWheelchairUse: UnavailableFn,
-  getWorkoutRoutes: UnavailableFn,
+  authorizationStatusFor: UnavailableFn(Promise.resolve(false)),
+  buildUnitWithPrefix: UnavailableFn(HKUnit.Atmospheres),
+  disableAllBackgroundDelivery: UnavailableFn(Promise.resolve(false)),
+  disableBackgroundDelivery: UnavailableFn(Promise.resolve(false)),
+  enableBackgroundDelivery: UnavailableFn(Promise.resolve(false)),
+  getBiologicalSex: UnavailableFn(Promise.resolve(HKBiologicalSex.notSet)),
+  getBloodType: UnavailableFn(Promise.resolve(HKBloodType.notSet)),
+  getDateOfBirth: UnavailableFn(Promise.resolve(new Date(0))),
+  getFitzpatrickSkinType: UnavailableFn(Promise.resolve(HKFitzpatrickSkinType.notSet)),
+  getMostRecentCategorySample: UnavailableFn(Promise.resolve(null)),
+  getMostRecentQuantitySample: UnavailableFn(Promise.resolve(null)),
+  getMostRecentWorkout: UnavailableFn(Promise.resolve(null)),
+  getPreferredUnit: UnavailableFn(Promise.resolve(HKUnit.Atmospheres)),
+  getPreferredUnits: UnavailableFn(Promise.resolve([])),
+  getRequestStatusForAuthorization: UnavailableFn(Promise.resolve(HKAuthorizationRequestStatus.unknown)),
+  getWheelchairUse: UnavailableFn(Promise.resolve(HKWheelchairUse.notSet)),
+  getWorkoutRoutes: UnavailableFn(Promise.resolve([])),
   isHealthDataAvailable: async () => Promise.resolve(false),
-  queryCategorySamples: UnavailableFn,
-  queryCorrelationSamples: UnavailableFn,
-  queryQuantitySamples: UnavailableFn,
-  queryStatisticsForQuantity: UnavailableFn,
-  queryWorkouts: UnavailableFn,
-  requestAuthorization: UnavailableFn,
-  saveCategorySample: UnavailableFn,
-  saveCorrelationSample: UnavailableFn,
-  saveQuantitySample: UnavailableFn,
-  saveWorkoutSample: UnavailableFn,
-  subscribeToChanges: UnavailableFn,
-  useMostRecentCategorySample: UnavailableFn,
-  useMostRecentQuantitySample: UnavailableFn,
-  useMostRecentWorkout: UnavailableFn,
-  useSubscribeToChanges: UnavailableFn,
+  queryCategorySamples: UnavailableFn(Promise.resolve([])),
+  queryCorrelationSamples: UnavailableFn(Promise.resolve([])),
+  queryQuantitySamples: UnavailableFn(Promise.resolve([])),
+  queryStatisticsForQuantity: UnavailableFn(Promise.resolve({
+    averageQuantity: undefined,
+    maximumQuantity: undefined,
+    minimumQuantity: undefined,
+    sumQuantity: undefined,
+    mostRecentQuantity: undefined,
+    mostRecentQuantityDateInterval: undefined,
+    duration: undefined,
+  })),
+  queryWorkouts: UnavailableFn(Promise.resolve([])),
+  requestAuthorization: UnavailableFn(Promise.resolve(false)),
+  saveCategorySample: UnavailableFn(Promise.resolve(false)),
+  saveCorrelationSample: UnavailableFn(Promise.resolve(false)),
+  saveQuantitySample: UnavailableFn(Promise.resolve(false)),
+  saveWorkoutSample: UnavailableFn(Promise.resolve(false)),
+  subscribeToChanges: UnavailableFn(Promise.resolve(async () => Promise.resolve(false))),
+  useMostRecentCategorySample: UnavailableFn(null),
+  useMostRecentQuantitySample: UnavailableFn(null),
+  useMostRecentWorkout: UnavailableFn(null),
+  useSubscribeToChanges: UnavailableFn([null, () => null]),
+  useHealthkitAuthorization: UnavailableFn([null, async () => Promise.resolve(null)] as const),
+  useIsHealthDataAvailable: UnavailableFn(false),
 }
 
 export * from './native-types'

package/src/native-types.ts

@@ -4,20 +4,121 @@ import {
 } from 'react-native'
 
 import type { EmitterSubscription } from 'react-native'
+import type { ValueOf } from 'type-fest'
 
-export const HKWorkoutTypeIdentifier = 'HKWorkoutTypeIdentifier'
-export const HKAudiogramTypeIdentifier = 'HKAudiogramTypeIdentifier'
-export const HKWorkoutRouteTypeIdentifier = 'HKWorkoutRouteTypeIdentifier'
-export const HKDataTypeIdentifierHeartbeatSeries = 'HKDataTypeIdentifierHeartbeatSeries'
+export const HKWorkoutTypeIdentifier = 'HKWorkoutTypeIdentifier' as const
+export const HKAudiogramTypeIdentifier = 'HKAudiogramTypeIdentifier' as const
+export const HKWorkoutRouteTypeIdentifier = 'HKWorkoutRouteTypeIdentifier' as const
+export const HKDataTypeIdentifierHeartbeatSeries = 'HKDataTypeIdentifierHeartbeatSeries' as const
 
-export type HKSampleTypeIdentifier =
-  | HKCategoryTypeIdentifier
-  | HKCorrelationTypeIdentifier
-  | HKQuantityTypeIdentifier
-  | typeof HKAudiogramTypeIdentifier
-  | typeof HKDataTypeIdentifierHeartbeatSeries
-  | typeof HKWorkoutRouteTypeIdentifier
-  | typeof HKWorkoutTypeIdentifier;
+// Straight mapping to https://developer.apple.com/documentation/healthkit/hkquantitytypeidentifier
+export enum HKQuantityTypeIdentifier {
+  bodyMassIndex = 'HKQuantityTypeIdentifierBodyMassIndex',
+  bodyFatPercentage = 'HKQuantityTypeIdentifierBodyFatPercentage', // Scalar(Percent, 0.0 - 1.0),  Discrete
+  height = 'HKQuantityTypeIdentifierHeight', // Length,                      Discrete
+  bodyMass = 'HKQuantityTypeIdentifierBodyMass', // Mass,                        Discrete
+  leanBodyMass = 'HKQuantityTypeIdentifierLeanBodyMass', // Mass,                        Discrete
+
+  waistCircumference = 'HKQuantityTypeIdentifierWaistCircumference', // Length,                      Discrete
+  // Fitness
+  stepCount = 'HKQuantityTypeIdentifierStepCount', // Scalar(Count),               Cumulative
+  distanceWalkingRunning = 'HKQuantityTypeIdentifierDistanceWalkingRunning', // Length,                      Cumulative
+  distanceCycling = 'HKQuantityTypeIdentifierDistanceCycling', // Length,                      Cumulative
+  distanceWheelchair = 'HKQuantityTypeIdentifierDistanceWheelchair', // Length,                      Cumulative
+  basalEnergyBurned = 'HKQuantityTypeIdentifierBasalEnergyBurned', // Energy,                      Cumulative
+  activeEnergyBurned = 'HKQuantityTypeIdentifierActiveEnergyBurned', // Energy,                      Cumulative
+  flightsClimbed = 'HKQuantityTypeIdentifierFlightsClimbed', // Scalar(Count),               Cumulative
+  nikeFuel = 'HKQuantityTypeIdentifierNikeFuel', // Scalar(Count),               Cumulative
+  appleExerciseTime = 'HKQuantityTypeIdentifierAppleExerciseTime', // Time                         Cumulative
+  pushCount = 'HKQuantityTypeIdentifierPushCount', // Scalar(Count),               Cumulative
+  distanceSwimming = 'HKQuantityTypeIdentifierDistanceSwimming', // Length,                      Cumulative
+  swimmingStrokeCount = 'HKQuantityTypeIdentifierSwimmingStrokeCount', // Scalar(Count),               Cumulative
+  vo2Max = 'HKQuantityTypeIdentifierVo2Max', // ml/(kg*min)                  Discrete
+  distanceDownhillSnowSports = 'HKQuantityTypeIdentifierDistanceDownhillSnowSports', // Length,                      Cumulative
+
+  appleStandTime = 'HKQuantityTypeIdentifierAppleStandTime', // Time,                        Cumulative
+  // Vitals
+  heartRate = 'HKQuantityTypeIdentifierHeartRate', // Scalar(Count)/Time,          Discrete
+  bodyTemperature = 'HKQuantityTypeIdentifierBodyTemperature', // Temperature,                 Discrete
+  basalBodyTemperature = 'HKQuantityTypeIdentifierBasalBodyTemperature', // Basal Body Temperature,      Discrete
+  bloodPressureSystolic = 'HKQuantityTypeIdentifierBloodPressureSystolic', // Pressure,                    Discrete
+  bloodPressureDiastolic = 'HKQuantityTypeIdentifierBloodPressureDiastolic', // Pressure,                    Discrete
+  respiratoryRate = 'HKQuantityTypeIdentifierRespiratoryRate', // Scalar(Count)/Time,          Discrete
+  // Beats per minute estimate of a user's lowest heart rate while at rest
+  restingHeartRate = 'HKQuantityTypeIdentifierRestingHeartRate', // Scalar(Count)/Time,          Discrete
+  // Average heartbeats per minute captured by an Apple Watch while a user is walking
+  walkingHeartRateAverage = 'HKQuantityTypeIdentifierWalkingHeartRateAverage', // Scalar(Count)/Time,          Discrete
+  // The standard deviation of heart beat-to-beat intevals (Standard Deviation of Normal to Normal)
+
+  heartRateVariabilitySDNN = 'HKQuantityTypeIdentifierHeartRateVariabilitySDNN', // Time (ms),                   Discrete
+  // Results
+  oxygenSaturation = 'HKQuantityTypeIdentifierOxygenSaturation', // Scalar (Percent, 0.0 - 1.0,  Discrete
+  peripheralPerfusionIndex = 'HKQuantityTypeIdentifierPeripheralPerfusionIndex', // Scalar(Percent, 0.0 - 1.0),  Discrete
+  bloodGlucose = 'HKQuantityTypeIdentifierBloodGlucose', // Mass/Volume,                 Discrete
+  numberOfTimesFallen = 'HKQuantityTypeIdentifierNumberOfTimesFallen', // Scalar(Count),               Cumulative
+  electrodermalActivity = 'HKQuantityTypeIdentifierElectrodermalActivity', // Conductance,                 Discrete
+  inhalerUsage = 'HKQuantityTypeIdentifierInhalerUsage', // Scalar(Count),               Cumulative
+  insulinDelivery = 'HKQuantityTypeIdentifierInsulinDelivery', // Pharmacology (IU)            Cumulative
+  bloodAlcoholContent = 'HKQuantityTypeIdentifierBloodAlcoholContent', // Scalar(Percent, 0.0 - 1.0),  Discrete
+  forcedVitalCapacity = 'HKQuantityTypeIdentifierForcedVitalCapacity', // Volume,                      Discrete
+  forcedExpiratoryVolume1 = 'HKQuantityTypeIdentifierForcedExpiratoryVolume1', // Volume,                      Discrete
+  peakExpiratoryFlowRate = 'HKQuantityTypeIdentifierPeakExpiratoryFlowRate', // Volume/Time,                 Discrete
+  environmentalAudioExposure = 'HKQuantityTypeIdentifierEnvironmentalAudioExposure', // Pressure,                    Cumulative
+
+  headphoneAudioExposure = 'HKQuantityTypeIdentifierHeadphoneAudioExposure', // Pressure,                    Cumulative
+  // Nutrition
+  dietaryFatTotal = 'HKQuantityTypeIdentifierDietaryFatTotal', // Mass,   Cumulative
+  dietaryFatPolyunsaturated = 'HKQuantityTypeIdentifierDietaryFatPolyunsaturated', // Mass,   Cumulative
+  dietaryFatMonounsaturated = 'HKQuantityTypeIdentifierDietaryFatMonounsaturated', // Mass,   Cumulative
+  dietaryFatSaturated = 'HKQuantityTypeIdentifierDietaryFatSaturated', // Mass,   Cumulative
+  dietaryCholesterol = 'HKQuantityTypeIdentifierDietaryCholesterol', // Mass,   Cumulative
+  dietarySodium = 'HKQuantityTypeIdentifierDietarySodium', // Mass,   Cumulative
+  dietaryCarbohydrates = 'HKQuantityTypeIdentifierDietaryCarbohydrates', // Mass,   Cumulative
+  dietaryFiber = 'HKQuantityTypeIdentifierDietaryFiber', // Mass,   Cumulative
+  dietarySugar = 'HKQuantityTypeIdentifierDietarySugar', // Mass,   Cumulative
+  dietaryEnergyConsumed = 'HKQuantityTypeIdentifierDietaryEnergyConsumed', // Energy, Cumulative
+  dietaryProtein = 'HKQuantityTypeIdentifierDietaryProtein', // Mass,   Cumulative
+
+  dietaryVitaminA = 'HKQuantityTypeIdentifierDietaryVitaminA', // Mass, Cumulative
+  dietaryVitaminB6 = 'HKQuantityTypeIdentifierDietaryVitaminB6', // Mass, Cumulative
+  dietaryVitaminB12 = 'HKQuantityTypeIdentifierDietaryVitaminB12', // Mass, Cumulative
+  dietaryVitaminC = 'HKQuantityTypeIdentifierDietaryVitaminC', // Mass, Cumulative
+  dietaryVitaminD = 'HKQuantityTypeIdentifierDietaryVitaminD', // Mass, Cumulative
+  dietaryVitaminE = 'HKQuantityTypeIdentifierDietaryVitaminE', // Mass, Cumulative
+  dietaryVitaminK = 'HKQuantityTypeIdentifierDietaryVitaminK', // Mass, Cumulative
+  dietaryCalcium = 'HKQuantityTypeIdentifierDietaryCalcium', // Mass, Cumulative
+  dietaryIron = 'HKQuantityTypeIdentifierDietaryIron', // Mass, Cumulative
+  dietaryThiamin = 'HKQuantityTypeIdentifierDietaryThiamin', // Mass, Cumulative
+  dietaryRiboflavin = 'HKQuantityTypeIdentifierDietaryRiboflavin', // Mass, Cumulative
+  dietaryNiacin = 'HKQuantityTypeIdentifierDietaryNiacin', // Mass, Cumulative
+  dietaryFolate = 'HKQuantityTypeIdentifierDietaryFolate', // Mass, Cumulative
+  dietaryBiotin = 'HKQuantityTypeIdentifierDietaryBiotin', // Mass, Cumulative
+  dietaryPantothenicAcid = 'HKQuantityTypeIdentifierDietaryPantothenicAcid', // Mass, Cumulative
+  dietaryPhosphorus = 'HKQuantityTypeIdentifierDietaryPhosphorus', // Mass, Cumulative
+  dietaryIodine = 'HKQuantityTypeIdentifierDietaryIodine', // Mass, Cumulative
+  dietaryMagnesium = 'HKQuantityTypeIdentifierDietaryMagnesium', // Mass, Cumulative
+  dietaryZinc = 'HKQuantityTypeIdentifierDietaryZinc', // Mass, Cumulative
+  dietarySelenium = 'HKQuantityTypeIdentifierDietarySelenium', // Mass, Cumulative
+  dietaryCopper = 'HKQuantityTypeIdentifierDietaryCopper', // Mass, Cumulative
+  dietaryManganese = 'HKQuantityTypeIdentifierDietaryManganese', // Mass, Cumulative
+  dietaryChromium = 'HKQuantityTypeIdentifierDietaryChromium', // Mass, Cumulative
+  dietaryMolybdenum = 'HKQuantityTypeIdentifierDietaryMolybdenum', // Mass, Cumulative
+  dietaryChloride = 'HKQuantityTypeIdentifierDietaryChloride', // Mass, Cumulative
+  dietaryPotassium = 'HKQuantityTypeIdentifierDietaryPotassium', // Mass, Cumulative
+  dietaryCaffeine = 'HKQuantityTypeIdentifierDietaryCaffeine', // Mass, Cumulative
+  dietaryWater = 'HKQuantityTypeIdentifierDietaryWater', // Volume, Cumulative
+
+  // Mobility
+  sixMinuteWalkTestDistance = 'HKQuantityTypeIdentifierSixMinuteWalkTestDistance',
+  walkingSpeed = 'HKQuantityTypeIdentifierWalkingSpeed',
+  walkingStepLength = 'HKQuantityTypeIdentifierWalkingStepLength',
+  walkingAsymmetryPercentage = 'HKQuantityTypeIdentifierWalkingAsymmetryPercentage',
+  walkingDoubleSupportPercentage = 'HKQuantityTypeIdentifierWalkingDoubleSupportPercentage',
+  stairAscentSpeed = 'HKQuantityTypeIdentifierStairAscentSpeed',
+  stairDescentSpeed = 'HKQuantityTypeIdentifierStairDescentSpeed',
+
+  uvExposure = 'HKQuantityTypeIdentifierUvExposure', // Scalar (Count), Discrete
+}
 
 export type TypeToUnitMapping = { readonly
   [key in HKQuantityTypeIdentifier]: HKUnit;
@@ -29,6 +130,11 @@ export enum HKHeartRateMotionContext {
   sedentary = 1,
 }
 
+export enum HKCorrelationTypeIdentifier {
+  bloodPressure = 'HKCorrelationTypeIdentifierBloodPressure',
+  food = 'HKCorrelationTypeIdentifierFood',
+}
+
 export enum HKCategoryTypeIdentifier {
   sleepAnalysis = 'HKCategoryTypeIdentifierSleepAnalysis',
   appleStandHour = 'HKCategoryTypeIdentifierAppleStandHour',
@@ -45,6 +151,16 @@ export enum HKCategoryTypeIdentifier {
   toothbrushingEvent = 'HKCategoryTypeIdentifierToothbrushingEvent',
 }
 
+export const HKSampleTypeIdentifier = {
+  ...HKCategoryTypeIdentifier,
+  ...HKCorrelationTypeIdentifier,
+  ...HKQuantityTypeIdentifier,
+  audiogram: HKAudiogramTypeIdentifier,
+  heartbeatSeries: HKDataTypeIdentifierHeartbeatSeries,
+  workoutRoute: HKWorkoutRouteTypeIdentifier,
+  workoute: HKWorkoutTypeIdentifier,
+}
+
 export enum HKCategoryValueAppleStandHour {
   stood = 0,
   idle = 1,
@@ -187,115 +303,6 @@ export interface HKWorkoutMetadata
   // HKWeatherTemperature: HKQuantity<TTemperatureUnit>
 }
 
-// Straight mapping to https://developer.apple.com/documentation/healthkit/hkquantitytypeidentifier
-export enum HKQuantityTypeIdentifier {
-  bodyMassIndex = 'HKQuantityTypeIdentifierBodyMassIndex',
-  bodyFatPercentage = 'HKQuantityTypeIdentifierBodyFatPercentage', // Scalar(Percent, 0.0 - 1.0),  Discrete
-  height = 'HKQuantityTypeIdentifierHeight', // Length,                      Discrete
-  bodyMass = 'HKQuantityTypeIdentifierBodyMass', // Mass,                        Discrete
-  leanBodyMass = 'HKQuantityTypeIdentifierLeanBodyMass', // Mass,                        Discrete
-
-  waistCircumference = 'HKQuantityTypeIdentifierWaistCircumference', // Length,                      Discrete
-  // Fitness
-  stepCount = 'HKQuantityTypeIdentifierStepCount', // Scalar(Count),               Cumulative
-  distanceWalkingRunning = 'HKQuantityTypeIdentifierDistanceWalkingRunning', // Length,                      Cumulative
-  distanceCycling = 'HKQuantityTypeIdentifierDistanceCycling', // Length,                      Cumulative
-  distanceWheelchair = 'HKQuantityTypeIdentifierDistanceWheelchair', // Length,                      Cumulative
-  basalEnergyBurned = 'HKQuantityTypeIdentifierBasalEnergyBurned', // Energy,                      Cumulative
-  activeEnergyBurned = 'HKQuantityTypeIdentifierActiveEnergyBurned', // Energy,                      Cumulative
-  flightsClimbed = 'HKQuantityTypeIdentifierFlightsClimbed', // Scalar(Count),               Cumulative
-  nikeFuel = 'HKQuantityTypeIdentifierNikeFuel', // Scalar(Count),               Cumulative
-  appleExerciseTime = 'HKQuantityTypeIdentifierAppleExerciseTime', // Time                         Cumulative
-  pushCount = 'HKQuantityTypeIdentifierPushCount', // Scalar(Count),               Cumulative
-  distanceSwimming = 'HKQuantityTypeIdentifierDistanceSwimming', // Length,                      Cumulative
-  swimmingStrokeCount = 'HKQuantityTypeIdentifierSwimmingStrokeCount', // Scalar(Count),               Cumulative
-  vo2Max = 'HKQuantityTypeIdentifierVo2Max', // ml/(kg*min)                  Discrete
-  distanceDownhillSnowSports = 'HKQuantityTypeIdentifierDistanceDownhillSnowSports', // Length,                      Cumulative
-
-  appleStandTime = 'HKQuantityTypeIdentifierAppleStandTime', // Time,                        Cumulative
-  // Vitals
-  heartRate = 'HKQuantityTypeIdentifierHeartRate', // Scalar(Count)/Time,          Discrete
-  bodyTemperature = 'HKQuantityTypeIdentifierBodyTemperature', // Temperature,                 Discrete
-  basalBodyTemperature = 'HKQuantityTypeIdentifierBasalBodyTemperature', // Basal Body Temperature,      Discrete
-  bloodPressureSystolic = 'HKQuantityTypeIdentifierBloodPressureSystolic', // Pressure,                    Discrete
-  bloodPressureDiastolic = 'HKQuantityTypeIdentifierBloodPressureDiastolic', // Pressure,                    Discrete
-  respiratoryRate = 'HKQuantityTypeIdentifierRespiratoryRate', // Scalar(Count)/Time,          Discrete
-  // Beats per minute estimate of a user's lowest heart rate while at rest
-  restingHeartRate = 'HKQuantityTypeIdentifierRestingHeartRate', // Scalar(Count)/Time,          Discrete
-  // Average heartbeats per minute captured by an Apple Watch while a user is walking
-  walkingHeartRateAverage = 'HKQuantityTypeIdentifierWalkingHeartRateAverage', // Scalar(Count)/Time,          Discrete
-  // The standard deviation of heart beat-to-beat intevals (Standard Deviation of Normal to Normal)
-
-  heartRateVariabilitySDNN = 'HKQuantityTypeIdentifierHeartRateVariabilitySDNN', // Time (ms),                   Discrete
-  // Results
-  oxygenSaturation = 'HKQuantityTypeIdentifierOxygenSaturation', // Scalar (Percent, 0.0 - 1.0,  Discrete
-  peripheralPerfusionIndex = 'HKQuantityTypeIdentifierPeripheralPerfusionIndex', // Scalar(Percent, 0.0 - 1.0),  Discrete
-  bloodGlucose = 'HKQuantityTypeIdentifierBloodGlucose', // Mass/Volume,                 Discrete
-  numberOfTimesFallen = 'HKQuantityTypeIdentifierNumberOfTimesFallen', // Scalar(Count),               Cumulative
-  electrodermalActivity = 'HKQuantityTypeIdentifierElectrodermalActivity', // Conductance,                 Discrete
-  inhalerUsage = 'HKQuantityTypeIdentifierInhalerUsage', // Scalar(Count),               Cumulative
-  insulinDelivery = 'HKQuantityTypeIdentifierInsulinDelivery', // Pharmacology (IU)            Cumulative
-  bloodAlcoholContent = 'HKQuantityTypeIdentifierBloodAlcoholContent', // Scalar(Percent, 0.0 - 1.0),  Discrete
-  forcedVitalCapacity = 'HKQuantityTypeIdentifierForcedVitalCapacity', // Volume,                      Discrete
-  forcedExpiratoryVolume1 = 'HKQuantityTypeIdentifierForcedExpiratoryVolume1', // Volume,                      Discrete
-  peakExpiratoryFlowRate = 'HKQuantityTypeIdentifierPeakExpiratoryFlowRate', // Volume/Time,                 Discrete
-  environmentalAudioExposure = 'HKQuantityTypeIdentifierEnvironmentalAudioExposure', // Pressure,                    Cumulative
-
-  headphoneAudioExposure = 'HKQuantityTypeIdentifierHeadphoneAudioExposure', // Pressure,                    Cumulative
-  // Nutrition
-  dietaryFatTotal = 'HKQuantityTypeIdentifierDietaryFatTotal', // Mass,   Cumulative
-  dietaryFatPolyunsaturated = 'HKQuantityTypeIdentifierDietaryFatPolyunsaturated', // Mass,   Cumulative
-  dietaryFatMonounsaturated = 'HKQuantityTypeIdentifierDietaryFatMonounsaturated', // Mass,   Cumulative
-  dietaryFatSaturated = 'HKQuantityTypeIdentifierDietaryFatSaturated', // Mass,   Cumulative
-  dietaryCholesterol = 'HKQuantityTypeIdentifierDietaryCholesterol', // Mass,   Cumulative
-  dietarySodium = 'HKQuantityTypeIdentifierDietarySodium', // Mass,   Cumulative
-  dietaryCarbohydrates = 'HKQuantityTypeIdentifierDietaryCarbohydrates', // Mass,   Cumulative
-  dietaryFiber = 'HKQuantityTypeIdentifierDietaryFiber', // Mass,   Cumulative
-  dietarySugar = 'HKQuantityTypeIdentifierDietarySugar', // Mass,   Cumulative
-  dietaryEnergyConsumed = 'HKQuantityTypeIdentifierDietaryEnergyConsumed', // Energy, Cumulative
-  dietaryProtein = 'HKQuantityTypeIdentifierDietaryProtein', // Mass,   Cumulative
-
-  dietaryVitaminA = 'HKQuantityTypeIdentifierDietaryVitaminA', // Mass, Cumulative
-  dietaryVitaminB6 = 'HKQuantityTypeIdentifierDietaryVitaminB6', // Mass, Cumulative
-  dietaryVitaminB12 = 'HKQuantityTypeIdentifierDietaryVitaminB12', // Mass, Cumulative
-  dietaryVitaminC = 'HKQuantityTypeIdentifierDietaryVitaminC', // Mass, Cumulative
-  dietaryVitaminD = 'HKQuantityTypeIdentifierDietaryVitaminD', // Mass, Cumulative
-  dietaryVitaminE = 'HKQuantityTypeIdentifierDietaryVitaminE', // Mass, Cumulative
-  dietaryVitaminK = 'HKQuantityTypeIdentifierDietaryVitaminK', // Mass, Cumulative
-  dietaryCalcium = 'HKQuantityTypeIdentifierDietaryCalcium', // Mass, Cumulative
-  dietaryIron = 'HKQuantityTypeIdentifierDietaryIron', // Mass, Cumulative
-  dietaryThiamin = 'HKQuantityTypeIdentifierDietaryThiamin', // Mass, Cumulative
-  dietaryRiboflavin = 'HKQuantityTypeIdentifierDietaryRiboflavin', // Mass, Cumulative
-  dietaryNiacin = 'HKQuantityTypeIdentifierDietaryNiacin', // Mass, Cumulative
-  dietaryFolate = 'HKQuantityTypeIdentifierDietaryFolate', // Mass, Cumulative
-  dietaryBiotin = 'HKQuantityTypeIdentifierDietaryBiotin', // Mass, Cumulative
-  dietaryPantothenicAcid = 'HKQuantityTypeIdentifierDietaryPantothenicAcid', // Mass, Cumulative
-  dietaryPhosphorus = 'HKQuantityTypeIdentifierDietaryPhosphorus', // Mass, Cumulative
-  dietaryIodine = 'HKQuantityTypeIdentifierDietaryIodine', // Mass, Cumulative
-  dietaryMagnesium = 'HKQuantityTypeIdentifierDietaryMagnesium', // Mass, Cumulative
-  dietaryZinc = 'HKQuantityTypeIdentifierDietaryZinc', // Mass, Cumulative
-  dietarySelenium = 'HKQuantityTypeIdentifierDietarySelenium', // Mass, Cumulative
-  dietaryCopper = 'HKQuantityTypeIdentifierDietaryCopper', // Mass, Cumulative
-  dietaryManganese = 'HKQuantityTypeIdentifierDietaryManganese', // Mass, Cumulative
-  dietaryChromium = 'HKQuantityTypeIdentifierDietaryChromium', // Mass, Cumulative
-  dietaryMolybdenum = 'HKQuantityTypeIdentifierDietaryMolybdenum', // Mass, Cumulative
-  dietaryChloride = 'HKQuantityTypeIdentifierDietaryChloride', // Mass, Cumulative
-  dietaryPotassium = 'HKQuantityTypeIdentifierDietaryPotassium', // Mass, Cumulative
-  dietaryCaffeine = 'HKQuantityTypeIdentifierDietaryCaffeine', // Mass, Cumulative
-  dietaryWater = 'HKQuantityTypeIdentifierDietaryWater', // Volume, Cumulative
-
-  // Mobility
-  sixMinuteWalkTestDistance = 'HKQuantityTypeIdentifierSixMinuteWalkTestDistance',
-  walkingSpeed = 'HKQuantityTypeIdentifierWalkingSpeed',
-  walkingStepLength = 'HKQuantityTypeIdentifierWalkingStepLength',
-  walkingAsymmetryPercentage = 'HKQuantityTypeIdentifierWalkingAsymmetryPercentage',
-  walkingDoubleSupportPercentage = 'HKQuantityTypeIdentifierWalkingDoubleSupportPercentage',
-  stairAscentSpeed = 'HKQuantityTypeIdentifierStairAscentSpeed',
-  stairDescentSpeed = 'HKQuantityTypeIdentifierStairDescentSpeed',
-
-  uvExposure = 'HKQuantityTypeIdentifierUvExposure', // Scalar (Count), Discrete
-}
-
 export enum HKAuthorizationRequestStatus {
   unknown = 0,
   shouldRequest = 1,
@@ -661,11 +668,6 @@ export type HKCorrelationRaw<TIdentifier extends HKCorrelationTypeIdentifier> =
 
 type QueryId = string;
 
-export enum HKCorrelationTypeIdentifier {
-  bloodPressure = 'HKCorrelationTypeIdentifierBloodPressure',
-  food = 'HKCorrelationTypeIdentifierFood',
-}
-
 export enum HKUpdateFrequency {
   immediate = 1,
   hourly = 2,
@@ -690,7 +692,7 @@ export type WorkoutRoute = {
   readonly HKMetadataKeySyncVersion?: number;
 };
 
-type AuthorizationStatusFor = HKCharacteristicTypeIdentifier | HKSampleTypeIdentifier
+export const HealthkitAuthorization = { ...HKCharacteristicTypeIdentifier, ...HKSampleTypeIdentifier }
 
 type ReactNativeHealthkitTypeNative = {
   isHealthDataAvailable(): Promise<boolean>;
@@ -701,11 +703,11 @@ type ReactNativeHealthkitTypeNative = {
   readonly getWheelchairUse: () => Promise<HKWheelchairUse>;
 
   readonly enableBackgroundDelivery: (
-    typeIdentifier: HKSampleTypeIdentifier,
+    typeIdentifier: ValueOf<typeof HKSampleTypeIdentifier>,
     updateFrequency: HKUpdateFrequency
   ) => Promise<boolean>;
   readonly disableBackgroundDelivery: (
-    typeIdentifier: HKSampleTypeIdentifier
+    typeIdentifier: ValueOf<typeof HKSampleTypeIdentifier>,
   ) => Promise<boolean>;
   readonly disableAllBackgroundDelivery: () => Promise<boolean>;
 
@@ -738,11 +740,11 @@ type ReactNativeHealthkitTypeNative = {
   ) => Promise<readonly HKCorrelationRaw<TIdentifier>[]>;
 
   subscribeToObserverQuery(
-    identifier: HKSampleTypeIdentifier
+    identifier: ValueOf<typeof HKSampleTypeIdentifier>
   ): Promise<QueryId>;
   unsubscribeQuery(queryId: QueryId): Promise<boolean>;
   authorizationStatusFor(
-    type: AuthorizationStatusFor
+    type: ValueOf<keyof typeof HealthkitAuthorization>
   ): Promise<boolean>;
   getRequestStatusForAuthorization(
     write: WritePermissions,
@@ -811,7 +813,7 @@ const Native = NativeModules.ReactNativeHealthkit as ReactNativeHealthkitTypeNat
 type OnChangeCallback = ({
   typeIdentifier,
 }: {
-  readonly typeIdentifier: HKSampleTypeIdentifier;
+  readonly typeIdentifier: ValueOf<typeof HKSampleTypeIdentifier>;
 }) => void;
 
 interface HealthkitEventEmitter extends NativeEventEmitter {

package/src/types.ts

@@ -26,7 +26,9 @@ import type {
   MetadataMapperForQuantityIdentifier,
   QueryStatisticsResponseRaw,
   WorkoutRoute,
+  HealthkitAuthorization,
 } from './native-types'
+import type { ValueOf } from 'type-fest'
 
 export interface QueryWorkoutsOptions<
   TEnergy extends HKUnit,
@@ -104,7 +106,7 @@ export type QueryWorkoutsFn = <
 ) => Promise<readonly HKWorkout<TEnergy, TDistance>[]>;
 
 export type AuthorizationStatusForFn = (
-  type: HKCharacteristicTypeIdentifier | HKSampleTypeIdentifier
+  type: HKCharacteristicTypeIdentifier | ValueOf<typeof HKSampleTypeIdentifier>
 ) => Promise<boolean>;
 
 export type QueryCategorySamplesFn = <T extends HKCategoryTypeIdentifier>(
@@ -112,14 +114,16 @@ export type QueryCategorySamplesFn = <T extends HKCategoryTypeIdentifier>(
   options: GenericQueryOptions
 ) => Promise<readonly HKCategorySample<T>[]>;
 
+type ReadPermission = HKCharacteristicTypeIdentifier | ValueOf<typeof HKSampleTypeIdentifier>
+
 export type GetRequestStatusForAuthorizationFn = (
-  read: readonly (HKCharacteristicTypeIdentifier | HKSampleTypeIdentifier)[],
-  write?: readonly HKSampleTypeIdentifier[]
+  read: readonly ReadPermission[],
+  write?: readonly ValueOf<typeof HKSampleTypeIdentifier>[]
 ) => Promise<HKAuthorizationRequestStatus>;
 
 export type RequestAuthorizationFn = (
-  read: readonly (HKCharacteristicTypeIdentifier | HKSampleTypeIdentifier)[],
-  write?: readonly HKSampleTypeIdentifier[]
+  read: readonly (HKCharacteristicTypeIdentifier | ValueOf<typeof HKSampleTypeIdentifier>)[],
+  write?: readonly ValueOf<typeof HKSampleTypeIdentifier>[]
 ) => Promise<boolean>;
 
 export type SaveQuantitySampleFn = <TUnit extends HKQuantityTypeIdentifier>(
@@ -142,7 +146,7 @@ export type QueryQuantitySamplesFn = <
 ) => Promise<readonly HKQuantitySample<TIdentifier, TUnit>[]>;
 
 export type SubscribeToChangesFn = (
-  identifier: HKSampleTypeIdentifier,
+  identifier: ValueOf<typeof HKSampleTypeIdentifier>,
   callback: () => void
 ) => Promise<UnsubscribeFunction>;
 
@@ -178,7 +182,7 @@ export type GetMostRecentQuantitySampleFn = <
 >(
   identifier: TIdentifier,
   unit?: TUnit
-) => Promise<HKQuantitySample<TIdentifier, TUnit>>;
+) => Promise<HKQuantitySample<TIdentifier, TUnit> | null>;
 
 export type MostRecentQuantitySampleHook = <
   TIdentifier extends HKQuantityTypeIdentifier,
@@ -262,7 +266,7 @@ export type QueryCorrelationSamplesFn = <
 ) => Promise<readonly HKCorrelation<TIdentifier>[]>;
 
 export type SubscribeToChangesHook = <
-  TIdentifier extends HKSampleTypeIdentifier
+  TIdentifier extends ValueOf<typeof HKSampleTypeIdentifier>
 >(
   identifier: TIdentifier,
   onChange: () => void,
@@ -306,11 +310,11 @@ export type ReactNativeHealthkit = {
   readonly saveCorrelationSample: SaveCorrelationSampleFn;
   readonly saveWorkoutSample: SaveWorkoutSampleFn;
   readonly enableBackgroundDelivery: (
-    typeIdentifier: HKSampleTypeIdentifier,
+    typeIdentifier: ValueOf<typeof HKSampleTypeIdentifier>,
     updateFrequency: HKUpdateFrequency
   ) => Promise<boolean>;
   readonly disableBackgroundDelivery: (
-    typeIdentifier: HKSampleTypeIdentifier
+    typeIdentifier: ValueOf<typeof HKSampleTypeIdentifier>
   ) => Promise<boolean>;
   readonly disableAllBackgroundDelivery: () => Promise<boolean>;
 
@@ -321,4 +325,9 @@ export type ReactNativeHealthkit = {
   readonly useMostRecentQuantitySample: MostRecentQuantitySampleHook;
 
   readonly useSubscribeToChanges: SubscribeToChangesHook;
+  readonly useIsHealthDataAvailable: () => boolean | null;
+  readonly useHealthkitAuthorization: (
+    read: readonly ValueOf<typeof HealthkitAuthorization>[],
+    write?: readonly ValueOf<typeof HKSampleTypeIdentifier>[],
+  ) => readonly [authorizationStatus: HKAuthorizationRequestStatus | null, request: () => Promise<HKAuthorizationRequestStatus | null>];
 };