yaver-feedback-react-native 0.7.13 → 0.7.15

package/app.plugin.js

@@ -188,9 +188,22 @@ function withYaverAppDelegateHook(config) {
       );
     }
 
-    // 2. Add reload notification handler and bridge recreation logic
-    // Insert before the closing brace of the class
-    const classCloseIndex = patched.lastIndexOf("}");
+    // 2. Add reload notification handler and bridge recreation logic.
+    //
+    // Must be inserted into the AppDelegate class — NOT ReactNativeDelegate
+    // (a separate class below it in the same file). The handler accesses
+    // `self.window`, `self.reactNativeDelegate`, `self.reactNativeFactory`,
+    // and `self.bindReactNativeFactory(...)` — all of which only exist
+    // on AppDelegate. An earlier version of this plugin used
+    // lastIndexOf("}"), which in modern Expo templates lands inside
+    // ReactNativeDelegate, producing build errors like
+    //   "cannot find 'setupYaverHotReload' in scope"
+    //   "value of type 'ReactNativeDelegate' has no member 'window'"
+    //
+    // The anchor we want is the closing brace of the AppDelegate class
+    // declaration itself. Find its opening, then walk braces to its
+    // matching close.
+    const classCloseIndex = findAppDelegateClassClose(patched);
     if (classCloseIndex > 0) {
       const reloadHandler = `
   // MARK: - Yaver Feedback SDK Hot Reload
@@ -257,8 +270,15 @@ function withYaverAppDelegateHook(config) {
     DispatchQueue.main.asyncAfter(deadline: .now() + 0.3) { [weak self] in
       guard let self = self else { return }
 
+      // No explicit override needed — the new delegate's bundleURL()
+      // has a patched branch that calls YaverHotReload.bundleURL()
+      // first, which returns the file we just saved. That avoids
+      // relying on a non-existent overrideBundleURL property on
+      // ExpoReactNativeFactoryDelegate (which is what errored out in
+      // 0.7.14's build on Expo SDK 54+).
+      _ = bundleURL  // silence "unused" warning; the file path was
+                    // baked into YaverHotReload by loadBundle() above
       let delegate = ReactNativeDelegate()
-      delegate.overrideBundleURL = bundleURL
       delegate.dependencyProvider = RCTAppDependencyProvider()
 
       let factory = ExpoReactNativeFactory(delegate: delegate)
@@ -298,6 +318,34 @@ function withYaverAppDelegateHook(config) {
   });
 }
 
+// Locate the closing brace of `class AppDelegate: ...` in an Expo
+// Swift AppDelegate file. Returns the index of the matching `}` for
+// the AppDelegate class's opening `{`, or -1 if not found. We need
+// this because Expo's modern template declares TWO classes in the
+// same file (AppDelegate + ReactNativeDelegate), and the SDK's
+// reload handler only makes sense on the AppDelegate one.
+function findAppDelegateClassClose(contents) {
+  // Match both `public class AppDelegate` and `class AppDelegate`,
+  // with either inheritance colon or a plain body.
+  const headerMatch = contents.match(/class\s+AppDelegate\s*[:{][^{]*\{/);
+  if (!headerMatch) return -1;
+  const bodyStart = headerMatch.index + headerMatch[0].length - 1; // index of the opening `{`
+  // Walk braces to find the matching close. Minimal — we don't try
+  // to parse strings/comments because the file is machine-generated
+  // by Expo, so braces inside strings are not a realistic concern
+  // at this layer.
+  let depth = 0;
+  for (let i = bodyStart; i < contents.length; i++) {
+    const ch = contents[i];
+    if (ch === "{") depth++;
+    else if (ch === "}") {
+      depth--;
+      if (depth === 0) return i;
+    }
+  }
+  return -1;
+}
+
 /**
  * Copy Android native module source files and register the package.
  * Also patches MainApplication to use hot-reloaded bundle on startup.

package/dist/FeedbackModal.js

@@ -47,6 +47,10 @@ const FeedbackModal = () => {
     const [toast, setToast] = (0, react_1.useState)(null);
     const [progress, setProgress] = (0, react_1.useState)(null);
     const [isRecordingVideo, setIsRecordingVideo] = (0, react_1.useState)(false);
+    const [isRecordingVoice, setIsRecordingVoice] = (0, react_1.useState)(false);
+    // Cached once on mount — bare-RN apps without expo-av get a clean
+    // hidden button instead of a runtime error.
+    const voiceSupported = (0, react_1.useRef)((0, capture_1.isVoiceCaptureSupported)()).current;
     const [lastVideo, setLastVideo] = (0, react_1.useState)(null);
     const mountedRef = (0, react_1.useRef)(true);
     (0, react_1.useEffect)(() => {
@@ -324,6 +328,97 @@ const FeedbackModal = () => {
             }
         }
     }, [isRecordingVideo]);
+    // ─── Voice note: record → transcribe → send as feedback ───────────
+    // Tap once to start; tap again to stop. On stop: upload the audio
+    // to the agent's /voice/transcribe (which routes through whichever
+    // STT provider is configured — Whisper / Deepgram / OpenAI / etc.),
+    // then file the transcript as a bug report. The audio file itself
+    // is also attached to the feedback bundle so the agent can re-play
+    // it if the transcript is wrong.
+    const handleToggleVoice = (0, react_1.useCallback)(async () => {
+        setError(null);
+        if (!isRecordingVoice) {
+            try {
+                await (0, capture_1.startAudioRecording)();
+                if (mountedRef.current) {
+                    setIsRecordingVoice(true);
+                    setAction('recording-voice');
+                    setToast('Recording voice note…');
+                }
+            }
+            catch (err) {
+                setIsRecordingVoice(false);
+                setAction('idle');
+                setError(err instanceof Error ? err.message : String(err));
+            }
+            return;
+        }
+        // Stopping → transcribe → send.
+        try {
+            const audio = await (0, capture_1.stopAudioRecording)();
+            setIsRecordingVoice(false);
+            if (!audio) {
+                setAction('idle');
+                return;
+            }
+            setAction('transcribing-voice');
+            setToast('Transcribing…');
+            const config = YaverFeedback_1.YaverFeedback.getConfig();
+            if (!config?.agentUrl) {
+                setError('Not connected to the agent yet.');
+                setAction('idle');
+                return;
+            }
+            let transcript = '';
+            try {
+                const client = YaverFeedback_1.YaverFeedback.getP2PClient();
+                if (client) {
+                    const res = await client.transcribeVoice(audio.path);
+                    transcript = res.text ?? '';
+                }
+            }
+            catch {
+                // Transcription can fail (no STT provider configured on the
+                // agent, network blip, etc.). Don't block the flow — ship
+                // the raw audio file with a "[no transcript]" note so the
+                // agent + human reviewer can still play it back.
+            }
+            const { Dimensions } = require('react-native');
+            const { width, height } = Dimensions.get('window');
+            const deviceInfo = {
+                platform: react_native_1.Platform.OS,
+                osVersion: String(react_native_1.Platform.Version),
+                model: react_native_1.Platform.OS === 'ios' ? 'iOS Device' : 'Android Device',
+                screenWidth: width,
+                screenHeight: height,
+            };
+            const bundle = {
+                metadata: {
+                    timestamp: new Date().toISOString(),
+                    device: deviceInfo,
+                    app: {},
+                    userNote: transcript.length > 0
+                        ? `[Voice note] ${transcript}`
+                        : `[Voice note · ${Math.round(audio.duration)}s — transcription unavailable]`,
+                },
+                screenshots: [],
+                audio: audio.path,
+                errors: YaverFeedback_1.YaverFeedback.getCapturedErrors().length
+                    ? YaverFeedback_1.YaverFeedback.getCapturedErrors()
+                    : undefined,
+            };
+            await (0, upload_1.uploadFeedback)(config.agentUrl, config.authToken ?? '', bundle);
+            setToast(transcript ? `Sent: "${transcript.slice(0, 60)}${transcript.length > 60 ? '…' : ''}"` : 'Voice note sent');
+            closeSoon(1800);
+        }
+        catch (err) {
+            setError(err instanceof Error ? err.message : String(err));
+        }
+        finally {
+            if (mountedRef.current)
+                setAction('idle');
+        }
+    }, [isRecordingVoice, closeSoon]);
     // ─── 5. Send the last recorded video ───────────────────────────────
     const handleSendVideo = (0, react_1.useCallback)(async () => {
         const config = YaverFeedback_1.YaverFeedback.getConfig();
@@ -397,6 +492,15 @@ const FeedbackModal = () => {
               {/* 3. Vibing */}
               <ActionRow label={action === 'vibing' ? 'Starting…' : 'Vibing'} tint="#818cf8" onPress={handleVibing} disabled={busy} busy={action === 'vibing'}/>
 
+              {/* Voice note — only rendered when expo-av is installed.
+                Tap to start, tap again to stop → transcribes via
+                the agent and files as a feedback report. */}
+              {voiceSupported && (<ActionRow label={action === 'transcribing-voice'
+                    ? 'Transcribing…'
+                    : isRecordingVoice
+                        ? 'Stop & Send Voice'
+                        : 'Voice Note'} tint={isRecordingVoice ? '#ef4444' : '#f472b6'} onPress={handleToggleVoice} disabled={busy && action !== 'recording-voice' && action !== 'idle'} busy={action === 'transcribing-voice'}/>)}
+
               {/* 4. Start/Stop Recording */}
               <ActionRow label={isRecordingVideo ? 'Stop Recording' : 'Start Recording'} tint={isRecordingVideo ? '#ef4444' : '#60a5fa'} onPress={handleToggleRecording} disabled={busy && action !== 'idle' && !isRecordingVideo}/>
 

package/dist/capture.d.ts

@@ -1,15 +1,17 @@
 /**
- * Screen capture helpers — screenshot + video recording.
+ * Screen capture helpers — screenshot + video + voice recording.
  *
  * Peer deps (all optional — loaded lazily):
  *   - `react-native-view-shot`        — screenshot
  *   - `react-native-record-screen`    — video recording (iOS ReplayKit /
  *                                       Android MediaProjection)
+ *   - `expo-av`                       — audio recording for voice notes
  *
  * Each helper surfaces a clear error if the module is missing so a host
- * app knows exactly which peer dep to add. Audio-note / voice-command
- * recording was removed in 0.7.0 — see FeedbackModal for the new
- * 5-button surface.
+ * app knows exactly which peer dep to add. Voice-note capture was
+ * removed in 0.7.0 and re-added in 0.7.14 as a narrow, "press to
+ * record → stop → transcribe via the agent → attach to feedback" flow.
+ * The broader live/narrated/batch modes from pre-0.7.0 stay removed.
  */
 /**
  * Capture the current screen as a PNG image.
@@ -38,3 +40,26 @@ export declare function stopVideoRecording(): Promise<{
 }>;
 /** Whether a video recording is currently active. */
 export declare function isVideoRecording(): boolean;
+/**
+ * Returns true if `expo-av` is installed and Audio.Recording is
+ * available — lets the modal hide the voice button in apps that
+ * haven't installed the peer dep, instead of throwing on tap.
+ */
+export declare function isVoiceCaptureSupported(): boolean;
+/**
+ * Begin recording audio from the device microphone. Requests
+ * microphone permission on first use. Resolves once recording has
+ * actually started, so the UI can flip to "Stop" immediately.
+ */
+export declare function startAudioRecording(): Promise<void>;
+/**
+ * Stop the current audio recording and return the on-device file path
+ * (usually a .m4a on iOS / .3gp on Android). Returns null if no
+ * recording was active.
+ */
+export declare function stopAudioRecording(): Promise<{
+    path: string;
+    duration: number;
+} | null>;
+/** Whether a voice-note recording is currently active. */
+export declare function isAudioRecording(): boolean;

package/dist/capture.js

@@ -1,22 +1,28 @@
 "use strict";
 /**
- * Screen capture helpers — screenshot + video recording.
+ * Screen capture helpers — screenshot + video + voice recording.
  *
  * Peer deps (all optional — loaded lazily):
  *   - `react-native-view-shot`        — screenshot
  *   - `react-native-record-screen`    — video recording (iOS ReplayKit /
  *                                       Android MediaProjection)
+ *   - `expo-av`                       — audio recording for voice notes
  *
  * Each helper surfaces a clear error if the module is missing so a host
- * app knows exactly which peer dep to add. Audio-note / voice-command
- * recording was removed in 0.7.0 — see FeedbackModal for the new
- * 5-button surface.
+ * app knows exactly which peer dep to add. Voice-note capture was
+ * removed in 0.7.0 and re-added in 0.7.14 as a narrow, "press to
+ * record → stop → transcribe via the agent → attach to feedback" flow.
+ * The broader live/narrated/batch modes from pre-0.7.0 stay removed.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.captureScreenshot = captureScreenshot;
 exports.startVideoRecording = startVideoRecording;
 exports.stopVideoRecording = stopVideoRecording;
 exports.isVideoRecording = isVideoRecording;
+exports.isVoiceCaptureSupported = isVoiceCaptureSupported;
+exports.startAudioRecording = startAudioRecording;
+exports.stopAudioRecording = stopAudioRecording;
+exports.isAudioRecording = isAudioRecording;
 /**
  * Capture the current screen as a PNG image.
  * Requires `react-native-view-shot` to be installed.
@@ -111,3 +117,105 @@ async function stopVideoRecording() {
 function isVideoRecording() {
     return videoRecordingActive;
 }
+// ── Voice note recording ────────────────────────────────────────────
+//
+// Short audio recording, stopped on user tap. Lazy-loaded via expo-av —
+// the SDK doesn't declare a hard dep on it so bare-RN apps that don't
+// have Expo can still install the SDK. If expo-av is missing, the
+// helpers throw a clear error and the modal's voice button gracefully
+// hides itself.
+let audioRecorderRef = null;
+let audioRecorderActive = false;
+function loadExpoAvOrThrow() {
+    try {
+        const mod = require('expo-av');
+        if (!mod?.Audio?.Recording) {
+            throw new Error('expo-av is installed but missing Audio.Recording');
+        }
+        return mod;
+    }
+    catch (err) {
+        throw new Error('[YaverFeedback] Voice notes need `expo-av` as a peer dependency. ' +
+            'Add it with `npx expo install expo-av` and rebuild. ' +
+            String(err));
+    }
+}
+/**
+ * Returns true if `expo-av` is installed and Audio.Recording is
+ * available — lets the modal hide the voice button in apps that
+ * haven't installed the peer dep, instead of throwing on tap.
+ */
+function isVoiceCaptureSupported() {
+    try {
+        const mod = require('expo-av');
+        return !!mod?.Audio?.Recording;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Begin recording audio from the device microphone. Requests
+ * microphone permission on first use. Resolves once recording has
+ * actually started, so the UI can flip to "Stop" immediately.
+ */
+async function startAudioRecording() {
+    if (audioRecorderActive) {
+        throw new Error('[YaverFeedback] An audio recording is already in progress.');
+    }
+    const ExpoAv = loadExpoAvOrThrow();
+    const { Audio } = ExpoAv;
+    const perm = await Audio.requestPermissionsAsync();
+    if (!perm.granted) {
+        throw new Error('[YaverFeedback] Microphone permission denied. Enable it in Settings ▸ Your App ▸ Microphone.');
+    }
+    // Use the iOS/Android high-quality preset — transcription providers
+    // (Whisper / Deepgram / OpenAI) prefer 16 kHz+ mono but also handle
+    // the higher sample rates fine. Default preset is portable.
+    await Audio.setAudioModeAsync({
+        allowsRecordingIOS: true,
+        playsInSilentModeIOS: true,
+        staysActiveInBackground: false,
+    });
+    const recording = new Audio.Recording();
+    await recording.prepareToRecordAsync(Audio.RecordingOptionsPresets.HIGH_QUALITY);
+    await recording.startAsync();
+    audioRecorderRef = recording;
+    audioRecorderActive = true;
+}
+/**
+ * Stop the current audio recording and return the on-device file path
+ * (usually a .m4a on iOS / .3gp on Android). Returns null if no
+ * recording was active.
+ */
+async function stopAudioRecording() {
+    if (!audioRecorderActive || !audioRecorderRef)
+        return null;
+    const recording = audioRecorderRef;
+    audioRecorderRef = null;
+    audioRecorderActive = false;
+    try {
+        await recording.stopAndUnloadAsync();
+    }
+    catch {
+        // Second stop calls throw; ignore and use whatever state we have.
+    }
+    const uri = typeof recording.getURI === 'function' ? recording.getURI() : null;
+    if (!uri) {
+        throw new Error('[YaverFeedback] Audio recording produced no file.');
+    }
+    let durationMs = 0;
+    try {
+        const status = await recording.getStatusAsync();
+        durationMs = status?.durationMillis ?? 0;
+    }
+    catch {
+        // Status can fail after unload; leave duration at 0, transcription
+        // still works.
+    }
+    return { path: uri, duration: durationMs / 1000 };
+}
+/** Whether a voice-note recording is currently active. */
+function isAudioRecording() {
+    return audioRecorderActive;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yaver-feedback-react-native",
-  "version": "0.7.13",
+  "version": "0.7.15",
   "description": "Visual feedback SDK for Yaver — bug reports, screen recording, voice annotations, and local-first developer workflows",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/FeedbackModal.tsx

@@ -14,6 +14,9 @@ import {
   captureScreenshot,
   startVideoRecording,
   stopVideoRecording,
+  startAudioRecording,
+  stopAudioRecording,
+  isVoiceCaptureSupported,
 } from './capture';
 import { uploadFeedback } from './upload';
 import { DeviceInfo, FeedbackBundle } from './types';
@@ -46,7 +49,9 @@ type ActionState =
   | 'hot-reloading'
   | 'capturing'
   | 'vibing'
-  | 'sending-video';
+  | 'sending-video'
+  | 'recording-voice'
+  | 'transcribing-voice';
 
 export const FeedbackModal: React.FC = () => {
   const [visible, setVisible] = useState(false);
@@ -55,6 +60,10 @@ export const FeedbackModal: React.FC = () => {
   const [toast, setToast] = useState<string | null>(null);
   const [progress, setProgress] = useState<number | null>(null);
   const [isRecordingVideo, setIsRecordingVideo] = useState(false);
+  const [isRecordingVoice, setIsRecordingVoice] = useState(false);
+  // Cached once on mount — bare-RN apps without expo-av get a clean
+  // hidden button instead of a runtime error.
+  const voiceSupported = useRef<boolean>(isVoiceCaptureSupported()).current;
   const [lastVideo, setLastVideo] = useState<LastVideo | null>(null);
   const mountedRef = useRef(true);
 
@@ -339,6 +348,97 @@ export const FeedbackModal: React.FC = () => {
     }
   }, [isRecordingVideo]);
 
+  // ─── Voice note: record → transcribe → send as feedback ───────────
+  // Tap once to start; tap again to stop. On stop: upload the audio
+  // to the agent's /voice/transcribe (which routes through whichever
+  // STT provider is configured — Whisper / Deepgram / OpenAI / etc.),
+  // then file the transcript as a bug report. The audio file itself
+  // is also attached to the feedback bundle so the agent can re-play
+  // it if the transcript is wrong.
+  const handleToggleVoice = useCallback(async () => {
+    setError(null);
+    if (!isRecordingVoice) {
+      try {
+        await startAudioRecording();
+        if (mountedRef.current) {
+          setIsRecordingVoice(true);
+          setAction('recording-voice');
+          setToast('Recording voice note…');
+        }
+      } catch (err: unknown) {
+        setIsRecordingVoice(false);
+        setAction('idle');
+        setError(err instanceof Error ? err.message : String(err));
+      }
+      return;
+    }
+
+    // Stopping → transcribe → send.
+    try {
+      const audio = await stopAudioRecording();
+      setIsRecordingVoice(false);
+      if (!audio) {
+        setAction('idle');
+        return;
+      }
+      setAction('transcribing-voice');
+      setToast('Transcribing…');
+
+      const config = YaverFeedback.getConfig();
+      if (!config?.agentUrl) {
+        setError('Not connected to the agent yet.');
+        setAction('idle');
+        return;
+      }
+      let transcript = '';
+      try {
+        const client = YaverFeedback.getP2PClient();
+        if (client) {
+          const res = await client.transcribeVoice(audio.path);
+          transcript = res.text ?? '';
+        }
+      } catch {
+        // Transcription can fail (no STT provider configured on the
+        // agent, network blip, etc.). Don't block the flow — ship
+        // the raw audio file with a "[no transcript]" note so the
+        // agent + human reviewer can still play it back.
+      }
+
+      const { Dimensions } = require('react-native');
+      const { width, height } = Dimensions.get('window');
+      const deviceInfo: DeviceInfo = {
+        platform: Platform.OS,
+        osVersion: String(Platform.Version),
+        model: Platform.OS === 'ios' ? 'iOS Device' : 'Android Device',
+        screenWidth: width,
+        screenHeight: height,
+      };
+      const bundle: FeedbackBundle = {
+        metadata: {
+          timestamp: new Date().toISOString(),
+          device: deviceInfo,
+          app: {},
+          userNote:
+            transcript.length > 0
+              ? `[Voice note] ${transcript}`
+              : `[Voice note · ${Math.round(audio.duration)}s — transcription unavailable]`,
+        },
+        screenshots: [],
+        audio: audio.path,
+        errors: YaverFeedback.getCapturedErrors().length
+          ? YaverFeedback.getCapturedErrors()
+          : undefined,
+      };
+      await uploadFeedback(config.agentUrl, config.authToken ?? '', bundle);
+      setToast(transcript ? `Sent: "${transcript.slice(0, 60)}${transcript.length > 60 ? '…' : ''}"` : 'Voice note sent');
+      closeSoon(1800);
+    } catch (err: unknown) {
+      setError(err instanceof Error ? err.message : String(err));
+    } finally {
+      if (mountedRef.current) setAction('idle');
+    }
+  }, [isRecordingVoice, closeSoon]);
+
   // ─── 5. Send the last recorded video ───────────────────────────────
   const handleSendVideo = useCallback(async () => {
     const config = YaverFeedback.getConfig();
@@ -446,6 +546,25 @@ export const FeedbackModal: React.FC = () => {
                 busy={action === 'vibing'}
               />
 
+              {/* Voice note — only rendered when expo-av is installed.
+                  Tap to start, tap again to stop → transcribes via
+                  the agent and files as a feedback report. */}
+              {voiceSupported && (
+                <ActionRow
+                  label={
+                    action === 'transcribing-voice'
+                      ? 'Transcribing…'
+                      : isRecordingVoice
+                        ? 'Stop & Send Voice'
+                        : 'Voice Note'
+                  }
+                  tint={isRecordingVoice ? '#ef4444' : '#f472b6'}
+                  onPress={handleToggleVoice}
+                  disabled={busy && action !== 'recording-voice' && action !== 'idle'}
+                  busy={action === 'transcribing-voice'}
+                />
+              )}
+
               {/* 4. Start/Stop Recording */}
               <ActionRow
                 label={isRecordingVideo ? 'Stop Recording' : 'Start Recording'}

package/src/capture.ts

@@ -1,15 +1,17 @@
 /**
- * Screen capture helpers — screenshot + video recording.
+ * Screen capture helpers — screenshot + video + voice recording.
  *
  * Peer deps (all optional — loaded lazily):
  *   - `react-native-view-shot`        — screenshot
  *   - `react-native-record-screen`    — video recording (iOS ReplayKit /
  *                                       Android MediaProjection)
+ *   - `expo-av`                       — audio recording for voice notes
  *
  * Each helper surfaces a clear error if the module is missing so a host
- * app knows exactly which peer dep to add. Audio-note / voice-command
- * recording was removed in 0.7.0 — see FeedbackModal for the new
- * 5-button surface.
+ * app knows exactly which peer dep to add. Voice-note capture was
+ * removed in 0.7.0 and re-added in 0.7.14 as a narrow, "press to
+ * record → stop → transcribe via the agent → attach to feedback" flow.
+ * The broader live/narrated/batch modes from pre-0.7.0 stay removed.
  */
 
 /**
@@ -118,3 +120,114 @@ export async function stopVideoRecording(): Promise<{
 export function isVideoRecording(): boolean {
   return videoRecordingActive;
 }
+
+// ── Voice note recording ────────────────────────────────────────────
+//
+// Short audio recording, stopped on user tap. Lazy-loaded via expo-av —
+// the SDK doesn't declare a hard dep on it so bare-RN apps that don't
+// have Expo can still install the SDK. If expo-av is missing, the
+// helpers throw a clear error and the modal's voice button gracefully
+// hides itself.
+
+let audioRecorderRef: any = null;
+let audioRecorderActive = false;
+
+function loadExpoAvOrThrow(): any {
+  try {
+    const mod = require('expo-av');
+    if (!mod?.Audio?.Recording) {
+      throw new Error('expo-av is installed but missing Audio.Recording');
+    }
+    return mod;
+  } catch (err) {
+    throw new Error(
+      '[YaverFeedback] Voice notes need `expo-av` as a peer dependency. ' +
+        'Add it with `npx expo install expo-av` and rebuild. ' +
+        String(err),
+    );
+  }
+}
+
+/**
+ * Returns true if `expo-av` is installed and Audio.Recording is
+ * available — lets the modal hide the voice button in apps that
+ * haven't installed the peer dep, instead of throwing on tap.
+ */
+export function isVoiceCaptureSupported(): boolean {
+  try {
+    const mod = require('expo-av');
+    return !!mod?.Audio?.Recording;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Begin recording audio from the device microphone. Requests
+ * microphone permission on first use. Resolves once recording has
+ * actually started, so the UI can flip to "Stop" immediately.
+ */
+export async function startAudioRecording(): Promise<void> {
+  if (audioRecorderActive) {
+    throw new Error('[YaverFeedback] An audio recording is already in progress.');
+  }
+  const ExpoAv = loadExpoAvOrThrow();
+  const { Audio } = ExpoAv;
+
+  const perm = await Audio.requestPermissionsAsync();
+  if (!perm.granted) {
+    throw new Error(
+      '[YaverFeedback] Microphone permission denied. Enable it in Settings ▸ Your App ▸ Microphone.',
+    );
+  }
+
+  // Use the iOS/Android high-quality preset — transcription providers
+  // (Whisper / Deepgram / OpenAI) prefer 16 kHz+ mono but also handle
+  // the higher sample rates fine. Default preset is portable.
+  await Audio.setAudioModeAsync({
+    allowsRecordingIOS: true,
+    playsInSilentModeIOS: true,
+    staysActiveInBackground: false,
+  });
+
+  const recording = new Audio.Recording();
+  await recording.prepareToRecordAsync(Audio.RecordingOptionsPresets.HIGH_QUALITY);
+  await recording.startAsync();
+  audioRecorderRef = recording;
+  audioRecorderActive = true;
+}
+
+/**
+ * Stop the current audio recording and return the on-device file path
+ * (usually a .m4a on iOS / .3gp on Android). Returns null if no
+ * recording was active.
+ */
+export async function stopAudioRecording(): Promise<{ path: string; duration: number } | null> {
+  if (!audioRecorderActive || !audioRecorderRef) return null;
+  const recording = audioRecorderRef;
+  audioRecorderRef = null;
+  audioRecorderActive = false;
+  try {
+    await recording.stopAndUnloadAsync();
+  } catch {
+    // Second stop calls throw; ignore and use whatever state we have.
+  }
+  const uri = typeof recording.getURI === 'function' ? recording.getURI() : null;
+  if (!uri) {
+    throw new Error('[YaverFeedback] Audio recording produced no file.');
+  }
+  let durationMs = 0;
+  try {
+    const status = await recording.getStatusAsync();
+    durationMs = status?.durationMillis ?? 0;
+  } catch {
+    // Status can fail after unload; leave duration at 0, transcription
+    // still works.
+  }
+  return { path: uri, duration: durationMs / 1000 };
+}
+
+/** Whether a voice-note recording is currently active. */
+export function isAudioRecording(): boolean {
+  return audioRecorderActive;
+}