@kingstinct/react-native-healthkit 8.7.2 → 9.0.0

package/src/types/Workouts.ts

@@ -0,0 +1,282 @@
+import type { AnyMap } from 'react-native-nitro-modules'
+import type { WorkoutProxy } from '../specs/WorkoutProxy.nitro'
+import type { Device } from './Device'
+import type { Quantity } from './QuantityType'
+import type { PredicateForSamples } from './QueryOptions'
+import type { DeletedSample, GenericMetadata } from './Shared'
+import type { SourceRevision } from './Source'
+
+export enum WorkoutActivityType {
+  americanFootball = 1,
+  archery = 2,
+  australianFootball = 3,
+  badminton = 4,
+  baseball = 5,
+  basketball = 6,
+  bowling = 7,
+  boxing = 8, // See also HKWorkoutActivityTypeKickboxing.,
+  climbing = 9,
+  cricket = 10,
+  crossTraining = 11, // Any mix of cardio and/or strength training. See also HKWorkoutActivityTypeCoreTraining and HKWorkoutActivityTypeFlexibility.,
+  curling = 12,
+  cycling = 13,
+  dance = 14,
+  danceInspiredTraining = 15, // This enum remains available to access older data.,
+  elliptical = 16,
+  equestrianSports = 17, // Polo, Horse Racing, Horse Riding, etc.,
+  fencing = 18,
+  fishing = 19,
+  functionalStrengthTraining = 20, // Primarily free weights and/or body weight and/or accessories,
+  golf = 21,
+  gymnastics = 22,
+  handball = 23,
+  hiking = 24,
+  hockey = 25, // Ice Hockey, Field Hockey, etc.,
+  hunting = 26,
+  lacrosse = 27,
+  martialArts = 28,
+  mindAndBody = 29, // Qigong, meditation, etc.,
+  mixedMetabolicCardioTraining = 30, // This enum remains available to access older data.,
+  paddleSports = 31, // Canoeing, Kayaking, Outrigger, Stand Up Paddle Board, etc.,
+  play = 32, // Dodge Ball, Hopscotch, Tetherball, Jungle Gym, etc.,
+  preparationAndRecovery = 33, // Foam rolling, stretching, etc.,
+  racquetball = 34,
+  rowing = 35,
+  rugby = 36,
+  running = 37,
+  sailing = 38,
+  skatingSports = 39, // Ice Skating, Speed Skating, Inline Skating, Skateboarding, etc.,
+  snowSports = 40, // Sledding, Snowmobiling, Building a Snowman, etc. See also HKWorkoutActivityTypeCrossCountrySkiing, HKWorkoutActivityTypeSnowboarding, and HKWorkoutActivityTypeDownhillSkiing.,
+  soccer = 41,
+  softball = 42,
+  squash = 43,
+  stairClimbing = 44, // See also HKWorkoutActivityTypeStairs and HKWorkoutActivityTypeStepTraining.,
+  surfingSports = 45, // Traditional Surfing, Kite Surfing, Wind Surfing, etc.,
+  swimming = 46,
+  tableTennis = 47,
+  tennis = 48,
+  trackAndField = 49, // Shot Put, Javelin, Pole Vaulting, etc.,
+  traditionalStrengthTraining = 50, // Primarily machines and/or free weights,
+  volleyball = 51,
+  walking = 52,
+  waterFitness = 53,
+  waterPolo = 54,
+  waterSports = 55, // Water Skiing, Wake Boarding, etc.,
+  wrestling = 56,
+  yoga = 57,
+  barre = 58, // HKWorkoutActivityTypeDanceInspiredTraining,
+  coreTraining = 59,
+  crossCountrySkiing = 60,
+  downhillSkiing = 61,
+  flexibility = 62,
+  highIntensityIntervalTraining = 63,
+  jumpRope = 64,
+  kickboxing = 65,
+  pilates = 66, // HKWorkoutActivityTypeDanceInspiredTraining,
+  snowboarding = 67,
+  stairs = 68,
+  stepTraining = 69,
+  wheelchairWalkPace = 70,
+  wheelchairRunPace = 71,
+  taiChi = 72,
+  mixedCardio = 73, // HKWorkoutActivityTypeMixedMetabolicCardioTraining,
+  handCycling = 74,
+  discSports = 75,
+  fitnessGaming = 76,
+  cardioDance = 77,
+  socialDance = 78,
+  pickleball = 79,
+  cooldown = 80,
+  swimBikeRun = 82,
+  transition = 83,
+  underwaterDiving = 84,
+  other = 3000,
+}
+
+// documented at https://developer.apple.com/documentation/healthkit/hkweathercondition
+export enum WeatherCondition {
+  none = 0,
+  clear = 1,
+  fair = 2,
+  partlyCloudy = 3,
+  mostlyCloudy = 4,
+  cloudy = 5,
+  foggy = 6,
+  haze = 7,
+  windy = 8,
+  blustery = 9,
+  smoky = 10,
+  dust = 11,
+  snow = 12,
+  hail = 13,
+  sleet = 14,
+  freezingDrizzle = 15,
+  freezingRain = 16,
+  mixedRainAndHail = 17,
+  mixedRainAndSnow = 18,
+  mixedRainAndSleet = 19,
+  mixedSnowAndSleet = 20,
+  drizzle = 21,
+  scatteredShowers = 22,
+  showers = 23,
+  thunderstorms = 24,
+  tropicalStorm = 25,
+  hurricane = 26,
+  tornado = 27,
+}
+
+export interface WorkoutMetadata extends GenericMetadata {
+  readonly HKWeatherCondition?: WeatherCondition
+  readonly HKWeatherHumidity?: Quantity
+  readonly HKWeatherTemperature?: Quantity
+  readonly HKAverageMETs?: Quantity
+  readonly HKElevationAscended?: Quantity
+  readonly HKIndoorWorkout?: boolean
+}
+
+export interface WorkoutEvent {
+  readonly type: WorkoutEventType
+  readonly startDate: Date
+  readonly endDate: Date
+}
+
+export enum WorkoutEventType {
+  pause = 1,
+  resume = 2,
+  lap = 3,
+  marker = 4,
+  motionPaused = 5,
+  motionResumed = 6,
+  segment = 7,
+  pauseOrResumeRequest = 8,
+}
+
+export interface WorkoutActivity {
+  readonly startDate: Date
+  readonly endDate: Date
+  readonly uuid: string
+  readonly duration: number
+}
+
+export interface WorkoutRoute {
+  readonly locations: readonly WorkoutRouteLocation[]
+  readonly HKMetadataKeySyncIdentifier?: string
+  readonly HKMetadataKeySyncVersion?: number
+}
+
+export interface QueryWorkoutSamplesWithAnchorResponse {
+  readonly workouts: readonly WorkoutProxy[]
+  readonly deletedSamples: readonly DeletedSample[]
+  readonly newAnchor: string
+}
+
+type WorkoutActivityTypePredicate = {
+  readonly workoutActivityType: WorkoutActivityType
+}
+
+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 WorkoutDurationPredicate = {
+  readonly predicateOperator: ComparisonPredicateOperator
+  readonly durationInSeconds: number
+}
+
+export type PredicateForWorkouts =
+  | PredicateForSamples
+  | WorkoutActivityTypePredicate
+  | WorkoutDurationPredicate
+
+export type PredicateForWorkoutsOr = {
+  readonly OR: readonly PredicateForWorkouts[]
+}
+
+export type PredicateForWorkoutsAnd = {
+  readonly AND: readonly PredicateForWorkouts[]
+}
+
+export type FilterForWorkouts =
+  | PredicateForWorkouts
+  | PredicateForWorkoutsOr
+  | PredicateForWorkoutsAnd
+
+export interface WorkoutQueryOptionsWithAnchor {
+  energyUnit?: string
+  distanceUnit?: string
+  filter?: FilterForWorkouts
+  limit?: number
+  anchor?: string
+}
+
+export interface WorkoutQueryOptions {
+  energyUnit?: string
+  distanceUnit?: string
+  filter?: FilterForWorkouts
+  limit?: number
+  ascending?: boolean
+}
+
+export interface WorkoutRouteLocation {
+  readonly altitude: number
+  readonly course: number
+  readonly date: Date
+  readonly distance: number | null
+  readonly horizontalAccuracy: number
+  readonly latitude: number
+  readonly longitude: number
+  readonly speed: number
+  readonly speedAccuracy: number
+  readonly verticalAccuracy: number
+}
+
+export interface LocationForSaving {
+  readonly altitude: number
+  readonly course: number
+  readonly date: Date // unix timestamp in milliseconds
+  readonly horizontalAccuracy: number
+  readonly latitude: number
+  readonly longitude: number
+  readonly speed: number
+  readonly verticalAccuracy: number
+}
+
+export interface WorkoutPlan {
+  readonly id: string
+  readonly activityType: WorkoutActivityType
+}
+
+export interface WorkoutTotals {
+  readonly distance?: number
+  readonly energyBurned?: number
+}
+
+export interface WorkoutSample {
+  readonly uuid: string
+  readonly device?: Device
+  readonly workoutActivityType: WorkoutActivityType
+  readonly duration: Quantity
+  readonly totalDistance?: Quantity
+  readonly totalEnergyBurned?: Quantity
+  readonly totalSwimmingStrokeCount?: Quantity
+  readonly totalFlightsClimbed?: Quantity
+  readonly startDate: Date
+  readonly endDate: Date
+  readonly metadata?: AnyMap
+  readonly sourceRevision?: SourceRevision
+  readonly events?: readonly WorkoutEvent[]
+  readonly activities?: readonly WorkoutActivity[]
+}

package/src/utils/getMostRecentCategorySample.ts

@@ -1,19 +1,15 @@
-import queryCategorySamples from './queryCategorySamples'
+import { CategoryTypes } from '../modules'
+import type { CategoryTypeIdentifier } from '../types/CategoryTypeIdentifier'
 
-import type { HKCategoryTypeIdentifier } from '../native-types'
-import type { HKCategorySample } from '../types'
-
-async function getMostRecentCategorySample<
-  T extends HKCategoryTypeIdentifier
->(
-  identifier: T,
-): Promise<HKCategorySample<T> | null> {
-  const samples = await queryCategorySamples(identifier, {
+export async function getMostRecentCategorySample<
+  T extends CategoryTypeIdentifier,
+>(identifier: T) {
+  const samples = await CategoryTypes.queryCategorySamples(identifier, {
     limit: 1,
     ascending: false,
   })
 
-  return samples[0] ?? null
+  return samples[0]
 }
 
 export default getMostRecentCategorySample

package/src/utils/getMostRecentQuantitySample.ts

@@ -1,26 +1,16 @@
-import queryQuantitySamples from './queryQuantitySamples'
+import { QuantityTypes } from '../modules'
+import type { QuantityTypeIdentifier } from '../types/QuantityTypeIdentifier'
 
-import type { HKQuantityTypeIdentifier, UnitForIdentifier } from '../native-types'
-import type { HKQuantitySample } from '../types'
-
-async function getMostRecentQuantitySample<
-  TIdentifier extends HKQuantityTypeIdentifier,
-  TUnit extends UnitForIdentifier<TIdentifier>
->(
-  identifier: TIdentifier,
-  unit: TUnit,
-): Promise<HKQuantitySample<TIdentifier, TUnit> | null> {
-  const samples = await queryQuantitySamples(identifier, {
+async function getMostRecentQuantitySample(
+  identifier: QuantityTypeIdentifier,
+  unit?: string,
+) {
+  const samples = await QuantityTypes.queryQuantitySamples(identifier, {
     limit: 1,
     unit,
   })
 
-  const lastSample = samples[0]
-
-  if (lastSample) {
-    return lastSample as HKQuantitySample<TIdentifier, TUnit>
-  }
-  return null
+  return samples[0]
 }
 
 export default getMostRecentQuantitySample

package/src/utils/getMostRecentWorkout.ts

@@ -1,27 +1,17 @@
-import queryWorkouts from './queryWorkouts'
+import { Workouts } from '../modules'
+import type { WorkoutQueryOptions } from '../types/Workouts'
 
-import type { EnergyUnit, LengthUnit } from '../native-types'
-import type { HKWorkout, QueryWorkoutsOptions } from '../types'
-
-export type GetMostRecentWorkoutFn = <
-  TEnergy extends EnergyUnit,
-  TDistance extends LengthUnit
->(
-  options?: Pick<
-  QueryWorkoutsOptions<TEnergy, TDistance>,
-  'distanceUnit' | 'energyUnit'
-  >
-) => Promise<HKWorkout<TEnergy, TDistance> | null>;
-
-const getMostRecentWorkout: GetMostRecentWorkoutFn = async (options) => {
-  const workouts = await queryWorkouts({
+const getMostRecentWorkout = async (
+  options: Pick<WorkoutQueryOptions, 'distanceUnit' | 'energyUnit'>,
+) => {
+  const workouts = await Workouts.queryWorkoutSamples({
     limit: 1,
     ascending: false,
     energyUnit: options?.energyUnit,
     distanceUnit: options?.distanceUnit,
   })
 
-  return workouts[0] || null
+  return workouts[0]
 }
 
 export default getMostRecentWorkout

package/src/utils/getPreferredUnit.ts

@@ -1,14 +1,18 @@
-import getPreferredUnits from './getPreferredUnits'
+import { Core } from '../modules'
+import type { QuantityTypeIdentifier } from '../types/QuantityTypeIdentifier'
 
-import type { HKQuantityTypeIdentifier, HKUnit } from '../native-types'
+const getPreferredUnit = async (
+  quantityType: QuantityTypeIdentifier,
+): Promise<string> => {
+  const units = await Core.getPreferredUnits([quantityType])
+  const unit = units[0]?.unit
 
-export type GetPreferredUnitFn = (
-  identifier: HKQuantityTypeIdentifier
-) => Promise<HKUnit | undefined>;
+  if (!unit) {
+    throw new Error(
+      `No preferred unit found for quantity type: ${quantityType}`,
+    )
+  }
 
-const getPreferredUnit: GetPreferredUnitFn = async (type) => {
-  const [unit] = await getPreferredUnits([type])
   return unit
 }
-
 export default getPreferredUnit

package/src/utils/subscribeToChanges.ts

@@ -1,31 +1,14 @@
-import Native, { EventEmitter } from '../native-types'
+import { Core } from '../modules'
+import type { SampleTypeIdentifier } from '../types/Shared'
+import type { OnChangeCallbackArgs } from '../types/Subscriptons'
 
-import type { HKSampleTypeIdentifier } from '..'
-
-const subscribeToChanges = async (
-  identifier: HKSampleTypeIdentifier,
-  callback: () => void,
+export const subscribeToChanges = (
+  identifier: SampleTypeIdentifier,
+  callback: (args: OnChangeCallbackArgs) => void,
 ) => {
-  const subscription = EventEmitter.addListener(
-    'onChange',
-    ({ typeIdentifier }: { readonly typeIdentifier: HKSampleTypeIdentifier }) => {
-      if (typeIdentifier === identifier) {
-        callback()
-      }
-    },
-  )
-
-  const queryId = await Native.subscribeToObserverQuery(identifier).catch(
-    async (error) => {
-      subscription.remove()
-      return Promise.reject(error)
-    },
-  )
+  const queryId = Core.subscribeToObserverQuery(identifier, callback)
 
-  return async () => {
-    subscription.remove()
-    return Native.unsubscribeQuery(queryId)
+  return {
+    remove: () => Core.unsubscribeQuery(queryId),
   }
 }
-
-export default subscribeToChanges

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2020 Robert Herber
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/README.md

@@ -1,179 +0,0 @@
-# @kingstinct/react-native-healthkit
-
-[![Test Status](https://github.com/Kingstinct/react-native-healthkit/actions/workflows/test.yml/badge.svg)](https://github.com/Kingstinct/react-native-healthkit/actions/workflows/test.yml)
-[![Latest version on NPM](https://img.shields.io/npm/v/@kingstinct/react-native-healthkit)](https://www.npmjs.com/package/@kingstinct/react-native-healthkit)
-[![Downloads on NPM](https://img.shields.io/npm/dt/@kingstinct/react-native-healthkit)](https://www.npmjs.com/package/@kingstinct/react-native-healthkit)
-[![Discord](https://dcbadge.vercel.app/api/server/hrgnETpsJA?style=flat)](https://discord.gg/hrgnETpsJA)
-
-
-React Native bindings for HealthKit with full TypeScript and Promise support covering about any kind of data. Keeping TypeScript mappings as close as possible to HealthKit - both in regards to naming and serialization. This will make it easier to keep this library up-to-date with HealthKit as well as browsing [the official documentation](https://developer.apple.com/documentation/healthkit) (and if something - metadata properties for example - is not typed it will still be accessible).
-
-| Data Types                  | Query | Save  | Subscribe | Examples                               |
-| ----------------------------|:------|:------|:----------|:---------------------------------------|
-| 100+ Quantity Types         | ✅    | ✅    | ✅       | Steps, energy burnt, blood glucose etc.. |
-| 63 Category Types           | ✅    | ✅    | ✅       | Sleep analysis, mindful sessions etc.. |
-| 75+ Workout Activity Types  | ✅    | ✅    | ✅       | Swimming, running, table tennis etc..  |
-| Correlation Types           | ✅    | ✅    | ✅       | Food and blood pressure                |
-| Document Types              | ✅    | ❌    | ✅       | [CDA documents](https://developer.apple.com/documentation/healthkit/hkcdadocument) exposed as Base64 data  |
-| Clinical Records            | ⚠️    | ❌    | ⚠️       | Lab results etc in [FHIR JSON format](https://www.hl7.org/fhir/json.html) (see [Clinical Records](https://github.com/kingstinct/react-native-healthkit#clinical-records))  |
-
-### Disclaimer
-
-This library is provided as-is without any warranty and is not affiliated with Apple in any way. The data might be incomplete or inaccurate.
-
-## Installation
-
-### Expo
-Usage with Expo is possible - just keep in mind it will not work in Expo Go and [you'll need to roll your own Dev Client](https://docs.expo.dev/development/getting-started/). 
-
-1. `yarn add @kingstinct/react-native-healthkit`
-2. Update your app.json with the config plugin:
-```json
-{
-  "expo": {
-    "plugins": ["@kingstinct/react-native-healthkit"]
-  }
-}
-```
-this will give you defaults that make the app build without any further configuration. If you want, you can override the defaults:
-```json
-{
-  "expo": {
-    "plugins": [
-      ["@kingstinct/react-native-healthkit", {
-        "NSHealthShareUsageDescription": "Your own custom usage description",
-        "NSHealthUpdateUsageDescription": false,  // if you have no plans to update data, you could skip adding it to your info.plist
-        "background": false // if you have no plans to use it in background mode, you could skip adding it to the entitlements
-      }]
-    ]
-  }
-}
-```
-3. Build a new Dev Client
-
-### Native or Expo Bare Workflow
-1. `yarn add @kingstinct/react-native-healthkit`
-2. `npx pod-install`
-3. Set `NSHealthUpdateUsageDescription` and `NSHealthShareUsageDescription` in your `Info.plist` 
-4. Enable the HealthKit capability for the project in Xcode.
-5. Since this package is using Swift you might also need to add a bridging header in your project if you haven't already, you can [find more about that in the official React Native docs](https://reactnative.dev/docs/native-modules-ios#exporting-swift)
-
-## Usage
-
-During runtime check and request permissions with `requestAuthorization`. Failing to request authorization, or requesting a permission you haven't requested yet, will result in the app crashing. This is easy to miss - for example by requesting authorization in the same component where you have a hook trying to fetch data right away.. :)
-
-Some hook examples:
-```TypeScript
-import { HKQuantityTypeIdentifier, useHealthkitAuthorization } from '@kingstinct/react-native-healthkit';
-
-const [authorizationStatus, requestAuthorization] = useHealthkitAuthorization([HKQuantityTypeIdentifier.bloodGlucose])
-
-// make sure that you've requested authorization before requesting data, otherwise your app will crash
-import { useMostRecentQuantitySample, HKQuantityTypeIdentifier, useMostRecentCategorySample } from '@kingstinct/react-native-healthkit';
-
-const mostRecentBloodGlucoseSample = useMostRecentQuantitySample(HKQuantityTypeIdentifier.bloodGlucose)
-const lastBodyFatSample = useMostRecentQuantitySample(HKQuantityTypeIdentifier.bodyFatPercentage)
-const lastMindfulSession = useMostRecentCategorySample(HKCategoryTypeIdentifier.mindfulSession)
-const lastWorkout = useMostRecentWorkout()
-```
-
-Some imperative examples:
-```TypeScript
-  import HealthKit, { HKUnit, HKQuantityTypeIdentifier, HKInsulinDeliveryReason, HKCategoryTypeIdentifier } from '@kingstinct/react-native-healthkit';
-
-  const isAvailable = await HealthKit.isHealthDataAvailable();
-
-  /* Read latest sample of any data */
-  await HealthKit.requestAuthorization([HKQuantityTypeIdentifier.bodyFatPercentage]); // request read permission for bodyFatPercentage
-
-  const { quantity, unit, startDate, endDate } = await HealthKit.getMostRecentQuantitySample(HKQuantityTypeIdentifier.bodyFatPercentage); // read latest sample
-  
-  console.log(quantity) // 17.5
-  console.log(unit) // %
-
-  await HealthKit.requestAuthorization([HKQuantityTypeIdentifier.heartRate]); // request read permission for heart rate
-
-  /* Subscribe to data (Make sure to request permissions before subscribing to changes) */
-  const [hasRequestedAuthorization, setHasRequestedAuthorization] = useState(false);
-  
-  useEffect(() => {
-    HealthKit.requestAuthorization([HKQuantityTypeIdentifier.heartRate]).then(() => {
-      setHasRequestedAuthorization(true);
-    });
-  }, []);
-  
-  useEffect(() => {
-    if (hasRequestedAuthorization) {
-      const unsubscribe = HealthKit.subscribeToChanges(HKQuantityTypeIdentifier.heartRate, () => {
-        // refetch data as needed
-      });
-    }
-
-    return () => unsubscribe();
-  }, [hasRequestedAuthorization]);
-
-  /* write data */
-  await HealthKit.requestAuthorization([], [HKQuantityTypeIdentifier.insulinDelivery]); // request write permission for insulin delivery
-
-  ReactNativeHealthkit.saveQuantitySample(
-      HKQuantityTypeIdentifier.insulinDelivery,
-      HKUnit.InternationalUnit,
-      5.5,
-      {
-        metadata: {
-          // Metadata keys could be arbirtary string to store app-specific data.
-          // To use built-in types from https://developer.apple.com/documentation/healthkit/samples/metadata_keys
-          // you need to specify string values instead of variable names (by dropping MetadataKey from the name).
-          HKInsulinDeliveryReason: HKInsulinDeliveryReason.basal,
-        },
-      }
-    );
-```
-
-### HealthKit Anchors (breaking change in 6.0)
-In 6.0 you can use HealthKit anchors to get changes and deleted items which is very useful for syncing. This is a breaking change - but a very easy one to handle that TypeScript should help you with. Most queries now return an object containing samples which is what was returned as only an array before. 
-
-```newAnchor``` is a base64-encoded string returned from HealthKit that contain sync information.  After each successful sync, store the anchor for the next time your anchor query is called to only return the values that have changed.
-
-```limit``` will indicate how many records to consider when sycning data, you can set this value to 0 indicate no limit.
-
-Example:
-
-```TypeScript
-  const { newAnchor, samples, deletedSamples } = await queryQuantitySamplesWithAnchor(HKQuantityTypeIdentifier.stepCount, {
-    limit: 2,
-  })
-
-  const nextResult = await queryQuantitySamplesWithAnchor(HKQuantityTypeIdentifier.stepCount, {
-    limit: 2,
-    anchor: newAnchor,
-  })
-
-  // etc..
-```
-
-## A note on Apple Documentation
-
-We're striving to do as straight a mapping as possible to the Native Libraries. This means that in most cases the Apple Documentation makes sense. However, when it comes to the Healthkit [Metadata Keys](https://developer.apple.com/documentation/healthkit/samples/metadata_keys) the documentation doesn't actually reflect the serialized values. For example HKMetadataKeyExternalUUID in the documentation serializes to HKExternalUUID - which is what we use.
-
-## Clinical Records
-
-For accessing Clinical Records use old version (3.x) or use specific branch "including-clinical-records". The reason is we cannot refer to this code natively in apps without getting approval from Apple, this could probably be solved by the config plugin but we haven't had time to look into it yet.
-
-## Android alternatives
-
-For a similar library for Android, check out [react-native-health-connect](https://github.com/matinzd/react-native-health-connect/) that works with the new Health Connect. For Google Fit [react-native-google-fit](https://www.npmjs.com/package/react-native-google-fit) seems to be the most popular option, and and another possible option is to work directly with the Google Fit REST API which I've some experience with.
-
-## Contributing
-
-See the [contributing guide](CONTRIBUTING.md) to learn how to contribute to the repository and the development workflow.
-
-## Sponsorship and enterprise-grade support
-
-If you're using @kingstinct/react-native-healthkit to build your production app [please consider funding its continued development](https://github.com/sponsors/Kingstinct). It helps us spend more time on keeping this library as good as it can be.
-
-At Kingstinct we're also able to provide enterprise-grade support for this package, [find us here](https://kingstinct.com) or [drop an email](mailto:healthkit@kingstinct.com) for more information. Also feel free to join our [Discord community](https://discord.gg/EHScS93v).
-
-## License
-
-MIT

package/ios/ReactNativeHealthkit-Bridging-Header.h

@@ -1,2 +0,0 @@
-#import <React/RCTBridgeModule.h>
-#import <React/RCTEventEmitter.h>