@asiriindatissa/capacitor-health 8.4.1 → 8.4.2

package/README.md

@@ -136,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: [],
 });
 
@@ -147,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
 

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

@@ -400,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
         }
 
@@ -413,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asiriindatissa/capacitor-health",
-  "version": "8.4.1",
+  "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",