@kingstinct/react-native-healthkit 15.1.0 → 16.0.0

package/src/healthkit.ts

@@ -1,4 +1,4 @@
-import { Platform } from 'react-native'
+import { createUnavailableHelpers } from '@react-native-healthkit/core'
 
 // Import types for default values and function signatures.
 // These types are expected to be available via the './types' export.
@@ -52,25 +52,10 @@ import type {
 
 export * from './types'
 
-const notAvailableError = `[@kingstinct/react-native-healthkit] Platform "${Platform.OS}" not supported. HealthKit is only available on iOS.`
-
-let hasWarned = false
-
-function UnavailableFnFromModule<
-  TKey extends keyof typeof ReactNativeHealthkit,
-  // biome-ignore lint/complexity/noBannedTypes: it works
-  T extends Function = (typeof ReactNativeHealthkit)[TKey],
-  // @ts-expect-error
->(_fn: TKey, defaultValue: ReturnType<T>): T {
-  // @ts-expect-error
-  return () => {
-    if (Platform.OS !== 'ios' && !hasWarned) {
-      console.warn(notAvailableError)
-      hasWarned = true
-    }
-    return defaultValue
-  }
-}
+const { unavailableFn: UnavailableFnFromModule, warnIfUnavailable } =
+  createUnavailableHelpers<typeof ReactNativeHealthkit>(
+    '@kingstinct/react-native-healthkit',
+  )
 
 // --- Mock Implementations for exported functions ---
 
@@ -185,10 +170,7 @@ export function queryQuantitySamples<T extends QuantityTypeIdentifier>(
   _identifier: T,
   _options: QueryOptionsWithSortOrderAndUnit<UnitForIdentifier<T>>,
 ): Promise<readonly QuantitySampleTyped<T>[]> {
-  if (Platform.OS !== 'ios' && !hasWarned) {
-    console.warn(notAvailableError)
-    hasWarned = true
-  }
+  warnIfUnavailable()
   return Promise.resolve([])
 }
 
@@ -198,10 +180,7 @@ export function queryQuantitySamplesWithAnchor<
   _identifier: T,
   _options: QueryOptionsWithAnchorAndUnit<UnitForIdentifier<T>>,
 ): Promise<QuantitySamplesWithAnchorResponseTyped<T>> {
-  if (Platform.OS !== 'ios' && !hasWarned) {
-    console.warn(notAvailableError)
-    hasWarned = true
-  }
+  warnIfUnavailable()
   return Promise.resolve({
     samples: [],
     deletedSamples: [],
@@ -213,10 +192,7 @@ export function queryStatisticsForQuantity<T extends QuantityTypeIdentifier>(
   _statistics: readonly StatisticsOptions[],
   _options?: StatisticsQueryOptions<UnitForIdentifier<T>>,
 ): Promise<QueryStatisticsResponse> {
-  if (Platform.OS !== 'ios' && !hasWarned) {
-    console.warn(notAvailableError)
-    hasWarned = true
-  }
+  warnIfUnavailable()
   return Promise.resolve({
     sources: [],
   })
@@ -230,10 +206,7 @@ export function queryStatisticsCollectionForQuantity<
   _intervalComponents: IntervalComponents,
   _options?: StatisticsQueryOptions<UnitForIdentifier<T>>,
 ): Promise<readonly QueryStatisticsResponse[]> {
-  if (Platform.OS !== 'ios' && !hasWarned) {
-    console.warn(notAvailableError)
-    hasWarned = true
-  }
+  warnIfUnavailable()
   return Promise.resolve([])
 }
 
@@ -244,10 +217,7 @@ export function queryStatisticsForQuantitySeparateBySource<
   _statistics: readonly StatisticsOptions[],
   _options?: StatisticsQueryOptions<UnitForIdentifier<T>>,
 ): Promise<QueryStatisticsResponseFromSingleSource[]> {
-  if (Platform.OS !== 'ios' && !hasWarned) {
-    console.warn(notAvailableError)
-    hasWarned = true
-  }
+  warnIfUnavailable()
   return Promise.resolve([])
 }
 export function queryStatisticsCollectionForQuantitySeparateBySource<
@@ -259,10 +229,7 @@ export function queryStatisticsCollectionForQuantitySeparateBySource<
   _intervalComponents: IntervalComponents,
   _options?: StatisticsQueryOptions<UnitForIdentifier<T>>,
 ): Promise<readonly QueryStatisticsResponseFromSingleSource[]> {
-  if (Platform.OS !== 'ios' && !hasWarned) {
-    console.warn(notAvailableError)
-    hasWarned = true
-  }
+  warnIfUnavailable()
   return Promise.resolve([])
 }
 export function saveQuantitySample<T extends QuantityTypeIdentifierWriteable>(
@@ -273,20 +240,14 @@ export function saveQuantitySample<T extends QuantityTypeIdentifierWriteable>(
   _end: Date,
   _metadata?: MetadataForQuantityIdentifier<T>,
 ): Promise<QuantitySampleTyped<T> | undefined> {
-  if (Platform.OS !== 'ios' && !hasWarned) {
-    console.warn(notAvailableError)
-    hasWarned = true
-  }
+  warnIfUnavailable()
   return Promise.resolve(undefined)
 }
 export function isQuantityCompatibleWithUnit<T extends QuantityTypeIdentifier>(
   _identifier: T,
   _unit: UnitForIdentifier<T>,
 ): boolean {
-  if (Platform.OS !== 'ios' && !hasWarned) {
-    console.warn(notAvailableError)
-    hasWarned = true
-  }
+  warnIfUnavailable()
   return false
 }
 
@@ -295,10 +256,7 @@ export function queryCategorySamples<T extends CategoryTypeIdentifier>(
   _categoryTypeIdentifier: T,
   _options: QueryOptionsWithSortOrder,
 ): Promise<CategorySampleTyped<T>[]> {
-  if (Platform.OS !== 'ios' && !hasWarned) {
-    console.warn(notAvailableError)
-    hasWarned = true
-  }
+  warnIfUnavailable()
   return Promise.resolve([])
 }
 
@@ -308,10 +266,7 @@ export function queryCategorySamplesWithAnchor<
   _categoryTypeIdentifier: T,
   _options: QueryOptionsWithAnchor,
 ): Promise<CategorySamplesWithAnchorResponseTyped<T>> {
-  if (Platform.OS !== 'ios' && !hasWarned) {
-    console.warn(notAvailableError)
-    hasWarned = true
-  }
+  warnIfUnavailable()
   return Promise.resolve({
     samples: [],
     deletedSamples: [],
@@ -326,10 +281,7 @@ export function saveCategorySample<T extends CategoryTypeIdentifierWriteable>(
   _endDate: Date,
   _metadata?: MetadataForCategoryIdentifier<T>,
 ): Promise<CategorySampleTyped<T> | undefined> {
-  if (Platform.OS !== 'ios' && !hasWarned) {
-    console.warn(notAvailableError)
-    hasWarned = true
-  }
+  warnIfUnavailable()
   return Promise.resolve(undefined)
 }
 
@@ -426,10 +378,7 @@ export const saveStateOfMindSample = UnavailableFnFromModule(
 export function getMostRecentCategorySample<T extends CategoryTypeIdentifier>(
   _identifier: T,
 ): Promise<CategorySampleTyped<T> | undefined> {
-  if (Platform.OS !== 'ios' && !hasWarned) {
-    console.warn(notAvailableError)
-    hasWarned = true
-  }
+  warnIfUnavailable()
   return Promise.resolve(undefined)
 }
 
@@ -437,10 +386,7 @@ export function getMostRecentQuantitySample<T extends QuantityTypeIdentifier>(
   _identifier: T,
   _unit?: UnitForIdentifier<T>,
 ): Promise<QuantitySampleTyped<T> | undefined> {
-  if (Platform.OS !== 'ios' && !hasWarned) {
-    console.warn(notAvailableError)
-    hasWarned = true
-  }
+  warnIfUnavailable()
   return Promise.resolve(undefined)
 }
 export const getMostRecentWorkout = UnavailableFnFromModule(
@@ -451,10 +397,7 @@ export const getMostRecentWorkout = UnavailableFnFromModule(
 export function getPreferredUnit<T extends QuantityTypeIdentifier>(
   _quantityType: T,
 ): Promise<UnitForIdentifier<T>> {
-  if (Platform.OS !== 'ios' && !hasWarned) {
-    console.warn(notAvailableError)
-    hasWarned = true
-  }
+  warnIfUnavailable()
   return Promise.resolve('count' as UnitForIdentifier<T>)
 }
 
@@ -462,10 +405,7 @@ export function getPreferredUnit<T extends QuantityTypeIdentifier>(
 export function useMostRecentCategorySample<T extends CategoryTypeIdentifier>(
   _categoryTypeIdentifier: T,
 ): CategorySampleTyped<T> | undefined {
-  if (Platform.OS !== 'ios' && !hasWarned) {
-    console.warn(notAvailableError)
-    hasWarned = true
-  }
+  warnIfUnavailable()
   return undefined
 }
 
@@ -473,10 +413,7 @@ export function useMostRecentQuantitySample<T extends QuantityTypeIdentifier>(
   _identifier: T,
   _unit?: UnitForIdentifier<T>,
 ): QuantitySampleTyped<T> | undefined {
-  if (Platform.OS !== 'ios' && !hasWarned) {
-    console.warn(notAvailableError)
-    hasWarned = true
-  }
+  warnIfUnavailable()
   return undefined
 }
 export const useMostRecentWorkout = UnavailableFnFromModule(
@@ -569,6 +506,11 @@ export const requestPerObjectReadAuthorization = UnavailableFnFromModule(
   Promise.resolve(undefined),
 ) // Mocking callback structure
 
+export const getEarliestAuthorizedSampleDates = UnavailableFnFromModule(
+  'getEarliestAuthorizedSampleDates',
+  Promise.resolve({}),
+)
+
 export const subscribeToCategorySamples = UnavailableFnFromModule(
   'subscribeToCategorySamples',
   {
@@ -646,6 +588,7 @@ const HealthkitModule = {
   queryMedicationEventsWithAnchor,
   requestMedicationsAuthorization,
   requestPerObjectReadAuthorization,
+  getEarliestAuthorizedSampleDates,
 
   subscribeToCategorySamples,
   currentAppSource,

package/src/specs/CoreModule.nitro.ts

@@ -118,6 +118,25 @@ export interface CoreModule extends HybridObject<{ ios: 'swift' }> {
     typeIdentifier: PerObjectTypeIdentifier,
   ): Promise<void>
 
+  /**
+   * Reports, for each of the given object types, the earliest date from which the app is
+   * authorized to read samples when the user has granted only limited access.
+   *
+   * A type is only present in the result when the user has imposed a lower time bound on
+   * the app's read access for it - types without such a bound are omitted. Use it to clamp
+   * the `startDate` of a query filter so you don't request data you can't read.
+   *
+   * Requires iOS 27. On earlier versions there is no limited-access lower bound, so this
+   * resolves to an empty object. It also resolves to an empty object - and logs a warning -
+   * when running on iOS 27 in an app built with an SDK older than iOS 27, since the
+   * underlying API cannot be called from such a binary.
+   *
+   * @see {@link https://developer.apple.com/documentation/healthkit/hkhealthstore/earliestauthorizedsampledate(for:) Apple Docs }
+   */
+  getEarliestAuthorizedSampleDates(
+    objectTypeIdentifiers: readonly ObjectTypeIdentifier[],
+  ): Promise<Record<string, Date>>
+
   deleteObjects(
     objectTypeIdentifier: SampleTypeIdentifierWriteable,
     filter: FilterForSamples,

package/src/specs/SourceProxy.nitro.ts

@@ -1,9 +1,7 @@
+import type { Source } from '@react-native-healthkit/core'
 import type { HybridObject } from 'react-native-nitro-modules'
 
-export interface Source {
-  readonly name: string
-  readonly bundleIdentifier: string
-}
+export type { Source }
 
 /**
  * @see {@link https://developer.apple.com/documentation/healthkit/hkobject/1615781-source Apple Docs }

package/src/test-setup.ts

@@ -50,6 +50,7 @@ const mockModule = {
   isObjectTypeAvailableAsync: jest.fn(),
   areObjectTypesAvailable: jest.fn(),
   areObjectTypesAvailableAsync: jest.fn(),
+  getEarliestAuthorizedSampleDates: jest.fn(),
   queryStateOfMindSamples: jest.fn(),
   workoutSessionMirroringStartHandler: jest.fn(),
 }

package/src/types/Auth.ts

@@ -1,17 +1,4 @@
-/**
- * @see {@link https://developer.apple.com/documentation/healthkit/hkauthorizationrequeststatus Apple Docs }
- */
-export enum AuthorizationRequestStatus {
-  unknown = 0,
-  shouldRequest = 1,
-  unnecessary = 2,
-}
-
-/**
- * @see {@link https://developer.apple.com/documentation/healthkit/hkauthorizationstatus Apple Docs }
- */
-export enum AuthorizationStatus {
-  notDetermined = 0,
-  sharingDenied = 1,
-  sharingAuthorized = 2,
-}
+export {
+  AuthorizationRequestStatus,
+  AuthorizationStatus,
+} from '@react-native-healthkit/core'

package/src/types/Background.ts

@@ -1,9 +1 @@
-/**
- * @see {@link https://developer.apple.com/documentation/healthkit/hkupdatefrequency Apple Docs }
- */
-export enum UpdateFrequency {
-  immediate = 1,
-  hourly = 2,
-  daily = 3,
-  weekly = 4,
-}
+export { UpdateFrequency } from '@react-native-healthkit/core'

package/src/types/Device.ts

@@ -1,13 +1 @@
-/**
- * @see {@link https://developer.apple.com/documentation/healthkit/hkdevice Apple Docs }
- */
-export interface Device {
-  readonly name?: string // ex: "Apple Watch"
-  readonly firmwareVersion?: string
-  readonly hardwareVersion?: string // ex: "Watch6,2",
-  readonly localIdentifier?: string
-  readonly manufacturer?: string // ex: "Apple Inc."
-  readonly model?: string // ex: "Watch"
-  readonly softwareVersion?: string // ex: "9.0"
-  readonly udiDeviceIdentifier?: string
-}
+export type { Device } from '@react-native-healthkit/core'

package/src/types/QuantityType.ts

@@ -3,11 +3,11 @@ import {
   HeartRateMotionContext,
   InsulinDeliveryReason,
 } from '../generated/healthkit.generated'
-import type { Source } from '../specs/SourceProxy.nitro'
 import type { QuantitySample, QuantitySampleTyped } from './QuantitySample'
 import type { QuantityTypeIdentifier } from './QuantityTypeIdentifier'
 import type { FilterForSamples } from './QueryOptions'
 import type { DeletedSample } from './Shared'
+import type { Source } from './Source'
 
 export { HeartRateMotionContext, InsulinDeliveryReason }
 

package/src/types/QueryOptions.ts

@@ -1,71 +1,13 @@
+import type {
+  DateFilter,
+  PredicateWithMetadataKey,
+  StrictUnion,
+} from '@react-native-healthkit/core'
 import type { SourceProxy } from '../specs/SourceProxy.nitro'
 import type { WorkoutProxy } from '../specs/WorkoutProxy.nitro'
 
-export enum ComparisonPredicateOperator {
-  lessThan = 0,
-
-  lessThanOrEqualTo = 1,
-
-  greaterThan = 2,
-
-  greaterThanOrEqualTo = 3,
-
-  equalTo = 4,
-
-  notEqualTo = 5,
-
-  matches = 6,
-
-  like = 7,
-
-  beginsWith = 8,
-
-  endsWith = 9,
-
-  IN = 10,
-
-  customSelector = 11,
-
-  contains = 99,
-
-  between = 100,
-}
-
-type PredicateWithMetadataValue = string | number | Date | boolean
-
-export interface PredicateWithMetadataKey {
-  readonly withMetadataKey: string
-  readonly operatorType?: ComparisonPredicateOperator
-  readonly value?: PredicateWithMetadataValue
-}
-// Computes and flattens object types
-// biome-ignore lint/complexity/noBannedTypes: it works
-type ComputeRaw<A> = A extends Function ? A : { [K in keyof A]: A[K] } & {}
-
-// Gets all keys from a union of objects
-// biome-ignore lint/suspicious/noExplicitAny: it works
-type AllKeys<U> = U extends any ? keyof U : never
-
-// The core: for each member U in the union,
-// add `?: never` for any key that exists in other union members.
-// biome-ignore lint/suspicious/noExplicitAny: it works
-type _Strict<U, UAll extends U = U> = U extends any
-  ? ComputeRaw<
-      U & {
-        [K in Exclude<AllKeys<UAll>, keyof U>]?: never
-      }
-    >
-  : never
-
-// The exported type you can copy into your codebase
-export type StrictUnion<U extends object> = _Strict<U>
-
-export interface DateFilter {
-  readonly startDate?: Date
-  readonly endDate?: Date
-  readonly strictEndDate?: boolean
-  readonly strictStartDate?: boolean
-}
+export { ComparisonPredicateOperator } from '@react-native-healthkit/core'
+export type { DateFilter, PredicateWithMetadataKey, StrictUnion }
 
 export interface FilterForSamplesBase {
   readonly uuid?: string

package/src/types/Shared.ts

@@ -1,3 +1,9 @@
+import type {
+  BaseObject,
+  BaseSample,
+  DeletedSample,
+  SampleType,
+} from '@react-native-healthkit/core'
 import type { AnyMap } from 'react-native-nitro-modules'
 import type {
   KnownObjectMetadata,
@@ -20,17 +26,12 @@ import type {
   WorkoutTypeIdentifier,
 } from './Constants'
 import type { CorrelationTypeIdentifier } from './CorrelationType'
-import type { Device } from './Device'
 import type {
   QuantityTypeIdentifier,
   QuantityTypeIdentifierWriteable,
 } from './QuantityTypeIdentifier'
-import type { SourceRevision } from './Source'
 
-export interface DeletedSample {
-  readonly uuid: string
-  readonly metadata?: AnyMap
-}
+export type { BaseObject, BaseSample, DeletedSample, SampleType }
 
 export type ObjectTypeIdentifier =
   | CharacteristicTypeIdentifier
@@ -80,25 +81,3 @@ export type BaseObjectTyped<TMetadata extends object = KnownObjectMetadata> =
   WithTypedMetadata<BaseObject, TMetadata>
 export type BaseSampleTyped<TMetadata extends object = KnownSampleMetadata> =
   WithTypedMetadata<BaseSample, TMetadata>
-
-export interface BaseObject {
-  readonly uuid: string
-  readonly sourceRevision: SourceRevision
-  readonly device?: Device
-  readonly metadata: AnyMap
-}
-
-export interface SampleType {
-  identifier: string
-  allowsRecalibrationForEstimates: boolean
-  isMinimumDurationRestricted: boolean
-  isMaximumDurationRestricted: boolean
-}
-
-export interface BaseSample extends BaseObject {
-  readonly sampleType: SampleType
-  readonly startDate: Date
-  readonly endDate: Date
-  readonly hasUndeterminedDuration: boolean
-  readonly metadata: AnyMap
-}

package/src/types/Source.ts

@@ -1,11 +1 @@
-import type { Source } from '../specs/SourceProxy.nitro'
-
-/**
- * @see {@link https://developer.apple.com/documentation/healthkit/hkobject/1615483-sourcerevision Apple Docs }
- */
-export interface SourceRevision {
-  readonly source: Source
-  readonly version?: string
-  readonly operatingSystemVersion: string
-  readonly productType?: string
-}
+export type { Source, SourceRevision } from '@react-native-healthkit/core'

package/src/types/Subscriptions.ts

@@ -1,12 +1,11 @@
+import type { EmitterSubscription } from '@react-native-healthkit/core'
 import type { CategorySampleTyped } from './CategoryType'
 import type { CategoryTypeIdentifier } from './CategoryTypeIdentifier'
 import type { QuantitySampleTyped } from './QuantitySample'
 import type { QuantityTypeIdentifier } from './QuantityTypeIdentifier'
 import type { SampleTypeIdentifier } from './Shared'
 
-export interface EmitterSubscription {
-  remove: () => void
-}
+export type { EmitterSubscription }
 
 export interface OnChangeCallbackArgs {
   readonly typeIdentifier: SampleTypeIdentifier