@tryterra/react-native 0.0.0-stage → 2.2.1

package/android/src/healthConnectOnly/kotlin/co/tryterra/sdk/reactnative/TerraStores.kt

@@ -0,0 +1,11 @@
+package co.tryterra.sdk.reactnative
+
+import co.tryterra.sdk.StoreRegistration
+
+/**
+ * The stores this build registers beyond Health Connect: none. The host did not set
+ * `terraSamsungHealth=true`, so `samsungHealth` answers `health_data_unavailable`.
+ */
+internal object TerraStores {
+  val registration: StoreRegistration.() -> Unit = {}
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools">
+
+    <!--
+      The zero-line bootstrap: androidx.startup runs it in every process start, WorkManager's
+      included, before Application.onCreate. It reads the host's
+      <meta-data android:name="co.tryterra.sdk.DEV_ID">.
+
+      No health permission is declared here. A host's permission list is exactly what the host asked
+      for, because Play reviews each declared type against the app's stated use.
+    -->
+    <application>
+        <provider
+            android:name="androidx.startup.InitializationProvider"
+            android:authorities="${applicationId}.androidx-startup"
+            android:exported="false"
+            tools:node="merge">
+            <meta-data
+                android:name="co.tryterra.sdk.reactnative.TerraStartup"
+                android:value="androidx.startup" />
+        </provider>
+    </application>
+</manifest>

package/android/src/main/java/co/tryterra/sdk/reactnative/TerraBridgeModule.kt

@@ -0,0 +1,96 @@
+package co.tryterra.sdk.reactnative
+
+import co.tryterra.sdk.bridge.BridgeBootstrap
+import co.tryterra.sdk.bridge.Rejections
+import co.tryterra.sdk.bridge.TerraBridge
+import co.tryterra.sdk.bridge.generated.BridgeDispatch
+import co.tryterra.sdk.bridge.generated.TerraErrorPayload
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.Promise
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.annotations.ReactModule
+import kotlinx.coroutines.CancellationException
+import kotlinx.coroutines.CoroutineScope
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.SupervisorJob
+import kotlinx.coroutines.cancel
+import kotlinx.coroutines.launch
+
+/**
+ * The TurboModule: one [TerraBridge] per JavaScript runtime, attached to the client bootstrap
+ * parked at process start.
+ *
+ * A shim. It turns a `Promise` and the codegen'd emitter into what hybrid-common takes, and nothing
+ * here knows an op, a code or a data type.
+ */
+@ReactModule(name = TerraBridgeModule.NAME)
+class TerraBridgeModule(context: ReactApplicationContext) : NativeTerraBridgeSpec(context) {
+
+  /** Cancelled with the runtime, which cancels every stream this runtime started. */
+  private val scope = CoroutineScope(SupervisorJob() + Dispatchers.Default)
+
+  private var attached: TerraBridge? = null
+
+  /**
+   * Attached on first use, and a failed attach is not remembered: the next call retries, so a
+   * runtime that started before a manual bootstrap recovers without a reload.
+   */
+  @Synchronized
+  private fun bridge(): TerraBridge =
+    attached ?: BridgeBootstrap.attach(scope, TerraReactNative.MISSING_LINE, ::emit).also { attached = it }
+
+  private fun emit(subscriptionId: String, message: String) {
+    emitOnMessage(
+      Arguments.createMap().apply {
+        putString("subscriptionId", subscriptionId)
+        putString("message", message)
+      },
+    )
+  }
+
+  override fun invoke(op: String, payload: String, promise: Promise) {
+    scope.launch {
+      settle(promise) { bridge().dispatch(op, payload) }
+    }
+  }
+
+  override fun subscribe(stream: String, params: String, promise: Promise) {
+    scope.launch {
+      settle(promise) { bridge().subscribe(stream, params) }
+    }
+  }
+
+  override fun unsubscribe(subscriptionId: String) {
+    synchronized(this) { attached }?.unsubscribe(subscriptionId)
+  }
+
+  /** The runtime is going away. The client is not: the next runtime attaches to the same one. */
+  override fun invalidate() {
+    synchronized(this) {
+      attached?.invalidate()
+      attached = null
+    }
+    scope.cancel()
+    super.invalidate()
+  }
+
+  private suspend fun settle(promise: Promise, work: suspend () -> String) {
+    val payload: TerraErrorPayload = try {
+      promise.resolve(work())
+      return
+    } catch (cancelled: CancellationException) {
+      throw cancelled
+    } catch (rejected: TerraBridge.BridgeRejection) {
+      rejected.payload
+    } catch (thrown: Throwable) {
+      Rejections.of(thrown)
+    }
+    // A JSON string preserves payload types across the native/JS bridge, unlike a nested map.
+    val encoded = BridgeDispatch.defaultJson.encodeToString(TerraErrorPayload.serializer(), payload)
+    promise.reject(payload.code, payload.message, null, Arguments.createMap().apply { putString("payload", encoded) })
+  }
+
+  companion object {
+    const val NAME: String = NativeTerraBridgeSpec.NAME
+  }
+}

package/android/src/main/java/co/tryterra/sdk/reactnative/TerraReactNativePackage.kt

@@ -0,0 +1,26 @@
+package co.tryterra.sdk.reactnative
+
+import com.facebook.react.BaseReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.model.ReactModuleInfo
+import com.facebook.react.module.model.ReactModuleInfoProvider
+
+/** What autolinking adds to the host's package list. */
+class TerraReactNativePackage : BaseReactPackage() {
+  override fun getModule(name: String, reactContext: ReactApplicationContext): NativeModule? =
+    if (name == TerraBridgeModule.NAME) TerraBridgeModule(reactContext) else null
+
+  override fun getReactModuleInfoProvider(): ReactModuleInfoProvider = ReactModuleInfoProvider {
+    mapOf(
+      TerraBridgeModule.NAME to ReactModuleInfo(
+        name = TerraBridgeModule.NAME,
+        className = TerraBridgeModule.NAME,
+        canOverrideExistingModule = false,
+        needsEagerInit = false,
+        isCxxModule = false,
+        isTurboModule = true,
+      ),
+    )
+  }
+}

package/android/src/main/java/co/tryterra/sdk/reactnative/TerraStartup.kt

@@ -0,0 +1,46 @@
+package co.tryterra.sdk.reactnative
+
+import android.content.Context
+import android.util.Log
+import androidx.startup.AppInitializer
+import androidx.startup.Initializer
+import androidx.work.WorkManagerInitializer
+import co.tryterra.sdk.bridge.BridgeBootstrap
+
+/**
+ * Declaring WorkManager's initializer as a dependency runs it even when the host removed its
+ * manifest entry to supply a custom `WorkerFactory`.
+ *
+ * A host that removed it configures WorkManager in `Application.onCreate`, which has not run yet,
+ * so that host bootstraps there instead.
+ */
+class TerraStartup : Initializer<Unit> {
+  override fun create(context: Context) {
+    val startup = AppInitializer.getInstance(context)
+    if (!startup.isEagerlyInitialized(WorkManagerInitializer::class.java)) {
+      Log.i(TAG, "WorkManager's default initializer is removed: call TerraReactNative.bootstrap(this) at the end of Application.onCreate")
+      return
+    }
+    startup.initializeComponent(WorkManagerInitializer::class.java)
+    TerraReactNative.bootstrap(context)
+  }
+
+  override fun dependencies(): List<Class<out Initializer<*>>> = emptyList()
+
+  private companion object {
+    const val TAG = "TerraReactNative"
+  }
+}
+
+/** The manual bootstrap, for a host that opted out of [TerraStartup]. */
+object TerraReactNative {
+  /** What `bridge.not_bootstrapped` tells a developer to fix. */
+  internal const val MISSING_LINE: String =
+    "<meta-data android:name=\"${BridgeBootstrap.DEV_ID_KEY}\" android:value=\"YOUR_DEV_ID\" /> " +
+      "in AndroidManifest.xml's <application>"
+
+  @JvmStatic
+  fun bootstrap(context: Context) {
+    BridgeBootstrap.bootstrap(context, TerraStores.registration)
+  }
+}

package/android/src/samsung/kotlin/co/tryterra/sdk/reactnative/TerraStores.kt

@@ -0,0 +1,13 @@
+package co.tryterra.sdk.reactnative
+
+import co.tryterra.sdk.StoreRegistration
+import co.tryterra.sdk.health.samsung.samsungHealth
+
+/**
+ * The stores this build registers beyond Health Connect: Samsung Health, because the host set
+ * `terraSamsungHealth=true`. The add-on also claims Samsung's own writes out of Health Connect, so
+ * a step counted by Samsung is not uploaded twice.
+ */
+internal object TerraStores {
+  val registration: StoreRegistration.() -> Unit = { samsungHealth() }
+}

package/docs/availability.md

@@ -0,0 +1,396 @@
+<!-- Generated from surface/terra-surface.json by surface/gen. Do not edit by hand.
+     Regenerate with: node surface/gen/src/cli.ts generate -->
+
+# What exists on which platform
+
+Generated from `surface/terra-surface.json`. A row missing from this page is an op no platform
+implements, which the generator refuses to emit, so the page cannot be quietly incomplete.
+
+Two kinds of absence appear here and they are not the same thing. A member absent because the
+platform has no model for it is typed optional in TypeScript, so calling it is a type error. A
+member absent because the SDK has not grown it yet rejects with `bridge.unsupported_on_platform`
+at runtime, and becomes available without a breaking change when the SDK catches up.
+
+## Operations
+
+| Op | iOS | Android |
+|---|---|---|
+| `client.attach` | yes | yes |
+| `client.connect` | yes | yes |
+| `client.connections` | yes | yes |
+| `client.availability` | yes | yes |
+| `client.disconnect` | yes | yes |
+| `token.setProviderPresent` | yes | yes |
+| `token.resolve` | yes | yes |
+| `token.reject` | yes | yes |
+| `permissions.request` | yes | yes |
+| `permissions.status` | yes | yes |
+| `permissions.writeStatus` | yes | yes |
+| `permissions.requested` | yes | yes |
+| `permissions.statuses` | - | yes |
+| `permissions.backgroundReadStatus` | - | yes |
+| `permissions.historyReadStatus` | - | yes |
+| `diagnostics.state` | yes | yes |
+| `diagnostics.lastDelivery` | yes | yes |
+| `diagnostics.report` | yes | yes |
+| `diagnostics.send` | yes | yes |
+| `background.isRegistered` | yes | yes |
+| `background.cancel` | - | yes |
+| `body.heartRate` | yes | yes |
+| `body.restingHeartRate` | yes | yes |
+| `body.readings` | yes | yes |
+| `body.logHeartRate` | yes | yes |
+| `body.log` | yes | yes |
+| `body.delete` | yes | yes |
+| `daily.steps` | yes | yes |
+| `daily.totals` | yes | yes |
+| `daily.intraday` | yes | yes |
+| `daily.log` | yes | yes |
+| `daily.delete` | yes | yes |
+| `sleep.segments` | yes | yes |
+| `sleep.log` | yes | yes |
+| `sleep.delete` | yes | yes |
+| `activity.workouts` | yes | yes |
+| `activity.routes` | yes | yes |
+| `activity.intensity` | yes | yes |
+| `activity.log` | yes | yes |
+| `activity.delete` | yes | yes |
+| `nutrition.quantities` | yes | yes |
+| `nutrition.log` | yes | yes |
+| `nutrition.delete` | yes | yes |
+| `nutrition.hydration` | yes | yes |
+| `menstruation.flow` | yes | yes |
+| `menstruation.events` | yes | yes |
+| `athlete.profile` | yes | - |
+| `plannedWorkouts.planned` | yes | - |
+| `plannedWorkouts.markComplete` | yes | - |
+| `plannedWorkouts.delete` | yes | - |
+| `plannedWorkouts.schedulingStatus` | yes | - |
+| `plannedWorkouts.requestScheduling` | yes | - |
+
+## Streams
+
+| Stream | iOS | Android |
+|---|---|---|
+| `diagnostics.events` | yes | yes |
+| `body.changes` | yes | yes |
+| `daily.changes` | yes | yes |
+| `sleep.changes` | yes | yes |
+| `activity.changes` | yes | yes |
+| `bridge.tokenRequest` | yes | yes |
+
+## Enum cases
+
+| Enum | Case | iOS | Android | Status |
+|---|---|---|---|---|
+| `Source` | `health` | yes | yes | supported |
+| `Source` | `samsungHealth` | - | yes | supported |
+| `DataCategory` | `activity` | yes | yes | supported |
+| `DataCategory` | `body` | yes | yes | supported |
+| `DataCategory` | `daily` | yes | yes | supported |
+| `DataCategory` | `sleep` | yes | yes | supported |
+| `DataCategory` | `nutrition` | yes | yes | supported |
+| `DataCategory` | `menstruation` | yes | yes | supported |
+| `DataCategory` | `athlete` | yes | - | supported |
+| `DataCategory` | `healthObservation` | yes | - | excluded |
+| `PermissionStatus` | `granted` | yes | yes | supported |
+| `PermissionStatus` | `denied` | yes | yes | supported |
+| `PermissionStatus` | `notDetermined` | yes | yes | supported |
+| `PermissionStatus` | `notDisclosed` | yes | yes | supported |
+| `PermissionStatus` | `unsupported` | yes | yes | supported |
+| `PermissionStatus` | `unavailable` | yes | - | supported |
+| `MotionContext` | `unknown` | yes | yes | supported |
+| `MotionContext` | `sedentary` | yes | yes | supported |
+| `MotionContext` | `active` | yes | yes | supported |
+| `Nutrient` | `energyConsumed` | yes | yes | supported |
+| `Nutrient` | `protein` | yes | yes | supported |
+| `Nutrient` | `carbohydrates` | yes | yes | supported |
+| `Nutrient` | `fatTotal` | yes | yes | supported |
+| `Nutrient` | `fatSaturated` | yes | yes | supported |
+| `Nutrient` | `fatMonounsaturated` | yes | yes | supported |
+| `Nutrient` | `fatPolyunsaturated` | yes | yes | supported |
+| `Nutrient` | `sugar` | yes | yes | supported |
+| `Nutrient` | `fiber` | yes | yes | supported |
+| `Nutrient` | `cholesterol` | yes | yes | supported |
+| `Nutrient` | `sodium` | yes | yes | supported |
+| `Nutrient` | `potassium` | yes | yes | supported |
+| `Nutrient` | `calcium` | yes | yes | supported |
+| `Nutrient` | `iron` | yes | yes | supported |
+| `Nutrient` | `magnesium` | yes | yes | supported |
+| `Nutrient` | `zinc` | yes | yes | supported |
+| `Nutrient` | `phosphorus` | yes | yes | supported |
+| `Nutrient` | `iodine` | yes | yes | supported |
+| `Nutrient` | `manganese` | yes | yes | supported |
+| `Nutrient` | `molybdenum` | yes | yes | supported |
+| `Nutrient` | `selenium` | yes | yes | supported |
+| `Nutrient` | `copper` | yes | yes | supported |
+| `Nutrient` | `chromium` | yes | yes | supported |
+| `Nutrient` | `chloride` | yes | yes | supported |
+| `Nutrient` | `caffeine` | yes | yes | supported |
+| `Nutrient` | `vitaminA` | yes | yes | supported |
+| `Nutrient` | `vitaminC` | yes | yes | supported |
+| `Nutrient` | `vitaminD` | yes | yes | supported |
+| `Nutrient` | `vitaminE` | yes | yes | supported |
+| `Nutrient` | `vitaminK` | yes | yes | supported |
+| `Nutrient` | `vitaminB6` | yes | yes | supported |
+| `Nutrient` | `vitaminB12` | yes | yes | supported |
+| `Nutrient` | `thiamin` | yes | yes | supported |
+| `Nutrient` | `riboflavin` | yes | yes | supported |
+| `Nutrient` | `niacin` | yes | yes | supported |
+| `Nutrient` | `folate` | yes | yes | supported |
+| `Nutrient` | `biotin` | yes | yes | supported |
+| `Nutrient` | `pantothenicAcid` | yes | yes | supported |
+| `MealType` | `breakfast` | yes | yes | supported |
+| `MealType` | `lunch` | yes | yes | supported |
+| `MealType` | `dinner` | yes | yes | supported |
+| `MealType` | `snack` | yes | yes | supported |
+| `MealType` | `unknown` | yes | yes | supported |
+| `MenstruationFlow` | `unspecified` | yes | yes | supported |
+| `MenstruationFlow` | `light` | yes | yes | supported |
+| `MenstruationFlow` | `medium` | yes | yes | supported |
+| `MenstruationFlow` | `heavy` | yes | yes | supported |
+| `MenstruationFlow` | `none` | yes | yes | supported |
+| `BiologicalSex` | `female` | yes | - | supported |
+| `BiologicalSex` | `male` | yes | - | supported |
+| `BiologicalSex` | `other` | yes | - | supported |
+| `BiologicalSex` | `notSet` | yes | - | supported |
+| `ActivityMoveMode` | `activeEnergy` | yes | - | supported |
+| `ActivityMoveMode` | `appleMoveTime` | yes | - | supported |
+| `BackgroundRestrictionReason` | `oemRestricted` | - | yes | supported |
+| `BackgroundRestrictionReason` | `backgroundReadDenied` | - | yes | supported |
+| `BackgroundRestrictionReason` | `healthConnectFeatureUnavailable` | - | yes | supported |
+| `BackgroundRestrictionReason` | `storeFeatureUnavailable` | - | yes | supported |
+| `BackgroundRestrictionReason` | `ticksNotRunning` | - | yes | supported |
+| `DiagnosticsReason` | `uploadFailed` | yes | yes | supported |
+| `DiagnosticsReason` | `backfillAbandoned` | yes | yes | supported |
+| `DiagnosticsReason` | `backgroundObservationUnavailable` | yes | yes | supported |
+| `DiagnosticsReason` | `backgroundRestricted` | yes | yes | supported |
+| `DiagnosticsReason` | `backgroundRefreshUnscheduled` | yes | yes | supported |
+| `DiagnosticsReason` | `quiet` | yes | yes | supported |
+| `DiagnosticsReason` | `requested` | yes | yes | supported |
+| `DeviceKeyRevokeOutcome` | `revoked` | yes | yes | supported |
+| `DeviceKeyRevokeOutcome` | `alreadyRevoked` | yes | yes | supported |
+| `DeviceKeyRevokeOutcome` | `routeAbsent` | yes | yes | supported |
+| `FailureCode` | `healthDataUnavailable` | yes | yes | supported |
+| `FailureCode` | `notConnected` | yes | yes | supported |
+| `FailureCode` | `tokenUnavailable` | yes | yes | supported |
+| `FailureCode` | `tokenRejected` | yes | yes | supported |
+| `FailureCode` | `tokenProviderFailed` | yes | yes | supported |
+| `FailureCode` | `offline` | yes | yes | supported |
+| `FailureCode` | `timedOut` | yes | yes | supported |
+| `FailureCode` | `serverError` | yes | yes | supported |
+| `FailureCode` | `transport` | yes | yes | supported |
+| `FailureCode` | `malformedResponse` | yes | yes | supported |
+| `FailureCode` | `userLimitReached` | yes | yes | supported |
+| `FailureCode` | `upgradeRequired` | yes | yes | supported |
+| `FailureCode` | `platform` | yes | yes | supported |
+| `FailureCode` | `deviceKeyUnavailable` | yes | yes | supported |
+| `FailureCode` | `signatureRejected` | yes | yes | supported |
+| `FailureCode` | `linkRevoked` | yes | yes | supported |
+| `FailureCode` | `linkConflict` | yes | yes | supported |
+| `FailureCode` | `clockSkewed` | yes | yes | supported |
+| `FailureCode` | `devIDMismatch` | yes | yes | supported |
+| `FailureCode` | `syncAlreadyRunning` | yes | yes | supported |
+| `FailureCode` | `linkAlreadyRunning` | yes | yes | supported |
+| `FailureCode` | `storeLocked` | yes | yes | supported |
+| `FailureCode` | `storeUnreadable` | yes | yes | supported |
+| `FailureCode` | `deadlineExceeded` | yes | yes | supported |
+| `FailureCode` | `permissionDenied` | yes | yes | supported |
+| `FailureCode` | `authorizationNotDetermined` | yes | yes | supported |
+| `FailureCode` | `sampleNotFound` | yes | yes | supported |
+| `FailureCode` | `rollbackIncomplete` | yes | yes | supported |
+| `FailureCode` | `distanceNotAttributable` | yes | yes | supported |
+| `FailureCode` | `bloodPressureIncomplete` | yes | yes | supported |
+| `FailureCode` | `authorizationUnavailableInExtension` | yes | yes | supported |
+| `FailureCode` | `routeAwaitingConverter` | yes | yes | supported |
+| `FailureCode` | `readQuotaExceeded` | - | yes | supported |
+| `FailureCode` | `plannedWorkoutUnnamed` | yes | - | supported |
+| `WorkoutSchedulingStatus` | `unsupported` | yes | - | supported |
+| `WorkoutSchedulingStatus` | `notDetermined` | yes | - | supported |
+| `WorkoutSchedulingStatus` | `denied` | yes | - | supported |
+| `WorkoutSchedulingStatus` | `authorized` | yes | - | supported |
+| `DayTotalMetric` | `distanceWalkingRunning` | yes | yes | supported |
+| `DayTotalMetric` | `distanceCycling` | yes | yes | supported |
+| `DayTotalMetric` | `distanceSwimming` | yes | yes | supported |
+| `DayTotalMetric` | `distanceWheelchair` | yes | yes | supported |
+| `DayTotalMetric` | `activeEnergyBurned` | yes | yes | supported |
+| `DayTotalMetric` | `basalEnergyBurned` | yes | yes | supported |
+| `DayTotalMetric` | `flightsClimbed` | yes | yes | supported |
+| `DayTotalMetric` | `appleExerciseTime` | yes | - | supported |
+| `DayTotalMetric` | `steps` | yes | yes | excluded |
+| `DayTotalMetric` | `swimmingStrokeCount` | yes | yes | excluded |
+| `DayTotalMetric` | `appleMoveTime` | yes | - | excluded |
+| `DayTotalMetric` | `appleStandTime` | yes | - | excluded |
+| `DayTotalMetric` | `appleStandHours` | yes | - | excluded |
+| `IntradayMetric` | `activeEnergy` | yes | yes | supported |
+| `IntradayMetric` | `basalEnergy` | yes | - | supported |
+| `IntradayMetric` | `distance` | yes | yes | supported |
+| `IntradayMetric` | `floorsClimbed` | yes | yes | supported |
+| `WorkoutIntensityMetric` | `speed` | yes | yes | supported |
+| `WorkoutIntensityMetric` | `power` | yes | yes | supported |
+| `WorkoutIntensityMetric` | `cadence` | yes | yes | supported |
+| `BodyMetric` | `weight` | yes | yes | supported |
+| `BodyMetric` | `height` | yes | yes | supported |
+| `BodyMetric` | `bodyFatPercentage` | yes | yes | supported |
+| `BodyMetric` | `leanBodyMass` | yes | yes | supported |
+| `BodyMetric` | `bmi` | yes | - | supported |
+| `BodyMetric` | `waistCircumference` | yes | - | excluded |
+| `BodyMetric` | `boneMass` | - | yes | excluded |
+| `BodyMetric` | `bodyWaterMass` | - | yes | excluded |
+| `BodyMetric` | `basalMetabolicRate` | - | yes | excluded |
+| `BloodGlucoseUnit` | `mg/dL` | yes | yes | supported |
+| `BloodGlucoseUnit` | `mmol/L` | yes | yes | supported |
+| `GlucoseMealTime` | `preprandial` | yes | yes | supported |
+| `GlucoseMealTime` | `postprandial` | yes | yes | supported |
+| `GlucoseMealTime` | `unknown` | yes | yes | supported |
+| `GlucoseSpecimen` | `capillary` | yes | yes | supported |
+| `GlucoseSpecimen` | `interstitial` | yes | yes | supported |
+| `GlucoseSpecimen` | `plasma` | yes | yes | supported |
+| `GlucoseSpecimen` | `serum` | yes | yes | supported |
+| `GlucoseSpecimen` | `tears` | yes | yes | supported |
+| `GlucoseSpecimen` | `wholeBlood` | yes | yes | supported |
+| `GlucoseSpecimen` | `unknown` | yes | yes | supported |
+| `BodyTemperatureMetric` | `body` | yes | yes | supported |
+| `BodyTemperatureMetric` | `basal` | yes | yes | supported |
+| `BodyTemperatureMetric` | `wrist` | yes | - | supported |
+| `BodyTemperatureMetric` | `skin` | yes | yes | supported |
+| `HeartRateVariabilityMetric` | `sdnn` | yes | yes | supported |
+| `HeartRateVariabilityMetric` | `rmssd` | yes | yes | supported |
+| `VO2MaxTestType` | `maxExercise` | yes | yes | supported |
+| `VO2MaxTestType` | `predictedSubMaxExercise` | yes | yes | supported |
+| `VO2MaxTestType` | `predictedNonExercise` | yes | yes | supported |
+| `MenstrualEventKind` | `intermenstrualBleeding` | yes | yes | supported |
+| `MenstrualEventKind` | `ovulationTest` | yes | yes | supported |
+| `MenstrualEventKind` | `cervicalMucus` | yes | yes | supported |
+| `MenstrualEventKind` | `sexualActivity` | yes | yes | excluded |
+| `MenstrualEventKind` | `pregnancyTest` | yes | - | excluded |
+| `MenstrualEventKind` | `progesteroneTest` | yes | - | excluded |
+| `MenstrualEventKind` | `pregnancy` | yes | - | excluded |
+| `MenstrualEventKind` | `lactation` | yes | - | excluded |
+| `MenstrualEventKind` | `contraceptive` | yes | - | excluded |
+| `MenstrualEventKind` | `persistentIntermenstrualBleeding` | yes | - | excluded |
+| `MenstrualEventKind` | `infrequentCycles` | yes | - | excluded |
+| `MenstrualEventKind` | `irregularCycles` | yes | - | excluded |
+| `MenstrualEventKind` | `prolongedPeriods` | yes | - | excluded |
+| `MenstrualEventKind` | `bleedingDuringPregnancy` | yes | - | excluded |
+| `MenstrualEventKind` | `bleedingAfterPregnancy` | yes | - | excluded |
+
+### Why those cases are not in the API
+
+Each one exists in at least one native SDK. They are listed rather than dropped, because a
+case that simply went unmentioned is the bug this whole schema exists to prevent.
+
+- `DataCategory.healthObservation` (excluded): docs/sdk-reference.md records it as carrying no HealthKit types yet.
+- `DayTotalMetric.steps` (excluded): daily.steps answers steps, split by writer. A merged total beside it would be two step figures for one day.
+- `DayTotalMetric.swimmingStrokeCount` (excluded): Uploaded, and never part of the 1.x daily read this op replaces.
+- `DayTotalMetric.appleMoveTime` (excluded): A ring figure the 1.x daily read never returned. Uploaded.
+- `DayTotalMetric.appleStandTime` (excluded): A ring figure the 1.x daily read never returned. Uploaded.
+- `DayTotalMetric.appleStandHours` (excluded): A ring figure the 1.x daily read never returned. Uploaded.
+- `BodyMetric.waistCircumference` (excluded): Uploaded, and never part of the 1.x body read body.readings replaces.
+- `BodyMetric.boneMass` (excluded): Uploaded, and never part of the 1.x body read body.readings replaces.
+- `BodyMetric.bodyWaterMass` (excluded): Uploaded, and never part of the 1.x body read body.readings replaces.
+- `BodyMetric.basalMetabolicRate` (excluded): Uploaded, and never part of the 1.x body read body.readings replaces.
+- `MenstrualEventKind.sexualActivity` (excluded): Uploaded, and never part of the 1.x cycle read menstruation.events replaces.
+- `MenstrualEventKind.pregnancyTest` (excluded): Uploaded, and never part of the 1.x cycle read menstruation.events replaces.
+- `MenstrualEventKind.progesteroneTest` (excluded): Uploaded, and never part of the 1.x cycle read menstruation.events replaces.
+- `MenstrualEventKind.pregnancy` (excluded): Uploaded, and never part of the 1.x cycle read menstruation.events replaces.
+- `MenstrualEventKind.lactation` (excluded): Uploaded, and never part of the 1.x cycle read menstruation.events replaces.
+- `MenstrualEventKind.contraceptive` (excluded): Uploaded, and never part of the 1.x cycle read menstruation.events replaces.
+- `MenstrualEventKind.persistentIntermenstrualBleeding` (excluded): Uploaded, and never part of the 1.x cycle read menstruation.events replaces.
+- `MenstrualEventKind.infrequentCycles` (excluded): Uploaded, and never part of the 1.x cycle read menstruation.events replaces.
+- `MenstrualEventKind.irregularCycles` (excluded): Uploaded, and never part of the 1.x cycle read menstruation.events replaces.
+- `MenstrualEventKind.prolongedPeriods` (excluded): Uploaded, and never part of the 1.x cycle read menstruation.events replaces.
+- `MenstrualEventKind.bleedingDuringPregnancy` (excluded): Uploaded, and never part of the 1.x cycle read menstruation.events replaces.
+- `MenstrualEventKind.bleedingAfterPregnancy` (excluded): Uploaded, and never part of the 1.x cycle read menstruation.events replaces.
+
+## Events
+
+| Kind | iOS | Android |
+|---|---|---|
+| `connected` | yes | yes |
+| `disconnected` | yes | yes |
+| `linkRevoked` | yes | yes |
+| `permissionResult` | yes | yes |
+| `backgroundWake` | yes | yes |
+| `backgroundRefreshUnscheduled` | yes | yes |
+| `uploadBatch` | yes | yes |
+| `uploadFailed` | yes | yes |
+| `retryScheduled` | yes | yes |
+| `backfillProgress` | yes | yes |
+| `serverBackfillQueued` | yes | yes |
+| `serverBackfillCompleted` | yes | yes |
+| `serverBackfillAbandoned` | yes | yes |
+| `serverBackfillRefused` | yes | yes |
+| `serverBackfillUnsupported` | yes | yes |
+| `serverBackfillPollFailed` | yes | yes |
+| `backgroundObservationUnavailable` | yes | yes |
+| `observationDropped` | yes | yes |
+| `samplesLogged` | yes | yes |
+| `sampleDeleted` | yes | yes |
+| `tokenRefreshed` | yes | yes |
+| `deviceKeyRevokeAnswered` | yes | yes |
+| `deviceKeyRevokeFailed` | yes | yes |
+| `diagnosticsReported` | yes | yes |
+| `backgroundWakeRefused` | yes | - |
+| `dailyDayTooLarge` | yes | - |
+| `plannedWorkoutUpdated` | yes | - |
+| `plannedWorkoutsScheduled` | yes | - |
+| `plannedWorkoutScheduleFailed` | yes | - |
+| `sleepWakeDateTooLarge` | yes | - |
+| `backgroundWorkGap` | - | yes |
+| `backgroundWorkReset` | - | yes |
+| `changeTokenExpired` | - | yes |
+| `historyReadUnavailable` | - | yes |
+| `processExitDecided` | - | yes |
+| `readQuotaExceeded` | - | yes |
+| `routeConsentRequired` | - | yes |
+
+## Error codes
+
+| Code | Retryable | iOS | Android | Owner |
+|---|---|---|---|---|
+| `health_data_unavailable` | false | yes | yes | sdk |
+| `not_connected` | false | yes | yes | sdk |
+| `route_awaiting_converter` | false | yes | yes | sdk |
+| `token_unavailable` | false | yes | yes | sdk |
+| `token_rejected` | false | yes | yes | sdk |
+| `token_provider_failed` | false | yes | yes | sdk |
+| `user_limit_reached` | false | yes | yes | sdk |
+| `upgrade_required` | false | yes | yes | sdk |
+| `platform` | false | yes | yes | sdk |
+| `device_key_unavailable` | false | yes | yes | sdk |
+| `signature_rejected` | false | yes | yes | sdk |
+| `clock_skewed` | false | yes | yes | sdk |
+| `link_revoked` | false | yes | yes | sdk |
+| `dev_id_mismatch` | false | yes | yes | sdk |
+| `link_conflict` | true | yes | yes | sdk |
+| `sync_already_running` | false | yes | yes | sdk |
+| `link_already_running` | false | yes | yes | sdk |
+| `store_locked` | true | yes | yes | sdk |
+| `store_unreadable` | false | yes | yes | sdk |
+| `deadline_exceeded` | true | yes | yes | sdk |
+| `read_quota_exceeded` | true | - | yes | sdk |
+| `permission_denied` | false | yes | yes | sdk |
+| `authorization_not_determined` | false | yes | yes | sdk |
+| `sample_not_found` | false | yes | yes | sdk |
+| `rollback_incomplete` | false | yes | yes | sdk |
+| `distance_not_attributable` | false | yes | yes | sdk |
+| `blood_pressure_incomplete` | false | yes | yes | sdk |
+| `authorization_unavailable_in_extension` | false | yes | yes | sdk |
+| `planned_workout_unnamed` | false | yes | - | sdk |
+| `network.transport` | true | yes | yes | sdk |
+| `network.throttled` | true | yes | yes | sdk |
+| `network.server_error` | carried | yes | yes | sdk |
+| `network.malformed_response` | false | yes | yes | sdk |
+| `network.offline` | true | yes | - | sdk |
+| `network.timed_out` | true | yes | - | sdk |
+| `bridge.not_bootstrapped` | false | - | - | bridge |
+| `bridge.unsupported_on_platform` | false | - | - | bridge |
+| `bridge.no_activity` | true | - | - | bridge |
+| `bridge.permission_sheet_unavailable` | true | - | - | bridge |
+| `bridge.token_timeout` | false | - | - | bridge |
+| `bridge.invalid_payload` | false | - | - | bridge |
+
+The SDK-owned half of that table is `docs/sdk-reference.md`'s, which both native test suites
+read. `surface-gen check` asserts the two agree in both directions, so this page cannot drift
+from the vocabulary the SDKs actually speak.

package/frameworks/TerraSDK.xcframework/Info.plist

@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>AvailableLibraries</key>
+	<array>
+		<dict>
+			<key>BinaryPath</key>
+			<string>TerraSDK.framework/TerraSDK</string>
+			<key>DebugSymbolsPath</key>
+			<string>dSYMs</string>
+			<key>LibraryIdentifier</key>
+			<string>ios-arm64_x86_64-simulator</string>
+			<key>LibraryPath</key>
+			<string>TerraSDK.framework</string>
+			<key>SupportedArchitectures</key>
+			<array>
+				<string>arm64</string>
+				<string>x86_64</string>
+			</array>
+			<key>SupportedPlatform</key>
+			<string>ios</string>
+			<key>SupportedPlatformVariant</key>
+			<string>simulator</string>
+		</dict>
+		<dict>
+			<key>BinaryPath</key>
+			<string>TerraSDK.framework/TerraSDK</string>
+			<key>DebugSymbolsPath</key>
+			<string>dSYMs</string>
+			<key>LibraryIdentifier</key>
+			<string>ios-arm64</string>
+			<key>LibraryPath</key>
+			<string>TerraSDK.framework</string>
+			<key>SupportedArchitectures</key>
+			<array>
+				<string>arm64</string>
+			</array>
+			<key>SupportedPlatform</key>
+			<string>ios</string>
+		</dict>
+	</array>
+	<key>CFBundlePackageType</key>
+	<string>XFWK</string>
+	<key>XCFrameworkFormatVersion</key>
+	<string>1.0</string>
+</dict>
+</plist>