@glassly/engine 0.1.0-dev.1 → 0.1.0-dev.100

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glassly/engine",
-  "version": "0.1.0-dev.1",
+  "version": "0.1.0-dev.100",
   "description": "Glassly Engine — miniapp registry, WebView bridge, and miniapp store",
   "main": "build/index.js",
   "react-native": "src/index.ts",
@@ -11,15 +11,40 @@
       "react-native": "./src/index.ts",
       "default": "./build/index.js"
     },
-    "./internal": {
-      "types": "./build/internal.d.ts",
-      "react-native": "./src/internal.ts",
-      "default": "./build/internal.js"
+    "./ota": {
+      "types": "./build/react/index.d.ts",
+      "react-native": "./src/react/index.ts",
+      "default": "./build/react/index.js"
     },
-    "./devtools": {
-      "types": "./build/devtools.d.ts",
-      "react-native": "./src/devtools.ts",
-      "default": "./build/devtools.js"
+    "./bluetooth-sdk": {
+      "types": "./build/bluetooth-sdk/index.d.ts",
+      "react-native": "./src/bluetooth-sdk/index.ts",
+      "default": "./build/bluetooth-sdk/index.js"
+    },
+    "./bluetooth-sdk/react": {
+      "types": "./build/bluetooth-sdk/react.d.ts",
+      "react-native": "./src/bluetooth-sdk/react.ts",
+      "default": "./build/bluetooth-sdk/react.js"
+    },
+    "./bluetooth-sdk/types": {
+      "types": "./build/bluetooth-sdk/types.d.ts",
+      "react-native": "./src/bluetooth-sdk/types.ts",
+      "default": "./build/bluetooth-sdk/types.js"
+    },
+    "./bluetooth-sdk/photo-receiver": {
+      "types": "./build/bluetooth-sdk/photo-receiver.d.ts",
+      "react-native": "./src/bluetooth-sdk/photo-receiver.ts",
+      "default": "./build/bluetooth-sdk/photo-receiver.js"
+    },
+    "./bluetooth-sdk/ota-transport": {
+      "types": "./build/bluetooth-sdk/ota-transport.d.ts",
+      "react-native": "./src/bluetooth-sdk/ota-transport.ts",
+      "default": "./build/bluetooth-sdk/ota-transport.js"
+    },
+    "./bluetooth-sdk/debug": {
+      "types": "./build/bluetooth-sdk/debug.d.ts",
+      "react-native": "./src/bluetooth-sdk/debug.ts",
+      "default": "./build/bluetooth-sdk/debug.js"
     },
     "./build/*": null,
     "./src/*": null,
@@ -29,6 +54,10 @@
     "build",
     "README.md",
     "src",
+    "!build/devtools.*",
+    "!build/internal.*",
+    "!src/devtools.ts",
+    "!src/internal.ts",
     "!src/**/__tests__",
     "!src/**/*.test.ts"
   ],
@@ -36,7 +65,11 @@
     "build": "expo-module build",
     "clean": "expo-module clean",
     "lint": "expo-module lint",
-    "test": "./scripts/test.sh",
+    "test": "./scripts/test.sh && node --test scripts/*.test.mjs",
+    "write:release-metadata": "node scripts/write-release-metadata.mjs",
+    "verify:release-package": "node scripts/verify-release-package.mjs",
+    "test:public-api": "bun test src/bluetooth-sdk/__tests__/publicApi.test.ts",
+    "test:public-ota-consumer": "tsc --noEmit --strict --skipLibCheck --jsx react-jsx --moduleResolution bundler --module esnext --target es2022 scripts/fixtures/public-ota-consumer.tsx",
     "build:module": "expo-module build",
     "prepublishOnly": "expo-module prepublishOnly",
     "expo-module": "expo-module"
@@ -64,16 +97,19 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@glassly/miniapp": "^0.3.0-dev.2",
+    "@glassly/bluetooth-sdk": "0.1.0-dev.100",
+    "@glassly/cloud-client": "0.1.0-dev.100",
+    "@glassly/cloud-protocol": "0.1.0-dev.100",
+    "@glassly/crust": "0.1.0-dev.100",
+    "@glassly/miniapp": "0.1.0-dev.100",
     "buffer": "^6.0.3",
     "events": "^3.3.0",
+    "react-native-marked": "8.1.1",
     "semver": "^7.7.4",
-    "typesafe-ts": "^1.7.1"
+    "typesafe-ts": "^1.7.1",
+    "@glassly/llm-providers": "0.1.0-dev.100"
   },
   "devDependencies": {
-    "@glassly/bluetooth-sdk": "workspace:*",
-    "@glassly/cloud-client": "workspace:*",
-    "@glassly/cloud-protocol": "workspace:*",
     "@glassly/llm-providers": "workspace:*",
     "@types/semver": "^7.7.1",
     "expo-module-scripts": "^56.0.3",
@@ -82,28 +118,31 @@
     "typescript": "~5.9.2"
   },
   "peerDependencies": {
-    "expo": "*",
-    "expo-modules-core": "*",
+    "expo": ">=55.0.0",
+    "expo-modules-core": ">=55.0.0",
     "react": "*",
     "react-native": "*",
+    "react-native-safe-area-context": "*",
+    "react-native-svg": "*",
     "react-native-udp": "*",
     "@types/react": "*",
     "react-native-mmkv": "*",
     "react-native-nitro-bg-timer": "*",
     "react-native-nitro-modules": "*",
-    "react-native-reanimated": "*",
-    "expo-file-system": "*",
-    "react-native-zip-archive": "*",
+    "react-native-reanimated": ">=4.2.1 <5",
+    "react-native-worklets": ">=0.7.4 <1",
+    "expo-file-system": ">=55.0.0",
+    "react-native-zip-archive": "7.1.1",
     "zustand": "*",
-    "expo-battery": "*",
-    "expo-audio": "*",
-    "expo-clipboard": "*",
-    "expo-calendar": "*",
-    "expo-constants": "*",
-    "expo-device": "*",
-    "expo-location": "*",
-    "expo-task-manager": "*",
-    "expo-notifications": "*",
+    "expo-battery": ">=55.0.0",
+    "expo-audio": ">=55.0.0",
+    "expo-clipboard": ">=55.0.0",
+    "expo-calendar": ">=55.0.0",
+    "expo-constants": ">=55.0.0",
+    "expo-device": ">=55.0.0",
+    "expo-location": ">=55.0.0",
+    "expo-task-manager": ">=55.0.0",
+    "expo-notifications": ">=55.0.0",
     "react-native-share": "*",
     "react-native-localize": "*",
     "react-native-ble-manager": "*",
@@ -112,11 +151,6 @@
     "@react-native-community/netinfo": "*",
     "@dr.pogodin/react-native-fs": "*",
     "@craftzdog/react-native-buffer": "*",
-    "axios": "*",
-    "@glassly/bluetooth-sdk": "*",
-    "@glassly/crust": "^0.1.0-dev.1",
-    "@glassly/cloud-client": "^0.1.0-dev.0",
-    "@glassly/miniapp": "^0.3.0-dev.2",
-    "@glassly/cloud-protocol": "^0.1.0-dev.0"
+    "axios": "*"
   }
 }

package/src/bluetooth-sdk/debug.ts

@@ -0,0 +1 @@
+export * from "@glassly/bluetooth-sdk/debug"

package/src/bluetooth-sdk/index.ts

@@ -0,0 +1,2 @@
+export {default} from "@glassly/bluetooth-sdk"
+export * from "@glassly/bluetooth-sdk"

package/src/bluetooth-sdk/ota-transport.ts

@@ -0,0 +1 @@
+export * from "@glassly/bluetooth-sdk/ota-transport"

package/src/bluetooth-sdk/photo-receiver.ts

@@ -0,0 +1,2 @@
+export {default} from "@glassly/bluetooth-sdk/photo-receiver"
+export * from "@glassly/bluetooth-sdk/photo-receiver"

package/src/bluetooth-sdk/react.ts

@@ -0,0 +1 @@
+export * from "@glassly/bluetooth-sdk/react"

package/src/bluetooth-sdk/types.ts

@@ -0,0 +1 @@
+export * from "@glassly/bluetooth-sdk/types"

package/src/engine.ts

@@ -5,8 +5,8 @@
  * name stays `engine` in code; the public API surface is `engine`.)
  *
  * It grows one facade at a time. The migration-era flat store/service exports
- * live on the `@glassly/engine/internal` entry (and the debug singletons on
- * `@glassly/engine/devtools`); they shrink as screens move onto `engine.*`.
+ * remain in a private GlasslyOS host package; they shrink as screens move onto
+ * `engine.*`.
  */
 import {configure, start as bootstrapStart, stop as bootstrapStop, updateUiSeams} from "./runtime/bootstrap"
 import {cloudClientService} from "./services/CloudClientService"
@@ -45,6 +45,9 @@ import {memory} from "./facades/memory"
 import {speakers} from "./facades/speakers"
 import {providerKeys} from "./facades/providerKeys"
 import {logBuffer} from "./utils/devLogging"
+import customDashboardService from "./services/CustomDashboardService"
+import dashboardCoordinator from "./services/DashboardCoordinator"
+import gestureDotsService from "./services/GestureDotsService"
 
 export const engine = {
   /** Front door — hand engine auth + config, then start/stop the runtime. */
@@ -65,7 +68,10 @@ export const engine = {
     // Project native device status -> the engine stores (the inbound feed the rest
     // of the runtime reads). Established first so the stores are live before the
     // syncs below react to them.
-    startGlassesStatusProjection()
+    startGlassesStatusProjection((changed) => localMiniappRuntime.forwardEvent("glasses_connection_state", changed))
+    customDashboardService.start()
+    dashboardCoordinator.start()
+    gestureDotsService.start()
     // Route the rest of the inbound device events (wifi/hotspot/gallery -> stores+bus,
     // photo/stream -> coordinators, button/touch/accel/head -> miniapps, save_setting ->
     // store, miniapp_selected -> launcher) so a bare OEM gets device data, not just the
@@ -147,6 +153,9 @@ export const engine = {
     await safely("glasses settings sync", stopGlassesSettingsSync)
     await safely("glasses status projection", stopGlassesStatusProjection)
     await safely("device event router", stopDeviceEventRouter)
+    await safely("dashboard coordinator", () => dashboardCoordinator.stop())
+    await safely("custom dashboard service", () => customDashboardService.stop())
+    await safely("gesture dots service", () => gestureDotsService.stop())
     await safely("ota service", stopOtaService)
     await safely("audio cloud uplink", stopAudioCloudUplink)
     await safely("soniox direct service", () => sonioxDirectService.stop())

package/src/facades/display.ts

@@ -4,12 +4,22 @@
  * glasses display for dev tools and escape-hatch use (normal rendering goes through
  * the engine DisplayProcessor / layout system, not these).
  */
-import BluetoothSdk from "@glassly/bluetooth-sdk/internal"
+import BluetoothSdk from "@glassly/bluetooth-sdk"
+import dashboardCoordinator from "../services/DashboardCoordinator"
 import {displayMirror} from "./displayMirror"
 
 export const display = {
-  /** Mirrored-view read-model (current/onMirror/view/setView). */
+  /** Mirrored-view read-model (current/onMirror). */
   mirror: displayMirror,
+  /** Phone-composed dashboard controls (simulated head-up, dev tools). */
+  dashboard: {
+    isOpen: (): boolean => dashboardCoordinator.isOpen,
+    /** Open/close as if the head was raised/lowered (respects contextual_dashboard). */
+    setHeadUp: (up: boolean): void => dashboardCoordinator.setHeadUp(up),
+    /** Force open/close, ignoring contextual_dashboard (simulator button). */
+    open: (): void => dashboardCoordinator.open(),
+    close: (): void => dashboardCoordinator.close(),
+  },
   /** Write raw text to the glasses display at (x, y) with a font size. */
   text: (...args: Parameters<typeof BluetoothSdk.displayText>) => BluetoothSdk.displayText(...args),
   /** Clear the glasses display. */

package/src/facades/displayMirror.ts

@@ -1,33 +1,25 @@
 /**
  * glasses display mirror — the typed read facade over the (now engine-owned)
  * display store, for a phone-side preview of the glasses screen
- * (`engine.display.mirror`). The store is fed by the display paths
- * (LocalDisplayManager + the cloud path) via `setDisplayEvent`; this facade is the
- * read side: `current()` (snapshot) + `onMirror(cb)` (subscribe). The raw store is
- * also exposed as `engine.displayStore` (the Glassly-app escape hatch).
+ * (`engine.display.mirror`). The store holds the single frame currently on the
+ * glasses (dashboard switching happens upstream in DashboardCoordinator); this
+ * facade is the read side: `current()` (snapshot) + `onMirror(cb)` (subscribe).
+ * The raw store is also exposed as `engine.displayStore` (the Glassly-app
+ * escape hatch).
  */
 import {useDisplayStore} from "../stores/display"
 
 export type DisplayMirrorEvent = Record<string, unknown> & {view?: string; layout?: any}
 
 export const displayMirror = {
-  /** The display event currently shown on the previewed view (snapshot). */
+  /** The display event currently on the glasses (snapshot). */
   current(): DisplayMirrorEvent {
     // Copy: the snapshot must not hand callers a mutable reference into the store.
     return {...useDisplayStore.getState().currentEvent}
   },
 
-  /** Subscribe to changes of the previewed display event; returns an unsubscribe. */
+  /** Subscribe to changes of the mirrored display event; returns an unsubscribe. */
   onMirror(cb: (event: DisplayMirrorEvent) => void): () => void {
     return useDisplayStore.subscribe((s) => s.currentEvent, cb)
   },
-
-  /** Which view is previewed — the main screen or the dashboard. */
-  view(): string {
-    return useDisplayStore.getState().view
-  },
-  /** Switch the previewed view between `"main"` and `"dashboard"`. */
-  setView(view: "main" | "dashboard"): void {
-    useDisplayStore.getState().setView(view)
-  },
 }

package/src/facades/glasses.ts

@@ -11,7 +11,7 @@
 // surface, not the public entry. Relative path (the alias doesn't resolve in engine's
 // standalone build); jest moduleNameMapper + tsconfig both resolve it.
 import BluetoothSdk from "@glassly/bluetooth-sdk/internal"
-import type {ButtonPressEvent, TouchEvent} from "@glassly/bluetooth-sdk/internal"
+import type {ButtonPressEvent, ConnectOptions, Device, TouchEvent} from "@glassly/bluetooth-sdk"
 import {useGlassesStore} from "../stores/glasses"
 import {useSettingsStore, SETTINGS} from "../stores/settings"
 import {hasDefaultDevice} from "../services/DeviceStoreHydration"
@@ -35,6 +35,8 @@ function projectStatus() {
     micEnabled: s.micEnabled,
     vadEnabled: s.voiceActivityDetectionEnabled,
     btClassic: s.bluetoothClassicConnected,
+    // iOS: glasses may read the phone's ANCS stream ("Share System Notifications").
+    ancsAuthorized: Boolean(s.ancsAuthorized),
   }
 }
 
@@ -66,6 +68,8 @@ function projectInfo() {
     wifiMac: s.wifiMacAddress,
     leftMac: s.leftMacAddress,
     rightMac: s.rightMacAddress,
+    sceneCanvasWidth: s.sceneCanvasWidth,
+    sceneCanvasHeight: s.sceneCanvasHeight,
     // Copy: the snapshot must not hand callers a mutable reference into the store.
     wifi: {...s.wifi},
   }
@@ -94,10 +98,10 @@ export const glasses = {
   disconnect: (): Promise<void> => BluetoothSdk.disconnect(),
   forget: (): Promise<void> => BluetoothSdk.forget(),
   /** Connect to a specific (discovered) device. */
-  connect: async (...args: Parameters<typeof BluetoothSdk.connect>): Promise<void> => {
+  connect: async (device: Device, options?: ConnectOptions): Promise<void> => {
     try {
       await pushAllBluetoothSettings()
-      await BluetoothSdk.connect(...args)
+      await BluetoothSdk.connect(device, options)
     } catch (error) {
       recordSupportProfileConnectionFailure(error, "connect")
       throw error
@@ -106,7 +110,7 @@ export const glasses = {
   /** Connect the built-in simulated glasses (dev/testing). */
   connectSimulated: (): Promise<void> => BluetoothSdk.connectSimulated(),
   /** Set a device as the `connectDefault()` target. */
-  setDefault: (...args: Parameters<typeof BluetoothSdk.setDefaultDevice>) => BluetoothSdk.setDefaultDevice(...args),
+  setDefault: (device: Device | null): Promise<void> => BluetoothSdk.setDefaultDevice(device),
   /**
    * Reconnect to the saved default glasses. Resolves `false` when there's nothing to
    * reconnect to (no default paired) or the connect attempt fails (e.g. BLE powered

package/src/facades/ota.ts

@@ -1,18 +1,27 @@
 /**
  * ota facade — `engine.ota`: the OEM-facing OTA read/observe surface. Engine's
  * OtaService projects the glasses' OTA BLE events into the engine store; this facade
- * exposes the snapshot + change subscriptions the host renders its update prompt and
- * progress UI from. No host-injected UI — the host owns all alerts/navigation/i18n.
+ * exposes the snapshot + change subscriptions behind the shared OTA flow exported by
+ * `@glassly/engine/ota`. Hosts retain only their surrounding navigation and theme/i18n adapters.
  *
  * Availability checks live in engine. Install orchestration lives in engine too:
  * `installSession` fronts the OtaInstallCoordinator state machine (WP 8B) — the host
  * progress screen is a pure renderer over its snapshot + attach/detach/retry/finish.
  */
-import BluetoothSdk from "@glassly/bluetooth-sdk/internal"
-import type {OtaProgress, OtaProgressStatus, OtaStatus, OtaUpdateInfo} from "@glassly/bluetooth-sdk/internal"
-import {isGlassesConnected, useGlassesStore} from "../stores/glasses"
+import BluetoothSdk from "@glassly/bluetooth-sdk"
+import type {
+  OtaProgress,
+  OtaProgressStatus,
+  OtaStartAckEvent,
+  OtaStatus,
+  OtaUpdateInfo,
+  ReleaseChangelog,
+} from "@glassly/bluetooth-sdk"
+import {isGlassesConnected, isGlassesReady, useGlassesStore} from "../stores/glasses"
 import {resolveOtaManifestUrl} from "../services/otaManifestUrl"
 import {otaInstallCoordinator, type OtaInstallSnapshot} from "../services/OtaInstallCoordinator"
+import {startGlassesStatusProjection} from "../services/GlassesStatusProjection"
+import {startOtaService} from "../services/OtaService"
 import {
   checkCurrentGlassesForUpdate,
   type OtaCheckCurrentGlassesOptions,
@@ -23,9 +32,12 @@ function projectSnapshot() {
   const s = useGlassesStore.getState()
   return {
     connected: isGlassesConnected(s.connection),
+    ready: isGlassesReady(s.connection),
     buildNumber: s.buildNumber || null,
+    appVersion: s.appVersion || null,
     mtkFirmwareVersion: s.mtkFirmwareVersion || null,
     besFirmwareVersion: s.besFirmwareVersion || null,
+    batteryLevel: s.batteryLevel >= 0 ? s.batteryLevel : null,
     hotspotOtaVersion: s.hotspotOtaVersion ?? 0,
     wifiConnected: s.wifi.state === "connected",
     wifiStatusKnown: s.wifiStatusKnown,
@@ -44,6 +56,7 @@ export type {
   OtaProgressStatus,
   OtaStatus,
   OtaUpdateInfo,
+  ReleaseChangelog,
   OtaInstallSnapshot,
   OtaCheckCurrentGlassesOptions,
   OtaCheckCurrentGlassesResult,
@@ -51,13 +64,23 @@ export type {
 
 export const ota = {
   // --- actions ---
+  /**
+   * Start the device-status and OTA projections without starting the authenticated
+   * cloud connection or miniapp runtime. This is the explicit entry point for Bluetooth-only hosts.
+   * Idempotent and safe when the full engine runtime is already running.
+   */
+  initialize: async () => {
+    const hydrated = startGlassesStatusProjection()
+    startOtaService()
+    await hydrated
+  },
   /**
    * Start the firmware install with the resolved OTA manifest URL. Progress lands on
-   * `status()`/`onStatus()`. (The host resolves the manifest URL — dev-override/env/prod
-   * resolution stays with the OTA config; the host-side stuck/retry watchdog is its own
+   * `status()`/`onStatus()`. (The host resolves the manifest URL — developer override,
+   * host pin, or Engine release pin resolution stays with the OTA config; the stuck/retry watchdog is its own
    * resilience layer on top of this command.)
    */
-  install: (...args: Parameters<typeof BluetoothSdk.startOtaUpdate>) => BluetoothSdk.startOtaUpdate(...args),
+  install: (otaVersionUrl?: string | null): Promise<OtaStartAckEvent> => BluetoothSdk.startOtaUpdate(otaVersionUrl),
   // Deferred: this facade entry was intended to become the engine-owned retry/check
   // action, but BluetoothSdk.checkForOtaUpdate() only returns a boolean. Exposing it
   // here would make callers think the rich otaUpdateAvailable read model is refreshed,
@@ -72,6 +95,9 @@ export const ota = {
   ping: () => BluetoothSdk.ping(),
   /** Resolve and compare the current glasses against the OTA manifest, then update the OTA snapshot. */
   checkForUpdates: (options?: OtaCheckCurrentGlassesOptions) => checkCurrentGlassesForUpdate(options),
+  /** Return bundled release changelogs crossed between two coordinated product versions, newest first. */
+  getReleaseChangelogs: (fromVersion?: string | null, toVersion?: string | null): ReleaseChangelog[] =>
+    BluetoothSdk.getReleaseChangelogs(fromVersion, toVersion),
   /** Clear the available-update prompt state. */
   clearUpdateAvailable: () => useGlassesStore.getState().setOtaUpdateAvailable(null),
   /** Clear active progress/status before entering a fresh install flow. */
@@ -101,7 +127,6 @@ export const ota = {
    * @deprecated Legacy progress route (build < 37) only — removed with WP 8D.
    */
   clearBuildNumberForNextCheck: () => {
-    BluetoothSdk.updateGlasses({buildNumber: ""})
     useGlassesStore.getState().setGlassesInfo({buildNumber: ""})
   },
   /**
@@ -124,9 +149,9 @@ export const ota = {
     detach: () => otaInstallCoordinator.detach(),
     /** Retry after a failure: clear state and re-send ota_start (if connected). */
     retry: () => otaInstallCoordinator.retry(),
-    /** Terminal cleanup for Continue/Done (navigation stays in the screen). */
+    /** Terminal cleanup for Continue/Done, including hotspot route teardown. */
     finish: () => otaInstallCoordinator.finish(),
-    /** Abandon an interrupted session (super-mode skip): finish() + drop the session's status/progress. */
+    /** Abandon an interrupted session: await finish() then drop the session's status/progress. */
     discard: () => otaInstallCoordinator.discard(),
     /** Current install read model (displayState/errorMsg/lockout + glasses OTA data). */
     snapshot: (): OtaInstallSnapshot => otaInstallCoordinator.snapshot(),