@glassly/engine 0.3.3-dev.644 → 0.3.3-dev.645

package/build/generated/releaseMetadata.js

@@ -1,9 +1,9 @@
 export const ENGINE_RELEASE_METADATA = Object.freeze({
     "schemaVersion": 1,
     "familyBaseVersion": "0.3.3",
-    "releaseIdentity": "0.3.3-dev.644",
-    "releaseSetId": "glassly-0.3.3-dev.644",
-    "sourceCommit": "7efbf5ec37d31b5589b9c9aedbb3159424e82a05",
+    "releaseIdentity": "0.3.3-dev.645",
+    "releaseSetId": "glassly-0.3.3-dev.645",
+    "sourceCommit": "d448896b180f4eb054a597d2c460d6eae8841a64",
     "otaManifestUrl": null,
     "otaManifestSha256": null
 });

package/build/generated/releaseMetadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"releaseMetadata.js","sourceRoot":"","sources":["../../src/generated/releaseMetadata.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,uBAAuB,GAAoC,MAAM,CAAC,MAAM,CAAC;IACpF,eAAe,EAAE,CAAC;IAClB,mBAAmB,EAAE,OAAO;IAC5B,iBAAiB,EAAE,eAAe;IAClC,cAAc,EAAE,uBAAuB;IACvC,cAAc,EAAE,0CAA0C;IAC1D,gBAAgB,EAAE,IAAI;IACtB,mBAAmB,EAAE,IAAI;CAC1B,CAAC,CAAA","sourcesContent":["/** Generated by release CI. Do not edit in a release checkout. */\nexport interface EngineReleaseMetadata {\n  schemaVersion: 1\n  familyBaseVersion: string | null\n  releaseIdentity: string | null\n  releaseSetId: string | null\n  sourceCommit: string | null\n  otaManifestUrl: string | null\n  otaManifestSha256: string | null\n}\n\nexport const ENGINE_RELEASE_METADATA: Readonly<EngineReleaseMetadata> = Object.freeze({\n  \"schemaVersion\": 1,\n  \"familyBaseVersion\": \"0.3.3\",\n  \"releaseIdentity\": \"0.3.3-dev.644\",\n  \"releaseSetId\": \"glassly-0.3.3-dev.644\",\n  \"sourceCommit\": \"7efbf5ec37d31b5589b9c9aedbb3159424e82a05\",\n  \"otaManifestUrl\": null,\n  \"otaManifestSha256\": null\n})\n"]}
+{"version":3,"file":"releaseMetadata.js","sourceRoot":"","sources":["../../src/generated/releaseMetadata.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,uBAAuB,GAAoC,MAAM,CAAC,MAAM,CAAC;IACpF,eAAe,EAAE,CAAC;IAClB,mBAAmB,EAAE,OAAO;IAC5B,iBAAiB,EAAE,eAAe;IAClC,cAAc,EAAE,uBAAuB;IACvC,cAAc,EAAE,0CAA0C;IAC1D,gBAAgB,EAAE,IAAI;IACtB,mBAAmB,EAAE,IAAI;CAC1B,CAAC,CAAA","sourcesContent":["/** Generated by release CI. Do not edit in a release checkout. */\nexport interface EngineReleaseMetadata {\n  schemaVersion: 1\n  familyBaseVersion: string | null\n  releaseIdentity: string | null\n  releaseSetId: string | null\n  sourceCommit: string | null\n  otaManifestUrl: string | null\n  otaManifestSha256: string | null\n}\n\nexport const ENGINE_RELEASE_METADATA: Readonly<EngineReleaseMetadata> = Object.freeze({\n  \"schemaVersion\": 1,\n  \"familyBaseVersion\": \"0.3.3\",\n  \"releaseIdentity\": \"0.3.3-dev.645\",\n  \"releaseSetId\": \"glassly-0.3.3-dev.645\",\n  \"sourceCommit\": \"d448896b180f4eb054a597d2c460d6eae8841a64\",\n  \"otaManifestUrl\": null,\n  \"otaManifestSha256\": null\n})\n"]}

package/build/index.d.ts

@@ -48,7 +48,7 @@ export { WebSocketStatus } from "./stores/connection";
 export { DUMMY_APPLET, saveAppsOrder, getAppsOrder, sortAppsByPackageNamePriority, saveLastOpenTime, getLastOpenTime, sortAppsByLastOpenTime, useApps, useStart, useStop, useSetForeground, useClearForeground, useRefresh, useStopAll, useInstall, useUninstall, useActiveApps, useRunningAlwaysOnApps, useActiveBackgroundApps, useBackgroundApps, useActiveForegroundApp, useForegroundApp, useActiveBackgroundAppsCount, useLocalMiniApps, type StartOptions, type OrderMap, } from "./stores/apps";
 export { decideDevLaunchRoute, type DecideDevLaunchOptions, type DevLaunchResult, type DevManifest, } from "./utils/devMiniappLaunch";
 export { HardwareCompatibility, type CompatibilityResult } from "./utils/hardware";
-export { BgTimer, throttle, debounce } from "./utils/timers";
+export { BgTimer } from "./utils/timers";
 export { MetaAuthError, authEntryUrl, callbackMatches, callbackQuery, decryptBlob, isLoginCallback, login, tokensQuery, type MetaSession, type MetaSsoTokens, } from "./services/neuralBand/MetaAuth";
 export type { NeuralBandClaimStatus, NeuralBandHandwritingStatus } from "./services/neuralBand/NeuralBandInput";
 export { HardwareType, HardwareRequirementLevel, DeviceTypes, ControllerTypes, HARDWARE_CAPABILITIES, getModelCapabilities, simulatedGlasses, evenRealitiesG1, evenRealitiesG2, mentraLive, nimo, rayneoIO, vuzixZ100, mentraDisplay, } from "./types";

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/build/index.js

@@ -47,7 +47,7 @@ export { DUMMY_APPLET, saveAppsOrder, getAppsOrder, sortAppsByPackageNamePriorit
 // Pure dev-miniapp launch-route decision (registration itself is internal).
 export { decideDevLaunchRoute, } from "./utils/devMiniappLaunch";
 export { HardwareCompatibility } from "./utils/hardware";
-export { BgTimer, throttle, debounce } from "./utils/timers";
+export { BgTimer } from "./utils/timers";
 // Meta Neural Band: the account sign-in a claim needs (the WebView lives in the host).
 export { MetaAuthError, authEntryUrl, callbackMatches, callbackQuery, decryptBlob, isLoginCallback, login, tokensQuery, } from "./services/neuralBand/MetaAuth";
 // Hardware types and capability profiles.

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `@glassly/engine` — the OEM-facing main entry.\n *\n * The `engine` namespace (configure/start/stop + typed domain facades), the\n * public contract/read-model types, and the pure helpers host UI legitimately\n * renders with (decision functions, sort/order helpers, policy constants,\n * capability tables, timers). Judgment rule: read models, commands, pure\n * functions and types belong here; anything that mutates runtime state or\n * exposes a raw store/service remains private to the Glassly host.\n * See cloud/docs/issues/020-glasses-status-boundary/integration-review.md §D.\n */\n\n// The namespaced OEM-facing engine API (the \"(A) host API\"). See ./engine.\nexport {engine} from \"./engine\"\nexport type {\n  ReportAttachmentInput,\n  ReportContext,\n  ReportDetails,\n  ReportStatus,\n  ReportTrigger,\n  ReportSubmitResult,\n  EngineSubmitReportInput,\n} from \"./facades/reports\"\nexport type {IslandNotification, IslandNotificationKind} from \"./facades/notifications\"\nexport type {PresentationOwner} from \"./services/notifications/notificationPolicy\"\nexport {DEFAULT_HIDDEN_PACKAGES, isGatedByDevTools, isSystemMiniapp} from \"./stores/appVisibility\"\nexport type {WifiSearchResult} from \"./facades/glassesWifi\"\nexport type {IdentitySnapshot} from \"./services/PairingIdentity\"\nexport type {DisplayMirrorEvent} from \"./facades/displayMirror\"\nexport type {\n  IslandConfigureOptions,\n  IslandAuth,\n  IslandConfigValues,\n  IslandAnalytics,\n  IslandUiSeams,\n  ScanQrOptions,\n  ScanQrResult,\n  SubjectTokenType,\n} from \"./runtime/bootstrap\"\n\n// Settings contract: the typed key registry (schema descriptors — the same\n// surface engine.settings.descriptor()/keys() reads), the per-key React hook\n// (the hook layer, same precedent as the apps hooks below), and the pure\n// device-model key helpers. The raw useSettingsStore stays internal;\n// imperative access goes through engine.settings.\nexport {SETTINGS, useSetting, AI_DATA_CONSENT_VERSION} from \"./stores/settings\"\nexport {isCfwFirmwareVersion, isCustomDashboardEligible} from \"./services/pages/pageEligibility\"\nexport {getEffectiveCapabilities} from \"./services/effectiveCapabilities\"\n\n// AI tier registry: the curated per-tier model dropdown options and helpers\n// the Settings > AI Models screen renders. Resolution itself runs inside\n// LocalMiniappRuntime; the screen only reads/writes the ai_model_* settings.\nexport {AI_TIERS, TIER_MODEL_OPTIONS, parseTierSetting} from \"./services/AiTierResolution\"\nexport type {AiTier, AiTierProvider, TierModelOption} from \"./services/AiTierResolution\"\n\n// Shared user memory timeline (engine.memory / Settings > Memory). Entry and\n// session shapes are canonical in @glassly/miniapp (the session.memory\n// surface); the stats read model is engine-side.\nexport type {MemoryStats} from \"./services/MemoryStore\"\nexport type {SpeakerProfile} from \"./services/SpeakerProfileStore\"\nexport type {EnrollOutcome} from \"./facades/speakers\"\nexport {MENTRA_LIVE_SETTING_KEYS, getBluetoothSettingKeysForDevice} from \"./stores/bluetoothSettingKeys\"\n\n// Runtime-shared constants and contract DTOs.\nexport {ISLAND_SETTINGS_KEYS} from \"./runtime/config\"\nexport type {CloudClientStatusSnapshot, MiniappAuthToken, InteropAuditEvent, TtsSynthesisResult} from \"./runtime/config\"\n\n// Pure readiness predicates over glasses connection state.\nexport {\n  isGlassesConnected,\n  isGlassesReady,\n  isGlassesLinkLayerBusy,\n  waitForGlassesReady,\n  type GlassesConnectionStatus,\n  type WaitForGlassesReadyOptions,\n} from \"./services/GlassesReadiness\"\n// Pure connect/reconnect decision helpers (host UI renders the outcome).\nexport {\n  decideReconnect,\n  decideConnectButtonAction,\n  type ReconnectDecision,\n  type ReconnectDecisionInput,\n  type ConnectButtonAction,\n} from \"./services/ConnectionCoordinator\"\n\n// OTA read-model types for host OTA UI (progress screen, error mapping,\n// progress section) — the check/install machinery itself is internal.\nexport type {\n  VersionInfo,\n  MtkPatch,\n  BesFirmware,\n  VersionJson,\n  OtaCheckResult,\n  OtaCheckCurrentGlassesResult,\n  OtaCheckCurrentGlassesOptions,\n} from \"./services/OtaUpdateCheckService\"\n// OTA install policy (watchdog timings + failure copy) + display-state\n// derivation, consumed by the OTA screens and their tests.\nexport {\n  MINIMUM_OTA_STATUS_BUILD,\n  MAX_RETRIES,\n  RETRY_INTERVAL_MS,\n  PROGRESS_TIMEOUT_MS,\n  DOWNLOAD_STUCK_TIMEOUT_MS,\n  MTK_INSTALL_TIMEOUT_MS,\n  GLOBAL_OTA_TIMEOUT_MS,\n  PING_INTERVAL_MS,\n  QUERY_REPLY_TIMEOUT_MS,\n  BES_RESTART_TIMEOUT_MS,\n  OtaProgressMessages,\n} from \"./services/otaInstallPolicy\"\nexport {deriveDisplayState} from \"./services/otaDisplayState\"\nexport type {DisplayState} from \"./services/otaDisplayState\"\nexport type {\n  OtaProgress,\n  OtaProgressStatus,\n  OtaStatus,\n  OtaUpdateInfo,\n  ReleaseChangelog,\n  OtaSnapshot,\n  OtaInstallSnapshot,\n} from \"./facades/ota\"\nexport {\n  beginOtaAutoChain,\n  clearOtaAutoChainReconnectWait,\n  isOtaAutoChainActive,\n  otaAutoChainFingerprint,\n  otaAutoChainReconnectWaitRemaining,\n  stopOtaAutoChain,\n  tryAdvanceOtaAutoChain,\n  MAX_OTA_AUTO_CHAIN_PASSES,\n  OTA_AUTO_CHAIN_RECONNECT_TIMEOUT_MS,\n} from \"./services/OtaAutoChain\"\nexport type {OtaAutoChainAdvanceResult} from \"./services/OtaAutoChain\"\nexport {\n  BES_INSTALL_RESTART_MESSAGE,\n  getOtaErrorMessage,\n  shouldRequireGlassesRebootForBesFailure,\n  shouldShowChangeWifiForOtaDownloadFailure,\n} from \"./services/OtaErrorMapping\"\n\n// Gallery read models: engine.gallery.onNotice payload types, the media\n// permission helper + display-name derivation host gallery UI uses, and the\n// glasses-camera DTO types (re-exported through the host @/types/asg shim).\nexport type {GalleryNotice, GalleryNoticeCode} from \"./services/asg/galleryNotices\"\nexport {MediaLibraryPermissions} from \"./utils/permissions/MediaLibraryPermissions\"\nexport {deriveGalleryDisplayName} from \"./utils/permissions/galleryDisplayName\"\nexport type {\n  PhotoInfo,\n  CaptureFile,\n  CaptureGroup,\n  GalleryResponse,\n  ServerStatus,\n  HealthResponse,\n  GalleryEvent,\n} from \"./types/asg\"\n\n// Bluetooth SDK event types host UI subscribes to via engine facades (the\n// BluetoothSdk singleton passthrough itself is internal).\nexport type {PairFailureEvent, GlassesNotReadyEvent} from \"@glassly/bluetooth-sdk\"\n\n// Cloud connection status enum (read model; the connection store is internal).\nexport {WebSocketStatus} from \"./stores/connection\"\n\n// App-list hook layer + pure list helpers (the raw useAppStatusStore and\n// installAppStoreHooks wiring are internal).\nexport {\n  DUMMY_APPLET,\n  saveAppsOrder,\n  getAppsOrder,\n  sortAppsByPackageNamePriority,\n  saveLastOpenTime,\n  getLastOpenTime,\n  sortAppsByLastOpenTime,\n  useApps,\n  useStart,\n  useStop,\n  useSetForeground,\n  useClearForeground,\n  useRefresh,\n  useStopAll,\n  useInstall,\n  useUninstall,\n  useActiveApps,\n  useRunningAlwaysOnApps,\n  useActiveBackgroundApps,\n  useBackgroundApps,\n  useActiveForegroundApp,\n  useForegroundApp,\n  useActiveBackgroundAppsCount,\n  useLocalMiniApps,\n  type StartOptions,\n  type OrderMap,\n} from \"./stores/apps\"\n\n// Pure dev-miniapp launch-route decision (registration itself is internal).\nexport {\n  decideDevLaunchRoute,\n  type DecideDevLaunchOptions,\n  type DevLaunchResult,\n  type DevManifest,\n} from \"./utils/devMiniappLaunch\"\nexport {HardwareCompatibility, type CompatibilityResult} from \"./utils/hardware\"\nexport {BgTimer, throttle, debounce} from \"./utils/timers\"\n// Meta Neural Band: the account sign-in a claim needs (the WebView lives in the host).\nexport {\n  MetaAuthError,\n  authEntryUrl,\n  callbackMatches,\n  callbackQuery,\n  decryptBlob,\n  isLoginCallback,\n  login,\n  tokensQuery,\n  type MetaSession,\n  type MetaSsoTokens,\n} from \"./services/neuralBand/MetaAuth\"\nexport type {NeuralBandClaimStatus, NeuralBandHandwritingStatus} from \"./services/neuralBand/NeuralBandInput\"\n\n// Hardware types and capability profiles.\nexport {\n  HardwareType,\n  HardwareRequirementLevel,\n  DeviceTypes,\n  ControllerTypes,\n  HARDWARE_CAPABILITIES,\n  getModelCapabilities,\n  simulatedGlasses,\n  evenRealitiesG1,\n  evenRealitiesG2,\n  mentraLive,\n  nimo,\n  rayneoIO,\n  vuzixZ100,\n  mentraDisplay,\n} from \"./types\"\nexport type {\n  HardwareRequirement,\n  CameraCapabilities,\n  DisplayCapabilities,\n  MicrophoneCapabilities,\n  SpeakerCapabilities,\n  IMUCapabilities,\n  ButtonCapabilities,\n  LightCapabilities,\n  PowerCapabilities,\n  Capabilities,\n  AppletType,\n  AppPermissionType,\n  AppletPermission,\n  AppletInterface,\n  ClientApp,\n} from \"./types\"\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `@glassly/engine` — the OEM-facing main entry.\n *\n * The `engine` namespace (configure/start/stop + typed domain facades), the\n * public contract/read-model types, and the pure helpers host UI legitimately\n * renders with (decision functions, sort/order helpers, policy constants,\n * capability tables, timers). Judgment rule: read models, commands, pure\n * functions and types belong here; anything that mutates runtime state or\n * exposes a raw store/service remains private to the Glassly host.\n * See cloud/docs/issues/020-glasses-status-boundary/integration-review.md §D.\n */\n\n// The namespaced OEM-facing engine API (the \"(A) host API\"). See ./engine.\nexport {engine} from \"./engine\"\nexport type {\n  ReportAttachmentInput,\n  ReportContext,\n  ReportDetails,\n  ReportStatus,\n  ReportTrigger,\n  ReportSubmitResult,\n  EngineSubmitReportInput,\n} from \"./facades/reports\"\nexport type {IslandNotification, IslandNotificationKind} from \"./facades/notifications\"\nexport type {PresentationOwner} from \"./services/notifications/notificationPolicy\"\nexport {DEFAULT_HIDDEN_PACKAGES, isGatedByDevTools, isSystemMiniapp} from \"./stores/appVisibility\"\nexport type {WifiSearchResult} from \"./facades/glassesWifi\"\nexport type {IdentitySnapshot} from \"./services/PairingIdentity\"\nexport type {DisplayMirrorEvent} from \"./facades/displayMirror\"\nexport type {\n  IslandConfigureOptions,\n  IslandAuth,\n  IslandConfigValues,\n  IslandAnalytics,\n  IslandUiSeams,\n  ScanQrOptions,\n  ScanQrResult,\n  SubjectTokenType,\n} from \"./runtime/bootstrap\"\n\n// Settings contract: the typed key registry (schema descriptors — the same\n// surface engine.settings.descriptor()/keys() reads), the per-key React hook\n// (the hook layer, same precedent as the apps hooks below), and the pure\n// device-model key helpers. The raw useSettingsStore stays internal;\n// imperative access goes through engine.settings.\nexport {SETTINGS, useSetting, AI_DATA_CONSENT_VERSION} from \"./stores/settings\"\nexport {isCfwFirmwareVersion, isCustomDashboardEligible} from \"./services/pages/pageEligibility\"\nexport {getEffectiveCapabilities} from \"./services/effectiveCapabilities\"\n\n// AI tier registry: the curated per-tier model dropdown options and helpers\n// the Settings > AI Models screen renders. Resolution itself runs inside\n// LocalMiniappRuntime; the screen only reads/writes the ai_model_* settings.\nexport {AI_TIERS, TIER_MODEL_OPTIONS, parseTierSetting} from \"./services/AiTierResolution\"\nexport type {AiTier, AiTierProvider, TierModelOption} from \"./services/AiTierResolution\"\n\n// Shared user memory timeline (engine.memory / Settings > Memory). Entry and\n// session shapes are canonical in @glassly/miniapp (the session.memory\n// surface); the stats read model is engine-side.\nexport type {MemoryStats} from \"./services/MemoryStore\"\nexport type {SpeakerProfile} from \"./services/SpeakerProfileStore\"\nexport type {EnrollOutcome} from \"./facades/speakers\"\nexport {MENTRA_LIVE_SETTING_KEYS, getBluetoothSettingKeysForDevice} from \"./stores/bluetoothSettingKeys\"\n\n// Runtime-shared constants and contract DTOs.\nexport {ISLAND_SETTINGS_KEYS} from \"./runtime/config\"\nexport type {CloudClientStatusSnapshot, MiniappAuthToken, InteropAuditEvent, TtsSynthesisResult} from \"./runtime/config\"\n\n// Pure readiness predicates over glasses connection state.\nexport {\n  isGlassesConnected,\n  isGlassesReady,\n  isGlassesLinkLayerBusy,\n  waitForGlassesReady,\n  type GlassesConnectionStatus,\n  type WaitForGlassesReadyOptions,\n} from \"./services/GlassesReadiness\"\n// Pure connect/reconnect decision helpers (host UI renders the outcome).\nexport {\n  decideReconnect,\n  decideConnectButtonAction,\n  type ReconnectDecision,\n  type ReconnectDecisionInput,\n  type ConnectButtonAction,\n} from \"./services/ConnectionCoordinator\"\n\n// OTA read-model types for host OTA UI (progress screen, error mapping,\n// progress section) — the check/install machinery itself is internal.\nexport type {\n  VersionInfo,\n  MtkPatch,\n  BesFirmware,\n  VersionJson,\n  OtaCheckResult,\n  OtaCheckCurrentGlassesResult,\n  OtaCheckCurrentGlassesOptions,\n} from \"./services/OtaUpdateCheckService\"\n// OTA install policy (watchdog timings + failure copy) + display-state\n// derivation, consumed by the OTA screens and their tests.\nexport {\n  MINIMUM_OTA_STATUS_BUILD,\n  MAX_RETRIES,\n  RETRY_INTERVAL_MS,\n  PROGRESS_TIMEOUT_MS,\n  DOWNLOAD_STUCK_TIMEOUT_MS,\n  MTK_INSTALL_TIMEOUT_MS,\n  GLOBAL_OTA_TIMEOUT_MS,\n  PING_INTERVAL_MS,\n  QUERY_REPLY_TIMEOUT_MS,\n  BES_RESTART_TIMEOUT_MS,\n  OtaProgressMessages,\n} from \"./services/otaInstallPolicy\"\nexport {deriveDisplayState} from \"./services/otaDisplayState\"\nexport type {DisplayState} from \"./services/otaDisplayState\"\nexport type {\n  OtaProgress,\n  OtaProgressStatus,\n  OtaStatus,\n  OtaUpdateInfo,\n  ReleaseChangelog,\n  OtaSnapshot,\n  OtaInstallSnapshot,\n} from \"./facades/ota\"\nexport {\n  beginOtaAutoChain,\n  clearOtaAutoChainReconnectWait,\n  isOtaAutoChainActive,\n  otaAutoChainFingerprint,\n  otaAutoChainReconnectWaitRemaining,\n  stopOtaAutoChain,\n  tryAdvanceOtaAutoChain,\n  MAX_OTA_AUTO_CHAIN_PASSES,\n  OTA_AUTO_CHAIN_RECONNECT_TIMEOUT_MS,\n} from \"./services/OtaAutoChain\"\nexport type {OtaAutoChainAdvanceResult} from \"./services/OtaAutoChain\"\nexport {\n  BES_INSTALL_RESTART_MESSAGE,\n  getOtaErrorMessage,\n  shouldRequireGlassesRebootForBesFailure,\n  shouldShowChangeWifiForOtaDownloadFailure,\n} from \"./services/OtaErrorMapping\"\n\n// Gallery read models: engine.gallery.onNotice payload types, the media\n// permission helper + display-name derivation host gallery UI uses, and the\n// glasses-camera DTO types (re-exported through the host @/types/asg shim).\nexport type {GalleryNotice, GalleryNoticeCode} from \"./services/asg/galleryNotices\"\nexport {MediaLibraryPermissions} from \"./utils/permissions/MediaLibraryPermissions\"\nexport {deriveGalleryDisplayName} from \"./utils/permissions/galleryDisplayName\"\nexport type {\n  PhotoInfo,\n  CaptureFile,\n  CaptureGroup,\n  GalleryResponse,\n  ServerStatus,\n  HealthResponse,\n  GalleryEvent,\n} from \"./types/asg\"\n\n// Bluetooth SDK event types host UI subscribes to via engine facades (the\n// BluetoothSdk singleton passthrough itself is internal).\nexport type {PairFailureEvent, GlassesNotReadyEvent} from \"@glassly/bluetooth-sdk\"\n\n// Cloud connection status enum (read model; the connection store is internal).\nexport {WebSocketStatus} from \"./stores/connection\"\n\n// App-list hook layer + pure list helpers (the raw useAppStatusStore and\n// installAppStoreHooks wiring are internal).\nexport {\n  DUMMY_APPLET,\n  saveAppsOrder,\n  getAppsOrder,\n  sortAppsByPackageNamePriority,\n  saveLastOpenTime,\n  getLastOpenTime,\n  sortAppsByLastOpenTime,\n  useApps,\n  useStart,\n  useStop,\n  useSetForeground,\n  useClearForeground,\n  useRefresh,\n  useStopAll,\n  useInstall,\n  useUninstall,\n  useActiveApps,\n  useRunningAlwaysOnApps,\n  useActiveBackgroundApps,\n  useBackgroundApps,\n  useActiveForegroundApp,\n  useForegroundApp,\n  useActiveBackgroundAppsCount,\n  useLocalMiniApps,\n  type StartOptions,\n  type OrderMap,\n} from \"./stores/apps\"\n\n// Pure dev-miniapp launch-route decision (registration itself is internal).\nexport {\n  decideDevLaunchRoute,\n  type DecideDevLaunchOptions,\n  type DevLaunchResult,\n  type DevManifest,\n} from \"./utils/devMiniappLaunch\"\nexport {HardwareCompatibility, type CompatibilityResult} from \"./utils/hardware\"\nexport {BgTimer} from \"./utils/timers\"\n// Meta Neural Band: the account sign-in a claim needs (the WebView lives in the host).\nexport {\n  MetaAuthError,\n  authEntryUrl,\n  callbackMatches,\n  callbackQuery,\n  decryptBlob,\n  isLoginCallback,\n  login,\n  tokensQuery,\n  type MetaSession,\n  type MetaSsoTokens,\n} from \"./services/neuralBand/MetaAuth\"\nexport type {NeuralBandClaimStatus, NeuralBandHandwritingStatus} from \"./services/neuralBand/NeuralBandInput\"\n\n// Hardware types and capability profiles.\nexport {\n  HardwareType,\n  HardwareRequirementLevel,\n  DeviceTypes,\n  ControllerTypes,\n  HARDWARE_CAPABILITIES,\n  getModelCapabilities,\n  simulatedGlasses,\n  evenRealitiesG1,\n  evenRealitiesG2,\n  mentraLive,\n  nimo,\n  rayneoIO,\n  vuzixZ100,\n  mentraDisplay,\n} from \"./types\"\nexport type {\n  HardwareRequirement,\n  CameraCapabilities,\n  DisplayCapabilities,\n  MicrophoneCapabilities,\n  SpeakerCapabilities,\n  IMUCapabilities,\n  ButtonCapabilities,\n  LightCapabilities,\n  PowerCapabilities,\n  Capabilities,\n  AppletType,\n  AppPermissionType,\n  AppletPermission,\n  AppletInterface,\n  ClientApp,\n} from \"./types\"\n"]}

package/build/utils/timers/index.d.ts

@@ -1,3 +1,2 @@
-import { BgTimer, throttle, debounce } from "./timers";
-export { BgTimer, throttle, debounce };
+export { BgTimer } from "./timers";
 //# sourceMappingURL=index.d.ts.map

package/build/utils/timers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/timers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAC,MAAM,UAAU,CAAA;AACpD,OAAO,EAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/timers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,UAAU,CAAA"}

package/build/utils/timers/index.js

@@ -1,3 +1,2 @@
-import { BgTimer, throttle, debounce } from "./timers";
-export { BgTimer, throttle, debounce };
+export { BgTimer } from "./timers";
 //# sourceMappingURL=index.js.map

package/build/utils/timers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/timers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAC,MAAM,UAAU,CAAA;AACpD,OAAO,EAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAC,CAAA","sourcesContent":["import {BgTimer, throttle, debounce} from \"./timers\"\nexport {BgTimer, throttle, debounce}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/timers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,UAAU,CAAA","sourcesContent":["export {BgTimer} from \"./timers\"\n"]}

package/build/utils/timers/timers.d.ts

@@ -1,9 +1,7 @@
 export declare class BgTimer {
-    static setInterval(callback: () => void, delay: number): number;
-    static clearInterval(intervalId: number): void;
     static setTimeout(callback: () => void, delay: number): number;
-    static clearTimeout(timeoutId: number): void;
+    static clearTimeout(id: number): void;
+    static setInterval(callback: () => void, delay: number): number;
+    static clearInterval(id: number): void;
 }
-export declare function throttle<T extends (...args: any[]) => any>(fn: T, ms: number): (...args: Parameters<T>) => void;
-export declare function debounce<T extends (...args: any[]) => any>(fn: T, ms: number): (...args: Parameters<T>) => void;
 //# sourceMappingURL=timers.d.ts.map

package/build/utils/timers/timers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timers.d.ts","sourceRoot":"","sources":["../../../src/utils/timers/timers.ts"],"names":[],"mappings":"AAoJA,qBAAa,OAAO;IAClB,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAO/D,MAAM,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAO9C,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAO9D,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAM7C;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAU/G;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAY/G"}
+{"version":3,"file":"timers.d.ts","sourceRoot":"","sources":["../../../src/utils/timers/timers.ts"],"names":[],"mappings":"AA+GA,qBAAa,OAAO;IAClB,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAI9D,MAAM,CAAC,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIrC,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAI/D,MAAM,CAAC,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;CAGvC"}

package/build/utils/timers/timers.js

@@ -1,164 +1,114 @@
-// BgTimer — background-safe timers for the engine.
+// BgTimer: every engine timer (miniapp liveness watchdog, display expiries,
+// boot windows, token refresh) goes through here. Android pauses plain JS
+// timers while the app is backgrounded, so on a device these run on the
+// native react-native-nitro-bg-timer instead. iOS needs that package at
+// >= 0.2.0: earlier versions cleared each timer right after scheduling it
+// (https://github.com/tconns/react-native-nitro-bg-timer/issues/2).
 //
-// Everything timing-critical in the engine runs through this class: the
-// miniapp liveness watchdog, display durationMs expiries, boot windows,
-// auth-token refresh. On Android, React Native PAUSES plain JS timers while
-// the app is backgrounded, so those features only keep working in the
-// background when the native implementation (react-native-nitro-bg-timer)
-// is active.
+// Dev and release behave the same; there is no env switch. A missing native
+// module falls back to JS timers so the foreground keeps working, and says so
+// once, loudly: a quiet fallback already cost a day of phantom "zombie
+// miniapp" bugs (OS-1790). Never downgrade that report to a warning.
 //
-// Who actually gets native timers:
-//   - Android, dev AND release: always attempted — dev must match production
-//     background behavior. There is no opt-in/opt-out env var. If the native
-//     module is unavailable (a dev client whose binary predates it, or a
-//     broken release binary), the failure is LOUD: a console.error with the
-//     remediation, plus a blocking dev alert. The JS-timer fallback still
-//     engages so foreground behavior keeps working, but backgrounded
-//     behavior is broken until the native rebuild — the error says exactly
-//     that. (A silent dev fallback previously cost a full debugging day of
-//     phantom "zombie miniapp" bugs; see OS-1790.)
-//   - iOS: never, dev or prod — the package is disabled pending
-//     https://github.com/tconns/react-native-nitro-bg-timer/issues/2. iOS
-//     suspends the whole process in background anyway, so background timing
-//     there is handled by native per-device queues, not JS timers.
-//
-// react-native is loaded lazily, not imported. Every engine service runs its
-// timers through this module, and the engine's bun test suites load those
-// services in a plain JS runtime that cannot parse react-native's Flow
-// source. A static import would force every such suite to mock this module;
-// with the lazy load, a runtime without react-native simply gets the JS
-// timers, which is the correct answer there anyway.
+// react-native and the nitro packages are require()d lazily. The engine's bun
+// suites run services in a plain JS runtime that cannot parse react-native;
+// there the native lookup finds no platform and JS timers are the right answer.
+const TIMER_METHODS = ["setTimeout", "clearTimeout", "setInterval", "clearInterval"];
+const jsTimers = {
+    setTimeout: (callback, delay) => setTimeout(callback, delay),
+    clearTimeout: (id) => clearTimeout(id),
+    setInterval: (callback, delay) => setInterval(callback, delay),
+    clearInterval: (id) => clearInterval(id),
+};
 let reactNative;
-function getReactNative() {
-    if (reactNative !== undefined) {
-        return reactNative;
-    }
-    try {
-        reactNative = require("react-native");
-    }
-    catch {
-        reactNative = null;
+// undefined = not looked up yet, null = unavailable (JS timers from here on).
+let nativeTimers;
+let reported = false;
+function loadReactNative() {
+    if (reactNative === undefined) {
+        try {
+            reactNative = require("react-native");
+        }
+        catch {
+            reactNative = null;
+        }
     }
     return reactNative;
 }
-function isDev() {
-    return typeof __DEV__ !== "undefined" && __DEV__;
-}
-let nitroTimer;
-let nitroDisabled = false;
-let failedLoud = false;
-/**
- * The native background timer is unavailable — say so ONCE, loudly, with the
- * remediation. The JS-timer fallback keeps foreground behavior working, but
- * everything timing-driven freezes while the app is backgrounded, which
- * presents as phantom miniapp bugs (frozen captions, missed wake words,
- * watchdog kills on resume). A quiet warning here has already cost a full
- * debugging day; never downgrade this to console.warn.
- */
-function failUnavailable(reason) {
-    if (failedLoud) {
+function reportUnavailable(reason) {
+    if (reported)
         return;
-    }
-    failedLoud = true;
+    reported = true;
+    const rn = loadReactNative();
+    const platform = rn?.Platform.OS === "ios" ? "ios" : "android";
     const message = `BgTimer: native background timer unavailable (${reason}). ` +
-        "Backgrounded behavior IS BROKEN until you rebuild the Android app: run `bun android`. " +
+        `Backgrounded behavior IS BROKEN until you rebuild the app: run \`bun ${platform}\`. ` +
         "Engine timers and local miniapps (captions, wake words) freeze whenever the app is not foregrounded.";
     console.error(message);
-    if (isDev()) {
-        // A stale dev client may ALSO show the library's own require-time red box
-        // (bridgeless LogBox surfaces it even though we catch below) — this alert
-        // is the actionable one: it names the fix.
+    if (typeof __DEV__ !== "undefined" && __DEV__) {
+        // A stale dev client may also red-box inside the library itself; this
+        // alert is the one that names the fix.
         try {
-            getReactNative()?.Alert?.alert("Background timers unavailable", message);
+            rn?.Alert?.alert("Background timers unavailable", message);
         }
         catch {
-            /* Alert not available (tests / headless) — the console.error stands. */
+            // Headless runtime: the console.error stands.
         }
     }
 }
-function getNitroTimer() {
-    if (nitroDisabled || getReactNative()?.Platform.OS !== "android") {
+function loadNativeTimers() {
+    if (nativeTimers !== undefined)
+        return nativeTimers;
+    const platform = loadReactNative()?.Platform.OS;
+    if (platform !== "android" && platform !== "ios") {
+        nativeTimers = null;
         return null;
     }
-    if (nitroTimer !== undefined) {
-        return nitroTimer;
-    }
     try {
         const { isRuntimeAlive } = require("react-native-nitro-modules");
-        if (typeof isRuntimeAlive === "function" && !isRuntimeAlive()) {
-            nitroTimer = null;
-            failUnavailable("nitro runtime is not alive");
-            return nitroTimer;
-        }
+        if (typeof isRuntimeAlive === "function" && !isRuntimeAlive())
+            throw new Error("nitro runtime is not alive");
         const { BackgroundTimer } = require("react-native-nitro-bg-timer");
-        nitroTimer =
-            BackgroundTimer &&
-                typeof BackgroundTimer.setTimeout === "function" &&
-                typeof BackgroundTimer.setInterval === "function" &&
-                typeof BackgroundTimer.clearTimeout === "function" &&
-                typeof BackgroundTimer.clearInterval === "function"
-                ? BackgroundTimer
-                : null;
-    }
-    catch {
-        nitroTimer = null;
-        nitroDisabled = true;
+        for (const method of TIMER_METHODS) {
+            if (typeof BackgroundTimer?.[method] !== "function")
+                throw new Error(`BackgroundTimer.${method} missing`);
+        }
+        nativeTimers = BackgroundTimer;
     }
-    if (!nitroTimer) {
-        failUnavailable("react-native-nitro-bg-timer failed to load");
+    catch (error) {
+        nativeTimers = null;
+        reportUnavailable(error instanceof Error ? error.message : String(error));
     }
-    return nitroTimer;
+    return nativeTimers;
 }
-function withNitro(run, fallback) {
-    const api = getNitroTimer();
-    if (!api) {
-        return fallback();
-    }
+// A native call that throws mid-session is new information: drop to JS timers
+// and announce again.
+function call(run) {
+    const native = loadNativeTimers();
+    if (!native)
+        return run(jsTimers);
     try {
-        return run(api);
+        return run(native);
     }
     catch (error) {
-        nitroDisabled = true;
-        nitroTimer = null;
-        failedLoud = false; // a mid-session failure is new information — re-announce
-        failUnavailable(`nitro timer call threw: ${String(error)}`);
-        return fallback();
+        nativeTimers = null;
+        reported = false;
+        reportUnavailable(`native timer call threw: ${String(error)}`);
+        return run(jsTimers);
     }
 }
 export class BgTimer {
-    static setInterval(callback, delay) {
-        return withNitro((api) => api.setInterval(callback, delay), () => setInterval(callback, delay));
+    static setTimeout(callback, delay) {
+        return call((timers) => timers.setTimeout(callback, delay));
     }
-    static clearInterval(intervalId) {
-        withNitro((api) => api.clearInterval(intervalId), () => clearInterval(intervalId));
+    static clearTimeout(id) {
+        call((timers) => timers.clearTimeout(id));
     }
-    static setTimeout(callback, delay) {
-        return withNitro((api) => api.setTimeout(callback, delay), () => setTimeout(callback, delay));
+    static setInterval(callback, delay) {
+        return call((timers) => timers.setInterval(callback, delay));
     }
-    static clearTimeout(timeoutId) {
-        withNitro((api) => api.clearTimeout(timeoutId), () => clearTimeout(timeoutId));
+    static clearInterval(id) {
+        call((timers) => timers.clearInterval(id));
     }
 }
-export function throttle(fn, ms) {
-    let lastCalled = 0;
-    return (...args) => {
-        const now = Date.now();
-        if (now - lastCalled >= ms) {
-            lastCalled = now;
-            fn(...args);
-        }
-    };
-}
-export function debounce(fn, ms) {
-    let timeoutId = null;
-    return (...args) => {
-        if (timeoutId) {
-            BgTimer.clearTimeout(timeoutId);
-        }
-        timeoutId = BgTimer.setTimeout(() => {
-            fn(...args);
-            timeoutId = null;
-        }, ms);
-    };
-}
 //# sourceMappingURL=timers.js.map

package/build/utils/timers/timers.js.map

@@ -1 +1 @@
-{"version":3,"file":"timers.js","sourceRoot":"","sources":["../../../src/utils/timers/timers.ts"],"names":[],"mappings":"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","sourcesContent":["// BgTimer — background-safe timers for the engine.\n//\n// Everything timing-critical in the engine runs through this class: the\n// miniapp liveness watchdog, display durationMs expiries, boot windows,\n// auth-token refresh. On Android, React Native PAUSES plain JS timers while\n// the app is backgrounded, so those features only keep working in the\n// background when the native implementation (react-native-nitro-bg-timer)\n// is active.\n//\n// Who actually gets native timers:\n//   - Android, dev AND release: always attempted — dev must match production\n//     background behavior. There is no opt-in/opt-out env var. If the native\n//     module is unavailable (a dev client whose binary predates it, or a\n//     broken release binary), the failure is LOUD: a console.error with the\n//     remediation, plus a blocking dev alert. The JS-timer fallback still\n//     engages so foreground behavior keeps working, but backgrounded\n//     behavior is broken until the native rebuild — the error says exactly\n//     that. (A silent dev fallback previously cost a full debugging day of\n//     phantom \"zombie miniapp\" bugs; see OS-1790.)\n//   - iOS: never, dev or prod — the package is disabled pending\n//     https://github.com/tconns/react-native-nitro-bg-timer/issues/2. iOS\n//     suspends the whole process in background anyway, so background timing\n//     there is handled by native per-device queues, not JS timers.\n//\n// react-native is loaded lazily, not imported. Every engine service runs its\n// timers through this module, and the engine's bun test suites load those\n// services in a plain JS runtime that cannot parse react-native's Flow\n// source. A static import would force every such suite to mock this module;\n// with the lazy load, a runtime without react-native simply gets the JS\n// timers, which is the correct answer there anyway.\n\ntype ReactNativeSubset = {\n  Platform: {OS: string}\n  Alert?: {alert: (title: string, message?: string) => void}\n}\n\nlet reactNative: ReactNativeSubset | null | undefined\n\nfunction getReactNative(): ReactNativeSubset | null {\n  if (reactNative !== undefined) {\n    return reactNative\n  }\n  try {\n    reactNative = require(\"react-native\") as ReactNativeSubset\n  } catch {\n    reactNative = null\n  }\n  return reactNative\n}\n\nfunction isDev(): boolean {\n  return typeof __DEV__ !== \"undefined\" && __DEV__\n}\n\ntype NitroTimerApi = {\n  setInterval: (callback: () => void, delay: number) => number\n  clearInterval: (intervalId: number) => void\n  setTimeout: (callback: () => void, delay: number) => number\n  clearTimeout: (timeoutId: number) => void\n}\n\nlet nitroTimer: NitroTimerApi | null | undefined\nlet nitroDisabled = false\nlet failedLoud = false\n\n/**\n * The native background timer is unavailable — say so ONCE, loudly, with the\n * remediation. The JS-timer fallback keeps foreground behavior working, but\n * everything timing-driven freezes while the app is backgrounded, which\n * presents as phantom miniapp bugs (frozen captions, missed wake words,\n * watchdog kills on resume). A quiet warning here has already cost a full\n * debugging day; never downgrade this to console.warn.\n */\nfunction failUnavailable(reason: string) {\n  if (failedLoud) {\n    return\n  }\n  failedLoud = true\n  const message =\n    `BgTimer: native background timer unavailable (${reason}). ` +\n    \"Backgrounded behavior IS BROKEN until you rebuild the Android app: run `bun android`. \" +\n    \"Engine timers and local miniapps (captions, wake words) freeze whenever the app is not foregrounded.\"\n  console.error(message)\n  if (isDev()) {\n    // A stale dev client may ALSO show the library's own require-time red box\n    // (bridgeless LogBox surfaces it even though we catch below) — this alert\n    // is the actionable one: it names the fix.\n    try {\n      getReactNative()?.Alert?.alert(\"Background timers unavailable\", message)\n    } catch {\n      /* Alert not available (tests / headless) — the console.error stands. */\n    }\n  }\n}\n\nfunction getNitroTimer(): NitroTimerApi | null {\n  if (nitroDisabled || getReactNative()?.Platform.OS !== \"android\") {\n    return null\n  }\n\n  if (nitroTimer !== undefined) {\n    return nitroTimer\n  }\n\n  try {\n    const {isRuntimeAlive} = require(\"react-native-nitro-modules\") as {isRuntimeAlive?: () => boolean}\n    if (typeof isRuntimeAlive === \"function\" && !isRuntimeAlive()) {\n      nitroTimer = null\n      failUnavailable(\"nitro runtime is not alive\")\n      return nitroTimer\n    }\n\n    const {BackgroundTimer} = require(\"react-native-nitro-bg-timer\") as {BackgroundTimer?: NitroTimerApi}\n    nitroTimer =\n      BackgroundTimer &&\n      typeof BackgroundTimer.setTimeout === \"function\" &&\n      typeof BackgroundTimer.setInterval === \"function\" &&\n      typeof BackgroundTimer.clearTimeout === \"function\" &&\n      typeof BackgroundTimer.clearInterval === \"function\"\n        ? BackgroundTimer\n        : null\n  } catch {\n    nitroTimer = null\n    nitroDisabled = true\n  }\n\n  if (!nitroTimer) {\n    failUnavailable(\"react-native-nitro-bg-timer failed to load\")\n  }\n  return nitroTimer\n}\n\nfunction withNitro<T>(run: (api: NitroTimerApi) => T, fallback: () => T): T {\n  const api = getNitroTimer()\n  if (!api) {\n    return fallback()\n  }\n  try {\n    return run(api)\n  } catch (error) {\n    nitroDisabled = true\n    nitroTimer = null\n    failedLoud = false // a mid-session failure is new information — re-announce\n    failUnavailable(`nitro timer call threw: ${String(error)}`)\n    return fallback()\n  }\n}\n\nexport class BgTimer {\n  static setInterval(callback: () => void, delay: number): number {\n    return withNitro(\n      (api) => api.setInterval(callback, delay),\n      () => setInterval(callback, delay) as unknown as number,\n    )\n  }\n\n  static clearInterval(intervalId: number): void {\n    withNitro(\n      (api) => api.clearInterval(intervalId),\n      () => clearInterval(intervalId),\n    )\n  }\n\n  static setTimeout(callback: () => void, delay: number): number {\n    return withNitro(\n      (api) => api.setTimeout(callback, delay),\n      () => setTimeout(callback, delay) as unknown as number,\n    )\n  }\n\n  static clearTimeout(timeoutId: number): void {\n    withNitro(\n      (api) => api.clearTimeout(timeoutId),\n      () => clearTimeout(timeoutId),\n    )\n  }\n}\n\nexport function throttle<T extends (...args: any[]) => any>(fn: T, ms: number): (...args: Parameters<T>) => void {\n  let lastCalled = 0\n\n  return (...args: Parameters<T>) => {\n    const now = Date.now()\n    if (now - lastCalled >= ms) {\n      lastCalled = now\n      fn(...args)\n    }\n  }\n}\n\nexport function debounce<T extends (...args: any[]) => any>(fn: T, ms: number): (...args: Parameters<T>) => void {\n  let timeoutId: number | null = null\n\n  return (...args: Parameters<T>) => {\n    if (timeoutId) {\n      BgTimer.clearTimeout(timeoutId)\n    }\n    timeoutId = BgTimer.setTimeout(() => {\n      fn(...args)\n      timeoutId = null\n    }, ms)\n  }\n}\n"]}
+{"version":3,"file":"timers.js","sourceRoot":"","sources":["../../../src/utils/timers/timers.ts"],"names":[],"mappings":"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","sourcesContent":["// BgTimer: every engine timer (miniapp liveness watchdog, display expiries,\n// boot windows, token refresh) goes through here. Android pauses plain JS\n// timers while the app is backgrounded, so on a device these run on the\n// native react-native-nitro-bg-timer instead. iOS needs that package at\n// >= 0.2.0: earlier versions cleared each timer right after scheduling it\n// (https://github.com/tconns/react-native-nitro-bg-timer/issues/2).\n//\n// Dev and release behave the same; there is no env switch. A missing native\n// module falls back to JS timers so the foreground keeps working, and says so\n// once, loudly: a quiet fallback already cost a day of phantom \"zombie\n// miniapp\" bugs (OS-1790). Never downgrade that report to a warning.\n//\n// react-native and the nitro packages are require()d lazily. The engine's bun\n// suites run services in a plain JS runtime that cannot parse react-native;\n// there the native lookup finds no platform and JS timers are the right answer.\n\ntype TimerApi = {\n  setTimeout(callback: () => void, delay: number): number\n  clearTimeout(id: number): void\n  setInterval(callback: () => void, delay: number): number\n  clearInterval(id: number): void\n}\n\ntype ReactNativeSubset = {\n  Platform: {OS: string}\n  Alert?: {alert(title: string, message?: string): void}\n}\n\nconst TIMER_METHODS = [\"setTimeout\", \"clearTimeout\", \"setInterval\", \"clearInterval\"] as const\n\nconst jsTimers: TimerApi = {\n  setTimeout: (callback, delay) => setTimeout(callback, delay) as unknown as number,\n  clearTimeout: (id) => clearTimeout(id),\n  setInterval: (callback, delay) => setInterval(callback, delay) as unknown as number,\n  clearInterval: (id) => clearInterval(id),\n}\n\nlet reactNative: ReactNativeSubset | null | undefined\n// undefined = not looked up yet, null = unavailable (JS timers from here on).\nlet nativeTimers: TimerApi | null | undefined\nlet reported = false\n\nfunction loadReactNative(): ReactNativeSubset | null {\n  if (reactNative === undefined) {\n    try {\n      reactNative = require(\"react-native\") as ReactNativeSubset\n    } catch {\n      reactNative = null\n    }\n  }\n  return reactNative\n}\n\nfunction reportUnavailable(reason: string): void {\n  if (reported) return\n  reported = true\n  const rn = loadReactNative()\n  const platform = rn?.Platform.OS === \"ios\" ? \"ios\" : \"android\"\n  const message =\n    `BgTimer: native background timer unavailable (${reason}). ` +\n    `Backgrounded behavior IS BROKEN until you rebuild the app: run \\`bun ${platform}\\`. ` +\n    \"Engine timers and local miniapps (captions, wake words) freeze whenever the app is not foregrounded.\"\n  console.error(message)\n  if (typeof __DEV__ !== \"undefined\" && __DEV__) {\n    // A stale dev client may also red-box inside the library itself; this\n    // alert is the one that names the fix.\n    try {\n      rn?.Alert?.alert(\"Background timers unavailable\", message)\n    } catch {\n      // Headless runtime: the console.error stands.\n    }\n  }\n}\n\nfunction loadNativeTimers(): TimerApi | null {\n  if (nativeTimers !== undefined) return nativeTimers\n  const platform = loadReactNative()?.Platform.OS\n  if (platform !== \"android\" && platform !== \"ios\") {\n    nativeTimers = null\n    return null\n  }\n  try {\n    const {isRuntimeAlive} = require(\"react-native-nitro-modules\") as {isRuntimeAlive?: () => boolean}\n    if (typeof isRuntimeAlive === \"function\" && !isRuntimeAlive()) throw new Error(\"nitro runtime is not alive\")\n    const {BackgroundTimer} = require(\"react-native-nitro-bg-timer\") as {BackgroundTimer?: Partial<TimerApi>}\n    for (const method of TIMER_METHODS) {\n      if (typeof BackgroundTimer?.[method] !== \"function\") throw new Error(`BackgroundTimer.${method} missing`)\n    }\n    nativeTimers = BackgroundTimer as TimerApi\n  } catch (error) {\n    nativeTimers = null\n    reportUnavailable(error instanceof Error ? error.message : String(error))\n  }\n  return nativeTimers\n}\n\n// A native call that throws mid-session is new information: drop to JS timers\n// and announce again.\nfunction call<T>(run: (timers: TimerApi) => T): T {\n  const native = loadNativeTimers()\n  if (!native) return run(jsTimers)\n  try {\n    return run(native)\n  } catch (error) {\n    nativeTimers = null\n    reported = false\n    reportUnavailable(`native timer call threw: ${String(error)}`)\n    return run(jsTimers)\n  }\n}\n\nexport class BgTimer {\n  static setTimeout(callback: () => void, delay: number): number {\n    return call((timers) => timers.setTimeout(callback, delay))\n  }\n\n  static clearTimeout(id: number): void {\n    call((timers) => timers.clearTimeout(id))\n  }\n\n  static setInterval(callback: () => void, delay: number): number {\n    return call((timers) => timers.setInterval(callback, delay))\n  }\n\n  static clearInterval(id: number): void {\n    call((timers) => timers.clearInterval(id))\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glassly/engine",
-  "version": "0.3.3-dev.644",
+  "version": "0.3.3-dev.645",
   "description": "Glassly Engine — miniapp registry, WebView bridge, and miniapp store",
   "main": "build/index.js",
   "react-native": "src/index.ts",
@@ -97,17 +97,17 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@glassly/bluetooth-sdk": "0.3.3-dev.644",
-    "@glassly/cloud-client": "0.3.3-dev.644",
-    "@glassly/cloud-protocol": "0.3.3-dev.644",
-    "@glassly/crust": "0.3.3-dev.644",
-    "@glassly/miniapp": "0.3.3-dev.644",
+    "@glassly/bluetooth-sdk": "0.3.3-dev.645",
+    "@glassly/cloud-client": "0.3.3-dev.645",
+    "@glassly/cloud-protocol": "0.3.3-dev.645",
+    "@glassly/crust": "0.3.3-dev.645",
+    "@glassly/miniapp": "0.3.3-dev.645",
     "buffer": "^6.0.3",
     "events": "^3.3.0",
     "react-native-marked": "8.1.1",
     "semver": "^7.7.4",
     "typesafe-ts": "^1.7.1",
-    "@glassly/llm-providers": "0.3.3-dev.644"
+    "@glassly/llm-providers": "0.3.3-dev.645"
   },
   "devDependencies": {
     "@glassly/llm-providers": "workspace:*",

package/src/generated/releaseMetadata.ts

@@ -12,9 +12,9 @@ export interface EngineReleaseMetadata {
 export const ENGINE_RELEASE_METADATA: Readonly<EngineReleaseMetadata> = Object.freeze({
   "schemaVersion": 1,
   "familyBaseVersion": "0.3.3",
-  "releaseIdentity": "0.3.3-dev.644",
-  "releaseSetId": "glassly-0.3.3-dev.644",
-  "sourceCommit": "7efbf5ec37d31b5589b9c9aedbb3159424e82a05",
+  "releaseIdentity": "0.3.3-dev.645",
+  "releaseSetId": "glassly-0.3.3-dev.645",
+  "sourceCommit": "d448896b180f4eb054a597d2c460d6eae8841a64",
   "otaManifestUrl": null,
   "otaManifestSha256": null
 })

package/src/index.ts

@@ -201,7 +201,7 @@ export {
   type DevManifest,
 } from "./utils/devMiniappLaunch"
 export {HardwareCompatibility, type CompatibilityResult} from "./utils/hardware"
-export {BgTimer, throttle, debounce} from "./utils/timers"
+export {BgTimer} from "./utils/timers"
 // Meta Neural Band: the account sign-in a claim needs (the WebView lives in the host).
 export {
   MetaAuthError,

package/src/utils/timers/index.ts

@@ -1,2 +1 @@
-import {BgTimer, throttle, debounce} from "./timers"
-export {BgTimer, throttle, debounce}
+export {BgTimer} from "./timers"

package/src/utils/timers/timers.ts

@@ -1,203 +1,128 @@
-// BgTimer — background-safe timers for the engine.
+// BgTimer: every engine timer (miniapp liveness watchdog, display expiries,
+// boot windows, token refresh) goes through here. Android pauses plain JS
+// timers while the app is backgrounded, so on a device these run on the
+// native react-native-nitro-bg-timer instead. iOS needs that package at
+// >= 0.2.0: earlier versions cleared each timer right after scheduling it
+// (https://github.com/tconns/react-native-nitro-bg-timer/issues/2).
 //
-// Everything timing-critical in the engine runs through this class: the
-// miniapp liveness watchdog, display durationMs expiries, boot windows,
-// auth-token refresh. On Android, React Native PAUSES plain JS timers while
-// the app is backgrounded, so those features only keep working in the
-// background when the native implementation (react-native-nitro-bg-timer)
-// is active.
+// Dev and release behave the same; there is no env switch. A missing native
+// module falls back to JS timers so the foreground keeps working, and says so
+// once, loudly: a quiet fallback already cost a day of phantom "zombie
+// miniapp" bugs (OS-1790). Never downgrade that report to a warning.
 //
-// Who actually gets native timers:
-//   - Android, dev AND release: always attempted — dev must match production
-//     background behavior. There is no opt-in/opt-out env var. If the native
-//     module is unavailable (a dev client whose binary predates it, or a
-//     broken release binary), the failure is LOUD: a console.error with the
-//     remediation, plus a blocking dev alert. The JS-timer fallback still
-//     engages so foreground behavior keeps working, but backgrounded
-//     behavior is broken until the native rebuild — the error says exactly
-//     that. (A silent dev fallback previously cost a full debugging day of
-//     phantom "zombie miniapp" bugs; see OS-1790.)
-//   - iOS: never, dev or prod — the package is disabled pending
-//     https://github.com/tconns/react-native-nitro-bg-timer/issues/2. iOS
-//     suspends the whole process in background anyway, so background timing
-//     there is handled by native per-device queues, not JS timers.
-//
-// react-native is loaded lazily, not imported. Every engine service runs its
-// timers through this module, and the engine's bun test suites load those
-// services in a plain JS runtime that cannot parse react-native's Flow
-// source. A static import would force every such suite to mock this module;
-// with the lazy load, a runtime without react-native simply gets the JS
-// timers, which is the correct answer there anyway.
+// react-native and the nitro packages are require()d lazily. The engine's bun
+// suites run services in a plain JS runtime that cannot parse react-native;
+// there the native lookup finds no platform and JS timers are the right answer.
+
+type TimerApi = {
+  setTimeout(callback: () => void, delay: number): number
+  clearTimeout(id: number): void
+  setInterval(callback: () => void, delay: number): number
+  clearInterval(id: number): void
+}
 
 type ReactNativeSubset = {
   Platform: {OS: string}
-  Alert?: {alert: (title: string, message?: string) => void}
+  Alert?: {alert(title: string, message?: string): void}
 }
 
-let reactNative: ReactNativeSubset | null | undefined
+const TIMER_METHODS = ["setTimeout", "clearTimeout", "setInterval", "clearInterval"] as const
 
-function getReactNative(): ReactNativeSubset | null {
-  if (reactNative !== undefined) {
-    return reactNative
-  }
-  try {
-    reactNative = require("react-native") as ReactNativeSubset
-  } catch {
-    reactNative = null
-  }
-  return reactNative
+const jsTimers: TimerApi = {
+  setTimeout: (callback, delay) => setTimeout(callback, delay) as unknown as number,
+  clearTimeout: (id) => clearTimeout(id),
+  setInterval: (callback, delay) => setInterval(callback, delay) as unknown as number,
+  clearInterval: (id) => clearInterval(id),
 }
 
-function isDev(): boolean {
-  return typeof __DEV__ !== "undefined" && __DEV__
-}
+let reactNative: ReactNativeSubset | null | undefined
+// undefined = not looked up yet, null = unavailable (JS timers from here on).
+let nativeTimers: TimerApi | null | undefined
+let reported = false
 
-type NitroTimerApi = {
-  setInterval: (callback: () => void, delay: number) => number
-  clearInterval: (intervalId: number) => void
-  setTimeout: (callback: () => void, delay: number) => number
-  clearTimeout: (timeoutId: number) => void
+function loadReactNative(): ReactNativeSubset | null {
+  if (reactNative === undefined) {
+    try {
+      reactNative = require("react-native") as ReactNativeSubset
+    } catch {
+      reactNative = null
+    }
+  }
+  return reactNative
 }
 
-let nitroTimer: NitroTimerApi | null | undefined
-let nitroDisabled = false
-let failedLoud = false
-
-/**
- * The native background timer is unavailable — say so ONCE, loudly, with the
- * remediation. The JS-timer fallback keeps foreground behavior working, but
- * everything timing-driven freezes while the app is backgrounded, which
- * presents as phantom miniapp bugs (frozen captions, missed wake words,
- * watchdog kills on resume). A quiet warning here has already cost a full
- * debugging day; never downgrade this to console.warn.
- */
-function failUnavailable(reason: string) {
-  if (failedLoud) {
-    return
-  }
-  failedLoud = true
+function reportUnavailable(reason: string): void {
+  if (reported) return
+  reported = true
+  const rn = loadReactNative()
+  const platform = rn?.Platform.OS === "ios" ? "ios" : "android"
   const message =
     `BgTimer: native background timer unavailable (${reason}). ` +
-    "Backgrounded behavior IS BROKEN until you rebuild the Android app: run `bun android`. " +
+    `Backgrounded behavior IS BROKEN until you rebuild the app: run \`bun ${platform}\`. ` +
     "Engine timers and local miniapps (captions, wake words) freeze whenever the app is not foregrounded."
   console.error(message)
-  if (isDev()) {
-    // A stale dev client may ALSO show the library's own require-time red box
-    // (bridgeless LogBox surfaces it even though we catch below) — this alert
-    // is the actionable one: it names the fix.
+  if (typeof __DEV__ !== "undefined" && __DEV__) {
+    // A stale dev client may also red-box inside the library itself; this
+    // alert is the one that names the fix.
     try {
-      getReactNative()?.Alert?.alert("Background timers unavailable", message)
+      rn?.Alert?.alert("Background timers unavailable", message)
     } catch {
-      /* Alert not available (tests / headless) — the console.error stands. */
+      // Headless runtime: the console.error stands.
     }
   }
 }
 
-function getNitroTimer(): NitroTimerApi | null {
-  if (nitroDisabled || getReactNative()?.Platform.OS !== "android") {
+function loadNativeTimers(): TimerApi | null {
+  if (nativeTimers !== undefined) return nativeTimers
+  const platform = loadReactNative()?.Platform.OS
+  if (platform !== "android" && platform !== "ios") {
+    nativeTimers = null
     return null
   }
-
-  if (nitroTimer !== undefined) {
-    return nitroTimer
-  }
-
   try {
     const {isRuntimeAlive} = require("react-native-nitro-modules") as {isRuntimeAlive?: () => boolean}
-    if (typeof isRuntimeAlive === "function" && !isRuntimeAlive()) {
-      nitroTimer = null
-      failUnavailable("nitro runtime is not alive")
-      return nitroTimer
+    if (typeof isRuntimeAlive === "function" && !isRuntimeAlive()) throw new Error("nitro runtime is not alive")
+    const {BackgroundTimer} = require("react-native-nitro-bg-timer") as {BackgroundTimer?: Partial<TimerApi>}
+    for (const method of TIMER_METHODS) {
+      if (typeof BackgroundTimer?.[method] !== "function") throw new Error(`BackgroundTimer.${method} missing`)
     }
-
-    const {BackgroundTimer} = require("react-native-nitro-bg-timer") as {BackgroundTimer?: NitroTimerApi}
-    nitroTimer =
-      BackgroundTimer &&
-      typeof BackgroundTimer.setTimeout === "function" &&
-      typeof BackgroundTimer.setInterval === "function" &&
-      typeof BackgroundTimer.clearTimeout === "function" &&
-      typeof BackgroundTimer.clearInterval === "function"
-        ? BackgroundTimer
-        : null
-  } catch {
-    nitroTimer = null
-    nitroDisabled = true
-  }
-
-  if (!nitroTimer) {
-    failUnavailable("react-native-nitro-bg-timer failed to load")
+    nativeTimers = BackgroundTimer as TimerApi
+  } catch (error) {
+    nativeTimers = null
+    reportUnavailable(error instanceof Error ? error.message : String(error))
   }
-  return nitroTimer
+  return nativeTimers
 }
 
-function withNitro<T>(run: (api: NitroTimerApi) => T, fallback: () => T): T {
-  const api = getNitroTimer()
-  if (!api) {
-    return fallback()
-  }
+// A native call that throws mid-session is new information: drop to JS timers
+// and announce again.
+function call<T>(run: (timers: TimerApi) => T): T {
+  const native = loadNativeTimers()
+  if (!native) return run(jsTimers)
   try {
-    return run(api)
+    return run(native)
   } catch (error) {
-    nitroDisabled = true
-    nitroTimer = null
-    failedLoud = false // a mid-session failure is new information — re-announce
-    failUnavailable(`nitro timer call threw: ${String(error)}`)
-    return fallback()
+    nativeTimers = null
+    reported = false
+    reportUnavailable(`native timer call threw: ${String(error)}`)
+    return run(jsTimers)
   }
 }
 
 export class BgTimer {
-  static setInterval(callback: () => void, delay: number): number {
-    return withNitro(
-      (api) => api.setInterval(callback, delay),
-      () => setInterval(callback, delay) as unknown as number,
-    )
-  }
-
-  static clearInterval(intervalId: number): void {
-    withNitro(
-      (api) => api.clearInterval(intervalId),
-      () => clearInterval(intervalId),
-    )
-  }
-
   static setTimeout(callback: () => void, delay: number): number {
-    return withNitro(
-      (api) => api.setTimeout(callback, delay),
-      () => setTimeout(callback, delay) as unknown as number,
-    )
+    return call((timers) => timers.setTimeout(callback, delay))
   }
 
-  static clearTimeout(timeoutId: number): void {
-    withNitro(
-      (api) => api.clearTimeout(timeoutId),
-      () => clearTimeout(timeoutId),
-    )
+  static clearTimeout(id: number): void {
+    call((timers) => timers.clearTimeout(id))
   }
-}
 
-export function throttle<T extends (...args: any[]) => any>(fn: T, ms: number): (...args: Parameters<T>) => void {
-  let lastCalled = 0
-
-  return (...args: Parameters<T>) => {
-    const now = Date.now()
-    if (now - lastCalled >= ms) {
-      lastCalled = now
-      fn(...args)
-    }
+  static setInterval(callback: () => void, delay: number): number {
+    return call((timers) => timers.setInterval(callback, delay))
   }
-}
 
-export function debounce<T extends (...args: any[]) => any>(fn: T, ms: number): (...args: Parameters<T>) => void {
-  let timeoutId: number | null = null
-
-  return (...args: Parameters<T>) => {
-    if (timeoutId) {
-      BgTimer.clearTimeout(timeoutId)
-    }
-    timeoutId = BgTimer.setTimeout(() => {
-      fn(...args)
-      timeoutId = null
-    }, ms)
+  static clearInterval(id: number): void {
+    call((timers) => timers.clearInterval(id))
   }
 }