@akhilpulse/samadhaan-session-replay 0.6.1 → 0.6.3

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
 

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.1",
+  "version": "0.6.3",
   "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.1";
+const SDK_VERSION = "0.6.3";
 
 // ---- Module-level session singleton --------------------------------------
 // Multiple SessionReplayProvider mounts (intentional or via React StrictMode's
@@ -857,36 +857,6 @@ export function SessionReplayProvider({ config, children }: { config: Config; ch
           </>
         )}
 
-        {/* Shake-to-Assist: on-screen arrow pointing at the next element to tap. */}
-        {assistantActive && assistantArrow && (() => {
-          const { w, h } = viewSizeRef.current;
-          const px = assistantArrow.nx * (w || 0);
-          const py = assistantArrow.ny * (h || 0);
-          // Keep the label bubble on-screen: flip below the target near the top edge.
-          const below = py < 96;
-          return (
-            <View pointerEvents="none" style={StyleSheet.absoluteFill}>
-              <View style={[styles.assistHalo, { left: px - 26, top: py - 26 }]} />
-              <View style={[styles.assistDot, { left: px - 9, top: py - 9 }]} />
-              {/* Arrow shaft pointing down at the target (or up when flipped). */}
-              <View
-                style={[
-                  styles.assistArrow,
-                  below
-                    ? { left: px - 9, top: py + 12 }
-                    : { left: px - 9, top: py - 30, transform: [{ rotate: "180deg" }] },
-                ]}
-              />
-              {!!(assistantArrow.label || assistantArrow.instruction) && (
-                <View style={[styles.assistBubble, { left: 16, right: 16, [below ? "top" : "bottom"]: below ? py + 36 : (h || 0) - py + 36 } as any]}>
-                  {!!assistantArrow.label && <Text style={styles.assistBubbleLabel}>{assistantArrow.label}</Text>}
-                  {!!assistantArrow.instruction && <Text style={styles.assistBubbleText}>{assistantArrow.instruction}</Text>}
-                </View>
-              )}
-            </View>
-          );
-        })()}
-
         {/* Floating help button — draggable, tap to open the AI voice guide.
             This is the definitive trigger for Expo apps (no native shake module).
             Hidden during guided tours so it never collides with the End-tour pill. */}
@@ -925,12 +895,81 @@ export function SessionReplayProvider({ config, children }: { config: Config; ch
             </View>
           </View>
         )}
+
+        {/* Shake-to-Assist: on-screen arrow pointing at the next element to tap.
+            Rendered LAST so it draws above the bottom voice dock — targets near
+            the bottom of the screen used to be hidden underneath it. */}
+        {assistantActive && assistantArrow && (
+          <AssistArrowOverlay
+            nx={assistantArrow.nx}
+            ny={assistantArrow.ny}
+            label={assistantArrow.label}
+            instruction={assistantArrow.instruction}
+            w={viewSizeRef.current.w}
+            h={viewSizeRef.current.h}
+          />
+        )}
       </View>
     </SessionReplayContext.Provider>
   );
 }
 
 // ---- Shake-to-Assist UI bits ----
+
+/**
+ * Pulsing arrow + label bubble pointing at the next element to tap.
+ * - Halo pulses continuously so the target is hard to miss.
+ * - The label bubble is clamped so it never hides behind the bottom voice dock
+ *   (which occupies roughly the bottom 110px of the screen).
+ */
+function AssistArrowOverlay({
+  nx, ny, label, instruction, w, h,
+}: { nx: number; ny: number; label?: string; instruction?: string; w: number; h: number }) {
+  const pulse = useRef(new Animated.Value(0)).current;
+  useEffect(() => {
+    const loop = Animated.loop(
+      Animated.sequence([
+        Animated.timing(pulse, { toValue: 1, duration: 650, useNativeDriver: true }),
+        Animated.timing(pulse, { toValue: 0, duration: 650, useNativeDriver: true }),
+      ])
+    );
+    loop.start();
+    return () => loop.stop();
+  }, [pulse]);
+
+  const px = nx * (w || 0);
+  const py = ny * (h || 0);
+  // Keep the label bubble on-screen: flip below the target near the top edge.
+  const below = py < 96;
+  // Never let the bubble sink behind the bottom voice dock (~110px tall).
+  const bubbleBottom = Math.max((h || 0) - py + 36, 122);
+  const scale = pulse.interpolate({ inputRange: [0, 1], outputRange: [1, 1.45] });
+  const opacity = pulse.interpolate({ inputRange: [0, 1], outputRange: [1, 0.35] });
+
+  return (
+    <View pointerEvents="none" style={StyleSheet.absoluteFill}>
+      <Animated.View
+        style={[styles.assistHalo, { left: px - 26, top: py - 26, transform: [{ scale }], opacity }]}
+      />
+      <View style={[styles.assistDot, { left: px - 9, top: py - 9 }]} />
+      {/* Arrow shaft pointing down at the target (or up when flipped). */}
+      <View
+        style={[
+          styles.assistArrow,
+          below
+            ? { left: px - 9, top: py + 12 }
+            : { left: px - 9, top: py - 30, transform: [{ rotate: "180deg" }] },
+        ]}
+      />
+      {!!(label || instruction) && (
+        <View style={[styles.assistBubble, { left: 16, right: 16, [below ? "top" : "bottom"]: below ? py + 36 : bubbleBottom } as any]}>
+          {!!label && <Text style={styles.assistBubbleLabel}>{label}</Text>}
+          {!!instruction && <Text style={styles.assistBubbleText}>{instruction}</Text>}
+        </View>
+      )}
+    </View>
+  );
+}
 function assistantStatusLabel(phase: AssistantPhase, micStatus?: MicStatus | null): string {
   // Be honest when we can't actually hear the user — a fake "Listening…"
   // with a dead mic is the worst possible UX (bar stuck forever).

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). */