echogarden 0.0.1 → 0.1.0

package/dist/codecs/WaveCodec.js

@@ -0,0 +1,208 @@
+import * as AudioBufferConversion from '../audio/AudioBufferConversion.js';
+import { logToStderr } from '../utilities/Utilities.js';
+const log = logToStderr;
+export function encodeWave(rawAudio, bitDepth = 16, sampleFormat, speakerPositionMask = 0) {
+    const audioChannels = rawAudio.audioChannels;
+    const sampleRate = rawAudio.sampleRate;
+    const audioBuffer = AudioBufferConversion.encodeToAudioBuffer(audioChannels, bitDepth, sampleFormat);
+    const audioDataLength = audioBuffer.length;
+    const shouldUseExtensibleFormat = bitDepth > 16 || audioChannels.length > 2;
+    const formatSubChunk = new WaveFormat(audioChannels.length, sampleRate, bitDepth, sampleFormat, speakerPositionMask);
+    const formatSubChunkBuffer = formatSubChunk.serialize(shouldUseExtensibleFormat);
+    const dataSubChunkBuffer = Buffer.alloc(4 + 4 + audioDataLength);
+    dataSubChunkBuffer.write("data", 0, "ascii");
+    dataSubChunkBuffer.writeUint32LE(audioDataLength, 4);
+    dataSubChunkBuffer.set(audioBuffer, 8);
+    const riffChunkHeaderBuffer = Buffer.alloc(12);
+    riffChunkHeaderBuffer.write("RIFF", 0, "ascii");
+    riffChunkHeaderBuffer.writeUint32LE(4 + formatSubChunkBuffer.length + dataSubChunkBuffer.length, 4);
+    riffChunkHeaderBuffer.write("WAVE", 8, "ascii");
+    return Buffer.concat([riffChunkHeaderBuffer, formatSubChunkBuffer, dataSubChunkBuffer]);
+}
+export function decodeWave(waveData, ignoreTruncatedChunks = false) {
+    let readOffset = 0;
+    const riffId = waveData.subarray(readOffset, readOffset + 4).toString("ascii");
+    if (riffId != "RIFF") {
+        throw new Error("Not a valid wave file. No RIFF id found at offset 0.");
+    }
+    readOffset += 4;
+    const riffChunkSize = waveData.readUInt32LE(readOffset);
+    readOffset += 4;
+    const waveId = waveData.subarray(readOffset, readOffset + 4).toString("ascii");
+    if (waveId != "WAVE") {
+        throw new Error("Not a valid wave file. No WAVE id found at offset 8.");
+    }
+    if (riffChunkSize < waveData.length - 8) {
+        throw new Error(`RIFF chunk length ${riffChunkSize} is smaller than the remaining size of the buffer (${waveData.length - 8})`);
+    }
+    if (!ignoreTruncatedChunks && riffChunkSize > waveData.length - 8) {
+        throw new Error(`RIFF chunk length (${riffChunkSize}) is greater than the remaining size of the buffer (${waveData.length - 8})`);
+    }
+    readOffset += 4;
+    let formatSubChunkBodyBuffer;
+    const dataBuffers = [];
+    while (true) {
+        const subChunkIdentifier = waveData.subarray(readOffset, readOffset + 4).toString("ascii");
+        readOffset += 4;
+        const subChunkSize = waveData.readUInt32LE(readOffset);
+        readOffset += 4;
+        if (!ignoreTruncatedChunks && subChunkSize > waveData.length - readOffset) {
+            throw new Error(`Encountered a '${subChunkIdentifier}' subchunk with a size of ${subChunkSize} which is greater than the remaining size of the buffer (${waveData.length - readOffset})`);
+        }
+        if (subChunkIdentifier == "fmt ") {
+            formatSubChunkBodyBuffer = waveData.subarray(readOffset, readOffset + subChunkSize);
+        }
+        else if (subChunkIdentifier == "data") {
+            if (!formatSubChunkBodyBuffer) {
+                throw new Error("A data subchunk was encountered before a format subchunk");
+            }
+            // If the data chunk is truncated, but truncations are ignored,
+            // it would be read up to the end of the buffer
+            dataBuffers.push(waveData.subarray(readOffset, readOffset + subChunkSize));
+        }
+        // All sub chunks other than 'data' (e.g. 'LIST', 'fact', 'plst', 'junk' etc.) are ignored
+        // This addition operation may overflow if JavaScript integers were 32 bits,
+        // but since they are 52 bits, it is okay:
+        readOffset += subChunkSize;
+        // Break if readOffset is equal to or is greater than the size of the buffer
+        if (readOffset >= waveData.length) {
+            break;
+        }
+    }
+    if (!formatSubChunkBodyBuffer) {
+        throw new Error("No format subchunk was found in the wave file");
+    }
+    const waveFormat = WaveFormat.deserializeFrom(formatSubChunkBodyBuffer);
+    const sampleFormat = waveFormat.sampleFormat;
+    const channelCount = waveFormat.channelCount;
+    const sampleRate = waveFormat.sampleRate;
+    const bitDepth = waveFormat.bitDepth;
+    const speakerPositionMask = waveFormat.speakerPositionMask;
+    const concatenatedDataBuffers = Buffer.concat(dataBuffers);
+    const audioChannels = AudioBufferConversion.decodeToChannels(concatenatedDataBuffers, channelCount, bitDepth, sampleFormat);
+    return {
+        rawAudio: { audioChannels, sampleRate },
+        sourceSampleFormat: sampleFormat,
+        sourceBitDepth: bitDepth,
+        sourceSpeakerPositionMask: speakerPositionMask
+    };
+}
+export function repairWave(waveData) {
+    const { rawAudio, sourceSampleFormat, sourceBitDepth } = decodeWave(waveData);
+    return encodeWave(rawAudio, sourceBitDepth, sourceSampleFormat);
+}
+class WaveFormat {
+    sampleFormat; // 2 bytes LE
+    channelCount; // 2 bytes LE
+    sampleRate; // 4 bytes LE
+    get byteRate() { return this.sampleRate * this.bytesPerSample * this.channelCount; } // 4 bytes LE
+    get blockAlign() { return this.bytesPerSample * this.channelCount; } // 2 bytes LE
+    bitDepth; // 2 bytes LE
+    speakerPositionMask; // 4 bytes LE
+    get guid() { return sampleFormatToGuid[this.sampleFormat]; } // 16 bytes BE
+    // helpers:
+    get bytesPerSample() { return this.bitDepth / 8; }
+    constructor(channelCount, sampleRate, bitDepth, sampleFormat, speakerPositionMask = 0) {
+        this.sampleFormat = sampleFormat;
+        this.channelCount = channelCount;
+        this.sampleRate = sampleRate;
+        this.bitDepth = bitDepth;
+        this.speakerPositionMask = speakerPositionMask;
+    }
+    serialize(useExtensibleFormat) {
+        let sampleFormatId = this.sampleFormat;
+        if (useExtensibleFormat) {
+            sampleFormatId = 65534;
+        }
+        const serializedSize = sampleFormatToSerializedSize[sampleFormatId];
+        const result = Buffer.alloc(serializedSize);
+        result.write("fmt ", 0, "ascii"); // + 4
+        result.writeUint32LE(serializedSize - 8, 4); // + 4
+        result.writeUint16LE(sampleFormatId, 8); // + 2
+        result.writeUint16LE(this.channelCount, 10); // + 2
+        result.writeUint32LE(this.sampleRate, 12); // + 4
+        result.writeUint32LE(this.byteRate, 16); // + 4
+        result.writeUint16LE(this.blockAlign, 20); // + 2
+        result.writeUint16LE(this.bitDepth, 22); // + 2
+        if (useExtensibleFormat) {
+            result.writeUint16LE(serializedSize - 26, 24); // + 2 (extension size)
+            result.writeUint16LE(this.bitDepth, 26); // + 2 (valid bits per sample)
+            result.writeUint32LE(this.speakerPositionMask, 28); // + 2 (speaker position mask)
+            if (this.sampleFormat == SampleFormat.PCM || this.sampleFormat == SampleFormat.Float) {
+                result.set(Buffer.from(this.guid, "hex"), 32);
+            }
+            else {
+                throw new Error(`Extensible format is not supported for sample format ${this.sampleFormat}`);
+            }
+        }
+        return result;
+    }
+    static deserializeFrom(formatChunkBody) {
+        let sampleFormat = formatChunkBody.readUint16LE(0); // + 2
+        const channelCount = formatChunkBody.readUint16LE(2); // + 2
+        const sampleRate = formatChunkBody.readUint32LE(4); // + 4
+        const bitDepth = formatChunkBody.readUint16LE(14);
+        let speakerPositionMask = 0;
+        if (sampleFormat == 65534) {
+            if (formatChunkBody.length < 40) {
+                throw new Error(`Format subchunk specifies a format id of 65534 (extensible) but its body size is ${formatChunkBody.length} bytes, which is smaller than the minimum expected of 40 bytes`);
+            }
+            speakerPositionMask = formatChunkBody.readUint16LE(20);
+            const guid = formatChunkBody.subarray(24, 40).toString("hex");
+            if (guid == sampleFormatToGuid[SampleFormat.PCM]) {
+                sampleFormat = SampleFormat.PCM;
+            }
+            else if (guid == sampleFormatToGuid[SampleFormat.Float]) {
+                sampleFormat = SampleFormat.Float;
+            }
+            else {
+                throw new Error(`Unsupported format GUID in extended format subchunk: ${guid}`);
+            }
+        }
+        if (sampleFormat == SampleFormat.PCM) {
+            if (bitDepth != 8 && bitDepth != 16 && bitDepth != 24 && bitDepth != 32) {
+                throw new Error(`PCM audio has a bit depth of ${bitDepth}, which is not supported`);
+            }
+        }
+        else if (sampleFormat == SampleFormat.Float) {
+            if (bitDepth != 32 && bitDepth != 64) {
+                throw new Error(`IEEE float audio has a bit depth of ${bitDepth}, which is not supported`);
+            }
+        }
+        else if (sampleFormat == SampleFormat.Alaw) {
+            if (bitDepth != 8) {
+                throw new Error(`Alaw audio has a bit depth of ${bitDepth}, which is not supported`);
+            }
+        }
+        else if (sampleFormat == SampleFormat.Mulaw) {
+            if (bitDepth != 8) {
+                throw new Error(`Mulaw audio has a bit depth of ${bitDepth}, which is not supported`);
+            }
+        }
+        else {
+            throw new Error(`Wave audio format id ${sampleFormat} is not supported`);
+        }
+        return new WaveFormat(channelCount, sampleRate, bitDepth, sampleFormat, speakerPositionMask);
+    }
+}
+export var SampleFormat;
+(function (SampleFormat) {
+    SampleFormat[SampleFormat["PCM"] = 1] = "PCM";
+    SampleFormat[SampleFormat["Float"] = 2] = "Float";
+    SampleFormat[SampleFormat["Alaw"] = 6] = "Alaw";
+    SampleFormat[SampleFormat["Mulaw"] = 7] = "Mulaw";
+})(SampleFormat = SampleFormat || (SampleFormat = {}));
+const sampleFormatToSerializedSize = {
+    [SampleFormat.PCM]: 24,
+    [SampleFormat.Float]: 26,
+    [SampleFormat.Alaw]: 26,
+    [SampleFormat.Mulaw]: 26,
+    65534: 48
+};
+const sampleFormatToGuid = {
+    [SampleFormat.PCM]: "0100000000001000800000aa00389b71",
+    [SampleFormat.Float]: "0300000000001000800000aa00389b71",
+    [SampleFormat.Alaw]: "",
+    [SampleFormat.Mulaw]: "",
+};
+//# sourceMappingURL=WaveCodec.js.map

package/dist/codecs/WaveCodec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WaveCodec.js","sourceRoot":"","sources":["../../src/codecs/WaveCodec.ts"],"names":[],"mappings":"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"}

package/dist/denoising/RNNoise.d.ts

@@ -0,0 +1,6 @@
+import { RawAudio } from "../audio/AudioUtilities.js";
+export declare function denoiseAudio(rawAudio: RawAudio): Promise<{
+    denoisedRawAudio: RawAudio;
+    frameVadProbabilities: number[];
+}>;
+export declare function getRnnoiseInstance(): Promise<any>;

package/dist/denoising/RNNoise.js

@@ -0,0 +1,68 @@
+import { float32ToInt16Pcm } from "../audio/AudioBufferConversion.js";
+import { concatFloat32Arrays } from "../utilities/Utilities.js";
+import { WasmMemoryManager } from "../utilities/WasmMemoryManager.js";
+import { Logger } from "../utilities/Logger.js";
+import { cloneRawAudio } from "../audio/AudioUtilities.js";
+let rnnoiseInstance;
+export async function denoiseAudio(rawAudio) {
+    const logger = new Logger();
+    if (rawAudio.sampleRate != 48000) {
+        throw new Error("Sample rate must be 48000");
+    }
+    if (rawAudio.audioChannels.length != 1) {
+        throw new Error("Channel count must be 1");
+    }
+    if (rawAudio.audioChannels[0].length == 0) {
+        return { denoisedRawAudio: cloneRawAudio(rawAudio), frameVadProbabilities: [] };
+    }
+    logger.start("Get RNNoise WASM instance");
+    const m = await getRnnoiseInstance();
+    logger.start("Process with RNNoise");
+    const wasmMemory = new WasmMemoryManager(m);
+    const stateSize = m._rnnoise_get_size();
+    const frameSize = m._rnnoise_get_frame_size();
+    const denoiseState = m._rnnoise_create(0);
+    const inputRef = wasmMemory.allocFloat32Array(frameSize);
+    const outputRef = wasmMemory.allocFloat32Array(frameSize);
+    const floatSamples = rawAudio.audioChannels[0];
+    const int16Samples = float32ToInt16Pcm(floatSamples);
+    const int16SamplesAsFloats = new Float32Array(int16Samples);
+    const processedFrames = [];
+    const frameVadProbabilities = [];
+    function outputNewFrame(newFrame, vadProbability) {
+        processedFrames.push(newFrame);
+        frameVadProbabilities.push(vadProbability);
+    }
+    for (let readOffset = 0; readOffset < int16Samples.length; readOffset += frameSize) {
+        let frame = int16SamplesAsFloats.subarray(readOffset, readOffset + frameSize);
+        if (frame.length < frameSize) {
+            frame = concatFloat32Arrays([frame, new Float32Array(frameSize - frame.length)]);
+        }
+        inputRef.view.set(frame);
+        const vadProbability = m._rnnoise_process_frame(denoiseState, outputRef.address, inputRef.address);
+        // Latency compensation: don't write an output frame for the first read frame
+        if (readOffset > 0) {
+            outputNewFrame(outputRef.view.slice(), vadProbability);
+        }
+    }
+    // Latency compensation: process an empty input frame for the last output frame
+    inputRef.view.set(new Float32Array(frameSize));
+    const lastFrameVadProbability = m._rnnoise_process_frame(denoiseState, outputRef.address, inputRef.address);
+    outputNewFrame(outputRef.view.slice(), lastFrameVadProbability);
+    m._rnnoise_destroy(denoiseState);
+    wasmMemory.freeAll();
+    const int16DenoisedSamplesAsFloats = concatFloat32Arrays(processedFrames);
+    let denoisedSamples = int16DenoisedSamplesAsFloats.map(sample => sample / 32768);
+    denoisedSamples = denoisedSamples.subarray(0, floatSamples.length);
+    const denoisedRawAudio = { audioChannels: [denoisedSamples], sampleRate: 48000 };
+    logger.end();
+    return { denoisedRawAudio, frameVadProbabilities };
+}
+export async function getRnnoiseInstance() {
+    if (!rnnoiseInstance) {
+        const { default: initializer } = await import('@echogarden/rnnoise-wasm');
+        rnnoiseInstance = await initializer();
+    }
+    return rnnoiseInstance;
+}
+//# sourceMappingURL=RNNoise.js.map

package/dist/denoising/RNNoise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RNNoise.js","sourceRoot":"","sources":["../../src/denoising/RNNoise.ts"],"names":[],"mappings":"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"}

package/dist/dsp/BiquadFilter.d.ts

@@ -0,0 +1,26 @@
+import { RawAudio } from "../audio/AudioUtilities.js";
+export declare function lowpassFilter(rawAudio: RawAudio, cutoffFrequency: number, q?: number): RawAudio;
+export declare function highpassFilter(rawAudio: RawAudio, cutoffFrequency: number, q?: number): RawAudio;
+export declare function bandpassFilter(rawAudio: RawAudio, centerFrequency: number, q?: number): RawAudio;
+export declare function lowshelfFilter(rawAudio: RawAudio, midpointFrequency: number, gain: number): RawAudio;
+export declare function highshelfFilter(rawAudio: RawAudio, midpointFrequency: number, gain: number): RawAudio;
+export declare function peakingFilter(rawAudio: RawAudio, centerFrequency: number, gain: number, q?: number): RawAudio;
+export declare function notchFilter(rawAudio: RawAudio, centerFrequency: number, q?: number): RawAudio;
+export declare function allpassFilter(rawAudio: RawAudio, centerFrequency: number, q?: number): RawAudio;
+export declare function filter(rawAudio: RawAudio, filterType: FilterType, frequency: number, gain: number, q: number): RawAudio;
+export declare function filterUsingCoefficients(samples: Float32Array, filterCoefficients: FilterCoefficients): Float32Array;
+export declare function createFilter(filterType: FilterType, sampleRate: number, centerFrequency: number, q: number, gain: number): any;
+export declare function createLowpassFilter(freqRatio: number, q: number, gain: number): FilterCoefficients;
+export declare function bandwidthToQFactor(bandwidth: number): number;
+export declare function qFactorToBandwidth(q: number): number;
+export declare const filterTypeName: {
+    [name in FilterType]: string;
+};
+export type FilterType = 'lowpass' | 'highpass' | 'bandpass' | 'lowshelf' | 'highshelf' | 'peaking' | 'notch' | 'allpass';
+export type FilterCoefficients = {
+    b0: number;
+    b1: number;
+    b2: number;
+    a1: number;
+    a2: number;
+};