@jadujoel/web-audio-clip-node 0.1.7 → 0.1.8

package/dist/workers/mp3-decode-worker.js

@@ -0,0 +1,254 @@
+// MP3 Decode Worker — runs fetch → MP3 demux → AudioDecoder off the main thread.
+// Sends decoded Float32Array data directly to the ClipProcessor via a
+// transferred MessagePort, bypassing the main thread for audio data.
+import { concat, createThrottleStream, estimateTotalSamplesFromContentLength, resampleChannel, } from "./worker-utils.js";
+// ── MP3 frame parser ─────────────────────────────────────────────────
+const BITRATES = [
+    0, 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320, 0,
+];
+const SAMPLE_RATES = [44100, 48000, 32000, 0];
+const SAMPLES_PER_FRAME = 1152; // MPEG1 Layer III
+function parseMp3Frames(buf) {
+    const frames = [];
+    let i = 0;
+    // Skip ID3v2 tag if present
+    if (buf.length >= 10 &&
+        buf[0] === 0x49 &&
+        buf[1] === 0x44 &&
+        buf[2] === 0x33) {
+        const size = ((buf[6] & 0x7f) << 21) |
+            ((buf[7] & 0x7f) << 14) |
+            ((buf[8] & 0x7f) << 7) |
+            (buf[9] & 0x7f);
+        i = 10 + size;
+    }
+    while (i + 4 <= buf.length) {
+        // Sync word: 11 set bits
+        if (buf[i] !== 0xff || (buf[i + 1] & 0xe0) !== 0xe0) {
+            i++;
+            continue;
+        }
+        const header = buf[i + 1];
+        const mpegVersion = (header >> 3) & 0x03;
+        const layer = (header >> 1) & 0x03;
+        // Only MPEG1 Layer III
+        if (mpegVersion !== 3 || layer !== 1) {
+            i++;
+            continue;
+        }
+        const bitrateIndex = (buf[i + 2] >> 4) & 0x0f;
+        const sampleRateIndex = (buf[i + 2] >> 2) & 0x03;
+        const padding = (buf[i + 2] >> 1) & 0x01;
+        const channelMode = (buf[i + 3] >> 6) & 0x03;
+        const bitrate = BITRATES[bitrateIndex] * 1000;
+        const sampleRate = SAMPLE_RATES[sampleRateIndex];
+        if (bitrate === 0 || sampleRate === 0) {
+            i++;
+            continue;
+        }
+        const frameSize = Math.floor((144 * bitrate) / sampleRate) + padding;
+        if (i + frameSize > buf.length) {
+            // Incomplete frame — return as leftover
+            break;
+        }
+        frames.push({
+            offset: i,
+            size: frameSize,
+            bitrate,
+            sampleRate,
+            channels: channelMode === 3 ? 1 : 2,
+        });
+        i += frameSize;
+    }
+    return { frames, leftover: buf.slice(i) };
+}
+// ── Main worker entry ────────────────────────────────────────────────
+let abortController = null;
+self.onmessage = (ev) => {
+    const { type } = ev.data;
+    if (type === "init") {
+        const { port, url, throttle, targetSampleRate } = ev.data;
+        abortController = new AbortController();
+        startStreaming(port, url, abortController.signal, throttle ?? 0, targetSampleRate ?? 0);
+    }
+    else if (type === "abort") {
+        abortController?.abort();
+    }
+};
+async function startStreaming(processorPort, url, signal, throttle, targetSampleRate) {
+    let totalBytes = null;
+    let bytesReceived = 0;
+    let samplesDecoded = 0;
+    let leftover = new Uint8Array(0);
+    let initialized = false;
+    let didSendMeta = false;
+    const decoder = new AudioDecoder({
+        output(audioData) {
+            const numFrames = audioData.numberOfFrames;
+            const numChannels = audioData.numberOfChannels;
+            const srcRate = audioData.sampleRate;
+            const dstRate = targetSampleRate > 0 ? targetSampleRate : srcRate;
+            const channelData = [];
+            for (let ch = 0; ch < numChannels; ch++) {
+                const raw = new Float32Array(numFrames);
+                audioData.copyTo(raw, { planeIndex: ch, format: "f32-planar" });
+                channelData.push(resampleChannel(raw, srcRate, dstRate));
+            }
+            audioData.close();
+            const resampledFrames = channelData[0].length;
+            if (!didSendMeta) {
+                didSendMeta = true;
+                const estimatedTotalSamples = estimateTotalSamplesFromContentLength({
+                    totalBytes,
+                    bitrate: null,
+                    sourceSampleRate: srcRate,
+                    targetSampleRate: dstRate,
+                });
+                self.postMessage({
+                    type: "streamMeta",
+                    estimatedTotalSamples,
+                    sampleRate: dstRate,
+                    channels: numChannels,
+                    isEstimate: true,
+                });
+            }
+            if (!initialized) {
+                initialized = true;
+                const estimatedTotalSamples = estimateTotalSamplesFromContentLength({
+                    totalBytes,
+                    bitrate: null,
+                    sourceSampleRate: srcRate,
+                    targetSampleRate: dstRate,
+                });
+                processorPort.postMessage({
+                    type: "bufferInit",
+                    data: {
+                        channels: numChannels,
+                        totalLength: estimatedTotalSamples ?? 0,
+                        streaming: true,
+                    },
+                });
+                self.postMessage({
+                    type: "info",
+                    sampleRate: srcRate,
+                    channels: numChannels,
+                });
+            }
+            processorPort.postMessage({
+                type: "bufferRange",
+                data: {
+                    startSample: samplesDecoded,
+                    channelData,
+                },
+            });
+            samplesDecoded += resampledFrames;
+            self.postMessage({ type: "decoded", samplesDecoded });
+        },
+        error(e) {
+            self.postMessage({ type: "error", message: e.message });
+        },
+    });
+    try {
+        const response = await fetch(url, { signal });
+        if (!response.ok) {
+            self.postMessage({
+                type: "error",
+                message: `Fetch failed: ${response.status} ${response.statusText}`,
+            });
+            return;
+        }
+        if (!response.body) {
+            self.postMessage({ type: "error", message: "Response has no body" });
+            return;
+        }
+        const contentLength = response.headers.get("content-length");
+        totalBytes = contentLength ? Number.parseInt(contentLength, 10) : null;
+        const body = throttle > 0
+            ? response.body.pipeThrough(createThrottleStream(throttle))
+            : response.body;
+        const reader = body.getReader();
+        let configuredDecoder = false;
+        let timestampUs = 0;
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            bytesReceived += value.length;
+            self.postMessage({ type: "progress", bytesReceived, totalBytes });
+            const combined = leftover.length > 0 ? concat(leftover, value) : value;
+            const { frames, leftover: remainder } = parseMp3Frames(combined);
+            leftover = remainder;
+            for (const frame of frames) {
+                if (didSendMeta && totalBytes !== null) {
+                    const refinedEstimate = estimateTotalSamplesFromContentLength({
+                        totalBytes,
+                        bitrate: frame.bitrate,
+                        sourceSampleRate: frame.sampleRate,
+                        targetSampleRate: targetSampleRate > 0 ? targetSampleRate : frame.sampleRate,
+                    });
+                    if (refinedEstimate != null) {
+                        self.postMessage({
+                            type: "streamMeta",
+                            estimatedTotalSamples: refinedEstimate,
+                            sampleRate: targetSampleRate > 0 ? targetSampleRate : frame.sampleRate,
+                            channels: frame.channels,
+                            isEstimate: true,
+                        });
+                    }
+                }
+                if (!configuredDecoder) {
+                    decoder.configure({
+                        codec: "mp3",
+                        sampleRate: frame.sampleRate,
+                        numberOfChannels: frame.channels,
+                    });
+                    configuredDecoder = true;
+                }
+                const frameData = combined.slice(frame.offset, frame.offset + frame.size);
+                decoder.decode(new EncodedAudioChunk({
+                    type: "key",
+                    timestamp: timestampUs,
+                    data: frameData,
+                }));
+                timestampUs += Math.round((SAMPLES_PER_FRAME / frame.sampleRate) * 1_000_000);
+            }
+        }
+        // Flush remaining decoded data
+        if (configuredDecoder) {
+            await decoder.flush();
+        }
+        else {
+            self.postMessage({
+                type: "error",
+                message: "No MP3 frames found in the stream",
+            });
+            return;
+        }
+        // Signal end of buffer
+        processorPort.postMessage({
+            type: "bufferEnd",
+            data: { totalLength: samplesDecoded },
+        });
+        self.postMessage({ type: "done", samplesDecoded });
+    }
+    catch (e) {
+        if (e instanceof DOMException && e.name === "AbortError") {
+            self.postMessage({ type: "aborted" });
+        }
+        else {
+            self.postMessage({
+                type: "error",
+                message: e instanceof Error ? e.message : String(e),
+            });
+        }
+    }
+    finally {
+        try {
+            decoder.close();
+        }
+        catch {
+            // already closed
+        }
+        processorPort.close();
+    }
+}

package/dist/workers/mp3-decode-worker.min.js

@@ -0,0 +1 @@
+function k(n,x){let A=new Uint8Array(n.length+x.length);return A.set(n),A.set(x,n.length),A}var P=128000;function X({totalBytes:n,bitrate:x,sourceSampleRate:A,targetSampleRate:N}){if(n==null||n<=0)return null;if(A<=0||N<=0)return null;let T=x!=null&&Number.isFinite(x)&&x>0?x:P,U=n*8/T;if(!Number.isFinite(U)||U<=0)return null;let _=Math.ceil(U*N);return Number.isFinite(_)&&_>0?_:null}function L(n,x,A){if(x===A)return n;let N=x/A,T=Math.round(n.length/N),U=new Float32Array(T);for(let _=0;_<T;_++){let F=_*N,q=Math.floor(F),I=F-q,y=n[q]??0,E=n[Math.min(q+1,n.length-1)]??0;U[_]=y+I*(E-y)}return U}function M(n){let x=0,A=performance.now();return new TransformStream({async transform(N,T){x+=N.length;let U=(performance.now()-A)/1000,F=x/n-U;if(F>0)await new Promise((q)=>setTimeout(q,F*1000));T.enqueue(N)}})}var C=[0,32,40,48,56,64,80,96,112,128,160,192,224,256,320,0],h=[44100,48000,32000,0],v=1152;function c(n){let x=[],A=0;if(n.length>=10&&n[0]===73&&n[1]===68&&n[2]===51)A=10+((n[6]&127)<<21|(n[7]&127)<<14|(n[8]&127)<<7|n[9]&127);while(A+4<=n.length){if(n[A]!==255||(n[A+1]&224)!==224){A++;continue}let N=n[A+1],T=N>>3&3,U=N>>1&3;if(T!==3||U!==1){A++;continue}let _=n[A+2]>>4&15,F=n[A+2]>>2&3,q=n[A+2]>>1&1,I=n[A+3]>>6&3,y=C[_]*1000,E=h[F];if(y===0||E===0){A++;continue}let w=Math.floor(144*y/E)+q;if(A+w>n.length)break;x.push({offset:A,size:w,bitrate:y,sampleRate:E,channels:I===3?1:2}),A+=w}return{frames:x,leftover:n.slice(A)}}var Z=null;self.onmessage=(n)=>{let{type:x}=n.data;if(x==="init"){let{port:A,url:N,throttle:T,targetSampleRate:U}=n.data;Z=new AbortController,S(A,N,Z.signal,T??0,U??0)}else if(x==="abort")Z?.abort()};async function S(n,x,A,N,T){let U=null,_=0,F=0,q=new Uint8Array(0),I=!1,y=!1,E=new AudioDecoder({output(w){let{numberOfFrames:W,numberOfChannels:O,sampleRate:H}=w,G=T>0?T:H,J=[];for(let K=0;K<O;K++){let Q=new Float32Array(W);w.copyTo(Q,{planeIndex:K,format:"f32-planar"}),J.push(L(Q,H,G))}w.close();let Y=J[0].length;if(!y){y=!0;let K=X({totalBytes:U,bitrate:null,sourceSampleRate:H,targetSampleRate:G});self.postMessage({type:"streamMeta",estimatedTotalSamples:K,sampleRate:G,channels:O,isEstimate:!0})}if(!I){I=!0;let K=X({totalBytes:U,bitrate:null,sourceSampleRate:H,targetSampleRate:G});n.postMessage({type:"bufferInit",data:{channels:O,totalLength:K??0,streaming:!0}}),self.postMessage({type:"info",sampleRate:H,channels:O})}n.postMessage({type:"bufferRange",data:{startSample:F,channelData:J}}),F+=Y,self.postMessage({type:"decoded",samplesDecoded:F})},error(w){self.postMessage({type:"error",message:w.message})}});try{let w=await fetch(x,{signal:A});if(!w.ok){self.postMessage({type:"error",message:`Fetch failed: ${w.status} ${w.statusText}`});return}if(!w.body){self.postMessage({type:"error",message:"Response has no body"});return}let W=w.headers.get("content-length");U=W?Number.parseInt(W,10):null;let H=(N>0?w.body.pipeThrough(M(N)):w.body).getReader(),G=!1,J=0;while(!0){let{done:Y,value:K}=await H.read();if(Y)break;_+=K.length,self.postMessage({type:"progress",bytesReceived:_,totalBytes:U});let Q=q.length>0?k(q,K):K,{frames:V,leftover:B}=c(Q);q=B;for(let j of V){if(y&&U!==null){let $=X({totalBytes:U,bitrate:j.bitrate,sourceSampleRate:j.sampleRate,targetSampleRate:T>0?T:j.sampleRate});if($!=null)self.postMessage({type:"streamMeta",estimatedTotalSamples:$,sampleRate:T>0?T:j.sampleRate,channels:j.channels,isEstimate:!0})}if(!G)E.configure({codec:"mp3",sampleRate:j.sampleRate,numberOfChannels:j.channels}),G=!0;let z=Q.slice(j.offset,j.offset+j.size);E.decode(new EncodedAudioChunk({type:"key",timestamp:J,data:z})),J+=Math.round(v/j.sampleRate*1e6)}}if(G)await E.flush();else{self.postMessage({type:"error",message:"No MP3 frames found in the stream"});return}n.postMessage({type:"bufferEnd",data:{totalLength:F}}),self.postMessage({type:"done",samplesDecoded:F})}catch(w){if(w instanceof DOMException&&w.name==="AbortError")self.postMessage({type:"aborted"});else self.postMessage({type:"error",message:w instanceof Error?w.message:String(w)})}finally{try{E.close()}catch{}n.close()}}

package/dist/workers/ogg-opus-decode-worker.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/workers/ogg-opus-decode-worker.js

@@ -0,0 +1,398 @@
+// Ogg Opus Decode Worker — runs fetch → Ogg/Opus demux → AudioDecoder off the main thread.
+// Sends decoded Float32Array data directly to the ClipProcessor via a
+// transferred MessagePort, bypassing the main thread for audio data.
+import { concat, createThrottleStream, estimateTotalSamplesFromContentLength, resampleChannel, } from "./worker-utils.js";
+const OGG_MAGIC = [0x4f, 0x67, 0x67, 0x53];
+const OPUS_SAMPLE_RATE = 48_000;
+function readUint64LE(buf, offset) {
+    let value = 0n;
+    for (let i = 0; i < 8; i++) {
+        value |= BigInt(buf[offset + i] ?? 0) << BigInt(i * 8);
+    }
+    return value;
+}
+function indexOfOggSync(buf, from) {
+    for (let i = from; i <= buf.length - OGG_MAGIC.length; i++) {
+        if (buf[i] === OGG_MAGIC[0] &&
+            buf[i + 1] === OGG_MAGIC[1] &&
+            buf[i + 2] === OGG_MAGIC[2] &&
+            buf[i + 3] === OGG_MAGIC[3]) {
+            return i;
+        }
+    }
+    return -1;
+}
+function parseOggPages(buf) {
+    const pages = [];
+    let cursor = 0;
+    while (cursor < buf.length) {
+        const sync = indexOfOggSync(buf, cursor);
+        if (sync < 0) {
+            break;
+        }
+        if (sync > cursor) {
+            cursor = sync;
+        }
+        if (cursor + 27 > buf.length) {
+            break;
+        }
+        const version = buf[cursor + 4] ?? 255;
+        if (version !== 0) {
+            cursor += 1;
+            continue;
+        }
+        const headerType = buf[cursor + 5] ?? 0;
+        const granulePosition = readUint64LE(buf, cursor + 6);
+        const serialNumber = (buf[cursor + 14] ?? 0) |
+            ((buf[cursor + 15] ?? 0) << 8) |
+            ((buf[cursor + 16] ?? 0) << 16) |
+            ((buf[cursor + 17] ?? 0) << 24);
+        const pageSequence = (buf[cursor + 18] ?? 0) |
+            ((buf[cursor + 19] ?? 0) << 8) |
+            ((buf[cursor + 20] ?? 0) << 16) |
+            ((buf[cursor + 21] ?? 0) << 24);
+        const segmentCount = buf[cursor + 26] ?? 0;
+        const segmentTableStart = cursor + 27;
+        const segmentTableEnd = segmentTableStart + segmentCount;
+        if (segmentTableEnd > buf.length) {
+            break;
+        }
+        let segmentBytes = 0;
+        for (let i = 0; i < segmentCount; i++) {
+            segmentBytes += buf[segmentTableStart + i] ?? 0;
+        }
+        const segmentDataStart = segmentTableEnd;
+        const segmentDataEnd = segmentDataStart + segmentBytes;
+        if (segmentDataEnd > buf.length) {
+            break;
+        }
+        const packets = [];
+        let packetStart = segmentDataStart;
+        let packetSize = 0;
+        for (let i = 0; i < segmentCount; i++) {
+            const lace = buf[segmentTableStart + i] ?? 0;
+            packetSize += lace;
+            if (lace < 255) {
+                packets.push(buf.slice(packetStart, packetStart + packetSize));
+                packetStart += packetSize;
+                packetSize = 0;
+            }
+        }
+        const lastPacketComplete = packetSize === 0;
+        if (!lastPacketComplete) {
+            packets.push(buf.slice(packetStart, packetStart + packetSize));
+        }
+        pages.push({
+            headerType,
+            granulePosition,
+            serialNumber,
+            pageSequence,
+            packets,
+            continued: (headerType & 0x01) !== 0,
+            lastPacketComplete,
+        });
+        cursor = segmentDataEnd;
+    }
+    return {
+        pages,
+        leftover: buf.slice(cursor),
+    };
+}
+function parseOpusHead(packet) {
+    if (packet.length < 19)
+        return null;
+    const magic = new TextDecoder().decode(packet.slice(0, 8));
+    if (magic !== "OpusHead")
+        return null;
+    const channels = packet[9] ?? 0;
+    const preSkip = (packet[10] ?? 0) | ((packet[11] ?? 0) << 8);
+    return {
+        channels,
+        preSkip,
+        description: packet,
+    };
+}
+let abortController = null;
+self.onmessage = (ev) => {
+    const { type } = ev.data;
+    if (type === "init") {
+        const { port, url, throttle, targetSampleRate } = ev.data;
+        abortController = new AbortController();
+        startStreaming(port, url, abortController.signal, throttle ?? 0, targetSampleRate ?? 0);
+    }
+    else if (type === "abort") {
+        abortController?.abort();
+    }
+};
+async function startStreaming(processorPort, url, signal, throttle, targetSampleRate) {
+    let totalBytes = null;
+    let bytesReceived = 0;
+    let samplesDecoded = 0;
+    let leftover = new Uint8Array(0);
+    let pendingPacket = new Uint8Array(0);
+    let initialized = false;
+    let didSendMeta = false;
+    let packetIndex = 0;
+    let activeSerial = null;
+    let streamChannels = 2;
+    let preSkipSourceSamples = 0;
+    let preSkipTargetSamples = 0;
+    let samplesSkipped = 0;
+    let shouldApplyPreSkip = true;
+    let preSkipProbeDone = false;
+    let timestampUs = 0;
+    const decoder = new AudioDecoder({
+        output(audioData) {
+            const numFrames = audioData.numberOfFrames;
+            const numChannels = audioData.numberOfChannels;
+            const srcRate = audioData.sampleRate;
+            const dstRate = targetSampleRate > 0 ? targetSampleRate : srcRate;
+            if (!preSkipProbeDone) {
+                const preSkipUs = Math.round((preSkipSourceSamples / OPUS_SAMPLE_RATE) * 1_000_000);
+                if (audioData.timestamp >= preSkipUs && preSkipUs > 0) {
+                    shouldApplyPreSkip = false;
+                }
+                preSkipProbeDone = true;
+            }
+            const channelData = [];
+            for (let ch = 0; ch < numChannels; ch++) {
+                const raw = new Float32Array(numFrames);
+                audioData.copyTo(raw, { planeIndex: ch, format: "f32-planar" });
+                channelData.push(resampleChannel(raw, srcRate, dstRate));
+            }
+            audioData.close();
+            let resampledFrames = channelData[0]?.length ?? 0;
+            if (shouldApplyPreSkip &&
+                samplesSkipped < preSkipTargetSamples &&
+                resampledFrames > 0) {
+                const toSkip = Math.min(preSkipTargetSamples - samplesSkipped, resampledFrames);
+                samplesSkipped += toSkip;
+                if (toSkip === resampledFrames) {
+                    timestampUs += Math.round((numFrames / OPUS_SAMPLE_RATE) * 1_000_000);
+                    return;
+                }
+                for (let ch = 0; ch < channelData.length; ch++) {
+                    channelData[ch] = channelData[ch].subarray(toSkip);
+                }
+                resampledFrames = channelData[0]?.length ?? 0;
+            }
+            if (!didSendMeta) {
+                didSendMeta = true;
+                const estimatedTotalSamples = estimateTotalSamplesFromContentLength({
+                    totalBytes,
+                    bitrate: null,
+                    sourceSampleRate: OPUS_SAMPLE_RATE,
+                    targetSampleRate: dstRate,
+                });
+                self.postMessage({
+                    type: "streamMeta",
+                    estimatedTotalSamples,
+                    sampleRate: dstRate,
+                    channels: numChannels,
+                    isEstimate: true,
+                });
+            }
+            if (!initialized) {
+                initialized = true;
+                const estimatedTotalSamples = estimateTotalSamplesFromContentLength({
+                    totalBytes,
+                    bitrate: null,
+                    sourceSampleRate: OPUS_SAMPLE_RATE,
+                    targetSampleRate: dstRate,
+                });
+                processorPort.postMessage({
+                    type: "bufferInit",
+                    data: {
+                        channels: numChannels,
+                        totalLength: estimatedTotalSamples ?? 0,
+                        streaming: true,
+                    },
+                });
+                self.postMessage({
+                    type: "info",
+                    sampleRate: srcRate,
+                    channels: numChannels,
+                });
+            }
+            if (resampledFrames > 0) {
+                processorPort.postMessage({
+                    type: "bufferRange",
+                    data: {
+                        startSample: samplesDecoded,
+                        channelData,
+                    },
+                });
+                samplesDecoded += resampledFrames;
+                self.postMessage({ type: "decoded", samplesDecoded });
+            }
+            timestampUs += Math.round((numFrames / OPUS_SAMPLE_RATE) * 1_000_000);
+        },
+        error(e) {
+            self.postMessage({ type: "error", message: e.message });
+        },
+    });
+    try {
+        const response = await fetch(url, { signal });
+        if (!response.ok) {
+            self.postMessage({
+                type: "error",
+                message: `Fetch failed: ${response.status} ${response.statusText}`,
+            });
+            return;
+        }
+        if (!response.body) {
+            self.postMessage({ type: "error", message: "Response has no body" });
+            return;
+        }
+        const contentLength = response.headers.get("content-length");
+        totalBytes = contentLength ? Number.parseInt(contentLength, 10) : null;
+        const body = throttle > 0
+            ? response.body.pipeThrough(createThrottleStream(throttle))
+            : response.body;
+        const reader = body.getReader();
+        let configuredDecoder = false;
+        let decodedAnyPacket = false;
+        const handlePacket = (packet) => {
+            if (packet.length === 0)
+                return;
+            if (packetIndex === 0) {
+                const head = parseOpusHead(packet);
+                if (!head) {
+                    throw new Error("Missing or invalid OpusHead packet");
+                }
+                if (head.channels <= 0) {
+                    throw new Error("OpusHead contains invalid channel count");
+                }
+                streamChannels = head.channels;
+                preSkipSourceSamples = head.preSkip;
+                const dstRate = targetSampleRate > 0 ? targetSampleRate : OPUS_SAMPLE_RATE;
+                preSkipTargetSamples = Math.round((preSkipSourceSamples / OPUS_SAMPLE_RATE) * dstRate);
+                decoder.configure({
+                    codec: "opus",
+                    sampleRate: OPUS_SAMPLE_RATE,
+                    numberOfChannels: head.channels,
+                    description: head.description,
+                });
+                configuredDecoder = true;
+                packetIndex += 1;
+                return;
+            }
+            if (packetIndex === 1) {
+                packetIndex += 1;
+                return;
+            }
+            if (!configuredDecoder) {
+                throw new Error("Decoder is not configured for Opus stream");
+            }
+            decoder.decode(new EncodedAudioChunk({
+                type: "key",
+                timestamp: timestampUs,
+                data: packet,
+            }));
+            decodedAnyPacket = true;
+            packetIndex += 1;
+        };
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            bytesReceived += value.length;
+            self.postMessage({ type: "progress", bytesReceived, totalBytes });
+            const combined = leftover.length > 0 ? concat(leftover, value) : value;
+            const parsed = parseOggPages(combined);
+            leftover = parsed.leftover;
+            for (const page of parsed.pages) {
+                if (activeSerial == null) {
+                    activeSerial = page.serialNumber;
+                }
+                if (page.serialNumber !== activeSerial) {
+                    continue;
+                }
+                if (page.continued) {
+                    if (page.packets.length === 0) {
+                        continue;
+                    }
+                    pendingPacket = concat(pendingPacket, page.packets[0]);
+                    const firstComplete = page.packets.length > 1 || page.lastPacketComplete;
+                    if (firstComplete) {
+                        handlePacket(pendingPacket);
+                        pendingPacket = new Uint8Array(0);
+                    }
+                    for (let i = 1; i < page.packets.length; i++) {
+                        const isTrailingPartial = i === page.packets.length - 1 && !page.lastPacketComplete;
+                        if (isTrailingPartial) {
+                            pendingPacket = concat(pendingPacket, page.packets[i]);
+                            continue;
+                        }
+                        if (pendingPacket.length > 0) {
+                            handlePacket(concat(pendingPacket, page.packets[i]));
+                            pendingPacket = new Uint8Array(0);
+                        }
+                        else {
+                            handlePacket(page.packets[i]);
+                        }
+                    }
+                    continue;
+                }
+                for (let i = 0; i < page.packets.length; i++) {
+                    const isTrailingPartial = i === page.packets.length - 1 && !page.lastPacketComplete;
+                    if (isTrailingPartial) {
+                        pendingPacket = concat(pendingPacket, page.packets[i]);
+                        continue;
+                    }
+                    if (pendingPacket.length > 0) {
+                        handlePacket(concat(pendingPacket, page.packets[i]));
+                        pendingPacket = new Uint8Array(0);
+                    }
+                    else {
+                        handlePacket(page.packets[i]);
+                    }
+                }
+            }
+        }
+        if (pendingPacket.length > 0) {
+            handlePacket(pendingPacket);
+            pendingPacket = new Uint8Array(0);
+        }
+        if (configuredDecoder && decodedAnyPacket) {
+            await decoder.flush();
+        }
+        else {
+            self.postMessage({
+                type: "error",
+                message: "No Opus packets found in the stream",
+            });
+            return;
+        }
+        processorPort.postMessage({
+            type: "bufferEnd",
+            data: { totalLength: samplesDecoded },
+        });
+        self.postMessage({
+            type: "done",
+            samplesDecoded,
+            sampleRate: OPUS_SAMPLE_RATE,
+            channels: streamChannels,
+        });
+    }
+    catch (e) {
+        if (e instanceof DOMException && e.name === "AbortError") {
+            self.postMessage({ type: "aborted" });
+        }
+        else {
+            self.postMessage({
+                type: "error",
+                message: e instanceof Error ? e.message : String(e),
+            });
+        }
+    }
+    finally {
+        try {
+            decoder.close();
+        }
+        catch {
+            // already closed
+        }
+        processorPort.close();
+    }
+}

package/dist/workers/ogg-opus-decode-worker.min.js

@@ -0,0 +1 @@
+function z(A,_){let w=new Uint8Array(A.length+_.length);return w.set(A),w.set(_,A.length),w}var i=128000;function b({totalBytes:A,bitrate:_,sourceSampleRate:w,targetSampleRate:M}){if(A==null||A<=0)return null;if(w<=0||M<=0)return null;let G=_!=null&&Number.isFinite(_)&&_>0?_:i,j=A*8/G;if(!Number.isFinite(j)||j<=0)return null;let H=Math.ceil(j*M);return Number.isFinite(H)&&H>0?H:null}function g(A,_,w){if(_===w)return A;let M=_/w,G=Math.round(A.length/M),j=new Float32Array(G);for(let H=0;H<G;H++){let J=H*M,Q=Math.floor(J),N=J-Q,Y=A[Q]??0,I=A[Math.min(Q+1,A.length-1)]??0;j[H]=Y+N*(I-Y)}return j}function u(A){let _=0,w=performance.now();return new TransformStream({async transform(M,G){_+=M.length;let j=(performance.now()-w)/1000,J=_/A-j;if(J>0)await new Promise((Q)=>setTimeout(Q,J*1000));G.enqueue(M)}})}var f=[79,103,103,83],$=48000;function k(A,_){let w=0n;for(let M=0;M<8;M++)w|=BigInt(A[_+M]??0)<<BigInt(M*8);return w}function o(A,_){for(let w=_;w<=A.length-f.length;w++)if(A[w]===f[0]&&A[w+1]===f[1]&&A[w+2]===f[2]&&A[w+3]===f[3])return w;return-1}function d(A){let _=[],w=0;while(w<A.length){let M=o(A,w);if(M<0)break;if(M>w)w=M;if(w+27>A.length)break;if((A[w+4]??255)!==0){w+=1;continue}let j=A[w+5]??0,H=k(A,w+6),J=(A[w+14]??0)|(A[w+15]??0)<<8|(A[w+16]??0)<<16|(A[w+17]??0)<<24,Q=(A[w+18]??0)|(A[w+19]??0)<<8|(A[w+20]??0)<<16|(A[w+21]??0)<<24,N=A[w+26]??0,Y=w+27,I=Y+N;if(I>A.length)break;let E=0;for(let W=0;W<N;W++)E+=A[Y+W]??0;let y=I,R=y+E;if(R>A.length)break;let O=[],Z=y,V=0;for(let W=0;W<N;W++){let C=A[Y+W]??0;if(V+=C,C<255)O.push(A.slice(Z,Z+V)),Z+=V,V=0}let D=V===0;if(!D)O.push(A.slice(Z,Z+V));_.push({headerType:j,granulePosition:H,serialNumber:J,pageSequence:Q,packets:O,continued:(j&1)!==0,lastPacketComplete:D}),w=R}return{pages:_,leftover:A.slice(w)}}function r(A){if(A.length<19)return null;if(new TextDecoder().decode(A.slice(0,8))!=="OpusHead")return null;let w=A[9]??0,M=(A[10]??0)|(A[11]??0)<<8;return{channels:w,preSkip:M,description:A}}var l=null;self.onmessage=(A)=>{let{type:_}=A.data;if(_==="init"){let{port:w,url:M,throttle:G,targetSampleRate:j}=A.data;l=new AbortController,s(w,M,l.signal,G??0,j??0)}else if(_==="abort")l?.abort()};async function s(A,_,w,M,G){let j=null,H=0,J=0,Q=new Uint8Array(0),N=new Uint8Array(0),Y=!1,I=!1,E=0,y=null,R=2,O=0,Z=0,V=0,D=!0,W=!1,C=0,m=new AudioDecoder({output(x){let{numberOfFrames:v,numberOfChannels:h,sampleRate:P}=x,B=G>0?G:P;if(!W){let K=Math.round(O/$*1e6);if(x.timestamp>=K&&K>0)D=!1;W=!0}let X=[];for(let K=0;K<h;K++){let q=new Float32Array(v);x.copyTo(q,{planeIndex:K,format:"f32-planar"}),X.push(g(q,P,B))}x.close();let L=X[0]?.length??0;if(D&&V<Z&&L>0){let K=Math.min(Z-V,L);if(V+=K,K===L){C+=Math.round(v/$*1e6);return}for(let q=0;q<X.length;q++)X[q]=X[q].subarray(K);L=X[0]?.length??0}if(!I){I=!0;let K=b({totalBytes:j,bitrate:null,sourceSampleRate:$,targetSampleRate:B});self.postMessage({type:"streamMeta",estimatedTotalSamples:K,sampleRate:B,channels:h,isEstimate:!0})}if(!Y){Y=!0;let K=b({totalBytes:j,bitrate:null,sourceSampleRate:$,targetSampleRate:B});A.postMessage({type:"bufferInit",data:{channels:h,totalLength:K??0,streaming:!0}}),self.postMessage({type:"info",sampleRate:P,channels:h})}if(L>0)A.postMessage({type:"bufferRange",data:{startSample:J,channelData:X}}),J+=L,self.postMessage({type:"decoded",samplesDecoded:J});C+=Math.round(v/$*1e6)},error(x){self.postMessage({type:"error",message:x.message})}});try{let x=await fetch(_,{signal:w});if(!x.ok){self.postMessage({type:"error",message:`Fetch failed: ${x.status} ${x.statusText}`});return}if(!x.body){self.postMessage({type:"error",message:"Response has no body"});return}let v=x.headers.get("content-length");j=v?Number.parseInt(v,10):null;let P=(M>0?x.body.pipeThrough(u(M)):x.body).getReader(),B=!1,X=!1,L=(K)=>{if(K.length===0)return;if(E===0){let q=r(K);if(!q)throw Error("Missing or invalid OpusHead packet");if(q.channels<=0)throw Error("OpusHead contains invalid channel count");R=q.channels,O=q.preSkip;let S=G>0?G:$;Z=Math.round(O/$*S),m.configure({codec:"opus",sampleRate:$,numberOfChannels:q.channels,description:q.description}),B=!0,E+=1;return}if(E===1){E+=1;return}if(!B)throw Error("Decoder is not configured for Opus stream");m.decode(new EncodedAudioChunk({type:"key",timestamp:C,data:K})),X=!0,E+=1};while(!0){let{done:K,value:q}=await P.read();if(K)break;H+=q.length,self.postMessage({type:"progress",bytesReceived:H,totalBytes:j});let S=Q.length>0?z(Q,q):q,n=d(S);Q=n.leftover;for(let U of n.pages){if(y==null)y=U.serialNumber;if(U.serialNumber!==y)continue;if(U.continued){if(U.packets.length===0)continue;if(N=z(N,U.packets[0]),U.packets.length>1||U.lastPacketComplete)L(N),N=new Uint8Array(0);for(let T=1;T<U.packets.length;T++){if(T===U.packets.length-1&&!U.lastPacketComplete){N=z(N,U.packets[T]);continue}if(N.length>0)L(z(N,U.packets[T])),N=new Uint8Array(0);else L(U.packets[T])}continue}for(let F=0;F<U.packets.length;F++){if(F===U.packets.length-1&&!U.lastPacketComplete){N=z(N,U.packets[F]);continue}if(N.length>0)L(z(N,U.packets[F])),N=new Uint8Array(0);else L(U.packets[F])}}}if(N.length>0)L(N),N=new Uint8Array(0);if(B&&X)await m.flush();else{self.postMessage({type:"error",message:"No Opus packets found in the stream"});return}A.postMessage({type:"bufferEnd",data:{totalLength:J}}),self.postMessage({type:"done",samplesDecoded:J,sampleRate:$,channels:R})}catch(x){if(x instanceof DOMException&&x.name==="AbortError")self.postMessage({type:"aborted"});else self.postMessage({type:"error",message:x instanceof Error?x.message:String(x)})}finally{try{m.close()}catch{}A.close()}}