hls-streamer 2.1.0 → 3.0.0

package/dist/cjs/Libs/FormatDetector.d.ts

@@ -0,0 +1,8 @@
+import { AudioFormat } from '../Parsers/IAudioParser';
+export declare class FormatDetector {
+    static detectFormat(buffer: Buffer): AudioFormat | null;
+    static detectFormatFromExtension(filePath: string): AudioFormat | null;
+    static getSupportedExtensions(): string[];
+    static isSupportedExtension(filePath: string): boolean;
+}
+//# sourceMappingURL=FormatDetector.d.ts.map

package/dist/cjs/Libs/FormatDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormatDetector.d.ts","sourceRoot":"","sources":["../../../src/Libs/FormatDetector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAKtD,qBAAa,cAAc;IAMzB,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAoDvD,MAAM,CAAC,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IA0BtE,MAAM,CAAC,sBAAsB,IAAI,MAAM,EAAE;IAOzC,MAAM,CAAC,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAIvD"}

package/dist/cjs/Libs/FormatDetector.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FormatDetector = void 0;
+class FormatDetector {
+    static detectFormat(buffer) {
+        if (buffer.length < 4) {
+            return null;
+        }
+        if (buffer.toString('ascii', 0, 3) === 'ID3') {
+            return 'mp3';
+        }
+        if (buffer.length >= 2 && buffer[0] === 0xff && (buffer[1] & 0xe0) === 0xe0) {
+            return 'mp3';
+        }
+        if (buffer.toString('ascii', 0, 4) === 'fLaC') {
+            return 'flac';
+        }
+        if (buffer.toString('ascii', 0, 4) === 'OggS') {
+            return 'ogg';
+        }
+        if (buffer.length >= 12 &&
+            buffer.toString('ascii', 0, 4) === 'RIFF' &&
+            buffer.toString('ascii', 8, 12) === 'WAVE') {
+            return 'wav';
+        }
+        if (buffer.length >= 12 && buffer.toString('ascii', 4, 8) === 'ftyp') {
+            const brand = buffer.toString('ascii', 8, 12);
+            if (brand === 'M4A ' || brand === 'M4B ' || brand === 'mp42' || brand === 'isom') {
+                return 'm4a';
+            }
+        }
+        if (buffer.length >= 2 && buffer[0] === 0xff && (buffer[1] & 0xf6) === 0xf0) {
+            return 'aac';
+        }
+        return null;
+    }
+    static detectFormatFromExtension(filePath) {
+        const ext = filePath.toLowerCase().split('.').pop();
+        switch (ext) {
+            case 'mp3':
+                return 'mp3';
+            case 'aac':
+                return 'aac';
+            case 'm4a':
+            case 'm4b':
+                return 'm4a';
+            case 'ogg':
+            case 'oga':
+                return 'ogg';
+            case 'flac':
+                return 'flac';
+            case 'wav':
+                return 'wav';
+            default:
+                return null;
+        }
+    }
+    static getSupportedExtensions() {
+        return ['.mp3', '.aac', '.m4a', '.m4b', '.ogg', '.oga', '.flac', '.wav'];
+    }
+    static isSupportedExtension(filePath) {
+        const ext = '.' + filePath.toLowerCase().split('.').pop();
+        return this.getSupportedExtensions().includes(ext);
+    }
+}
+exports.FormatDetector = FormatDetector;
+//# sourceMappingURL=FormatDetector.js.map

package/dist/cjs/Libs/FormatDetector.js.map

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

package/dist/cjs/Parsers/AacParser.d.ts

@@ -0,0 +1,15 @@
+import { IAudioParser, AudioFileInfo, AudioFormat } from './IAudioParser';
+export declare class AacParser implements IAudioParser {
+    private static readonly SAMPLE_RATES;
+    getFormat(): AudioFormat;
+    canParse(buffer: Buffer): boolean;
+    analyze(buffer: Buffer, opts?: {
+        fileSize?: number;
+    }): AudioFileInfo;
+    private analyzeAdts;
+    private analyzeM4a;
+    private parseAdtsHeader;
+    private parseBoxes;
+    private findBoxInData;
+}
+//# sourceMappingURL=AacParser.d.ts.map

package/dist/cjs/Parsers/AacParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AacParser.d.ts","sourceRoot":"","sources":["../../../src/Parsers/AacParser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAkB,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAM1F,qBAAa,SAAU,YAAW,YAAY;IAC5C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAGlC;IAEF,SAAS,IAAI,WAAW;IAKxB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAkBjC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,aAAa;IAWxE,OAAO,CAAC,WAAW;IA8FnB,OAAO,CAAC,UAAU;IAuGlB,OAAO,CAAC,eAAe;IA+BvB,OAAO,CAAC,UAAU;IA4BlB,OAAO,CAAC,aAAa;CAwBtB"}

package/dist/cjs/Parsers/AacParser.js

@@ -0,0 +1,250 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AacParser = void 0;
+class AacParser {
+    getFormat() {
+        return 'aac';
+    }
+    canParse(buffer) {
+        if (buffer.length < 4) {
+            return false;
+        }
+        if (buffer.length >= 12 && buffer.toString('ascii', 4, 8) === 'ftyp') {
+            return true;
+        }
+        if (buffer[0] === 0xff && (buffer[1] & 0xf6) === 0xf0) {
+            return true;
+        }
+        return false;
+    }
+    analyze(buffer, opts = {}) {
+        const size = opts.fileSize ?? buffer.length;
+        if (buffer.length >= 12 && buffer.toString('ascii', 4, 8) === 'ftyp') {
+            return this.analyzeM4a(buffer, size);
+        }
+        else {
+            return this.analyzeAdts(buffer, size);
+        }
+    }
+    analyzeAdts(buffer, size) {
+        const warnings = [];
+        const frames = [];
+        let offset = 0;
+        let frameIndex = 0;
+        let sampleRate;
+        let channels;
+        let totalDuration = 0;
+        let totalBytes = 0;
+        while (offset + 7 <= buffer.length) {
+            if (buffer[offset] !== 0xff || (buffer[offset + 1] & 0xf6) !== 0xf0) {
+                offset++;
+                continue;
+            }
+            const header = this.parseAdtsHeader(buffer, offset);
+            if (!header) {
+                offset++;
+                continue;
+            }
+            if (offset + header.frameLength > buffer.length) {
+                warnings.push(`Truncated ADTS frame at offset ${offset}`);
+                break;
+            }
+            sampleRate = sampleRate ?? header.sampleRate;
+            channels = channels ?? header.channels;
+            const samplesPerFrame = 1024;
+            const frameDuration = samplesPerFrame / header.sampleRate;
+            frames.push({
+                index: frameIndex,
+                offset,
+                length: header.frameLength,
+                duration: frameDuration,
+                samples: samplesPerFrame,
+                sampleRate: header.sampleRate,
+                bitrate: Math.round((header.frameLength * 8 * header.sampleRate) / samplesPerFrame / 1000)
+            });
+            totalDuration += frameDuration;
+            totalBytes += header.frameLength;
+            offset += header.frameLength;
+            frameIndex++;
+        }
+        if (frames.length === 0) {
+            return {
+                format: 'aac',
+                size,
+                duration: 0,
+                audioDataSize: 0,
+                frames: [],
+                warnings: ['No valid ADTS frames found']
+            };
+        }
+        const averageBitrate = totalDuration > 0 ? (totalBytes * 8) / totalDuration / 1000 : undefined;
+        const metadata = {
+            format: 'aac',
+            size,
+            duration: totalDuration,
+            audioDataSize: totalBytes,
+            frames
+        };
+        if (sampleRate !== undefined) {
+            metadata.sampleRate = sampleRate;
+        }
+        if (channels !== undefined) {
+            metadata.channels = channels;
+        }
+        if (averageBitrate !== undefined) {
+            metadata.averageBitrate = averageBitrate;
+        }
+        if (warnings.length > 0) {
+            metadata.warnings = warnings;
+        }
+        return metadata;
+    }
+    analyzeM4a(buffer, size) {
+        const warnings = [];
+        const boxes = this.parseBoxes(buffer);
+        let duration = 0;
+        let sampleRate;
+        let channels;
+        let bitrate;
+        let audioDataSize = 0;
+        const mdatBox = boxes.find(b => b.type === 'mdat');
+        if (mdatBox) {
+            audioDataSize = mdatBox.size - 8;
+        }
+        const moovBox = boxes.find(b => b.type === 'moov');
+        if (moovBox && moovBox.offset + 8 <= buffer.length) {
+            const moovData = buffer.subarray(moovBox.offset + 8, Math.min(buffer.length, moovBox.offset + moovBox.size));
+            const mvhdBox = this.findBoxInData(moovData, 'mvhd');
+            if (mvhdBox && mvhdBox.offset + 20 <= moovData.length) {
+                const version = moovData[mvhdBox.offset];
+                const offset = version === 1 ? mvhdBox.offset + 20 : mvhdBox.offset + 12;
+                if (offset + 8 <= moovData.length) {
+                    const timescale = moovData.readUInt32BE(offset);
+                    const durationUnits = version === 1
+                        ? Number(moovData.readBigUInt64BE(offset + 4))
+                        : moovData.readUInt32BE(offset + 4);
+                    duration = timescale > 0 ? durationUnits / timescale : 0;
+                }
+            }
+            const mp4aBox = this.findBoxInData(moovData, 'mp4a');
+            if (mp4aBox && mp4aBox.offset + 28 <= moovData.length) {
+                channels = moovData.readUInt16BE(mp4aBox.offset + 16);
+                sampleRate = moovData.readUInt32BE(mp4aBox.offset + 24) >> 16;
+            }
+        }
+        const averageBitrate = duration > 0 ? (audioDataSize * 8) / duration / 1000 : undefined;
+        const frames = [];
+        if (duration > 0 && sampleRate) {
+            const samplesPerFrame = 1024;
+            const frameDuration = samplesPerFrame / sampleRate;
+            const totalFrames = Math.ceil(duration / frameDuration);
+            const avgFrameSize = audioDataSize / totalFrames;
+            const mdatStart = mdatBox ? mdatBox.offset + 8 : 0;
+            for (let i = 0; i < totalFrames; i++) {
+                frames.push({
+                    index: i,
+                    offset: mdatStart + Math.floor(i * avgFrameSize),
+                    length: Math.floor(avgFrameSize),
+                    duration: frameDuration,
+                    samples: samplesPerFrame,
+                    sampleRate,
+                    bitrate: Math.round(averageBitrate || 0)
+                });
+            }
+        }
+        const metadata = {
+            format: 'm4a',
+            size,
+            duration,
+            audioDataSize,
+            frames
+        };
+        if (sampleRate !== undefined) {
+            metadata.sampleRate = sampleRate;
+        }
+        if (channels !== undefined) {
+            metadata.channels = channels;
+        }
+        if (averageBitrate !== undefined) {
+            metadata.averageBitrate = averageBitrate;
+        }
+        if (warnings.length > 0) {
+            metadata.warnings = warnings;
+        }
+        metadata.metadata = {
+            container: 'mp4',
+            codec: 'aac'
+        };
+        return metadata;
+    }
+    parseAdtsHeader(buffer, offset) {
+        if (offset + 7 > buffer.length) {
+            return null;
+        }
+        const byte2 = buffer[offset + 2];
+        const byte3 = buffer[offset + 3];
+        const byte4 = buffer[offset + 4];
+        const byte5 = buffer[offset + 5];
+        const sampleRateIndex = (byte2 >> 2) & 0x0f;
+        const channelConfig = ((byte2 & 0x01) << 2) | ((byte3 >> 6) & 0x03);
+        const sampleRate = AacParser.SAMPLE_RATES[sampleRateIndex];
+        if (!sampleRate || sampleRate === 0) {
+            return null;
+        }
+        const frameLength = ((byte3 & 0x03) << 11) | (byte4 << 3) | ((byte5 >> 5) & 0x07);
+        return {
+            sampleRate,
+            channels: channelConfig,
+            frameLength
+        };
+    }
+    parseBoxes(buffer) {
+        const boxes = [];
+        let offset = 0;
+        while (offset + 8 <= buffer.length) {
+            let size = buffer.readUInt32BE(offset);
+            const type = buffer.toString('ascii', offset + 4, offset + 8);
+            if (size === 1 && offset + 16 <= buffer.length) {
+                size = Number(buffer.readBigUInt64BE(offset + 8));
+            }
+            else if (size === 0) {
+                size = buffer.length - offset;
+            }
+            boxes.push({ type, size, offset });
+            if (size < 8 || offset + size > buffer.length) {
+                break;
+            }
+            offset += size;
+        }
+        return boxes;
+    }
+    findBoxInData(data, boxType) {
+        let offset = 0;
+        while (offset + 8 <= data.length) {
+            let size = data.readUInt32BE(offset);
+            const type = data.toString('ascii', offset + 4, offset + 8);
+            if (size === 1 && offset + 16 <= data.length) {
+                size = Number(data.readBigUInt64BE(offset + 8));
+            }
+            if (type === boxType) {
+                return { offset: offset + 8, size };
+            }
+            if (size < 8 || offset + size > data.length) {
+                break;
+            }
+            offset += size;
+        }
+        return null;
+    }
+}
+exports.AacParser = AacParser;
+Object.defineProperty(AacParser, "SAMPLE_RATES", {
+    enumerable: true,
+    configurable: true,
+    writable: true,
+    value: [
+        96000, 88200, 64000, 48000, 44100, 32000, 24000, 22050,
+        16000, 12000, 11025, 8000, 7350, 0, 0, 0
+    ]
+});
+//# sourceMappingURL=AacParser.js.map

package/dist/cjs/Parsers/AacParser.js.map

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

package/dist/cjs/Parsers/FlacParser.d.ts

@@ -0,0 +1,13 @@
+import { IAudioParser, AudioFileInfo, AudioFormat } from './IAudioParser';
+export declare class FlacParser implements IAudioParser {
+    private static readonly FLAC_SIGNATURE;
+    getFormat(): AudioFormat;
+    canParse(buffer: Buffer): boolean;
+    analyze(buffer: Buffer, opts?: {
+        fileSize?: number;
+    }): AudioFileInfo;
+    private parseStreamInfo;
+    private findNextFrameSync;
+    private parseFrameHeader;
+}
+//# sourceMappingURL=FlacParser.d.ts.map

package/dist/cjs/Parsers/FlacParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlacParser.d.ts","sourceRoot":"","sources":["../../../src/Parsers/FlacParser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAkB,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAK1F,qBAAa,UAAW,YAAW,YAAY;IAC7C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAU;IAEhD,SAAS,IAAI,WAAW;IAIxB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIjC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,aAAa;IAgLxE,OAAO,CAAC,eAAe;IA+BvB,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,gBAAgB;CA6BzB"}

package/dist/cjs/Parsers/FlacParser.js

@@ -0,0 +1,204 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlacParser = void 0;
+class FlacParser {
+    getFormat() {
+        return 'flac';
+    }
+    canParse(buffer) {
+        return buffer.length >= 4 && buffer.toString('ascii', 0, 4) === FlacParser.FLAC_SIGNATURE;
+    }
+    analyze(buffer, opts = {}) {
+        const warnings = [];
+        const size = opts.fileSize ?? buffer.length;
+        if (!this.canParse(buffer)) {
+            return {
+                format: 'flac',
+                size,
+                duration: 0,
+                audioDataSize: 0,
+                frames: [],
+                warnings: ['Not a valid FLAC file']
+            };
+        }
+        let offset = 4;
+        let streamInfo = null;
+        let audioDataOffset = -1;
+        while (offset + 4 <= buffer.length) {
+            const blockHeader = buffer[offset];
+            if (blockHeader === undefined)
+                break;
+            const isLast = (blockHeader & 0x80) !== 0;
+            const blockType = blockHeader & 0x7f;
+            const blockLength = (buffer[offset + 1] << 16) | (buffer[offset + 2] << 8) | buffer[offset + 3];
+            offset += 4;
+            if (blockType === 0) {
+                if (blockLength < 34) {
+                    warnings.push('Invalid STREAMINFO block size');
+                    break;
+                }
+                streamInfo = this.parseStreamInfo(buffer, offset);
+            }
+            offset += blockLength;
+            if (isLast) {
+                audioDataOffset = offset;
+                break;
+            }
+        }
+        if (!streamInfo) {
+            return {
+                format: 'flac',
+                size,
+                duration: 0,
+                audioDataSize: 0,
+                frames: [],
+                warnings: ['Missing STREAMINFO block']
+            };
+        }
+        const duration = streamInfo.sampleRate > 0
+            ? Number(streamInfo.totalSamples) / streamInfo.sampleRate
+            : 0;
+        const audioDataSize = audioDataOffset > 0 ? size - audioDataOffset : 0;
+        const averageBitrate = duration > 0 ? (audioDataSize * 8) / duration / 1000 : undefined;
+        const frames = [];
+        if (audioDataOffset > 0 && audioDataOffset < buffer.length) {
+            let frameOffset = audioDataOffset;
+            let frameIndex = 0;
+            const maxFrames = 10000;
+            while (frameOffset + 4 <= buffer.length && frameIndex < maxFrames) {
+                const frameHeader = this.findNextFrameSync(buffer, frameOffset);
+                if (frameHeader === -1) {
+                    break;
+                }
+                frameOffset = frameHeader;
+                const frameInfo = this.parseFrameHeader(buffer, frameOffset, streamInfo);
+                if (!frameInfo) {
+                    frameOffset++;
+                    continue;
+                }
+                const estimatedFrameSize = streamInfo.maxFrameSize > 0
+                    ? streamInfo.maxFrameSize
+                    : Math.ceil((streamInfo.maxBlockSize * streamInfo.bitsPerSample * streamInfo.channels) / 8) + 16;
+                const frameDuration = frameInfo.blockSize / streamInfo.sampleRate;
+                frames.push({
+                    index: frameIndex,
+                    offset: frameOffset,
+                    length: estimatedFrameSize,
+                    duration: frameDuration,
+                    samples: frameInfo.blockSize,
+                    sampleRate: streamInfo.sampleRate,
+                    bitrate: Math.round(averageBitrate || 0)
+                });
+                frameIndex++;
+                frameOffset += estimatedFrameSize;
+            }
+        }
+        if (frames.length === 0 && duration > 0) {
+            warnings.push('Could not parse FLAC frames, using estimated segmentation');
+            const framesPerSecond = streamInfo.sampleRate / streamInfo.maxBlockSize;
+            const totalFrames = Math.ceil(duration * framesPerSecond);
+            const avgFrameSize = audioDataSize / totalFrames;
+            let frameOffset = audioDataOffset;
+            for (let i = 0; i < totalFrames; i++) {
+                const frameDuration = streamInfo.maxBlockSize / streamInfo.sampleRate;
+                frames.push({
+                    index: i,
+                    offset: frameOffset,
+                    length: Math.floor(avgFrameSize),
+                    duration: frameDuration,
+                    samples: streamInfo.maxBlockSize,
+                    sampleRate: streamInfo.sampleRate,
+                    bitrate: Math.round(averageBitrate || 0)
+                });
+                frameOffset += avgFrameSize;
+            }
+        }
+        const metadata = {
+            format: 'flac',
+            size,
+            duration,
+            audioDataSize,
+            sampleRate: streamInfo.sampleRate,
+            channels: streamInfo.channels,
+            bitDepth: streamInfo.bitsPerSample,
+            frames
+        };
+        if (averageBitrate !== undefined) {
+            metadata.averageBitrate = averageBitrate;
+        }
+        if (warnings.length > 0) {
+            metadata.warnings = warnings;
+        }
+        metadata.metadata = {
+            minBlockSize: streamInfo.minBlockSize,
+            maxBlockSize: streamInfo.maxBlockSize,
+            minFrameSize: streamInfo.minFrameSize,
+            maxFrameSize: streamInfo.maxFrameSize,
+            totalSamples: streamInfo.totalSamples.toString()
+        };
+        return metadata;
+    }
+    parseStreamInfo(buffer, offset) {
+        const minBlockSize = buffer.readUInt16BE(offset);
+        const maxBlockSize = buffer.readUInt16BE(offset + 2);
+        const minFrameSize = (buffer[offset + 4] << 16) | (buffer[offset + 5] << 8) | buffer[offset + 6];
+        const maxFrameSize = (buffer[offset + 7] << 16) | (buffer[offset + 8] << 8) | buffer[offset + 9];
+        const word1 = buffer.readUInt32BE(offset + 10);
+        const word2 = buffer.readUInt32BE(offset + 14);
+        const sampleRate = (word1 >> 12) & 0xfffff;
+        const channels = ((word1 >> 9) & 0x7) + 1;
+        const bitsPerSample = ((word1 >> 4) & 0x1f) + 1;
+        const totalSamplesHigh = BigInt(word1 & 0xf);
+        const totalSamplesLow = BigInt(word2);
+        const totalSamples = (totalSamplesHigh << 32n) | totalSamplesLow;
+        return {
+            minBlockSize,
+            maxBlockSize,
+            minFrameSize,
+            maxFrameSize,
+            sampleRate,
+            channels,
+            bitsPerSample,
+            totalSamples
+        };
+    }
+    findNextFrameSync(buffer, startOffset) {
+        for (let i = startOffset; i < buffer.length - 1; i++) {
+            if (buffer[i] === 0xff && (buffer[i + 1] & 0xfc) === 0xf8) {
+                return i;
+            }
+        }
+        return -1;
+    }
+    parseFrameHeader(buffer, offset, streamInfo) {
+        if (offset + 4 > buffer.length) {
+            return null;
+        }
+        if (buffer[offset] !== 0xff || (buffer[offset + 1] & 0xfc) !== 0xf8) {
+            return null;
+        }
+        const byte2 = buffer[offset + 2];
+        if (byte2 === undefined)
+            return null;
+        const blockSizeCode = (byte2 >> 4) & 0x0f;
+        let blockSize = streamInfo.maxBlockSize;
+        if (blockSizeCode >= 1 && blockSizeCode <= 5) {
+            blockSize = 192 * (1 << (blockSizeCode - 1));
+        }
+        else if (blockSizeCode === 6 || blockSizeCode === 7) {
+            blockSize = streamInfo.maxBlockSize;
+        }
+        else if (blockSizeCode >= 8 && blockSizeCode <= 15) {
+            blockSize = 256 * (1 << (blockSizeCode - 8));
+        }
+        return { blockSize };
+    }
+}
+exports.FlacParser = FlacParser;
+Object.defineProperty(FlacParser, "FLAC_SIGNATURE", {
+    enumerable: true,
+    configurable: true,
+    writable: true,
+    value: 'fLaC'
+});
+//# sourceMappingURL=FlacParser.js.map

package/dist/cjs/Parsers/FlacParser.js.map

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

package/dist/cjs/Parsers/IAudioParser.d.ts

@@ -0,0 +1,31 @@
+export type AudioFormat = 'mp3' | 'aac' | 'm4a' | 'ogg' | 'flac' | 'wav';
+export interface AudioFrameInfo {
+    index: number;
+    offset: number;
+    length: number;
+    duration: number;
+    samples: number;
+    sampleRate: number;
+    bitrate: number;
+}
+export interface AudioFileInfo {
+    format: AudioFormat;
+    size: number;
+    duration: number;
+    audioDataSize: number;
+    sampleRate?: number;
+    averageBitrate?: number;
+    bitDepth?: number;
+    channels?: number;
+    frames: AudioFrameInfo[];
+    warnings?: string[];
+    metadata?: Record<string, any>;
+}
+export interface IAudioParser {
+    analyze(buffer: Buffer, opts?: {
+        fileSize?: number;
+    }): AudioFileInfo;
+    getFormat(): AudioFormat;
+    canParse(buffer: Buffer): boolean;
+}
+//# sourceMappingURL=IAudioParser.d.ts.map

package/dist/cjs/Parsers/IAudioParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAudioParser.d.ts","sourceRoot":"","sources":["../../../src/Parsers/IAudioParser.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;AAKzE,MAAM,WAAW,cAAc;IAE7B,KAAK,EAAE,MAAM,CAAC;IAEd,MAAM,EAAE,MAAM,CAAC;IAEf,MAAM,EAAE,MAAM,CAAC;IAEf,QAAQ,EAAE,MAAM,CAAC;IAEjB,OAAO,EAAE,MAAM,CAAC;IAEhB,UAAU,EAAE,MAAM,CAAC;IAEnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAKD,MAAM,WAAW,aAAa;IAE5B,MAAM,EAAE,WAAW,CAAC;IAEpB,IAAI,EAAE,MAAM,CAAC;IAEb,QAAQ,EAAE,MAAM,CAAC;IAEjB,aAAa,EAAE,MAAM,CAAC;IAEtB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,MAAM,EAAE,cAAc,EAAE,CAAC;IAEzB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAKD,MAAM,WAAW,YAAY;IAM3B,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,aAAa,CAAC;IAKrE,SAAS,IAAI,WAAW,CAAC;IAMzB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC"}

package/dist/cjs/Parsers/IAudioParser.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IAudioParser.js.map

package/dist/cjs/Parsers/IAudioParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAudioParser.js","sourceRoot":"","sources":["../../../src/Parsers/IAudioParser.ts"],"names":[],"mappings":""}