@mentra/bluetooth-sdk 3.3.0-dev.513 → 3.3.0-dev.514

package/android/src/main/java/com/mentra/bluetoothsdk/GeneratedReleaseMetadata.kt

@@ -3,9 +3,9 @@ package com.mentra.bluetoothsdk
 /** Generated by release CI. Do not edit in a release checkout. */
 internal object GeneratedReleaseMetadata {
     const val FAMILY_BASE_VERSION: String = "3.3.0"
-    const val RELEASE_IDENTITY: String = "3.3.0-dev.513"
-    const val RELEASE_SET_ID: String = "mentra-3.3.0-dev.513"
-    const val SOURCE_COMMIT: String = "abeb5904b244689cdfee105ac4eed26629df40ac"
-    const val OTA_MANIFEST_URL: String = "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.3.0/mentra-live-ota-3.3.0-dev.513.json"
-    const val OTA_MANIFEST_SHA256: String = "bc98768e1baee50bdb955ef230822f4070e0c20bc910d1960a1b2e4307a0f077"
+    const val RELEASE_IDENTITY: String = "3.3.0-dev.514"
+    const val RELEASE_SET_ID: String = "mentra-3.3.0-dev.514"
+    const val SOURCE_COMMIT: String = "c08afa1e430e63dffd758478435e8d59940d36c7"
+    const val OTA_MANIFEST_URL: String = "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.3.0/mentra-live-ota-3.3.0-dev.514.json"
+    const val OTA_MANIFEST_SHA256: String = "24a37a482d08ef1a11ff5c96280c641150601b255e336f7723dbf88cb598337e"
 }

package/android/src/main/java/com/mentra/bluetoothsdk/sgcs/MentraLive.kt

@@ -777,7 +777,8 @@ class MentraLive : SGCManager() {
     }
 
     // Inner class to track incoming file transfers
-    private class FileTransferSession(var fileName: String, var fileSize: Int) {
+    internal class FileTransferSession(var fileName: String, var fileSize: Int, flags: Int = 0) {
+        private val dynamicPayload = (flags and 0x0002) != 0
         // NOTE: fileSize may be "fake" (inflated) due to BES firmware workaround
         var actualPackSize =
                 0 // Actual pack size from first received packet (for BES lie detection)
@@ -806,9 +807,8 @@ class MentraLive : SGCManager() {
          * Recalculate total packets based on actual pack size from received packet. Called when
          * first packet is received to handle variable pack sizes.
          *
-         * NOTE: Due to BES firmware workaround, fileSize in header may be "fake" (inflated). We
-         * detect this by checking if fileSize is a multiple of 400 (BES_HARDCODED_PACK_SIZE). If
-         * so, totalPackets = fileSize / 400, regardless of actual pack size.
+         * Dynamic-payload headers carry the true byte count. Only legacy small packs use
+         * the inflated-size workaround (multiples of BES_HARDCODED_PACK_SIZE).
          */
         fun recalculateTotalPackets(actualPackSize: Int) {
             if (actualPackSize <= 0 || actualPackSize > K900ProtocolUtils.FILE_PACK_SIZE) {
@@ -819,8 +819,8 @@ class MentraLive : SGCManager() {
 
             // Detect BES lie: if fileSize is exact multiple of 400, glasses used the lie strategy
             val isBesLie =
-                    (fileSize % BES_HARDCODED_PACK_SIZE == 0) &&
-                            (actualPackSize != BES_HARDCODED_PACK_SIZE)
+                    !dynamicPayload && (fileSize % BES_HARDCODED_PACK_SIZE == 0) &&
+                            (actualPackSize < BES_HARDCODED_PACK_SIZE)
 
             val newTotalPackets: Int
             if (isBesLie) {
@@ -858,6 +858,10 @@ class MentraLive : SGCManager() {
         }
 
         fun addPacket(index: Int, data: ByteArray): Boolean {
+            if (dynamicPayload && (index < 0 || index >= totalPackets || actualPackSize <= 0 ||
+                            data.size != minOf(actualPackSize, fileSize - index * actualPackSize))) {
+                return false
+            }
             if (index >= 0 && index < totalPackets && !receivedPackets.containsKey(index)) {
                 receivedPackets[index] = data
 
@@ -10235,7 +10239,7 @@ class MentraLive : SGCManager() {
             if (incidentRelay.session == null) {
                 activeFileTransfers.remove(packetInfo.fileName)
                 incidentRelay.session =
-                        FileTransferSession(packetInfo.fileName, packetInfo.fileSize)
+                        FileTransferSession(packetInfo.fileName, packetInfo.fileSize, packetInfo.flags)
                 incidentRelay.session!!.recalculateTotalPackets(packetInfo.packSize)
                 Bridge.log(
                         "LIVE: 📦 Started BLE incident log transfer: " +
@@ -10286,7 +10290,7 @@ class MentraLive : SGCManager() {
             // Get or create session for this transfer
             if (photoTransfer.session == null) {
                 photoTransfer.session =
-                        FileTransferSession(packetInfo.fileName, packetInfo.fileSize)
+                        FileTransferSession(packetInfo.fileName, packetInfo.fileSize, packetInfo.flags)
                 // Recalculate total packets based on actual pack size (handles variable MTU)
                 photoTransfer.session!!.recalculateTotalPackets(packetInfo.packSize)
                 Bridge.log(
@@ -10372,7 +10376,7 @@ class MentraLive : SGCManager() {
         var session = activeFileTransfers[packetInfo.fileName]
         if (session == null) {
             // New file transfer
-            session = FileTransferSession(packetInfo.fileName, packetInfo.fileSize)
+            session = FileTransferSession(packetInfo.fileName, packetInfo.fileSize, packetInfo.flags)
             // Recalculate total packets based on actual pack size (handles variable MTU)
             session.recalculateTotalPackets(packetInfo.packSize)
             activeFileTransfers[packetInfo.fileName] = session

package/android/src/test/java/com/mentra/bluetoothsdk/sgcs/MentraLiveFileTransferSessionTest.kt

@@ -0,0 +1,55 @@
+package com.mentra.bluetoothsdk.sgcs
+
+import org.junit.Assert.*
+import org.junit.Test
+import org.junit.runner.RunWith
+import org.robolectric.RobolectricTestRunner
+import org.robolectric.annotation.Config
+
+@RunWith(RobolectricTestRunner::class)
+@Config(sdk = [33])
+class MentraLiveFileTransferSessionTest {
+    @Test fun dynamicPayloadUsesTrueSizeEvenWhenDivisibleBy400() {
+        for (pack in listOf(244, 474, 800)) {
+            val session = MentraLive.FileTransferSession("photo", 80000, 2)
+            session.recalculateTotalPackets(pack)
+            assertEquals((80000 + pack - 1) / pack, session.totalPackets)
+            for (index in 0 until session.totalPackets) {
+                assertTrue(session.addPacket(index, ByteArray(minOf(pack, 80000 - index * pack))))
+            }
+            assertTrue(session.isComplete)
+            assertEquals(80000, session.assembleFile()!!.size)
+        }
+    }
+
+    @Test fun legacyInflatedSizeAndLargeUnflaggedPayloads() {
+        // Flag 1 enables batched ACKs but still uses legacy size semantics.
+        for ((pack, headerSize, actualSize, packets) in listOf(
+                listOf(221, 80000, 43982, 200),
+                listOf(400, 80000, 79777, 200),
+                listOf(800, 80000, 80000, 100))) {
+            val session = MentraLive.FileTransferSession("photo", headerSize, 1)
+            session.recalculateTotalPackets(pack)
+            assertEquals(packets, session.totalPackets)
+            val source = ByteArray(actualSize) { (it % 251).toByte() }
+            for (index in (0 until packets).reversed()) {
+                val start = index * pack
+                assertTrue(session.addPacket(index, source.copyOfRange(start, minOf(start + pack, actualSize))))
+            }
+            assertTrue(session.isComplete)
+            assertArrayEquals(source, session.assembleFile())
+        }
+    }
+
+    @Test fun malformedOrDuplicatePacketsCannotCompleteFile() {
+        val session = MentraLive.FileTransferSession("photo", 1000, 2)
+        session.recalculateTotalPackets(800)
+        assertFalse(session.addPacket(0, ByteArray(799)))
+        assertFalse(session.addPacket(2, ByteArray(200)))
+        assertTrue(session.addPacket(1, ByteArray(200)))
+        assertFalse(session.isComplete)
+        assertFalse(session.addPacket(1, ByteArray(200)))
+        assertTrue(session.addPacket(0, ByteArray(800)))
+        assertEquals(1000, session.assembleFile()!!.size)
+    }
+}

package/build/generated/releaseMetadata.js

@@ -1,10 +1,10 @@
 export const BLUETOOTH_SDK_RELEASE_METADATA = Object.freeze({
     "schemaVersion": 1,
     "familyBaseVersion": "3.3.0",
-    "releaseIdentity": "3.3.0-dev.513",
-    "releaseSetId": "mentra-3.3.0-dev.513",
-    "sourceCommit": "abeb5904b244689cdfee105ac4eed26629df40ac",
-    "otaManifestUrl": "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.3.0/mentra-live-ota-3.3.0-dev.513.json",
-    "otaManifestSha256": "bc98768e1baee50bdb955ef230822f4070e0c20bc910d1960a1b2e4307a0f077"
+    "releaseIdentity": "3.3.0-dev.514",
+    "releaseSetId": "mentra-3.3.0-dev.514",
+    "sourceCommit": "c08afa1e430e63dffd758478435e8d59940d36c7",
+    "otaManifestUrl": "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.3.0/mentra-live-ota-3.3.0-dev.514.json",
+    "otaManifestSha256": "24a37a482d08ef1a11ff5c96280c641150601b255e336f7723dbf88cb598337e"
 });
 //# sourceMappingURL=releaseMetadata.js.map

package/build/generated/releaseMetadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"releaseMetadata.js","sourceRoot":"","sources":["../../src/generated/releaseMetadata.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,8BAA8B,GAA0C,MAAM,CAAC,MAAM,CAAC;IACjG,eAAe,EAAE,CAAC;IAClB,mBAAmB,EAAE,OAAO;IAC5B,iBAAiB,EAAE,eAAe;IAClC,cAAc,EAAE,sBAAsB;IACtC,cAAc,EAAE,0CAA0C;IAC1D,gBAAgB,EAAE,iIAAiI;IACnJ,mBAAmB,EAAE,kEAAkE;CACxF,CAAC,CAAA","sourcesContent":["/** Generated by release CI. Do not edit in a release checkout. */\nexport interface BluetoothSdkReleaseMetadata {\n  schemaVersion: 1\n  familyBaseVersion: string | null\n  releaseIdentity: string | null\n  releaseSetId: string | null\n  sourceCommit: string | null\n  otaManifestUrl: string | null\n  otaManifestSha256: string | null\n}\n\nexport const BLUETOOTH_SDK_RELEASE_METADATA: Readonly<BluetoothSdkReleaseMetadata> = Object.freeze({\n  \"schemaVersion\": 1,\n  \"familyBaseVersion\": \"3.3.0\",\n  \"releaseIdentity\": \"3.3.0-dev.513\",\n  \"releaseSetId\": \"mentra-3.3.0-dev.513\",\n  \"sourceCommit\": \"abeb5904b244689cdfee105ac4eed26629df40ac\",\n  \"otaManifestUrl\": \"https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.3.0/mentra-live-ota-3.3.0-dev.513.json\",\n  \"otaManifestSha256\": \"bc98768e1baee50bdb955ef230822f4070e0c20bc910d1960a1b2e4307a0f077\"\n})\n"]}
+{"version":3,"file":"releaseMetadata.js","sourceRoot":"","sources":["../../src/generated/releaseMetadata.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,8BAA8B,GAA0C,MAAM,CAAC,MAAM,CAAC;IACjG,eAAe,EAAE,CAAC;IAClB,mBAAmB,EAAE,OAAO;IAC5B,iBAAiB,EAAE,eAAe;IAClC,cAAc,EAAE,sBAAsB;IACtC,cAAc,EAAE,0CAA0C;IAC1D,gBAAgB,EAAE,iIAAiI;IACnJ,mBAAmB,EAAE,kEAAkE;CACxF,CAAC,CAAA","sourcesContent":["/** Generated by release CI. Do not edit in a release checkout. */\nexport interface BluetoothSdkReleaseMetadata {\n  schemaVersion: 1\n  familyBaseVersion: string | null\n  releaseIdentity: string | null\n  releaseSetId: string | null\n  sourceCommit: string | null\n  otaManifestUrl: string | null\n  otaManifestSha256: string | null\n}\n\nexport const BLUETOOTH_SDK_RELEASE_METADATA: Readonly<BluetoothSdkReleaseMetadata> = Object.freeze({\n  \"schemaVersion\": 1,\n  \"familyBaseVersion\": \"3.3.0\",\n  \"releaseIdentity\": \"3.3.0-dev.514\",\n  \"releaseSetId\": \"mentra-3.3.0-dev.514\",\n  \"sourceCommit\": \"c08afa1e430e63dffd758478435e8d59940d36c7\",\n  \"otaManifestUrl\": \"https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.3.0/mentra-live-ota-3.3.0-dev.514.json\",\n  \"otaManifestSha256\": \"24a37a482d08ef1a11ff5c96280c641150601b255e336f7723dbf88cb598337e\"\n})\n"]}

package/ios/Source/BluetoothSdkDefaults.swift

@@ -16,7 +16,7 @@ enum BluetoothSdkDefaults {
     /// silently disable it on every pair the app touches.
     static let autoPowerOffEnabled = false
     private static let infoSdkVersionKey = "MentraBluetoothSdkVersion"
-    private static let swiftPackageSdkVersion = "3.3.0-dev.513"
+    private static let swiftPackageSdkVersion = "3.3.0-dev.514"
     private static let swiftPackageSdkVersionPlaceholder = "__MENTRA" + "_BLUETOOTH_SDK_VERSION__"
 
     private static func normalizedSdkVersion(_ value: String?) -> String? {

package/ios/Source/GeneratedReleaseMetadata.swift

@@ -3,9 +3,9 @@ import Foundation
 /// Generated by release CI. Do not edit in a release checkout.
 enum GeneratedReleaseMetadata {
     static let familyBaseVersion = "3.3.0"
-    static let releaseIdentity = "3.3.0-dev.513"
-    static let releaseSetId = "mentra-3.3.0-dev.513"
-    static let sourceCommit = "abeb5904b244689cdfee105ac4eed26629df40ac"
-    static let otaManifestUrl = "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.3.0/mentra-live-ota-3.3.0-dev.513.json"
-    static let otaManifestSha256 = "bc98768e1baee50bdb955ef230822f4070e0c20bc910d1960a1b2e4307a0f077"
+    static let releaseIdentity = "3.3.0-dev.514"
+    static let releaseSetId = "mentra-3.3.0-dev.514"
+    static let sourceCommit = "c08afa1e430e63dffd758478435e8d59940d36c7"
+    static let otaManifestUrl = "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.3.0/mentra-live-ota-3.3.0-dev.514.json"
+    static let otaManifestSha256 = "24a37a482d08ef1a11ff5c96280c641150601b255e336f7723dbf88cb598337e"
 }

package/ios/Source/sgcs/MentraLive.swift

@@ -677,145 +677,13 @@ enum K900ProtocolUtils {
     }
 }
 
-private struct FileTransferSession {
-    let fileName: String
-    let fileSize: Int // NOTE: May be "fake" (inflated) due to BES firmware workaround
-    var actualPackSize: Int = 0 // Actual pack size from first received packet
-    var totalPackets: Int
-    var expectedNextPacket: Int = 0
-    var receivedPackets: [Int: Data] = [:]
-    let startTime: Date
-    var isComplete: Bool = false
-    var isAnnounced: Bool = false
-
-    /// BES2700 firmware hardcodes FILE_PACK_SIZE=400 when calculating totalPack.
-    /// Android glasses "lie" about fileSize to make BES expect correct packet count.
-    private static let BES_HARDCODED_PACK_SIZE = 400
-
-    init(fileName: String, fileSize: Int, announcedPackets: Int? = nil) {
-        self.fileName = fileName
-        self.fileSize = fileSize
-        let computedPackets =
-            (fileSize + K900ProtocolUtils.FILE_PACK_SIZE - 1) / K900ProtocolUtils.FILE_PACK_SIZE
-        if let announced = announcedPackets, announced > 0 {
-            totalPackets = announced
-            isAnnounced = true
-        } else {
-            totalPackets = computedPackets
-            isAnnounced = false
-        }
-        startTime = Date()
-    }
-
-    mutating func updateAnnouncedPackets(_ announced: Int) {
-        guard announced > 0 else { return }
-        totalPackets = announced
-        isAnnounced = true
-        if expectedNextPacket >= totalPackets {
-            expectedNextPacket = min(expectedNextPacket, max(totalPackets - 1, 0))
-        }
-    }
-
-    /// Recalculate total packets based on actual pack size from received packet.
-    /// Detects BES lie: if fileSize is multiple of 400 but actual pack size differs.
-    mutating func recalculateTotalPackets(actualPackSize: Int) {
-        guard actualPackSize > 0, actualPackSize <= K900ProtocolUtils.FILE_PACK_SIZE else { return }
-
-        self.actualPackSize = actualPackSize
-
-        // Detect BES lie: if fileSize is exact multiple of 400, glasses used the lie strategy
-        let isBesLie =
-            (fileSize % Self.BES_HARDCODED_PACK_SIZE == 0)
-                && (actualPackSize != Self.BES_HARDCODED_PACK_SIZE)
-
-        let newTotalPackets: Int
-        if isBesLie {
-            // BES lie detected: totalPackets = fileSize / 400
-            newTotalPackets = fileSize / Self.BES_HARDCODED_PACK_SIZE
-            Bridge.log(
-                "📦 BES Lie detected! fakeFileSize=\(fileSize), totalPackets=\(newTotalPackets), actualPackSize=\(actualPackSize)"
-            )
-        } else {
-            // Normal case: calculate based on actual pack size
-            newTotalPackets = (fileSize + actualPackSize - 1) / actualPackSize
-        }
-
-        if newTotalPackets != totalPackets {
-            Bridge.log(
-                "📦 Recalculating totalPackets: \(totalPackets) -> \(newTotalPackets) (packSize=\(actualPackSize), fileSize=\(fileSize))"
-            )
-            totalPackets = newTotalPackets
-        }
-    }
-
-    mutating func addPacket(_ index: Int, data: Data) -> Bool {
-        guard index >= 0 else { return false }
-
-        // On first packet, recalculate total packets only when we do not already
-        // have an authoritative pack size from protocol metadata.
-        if receivedPackets.isEmpty && actualPackSize == 0 && !data.isEmpty {
-            recalculateTotalPackets(actualPackSize: data.count)
-        }
-
-        if index >= totalPackets {
-            totalPackets = index + 1
-        }
-
-        guard receivedPackets[index] == nil else {
-            return false
-        }
-
-        receivedPackets[index] = data
-
-        while receivedPackets[expectedNextPacket] != nil, expectedNextPacket < totalPackets {
-            expectedNextPacket += 1
-        }
-
-        isComplete = (receivedPackets.count == totalPackets)
-        return true
-    }
-
-    func isFinalPacket(_ index: Int) -> Bool {
-        index == totalPackets - 1
-    }
-
-    func missingPacketIndices() -> [Int] {
-        guard totalPackets > receivedPackets.count else { return [] }
-        return (0 ..< totalPackets).compactMap { receivedPackets[$0] == nil ? $0 : nil }
-    }
-
-    /// Assemble file from received packets.
-    /// NOTE: Calculates actual file size from received data, NOT from header fileSize,
-    /// because fileSize may be "fake" (inflated) due to BES firmware workaround.
-    func assembleFile() -> Data? {
-        guard isComplete else { return nil }
-
-        // Calculate actual file size by summing all received packet sizes
-        let actualFileSize = receivedPackets.values.reduce(0) { $0 + $1.count }
-
-        Bridge.log(
-            "📦 Assembling file: headerFileSize=\(fileSize), actualFileSize=\(actualFileSize), totalPackets=\(totalPackets)"
-        )
-
-        var fileData = Data(capacity: actualFileSize)
-
-        for i in 0 ..< totalPackets {
-            if let packet = receivedPackets[i] {
-                fileData.append(packet)
-            }
-        }
-
-        return fileData
-    }
-}
-
 private struct BlePhotoTransfer {
     var isThumbnail = false
     let bleImgId: String
     let requestId: String
     let webhookUrl: String
     var authToken: String?
-    var session: FileTransferSession?
+    var session: MentraLiveFileTransferSession?
     let phoneStartTime: Date
     var bleTransferStartTime: Date?
     var glassesCompressionDurationMs: Int64 = 0
@@ -838,7 +706,7 @@ private final class BleIncidentLogRelayEntry {
     let incidentId: String
     let apiBaseUrl: String
     let kind: BleIncidentLogRelayKind
-    var session: FileTransferSession?
+    var session: MentraLiveFileTransferSession?
 
     init(
         fileBaseKey: String, incidentId: String, apiBaseUrl: String, kind: BleIncidentLogRelayKind
@@ -1602,7 +1470,7 @@ class MentraLive: NSObject, SGCManager {
     // NEW: File transfer properties
     private var fileReadCharacteristic: CBCharacteristic?
     private var fileWriteCharacteristic: CBCharacteristic?
-    private var activeFileTransfers = [String: FileTransferSession]()
+    private var activeFileTransfers = [String: MentraLiveFileTransferSession]()
     private var blePhotoTransfers = [String: BlePhotoTransfer]()
     private var bleIncidentLogRelays = [String: BleIncidentLogRelayEntry]()
     private var l2capFileChannel: MentraLiveL2capChannel?
@@ -2639,7 +2507,8 @@ class MentraLive: NSObject, SGCManager {
                 // The reader thread keeps draining the stream (and returning CoC credits)
                 // while the existing transfer state remains serialized on the main actor.
                 DispatchQueue.main.async {
-                    self?.processReceivedData(frame)
+                    guard let self, self.l2capFileChannelId == channelId else { return }
+                    self.processReceivedData(frame)
                 }
             },
             onClose: { [weak self] in
@@ -2666,7 +2535,7 @@ class MentraLive: NSObject, SGCManager {
 
     // MARK: - Data Processing
 
-    // Internal so native integration tests can replay the actual BLE receive path.
+    /// Internal so native integration tests can replay the actual BLE receive path.
     func processReceivedData(_ data: Data) {
         guard data.count > 0 else { return }
 
@@ -4161,7 +4030,7 @@ class MentraLive: NSObject, SGCManager {
             activeFileTransfers.removeValue(forKey: fileName)
         }
 
-        var session = FileTransferSession(
+        var session = MentraLiveFileTransferSession(
             fileName: fileName, fileSize: fileSize, announcedPackets: totalPackets
         )
         session.isAnnounced = true
@@ -4171,7 +4040,7 @@ class MentraLive: NSObject, SGCManager {
         if var bleTransfer = blePhotoTransfers[bleImgId] {
             var bleSession =
                 bleTransfer.session
-                    ?? FileTransferSession(
+                    ?? MentraLiveFileTransferSession(
                         fileName: fileName, fileSize: fileSize, announcedPackets: totalPackets
                     )
             bleSession.updateAnnouncedPackets(totalPackets)
@@ -4264,8 +4133,8 @@ class MentraLive: NSObject, SGCManager {
 
             if incidentRelay.session == nil {
                 activeFileTransfers.removeValue(forKey: packetInfo.fileName)
-                var session = FileTransferSession(
-                    fileName: packetInfo.fileName, fileSize: Int(packetInfo.fileSize)
+                var session = MentraLiveFileTransferSession(
+                    fileName: packetInfo.fileName, fileSize: Int(packetInfo.fileSize), flags: packetInfo.flags
                 )
                 session.recalculateTotalPackets(actualPackSize: Int(packetInfo.packSize))
                 incidentRelay.session = session
@@ -4316,10 +4185,11 @@ class MentraLive: NSObject, SGCManager {
 
             // Get or create session for this transfer
             if photoTransfer.session == nil {
-                var session = FileTransferSession(
+                var session = MentraLiveFileTransferSession(
                     fileName: packetInfo.fileName,
-                    fileSize: Int(packetInfo.fileSize)
+                    fileSize: Int(packetInfo.fileSize), flags: packetInfo.flags
                 )
+                session.recalculateTotalPackets(actualPackSize: Int(packetInfo.packSize))
                 photoTransfer.session = session
                 blePhotoTransfers[bleImgId] = photoTransfer
                 Bridge.log(
@@ -4392,9 +4262,10 @@ class MentraLive: NSObject, SGCManager {
         var session = activeFileTransfers[packetInfo.fileName]
         if session == nil {
             // New file transfer
-            session = FileTransferSession(
-                fileName: packetInfo.fileName, fileSize: Int(packetInfo.fileSize)
+            session = MentraLiveFileTransferSession(
+                fileName: packetInfo.fileName, fileSize: Int(packetInfo.fileSize), flags: packetInfo.flags
             )
+            session?.recalculateTotalPackets(actualPackSize: Int(packetInfo.packSize))
             activeFileTransfers[packetInfo.fileName] = session
 
             Bridge.log(

package/ios/Source/sgcs/MentraLiveFileTransferSession.swift

@@ -0,0 +1,137 @@
+import Foundation
+
+struct MentraLiveFileTransferSession {
+    let fileName: String
+    let fileSize: Int // NOTE: May be "fake" (inflated) due to BES firmware workaround
+    let dynamicPayload: Bool
+    var actualPackSize: Int = 0 // Actual pack size from first received packet
+    var totalPackets: Int
+    var expectedNextPacket: Int = 0
+    var receivedPackets: [Int: Data] = [:]
+    let startTime: Date
+    var isComplete: Bool = false
+    var isAnnounced: Bool = false
+
+    /// BES2700 firmware hardcodes FILE_PACK_SIZE=400 when calculating totalPack.
+    /// Android glasses "lie" about fileSize to make BES expect correct packet count.
+    private static let BES_HARDCODED_PACK_SIZE = 400
+
+    init(fileName: String, fileSize: Int, announcedPackets: Int? = nil, flags: UInt16 = 0) {
+        self.fileName = fileName
+        self.fileSize = fileSize
+        dynamicPayload = (flags & 0x0002) != 0
+        let computedPackets =
+            (fileSize + K900ProtocolUtils.FILE_PACK_SIZE - 1) / K900ProtocolUtils.FILE_PACK_SIZE
+        if let announced = announcedPackets, announced > 0 {
+            totalPackets = announced
+            isAnnounced = true
+        } else {
+            totalPackets = computedPackets
+            isAnnounced = false
+        }
+        startTime = Date()
+    }
+
+    mutating func updateAnnouncedPackets(_ announced: Int) {
+        guard announced > 0 else { return }
+        totalPackets = announced
+        isAnnounced = true
+        if expectedNextPacket >= totalPackets {
+            expectedNextPacket = min(expectedNextPacket, max(totalPackets - 1, 0))
+        }
+    }
+
+    /// Recalculate total packets based on actual pack size from received packet.
+    /// Dynamic headers carry the true byte count. Only legacy small packs use inflated sizes.
+    mutating func recalculateTotalPackets(actualPackSize: Int) {
+        guard actualPackSize > 0, actualPackSize <= K900ProtocolUtils.FILE_PACK_SIZE else { return }
+
+        self.actualPackSize = actualPackSize
+
+        // Detect BES lie: if fileSize is exact multiple of 400, glasses used the lie strategy
+        let isBesLie = !dynamicPayload
+            && (fileSize % Self.BES_HARDCODED_PACK_SIZE == 0)
+            && (actualPackSize < Self.BES_HARDCODED_PACK_SIZE)
+
+        let newTotalPackets: Int
+        if isBesLie {
+            // BES lie detected: totalPackets = fileSize / 400
+            newTotalPackets = fileSize / Self.BES_HARDCODED_PACK_SIZE
+            Bridge.log(
+                "📦 BES Lie detected! fakeFileSize=\(fileSize), totalPackets=\(newTotalPackets), actualPackSize=\(actualPackSize)"
+            )
+        } else {
+            // Normal case: calculate based on actual pack size
+            newTotalPackets = (fileSize + actualPackSize - 1) / actualPackSize
+        }
+
+        if newTotalPackets != totalPackets {
+            Bridge.log(
+                "📦 Recalculating totalPackets: \(totalPackets) -> \(newTotalPackets) (packSize=\(actualPackSize), fileSize=\(fileSize))"
+            )
+            totalPackets = newTotalPackets
+        }
+    }
+
+    mutating func addPacket(_ index: Int, data: Data) -> Bool {
+        guard index >= 0 else { return false }
+
+        // On first packet, recalculate total packets only when we do not already
+        // have an authoritative pack size from protocol metadata.
+        if receivedPackets.isEmpty && actualPackSize == 0 && !data.isEmpty {
+            recalculateTotalPackets(actualPackSize: data.count)
+        }
+
+        guard index < totalPackets else { return false }
+        if dynamicPayload {
+            let expectedSize = min(actualPackSize, fileSize - index * actualPackSize)
+            guard expectedSize > 0, data.count == expectedSize else { return false }
+        }
+
+        guard receivedPackets[index] == nil else {
+            return false
+        }
+
+        receivedPackets[index] = data
+
+        while receivedPackets[expectedNextPacket] != nil, expectedNextPacket < totalPackets {
+            expectedNextPacket += 1
+        }
+
+        isComplete = (receivedPackets.count == totalPackets)
+        return true
+    }
+
+    func isFinalPacket(_ index: Int) -> Bool {
+        index == totalPackets - 1
+    }
+
+    func missingPacketIndices() -> [Int] {
+        guard totalPackets > receivedPackets.count else { return [] }
+        return (0 ..< totalPackets).compactMap { receivedPackets[$0] == nil ? $0 : nil }
+    }
+
+    /// Assemble file from received packets.
+    /// NOTE: Calculates actual file size from received data, NOT from header fileSize,
+    /// because fileSize may be "fake" (inflated) due to BES firmware workaround.
+    func assembleFile() -> Data? {
+        guard isComplete else { return nil }
+
+        // Calculate actual file size by summing all received packet sizes
+        let actualFileSize = receivedPackets.values.reduce(0) { $0 + $1.count }
+
+        Bridge.log(
+            "📦 Assembling file: headerFileSize=\(fileSize), actualFileSize=\(actualFileSize), totalPackets=\(totalPackets)"
+        )
+
+        var fileData = Data(capacity: actualFileSize)
+
+        for i in 0 ..< totalPackets {
+            if let packet = receivedPackets[i] {
+                fileData.append(packet)
+            }
+        }
+
+        return fileData
+    }
+}

package/ios/Tests/MentraLiveFileTransferSessionTests.swift

@@ -0,0 +1,47 @@
+import Foundation
+@testable import MentraBluetoothSDK
+import XCTest
+
+final class MentraLiveFileTransferSessionTests: XCTestCase {
+    func testDynamicPayloadUsesTrueSizeEvenWhenDivisibleBy400() {
+        for pack in [244, 474, 800] {
+            var session = MentraLiveFileTransferSession(fileName: "photo", fileSize: 80000, flags: 2)
+            session.recalculateTotalPackets(actualPackSize: pack)
+            XCTAssertEqual(session.totalPackets, (80000 + pack - 1) / pack)
+            for index in 0 ..< session.totalPackets {
+                XCTAssertTrue(session.addPacket(index, data: Data(repeating: 7, count: min(pack, 80000 - index * pack))))
+            }
+            XCTAssertTrue(session.isComplete)
+            XCTAssertEqual(session.assembleFile()?.count, 80000)
+        }
+    }
+
+    func testLegacyInflatedSizeAndLargeUnflaggedPayloads() {
+        // Old senders inflate the header length for small packs, including
+        // the short final pack. Flag 1 only enables batched ACKs.
+        for (pack, headerSize, actualSize, packets) in [(221, 80000, 43982, 200), (400, 80000, 79777, 200), (800, 80000, 80000, 100)] {
+            var session = MentraLiveFileTransferSession(fileName: "photo", fileSize: headerSize, flags: 1)
+            session.recalculateTotalPackets(actualPackSize: pack)
+            XCTAssertEqual(session.totalPackets, packets)
+            let source = Data((0 ..< actualSize).map { UInt8($0 % 251) })
+            for index in (0 ..< packets).reversed() {
+                let start = index * pack
+                XCTAssertTrue(session.addPacket(index, data: source.subdata(in: start ..< min(start + pack, actualSize))))
+            }
+            XCTAssertTrue(session.isComplete)
+            XCTAssertEqual(session.assembleFile(), source)
+        }
+    }
+
+    func testMalformedOrDuplicatePacketsCannotCompleteFile() {
+        var session = MentraLiveFileTransferSession(fileName: "photo", fileSize: 1000, flags: 2)
+        session.recalculateTotalPackets(actualPackSize: 800)
+        XCTAssertFalse(session.addPacket(0, data: Data(count: 799)))
+        XCTAssertFalse(session.addPacket(2, data: Data(count: 200)))
+        XCTAssertTrue(session.addPacket(1, data: Data(count: 200)))
+        XCTAssertFalse(session.isComplete)
+        XCTAssertFalse(session.addPacket(1, data: Data(count: 200)))
+        XCTAssertTrue(session.addPacket(0, data: Data(count: 800)))
+        XCTAssertEqual(session.assembleFile()?.count, 1000)
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentra/bluetooth-sdk",
-  "version": "3.3.0-dev.513",
+  "version": "3.3.0-dev.514",
   "description": "SDK for communicating with smart glasses",
   "main": "build/index.js",
   "react-native": "src/index.ts",
@@ -114,7 +114,7 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@mentra/cloud-protocol": "3.3.0-dev.513"
+    "@mentra/cloud-protocol": "3.3.0-dev.514"
   },
   "devDependencies": {
     "@types/node": "^25.9.3",

package/src/generated/releaseMetadata.ts

@@ -12,9 +12,9 @@ export interface BluetoothSdkReleaseMetadata {
 export const BLUETOOTH_SDK_RELEASE_METADATA: Readonly<BluetoothSdkReleaseMetadata> = Object.freeze({
   "schemaVersion": 1,
   "familyBaseVersion": "3.3.0",
-  "releaseIdentity": "3.3.0-dev.513",
-  "releaseSetId": "mentra-3.3.0-dev.513",
-  "sourceCommit": "abeb5904b244689cdfee105ac4eed26629df40ac",
-  "otaManifestUrl": "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.3.0/mentra-live-ota-3.3.0-dev.513.json",
-  "otaManifestSha256": "bc98768e1baee50bdb955ef230822f4070e0c20bc910d1960a1b2e4307a0f077"
+  "releaseIdentity": "3.3.0-dev.514",
+  "releaseSetId": "mentra-3.3.0-dev.514",
+  "sourceCommit": "c08afa1e430e63dffd758478435e8d59940d36c7",
+  "otaManifestUrl": "https://artifactscdn.mentraglass.com/Mentra-Community/MentraOS/releases/mentra-builds-v3.3.0/mentra-live-ota-3.3.0-dev.514.json",
+  "otaManifestSha256": "24a37a482d08ef1a11ff5c96280c641150601b255e336f7723dbf88cb598337e"
 })