@flighthq/video 0.1.0 → 0.2.0

package/dist/videoFormat.d.ts

@@ -1,2 +1,6 @@
-export declare function inferVideoType(url: string): string | null;
+import type { VideoResourceUrl } from '@flighthq/types';
+export declare function canPlayVideoType(mimeType: string): boolean;
+export declare function detectVideoMimeType(data: ArrayBuffer | Uint8Array): string | null;
+export declare function inferVideoMimeType(url: string): string | null;
+export declare function selectVideoResourceUrl(sources: Readonly<VideoResourceUrl[]>): VideoResourceUrl | null;
 //# sourceMappingURL=videoFormat.d.ts.map

package/dist/videoFormat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"videoFormat.d.ts","sourceRoot":"","sources":["../src/videoFormat.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgBzD"}
+{"version":3,"file":"videoFormat.d.ts","sourceRoot":"","sources":["../src/videoFormat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAKxD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAG1D;AAKD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,UAAU,GAAG,MAAM,GAAG,IAAI,CAcjF;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwB7D;AAKD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,QAAQ,CAAC,gBAAgB,EAAE,CAAC,GAAG,gBAAgB,GAAG,IAAI,CAKrG"}

package/dist/videoFormat.js

@@ -1,4 +1,29 @@
-export function inferVideoType(url) {
+// True when the current environment claims it can play the given MIME type (a non-empty canPlayType
+// result — 'maybe' or 'probably'). Returns false in headless environments (jsdom) where no codecs
+// are registered. This is the codec-probe primitive that source selection is built on.
+export function canPlayVideoType(mimeType) {
+    const probe = document.createElement('video');
+    return probe.canPlayType(mimeType) !== '';
+}
+// Sniffs a container MIME type from the leading bytes of encoded video, or null when unrecognised.
+// Mirrors detectImageMimeType. mkv and webm share the Matroska/EBML signature (the DocType that
+// separates them lives deeper in the stream), so both report as 'video/webm', the web-canonical one.
+export function detectVideoMimeType(data) {
+    const b = data instanceof Uint8Array ? data : new Uint8Array(data);
+    if (b.byteLength < 4)
+        return null;
+    // ISO Base Media (mp4/m4v): a 'ftyp' box tag at bytes 4-7 (66 74 79 70).
+    if (b.byteLength >= 8 && b[4] === 0x66 && b[5] === 0x74 && b[6] === 0x79 && b[7] === 0x70)
+        return 'video/mp4';
+    // Matroska/WebM (EBML header): 1A 45 DF A3.
+    if (b[0] === 0x1a && b[1] === 0x45 && b[2] === 0xdf && b[3] === 0xa3)
+        return 'video/webm';
+    // Ogg: 'OggS' (4F 67 67 53).
+    if (b[0] === 0x4f && b[1] === 0x67 && b[2] === 0x67 && b[3] === 0x53)
+        return 'video/ogg';
+    return null;
+}
+export function inferVideoMimeType(url) {
     const ext = url.split('?')[0].split('.').pop()?.toLowerCase();
     switch (ext) {
         case 'mp4':
@@ -6,13 +31,31 @@ export function inferVideoType(url) {
             return 'video/mp4';
         case 'webm':
             return 'video/webm';
+        case 'mkv':
+            return 'video/x-matroska';
         case 'ogv':
         case 'ogg':
             return 'video/ogg';
         case 'mov':
             return 'video/quicktime';
+        case '3gp':
+            return 'video/3gpp';
+        case 'm3u8':
+            return 'application/vnd.apple.mpegurl';
+        case 'mpd':
+            return 'application/dash+xml';
         default:
             return null;
     }
 }
+// Picks the first source the environment can play, resolving each source's MIME type from its
+// explicit `type` or, failing that, its URL extension. Returns null when none is playable — the
+// source-negotiation primitive behind loadVideoResourceFromUrls.
+export function selectVideoResourceUrl(sources) {
+    for (const source of sources) {
+        if (canPlayVideoType(source.type ?? inferVideoMimeType(source.url) ?? ''))
+            return source;
+    }
+    return null;
+}
 //# sourceMappingURL=videoFormat.js.map

package/dist/videoFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"videoFormat.js","sourceRoot":"","sources":["../src/videoFormat.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,CAAC;IAC9D,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,KAAK,CAAC;QACX,KAAK,KAAK;YACR,OAAO,WAAW,CAAC;QACrB,KAAK,MAAM;YACT,OAAO,YAAY,CAAC;QACtB,KAAK,KAAK,CAAC;QACX,KAAK,KAAK;YACR,OAAO,WAAW,CAAC;QACrB,KAAK,KAAK;YACR,OAAO,iBAAiB,CAAC;QAC3B;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}
+{"version":3,"file":"videoFormat.js","sourceRoot":"","sources":["../src/videoFormat.ts"],"names":[],"mappings":"AAEA,oGAAoG;AACpG,kGAAkG;AAClG,uFAAuF;AACvF,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAC9C,OAAO,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;AAC5C,CAAC;AAED,mGAAmG;AACnG,gGAAgG;AAChG,qGAAqG;AACrG,MAAM,UAAU,mBAAmB,CAAC,IAA8B;IAChE,MAAM,CAAC,GAAG,IAAI,YAAY,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IACnE,IAAI,CAAC,CAAC,UAAU,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAElC,yEAAyE;IACzE,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,WAAW,CAAC;IAE9G,4CAA4C;IAC5C,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,YAAY,CAAC;IAE1F,6BAA6B;IAC7B,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,WAAW,CAAC;IAEzF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,CAAC;IAC9D,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,KAAK,CAAC;QACX,KAAK,KAAK;YACR,OAAO,WAAW,CAAC;QACrB,KAAK,MAAM;YACT,OAAO,YAAY,CAAC;QACtB,KAAK,KAAK;YACR,OAAO,kBAAkB,CAAC;QAC5B,KAAK,KAAK,CAAC;QACX,KAAK,KAAK;YACR,OAAO,WAAW,CAAC;QACrB,KAAK,KAAK;YACR,OAAO,iBAAiB,CAAC;QAC3B,KAAK,KAAK;YACR,OAAO,YAAY,CAAC;QACtB,KAAK,MAAM;YACT,OAAO,+BAA+B,CAAC;QACzC,KAAK,KAAK;YACR,OAAO,sBAAsB,CAAC;QAChC;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,8FAA8F;AAC9F,gGAAgG;AAChG,iEAAiE;AACjE,MAAM,UAAU,sBAAsB,CAAC,OAAqC;IAC1E,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,gBAAgB,CAAC,MAAM,CAAC,IAAI,IAAI,kBAAkB,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YAAE,OAAO,MAAM,CAAC;IAC3F,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/videoResource.d.ts

@@ -1,3 +1,10 @@
 import type { VideoResource } from '@flighthq/types';
 export declare function createVideoResource(element?: HTMLVideoElement): VideoResource;
+export declare function disposeVideoResource(resource: VideoResource): void;
+export declare function getVideoResourceDuration(resource: Readonly<VideoResource>): number;
+export declare function getVideoResourceHeight(resource: Readonly<VideoResource>): number;
+export declare function getVideoResourceWidth(resource: Readonly<VideoResource>): number;
+export declare function hasVideoResourceElement(resource: Readonly<VideoResource>): boolean;
+export declare function isVideoResourceEmpty(resource: Readonly<VideoResource>): boolean;
+export declare function isVideoResourceReady(resource: Readonly<VideoResource>): boolean;
 //# sourceMappingURL=videoResource.d.ts.map

package/dist/videoResource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"videoResource.d.ts","sourceRoot":"","sources":["../src/videoResource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,aAAa,CAE7E"}
+{"version":3,"file":"videoResource.d.ts","sourceRoot":"","sources":["../src/videoResource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAKrD,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,aAAa,CAE7E;AAKD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAOlE;AAID,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,MAAM,CAElF;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,MAAM,CAEhF;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,MAAM,CAE/E;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,OAAO,CAElF;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,OAAO,CAG/E;AAID,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,OAAO,CAG/E"}

package/dist/videoResource.js

@@ -1,4 +1,44 @@
+// No cloneVideoResource: a VideoResource is a thin carrier over a single HTMLVideoElement, and an
+// element cannot be duplicated (each carries its own decoder and playback position). Wrap the same
+// element in a second createVideoResource call if two carriers over one stream are truly wanted.
 export function createVideoResource(element) {
     return { element: element ?? null };
 }
+// Releases the decoder the element holds: clearing the src and calling load() detaches the media
+// resource so the browser can free its buffers, then the element reference is dropped for GC. Unlike
+// destroy*, there is no non-GC handle to free here — the element is plain GC-managed memory.
+export function disposeVideoResource(resource) {
+    const element = resource.element;
+    if (element !== null) {
+        element.removeAttribute('src');
+        element.load();
+    }
+    resource.element = null;
+}
+// Duration in seconds of the loaded media, or 0 when no element is attached. May be NaN before
+// metadata has loaded and Infinity for open-ended live streams — both come straight from the element.
+export function getVideoResourceDuration(resource) {
+    return resource.element !== null ? resource.element.duration : 0;
+}
+export function getVideoResourceHeight(resource) {
+    return resource.element !== null ? resource.element.videoHeight : 0;
+}
+export function getVideoResourceWidth(resource) {
+    return resource.element !== null ? resource.element.videoWidth : 0;
+}
+export function hasVideoResourceElement(resource) {
+    return resource.element !== null;
+}
+export function isVideoResourceEmpty(resource) {
+    const element = resource.element;
+    return element === null || element.videoWidth <= 0 || element.videoHeight <= 0;
+}
+// True once the element has decoded at least the current frame (readyState >= HAVE_CURRENT_DATA), so
+// its videoWidth/videoHeight are known and a frame is available to sample or upload to a texture.
+export function isVideoResourceReady(resource) {
+    const element = resource.element;
+    return element !== null && element.readyState >= HAVE_CURRENT_DATA;
+}
+// HTMLMediaElement.HAVE_CURRENT_DATA — data for the current playback position is available.
+const HAVE_CURRENT_DATA = 2;
 //# sourceMappingURL=videoResource.js.map

package/dist/videoResource.js.map

@@ -1 +1 @@
-{"version":3,"file":"videoResource.js","sourceRoot":"","sources":["../src/videoResource.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,mBAAmB,CAAC,OAA0B;IAC5D,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,CAAC;AACtC,CAAC"}
+{"version":3,"file":"videoResource.js","sourceRoot":"","sources":["../src/videoResource.ts"],"names":[],"mappings":"AAEA,kGAAkG;AAClG,mGAAmG;AACnG,iGAAiG;AACjG,MAAM,UAAU,mBAAmB,CAAC,OAA0B;IAC5D,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,CAAC;AACtC,CAAC;AAED,iGAAiG;AACjG,qGAAqG;AACrG,6FAA6F;AAC7F,MAAM,UAAU,oBAAoB,CAAC,QAAuB;IAC1D,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;IACjC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QAC/B,OAAO,CAAC,IAAI,EAAE,CAAC;IACjB,CAAC;IACD,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;AAC1B,CAAC;AAED,+FAA+F;AAC/F,sGAAsG;AACtG,MAAM,UAAU,wBAAwB,CAAC,QAAiC;IACxE,OAAO,QAAQ,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAiC;IACtE,OAAO,QAAQ,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAiC;IACrE,OAAO,QAAQ,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,QAAiC;IACvE,OAAO,QAAQ,CAAC,OAAO,KAAK,IAAI,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAiC;IACpE,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;IACjC,OAAO,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,UAAU,IAAI,CAAC,IAAI,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC;AACjF,CAAC;AAED,qGAAqG;AACrG,kGAAkG;AAClG,MAAM,UAAU,oBAAoB,CAAC,QAAiC;IACpE,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;IACjC,OAAO,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,UAAU,IAAI,iBAAiB,CAAC;AACrE,CAAC;AAED,4FAA4F;AAC5F,MAAM,iBAAiB,GAAG,CAAC,CAAC"}

package/dist/videoResourceFrom.d.ts

@@ -1,4 +1,6 @@
-import type { VideoResource, VideoResourceUrl } from '@flighthq/types';
-export declare function loadVideoResourceFromUrl(url: string, signal?: AbortSignal): Promise<VideoResource>;
-export declare function loadVideoResourceFromUrls(sources: VideoResourceUrl[], signal?: AbortSignal): Promise<VideoResource>;
+import type { VideoResource, VideoResourceLoadOptions, VideoResourceUrl } from '@flighthq/types';
+export declare function createVideoResourceFromMediaStream(stream: MediaStream): VideoResource;
+export declare function loadVideoResourceFromBlob(blob: Blob, options?: Readonly<VideoResourceLoadOptions>, signal?: AbortSignal): Promise<VideoResource>;
+export declare function loadVideoResourceFromUrl(url: string, options?: Readonly<VideoResourceLoadOptions>, signal?: AbortSignal): Promise<VideoResource>;
+export declare function loadVideoResourceFromUrls(sources: Readonly<VideoResourceUrl[]>, options?: Readonly<VideoResourceLoadOptions>, signal?: AbortSignal): Promise<VideoResource>;
 //# sourceMappingURL=videoResourceFrom.d.ts.map

package/dist/videoResourceFrom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"videoResourceFrom.d.ts","sourceRoot":"","sources":["../src/videoResourceFrom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAKvE,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAkClG;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,gBAAgB,EAAE,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAKnH"}
+{"version":3,"file":"videoResourceFrom.d.ts","sourceRoot":"","sources":["../src/videoResourceFrom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAOjG,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,WAAW,GAAG,aAAa,CAIrF;AAID,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,QAAQ,CAAC,wBAAwB,CAAC,EAC5C,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAOxB;AAED,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,QAAQ,CAAC,wBAAwB,CAAC,EAC5C,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAuCxB;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,QAAQ,CAAC,gBAAgB,EAAE,CAAC,EACrC,OAAO,CAAC,EAAE,QAAQ,CAAC,wBAAwB,CAAC,EAC5C,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAIxB"}

package/dist/videoResourceFrom.js

@@ -1,12 +1,38 @@
-import { inferVideoType } from './videoFormat';
+import { selectVideoResourceUrl } from './videoFormat';
 import { createVideoResource } from './videoResource';
-export function loadVideoResourceFromUrl(url, signal) {
+// Wraps a live MediaStream (camera, screen capture, canvas.captureStream) as a video resource by
+// assigning it to element.srcObject. Pure DOM, no load — the stream feeds frames as they arrive.
+export function createVideoResourceFromMediaStream(stream) {
+    const element = document.createElement('video');
+    element.srcObject = stream;
+    return createVideoResource(element);
+}
+// Loads from a Blob by wrapping it in an object URL. This function owns that URL and revokes it once
+// the load settles (success or failure), so the caller never has to.
+export async function loadVideoResourceFromBlob(blob, options, signal) {
+    const url = URL.createObjectURL(blob);
+    try {
+        return await loadVideoResourceFromUrl(url, options, signal);
+    }
+    finally {
+        URL.revokeObjectURL(url);
+    }
+}
+export function loadVideoResourceFromUrl(url, options, signal) {
     if (signal?.aborted)
         return Promise.reject(signal.reason);
     return new Promise((resolve, reject) => {
         const element = document.createElement('video');
-        element.preload = 'auto';
-        const onCanPlay = () => {
+        element.preload = (options?.preload ?? 'auto');
+        // crossOrigin must be set before assigning src so the fetched frames stay untainted for GPU upload.
+        if (options?.crossOrigin !== undefined)
+            element.crossOrigin = options.crossOrigin;
+        if (options?.muted !== undefined)
+            element.muted = options.muted;
+        if (options?.playsInline !== undefined)
+            element.playsInline = options.playsInline;
+        const readyEvent = readinessEventName(options?.readiness);
+        const onReady = () => {
             cleanup();
             resolve(createVideoResource(element));
         };
@@ -20,23 +46,33 @@ export function loadVideoResourceFromUrl(url, signal) {
             reject(signal.reason);
         };
         const cleanup = () => {
-            element.removeEventListener('canplay', onCanPlay);
+            element.removeEventListener(readyEvent, onReady);
             element.removeEventListener('error', onError);
             if (signal !== undefined)
                 signal.removeEventListener('abort', onAbort);
         };
-        element.addEventListener('canplay', onCanPlay, { once: true });
+        element.addEventListener(readyEvent, onReady, { once: true });
         element.addEventListener('error', onError, { once: true });
         if (signal !== undefined)
             signal.addEventListener('abort', onAbort, { once: true });
         element.src = url;
     });
 }
-export function loadVideoResourceFromUrls(sources, signal) {
-    const probe = document.createElement('video');
-    const selected = sources.find(({ url, type }) => probe.canPlayType(type ?? inferVideoType(url) ?? '') !== '');
-    if (selected === undefined)
+export function loadVideoResourceFromUrls(sources, options, signal) {
+    const selected = selectVideoResourceUrl(sources);
+    if (selected === null)
         return Promise.resolve(createVideoResource());
-    return loadVideoResourceFromUrl(selected.url, signal);
+    return loadVideoResourceFromUrl(selected.url, options, signal);
+}
+// Maps a readiness mode to the media event that resolves the load; defaults to 'canplay'.
+function readinessEventName(readiness) {
+    switch (readiness) {
+        case 'metadata':
+            return 'loadedmetadata';
+        case 'canplaythrough':
+            return 'canplaythrough';
+        default:
+            return 'canplay';
+    }
 }
 //# sourceMappingURL=videoResourceFrom.js.map

package/dist/videoResourceFrom.js.map

@@ -1 +1 @@
-{"version":3,"file":"videoResourceFrom.js","sourceRoot":"","sources":["../src/videoResourceFrom.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtD,MAAM,UAAU,wBAAwB,CAAC,GAAW,EAAE,MAAoB;IACxE,IAAI,MAAM,EAAE,OAAO;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAChD,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC;QAEzB,MAAM,SAAS,GAAG,GAAS,EAAE;YAC3B,OAAO,EAAE,CAAC;YACV,OAAO,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC;QACxC,CAAC,CAAC;QAEF,MAAM,OAAO,GAAG,GAAS,EAAE;YACzB,OAAO,EAAE,CAAC;YACV,MAAM,CAAC,IAAI,KAAK,CAAC,yBAAyB,GAAG,EAAE,CAAC,CAAC,CAAC;QACpD,CAAC,CAAC;QAEF,MAAM,OAAO,GAAG,GAAS,EAAE;YACzB,OAAO,EAAE,CAAC;YACV,OAAO,CAAC,GAAG,GAAG,EAAE,CAAC;YACjB,MAAM,CAAC,MAAO,CAAC,MAAM,CAAC,CAAC;QACzB,CAAC,CAAC;QAEF,MAAM,OAAO,GAAG,GAAS,EAAE;YACzB,OAAO,CAAC,mBAAmB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YAClD,OAAO,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC9C,IAAI,MAAM,KAAK,SAAS;gBAAE,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACzE,CAAC,CAAC;QAEF,OAAO,CAAC,gBAAgB,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,OAAO,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAEpF,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC;IACpB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,OAA2B,EAAE,MAAoB;IACzF,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;IAC9G,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC1E,OAAO,wBAAwB,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AACxD,CAAC"}
+{"version":3,"file":"videoResourceFrom.js","sourceRoot":"","sources":["../src/videoResourceFrom.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,11 @@
 {
   "name": "@flighthq/video",
-  "version": "0.1.0",
+  "version": "0.2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/flighthq/flight.git",
+    "directory": "packages/video"
+  },
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -27,7 +32,7 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/types": "0.1.0"
+    "@flighthq/types": "0.2.0"
   },
   "devDependencies": {
     "typescript": "^5.3.0"

package/src/videoFormat.test.ts

@@ -1,39 +1,125 @@
-import { inferVideoType } from './videoFormat';
+import { canPlayVideoType, detectVideoMimeType, inferVideoMimeType, selectVideoResourceUrl } from './videoFormat';
 
-describe('inferVideoType', () => {
+afterEach(() => {
+  vi.restoreAllMocks();
+});
+
+describe('canPlayVideoType', () => {
+  it('is false in jsdom where no codecs are registered', () => {
+    expect(canPlayVideoType('video/mp4')).toBe(false);
+  });
+
+  it('is true when the element reports it can play the type', () => {
+    vi.spyOn(HTMLVideoElement.prototype, 'canPlayType').mockReturnValue('probably');
+    expect(canPlayVideoType('video/mp4')).toBe(true);
+  });
+});
+
+describe('detectVideoMimeType', () => {
+  it('returns null for a buffer that is too small', () => {
+    expect(detectVideoMimeType(new ArrayBuffer(2))).toBeNull();
+  });
+
+  it('returns null for an unrecognised header', () => {
+    expect(detectVideoMimeType(new Uint8Array([0x00, 0x01, 0x02, 0x03]))).toBeNull();
+  });
+
+  it('detects an mp4 ftyp box', () => {
+    const b = new Uint8Array([0x00, 0x00, 0x00, 0x18, 0x66, 0x74, 0x79, 0x70]);
+    expect(detectVideoMimeType(b)).toBe('video/mp4');
+  });
+
+  it('detects a Matroska/WebM EBML header', () => {
+    expect(detectVideoMimeType(new Uint8Array([0x1a, 0x45, 0xdf, 0xa3]))).toBe('video/webm');
+  });
+
+  it('detects an Ogg stream', () => {
+    expect(detectVideoMimeType(new Uint8Array([0x4f, 0x67, 0x67, 0x53]))).toBe('video/ogg');
+  });
+
+  it('accepts an ArrayBuffer as well as a Uint8Array', () => {
+    const buf = new ArrayBuffer(8);
+    new Uint8Array(buf).set([0x00, 0x00, 0x00, 0x18, 0x66, 0x74, 0x79, 0x70]);
+    expect(detectVideoMimeType(buf)).toBe('video/mp4');
+  });
+});
+
+describe('inferVideoMimeType', () => {
   it('returns "video/mp4" for .mp4 files', () => {
-    expect(inferVideoType('clip.mp4')).toBe('video/mp4');
+    expect(inferVideoMimeType('clip.mp4')).toBe('video/mp4');
   });
 
   it('returns "video/mp4" for .m4v files', () => {
-    expect(inferVideoType('clip.m4v')).toBe('video/mp4');
+    expect(inferVideoMimeType('clip.m4v')).toBe('video/mp4');
   });
 
   it('returns "video/webm" for .webm files', () => {
-    expect(inferVideoType('clip.webm')).toBe('video/webm');
+    expect(inferVideoMimeType('clip.webm')).toBe('video/webm');
+  });
+
+  it('returns "video/x-matroska" for .mkv files', () => {
+    expect(inferVideoMimeType('clip.mkv')).toBe('video/x-matroska');
   });
 
   it('returns "video/ogg" for .ogv files', () => {
-    expect(inferVideoType('clip.ogv')).toBe('video/ogg');
+    expect(inferVideoMimeType('clip.ogv')).toBe('video/ogg');
   });
 
   it('returns "video/ogg" for .ogg files', () => {
-    expect(inferVideoType('clip.ogg')).toBe('video/ogg');
+    expect(inferVideoMimeType('clip.ogg')).toBe('video/ogg');
   });
 
   it('returns "video/quicktime" for .mov files', () => {
-    expect(inferVideoType('clip.mov')).toBe('video/quicktime');
+    expect(inferVideoMimeType('clip.mov')).toBe('video/quicktime');
+  });
+
+  it('returns "video/3gpp" for .3gp files', () => {
+    expect(inferVideoMimeType('clip.3gp')).toBe('video/3gpp');
+  });
+
+  it('returns the HLS playlist type for .m3u8 files', () => {
+    expect(inferVideoMimeType('stream.m3u8')).toBe('application/vnd.apple.mpegurl');
+  });
+
+  it('returns the DASH manifest type for .mpd files', () => {
+    expect(inferVideoMimeType('stream.mpd')).toBe('application/dash+xml');
   });
 
   it('returns null for unrecognized extensions', () => {
-    expect(inferVideoType('clip.avi')).toBeNull();
+    expect(inferVideoMimeType('clip.avi')).toBeNull();
   });
 
   it('strips query parameters before matching', () => {
-    expect(inferVideoType('clip.mp4?t=0')).toBe('video/mp4');
+    expect(inferVideoMimeType('clip.mp4?t=0')).toBe('video/mp4');
   });
 
   it('returns null for a URL with no extension', () => {
-    expect(inferVideoType('video')).toBeNull();
+    expect(inferVideoMimeType('video')).toBeNull();
+  });
+});
+
+describe('selectVideoResourceUrl', () => {
+  it('returns null when no source is playable', () => {
+    expect(selectVideoResourceUrl([{ url: 'clip.mp4' }])).toBeNull();
+  });
+
+  it('returns null for an empty source list', () => {
+    expect(selectVideoResourceUrl([])).toBeNull();
+  });
+
+  it('picks the first source whose inferred type is playable', () => {
+    vi.spyOn(HTMLVideoElement.prototype, 'canPlayType').mockImplementation((type) =>
+      type === 'video/webm' ? 'probably' : '',
+    );
+    const selected = selectVideoResourceUrl([{ url: 'clip.mp4' }, { url: 'clip.webm' }]);
+    expect(selected?.url).toBe('clip.webm');
+  });
+
+  it('honours an explicit type over the URL extension', () => {
+    vi.spyOn(HTMLVideoElement.prototype, 'canPlayType').mockImplementation((type) =>
+      type === 'video/mp4' ? 'maybe' : '',
+    );
+    const selected = selectVideoResourceUrl([{ url: 'stream', type: 'video/mp4' }]);
+    expect(selected?.url).toBe('stream');
   });
 });

package/src/videoResource.test.ts

@@ -1,4 +1,13 @@
-import { createVideoResource } from './videoResource';
+import {
+  createVideoResource,
+  disposeVideoResource,
+  getVideoResourceDuration,
+  getVideoResourceHeight,
+  getVideoResourceWidth,
+  hasVideoResourceElement,
+  isVideoResourceEmpty,
+  isVideoResourceReady,
+} from './videoResource';
 
 describe('createVideoResource', () => {
   it('returns a resource with null element when called with no arguments', () => {
@@ -12,3 +21,96 @@ describe('createVideoResource', () => {
     expect(resource.element).toBe(element);
   });
 });
+
+describe('disposeVideoResource', () => {
+  it('clears the src, reloads to release the decoder, and drops the element', () => {
+    const removeAttribute = vi.fn();
+    const load = vi.fn();
+    const element = { removeAttribute, load } as unknown as HTMLVideoElement;
+    const resource = createVideoResource(element);
+
+    disposeVideoResource(resource);
+
+    expect(removeAttribute).toHaveBeenCalledWith('src');
+    expect(load).toHaveBeenCalledOnce();
+    expect(resource.element).toBeNull();
+  });
+
+  it('is a no-op on an already element-less resource', () => {
+    const resource = createVideoResource();
+    disposeVideoResource(resource);
+    expect(resource.element).toBeNull();
+  });
+});
+
+describe('getVideoResourceDuration', () => {
+  it('returns 0 when there is no element', () => {
+    expect(getVideoResourceDuration(createVideoResource())).toBe(0);
+  });
+
+  it('reads duration from the element', () => {
+    const element = { duration: 12.5 } as HTMLVideoElement;
+    expect(getVideoResourceDuration(createVideoResource(element))).toBe(12.5);
+  });
+});
+
+describe('getVideoResourceHeight', () => {
+  it('returns 0 when there is no element', () => {
+    expect(getVideoResourceHeight(createVideoResource())).toBe(0);
+  });
+
+  it('reads videoHeight from the element', () => {
+    const element = { videoHeight: 480 } as HTMLVideoElement;
+    expect(getVideoResourceHeight(createVideoResource(element))).toBe(480);
+  });
+});
+
+describe('getVideoResourceWidth', () => {
+  it('returns 0 when there is no element', () => {
+    expect(getVideoResourceWidth(createVideoResource())).toBe(0);
+  });
+
+  it('reads videoWidth from the element', () => {
+    const element = { videoWidth: 640 } as HTMLVideoElement;
+    expect(getVideoResourceWidth(createVideoResource(element))).toBe(640);
+  });
+});
+
+describe('hasVideoResourceElement', () => {
+  it('is false without an element and true with one', () => {
+    expect(hasVideoResourceElement(createVideoResource())).toBe(false);
+    expect(hasVideoResourceElement(createVideoResource(document.createElement('video')))).toBe(true);
+  });
+});
+
+describe('isVideoResourceEmpty', () => {
+  it('is true when there is no element', () => {
+    expect(isVideoResourceEmpty(createVideoResource())).toBe(true);
+  });
+
+  it('is true when the element has no decoded dimensions', () => {
+    const element = { videoWidth: 0, videoHeight: 0 } as HTMLVideoElement;
+    expect(isVideoResourceEmpty(createVideoResource(element))).toBe(true);
+  });
+
+  it('is false once the element reports dimensions', () => {
+    const element = { videoWidth: 640, videoHeight: 480 } as HTMLVideoElement;
+    expect(isVideoResourceEmpty(createVideoResource(element))).toBe(false);
+  });
+});
+
+describe('isVideoResourceReady', () => {
+  it('is false when there is no element', () => {
+    expect(isVideoResourceReady(createVideoResource())).toBe(false);
+  });
+
+  it('is false while readyState is below HAVE_CURRENT_DATA', () => {
+    const element = { readyState: 1 } as HTMLVideoElement;
+    expect(isVideoResourceReady(createVideoResource(element))).toBe(false);
+  });
+
+  it('is true once readyState reaches HAVE_CURRENT_DATA', () => {
+    const element = { readyState: 2 } as HTMLVideoElement;
+    expect(isVideoResourceReady(createVideoResource(element))).toBe(true);
+  });
+});

package/src/videoResourceFrom.test.ts

@@ -1,4 +1,59 @@
-import { loadVideoResourceFromUrl, loadVideoResourceFromUrls } from './videoResourceFrom';
+import {
+  createVideoResourceFromMediaStream,
+  loadVideoResourceFromBlob,
+  loadVideoResourceFromUrl,
+  loadVideoResourceFromUrls,
+} from './videoResourceFrom';
+
+// Capture every <video> the loaders create so tests can drive its media events synchronously.
+let created: HTMLVideoElement[];
+
+beforeEach(() => {
+  created = [];
+  const original = document.createElement.bind(document);
+  vi.spyOn(document, 'createElement').mockImplementation(((tag: string, options?: ElementCreationOptions) => {
+    const element = original(tag, options);
+    if (tag === 'video') created.push(element as HTMLVideoElement);
+    return element;
+  }) as typeof document.createElement);
+});
+
+afterEach(() => {
+  vi.restoreAllMocks();
+});
+
+function lastVideo(): HTMLVideoElement {
+  return created[created.length - 1];
+}
+
+describe('createVideoResourceFromMediaStream', () => {
+  it('wraps a MediaStream by assigning it to srcObject', () => {
+    const stream = {} as MediaStream;
+    const resource = createVideoResourceFromMediaStream(stream);
+    expect(resource.element).not.toBeNull();
+    expect(resource.element!.srcObject).toBe(stream);
+  });
+});
+
+describe('loadVideoResourceFromBlob', () => {
+  it('revokes the object URL after a successful load', async () => {
+    vi.spyOn(URL, 'createObjectURL').mockReturnValue('blob:mock');
+    const revokeSpy = vi.spyOn(URL, 'revokeObjectURL');
+    const promise = loadVideoResourceFromBlob(new Blob([], { type: 'video/mp4' }));
+    lastVideo().dispatchEvent(new Event('canplay'));
+    await promise;
+    expect(revokeSpy).toHaveBeenCalledWith('blob:mock');
+  });
+
+  it('revokes the object URL even when the load fails', async () => {
+    vi.spyOn(URL, 'createObjectURL').mockReturnValue('blob:mock');
+    const revokeSpy = vi.spyOn(URL, 'revokeObjectURL');
+    const promise = loadVideoResourceFromBlob(new Blob([], { type: 'video/mp4' }));
+    lastVideo().dispatchEvent(new Event('error'));
+    await expect(promise).rejects.toThrow('Failed to load video');
+    expect(revokeSpy).toHaveBeenCalledWith('blob:mock');
+  });
+});
 
 describe('loadVideoResourceFromUrl', () => {
   it('returns a Promise', () => {
@@ -7,16 +62,60 @@ describe('loadVideoResourceFromUrl', () => {
     expect(result).toBeInstanceOf(Promise);
   });
 
+  it('defaults preload to auto and resolves on canplay when options are omitted', async () => {
+    const promise = loadVideoResourceFromUrl('test.mp4');
+    const element = lastVideo();
+    expect(element.preload).toBe('auto');
+    element.dispatchEvent(new Event('canplay'));
+    const resource = await promise;
+    expect(resource.element).toBe(element);
+  });
+
+  it('applies crossOrigin, muted, and preload from options', async () => {
+    const promise = loadVideoResourceFromUrl('test.mp4', {
+      crossOrigin: 'anonymous',
+      muted: true,
+      preload: 'metadata',
+    });
+    const element = lastVideo();
+    expect(element.crossOrigin).toBe('anonymous');
+    expect(element.muted).toBe(true);
+    expect(element.preload).toBe('metadata');
+    element.dispatchEvent(new Event('canplay'));
+    await promise;
+  });
+
+  it('resolves on loadedmetadata when readiness is "metadata"', async () => {
+    const promise = loadVideoResourceFromUrl('test.mp4', { readiness: 'metadata' });
+    const element = lastVideo();
+    element.dispatchEvent(new Event('loadedmetadata'));
+    const resource = await promise;
+    expect(resource.element).toBe(element);
+  });
+
+  it('resolves on canplaythrough when readiness is "canplaythrough"', async () => {
+    const promise = loadVideoResourceFromUrl('test.mp4', { readiness: 'canplaythrough' });
+    const element = lastVideo();
+    element.dispatchEvent(new Event('canplaythrough'));
+    const resource = await promise;
+    expect(resource.element).toBe(element);
+  });
+
+  it('rejects when the element emits an error', async () => {
+    const promise = loadVideoResourceFromUrl('bad.mp4');
+    lastVideo().dispatchEvent(new Event('error'));
+    await expect(promise).rejects.toThrow('Failed to load video: bad.mp4');
+  });
+
   it('rejects immediately when the signal is already aborted', async () => {
     const controller = new AbortController();
-    const reason = new Error('pre-aborted');
-    controller.abort(reason);
-    await expect(loadVideoResourceFromUrl('test.mp4', controller.signal)).rejects.toThrow('pre-aborted');
+    controller.abort(new Error('pre-aborted'));
+    await expect(loadVideoResourceFromUrl('test.mp4', undefined, controller.signal)).rejects.toThrow('pre-aborted');
   });
 
   it('rejects when the signal is aborted after the call', async () => {
     const controller = new AbortController();
-    const promise = loadVideoResourceFromUrl('test.mp4', controller.signal);
+    const promise = loadVideoResourceFromUrl('test.mp4', undefined, controller.signal);
     controller.abort(new Error('cancelled'));
     await expect(promise).rejects.toThrow('cancelled');
   });
@@ -28,8 +127,17 @@ describe('loadVideoResourceFromUrls', () => {
     expect(resource.element).toBeNull();
   });
 
-  it('resolves to a null-element resource when no source passes canPlayType in jsdom', async () => {
+  it('resolves to a null-element resource when no source is playable in jsdom', async () => {
     const resource = await loadVideoResourceFromUrls([{ url: 'test.mp4' }]);
     expect(resource.element).toBeNull();
   });
+
+  it('loads the first playable source', async () => {
+    vi.spyOn(HTMLVideoElement.prototype, 'canPlayType').mockReturnValue('probably');
+    const promise = loadVideoResourceFromUrls([{ url: 'clip.mp4' }]);
+    const element = lastVideo();
+    element.dispatchEvent(new Event('canplay'));
+    const resource = await promise;
+    expect(resource.element).toBe(element);
+  });
 });