@chipmobilesdk/rn-camera 0.3.0 → 0.5.0

package/lib/module/react/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useEffect","useRef","useState","useSyncExternalStore","createCameraController","useCameraController","options","optionsRef","controller","setController","current","disposedRef","WeakSet","disposed","has","undefined","add","dispose","catch","useCameraState","subscribe","state"],"sourceRoot":"../../../src","sources":["react/hooks.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,SAAS,EAAEC,MAAM,EAAEC,QAAQ,EAAEC,oBAAoB,QAAQ,OAAO;AAGzE,SACCC,sBAAsB,QAGhB,uBAAoB;AAE3B,OAAO,SAASC,mBAAmBA,CAACC,OAAgC,EAAoB;EACvF;EACA;EACA,MAAMC,UAAU,GAAGN,MAAM,CAACK,OAAO,CAAC;EAClC;EACA;EACA,MAAM,CAACE,UAAU,EAAEC,aAAa,CAAC,GAAGP,QAAQ,CAAC,MAAME,sBAAsB,CAACG,UAAU,CAACG,OAAO,CAAC,CAAC;EAC9F,MAAMC,WAAW,GAAGV,MAAM,CAAC,IAAIW,OAAO,CAAmB,CAAC,CAAC;EAE3DZ,SAAS,CAAC,MAAM;IACf;IACA;IACA;IACA;IACA,MAAMa,QAAQ,GAAGF,WAAW,CAACD,OAAO;IACpC,IAAIG,QAAQ,CAACC,GAAG,CAACN,UAAU,CAAC,EAAE;MAC7BC,aAAa,CAACL,sBAAsB,CAACG,UAAU,CAACG,OAAO,CAAC,CAAC;MACzD,OAAOK,SAAS;IACjB;IACA,OAAO,MAAM;MACZF,QAAQ,CAACG,GAAG,CAACR,UAAU,CAAC;MACxBA,UAAU,CAACS,OAAO,CAAC,CAAC,CAACC,KAAK,CAAC,MAAMH,SAAS,CAAC;IAC5C,CAAC;EACF,CAAC,EAAE,CAACP,UAAU,CAAC,CAAC;EAEhB,OAAOA,UAAU;AAClB;AAEA,OAAO,SAASW,cAAcA,CAACX,UAA4B,EAAe;EACzE;EACA;EACA;EACA;EACA,OAAOL,oBAAoB,CAC1BK,UAAU,CAACY,SAAS,EACpB,MAAMZ,UAAU,CAACa,KAAK,EACtB,MAAMb,UAAU,CAACa,KAClB,CAAC;AACF","ignoreList":[]}

package/lib/module/storage/artifactStore.js

@@ -0,0 +1,94 @@
+"use strict";
+
+/**
+ * ArtifactStore port + default cache-directory adapter (FR-026..FR-029).
+ *
+ * Package-owned artifacts live in a dedicated `rn-camera` subdirectory of the
+ * platform cache directory (research R6). That dedicated prefix is what makes
+ * ownership checkable rather than advisory: `owns()` is a path-prefix test, so
+ * the package can refuse to delete anything it did not create (FR-028).
+ */
+
+import { CameraError } from "../diagnostics/errors.js";
+
+/** Minimal filesystem surface the adapter needs. Injectable for tests. */
+
+/** Normalizes separators so prefix comparison works on both platforms. */
+function normalize(path) {
+  return path.replace(/\\/g, '/').replace(/^file:\/\//, '');
+}
+export function createArtifactStore(fs, directoryName = 'rn-camera') {
+  const root = `${fs.cacheDirectory().replace(/\/$/, '')}/${directoryName}`;
+  const normalizedRoot = normalize(root);
+  // Artifacts created by this process are never swept, no matter their age.
+  const createdThisProcess = new Set();
+  function owns(uri) {
+    return normalize(uri).startsWith(`${normalizedRoot}/`);
+  }
+  return {
+    temporaryDirectory() {
+      return root;
+    },
+    owns,
+    async remove(uri) {
+      if (!owns(uri)) {
+        return;
+      }
+      const path = normalize(uri);
+      // Idempotent: a missing artifact is a successful cleanup (FR-027).
+      if (await fs.exists(path)) {
+        await fs.unlink(path);
+      }
+      createdThisProcess.delete(path);
+    },
+    async sweep(olderThanMs) {
+      await fs.ensureDirectory(root);
+      const entries = await fs.list(root);
+      const cutoff = Date.now() - olderThanMs;
+      let removed = 0;
+      for (const entry of entries) {
+        const path = normalize(entry);
+        if (createdThisProcess.has(path)) {
+          continue;
+        }
+        const created = await fs.createdAt(path);
+        if (created < cutoff) {
+          await fs.unlink(path);
+          removed += 1;
+        }
+      }
+      return removed;
+    },
+    async adopt(uri) {
+      const path = normalize(uri);
+      if (owns(uri)) {
+        createdThisProcess.add(path);
+        return uri;
+      }
+      if (!fs.move) {
+        throw new CameraError('storageFailure', 'This FileSystemBridge has no move(), so it cannot adopt a capture');
+      }
+      await fs.ensureDirectory(root);
+      const name = path.slice(path.lastIndexOf('/') + 1) || `capture-${Date.now()}.jpg`;
+      const target = `${root}/${name}`;
+      await fs.move(path, target);
+      createdThisProcess.add(normalize(target));
+      return uri.startsWith('file://') ? `file://${normalize(target)}` : target;
+    }
+  };
+}
+
+/**
+ * Default adapter. The concrete filesystem bridge is supplied by the native
+ * layer at runtime; it is a parameter rather than a hard import so the package
+ * takes no filesystem dependency of its own.
+ */
+export function createCacheArtifactStore(options = {}) {
+  const fs = options.fs;
+  if (!fs) {
+    // A typed error, like every other failure this package reports.
+    throw new CameraError('storageFailure', 'createCacheArtifactStore requires a FileSystemBridge. Pass `fs`, or use ' + 'createTestCamera() in tests.');
+  }
+  return createArtifactStore(fs, options.directoryName);
+}
+//# sourceMappingURL=artifactStore.js.map

package/lib/module/storage/artifactStore.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["CameraError","normalize","path","replace","createArtifactStore","fs","directoryName","root","cacheDirectory","normalizedRoot","createdThisProcess","Set","owns","uri","startsWith","temporaryDirectory","remove","exists","unlink","delete","sweep","olderThanMs","ensureDirectory","entries","list","cutoff","Date","now","removed","entry","has","created","createdAt","adopt","add","move","name","slice","lastIndexOf","target","createCacheArtifactStore","options"],"sourceRoot":"../../../src","sources":["storage/artifactStore.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/testing/conformance.js

@@ -0,0 +1,102 @@
+"use strict";
+
+/**
+ * What any `PermissionPort` and `CameraEngine` must do (IOS-12, CAM-13).
+ *
+ * The same checks run against the in-memory test adapter and against the real
+ * VisionCamera adapters (native module mocked in Jest, or for real on a device),
+ * so the fake the app's tests rely on cannot drift from the adapter it stands in
+ * for. Each check builds its own port from a harness, under the conditions it
+ * needs.
+ */
+import { ensure, runChecks } from '@chipmobilesdk/rn-core/testing';
+export const permissionPortChecks = [{
+  name: 'reads the status without prompting',
+  async run(harness) {
+    const system = harness.create('undetermined');
+    ensure((await system.port.getStatus()) === 'undetermined', 'expected undetermined');
+    ensure(system.prompts() === 0, 'getStatus prompted');
+  }
+}, {
+  name: 'reports a grant after prompting once',
+  async run(harness) {
+    const system = harness.create('undetermined');
+    const state = await system.port.request();
+    ensure(state === 'granted', `expected granted, got ${state}`);
+    ensure(system.prompts() === 1, `expected one prompt, got ${system.prompts()}`);
+  }
+}, {
+  name: 'never prompts again after a permanent denial',
+  async run(harness) {
+    const system = harness.create('deniedPermanently');
+    const state = await system.port.request();
+    ensure(state === 'deniedPermanently', `expected deniedPermanently, got ${state}`);
+    ensure(system.prompts() === 0, 'prompted after a permanent denial');
+  }
+}, {
+  name: 'tells subscribers about a change, and nothing after unsubscribing',
+  async run(harness) {
+    const system = harness.create('undetermined');
+    const seen = [];
+    const unsubscribe = system.port.subscribe(state => seen.push(state));
+    await system.port.request();
+    ensure(seen.includes('granted'), `subscriber saw ${JSON.stringify(seen)}`);
+    unsubscribe();
+    unsubscribe();
+    const before = seen.length;
+    system.setSystemState('deniedPermanently');
+    await system.port.getStatus();
+    ensure(seen.length === before, 'notified after unsubscribing');
+  }
+}];
+export const cameraEngineChecks = [{
+  name: 'refuses to start without a camera, as cameraUnavailable',
+  async run(harness) {
+    const engine = harness.create([]);
+    let code;
+    try {
+      await engine.start({});
+    } catch (error) {
+      code = error.code;
+    }
+    ensure(code === 'cameraUnavailable', `expected cameraUnavailable, got ${String(code)}`);
+  }
+}, {
+  name: 'starts when a camera exists',
+  async run(harness) {
+    await harness.create([{
+      position: 'back'
+    }]).start({});
+  }
+}, {
+  name: 'reports capabilities from the cameras present',
+  async run(harness) {
+    const capabilities = await harness.create([{
+      position: 'back',
+      hasTorch: true,
+      hasFlash: true
+    }, {
+      position: 'front'
+    }]).getCapabilities();
+    ensure(capabilities.hasCameraHardware, 'no camera hardware reported');
+    ensure(capabilities.hasTorch && capabilities.hasFlash, 'torch or flash not reported');
+    const positions = [...capabilities.availablePositions].sort();
+    ensure(positions.join(',') === 'back,front', `positions ${positions.join(',')}`);
+  }
+}, {
+  name: 'stops safely, even without a start and twice',
+  async run(harness) {
+    const engine = harness.create([{
+      position: 'back'
+    }]);
+    await engine.stop();
+    await engine.stop();
+  }
+}];
+export function runPermissionPortConformance(harness) {
+  return runChecks(() => harness, permissionPortChecks);
+}
+export function runCameraEngineConformance(harness) {
+  return runChecks(() => harness, cameraEngineChecks);
+}
+//# sourceMappingURL=conformance.js.map

package/lib/module/testing/conformance.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["ensure","runChecks","permissionPortChecks","name","run","harness","system","create","port","getStatus","prompts","state","request","seen","unsubscribe","subscribe","push","includes","JSON","stringify","before","length","setSystemState","cameraEngineChecks","engine","code","start","error","String","position","capabilities","hasTorch","hasFlash","getCapabilities","hasCameraHardware","positions","availablePositions","sort","join","stop","runPermissionPortConformance","runCameraEngineConformance"],"sourceRoot":"../../../src","sources":["testing/conformance.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/testing/index.js

@@ -0,0 +1,13 @@
+"use strict";
+
+/**
+ * `@chipmobilesdk/rn-camera/testing`: test doubles and the port conformance suites.
+ *
+ * A separate entrypoint so the suites cannot reach a production bundle. The test
+ * adapter is also exported from the main entrypoint for compatibility; it leaves
+ * there only in a major release.
+ */
+
+export { createTestCamera, createMemoryFileSystem, DEFAULT_TEST_CAPABILITIES } from "./testCameraAdapter.js";
+export { cameraEngineChecks, permissionPortChecks, runCameraEngineConformance, runPermissionPortConformance } from "./conformance.js";
+//# sourceMappingURL=index.js.map

package/lib/module/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createTestCamera","createMemoryFileSystem","DEFAULT_TEST_CAPABILITIES","cameraEngineChecks","permissionPortChecks","runCameraEngineConformance","runPermissionPortConformance"],"sourceRoot":"../../../src","sources":["testing/index.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SACCA,gBAAgB,EAChBC,sBAAsB,EACtBC,yBAAyB,QACnB,wBAAqB;AAG5B,SACCC,kBAAkB,EAClBC,oBAAoB,EACpBC,0BAA0B,EAC1BC,4BAA4B,QACtB,kBAAe","ignoreList":[]}

package/lib/module/testing/testCameraAdapter.js

@@ -0,0 +1,185 @@
+"use strict";
+
+/**
+ * Deterministic in-memory camera for tests (FR-041, SC-010).
+ *
+ * These are real implementations of the same published ports the production
+ * adapters implement, not a parallel mock — so a contract change breaks them at
+ * compile time and they cannot drift. Nothing here touches a native module, the
+ * filesystem, or a permission API.
+ */
+
+import { createListenerSet } from '@chipmobilesdk/rn-core';
+import { known, unavailable } from "../config/types.js";
+import { CameraError } from "../diagnostics/errors.js";
+import { createArtifactStore } from "../storage/artifactStore.js";
+import { clampQuality } from "../core/captureController.js";
+export function createMemoryFileSystem(root = '/cache') {
+  const files = new Map();
+  const directories = new Set();
+  return {
+    cacheDirectory: () => root,
+    async exists(path) {
+      return files.has(path);
+    },
+    async unlink(path) {
+      files.delete(path);
+    },
+    async list(directory) {
+      const prefix = `${directory.replace(/\/$/, '')}/`;
+      return Array.from(files.keys()).filter(path => path.startsWith(prefix));
+    },
+    async createdAt(path) {
+      return files.get(path) ?? Date.now();
+    },
+    async ensureDirectory(directory) {
+      directories.add(directory);
+    },
+    async move(from, to) {
+      if (!files.has(from)) {
+        throw new Error('No such file');
+      }
+      files.set(to, files.get(from) ?? Date.now());
+      files.delete(from);
+    },
+    seed(path, createdAtMs) {
+      files.set(path, createdAtMs);
+    },
+    paths: () => Array.from(files.keys())
+  };
+}
+export const DEFAULT_TEST_CAPABILITIES = {
+  availablePositions: ['back', 'front'],
+  hasFlash: true,
+  hasTorch: true,
+  supportsOrientationChange: true,
+  hasCameraHardware: true
+};
+export function createTestCamera(config = {}) {
+  const fs = createMemoryFileSystem(config.cacheRoot ?? '/cache');
+  const store = createArtifactStore(fs);
+  const capabilities = {
+    ...DEFAULT_TEST_CAPABILITIES,
+    ...config.capabilities
+  };
+  let permission = config.permission ?? 'undetermined';
+  let captureError = config.captureError ?? null;
+  let startError = config.startError ?? null;
+  let torch = false;
+  let starts = 0;
+  let stops = 0;
+  let sequence = 0;
+  let promptCount = 0;
+  const produced = [];
+  // The same listener sets as the real adapters, so a throwing subscriber behaves
+  // identically here and on a device.
+  const permissionListeners = createListenerSet();
+  const appStateListeners = createListenerSet();
+  const interruptionListeners = createListenerSet();
+  let requestThrows = false;
+  const permissions = {
+    async getStatus() {
+      return permission;
+    },
+    async request() {
+      if (requestThrows) {
+        // What a native module that cannot be reached does.
+        throw new Error('permission request failed');
+      }
+      // Mirrors the real adapter: never re-prompt after a permanent denial.
+      if (permission === 'deniedPermanently') {
+        return permission;
+      }
+      if (permission === 'undetermined' || permission === 'denied') {
+        promptCount += 1;
+        permission = 'granted';
+      }
+      permissionListeners.notify(permission);
+      return permission;
+    },
+    subscribe: listener => permissionListeners.add(listener)
+  };
+  const engine = {
+    subscribeToInterruptions: listener => interruptionListeners.add(listener),
+    async start() {
+      starts += 1;
+      if (startError) {
+        throw new CameraError(startError);
+      }
+      if (!capabilities.hasCameraHardware) {
+        throw new CameraError('cameraUnavailable');
+      }
+    },
+    async stop() {
+      stops += 1;
+      torch = false;
+    },
+    async capture(request) {
+      if (captureError) {
+        throw new CameraError(captureError);
+      }
+      sequence += 1;
+      const position = request.cameraPosition ?? 'back';
+      const uri = request.destination ?? `${store.temporaryDirectory()}/capture-${sequence}.jpg`;
+      fs.seed(uri, Date.now());
+      const image = {
+        uri,
+        mimeType: 'image/jpeg',
+        width: 1920,
+        height: 1080,
+        timestamp: Date.now(),
+        cameraPosition: position,
+        ownership: request.destination ? 'appOwned' : 'packageTemporary',
+        // Clamped the way the real path clamps it, not a second copy of 0.9.
+        effectiveQuality: clampQuality(request.quality),
+        effectiveMaxDimension: request.maxDimension === undefined ? unavailable() : known(request.maxDimension),
+        fileSize: known(1024),
+        orientation: known(0),
+        ...config.captureResult
+      };
+      produced.push(image);
+      return image;
+    },
+    async setTorch(enabled) {
+      torch = enabled;
+    },
+    async getCapabilities() {
+      return capabilities;
+    }
+  };
+  return {
+    engine,
+    permissions,
+    store,
+    fs,
+    subscribeToAppState: listener => appStateListeners.add(listener),
+    setAppState(status) {
+      appStateListeners.notify(status);
+    },
+    setPermission(state) {
+      permission = state;
+      permissionListeners.notify(state);
+    },
+    emitInterruption(code = 'interrupted') {
+      // The OS took the camera away. A live session hears about it, and the
+      // next start attempt fails until the app clears it.
+      startError = code;
+      interruptionListeners.notify(code);
+    },
+    emitPermissionRequestFailure(enabled) {
+      requestThrows = enabled;
+    },
+    setCaptureError(code) {
+      captureError = code;
+    },
+    setStartError(code) {
+      startError = code;
+    },
+    prompts: () => promptCount,
+    captures: () => produced,
+    torchState: () => torch,
+    startCount: () => starts,
+    stopCount: () => stops
+  };
+}
+//# sourceMappingURL=testCameraAdapter.js.map

package/lib/module/testing/testCameraAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createListenerSet","known","unavailable","CameraError","createArtifactStore","clampQuality","createMemoryFileSystem","root","files","Map","directories","Set","cacheDirectory","exists","path","has","unlink","delete","list","directory","prefix","replace","Array","from","keys","filter","startsWith","createdAt","get","Date","now","ensureDirectory","add","move","to","Error","set","seed","createdAtMs","paths","DEFAULT_TEST_CAPABILITIES","availablePositions","hasFlash","hasTorch","supportsOrientationChange","hasCameraHardware","createTestCamera","config","fs","cacheRoot","store","capabilities","permission","captureError","startError","torch","starts","stops","sequence","promptCount","produced","permissionListeners","appStateListeners","interruptionListeners","requestThrows","permissions","getStatus","request","notify","subscribe","listener","engine","subscribeToInterruptions","start","stop","capture","position","cameraPosition","uri","destination","temporaryDirectory","image","mimeType","width","height","timestamp","ownership","effectiveQuality","quality","effectiveMaxDimension","maxDimension","undefined","fileSize","orientation","captureResult","push","setTorch","enabled","getCapabilities","subscribeToAppState","setAppState","status","setPermission","state","emitInterruption","code","emitPermissionRequestFailure","setCaptureError","setStartError","prompts","captures","torchState","startCount","stopCount"],"sourceRoot":"../../../src","sources":["testing/testCameraAdapter.ts"],"mappings":"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","ignoreList":[]}

package/lib/typescript/commonjs/config/types.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Public type contract for @chipmobilesdk/rn-camera.
+ *
+ * Every type here is re-exported from `src/index.ts` (LIB-002/LIB-003). See
+ * `specs/006-rn-camera-package/contracts/public-api.md` for the authoritative
+ * contract and `data-model.md` for the rules behind each field.
+ */
+/** Camera authorization status. Seven distinguishable outcomes (FR-004). */
+export type CameraPermissionState = 'undetermined' | 'requesting' | 'granted' | 'denied' | 'deniedPermanently' | 'unavailable' | 'unsupported';
+export type CameraPosition = 'front' | 'back';
+export type FlashMode = 'auto' | 'on' | 'off';
+export type ResizeMode = 'cover' | 'contain';
+export type ArtifactOwnership = 'packageTemporary' | 'appOwned';
+import type { SurfaceInfo } from '../native/visionSurface';
+export type SessionStatus = 'idle' | 'starting' | 'active' | 'paused' | 'stopping' | 'stopped' | 'error';
+/**
+ * A metadata field the platform could not determine (FR-022). Distinct from an
+ * absent property so consumers can tell "not reported" from "not asked for".
+ */
+export interface Unavailable {
+    readonly available: false;
+}
+export interface Known<T> {
+    readonly available: true;
+    readonly value: T;
+}
+export type Maybe<T> = Known<T> | Unavailable;
+export declare function known<T>(value: T): Known<T>;
+export declare function unavailable(): Unavailable;
+/** What this device and platform actually support (FR-033). */
+export interface CapabilityProfile {
+    readonly availablePositions: readonly CameraPosition[];
+    readonly hasFlash: boolean;
+    readonly hasTorch: boolean;
+    readonly supportsOrientationChange: boolean;
+    readonly hasCameraHardware: boolean;
+}
+/** Instruction to take one still photo. Carries no business context (FR-002). */
+export interface CaptureRequest {
+    /** 0..1, clamped to what the device supports. */
+    readonly quality?: number;
+    /** Longest edge in pixels, applied within device limits. */
+    readonly maxDimension?: number;
+    readonly cameraPosition?: CameraPosition;
+    readonly flashMode?: FlashMode;
+    /**
+     * Supplying a destination makes the result `appOwned` and the package writes
+     * directly there. Omitting it makes the result `packageTemporary` (FR-026a).
+     * This is the only way ownership is decided.
+     */
+    readonly destination?: string;
+}
+/** Result of one successful capture. Always a file reference (FR-021/FR-021a). */
+export interface CapturedImage {
+    /** File URI or handle. Never a base64 string, never an in-memory buffer. */
+    readonly uri: string;
+    readonly mimeType: string;
+    readonly width: number;
+    readonly height: number;
+    readonly timestamp: number;
+    readonly cameraPosition: CameraPosition;
+    readonly ownership: ArtifactOwnership;
+    readonly effectiveQuality: number;
+    readonly effectiveMaxDimension: Maybe<number>;
+    readonly fileSize: Maybe<number>;
+    readonly orientation: Maybe<number>;
+}
+/** Options accepted when starting a session. */
+export interface StartOptions {
+    readonly cameraPosition?: CameraPosition;
+}
+/**
+ * Relationship between captured-image space and on-screen preview space.
+ * Consumed by the pure mapping functions in `geometry/coordinateMapping`.
+ */
+export interface PreviewGeometry {
+    readonly imageWidth: number;
+    readonly imageHeight: number;
+    readonly previewWidth: number;
+    readonly previewHeight: number;
+    readonly resizeMode: ResizeMode;
+    /** Clockwise degrees: 0, 90, 180, or 270. */
+    readonly orientation: number;
+    readonly isMirrored: boolean;
+}
+export interface Point {
+    readonly x: number;
+    readonly y: number;
+}
+export interface Rect {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+/** Aggregate observable state exposed by the controller. */
+export interface CameraState {
+    readonly session: SessionStatus;
+    readonly permission: CameraPermissionState;
+    readonly capabilities: CapabilityProfile | null;
+    readonly cameraPosition: CameraPosition;
+    readonly flashMode: FlashMode;
+    readonly torchEnabled: boolean;
+    readonly capturing: boolean;
+    /**
+     * What the mounted preview surface reported about itself: the capture
+     * dimensions of the selected format, its orientation, and the position of
+     * the device actually running. `null` until a surface reports (CAM-10).
+     */
+    readonly surface: SurfaceInfo | null;
+    readonly error: CameraErrorLike | null;
+}
+/**
+ * Structural view of a CameraError, kept here so `CameraState` does not create
+ * a circular import with the diagnostics module.
+ */
+export interface CameraErrorLike {
+    readonly code: string;
+    readonly recoverable: boolean;
+    readonly message: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/commonjs/config/types.d.ts.map

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

package/lib/typescript/commonjs/core/capabilities.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Capability gating (FR-033, FR-034).
+ *
+ * An unsupported capability must produce an `unsupportedCapability` result, not
+ * an unexpected failure — that is what lets an app hide a control instead of
+ * discovering at tap time that the device has no flash.
+ */
+import type { CameraPosition, CapabilityProfile, FlashMode } from '../config/types';
+export declare const EMPTY_CAPABILITIES: CapabilityProfile;
+export declare function supportsPosition(profile: CapabilityProfile | null, position: CameraPosition): boolean;
+/** `off` is always legal — it is the absence of flash, not a use of it. */
+export declare function supportsFlashMode(profile: CapabilityProfile | null, mode: FlashMode): boolean;
+export declare function supportsTorch(profile: CapabilityProfile | null): boolean;
+/** Throws the uniform unsupported error so every gate reads the same way. */
+export declare function assertSupported(supported: boolean, what: string): void;
+//# sourceMappingURL=capabilities.d.ts.map

package/lib/typescript/commonjs/core/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../../../src/core/capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGpF,eAAO,MAAM,kBAAkB,EAAE,iBAMhC,CAAC;AAEF,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,iBAAiB,GAAG,IAAI,EACjC,QAAQ,EAAE,cAAc,GACtB,OAAO,CAET;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAE7F;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,GAAG,OAAO,CAExE;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAItE"}

package/lib/typescript/commonjs/core/captureController.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Capture guards, single-flight enforcement, and metadata assembly
+ * (FR-020..FR-026b).
+ *
+ * The single-flight guard rejects rather than queues or coalesces. A queue
+ * turns a double-tapped shutter into two photos the user never asked for, and
+ * coalescing hides a deliberate second capture behind an accidental one — so a
+ * fast, explicit `captureInProgress` error is the only option that lets the app
+ * decide (clarification session 2026-07-26).
+ */
+import { type CameraPosition, type CapabilityProfile, type CapturedImage, type CaptureRequest, type FlashMode, type Maybe, type SessionStatus } from '../config/types';
+import type { CameraEngine } from '../native/cameraEngine';
+export declare const DEFAULT_QUALITY = 0.9;
+export declare function clampQuality(quality: number | undefined): number;
+export declare function clampMaxDimension(maxDimension: number | undefined): Maybe<number>;
+export interface CaptureContext {
+    readonly engine: CameraEngine;
+    readonly sessionStatus: SessionStatus;
+    readonly permissionGranted: boolean;
+    readonly capabilities: CapabilityProfile | null;
+    readonly cameraPosition: CameraPosition;
+    readonly flashMode: FlashMode;
+}
+/**
+ * Validates a capture request against permission, readiness, and capability.
+ * Throws before any artifact could be created, so a rejected capture never
+ * leaves a file behind (FR-020).
+ */
+export declare function assertCaptureAllowed(context: CaptureContext, request: CaptureRequest): void;
+/**
+ * Normalizes whatever the engine returned into the published contract, filling
+ * in effective hint values and marking undeterminable fields explicitly
+ * unavailable rather than guessing them (FR-022, FR-023).
+ */
+export declare function finalizeResult(raw: CapturedImage, request: CaptureRequest, context: CaptureContext): CapturedImage;
+/**
+ * Serializes captures. The slot is taken synchronously, before the operation
+ * runs, so two calls in the same tick cannot both pass the check — and the
+ * operation's own first `emit()` already sees `busy`. Holding the operation's
+ * promise instead set the slot only after that first emit, so `capturing: true`
+ * was never published at all.
+ */
+export declare class SingleFlight {
+    private active;
+    get busy(): boolean;
+    run(operation: () => Promise<CapturedImage>): Promise<CapturedImage>;
+}
+//# sourceMappingURL=captureController.d.ts.map

package/lib/typescript/commonjs/core/captureController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"captureController.d.ts","sourceRoot":"","sources":["../../../../src/core/captureController.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAGN,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,KAAK,EACV,KAAK,aAAa,EAClB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAI3D,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAKhE;AAED,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAKjF;AAED,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAqB3F;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC7B,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,cAAc,GACrB,aAAa,CAaf;AAED;;;;;;GAMG;AACH,qBAAa,YAAY;IACxB,OAAO,CAAC,MAAM,CAAS;IAEvB,IAAI,IAAI,IAAI,OAAO,CAElB;IAEK,GAAG,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;CAW1E"}