@qafka/react-native 2.3.2 → 2.3.3

package/android/src/main/AndroidManifest.xml

@@ -1,2 +1,4 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <!-- Required for voice capture. Merged into the consumer app manifest. -->
+    <uses-permission android:name="android.permission.RECORD_AUDIO" />
 </manifest>

package/dist/native/QafkaAudio.d.ts

@@ -1,4 +1,11 @@
 export declare const QafkaAudio: {
+    /**
+     * Ensure microphone access before capturing. iOS prompts natively inside
+     * startCapture; on Android the RECORD_AUDIO runtime permission is requested
+     * here (the platform never auto-prompts), otherwise capture starts denied and
+     * the voice stream is silent. Resolves to whether mic access is available.
+     */
+    ensureRecordPermission: () => Promise<boolean>;
     startCapture: () => Promise<boolean>;
     stopCapture: () => Promise<boolean>;
     playAudioChunk: (base64Data: string) => Promise<boolean>;

package/dist/native/QafkaAudio.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.QafkaAudio = void 0;
 const react_native_1 = require("react-native");
+const ensure_record_permission_1 = require("./ensure-record-permission");
 const { QafkaAudio: NativeQafkaAudio } = react_native_1.NativeModules;
 const emitter = NativeQafkaAudio ? new react_native_1.NativeEventEmitter(NativeQafkaAudio) : null;
 const MISSING_MODULE_MESSAGE = `QafkaAudio native module is not linked. ` +
@@ -15,6 +16,25 @@ const requireModule = () => {
     return NativeQafkaAudio;
 };
 exports.QafkaAudio = {
+    /**
+     * Ensure microphone access before capturing. iOS prompts natively inside
+     * startCapture; on Android the RECORD_AUDIO runtime permission is requested
+     * here (the platform never auto-prompts), otherwise capture starts denied and
+     * the voice stream is silent. Resolves to whether mic access is available.
+     */
+    ensureRecordPermission: () => (0, ensure_record_permission_1.ensureRecordPermission)({
+        os: react_native_1.Platform.OS,
+        check: () => react_native_1.PermissionsAndroid.check(react_native_1.PermissionsAndroid.PERMISSIONS.RECORD_AUDIO),
+        request: async () => {
+            const result = await react_native_1.PermissionsAndroid.request(react_native_1.PermissionsAndroid.PERMISSIONS.RECORD_AUDIO, {
+                title: 'Microphone permission',
+                message: 'Microphone access is required for voice conversations.',
+                buttonPositive: 'OK',
+                buttonNegative: 'Cancel',
+            });
+            return result === react_native_1.PermissionsAndroid.RESULTS.GRANTED;
+        },
+    }),
     startCapture: () => requireModule().startCapture(),
     stopCapture: () => requireModule().stopCapture(),
     playAudioChunk: (base64Data) => requireModule().playAudioChunk(base64Data),

package/dist/native/ensure-record-permission.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Resolve microphone permission before voice capture starts.
+ *
+ * iOS requests the permission as part of starting native capture, so this is a
+ * no-op there. On Android the platform never auto-prompts for the runtime
+ * RECORD_AUDIO permission — it must be requested explicitly, otherwise capture
+ * starts denied and the voice stream stays silent.
+ *
+ * Kept pure and dependency-injected so it can be unit-tested without the
+ * react-native runtime; {@link QafkaAudio} wires the real platform calls in.
+ */
+export interface RecordPermissionDeps {
+    /** Platform.OS */
+    os: string;
+    /** Resolve whether RECORD_AUDIO is already granted. */
+    check: () => Promise<boolean>;
+    /** Prompt the user for RECORD_AUDIO; resolve whether it was granted. */
+    request: () => Promise<boolean>;
+}
+export declare function ensureRecordPermission(deps: RecordPermissionDeps): Promise<boolean>;

package/dist/native/ensure-record-permission.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureRecordPermission = ensureRecordPermission;
+async function ensureRecordPermission(deps) {
+    // iOS handles the prompt natively inside startCapture.
+    if (deps.os !== 'android')
+        return true;
+    if (await deps.check())
+        return true;
+    return deps.request();
+}

package/dist/services/RealtimeService.js

@@ -129,6 +129,17 @@ class RealtimeService {
     }
     async startAudioPipeline() {
         try {
+            // Android needs the RECORD_AUDIO runtime permission requested explicitly
+            // before capture (iOS prompts natively inside startCapture). Without this
+            // capture starts denied and the voice stream is silent.
+            const micGranted = await QafkaAudio_1.QafkaAudio.ensureRecordPermission();
+            if (!micGranted) {
+                this.eventHandler?.({
+                    type: 'error',
+                    message: 'Microphone permission denied',
+                });
+                return;
+            }
             // Attach listener BEFORE startCapture so the native tap
             // doesn't drop early buffers (hasListeners/listenerCount gate).
             this.attachAudioListener();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qafka/react-native",
-  "version": "2.3.2",
+  "version": "2.3.3",
   "description": "Drop-in AI assistant for React Native: chat, voice, and tool execution with screen-aware navigation.",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",