@chipmobilesdk/rn-camera 0.4.0 → 0.5.0

package/lib/commonjs/core/controller.js

@@ -0,0 +1,452 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.DEFAULT_START_TIMEOUT_MS = void 0;
+Object.defineProperty(exports, "DEFAULT_TEMPORARY_TTL_MS", {
+  enumerable: true,
+  get: function () {
+    return _contract.DEFAULT_TEMPORARY_TTL_MS;
+  }
+});
+exports.createCameraController = createCameraController;
+var _rnCore = require("@chipmobilesdk/rn-core");
+var _errors = require("../diagnostics/errors.js");
+var _logger = require("../diagnostics/logger.js");
+var _contract = require("./contract.js");
+var _capabilities = require("./capabilities.js");
+var _captureController = require("./captureController.js");
+var _sessionMachine = require("./sessionMachine.js");
+var _sessionRuntime = require("./sessionRuntime.js");
+/**
+ * Camera controller — the object consuming apps actually drive.
+ *
+ * It owns observable state and orchestrates the three ports (engine,
+ * permissions, artifact store). All I/O lives here; the decisions live in
+ * `sessionMachine` and `captureController`, which stay pure so they can be
+ * tested without a camera.
+ */
+
+/** 24 hours (FR-029). */
+
+function defaultAppStateSubscribe(listener) {
+  // rn-core's one lifecycle subscription, shared with every other package; it
+  // requires react-native only on first subscribe (PERF-07).
+  return (0, _rnCore.appLifecycle)().subscribe(state => listener(state === 'active' ? 'active' : 'background'));
+}
+
+/** 8 s: a cold camera on a slow device, with room to spare (PERF-001 is 1.5 s). */
+const DEFAULT_START_TIMEOUT_MS = exports.DEFAULT_START_TIMEOUT_MS = 8_000;
+function createCameraController(options) {
+  if (!options?.engine || !options?.permissions) {
+    // A configuration fault, named as one. The ports are required by the type;
+    // this is the answer for a JavaScript caller or a cast.
+    throw new _errors.CameraError('unsupportedCapability', 'createCameraController requires `engine` and `permissions` ports. Use the ' + 'default adapters, or createTestCamera() in tests.');
+  }
+  const engine = options.engine;
+  const permissions = options.permissions;
+  const store = options.store;
+  const logger = (0, _logger.withSdkSinks)(options.logger ?? _logger.silentLogger);
+  const ttlMs = options.temporaryTtlMs ?? _contract.DEFAULT_TEMPORARY_TTL_MS;
+  const startTimeoutMs = options.startTimeoutMs ?? DEFAULT_START_TIMEOUT_MS;
+  const scheduler = options.scheduler ?? {
+    setTimeout: (callback, ms) => setTimeout(callback, ms),
+    clearTimeout: handle => clearTimeout(handle)
+  };
+  let session = _sessionMachine.initialSession;
+  let permission = 'undetermined';
+  let capabilities = null;
+  let cameraPosition = 'back';
+  let flashMode = 'off';
+  let torchEnabled = false;
+  let surfaceMounted = false;
+  let disposed = false;
+  let warnedUnmanaged = false;
+  let detach = null;
+  const capture = new _captureController.SingleFlight();
+  const listeners = (0, _rnCore.createListenerSet)({
+    onListenerError: () => logger.log({
+      type: 'session',
+      code: 'listener-threw'
+    })
+  });
+
+  /**
+   * The session's own I/O (`sessionRuntime`): starting it, waiting for frames,
+   * releasing it, following the app in and out of the foreground. It reads and
+   * writes the state above through this context, so one snapshot reaches
+   * subscribers whichever part changed it.
+   */
+  const runtime = (0, _sessionRuntime.createSessionRuntime)({
+    engine,
+    logger,
+    startTimeoutMs,
+    scheduler,
+    session: () => session,
+    dispatch,
+    emit,
+    cameraPosition: () => cameraPosition,
+    setCameraPosition: position => {
+      cameraPosition = position;
+    },
+    torchEnabled: () => torchEnabled,
+    setTorchEnabled: enabled => {
+      torchEnabled = enabled;
+    },
+    surfaceMounted: () => surfaceMounted,
+    permissionGranted: () => permission === 'granted',
+    disposed: () => disposed
+  });
+  function snapshot() {
+    return {
+      session: session.status,
+      permission,
+      capabilities,
+      cameraPosition,
+      flashMode,
+      torchEnabled,
+      capturing: capture.busy,
+      // What the mounted preview turned out to be, once it reported: the
+      // format's pixel size and the orientation coordinate mapping needs.
+      surface: runtime.surfaceInfo(),
+      error: session.error ? {
+        code: session.error.code,
+        recoverable: session.error.recoverable,
+        message: session.error.message
+      } : null
+    };
+  }
+  let current = snapshot();
+  function emit() {
+    current = snapshot();
+    // Isolated: one throwing subscriber neither starves the others nor unwinds
+    // into the transition that emitted, which left the controller half-updated.
+    listeners.notify(current);
+  }
+  function dispatch(event) {
+    const next = (0, _sessionMachine.sessionReducer)(session, event);
+    if (next !== session) {
+      session = next;
+      logger.log({
+        type: 'session',
+        code: session.status,
+        recoverable: session.error?.recoverable
+      });
+      emit();
+    }
+  }
+
+  /**
+   * Subscribes to permission and app-state changes and runs the sweep, on first
+   * use rather than at construction. React may build a controller during a
+   * render it then throws away (StrictMode does so on purpose); construction
+   * that subscribed leaked a listener pair every time.
+   */
+  function attach() {
+    if (detach || disposed) {
+      return;
+    }
+    const unsubscribePermission = permissions.subscribe(next => {
+      permission = next;
+      logger.log({
+        type: 'permission',
+        code: next
+      });
+      emit();
+      // A revocation while running must tear the session down, not leave a
+      // frozen preview on screen (FR-007).
+      if (next !== 'granted') {
+        runtime.armResumeOnForeground();
+        if (session.status !== 'idle' && session.status !== 'stopped') {
+          runtime.release().catch(() => undefined);
+        }
+      }
+    });
+    const unsubscribeAppState = (options.subscribeToAppState ?? defaultAppStateSubscribe)(status => runtime.onAppState(status));
+    // The OS can take the camera at any moment — another app, an incoming
+    // call, a disconnected device. The session has to go with it (CAM-19).
+    const unsubscribeInterruptions = engine.subscribeToInterruptions?.(code => runtime.onInterruption(code)) ?? (() => undefined);
+    detach = () => {
+      unsubscribePermission();
+      unsubscribeAppState();
+      unsubscribeInterruptions();
+    };
+
+    // FR-029: sweep our own temp directory once, asynchronously, so it can
+    // never add latency to the capture path or the preview start.
+    if (store && options.sweepOnInit !== false) {
+      store.sweep(ttlMs).then(removed => {
+        if (removed > 0) {
+          logger.log({
+            type: 'cleanup',
+            code: `swept:${removed}`
+          });
+        }
+      }).catch(() => {
+        // A failed sweep must never block startup.
+      });
+    }
+  }
+
+  /** Entry guard for operations that need a live controller. */
+  function live(operation) {
+    if (disposed) {
+      throw new _errors.CameraError('notReady', `${operation}() called on a disposed camera controller`);
+    }
+    attach();
+  }
+
+  /**
+   * Puts a package-temporary capture under the store so `cleanup()` and the
+   * sweep can reach it. Never throws: the capture itself succeeded, and a file
+   * the store cannot manage is still a usable photo.
+   */
+  async function manage(image) {
+    if (image.ownership !== 'packageTemporary') {
+      return image;
+    }
+    if (store?.adopt) {
+      try {
+        return {
+          ...image,
+          uri: await store.adopt(image.uri)
+        };
+      } catch {
+        logger.log({
+          type: 'cleanup',
+          code: 'adopt-failed'
+        });
+        return image;
+      }
+    }
+    if (!store?.owns(image.uri) && !warnedUnmanaged) {
+      warnedUnmanaged = true;
+      logger.log({
+        type: 'cleanup',
+        code: store ? 'unmanaged:store-cannot-adopt' : 'unmanaged:no-store'
+      });
+    }
+    return image;
+  }
+  const controller = {
+    get state() {
+      return current;
+    },
+    subscribe(listener) {
+      if (disposed) {
+        return () => undefined;
+      }
+      attach();
+      return listeners.add(listener);
+    },
+    async getPermission() {
+      live('getPermission');
+      permission = await permissions.getStatus();
+      emit();
+      return permission;
+    },
+    async requestPermission() {
+      live('requestPermission');
+      permission = 'requesting';
+      emit();
+      try {
+        permission = await permissions.request();
+      } catch (error) {
+        // A native call that failed used to leave the state at `requesting`
+        // forever, with no way for the app to ask again (CAM-07).
+        permission = await permissions.getStatus().catch(() => 'unavailable');
+        emit();
+        throw (0, _errors.isCameraError)(error) ? error : new _errors.CameraError('permissionDenied', 'The permission request could not be completed');
+      }
+      emit();
+      return permission;
+    },
+    async start(startOptions = {}) {
+      live('start');
+      if (permission !== 'granted') {
+        dispatch({
+          type: 'FAIL',
+          code: 'permissionDenied'
+        });
+        throw new _errors.CameraError('permissionDenied', 'Camera permission is not granted');
+      }
+      if (!(0, _sessionMachine.canStart)(session.status)) {
+        throw new _errors.CameraError('sessionConflict', `Session already ${session.status}`);
+      }
+      if (startOptions.cameraPosition) {
+        cameraPosition = startOptions.cameraPosition;
+      }
+      dispatch({
+        type: 'START'
+      });
+      await runtime.start(startOptions);
+      if (session.error) {
+        throw session.error;
+      }
+    },
+    async pause() {
+      if (disposed) {
+        return;
+      }
+      await runtime.forceTorchOff();
+      dispatch({
+        type: 'PAUSE'
+      });
+    },
+    async resume() {
+      live('resume');
+      dispatch({
+        type: 'RESUME'
+      });
+      if (session.status === 'starting') {
+        await runtime.start();
+      }
+    },
+    async stop() {
+      // An explicit stop is the user's decision; foregrounding must not undo it.
+      runtime.armResumeOnForeground();
+      if (disposed) {
+        return;
+      }
+      await runtime.release();
+    },
+    async capture(request = {}) {
+      live('capture');
+      const context = {
+        engine,
+        sessionStatus: session.status,
+        permissionGranted: permission === 'granted',
+        capabilities,
+        cameraPosition,
+        flashMode
+      };
+      // Guards run before the single-flight slot is taken so a rejected
+      // request cannot block a subsequent legal one.
+      (0, _captureController.assertCaptureAllowed)(context, request);
+      try {
+        const result = await capture.run(async () => {
+          emit();
+          const raw = await engine.capture({
+            ...request,
+            flashMode: request.flashMode ?? flashMode,
+            cameraPosition: request.cameraPosition ?? cameraPosition
+          });
+          return manage((0, _captureController.finalizeResult)(raw, request, context));
+        });
+        logger.log({
+          type: 'capture',
+          code: 'succeeded'
+        });
+        return result;
+      } catch (error) {
+        // The contract promises a CameraError; a raw native error carries
+        // no code to branch on and its message may hold a file path.
+        const failure = (0, _errors.isCameraError)(error) ? error : new _errors.CameraError('captureFailed', 'The camera failed to capture a photo');
+        logger.log({
+          type: 'capture',
+          code: failure.code,
+          recoverable: failure.recoverable
+        });
+        throw failure;
+      } finally {
+        // Without this a failed capture left `capturing: true` published
+        // until some unrelated change emitted again.
+        emit();
+      }
+    },
+    async cleanup(image) {
+      const uri = typeof image === 'string' ? image : image.uri;
+      if (!store) {
+        return;
+      }
+      // Refuse anything we did not create rather than deleting an arbitrary
+      // path, which also covers every appOwned artifact (FR-026b, FR-028).
+      if (!store.owns(uri)) {
+        logger.log({
+          type: 'cleanup',
+          code: 'refused-not-owned'
+        });
+        return;
+      }
+      await store.remove(uri);
+      logger.log({
+        type: 'cleanup',
+        code: 'removed'
+      });
+    },
+    async getCapabilities() {
+      live('getCapabilities');
+      try {
+        capabilities = await engine.getCapabilities();
+      } catch {
+        capabilities = _capabilities.EMPTY_CAPABILITIES;
+      }
+      logger.log({
+        type: 'capability',
+        code: capabilities.hasCameraHardware ? 'available' : 'no-hardware'
+      });
+      emit();
+      return capabilities;
+    },
+    setFlashMode(mode) {
+      (0, _capabilities.assertSupported)(mode === 'off' || capabilities?.hasFlash === true, `flash mode "${mode}"`);
+      flashMode = mode;
+      emit();
+    },
+    async setTorch(enabled) {
+      if (disposed && !enabled) {
+        return;
+      }
+      live('setTorch');
+      if (enabled) {
+        (0, _capabilities.assertSupported)((0, _capabilities.supportsTorch)(capabilities), 'torch');
+      }
+      await engine.setTorch(enabled);
+      torchEnabled = enabled;
+      emit();
+    },
+    reportSurfaceUnavailable() {
+      if (disposed) {
+        return;
+      }
+      logger.log({
+        type: 'session',
+        code: 'surface-unavailable',
+        recoverable: false
+      });
+      dispatch({
+        type: 'FAIL',
+        code: 'cameraUnavailable'
+      });
+    },
+    attachSurface(surface) {
+      return engine.attachSurface?.(surface) ?? (() => undefined);
+    },
+    reportSurfaceStarted(info) {
+      runtime.reportSurfaceStarted(info);
+    },
+    reportSurfaceFailed(code) {
+      runtime.reportSurfaceFailed(code);
+    },
+    setSurfaceMounted(mounted) {
+      if (disposed) {
+        return;
+      }
+      surfaceMounted = mounted;
+    },
+    async dispose() {
+      if (disposed) {
+        return;
+      }
+      disposed = true;
+      runtime.armResumeOnForeground();
+      detach?.();
+      detach = null;
+      await runtime.release();
+      listeners.clear();
+    }
+  };
+  return controller;
+}
+//# sourceMappingURL=controller.js.map

package/lib/commonjs/core/controller.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_rnCore","require","_errors","_logger","_contract","_capabilities","_captureController","_sessionMachine","_sessionRuntime","defaultAppStateSubscribe","listener","appLifecycle","subscribe","state","DEFAULT_START_TIMEOUT_MS","exports","createCameraController","options","engine","permissions","CameraError","store","logger","withSdkSinks","silentLogger","ttlMs","temporaryTtlMs","DEFAULT_TEMPORARY_TTL_MS","startTimeoutMs","scheduler","setTimeout","callback","ms","clearTimeout","handle","session","initialSession","permission","capabilities","cameraPosition","flashMode","torchEnabled","surfaceMounted","disposed","warnedUnmanaged","detach","capture","SingleFlight","listeners","createListenerSet","onListenerError","log","type","code","runtime","createSessionRuntime","dispatch","emit","setCameraPosition","position","setTorchEnabled","enabled","permissionGranted","snapshot","status","capturing","busy","surface","surfaceInfo","error","recoverable","message","current","notify","event","next","sessionReducer","attach","unsubscribePermission","armResumeOnForeground","release","catch","undefined","unsubscribeAppState","subscribeToAppState","onAppState","unsubscribeInterruptions","subscribeToInterruptions","onInterruption","sweepOnInit","sweep","then","removed","live","operation","manage","image","ownership","adopt","uri","owns","controller","add","getPermission","getStatus","requestPermission","request","isCameraError","start","startOptions","canStart","pause","forceTorchOff","resume","stop","context","sessionStatus","assertCaptureAllowed","result","run","raw","finalizeResult","failure","cleanup","remove","getCapabilities","EMPTY_CAPABILITIES","hasCameraHardware","setFlashMode","mode","assertSupported","hasFlash","setTorch","supportsTorch","reportSurfaceUnavailable","attachSurface","reportSurfaceStarted","info","reportSurfaceFailed","setSurfaceMounted","mounted","dispose","clear"],"sourceRoot":"../../../src","sources":["core/controller.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/core/sessionMachine.js

@@ -0,0 +1,116 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.canCapture = canCapture;
+exports.canStart = canStart;
+exports.initialSession = void 0;
+exports.sessionReducer = sessionReducer;
+var _errors = require("../diagnostics/errors.js");
+/**
+ * Session lifecycle state machine (FR-014..FR-019).
+ *
+ * Pure and synchronous: it decides what a transition means, the controller
+ * performs the I/O. That split is what makes every lifecycle rule in
+ * `data-model.md` section 2 testable without a camera.
+ *
+ * Backgrounding STOPS rather than pauses. Both operating systems can reclaim
+ * the camera anyway, and holding it risks leaving the OS camera indicator lit
+ * after the app is no longer in front of the user (FR-015).
+ */
+
+const initialSession = exports.initialSession = {
+  status: 'idle',
+  error: null
+};
+
+/** Statuses from which a fresh start is allowed (FR-019). */
+const STARTABLE = new Set(['idle', 'stopped', 'error']);
+function canStart(status) {
+  return STARTABLE.has(status);
+}
+
+/** Capture is only ever legal from a fully active session (FR-020). */
+function canCapture(status) {
+  return status === 'active';
+}
+function fail(code) {
+  return {
+    status: 'error',
+    error: new _errors.CameraError(code)
+  };
+}
+function sessionReducer(snapshot, event) {
+  const {
+    status
+  } = snapshot;
+  switch (event.type) {
+    case 'START':
+      if (!canStart(status)) {
+        // Refuse rather than silently stealing the camera from the surface
+        // that already holds it (FR-019).
+        return {
+          status,
+          error: new _errors.CameraError('sessionConflict')
+        };
+      }
+      return {
+        status: 'starting',
+        error: null
+      };
+    case 'STARTED':
+      return status === 'starting' ? {
+        status: 'active',
+        error: null
+      } : snapshot;
+    case 'START_TIMEOUT':
+      // Never sit in `starting` forever when frames stop arriving.
+      return status === 'starting' ? fail('captureFailed') : snapshot;
+    case 'PAUSE':
+      return status === 'active' ? {
+        status: 'paused',
+        error: null
+      } : snapshot;
+    case 'RESUME':
+      return status === 'paused' ? {
+        status: 'starting',
+        error: null
+      } : snapshot;
+    case 'STOP':
+      if (status === 'stopped' || status === 'idle') {
+        return snapshot;
+      }
+      return {
+        status: 'stopping',
+        error: snapshot.error
+      };
+    case 'STOPPED':
+      return {
+        status: 'stopped',
+        error: null
+      };
+    case 'BACKGROUND':
+      // Release, do not hold (FR-015).
+      if (status === 'active' || status === 'paused' || status === 'starting') {
+        return {
+          status: 'stopping',
+          error: null
+        };
+      }
+      return snapshot;
+    case 'FOREGROUND':
+      if (event.surfaceMounted && (status === 'stopped' || status === 'idle')) {
+        return {
+          status: 'starting',
+          error: null
+        };
+      }
+      return snapshot;
+    case 'FAIL':
+      return fail(event.code);
+    default:
+      return snapshot;
+  }
+}
+//# sourceMappingURL=sessionMachine.js.map

package/lib/commonjs/core/sessionMachine.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_errors","require","initialSession","exports","status","error","STARTABLE","Set","canStart","has","canCapture","fail","code","CameraError","sessionReducer","snapshot","event","type","surfaceMounted"],"sourceRoot":"../../../src","sources":["core/sessionMachine.ts"],"mappings":";;;;;;;;;AAaA,IAAAA,OAAA,GAAAC,OAAA;AAbA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAsBO,MAAMC,cAA+B,GAAAC,OAAA,CAAAD,cAAA,GAAG;EAAEE,MAAM,EAAE,MAAM;EAAEC,KAAK,EAAE;AAAK,CAAC;;AAE9E;AACA,MAAMC,SAAqC,GAAG,IAAIC,GAAG,CAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AAE3F,SAASC,QAAQA,CAACJ,MAAqB,EAAW;EACxD,OAAOE,SAAS,CAACG,GAAG,CAACL,MAAM,CAAC;AAC7B;;AAEA;AACO,SAASM,UAAUA,CAACN,MAAqB,EAAW;EAC1D,OAAOA,MAAM,KAAK,QAAQ;AAC3B;AAEA,SAASO,IAAIA,CAACC,IAAqB,EAAmB;EACrD,OAAO;IAAER,MAAM,EAAE,OAAO;IAAEC,KAAK,EAAE,IAAIQ,mBAAW,CAACD,IAAI;EAAE,CAAC;AACzD;AAEO,SAASE,cAAcA,CAACC,QAAyB,EAAEC,KAAmB,EAAmB;EAC/F,MAAM;IAAEZ;EAAO,CAAC,GAAGW,QAAQ;EAE3B,QAAQC,KAAK,CAACC,IAAI;IACjB,KAAK,OAAO;MACX,IAAI,CAACT,QAAQ,CAACJ,MAAM,CAAC,EAAE;QACtB;QACA;QACA,OAAO;UAAEA,MAAM;UAAEC,KAAK,EAAE,IAAIQ,mBAAW,CAAC,iBAAiB;QAAE,CAAC;MAC7D;MACA,OAAO;QAAET,MAAM,EAAE,UAAU;QAAEC,KAAK,EAAE;MAAK,CAAC;IAE3C,KAAK,SAAS;MACb,OAAOD,MAAM,KAAK,UAAU,GAAG;QAAEA,MAAM,EAAE,QAAQ;QAAEC,KAAK,EAAE;MAAK,CAAC,GAAGU,QAAQ;IAE5E,KAAK,eAAe;MACnB;MACA,OAAOX,MAAM,KAAK,UAAU,GAAGO,IAAI,CAAC,eAAe,CAAC,GAAGI,QAAQ;IAEhE,KAAK,OAAO;MACX,OAAOX,MAAM,KAAK,QAAQ,GAAG;QAAEA,MAAM,EAAE,QAAQ;QAAEC,KAAK,EAAE;MAAK,CAAC,GAAGU,QAAQ;IAE1E,KAAK,QAAQ;MACZ,OAAOX,MAAM,KAAK,QAAQ,GAAG;QAAEA,MAAM,EAAE,UAAU;QAAEC,KAAK,EAAE;MAAK,CAAC,GAAGU,QAAQ;IAE5E,KAAK,MAAM;MACV,IAAIX,MAAM,KAAK,SAAS,IAAIA,MAAM,KAAK,MAAM,EAAE;QAC9C,OAAOW,QAAQ;MAChB;MACA,OAAO;QAAEX,MAAM,EAAE,UAAU;QAAEC,KAAK,EAAEU,QAAQ,CAACV;MAAM,CAAC;IAErD,KAAK,SAAS;MACb,OAAO;QAAED,MAAM,EAAE,SAAS;QAAEC,KAAK,EAAE;MAAK,CAAC;IAE1C,KAAK,YAAY;MAChB;MACA,IAAID,MAAM,KAAK,QAAQ,IAAIA,MAAM,KAAK,QAAQ,IAAIA,MAAM,KAAK,UAAU,EAAE;QACxE,OAAO;UAAEA,MAAM,EAAE,UAAU;UAAEC,KAAK,EAAE;QAAK,CAAC;MAC3C;MACA,OAAOU,QAAQ;IAEhB,KAAK,YAAY;MAChB,IAAIC,KAAK,CAACE,cAAc,KAAKd,MAAM,KAAK,SAAS,IAAIA,MAAM,KAAK,MAAM,CAAC,EAAE;QACxE,OAAO;UAAEA,MAAM,EAAE,UAAU;UAAEC,KAAK,EAAE;QAAK,CAAC;MAC3C;MACA,OAAOU,QAAQ;IAEhB,KAAK,MAAM;MACV,OAAOJ,IAAI,CAACK,KAAK,CAACJ,IAAI,CAAC;IAExB;MACC,OAAOG,QAAQ;EACjB;AACD","ignoreList":[]}