@mentra/bluetooth-sdk 0.1.0

package/ios/Source/ObservableStore.swift

@@ -0,0 +1,88 @@
+//
+//  ObservableStore.swift
+//  BluetoothSdk
+//
+//  Observable state management with immediate event emission
+//
+
+import Foundation
+
+@MainActor
+class ObservableStore {
+    private nonisolated(unsafe) var values: [String: Any] = [:]
+    private var onEmit: ((String, [String: Any]) -> Void)?
+    private var listeners: [String: (String, [String: Any]) -> Void] = [:]
+
+    nonisolated static let bluetoothCategory = "bluetooth"
+    private nonisolated static let legacyCoreCategory = "core"
+
+    nonisolated static func normalizeCategory(_ category: String) -> String {
+        category == legacyCoreCategory ? bluetoothCategory : category
+    }
+
+    func configure(onEmit: @escaping (String, [String: Any]) -> Void) {
+        self.onEmit = onEmit
+    }
+
+    func addListener(_ listener: @escaping (String, [String: Any]) -> Void) -> String {
+        let id = UUID().uuidString
+        listeners[id] = listener
+        return id
+    }
+
+    func removeListener(_ id: String) {
+        listeners.removeValue(forKey: id)
+    }
+
+    func set(_ category: String, _ key: String, _ value: Any) {
+        let normalizedCategory = Self.normalizeCategory(category)
+        let fullKey = "\(normalizedCategory).\(key)"
+        let oldValue = values[fullKey]
+
+        // Skip if unchanged
+        if let old = oldValue, areEqual(old, value) {
+            return
+        }
+
+        values[fullKey] = value
+
+        // Emit immediately
+        let changes = [key: value]
+        onEmit?(normalizedCategory, changes)
+        for listener in Array(listeners.values) {
+            listener(normalizedCategory, changes)
+        }
+    }
+
+    nonisolated func get(_ category: String, _ key: String) -> Any? {
+        values["\(Self.normalizeCategory(category)).\(key)"]
+    }
+
+    func getCategory(_ category: String) -> [String: Any] {
+        var result: [String: Any] = [:]
+        let prefix = "\(Self.normalizeCategory(category))."
+        for (key, value) in values where key.hasPrefix(prefix) {
+            let shortKey = String(key.dropFirst(prefix.count))
+            result[shortKey] = value
+        }
+        return result
+    }
+
+    /// Helper to compare values
+    private func areEqual(_ lhs: Any, _ rhs: Any) -> Bool {
+        if let l = lhs as? String, let r = rhs as? String { return l == r }
+        if let l = lhs as? Int, let r = rhs as? Int { return l == r }
+        if let l = lhs as? Bool, let r = rhs as? Bool { return l == r }
+        if let l = lhs as? Double, let r = rhs as? Double { return l == r }
+        if let l = lhs as? [String], let r = rhs as? [String] { return l == r }
+        if let l = lhs as? [[String: Any]], let r = rhs as? [[String: Any]] {
+            return toJson(l) == toJson(r)
+        }
+        return false
+    }
+
+    private func toJson(_ value: Any) -> String? {
+        guard let data = try? JSONSerialization.data(withJSONObject: value) else { return nil }
+        return String(data: data, encoding: .utf8)
+    }
+}

package/ios/Source/PrivacyInfo.xcprivacy

@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>NSPrivacyTracking</key>
+  <false/>
+  <key>NSPrivacyCollectedDataTypes</key>
+  <array/>
+  <key>NSPrivacyTrackingDomains</key>
+  <array/>
+  <key>NSPrivacyAccessedAPITypes</key>
+  <array>
+    <dict>
+      <key>NSPrivacyAccessedAPIType</key>
+      <string>NSPrivacyAccessedAPICategoryUserDefaults</string>
+      <key>NSPrivacyAccessedAPITypeReasons</key>
+      <array>
+        <string>CA92.1</string>
+      </array>
+    </dict>
+  </array>
+</dict>
+</plist>

package/ios/Source/controllers/ControllerManager.swift

@@ -0,0 +1,187 @@
+import Foundation
+
+@MainActor
+protocol ControllerManager {
+    // MARK: - hard coded device properties:
+
+    var type: String { get set }
+    var hasMic: Bool { get }
+
+    // MARK: - Audio Control
+
+    func setMicEnabled(_ enabled: Bool)
+    func sortMicRanking(list: [String]) -> [String]
+
+    // MARK: - Messaging
+
+    func sendJson(_ jsonOriginal: [String: Any], wakeUp: Bool, requireAck: Bool)
+
+    // MARK: - Camera & Media
+
+    func requestPhoto(
+        _ requestId: String, appId: String, size: String?, webhookUrl: String?, authToken: String?,
+        compress: String?, flash: Bool, sound: Bool
+    )
+    func startStream(_ message: [String: Any])
+    func stopStream()
+    func sendStreamKeepAlive(_ message: [String: Any])
+    func startVideoRecording(requestId: String, save: Bool, flash: Bool, sound: Bool)
+    func stopVideoRecording(requestId: String)
+
+    // MARK: - Button Settings
+
+    func sendButtonPhotoSettings()
+    func sendButtonVideoRecordingSettings()
+    func sendButtonMaxRecordingTime()
+    func sendButtonCameraLedSetting()
+
+    // MARK: - Display Control
+
+    func setBrightness(_ level: Int, autoMode: Bool)
+    func clearDisplay()
+    func sendTextWall(_ text: String)
+    func sendDoubleTextWall(_ top: String, _ bottom: String)
+    func displayBitmap(base64ImageData: String) async -> Bool
+    func showDashboard()
+    func setDashboardPosition(_ height: Int, _ depth: Int)
+
+    // MARK: - Device Control
+
+    func setHeadUpAngle(_ angle: Int)
+    func getBatteryStatus()
+    func setSilentMode(_ enabled: Bool)
+    func exit()
+    func sendShutdown()
+    func sendReboot()
+    func sendRgbLedControl(
+        requestId: String, packageName: String?, action: String, color: String?, ontime: Int,
+        offtime: Int, count: Int
+    )
+
+    // MARK: - Connection Management
+
+    func disconnect()
+    func forget()
+    func findCompatibleDevices()
+    func stopScan()
+    func connectById(_ id: String)
+    func getConnectedBluetoothName() -> String?
+    func cleanup()
+    func ping()
+
+    // MARK: - Network Management
+
+    func requestWifiScan()
+    func sendWifiCredentials(_ ssid: String, _ password: String)
+    func forgetWifiNetwork(_ ssid: String)
+    func sendHotspotState(_ enabled: Bool)
+    func sendOtaStart()
+    func sendOtaQueryStatus()
+
+    // MARK: - User Context (for crash reporting)
+
+    func sendUserEmailToGlasses(_ email: String)
+
+    // MARK: - Incident Reporting
+
+    func sendIncidentId(_ incidentId: String, apiBaseUrl: String?)
+
+    // MARK: - Gallery
+
+    func queryGalleryStatus()
+    func sendGalleryMode()
+
+    // MARK: - Version Info
+
+    func requestVersionInfo()
+}
+
+/// doesn't seem to work for concurrency reasons :(
+/// we can make read-only getters for convienence though:
+extension ControllerManager {
+    // MARK: - Default DeviceStore-backed property implementations
+
+    var fullyBooted: Bool {
+        DeviceStore.shared.get("glasses", "fullyBooted") as? Bool ?? false
+    }
+
+    var connected: Bool {
+        DeviceStore.shared.get("glasses", "connected") as? Bool ?? false
+    }
+
+    var appVersion: String {
+        DeviceStore.shared.get("glasses", "appVersion") as? String ?? ""
+    }
+
+    var buildNumber: String {
+        DeviceStore.shared.get("glasses", "buildNumber") as? String ?? ""
+    }
+
+    var deviceModel: String {
+        DeviceStore.shared.get("glasses", "deviceModel") as? String ?? ""
+    }
+
+    var androidVersion: String {
+        DeviceStore.shared.get("glasses", "androidVersion") as? String ?? ""
+    }
+
+    var otaVersionUrl: String {
+        DeviceStore.shared.get("glasses", "otaVersionUrl") as? String ?? ""
+    }
+
+    var firmwareVersion: String {
+        DeviceStore.shared.get("glasses", "fwVersion") as? String ?? ""
+    }
+
+    var btMacAddress: String {
+        DeviceStore.shared.get("glasses", "btMacAddress") as? String ?? ""
+    }
+
+    var serialNumber: String {
+        DeviceStore.shared.get("glasses", "serialNumber") as? String ?? ""
+    }
+
+    var style: String {
+        DeviceStore.shared.get("glasses", "style") as? String ?? ""
+    }
+
+    var color: String {
+        DeviceStore.shared.get("glasses", "color") as? String ?? ""
+    }
+
+    var micEnabled: Bool {
+        DeviceStore.shared.get("glasses", "micEnabled") as? Bool ?? false
+    }
+
+    var vadEnabled: Bool {
+        DeviceStore.shared.get("glasses", "vadEnabled") as? Bool ?? false
+    }
+
+    var batteryLevel: Int {
+        DeviceStore.shared.get("glasses", "batteryLevel") as? Int ?? -1
+    }
+
+    var headUp: Bool {
+        DeviceStore.shared.get("glasses", "headUp") as? Bool ?? false
+    }
+
+    var charging: Bool {
+        DeviceStore.shared.get("glasses", "charging") as? Bool ?? false
+    }
+
+    var caseOpen: Bool {
+        DeviceStore.shared.get("glasses", "caseOpen") as? Bool ?? true
+    }
+
+    var caseRemoved: Bool {
+        DeviceStore.shared.get("glasses", "caseRemoved") as? Bool ?? true
+    }
+
+    var caseCharging: Bool {
+        DeviceStore.shared.get("glasses", "caseCharging") as? Bool ?? false
+    }
+
+    var caseBatteryLevel: Int {
+        DeviceStore.shared.get("glasses", "caseBatteryLevel") as? Int ?? -1
+    }
+}