refactor(mediabunny): [PKG-MB-03] type inputs and cancel owned loads

2026-10-25 08:01:20 -08:00 · 2026-09-12 18:08:37 +08:00
1 parent 03451c029b
commit adba8a3d12
@@ -0,0 +1,92 @@
+# MediaBunny proxy maintenance
+
+The public entry is `src/index.js`: an optional-options factory returns the existing
+ArtPlayer proxy callback and an HTMLCanvasElement. Public declarations remain in
+`types/artplayer-proxy-mediabunny.d.ts`. The input migration does not change those
+declarations, the factory signature, canvas forwarding, or package entrypoints.
+
+## Current module map
+
+| Module | Responsibility |
+| --- | --- |
+| `input.ts` | String/Blob/ReadableStream normalization, SDK Source/SourceRef pass-through, HLS detection and Input construction |
+| `media.ts` | Internal SDK-backed media and track-mode types; not public consumer types |
+| `tracks.ts` | Primary video and pairable audio selection, metadata/computed/live duration |
+| `hls-state.ts` | HLS track snapshots, bitrate/name/language values and actual selected track identity |
+| `preflight.ts` | Optional HEAD Range check, historical warning/error policy, cancellation and stale-result guard |
+| `load-session.ts` | Ownership of the pending/active SDK Input, HEAD AbortController, deferred load events and deadline |
+| `MediaBunnyEngine.js` | Current coordinator; connects session cancellation to load, source replacement, errors and destroy |
+| `VideoEngine.js` / `AudioEngine.js` | Current native decoding, rendering, seeking, Web Audio clock and scheduling |
+| `VideoShim.js` / `EventTarget.js` | Current video-like descriptors and event forwarding |
+| `m3u8.js` | Current ArtPlayer control/setting integration |
+
+The six TypeScript modules use strict checking with `skipLibCheck: false` and no
+ambient Node types. Remaining JavaScript is explicitly scheduled in PKG-MB-04/05/06/07/08.
+Do not describe the whole package as migrated yet.
+
+## Input and cancellation flow
+
+Each `engine.load` invalidates the previous generation and cancels its session.
+The new session owns an Input immediately after construction, before asynchronous
+track selection. `engine.input` and `engine.media` become visible only after selection.
+The session continues to own the Input during playback; these fields are aliases,
+not separate disposal owners. Repeated cancellation/disposal is harmless.
+
+Source replacement, timeout and destroy release that Input through SDK `Input.dispose()`.
+MediaBunny controls its media fetch cancellation; do not pass a signal in UrlSource's
+`requestInit` (the SDK explicitly excludes it). The separate HEAD check uses its own
+AbortController. Without that constructor, stale HEAD results/errors are still ignored,
+although the network request cannot be physically aborted by this adapter.
+
+Cancellation settles the old load Promise without waiting for a stalled read. Its late
+fulfillment/rejection remains observed but cannot update the current load. Active errors
+retain `code: 4` and the SDK message; active timeout retains `Load timeout` and networkState 3.
+Successful completion clears its deadline. Normal deferred waiting/loadstart ordering
+remains; cancellation clears both callbacks. Destroy makes future loads inert.
+
+Range behavior remains opt-in: no/`none` accept-ranges emits an error with a
+`RangeNotSupported` detail and returns false, without setting the engine error property.
+Network failure warns and continues; HLS strings and non-string sources skip HEAD.
+HLS matching preserves the old case-insensitive `.m3u8` suffix/query/hash rule.
+One explicit InputOptions assertion leaves unsupported values to SDK validation, preserving
+the old error owner rather than silently converting arbitrary inputs.
+
+## Types and dependencies
+
+The locked runtime SDK remains MediaBunny 1.56.1. Its pinned WebCodecs declaration
+0.1.13 duplicates types now present in TypeScript 5.9.3's DOM library. The root Yarn
+resolution selects `@types/dom-webcodecs@0.1.19` for both dependency paths; the SDK
+itself is unchanged. This is a build-time declaration correction, not a browser polyfill.
+The package typecheck adds ESNext.Disposable for SDK declarations while keeping the
+ES2020 target; production source does not use `using` or require Symbol.dispose.
+Public consumer declarations do not import these SDK types; preserve that boundary
+until the separate consumer-compatibility task verifies any proposed change.
+
+## Validation and remaining work
+
+```sh
+yarn test:mediabunny
+node node_modules/typescript/bin/tsc -p packages/artplayer-proxy-mediabunny/tsconfig.json
+yarn build artplayer-proxy-mediabunny
+yarn test:browser test/browser/mediabunny-inputs.spec.js test/browser/mediabunny.spec.js test/browser/mediabunny-load.spec.js
+```
+
+Node tests use actual SDK parsing and controlled lifecycle interleavings. Browser tests
+include native decoding and separate pending ReadableStream cancellation with real timers.
+`ARTPLAYER_MB_BASELINE=1` runs candidate load assertions against the immutable old main
+to reproduce failures. `ARTPLAYER_MB_ARTIFACT` selects a built UMD main/legacy bundle;
+`ARTPLAYER_MB_BROWSER_CANDIDATE=1` restricts browser runs to that candidate. Browser
+reports record the implementation hash; archive the report and results before rerunning.
+
+The source of historical truth is `refactor/baselines/mb-release.json` and its Git/npm
+inputs, not a rebuilt dist. Package-specific evidence and remaining tasks are in
+`refactor/mb-validation.md`. The full refactor plan is at the repository root.
+
+PKG-MB-04 still owns duplicate/trackless readiness, reentrant event sequences and
+pending play/seek coordination. PKG-MB-05/06 own late frame and audio callbacks,
+including operations already inside decoders at cancellation; releasing Input alone
+does not prove those resources are fully handled. PKG-MB-07 owns HLS UI/selection
+races. PKG-MB-09 owns long-run AV sync, full core/proxy/plugin combinations and device
+validation. PKG-MB-10 owns the demo, installed package and MPL/source notice gate.
+Windows WebKit without WebCodecs/Web Audio is recorded as a capability failure,
+not successful playback or a claim about all Safari installations.
@@ -9,3 +9,7 @@ mediabunny proxy for ArtPlayer, including `m3u8` playback through Mediabunny's H
 ## License

 MIT © Harvey Zhao
+
+## Maintenance
+
+See [ARCHITECTURE.md](ARCHITECTURE.md) for current modules, resource ownership, compatibility boundaries and validation commands.
@@ -4,4 +4,4 @@
 * (c) 2017-2026 Harvey Zhao
 * Released under the MIT License.
 */
-!function(e,t){"object"===typeof exports&&"undefined"!==typeof module?module.exports=t():"function"==typeof define&&define.amd?(t.artplayerProxyMediabunny=t(),define(function(){return t.artplayerProxyMediabunny})):(e="undefined"!==typeof globalThis?globalThis:e||self).artplayerProxyMediabunny=t()}(this,function(){"use strict";function e(e,t){const i=new Map;return e.filter(e=>{const r=e[t];return void 0===r||!i.has(r)&&i.set(r,1)})}class t{constructor(){this.listeners=new Map}addEventListener(e,t){this.listeners.has(e)||this.listeners.set(e,[]),this.listeners.get(e).push(t)}removeEventListener(e,t){const i=this.listeners.get(e);if(!i)return;const r=i.indexOf(t);r>=0&&i.splice(r,1)}emit(e,t){const i=new Event(e);i.detail=t;const r=this.listeners.get(e);r&&r.forEach(e=>e(i))}}function i(e){if(!e)throw new Error("Assertion failed.")}const r=e=>{const t=(e%360+360)%360;if(0===t||90===t||180===t||270===t)return t;throw new Error(`Invalid rotation ${e}.`)},a=e=>e&&e[e.length-1],s=e=>{let t=0;for(;0===e.readBits(1)&&t<32;)t++;if(t>=32)throw new Error("Invalid exponential-Golomb code.");return(1<<t)-1+e.readBits(t)},n=e=>{const t=s(e);return 0===(1&t)?-(t>>1):t+1>>1},o=e=>e.constructor===Uint8Array?e:ArrayBuffer.isView(e)?new Uint8Array(e.buffer,e.byteOffset,e.byteLength):new Uint8Array(e),c=e=>e.constructor===DataView?e:ArrayBuffer.isView(e)?new DataView(e.buffer,e.byteOffset,e.byteLength):new DataView(e),l=new TextDecoder,u=e=>Object.fromEntries(Object.entries(e).map(([e,t])=>[t,e])),d={bt709:1,bt470bg:5,smpte170m:6,bt2020:9,smpte432:12},h=u(d),f={bt709:1,smpte170m:6,linear:8,"iec61966-2-1":13,pq:16,hlg:18},m=u(f),p={rgb:0,bt709:1,bt470bg:5,smpte170m:6,"bt2020-ncl":9},g=u(p),k=e=>e instanceof ArrayBuffer||"undefined"!==typeof SharedArrayBuffer&&e instanceof SharedArrayBuffer||ArrayBuffer.isView(e);class b{constructor(){this.currentPromise=Promise.resolve(),this.pending=0}async acquire(){let e;const t=new Promise(t=>{let i=!1;e=()=>{i||(t(),this.pending--,i=!0)}}),i=this.currentPromise;return this.currentPromise=t,this.pending++,await i,e}}const y=/^[0-9a-fA-F]+$/,w=e=>[...e].map(e=>e.toString(16).padStart(2,"0")).join(""),T=e=>(e=(e=(e=(e=(e=e>>1&1431655765|(1431655765&e)<<1)>>2&858993459|(858993459&e)<<2)>>4&252645135|(252645135&e)<<4)>>8&16711935|(16711935&e)<<8)>>16&65535|(65535&e)<<16)>>>0,S=(e,t,i)=>{let r=0,a=e.length-1,s=-1;for(;r<=a;){const n=r+a>>1,o=i(e[n]);o===t?(s=n,a=n-1):o<t?r=n+1:a=n-1}return s},P=(e,t,i)=>{let r=0,a=e.length-1,s=-1;for(;r<=a;){const n=r+(a-r+1)/2|0;i(e[n])<=t?(s=n,r=n+1):a=n-1}return s},v=(e,t,i)=>{const r=P(e,i(t),i);e.splice(r+1,0,t)},I=()=>{let e,t;return{promise:new Promise((i,r)=>{e=i,t=r}),resolve:e,reject:t}},x=(e,t)=>{for(let i=e.length-1;i>=0;i--)if(t(e[i]))return e[i]},C=(e,t)=>{for(let i=e.length-1;i>=0;i--)if(t(e[i]))return i;return-1},B=e=>{throw new Error(`Unexpected value: ${e}`)},E=(e,t,i)=>{const r=e.getUint8(t),a=e.getUint8(t+1),s=e.getUint8(t+2);return i?r|a<<8|s<<16:r<<16|a<<8|s},_=(e,t,i,r)=>{i>>>=0,i&=16777215,e.setUint8(t,i>>>16&255),e.setUint8(t+1,i>>>8&255),e.setUint8(t+2,255&i)},A=(e,t)=>({async next(){const i=await e.next();return i.done?{value:void 0,done:!0}:{value:t(i.value),done:!1}},return:()=>e.return(),throw:t=>e.throw(t),[Symbol.asyncIterator](){return this}}),F=(e,t,i)=>Math.max(t,Math.min(i,e)),R="und",D=e=>{const t=Math.round(e);return Math.abs(e/t-1)<10*Number.EPSILON?t:e},M=(e,t)=>Math.round(e*t)/t,N=(e,t)=>Math.floor(e/t)*t,O=/^[a-z]{3}$/,L=e=>O.test(e),z=1e6*(1+Number.EPSILON),U=(e,t)=>{const i={...e,...t};if(e.headers||t.headers){const r=e.headers?q(e.headers):{},a=t.headers?q(t.headers):{},s={...r};Object.entries(a).forEach(([e,t])=>{const i=Object.keys(s).find(t=>t.toLowerCase()===e.toLowerCase());i&&delete s[i],s[e]=t}),i.headers=s}return i},q=e=>{if(e instanceof Headers){const t={};return e.forEach((e,i)=>{t[i]=e}),t}if(Array.isArray(e)){const t={};return e.forEach(([e,i])=>{t[e]=i}),t}return e},W=async(e,t,i,r,a)=>{let s=0;for(;;)try{return await e(t,i)}catch(n){if(a())throw n;s++;const e=r(s,n,t);if(null===e)throw n;if(console.error("Retrying failed fetch. Error:",n),!Number.isFinite(e)||e<0)throw new TypeError("Retry delay must be a non-negative finite number.");if(e>0&&await ce(1e3*e),a())throw n}};class V{constructor(){this.currentPromise=Promise.resolve()}call(e){return this.currentPromise=this.currentPromise.then(e)}}let H=null;const K=()=>null!==H?H:H=!("undefined"===typeof navigator||!(navigator.vendor?.match(/apple/i)||/AppleWebKit/.test(navigator.userAgent)&&!/Chrome/.test(navigator.userAgent)||/\b(iPad|iPhone|iPod)\b/.test(navigator.userAgent)));let j=null;const X=()=>null!==j?j:j="undefined"!==typeof navigator&&navigator.userAgent?.includes("Firefox");let $=null;const Q=()=>null!==$?$:$=!("undefined"===typeof navigator||!navigator.vendor?.includes("Google Inc")&&!/Chrome/.test(navigator.userAgent));let G=null;const Y=()=>{if(null!==G)return G;if("undefined"===typeof navigator)return null;const e=/\bChrome\/(\d+)/.exec(naLine truncated
+!function(e,t){"object"===typeof exports&&"undefined"!==typeof module?module.exports=t():"function"==typeof define&&define.amd?(e.artplayerProxyMediabunny=t(),define(function(){return e.artplayerProxyMediabunny})):(e="undefined"!==typeof globalThis?globalThis:e||self).artplayerProxyMediabunny=t()}(this,function(){"use strict";function e(e,t){const i=new Map;return e.filter(e=>{const r=e[t];return void 0===r||!i.has(r)&&i.set(r,1)})}class t{constructor(){this.listeners=new Map}addEventListener(e,t){this.listeners.has(e)||this.listeners.set(e,[]),this.listeners.get(e).push(t)}removeEventListener(e,t){const i=this.listeners.get(e);if(!i)return;const r=i.indexOf(t);r>=0&&i.splice(r,1)}emit(e,t){const i=new Event(e);i.detail=t;const r=this.listeners.get(e);r&&r.forEach(e=>e(i))}}function i(e){if(!e)throw new Error("Assertion failed.")}const r=e=>{const t=(e%360+360)%360;if(0===t||90===t||180===t||270===t)return t;throw new Error(`Invalid rotation ${e}.`)},a=e=>e&&e[e.length-1],s=e=>{let t=0;for(;0===e.readBits(1)&&t<32;)t++;if(t>=32)throw new Error("Invalid exponential-Golomb code.");return(1<<t)-1+e.readBits(t)},n=(e,t)=>{const i=t+1,r=Math.floor(Math.log2(i));e.writeBits(r,0),e.writeBits(1,1),e.writeBits(r,i-2**r)},o=e=>{const t=s(e);return 0===(1&t)?-(t>>1):t+1>>1},c=e=>e.constructor===Uint8Array?e:ArrayBuffer.isView(e)?new Uint8Array(e.buffer,e.byteOffset,e.byteLength):new Uint8Array(e),l=e=>e.constructor===DataView?e:ArrayBuffer.isView(e)?new DataView(e.buffer,e.byteOffset,e.byteLength):new DataView(e),u=new TextDecoder,d=e=>Object.fromEntries(Object.entries(e).map(([e,t])=>[t,e])),h={bt709:1,bt470bg:5,smpte170m:6,bt2020:9,smpte432:12},f=d(h),m={bt709:1,smpte170m:6,linear:8,"iec61966-2-1":13,pq:16,hlg:18},p=d(m),g={rgb:0,bt709:1,bt470bg:5,smpte170m:6,"bt2020-ncl":9},k=d(g),y=e=>!!e&&!!e.primaries&&!!e.transfer&&!!e.matrix&&void 0!==e.fullRange,b={primaries:void 0,transfer:void 0,matrix:void 0,fullRange:void 0},w=e=>e instanceof ArrayBuffer||"undefined"!==typeof SharedArrayBuffer&&e instanceof SharedArrayBuffer||ArrayBuffer.isView(e);class T{constructor(){this.currentPromise=Promise.resolve(),this.pending=0}async acquire(){let e;const t=new Promise(t=>{let i=!1;e=()=>{i||(t(),this.pending--,i=!0)}}),i=this.currentPromise;return this.currentPromise=t,this.pending++,await i,e}}const S=/^[0-9a-fA-F]+$/,v=e=>[...e].map(e=>e.toString(16).padStart(2,"0")).join(""),P=e=>(e=(e=(e=(e=(e=e>>1&1431655765|(1431655765&e)<<1)>>2&858993459|(858993459&e)<<2)>>4&252645135|(252645135&e)<<4)>>8&16711935|(16711935&e)<<8)>>16&65535|(65535&e)<<16)>>>0,I=(e,t,i)=>{let r=0,a=e.length-1,s=-1;for(;r<=a;){const n=r+a>>1,o=i(e[n]);o===t?(s=n,a=n-1):o<t?r=n+1:a=n-1}return s},x=(e,t,i)=>{let r=0,a=e.length-1,s=-1;for(;r<=a;){const n=r+(a-r+1)/2|0;i(e[n])<=t?(s=n,r=n+1):a=n-1}return s},C=(e,t,i)=>{const r=x(e,i(t),i);e.splice(r+1,0,t)},B=()=>{let e,t;return{promise:new Promise((i,r)=>{e=i,t=r}),resolve:e,reject:t}},E=(e,t)=>{const i=e.indexOf(t);-1!==i&&e.splice(i,1)},_=(e,t)=>{for(let i=e.length-1;i>=0;i--)if(t(e[i]))return e[i]},R=(e,t)=>{for(let i=e.length-1;i>=0;i--)if(t(e[i]))return i;return-1},F=e=>{throw new Error(`Unexpected value: ${e}`)},A=(e,t,i)=>{const r=e.getUint8(t),a=e.getUint8(t+1),s=e.getUint8(t+2);return i?r|a<<8|s<<16:r<<16|a<<8|s},D=(e,t,i,r)=>{i>>>=0,i&=16777215,e.setUint8(t,i>>>16&255),e.setUint8(t+1,i>>>8&255),e.setUint8(t+2,255&i)},M=(e,t)=>({async next(){const i=await e.next();return i.done?{value:void 0,done:!0}:{value:t(i.value),done:!1}},return:()=>e.return(),throw:t=>e.throw(t),[Symbol.asyncIterator](){return this}}),N=(e,t,i)=>Math.max(t,Math.min(i,e)),O="und",L=e=>{const t=Math.round(e);return Math.abs(e/t-1)<10*Number.EPSILON?t:e},z=(e,t)=>Math.round(e/t)*t,U=(e,t)=>Math.round(e*t)/t,q=(e,t)=>Math.floor(e/t)*t,W=e=>{let t=0;for(;0!==e;)e&=e-1,t++;return t},H=/^[a-z]{3}$/,V=e=>H.test(e),j=1e6*(1+Number.EPSILON),K=(e,t)=>{const i={...e,...t};if(e.headers||t.headers){const r=e.headers?X(e.headers):{},a=t.headers?X(t.headers):{},s={...r};Object.entries(a).forEach(([e,t])=>{const i=Object.keys(s).find(t=>t.toLowerCase()===e.toLowerCase());i&&delete s[i],s[e]=t}),i.headers=s}return i},X=e=>{if(e instanceof Headers){const t={};return e.forEach((e,i)=>{t[i]=e}),t}if(Array.isArray(e)){const t={};return e.forEach(([e,i])=>{t[e]=i}),t}return e},$=async(e,t,i,r,a)=>{let s=0;for(;;)try{return await e(t,i)}catch(n){if(a())throw n;s++;const e=r(s,n,t);if(null===e)throw n;if(be._error("Retrying failed fetch. Error:",n),!Number.isFinite(e)||e<0)throw new TypeError("Retry delay must be a non-negative finite number.");if(e>0&&await pe(1e3*e),a())throw n}};class G{constructor(){this.currentPromise=Promise.resolve()}call(e){return this.currentPromise=this.currentPromise.then(e)}}let Q=null;const Y=()=>null!==Q?Q:Q=!("undefined"===typeof navigator||!(navigator.vendor?.match(/apple/i)||/AppleWebKit/.test(navigator.userAgent)&&!/Chrome/.test(navigator.userAgent)||/\b(iPad|iPhone|iPod)\b/.test(navigator.userAgent)));let J=null;coLine truncated
@@ -4,4 +4,4 @@
 * (c) 2017-2026 Harvey Zhao
 * Released under the MIT License.
 */
-!function(e,t){"object"===typeof exports&&"undefined"!==typeof module?module.exports=t():"function"==typeof define&&define.amd?(t.artplayerProxyMediabunny=t(),define(function(){return t.artplayerProxyMediabunny})):(e="undefined"!==typeof globalThis?globalThis:e||self).artplayerProxyMediabunny=t()}(this,function(){"use strict";var e=Object.defineProperty,t=Object.defineProperties,i=Object.getOwnPropertyDescriptors,r=Object.getOwnPropertySymbols,n=Object.prototype.hasOwnProperty,s=Object.prototype.propertyIsEnumerable,a=(e,t)=>(t=Symbol[e])?t:Symbol.for("Symbol."+e),o=Math.pow,l=(t,i,r)=>i in t?e(t,i,{enumerable:!0,configurable:!0,writable:!0,value:r}):t[i]=r,c=(e,t)=>{for(var i in t||(t={}))n.call(t,i)&&l(e,i,t[i]);if(r)for(var i of r(t))s.call(t,i)&&l(e,i,t[i]);return e},u=(e,r)=>t(e,i(r)),d=(e,t,i)=>new Promise((r,n)=>{var s=e=>{try{o(i.next(e))}catch(t){n(t)}},a=e=>{try{o(i.throw(e))}catch(t){n(t)}},o=e=>e.done?r(e.value):Promise.resolve(e.value).then(s,a);o((i=i.apply(e,t)).next())}),h=function(e,t){this[0]=e,this[1]=t},f=(e,t,i)=>{var r=(e,t,n,s)=>{try{var a=i[e](t),o=(t=a.value)instanceof h,l=a.done;Promise.resolve(o?t[0]:t).then(i=>o?r("return"===e?e:"next",t[1]?{done:i.done,value:i.value}:i,n,s):n({value:i,done:l})).catch(e=>r("throw",e,n,s))}catch(c){s(c)}},n=e=>s[e]=t=>new Promise((i,n)=>r(e,t,i,n)),s={};return i=i.apply(e,t),s[a("asyncIterator")]=()=>s,n("next"),n("throw"),n("return"),s},m=e=>{var t,i=e[a("asyncIterator")],r=!1,n={};return null==i?(i=e[a("iterator")](),t=e=>n[e]=t=>i[e](t)):(i=i.call(e),t=e=>n[e]=t=>{if(r){if(r=!1,"throw"===e)throw t;return t}return r=!0,{done:!1,value:new h(new Promise(r=>{var n=i[e](t);n instanceof Object||(e=>{throw TypeError(e)})("Object expected"),r(n)}),1)}}),n[a("iterator")]=()=>n,t("next"),"throw"in i?t("throw"):n.throw=e=>{throw e},"return"in i&&t("return"),n},p=(e,t,i)=>(t=e[a("asyncIterator")])?t.call(e):(e=e[a("iterator")](),t={},(i=(i,r)=>(r=e[i])&&(t[i]=t=>new Promise((i,n,s)=>(t=r.call(e,t),s=t.done,Promise.resolve(t.value).then(e=>i({value:e,done:s}),n)))))("next"),i("return"),t);function g(e,t){const i=new Map;return e.filter(e=>{const r=e[t];return void 0===r||!i.has(r)&&i.set(r,1)})}class k{constructor(){this.listeners=new Map}addEventListener(e,t){this.listeners.has(e)||this.listeners.set(e,[]),this.listeners.get(e).push(t)}removeEventListener(e,t){const i=this.listeners.get(e);if(!i)return;const r=i.indexOf(t);r>=0&&i.splice(r,1)}emit(e,t){const i=new Event(e);i.detail=t;const r=this.listeners.get(e);r&&r.forEach(e=>e(i))}}function y(e){if(!e)throw new Error("Assertion failed.")}const b=e=>{const t=(e%360+360)%360;if(0===t||90===t||180===t||270===t)return t;throw new Error(`Invalid rotation ${e}.`)},T=e=>e&&e[e.length-1],S=e=>{let t=0;for(;0===e.readBits(1)&&t<32;)t++;if(t>=32)throw new Error("Invalid exponential-Golomb code.");return(1<<t)-1+e.readBits(t)},v=e=>{const t=S(e);return 0===(1&t)?-(t>>1):t+1>>1},w=e=>e.constructor===Uint8Array?e:ArrayBuffer.isView(e)?new Uint8Array(e.buffer,e.byteOffset,e.byteLength):new Uint8Array(e),P=e=>e.constructor===DataView?e:ArrayBuffer.isView(e)?new DataView(e.buffer,e.byteOffset,e.byteLength):new DataView(e),I=new TextDecoder,x=e=>Object.fromEntries(Object.entries(e).map(([e,t])=>[t,e])),C={bt709:1,bt470bg:5,smpte170m:6,bt2020:9,smpte432:12},B=x(C),E={bt709:1,smpte170m:6,linear:8,"iec61966-2-1":13,pq:16,hlg:18},_=x(E),A={rgb:0,bt709:1,bt470bg:5,smpte170m:6,"bt2020-ncl":9},F=x(A),R=e=>e instanceof ArrayBuffer||"undefined"!==typeof SharedArrayBuffer&&e instanceof SharedArrayBuffer||ArrayBuffer.isView(e);class D{constructor(){this.currentPromise=Promise.resolve(),this.pending=0}acquire(){return d(this,null,function*(){let e;const t=new Promise(t=>{let i=!1;e=()=>{i||(t(),this.pending--,i=!0)}}),i=this.currentPromise;return this.currentPromise=t,this.pending++,yield i,e})}}const M=/^[0-9a-fA-F]+$/,N=e=>[...e].map(e=>e.toString(16).padStart(2,"0")).join(""),O=e=>(e=(e=(e=(e=(e=e>>1&1431655765|(1431655765&e)<<1)>>2&858993459|(858993459&e)<<2)>>4&252645135|(252645135&e)<<4)>>8&16711935|(16711935&e)<<8)>>16&65535|(65535&e)<<16)>>>0,L=(e,t,i)=>{let r=0,n=e.length-1,s=-1;for(;r<=n;){const a=r+n>>1,o=i(e[a]);o===t?(s=a,n=a-1):o<t?r=a+1:n=a-1}return s},z=(e,t,i)=>{let r=0,n=e.length-1,s=-1;for(;r<=n;){const a=r+(n-r+1)/2|0;i(e[a])<=t?(s=a,r=a+1):n=a-1}return s},U=(e,t,i)=>{const r=z(e,i(t),i);e.splice(r+1,0,t)},q=()=>{let e,t;return{promise:new Promise((i,r)=>{e=i,t=r}),resolve:e,reject:t}},W=(e,t)=>{for(let i=e.length-1;i>=0;i--)if(t(e[i]))return e[i]},V=(e,t)=>{for(let i=e.length-1;i>=0;i--)if(t(e[i]))return i;return-1},H=e=>{throw new Error(`Unexpected value: ${e}`)},K=(e,t,i)=>{const r=e.getUint8(t),n=e.getUint8(t+1),s=e.getUint8(t+2);return i?r|n<<8|s<<16:r<<16|n<<8|s},j=(e,t,i,r)=>{i>>>=0,i&=16777215,e.setUint8(t,i>>>16&255),e.setUint8(t+1,i>>>8&255),e.setUint8(t+2,255&i)},X=(e,t)=>({next(){return d(this,null,function*(){const i=yield e.next();return i.done?{value:void 0,done:!0}:{value:t(i.value),done:!1}})}Line truncated
+!function(e,t){"object"===typeof exports&&"undefined"!==typeof module?module.exports=t():"function"==typeof define&&define.amd?(e.artplayerProxyMediabunny=t(),define(function(){return e.artplayerProxyMediabunny})):(e="undefined"!==typeof globalThis?globalThis:e||self).artplayerProxyMediabunny=t()}(this,function(){"use strict";var e=Object.defineProperty,t=Object.defineProperties,i=Object.getOwnPropertyDescriptors,r=Object.getOwnPropertySymbols,n=Object.prototype.hasOwnProperty,s=Object.prototype.propertyIsEnumerable,a=(e,t)=>(t=Symbol[e])?t:Symbol.for("Symbol."+e),o=Math.pow,l=(t,i,r)=>i in t?e(t,i,{enumerable:!0,configurable:!0,writable:!0,value:r}):t[i]=r,c=(e,t)=>{for(var i in t||(t={}))n.call(t,i)&&l(e,i,t[i]);if(r)for(var i of r(t))s.call(t,i)&&l(e,i,t[i]);return e},u=(e,r)=>t(e,i(r)),d=(e,t,i)=>new Promise((r,n)=>{var s=e=>{try{o(i.next(e))}catch(t){n(t)}},a=e=>{try{o(i.throw(e))}catch(t){n(t)}},o=e=>e.done?r(e.value):Promise.resolve(e.value).then(s,a);o((i=i.apply(e,t)).next())}),h=function(e,t){this[0]=e,this[1]=t},f=(e,t,i)=>{var r,n=(e,t,r,s)=>{try{var a=i[e](t),o=(t=a.value)instanceof h,l=a.done;Promise.resolve(o?t[0]:t).then(i=>o?n("return"===e?e:"next",t[1]?{done:i.done,value:i.value}:i,r,s):r({value:i,done:l})).catch(e=>n("throw",e,r,s))}catch(c){s(c)}},s=(e,t,i,s)=>o[e]=a=>(t=new Promise((t,i,s)=>(s=()=>n(e,a,t,i),r?r.then(s):s())),s=()=>r===i&&(r=0),r=i=t.then(s,s),t),o={};return i=i.apply(e,t),o[a("asyncIterator")]=()=>o,s("next"),s("throw"),s("return"),o},m=e=>{var t,i=e[a("asyncIterator")],r=!1,n={};return null==i?(i=e[a("iterator")](),t=e=>n[e]=t=>i[e](t)):(i=i.call(e),t=e=>n[e]=t=>{if(r){if(r=!1,"throw"===e)throw t;return t}return r=!0,{done:!1,value:new h(new Promise(r=>{var n=i[e](t);n instanceof Object||(e=>{throw TypeError(e)})("Object expected"),r(n)}),1)}}),n[a("iterator")]=()=>n,t("next"),"throw"in i?t("throw"):n.throw=e=>{throw e},"return"in i&&t("return"),n},p=(e,t,i)=>(t=e[a("asyncIterator")])?t.call(e):(e=e[a("iterator")](),t={},(i=(i,r)=>(r=e[i])&&(t[i]=t=>new Promise((i,n,s)=>(t=r.call(e,t),s=t.done,Promise.resolve(t.value).then(e=>i({value:e,done:s}),n)))))("next"),i("return"),t);function g(e,t){const i=new Map;return e.filter(e=>{const r=e[t];return void 0===r||!i.has(r)&&i.set(r,1)})}class k{constructor(){this.listeners=new Map}addEventListener(e,t){this.listeners.has(e)||this.listeners.set(e,[]),this.listeners.get(e).push(t)}removeEventListener(e,t){const i=this.listeners.get(e);if(!i)return;const r=i.indexOf(t);r>=0&&i.splice(r,1)}emit(e,t){const i=new Event(e);i.detail=t;const r=this.listeners.get(e);r&&r.forEach(e=>e(i))}}function y(e){if(!e)throw new Error("Assertion failed.")}const b=e=>{const t=(e%360+360)%360;if(0===t||90===t||180===t||270===t)return t;throw new Error(`Invalid rotation ${e}.`)},T=e=>e&&e[e.length-1],v=e=>{let t=0;for(;0===e.readBits(1)&&t<32;)t++;if(t>=32)throw new Error("Invalid exponential-Golomb code.");return(1<<t)-1+e.readBits(t)},S=(e,t)=>{const i=t+1,r=Math.floor(Math.log2(i));e.writeBits(r,0),e.writeBits(1,1),e.writeBits(r,i-o(2,r))},w=e=>{const t=v(e);return 0===(1&t)?-(t>>1):t+1>>1},P=e=>e.constructor===Uint8Array?e:ArrayBuffer.isView(e)?new Uint8Array(e.buffer,e.byteOffset,e.byteLength):new Uint8Array(e),I=e=>e.constructor===DataView?e:ArrayBuffer.isView(e)?new DataView(e.buffer,e.byteOffset,e.byteLength):new DataView(e),x=new TextDecoder,C=e=>Object.fromEntries(Object.entries(e).map(([e,t])=>[t,e])),B={bt709:1,bt470bg:5,smpte170m:6,bt2020:9,smpte432:12},E=C(B),_={bt709:1,smpte170m:6,linear:8,"iec61966-2-1":13,pq:16,hlg:18},R=C(_),F={rgb:0,bt709:1,bt470bg:5,smpte170m:6,"bt2020-ncl":9},A=C(F),D=e=>!!e&&!!e.primaries&&!!e.transfer&&!!e.matrix&&void 0!==e.fullRange,M={primaries:void 0,transfer:void 0,matrix:void 0,fullRange:void 0},N=e=>e instanceof ArrayBuffer||"undefined"!==typeof SharedArrayBuffer&&e instanceof SharedArrayBuffer||ArrayBuffer.isView(e);class O{constructor(){this.currentPromise=Promise.resolve(),this.pending=0}acquire(){return d(this,null,function*(){let e;const t=new Promise(t=>{let i=!1;e=()=>{i||(t(),this.pending--,i=!0)}}),i=this.currentPromise;return this.currentPromise=t,this.pending++,yield i,e})}}const L=/^[0-9a-fA-F]+$/,z=e=>[...e].map(e=>e.toString(16).padStart(2,"0")).join(""),U=e=>(e=(e=(e=(e=(e=e>>1&1431655765|(1431655765&e)<<1)>>2&858993459|(858993459&e)<<2)>>4&252645135|(252645135&e)<<4)>>8&16711935|(16711935&e)<<8)>>16&65535|(65535&e)<<16)>>>0,q=(e,t,i)=>{let r=0,n=e.length-1,s=-1;for(;r<=n;){const a=r+n>>1,o=i(e[a]);o===t?(s=a,n=a-1):o<t?r=a+1:n=a-1}return s},W=(e,t,i)=>{let r=0,n=e.length-1,s=-1;for(;r<=n;){const a=r+(n-r+1)/2|0;i(e[a])<=t?(s=a,r=a+1):n=a-1}return s},H=(e,t,i)=>{const r=W(e,i(t),i);e.splice(r+1,0,t)},V=()=>{let e,t;return{promise:new Promise((i,r)=>{e=i,t=r}),resolve:e,reject:t}},j=(e,t)=>{const i=e.indexOf(t);-1!==i&&e.splice(i,1)},K=(e,t)=>{for(let i=e.length-1;i>=0;i--)if(t(e[i]))return e[i]},X=(e,t)=>{for(let i=e.length-1;i>=0;i--)if(t(e[i]))return i;return-1},$=e=>{throw new ErrorLine truncated
@@ -3,7 +3,10 @@
 * Coordinates audio and video playback
 */
 import AudioEngine from './AudioEngine.js'
-import { createInput, getHlsState, resolveDuration, selectPlaybackTracks } from './input.js'
+import { getHlsState } from './hls-state'
+import { createInput } from './input'
+import LoadSession from './load-session'
+import { resolveDuration, selectPlaybackTracks } from './tracks'
 import VideoEngine from './VideoEngine.js'

 export default class MediaBunnyEngine {
@@ -34,6 +37,8 @@ export default class MediaBunnyEngine {
    this.loadSeq = 0
    this.input = null
    this.media = null
+    this.loadSession = null
+    this.destroyed = false

    // Listen to ended event
    events.addEventListener?.('ended', () => {
@@ -43,41 +48,50 @@ export default class MediaBunnyEngine {
  }

  async load(src) {
+    if (this.destroyed)
+      return
    const id = ++this.loadSeq
-
+    this.loadSession?.cancel()
+    if (id !== this.loadSeq || this.destroyed)
+      return
    this.pause()
+    if (id !== this.loadSeq || this.destroyed)
+      return
    this.disposeInput()
+    const session = new LoadSession()
+    this.loadSession = session
    this.ended = false
    this.error = null
    this.networkState = 2 // NETWORK_LOADING
    this.readyState = 0 // HAVE_NOTHING

-    setTimeout(() => this.events.emit('waiting'), 0)
-    setTimeout(() => this.events.emit('loadstart'), 0)
+    session.defer(() => this.events.emit('waiting'))
+    session.defer(() => this.events.emit('loadstart'))

    const loadTimeout = Number.isFinite(this.option.loadTimeout)
      ? this.option.loadTimeout
      : 0

    try {
-      await Promise.race([
-        this.performLoad(src, id),
-        loadTimeout > 0 ? this.createTimeout(loadTimeout) : new Promise(() => {}),
-      ])
+      await session.wait(this.performLoad(src, id, session), loadTimeout)
    }
    catch (err) {
      if (id !== this.loadSeq)
        return

-      this.loadSeq++
+      const failed = ++this.loadSeq
+      session.cancel()
+      if (failed !== this.loadSeq || this.destroyed)
+        return
+      this.disposeInput()
      this.error = { code: 4, message: err.message }
      this.networkState = 3 // NETWORK_NO_SOURCE
      this.events.emit('error')
    }
  }

-  async performLoad(src, id) {
-    if (!(await this.video.preflight(src)))
+  async performLoad(src, id, session = this.loadSession) {
+    if (!(await this.video.preflight(src, session?.signal, () => id === this.loadSeq)) || id !== this.loadSeq)
      return

    const input = createInput(src)
@@ -86,14 +100,10 @@ export default class MediaBunnyEngine {
      this.audio.handleNoAudioTrack()
      return
    }
-
+    session.own(input)
    const media = await selectPlaybackTracks(input, src)
-    if (id !== this.loadSeq) {
-      input.dispose()
+    if (id !== this.loadSeq)
      return
-    }
-
-    this.disposeInput()
    this.input = input
    this.media = media

@@ -139,10 +149,8 @@ export default class MediaBunnyEngine {
      if (id !== this.loadSeq)
        return

-      this.error = { code: 4, message: err.message }
-      this.networkState = 3
-      this.events.emit('error')
      console.error('MediaBunny load error:', err)
+      throw err
    }
  }

@@ -153,7 +161,7 @@ export default class MediaBunnyEngine {
  }

  disposeInput() {
-    this.input?.dispose()
+    this.loadSession?.disposeInput()
    this.input = null
    this.media = null
  }
@@ -334,6 +342,11 @@ export default class MediaBunnyEngine {
  }

  destroy() {
+    if (this.destroyed)
+      return
+    this.destroyed = true
+    this.loadSeq++
+    this.loadSession?.cancel()
    this.pause()
    this.disposeInput()
    this.audio.destroy()
@@ -5,7 +5,7 @@
 import {
  CanvasSink,
 } from 'mediabunny'
-import { isHlsSource } from './input.js'
+import { preflightRange } from './preflight'

 export default class VideoEngine {
  constructor({
@@ -51,23 +51,8 @@ export default class VideoEngine {
    this.isFetching = false
  }

-  async preflight(url) {
-    if (!this.preflightRange || typeof url !== 'string' || isHlsSource(url))
-      return true
-
-    try {
-      const res = await fetch(url, { method: 'HEAD' })
-      const acceptRanges = res.headers.get('accept-ranges')
-      if (!acceptRanges || acceptRanges === 'none') {
-        this.events.emit('error', new Event('RangeNotSupported'))
-        return false
-      }
-      return true
-    }
-    catch (e) {
-      console.warn('Preflight check failed:', e)
-      return true
-    }
+  async preflight(url, signal, isCurrent) {
+    return preflightRange(url, this.preflightRange, this.events, signal, isCurrent)
  }

  drawPoster() {
@@ -0,0 +1,47 @@
+import type { InputTrack } from 'mediabunny'
+import type { PlaybackMedia } from './media'
+
+async function getTrackBitrate(track: InputTrack): Promise<number> {
+  return await track.getAverageBitrate() ?? await track.getBitrate() ?? 0
+}
+
+export async function getHlsState(media: PlaybackMedia | null) {
+  if (!media?.isHls || !media.input)
+    return null
+
+  const [videoTracks, pairableAudioTracks] = await Promise.all([
+    media.input.getVideoTracks(),
+    media.videoTrack ? media.videoTrack.getPairableAudioTracks() : [],
+  ])
+  const [levels, audios] = await Promise.all([
+    Promise.all(videoTracks.map(async (track, index) => ({
+      id: track.id,
+      track,
+      index,
+      name: await track.getName(),
+      height: await track.getDisplayHeight(),
+      bitrate: await getTrackBitrate(track),
+    }))),
+    Promise.all(pairableAudioTracks.map(async (track, index) => {
+      const name = await track.getName()
+      const language = await track.getLanguageCode()
+      return {
+        id: track.id,
+        track,
+        index,
+        name,
+        lang: language,
+        language,
+        bitrate: await getTrackBitrate(track),
+      }
+    })),
+  ])
+  return {
+    levels,
+    audios,
+    currentLevel: media.videoTrack ? levels.find(item => item.id === media.videoTrack?.id) ?? null : null,
+    currentAudio: media.audioTrack ? audios.find(item => item.id === media.audioTrack?.id) ?? null : null,
+    videoMode: media.videoMode ?? 'auto',
+    audioMode: media.audioMode ?? 'auto',
+  }
+}
@@ -1,120 +0,0 @@
-import {
-  ALL_FORMATS,
-  BlobSource,
-  HLS_FORMATS,
-  Input,
-  ReadableStreamSource,
-  UrlSource,
-} from 'mediabunny'
-
-const M3U8_RE = /\.m3u8(?:$|[?#])/i
-
-export function isHlsSource(src) {
-  return typeof src === 'string' && M3U8_RE.test(src)
-}
-
-export function normalizeSource(src) {
-  if (typeof src === 'string')
-    return new UrlSource(src)
-  if (src instanceof Blob)
-    return new BlobSource(src)
-  if (typeof ReadableStream !== 'undefined' && src instanceof ReadableStream) {
-    return new ReadableStreamSource(src)
-  }
-  return src ?? null
-}
-
-export function createInput(src) {
-  const source = normalizeSource(src)
-  if (!source)
-    return null
-
-  return new Input({
-    source,
-    formats: isHlsSource(src) ? HLS_FORMATS : ALL_FORMATS,
-  })
-}
-
-export async function resolveDuration({ input, videoTrack, audioTrack }) {
-  const tracks = [videoTrack, audioTrack].filter(Boolean)
-  const referenceTrack = videoTrack || audioTrack
-  const isLive = Boolean(referenceTrack && await referenceTrack.isLive())
-
-  let duration = Number.NaN
-  if (tracks.length > 0) {
-    duration = await input.getDurationFromMetadata(tracks, { skipLiveWait: true })
-    if (duration === null && !isLive) {
-      duration = await input.computeDuration(tracks, { skipLiveWait: true })
-    }
-  }
-
-  return isLive ? Number.POSITIVE_INFINITY : duration ?? Number.NaN
-}
-
-export async function selectPlaybackTracks(input, src) {
-  const videoTrack = await input.getPrimaryVideoTrack()
-  const audioTrack = videoTrack
-    ? await videoTrack.getPrimaryPairableAudioTrack()
-    : await input.getPrimaryAudioTrack()
-  const duration = await resolveDuration({ input, videoTrack, audioTrack })
-
-  return {
-    input,
-    videoTrack,
-    audioTrack,
-    duration,
-    isLive: Number.isFinite(duration) ? false : Boolean((videoTrack || audioTrack) && await (videoTrack || audioTrack).isLive()),
-    isHls: isHlsSource(src),
-    videoMode: isHlsSource(src) ? 'auto' : 'manual',
-    audioMode: isHlsSource(src) ? 'auto' : 'manual',
-  }
-}
-
-async function getTrackBitrate(track) {
-  return await track.getAverageBitrate() ?? await track.getBitrate() ?? 0
-}
-
-export async function getHlsState(media) {
-  if (!media?.isHls || !media.input)
-    return null
-
-  const [videoTracks, pairableAudioTracks] = await Promise.all([
-    media.input.getVideoTracks(),
-    media.videoTrack
-      ? media.videoTrack.getPairableAudioTracks()
-      : [],
-  ])
-
-  const [levels, audios] = await Promise.all([
-    Promise.all(videoTracks.map(async (track, index) => ({
-      id: track.id,
-      track,
-      index,
-      name: await track.getName(),
-      height: await track.getDisplayHeight(),
-      bitrate: await getTrackBitrate(track),
-    }))),
-    Promise.all(pairableAudioTracks.map(async (track, index) => {
-      const name = await track.getName()
-      const language = await track.getLanguageCode()
-      return {
-        id: track.id,
-        track,
-        index,
-        name,
-        lang: language,
-        language,
-        bitrate: await getTrackBitrate(track),
-      }
-    })),
-  ])
-
-  return {
-    levels,
-    audios,
-    currentLevel: media.videoTrack ? levels.find(item => item.id === media.videoTrack.id) ?? null : null,
-    currentAudio: media.audioTrack ? audios.find(item => item.id === media.audioTrack.id) ?? null : null,
-    videoMode: media.videoMode ?? 'auto',
-    audioMode: media.audioMode ?? 'auto',
-  }
-}
@@ -0,0 +1,37 @@
+import type { InputOptions } from 'mediabunny'
+import {
+  ALL_FORMATS,
+  BlobSource,
+  HLS_FORMATS,
+  Input,
+  ReadableStreamSource,
+  UrlSource,
+} from 'mediabunny'
+
+const M3U8_RE = /\.m3u8(?:$|[?#])/i
+
+export function isHlsSource(src: unknown): boolean {
+  return typeof src === 'string' && M3U8_RE.test(src)
+}
+
+export function normalizeSource(src: unknown): unknown {
+  if (typeof src === 'string')
+    return new UrlSource(src)
+  if (src instanceof Blob)
+    return new BlobSource(src)
+  if (typeof ReadableStream !== 'undefined' && src instanceof ReadableStream)
+    return new ReadableStreamSource(src)
+  return src ?? null
+}
+
+export function createInput(src: unknown): Input | null {
+  const source = normalizeSource(src)
+  if (!source)
+    return null
+
+  return new Input({
+    // Preserve SDK Source/SourceRef pass-through and its historical validation errors.
+    source: source as InputOptions['source'],
+    formats: isHlsSource(src) ? HLS_FORMATS : ALL_FORMATS,
+  })
+}
@@ -0,0 +1,77 @@
+import type { Input } from 'mediabunny'
+
+export default class LoadSession {
+  private active = true
+  private input: Input | null = null
+  private timers = new Set<ReturnType<typeof setTimeout>>()
+  private deadline: ReturnType<typeof setTimeout> | undefined
+  private controller = typeof AbortController === 'undefined' ? undefined : new AbortController()
+  private resolveCancellation!: () => void
+  private cancellation = new Promise<void>((resolve) => {
+    this.resolveCancellation = resolve
+  })
+
+  get signal(): AbortSignal | undefined {
+    return this.controller?.signal
+  }
+
+  own(input: Input): void {
+    if (this.active)
+      this.input = input
+    else input.dispose()
+  }
+
+  defer(callback: () => void): void {
+    if (!this.active)
+      return
+    const timer = setTimeout(() => {
+      this.timers.delete(timer)
+      if (this.active)
+        callback()
+    }, 0)
+    this.timers.add(timer)
+  }
+
+  async wait(operation: Promise<void>, milliseconds: number): Promise<void> {
+    try {
+      await Promise.race([
+        operation,
+        this.cancellation,
+        milliseconds > 0 ? this.timeout(milliseconds) : new Promise<void>(() => {}),
+      ])
+    }
+    finally {
+      if (this.deadline !== undefined) {
+        clearTimeout(this.deadline)
+        this.deadline = undefined
+      }
+    }
+  }
+
+  timeout(milliseconds: number): Promise<never> {
+    return new Promise((_, reject) => {
+      this.deadline = setTimeout(() => reject(new Error('Load timeout')), milliseconds)
+    })
+  }
+
+  disposeInput(): void {
+    const input = this.input
+    this.input = null
+    input?.dispose()
+  }
+
+  cancel(): void {
+    if (!this.active)
+      return
+    this.active = false
+    for (const timer of this.timers) clearTimeout(timer)
+    this.timers.clear()
+    if (this.deadline !== undefined) {
+      clearTimeout(this.deadline)
+      this.deadline = undefined
+    }
+    this.resolveCancellation()
+    this.controller?.abort()
+    this.disposeInput()
+  }
+}
@@ -0,0 +1,14 @@
+import type { Input, InputAudioTrack, InputVideoTrack } from 'mediabunny'
+
+export type TrackMode = 'auto' | 'manual'
+
+export interface PlaybackMedia {
+  input: Input
+  videoTrack: InputVideoTrack | null
+  audioTrack: InputAudioTrack | null
+  duration: number
+  isLive: boolean
+  isHls: boolean
+  videoMode: TrackMode
+  audioMode: TrackMode
+}
@@ -0,0 +1,30 @@
+import { isHlsSource } from './input'
+
+interface RangeEvents {
+  emit: (type: string, detail?: Event) => void
+}
+
+export async function preflightRange(url: unknown, enabled: boolean, events: RangeEvents, signal?: AbortSignal, isCurrent = (): boolean => true): Promise<boolean> {
+  if (signal?.aborted || !isCurrent())
+    return false
+  if (!enabled || typeof url !== 'string' || isHlsSource(url))
+    return true
+
+  try {
+    const res = await fetch(url, signal ? { method: 'HEAD', signal } : { method: 'HEAD' })
+    if (signal?.aborted || !isCurrent())
+      return false
+    const acceptRanges = res.headers.get('accept-ranges')
+    if (!acceptRanges || acceptRanges === 'none') {
+      events.emit('error', new Event('RangeNotSupported'))
+      return false
+    }
+    return true
+  }
+  catch (error) {
+    if (signal?.aborted || !isCurrent())
+      return false
+    console.warn('Preflight check failed:', error)
+    return true
+  }
+}
@@ -0,0 +1,38 @@
+import type { Input, InputAudioTrack, InputVideoTrack } from 'mediabunny'
+import type { PlaybackMedia } from './media'
+import { isHlsSource } from './input'
+
+export async function resolveDuration({ input, videoTrack, audioTrack }: Pick<PlaybackMedia, 'input' | 'videoTrack' | 'audioTrack'>): Promise<number> {
+  const tracks = [videoTrack, audioTrack].filter((track): track is InputVideoTrack | InputAudioTrack => track !== null)
+  const referenceTrack = videoTrack || audioTrack
+  const isLive = Boolean(referenceTrack && await referenceTrack.isLive())
+
+  let duration: number | null = Number.NaN
+  if (tracks.length > 0) {
+    duration = await input.getDurationFromMetadata(tracks, { skipLiveWait: true })
+    if (duration === null && !isLive)
+      duration = await input.computeDuration(tracks, { skipLiveWait: true })
+  }
+  return isLive ? Number.POSITIVE_INFINITY : duration ?? Number.NaN
+}
+
+export async function selectPlaybackTracks(input: Input, src: unknown): Promise<PlaybackMedia> {
+  const videoTrack = await input.getPrimaryVideoTrack()
+  const audioTrack = videoTrack
+    ? await videoTrack.getPrimaryPairableAudioTrack()
+    : await input.getPrimaryAudioTrack()
+  const duration = await resolveDuration({ input, videoTrack, audioTrack })
+  const referenceTrack = videoTrack || audioTrack
+  const isHls = isHlsSource(src)
+
+  return {
+    input,
+    videoTrack,
+    audioTrack,
+    duration,
+    isLive: Number.isFinite(duration) ? false : Boolean(referenceTrack && await referenceTrack.isLive()),
+    isHls,
+    videoMode: isHls ? 'auto' : 'manual',
+    audioMode: isHls ? 'auto' : 'manual',
+  }
+}
@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "allowJs": false,
+    "lib": ["ES2020", "DOM", "DOM.Iterable", "ESNext.Disposable"]
+  },
+  "include": ["src/**/*.ts", "types/**/*.d.ts"]
+}