@flomentumsolutions/capacitor-health-extended 0.4.5 → 0.6.1

package/README.md

@@ -28,12 +28,14 @@ Thanks [@mley](https://github.com/mley) for the ground work. The goal of this fo
 - Query aggregated data like steps or calories
 - Retrieve workout sessions with optional route and heart rate data
 - Fetch the latest samples for steps, distance (incl. cycling), calories (active/total/basal), heart‑rate, resting HR, HRV, respiratory rate, blood pressure, oxygen saturation, blood glucose, body temperature (basal + core), body fat, height, weight, flights climbed, sleep, and exercise time.
+- Read profile characteristics on iOS: biological sex, blood type, date of birth, Fitzpatrick skin type, wheelchair use.
 
 ### Supported data types (parity iOS + Android)
 - Activity: steps, distance, distance‑cycling, exercise time (Apple Exercise Time), workouts (with routes/steps/calories), flights climbed
 - Energy: active calories, total calories, basal calories
 - Vitals: heart rate, resting heart rate, HRV, respiratory rate, blood pressure, oxygen saturation, blood glucose, body temperature, basal body temperature
 - Body: weight, height, body fat
+- Characteristics (iOS): biological sex, blood type, date of birth, Fitzpatrick skin type, wheelchair use
 - Sessions: mindfulness, sleep
 
 ## Install
@@ -213,6 +215,7 @@ This setup ensures your WebView will load HTTPS content securely and complies wi
 * [`openAppleHealthSettings()`](#openapplehealthsettings)
 * [`openHealthConnectSettings()`](#openhealthconnectsettings)
 * [`showHealthConnectInPlayStore()`](#showhealthconnectinplaystore)
+* [`getCharacteristics()`](#getcharacteristics)
 * [`queryAggregated(...)`](#queryaggregated)
 * [`queryWorkouts(...)`](#queryworkouts)
 * [`queryLatestSample(...)`](#querylatestsample)
@@ -319,20 +322,27 @@ Opens the Google Health Connect app in PlayStore
 --------------------
 
 
-### queryAggregated(...)
+### getCharacteristics()
 
 ```typescript
-queryAggregated(request: QueryAggregatedRequest) => Promise<QueryAggregatedResponse>
+getCharacteristics() => Promise<CharacteristicsResponse>
 ```
 
-Query aggregated data
+iOS only: Reads user characteristics such as biological sex, blood type, date of birth, Fitzpatrick skin type, and wheelchair use.
+Values are null when unavailable or permission was not granted. Android does not expose these characteristics; it returns `platformSupported: false` and a `platformMessage` for UI hints without emitting null values.
 
-| Param         | Type                                                                      |
-| ------------- | ------------------------------------------------------------------------- |
-| **`request`** | <code><a href="#queryaggregatedrequest">QueryAggregatedRequest</a></code> |
+**Returns:** <code>Promise&lt;<a href="#characteristicsresponse">CharacteristicsResponse</a>&gt;</code>
 
-**Returns:** <code>Promise&lt;<a href="#queryaggregatedresponse">QueryAggregatedResponse</a>&gt;</code>
+--------------------
+
+
+### queryAggregated(...)
+
+```typescript
+queryAggregated(request: QueryAggregatedRequest) => Promise<QueryAggregatedResponse>
+```
 
+Query aggregated data
 - Blood-pressure aggregates return the systolic average in `value` plus `systolic`, `diastolic`, and `unit`.
 - `total-calories` is derived as active + basal energy on both iOS and Android for latest samples, aggregated queries, and workouts. We fall back to the platform's total‑calories metric (or active calories) when basal data isn't available or permission is missing. Request both `READ_ACTIVE_CALORIES` and `READ_BASAL_CALORIES` for full totals.
 - Weight/height aggregation returns the latest sample per day (no averaging).
@@ -340,6 +350,12 @@ Query aggregated data
 - Android `distance-cycling` aggregates distance recorded during biking exercise sessions (requires distance + workouts permissions).
 - Daily `bucket: "day"` queries use calendar-day boundaries in the device time zone (start-of-day through the next start-of-day) instead of a trailing 24-hour window. For “today,” send `startDate` at today’s start-of-day and `endDate` at now or tomorrow’s start-of-day.
 
+| Param         | Type                                                                      |
+| ------------- | ------------------------------------------------------------------------- |
+| **`request`** | <code><a href="#queryaggregatedrequest">QueryAggregatedRequest</a></code> |
+
+**Returns:** <code>Promise&lt;<a href="#queryaggregatedresponse">QueryAggregatedResponse</a>&gt;</code>
+
 --------------------
 
 
@@ -363,19 +379,18 @@ Query workouts
 ### queryLatestSample(...)
 
 ```typescript
-queryLatestSample(request: { dataType: string; }) => Promise<QueryLatestSampleResponse>
+queryLatestSample(request: { dataType: LatestDataType; }) => Promise<QueryLatestSampleResponse>
 ```
 
 Query latest sample for a specific data type
+- Latest sleep sample returns the most recent complete sleep session (asleep states only) from the last ~36 hours; if a longer overnight session exists, shorter naps are ignored.
 
-| Param         | Type                               |
-| ------------- | ---------------------------------- |
-| **`request`** | <code>{ dataType: string; }</code> |
+| Param         | Type                                                                     |
+| ------------- | ------------------------------------------------------------------------ |
+| **`request`** | <code>{ dataType: <a href="#latestdatatype">LatestDataType</a>; }</code> |
 
 **Returns:** <code>Promise&lt;<a href="#querylatestsampleresponse">QueryLatestSampleResponse</a>&gt;</code>
 
-- Latest sleep sample returns the most recent complete sleep session (asleep states only) from the last ~36 hours; if a longer overnight session exists, shorter naps are ignored.
-
 --------------------
 
 
@@ -436,9 +451,9 @@ Query latest steps sample
 
 #### PermissionResponse
 
-| Prop              | Type                                       |
-| ----------------- | ------------------------------------------ |
-| **`permissions`** | <code>Record<HealthPermission, boolean></code> |
+| Prop              | Type                                                                                                       |
+| ----------------- | ---------------------------------------------------------------------------------------------------------- |
+| **`permissions`** | <code><a href="#record">Record</a>&lt;<a href="#healthpermission">HealthPermission</a>, boolean&gt;</code> |
 
 
 #### PermissionsRequest
@@ -448,6 +463,19 @@ Query latest steps sample
 | **`permissions`** | <code>HealthPermission[]</code> |
 
 
+#### CharacteristicsResponse
+
+| Prop                      | Type                                                                                    | Description                                                                                                                             |
+| ------------------------- | --------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
+| **`biologicalSex`**       | <code><a href="#healthbiologicalsex">HealthBiologicalSex</a> \| null</code>             |                                                                                                                                         |
+| **`bloodType`**           | <code><a href="#healthbloodtype">HealthBloodType</a> \| null</code>                     |                                                                                                                                         |
+| **`dateOfBirth`**         | <code>string \| null</code>                                                             |                                                                                                                                         |
+| **`fitzpatrickSkinType`** | <code><a href="#healthfitzpatrickskintype">HealthFitzpatrickSkinType</a> \| null</code> |                                                                                                                                         |
+| **`wheelchairUse`**       | <code><a href="#healthwheelchairuse">HealthWheelchairUse</a> \| null</code>             |                                                                                                                                         |
+| **`platformSupported`**   | <code>boolean</code>                                                                    | Indicates whether the platform exposes these characteristics via the plugin (true on iOS, false on Android).                            |
+| **`platformMessage`**     | <code>string</code>                                                                     | Optional platform-specific message; on Android we return a user-facing note explaining that values remain empty unless synced from iOS. |
+
+
 #### QueryAggregatedResponse
 
 | Prop                 | Type                            |
@@ -457,14 +485,14 @@ Query latest steps sample
 
 #### AggregatedSample
 
-| Prop              | Type                |
-| ----------------- | ------------------- |
-| **`startDate`**   | <code>string</code> |
-| **`endDate`**     | <code>string</code> |
-| **`value`**       | <code>number</code> |
-| **`systolic`**    | <code>number</code> |
-| **`diastolic`**   | <code>number</code> |
-| **`unit`**        | <code>string</code> |
+| Prop            | Type                |
+| --------------- | ------------------- |
+| **`startDate`** | <code>string</code> |
+| **`endDate`**   | <code>string</code> |
+| **`value`**     | <code>number</code> |
+| **`systolic`**  | <code>number</code> |
+| **`diastolic`** | <code>number</code> |
+| **`unit`**      | <code>string</code> |
 
 
 #### QueryAggregatedRequest
@@ -473,7 +501,7 @@ Query latest steps sample
 | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | **`startDate`** | <code>string</code>                                                                                                                                                                                                                                                                                                                                                                                                    |
 | **`endDate`**   | <code>string</code>                                                                                                                                                                                                                                                                                                                                                                                                    |
-| **`dataType`**  | <code>'steps' \| 'active-calories' \| 'total-calories' \| 'basal-calories' \| 'distance' \| 'distance-cycling' \| 'weight' \| 'height' \| 'heart-rate' \| 'resting-heart-rate' \| 'respiratory-rate' \| 'oxygen-saturation' \| 'blood-glucose' \| 'body-temperature' \| 'basal-body-temperature' \| 'body-fat' \| 'flights-climbed' \| 'exercise-time' \| 'sleep' \| 'mindfulness' \| 'hrv' \| 'blood-pressure'</code> |
+| **`dataType`**  | <code>'steps' \| 'active-calories' \| 'total-calories' \| 'basal-calories' \| 'distance' \| 'weight' \| 'height' \| 'heart-rate' \| 'resting-heart-rate' \| 'respiratory-rate' \| 'oxygen-saturation' \| 'blood-glucose' \| 'body-temperature' \| 'basal-body-temperature' \| 'body-fat' \| 'flights-climbed' \| 'exercise-time' \| 'distance-cycling' \| 'mindfulness' \| 'sleep' \| 'hrv' \| 'blood-pressure'</code> |
 | **`bucket`**    | <code>string</code>                                                                                                                                                                                                                                                                                                                                                                                                    |
 
 
@@ -533,20 +561,54 @@ Query latest steps sample
 
 #### QueryLatestSampleResponse
 
-| Prop            | Type                |
-| --------------- | ------------------- |
-| **`value`**     | <code>number</code> |
-| **`systolic`**  | <code>number</code> |
-| **`diastolic`** | <code>number</code> |
-| **`timestamp`** | <code>number</code> |
-| **`unit`**      | <code>string</code> |
+| Prop               | Type                                                             |
+| ------------------ | ---------------------------------------------------------------- |
+| **`value`**        | <code>number</code>                                              |
+| **`systolic`**     | <code>number</code>                                              |
+| **`diastolic`**    | <code>number</code>                                              |
+| **`timestamp`**    | <code>number</code>                                              |
+| **`endTimestamp`** | <code>number</code>                                              |
+| **`unit`**         | <code>string</code>                                              |
+| **`metadata`**     | <code><a href="#record">Record</a>&lt;string, unknown&gt;</code> |
 
 
 ### Type Aliases
 
 
+#### Record
+
+Construct a type with a set of properties K of type T
+
+<code>{
 [P in K]: T;
 }</code>
+
+
 #### HealthPermission
 
-<code>'READ_STEPS' | 'READ_WORKOUTS' | 'READ_ACTIVE_CALORIES' | 'READ_TOTAL_CALORIES' | 'READ_DISTANCE' | 'READ_WEIGHT' | 'READ_HEIGHT' | 'READ_HEART_RATE' | 'READ_ROUTE' | 'READ_MINDFULNESS' | 'READ_HRV' | 'READ_BLOOD_PRESSURE'</code>
+<code>'READ_STEPS' | 'READ_WORKOUTS' | 'READ_ACTIVE_CALORIES' | 'READ_TOTAL_CALORIES' | 'READ_DISTANCE' | 'READ_WEIGHT' | 'READ_HEIGHT' | 'READ_HEART_RATE' | 'READ_RESTING_HEART_RATE' | 'READ_ROUTE' | 'READ_MINDFULNESS' | 'READ_HRV' | 'READ_BLOOD_PRESSURE' | 'READ_BASAL_CALORIES' | 'READ_RESPIRATORY_RATE' | 'READ_OXYGEN_SATURATION' | 'READ_BLOOD_GLUCOSE' | 'READ_BODY_TEMPERATURE' | 'READ_BASAL_BODY_TEMPERATURE' | 'READ_BODY_FAT' | 'READ_FLOORS_CLIMBED' | 'READ_SLEEP' | 'READ_EXERCISE_TIME' | 'READ_BIOLOGICAL_SEX' | 'READ_BLOOD_TYPE' | 'READ_DATE_OF_BIRTH' | 'READ_FITZPATRICK_SKIN_TYPE' | 'READ_WHEELCHAIR_USE'</code>
+
+
+#### HealthBiologicalSex
+
+<code>'female' | 'male' | 'other' | 'not_set' | 'unknown'</code>
+
+
+#### HealthBloodType
+
+<code>'a-positive' | 'a-negative' | 'b-positive' | 'b-negative' | 'ab-positive' | 'ab-negative' | 'o-positive' | 'o-negative' | 'not_set' | 'unknown'</code>
+
+
+#### HealthFitzpatrickSkinType
+
+<code>'type1' | 'type2' | 'type3' | 'type4' | 'type5' | 'type6' | 'not_set' | 'unknown'</code>
+
+
+#### HealthWheelchairUse
+
+<code>'wheelchair_user' | 'not_wheelchair_user' | 'not_set' | 'unknown'</code>
+
+
+#### LatestDataType
+
+<code>'steps' | 'active-calories' | 'total-calories' | 'basal-calories' | 'distance' | 'weight' | 'height' | 'heart-rate' | 'resting-heart-rate' | 'respiratory-rate' | 'oxygen-saturation' | 'blood-glucose' | 'body-temperature' | 'basal-body-temperature' | 'body-fat' | 'flights-climbed' | 'exercise-time' | 'distance-cycling' | 'mindfulness' | 'sleep' | 'hrv' | 'blood-pressure'</code>
 
 </docgen-api>

package/android/src/main/java/com/flomentum/health/capacitor/HealthPlugin.kt

@@ -313,6 +313,17 @@ class HealthPlugin : Plugin() {
         call.resolve()
     }
 
+    @PluginMethod
+    fun getCharacteristics(call: PluginCall) {
+        val result = JSObject()
+        result.put("platformSupported", false)
+        result.put(
+            "platformMessage",
+            "Health Connect does not expose characteristics; this section stays empty unless synced from an iOS device."
+        )
+        call.resolve(result)
+    }
+
     private fun getMetricAndMapper(dataType: String): MetricAndMapper {
         return when (dataType) {
             "steps" -> metricAndMapper("steps", CapHealthPermission.READ_STEPS, StepsRecord.COUNT_TOTAL) { it?.toDouble() }

package/dist/esm/definitions.d.ts

@@ -40,8 +40,19 @@ export interface HealthPlugin {
      * Opens the Google Health Connect app in PlayStore
      */
     showHealthConnectInPlayStore(): Promise<void>;
+    /**
+     * iOS only: Reads user characteristics such as biological sex, blood type, date of birth, Fitzpatrick skin type, and wheelchair use.
+     * Values are null when unavailable or permission was not granted. Android does not expose these characteristics; it returns `platformSupported: false` and a `platformMessage` for UI hints without emitting null values.
+     */
+    getCharacteristics(): Promise<CharacteristicsResponse>;
     /**
      * Query aggregated data
+     * - Blood-pressure aggregates return the systolic average in `value` plus `systolic`, `diastolic`, and `unit`.
+     * - `total-calories` is derived as active + basal energy on both iOS and Android for latest samples, aggregated queries, and workouts. We fall back to the platform's total‑calories metric (or active calories) when basal data isn't available or permission is missing. Request both `READ_ACTIVE_CALORIES` and `READ_BASAL_CALORIES` for full totals.
+     * - Weight/height aggregation returns the latest sample per day (no averaging).
+     * - Android aggregation currently supports daily buckets; unsupported buckets will be rejected.
+     * - Android `distance-cycling` aggregates distance recorded during biking exercise sessions (requires distance + workouts permissions).
+     * - Daily `bucket: "day"` queries use calendar-day boundaries in the device time zone (start-of-day through the next start-of-day) instead of a trailing 24-hour window. For “today,” send `startDate` at today’s start-of-day and `endDate` at now or tomorrow’s start-of-day.
      * @param request
      */
     queryAggregated(request: QueryAggregatedRequest): Promise<QueryAggregatedResponse>;
@@ -52,6 +63,7 @@ export interface HealthPlugin {
     queryWorkouts(request: QueryWorkoutRequest): Promise<QueryWorkoutResponse>;
     /**
      * Query latest sample for a specific data type
+     * - Latest sleep sample returns the most recent complete sleep session (asleep states only) from the last ~36 hours; if a longer overnight session exists, shorter naps are ignored.
      * @param request
      */
     queryLatestSample(request: {
@@ -74,7 +86,7 @@ export interface HealthPlugin {
      */
     querySteps(): Promise<QueryLatestSampleResponse>;
 }
-export declare type HealthPermission = 'READ_STEPS' | 'READ_WORKOUTS' | 'READ_ACTIVE_CALORIES' | 'READ_TOTAL_CALORIES' | 'READ_DISTANCE' | 'READ_WEIGHT' | 'READ_HEIGHT' | 'READ_HEART_RATE' | 'READ_RESTING_HEART_RATE' | 'READ_ROUTE' | 'READ_MINDFULNESS' | 'READ_HRV' | 'READ_BLOOD_PRESSURE' | 'READ_BASAL_CALORIES' | 'READ_RESPIRATORY_RATE' | 'READ_OXYGEN_SATURATION' | 'READ_BLOOD_GLUCOSE' | 'READ_BODY_TEMPERATURE' | 'READ_BASAL_BODY_TEMPERATURE' | 'READ_BODY_FAT' | 'READ_FLOORS_CLIMBED' | 'READ_SLEEP' | 'READ_EXERCISE_TIME';
+export declare type HealthPermission = 'READ_STEPS' | 'READ_WORKOUTS' | 'READ_ACTIVE_CALORIES' | 'READ_TOTAL_CALORIES' | 'READ_DISTANCE' | 'READ_WEIGHT' | 'READ_HEIGHT' | 'READ_HEART_RATE' | 'READ_RESTING_HEART_RATE' | 'READ_ROUTE' | 'READ_MINDFULNESS' | 'READ_HRV' | 'READ_BLOOD_PRESSURE' | 'READ_BASAL_CALORIES' | 'READ_RESPIRATORY_RATE' | 'READ_OXYGEN_SATURATION' | 'READ_BLOOD_GLUCOSE' | 'READ_BODY_TEMPERATURE' | 'READ_BASAL_BODY_TEMPERATURE' | 'READ_BODY_FAT' | 'READ_FLOORS_CLIMBED' | 'READ_SLEEP' | 'READ_EXERCISE_TIME' | 'READ_BIOLOGICAL_SEX' | 'READ_BLOOD_TYPE' | 'READ_DATE_OF_BIRTH' | 'READ_FITZPATRICK_SKIN_TYPE' | 'READ_WHEELCHAIR_USE';
 export type LatestDataType = 'steps' | 'active-calories' | 'total-calories' | 'basal-calories' | 'distance' | 'weight' | 'height' | 'heart-rate' | 'resting-heart-rate' | 'respiratory-rate' | 'oxygen-saturation' | 'blood-glucose' | 'body-temperature' | 'basal-body-temperature' | 'body-fat' | 'flights-climbed' | 'exercise-time' | 'distance-cycling' | 'mindfulness' | 'sleep' | 'hrv' | 'blood-pressure';
 export interface PermissionsRequest {
     permissions: HealthPermission[];
@@ -142,3 +154,22 @@ export interface QueryLatestSampleResponse {
     unit: string;
     metadata?: Record<string, unknown>;
 }
+export interface CharacteristicsResponse {
+    biologicalSex?: HealthBiologicalSex | null;
+    bloodType?: HealthBloodType | null;
+    dateOfBirth?: string | null;
+    fitzpatrickSkinType?: HealthFitzpatrickSkinType | null;
+    wheelchairUse?: HealthWheelchairUse | null;
+    /**
+     * Indicates whether the platform exposes these characteristics via the plugin (true on iOS, false on Android).
+     */
+    platformSupported?: boolean;
+    /**
+     * Optional platform-specific message; on Android we return a user-facing note explaining that values remain empty unless synced from iOS.
+     */
+    platformMessage?: string;
+}
+export type HealthBiologicalSex = 'female' | 'male' | 'other' | 'not_set' | 'unknown';
+export type HealthBloodType = 'a-positive' | 'a-negative' | 'b-positive' | 'b-negative' | 'ab-positive' | 'ab-negative' | 'o-positive' | 'o-negative' | 'not_set' | 'unknown';
+export type HealthFitzpatrickSkinType = 'type1' | 'type2' | 'type3' | 'type4' | 'type5' | 'type6' | 'not_set' | 'unknown';
+export type HealthWheelchairUse = 'wheelchair_user' | 'not_wheelchair_user' | 'not_set' | 'unknown';

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["export interface HealthPlugin {\n  /**\n   * Checks if health API is available.\n   * Android: If false is returned, the Google Health Connect app is probably not installed.\n   * See showHealthConnectInPlayStore()\n   *\n   */\n  isHealthAvailable(): Promise<{ available: boolean }>;\n\n  /**\n   * Android only: Returns for each given permission, if it was granted by the underlying health API\n   * @param permissions permissions to query\n   */\n  checkHealthPermissions(permissions: PermissionsRequest): Promise<PermissionResponse>;\n\n  /**\n   * Requests the permissions from the user.\n   *\n   * Android: Apps can ask only a few times for permissions, after that the user has to grant them manually in\n   * the Health Connect app. See openHealthConnectSettings()\n   *\n   * iOS: If the permissions are already granted or denied, this method will just return without asking the user. In iOS\n   * we can't really detect if a user granted or denied a permission. The return value reflects the assumption that all\n   * permissions were granted.\n   *\n   * @param permissions permissions to request\n   */\n  requestHealthPermissions(permissions: PermissionsRequest): Promise<PermissionResponse>;\n\n  /**\n   * Opens the apps settings, which is kind of wrong, because health permissions are configured under:\n   * Settings > Apps > (Apple) Health > Access and Devices > [app-name]\n   * But we can't go there directly.\n   */\n  openAppleHealthSettings(): Promise<void>;\n\n  /**\n   * Opens the Google Health Connect app\n   */\n  openHealthConnectSettings(): Promise<void>;\n\n  /**\n   * Opens the Google Health Connect app in PlayStore\n   */\n  showHealthConnectInPlayStore(): Promise<void>;\n\n  /**\n   * Query aggregated data\n   * @param request\n   */\n  queryAggregated(request: QueryAggregatedRequest): Promise<QueryAggregatedResponse>;\n\n  /**\n   * Query workouts\n   * @param request\n   */\n  queryWorkouts(request: QueryWorkoutRequest): Promise<QueryWorkoutResponse>;\n\n  /**\n   * Query latest sample for a specific data type\n   * @param request\n   */\n  queryLatestSample(request: { dataType: LatestDataType }): Promise<QueryLatestSampleResponse>;\n\n  /**\n   * Query latest weight sample\n   */\n  queryWeight(): Promise<QueryLatestSampleResponse>;\n\n  /**\n   * Query latest height sample\n   */\n  queryHeight(): Promise<QueryLatestSampleResponse>;\n\n  /**\n   * Query latest heart rate sample\n   */\n  queryHeartRate(): Promise<QueryLatestSampleResponse>;\n\n  /**\n   * Query latest steps sample\n   */\n  querySteps(): Promise<QueryLatestSampleResponse>;\n}\n\nexport declare type HealthPermission =\n  | 'READ_STEPS'\n  | 'READ_WORKOUTS'\n  | 'READ_ACTIVE_CALORIES'\n  | 'READ_TOTAL_CALORIES'\n  | 'READ_DISTANCE'\n  | 'READ_WEIGHT'\n  | 'READ_HEIGHT'\n  | 'READ_HEART_RATE'\n  | 'READ_RESTING_HEART_RATE'\n  | 'READ_ROUTE'\n  | 'READ_MINDFULNESS'\n  | 'READ_HRV'\n  | 'READ_BLOOD_PRESSURE'\n  | 'READ_BASAL_CALORIES'\n  | 'READ_RESPIRATORY_RATE'\n  | 'READ_OXYGEN_SATURATION'\n  | 'READ_BLOOD_GLUCOSE'\n  | 'READ_BODY_TEMPERATURE'\n  | 'READ_BASAL_BODY_TEMPERATURE'\n  | 'READ_BODY_FAT'\n  | 'READ_FLOORS_CLIMBED'\n  | 'READ_SLEEP'\n  | 'READ_EXERCISE_TIME';\n\nexport type LatestDataType =\n  | 'steps'\n  | 'active-calories'\n  | 'total-calories'\n  | 'basal-calories'\n  | 'distance'\n  | 'weight'\n  | 'height'\n  | 'heart-rate'\n  | 'resting-heart-rate'\n  | 'respiratory-rate'\n  | 'oxygen-saturation'\n  | 'blood-glucose'\n  | 'body-temperature'\n  | 'basal-body-temperature'\n  | 'body-fat'\n  | 'flights-climbed'\n  | 'exercise-time'\n  | 'distance-cycling'\n  | 'mindfulness'\n  | 'sleep'\n  | 'hrv'\n  | 'blood-pressure';\n\nexport interface PermissionsRequest {\n  permissions: HealthPermission[];\n}\n\nexport interface PermissionResponse {\n  permissions: Record<HealthPermission, boolean>;\n}\n\nexport interface QueryWorkoutRequest {\n  startDate: string;\n  endDate: string;\n  includeHeartRate: boolean;\n  includeRoute: boolean;\n  includeSteps: boolean;\n}\n\nexport interface HeartRateSample {\n  timestamp: string;\n  bpm: number;\n}\n\nexport interface RouteSample {\n  timestamp: string;\n  lat: number;\n  lng: number;\n  alt?: number;\n}\n\nexport interface QueryWorkoutResponse {\n  workouts: Workout[];\n}\n\nexport interface Workout {\n  startDate: string;\n  endDate: string;\n  workoutType: string;\n  sourceName: string;\n  id?: string;\n  duration: number;\n  distance?: number;\n  steps?: number;\n  calories: number;\n  sourceBundleId: string;\n  route?: RouteSample[];\n  heartRate?: HeartRateSample[];\n}\n\nexport interface QueryAggregatedRequest {\n  startDate: string;\n  endDate: string;\n  dataType:\n    | 'steps'\n    | 'active-calories'\n    | 'total-calories'\n    | 'basal-calories'\n    | 'distance'\n    | 'weight'\n    | 'height'\n    | 'heart-rate'\n    | 'resting-heart-rate'\n    | 'respiratory-rate'\n    | 'oxygen-saturation'\n    | 'blood-glucose'\n    | 'body-temperature'\n    | 'basal-body-temperature'\n    | 'body-fat'\n    | 'flights-climbed'\n    | 'exercise-time'\n    | 'distance-cycling'\n    | 'sleep'\n    | 'mindfulness'\n    | 'hrv'\n    | 'blood-pressure';\n  bucket: string;\n}\n\nexport interface QueryAggregatedResponse {\n  aggregatedData: AggregatedSample[];\n}\n\nexport interface AggregatedSample {\n  startDate: string;\n  endDate: string;\n  value: number;\n  systolic?: number;\n  diastolic?: number;\n  unit?: string;\n}\n\nexport interface QueryLatestSampleResponse {\n  value?: number;\n  systolic?: number;\n  diastolic?: number;\n  timestamp: number;\n  endTimestamp?: number;\n  unit: string;\n  metadata?: Record<string, unknown>;\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["export interface HealthPlugin {\n  /**\n   * Checks if health API is available.\n   * Android: If false is returned, the Google Health Connect app is probably not installed.\n   * See showHealthConnectInPlayStore()\n   *\n   */\n  isHealthAvailable(): Promise<{ available: boolean }>;\n\n  /**\n   * Android only: Returns for each given permission, if it was granted by the underlying health API\n   * @param permissions permissions to query\n   */\n  checkHealthPermissions(permissions: PermissionsRequest): Promise<PermissionResponse>;\n\n  /**\n   * Requests the permissions from the user.\n   *\n   * Android: Apps can ask only a few times for permissions, after that the user has to grant them manually in\n   * the Health Connect app. See openHealthConnectSettings()\n   *\n   * iOS: If the permissions are already granted or denied, this method will just return without asking the user. In iOS\n   * we can't really detect if a user granted or denied a permission. The return value reflects the assumption that all\n   * permissions were granted.\n   *\n   * @param permissions permissions to request\n   */\n  requestHealthPermissions(permissions: PermissionsRequest): Promise<PermissionResponse>;\n\n  /**\n   * Opens the apps settings, which is kind of wrong, because health permissions are configured under:\n   * Settings > Apps > (Apple) Health > Access and Devices > [app-name]\n   * But we can't go there directly.\n   */\n  openAppleHealthSettings(): Promise<void>;\n\n  /**\n   * Opens the Google Health Connect app\n   */\n  openHealthConnectSettings(): Promise<void>;\n\n  /**\n   * Opens the Google Health Connect app in PlayStore\n   */\n  showHealthConnectInPlayStore(): Promise<void>;\n\n  /**\n   * iOS only: Reads user characteristics such as biological sex, blood type, date of birth, Fitzpatrick skin type, and wheelchair use.\n   * Values are null when unavailable or permission was not granted. Android does not expose these characteristics; it returns `platformSupported: false` and a `platformMessage` for UI hints without emitting null values.\n   */\n  getCharacteristics(): Promise<CharacteristicsResponse>;\n\n  /**\n   * Query aggregated data\n   * - Blood-pressure aggregates return the systolic average in `value` plus `systolic`, `diastolic`, and `unit`.\n   * - `total-calories` is derived as active + basal energy on both iOS and Android for latest samples, aggregated queries, and workouts. We fall back to the platform's total‑calories metric (or active calories) when basal data isn't available or permission is missing. Request both `READ_ACTIVE_CALORIES` and `READ_BASAL_CALORIES` for full totals.\n   * - Weight/height aggregation returns the latest sample per day (no averaging).\n   * - Android aggregation currently supports daily buckets; unsupported buckets will be rejected.\n   * - Android `distance-cycling` aggregates distance recorded during biking exercise sessions (requires distance + workouts permissions).\n   * - Daily `bucket: \"day\"` queries use calendar-day boundaries in the device time zone (start-of-day through the next start-of-day) instead of a trailing 24-hour window. For “today,” send `startDate` at today’s start-of-day and `endDate` at now or tomorrow’s start-of-day.\n   * @param request\n   */\n  queryAggregated(request: QueryAggregatedRequest): Promise<QueryAggregatedResponse>;\n\n  /**\n   * Query workouts\n   * @param request\n   */\n  queryWorkouts(request: QueryWorkoutRequest): Promise<QueryWorkoutResponse>;\n\n  /**\n   * Query latest sample for a specific data type\n   * - Latest sleep sample returns the most recent complete sleep session (asleep states only) from the last ~36 hours; if a longer overnight session exists, shorter naps are ignored.\n   * @param request\n   */\n  queryLatestSample(request: { dataType: LatestDataType }): Promise<QueryLatestSampleResponse>;\n\n  /**\n   * Query latest weight sample\n   */\n  queryWeight(): Promise<QueryLatestSampleResponse>;\n\n  /**\n   * Query latest height sample\n   */\n  queryHeight(): Promise<QueryLatestSampleResponse>;\n\n  /**\n   * Query latest heart rate sample\n   */\n  queryHeartRate(): Promise<QueryLatestSampleResponse>;\n\n  /**\n   * Query latest steps sample\n   */\n  querySteps(): Promise<QueryLatestSampleResponse>;\n}\n\nexport declare type HealthPermission =\n  | 'READ_STEPS'\n  | 'READ_WORKOUTS'\n  | 'READ_ACTIVE_CALORIES'\n  | 'READ_TOTAL_CALORIES'\n  | 'READ_DISTANCE'\n  | 'READ_WEIGHT'\n  | 'READ_HEIGHT'\n  | 'READ_HEART_RATE'\n  | 'READ_RESTING_HEART_RATE'\n  | 'READ_ROUTE'\n  | 'READ_MINDFULNESS'\n  | 'READ_HRV'\n  | 'READ_BLOOD_PRESSURE'\n  | 'READ_BASAL_CALORIES'\n  | 'READ_RESPIRATORY_RATE'\n  | 'READ_OXYGEN_SATURATION'\n  | 'READ_BLOOD_GLUCOSE'\n  | 'READ_BODY_TEMPERATURE'\n  | 'READ_BASAL_BODY_TEMPERATURE'\n  | 'READ_BODY_FAT'\n  | 'READ_FLOORS_CLIMBED'\n  | 'READ_SLEEP'\n  | 'READ_EXERCISE_TIME'\n  | 'READ_BIOLOGICAL_SEX'\n  | 'READ_BLOOD_TYPE'\n  | 'READ_DATE_OF_BIRTH'\n  | 'READ_FITZPATRICK_SKIN_TYPE'\n  | 'READ_WHEELCHAIR_USE';\n\nexport type LatestDataType =\n  | 'steps'\n  | 'active-calories'\n  | 'total-calories'\n  | 'basal-calories'\n  | 'distance'\n  | 'weight'\n  | 'height'\n  | 'heart-rate'\n  | 'resting-heart-rate'\n  | 'respiratory-rate'\n  | 'oxygen-saturation'\n  | 'blood-glucose'\n  | 'body-temperature'\n  | 'basal-body-temperature'\n  | 'body-fat'\n  | 'flights-climbed'\n  | 'exercise-time'\n  | 'distance-cycling'\n  | 'mindfulness'\n  | 'sleep'\n  | 'hrv'\n  | 'blood-pressure';\n\nexport interface PermissionsRequest {\n  permissions: HealthPermission[];\n}\n\nexport interface PermissionResponse {\n  permissions: Record<HealthPermission, boolean>;\n}\n\nexport interface QueryWorkoutRequest {\n  startDate: string;\n  endDate: string;\n  includeHeartRate: boolean;\n  includeRoute: boolean;\n  includeSteps: boolean;\n}\n\nexport interface HeartRateSample {\n  timestamp: string;\n  bpm: number;\n}\n\nexport interface RouteSample {\n  timestamp: string;\n  lat: number;\n  lng: number;\n  alt?: number;\n}\n\nexport interface QueryWorkoutResponse {\n  workouts: Workout[];\n}\n\nexport interface Workout {\n  startDate: string;\n  endDate: string;\n  workoutType: string;\n  sourceName: string;\n  id?: string;\n  duration: number;\n  distance?: number;\n  steps?: number;\n  calories: number;\n  sourceBundleId: string;\n  route?: RouteSample[];\n  heartRate?: HeartRateSample[];\n}\n\nexport interface QueryAggregatedRequest {\n  startDate: string;\n  endDate: string;\n  dataType:\n    | 'steps'\n    | 'active-calories'\n    | 'total-calories'\n    | 'basal-calories'\n    | 'distance'\n    | 'weight'\n    | 'height'\n    | 'heart-rate'\n    | 'resting-heart-rate'\n    | 'respiratory-rate'\n    | 'oxygen-saturation'\n    | 'blood-glucose'\n    | 'body-temperature'\n    | 'basal-body-temperature'\n    | 'body-fat'\n    | 'flights-climbed'\n    | 'exercise-time'\n    | 'distance-cycling'\n    | 'sleep'\n    | 'mindfulness'\n    | 'hrv'\n    | 'blood-pressure';\n  bucket: string;\n}\n\nexport interface QueryAggregatedResponse {\n  aggregatedData: AggregatedSample[];\n}\n\nexport interface AggregatedSample {\n  startDate: string;\n  endDate: string;\n  value: number;\n  systolic?: number;\n  diastolic?: number;\n  unit?: string;\n}\n\nexport interface QueryLatestSampleResponse {\n  value?: number;\n  systolic?: number;\n  diastolic?: number;\n  timestamp: number;\n  endTimestamp?: number;\n  unit: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface CharacteristicsResponse {\n  biologicalSex?: HealthBiologicalSex | null;\n  bloodType?: HealthBloodType | null;\n  dateOfBirth?: string | null;\n  fitzpatrickSkinType?: HealthFitzpatrickSkinType | null;\n  wheelchairUse?: HealthWheelchairUse | null;\n  /**\n   * Indicates whether the platform exposes these characteristics via the plugin (true on iOS, false on Android).\n   */\n  platformSupported?: boolean;\n  /**\n   * Optional platform-specific message; on Android we return a user-facing note explaining that values remain empty unless synced from iOS.\n   */\n  platformMessage?: string;\n}\n\nexport type HealthBiologicalSex = 'female' | 'male' | 'other' | 'not_set' | 'unknown';\n\nexport type HealthBloodType =\n  | 'a-positive'\n  | 'a-negative'\n  | 'b-positive'\n  | 'b-negative'\n  | 'ab-positive'\n  | 'ab-negative'\n  | 'o-positive'\n  | 'o-negative'\n  | 'not_set'\n  | 'unknown';\n\nexport type HealthFitzpatrickSkinType = 'type1' | 'type2' | 'type3' | 'type4' | 'type5' | 'type6' | 'not_set' | 'unknown';\n\nexport type HealthWheelchairUse = 'wheelchair_user' | 'not_wheelchair_user' | 'not_set' | 'unknown';\n"]}

package/ios/Sources/HealthPluginPlugin/HealthPlugin.swift

@@ -18,7 +18,8 @@ public class HealthPlugin: CAPPlugin, CAPBridgedPlugin {
         CAPPluginMethod(name: "openAppleHealthSettings", returnType: CAPPluginReturnPromise),
         CAPPluginMethod(name: "queryAggregated", returnType: CAPPluginReturnPromise),
         CAPPluginMethod(name: "queryWorkouts", returnType: CAPPluginReturnPromise),
-        CAPPluginMethod(name: "queryLatestSample", returnType: CAPPluginReturnPromise)
+        CAPPluginMethod(name: "queryLatestSample", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "getCharacteristics", returnType: CAPPluginReturnPromise)
     ]
     
     let healthStore = HKHealthStore()
@@ -96,6 +97,47 @@ public class HealthPlugin: CAPPlugin, CAPBridgedPlugin {
         }
     }
 
+    @objc func getCharacteristics(_ call: CAPPluginCall) {
+        var result: [String: Any] = [:]
+
+        func setValue(_ key: String, _ value: String?) {
+            result[key] = value ?? NSNull()
+        }
+
+        if let biologicalSexObject = try? healthStore.biologicalSex() {
+            setValue("biologicalSex", mapBiologicalSex(biologicalSexObject.biologicalSex))
+        } else {
+            setValue("biologicalSex", nil)
+        }
+
+        if let bloodTypeObject = try? healthStore.bloodType() {
+            setValue("bloodType", mapBloodType(bloodTypeObject.bloodType))
+        } else {
+            setValue("bloodType", nil)
+        }
+
+        if let dateComponents = try? healthStore.dateOfBirthComponents() {
+            setValue("dateOfBirth", isoBirthDateString(from: dateComponents))
+        } else {
+            setValue("dateOfBirth", nil)
+        }
+
+        if let fitzpatrickObject = try? healthStore.fitzpatrickSkinType() {
+            setValue("fitzpatrickSkinType", mapFitzpatrickSkinType(fitzpatrickObject.skinType))
+        } else {
+            setValue("fitzpatrickSkinType", nil)
+        }
+
+        if let wheelchairUseObject = try? healthStore.wheelchairUse() {
+            setValue("wheelchairUse", mapWheelchairUse(wheelchairUseObject.wheelchairUse))
+        } else {
+            setValue("wheelchairUse", nil)
+        }
+
+        result["platformSupported"] = true
+        call.resolve(result)
+    }
+
     @objc func queryLatestSample(_ call: CAPPluginCall) {
         guard let dataTypeString = call.getString("dataType") else {
             call.reject("Missing data type")
@@ -473,6 +515,16 @@ public class HealthPlugin: CAPPlugin, CAPBridgedPlugin {
             return [HKObjectType.categoryType(forIdentifier: .sleepAnalysis)!].compactMap { $0 }
         case "READ_EXERCISE_TIME":
             return [HKObjectType.quantityType(forIdentifier: .appleExerciseTime)].compactMap { $0 }
+        case "READ_BIOLOGICAL_SEX":
+            return [HKObjectType.characteristicType(forIdentifier: .biologicalSex)].compactMap { $0 }
+        case "READ_BLOOD_TYPE":
+            return [HKObjectType.characteristicType(forIdentifier: .bloodType)].compactMap { $0 }
+        case "READ_DATE_OF_BIRTH":
+            return [HKObjectType.characteristicType(forIdentifier: .dateOfBirth)].compactMap { $0 }
+        case "READ_FITZPATRICK_SKIN_TYPE":
+            return [HKObjectType.characteristicType(forIdentifier: .fitzpatrickSkinType)].compactMap { $0 }
+        case "READ_WHEELCHAIR_USE":
+            return [HKObjectType.characteristicType(forIdentifier: .wheelchairUse)].compactMap { $0 }
         // Add common alternative permission names
         case "steps":
             return [HKObjectType.quantityType(forIdentifier: .stepCount)].compactMap{$0}
@@ -534,6 +586,94 @@ public class HealthPlugin: CAPPlugin, CAPBridgedPlugin {
             return []
         }
     }
+
+    private func mapBiologicalSex(_ biologicalSex: HKBiologicalSex) -> String {
+        switch biologicalSex {
+        case .female:
+            return "female"
+        case .male:
+            return "male"
+        case .other:
+            return "other"
+        case .notSet:
+            return "not_set"
+        @unknown default:
+            return "unknown"
+        }
+    }
+
+    private func mapBloodType(_ bloodType: HKBloodType) -> String {
+        switch bloodType {
+        case .aPositive:
+            return "a-positive"
+        case .aNegative:
+            return "a-negative"
+        case .bPositive:
+            return "b-positive"
+        case .bNegative:
+            return "b-negative"
+        case .abPositive:
+            return "ab-positive"
+        case .abNegative:
+            return "ab-negative"
+        case .oPositive:
+            return "o-positive"
+        case .oNegative:
+            return "o-negative"
+        case .notSet:
+            return "not_set"
+        @unknown default:
+            return "unknown"
+        }
+    }
+
+    private func mapFitzpatrickSkinType(_ skinType: HKFitzpatrickSkinType) -> String {
+        switch skinType {
+        case .I:
+            return "type1"
+        case .II:
+            return "type2"
+        case .III:
+            return "type3"
+        case .IV:
+            return "type4"
+        case .V:
+            return "type5"
+        case .VI:
+            return "type6"
+        case .notSet:
+            return "not_set"
+        @unknown default:
+            return "unknown"
+        }
+    }
+
+    private func mapWheelchairUse(_ wheelchairUse: HKWheelchairUse) -> String {
+        switch wheelchairUse {
+        case .yes:
+            return "wheelchair_user"
+        case .no:
+            return "not_wheelchair_user"
+        case .notSet:
+            return "not_set"
+        @unknown default:
+            return "unknown"
+        }
+    }
+
+    private func isoBirthDateString(from components: DateComponents) -> String? {
+        var calendar = Calendar(identifier: .gregorian)
+        calendar.timeZone = TimeZone(secondsFromGMT: 0) ?? TimeZone.current
+        guard let date = calendar.date(from: components) else {
+            return nil
+        }
+        let formatter = DateFormatter()
+        formatter.calendar = calendar
+        formatter.locale = Locale(identifier: "en_US_POSIX")
+        formatter.timeZone = calendar.timeZone
+        formatter.dateFormat = "yyyy-MM-dd"
+        return formatter.string(from: date)
+    }
     
     func aggregateTypeToHKQuantityType(_ dataType: String) -> HKQuantityType? {
         switch dataType {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flomentumsolutions/capacitor-health-extended",
-  "version": "0.4.5",
+  "version": "0.6.1",
   "description": "Capacitor plugin for Apple HealthKit and Google Health Connect Platform",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",