@mentra/engine 0.1.0-beta.0

package/build/services/GlassesReadiness.d.ts

@@ -0,0 +1,41 @@
+/**
+ * GlassesReadiness — the canonical connection predicates plus a wait-for-booted
+ * primitive.
+ *
+ * The predicates ("connected / booted / busy") are the single app-facing home
+ * for connection readiness: the app, the Connection coordinator, and the
+ * Pairing coordinator all read them through engine rather than re-deriving the
+ * same checks in three places. They are defined here over the btsdk
+ * `GlassesConnectionStatus` type through the public Bluetooth SDK package
+ * boundary.
+ *
+ * waitForGlassesReady is the new primitive those coordinators build on:
+ * "resolve once the glasses report fully booted, or false on timeout". It is
+ * host-store-agnostic — callers inject a snapshot getter + a subscribe fn — so
+ * it is unit-testable without a live device.
+ */
+import { type GlassesConnectionStatus } from "@mentra/bluetooth-sdk/types";
+export type { GlassesConnectionStatus };
+/** True when the BLE link is established (regardless of boot state). */
+export declare function isGlassesConnected(connection: GlassesConnectionStatus): boolean;
+/** True when connected AND the glasses OS has finished booting. */
+export declare function isGlassesReady(connection: GlassesConnectionStatus): boolean;
+/** True while the native link layer is mid scan / connect / bond. */
+export declare function isGlassesLinkLayerBusy(connection: GlassesConnectionStatus): boolean;
+export interface WaitForGlassesReadyOptions {
+    /** Current connection snapshot. */
+    getConnection: () => GlassesConnectionStatus;
+    /** Subscribe to connection changes; returns an unsubscribe fn. */
+    subscribe: (listener: (connection: GlassesConnectionStatus) => void) => () => void;
+    /** Resolve false after this many ms if still not ready. Default 35s — the pairing boot budget. */
+    timeoutMs?: number;
+    /** Abort the wait early (e.g. the screen unmounted). Tears down the subscription + timer; resolves false. */
+    signal?: AbortSignal;
+}
+/**
+ * Resolves true once the glasses report fully booted, false on timeout, or
+ * false if the optional signal aborts. Resolves immediately when already ready.
+ * Always tears down its subscription, timer, and abort listener before resolving.
+ */
+export declare function waitForGlassesReady(options: WaitForGlassesReadyOptions): Promise<boolean>;
+//# sourceMappingURL=GlassesReadiness.d.ts.map

package/build/services/GlassesReadiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlassesReadiness.d.ts","sourceRoot":"","sources":["../../src/services/GlassesReadiness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,6BAA6B,CAAA;AAIpC,YAAY,EAAC,uBAAuB,EAAC,CAAA;AAErC,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,uBAAuB,GAAG,OAAO,CAE/E;AAED,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,UAAU,EAAE,uBAAuB,GAAG,OAAO,CAE3E;AAED,qEAAqE;AACrE,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,uBAAuB,GAAG,OAAO,CAEnF;AAED,MAAM,WAAW,0BAA0B;IACzC,mCAAmC;IACnC,aAAa,EAAE,MAAM,uBAAuB,CAAA;IAC5C,kEAAkE;IAClE,SAAS,EAAE,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,uBAAuB,KAAK,IAAI,KAAK,MAAM,IAAI,CAAA;IAClF,kGAAkG;IAClG,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6GAA6G;IAC7G,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,OAAO,CAAC,CA4CzF"}

package/build/services/GlassesReadiness.js

@@ -0,0 +1,82 @@
+/**
+ * GlassesReadiness — the canonical connection predicates plus a wait-for-booted
+ * primitive.
+ *
+ * The predicates ("connected / booted / busy") are the single app-facing home
+ * for connection readiness: the app, the Connection coordinator, and the
+ * Pairing coordinator all read them through engine rather than re-deriving the
+ * same checks in three places. They are defined here over the btsdk
+ * `GlassesConnectionStatus` type through the public Bluetooth SDK package
+ * boundary.
+ *
+ * waitForGlassesReady is the new primitive those coordinators build on:
+ * "resolve once the glasses report fully booted, or false on timeout". It is
+ * host-store-agnostic — callers inject a snapshot getter + a subscribe fn — so
+ * it is unit-testable without a live device.
+ */
+import { isBusyGlassesConnectionStatus, isConnectedGlassesConnectionStatus, isReadyGlassesConnectionStatus, } from "@mentra/bluetooth-sdk/types";
+import { BgTimer } from "../utils/timers";
+/** True when the BLE link is established (regardless of boot state). */
+export function isGlassesConnected(connection) {
+    return isConnectedGlassesConnectionStatus(connection);
+}
+/** True when connected AND the glasses OS has finished booting. */
+export function isGlassesReady(connection) {
+    return isReadyGlassesConnectionStatus(connection);
+}
+/** True while the native link layer is mid scan / connect / bond. */
+export function isGlassesLinkLayerBusy(connection) {
+    return isBusyGlassesConnectionStatus(connection);
+}
+/**
+ * Resolves true once the glasses report fully booted, false on timeout, or
+ * false if the optional signal aborts. Resolves immediately when already ready.
+ * Always tears down its subscription, timer, and abort listener before resolving.
+ */
+export function waitForGlassesReady(options) {
+    const { getConnection, subscribe, timeoutMs = 35_000, signal } = options;
+    return new Promise((resolve) => {
+        if (signal?.aborted) {
+            resolve(false);
+            return;
+        }
+        if (isGlassesReady(getConnection())) {
+            resolve(true);
+            return;
+        }
+        let settled = false;
+        let timer = null;
+        let unsubscribe = null;
+        let onAbort = null;
+        const finish = (value) => {
+            if (settled)
+                return;
+            settled = true;
+            if (unsubscribe)
+                unsubscribe();
+            if (timer !== null)
+                BgTimer.clearTimeout(timer);
+            if (onAbort && signal)
+                signal.removeEventListener("abort", onAbort);
+            resolve(value);
+        };
+        if (signal) {
+            onAbort = () => finish(false);
+            signal.addEventListener("abort", onAbort);
+        }
+        unsubscribe = subscribe((connection) => {
+            if (isGlassesReady(connection))
+                finish(true);
+        });
+        if (settled) {
+            // subscribe() notified synchronously with a ready state, so finish() ran
+            // before unsubscribe was assigned and couldn't tear the subscription down.
+            // Do it now (and don't arm a timer).
+            unsubscribe();
+        }
+        else {
+            timer = BgTimer.setTimeout(() => finish(isGlassesReady(getConnection())), timeoutMs);
+        }
+    });
+}
+//# sourceMappingURL=GlassesReadiness.js.map

package/build/services/GlassesReadiness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlassesReadiness.js","sourceRoot":"","sources":["../../src/services/GlassesReadiness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EACL,6BAA6B,EAC7B,kCAAkC,EAClC,8BAA8B,GAE/B,MAAM,6BAA6B,CAAA;AAEpC,OAAO,EAAC,OAAO,EAAC,MAAM,iBAAiB,CAAA;AAIvC,wEAAwE;AACxE,MAAM,UAAU,kBAAkB,CAAC,UAAmC;IACpE,OAAO,kCAAkC,CAAC,UAAU,CAAC,CAAA;AACvD,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,cAAc,CAAC,UAAmC;IAChE,OAAO,8BAA8B,CAAC,UAAU,CAAC,CAAA;AACnD,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,sBAAsB,CAAC,UAAmC;IACxE,OAAO,6BAA6B,CAAC,UAAU,CAAC,CAAA;AAClD,CAAC;AAaD;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAmC;IACrE,MAAM,EAAC,aAAa,EAAE,SAAS,EAAE,SAAS,GAAG,MAAM,EAAE,MAAM,EAAC,GAAG,OAAO,CAAA;IACtE,OAAO,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE;QACtC,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,CAAA;YACd,OAAM;QACR,CAAC;QACD,IAAI,cAAc,CAAC,aAAa,EAAE,CAAC,EAAE,CAAC;YACpC,OAAO,CAAC,IAAI,CAAC,CAAA;YACb,OAAM;QACR,CAAC;QAED,IAAI,OAAO,GAAG,KAAK,CAAA;QACnB,IAAI,KAAK,GAAkB,IAAI,CAAA;QAC/B,IAAI,WAAW,GAAwB,IAAI,CAAA;QAC3C,IAAI,OAAO,GAAwB,IAAI,CAAA;QAEvC,MAAM,MAAM,GAAG,CAAC,KAAc,EAAE,EAAE;YAChC,IAAI,OAAO;gBAAE,OAAM;YACnB,OAAO,GAAG,IAAI,CAAA;YACd,IAAI,WAAW;gBAAE,WAAW,EAAE,CAAA;YAC9B,IAAI,KAAK,KAAK,IAAI;gBAAE,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA;YAC/C,IAAI,OAAO,IAAI,MAAM;gBAAE,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;YACnE,OAAO,CAAC,KAAK,CAAC,CAAA;QAChB,CAAC,CAAA;QAED,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YAC7B,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAC3C,CAAC;QAED,WAAW,GAAG,SAAS,CAAC,CAAC,UAAU,EAAE,EAAE;YACrC,IAAI,cAAc,CAAC,UAAU,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,CAAA;QAC9C,CAAC,CAAC,CAAA;QAEF,IAAI,OAAO,EAAE,CAAC;YACZ,yEAAyE;YACzE,2EAA2E;YAC3E,qCAAqC;YACrC,WAAW,EAAE,CAAA;QACf,CAAC;aAAM,CAAC;YACN,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,aAAa,EAAE,CAAC,CAAC,EAAE,SAAS,CAAC,CAAA;QACtF,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC","sourcesContent":["/**\n * GlassesReadiness — the canonical connection predicates plus a wait-for-booted\n * primitive.\n *\n * The predicates (\"connected / booted / busy\") are the single app-facing home\n * for connection readiness: the app, the Connection coordinator, and the\n * Pairing coordinator all read them through engine rather than re-deriving the\n * same checks in three places. They are defined here over the btsdk\n * `GlassesConnectionStatus` type through the public Bluetooth SDK package\n * boundary.\n *\n * waitForGlassesReady is the new primitive those coordinators build on:\n * \"resolve once the glasses report fully booted, or false on timeout\". It is\n * host-store-agnostic — callers inject a snapshot getter + a subscribe fn — so\n * it is unit-testable without a live device.\n */\nimport {\n  isBusyGlassesConnectionStatus,\n  isConnectedGlassesConnectionStatus,\n  isReadyGlassesConnectionStatus,\n  type GlassesConnectionStatus,\n} from \"@mentra/bluetooth-sdk/types\"\n\nimport {BgTimer} from \"../utils/timers\"\n\nexport type {GlassesConnectionStatus}\n\n/** True when the BLE link is established (regardless of boot state). */\nexport function isGlassesConnected(connection: GlassesConnectionStatus): boolean {\n  return isConnectedGlassesConnectionStatus(connection)\n}\n\n/** True when connected AND the glasses OS has finished booting. */\nexport function isGlassesReady(connection: GlassesConnectionStatus): boolean {\n  return isReadyGlassesConnectionStatus(connection)\n}\n\n/** True while the native link layer is mid scan / connect / bond. */\nexport function isGlassesLinkLayerBusy(connection: GlassesConnectionStatus): boolean {\n  return isBusyGlassesConnectionStatus(connection)\n}\n\nexport interface WaitForGlassesReadyOptions {\n  /** Current connection snapshot. */\n  getConnection: () => GlassesConnectionStatus\n  /** Subscribe to connection changes; returns an unsubscribe fn. */\n  subscribe: (listener: (connection: GlassesConnectionStatus) => void) => () => void\n  /** Resolve false after this many ms if still not ready. Default 35s — the pairing boot budget. */\n  timeoutMs?: number\n  /** Abort the wait early (e.g. the screen unmounted). Tears down the subscription + timer; resolves false. */\n  signal?: AbortSignal\n}\n\n/**\n * Resolves true once the glasses report fully booted, false on timeout, or\n * false if the optional signal aborts. Resolves immediately when already ready.\n * Always tears down its subscription, timer, and abort listener before resolving.\n */\nexport function waitForGlassesReady(options: WaitForGlassesReadyOptions): Promise<boolean> {\n  const {getConnection, subscribe, timeoutMs = 35_000, signal} = options\n  return new Promise<boolean>((resolve) => {\n    if (signal?.aborted) {\n      resolve(false)\n      return\n    }\n    if (isGlassesReady(getConnection())) {\n      resolve(true)\n      return\n    }\n\n    let settled = false\n    let timer: number | null = null\n    let unsubscribe: (() => void) | null = null\n    let onAbort: (() => void) | null = null\n\n    const finish = (value: boolean) => {\n      if (settled) return\n      settled = true\n      if (unsubscribe) unsubscribe()\n      if (timer !== null) BgTimer.clearTimeout(timer)\n      if (onAbort && signal) signal.removeEventListener(\"abort\", onAbort)\n      resolve(value)\n    }\n\n    if (signal) {\n      onAbort = () => finish(false)\n      signal.addEventListener(\"abort\", onAbort)\n    }\n\n    unsubscribe = subscribe((connection) => {\n      if (isGlassesReady(connection)) finish(true)\n    })\n\n    if (settled) {\n      // subscribe() notified synchronously with a ready state, so finish() ran\n      // before unsubscribe was assigned and couldn't tear the subscription down.\n      // Do it now (and don't arm a timer).\n      unsubscribe()\n    } else {\n      timer = BgTimer.setTimeout(() => finish(isGlassesReady(getConnection())), timeoutMs)\n    }\n  })\n}\n"]}

package/build/services/GlassesSettingsSync.d.ts

@@ -0,0 +1,33 @@
+/**
+ * The changed-keys diff for the change-push, MINUS the pairing-identity keys.
+ * Identity is native-authoritative (promoted on pairing success, cleared on
+ * forget, echoed down via save_setting) and reaches native only through the
+ * explicit full seeds. Pushing identity from the change subscription would
+ * close a feedback loop: native echo → store setSetting → change-push →
+ * native apply → echo…, which self-sustains the moment two different values
+ * are in flight (e.g. a boot demotion crossing a native promotion) and flaps
+ * the pairing UI.
+ */
+export declare function diffBluetoothSettingsForPush(settings: Record<string, unknown>, previous: Record<string, unknown>): Record<string, unknown>;
+/** A copy of the settings record without the pairing-identity keys. */
+export declare function stripPairingIdentity(settings: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Push the FULL current device-settings set — identity included — to native.
+ * This is the explicit identity SEED, for the flows where native genuinely
+ * needs the phone's persisted identity BEFORE it can act: the device-store
+ * hydration at start, the pre-connect seed (connectDefault targets the seeded
+ * identity), the post-demotion re-push, and the abandon re-seed.
+ */
+export declare function pushAllBluetoothSettings(): Promise<void>;
+/**
+ * Push the device-settings set MINUS the pairing identity. The on-connect
+ * replay uses this: while connected, NATIVE owns the identity (it promotes at
+ * device-ready and echoes down), and the JS snapshot can be mid-relay stale —
+ * on Mentra Live "connected" lands together with device-ready, and a full
+ * replay raced the promotion echoes and overwrote the just-promoted identity
+ * with pre-promotion empties (wiping the pairing it had just made).
+ */
+export declare function pushDeviceSettingsOnConnect(): Promise<void>;
+export declare function startGlassesSettingsSync(): void;
+export declare function stopGlassesSettingsSync(): void;
+//# sourceMappingURL=GlassesSettingsSync.d.ts.map

package/build/services/GlassesSettingsSync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlassesSettingsSync.d.ts","sourceRoot":"","sources":["../../src/services/GlassesSettingsSync.ts"],"names":[],"mappings":"AAmCA;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOzB;AAED,uEAAuE;AACvE,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAO/F;AAKD;;;;;;GAMG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC,CAK9D;AAED;;;;;;;GAOG;AACH,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,IAAI,CAAC,CAEjE;AAED,wBAAgB,wBAAwB,IAAI,IAAI,CA8B/C;AAED,wBAAgB,uBAAuB,IAAI,IAAI,CAK9C"}

package/build/services/GlassesSettingsSync.js

@@ -0,0 +1,121 @@
+/**
+ * Glasses settings sync — engine-owned. Keeps the connected glasses in sync with
+ * the phone's device settings (`BLUETOOTH_SETTING_KEYS`) over the bluetooth-sdk, so
+ * `engine.glasses.settings.set()` (and any other settings-store write) reaches the
+ * device for ANY host — not just the first-party Mentra app, where this used to live
+ * in MantleManager.
+ *
+ * Two triggers:
+ *   1. on change — push the keys that changed.
+ *   2. on (re)connect — push the FULL set, so a freshly-connected device gets the
+ *      phone's current settings (not just future changes).
+ *
+ * Started by `engine.start()`. Idempotent.
+ */
+import { shallow } from "zustand/shallow";
+import BluetoothSdk from "@mentra/bluetooth-sdk/internal";
+import { useSettingsStore, PAIRING_IDENTITY_KEYS } from "../stores/settings";
+import { useGlassesStore } from "../stores/glasses";
+import { createDebouncedPatchFlusher } from "../utils/debouncedPatch";
+import { isGlassesConnected } from "./GlassesReadiness";
+/**
+ * Change-pushes are debounced (300ms) and merged so a burst of setSetting
+ * calls becomes ONE BLE write (wire v2 keeps BLE JSON small and infrequent).
+ * The full on-connect/seed pushes stay direct — callers await their ordering.
+ */
+const flushBluetoothSettingsPatch = createDebouncedPatchFlusher((patch) => {
+    // Settings can change while the glasses are disconnected — a native
+    // rejection must not surface as an unhandled promise rejection.
+    void Promise.resolve(BluetoothSdk.updateBluetoothSettings(patch)).catch((error) => {
+        console.warn("GlassesSettingsSync: updateBluetoothSettings failed:", error);
+    });
+}, 300);
+/**
+ * The changed-keys diff for the change-push, MINUS the pairing-identity keys.
+ * Identity is native-authoritative (promoted on pairing success, cleared on
+ * forget, echoed down via save_setting) and reaches native only through the
+ * explicit full seeds. Pushing identity from the change subscription would
+ * close a feedback loop: native echo → store setSetting → change-push →
+ * native apply → echo…, which self-sustains the moment two different values
+ * are in flight (e.g. a boot demotion crossing a native promotion) and flaps
+ * the pairing UI.
+ */
+export function diffBluetoothSettingsForPush(settings, previous) {
+    const changed = {};
+    for (const key in settings) {
+        if (PAIRING_IDENTITY_KEYS.includes(key))
+            continue;
+        if (settings[key] !== previous[key])
+            changed[key] = settings[key];
+    }
+    return changed;
+}
+/** A copy of the settings record without the pairing-identity keys. */
+export function stripPairingIdentity(settings) {
+    const stripped = {};
+    for (const key in settings) {
+        if (PAIRING_IDENTITY_KEYS.includes(key))
+            continue;
+        stripped[key] = settings[key];
+    }
+    return stripped;
+}
+let unsubChange = null;
+let unsubConnect = null;
+/**
+ * Push the FULL current device-settings set — identity included — to native.
+ * This is the explicit identity SEED, for the flows where native genuinely
+ * needs the phone's persisted identity BEFORE it can act: the device-store
+ * hydration at start, the pre-connect seed (connectDefault targets the seeded
+ * identity), the post-demotion re-push, and the abandon re-seed.
+ */
+export async function pushAllBluetoothSettings() {
+    // Returns the native write promise so callers can await the seed before the
+    // connect handshake replays settings to the glasses (otherwise the handshake
+    // can race ahead and replay stale native settings).
+    await BluetoothSdk.updateBluetoothSettings(useSettingsStore.getState().getBluetoothSettings());
+}
+/**
+ * Push the device-settings set MINUS the pairing identity. The on-connect
+ * replay uses this: while connected, NATIVE owns the identity (it promotes at
+ * device-ready and echoes down), and the JS snapshot can be mid-relay stale —
+ * on Mentra Live "connected" lands together with device-ready, and a full
+ * replay raced the promotion echoes and overwrote the just-promoted identity
+ * with pre-promotion empties (wiping the pairing it had just made).
+ */
+export async function pushDeviceSettingsOnConnect() {
+    await BluetoothSdk.updateBluetoothSettings(stripPairingIdentity(useSettingsStore.getState().getBluetoothSettings()));
+}
+export function startGlassesSettingsSync() {
+    if (unsubChange || unsubConnect)
+        return;
+    // 1. Push only the keys that changed (matching the prior MantleManager sync).
+    // Pairing identity is excluded — see diffBluetoothSettingsForPush.
+    unsubChange = useSettingsStore.subscribe((state) => state.getBluetoothSettings(), (settings, previous) => {
+        const changed = diffBluetoothSettingsForPush(settings, previous);
+        if (Object.keys(changed).length > 0) {
+            flushBluetoothSettingsPatch(changed);
+        }
+    }, { equalityFn: shallow });
+    // 2. Push the device settings whenever the glasses transition to connected —
+    // identity EXCLUDED: native owns the identity it just promoted, and a full
+    // replay here raced the promotion echoes (see pushDeviceSettingsOnConnect).
+    let wasConnected = isGlassesConnected(useGlassesStore.getState().connection);
+    unsubConnect = useGlassesStore.subscribe(() => {
+        const connected = isGlassesConnected(useGlassesStore.getState().connection);
+        if (connected && !wasConnected) {
+            // Background sync: log-and-continue if the device drops right after connect.
+            void pushDeviceSettingsOnConnect().catch((error) => {
+                console.warn("GlassesSettingsSync: on-connect settings push failed:", error);
+            });
+        }
+        wasConnected = connected;
+    });
+}
+export function stopGlassesSettingsSync() {
+    unsubChange?.();
+    unsubConnect?.();
+    unsubChange = null;
+    unsubConnect = null;
+}
+//# sourceMappingURL=GlassesSettingsSync.js.map

package/build/services/GlassesSettingsSync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlassesSettingsSync.js","sourceRoot":"","sources":["../../src/services/GlassesSettingsSync.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Glasses settings sync — engine-owned. Keeps the connected glasses in sync with\n * the phone's device settings (`BLUETOOTH_SETTING_KEYS`) over the bluetooth-sdk, so\n * `engine.glasses.settings.set()` (and any other settings-store write) reaches the\n * device for ANY host — not just the first-party Mentra app, where this used to live\n * in MantleManager.\n *\n * Two triggers:\n *   1. on change — push the keys that changed.\n *   2. on (re)connect — push the FULL set, so a freshly-connected device gets the\n *      phone's current settings (not just future changes).\n *\n * Started by `engine.start()`. Idempotent.\n */\nimport {shallow} from \"zustand/shallow\"\n\nimport BluetoothSdk from \"@mentra/bluetooth-sdk/internal\"\nimport {useSettingsStore, PAIRING_IDENTITY_KEYS} from \"../stores/settings\"\nimport {useGlassesStore} from \"../stores/glasses\"\nimport {createDebouncedPatchFlusher} from \"../utils/debouncedPatch\"\nimport {isGlassesConnected} from \"./GlassesReadiness\"\n\n/**\n * Change-pushes are debounced (300ms) and merged so a burst of setSetting\n * calls becomes ONE BLE write (wire v2 keeps BLE JSON small and infrequent).\n * The full on-connect/seed pushes stay direct — callers await their ordering.\n */\nconst flushBluetoothSettingsPatch = createDebouncedPatchFlusher<Record<string, unknown>>((patch) => {\n  // Settings can change while the glasses are disconnected — a native\n  // rejection must not surface as an unhandled promise rejection.\n  void Promise.resolve(BluetoothSdk.updateBluetoothSettings(patch)).catch((error) => {\n    console.warn(\"GlassesSettingsSync: updateBluetoothSettings failed:\", error)\n  })\n}, 300)\n\n/**\n * The changed-keys diff for the change-push, MINUS the pairing-identity keys.\n * Identity is native-authoritative (promoted on pairing success, cleared on\n * forget, echoed down via save_setting) and reaches native only through the\n * explicit full seeds. Pushing identity from the change subscription would\n * close a feedback loop: native echo → store setSetting → change-push →\n * native apply → echo…, which self-sustains the moment two different values\n * are in flight (e.g. a boot demotion crossing a native promotion) and flaps\n * the pairing UI.\n */\nexport function diffBluetoothSettingsForPush(\n  settings: Record<string, unknown>,\n  previous: Record<string, unknown>,\n): Record<string, unknown> {\n  const changed: Record<string, unknown> = {}\n  for (const key in settings) {\n    if (PAIRING_IDENTITY_KEYS.includes(key)) continue\n    if (settings[key] !== previous[key]) changed[key] = settings[key]\n  }\n  return changed\n}\n\n/** A copy of the settings record without the pairing-identity keys. */\nexport function stripPairingIdentity(settings: Record<string, unknown>): Record<string, unknown> {\n  const stripped: Record<string, unknown> = {}\n  for (const key in settings) {\n    if (PAIRING_IDENTITY_KEYS.includes(key)) continue\n    stripped[key] = settings[key]\n  }\n  return stripped\n}\n\nlet unsubChange: (() => void) | null = null\nlet unsubConnect: (() => void) | null = null\n\n/**\n * Push the FULL current device-settings set — identity included — to native.\n * This is the explicit identity SEED, for the flows where native genuinely\n * needs the phone's persisted identity BEFORE it can act: the device-store\n * hydration at start, the pre-connect seed (connectDefault targets the seeded\n * identity), the post-demotion re-push, and the abandon re-seed.\n */\nexport async function pushAllBluetoothSettings(): Promise<void> {\n  // Returns the native write promise so callers can await the seed before the\n  // connect handshake replays settings to the glasses (otherwise the handshake\n  // can race ahead and replay stale native settings).\n  await BluetoothSdk.updateBluetoothSettings(useSettingsStore.getState().getBluetoothSettings())\n}\n\n/**\n * Push the device-settings set MINUS the pairing identity. The on-connect\n * replay uses this: while connected, NATIVE owns the identity (it promotes at\n * device-ready and echoes down), and the JS snapshot can be mid-relay stale —\n * on Mentra Live \"connected\" lands together with device-ready, and a full\n * replay raced the promotion echoes and overwrote the just-promoted identity\n * with pre-promotion empties (wiping the pairing it had just made).\n */\nexport async function pushDeviceSettingsOnConnect(): Promise<void> {\n  await BluetoothSdk.updateBluetoothSettings(stripPairingIdentity(useSettingsStore.getState().getBluetoothSettings()))\n}\n\nexport function startGlassesSettingsSync(): void {\n  if (unsubChange || unsubConnect) return\n\n  // 1. Push only the keys that changed (matching the prior MantleManager sync).\n  // Pairing identity is excluded — see diffBluetoothSettingsForPush.\n  unsubChange = useSettingsStore.subscribe(\n    (state) => state.getBluetoothSettings(),\n    (settings: Record<string, unknown>, previous: Record<string, unknown>) => {\n      const changed = diffBluetoothSettingsForPush(settings, previous)\n      if (Object.keys(changed).length > 0) {\n        flushBluetoothSettingsPatch(changed)\n      }\n    },\n    {equalityFn: shallow},\n  )\n\n  // 2. Push the device settings whenever the glasses transition to connected —\n  // identity EXCLUDED: native owns the identity it just promoted, and a full\n  // replay here raced the promotion echoes (see pushDeviceSettingsOnConnect).\n  let wasConnected = isGlassesConnected(useGlassesStore.getState().connection)\n  unsubConnect = useGlassesStore.subscribe(() => {\n    const connected = isGlassesConnected(useGlassesStore.getState().connection)\n    if (connected && !wasConnected) {\n      // Background sync: log-and-continue if the device drops right after connect.\n      void pushDeviceSettingsOnConnect().catch((error) => {\n        console.warn(\"GlassesSettingsSync: on-connect settings push failed:\", error)\n      })\n    }\n    wasConnected = connected\n  })\n}\n\nexport function stopGlassesSettingsSync(): void {\n  unsubChange?.()\n  unsubConnect?.()\n  unsubChange = null\n  unsubConnect = null\n}\n"]}

package/build/services/GlassesStatusProjection.d.ts

@@ -0,0 +1,3 @@
+export declare function startGlassesStatusProjection(): void;
+export declare function stopGlassesStatusProjection(): void;
+//# sourceMappingURL=GlassesStatusProjection.d.ts.map

package/build/services/GlassesStatusProjection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlassesStatusProjection.d.ts","sourceRoot":"","sources":["../../src/services/GlassesStatusProjection.ts"],"names":[],"mappings":"AAqBA,wBAAgB,4BAA4B,IAAI,IAAI,CA6CnD;AAED,wBAAgB,2BAA2B,IAAI,IAAI,CAIlD"}

package/build/services/GlassesStatusProjection.js

@@ -0,0 +1,65 @@
+/**
+ * Glasses status projection — engine-owned. Subscribes to the native bluetooth-sdk
+ * status events and projects them into the engine device stores, so engine's own
+ * services (which react to those stores) work for ANY host — not just the first-party
+ * Mentra app, where this used to live in MantleManager.
+ *
+ * This is the INBOUND mirror of GlassesSettingsSync: that pushes the settings store
+ * OUT to the device; this pulls device status IN to the stores. It's the feed that
+ * the rest of the engine runtime depends on (MicStateCoordinator, the settings-sync
+ * on-connect trigger, the facade read-models all read these stores).
+ *
+ * Started by `engine.start()`. Idempotent.
+ */
+import BluetoothSdk from "@mentra/bluetooth-sdk/internal";
+import { useCoreStore } from "../stores/core";
+import { useGlassesStore } from "../stores/glasses";
+import localMiniappRuntime from "./LocalMiniappRuntime";
+let unsubs = [];
+let projectionRunId = 0;
+export function startGlassesStatusProjection() {
+    if (unsubs.length)
+        return;
+    const runId = ++projectionRunId;
+    let bluetoothEventSeen = false;
+    let glassesEventSeen = false;
+    void BluetoothSdk.getBluetoothStatus()
+        .then((status) => {
+        if (runId !== projectionRunId || bluetoothEventSeen)
+            return;
+        useCoreStore.getState().setCoreInfo(status);
+    })
+        .catch((error) => {
+        console.warn("GlassesStatusProjection: getBluetoothStatus failed", error);
+    });
+    void BluetoothSdk.getGlassesStatus()
+        .then((status) => {
+        if (runId !== projectionRunId || glassesEventSeen)
+            return;
+        useGlassesStore.getState().setGlassesInfo(status);
+    })
+        .catch((error) => {
+        console.warn("GlassesStatusProjection: getGlassesStatus failed", error);
+    });
+    // Bluetooth-adapter status -> core store.
+    unsubs.push(BluetoothSdk.onBluetoothStatus((changed) => {
+        bluetoothEventSeen = true;
+        useCoreStore.getState().setCoreInfo(changed);
+    }));
+    // Glasses status -> glasses store (+ forward to local miniapps; clear any stale
+    // OTA-available flag on disconnect).
+    unsubs.push(BluetoothSdk.onGlassesStatus((changed) => {
+        glassesEventSeen = true;
+        useGlassesStore.getState().setGlassesInfo(changed);
+        localMiniappRuntime.forwardEvent("glasses_connection_state", changed);
+        if (changed.connection?.state === "disconnected") {
+            useGlassesStore.getState().setOtaUpdateAvailable(null);
+        }
+    }));
+}
+export function stopGlassesStatusProjection() {
+    projectionRunId++;
+    unsubs.forEach((unsub) => unsub());
+    unsubs = [];
+}
+//# sourceMappingURL=GlassesStatusProjection.js.map

package/build/services/GlassesStatusProjection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlassesStatusProjection.js","sourceRoot":"","sources":["../../src/services/GlassesStatusProjection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,YAAY,MAAM,gCAAgC,CAAA;AACzD,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAA;AAC3C,OAAO,EAAC,eAAe,EAAC,MAAM,mBAAmB,CAAA;AACjD,OAAO,mBAAmB,MAAM,uBAAuB,CAAA;AAEvD,IAAI,MAAM,GAAsB,EAAE,CAAA;AAClC,IAAI,eAAe,GAAG,CAAC,CAAA;AAEvB,MAAM,UAAU,4BAA4B;IAC1C,IAAI,MAAM,CAAC,MAAM;QAAE,OAAM;IAEzB,MAAM,KAAK,GAAG,EAAE,eAAe,CAAA;IAC/B,IAAI,kBAAkB,GAAG,KAAK,CAAA;IAC9B,IAAI,gBAAgB,GAAG,KAAK,CAAA;IAE5B,KAAK,YAAY,CAAC,kBAAkB,EAAE;SACnC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;QACf,IAAI,KAAK,KAAK,eAAe,IAAI,kBAAkB;YAAE,OAAM;QAC3D,YAAY,CAAC,QAAQ,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;IAC7C,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACf,OAAO,CAAC,IAAI,CAAC,oDAAoD,EAAE,KAAK,CAAC,CAAA;IAC3E,CAAC,CAAC,CAAA;IAEJ,KAAK,YAAY,CAAC,gBAAgB,EAAE;SACjC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;QACf,IAAI,KAAK,KAAK,eAAe,IAAI,gBAAgB;YAAE,OAAM;QACzD,eAAe,CAAC,QAAQ,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,CAAA;IACnD,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACf,OAAO,CAAC,IAAI,CAAC,kDAAkD,EAAE,KAAK,CAAC,CAAA;IACzE,CAAC,CAAC,CAAA;IAEJ,0CAA0C;IAC1C,MAAM,CAAC,IAAI,CACT,YAAY,CAAC,iBAAiB,CAAC,CAAC,OAAO,EAAE,EAAE;QACzC,kBAAkB,GAAG,IAAI,CAAA;QACzB,YAAY,CAAC,QAAQ,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;IAC9C,CAAC,CAAC,CACH,CAAA;IAED,gFAAgF;IAChF,qCAAqC;IACrC,MAAM,CAAC,IAAI,CACT,YAAY,CAAC,eAAe,CAAC,CAAC,OAAO,EAAE,EAAE;QACvC,gBAAgB,GAAG,IAAI,CAAA;QACvB,eAAe,CAAC,QAAQ,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC,CAAA;QAClD,mBAAmB,CAAC,YAAY,CAAC,0BAA0B,EAAE,OAAO,CAAC,CAAA;QACrE,IAAI,OAAO,CAAC,UAAU,EAAE,KAAK,KAAK,cAAc,EAAE,CAAC;YACjD,eAAe,CAAC,QAAQ,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAA;QACxD,CAAC;IACH,CAAC,CAAC,CACH,CAAA;AACH,CAAC;AAED,MAAM,UAAU,2BAA2B;IACzC,eAAe,EAAE,CAAA;IACjB,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,CAAA;IAClC,MAAM,GAAG,EAAE,CAAA;AACb,CAAC","sourcesContent":["/**\n * Glasses status projection — engine-owned. Subscribes to the native bluetooth-sdk\n * status events and projects them into the engine device stores, so engine's own\n * services (which react to those stores) work for ANY host — not just the first-party\n * Mentra app, where this used to live in MantleManager.\n *\n * This is the INBOUND mirror of GlassesSettingsSync: that pushes the settings store\n * OUT to the device; this pulls device status IN to the stores. It's the feed that\n * the rest of the engine runtime depends on (MicStateCoordinator, the settings-sync\n * on-connect trigger, the facade read-models all read these stores).\n *\n * Started by `engine.start()`. Idempotent.\n */\nimport BluetoothSdk from \"@mentra/bluetooth-sdk/internal\"\nimport {useCoreStore} from \"../stores/core\"\nimport {useGlassesStore} from \"../stores/glasses\"\nimport localMiniappRuntime from \"./LocalMiniappRuntime\"\n\nlet unsubs: Array<() => void> = []\nlet projectionRunId = 0\n\nexport function startGlassesStatusProjection(): void {\n  if (unsubs.length) return\n\n  const runId = ++projectionRunId\n  let bluetoothEventSeen = false\n  let glassesEventSeen = false\n\n  void BluetoothSdk.getBluetoothStatus()\n    .then((status) => {\n      if (runId !== projectionRunId || bluetoothEventSeen) return\n      useCoreStore.getState().setCoreInfo(status)\n    })\n    .catch((error) => {\n      console.warn(\"GlassesStatusProjection: getBluetoothStatus failed\", error)\n    })\n\n  void BluetoothSdk.getGlassesStatus()\n    .then((status) => {\n      if (runId !== projectionRunId || glassesEventSeen) return\n      useGlassesStore.getState().setGlassesInfo(status)\n    })\n    .catch((error) => {\n      console.warn(\"GlassesStatusProjection: getGlassesStatus failed\", error)\n    })\n\n  // Bluetooth-adapter status -> core store.\n  unsubs.push(\n    BluetoothSdk.onBluetoothStatus((changed) => {\n      bluetoothEventSeen = true\n      useCoreStore.getState().setCoreInfo(changed)\n    }),\n  )\n\n  // Glasses status -> glasses store (+ forward to local miniapps; clear any stale\n  // OTA-available flag on disconnect).\n  unsubs.push(\n    BluetoothSdk.onGlassesStatus((changed) => {\n      glassesEventSeen = true\n      useGlassesStore.getState().setGlassesInfo(changed)\n      localMiniappRuntime.forwardEvent(\"glasses_connection_state\", changed)\n      if (changed.connection?.state === \"disconnected\") {\n        useGlassesStore.getState().setOtaUpdateAvailable(null)\n      }\n    }),\n  )\n}\n\nexport function stopGlassesStatusProjection(): void {\n  projectionRunId++\n  unsubs.forEach((unsub) => unsub())\n  unsubs = []\n}\n"]}

package/build/services/HeadingService.d.ts

@@ -0,0 +1,27 @@
+/**
+ * HeadingService
+ *
+ * Thin singleton over the native compass stream exposed by `crust`.
+ * Works on both Android and iOS via CLLocationManager (iOS) / SensorManager (Android).
+ *
+ * Reference-counted: the underlying SensorManager subscription starts on
+ * the first listener and stops when the last one unsubscribes. Late
+ * subscribers get the most recently emitted heading replayed
+ * synchronously so the UI doesn't have to wait for the next sensor tick.
+ */
+export type HeadingListener = (degrees: number) => void;
+declare class HeadingService {
+    private static instance;
+    private listeners;
+    private nativeSub;
+    private lastDegrees;
+    private nativeStarted;
+    private constructor();
+    static getInstance(): HeadingService;
+    addListener(listener: HeadingListener): () => void;
+    private startNative;
+    private stopNative;
+}
+declare const headingService: HeadingService;
+export default headingService;
+//# sourceMappingURL=HeadingService.d.ts.map

package/build/services/HeadingService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HeadingService.d.ts","sourceRoot":"","sources":["../../src/services/HeadingService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;AAEvD,cAAM,cAAc;IAClB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA8B;IACrD,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,aAAa,CAAQ;IAE7B,OAAO;WAEO,WAAW,IAAI,cAAc;IAOpC,WAAW,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,IAAI;YAoB3C,WAAW;YA2BX,UAAU;CAazB;AAED,QAAA,MAAM,cAAc,gBAA+B,CAAA;AACnD,eAAe,cAAc,CAAA"}

package/build/services/HeadingService.js

@@ -0,0 +1,96 @@
+/**
+ * HeadingService
+ *
+ * Thin singleton over the native compass stream exposed by `crust`.
+ * Works on both Android and iOS via CLLocationManager (iOS) / SensorManager (Android).
+ *
+ * Reference-counted: the underlying SensorManager subscription starts on
+ * the first listener and stops when the last one unsubscribes. Late
+ * subscribers get the most recently emitted heading replayed
+ * synchronously so the UI doesn't have to wait for the next sensor tick.
+ */
+import CrustModule from "@mentra/crust";
+const LOG_TAG = "HEADING_SERVICE";
+class HeadingService {
+    static instance = null;
+    listeners = new Set();
+    nativeSub = null;
+    lastDegrees = null;
+    nativeStarted = false;
+    constructor() { }
+    static getInstance() {
+        if (!HeadingService.instance) {
+            HeadingService.instance = new HeadingService();
+        }
+        return HeadingService.instance;
+    }
+    addListener(listener) {
+        this.listeners.add(listener);
+        if (!this.nativeStarted) {
+            this.startNative();
+        }
+        if (this.lastDegrees != null) {
+            try {
+                listener(this.lastDegrees);
+            }
+            catch (err) {
+                console.error(`${LOG_TAG}: listener threw on replay`, err);
+            }
+        }
+        return () => {
+            this.listeners.delete(listener);
+            if (this.listeners.size === 0) {
+                this.stopNative();
+            }
+        };
+    }
+    async startNative() {
+        if (this.nativeStarted)
+            return;
+        this.nativeStarted = true;
+        this.nativeSub = CrustModule.addListener("onHeading", (data) => {
+            const deg = Number(data.degrees);
+            if (!Number.isFinite(deg))
+                return;
+            this.lastDegrees = deg;
+            this.listeners.forEach((l) => {
+                try {
+                    l(deg);
+                }
+                catch (err) {
+                    console.error(`${LOG_TAG}: listener threw`, err);
+                }
+            });
+        });
+        try {
+            const result = await CrustModule.startHeading();
+            if (!result.ok) {
+                console.warn(`${LOG_TAG}: startHeading failed — ${result.error}`);
+            }
+            else {
+                console.log(`${LOG_TAG}: started`);
+            }
+        }
+        catch (err) {
+            console.error(`${LOG_TAG}: startHeading threw`, err);
+        }
+    }
+    async stopNative() {
+        if (!this.nativeStarted)
+            return;
+        this.nativeStarted = false;
+        this.nativeSub?.remove();
+        this.nativeSub = null;
+        this.lastDegrees = null;
+        try {
+            await CrustModule.stopHeading();
+            console.log(`${LOG_TAG}: stopped`);
+        }
+        catch (err) {
+            console.error(`${LOG_TAG}: stopHeading threw`, err);
+        }
+    }
+}
+const headingService = HeadingService.getInstance();
+export default headingService;
+//# sourceMappingURL=HeadingService.js.map

package/build/services/HeadingService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HeadingService.js","sourceRoot":"","sources":["../../src/services/HeadingService.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * HeadingService\n *\n * Thin singleton over the native compass stream exposed by `crust`.\n * Works on both Android and iOS via CLLocationManager (iOS) / SensorManager (Android).\n *\n * Reference-counted: the underlying SensorManager subscription starts on\n * the first listener and stops when the last one unsubscribes. Late\n * subscribers get the most recently emitted heading replayed\n * synchronously so the UI doesn't have to wait for the next sensor tick.\n */\n\nimport CrustModule from \"@mentra/crust\"\n\nconst LOG_TAG = \"HEADING_SERVICE\"\n\nexport type HeadingListener = (degrees: number) => void\n\nclass HeadingService {\n  private static instance: HeadingService | null = null\n  private listeners = new Set<HeadingListener>()\n  private nativeSub: {remove: () => void} | null = null\n  private lastDegrees: number | null = null\n  private nativeStarted = false\n\n  private constructor() {}\n\n  public static getInstance(): HeadingService {\n    if (!HeadingService.instance) {\n      HeadingService.instance = new HeadingService()\n    }\n    return HeadingService.instance\n  }\n\n  public addListener(listener: HeadingListener): () => void {\n    this.listeners.add(listener)\n    if (!this.nativeStarted) {\n      this.startNative()\n    }\n    if (this.lastDegrees != null) {\n      try {\n        listener(this.lastDegrees)\n      } catch (err) {\n        console.error(`${LOG_TAG}: listener threw on replay`, err)\n      }\n    }\n    return () => {\n      this.listeners.delete(listener)\n      if (this.listeners.size === 0) {\n        this.stopNative()\n      }\n    }\n  }\n\n  private async startNative(): Promise<void> {\n    if (this.nativeStarted) return\n    this.nativeStarted = true\n    this.nativeSub = CrustModule.addListener(\"onHeading\", (data) => {\n      const deg = Number(data.degrees)\n      if (!Number.isFinite(deg)) return\n      this.lastDegrees = deg\n      this.listeners.forEach((l) => {\n        try {\n          l(deg)\n        } catch (err) {\n          console.error(`${LOG_TAG}: listener threw`, err)\n        }\n      })\n    })\n    try {\n      const result = await CrustModule.startHeading()\n      if (!result.ok) {\n        console.warn(`${LOG_TAG}: startHeading failed — ${result.error}`)\n      } else {\n        console.log(`${LOG_TAG}: started`)\n      }\n    } catch (err) {\n      console.error(`${LOG_TAG}: startHeading threw`, err)\n    }\n  }\n\n  private async stopNative(): Promise<void> {\n    if (!this.nativeStarted) return\n    this.nativeStarted = false\n    this.nativeSub?.remove()\n    this.nativeSub = null\n    this.lastDegrees = null\n    try {\n      await CrustModule.stopHeading()\n      console.log(`${LOG_TAG}: stopped`)\n    } catch (err) {\n      console.error(`${LOG_TAG}: stopHeading threw`, err)\n    }\n  }\n}\n\nconst headingService = HeadingService.getInstance()\nexport default headingService\n"]}