@kingstinct/react-native-healthkit 14.0.2 → 15.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kingstinct/react-native-healthkit",
-  "version": "14.0.2",
+  "version": "15.1.0",
   "description": "React Native bindings for HealthKit",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
@@ -58,13 +58,15 @@
     "build:cjs": "tsc -p tsconfig.cjs.json",
     "build:esm": "tsc -p tsconfig.esm.json",
     "build:types": "tsc -p tsconfig.declarations.json",
-    "build": "bun run clean && bun run build:cjs && bun run build:esm && bun run build:types",
+    "build": "bun run clean && bun run build:cjs && bun run build:esm && bun run build:types && bun run build:plugin",
+    "build:plugin": "bun ../../scripts/build-app-plugin.ts",
     "typecheck": "tsc --noEmit -p tsconfig.json && tsc --noEmit -p tsconfig.type-tests.json",
     "lint": "bunx @biomejs/biome format --write",
     "check:generated": "bun run generate:healthkit && bun run verify:healthkit-sdk && git diff --exit-code -- src/generated/healthkit.generated.ts src/generated/healthkit-schema.json ../../apps/example/contracts/generated ios/generated",
     "codegen": "bun run build && nitrogen --logLevel=\"debug\" && perl -i -pe 's/Bool\\(fromCxx: cachedCxxPart\\)/cachedCxxPart.use_count() > 0/g' nitrogen/generated/ios/swift/*Spec_cxx.swift",
     "test": "bun test",
-    "prepublishOnly": "bun run build && bun run codegen"
+    "prepublishOnly": "bun run build && bun run codegen",
+    "prepack": "test -f app.plugin.js || { echo \"app.plugin.js is missing; run bun run build:plugin (it is generated, not committed)\" >&2; exit 1; }"
   },
   "keywords": [
     "react-native",

package/src/generated/healthkit-schema.json

@@ -156,7 +156,7 @@
       "name": "HKQuantityTypeIdentifierCyclingCadence",
       "ios": "17.0",
       "canonicalUnit": "count/min",
-      "aggregationStyle": "Discrete (Arithmetic)",
+      "aggregationStyle": "Discrete (Temporally Weighted)",
       "writeable": true,
       "legacy": false
     },
@@ -172,7 +172,7 @@
       "name": "HKQuantityTypeIdentifierCyclingPower",
       "ios": "17.0",
       "canonicalUnit": "W",
-      "aggregationStyle": "Discrete (Arithmetic)",
+      "aggregationStyle": "Discrete (Temporally Weighted)",
       "writeable": true,
       "legacy": false
     },
@@ -180,7 +180,7 @@
       "name": "HKQuantityTypeIdentifierCyclingSpeed",
       "ios": "17.0",
       "canonicalUnit": "m/s",
-      "aggregationStyle": "Discrete (Arithmetic)",
+      "aggregationStyle": "Discrete (Temporally Weighted)",
       "writeable": true,
       "legacy": false
     },
@@ -772,7 +772,7 @@
       "name": "HKQuantityTypeIdentifierRestingHeartRate",
       "ios": "11.0",
       "canonicalUnit": "count/min",
-      "aggregationStyle": "Discrete (Arithmetic)",
+      "aggregationStyle": "Discrete (Temporally Weighted)",
       "writeable": true,
       "legacy": false
     },
@@ -924,7 +924,7 @@
       "name": "HKQuantityTypeIdentifierWalkingHeartRateAverage",
       "ios": "11.0",
       "canonicalUnit": "count/min",
-      "aggregationStyle": "Discrete (Arithmetic)",
+      "aggregationStyle": "Discrete (Temporally Weighted)",
       "writeable": false,
       "legacy": false
     },
@@ -1011,6 +1011,13 @@
       "writeable": true,
       "legacy": false
     },
+    {
+      "name": "HKCategoryTypeIdentifierBleedingAfterMenopause",
+      "ios": "27.0",
+      "valueEnum": "HKCategoryValueVaginalBleeding",
+      "writeable": true,
+      "legacy": false
+    },
     {
       "name": "HKCategoryTypeIdentifierBleedingAfterPregnancy",
       "ios": "18.0",
@@ -1270,6 +1277,13 @@
       "writeable": true,
       "legacy": false
     },
+    {
+      "name": "HKCategoryTypeIdentifierMenopausalState",
+      "ios": "27.0",
+      "valueEnum": "HKCategoryValueMenopausalState",
+      "writeable": true,
+      "legacy": false
+    },
     {
       "name": "HKCategoryTypeIdentifierMenstrualFlow",
       "ios": "9.0",
@@ -1747,6 +1761,27 @@
         }
       ]
     },
+    {
+      "name": "CategoryValueMenopausalState",
+      "ios": "27.0",
+      "members": [
+        {
+          "name": "menopause",
+          "swiftName": "HKCategoryValueMenopausalStateMenopause",
+          "rawValue": 1
+        },
+        {
+          "name": "perimenopause",
+          "swiftName": "HKCategoryValueMenopausalStatePerimenopause",
+          "rawValue": 2
+        },
+        {
+          "name": "none",
+          "swiftName": "HKCategoryValueMenopausalStateNone",
+          "rawValue": 3
+        }
+      ]
+    },
     {
       "name": "CategoryValueMenstrualFlow",
       "ios": "9.0",
@@ -2806,6 +2841,16 @@
           "swiftName": "HKWorkoutActivityTypeUnderwaterDiving",
           "rawValue": 84
         },
+        {
+          "name": "rest",
+          "swiftName": "HKWorkoutActivityTypeRest",
+          "rawValue": 2998
+        },
+        {
+          "name": "group",
+          "swiftName": "HKWorkoutActivityTypeGroup",
+          "rawValue": 2999
+        },
         {
           "name": "other",
           "swiftName": "HKWorkoutActivityTypeOther",

package/src/generated/healthkit.generated.ts

@@ -153,6 +153,7 @@ export type CategoryTypeIdentifierWriteable =
   | 'HKCategoryTypeIdentifierAppleWalkingSteadinessEvent'
   | 'HKCategoryTypeIdentifierAudioExposureEvent'
   | 'HKCategoryTypeIdentifierBladderIncontinence'
+  | 'HKCategoryTypeIdentifierBleedingAfterMenopause'
   | 'HKCategoryTypeIdentifierBleedingAfterPregnancy'
   | 'HKCategoryTypeIdentifierBleedingDuringPregnancy'
   | 'HKCategoryTypeIdentifierBloating'
@@ -186,6 +187,7 @@ export type CategoryTypeIdentifierWriteable =
   | 'HKCategoryTypeIdentifierLowCardioFitnessEvent'
   | 'HKCategoryTypeIdentifierLowerBackPain'
   | 'HKCategoryTypeIdentifierMemoryLapse'
+  | 'HKCategoryTypeIdentifierMenopausalState'
   | 'HKCategoryTypeIdentifierMenstrualFlow'
   | 'HKCategoryTypeIdentifierMindfulSession'
   | 'HKCategoryTypeIdentifierMoodChanges'
@@ -345,6 +347,7 @@ export const CATEGORY_IDENTIFIER_IOS_AVAILABILITY = {
   HKCategoryTypeIdentifierAppleWalkingSteadinessEvent: '15.0',
   HKCategoryTypeIdentifierAudioExposureEvent: '13.0',
   HKCategoryTypeIdentifierBladderIncontinence: '14.0',
+  HKCategoryTypeIdentifierBleedingAfterMenopause: '27.0',
   HKCategoryTypeIdentifierBleedingAfterPregnancy: '18.0',
   HKCategoryTypeIdentifierBleedingDuringPregnancy: '18.0',
   HKCategoryTypeIdentifierBloating: '13.6',
@@ -382,6 +385,7 @@ export const CATEGORY_IDENTIFIER_IOS_AVAILABILITY = {
   HKCategoryTypeIdentifierLowerBackPain: '13.6',
   HKCategoryTypeIdentifierLowHeartRateEvent: '12.2',
   HKCategoryTypeIdentifierMemoryLapse: '14.0',
+  HKCategoryTypeIdentifierMenopausalState: '27.0',
   HKCategoryTypeIdentifierMenstrualFlow: '9.0',
   HKCategoryTypeIdentifierMindfulSession: '10.0',
   HKCategoryTypeIdentifierMoodChanges: '13.6',
@@ -540,6 +544,8 @@ export const CATEGORY_IDENTIFIER_VALUE_ENUMS = {
     'CategoryValueAppleWalkingSteadinessEvent',
   HKCategoryTypeIdentifierAudioExposureEvent: null,
   HKCategoryTypeIdentifierBladderIncontinence: 'CategoryValueSeverity',
+  HKCategoryTypeIdentifierBleedingAfterMenopause:
+    'CategoryValueVaginalBleeding',
   HKCategoryTypeIdentifierBleedingAfterPregnancy:
     'CategoryValueVaginalBleeding',
   HKCategoryTypeIdentifierBleedingDuringPregnancy:
@@ -583,6 +589,7 @@ export const CATEGORY_IDENTIFIER_VALUE_ENUMS = {
   HKCategoryTypeIdentifierLowerBackPain: 'CategoryValueSeverity',
   HKCategoryTypeIdentifierLowHeartRateEvent: 'CategoryValue',
   HKCategoryTypeIdentifierMemoryLapse: 'CategoryValueSeverity',
+  HKCategoryTypeIdentifierMenopausalState: 'CategoryValueMenopausalState',
   HKCategoryTypeIdentifierMenstrualFlow: 'CategoryValueMenstrualFlow',
   HKCategoryTypeIdentifierMindfulSession: 'CategoryValue',
   HKCategoryTypeIdentifierMoodChanges: 'CategoryValuePresence',
@@ -683,6 +690,11 @@ export enum CategoryValueHeadphoneAudioExposureEvent {
 export enum CategoryValueLowCardioFitnessEvent {
   lowFitness = 1,
 }
+export enum CategoryValueMenopausalState {
+  menopause = 1,
+  perimenopause = 2,
+  none = 3,
+}
 export enum CategoryValueMenstrualFlow {
   unspecified = 1,
   light = 2,
@@ -911,6 +923,8 @@ export enum WorkoutActivityType {
   swimBikeRun = 82,
   transition = 83,
   underwaterDiving = 84,
+  rest = 2998,
+  group = 2999,
   other = 3000,
 }
 export enum WorkoutEventType {
@@ -935,6 +949,7 @@ export interface CategoryValueByIdentifierMap {
   readonly HKCategoryTypeIdentifierAppleStandHour: CategoryValueAppleStandHour
   readonly HKCategoryTypeIdentifierAppleWalkingSteadinessEvent: CategoryValueAppleWalkingSteadinessEvent
   readonly HKCategoryTypeIdentifierBladderIncontinence: CategoryValueSeverity
+  readonly HKCategoryTypeIdentifierBleedingAfterMenopause: CategoryValueVaginalBleeding
   readonly HKCategoryTypeIdentifierBleedingAfterPregnancy: CategoryValueVaginalBleeding
   readonly HKCategoryTypeIdentifierBleedingDuringPregnancy: CategoryValueVaginalBleeding
   readonly HKCategoryTypeIdentifierBloating: CategoryValueSeverity
@@ -972,6 +987,7 @@ export interface CategoryValueByIdentifierMap {
   readonly HKCategoryTypeIdentifierLowerBackPain: CategoryValueSeverity
   readonly HKCategoryTypeIdentifierLowHeartRateEvent: CategoryValue
   readonly HKCategoryTypeIdentifierMemoryLapse: CategoryValueSeverity
+  readonly HKCategoryTypeIdentifierMenopausalState: CategoryValueMenopausalState
   readonly HKCategoryTypeIdentifierMenstrualFlow: CategoryValueMenstrualFlow
   readonly HKCategoryTypeIdentifierMindfulSession: CategoryValue
   readonly HKCategoryTypeIdentifierMoodChanges: CategoryValuePresence
@@ -1125,7 +1141,7 @@ export type CategoryTypedMetadataForIdentifierGenerated<
 > = KnownSampleMetadata &
   (T extends keyof CategorySpecificMetadataByIdentifierMap
     ? CategorySpecificMetadataByIdentifierMap[T]
-    : Record<string, never>)
+    : unknown)
 export interface QuantitySpecificMetadataByIdentifierMap {
   readonly HKQuantityTypeIdentifierBasalBodyTemperature: Pick<
     QuantityTypedMetadata,
@@ -1165,7 +1181,7 @@ export type QuantityTypedMetadataForIdentifierGenerated<
   > &
   (T extends keyof QuantitySpecificMetadataByIdentifierMap
     ? QuantitySpecificMetadataByIdentifierMap[T]
-    : Record<string, never>)
+    : unknown)
 export interface QuantityUnitByIdentifierMap {
   readonly HKQuantityTypeIdentifierActiveEnergyBurned: EnergyUnit
   readonly HKQuantityTypeIdentifierAppleExerciseTime: TimeUnit

package/src/healthkit.ios.ts

@@ -368,6 +368,8 @@ export const saveWorkoutSample = WorkoutBindings.saveWorkoutSample
 export const startWatchApp =
   Workouts.startWatchAppWithWorkoutConfiguration.bind(Workouts)
 export const isProtectedDataAvailable = Core.isProtectedDataAvailable.bind(Core)
+export const isProtectedDataAvailableAsync =
+  Core.isProtectedDataAvailableAsync.bind(Core)
 export const queryStateOfMindSamples =
   StateOfMindBindings.queryStateOfMindSamples
 export const queryStateOfMindSamplesWithAnchor =
@@ -461,6 +463,7 @@ export default {
   subscribeToQuantitySamples,
   startWatchApp,
   isProtectedDataAvailable,
+  isProtectedDataAvailableAsync,
   queryStateOfMindSamples,
   queryStateOfMindSamplesWithAnchor,
   saveStateOfMindSample,

package/src/healthkit.ts

@@ -137,6 +137,10 @@ export const isProtectedDataAvailable = UnavailableFnFromModule(
   'isProtectedDataAvailable',
   false,
 )
+export const isProtectedDataAvailableAsync = UnavailableFnFromModule(
+  'isProtectedDataAvailableAsync',
+  Promise.resolve(false),
+)
 export const isObjectTypeAvailable = UnavailableFnFromModule(
   'isObjectTypeAvailable',
   false,
@@ -630,6 +634,7 @@ const HealthkitModule = {
   subscribeToChanges,
   startWatchApp,
   isProtectedDataAvailable,
+  isProtectedDataAvailableAsync,
   queryStateOfMindSamples,
   queryStateOfMindSamplesWithAnchor,
   saveStateOfMindSample,

package/src/specs/CoreModule.nitro.ts

@@ -41,13 +41,15 @@ export interface CoreModule extends HybridObject<{ ios: 'swift' }> {
   disableAllBackgroundDelivery(): Promise<boolean>
 
   /**
-   * Configure background delivery types that will be registered natively in
-   * AppDelegate.didFinishLaunchingWithOptions — surviving app termination.
+   * Configure background delivery types whose observer queries are registered
+   * natively at launch (during didFinishLaunchingWithOptions), so background
+   * delivery survives app termination.
    * Types and frequency are persisted to UserDefaults so they're available
    * before the JS bridge boots on subsequent cold launches.
    *
-   * Requires the Expo config plugin with `background: true` (default) or
-   * manual AppDelegate setup: `BackgroundDeliveryManager.shared.setupBackgroundObservers()`
+   * Requires the background-delivery entitlement (added by the config plugin
+   * unless `background: false`). No AppDelegate change is needed; the pod
+   * registers the observers on UIApplicationDidFinishLaunchingNotification.
    */
   configureBackgroundTypes(
     typeIdentifiers: string[],

package/src/specs/SourceProxy.nitro.ts

@@ -1,6 +1,6 @@
 import type { HybridObject } from 'react-native-nitro-modules'
 
-interface Source {
+export interface Source {
   readonly name: string
   readonly bundleIdentifier: string
 }

package/src/type-tests/generated-typing.ts

@@ -7,13 +7,18 @@ import type {
   CategoryValueSleepAnalysis,
   CorrelationSampleTyped,
   HeartRateMotionContext,
+  InsulinDeliveryReason,
+  MetadataForQuantityIdentifier,
   Quantity,
   QuantitySampleTyped,
+  QuantityTypeIdentifier,
+  QuantityTypeIdentifierWriteable,
   QueryOptionsWithAnchorAndUnit,
   QueryOptionsWithSortOrderAndUnit,
   StateOfMindSampleTyped,
   StatisticsQueryOptions,
   SwimmingStrokeStyle,
+  UnitForIdentifier,
   WorkoutEventTyped,
   WorkoutSampleTyped,
 } from '../types'
@@ -25,6 +30,13 @@ type Equal<A, B> =
 
 type Assert<T extends true> = T
 
+// Mirrors saveQuantitySample(identifier, unit, value, start, end, metadata?).
+type AssertSaveQuantitySampleCall<
+  T extends QuantityTypeIdentifierWriteable,
+  _TUnit extends UnitForIdentifier<T>,
+  _TMetadata extends MetadataForQuantityIdentifier<T>,
+> = true
+
 type _sleepAnalysisValuesAreTyped = Assert<
   Equal<
     CategoryValueForIdentifier<'HKCategoryTypeIdentifierSleepAnalysis'>,
@@ -38,6 +50,13 @@ type _newCategoryIdentifierFromSdkIsPresent = Assert<
     : false
 >
 
+// Apple has never shipped a blood ketones quantity type (see issue #379).
+type _bloodKetonesIdentifierIsAbsent = Assert<
+  'HKQuantityTypeIdentifierBloodKetones' extends QuantityTypeIdentifier
+    ? false
+    : true
+>
+
 type _heartRateMetadataNarrowsToEnum = Assert<
   Equal<
     QuantitySampleTyped<'HKQuantityTypeIdentifierHeartRate'>['metadata']['HKHeartRateMotionContext'],
@@ -80,6 +99,23 @@ type _bloodGlucoseUnitNarrows = Assert<
   >
 >
 
+type _saveQuantitySampleBodyMassAcceptsAppSpecificMetadata =
+  AssertSaveQuantitySampleCall<
+    'HKQuantityTypeIdentifierBodyMass',
+    'kg',
+    { APP_CUSTOM_KEY: 'v1'; HKWasUserEntered: true }
+  >
+
+type _saveQuantitySampleInsulinAcceptsOfficialAndAppSpecificMetadata =
+  AssertSaveQuantitySampleCall<
+    'HKQuantityTypeIdentifierInsulinDelivery',
+    'IU',
+    {
+      HKInsulinDeliveryReason: InsulinDeliveryReason.basal
+      APP_CUSTOM_KEY: 'v1'
+    }
+  >
+
 type _quantityQueryOptionsUnitNarrows = Assert<
   Equal<
     QueryOptionsWithSortOrderAndUnit<BloodGlucoseUnit>['unit'],

package/src/types/QuantityType.ts

@@ -3,7 +3,7 @@ import {
   HeartRateMotionContext,
   InsulinDeliveryReason,
 } from '../generated/healthkit.generated'
-import type { SourceProxy } from '../specs/SourceProxy.nitro'
+import type { Source } from '../specs/SourceProxy.nitro'
 import type { QuantitySample, QuantitySampleTyped } from './QuantitySample'
 import type { QuantityTypeIdentifier } from './QuantityTypeIdentifier'
 import type { FilterForSamples } from './QueryOptions'
@@ -26,12 +26,12 @@ export interface QueryStatisticsResponse {
   readonly duration?: Quantity
   readonly startDate?: Date
   readonly endDate?: Date
-  sources: SourceProxy[]
+  readonly sources: readonly Source[]
 }
 
 export interface QueryStatisticsResponseFromSingleSource
   extends Omit<QueryStatisticsResponse, 'sources'> {
-  readonly source: SourceProxy
+  readonly source: Source
 }
 
 export enum AggregationStyle {

package/src/types/Source.ts

@@ -1,10 +1,10 @@
-import type { SourceProxy } from '../specs/SourceProxy.nitro'
+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: SourceProxy
+  readonly source: Source
   readonly version?: string
   readonly operatingSystemVersion: string
   readonly productType?: string

package/src/types/Workouts.ts

@@ -36,6 +36,7 @@ export interface WorkoutActivity {
   readonly endDate: Date
   readonly uuid: string
   readonly duration: number
+  readonly activityType: WorkoutActivityType
 }
 
 export interface WorkoutRoute {