@chipmobilesdk/rn-camera 0.1.1 → 0.2.1

package/src/testing/testCameraAdapter.ts

@@ -1,249 +1,256 @@
-/**
- * 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 {
-	known,
-	unavailable,
-	type CameraPermissionState,
-	type CameraPosition,
-	type CapabilityProfile,
-	type CapturedImage,
-	type CaptureRequest,
-} from '../config/types';
-import { CameraError, type CameraErrorCode } from '../diagnostics/errors';
-import type { CameraEngine } from '../native/cameraEngine';
-import type { PermissionPort } from '../permissions/permissionPort';
-import {
-	createArtifactStore,
-	type ArtifactStore,
-	type FileSystemBridge,
-} from '../storage/artifactStore';
-import type { AppStatus } from '../core/controller';
-
-export interface MemoryFileSystem extends FileSystemBridge {
-	/** Seeds a file with an explicit creation time, for time-to-live tests. */
-	seed(path: string, createdAtMs: number): void;
-	/** Every path currently present. */
-	paths(): readonly string[];
-}
-
-export function createMemoryFileSystem(root = '/cache'): MemoryFileSystem {
-	const files = new Map<string, number>();
-	const directories = new Set<string>();
-
-	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);
-		},
-		seed(path, createdAtMs) {
-			files.set(path, createdAtMs);
-		},
-		paths: () => Array.from(files.keys()),
-	};
-}
-
-export const DEFAULT_TEST_CAPABILITIES: CapabilityProfile = {
-	availablePositions: ['back', 'front'],
-	hasFlash: true,
-	hasTorch: true,
-	supportsOrientationChange: true,
-	hasCameraHardware: true,
-};
-
-export interface TestCameraConfig {
-	readonly permission?: CameraPermissionState;
-	readonly capabilities?: Partial<CapabilityProfile>;
-	readonly captureResult?: Partial<CapturedImage>;
-	readonly captureError?: CameraErrorCode;
-	readonly startError?: CameraErrorCode;
-	readonly cacheRoot?: string;
-}
-
-export interface TestCameraHandles {
-	readonly engine: CameraEngine;
-	readonly permissions: PermissionPort;
-	readonly store: ArtifactStore;
-	readonly fs: MemoryFileSystem;
-	/** Drives the controller's app foreground/background handling. */
-	subscribeToAppState(listener: (status: AppStatus) => void): () => void;
-	setAppState(status: AppStatus): void;
-	/** Simulates a Settings-level permission change while running (FR-007). */
-	setPermission(state: CameraPermissionState): void;
-	/** Simulates an OS preemption such as an incoming call. */
-	emitInterruption(): void;
-	setCaptureError(code: CameraErrorCode | null): void;
-	setStartError(code: CameraErrorCode | null): void;
-	/** Every capture the engine produced, in order. */
-	captures(): readonly CapturedImage[];
-	torchState(): boolean;
-	startCount(): number;
-	stopCount(): number;
-}
-
-export function createTestCamera(config: TestCameraConfig = {}): TestCameraHandles {
-	const fs = createMemoryFileSystem(config.cacheRoot ?? '/cache');
-	const store = createArtifactStore(fs);
-	const capabilities: CapabilityProfile = {
-		...DEFAULT_TEST_CAPABILITIES,
-		...config.capabilities,
-	};
-
-	let permission: CameraPermissionState = config.permission ?? 'undetermined';
-	let captureError: CameraErrorCode | null = config.captureError ?? null;
-	let startError: CameraErrorCode | null = config.startError ?? null;
-	let torch = false;
-	let starts = 0;
-	let stops = 0;
-	let sequence = 0;
-
-	const produced: CapturedImage[] = [];
-	const permissionListeners = new Set<(state: CameraPermissionState) => void>();
-	const appStateListeners = new Set<(status: AppStatus) => void>();
-	const interruptionListeners = new Set<() => void>();
-
-	const permissions: PermissionPort = {
-		async getStatus() {
-			return permission;
-		},
-		async request() {
-			// Mirrors the real adapter: never re-prompt after a permanent denial.
-			if (permission === 'deniedPermanently') {
-				return permission;
-			}
-			permission = permission === 'undetermined' || permission === 'denied' ? 'granted' : permission;
-			for (const listener of permissionListeners) {
-				listener(permission);
-			}
-			return permission;
-		},
-		subscribe(listener) {
-			permissionListeners.add(listener);
-			return () => {
-				permissionListeners.delete(listener);
-			};
-		},
-	};
-
-	const engine: CameraEngine = {
-		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: CaptureRequest) {
-			if (captureError) {
-				throw new CameraError(captureError);
-			}
-			sequence += 1;
-			const position: CameraPosition = request.cameraPosition ?? 'back';
-			const uri =
-				request.destination ?? `${store.temporaryDirectory()}/capture-${sequence}.jpg`;
-			fs.seed(uri, Date.now());
-
-			const image: CapturedImage = {
-				uri,
-				mimeType: 'image/jpeg',
-				width: 1920,
-				height: 1080,
-				timestamp: Date.now(),
-				cameraPosition: position,
-				ownership: request.destination ? 'appOwned' : 'packageTemporary',
-				effectiveQuality: request.quality ?? 0.9,
-				effectiveMaxDimension:
-					request.maxDimension === undefined ? unavailable() : known(request.maxDimension),
-				fileSize: known(1024),
-				orientation: known(0),
-				...config.captureResult,
-			};
-			produced.push(image);
-			return image;
-		},
-
-		async setTorch(enabled: boolean) {
-			torch = enabled;
-		},
-
-		async getCapabilities() {
-			return capabilities;
-		},
-	};
-
-	return {
-		engine,
-		permissions,
-		store,
-		fs,
-
-		subscribeToAppState(listener) {
-			appStateListeners.add(listener);
-			return () => {
-				appStateListeners.delete(listener);
-			};
-		},
-
-		setAppState(status) {
-			for (const listener of appStateListeners) {
-				listener(status);
-			}
-		},
-
-		setPermission(state) {
-			permission = state;
-			for (const listener of permissionListeners) {
-				listener(state);
-			}
-		},
-
-		emitInterruption() {
-			for (const listener of interruptionListeners) {
-				listener();
-			}
-			// An interruption behaves like the OS taking the camera away: the next
-			// start attempt fails until the app clears it.
-			startError = 'interrupted';
-		},
-
-		setCaptureError(code) {
-			captureError = code;
-		},
-
-		setStartError(code) {
-			startError = code;
-		},
-
-		captures: () => produced,
-		torchState: () => torch,
-		startCount: () => starts,
-		stopCount: () => stops,
-	};
-}
+/**
+ * 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 {
+	known,
+	unavailable,
+	type CameraPermissionState,
+	type CameraPosition,
+	type CapabilityProfile,
+	type CapturedImage,
+	type CaptureRequest,
+} from '../config/types';
+import { CameraError, type CameraErrorCode } from '../diagnostics/errors';
+import type { CameraEngine } from '../native/cameraEngine';
+import type { PermissionPort } from '../permissions/permissionPort';
+import {
+	createArtifactStore,
+	type ArtifactStore,
+	type FileSystemBridge,
+} from '../storage/artifactStore';
+import type { AppStatus } from '../core/controller';
+
+export interface MemoryFileSystem extends FileSystemBridge {
+	/** Seeds a file with an explicit creation time, for time-to-live tests. */
+	seed(path: string, createdAtMs: number): void;
+	/** Every path currently present. */
+	paths(): readonly string[];
+}
+
+export function createMemoryFileSystem(root = '/cache'): MemoryFileSystem {
+	const files = new Map<string, number>();
+	const directories = new Set<string>();
+
+	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: CapabilityProfile = {
+	availablePositions: ['back', 'front'],
+	hasFlash: true,
+	hasTorch: true,
+	supportsOrientationChange: true,
+	hasCameraHardware: true,
+};
+
+export interface TestCameraConfig {
+	readonly permission?: CameraPermissionState;
+	readonly capabilities?: Partial<CapabilityProfile>;
+	readonly captureResult?: Partial<CapturedImage>;
+	readonly captureError?: CameraErrorCode;
+	readonly startError?: CameraErrorCode;
+	readonly cacheRoot?: string;
+}
+
+export interface TestCameraHandles {
+	readonly engine: CameraEngine;
+	readonly permissions: PermissionPort;
+	readonly store: ArtifactStore;
+	readonly fs: MemoryFileSystem;
+	/** Drives the controller's app foreground/background handling. */
+	subscribeToAppState(listener: (status: AppStatus) => void): () => void;
+	setAppState(status: AppStatus): void;
+	/** Simulates a Settings-level permission change while running (FR-007). */
+	setPermission(state: CameraPermissionState): void;
+	/** Simulates an OS preemption such as an incoming call. */
+	emitInterruption(): void;
+	setCaptureError(code: CameraErrorCode | null): void;
+	setStartError(code: CameraErrorCode | null): void;
+	/** Every capture the engine produced, in order. */
+	captures(): readonly CapturedImage[];
+	torchState(): boolean;
+	startCount(): number;
+	stopCount(): number;
+}
+
+export function createTestCamera(config: TestCameraConfig = {}): TestCameraHandles {
+	const fs = createMemoryFileSystem(config.cacheRoot ?? '/cache');
+	const store = createArtifactStore(fs);
+	const capabilities: CapabilityProfile = {
+		...DEFAULT_TEST_CAPABILITIES,
+		...config.capabilities,
+	};
+
+	let permission: CameraPermissionState = config.permission ?? 'undetermined';
+	let captureError: CameraErrorCode | null = config.captureError ?? null;
+	let startError: CameraErrorCode | null = config.startError ?? null;
+	let torch = false;
+	let starts = 0;
+	let stops = 0;
+	let sequence = 0;
+
+	const produced: CapturedImage[] = [];
+	const permissionListeners = new Set<(state: CameraPermissionState) => void>();
+	const appStateListeners = new Set<(status: AppStatus) => void>();
+	const interruptionListeners = new Set<() => void>();
+
+	const permissions: PermissionPort = {
+		async getStatus() {
+			return permission;
+		},
+		async request() {
+			// Mirrors the real adapter: never re-prompt after a permanent denial.
+			if (permission === 'deniedPermanently') {
+				return permission;
+			}
+			permission =
+				permission === 'undetermined' || permission === 'denied' ? 'granted' : permission;
+			for (const listener of permissionListeners) {
+				listener(permission);
+			}
+			return permission;
+		},
+		subscribe(listener) {
+			permissionListeners.add(listener);
+			return () => {
+				permissionListeners.delete(listener);
+			};
+		},
+	};
+
+	const engine: CameraEngine = {
+		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: CaptureRequest) {
+			if (captureError) {
+				throw new CameraError(captureError);
+			}
+			sequence += 1;
+			const position: CameraPosition = request.cameraPosition ?? 'back';
+			const uri = request.destination ?? `${store.temporaryDirectory()}/capture-${sequence}.jpg`;
+			fs.seed(uri, Date.now());
+
+			const image: CapturedImage = {
+				uri,
+				mimeType: 'image/jpeg',
+				width: 1920,
+				height: 1080,
+				timestamp: Date.now(),
+				cameraPosition: position,
+				ownership: request.destination ? 'appOwned' : 'packageTemporary',
+				effectiveQuality: request.quality ?? 0.9,
+				effectiveMaxDimension:
+					request.maxDimension === undefined ? unavailable() : known(request.maxDimension),
+				fileSize: known(1024),
+				orientation: known(0),
+				...config.captureResult,
+			};
+			produced.push(image);
+			return image;
+		},
+
+		async setTorch(enabled: boolean) {
+			torch = enabled;
+		},
+
+		async getCapabilities() {
+			return capabilities;
+		},
+	};
+
+	return {
+		engine,
+		permissions,
+		store,
+		fs,
+
+		subscribeToAppState(listener) {
+			appStateListeners.add(listener);
+			return () => {
+				appStateListeners.delete(listener);
+			};
+		},
+
+		setAppState(status) {
+			for (const listener of appStateListeners) {
+				listener(status);
+			}
+		},
+
+		setPermission(state) {
+			permission = state;
+			for (const listener of permissionListeners) {
+				listener(state);
+			}
+		},
+
+		emitInterruption() {
+			for (const listener of interruptionListeners) {
+				listener();
+			}
+			// An interruption behaves like the OS taking the camera away: the next
+			// start attempt fails until the app clears it.
+			startError = 'interrupted';
+		},
+
+		setCaptureError(code) {
+			captureError = code;
+		},
+
+		setStartError(code) {
+			startError = code;
+		},
+
+		captures: () => produced,
+		torchState: () => torch,
+		startCount: () => starts,
+		stopCount: () => stops,
+	};
+}