@siteed/audio-studio 3.0.0

package/build/esm/utils/audioProcessing.js

@@ -0,0 +1,133 @@
+// packages/audio-studio/src/utils/audioProcessing.ts
+import { Platform } from 'react-native';
+export async function processAudioBuffer({ arrayBuffer, fileUri, targetSampleRate, targetChannels, normalizeAudio, startTimeMs, endTimeMs, position, length, audioContext, logger, }) {
+    if (Platform.OS !== 'web') {
+        throw new Error('processAudioBuffer is only supported on web');
+    }
+    let ctx;
+    let buffer;
+    try {
+        // Log initial parameters
+        logger?.debug('Process audio buffer - Initial params:', {
+            hasArrayBuffer: !!arrayBuffer,
+            fileUri,
+            targetSampleRate,
+            targetChannels,
+            normalizeAudio,
+            startTimeMs,
+            endTimeMs,
+            position,
+            length,
+        });
+        // Get the audio data
+        let audioData;
+        if (arrayBuffer) {
+            audioData = arrayBuffer;
+        }
+        else if (fileUri) {
+            const response = await fetch(fileUri);
+            if (!response.ok) {
+                throw new Error(`Failed to fetch fileUri: ${response.statusText}`);
+            }
+            audioData = await response.arrayBuffer();
+        }
+        else {
+            throw new Error('Either arrayBuffer or fileUri must be provided');
+        }
+        logger?.debug('Audio data loaded:', {
+            byteLength: audioData.byteLength,
+            firstBytes: Array.from(new Uint8Array(audioData.slice(0, 16))),
+        });
+        // Create context at original sample rate first
+        ctx =
+            audioContext ||
+                new (window.AudioContext || window.webkitAudioContext)();
+        buffer = await ctx.decodeAudioData(audioData);
+        logger?.debug('Decoded audio buffer:', {
+            originalChannels: buffer.numberOfChannels,
+            originalSampleRate: buffer.sampleRate,
+            originalDuration: buffer.duration,
+            originalLength: buffer.length,
+        });
+        // Calculate time range
+        const startSample = startTimeMs !== undefined
+            ? Math.floor((startTimeMs / 1000) * buffer.sampleRate)
+            : position !== undefined
+                ? Math.floor(position / 2)
+                : 0;
+        // Fix: Adjust position calculation based on original sample rate
+        // When position is provided in bytes, we need to account for the original sample rate
+        const bytesPerSample = 2; // 16-bit audio = 2 bytes per sample
+        const adjustedStartSample = position !== undefined
+            ? Math.floor((position / bytesPerSample) *
+                (buffer.sampleRate / targetSampleRate))
+            : startSample;
+        const samplesNeeded = length !== undefined
+            ? Math.floor((length / bytesPerSample) *
+                (buffer.sampleRate / targetSampleRate))
+            : endTimeMs !== undefined && startTimeMs !== undefined
+                ? Math.floor(((endTimeMs - startTimeMs) / 1000) * buffer.sampleRate)
+                : buffer.length - adjustedStartSample;
+        logger?.debug('Sample calculations (adjusted):', {
+            originalStartSample: startSample,
+            adjustedStartSample,
+            samplesNeeded,
+            originalSampleRate: buffer.sampleRate,
+            targetSampleRate,
+            conversionRatio: buffer.sampleRate / targetSampleRate,
+            expectedDurationMs: (samplesNeeded / buffer.sampleRate) * 1000,
+        });
+        // Create temporary buffer for the segment
+        const segmentBuffer = ctx.createBuffer(buffer.numberOfChannels, samplesNeeded, buffer.sampleRate);
+        // Copy the segment
+        for (let channel = 0; channel < buffer.numberOfChannels; channel++) {
+            const channelData = buffer.getChannelData(channel);
+            const segmentData = segmentBuffer.getChannelData(channel);
+            for (let i = 0; i < samplesNeeded; i++) {
+                segmentData[i] = channelData[adjustedStartSample + i];
+            }
+        }
+        // Create offline context for resampling
+        const offlineCtx = new OfflineAudioContext(targetChannels, Math.ceil((samplesNeeded * targetSampleRate) / buffer.sampleRate), targetSampleRate);
+        // Create source and connect
+        const source = offlineCtx.createBufferSource();
+        source.buffer = segmentBuffer;
+        source.connect(offlineCtx.destination);
+        // Render at new sample rate
+        source.start();
+        const processedBuffer = await offlineCtx.startRendering();
+        // Get the final audio data
+        const channelData = processedBuffer.getChannelData(0);
+        const durationMs = Math.round((samplesNeeded / buffer.sampleRate) * 1000);
+        logger?.debug('Final processed audio:', {
+            outputSamples: channelData.length,
+            outputSampleRate: targetSampleRate,
+            durationMs,
+        });
+        return {
+            buffer: processedBuffer,
+            channelData,
+            samples: channelData.length,
+            durationMs,
+            sampleRate: targetSampleRate,
+            channels: processedBuffer.numberOfChannels,
+        };
+    }
+    catch (error) {
+        logger?.error('Failed to process audio buffer:', {
+            error,
+            position,
+            length,
+            startTimeMs,
+            endTimeMs,
+            bufferLength: buffer?.length,
+        });
+        throw error;
+    }
+    finally {
+        if (!audioContext && ctx) {
+            await ctx.close();
+        }
+    }
+}
+//# sourceMappingURL=audioProcessing.js.map

package/build/esm/utils/audioProcessing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audioProcessing.js","sourceRoot":"","sources":["../../../src/utils/audioProcessing.ts"],"names":[],"mappings":"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","sourcesContent":["// packages/audio-studio/src/utils/audioProcessing.ts\nimport { Platform } from 'react-native'\n\nimport { ConsoleLike } from '../AudioStudio.types'\n\nexport interface ProcessAudioBufferOptions {\n    arrayBuffer?: ArrayBuffer\n    fileUri?: string\n    targetSampleRate: number\n    targetChannels: number\n    normalizeAudio: boolean\n    startTimeMs?: number\n    endTimeMs?: number\n    position?: number\n    length?: number\n    audioContext?: AudioContext\n    logger?: ConsoleLike\n}\n\nexport interface ProcessedAudioData {\n    channelData: Float32Array\n    samples: number\n    durationMs: number\n    sampleRate: number\n    channels: number\n    buffer: AudioBuffer\n}\n\nexport async function processAudioBuffer({\n    arrayBuffer,\n    fileUri,\n    targetSampleRate,\n    targetChannels,\n    normalizeAudio,\n    startTimeMs,\n    endTimeMs,\n    position,\n    length,\n    audioContext,\n    logger,\n}: ProcessAudioBufferOptions): Promise<ProcessedAudioData> {\n    if (Platform.OS !== 'web') {\n        throw new Error('processAudioBuffer is only supported on web')\n    }\n\n    let ctx: AudioContext | undefined\n    let buffer: AudioBuffer | undefined\n\n    try {\n        // Log initial parameters\n        logger?.debug('Process audio buffer - Initial params:', {\n            hasArrayBuffer: !!arrayBuffer,\n            fileUri,\n            targetSampleRate,\n            targetChannels,\n            normalizeAudio,\n            startTimeMs,\n            endTimeMs,\n            position,\n            length,\n        })\n\n        // Get the audio data\n        let audioData: ArrayBuffer\n        if (arrayBuffer) {\n            audioData = arrayBuffer\n        } else if (fileUri) {\n            const response = await fetch(fileUri)\n            if (!response.ok) {\n                throw new Error(\n                    `Failed to fetch fileUri: ${response.statusText}`\n                )\n            }\n            audioData = await response.arrayBuffer()\n        } else {\n            throw new Error('Either arrayBuffer or fileUri must be provided')\n        }\n\n        logger?.debug('Audio data loaded:', {\n            byteLength: audioData.byteLength,\n            firstBytes: Array.from(new Uint8Array(audioData.slice(0, 16))),\n        })\n\n        // Create context at original sample rate first\n        ctx =\n            audioContext ||\n            new (window.AudioContext || (window as any).webkitAudioContext)()\n        buffer = await ctx.decodeAudioData(audioData)\n\n        logger?.debug('Decoded audio buffer:', {\n            originalChannels: buffer.numberOfChannels,\n            originalSampleRate: buffer.sampleRate,\n            originalDuration: buffer.duration,\n            originalLength: buffer.length,\n        })\n\n        // Calculate time range\n        const startSample =\n            startTimeMs !== undefined\n                ? Math.floor((startTimeMs / 1000) * buffer.sampleRate)\n                : position !== undefined\n                  ? Math.floor(position / 2)\n                  : 0\n\n        // Fix: Adjust position calculation based on original sample rate\n        // When position is provided in bytes, we need to account for the original sample rate\n        const bytesPerSample = 2 // 16-bit audio = 2 bytes per sample\n        const adjustedStartSample =\n            position !== undefined\n                ? Math.floor(\n                      (position / bytesPerSample) *\n                          (buffer.sampleRate / targetSampleRate)\n                  )\n                : startSample\n\n        const samplesNeeded =\n            length !== undefined\n                ? Math.floor(\n                      (length / bytesPerSample) *\n                          (buffer.sampleRate / targetSampleRate)\n                  )\n                : endTimeMs !== undefined && startTimeMs !== undefined\n                  ? Math.floor(\n                        ((endTimeMs - startTimeMs) / 1000) * buffer.sampleRate\n                    )\n                  : buffer.length - adjustedStartSample\n\n        logger?.debug('Sample calculations (adjusted):', {\n            originalStartSample: startSample,\n            adjustedStartSample,\n            samplesNeeded,\n            originalSampleRate: buffer.sampleRate,\n            targetSampleRate,\n            conversionRatio: buffer.sampleRate / targetSampleRate,\n            expectedDurationMs: (samplesNeeded / buffer.sampleRate) * 1000,\n        })\n\n        // Create temporary buffer for the segment\n        const segmentBuffer = ctx.createBuffer(\n            buffer.numberOfChannels,\n            samplesNeeded,\n            buffer.sampleRate\n        )\n\n        // Copy the segment\n        for (let channel = 0; channel < buffer.numberOfChannels; channel++) {\n            const channelData = buffer.getChannelData(channel)\n            const segmentData = segmentBuffer.getChannelData(channel)\n            for (let i = 0; i < samplesNeeded; i++) {\n                segmentData[i] = channelData[adjustedStartSample + i]\n            }\n        }\n\n        // Create offline context for resampling\n        const offlineCtx = new OfflineAudioContext(\n            targetChannels,\n            Math.ceil((samplesNeeded * targetSampleRate) / buffer.sampleRate),\n            targetSampleRate\n        )\n\n        // Create source and connect\n        const source = offlineCtx.createBufferSource()\n        source.buffer = segmentBuffer\n        source.connect(offlineCtx.destination)\n\n        // Render at new sample rate\n        source.start()\n        const processedBuffer = await offlineCtx.startRendering()\n\n        // Get the final audio data\n        const channelData = processedBuffer.getChannelData(0)\n        const durationMs = Math.round(\n            (samplesNeeded / buffer.sampleRate) * 1000\n        )\n\n        logger?.debug('Final processed audio:', {\n            outputSamples: channelData.length,\n            outputSampleRate: targetSampleRate,\n            durationMs,\n        })\n\n        return {\n            buffer: processedBuffer,\n            channelData,\n            samples: channelData.length,\n            durationMs,\n            sampleRate: targetSampleRate,\n            channels: processedBuffer.numberOfChannels,\n        }\n    } catch (error) {\n        logger?.error('Failed to process audio buffer:', {\n            error,\n            position,\n            length,\n            startTimeMs,\n            endTimeMs,\n            bufferLength: buffer?.length,\n        })\n        throw error\n    } finally {\n        if (!audioContext && ctx) {\n            await ctx.close()\n        }\n    }\n}\n"]}

package/build/esm/utils/cleanNativeOptions.js

@@ -0,0 +1,19 @@
+/**
+ * Strips non-serializable values (functions, ArrayBuffer, undefined) from
+ * option objects before passing them to Expo native modules.
+ *
+ * Android's Kotlin bridge crashes with "Cannot convert '[object Object]' to a
+ * Kotlin type" when it receives non-plain values such as `logger`, `ArrayBuffer`,
+ * or `undefined` fields.  The JSON round-trip removes all of these safely.
+ *
+ * Only use this for small config objects (never for large audio buffers).
+ *
+ * NOTE: structuredClone() is intentionally NOT used here — it preserves
+ * undefined values and non-JSON types, which is exactly what we need to strip.
+ */
+export function cleanNativeOptions(options) {
+    // NOSONAR: JSON round-trip is deliberate — it strips undefined, functions,
+    // and non-serializable values that structuredClone would preserve.
+    return JSON.parse(JSON.stringify(options)); // NOSONAR
+}
+//# sourceMappingURL=cleanNativeOptions.js.map

package/build/esm/utils/cleanNativeOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanNativeOptions.js","sourceRoot":"","sources":["../../../src/utils/cleanNativeOptions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAAI,OAAU;IAC5C,2EAA2E;IAC3E,mEAAmE;IACnE,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAA,CAAC,UAAU;AACzD,CAAC","sourcesContent":["/**\n * Strips non-serializable values (functions, ArrayBuffer, undefined) from\n * option objects before passing them to Expo native modules.\n *\n * Android's Kotlin bridge crashes with \"Cannot convert '[object Object]' to a\n * Kotlin type\" when it receives non-plain values such as `logger`, `ArrayBuffer`,\n * or `undefined` fields.  The JSON round-trip removes all of these safely.\n *\n * Only use this for small config objects (never for large audio buffers).\n *\n * NOTE: structuredClone() is intentionally NOT used here — it preserves\n * undefined values and non-JSON types, which is exactly what we need to strip.\n */\nexport function cleanNativeOptions<T>(options: T): T {\n    // NOSONAR: JSON round-trip is deliberate — it strips undefined, functions,\n    // and non-serializable values that structuredClone would preserve.\n    return JSON.parse(JSON.stringify(options)) // NOSONAR\n}\n"]}

package/build/esm/utils/concatenateBuffers.js

@@ -0,0 +1,21 @@
+/**
+ * Concatenates an array of ArrayBuffers into a single ArrayBuffer.
+ *
+ * @param buffers - An array of ArrayBuffers to be concatenated.
+ * @returns A single ArrayBuffer containing the concatenated data.
+ */
+export const concatenateBuffers = (buffers) => {
+    // Filter out any undefined or null buffers
+    const validBuffers = buffers.filter((buffer) => buffer);
+    const totalLength = validBuffers.reduce((sum, buffer) => sum + buffer.byteLength, 0);
+    // Create a new Uint8Array to hold the concatenated result
+    const result = new Uint8Array(totalLength);
+    // Offset to keep track of the current position in the result array
+    let offset = 0;
+    for (const buffer of validBuffers) {
+        result.set(new Uint8Array(buffer), offset);
+        offset += buffer.byteLength;
+    }
+    return result.buffer;
+};
+//# sourceMappingURL=concatenateBuffers.js.map

package/build/esm/utils/concatenateBuffers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concatenateBuffers.js","sourceRoot":"","sources":["../../../src/utils/concatenateBuffers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,OAAsB,EAAe,EAAE;IACtE,2CAA2C;IAC3C,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,CAAA;IACvD,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,CACnC,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,GAAG,GAAG,MAAM,CAAC,UAAU,EACxC,CAAC,CACJ,CAAA;IACD,0DAA0D;IAC1D,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,WAAW,CAAC,CAAA;IAC1C,mEAAmE;IACnE,IAAI,MAAM,GAAG,CAAC,CAAA;IAEd,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;QAChC,MAAM,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAA;QAC1C,MAAM,IAAI,MAAM,CAAC,UAAU,CAAA;IAC/B,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAA;AACxB,CAAC,CAAA","sourcesContent":["/**\n * Concatenates an array of ArrayBuffers into a single ArrayBuffer.\n *\n * @param buffers - An array of ArrayBuffers to be concatenated.\n * @returns A single ArrayBuffer containing the concatenated data.\n */\nexport const concatenateBuffers = (buffers: ArrayBuffer[]): ArrayBuffer => {\n    // Filter out any undefined or null buffers\n    const validBuffers = buffers.filter((buffer) => buffer)\n    const totalLength = validBuffers.reduce(\n        (sum, buffer) => sum + buffer.byteLength,\n        0\n    )\n    // Create a new Uint8Array to hold the concatenated result\n    const result = new Uint8Array(totalLength)\n    // Offset to keep track of the current position in the result array\n    let offset = 0\n\n    for (const buffer of validBuffers) {\n        result.set(new Uint8Array(buffer), offset)\n        offset += buffer.byteLength\n    }\n    return result.buffer\n}\n"]}

package/build/esm/utils/convertPCMToFloat32.js

@@ -0,0 +1,120 @@
+import { Platform } from 'react-native';
+import { getWavFileInfo } from './getWavFileInfo';
+export const WAV_HEADER_SIZE = 44;
+const convertSample = (dataView, offset, bitDepth) => {
+    switch (bitDepth) {
+        case 8:
+            return (dataView.getUint8(offset) - 128) / 128;
+        case 16:
+            return dataView.getInt16(offset, true) / 32768;
+        case 24:
+            return (((dataView.getUint8(offset) |
+                (dataView.getUint8(offset + 1) << 8) |
+                (dataView.getUint8(offset + 2) << 16)) /
+                8388608) *
+                2 -
+                1);
+        case 32:
+            return dataView.getFloat32(offset, true);
+        default:
+            throw new Error(`Unsupported bit depth: ${bitDepth}`);
+    }
+};
+const convertSampleNative = (array, startIndex, bitDepth) => {
+    switch (bitDepth) {
+        case 8:
+            return (array[startIndex] - 128) / 128;
+        case 16: {
+            // Handle 16-bit PCM using Uint8Array directly
+            const low = array[startIndex];
+            const high = array[startIndex + 1];
+            const value = (high << 8) | low;
+            // Convert to signed 16-bit
+            return (value > 32767 ? value - 65536 : value) / 32768;
+        }
+        case 24: {
+            const byte1 = array[startIndex];
+            const byte2 = array[startIndex + 1];
+            const byte3 = array[startIndex + 2];
+            const value = (byte3 << 16) | (byte2 << 8) | byte1;
+            return (((value > 8388607 ? value - 16777216 : value) / 8388608) * 2 - 1);
+        }
+        case 32: {
+            // Assuming 32-bit float
+            const view = new DataView(array.buffer, startIndex, 4);
+            return view.getFloat32(0, true);
+        }
+        default:
+            throw new Error(`Unsupported bit depth: ${bitDepth}`);
+    }
+};
+export const convertPCMToFloat32 = async ({ bitDepth, buffer, skipWavHeader = false, logger, }) => {
+    try {
+        logger?.debug(`Converting PCM to Float32: bitDepth: ${bitDepth}, buffer.byteLength: ${buffer.byteLength}`);
+        let headerOffset = 0;
+        if (!skipWavHeader) {
+            const wavFileInfo = await getWavFileInfo(buffer);
+            headerOffset = wavFileInfo.dataChunkOffset;
+            logger?.debug(`Using WAV header offset: ${headerOffset}`);
+        }
+        // Convert ArrayBuffer to Uint8Array for more efficient native handling
+        const uint8Array = new Uint8Array(buffer);
+        const dataLength = buffer.byteLength - headerOffset;
+        const bytesPerSample = bitDepth / 8;
+        const sampleLength = Math.floor(dataLength / bytesPerSample);
+        // Create result array using SharedArrayBuffer for better memory handling
+        let float32Array;
+        try {
+            // Try using SharedArrayBuffer first
+            const sharedBuffer = new SharedArrayBuffer(sampleLength * 4);
+            float32Array = new Float32Array(sharedBuffer);
+        }
+        catch (e) {
+            // Fallback to regular ArrayBuffer if SharedArrayBuffer is not available
+            float32Array = new Float32Array(sampleLength);
+        }
+        let min = Infinity;
+        let max = -Infinity;
+        // Process in smaller chunks
+        const CHUNK_SIZE = Platform.OS === 'web' ? sampleLength : 4000; // Smaller chunks for native
+        const numChunks = Math.ceil(sampleLength / CHUNK_SIZE);
+        for (let chunk = 0; chunk < numChunks; chunk++) {
+            const startSample = chunk * CHUNK_SIZE;
+            const endSample = Math.min((chunk + 1) * CHUNK_SIZE, sampleLength);
+            // Process chunk
+            for (let i = startSample; i < endSample; i++) {
+                const startIndex = headerOffset + i * bytesPerSample;
+                if (startIndex + bytesPerSample <= uint8Array.length) {
+                    const value = Platform.OS === 'web'
+                        ? convertSample(new DataView(buffer), startIndex, bitDepth)
+                        : convertSampleNative(uint8Array, startIndex, bitDepth);
+                    if (isFinite(value)) {
+                        float32Array[i] = value;
+                        min = Math.min(min, value);
+                        max = Math.max(max, value);
+                    }
+                }
+            }
+            // Allow garbage collection between chunks on native
+            if (Platform.OS !== 'web' && chunk < numChunks - 1) {
+                await new Promise((resolve) => setTimeout(resolve, 0));
+            }
+        }
+        logger?.debug(`Conversion complete. Length: ${float32Array.length}, Range: [${min}, ${max}]`);
+        // Only log a small sample of values to avoid memory issues
+        if (logger?.debug) {
+            const sampleValues = Array.from(float32Array.slice(0, 5));
+            logger.debug('Sample values:', sampleValues);
+        }
+        return {
+            pcmValues: float32Array,
+            min,
+            max,
+        };
+    }
+    catch (error) {
+        logger?.error(`Error converting PCM to Float32`, error);
+        throw error;
+    }
+};
+//# sourceMappingURL=convertPCMToFloat32.js.map

package/build/esm/utils/convertPCMToFloat32.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertPCMToFloat32.js","sourceRoot":"","sources":["../../../src/utils/convertPCMToFloat32.ts"],"names":[],"mappings":"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","sourcesContent":["import { Platform } from 'react-native'\n\nimport { ConsoleLike } from '../AudioStudio.types'\nimport { getWavFileInfo, WavFileInfo } from './getWavFileInfo'\n\nexport const WAV_HEADER_SIZE = 44\n\nconst convertSample = (\n    dataView: DataView,\n    offset: number,\n    bitDepth: number\n): number => {\n    switch (bitDepth) {\n        case 8:\n            return (dataView.getUint8(offset) - 128) / 128\n        case 16:\n            return dataView.getInt16(offset, true) / 32768\n        case 24:\n            return (\n                ((dataView.getUint8(offset) |\n                    (dataView.getUint8(offset + 1) << 8) |\n                    (dataView.getUint8(offset + 2) << 16)) /\n                    8388608) *\n                    2 -\n                1\n            )\n        case 32:\n            return dataView.getFloat32(offset, true)\n        default:\n            throw new Error(`Unsupported bit depth: ${bitDepth}`)\n    }\n}\n\nconst convertSampleNative = (\n    array: Uint8Array,\n    startIndex: number,\n    bitDepth: number\n): number => {\n    switch (bitDepth) {\n        case 8:\n            return (array[startIndex] - 128) / 128\n        case 16: {\n            // Handle 16-bit PCM using Uint8Array directly\n            const low = array[startIndex]\n            const high = array[startIndex + 1]\n            const value = (high << 8) | low\n            // Convert to signed 16-bit\n            return (value > 32767 ? value - 65536 : value) / 32768\n        }\n        case 24: {\n            const byte1 = array[startIndex]\n            const byte2 = array[startIndex + 1]\n            const byte3 = array[startIndex + 2]\n            const value = (byte3 << 16) | (byte2 << 8) | byte1\n            return (\n                ((value > 8388607 ? value - 16777216 : value) / 8388608) * 2 - 1\n            )\n        }\n        case 32: {\n            // Assuming 32-bit float\n            const view = new DataView(array.buffer, startIndex, 4)\n            return view.getFloat32(0, true)\n        }\n        default:\n            throw new Error(`Unsupported bit depth: ${bitDepth}`)\n    }\n}\n\nexport const convertPCMToFloat32 = async ({\n    bitDepth,\n    buffer,\n    skipWavHeader = false,\n    logger,\n}: {\n    buffer: ArrayBuffer\n    bitDepth: number\n    skipWavHeader?: boolean\n    logger?: ConsoleLike\n}): Promise<{ pcmValues: Float32Array; min: number; max: number }> => {\n    try {\n        logger?.debug(\n            `Converting PCM to Float32: bitDepth: ${bitDepth}, buffer.byteLength: ${buffer.byteLength}`\n        )\n\n        let headerOffset = 0\n        if (!skipWavHeader) {\n            const wavFileInfo: WavFileInfo = await getWavFileInfo(buffer)\n            headerOffset = wavFileInfo.dataChunkOffset\n            logger?.debug(`Using WAV header offset: ${headerOffset}`)\n        }\n\n        // Convert ArrayBuffer to Uint8Array for more efficient native handling\n        const uint8Array = new Uint8Array(buffer)\n        const dataLength = buffer.byteLength - headerOffset\n        const bytesPerSample = bitDepth / 8\n        const sampleLength = Math.floor(dataLength / bytesPerSample)\n\n        // Create result array using SharedArrayBuffer for better memory handling\n        let float32Array: Float32Array\n        try {\n            // Try using SharedArrayBuffer first\n            const sharedBuffer = new SharedArrayBuffer(sampleLength * 4)\n            float32Array = new Float32Array(sharedBuffer)\n        } catch (e) {\n            // Fallback to regular ArrayBuffer if SharedArrayBuffer is not available\n            float32Array = new Float32Array(sampleLength)\n        }\n\n        let min = Infinity\n        let max = -Infinity\n\n        // Process in smaller chunks\n        const CHUNK_SIZE = Platform.OS === 'web' ? sampleLength : 4000 // Smaller chunks for native\n        const numChunks = Math.ceil(sampleLength / CHUNK_SIZE)\n\n        for (let chunk = 0; chunk < numChunks; chunk++) {\n            const startSample = chunk * CHUNK_SIZE\n            const endSample = Math.min((chunk + 1) * CHUNK_SIZE, sampleLength)\n\n            // Process chunk\n            for (let i = startSample; i < endSample; i++) {\n                const startIndex = headerOffset + i * bytesPerSample\n                if (startIndex + bytesPerSample <= uint8Array.length) {\n                    const value =\n                        Platform.OS === 'web'\n                            ? convertSample(\n                                  new DataView(buffer),\n                                  startIndex,\n                                  bitDepth\n                              )\n                            : convertSampleNative(\n                                  uint8Array,\n                                  startIndex,\n                                  bitDepth\n                              )\n\n                    if (isFinite(value)) {\n                        float32Array[i] = value\n                        min = Math.min(min, value)\n                        max = Math.max(max, value)\n                    }\n                }\n            }\n\n            // Allow garbage collection between chunks on native\n            if (Platform.OS !== 'web' && chunk < numChunks - 1) {\n                await new Promise((resolve) => setTimeout(resolve, 0))\n            }\n        }\n\n        logger?.debug(\n            `Conversion complete. Length: ${float32Array.length}, Range: [${min}, ${max}]`\n        )\n\n        // Only log a small sample of values to avoid memory issues\n        if (logger?.debug) {\n            const sampleValues = Array.from(float32Array.slice(0, 5))\n            logger.debug('Sample values:', sampleValues)\n        }\n\n        return {\n            pcmValues: float32Array,\n            min,\n            max,\n        }\n    } catch (error: unknown) {\n        logger?.error(`Error converting PCM to Float32`, error)\n        throw error\n    }\n}\n"]}

package/build/esm/utils/crc32.js

@@ -0,0 +1,50 @@
+// Bundler (Metro/Webpack) will automatically resolve to crc32.web.ts or crc32.native.ts.
+import { Platform } from 'react-native';
+// --- Web CRC32 Calculation Logic ---
+let webCrcTable;
+function computeWebCrc32(data) {
+    // Lazily compute the table only on web when first needed
+    if (!webCrcTable) {
+        webCrcTable = (() => {
+            const table = new Uint32Array(256);
+            for (let i = 0; i < 256; ++i) {
+                let crc = i;
+                for (let j = 0; j < 8; ++j) {
+                    crc = crc & 1 ? (crc >>> 1) ^ 0xedb88320 : crc >>> 1;
+                }
+                table[i] = crc;
+            }
+            return table;
+        })();
+    }
+    let crc = -1; // Initialize with 0xFFFFFFFF
+    if (typeof data === 'string') {
+        const strBytes = new TextEncoder().encode(data);
+        for (let i = 0; i < strBytes.length; ++i) {
+            crc = (crc >>> 8) ^ webCrcTable[(crc ^ strBytes[i]) & 0xff];
+        }
+    }
+    else if (data instanceof Uint8Array) {
+        for (let i = 0; i < data.length; ++i) {
+            crc = (crc >>> 8) ^ webCrcTable[(crc ^ data[i]) & 0xff];
+        }
+    }
+    else {
+        throw new Error('Unsupported data type for CRC32 calculation.');
+    }
+    return (crc ^ -1) >>> 0; // Final XOR and ensure unsigned 32-bit
+}
+// --- End Web CRC32 Calculation Logic ---
+let crc32Implementation;
+if (Platform.OS === 'web') {
+    // Assign the web implementation
+    crc32Implementation = Object.assign(computeWebCrc32, {
+        buf: (data) => computeWebCrc32(data),
+    });
+}
+else {
+    // No-op implementation for native platforms
+    crc32Implementation = Object.assign(() => 0, { buf: () => 0 });
+}
+export default crc32Implementation;
+//# sourceMappingURL=crc32.js.map

package/build/esm/utils/crc32.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crc32.js","sourceRoot":"","sources":["../../../src/utils/crc32.ts"],"names":[],"mappings":"AAAA,yFAAyF;AAEzF,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAQvC,sCAAsC;AACtC,IAAI,WAAoC,CAAA;AACxC,SAAS,eAAe,CAAC,IAAyB;IAC9C,yDAAyD;IACzD,IAAI,CAAC,WAAW,EAAE,CAAC;QACf,WAAW,GAAG,CAAC,GAAG,EAAE;YAChB,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC,CAAA;YAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC;gBAC3B,IAAI,GAAG,GAAG,CAAC,CAAA;gBACX,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;oBACzB,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAA;gBACxD,CAAC;gBACD,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAA;YAClB,CAAC;YACD,OAAO,KAAK,CAAA;QAChB,CAAC,CAAC,EAAE,CAAA;IACR,CAAC;IAED,IAAI,GAAG,GAAG,CAAC,CAAC,CAAA,CAAC,6BAA6B;IAC1C,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAC/C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;YACvC,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;QAC/D,CAAC;IACL,CAAC;SAAM,IAAI,IAAI,YAAY,UAAU,EAAE,CAAC;QACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;YACnC,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;QAC3D,CAAC;IACL,CAAC;SAAM,CAAC;QACJ,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;IACnE,CAAC;IAED,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA,CAAC,uCAAuC;AACnE,CAAC;AACD,0CAA0C;AAE1C,IAAI,mBAA0B,CAAA;AAE9B,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;IACxB,gCAAgC;IAChC,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE;QACjD,GAAG,EAAE,CAAC,IAAgB,EAAU,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC;KAC3D,CAAC,CAAA;AACN,CAAC;KAAM,CAAC;IACJ,4CAA4C;IAC5C,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAA;AAClE,CAAC;AAED,eAAe,mBAAmB,CAAA","sourcesContent":["// Bundler (Metro/Webpack) will automatically resolve to crc32.web.ts or crc32.native.ts.\n\nimport { Platform } from 'react-native'\n\n// Define the interface first\nexport interface CRC32 {\n    (data: string | Uint8Array): number\n    buf(data: Uint8Array): number\n}\n\n// --- Web CRC32 Calculation Logic ---\nlet webCrcTable: Uint32Array | undefined\nfunction computeWebCrc32(data: string | Uint8Array): number {\n    // Lazily compute the table only on web when first needed\n    if (!webCrcTable) {\n        webCrcTable = (() => {\n            const table = new Uint32Array(256)\n            for (let i = 0; i < 256; ++i) {\n                let crc = i\n                for (let j = 0; j < 8; ++j) {\n                    crc = crc & 1 ? (crc >>> 1) ^ 0xedb88320 : crc >>> 1\n                }\n                table[i] = crc\n            }\n            return table\n        })()\n    }\n\n    let crc = -1 // Initialize with 0xFFFFFFFF\n    if (typeof data === 'string') {\n        const strBytes = new TextEncoder().encode(data)\n        for (let i = 0; i < strBytes.length; ++i) {\n            crc = (crc >>> 8) ^ webCrcTable[(crc ^ strBytes[i]) & 0xff]\n        }\n    } else if (data instanceof Uint8Array) {\n        for (let i = 0; i < data.length; ++i) {\n            crc = (crc >>> 8) ^ webCrcTable[(crc ^ data[i]) & 0xff]\n        }\n    } else {\n        throw new Error('Unsupported data type for CRC32 calculation.')\n    }\n\n    return (crc ^ -1) >>> 0 // Final XOR and ensure unsigned 32-bit\n}\n// --- End Web CRC32 Calculation Logic ---\n\nlet crc32Implementation: CRC32\n\nif (Platform.OS === 'web') {\n    // Assign the web implementation\n    crc32Implementation = Object.assign(computeWebCrc32, {\n        buf: (data: Uint8Array): number => computeWebCrc32(data),\n    })\n} else {\n    // No-op implementation for native platforms\n    crc32Implementation = Object.assign(() => 0, { buf: () => 0 })\n}\n\nexport default crc32Implementation\n"]}

package/build/esm/utils/encodingToBitDepth.js

@@ -0,0 +1,13 @@
+export const encodingToBitDepth = ({ encoding, }) => {
+    switch (encoding) {
+        case 'pcm_32bit':
+            return 32;
+        case 'pcm_16bit':
+            return 16;
+        case 'pcm_8bit':
+            return 8;
+        default:
+            throw new Error(`Unsupported encoding type: ${encoding}`);
+    }
+};
+//# sourceMappingURL=encodingToBitDepth.js.map

package/build/esm/utils/encodingToBitDepth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encodingToBitDepth.js","sourceRoot":"","sources":["../../../src/utils/encodingToBitDepth.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,EAC/B,QAAQ,GAGX,EAAY,EAAE;IACX,QAAQ,QAAQ,EAAE,CAAC;QACf,KAAK,WAAW;YACZ,OAAO,EAAE,CAAA;QACb,KAAK,WAAW;YACZ,OAAO,EAAE,CAAA;QACb,KAAK,UAAU;YACX,OAAO,CAAC,CAAA;QACZ;YACI,MAAM,IAAI,KAAK,CAAC,8BAA8B,QAAQ,EAAE,CAAC,CAAA;IACjE,CAAC;AACL,CAAC,CAAA","sourcesContent":["import { BitDepth, EncodingType } from '../AudioStudio.types'\n\nexport const encodingToBitDepth = ({\n    encoding,\n}: {\n    encoding: EncodingType\n}): BitDepth => {\n    switch (encoding) {\n        case 'pcm_32bit':\n            return 32\n        case 'pcm_16bit':\n            return 16\n        case 'pcm_8bit':\n            return 8\n        default:\n            throw new Error(`Unsupported encoding type: ${encoding}`)\n    }\n}\n"]}

package/build/esm/utils/getWavFileInfo.js

@@ -0,0 +1,92 @@
+// packages/audio-studio/src/utils/getWavFileInfo.ts
+import { DATA_CHUNK_ID, DEFAULT_BIT_DEPTH, DEFAULT_SAMPLE_RATE, FMT_CHUNK_ID, INFO_CHUNK_ID, RIFF_HEADER, WAVE_HEADER, } from '../constants';
+// Audio format descriptions
+const AUDIO_FORMATS = {
+    1: 'PCM',
+    3: 'IEEE float',
+    6: '8-bit ITU-T G.711 A-law',
+    7: '8-bit ITU-T G.711 µ-law',
+    65534: 'WAVE_FORMAT_EXTENSIBLE',
+};
+/**
+ * Extracts metadata from a WAV buffer.
+ *
+ * @param arrayBuffer - The array buffer containing the WAV data.
+ * @returns A promise that resolves to the extracted metadata.
+ */
+export const getWavFileInfo = async (arrayBuffer) => {
+    const view = new DataView(arrayBuffer);
+    // Check if the file is a valid RIFF/WAVE file
+    const riffHeader = view.getUint32(0, false);
+    const waveHeader = view.getUint32(8, false);
+    if (riffHeader !== RIFF_HEADER || waveHeader !== WAVE_HEADER) {
+        throw new Error('Invalid WAV file');
+    }
+    // Initialize variables for the metadata
+    let fmtChunkOffset = 12;
+    let sampleRate = DEFAULT_SAMPLE_RATE;
+    let numChannels = 0;
+    let bitDepth = DEFAULT_BIT_DEPTH;
+    let dataChunkSize = 0;
+    let audioFormat = 0;
+    let byteRate = 0;
+    let blockAlign = 0;
+    let creationDateTime = '';
+    let comments = '';
+    let dataChunkOffset = 0;
+    // Parse chunks to find the "fmt " and "data" chunks
+    while (fmtChunkOffset < view.byteLength) {
+        const chunkId = view.getUint32(fmtChunkOffset, false);
+        const chunkSize = view.getUint32(fmtChunkOffset + 4, true);
+        if (chunkId === FMT_CHUNK_ID) {
+            // "fmt "
+            audioFormat = view.getUint16(fmtChunkOffset + 8, true);
+            if (!AUDIO_FORMATS[audioFormat]) {
+                throw new Error('Unsupported WAV file format');
+            }
+            numChannels = view.getUint16(fmtChunkOffset + 10, true);
+            sampleRate = view.getUint32(fmtChunkOffset + 12, true);
+            byteRate = view.getUint32(fmtChunkOffset + 16, true);
+            blockAlign = view.getUint16(fmtChunkOffset + 20, true);
+            bitDepth = view.getUint16(fmtChunkOffset + 22, true);
+        }
+        else if (chunkId === DATA_CHUNK_ID) {
+            // "data"
+            dataChunkSize = chunkSize;
+            dataChunkOffset = fmtChunkOffset + 8; // Position after chunk header
+            break;
+        }
+        else if (chunkId === INFO_CHUNK_ID) {
+            // "INFO"
+            // Read INFO chunk (assuming it contains a text-based creation date/time and comments)
+            const infoStart = fmtChunkOffset + 8;
+            const infoText = new TextDecoder().decode(new Uint8Array(arrayBuffer.slice(infoStart, infoStart + chunkSize)));
+            const infoParts = infoText.split('\0');
+            creationDateTime = infoParts[0];
+            comments = infoParts[1];
+        }
+        fmtChunkOffset += 8 + chunkSize;
+    }
+    if (!sampleRate || !numChannels || !bitDepth || !dataChunkSize) {
+        throw new Error('Incomplete WAV file information');
+    }
+    // Calculate duration
+    const bytesPerSample = bitDepth / 8;
+    const numSamples = dataChunkSize / (numChannels * bytesPerSample);
+    const durationMs = (numSamples / sampleRate) * 1000;
+    return {
+        sampleRate,
+        numChannels,
+        bitDepth,
+        size: arrayBuffer.byteLength,
+        durationMs,
+        audioFormatDescription: AUDIO_FORMATS[audioFormat],
+        byteRate,
+        blockAlign,
+        creationDateTime: creationDateTime || undefined,
+        comments: comments || undefined,
+        compressionType: audioFormat === 1 ? 'None' : AUDIO_FORMATS[audioFormat],
+        dataChunkOffset,
+    };
+};
+//# sourceMappingURL=getWavFileInfo.js.map

package/build/esm/utils/getWavFileInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getWavFileInfo.js","sourceRoot":"","sources":["../../../src/utils/getWavFileInfo.ts"],"names":[],"mappings":"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","sourcesContent":["// packages/audio-studio/src/utils/getWavFileInfo.ts\n\nimport { BitDepth, SampleRate } from '../AudioStudio.types'\nimport {\n    DATA_CHUNK_ID,\n    DEFAULT_BIT_DEPTH,\n    DEFAULT_SAMPLE_RATE,\n    FMT_CHUNK_ID,\n    INFO_CHUNK_ID,\n    RIFF_HEADER,\n    WAVE_HEADER,\n} from '../constants'\n\n// Audio format descriptions\nconst AUDIO_FORMATS: { [key: number]: string } = {\n    1: 'PCM',\n    3: 'IEEE float',\n    6: '8-bit ITU-T G.711 A-law',\n    7: '8-bit ITU-T G.711 µ-law',\n    65534: 'WAVE_FORMAT_EXTENSIBLE',\n}\n\n/**\n * Interface representing the metadata of a WAV file.\n */\nexport interface WavFileInfo {\n    sampleRate: SampleRate\n    numChannels: number\n    bitDepth: BitDepth\n    size: number // in bytes\n    durationMs: number // in ms\n    audioFormatDescription: string // Description of the audio format\n    byteRate: number // Average bytes per second\n    blockAlign: number // Number of bytes for one sample including all channels\n    creationDateTime?: string // Optional creation date and time\n    comments?: string // Optional comments or tags\n    compressionType?: string // Optional compression type\n    dataChunkOffset: number // Position of the first data chunk\n}\n\n/**\n * Extracts metadata from a WAV buffer.\n *\n * @param arrayBuffer - The array buffer containing the WAV data.\n * @returns A promise that resolves to the extracted metadata.\n */\nexport const getWavFileInfo = async (\n    arrayBuffer: ArrayBuffer\n): Promise<WavFileInfo> => {\n    const view = new DataView(arrayBuffer)\n\n    // Check if the file is a valid RIFF/WAVE file\n    const riffHeader = view.getUint32(0, false)\n    const waveHeader = view.getUint32(8, false)\n    if (riffHeader !== RIFF_HEADER || waveHeader !== WAVE_HEADER) {\n        throw new Error('Invalid WAV file')\n    }\n\n    // Initialize variables for the metadata\n    let fmtChunkOffset = 12\n    let sampleRate: SampleRate = DEFAULT_SAMPLE_RATE\n    let numChannels = 0\n    let bitDepth: BitDepth = DEFAULT_BIT_DEPTH\n    let dataChunkSize = 0\n    let audioFormat = 0\n    let byteRate = 0\n    let blockAlign = 0\n    let creationDateTime = ''\n    let comments = ''\n    let dataChunkOffset = 0\n\n    // Parse chunks to find the \"fmt \" and \"data\" chunks\n    while (fmtChunkOffset < view.byteLength) {\n        const chunkId = view.getUint32(fmtChunkOffset, false)\n        const chunkSize = view.getUint32(fmtChunkOffset + 4, true)\n        if (chunkId === FMT_CHUNK_ID) {\n            // \"fmt \"\n            audioFormat = view.getUint16(fmtChunkOffset + 8, true)\n            if (!AUDIO_FORMATS[audioFormat]) {\n                throw new Error('Unsupported WAV file format')\n            }\n            numChannels = view.getUint16(fmtChunkOffset + 10, true)\n            sampleRate = view.getUint32(fmtChunkOffset + 12, true) as SampleRate\n            byteRate = view.getUint32(fmtChunkOffset + 16, true)\n            blockAlign = view.getUint16(fmtChunkOffset + 20, true)\n            bitDepth = view.getUint16(fmtChunkOffset + 22, true) as BitDepth\n        } else if (chunkId === DATA_CHUNK_ID) {\n            // \"data\"\n            dataChunkSize = chunkSize\n            dataChunkOffset = fmtChunkOffset + 8 // Position after chunk header\n            break\n        } else if (chunkId === INFO_CHUNK_ID) {\n            // \"INFO\"\n            // Read INFO chunk (assuming it contains a text-based creation date/time and comments)\n            const infoStart = fmtChunkOffset + 8\n            const infoText = new TextDecoder().decode(\n                new Uint8Array(\n                    arrayBuffer.slice(infoStart, infoStart + chunkSize)\n                )\n            )\n            const infoParts = infoText.split('\\0')\n            creationDateTime = infoParts[0]\n            comments = infoParts[1]\n        }\n        fmtChunkOffset += 8 + chunkSize\n    }\n\n    if (!sampleRate || !numChannels || !bitDepth || !dataChunkSize) {\n        throw new Error('Incomplete WAV file information')\n    }\n\n    // Calculate duration\n    const bytesPerSample = bitDepth / 8\n    const numSamples = dataChunkSize / (numChannels * bytesPerSample)\n    const durationMs = (numSamples / sampleRate) * 1000\n\n    return {\n        sampleRate,\n        numChannels,\n        bitDepth,\n        size: arrayBuffer.byteLength,\n        durationMs,\n        audioFormatDescription: AUDIO_FORMATS[audioFormat],\n        byteRate,\n        blockAlign,\n        creationDateTime: creationDateTime || undefined,\n        comments: comments || undefined,\n        compressionType:\n            audioFormat === 1 ? 'None' : AUDIO_FORMATS[audioFormat],\n        dataChunkOffset,\n    }\n}\n"]}

package/build/esm/utils/writeWavHeader.js

@@ -0,0 +1,84 @@
+// packages/audio-studio/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.
+ */
+export const writeWavHeader = ({ buffer, sampleRate, numChannels, bitDepth, isFloat = bitDepth === 32, // Default to float for 32-bit
+ }) => {
+    // For 32-bit float, we use format 3, otherwise format 1 for PCM
+    const audioFormat = isFloat ? 3 : 1; // 3 = IEEE float, 1 = PCM
+    const bytesPerSample = bitDepth / 8;
+    const blockAlign = numChannels * bytesPerSample;
+    const byteRate = sampleRate * blockAlign;
+    // Function to write a string to the DataView
+    const writeString = (view, offset, string) => {
+        for (let i = 0; i < string.length; i++) {
+            view.setUint8(offset + i, string.charCodeAt(i));
+        }
+    };
+    // Function to write or update the header
+    const writeHeader = (view, dataSize = 0xffffffff) => {
+        // RIFF chunk descriptor
+        writeString(view, 0, 'RIFF'); // ChunkID
+        view.setUint32(4, 36 + dataSize, true); // ChunkSize: 4 + (8 + 16) + (8 + dataSize)
+        writeString(view, 8, 'WAVE'); // Format
+        // "fmt " sub-chunk
+        writeString(view, 12, 'fmt '); // Subchunk1ID
+        view.setUint32(16, 16, true); // Subchunk1Size (16 for PCM/Float)
+        view.setUint16(20, audioFormat, true); // AudioFormat (3 for float, 1 for PCM)
+        view.setUint16(22, numChannels, true); // NumChannels
+        view.setUint32(24, sampleRate, true); // SampleRate
+        view.setUint32(28, byteRate, true); // ByteRate = SampleRate * NumChannels * BitsPerSample/8
+        view.setUint16(32, blockAlign, true); // BlockAlign = NumChannels * BitsPerSample/8
+        view.setUint16(34, bitDepth, true); // BitsPerSample
+        // "data" sub-chunk
+        writeString(view, 36, 'data'); // Subchunk2ID
+        view.setUint32(40, dataSize, true); // Subchunk2Size = NumSamples * NumChannels * BitsPerSample/8
+    };
+    if (buffer) {
+        // Handle existing buffer
+        // Check for minimum size
+        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 {
+            // Create a new buffer with header + data
+            const newBuffer = new ArrayBuffer(44 + buffer.byteLength);
+            const newView = new DataView(newBuffer);
+            // Write header to new buffer
+            writeHeader(newView, buffer.byteLength);
+            // Copy audio data after header
+            new Uint8Array(newBuffer).set(new Uint8Array(buffer), 44);
+            return newBuffer;
+        }
+    }
+    else {
+        // Create standalone header
+        const headerBuffer = new ArrayBuffer(44);
+        const view = new DataView(headerBuffer);
+        writeHeader(view);
+        return headerBuffer;
+    }
+};
+//# sourceMappingURL=writeWavHeader.js.map