@flighthq/webcam 0.5.0-next.1944.cd6b6e7 → 0.5.1-edge.638.d4dbd4e

package/README.md

@@ -13,5 +13,5 @@ Import the supported application-facing API from `@flighthq/webcam`. The `@fligh
 This package is part of the locked-version Flight SDK graph. Applications may instead install and import `@flighthq/sdk` when package-level tree shaking is sufficient.
 
 - [Flight project](https://github.com/flighthq/flight)
-- [Source for @flighthq/webcam@0.5.0-next.1944.cd6b6e7](https://github.com/flighthq/flight/tree/cd6b6e71eb472b3a4249830a7743333f019fa7b7/packages/webcam)
-- [License](https://github.com/flighthq/flight/blob/cd6b6e71eb472b3a4249830a7743333f019fa7b7/LICENSE.md)
+- [Source for @flighthq/webcam@0.5.1-edge.638.d4dbd4e](https://github.com/flighthq/flight/tree/d4dbd4e347dc8be10b180c85a766ab50333dcb51/packages/webcam)
+- [License](https://github.com/flighthq/flight/blob/d4dbd4e347dc8be10b180c85a766ab50333dcb51/LICENSE.md)

package/dist/contract.d.ts

@@ -1,3 +1,2 @@
-export * from './webcam';
-export * from './webcamStream';
+export * from './mediaFileCapture';
 //# 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,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/dist/contract.js

@@ -1,3 +1,2 @@
-export * from './webcam';
-export * from './webcamStream';
+export * from './mediaFileCapture';
 //# 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,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export { explainWebcamBackend, createWebcamStreamEntity, recordWebcamVideo, requestWebcamPermission, selectWebcamImage, takeWebcamPhoto, } from './contract';
+export { explainMediaFileCaptureBackend, recordMediaFileCaptureVideo, selectMediaFileCaptureImage, takeMediaFileCapturePhoto, } 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,oBAAoB,EACpB,wBAAwB,EACxB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,eAAe,GAChB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,2BAA2B,EAC3B,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-export { explainWebcamBackend, createWebcamStreamEntity, recordWebcamVideo, requestWebcamPermission, selectWebcamImage, takeWebcamPhoto, } from './contract';
+export { explainMediaFileCaptureBackend, recordMediaFileCaptureVideo, selectMediaFileCaptureImage, takeMediaFileCapturePhoto, } 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,oBAAoB,EACpB,wBAAwB,EACxB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,eAAe,GAChB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,2BAA2B,EAC3B,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,YAAY,CAAC"}

package/dist/mediaFileCapture.d.ts

@@ -0,0 +1,13 @@
+import type { BackendExplanation } from '@flighthq/types/contract';
+import type { MediaFileCaptureBackend, MediaFileCaptureOptions, MediaFileCapturePhoto, MediaFileCaptureVideo } from '@flighthq/types/contract';
+export declare function createWebMediaFileCaptureBackend(): MediaFileCaptureBackend;
+export declare function explainMediaFileCaptureBackend(): BackendExplanation;
+export declare function getMediaFileCaptureBackend(): MediaFileCaptureBackend;
+export declare function installMediaFileCaptureHostBackend(backend: MediaFileCaptureBackend): void;
+export declare function observeMediaFileCaptureHostResult(operation: string, succeeded: boolean): void;
+export declare function recordMediaFileCaptureVideo(options?: Readonly<MediaFileCaptureOptions>): Promise<MediaFileCaptureVideo | null>;
+export declare function resetMediaFileCaptureBackendForTest(): void;
+export declare function selectMediaFileCaptureImage(options?: Readonly<MediaFileCaptureOptions>): Promise<MediaFileCapturePhoto | null>;
+export declare function setMediaFileCaptureBackend(backend: MediaFileCaptureBackend | null): void;
+export declare function takeMediaFileCapturePhoto(options?: Readonly<MediaFileCaptureOptions>): Promise<MediaFileCapturePhoto | null>;
+//# sourceMappingURL=mediaFileCapture.d.ts.map

package/dist/mediaFileCapture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mediaFileCapture.d.ts","sourceRoot":"","sources":["../src/mediaFileCapture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EACV,uBAAuB,EACvB,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,0BAA0B,CAAC;AAKlC,wBAAgB,gCAAgC,IAAI,uBAAuB,CA0F1E;AAED,wBAAgB,8BAA8B,IAAI,kBAAkB,CAanE;AAED,wBAAgB,0BAA0B,IAAI,uBAAuB,CAEpE;AAED,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAMzF;AAED,wBAAgB,iCAAiC,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI,CAK7F;AAGD,wBAAgB,2BAA2B,CACzC,OAAO,CAAC,EAAE,QAAQ,CAAC,uBAAuB,CAAC,GAC1C,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAEvC;AAED,wBAAgB,mCAAmC,IAAI,IAAI,CAK1D;AAGD,wBAAgB,2BAA2B,CACzC,OAAO,CAAC,EAAE,QAAQ,CAAC,uBAAuB,CAAC,GAC1C,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAEvC;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,GAAG,IAAI,CAExF;AAGD,wBAAgB,yBAAyB,CACvC,OAAO,CAAC,EAAE,QAAQ,CAAC,uBAAuB,CAAC,GAC1C,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAEvC"}

package/dist/{webcam.js → mediaFileCapture.js}

@@ -1,12 +1,12 @@
 // Builds the default web backend over a transient <input type="file">. capture resolves to null when
 // the document is absent (jsdom), the user cancels, or the file cannot be read — capture is not
 // guaranteed. Real pixel dimensions are not decoded; width/height resolve to 0.
-export function createWebWebcamBackend() {
+export function createWebMediaFileCaptureBackend() {
     return {
         capture(options) {
             return new Promise((resolve) => {
                 if (typeof document === 'undefined' || typeof document.createElement !== 'function') {
-                    observeWebcamHostResult('capture', false);
+                    observeMediaFileCaptureHostResult('capture', false);
                     resolve(null);
                     return;
                 }
@@ -16,32 +16,35 @@ export function createWebWebcamBackend() {
                     input.accept = 'image/*';
                     if (options.source === 'camera')
                         input.capture = 'environment';
+                    const settle = (value) => {
+                        input.onchange = null;
+                        input.oncancel = null;
+                        observeMediaFileCaptureHostResult('capture', value !== null);
+                        resolve(value);
+                    };
                     input.onchange = () => {
                         const file = input.files?.[0] ?? null;
                         if (file === null) {
-                            resolve(null);
+                            settle(null);
                             return;
                         }
                         const reader = new FileReader();
                         reader.onload = () => {
-                            observeWebcamHostResult('capture', true);
-                            resolve({
+                            settle({
                                 dataUrl: typeof reader.result === 'string' ? reader.result : '',
                                 width: 0,
                                 height: 0,
                                 format: file.type,
                             });
                         };
-                        reader.onerror = () => {
-                            observeWebcamHostResult('capture', false);
-                            resolve(null);
-                        };
+                        reader.onerror = () => settle(null);
                         reader.readAsDataURL(file);
                     };
+                    input.oncancel = () => settle(null);
                     input.click();
                 }
                 catch {
-                    observeWebcamHostResult('capture', false);
+                    observeMediaFileCaptureHostResult('capture', false);
                     resolve(null);
                 }
             });
@@ -49,7 +52,7 @@ export function createWebWebcamBackend() {
         captureVideo(options) {
             return new Promise((resolve) => {
                 if (typeof document === 'undefined' || typeof document.createElement !== 'function') {
-                    observeWebcamHostResult('captureVideo', false);
+                    observeMediaFileCaptureHostResult('captureVideo', false);
                     resolve(null);
                     return;
                 }
@@ -59,59 +62,41 @@ export function createWebWebcamBackend() {
                     input.accept = 'video/*';
                     if (options.source === 'camera')
                         input.capture = 'environment';
+                    const settle = (value) => {
+                        input.onchange = null;
+                        input.oncancel = null;
+                        observeMediaFileCaptureHostResult('captureVideo', value !== null);
+                        resolve(value);
+                    };
                     input.onchange = () => {
                         const file = input.files?.[0] ?? null;
                         if (file === null) {
-                            resolve(null);
+                            settle(null);
                             return;
                         }
                         const reader = new FileReader();
                         reader.onload = () => {
-                            observeWebcamHostResult('captureVideo', true);
-                            resolve({
+                            settle({
                                 dataUrl: typeof reader.result === 'string' ? reader.result : '',
                                 duration: 0,
                                 format: file.type,
                             });
                         };
-                        reader.onerror = () => {
-                            observeWebcamHostResult('captureVideo', false);
-                            resolve(null);
-                        };
+                        reader.onerror = () => settle(null);
                         reader.readAsDataURL(file);
                     };
+                    input.oncancel = () => settle(null);
                     input.click();
                 }
                 catch {
-                    observeWebcamHostResult('captureVideo', false);
+                    observeMediaFileCaptureHostResult('captureVideo', false);
                     resolve(null);
                 }
             });
         },
-        async requestPermission() {
-            if (typeof navigator === 'undefined') {
-                observeWebcamHostResult('requestPermission', false);
-                return false;
-            }
-            try {
-                const permissions = navigator.permissions;
-                if (permissions === undefined || typeof permissions.query !== 'function') {
-                    observeWebcamHostResult('requestPermission', false);
-                    return false;
-                }
-                const status = await permissions.query({ name: 'camera' });
-                const granted = status.state === 'granted';
-                observeWebcamHostResult('requestPermission', granted);
-                return granted;
-            }
-            catch {
-                observeWebcamHostResult('requestPermission', false);
-                return false;
-            }
-        },
     };
 }
-export function explainWebcamBackend() {
+export function explainMediaFileCaptureBackend() {
     if (_custom !== null) {
         return { conflict: _hostConflict, layer: 'custom', operation: null, viability: 'unobserved' };
     }
@@ -125,10 +110,10 @@ export function explainWebcamBackend() {
     }
     return { conflict: false, layer: 'host-not-enabled', operation: null, viability: 'unobserved' };
 }
-export function getWebcamBackend() {
+export function getMediaFileCaptureBackend() {
     return _custom ?? _host ?? _sentinel;
 }
-export function installWebcamHostBackend(backend) {
+export function installMediaFileCaptureHostBackend(backend) {
     if (_host !== null) {
         if (_host !== backend)
             _hostConflict = true;
@@ -136,36 +121,32 @@ export function installWebcamHostBackend(backend) {
     }
     _host = backend;
 }
-export function observeWebcamHostResult(operation, succeeded) {
+export function observeMediaFileCaptureHostResult(operation, succeeded) {
     _hostObservation = {
         operation,
         viability: succeeded ? 'available' : 'runtime-api-unavailable',
     };
 }
 // Records a video from the device camera. Resolves null when cancelled, denied, or unavailable.
-export function recordWebcamVideo(options) {
-    return getWebcamBackend().captureVideo({ ...options, source: 'camera' });
+export function recordMediaFileCaptureVideo(options) {
+    return getMediaFileCaptureBackend().captureVideo({ ...options, source: 'camera' });
 }
-// Requests camera access permission. Resolves false when denied or when the host cannot prompt.
-export function requestWebcamPermission() {
-    return getWebcamBackend().requestPermission();
-}
-export function resetWebcamBackendForTest() {
+export function resetMediaFileCaptureBackendForTest() {
     _custom = null;
     _host = null;
     _hostConflict = false;
     _hostObservation = null;
 }
 // Picks an existing image from the photo library. Resolves null when cancelled or unavailable.
-export function selectWebcamImage(options) {
-    return getWebcamBackend().capture({ ...options, source: 'photos' });
+export function selectMediaFileCaptureImage(options) {
+    return getMediaFileCaptureBackend().capture({ ...options, source: 'photos' });
 }
-export function setWebcamBackend(backend) {
+export function setMediaFileCaptureBackend(backend) {
     _custom = backend;
 }
 // Captures a photo from the device camera. Resolves null when cancelled, denied, or unavailable.
-export function takeWebcamPhoto(options) {
-    return getWebcamBackend().capture({ ...options, source: 'camera' });
+export function takeMediaFileCapturePhoto(options) {
+    return getMediaFileCaptureBackend().capture({ ...options, source: 'camera' });
 }
 let _custom = null;
 let _host = null;
@@ -178,8 +159,5 @@ const _sentinel = {
     async captureVideo() {
         return null;
     },
-    async requestPermission() {
-        return false;
-    },
 };
-//# sourceMappingURL=webcam.js.map
+//# sourceMappingURL=mediaFileCapture.js.map

package/dist/mediaFileCapture.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/webcam",
-  "version": "0.5.0-next.1944.cd6b6e7",
+  "version": "0.5.1-edge.638.d4dbd4e",
   "author": "Joshua Granick and other contributors",
   "license": "MIT",
   "repository": {
@@ -38,8 +38,8 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/entity": "0.5.0-next.1944.cd6b6e7",
-    "@flighthq/types": "0.5.0-next.1944.cd6b6e7"
+    "@flighthq/entity": "0.5.1-edge.638.d4dbd4e",
+    "@flighthq/types": "0.5.1-edge.638.d4dbd4e"
   },
   "devDependencies": {
     "typescript": "^5.3.0"

package/src/mediaFileCapture.test.ts

@@ -0,0 +1,207 @@
+import type { MediaFileCaptureBackend, MediaFileCaptureOptions } from '@flighthq/types/contract';
+
+import {
+  createWebMediaFileCaptureBackend,
+  explainMediaFileCaptureBackend,
+  getMediaFileCaptureBackend,
+  installMediaFileCaptureHostBackend,
+  observeMediaFileCaptureHostResult,
+  recordMediaFileCaptureVideo,
+  resetMediaFileCaptureBackendForTest,
+  selectMediaFileCaptureImage,
+  setMediaFileCaptureBackend,
+  takeMediaFileCapturePhoto,
+} from './mediaFileCapture';
+
+function fakeBackend(): MediaFileCaptureBackend & { lastOptions: MediaFileCaptureOptions | null } {
+  return {
+    lastOptions: null,
+    async capture(options) {
+      this.lastOptions = { ...options };
+      return { dataUrl: 'data:image/png;base64,xx', width: 0, height: 0, format: 'image/png' };
+    },
+    async captureVideo(options) {
+      this.lastOptions = { ...options };
+      return { dataUrl: 'data:video/mp4;base64,xx', duration: 0, format: 'video/mp4' };
+    },
+  };
+}
+
+afterEach(() => setMediaFileCaptureBackend(null));
+
+describe('createWebMediaFileCaptureBackend', () => {
+  afterEach(() => vi.restoreAllMocks());
+
+  for (const method of ['capture', 'captureVideo'] as const) {
+    it(`${method} settles with null and detaches handlers when the picker is dismissed`, async () => {
+      const created: HTMLInputElement[] = [];
+      const createElement = document.createElement.bind(document);
+      vi.spyOn(document, 'createElement').mockImplementation(((tag: string) => {
+        const element = createElement(tag);
+        if (tag === 'input') created.push(element as HTMLInputElement);
+        return element;
+      }) as typeof document.createElement);
+
+      const pending = createWebMediaFileCaptureBackend()[method]({ source: 'photos' });
+      created[0].dispatchEvent(new Event('cancel'));
+
+      await expect(
+        Promise.race([pending, new Promise<'pending'>((resolve) => setTimeout(() => resolve('pending'), 200))]),
+      ).resolves.toBeNull();
+      expect(created[0].onchange).toBeNull();
+      expect(created[0].oncancel).toBeNull();
+    });
+  }
+
+  it('returns a backend whose capture yields a Promise without throwing synchronously', () => {
+    const backend = createWebMediaFileCaptureBackend();
+    expect(backend.capture({}) instanceof Promise).toBe(true);
+  });
+});
+
+describe('explainMediaFileCaptureBackend', () => {
+  afterEach(() => resetMediaFileCaptureBackendForTest());
+
+  it('reports host-not-enabled when no backend is installed', () => {
+    resetMediaFileCaptureBackendForTest();
+    const explanation = explainMediaFileCaptureBackend();
+    expect(explanation.layer).toBe('host-not-enabled');
+    expect(explanation.conflict).toBe(false);
+    expect(explanation.viability).toBe('unobserved');
+  });
+
+  it('reports custom layer when a custom backend is set', () => {
+    setMediaFileCaptureBackend(fakeBackend());
+    expect(explainMediaFileCaptureBackend().layer).toBe('custom');
+  });
+
+  it('reports host layer when a host backend is installed', () => {
+    installMediaFileCaptureHostBackend(fakeBackend());
+    expect(explainMediaFileCaptureBackend().layer).toBe('host');
+  });
+
+  it('reports conflict when two different host backends are installed', () => {
+    installMediaFileCaptureHostBackend(fakeBackend());
+    installMediaFileCaptureHostBackend(fakeBackend());
+    expect(explainMediaFileCaptureBackend().conflict).toBe(true);
+  });
+});
+
+describe('getMediaFileCaptureBackend', () => {
+  it('falls back to a web backend', () => {
+    expect(getMediaFileCaptureBackend()).not.toBeNull();
+  });
+
+  it('returns the registered backend', () => {
+    const backend = fakeBackend();
+    setMediaFileCaptureBackend(backend);
+    expect(getMediaFileCaptureBackend()).toBe(backend);
+  });
+});
+
+describe('installMediaFileCaptureHostBackend', () => {
+  afterEach(() => resetMediaFileCaptureBackendForTest());
+
+  it('installs a host backend that getMediaFileCaptureBackend returns', () => {
+    const backend = fakeBackend();
+    installMediaFileCaptureHostBackend(backend);
+    expect(getMediaFileCaptureBackend()).toBe(backend);
+  });
+
+  it('is first-host-wins: a second different backend sets conflict', () => {
+    const first = fakeBackend();
+    const second = fakeBackend();
+    installMediaFileCaptureHostBackend(first);
+    installMediaFileCaptureHostBackend(second);
+    expect(getMediaFileCaptureBackend()).toBe(first);
+    expect(explainMediaFileCaptureBackend().conflict).toBe(true);
+  });
+});
+
+describe('mediaFileCapture public API boundary', () => {
+  it('web backend has exactly capture and captureVideo methods', () => {
+    const backend = createWebMediaFileCaptureBackend();
+    const methods = Object.keys(backend).sort();
+    expect(methods).toEqual(['capture', 'captureVideo']);
+  });
+
+  it('sentinel backend has no requestPermission method', () => {
+    resetMediaFileCaptureBackendForTest();
+    setMediaFileCaptureBackend(null);
+    const sentinel = getMediaFileCaptureBackend();
+    expect('requestPermission' in sentinel).toBe(false);
+  });
+});
+
+describe('observeMediaFileCaptureHostResult', () => {
+  afterEach(() => resetMediaFileCaptureBackendForTest());
+
+  it('records a successful observation', () => {
+    installMediaFileCaptureHostBackend(fakeBackend());
+    observeMediaFileCaptureHostResult('capture', true);
+    const explanation = explainMediaFileCaptureBackend();
+    expect(explanation.operation).toBe('capture');
+    expect(explanation.viability).toBe('available');
+  });
+
+  it('records a failed observation', () => {
+    installMediaFileCaptureHostBackend(fakeBackend());
+    observeMediaFileCaptureHostResult('capture', false);
+    expect(explainMediaFileCaptureBackend().viability).toBe('runtime-api-unavailable');
+  });
+});
+
+describe('recordMediaFileCaptureVideo', () => {
+  it('captures video with the camera source', async () => {
+    const backend = fakeBackend();
+    setMediaFileCaptureBackend(backend);
+    const video = await recordMediaFileCaptureVideo({ maxDurationMs: 5000 });
+    expect(video).not.toBeNull();
+    expect(backend.lastOptions).toEqual({ maxDurationMs: 5000, source: 'camera' });
+  });
+
+  it('returns a Promise from the web backend without throwing', () => {
+    const backend = createWebMediaFileCaptureBackend();
+    expect(backend.captureVideo({}) instanceof Promise).toBe(true);
+  });
+});
+
+describe('resetMediaFileCaptureBackendForTest', () => {
+  it('clears all backend slots', () => {
+    setMediaFileCaptureBackend(fakeBackend());
+    installMediaFileCaptureHostBackend(fakeBackend());
+    observeMediaFileCaptureHostResult('capture', true);
+    resetMediaFileCaptureBackendForTest();
+    expect(explainMediaFileCaptureBackend().layer).toBe('host-not-enabled');
+    expect(explainMediaFileCaptureBackend().conflict).toBe(false);
+    expect(explainMediaFileCaptureBackend().viability).toBe('unobserved');
+  });
+});
+
+describe('selectMediaFileCaptureImage', () => {
+  it('captures with the photos source', async () => {
+    const backend = fakeBackend();
+    setMediaFileCaptureBackend(backend);
+    const photo = await selectMediaFileCaptureImage({ quality: 0.5 });
+    expect(photo).not.toBeNull();
+    expect(backend.lastOptions).toEqual({ quality: 0.5, source: 'photos' });
+  });
+});
+
+describe('setMediaFileCaptureBackend', () => {
+  it('clears back to the web fallback when passed null', () => {
+    setMediaFileCaptureBackend(fakeBackend());
+    setMediaFileCaptureBackend(null);
+    expect(getMediaFileCaptureBackend()).not.toBeNull();
+  });
+});
+
+describe('takeMediaFileCapturePhoto', () => {
+  it('captures with the camera source', async () => {
+    const backend = fakeBackend();
+    setMediaFileCaptureBackend(backend);
+    const photo = await takeMediaFileCapturePhoto({ allowEditing: true });
+    expect(photo).not.toBeNull();
+    expect(backend.lastOptions).toEqual({ allowEditing: true, source: 'camera' });
+  });
+});

package/dist/webcam.d.ts

@@ -1,14 +0,0 @@
-import type { BackendExplanation } from '@flighthq/types/contract';
-import type { WebcamBackend, WebcamCaptureOptions, WebcamPhoto, WebcamVideo } from '@flighthq/types/contract';
-export declare function createWebWebcamBackend(): WebcamBackend;
-export declare function explainWebcamBackend(): BackendExplanation;
-export declare function getWebcamBackend(): WebcamBackend;
-export declare function installWebcamHostBackend(backend: WebcamBackend): void;
-export declare function observeWebcamHostResult(operation: string, succeeded: boolean): void;
-export declare function recordWebcamVideo(options?: Readonly<WebcamCaptureOptions>): Promise<WebcamVideo | null>;
-export declare function requestWebcamPermission(): Promise<boolean>;
-export declare function resetWebcamBackendForTest(): void;
-export declare function selectWebcamImage(options?: Readonly<WebcamCaptureOptions>): Promise<WebcamPhoto | null>;
-export declare function setWebcamBackend(backend: WebcamBackend | null): void;
-export declare function takeWebcamPhoto(options?: Readonly<WebcamCaptureOptions>): Promise<WebcamPhoto | null>;
-//# sourceMappingURL=webcam.d.ts.map

package/dist/webcam.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"webcam.d.ts","sourceRoot":"","sources":["../src/webcam.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAK9G,wBAAgB,sBAAsB,IAAI,aAAa,CAwGtD;AAED,wBAAgB,oBAAoB,IAAI,kBAAkB,CAazD;AAED,wBAAgB,gBAAgB,IAAI,aAAa,CAEhD;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAMrE;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI,CAKnF;AAGD,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAEvG;AAGD,wBAAgB,uBAAuB,IAAI,OAAO,CAAC,OAAO,CAAC,CAE1D;AAED,wBAAgB,yBAAyB,IAAI,IAAI,CAKhD;AAGD,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAEvG;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI,CAEpE;AAGD,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAErG"}

package/dist/webcam.js.map

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

package/dist/webcamStream.d.ts

@@ -1,12 +0,0 @@
-import type { WebcamFacingMode, WebcamStream, WebcamStreamRuntime } from '@flighthq/types/contract';
-export declare function createWebcamStreamEntity(data: {
-    active: boolean;
-    deviceId: string;
-    facingMode: WebcamFacingMode | null;
-    frameRate: number;
-    height: number;
-    id: string;
-    width: number;
-}): WebcamStream;
-export declare function getWebcamStreamRuntime(stream: Readonly<WebcamStream>): WebcamStreamRuntime | null;
-//# sourceMappingURL=webcamStream.d.ts.map

package/dist/webcamStream.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"webcamStream.d.ts","sourceRoot":"","sources":["../src/webcamStream.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAMpG,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,YAAY,CAoBf;AAGD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,mBAAmB,GAAG,IAAI,CAIjG"}

package/dist/webcamStream.js

@@ -1,34 +0,0 @@
-import { createEntity } from '@flighthq/entity/contract';
-import { EntityRuntimeKey } from '@flighthq/types/contract';
-// Allocates a WebcamStream entity with an attached runtime slot holding the MediaStream.
-// The fields in data become the entity's public fields; the runtime is initialized with a
-// placeholder MediaStream that is replaced immediately by the caller.
-export function createWebcamStreamEntity(data) {
-    const stream = createEntity({
-        active: data.active,
-        deviceId: data.deviceId,
-        facingMode: data.facingMode,
-        frameRate: data.frameRate,
-        height: data.height,
-        id: data.id,
-        width: data.width,
-    });
-    // Initialize with null; the caller overwrites rt.mediaStream once a live stream is acquired. Using
-    // null (not new MediaStream()) avoids depending on MediaStream in environments that lack it (jsdom
-    // without the media API).
-    const rt = {
-        binding: null,
-        mediaStream: null,
-        videoElement: null,
-    };
-    stream[EntityRuntimeKey] = rt;
-    return stream;
-}
-// Returns the WebcamStreamRuntime attached to stream, or null when stream has no runtime.
-export function getWebcamStreamRuntime(stream) {
-    const rt = stream[EntityRuntimeKey];
-    if (rt === undefined || rt === null)
-        return null;
-    return rt;
-}
-//# sourceMappingURL=webcamStream.js.map

package/dist/webcamStream.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"webcamStream.js","sourceRoot":"","sources":["../src/webcamStream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,yFAAyF;AACzF,0FAA0F;AAC1F,sEAAsE;AACtE,MAAM,UAAU,wBAAwB,CAAC,IAQxC;IACC,MAAM,MAAM,GAAG,YAAY,CAAC;QAC1B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC,CAAC;IACH,mGAAmG;IACnG,mGAAmG;IACnG,0BAA0B;IAC1B,MAAM,EAAE,GAAwB;QAC9B,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,IAAI;QACjB,YAAY,EAAE,IAAI;KACnB,CAAC;IACF,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,CAAC;IAC9B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,sBAAsB,CAAC,MAA8B;IACnE,MAAM,EAAE,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACpC,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACjD,OAAO,EAAyB,CAAC;AACnC,CAAC"}

package/src/webcam.test.ts

@@ -1,184 +0,0 @@
-import type { WebcamBackend, WebcamCaptureOptions } from '@flighthq/types/contract';
-
-import {
-  createWebWebcamBackend,
-  getWebcamBackend,
-  recordWebcamVideo,
-  requestWebcamPermission,
-  selectWebcamImage,
-  setWebcamBackend,
-  takeWebcamPhoto,
-  explainWebcamBackend,
-  installWebcamHostBackend,
-  observeWebcamHostResult,
-  resetWebcamBackendForTest,
-} from './webcam';
-
-function fakeBackend(): WebcamBackend & { lastOptions: WebcamCaptureOptions | null } {
-  return {
-    lastOptions: null,
-    async capture(options) {
-      this.lastOptions = { ...options };
-      return { dataUrl: 'data:image/png;base64,xx', width: 0, height: 0, format: 'image/png' };
-    },
-    async captureVideo(options) {
-      this.lastOptions = { ...options };
-      return { dataUrl: 'data:video/mp4;base64,xx', duration: 0, format: 'video/mp4' };
-    },
-    async requestPermission() {
-      return true;
-    },
-  };
-}
-
-afterEach(() => setWebcamBackend(null));
-
-describe('createWebWebcamBackend', () => {
-  it('returns a backend whose capture yields a Promise without throwing synchronously', () => {
-    const backend = createWebWebcamBackend();
-    expect(backend.capture({}) instanceof Promise).toBe(true);
-  });
-});
-
-describe('explainWebcamBackend', () => {
-  afterEach(() => resetWebcamBackendForTest());
-
-  it('reports host-not-enabled when no backend is installed', () => {
-    resetWebcamBackendForTest();
-    const explanation = explainWebcamBackend();
-    expect(explanation.layer).toBe('host-not-enabled');
-    expect(explanation.conflict).toBe(false);
-    expect(explanation.viability).toBe('unobserved');
-  });
-
-  it('reports custom layer when a custom backend is set', () => {
-    setWebcamBackend(fakeBackend());
-    expect(explainWebcamBackend().layer).toBe('custom');
-  });
-
-  it('reports host layer when a host backend is installed', () => {
-    installWebcamHostBackend(fakeBackend());
-    expect(explainWebcamBackend().layer).toBe('host');
-  });
-
-  it('reports conflict when two different host backends are installed', () => {
-    installWebcamHostBackend(fakeBackend());
-    installWebcamHostBackend(fakeBackend());
-    expect(explainWebcamBackend().conflict).toBe(true);
-  });
-});
-
-describe('getWebcamBackend', () => {
-  it('falls back to a web backend', () => {
-    expect(getWebcamBackend()).not.toBeNull();
-  });
-
-  it('returns the registered backend', () => {
-    const backend = fakeBackend();
-    setWebcamBackend(backend);
-    expect(getWebcamBackend()).toBe(backend);
-  });
-});
-
-describe('installWebcamHostBackend', () => {
-  afterEach(() => resetWebcamBackendForTest());
-
-  it('installs a host backend that getWebcamBackend returns', () => {
-    const backend = fakeBackend();
-    installWebcamHostBackend(backend);
-    expect(getWebcamBackend()).toBe(backend);
-  });
-
-  it('is first-host-wins: a second different backend sets conflict', () => {
-    const first = fakeBackend();
-    const second = fakeBackend();
-    installWebcamHostBackend(first);
-    installWebcamHostBackend(second);
-    expect(getWebcamBackend()).toBe(first);
-    expect(explainWebcamBackend().conflict).toBe(true);
-  });
-});
-
-describe('observeWebcamHostResult', () => {
-  afterEach(() => resetWebcamBackendForTest());
-
-  it('records a successful observation', () => {
-    installWebcamHostBackend(fakeBackend());
-    observeWebcamHostResult('capture', true);
-    const explanation = explainWebcamBackend();
-    expect(explanation.operation).toBe('capture');
-    expect(explanation.viability).toBe('available');
-  });
-
-  it('records a failed observation', () => {
-    installWebcamHostBackend(fakeBackend());
-    observeWebcamHostResult('capture', false);
-    expect(explainWebcamBackend().viability).toBe('runtime-api-unavailable');
-  });
-});
-
-describe('recordWebcamVideo', () => {
-  it('captures video with the camera source', async () => {
-    const backend = fakeBackend();
-    setWebcamBackend(backend);
-    const video = await recordWebcamVideo({ maxDurationMs: 5000 });
-    expect(video).not.toBeNull();
-    expect(backend.lastOptions).toEqual({ maxDurationMs: 5000, source: 'camera' });
-  });
-
-  it('returns a Promise from the web backend without throwing', () => {
-    const backend = createWebWebcamBackend();
-    expect(backend.captureVideo({}) instanceof Promise).toBe(true);
-  });
-});
-
-describe('requestWebcamPermission', () => {
-  it('delegates to the active backend', async () => {
-    setWebcamBackend(fakeBackend());
-    expect(await requestWebcamPermission()).toBe(true);
-  });
-
-  it('returns a boolean from the web backend without throwing', async () => {
-    expect(typeof (await requestWebcamPermission())).toBe('boolean');
-  });
-});
-
-describe('resetWebcamBackendForTest', () => {
-  it('clears all backend slots', () => {
-    setWebcamBackend(fakeBackend());
-    installWebcamHostBackend(fakeBackend());
-    observeWebcamHostResult('capture', true);
-    resetWebcamBackendForTest();
-    expect(explainWebcamBackend().layer).toBe('host-not-enabled');
-    expect(explainWebcamBackend().conflict).toBe(false);
-    expect(explainWebcamBackend().viability).toBe('unobserved');
-  });
-});
-
-describe('selectWebcamImage', () => {
-  it('captures with the photos source', async () => {
-    const backend = fakeBackend();
-    setWebcamBackend(backend);
-    const photo = await selectWebcamImage({ quality: 0.5 });
-    expect(photo).not.toBeNull();
-    expect(backend.lastOptions).toEqual({ quality: 0.5, source: 'photos' });
-  });
-});
-
-describe('setWebcamBackend', () => {
-  it('clears back to the web fallback when passed null', () => {
-    setWebcamBackend(fakeBackend());
-    setWebcamBackend(null);
-    expect(getWebcamBackend()).not.toBeNull();
-  });
-});
-
-describe('takeWebcamPhoto', () => {
-  it('captures with the camera source', async () => {
-    const backend = fakeBackend();
-    setWebcamBackend(backend);
-    const photo = await takeWebcamPhoto({ allowEditing: true });
-    expect(photo).not.toBeNull();
-    expect(backend.lastOptions).toEqual({ allowEditing: true, source: 'camera' });
-  });
-});

package/src/webcamStream.test.ts

@@ -1,86 +0,0 @@
-import type { WebcamStream } from '@flighthq/types/contract';
-import { EntityRuntimeKey } from '@flighthq/types/contract';
-
-import { createWebcamStreamEntity, getWebcamStreamRuntime } from './webcamStream';
-
-describe('createWebcamStreamEntity', () => {
-  it('creates a WebcamStream with the correct public fields', () => {
-    const stream = createWebcamStreamEntity({
-      active: true,
-      deviceId: 'device-1',
-      facingMode: 'environment',
-      frameRate: 30,
-      height: 480,
-      id: 'stream-123',
-      width: 640,
-    });
-    expect(stream.active).toBe(true);
-    expect(stream.deviceId).toBe('device-1');
-    expect(stream.facingMode).toBe('environment');
-    expect(stream.frameRate).toBe(30);
-    expect(stream.height).toBe(480);
-    expect(stream.id).toBe('stream-123');
-    expect(stream.width).toBe(640);
-  });
-
-  it('attaches a runtime slot to the entity', () => {
-    const stream = createWebcamStreamEntity({
-      active: true,
-      deviceId: '',
-      facingMode: null,
-      frameRate: 0,
-      height: 0,
-      id: 'x',
-      width: 0,
-    });
-    expect(stream[EntityRuntimeKey]).not.toBeUndefined();
-  });
-
-  it('runtime slot is initialized (mediaStream placeholder is present)', () => {
-    const stream = createWebcamStreamEntity({
-      active: false,
-      deviceId: '',
-      facingMode: null,
-      frameRate: 0,
-      height: 0,
-      id: 'x',
-      width: 0,
-    });
-    const rt = getWebcamStreamRuntime(stream);
-    expect(rt).not.toBeNull();
-    // mediaStream starts null; the caller attaches a live stream before use.
-    expect(rt?.mediaStream).toBeNull();
-    expect(rt?.videoElement).toBeNull();
-  });
-});
-
-describe('getWebcamStreamRuntime', () => {
-  it('returns null for a stream without a runtime', () => {
-    const stream = {
-      active: true,
-      deviceId: '',
-      facingMode: null,
-      frameRate: 0,
-      height: 0,
-      id: 'x',
-      width: 0,
-      [EntityRuntimeKey]: undefined,
-    } as WebcamStream;
-    expect(getWebcamStreamRuntime(stream)).toBeNull();
-  });
-
-  it('returns the runtime for a stream created by createWebcamStreamEntity', () => {
-    const stream = createWebcamStreamEntity({
-      active: true,
-      deviceId: 'dev',
-      facingMode: 'user',
-      frameRate: 60,
-      height: 720,
-      id: 'stream-rt',
-      width: 1280,
-    });
-    const rt = getWebcamStreamRuntime(stream);
-    expect(rt).not.toBeNull();
-    expect(rt?.videoElement).toBeNull();
-  });
-});