@appeeky/expo-healthkit 0.1.0

package/ios/HealthKitExceptions.swift

@@ -0,0 +1,109 @@
+import ExpoModulesCore
+
+internal final class HealthUnavailableException: Exception, @unchecked Sendable {
+  override var reason: String {
+    "HealthKit is not available on this device"
+  }
+}
+
+internal final class EmptyPermissionsException: Exception, @unchecked Sendable {
+  override var reason: String {
+    "Provide at least one HealthKit type in toRead or toShare"
+  }
+}
+
+internal final class InvalidIdentifierException: GenericException<String>, @unchecked Sendable {
+  override var reason: String {
+    "Unknown or unsupported HealthKit identifier: \(param)"
+  }
+}
+
+internal final class InvalidUnitException: GenericException<String>, @unchecked Sendable {
+  override var reason: String {
+    "Invalid HealthKit unit string: \(param)"
+  }
+}
+
+internal final class InvalidDateException: GenericException<String>, @unchecked Sendable {
+  override var reason: String {
+    "Invalid ISO-8601 date: \(param)"
+  }
+}
+
+internal final class InvalidSampleTypeException: GenericException<String>, @unchecked Sendable {
+  override var reason: String {
+    "Identifier is not a writable sample type: \(param)"
+  }
+}
+
+internal final class MissingDeleteTypeException: Exception, @unchecked Sendable {
+  override var reason: String {
+    "deleteObjects requires a type, optionally with uuid or a date range"
+  }
+}
+
+internal final class MissingUuidException: Exception, @unchecked Sendable {
+  override var reason: String {
+    "uuid is not a valid UUID string"
+  }
+}
+
+internal final class SampleNotFoundException: GenericException<String>, @unchecked Sendable {
+  override var reason: String {
+    "No HealthKit sample found for uuid: \(param)"
+  }
+}
+
+internal final class EmptyCorrelationException: Exception, @unchecked Sendable {
+  override var reason: String {
+    "saveCorrelation requires at least one quantity object"
+  }
+}
+
+internal final class HealthKitNativeException: GenericException<String>, @unchecked Sendable {
+  override var code: String {
+    "ERR_HEALTHKIT_NATIVE"
+  }
+
+  override var reason: String {
+    param
+  }
+}
+
+func catchingHealthKit<T>(_ work: () throws -> T) throws -> T {
+  var result: Result<T, Error>?
+  do {
+    try withoutActuallyEscaping(work) { escapingWork in
+      try EXUtilities.catchException {
+        do {
+          result = .success(try escapingWork())
+        } catch {
+          result = .failure(error)
+        }
+      }
+    }
+  } catch {
+    throw HealthKitNativeException(healthKitNativeMessage(error))
+  }
+
+  switch result {
+  case .success(let value):
+    return value
+  case .failure(let error):
+    throw error
+  case nil:
+    throw HealthKitNativeException("HealthKit failed without a result")
+  }
+}
+
+private func healthKitNativeMessage(_ error: Error) -> String {
+  let nsError = error as NSError
+  let name = nsError.domain
+  if let description = nsError.userInfo[NSLocalizedDescriptionKey] as? String, !description.isEmpty {
+    return name.isEmpty || description.contains(name) ? description : "\(name): \(description)"
+  }
+  if name.isEmpty {
+    return nsError.localizedDescription
+  }
+  return "HealthKit raised \(name). The query arguments are invalid."
+}

package/ios/HealthKitIdentifiers.swift

@@ -0,0 +1,183 @@
+import HealthKit
+
+internal enum HealthKitIdentifiers {
+  static func objectType(for identifier: String) throws -> HKObjectType {
+    if identifier == "HKWorkoutTypeIdentifier" {
+      return HKObjectType.workoutType()
+    }
+
+    if identifier.hasPrefix("HKQuantityTypeIdentifier"),
+      let type = HKObjectType.quantityType(forIdentifier: HKQuantityTypeIdentifier(rawValue: identifier))
+    {
+      return type
+    }
+
+    if identifier.hasPrefix("HKCategoryTypeIdentifier"),
+      let type = HKObjectType.categoryType(forIdentifier: HKCategoryTypeIdentifier(rawValue: identifier))
+    {
+      return type
+    }
+
+    if identifier.hasPrefix("HKCharacteristicTypeIdentifier"),
+      let type = HKObjectType.characteristicType(forIdentifier: HKCharacteristicTypeIdentifier(rawValue: identifier))
+    {
+      return type
+    }
+
+    if identifier.hasPrefix("HKCorrelationTypeIdentifier"),
+      let type = HKObjectType.correlationType(forIdentifier: HKCorrelationTypeIdentifier(rawValue: identifier))
+    {
+      return type
+    }
+
+    if identifier == "HKElectrocardiogramTypeIdentifier" {
+      return HKObjectType.electrocardiogramType()
+    }
+
+    if identifier == "HKAudiogramSampleTypeIdentifier" {
+      return HKObjectType.audiogramSampleType()
+    }
+
+    if identifier == "HKWorkoutRouteTypeIdentifier" {
+      return HKSeriesType.workoutRoute()
+    }
+
+    if identifier == "HKDataTypeIdentifierHeartbeatSeries" {
+      return HKSeriesType.heartbeat()
+    }
+
+    if identifier == "HKActivitySummaryTypeIdentifier" {
+      return HKObjectType.activitySummaryType()
+    }
+
+    if identifier.hasPrefix("HKClinicalTypeIdentifier"),
+      let type = HKObjectType.clinicalType(forIdentifier: HKClinicalTypeIdentifier(rawValue: identifier))
+    {
+      return type
+    }
+
+    throw InvalidIdentifierException(identifier)
+  }
+
+  static func sampleType(for identifier: String) throws -> HKSampleType {
+    guard let type = try objectType(for: identifier) as? HKSampleType else {
+      throw InvalidSampleTypeException(identifier)
+    }
+    return type
+  }
+
+  static func quantityType(for identifier: String) throws -> HKQuantityType {
+    guard let type = try objectType(for: identifier) as? HKQuantityType else {
+      throw InvalidIdentifierException(identifier)
+    }
+    return type
+  }
+
+  static func categoryType(for identifier: String) throws -> HKCategoryType {
+    guard let type = try objectType(for: identifier) as? HKCategoryType else {
+      throw InvalidIdentifierException(identifier)
+    }
+    return type
+  }
+
+  static func unit(from string: String) throws -> HKUnit {
+    let unit = HKUnit(from: string)
+    if unit.unitString.isEmpty {
+      throw InvalidUnitException(string)
+    }
+    return unit
+  }
+
+  static func date(from value: String) throws -> Date {
+    let withFractional = ISO8601DateFormatter()
+    withFractional.formatOptions = [.withInternetDateTime, .withFractionalSeconds]
+    if let date = withFractional.date(from: value) {
+      return date
+    }
+
+    let withoutFractional = ISO8601DateFormatter()
+    withoutFractional.formatOptions = [.withInternetDateTime]
+    if let date = withoutFractional.date(from: value) {
+      return date
+    }
+
+    throw InvalidDateException(value)
+  }
+
+  static func optionalDate(from value: String?) throws -> Date? {
+    guard let value else {
+      return nil
+    }
+    return try date(from: value)
+  }
+
+  static func isoString(from date: Date) -> String {
+    let formatter = ISO8601DateFormatter()
+    formatter.formatOptions = [.withInternetDateTime, .withFractionalSeconds]
+    return formatter.string(from: date)
+  }
+
+  static func queryLimit(_ limit: Int) -> Int {
+    limit <= 0 ? HKObjectQueryNoLimit : limit
+  }
+
+  static func statisticsOptions(from raw: Int, quantityType: HKQuantityType) -> HKStatisticsOptions {
+    if raw == 0 {
+      return quantityType.aggregationStyle == .cumulative ? .cumulativeSum : .discreteAverage
+    }
+
+    var options: HKStatisticsOptions = []
+    if raw & 1 != 0 { options.insert(.discreteAverage) }
+    if raw & 2 != 0 { options.insert(.discreteMin) }
+    if raw & 4 != 0 { options.insert(.discreteMax) }
+    if raw & 8 != 0 { options.insert(.cumulativeSum) }
+    if raw & 32 != 0 { options.insert(.discreteMostRecent) }
+    return options
+  }
+
+  static func displayUnit(for quantityType: HKQuantityType) -> HKUnit {
+    let candidates: [HKUnit] = [
+      HKUnit.millimeterOfMercury(),
+      HKUnit.percent(),
+      HKUnit.count().unitDivided(by: .minute()),
+      HKUnit.count(),
+      HKUnit.kilocalorie(),
+      HKUnit.internationalUnit(),
+      HKUnit.gram(),
+      HKUnit.literUnit(with: .milli),
+      HKUnit.meter(),
+      HKUnit.degreeCelsius(),
+      HKUnit.siemenUnit(with: .micro),
+      HKUnit.decibelAWeightedSoundPressureLevel(),
+      HKUnit.second()
+    ]
+    return candidates.first { quantityType.is(compatibleWith: $0) } ?? HKUnit.count()
+  }
+
+  static func stringifyMetadata(_ metadata: [String: Any]?) -> [String: String]? {
+    guard let metadata, !metadata.isEmpty else {
+      return nil
+    }
+
+    var result: [String: String] = [:]
+    for (key, value) in metadata {
+      result[key] = String(describing: value)
+    }
+    return result
+  }
+
+  static func encodeAnchor(_ anchor: HKQueryAnchor?) throws -> String? {
+    guard let anchor else {
+      return nil
+    }
+    let data = try NSKeyedArchiver.archivedData(withRootObject: anchor, requiringSecureCoding: true)
+    return data.base64EncodedString()
+  }
+
+  static func decodeAnchor(_ value: String?) throws -> HKQueryAnchor? {
+    guard let value, let data = Data(base64Encoded: value) else {
+      return nil
+    }
+    return try NSKeyedUnarchiver.unarchivedObject(ofClass: HKQueryAnchor.self, from: data)
+  }
+}

package/ios/HealthKitRecords.swift

@@ -0,0 +1,214 @@
+import ExpoModulesCore
+
+internal struct AuthorizationOptions: Record {
+  @Field var toRead: [String] = []
+  @Field var toShare: [String] = []
+}
+
+internal struct QuantityQueryOptions: Record {
+  @Field var type: String = ""
+  @Field var unit: String = ""
+  @Field var from: String?
+  @Field var to: String?
+  @Field var limit: Int = 0
+  @Field var ascending: Bool = false
+}
+
+internal struct CategoryQueryOptions: Record {
+  @Field var type: String = ""
+  @Field var from: String?
+  @Field var to: String?
+  @Field var limit: Int = 0
+  @Field var ascending: Bool = false
+}
+
+internal struct WorkoutQueryOptions: Record {
+  @Field var from: String?
+  @Field var to: String?
+  @Field var limit: Int = 0
+  @Field var ascending: Bool = false
+  @Field var activityType: Int?
+}
+
+internal struct StatisticsQueryOptions: Record {
+  @Field var type: String = ""
+  @Field var unit: String = ""
+  @Field var from: String?
+  @Field var to: String?
+  @Field var options: Int = 0
+}
+
+internal struct StatisticsCollectionQueryOptions: Record {
+  @Field var type: String = ""
+  @Field var unit: String = ""
+  @Field var from: String?
+  @Field var to: String?
+  @Field var options: Int = 0
+  @Field var year: Int = 0
+  @Field var month: Int = 0
+  @Field var day: Int = 0
+  @Field var hour: Int = 0
+  @Field var minute: Int = 0
+  @Field var second: Int = 0
+}
+
+internal struct AnchoredQueryOptions: Record {
+  @Field var type: String = ""
+  @Field var unit: String?
+  @Field var from: String?
+  @Field var to: String?
+  @Field var limit: Int = 0
+  @Field var anchor: String?
+}
+
+internal struct QuantitySampleInput: Record {
+  @Field var type: String = ""
+  @Field var unit: String = ""
+  @Field var value: Double = 0
+  @Field var startDate: String = ""
+  @Field var endDate: String = ""
+  @Field var metadata: [String: String]?
+}
+
+internal struct CategorySampleInput: Record {
+  @Field var type: String = ""
+  @Field var value: Int = 0
+  @Field var startDate: String = ""
+  @Field var endDate: String = ""
+  @Field var metadata: [String: String]?
+}
+
+internal struct WorkoutInput: Record {
+  @Field var activityType: Int = 0
+  @Field var startDate: String = ""
+  @Field var endDate: String = ""
+  @Field var energyBurned: Double?
+  @Field var energyBurnedUnit: String?
+  @Field var distance: Double?
+  @Field var distanceUnit: String?
+  @Field var metadata: [String: String]?
+}
+
+internal struct DeleteObjectsOptions: Record {
+  @Field var uuid: String?
+  @Field var type: String?
+  @Field var from: String?
+  @Field var to: String?
+}
+
+internal struct DateRangeQueryOptions: Record {
+  @Field var from: String?
+  @Field var to: String?
+  @Field var limit: Int = 0
+  @Field var ascending: Bool = false
+}
+
+internal struct ElectrocardiogramQueryOptions: Record {
+  @Field var from: String?
+  @Field var to: String?
+  @Field var limit: Int = 0
+  @Field var ascending: Bool = false
+  @Field var includeVoltage: Bool = false
+}
+
+internal struct ActivitySummaryQueryOptions: Record {
+  @Field var from: String?
+  @Field var to: String?
+}
+
+internal struct ClinicalRecordQueryOptions: Record {
+  @Field var type: String = ""
+  @Field var from: String?
+  @Field var to: String?
+  @Field var limit: Int = 0
+  @Field var ascending: Bool = false
+}
+
+internal struct WorkoutRouteQueryOptions: Record {
+  @Field var workoutUUID: String = ""
+}
+
+internal struct CorrelationQueryOptions: Record {
+  @Field var type: String = ""
+  @Field var from: String?
+  @Field var to: String?
+  @Field var limit: Int = 0
+  @Field var ascending: Bool = false
+}
+
+internal struct CorrelationInput: Record {
+  @Field var type: String = ""
+  @Field var startDate: String = ""
+  @Field var endDate: String = ""
+  @Field var objects: [QuantitySampleInput] = []
+  @Field var metadata: [String: String]?
+}
+
+internal struct HeartbeatSeriesQueryOptions: Record {
+  @Field var from: String?
+  @Field var to: String?
+  @Field var limit: Int = 0
+  @Field var ascending: Bool = false
+  @Field var includeBeats: Bool = true
+}
+
+internal struct QuantitySampleRecord: Record {
+  @Field var uuid: String = ""
+  @Field var type: String = ""
+  @Field var startDate: String = ""
+  @Field var endDate: String = ""
+  @Field var value: Double = 0
+  @Field var unit: String = ""
+  @Field var sourceName: String?
+  @Field var sourceId: String?
+  @Field var metadata: [String: String]?
+}
+
+internal struct CategorySampleRecord: Record {
+  @Field var uuid: String = ""
+  @Field var type: String = ""
+  @Field var startDate: String = ""
+  @Field var endDate: String = ""
+  @Field var value: Int = 0
+  @Field var sourceName: String?
+  @Field var sourceId: String?
+  @Field var metadata: [String: String]?
+}
+
+internal struct WorkoutSampleRecord: Record {
+  @Field var uuid: String = ""
+  @Field var type: String = "HKWorkoutTypeIdentifier"
+  @Field var startDate: String = ""
+  @Field var endDate: String = ""
+  @Field var duration: Double = 0
+  @Field var workoutActivityType: Int = 0
+  @Field var totalEnergyBurned: Double?
+  @Field var totalEnergyBurnedUnit: String?
+  @Field var totalDistance: Double?
+  @Field var totalDistanceUnit: String?
+  @Field var sourceName: String?
+  @Field var sourceId: String?
+  @Field var metadata: [String: String]?
+}
+
+internal struct DeletedSampleRecord: Record {
+  @Field var uuid: String = ""
+  @Field var type: String?
+}
+
+internal struct StatisticsRecord: Record {
+  @Field var startDate: String = ""
+  @Field var endDate: String = ""
+  @Field var unit: String = ""
+  @Field var sum: Double?
+  @Field var min: Double?
+  @Field var max: Double?
+  @Field var average: Double?
+  @Field var mostRecent: Double?
+}
+
+internal struct AnchoredQueryResultRecord: Record {
+  @Field var added: [QuantitySampleRecord] = []
+  @Field var deleted: [DeletedSampleRecord] = []
+  @Field var anchor: String?
+}