audio-snip 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Stepan Mikhailiuk
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,68 @@
+# audio-snip
+
+Decode a segment of a remote audio file via HTTP Range requests — without downloading the whole thing.
+
+A 50 MB podcast, but you only need seconds 30–60? `audio-snip` fetches ~500 KB instead of 50 MB.
+
+## Demo
+
+[Live demo](https://stepancar.github.io/audio-snip/) — pick a test file, choose a time range, see exactly which byte ranges were fetched.
+
+## Before / After
+
+### Before — vanilla fetch + AudioContext
+
+You have to download the **entire file**, then decode, then slice:
+
+```ts
+const resp = await fetch(url);               // downloads all 50 MB
+const buf = await resp.arrayBuffer();
+const full = await audioCtx.decodeAudioData(buf);
+
+// manual trimming
+const start = Math.round(30 * full.sampleRate);
+const end = Math.round(60 * full.sampleRate);
+const trimmed = audioCtx.createBuffer(full.numberOfChannels, end - start, full.sampleRate);
+for (let ch = 0; ch < full.numberOfChannels; ch++) {
+  trimmed.copyToChannel(full.getChannelData(ch).subarray(start, end), ch);
+}
+```
+
+### After — audio-snip
+
+```ts
+import { audioSnip } from 'audio-snip';
+import { Mp3Plugin } from 'audio-snip/mp3';
+import { Mp4Plugin } from 'audio-snip/mp4';
+
+audioSnip.register(new Mp3Plugin());
+audioSnip.register(new Mp4Plugin());
+
+const buffer = await audioSnip.decodeAudioDataSegment(audioCtx, url, 30, 60);
+// AudioBuffer with exactly 30 seconds of audio
+// only a few hundred KB were fetched
+```
+
+## How it works
+
+1. Fetch file header (first ~128 KB) to parse codec metadata
+2. Use metadata (Xing TOC for MP3, stbl tables for MP4) to map time → byte offset
+3. Fetch only the needed byte range via HTTP `Range` request
+4. Decode and trim to exact sample boundaries
+
+## Supported formats
+
+| Format | Plugin | Notes |
+|--------|--------|-------|
+| MP3 CBR/VBR | `Mp3Plugin` | Xing/VBRI TOC, LAME gapless, ID3v2 |
+| M4A/MP4/AAC | `Mp4Plugin` | Uses mp4box.js, ADTS wrapping, video+audio files |
+
+## Install
+
+```sh
+npm install audio-snip
+```
+
+## License
+
+MIT

package/dist/core.d.ts

@@ -0,0 +1,25 @@
+export interface AudioFileInfo {
+    duration: number | null;
+    sampleRate: number;
+    channels: number;
+    bitrate: number;
+    codec: string;
+    isVbr: boolean;
+    encoderDelay: number;
+}
+export declare abstract class BasePlugin {
+    abstract canHandle(url: string): boolean;
+    abstract getInfo(url: string): Promise<AudioFileInfo>;
+    abstract decode(ctx: BaseAudioContext, url: string, startTime: number, endTime: number): Promise<AudioBuffer>;
+}
+export declare function fetchRange(url: string, start: number, end: number): Promise<Uint8Array>;
+export declare function fetchContentLength(url: string): Promise<number | null>;
+export declare function trimBySamples(ctx: BaseAudioContext, buffer: AudioBuffer, startSample: number, endSample: number): AudioBuffer;
+declare class AudioSnip {
+    private plugins;
+    register(plugin: BasePlugin): void;
+    private resolve;
+    decodeAudioDataSegment(ctx: BaseAudioContext, url: string, startTime: number, endTime: number): Promise<AudioBuffer>;
+}
+export declare const audioSnip: AudioSnip;
+export {};

package/dist/core.js

@@ -0,0 +1,73 @@
+// ─── Types ───────────────────────────────────────────────────────────────────
+export class BasePlugin {
+}
+// ─── Shared utilities ────────────────────────────────────────────────────────
+export async function fetchRange(url, start, end) {
+    const resp = await fetch(url, {
+        headers: { Range: `bytes=${start}-${end}` },
+    });
+    if (!resp.ok && resp.status !== 206) {
+        throw new Error(`HTTP ${resp.status} fetching range ${start}-${end}`);
+    }
+    const full = new Uint8Array(await resp.arrayBuffer());
+    // If server ignored Range header and returned full file (200 instead of 206),
+    // slice to the requested range manually.
+    if (resp.status === 200 && full.length > end - start + 1) {
+        return full.slice(start, end + 1);
+    }
+    return full;
+}
+export async function fetchContentLength(url) {
+    // Try HEAD first
+    const headResp = await fetch(url, { method: 'HEAD' });
+    const cl = headResp.headers.get('content-length');
+    if (cl)
+        return parseInt(cl, 10);
+    // Fallback: GET with Range 0-0 and parse Content-Range
+    const rangeResp = await fetch(url, {
+        headers: { Range: 'bytes=0-0' },
+    });
+    const cr = rangeResp.headers.get('content-range');
+    if (cr) {
+        const match = cr.match(/\/(\d+)/);
+        if (match)
+            return parseInt(match[1], 10);
+    }
+    return null;
+}
+export function trimBySamples(ctx, buffer, startSample, endSample) {
+    const start = Math.max(0, Math.round(startSample));
+    const end = Math.min(buffer.length, Math.round(endSample));
+    const length = end - start;
+    if (length <= 0) {
+        throw new Error(`Invalid trim range: startSample=${startSample}, endSample=${endSample}, bufferLength=${buffer.length}`);
+    }
+    const trimmed = ctx.createBuffer(buffer.numberOfChannels, length, buffer.sampleRate);
+    for (let ch = 0; ch < buffer.numberOfChannels; ch++) {
+        const src = buffer.getChannelData(ch);
+        trimmed.copyToChannel(src.subarray(start, end), ch);
+    }
+    return trimmed;
+}
+// ─── Plugin registry / singleton ─────────────────────────────────────────────
+class AudioSnip {
+    constructor() {
+        this.plugins = [];
+    }
+    register(plugin) {
+        this.plugins.push(plugin);
+    }
+    resolve(url) {
+        for (const p of this.plugins) {
+            if (p.canHandle(url))
+                return p;
+        }
+        throw new Error(`No plugin registered for URL: ${url}`);
+    }
+    async decodeAudioDataSegment(ctx, url, startTime, endTime) {
+        const plugin = this.resolve(url);
+        return plugin.decode(ctx, url, startTime, endTime);
+    }
+}
+export const audioSnip = new AudioSnip();
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { audioSnip, BasePlugin, fetchRange, fetchContentLength, trimBySamples, } from './core.js';
+export type { AudioFileInfo } from './core.js';

package/dist/index.js

@@ -0,0 +1,2 @@
+export { audioSnip, BasePlugin, fetchRange, fetchContentLength, trimBySamples, } from './core.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,aAAa,GACd,MAAM,WAAW,CAAC"}

package/dist/plugins/mp3.d.ts

@@ -0,0 +1,13 @@
+import { BasePlugin, AudioFileInfo } from '../core.js';
+export interface Mp3PluginOptions {
+    paddingFrames?: number;
+}
+export declare class Mp3Plugin extends BasePlugin {
+    private paddingFrames;
+    constructor(options?: Mp3PluginOptions);
+    canHandle(url: string): boolean;
+    getInfo(url: string): Promise<AudioFileInfo>;
+    decode(ctx: BaseAudioContext, url: string, startTime: number, endTime: number): Promise<AudioBuffer>;
+    private fetchHeader;
+    private computeDuration;
+}

package/dist/plugins/mp3.js

@@ -0,0 +1,366 @@
+import { BasePlugin, fetchRange, fetchContentLength, trimBySamples, } from '../core.js';
+// ─── Constants ───────────────────────────────────────────────────────────────
+const HEAD_SIZE = 128 * 1024; // 128 KB initial fetch
+// MPEG bitrate tables [version][layer][index]
+const BITRATE_TABLE = {
+    'V1L1': [0, 32, 64, 96, 128, 160, 192, 224, 256, 288, 320, 352, 384, 416, 448, 0],
+    'V1L2': [0, 32, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320, 384, 0],
+    'V1L3': [0, 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320, 0],
+    'V2L1': [0, 32, 48, 56, 64, 80, 96, 112, 128, 144, 160, 176, 192, 224, 256, 0],
+    'V2L2': [0, 8, 16, 24, 32, 40, 48, 56, 64, 80, 96, 112, 128, 144, 160, 0],
+    'V2L3': [0, 8, 16, 24, 32, 40, 48, 56, 64, 80, 96, 112, 128, 144, 160, 0],
+};
+const SAMPLE_RATE_TABLE = [
+    [44100, 48000, 32000, 0], // MPEG1
+    [22050, 24000, 16000, 0], // MPEG2
+    [11025, 12000, 8000, 0], // MPEG2.5
+];
+const SAMPLES_PER_FRAME = {
+    'V1L1': 384,
+    'V1L2': 1152,
+    'V1L3': 1152,
+    'V2L1': 384,
+    'V2L2': 1152,
+    'V2L3': 576,
+};
+function parseFrameHeader(data, offset) {
+    if (offset + 4 > data.length)
+        return null;
+    const b0 = data[offset];
+    const b1 = data[offset + 1];
+    const b2 = data[offset + 2];
+    const b3 = data[offset + 3];
+    // Sync: 11 bits set
+    if (b0 !== 0xFF || (b1 & 0xE0) !== 0xE0)
+        return null;
+    const versionBits = (b1 >> 3) & 0x03;
+    const layerBits = (b1 >> 1) & 0x03;
+    const bitrateIdx = (b2 >> 4) & 0x0F;
+    const srIdx = (b2 >> 2) & 0x03;
+    const padding = ((b2 >> 1) & 0x01) === 1;
+    const channelMode = (b3 >> 6) & 0x03;
+    // Reject reserved values
+    if (versionBits === 1 || layerBits === 0 || bitrateIdx === 0 || bitrateIdx === 15 || srIdx === 3) {
+        return null;
+    }
+    const mpegVersion = versionBits === 3 ? 1 : versionBits === 2 ? 2 : 2.5;
+    const layer = layerBits === 3 ? 1 : layerBits === 2 ? 2 : 3;
+    const vKey = mpegVersion === 1 ? 'V1' : 'V2';
+    const lKey = `L${layer}`;
+    const key = `${vKey}${lKey}`;
+    const bitrate = BITRATE_TABLE[key]?.[bitrateIdx];
+    if (!bitrate)
+        return null;
+    const srTableIdx = mpegVersion === 1 ? 0 : mpegVersion === 2 ? 1 : 2;
+    const sampleRate = SAMPLE_RATE_TABLE[srTableIdx][srIdx];
+    if (!sampleRate)
+        return null;
+    const samplesPerFrame = SAMPLES_PER_FRAME[key];
+    const channels = channelMode === 3 ? 1 : 2;
+    let frameSize;
+    if (layer === 1) {
+        frameSize = Math.floor((12 * bitrate * 1000) / sampleRate + (padding ? 1 : 0)) * 4;
+    }
+    else {
+        const slotSize = 1;
+        const divisor = mpegVersion === 1 ? sampleRate : sampleRate * 2;
+        frameSize = Math.floor((samplesPerFrame * bitrate * 1000) / (8 * divisor)) * 8 / 8 + (padding ? slotSize : 0);
+        // Simplified: frameSize = floor(samplesPerFrame/8 * bitrate*1000 / sampleRate) + padding
+        frameSize = Math.floor((samplesPerFrame * (bitrate * 1000) / 8) / sampleRate) + (padding ? slotSize : 0);
+    }
+    // Side information size for Layer 3
+    let sideInfoSize = 0;
+    if (layer === 3) {
+        if (mpegVersion === 1) {
+            sideInfoSize = channels === 1 ? 17 : 32;
+        }
+        else {
+            sideInfoSize = channels === 1 ? 9 : 17;
+        }
+    }
+    return {
+        mpegVersion,
+        layer,
+        bitrate,
+        sampleRate,
+        channels,
+        padding,
+        samplesPerFrame,
+        frameSize,
+        sideInfoSize,
+    };
+}
+// ─── ID3v2 tag size ──────────────────────────────────────────────────────────
+function id3v2Size(data) {
+    if (data.length < 10)
+        return 0;
+    if (data[0] !== 0x49 || data[1] !== 0x44 || data[2] !== 0x33)
+        return 0; // "ID3"
+    // Syncsafe integer at bytes 6-9
+    const size = ((data[6] & 0x7F) << 21) |
+        ((data[7] & 0x7F) << 14) |
+        ((data[8] & 0x7F) << 7) |
+        (data[9] & 0x7F);
+    return size + 10; // 10-byte header not included in size field
+}
+// ─── Find first frame sync after given offset ───────────────────────────────
+function findFrameSync(data, start) {
+    for (let i = start; i < data.length - 4; i++) {
+        if (data[i] === 0xFF && (data[i + 1] & 0xE0) === 0xE0) {
+            const hdr = parseFrameHeader(data, i);
+            if (hdr && hdr.frameSize > 0) {
+                // Validate next frame exists
+                const next = i + hdr.frameSize;
+                if (next + 2 <= data.length) {
+                    if (data[next] === 0xFF && (data[next + 1] & 0xE0) === 0xE0) {
+                        return i;
+                    }
+                }
+                else {
+                    // Near end of data, trust single sync
+                    return i;
+                }
+            }
+        }
+    }
+    return -1;
+}
+function parseXingVbri(data, frameOffset, header) {
+    // Xing/Info header is after frame header (4 bytes) + side info
+    const xingOffset = frameOffset + 4 + header.sideInfoSize;
+    if (xingOffset + 4 > data.length)
+        return null;
+    const tag = String.fromCharCode(data[xingOffset], data[xingOffset + 1], data[xingOffset + 2], data[xingOffset + 3]);
+    if (tag === 'Xing' || tag === 'Info') {
+        const flags = readU32BE(data, xingOffset + 4);
+        let pos = xingOffset + 8;
+        let totalFrames = null;
+        let totalBytes = null;
+        let toc = null;
+        if (flags & 1) {
+            totalFrames = readU32BE(data, pos);
+            pos += 4;
+        }
+        if (flags & 2) {
+            totalBytes = readU32BE(data, pos);
+            pos += 4;
+        }
+        if (flags & 4) {
+            toc = data.slice(pos, pos + 100);
+            pos += 100;
+        }
+        // flags & 8 → quality indicator, skip
+        if (flags & 8) {
+            pos += 4;
+        }
+        // LAME gapless info at xingOffset + 141 (relative to Xing tag start)
+        // The LAME header starts 120 bytes after the Xing tag position
+        let encoderDelay = 0;
+        let encoderPadding = 0;
+        const lameOffset = xingOffset + 120 + 21; // LAME encoder delays are at Xing+141
+        if (lameOffset + 3 <= data.length) {
+            // Verify LAME tag exists (9 char encoder string at xingOffset+120)
+            const lameTag = String.fromCharCode(data[xingOffset + 120], data[xingOffset + 121], data[xingOffset + 122], data[xingOffset + 123]);
+            if (lameTag === 'LAME' || lameTag === 'Lavf' || lameTag === 'Lavc') {
+                // Encoder delay: 12 bits at byte 141, encoder padding: 12 bits at byte 142-143
+                const delayByte1 = data[xingOffset + 141];
+                const delayByte2 = data[xingOffset + 142];
+                const delayByte3 = data[xingOffset + 143];
+                encoderDelay = (delayByte1 << 4) | (delayByte2 >> 4);
+                encoderPadding = ((delayByte2 & 0x0F) << 8) | delayByte3;
+            }
+        }
+        return {
+            isVbr: tag === 'Xing',
+            totalFrames,
+            totalBytes,
+            toc,
+            encoderDelay,
+            encoderPadding,
+        };
+    }
+    // Try VBRI (Fraunhofer) — always at offset 36 from frame start
+    const vbriOffset = frameOffset + 36;
+    if (vbriOffset + 4 <= data.length) {
+        const vbriTag = String.fromCharCode(data[vbriOffset], data[vbriOffset + 1], data[vbriOffset + 2], data[vbriOffset + 3]);
+        if (vbriTag === 'VBRI') {
+            const totalBytes = readU32BE(data, vbriOffset + 10);
+            const totalFrames = readU32BE(data, vbriOffset + 14);
+            return {
+                isVbr: true,
+                totalFrames,
+                totalBytes,
+                toc: null,
+                encoderDelay: 0,
+                encoderPadding: 0,
+            };
+        }
+    }
+    return null;
+}
+function readU32BE(data, offset) {
+    return (((data[offset] << 24) >>> 0) +
+        (data[offset + 1] << 16) +
+        (data[offset + 2] << 8) +
+        data[offset + 3]);
+}
+// ─── TOC-based byte interpolation for VBR ────────────────────────────────────
+function tocInterpolate(toc, fraction, totalBytes) {
+    // fraction is 0..1 representing position in file
+    const scaledPos = fraction * 100;
+    const idx = Math.min(99, Math.floor(scaledPos));
+    const idxFrac = scaledPos - idx;
+    const lower = toc[idx];
+    const upper = idx < 99 ? toc[idx + 1] : 256;
+    const interpolated = lower + idxFrac * (upper - lower);
+    return Math.floor((interpolated / 256) * totalBytes);
+}
+export class Mp3Plugin extends BasePlugin {
+    constructor(options = {}) {
+        super();
+        this.paddingFrames = options.paddingFrames ?? 8;
+    }
+    canHandle(url) {
+        try {
+            const path = new URL(url, 'https://dummy').pathname.toLowerCase();
+            return path.endsWith('.mp3');
+        }
+        catch {
+            return url.toLowerCase().endsWith('.mp3');
+        }
+    }
+    async getInfo(url) {
+        const { header, vbrInfo, fileSize, audioStart } = await this.fetchHeader(url);
+        const duration = this.computeDuration(header, vbrInfo, fileSize, audioStart);
+        return {
+            duration,
+            sampleRate: header.sampleRate,
+            channels: header.channels,
+            bitrate: header.bitrate,
+            codec: `MPEG${header.mpegVersion} Layer ${header.layer}`,
+            isVbr: vbrInfo?.isVbr ?? false,
+            encoderDelay: vbrInfo?.encoderDelay ?? 0,
+        };
+    }
+    async decode(ctx, url, startTime, endTime) {
+        const { header, vbrInfo, audioStart, fileSize } = await this.fetchHeader(url);
+        const sampleRate = header.sampleRate;
+        const encoderDelay = vbrInfo?.encoderDelay ?? 0;
+        const encoderPadding = vbrInfo?.encoderPadding ?? 0;
+        const isVbr = vbrInfo?.isVbr ?? false;
+        const duration = this.computeDuration(header, vbrInfo, fileSize, audioStart);
+        // Compute byte range for the requested time segment
+        let startByte;
+        let endByte;
+        // For VBR+TOC, map time to byte position via TOC
+        if (isVbr && vbrInfo?.toc && vbrInfo.totalBytes && duration) {
+            const startFrac = Math.max(0, startTime / duration);
+            const endFrac = Math.min(1, endTime / duration);
+            startByte = audioStart + tocInterpolate(vbrInfo.toc, startFrac, vbrInfo.totalBytes);
+            endByte = audioStart + tocInterpolate(vbrInfo.toc, endFrac, vbrInfo.totalBytes);
+        }
+        else {
+            // CBR or VBR-without-TOC fallback: linear byte estimate
+            if (isVbr && (!vbrInfo?.toc)) {
+                console.warn('audio-snip: VBR file without TOC, using CBR byte estimate for Range request');
+            }
+            const bytesPerSecond = (header.bitrate * 1000) / 8;
+            startByte = audioStart + Math.floor(startTime * bytesPerSecond);
+            endByte = audioStart + Math.ceil(endTime * bytesPerSecond);
+        }
+        // Snap to frame boundaries and add padding
+        const paddingBytes = this.paddingFrames * header.frameSize;
+        const fetchStart = Math.max(audioStart, startByte - paddingBytes);
+        // Add extra frames at end for safety
+        const fetchEnd = Math.min((fileSize ?? endByte + paddingBytes * 2) - 1, endByte + paddingBytes * 2);
+        // Fetch the segment
+        const chunk = await fetchRange(url, fetchStart, fetchEnd);
+        // Find first valid frame in fetched chunk
+        const firstSync = findFrameSync(chunk, 0);
+        if (firstSync === -1) {
+            throw new Error('No valid MP3 frame found in fetched range');
+        }
+        // Walk frames to count samples up to the actual startByte offset
+        // This gives us exact sample count for trimming, even for VBR
+        const offsetInChunk = startByte - fetchStart;
+        let samplesBefore = 0;
+        let pos = firstSync;
+        while (pos < chunk.length - 4) {
+            const fh = parseFrameHeader(chunk, pos);
+            if (!fh || fh.frameSize <= 0)
+                break;
+            if (pos >= offsetInChunk)
+                break;
+            samplesBefore += fh.samplesPerFrame;
+            pos += fh.frameSize;
+        }
+        // Decode the entire fetched chunk
+        const audioData = new Uint8Array(chunk.subarray(firstSync)).buffer;
+        const decoded = await ctx.decodeAudioData(audioData.slice(0));
+        // Use decoded buffer's sampleRate — AudioContext may resample (e.g. 44100→48000)
+        const decodedRate = decoded.sampleRate;
+        const resampleRatio = decodedRate / sampleRate;
+        // Scale samplesBefore and encoderDelay to decoded rate
+        const trimStartSamples = Math.round((samplesBefore - encoderDelay) * resampleRatio);
+        const wantedSamples = Math.round((endTime - startTime) * decodedRate);
+        const startSample = Math.max(0, trimStartSamples);
+        let endSample = startSample + wantedSamples;
+        // If endTime >= duration, also trim encoder padding from end
+        if (duration && endTime >= duration - 0.01 && encoderPadding > 0) {
+            const scaledPadding = Math.round(encoderPadding * resampleRatio);
+            endSample = Math.min(endSample, decoded.length - scaledPadding);
+        }
+        endSample = Math.min(endSample, decoded.length);
+        return trimBySamples(ctx, decoded, startSample, endSample);
+    }
+    // ─── Internal helpers ────────────────────────────────────────────────────
+    async fetchHeader(url) {
+        const fileSize = await fetchContentLength(url);
+        // First pass: fetch initial chunk
+        let headData = await fetchRange(url, 0, HEAD_SIZE - 1);
+        // Check for ID3v2 tag
+        let audioStart = 0;
+        const id3Size = id3v2Size(headData);
+        if (id3Size > 0) {
+            audioStart = id3Size;
+            // If ID3 tag is larger than our initial fetch, re-fetch from after it
+            if (id3Size >= HEAD_SIZE) {
+                headData = await fetchRange(url, id3Size, id3Size + HEAD_SIZE - 1);
+                audioStart = id3Size;
+            }
+        }
+        // Find first frame sync
+        const searchStart = id3Size >= HEAD_SIZE ? 0 : audioStart;
+        const syncOffset = findFrameSync(headData, searchStart);
+        if (syncOffset === -1) {
+            throw new Error('No valid MP3 frame sync found');
+        }
+        const header = parseFrameHeader(headData, syncOffset);
+        const absoluteFrameOffset = id3Size >= HEAD_SIZE ? id3Size + syncOffset : syncOffset;
+        // Parse Xing/VBRI
+        const vbrInfo = parseXingVbri(headData, syncOffset, header);
+        // If there's a Xing/Info frame, the actual audio starts after it
+        const firstFrameOffset = vbrInfo
+            ? absoluteFrameOffset + header.frameSize
+            : absoluteFrameOffset;
+        return {
+            header,
+            vbrInfo,
+            audioStart: firstFrameOffset,
+            firstFrameOffset,
+            fileSize,
+        };
+    }
+    computeDuration(header, vbrInfo, fileSize, audioStart) {
+        if (vbrInfo?.totalFrames) {
+            const totalSamples = vbrInfo.totalFrames * header.samplesPerFrame;
+            return totalSamples / header.sampleRate;
+        }
+        if (fileSize) {
+            const audioBytes = fileSize - audioStart;
+            return audioBytes / ((header.bitrate * 1000) / 8);
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=mp3.js.map

package/dist/plugins/mp3.js.map

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

package/dist/plugins/mp4.d.ts

@@ -0,0 +1,18 @@
+import { BasePlugin, AudioFileInfo } from '../core.js';
+export declare class Mp4Plugin extends BasePlugin {
+    canHandle(url: string): boolean;
+    getInfo(url: string): Promise<AudioFileInfo>;
+    decode(ctx: BaseAudioContext, url: string, startTime: number, endTime: number): Promise<AudioBuffer>;
+    /**
+     * Read sample data from pre-fetched byte ranges.
+     */
+    private readSampleFromRanges;
+    /**
+     * Collapse sample byte ranges into minimal contiguous fetch ranges.
+     * Adjacent or overlapping ranges are merged to reduce HTTP requests.
+     */
+    private collapseRanges;
+    private loadMoov;
+    private loadMoovForDecode;
+    private streamToMP4Box;
+}

package/dist/plugins/mp4.js

@@ -0,0 +1,232 @@
+import { BasePlugin, fetchRange, fetchContentLength, trimBySamples, } from '../core.js';
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+import MP4BoxFactory from 'mp4box';
+const MP4BoxLib = MP4BoxFactory;
+// ─── ADTS header construction ────────────────────────────────────────────────
+function makeAdtsHeader(frameLength, audioObjectType, samplingFrequencyIndex, channelConfiguration) {
+    const header = new Uint8Array(7);
+    const fullLength = frameLength + 7;
+    // Syncword (12 bits), ID (1 bit = 0 for MPEG-4), Layer (2 bits = 00), Protection absent (1 bit = 1)
+    header[0] = 0xFF;
+    header[1] = 0xF1;
+    // Profile (2 bits, audioObjectType - 1), Sampling freq idx (4 bits), Private (1 bit = 0), Channel config high (1 bit)
+    header[2] =
+        ((audioObjectType - 1) << 6) |
+            (samplingFrequencyIndex << 2) |
+            (0 << 1) |
+            ((channelConfiguration >> 2) & 0x01);
+    // Channel config low (2 bits), Original (1 bit = 0), Home (1 bit = 0), copyright_id (1 bit = 0), copyright_start (1 bit = 0), frame length high (2 bits)
+    header[3] =
+        ((channelConfiguration & 0x03) << 6) |
+            ((fullLength >> 11) & 0x03);
+    // frame length mid (8 bits)
+    header[4] = (fullLength >> 3) & 0xFF;
+    // frame length low (3 bits), buffer fullness high (5 bits = 0x1F)
+    header[5] = ((fullLength & 0x07) << 5) | 0x1F;
+    // buffer fullness low (6 bits = 0x3F), number of AAC frames - 1 (2 bits = 0)
+    header[6] = 0xFC;
+    return header;
+}
+// Sampling frequency index table
+const SAMPLING_FREQ_TABLE = [
+    96000, 88200, 64000, 48000, 44100, 32000,
+    24000, 22050, 16000, 12000, 11025, 8000, 7350,
+];
+function getSamplingFrequencyIndex(sampleRate) {
+    const idx = SAMPLING_FREQ_TABLE.indexOf(sampleRate);
+    return idx >= 0 ? idx : 4; // default to 44100
+}
+// ─── Mp4Plugin ───────────────────────────────────────────────────────────────
+export class Mp4Plugin extends BasePlugin {
+    canHandle(url) {
+        try {
+            const path = new URL(url, 'https://dummy').pathname.toLowerCase();
+            return (path.endsWith('.m4a') ||
+                path.endsWith('.mp4') ||
+                path.endsWith('.aac') ||
+                path.endsWith('.m4b'));
+        }
+        catch {
+            const lower = url.toLowerCase();
+            return lower.endsWith('.m4a') || lower.endsWith('.mp4') || lower.endsWith('.aac') || lower.endsWith('.m4b');
+        }
+    }
+    async getInfo(url) {
+        const { info, audioTrack } = await this.loadMoov(url);
+        const duration = info.duration / info.timescale;
+        return {
+            duration,
+            sampleRate: audioTrack.audio.sample_rate,
+            channels: audioTrack.audio.channel_count,
+            bitrate: audioTrack.bitrate,
+            codec: audioTrack.codec,
+            isVbr: true, // AAC is always VBR conceptually
+            encoderDelay: 0,
+        };
+    }
+    async decode(ctx, url, startTime, endTime) {
+        // Step 1: Load moov atom only (a few MB) to get metadata + sample table
+        const { audioTrack, mp4 } = await this.loadMoovForDecode(url);
+        const sampleRate = audioTrack.audio.sample_rate;
+        const timescale = audioTrack.timescale;
+        // Step 2: Use sample table to find which samples fall in [startTime, endTime]
+        const allSamples = mp4.getTrackSamplesInfo(audioTrack.id);
+        if (allSamples.length === 0) {
+            throw new Error('No audio samples in track');
+        }
+        const startTS = startTime * timescale;
+        const endTS = endTime * timescale;
+        let firstIdx = 0;
+        let lastIdx = allSamples.length - 1;
+        for (let i = 0; i < allSamples.length; i++) {
+            if (allSamples[i].cts + allSamples[i].duration > startTS) {
+                firstIdx = Math.max(0, i - 1); // one extra for decoder priming
+                break;
+            }
+        }
+        for (let i = allSamples.length - 1; i >= 0; i--) {
+            if (allSamples[i].cts < endTS) {
+                lastIdx = Math.min(allSamples.length - 1, i + 1); // one extra at end
+                break;
+            }
+        }
+        const neededSamples = allSamples.slice(firstIdx, lastIdx + 1);
+        // Step 3: Compute minimal byte ranges from sample offsets
+        // Collapse contiguous/overlapping samples into merged ranges
+        const ranges = this.collapseRanges(neededSamples);
+        // Step 4: Fetch only the byte ranges containing needed samples
+        // We read sample data directly from the fetched bytes — no onSamples needed.
+        const rangeData = new Map(); // range.start → data
+        for (const range of ranges) {
+            const data = await fetchRange(url, range.start, range.end);
+            rangeData.set(range.start, data);
+        }
+        // Step 5: Extract raw AAC frame data for each needed sample
+        // by reading directly from fetched ranges using sample offset/size
+        const firstSampleInfo = neededSamples[0];
+        const aacConfig = firstSampleInfo.description?.aacDecoderConfigDescriptor;
+        const audioObjectType = aacConfig?.audioObjectType ?? 2;
+        const samplingFreqIndex = aacConfig?.samplingFrequencyIndex ?? getSamplingFrequencyIndex(sampleRate);
+        const channelConfig = aacConfig?.channelConfiguration ?? audioTrack.audio.channel_count;
+        const adtsChunks = [];
+        for (const si of neededSamples) {
+            // Find which fetched range contains this sample
+            const rawData = this.readSampleFromRanges(si.offset, si.size, ranges, rangeData);
+            if (!rawData)
+                continue; // skip if data not available (shouldn't happen)
+            const adtsHeader = makeAdtsHeader(rawData.length, audioObjectType, samplingFreqIndex, channelConfig);
+            const frame = new Uint8Array(adtsHeader.length + rawData.length);
+            frame.set(adtsHeader, 0);
+            frame.set(rawData, adtsHeader.length);
+            adtsChunks.push(frame);
+        }
+        if (adtsChunks.length === 0) {
+            throw new Error('No audio samples could be read from fetched ranges');
+        }
+        const totalLen = adtsChunks.reduce((acc, c) => acc + c.length, 0);
+        const adtsStream = new Uint8Array(totalLen);
+        let offset = 0;
+        for (const chunk of adtsChunks) {
+            adtsStream.set(chunk, offset);
+            offset += chunk.length;
+        }
+        // Step 6: Decode and trim
+        const decoded = await ctx.decodeAudioData(adtsStream.buffer.slice(0));
+        const decodedRate = decoded.sampleRate;
+        const rangeStartTime = neededSamples[0].cts / timescale;
+        const trimStartSeconds = startTime - rangeStartTime;
+        const trimStartSamples = Math.round(trimStartSeconds * decodedRate);
+        const wantedSamples = Math.round((endTime - startTime) * decodedRate);
+        const startSample = Math.max(0, trimStartSamples);
+        const endSample = Math.min(decoded.length, startSample + wantedSamples);
+        return trimBySamples(ctx, decoded, startSample, endSample);
+    }
+    /**
+     * Read sample data from pre-fetched byte ranges.
+     */
+    readSampleFromRanges(sampleOffset, sampleSize, ranges, rangeData) {
+        for (const range of ranges) {
+            if (sampleOffset >= range.start && sampleOffset + sampleSize - 1 <= range.end) {
+                const data = rangeData.get(range.start);
+                if (!data)
+                    return null;
+                const localOffset = sampleOffset - range.start;
+                return data.subarray(localOffset, localOffset + sampleSize);
+            }
+        }
+        return null;
+    }
+    /**
+     * Collapse sample byte ranges into minimal contiguous fetch ranges.
+     * Adjacent or overlapping ranges are merged to reduce HTTP requests.
+     */
+    collapseRanges(samples) {
+        if (samples.length === 0)
+            return [];
+        const sorted = [...samples].sort((a, b) => a.offset - b.offset);
+        const ranges = [];
+        let cur = { start: sorted[0].offset, end: sorted[0].offset + sorted[0].size - 1 };
+        for (let i = 1; i < sorted.length; i++) {
+            const sampleStart = sorted[i].offset;
+            const sampleEnd = sampleStart + sorted[i].size - 1;
+            // Merge if gap is < 64KB (cheaper to over-fetch than make another request)
+            if (sampleStart <= cur.end + 65536) {
+                cur.end = Math.max(cur.end, sampleEnd);
+            }
+            else {
+                ranges.push(cur);
+                cur = { start: sampleStart, end: sampleEnd };
+            }
+        }
+        ranges.push(cur);
+        return ranges;
+    }
+    // ─── Internal helpers ────────────────────────────────────────────────────
+    async loadMoov(url) {
+        const { info, audioTrack } = await this.loadMoovForDecode(url);
+        return { info, audioTrack };
+    }
+    async loadMoovForDecode(url) {
+        const MP4Box = MP4BoxLib;
+        const mp4 = MP4Box.createFile();
+        const fileSize = await fetchContentLength(url);
+        const info = await new Promise((resolve, reject) => {
+            mp4.onReady = resolve;
+            mp4.onError = reject;
+            this.streamToMP4Box(mp4, url, fileSize).catch(reject);
+        });
+        const audioTrack = info.tracks.find((t) => t.type === 'audio');
+        if (!audioTrack)
+            throw new Error('No audio track found in MP4');
+        return { info, audioTrack, mp4 };
+    }
+    async streamToMP4Box(mp4, url, fileSize) {
+        const chunkSize = 256 * 1024;
+        const totalSize = fileSize ?? 10 * 1024 * 1024; // fallback 10MB
+        let offset = 0;
+        while (offset < totalSize) {
+            const end = Math.min(offset + chunkSize - 1, totalSize - 1);
+            const data = await fetchRange(url, offset, end);
+            const ab = data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength);
+            ab.fileStart = offset;
+            mp4.appendBuffer(ab);
+            offset = end + 1;
+            // Check if we have enough info - mp4box will call onReady
+            // For large files, we may need to stop early once we have what we need
+            if (offset > 2 * 1024 * 1024 && offset < totalSize - chunkSize) {
+                // For the moov-at-end case, try the tail
+                break;
+            }
+        }
+        // If moov is at the end, fetch the tail
+        if (fileSize && offset < fileSize) {
+            const tailStart = Math.max(offset, fileSize - 2 * 1024 * 1024);
+            const tailData = await fetchRange(url, tailStart, fileSize - 1);
+            const ab = tailData.buffer.slice(tailData.byteOffset, tailData.byteOffset + tailData.byteLength);
+            ab.fileStart = tailStart;
+            mp4.appendBuffer(ab);
+        }
+        mp4.flush();
+    }
+}
+//# sourceMappingURL=mp4.js.map

package/dist/plugins/mp4.js.map

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

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "audio-snip",
+  "version": "0.1.0",
+  "description": "Decode audio segments from remote files via HTTP Range requests",
+  "license": "MIT",
+  "author": "Stepan Mikhailiuk",
+  "repository": "stepancar/audio-snip",
+  "type": "module",
+  "files": ["dist", "LICENSE", "README.md"],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./mp3": {
+      "import": "./dist/plugins/mp3.js",
+      "types": "./dist/plugins/mp3.d.ts"
+    },
+    "./mp4": {
+      "import": "./dist/plugins/mp4.js",
+      "types": "./dist/plugins/mp4.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "build:demo": "vite build --config demo/vite.config.ts",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "mp4box": "^0.5.2"
+  },
+  "devDependencies": {
+    "typescript": "^5",
+    "vitest": "^2",
+    "@vitest/browser": "^2",
+    "playwright": "^1",
+    "vite": "^5"
+  }
+}