@siteed/expo-audio-stream 0.1.0 → 0.2.1

package/README.md

@@ -1,4 +1,4 @@
-# expo-audio-stream
+# @siteed/expo-audio-stream
 
 `@siteed/expo-audio-stream` is a comprehensive library designed to facilitate real-time audio processing and streaming across iOS, Android, and web platforms. This library leverages Expo's robust ecosystem to simplify the implementation of audio recording and streaming functionalities within React Native applications. Key features include audio streaming with configurable buffer intervals and automatic handling of microphone permissions in managed Expo projects.
 
@@ -7,10 +7,10 @@
 - Real-time audio streaming across iOS, Android, and web.
 - Configurable intervals for audio buffer receipt.
 - Automated microphone permissions setup in managed Expo projects.
+- IOS is automatically setup to handle background audio recording.
 - Listeners for audio data events with detailed event payloads.
 - Utility functions for recording control and file management.
 
-
 ## Installation
 
 To install `@siteed/expo-audio-stream`, add it to your project using npm or Yarn:
@@ -39,32 +39,39 @@ Add the plugin to your app.json like so:
 
 ## Usage
 
+The `example/` folder contains a fully functional React Native application that demonstrates how to integrate and use the `@siteed/expo-audio-stream` library in a real-world scenario. This sample application includes features such as starting and stopping audio recordings, handling permissions, and processing live audio data.
+
 ### Importing the module
 
 ```tsx
 import {
   useAudioRecorder,
+  AudioStreamResult,
 } from 'expo-audio-stream';
 
 export default function App() {
   const { startRecording, stopRecording, duration, size, isRecording } = useAudioRecorder({
-    onAudioStream: (base64Data) => {
-      console.log(`audio event ${typeof base64Data}`, base64Data);
+    onAudioStream: (audioData: Blob) => {
+      console.log(`audio event`,audioData);
     }
   });
 
   const handleStart = async () => {
     const { granted } = await Audio.requestPermissionsAsync();
     if (granted) {
-      startRecording({interval: 500});
+      const fileUri = await startRecording({interval: 500});
     }
   };
 
+  const handleStop = async () => {
+    const result: AudioStreamResult = await stopRecording();
+  };
+
   const renderRecording = () => (
     <View>
       <Text>Duration: {duration} ms</Text>
       <Text>Size: {size} bytes</Text>
-      <Button title="Stop Recording" onPress={stopRecording} />
+      <Button title="Stop Recording" onPress={handleStop} />
     </View>
   );
 
@@ -83,3 +90,65 @@ export default function App() {
 }
 ```
 
+The library also exposes an `addAudioEventListener` function that provides an `AudioEventPayload` object that you can subscribe to:
+```tsx
+export interface AudioEventPayload {
+  encoded?: string, 
+  buffer?: Blob,
+  fileUri: string,
+  from: number,
+  deltaSize: number,
+  totalSize: number,
+  mimeType: string;
+  streamUuid: string,
+};
+
+  useEffect(() => {
+    const subscribe = addAudioEventListener(async ({fileUri, deltaSize, totalSize, from, streamUuid, encoded, mimeType, buffer}) => {
+        log(`Received audio event:`, {fileUri, deltaSize, totalSize, mimeType, from, streamUuid, encodedLength: encoded?.length})
+        if(deltaSize > 0) {
+            // Coming from native ( ios / android ) otherwise buffer is set
+              if(Platform.OS !== 'web') {
+                // Read the audio file as a base64 string for comparison
+                try {
+                    // convert encoded string to binary data
+                    const binaryData = atob(encoded);
+                    const content = new Uint8Array(binaryData.length);
+                    for (let i = 0; i < binaryData.length; i++) {
+                        content[i] = binaryData.charCodeAt(i);
+                    }
+                    const audioBlob = new Blob([content], { type: mimeType });
+                    console.info(`Received audio blob:`, audioBlob);
+                } catch (error) {
+                    console.error('Error reading audio file:', error);
+                }
+            } else if(buffer) {
+                // Coming from web
+                console.info(`Received audio buffer:`, buffer)
+            }
+        }
+    });
+    return () => subscribe.remove();
+  }, []);
+```
+
+### Recording configuration
+
+- on Android and IOS, audio is recorded in wav format, 16khz sample rate, 16 bit depth, 1 channel.
+- on web, it usually records in opus  but it depends on the browser configuration.
+
+If you want to process the audio livestream directly, I recommend having another encoding step to align the audio format across platforms.
+
+
+### Debug Configuration
+
+This library uses the npm `debug` package, to enable logging you can:
+```
+localStorage.debug = 'expo-audio-stream:*'
+```
+or set the DEBUG environment variable to `expo-audio-stream:*`
+
+### TODO
+this package is still in development, and there are a few things that need to be done:
+- add multiple format for native audio stream (wav, mp3, opus)
+

package/android/src/main/java/net/siteed/audiostream/ExpoAudioStreamModule.kt

@@ -22,13 +22,18 @@ import java.util.concurrent.atomic.AtomicBoolean
 import java.io.File
 import java.io.FileOutputStream
 import java.io.IOException
+import java.io.RandomAccessFile
+
 const val AUDIO_EVENT_NAME = "AudioData"
+const val DEFAULT_SAMPLE_RATE = 16000 // Default sample rate for audio recording
+const val DEFAULT_CHANNEL_CONFIG = AudioFormat.CHANNEL_IN_MONO
+const val DEFAULT_AUDIO_FORMAT = AudioFormat.ENCODING_PCM_16BIT
 
 class ExpoAudioStreamModule() : Module() {
   private var audioRecord: AudioRecord? = null
-  private var sampleRateInHz = 44100  // Default sample rate
-  private var channelConfig = AudioFormat.CHANNEL_IN_MONO
-  private var audioFormat = AudioFormat.ENCODING_PCM_16BIT
+  private var sampleRateInHz = DEFAULT_SAMPLE_RATE
+  private var channelConfig = DEFAULT_CHANNEL_CONFIG
+  private var audioFormat = DEFAULT_AUDIO_FORMAT
   private var bufferSizeInBytes: Int = AudioRecord.getMinBufferSize(sampleRateInHz, channelConfig, audioFormat)
   private var isRecording = AtomicBoolean(false)
   private val isPaused = AtomicBoolean(false)
@@ -44,6 +49,7 @@ class ExpoAudioStreamModule() : Module() {
   private var lastPauseTime = 0L
   private var pausedDuration = 0L
   private var lastEmittedSize = 0L
+  private var mimeType = "audio/wav"
   private val mainHandler = Handler(Looper.getMainLooper())
 
   @SuppressLint("MissingPermission")
@@ -72,6 +78,7 @@ class ExpoAudioStreamModule() : Module() {
         "duration" to totalRecordedTime,
         "isRecording" to isRecording.get(),
         "isPaused" to isPaused.get(),
+        "mime" to mimeType,
         "size" to totalDataSize,
         "interval" to interval,
       )
@@ -87,26 +94,62 @@ class ExpoAudioStreamModule() : Module() {
     }
 
     AsyncFunction("pauseRecording") { promise: Promise ->
+      Log.d("AudioRecorderModule", "Pausing recording")
       pauseRecording(promise)
     }
 
     AsyncFunction("stopRecording") { promise: Promise ->
+      Log.d("AudioRecorderModule", "Stopping recording")
       stopRecording(promise)
     }
   }
 
+  // Method to write WAV file header
+  private fun writeWavHeader(out: FileOutputStream, channelConfig: Int, sampleRate: Int, audioFormat: Int) {
+    val channels = if (channelConfig == AudioFormat.CHANNEL_IN_MONO) 1 else 2
+    val bitDepth = if (audioFormat == AudioFormat.ENCODING_PCM_16BIT) 16 else 8
+
+    val header = ByteArray(44)
+    val byteRate = sampleRate * channels * bitDepth / 8
+    val blockAlign = channels * bitDepth / 8
+
+    // RIFF/WAVE header
+    "RIFF".toByteArray().copyInto(header, 0)
+    header[4] = 0 // Size will be updated later
+    "WAVE".toByteArray().copyInto(header, 8)
+    "fmt ".toByteArray().copyInto(header, 12)
+
+    // 16 for PCM
+    header[16] = 16
+    header[20] = 1 // Audio format 1 for PCM
+    header[22] = channels.toByte()
+    header[24] = (sampleRate and 0xff).toByte()
+    header[25] = (sampleRate shr 8 and 0xff).toByte()
+    header[26] = (sampleRate shr 16 and 0xff).toByte()
+    header[27] = (sampleRate shr 24 and 0xff).toByte()
+    header[28] = (byteRate and 0xff).toByte()
+    header[29] = (byteRate shr 8 and 0xff).toByte()
+    header[30] = (byteRate shr 16 and 0xff).toByte()
+    header[31] = (byteRate shr 24 and 0xff).toByte()
+    header[32] = blockAlign.toByte()
+    header[34] = bitDepth.toByte()
+    "data".toByteArray().copyInto(header, 36)
+
+    out.write(header, 0, 44)
+  }
+
   private fun configureRecording(params: Map<String, Any?>) {
-    sampleRateInHz = (params["sampleRate"] as? Int) ?: 44100
-    channelConfig = (params["channelConfig"] as? Int) ?: AudioFormat.CHANNEL_IN_MONO
-    audioFormat = (params["audioFormat"] as? Int) ?: AudioFormat.ENCODING_PCM_16BIT
+    sampleRateInHz = (params["sampleRate"] as? Int) ?: DEFAULT_SAMPLE_RATE
+    channelConfig = (params["channelConfig"] as? Int) ?: DEFAULT_CHANNEL_CONFIG
+    audioFormat = (params["audioFormat"] as? Int) ?: DEFAULT_AUDIO_FORMAT
     bufferSizeInBytes = AudioRecord.getMinBufferSize(sampleRateInHz, channelConfig, audioFormat)
   }
 
   private fun listAudioFiles(): List<String> {
     val filesDir = appContext.reactContext?.filesDir
-    // Filter to include only .pcm files
+    // Filter to include only .wav files
     val files = filesDir?.listFiles { file ->
-      file.isFile && file.name.endsWith(".pcm")
+      file.isFile && file.name.endsWith(".wav")
     }?.map { it.absolutePath } ?: listOf()  // Use `listOf()` to return an empty list if null
     return files
   }
@@ -143,7 +186,7 @@ class ExpoAudioStreamModule() : Module() {
     // Log for new recording or resuming
     if (!isPaused.get()) {
       streamUuid = java.util.UUID.randomUUID().toString()
-      audioFile = File(appContext.reactContext?.filesDir, "audio_${streamUuid}.pcm")
+      audioFile = File(appContext.reactContext?.filesDir, "audio_${streamUuid}.wav")
       Log.i("AudioRecorderModule", "Starting new recording $streamUuid with sample rate: $sampleRateInHz, channel config: $channelConfig, audio format: $audioFormat, buffer size: $bufferSizeInBytes, interval: $interval")
 
     } else {
@@ -156,6 +199,15 @@ class ExpoAudioStreamModule() : Module() {
       return
     }
 
+    try {
+      FileOutputStream(audioFile, true).use { fos ->
+        writeWavHeader(fos, channelConfig, sampleRateInHz, audioFormat)
+      }
+    } catch (e: IOException) {
+      promise.reject("FILE_CREATION_FAILED", "Failed to create audio file with WAV header", null)
+      return
+    }
+
     audioRecord?.startRecording()
     isPaused.set(false)
     isRecording.set(true)
@@ -166,7 +218,7 @@ class ExpoAudioStreamModule() : Module() {
     }
 
     recordingThread = Thread { recordingProcess() }.apply { start() }
-    promise.resolve(null)
+    promise.resolve(audioFile?.toURI().toString())
   }
 
   private fun stopRecording(promise: Promise) {
@@ -182,7 +234,19 @@ class ExpoAudioStreamModule() : Module() {
       totalRecordedTime += (endTime - recordingStartTime - pausedDuration)  // Adjust the total recording time
       isRecording.set(false)
       isPaused.set(false)
-      promise.resolve(totalRecordedTime)
+
+      // Calculate the file size
+      val fileSize = audioFile?.length() ?: 0
+
+      // Create result bundle
+      val result = bundleOf(
+        "fileUri" to audioFile?.toURI().toString(),
+        "duration" to totalRecordedTime,
+        "size" to fileSize,
+        "mimeType" to mimeType
+      )
+      promise.resolve(result)
+
       // Reset the timing variables
       totalRecordedTime = 0
       pausedDuration = 0
@@ -194,30 +258,49 @@ class ExpoAudioStreamModule() : Module() {
   }
 
   private fun recordingProcess() {
-
-    val audioData = ByteArray(bufferSizeInBytes)
-    while (isRecording.get()) {
-      if (!isPaused.get()) {
-        val bytesRead = audioRecord?.read(audioData, 0, bufferSizeInBytes) ?: -1
-        if (bytesRead < 0) {
-          Log.e("AudioRecorderModule", "Read error: $bytesRead")
-          break
-        }
-        if (bytesRead > 0) {
-          audioDataBuffer.write(audioData, 0, bytesRead)
-          totalDataSize += bytesRead
-          if (SystemClock.elapsedRealtime() - lastEmitTime >= interval) {
-            emitAudioData()
-            lastEmitTime = SystemClock.elapsedRealtime() // Reset the timer
+    FileOutputStream(audioFile, true).use { fos ->
+      // Write audio data directly to the file
+      val audioData = ByteArray(bufferSizeInBytes)
+      while (isRecording.get()) {
+        if (!isPaused.get()) {
+          val bytesRead = audioRecord?.read(audioData, 0, bufferSizeInBytes) ?: -1
+          if (bytesRead < 0) {
+            Log.e("AudioRecorderModule", "Read error: $bytesRead")
+            break
+          }
+          if (bytesRead > 0) {
+            fos.write(audioData, 0, bytesRead)
+            totalDataSize += bytesRead
+
+            // Emit audio data at defined intervals
+            if (SystemClock.elapsedRealtime() - lastEmitTime >= interval) {
+              emitAudioData(audioData, bytesRead)
+              lastEmitTime = SystemClock.elapsedRealtime() // Reset the timer
+            }
           }
         }
       }
     }
-    if (audioDataBuffer.size() > 0) {
-      emitAudioData() // Emit any remaining data
-    }
+    updateWavHeader() // Update the header with the correct file size after recording stops
   }
 
+  private fun updateWavHeader() {
+    try {
+      RandomAccessFile(audioFile, "rw").use { raf ->
+        val fileSize = raf.length()
+        val dataSize = fileSize - 44 // Subtract the header size
+        raf.seek(4) // Skip 'RIFF' label
+
+        // Write correct file size, excluding the first 8 bytes of the RIFF header
+        raf.writeInt(Integer.reverseBytes((dataSize + 36).toInt()))
+
+        raf.seek(40) // Go to the data size position
+        raf.writeInt(Integer.reverseBytes(dataSize.toInt())) // Write the size of the data segment
+      }
+    } catch (e: IOException) {
+      Log.e("AudioRecorderModule", "Could not update WAV header", e)
+    }
+  }
 
   private fun clearAudioStorage() {
     // Clear all files in the app's internal storage
@@ -228,34 +311,31 @@ class ExpoAudioStreamModule() : Module() {
     }
   }
 
-  private fun emitAudioData() {
-    val rawData = audioDataBuffer.toByteArray()
-    if (!saveAudioToFile(rawData)) {
-      Log.e("AudioRecorderModule", "Failed to save audio data")
-      return
-    }
-    val encodedBuffer = encodeAudioData(rawData)
-    val fileSize = audioFile?.length() ?: 0
+  private fun emitAudioData(audioData: ByteArray, length: Int) {
+    // Since audioData now contains the actual bytes read, you do not need to read from audioDataBuffer.
+    // Encode the part of the buffer that contains new audio data.
+    val encodedBuffer = encodeAudioData(audioData)
+    val fileSize = audioFile?.length() ?: 0 // Update file size information
     val from = lastEmittedSize
     val deltaSize = fileSize - lastEmittedSize
-    lastEmittedSize = fileSize
+    lastEmittedSize = fileSize // Update last emitted size
+
     mainHandler.post {
       try {
-        this@ExpoAudioStreamModule.sendEvent(AUDIO_EVENT_NAME,
-          bundleOf(
-            "fileUri" to audioFile?.toURI().toString(),
-            "from" to from,
-            "encoded" to encodedBuffer,
-            "deltaSize" to deltaSize,
-            "totalSize" to fileSize,
-            "streamUuid" to streamUuid
-          )
-        )
+        this@ExpoAudioStreamModule.sendEvent(AUDIO_EVENT_NAME, bundleOf(
+          "fileUri" to audioFile?.toURI().toString(),
+          "from" to from,
+          "encoded" to encodedBuffer,
+          "deltaSize" to deltaSize,
+          "mimeType" to mimeType,
+          "totalSize" to fileSize,
+          "streamUuid" to streamUuid
+        ))
       } catch (e: Exception) {
         Log.e("AudioRecorderModule", "Failed to send event", e)
       }
     }
-    audioDataBuffer.reset() // Clear the buffer after emitting
+    // audioDataBuffer.reset() is no longer needed here as we do not use the buffer to store ongoing data
   }
 
   private fun encodeAudioData(rawData: ByteArray): String {

package/build/ExpoAudioStream.types.d.ts

@@ -5,19 +5,24 @@ export interface AudioEventPayload {
     from: number;
     deltaSize: number;
     totalSize: number;
+    mimeType: string;
     streamUuid: string;
 }
+export interface AudioStreamResult {
+    fileUri: string;
+    duration: number;
+    size: number;
+    mimeType: string;
+}
 export interface AudioStreamStatus {
     isRecording: boolean;
     isPaused: boolean;
     duration: number;
     size: number;
     interval: number;
+    mimeType: string;
 }
 export interface RecordingOptions {
-    sampleRate?: number;
-    channelConfig?: number;
-    audioFormat?: number;
     interval?: number;
 }
 //# sourceMappingURL=ExpoAudioStream.types.d.ts.map

package/build/ExpoAudioStream.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoAudioStream.types.d.ts","sourceRoot":"","sources":["../src/ExpoAudioStream.types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,IAAI,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAE/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"ExpoAudioStream.types.d.ts","sourceRoot":"","sources":["../src/ExpoAudioStream.types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,IAAI,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAK/B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/build/ExpoAudioStream.types.js

@@ -1,3 +1,2 @@
-;
 export {};
 //# sourceMappingURL=ExpoAudioStream.types.js.map

package/build/ExpoAudioStream.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoAudioStream.types.js","sourceRoot":"","sources":["../src/ExpoAudioStream.types.ts"],"names":[],"mappings":"AAQC,CAAC","sourcesContent":["export interface AudioEventPayload {\n  encoded?: string, \n  buffer?: Blob,\n  fileUri: string,\n  from: number,\n  deltaSize: number,\n  totalSize: number,\n  streamUuid: string,\n};\n\nexport interface AudioStreamStatus {\n  isRecording: boolean;\n  isPaused: boolean;\n  duration: number;\n  size: number;\n  interval: number;\n}\n\nexport interface RecordingOptions {\n  // TODO align Android and IOS options\n  sampleRate?: number;\n  channelConfig?: number; // numberOfChannel\n  audioFormat?: number; // bitDepth (ENCODING_PCM_16BIT --> 2)\n  interval?: number;\n}\n"]}
+{"version":3,"file":"ExpoAudioStream.types.js","sourceRoot":"","sources":["../src/ExpoAudioStream.types.ts"],"names":[],"mappings":"","sourcesContent":["export interface AudioEventPayload {\n  encoded?: string;\n  buffer?: Blob;\n  fileUri: string;\n  from: number;\n  deltaSize: number;\n  totalSize: number;\n  mimeType: string;\n  streamUuid: string;\n}\n\nexport interface AudioStreamResult {\n  fileUri: string;\n  duration: number;\n  size: number;\n  mimeType: string;\n}\n\nexport interface AudioStreamStatus {\n  isRecording: boolean;\n  isPaused: boolean;\n  duration: number;\n  size: number;\n  interval: number;\n  mimeType: string;\n}\n\nexport interface RecordingOptions {\n  // TODO align Android and IOS options\n  // sampleRate?: number;\n  // channelConfig?: number; // numberOfChannel\n  // audioFormat?: number; // bitDepth (ENCODING_PCM_16BIT --> 2)\n  interval?: number;\n}\n"]}

package/build/ExpoAudioStreamModule.js

@@ -1,5 +1,5 @@
-import { requireNativeModule } from 'expo-modules-core';
+import { requireNativeModule } from "expo-modules-core";
 // It loads the native module object from the JSI or falls back to
 // the bridge module (from NativeModulesProxy) if the remote debugger is on.
-export default requireNativeModule('ExpoAudioStream');
+export default requireNativeModule("ExpoAudioStream");
 //# sourceMappingURL=ExpoAudioStreamModule.js.map

package/build/ExpoAudioStreamModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoAudioStreamModule.js","sourceRoot":"","sources":["../src/ExpoAudioStreamModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,kEAAkE;AAClE,4EAA4E;AAC5E,eAAe,mBAAmB,CAAC,iBAAiB,CAAC,CAAC","sourcesContent":["import { requireNativeModule } from 'expo-modules-core';\n\n// It loads the native module object from the JSI or falls back to\n// the bridge module (from NativeModulesProxy) if the remote debugger is on.\nexport default requireNativeModule('ExpoAudioStream');\n"]}
+{"version":3,"file":"ExpoAudioStreamModule.js","sourceRoot":"","sources":["../src/ExpoAudioStreamModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,kEAAkE;AAClE,4EAA4E;AAC5E,eAAe,mBAAmB,CAAC,iBAAiB,CAAC,CAAC","sourcesContent":["import { requireNativeModule } from \"expo-modules-core\";\n\n// It loads the native module object from the JSI or falls back to\n// the bridge module (from NativeModulesProxy) if the remote debugger is on.\nexport default requireNativeModule(\"ExpoAudioStream\");\n"]}

package/build/ExpoAudioStreamModule.web.d.ts

@@ -1,5 +1,5 @@
 import { EventEmitter } from "expo-modules-core";
-import { RecordingOptions } from "./ExpoAudioStream.types";
+import { AudioStreamResult, RecordingOptions } from "./ExpoAudioStream.types";
 declare class ExpoAudioStreamWeb extends EventEmitter {
     mediaRecorder: MediaRecorder | null;
     audioChunks: Blob[];
@@ -14,11 +14,11 @@ declare class ExpoAudioStreamWeb extends EventEmitter {
     streamUuid: string | null;
     constructor();
     getMediaStream(): Promise<MediaStream>;
-    startRecording(options?: RecordingOptions): Promise<void>;
+    startRecording(options?: RecordingOptions): Promise<string>;
     setupRecordingListeners(): void;
     emitAudioEvent(data: Blob): void;
     generateUUID(): string;
-    stopRecording(): Promise<number>;
+    stopRecording(): Promise<AudioStreamResult | null>;
     pauseRecording(): Promise<void>;
     status(): {
         isRecording: boolean;

package/build/ExpoAudioStreamModule.web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoAudioStreamModule.web.d.ts","sourceRoot":"","sources":["../src/ExpoAudioStreamModule.web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAqB,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE9E,cAAM,kBAAmB,SAAQ,YAAY;IACzC,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IACpC,WAAW,EAAE,IAAI,EAAE,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;;IA4BpB,cAAc;IAUd,cAAc,CAAC,OAAO,GAAE,gBAAqB;IAiBnD,uBAAuB;IA0BvB,cAAc,CAAC,IAAI,EAAE,IAAI;IAexB,YAAY;IASP,aAAa;IASb,cAAc;IAcpB,MAAM;;;;;;;IAUN,cAAc;IAId,eAAe;CAGlB;;AAED,wBAAwC"}
+{"version":3,"file":"ExpoAudioStreamModule.web.d.ts","sourceRoot":"","sources":["../src/ExpoAudioStreamModule.web.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAEL,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,yBAAyB,CAAC;AAGjC,cAAM,kBAAmB,SAAQ,YAAY;IAC3C,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IACpC,WAAW,EAAE,IAAI,EAAE,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;;IA2BpB,cAAc;IAUd,cAAc,CAAC,OAAO,GAAE,gBAAqB;IAmBnD,uBAAuB;IA0BvB,cAAc,CAAC,IAAI,EAAE,IAAI;IAgBzB,YAAY;IAUN,aAAa,IAAI,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAelD,cAAc;IAcpB,MAAM;;;;;;;IAUN,cAAc;IAId,eAAe;CAGhB;;AAED,wBAAwC"}

package/build/ExpoAudioStreamModule.web.js

@@ -1,4 +1,6 @@
+import debug from "debug";
 import { EventEmitter } from "expo-modules-core";
+const log = debug("expo-audio-stream:useAudioRecording");
 class ExpoAudioStreamWeb extends EventEmitter {
     mediaRecorder;
     audioChunks;
@@ -14,11 +16,11 @@ class ExpoAudioStreamWeb extends EventEmitter {
     constructor() {
         const mockNativeModule = {
             addListener: (eventName) => {
-                console.log(`Web addListener called for ${eventName}`);
+                // Not used on web
             },
             removeListeners: (count) => {
-                console.log(`Web removeListeners called, count: ${count}`);
-            }
+                // Not used on web
+            },
         };
         super(mockNativeModule); // Pass the mock native module to the parent class
         this.mediaRecorder = null;
@@ -46,7 +48,7 @@ class ExpoAudioStreamWeb extends EventEmitter {
     // Start recording with options
     async startRecording(options = {}) {
         if (this.isRecording) {
-            throw new Error('Recording is already in progress');
+            throw new Error("Recording is already in progress");
         }
         const stream = await this.getMediaStream();
         this.mediaRecorder = new MediaRecorder(stream);
@@ -57,11 +59,13 @@ class ExpoAudioStreamWeb extends EventEmitter {
         this.pausedTime = 0;
         this.lastEmittedSize = 0;
         this.streamUuid = this.generateUUID(); // Generate a UUID for the new recording session
+        const fileUri = `${this.streamUuid}.webm`;
+        return fileUri;
     }
     // Setup listeners for the MediaRecorder
     setupRecordingListeners() {
         if (!this.mediaRecorder) {
-            throw new Error('No active media recorder');
+            throw new Error("No active media recorder");
         }
         this.mediaRecorder.ondataavailable = (event) => {
             this.audioChunks.push(event.data);
@@ -71,55 +75,61 @@ class ExpoAudioStreamWeb extends EventEmitter {
         };
         this.mediaRecorder.onstop = () => {
             this.isRecording = false;
-            console.log('Recording stopped', this.audioChunks);
+            log("Recording stopped", this.audioChunks);
         };
         this.mediaRecorder.onpause = () => {
             this.isPaused = true;
         };
         this.mediaRecorder.onresume = () => {
             this.isPaused = false;
-            this.recordingStartTime += (Date.now() - this.pausedTime); // Adjust start time after resuming
+            this.recordingStartTime += Date.now() - this.pausedTime; // Adjust start time after resuming
         };
     }
     emitAudioEvent(data) {
-        const fileUri = `${this.streamUuid}.pcm`;
+        const fileUri = `${this.streamUuid}.webm`;
         const audioEventPayload = {
-            fileUri: fileUri,
+            fileUri,
+            mimeType: "audio/webm",
             from: this.lastEmittedSize, // Since this might be continuously streaming, adjust accordingly
             deltaSize: data.size,
             totalSize: this.currentSize,
             buffer: data,
-            streamUuid: this.streamUuid ?? '', // Generate or manage UUID for stream identification
+            streamUuid: this.streamUuid ?? "", // Generate or manage UUID for stream identification
         };
-        this.emit('AudioData', audioEventPayload);
+        this.emit("AudioData", audioEventPayload);
     }
     // Helper method to generate a UUID
     generateUUID() {
         // Implementation of UUID generation (use a library or custom method)
-        return 'xxxx-xxxx-xxxx-xxxx'.replace(/[x]/g, (c) => {
-            const r = Math.random() * 16 | 0, v = c == 'x' ? r : (r & 0x3 | 0x8);
+        return "xxxx-xxxx-xxxx-xxxx".replace(/[x]/g, (c) => {
+            const r = (Math.random() * 16) | 0, v = c === "x" ? r : (r & 0x3) | 0x8;
             return v.toString(16);
         });
     }
     // Stop recording
     async stopRecording() {
-        console.debug('Stopping recording', this);
         this.mediaRecorder?.stop();
         this.isRecording = false;
         this.currentDuration = (Date.now() - this.recordingStartTime) / 1000;
-        return this.currentDuration;
+        const result = {
+            fileUri: `${this.streamUuid}.webm`,
+            duration: this.currentDuration,
+            size: this.currentSize,
+            mimeType: "audio/webm",
+        };
+        return result;
     }
     // Pause recording
     async pauseRecording() {
         if (!this.mediaRecorder) {
-            throw new Error('No active media recorder');
+            throw new Error("No active media recorder");
         }
         if (this.isRecording && !this.isPaused) {
             this.mediaRecorder.pause();
             this.pausedTime = Date.now();
         }
         else {
-            throw new Error('Recording is not active or already paused');
+            throw new Error("Recording is not active or already paused");
         }
     }
     // Get current status