@flighthq/audio 0.1.0 → 0.2.0

package/dist/audioFormat.d.ts

@@ -1,2 +1,4 @@
-export declare function inferAudioType(url: string): string | null;
+export declare function canPlayAudioType(mimeType: string): boolean;
+export declare function detectAudioMimeType(data: ArrayBuffer | Uint8Array): string | null;
+export declare function inferAudioMimeType(url: string): string | null;
 //# sourceMappingURL=audioFormat.d.ts.map

package/dist/audioFormat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audioFormat.d.ts","sourceRoot":"","sources":["../src/audioFormat.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoBzD"}
+{"version":3,"file":"audioFormat.d.ts","sourceRoot":"","sources":["../src/audioFormat.ts"],"names":[],"mappings":"AAEA,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAG1D;AAKD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,UAAU,GAAG,MAAM,GAAG,IAAI,CAmCjF;AAID,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoB7D"}

package/dist/audioFormat.js

@@ -1,4 +1,50 @@
-export function inferAudioType(url) {
+// Reports whether the current environment can play a given MIME type, by probing an <audio> element's
+// canPlayType. Returns false for the empty string and for any type the browser reports it cannot play.
+export function canPlayAudioType(mimeType) {
+    if (mimeType === '')
+        return false;
+    return new Audio().canPlayType(mimeType) !== '';
+}
+// Sniffs the container MIME type from a buffer's leading magic bytes, or null when unrecognized.
+// Mirrors detectImageMimeType. Covers wav, flac, ogg, mp3 (ID3 or MPEG frame sync), m4a/aac
+// (ISO-BMFF ftyp), and webm (EBML).
+export function detectAudioMimeType(data) {
+    const b = data instanceof Uint8Array ? data : new Uint8Array(data);
+    if (b.byteLength < 4)
+        return null;
+    // WAV: 'RIFF' (0-3) .... 'WAVE' (8-11)
+    if (b.byteLength >= 12 &&
+        b[0] === 0x52 &&
+        b[1] === 0x49 &&
+        b[2] === 0x46 &&
+        b[3] === 0x46 &&
+        b[8] === 0x57 &&
+        b[9] === 0x41 &&
+        b[10] === 0x56 &&
+        b[11] === 0x45)
+        return 'audio/wav';
+    // FLAC: 'fLaC'
+    if (b[0] === 0x66 && b[1] === 0x4c && b[2] === 0x61 && b[3] === 0x43)
+        return 'audio/flac';
+    // Ogg: 'OggS'
+    if (b[0] === 0x4f && b[1] === 0x67 && b[2] === 0x67 && b[3] === 0x53)
+        return 'audio/ogg';
+    // MP3: 'ID3' tag prefix, or an MPEG audio frame sync (11 set bits: 0xFF followed by 0xE0-mask).
+    if (b[0] === 0x49 && b[1] === 0x44 && b[2] === 0x33)
+        return 'audio/mpeg';
+    if (b[0] === 0xff && (b[1] & 0xe0) === 0xe0)
+        return 'audio/mpeg';
+    // M4A / AAC (ISO base media): a box-size prefix (0-3) followed by 'ftyp' (4-7).
+    if (b.byteLength >= 8 && b[4] === 0x66 && b[5] === 0x74 && b[6] === 0x79 && b[7] === 0x70)
+        return 'audio/mp4';
+    // WebM / Matroska (EBML): 1A 45 DF A3
+    if (b[0] === 0x1a && b[1] === 0x45 && b[2] === 0xdf && b[3] === 0xa3)
+        return 'audio/webm';
+    return null;
+}
+// Infers the MIME type from a URL's file extension, or null when unrecognized. Extension-based; use
+// detectAudioMimeType when the bytes are in hand.
+export function inferAudioMimeType(url) {
     const ext = url.split('?')[0].split('.').pop()?.toLowerCase();
     switch (ext) {
         case 'mp3':

package/dist/audioFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"audioFormat.js","sourceRoot":"","sources":["../src/audioFormat.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,CAAC;IAC9D,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,KAAK;YACR,OAAO,YAAY,CAAC;QACtB,KAAK,KAAK;YACR,OAAO,WAAW,CAAC;QACrB,KAAK,KAAK;YACR,OAAO,WAAW,CAAC;QACrB,KAAK,KAAK;YACR,OAAO,WAAW,CAAC;QACrB,KAAK,MAAM;YACT,OAAO,YAAY,CAAC;QACtB,KAAK,MAAM;YACT,OAAO,YAAY,CAAC;QACtB,KAAK,KAAK;YACR,OAAO,WAAW,CAAC;QACrB;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}
+{"version":3,"file":"audioFormat.js","sourceRoot":"","sources":["../src/audioFormat.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,uGAAuG;AACvG,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,IAAI,QAAQ,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IAClC,OAAO,IAAI,KAAK,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;AAClD,CAAC;AAED,iGAAiG;AACjG,4FAA4F;AAC5F,oCAAoC;AACpC,MAAM,UAAU,mBAAmB,CAAC,IAA8B;IAChE,MAAM,CAAC,GAAG,IAAI,YAAY,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IACnE,IAAI,CAAC,CAAC,UAAU,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAElC,uCAAuC;IACvC,IACE,CAAC,CAAC,UAAU,IAAI,EAAE;QAClB,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;QACb,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;QACb,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;QACb,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;QACb,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;QACb,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;QACb,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI;QACd,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI;QAEd,OAAO,WAAW,CAAC;IAErB,eAAe;IACf,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,YAAY,CAAC;IAE1F,cAAc;IACd,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,WAAW,CAAC;IAEzF,gGAAgG;IAChG,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,YAAY,CAAC;IACzE,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,YAAY,CAAC;IAEjE,gFAAgF;IAChF,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,WAAW,CAAC;IAE9G,sCAAsC;IACtC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,YAAY,CAAC;IAE1F,OAAO,IAAI,CAAC;AACd,CAAC;AAED,oGAAoG;AACpG,kDAAkD;AAClD,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,CAAC;IAC9D,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,KAAK;YACR,OAAO,YAAY,CAAC;QACtB,KAAK,KAAK;YACR,OAAO,WAAW,CAAC;QACrB,KAAK,KAAK;YACR,OAAO,WAAW,CAAC;QACrB,KAAK,KAAK;YACR,OAAO,WAAW,CAAC;QACrB,KAAK,MAAM;YACT,OAAO,YAAY,CAAC;QACtB,KAAK,MAAM;YACT,OAAO,YAAY,CAAC;QACtB,KAAK,KAAK;YACR,OAAO,WAAW,CAAC;QACrB;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/audioResource.d.ts

@@ -1,3 +1,12 @@
 import type { AudioResource } from '@flighthq/types';
+export declare function cloneAudioResource(resource: Readonly<AudioResource>): AudioResource;
 export declare function createAudioResource(buffer?: AudioBuffer): AudioResource;
+export declare function disposeAudioResource(resource: AudioResource): void;
+export declare function getAudioResourceByteSize(resource: Readonly<AudioResource>): number;
+export declare function getAudioResourceChannelCount(resource: Readonly<AudioResource>): number;
+export declare function getAudioResourceChannelData(resource: Readonly<AudioResource>, channel: number): Float32Array | null;
+export declare function getAudioResourceDuration(resource: Readonly<AudioResource>): number;
+export declare function getAudioResourceSampleRate(resource: Readonly<AudioResource>): number;
+export declare function hasAudioResourceBuffer(resource: Readonly<AudioResource>): boolean;
+export declare function isAudioResourceEmpty(resource: Readonly<AudioResource>): boolean;
 //# sourceMappingURL=audioResource.d.ts.map

package/dist/audioResource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audioResource.d.ts","sourceRoot":"","sources":["../src/audioResource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,aAAa,CAEvE"}
+{"version":3,"file":"audioResource.d.ts","sourceRoot":"","sources":["../src/audioResource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAMrD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,aAAa,CAEnF;AAED,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,aAAa,CAEvE;AAID,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAElE;AAID,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,MAAM,CAGlF;AAED,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,MAAM,CAEtF;AAKD,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAInH;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,MAAM,CAElF;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,MAAM,CAEpF;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,OAAO,CAEjF;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,OAAO,CAE/E"}

package/dist/audioResource.js

@@ -1,4 +1,46 @@
+// Allocates a new resource identity over the SAME underlying AudioBuffer. The buffer is shared by
+// reference, not duplicated — clone gives an independent resource object over the same decoded PCM,
+// e.g. to hand one decoded sound to two playback subsystems. Use createAudioResourceFromSamples with
+// copied channel data when you need the samples themselves duplicated.
+export function cloneAudioResource(resource) {
+    return { buffer: resource.buffer };
+}
 export function createAudioResource(buffer) {
     return { buffer: buffer ?? null };
 }
+// Releases the decoded AudioBuffer reference so it becomes eligible for GC. The AudioBuffer is plain
+// GC-managed memory with no GPU/native handle to free, so this is dispose*, not destroy*.
+export function disposeAudioResource(resource) {
+    resource.buffer = null;
+}
+// Returns the byte footprint of the decoded PCM: channels × length × 4 (Float32 samples). Returns 0
+// when there is no buffer. Mirrors getImageResourceByteSize (width × height × 4).
+export function getAudioResourceByteSize(resource) {
+    const buffer = resource.buffer;
+    return buffer !== null ? buffer.numberOfChannels * buffer.length * 4 : 0;
+}
+export function getAudioResourceChannelCount(resource) {
+    return resource.buffer !== null ? resource.buffer.numberOfChannels : 0;
+}
+// Returns the Float32 samples for one channel by reference (Web Audio's getChannelData contract), or
+// null when there is no buffer or the channel index is out of range. Mutating the returned array
+// mutates the decoded buffer in place.
+export function getAudioResourceChannelData(resource, channel) {
+    const buffer = resource.buffer;
+    if (buffer === null || channel < 0 || channel >= buffer.numberOfChannels)
+        return null;
+    return buffer.getChannelData(channel);
+}
+export function getAudioResourceDuration(resource) {
+    return resource.buffer !== null ? resource.buffer.duration : 0;
+}
+export function getAudioResourceSampleRate(resource) {
+    return resource.buffer !== null ? resource.buffer.sampleRate : 0;
+}
+export function hasAudioResourceBuffer(resource) {
+    return resource.buffer !== null;
+}
+export function isAudioResourceEmpty(resource) {
+    return resource.buffer === null || resource.buffer.length === 0;
+}
 //# sourceMappingURL=audioResource.js.map

package/dist/audioResource.js.map

@@ -1 +1 @@
-{"version":3,"file":"audioResource.js","sourceRoot":"","sources":["../src/audioResource.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,mBAAmB,CAAC,MAAoB;IACtD,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,IAAI,EAAE,CAAC;AACpC,CAAC"}
+{"version":3,"file":"audioResource.js","sourceRoot":"","sources":["../src/audioResource.ts"],"names":[],"mappings":"AAEA,kGAAkG;AAClG,oGAAoG;AACpG,qGAAqG;AACrG,uEAAuE;AACvE,MAAM,UAAU,kBAAkB,CAAC,QAAiC;IAClE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAoB;IACtD,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,IAAI,EAAE,CAAC;AACpC,CAAC;AAED,qGAAqG;AACrG,0FAA0F;AAC1F,MAAM,UAAU,oBAAoB,CAAC,QAAuB;IAC1D,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC;AACzB,CAAC;AAED,oGAAoG;AACpG,kFAAkF;AAClF,MAAM,UAAU,wBAAwB,CAAC,QAAiC;IACxE,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;IAC/B,OAAO,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,QAAiC;IAC5E,OAAO,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,qGAAqG;AACrG,iGAAiG;AACjG,uCAAuC;AACvC,MAAM,UAAU,2BAA2B,CAAC,QAAiC,EAAE,OAAe;IAC5F,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;IAC/B,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,GAAG,CAAC,IAAI,OAAO,IAAI,MAAM,CAAC,gBAAgB;QAAE,OAAO,IAAI,CAAC;IACtF,OAAO,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,QAAiC;IACxE,OAAO,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,QAAiC;IAC1E,OAAO,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAiC;IACtE,OAAO,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAiC;IACpE,OAAO,QAAQ,CAAC,MAAM,KAAK,IAAI,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC;AAClE,CAAC"}

package/dist/audioResourceFrom.d.ts

@@ -1,4 +1,9 @@
 import type { AudioResource, AudioResourceUrl } from '@flighthq/types';
+export declare function createAudioResourceFromSamples(channels: readonly Float32Array[], sampleRate: number): AudioResource;
+export declare function loadAudioResourceFromBase64(context: AudioContext, base64: string, mimeType: string, signal?: AbortSignal): Promise<AudioResource>;
+export declare function loadAudioResourceFromBlob(context: AudioContext, blob: Blob, signal?: AbortSignal): Promise<AudioResource>;
+export declare function loadAudioResourceFromBytes(context: AudioContext, bytes: Uint8Array, mimeType?: string, signal?: AbortSignal): Promise<AudioResource>;
 export declare function loadAudioResourceFromUrl(context: AudioContext, url: string, signal?: AbortSignal): Promise<AudioResource>;
-export declare function loadAudioResourceFromUrls(context: AudioContext, sources: AudioResourceUrl[], signal?: AbortSignal): Promise<AudioResource>;
+export declare function loadAudioResourceFromUrls(context: AudioContext, sources: readonly AudioResourceUrl[], signal?: AbortSignal): Promise<AudioResource>;
+export declare function selectAudioResourceUrl(sources: readonly AudioResourceUrl[]): string | null;
 //# sourceMappingURL=audioResourceFrom.d.ts.map

package/dist/audioResourceFrom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audioResourceFrom.d.ts","sourceRoot":"","sources":["../src/audioResourceFrom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAKvE,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,YAAY,EACrB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAKxB;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,gBAAgB,EAAE,EAC3B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAKxB"}
+{"version":3,"file":"audioResourceFrom.d.ts","sourceRoot":"","sources":["../src/audioResourceFrom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AASvE,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,aAAa,CAUnH;AAID,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAKxB;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,IAAI,EACV,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAGxB;AAKD,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,UAAU,EACjB,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAKxB;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,YAAY,EACrB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CASxB;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,SAAS,gBAAgB,EAAE,EACpC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAIxB;AAID,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,GAAG,MAAM,GAAG,IAAI,CAM1F"}

package/dist/audioResourceFrom.js

@@ -1,16 +1,62 @@
-import { inferAudioType } from './audioFormat';
+import { canPlayAudioType, inferAudioMimeType } from './audioFormat';
 import { createAudioResource } from './audioResource';
+// Builds a resource from raw PCM channel data without needing an AudioContext. Each entry in
+// `channels` holds one channel's Float32 samples; all are expected to share the first channel's
+// length. Uses the AudioBuffer constructor (not context.createBuffer) so it works off the audio
+// thread. Returns a null-buffer resource for empty or zero-length input.
+export function createAudioResourceFromSamples(channels, sampleRate) {
+    const numberOfChannels = channels.length;
+    const length = numberOfChannels > 0 ? channels[0].length : 0;
+    if (numberOfChannels === 0 || length === 0)
+        return createAudioResource();
+    const buffer = new AudioBuffer({ length, numberOfChannels, sampleRate });
+    for (let channel = 0; channel < numberOfChannels; channel++) {
+        // Narrow the widened ArrayBufferLike backing to the ArrayBuffer that copyToChannel requires.
+        buffer.copyToChannel(channels[channel], channel);
+    }
+    return createAudioResource(buffer);
+}
+// Web Audio's decodeAudioData content-sniffs the container, so `mimeType` is advisory here (threaded
+// for loader-family symmetry and non-web backends); the decoder ignores it.
+export async function loadAudioResourceFromBase64(context, base64, mimeType, signal) {
+    const binary = atob(base64);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++)
+        bytes[i] = binary.charCodeAt(i);
+    return loadAudioResourceFromBytes(context, bytes, mimeType, signal);
+}
+export async function loadAudioResourceFromBlob(context, blob, signal) {
+    const arrayBuffer = await blob.arrayBuffer();
+    return loadAudioResourceFromBytes(context, new Uint8Array(arrayBuffer), blob.type || undefined, signal);
+}
+// Decodes encoded audio bytes into a resource. Copies the viewed region into a fresh ArrayBuffer
+// before decoding so the caller's Uint8Array is not detached by decodeAudioData. `mimeType` is
+// advisory (see loadAudioResourceFromBase64): decodeAudioData sniffs the container itself.
+export async function loadAudioResourceFromBytes(context, bytes, mimeType, signal) {
+    signal?.throwIfAborted();
+    const buffer = bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
+    const audioBuffer = await context.decodeAudioData(buffer);
+    return createAudioResource(audioBuffer);
+}
 export async function loadAudioResourceFromUrl(context, url, signal) {
     const response = await fetch(url, { signal });
     const arrayBuffer = await response.arrayBuffer();
-    const audioBuffer = await context.decodeAudioData(arrayBuffer);
-    return createAudioResource(audioBuffer);
+    return loadAudioResourceFromBytes(context, new Uint8Array(arrayBuffer), response.headers.get('content-type') ?? undefined, signal);
 }
 export async function loadAudioResourceFromUrls(context, sources, signal) {
-    const probe = new Audio();
-    const selected = sources.find(({ url, type }) => probe.canPlayType(type ?? inferAudioType(url) ?? '') !== '');
-    if (selected === undefined)
+    const selected = selectAudioResourceUrl(sources);
+    if (selected === null)
         return createAudioResource();
-    return loadAudioResourceFromUrl(context, selected.url, signal);
+    return loadAudioResourceFromUrl(context, selected, signal);
+}
+// Picks the first source URL the environment can play, or null when none is playable. A source's
+// explicit `type` wins; otherwise the MIME type is inferred from the URL extension.
+export function selectAudioResourceUrl(sources) {
+    for (const source of sources) {
+        const type = source.type ?? inferAudioMimeType(source.url) ?? '';
+        if (canPlayAudioType(type))
+            return source.url;
+    }
+    return null;
 }
 //# sourceMappingURL=audioResourceFrom.js.map

package/dist/audioResourceFrom.js.map

@@ -1 +1 @@
-{"version":3,"file":"audioResourceFrom.js","sourceRoot":"","sources":["../src/audioResourceFrom.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtD,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,OAAqB,EACrB,GAAW,EACX,MAAoB;IAEpB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;IACjD,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;IAC/D,OAAO,mBAAmB,CAAC,WAAW,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,OAAqB,EACrB,OAA2B,EAC3B,MAAoB;IAEpB,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC;IAC1B,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;IAC9G,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,mBAAmB,EAAE,CAAC;IACzD,OAAO,wBAAwB,CAAC,OAAO,EAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AACjE,CAAC"}
+{"version":3,"file":"audioResourceFrom.js","sourceRoot":"","sources":["../src/audioResourceFrom.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,11 @@
 {
   "name": "@flighthq/audio",
-  "version": "0.1.0",
+  "version": "0.2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/flighthq/flight.git",
+    "directory": "packages/audio"
+  },
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -27,11 +32,11 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/types": "0.1.0"
+    "@flighthq/types": "0.2.0"
   },
   "devDependencies": {
     "typescript": "^5.3.0"
   },
-  "description": "Audio resources, URL constructors, and the shared audio context",
+  "description": "AudioResource lifecycle — create/clone/dispose, sample-tier and decoded-bytes constructors, URL/Blob/Base64 loaders, codec negotiation, and container MIME detection",
   "sideEffects": false
 }

package/src/audioFormat.test.ts

@@ -1,43 +1,115 @@
-import { inferAudioType } from './audioFormat';
+import { canPlayAudioType, detectAudioMimeType, inferAudioMimeType } from './audioFormat';
 
-describe('inferAudioType', () => {
+describe('canPlayAudioType', () => {
+  beforeEach(() => {
+    vi.spyOn(HTMLMediaElement.prototype, 'canPlayType').mockImplementation((type: string) =>
+      type === 'audio/mpeg' ? 'probably' : '',
+    );
+  });
+
+  afterEach(() => {
+    vi.restoreAllMocks();
+  });
+
+  it('returns false for the empty string without probing', () => {
+    expect(canPlayAudioType('')).toBe(false);
+  });
+
+  it('returns true for a type the element reports it can play', () => {
+    expect(canPlayAudioType('audio/mpeg')).toBe(true);
+  });
+
+  it('returns false for a type the element cannot play', () => {
+    expect(canPlayAudioType('audio/x-unknown')).toBe(false);
+  });
+});
+
+describe('detectAudioMimeType', () => {
+  it('returns null for a buffer that is too small', () => {
+    expect(detectAudioMimeType(new ArrayBuffer(3))).toBeNull();
+  });
+
+  it('returns null for an unrecognised header', () => {
+    expect(detectAudioMimeType(new Uint8Array([0x00, 0x01, 0x02, 0x03]))).toBeNull();
+  });
+
+  it('detects WAV (RIFF....WAVE)', () => {
+    const b = new Uint8Array(12);
+    b.set([0x52, 0x49, 0x46, 0x46], 0);
+    b.set([0x57, 0x41, 0x56, 0x45], 8);
+    expect(detectAudioMimeType(b)).toBe('audio/wav');
+  });
+
+  it('detects FLAC (fLaC)', () => {
+    expect(detectAudioMimeType(new Uint8Array([0x66, 0x4c, 0x61, 0x43]))).toBe('audio/flac');
+  });
+
+  it('detects Ogg (OggS)', () => {
+    expect(detectAudioMimeType(new Uint8Array([0x4f, 0x67, 0x67, 0x53]))).toBe('audio/ogg');
+  });
+
+  it('detects MP3 via an ID3 tag', () => {
+    expect(detectAudioMimeType(new Uint8Array([0x49, 0x44, 0x33, 0x04]))).toBe('audio/mpeg');
+  });
+
+  it('detects MP3 via an MPEG frame sync', () => {
+    expect(detectAudioMimeType(new Uint8Array([0xff, 0xfb, 0x90, 0x00]))).toBe('audio/mpeg');
+  });
+
+  it('detects M4A / AAC (ftyp box)', () => {
+    const b = new Uint8Array([0x00, 0x00, 0x00, 0x20, 0x66, 0x74, 0x79, 0x70]);
+    expect(detectAudioMimeType(b)).toBe('audio/mp4');
+  });
+
+  it('detects WebM (EBML)', () => {
+    expect(detectAudioMimeType(new Uint8Array([0x1a, 0x45, 0xdf, 0xa3]))).toBe('audio/webm');
+  });
+
+  it('accepts an ArrayBuffer as well as a Uint8Array', () => {
+    const buf = new ArrayBuffer(4);
+    new Uint8Array(buf).set([0x66, 0x4c, 0x61, 0x43]);
+    expect(detectAudioMimeType(buf)).toBe('audio/flac');
+  });
+});
+
+describe('inferAudioMimeType', () => {
   it('returns "audio/mpeg" for .mp3 files', () => {
-    expect(inferAudioType('track.mp3')).toBe('audio/mpeg');
+    expect(inferAudioMimeType('track.mp3')).toBe('audio/mpeg');
   });
 
   it('returns "audio/ogg" for .ogg files', () => {
-    expect(inferAudioType('track.ogg')).toBe('audio/ogg');
+    expect(inferAudioMimeType('track.ogg')).toBe('audio/ogg');
   });
 
   it('returns "audio/wav" for .wav files', () => {
-    expect(inferAudioType('track.wav')).toBe('audio/wav');
+    expect(inferAudioMimeType('track.wav')).toBe('audio/wav');
   });
 
   it('returns "audio/aac" for .aac files', () => {
-    expect(inferAudioType('track.aac')).toBe('audio/aac');
+    expect(inferAudioMimeType('track.aac')).toBe('audio/aac');
   });
 
   it('returns "audio/flac" for .flac files', () => {
-    expect(inferAudioType('track.flac')).toBe('audio/flac');
+    expect(inferAudioMimeType('track.flac')).toBe('audio/flac');
   });
 
   it('returns "audio/webm" for .webm files', () => {
-    expect(inferAudioType('track.webm')).toBe('audio/webm');
+    expect(inferAudioMimeType('track.webm')).toBe('audio/webm');
   });
 
   it('returns "audio/mp4" for .m4a files', () => {
-    expect(inferAudioType('track.m4a')).toBe('audio/mp4');
+    expect(inferAudioMimeType('track.m4a')).toBe('audio/mp4');
   });
 
   it('returns null for unrecognized extensions', () => {
-    expect(inferAudioType('track.mid')).toBeNull();
+    expect(inferAudioMimeType('track.mid')).toBeNull();
   });
 
   it('strips query parameters before matching', () => {
-    expect(inferAudioType('track.mp3?cb=1')).toBe('audio/mpeg');
+    expect(inferAudioMimeType('track.mp3?cb=1')).toBe('audio/mpeg');
   });
 
   it('returns null for a URL with no extension', () => {
-    expect(inferAudioType('audio')).toBeNull();
+    expect(inferAudioMimeType('audio')).toBeNull();
   });
 });

package/src/audioResource.test.ts

@@ -1,8 +1,130 @@
-import { createAudioResource } from './audioResource';
+import {
+  cloneAudioResource,
+  createAudioResource,
+  disposeAudioResource,
+  getAudioResourceByteSize,
+  getAudioResourceChannelCount,
+  getAudioResourceChannelData,
+  getAudioResourceDuration,
+  getAudioResourceSampleRate,
+  hasAudioResourceBuffer,
+  isAudioResourceEmpty,
+} from './audioResource';
+
+// jsdom has no AudioBuffer; the media package models it the same way — a plain cast carrying only the
+// fields under test (mirrors its createMockAudioBuffer helper).
+function createMockAudioBuffer(overrides: Partial<AudioBuffer> = {}): AudioBuffer {
+  const length = 100;
+  const numberOfChannels = 2;
+  const sampleRate = 44100;
+  const channels = [new Float32Array(length), new Float32Array(length)];
+  return {
+    duration: length / sampleRate,
+    getChannelData: (channel: number) => channels[channel],
+    length,
+    numberOfChannels,
+    sampleRate,
+    ...overrides,
+  } as unknown as AudioBuffer;
+}
+
+describe('cloneAudioResource', () => {
+  it('shares the buffer by reference and gives an independent resource identity', () => {
+    const buffer = createMockAudioBuffer();
+    const resource = createAudioResource(buffer);
+
+    const copy = cloneAudioResource(resource);
+
+    expect(copy).not.toBe(resource);
+    expect(copy.buffer).toBe(buffer);
+  });
+
+  it('copies a null buffer', () => {
+    expect(cloneAudioResource(createAudioResource()).buffer).toBeNull();
+  });
+});
 
 describe('createAudioResource', () => {
   it('returns a resource with null buffer when called with no arguments', () => {
-    const resource = createAudioResource();
+    expect(createAudioResource().buffer).toBeNull();
+  });
+
+  it('wraps a provided buffer', () => {
+    const buffer = createMockAudioBuffer();
+    expect(createAudioResource(buffer).buffer).toBe(buffer);
+  });
+});
+
+describe('disposeAudioResource', () => {
+  it('releases the buffer reference', () => {
+    const resource = createAudioResource(createMockAudioBuffer());
+    disposeAudioResource(resource);
     expect(resource.buffer).toBeNull();
   });
 });
+
+describe('getAudioResourceByteSize', () => {
+  it('returns 0 when there is no buffer', () => {
+    expect(getAudioResourceByteSize(createAudioResource())).toBe(0);
+  });
+
+  it('returns channels × length × 4 for Float32 PCM', () => {
+    const resource = createAudioResource(createMockAudioBuffer());
+    expect(getAudioResourceByteSize(resource)).toBe(2 * 100 * 4);
+  });
+});
+
+describe('getAudioResourceChannelCount', () => {
+  it('returns 0 without a buffer and the channel count with one', () => {
+    expect(getAudioResourceChannelCount(createAudioResource())).toBe(0);
+    expect(getAudioResourceChannelCount(createAudioResource(createMockAudioBuffer()))).toBe(2);
+  });
+});
+
+describe('getAudioResourceChannelData', () => {
+  it('returns the Float32Array for an in-range channel', () => {
+    const resource = createAudioResource(createMockAudioBuffer());
+    const data = getAudioResourceChannelData(resource, 1);
+    expect(data).toBeInstanceOf(Float32Array);
+    expect(data?.length).toBe(100);
+  });
+
+  it('returns null without a buffer or for an out-of-range channel', () => {
+    expect(getAudioResourceChannelData(createAudioResource(), 0)).toBeNull();
+    const resource = createAudioResource(createMockAudioBuffer());
+    expect(getAudioResourceChannelData(resource, -1)).toBeNull();
+    expect(getAudioResourceChannelData(resource, 2)).toBeNull();
+  });
+});
+
+describe('getAudioResourceDuration', () => {
+  it('returns 0 without a buffer and the buffer duration with one', () => {
+    expect(getAudioResourceDuration(createAudioResource())).toBe(0);
+    expect(getAudioResourceDuration(createAudioResource(createMockAudioBuffer({ duration: 2.5 })))).toBe(2.5);
+  });
+});
+
+describe('getAudioResourceSampleRate', () => {
+  it('returns 0 without a buffer and the sample rate with one', () => {
+    expect(getAudioResourceSampleRate(createAudioResource())).toBe(0);
+    expect(getAudioResourceSampleRate(createAudioResource(createMockAudioBuffer()))).toBe(44100);
+  });
+});
+
+describe('hasAudioResourceBuffer', () => {
+  it('is false without a buffer and true with one', () => {
+    expect(hasAudioResourceBuffer(createAudioResource())).toBe(false);
+    expect(hasAudioResourceBuffer(createAudioResource(createMockAudioBuffer()))).toBe(true);
+  });
+});
+
+describe('isAudioResourceEmpty', () => {
+  it('is true without a buffer', () => {
+    expect(isAudioResourceEmpty(createAudioResource())).toBe(true);
+  });
+
+  it('is true for a zero-length buffer and false once it has samples', () => {
+    expect(isAudioResourceEmpty(createAudioResource(createMockAudioBuffer({ length: 0 })))).toBe(true);
+    expect(isAudioResourceEmpty(createAudioResource(createMockAudioBuffer()))).toBe(false);
+  });
+});

package/src/audioResourceFrom.test.ts

@@ -1,20 +1,172 @@
-import { loadAudioResourceFromUrl, loadAudioResourceFromUrls } from './audioResourceFrom';
+import {
+  createAudioResourceFromSamples,
+  loadAudioResourceFromBase64,
+  loadAudioResourceFromBlob,
+  loadAudioResourceFromBytes,
+  loadAudioResourceFromUrl,
+  loadAudioResourceFromUrls,
+  selectAudioResourceUrl,
+} from './audioResourceFrom';
+
+const decodedBuffer = { duration: 1 } as AudioBuffer;
 
 const mockContext = {
-  decodeAudioData: vi.fn().mockResolvedValue({} as AudioBuffer),
+  decodeAudioData: vi.fn().mockResolvedValue(decodedBuffer),
 } as unknown as AudioContext;
 
+// jsdom lacks the AudioBuffer constructor; this minimal stand-in honours the { length,
+// numberOfChannels, sampleRate } constructor plus copyToChannel/getChannelData used by
+// createAudioResourceFromSamples.
+class MockAudioBuffer {
+  length: number;
+  numberOfChannels: number;
+  sampleRate: number;
+  private channels: Float32Array[];
+
+  constructor(options: { length: number; numberOfChannels: number; sampleRate: number }) {
+    this.length = options.length;
+    this.numberOfChannels = options.numberOfChannels;
+    this.sampleRate = options.sampleRate;
+    this.channels = Array.from({ length: options.numberOfChannels }, () => new Float32Array(options.length));
+  }
+
+  copyToChannel(source: Float32Array, channel: number): void {
+    this.channels[channel].set(source.subarray(0, this.length));
+  }
+
+  getChannelData(channel: number): Float32Array {
+    return this.channels[channel];
+  }
+}
+
+beforeEach(() => {
+  vi.stubGlobal('AudioBuffer', MockAudioBuffer);
+});
+
+afterEach(() => {
+  vi.unstubAllGlobals();
+  vi.restoreAllMocks();
+  (mockContext.decodeAudioData as ReturnType<typeof vi.fn>).mockClear();
+});
+
+describe('createAudioResourceFromSamples', () => {
+  it('builds a buffer from channel data and copies the samples', () => {
+    // Values exactly representable in Float32 so copyToChannel round-trips without precision drift.
+    const left = new Float32Array([0, 0.5, 0.25]);
+    const right = new Float32Array([0.75, -0.5, 0.25]);
+    const resource = createAudioResourceFromSamples([left, right], 48000);
+
+    expect(resource.buffer).not.toBeNull();
+    expect(resource.buffer?.numberOfChannels).toBe(2);
+    expect(resource.buffer?.length).toBe(3);
+    expect(resource.buffer?.sampleRate).toBe(48000);
+    expect(Array.from(resource.buffer!.getChannelData(1))).toEqual([0.75, -0.5, 0.25]);
+  });
+
+  it('returns a null-buffer resource for empty input', () => {
+    expect(createAudioResourceFromSamples([], 48000).buffer).toBeNull();
+  });
+
+  it('returns a null-buffer resource for zero-length channels', () => {
+    expect(createAudioResourceFromSamples([new Float32Array(0)], 48000).buffer).toBeNull();
+  });
+});
+
+describe('loadAudioResourceFromBase64', () => {
+  it('decodes base64-encoded bytes into a resource', async () => {
+    const resource = await loadAudioResourceFromBase64(mockContext, btoa('abc'), 'audio/mpeg');
+    expect(resource.buffer).toBe(decodedBuffer);
+    expect(mockContext.decodeAudioData).toHaveBeenCalledOnce();
+  });
+});
+
+describe('loadAudioResourceFromBlob', () => {
+  it('decodes a blob into a resource', async () => {
+    // jsdom's Blob does not implement arrayBuffer(); a minimal double supplies what the loader reads.
+    const blob = {
+      arrayBuffer: () => Promise.resolve(new Uint8Array([1, 2, 3, 4]).buffer),
+      type: 'audio/wav',
+    } as unknown as Blob;
+    const resource = await loadAudioResourceFromBlob(mockContext, blob);
+    expect(resource.buffer).toBe(decodedBuffer);
+    expect(mockContext.decodeAudioData).toHaveBeenCalledOnce();
+  });
+});
+
+describe('loadAudioResourceFromBytes', () => {
+  it('decodes bytes into a resource', async () => {
+    const resource = await loadAudioResourceFromBytes(mockContext, new Uint8Array([1, 2, 3, 4]));
+    expect(resource.buffer).toBe(decodedBuffer);
+  });
+
+  it('does not detach the caller’s Uint8Array', async () => {
+    const bytes = new Uint8Array([1, 2, 3, 4]);
+    await loadAudioResourceFromBytes(mockContext, bytes);
+    expect(bytes.byteLength).toBe(4);
+  });
+
+  it('rejects when the signal is already aborted', async () => {
+    const controller = new AbortController();
+    controller.abort(new Error('cancelled'));
+    await expect(
+      loadAudioResourceFromBytes(mockContext, new Uint8Array([1, 2, 3, 4]), undefined, controller.signal),
+    ).rejects.toThrow('cancelled');
+  });
+});
+
 describe('loadAudioResourceFromUrl', () => {
-  it('returns a Promise', () => {
-    const result = loadAudioResourceFromUrl(mockContext, 'test.mp3');
-    result.catch(() => {});
-    expect(result).toBeInstanceOf(Promise);
+  it('fetches, decodes, and returns a resource', async () => {
+    vi.stubGlobal(
+      'fetch',
+      vi.fn().mockResolvedValue({
+        arrayBuffer: () => Promise.resolve(new ArrayBuffer(8)),
+        headers: new Headers({ 'content-type': 'audio/mpeg' }),
+      }),
+    );
+    const resource = await loadAudioResourceFromUrl(mockContext, 'sound.mp3');
+    expect(resource.buffer).toBe(decodedBuffer);
   });
 });
 
 describe('loadAudioResourceFromUrls', () => {
-  it('resolves immediately with a null-buffer resource when sources is empty', async () => {
+  it('resolves with a null-buffer resource when sources is empty', async () => {
     const resource = await loadAudioResourceFromUrls(mockContext, []);
     expect(resource.buffer).toBeNull();
   });
+
+  it('loads the first playable source', async () => {
+    vi.spyOn(HTMLMediaElement.prototype, 'canPlayType').mockImplementation((type: string) =>
+      type === 'audio/ogg' ? 'probably' : '',
+    );
+    const fetchMock = vi.fn().mockResolvedValue({
+      arrayBuffer: () => Promise.resolve(new ArrayBuffer(8)),
+      headers: new Headers(),
+    });
+    vi.stubGlobal('fetch', fetchMock);
+
+    const resource = await loadAudioResourceFromUrls(mockContext, [{ url: 'sound.mp3' }, { url: 'sound.ogg' }]);
+
+    expect(resource.buffer).toBe(decodedBuffer);
+    expect(fetchMock).toHaveBeenCalledWith('sound.ogg', expect.anything());
+  });
+});
+
+describe('selectAudioResourceUrl', () => {
+  beforeEach(() => {
+    vi.spyOn(HTMLMediaElement.prototype, 'canPlayType').mockImplementation((type: string) =>
+      type === 'audio/ogg' ? 'maybe' : '',
+    );
+  });
+
+  it('returns the first source whose inferred type is playable', () => {
+    expect(selectAudioResourceUrl([{ url: 'a.mp3' }, { url: 'b.ogg' }])).toBe('b.ogg');
+  });
+
+  it('honours an explicit type over the URL extension', () => {
+    expect(selectAudioResourceUrl([{ type: 'audio/ogg', url: 'stream' }])).toBe('stream');
+  });
+
+  it('returns null when no source is playable', () => {
+    expect(selectAudioResourceUrl([{ url: 'a.mp3' }, { url: 'b.wav' }])).toBeNull();
+  });
 });