@mentra/bluetooth-sdk 3.2.0-dev.255 → 3.2.0-dev.259

package/build/_private/streamRequestPayload.js

@@ -0,0 +1,42 @@
+/**
+ * Normalizes stream start request parameters for the native module bridge.
+ * Preserves omission of telemetry when undefined so the glasses use their build default,
+ * and forwards explicit true / false.
+ */
+export function streamRequestParamsForNative(params) {
+    const payload = {
+        streamUrl: params.streamUrl,
+    };
+    if (params.type !== undefined) {
+        payload.type = params.type;
+    }
+    if (params.streamId !== undefined) {
+        payload.streamId = params.streamId;
+    }
+    if (params.sound !== undefined) {
+        payload.sound = params.sound;
+    }
+    if (params.video !== undefined) {
+        payload.video = params.video;
+    }
+    if (params.audio !== undefined) {
+        payload.audio = params.audio;
+    }
+    if (params.ice !== undefined) {
+        payload.ice = params.ice;
+    }
+    if (params.captureAudio !== undefined) {
+        payload.captureAudio = params.captureAudio;
+    }
+    if (params.traceId !== undefined && params.traceId.length > 0) {
+        payload.traceId = params.traceId;
+    }
+    if (params.authToken !== undefined && params.authToken.length > 0) {
+        payload.authToken = params.authToken;
+    }
+    if (params.telemetry !== undefined) {
+        payload.telemetry = params.telemetry;
+    }
+    return payload;
+}
+//# sourceMappingURL=streamRequestPayload.js.map

package/build/_private/streamRequestPayload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamRequestPayload.js","sourceRoot":"","sources":["../../src/_private/streamRequestPayload.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAAC,MAA0B;IACrE,MAAM,OAAO,GAA4B;QACvC,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAA;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAA;IAC5B,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAA;IACpC,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAA;IAC9B,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAA;IAC9B,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAA;IAC9B,CAAC;IACD,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAA;IAC1B,CAAC;IACD,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACtC,OAAO,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAA;IAC5C,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9D,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAA;IAClC,CAAC;IACD,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClE,OAAO,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAA;IACtC,CAAC;IACD,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACnC,OAAO,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAA;IACtC,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC","sourcesContent":["import type {StreamStartRequest} from \"../BluetoothSdk.types\"\n\n/**\n * Normalizes stream start request parameters for the native module bridge.\n * Preserves omission of telemetry when undefined so the glasses use their build default,\n * and forwards explicit true / false.\n */\nexport function streamRequestParamsForNative(params: StreamStartRequest): Record<string, unknown> {\n  const payload: Record<string, unknown> = {\n    streamUrl: params.streamUrl,\n  }\n  if (params.type !== undefined) {\n    payload.type = params.type\n  }\n  if (params.streamId !== undefined) {\n    payload.streamId = params.streamId\n  }\n  if (params.sound !== undefined) {\n    payload.sound = params.sound\n  }\n  if (params.video !== undefined) {\n    payload.video = params.video\n  }\n  if (params.audio !== undefined) {\n    payload.audio = params.audio\n  }\n  if (params.ice !== undefined) {\n    payload.ice = params.ice\n  }\n  if (params.captureAudio !== undefined) {\n    payload.captureAudio = params.captureAudio\n  }\n  if (params.traceId !== undefined && params.traceId.length > 0) {\n    payload.traceId = params.traceId\n  }\n  if (params.authToken !== undefined && params.authToken.length > 0) {\n    payload.authToken = params.authToken\n  }\n  if (params.telemetry !== undefined) {\n    payload.telemetry = params.telemetry\n  }\n  return payload\n}\n"]}

package/build/generated/releaseMetadata.js

@@ -1,10 +1,10 @@
 export const BLUETOOTH_SDK_RELEASE_METADATA = Object.freeze({
     "schemaVersion": 1,
     "familyBaseVersion": "3.2.0",
-    "releaseIdentity": "3.2.0-dev.255",
-    "releaseSetId": "mentra-3.2.0-dev.255",
-    "sourceCommit": "95dfa6c4b2f341917b687798ff7b0065365d3115",
-    "otaManifestUrl": "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.255.json",
-    "otaManifestSha256": "9816cf655e30e4306c324469ed5ed3eee73d9b76345bc8c6b24e48edf5215837"
+    "releaseIdentity": "3.2.0-dev.259",
+    "releaseSetId": "mentra-3.2.0-dev.259",
+    "sourceCommit": "a813257666fd73103cf743ec50a4a158ed021d41",
+    "otaManifestUrl": "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.259.json",
+    "otaManifestSha256": "b72673f29592ac9357d40b639d093bd50914c8f6f0f4bb02cf0f4fe03fbf0f38"
 });
 //# 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,wHAAwH;IAC1I,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.2.0\",\n  \"releaseIdentity\": \"3.2.0-dev.255\",\n  \"releaseSetId\": \"mentra-3.2.0-dev.255\",\n  \"sourceCommit\": \"95dfa6c4b2f341917b687798ff7b0065365d3115\",\n  \"otaManifestUrl\": \"https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.255.json\",\n  \"otaManifestSha256\": \"9816cf655e30e4306c324469ed5ed3eee73d9b76345bc8c6b24e48edf5215837\"\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,wHAAwH;IAC1I,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.2.0\",\n  \"releaseIdentity\": \"3.2.0-dev.259\",\n  \"releaseSetId\": \"mentra-3.2.0-dev.259\",\n  \"sourceCommit\": \"a813257666fd73103cf743ec50a4a158ed021d41\",\n  \"otaManifestUrl\": \"https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.259.json\",\n  \"otaManifestSha256\": \"b72673f29592ac9357d40b639d093bd50914c8f6f0f4bb02cf0f4fe03fbf0f38\"\n})\n"]}

package/ios/Source/BluetoothSdkDefaults.swift

@@ -11,7 +11,7 @@ enum BluetoothSdkDefaults {
     static let voiceActivityDetectionEnabled = false
     static let loudnessGateEnabled = false
     private static let infoSdkVersionKey = "MentraBluetoothSdkVersion"
-    private static let swiftPackageSdkVersion = "3.2.0-dev.255"
+    private static let swiftPackageSdkVersion = "3.2.0-dev.259"
     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.2.0"
-    static let releaseIdentity = "3.2.0-dev.255"
-    static let releaseSetId = "mentra-3.2.0-dev.255"
-    static let sourceCommit = "95dfa6c4b2f341917b687798ff7b0065365d3115"
-    static let otaManifestUrl = "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.255.json"
-    static let otaManifestSha256 = "9816cf655e30e4306c324469ed5ed3eee73d9b76345bc8c6b24e48edf5215837"
+    static let releaseIdentity = "3.2.0-dev.259"
+    static let releaseSetId = "mentra-3.2.0-dev.259"
+    static let sourceCommit = "a813257666fd73103cf743ec50a4a158ed021d41"
+    static let otaManifestUrl = "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.259.json"
+    static let otaManifestSha256 = "b72673f29592ac9357d40b639d093bd50914c8f6f0f4bb02cf0f4fe03fbf0f38"
 }

package/ios/Source/streaming/StreamModels.swift

@@ -330,6 +330,7 @@ public struct StreamRequest {
     /// Correlation id the glasses echo in every SOFTAP_TRACE line, so phone and glasses logs can
     /// be joined despite unsynchronised clocks.
     public let traceId: String?
+    public let telemetry: Bool?
 
     public init(
         streamUrl: String,
@@ -340,7 +341,8 @@ public struct StreamRequest {
         authToken: String? = nil,
         captureAudio: Bool = true,
         ice: StreamIceConfig? = nil,
-        traceId: String? = nil
+        traceId: String? = nil,
+        telemetry: Bool? = nil
     ) {
         self.streamUrl = streamUrl
         self.streamId = streamId
@@ -351,9 +353,19 @@ public struct StreamRequest {
         self.captureAudio = captureAudio
         self.ice = ice
         self.traceId = traceId
+        self.telemetry = telemetry
     }
 
     init(values: [String: Any]) {
+        let telemetryValue: Bool?
+        if let telemetry = values["telemetry"] as? Bool {
+            telemetryValue = telemetry
+        } else if let tl = values["tl"] as? Bool {
+            telemetryValue = tl
+        } else {
+            telemetryValue = nil
+        }
+
         self.init(
             streamUrl: values["streamUrl"] as? String
                 ?? values["rtmpUrl"] as? String
@@ -369,7 +381,8 @@ public struct StreamRequest {
             ice: StreamIceConfig(
                 values: (values["ice"] as? [String: Any]) ?? (values["i"] as? [String: Any])
             ),
-            traceId: values["traceId"] as? String
+            traceId: values["traceId"] as? String,
+            telemetry: telemetryValue
         )
     }
 
@@ -397,6 +410,9 @@ public struct StreamRequest {
         if let traceId, !traceId.isEmpty {
             values["traceId"] = traceId
         }
+        if let telemetry {
+            values["telemetry"] = telemetry
+        }
         return values
     }
 }

package/ios/Tests/StreamRequestTests.swift

@@ -0,0 +1,113 @@
+@testable import MentraBluetoothSDK
+import XCTest
+
+final class StreamRequestTests: XCTestCase {
+
+    func testOmissionPreservesBuildDefaultInValues() {
+        let request = StreamRequest(
+            streamUrl: "https://example.com/whip",
+            streamId: "s-1"
+        )
+
+        XCTAssertNil(request.telemetry)
+        XCTAssertNil(request.values["telemetry"])
+        XCTAssertNil(request.values["tl"])
+    }
+
+    func testInitFromValuesPreservesOmissionWhenKeyAbsent() {
+        let request = StreamRequest(values: [
+            "streamUrl": "https://example.com/whip",
+            "streamId": "s-1"
+        ])
+
+        XCTAssertNil(request.telemetry)
+        XCTAssertNil(request.values["telemetry"])
+    }
+
+    func testForwardsExplicitTrueInValues() {
+        let request = StreamRequest(
+            streamUrl: "https://example.com/whip",
+            streamId: "s-1",
+            telemetry: true
+        )
+
+        XCTAssertEqual(request.telemetry, true)
+        XCTAssertEqual(request.values["telemetry"] as? Bool, true)
+    }
+
+    func testInitFromValuesForwardsExplicitTrue() {
+        let request = StreamRequest(values: [
+            "streamUrl": "https://example.com/whip",
+            "streamId": "s-1",
+            "telemetry": true
+        ])
+
+        XCTAssertEqual(request.telemetry, true)
+        XCTAssertEqual(request.values["telemetry"] as? Bool, true)
+    }
+
+    func testForwardsExplicitFalseInValues() {
+        let request = StreamRequest(
+            streamUrl: "https://example.com/whip",
+            streamId: "s-1",
+            telemetry: false
+        )
+
+        XCTAssertEqual(request.telemetry, false)
+        XCTAssertEqual(request.values["telemetry"] as? Bool, false)
+    }
+
+    func testInitFromValuesForwardsExplicitFalse() {
+        let request = StreamRequest(values: [
+            "streamUrl": "https://example.com/whip",
+            "streamId": "s-1",
+            "telemetry": false
+        ])
+
+        XCTAssertEqual(request.telemetry, false)
+        XCTAssertEqual(request.values["telemetry"] as? Bool, false)
+    }
+
+    func testInitFromValuesAcceptsCompactTlKeyWhenTelemetryAbsent() {
+        let request = StreamRequest(values: [
+            "streamUrl": "https://example.com/whip",
+            "tl": true
+        ])
+
+        XCTAssertEqual(request.telemetry, true)
+        XCTAssertEqual(request.values["telemetry"] as? Bool, true)
+    }
+
+    func testInitFromValuesGivesTelemetryPrecedenceOverCompactTl() {
+        let request = StreamRequest(values: [
+            "streamUrl": "https://example.com/whip",
+            "telemetry": false,
+            "tl": true
+        ])
+
+        XCTAssertEqual(request.telemetry, false)
+        XCTAssertEqual(request.values["telemetry"] as? Bool, false)
+    }
+
+    func testFullStreamRequestSerializesAllFields() {
+        let request = StreamRequest(
+            streamUrl: "https://example.com/whip",
+            streamId: "stream-123",
+            sound: false,
+            video: StreamVideoConfig(width: 1280, height: 720, bitrate: 2_000_000, fps: 15),
+            audio: StreamAudioConfig(bitrate: 64000, sampleRate: 48000, echoCancellation: true),
+            authToken: "bearer-token",
+            telemetry: true
+        )
+
+        let values = request.values
+        XCTAssertEqual(values["type"] as? String, "start_stream")
+        XCTAssertEqual(values["streamUrl"] as? String, "https://example.com/whip")
+        XCTAssertEqual(values["streamId"] as? String, "stream-123")
+        XCTAssertEqual(values["sound"] as? Bool, false)
+        XCTAssertEqual(values["authToken"] as? String, "bearer-token")
+        XCTAssertEqual(values["telemetry"] as? Bool, true)
+        XCTAssertNotNil(values["video"])
+        XCTAssertNotNil(values["audio"])
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentra/bluetooth-sdk",
-  "version": "3.2.0-dev.255",
+  "version": "3.2.0-dev.259",
   "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.2.0-dev.255"
+    "@mentra/cloud-protocol": "3.2.0-dev.259"
   },
   "devDependencies": {
     "@types/node": "^25.9.3",

package/src/BluetoothSdk.types.ts

@@ -760,6 +760,8 @@ export type StreamStartRequest = {
    * TEMPORARY: part of the SoftAP diagnostic trace layer.
    */
   traceId?: string
+  authToken?: string
+  telemetry?: boolean
 }
 
 export type StreamKeepAliveRequest = {

package/src/_private/BluetoothSdkModule.ts

@@ -61,6 +61,7 @@ import {
 } from "../BluetoothSdk.types"
 import {warmUpCameraParamsForNative} from "./cameraRequestPayload"
 import {photoRequestParamsForNative} from "./photoRequestPayload"
+import {streamRequestParamsForNative} from "./streamRequestPayload"
 
 /**
  * Private React Native native-module facade.
@@ -669,5 +670,13 @@ NativeBluetoothSdkModule.warmUpCamera = function (params: WarmUpCameraParams) {
   return nativeWarmUpCamera(warmUpCameraParamsForNative(params) as unknown as WarmUpCameraParams)
 }
 
+const nativeStartStream = bindNativeMethod<(params: StreamStartRequest) => Promise<StreamStatusEvent>>(
+  NativeBluetoothSdkModule as unknown as Record<string, unknown>,
+  "startStream",
+)
+NativeBluetoothSdkModule.startStream = function (params: StreamStartRequest) {
+  return nativeStartStream(streamRequestParamsForNative(params) as unknown as StreamStartRequest)
+}
+
 export default NativeBluetoothSdkModule
 export const BluetoothSdk = NativeBluetoothSdkModule as BluetoothSdkInternalModule

package/src/_private/streamRequestPayload.ts

@@ -0,0 +1,43 @@
+import type {StreamStartRequest} from "../BluetoothSdk.types"
+
+/**
+ * Normalizes stream start request parameters for the native module bridge.
+ * Preserves omission of telemetry when undefined so the glasses use their build default,
+ * and forwards explicit true / false.
+ */
+export function streamRequestParamsForNative(params: StreamStartRequest): Record<string, unknown> {
+  const payload: Record<string, unknown> = {
+    streamUrl: params.streamUrl,
+  }
+  if (params.type !== undefined) {
+    payload.type = params.type
+  }
+  if (params.streamId !== undefined) {
+    payload.streamId = params.streamId
+  }
+  if (params.sound !== undefined) {
+    payload.sound = params.sound
+  }
+  if (params.video !== undefined) {
+    payload.video = params.video
+  }
+  if (params.audio !== undefined) {
+    payload.audio = params.audio
+  }
+  if (params.ice !== undefined) {
+    payload.ice = params.ice
+  }
+  if (params.captureAudio !== undefined) {
+    payload.captureAudio = params.captureAudio
+  }
+  if (params.traceId !== undefined && params.traceId.length > 0) {
+    payload.traceId = params.traceId
+  }
+  if (params.authToken !== undefined && params.authToken.length > 0) {
+    payload.authToken = params.authToken
+  }
+  if (params.telemetry !== undefined) {
+    payload.telemetry = params.telemetry
+  }
+  return payload
+}

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.2.0",
-  "releaseIdentity": "3.2.0-dev.255",
-  "releaseSetId": "mentra-3.2.0-dev.255",
-  "sourceCommit": "95dfa6c4b2f341917b687798ff7b0065365d3115",
-  "otaManifestUrl": "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.255.json",
-  "otaManifestSha256": "9816cf655e30e4306c324469ed5ed3eee73d9b76345bc8c6b24e48edf5215837"
+  "releaseIdentity": "3.2.0-dev.259",
+  "releaseSetId": "mentra-3.2.0-dev.259",
+  "sourceCommit": "a813257666fd73103cf743ec50a4a158ed021d41",
+  "otaManifestUrl": "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.2.0/mentra-live-ota-3.2.0-dev.259.json",
+  "otaManifestSha256": "b72673f29592ac9357d40b639d093bd50914c8f6f0f4bb02cf0f4fe03fbf0f38"
 })