@tryterra/react-native 0.0.0-stage → 2.1.0

package/src/generated/errors.ts

@@ -0,0 +1,113 @@
+// Generated from surface/terra-surface.json by surface/gen. Do not edit by hand.
+// Regenerate with: node surface/gen/src/cli.ts generate
+
+/** Every code a rejected op can carry. */
+export type TerraErrorCode =
+  | "health_data_unavailable" // ios+android
+  | "not_connected" // ios+android
+  | "route_awaiting_converter" // ios+android
+  | "token_unavailable" // ios+android
+  | "token_rejected" // ios+android
+  | "token_provider_failed" // ios+android
+  | "user_limit_reached" // ios+android
+  | "upgrade_required" // ios+android
+  | "platform" // ios+android
+  | "device_key_unavailable" // ios+android
+  | "signature_rejected" // ios+android
+  | "clock_skewed" // ios+android
+  | "link_revoked" // ios+android
+  | "dev_id_mismatch" // ios+android
+  | "link_conflict" // ios+android
+  | "sync_already_running" // ios+android
+  | "link_already_running" // ios+android
+  | "store_locked" // ios+android
+  | "store_unreadable" // ios+android
+  | "deadline_exceeded" // ios+android
+  | "read_quota_exceeded" // android
+  | "permission_denied" // ios+android
+  | "authorization_not_determined" // ios+android
+  | "sample_not_found" // ios+android
+  | "rollback_incomplete" // ios+android
+  | "distance_not_attributable" // ios+android
+  | "blood_pressure_incomplete" // ios+android
+  | "authorization_unavailable_in_extension" // ios+android
+  | "planned_workout_unnamed" // ios
+  | "network.transport" // ios+android
+  | "network.throttled" // ios+android
+  | "network.server_error" // ios+android
+  | "network.malformed_response" // ios+android
+  | "network.offline" // ios
+  | "network.timed_out" // ios
+  | "bridge.not_bootstrapped" // bridge
+  | "bridge.unsupported_on_platform" // bridge
+  | "bridge.no_activity" // bridge
+  | "bridge.permission_sheet_unavailable" // bridge
+  | "bridge.token_timeout" // bridge
+  | "bridge.invalid_payload"; // bridge
+
+/**
+ * Whether retrying the same call could succeed.
+ *
+ * `'carried'` means the answer depends on the instance, so the rejection's own `retryable` is
+ * the one to read. Only `network.server_error` is carried today.
+ */
+export const retryableByCode: Readonly<Record<TerraErrorCode, boolean | 'carried'>> = {
+  "health_data_unavailable": false,
+  "not_connected": false,
+  "route_awaiting_converter": false,
+  "token_unavailable": false,
+  "token_rejected": false,
+  "token_provider_failed": false,
+  "user_limit_reached": false,
+  "upgrade_required": false,
+  "platform": false,
+  "device_key_unavailable": false,
+  "signature_rejected": false,
+  "clock_skewed": false,
+  "link_revoked": false,
+  "dev_id_mismatch": false,
+  "link_conflict": true,
+  "sync_already_running": false,
+  "link_already_running": false,
+  "store_locked": true,
+  "store_unreadable": false,
+  "deadline_exceeded": true,
+  "read_quota_exceeded": true,
+  "permission_denied": false,
+  "authorization_not_determined": false,
+  "sample_not_found": false,
+  "rollback_incomplete": false,
+  "distance_not_attributable": false,
+  "blood_pressure_incomplete": false,
+  "authorization_unavailable_in_extension": false,
+  "planned_workout_unnamed": false,
+  "network.transport": true,
+  "network.throttled": true,
+  "network.server_error": "carried",
+  "network.malformed_response": false,
+  "network.offline": true,
+  "network.timed_out": true,
+  "bridge.not_bootstrapped": false,
+  "bridge.unsupported_on_platform": false,
+  "bridge.no_activity": true,
+  "bridge.permission_sheet_unavailable": true,
+  "bridge.token_timeout": false,
+  "bridge.invalid_payload": false,
+};
+
+/** Codes no native SDK raises. Their cause is always the host's setup or the bridge's own state. */
+export const bridgeOwnedCodes: readonly TerraErrorCode[] = [
+  "bridge.not_bootstrapped",
+  "bridge.unsupported_on_platform",
+  "bridge.no_activity",
+  "bridge.permission_sheet_unavailable",
+  "bridge.token_timeout",
+  "bridge.invalid_payload",
+];
+
+/** Codes only one platform can raise, so that a caller can narrow rather than discover. */
+export const platformOnlyCodes: Readonly<Record<string, readonly TerraErrorCode[]>> = {
+  ios: ["planned_workout_unnamed", "network.offline", "network.timed_out"],
+  android: ["read_quota_exceeded", "bridge.no_activity", "bridge.permission_sheet_unavailable"],
+};
+

package/src/generated/ops.ts

@@ -0,0 +1,197 @@
+// Generated from surface/terra-surface.json by surface/gen. Do not edit by hand.
+// Regenerate with: node surface/gen/src/cli.ts generate
+
+/**
+ * The op table: the strings that travel, and where each one is implemented.
+ *
+ * `availableOn` is read by the availability test and by the facade, which is what makes an op
+ * missing from a platform a typed absence rather than a runtime surprise.
+ */
+export type OpId =
+  | "client.attach"
+  | "client.connect"
+  | "client.connections"
+  | "client.disconnect"
+  | "token.setProviderPresent"
+  | "token.resolve"
+  | "token.reject"
+  | "permissions.request"
+  | "permissions.status"
+  | "permissions.writeStatus"
+  | "permissions.requested"
+  | "permissions.statuses"
+  | "permissions.backgroundReadStatus"
+  | "permissions.historyReadStatus"
+  | "diagnostics.state"
+  | "diagnostics.lastDelivery"
+  | "diagnostics.report"
+  | "diagnostics.send"
+  | "background.isRegistered"
+  | "background.cancel"
+  | "body.heartRate"
+  | "body.logHeartRate"
+  | "body.log"
+  | "body.delete"
+  | "daily.steps"
+  | "daily.log"
+  | "daily.delete"
+  | "sleep.segments"
+  | "sleep.log"
+  | "sleep.delete"
+  | "activity.workouts"
+  | "activity.log"
+  | "activity.delete"
+  | "nutrition.log"
+  | "nutrition.delete"
+  | "plannedWorkouts.planned"
+  | "plannedWorkouts.markComplete"
+  | "plannedWorkouts.delete"
+  | "plannedWorkouts.schedulingStatus"
+  | "plannedWorkouts.requestScheduling"
+;
+
+export const opIds: readonly OpId[] = [
+  "client.attach",
+  "client.connect",
+  "client.connections",
+  "client.disconnect",
+  "token.setProviderPresent",
+  "token.resolve",
+  "token.reject",
+  "permissions.request",
+  "permissions.status",
+  "permissions.writeStatus",
+  "permissions.requested",
+  "permissions.statuses",
+  "permissions.backgroundReadStatus",
+  "permissions.historyReadStatus",
+  "diagnostics.state",
+  "diagnostics.lastDelivery",
+  "diagnostics.report",
+  "diagnostics.send",
+  "background.isRegistered",
+  "background.cancel",
+  "body.heartRate",
+  "body.logHeartRate",
+  "body.log",
+  "body.delete",
+  "daily.steps",
+  "daily.log",
+  "daily.delete",
+  "sleep.segments",
+  "sleep.log",
+  "sleep.delete",
+  "activity.workouts",
+  "activity.log",
+  "activity.delete",
+  "nutrition.log",
+  "nutrition.delete",
+  "plannedWorkouts.planned",
+  "plannedWorkouts.markComplete",
+  "plannedWorkouts.delete",
+  "plannedWorkouts.schedulingStatus",
+  "plannedWorkouts.requestScheduling",
+];
+
+export const availableOn: Readonly<Record<OpId, readonly string[]>> = {
+  "client.attach": ["ios", "android"],
+  "client.connect": ["ios", "android"],
+  "client.connections": ["ios", "android"],
+  "client.disconnect": ["ios", "android"],
+  "token.setProviderPresent": ["ios", "android"],
+  "token.resolve": ["ios", "android"],
+  "token.reject": ["ios", "android"],
+  "permissions.request": ["ios", "android"],
+  "permissions.status": ["ios", "android"],
+  "permissions.writeStatus": ["ios", "android"],
+  "permissions.requested": ["ios", "android"],
+  "permissions.statuses": ["android"],
+  "permissions.backgroundReadStatus": ["android"],
+  "permissions.historyReadStatus": ["android"],
+  "diagnostics.state": ["ios", "android"],
+  "diagnostics.lastDelivery": ["ios", "android"],
+  "diagnostics.report": ["ios", "android"],
+  "diagnostics.send": ["ios", "android"],
+  "background.isRegistered": ["ios", "android"],
+  "background.cancel": ["android"],
+  "body.heartRate": ["ios", "android"],
+  "body.logHeartRate": ["ios", "android"],
+  "body.log": ["ios", "android"],
+  "body.delete": ["ios", "android"],
+  "daily.steps": ["ios", "android"],
+  "daily.log": ["ios", "android"],
+  "daily.delete": ["ios", "android"],
+  "sleep.segments": ["ios", "android"],
+  "sleep.log": ["ios", "android"],
+  "sleep.delete": ["ios", "android"],
+  "activity.workouts": ["ios", "android"],
+  "activity.log": ["ios", "android"],
+  "activity.delete": ["ios", "android"],
+  "nutrition.log": ["ios", "android"],
+  "nutrition.delete": ["ios", "android"],
+  "plannedWorkouts.planned": ["ios"],
+  "plannedWorkouts.markComplete": ["ios"],
+  "plannedWorkouts.delete": ["ios"],
+  "plannedWorkouts.schedulingStatus": ["ios"],
+  "plannedWorkouts.requestScheduling": ["ios"],
+};
+
+export type StreamId =
+  | "diagnostics.events"
+  | "body.changes"
+  | "daily.changes"
+  | "sleep.changes"
+  | "activity.changes"
+  | "bridge.tokenRequest"
+;
+
+export const streamIds: readonly StreamId[] = [
+  "diagnostics.events",
+  "body.changes",
+  "daily.changes",
+  "sleep.changes",
+  "activity.changes",
+  "bridge.tokenRequest",
+];
+
+/** Event kinds, and the platforms that can emit each. */
+export const eventKinds: Readonly<Record<string, readonly string[]>> = {
+  "connected": ["ios", "android"],
+  "disconnected": ["ios", "android"],
+  "linkRevoked": ["ios", "android"],
+  "permissionResult": ["ios", "android"],
+  "backgroundWake": ["ios", "android"],
+  "backgroundRefreshUnscheduled": ["ios", "android"],
+  "uploadBatch": ["ios", "android"],
+  "uploadFailed": ["ios", "android"],
+  "retryScheduled": ["ios", "android"],
+  "backfillProgress": ["ios", "android"],
+  "serverBackfillQueued": ["ios", "android"],
+  "serverBackfillCompleted": ["ios", "android"],
+  "serverBackfillAbandoned": ["ios", "android"],
+  "serverBackfillRefused": ["ios", "android"],
+  "serverBackfillUnsupported": ["ios", "android"],
+  "serverBackfillPollFailed": ["ios", "android"],
+  "backgroundObservationUnavailable": ["ios", "android"],
+  "observationDropped": ["ios", "android"],
+  "samplesLogged": ["ios", "android"],
+  "sampleDeleted": ["ios", "android"],
+  "tokenRefreshed": ["ios", "android"],
+  "deviceKeyRevokeAnswered": ["ios", "android"],
+  "deviceKeyRevokeFailed": ["ios", "android"],
+  "diagnosticsReported": ["ios", "android"],
+  "backgroundWakeRefused": ["ios"],
+  "dailyDayTooLarge": ["ios"],
+  "plannedWorkoutUpdated": ["ios"],
+  "plannedWorkoutsScheduled": ["ios"],
+  "plannedWorkoutScheduleFailed": ["ios"],
+  "sleepWakeDateTooLarge": ["ios"],
+  "backgroundWorkGap": ["android"],
+  "backgroundWorkReset": ["android"],
+  "changeTokenExpired": ["android"],
+  "historyReadUnavailable": ["android"],
+  "processExitDecided": ["android"],
+  "readQuotaExceeded": ["android"],
+  "routeConsentRequired": ["android"],
+};
+

package/src/generated/streams.ts

@@ -0,0 +1,74 @@
+// Generated from surface/terra-surface.json by surface/gen. Do not edit by hand.
+// Regenerate with: node surface/gen/src/cli.ts generate
+
+import type { HealthChange, StreamMessage, TerraEvent, TokenRequest } from "./types";
+import { decodeStreamMessage, decodeHealthChange, encodeHealthChange, decodeTerraEvent, encodeTerraEvent, decodeTokenRequest, encodeTokenRequest } from "./codecs";
+import type { StreamId } from "./ops";
+
+/** The element each stream delivers inside a data message. */
+export interface StreamElements {
+  "diagnostics.events": TerraEvent;
+  "body.changes": HealthChange;
+  "daily.changes": HealthChange;
+  "sleep.changes": HealthChange;
+  "activity.changes": HealthChange;
+  "bridge.tokenRequest": TokenRequest;
+}
+
+/** Where each stream is published. */
+export const streamAvailableOn: Readonly<Record<StreamId, readonly string[]>> = {
+  "diagnostics.events": ["ios", "android"],
+  "body.changes": ["ios", "android"],
+  "daily.changes": ["ios", "android"],
+  "sleep.changes": ["ios", "android"],
+  "activity.changes": ["ios", "android"],
+  "bridge.tokenRequest": ["ios", "android"],
+};
+
+/** One delivered message, with a data message's element typed as its stream's own. */
+export type StreamDelivery<S extends StreamId> =
+  | { kind: "data"; element: StreamElements[S] }
+  | Exclude<StreamMessage, { kind: "data" }>;
+
+export function decodeStreamElement<S extends StreamId>(stream: S, raw: unknown): StreamElements[S] {
+  switch (stream as StreamId) {
+    case "diagnostics.events":
+      return decodeTerraEvent(raw, "diagnostics.events") as StreamElements[S];
+    case "body.changes":
+      return decodeHealthChange(raw, "body.changes") as StreamElements[S];
+    case "daily.changes":
+      return decodeHealthChange(raw, "daily.changes") as StreamElements[S];
+    case "sleep.changes":
+      return decodeHealthChange(raw, "sleep.changes") as StreamElements[S];
+    case "activity.changes":
+      return decodeHealthChange(raw, "activity.changes") as StreamElements[S];
+    case "bridge.tokenRequest":
+      return decodeTokenRequest(raw, "bridge.tokenRequest") as StreamElements[S];
+  }
+  throw new TypeError(`unknown stream ${String(stream)}`);
+}
+
+export function encodeStreamElement<S extends StreamId>(stream: S, value: StreamElements[S]): Record<string, unknown> {
+  switch (stream as StreamId) {
+    case "diagnostics.events":
+      return encodeTerraEvent(value as TerraEvent);
+    case "body.changes":
+      return encodeHealthChange(value as HealthChange);
+    case "daily.changes":
+      return encodeHealthChange(value as HealthChange);
+    case "sleep.changes":
+      return encodeHealthChange(value as HealthChange);
+    case "activity.changes":
+      return encodeHealthChange(value as HealthChange);
+    case "bridge.tokenRequest":
+      return encodeTokenRequest(value as TokenRequest);
+  }
+  throw new TypeError(`unknown stream ${String(stream)}`);
+}
+
+export function decodeStreamDelivery<S extends StreamId>(stream: S, raw: unknown): StreamDelivery<S> {
+  const message = decodeStreamMessage(raw, "StreamMessage");
+  if (message.kind !== "data") return message;
+  return { kind: "data", element: decodeStreamElement(stream, message.element) };
+}
+