@capgo/capacitor-health 8.4.9 → 8.5.0

package/README.md

@@ -1,11 +1,6 @@
 # @capgo/capacitor-health
 
-<a href="https://capgo.app/">
-  <img
-    src="https://raw.githubusercontent.com/Cap-go/capgo/main/assets/capgo_banner.png"
-    alt="Capgo - Instant updates for capacitor"
-  />
-</a>
+<a href="https://capgo.app/"><img src="https://capgo.app/readme-banner.svg?repo=Cap-go/capacitor-health" alt="Capgo - Instant updates for Capacitor" /></a>
 
 <div align="center">
   <h2>
@@ -174,6 +169,7 @@ await Health.saveSample({
 | `oxygenSaturation`      | `percent`     | Blood oxygen saturation (SpO2)                           |
 | `restingHeartRate`      | `bpm`         | Resting heart rate                                       |
 | `heartRateVariability`  | `millisecond` | Heart rate variability (HRV)                             |
+| `vo2Max`                | `mL/min/kg`   | VO2 max (Android Health Connect)                         |
 | `bloodPressure`         | `mmHg`        | Blood pressure (requires systolic/diastolic values)      |
 | `bloodGlucose`          | `mg/dL`       | Blood glucose level                                      |
 | `bodyTemperature`       | `celsius`     | Body temperature                                         |
@@ -318,7 +314,7 @@ const { samples: avgHR } = await Health.queryAggregated({
 });
 ```
 
-**Note:** Aggregated queries are not supported for sleep, respiratory rate, oxygen saturation, and heart rate variability data types. These are instantaneous measurements and should use `readSamples()` instead. Aggregation is supported for: steps, distance, calories, heart rate, weight, and resting heart rate.
+**Note:** Aggregated queries are not supported for sleep, respiratory rate, oxygen saturation, heart rate variability, and VO2 max data types. These measurements should use `readSamples()`, not `queryAggregated()`. Aggregation is supported for: steps, distance, calories, heart rate, weight, and resting heart rate.
 
 ## API
 
@@ -546,19 +542,20 @@ Supported on iOS (HealthKit) and Android (Health Connect).
 
 #### HealthSample
 
-| Prop             | Type                                                      | Description                                                                                         |
-| ---------------- | --------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
-| **`dataType`**   | <code><a href="#healthdatatype">HealthDataType</a></code> |                                                                                                     |
-| **`value`**      | <code>number</code>                                       |                                                                                                     |
-| **`unit`**       | <code><a href="#healthunit">HealthUnit</a></code>         |                                                                                                     |
-| **`startDate`**  | <code>string</code>                                       |                                                                                                     |
-| **`endDate`**    | <code>string</code>                                       |                                                                                                     |
-| **`sourceName`** | <code>string</code>                                       |                                                                                                     |
-| **`sourceId`**   | <code>string</code>                                       |                                                                                                     |
-| **`platformId`** | <code>string</code>                                       | Platform-specific unique identifier (HealthKit UUID on iOS, Health Connect metadata ID on Android). |
-| **`sleepState`** | <code><a href="#sleepstate">SleepState</a></code>         | For sleep data, indicates the sleep state (e.g., 'asleep', 'awake', 'rem', 'deep', 'light').        |
-| **`systolic`**   | <code>number</code>                                       | For blood pressure data, the systolic value in mmHg.                                                |
-| **`diastolic`**  | <code>number</code>                                       | For blood pressure data, the diastolic value in mmHg.                                               |
+| Prop                    | Type                                                      | Description                                                                                         |
+| ----------------------- | --------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
+| **`dataType`**          | <code><a href="#healthdatatype">HealthDataType</a></code> |                                                                                                     |
+| **`value`**             | <code>number</code>                                       |                                                                                                     |
+| **`unit`**              | <code><a href="#healthunit">HealthUnit</a></code>         |                                                                                                     |
+| **`startDate`**         | <code>string</code>                                       |                                                                                                     |
+| **`endDate`**           | <code>string</code>                                       |                                                                                                     |
+| **`sourceName`**        | <code>string</code>                                       |                                                                                                     |
+| **`sourceId`**          | <code>string</code>                                       |                                                                                                     |
+| **`platformId`**        | <code>string</code>                                       | Platform-specific unique identifier (HealthKit UUID on iOS, Health Connect metadata ID on Android). |
+| **`sleepState`**        | <code><a href="#sleepstate">SleepState</a></code>         | For sleep data, indicates the sleep state (e.g., 'asleep', 'awake', 'rem', 'deep', 'light').        |
+| **`systolic`**          | <code>number</code>                                       | For blood pressure data, the systolic value in mmHg.                                                |
+| **`diastolic`**         | <code>number</code>                                       | For blood pressure data, the diastolic value in mmHg.                                               |
+| **`measurementMethod`** | <code>number</code>                                       | For VO2 max data on Android, Health Connect's measurement method enum value.                        |
 
 
 #### QueryOptions
@@ -655,12 +652,12 @@ Supported on iOS (HealthKit) and Android (Health Connect).
 
 #### HealthDataType
 
-<code>'steps' | 'distance' | 'calories' | 'heartRate' | 'weight' | 'sleep' | 'respiratoryRate' | 'oxygenSaturation' | 'restingHeartRate' | 'heartRateVariability' | 'bloodPressure' | 'bloodGlucose' | 'bodyTemperature' | 'height' | 'flightsClimbed' | 'exerciseTime' | 'distanceCycling' | 'bodyFat' | 'basalBodyTemperature' | 'basalCalories' | 'totalCalories' | 'mindfulness' | 'workouts'</code>
+<code>'steps' | 'distance' | 'calories' | 'heartRate' | 'weight' | 'sleep' | 'respiratoryRate' | 'oxygenSaturation' | 'restingHeartRate' | 'heartRateVariability' | 'vo2Max' | 'bloodPressure' | 'bloodGlucose' | 'bodyTemperature' | 'height' | 'flightsClimbed' | 'exerciseTime' | 'distanceCycling' | 'bodyFat' | 'basalBodyTemperature' | 'basalCalories' | 'totalCalories' | 'mindfulness' | 'workouts'</code>
 
 
 #### HealthUnit
 
-<code>'count' | 'meter' | 'kilocalorie' | 'bpm' | 'kilogram' | 'minute' | 'percent' | 'millisecond' | 'mmHg' | 'mg/dL' | 'celsius' | 'fahrenheit' | 'centimeter'</code>
+<code>'count' | 'meter' | 'kilocalorie' | 'bpm' | 'kilogram' | 'minute' | 'percent' | 'millisecond' | 'mL/min/kg' | 'mmHg' | 'mg/dL' | 'celsius' | 'fahrenheit' | 'centimeter'</code>
 
 
 #### SleepState

package/android/src/main/AndroidManifest.xml

@@ -19,6 +19,8 @@
     <uses-permission android:name="android.permission.health.WRITE_RESTING_HEART_RATE" />
     <uses-permission android:name="android.permission.health.READ_HEART_RATE_VARIABILITY" />
     <uses-permission android:name="android.permission.health.WRITE_HEART_RATE_VARIABILITY" />
+    <uses-permission android:name="android.permission.health.READ_VO2_MAX" />
+    <uses-permission android:name="android.permission.health.WRITE_VO2_MAX" />
     <uses-permission android:name="android.permission.health.READ_BLOOD_PRESSURE" />
     <uses-permission android:name="android.permission.health.WRITE_BLOOD_PRESSURE" />
     <uses-permission android:name="android.permission.health.READ_BLOOD_GLUCOSE" />

package/android/src/main/java/app/capgo/plugin/health/HealthDataType.kt

@@ -22,6 +22,7 @@ import androidx.health.connect.client.records.RestingHeartRateRecord
 import androidx.health.connect.client.records.SleepSessionRecord
 import androidx.health.connect.client.records.StepsRecord
 import androidx.health.connect.client.records.TotalCaloriesBurnedRecord
+import androidx.health.connect.client.records.Vo2MaxRecord
 import androidx.health.connect.client.records.WeightRecord
 import kotlin.reflect.KClass
 
@@ -41,6 +42,7 @@ enum class HealthDataType(
     OXYGEN_SATURATION("oxygenSaturation", OxygenSaturationRecord::class, "percent"),
     RESTING_HEART_RATE("restingHeartRate", RestingHeartRateRecord::class, "bpm"),
     HEART_RATE_VARIABILITY("heartRateVariability", HeartRateVariabilityRmssdRecord::class, "millisecond"),
+    VO2_MAX("vo2Max", Vo2MaxRecord::class, "mL/min/kg"),
     BLOOD_PRESSURE("bloodPressure", BloodPressureRecord::class, "mmHg"),
     BLOOD_GLUCOSE("bloodGlucose", BloodGlucoseRecord::class, "mg/dL"),
     BODY_TEMPERATURE("bodyTemperature", BodyTemperatureRecord::class, "celsius"),

package/android/src/main/java/app/capgo/plugin/health/HealthManager.kt

@@ -25,6 +25,7 @@ import androidx.health.connect.client.records.RestingHeartRateRecord
 import androidx.health.connect.client.records.SleepSessionRecord
 import androidx.health.connect.client.records.StepsRecord
 import androidx.health.connect.client.records.TotalCaloriesBurnedRecord
+import androidx.health.connect.client.records.Vo2MaxRecord
 import androidx.health.connect.client.records.WeightRecord
 import androidx.health.connect.client.records.metadata.Metadata
 import androidx.health.connect.client.request.ReadRecordsRequest
@@ -223,6 +224,17 @@ class HealthManager {
                 )
                 samples.add(record.time to payload)
             }
+            HealthDataType.VO2_MAX -> readRecords(client, Vo2MaxRecord::class, startTime, endTime, limit) { record ->
+                val payload = createSamplePayload(
+                    dataType,
+                    record.time,
+                    record.time,
+                    record.vo2MillilitersPerMinuteKilogram,
+                    record.metadata
+                )
+                payload.put("measurementMethod", record.measurementMethod)
+                samples.add(record.time to payload)
+            }
             HealthDataType.BLOOD_PRESSURE -> readRecords(client, BloodPressureRecord::class, startTime, endTime, limit) { record ->
                 val payload = createSamplePayload(
                     dataType,
@@ -489,6 +501,15 @@ class HealthManager {
                 )
                 client.insertRecords(listOf(record))
             }
+            HealthDataType.VO2_MAX -> {
+                val record = Vo2MaxRecord(
+                    time = startTime,
+                    zoneOffset = zoneOffset(startTime),
+                    metadata = recordMetadata,
+                    vo2MillilitersPerMinuteKilogram = value
+                )
+                client.insertRecords(listOf(record))
+            }
             HealthDataType.BLOOD_PRESSURE -> {
                 if (systolic == null || diastolic == null) {
                     throw IllegalArgumentException("Blood pressure requires both systolic and diastolic values")
@@ -666,7 +687,8 @@ class HealthManager {
         // These data types should use readSamples instead
         if (dataType == HealthDataType.RESPIRATORY_RATE || 
             dataType == HealthDataType.OXYGEN_SATURATION || 
-            dataType == HealthDataType.HEART_RATE_VARIABILITY) {
+            dataType == HealthDataType.HEART_RATE_VARIABILITY ||
+            dataType == HealthDataType.VO2_MAX) {
             throw IllegalArgumentException("Aggregated queries are not supported for ${dataType.identifier}. Use readSamples instead.")
         }
 

package/dist/docs.json

@@ -418,6 +418,13 @@
           "docs": "For blood pressure data, the diastolic value in mmHg.",
           "complexTypes": [],
           "type": "number | undefined"
+        },
+        {
+          "name": "measurementMethod",
+          "tags": [],
+          "docs": "For VO2 max data on Android, Health Connect's measurement method enum value.",
+          "complexTypes": [],
+          "type": "number | undefined"
         }
       ]
     },
@@ -854,6 +861,10 @@
           "text": "'heartRateVariability'",
           "complexTypes": []
         },
+        {
+          "text": "'vo2Max'",
+          "complexTypes": []
+        },
         {
           "text": "'bloodPressure'",
           "complexTypes": []
@@ -945,6 +956,10 @@
           "text": "'millisecond'",
           "complexTypes": []
         },
+        {
+          "text": "'mL/min/kg'",
+          "complexTypes": []
+        },
         {
           "text": "'mmHg'",
           "complexTypes": []

package/dist/esm/definitions.d.ts

@@ -1,5 +1,5 @@
-export type HealthDataType = 'steps' | 'distance' | 'calories' | 'heartRate' | 'weight' | 'sleep' | 'respiratoryRate' | 'oxygenSaturation' | 'restingHeartRate' | 'heartRateVariability' | 'bloodPressure' | 'bloodGlucose' | 'bodyTemperature' | 'height' | 'flightsClimbed' | 'exerciseTime' | 'distanceCycling' | 'bodyFat' | 'basalBodyTemperature' | 'basalCalories' | 'totalCalories' | 'mindfulness' | 'workouts';
-export type HealthUnit = 'count' | 'meter' | 'kilocalorie' | 'bpm' | 'kilogram' | 'minute' | 'percent' | 'millisecond' | 'mmHg' | 'mg/dL' | 'celsius' | 'fahrenheit' | 'centimeter';
+export type HealthDataType = 'steps' | 'distance' | 'calories' | 'heartRate' | 'weight' | 'sleep' | 'respiratoryRate' | 'oxygenSaturation' | 'restingHeartRate' | 'heartRateVariability' | 'vo2Max' | 'bloodPressure' | 'bloodGlucose' | 'bodyTemperature' | 'height' | 'flightsClimbed' | 'exerciseTime' | 'distanceCycling' | 'bodyFat' | 'basalBodyTemperature' | 'basalCalories' | 'totalCalories' | 'mindfulness' | 'workouts';
+export type HealthUnit = 'count' | 'meter' | 'kilocalorie' | 'bpm' | 'kilogram' | 'minute' | 'percent' | 'millisecond' | 'mL/min/kg' | 'mmHg' | 'mg/dL' | 'celsius' | 'fahrenheit' | 'centimeter';
 export interface AuthorizationOptions {
     /** Data types that should be readable after authorization. */
     read?: HealthDataType[];
@@ -47,6 +47,8 @@ export interface HealthSample {
     systolic?: number;
     /** For blood pressure data, the diastolic value in mmHg. */
     diastolic?: number;
+    /** For VO2 max data on Android, Health Connect's measurement method enum value. */
+    measurementMethod?: number;
 }
 export interface ReadSamplesResult {
     samples: HealthSample[];

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["export type HealthDataType =\n  | 'steps'\n  | 'distance'\n  | 'calories'\n  | 'heartRate'\n  | 'weight'\n  | 'sleep'\n  | 'respiratoryRate'\n  | 'oxygenSaturation'\n  | 'restingHeartRate'\n  | 'heartRateVariability'\n  | 'bloodPressure'\n  | 'bloodGlucose'\n  | 'bodyTemperature'\n  | 'height'\n  | 'flightsClimbed'\n  | 'exerciseTime'\n  | 'distanceCycling'\n  | 'bodyFat'\n  | 'basalBodyTemperature'\n  | 'basalCalories'\n  | 'totalCalories'\n  | 'mindfulness'\n  | 'workouts';\n\nexport type HealthUnit =\n  | 'count'\n  | 'meter'\n  | 'kilocalorie'\n  | 'bpm'\n  | 'kilogram'\n  | 'minute'\n  | 'percent'\n  | 'millisecond'\n  | 'mmHg'\n  | 'mg/dL'\n  | 'celsius'\n  | 'fahrenheit'\n  | 'centimeter';\n\nexport interface AuthorizationOptions {\n  /** Data types that should be readable after authorization. */\n  read?: HealthDataType[];\n  /** Data types that should be writable after authorization. */\n  write?: HealthDataType[];\n}\n\nexport interface AuthorizationStatus {\n  readAuthorized: HealthDataType[];\n  readDenied: HealthDataType[];\n  writeAuthorized: HealthDataType[];\n  writeDenied: HealthDataType[];\n}\n\nexport interface AvailabilityResult {\n  available: boolean;\n  /** Platform specific details (for debugging/diagnostics). */\n  platform?: 'ios' | 'android' | 'web';\n  reason?: string;\n}\n\nexport interface QueryOptions {\n  /** The type of data to retrieve from the health store. */\n  dataType: HealthDataType;\n  /** Inclusive ISO 8601 start date (defaults to now - 1 day). */\n  startDate?: string;\n  /** Exclusive ISO 8601 end date (defaults to now). */\n  endDate?: string;\n  /** Maximum number of samples to return (defaults to 100). */\n  limit?: number;\n  /** Return results sorted ascending by start date (defaults to false). */\n  ascending?: boolean;\n}\n\nexport type SleepState = 'inBed' | 'asleep' | 'awake' | 'rem' | 'deep' | 'light';\n\nexport interface HealthSample {\n  dataType: HealthDataType;\n  value: number;\n  unit: HealthUnit;\n  startDate: string;\n  endDate: string;\n  sourceName?: string;\n  sourceId?: string;\n  /** Platform-specific unique identifier (HealthKit UUID on iOS, Health Connect metadata ID on Android). */\n  platformId?: string;\n  /** For sleep data, indicates the sleep state (e.g., 'asleep', 'awake', 'rem', 'deep', 'light'). */\n  sleepState?: SleepState;\n  /** For blood pressure data, the systolic value in mmHg. */\n  systolic?: number;\n  /** For blood pressure data, the diastolic value in mmHg. */\n  diastolic?: number;\n}\n\nexport interface ReadSamplesResult {\n  samples: HealthSample[];\n}\n\nexport type WorkoutType =\n  // Common types (supported on both platforms)\n  | 'americanFootball'\n  | 'australianFootball'\n  | 'badminton'\n  | 'baseball'\n  | 'basketball'\n  | 'bowling'\n  | 'boxing'\n  | 'climbing'\n  | 'cricket'\n  | 'crossTraining'\n  | 'curling'\n  | 'cycling'\n  | 'dance'\n  | 'elliptical'\n  | 'fencing'\n  | 'functionalStrengthTraining'\n  | 'golf'\n  | 'gymnastics'\n  | 'handball'\n  | 'hiking'\n  | 'hockey'\n  | 'jumpRope'\n  | 'kickboxing'\n  | 'lacrosse'\n  | 'martialArts'\n  | 'pilates'\n  | 'racquetball'\n  | 'rowing'\n  | 'rugby'\n  | 'running'\n  | 'sailing'\n  | 'skatingSports'\n  | 'skiing'\n  | 'snowboarding'\n  | 'soccer'\n  | 'softball'\n  | 'squash'\n  | 'stairClimbing'\n  | 'strengthTraining'\n  | 'surfing'\n  | 'swimming'\n  | 'swimmingPool'\n  | 'swimmingOpenWater'\n  | 'tableTennis'\n  | 'tennis'\n  | 'trackAndField'\n  | 'traditionalStrengthTraining'\n  | 'volleyball'\n  | 'walking'\n  | 'waterFitness'\n  | 'waterPolo'\n  | 'waterSports'\n  | 'weightlifting'\n  | 'wheelchair'\n  | 'yoga'\n  // iOS specific types\n  | 'archery'\n  | 'barre'\n  | 'cooldown'\n  | 'coreTraining'\n  | 'crossCountrySkiing'\n  | 'discSports'\n  | 'downhillSkiing'\n  | 'equestrianSports'\n  | 'fishing'\n  | 'fitnessGaming'\n  | 'flexibility'\n  | 'handCycling'\n  | 'highIntensityIntervalTraining'\n  | 'hunting'\n  | 'mindAndBody'\n  | 'mixedCardio'\n  | 'paddleSports'\n  | 'pickleball'\n  | 'play'\n  | 'preparationAndRecovery'\n  | 'snowSports'\n  | 'stairs'\n  | 'stepTraining'\n  | 'surfingSports'\n  | 'taiChi'\n  | 'transition'\n  | 'underwaterDiving'\n  | 'wheelchairRunPace'\n  | 'wheelchairWalkPace'\n  | 'wrestling'\n  | 'cardioDance'\n  | 'socialDance'\n  // Android specific types\n  | 'backExtension'\n  | 'barbellShoulderPress'\n  | 'benchPress'\n  | 'benchSitUp'\n  | 'bikingStationary'\n  | 'bootCamp'\n  | 'burpee'\n  | 'calisthenics'\n  | 'crunch'\n  | 'dancing'\n  | 'deadlift'\n  | 'dumbbellCurlLeftArm'\n  | 'dumbbellCurlRightArm'\n  | 'dumbbellFrontRaise'\n  | 'dumbbellLateralRaise'\n  | 'dumbbellTricepsExtensionLeftArm'\n  | 'dumbbellTricepsExtensionRightArm'\n  | 'dumbbellTricepsExtensionTwoArm'\n  | 'exerciseClass'\n  | 'forwardTwist'\n  | 'frisbeedisc'\n  | 'guidedBreathing'\n  | 'iceHockey'\n  | 'iceSkating'\n  | 'jumpingJack'\n  | 'latPullDown'\n  | 'lunge'\n  | 'meditation'\n  | 'paddling'\n  | 'paraGliding'\n  | 'plank'\n  | 'rockClimbing'\n  | 'rollerHockey'\n  | 'rowingMachine'\n  | 'runningTreadmill'\n  | 'scubaDiving'\n  | 'skating'\n  | 'snowshoeing'\n  | 'stairClimbingMachine'\n  | 'stretching'\n  | 'upperTwist'\n  | 'other';\n\nexport interface QueryWorkoutsOptions {\n  /** Optional workout type filter. If omitted, all workout types are returned. */\n  workoutType?: WorkoutType;\n  /** Inclusive ISO 8601 start date (defaults to now - 1 day). */\n  startDate?: string;\n  /** Exclusive ISO 8601 end date (defaults to now). */\n  endDate?: string;\n  /** Maximum number of workouts to return (defaults to 100). */\n  limit?: number;\n  /** Return results sorted ascending by start date (defaults to false). */\n  ascending?: boolean;\n  /**\n   * Anchor for pagination. Use the anchor returned from a previous query to continue from that point.\n   * On iOS, this is the ISO 8601 cursor returned by the previous query. On Android, this uses\n   * Health Connect's pageToken.\n   * Omit this parameter to start from the beginning.\n   */\n  anchor?: string;\n}\n\nexport interface Workout {\n  /** The type of workout. */\n  workoutType: WorkoutType;\n  /** Duration of the workout in seconds. */\n  duration: number;\n  /** Total energy burned in kilocalories (if available). */\n  totalEnergyBurned?: number;\n  /** Total distance in meters (if available). */\n  totalDistance?: number;\n  /** ISO 8601 start date of the workout. */\n  startDate: string;\n  /** ISO 8601 end date of the workout. */\n  endDate: string;\n  /** Source name that recorded the workout. */\n  sourceName?: string;\n  /** Source bundle identifier. */\n  sourceId?: string;\n  /** Platform-specific unique identifier (HealthKit UUID on iOS, Health Connect metadata ID on Android). */\n  platformId?: string;\n  /** Additional metadata (if available). */\n  metadata?: Record<string, string>;\n}\n\nexport interface QueryWorkoutsResult {\n  workouts: Workout[];\n  /**\n   * Anchor for the next page of results. Pass this value as the anchor parameter in the next query\n   * to continue pagination. If undefined or null, there are no more results.\n   */\n  anchor?: string;\n}\n\nexport interface WriteSampleOptions {\n  dataType: HealthDataType;\n  value: number;\n  /**\n   * Optional unit override. If omitted, the default unit for the data type is used\n   * (count for `steps`, meter for `distance`, kilocalorie for `calories`, bpm for `heartRate`, kilogram for `weight`).\n   */\n  unit?: HealthUnit;\n  /** ISO 8601 start date for the sample. Defaults to now. */\n  startDate?: string;\n  /** ISO 8601 end date for the sample. Defaults to startDate. */\n  endDate?: string;\n  /** Metadata key-value pairs forwarded to the native APIs where supported. */\n  metadata?: Record<string, string>;\n  /** For blood pressure data, the systolic value in mmHg. Required when dataType is 'bloodPressure'. */\n  systolic?: number;\n  /** For blood pressure data, the diastolic value in mmHg. Required when dataType is 'bloodPressure'. */\n  diastolic?: number;\n}\n\nexport type BucketType = 'hour' | 'day' | 'week' | 'month';\n\nexport type AggregationType = 'sum' | 'average' | 'min' | 'max';\n\nexport interface QueryAggregatedOptions {\n  /** The type of data to aggregate from the health store. */\n  dataType: HealthDataType;\n  /** Inclusive ISO 8601 start date (defaults to now - 1 day). */\n  startDate?: string;\n  /** Exclusive ISO 8601 end date (defaults to now). */\n  endDate?: string;\n  /** Time bucket for aggregation (defaults to 'day'). */\n  bucket?: BucketType;\n  /** Aggregation operation to perform (defaults to 'sum'). */\n  aggregation?: AggregationType;\n}\n\nexport interface AggregatedSample {\n  /** ISO 8601 start date of the bucket. */\n  startDate: string;\n  /** ISO 8601 end date of the bucket. */\n  endDate: string;\n  /** Aggregated value for the bucket. */\n  value: number;\n  /** Unit of the aggregated value. */\n  unit: HealthUnit;\n}\n\nexport interface QueryAggregatedResult {\n  samples: AggregatedSample[];\n}\n\nexport interface HealthPlugin {\n  /** Returns whether the current platform supports the native health SDK. */\n  isAvailable(): Promise<AvailabilityResult>;\n  /** Requests read/write access to the provided data types. */\n  requestAuthorization(options: AuthorizationOptions): Promise<AuthorizationStatus>;\n  /** Checks authorization status for the provided data types without prompting the user. */\n  checkAuthorization(options: AuthorizationOptions): Promise<AuthorizationStatus>;\n  /** Reads samples for the given data type within the specified time frame. */\n  readSamples(options: QueryOptions): Promise<ReadSamplesResult>;\n  /** Writes a single sample to the native health store. */\n  saveSample(options: WriteSampleOptions): Promise<void>;\n\n  /**\n   * Get the native Capacitor plugin version\n   *\n   * @returns {Promise<{ version: string }>} a Promise with version for this device\n   * @throws An error if something went wrong\n   */\n  getPluginVersion(): Promise<{ version: string }>;\n\n  /**\n   * Opens the Health Connect settings screen (Android only).\n   * On iOS, this method does nothing.\n   *\n   * Use this to direct users to manage their Health Connect permissions\n   * or to install Health Connect if not available.\n   *\n   * @throws An error if Health Connect settings cannot be opened\n   */\n  openHealthConnectSettings(): Promise<void>;\n\n  /**\n   * Shows the app's privacy policy for Health Connect (Android only).\n   * On iOS, this method does nothing.\n   *\n   * This displays the same privacy policy screen that Health Connect shows\n   * when the user taps \"Privacy policy\" in the permissions dialog.\n   *\n   * The privacy policy URL can be configured by adding a string resource\n   * named \"health_connect_privacy_policy_url\" in your app's strings.xml,\n   * or by placing an HTML file at www/privacypolicy.html in your assets.\n   *\n   * @throws An error if the privacy policy cannot be displayed\n   */\n  showPrivacyPolicy(): Promise<void>;\n\n  /**\n   * Queries workout sessions from the native health store.\n   * Supported on iOS (HealthKit) and Android (Health Connect).\n   *\n   * @param options Query options including optional workout type filter, date range, limit, and sort order\n   * @returns A promise that resolves with the workout sessions\n   * @throws An error if something went wrong\n   */\n  queryWorkouts(options: QueryWorkoutsOptions): Promise<QueryWorkoutsResult>;\n\n  /**\n   * Queries aggregated health data from the native health store.\n   * Aggregates data into time buckets (hour, day, week, month) with operations like sum, average, min, or max.\n   * This is more efficient than fetching individual samples for large date ranges.\n   *\n   * Supported on iOS (HealthKit) and Android (Health Connect).\n   *\n   * @param options Query options including data type, date range, bucket size, and aggregation type\n   * @returns A promise that resolves with the aggregated samples\n   * @throws An error if something went wrong\n   */\n  queryAggregated(options: QueryAggregatedOptions): Promise<QueryAggregatedResult>;\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["export type HealthDataType =\n  | 'steps'\n  | 'distance'\n  | 'calories'\n  | 'heartRate'\n  | 'weight'\n  | 'sleep'\n  | 'respiratoryRate'\n  | 'oxygenSaturation'\n  | 'restingHeartRate'\n  | 'heartRateVariability'\n  | 'vo2Max'\n  | 'bloodPressure'\n  | 'bloodGlucose'\n  | 'bodyTemperature'\n  | 'height'\n  | 'flightsClimbed'\n  | 'exerciseTime'\n  | 'distanceCycling'\n  | 'bodyFat'\n  | 'basalBodyTemperature'\n  | 'basalCalories'\n  | 'totalCalories'\n  | 'mindfulness'\n  | 'workouts';\n\nexport type HealthUnit =\n  | 'count'\n  | 'meter'\n  | 'kilocalorie'\n  | 'bpm'\n  | 'kilogram'\n  | 'minute'\n  | 'percent'\n  | 'millisecond'\n  | 'mL/min/kg'\n  | 'mmHg'\n  | 'mg/dL'\n  | 'celsius'\n  | 'fahrenheit'\n  | 'centimeter';\n\nexport interface AuthorizationOptions {\n  /** Data types that should be readable after authorization. */\n  read?: HealthDataType[];\n  /** Data types that should be writable after authorization. */\n  write?: HealthDataType[];\n}\n\nexport interface AuthorizationStatus {\n  readAuthorized: HealthDataType[];\n  readDenied: HealthDataType[];\n  writeAuthorized: HealthDataType[];\n  writeDenied: HealthDataType[];\n}\n\nexport interface AvailabilityResult {\n  available: boolean;\n  /** Platform specific details (for debugging/diagnostics). */\n  platform?: 'ios' | 'android' | 'web';\n  reason?: string;\n}\n\nexport interface QueryOptions {\n  /** The type of data to retrieve from the health store. */\n  dataType: HealthDataType;\n  /** Inclusive ISO 8601 start date (defaults to now - 1 day). */\n  startDate?: string;\n  /** Exclusive ISO 8601 end date (defaults to now). */\n  endDate?: string;\n  /** Maximum number of samples to return (defaults to 100). */\n  limit?: number;\n  /** Return results sorted ascending by start date (defaults to false). */\n  ascending?: boolean;\n}\n\nexport type SleepState = 'inBed' | 'asleep' | 'awake' | 'rem' | 'deep' | 'light';\n\nexport interface HealthSample {\n  dataType: HealthDataType;\n  value: number;\n  unit: HealthUnit;\n  startDate: string;\n  endDate: string;\n  sourceName?: string;\n  sourceId?: string;\n  /** Platform-specific unique identifier (HealthKit UUID on iOS, Health Connect metadata ID on Android). */\n  platformId?: string;\n  /** For sleep data, indicates the sleep state (e.g., 'asleep', 'awake', 'rem', 'deep', 'light'). */\n  sleepState?: SleepState;\n  /** For blood pressure data, the systolic value in mmHg. */\n  systolic?: number;\n  /** For blood pressure data, the diastolic value in mmHg. */\n  diastolic?: number;\n  /** For VO2 max data on Android, Health Connect's measurement method enum value. */\n  measurementMethod?: number;\n}\n\nexport interface ReadSamplesResult {\n  samples: HealthSample[];\n}\n\nexport type WorkoutType =\n  // Common types (supported on both platforms)\n  | 'americanFootball'\n  | 'australianFootball'\n  | 'badminton'\n  | 'baseball'\n  | 'basketball'\n  | 'bowling'\n  | 'boxing'\n  | 'climbing'\n  | 'cricket'\n  | 'crossTraining'\n  | 'curling'\n  | 'cycling'\n  | 'dance'\n  | 'elliptical'\n  | 'fencing'\n  | 'functionalStrengthTraining'\n  | 'golf'\n  | 'gymnastics'\n  | 'handball'\n  | 'hiking'\n  | 'hockey'\n  | 'jumpRope'\n  | 'kickboxing'\n  | 'lacrosse'\n  | 'martialArts'\n  | 'pilates'\n  | 'racquetball'\n  | 'rowing'\n  | 'rugby'\n  | 'running'\n  | 'sailing'\n  | 'skatingSports'\n  | 'skiing'\n  | 'snowboarding'\n  | 'soccer'\n  | 'softball'\n  | 'squash'\n  | 'stairClimbing'\n  | 'strengthTraining'\n  | 'surfing'\n  | 'swimming'\n  | 'swimmingPool'\n  | 'swimmingOpenWater'\n  | 'tableTennis'\n  | 'tennis'\n  | 'trackAndField'\n  | 'traditionalStrengthTraining'\n  | 'volleyball'\n  | 'walking'\n  | 'waterFitness'\n  | 'waterPolo'\n  | 'waterSports'\n  | 'weightlifting'\n  | 'wheelchair'\n  | 'yoga'\n  // iOS specific types\n  | 'archery'\n  | 'barre'\n  | 'cooldown'\n  | 'coreTraining'\n  | 'crossCountrySkiing'\n  | 'discSports'\n  | 'downhillSkiing'\n  | 'equestrianSports'\n  | 'fishing'\n  | 'fitnessGaming'\n  | 'flexibility'\n  | 'handCycling'\n  | 'highIntensityIntervalTraining'\n  | 'hunting'\n  | 'mindAndBody'\n  | 'mixedCardio'\n  | 'paddleSports'\n  | 'pickleball'\n  | 'play'\n  | 'preparationAndRecovery'\n  | 'snowSports'\n  | 'stairs'\n  | 'stepTraining'\n  | 'surfingSports'\n  | 'taiChi'\n  | 'transition'\n  | 'underwaterDiving'\n  | 'wheelchairRunPace'\n  | 'wheelchairWalkPace'\n  | 'wrestling'\n  | 'cardioDance'\n  | 'socialDance'\n  // Android specific types\n  | 'backExtension'\n  | 'barbellShoulderPress'\n  | 'benchPress'\n  | 'benchSitUp'\n  | 'bikingStationary'\n  | 'bootCamp'\n  | 'burpee'\n  | 'calisthenics'\n  | 'crunch'\n  | 'dancing'\n  | 'deadlift'\n  | 'dumbbellCurlLeftArm'\n  | 'dumbbellCurlRightArm'\n  | 'dumbbellFrontRaise'\n  | 'dumbbellLateralRaise'\n  | 'dumbbellTricepsExtensionLeftArm'\n  | 'dumbbellTricepsExtensionRightArm'\n  | 'dumbbellTricepsExtensionTwoArm'\n  | 'exerciseClass'\n  | 'forwardTwist'\n  | 'frisbeedisc'\n  | 'guidedBreathing'\n  | 'iceHockey'\n  | 'iceSkating'\n  | 'jumpingJack'\n  | 'latPullDown'\n  | 'lunge'\n  | 'meditation'\n  | 'paddling'\n  | 'paraGliding'\n  | 'plank'\n  | 'rockClimbing'\n  | 'rollerHockey'\n  | 'rowingMachine'\n  | 'runningTreadmill'\n  | 'scubaDiving'\n  | 'skating'\n  | 'snowshoeing'\n  | 'stairClimbingMachine'\n  | 'stretching'\n  | 'upperTwist'\n  | 'other';\n\nexport interface QueryWorkoutsOptions {\n  /** Optional workout type filter. If omitted, all workout types are returned. */\n  workoutType?: WorkoutType;\n  /** Inclusive ISO 8601 start date (defaults to now - 1 day). */\n  startDate?: string;\n  /** Exclusive ISO 8601 end date (defaults to now). */\n  endDate?: string;\n  /** Maximum number of workouts to return (defaults to 100). */\n  limit?: number;\n  /** Return results sorted ascending by start date (defaults to false). */\n  ascending?: boolean;\n  /**\n   * Anchor for pagination. Use the anchor returned from a previous query to continue from that point.\n   * On iOS, this is the ISO 8601 cursor returned by the previous query. On Android, this uses\n   * Health Connect's pageToken.\n   * Omit this parameter to start from the beginning.\n   */\n  anchor?: string;\n}\n\nexport interface Workout {\n  /** The type of workout. */\n  workoutType: WorkoutType;\n  /** Duration of the workout in seconds. */\n  duration: number;\n  /** Total energy burned in kilocalories (if available). */\n  totalEnergyBurned?: number;\n  /** Total distance in meters (if available). */\n  totalDistance?: number;\n  /** ISO 8601 start date of the workout. */\n  startDate: string;\n  /** ISO 8601 end date of the workout. */\n  endDate: string;\n  /** Source name that recorded the workout. */\n  sourceName?: string;\n  /** Source bundle identifier. */\n  sourceId?: string;\n  /** Platform-specific unique identifier (HealthKit UUID on iOS, Health Connect metadata ID on Android). */\n  platformId?: string;\n  /** Additional metadata (if available). */\n  metadata?: Record<string, string>;\n}\n\nexport interface QueryWorkoutsResult {\n  workouts: Workout[];\n  /**\n   * Anchor for the next page of results. Pass this value as the anchor parameter in the next query\n   * to continue pagination. If undefined or null, there are no more results.\n   */\n  anchor?: string;\n}\n\nexport interface WriteSampleOptions {\n  dataType: HealthDataType;\n  value: number;\n  /**\n   * Optional unit override. If omitted, the default unit for the data type is used\n   * (count for `steps`, meter for `distance`, kilocalorie for `calories`, bpm for `heartRate`, kilogram for `weight`).\n   */\n  unit?: HealthUnit;\n  /** ISO 8601 start date for the sample. Defaults to now. */\n  startDate?: string;\n  /** ISO 8601 end date for the sample. Defaults to startDate. */\n  endDate?: string;\n  /** Metadata key-value pairs forwarded to the native APIs where supported. */\n  metadata?: Record<string, string>;\n  /** For blood pressure data, the systolic value in mmHg. Required when dataType is 'bloodPressure'. */\n  systolic?: number;\n  /** For blood pressure data, the diastolic value in mmHg. Required when dataType is 'bloodPressure'. */\n  diastolic?: number;\n}\n\nexport type BucketType = 'hour' | 'day' | 'week' | 'month';\n\nexport type AggregationType = 'sum' | 'average' | 'min' | 'max';\n\nexport interface QueryAggregatedOptions {\n  /** The type of data to aggregate from the health store. */\n  dataType: HealthDataType;\n  /** Inclusive ISO 8601 start date (defaults to now - 1 day). */\n  startDate?: string;\n  /** Exclusive ISO 8601 end date (defaults to now). */\n  endDate?: string;\n  /** Time bucket for aggregation (defaults to 'day'). */\n  bucket?: BucketType;\n  /** Aggregation operation to perform (defaults to 'sum'). */\n  aggregation?: AggregationType;\n}\n\nexport interface AggregatedSample {\n  /** ISO 8601 start date of the bucket. */\n  startDate: string;\n  /** ISO 8601 end date of the bucket. */\n  endDate: string;\n  /** Aggregated value for the bucket. */\n  value: number;\n  /** Unit of the aggregated value. */\n  unit: HealthUnit;\n}\n\nexport interface QueryAggregatedResult {\n  samples: AggregatedSample[];\n}\n\nexport interface HealthPlugin {\n  /** Returns whether the current platform supports the native health SDK. */\n  isAvailable(): Promise<AvailabilityResult>;\n  /** Requests read/write access to the provided data types. */\n  requestAuthorization(options: AuthorizationOptions): Promise<AuthorizationStatus>;\n  /** Checks authorization status for the provided data types without prompting the user. */\n  checkAuthorization(options: AuthorizationOptions): Promise<AuthorizationStatus>;\n  /** Reads samples for the given data type within the specified time frame. */\n  readSamples(options: QueryOptions): Promise<ReadSamplesResult>;\n  /** Writes a single sample to the native health store. */\n  saveSample(options: WriteSampleOptions): Promise<void>;\n\n  /**\n   * Get the native Capacitor plugin version\n   *\n   * @returns {Promise<{ version: string }>} a Promise with version for this device\n   * @throws An error if something went wrong\n   */\n  getPluginVersion(): Promise<{ version: string }>;\n\n  /**\n   * Opens the Health Connect settings screen (Android only).\n   * On iOS, this method does nothing.\n   *\n   * Use this to direct users to manage their Health Connect permissions\n   * or to install Health Connect if not available.\n   *\n   * @throws An error if Health Connect settings cannot be opened\n   */\n  openHealthConnectSettings(): Promise<void>;\n\n  /**\n   * Shows the app's privacy policy for Health Connect (Android only).\n   * On iOS, this method does nothing.\n   *\n   * This displays the same privacy policy screen that Health Connect shows\n   * when the user taps \"Privacy policy\" in the permissions dialog.\n   *\n   * The privacy policy URL can be configured by adding a string resource\n   * named \"health_connect_privacy_policy_url\" in your app's strings.xml,\n   * or by placing an HTML file at www/privacypolicy.html in your assets.\n   *\n   * @throws An error if the privacy policy cannot be displayed\n   */\n  showPrivacyPolicy(): Promise<void>;\n\n  /**\n   * Queries workout sessions from the native health store.\n   * Supported on iOS (HealthKit) and Android (Health Connect).\n   *\n   * @param options Query options including optional workout type filter, date range, limit, and sort order\n   * @returns A promise that resolves with the workout sessions\n   * @throws An error if something went wrong\n   */\n  queryWorkouts(options: QueryWorkoutsOptions): Promise<QueryWorkoutsResult>;\n\n  /**\n   * Queries aggregated health data from the native health store.\n   * Aggregates data into time buckets (hour, day, week, month) with operations like sum, average, min, or max.\n   * This is more efficient than fetching individual samples for large date ranges.\n   *\n   * Supported on iOS (HealthKit) and Android (Health Connect).\n   *\n   * @param options Query options including data type, date range, bucket size, and aggregation type\n   * @returns A promise that resolves with the aggregated samples\n   * @throws An error if something went wrong\n   */\n  queryAggregated(options: QueryAggregatedOptions): Promise<QueryAggregatedResult>;\n}\n"]}

package/ios/Sources/HealthPlugin/HealthPlugin.swift

@@ -3,7 +3,7 @@ import Capacitor
 
 @objc(HealthPlugin)
 public class HealthPlugin: CAPPlugin, CAPBridgedPlugin {
-    private let pluginVersion: String = "8.4.9"
+    private let pluginVersion: String = "8.5.0"
     public let identifier = "HealthPlugin"
     public let jsName = "Health"
     public let pluginMethods: [CAPPluginMethod] = [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capgo/capacitor-health",
-  "version": "8.4.9",
+  "version": "8.5.0",
   "description": "Capacitor plugin to interact with data from Apple HealthKit and Health Connect",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",