@capgo/capacitor-health 8.3.2 → 8.4.0

package/README.md

@@ -546,18 +546,19 @@ Supported on iOS (HealthKit) and Android (Health Connect).
 
 #### HealthSample
 
-| Prop             | Type                                                      | Description                                                                                  |
-| ---------------- | --------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
-| **`dataType`**   | <code><a href="#healthdatatype">HealthDataType</a></code> |                                                                                              |
-| **`value`**      | <code>number</code>                                       |                                                                                              |
-| **`unit`**       | <code><a href="#healthunit">HealthUnit</a></code>         |                                                                                              |
-| **`startDate`**  | <code>string</code>                                       |                                                                                              |
-| **`endDate`**    | <code>string</code>                                       |                                                                                              |
-| **`sourceName`** | <code>string</code>                                       |                                                                                              |
-| **`sourceId`**   | <code>string</code>                                       |                                                                                              |
-| **`sleepState`** | <code><a href="#sleepstate">SleepState</a></code>         | For sleep data, indicates the sleep state (e.g., 'asleep', 'awake', 'rem', 'deep', 'light'). |
-| **`systolic`**   | <code>number</code>                                       | For blood pressure data, the systolic value in mmHg.                                         |
-| **`diastolic`**  | <code>number</code>                                       | For blood pressure data, the diastolic value in mmHg.                                        |
+| Prop             | Type                                                      | Description                                                                                         |
+| ---------------- | --------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
+| **`dataType`**   | <code><a href="#healthdatatype">HealthDataType</a></code> |                                                                                                     |
+| **`value`**      | <code>number</code>                                       |                                                                                                     |
+| **`unit`**       | <code><a href="#healthunit">HealthUnit</a></code>         |                                                                                                     |
+| **`startDate`**  | <code>string</code>                                       |                                                                                                     |
+| **`endDate`**    | <code>string</code>                                       |                                                                                                     |
+| **`sourceName`** | <code>string</code>                                       |                                                                                                     |
+| **`sourceId`**   | <code>string</code>                                       |                                                                                                     |
+| **`platformId`** | <code>string</code>                                       | Platform-specific unique identifier (HealthKit UUID on iOS, Health Connect metadata ID on Android). |
+| **`sleepState`** | <code><a href="#sleepstate">SleepState</a></code>         | For sleep data, indicates the sleep state (e.g., 'asleep', 'awake', 'rem', 'deep', 'light').        |
+| **`systolic`**   | <code>number</code>                                       | For blood pressure data, the systolic value in mmHg.                                                |
+| **`diastolic`**  | <code>number</code>                                       | For blood pressure data, the diastolic value in mmHg.                                               |
 
 
 #### QueryOptions
@@ -595,17 +596,18 @@ Supported on iOS (HealthKit) and Android (Health Connect).
 
 #### 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).                 |
+| 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.                                                                           |
+| **`platformId`**        | <code>string</code>                                             | Platform-specific unique identifier (HealthKit UUID on iOS, Health Connect metadata ID on Android). |
+| **`metadata`**          | <code><a href="#record">Record</a>&lt;string, string&gt;</code> | Additional metadata (if available).                                                                 |
 
 
 #### QueryWorkoutsOptions

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

@@ -636,6 +636,8 @@ class HealthManager {
             }
         }
 
+        payload.put("platformId", metadata.id)
+
         return payload
     }
 
@@ -912,9 +914,11 @@ class HealthManager {
             }
         }
         
+        payload.put("platformId", session.metadata.id)
+
         // Note: customMetadata is not available on Metadata in Health Connect
         // Metadata only contains dataOrigin, device, and lastModifiedTime
-        
+
         return payload
     }
 

package/dist/docs.json

@@ -389,6 +389,13 @@
           "complexTypes": [],
           "type": "string | undefined"
         },
+        {
+          "name": "platformId",
+          "tags": [],
+          "docs": "Platform-specific unique identifier (HealthKit UUID on iOS, Health Connect metadata ID on Android).",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
         {
           "name": "sleepState",
           "tags": [],
@@ -621,6 +628,13 @@
           "complexTypes": [],
           "type": "string | undefined"
         },
+        {
+          "name": "platformId",
+          "tags": [],
+          "docs": "Platform-specific unique identifier (HealthKit UUID on iOS, Health Connect metadata ID on Android).",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
         {
           "name": "metadata",
           "tags": [],

package/dist/esm/definitions.d.ts

@@ -39,6 +39,8 @@ export interface HealthSample {
     endDate: string;
     sourceName?: string;
     sourceId?: string;
+    /** Platform-specific unique identifier (HealthKit UUID on iOS, Health Connect metadata ID on Android). */
+    platformId?: string;
     /** For sleep data, indicates the sleep state (e.g., 'asleep', 'awake', 'rem', 'deep', 'light'). */
     sleepState?: SleepState;
     /** For blood pressure data, the systolic value in mmHg. */
@@ -86,6 +88,8 @@ export interface Workout {
     sourceName?: string;
     /** Source bundle identifier. */
     sourceId?: string;
+    /** Platform-specific unique identifier (HealthKit UUID on iOS, Health Connect metadata ID on Android). */
+    platformId?: string;
     /** Additional metadata (if available). */
     metadata?: Record<string, string>;
 }

package/dist/esm/definitions.js.map

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

package/ios/Sources/HealthPlugin/Health.swift

@@ -898,9 +898,7 @@ final class Health {
                         payload["sleepState"] = sleepState
                     }
 
-                    let source = sample.sourceRevision.source
-                    payload["sourceName"] = source.name
-                    payload["sourceId"] = source.bundleIdentifier
+                    self.addSampleMetadata(sample, to: &payload)
 
                     return payload
                 }
@@ -910,7 +908,7 @@ final class Health {
             healthStore.execute(query)
             return
         }
-        
+
         // Handle mindfulness as a category sample
         if dataType == .mindfulness {
             let query = HKSampleQuery(sampleType: sampleType, predicate: predicate, limit: queryLimit, sortDescriptors: [sortDescriptor]) { [weak self] _, samples, error in
@@ -937,9 +935,7 @@ final class Health {
                         "endDate": self.isoFormatter.string(from: sample.endDate)
                     ]
 
-                    let source = sample.sourceRevision.source
-                    payload["sourceName"] = source.name
-                    payload["sourceId"] = source.bundleIdentifier
+                    self.addSampleMetadata(sample, to: &payload)
 
                     return payload
                 }
@@ -949,7 +945,7 @@ final class Health {
             healthStore.execute(query)
             return
         }
-        
+
         // Handle blood pressure as a correlation sample
         if dataType == .bloodPressure {
             let query = HKSampleQuery(sampleType: sampleType, predicate: predicate, limit: queryLimit, sortDescriptors: [sortDescriptor]) { [weak self] _, samples, error in
@@ -986,9 +982,7 @@ final class Health {
                         "diastolic": diastolicValue
                     ]
 
-                    let source = correlation.sourceRevision.source
-                    payload["sourceName"] = source.name
-                    payload["sourceId"] = source.bundleIdentifier
+                    self.addSampleMetadata(correlation, to: &payload)
 
                     return payload
                 }
@@ -1023,9 +1017,7 @@ final class Health {
                     "endDate": self.isoFormatter.string(from: sample.endDate)
                 ]
 
-                let source = sample.sourceRevision.source
-                payload["sourceName"] = source.name
-                payload["sourceId"] = source.bundleIdentifier
+                self.addSampleMetadata(sample, to: &payload)
 
                 return payload
             }
@@ -1036,6 +1028,13 @@ final class Health {
         healthStore.execute(query)
     }
     
+    private func addSampleMetadata(_ sample: HKSample, to payload: inout [String: Any]) {
+        let source = sample.sourceRevision.source
+        payload["sourceName"] = source.name
+        payload["sourceId"] = source.bundleIdentifier
+        payload["platformId"] = sample.uuid.uuidString
+    }
+
     private func sleepStateFromValue(_ value: Int) -> String? {
         switch value {
         case HKCategoryValueSleepAnalysis.inBed.rawValue:
@@ -1584,10 +1583,8 @@ final class Health {
             payload["totalDistance"] = distanceInMeters
         }
 
-        // Add source information
-        let source = workout.sourceRevision.source
-        payload["sourceName"] = source.name
-        payload["sourceId"] = source.bundleIdentifier
+        // Add source information and platform ID
+        addSampleMetadata(workout, to: &payload)
 
         // Add metadata if available
         if let metadata = workout.metadata, !metadata.isEmpty {

package/ios/Sources/HealthPlugin/HealthPlugin.swift

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

package/package.json

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