@siteed/expo-audio-stream 1.1.5 → 1.1.7

package/build/utils/writeWavHeader.js

@@ -1,7 +1,40 @@
+// packages/expo-audio-stream/src/utils/writeWavHeader.ts
+/**
+ * Writes or updates a WAV (RIFF) header based on the provided options.
+ *
+ * This function can be used in three ways:
+ * 1. To create a standalone WAV header (when no buffer is provided).
+ * 2. To create a WAV header and combine it with existing audio data (when a buffer without a header is provided).
+ * 3. To update an existing WAV header in the provided buffer.
+ *
+ * For streaming audio where the final size is unknown, this function sets the size fields
+ * to the maximum 32-bit value (0xFFFFFFFF). These can be updated later using the
+ * `updateWavHeaderSize` function once the final size is known.
+ *
+ * @param options - The options for creating or updating the WAV header.
+ * @returns An ArrayBuffer containing the WAV header, or the header combined with the provided audio data.
+ *
+ * @throws {Error} Throws an error if the provided options are invalid or if the buffer is too small.
+ *
+ * @example
+ * // Create a standalone WAV header
+ * const header = writeWavHeader({
+ *   sampleRate: 44100,
+ *   numChannels: 2,
+ *   bitDepth: 16
+ * });
+ *
+ * @example
+ * // Create a WAV header and combine it with audio data
+ * const completeWav = writeWavHeader({
+ *   buffer: audioData,
+ *   sampleRate: 44100,
+ *   numChannels: 2,
+ *   bitDepth: 16
+ * });
+ */
 export const writeWavHeader = ({ buffer, sampleRate, numChannels, bitDepth, }) => {
     const bytesPerSample = bitDepth / 8;
-    const numSamples = buffer.byteLength / (numChannels * bytesPerSample);
-    const view = new DataView(buffer);
     const blockAlign = numChannels * bytesPerSample;
     const byteRate = sampleRate * blockAlign;
     // Function to write a string to the DataView
@@ -10,16 +43,10 @@ export const writeWavHeader = ({ buffer, sampleRate, numChannels, bitDepth, }) =
             view.setUint8(offset + i, string.charCodeAt(i));
         }
     };
-    // Check if the buffer already has a WAV header by looking for "RIFF" at the start
-    const existingHeader = view.getUint32(0, false) === 0x52494646; // "RIFF" in ASCII
-    if (!existingHeader) {
-        // Ensure the buffer is large enough for the WAV header
-        if (buffer.byteLength < 44) {
-            throw new Error('Buffer is too small to contain a valid WAV header');
-        }
-        // Write the WAV header
+    // Function to write or update the header
+    const writeHeader = (view, dataSize = 0xffffffff) => {
         writeString(view, 0, 'RIFF'); // ChunkID
-        view.setUint32(4, 36 + numSamples * blockAlign, true); // ChunkSize
+        view.setUint32(4, 36 + dataSize, true); // ChunkSize
         writeString(view, 8, 'WAVE'); // Format
         writeString(view, 12, 'fmt '); // Subchunk1ID
         view.setUint32(16, 16, true); // Subchunk1Size (16 for PCM)
@@ -30,16 +57,35 @@ export const writeWavHeader = ({ buffer, sampleRate, numChannels, bitDepth, }) =
         view.setUint16(32, blockAlign, true); // BlockAlign
         view.setUint16(34, bitDepth, true); // BitsPerSample
         writeString(view, 36, 'data'); // Subchunk2ID
-        view.setUint32(40, numSamples * blockAlign, true); // Subchunk2Size
+        view.setUint32(40, dataSize, true); // Subchunk2Size
+    };
+    if (buffer) {
+        if (buffer.byteLength < 44) {
+            throw new Error('Buffer is too small to contain a valid WAV header');
+        }
+        const view = new DataView(buffer);
+        // Check if the buffer already has a WAV header by looking for "RIFF" at the start
+        const existingHeader = view.getUint32(0, false) === 0x52494646; // "RIFF" in ASCII
+        if (existingHeader) {
+            // Update the existing header
+            writeHeader(view, buffer.byteLength - 44);
+            return buffer;
+        }
+        else {
+            // Combine the new header with the existing buffer
+            const newBuffer = new ArrayBuffer(44 + buffer.byteLength);
+            const newView = new DataView(newBuffer);
+            writeHeader(newView, buffer.byteLength);
+            new Uint8Array(newBuffer).set(new Uint8Array(buffer), 44);
+            return newBuffer;
+        }
     }
     else {
-        // Update the existing WAV header if necessary
-        view.setUint32(4, 36 + numSamples * blockAlign, true); // Update ChunkSize
-        view.setUint32(24, sampleRate, true); // Update SampleRate
-        view.setUint32(28, byteRate, true); // Update ByteRate
-        view.setUint16(32, blockAlign, true); // Update BlockAlign
-        view.setUint32(40, numSamples * blockAlign, true); // Update Subchunk2Size
+        // Create a standalone header
+        const headerBuffer = new ArrayBuffer(44);
+        const view = new DataView(headerBuffer);
+        writeHeader(view);
+        return headerBuffer;
     }
-    return buffer;
 };
 //# sourceMappingURL=writeWavHeader.js.map

package/build/utils/writeWavHeader.js.map

@@ -1 +1 @@
-{"version":3,"file":"writeWavHeader.js","sourceRoot":"","sources":["../../src/utils/writeWavHeader.ts"],"names":[],"mappings":"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","sourcesContent":["// packages/expo-audio-stream/src/utils/writeWavHeader.ts\ninterface WavHeaderOptions {\n    buffer: ArrayBuffer\n    sampleRate: number\n    numChannels: number\n    bitDepth: number\n}\n\nexport const writeWavHeader = ({\n    buffer,\n    sampleRate,\n    numChannels,\n    bitDepth,\n}: WavHeaderOptions): ArrayBuffer => {\n    const bytesPerSample = bitDepth / 8\n    const numSamples = buffer.byteLength / (numChannels * bytesPerSample)\n    const view = new DataView(buffer)\n    const blockAlign = numChannels * bytesPerSample\n    const byteRate = sampleRate * blockAlign\n\n    // Function to write a string to the DataView\n    const writeString = (view: DataView, offset: number, string: string) => {\n        for (let i = 0; i < string.length; i++) {\n            view.setUint8(offset + i, string.charCodeAt(i))\n        }\n    }\n\n    // Check if the buffer already has a WAV header by looking for \"RIFF\" at the start\n    const existingHeader = view.getUint32(0, false) === 0x52494646 // \"RIFF\" in ASCII\n\n    if (!existingHeader) {\n        // Ensure the buffer is large enough for the WAV header\n        if (buffer.byteLength < 44) {\n            throw new Error('Buffer is too small to contain a valid WAV header')\n        }\n\n        // Write the WAV header\n        writeString(view, 0, 'RIFF') // ChunkID\n        view.setUint32(4, 36 + numSamples * blockAlign, true) // ChunkSize\n        writeString(view, 8, 'WAVE') // Format\n        writeString(view, 12, 'fmt ') // Subchunk1ID\n        view.setUint32(16, 16, true) // Subchunk1Size (16 for PCM)\n        view.setUint16(20, bitDepth === 32 ? 3 : 1, true) // AudioFormat (3 for float, 1 for PCM)\n        view.setUint16(22, numChannels, true) // NumChannels\n        view.setUint32(24, sampleRate, true) // SampleRate\n        view.setUint32(28, byteRate, true) // ByteRate\n        view.setUint16(32, blockAlign, true) // BlockAlign\n        view.setUint16(34, bitDepth, true) // BitsPerSample\n        writeString(view, 36, 'data') // Subchunk2ID\n        view.setUint32(40, numSamples * blockAlign, true) // Subchunk2Size\n    } else {\n        // Update the existing WAV header if necessary\n        view.setUint32(4, 36 + numSamples * blockAlign, true) // Update ChunkSize\n        view.setUint32(24, sampleRate, true) // Update SampleRate\n        view.setUint32(28, byteRate, true) // Update ByteRate\n        view.setUint16(32, blockAlign, true) // Update BlockAlign\n        view.setUint32(40, numSamples * blockAlign, true) // Update Subchunk2Size\n    }\n\n    return buffer\n}\n"]}
+{"version":3,"file":"writeWavHeader.js","sourceRoot":"","sources":["../../src/utils/writeWavHeader.ts"],"names":[],"mappings":"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","sourcesContent":["// packages/expo-audio-stream/src/utils/writeWavHeader.ts\n\n/**\n * Options for creating a WAV header.\n */\nexport interface WavHeaderOptions {\n    /** Optional buffer containing audio data. If provided, it will be combined with the header. */\n    buffer?: ArrayBuffer\n    /** The sample rate of the audio in Hz (e.g., 44100). */\n    sampleRate: number\n    /** The number of audio channels (e.g., 1 for mono, 2 for stereo). */\n    numChannels: number\n    /** The bit depth of the audio (e.g., 16, 24, or 32). */\n    bitDepth: number\n}\n\n/**\n * Writes or updates a WAV (RIFF) header based on the provided options.\n *\n * This function can be used in three ways:\n * 1. To create a standalone WAV header (when no buffer is provided).\n * 2. To create a WAV header and combine it with existing audio data (when a buffer without a header is provided).\n * 3. To update an existing WAV header in the provided buffer.\n *\n * For streaming audio where the final size is unknown, this function sets the size fields\n * to the maximum 32-bit value (0xFFFFFFFF). These can be updated later using the\n * `updateWavHeaderSize` function once the final size is known.\n *\n * @param options - The options for creating or updating the WAV header.\n * @returns An ArrayBuffer containing the WAV header, or the header combined with the provided audio data.\n *\n * @throws {Error} Throws an error if the provided options are invalid or if the buffer is too small.\n *\n * @example\n * // Create a standalone WAV header\n * const header = writeWavHeader({\n *   sampleRate: 44100,\n *   numChannels: 2,\n *   bitDepth: 16\n * });\n *\n * @example\n * // Create a WAV header and combine it with audio data\n * const completeWav = writeWavHeader({\n *   buffer: audioData,\n *   sampleRate: 44100,\n *   numChannels: 2,\n *   bitDepth: 16\n * });\n */\nexport const writeWavHeader = ({\n    buffer,\n    sampleRate,\n    numChannels,\n    bitDepth,\n}: WavHeaderOptions): ArrayBuffer => {\n    const bytesPerSample = bitDepth / 8\n    const blockAlign = numChannels * bytesPerSample\n    const byteRate = sampleRate * blockAlign\n\n    // Function to write a string to the DataView\n    const writeString = (view: DataView, offset: number, string: string) => {\n        for (let i = 0; i < string.length; i++) {\n            view.setUint8(offset + i, string.charCodeAt(i))\n        }\n    }\n\n    // Function to write or update the header\n    const writeHeader = (view: DataView, dataSize: number = 0xffffffff) => {\n        writeString(view, 0, 'RIFF') // ChunkID\n        view.setUint32(4, 36 + dataSize, true) // ChunkSize\n        writeString(view, 8, 'WAVE') // Format\n        writeString(view, 12, 'fmt ') // Subchunk1ID\n        view.setUint32(16, 16, true) // Subchunk1Size (16 for PCM)\n        view.setUint16(20, bitDepth === 32 ? 3 : 1, true) // AudioFormat (3 for float, 1 for PCM)\n        view.setUint16(22, numChannels, true) // NumChannels\n        view.setUint32(24, sampleRate, true) // SampleRate\n        view.setUint32(28, byteRate, true) // ByteRate\n        view.setUint16(32, blockAlign, true) // BlockAlign\n        view.setUint16(34, bitDepth, true) // BitsPerSample\n        writeString(view, 36, 'data') // Subchunk2ID\n        view.setUint32(40, dataSize, true) // Subchunk2Size\n    }\n\n    if (buffer) {\n        if (buffer.byteLength < 44) {\n            throw new Error('Buffer is too small to contain a valid WAV header')\n        }\n\n        const view = new DataView(buffer)\n\n        // Check if the buffer already has a WAV header by looking for \"RIFF\" at the start\n        const existingHeader = view.getUint32(0, false) === 0x52494646 // \"RIFF\" in ASCII\n\n        if (existingHeader) {\n            // Update the existing header\n            writeHeader(view, buffer.byteLength - 44)\n            return buffer\n        } else {\n            // Combine the new header with the existing buffer\n            const newBuffer = new ArrayBuffer(44 + buffer.byteLength)\n            const newView = new DataView(newBuffer)\n            writeHeader(newView, buffer.byteLength)\n            new Uint8Array(newBuffer).set(new Uint8Array(buffer), 44)\n            return newBuffer\n        }\n    } else {\n        // Create a standalone header\n        const headerBuffer = new ArrayBuffer(44)\n        const view = new DataView(headerBuffer)\n        writeHeader(view)\n        return headerBuffer\n    }\n}\n"]}

package/expo-module.config.json

@@ -0,0 +1,9 @@
+{
+    "platforms": ["ios", "tvos", "android", "web"],
+    "ios": {
+        "modules": ["ExpoAudioStreamModule"]
+    },
+    "android": {
+        "modules": ["net.siteed.audiostream.ExpoAudioStreamModule"]
+    }
+}

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@siteed/expo-audio-stream",
-  "version": "1.1.5",
+  "version": "1.1.7",
   "description": "stream audio crossplatform",
   "license": "MIT",
   "main": "build/index.js",
   "types": "build/index.d.ts",
   "author": "Arthur Breton <abreton@siteed.net> (https://github.com/deeeed)",
-  "homepage": "https://github.com/deeeed/expo-audio-stream#readme",
+  "homepage": "https://github.com/deeeed/expo-audio-stream/blob/main/packages/expo-audio-stream/README.md",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/deeeed/expo-audio-stream.git",
@@ -21,26 +21,6 @@
     "expo-audio-stream",
     "ExpoAudioStream"
   ],
-  "files": [
-    "android",
-    "ios",
-    "cpp",
-    "build",
-    "generated",
-    "README.md",
-    "package.json",
-    "*.podspec",
-    "!ios/build",
-    "!android/build",
-    "!android/gradle",
-    "!android/gradlew",
-    "!android/gradlew.bat",
-    "!android/local.properties",
-    "!**/__tests__",
-    "!**/__fixtures__",
-    "!**/__mocks__",
-    "!**/.*"
-  ],
   "scripts": {
     "build": "expo-module build",
     "clean": "expo-module clean",

package/plugin/build/index.d.ts

@@ -0,0 +1,5 @@
+import { ConfigPlugin } from '@expo/config-plugins';
+declare const withRecordingPermission: ConfigPlugin<{
+    microphonePermission: string;
+}>;
+export default withRecordingPermission;

package/plugin/build/index.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const config_plugins_1 = require("@expo/config-plugins");
+const MICROPHONE_USAGE = 'Allow $(PRODUCT_NAME) to access your microphone';
+const withRecordingPermission = (config, existingPerms) => {
+    if (!existingPerms) {
+        console.warn('No previous permissions provided');
+    }
+    config = (0, config_plugins_1.withInfoPlist)(config, (config) => {
+        config.modResults['NSMicrophoneUsageDescription'] = MICROPHONE_USAGE;
+        // Add audio to UIBackgroundModes to allow background audio recording
+        const existingBackgroundModes = config.modResults.UIBackgroundModes || [];
+        if (!existingBackgroundModes.includes('audio')) {
+            existingBackgroundModes.push('audio');
+        }
+        config.modResults.UIBackgroundModes = existingBackgroundModes;
+        return config;
+    });
+    config = (0, config_plugins_1.withAndroidManifest)(config, (config) => {
+        const mainApplication = config_plugins_1.AndroidConfig.Manifest.getMainApplicationOrThrow(config.modResults);
+        config_plugins_1.AndroidConfig.Manifest.addMetaDataItemToMainApplication(mainApplication, 'android.permission.RECORD_AUDIO', MICROPHONE_USAGE);
+        // Add FOREGROUND_SERVICE permission for handling background recording
+        config_plugins_1.AndroidConfig.Manifest.addMetaDataItemToMainApplication(mainApplication, 'android.permission.FOREGROUND_SERVICE', 'This apps needs access to the foreground service to record audio in the background');
+        return config;
+    });
+    return config;
+};
+exports.default = withRecordingPermission;

package/plugin/src/index.ts

@@ -0,0 +1,53 @@
+import {
+    AndroidConfig,
+    ConfigPlugin,
+    withAndroidManifest,
+    withInfoPlist,
+} from '@expo/config-plugins'
+
+const MICROPHONE_USAGE = 'Allow $(PRODUCT_NAME) to access your microphone'
+
+const withRecordingPermission: ConfigPlugin<{
+    microphonePermission: string
+}> = (config, existingPerms) => {
+    if (!existingPerms) {
+        console.warn('No previous permissions provided')
+    }
+    config = withInfoPlist(config, (config) => {
+        config.modResults['NSMicrophoneUsageDescription'] = MICROPHONE_USAGE
+
+        // Add audio to UIBackgroundModes to allow background audio recording
+        const existingBackgroundModes =
+            config.modResults.UIBackgroundModes || []
+        if (!existingBackgroundModes.includes('audio')) {
+            existingBackgroundModes.push('audio')
+        }
+        config.modResults.UIBackgroundModes = existingBackgroundModes
+
+        return config
+    })
+
+    config = withAndroidManifest(config, (config) => {
+        const mainApplication =
+            AndroidConfig.Manifest.getMainApplicationOrThrow(config.modResults)
+
+        AndroidConfig.Manifest.addMetaDataItemToMainApplication(
+            mainApplication,
+            'android.permission.RECORD_AUDIO',
+            MICROPHONE_USAGE
+        )
+
+        // Add FOREGROUND_SERVICE permission for handling background recording
+        AndroidConfig.Manifest.addMetaDataItemToMainApplication(
+            mainApplication,
+            'android.permission.FOREGROUND_SERVICE',
+            'This apps needs access to the foreground service to record audio in the background'
+        )
+
+        return config
+    })
+
+    return config
+}
+
+export default withRecordingPermission

package/plugin/tsconfig.json

@@ -0,0 +1,9 @@
+{
+    "extends": "expo-module-scripts/tsconfig.plugin",
+    "compilerOptions": {
+        "outDir": "build",
+        "rootDir": "src"
+    },
+    "include": ["./src"],
+    "exclude": ["**/__mocks__/*", "**/__tests__/*"]
+}

package/publish.sh

@@ -0,0 +1,9 @@
+#!/bin/bash
+set -e
+# Bump version
+yarn version patch
+version=$(node -p "require('./package.json').version")
+git add .
+git commit -m "feat: bump version to $version"
+yarn clean && yarn prepare && yarn npm publish
+rm package-lock.json

package/src/AudioAnalysis/AudioAnalysis.types.ts

@@ -0,0 +1,84 @@
+// packages/expo-audio-stream/src/AudioAnalysis/AudioAnalysis.types.ts
+
+/**
+ * Represents various audio features extracted from an audio signal.
+ */
+export interface AudioFeatures {
+    energy: number // The infinite integral of the squared signal, representing the overall energy of the audio.
+    mfcc: number[] // Mel-frequency cepstral coefficients, describing the short-term power spectrum of a sound.
+    rms: number // Root mean square value, indicating the amplitude of the audio signal.
+    minAmplitude: number // Minimum amplitude value in the audio signal.
+    maxAmplitude: number // Maximum amplitude value in the audio signal.
+    zcr: number // Zero-crossing rate, indicating the rate at which the signal changes sign.
+    spectralCentroid: number // The center of mass of the spectrum, indicating the brightness of the sound.
+    spectralFlatness: number // Measure of the flatness of the spectrum, indicating how noise-like the signal is.
+    spectralRolloff: number // The frequency below which a specified percentage (usually 85%) of the total spectral energy lies.
+    spectralBandwidth: number // The width of the spectrum, indicating the range of frequencies present.
+    chromagram: number[] // Chromagram, representing the 12 different pitch classes of the audio.
+    tempo: number // Estimated tempo of the audio signal, measured in beats per minute (BPM).
+    hnr: number // Harmonics-to-noise ratio, indicating the proportion of harmonics to noise in the audio signal.
+}
+
+/**
+ * Options to specify which audio features to extract.
+ */
+export interface AudioFeaturesOptions {
+    energy?: boolean
+    mfcc?: boolean
+    rms?: boolean
+    zcr?: boolean
+    spectralCentroid?: boolean
+    spectralFlatness?: boolean
+    spectralRolloff?: boolean
+    spectralBandwidth?: boolean
+    chromagram?: boolean
+    tempo?: boolean
+    hnr?: boolean
+}
+
+/**
+ * Represents a single data point in the audio analysis.
+ */
+export interface DataPoint {
+    id: number
+    amplitude: number
+    activeSpeech?: boolean
+    dB?: number
+    silent?: boolean
+    features?: AudioFeatures
+    startTime?: number
+    endTime?: number
+    // start / end position in bytes
+    startPosition?: number
+    endPosition?: number
+    // number of audio samples for this point (samples size depends on bit depth)
+    samples?: number
+    // TODO: speaker detection
+    speaker?: number
+}
+
+export type AmplitudeAlgorithm = 'peak' | 'rms'
+
+/**
+ * Represents the complete data from the audio analysis.
+ */
+export interface AudioAnalysis {
+    pointsPerSecond: number // How many consolidated value per second
+    durationMs: number // Duration of the audio in milliseconds
+    bitDepth: number // Bit depth of the audio
+    samples: number // Size of the audio in bytes
+    numberOfChannels: number // Number of audio channels
+    sampleRate: number // Sample rate of the audio
+    dataPoints: DataPoint[] // Array of data points from the analysis.
+    amplitudeAlgorithm: AmplitudeAlgorithm // Algorithm used to calculate amplitude values.
+    amplitudeRange: {
+        min: number
+        max: number
+    }
+    // TODO: speaker detection
+    speakerChanges?: {
+        timestamp: number // Timestamp of the speaker change in milliseconds.
+        speaker: number // Speaker identifier.
+    }[]
+}
+

package/src/AudioAnalysis/extractAudioAnalysis.ts

@@ -0,0 +1,147 @@
+// packages/expo-audio-stream/src/AudioAnalysis/extractAudioAnalysis.ts
+import {
+    AmplitudeAlgorithm,
+    AudioAnalysis,
+    AudioFeaturesOptions,
+} from './AudioAnalysis.types'
+import ExpoAudioStreamModule from '../ExpoAudioStreamModule'
+import { isWeb } from '../constants'
+import { getLogger } from '../logger'
+import { convertPCMToFloat32 } from '../utils/convertPCMToFloat32'
+import { getWavFileInfo, WavFileInfo } from '../utils/getWavFileInfo'
+import { InlineFeaturesExtractor } from '../workers/InlineFeaturesExtractor.web'
+
+const logger = getLogger('extractAudioAnalysis')
+
+export interface ExtractAudioAnalysisProps {
+    fileUri?: string // should provide either fileUri or arrayBuffer
+    wavMetadata?: WavFileInfo
+    arrayBuffer?: ArrayBuffer
+    bitDepth?: number
+    skipWavHeader?: boolean
+    durationMs?: number
+    sampleRate?: number
+    numberOfChannels?: number
+    algorithm?: AmplitudeAlgorithm
+    position?: number // Optional number of bytes to skip. Default is 0
+    length?: number // Optional number of bytes to read.
+    pointsPerSecond?: number // Optional number of points per second. Use to reduce the number of points and compute the number of datapoints to return.
+    features?: AudioFeaturesOptions
+    featuresExtratorUrl?: string
+}
+
+export const extractAudioAnalysis = async ({
+    fileUri,
+    pointsPerSecond = 20,
+    arrayBuffer,
+    bitDepth,
+    skipWavHeader = true,
+    durationMs,
+    sampleRate,
+    numberOfChannels,
+    algorithm = 'rms',
+    features,
+    featuresExtratorUrl,
+}: ExtractAudioAnalysisProps): Promise<AudioAnalysis> => {
+    if (isWeb) {
+        if (!arrayBuffer && !fileUri) {
+            throw new Error('Either arrayBuffer or fileUri must be provided')
+        }
+
+        if (!arrayBuffer) {
+            logger.log(`fetching fileUri`, fileUri)
+            const response = await fetch(fileUri!)
+
+            if (!response.ok) {
+                throw new Error(
+                    `Failed to fetch fileUri: ${response.statusText}`
+                )
+            }
+
+            arrayBuffer = await response.arrayBuffer()
+            logger.log(`fetched fileUri`, arrayBuffer.byteLength, arrayBuffer)
+        }
+
+        // Create a new copy of the ArrayBuffer to avoid detachment issues
+        const bufferCopy = arrayBuffer.slice(0)
+        logger.log(
+            `extractAudioAnalysis skipWavHeader=${skipWavHeader} bitDepth=${bitDepth} len=${bufferCopy.byteLength}`,
+            bufferCopy.slice(0, 100)
+        )
+
+        let actualBitDepth = bitDepth
+        if (!actualBitDepth) {
+            logger.log(
+                `extractAudioAnalysis bitDepth not provided -- getting wav file info`
+            )
+            const fileInfo = await getWavFileInfo(bufferCopy)
+            actualBitDepth = fileInfo.bitDepth
+        }
+        logger.log(`extractAudioAnalysis actualBitDepth=${actualBitDepth}`)
+
+        const {
+            pcmValues: channelData,
+            min,
+            max,
+        } = await convertPCMToFloat32({
+            buffer: arrayBuffer,
+            bitDepth: actualBitDepth,
+            skipWavHeader,
+        })
+        logger.log(
+            `extractAudioAnalysis skipWaveHeader=${skipWavHeader} convertPCMToFloat32 length=${channelData.length} range: [ ${min} :: ${max} ]`
+        )
+
+        return new Promise((resolve, reject) => {
+            let worker: Worker
+            if (featuresExtratorUrl) {
+                worker = new Worker(
+                    new URL(featuresExtratorUrl, window.location.href)
+                )
+            } else {
+                const blob = new Blob([InlineFeaturesExtractor], {
+                    type: 'application/javascript',
+                })
+                const url = URL.createObjectURL(blob)
+                worker = new Worker(url)
+            }
+
+            worker.onmessage = (event) => {
+                resolve(event.data.result)
+            }
+
+            worker.onerror = (error) => {
+                reject(error)
+            }
+
+            worker.postMessage({
+                command: 'process',
+                channelData,
+                sampleRate,
+                pointsPerSecond,
+                algorithm,
+                bitDepth,
+                fullAudioDurationMs: durationMs,
+                numberOfChannels,
+            })
+        })
+    } else {
+        if (!fileUri) {
+            throw new Error('fileUri is required')
+        }
+        logger.log(`extractAudioAnalysis`, {
+            fileUri,
+            pointsPerSecond,
+            algorithm,
+        })
+        const res = await ExpoAudioStreamModule.extractAudioAnalysis({
+            fileUri,
+            pointsPerSecond,
+            skipWavHeader,
+            algorithm,
+            features,
+        })
+        logger.log(`extractAudioAnalysis`, res)
+        return res
+    }
+}

package/src/AudioAnalysis/extractWaveform.ts

@@ -0,0 +1,25 @@
+import ExpoAudioStreamModule from '../ExpoAudioStreamModule'
+import { getLogger } from '../logger'
+
+const logger = getLogger('extractWaveform')
+export interface ExtractWaveformProps {
+    fileUri: string
+    numberOfSamples: number
+    offset?: number
+    length?: number
+}
+export const extractWaveform = async ({
+    fileUri,
+    numberOfSamples,
+    offset = 0,
+    length,
+}: ExtractWaveformProps): Promise<unknown> => {
+    const res = await ExpoAudioStreamModule.extractAudioAnalysis({
+        fileUri,
+        numberOfSamples,
+        offset,
+        length,
+    })
+    logger.log(`extractWaveform`, res)
+    return res
+}

package/src/AudioRecorder.provider.tsx

@@ -0,0 +1,53 @@
+// packages/expo-audio-stream/src/AudioRecorder.provider.tsx
+import React, { createContext, useContext } from 'react'
+
+import { UseAudioRecorderState } from './ExpoAudioStream.types'
+import { UseAudioRecorderProps, useAudioRecorder } from './useAudioRecorder'
+
+const initContext: UseAudioRecorderState = {
+    isRecording: false,
+    isPaused: false,
+    durationMs: 0,
+    size: 0,
+    startRecording: async () => {
+        throw new Error('AudioRecorderProvider not found')
+    },
+    stopRecording: async () => {
+        throw new Error('AudioRecorderProvider not found')
+    },
+    pauseRecording: () => {
+        throw new Error('AudioRecorderProvider not found')
+    },
+    resumeRecording: () => {
+        throw new Error('AudioRecorderProvider not found')
+    },
+}
+
+const AudioRecorderContext = createContext<UseAudioRecorderState>(initContext)
+
+interface AudioRecorderProviderProps {
+    children: React.ReactNode
+    config?: UseAudioRecorderProps
+}
+
+export const AudioRecorderProvider: React.FC<AudioRecorderProviderProps> = ({
+    children,
+    config = {},
+}) => {
+    const audioRecorder = useAudioRecorder(config)
+    return (
+        <AudioRecorderContext.Provider value={audioRecorder}>
+            {children}
+        </AudioRecorderContext.Provider>
+    )
+}
+
+export const useSharedAudioRecorder = () => {
+    const context = useContext(AudioRecorderContext)
+    if (!context) {
+        throw new Error(
+            'useSharedAudioRecorder must be used within an AudioRecorderProvider'
+        )
+    }
+    return context
+}

package/src/ExpoAudioStream.native.ts

@@ -0,0 +1,6 @@
+// src/ExpoAudioStreamModule.ts
+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')