@akhilpulse/samadhaan-session-replay 0.6.0 → 0.6.2

package/README.md

@@ -140,8 +140,16 @@ cd ios && pod install
   the first time the assistant opens. If the user denies it, the voice bar
   shows "Mic blocked — allow microphone access in Settings" instead of
   pretending to listen.
-- **iOS** — add `NSMicrophoneUsageDescription` to `Info.plist` or the OS will
-  kill the app when recording starts.
+- **iOS** — add `NSMicrophoneUsageDescription` to `Info.plist` (**required** —
+  without it iOS terminates the app the moment the mic is touched):
+  ```xml
+  <key>NSMicrophoneUsageDescription</key>
+  <string>Needed so the voice assistant can hear you.</string>
+  ```
+  Starting in **0.6.2 the SDK explicitly triggers the system mic prompt** when
+  the assistant opens (via the bundled native module — run `pod install` and
+  rebuild after upgrading). If the user denies it, the voice bar shows
+  "Mic blocked" instead of pretending to listen.
 
 #### Agent voice playback
 
@@ -177,7 +185,7 @@ iOS: `cd ios && pod install && cd .. && npx react-native run-ios`.
 
 - Creates a session against `POST /api/guided-support/sessions` and persists `sessionId` in AsyncStorage so it can be resumed after relaunch.
 - Captures gestures (tap, swipe) using a passive PanResponder + onTouchEnd bubble listener — host taps still work.
-- Captures screenshots every 10 s in background mode, every 200 ms in live mode, via `react-native-view-shot`. Uploads via `POST /api/guided-support/storage/uploads/request-url` then PUTs to the returned URL.
+- Captures screenshots every 10 s in background mode, every 500 ms (~2 fps) in live/assistant mode, via `react-native-view-shot`. Uploads via `POST /api/guided-support/storage/uploads/request-url` then PUTs to the returned URL.
 - Auto-connects to `WS /ws/guided-support?sessionId=…&role=device&token=…` when the dashboard flips the session to `live`.
 - Streams binary frames as `[ts u32 BE | width u16 BE | height u16 BE] + JPEG bytes`.
 - Renders a remote-control overlay that visualizes incoming taps. Native touch dispatch (iOS UIEvent / Android AccessibilityService) is wired by the integrator via a small custom native module.

package/ios/SessionReplayPcmPlayer.m

@@ -148,6 +148,18 @@ RCT_EXPORT_METHOD(stop)
   [self tearDownEngine];
 }
 
+// Explicitly triggers the iOS microphone permission prompt (first call shows
+// the system dialog; later calls resolve with the remembered answer).
+// REQUIRES NSMicrophoneUsageDescription in the host app's Info.plist —
+// without it iOS terminates the app the moment the mic is touched.
+RCT_EXPORT_METHOD(requestMicPermission:(RCTPromiseResolveBlock)resolve
+                  rejecter:(__unused RCTPromiseRejectBlock)reject)
+{
+  [[AVAudioSession sharedInstance] requestRecordPermission:^(BOOL granted) {
+    resolve(@(granted));
+  }];
+}
+
 - (void)invalidate
 {
   [self tearDownEngine];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akhilpulse/samadhaan-session-replay",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "React Native SDK for Samadhaan Guided Support — session recording, live remote screen-share, take-control, guided-tour overlays, and Shake-to-Assist AI voice guide.",
   "main": "src/index.ts",
   "module": "src/index.ts",

package/src/SessionReplayProvider.tsx

@@ -56,7 +56,7 @@ let pixelCopyDisabled = false; // turned true after repeated runtime failures to
 let pixelCopyFailStreak = 0; // consecutive non-busy failures; resets on success
 
 const STORAGE_KEY = "@akhilpulse/samadhaan-session-replay/sessionId";
-const SDK_VERSION = "0.6.0";
+const SDK_VERSION = "0.6.2";
 
 // ---- Module-level session singleton --------------------------------------
 // Multiple SessionReplayProvider mounts (intentional or via React StrictMode's
@@ -370,9 +370,9 @@ export function SessionReplayProvider({ config, children }: { config: Config; ch
     // waste CPU/battery/network on periodic screenshots.
     if (config.disableScreenshots || !sessionId || !streamActive) return;
     let stopped = false;
-    // ~4 fps target — low device load while still feeling responsive. Capture
+    // ~2 fps target — low device load while still feeling responsive. Capture
     // takes time, so the loop self-paces: next tick is scheduled AFTER the previous capture completes.
-    const liveTargetMs = 250;
+    const liveTargetMs = 500;
     let lastUploadFrameAt = 0;
     const tick = async () => {
       if (stopped) return;

package/src/voice.ts

@@ -37,25 +37,44 @@ function loadOptional<T = any>(name: string): T | null {
 /**
  * Android requires a runtime RECORD_AUDIO grant — react-native-live-audio-stream
  * does NOT request it itself; without it the recorder silently captures nothing
- * and the assistant can never hear the user. iOS shows its own prompt when the
- * recorder starts (host app must have NSMicrophoneUsageDescription in Info.plist).
+ * and the assistant can never hear the user.
+ * iOS (SDK 0.6.2+): the bundled native module explicitly triggers the system
+ * mic prompt via AVAudioSession requestRecordPermission. The host app MUST have
+ * NSMicrophoneUsageDescription in Info.plist or iOS kills the app on first use.
+ * On older iOS builds without the native method, we fall through and let the
+ * recorder's own first mic access raise the prompt.
  */
 async function ensureMicPermission(): Promise<boolean> {
-  if (Platform.OS !== "android") return true;
-  try {
-    const perm = PermissionsAndroid.PERMISSIONS.RECORD_AUDIO;
-    const already = await PermissionsAndroid.check(perm);
-    if (already) return true;
-    const res = await PermissionsAndroid.request(perm, {
-      title: "Microphone access",
-      message: "Needed so the voice assistant can hear you.",
-      buttonPositive: "Allow",
-      buttonNegative: "Not now",
-    });
-    return res === PermissionsAndroid.RESULTS.GRANTED;
-  } catch {
-    return false;
+  if (Platform.OS === "android") {
+    try {
+      const perm = PermissionsAndroid.PERMISSIONS.RECORD_AUDIO;
+      const already = await PermissionsAndroid.check(perm);
+      if (already) return true;
+      const res = await PermissionsAndroid.request(perm, {
+        title: "Microphone access",
+        message: "Needed so the voice assistant can hear you.",
+        buttonPositive: "Allow",
+        buttonNegative: "Not now",
+      });
+      return res === PermissionsAndroid.RESULTS.GRANTED;
+    } catch {
+      return false;
+    }
+  }
+  if (Platform.OS === "ios") {
+    const native: any = (NativeModules as any).SessionReplayPcmPlayer;
+    if (native && typeof native.requestMicPermission === "function") {
+      try {
+        return !!(await native.requestMicPermission());
+      } catch {
+        // Native call failed — don't block; recorder start may still prompt.
+        return true;
+      }
+    }
+    // Old build without the native method — recorder start triggers the prompt.
+    return true;
   }
+  return true;
 }
 
 /** Why voice input isn't working (surfaced so the UI can tell the user). */