@chipmobilesdk/rn-camera 0.4.0 → 0.5.0

package/lib/module/core/sessionMachine.js

@@ -0,0 +1,109 @@
+"use strict";
+
+/**
+ * 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).
+ */
+
+import { CameraError } from "../diagnostics/errors.js";
+export const initialSession = {
+  status: 'idle',
+  error: null
+};
+
+/** Statuses from which a fresh start is allowed (FR-019). */
+const STARTABLE = new Set(['idle', 'stopped', 'error']);
+export function canStart(status) {
+  return STARTABLE.has(status);
+}
+
+/** Capture is only ever legal from a fully active session (FR-020). */
+export function canCapture(status) {
+  return status === 'active';
+}
+function fail(code) {
+  return {
+    status: 'error',
+    error: new CameraError(code)
+  };
+}
+export 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 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/module/core/sessionMachine.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["CameraError","initialSession","status","error","STARTABLE","Set","canStart","has","canCapture","fail","code","sessionReducer","snapshot","event","type","surfaceMounted"],"sourceRoot":"../../../src","sources":["core/sessionMachine.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,SAASA,WAAW,QAA8B,0BAAuB;AAmBzE,OAAO,MAAMC,cAA+B,GAAG;EAAEC,MAAM,EAAE,MAAM;EAAEC,KAAK,EAAE;AAAK,CAAC;;AAE9E;AACA,MAAMC,SAAqC,GAAG,IAAIC,GAAG,CAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AAElG,OAAO,SAASC,QAAQA,CAACJ,MAAqB,EAAW;EACxD,OAAOE,SAAS,CAACG,GAAG,CAACL,MAAM,CAAC;AAC7B;;AAEA;AACA,OAAO,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,IAAIH,WAAW,CAACU,IAAI;EAAE,CAAC;AACzD;AAEA,OAAO,SAASC,cAAcA,CAACC,QAAyB,EAAEC,KAAmB,EAAmB;EAC/F,MAAM;IAAEX;EAAO,CAAC,GAAGU,QAAQ;EAE3B,QAAQC,KAAK,CAACC,IAAI;IACjB,KAAK,OAAO;MACX,IAAI,CAACR,QAAQ,CAACJ,MAAM,CAAC,EAAE;QACtB;QACA;QACA,OAAO;UAAEA,MAAM;UAAEC,KAAK,EAAE,IAAIH,WAAW,CAAC,iBAAiB;QAAE,CAAC;MAC7D;MACA,OAAO;QAAEE,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,GAAGS,QAAQ;IAE5E,KAAK,eAAe;MACnB;MACA,OAAOV,MAAM,KAAK,UAAU,GAAGO,IAAI,CAAC,eAAe,CAAC,GAAGG,QAAQ;IAEhE,KAAK,OAAO;MACX,OAAOV,MAAM,KAAK,QAAQ,GAAG;QAAEA,MAAM,EAAE,QAAQ;QAAEC,KAAK,EAAE;MAAK,CAAC,GAAGS,QAAQ;IAE1E,KAAK,QAAQ;MACZ,OAAOV,MAAM,KAAK,QAAQ,GAAG;QAAEA,MAAM,EAAE,UAAU;QAAEC,KAAK,EAAE;MAAK,CAAC,GAAGS,QAAQ;IAE5E,KAAK,MAAM;MACV,IAAIV,MAAM,KAAK,SAAS,IAAIA,MAAM,KAAK,MAAM,EAAE;QAC9C,OAAOU,QAAQ;MAChB;MACA,OAAO;QAAEV,MAAM,EAAE,UAAU;QAAEC,KAAK,EAAES,QAAQ,CAACT;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,OAAOS,QAAQ;IAEhB,KAAK,YAAY;MAChB,IAAIC,KAAK,CAACE,cAAc,KAAKb,MAAM,KAAK,SAAS,IAAIA,MAAM,KAAK,MAAM,CAAC,EAAE;QACxE,OAAO;UAAEA,MAAM,EAAE,UAAU;UAAEC,KAAK,EAAE;QAAK,CAAC;MAC3C;MACA,OAAOS,QAAQ;IAEhB,KAAK,MAAM;MACV,OAAOH,IAAI,CAACI,KAAK,CAACH,IAAI,CAAC;IAExB;MACC,OAAOE,QAAQ;EACjB;AACD","ignoreList":[]}

package/lib/module/core/sessionRuntime.js

@@ -0,0 +1,215 @@
+"use strict";
+
+/**
+ * The session's own I/O: starting it, waiting for frames, releasing it, and
+ * following the app in and out of the foreground.
+ *
+ * Split out of `controller.ts`, which had grown to hold three jobs at once:
+ * publishing state, running the session, and serving the public API. The
+ * decisions still live in `sessionMachine` (pure); this is the part that
+ * actually awaits the engine, and the controller composes it.
+ *
+ * It reads and writes the controller's state through `SessionContext` rather
+ * than owning it: one snapshot reaches subscribers, whichever part of the
+ * controller changed it.
+ */
+
+import { isCameraError } from "../diagnostics/errors.js";
+
+/** What the runtime needs from the controller that owns the state. */
+
+export function createSessionRuntime(context) {
+  let surfaceInfo = null;
+  /** Resolved by the surface's own report, or by the start timeout. */
+  let pendingStart = null;
+  let appStatus = 'active';
+  let resumeOnForeground = false;
+  let releasing;
+
+  /** Torch must never survive leaving the active state (FR-034b). */
+  async function forceTorchOff() {
+    if (!context.torchEnabled()) {
+      return;
+    }
+    context.setTorchEnabled(false);
+    try {
+      await context.engine.setTorch(false);
+    } catch {
+      // Torch-off is best effort; the session is going away regardless.
+    }
+    context.emit();
+  }
+  async function release() {
+    await forceTorchOff();
+    // Nothing to release. Going through STOP/STOPPED here turned an idle
+    // controller into `stopped` on every preview unmount.
+    const status = context.session().status;
+    if (status === 'idle' || status === 'stopped') {
+      return;
+    }
+    context.dispatch({
+      type: 'STOP'
+    });
+    try {
+      await context.engine.stop();
+      context.dispatch({
+        type: 'STOPPED'
+      });
+    } catch (error) {
+      context.dispatch({
+        type: 'FAIL',
+        code: isCameraError(error) ? error.code : 'captureFailed'
+      });
+    }
+  }
+
+  /**
+   * Waits for the mounted preview to report frames.
+   *
+   * `engine.start()` only confirms a device exists for the VisionCamera
+   * adapter: the session belongs to the `<Camera>` view. Calling the session
+   * active there made `capture()` right after `start()` fail with `notReady`,
+   * and a camera that never produced a frame left the session in `starting`
+   * forever (CAM-08).
+   */
+  function awaitSurfaceStart() {
+    return new Promise(resolve => {
+      const timer = context.scheduler.setTimeout(() => {
+        if (pendingStart) {
+          pendingStart = null;
+          context.dispatch({
+            type: 'START_TIMEOUT'
+          });
+          resolve();
+        }
+      }, context.startTimeoutMs);
+      const finish = () => {
+        context.scheduler.clearTimeout(timer);
+        pendingStart = null;
+        resolve();
+      };
+      pendingStart = {
+        settle: () => {
+          context.dispatch({
+            type: 'STARTED'
+          });
+          finish();
+        },
+        fail: code => {
+          context.dispatch({
+            type: 'FAIL',
+            code
+          });
+          finish();
+        }
+      };
+    });
+  }
+  async function start(options = {}) {
+    try {
+      await context.engine.start({
+        cameraPosition: options.cameraPosition ?? context.cameraPosition()
+      });
+    } catch (error) {
+      context.dispatch({
+        type: 'FAIL',
+        code: isCameraError(error) ? error.code : 'cameraUnavailable'
+      });
+      return;
+    }
+    if (context.engine.awaitsSurfaceStart !== true || !context.surfaceMounted()) {
+      // The engine owns its session, or there is no preview to wait for.
+      context.dispatch({
+        type: 'STARTED'
+      });
+      return;
+    }
+    await awaitSurfaceStart();
+  }
+  function resumeAfterForeground() {
+    if (context.disposed() || appStatus !== 'active' || !resumeOnForeground) {
+      return;
+    }
+    resumeOnForeground = false;
+    if (!context.surfaceMounted() || !context.permissionGranted()) {
+      return;
+    }
+    context.dispatch({
+      type: 'FOREGROUND',
+      surfaceMounted: true
+    });
+    if (context.session().status === 'starting') {
+      start().catch(() => undefined);
+    }
+  }
+  return {
+    start,
+    release,
+    forceTorchOff,
+    onAppState(status) {
+      appStatus = status;
+      if (status === 'background') {
+        const running = context.session().status;
+        resumeOnForeground ||= running === 'active' || running === 'starting';
+        context.dispatch({
+          type: 'BACKGROUND'
+        });
+        releasing = release().catch(() => undefined);
+      } else {
+        // Wait for a release still in flight, or the restart lands on a
+        // `stopping` session and is dropped.
+        (releasing ?? Promise.resolve()).then(resumeAfterForeground).catch(() => undefined);
+      }
+    },
+    reportSurfaceStarted(info) {
+      surfaceInfo = info;
+      if (info.cameraPosition !== context.cameraPosition()) {
+        // The device that mounted is the one taking the photos.
+        context.setCameraPosition(info.cameraPosition);
+      }
+      if (pendingStart) {
+        pendingStart.settle();
+      } else if (context.session().status === 'starting') {
+        context.dispatch({
+          type: 'STARTED'
+        });
+      } else {
+        context.emit();
+      }
+    },
+    reportSurfaceFailed(code) {
+      if (pendingStart) {
+        pendingStart.fail(code);
+        return;
+      }
+      context.dispatch({
+        type: 'FAIL',
+        code
+      });
+    },
+    onInterruption(code) {
+      context.logger.log({
+        type: 'session',
+        code
+      });
+      if (pendingStart) {
+        pendingStart.fail(code);
+        return;
+      }
+      const status = context.session().status;
+      if (status !== 'idle' && status !== 'stopped') {
+        context.dispatch({
+          type: 'FAIL',
+          code
+        });
+        release().catch(() => undefined);
+      }
+    },
+    surfaceInfo: () => surfaceInfo,
+    armResumeOnForeground() {
+      resumeOnForeground = false;
+    },
+    pending: () => releasing
+  };
+}
+//# sourceMappingURL=sessionRuntime.js.map

package/lib/module/core/sessionRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isCameraError","createSessionRuntime","context","surfaceInfo","pendingStart","appStatus","resumeOnForeground","releasing","forceTorchOff","torchEnabled","setTorchEnabled","engine","setTorch","emit","release","status","session","dispatch","type","stop","error","code","awaitSurfaceStart","Promise","resolve","timer","scheduler","setTimeout","startTimeoutMs","finish","clearTimeout","settle","fail","start","options","cameraPosition","awaitsSurfaceStart","surfaceMounted","resumeAfterForeground","disposed","permissionGranted","catch","undefined","onAppState","running","then","reportSurfaceStarted","info","setCameraPosition","reportSurfaceFailed","onInterruption","logger","log","armResumeOnForeground","pending"],"sourceRoot":"../../../src","sources":["core/sessionRuntime.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA,SAASA,aAAa,QAA8B,0BAAuB;;AAM3E;;AA6CA,OAAO,SAASC,oBAAoBA,CAACC,OAAuB,EAAkB;EAC7E,IAAIC,WAA+B,GAAG,IAAI;EAC1C;EACA,IAAIC,YAA0E,GAAG,IAAI;EACrF,IAAIC,SAAkC,GAAG,QAAQ;EACjD,IAAIC,kBAAkB,GAAG,KAAK;EAC9B,IAAIC,SAAoC;;EAExC;EACA,eAAeC,aAAaA,CAAA,EAAkB;IAC7C,IAAI,CAACN,OAAO,CAACO,YAAY,CAAC,CAAC,EAAE;MAC5B;IACD;IACAP,OAAO,CAACQ,eAAe,CAAC,KAAK,CAAC;IAC9B,IAAI;MACH,MAAMR,OAAO,CAACS,MAAM,CAACC,QAAQ,CAAC,KAAK,CAAC;IACrC,CAAC,CAAC,MAAM;MACP;IAAA;IAEDV,OAAO,CAACW,IAAI,CAAC,CAAC;EACf;EAEA,eAAeC,OAAOA,CAAA,EAAkB;IACvC,MAAMN,aAAa,CAAC,CAAC;IACrB;IACA;IACA,MAAMO,MAAM,GAAGb,OAAO,CAACc,OAAO,CAAC,CAAC,CAACD,MAAM;IACvC,IAAIA,MAAM,KAAK,MAAM,IAAIA,MAAM,KAAK,SAAS,EAAE;MAC9C;IACD;IACAb,OAAO,CAACe,QAAQ,CAAC;MAAEC,IAAI,EAAE;IAAO,CAAC,CAAC;IAClC,IAAI;MACH,MAAMhB,OAAO,CAACS,MAAM,CAACQ,IAAI,CAAC,CAAC;MAC3BjB,OAAO,CAACe,QAAQ,CAAC;QAAEC,IAAI,EAAE;MAAU,CAAC,CAAC;IACtC,CAAC,CAAC,OAAOE,KAAK,EAAE;MACflB,OAAO,CAACe,QAAQ,CAAC;QAChBC,IAAI,EAAE,MAAM;QACZG,IAAI,EAAErB,aAAa,CAACoB,KAAK,CAAC,GAAGA,KAAK,CAACC,IAAI,GAAG;MAC3C,CAAC,CAAC;IACH;EACD;;EAEA;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACC,SAASC,iBAAiBA,CAAA,EAAkB;IAC3C,OAAO,IAAIC,OAAO,CAAOC,OAAO,IAAI;MACnC,MAAMC,KAAK,GAAGvB,OAAO,CAACwB,SAAS,CAACC,UAAU,CAAC,MAAM;QAChD,IAAIvB,YAAY,EAAE;UACjBA,YAAY,GAAG,IAAI;UACnBF,OAAO,CAACe,QAAQ,CAAC;YAAEC,IAAI,EAAE;UAAgB,CAAC,CAAC;UAC3CM,OAAO,CAAC,CAAC;QACV;MACD,CAAC,EAAEtB,OAAO,CAAC0B,cAAc,CAAC;MAC1B,MAAMC,MAAM,GAAGA,CAAA,KAAM;QACpB3B,OAAO,CAACwB,SAAS,CAACI,YAAY,CAACL,KAAK,CAAC;QACrCrB,YAAY,GAAG,IAAI;QACnBoB,OAAO,CAAC,CAAC;MACV,CAAC;MACDpB,YAAY,GAAG;QACd2B,MAAM,EAAEA,CAAA,KAAM;UACb7B,OAAO,CAACe,QAAQ,CAAC;YAAEC,IAAI,EAAE;UAAU,CAAC,CAAC;UACrCW,MAAM,CAAC,CAAC;QACT,CAAC;QACDG,IAAI,EAAEX,IAAI,IAAI;UACbnB,OAAO,CAACe,QAAQ,CAAC;YAAEC,IAAI,EAAE,MAAM;YAAEG;UAAK,CAAC,CAAC;UACxCQ,MAAM,CAAC,CAAC;QACT;MACD,CAAC;IACF,CAAC,CAAC;EACH;EAEA,eAAeI,KAAKA,CAACC,OAAqB,GAAG,CAAC,CAAC,EAAiB;IAC/D,IAAI;MACH,MAAMhC,OAAO,CAACS,MAAM,CAACsB,KAAK,CAAC;QAC1BE,cAAc,EAAED,OAAO,CAACC,cAAc,IAAIjC,OAAO,CAACiC,cAAc,CAAC;MAClE,CAAC,CAAC;IACH,CAAC,CAAC,OAAOf,KAAK,EAAE;MACflB,OAAO,CAACe,QAAQ,CAAC;QAChBC,IAAI,EAAE,MAAM;QACZG,IAAI,EAAErB,aAAa,CAACoB,KAAK,CAAC,GAAGA,KAAK,CAACC,IAAI,GAAG;MAC3C,CAAC,CAAC;MACF;IACD;IACA,IAAInB,OAAO,CAACS,MAAM,CAACyB,kBAAkB,KAAK,IAAI,IAAI,CAAClC,OAAO,CAACmC,cAAc,CAAC,CAAC,EAAE;MAC5E;MACAnC,OAAO,CAACe,QAAQ,CAAC;QAAEC,IAAI,EAAE;MAAU,CAAC,CAAC;MACrC;IACD;IACA,MAAMI,iBAAiB,CAAC,CAAC;EAC1B;EAEA,SAASgB,qBAAqBA,CAAA,EAAS;IACtC,IAAIpC,OAAO,CAACqC,QAAQ,CAAC,CAAC,IAAIlC,SAAS,KAAK,QAAQ,IAAI,CAACC,kBAAkB,EAAE;MACxE;IACD;IACAA,kBAAkB,GAAG,KAAK;IAC1B,IAAI,CAACJ,OAAO,CAACmC,cAAc,CAAC,CAAC,IAAI,CAACnC,OAAO,CAACsC,iBAAiB,CAAC,CAAC,EAAE;MAC9D;IACD;IACAtC,OAAO,CAACe,QAAQ,CAAC;MAAEC,IAAI,EAAE,YAAY;MAAEmB,cAAc,EAAE;IAAK,CAAC,CAAC;IAC9D,IAAInC,OAAO,CAACc,OAAO,CAAC,CAAC,CAACD,MAAM,KAAK,UAAU,EAAE;MAC5CkB,KAAK,CAAC,CAAC,CAACQ,KAAK,CAAC,MAAMC,SAAS,CAAC;IAC/B;EACD;EAEA,OAAO;IACNT,KAAK;IACLnB,OAAO;IACPN,aAAa;IAEbmC,UAAUA,CAAC5B,MAAM,EAAE;MAClBV,SAAS,GAAGU,MAAM;MAClB,IAAIA,MAAM,KAAK,YAAY,EAAE;QAC5B,MAAM6B,OAAO,GAAG1C,OAAO,CAACc,OAAO,CAAC,CAAC,CAACD,MAAM;QACxCT,kBAAkB,KAAKsC,OAAO,KAAK,QAAQ,IAAIA,OAAO,KAAK,UAAU;QACrE1C,OAAO,CAACe,QAAQ,CAAC;UAAEC,IAAI,EAAE;QAAa,CAAC,CAAC;QACxCX,SAAS,GAAGO,OAAO,CAAC,CAAC,CAAC2B,KAAK,CAAC,MAAMC,SAAS,CAAC;MAC7C,CAAC,MAAM;QACN;QACA;QACA,CAACnC,SAAS,IAAIgB,OAAO,CAACC,OAAO,CAAC,CAAC,EAAEqB,IAAI,CAACP,qBAAqB,CAAC,CAACG,KAAK,CAAC,MAAMC,SAAS,CAAC;MACpF;IACD,CAAC;IAEDI,oBAAoBA,CAACC,IAAI,EAAE;MAC1B5C,WAAW,GAAG4C,IAAI;MAClB,IAAIA,IAAI,CAACZ,cAAc,KAAKjC,OAAO,CAACiC,cAAc,CAAC,CAAC,EAAE;QACrD;QACAjC,OAAO,CAAC8C,iBAAiB,CAACD,IAAI,CAACZ,cAAc,CAAC;MAC/C;MACA,IAAI/B,YAAY,EAAE;QACjBA,YAAY,CAAC2B,MAAM,CAAC,CAAC;MACtB,CAAC,MAAM,IAAI7B,OAAO,CAACc,OAAO,CAAC,CAAC,CAACD,MAAM,KAAK,UAAU,EAAE;QACnDb,OAAO,CAACe,QAAQ,CAAC;UAAEC,IAAI,EAAE;QAAU,CAAC,CAAC;MACtC,CAAC,MAAM;QACNhB,OAAO,CAACW,IAAI,CAAC,CAAC;MACf;IACD,CAAC;IAEDoC,mBAAmBA,CAAC5B,IAAI,EAAE;MACzB,IAAIjB,YAAY,EAAE;QACjBA,YAAY,CAAC4B,IAAI,CAACX,IAAI,CAAC;QACvB;MACD;MACAnB,OAAO,CAACe,QAAQ,CAAC;QAAEC,IAAI,EAAE,MAAM;QAAEG;MAAK,CAAC,CAAC;IACzC,CAAC;IAED6B,cAAcA,CAAC7B,IAAI,EAAE;MACpBnB,OAAO,CAACiD,MAAM,CAACC,GAAG,CAAC;QAAElC,IAAI,EAAE,SAAS;QAAEG;MAAK,CAAC,CAAC;MAC7C,IAAIjB,YAAY,EAAE;QACjBA,YAAY,CAAC4B,IAAI,CAACX,IAAI,CAAC;QACvB;MACD;MACA,MAAMN,MAAM,GAAGb,OAAO,CAACc,OAAO,CAAC,CAAC,CAACD,MAAM;MACvC,IAAIA,MAAM,KAAK,MAAM,IAAIA,MAAM,KAAK,SAAS,EAAE;QAC9Cb,OAAO,CAACe,QAAQ,CAAC;UAAEC,IAAI,EAAE,MAAM;UAAEG;QAAK,CAAC,CAAC;QACxCP,OAAO,CAAC,CAAC,CAAC2B,KAAK,CAAC,MAAMC,SAAS,CAAC;MACjC;IACD,CAAC;IAEDvC,WAAW,EAAEA,CAAA,KAAMA,WAAW;IAE9BkD,qBAAqBA,CAAA,EAAG;MACvB/C,kBAAkB,GAAG,KAAK;IAC3B,CAAC;IAEDgD,OAAO,EAAEA,CAAA,KAAM/C;EAChB,CAAC;AACF","ignoreList":[]}

package/lib/module/diagnostics/errors.js

@@ -0,0 +1,79 @@
+"use strict";
+
+/**
+ * Typed error taxonomy (FR-044) and redaction helper (FR-038).
+ *
+ * The taxonomy exists so consuming apps can branch on `code` and `recoverable`
+ * instead of string-matching messages. Messages never carry file paths or image
+ * payloads — `redact` is applied before any value reaches a log sink.
+ */
+
+import { COMMON_PATTERNS, PATH_PATTERN, SdkError, redactPatterns } from '@chipmobilesdk/rn-core';
+/** Codes the app may retry; everything else ends the session. */
+const RECOVERABLE = new Set(['permissionDenied', 'cameraInUse', 'sessionConflict', 'notReady', 'captureInProgress', 'captureFailed', 'storageFailure', 'unsupportedCapability', 'interrupted']);
+
+/** The package's error; an `SdkError` (`@chipmobilesdk/rn-core`) with `pkg: 'rn-camera'`. */
+export class CameraError extends SdkError {
+  constructor(code, message) {
+    super('rn-camera', code, {
+      message,
+      retryable: RECOVERABLE.has(code)
+    });
+    this.name = 'CameraError';
+  }
+
+  /** @deprecated Use `retryable`, the name every SDK package shares. */
+  get recoverable() {
+    return this.retryable;
+  }
+}
+export function isCameraError(value) {
+  return value instanceof CameraError;
+}
+
+/**
+ * rn-core's shared patterns (URLs, including file URIs; JWTs; e-mail addresses;
+ * UUIDs; base64-ish payload runs) plus POSIX and Windows paths.
+ */
+const PATTERNS = [...COMMON_PATTERNS, PATH_PATTERN];
+const REDACTED = '[redacted]';
+const SENSITIVE_KEYS = new Set(['uri', 'path', 'destination', 'file', 'data', 'base64']);
+function redactString(value) {
+  return redactPatterns(value, PATTERNS);
+}
+
+/**
+ * Strips paths and payload-shaped strings from a value before logging (FR-038).
+ * Recurses through plain objects and arrays; known-sensitive keys are dropped
+ * wholesale rather than pattern-matched, since a bare filename has no separator
+ * for the path pattern to catch.
+ */
+export function redact(value) {
+  if (typeof value === 'string') {
+    return redactString(value);
+  }
+  if (Array.isArray(value)) {
+    return value.map(redact);
+  }
+  if (value instanceof CameraError) {
+    return {
+      code: value.code,
+      recoverable: value.retryable
+    };
+  }
+  if (value instanceof Error) {
+    return {
+      name: value.name,
+      message: redactString(value.message)
+    };
+  }
+  if (value && typeof value === 'object') {
+    const out = {};
+    for (const [key, item] of Object.entries(value)) {
+      out[key] = SENSITIVE_KEYS.has(key) ? REDACTED : redact(item);
+    }
+    return out;
+  }
+  return value;
+}
+//# sourceMappingURL=errors.js.map

package/lib/module/diagnostics/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["COMMON_PATTERNS","PATH_PATTERN","SdkError","redactPatterns","RECOVERABLE","Set","CameraError","constructor","code","message","retryable","has","name","recoverable","isCameraError","value","PATTERNS","REDACTED","SENSITIVE_KEYS","redactString","redact","Array","isArray","map","Error","out","key","item","Object","entries"],"sourceRoot":"../../../src","sources":["diagnostics/errors.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,eAAe,EAAEC,YAAY,EAAEC,QAAQ,EAAEC,cAAc,QAAQ,wBAAwB;AAehG;AACA,MAAMC,WAAyC,GAAG,IAAIC,GAAG,CAAkB,CAC1E,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,uBAAuB,EACvB,aAAa,CACb,CAAC;;AAEF;AACA,OAAO,MAAMC,WAAW,SAASJ,QAAQ,CAAkB;EAC1DK,WAAWA,CAACC,IAAqB,EAAEC,OAAgB,EAAE;IACpD,KAAK,CAAC,WAAW,EAAED,IAAI,EAAE;MAAEC,OAAO;MAAEC,SAAS,EAAEN,WAAW,CAACO,GAAG,CAACH,IAAI;IAAE,CAAC,CAAC;IACvE,IAAI,CAACI,IAAI,GAAG,aAAa;EAC1B;;EAEA;EACA,IAAIC,WAAWA,CAAA,EAAY;IAC1B,OAAO,IAAI,CAACH,SAAS;EACtB;AACD;AAEA,OAAO,SAASI,aAAaA,CAACC,KAAc,EAAwB;EACnE,OAAOA,KAAK,YAAYT,WAAW;AACpC;;AAEA;AACA;AACA;AACA;AACA,MAAMU,QAAQ,GAAG,CAAC,GAAGhB,eAAe,EAAEC,YAAY,CAAC;AAEnD,MAAMgB,QAAQ,GAAG,YAAY;AAC7B,MAAMC,cAAc,GAAG,IAAIb,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;AAExF,SAASc,YAAYA,CAACJ,KAAa,EAAU;EAC5C,OAAOZ,cAAc,CAACY,KAAK,EAAEC,QAAQ,CAAC;AACvC;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASI,MAAMA,CAACL,KAAc,EAAW;EAC/C,IAAI,OAAOA,KAAK,KAAK,QAAQ,EAAE;IAC9B,OAAOI,YAAY,CAACJ,KAAK,CAAC;EAC3B;EACA,IAAIM,KAAK,CAACC,OAAO,CAACP,KAAK,CAAC,EAAE;IACzB,OAAOA,KAAK,CAACQ,GAAG,CAACH,MAAM,CAAC;EACzB;EACA,IAAIL,KAAK,YAAYT,WAAW,EAAE;IACjC,OAAO;MAAEE,IAAI,EAAEO,KAAK,CAACP,IAAI;MAAEK,WAAW,EAAEE,KAAK,CAACL;IAAU,CAAC;EAC1D;EACA,IAAIK,KAAK,YAAYS,KAAK,EAAE;IAC3B,OAAO;MAAEZ,IAAI,EAAEG,KAAK,CAACH,IAAI;MAAEH,OAAO,EAAEU,YAAY,CAACJ,KAAK,CAACN,OAAO;IAAE,CAAC;EAClE;EACA,IAAIM,KAAK,IAAI,OAAOA,KAAK,KAAK,QAAQ,EAAE;IACvC,MAAMU,GAA4B,GAAG,CAAC,CAAC;IACvC,KAAK,MAAM,CAACC,GAAG,EAAEC,IAAI,CAAC,IAAIC,MAAM,CAACC,OAAO,CAACd,KAAK,CAAC,EAAE;MAChDU,GAAG,CAACC,GAAG,CAAC,GAAGR,cAAc,CAACP,GAAG,CAACe,GAAG,CAAC,GAAGT,QAAQ,GAAGG,MAAM,CAACO,IAAI,CAAC;IAC7D;IACA,OAAOF,GAAG;EACX;EACA,OAAOV,KAAK;AACb","ignoreList":[]}

package/lib/module/diagnostics/logger.js

@@ -0,0 +1,35 @@
+"use strict";
+
+/**
+ * Optional consumer-supplied logger (research R4).
+ *
+ * The default is no logging at all, so FR-038 holds whether or not a consumer
+ * opts in. Event bodies carry codes and states only — never file paths, never
+ * image data — so an opted-in logger still cannot leak an image path.
+ */
+
+import { createDiagnosticChannel } from '@chipmobilesdk/rn-core';
+const channel = createDiagnosticChannel('rn-camera');
+
+/**
+ * Every event also reaches the app's SDK sinks (`installSdkSink`, CORE-08), as
+ * `<type>.<code>`: the same code-and-state body, so nothing new can leak.
+ */
+export function withSdkSinks(logger) {
+  return {
+    log(event) {
+      channel.emit(`${event.type}.${event.code}`, event.code === 'listener-threw' ? 'error' : event.recoverable === false ? 'warn' : 'info', event.recoverable === undefined ? undefined : {
+        retryable: event.recoverable
+      });
+      logger.log(event);
+    }
+  };
+}
+
+/** No-op logger used when the consumer supplies none. */
+export const silentLogger = {
+  log() {
+    // Intentionally empty: logging is opt-in.
+  }
+};
+//# sourceMappingURL=logger.js.map

package/lib/module/diagnostics/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createDiagnosticChannel","channel","withSdkSinks","logger","log","event","emit","type","code","recoverable","undefined","retryable","silentLogger"],"sourceRoot":"../../../src","sources":["diagnostics/logger.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,uBAAuB,QAAQ,wBAAwB;AAchE,MAAMC,OAAO,GAAGD,uBAAuB,CAAC,WAAW,CAAC;;AAEpD;AACA;AACA;AACA;AACA,OAAO,SAASE,YAAYA,CAACC,MAAoB,EAAgB;EAChE,OAAO;IACNC,GAAGA,CAACC,KAAK,EAAE;MACVJ,OAAO,CAACK,IAAI,CACX,GAAGD,KAAK,CAACE,IAAI,IAAIF,KAAK,CAACG,IAAI,EAAE,EAC7BH,KAAK,CAACG,IAAI,KAAK,gBAAgB,GAAG,OAAO,GAAGH,KAAK,CAACI,WAAW,KAAK,KAAK,GAAG,MAAM,GAAG,MAAM,EACzFJ,KAAK,CAACI,WAAW,KAAKC,SAAS,GAAGA,SAAS,GAAG;QAAEC,SAAS,EAAEN,KAAK,CAACI;MAAY,CAC9E,CAAC;MACDN,MAAM,CAACC,GAAG,CAACC,KAAK,CAAC;IAClB;EACD,CAAC;AACF;;AAEA;AACA,OAAO,MAAMO,YAA0B,GAAG;EACzCR,GAAGA,CAAA,EAAG;IACL;EAAA;AAEF,CAAC","ignoreList":[]}

package/lib/module/geometry/coordinateMapping.js

@@ -0,0 +1,149 @@
+"use strict";
+
+/**
+ * Bidirectional coordinate mapping between preview space and captured-image
+ * space (FR-036, SC-012).
+ *
+ * Pure functions with no native involvement (research R5). Everything needed is
+ * already known in JavaScript, so keeping this pure is what makes the 2-pixel
+ * round-trip tolerance verifiable in CI rather than only on a device.
+ *
+ * Composition order, preview -> image: undo mirror, undo letterbox/crop offset,
+ * undo scale, undo orientation. Image -> preview reverses it exactly.
+ */
+
+/** Orientation rotates the image for display, swapping dimensions at 90/270. */
+function isQuarterTurn(orientation) {
+  const normalized = (orientation % 360 + 360) % 360;
+  return normalized === 90 || normalized === 270;
+}
+function normalizeOrientation(orientation) {
+  const normalized = (Math.round(orientation / 90) * 90 % 360 + 360) % 360;
+  return normalized;
+}
+function projection(geometry) {
+  const swap = isQuarterTurn(geometry.orientation);
+  const displayWidth = swap ? geometry.imageHeight : geometry.imageWidth;
+  const displayHeight = swap ? geometry.imageWidth : geometry.imageHeight;
+  const scaleX = geometry.previewWidth / displayWidth;
+  const scaleY = geometry.previewHeight / displayHeight;
+  // `cover` fills and crops the overflow; `contain` fits and letterboxes.
+  const scale = geometry.resizeMode === 'cover' ? Math.max(scaleX, scaleY) : Math.min(scaleX, scaleY);
+  return {
+    scale,
+    // Negative under `cover` (cropped away), positive under `contain`
+    // (letterbox bands). The same arithmetic covers both.
+    offsetX: (geometry.previewWidth - displayWidth * scale) / 2,
+    offsetY: (geometry.previewHeight - displayHeight * scale) / 2,
+    displayWidth,
+    displayHeight
+  };
+}
+
+/** Display-space point -> original image point, undoing the rotation. */
+function unrotate(point, geometry) {
+  switch (normalizeOrientation(geometry.orientation)) {
+    case 90:
+      return {
+        x: point.y,
+        y: geometry.imageHeight - point.x
+      };
+    case 180:
+      return {
+        x: geometry.imageWidth - point.x,
+        y: geometry.imageHeight - point.y
+      };
+    case 270:
+      return {
+        x: geometry.imageWidth - point.y,
+        y: point.x
+      };
+    default:
+      return point;
+  }
+}
+
+/** Original image point -> display-space point, applying the rotation. */
+function rotate(point, geometry) {
+  switch (normalizeOrientation(geometry.orientation)) {
+    case 90:
+      return {
+        x: geometry.imageHeight - point.y,
+        y: point.x
+      };
+    case 180:
+      return {
+        x: geometry.imageWidth - point.x,
+        y: geometry.imageHeight - point.y
+      };
+    case 270:
+      return {
+        x: point.y,
+        y: geometry.imageWidth - point.x
+      };
+    default:
+      return point;
+  }
+}
+
+/**
+ * Maps a preview-space point into captured-image space. Points outside the
+ * visible region stay representable (they fall outside the image bounds) rather
+ * than being clamped to an edge, so callers can detect an out-of-frame overlay.
+ */
+export function mapPointToImage(point, geometry) {
+  const {
+    scale,
+    offsetX,
+    offsetY
+  } = projection(geometry);
+  const x = geometry.isMirrored ? geometry.previewWidth - point.x : point.x;
+  return unrotate({
+    x: (x - offsetX) / scale,
+    y: (point.y - offsetY) / scale
+  }, geometry);
+}
+
+/** Maps a captured-image point into preview space. Exact inverse of the above. */
+export function mapPointToPreview(point, geometry) {
+  const {
+    scale,
+    offsetX,
+    offsetY
+  } = projection(geometry);
+  const rotated = rotate(point, geometry);
+  const x = rotated.x * scale + offsetX;
+  return {
+    x: geometry.isMirrored ? geometry.previewWidth - x : x,
+    y: rotated.y * scale + offsetY
+  };
+}
+
+/** Axis-aligned bounding box of the mapped corners — exact for quarter turns. */
+function boundsOf(a, b) {
+  return {
+    x: Math.min(a.x, b.x),
+    y: Math.min(a.y, b.y),
+    width: Math.abs(b.x - a.x),
+    height: Math.abs(b.y - a.y)
+  };
+}
+export function mapRectToImage(rect, geometry) {
+  return boundsOf(mapPointToImage({
+    x: rect.x,
+    y: rect.y
+  }, geometry), mapPointToImage({
+    x: rect.x + rect.width,
+    y: rect.y + rect.height
+  }, geometry));
+}
+export function mapRectToPreview(rect, geometry) {
+  return boundsOf(mapPointToPreview({
+    x: rect.x,
+    y: rect.y
+  }, geometry), mapPointToPreview({
+    x: rect.x + rect.width,
+    y: rect.y + rect.height
+  }, geometry));
+}
+//# sourceMappingURL=coordinateMapping.js.map

package/lib/module/geometry/coordinateMapping.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isQuarterTurn","orientation","normalized","normalizeOrientation","Math","round","projection","geometry","swap","displayWidth","imageHeight","imageWidth","displayHeight","scaleX","previewWidth","scaleY","previewHeight","scale","resizeMode","max","min","offsetX","offsetY","unrotate","point","x","y","rotate","mapPointToImage","isMirrored","mapPointToPreview","rotated","boundsOf","a","b","width","abs","height","mapRectToImage","rect","mapRectToPreview"],"sourceRoot":"../../../src","sources":["geometry/coordinateMapping.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/index.js

@@ -0,0 +1,44 @@
+"use strict";
+
+/**
+ * @chipmobilesdk/rn-camera — reusable camera infrastructure for
+ * ChipMobileSdk-family React Native apps.
+ *
+ * This is the single public entrypoint (LIB-003). Modules under `core/`,
+ * `native/`, `permissions/`, `storage/`, `geometry/`, `diagnostics/`, and
+ * `testing/` are private; import them only through this file.
+ *
+ * The package contains no business logic, sends nothing over the network, and
+ * writes nothing to the device gallery. Phase one runs no on-device inference —
+ * see the reserved frame-processing extension point in the README.
+ */
+
+// Public types
+
+export { known, unavailable } from "./config/types.js";
+
+// Controller
+export { createCameraController, DEFAULT_TEMPORARY_TTL_MS } from "./core/controller.js";
+
+// Ports + default adapters
+
+export { createSurfaceRegistry } from "./native/visionSurface.js";
+export { createVisionCameraEngine } from "./native/cameraEngine.js";
+export { createVisionCameraPermissions } from "./permissions/permissionPort.js";
+export { createArtifactStore, createCacheArtifactStore } from "./storage/artifactStore.js";
+
+// React surface
+export { CameraPreview } from "./react/CameraPreview.js";
+export { useCameraController, useCameraState } from "./react/hooks.js";
+
+// Coordinate mapping (pure)
+export { mapPointToImage, mapPointToPreview, mapRectToImage, mapRectToPreview } from "./geometry/coordinateMapping.js";
+
+// Diagnostics
+export { CameraError, isCameraError, redact } from "./diagnostics/errors.js";
+
+// The test adapter (FR-041) is not here: it lives at `@chipmobilesdk/rn-camera/testing`.
+// Re-exporting it from this entrypoint put the fake camera in the module graph of
+// every app that imports the package, and Metro does not tree-shake it back out
+// (PERF-14). It is still the same published ports the real adapters implement.
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["known","unavailable","createCameraController","DEFAULT_TEMPORARY_TTL_MS","createSurfaceRegistry","createVisionCameraEngine","createVisionCameraPermissions","createArtifactStore","createCacheArtifactStore","CameraPreview","useCameraController","useCameraState","mapPointToImage","mapPointToPreview","mapRectToImage","mapRectToPreview","CameraError","isCameraError","redact"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;;AAqBA,SAASA,KAAK,EAAEC,WAAW,QAAQ,mBAAgB;;AAEnD;AACA,SAASC,sBAAsB,EAAEC,wBAAwB,QAAQ,sBAAmB;;AAGpF;;AAGA,SAASC,qBAAqB,QAAQ,2BAAwB;AAC9D,SAASC,wBAAwB,QAAQ,0BAAuB;AAEhE,SAASC,6BAA6B,QAAQ,iCAA8B;AAE5E,SAASC,mBAAmB,EAAEC,wBAAwB,QAAQ,4BAAyB;;AAEvF;AACA,SAASC,aAAa,QAAQ,0BAAuB;AAErD,SAASC,mBAAmB,EAAEC,cAAc,QAAQ,kBAAe;;AAEnE;AACA,SACCC,eAAe,EACfC,iBAAiB,EACjBC,cAAc,EACdC,gBAAgB,QACV,iCAA8B;;AAErC;AACA,SAASC,WAAW,EAAEC,aAAa,EAAEC,MAAM,QAAQ,yBAAsB;;AAIzE;AACA;AACA;AACA","ignoreList":[]}