@mentra/bluetooth-sdk 0.1.11 → 0.1.12

package/ios/Source/sgcs/SGCManager.swift

@@ -31,9 +31,16 @@ protocol SGCManager {
     /// Defaulted in an extension to delegate to the basic recording path; devices
     /// that support custom settings (e.g. Mentra Live) override this.
     func startVideoRecording(
-        requestId: String, save: Bool, flash: Bool, sound: Bool, width: Int, height: Int, fps: Int
+        requestId: String, save: Bool, flash: Bool, sound: Bool, width: Int, height: Int, fps: Int,
+        maxRecordingTimeMinutes: Int
     )
     func stopVideoRecording(requestId: String)
+    /// Stop recording and upload the result to `webhookUrl` (multipart) using
+    /// `authToken`. Supplied at stop time so the token is fresh when the upload
+    /// runs. Defaulted in an extension to ignore the upload target and just stop;
+    /// devices that support webhook upload (e.g. Mentra Live) override this. An
+    /// empty/nil `webhookUrl` means "keep the video on device".
+    func stopVideoRecording(requestId: String, webhookUrl: String?, authToken: String?)
 
     // MARK: - Button Settings
 
@@ -145,11 +152,15 @@ extension SGCManager {
 
     func startVideoRecording(
         requestId: String, save: Bool, flash: Bool, sound: Bool, width _: Int, height _: Int,
-        fps _: Int
+        fps _: Int, maxRecordingTimeMinutes _: Int
     ) {
         startVideoRecording(requestId: requestId, save: save, flash: flash, sound: sound)
     }
 
+    func stopVideoRecording(requestId: String, webhookUrl _: String?, authToken _: String?) {
+        stopVideoRecording(requestId: requestId)
+    }
+
     // MARK: - Dashboard (default: combined wire format; Nex implements single-field)
 
     func setDashboardHeightOnly(_ height: Int) {

package/ios/Source/types/DeviceModels.swift

@@ -3,7 +3,11 @@ import Foundation
 public struct MentraBluetoothSDKConfiguration {
     public static let `default` = MentraBluetoothSDKConfiguration()
 
-    public init() {}
+    public let analytics: BluetoothSdkAnalyticsConfiguration
+
+    public init(analytics: BluetoothSdkAnalyticsConfiguration = BluetoothSdkAnalyticsConfiguration()) {
+        self.analytics = analytics
+    }
 }
 
 public enum DeviceModel: String {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mentra/bluetooth-sdk",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "description": "SDK for communicating with smart glasses",
   "main": "build/index.js",
   "react-native": "src/index.ts",

package/plugin/build/index.d.ts

@@ -1,6 +1,10 @@
 import { type ConfigPlugin } from "expo/config-plugins";
 export interface BluetoothSdkPluginProps {
     node?: boolean;
+    analytics?: boolean | BluetoothSdkAnalyticsPluginProps;
+}
+export interface BluetoothSdkAnalyticsPluginProps {
+    enabled?: boolean;
 }
 declare const withBluetoothSdk: ConfigPlugin<BluetoothSdkPluginProps>;
 export default withBluetoothSdk;

package/plugin/build/withAndroid.d.ts

@@ -1,4 +1,3 @@
 import { type ConfigPlugin } from "expo/config-plugins";
-export declare const withAndroidConfiguration: ConfigPlugin<{
-    node?: boolean;
-}>;
+import { type BluetoothSdkPluginProps } from "./index";
+export declare const withAndroidConfiguration: ConfigPlugin<BluetoothSdkPluginProps>;

package/plugin/build/withAndroid.js

@@ -7,6 +7,10 @@ exports.withAndroidConfiguration = void 0;
 const child_process_1 = require("child_process");
 const path_1 = __importDefault(require("path"));
 const config_plugins_1 = require("expo/config-plugins");
+const META_ANALYTICS_DISABLED = "com.mentra.bluetoothsdk.analytics.disabled";
+const STALE_META_POSTHOG_API_KEY = "com.mentra.bluetoothsdk.analytics.posthog_api_key";
+const STALE_META_POSTHOG_HOST = "com.mentra.bluetoothsdk.analytics.posthog_host";
+const ANALYTICS_META_NAMES = [META_ANALYTICS_DISABLED, STALE_META_POSTHOG_API_KEY, STALE_META_POSTHOG_HOST];
 function getBluetoothSdkRoot() {
     return path_1.default.dirname(require.resolve("../../package.json"));
 }
@@ -133,9 +137,51 @@ function withSherpaOnnxLocalMavenRepo(config) {
         return config;
     });
 }
+function resolveAnalyticsProps(props) {
+    const analytics = props?.analytics;
+    let disabled;
+    if (analytics === false) {
+        disabled = true;
+    }
+    else if (analytics === true) {
+        disabled = false;
+    }
+    else if (typeof analytics === "object" && analytics.enabled !== undefined) {
+        disabled = !analytics.enabled;
+    }
+    return {
+        disabled,
+    };
+}
+function upsertMetaData(application, name, value) {
+    application["meta-data"] ??= [];
+    const existing = application["meta-data"].find((item) => item.$?.["android:name"] === name);
+    const entry = existing ?? { $: { "android:name": name } };
+    entry.$["android:value"] = value;
+    if (!existing) {
+        application["meta-data"].push(entry);
+    }
+}
+function removeMetaData(application, name) {
+    application["meta-data"] = (application["meta-data"] ?? []).filter((item) => item.$?.["android:name"] !== name);
+}
+function withAnalyticsManifestMetadata(config, props) {
+    return (0, config_plugins_1.withAndroidManifest)(config, (config) => {
+        const analytics = resolveAnalyticsProps(props);
+        const application = config_plugins_1.AndroidConfig.Manifest.getMainApplicationOrThrow(config.modResults);
+        for (const name of ANALYTICS_META_NAMES) {
+            removeMetaData(application, name);
+        }
+        if (analytics.disabled !== undefined) {
+            upsertMetaData(application, META_ANALYTICS_DISABLED, analytics.disabled ? "true" : "false");
+        }
+        return config;
+    });
+}
 const withAndroidConfiguration = (config, props) => {
     config = withSettingsGradleModifications(config);
     config = withSherpaOnnxLocalMavenRepo(config);
+    config = withAnalyticsManifestMetadata(config, props);
     if (props?.node) {
         config = withGradlePropertiesModifications(config);
     }

package/plugin/build/withIos.d.ts

@@ -1,4 +1,3 @@
 import { type ConfigPlugin } from "expo/config-plugins";
-export declare const withIosConfiguration: ConfigPlugin<{
-    node?: boolean;
-}>;
+import { type BluetoothSdkPluginProps } from "./index";
+export declare const withIosConfiguration: ConfigPlugin<BluetoothSdkPluginProps>;

package/plugin/build/withIos.js

@@ -10,6 +10,9 @@ const path_1 = __importDefault(require("path"));
 const config_plugins_1 = require("expo/config-plugins");
 const BLUETOOTH_SDK_EXPO_ADAPTER_ENV = "MENTRA_BLUETOOTH_SDK_INCLUDE_EXPO_ADAPTER";
 const BLUETOOTH_SDK_EXPO_ADAPTER_LINE = `ENV['${BLUETOOTH_SDK_EXPO_ADAPTER_ENV}'] ||= '1'`;
+const INFO_ANALYTICS_DISABLED = "MentraBluetoothSdkAnalyticsDisabled";
+const STALE_INFO_POSTHOG_API_KEY = "MentraBluetoothSdkPostHogApiKey";
+const STALE_INFO_POSTHOG_HOST = "MentraBluetoothSdkPostHogHost";
 const ensureBluetoothSdkExpoAdapterPodEnv = (podfile) => {
     if (podfile.includes(BLUETOOTH_SDK_EXPO_ADAPTER_ENV)) {
         return podfile;
@@ -51,11 +54,40 @@ const withXcodeEnvLocal = (config) => {
         },
     ]);
 };
+function resolveAnalyticsProps(props) {
+    const analytics = props?.analytics;
+    let disabled;
+    if (analytics === false) {
+        disabled = true;
+    }
+    else if (analytics === true) {
+        disabled = false;
+    }
+    else if (typeof analytics === "object" && analytics.enabled !== undefined) {
+        disabled = !analytics.enabled;
+    }
+    return {
+        disabled,
+    };
+}
+function withAnalyticsInfoPlist(config, props) {
+    return (0, config_plugins_1.withInfoPlist)(config, (config) => {
+        const analytics = resolveAnalyticsProps(props);
+        delete config.modResults[INFO_ANALYTICS_DISABLED];
+        delete config.modResults[STALE_INFO_POSTHOG_API_KEY];
+        delete config.modResults[STALE_INFO_POSTHOG_HOST];
+        if (analytics.disabled !== undefined) {
+            config.modResults[INFO_ANALYTICS_DISABLED] = analytics.disabled;
+        }
+        return config;
+    });
+}
 const withIosConfiguration = (config, props) => {
     config = (0, config_plugins_1.withPodfile)(config, (config) => {
         config.modResults.contents = ensureBluetoothSdkExpoAdapterPodEnv(config.modResults.contents);
         return config;
     });
+    config = withAnalyticsInfoPlist(config, props);
     if (props?.node) {
         config = withXcodeEnvLocal(config);
     }

package/src/BluetoothSdk.types.ts

@@ -307,6 +307,24 @@ export type VideoRecordingSuccessStatusEvent =
   | VideoRecordingStartedStatusEvent
   | VideoRecordingStoppedStatusEvent
 
+export type MediaUploadSuccessEvent = {
+  type: "media_success"
+  requestId: string
+  mediaUrl: string
+  mediaType: number
+  timestamp: number
+}
+
+export type MediaUploadErrorEvent = {
+  type: "media_error"
+  requestId: string
+  errorMessage: string
+  mediaType: number
+  timestamp: number
+}
+
+export type MediaUploadEvent = MediaUploadSuccessEvent | MediaUploadErrorEvent
+
 export type GalleryStatusEvent = {
   type: "gallery_status"
   photos: number
@@ -416,6 +434,12 @@ export interface VideoRecordingSettings {
   width?: number
   height?: number
   fps?: number
+  /**
+   * Optional auto-stop timer in minutes, sent on `start_video_recording`.
+   * `0` (the default) means record until stopped or interrupted
+   * (battery/storage/thermal/error).
+   */
+  maxRecordingTimeMinutes?: number
 }
 export const DeviceModels = {
   Simulated: "Simulated Glasses",
@@ -743,6 +767,8 @@ export type BluetoothSdkModuleEvents = {
   photo_response: (event: PhotoResponseEvent) => void
   photo_status: (event: PhotoStatusEvent) => void
   video_recording_status: (event: VideoRecordingStatusEvent) => void
+  media_success: (event: MediaUploadSuccessEvent) => void
+  media_error: (event: MediaUploadErrorEvent) => void
   gallery_status: (event: GalleryStatusEvent) => void
   compatible_glasses_search_stop: (event: CompatibleGlassesSearchStopEvent) => void
   heartbeat_sent: (event: HeartbeatSentEvent) => void
@@ -818,6 +844,8 @@ export type BluetoothSdkEventMap = {
   photo_response: PhotoResponseEvent
   photo_status: PhotoStatusEvent
   video_recording_status: VideoRecordingStatusEvent
+  media_success: MediaUploadSuccessEvent
+  media_error: MediaUploadErrorEvent
   gallery_status: GalleryStatusEvent
   compatible_glasses_search_stop: CompatibleGlassesSearchStopEvent
   swipe_volume_status: SwipeVolumeStatusEvent
@@ -898,7 +926,18 @@ export interface BluetoothSdkPublicModule {
     sound: boolean,
     settings?: VideoRecordingSettings,
   ): Promise<VideoRecordingStartedStatusEvent>
-  stopVideoRecording(requestId: string): Promise<VideoRecordingStoppedStatusEvent>
+  /**
+   * Stop the active recording. When {@link webhookUrl} is provided, the glasses
+   * upload the recorded video to it (multipart) using {@link authToken}. These
+   * are supplied at stop time (not start) so the token is fresh when the upload
+   * runs — a recording can last arbitrarily long. An empty/omitted webhook keeps
+   * the video on device (no upload).
+   */
+  stopVideoRecording(
+    requestId: string,
+    webhookUrl?: string,
+    authToken?: string,
+  ): Promise<VideoRecordingStoppedStatusEvent>
 
   startStream(params: StreamStartRequest): Promise<StreamStatusEvent>
   stopStream(): Promise<StreamStatusEvent>

package/src/_private/BluetoothSdkModule.ts

@@ -148,7 +148,11 @@ declare class BluetoothSdkNativeModule extends NativeModule<BluetoothSdkModuleEv
     sound: boolean,
     settings?: VideoRecordingSettings,
   ): Promise<VideoRecordingStartedStatusEvent>
-  stopVideoRecording(requestId: string): Promise<VideoRecordingStoppedStatusEvent>
+  stopVideoRecording(
+    requestId: string,
+    webhookUrl?: string,
+    authToken?: string,
+  ): Promise<VideoRecordingStoppedStatusEvent>
 
   // Stream Commands
   startStream(params: StreamStartRequest): Promise<StreamStatusEvent>

package/src/index.ts

@@ -21,6 +21,8 @@ const PUBLIC_EVENT_NAMES = new Set<BluetoothSdkEventName>([
   "photo_response",
   "photo_status",
   "video_recording_status",
+  "media_success",
+  "media_error",
   "gallery_status",
   "compatible_glasses_search_stop",
   "swipe_volume_status",