react-native-iinstall 0.2.13 → 0.2.15

package/INTEGRATION_GUIDE.md

@@ -46,16 +46,20 @@ npm install react-native-iinstall
 yarn add react-native-iinstall
 ```
 
-**Note**: The SDK automatically includes necessary dependencies like `react-native-sensors` and `react-native-view-shot`.
+Install required native peer dependencies at app root:
 
-### Updating to Latest Version (v0.2.13)
+```bash
+npm install react-native-sensors react-native-view-shot react-native-device-info react-native-audio-recorder-player react-native-record-screen
+```
+
+### Updating to Latest Version (v0.2.14)
 
 If you're using an older version, update to get the latest audio/video improvements:
 
 ```bash
-npm install react-native-iinstall@0.2.13
+npm install react-native-iinstall@0.2.14
 # OR
-yarn add react-native-iinstall@0.2.13
+yarn add react-native-iinstall@0.2.14
 ```
 
 **Key improvements in v0.2.7:**
@@ -136,7 +140,7 @@ import { registerPushToken, unregisterPushToken } from 'react-native-iinstall';
 
 ---
 
-## 6. Audio & Video Feedback (v0.2.7+)
+## 6. Audio & Video Feedback (v0.2.14+)
 
 The SDK now supports **Audio Feedback** (Voice Notes) and **Screen Recording** with enhanced compatibility and reliability.
 
@@ -151,6 +155,7 @@ The SDK now supports **Audio Feedback** (Voice Notes) and **Screen Recording** w
 These features require native modules. If you haven't already, run:
 
 ```bash
+npm install react-native-sensors react-native-view-shot react-native-device-info react-native-audio-recorder-player react-native-record-screen
 cd ios && pod install
 ```
 
@@ -219,7 +224,7 @@ A: The app will work fine, but features like "Shake to Report" and automatic ses
 A: Ensure your project icon URL is valid. If the image fails to load, the dashboard now automatically falls back to showing the project's initial letter on a styled background.
 
 **Q: Audio feedback shows 0:00 duration in dashboard?**
-A: Update to SDK v0.2.7+ which fixes audio codec compatibility. Audio files are now encoded as AAC instead of ALAC for better browser compatibility.
+A: Update to SDK v0.2.14+ which includes the audio codec compatibility fixes. Audio files are encoded as AAC for browser playback.
 
 **Q: Screen recording sometimes doesn't capture?**
-A: Update to SDK v0.2.7+ which includes enhanced URI extraction and better error handling for screen recordings across different devices.
+A: Update to SDK v0.2.14+ which includes enhanced URI extraction and better error handling for screen recordings across different devices.

package/README.md

@@ -34,9 +34,12 @@ Transform your app's feedback collection with our powerful shake-to-report SDK.
    npm install react-native-iinstall
    ```
 
-   **Note**: This package automatically installs required dependencies (`react-native-sensors`, `react-native-view-shot`, etc.).
+2. Install required native peer dependencies in your app root:
+   ```bash
+   npm install react-native-sensors react-native-view-shot react-native-device-info react-native-audio-recorder-player react-native-record-screen
+   ```
 
-2. Link native modules (iOS only, non-Expo):
+3. Link native modules (iOS only, non-Expo):
    ```bash
    cd ios && pod install
    ```
@@ -173,7 +176,8 @@ await unregisterPushToken({
 - **Shake not working?** Test on real device or enable "Shake" in simulator
 - **Network errors?** Verify `apiEndpoint` is base URL only (not `/api/sdk/issue`)
 - **Permissions denied?** Check platform-specific setup in integration guide
-- **Audio issues?** Ensure SDK v0.2.7+ for AAC codec support
+- **Audio issues?** Ensure SDK v0.2.14+ and rebuild after native peer install
+- **Native module is null/undefined?** Reinstall peer deps in app root, run `cd ios && pod install`, then rebuild the app
 
 ### Getting Help
 - 📖 [Complete Integration Guide](INTEGRATION_GUIDE.md)

package/RELEASE_MANIFEST.json

@@ -0,0 +1,8 @@
+{
+  "version": "0.2.15",
+  "highlights": [
+    "Native modules now declared as peer dependencies for reliable app-root autolinking",
+    "SDK now lazy-loads native modules and degrades gracefully instead of hard crashing",
+    "Updated integration docs with explicit peer dependency install commands"
+  ]
+}

package/lib/FeedbackModal.js

@@ -32,15 +32,11 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FeedbackModal = void 0;
 const react_1 = __importStar(require("react"));
 const react_native_1 = require("react-native");
-const react_native_device_info_1 = __importDefault(require("react-native-device-info"));
-const react_native_audio_recorder_player_1 = __importStar(require("react-native-audio-recorder-player"));
+const nativeModules_1 = require("./nativeModules");
 const FeedbackModal = ({ visible, onClose, screenshotUri, videoUri, onStartRecording, apiKey, apiEndpoint }) => {
     const [description, setDescription] = (0, react_1.useState)('');
     const [isSending, setIsSending] = (0, react_1.useState)(false);
@@ -48,16 +44,21 @@ const FeedbackModal = ({ visible, onClose, screenshotUri, videoUri, onStartRecor
     const [isRecordingAudio, setIsRecordingAudio] = (0, react_1.useState)(false);
     const [audioUri, setAudioUri] = (0, react_1.useState)(null);
     const [audioDuration, setAudioDuration] = (0, react_1.useState)('00:00');
-    const audioRecorderPlayer = (0, react_1.useRef)(new react_native_audio_recorder_player_1.default()).current;
+    const audioRecordingAvailable = (0, nativeModules_1.hasAudioRecordingSupport)();
+    const audioRecorderPlayer = (0, react_1.useRef)((0, nativeModules_1.createAudioRecorderPlayer)()).current;
     (0, react_1.useEffect)(() => {
         return () => {
             // Cleanup
-            if (isRecordingAudio) {
-                audioRecorderPlayer.stopRecorder();
+            if (isRecordingAudio && audioRecorderPlayer) {
+                audioRecorderPlayer.stopRecorder().catch(() => undefined);
             }
         };
-    }, [isRecordingAudio]);
+    }, [audioRecorderPlayer, isRecordingAudio]);
     const onStartAudioRecord = async () => {
+        if (!audioRecorderPlayer || !audioRecordingAvailable) {
+            react_native_1.Alert.alert('Audio unavailable', 'Install react-native-audio-recorder-player in your app root, then rebuild the app.');
+            return;
+        }
         if (react_native_1.Platform.OS === 'android') {
             try {
                 const grants = await react_native_1.PermissionsAndroid.requestMultiple([
@@ -77,20 +78,7 @@ const FeedbackModal = ({ visible, onClose, screenshotUri, videoUri, onStartRecor
             }
         }
         try {
-            const audioSet = {
-                AVFormatIDKeyIOS: react_native_audio_recorder_player_1.AVEncodingOption.aac,
-                AVEncoderAudioQualityKeyIOS: react_native_audio_recorder_player_1.AVEncoderAudioQualityIOSType.high,
-                AVSampleRateKeyIOS: 44100,
-                AVNumberOfChannelsKeyIOS: 1,
-                AVEncoderBitRateKeyIOS: 128000,
-                AudioEncoderAndroid: react_native_audio_recorder_player_1.AudioEncoderAndroidType.AAC,
-                AudioSourceAndroid: react_native_audio_recorder_player_1.AudioSourceAndroidType.MIC,
-                OutputFormatAndroid: react_native_audio_recorder_player_1.OutputFormatAndroidType.MPEG_4,
-                AudioEncodingBitRateAndroid: 128000,
-                AudioSamplingRateAndroid: 44100,
-                AudioChannelsAndroid: 1,
-            };
-            const result = await audioRecorderPlayer.startRecorder(undefined, audioSet);
+            const result = await audioRecorderPlayer.startRecorder(undefined, (0, nativeModules_1.getAudioRecordingPreset)());
             audioRecorderPlayer.addRecordBackListener((e) => {
                 setAudioDuration(audioRecorderPlayer.mmssss(Math.floor(e.currentPosition)));
                 return;
@@ -104,6 +92,9 @@ const FeedbackModal = ({ visible, onClose, screenshotUri, videoUri, onStartRecor
         }
     };
     const onStopAudioRecord = async () => {
+        if (!audioRecorderPlayer) {
+            return;
+        }
         try {
             const result = await audioRecorderPlayer.stopRecorder();
             audioRecorderPlayer.removeRecordBackListener();
@@ -120,7 +111,7 @@ const FeedbackModal = ({ visible, onClose, screenshotUri, videoUri, onStartRecor
         setAudioDuration('00:00');
     };
     const handleClose = async () => {
-        if (isRecordingAudio) {
+        if (isRecordingAudio && audioRecorderPlayer) {
             try {
                 await audioRecorderPlayer.stopRecorder();
             }
@@ -181,20 +172,13 @@ const FeedbackModal = ({ visible, onClose, screenshotUri, videoUri, onStartRecor
                 });
             }
             // 4. Metadata
-            const metadata = {
-                device: react_native_device_info_1.default.getModel(),
-                systemName: react_native_device_info_1.default.getSystemName(),
-                systemVersion: react_native_device_info_1.default.getSystemVersion(),
-                appVersion: react_native_device_info_1.default.getVersion(),
-                buildNumber: react_native_device_info_1.default.getBuildNumber(),
-                brand: react_native_device_info_1.default.getBrand(),
-                isEmulator: await react_native_device_info_1.default.isEmulator(),
-            };
+            const metadata = await (0, nativeModules_1.getDeviceMetadata)();
             formData.append('metadata', JSON.stringify(metadata));
             // 5. Other fields
             formData.append('description', description);
             formData.append('apiKey', apiKey);
-            formData.append('udid', await react_native_device_info_1.default.getUniqueId());
+            const deviceUdid = await (0, nativeModules_1.getDeviceUniqueId)();
+            formData.append('udid', deviceUdid || 'unknown');
             // 6. Send
             const response = await fetch(`${apiEndpoint}/api/feedback`, {
                 method: 'POST',
@@ -257,9 +241,20 @@ const FeedbackModal = ({ visible, onClose, screenshotUri, videoUri, onStartRecor
           {/* Media Actions Row */}
           <react_native_1.View style={styles.actionsRow}>
               {/* Audio Recorder */}
-              <react_native_1.TouchableOpacity style={[styles.actionBtn, isRecordingAudio ? styles.recordingBtn : undefined, audioUri ? styles.hasAudioBtn : undefined]} onPress={isRecordingAudio ? onStopAudioRecord : onStartAudioRecord}>
+              <react_native_1.TouchableOpacity style={[
+            styles.actionBtn,
+            isRecordingAudio ? styles.recordingBtn : undefined,
+            audioUri ? styles.hasAudioBtn : undefined,
+            !audioRecordingAvailable ? styles.disabledActionBtn : undefined,
+        ]} onPress={isRecordingAudio ? onStopAudioRecord : onStartAudioRecord} disabled={!audioRecordingAvailable}>
                   <react_native_1.Text style={[styles.actionBtnText, (isRecordingAudio || audioUri) ? { color: '#FFF' } : undefined]}>
-                      {isRecordingAudio ? `Stop (${audioDuration})` : audioUri ? 'Re-record Audio' : '🎙 Record Audio'}
+                      {!audioRecordingAvailable
+            ? '🎙 Audio Unavailable'
+            : isRecordingAudio
+                ? `Stop (${audioDuration})`
+                : audioUri
+                    ? 'Re-record Audio'
+                    : '🎙 Record Audio'}
                   </react_native_1.Text>
               </react_native_1.TouchableOpacity>
 
@@ -372,6 +367,9 @@ const styles = react_native_1.StyleSheet.create({
     hasAudioBtn: {
         backgroundColor: '#4CAF50',
     },
+    disabledActionBtn: {
+        opacity: 0.45,
+    },
     actionBtnText: {
         fontSize: 14,
         fontWeight: '600',

package/lib/index.js

@@ -32,19 +32,14 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.unregisterPushToken = exports.registerPushToken = exports.IInstallWrapper = exports.IInstall = void 0;
 const react_1 = __importStar(require("react"));
 const react_native_1 = require("react-native");
-const react_native_view_shot_1 = require("react-native-view-shot");
 const ShakeDetector_1 = require("./ShakeDetector");
 const FeedbackModal_1 = require("./FeedbackModal");
-const react_native_record_screen_1 = __importDefault(require("react-native-record-screen"));
-const react_native_device_info_1 = __importDefault(require("react-native-device-info"));
 const pushRegistration_1 = require("./pushRegistration");
+const nativeModules_1 = require("./nativeModules");
 const IInstall = ({ apiKey, apiEndpoint = 'https://iinstall.app', children, enabled = true, showFloatingButtonOnEmulator = true, floatingButtonLabel = 'Report Issue', pushToken, autoRegisterPushToken = true, projectId, onPushTokenRegisterError, }) => {
     const [modalVisible, setModalVisible] = (0, react_1.useState)(false);
     const [screenshotUri, setScreenshotUri] = (0, react_1.useState)(null);
@@ -62,7 +57,7 @@ const IInstall = ({ apiKey, apiEndpoint = 'https://iinstall.app', children, enab
     }, [isRecording, modalVisible]);
     (0, react_1.useEffect)(() => {
         let mounted = true;
-        react_native_device_info_1.default.isEmulator()
+        (0, nativeModules_1.isEmulatorDevice)()
             .then((value) => {
             if (mounted) {
                 setIsEmulator(value);
@@ -82,7 +77,7 @@ const IInstall = ({ apiKey, apiEndpoint = 'https://iinstall.app', children, enab
             return;
         try {
             // Capture screenshot
-            const uri = await (0, react_native_view_shot_1.captureScreen)({
+            const uri = await (0, nativeModules_1.captureScreenImage)({
                 format: 'png',
                 quality: 0.8,
             });
@@ -117,7 +112,7 @@ const IInstall = ({ apiKey, apiEndpoint = 'https://iinstall.app', children, enab
             return;
         let cancelled = false;
         const syncPushToken = async () => {
-            const deviceUdid = await react_native_device_info_1.default.getUniqueId().catch(() => undefined);
+            const deviceUdid = await (0, nativeModules_1.getDeviceUniqueId)();
             const result = await (0, pushRegistration_1.registerPushToken)({
                 token: pushToken,
                 apiKey,
@@ -167,6 +162,7 @@ const IInstall = ({ apiKey, apiEndpoint = 'https://iinstall.app', children, enab
         showFloatingButtonOnEmulator &&
         !modalVisible &&
         !isRecording;
+    const screenRecordingAvailable = (0, nativeModules_1.hasScreenRecordingSupport)();
     const normalizeVideoUri = (value) => {
         if (react_native_1.Platform.OS === 'ios' && value.startsWith('/')) {
             return `file://${value}`;
@@ -211,10 +207,15 @@ const IInstall = ({ apiKey, apiEndpoint = 'https://iinstall.app', children, enab
         return null;
     };
     const handleStartRecording = async () => {
+        if (!screenRecordingAvailable) {
+            console.warn('IInstall: Screen recording unavailable. Install react-native-record-screen in your app and rebuild.');
+            setModalVisible(true);
+            return;
+        }
         setModalVisible(false);
         setIsRecording(true);
         try {
-            await react_native_record_screen_1.default.startRecording({ mic: true });
+            await (0, nativeModules_1.startScreenRecording)({ mic: true });
         }
         catch (e) {
             console.error('Failed to start recording', e);
@@ -225,7 +226,7 @@ const IInstall = ({ apiKey, apiEndpoint = 'https://iinstall.app', children, enab
     const handleStopRecording = async () => {
         try {
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            const res = await react_native_record_screen_1.default.stopRecording();
+            const res = await (0, nativeModules_1.stopScreenRecording)();
             if (res) {
                 const nextVideoUri = resolveRecordedVideoUri(res);
                 if (nextVideoUri) {
@@ -272,7 +273,7 @@ const IInstall = ({ apiKey, apiEndpoint = 'https://iinstall.app', children, enab
             setModalVisible(false);
             setVideoUri(null); // Clear video on close
             setScreenshotUri(null);
-        }} screenshotUri={screenshotUri} videoUri={videoUri} onStartRecording={handleStartRecording} apiKey={apiKey} apiEndpoint={apiEndpoint}/>
+        }} screenshotUri={screenshotUri} videoUri={videoUri} onStartRecording={screenRecordingAvailable ? handleStartRecording : undefined} apiKey={apiKey} apiEndpoint={apiEndpoint}/>
     </react_native_1.View>);
 };
 exports.IInstall = IInstall;

package/lib/nativeModules.d.ts

@@ -0,0 +1,37 @@
+type CaptureScreenOptions = {
+    format?: 'png' | 'jpg' | 'webm' | 'raw';
+    quality?: number;
+    result?: 'tmpfile' | 'base64' | 'data-uri' | 'zip-base64';
+};
+type RecordBackEvent = {
+    currentPosition: number;
+};
+export type AudioRecorderPlayerLike = {
+    startRecorder: (uri?: string, audioSets?: Record<string, unknown>) => Promise<string>;
+    stopRecorder: () => Promise<string>;
+    addRecordBackListener: (callback: (recordingMeta: RecordBackEvent) => void) => void;
+    removeRecordBackListener: () => void;
+    mmssss: (milisecs: number) => string;
+};
+export type DeviceMetadata = {
+    device: string;
+    systemName: string;
+    systemVersion: string;
+    appVersion: string;
+    buildNumber: string;
+    brand: string;
+    isEmulator: boolean;
+};
+export declare function isEmulatorDevice(): Promise<boolean>;
+export declare function getDeviceUniqueId(): Promise<string | undefined>;
+export declare function getDeviceMetadata(): Promise<DeviceMetadata>;
+export declare function hasScreenRecordingSupport(): boolean;
+export declare function startScreenRecording(config?: {
+    mic?: boolean;
+}): Promise<void>;
+export declare function stopScreenRecording(): Promise<unknown>;
+export declare function captureScreenImage(options?: CaptureScreenOptions): Promise<string>;
+export declare function hasAudioRecordingSupport(): boolean;
+export declare function createAudioRecorderPlayer(): AudioRecorderPlayerLike | null;
+export declare function getAudioRecordingPreset(): Record<string, string | number>;
+export {};

package/lib/nativeModules.js

@@ -0,0 +1,232 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isEmulatorDevice = isEmulatorDevice;
+exports.getDeviceUniqueId = getDeviceUniqueId;
+exports.getDeviceMetadata = getDeviceMetadata;
+exports.hasScreenRecordingSupport = hasScreenRecordingSupport;
+exports.startScreenRecording = startScreenRecording;
+exports.stopScreenRecording = stopScreenRecording;
+exports.captureScreenImage = captureScreenImage;
+exports.hasAudioRecordingSupport = hasAudioRecordingSupport;
+exports.createAudioRecorderPlayer = createAudioRecorderPlayer;
+exports.getAudioRecordingPreset = getAudioRecordingPreset;
+const react_native_1 = require("react-native");
+const warnedKeys = new Set();
+function warnOnce(key, message) {
+    if (warnedKeys.has(key)) {
+        return;
+    }
+    warnedKeys.add(key);
+    console.warn(message);
+}
+function getDefaultExport(moduleValue) {
+    if (!moduleValue) {
+        return null;
+    }
+    if (typeof moduleValue === 'object' && moduleValue !== null && 'default' in moduleValue) {
+        return moduleValue.default;
+    }
+    return moduleValue;
+}
+function loadRawModule(moduleName) {
+    try {
+        return require(moduleName);
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        warnOnce(`missing:${moduleName}`, `[iInstall SDK] Missing native dependency "${moduleName}". Install it in your app root and rebuild. (${reason})`);
+        return null;
+    }
+}
+let cachedDeviceInfoModule;
+let cachedCaptureScreen;
+let cachedRecordScreenModule;
+let cachedAudioModule;
+function getDeviceInfoModule() {
+    if (cachedDeviceInfoModule !== undefined) {
+        return cachedDeviceInfoModule;
+    }
+    const required = loadRawModule('react-native-device-info');
+    cachedDeviceInfoModule = required ? getDefaultExport(required) : null;
+    return cachedDeviceInfoModule;
+}
+function getCaptureScreenFn() {
+    if (cachedCaptureScreen !== undefined) {
+        return cachedCaptureScreen;
+    }
+    const required = loadRawModule('react-native-view-shot');
+    cachedCaptureScreen = required?.captureScreen ?? null;
+    if (!cachedCaptureScreen) {
+        warnOnce('missing:react-native-view-shot:captureScreen', '[iInstall SDK] Screenshot capture unavailable: react-native-view-shot is not linked correctly.');
+    }
+    return cachedCaptureScreen;
+}
+function getRecordScreenModule() {
+    if (cachedRecordScreenModule !== undefined) {
+        return cachedRecordScreenModule;
+    }
+    const required = loadRawModule('react-native-record-screen');
+    cachedRecordScreenModule = required ? getDefaultExport(required) : null;
+    return cachedRecordScreenModule;
+}
+function getAudioRecorderModule() {
+    if (cachedAudioModule !== undefined) {
+        return cachedAudioModule;
+    }
+    cachedAudioModule = loadRawModule('react-native-audio-recorder-player');
+    return cachedAudioModule;
+}
+function fallbackString(value, defaultValue) {
+    if (!value || value.trim().length === 0) {
+        return defaultValue;
+    }
+    return value;
+}
+async function isEmulatorDevice() {
+    const moduleRef = getDeviceInfoModule();
+    if (!moduleRef?.isEmulator) {
+        return false;
+    }
+    try {
+        return await moduleRef.isEmulator();
+    }
+    catch {
+        return false;
+    }
+}
+async function getDeviceUniqueId() {
+    const moduleRef = getDeviceInfoModule();
+    if (!moduleRef?.getUniqueId) {
+        return undefined;
+    }
+    try {
+        const value = await moduleRef.getUniqueId();
+        return fallbackString(value, 'unknown');
+    }
+    catch {
+        return undefined;
+    }
+}
+async function getDeviceMetadata() {
+    const moduleRef = getDeviceInfoModule();
+    const systemName = react_native_1.Platform.OS === 'ios' ? 'iOS' : react_native_1.Platform.OS;
+    const systemVersion = String(react_native_1.Platform.Version ?? 'unknown');
+    const metadata = {
+        device: 'Unknown Device',
+        systemName,
+        systemVersion,
+        appVersion: 'unknown',
+        buildNumber: 'unknown',
+        brand: react_native_1.Platform.OS === 'ios' ? 'Apple' : 'Unknown',
+        isEmulator: false,
+    };
+    if (!moduleRef) {
+        return metadata;
+    }
+    try {
+        metadata.device = fallbackString(moduleRef.getModel?.(), metadata.device);
+    }
+    catch {
+        // noop
+    }
+    try {
+        metadata.systemName = fallbackString(moduleRef.getSystemName?.(), metadata.systemName);
+    }
+    catch {
+        // noop
+    }
+    try {
+        metadata.systemVersion = fallbackString(moduleRef.getSystemVersion?.(), metadata.systemVersion);
+    }
+    catch {
+        // noop
+    }
+    try {
+        metadata.appVersion = fallbackString(moduleRef.getVersion?.(), metadata.appVersion);
+    }
+    catch {
+        // noop
+    }
+    try {
+        metadata.buildNumber = fallbackString(moduleRef.getBuildNumber?.(), metadata.buildNumber);
+    }
+    catch {
+        // noop
+    }
+    try {
+        metadata.brand = fallbackString(moduleRef.getBrand?.(), metadata.brand);
+    }
+    catch {
+        // noop
+    }
+    try {
+        metadata.isEmulator = moduleRef.isEmulator ? await moduleRef.isEmulator() : false;
+    }
+    catch {
+        metadata.isEmulator = false;
+    }
+    return metadata;
+}
+function hasScreenRecordingSupport() {
+    const moduleRef = getRecordScreenModule();
+    return Boolean(moduleRef?.startRecording && moduleRef?.stopRecording);
+}
+async function startScreenRecording(config = { mic: true }) {
+    const moduleRef = getRecordScreenModule();
+    if (!moduleRef?.startRecording) {
+        throw new Error('Screen recording dependency missing. Install react-native-record-screen and rebuild the app.');
+    }
+    await moduleRef.startRecording(config);
+}
+async function stopScreenRecording() {
+    const moduleRef = getRecordScreenModule();
+    if (!moduleRef?.stopRecording) {
+        throw new Error('Screen recording dependency missing. Install react-native-record-screen and rebuild the app.');
+    }
+    return moduleRef.stopRecording();
+}
+async function captureScreenImage(options) {
+    const captureScreen = getCaptureScreenFn();
+    if (!captureScreen) {
+        throw new Error('Screenshot dependency missing. Install react-native-view-shot and rebuild the app.');
+    }
+    return captureScreen(options);
+}
+function hasAudioRecordingSupport() {
+    const moduleRef = getAudioRecorderModule();
+    const recorderCtor = typeof moduleRef === 'function' ? moduleRef : moduleRef?.default;
+    return typeof recorderCtor === 'function';
+}
+function createAudioRecorderPlayer() {
+    const moduleRef = getAudioRecorderModule();
+    const recorderCtor = typeof moduleRef === 'function' ? moduleRef : moduleRef?.default;
+    if (typeof recorderCtor !== 'function') {
+        warnOnce('missing:react-native-audio-recorder-player:ctor', '[iInstall SDK] Audio recording unavailable: react-native-audio-recorder-player is not linked correctly.');
+        return null;
+    }
+    try {
+        return new recorderCtor();
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        warnOnce('missing:react-native-audio-recorder-player:new', `[iInstall SDK] Failed to initialize audio recorder. (${reason})`);
+        return null;
+    }
+}
+function getAudioRecordingPreset() {
+    const moduleRef = getAudioRecorderModule();
+    const namedExports = typeof moduleRef === 'object' && moduleRef !== null ? moduleRef : undefined;
+    return {
+        AVFormatIDKeyIOS: namedExports?.AVEncodingOption?.aac ?? 'aac',
+        AVEncoderAudioQualityKeyIOS: namedExports?.AVEncoderAudioQualityIOSType?.high ?? 96,
+        AVSampleRateKeyIOS: 44100,
+        AVNumberOfChannelsKeyIOS: 1,
+        AVEncoderBitRateKeyIOS: 128000,
+        AudioEncoderAndroid: namedExports?.AudioEncoderAndroidType?.AAC ?? 3,
+        AudioSourceAndroid: namedExports?.AudioSourceAndroidType?.MIC ?? 1,
+        OutputFormatAndroid: namedExports?.OutputFormatAndroidType?.MPEG_4 ?? 2,
+        AudioEncodingBitRateAndroid: 128000,
+        AudioSamplingRateAndroid: 44100,
+        AudioChannelsAndroid: 1,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-iinstall",
-  "version": "0.2.13",
+  "version": "0.2.15",
   "description": "🎯 IInstall React Native SDK - The ultimate beta testing & QA feedback tool. Shake-to-report with voice recordings, screen recordings, and screenshots. Zero-config setup with TypeScript support. Perfect for beta testing, QA teams, and user feedback collection.",
   "author": "TesterFlow Team",
   "license": "MIT",
@@ -34,22 +34,28 @@
   "files": [
     "lib",
     "src",
-    "INTEGRATION_GUIDE.md"
+    "INTEGRATION_GUIDE.md",
+    "RELEASE_MANIFEST.json"
   ],
   "scripts": {
-    "build": "tsc",
+    "prebuild": "npm run prepare:release",
+    "clean:build": "node -e \"require('fs').rmSync('lib',{ recursive: true, force: true })\"",
+    "build": "npm run clean:build && tsc",
+    "sync:release-manifest": "node scripts/sync-release-manifest.mjs",
+    "check:release-manifest": "node scripts/check-release-manifest.mjs",
+    "prepare:release": "npm run sync:release-manifest && npm run check:release-manifest",
     "prepare": "npm run build"
   },
   "peerDependencies": {
     "react": ">=16.8.0",
-    "react-native": ">=0.60.0"
-  },
-  "dependencies": {
-    "react-native-sensors": "^7.3.0",
-    "react-native-view-shot": "^3.1.2",
-    "react-native-device-info": "^10.0.0",
+    "react-native": ">=0.60.0",
     "react-native-audio-recorder-player": "^3.6.4",
+    "react-native-device-info": "^10.0.0",
     "react-native-record-screen": "^0.6.2",
+    "react-native-sensors": "^7.3.0",
+    "react-native-view-shot": "^3.1.2"
+  },
+  "dependencies": {
     "rxjs": "^7.0.0"
   },
   "devDependencies": {
@@ -57,6 +63,11 @@
     "@types/react-native": "^0.70.0",
     "react": "18.2.0",
     "react-native": "0.72.6",
+    "react-native-audio-recorder-player": "^3.6.4",
+    "react-native-device-info": "^10.0.0",
+    "react-native-record-screen": "^0.6.2",
+    "react-native-sensors": "^7.3.0",
+    "react-native-view-shot": "^3.1.2",
     "typescript": "^5.0.0"
   }
 }

package/src/FeedbackModal.tsx

@@ -16,15 +16,13 @@ import {
   TouchableWithoutFeedback,
   ScrollView
 } from 'react-native';
-import DeviceInfo from 'react-native-device-info';
-import AudioRecorderPlayer, {
-  AVEncodingOption,
-  AVEncoderAudioQualityIOSType,
-  AudioEncoderAndroidType,
-  AudioSourceAndroidType,
-  OutputFormatAndroidType,
-  type AudioSet,
-} from 'react-native-audio-recorder-player';
+import {
+  createAudioRecorderPlayer,
+  getAudioRecordingPreset,
+  getDeviceMetadata,
+  getDeviceUniqueId,
+  hasAudioRecordingSupport,
+} from './nativeModules';
 
 interface FeedbackModalProps {
   visible: boolean;
@@ -52,19 +50,28 @@ export const FeedbackModal: React.FC<FeedbackModalProps> = ({
   const [isRecordingAudio, setIsRecordingAudio] = useState(false);
   const [audioUri, setAudioUri] = useState<string | null>(null);
   const [audioDuration, setAudioDuration] = useState('00:00');
+  const audioRecordingAvailable = hasAudioRecordingSupport();
   
-  const audioRecorderPlayer = useRef(new AudioRecorderPlayer()).current;
+  const audioRecorderPlayer = useRef(createAudioRecorderPlayer()).current;
 
   useEffect(() => {
     return () => {
       // Cleanup
-      if (isRecordingAudio) {
-        audioRecorderPlayer.stopRecorder();
+      if (isRecordingAudio && audioRecorderPlayer) {
+        audioRecorderPlayer.stopRecorder().catch(() => undefined);
       }
     };
-  }, [isRecordingAudio]);
+  }, [audioRecorderPlayer, isRecordingAudio]);
 
   const onStartAudioRecord = async () => {
+    if (!audioRecorderPlayer || !audioRecordingAvailable) {
+      Alert.alert(
+        'Audio unavailable',
+        'Install react-native-audio-recorder-player in your app root, then rebuild the app.'
+      );
+      return;
+    }
+
     if (Platform.OS === 'android') {
       try {
         const grants = await PermissionsAndroid.requestMultiple([
@@ -86,23 +93,9 @@ export const FeedbackModal: React.FC<FeedbackModalProps> = ({
     }
 
     try {
-      const audioSet: AudioSet = {
-        AVFormatIDKeyIOS: AVEncodingOption.aac,
-        AVEncoderAudioQualityKeyIOS: AVEncoderAudioQualityIOSType.high,
-        AVSampleRateKeyIOS: 44100,
-        AVNumberOfChannelsKeyIOS: 1,
-        AVEncoderBitRateKeyIOS: 128000,
-        AudioEncoderAndroid: AudioEncoderAndroidType.AAC,
-        AudioSourceAndroid: AudioSourceAndroidType.MIC,
-        OutputFormatAndroid: OutputFormatAndroidType.MPEG_4,
-        AudioEncodingBitRateAndroid: 128000,
-        AudioSamplingRateAndroid: 44100,
-        AudioChannelsAndroid: 1,
-      };
-
       const result = await audioRecorderPlayer.startRecorder(
         undefined,
-        audioSet,
+        getAudioRecordingPreset(),
       );
       audioRecorderPlayer.addRecordBackListener((e) => {
         setAudioDuration(audioRecorderPlayer.mmssss(Math.floor(e.currentPosition)));
@@ -117,6 +110,10 @@ export const FeedbackModal: React.FC<FeedbackModalProps> = ({
   };
 
   const onStopAudioRecord = async () => {
+    if (!audioRecorderPlayer) {
+      return;
+    }
+
     try {
       const result = await audioRecorderPlayer.stopRecorder();
       audioRecorderPlayer.removeRecordBackListener();
@@ -134,7 +131,7 @@ export const FeedbackModal: React.FC<FeedbackModalProps> = ({
   };
 
   const handleClose = async () => {
-    if (isRecordingAudio) {
+    if (isRecordingAudio && audioRecorderPlayer) {
       try {
         await audioRecorderPlayer.stopRecorder();
       } catch (error) {
@@ -203,21 +200,14 @@ export const FeedbackModal: React.FC<FeedbackModalProps> = ({
       }
 
       // 4. Metadata
-      const metadata = {
-        device: DeviceInfo.getModel(),
-        systemName: DeviceInfo.getSystemName(),
-        systemVersion: DeviceInfo.getSystemVersion(),
-        appVersion: DeviceInfo.getVersion(),
-        buildNumber: DeviceInfo.getBuildNumber(),
-        brand: DeviceInfo.getBrand(),
-        isEmulator: await DeviceInfo.isEmulator(),
-      };
+      const metadata = await getDeviceMetadata();
       formData.append('metadata', JSON.stringify(metadata));
 
       // 5. Other fields
       formData.append('description', description);
       formData.append('apiKey', apiKey);
-      formData.append('udid', await DeviceInfo.getUniqueId());
+      const deviceUdid = await getDeviceUniqueId();
+      formData.append('udid', deviceUdid || 'unknown');
       
       // 6. Send
       const response = await fetch(`${apiEndpoint}/api/feedback`, {
@@ -306,11 +296,23 @@ export const FeedbackModal: React.FC<FeedbackModalProps> = ({
           <View style={styles.actionsRow}>
               {/* Audio Recorder */}
               <TouchableOpacity 
-                style={[styles.actionBtn, isRecordingAudio ? styles.recordingBtn : undefined, audioUri ? styles.hasAudioBtn : undefined]}
+                style={[
+                  styles.actionBtn,
+                  isRecordingAudio ? styles.recordingBtn : undefined,
+                  audioUri ? styles.hasAudioBtn : undefined,
+                  !audioRecordingAvailable ? styles.disabledActionBtn : undefined,
+                ]}
                 onPress={isRecordingAudio ? onStopAudioRecord : onStartAudioRecord}
+                disabled={!audioRecordingAvailable}
               >
                   <Text style={[styles.actionBtnText, (isRecordingAudio || audioUri) ? { color: '#FFF' } : undefined]}>
-                      {isRecordingAudio ? `Stop (${audioDuration})` : audioUri ? 'Re-record Audio' : '🎙 Record Audio'}
+                      {!audioRecordingAvailable
+                        ? '🎙 Audio Unavailable'
+                        : isRecordingAudio
+                          ? `Stop (${audioDuration})`
+                          : audioUri
+                            ? 'Re-record Audio'
+                            : '🎙 Record Audio'}
                   </Text>
               </TouchableOpacity>
 
@@ -437,6 +439,9 @@ const styles = StyleSheet.create({
   hasAudioBtn: {
       backgroundColor: '#4CAF50',
   },
+  disabledActionBtn: {
+      opacity: 0.45,
+  },
   actionBtnText: {
       fontSize: 14,
       fontWeight: '600',

package/src/index.tsx

@@ -1,11 +1,16 @@
 import React, { useEffect, useState, useRef } from 'react';
 import { View, StyleSheet, TouchableOpacity, Text, SafeAreaView, Platform } from 'react-native';
-import { captureScreen } from 'react-native-view-shot';
 import { ShakeDetector } from './ShakeDetector';
 import { FeedbackModal } from './FeedbackModal';
-import RecordScreen from 'react-native-record-screen';
-import DeviceInfo from 'react-native-device-info';
 import { registerPushToken } from './pushRegistration';
+import {
+  captureScreenImage,
+  getDeviceUniqueId,
+  hasScreenRecordingSupport,
+  isEmulatorDevice,
+  startScreenRecording,
+  stopScreenRecording,
+} from './nativeModules';
 
 interface IInstallProps {
   apiKey: string;
@@ -53,7 +58,7 @@ export const IInstall: React.FC<IInstallProps> = ({
   useEffect(() => {
     let mounted = true;
 
-    DeviceInfo.isEmulator()
+    isEmulatorDevice()
       .then((value) => {
         if (mounted) {
           setIsEmulator(value);
@@ -75,7 +80,7 @@ export const IInstall: React.FC<IInstallProps> = ({
 
     try {
       // Capture screenshot
-      const uri = await captureScreen({
+      const uri = await captureScreenImage({
         format: 'png',
         quality: 0.8,
       });
@@ -113,7 +118,7 @@ export const IInstall: React.FC<IInstallProps> = ({
     let cancelled = false;
 
     const syncPushToken = async () => {
-      const deviceUdid = await DeviceInfo.getUniqueId().catch(() => undefined);
+      const deviceUdid = await getDeviceUniqueId();
       const result = await registerPushToken({
         token: pushToken,
         apiKey,
@@ -168,6 +173,7 @@ export const IInstall: React.FC<IInstallProps> = ({
     showFloatingButtonOnEmulator &&
     !modalVisible &&
     !isRecording;
+  const screenRecordingAvailable = hasScreenRecordingSupport();
 
   const normalizeVideoUri = (value: string) => {
     if (Platform.OS === 'ios' && value.startsWith('/')) {
@@ -242,10 +248,18 @@ export const IInstall: React.FC<IInstallProps> = ({
   };
 
   const handleStartRecording = async () => {
+    if (!screenRecordingAvailable) {
+      console.warn(
+        'IInstall: Screen recording unavailable. Install react-native-record-screen in your app and rebuild.'
+      );
+      setModalVisible(true);
+      return;
+    }
+
     setModalVisible(false);
     setIsRecording(true);
     try {
-        await RecordScreen.startRecording({ mic: true });
+        await startScreenRecording({ mic: true });
     } catch (e) {
         console.error('Failed to start recording', e);
         setIsRecording(false);
@@ -256,7 +270,7 @@ export const IInstall: React.FC<IInstallProps> = ({
   const handleStopRecording = async () => {
     try {
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        const res: any = await RecordScreen.stopRecording();
+        const res: any = await stopScreenRecording();
         if (res) {
             const nextVideoUri = resolveRecordedVideoUri(res);
             if (nextVideoUri) {
@@ -315,7 +329,7 @@ export const IInstall: React.FC<IInstallProps> = ({
         }}
         screenshotUri={screenshotUri}
         videoUri={videoUri}
-        onStartRecording={handleStartRecording}
+        onStartRecording={screenRecordingAvailable ? handleStartRecording : undefined}
         apiKey={apiKey}
         apiEndpoint={apiEndpoint}
       />

package/src/nativeModules.ts

@@ -0,0 +1,313 @@
+import { Platform } from 'react-native';
+
+type CaptureScreenOptions = {
+  format?: 'png' | 'jpg' | 'webm' | 'raw';
+  quality?: number;
+  result?: 'tmpfile' | 'base64' | 'data-uri' | 'zip-base64';
+};
+
+type DeviceInfoModule = {
+  getModel?: () => string;
+  getSystemName?: () => string;
+  getSystemVersion?: () => string;
+  getVersion?: () => string;
+  getBuildNumber?: () => string;
+  getBrand?: () => string;
+  isEmulator?: () => Promise<boolean>;
+  getUniqueId?: () => Promise<string>;
+};
+
+type ViewShotModule = {
+  captureScreen?: (options?: CaptureScreenOptions) => Promise<string>;
+};
+
+type RecordScreenModule = {
+  startRecording?: (config?: { mic?: boolean; fps?: number; bitrate?: number }) => Promise<unknown>;
+  stopRecording?: () => Promise<unknown>;
+};
+
+type AudioRecorderModule = {
+  default?: new () => AudioRecorderPlayerLike;
+  AVEncodingOption?: { aac?: string };
+  AVEncoderAudioQualityIOSType?: { high?: number };
+  AudioEncoderAndroidType?: { AAC?: number };
+  AudioSourceAndroidType?: { MIC?: number };
+  OutputFormatAndroidType?: { MPEG_4?: number };
+};
+
+type AudioRecorderModuleValue = AudioRecorderModule | (new () => AudioRecorderPlayerLike);
+
+type RecordBackEvent = {
+  currentPosition: number;
+};
+
+export type AudioRecorderPlayerLike = {
+  startRecorder: (uri?: string, audioSets?: Record<string, unknown>) => Promise<string>;
+  stopRecorder: () => Promise<string>;
+  addRecordBackListener: (callback: (recordingMeta: RecordBackEvent) => void) => void;
+  removeRecordBackListener: () => void;
+  mmssss: (milisecs: number) => string;
+};
+
+export type DeviceMetadata = {
+  device: string;
+  systemName: string;
+  systemVersion: string;
+  appVersion: string;
+  buildNumber: string;
+  brand: string;
+  isEmulator: boolean;
+};
+
+const warnedKeys = new Set<string>();
+
+function warnOnce(key: string, message: string) {
+  if (warnedKeys.has(key)) {
+    return;
+  }
+  warnedKeys.add(key);
+  console.warn(message);
+}
+
+function getDefaultExport<T>(moduleValue: unknown): T | null {
+  if (!moduleValue) {
+    return null;
+  }
+  if (typeof moduleValue === 'object' && moduleValue !== null && 'default' in moduleValue) {
+    return (moduleValue as { default: T }).default;
+  }
+  return moduleValue as T;
+}
+
+function loadRawModule<T>(moduleName: string): T | null {
+  try {
+    return require(moduleName) as T;
+  } catch (error) {
+    const reason = error instanceof Error ? error.message : String(error);
+    warnOnce(
+      `missing:${moduleName}`,
+      `[iInstall SDK] Missing native dependency "${moduleName}". Install it in your app root and rebuild. (${reason})`
+    );
+    return null;
+  }
+}
+
+let cachedDeviceInfoModule: DeviceInfoModule | null | undefined;
+let cachedCaptureScreen: ((options?: CaptureScreenOptions) => Promise<string>) | null | undefined;
+let cachedRecordScreenModule: RecordScreenModule | null | undefined;
+let cachedAudioModule: AudioRecorderModuleValue | null | undefined;
+
+function getDeviceInfoModule(): DeviceInfoModule | null {
+  if (cachedDeviceInfoModule !== undefined) {
+    return cachedDeviceInfoModule;
+  }
+  const required = loadRawModule<unknown>('react-native-device-info');
+  cachedDeviceInfoModule = required ? getDefaultExport<DeviceInfoModule>(required) : null;
+  return cachedDeviceInfoModule;
+}
+
+function getCaptureScreenFn(): ((options?: CaptureScreenOptions) => Promise<string>) | null {
+  if (cachedCaptureScreen !== undefined) {
+    return cachedCaptureScreen;
+  }
+  const required = loadRawModule<ViewShotModule>('react-native-view-shot');
+  cachedCaptureScreen = required?.captureScreen ?? null;
+  if (!cachedCaptureScreen) {
+    warnOnce(
+      'missing:react-native-view-shot:captureScreen',
+      '[iInstall SDK] Screenshot capture unavailable: react-native-view-shot is not linked correctly.'
+    );
+  }
+  return cachedCaptureScreen;
+}
+
+function getRecordScreenModule(): RecordScreenModule | null {
+  if (cachedRecordScreenModule !== undefined) {
+    return cachedRecordScreenModule;
+  }
+  const required = loadRawModule<unknown>('react-native-record-screen');
+  cachedRecordScreenModule = required ? getDefaultExport<RecordScreenModule>(required) : null;
+  return cachedRecordScreenModule;
+}
+
+function getAudioRecorderModule(): AudioRecorderModuleValue | null {
+  if (cachedAudioModule !== undefined) {
+    return cachedAudioModule;
+  }
+  cachedAudioModule = loadRawModule<AudioRecorderModuleValue>('react-native-audio-recorder-player');
+  return cachedAudioModule;
+}
+
+function fallbackString(value: string | undefined, defaultValue: string): string {
+  if (!value || value.trim().length === 0) {
+    return defaultValue;
+  }
+  return value;
+}
+
+export async function isEmulatorDevice(): Promise<boolean> {
+  const moduleRef = getDeviceInfoModule();
+  if (!moduleRef?.isEmulator) {
+    return false;
+  }
+  try {
+    return await moduleRef.isEmulator();
+  } catch {
+    return false;
+  }
+}
+
+export async function getDeviceUniqueId(): Promise<string | undefined> {
+  const moduleRef = getDeviceInfoModule();
+  if (!moduleRef?.getUniqueId) {
+    return undefined;
+  }
+  try {
+    const value = await moduleRef.getUniqueId();
+    return fallbackString(value, 'unknown');
+  } catch {
+    return undefined;
+  }
+}
+
+export async function getDeviceMetadata(): Promise<DeviceMetadata> {
+  const moduleRef = getDeviceInfoModule();
+  const systemName = Platform.OS === 'ios' ? 'iOS' : Platform.OS;
+  const systemVersion = String(Platform.Version ?? 'unknown');
+
+  const metadata: DeviceMetadata = {
+    device: 'Unknown Device',
+    systemName,
+    systemVersion,
+    appVersion: 'unknown',
+    buildNumber: 'unknown',
+    brand: Platform.OS === 'ios' ? 'Apple' : 'Unknown',
+    isEmulator: false,
+  };
+
+  if (!moduleRef) {
+    return metadata;
+  }
+
+  try {
+    metadata.device = fallbackString(moduleRef.getModel?.(), metadata.device);
+  } catch {
+    // noop
+  }
+  try {
+    metadata.systemName = fallbackString(moduleRef.getSystemName?.(), metadata.systemName);
+  } catch {
+    // noop
+  }
+  try {
+    metadata.systemVersion = fallbackString(moduleRef.getSystemVersion?.(), metadata.systemVersion);
+  } catch {
+    // noop
+  }
+  try {
+    metadata.appVersion = fallbackString(moduleRef.getVersion?.(), metadata.appVersion);
+  } catch {
+    // noop
+  }
+  try {
+    metadata.buildNumber = fallbackString(moduleRef.getBuildNumber?.(), metadata.buildNumber);
+  } catch {
+    // noop
+  }
+  try {
+    metadata.brand = fallbackString(moduleRef.getBrand?.(), metadata.brand);
+  } catch {
+    // noop
+  }
+  try {
+    metadata.isEmulator = moduleRef.isEmulator ? await moduleRef.isEmulator() : false;
+  } catch {
+    metadata.isEmulator = false;
+  }
+
+  return metadata;
+}
+
+export function hasScreenRecordingSupport(): boolean {
+  const moduleRef = getRecordScreenModule();
+  return Boolean(moduleRef?.startRecording && moduleRef?.stopRecording);
+}
+
+export async function startScreenRecording(config: { mic?: boolean } = { mic: true }): Promise<void> {
+  const moduleRef = getRecordScreenModule();
+  if (!moduleRef?.startRecording) {
+    throw new Error(
+      'Screen recording dependency missing. Install react-native-record-screen and rebuild the app.'
+    );
+  }
+  await moduleRef.startRecording(config);
+}
+
+export async function stopScreenRecording(): Promise<unknown> {
+  const moduleRef = getRecordScreenModule();
+  if (!moduleRef?.stopRecording) {
+    throw new Error(
+      'Screen recording dependency missing. Install react-native-record-screen and rebuild the app.'
+    );
+  }
+  return moduleRef.stopRecording();
+}
+
+export async function captureScreenImage(options?: CaptureScreenOptions): Promise<string> {
+  const captureScreen = getCaptureScreenFn();
+  if (!captureScreen) {
+    throw new Error(
+      'Screenshot dependency missing. Install react-native-view-shot and rebuild the app.'
+    );
+  }
+  return captureScreen(options);
+}
+
+export function hasAudioRecordingSupport(): boolean {
+  const moduleRef = getAudioRecorderModule();
+  const recorderCtor =
+    typeof moduleRef === 'function' ? moduleRef : moduleRef?.default;
+  return typeof recorderCtor === 'function';
+}
+
+export function createAudioRecorderPlayer(): AudioRecorderPlayerLike | null {
+  const moduleRef = getAudioRecorderModule();
+  const recorderCtor =
+    typeof moduleRef === 'function' ? moduleRef : moduleRef?.default;
+  if (typeof recorderCtor !== 'function') {
+    warnOnce(
+      'missing:react-native-audio-recorder-player:ctor',
+      '[iInstall SDK] Audio recording unavailable: react-native-audio-recorder-player is not linked correctly.'
+    );
+    return null;
+  }
+
+  try {
+    return new recorderCtor();
+  } catch (error) {
+    const reason = error instanceof Error ? error.message : String(error);
+    warnOnce(
+      'missing:react-native-audio-recorder-player:new',
+      `[iInstall SDK] Failed to initialize audio recorder. (${reason})`
+    );
+    return null;
+  }
+}
+
+export function getAudioRecordingPreset(): Record<string, string | number> {
+  const moduleRef = getAudioRecorderModule();
+  const namedExports = typeof moduleRef === 'object' && moduleRef !== null ? moduleRef : undefined;
+  return {
+    AVFormatIDKeyIOS: namedExports?.AVEncodingOption?.aac ?? 'aac',
+    AVEncoderAudioQualityKeyIOS: namedExports?.AVEncoderAudioQualityIOSType?.high ?? 96,
+    AVSampleRateKeyIOS: 44100,
+    AVNumberOfChannelsKeyIOS: 1,
+    AVEncoderBitRateKeyIOS: 128000,
+    AudioEncoderAndroid: namedExports?.AudioEncoderAndroidType?.AAC ?? 3,
+    AudioSourceAndroid: namedExports?.AudioSourceAndroidType?.MIC ?? 1,
+    OutputFormatAndroid: namedExports?.OutputFormatAndroidType?.MPEG_4 ?? 2,
+    AudioEncodingBitRateAndroid: 128000,
+    AudioSamplingRateAndroid: 44100,
+    AudioChannelsAndroid: 1,
+  };
+}