@mentra/bluetooth-sdk 0.1.6 → 0.1.8

package/ios/Source/sgcs/MentraLive.swift

@@ -768,9 +768,12 @@ extension MentraLive: CBPeripheralDelegate {
             // Keep state as connecting until glasses are ready
             updateConnectionState(ConnTypes.CONNECTING)
 
-            // Request MTU size
-            let mtuSize = peripheral.maximumWriteValueLength(for: .withResponse)
-            Bridge.log("LIVE: Current MTU size: \(mtuSize + 3) bytes")
+            let withResponseMtu = peripheral.maximumWriteValueLength(for: .withResponse) + 3
+            let withoutResponseMtu = peripheral.maximumWriteValueLength(for: .withoutResponse) + 3
+            currentMtu = max(23, min(withResponseMtu, withoutResponseMtu))
+            Bridge.log(
+                "LIVE: Current MTU estimate: withResponse=\(withResponseMtu), withoutResponse=\(withoutResponseMtu), selected=\(currentMtu)"
+            )
 
             // Enable notifications on RX characteristic
             peripheral.setNotifyValue(true, for: rx)
@@ -903,6 +906,7 @@ class MentraLive: NSObject, SGCManager {
     // BLOCK_AUDIO_DUPLEX: When true, suspends LC3 mic while phone is playing audio via A2DP
     // to avoid overloading the MCU. Set to false to allow simultaneous A2DP + LC3 mic.
     private let BLOCK_AUDIO_DUPLEX = false
+    private static let voiceActivityDetectionSwitchType = 8
 
     var connectionState: String = ConnTypes.DISCONNECTED
 
@@ -1071,6 +1075,7 @@ class MentraLive: NSObject, SGCManager {
     private var connectedPeripheral: CBPeripheral?
     private var txCharacteristic: CBCharacteristic?
     private var rxCharacteristic: CBCharacteristic?
+    private let bes2700MtuLimit = 256
     private var currentMtu: Int = 23 // Default BLE MTU
 
     // State Tracking
@@ -1095,6 +1100,7 @@ class MentraLive: NSObject, SGCManager {
     // Queue Management
     private let commandQueue = CommandQueue()
     private let bluetoothQueue = DispatchQueue(label: "MentraLiveBluetooth", qos: .userInitiated)
+    private let incomingChunkReassembler = MessageChunkReassembler()
     private var lastSendTimeMs: TimeInterval = 0
 
     // Timers
@@ -1311,9 +1317,11 @@ class MentraLive: NSObject, SGCManager {
 
     func requestPhoto(
         _ requestId: String, appId: String, size: String?, webhookUrl: String?, authToken: String?,
-        compress: String?, flash: Bool, sound: Bool
+        compress: String?, flash: Bool, sound: Bool, exposureTimeNs: Double?, iso: Int?
     ) {
-        Bridge.log("Requesting photo: \(requestId) for app: \(appId), flash: \(flash), sound: \(sound)")
+        Bridge.log(
+            "LIVE: PHOTO PIPELINE [5/6] requestPhoto() entry requestId=\(requestId) appId=\(appId) flash=\(flash) sound=\(sound) iso=\(iso.map { String($0) } ?? "auto")"
+        )
 
         var json: [String: Any] = [
             "type": "take_photo",
@@ -1360,7 +1368,17 @@ class MentraLive: NSObject, SGCManager {
         json["flash"] = flash
         json["sound"] = sound
 
-        Bridge.log("Using auto transfer mode with BLE fallback ID: \(bleImgId)")
+        if let e = exposureTimeNs, e.isFinite, e > 0, e <= Double(Int64.max) {
+            Bridge.log("LIVE: Using manual exposure time for photo request \(requestId): \(Int64(e)) ns")
+            json["exposureTimeNs"] = Int64(e)
+        }
+        if let iso, iso > 0 {
+            Bridge.log("LIVE: Using manual ISO for photo request \(requestId): ISO \(iso)")
+            json["iso"] = iso
+        }
+
+        Bridge.log("LIVE: PHOTO PIPELINE [5b/6] take_photo JSON ready bleImgId=\(bleImgId) transferMethod=auto")
+        Bridge.log("LIVE: PHOTO PIPELINE [6/6] Dispatching take_photo to sendJson()")
 
         sendJson(json, wakeUp: true)
     }
@@ -1768,6 +1786,11 @@ class MentraLive: NSObject, SGCManager {
         // Log ALL incoming JSON objects for debugging
         // Bridge.log("LIVE: DEBUG: processJsonObject: \(json)")
 
+        if MessageChunker.isChunkedMessage(json) {
+            processChunkedJsonObject(json)
+            return
+        }
+
         // Check for K900 command format
         if let command = json["C"] as? String {
             processK900JsonMessage(json)
@@ -1814,6 +1837,14 @@ class MentraLive: NSObject, SGCManager {
             let isCharging = json["charging"] as? Bool ?? charging
             updateBatteryStatus(level: level, isCharging: isCharging)
 
+        case "voice_activity_detection_status":
+            let enabled = json["voiceActivityDetectionEnabled"] as? Bool ?? true
+            handleVoiceActivityDetectionStatus(enabled: enabled)
+
+        case "speaking_status":
+            let speaking = json["speaking"] as? Bool ?? false
+            handleSpeakingStatus(speaking: speaking)
+
         case "wifi_status":
             let connected = json["connected"] as? Bool ?? false
             let ssid = json["ssid"] as? String ?? ""
@@ -1839,6 +1870,9 @@ class MentraLive: NSObject, SGCManager {
         case "stream_status":
             emitRtmpStreamStatus(json)
 
+        case "photo_status":
+            emitPhotoStatus(json)
+
         case "gallery_status":
             let photoCount = json["photos"] as? Int ?? 0
             let videoCount = json["videos"] as? Int ?? 0
@@ -1893,9 +1927,7 @@ class MentraLive: NSObject, SGCManager {
             let switchType = (json["switch_type"] as? Int) ?? (json["switchType"] as? Int) ?? -1
             let switchValue = (json["switch_value"] as? Int) ?? (json["switchValue"] as? Int) ?? -1
             let timestamp = parseTimestamp(json["timestamp"])
-            Bridge.sendSwitchStatus(
-                switchType: switchType, value: switchValue, timestamp: timestamp
-            )
+            handleSwitchStatus(switchType: switchType, value: switchValue, timestamp: timestamp)
 
         case "rgb_led_control_response":
             let requestId = json["requestId"] as? String ?? ""
@@ -2087,6 +2119,9 @@ class MentraLive: NSObject, SGCManager {
                     // Note: Stored separately from BES version for OTA patch matching
                     DeviceStore.shared.apply("glasses", "mtkFirmwareVersion", mtkFirmwareVersion)
                 }
+                if let systemTimeMs = fields["system_time_ms"] as? NSNumber {
+                    DeviceStore.shared.apply("glasses", "systemTimeMs", systemTimeMs.int64Value)
+                }
                 if let bluetoothMacAddress = fields["bt_mac_address"] as? String {
                     DeviceStore.shared.apply("glasses", "bluetoothMacAddress", bluetoothMacAddress)
                 }
@@ -2102,6 +2137,26 @@ class MentraLive: NSObject, SGCManager {
         }
     }
 
+    private func processChunkedJsonObject(_ json: [String: Any]) {
+        guard let info = MessageChunker.getChunkInfo(json) else {
+            Bridge.log("LIVE: Received malformed chunked message from glasses")
+            return
+        }
+
+        guard let reassembled = incomingChunkReassembler.addChunk(info) else {
+            return
+        }
+
+        guard let data = reassembled.data(using: .utf8),
+              let reassembledJson = try? JSONSerialization.jsonObject(with: data) as? [String: Any]
+        else {
+            Bridge.log("LIVE: Failed to parse reassembled chunked message")
+            return
+        }
+
+        processJsonObject(reassembledJson)
+    }
+
     /// Maps K900 gesture type codes to gesture names
     /// Compute the weighted overall OTA percentage for a BES progress event arriving via sr_adota.
     /// Mirrors the weight table in OtaSessionManager.computeStepWeights() on the glasses side.
@@ -2241,6 +2296,25 @@ class MentraLive: NSObject, SGCManager {
         case "sr_vol":
             handleSrVol(json)
 
+        case "sr_vad":
+            if let bodyObj = k900ParseBody(json["B"]),
+               let on = k900JsonInt(bodyObj, "on"),
+               on == 0 || on == 1
+            {
+                handleSpeakingStatus(speaking: on == 1)
+            }
+
+        case "sr_swit":
+            if let body = k900ParseBody(json["B"]) {
+                let switchType = k900JsonInt(body, "type") ?? -1
+                let switchValue = k900JsonInt(body, "switch") ?? -1
+                handleSwitchStatus(
+                    switchType: switchType,
+                    value: switchValue,
+                    timestamp: Int64(Date().timeIntervalSince1970 * 1000)
+                )
+            }
+
         case "sr_shut":
             Bridge.log("K900 shutdown command received - glasses shutting down")
             // Mark as killed to prevent reconnection attempts
@@ -2461,7 +2535,7 @@ class MentraLive: NSObject, SGCManager {
     }
 
     func sendGalleryMode() {
-        let active = DeviceStore.shared.get("bluetooth", "galleryModeAuto") as! Bool
+        let active = DeviceStore.shared.get("bluetooth", "gallery_mode") as! Bool
         Bridge.log("LIVE: 📸 Sending gallery mode active to glasses: \(active)")
 
         let json: [String: Any] = [
@@ -2515,6 +2589,7 @@ class MentraLive: NSObject, SGCManager {
         Bridge.log("LIVE: 🎉 Received glasses_ready message - SOC is booted and ready!")
 
         stopReadinessCheckLoop()
+        sendBleMtuConfig()
 
         // Invalidate any version fields from a prior link session so the next version_info
         // cannot leave a stale build number in RN (ASG is source of truth for PackageInfo).
@@ -2656,7 +2731,7 @@ class MentraLive: NSObject, SGCManager {
         //     return
         // }
 
-        // // Forward PCM data to DeviceManager for VAD and server transmission (same as Android)
+        // // Forward PCM data to DeviceManager for audio events and server transmission (same as Android)
         // DeviceManager.shared.handlePcm(pcmData)
 
         // Bridge.log(
@@ -2762,8 +2837,12 @@ class MentraLive: NSObject, SGCManager {
         activeFileTransfers.removeValue(forKey: fileName)
 
         let bleImgId = fileName.split(separator: ".").first.map(String.init) ?? ""
-        if blePhotoTransfers.removeValue(forKey: bleImgId) != nil {
+        if let transfer = blePhotoTransfers.removeValue(forKey: bleImgId) {
             Bridge.log("LIVE: 🧹 Cleaned up timed out BLE photo transfer for: \(bleImgId)")
+            Bridge.sendPhotoError(
+                requestId: transfer.requestId, errorCode: "TRANSFER_TIMEOUT",
+                errorMessage: "Transfer timed out for: \(fileName)"
+            )
         }
         if bleIncidentLogRelays.removeValue(forKey: bleImgId) != nil {
             Bridge.log("LIVE: 🧹 Cleaned up timed out BLE incident log relay for: \(bleImgId)")
@@ -2785,8 +2864,11 @@ class MentraLive: NSObject, SGCManager {
         }
 
         Bridge.log("LIVE: ❌ Transfer failed for: \(fileName) (reason: \(reason))")
+        let bleImgId = fileName.split(separator: ".").first.map(String.init) ?? ""
+        let transfer = blePhotoTransfers[bleImgId]
+        let effectiveRequestId = requestId.isEmpty ? transfer?.requestId ?? "" : requestId
         Bridge.sendPhotoError(
-            requestId: requestId, errorCode: "TRANSFER_FAILED",
+            requestId: effectiveRequestId, errorCode: "TRANSFER_FAILED",
             errorMessage: "Transfer failed for: \(fileName) (reason: \(reason))"
         )
 
@@ -2796,7 +2878,6 @@ class MentraLive: NSObject, SGCManager {
             )
         }
 
-        let bleImgId = fileName.split(separator: ".").first.map(String.init) ?? ""
         if let transfer = blePhotoTransfers.removeValue(forKey: bleImgId) {
             Bridge.log(
                 "LIVE: 🧹 Cleaned up failed BLE photo transfer for: \(bleImgId) (requestId: \(transfer.requestId))"
@@ -2933,11 +3014,13 @@ class MentraLive: NSObject, SGCManager {
                             )
                             Bridge.log("❌ Telling glasses to retry entire transfer")
 
-                            // Tell glasses transfer failed, they will retry
+                            // Tell glasses transfer failed, they will retry. Keep the photo
+                            // transfer entry so the retry maps back to the original requestId.
                             sendTransferCompleteConfirmation(
                                 fileName: packetInfo.fileName, success: false
                             )
-                            blePhotoTransfers.removeValue(forKey: bleImgId)
+                            photoTransfer.session = nil
+                            blePhotoTransfers[bleImgId] = photoTransfer
                         }
                     }
                 }
@@ -3170,6 +3253,20 @@ class MentraLive: NSObject, SGCManager {
         )
     }
 
+    private func sendBleMtuConfig() {
+        let effectiveMtu = min(currentMtu, bes2700MtuLimit)
+        let json: [String: Any] = [
+            "type": "set_ble_mtu",
+            "mtu": effectiveMtu,
+            "timestamp": Int64(Date().timeIntervalSince1970 * 1000),
+        ]
+
+        sendJson(json)
+        Bridge.log(
+            "LIVE: Sent BLE MTU config to glasses: negotiated=\(currentMtu), BES2700 limit=\(bes2700MtuLimit), effective=\(effectiveMtu)"
+        )
+    }
+
     // MARK: - Sending Data
 
     func queueSend(_ data: Data, id: String) {
@@ -3237,6 +3334,9 @@ class MentraLive: NSObject, SGCManager {
                     Bridge.log("LIVE: All chunks queued for transmission")
                 } else {
                     // Normal single message transmission
+                    if (json["type"] as? String) == "take_photo" {
+                        Bridge.log("LIVE: PHOTO PIPELINE BLE handoff — sendJson -> queueSend take_photo")
+                    }
                     Bridge.log("LIVE: Sending data to glasses: \(jsonString)")
                     let packedData = packJson(jsonString, wakeUp: wakeUp) ?? Data()
                     queueSend(packedData, id: trackingId)
@@ -3508,6 +3608,27 @@ class MentraLive: NSObject, SGCManager {
         }
     }
 
+    private func handleVoiceActivityDetectionStatus(enabled: Bool) {
+        Bridge.log("LIVE: Voice Activity Detection \(enabled ? "enabled" : "disabled")")
+        Bridge.sendVoiceActivityDetectionStatus(enabled)
+    }
+
+    private func handleSpeakingStatus(speaking: Bool) {
+        guard voiceActivityDetectionEnabled else {
+            Bridge.log("LIVE: Ignoring speaking status because Voice Activity Detection is disabled")
+            return
+        }
+        Bridge.log("LIVE: Speaking status \(speaking ? "speaking" : "not speaking")")
+        Bridge.sendSpeakingStatus(speaking)
+    }
+
+    private func handleSwitchStatus(switchType: Int, value: Int, timestamp: Int64) {
+        Bridge.sendSwitchStatus(switchType: switchType, value: value, timestamp: timestamp)
+        if switchType == Self.voiceActivityDetectionSwitchType, value == 0 || value == 1 {
+            handleVoiceActivityDetectionStatus(enabled: value == 1)
+        }
+    }
+
     private func updateWifiStatus(connected: Bool, ssid: String, ip: String) {
         Bridge.log("LIVE: 🌐 Updating WiFi status - connected: \(connected), ssid: \(ssid)")
         DeviceStore.shared.apply("glasses", "wifiConnected", connected)
@@ -3796,6 +3917,10 @@ class MentraLive: NSObject, SGCManager {
         Bridge.sendTypedMessage("stream_status", body: json)
     }
 
+    private func emitPhotoStatus(_ json: [String: Any]) {
+        Bridge.sendPhotoStatus(json)
+    }
+
     private func emitButtonPress(buttonId: String, pressType: String, timestamp: Int64) {
         let eventBody: [String: Any] = [
             "device_model": "Mentra Live",
@@ -4493,6 +4618,42 @@ extension MentraLive {
 
         // Send gallery mode state (camera app running status)
         sendGalleryMode()
+
+        // Send glasses-side Voice Activity Detection setting.
+        sendVoiceActivityDetectionSetting()
+    }
+
+    func sendVoiceActivityDetectionSetting() {
+        let enabled = DeviceStore.shared.get("bluetooth", "voice_activity_detection_enabled") as? Bool ?? true
+        Bridge.log("LIVE: 🎤 Sending Voice Activity Detection setting to glasses: \(enabled)")
+
+        guard connectedPeripheral != nil, txCharacteristic != nil else {
+            Bridge.log("Cannot send Voice Activity Detection setting - BLE write path not ready")
+            return
+        }
+
+        do {
+            let bodyData = try JSONSerialization.data(withJSONObject: [
+                "type": Self.voiceActivityDetectionSwitchType,
+                "switch": enabled ? 1 : 0,
+            ])
+            guard let bodyString = String(data: bodyData, encoding: .utf8) else {
+                Bridge.log("LIVE: Failed to encode Voice Activity Detection payload")
+                return
+            }
+            let command: [String: Any] = [
+                "C": "cs_swit",
+                "V": 1,
+                "B": bodyString,
+            ]
+            if sendRawK900Command(command, wakeUp: true) {
+                Bridge.sendVoiceActivityDetectionStatus(enabled)
+            } else {
+                Bridge.log("LIVE: Failed to send Voice Activity Detection setting command")
+            }
+        } catch {
+            Bridge.log("LIVE: Error encoding Voice Activity Detection payload: \(error)")
+        }
     }
 
     func sendButtonVideoRecordingSettings() {
@@ -4500,11 +4661,11 @@ extension MentraLive {
             DeviceStore.shared.get("bluetooth", "button_video_settings") as? [String: Any] ?? [
                 "width": 1280,
                 "height": 720,
-                "frameRate": 30,
+                "fps": 30,
             ]
         let width = settings["width"] as? Int ?? 1280
         let height = settings["height"] as? Int ?? 720
-        let fps = settings["frameRate"] as? Int ?? 30
+        let fps = settings["fps"] as? Int ?? 30
 
         // Use defaults if not set
         let finalWidth = width > 0 ? width : 1280
@@ -4582,9 +4743,9 @@ extension MentraLive {
     }
 
     func sendCameraFovSetting() {
-        let settings = DeviceStore.shared.get("bluetooth", "camera_fov") as? [String: Any] ?? ["fov": 118, "roiPosition": 0]
+        let settings = DeviceStore.shared.get("bluetooth", "camera_fov") as? [String: Any] ?? ["fov": 118, "roi_position": 0]
         let fov = settings["fov"] as? Int ?? 118
-        let roiPosition = settings["roiPosition"] as? Int ?? 0
+        let roiPosition = settings["roi_position"] as? Int ?? 0
 
         Bridge.log("Sending camera FOV setting: fov=\(fov), roiPosition=\(roiPosition)")
 
@@ -4642,7 +4803,7 @@ extension MentraLive {
 
         var json: [String: Any] = [
             "type": "start_video_recording",
-            "request_id": requestId,
+            "requestId": requestId,
             "save": save,
             "flash": flash,
             "sound": sound,
@@ -4669,7 +4830,7 @@ extension MentraLive {
 
         let json: [String: Any] = [
             "type": "stop_video_recording",
-            "request_id": requestId,
+            "requestId": requestId,
         ]
         sendJson(json)
     }

package/ios/Source/sgcs/MentraNex.swift

@@ -46,7 +46,7 @@ class MentraNexSGC: NSObject, CBCentralManagerDelegate, CBPeripheralDelegate, SG
 
     func requestPhoto(
         _: String, appId _: String, size _: String?, webhookUrl _: String?, authToken _: String?,
-        compress _: String?, flash _: Bool, sound _: Bool
+        compress _: String?, flash _: Bool, sound _: Bool, exposureTimeNs _: Double?, iso _: Int?
     ) {}
 
     func startStream(_: [String: Any]) {}

package/ios/Source/sgcs/SGCManager.swift

@@ -20,7 +20,7 @@ protocol SGCManager {
 
     func requestPhoto(
         _ requestId: String, appId: String, size: String?, webhookUrl: String?, authToken: String?,
-        compress: String?, flash: Bool, sound: Bool
+        compress: String?, flash: Bool, sound: Bool, exposureTimeNs: Double?, iso: Int?
     )
     func startStream(_ message: [String: Any])
     func stopStream()
@@ -103,6 +103,10 @@ protocol SGCManager {
     func queryGalleryStatus()
     func sendGalleryMode()
 
+    // MARK: - Voice Activity Detection
+
+    func sendVoiceActivityDetectionSetting()
+
     // MARK: - Version Info
 
     func requestVersionInfo()
@@ -127,6 +131,10 @@ extension SGCManager {
 
     func setDashboardMenu(_: [[String: Any]]) {}
 
+    // MARK: - Voice Activity Detection (default no-op — Mentra Live supports this)
+
+    func sendVoiceActivityDetectionSetting() {}
+
     // MARK: - Default DeviceStore-backed property implementations
 
     var fullyBooted: Bool {
@@ -181,8 +189,8 @@ extension SGCManager {
         DeviceStore.shared.get("glasses", "micEnabled") as? Bool ?? false
     }
 
-    var vadEnabled: Bool {
-        DeviceStore.shared.get("glasses", "vadEnabled") as? Bool ?? false
+    var voiceActivityDetectionEnabled: Bool {
+        DeviceStore.shared.get("glasses", "voiceActivityDetectionEnabled") as? Bool ?? true
     }
 
     var batteryLevel: Int {

package/ios/Source/sgcs/Simulated.swift

@@ -12,7 +12,7 @@ class Simulated: SGCManager {
         DeviceStore.shared.apply("glasses", "connected", true)
         DeviceStore.shared.apply("glasses", "connectionState", ConnTypes.CONNECTED)
         DeviceStore.shared.apply("glasses", "micEnabled", false)
-        DeviceStore.shared.apply("glasses", "vadEnabled", false)
+        DeviceStore.shared.apply("glasses", "voiceActivityDetectionEnabled", true)
         DeviceStore.shared.apply("glasses", "bluetoothClassicConnected", false)
     }
 
@@ -75,7 +75,7 @@ class Simulated: SGCManager {
 
     // MARK: - Camera & Media
 
-    func requestPhoto(_: String, appId _: String, size _: String?, webhookUrl _: String?, authToken _: String?, compress _: String?, flash _: Bool, sound _: Bool) {
+    func requestPhoto(_: String, appId _: String, size _: String?, webhookUrl _: String?, authToken _: String?, compress _: String?, flash _: Bool, sound _: Bool, exposureTimeNs _: Double?, iso _: Int?) {
         Bridge.log("requestPhoto")
     }
 

package/ios/Source/stt/SherpaOnnxTranscriber.swift

@@ -214,16 +214,13 @@ class SherpaOnnxTranscriber {
      * Feed PCM audio data (16-bit little endian) into the transcriber.
      * This method should be called continuously with short chunks (e.g., 100-300ms).
      *
-     * Note: Audio passed to this method is assumed to have already passed VAD elsewhere,
-     * so it's directly queued for processing without additional VAD checks.
+     * Audio is queued directly; microphone VAD gating is not applied in the SDK.
      */
     func acceptAudio(pcm16le: Data) {
         guard isRunning else {
             return
         }
 
-        // Directly queue the audio data for processing
-        // No VAD check here as it's assumed to be done upstream
         queueAudioData(pcm16le)
     }
 

package/ios/Source/utils/MessageChunkReassembler.swift

@@ -0,0 +1,89 @@
+import Foundation
+
+final class MessageChunkReassembler {
+    private static let chunkTimeoutMs: TimeInterval = 30_000
+    private static let maxConcurrentSessions = 10
+
+    private var activeSessions: [String: ChunkSession] = [:]
+
+    func addChunk(_ info: MessageChunker.ChunkInfo) -> String? {
+        cleanupTimedOutSessions()
+
+        if activeSessions.count >= Self.maxConcurrentSessions,
+           activeSessions[info.chunkId] == nil
+        {
+            removeOldestSession()
+        }
+
+        let session = activeSessions[info.chunkId] ?? ChunkSession(
+            chunkId: info.chunkId,
+            totalChunks: info.totalChunks
+        )
+        activeSessions[info.chunkId] = session
+
+        guard session.addChunk(index: info.chunkIndex, data: info.data) else {
+            print("MessageChunkReassembler: Failed to add chunk \(info.chunkIndex) for \(info.chunkId)")
+            return nil
+        }
+
+        guard session.isComplete else {
+            return nil
+        }
+
+        let reassembled = session.reassemble()
+        activeSessions.removeValue(forKey: info.chunkId)
+        print("MessageChunkReassembler: Reassembled \(reassembled.count) bytes from \(info.totalChunks) chunks")
+        return reassembled
+    }
+
+    func clear() {
+        activeSessions.removeAll()
+    }
+
+    private func cleanupTimedOutSessions() {
+        let now = Date().timeIntervalSince1970 * 1000
+        activeSessions = activeSessions.filter { entry in
+            now - entry.value.createdAtMs <= Self.chunkTimeoutMs
+        }
+    }
+
+    private func removeOldestSession() {
+        guard let oldest = activeSessions.min(by: { $0.value.createdAtMs < $1.value.createdAtMs }) else {
+            return
+        }
+        activeSessions.removeValue(forKey: oldest.key)
+    }
+
+    private final class ChunkSession {
+        let chunkId: String
+        let totalChunks: Int
+        let createdAtMs: TimeInterval
+        private var chunks: [Int: String] = [:]
+
+        init(chunkId: String, totalChunks: Int) {
+            self.chunkId = chunkId
+            self.totalChunks = totalChunks
+            self.createdAtMs = Date().timeIntervalSince1970 * 1000
+        }
+
+        func addChunk(index: Int, data: String) -> Bool {
+            guard index >= 0, index < totalChunks else {
+                return false
+            }
+            chunks[index] = data
+            return true
+        }
+
+        var isComplete: Bool {
+            chunks.count == totalChunks
+        }
+
+        func reassemble() -> String {
+            var result = ""
+            for index in 0 ..< totalChunks {
+                result += chunks[index] ?? ""
+            }
+            return result
+        }
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentra/bluetooth-sdk",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "SDK for communicating with smart glasses",
   "main": "build/index.js",
   "react-native": "src/index.ts",
@@ -17,6 +17,11 @@
       "react-native": "./src/react/index.ts",
       "default": "./build/react/index.js"
     },
+    "./photo-receiver": {
+      "types": "./build/photo-receiver/index.d.ts",
+      "react-native": "./src/photo-receiver/index.ts",
+      "default": "./build/photo-receiver/index.js"
+    },
     "./_private/*": null,
     "./build/*": null,
     "./src/*": null,