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

package/dist/workers/opus-worker-common.d.ts

@@ -0,0 +1,45 @@
+export declare const OPUS_SAMPLE_RATE = 48000;
+export interface OpusHead {
+    channels: number;
+    preSkip: number;
+    description: Uint8Array<ArrayBufferLike>;
+}
+export declare function parseOpusHead(packet: Uint8Array): OpusHead | null;
+export declare function createFallbackOpusHead(channels: number): OpusHead;
+interface StreamingOpusDecoderOptions {
+    processorPort: MessagePort;
+    targetSampleRate: number;
+    postMessage: (message: unknown) => void;
+}
+export declare class StreamingOpusDecoder {
+    private readonly processorPort;
+    private readonly targetSampleRate;
+    private readonly postMessage;
+    private readonly decoder;
+    private totalBytes;
+    private samplesDecodedCount;
+    private didSendMeta;
+    private initialized;
+    private configured;
+    private decodedAnyPacket;
+    private streamChannels;
+    private preSkipSourceSamples;
+    private preSkipTargetSamples;
+    private samplesSkipped;
+    private allowTimestampProbe;
+    private preSkipProbeDone;
+    private shouldApplyPreSkip;
+    private lastConfig;
+    constructor({ processorPort, targetSampleRate, postMessage, }: StreamingOpusDecoderOptions);
+    setTotalBytes(totalBytes: number | null): void;
+    configure(head: OpusHead, bitstreamFormat: "ogg" | "opus"): Promise<void>;
+    decodePacket(packet: Uint8Array, timestampUs: number): void;
+    flush(): Promise<void>;
+    close(): void;
+    get samplesDecoded(): number;
+    get channels(): number;
+    get hasConfiguredDecoder(): boolean;
+    get hasDecodedPackets(): boolean;
+    private readonly handleOutput;
+}
+export {};

package/dist/workers/opus-worker-common.js

@@ -0,0 +1,226 @@
+import { estimateTotalSamplesFromContentLength, resampleChannel, } from "./worker-utils.js";
+export const OPUS_SAMPLE_RATE = 48_000;
+const textDecoder = new TextDecoder();
+export function parseOpusHead(packet) {
+    if (packet.length < 19)
+        return null;
+    const magic = 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,
+    };
+}
+export function createFallbackOpusHead(channels) {
+    const description = new Uint8Array(19);
+    description.set(new TextEncoder().encode("OpusHead"), 0);
+    description[8] = 1;
+    description[9] = channels;
+    return {
+        channels,
+        preSkip: 0,
+        description,
+    };
+}
+export class StreamingOpusDecoder {
+    processorPort;
+    targetSampleRate;
+    postMessage;
+    decoder;
+    totalBytes = null;
+    samplesDecodedCount = 0;
+    didSendMeta = false;
+    initialized = false;
+    configured = false;
+    decodedAnyPacket = false;
+    streamChannels = 2;
+    preSkipSourceSamples = 0;
+    preSkipTargetSamples = 0;
+    samplesSkipped = 0;
+    allowTimestampProbe = false;
+    preSkipProbeDone = false;
+    shouldApplyPreSkip = true;
+    lastConfig = null;
+    constructor({ processorPort, targetSampleRate, postMessage, }) {
+        this.processorPort = processorPort;
+        this.targetSampleRate = targetSampleRate;
+        this.postMessage = postMessage;
+        this.decoder = new AudioDecoder({
+            output: this.handleOutput,
+            error: (error) => {
+                this.postMessage({
+                    type: "error",
+                    message: this.lastConfig == null
+                        ? error.message
+                        : `${error.message} (${JSON.stringify({
+                            configured: this.configured,
+                            decodedAnyPacket: this.decodedAnyPacket,
+                            config: this.lastConfig,
+                        })})`,
+                });
+            },
+        });
+    }
+    setTotalBytes(totalBytes) {
+        this.totalBytes = totalBytes;
+    }
+    async configure(head, bitstreamFormat) {
+        if (head.channels <= 0) {
+            throw new Error("Opus stream contains invalid channel count");
+        }
+        this.streamChannels = head.channels;
+        this.preSkipSourceSamples = head.preSkip;
+        const dstRate = this.targetSampleRate > 0 ? this.targetSampleRate : OPUS_SAMPLE_RATE;
+        this.preSkipTargetSamples = Math.round((this.preSkipSourceSamples / OPUS_SAMPLE_RATE) * dstRate);
+        this.allowTimestampProbe = bitstreamFormat === "ogg";
+        this.preSkipProbeDone = false;
+        this.shouldApplyPreSkip = true;
+        const config = {
+            codec: "opus",
+            sampleRate: OPUS_SAMPLE_RATE,
+            numberOfChannels: head.channels,
+            description: head.description,
+        };
+        this.lastConfig = {
+            codec: config.codec,
+            sampleRate: config.sampleRate,
+            numberOfChannels: config.numberOfChannels,
+            descriptionLength: head.description.length,
+        };
+        const support = await AudioDecoder.isConfigSupported(config);
+        if (!support.supported) {
+            throw new Error(`Unsupported Opus decoder config: ${JSON.stringify({
+                codec: config.codec,
+                sampleRate: config.sampleRate,
+                numberOfChannels: config.numberOfChannels,
+                descriptionLength: head.description.length,
+            })}`);
+        }
+        this.decoder.configure(config);
+        this.configured = true;
+    }
+    decodePacket(packet, timestampUs) {
+        if (!this.configured) {
+            throw new Error("Decoder is not configured for Opus stream");
+        }
+        this.decoder.decode(new EncodedAudioChunk({
+            type: "key",
+            timestamp: timestampUs,
+            data: packet,
+        }));
+        this.decodedAnyPacket = true;
+    }
+    async flush() {
+        await this.decoder.flush();
+    }
+    close() {
+        try {
+            this.decoder.close();
+        }
+        catch {
+            // already closed
+        }
+    }
+    get samplesDecoded() {
+        return this.samplesDecodedCount;
+    }
+    get channels() {
+        return this.streamChannels;
+    }
+    get hasConfiguredDecoder() {
+        return this.configured;
+    }
+    get hasDecodedPackets() {
+        return this.decodedAnyPacket;
+    }
+    handleOutput = (audioData) => {
+        const numFrames = audioData.numberOfFrames;
+        const numChannels = audioData.numberOfChannels;
+        const srcRate = audioData.sampleRate;
+        const dstRate = this.targetSampleRate > 0 ? this.targetSampleRate : srcRate;
+        if (this.allowTimestampProbe && !this.preSkipProbeDone) {
+            const preSkipUs = Math.round((this.preSkipSourceSamples / OPUS_SAMPLE_RATE) * 1_000_000);
+            if (audioData.timestamp >= preSkipUs && preSkipUs > 0) {
+                this.shouldApplyPreSkip = false;
+            }
+            this.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 (this.shouldApplyPreSkip &&
+            this.samplesSkipped < this.preSkipTargetSamples &&
+            resampledFrames > 0) {
+            const toSkip = Math.min(this.preSkipTargetSamples - this.samplesSkipped, resampledFrames);
+            this.samplesSkipped += toSkip;
+            if (toSkip === resampledFrames) {
+                return;
+            }
+            for (let ch = 0; ch < channelData.length; ch++) {
+                channelData[ch] = channelData[ch].subarray(toSkip);
+            }
+            resampledFrames = channelData[0]?.length ?? 0;
+        }
+        if (!this.didSendMeta) {
+            this.didSendMeta = true;
+            const estimatedTotalSamples = estimateTotalSamplesFromContentLength({
+                totalBytes: this.totalBytes,
+                bitrate: null,
+                sourceSampleRate: OPUS_SAMPLE_RATE,
+                targetSampleRate: dstRate,
+            });
+            this.postMessage({
+                type: "streamMeta",
+                estimatedTotalSamples,
+                sampleRate: dstRate,
+                channels: numChannels,
+                isEstimate: true,
+            });
+        }
+        if (!this.initialized) {
+            this.initialized = true;
+            const estimatedTotalSamples = estimateTotalSamplesFromContentLength({
+                totalBytes: this.totalBytes,
+                bitrate: null,
+                sourceSampleRate: OPUS_SAMPLE_RATE,
+                targetSampleRate: dstRate,
+            });
+            this.processorPort.postMessage({
+                type: "bufferInit",
+                data: {
+                    channels: numChannels,
+                    totalLength: estimatedTotalSamples ?? 0,
+                    streaming: true,
+                },
+            });
+            this.postMessage({
+                type: "info",
+                sampleRate: srcRate,
+                channels: numChannels,
+            });
+        }
+        if (resampledFrames > 0) {
+            this.processorPort.postMessage({
+                type: "bufferRange",
+                data: {
+                    startSample: this.samplesDecodedCount,
+                    channelData,
+                },
+            });
+            this.samplesDecodedCount += resampledFrames;
+            this.postMessage({
+                type: "decoded",
+                samplesDecoded: this.samplesDecodedCount,
+            });
+        }
+    };
+}

package/dist/workers/raw-opus-framed-decode-worker.d.ts

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

package/dist/workers/raw-opus-framed-decode-worker.js

@@ -0,0 +1,119 @@
+// Raw Opus Decode Worker — runs fetch → framed raw Opus packet parse → AudioDecoder off the main thread.
+// Expected transport format:
+// - 8-byte magic: FROPUS01
+// - 4-byte little-endian OpusHead packet length
+// - OpusHead packet bytes
+// - repeated 4-byte little-endian packet length + Opus packet bytes
+import { createFramedRawOpusStreamState, parseFramedRawOpusStream, } from "./framed-raw-opus.js";
+import { OPUS_SAMPLE_RATE, StreamingOpusDecoder } from "./opus-worker-common.js";
+import { concat, createThrottleStream } from "./worker-utils.js";
+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 leftover = new Uint8Array(0);
+    let packetTimestampUs = 0;
+    const parserState = createFramedRawOpusStreamState();
+    const streamDecoder = new StreamingOpusDecoder({
+        processorPort,
+        targetSampleRate,
+        postMessage: (message) => self.postMessage(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;
+        streamDecoder.setTotalBytes(totalBytes);
+        const body = throttle > 0
+            ? response.body.pipeThrough(createThrottleStream(throttle))
+            : response.body;
+        const reader = body.getReader();
+        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 = parseFramedRawOpusStream(combined, parserState);
+            leftover = parsed.leftover;
+            if (parsed.head != null && !streamDecoder.hasConfiguredDecoder) {
+                await streamDecoder.configure(parsed.head, "opus");
+            }
+            for (const packet of parsed.packets) {
+                streamDecoder.decodePacket(packet, packetTimestampUs);
+                packetTimestampUs += 1;
+            }
+        }
+        if (leftover.length > 0) {
+            const parsed = parseFramedRawOpusStream(leftover, parserState);
+            if (parsed.leftover.length > 0) {
+                throw new Error("Framed raw Opus stream ended with a partial packet");
+            }
+            if (parsed.head != null && !streamDecoder.hasConfiguredDecoder) {
+                await streamDecoder.configure(parsed.head, "opus");
+            }
+            for (const packet of parsed.packets) {
+                streamDecoder.decodePacket(packet, packetTimestampUs);
+                packetTimestampUs += 1;
+            }
+        }
+        if (streamDecoder.hasConfiguredDecoder && streamDecoder.hasDecodedPackets) {
+            await streamDecoder.flush();
+        }
+        else {
+            self.postMessage({
+                type: "error",
+                message: "No framed raw Opus packets found in the stream",
+            });
+            return;
+        }
+        processorPort.postMessage({
+            type: "bufferEnd",
+            data: { totalLength: streamDecoder.samplesDecoded },
+        });
+        self.postMessage({
+            type: "done",
+            samplesDecoded: streamDecoder.samplesDecoded,
+            sampleRate: OPUS_SAMPLE_RATE,
+            channels: streamDecoder.channels,
+        });
+    }
+    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 {
+        streamDecoder.close();
+        processorPort.close();
+    }
+}

package/dist/workers/raw-opus-framed-decode-worker.min.js

@@ -0,0 +1 @@
+function x(e,r){let n=new Uint8Array(e.length+r.length);return n.set(e),n.set(r,e.length),n}var L=128000;function h({totalBytes:e,bitrate:r,sourceSampleRate:n,targetSampleRate:t}){if(e==null||e<=0)return null;if(n<=0||t<=0)return null;let u=r!=null&&Number.isFinite(r)&&r>0?r:L,o=e*8/u;if(!Number.isFinite(o)||o<=0)return null;let a=Math.ceil(o*t);return Number.isFinite(a)&&a>0?a:null}function k(e,r,n){if(r===n)return e;let t=r/n,u=Math.round(e.length/t),o=new Float32Array(u);for(let a=0;a<u;a++){let s=a*t,c=Math.floor(s),p=s-c,l=e[c]??0,i=e[Math.min(c+1,e.length-1)]??0;o[a]=l+p*(i-l)}return o}function S(e){let r=0,n=performance.now();return new TransformStream({async transform(t,u){r+=t.length;let o=(performance.now()-n)/1000,s=r/e-o;if(s>0)await new Promise((c)=>setTimeout(c,s*1000));u.enqueue(t)}})}var d=48000,R=new TextDecoder;function M(e){if(e.length<19)return null;if(R.decode(e.slice(0,8))!=="OpusHead")return null;let n=e[9]??0,t=(e[10]??0)|(e[11]??0)<<8;return{channels:n,preSkip:t,description:e}}class w{processorPort;targetSampleRate;postMessage;decoder;totalBytes=null;samplesDecodedCount=0;didSendMeta=!1;initialized=!1;configured=!1;decodedAnyPacket=!1;streamChannels=2;preSkipSourceSamples=0;preSkipTargetSamples=0;samplesSkipped=0;allowTimestampProbe=!1;preSkipProbeDone=!1;shouldApplyPreSkip=!0;lastConfig=null;constructor({processorPort:e,targetSampleRate:r,postMessage:n}){this.processorPort=e,this.targetSampleRate=r,this.postMessage=n,this.decoder=new AudioDecoder({output:this.handleOutput,error:(t)=>{this.postMessage({type:"error",message:this.lastConfig==null?t.message:`${t.message} (${JSON.stringify({configured:this.configured,decodedAnyPacket:this.decodedAnyPacket,config:this.lastConfig})})`})}})}setTotalBytes(e){this.totalBytes=e}async configure(e,r){if(e.channels<=0)throw Error("Opus stream contains invalid channel count");this.streamChannels=e.channels,this.preSkipSourceSamples=e.preSkip;let n=this.targetSampleRate>0?this.targetSampleRate:d;this.preSkipTargetSamples=Math.round(this.preSkipSourceSamples/d*n),this.allowTimestampProbe=r==="ogg",this.preSkipProbeDone=!1,this.shouldApplyPreSkip=!0;let t={codec:"opus",sampleRate:d,numberOfChannels:e.channels,description:e.description};if(this.lastConfig={codec:t.codec,sampleRate:t.sampleRate,numberOfChannels:t.numberOfChannels,descriptionLength:e.description.length},!(await AudioDecoder.isConfigSupported(t)).supported)throw Error(`Unsupported Opus decoder config: ${JSON.stringify({codec:t.codec,sampleRate:t.sampleRate,numberOfChannels:t.numberOfChannels,descriptionLength:e.description.length})}`);this.decoder.configure(t),this.configured=!0}decodePacket(e,r){if(!this.configured)throw Error("Decoder is not configured for Opus stream");this.decoder.decode(new EncodedAudioChunk({type:"key",timestamp:r,data:e})),this.decodedAnyPacket=!0}async flush(){await this.decoder.flush()}close(){try{this.decoder.close()}catch{}}get samplesDecoded(){return this.samplesDecodedCount}get channels(){return this.streamChannels}get hasConfiguredDecoder(){return this.configured}get hasDecodedPackets(){return this.decodedAnyPacket}handleOutput=(e)=>{let{numberOfFrames:r,numberOfChannels:n,sampleRate:t}=e,u=this.targetSampleRate>0?this.targetSampleRate:t;if(this.allowTimestampProbe&&!this.preSkipProbeDone){let s=Math.round(this.preSkipSourceSamples/d*1e6);if(e.timestamp>=s&&s>0)this.shouldApplyPreSkip=!1;this.preSkipProbeDone=!0}let o=[];for(let s=0;s<n;s++){let c=new Float32Array(r);e.copyTo(c,{planeIndex:s,format:"f32-planar"}),o.push(k(c,t,u))}e.close();let a=o[0]?.length??0;if(this.shouldApplyPreSkip&&this.samplesSkipped<this.preSkipTargetSamples&&a>0){let s=Math.min(this.preSkipTargetSamples-this.samplesSkipped,a);if(this.samplesSkipped+=s,s===a)return;for(let c=0;c<o.length;c++)o[c]=o[c].subarray(s);a=o[0]?.length??0}if(!this.didSendMeta){this.didSendMeta=!0;let s=h({totalBytes:this.totalBytes,bitrate:null,sourceSampleRate:d,targetSampleRate:u});this.postMessage({type:"streamMeta",estimatedTotalSamples:s,sampleRate:u,channels:n,isEstimate:!0})}if(!this.initialized){this.initialized=!0;let s=h({totalBytes:this.totalBytes,bitrate:null,sourceSampleRate:d,targetSampleRate:u});this.processorPort.postMessage({type:"bufferInit",data:{channels:n,totalLength:s??0,streaming:!0}}),this.postMessage({type:"info",sampleRate:t,channels:n})}if(a>0)this.processorPort.postMessage({type:"bufferRange",data:{startSample:this.samplesDecodedCount,channelData:o}}),this.samplesDecodedCount+=a,this.postMessage({type:"decoded",samplesDecoded:this.samplesDecodedCount})}}var v="FROPUS01",y=new TextEncoder().encode(v);function B(){return{headerParsed:!1,head:null}}function F(e,r){return((e[r]??0)|(e[r+1]??0)<<8|(e[r+2]??0)<<16|(e[r+3]??0)<<24)>>>0}function b(e,r){let n=0;if(!r.headerParsed){let u=y.length+4;if(e.length<u)return{packets:[],leftover:e,head:r.head};for(let l=0;l<y.length;l++)if(e[l]!==y[l])throw Error(`Expected ${v} header for framed raw Opus transport`);let o=F(e,y.length),a=u,s=a+o;if(e.length<s)return{packets:[],leftover:e,head:r.head};let c=e.slice(a,s),p=M(c);if(!p)throw Error("Framed raw Opus stream is missing a valid OpusHead packet");r.headerParsed=!0,r.head=p,n=s}let t=[];while(n+4<=e.length){let u=F(e,n),o=n+4,a=o+u;if(e.length<a)break;t.push(e.slice(o,a)),n=a}return{packets:t,leftover:e.slice(n),head:r.head}}var O=null;self.onmessage=(e)=>{let{type:r}=e.data;if(r==="init"){let{port:n,url:t,throttle:u,targetSampleRate:o}=e.data;O=new AbortController,T(n,t,O.signal,u??0,o??0)}else if(r==="abort")O?.abort()};async function T(e,r,n,t,u){let o=null,a=0,s=new Uint8Array(0),c=0,p=B(),l=new w({processorPort:e,targetSampleRate:u,postMessage:(i)=>self.postMessage(i)});try{let i=await fetch(r,{signal:n});if(!i.ok){self.postMessage({type:"error",message:`Fetch failed: ${i.status} ${i.statusText}`});return}if(!i.body){self.postMessage({type:"error",message:"Response has no body"});return}let A=i.headers.get("content-length");o=A?Number.parseInt(A,10):null,l.setTotalBytes(o);let H=(t>0?i.body.pipeThrough(S(t)):i.body).getReader();while(!0){let{done:f,value:m}=await H.read();if(f)break;a+=m.length,self.postMessage({type:"progress",bytesReceived:a,totalBytes:o});let U=s.length>0?x(s,m):m,g=b(U,p);if(s=g.leftover,g.head!=null&&!l.hasConfiguredDecoder)await l.configure(g.head,"opus");for(let E of g.packets)l.decodePacket(E,c),c+=1}if(s.length>0){let f=b(s,p);if(f.leftover.length>0)throw Error("Framed raw Opus stream ended with a partial packet");if(f.head!=null&&!l.hasConfiguredDecoder)await l.configure(f.head,"opus");for(let m of f.packets)l.decodePacket(m,c),c+=1}if(l.hasConfiguredDecoder&&l.hasDecodedPackets)await l.flush();else{self.postMessage({type:"error",message:"No framed raw Opus packets found in the stream"});return}e.postMessage({type:"bufferEnd",data:{totalLength:l.samplesDecoded}}),self.postMessage({type:"done",samplesDecoded:l.samplesDecoded,sampleRate:d,channels:l.channels})}catch(i){if(i instanceof DOMException&&i.name==="AbortError")self.postMessage({type:"aborted"});else self.postMessage({type:"error",message:i instanceof Error?i.message:String(i)})}finally{l.close(),e.close()}}

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

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

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

@@ -0,0 +1,97 @@
+// WebM Opus Decode Worker — runs fetch → WebM/Matroska demux → AudioDecoder off the main thread.
+// Uses the local incremental parser to extract Opus packets and feeds them into WebCodecs.
+import { OPUS_SAMPLE_RATE, StreamingOpusDecoder } from "./opus-worker-common.js";
+import { appendWebmOpusBytes, createWebmOpusParserState, } from "./webm-opus-parser.js";
+import { createThrottleStream } from "./worker-utils.js";
+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;
+    const parserState = createWebmOpusParserState();
+    const streamDecoder = new StreamingOpusDecoder({
+        processorPort,
+        targetSampleRate,
+        postMessage: (message) => self.postMessage(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;
+        streamDecoder.setTotalBytes(totalBytes);
+        const body = throttle > 0
+            ? response.body.pipeThrough(createThrottleStream(throttle))
+            : response.body;
+        const reader = body.getReader();
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            bytesReceived += value.length;
+            self.postMessage({ type: "progress", bytesReceived, totalBytes });
+            const parsed = appendWebmOpusBytes(value, parserState);
+            if (parsed.head != null && !streamDecoder.hasConfiguredDecoder) {
+                await streamDecoder.configure(parsed.head, "opus");
+            }
+            for (const packet of parsed.packets) {
+                streamDecoder.decodePacket(packet.packet, packet.timestampUs);
+            }
+        }
+        if (streamDecoder.hasConfiguredDecoder && streamDecoder.hasDecodedPackets) {
+            await streamDecoder.flush();
+        }
+        else {
+            self.postMessage({
+                type: "error",
+                message: "No WebM Opus packets found in the stream",
+            });
+            return;
+        }
+        processorPort.postMessage({
+            type: "bufferEnd",
+            data: { totalLength: streamDecoder.samplesDecoded },
+        });
+        self.postMessage({
+            type: "done",
+            samplesDecoded: streamDecoder.samplesDecoded,
+            sampleRate: OPUS_SAMPLE_RATE,
+            channels: streamDecoder.channels,
+        });
+    }
+    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 {
+        streamDecoder.close();
+        processorPort.close();
+    }
+}

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

@@ -0,0 +1 @@
+var N=128000;function y({totalBytes:e,bitrate:r,sourceSampleRate:u,targetSampleRate:n}){if(e==null||e<=0)return null;if(u<=0||n<=0)return null;let t=r!=null&&Number.isFinite(r)&&r>0?r:N,a=e*8/t;if(!Number.isFinite(a)||a<=0)return null;let c=Math.ceil(a*n);return Number.isFinite(c)&&c>0?c:null}function v(e,r,u){if(r===u)return e;let n=r/u,t=Math.round(e.length/n),a=new Float32Array(t);for(let c=0;c<t;c++){let l=c*n,s=Math.floor(l),o=l-s,i=e[s]??0,h=e[Math.min(s+1,e.length-1)]??0;a[c]=i+o*(h-i)}return a}function W(e){let r=0,u=performance.now();return new TransformStream({async transform(n,t){r+=n.length;let a=(performance.now()-u)/1000,l=r/e-a;if(l>0)await new Promise((s)=>setTimeout(s,l*1000));t.enqueue(n)}})}var m=48000,M=new TextDecoder;function B(e){if(e.length<19)return null;if(M.decode(e.slice(0,8))!=="OpusHead")return null;let u=e[9]??0,n=(e[10]??0)|(e[11]??0)<<8;return{channels:u,preSkip:n,description:e}}function k(e){let r=new Uint8Array(19);return r.set(new TextEncoder().encode("OpusHead"),0),r[8]=1,r[9]=e,{channels:e,preSkip:0,description:r}}class d{processorPort;targetSampleRate;postMessage;decoder;totalBytes=null;samplesDecodedCount=0;didSendMeta=!1;initialized=!1;configured=!1;decodedAnyPacket=!1;streamChannels=2;preSkipSourceSamples=0;preSkipTargetSamples=0;samplesSkipped=0;allowTimestampProbe=!1;preSkipProbeDone=!1;shouldApplyPreSkip=!0;lastConfig=null;constructor({processorPort:e,targetSampleRate:r,postMessage:u}){this.processorPort=e,this.targetSampleRate=r,this.postMessage=u,this.decoder=new AudioDecoder({output:this.handleOutput,error:(n)=>{this.postMessage({type:"error",message:this.lastConfig==null?n.message:`${n.message} (${JSON.stringify({configured:this.configured,decodedAnyPacket:this.decodedAnyPacket,config:this.lastConfig})})`})}})}setTotalBytes(e){this.totalBytes=e}async configure(e,r){if(e.channels<=0)throw Error("Opus stream contains invalid channel count");this.streamChannels=e.channels,this.preSkipSourceSamples=e.preSkip;let u=this.targetSampleRate>0?this.targetSampleRate:m;this.preSkipTargetSamples=Math.round(this.preSkipSourceSamples/m*u),this.allowTimestampProbe=r==="ogg",this.preSkipProbeDone=!1,this.shouldApplyPreSkip=!0;let n={codec:"opus",sampleRate:m,numberOfChannels:e.channels,description:e.description};if(this.lastConfig={codec:n.codec,sampleRate:n.sampleRate,numberOfChannels:n.numberOfChannels,descriptionLength:e.description.length},!(await AudioDecoder.isConfigSupported(n)).supported)throw Error(`Unsupported Opus decoder config: ${JSON.stringify({codec:n.codec,sampleRate:n.sampleRate,numberOfChannels:n.numberOfChannels,descriptionLength:e.description.length})}`);this.decoder.configure(n),this.configured=!0}decodePacket(e,r){if(!this.configured)throw Error("Decoder is not configured for Opus stream");this.decoder.decode(new EncodedAudioChunk({type:"key",timestamp:r,data:e})),this.decodedAnyPacket=!0}async flush(){await this.decoder.flush()}close(){try{this.decoder.close()}catch{}}get samplesDecoded(){return this.samplesDecodedCount}get channels(){return this.streamChannels}get hasConfiguredDecoder(){return this.configured}get hasDecodedPackets(){return this.decodedAnyPacket}handleOutput=(e)=>{let{numberOfFrames:r,numberOfChannels:u,sampleRate:n}=e,t=this.targetSampleRate>0?this.targetSampleRate:n;if(this.allowTimestampProbe&&!this.preSkipProbeDone){let l=Math.round(this.preSkipSourceSamples/m*1e6);if(e.timestamp>=l&&l>0)this.shouldApplyPreSkip=!1;this.preSkipProbeDone=!0}let a=[];for(let l=0;l<u;l++){let s=new Float32Array(r);e.copyTo(s,{planeIndex:l,format:"f32-planar"}),a.push(v(s,n,t))}e.close();let c=a[0]?.length??0;if(this.shouldApplyPreSkip&&this.samplesSkipped<this.preSkipTargetSamples&&c>0){let l=Math.min(this.preSkipTargetSamples-this.samplesSkipped,c);if(this.samplesSkipped+=l,l===c)return;for(let s=0;s<a.length;s++)a[s]=a[s].subarray(l);c=a[0]?.length??0}if(!this.didSendMeta){this.didSendMeta=!0;let l=y({totalBytes:this.totalBytes,bitrate:null,sourceSampleRate:m,targetSampleRate:t});this.postMessage({type:"streamMeta",estimatedTotalSamples:l,sampleRate:t,channels:u,isEstimate:!0})}if(!this.initialized){this.initialized=!0;let l=y({totalBytes:this.totalBytes,bitrate:null,sourceSampleRate:m,targetSampleRate:t});this.processorPort.postMessage({type:"bufferInit",data:{channels:u,totalLength:l??0,streaming:!0}}),this.postMessage({type:"info",sampleRate:n,channels:u})}if(c>0)this.processorPort.postMessage({type:"bufferRange",data:{startSample:this.samplesDecodedCount,channelData:a}}),this.samplesDecodedCount+=c,this.postMessage({type:"decoded",samplesDecoded:this.samplesDecodedCount})}}var g=new Uint8Array(0),P=new TextDecoder,I=new TextDecoder("ascii"),C=new Map([[440786851,{name:"EBML",type:"m"}],[408125543,{name:"Segment",type:"m"}],[290298740,{name:"SeekHead",type:"m"}],[357149030,{name:"Info",type:"m"}],[374648427,{name:"Tracks",type:"m"}],[524531317,{name:"Cluster",type:"m"}],[475249515,{name:"Cues",type:"m"}],[174,{name:"TrackEntry",type:"m"}],[225,{name:"Audio",type:"m"}],[2807729,{name:"TimestampScale",type:"u"}],[231,{name:"Timestamp",type:"u"}],[215,{name:"TrackNumber",type:"u"}],[131,{name:"TrackType",type:"u"}],[134,{name:"CodecID",type:"s"}],[25506,{name:"CodecPrivate",type:"b"}],[22186,{name:"CodecDelay",type:"u"}],[159,{name:"Channels",type:"u"}],[163,{name:"SimpleBlock",type:"b"}],[161,{name:"Block",type:"b"}]]);function E(){return{timestampScaleNs:1e6,clusterTimestamp:0,currentTrack:null,activeTrack:null,inAudio:!1,buffer:g,byteOffset:0,elementStack:[]}}function L(e,r){if(e.length===0)return r;if(r.length===0)return e;let u=new Uint8Array(e.length+r.length);return u.set(e,0),u.set(r,e.length),u}function f(e){return new Uint8Array(e.buffer.slice(e.byteOffset,e.byteOffset+e.byteLength))}function D(e,r){if(r>=e.length)return null;let u=e[r];if(u===0)return null;let n=1;while(n<=4&&(u&1<<8-n)===0)n+=1;if(n>4||r+n>e.length)return null;let t=0;for(let a=0;a<n;a++)t=t<<8|(e[r+a]??0);return{length:n,value:t}}function b(e,r,u=!1){if(r>=e.length)return null;let n=e[r];if(n===0)return null;let t=1;while(t<=8&&(n&1<<8-t)===0)t+=1;if(t>8||r+t>e.length)return null;let a=n&(1<<8-t)-1;for(let l=1;l<t;l++)a=a*256+(e[r+l]??0);let c=2**(7*t)-1;if(!u&&a===c)return{length:t,value:-1};if(u)a-=2**(7*t-1)-1;return{length:t,value:a}}function z(e){let r=0;for(let u of e)r=r*256+u;return r}function H(e,r){if(e.type==="u")return{name:e.name,type:e.type,value:z(r),data:r};if(e.type==="s")return{name:e.name,type:e.type,value:I.decode(r),data:r};if(e.type==="8")return{name:e.name,type:e.type,value:P.decode(r),data:r};return{name:e.name,type:e.type,data:r}}function O(e,r,u){while(e.elementStack.length>0){let n=e.elementStack[e.elementStack.length-1];if(!n)break;if(n.end==null||r<n.end)break;e.elementStack.pop(),u.push({name:n.name,type:"m",isEnd:!0,data:g})}}function V(e,r){if(r===0)return[f(e)];if(e.length===0)return[];let u=0,n=(e[u++]??0)+1,t=[];if(r===2){let c=Math.floor((e.length-u)/n);for(let l=0;l<n;l++)t.push(c);return t.map((l,s)=>{let o=u+s*l;return f(e.subarray(o,o+l))})}if(r===1){let c=0;for(let l=0;l<n-1;l++){let s=0;while(u<e.length){let o=e[u++]??0;if(s+=o,o!==255)break}t.push(s),c+=s}t.push(e.length-u-c)}else{let c=b(e,u,!1);if(!c)return[];u+=c.length,t.push(c.value);let l=c.value;for(let s=1;s<n-1;s++){let o=b(e,u,!0);if(!o)return[];u+=o.length;let i=(t[s-1]??0)+o.value;t.push(i),l+=i}t.push(e.length-u-l)}let a=[];for(let c of t)a.push(f(e.subarray(u,u+c))),u+=c;return a}function G(e){let r=b(e,0,!1);if(!r)throw Error("Invalid WebM block: missing track number");let u=r.length;if(e.length<u+3)throw Error("Invalid WebM block: truncated header");let n=(e[u]??0)<<8|(e[u+1]??0);if(n&32768)n-=65536;u+=2;let a=(e[u++]??0)>>1&3,c=V(e.subarray(u),a);return{trackNumber:r.value,timecode:n,frames:c}}function Y(e,r){r.buffer=L(r.buffer,e);let u=[],n=0;while(!0){O(r,r.byteOffset+n,u);let t=D(r.buffer,n);if(!t)break;let a=b(r.buffer,n+t.length,!1);if(!a)break;let c=t.length+a.length;if(r.buffer.length<n+c)break;let l=C.get(t.value)??{name:"unknown",type:"b"},s=a.value,o=r.byteOffset+n+c;if(n+=c,l.type==="m"){u.push({name:l.name,type:"m",isEnd:!1,data:g}),r.elementStack.push({name:l.name,end:s>=0?o+s:null});continue}if(s<0||r.buffer.length<n+s){n-=c;break}let i=f(r.buffer.subarray(n,n+s));u.push(H(l,i)),n+=s}return r.byteOffset+=n,r.buffer=f(r.buffer.subarray(n)),O(r,r.byteOffset,u),u}function $(e,r){let u=[],n=null;for(let t of e){if(t.type==="m"){if(!t.isEnd){if(t.name==="TrackEntry")r.currentTrack={};else if(t.name==="Audio")r.inAudio=!0}else if(t.name==="TrackEntry"){if(r.activeTrack==null&&r.currentTrack?.trackType===2&&r.currentTrack.codecId==="A_OPUS"&&r.currentTrack.trackNumber!=null){let a=r.currentTrack.channels??2,c=r.currentTrack.codecPrivate??null;r.activeTrack={trackNumber:r.currentTrack.trackNumber,channels:a,codecPrivate:c,codecDelayNs:r.currentTrack.codecDelayNs??0},n=c!=null?B(c)??k(a):k(a)}r.currentTrack=null}else if(t.name==="Audio")r.inAudio=!1;continue}if(t.name==="TimestampScale"||t.name==="TimecodeScale"){r.timestampScaleNs=t.value;continue}if(t.name==="Timestamp"||t.name==="Timecode"){r.clusterTimestamp=t.value;continue}if(r.currentTrack!=null)switch(t.name){case"TrackNumber":r.currentTrack.trackNumber=t.value;continue;case"TrackType":r.currentTrack.trackType=t.value;continue;case"CodecID":r.currentTrack.codecId=t.value;continue;case"CodecPrivate":r.currentTrack.codecPrivate=t.data;continue;case"CodecDelay":r.currentTrack.codecDelayNs=t.value;continue;case"Channels":if(r.inAudio)r.currentTrack.channels=t.value;continue}if(r.activeTrack!=null&&(t.name==="SimpleBlock"||t.name==="Block")){let a=G(t.data);if(a.trackNumber!==r.activeTrack.trackNumber)continue;let c=Math.max(0,Math.round(((r.clusterTimestamp+a.timecode)*r.timestampScaleNs-r.activeTrack.codecDelayNs)/1000));for(let l=0;l<a.frames.length;l++)u.push({packet:a.frames[l]??new Uint8Array(0),timestampUs:c+l})}}return{packets:u,head:n}}function S(e,r){return $(Y(e,r),r)}var T=null;self.onmessage=(e)=>{let{type:r}=e.data;if(r==="init"){let{port:u,url:n,throttle:t,targetSampleRate:a}=e.data;T=new AbortController,q(u,n,T.signal,t??0,a??0)}else if(r==="abort")T?.abort()};async function q(e,r,u,n,t){let a=null,c=0,l=E(),s=new d({processorPort:e,targetSampleRate:t,postMessage:(o)=>self.postMessage(o)});try{let o=await fetch(r,{signal:u});if(!o.ok){self.postMessage({type:"error",message:`Fetch failed: ${o.status} ${o.statusText}`});return}if(!o.body){self.postMessage({type:"error",message:"Response has no body"});return}let i=o.headers.get("content-length");a=i?Number.parseInt(i,10):null,s.setTotalBytes(a);let w=(n>0?o.body.pipeThrough(W(n)):o.body).getReader();while(!0){let{done:U,value:A}=await w.read();if(U)break;c+=A.length,self.postMessage({type:"progress",bytesReceived:c,totalBytes:a});let p=S(A,l);if(p.head!=null&&!s.hasConfiguredDecoder)await s.configure(p.head,"opus");for(let x of p.packets)s.decodePacket(x.packet,x.timestampUs)}if(s.hasConfiguredDecoder&&s.hasDecodedPackets)await s.flush();else{self.postMessage({type:"error",message:"No WebM Opus packets found in the stream"});return}e.postMessage({type:"bufferEnd",data:{totalLength:s.samplesDecoded}}),self.postMessage({type:"done",samplesDecoded:s.samplesDecoded,sampleRate:m,channels:s.channels})}catch(o){if(o instanceof DOMException&&o.name==="AbortError")self.postMessage({type:"aborted"});else self.postMessage({type:"error",message:o instanceof Error?o.message:String(o)})}finally{s.close(),e.close()}}

package/dist/workers/webm-opus-parser.d.ts

@@ -0,0 +1,49 @@
+import { type OpusHead } from "./opus-worker-common";
+export interface ParsedWebmOpusPacket {
+    packet: Uint8Array<ArrayBufferLike>;
+    timestampUs: number;
+}
+type ElementType = "m" | "u" | "s" | "8" | "b";
+export interface WebmElementDetail {
+    name: string;
+    type: ElementType;
+    isEnd?: boolean;
+    value?: number | string;
+    data: Uint8Array<ArrayBufferLike>;
+}
+interface PartialTrackInfo {
+    trackNumber?: number;
+    trackType?: number;
+    codecId?: string;
+    codecPrivate?: Uint8Array<ArrayBufferLike> | null;
+    channels?: number;
+    codecDelayNs?: number;
+}
+interface WebmOpusTrackInfo {
+    trackNumber: number;
+    channels: number;
+    codecPrivate: Uint8Array<ArrayBufferLike> | null;
+    codecDelayNs: number;
+}
+interface ParserStackEntry {
+    name: string;
+    end: number | null;
+}
+export interface WebmOpusParserState {
+    timestampScaleNs: number;
+    clusterTimestamp: number;
+    currentTrack: PartialTrackInfo | null;
+    activeTrack: WebmOpusTrackInfo | null;
+    inAudio: boolean;
+    buffer: Uint8Array<ArrayBufferLike>;
+    byteOffset: number;
+    elementStack: ParserStackEntry[];
+}
+export interface WebmOpusParseResult {
+    packets: ParsedWebmOpusPacket[];
+    head: OpusHead | null;
+}
+export declare function createWebmOpusParserState(): WebmOpusParserState;
+export declare function processWebmOpusElements(elements: WebmElementDetail[], state: WebmOpusParserState): WebmOpusParseResult;
+export declare function appendWebmOpusBytes(chunk: Uint8Array<ArrayBufferLike>, state: WebmOpusParserState): WebmOpusParseResult;
+export {};