Added saveHeartRateSample to the library

Author: Alberto Vaccari

RCTAppleHealthKit/RCTAppleHealthKit+Methods_Vitals.h

@@ -9,6 +9,7 @@
 
 @interface RCTAppleHealthKit (Methods_Vitals)
 
+- (void)vitals_saveHeartRateSample:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback;
 - (void)vitals_getHeartRateSamples:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback;
 - (void)vitals_getRestingHeartRate:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback;
 - (void)vitals_getWalkingHeartRateAverage:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback;

RCTAppleHealthKit/RCTAppleHealthKit+Methods_Vitals.m

@@ -12,6 +12,26 @@
 
 @implementation RCTAppleHealthKit (Methods_Vitals)
 
+- (void)vitals_saveHeartRateSample:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback
+{
+    NSDate *timeHeartRateSampleWasTaken = [RCTAppleHealthKit dateFromOptions:input key:@"date" withDefault:[NSDate date]];
+    double heartRateValue = [RCTAppleHealthKit doubleFromOptions:input key:@"value" withDefault:(double)60];    // Default HR is 60
+
+    HKQuantitySample* heartRate = [HKQuantitySample quantitySampleWithType:[HKQuantityType quantityTypeForIdentifier:HKQuantityTypeIdentifierHeartRate]
+                                                                quantity:[HKQuantity quantityWithUnit:[HKUnit unitFromString: @"count/min"] doubleValue:heartRateValue]
+                                                                startDate:timeHeartRateSampleWasTaken
+                                                                endDate:timeHeartRateSampleWasTaken];
+
+    // Save the HeartRate Sample to HealthKit //
+    [self.healthStore saveObject:heartRate withCompletion:^(BOOL success, NSError *error) {
+        if (!success) {
+            NSLog(@"An error occured saving the heart rate sample %@. The error was: ", error);
+            callback(@[RCTMakeError(@"An error occured saving the heart rate sample", error, nil)]);
+            return;
+        }
+        callback(@[[NSNull null], @true]);
+    }];
+}
 
 - (void)vitals_getHeartRateSamples:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback
 {

RCTAppleHealthKit/RCTAppleHealthKit+TypesAndPermissions.m

@@ -370,6 +370,9 @@ - (nullable HKObjectType *)getWritePermFromText:(nonnull NSString*) key {
     if ([@"BloodAlcoholContent" isEqualToString: key]) {
         return [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierBloodAlcoholContent];
     }
+    if ([@"HeartRate" isEqualToString: key]) {
+        return [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierHeartRate];
+    }
 
     return nil;
 }

RCTAppleHealthKit/RCTAppleHealthKit.m

@@ -311,6 +311,12 @@ + (BOOL)requiresMainQueueSetup
     [self getWater:input callback:callback];
 }
 
+RCT_EXPORT_METHOD(saveHeartRateSample:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback)
+{
+    [self _initializeHealthStore];
+    [self vitals_saveHeartRateSample:input callback:callback];
+}
+
 RCT_EXPORT_METHOD(getHeartRateSamples:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback)
 {
     [self _initializeHealthStore];

README.md

@@ -244,6 +244,7 @@ they are splitted in the following categories
 
 - [getBloodPressureSamples](/docs/getBloodPressureSamples.md)
 - [getElectrocardiogramSamples](/docs/getElectrocardiogramSamples.md)
+- [saveHeartRateSample](/docs/saveHeartRateSample.md)
 - [getHeartRateSamples](/docs/getHeartRateSamples.md)
 - [getHeartRateVariabilitySamples](/docs/getHeartRateVariabilitySamples.md)
 - [getHeartbeatSeriesSamples](/docs/getHeartbeatSeriesSamples.md)

docs/saveHeartRateSample.md

@@ -0,0 +1,33 @@
+# saveHeartRateSample
+
+Save a Heart Rate sample to Healthkit
+
+`saveHeartRateSample` accepts an options object containing a numeric heart rate value in Beats per minute (BPM).
+In the example below a heart rate sample of 72BPM is added to Healthkit.
+
+Example input options:
+
+```javascript
+let options = {
+  value: 72, // Amount in BPM
+  date: (new Date(2018,10,1)).toISOString(), // Optional, time when the Heart Rate was logged
+}
+```
+
+Call the method:
+
+```javascript
+AppleHealthKit.saveHeartRateSample((options: Object), (err: Object, results: boolean) => {
+  if (err) {
+    console.log('Error saving Heart Rate to Healthkit: ', err)
+    return
+  }
+  // Heart Rate successfully saved
+})
+```
+
+Example output:
+
+```json
+1
+```

index.d.ts

@@ -197,6 +197,11 @@ declare module 'react-native-health' {
       callback: (err: string, results: HealthValue) => void,
     ): void
 
+    saveHeartRateSample(
+      options: HealthValueOptions,
+      callback: (error: string, result: HealthValue) => void,
+    ): void
+
     getHeartRateSamples(
       options: HealthInputOptions,
       callback: (err: string, results: Array<HealthValue>) => void,