@flighthq/audio 0.3.0-next.906.07cea63 → 0.3.0

package/dist/audioDecoderRegistry.d.ts

@@ -0,0 +1,7 @@
+import type { AudioDecoder } from '@flighthq/types/contract';
+export declare function getAudioDecoder(mimeType: string): AudioDecoder | null;
+export declare function getAudioDecoderMimeTypes(): readonly string[];
+export declare function hasAudioDecoder(mimeType: string): boolean;
+export declare function registerAudioDecoder(mimeType: string, decoder: AudioDecoder): void;
+export declare function unregisterAudioDecoder(mimeType: string): void;
+//# sourceMappingURL=audioDecoderRegistry.d.ts.map

package/dist/audioDecoderRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audioDecoderRegistry.d.ts","sourceRoot":"","sources":["../src/audioDecoderRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAI7D,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAErE;AAID,wBAAgB,wBAAwB,IAAI,SAAS,MAAM,EAAE,CAE5D;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAElF;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE7D"}

package/dist/audioDecoderRegistry.js

@@ -0,0 +1,28 @@
+import { getAudioMimeTypeEssence } from './audioFormat';
+export function getAudioDecoder(mimeType) {
+    return decoders.get(getAudioMimeTypeEssence(mimeType)) ?? null;
+}
+// Returns an insertion-ordered snapshot of the MIME types with registered decoders. Mutating the returned
+// array cannot change registry state.
+export function getAudioDecoderMimeTypes() {
+    return Array.from(decoders.keys());
+}
+export function hasAudioDecoder(mimeType) {
+    return decoders.has(getAudioMimeTypeEssence(mimeType));
+}
+export function registerAudioDecoder(mimeType, decoder) {
+    decoders.set(getAudioMimeTypeEssence(mimeType), decoder);
+}
+export function unregisterAudioDecoder(mimeType) {
+    decoders.delete(getAudioMimeTypeEssence(mimeType));
+}
+// Global MIME-keyed decoder registry, mirroring the image one. Empty at import — only register* populates
+// it, so importing this package has no side effects. Last-write-wins, so a host can override a decoder by
+// registering after the default one.
+//
+// This registry is for formats the platform cannot decode on its own. Anything the browser understands
+// (MP3, WAV, Ogg) needs no entry: the resolver falls through to the platform decoder, which content-sniffs.
+// Registering here is how a SWF ADPCM or Nellymoser decoder becomes reachable without this package, or the
+// resolver, knowing that those formats exist.
+const decoders = new Map();
+//# sourceMappingURL=audioDecoderRegistry.js.map

package/dist/audioDecoderRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audioDecoderRegistry.js","sourceRoot":"","sources":["../src/audioDecoderRegistry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAExD,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,QAAQ,CAAC,GAAG,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC,IAAI,IAAI,CAAC;AACjE,CAAC;AAED,0GAA0G;AAC1G,sCAAsC;AACtC,MAAM,UAAU,wBAAwB;IACtC,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,QAAQ,CAAC,GAAG,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAgB,EAAE,OAAqB;IAC1E,QAAQ,CAAC,GAAG,CAAC,uBAAuB,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,QAAQ,CAAC,MAAM,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,0GAA0G;AAC1G,0GAA0G;AAC1G,qCAAqC;AACrC,EAAE;AACF,uGAAuG;AACvG,4GAA4G;AAC5G,2GAA2G;AAC3G,8CAA8C;AAC9C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAC"}

package/dist/audioFormat.d.ts

@@ -1,4 +1,6 @@
 export declare function canPlayAudioType(mimeType: string): boolean;
 export declare function detectAudioMimeType(data: ArrayBuffer | Uint8Array): string | null;
+export declare function getAudioMimeTypeEssence(mimeType: string): string;
+export declare function getAudioMimeTypeParameter(mimeType: string, name: string): 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":"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"}
+{"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;AAKD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGhE;AAID,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAqBvF;AAID,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoB7D"}

package/dist/audioFormat.js

@@ -42,6 +42,39 @@ export function detectAudioMimeType(data) {
         return 'audio/webm';
     return null;
 }
+// Returns the type/subtype of a MIME string without its parameters, lowercased — `audio/vnd.adobe.swf-adpcm`
+// for `audio/vnd.adobe.swf-adpcm; rate=22050`. Decoders register against the essence so one registration
+// serves every parameter combination a container emits.
+export function getAudioMimeTypeEssence(mimeType) {
+    const end = mimeType.indexOf(';');
+    return (end === -1 ? mimeType : mimeType.slice(0, end)).trim().toLowerCase();
+}
+// Returns one MIME parameter's value, or null when the type does not carry it. This is how a decoder for a
+// container-less format reads the sample rate and channel count its bitstream does not encode.
+export function getAudioMimeTypeParameter(mimeType, name) {
+    const wanted = name.toLowerCase();
+    // Split on semicolons outside quotes: a quoted value may contain one, and treating that as a separator
+    // would truncate the value and invent a parameter out of its tail.
+    let start = -1;
+    let quoted = false;
+    for (let i = 0; i <= mimeType.length; i++) {
+        const character = i < mimeType.length ? mimeType[i] : ';';
+        if (character === '"')
+            quoted = !quoted;
+        if (quoted || character !== ';')
+            continue;
+        if (start >= 0) {
+            const part = mimeType.slice(start, i);
+            const separator = part.indexOf('=');
+            if (separator >= 0 && part.slice(0, separator).trim().toLowerCase() === wanted) {
+                const value = part.slice(separator + 1).trim();
+                return value.length >= 2 && value.startsWith('"') && value.endsWith('"') ? value.slice(1, -1) : value;
+            }
+        }
+        start = i + 1;
+    }
+    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) {

package/dist/audioFormat.js.map

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

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,0BAA0B,CAAC;AAShF,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"}
+{"version":3,"file":"audioResourceFrom.d.ts","sourceRoot":"","sources":["../src/audioResourceFrom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAShF,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,CAWxB;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,YAAY,EACrB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAgBxB;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

@@ -36,10 +36,24 @@ export async function loadAudioResourceFromBytes(context, bytes, mimeType, signa
     signal?.throwIfAborted();
     const buffer = bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
     const audioBuffer = await context.decodeAudioData(buffer);
+    // decodeAudioData cannot be cancelled, so an abort landing mid-decode cannot stop the work — but it
+    // must still stop the result, or an aborted load resolves with a resource the caller no longer wants
+    // and is indistinguishable from one it asked for. This is the whole family's abort barrier: every
+    // loader here funnels through this function, so checking after the await is what makes "an aborted
+    // load never resolves" true for all of them rather than only for the pre-abort fast path above.
+    signal?.throwIfAborted();
     return createAudioResource(audioBuffer);
 }
 export async function loadAudioResourceFromUrl(context, url, signal) {
     const response = await fetch(url, { signal });
+    // fetch only rejects on a network-level failure, so a 404/500 arrives here as a perfectly good
+    // response whose body is an error page. Decoding that reports "unable to decode audio data" — the
+    // wrong failure, blaming the codec for a transport problem, after paying for a decode that never had
+    // a chance. Reporting the status keeps this function's existing reject-on-failure contract; whether
+    // this family should reject at all or return the empty-resource sentinel is the separate parked
+    // question in the assessment Backlog.
+    if (!response.ok)
+        throw new Error(`Failed to load audio: ${url} (${response.status} ${response.statusText})`);
     const arrayBuffer = await response.arrayBuffer();
     return loadAudioResourceFromBytes(context, new Uint8Array(arrayBuffer), response.headers.get('content-type') ?? undefined, signal);
 }

package/dist/audioResourceFrom.js.map

@@ -1 +1 @@
-{"version":3,"file":"audioResourceFrom.js","sourceRoot":"","sources":["../src/audioResourceFrom.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtD,6FAA6F;AAC7F,gGAAgG;AAChG,gGAAgG;AAChG,yEAAyE;AACzE,MAAM,UAAU,8BAA8B,CAAC,QAAiC,EAAE,UAAkB;IAClG,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC;IACzC,MAAM,MAAM,GAAG,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7D,IAAI,gBAAgB,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO,mBAAmB,EAAE,CAAC;IACzE,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,UAAU,EAAE,CAAC,CAAC;IACzE,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,gBAAgB,EAAE,OAAO,EAAE,EAAE,CAAC;QAC5D,6FAA6F;QAC7F,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,OAAO,CAA8B,EAAE,OAAO,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;AACrC,CAAC;AAED,qGAAqG;AACrG,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,OAAqB,EACrB,MAAc,EACd,QAAgB,EAChB,MAAoB;IAEpB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACxE,OAAO,0BAA0B,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,OAAqB,EACrB,IAAU,EACV,MAAoB;IAEpB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;IAC7C,OAAO,0BAA0B,CAAC,OAAO,EAAE,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,IAAI,IAAI,SAAS,EAAE,MAAM,CAAC,CAAC;AAC1G,CAAC;AAED,iGAAiG;AACjG,+FAA+F;AAC/F,2FAA2F;AAC3F,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,OAAqB,EACrB,KAAiB,EACjB,QAAiB,EACjB,MAAoB;IAEpB,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,MAAM,MAAM,GAAI,KAAK,CAAC,MAAsB,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC;IAC1G,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAC1D,OAAO,mBAAmB,CAAC,WAAW,CAAC,CAAC;AAC1C,CAAC;AAED,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,OAAO,0BAA0B,CAC/B,OAAO,EACP,IAAI,UAAU,CAAC,WAAW,CAAC,EAC3B,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,SAAS,EACjD,MAAM,CACP,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,OAAqB,EACrB,OAAoC,EACpC,MAAoB;IAEpB,MAAM,QAAQ,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACjD,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,mBAAmB,EAAE,CAAC;IACpD,OAAO,wBAAwB,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AAC7D,CAAC;AAED,iGAAiG;AACjG,oFAAoF;AACpF,MAAM,UAAU,sBAAsB,CAAC,OAAoC;IACzE,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,kBAAkB,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACjE,IAAI,gBAAgB,CAAC,IAAI,CAAC;YAAE,OAAO,MAAM,CAAC,GAAG,CAAC;IAChD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"audioResourceFrom.js","sourceRoot":"","sources":["../src/audioResourceFrom.ts"],"names":[],"mappings":"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"}

package/dist/audioResourceReference.d.ts

@@ -0,0 +1,9 @@
+import type { AudioResource, AudioResourceFailure, AudioResourceFetch, AudioResourceReference, AudioResourceReferenceResolutionExplanation, EmbeddedAudioResourceReference, ExternalAudioResourceReference } from '@flighthq/types/contract';
+export declare function createAudioResourceFailure(cause: unknown): AudioResourceFailure;
+export declare function createEmbeddedAudioResourceReference(bytes: Uint8Array, mimeType?: string | null, name?: string | null): EmbeddedAudioResourceReference;
+export declare function createExternalAudioResourceReference(uri: string, basePath?: string | null, mimeType?: string | null, name?: string | null): ExternalAudioResourceReference;
+export declare function explainAudioResourceReferenceResolution(ref: Readonly<AudioResourceReference>): AudioResourceReferenceResolutionExplanation;
+export declare function findAudioResourceReferenceByName(references: readonly Readonly<AudioResourceReference>[], name: string): Readonly<AudioResourceReference> | null;
+export declare function resetFailedAudioResourceReference(ref: AudioResourceReference): boolean;
+export declare function resolveAudioResourceReference(ref: AudioResourceReference, context: AudioContext | null, fetch: AudioResourceFetch, signal: AbortSignal): Promise<AudioResource | null>;
+//# sourceMappingURL=audioResourceReference.d.ts.map

package/dist/audioResourceReference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audioResourceReference.d.ts","sourceRoot":"","sources":["../src/audioResourceReference.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,2CAA2C,EAC3C,8BAA8B,EAC9B,8BAA8B,EAC/B,MAAM,0BAA0B,CAAC;AAalC,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,CAK/E;AAMD,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,UAAU,EACjB,QAAQ,GAAE,MAAM,GAAG,IAAW,EAC9B,IAAI,GAAE,MAAM,GAAG,IAAW,GACzB,8BAA8B,CAUhC;AAED,wBAAgB,oCAAoC,CAClD,GAAG,EAAE,MAAM,EACX,QAAQ,GAAE,MAAM,GAAG,IAAW,EAC9B,QAAQ,GAAE,MAAM,GAAG,IAAW,EAC9B,IAAI,GAAE,MAAM,GAAG,IAAW,GACzB,8BAA8B,CAWhC;AAID,wBAAgB,uCAAuC,CACrD,GAAG,EAAE,QAAQ,CAAC,sBAAsB,CAAC,GACpC,2CAA2C,CAO7C;AAKD,wBAAgB,gCAAgC,CAC9C,UAAU,EAAE,SAAS,QAAQ,CAAC,sBAAsB,CAAC,EAAE,EACvD,IAAI,EAAE,MAAM,GACX,QAAQ,CAAC,sBAAsB,CAAC,GAAG,IAAI,CAKzC;AAID,wBAAgB,iCAAiC,CAAC,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAKtF;AAUD,wBAAsB,6BAA6B,CACjD,GAAG,EAAE,sBAAsB,EAC3B,OAAO,EAAE,YAAY,GAAG,IAAI,EAC5B,KAAK,EAAE,kBAAkB,EACzB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CA2B/B"}

package/dist/audioResourceReference.js

@@ -0,0 +1,113 @@
+import { AudioResourceFailureKind, AudioResourceReferenceKind, ResourceResolutionState, } from '@flighthq/types/contract';
+import { getAudioDecoder } from './audioDecoderRegistry';
+import { createAudioResource } from './audioResource';
+import { loadAudioResourceFromBytes } from './audioResourceFrom';
+// Reduces a thrown value to the serialization-safe categories a reference retains. Raw Error objects and
+// arbitrary thrown values stay inside the resolving operation; diagnostics get category, name, and message.
+export function createAudioResourceFailure(cause) {
+    if (cause instanceof Error) {
+        return { kind: AudioResourceFailureKind.Error, message: cause.message, name: cause.name };
+    }
+    return { kind: AudioResourceFailureKind.Error, message: String(cause), name: null };
+}
+// `bytes` is retained as the view the container handed over, not a copy: a parser carves a sound payload
+// out of its source and the reference borrows it, so a document that never resolves a sound never pays for
+// its samples. The `resource` is allocated here rather than by the caller, because a trigger has to have
+// something to bind to before anything decodes.
+export function createEmbeddedAudioResourceReference(bytes, mimeType = null, name = null) {
+    return {
+        bytes,
+        failure: null,
+        kind: AudioResourceReferenceKind.Embedded,
+        mimeType,
+        name,
+        resource: createAudioResource(),
+        state: ResourceResolutionState.Unresolved,
+    };
+}
+export function createExternalAudioResourceReference(uri, basePath = null, mimeType = null, name = null) {
+    return {
+        basePath,
+        failure: null,
+        kind: AudioResourceReferenceKind.External,
+        mimeType,
+        name,
+        resource: createAudioResource(),
+        state: ResourceResolutionState.Unresolved,
+        uri,
+    };
+}
+// Returns a detached plain-data explanation suitable for logs, tools, and serialization. It never throws
+// and exposes no resolver runtime or raw thrown value.
+export function explainAudioResourceReferenceResolution(ref) {
+    return {
+        failure: ref.failure === null ? null : { ...ref.failure },
+        kind: ref.kind,
+        retryable: ref.state === ResourceResolutionState.Failed,
+        state: ref.state,
+    };
+}
+// Returns the reference a caller asked for by authoring-time name, or null when the document carried no
+// such sound. This is the only handle on a sound no timeline cues — a library sound published for code to
+// start — so a miss is an ordinary outcome rather than an error.
+export function findAudioResourceReferenceByName(references, name) {
+    for (let i = 0; i < references.length; i++) {
+        if (references[i].name === name)
+            return references[i];
+    }
+    return null;
+}
+// Returns a failed reference to the requestable state. Loading/resolved/unresolved references are unchanged
+// so this atom cannot invalidate live work or a successfully bound resource accidentally.
+export function resetFailedAudioResourceReference(ref) {
+    if (ref.state !== ResourceResolutionState.Failed)
+        return false;
+    ref.failure = null;
+    ref.state = ResourceResolutionState.Unresolved;
+    return true;
+}
+// Advances one reference through its lifecycle and binds the decoded samples into the resource the
+// reference already handed out, returning it or null for an expected failure. An abort is a cancel rather
+// than a failure, so the reference reverts to Unresolved and the rejection propagates.
+//
+// Embedded bytes take a registered decoder when the MIME type has one and the platform decoder otherwise,
+// in that order: a format the browser cannot parse is exactly what a registration is for, and a format it
+// can parse needs no registration. `context` may be null when every reference in play resolves through a
+// registered decoder or the fetch seam, which is what lets a non-web host avoid constructing one at all.
+export async function resolveAudioResourceReference(ref, context, fetch, signal) {
+    ref.failure = null;
+    ref.state = ResourceResolutionState.Loading;
+    try {
+        const decoded = ref.kind === AudioResourceReferenceKind.Embedded
+            ? await decodeAudioResourceBytes(ref, context, signal)
+            : await fetch(ref, signal);
+        if (decoded === null || decoded.buffer === null) {
+            ref.failure = { kind: AudioResourceFailureKind.Unavailable, message: 'Audio resource unavailable', name: null };
+            ref.state = ResourceResolutionState.Failed;
+            return null;
+        }
+        // The resource every cue already holds is the one that gains the samples, so a sound cued from forty
+        // frames costs one decode and all forty are live at once.
+        ref.resource.buffer = decoded.buffer;
+        ref.state = ResourceResolutionState.Resolved;
+        return ref.resource;
+    }
+    catch (cause) {
+        if (signal.aborted) {
+            ref.state = ResourceResolutionState.Unresolved;
+            throw cause;
+        }
+        ref.failure = createAudioResourceFailure(cause);
+        ref.state = ResourceResolutionState.Failed;
+        return null;
+    }
+}
+async function decodeAudioResourceBytes(ref, context, signal) {
+    const decoder = ref.mimeType === null ? null : getAudioDecoder(ref.mimeType);
+    if (decoder !== null)
+        return decoder(ref.bytes, ref.mimeType, signal);
+    if (context === null)
+        return null;
+    return loadAudioResourceFromBytes(context, ref.bytes, ref.mimeType ?? undefined, signal);
+}
+//# sourceMappingURL=audioResourceReference.js.map

package/dist/audioResourceReference.js.map

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

package/dist/contract.d.ts

@@ -1,4 +1,6 @@
+export * from './audioDecoderRegistry';
 export * from './audioFormat';
 export * from './audioResource';
+export * from './audioResourceReference';
 export * from './audioResourceFrom';
 //# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC"}

package/dist/contract.js

@@ -1,4 +1,6 @@
+export * from './audioDecoderRegistry';
 export * from './audioFormat';
 export * from './audioResource';
+export * from './audioResourceReference';
 export * from './audioResourceFrom';
 //# sourceMappingURL=contract.js.map

package/dist/contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC"}

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export { canPlayAudioType, cloneAudioResource, createAudioResource, createAudioResourceFromSamples, detectAudioMimeType, disposeAudioResource, getAudioResourceByteSize, getAudioResourceChannelCount, getAudioResourceChannelData, getAudioResourceDuration, getAudioResourceSampleRate, hasAudioResourceBuffer, inferAudioMimeType, isAudioResourceEmpty, loadAudioResourceFromBase64, loadAudioResourceFromBlob, loadAudioResourceFromBytes, loadAudioResourceFromUrl, loadAudioResourceFromUrls, selectAudioResourceUrl, } from './contract';
+export { findAudioResourceReferenceByName, unregisterAudioDecoder, resolveAudioResourceReference, resetFailedAudioResourceReference, registerAudioDecoder, hasAudioDecoder, getAudioMimeTypeParameter, getAudioMimeTypeEssence, getAudioDecoderMimeTypes, getAudioDecoder, explainAudioResourceReferenceResolution, createExternalAudioResourceReference, createAudioResourceFailure, canPlayAudioType, cloneAudioResource, createAudioResource, createAudioResourceFromSamples, createEmbeddedAudioResourceReference, detectAudioMimeType, disposeAudioResource, getAudioResourceByteSize, getAudioResourceChannelCount, getAudioResourceChannelData, getAudioResourceDuration, getAudioResourceSampleRate, hasAudioResourceBuffer, inferAudioMimeType, isAudioResourceEmpty, loadAudioResourceFromBase64, loadAudioResourceFromBlob, loadAudioResourceFromBytes, loadAudioResourceFromUrl, loadAudioResourceFromUrls, selectAudioResourceUrl, } from './contract';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,8BAA8B,EAC9B,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,4BAA4B,EAC5B,2BAA2B,EAC3B,wBAAwB,EACxB,0BAA0B,EAC1B,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,2BAA2B,EAC3B,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gCAAgC,EAChC,sBAAsB,EACtB,6BAA6B,EAC7B,iCAAiC,EACjC,oBAAoB,EACpB,eAAe,EACf,yBAAyB,EACzB,uBAAuB,EACvB,wBAAwB,EACxB,eAAe,EACf,uCAAuC,EACvC,oCAAoC,EACpC,0BAA0B,EAC1B,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,8BAA8B,EAC9B,oCAAoC,EACpC,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,4BAA4B,EAC5B,2BAA2B,EAC3B,wBAAwB,EACxB,0BAA0B,EAC1B,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,2BAA2B,EAC3B,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-export { canPlayAudioType, cloneAudioResource, createAudioResource, createAudioResourceFromSamples, detectAudioMimeType, disposeAudioResource, getAudioResourceByteSize, getAudioResourceChannelCount, getAudioResourceChannelData, getAudioResourceDuration, getAudioResourceSampleRate, hasAudioResourceBuffer, inferAudioMimeType, isAudioResourceEmpty, loadAudioResourceFromBase64, loadAudioResourceFromBlob, loadAudioResourceFromBytes, loadAudioResourceFromUrl, loadAudioResourceFromUrls, selectAudioResourceUrl, } from './contract';
+export { findAudioResourceReferenceByName, unregisterAudioDecoder, resolveAudioResourceReference, resetFailedAudioResourceReference, registerAudioDecoder, hasAudioDecoder, getAudioMimeTypeParameter, getAudioMimeTypeEssence, getAudioDecoderMimeTypes, getAudioDecoder, explainAudioResourceReferenceResolution, createExternalAudioResourceReference, createAudioResourceFailure, canPlayAudioType, cloneAudioResource, createAudioResource, createAudioResourceFromSamples, createEmbeddedAudioResourceReference, detectAudioMimeType, disposeAudioResource, getAudioResourceByteSize, getAudioResourceChannelCount, getAudioResourceChannelData, getAudioResourceDuration, getAudioResourceSampleRate, hasAudioResourceBuffer, inferAudioMimeType, isAudioResourceEmpty, loadAudioResourceFromBase64, loadAudioResourceFromBlob, loadAudioResourceFromBytes, loadAudioResourceFromUrl, loadAudioResourceFromUrls, selectAudioResourceUrl, } from './contract';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,8BAA8B,EAC9B,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,4BAA4B,EAC5B,2BAA2B,EAC3B,wBAAwB,EACxB,0BAA0B,EAC1B,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,2BAA2B,EAC3B,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gCAAgC,EAChC,sBAAsB,EACtB,6BAA6B,EAC7B,iCAAiC,EACjC,oBAAoB,EACpB,eAAe,EACf,yBAAyB,EACzB,uBAAuB,EACvB,wBAAwB,EACxB,eAAe,EACf,uCAAuC,EACvC,oCAAoC,EACpC,0BAA0B,EAC1B,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,8BAA8B,EAC9B,oCAAoC,EACpC,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,4BAA4B,EAC5B,2BAA2B,EAC3B,wBAAwB,EACxB,0BAA0B,EAC1B,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,2BAA2B,EAC3B,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,YAAY,CAAC"}

package/package.json

@@ -1,6 +1,8 @@
 {
   "name": "@flighthq/audio",
-  "version": "0.3.0-next.906.07cea63",
+  "version": "0.3.0",
+  "author": "Joshua Granick and other contributors",
+  "license": "MIT",
   "repository": {
     "type": "git",
     "url": "https://github.com/flighthq/flight.git",
@@ -36,7 +38,7 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/types": "0.3.0-next.906.07cea63"
+    "@flighthq/types": "0.3.0"
   },
   "devDependencies": {
     "typescript": "^5.3.0"

package/src/audioDecoderRegistry.test.ts

@@ -0,0 +1,73 @@
+import type { AudioDecoder } from '@flighthq/types/contract';
+
+import {
+  getAudioDecoder,
+  getAudioDecoderMimeTypes,
+  hasAudioDecoder,
+  registerAudioDecoder,
+  unregisterAudioDecoder,
+} from './audioDecoderRegistry';
+import { createAudioResource } from './audioResource';
+
+const decoder: AudioDecoder = async () => createAudioResource();
+
+afterEach(() => {
+  for (const mimeType of [...getAudioDecoderMimeTypes()]) unregisterAudioDecoder(mimeType);
+});
+
+describe('getAudioDecoder', () => {
+  it('returns null for an unregistered type rather than throwing', () => {
+    expect(getAudioDecoder('audio/vnd.acme.nothing')).toBeNull();
+  });
+
+  it('matches a registration regardless of the parameters the caller carries', () => {
+    registerAudioDecoder('audio/vnd.adobe.swf-adpcm', decoder);
+    // A container tags every sound with the parameters that sound needs, so a registry keyed on the whole
+    // string would miss every one of them.
+    expect(getAudioDecoder('audio/vnd.adobe.swf-adpcm; rate=22050; channels=1')).toBe(decoder);
+    expect(getAudioDecoder('AUDIO/VND.ADOBE.SWF-ADPCM')).toBe(decoder);
+  });
+});
+
+describe('getAudioDecoderMimeTypes', () => {
+  it('is empty until something registers', () => {
+    expect(getAudioDecoderMimeTypes()).toEqual([]);
+  });
+
+  it('snapshots the registered essences and cannot be mutated into the registry', () => {
+    registerAudioDecoder('audio/vnd.adobe.swf-adpcm; rate=8000', decoder);
+    const types = getAudioDecoderMimeTypes();
+    expect(types).toEqual(['audio/vnd.adobe.swf-adpcm']);
+    (types as string[]).push('audio/fake');
+    expect(getAudioDecoderMimeTypes()).toEqual(['audio/vnd.adobe.swf-adpcm']);
+  });
+});
+
+describe('hasAudioDecoder', () => {
+  it('reports registration by essence', () => {
+    expect(hasAudioDecoder('audio/vnd.acme.thing')).toBe(false);
+    registerAudioDecoder('audio/vnd.acme.thing', decoder);
+    expect(hasAudioDecoder('audio/vnd.acme.thing; rate=1')).toBe(true);
+  });
+});
+
+describe('registerAudioDecoder', () => {
+  it('lets a later registration win so a host can override a default', () => {
+    const replacement: AudioDecoder = async () => createAudioResource();
+    registerAudioDecoder('audio/vnd.acme.thing', decoder);
+    registerAudioDecoder('audio/vnd.acme.thing', replacement);
+    expect(getAudioDecoder('audio/vnd.acme.thing')).toBe(replacement);
+  });
+});
+
+describe('unregisterAudioDecoder', () => {
+  it('removes a registration by essence', () => {
+    registerAudioDecoder('audio/vnd.acme.thing', decoder);
+    unregisterAudioDecoder('audio/vnd.acme.thing; rate=2');
+    expect(hasAudioDecoder('audio/vnd.acme.thing')).toBe(false);
+  });
+
+  it('is a no-op for a type that was never registered', () => {
+    expect(() => unregisterAudioDecoder('audio/missing')).not.toThrow();
+  });
+});

package/src/audioFormat.test.ts

@@ -1,4 +1,10 @@
-import { canPlayAudioType, detectAudioMimeType, inferAudioMimeType } from './audioFormat';
+import {
+  canPlayAudioType,
+  detectAudioMimeType,
+  getAudioMimeTypeEssence,
+  getAudioMimeTypeParameter,
+  inferAudioMimeType,
+} from './audioFormat';
 
 describe('canPlayAudioType', () => {
   beforeEach(() => {
@@ -72,6 +78,42 @@ describe('detectAudioMimeType', () => {
   });
 });
 
+describe('getAudioMimeTypeEssence', () => {
+  it('strips parameters and lowercases the type', () => {
+    expect(getAudioMimeTypeEssence('audio/vnd.adobe.swf-adpcm; rate=22050; channels=1')).toBe(
+      'audio/vnd.adobe.swf-adpcm',
+    );
+    expect(getAudioMimeTypeEssence('  AUDIO/MPEG  ')).toBe('audio/mpeg');
+  });
+
+  it('returns a parameterless type unchanged', () => {
+    expect(getAudioMimeTypeEssence('audio/mpeg')).toBe('audio/mpeg');
+    expect(getAudioMimeTypeEssence('')).toBe('');
+  });
+});
+
+describe('getAudioMimeTypeParameter', () => {
+  it('reads a parameter a container-less format needs to decode', () => {
+    const mimeType = 'audio/vnd.adobe.swf-pcm; rate=22050; channels=2; bits=16';
+    expect(getAudioMimeTypeParameter(mimeType, 'rate')).toBe('22050');
+    expect(getAudioMimeTypeParameter(mimeType, 'channels')).toBe('2');
+    expect(getAudioMimeTypeParameter(mimeType, 'BITS')).toBe('16');
+  });
+
+  it('unwraps a quoted value', () => {
+    expect(getAudioMimeTypeParameter('audio/x-thing; codec="a;b"', 'codec')).toBe('a;b');
+  });
+
+  it('returns null for a parameter the type does not carry', () => {
+    expect(getAudioMimeTypeParameter('audio/mpeg', 'rate')).toBeNull();
+    expect(getAudioMimeTypeParameter('audio/mpeg; rate=1', 'channels')).toBeNull();
+  });
+
+  it('never reads the type itself as a parameter', () => {
+    expect(getAudioMimeTypeParameter('audio/mpeg', 'audio/mpeg')).toBeNull();
+  });
+});
+
 describe('inferAudioMimeType', () => {
   it('returns "audio/mpeg" for .mp3 files', () => {
     expect(inferAudioMimeType('track.mp3')).toBe('audio/mpeg');

package/src/audioResourceFrom.test.ts

@@ -14,6 +14,17 @@ const mockContext = {
   decodeAudioData: vi.fn().mockResolvedValue(decodedBuffer),
 } as unknown as AudioContext;
 
+// A context whose decode is held open, so a test can land an abort while the decode is still in
+// flight — the window the pre-abort fast path cannot see. `finishDecode` then completes it, modelling
+// the real decodeAudioData, which has no cancellation and so always runs to completion.
+function createPendingDecodeContext(): { context: AudioContext; finishDecode: () => void } {
+  let release: (buffer: AudioBuffer) => void = () => {};
+  const context = {
+    decodeAudioData: vi.fn(() => new Promise<AudioBuffer>((resolve) => (release = resolve))),
+  } as unknown as AudioContext;
+  return { context, finishDecode: () => release(decodedBuffer) };
+}
+
 // jsdom lacks the AudioBuffer constructor; this minimal stand-in honours the { length,
 // numberOfChannels, sampleRate } constructor plus copyToChannel/getChannelData used by
 // createAudioResourceFromSamples.
@@ -78,6 +89,15 @@ describe('loadAudioResourceFromBase64', () => {
     expect(resource.buffer).toBe(decodedBuffer);
     expect(mockContext.decodeAudioData).toHaveBeenCalledOnce();
   });
+
+  it('rejects when the signal aborts while the decode is in flight', async () => {
+    const { context, finishDecode } = createPendingDecodeContext();
+    const controller = new AbortController();
+    const promise = loadAudioResourceFromBase64(context, btoa('abc'), 'audio/mpeg', controller.signal);
+    controller.abort(new Error('cancelled'));
+    finishDecode();
+    await expect(promise).rejects.toThrow('cancelled');
+  });
 });
 
 describe('loadAudioResourceFromBlob', () => {
@@ -91,6 +111,20 @@ describe('loadAudioResourceFromBlob', () => {
     expect(resource.buffer).toBe(decodedBuffer);
     expect(mockContext.decodeAudioData).toHaveBeenCalledOnce();
   });
+
+  it('rejects when the signal aborts while the decode is in flight', async () => {
+    const { context, finishDecode } = createPendingDecodeContext();
+    const blob = {
+      arrayBuffer: () => Promise.resolve(new Uint8Array([1, 2, 3, 4]).buffer),
+      type: 'audio/wav',
+    } as unknown as Blob;
+    const controller = new AbortController();
+    const promise = loadAudioResourceFromBlob(context, blob, controller.signal);
+    await Promise.resolve();
+    controller.abort(new Error('cancelled'));
+    finishDecode();
+    await expect(promise).rejects.toThrow('cancelled');
+  });
 });
 
 describe('loadAudioResourceFromBytes', () => {
@@ -112,6 +146,31 @@ describe('loadAudioResourceFromBytes', () => {
       loadAudioResourceFromBytes(mockContext, new Uint8Array([1, 2, 3, 4]), undefined, controller.signal),
     ).rejects.toThrow('cancelled');
   });
+
+  // Every loader in this family funnels through here, and each is covered separately, because the
+  // guarantee is per entry point: a barrier that only holds for direct callers still lets the wrappers
+  // resolve past an abort.
+  it('rejects when the signal aborts while the decode is in flight', async () => {
+    const { context, finishDecode } = createPendingDecodeContext();
+    const controller = new AbortController();
+    const promise = loadAudioResourceFromBytes(context, new Uint8Array([1, 2, 3, 4]), undefined, controller.signal);
+    controller.abort(new Error('cancelled'));
+    finishDecode();
+    await expect(promise).rejects.toThrow('cancelled');
+  });
+
+  it('does not resolve with a decoded buffer after an abort', async () => {
+    const { context, finishDecode } = createPendingDecodeContext();
+    const controller = new AbortController();
+    const promise = loadAudioResourceFromBytes(context, new Uint8Array([1, 2, 3, 4]), undefined, controller.signal);
+    controller.abort(new Error('cancelled'));
+    finishDecode();
+    const settled = await promise.then(
+      (resource) => `resolved:${resource.buffer !== null}`,
+      () => 'rejected',
+    );
+    expect(settled).toBe('rejected');
+  });
 });
 
 describe('loadAudioResourceFromUrl', () => {
@@ -119,6 +178,7 @@ describe('loadAudioResourceFromUrl', () => {
     vi.stubGlobal(
       'fetch',
       vi.fn().mockResolvedValue({
+        ok: true,
         arrayBuffer: () => Promise.resolve(new ArrayBuffer(8)),
         headers: new Headers({ 'content-type': 'audio/mpeg' }),
       }),
@@ -126,6 +186,44 @@ describe('loadAudioResourceFromUrl', () => {
     const resource = await loadAudioResourceFromUrl(mockContext, 'sound.mp3');
     expect(resource.buffer).toBe(decodedBuffer);
   });
+
+  // fetch resolves for 404/500, so without a status check the error page reaches the decoder and the
+  // caller is told the codec failed. The assertion pins the status, not merely that it rejected.
+  it('rejects with the HTTP status rather than decoding an error response', async () => {
+    const decodeAudioData = vi.fn().mockResolvedValue(decodedBuffer);
+    vi.stubGlobal(
+      'fetch',
+      vi.fn().mockResolvedValue({
+        ok: false,
+        status: 404,
+        statusText: 'Not Found',
+        arrayBuffer: () => Promise.resolve(new TextEncoder().encode('<html>404</html>').buffer),
+        headers: new Headers({ 'content-type': 'text/html' }),
+      }),
+    );
+    await expect(
+      loadAudioResourceFromUrl({ decodeAudioData } as unknown as AudioContext, 'missing.mp3'),
+    ).rejects.toThrow('Failed to load audio: missing.mp3 (404 Not Found)');
+    expect(decodeAudioData).not.toHaveBeenCalled();
+  });
+
+  it('rejects when the signal aborts while the decode is in flight', async () => {
+    const { context, finishDecode } = createPendingDecodeContext();
+    vi.stubGlobal(
+      'fetch',
+      vi.fn().mockResolvedValue({
+        ok: true,
+        arrayBuffer: () => Promise.resolve(new ArrayBuffer(8)),
+        headers: new Headers({ 'content-type': 'audio/mpeg' }),
+      }),
+    );
+    const controller = new AbortController();
+    const promise = loadAudioResourceFromUrl(context, 'sound.mp3', controller.signal);
+    await Promise.resolve();
+    controller.abort(new Error('cancelled'));
+    finishDecode();
+    await expect(promise).rejects.toThrow('cancelled');
+  });
 });
 
 describe('loadAudioResourceFromUrls', () => {
@@ -139,6 +237,7 @@ describe('loadAudioResourceFromUrls', () => {
       type === 'audio/ogg' ? 'probably' : '',
     );
     const fetchMock = vi.fn().mockResolvedValue({
+      ok: true,
       arrayBuffer: () => Promise.resolve(new ArrayBuffer(8)),
       headers: new Headers(),
     });

package/src/audioResourceReference.test.ts

@@ -0,0 +1,219 @@
+import type { AudioDecoder, AudioResourceFetch } from '@flighthq/types/contract';
+import { ResourceResolutionState } from '@flighthq/types/contract';
+
+import { getAudioDecoderMimeTypes, registerAudioDecoder, unregisterAudioDecoder } from './audioDecoderRegistry';
+import { createAudioResource } from './audioResource';
+import {
+  createAudioResourceFailure,
+  createEmbeddedAudioResourceReference,
+  createExternalAudioResourceReference,
+  explainAudioResourceReferenceResolution,
+  findAudioResourceReferenceByName,
+  resetFailedAudioResourceReference,
+  resolveAudioResourceReference,
+} from './audioResourceReference';
+
+describe('createAudioResourceFailure', () => {
+  it('keeps an Error’s name and message without retaining the Error', () => {
+    const failure = createAudioResourceFailure(new TypeError('bad bytes'));
+    expect(failure).toEqual({ kind: 'Error', message: 'bad bytes', name: 'TypeError' });
+  });
+
+  it('stringifies a thrown non-Error', () => {
+    expect(createAudioResourceFailure('nope')).toEqual({ kind: 'Error', message: 'nope', name: null });
+  });
+});
+
+describe('createEmbeddedAudioResourceReference', () => {
+  it('starts unresolved with a resource waiting for its samples', () => {
+    const bytes = new Uint8Array([1, 2, 3]);
+    const reference = createEmbeddedAudioResourceReference(bytes, 'audio/mpeg', 'theme');
+
+    expect(reference.kind).toBe('Embedded');
+    expect(reference.bytes).toBe(bytes);
+    expect(reference.mimeType).toBe('audio/mpeg');
+    expect(reference.name).toBe('theme');
+    expect(reference.failure).toBeNull();
+    expect(reference.state).toBe(ResourceResolutionState.Unresolved);
+    // The resource exists before its samples do, so a cue can hold it while the bytes are undecoded.
+    expect(reference.resource.buffer).toBeNull();
+  });
+
+  it('borrows the caller’s bytes rather than copying them', () => {
+    const bytes = new Uint8Array([9, 9]);
+    expect(createEmbeddedAudioResourceReference(bytes).bytes).toBe(bytes);
+  });
+
+  it('leaves the mime type and name null when the container declared neither', () => {
+    const reference = createEmbeddedAudioResourceReference(new Uint8Array([0]));
+    expect(reference.mimeType).toBeNull();
+    expect(reference.name).toBeNull();
+  });
+
+  it('gives each reference its own resource', () => {
+    const first = createEmbeddedAudioResourceReference(new Uint8Array([1]));
+    const second = createEmbeddedAudioResourceReference(new Uint8Array([2]));
+    expect(first.resource).not.toBe(second.resource);
+  });
+});
+
+describe('createExternalAudioResourceReference', () => {
+  it('names a uri that has not been fetched yet', () => {
+    const reference = createExternalAudioResourceReference('hit.mp3', '/sounds', 'audio/mpeg', 'hit');
+    expect(reference.kind).toBe('External');
+    expect(reference.uri).toBe('hit.mp3');
+    expect(reference.basePath).toBe('/sounds');
+    expect(reference.mimeType).toBe('audio/mpeg');
+    expect(reference.name).toBe('hit');
+    expect(reference.resource.buffer).toBeNull();
+    expect(reference.state).toBe(ResourceResolutionState.Unresolved);
+  });
+
+  it('defaults the base path and the declared type to null', () => {
+    const reference = createExternalAudioResourceReference('hit.mp3');
+    expect(reference.basePath).toBeNull();
+    expect(reference.mimeType).toBeNull();
+  });
+});
+
+describe('explainAudioResourceReferenceResolution', () => {
+  it('reports an unresolved reference as not retryable', () => {
+    const reference = createEmbeddedAudioResourceReference(new Uint8Array([1]));
+    expect(explainAudioResourceReferenceResolution(reference)).toEqual({
+      failure: null,
+      kind: 'Embedded',
+      retryable: false,
+      state: ResourceResolutionState.Unresolved,
+    });
+  });
+
+  it('detaches the failure so a caller cannot mutate the reference through it', () => {
+    const reference = createEmbeddedAudioResourceReference(new Uint8Array([1]));
+    reference.state = ResourceResolutionState.Failed;
+    reference.failure = { kind: 'Error', message: 'boom', name: null };
+    const explanation = explainAudioResourceReferenceResolution(reference);
+    expect(explanation.retryable).toBe(true);
+    expect(explanation.failure).not.toBe(reference.failure);
+    explanation.failure!.message = 'changed';
+    expect(reference.failure.message).toBe('boom');
+  });
+});
+
+describe('findAudioResourceReferenceByName', () => {
+  it('returns the reference carrying the name', () => {
+    const first = createEmbeddedAudioResourceReference(new Uint8Array([1]), 'audio/mpeg', 'intro');
+    const second = createEmbeddedAudioResourceReference(new Uint8Array([2]), 'audio/mpeg', 'loop');
+    expect(findAudioResourceReferenceByName([first, second], 'loop')).toBe(second);
+  });
+
+  it('returns null for a name the document does not carry', () => {
+    const only = createEmbeddedAudioResourceReference(new Uint8Array([1]));
+    expect(findAudioResourceReferenceByName([only], 'missing')).toBeNull();
+    expect(findAudioResourceReferenceByName([], 'anything')).toBeNull();
+  });
+});
+
+describe('resetFailedAudioResourceReference', () => {
+  it('returns a failed reference to unresolved', () => {
+    const reference = createEmbeddedAudioResourceReference(new Uint8Array([1]));
+    reference.state = ResourceResolutionState.Failed;
+    reference.failure = { kind: 'Error', message: 'boom', name: null };
+    expect(resetFailedAudioResourceReference(reference)).toBe(true);
+    expect(reference.state).toBe(ResourceResolutionState.Unresolved);
+    expect(reference.failure).toBeNull();
+  });
+
+  it('leaves a reference that never failed untouched', () => {
+    const reference = createEmbeddedAudioResourceReference(new Uint8Array([1]));
+    reference.state = ResourceResolutionState.Resolved;
+    expect(resetFailedAudioResourceReference(reference)).toBe(false);
+    expect(reference.state).toBe(ResourceResolutionState.Resolved);
+  });
+});
+
+describe('resolveAudioResourceReference', () => {
+  const decodedBuffer = { duration: 1 } as AudioBuffer;
+  const context = { decodeAudioData: vi.fn().mockResolvedValue(decodedBuffer) } as unknown as AudioContext;
+  const noFetch: AudioResourceFetch = async () => null;
+
+  afterEach(() => {
+    for (const mimeType of [...getAudioDecoderMimeTypes()]) unregisterAudioDecoder(mimeType);
+  });
+
+  it('decodes embedded bytes through the platform and binds them into the reference’s own resource', async () => {
+    const reference = createEmbeddedAudioResourceReference(new Uint8Array([1, 2]), 'audio/mpeg');
+    const resource = reference.resource;
+
+    const resolved = await resolveAudioResourceReference(reference, context, noFetch, new AbortController().signal);
+
+    // The resource every cue already holds is the one that gains the samples; swapping in the decoder's
+    // own would leave every cue pointing at an empty resource.
+    expect(resolved).toBe(resource);
+    expect(resource.buffer).toBe(decodedBuffer);
+    expect(reference.state).toBe(ResourceResolutionState.Resolved);
+  });
+
+  it('prefers a registered decoder over the platform for a format the platform cannot parse', async () => {
+    const swfBuffer = { duration: 2 } as AudioBuffer;
+    const decoder = vi.fn<AudioDecoder>(async () => createAudioResource(swfBuffer));
+    registerAudioDecoder('audio/vnd.adobe.swf-adpcm', decoder);
+    const reference = createEmbeddedAudioResourceReference(
+      new Uint8Array([7]),
+      'audio/vnd.adobe.swf-adpcm; rate=22050; channels=1',
+    );
+
+    await resolveAudioResourceReference(reference, context, noFetch, new AbortController().signal);
+
+    expect(decoder).toHaveBeenCalledOnce();
+    // The decoder gets the whole type, parameters included, because that is where its rate lives.
+    expect(decoder.mock.calls[0][1]).toBe('audio/vnd.adobe.swf-adpcm; rate=22050; channels=1');
+    expect(reference.resource.buffer).toBe(swfBuffer);
+  });
+
+  it('fails rather than throwing when no decoder and no context can take the bytes', async () => {
+    const reference = createEmbeddedAudioResourceReference(new Uint8Array([7]), 'audio/vnd.adobe.swf-adpcm');
+    const resolved = await resolveAudioResourceReference(reference, null, noFetch, new AbortController().signal);
+
+    expect(resolved).toBeNull();
+    expect(reference.state).toBe(ResourceResolutionState.Failed);
+    expect(reference.failure).toEqual({ kind: 'Unavailable', message: 'Audio resource unavailable', name: null });
+  });
+
+  it('routes an external reference through the fetch seam', async () => {
+    const fetched = { duration: 3 } as AudioBuffer;
+    const fetch = vi.fn(async () => createAudioResource(fetched));
+    const reference = createExternalAudioResourceReference('hit.mp3', '/sounds');
+
+    await resolveAudioResourceReference(reference, context, fetch, new AbortController().signal);
+
+    expect(fetch).toHaveBeenCalledOnce();
+    expect(reference.resource.buffer).toBe(fetched);
+    expect(reference.state).toBe(ResourceResolutionState.Resolved);
+  });
+
+  it('records a thrown decode as a failure rather than propagating it', async () => {
+    const failing = {
+      decodeAudioData: vi.fn().mockRejectedValue(new TypeError('bad bytes')),
+    } as unknown as AudioContext;
+    const reference = createEmbeddedAudioResourceReference(new Uint8Array([1]), 'audio/mpeg');
+
+    const resolved = await resolveAudioResourceReference(reference, failing, noFetch, new AbortController().signal);
+
+    expect(resolved).toBeNull();
+    expect(reference.state).toBe(ResourceResolutionState.Failed);
+    expect(reference.failure).toEqual({ kind: 'Error', message: 'bad bytes', name: 'TypeError' });
+  });
+
+  it('treats an abort as a cancel, leaving the reference requestable rather than failed', async () => {
+    const controller = new AbortController();
+    const failing = {
+      decodeAudioData: vi.fn().mockRejectedValue(new Error('cancelled')),
+    } as unknown as AudioContext;
+    controller.abort(new Error('cancelled'));
+    const reference = createEmbeddedAudioResourceReference(new Uint8Array([1]), 'audio/mpeg');
+
+    await expect(resolveAudioResourceReference(reference, failing, noFetch, controller.signal)).rejects.toThrow();
+    expect(reference.state).toBe(ResourceResolutionState.Unresolved);
+    expect(reference.failure).toBeNull();
+  });
+});