@mentra/engine 0.1.0-beta.0

package/build/facades/pairing.js

@@ -0,0 +1,275 @@
+/**
+ * pairing facade — `engine.pairing`: scan for nearby glasses + pair. Scan state
+ * (searching + results) comes from the engine core store; scan/connect go over the
+ * bluetooth-sdk; pair-failure / not-ready are the bluetooth-sdk events.
+ *
+ * (Connect-the-already-paired-default is `engine.glasses.connectDefault()`; this
+ * facade is the first-time discovery + pair flow.)
+ */
+// Internal btsdk surface — updateBluetoothSettings (the Bluetooth Classic
+// target hint) lives on the full surface, not the public entry (same reason
+// the glasses facade imports internal).
+import BluetoothSdk from "@mentra/bluetooth-sdk/internal";
+import { useCoreStore } from "../stores/core";
+import { useGlassesStore } from "../stores/glasses";
+import { hasDefaultDevice } from "../services/DeviceStoreHydration";
+import { markPendingSelection, projectPairingIdentity, subscribePairingIdentity, } from "../services/PairingIdentity";
+import { isGlassesConnected, isGlassesLinkLayerBusy, isGlassesReady, waitForGlassesReady, } from "../services/GlassesReadiness";
+import { logAutomaticReportSubmissionStatus, toAutomaticReportSubmissionStatus, } from "../services/AutomaticReportResult";
+import { pushAllBluetoothSettings } from "../services/GlassesSettingsSync";
+import { submitAutomaticReport } from "./reports";
+const DEFAULT_PAIRING_BOOT_TIMEOUT_MS = 35_000;
+const DEFAULT_BT_CLASSIC_TIMEOUT_MS = 1_000;
+const DEFAULT_PAIRING_ROUTE = "/pairing/loading";
+const LOG_TAG = "PairingTimeoutReport";
+function projectReadiness() {
+    const s = useGlassesStore.getState();
+    return {
+        state: s.connection.state,
+        connected: s.connection.state === "connected",
+        fullyBooted: isGlassesReady(s.connection),
+        bluetoothClassicConnected: s.bluetoothClassicConnected,
+        nativeLinkBusy: isGlassesLinkLayerBusy(s.connection),
+    };
+}
+export async function submitPairingBootTimeoutReport(params) {
+    const { deviceModel, deviceName, showGlassesBooting, elapsedMs, route = DEFAULT_PAIRING_ROUTE } = params;
+    const result = await submitAutomaticReport({
+        kind: "automatic",
+        trigger: {
+            type: "automatic",
+            source: "pairing_loading",
+            reason: "glasses_connect_timeout",
+        },
+        report: {
+            expectedBehavior: `Glasses should connect successfully within ${Math.round(elapsedMs / 1000)} seconds.`,
+            actualBehavior: JSON.stringify({
+                deviceModel,
+                deviceName,
+                showGlassesBooting,
+                elapsedMs,
+                route,
+            }, null, 2),
+            systemPriority: "medium",
+        },
+        throttleKey: `pairing_timeout|${deviceModel || "unknown"}|${deviceName || "unknown"}`,
+    });
+    const status = toAutomaticReportSubmissionStatus(result);
+    logAutomaticReportSubmissionStatus(LOG_TAG, status, deviceModel, deviceName);
+    return status;
+}
+async function waitForReadyDuringPairing(options = {}) {
+    const timeoutMs = options.timeoutMs ?? DEFAULT_PAIRING_BOOT_TIMEOUT_MS;
+    let showGlassesBooting = false;
+    const notReadySub = BluetoothSdk.addListener("glasses_not_ready", () => {
+        showGlassesBooting = true;
+    });
+    try {
+        const ready = await waitForGlassesReady({
+            getConnection: () => useGlassesStore.getState().connection,
+            subscribe: (listener) => useGlassesStore.subscribe((state) => state.connection, listener),
+            timeoutMs,
+            signal: options.signal,
+        });
+        if (!ready && !options.signal?.aborted) {
+            void submitPairingBootTimeoutReport({
+                deviceModel: options.deviceModel,
+                deviceName: options.deviceName,
+                showGlassesBooting,
+                elapsedMs: timeoutMs,
+                route: options.route,
+            }).catch((error) => {
+                console.error(`[${LOG_TAG}] Unexpected error:`, error);
+            });
+        }
+        return ready;
+    }
+    finally {
+        notReadySub.remove();
+    }
+}
+async function waitForBluetoothClassic(options = {}) {
+    const timeoutMs = options.timeoutMs ?? DEFAULT_BT_CLASSIC_TIMEOUT_MS;
+    return new Promise((resolve) => {
+        if (options.signal?.aborted) {
+            resolve(false);
+            return;
+        }
+        const initial = useGlassesStore.getState().bluetoothClassicConnected;
+        if (initial) {
+            resolve(true);
+            return;
+        }
+        let settled = false;
+        let timeout = null;
+        let unsubscribe = null;
+        let onAbort = null;
+        const finish = (value) => {
+            if (settled)
+                return;
+            settled = true;
+            if (timeout)
+                clearTimeout(timeout);
+            if (unsubscribe)
+                unsubscribe();
+            if (onAbort && options.signal)
+                options.signal.removeEventListener("abort", onAbort);
+            resolve(value);
+        };
+        if (options.signal) {
+            onAbort = () => finish(false);
+            options.signal.addEventListener("abort", onAbort);
+        }
+        unsubscribe = useGlassesStore.subscribe((s) => s.bluetoothClassicConnected, (connected) => {
+            if (connected)
+                finish(true);
+        });
+        timeout = setTimeout(() => {
+            finish(useGlassesStore.getState().bluetoothClassicConnected);
+        }, timeoutMs);
+    });
+}
+export const pairing = {
+    readiness: () => projectReadiness(),
+    onReadiness: (cb) => {
+        let last = JSON.stringify(projectReadiness());
+        return useGlassesStore.subscribe(() => {
+            const snap = projectReadiness();
+            const key = JSON.stringify(snap);
+            if (key === last)
+                return;
+            last = key;
+            cb(snap);
+        });
+    },
+    // --- pairing-identity lifecycle (the PairingIdentity read-model + the JS-owned
+    // identity writes; promotion to `paired` only ever happens natively) ---
+    /** The identity lifecycle snapshot: none | pending (chosen, never paired) | paired. */
+    identity: () => projectPairingIdentity(),
+    /** Subscribe to identity changes; fires only when the projected snapshot changes.
+     * Returns an unsubscribe. */
+    onIdentity: (cb) => subscribePairingIdentity(cb),
+    /** Mark the chosen model as the pending selection (the scan-entry write); the
+     * host renders it as a finish-pairing affordance until pairing succeeds. */
+    markPendingSelection: (model) => markPendingSelection(model),
+    /** Start scanning for nearby glasses. Results land on `searchResults()`/`onFound()`. */
+    scan: (...args) => BluetoothSdk.startScan(...args),
+    /** Whether a scan is currently in progress. */
+    scanning: () => useCoreStore.getState().searching,
+    /** Subscribe to scan-in-progress changes; fires only when it changes. Returns an unsubscribe. */
+    onScanning: (cb) => useCoreStore.subscribe((s) => s.searching, cb),
+    /** Whether a controller scan is currently in progress. */
+    scanningController: () => useCoreStore.getState().searchingController,
+    /** Subscribe to controller-scan-in-progress changes; fires only when it changes. Returns an unsubscribe. */
+    onScanningController: (cb) => useCoreStore.subscribe((s) => s.searchingController, cb),
+    /** Whether the phone has another Bluetooth (audio) device connected — the BT Classic pairing hint. */
+    otherBtConnected: () => useCoreStore.getState().otherBtConnected,
+    /** Subscribe to other-Bluetooth-device-connected changes; fires only when it changes. Returns an unsubscribe. */
+    onOtherBtConnected: (cb) => useCoreStore.subscribe((s) => s.otherBtConnected, cb),
+    /** The current scan results (snapshot). */
+    // Copy the array AND each entry: neither the list nor the Device objects may
+    // leak as mutable references into the store.
+    searchResults: () => useCoreStore.getState().searchResults.map((result) => ({ ...result })),
+    /** Subscribe to scan-result changes; fires only when they change. Returns an unsubscribe. */
+    onFound: (cb) => {
+        let last = JSON.stringify(useCoreStore.getState().searchResults);
+        return useCoreStore.subscribe(() => {
+            const results = useCoreStore.getState().searchResults;
+            const key = JSON.stringify(results);
+            if (key === last)
+                return;
+            last = key;
+            // Copy like searchResults(): listeners must not mutate shared scan state.
+            cb(results.map((result) => ({ ...result })));
+        });
+    },
+    /**
+     * Pair with (connect to) a discovered device. Two-phase identity: the connect
+     * attempt only marks the device as pending (`saveAsDefault: false` — no eager
+     * default-device write); the native layer promotes it to the default wearable
+     * when pairing actually succeeds (handleDeviceReady), so an abandoned or
+     * failed attempt can't leave a default identity with no paired device behind.
+     */
+    pair: async (device, options) => {
+        await pushAllBluetoothSettings();
+        return BluetoothSdk.connect(device, { ...options, saveAsDefault: false });
+    },
+    /** Set a device as the default for subsequent `glasses.connectDefault()`. */
+    setDefault: (...args) => BluetoothSdk.setDefaultDevice(...args),
+    /**
+     * Prime the native Bluetooth Classic audio watcher with the picked device.
+     * The iOS Mentra Live flow pairs Classic audio BEFORE any BLE connect
+     * exists, and native detects the pairing by matching the connected audio
+     * route against its device_name — which two-phase identity no longer sets
+     * at selection time. This is native-only routing state (device_name has no
+     * native→JS echo): the phone's persisted identity is untouched, and
+     * promotion still happens only at pairing success.
+     */
+    setBluetoothClassicTarget: (device) => BluetoothSdk.updateBluetoothSettings({ device_name: device.name }),
+    /**
+     * Abandon an in-flight pairing attempt (back-out, failure retry, conflict
+     * retry) without destroying an existing pairing. The decision comes from the
+     * LIVE hydrated default-device read — never from flow-entry state, because a
+     * pairing can PROMOTE while the flow is open (the glasses finish pairing
+     * even as the user backs out of the UI), and an entry snapshot would forget
+     * that brand-new pairing:
+     * - Default device exists and glasses are connected (nothing in flight — an
+     *   attempt drops the link first): stop the scan, touch nothing else.
+     * - Default device exists with an attempt in flight: cancel it, then re-seed
+     *   the native identity from the phone's persisted settings — the attempt's
+     *   connect-by-name overwrote the native device_name, so a later
+     *   connectDefault() would otherwise target the abandoned device.
+     * - No default device (genuinely unpaired attempt): also forget, clearing
+     *   the partial native pairing state.
+     * The read fails OPEN to "preserve" — a transient failure must never wipe a
+     * real pairing. The `pending_wearable` marker is deliberately left alone —
+     * the host renders it as a finish-pairing affordance.
+     */
+    abandonAttempt: async () => {
+        const nativeHasDefault = await hasDefaultDevice().catch(() => true);
+        if (nativeHasDefault && isGlassesConnected(useGlassesStore.getState().connection)) {
+            // Still connected means no connect attempt is in flight (an attempt drops
+            // the existing link first): the user browsed the scan and backed out.
+            // Stop the scan and leave the live pairing untouched.
+            console.log("PairingIdentity: abandonAttempt — pairing intact and connected; stopping scan only");
+            await BluetoothSdk.stopScan();
+            return;
+        }
+        await BluetoothSdk.disconnect();
+        if (projectPairingIdentity().kind === "paired") {
+            // The persisted settings describe a COMPLETE pairing: restore it to
+            // native (the attempt's connect-by-name overwrote the native
+            // device_name; and if native somehow lost its default entirely, this
+            // repairs the divergence instead of forgetting a real pairing).
+            console.log("PairingIdentity: abandonAttempt — preserving pairing; attempt cancelled, native identity re-seeded");
+            await pushAllBluetoothSettings();
+        }
+        else if (nativeHasDefault) {
+            // Mid-relay: native promoted and its echoes are still landing — the
+            // incomplete JS snapshot must not be pushed over the fresher native
+            // identity (the on-connect replay's race). Native holds the truth.
+            console.log("PairingIdentity: abandonAttempt — preserving pairing; JS identity mid-relay, native kept as-is");
+        }
+        else {
+            // Forgetting requires CONSENSUS: no native default AND no complete
+            // persisted pairing — a genuinely partial attempt.
+            console.log("PairingIdentity: abandonAttempt — no pairing on either layer; forgetting the partial attempt");
+            await BluetoothSdk.forget();
+        }
+    },
+    /** Subscribe to pairing failures; returns an unsubscribe. */
+    onPairFailure: (cb) => {
+        const sub = BluetoothSdk.addListener("pair_failure", cb);
+        return () => sub.remove();
+    },
+    /** Subscribe to glasses-not-ready events during pairing; returns an unsubscribe. */
+    onGlassesNotReady: (cb) => {
+        const sub = BluetoothSdk.addListener("glasses_not_ready", cb);
+        return () => sub.remove();
+    },
+    /** Wait for paired glasses to finish booting; engine files the timeout diagnostic. */
+    waitForReady: waitForReadyDuringPairing,
+    /** Wait briefly for Bluetooth Classic to come up after BLE pairing. */
+    waitForBluetoothClassic,
+};
+//# sourceMappingURL=pairing.js.map

package/build/facades/pairing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pairing.js","sourceRoot":"","sources":["../../src/facades/pairing.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * pairing facade — `engine.pairing`: scan for nearby glasses + pair. Scan state\n * (searching + results) comes from the engine core store; scan/connect go over the\n * bluetooth-sdk; pair-failure / not-ready are the bluetooth-sdk events.\n *\n * (Connect-the-already-paired-default is `engine.glasses.connectDefault()`; this\n * facade is the first-time discovery + pair flow.)\n */\n// Internal btsdk surface — updateBluetoothSettings (the Bluetooth Classic\n// target hint) lives on the full surface, not the public entry (same reason\n// the glasses facade imports internal).\nimport BluetoothSdk from \"@mentra/bluetooth-sdk/internal\"\nimport type {ConnectOptions, Device, PairFailureEvent, GlassesNotReadyEvent} from \"@mentra/bluetooth-sdk\"\nimport {useCoreStore} from \"../stores/core\"\nimport {useGlassesStore} from \"../stores/glasses\"\nimport {hasDefaultDevice} from \"../services/DeviceStoreHydration\"\nimport {\n  markPendingSelection,\n  projectPairingIdentity,\n  subscribePairingIdentity,\n  type IdentitySnapshot,\n} from \"../services/PairingIdentity\"\nimport {\n  isGlassesConnected,\n  isGlassesLinkLayerBusy,\n  isGlassesReady,\n  waitForGlassesReady,\n} from \"../services/GlassesReadiness\"\nimport {\n  logAutomaticReportSubmissionStatus,\n  toAutomaticReportSubmissionStatus,\n  type AutomaticReportSubmissionStatus,\n} from \"../services/AutomaticReportResult\"\nimport {pushAllBluetoothSettings} from \"../services/GlassesSettingsSync\"\nimport {submitAutomaticReport} from \"./reports\"\n\nexport type {IdentitySnapshot} from \"../services/PairingIdentity\"\n\nexport interface PairingReadyWaitOptions {\n  deviceModel?: string\n  deviceName?: string\n  timeoutMs?: number\n  route?: string\n  signal?: AbortSignal\n}\n\nconst DEFAULT_PAIRING_BOOT_TIMEOUT_MS = 35_000\nconst DEFAULT_BT_CLASSIC_TIMEOUT_MS = 1_000\nconst DEFAULT_PAIRING_ROUTE = \"/pairing/loading\"\nconst LOG_TAG = \"PairingTimeoutReport\"\n\nfunction projectReadiness() {\n  const s = useGlassesStore.getState()\n  return {\n    state: s.connection.state,\n    connected: s.connection.state === \"connected\",\n    fullyBooted: isGlassesReady(s.connection),\n    bluetoothClassicConnected: s.bluetoothClassicConnected,\n    nativeLinkBusy: isGlassesLinkLayerBusy(s.connection),\n  }\n}\n\nexport type PairingReadinessSnapshot = ReturnType<typeof projectReadiness>\n\nexport async function submitPairingBootTimeoutReport(params: {\n  deviceModel?: string\n  deviceName?: string\n  showGlassesBooting: boolean\n  elapsedMs: number\n  route?: string\n}): Promise<AutomaticReportSubmissionStatus> {\n  const {deviceModel, deviceName, showGlassesBooting, elapsedMs, route = DEFAULT_PAIRING_ROUTE} = params\n  const result = await submitAutomaticReport({\n    kind: \"automatic\",\n    trigger: {\n      type: \"automatic\",\n      source: \"pairing_loading\",\n      reason: \"glasses_connect_timeout\",\n    },\n    report: {\n      expectedBehavior: `Glasses should connect successfully within ${Math.round(elapsedMs / 1000)} seconds.`,\n      actualBehavior: JSON.stringify(\n        {\n          deviceModel,\n          deviceName,\n          showGlassesBooting,\n          elapsedMs,\n          route,\n        },\n        null,\n        2,\n      ),\n      systemPriority: \"medium\",\n    },\n    throttleKey: `pairing_timeout|${deviceModel || \"unknown\"}|${deviceName || \"unknown\"}`,\n  })\n\n  const status = toAutomaticReportSubmissionStatus(result)\n  logAutomaticReportSubmissionStatus(LOG_TAG, status, deviceModel, deviceName)\n  return status\n}\n\nasync function waitForReadyDuringPairing(options: PairingReadyWaitOptions = {}): Promise<boolean> {\n  const timeoutMs = options.timeoutMs ?? DEFAULT_PAIRING_BOOT_TIMEOUT_MS\n  let showGlassesBooting = false\n  const notReadySub = BluetoothSdk.addListener(\"glasses_not_ready\", () => {\n    showGlassesBooting = true\n  })\n\n  try {\n    const ready = await waitForGlassesReady({\n      getConnection: () => useGlassesStore.getState().connection,\n      subscribe: (listener) => useGlassesStore.subscribe((state) => state.connection, listener),\n      timeoutMs,\n      signal: options.signal,\n    })\n\n    if (!ready && !options.signal?.aborted) {\n      void submitPairingBootTimeoutReport({\n        deviceModel: options.deviceModel,\n        deviceName: options.deviceName,\n        showGlassesBooting,\n        elapsedMs: timeoutMs,\n        route: options.route,\n      }).catch((error) => {\n        console.error(`[${LOG_TAG}] Unexpected error:`, error)\n      })\n    }\n\n    return ready\n  } finally {\n    notReadySub.remove()\n  }\n}\n\nasync function waitForBluetoothClassic(\n  options: Pick<PairingReadyWaitOptions, \"timeoutMs\" | \"signal\"> = {},\n): Promise<boolean> {\n  const timeoutMs = options.timeoutMs ?? DEFAULT_BT_CLASSIC_TIMEOUT_MS\n  return new Promise((resolve) => {\n    if (options.signal?.aborted) {\n      resolve(false)\n      return\n    }\n\n    const initial = useGlassesStore.getState().bluetoothClassicConnected\n    if (initial) {\n      resolve(true)\n      return\n    }\n\n    let settled = false\n    let timeout: ReturnType<typeof setTimeout> | 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 (timeout) clearTimeout(timeout)\n      if (unsubscribe) unsubscribe()\n      if (onAbort && options.signal) options.signal.removeEventListener(\"abort\", onAbort)\n      resolve(value)\n    }\n\n    if (options.signal) {\n      onAbort = () => finish(false)\n      options.signal.addEventListener(\"abort\", onAbort)\n    }\n\n    unsubscribe = useGlassesStore.subscribe(\n      (s) => s.bluetoothClassicConnected,\n      (connected) => {\n        if (connected) finish(true)\n      },\n    )\n\n    timeout = setTimeout(() => {\n      finish(useGlassesStore.getState().bluetoothClassicConnected)\n    }, timeoutMs)\n  })\n}\n\nexport const pairing = {\n  readiness: (): PairingReadinessSnapshot => projectReadiness(),\n  onReadiness: (cb: (readiness: PairingReadinessSnapshot) => void): (() => void) => {\n    let last = JSON.stringify(projectReadiness())\n    return useGlassesStore.subscribe(() => {\n      const snap = projectReadiness()\n      const key = JSON.stringify(snap)\n      if (key === last) return\n      last = key\n      cb(snap)\n    })\n  },\n\n  // --- pairing-identity lifecycle (the PairingIdentity read-model + the JS-owned\n  // identity writes; promotion to `paired` only ever happens natively) ---\n  /** The identity lifecycle snapshot: none | pending (chosen, never paired) | paired. */\n  identity: (): IdentitySnapshot => projectPairingIdentity(),\n  /** Subscribe to identity changes; fires only when the projected snapshot changes.\n   * Returns an unsubscribe. */\n  onIdentity: (cb: (identity: IdentitySnapshot) => void): (() => void) => subscribePairingIdentity(cb),\n  /** Mark the chosen model as the pending selection (the scan-entry write); the\n   * host renders it as a finish-pairing affordance until pairing succeeds. */\n  markPendingSelection: (model: string) => markPendingSelection(model),\n\n  /** Start scanning for nearby glasses. Results land on `searchResults()`/`onFound()`. */\n  scan: (...args: Parameters<typeof BluetoothSdk.startScan>) => BluetoothSdk.startScan(...args),\n  /** Whether a scan is currently in progress. */\n  scanning: (): boolean => useCoreStore.getState().searching,\n  /** Subscribe to scan-in-progress changes; fires only when it changes. Returns an unsubscribe. */\n  onScanning: (cb: (scanning: boolean) => void): (() => void) => useCoreStore.subscribe((s) => s.searching, cb),\n  /** Whether a controller scan is currently in progress. */\n  scanningController: (): boolean => useCoreStore.getState().searchingController,\n  /** Subscribe to controller-scan-in-progress changes; fires only when it changes. Returns an unsubscribe. */\n  onScanningController: (cb: (scanning: boolean) => void): (() => void) =>\n    useCoreStore.subscribe((s) => s.searchingController, cb),\n  /** Whether the phone has another Bluetooth (audio) device connected — the BT Classic pairing hint. */\n  otherBtConnected: (): boolean => useCoreStore.getState().otherBtConnected,\n  /** Subscribe to other-Bluetooth-device-connected changes; fires only when it changes. Returns an unsubscribe. */\n  onOtherBtConnected: (cb: (connected: boolean) => void): (() => void) =>\n    useCoreStore.subscribe((s) => s.otherBtConnected, cb),\n  /** The current scan results (snapshot). */\n  // Copy the array AND each entry: neither the list nor the Device objects may\n  // leak as mutable references into the store.\n  searchResults: () => useCoreStore.getState().searchResults.map((result) => ({...result})),\n  /** Subscribe to scan-result changes; fires only when they change. Returns an unsubscribe. */\n  onFound: (cb: (results: ReturnType<typeof useCoreStore.getState>[\"searchResults\"]) => void): (() => void) => {\n    let last = JSON.stringify(useCoreStore.getState().searchResults)\n    return useCoreStore.subscribe(() => {\n      const results = useCoreStore.getState().searchResults\n      const key = JSON.stringify(results)\n      if (key === last) return\n      last = key\n      // Copy like searchResults(): listeners must not mutate shared scan state.\n      cb(results.map((result) => ({...result})))\n    })\n  },\n\n  /**\n   * Pair with (connect to) a discovered device. Two-phase identity: the connect\n   * attempt only marks the device as pending (`saveAsDefault: false` — no eager\n   * default-device write); the native layer promotes it to the default wearable\n   * when pairing actually succeeds (handleDeviceReady), so an abandoned or\n   * failed attempt can't leave a default identity with no paired device behind.\n   */\n  pair: async (device: Device, options?: ConnectOptions): Promise<void> => {\n    await pushAllBluetoothSettings()\n    return BluetoothSdk.connect(device, {...options, saveAsDefault: false})\n  },\n  /** Set a device as the default for subsequent `glasses.connectDefault()`. */\n  setDefault: (...args: Parameters<typeof BluetoothSdk.setDefaultDevice>) => BluetoothSdk.setDefaultDevice(...args),\n  /**\n   * Prime the native Bluetooth Classic audio watcher with the picked device.\n   * The iOS Mentra Live flow pairs Classic audio BEFORE any BLE connect\n   * exists, and native detects the pairing by matching the connected audio\n   * route against its device_name — which two-phase identity no longer sets\n   * at selection time. This is native-only routing state (device_name has no\n   * native→JS echo): the phone's persisted identity is untouched, and\n   * promotion still happens only at pairing success.\n   */\n  setBluetoothClassicTarget: (device: Device): Promise<void> =>\n    BluetoothSdk.updateBluetoothSettings({device_name: device.name}),\n  /**\n   * Abandon an in-flight pairing attempt (back-out, failure retry, conflict\n   * retry) without destroying an existing pairing. The decision comes from the\n   * LIVE hydrated default-device read — never from flow-entry state, because a\n   * pairing can PROMOTE while the flow is open (the glasses finish pairing\n   * even as the user backs out of the UI), and an entry snapshot would forget\n   * that brand-new pairing:\n   * - Default device exists and glasses are connected (nothing in flight — an\n   *   attempt drops the link first): stop the scan, touch nothing else.\n   * - Default device exists with an attempt in flight: cancel it, then re-seed\n   *   the native identity from the phone's persisted settings — the attempt's\n   *   connect-by-name overwrote the native device_name, so a later\n   *   connectDefault() would otherwise target the abandoned device.\n   * - No default device (genuinely unpaired attempt): also forget, clearing\n   *   the partial native pairing state.\n   * The read fails OPEN to \"preserve\" — a transient failure must never wipe a\n   * real pairing. The `pending_wearable` marker is deliberately left alone —\n   * the host renders it as a finish-pairing affordance.\n   */\n  abandonAttempt: async (): Promise<void> => {\n    const nativeHasDefault = await hasDefaultDevice().catch(() => true)\n    if (nativeHasDefault && isGlassesConnected(useGlassesStore.getState().connection)) {\n      // Still connected means no connect attempt is in flight (an attempt drops\n      // the existing link first): the user browsed the scan and backed out.\n      // Stop the scan and leave the live pairing untouched.\n      console.log(\"PairingIdentity: abandonAttempt — pairing intact and connected; stopping scan only\")\n      await BluetoothSdk.stopScan()\n      return\n    }\n    await BluetoothSdk.disconnect()\n    if (projectPairingIdentity().kind === \"paired\") {\n      // The persisted settings describe a COMPLETE pairing: restore it to\n      // native (the attempt's connect-by-name overwrote the native\n      // device_name; and if native somehow lost its default entirely, this\n      // repairs the divergence instead of forgetting a real pairing).\n      console.log(\"PairingIdentity: abandonAttempt — preserving pairing; attempt cancelled, native identity re-seeded\")\n      await pushAllBluetoothSettings()\n    } else if (nativeHasDefault) {\n      // Mid-relay: native promoted and its echoes are still landing — the\n      // incomplete JS snapshot must not be pushed over the fresher native\n      // identity (the on-connect replay's race). Native holds the truth.\n      console.log(\"PairingIdentity: abandonAttempt — preserving pairing; JS identity mid-relay, native kept as-is\")\n    } else {\n      // Forgetting requires CONSENSUS: no native default AND no complete\n      // persisted pairing — a genuinely partial attempt.\n      console.log(\"PairingIdentity: abandonAttempt — no pairing on either layer; forgetting the partial attempt\")\n      await BluetoothSdk.forget()\n    }\n  },\n\n  /** Subscribe to pairing failures; returns an unsubscribe. */\n  onPairFailure: (cb: (event: PairFailureEvent) => void): (() => void) => {\n    const sub = BluetoothSdk.addListener(\"pair_failure\", cb)\n    return () => sub.remove()\n  },\n  /** Subscribe to glasses-not-ready events during pairing; returns an unsubscribe. */\n  onGlassesNotReady: (cb: (event: GlassesNotReadyEvent) => void): (() => void) => {\n    const sub = BluetoothSdk.addListener(\"glasses_not_ready\", cb)\n    return () => sub.remove()\n  },\n  /** Wait for paired glasses to finish booting; engine files the timeout diagnostic. */\n  waitForReady: waitForReadyDuringPairing,\n  /** Wait briefly for Bluetooth Classic to come up after BLE pairing. */\n  waitForBluetoothClassic,\n}\n"]}

package/build/facades/permissions.d.ts

@@ -0,0 +1,33 @@
+/**
+ * permissions facade — `engine.permissions`: the raw OS-permission ops the runtime
+ * needs, mapped from feature keys to react-native-permissions. This is the LEAN
+ * surface (check/request/openSettings/requirementsForMiniapp) — the host keeps its
+ * own UI helpers (rationale dialogs, denied-warnings) on top; engine stays free of
+ * i18n/theme/AlertUtils.
+ */
+import { PermissionsAndroid, type Permission as AndroidPermission } from "react-native";
+import type { AppletPermission } from "../types";
+/** OEM-facing feature keys (mapped to OS permissions per platform). */
+export declare const PermissionFeatures: {
+    readonly MICROPHONE: "microphone";
+    readonly CAMERA: "camera";
+    readonly CALENDAR: "calendar";
+    readonly LOCATION: "location";
+    readonly LOCAL_WIFI: "local_wifi";
+    readonly BACKGROUND_LOCATION: "background_location";
+    readonly BLUETOOTH: "bluetooth";
+    readonly PHONE_STATE: "phone_state";
+    readonly POST_NOTIFICATIONS: "post_notifications";
+};
+export declare function localWifiPermissionForAndroid(androidApiLevel: number, androidPermissions?: typeof PermissionsAndroid.PERMISSIONS): AndroidPermission;
+export declare const permissions: {
+    /** Is the given feature's OS permission currently granted? */
+    check(feature: string): Promise<boolean>;
+    /** Request the given feature's OS permission. Resolves to whether it's granted. */
+    request(feature: string): Promise<boolean>;
+    /** Open the OS settings app (so the user can grant a blocked permission). */
+    openSettings: () => Promise<void>;
+    /** The permissions a given installed miniapp declares it needs. */
+    requirementsForMiniapp(packageName: string): Promise<AppletPermission[]>;
+};
+//# sourceMappingURL=permissions.d.ts.map

package/build/facades/permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../src/facades/permissions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAoB,kBAAkB,EAAE,KAAK,UAAU,IAAI,iBAAiB,EAAC,MAAM,cAAc,CAAA;AAIxG,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,UAAU,CAAA;AAE9C,uEAAuE;AACvE,eAAO,MAAM,kBAAkB;;;;;;;;;;CAUrB,CAAA;AAMV,wBAAgB,6BAA6B,CAC3C,eAAe,EAAE,MAAM,EACvB,kBAAkB,GAAE,OAAO,kBAAkB,CAAC,WAAqB,GAClE,iBAAiB,CAEnB;AAgFD,eAAO,MAAM,WAAW;IACtB,8DAA8D;mBACzC,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAmB9C,mFAAmF;qBAC5D,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAmBhD,6EAA6E;wBAC3D,OAAO,CAAC,IAAI,CAAC;IAE/B,mEAAmE;wCACzB,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAI/E,CAAA"}

package/build/facades/permissions.js

@@ -0,0 +1,155 @@
+/**
+ * permissions facade — `engine.permissions`: the raw OS-permission ops the runtime
+ * needs, mapped from feature keys to react-native-permissions. This is the LEAN
+ * surface (check/request/openSettings/requirementsForMiniapp) — the host keeps its
+ * own UI helpers (rationale dialogs, denied-warnings) on top; engine stays free of
+ * i18n/theme/AlertUtils.
+ */
+import { Platform, Linking, PermissionsAndroid } from "react-native";
+import { check, request, PERMISSIONS, RESULTS } from "react-native-permissions";
+import appRegistry from "../services/AppRegistry";
+/** OEM-facing feature keys (mapped to OS permissions per platform). */
+export const PermissionFeatures = {
+    MICROPHONE: "microphone",
+    CAMERA: "camera",
+    CALENDAR: "calendar",
+    LOCATION: "location",
+    LOCAL_WIFI: "local_wifi",
+    BACKGROUND_LOCATION: "background_location",
+    BLUETOOTH: "bluetooth",
+    PHONE_STATE: "phone_state",
+    POST_NOTIFICATIONS: "post_notifications",
+};
+const ANDROID = PermissionsAndroid.PERMISSIONS;
+const apiLevel = typeof Platform.Version === "number" ? Platform.Version : parseInt(String(Platform.Version), 10);
+const requiresSeparateAndroidBackgroundLocation = apiLevel >= 29;
+export function localWifiPermissionForAndroid(androidApiLevel, androidPermissions = ANDROID) {
+    return androidApiLevel >= 33 ? androidPermissions.NEARBY_WIFI_DEVICES : androidPermissions.ACCESS_FINE_LOCATION;
+}
+async function areAndroidPermissionsGranted(perms) {
+    for (const p of perms) {
+        if (!(await PermissionsAndroid.check(p)))
+            return false;
+    }
+    return true;
+}
+async function requestAndroidPermissions(perms) {
+    const results = await PermissionsAndroid.requestMultiple(perms);
+    return perms.every((p) => results[p] === PermissionsAndroid.RESULTS.GRANTED);
+}
+async function checkAndroidBackgroundLocation() {
+    const hasForegroundLocation = await areAndroidPermissionsGranted([ANDROID.ACCESS_FINE_LOCATION]);
+    if (!hasForegroundLocation || !requiresSeparateAndroidBackgroundLocation)
+        return hasForegroundLocation;
+    return PermissionsAndroid.check(ANDROID.ACCESS_BACKGROUND_LOCATION);
+}
+async function requestAndroidBackgroundLocation() {
+    const hasForegroundLocation = await requestAndroidPermissions([ANDROID.ACCESS_FINE_LOCATION]);
+    if (!hasForegroundLocation || !requiresSeparateAndroidBackgroundLocation)
+        return hasForegroundLocation;
+    if (await PermissionsAndroid.check(ANDROID.ACCESS_BACKGROUND_LOCATION))
+        return true;
+    const result = await PermissionsAndroid.request(ANDROID.ACCESS_BACKGROUND_LOCATION);
+    return result === PermissionsAndroid.RESULTS.GRANTED;
+}
+function iosPerms(feature) {
+    switch (feature) {
+        case PermissionFeatures.MICROPHONE:
+            return [PERMISSIONS.IOS.MICROPHONE];
+        case PermissionFeatures.CAMERA:
+            return [PERMISSIONS.IOS.CAMERA];
+        case PermissionFeatures.CALENDAR:
+            return [PERMISSIONS.IOS.CALENDARS];
+        case PermissionFeatures.LOCATION:
+            return [PERMISSIONS.IOS.LOCATION_WHEN_IN_USE];
+        case PermissionFeatures.LOCAL_WIFI:
+            return [];
+        case PermissionFeatures.BACKGROUND_LOCATION:
+            // iOS won't grant ALWAYS without WHEN_IN_USE first — request both (matches
+            // the host PermissionsUtils mapping), else a cold request can't escalate.
+            return [PERMISSIONS.IOS.LOCATION_WHEN_IN_USE, PERMISSIONS.IOS.LOCATION_ALWAYS];
+        case PermissionFeatures.BLUETOOTH:
+            return [PERMISSIONS.IOS.BLUETOOTH];
+        default:
+            return [];
+    }
+}
+function androidPerms(feature) {
+    switch (feature) {
+        case PermissionFeatures.MICROPHONE:
+            return [ANDROID.RECORD_AUDIO];
+        case PermissionFeatures.CAMERA:
+            return [ANDROID.CAMERA];
+        case PermissionFeatures.CALENDAR:
+            // Expo Calendar requires both grants on Android, including for read APIs.
+            // The miniapp-facing calendar API remains read-only.
+            return [ANDROID.READ_CALENDAR, ANDROID.WRITE_CALENDAR];
+        case PermissionFeatures.LOCATION:
+        case PermissionFeatures.BACKGROUND_LOCATION:
+            return [ANDROID.ACCESS_FINE_LOCATION];
+        case PermissionFeatures.LOCAL_WIFI:
+            return [localWifiPermissionForAndroid(apiLevel)];
+        case PermissionFeatures.PHONE_STATE:
+            return [ANDROID.READ_PHONE_STATE];
+        case PermissionFeatures.BLUETOOTH:
+            return apiLevel >= 31 ? [ANDROID.BLUETOOTH_SCAN, ANDROID.BLUETOOTH_CONNECT, ANDROID.BLUETOOTH_ADVERTISE] : [];
+        case PermissionFeatures.POST_NOTIFICATIONS:
+            return apiLevel >= 33 ? [ANDROID.POST_NOTIFICATIONS] : [];
+        default:
+            return [];
+    }
+}
+export const permissions = {
+    /** Is the given feature's OS permission currently granted? */
+    async check(feature) {
+        if (Platform.OS === "android") {
+            if (feature === PermissionFeatures.BACKGROUND_LOCATION)
+                return checkAndroidBackgroundLocation();
+            const perms = androidPerms(feature);
+            if (perms.length === 0)
+                return true; // nothing to ask on this OS/version
+            // Every permission in the group must be granted (e.g. bluetooth =
+            // scan+connect+advertise, calendar = read+write) — matches the iOS branch.
+            return areAndroidPermissionsGranted(perms);
+        }
+        const perms = iosPerms(feature);
+        if (perms.length === 0)
+            return true;
+        for (const p of perms) {
+            const status = await check(p);
+            if (status !== RESULTS.GRANTED && status !== RESULTS.LIMITED)
+                return false;
+        }
+        return true;
+    },
+    /** Request the given feature's OS permission. Resolves to whether it's granted. */
+    async request(feature) {
+        if (Platform.OS === "android") {
+            if (feature === PermissionFeatures.BACKGROUND_LOCATION)
+                return requestAndroidBackgroundLocation();
+            const perms = androidPerms(feature);
+            if (perms.length === 0)
+                return true;
+            // Granted only when EVERY permission in the group was granted.
+            return requestAndroidPermissions(perms);
+        }
+        const perms = iosPerms(feature);
+        if (perms.length === 0)
+            return true;
+        let granted = true;
+        for (const p of perms) {
+            const result = await request(p);
+            if (result !== RESULTS.GRANTED && result !== RESULTS.LIMITED)
+                granted = false;
+        }
+        return granted;
+    },
+    /** Open the OS settings app (so the user can grant a blocked permission). */
+    openSettings: () => Linking.openSettings(),
+    /** The permissions a given installed miniapp declares it needs. */
+    async requirementsForMiniapp(packageName) {
+        const apps = await appRegistry.getInstalledMiniapps();
+        return apps.find((a) => a.packageName === packageName)?.permissions ?? [];
+    },
+};
+//# sourceMappingURL=permissions.js.map

package/build/facades/permissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../../src/facades/permissions.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * permissions facade — `engine.permissions`: the raw OS-permission ops the runtime\n * needs, mapped from feature keys to react-native-permissions. This is the LEAN\n * surface (check/request/openSettings/requirementsForMiniapp) — the host keeps its\n * own UI helpers (rationale dialogs, denied-warnings) on top; engine stays free of\n * i18n/theme/AlertUtils.\n */\nimport {Platform, Linking, PermissionsAndroid, type Permission as AndroidPermission} from \"react-native\"\nimport {check, request, PERMISSIONS, RESULTS, type Permission} from \"react-native-permissions\"\n\nimport appRegistry from \"../services/AppRegistry\"\nimport type {AppletPermission} from \"../types\"\n\n/** OEM-facing feature keys (mapped to OS permissions per platform). */\nexport const PermissionFeatures = {\n  MICROPHONE: \"microphone\",\n  CAMERA: \"camera\",\n  CALENDAR: \"calendar\",\n  LOCATION: \"location\",\n  LOCAL_WIFI: \"local_wifi\",\n  BACKGROUND_LOCATION: \"background_location\",\n  BLUETOOTH: \"bluetooth\",\n  PHONE_STATE: \"phone_state\",\n  POST_NOTIFICATIONS: \"post_notifications\",\n} as const\n\nconst ANDROID = PermissionsAndroid.PERMISSIONS\nconst apiLevel = typeof Platform.Version === \"number\" ? Platform.Version : parseInt(String(Platform.Version), 10)\nconst requiresSeparateAndroidBackgroundLocation = apiLevel >= 29\n\nexport function localWifiPermissionForAndroid(\n  androidApiLevel: number,\n  androidPermissions: typeof PermissionsAndroid.PERMISSIONS = ANDROID,\n): AndroidPermission {\n  return androidApiLevel >= 33 ? androidPermissions.NEARBY_WIFI_DEVICES : androidPermissions.ACCESS_FINE_LOCATION\n}\n\nasync function areAndroidPermissionsGranted(perms: AndroidPermission[]): Promise<boolean> {\n  for (const p of perms) {\n    if (!(await PermissionsAndroid.check(p))) return false\n  }\n  return true\n}\n\nasync function requestAndroidPermissions(perms: AndroidPermission[]): Promise<boolean> {\n  const results = await PermissionsAndroid.requestMultiple(perms)\n  return perms.every((p) => results[p] === PermissionsAndroid.RESULTS.GRANTED)\n}\n\nasync function checkAndroidBackgroundLocation(): Promise<boolean> {\n  const hasForegroundLocation = await areAndroidPermissionsGranted([ANDROID.ACCESS_FINE_LOCATION])\n  if (!hasForegroundLocation || !requiresSeparateAndroidBackgroundLocation) return hasForegroundLocation\n\n  return PermissionsAndroid.check(ANDROID.ACCESS_BACKGROUND_LOCATION)\n}\n\nasync function requestAndroidBackgroundLocation(): Promise<boolean> {\n  const hasForegroundLocation = await requestAndroidPermissions([ANDROID.ACCESS_FINE_LOCATION])\n  if (!hasForegroundLocation || !requiresSeparateAndroidBackgroundLocation) return hasForegroundLocation\n\n  if (await PermissionsAndroid.check(ANDROID.ACCESS_BACKGROUND_LOCATION)) return true\n\n  const result = await PermissionsAndroid.request(ANDROID.ACCESS_BACKGROUND_LOCATION)\n  return result === PermissionsAndroid.RESULTS.GRANTED\n}\n\nfunction iosPerms(feature: string): Permission[] {\n  switch (feature) {\n    case PermissionFeatures.MICROPHONE:\n      return [PERMISSIONS.IOS.MICROPHONE]\n    case PermissionFeatures.CAMERA:\n      return [PERMISSIONS.IOS.CAMERA]\n    case PermissionFeatures.CALENDAR:\n      return [PERMISSIONS.IOS.CALENDARS]\n    case PermissionFeatures.LOCATION:\n      return [PERMISSIONS.IOS.LOCATION_WHEN_IN_USE]\n    case PermissionFeatures.LOCAL_WIFI:\n      return []\n    case PermissionFeatures.BACKGROUND_LOCATION:\n      // iOS won't grant ALWAYS without WHEN_IN_USE first — request both (matches\n      // the host PermissionsUtils mapping), else a cold request can't escalate.\n      return [PERMISSIONS.IOS.LOCATION_WHEN_IN_USE, PERMISSIONS.IOS.LOCATION_ALWAYS]\n    case PermissionFeatures.BLUETOOTH:\n      return [PERMISSIONS.IOS.BLUETOOTH]\n    default:\n      return []\n  }\n}\n\nfunction androidPerms(feature: string): AndroidPermission[] {\n  switch (feature) {\n    case PermissionFeatures.MICROPHONE:\n      return [ANDROID.RECORD_AUDIO]\n    case PermissionFeatures.CAMERA:\n      return [ANDROID.CAMERA]\n    case PermissionFeatures.CALENDAR:\n      // Expo Calendar requires both grants on Android, including for read APIs.\n      // The miniapp-facing calendar API remains read-only.\n      return [ANDROID.READ_CALENDAR, ANDROID.WRITE_CALENDAR]\n    case PermissionFeatures.LOCATION:\n    case PermissionFeatures.BACKGROUND_LOCATION:\n      return [ANDROID.ACCESS_FINE_LOCATION]\n    case PermissionFeatures.LOCAL_WIFI:\n      return [localWifiPermissionForAndroid(apiLevel)]\n    case PermissionFeatures.PHONE_STATE:\n      return [ANDROID.READ_PHONE_STATE]\n    case PermissionFeatures.BLUETOOTH:\n      return apiLevel >= 31 ? [ANDROID.BLUETOOTH_SCAN, ANDROID.BLUETOOTH_CONNECT, ANDROID.BLUETOOTH_ADVERTISE] : []\n    case PermissionFeatures.POST_NOTIFICATIONS:\n      return apiLevel >= 33 ? [ANDROID.POST_NOTIFICATIONS] : []\n    default:\n      return []\n  }\n}\n\nexport const permissions = {\n  /** Is the given feature's OS permission currently granted? */\n  async check(feature: string): Promise<boolean> {\n    if (Platform.OS === \"android\") {\n      if (feature === PermissionFeatures.BACKGROUND_LOCATION) return checkAndroidBackgroundLocation()\n\n      const perms = androidPerms(feature)\n      if (perms.length === 0) return true // nothing to ask on this OS/version\n      // Every permission in the group must be granted (e.g. bluetooth =\n      // scan+connect+advertise, calendar = read+write) — matches the iOS branch.\n      return areAndroidPermissionsGranted(perms)\n    }\n    const perms = iosPerms(feature)\n    if (perms.length === 0) return true\n    for (const p of perms) {\n      const status = await check(p)\n      if (status !== RESULTS.GRANTED && status !== RESULTS.LIMITED) return false\n    }\n    return true\n  },\n\n  /** Request the given feature's OS permission. Resolves to whether it's granted. */\n  async request(feature: string): Promise<boolean> {\n    if (Platform.OS === \"android\") {\n      if (feature === PermissionFeatures.BACKGROUND_LOCATION) return requestAndroidBackgroundLocation()\n\n      const perms = androidPerms(feature)\n      if (perms.length === 0) return true\n      // Granted only when EVERY permission in the group was granted.\n      return requestAndroidPermissions(perms)\n    }\n    const perms = iosPerms(feature)\n    if (perms.length === 0) return true\n    let granted = true\n    for (const p of perms) {\n      const result = await request(p)\n      if (result !== RESULTS.GRANTED && result !== RESULTS.LIMITED) granted = false\n    }\n    return granted\n  },\n\n  /** Open the OS settings app (so the user can grant a blocked permission). */\n  openSettings: (): Promise<void> => Linking.openSettings(),\n\n  /** The permissions a given installed miniapp declares it needs. */\n  async requirementsForMiniapp(packageName: string): Promise<AppletPermission[]> {\n    const apps = await appRegistry.getInstalledMiniapps()\n    return apps.find((a) => a.packageName === packageName)?.permissions ?? []\n  },\n}\n"]}

package/build/facades/phoneNotifications.d.ts

@@ -0,0 +1,21 @@
+export declare const phoneNotifications: {
+    /** Is phone-notification forwarding enabled? (false on iOS) */
+    enabled: () => boolean;
+    /** Enable/disable phone-notification forwarding. (no-op on iOS) */
+    setEnabled: (enabled: boolean) => import("typesafe-ts").AsyncResult<void, Error> | undefined;
+    /** The phone's installed apps (package, name, icon). (empty on iOS) */
+    installedApps: () => Promise<Array<{
+        packageName: string;
+        appName: string;
+        icon: string | null;
+    }>>;
+    /** The per-app blocklist (package names whose notifications are NOT forwarded). */
+    blocklist: () => string[];
+    /** Replace the per-app blocklist. */
+    setBlocklist: (packageNames: string[]) => import("typesafe-ts").AsyncResult<void, Error>;
+    /** Does the app have the Android notification-listener permission? (false on iOS) */
+    hasListenerPermission: () => Promise<boolean>;
+    /** Open the OS settings to grant the notification-listener permission. (no-op on iOS) */
+    requestListenerPermission: () => Promise<boolean> | undefined;
+};
+//# sourceMappingURL=phoneNotifications.d.ts.map

package/build/facades/phoneNotifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phoneNotifications.d.ts","sourceRoot":"","sources":["../../src/facades/phoneNotifications.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,kBAAkB;IAC7B,+DAA+D;mBAClD,OAAO;IAIpB,mEAAmE;0BAC7C,OAAO;IAK7B,uEAAuE;yBACpD,OAAO,CAAC,KAAK,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;KAAC,CAAC,CAAC;IAK9F,mFAAmF;qBACpE,MAAM,EAAE;IAIvB,qCAAqC;iCACR,MAAM,EAAE;IAGrC,qFAAqF;iCAC1D,OAAO,CAAC,OAAO,CAAC;IAI3C,yFAAyF;;CAK1F,CAAA"}

package/build/facades/phoneNotifications.js

@@ -0,0 +1,51 @@
+/**
+ * phoneNotifications facade — `engine.phoneNotifications`: forward phone
+ * notifications to the glasses, with a per-app blocklist. Android-only (the
+ * NotificationListenerService); the getters return sensible defaults on iOS.
+ *
+ * Enabled-state + blocklist are engine settings (auto-synced to the native
+ * listener); the installed-apps list + the listener permission are CrustModule.
+ */
+import { Platform } from "react-native";
+import CrustModule from "@mentra/crust";
+import { useSettingsStore, SETTINGS } from "../stores/settings";
+export const phoneNotifications = {
+    /** Is phone-notification forwarding enabled? (false on iOS) */
+    enabled: () => {
+        if (Platform.OS !== "android")
+            return false;
+        return useSettingsStore.getState().getSetting(SETTINGS.notifications_enabled.key) ?? true;
+    },
+    /** Enable/disable phone-notification forwarding. (no-op on iOS) */
+    setEnabled: (enabled) => {
+        if (Platform.OS !== "android")
+            return;
+        return useSettingsStore.getState().setSetting(SETTINGS.notifications_enabled.key, enabled);
+    },
+    /** The phone's installed apps (package, name, icon). (empty on iOS) */
+    installedApps: () => {
+        if (Platform.OS !== "android")
+            return Promise.resolve([]);
+        return CrustModule.getInstalledApps();
+    },
+    /** The per-app blocklist (package names whose notifications are NOT forwarded). */
+    blocklist: () => {
+        const b = useSettingsStore.getState().getSetting(SETTINGS.notifications_blocklist.key);
+        return Array.isArray(b) ? b : [];
+    },
+    /** Replace the per-app blocklist. */
+    setBlocklist: (packageNames) => useSettingsStore.getState().setSetting(SETTINGS.notifications_blocklist.key, packageNames),
+    /** Does the app have the Android notification-listener permission? (false on iOS) */
+    hasListenerPermission: () => {
+        if (Platform.OS !== "android")
+            return Promise.resolve(false);
+        return CrustModule.hasNotificationListenerPermission();
+    },
+    /** Open the OS settings to grant the notification-listener permission. (no-op on iOS) */
+    requestListenerPermission: () => {
+        if (Platform.OS !== "android")
+            return;
+        return CrustModule.openNotificationListenerSettings();
+    },
+};
+//# sourceMappingURL=phoneNotifications.js.map

package/build/facades/phoneNotifications.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phoneNotifications.js","sourceRoot":"","sources":["../../src/facades/phoneNotifications.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAC,QAAQ,EAAC,MAAM,cAAc,CAAA;AACrC,OAAO,WAAW,MAAM,eAAe,CAAA;AACvC,OAAO,EAAC,gBAAgB,EAAE,QAAQ,EAAC,MAAM,oBAAoB,CAAA;AAE7D,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,+DAA+D;IAC/D,OAAO,EAAE,GAAY,EAAE;QACrB,IAAI,QAAQ,CAAC,EAAE,KAAK,SAAS;YAAE,OAAO,KAAK,CAAA;QAC3C,OAAO,gBAAgB,CAAC,QAAQ,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,qBAAqB,CAAC,GAAG,CAAC,IAAI,IAAI,CAAA;IAC3F,CAAC;IACD,mEAAmE;IACnE,UAAU,EAAE,CAAC,OAAgB,EAAE,EAAE;QAC/B,IAAI,QAAQ,CAAC,EAAE,KAAK,SAAS;YAAE,OAAM;QACrC,OAAO,gBAAgB,CAAC,QAAQ,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,qBAAqB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;IAC5F,CAAC;IAED,uEAAuE;IACvE,aAAa,EAAE,GAAgF,EAAE;QAC/F,IAAI,QAAQ,CAAC,EAAE,KAAK,SAAS;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QACzD,OAAO,WAAW,CAAC,gBAAgB,EAAE,CAAA;IACvC,CAAC;IAED,mFAAmF;IACnF,SAAS,EAAE,GAAa,EAAE;QACxB,MAAM,CAAC,GAAG,gBAAgB,CAAC,QAAQ,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAA;QACtF,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAClC,CAAC;IACD,qCAAqC;IACrC,YAAY,EAAE,CAAC,YAAsB,EAAE,EAAE,CACvC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,uBAAuB,CAAC,GAAG,EAAE,YAAY,CAAC;IAE5F,qFAAqF;IACrF,qBAAqB,EAAE,GAAqB,EAAE;QAC5C,IAAI,QAAQ,CAAC,EAAE,KAAK,SAAS;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QAC5D,OAAO,WAAW,CAAC,iCAAiC,EAAE,CAAA;IACxD,CAAC;IACD,yFAAyF;IACzF,yBAAyB,EAAE,GAAG,EAAE;QAC9B,IAAI,QAAQ,CAAC,EAAE,KAAK,SAAS;YAAE,OAAM;QACrC,OAAO,WAAW,CAAC,gCAAgC,EAAE,CAAA;IACvD,CAAC;CACF,CAAA","sourcesContent":["/**\n * phoneNotifications facade — `engine.phoneNotifications`: forward phone\n * notifications to the glasses, with a per-app blocklist. Android-only (the\n * NotificationListenerService); the getters return sensible defaults on iOS.\n *\n * Enabled-state + blocklist are engine settings (auto-synced to the native\n * listener); the installed-apps list + the listener permission are CrustModule.\n */\nimport {Platform} from \"react-native\"\nimport CrustModule from \"@mentra/crust\"\nimport {useSettingsStore, SETTINGS} from \"../stores/settings\"\n\nexport const phoneNotifications = {\n  /** Is phone-notification forwarding enabled? (false on iOS) */\n  enabled: (): boolean => {\n    if (Platform.OS !== \"android\") return false\n    return useSettingsStore.getState().getSetting(SETTINGS.notifications_enabled.key) ?? true\n  },\n  /** Enable/disable phone-notification forwarding. (no-op on iOS) */\n  setEnabled: (enabled: boolean) => {\n    if (Platform.OS !== \"android\") return\n    return useSettingsStore.getState().setSetting(SETTINGS.notifications_enabled.key, enabled)\n  },\n\n  /** The phone's installed apps (package, name, icon). (empty on iOS) */\n  installedApps: (): Promise<Array<{packageName: string; appName: string; icon: string | null}>> => {\n    if (Platform.OS !== \"android\") return Promise.resolve([])\n    return CrustModule.getInstalledApps()\n  },\n\n  /** The per-app blocklist (package names whose notifications are NOT forwarded). */\n  blocklist: (): string[] => {\n    const b = useSettingsStore.getState().getSetting(SETTINGS.notifications_blocklist.key)\n    return Array.isArray(b) ? b : []\n  },\n  /** Replace the per-app blocklist. */\n  setBlocklist: (packageNames: string[]) =>\n    useSettingsStore.getState().setSetting(SETTINGS.notifications_blocklist.key, packageNames),\n\n  /** Does the app have the Android notification-listener permission? (false on iOS) */\n  hasListenerPermission: (): Promise<boolean> => {\n    if (Platform.OS !== \"android\") return Promise.resolve(false)\n    return CrustModule.hasNotificationListenerPermission()\n  },\n  /** Open the OS settings to grant the notification-listener permission. (no-op on iOS) */\n  requestListenerPermission: () => {\n    if (Platform.OS !== \"android\") return\n    return CrustModule.openNotificationListenerSettings()\n  },\n}\n"]}