@mentra/bluetooth-sdk 0.1.3 → 0.1.4

package/build/react/useGlassesConnection.js

@@ -0,0 +1,140 @@
+import { useEffect, useRef, useState } from "react";
+import BluetoothSdk from "../index";
+import { useBluetoothScan } from "./useBluetoothScan";
+import { useBluetoothStatus } from "./useBluetoothStatus";
+export function useGlassesConnection(options = {}) {
+    const status = useBluetoothStatus({ onError: options.onError });
+    const scan = useBluetoothScan({
+        model: options.scanModel,
+        onError: options.onError,
+        timeoutMs: options.scanTimeoutMs,
+    });
+    const [action, setAction] = useState("idle");
+    const [defaultDevice, setDefaultDeviceState] = useState(null);
+    const [operationError, setOperationError] = useState(null);
+    const autoConnectAttemptedRef = useRef(false);
+    const defaultDeviceStorageRef = useRef(options.defaultDeviceStorage);
+    const onErrorRef = useRef(options.onError);
+    useEffect(() => {
+        defaultDeviceStorageRef.current = options.defaultDeviceStorage;
+        onErrorRef.current = options.onError;
+    }, [options.defaultDeviceStorage, options.onError]);
+    useEffect(() => {
+        let mounted = true;
+        const loadDefaultDevice = async () => {
+            try {
+                const [nativeDefaultDevice, storedDefaultDevice] = await Promise.all([
+                    BluetoothSdk.getDefaultDevice(),
+                    defaultDeviceStorageRef.current?.load() ?? Promise.resolve(null),
+                ]);
+                if (!mounted) {
+                    return;
+                }
+                const nextDefaultDevice = storedDefaultDevice ?? nativeDefaultDevice;
+                if (nextDefaultDevice) {
+                    await BluetoothSdk.setDefaultDevice(nextDefaultDevice);
+                }
+                if (mounted) {
+                    setDefaultDeviceState(nextDefaultDevice);
+                    setOperationError(null);
+                }
+            }
+            catch (nextError) {
+                if (!mounted) {
+                    return;
+                }
+                setOperationError(nextError);
+                onErrorRef.current?.(nextError);
+            }
+        };
+        void loadDefaultDevice();
+        return () => {
+            mounted = false;
+        };
+    }, []);
+    useEffect(() => {
+        if (!options.autoConnectDefault || autoConnectAttemptedRef.current || status.connected || !defaultDevice) {
+            return;
+        }
+        autoConnectAttemptedRef.current = true;
+        void connectDefault().catch(() => undefined);
+    }, [defaultDevice, options.autoConnectDefault, status.connected]);
+    async function runConnectionAction(nextAction, operation) {
+        setAction(nextAction);
+        setOperationError(null);
+        try {
+            const result = await operation();
+            setOperationError(null);
+            return result;
+        }
+        catch (nextError) {
+            setOperationError(nextError);
+            onErrorRef.current?.(nextError);
+            throw nextError;
+        }
+        finally {
+            setAction("idle");
+        }
+    }
+    async function setDefaultDevice(device) {
+        await runConnectionAction("connecting", async () => {
+            await BluetoothSdk.setDefaultDevice(device);
+            await defaultDeviceStorageRef.current?.save(device);
+            setDefaultDeviceState(device);
+        });
+    }
+    async function clearDefaultDevice() {
+        await runConnectionAction("forgetting", async () => {
+            await BluetoothSdk.clearDefaultDevice();
+            await defaultDeviceStorageRef.current?.save(null);
+            setDefaultDeviceState(null);
+            scan.selectDevice(null);
+        });
+    }
+    async function connect(device, connectOptions) {
+        await runConnectionAction("connecting", async () => {
+            const targetDevice = device ?? scan.selectedDevice;
+            if (targetDevice) {
+                await BluetoothSdk.connect(targetDevice, connectOptions);
+                if (connectOptions?.saveAsDefault !== false) {
+                    await defaultDeviceStorageRef.current?.save(targetDevice);
+                    setDefaultDeviceState(targetDevice);
+                }
+                return;
+            }
+            await BluetoothSdk.connectDefault(connectOptions);
+        });
+    }
+    async function connectDefault(connectOptions) {
+        await runConnectionAction("connecting", async () => {
+            await BluetoothSdk.connectDefault(connectOptions);
+        });
+    }
+    async function disconnect() {
+        await runConnectionAction("disconnecting", async () => {
+            await BluetoothSdk.disconnect();
+        });
+    }
+    async function forget() {
+        await runConnectionAction("forgetting", async () => {
+            await BluetoothSdk.forget();
+            scan.clearResults();
+        });
+    }
+    const busy = action !== "idle" || scan.scanning || status.loading;
+    return {
+        ...status,
+        action: scan.scanning ? "scanning" : action,
+        busy,
+        clearDefaultDevice,
+        connect,
+        connectDefault,
+        defaultDevice,
+        disconnect,
+        error: operationError ?? scan.error ?? status.error,
+        forget,
+        scan,
+        setDefaultDevice,
+    };
+}
+//# sourceMappingURL=useGlassesConnection.js.map

package/build/react/useGlassesConnection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGlassesConnection.js","sourceRoot":"","sources":["../../src/react/useGlassesConnection.ts"],"names":[],"mappings":"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","sourcesContent":["import {useEffect, useRef, useState} from \"react\"\n\nimport BluetoothSdk from \"../index\"\nimport type {ConnectOptions, Device, DeviceModel} from \"../BluetoothSdk.types\"\n\nimport {useBluetoothScan, type BluetoothScanHookResult} from \"./useBluetoothScan\"\nimport {useBluetoothStatus, type BluetoothStatusHookResult} from \"./useBluetoothStatus\"\n\nexport type DefaultDeviceStorage = {\n  load: () => Promise<Device | null>\n  save: (device: Device | null) => Promise<void>\n}\n\nexport type GlassesConnectionAction =\n  | \"idle\"\n  | \"scanning\"\n  | \"connecting\"\n  | \"disconnecting\"\n  | \"forgetting\"\n\nexport type UseGlassesConnectionOptions = {\n  autoConnectDefault?: boolean\n  defaultDeviceStorage?: DefaultDeviceStorage\n  onError?: (error: unknown) => void\n  scanModel?: DeviceModel\n  scanTimeoutMs?: number\n}\n\nexport type GlassesConnectionHookResult = BluetoothStatusHookResult & {\n  action: GlassesConnectionAction\n  busy: boolean\n  clearDefaultDevice: () => Promise<void>\n  connect: (device?: Device, options?: ConnectOptions) => Promise<void>\n  connectDefault: (options?: ConnectOptions) => Promise<void>\n  defaultDevice: Device | null\n  disconnect: () => Promise<void>\n  forget: () => Promise<void>\n  scan: BluetoothScanHookResult\n  setDefaultDevice: (device: Device | null) => Promise<void>\n}\n\nexport function useGlassesConnection(\n  options: UseGlassesConnectionOptions = {},\n): GlassesConnectionHookResult {\n  const status = useBluetoothStatus({onError: options.onError})\n  const scan = useBluetoothScan({\n    model: options.scanModel,\n    onError: options.onError,\n    timeoutMs: options.scanTimeoutMs,\n  })\n  const [action, setAction] = useState<GlassesConnectionAction>(\"idle\")\n  const [defaultDevice, setDefaultDeviceState] = useState<Device | null>(null)\n  const [operationError, setOperationError] = useState<unknown | null>(null)\n  const autoConnectAttemptedRef = useRef(false)\n  const defaultDeviceStorageRef = useRef(options.defaultDeviceStorage)\n  const onErrorRef = useRef(options.onError)\n\n  useEffect(() => {\n    defaultDeviceStorageRef.current = options.defaultDeviceStorage\n    onErrorRef.current = options.onError\n  }, [options.defaultDeviceStorage, options.onError])\n\n  useEffect(() => {\n    let mounted = true\n\n    const loadDefaultDevice = async () => {\n      try {\n        const [nativeDefaultDevice, storedDefaultDevice] = await Promise.all([\n          BluetoothSdk.getDefaultDevice(),\n          defaultDeviceStorageRef.current?.load() ?? Promise.resolve(null),\n        ])\n        if (!mounted) {\n          return\n        }\n        const nextDefaultDevice = storedDefaultDevice ?? nativeDefaultDevice\n        if (nextDefaultDevice) {\n          await BluetoothSdk.setDefaultDevice(nextDefaultDevice)\n        }\n        if (mounted) {\n          setDefaultDeviceState(nextDefaultDevice)\n          setOperationError(null)\n        }\n      } catch (nextError) {\n        if (!mounted) {\n          return\n        }\n        setOperationError(nextError)\n        onErrorRef.current?.(nextError)\n      }\n    }\n\n    void loadDefaultDevice()\n\n    return () => {\n      mounted = false\n    }\n  }, [])\n\n  useEffect(() => {\n    if (!options.autoConnectDefault || autoConnectAttemptedRef.current || status.connected || !defaultDevice) {\n      return\n    }\n\n    autoConnectAttemptedRef.current = true\n    void connectDefault().catch(() => undefined)\n  }, [defaultDevice, options.autoConnectDefault, status.connected])\n\n  async function runConnectionAction<T>(\n    nextAction: Exclude<GlassesConnectionAction, \"idle\" | \"scanning\">,\n    operation: () => Promise<T>,\n  ): Promise<T> {\n    setAction(nextAction)\n    setOperationError(null)\n    try {\n      const result = await operation()\n      setOperationError(null)\n      return result\n    } catch (nextError) {\n      setOperationError(nextError)\n      onErrorRef.current?.(nextError)\n      throw nextError\n    } finally {\n      setAction(\"idle\")\n    }\n  }\n\n  async function setDefaultDevice(device: Device | null) {\n    await runConnectionAction(\"connecting\", async () => {\n      await BluetoothSdk.setDefaultDevice(device)\n      await defaultDeviceStorageRef.current?.save(device)\n      setDefaultDeviceState(device)\n    })\n  }\n\n  async function clearDefaultDevice() {\n    await runConnectionAction(\"forgetting\", async () => {\n      await BluetoothSdk.clearDefaultDevice()\n      await defaultDeviceStorageRef.current?.save(null)\n      setDefaultDeviceState(null)\n      scan.selectDevice(null)\n    })\n  }\n\n  async function connect(device?: Device, connectOptions?: ConnectOptions) {\n    await runConnectionAction(\"connecting\", async () => {\n      const targetDevice = device ?? scan.selectedDevice\n      if (targetDevice) {\n        await BluetoothSdk.connect(targetDevice, connectOptions)\n        if (connectOptions?.saveAsDefault !== false) {\n          await defaultDeviceStorageRef.current?.save(targetDevice)\n          setDefaultDeviceState(targetDevice)\n        }\n        return\n      }\n      await BluetoothSdk.connectDefault(connectOptions)\n    })\n  }\n\n  async function connectDefault(connectOptions?: ConnectOptions) {\n    await runConnectionAction(\"connecting\", async () => {\n      await BluetoothSdk.connectDefault(connectOptions)\n    })\n  }\n\n  async function disconnect() {\n    await runConnectionAction(\"disconnecting\", async () => {\n      await BluetoothSdk.disconnect()\n    })\n  }\n\n  async function forget() {\n    await runConnectionAction(\"forgetting\", async () => {\n      await BluetoothSdk.forget()\n      scan.clearResults()\n    })\n  }\n\n  const busy = action !== \"idle\" || scan.scanning || status.loading\n\n  return {\n    ...status,\n    action: scan.scanning ? \"scanning\" : action,\n    busy,\n    clearDefaultDevice,\n    connect,\n    connectDefault,\n    defaultDevice,\n    disconnect,\n    error: operationError ?? scan.error ?? status.error,\n    forget,\n    scan,\n    setDefaultDevice,\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentra/bluetooth-sdk",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "SDK for communicating with smart glasses",
   "main": "build/index.js",
   "react-native": "src/index.ts",
@@ -12,10 +12,16 @@
       "react-native": "./src/index.ts",
       "default": "./build/index.js"
     },
+    "./react": {
+      "types": "./build/react/index.d.ts",
+      "react-native": "./src/react/index.ts",
+      "default": "./build/react/index.js"
+    },
     "./_private/*": null,
     "./build/*": null,
     "./src/*": null,
     "./app.plugin": "./app.plugin.js",
+    "./app.plugin.js": "./app.plugin.js",
     "./package.json": "./package.json"
   },
   "files": [

package/src/react/index.ts

@@ -0,0 +1,22 @@
+export {
+  useBluetoothEvent,
+  type UseBluetoothEventOptions,
+} from "./useBluetoothEvent"
+export {
+  useBluetoothScan,
+  type BluetoothScanDedupe,
+  type BluetoothScanHookResult,
+  type UseBluetoothScanOptions,
+} from "./useBluetoothScan"
+export {
+  useBluetoothStatus,
+  type BluetoothStatusHookResult,
+  type UseBluetoothStatusOptions,
+} from "./useBluetoothStatus"
+export {
+  useGlassesConnection,
+  type DefaultDeviceStorage,
+  type GlassesConnectionAction,
+  type GlassesConnectionHookResult,
+  type UseGlassesConnectionOptions,
+} from "./useGlassesConnection"

package/src/react/useBluetoothEvent.ts

@@ -0,0 +1,38 @@
+import {useEffect, useRef} from "react"
+
+import BluetoothSdk from "../index"
+import type {
+  BluetoothSdkEventListener,
+  BluetoothSdkEventName,
+} from "../BluetoothSdk.types"
+
+export type UseBluetoothEventOptions = {
+  enabled?: boolean
+}
+
+export function useBluetoothEvent<EventName extends BluetoothSdkEventName>(
+  eventName: EventName,
+  listener: BluetoothSdkEventListener<EventName>,
+  options: UseBluetoothEventOptions = {},
+): void {
+  const enabled = options.enabled ?? true
+  const listenerRef = useRef(listener)
+
+  useEffect(() => {
+    listenerRef.current = listener
+  }, [listener])
+
+  useEffect(() => {
+    if (!enabled) {
+      return undefined
+    }
+
+    const subscription = BluetoothSdk.addListener(eventName, (event) => {
+      listenerRef.current(event)
+    })
+
+    return () => {
+      subscription.remove()
+    }
+  }, [enabled, eventName])
+}

package/src/react/useBluetoothScan.ts

@@ -0,0 +1,173 @@
+import {useEffect, useRef, useState} from "react"
+
+import BluetoothSdk, {DeviceModels} from "../index"
+import type {Device, DeviceModel} from "../BluetoothSdk.types"
+
+export type BluetoothScanDedupe = "id" | "name" | ((device: Device) => string)
+
+export type UseBluetoothScanOptions = {
+  dedupe?: BluetoothScanDedupe
+  model?: DeviceModel
+  onError?: (error: unknown) => void
+  timeoutMs?: number
+}
+
+export type BluetoothScanHookResult = {
+  clearResults: () => void
+  devices: Device[]
+  error: unknown | null
+  model: DeviceModel
+  scanning: boolean
+  selectedDevice: Device | null
+  selectDevice: (device: Device | null) => void
+  setModel: (model: DeviceModel) => void
+  startScan: (model?: DeviceModel) => Promise<Device[]>
+  stopScan: () => Promise<void>
+}
+
+function dedupeKey(device: Device, dedupe: BluetoothScanDedupe): string {
+  if (typeof dedupe === "function") {
+    return dedupe(device)
+  }
+  if (dedupe === "name") {
+    return `${device.model}:${device.name}`
+  }
+  return device.id
+}
+
+function dedupeDevices(devices: Device[], dedupe: BluetoothScanDedupe): Device[] {
+  const seen = new Set<string>()
+  const nextDevices: Device[] = []
+
+  devices.forEach((device) => {
+    const key = dedupeKey(device, dedupe)
+    if (seen.has(key)) {
+      return
+    }
+    seen.add(key)
+    nextDevices.push(device)
+  })
+
+  return nextDevices
+}
+
+function hasDevice(devices: Device[], selectedDevice: Device | null, dedupe: BluetoothScanDedupe): boolean {
+  if (!selectedDevice) {
+    return true
+  }
+  const selectedKey = dedupeKey(selectedDevice, dedupe)
+  return devices.some((device) => dedupeKey(device, dedupe) === selectedKey)
+}
+
+export function useBluetoothScan(options: UseBluetoothScanOptions = {}): BluetoothScanHookResult {
+  const [devices, setDevices] = useState<Device[]>([])
+  const [error, setError] = useState<unknown | null>(null)
+  const [model, setModelState] = useState<DeviceModel>(options.model ?? DeviceModels.MentraLive)
+  const [scanning, setScanning] = useState(false)
+  const [selectedDevice, selectDevice] = useState<Device | null>(null)
+  const activeScanRef = useRef(0)
+  const dedupeRef = useRef<BluetoothScanDedupe>(options.dedupe ?? "id")
+  const onErrorRef = useRef(options.onError)
+  const scanningRef = useRef(false)
+  const timeoutMsRef = useRef(options.timeoutMs)
+
+  useEffect(() => {
+    dedupeRef.current = options.dedupe ?? "id"
+    onErrorRef.current = options.onError
+    timeoutMsRef.current = options.timeoutMs
+  }, [options.dedupe, options.onError, options.timeoutMs])
+
+  useEffect(() => {
+    scanningRef.current = scanning
+  }, [scanning])
+
+  useEffect(() => {
+    if (!hasDevice(devices, selectedDevice, dedupeRef.current)) {
+      selectDevice(null)
+    }
+  }, [devices, selectedDevice])
+
+  useEffect(() => {
+    return () => {
+      if (!scanningRef.current) {
+        return
+      }
+      activeScanRef.current += 1
+      void BluetoothSdk.stopScan().catch(() => undefined)
+    }
+  }, [])
+
+  function clearResults() {
+    setDevices([])
+    selectDevice(null)
+  }
+
+  function setModel(nextModel: DeviceModel) {
+    setModelState(nextModel)
+    clearResults()
+  }
+
+  async function startScan(nextModel?: DeviceModel): Promise<Device[]> {
+    const scanId = activeScanRef.current + 1
+    activeScanRef.current = scanId
+    const scanModel = nextModel ?? model
+    if (nextModel && nextModel !== model) {
+      setModelState(nextModel)
+    }
+
+    setError(null)
+    setScanning(true)
+    scanningRef.current = true
+    setDevices([])
+    selectDevice(null)
+
+    try {
+      const nextDevices = await BluetoothSdk.scan(scanModel, {
+        ...(timeoutMsRef.current == null ? {} : {timeoutMs: timeoutMsRef.current}),
+        onResults: (results) => {
+          if (activeScanRef.current !== scanId) {
+            return
+          }
+          setDevices(dedupeDevices(results, dedupeRef.current))
+        },
+      })
+      const finalDevices = dedupeDevices(nextDevices, dedupeRef.current)
+      if (activeScanRef.current === scanId) {
+        setDevices(finalDevices)
+        setError(null)
+      }
+      return finalDevices
+    } catch (nextError) {
+      if (activeScanRef.current === scanId) {
+        setError(nextError)
+        onErrorRef.current?.(nextError)
+      }
+      throw nextError
+    } finally {
+      if (activeScanRef.current === scanId) {
+        setScanning(false)
+        scanningRef.current = false
+      }
+    }
+  }
+
+  async function stopScan() {
+    activeScanRef.current += 1
+    setScanning(false)
+    scanningRef.current = false
+    await BluetoothSdk.stopScan()
+  }
+
+  return {
+    clearResults,
+    devices,
+    error,
+    model,
+    scanning,
+    selectedDevice,
+    selectDevice,
+    setModel,
+    startScan,
+    stopScan,
+  }
+}

package/src/react/useBluetoothStatus.ts

@@ -0,0 +1,180 @@
+import {useEffect, useRef, useState} from "react"
+
+import BluetoothSdk from "../index"
+import {
+  createDisconnectedGlassesStatus,
+  isConnectedGlassesConnectionStatus,
+  isReadyGlassesConnectionStatus,
+} from "../BluetoothSdk.types"
+import type {
+  BatteryStatusEvent,
+  HotspotStatus,
+  HotspotStatusChangeEvent,
+  PublicBluetoothStatus,
+  PublicGlassesStatus,
+  WifiStatus,
+  WifiStatusChangeEvent,
+} from "../BluetoothSdk.types"
+
+export type UseBluetoothStatusOptions = {
+  enabled?: boolean
+  onError?: (error: unknown) => void
+}
+
+export type BluetoothStatusHookResult = {
+  bluetoothStatus: Partial<PublicBluetoothStatus>
+  connected: boolean
+  error: unknown | null
+  glassesStatus: Partial<PublicGlassesStatus>
+  loading: boolean
+  ready: boolean
+  refresh: () => Promise<void>
+}
+
+function wifiStatusFromEvent(event: WifiStatusChangeEvent): WifiStatus {
+  switch (event.state) {
+    case "connected":
+      return {state: "connected", ssid: event.ssid, localIp: event.localIp}
+    case "disconnected":
+      return {state: "disconnected"}
+  }
+}
+
+function hotspotStatusFromEvent(event: HotspotStatusChangeEvent): HotspotStatus {
+  if (event.state === "enabled") {
+    return {
+      state: "enabled",
+      ssid: event.ssid,
+      password: event.password,
+      localIp: event.localIp,
+    }
+  }
+  return {state: event.state}
+}
+
+function mergeGlassesStatus(
+  current: Partial<PublicGlassesStatus>,
+  changed: Partial<PublicGlassesStatus>,
+): Partial<PublicGlassesStatus> {
+  if (changed.connection?.state === "disconnected") {
+    return {...createDisconnectedGlassesStatus(), ...changed}
+  }
+  return {...current, ...changed}
+}
+
+export function useBluetoothStatus(options: UseBluetoothStatusOptions = {}): BluetoothStatusHookResult {
+  const enabled = options.enabled ?? true
+  const onErrorRef = useRef(options.onError)
+  const [bluetoothStatus, setBluetoothStatus] = useState<Partial<PublicBluetoothStatus>>({})
+  const [error, setError] = useState<unknown | null>(null)
+  const [glassesStatus, setGlassesStatus] = useState<Partial<PublicGlassesStatus>>(() =>
+    createDisconnectedGlassesStatus(),
+  )
+  const [loading, setLoading] = useState(enabled)
+
+  useEffect(() => {
+    onErrorRef.current = options.onError
+  }, [options.onError])
+
+  async function refresh() {
+    setLoading(true)
+    try {
+      const [nextGlassesStatus, nextBluetoothStatus] = await Promise.all([
+        BluetoothSdk.getGlassesStatus(),
+        BluetoothSdk.getBluetoothStatus(),
+      ])
+      setGlassesStatus(nextGlassesStatus)
+      setBluetoothStatus(nextBluetoothStatus)
+      setError(null)
+    } catch (nextError) {
+      setError(nextError)
+      onErrorRef.current?.(nextError)
+    } finally {
+      setLoading(false)
+    }
+  }
+
+  useEffect(() => {
+    if (!enabled) {
+      setLoading(false)
+      return undefined
+    }
+
+    let mounted = true
+
+    const loadInitialStatus = async () => {
+      setLoading(true)
+      try {
+        const [nextGlassesStatus, nextBluetoothStatus] = await Promise.all([
+          BluetoothSdk.getGlassesStatus(),
+          BluetoothSdk.getBluetoothStatus(),
+        ])
+        if (!mounted) {
+          return
+        }
+        setGlassesStatus(nextGlassesStatus)
+        setBluetoothStatus(nextBluetoothStatus)
+        setError(null)
+      } catch (nextError) {
+        if (!mounted) {
+          return
+        }
+        setError(nextError)
+        onErrorRef.current?.(nextError)
+      } finally {
+        if (mounted) {
+          setLoading(false)
+        }
+      }
+    }
+
+    void loadInitialStatus()
+
+    const removeGlasses = BluetoothSdk.onGlassesStatus((changed) => {
+      setGlassesStatus((current) => mergeGlassesStatus(current, changed))
+    })
+    const removeBluetooth = BluetoothSdk.onBluetoothStatus((changed) => {
+      setBluetoothStatus((current) => ({...current, ...changed}))
+    })
+    const batterySubscription = BluetoothSdk.addListener("battery_status", (event: BatteryStatusEvent) => {
+      setGlassesStatus((current) => ({
+        ...current,
+        batteryLevel: event.level,
+        charging: event.charging,
+      }))
+    })
+    const wifiSubscription = BluetoothSdk.addListener("wifi_status_change", (event) => {
+      setGlassesStatus((current) => ({...current, wifi: wifiStatusFromEvent(event)}))
+    })
+    const hotspotSubscription = BluetoothSdk.addListener("hotspot_status_change", (event) => {
+      setGlassesStatus((current) => ({...current, hotspot: hotspotStatusFromEvent(event)}))
+    })
+    const hotspotErrorSubscription = BluetoothSdk.addListener("hotspot_error", () => {
+      setGlassesStatus((current) => ({...current, hotspot: {state: "disabled"}}))
+    })
+
+    return () => {
+      mounted = false
+      removeGlasses()
+      removeBluetooth()
+      batterySubscription.remove()
+      wifiSubscription.remove()
+      hotspotSubscription.remove()
+      hotspotErrorSubscription.remove()
+    }
+  }, [enabled])
+
+  const connection = glassesStatus.connection
+  const connected = connection ? isConnectedGlassesConnectionStatus(connection) : false
+  const ready = connection ? isReadyGlassesConnectionStatus(connection) : false
+
+  return {
+    bluetoothStatus,
+    connected,
+    error,
+    glassesStatus,
+    loading,
+    ready,
+    refresh,
+  }
+}