@ovok/native 1.10.13 → 1.10.15

package/lib/module/modules/data-sync/utils/health-data-catalog.js

@@ -2,11 +2,14 @@
 
 /* eslint-disable max-lines */
 
+import { LOINC_SYSTEM } from "./fhir-systems.js";
 import { healthUnitFor } from "./health-units.js";
 const HEALTH_CONNECT_PERMISSION_PREFIX = "android.permission.health.READ_";
 const HEALTH_CONNECT_CODE_SYSTEM = "urn:ovok:health-connect:record-type";
 const HEALTH_CONNECT_MEDICAL_CODE_SYSTEM = "urn:ovok:health-connect:medical-resource-type";
 const HEALTHKIT_CODE_SYSTEM = "urn:ovok:healthkit:sample-type";
+const HEALTH_CONNECT_UNSUPPORTED_STRATEGY = "not exposed by the pinned react-native-health-connect wrapper";
+const HEALTH_CONNECT_DATATYPES_DOCS = "https://developer.android.com/reference/android/health/connect/datatypes/";
 const APPLE_HEALTH_IDENTIFIERS = {
   height: "HKQuantityTypeIdentifierHeight",
   bodyMass: "HKQuantityTypeIdentifierBodyMass",
@@ -20,89 +23,45 @@ const APPLE_HEALTH_IDENTIFIERS = {
   respiratoryRate: "HKQuantityTypeIdentifierRespiratoryRate",
   stepCount: "HKQuantityTypeIdentifierStepCount"
 };
+/** A reviewed LOINC 2.83 term, valid in point mode only. */
+const loinc = (code, display) => ({
+  code,
+  display,
+  release: "2.83",
+  status: "Active",
+  sourceUrl: `https://loinc.org/${code}`,
+  modes: ["point"]
+});
 const appleLoincMappings = {
-  [APPLE_HEALTH_IDENTIFIERS.height]: {
-    code: "8302-2",
-    display: "Body height",
-    release: "2.83",
-    status: "Active",
-    sourceUrl: "https://loinc.org/8302-2",
-    modes: ["point"]
-  },
-  [APPLE_HEALTH_IDENTIFIERS.bodyMass]: {
-    code: "29463-7",
-    display: "Body weight",
-    release: "2.83",
-    status: "Active",
-    sourceUrl: "https://loinc.org/29463-7",
-    modes: ["point"]
-  },
-  [APPLE_HEALTH_IDENTIFIERS.bodyMassIndex]: {
-    code: "39156-5",
-    display: "Body mass index (BMI) [Ratio]",
-    release: "2.83",
-    status: "Active",
-    sourceUrl: "https://loinc.org/39156-5",
-    modes: ["point"]
-  },
-  [APPLE_HEALTH_IDENTIFIERS.bodyTemperature]: {
-    code: "8310-5",
-    display: "Body temperature",
-    release: "2.83",
-    status: "Active",
-    sourceUrl: "https://loinc.org/8310-5",
-    modes: ["point"]
-  },
-  [APPLE_HEALTH_IDENTIFIERS.systolicBloodPressure]: {
-    code: "8480-6",
-    display: "Systolic blood pressure",
-    release: "2.83",
-    status: "Active",
-    sourceUrl: "https://loinc.org/8480-6",
-    modes: ["point"]
-  },
-  [APPLE_HEALTH_IDENTIFIERS.diastolicBloodPressure]: {
-    code: "8462-4",
-    display: "Diastolic blood pressure",
-    release: "2.83",
-    status: "Active",
-    sourceUrl: "https://loinc.org/8462-4",
-    modes: ["point"]
-  },
-  [APPLE_HEALTH_IDENTIFIERS.heartRate]: {
-    code: "8867-4",
-    display: "Heart rate",
-    release: "2.83",
-    status: "Active",
-    sourceUrl: "https://loinc.org/8867-4",
-    modes: ["point"]
-  },
-  [APPLE_HEALTH_IDENTIFIERS.restingHeartRate]: {
-    code: "40443-4",
-    display: "Heart rate --resting",
-    release: "2.83",
-    status: "Active",
-    sourceUrl: "https://loinc.org/40443-4",
-    modes: ["point"]
-  },
-  [APPLE_HEALTH_IDENTIFIERS.heartRateVariabilitySDNN]: {
-    code: "112429-6",
-    display: "Heart rate variability SDNN [Time]",
-    release: "2.83",
-    status: "Active",
-    sourceUrl: "https://loinc.org/112429-6",
-    modes: ["point"]
-  },
-  [APPLE_HEALTH_IDENTIFIERS.respiratoryRate]: {
-    code: "9279-1",
-    display: "Respiratory rate",
-    release: "2.83",
-    status: "Active",
-    sourceUrl: "https://loinc.org/9279-1",
-    modes: ["point"]
-  }
+  [APPLE_HEALTH_IDENTIFIERS.height]: loinc("8302-2", "Body height"),
+  [APPLE_HEALTH_IDENTIFIERS.bodyMass]: loinc("29463-7", "Body weight"),
+  [APPLE_HEALTH_IDENTIFIERS.bodyMassIndex]: loinc("39156-5", "Body mass index (BMI) [Ratio]"),
+  [APPLE_HEALTH_IDENTIFIERS.bodyTemperature]: loinc("8310-5", "Body temperature"),
+  [APPLE_HEALTH_IDENTIFIERS.systolicBloodPressure]: loinc("8480-6", "Systolic blood pressure"),
+  [APPLE_HEALTH_IDENTIFIERS.diastolicBloodPressure]: loinc("8462-4", "Diastolic blood pressure"),
+  [APPLE_HEALTH_IDENTIFIERS.heartRate]: loinc("8867-4", "Heart rate"),
+  [APPLE_HEALTH_IDENTIFIERS.restingHeartRate]: loinc("40443-4", "Heart rate --resting"),
+  [APPLE_HEALTH_IDENTIFIERS.heartRateVariabilitySDNN]: loinc("112429-6", "Heart rate variability SDNN [Time]"),
+  [APPLE_HEALTH_IDENTIFIERS.respiratoryRate]: loinc("9279-1", "Respiratory rate")
 };
 
+/** Supplies the per-platform envelope; `readPermission` defaults to the identifier. */
+
+const appleEntry = row => ({
+  provider: "apple-health",
+  sourceCodeSystem: HEALTHKIT_CODE_SYSTEM,
+  fhirResource: "Observation",
+  readPermission: row.identifier,
+  ...row
+});
+const healthConnectEntry = row => ({
+  provider: "health-connect",
+  sourceCodeSystem: HEALTH_CONNECT_CODE_SYSTEM,
+  fhirResource: "Observation",
+  readPermission: row.identifier,
+  ...row
+});
+
 // HKQuantityTypeIdentifier is type-only from the wrapper's shared native entry
 // point. Keep the 8.7.2 identifiers here so the catalog is complete on Android,
 // Jest, and other entry points where Object.values(enum) is empty.
@@ -122,206 +81,141 @@ const healthConnectLoincMappings = {
   Weight: appleLoincMappings[APPLE_HEALTH_IDENTIFIERS.bodyMass],
   RestingHeartRate: appleLoincMappings[APPLE_HEALTH_IDENTIFIERS.restingHeartRate],
   RespiratoryRate: appleLoincMappings[APPLE_HEALTH_IDENTIFIERS.respiratoryRate],
-  BodyWaterMass: {
-    code: "101683-1",
-    display: "Body water mass",
-    release: "2.83",
-    status: "Active",
-    sourceUrl: "https://loinc.org/101683-1",
-    modes: ["point"]
-  }
+  BodyWaterMass: loinc("101683-1", "Body water mass")
 };
-const appleSupportedSamples = [...appleQuantityIdentifiers.map(identifier => ({
-  provider: "apple-health",
+const appleSupportedSamples = [...appleQuantityIdentifiers.map(identifier => appleEntry({
   identifier,
   category: "quantity",
   shape: "sample",
-  readPermission: identifier,
   readStrategy: "Anchored HealthKit quantity query",
-  fhirResource: "Observation",
-  sourceCodeSystem: HEALTHKIT_CODE_SYSTEM,
   unit: identifier === APPLE_HEALTH_IDENTIFIERS.bodyMassIndex ? "count (serialized as kg/m2 for LOINC)" : healthUnitFor(identifier) ?? "HealthKit preferred unit",
   loincMapping: appleLoincMappings[identifier]
-})), ...appleCategoryIdentifiers.map(identifier => ({
-  provider: "apple-health",
+})), ...appleCategoryIdentifiers.map(identifier => appleEntry({
   identifier,
   category: "category",
   shape: "interval",
-  readPermission: identifier,
   readStrategy: "Anchored HealthKit category query",
-  fhirResource: "Observation",
-  sourceCodeSystem: HEALTHKIT_CODE_SYSTEM,
   unit: "not applicable",
   ...(identifier === "HKCategoryTypeIdentifierSleepApneaEvent" ? {
     platformDocumentationUrl: "https://developer.apple.com/documentation/healthkit/hkcategorytypeidentifier/sleepapneaevent",
     limitation: "HealthKit exposes this category only on compatible OS versions and devices; the pinned wrapper reads it through its generic category query, and query errors are reported through the normal sync error callback."
   } : {})
-})), ...appleCorrelationIdentifiers.map(identifier => ({
-  provider: "apple-health",
+})), ...appleCorrelationIdentifiers.map(identifier => appleEntry({
   identifier,
   category: "correlation",
   shape: "sample",
-  readPermission: identifier,
   readStrategy: "Non-anchored HealthKit date-window query",
-  fhirResource: "Observation",
-  sourceCodeSystem: HEALTHKIT_CODE_SYSTEM,
   unit: "record-specific",
   limitation: "This wrapper does not expose a correlation anchor or deleted-sample cursor."
-})), {
-  provider: "apple-health",
+})), appleEntry({
   identifier: "HKWorkoutTypeIdentifier",
   category: "workout",
   shape: "interval",
-  readPermission: "HKWorkoutTypeIdentifier",
   readStrategy: "Anchored HealthKit workout query",
-  fhirResource: "Observation",
-  sourceCodeSystem: HEALTHKIT_CODE_SYSTEM,
   unit: "record-specific"
-}, {
-  provider: "apple-health",
+}), appleEntry({
   identifier: "HKDataTypeIdentifierHeartbeatSeries",
   category: "series",
   shape: "series",
-  readPermission: "HKDataTypeIdentifierHeartbeatSeries",
   readStrategy: "Anchored HealthKit heartbeat-series query",
-  fhirResource: "Observation",
-  sourceCodeSystem: HEALTHKIT_CODE_SYSTEM,
   unit: "count/min"
-}, {
-  provider: "apple-health",
+}), appleEntry({
   identifier: "HKStateOfMindTypeIdentifier",
   category: "state of mind",
   shape: "sample",
-  readPermission: "HKStateOfMindTypeIdentifier",
   readStrategy: "Non-anchored HealthKit date-window query",
-  fhirResource: "Observation",
-  sourceCodeSystem: HEALTHKIT_CODE_SYSTEM,
   unit: "not applicable",
   limitation: "Requires iOS 18 or later; this wrapper does not expose an anchor or deleted-sample cursor."
-}];
-const appleExcludedTypes = [...[["HKScoredAssessmentTypeIdentifierGAD7", "GAD-7 assessment"], ["HKScoredAssessmentTypeIdentifierPHQ9", "PHQ-9 assessment"]].map(([identifier, display]) => ({
-  provider: "apple-health",
+})];
+const appleExcludedTypes = [...[["HKScoredAssessmentTypeIdentifierGAD7", "GAD-7 assessment"], ["HKScoredAssessmentTypeIdentifierPHQ9", "PHQ-9 assessment"]].map(([identifier, display]) => appleEntry({
   identifier,
   category: "scored assessment",
   shape: "sample",
-  readPermission: identifier,
   readStrategy: "not exposed by the pinned wrapper",
   fhirResource: "FHIR resource",
-  sourceCodeSystem: HEALTHKIT_CODE_SYSTEM,
   platformDocumentationUrl: `https://developer.apple.com/documentation/healthkit/hkscoredassessmenttypeidentifier/${identifier.endsWith("GAD7") ? "gad7" : "phq9"}`,
   unit: "assessment score",
   limitation: `${display} is a public HealthKit scored-assessment type, but the pinned wrapper does not construct its type, query it, or preserve its assessment answers. The SDK cannot yet import it as a semantically complete FHIR resource.`
-})), {
-  provider: "apple-health",
+})), appleEntry({
   identifier: "HKDataTypeIdentifierUserAnnotatedMedicationConcept",
   category: "medication concept",
   shape: "sample",
-  readPermission: "HKDataTypeIdentifierUserAnnotatedMedicationConcept",
   readStrategy: "not exposed by the pinned wrapper",
   fhirResource: "FHIR resource",
-  sourceCodeSystem: HEALTHKIT_CODE_SYSTEM,
   platformDocumentationUrl: "https://developer.apple.com/documentation/healthkit/hkdatatypeidentifieruserannotatedmedicationconcept",
   unit: "not applicable",
   limitation: "HealthKit exposes user-annotated medication concepts, but the pinned wrapper does not construct this sample type or expose its query and medication-concept serializer."
-}, {
-  provider: "apple-health",
+}), appleEntry({
   identifier: "HKMedicationDoseEventTypeIdentifierMedicationDoseEvent",
   category: "medication dose event",
   shape: "sample",
-  readPermission: "HKMedicationDoseEventTypeIdentifierMedicationDoseEvent",
   readStrategy: "not exposed by the pinned wrapper",
   fhirResource: "FHIR resource",
-  sourceCodeSystem: HEALTHKIT_CODE_SYSTEM,
   platformDocumentationUrl: "https://developer.apple.com/documentation/healthkit/hkmedicationdoseeventtypeidentifiermedicationdoseevent",
   unit: "medication-specific dose",
   limitation: "HealthKit exposes medication dose events, but the pinned wrapper does not construct this sample type, query it, or map its dose/status fields to a FHIR MedicationAdministration."
-}, {
-  provider: "apple-health",
+}), appleEntry({
   identifier: "HKElectrocardiogramType",
   category: "electrocardiogram",
   shape: "series",
   readPermission: "HKObjectType.electrocardiogramType()",
   readStrategy: "not exposed by the pinned wrapper",
-  fhirResource: "Observation",
-  sourceCodeSystem: HEALTHKIT_CODE_SYSTEM,
   unit: "ECG samples",
   limitation: "HealthKit exposes read-only ECG samples, but the pinned wrapper does not expose an ECG query or voltage-series serializer."
-}, ...["AllergyRecord", "ClinicalNoteRecord", "ConditionRecord", "ImmunizationRecord", "LabResultRecord", "MedicationRecord", "ProcedureRecord", "VitalSignRecord", "CoverageRecord"].map(type => ({
-  provider: "apple-health",
+}), ...["AllergyRecord", "ClinicalNoteRecord", "ConditionRecord", "ImmunizationRecord", "LabResultRecord", "MedicationRecord", "ProcedureRecord", "VitalSignRecord", "CoverageRecord"].map(type => appleEntry({
   identifier: `HKClinicalTypeIdentifier${type}`,
   category: "clinical record",
   shape: "sample",
   readPermission: `HKObjectType.clinicalType(forIdentifier: .${type[0]?.toLowerCase()}${type.slice(1)})`,
   readStrategy: "not exposed by the pinned wrapper",
   fhirResource: "FHIR resource",
-  sourceCodeSystem: HEALTHKIT_CODE_SYSTEM,
   unit: "FHIR JSON",
   limitation: "HealthKit clinical records contain source FHIR resources and require per-type authorization; the pinned wrapper exposes neither the query nor FHIR-resource serializer."
-})), {
-  provider: "apple-health",
+})), appleEntry({
   identifier: "HKDocumentTypeIdentifierCDA",
   category: "clinical document",
   shape: "sample",
   readPermission: "HKObjectType.documentType(forIdentifier: .CDA)",
   readStrategy: "not exposed by the pinned wrapper",
   fhirResource: "FHIR resource",
-  sourceCodeSystem: HEALTHKIT_CODE_SYSTEM,
   unit: "CDA document",
   limitation: "The pinned wrapper does not expose HealthKit document queries or a CDA document importer."
-}, {
-  provider: "apple-health",
+}), appleEntry({
   identifier: "HKVisionPrescriptionTypeIdentifier",
   category: "vision prescription",
   shape: "sample",
   readPermission: "HKObjectType.visionPrescriptionType()",
   readStrategy: "not exposed by the pinned wrapper",
-  fhirResource: "Observation",
-  sourceCodeSystem: HEALTHKIT_CODE_SYSTEM,
   unit: "prescription-specific",
   limitation: "The pinned wrapper does not expose HealthKit vision-prescription queries or a prescription serializer."
-}, {
-  provider: "apple-health",
+}), appleEntry({
   identifier: "HKActivitySummaryTypeIdentifier",
   category: "activity summary",
   shape: "sample",
-  readPermission: "HKActivitySummaryTypeIdentifier",
   readStrategy: "not exposed by the pinned wrapper",
-  fhirResource: "Observation",
-  sourceCodeSystem: HEALTHKIT_CODE_SYSTEM,
   unit: "record-specific",
   limitation: "The pinned wrapper does not expose an activity-summary query."
-}, {
-  provider: "apple-health",
+}), appleEntry({
   identifier: "HKAudiogramSampleType",
   category: "audiogram",
   shape: "sample",
-  readPermission: "HKAudiogramSampleType",
   readStrategy: "not exposed by the pinned wrapper",
-  fhirResource: "Observation",
-  sourceCodeSystem: HEALTHKIT_CODE_SYSTEM,
   unit: "record-specific",
   limitation: "The pinned wrapper does not expose an audiogram query or serializer."
-}, {
-  provider: "apple-health",
+}), appleEntry({
   identifier: "HKWorkoutRouteTypeIdentifier",
   category: "workout route",
   shape: "series",
-  readPermission: "HKWorkoutRouteTypeIdentifier",
   readStrategy: "getWorkoutRoutes(workoutUUID)",
-  fhirResource: "Observation",
-  sourceCodeSystem: HEALTHKIT_CODE_SYSTEM,
   unit: "geographic coordinates",
   limitation: "The wrapper requires a known workout UUID and the route is not a pageable sample query; routes are excluded from automatic import."
-}];
-const appleCharacteristics = appleCharacteristicTypes.map(([identifier, readStrategy]) => ({
-  provider: "apple-health",
+})];
+const appleCharacteristics = appleCharacteristicTypes.map(([identifier, readStrategy]) => appleEntry({
   identifier,
   category: "characteristic",
   shape: "characteristic",
-  readPermission: identifier,
   readStrategy,
   fhirResource: "Patient",
-  sourceCodeSystem: HEALTHKIT_CODE_SYSTEM,
   unit: "not applicable",
   limitation: "Characteristics are not HKSampleType values and are not accepted by dataToSync; they need a separate Patient mapping."
 }));
@@ -335,15 +229,12 @@ const readPermissionOverrides = {
   MenstruationPeriod: "MENSTRUATION",
   StepsCadence: "STEPS"
 };
-const healthConnectCatalog = healthConnectRecords.map(([identifier, category, shape, permission, unit]) => ({
-  provider: "health-connect",
+const healthConnectCatalog = healthConnectRecords.map(([identifier, category, shape, permission, unit]) => healthConnectEntry({
   identifier,
   category,
   shape,
   readPermission: `${HEALTH_CONNECT_PERMISSION_PREFIX}${readPermissionOverrides[identifier] ?? permission}`,
   readStrategy: "readRecords pages followed by the Health Connect changes feed",
-  fhirResource: "Observation",
-  sourceCodeSystem: HEALTH_CONNECT_CODE_SYSTEM,
   unit,
   loincMapping: healthConnectLoincMappings[identifier]
 }));
@@ -352,49 +243,39 @@ const healthConnectCatalog = healthConnectRecords.map(([identifier, category, sh
 // wrapper's RecordType/readRecords implementation. Keep one row per symptom
 // value because Android requires a distinct read permission for each one.
 const healthConnectApi37SymptomTypes = ["ABDOMINAL_PAIN", "ACNE", "BACK_PAIN", "BLOATING", "BRAIN_FOG", "BREAST_TENDERNESS", "BRITTLE_NAILS", "BURNING_MOUTH", "CHEST_PAIN", "CHEST_TIGHTNESS", "CHILLS", "CONSTIPATION", "COUGH", "CRAMPS", "CRAVINGS", "DEHYDRATION", "DIARRHEA", "DIFFICULTY_SWALLOWING", "DIZZINESS", "DRY_SKIN", "EARACHES", "FATIGUE", "FEVER", "GENERALIZED_BODY_ACHE", "HAIR_LOSS", "HEADACHE", "HEARTBURN", "HEART_PALPITATIONS", "HOT_FLASHES", "INSOMNIA", "JOINT_PAIN", "JOINT_STIFFNESS", "LOSS_OF_APPETITE", "LOSS_OF_CONSCIOUSNESS", "LOWER_BACK_PAIN", "MEMORY_LAPSE", "MOOD_CHANGE", "MUSCLE_PAIN", "NAUSEA", "NIGHT_SWEATS", "PELVIC_PAIN", "RAPID_POUNDING_OR_FLUTTERING_HEARTBEAT", "REDUCED_CAPACITY_FOR_EXERCISE", "RUNNY_NOSE", "SHORTNESS_OF_BREATH", "SKIPPED_HEARTBEAT", "SLEEPINESS", "SLEEP_CHANGES", "SNEEZING", "SNORE", "SORE_THROAT", "STOMACH_ACHE", "STUFFY_NOSE", "UNEXPLAINED_WEIGHT_CHANGES", "UNKNOWN", "VAGINAL_DRYNESS", "VAGINAL_ITCHINESS", "VOMITING", "WATER_RETENTION", "WHEEZING"];
-const healthConnectApi37UnsupportedTypes = [{
-  provider: "health-connect",
+const healthConnectApi37UnsupportedTypes = [healthConnectEntry({
   identifier: "AlcoholConsumption",
   category: "unsupported platform type",
   shape: "sample",
   readPermission: `${HEALTH_CONNECT_PERMISSION_PREFIX}ALCOHOL_CONSUMPTION`,
-  readStrategy: "not exposed by the pinned react-native-health-connect wrapper",
+  readStrategy: HEALTH_CONNECT_UNSUPPORTED_STRATEGY,
   timeSemantics: "instant, interval, or local date",
-  fhirResource: "Observation",
-  sourceCodeSystem: HEALTH_CONNECT_CODE_SYSTEM,
-  platformDocumentationUrl: "https://developer.android.com/reference/android/health/connect/datatypes/AlcoholConsumptionRecord",
+  platformDocumentationUrl: `${HEALTH_CONNECT_DATATYPES_DOCS}AlcoholConsumptionRecord`,
   unit: "servings, serving volume, alcohol by volume",
   limitation: "AlcoholConsumptionRecord was added in Android API 37 / U Extensions 21, but pinned react-native-health-connect 3.5.3 (connect-client 1.1.0-alpha11) has no RecordType or readRecords mapping for it. It is not selectable or importable through this adapter."
-}, {
-  provider: "health-connect",
+}), healthConnectEntry({
   identifier: "MenstrualCyclePhase",
   category: "unsupported platform type",
   shape: "sample",
   readPermission: `${HEALTH_CONNECT_PERMISSION_PREFIX}MENSTRUAL_CYCLE_PHASE`,
-  readStrategy: "not exposed by the pinned react-native-health-connect wrapper",
+  readStrategy: HEALTH_CONNECT_UNSUPPORTED_STRATEGY,
   timeSemantics: "local date",
-  fhirResource: "Observation",
-  sourceCodeSystem: HEALTH_CONNECT_CODE_SYSTEM,
-  platformDocumentationUrl: "https://developer.android.com/reference/android/health/connect/datatypes/MenstrualCyclePhaseRecord",
+  platformDocumentationUrl: `${HEALTH_CONNECT_DATATYPES_DOCS}MenstrualCyclePhaseRecord`,
   unit: "cycle phase and optional day of cycle",
   limitation: "MenstrualCyclePhaseRecord was added in Android API 37 / U Extensions 22, but pinned react-native-health-connect 3.5.3 (connect-client 1.1.0-alpha11) has no RecordType or readRecords mapping for it. It is not selectable or importable through this adapter."
-}, ...healthConnectApi37SymptomTypes.map(symptomType => ({
-  provider: "health-connect",
+}), ...healthConnectApi37SymptomTypes.map(symptomType => healthConnectEntry({
   identifier: `SymptomRecord:${symptomType}`,
   category: "unsupported platform type",
   shape: "sample",
   readPermission: `${HEALTH_CONNECT_PERMISSION_PREFIX}SYMPTOM_${symptomType}`,
-  readStrategy: "not exposed by the pinned react-native-health-connect wrapper",
+  readStrategy: HEALTH_CONNECT_UNSUPPORTED_STRATEGY,
   timeSemantics: "instant, interval, or local date",
-  fhirResource: "Observation",
-  sourceCodeSystem: HEALTH_CONNECT_CODE_SYSTEM,
-  platformDocumentationUrl: "https://developer.android.com/reference/android/health/connect/datatypes/SymptomRecord",
+  platformDocumentationUrl: `${HEALTH_CONNECT_DATATYPES_DOCS}SymptomRecord`,
   unit: "count, severity, and optional notes",
   limitation: "SymptomRecord was added in Android API 37 / U Extensions 21. Android requires a distinct READ_SYMPTOM_* permission for each symptom type; pinned react-native-health-connect 3.5.3 (connect-client 1.1.0-alpha11) has no RecordType or readRecords mapping, so this value is not selectable or importable through the adapter."
 }))];
 const healthConnectMedicalResourceTypes = [["ALLERGIES_INTOLERANCES", "AllergyIntolerance", "Allergies and intolerances"], ["CONDITIONS", "Condition", "Conditions"], ["LABORATORY_RESULTS", "Observation", "Laboratory results"], ["MEDICATIONS", "Medication / MedicationRequest / MedicationStatement", "Medications"], ["PERSONAL_DETAILS", "Patient", "Personal details"], ["PRACTITIONER_DETAILS", "Practitioner / PractitionerRole", "Practitioner details"], ["PREGNANCY", "Observation", "Pregnancy observations"], ["PROCEDURES", "Procedure", "Procedures"], ["SOCIAL_HISTORY", "Observation", "Social history"], ["VACCINES", "Immunization", "Vaccines"], ["VISITS", "Encounter / Location / Organization", "Visits"], ["VITAL_SIGNS", "Observation", "Vital signs"]];
-const healthConnectMedicalResources = healthConnectMedicalResourceTypes.map(([type, fhirResource, display]) => ({
-  provider: "health-connect",
+const healthConnectMedicalResources = healthConnectMedicalResourceTypes.map(([type, fhirResource, display]) => healthConnectEntry({
   identifier: `MedicalResourceType:${type}`,
   category: "unsupported platform resource",
   shape: "document",
@@ -407,67 +288,50 @@ const healthConnectMedicalResources = healthConnectMedicalResourceTypes.map(([ty
   unit: "not applicable",
   limitation: `${display} are Health Connect MedicalResource FHIR ${fhirResource} data, not scalar observations to recode. The pinned react-native-health-connect 3.5.3 wrapper does not expose readMedicalResources or the Medical Records permission/feature flow. Preserve embedded FHIR codings (including any LOINC coding) when this API is added; do not assign a LOINC code to the resource type.`
 }));
-const healthConnectSpecialTypes = [{
-  provider: "health-connect",
-  identifier: "ActivityIntensity",
-  category: "unsupported platform type",
-  shape: "interval",
-  readPermission: "android.permission.health.READ_ACTIVITY_INTENSITY",
-  readStrategy: "not exposed by the pinned react-native-health-connect wrapper",
-  fhirResource: "Observation",
-  sourceCodeSystem: HEALTH_CONNECT_CODE_SYSTEM,
-  platformDocumentationUrl: "https://developer.android.com/reference/android/health/connect/datatypes/ActivityIntensityRecord",
-  unit: "duration by intensity",
-  limitation: "The current Health Connect catalog defines ActivityIntensityRecord with this read permission and FEATURE_ACTIVITY_INTENSITY, but pinned react-native-health-connect 3.5.3 omits it from RecordType and readRecords. It is not selectable or importable until the adapter supports it."
-}, {
-  provider: "health-connect",
-  identifier: "MindfulnessSession",
-  category: "unsupported platform type",
-  shape: "interval",
-  readPermission: "android.permission.health.READ_MINDFULNESS",
-  readStrategy: "not exposed by the pinned react-native-health-connect wrapper",
-  fhirResource: "Observation",
-  sourceCodeSystem: HEALTH_CONNECT_CODE_SYSTEM,
-  platformDocumentationUrl: "https://developer.android.com/reference/android/health/connect/datatypes/MindfulnessSessionRecord",
-  unit: "duration and session type",
-  limitation: "The current Health Connect catalog defines MindfulnessSessionRecord with this read permission and FEATURE_MINDFULNESS_SESSION, but pinned react-native-health-connect 3.5.3 omits it from RecordType and readRecords. It is not selectable or importable until the adapter supports it."
-}, {
-  provider: "health-connect",
-  identifier: "PlannedExerciseSession",
-  category: "unsupported platform type",
-  shape: "interval",
-  readPermission: "android.permission.health.READ_PLANNED_EXERCISE",
-  readStrategy: "not exposed by the pinned react-native-health-connect wrapper",
-  fhirResource: "FHIR resource",
-  sourceCodeSystem: HEALTH_CONNECT_CODE_SYSTEM,
-  platformDocumentationUrl: "https://developer.android.com/reference/android/health/connect/datatypes/PlannedExerciseSessionRecord",
-  unit: "planned exercise details",
-  limitation: "The current Health Connect catalog defines PlannedExerciseSessionRecord with this read permission and FEATURE_PLANNED_EXERCISE, but pinned react-native-health-connect 3.5.3 omits it from RecordType and readRecords. It is not selectable or importable until the adapter supports it."
-}, {
-  provider: "health-connect",
-  identifier: "SkinTemperature",
+
+// Defined by the current Health Connect catalog, but missing from the pinned wrapper's RecordType/readRecords.
+const unsupportedHealthConnectTypes = [["ActivityIntensity", "interval", "ACTIVITY_INTENSITY", "ACTIVITY_INTENSITY", "duration by intensity"], ["MindfulnessSession", "interval", "MINDFULNESS", "MINDFULNESS_SESSION", "duration and session type"], ["PlannedExerciseSession", "interval", "PLANNED_EXERCISE", "PLANNED_EXERCISE", "planned exercise details"], ["SkinTemperature", "series", "SKIN_TEMPERATURE", "SKIN_TEMPERATURE", "temperature deltas"]].map(([identifier, shape, permission, feature, unit]) => healthConnectEntry({
+  identifier,
   category: "unsupported platform type",
-  shape: "series",
-  readPermission: "android.permission.health.READ_SKIN_TEMPERATURE",
-  readStrategy: "not exposed by the pinned react-native-health-connect wrapper",
-  fhirResource: "Observation",
-  sourceCodeSystem: HEALTH_CONNECT_CODE_SYSTEM,
-  platformDocumentationUrl: "https://developer.android.com/reference/android/health/connect/datatypes/SkinTemperatureRecord",
-  unit: "temperature deltas",
-  limitation: "The current Health Connect catalog defines SkinTemperatureRecord with this read permission and FEATURE_SKIN_TEMPERATURE, but pinned react-native-health-connect 3.5.3 omits it from RecordType and readRecords. It is not selectable or importable until the adapter supports it."
-}, {
-  provider: "health-connect",
+  shape,
+  readPermission: `${HEALTH_CONNECT_PERMISSION_PREFIX}${permission}`,
+  readStrategy: HEALTH_CONNECT_UNSUPPORTED_STRATEGY,
+  fhirResource: identifier === "PlannedExerciseSession" ? "FHIR resource" : "Observation",
+  platformDocumentationUrl: `${HEALTH_CONNECT_DATATYPES_DOCS}${identifier}Record`,
+  unit,
+  limitation: `The current Health Connect catalog defines ${identifier}Record with this read permission and FEATURE_${feature}, but pinned react-native-health-connect 3.5.3 omits it from RecordType and readRecords. It is not selectable or importable until the adapter supports it.`
+}));
+const healthConnectSpecialTypes = [...unsupportedHealthConnectTypes, healthConnectEntry({
   identifier: "ExerciseRoute",
   category: "route",
   shape: "series",
   readPermission: "per-session Health Connect consent dialog",
   readStrategy: "ExerciseSessionRecord.exerciseRoute / requestExerciseRoute(recordId)",
-  fhirResource: "Observation",
-  sourceCodeSystem: HEALTH_CONNECT_CODE_SYSTEM,
   unit: "geographic coordinates",
   limitation: "Routes are returned with exercise sessions only when the user grants per-session route access; the SDK does not expose a standalone route selector or requestExerciseRoute flow."
-}, ...healthConnectApi37UnsupportedTypes, ...healthConnectMedicalResources];
+}), ...healthConnectApi37UnsupportedTypes, ...healthConnectMedicalResources];
 const catalogEntries = [...appleSupportedSamples, ...appleExcludedTypes, ...appleCharacteristics, ...healthConnectCatalog, ...healthConnectSpecialTypes];
+const BODY_FAT_LIMITATION = "Not mapped: LOINC 41982-0 specifies the Measured method, but neither platform record type establishes how the body-fat percentage was derived.";
+const STEPS_LIMITATION = "Not mapped: the default daily-total result is a local-calendar-day count, while LOINC 41950-7 is a 24-hour count rate with UCUM unit {#}/(24.h). The local day can be shorter or longer at daylight-saving transitions; individual source intervals are not asserted to be a 24-hour rate either.";
+const GLUCOSE_LIMITATION = "Not mapped: the platform type alone does not guarantee a compatible specimen, method, and unit combination for one LOINC glucose term.";
+
+// Per-type reasons keyed "<provider>:<identifier>"; checked before the category and shape fallbacks.
+const LOINC_LIMITATION_BY_KEY = {
+  "apple-health:HKQuantityTypeIdentifierBodyFatPercentage": BODY_FAT_LIMITATION,
+  "health-connect:BodyFat": BODY_FAT_LIMITATION,
+  [`apple-health:${APPLE_HEALTH_IDENTIFIERS.stepCount}`]: STEPS_LIMITATION,
+  "health-connect:Steps": STEPS_LIMITATION,
+  "health-connect:BloodGlucose": GLUCOSE_LIMITATION,
+  "apple-health:HKQuantityTypeIdentifierBloodGlucose": GLUCOSE_LIMITATION,
+  "health-connect:BloodPressure": "Not mapped: this is a composite systolic/diastolic record. The importer must emit the paired component Observations (or a correctly coded panel) instead of attaching one code to the serialized record.",
+  "health-connect:HeartRateVariabilityRmssd": "Not mapped: this source is RMSSD; it must not be coded as the distinct SDNN measure (LOINC 112429-6).",
+  "health-connect:HeartRate": "Not mapped: Health Connect HeartRateRecord is a series of samples, but the point converter currently preserves that array as a structured value instead of emitting one Observation per sample; a point heart-rate LOINC code would misstate the output.",
+  "health-connect:BodyTemperature": "Not mapped: Health Connect exposes temperature as a structured value and includes a measurement location. The generic Observation converter does not yet normalize that value to a numeric UCUM quantity or preserve the location in bodySite.",
+  "health-connect:SleepSession": "Not mapped: the current session value is elapsed session duration, not total time asleep; sleep stages can include awake intervals.",
+  "health-connect:BasalMetabolicRate": "Not mapped: the source value is power (W), while the matching LOINC candidate is a basal metabolic rate index; these representations are not interchangeable.",
+  "health-connect:Vo2Max": "Not mapped: Health Connect exposes VO2 max using several measurement methods (including field-test estimates), while LOINC 94122-9 is specifically peak VO2 during exercise. The source method is retained, but this record does not guarantee that narrower concept.",
+  "apple-health:HKQuantityTypeIdentifierVO2Max": "Not mapped: Apple Watch VO2 max is estimated from sub-maximal outdoor walking/running data, while LOINC 94122-9 denotes peak VO2 during exercise. HealthKit also permits clinic-created samples, so the platform identifier alone cannot establish that method."
+};
 const getLoincLimitation = entry => {
   if (entry.sourceCodeSystem === HEALTH_CONNECT_MEDICAL_CODE_SYSTEM) {
     return "Not mapped: a MedicalResource is already a FHIR resource; preserve its embedded terminology codings instead of assigning a LOINC code to the resource type.";
@@ -478,38 +342,9 @@ const getLoincLimitation = entry => {
   if (entry.provider === "health-connect" && ["AlcoholConsumption", "MenstrualCyclePhase"].includes(entry.identifier)) {
     return `Not mapped: Health Connect ${entry.identifier} is a structured, coded platform record and the pinned adapter does not import it into a type-specific FHIR representation.`;
   }
-  if (entry.provider === "apple-health" && entry.identifier === "HKQuantityTypeIdentifierBodyFatPercentage" || entry.provider === "health-connect" && entry.identifier === "BodyFat") {
-    return "Not mapped: LOINC 41982-0 specifies the Measured method, but neither platform record type establishes how the body-fat percentage was derived.";
-  }
-  if (entry.identifier === APPLE_HEALTH_IDENTIFIERS.stepCount || entry.provider === "health-connect" && entry.identifier === "Steps") {
-    return "Not mapped: the default daily-total result is a local-calendar-day count, while LOINC 41950-7 is a 24-hour count rate with UCUM unit {#}/(24.h). The local day can be shorter or longer at daylight-saving transitions; individual source intervals are not asserted to be a 24-hour rate either.";
-  }
-  if (entry.provider === "health-connect" && entry.identifier === "BloodPressure") {
-    return "Not mapped: this is a composite systolic/diastolic record. The importer must emit the paired component Observations (or a correctly coded panel) instead of attaching one code to the serialized record.";
-  }
-  if (entry.provider === "health-connect" && entry.identifier === "HeartRateVariabilityRmssd") {
-    return "Not mapped: this source is RMSSD; it must not be coded as the distinct SDNN measure (LOINC 112429-6).";
-  }
-  if (entry.provider === "health-connect" && entry.identifier === "HeartRate") {
-    return "Not mapped: Health Connect HeartRateRecord is a series of samples, but the point converter currently preserves that array as a structured value instead of emitting one Observation per sample; a point heart-rate LOINC code would misstate the output.";
-  }
-  if (entry.provider === "health-connect" && entry.identifier === "BodyTemperature") {
-    return "Not mapped: Health Connect exposes temperature as a structured value and includes a measurement location. The generic Observation converter does not yet normalize that value to a numeric UCUM quantity or preserve the location in bodySite.";
-  }
-  if (entry.provider === "health-connect" && entry.identifier === "SleepSession") {
-    return "Not mapped: the current session value is elapsed session duration, not total time asleep; sleep stages can include awake intervals.";
-  }
-  if (entry.provider === "health-connect" && entry.identifier === "BasalMetabolicRate") {
-    return "Not mapped: the source value is power (W), while the matching LOINC candidate is a basal metabolic rate index; these representations are not interchangeable.";
-  }
-  if (entry.identifier === "BloodGlucose" || entry.identifier === "HKQuantityTypeIdentifierBloodGlucose") {
-    return "Not mapped: the platform type alone does not guarantee a compatible specimen, method, and unit combination for one LOINC glucose term.";
-  }
-  if (entry.provider === "health-connect" && entry.identifier === "Vo2Max") {
-    return "Not mapped: Health Connect exposes VO2 max using several measurement methods (including field-test estimates), while LOINC 94122-9 is specifically peak VO2 during exercise. The source method is retained, but this record does not guarantee that narrower concept.";
-  }
-  if (entry.provider === "apple-health" && entry.identifier === "HKQuantityTypeIdentifierVO2Max") {
-    return "Not mapped: Apple Watch VO2 max is estimated from sub-maximal outdoor walking/running data, while LOINC 94122-9 denotes peak VO2 during exercise. HealthKit also permits clinic-created samples, so the platform identifier alone cannot establish that method.";
+  const byKey = LOINC_LIMITATION_BY_KEY[`${entry.provider}:${entry.identifier}`];
+  if (byKey) {
+    return byKey;
   }
   if (entry.category === "characteristic") {
     return "Not mapped: this is a Patient characteristic, not a dated Observation; no Observation LOINC mapping is asserted.";
@@ -550,7 +385,7 @@ const getHealthDataCoding = (provider, identifier, mode) => {
   if (mapping?.modes.includes(mode)) {
     return {
       code: mapping.code,
-      system: "http://loinc.org",
+      system: LOINC_SYSTEM,
       display: mapping.display
     };
   }