Merge commit '950fe096' into observer

Constants/Permissions.js

@@ -16,7 +16,44 @@ export const Permissions = {
   BodyMassIndex: "BodyMassIndex",
   BodyTemperature: "BodyTemperature",
   DateOfBirth: "DateOfBirth",
-  DietaryEnergy: "DietaryEnergy",
+  Biotin: "Biotin",
+  Caffeine: "Caffeine",
+  Calcium: "Calcium",
+  Carbohydrates: "Carbohydrates",
+  Chloride: "Chloride",
+  Cholesterol: "Cholesterol",
+  Copper: "Copper",
+  EnergyConsumed: "EnergyConsumed",
+  FatMonounsaturated: "FatMonounsaturated",
+  FatPolyunsaturated: "FatPolyunsaturated",
+  FatSaturated: "FatSaturated",
+  FatTotal: "FatTotal",
+  Fiber: "Fiber",
+  Folate: "Folate",
+  Iodine: "Iodine",
+  Iron: "Iron",
+  Magnesium: "Magnesium",
+  Manganese: "Manganese",
+  Molybdenum: "Molybdenum",
+  Niacin: "Niacin",
+  PantothenicAcid: "PantothenicAcid",
+  Phosphorus: "Phosphorus",
+  Potassium: "Potassium",
+  Protein: "Protein",
+  Riboflavin: "Riboflavin",
+  Selenium: "Selenium",
+  Sodium: "Sodium",
+  Sugar: "Sugar",
+  Thiamin: "Thiamin",
+  VitaminA: "VitaminA",
+  VitaminB12: "VitaminB12",
+  VitaminB6: "VitaminB6",
+  VitaminC: "VitaminC",
+  VitaminD: "VitaminD",
+  VitaminE: "VitaminE",
+  VitaminK: "VitaminK",
+  Zinc: "Zinc",
+  Water: "Water",
   DistanceCycling: "DistanceCycling",
   DistanceWalkingRunning: "DistanceWalkingRunning",
   FlightsClimbed: "FlightsClimbed",

RCTAppleHealthKit/RCTAppleHealthKit+Methods_Activity.h

@@ -10,5 +10,6 @@
 @interface RCTAppleHealthKit (Methods_Activity)
 
 - (void)activity_getActiveEnergyBurned:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback;
+- (void)activity_getBasalEnergyBurned:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback;
 
 @end

RCTAppleHealthKit/RCTAppleHealthKit+Methods_Activity.m

@@ -42,4 +42,35 @@
                           }];
 }
 
+- (void)activity_getBasalEnergyBurned:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback
+{
+    HKQuantityType *basalEnergyType = [HKQuantityType quantityTypeForIdentifier:HKQuantityTypeIdentifierBasalEnergyBurned];
+    NSDate *startDate = [RCTAppleHealthKit dateFromOptions:input key:@"startDate" withDefault:nil];
+    NSDate *endDate = [RCTAppleHealthKit dateFromOptions:input key:@"endDate" withDefault:[NSDate date]];
+    HKUnit *cal = [HKUnit kilocalorieUnit];
+    
+    if(startDate == nil){
+        callback(@[RCTMakeError(@"startDate is required in options", nil, nil)]);
+        return;
+    }
+    NSPredicate * predicate = [RCTAppleHealthKit predicateForSamplesBetweenDates:startDate endDate:endDate];
+    
+    [self fetchQuantitySamplesOfType:basalEnergyType
+                                unit:cal
+                           predicate:predicate
+                           ascending:false
+                               limit:HKObjectQueryNoLimit
+                          completion:^(NSArray *results, NSError *error) {
+                              if(results){
+                                  callback(@[[NSNull null], results]);
+                                  return;
+                              } else {
+                                  NSLog(@"error getting basal energy burned samples: %@", error);
+                                  callback(@[RCTMakeError(@"error getting basal energy burned samples", nil, nil)]);
+                                  return;
+                              }
+                          }];
+    
+}
+
 @end

RCTAppleHealthKit/RCTAppleHealthKit+Methods_Body.m

@@ -80,7 +80,7 @@
 - (void)body_saveWeight:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback
 {
     double weight = [RCTAppleHealthKit doubleValueFromOptions:input];
-    NSDate *sampleDate = [RCTAppleHealthKit dateFromOptionsDefaultNow:input];
+    NSDate *sampleDate = [RCTAppleHealthKit dateFromOptions:input key:@"startDate" withDefault:[NSDate date]];
     HKUnit *unit = [RCTAppleHealthKit hkUnitFromOptions:input key:@"unit" withDefault:[HKUnit poundUnit]];
 
     HKQuantity *weightQuantity = [HKQuantity quantityWithUnit:unit doubleValue:weight];

RCTAppleHealthKit/RCTAppleHealthKit+Methods_Dietary.h

+//
+//  RCTAppleHealthKit+Methods_Dietary.h
+//  RCTAppleHealthKit
+//
+//  Created by Greg Wilson on 2016-06-26.
+//  Copyright © 2016 Greg Wilson. All rights reserved.
+//
+
+#import "RCTAppleHealthKit.h"
+
+@interface RCTAppleHealthKit (Methods_Dietary)
+
+- (void)saveFood:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback;
+- (void)saveWater:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback;
+
+@end

RCTAppleHealthKit/RCTAppleHealthKit+Methods_Fitness.h

@@ -17,7 +17,10 @@
 - (void)fitness_saveSteps:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback;
 - (void)fitness_initializeStepEventObserver:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback;
 - (void)fitness_getDistanceWalkingRunningOnDay:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback;
+- (void)fitness_getDailyDistanceWalkingRunningSamples:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback;
 - (void)fitness_getDistanceCyclingOnDay:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback;
+- (void)fitness_getDailyDistanceCyclingSamples:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback;
 - (void)fitness_getFlightsClimbedOnDay:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback;
+- (void)fitness_getDailyFlightsClimbedSamples:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback;
 
 @end

RCTAppleHealthKit/RCTAppleHealthKit+Methods_Fitness.m

@@ -230,6 +230,35 @@
     }];
 }
 
+- (void)fitness_getDailyDistanceWalkingRunningSamples:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback
+{
+    HKUnit *unit = [RCTAppleHealthKit hkUnitFromOptions:input key:@"unit" withDefault:[HKUnit meterUnit]];
+    NSUInteger limit = [RCTAppleHealthKit uintFromOptions:input key:@"limit" withDefault:HKObjectQueryNoLimit];
+    BOOL ascending = [RCTAppleHealthKit boolFromOptions:input key:@"ascending" withDefault:false];
+    NSDate *startDate = [RCTAppleHealthKit dateFromOptions:input key:@"startDate" withDefault:nil];
+    NSDate *endDate = [RCTAppleHealthKit dateFromOptions:input key:@"endDate" withDefault:[NSDate date]];
+    if(startDate == nil){
+        callback(@[RCTMakeError(@"startDate is required in options", nil, nil)]);
+        return;
+    }
+    
+    HKQuantityType *quantityType = [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDistanceWalkingRunning];
+    
+    [self fetchCumulativeSumStatisticsCollection:quantityType
+                                            unit:unit
+                                       startDate:startDate
+                                         endDate:endDate
+                                       ascending:ascending
+                                           limit:limit
+                                      completion:^(NSArray *arr, NSError *err){
+                                          if (err != nil) {
+                                              NSLog(@"error with fetchCumulativeSumStatisticsCollection: %@", err);
+                                              callback(@[RCTMakeError(@"error with fetchCumulativeSumStatisticsCollection", err, nil)]);
+                                              return;
+                                          }
+                                          callback(@[[NSNull null], arr]);
+                                      }];
+}
 
 - (void)fitness_getDistanceCyclingOnDay:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback
 {
@@ -255,6 +284,35 @@
     }];
 }
 
+- (void)fitness_getDailyDistanceCyclingSamples:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback
+{
+    HKUnit *unit = [RCTAppleHealthKit hkUnitFromOptions:input key:@"unit" withDefault:[HKUnit meterUnit]];
+    NSUInteger limit = [RCTAppleHealthKit uintFromOptions:input key:@"limit" withDefault:HKObjectQueryNoLimit];
+    BOOL ascending = [RCTAppleHealthKit boolFromOptions:input key:@"ascending" withDefault:false];
+    NSDate *startDate = [RCTAppleHealthKit dateFromOptions:input key:@"startDate" withDefault:nil];
+    NSDate *endDate = [RCTAppleHealthKit dateFromOptions:input key:@"endDate" withDefault:[NSDate date]];
+    if(startDate == nil){
+        callback(@[RCTMakeError(@"startDate is required in options", nil, nil)]);
+        return;
+    }
+    
+    HKQuantityType *quantityType = [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDistanceCycling];
+    
+    [self fetchCumulativeSumStatisticsCollection:quantityType
+                                            unit:unit
+                                       startDate:startDate
+                                         endDate:endDate
+                                       ascending:ascending
+                                           limit:limit
+                                      completion:^(NSArray *arr, NSError *err){
+                                          if (err != nil) {
+                                              NSLog(@"error with fetchCumulativeSumStatisticsCollection: %@", err);
+                                              callback(@[RCTMakeError(@"error with fetchCumulativeSumStatisticsCollection", err, nil)]);
+                                              return;
+                                          }
+                                          callback(@[[NSNull null], arr]);
+                                      }];
+}
 
 - (void)fitness_getFlightsClimbedOnDay:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback
 {
@@ -280,4 +338,34 @@
     }];
 }
 
+- (void)fitness_getDailyFlightsClimbedSamples:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback
+{
+    HKUnit *unit = [RCTAppleHealthKit hkUnitFromOptions:input key:@"unit" withDefault:[HKUnit countUnit]];
+    NSUInteger limit = [RCTAppleHealthKit uintFromOptions:input key:@"limit" withDefault:HKObjectQueryNoLimit];
+    BOOL ascending = [RCTAppleHealthKit boolFromOptions:input key:@"ascending" withDefault:false];
+    NSDate *startDate = [RCTAppleHealthKit dateFromOptions:input key:@"startDate" withDefault:nil];
+    NSDate *endDate = [RCTAppleHealthKit dateFromOptions:input key:@"endDate" withDefault:[NSDate date]];
+    if(startDate == nil){
+        callback(@[RCTMakeError(@"startDate is required in options", nil, nil)]);
+        return;
+    }
+    
+    HKQuantityType *quantityType = [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierFlightsClimbed];
+    
+    [self fetchCumulativeSumStatisticsCollection:quantityType
+                                            unit:unit
+                                       startDate:startDate
+                                         endDate:endDate
+                                       ascending:ascending
+                                           limit:limit
+                                      completion:^(NSArray *arr, NSError *err){
+                                          if (err != nil) {
+                                              NSLog(@"error with fetchCumulativeSumStatisticsCollection: %@", err);
+                                              callback(@[RCTMakeError(@"error with fetchCumulativeSumStatisticsCollection", err, nil)]);
+                                              return;
+                                          }
+                                          callback(@[[NSNull null], arr]);
+                                      }];
+}
+
 @end

RCTAppleHealthKit/RCTAppleHealthKit+TypesAndPermissions.m

@@ -74,7 +74,44 @@
         @"ActiveEnergyBurned" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierActiveEnergyBurned],
         @"FlightsClimbed" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierFlightsClimbed],
         // Nutrition Identifiers
-        @"DietaryEnergy" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietaryEnergyConsumed],
+        @"Biotin" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietaryBiotin],
+        @"Caffeine" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietaryCaffeine],
+        @"Calcium" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietaryCalcium],
+        @"Carbohydrates" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietaryCarbohydrates],
+        @"Chloride" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietaryChloride],
+        @"Cholesterol" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietaryCholesterol],
+        @"Copper" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietaryCopper],
+        @"EnergyConsumed" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietaryEnergyConsumed],
+        @"FatMonounsaturated" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietaryFatMonounsaturated],
+        @"FatPolyunsaturated" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietaryFatPolyunsaturated],
+        @"FatSaturated" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietaryFatSaturated],
+        @"FatTotal" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietaryFatTotal],
+        @"Fiber" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietaryFiber],
+        @"Folate" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietaryFolate],
+        @"Iodine" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietaryIodine],
+        @"Iron" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietaryIron],
+        @"Magnesium" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietaryMagnesium],
+        @"Manganese" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietaryManganese],
+        @"Molybdenum" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietaryMolybdenum],
+        @"Niacin" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietaryNiacin],
+        @"PantothenicAcid" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietaryPantothenicAcid],
+        @"Phosphorus" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietaryPhosphorus],
+        @"Potassium" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietaryPotassium],
+        @"Protein" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietaryProtein],
+        @"Riboflavin" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietaryRiboflavin],
+        @"Selenium" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietarySelenium],
+        @"Sodium" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietarySodium],
+        @"Sugar" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietarySugar],
+        @"Thiamin" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietaryThiamin],
+        @"VitaminA" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietaryVitaminA],
+        @"VitaminB12" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietaryVitaminB12],
+        @"VitaminB6" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietaryVitaminB6],
+        @"VitaminC" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietaryVitaminC],
+        @"VitaminD" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietaryVitaminD],
+        @"VitaminE" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietaryVitaminE],
+        @"VitaminK" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietaryVitaminK],
+        @"Zinc" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietaryZinc],
+        @"Water" : [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierDietaryWater],
         // Sleep
         @"SleepAnalysis" : [HKObjectType categoryTypeForIdentifier:HKCategoryTypeIdentifierSleepAnalysis],
         // Mindfulness

RCTAppleHealthKit/RCTAppleHealthKit.m

@@ -12,6 +12,7 @@
 #import "RCTAppleHealthKit+Methods_Activity.h"
 #import "RCTAppleHealthKit+Methods_Body.h"
 #import "RCTAppleHealthKit+Methods_Fitness.h"
+#import "RCTAppleHealthKit+Methods_Dietary.h"
 #import "RCTAppleHealthKit+Methods_Characteristic.h"
 #import "RCTAppleHealthKit+Methods_Vitals.h"
 #import "RCTAppleHealthKit+Methods_Results.h"
@@ -138,16 +139,41 @@ RCT_EXPORT_METHOD(getDistanceWalkingRunning:(NSDictionary *)input callback:(RCTR
     [self fitness_getDistanceWalkingRunningOnDay:input callback:callback];
 }
 
+RCT_EXPORT_METHOD(getDailyDistanceWalkingRunningSamples:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback)
+{
+    [self fitness_getDailyDistanceWalkingRunningSamples:input callback:callback];
+}
+
 RCT_EXPORT_METHOD(getDistanceCycling:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback)
 {
     [self fitness_getDistanceCyclingOnDay:input callback:callback];
 }
 
+RCT_EXPORT_METHOD(getDailyDistanceCyclingSamples:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback)
+{
+    [self fitness_getDailyDistanceCyclingSamples:input callback:callback];
+}
+
 RCT_EXPORT_METHOD(getFlightsClimbed:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback)
 {
     [self fitness_getFlightsClimbedOnDay:input callback:callback];
 }
 
+RCT_EXPORT_METHOD(getDailyFlightsClimbedSamples:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback)
+{
+    [self fitness_getDailyFlightsClimbedSamples:input callback:callback];
+}
+
+RCT_EXPORT_METHOD(saveFood:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback)
+{
+    [self saveFood:input callback:callback];
+}
+
+RCT_EXPORT_METHOD(saveWater:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback)
+{
+    [self saveWater:input callback:callback];
+}
+
 RCT_EXPORT_METHOD(getHeartRateSamples:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback)
 {
     [self vitals_getHeartRateSamples:input callback:callback];
@@ -158,6 +184,11 @@ RCT_EXPORT_METHOD(getActiveEnergyBurned:(NSDictionary *)input callback:(RCTRespo
    [self activity_getActiveEnergyBurned:input callback:callback];
 }
 
+RCT_EXPORT_METHOD(getBasalEnergyBurned:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback)
+{
+    [self activity_getBasalEnergyBurned:input callback:callback];
+}
+
 RCT_EXPORT_METHOD(getBodyTemperatureSamples:(NSDictionary *)input callback:(RCTResponseSenderBlock)callback)
 {
     [self vitals_getBodyTemperatureSamples:input callback:callback];

README.md

 
 # React Native Apple Healthkit
-A React Native bridge module for interacting with Apple Healthkit data. Checkout the [full documentation](https://github.com/terrillo/rn-apple-healthkit/wiki)
+A React Native bridge module for interacting with Apple Healthkit data. Checkout the [full documentation](https://github.com/terrillo/rn-apple-healthkit/tree/master/docs)
 
 ## Installation
 
@@ -28,7 +28,6 @@ Update `info.plist` in your React Native project
 ![](https://i.imgur.com/eOCCCyv.png "Xcode Capabilities Section")
 7. Compile and run
 
-
 ## Get Started
 Initialize Healthkit. This will show the Healthkit permissions prompt for any read/write permissions set in the required `options` object.
 
@@ -44,8 +43,8 @@ If new read/write permissions are added to the options object then the app user
 ```javascript
 let options = {
     permissions: {
-        read: ["Height", "Weight", "StepCount", "DateOfBirth", "BodyMassIndex"],
-        write: ["Weight", "StepCount", "BodyMassIndex"]
+        read: ["Height", "Weight", "StepCount", "DateOfBirth", "BodyMassIndex", "ActiveEnergyBurned"],
+        write: ["Height", "Weight", "StepCount", "BodyMassIndex", "Biotin", "Caffeine", "Calcium", "Carbohydrates", "Chloride", "Cholesterol", "Copper", "EnergyConsumed", "FatMonounsaturated", "FatPolyunsaturated", "FatSaturated", "FatTotal", "Fiber", "Folate", "Iodine", "Iron", "Magnesium", "Manganese", "Molybdenum", "Niacin", "PantothenicAcid", "Phosphorus", "Potassium", "Protein", "Riboflavin", "Selenium", "Sodium", "Sugar", "Thiamin", "VitaminA", "VitaminB12", "VitaminB6", "VitaminC", "VitaminD", "VitaminE", "VitaminK", "Zinc", "Water"]
     }
 };
 ```
@@ -77,48 +76,64 @@ AppleHealthKit.initHealthKit(options: Object, (err: string, results: Object) =>
 }
 ```
 
-## Changelog 
+## Changelog
+0.6.4v
+- Basal energy ([#23](https://github.com/terrillo/rn-apple-healthkit/pull/23))
+- Fixed issues with saving weight in the past
+- Commited the docs to increase pull request support
+- Add daily samples for:
+  - Flights Climbed
+  - WalkingRunning Distance
+  - Cycling Distance
+
+0.6.3v
+- Food and Water ([#19](https://github.com/terrillo/rn-apple-healthkit/pull/19))
+
 0.6.1v
 - HKQuantityTypeIdentifierActiveEnergyBurned
 
 ## Wiki
-  * [Installation](https://github.com/terrillo/rn-apple-healthkit/wiki/Install)
+  * [Installation](/docs/Install)
   * [Documentation](#documentation)
     * [Permissions](#permissions)
     * [Units](#units)
     * Base Methods
-      * [isAvailable](https://github.com/terrillo/rn-apple-healthkit/wiki/isAvailable())
-      * [initHealthKit](https://github.com/terrillo/rn-apple-healthkit/wiki/initHealthKit())
+      * [isAvailable](/docs/isAvailable().md)
+      * [initHealthKit](/docs/initHealthKit().md)
     * Realtime Methods
-      * [initStepCountObserver](https://github.com/terrillo/rn-apple-healthkit/wiki/initStepCountObserver())
+      * [initStepCountObserver](/docs/initStepCountObserver().md)
     * Read Methods
-      * [getActiveEnergyBurned](https://github.com/terrillo/rn-apple-healthkit/wiki/getActiveEnergyBurned())
-      * [getBiologicalSex](https://github.com/terrillo/rn-apple-healthkit/wiki/getBiologicalSex())
-      * [getBloodGlucoseSamples](https://github.com/terrillo/rn-apple-healthkit/wiki/getbloodglucosesamples())
-      * [getBloodPressureSamples](https://github.com/terrillo/rn-apple-healthkit/wiki/getbloodpressuresamples())
-      * [getBodyTemperatureSamples](https://github.com/terrillo/rn-apple-healthkit/wiki/getbodytemperaturesamples())
-      * [getDailyStepCountSamples](https://github.com/terrillo/rn-apple-healthkit/wiki/getDailyStepCountSamples())
-      * [getDateOfBirth](https://github.com/terrillo/rn-apple-healthkit/wiki/getDateOfBirth())
-      * [getDistanceCycling](https://github.com/terrillo/rn-apple-healthkit/wiki/getdistancecycling())
-      * [getDistanceWalkingRunning](https://github.com/terrillo/rn-apple-healthkit/wiki/getDistanceWalkingRunning())
-      * [getFlightsClimbed](https://github.com/terrillo/rn-apple-healthkit/wiki/getflightsclimbed())
-      * [getHeartRateSamples](https://github.com/terrillo/rn-apple-healthkit/wiki/getheartratesamples())
-      * [getHeightSamples](https://github.com/terrillo/rn-apple-healthkit/wiki/getheightsamples())
-      * [getLatestBmi](https://github.com/terrillo/rn-apple-healthkit/wiki/getlatestbmi())
-      * [getLatestBodyFatPercentage](https://github.com/terrillo/rn-apple-healthkit/wiki/getlatestbodyfatpercentage())
-      * [getLatestHeight](https://github.com/terrillo/rn-apple-healthkit/wiki/getlatestheight())
-      * [getLatestLeanBodyMass](https://github.com/terrillo/rn-apple-healthkit/wiki/getlatestleanbodymass())
-      * [getLatestWeight](https://github.com/terrillo/rn-apple-healthkit/wiki/getlatestweight())
-      * [getRespiratoryRateSamples](https://github.com/terrillo/rn-apple-healthkit/wiki/getrespiratoryratesamples())
-      * [getSleepSamples](https://github.com/terrillo/rn-apple-healthkit/wiki/getsleepsamples())
-      * [getStepCount](https://github.com/terrillo/rn-apple-healthkit/wiki/getStepCount())
-      * [getWeightSamples](https://github.com/terrillo/rn-apple-healthkit/wiki/getweightsamples())
+      * [getActiveEnergyBurned](/docs/getActiveEnergyBurned().md)
+      * [getBasalEnergyBurned](/docs/getBasalEnergyBurned().md)
+      * [getBiologicalSex](/docs/getBiologicalSex().md)
+      * [getBloodGlucoseSamples](/docs/getbloodglucosesamples().md)
+      * [getBloodPressureSamples](/docs/getbloodpressuresamples().md)
+      * [getBodyTemperatureSamples](/docs/getbodytemperaturesamples().md)
+      * [getDailyDistanceCyclingSamples]()
+      * [getDailyDistanceWalkingRunningSamples](/docs/getDailyDistanceWalkingRunningSamples().md)
+      * [getDailyFlightsClimbedSamples](/docs/getDailyFlightsClimbedSamples().md)
+      * [getDailyStepCountSamples](/docs/getDailyStepCountSamples().md)
+      * [getDateOfBirth](/docs/getDateOfBirth().md)
+      * [getDistanceCycling](/docs/getdistancecycling().md)
+      * [getDistanceWalkingRunning](/docs/getDistanceWalkingRunning().md)
+      * [getFlightsClimbed](/docs/getflightsclimbed().md)
+      * [getHeartRateSamples](/docs/getheartratesamples().md)
+      * [getHeightSamples](/docs/getheightsamples().md)
+      * [getLatestBmi](/docs/getlatestbmi().md)
+      * [getLatestBodyFatPercentage](/docs/getlatestbodyfatpercentage().md)
+      * [getLatestHeight](/docs/getlatestheight().md)
+      * [getLatestLeanBodyMass](/docs/getlatestleanbodymass().md)
+      * [getLatestWeight](/docs/getlatestweight().md)
+      * [getRespiratoryRateSamples](/docs/getrespiratoryratesamples().md)
+      * [getSleepSamples](/docs/getsleepsamples().md)
+      * [getStepCount](/docs/getStepCount().md)
+      * [getWeightSamples](/docs/getweightsamples().md)
     * Write Methods
-      * [saveBmi](https://github.com/terrillo/rn-apple-healthkit/wiki/savebmi())
-      * [saveHeight](https://github.com/terrillo/rn-apple-healthkit/wiki/saveheight())
-      * [saveMindfulSession](https://github.com/terrillo/rn-apple-healthkit/wiki/saveMindfulSession())
-      * [saveWeight](https://github.com/terrillo/rn-apple-healthkit/wiki/saveweight())
-      * [saveSteps](https://github.com/terrillo/rn-apple-healthkit/wiki/saveSteps())
+      * [saveBmi](/docs/savebmi().md)
+      * [saveHeight](/docs/saveheight().md)
+      * [saveMindfulSession](/docs/saveMindfulSession().md)
+      * [saveWeight](/docs/saveweight().md)
+      * [saveSteps](/docs/saveSteps().md)
   * [References](#references)
 
 ## Supported Apple Permissions
@@ -127,7 +142,8 @@ The available Healthkit permissions to use with `initHealthKit`
 
 | Permission             | Healthkit Identifier Type                                                                                                                                          | Read | Write |
 |------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------|------|-------|
-| ActiveEnergyBurned          | [HKCharacteristicTypeIdentifierActiveEnergyBurned](https://developer.apple.com/documentation/healthkit/hkquantitytypeidentifier/1615771-activeenergyburned?language=objc)           | ✓    |       |
+| ActiveEnergyBurned     | [HKQuantityTypeIdentifierActiveEnergyBurned](https://developer.apple.com/documentation/healthkit/hkquantitytypeidentifier/1615771-activeenergyburned?language=objc)           | ✓    |       |
+| BasalEnergyBurned      | [HKQuantityTypeIdentifierBasalEnergyBurned](https://developer.apple.com/documentation/healthkit/hkquantitytypeidentifier/1615512-basalenergyburned?language=objc)           | ✓    |       |
 | BiologicalSex          | [HKCharacteristicTypeIdentifierBiologicalSex](https://developer.apple.com/reference/Healthkit/hkcharacteristictypeidentifierbiologicalsex?language=objc)           | ✓    |       |
 | BloodGlucose           | [HKQuantityTypeIdentifierBloodGlucose](https://developer.apple.com/reference/Healthkit/hkquantitytypeidentifierbloodglucose?language=objc)                         | ✓    |       |
 | BloodPressureDiastolic | [HKQuantityTypeIdentifierBloodPressureDiastolic](https://developer.apple.com/documentation/healthkit/hkquantitytypeidentifierbloodpressurediastolic?language=objc) | ✓    | ✓     |

docs/Installation.md

+Install the `rn-apple-healthkit` npm package
+
+- Run `npm install rn-apple-healthkit --save`
+- Run `react-native link rn-apple-healthkit`
+
+Update `info.plist` in your React Native project
+```
+<key>NSHealthShareUsageDescription</key>
+<string>Read and understand health data.</string>
+<key>NSHealthUpdateUsageDescription</key>
+<string>Share workout data with other apps.</string>
+```

docs/Permissions.md

+These permissions are exported as constants of the `rn-apple-healthkit` module.
+
+```javascript
+import AppleHealthKit from 'rn-apple-healthkit';
+
+// get the available permissions from AppleHealthKit.Constants object
+const PERMS = AppleHealthKit.Constants.Permissions;
+
+// setup healthkit read/write permissions using PERMS
+const healthKitOptions = {
+    permissions: {
+        read:  [
+            PERMS.StepCount,
+            PERMS.Height,
+        ],
+        write: [
+            PERMS.StepCount
+        ],
+    }
+};
+```
\ No newline at end of file

docs/getActiveEnergyBurned().md

+A quantity sample type that measures the amount of active energy the user has burned.
+
+```javascript
+let d = new Date(2016,1,1);
+let options = {
+    startDate: (new Date(2016,10,1)).toISOString(), // required
+    endDate: (new Date()).toISOString(), // optional; default now
+};
+```
+
+```javascript
+AppleHealthKit.getActiveEnergyBurned(options: Object, (err: Object, results: Object) => {
+    if (err) {
+        return;
+    }
+    console.log(results)
+});
+```
\ No newline at end of file

docs/getBasalEnergyBurned().md

+```javascript
+let d = new Date(2016,1,1);
+let options = {
+    startDate: (new Date(2018,10,1)).toISOString(), // required
+    endDate: (new Date()).toISOString(), // optional; default now
+};
+```
+
+```javascript
+AppleHealthKit.getBasalEnergyBurned(options: Object, (err: Object, results: Object) => {
+    if (err) {
+        return;
+    }
+    console.log(results)
+});
+```

docs/getBiologicalSex().md

+Get the biological sex (gender). If the `BiologicalSex` read permission is missing or the user has denied it then the value will be `unknown`. The possible values are:
+
+| Value   | HKBiologicalSex       |
+|---------|-----------------------|
+| unknown | HKBiologicalSexNotSet |
+| male    | HKBiologicalSexMale   |
+| female  | HKBiologicalSexFemale |
+| other   | HKBiologicalSexOther  |
+
+```javascript
+AppleHealthKit.getBiologicalSex(null, (err: Object, results: Object) => {
+    if (this._handleHealthkitError(err, 'getBiologicalSex')) {
+      return;
+    }
+    console.log(results)
+});
+```
+
+```javascript
+{
+   value: 'female',
+}
+```
\ No newline at end of file

docs/getBloodGlucoseSamples().md

+Query for blood glucose samples. the options object is used to setup a query to retrieve relevant samples.
+```javascript
+let options = {
+  unit: 'mmolPerL',	// optional; default 'mmolPerL'
+  startDate: (new Date(2016,4,27)).toISOString(), // required
+  endDate: (new Date()).toISOString(), // optional; default now
+  ascending: false, // optional; default false
+  limit:10,	// optional; default no limit
+};
+```
+Available units are: `'mmolPerL'`, `'mgPerdL'`.
+
+The callback function will be called with a `samples` array containing objects with *value*, *startDate*, and *endDate* fields
+
+```javascript
+AppleHealthKit.getBloodGlucoseSamples(options, (err: Object, results: Array<Object>) => {
+  if (err) {
+    return;
+  }
+  console.log(results)
+});
+```

docs/getBloodPressureSamples().md

+Query for blood pressure samples. the options object is used to setup a query to retrieve relevant samples.
+```javascript
+let options = {
+  unit: 'mmhg',	// optional; default 'mmhg'
+  startDate: (new Date(2016,4,27)).toISOString(), // required
+  endDate: (new Date()).toISOString(),	// optional; default now
+  ascending: false,	// optional; default false
+  limit:10, // optional; default no limit
+};
+```
+
+The callback function will be called with a `samples` array containing objects with *bloodPressureSystolicValue*, *bloodPressureDiastolicValue*, *startDate*, and *endDate* fields
+
+```javascript
+AppleHealthKit.getBloodPressureSamples(options, (err: Object, results: Array<Object>) => {
+  if (err) {
+    return;
+  }
+  console.log(results)
+});
+```
+
+```javascript
+[
+  { bloodPressureSystolicValue: 120, bloodPressureDiastolicValue: 81, startDate:'2016-06-29T17:55:00.000-0400', endDate:'2016-06-29T17:55:00.000-0400' },
+  { bloodPressureSystolicValue: 119, bloodPressureDiastolicValue: 77, startDate:'2016-03-12T13:22:00.000-0400', endDate:'2016-03-12T13:22:00.000-0400' },
+]
+```
\ No newline at end of file

docs/getBodyTemperatureSamples().md

+Query for body temperature samples. the options object is used to setup a query to retrieve relevant samples.
+
+```javascript
+let options = {
+  unit: 'celsius', // optional; default 'celsius'
+  startDate: (new Date(2016,4,27)).toISOString(), // required
+  endDate: (new Date()).toISOString(), // optional; default now
+  ascending: false, // optional; default false
+  limit:10,	// optional; default no limit
+};
+```
+Available units are: `'fahrenheit'`, `'celsius'`.
+
+The callback function will be called with a `samples` array containing objects with *value*, *startDate*, and *endDate* fields.
+
+```javascript
+AppleHealthKit.getBodyTemperatureSamples(options, (err: Object, results: Array<Object>) => {
+  if (err) {
+		return;
+	}
+	console.log(results)
+});
+```
+
+```javascript
+[
+	{ value: 74.02, startDate:'2016-06-29T17:55:00.000-0400', endDate:'2016-06-29T17:55:00.000-0400' },
+	{ value: 74, startDate:'2016-03-12T13:22:00.000-0400', endDate:'2016-03-12T13:22:00.000-0400' },
+]
+```
\ No newline at end of file

docs/getDailyDistanceCyclingSamples().md

+```javascript
+let options = {
+  startDate: (new Date(2016,4,27)).toISOString(), // required
+  endDate: (new Date()).toISOString(), // optional; default now
+  ascending: false,	// optional; default false
+  limit:10, // optional; default no limit
+};
+```
+
+```javascript
+AppleHealthKit.getDailyDistanceCyclingSamples(options, (err: Object, results: Array<Object>) => {
+  if (err) {
+    return;
+  }
+  console.log(results)
+});
+```

docs/getDailyDistanceWalkingRunningSamples().md

+```javascript
+let options = {
+  startDate: (new Date(2016,4,27)).toISOString(), // required
+  endDate: (new Date()).toISOString(), // optional; default now
+  ascending: false,	// optional; default false
+  limit:10, // optional; default no limit
+};
+```
+
+```javascript
+AppleHealthKit.getDailyDistanceWalkingRunningSamples(options, (err: Object, results: Array<Object>) => {
+  if (err) {
+    return;
+  }
+  console.log(results)
+});
+```

docs/getDailyFlightsClimbedSamples().md

+```javascript
+let options = {
+  startDate: (new Date(2016,4,27)).toISOString(), // required
+  endDate: (new Date()).toISOString(), // optional; default now
+  ascending: false,	// optional; default false
+  limit:10, // optional; default no limit
+};
+```
+
+```javascript
+AppleHealthKit.getDailyFlightsClimbedSamples(options, (err: Object, results: Array<Object>) => {
+  if (err) {
+    return;
+  }
+  console.log(results)
+});
+```

docs/getDailyStepCountSamples().md

+Get the total steps per day over a specified date range.
+
+`getDailyStepCountSamples` accepts an options object containing required *`startDate: ISO8601Timestamp`* and optional *`endDate: ISO8601Timestamp`*. If `endDate` is not provided it will default to the current time
+```javascript
+let options = {
+    startDate: (new Date(2016,1,1)).toISOString() // required
+    endDate:   (new Date()).toISOString() // optional; default now
+};
+```
+
+```javascript
+ AppleHealthKit.getDailyStepCountSamples(options: Object, (err: Object, results: Array<Object>) => {
+    if (this._handleHealthkitError(err, 'getDailyStepCountSamples')) {
+        return;
+    }
+    console.log(results)
+});
+```
\ No newline at end of file

docs/getDateOfBirth().md

+Get the date of birth.
+
+On success, the callback function will be provided with a `res` object containing dob `value: string` (ISO timestamp), and `age: number` (age in years):
+```javascript
+AppleHealthKit.getDateOfBirth(null, (err: Object, results: Object) => {
+    if (this._handleHealthkitError(err, 'getDateOfBirth')) {
+        return;
+    }
+    console.log(results)
+});
+```
+
+```javascript
+{
+	value: '1986-09-01T00:00:00.000-0400',
+	age: 29
+}
+```
\ No newline at end of file

docs/getDistanceCycling().md

+Get the total distance cycling on a specific day.
+
+`getDistanceCycling` accepts an options object containing optional *`date: ISO8601Timestamp`* and *`unit: string`*. If `date` is not provided it will default to the current time. `unit` defaults to `meter`
+```javascript
+let options = {
+  unit: 'mile', // optional; default 'meter'
+  date: (new Date(2016,5,1)).toISOString(), // optional; default now
+};
+```
+
+```javascript
+AppleHealthKit.getDistanceCycling(options: Object, (err: Object, results: Object) => {
+    if (err) {
+    	return;
+    }
+    console.log(results)
+});
+```
+
+```javascript
+{
+	value: 11.45,
+	startDate: '2016-07-08T12:00:00.000-0400',
+	endDate: '2016-07-08T12:00:00.000-0400'
+}
+```
\ No newline at end of file

docs/getDistanceWalkingRunning().md

+Get the total distance walking/running on a specific day.
+
+`getDistanceWalkingRunning` accepts an options object containing optional *`date: ISO8601Timestamp`* and *`unit: string`*. If `date` is not provided it will default to the current time. `unit` defaults to `meter`.
+
+```javascript
+let options = {
+  unit: 'mile', // optional; default 'meter'
+  date: (new Date(2016,5,1)).toISOString(), // optional; default now
+};
+```
+
+```javascript
+AppleHealthKit.getDistanceWalkingRunning(options: Object, (err: Object, results: Object) => {
+    if (err) {
+    	return;
+    }
+    console.log(results)
+});
+```
+
+```javascript
+{
+	value: 1.45,
+	startDate: '2016-07-08T12:00:00.000-0400',
+	endDate: '2016-07-08T12:00:00.000-0400'
+}
+```
\ No newline at end of file

docs/getFlightsClimbed().md

+get the total flights climbed (1 flight is ~10ft of elevation) on a specific day.
+
+`getFlightsClimbed` accepts an options object containing optional *`date: ISO8601Timestamp`*. if `date` is not provided it will default to the current time.
+```javascript
+let options = {
+    date: (new Date(2016,5,1)).toISOString(), // optional; default now
+};
+```
+
+```javascript
+AppleHealthKit.getFlightsClimbed(options: Object, (err: Object, results: Object) => {
+  if (err) {
+    return;
+  }
+  console.log(results)
+});
+```
+
+```javascript
+{
+	value: 15,
+	startDate: '2016-07-08T12:00:00.000-0400',
+	endDate: '2016-07-08T12:00:00.000-0400'
+}
+```
\ No newline at end of file

docs/getHeartRateSamples().md

+Query for heart rate samples. the options object is used to setup a query to retrieve relevant samples.
+```javascript
+let options = {
+  unit: 'bpm', // optional; default 'bpm'
+  startDate: (new Date(2016,4,27)).toISOString(), // required
+  endDate: (new Date()).toISOString(), // optional; default now
+  ascending: false, // optional; default false
+  limit:10, // optional; default no limit
+};
+```
+
+The callback function will be called with a `samples` array containing objects with *value*, *startDate*, and *endDate* fields
+```javascript
+AppleHealthKit.getHeartRateSamples(options, (err: Object, results: Array<Object>) => {
+  if (err) {
+    return;
+  }
+  console.log(results)
+});
+```
+
+```javascript
+[
+	{ value: 74.02, startDate:'2016-06-29T17:55:00.000-0400', endDate:'2016-06-29T17:55:00.000-0400' },
+	{ value: 74, startDate:'2016-03-12T13:22:00.000-0400', endDate:'2016-03-12T13:22:00.000-0400' },
+]
\ No newline at end of file

docs/getHeightSamples().md

+query for height samples. the options object is used to setup a query to retrieve relevant samples.
+```javascript
+let options = {
+  unit: 'inch', // optional; default 'inch'
+  startDate: (new Date(2016,4,27)).toISOString(), // required
+  endDate: (new Date()).toISOString(), // optional; default now
+  ascending: false, // optional; default false
+  limit:10, // optional; default no limit
+};
+```
+
+```javascript
+AppleHealthKit.getHeightSamples(options, (err: Object, results: Array<Object>) => {
+  if (err) {
+    return;
+  }
+  console.log(results)
+});
+```
+
+The callback function will be called with a `samples` array containing objects with `value`, `startDate`, and `endDate` fields
+```javascript
+[
+	{ value: 74.02, startDate:'2016-06-29T17:55:00.000-0400', endDate:'2016-06-29T17:55:00.000-0400' },
+	{ value: 74, startDate:'2016-03-12T13:22:00.000-0400', endDate:'2016-03-12T13:22:00.000-0400' },
+]
+```
\ No newline at end of file

docs/getLatestBmi().md

+Get the most recent BMI sample.
+
+On success, the callback function will be provided with a `bmi` object containing the BMI `value`, and the `startDate` and `endDate` of the sample. *Note: startDate and endDate will be the same as bmi samples are saved at a specific point in time.*
+```javascript
+AppleHealthKit.getLatestBmi(null, (err: string, results: Object) => {
+    if (err) {
+        console.log("error getting latest bmi data: ", err);
+        return;
+    }
+    console.log(results)
+});
+```
+
+```javascript
+{
+	value: 27.2,
+	startDate: '2016-07-08T12:00:00.000-0400',
+	endDate: '2016-07-08T12:00:00.000-0400'
+}
+```

docs/getLatestBodyFatPercentage().md

+Get the most recent body fat percentage. The percentage value is a number between 0 and 100.
+
+On success, the callback function will be provided with a `bodyFatPercentage` object containing the body fat percentage `value`, and the `startDate` and `endDate` of the sample. *Note: startDate and endDate will be the same as bodyFatPercentage samples are saved at a specific point in time.*
+
+```javascript
+AppleHealthKit.getLatestBodyFatPercentage(null, (err: Object, results: Object) => {
+  if (err) {
+    return;
+  }
+  console.log(results)
+});
+```
+
+```javascript
+{
+	value: 20,
+	startDate: '2016-07-08T12:00:00.000-0400',
+	endDate: '2016-07-08T12:00:00.000-0400'
+}
+```
\ No newline at end of file

docs/getLatestHeight().md

+Get the most recent height value.
+
+On success, the callback function will be provided with a `height` object containing the height `value`, and the `startDate` and `endDate` of the height sample. *Note: startDate and endDate will be the same as height samples are saved at a specific point in time.*
+
+```javascript
+AppleHealthKit.getLatestHeight(null, (err: string, results: Object) => {
+    if (err) {
+        console.log("error getting latest height: ", err);
+        return;
+    }
+    console.log(results)
+});
+```
+
+```javascript
+{
+	value: 72,
+	startDate: '2016-07-08T12:00:00.000-0400',
+	endDate: '2016-07-08T12:00:00.000-0400'
+}
+```
\ No newline at end of file

docs/getLatestLeanBodyMass().md

+Get the most recent lean body mass. The value is a number representing the weight in pounds (lbs)
+
+On success, the callback function will be provided with a `leanBodyMass` object containing the leanBodyMass `value`, and the `startDate` and `endDate` of the sample. *Note: startDate and endDate will be the same as leanBodyMass samples are saved at a specific point in time.*
+
+```javascript
+ AppleHealthKit.getLatestLeanBodyMass(null, (err: Object, results: Object) => {
+  if (err) {
+    return;
+  }
+  console.log(results)
+});
+```
+
+```javascript
+{
+	value: 176,
+	startDate: '2016-07-08T12:00:00.000-0400',
+	endDate: '2016-07-08T12:00:00.000-0400'
+}
+```
\ No newline at end of file

docs/getLatestWeight().md

+Get the most recent weight sample.
+
+On success, the callback function will be provided with a `weight` object containing the weight `value`, and the `startDate` and `endDate` of the weight sample. *Note: startDate and endDate will be the same as weight samples are saved at a specific point in time.*
+
+```javascript
+let options = {
+  unit: 'pound'
+};
+```
+
+```javascript
+AppleHealthKit.getLatestWeight(options, (err: string, results: Object) => {
+  if (err) {
+    console.log("error getting latest weight: ", err);
+    return;
+  }
+  console.log(results)
+});
+```
+
+```javascript
+{
+	value: 200,
+	startDate: '2016-07-08T12:00:00.000-0400',
+	endDate: '2016-07-08T12:00:00.000-0400'
+}
+```

docs/getRespiratoryRateSamples().md

+Query for respiratory rate samples. the options object is used to setup a query to retrieve relevant samples.
+
+```javascript
+let options = {
+  unit: 'bpm', // optional; default 'bpm'
+  startDate: (new Date(2016,4,27)).toISOString(), // required
+  endDate: (new Date()).toISOString(), // optional; default now
+  ascending: false, // optional; default false
+  limit:10, // optional; default no limit
+};
+```
+
+The callback function will be called with a `samples` array containing objects with *value*, *startDate*, and *endDate* fields
+
+```javascript
+AppleHealthKit.getRespiratoryRateSamples(options, (err: Object, results: Array<Object>) => {
+  if (err) {
+    return;
+  }
+  console.log(results)
+});
+```

docs/getSleepSamples().md

+Query for sleep samples.
+
+Each sleep sample represents a period of time with a startDate and an endDate.
+the sample's value will be either `INBED` or `ASLEEP`. these values should overlap,
+meaning that two (or more) samples represent a single nights sleep activity. see
+[Healthkit SleepAnalysis] reference documentation
+
+The options object is used to setup a query to retrieve relevant samples.
+The options must contain `startDate` and may also optionally include `endDate`
+and `limit` options
+```javascript
+let options = {
+  startDate: (new Date(2016,10,1)).toISOString(), // required
+  endDate: (new Date()).toISOString(), // optional; default now
+  limit:10, // optional; default no limit
+};
+```
+
+The callback function will be called with a `samples` array containing objects
+with *value*, *startDate*, and *endDate* fields
+
+```javascript
+AppleHealthKit.getSleepSamples(options, (err: Object, results: Array<Object>) => {
+  if (err) {
+    return;
+  }
+  console.log(results).
+});
+```
\ No newline at end of file

docs/getStepCount().md

+Get the aggregated total steps for a specific day (starting and ending at midnight).
+
+An optional options object may be provided containing `date` field representing the selected day. If `date` is not set or an options object is not provided then the current day will be used.
+```javascript
+let d = new Date(2016,1,1);
+let options = {
+    date: d.toISOString()
+};
+```
+
+```javascript
+AppleHealthKit.getStepCount(options: Object, (err: Object, results: Object) => {
+    if (err) {
+        return;
+    }
+    console.log(results)
+});
+```
+
+```javascript
+{
+	value: 213,
+}
+```
\ No newline at end of file

docs/getWeightSamples().md

+Query for weight samples. the options object is used to setup a query to retrieve relevant samples.
+
+```javascript
+let options = {
+  unit: 'pound', // optional; default 'pound'
+  startDate: (new Date(2016,4,27)).toISOString(), // required
+  endDate: (new Date()).toISOString(), // optional; default now
+  ascending: false,	// optional; default false
+  limit:10, // optional; default no limit
+};
+```
+
+```javascript
+AppleHealthKit.getWeightSamples(options, (err: Object, results: Array<Object>) => {
+  if (err) {
+    return;
+  }
+  console.log(results)
+});
+```
+
+```javascript
+[
+  { value: 160, startDate: '2016-07-09T00:00:00.000-0400', endDate: '2016-07-10T00:00:00.000-0400' },
+  { value: 161, startDate: '2016-07-08T00:00:00.000-0400', endDate: '2016-07-09T00:00:00.000-0400' },
+  { value: 165, startDate: '2016-07-07T00:00:00.000-0400', endDate: '2016-07-08T00:00:00.000-0400' },
+]
+```
\ No newline at end of file

docs/initHealthKit().md

+Initialize Healthkit. This will show the Healthkit permissions prompt for any read/write permissions set in the required `options` object.
+
+Due to Apple's privacy model if an app user has previously denied a specific permission then they can not be prompted again for that same permission. The app user would have to go into the Apple Health app and grant the permission to your react-native app under *sources* tab.
+
+For any data that is read from Healthkit the status/error is the same for both. This privacy restriction results in having no knowledge of whether the permission was denied (make sure it's added to the permissions options object), or the data for the specific request was nil (ex. no steps recorded today).
+
+For any data written to Healthkit an authorization error can be caught. If an authorization error occurs you can prompt the user to set the specific permission or add the permission to the options object if not present.
+
+If new read/write permissions are added to the options object then the app user will see the Healthkit permissions prompt with the new permissions to allow.
+
+`initHealthKit` requires an options object with Healthkit permission settings
+```javascript
+let options = {
+    permissions: {
+        read: ["Height", "Weight", "StepCount", "DateOfBirth", "BodyMassIndex"],
+        write: ["Weight", "StepCount", "BodyMassIndex"]
+    }
+};
+```
+
+```javascript
+AppleHealthKit.initHealthKit(options: Object, (err: string, results: Object) => {
+    if (err) {
+        console.log("error initializing Healthkit: ", err);
+        return;
+    }
+    // Healthkit is initialized...
+    // now safe to read and write Healthkit data...
+});
+```
\ No newline at end of file

docs/initStepCountObserver().md

+Setup an HKObserverQuery for step count (HKQuantityTypeIdentifierStepCount) that will
+trigger an event listenable on react-native `NativeAppEventEmitter` when the
+Healthkit step count has changed.
+
+The `initStepCountObserver` method must be called before adding a listener to
+NativeAppEventEmitter. After the step count observer has been initialized you can
+listen to the NativeAppEventEmitter `change:steps` event and re-fetch relevent
+step count data in the event handler.
+
+The `initStepCountObserver` method should be called after Healthkit has been
+successfully initialized (AppleHealthKit.initHealthKit has been called without
+error).
+
+```javascript
+// import NativeAppEventEmitter from react-native
+import {
+  Navigator,
+  View,
+  NativeAppEventEmitter,
+} from 'react-native';
+```
+
+```javascript
+AppleHealthKit.initHealthKit(HKOPTIONS, (err, res) => {
+  if (this._handleHKError(err, 'initHealthKit')) {
+    return;
+  }
+
+  // initialize the step count observer
+  AppleHealthKit.initStepCountObserver({}, () => {});
+
+  // add event listener for 'change:steps' and handle the
+  // event in the event handler function.
+  //
+  // when adding a listener, a 'subscription' object is
+  // returned that must be used to remove the listener
+  // when the component unmounts. The subscription object
+  // must be accessible to any function/method/instance
+  // that will be unsubscribing from the event.
+  this.sub = NativeAppEventEmitter.addListener(
+    'change:steps',
+    (evt) => {
+      // a 'change:steps' event has been received. step
+      // count data should be re-fetched from Healthkit.
+      this._fetchStepCountData();
+    }
+  );
+
+  // other tasks to perform after Healthkit has been
+  // initialized (fetch relevant Healthkit data).
+  this._fetchStepCountData();
+  this._fetchOtherRelevantHealthkitData();
+  // ...
+});
+
+...
+
+// when the component where the listener was added unmounts
+// (or whenever the listener should be removed), call the
+// 'remove' method of the subscription object.
+componentWillUnmount() {
+  this.sub.remove();
+}
+```

docs/isAvailable().md

+Check for Healthkit availability
+
+```javascript
+import AppleHealthKit from 'rn-apple-healthkit';
+
+AppleHealthKit.isAvailable((err: Object, available: boolean) => {
+  if (err) {
+    console.log("error initializing Healthkit: ", err);
+    return;
+  }
+  // Healthkit is available
+});
+```
\ No newline at end of file

docs/saveBmi().md

+save a numeric BMI value to Healthkit
+
+`saveBmi` accepts an options object containing a numeric BMI value:
+```javascript
+let options = {
+  value: 27.2
+}
+```
+```javascript
+AppleHealthKit.saveBmi(options: Object, (err: Object, results: Object) => {
+  if (err) {
+    return;
+  }
+  // BMI successfully saved
+});
+```
\ No newline at end of file

docs/saveHeight().md

+save a numeric height value to Healthkit
+
+`saveHeight` accepts an options object containing a numeric height value:
+```javascript
+let options = {
+  value: 200 // Inches
+}
+```
+
+```javascript
+AppleHealthKit.saveHeight(options: Object, (err: Object, results: Object) => {
+  if (err) {
+    return;
+  }
+  // height successfully saved
+});
+```
\ No newline at end of file

docs/saveMindfulSession().md

+Each mindfulness sample represents a period of time with a startDate and an endDate.
+the options must contain `startDate` and `endDate`
+
+```javascript
+let options = {
+    startDate: (new Date(2016,10,1)).toISOString(), // required
+    endDate: (new Date()).toISOString(), // optional; default now
+};
+
+```
+
+```
+AppleHealthKit.saveMindfulSession(options, (err, res) => {
+  if (err) return {
+    return
+  }
+  console.log('Mindful session saved')
+});
+```
\ No newline at end of file

docs/saveSteps().md

+Save a step count sample.
+
+A step count sample represents the number of steps during a specific period of time. A sample should be a precise as possible, with startDate and endDate representing the range of time the steps were taken in.
+
+`saveSteps` accepts an options object containing required *`value: number`*, *`startDate: ISO8601Timestamp`*, and *`endDate: ISO8601Timestamp`*.
+```javascript
+// startDate and endDate are 30 minutes apart.
+// this means the step count value occurred within those 30 minutes.
+let options = {
+  value: 100,
+  startDate: (new Date(2016,6,2,6,0,0)).toISOString(),
+  endDate: (new Date(2016,6,2,6,30,0)).toISOString()
+};
+```
+
+```javascript
+AppleHealthKit.saveSteps(options, (err, res) => {
+  if (this._handleHKError(err, 'saveSteps')) {
+    return;
+  }
+  // step count sample successfully saved
+});
+```
\ No newline at end of file

docs/saveWeight().md

+save a numeric weight value to Healthkit
+
+`saveWeight` accepts an options object containing a numeric weight value:
+```javascript
+let options = {
+  value: 200
+}
+```
+
+```javascript
+AppleHealthKit.saveWeight(options: Object, (err: Object, results: Object) => {
+    if (err) {
+        console.log("error saving weight to Healthkit: ", err);
+        return;
+    }
+    // Done
+});
+```
\ No newline at end of file

package.json

 {
   "name": "rn-apple-healthkit",
-  "version": "0.6.1",
+  "version": "0.6.4",
   "description": "A React Native package for interacting with Apple HealthKit",
   "main": "index.js",
   "repository": {