@capgo/capacitor-health 8.1.4 → 8.2.0

package/README.md

@@ -163,6 +163,7 @@ All write operations expect the default unit shown above. On Android the `metada
 * [`getPluginVersion()`](#getpluginversion)
 * [`openHealthConnectSettings()`](#openhealthconnectsettings)
 * [`showPrivacyPolicy()`](#showprivacypolicy)
+* [`queryWorkouts(...)`](#queryworkouts)
 * [Interfaces](#interfaces)
 * [Type Aliases](#type-aliases)
 
@@ -297,6 +298,24 @@ or by placing an HTML file at www/privacypolicy.html in your assets.
 --------------------
 
 
+### queryWorkouts(...)
+
+```typescript
+queryWorkouts(options: QueryWorkoutsOptions) => Promise<QueryWorkoutsResult>
+```
+
+Queries workout sessions from the native health store.
+Supported on iOS (HealthKit) and Android (Health Connect).
+
+| Param         | Type                                                                  | Description                                                                             |
+| ------------- | --------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
+| **`options`** | <code><a href="#queryworkoutsoptions">QueryWorkoutsOptions</a></code> | Query options including optional workout type filter, date range, limit, and sort order |
+
+**Returns:** <code>Promise&lt;<a href="#queryworkoutsresult">QueryWorkoutsResult</a>&gt;</code>
+
+--------------------
+
+
 ### Interfaces
 
 
@@ -370,6 +389,39 @@ or by placing an HTML file at www/privacypolicy.html in your assets.
 | **`metadata`**  | <code><a href="#record">Record</a>&lt;string, string&gt;</code> | Metadata key-value pairs forwarded to the native APIs where supported.                                                                                                                            |
 
 
+#### QueryWorkoutsResult
+
+| Prop           | Type                   |
+| -------------- | ---------------------- |
+| **`workouts`** | <code>Workout[]</code> |
+
+
+#### Workout
+
+| Prop                    | Type                                                            | Description                                         |
+| ----------------------- | --------------------------------------------------------------- | --------------------------------------------------- |
+| **`workoutType`**       | <code><a href="#workouttype">WorkoutType</a></code>             | The type of workout.                                |
+| **`duration`**          | <code>number</code>                                             | Duration of the workout in seconds.                 |
+| **`totalEnergyBurned`** | <code>number</code>                                             | Total energy burned in kilocalories (if available). |
+| **`totalDistance`**     | <code>number</code>                                             | Total distance in meters (if available).            |
+| **`startDate`**         | <code>string</code>                                             | ISO 8601 start date of the workout.                 |
+| **`endDate`**           | <code>string</code>                                             | ISO 8601 end date of the workout.                   |
+| **`sourceName`**        | <code>string</code>                                             | Source name that recorded the workout.              |
+| **`sourceId`**          | <code>string</code>                                             | Source bundle identifier.                           |
+| **`metadata`**          | <code><a href="#record">Record</a>&lt;string, string&gt;</code> | Additional metadata (if available).                 |
+
+
+#### QueryWorkoutsOptions
+
+| Prop              | Type                                                | Description                                                               |
+| ----------------- | --------------------------------------------------- | ------------------------------------------------------------------------- |
+| **`workoutType`** | <code><a href="#workouttype">WorkoutType</a></code> | Optional workout type filter. If omitted, all workout types are returned. |
+| **`startDate`**   | <code>string</code>                                 | Inclusive ISO 8601 start date (defaults to now - 1 day).                  |
+| **`endDate`**     | <code>string</code>                                 | Exclusive ISO 8601 end date (defaults to now).                            |
+| **`limit`**       | <code>number</code>                                 | Maximum number of workouts to return (defaults to 100).                   |
+| **`ascending`**   | <code>boolean</code>                                | Return results sorted ascending by start date (defaults to false).        |
+
+
 ### Type Aliases
 
 
@@ -389,6 +441,11 @@ Construct a type with a set of properties K of type T
 
 <code>{
 [P in K]: T;
 }</code>
 
+
+#### WorkoutType
+
+<code>'running' | 'cycling' | 'walking' | 'swimming' | 'yoga' | 'strengthTraining' | 'hiking' | 'tennis' | 'basketball' | 'soccer' | 'americanFootball' | 'baseball' | 'crossTraining' | 'elliptical' | 'rowing' | 'stairClimbing' | 'traditionalStrengthTraining' | 'waterFitness' | 'waterPolo' | 'waterSports' | 'wrestling' | 'other'</code>
+
 </docgen-api>
 
 ### Credits:

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

@@ -1,8 +1,11 @@
 package app.capgo.plugin.health
 
 import androidx.health.connect.client.HealthConnectClient
+import androidx.health.connect.client.permission.HealthPermission
+import androidx.health.connect.client.request.AggregateRequest
 import androidx.health.connect.client.records.ActiveCaloriesBurnedRecord
 import androidx.health.connect.client.records.DistanceRecord
+import androidx.health.connect.client.records.ExerciseSessionRecord
 import androidx.health.connect.client.records.HeartRateRecord
 import androidx.health.connect.client.records.Record
 import androidx.health.connect.client.records.StepsRecord
@@ -13,6 +16,7 @@ import androidx.health.connect.client.units.Energy
 import androidx.health.connect.client.units.Length
 import androidx.health.connect.client.units.Mass
 import androidx.health.connect.client.records.metadata.Metadata
+import java.time.Duration
 import com.getcapacitor.JSArray
 import com.getcapacitor.JSObject
 import java.time.Instant
@@ -26,15 +30,20 @@ class HealthManager {
 
     private val formatter: DateTimeFormatter = DateTimeFormatter.ISO_INSTANT
 
-    fun permissionsFor(readTypes: Collection<HealthDataType>, writeTypes: Collection<HealthDataType>): Set<String> = buildSet {
+    fun permissionsFor(readTypes: Collection<HealthDataType>, writeTypes: Collection<HealthDataType>, includeWorkouts: Boolean = false): Set<String> = buildSet {
         readTypes.forEach { add(it.readPermission) }
         writeTypes.forEach { add(it.writePermission) }
+        // Include workout read permission if explicitly requested
+        if (includeWorkouts) {
+            add(HealthPermission.getReadPermission(ExerciseSessionRecord::class))
+        }
     }
 
     suspend fun authorizationStatus(
         client: HealthConnectClient,
         readTypes: Collection<HealthDataType>,
-        writeTypes: Collection<HealthDataType>
+        writeTypes: Collection<HealthDataType>,
+        includeWorkouts: Boolean = false
     ): JSObject {
         val granted = client.permissionController.getGrantedPermissions()
 
@@ -48,6 +57,16 @@ class HealthManager {
             }
         }
 
+        // Check workout permission if requested
+        if (includeWorkouts) {
+            val workoutPermission = HealthPermission.getReadPermission(ExerciseSessionRecord::class)
+            if (granted.contains(workoutPermission)) {
+                readAuthorized.put("workouts")
+            } else {
+                readDenied.put("workouts")
+            }
+        }
+
         val writeAuthorized = JSArray()
         val writeDenied = JSArray()
         writeTypes.forEach { type ->
@@ -273,6 +292,127 @@ class HealthManager {
         return java.lang.Math.round(this.coerceAtLeast(0.0))
     }
 
+    suspend fun queryWorkouts(
+        client: HealthConnectClient,
+        workoutType: String?,
+        startTime: Instant,
+        endTime: Instant,
+        limit: Int,
+        ascending: Boolean
+    ): JSArray {
+        val workouts = mutableListOf<Pair<Instant, JSObject>>()
+        
+        var pageToken: String? = null
+        val pageSize = if (limit > 0) min(limit, MAX_PAGE_SIZE) else DEFAULT_PAGE_SIZE
+        var fetched = 0
+        
+        val exerciseTypeFilter = WorkoutType.fromString(workoutType)
+        
+        do {
+            val request = ReadRecordsRequest(
+                recordType = ExerciseSessionRecord::class,
+                timeRangeFilter = TimeRangeFilter.between(startTime, endTime),
+                pageSize = pageSize,
+                pageToken = pageToken
+            )
+            val response = client.readRecords(request)
+            
+            response.records.forEach { record ->
+                val session = record as ExerciseSessionRecord
+                
+                // Filter by exercise type if specified
+                if (exerciseTypeFilter != null && session.exerciseType != exerciseTypeFilter) {
+                    return@forEach
+                }
+                
+                // Aggregate calories and distance for this workout session
+                val aggregatedData = aggregateWorkoutData(client, session)
+                val payload = createWorkoutPayload(session, aggregatedData)
+                workouts.add(session.startTime to payload)
+            }
+            
+            fetched += response.records.size
+            pageToken = response.pageToken
+        } while (pageToken != null && (limit <= 0 || fetched < limit))
+        
+        val sorted = workouts.sortedBy { it.first }
+        val ordered = if (ascending) sorted else sorted.asReversed()
+        val limited = if (limit > 0) ordered.take(limit) else ordered
+        
+        val array = JSArray()
+        limited.forEach { array.put(it.second) }
+        return array
+    }
+    
+    private suspend fun aggregateWorkoutData(
+        client: HealthConnectClient,
+        session: ExerciseSessionRecord
+    ): WorkoutAggregatedData {
+        val timeRange = TimeRangeFilter.between(session.startTime, session.endTime)
+        // Don't filter by dataOrigin - distance might come from different sources
+        // than the workout session itself (e.g., fitness tracker vs workout app)
+        
+        // Aggregate distance
+        val distanceAggregate = try {
+            val aggregateRequest = AggregateRequest(
+                metrics = setOf(DistanceRecord.DISTANCE_TOTAL),
+                timeRangeFilter = timeRange
+                // Removed dataOriginFilter to get distance from all sources during workout time
+            )
+            val result = client.aggregate(aggregateRequest)
+            result[DistanceRecord.DISTANCE_TOTAL]?.inMeters
+        } catch (e: Exception) {
+            android.util.Log.d("HealthManager", "Distance aggregation failed for workout: ${e.message}", e)
+            null // Permission might not be granted or no data available
+        }
+        
+        return WorkoutAggregatedData(
+            totalDistance = distanceAggregate
+        )
+    }
+    
+    private data class WorkoutAggregatedData(
+        val totalDistance: Double?
+    )
+    
+    private fun createWorkoutPayload(session: ExerciseSessionRecord, aggregatedData: WorkoutAggregatedData): JSObject {
+        val payload = JSObject()
+        
+        // Workout type
+        payload.put("workoutType", WorkoutType.toWorkoutTypeString(session.exerciseType))
+        
+        // Duration in seconds
+        val durationSeconds = Duration.between(session.startTime, session.endTime).seconds.toInt()
+        payload.put("duration", durationSeconds)
+        
+        // Start and end dates
+        payload.put("startDate", formatter.format(session.startTime))
+        payload.put("endDate", formatter.format(session.endTime))
+        
+        // Total distance (aggregated from DistanceRecord)
+        aggregatedData.totalDistance?.let { distance ->
+            payload.put("totalDistance", distance)
+        }
+        
+        // Source information
+        val dataOrigin = session.metadata.dataOrigin
+        payload.put("sourceId", dataOrigin.packageName)
+        payload.put("sourceName", dataOrigin.packageName)
+        session.metadata.device?.let { device ->
+            val manufacturer = device.manufacturer?.takeIf { it.isNotBlank() }
+            val model = device.model?.takeIf { it.isNotBlank() }
+            val label = listOfNotNull(manufacturer, model).joinToString(" ").trim()
+            if (label.isNotEmpty()) {
+                payload.put("sourceName", label)
+            }
+        }
+        
+        // Note: customMetadata is not available on Metadata in Health Connect
+        // Metadata only contains dataOrigin, device, and lastModifiedTime
+        
+        return payload
+    }
+
     companion object {
         private const val DEFAULT_PAGE_SIZE = 100
         private const val MAX_PAGE_SIZE = 500

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

@@ -32,6 +32,7 @@ class HealthPlugin : Plugin() {
     // Store pending request data for callback
     private var pendingReadTypes: List<HealthDataType> = emptyList()
     private var pendingWriteTypes: List<HealthDataType> = emptyList()
+    private var pendingIncludeWorkouts: Boolean = false
 
     override fun handleOnDestroy() {
         super.handleOnDestroy()
@@ -46,8 +47,8 @@ class HealthPlugin : Plugin() {
 
     @PluginMethod
     fun requestAuthorization(call: PluginCall) {
-        val readTypes = try {
-            parseTypeList(call, "read")
+        val (readTypes, includeWorkouts) = try {
+            parseTypeListWithWorkouts(call, "read")
         } catch (e: IllegalArgumentException) {
             call.reject(e.message, null, e)
             return
@@ -62,17 +63,17 @@ class HealthPlugin : Plugin() {
 
         pluginScope.launch {
             val client = getClientOrReject(call) ?: return@launch
-            val permissions = manager.permissionsFor(readTypes, writeTypes)
+            val permissions = manager.permissionsFor(readTypes, writeTypes, includeWorkouts)
 
             if (permissions.isEmpty()) {
-                val status = manager.authorizationStatus(client, readTypes, writeTypes)
+                val status = manager.authorizationStatus(client, readTypes, writeTypes, includeWorkouts)
                 call.resolve(status)
                 return@launch
             }
 
             val granted = client.permissionController.getGrantedPermissions()
             if (granted.containsAll(permissions)) {
-                val status = manager.authorizationStatus(client, readTypes, writeTypes)
+                val status = manager.authorizationStatus(client, readTypes, writeTypes, includeWorkouts)
                 call.resolve(status)
                 return@launch
             }
@@ -80,6 +81,7 @@ class HealthPlugin : Plugin() {
             // Store types for callback
             pendingReadTypes = readTypes
             pendingWriteTypes = writeTypes
+            pendingIncludeWorkouts = includeWorkouts
 
             // Create intent using the Health Connect permission contract
             val intent = permissionContract.createIntent(context, permissions)
@@ -102,20 +104,22 @@ class HealthPlugin : Plugin() {
 
         val readTypes = pendingReadTypes
         val writeTypes = pendingWriteTypes
+        val includeWorkouts = pendingIncludeWorkouts
         pendingReadTypes = emptyList()
         pendingWriteTypes = emptyList()
+        pendingIncludeWorkouts = false
 
         pluginScope.launch {
             val client = getClientOrReject(call) ?: return@launch
-            val status = manager.authorizationStatus(client, readTypes, writeTypes)
+            val status = manager.authorizationStatus(client, readTypes, writeTypes, includeWorkouts)
             call.resolve(status)
         }
     }
 
     @PluginMethod
     fun checkAuthorization(call: PluginCall) {
-        val readTypes = try {
-            parseTypeList(call, "read")
+        val (readTypes, includeWorkouts) = try {
+            parseTypeListWithWorkouts(call, "read")
         } catch (e: IllegalArgumentException) {
             call.reject(e.message, null, e)
             return
@@ -130,7 +134,7 @@ class HealthPlugin : Plugin() {
 
         pluginScope.launch {
             val client = getClientOrReject(call) ?: return@launch
-            val status = manager.authorizationStatus(client, readTypes, writeTypes)
+            val status = manager.authorizationStatus(client, readTypes, writeTypes, includeWorkouts)
             call.resolve(status)
         }
     }
@@ -265,6 +269,23 @@ class HealthPlugin : Plugin() {
         return result
     }
 
+    private fun parseTypeListWithWorkouts(call: PluginCall, key: String): Pair<List<HealthDataType>, Boolean> {
+        val array = call.getArray(key) ?: JSArray()
+        val result = mutableListOf<HealthDataType>()
+        var includeWorkouts = false
+        for (i in 0 until array.length()) {
+            val identifier = array.optString(i, null) ?: continue
+            if (identifier == "workouts") {
+                includeWorkouts = true
+            } else {
+                val dataType = HealthDataType.from(identifier)
+                    ?: throw IllegalArgumentException("Unsupported data type: $identifier")
+                result.add(dataType)
+            }
+        }
+        return Pair(result, includeWorkouts)
+    }
+
     private fun getClientOrReject(call: PluginCall): HealthConnectClient? {
         val status = HealthConnectClient.getSdkStatus(context)
         if (status != HealthConnectClient.SDK_AVAILABLE) {
@@ -327,6 +348,43 @@ class HealthPlugin : Plugin() {
         }
     }
 
+    @PluginMethod
+    fun queryWorkouts(call: PluginCall) {
+        val workoutType = call.getString("workoutType")
+        val limit = (call.getInt("limit") ?: DEFAULT_LIMIT).coerceAtLeast(0)
+        val ascending = call.getBoolean("ascending") ?: false
+
+        val startInstant = try {
+            manager.parseInstant(call.getString("startDate"), Instant.now().minus(DEFAULT_PAST_DURATION))
+        } catch (e: DateTimeParseException) {
+            call.reject(e.message, null, e)
+            return
+        }
+
+        val endInstant = try {
+            manager.parseInstant(call.getString("endDate"), Instant.now())
+        } catch (e: DateTimeParseException) {
+            call.reject(e.message, null, e)
+            return
+        }
+
+        if (endInstant.isBefore(startInstant)) {
+            call.reject("endDate must be greater than or equal to startDate")
+            return
+        }
+
+        pluginScope.launch {
+            val client = getClientOrReject(call) ?: return@launch
+            try {
+                val workouts = manager.queryWorkouts(client, workoutType, startInstant, endInstant, limit, ascending)
+                val result = JSObject().apply { put("workouts", workouts) }
+                call.resolve(result)
+            } catch (e: Exception) {
+                call.reject(e.message ?: "Failed to query workouts.", null, e)
+            }
+        }
+    }
+
     companion object {
         private const val DEFAULT_LIMIT = 100
         private val DEFAULT_PAST_DURATION: Duration = Duration.ofDays(1)

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

@@ -0,0 +1,64 @@
+package app.capgo.plugin.health
+
+import androidx.health.connect.client.records.ExerciseSessionRecord
+
+object WorkoutType {
+    fun fromString(type: String?): Int? {
+        if (type.isNullOrBlank()) return null
+        
+        return when (type) {
+            "running" -> ExerciseSessionRecord.EXERCISE_TYPE_RUNNING
+            "cycling" -> ExerciseSessionRecord.EXERCISE_TYPE_BIKING
+            "walking" -> ExerciseSessionRecord.EXERCISE_TYPE_WALKING
+            "swimming" -> ExerciseSessionRecord.EXERCISE_TYPE_SWIMMING_POOL
+            "yoga" -> ExerciseSessionRecord.EXERCISE_TYPE_YOGA
+            "strengthTraining" -> ExerciseSessionRecord.EXERCISE_TYPE_STRENGTH_TRAINING
+            "hiking" -> ExerciseSessionRecord.EXERCISE_TYPE_HIKING
+            "tennis" -> ExerciseSessionRecord.EXERCISE_TYPE_TENNIS
+            "basketball" -> ExerciseSessionRecord.EXERCISE_TYPE_BASKETBALL
+            "soccer" -> ExerciseSessionRecord.EXERCISE_TYPE_SOCCER
+            "americanFootball" -> ExerciseSessionRecord.EXERCISE_TYPE_FOOTBALL_AMERICAN
+            "baseball" -> ExerciseSessionRecord.EXERCISE_TYPE_BASEBALL
+            "crossTraining" -> ExerciseSessionRecord.EXERCISE_TYPE_HIGH_INTENSITY_INTERVAL_TRAINING
+            "elliptical" -> ExerciseSessionRecord.EXERCISE_TYPE_ELLIPTICAL
+            "rowing" -> ExerciseSessionRecord.EXERCISE_TYPE_ROWING
+            "stairClimbing" -> ExerciseSessionRecord.EXERCISE_TYPE_STAIR_CLIMBING
+            "traditionalStrengthTraining" -> ExerciseSessionRecord.EXERCISE_TYPE_STRENGTH_TRAINING
+            "waterFitness" -> ExerciseSessionRecord.EXERCISE_TYPE_SWIMMING_POOL
+            "waterPolo" -> ExerciseSessionRecord.EXERCISE_TYPE_WATER_POLO
+            "waterSports" -> ExerciseSessionRecord.EXERCISE_TYPE_SWIMMING_OPEN_WATER
+            "wrestling" -> ExerciseSessionRecord.EXERCISE_TYPE_MARTIAL_ARTS
+            "other" -> ExerciseSessionRecord.EXERCISE_TYPE_OTHER_WORKOUT
+            else -> null
+        }
+    }
+
+    fun toWorkoutTypeString(exerciseType: Int): String {
+        return when (exerciseType) {
+            ExerciseSessionRecord.EXERCISE_TYPE_RUNNING -> "running"
+            ExerciseSessionRecord.EXERCISE_TYPE_BIKING -> "cycling"
+            ExerciseSessionRecord.EXERCISE_TYPE_BIKING_STATIONARY -> "cycling"
+            ExerciseSessionRecord.EXERCISE_TYPE_WALKING -> "walking"
+            ExerciseSessionRecord.EXERCISE_TYPE_SWIMMING_POOL -> "swimming"
+            ExerciseSessionRecord.EXERCISE_TYPE_SWIMMING_OPEN_WATER -> "swimming"
+            ExerciseSessionRecord.EXERCISE_TYPE_YOGA -> "yoga"
+            ExerciseSessionRecord.EXERCISE_TYPE_STRENGTH_TRAINING -> "strengthTraining"
+            ExerciseSessionRecord.EXERCISE_TYPE_HIKING -> "hiking"
+            ExerciseSessionRecord.EXERCISE_TYPE_TENNIS -> "tennis"
+            ExerciseSessionRecord.EXERCISE_TYPE_BASKETBALL -> "basketball"
+            ExerciseSessionRecord.EXERCISE_TYPE_SOCCER -> "soccer"
+            ExerciseSessionRecord.EXERCISE_TYPE_FOOTBALL_AMERICAN -> "americanFootball"
+            ExerciseSessionRecord.EXERCISE_TYPE_BASEBALL -> "baseball"
+            ExerciseSessionRecord.EXERCISE_TYPE_HIGH_INTENSITY_INTERVAL_TRAINING -> "crossTraining"
+            ExerciseSessionRecord.EXERCISE_TYPE_ELLIPTICAL -> "elliptical"
+            ExerciseSessionRecord.EXERCISE_TYPE_ROWING -> "rowing"
+            ExerciseSessionRecord.EXERCISE_TYPE_ROWING_MACHINE -> "rowing"
+            ExerciseSessionRecord.EXERCISE_TYPE_STAIR_CLIMBING -> "stairClimbing"
+            ExerciseSessionRecord.EXERCISE_TYPE_STAIR_CLIMBING_MACHINE -> "stairClimbing"
+            ExerciseSessionRecord.EXERCISE_TYPE_WATER_POLO -> "waterPolo"
+            ExerciseSessionRecord.EXERCISE_TYPE_MARTIAL_ARTS -> "wrestling"
+            ExerciseSessionRecord.EXERCISE_TYPE_OTHER_WORKOUT -> "other"
+            else -> "other"
+        }
+    }
+}

package/dist/docs.json

@@ -140,6 +140,38 @@
         "docs": "Shows the app's privacy policy for Health Connect (Android only).\nOn iOS, this method does nothing.\n\nThis displays the same privacy policy screen that Health Connect shows\nwhen the user taps \"Privacy policy\" in the permissions dialog.\n\nThe privacy policy URL can be configured by adding a string resource\nnamed \"health_connect_privacy_policy_url\" in your app's strings.xml,\nor by placing an HTML file at www/privacypolicy.html in your assets.",
         "complexTypes": [],
         "slug": "showprivacypolicy"
+      },
+      {
+        "name": "queryWorkouts",
+        "signature": "(options: QueryWorkoutsOptions) => Promise<QueryWorkoutsResult>",
+        "parameters": [
+          {
+            "name": "options",
+            "docs": "Query options including optional workout type filter, date range, limit, and sort order",
+            "type": "QueryWorkoutsOptions"
+          }
+        ],
+        "returns": "Promise<QueryWorkoutsResult>",
+        "tags": [
+          {
+            "name": "param",
+            "text": "options Query options including optional workout type filter, date range, limit, and sort order"
+          },
+          {
+            "name": "returns",
+            "text": "A promise that resolves with the workout sessions"
+          },
+          {
+            "name": "throws",
+            "text": "An error if something went wrong"
+          }
+        ],
+        "docs": "Queries workout sessions from the native health store.\nSupported on iOS (HealthKit) and Android (Health Connect).",
+        "complexTypes": [
+          "QueryWorkoutsResult",
+          "QueryWorkoutsOptions"
+        ],
+        "slug": "queryworkouts"
       }
     ],
     "properties": []
@@ -429,6 +461,146 @@
           "type": "Record<string, string>"
         }
       ]
+    },
+    {
+      "name": "QueryWorkoutsResult",
+      "slug": "queryworkoutsresult",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "workouts",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [
+            "Workout"
+          ],
+          "type": "Workout[]"
+        }
+      ]
+    },
+    {
+      "name": "Workout",
+      "slug": "workout",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "workoutType",
+          "tags": [],
+          "docs": "The type of workout.",
+          "complexTypes": [
+            "WorkoutType"
+          ],
+          "type": "WorkoutType"
+        },
+        {
+          "name": "duration",
+          "tags": [],
+          "docs": "Duration of the workout in seconds.",
+          "complexTypes": [],
+          "type": "number"
+        },
+        {
+          "name": "totalEnergyBurned",
+          "tags": [],
+          "docs": "Total energy burned in kilocalories (if available).",
+          "complexTypes": [],
+          "type": "number | undefined"
+        },
+        {
+          "name": "totalDistance",
+          "tags": [],
+          "docs": "Total distance in meters (if available).",
+          "complexTypes": [],
+          "type": "number | undefined"
+        },
+        {
+          "name": "startDate",
+          "tags": [],
+          "docs": "ISO 8601 start date of the workout.",
+          "complexTypes": [],
+          "type": "string"
+        },
+        {
+          "name": "endDate",
+          "tags": [],
+          "docs": "ISO 8601 end date of the workout.",
+          "complexTypes": [],
+          "type": "string"
+        },
+        {
+          "name": "sourceName",
+          "tags": [],
+          "docs": "Source name that recorded the workout.",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "sourceId",
+          "tags": [],
+          "docs": "Source bundle identifier.",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "metadata",
+          "tags": [],
+          "docs": "Additional metadata (if available).",
+          "complexTypes": [
+            "Record"
+          ],
+          "type": "Record<string, string>"
+        }
+      ]
+    },
+    {
+      "name": "QueryWorkoutsOptions",
+      "slug": "queryworkoutsoptions",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "workoutType",
+          "tags": [],
+          "docs": "Optional workout type filter. If omitted, all workout types are returned.",
+          "complexTypes": [
+            "WorkoutType"
+          ],
+          "type": "WorkoutType"
+        },
+        {
+          "name": "startDate",
+          "tags": [],
+          "docs": "Inclusive ISO 8601 start date (defaults to now - 1 day).",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "endDate",
+          "tags": [],
+          "docs": "Exclusive ISO 8601 end date (defaults to now).",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "limit",
+          "tags": [],
+          "docs": "Maximum number of workouts to return (defaults to 100).",
+          "complexTypes": [],
+          "type": "number | undefined"
+        },
+        {
+          "name": "ascending",
+          "tags": [],
+          "docs": "Return results sorted ascending by start date (defaults to false).",
+          "complexTypes": [],
+          "type": "boolean | undefined"
+        }
+      ]
     }
   ],
   "enums": [],
@@ -500,6 +672,101 @@
           ]
         }
       ]
+    },
+    {
+      "name": "WorkoutType",
+      "slug": "workouttype",
+      "docs": "",
+      "types": [
+        {
+          "text": "'running'",
+          "complexTypes": []
+        },
+        {
+          "text": "'cycling'",
+          "complexTypes": []
+        },
+        {
+          "text": "'walking'",
+          "complexTypes": []
+        },
+        {
+          "text": "'swimming'",
+          "complexTypes": []
+        },
+        {
+          "text": "'yoga'",
+          "complexTypes": []
+        },
+        {
+          "text": "'strengthTraining'",
+          "complexTypes": []
+        },
+        {
+          "text": "'hiking'",
+          "complexTypes": []
+        },
+        {
+          "text": "'tennis'",
+          "complexTypes": []
+        },
+        {
+          "text": "'basketball'",
+          "complexTypes": []
+        },
+        {
+          "text": "'soccer'",
+          "complexTypes": []
+        },
+        {
+          "text": "'americanFootball'",
+          "complexTypes": []
+        },
+        {
+          "text": "'baseball'",
+          "complexTypes": []
+        },
+        {
+          "text": "'crossTraining'",
+          "complexTypes": []
+        },
+        {
+          "text": "'elliptical'",
+          "complexTypes": []
+        },
+        {
+          "text": "'rowing'",
+          "complexTypes": []
+        },
+        {
+          "text": "'stairClimbing'",
+          "complexTypes": []
+        },
+        {
+          "text": "'traditionalStrengthTraining'",
+          "complexTypes": []
+        },
+        {
+          "text": "'waterFitness'",
+          "complexTypes": []
+        },
+        {
+          "text": "'waterPolo'",
+          "complexTypes": []
+        },
+        {
+          "text": "'waterSports'",
+          "complexTypes": []
+        },
+        {
+          "text": "'wrestling'",
+          "complexTypes": []
+        },
+        {
+          "text": "'other'",
+          "complexTypes": []
+        }
+      ]
     }
   ],
   "pluginConfigs": []

package/dist/esm/definitions.d.ts

@@ -42,6 +42,42 @@ export interface HealthSample {
 export interface ReadSamplesResult {
     samples: HealthSample[];
 }
+export type WorkoutType = 'running' | 'cycling' | 'walking' | 'swimming' | 'yoga' | 'strengthTraining' | 'hiking' | 'tennis' | 'basketball' | 'soccer' | 'americanFootball' | 'baseball' | 'crossTraining' | 'elliptical' | 'rowing' | 'stairClimbing' | 'traditionalStrengthTraining' | 'waterFitness' | 'waterPolo' | 'waterSports' | 'wrestling' | 'other';
+export interface QueryWorkoutsOptions {
+    /** Optional workout type filter. If omitted, all workout types are returned. */
+    workoutType?: WorkoutType;
+    /** Inclusive ISO 8601 start date (defaults to now - 1 day). */
+    startDate?: string;
+    /** Exclusive ISO 8601 end date (defaults to now). */
+    endDate?: string;
+    /** Maximum number of workouts to return (defaults to 100). */
+    limit?: number;
+    /** Return results sorted ascending by start date (defaults to false). */
+    ascending?: boolean;
+}
+export interface Workout {
+    /** The type of workout. */
+    workoutType: WorkoutType;
+    /** Duration of the workout in seconds. */
+    duration: number;
+    /** Total energy burned in kilocalories (if available). */
+    totalEnergyBurned?: number;
+    /** Total distance in meters (if available). */
+    totalDistance?: number;
+    /** ISO 8601 start date of the workout. */
+    startDate: string;
+    /** ISO 8601 end date of the workout. */
+    endDate: string;
+    /** Source name that recorded the workout. */
+    sourceName?: string;
+    /** Source bundle identifier. */
+    sourceId?: string;
+    /** Additional metadata (if available). */
+    metadata?: Record<string, string>;
+}
+export interface QueryWorkoutsResult {
+    workouts: Workout[];
+}
 export interface WriteSampleOptions {
     dataType: HealthDataType;
     value: number;
@@ -101,4 +137,13 @@ export interface HealthPlugin {
      * @throws An error if the privacy policy cannot be displayed
      */
     showPrivacyPolicy(): Promise<void>;
+    /**
+     * Queries workout sessions from the native health store.
+     * Supported on iOS (HealthKit) and Android (Health Connect).
+     *
+     * @param options Query options including optional workout type filter, date range, limit, and sort order
+     * @returns A promise that resolves with the workout sessions
+     * @throws An error if something went wrong
+     */
+    queryWorkouts(options: QueryWorkoutsOptions): Promise<QueryWorkoutsResult>;
 }

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';\n\nexport type HealthUnit = 'count' | 'meter' | 'kilocalorie' | 'bpm' | 'kilogram';\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 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 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}\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"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["export type HealthDataType = 'steps' | 'distance' | 'calories' | 'heartRate' | 'weight';\n\nexport type HealthUnit = 'count' | 'meter' | 'kilocalorie' | 'bpm' | 'kilogram';\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 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`).\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 (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"]}

package/dist/esm/web.d.ts

@@ -1,5 +1,5 @@
 import { WebPlugin } from '@capacitor/core';
-import type { AuthorizationOptions, AuthorizationStatus, AvailabilityResult, HealthPlugin, QueryOptions, ReadSamplesResult, WriteSampleOptions } from './definitions';
+import type { AuthorizationOptions, AuthorizationStatus, AvailabilityResult, HealthPlugin, QueryOptions, QueryWorkoutsOptions, QueryWorkoutsResult, ReadSamplesResult, WriteSampleOptions } from './definitions';
 export declare class HealthWeb extends WebPlugin implements HealthPlugin {
     isAvailable(): Promise<AvailabilityResult>;
     requestAuthorization(_options: AuthorizationOptions): Promise<AuthorizationStatus>;
@@ -11,4 +11,5 @@ export declare class HealthWeb extends WebPlugin implements HealthPlugin {
     }>;
     openHealthConnectSettings(): Promise<void>;
     showPrivacyPolicy(): Promise<void>;
+    queryWorkouts(_options: QueryWorkoutsOptions): Promise<QueryWorkoutsResult>;
 }

package/dist/esm/web.js

@@ -28,5 +28,8 @@ export class HealthWeb extends WebPlugin {
     async showPrivacyPolicy() {
         // No-op on web - Health Connect privacy policy is Android only
     }
+    async queryWorkouts(_options) {
+        throw this.unimplemented('Querying workouts is only available on native platforms.');
+    }
 }
 //# sourceMappingURL=web.js.map

package/dist/esm/web.js.map

@@ -1 +1 @@
-{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAY5C,MAAM,OAAO,SAAU,SAAQ,SAAS;IACtC,KAAK,CAAC,WAAW;QACf,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,iEAAiE;SAC1E,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,QAA8B;QACvD,MAAM,IAAI,CAAC,aAAa,CAAC,4DAA4D,CAAC,CAAC;IACzF,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,QAA8B;QACrD,MAAM,IAAI,CAAC,aAAa,CAAC,4DAA4D,CAAC,CAAC;IACzF,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,QAAsB;QACtC,MAAM,IAAI,CAAC,aAAa,CAAC,4DAA4D,CAAC,CAAC;IACzF,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,QAA4B;QAC3C,MAAM,IAAI,CAAC,aAAa,CAAC,4DAA4D,CAAC,CAAC;IACzF,CAAC;IAED,KAAK,CAAC,gBAAgB;QACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,yBAAyB;QAC7B,gDAAgD;IAClD,CAAC;IAED,KAAK,CAAC,iBAAiB;QACrB,+DAA+D;IACjE,CAAC;CACF","sourcesContent":["import { WebPlugin } from '@capacitor/core';\n\nimport type {\n  AuthorizationOptions,\n  AuthorizationStatus,\n  AvailabilityResult,\n  HealthPlugin,\n  QueryOptions,\n  ReadSamplesResult,\n  WriteSampleOptions,\n} from './definitions';\n\nexport class HealthWeb extends WebPlugin implements HealthPlugin {\n  async isAvailable(): Promise<AvailabilityResult> {\n    return {\n      available: false,\n      platform: 'web',\n      reason: 'Native health APIs are not accessible in a browser environment.',\n    };\n  }\n\n  async requestAuthorization(_options: AuthorizationOptions): Promise<AuthorizationStatus> {\n    throw this.unimplemented('Health permissions are only available on native platforms.');\n  }\n\n  async checkAuthorization(_options: AuthorizationOptions): Promise<AuthorizationStatus> {\n    throw this.unimplemented('Health permissions are only available on native platforms.');\n  }\n\n  async readSamples(_options: QueryOptions): Promise<ReadSamplesResult> {\n    throw this.unimplemented('Reading health data is only available on native platforms.');\n  }\n\n  async saveSample(_options: WriteSampleOptions): Promise<void> {\n    throw this.unimplemented('Writing health data is only available on native platforms.');\n  }\n\n  async getPluginVersion(): Promise<{ version: string }> {\n    return { version: 'web' };\n  }\n\n  async openHealthConnectSettings(): Promise<void> {\n    // No-op on web - Health Connect is Android only\n  }\n\n  async showPrivacyPolicy(): Promise<void> {\n    // No-op on web - Health Connect privacy policy is Android only\n  }\n}\n"]}
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAc5C,MAAM,OAAO,SAAU,SAAQ,SAAS;IACtC,KAAK,CAAC,WAAW;QACf,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,iEAAiE;SAC1E,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,QAA8B;QACvD,MAAM,IAAI,CAAC,aAAa,CAAC,4DAA4D,CAAC,CAAC;IACzF,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,QAA8B;QACrD,MAAM,IAAI,CAAC,aAAa,CAAC,4DAA4D,CAAC,CAAC;IACzF,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,QAAsB;QACtC,MAAM,IAAI,CAAC,aAAa,CAAC,4DAA4D,CAAC,CAAC;IACzF,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,QAA4B;QAC3C,MAAM,IAAI,CAAC,aAAa,CAAC,4DAA4D,CAAC,CAAC;IACzF,CAAC;IAED,KAAK,CAAC,gBAAgB;QACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,yBAAyB;QAC7B,gDAAgD;IAClD,CAAC;IAED,KAAK,CAAC,iBAAiB;QACrB,+DAA+D;IACjE,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,QAA8B;QAChD,MAAM,IAAI,CAAC,aAAa,CAAC,0DAA0D,CAAC,CAAC;IACvF,CAAC;CACF","sourcesContent":["import { WebPlugin } from '@capacitor/core';\n\nimport type {\n  AuthorizationOptions,\n  AuthorizationStatus,\n  AvailabilityResult,\n  HealthPlugin,\n  QueryOptions,\n  QueryWorkoutsOptions,\n  QueryWorkoutsResult,\n  ReadSamplesResult,\n  WriteSampleOptions,\n} from './definitions';\n\nexport class HealthWeb extends WebPlugin implements HealthPlugin {\n  async isAvailable(): Promise<AvailabilityResult> {\n    return {\n      available: false,\n      platform: 'web',\n      reason: 'Native health APIs are not accessible in a browser environment.',\n    };\n  }\n\n  async requestAuthorization(_options: AuthorizationOptions): Promise<AuthorizationStatus> {\n    throw this.unimplemented('Health permissions are only available on native platforms.');\n  }\n\n  async checkAuthorization(_options: AuthorizationOptions): Promise<AuthorizationStatus> {\n    throw this.unimplemented('Health permissions are only available on native platforms.');\n  }\n\n  async readSamples(_options: QueryOptions): Promise<ReadSamplesResult> {\n    throw this.unimplemented('Reading health data is only available on native platforms.');\n  }\n\n  async saveSample(_options: WriteSampleOptions): Promise<void> {\n    throw this.unimplemented('Writing health data is only available on native platforms.');\n  }\n\n  async getPluginVersion(): Promise<{ version: string }> {\n    return { version: 'web' };\n  }\n\n  async openHealthConnectSettings(): Promise<void> {\n    // No-op on web - Health Connect is Android only\n  }\n\n  async showPrivacyPolicy(): Promise<void> {\n    // No-op on web - Health Connect privacy policy is Android only\n  }\n\n  async queryWorkouts(_options: QueryWorkoutsOptions): Promise<QueryWorkoutsResult> {\n    throw this.unimplemented('Querying workouts is only available on native platforms.');\n  }\n}\n"]}

package/dist/plugin.cjs.js

@@ -35,6 +35,9 @@ class HealthWeb extends core.WebPlugin {
     async showPrivacyPolicy() {
         // No-op on web - Health Connect privacy policy is Android only
     }
+    async queryWorkouts(_options) {
+        throw this.unimplemented('Querying workouts is only available on native platforms.');
+    }
 }
 
 var web = /*#__PURE__*/Object.freeze({

package/dist/plugin.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst Health = registerPlugin('Health', {\n    web: () => import('./web').then((m) => new m.HealthWeb()),\n});\nexport * from './definitions';\nexport { Health };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class HealthWeb extends WebPlugin {\n    async isAvailable() {\n        return {\n            available: false,\n            platform: 'web',\n            reason: 'Native health APIs are not accessible in a browser environment.',\n        };\n    }\n    async requestAuthorization(_options) {\n        throw this.unimplemented('Health permissions are only available on native platforms.');\n    }\n    async checkAuthorization(_options) {\n        throw this.unimplemented('Health permissions are only available on native platforms.');\n    }\n    async readSamples(_options) {\n        throw this.unimplemented('Reading health data is only available on native platforms.');\n    }\n    async saveSample(_options) {\n        throw this.unimplemented('Writing health data is only available on native platforms.');\n    }\n    async getPluginVersion() {\n        return { version: 'web' };\n    }\n    async openHealthConnectSettings() {\n        // No-op on web - Health Connect is Android only\n    }\n    async showPrivacyPolicy() {\n        // No-op on web - Health Connect privacy policy is Android only\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;AACK,MAAC,MAAM,GAAGA,mBAAc,CAAC,QAAQ,EAAE;AACxC,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;AAC7D,CAAC;;ACFM,MAAM,SAAS,SAASC,cAAS,CAAC;AACzC,IAAI,MAAM,WAAW,GAAG;AACxB,QAAQ,OAAO;AACf,YAAY,SAAS,EAAE,KAAK;AAC5B,YAAY,QAAQ,EAAE,KAAK;AAC3B,YAAY,MAAM,EAAE,iEAAiE;AACrF,SAAS;AACT,IAAI;AACJ,IAAI,MAAM,oBAAoB,CAAC,QAAQ,EAAE;AACzC,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,4DAA4D,CAAC;AAC9F,IAAI;AACJ,IAAI,MAAM,kBAAkB,CAAC,QAAQ,EAAE;AACvC,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,4DAA4D,CAAC;AAC9F,IAAI;AACJ,IAAI,MAAM,WAAW,CAAC,QAAQ,EAAE;AAChC,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,4DAA4D,CAAC;AAC9F,IAAI;AACJ,IAAI,MAAM,UAAU,CAAC,QAAQ,EAAE;AAC/B,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,4DAA4D,CAAC;AAC9F,IAAI;AACJ,IAAI,MAAM,gBAAgB,GAAG;AAC7B,QAAQ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE;AACjC,IAAI;AACJ,IAAI,MAAM,yBAAyB,GAAG;AACtC;AACA,IAAI;AACJ,IAAI,MAAM,iBAAiB,GAAG;AAC9B;AACA,IAAI;AACJ;;;;;;;;;"}
+{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst Health = registerPlugin('Health', {\n    web: () => import('./web').then((m) => new m.HealthWeb()),\n});\nexport * from './definitions';\nexport { Health };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class HealthWeb extends WebPlugin {\n    async isAvailable() {\n        return {\n            available: false,\n            platform: 'web',\n            reason: 'Native health APIs are not accessible in a browser environment.',\n        };\n    }\n    async requestAuthorization(_options) {\n        throw this.unimplemented('Health permissions are only available on native platforms.');\n    }\n    async checkAuthorization(_options) {\n        throw this.unimplemented('Health permissions are only available on native platforms.');\n    }\n    async readSamples(_options) {\n        throw this.unimplemented('Reading health data is only available on native platforms.');\n    }\n    async saveSample(_options) {\n        throw this.unimplemented('Writing health data is only available on native platforms.');\n    }\n    async getPluginVersion() {\n        return { version: 'web' };\n    }\n    async openHealthConnectSettings() {\n        // No-op on web - Health Connect is Android only\n    }\n    async showPrivacyPolicy() {\n        // No-op on web - Health Connect privacy policy is Android only\n    }\n    async queryWorkouts(_options) {\n        throw this.unimplemented('Querying workouts is only available on native platforms.');\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;AACK,MAAC,MAAM,GAAGA,mBAAc,CAAC,QAAQ,EAAE;AACxC,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;AAC7D,CAAC;;ACFM,MAAM,SAAS,SAASC,cAAS,CAAC;AACzC,IAAI,MAAM,WAAW,GAAG;AACxB,QAAQ,OAAO;AACf,YAAY,SAAS,EAAE,KAAK;AAC5B,YAAY,QAAQ,EAAE,KAAK;AAC3B,YAAY,MAAM,EAAE,iEAAiE;AACrF,SAAS;AACT,IAAI;AACJ,IAAI,MAAM,oBAAoB,CAAC,QAAQ,EAAE;AACzC,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,4DAA4D,CAAC;AAC9F,IAAI;AACJ,IAAI,MAAM,kBAAkB,CAAC,QAAQ,EAAE;AACvC,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,4DAA4D,CAAC;AAC9F,IAAI;AACJ,IAAI,MAAM,WAAW,CAAC,QAAQ,EAAE;AAChC,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,4DAA4D,CAAC;AAC9F,IAAI;AACJ,IAAI,MAAM,UAAU,CAAC,QAAQ,EAAE;AAC/B,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,4DAA4D,CAAC;AAC9F,IAAI;AACJ,IAAI,MAAM,gBAAgB,GAAG;AAC7B,QAAQ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE;AACjC,IAAI;AACJ,IAAI,MAAM,yBAAyB,GAAG;AACtC;AACA,IAAI;AACJ,IAAI,MAAM,iBAAiB,GAAG;AAC9B;AACA,IAAI;AACJ,IAAI,MAAM,aAAa,CAAC,QAAQ,EAAE;AAClC,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,0DAA0D,CAAC;AAC5F,IAAI;AACJ;;;;;;;;;"}

package/dist/plugin.js

@@ -34,6 +34,9 @@ var capacitorHealth = (function (exports, core) {
         async showPrivacyPolicy() {
             // No-op on web - Health Connect privacy policy is Android only
         }
+        async queryWorkouts(_options) {
+            throw this.unimplemented('Querying workouts is only available on native platforms.');
+        }
     }
 
     var web = /*#__PURE__*/Object.freeze({

package/dist/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst Health = registerPlugin('Health', {\n    web: () => import('./web').then((m) => new m.HealthWeb()),\n});\nexport * from './definitions';\nexport { Health };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class HealthWeb extends WebPlugin {\n    async isAvailable() {\n        return {\n            available: false,\n            platform: 'web',\n            reason: 'Native health APIs are not accessible in a browser environment.',\n        };\n    }\n    async requestAuthorization(_options) {\n        throw this.unimplemented('Health permissions are only available on native platforms.');\n    }\n    async checkAuthorization(_options) {\n        throw this.unimplemented('Health permissions are only available on native platforms.');\n    }\n    async readSamples(_options) {\n        throw this.unimplemented('Reading health data is only available on native platforms.');\n    }\n    async saveSample(_options) {\n        throw this.unimplemented('Writing health data is only available on native platforms.');\n    }\n    async getPluginVersion() {\n        return { version: 'web' };\n    }\n    async openHealthConnectSettings() {\n        // No-op on web - Health Connect is Android only\n    }\n    async showPrivacyPolicy() {\n        // No-op on web - Health Connect privacy policy is Android only\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;AACK,UAAC,MAAM,GAAGA,mBAAc,CAAC,QAAQ,EAAE;IACxC,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;IAC7D,CAAC;;ICFM,MAAM,SAAS,SAASC,cAAS,CAAC;IACzC,IAAI,MAAM,WAAW,GAAG;IACxB,QAAQ,OAAO;IACf,YAAY,SAAS,EAAE,KAAK;IAC5B,YAAY,QAAQ,EAAE,KAAK;IAC3B,YAAY,MAAM,EAAE,iEAAiE;IACrF,SAAS;IACT,IAAI;IACJ,IAAI,MAAM,oBAAoB,CAAC,QAAQ,EAAE;IACzC,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,4DAA4D,CAAC;IAC9F,IAAI;IACJ,IAAI,MAAM,kBAAkB,CAAC,QAAQ,EAAE;IACvC,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,4DAA4D,CAAC;IAC9F,IAAI;IACJ,IAAI,MAAM,WAAW,CAAC,QAAQ,EAAE;IAChC,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,4DAA4D,CAAC;IAC9F,IAAI;IACJ,IAAI,MAAM,UAAU,CAAC,QAAQ,EAAE;IAC/B,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,4DAA4D,CAAC;IAC9F,IAAI;IACJ,IAAI,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE;IACjC,IAAI;IACJ,IAAI,MAAM,yBAAyB,GAAG;IACtC;IACA,IAAI;IACJ,IAAI,MAAM,iBAAiB,GAAG;IAC9B;IACA,IAAI;IACJ;;;;;;;;;;;;;;;"}
+{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst Health = registerPlugin('Health', {\n    web: () => import('./web').then((m) => new m.HealthWeb()),\n});\nexport * from './definitions';\nexport { Health };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class HealthWeb extends WebPlugin {\n    async isAvailable() {\n        return {\n            available: false,\n            platform: 'web',\n            reason: 'Native health APIs are not accessible in a browser environment.',\n        };\n    }\n    async requestAuthorization(_options) {\n        throw this.unimplemented('Health permissions are only available on native platforms.');\n    }\n    async checkAuthorization(_options) {\n        throw this.unimplemented('Health permissions are only available on native platforms.');\n    }\n    async readSamples(_options) {\n        throw this.unimplemented('Reading health data is only available on native platforms.');\n    }\n    async saveSample(_options) {\n        throw this.unimplemented('Writing health data is only available on native platforms.');\n    }\n    async getPluginVersion() {\n        return { version: 'web' };\n    }\n    async openHealthConnectSettings() {\n        // No-op on web - Health Connect is Android only\n    }\n    async showPrivacyPolicy() {\n        // No-op on web - Health Connect privacy policy is Android only\n    }\n    async queryWorkouts(_options) {\n        throw this.unimplemented('Querying workouts is only available on native platforms.');\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;AACK,UAAC,MAAM,GAAGA,mBAAc,CAAC,QAAQ,EAAE;IACxC,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;IAC7D,CAAC;;ICFM,MAAM,SAAS,SAASC,cAAS,CAAC;IACzC,IAAI,MAAM,WAAW,GAAG;IACxB,QAAQ,OAAO;IACf,YAAY,SAAS,EAAE,KAAK;IAC5B,YAAY,QAAQ,EAAE,KAAK;IAC3B,YAAY,MAAM,EAAE,iEAAiE;IACrF,SAAS;IACT,IAAI;IACJ,IAAI,MAAM,oBAAoB,CAAC,QAAQ,EAAE;IACzC,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,4DAA4D,CAAC;IAC9F,IAAI;IACJ,IAAI,MAAM,kBAAkB,CAAC,QAAQ,EAAE;IACvC,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,4DAA4D,CAAC;IAC9F,IAAI;IACJ,IAAI,MAAM,WAAW,CAAC,QAAQ,EAAE;IAChC,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,4DAA4D,CAAC;IAC9F,IAAI;IACJ,IAAI,MAAM,UAAU,CAAC,QAAQ,EAAE;IAC/B,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,4DAA4D,CAAC;IAC9F,IAAI;IACJ,IAAI,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE;IACjC,IAAI;IACJ,IAAI,MAAM,yBAAyB,GAAG;IACtC;IACA,IAAI;IACJ,IAAI,MAAM,iBAAiB,GAAG;IAC9B;IACA,IAAI;IACJ,IAAI,MAAM,aAAa,CAAC,QAAQ,EAAE;IAClC,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,0DAA0D,CAAC;IAC5F,IAAI;IACJ;;;;;;;;;;;;;;;"}

package/ios/Sources/HealthPlugin/Health.swift

@@ -27,6 +27,128 @@ enum HealthManagerError: LocalizedError {
     }
 }
 
+enum WorkoutType: String, CaseIterable {
+    case running
+    case cycling
+    case walking
+    case swimming
+    case yoga
+    case strengthTraining
+    case hiking
+    case tennis
+    case basketball
+    case soccer
+    case americanFootball
+    case baseball
+    case crossTraining
+    case elliptical
+    case rowing
+    case stairClimbing
+    case traditionalStrengthTraining
+    case waterFitness
+    case waterPolo
+    case waterSports
+    case wrestling
+    case other
+
+    func hkWorkoutActivityType() -> HKWorkoutActivityType {
+        switch self {
+        case .running:
+            return .running
+        case .cycling:
+            return .cycling
+        case .walking:
+            return .walking
+        case .swimming:
+            return .swimming
+        case .yoga:
+            return .yoga
+        case .strengthTraining:
+            return .traditionalStrengthTraining
+        case .hiking:
+            return .hiking
+        case .tennis:
+            return .tennis
+        case .basketball:
+            return .basketball
+        case .soccer:
+            return .soccer
+        case .americanFootball:
+            return .americanFootball
+        case .baseball:
+            return .baseball
+        case .crossTraining:
+            return .crossTraining
+        case .elliptical:
+            return .elliptical
+        case .rowing:
+            return .rowing
+        case .stairClimbing:
+            return .stairClimbing
+        case .traditionalStrengthTraining:
+            return .traditionalStrengthTraining
+        case .waterFitness:
+            return .waterFitness
+        case .waterPolo:
+            return .waterPolo
+        case .waterSports:
+            return .waterSports
+        case .wrestling:
+            return .wrestling
+        case .other:
+            return .other
+        }
+    }
+
+    static func fromHKWorkoutActivityType(_ hkType: HKWorkoutActivityType) -> WorkoutType {
+        switch hkType {
+        case .running:
+            return .running
+        case .cycling:
+            return .cycling
+        case .walking:
+            return .walking
+        case .swimming:
+            return .swimming
+        case .yoga:
+            return .yoga
+        case .traditionalStrengthTraining:
+            // Map back to strengthTraining for consistency (both map to the same HK type)
+            return .strengthTraining
+        case .hiking:
+            return .hiking
+        case .tennis:
+            return .tennis
+        case .basketball:
+            return .basketball
+        case .soccer:
+            return .soccer
+        case .americanFootball:
+            return .americanFootball
+        case .baseball:
+            return .baseball
+        case .crossTraining:
+            return .crossTraining
+        case .elliptical:
+            return .elliptical
+        case .rowing:
+            return .rowing
+        case .stairClimbing:
+            return .stairClimbing
+        case .waterFitness:
+            return .waterFitness
+        case .waterPolo:
+            return .waterPolo
+        case .waterSports:
+            return .waterSports
+        case .wrestling:
+            return .wrestling
+        default:
+            return .other
+        }
+    }
+}
+
 enum HealthDataType: String, CaseIterable {
     case steps
     case distance
@@ -402,6 +524,8 @@ final class Health {
             let type = try dataType.sampleType()
             set.insert(type)
         }
+        // Always include workout type for read access to enable workout queries
+        set.insert(HKObjectType.workoutType())
         return set
     }
 
@@ -413,4 +537,92 @@ final class Health {
         }
         return set
     }
+
+    func queryWorkouts(workoutTypeString: String?, startDateString: String?, endDateString: String?, limit: Int?, ascending: Bool, completion: @escaping (Result<[[String: Any]], Error>) -> Void) {
+        let startDate = (try? parseDate(startDateString, defaultValue: Date().addingTimeInterval(-86400))) ?? Date().addingTimeInterval(-86400)
+        let endDate = (try? parseDate(endDateString, defaultValue: Date())) ?? Date()
+
+        guard endDate >= startDate else {
+            completion(.failure(HealthManagerError.invalidDateRange))
+            return
+        }
+
+        var predicate = HKQuery.predicateForSamples(withStart: startDate, end: endDate, options: [])
+
+        // Filter by workout type if specified
+        if let workoutTypeString = workoutTypeString, let workoutType = WorkoutType(rawValue: workoutTypeString) {
+            let hkWorkoutType = workoutType.hkWorkoutActivityType()
+            let typePredicate = HKQuery.predicateForWorkouts(with: hkWorkoutType)
+            predicate = NSCompoundPredicate(andPredicateWithSubpredicates: [predicate, typePredicate])
+        }
+
+        let sortDescriptor = NSSortDescriptor(key: HKSampleSortIdentifierStartDate, ascending: ascending)
+        let queryLimit = limit ?? 100
+
+        guard let workoutSampleType = HKObjectType.workoutType() as? HKSampleType else {
+            completion(.failure(HealthManagerError.operationFailed("Workout type is not available.")))
+            return
+        }
+
+        let query = HKSampleQuery(sampleType: workoutSampleType, predicate: predicate, limit: queryLimit, sortDescriptors: [sortDescriptor]) { [weak self] _, samples, error in
+            guard let self = self else { return }
+
+            if let error = error {
+                completion(.failure(error))
+                return
+            }
+
+            guard let workouts = samples as? [HKWorkout] else {
+                completion(.success([]))
+                return
+            }
+
+            let results = workouts.map { workout -> [String: Any] in
+                var payload: [String: Any] = [
+                    "workoutType": WorkoutType.fromHKWorkoutActivityType(workout.workoutActivityType).rawValue,
+                    "duration": Int(workout.duration),
+                    "startDate": self.isoFormatter.string(from: workout.startDate),
+                    "endDate": self.isoFormatter.string(from: workout.endDate)
+                ]
+
+                // Add total energy burned if available
+                if let totalEnergyBurned = workout.totalEnergyBurned {
+                    let energyInKilocalories = totalEnergyBurned.doubleValue(for: HKUnit.kilocalorie())
+                    payload["totalEnergyBurned"] = energyInKilocalories
+                }
+
+                // Add total distance if available
+                if let totalDistance = workout.totalDistance {
+                    let distanceInMeters = totalDistance.doubleValue(for: HKUnit.meter())
+                    payload["totalDistance"] = distanceInMeters
+                }
+
+                // Add source information
+                let source = workout.sourceRevision.source
+                payload["sourceName"] = source.name
+                payload["sourceId"] = source.bundleIdentifier
+
+                // Add metadata if available
+                if let metadata = workout.metadata, !metadata.isEmpty {
+                    var metadataDict: [String: String] = [:]
+                    for (key, value) in metadata {
+                        if let stringValue = value as? String {
+                            metadataDict[key] = stringValue
+                        } else if let numberValue = value as? NSNumber {
+                            metadataDict[key] = numberValue.stringValue
+                        }
+                    }
+                    if !metadataDict.isEmpty {
+                        payload["metadata"] = metadataDict
+                    }
+                }
+
+                return payload
+            }
+
+            completion(.success(results))
+        }
+
+        healthStore.execute(query)
+    }
 }

package/ios/Sources/HealthPlugin/HealthPlugin.swift

@@ -3,7 +3,7 @@ import Capacitor
 
 @objc(HealthPlugin)
 public class HealthPlugin: CAPPlugin, CAPBridgedPlugin {
-    private let pluginVersion: String = "8.1.4"
+    private let pluginVersion: String = "8.2.0"
     public let identifier = "HealthPlugin"
     public let jsName = "Health"
     public let pluginMethods: [CAPPluginMethod] = [
@@ -14,7 +14,8 @@ public class HealthPlugin: CAPPlugin, CAPBridgedPlugin {
         CAPPluginMethod(name: "saveSample", returnType: CAPPluginReturnPromise),
         CAPPluginMethod(name: "getPluginVersion", returnType: CAPPluginReturnPromise),
         CAPPluginMethod(name: "openHealthConnectSettings", returnType: CAPPluginReturnPromise),
-        CAPPluginMethod(name: "showPrivacyPolicy", returnType: CAPPluginReturnPromise)
+        CAPPluginMethod(name: "showPrivacyPolicy", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "queryWorkouts", returnType: CAPPluginReturnPromise)
     ]
 
     private let implementation = Health()
@@ -146,4 +147,29 @@ public class HealthPlugin: CAPPlugin, CAPBridgedPlugin {
         call.resolve()
     }
 
+    @objc func queryWorkouts(_ call: CAPPluginCall) {
+        let workoutType = call.getString("workoutType")
+        let startDate = call.getString("startDate")
+        let endDate = call.getString("endDate")
+        let limit = call.getInt("limit")
+        let ascending = call.getBool("ascending") ?? false
+
+        implementation.queryWorkouts(
+            workoutTypeString: workoutType,
+            startDateString: startDate,
+            endDateString: endDate,
+            limit: limit,
+            ascending: ascending
+        ) { result in
+            DispatchQueue.main.async {
+                switch result {
+                case let .success(workouts):
+                    call.resolve(["workouts": workouts])
+                case let .failure(error):
+                    call.reject(error.localizedDescription, nil, error)
+                }
+            }
+        }
+    }
+
 }

package/package.json

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