@asiriindatissa/capacitor-health 8.4.0 → 8.4.2

package/README.md

@@ -97,7 +97,7 @@ if (!availability.available) {
 // Ask for separate read/write access scopes
 // Include 'workouts' if you need to query workout sessions
 await Health.requestAuthorization({
-  read: ['steps', 'heartRate', 'weight', 'workouts'],
+  read: ['steps', 'heartRate', 'weight', 'totalCalories', 'workouts'],
   write: ['weight'],
 });
 
@@ -118,14 +118,15 @@ await Health.saveSample({
 
 ### Supported data types
 
-| Identifier  | Default unit  | Notes                      |
-| ----------- | ------------- | -------------------------- |
-| `steps`     | `count`       | Step count deltas          |
-| `distance`  | `meter`       | Walking / running distance |
-| `calories`  | `kilocalorie` | Active energy burned       |
-| `heartRate` | `bpm`         | Beats per minute           |
-| `weight`    | `kilogram`    | Body mass                  |
-| `height`    | `meter`       | Body height                |
+| Identifier      | Default unit  | Notes                      |
+| --------------- | ------------- | -------------------------- |
+| `steps`         | `count`       | Step count deltas          |
+| `distance`      | `meter`       | Walking / running distance |
+| `calories`      | `kilocalorie` | Active energy burned       |
+| `totalCalories` | `kilocalorie` | Total energy burned        |
+| `heartRate`     | `bpm`         | Beats per minute           |
+| `weight`        | `kilogram`    | Body mass                  |
+| `height`        | `meter`       | Body height                |
 
 All write operations expect the default unit shown above. On Android the `metadata` option is currently ignored by Health Connect.
 
@@ -135,8 +136,10 @@ To query workout sessions, you need to request read permission for `'workouts'`:
 
 ```ts
 // Request permission to read workouts
+// IMPORTANT: To see totalEnergyBurned and totalDistance in workout data,
+// you MUST also request permissions for 'calories' (or 'totalCalories') and 'distance'
 await Health.requestAuthorization({
-  read: ['workouts', 'steps', 'heartRate'],  // Include 'workouts' for queryWorkouts()
+  read: ['workouts', 'calories', 'totalCalories', 'distance'], // Include data types for workout metrics
   write: [],
 });
 
@@ -146,9 +149,18 @@ const { workouts } = await Health.queryWorkouts({
   endDate: new Date().toISOString(),
   limit: 10,
 });
+
+// Each workout may include:
+// - workoutType, duration, startDate, endDate (always present)
+// - totalEnergyBurned (if calories/totalCalories permission granted and data exists)
+// - totalDistance (if distance permission granted and data exists)
 ```
 
-Note: `'workouts'` is a special read-only permission type. You cannot write workouts with this plugin.
+**Note:**
+
+- `'workouts'` is a special read-only permission type. You cannot write workouts with this plugin.
+- Workout energy and distance data are aggregated from separate Health Connect records during the workout time period. If you don't request permissions for `calories`/`totalCalories` and `distance`, these fields will be missing from workout results.
+- If `totalEnergyBurned` or `totalDistance` are missing despite having permissions, it means no calorie or distance data was recorded during that workout period in Health Connect.
 
 ## API
 
@@ -375,14 +387,14 @@ Queries workout sessions from the native health store on Android (Health Connect
 
 #### WriteSampleOptions
 
-| Prop            | Type                                                            | Description                                                                                                                                                                                                           |
-| --------------- | --------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **`dataType`**  | <code><a href="#healthdatatype">HealthDataType</a></code>       |                                                                                                                                                                                                                       |
-| **`value`**     | <code>number</code>                                             |                                                                                                                                                                                                                       |
-| **`unit`**      | <code><a href="#healthunit">HealthUnit</a></code>               | Optional unit override. If omitted, the default unit for the data type is used (count for `steps`, meter for `distance`, kilocalorie for `calories`, bpm for `heartRate`, kilogram for `weight`, meter for `height`). |
-| **`startDate`** | <code>string</code>                                             | ISO 8601 start date for the sample. Defaults to now.                                                                                                                                                                  |
-| **`endDate`**   | <code>string</code>                                             | ISO 8601 end date for the sample. Defaults to startDate.                                                                                                                                                              |
-| **`metadata`**  | <code><a href="#record">Record</a>&lt;string, string&gt;</code> | Metadata key-value pairs forwarded to the native APIs where supported.                                                                                                                                                |
+| Prop            | Type                                                            | Description                                                                                                                                                                                                                               |
+| --------------- | --------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **`dataType`**  | <code><a href="#healthdatatype">HealthDataType</a></code>       |                                                                                                                                                                                                                                           |
+| **`value`**     | <code>number</code>                                             |                                                                                                                                                                                                                                           |
+| **`unit`**      | <code><a href="#healthunit">HealthUnit</a></code>               | Optional unit override. If omitted, the default unit for the data type is used (count for `steps`, meter for `distance`, kilocalorie for `calories` and `totalCalories`, bpm for `heartRate`, kilogram for `weight`, meter for `height`). |
+| **`startDate`** | <code>string</code>                                             | ISO 8601 start date for the sample. Defaults to now.                                                                                                                                                                                      |
+| **`endDate`**   | <code>string</code>                                             | ISO 8601 end date for the sample. Defaults to startDate.                                                                                                                                                                                  |
+| **`metadata`**  | <code><a href="#record">Record</a>&lt;string, string&gt;</code> | Metadata key-value pairs forwarded to the native APIs where supported.                                                                                                                                                                    |
 
 
 #### QueryWorkoutsResult
@@ -431,7 +443,7 @@ Includes 'workouts' for querying workout sessions via queryWorkouts().
 
 #### HealthDataType
 
-<code>'steps' | 'distance' | 'calories' | 'heartRate' | 'weight' | 'height'</code>
+<code>'steps' | 'distance' | 'calories' | 'totalCalories' | 'heartRate' | 'weight' | 'height'</code>
 
 
 #### HealthUnit

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

@@ -7,6 +7,7 @@ import androidx.health.connect.client.records.HeartRateRecord
 import androidx.health.connect.client.records.HeightRecord
 import androidx.health.connect.client.records.Record
 import androidx.health.connect.client.records.StepsRecord
+import androidx.health.connect.client.records.TotalCaloriesBurnedRecord
 import androidx.health.connect.client.records.WeightRecord
 import kotlin.reflect.KClass
 
@@ -18,6 +19,7 @@ enum class HealthDataType(
     STEPS("steps", StepsRecord::class, "count"),
     DISTANCE("distance", DistanceRecord::class, "meter"),
     CALORIES("calories", ActiveCaloriesBurnedRecord::class, "kilocalorie"),
+    TOTAL_CALORIES("totalCalories", TotalCaloriesBurnedRecord::class, "kilocalorie"),
     HEART_RATE("heartRate", HeartRateRecord::class, "bpm"),
     WEIGHT("weight", WeightRecord::class, "kilogram"),
     HEIGHT("height", HeightRecord::class, "meter");

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

@@ -127,6 +127,16 @@ class HealthManager {
                 )
                 samples.add(record.startTime to payload)
             }
+            HealthDataType.TOTAL_CALORIES -> readRecords(client, TotalCaloriesBurnedRecord::class, startTime, endTime, limit) { record ->
+                val payload = createSamplePayload(
+                    dataType,
+                    record.startTime,
+                    record.endTime,
+                    record.energy.inKilocalories,
+                    record.metadata
+                )
+                samples.add(record.startTime to payload)
+            }
             HealthDataType.WEIGHT -> readRecords(client, WeightRecord::class, startTime, endTime, limit) { record ->
                 val payload = createSamplePayload(
                     dataType,
@@ -238,6 +248,16 @@ class HealthManager {
                 )
                 client.insertRecords(listOf(record))
             }
+            HealthDataType.TOTAL_CALORIES -> {
+                val record = TotalCaloriesBurnedRecord(
+                    startTime = startTime,
+                    startZoneOffset = zoneOffset(startTime),
+                    endTime = endTime,
+                    endZoneOffset = zoneOffset(endTime),
+                    energy = Energy.kilocalories(value)
+                )
+                client.insertRecords(listOf(record))
+            }
             HealthDataType.WEIGHT -> {
                 val record = WeightRecord(
                     time = startTime,
@@ -380,9 +400,13 @@ class HealthManager {
                 // Removed dataOriginFilter to get distance from all sources during workout time
             )
             val result = client.aggregate(aggregateRequest)
-            result[DistanceRecord.DISTANCE_TOTAL]?.inMeters
+            val distance = result[DistanceRecord.DISTANCE_TOTAL]?.inMeters
+            if (distance == null) {
+                android.util.Log.d("HealthManager", "No distance data found for workout ${session.startTime} to ${session.endTime}")
+            }
+            distance
         } catch (e: Exception) {
-            android.util.Log.d("HealthManager", "Distance aggregation failed for workout: ${e.message}", e)
+            android.util.Log.w("HealthManager", "Distance aggregation failed for workout: ${e.message}", e)
             null // Permission might not be granted or no data available
         }
 
@@ -393,21 +417,34 @@ class HealthManager {
                 timeRangeFilter = timeRange
             )
             val result = client.aggregate(aggregateRequest)
-            result[ActiveCaloriesBurnedRecord.ACTIVE_CALORIES_TOTAL]?.inKilocalories
-        } catch (e: Exception) {
-            android.util.Log.d("HealthManager", "Active calories aggregation failed, trying total calories: ${e.message}", e)
-            // Fall back to total calories
-            try {
-                val aggregateRequest = AggregateRequest(
-                    metrics = setOf(TotalCaloriesBurnedRecord.ENERGY_TOTAL),
-                    timeRangeFilter = timeRange
-                )
-                val result = client.aggregate(aggregateRequest)
-                result[TotalCaloriesBurnedRecord.ENERGY_TOTAL]?.inKilocalories
-            } catch (e2: Exception) {
-                android.util.Log.d("HealthManager", "Total calories aggregation also failed: ${e2.message}", e2)
-                null // Permission might not be granted or no data available
+            val activeCalories = result[ActiveCaloriesBurnedRecord.ACTIVE_CALORIES_TOTAL]?.inKilocalories
+            if (activeCalories != null && activeCalories > 0) {
+                android.util.Log.d("HealthManager", "Found active calories: $activeCalories kcal")
+                activeCalories
+            } else {
+                android.util.Log.d("HealthManager", "No active calories found, trying total calories")
+                // Fall back to total calories
+                try {
+                    val totalRequest = AggregateRequest(
+                        metrics = setOf(TotalCaloriesBurnedRecord.ENERGY_TOTAL),
+                        timeRangeFilter = timeRange
+                    )
+                    val totalResult = client.aggregate(totalRequest)
+                    val totalCalories = totalResult[TotalCaloriesBurnedRecord.ENERGY_TOTAL]?.inKilocalories
+                    if (totalCalories != null && totalCalories > 0) {
+                        android.util.Log.d("HealthManager", "Found total calories: $totalCalories kcal")
+                    } else {
+                        android.util.Log.w("HealthManager", "No calorie data (active or total) available for workout ${session.startTime} to ${session.endTime}")
+                    }
+                    totalCalories
+                } catch (e2: Exception) {
+                    android.util.Log.w("HealthManager", "Total calories aggregation failed: ${e2.message}", e2)
+                    null
+                }
             }
+        } catch (e: Exception) {
+            android.util.Log.w("HealthManager", "Active calories aggregation failed: ${e.message}", e)
+            null // Permission might not be granted or no data available
         }
 
         return WorkoutAggregatedData(

package/dist/docs.json

@@ -431,7 +431,7 @@
         {
           "name": "unit",
           "tags": [],
-          "docs": "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`, meter for `height`).",
+          "docs": "Optional unit override. If omitted, the default unit for the data type is used\n(count for `steps`, meter for `distance`, kilocalorie for `calories` and `totalCalories`, bpm for `heartRate`, kilogram for `weight`, meter for `height`).",
           "complexTypes": [
             "HealthUnit"
           ],
@@ -639,6 +639,10 @@
           "text": "'calories'",
           "complexTypes": []
         },
+        {
+          "text": "'totalCalories'",
+          "complexTypes": []
+        },
         {
           "text": "'heartRate'",
           "complexTypes": []

package/dist/esm/definitions.d.ts

@@ -1,4 +1,4 @@
-export type HealthDataType = 'steps' | 'distance' | 'calories' | 'heartRate' | 'weight' | 'height';
+export type HealthDataType = 'steps' | 'distance' | 'calories' | 'totalCalories' | 'heartRate' | 'weight' | 'height';
 export type HealthUnit = 'count' | 'meter' | 'kilocalorie' | 'bpm' | 'kilogram';
 /**
  * Data types that can be requested for read authorization.
@@ -95,7 +95,7 @@ export interface WriteSampleOptions {
     value: number;
     /**
      * Optional unit override. If omitted, the default unit for the data type is used
-     * (count for `steps`, meter for `distance`, kilocalorie for `calories`, bpm for `heartRate`, kilogram for `weight`, meter for `height`).
+     * (count for `steps`, meter for `distance`, kilocalorie for `calories` and `totalCalories`, bpm for `heartRate`, kilogram for `weight`, meter for `height`).
      */
     unit?: HealthUnit;
     /** ISO 8601 start date for the sample. Defaults to now. */

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["export type HealthDataType = 'steps' | 'distance' | 'calories' | 'heartRate' | 'weight' | 'height';\n\nexport type HealthUnit = 'count' | 'meter' | 'kilocalorie' | 'bpm' | 'kilogram';\n\n/**\n * Data types that can be requested for read authorization.\n * Includes 'workouts' for querying workout sessions via queryWorkouts().\n */\nexport type ReadAuthorizationType = HealthDataType | 'workouts';\n\nexport interface AuthorizationOptions {\n  /**\n   * Data types that should be readable after authorization.\n   * Include 'workouts' to enable queryWorkouts() method.\n   */\n  read?: ReadAuthorizationType[];\n  /** Data types that should be writable after authorization. */\n  write?: HealthDataType[];\n}\n\nexport interface AuthorizationStatus {\n  /** Data types (and 'workouts') that are authorized for reading */\n  readAuthorized: ReadAuthorizationType[];\n  /** Data types (and 'workouts') that are denied for reading */\n  readDenied: ReadAuthorizationType[];\n  /** Data types that are authorized for writing */\n  writeAuthorized: HealthDataType[];\n  /** Data types that are denied for writing */\n  writeDenied: HealthDataType[];\n}\n\nexport interface AvailabilityResult {\n  available: boolean;\n  /** Platform specific details (for debugging/diagnostics). */\n  platform?: '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 interface HealthSample {\n  dataType: HealthDataType;\n  value: number;\n  unit: HealthUnit;\n  startDate: string;\n  endDate: string;\n  sourceName?: string;\n  sourceId?: string;\n}\n\nexport interface ReadSamplesResult {\n  samples: HealthSample[];\n}\n\nexport type WorkoutType =\n  | 'running'\n  | 'cycling'\n  | 'walking'\n  | 'swimming'\n  | 'yoga'\n  | 'strengthTraining'\n  | 'hiking'\n  | 'tennis'\n  | 'basketball'\n  | 'soccer'\n  | 'americanFootball'\n  | 'baseball'\n  | 'crossTraining'\n  | 'elliptical'\n  | 'rowing'\n  | 'stairClimbing'\n  | 'traditionalStrengthTraining'\n  | 'waterFitness'\n  | 'waterPolo'\n  | 'waterSports'\n  | 'wrestling'\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\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  /** Additional metadata (if available). */\n  metadata?: Record<string, string>;\n}\n\nexport interface QueryWorkoutsResult {\n  workouts: Workout[];\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`, meter for `height`).\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}\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.\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.\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 on 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"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["export type HealthDataType = 'steps' | 'distance' | 'calories' | 'totalCalories' | 'heartRate' | 'weight' | 'height';\n\nexport type HealthUnit = 'count' | 'meter' | 'kilocalorie' | 'bpm' | 'kilogram';\n\n/**\n * Data types that can be requested for read authorization.\n * Includes 'workouts' for querying workout sessions via queryWorkouts().\n */\nexport type ReadAuthorizationType = HealthDataType | 'workouts';\n\nexport interface AuthorizationOptions {\n  /**\n   * Data types that should be readable after authorization.\n   * Include 'workouts' to enable queryWorkouts() method.\n   */\n  read?: ReadAuthorizationType[];\n  /** Data types that should be writable after authorization. */\n  write?: HealthDataType[];\n}\n\nexport interface AuthorizationStatus {\n  /** Data types (and 'workouts') that are authorized for reading */\n  readAuthorized: ReadAuthorizationType[];\n  /** Data types (and 'workouts') that are denied for reading */\n  readDenied: ReadAuthorizationType[];\n  /** Data types that are authorized for writing */\n  writeAuthorized: HealthDataType[];\n  /** Data types that are denied for writing */\n  writeDenied: HealthDataType[];\n}\n\nexport interface AvailabilityResult {\n  available: boolean;\n  /** Platform specific details (for debugging/diagnostics). */\n  platform?: '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 interface HealthSample {\n  dataType: HealthDataType;\n  value: number;\n  unit: HealthUnit;\n  startDate: string;\n  endDate: string;\n  sourceName?: string;\n  sourceId?: string;\n}\n\nexport interface ReadSamplesResult {\n  samples: HealthSample[];\n}\n\nexport type WorkoutType =\n  | 'running'\n  | 'cycling'\n  | 'walking'\n  | 'swimming'\n  | 'yoga'\n  | 'strengthTraining'\n  | 'hiking'\n  | 'tennis'\n  | 'basketball'\n  | 'soccer'\n  | 'americanFootball'\n  | 'baseball'\n  | 'crossTraining'\n  | 'elliptical'\n  | 'rowing'\n  | 'stairClimbing'\n  | 'traditionalStrengthTraining'\n  | 'waterFitness'\n  | 'waterPolo'\n  | 'waterSports'\n  | 'wrestling'\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\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  /** Additional metadata (if available). */\n  metadata?: Record<string, string>;\n}\n\nexport interface QueryWorkoutsResult {\n  workouts: Workout[];\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` and `totalCalories`, bpm for `heartRate`, kilogram for `weight`, meter for `height`).\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}\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.\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.\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 on 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"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asiriindatissa/capacitor-health",
-  "version": "8.4.0",
+  "version": "8.4.2",
   "description": "Capacitor plugin to interact with data from Health Connect on Android",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",