hls-streamer 4.5.1 → 4.6.1

package/README.md

@@ -335,9 +335,11 @@ Provide either `filePath` **or** `storageProvider` — not both.
 ### API Surface
 
 - `createM3U8(): Promise<string>` – Full HLS playlist with frame-accurate durations. Audio → HLS v6; Video → HLS v7 + `EXT-X-MAP`.
-- `getFileBuffer(start: number, end: number): Promise<Buffer>` – Byte-range read from the source file (used for both segments and the init segment).
+- `getFileBuffer(start: number, end: number): Promise<Buffer>` – Byte-range read from the source file (used for both segments and the init segment). Validates the range against file size only — does not trigger a full parse.
 - `getSegmentDuration(index: number): Promise<number>` – Duration in seconds for a specific segment.
-- `getMediaType(): Promise<'audio' | 'video'>` – Returns `'video'` for MP4/MOV/M4V, `'audio'` for everything else.
+- `getMediaType(): Promise<'audio' | 'video'>` – Returns `'video'` for MP4/MOV/M4V, `'audio'` for everything else. Reads only the file header (~64 bytes) when possible.
+- `getFileInfo(): Promise<MediaFileInfo>` – Parsed metadata (size, duration, frame table, etc.). Cached on the instance.
+- `restoreFileInfo(fileInfo: MediaFileInfo): void` – Hydrate a previously-parsed `MediaFileInfo` into a fresh instance, skipping the underlying parse. Pair with an external metadata cache (LRU, Redis) to avoid re-downloading + re-parsing the same file across short-lived instances. Safe to round-trip via `JSON.stringify` / `JSON.parse`.
 
 Custom error classes: `FileNotFoundError`, `InvalidFileError`, `InvalidRangeError`, `InvalidParameterError`, `UnsupportedFormatError`, `StorageProviderError`.
 
@@ -397,6 +399,19 @@ Custom error classes: `FileNotFoundError`, `InvalidFileError`, `InvalidRangeErro
 ## Operational Tips
 
 - **Caching** – Construct the streamer once per unique file and reuse it. Segment planning caches metadata after the first call.
+- **External metadata cache** – If you cannot keep `HlsStreamer` instances alive between requests (e.g. serverless, multi-process workers), use `getFileInfo()` to capture the parsed `MediaFileInfo` once and `restoreFileInfo()` to hydrate fresh instances on subsequent requests. Subsequent calls to `createM3U8()`, `getMediaType()`, and `getFileBuffer()` then issue zero parse-related reads against your storage backend:
+
+  ```ts
+  const cached = lruCache.get(s3Key); // your cache
+  const streamer = new HlsStreamer({ storageProvider: new S3Provider({ bucket, key: s3Key, client: s3 }) });
+  if (cached) {
+    streamer.restoreFileInfo(cached);
+  } else {
+    lruCache.set(s3Key, await streamer.getFileInfo());
+  }
+  // From here, segment requests do one ranged GET, nothing more.
+  ```
+
 - **Video segment size** – Use a larger `segmentSizeKB` (1024–4096) for video to avoid excessive HTTP requests. Audio works well at 512.
 - **CDN friendliness** – Segment URLs are deterministic byte ranges, making them ideal for edge caching. Use `Cache-Control: public, max-age=86400`.
 - **Serverless** – Zero-dependency design works in Lambda/Cloud Functions. `getFileBuffer` reads only the bytes needed, keeping memory usage low.
@@ -433,6 +448,28 @@ Contributions are welcome! Please open an issue to discuss substantial changes b
 
 ## Release Notes
 
+For the complete history, see [CHANGELOG.md](./CHANGELOG.md).
+
+### Version 4.6.0
+
+#### New Features
+
+- **`HlsStreamer.getFileInfo()`** is now public — returns the parsed `MediaFileInfo` (size, duration, frame table, etc.). Result is cached on the instance.
+- **`HlsStreamer.restoreFileInfo(fileInfo)`** hydrates a previously-parsed `MediaFileInfo` into a fresh instance, skipping the underlying parse. Designed to pair with an external cache (LRU, Redis) so short-lived instances avoid redundant downloads + re-parsing of the same file. Round-trips cleanly through `JSON.stringify` / `JSON.parse`.
+
+#### Performance
+
+- **`getMediaType()`** no longer triggers a full file read in the common path. It now reads only the file header (~64 bytes) and classifies via magic bytes; falls back to a full parse only when the header is inconclusive. With a `format` override, classification happens with no read at all.
+- **`getFileBuffer()`** no longer triggers a full file parse. It validates the requested range using only `provider.getSize()` (a HEAD-equivalent), then issues the ranged read. The size is memoized on the instance — repeated segment requests against the same `HlsStreamer` issue exactly one `getSize()` call regardless of how many ranges are fetched.
+
+#### Migration
+
+Fully backward compatible — no signatures or behaviors changed. All additions are additive.
+
+Full details: [CHANGELOG.md](./CHANGELOG.md#460---2026-05-02).
+
+---
+
 ### Version 4.5.0
 
 #### New Features

package/dist/Libs/FileLib.d.ts

@@ -1,8 +1,6 @@
 import { Mp3FileInfo, MediaFileInfo } from '../Interfaces/HlsStreamer';
 import { MediaFormat } from '../Parsers/IMediaParser';
 export declare class FileLib {
-    private static readonly BITRATE_INDEX;
-    private static readonly SAMPLE_RATE_INDEX;
     static getFileSizeInBytes(buffer: Buffer): number;
     static getMP3DurationFromBuffer(mp3Buffer: Buffer): Promise<number>;
     static analyzeMP3Buffer(buffer: Buffer, opts?: {
@@ -21,13 +19,5 @@ export declare class FileLib {
         filePath?: string;
         format?: MediaFormat;
     }): MediaFileInfo;
-    private static calculateFrameLength;
-    private static getId3Offsets;
-    private static syncSafeInteger;
-    private static isFrameSync;
-    private static parseFrameHeader;
-    private static decodeVersion;
-    private static decodeLayer;
-    private static getSamplesPerFrame;
 }
 //# sourceMappingURL=FileLib.d.ts.map

package/dist/Libs/FileLib.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FileLib.d.ts","sourceRoot":"","sources":["../../src/Libs/FileLib.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAgB,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAGrF,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAqBtD,qBAAa,OAAO;IAClB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAgBnC;IAEF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAIvC;IAKF,MAAM,CAAC,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;WAWpC,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQzE,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,WAAW;WA8HzE,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;WAetD,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC;WAmBhF,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC;IAU7F,MAAM,CAAC,kBAAkB,CACvB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GACxE,aAAa;IA8BhB,MAAM,CAAC,kBAAkB,CACvB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GACxE,aAAa;IAIhB,OAAO,CAAC,MAAM,CAAC,oBAAoB;IASnC,OAAO,CAAC,MAAM,CAAC,aAAa;IA8B5B,OAAO,CAAC,MAAM,CAAC,eAAe;IAO9B,OAAO,CAAC,MAAM,CAAC,WAAW;IAW1B,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAqC/B,OAAO,CAAC,MAAM,CAAC,aAAa;IAa5B,OAAO,CAAC,MAAM,CAAC,WAAW;IAa1B,OAAO,CAAC,MAAM,CAAC,kBAAkB;CAWlC"}
+{"version":3,"file":"FileLib.d.ts","sourceRoot":"","sources":["../../src/Libs/FileLib.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAgB,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAErF,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAMtD,qBAAa,OAAO;IAIlB,MAAM,CAAC,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;WAWpC,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQzE,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,WAAW;WAiDzE,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;WAetD,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC;WAmBhF,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC;IAU7F,MAAM,CAAC,kBAAkB,CACvB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GACxE,aAAa;IA8BhB,MAAM,CAAC,kBAAkB,CACvB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GACxE,aAAa;CAGjB"}

package/dist/Libs/FileLib.js

@@ -1,5 +1,6 @@
 import fs from 'node:fs';
 import { ParserFactory } from '../Parsers/ParserFactory';
+import { Mp3Parser } from '../Parsers/Mp3Parser';
 export class FileLib {
     static getFileSizeInBytes(buffer) {
         if (Buffer.isBuffer(buffer)) {
@@ -14,98 +15,39 @@ export class FileLib {
         return duration;
     }
     static analyzeMP3Buffer(buffer, opts = {}) {
-        const warnings = [];
-        const size = opts.fileSize ?? buffer.length;
-        if (buffer.length === 0) {
-            return {
-                size,
-                duration: 0,
-                audioDataSize: 0,
-                frames: []
-            };
-        }
-        const offsets = this.getId3Offsets(buffer);
-        const frames = [];
-        const payloadSize = Math.max(0, offsets.audioEnd - offsets.startOffset);
-        let offset = offsets.startOffset;
-        let frameIndex = 0;
-        let sampleRate;
-        let totalDuration = 0;
-        let totalAudioBytes = 0;
-        while (offset + 4 <= offsets.audioEnd) {
-            if (!this.isFrameSync(buffer, offset)) {
-                offset++;
-                continue;
-            }
-            const header = buffer.readUInt32BE(offset);
-            const parsed = this.parseFrameHeader(header);
-            if (!parsed) {
-                offset++;
-                continue;
-            }
-            const frameLength = this.calculateFrameLength(parsed);
-            if (frameLength <= 0) {
-                warnings.push(`Encountered zero-length frame at offset ${offset}`);
-                offset++;
-                continue;
-            }
-            if (offset + frameLength > buffer.length) {
-                warnings.push(`Truncated frame at offset ${offset}`);
-                break;
-            }
-            sampleRate = sampleRate ?? parsed.sampleRate;
-            const frameDuration = parsed.samplesPerFrame / parsed.sampleRate;
-            frames.push({
-                index: frameIndex,
-                offset,
-                length: frameLength,
-                duration: frameDuration,
-                samples: parsed.samplesPerFrame,
-                sampleRate: parsed.sampleRate,
-                bitrate: parsed.bitrate,
-                padding: parsed.padding
-            });
-            frameIndex++;
-            totalDuration += frameDuration;
-            totalAudioBytes += frameLength;
-            offset += frameLength;
-        }
-        if (frames.length === 0) {
-            const estimatedDuration = buffer.length / 16000;
-            warnings.push('Falling back to heuristic duration due to missing MP3 frames');
-            const metadata = {
-                size,
-                duration: Math.max(0.001, estimatedDuration),
-                audioDataSize: payloadSize,
-                frames: []
-            };
-            if (warnings.length) {
-                metadata.warnings = warnings;
-            }
-            return metadata;
-        }
-        const duration = totalDuration;
-        const averageBitrate = duration > 0 ? (totalAudioBytes * 8) / duration / 1000 : undefined;
+        const parsed = new Mp3Parser().analyze(buffer, opts);
+        const frames = parsed.frames.map((frame) => ({
+            index: frame.index,
+            offset: frame.offset,
+            length: frame.length,
+            duration: frame.duration,
+            samples: frame.samples,
+            sampleRate: frame.sampleRate,
+            bitrate: frame.bitrate,
+            padding: (((buffer[frame.offset + 2] ?? 0) >> 1) & 0x1)
+        }));
         const metadata = {
-            size,
-            duration,
-            audioDataSize: totalAudioBytes || payloadSize,
+            size: parsed.size,
+            duration: parsed.duration,
+            audioDataSize: parsed.audioDataSize,
             frames
         };
-        if (sampleRate !== undefined) {
-            metadata.sampleRate = sampleRate;
+        if (parsed.sampleRate !== undefined) {
+            metadata.sampleRate = parsed.sampleRate;
         }
-        if (averageBitrate !== undefined) {
-            metadata.averageBitrate = averageBitrate;
+        if (parsed.averageBitrate !== undefined) {
+            metadata.averageBitrate = parsed.averageBitrate;
         }
-        if (offsets.id3v2Size > 0) {
-            metadata.id3v2Size = offsets.id3v2Size;
+        const id3v2Size = parsed.metadata?.['id3v2Size'];
+        if (typeof id3v2Size === 'number' && id3v2Size > 0) {
+            metadata.id3v2Size = id3v2Size;
         }
-        if (offsets.id3v1Size > 0) {
-            metadata.id3v1Size = offsets.id3v1Size;
+        const id3v1Size = parsed.metadata?.['id3v1Size'];
+        if (typeof id3v1Size === 'number' && id3v1Size > 0) {
+            metadata.id3v1Size = id3v1Size;
         }
-        if (warnings.length) {
-            metadata.warnings = warnings;
+        if (parsed.warnings?.length) {
+            metadata.warnings = parsed.warnings;
         }
         return metadata;
     }
@@ -156,144 +98,5 @@ export class FileLib {
     static analyzeAudioBuffer(buffer, opts = {}) {
         return this.analyzeMediaBuffer(buffer, opts);
     }
-    static calculateFrameLength(frame) {
-        if (frame.layer === 1) {
-            return Math.floor(((12 * frame.bitrate * 1000) / frame.sampleRate + frame.padding) * 4);
-        }
-        const multiplier = frame.layer === 3 && frame.version !== 1 ? 72 : 144;
-        return Math.floor((multiplier * frame.bitrate * 1000) / frame.sampleRate + frame.padding);
-    }
-    static getId3Offsets(buffer) {
-        let startOffset = 0;
-        let id3v2Size = 0;
-        if (buffer.length >= 10 && buffer.toString('ascii', 0, 3) === 'ID3') {
-            const sizeBytes = buffer.subarray(6, 10);
-            id3v2Size = this.syncSafeInteger(sizeBytes);
-            startOffset = Math.min(buffer.length, 10 + id3v2Size);
-        }
-        let id3v1Size = 0;
-        let audioEnd = buffer.length;
-        if (buffer.length >= 128) {
-            const tagOffset = buffer.length - 128;
-            if (buffer.toString('ascii', tagOffset, tagOffset + 3) === 'TAG') {
-                id3v1Size = 128;
-                audioEnd = tagOffset;
-            }
-        }
-        return {
-            startOffset,
-            id3v2Size,
-            audioEnd,
-            id3v1Size
-        };
-    }
-    static syncSafeInteger(bytes) {
-        return ((bytes[0] & 0x7f) << 21) |
-            ((bytes[1] & 0x7f) << 14) |
-            ((bytes[2] & 0x7f) << 7) |
-            (bytes[3] & 0x7f);
-    }
-    static isFrameSync(buffer, offset) {
-        const byte1 = buffer[offset];
-        const byte2 = buffer[offset + 1];
-        if (byte1 === undefined || byte2 === undefined) {
-            return false;
-        }
-        return byte1 === 0xff && (byte2 & 0xe0) === 0xe0;
-    }
-    static parseFrameHeader(header) {
-        const versionBits = (header >> 19) & 0x3;
-        const layerBits = (header >> 17) & 0x3;
-        const bitrateIndex = (header >> 12) & 0xf;
-        const sampleRateIndex = (header >> 10) & 0x3;
-        const padding = ((header >> 9) & 0x1);
-        const version = this.decodeVersion(versionBits);
-        const layer = this.decodeLayer(layerBits);
-        if (!version || !layer) {
-            return null;
-        }
-        if (bitrateIndex === 0 || bitrateIndex === 15 || sampleRateIndex === 3) {
-            return null;
-        }
-        const bitrate = this.BITRATE_INDEX[version][layer][bitrateIndex];
-        const sampleRate = this.SAMPLE_RATE_INDEX[version][sampleRateIndex];
-        if (!bitrate || !sampleRate) {
-            return null;
-        }
-        const samplesPerFrame = this.getSamplesPerFrame(version, layer);
-        return {
-            version,
-            layer,
-            bitrate,
-            sampleRate,
-            padding,
-            samplesPerFrame
-        };
-    }
-    static decodeVersion(bits) {
-        switch (bits) {
-            case 0b11:
-                return 1;
-            case 0b10:
-                return 2;
-            case 0b00:
-                return 25;
-            default:
-                return null;
-        }
-    }
-    static decodeLayer(bits) {
-        switch (bits) {
-            case 0b11:
-                return 1;
-            case 0b10:
-                return 2;
-            case 0b01:
-                return 3;
-            default:
-                return null;
-        }
-    }
-    static getSamplesPerFrame(version, layer) {
-        if (layer === 1) {
-            return 384;
-        }
-        if (layer === 2) {
-            return 1152;
-        }
-        return version === 1 ? 1152 : 576;
-    }
 }
-Object.defineProperty(FileLib, "BITRATE_INDEX", {
-    enumerable: true,
-    configurable: true,
-    writable: true,
-    value: {
-        1: {
-            1: [0, 32, 64, 96, 128, 160, 192, 224, 256, 288, 320, 352, 384, 416, 448],
-            2: [0, 32, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320, 384],
-            3: [0, 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320]
-        },
-        2: {
-            1: [0, 32, 48, 56, 64, 80, 96, 112, 128, 144, 160, 176, 192, 224, 256],
-            2: [0, 8, 16, 24, 32, 40, 48, 56, 64, 80, 96, 112, 128, 144, 160],
-            3: [0, 8, 16, 24, 32, 40, 48, 56, 64, 80, 96, 112, 128, 144, 160]
-        },
-        25: {
-            1: [0, 32, 48, 56, 64, 80, 96, 112, 128, 144, 160, 176, 192, 224, 256],
-            2: [0, 8, 16, 24, 32, 40, 48, 56, 64, 80, 96, 112, 128, 144, 160],
-            3: [0, 8, 16, 24, 32, 40, 48, 56, 64, 80, 96, 112, 128, 144, 160]
-        }
-    }
-});
-Object.defineProperty(FileLib, "SAMPLE_RATE_INDEX", {
-    enumerable: true,
-    configurable: true,
-    writable: true,
-    value: {
-        1: [44100, 48000, 32000],
-        2: [22050, 24000, 16000],
-        25: [11025, 12000, 8000]
-    }
-});
 //# sourceMappingURL=FileLib.js.map

package/dist/Libs/FileLib.js.map

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

package/dist/Parsers/Mp3Parser.d.ts

@@ -1,5 +1,6 @@
 import { IMediaParser, MediaFileInfo, MediaFormat } from './IMediaParser';
 export declare class Mp3Parser implements IMediaParser {
+    private static readonly MIN_CONSECUTIVE_AUDIO_FRAMES;
     private static readonly BITRATE_INDEX;
     private static readonly SAMPLE_RATE_INDEX;
     getFormat(): MediaFormat;
@@ -9,7 +10,14 @@ export declare class Mp3Parser implements IMediaParser {
     }): MediaFileInfo;
     private calculateFrameLength;
     private getId3Offsets;
+    private hasId3v2Magic;
+    private parseId3v2Tag;
     private syncSafeInteger;
+    private isSyncSafeInteger;
+    private findFirstFrameOffset;
+    private getFrameCandidate;
+    private countConsecutiveFrames;
+    private isCompatibleFrame;
     private isFrameSync;
     private parseFrameHeader;
     private decodeVersion;

package/dist/Parsers/Mp3Parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Mp3Parser.d.ts","sourceRoot":"","sources":["../../src/Parsers/Mp3Parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAkB,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAsB1F,qBAAa,SAAU,YAAW,YAAY;IAC5C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAgBnC;IAEF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAIvC;IAEF,SAAS,IAAI,WAAW;IAIxB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAsBjC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,aAAa;IAgJxE,OAAO,CAAC,oBAAoB;IAS5B,OAAO,CAAC,aAAa;IA8BrB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,gBAAgB;IAqCxB,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,kBAAkB;CAW3B"}
+{"version":3,"file":"Mp3Parser.d.ts","sourceRoot":"","sources":["../../src/Parsers/Mp3Parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAkB,WAAW,EAAE,MAAM,gBAAgB,CAAC;AA4B1F,qBAAa,SAAU,YAAW,YAAY;IAC5C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,4BAA4B,CAAK;IAEzD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAgBnC;IAEF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAIvC;IAEF,SAAS,IAAI,WAAW;IAIxB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAsBjC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,aAAa;IAwJxE,OAAO,CAAC,oBAAoB;IAS5B,OAAO,CAAC,aAAa;IAoDrB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,aAAa;IA+BrB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,oBAAoB;IAkC5B,OAAO,CAAC,iBAAiB;IAkBzB,OAAO,CAAC,sBAAsB;IA4B9B,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,gBAAgB;IAqCxB,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,kBAAkB;CAW3B"}

package/dist/Parsers/Mp3Parser.js

@@ -32,8 +32,13 @@ export class Mp3Parser {
         }
         const offsets = this.getId3Offsets(buffer);
         const frames = [];
-        const payloadSize = Math.max(0, offsets.audioEnd - offsets.startOffset);
-        let offset = offsets.startOffset;
+        const firstFrameOffset = this.findFirstFrameOffset(buffer, offsets.scanStartOffset, offsets.audioEnd);
+        const audioStartOffset = firstFrameOffset ?? offsets.startOffset;
+        const payloadSize = Math.max(0, offsets.audioEnd - audioStartOffset);
+        if (firstFrameOffset !== null && firstFrameOffset < offsets.startOffset) {
+            warnings.push(`ID3v2 tag size appears to overlap audio; using first verified MP3 frame at offset ${firstFrameOffset}`);
+        }
+        let offset = audioStartOffset;
         let frameIndex = 0;
         let sampleRate;
         let channels;
@@ -142,11 +147,27 @@ export class Mp3Parser {
     }
     getId3Offsets(buffer) {
         let startOffset = 0;
+        let scanStartOffset = 0;
         let id3v2Size = 0;
-        if (buffer.length >= 10 && buffer.toString('ascii', 0, 3) === 'ID3') {
-            const sizeBytes = buffer.subarray(6, 10);
-            id3v2Size = this.syncSafeInteger(sizeBytes);
-            startOffset = Math.min(buffer.length, 10 + id3v2Size);
+        if (this.hasId3v2Magic(buffer, 0)) {
+            scanStartOffset = Math.min(buffer.length, 10);
+            let offset = 0;
+            while (offset < buffer.length && this.hasId3v2Magic(buffer, offset)) {
+                const tag = this.parseId3v2Tag(buffer, offset);
+                if (!tag) {
+                    break;
+                }
+                id3v2Size += tag.payloadSize;
+                const nextOffset = Math.min(buffer.length, offset + tag.totalSize);
+                if (nextOffset <= offset) {
+                    break;
+                }
+                offset = nextOffset;
+                startOffset = offset;
+            }
+            if (startOffset === 0) {
+                startOffset = scanStartOffset;
+            }
         }
         let id3v1Size = 0;
         let audioEnd = buffer.length;
@@ -159,17 +180,113 @@ export class Mp3Parser {
         }
         return {
             startOffset,
+            scanStartOffset,
             id3v2Size,
             audioEnd,
             id3v1Size
         };
     }
+    hasId3v2Magic(buffer, offset) {
+        return offset + 10 <= buffer.length && buffer.toString('ascii', offset, offset + 3) === 'ID3';
+    }
+    parseId3v2Tag(buffer, offset) {
+        if (!this.hasId3v2Magic(buffer, offset)) {
+            return null;
+        }
+        const majorVersion = buffer[offset + 3];
+        const revision = buffer[offset + 4];
+        const flags = buffer[offset + 5];
+        const sizeBytes = buffer.subarray(offset + 6, offset + 10);
+        if (majorVersion === undefined ||
+            revision === undefined ||
+            flags === undefined ||
+            majorVersion < 2 ||
+            majorVersion > 4 ||
+            revision === 0xff ||
+            !this.isSyncSafeInteger(sizeBytes)) {
+            return null;
+        }
+        const payloadSize = this.syncSafeInteger(sizeBytes);
+        const footerSize = majorVersion === 4 && (flags & 0x10) !== 0 ? 10 : 0;
+        return {
+            payloadSize,
+            totalSize: 10 + payloadSize + footerSize
+        };
+    }
     syncSafeInteger(bytes) {
         return ((bytes[0] & 0x7f) << 21) |
             ((bytes[1] & 0x7f) << 14) |
             ((bytes[2] & 0x7f) << 7) |
             (bytes[3] & 0x7f);
     }
+    isSyncSafeInteger(bytes) {
+        return bytes.length === 4 && bytes.every((byte) => (byte & 0x80) === 0);
+    }
+    findFirstFrameOffset(buffer, startOffset, audioEnd) {
+        let offset = Math.max(0, Math.min(startOffset, audioEnd));
+        let fallbackOffset = null;
+        while (offset + 4 <= audioEnd) {
+            if (buffer[offset] !== 0xff) {
+                const next = buffer.indexOf(0xff, offset + 1);
+                if (next === -1 || next + 4 > audioEnd) {
+                    break;
+                }
+                offset = next;
+            }
+            const candidate = this.getFrameCandidate(buffer, offset, audioEnd);
+            if (!candidate) {
+                offset++;
+                continue;
+            }
+            fallbackOffset = fallbackOffset ?? offset;
+            if (this.countConsecutiveFrames(buffer, offset, audioEnd) >=
+                Mp3Parser.MIN_CONSECUTIVE_AUDIO_FRAMES) {
+                return offset;
+            }
+            offset++;
+        }
+        return fallbackOffset;
+    }
+    getFrameCandidate(buffer, offset, audioEnd) {
+        if (offset + 4 > audioEnd || !this.isFrameSync(buffer, offset)) {
+            return null;
+        }
+        const header = this.parseFrameHeader(buffer.readUInt32BE(offset));
+        if (!header) {
+            return null;
+        }
+        const length = this.calculateFrameLength(header);
+        if (length <= 0) {
+            return null;
+        }
+        return { header, length };
+    }
+    countConsecutiveFrames(buffer, offset, audioEnd) {
+        let count = 0;
+        let cursor = offset;
+        let firstHeader;
+        while (count < Mp3Parser.MIN_CONSECUTIVE_AUDIO_FRAMES) {
+            const candidate = this.getFrameCandidate(buffer, cursor, audioEnd);
+            if (!candidate) {
+                break;
+            }
+            if (firstHeader && !this.isCompatibleFrame(firstHeader, candidate.header)) {
+                break;
+            }
+            firstHeader = firstHeader ?? candidate.header;
+            count++;
+            if (cursor + candidate.length > audioEnd || cursor + candidate.length > buffer.length) {
+                break;
+            }
+            cursor += candidate.length;
+        }
+        return count;
+    }
+    isCompatibleFrame(first, next) {
+        return first.version === next.version &&
+            first.layer === next.layer &&
+            first.sampleRate === next.sampleRate;
+    }
     isFrameSync(buffer, offset) {
         const byte1 = buffer[offset];
         const byte2 = buffer[offset + 1];
@@ -241,6 +358,12 @@ export class Mp3Parser {
         return version === 1 ? 1152 : 576;
     }
 }
+Object.defineProperty(Mp3Parser, "MIN_CONSECUTIVE_AUDIO_FRAMES", {
+    enumerable: true,
+    configurable: true,
+    writable: true,
+    value: 3
+});
 Object.defineProperty(Mp3Parser, "BITRATE_INDEX", {
     enumerable: true,
     configurable: true,