smartcomply-web-sdk 1.0.80 → 1.0.82

package/dist/camera/ActionDetector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ActionDetector.d.ts","sourceRoot":"","sources":["../../src/camera/ActionDetector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAsBrD,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,WAAW,CAAuB;IAE1C,KAAK,CAAC,MAAM,EAAE,mBAAmB,GAAG,YAAY;IA+BhD,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,UAAU;CAInB"}
+{"version":3,"file":"ActionDetector.d.ts","sourceRoot":"","sources":["../../src/camera/ActionDetector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAwBrD,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,WAAW,CAAuB;IAE1C,KAAK,CAAC,MAAM,EAAE,mBAAmB,GAAG,YAAY;IA+BhD,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,UAAU;CAInB"}

package/dist/camera/ActionDetector.js

@@ -11,10 +11,12 @@ exports.ActionDetector = void 0;
  * commanding specific actions in order. This mirrors a passive liveness scan
  * rather than a step-by-step obstacle course.
  *
- * Pass criteria: at least one genuine blink OR a natural head-yaw excursion
- * detected at any point during the window — whichever happens first, since a
- * real person glancing around naturally will trigger one or both without
- * being told to.
+ * Pass criteria: BOTH a genuine blink AND a natural head-yaw excursion must
+ * be detected during the window, in either order — one signal alone is too
+ * easy for a held-up photo or a short video replay to trigger by accident
+ * (e.g. incidental camera/device motion registering as "head-yaw" with no
+ * live person present). Requiring both raises the bar without going back to
+ * commanded, sequential actions.
  */
 const BLINK_THRESHOLD = 0.25;
 const BLINK_HOLD_FRAMES = 2;
@@ -59,7 +61,7 @@ class ActionDetector {
             faceDetected,
             blinkDetected: this.blinkDetected,
             motionDetected: this.motionDetected,
-            livenessConfirmed: this.blinkDetected || this.motionDetected,
+            livenessConfirmed: this.blinkDetected && this.motionDetected,
         };
     }
     getHeadYaw(matrix) {

package/dist/camera/ActionDetector.js.map

@@ -1 +1 @@
-{"version":3,"file":"ActionDetector.js","sourceRoot":"","sources":["../../src/camera/ActionDetector.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,eAAe,GAAG,IAAI,CAAC;AAC7B,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAC5B,MAAM,wBAAwB,GAAG,CAAC,CAAC,CAAC,oDAAoD;AASxF,MAAa,cAAc;IAA3B;QACU,mBAAc,GAAG,CAAC,CAAC;QACnB,kBAAa,GAAG,KAAK,CAAC;QACtB,mBAAc,GAAG,KAAK,CAAC;QACvB,gBAAW,GAAkB,IAAI,CAAC;IA8C5C,CAAC;IA5CC,KAAK,CAAC,MAA2B;QAC/B,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;QAED,MAAM,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC;QAC9B,MAAM,SAAS,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAEvF,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,IAAI,SAAS,IAAI,eAAe,EAAE,CAAC;gBACjC,IAAI,CAAC,cAAc,EAAE,CAAC;gBACtB,IAAI,IAAI,CAAC,cAAc,IAAI,iBAAiB,EAAE,CAAC;oBAC7C,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;gBAC5B,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;YACpD,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;gBAC9B,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC;YACzB,CAAC;iBAAM,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,wBAAwB,EAAE,CAAC;gBACxE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;YAC7B,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAEO,aAAa,CAAC,YAAqB;QACzC,OAAO;YACL,YAAY;YACZ,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,iBAAiB,EAAE,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,cAAc;SAC7D,CAAC;IACJ,CAAC;IAEO,UAAU,CAAC,MAAuB;QACxC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,EAAE;YAAE,OAAO,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7D,CAAC;CACF;AAlDD,wCAkDC"}
+{"version":3,"file":"ActionDetector.js","sourceRoot":"","sources":["../../src/camera/ActionDetector.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,eAAe,GAAG,IAAI,CAAC;AAC7B,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAC5B,MAAM,wBAAwB,GAAG,CAAC,CAAC,CAAC,oDAAoD;AASxF,MAAa,cAAc;IAA3B;QACU,mBAAc,GAAG,CAAC,CAAC;QACnB,kBAAa,GAAG,KAAK,CAAC;QACtB,mBAAc,GAAG,KAAK,CAAC;QACvB,gBAAW,GAAkB,IAAI,CAAC;IA8C5C,CAAC;IA5CC,KAAK,CAAC,MAA2B;QAC/B,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;QAED,MAAM,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC;QAC9B,MAAM,SAAS,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAEvF,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,IAAI,SAAS,IAAI,eAAe,EAAE,CAAC;gBACjC,IAAI,CAAC,cAAc,EAAE,CAAC;gBACtB,IAAI,IAAI,CAAC,cAAc,IAAI,iBAAiB,EAAE,CAAC;oBAC7C,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;gBAC5B,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;YACpD,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;gBAC9B,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC;YACzB,CAAC;iBAAM,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,wBAAwB,EAAE,CAAC;gBACxE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;YAC7B,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAEO,aAAa,CAAC,YAAqB;QACzC,OAAO;YACL,YAAY;YACZ,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,iBAAiB,EAAE,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,cAAc;SAC7D,CAAC;IACJ,CAAC;IAEO,UAAU,CAAC,MAAuB;QACxC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,EAAE;YAAE,OAAO,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7D,CAAC;CACF;AAlDD,wCAkDC"}

package/dist/client/Smartcomply.d.ts

@@ -21,7 +21,7 @@ export declare class SmartComply {
      * CDN tag they installed with (e.g. @1, which floats to the latest
      * matching release) actually resolved to the version they expect.
      */
-    static readonly VERSION = "1.0.80";
+    static readonly VERSION = "1.0.82";
     private http;
     private clientId;
     private _sessionToken;

package/dist/client/Smartcomply.js

@@ -85,5 +85,5 @@ exports.SmartComply = SmartComply;
  * CDN tag they installed with (e.g. @1, which floats to the latest
  * matching release) actually resolved to the version they expect.
  */
-SmartComply.VERSION = "1.0.80";
+SmartComply.VERSION = "1.0.82";
 //# sourceMappingURL=Smartcomply.js.map

package/dist/esm/camera/ActionDetector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ActionDetector.d.ts","sourceRoot":"","sources":["../../../src/camera/ActionDetector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAsBrD,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,WAAW,CAAuB;IAE1C,KAAK,CAAC,MAAM,EAAE,mBAAmB,GAAG,YAAY;IA+BhD,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,UAAU;CAInB"}
+{"version":3,"file":"ActionDetector.d.ts","sourceRoot":"","sources":["../../../src/camera/ActionDetector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAwBrD,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,WAAW,CAAuB;IAE1C,KAAK,CAAC,MAAM,EAAE,mBAAmB,GAAG,YAAY;IA+BhD,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,UAAU;CAInB"}

package/dist/esm/camera/ActionDetector.js

@@ -8,10 +8,12 @@
  * commanding specific actions in order. This mirrors a passive liveness scan
  * rather than a step-by-step obstacle course.
  *
- * Pass criteria: at least one genuine blink OR a natural head-yaw excursion
- * detected at any point during the window — whichever happens first, since a
- * real person glancing around naturally will trigger one or both without
- * being told to.
+ * Pass criteria: BOTH a genuine blink AND a natural head-yaw excursion must
+ * be detected during the window, in either order — one signal alone is too
+ * easy for a held-up photo or a short video replay to trigger by accident
+ * (e.g. incidental camera/device motion registering as "head-yaw" with no
+ * live person present). Requiring both raises the bar without going back to
+ * commanded, sequential actions.
  */
 const BLINK_THRESHOLD = 0.25;
 const BLINK_HOLD_FRAMES = 2;
@@ -56,7 +58,7 @@ export class ActionDetector {
             faceDetected,
             blinkDetected: this.blinkDetected,
             motionDetected: this.motionDetected,
-            livenessConfirmed: this.blinkDetected || this.motionDetected,
+            livenessConfirmed: this.blinkDetected && this.motionDetected,
         };
     }
     getHeadYaw(matrix) {

package/dist/esm/camera/ActionDetector.js.map

@@ -1 +1 @@
-{"version":3,"file":"ActionDetector.js","sourceRoot":"","sources":["../../../src/camera/ActionDetector.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,eAAe,GAAG,IAAI,CAAC;AAC7B,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAC5B,MAAM,wBAAwB,GAAG,CAAC,CAAC,CAAC,oDAAoD;AASxF,MAAM,OAAO,cAAc;IAA3B;QACU,mBAAc,GAAG,CAAC,CAAC;QACnB,kBAAa,GAAG,KAAK,CAAC;QACtB,mBAAc,GAAG,KAAK,CAAC;QACvB,gBAAW,GAAkB,IAAI,CAAC;IA8C5C,CAAC;IA5CC,KAAK,CAAC,MAA2B;QAC/B,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;QAED,MAAM,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC;QAC9B,MAAM,SAAS,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAEvF,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,IAAI,SAAS,IAAI,eAAe,EAAE,CAAC;gBACjC,IAAI,CAAC,cAAc,EAAE,CAAC;gBACtB,IAAI,IAAI,CAAC,cAAc,IAAI,iBAAiB,EAAE,CAAC;oBAC7C,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;gBAC5B,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;YACpD,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;gBAC9B,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC;YACzB,CAAC;iBAAM,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,wBAAwB,EAAE,CAAC;gBACxE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;YAC7B,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAEO,aAAa,CAAC,YAAqB;QACzC,OAAO;YACL,YAAY;YACZ,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,iBAAiB,EAAE,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,cAAc;SAC7D,CAAC;IACJ,CAAC;IAEO,UAAU,CAAC,MAAuB;QACxC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,EAAE;YAAE,OAAO,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7D,CAAC;CACF"}
+{"version":3,"file":"ActionDetector.js","sourceRoot":"","sources":["../../../src/camera/ActionDetector.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,eAAe,GAAG,IAAI,CAAC;AAC7B,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAC5B,MAAM,wBAAwB,GAAG,CAAC,CAAC,CAAC,oDAAoD;AASxF,MAAM,OAAO,cAAc;IAA3B;QACU,mBAAc,GAAG,CAAC,CAAC;QACnB,kBAAa,GAAG,KAAK,CAAC;QACtB,mBAAc,GAAG,KAAK,CAAC;QACvB,gBAAW,GAAkB,IAAI,CAAC;IA8C5C,CAAC;IA5CC,KAAK,CAAC,MAA2B;QAC/B,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;QAED,MAAM,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC;QAC9B,MAAM,SAAS,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAEvF,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,IAAI,SAAS,IAAI,eAAe,EAAE,CAAC;gBACjC,IAAI,CAAC,cAAc,EAAE,CAAC;gBACtB,IAAI,IAAI,CAAC,cAAc,IAAI,iBAAiB,EAAE,CAAC;oBAC7C,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;gBAC5B,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;YACpD,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;gBAC9B,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC;YACzB,CAAC;iBAAM,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,wBAAwB,EAAE,CAAC;gBACxE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;YAC7B,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAEO,aAAa,CAAC,YAAqB;QACzC,OAAO;YACL,YAAY;YACZ,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,iBAAiB,EAAE,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,cAAc;SAC7D,CAAC;IACJ,CAAC;IAEO,UAAU,CAAC,MAAuB;QACxC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,EAAE;YAAE,OAAO,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7D,CAAC;CACF"}

package/dist/esm/client/Smartcomply.d.ts

@@ -21,7 +21,7 @@ export declare class SmartComply {
      * CDN tag they installed with (e.g. @1, which floats to the latest
      * matching release) actually resolved to the version they expect.
      */
-    static readonly VERSION = "1.0.80";
+    static readonly VERSION = "1.0.82";
     private http;
     private clientId;
     private _sessionToken;

package/dist/esm/client/Smartcomply.js

@@ -81,5 +81,5 @@ export class SmartComply {
  * CDN tag they installed with (e.g. @1, which floats to the latest
  * matching release) actually resolved to the version they expect.
  */
-SmartComply.VERSION = "1.0.80";
+SmartComply.VERSION = "1.0.82";
 //# sourceMappingURL=Smartcomply.js.map

package/dist/esm/flow/DocumentCapture.d.ts

@@ -27,6 +27,9 @@ export declare class DocumentCapture {
     private backBlob;
     private currentSide;
     private requiresBackOverride;
+    private framingTimer;
+    private framingStableCount;
+    private framingAutoTriggered;
     /**
      * Mount the document capture UI and return a promise that resolves
      * with the captured document image(s).
@@ -58,15 +61,49 @@ export declare class DocumentCapture {
      */
     private _watchOrientation;
     private _unwatchOrientation;
+    /**
+     * Auto-capture-on-stability — the same pattern the liveness module already
+     * uses for face-lock (see liveness.ts's checkFace), applied to documents:
+     * poll the raw video frame on an interval, score it against the guide box
+     * with assessFraming() (see utils/ImageQuality.ts), and fire the shutter
+     * automatically once several consecutive samples score as "framed". This
+     * is industry-standard for document capture (Persona/Onfido/Jumio-style
+     * SDKs all auto-capture rather than trust a manual tap against a static
+     * guide overlay) — the guide box alone never blocked a badly cropped tap.
+     *
+     * The manual capture button still works throughout and always wins
+     * (framingAutoTriggered guards against a race between the two).
+     */
+    private _startFramingLoop;
+    private _stopFramingLoop;
     private openCamera;
     private captureFrame;
     private showPreview;
     /**
-     * Runs the shared client-side quality heuristic (blur/glare/contrast/
-     * brightness — see utils/ImageQuality.ts) against the just-captured photo
-     * and, if it scores poorly, shows a plain-language nudge on the preview
-     * screen. Fails silently on decode error — this is an advisory extra, not
-     * a required step, so a browser that can't run it must not block capture.
+     * Runs the shared client-side quality heuristics — blur/glare/contrast/
+     * brightness (assessQuality) and document framing/completeness
+     * (assessFraming) — against the just-captured or just-uploaded photo, and
+     * shows a plain-language nudge on the preview screen if either scores
+     * poorly. This is the one chokepoint both the camera and manual-upload
+     * paths funnel through (see showPreview), so it's the only place that
+     * reliably catches a badly cropped document regardless of how the photo
+     * arrived — the camera's own auto-capture framing loop only guards live
+     * capture, and does nothing for an uploaded file or a manual shutter tap
+     * fired before the loop ever samples.
+     *
+     * Framing here checks the WHOLE image (guideBoxPct = full frame), not a
+     * guide-box region — there's no guide overlay for an arbitrary uploaded
+     * photo, so "does the document fill most of the frame" is the correct
+     * question, matching the same border-edge + interior-variance heuristic
+     * the camera loop already uses.
+     *
+     * A framing failure disables useBtn — unlike the blur/glare nudge, this
+     * one blocks: a cropped ID reads as a confident, wrong identity downstream
+     * (partial OCR fields, a registry check against a truncated ID number)
+     * with no further chance to catch it, so the user must retake/re-upload
+     * rather than being trusted to notice an advisory nudge and act on it
+     * voluntarily. Fails open on decode error — this heuristic not running at
+     * all must not lock the user out of a photo it never actually scored.
      */
     private _checkPhotoQuality;
     /** Decodes to a canvas, optionally downscaled to maxDim on the long edge (never upscales). */

package/dist/esm/flow/DocumentCapture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DocumentCapture.d.ts","sourceRoot":"","sources":["../../../src/flow/DocumentCapture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAgB,MAAM,SAAS,CAAC;AACpD,OAAO,EAAuC,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAQ3F;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,IAAI,CAAC;IACZ,IAAI,CAAC,EAAE,IAAI,CAAC;IAKZ,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,IAAI,CAA+B;IAC3C,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,aAAa,CAAsC;IAC3D,OAAO,CAAC,kBAAkB,CAA6B;IACvD,OAAO,CAAC,cAAc,CAA0D;IAChF,OAAO,CAAC,aAAa,CAAuC;IAC5D,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,oBAAoB,CAAuC;IAEnE;;;OAGG;IACH,OAAO,CACL,SAAS,EAAE,WAAW,EACtB,KAAK,EAAE,WAAW,EAClB,YAAY,EAAE,MAAM,EACpB,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,qBAAqB,CAAC;IAiCjC,OAAO,IAAI,IAAI;IAuBf,OAAO,CAAC,eAAe;IAOvB,8EAA8E;IAC9E,OAAO,CAAC,qBAAqB;IAI7B,0EAA0E;IAC1E,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,kBAAkB;IA4L1B,wDAAwD;IACxD,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,gBAAgB;IAyHxB;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IAQpB;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,mBAAmB;YAQb,UAAU;IAsExB,OAAO,CAAC,YAAY;IA4BpB,OAAO,CAAC,WAAW;IA4JnB;;;;;;OAMG;YACW,kBAAkB;IA4BhC,8FAA8F;IAC9F,OAAO,CAAC,aAAa;IAqBrB;;;;;;;;OAQG;IACH,OAAO,CAAC,YAAY;IA2BpB,OAAO,CAAC,qBAAqB;IAyC7B,OAAO,CAAC,wBAAwB;IAShC,OAAO,CAAC,YAAY;IAsBpB;;;;;;;;OAQG;YACW,sBAAsB;IASpC,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,SAAS;IAoCjB,OAAO,CAAC,YAAY;IA4BpB,OAAO,CAAC,aAAa;IA4ErB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAuC5B,OAAO,CAAC,gBAAgB;CAazB"}
+{"version":3,"file":"DocumentCapture.d.ts","sourceRoot":"","sources":["../../../src/flow/DocumentCapture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAgB,MAAM,SAAS,CAAC;AACpD,OAAO,EAAuC,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAQ3F;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,IAAI,CAAC;IACZ,IAAI,CAAC,EAAE,IAAI,CAAC;IAKZ,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,IAAI,CAA+B;IAC3C,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,aAAa,CAAsC;IAC3D,OAAO,CAAC,kBAAkB,CAA6B;IACvD,OAAO,CAAC,cAAc,CAA0D;IAChF,OAAO,CAAC,aAAa,CAAuC;IAC5D,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,oBAAoB,CAAuC;IACnE,OAAO,CAAC,YAAY,CAA8C;IAClE,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,oBAAoB,CAAS;IAErC;;;OAGG;IACH,OAAO,CACL,SAAS,EAAE,WAAW,EACtB,KAAK,EAAE,WAAW,EAClB,YAAY,EAAE,MAAM,EACpB,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,qBAAqB,CAAC;IAiCjC,OAAO,IAAI,IAAI;IAuBf,OAAO,CAAC,eAAe;IAOvB,8EAA8E;IAC9E,OAAO,CAAC,qBAAqB;IAI7B,0EAA0E;IAC1E,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,kBAAkB;IA4L1B,wDAAwD;IACxD,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,gBAAgB;IA0IxB;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IAQpB;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,mBAAmB;IAQ3B;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,iBAAiB;IA2FzB,OAAO,CAAC,gBAAgB;YAOV,UAAU;IAsExB,OAAO,CAAC,YAAY;IA4BpB,OAAO,CAAC,WAAW;IA+JnB;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;YACW,kBAAkB;IAsDhC,8FAA8F;IAC9F,OAAO,CAAC,aAAa;IAqBrB;;;;;;;;OAQG;IACH,OAAO,CAAC,YAAY;IA2BpB,OAAO,CAAC,qBAAqB;IAyC7B,OAAO,CAAC,wBAAwB;IAShC,OAAO,CAAC,YAAY;IAsBpB;;;;;;;;OAQG;YACW,sBAAsB;IASpC,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,SAAS;IAoCjB,OAAO,CAAC,YAAY;IA4BpB,OAAO,CAAC,aAAa;IA4ErB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAuC5B,OAAO,CAAC,gBAAgB;CAazB"}

package/dist/esm/flow/DocumentCapture.js

@@ -3,7 +3,7 @@ import { requiresBackSide, computeScaleRatio } from "../utils/documentRules";
 import { CameraManager, CameraAccessError } from "../camera/CameraManager";
 import { isRetryableCameraError } from "../camera/Permission";
 import { DOC_CAMERA_IDEAL_WIDTH, DOC_CAMERA_IDEAL_HEIGHT, MAX_DOCUMENT_BYTES } from "../utils/constants";
-import { assessQuality } from "../utils/ImageQuality";
+import { assessQuality, assessFraming } from "../utils/ImageQuality";
 import { icon } from "./icons";
 import { renderSpinner } from "./spinner";
 export class DocumentCapture {
@@ -20,6 +20,9 @@ export class DocumentCapture {
         this.backBlob = null;
         this.currentSide = 'front';
         this.requiresBackOverride = undefined;
+        this.framingTimer = null;
+        this.framingStableCount = 0;
+        this.framingAutoTriggered = false;
     }
     /**
      * Mount the document capture UI and return a promise that resolves
@@ -329,7 +332,7 @@ export class DocumentCapture {
         svg.appendChild(bracketGroup);
         guideWrap.appendChild(svg);
         wrapper.appendChild(guideWrap);
-        // Header — gradient scrim + document label
+        // Header — gradient scrim + document label + live framing status
         const header = document.createElement("div");
         header.style.cssText = `
       position:absolute;top:0;left:0;right:0;
@@ -337,6 +340,13 @@ export class DocumentCapture {
       padding:14px 16px 32px;text-align:center;
     `;
         header.innerHTML = `<div style="color:#fff;font-size:${TYPE.sm}px;font-weight:600;">Align your ${this.getDocumentLabel(documentType)} within the frame</div>`;
+        const framingStatus = document.createElement("div");
+        framingStatus.style.cssText = `
+      margin-top:6px;font-size:${TYPE.xs}px;font-weight:600;
+      color:rgba(255,255,255,0.7);transition:color 0.2s ease;
+    `;
+        framingStatus.textContent = "Fit the document inside the frame";
+        header.appendChild(framingStatus);
         wrapper.appendChild(header);
         // Footer — gradient scrim + tips
         const footer = document.createElement("div");
@@ -371,11 +381,17 @@ export class DocumentCapture {
             inner.style.transform = "translate(-50%,-50%) scale(1)";
         });
         captureBtn.addEventListener("click", () => {
+            this.framingAutoTriggered = true; // manual tap always wins, skip any pending auto-trigger
             this.captureFrame(container, theme, documentType);
         });
         container.appendChild(captureBtn);
-        // Open camera
-        this.openCamera();
+        // Open camera, then start the auto-capture framing loop once the stream
+        // has real dimensions to sample against.
+        this.openCamera().then(() => {
+            if (this.videoEl) {
+                this.videoEl.addEventListener("loadedmetadata", () => this._startFramingLoop(container, theme, documentType, framingStatus), { once: true });
+            }
+        });
     }
     /**
      * Matches the video box's aspect-ratio CSS to the stream's actual
@@ -412,6 +428,103 @@ export class DocumentCapture {
             this.orientationHandler = null;
         }
     }
+    /**
+     * Auto-capture-on-stability — the same pattern the liveness module already
+     * uses for face-lock (see liveness.ts's checkFace), applied to documents:
+     * poll the raw video frame on an interval, score it against the guide box
+     * with assessFraming() (see utils/ImageQuality.ts), and fire the shutter
+     * automatically once several consecutive samples score as "framed". This
+     * is industry-standard for document capture (Persona/Onfido/Jumio-style
+     * SDKs all auto-capture rather than trust a manual tap against a static
+     * guide overlay) — the guide box alone never blocked a badly cropped tap.
+     *
+     * The manual capture button still works throughout and always wins
+     * (framingAutoTriggered guards against a race between the two).
+     */
+    _startFramingLoop(container, theme, documentType, statusEl) {
+        if (!this.videoEl)
+            return;
+        this.framingStableCount = 0;
+        this.framingAutoTriggered = false;
+        const STABLE_REQUIRED = 3; // consecutive good samples before firing
+        const SAMPLE_INTERVAL_MS = 350; // cheap enough to run this often; not every animation frame
+        const MAX_WAIT_MS = 12000; // give up auto-capture, leave the manual button as the only path
+        const startTime = performance.now();
+        // Guide box in fractional coordinates, matching the on-screen CSS guide
+        // (width:84%, aspect-ratio:16/10, centered) — computed directly against
+        // the video's own pixel dimensions so no CSS/object-fit mapping is needed.
+        const boxWidthPct = 0.84;
+        const boxAspect = 16 / 10;
+        const tick = () => {
+            if (!this.videoEl || this.framingAutoTriggered)
+                return;
+            if (performance.now() - startTime >= MAX_WAIT_MS) {
+                statusEl.textContent = "Fit the document inside the frame";
+                return; // stop auto-detecting; manual capture button remains available
+            }
+            const w = this.videoEl.videoWidth;
+            const h = this.videoEl.videoHeight;
+            if (!w || !h || this.videoEl.readyState < 2) {
+                this.framingTimer = setTimeout(tick, SAMPLE_INTERVAL_MS);
+                return;
+            }
+            try {
+                const boxWidthPx = w * boxWidthPct;
+                const boxHeightPx = boxWidthPx / boxAspect;
+                const boxXPct = (1 - boxWidthPct) / 2;
+                const boxHeightPct = boxHeightPx / h;
+                const boxYPct = (1 - boxHeightPct) / 2;
+                const canvas = document.createElement("canvas");
+                // Downscaled sampling copy only — matches _checkPhotoQuality's own
+                // reasoning for why this must not run against the full-resolution
+                // frame on every tick.
+                const scale = Math.min(1, 480 / w);
+                canvas.width = Math.round(w * scale);
+                canvas.height = Math.round(h * scale);
+                const ctx = canvas.getContext("2d", { willReadFrequently: true });
+                if (!ctx) {
+                    this.framingTimer = setTimeout(tick, SAMPLE_INTERVAL_MS);
+                    return;
+                }
+                ctx.drawImage(this.videoEl, 0, 0, canvas.width, canvas.height);
+                const pixels = ctx.getImageData(0, 0, canvas.width, canvas.height);
+                const result = assessFraming(pixels, {
+                    x: boxXPct, y: boxYPct, width: boxWidthPct, height: boxHeightPct,
+                });
+                if (result.isFramed) {
+                    this.framingStableCount++;
+                    statusEl.style.color = theme.primary;
+                    statusEl.textContent = this.framingStableCount >= STABLE_REQUIRED
+                        ? "Capturing…"
+                        : "Hold steady…";
+                }
+                else {
+                    this.framingStableCount = 0;
+                    statusEl.style.color = "rgba(255,255,255,0.7)";
+                    statusEl.textContent = result.interiorVariance < 0.25
+                        ? "Move closer — fill the frame with your document"
+                        : "Align all 4 corners within the guide";
+                }
+                if (this.framingStableCount >= STABLE_REQUIRED) {
+                    this.framingAutoTriggered = true;
+                    this.captureFrame(container, theme, documentType);
+                    return;
+                }
+            }
+            catch {
+                // Advisory/auto-capture only — a scoring failure just falls back to
+                // the manual capture button, never blocks the flow.
+            }
+            this.framingTimer = setTimeout(tick, SAMPLE_INTERVAL_MS);
+        };
+        this.framingTimer = setTimeout(tick, SAMPLE_INTERVAL_MS);
+    }
+    _stopFramingLoop() {
+        if (this.framingTimer !== null) {
+            clearTimeout(this.framingTimer);
+            this.framingTimer = null;
+        }
+    }
     async openCamera() {
         // Check browser compatibility
         if (!navigator.mediaDevices || !navigator.mediaDevices.getUserMedia) {
@@ -573,7 +686,7 @@ export class DocumentCapture {
                 URL.revokeObjectURL(currentUrl);
                 currentUrl = URL.createObjectURL(rotated);
                 img.src = currentUrl;
-                this._checkPhotoQuality(currentBlob, qualityNotice, theme);
+                this._checkPhotoQuality(currentBlob, qualityNotice, theme, useBtn);
             }
             catch {
                 // Leave the current photo untouched — rotation is a convenience,
@@ -595,12 +708,14 @@ export class DocumentCapture {
         sublabel.style.cssText = `color:${theme.textMuted};font-size:${TYPE.xs}px;text-align:center;line-height:1.6;`;
         sublabel.textContent = "All text must be readable and all four corners must be visible. Sideways or upside-down? Use Rotate on the photo above.";
         this.root.appendChild(sublabel);
-        // Advisory-only quality nudge — catches an obviously blurry/dark/glare-
-        // heavy photo right here instead of only finding out several seconds
-        // later. Never blocks "Use Photo": this is a heuristic, not a hard
-        // rule, so a photo that's actually fine but scores oddly must still be
-        // usable — it just nudges the user toward retaking with a plain-
-        // language reason instead of silently letting a bad photo through.
+        // Quality/framing notice. Blur/glare/contrast issues (assessQuality) stay
+        // advisory-only — a heuristic that's off shouldn't block a photo that's
+        // actually fine. A framing failure (document not fully in frame —
+        // assessFraming) DOES block "Use Photo": a cropped ID reads as a
+        // confident, wrong identity downstream (partial OCR fields, a registry
+        // check against a truncated ID number) with no further chance to catch
+        // it, so this is the one signal worth hard-blocking on rather than
+        // trusting the user to notice and retake voluntarily.
         const qualityNotice = document.createElement("div");
         qualityNotice.style.cssText = `
       display:none;width:100%;padding:10px 14px;border-radius:${RADIUS.md}px;
@@ -609,7 +724,6 @@ export class DocumentCapture {
     `;
         qualityNotice.setAttribute("role", "status");
         this.root.appendChild(qualityNotice);
-        this._checkPhotoQuality(currentBlob, qualityNotice, theme);
         // Buttons
         const btnRow = document.createElement("div");
         btnRow.style.cssText = "display:flex;gap:12px;width:100%;";
@@ -635,15 +749,35 @@ export class DocumentCapture {
         btnRow.appendChild(retakeBtn);
         btnRow.appendChild(useBtn);
         this.root.appendChild(btnRow);
+        this._checkPhotoQuality(currentBlob, qualityNotice, theme, useBtn);
     }
     /**
-     * Runs the shared client-side quality heuristic (blur/glare/contrast/
-     * brightness — see utils/ImageQuality.ts) against the just-captured photo
-     * and, if it scores poorly, shows a plain-language nudge on the preview
-     * screen. Fails silently on decode error — this is an advisory extra, not
-     * a required step, so a browser that can't run it must not block capture.
+     * Runs the shared client-side quality heuristics — blur/glare/contrast/
+     * brightness (assessQuality) and document framing/completeness
+     * (assessFraming) — against the just-captured or just-uploaded photo, and
+     * shows a plain-language nudge on the preview screen if either scores
+     * poorly. This is the one chokepoint both the camera and manual-upload
+     * paths funnel through (see showPreview), so it's the only place that
+     * reliably catches a badly cropped document regardless of how the photo
+     * arrived — the camera's own auto-capture framing loop only guards live
+     * capture, and does nothing for an uploaded file or a manual shutter tap
+     * fired before the loop ever samples.
+     *
+     * Framing here checks the WHOLE image (guideBoxPct = full frame), not a
+     * guide-box region — there's no guide overlay for an arbitrary uploaded
+     * photo, so "does the document fill most of the frame" is the correct
+     * question, matching the same border-edge + interior-variance heuristic
+     * the camera loop already uses.
+     *
+     * A framing failure disables useBtn — unlike the blur/glare nudge, this
+     * one blocks: a cropped ID reads as a confident, wrong identity downstream
+     * (partial OCR fields, a registry check against a truncated ID number)
+     * with no further chance to catch it, so the user must retake/re-upload
+     * rather than being trusted to notice an advisory nudge and act on it
+     * voluntarily. Fails open on decode error — this heuristic not running at
+     * all must not lock the user out of a photo it never actually scored.
      */
-    async _checkPhotoQuality(imageData, noticeEl, theme) {
+    async _checkPhotoQuality(imageData, noticeEl, theme, useBtn) {
         try {
             // Document photos are captured at up to DOC_CAMERA_IDEAL_WIDTH/HEIGHT
             // (2000x1500) — scoring every pixel across four full-image passes in
@@ -656,6 +790,28 @@ export class DocumentCapture {
             if (!ctx)
                 return;
             const pixels = ctx.getImageData(0, 0, canvas.width, canvas.height);
+            const framing = assessFraming(pixels, { x: 0, y: 0, width: 1, height: 1 });
+            if (!framing.isFramed) {
+                if (noticeEl.isConnected) {
+                    noticeEl.style.display = "block";
+                    noticeEl.textContent = framing.interiorVariance < 0.25
+                        ? "We couldn't detect a document in this photo — make sure the ID is clearly visible and try again."
+                        : "Part of the document looks cut off — make sure all four corners are visible and try again.";
+                }
+                if (useBtn.isConnected) {
+                    useBtn.disabled = true;
+                    useBtn.style.opacity = "0.5";
+                    useBtn.style.cursor = "not-allowed";
+                }
+                return; // framing issue is the more actionable/specific one — don't also show the quality nudge
+            }
+            // Framing passed — make sure a previous failed attempt (before Retake/
+            // Rotate) doesn't leave the button stuck disabled.
+            if (useBtn.isConnected) {
+                useBtn.disabled = false;
+                useBtn.style.opacity = "1";
+                useBtn.style.cursor = "pointer";
+            }
             const result = assessQuality(pixels);
             if (noticeEl.isConnected && !result.isValid) {
                 noticeEl.style.display = "block";
@@ -665,7 +821,7 @@ export class DocumentCapture {
             }
         }
         catch {
-            // Advisory only — no notice shown if scoring fails for any reason.
+            // Fails open — no notice, button stays enabled, if scoring fails for any reason.
         }
     }
     /** Decodes to a canvas, optionally downscaled to maxDim on the long edge (never upscales). */
@@ -802,6 +958,7 @@ export class DocumentCapture {
             input.click();
     }
     stopCamera() {
+        this._stopFramingLoop();
         this._unwatchOrientation();
         this.cameraManager.stop();
         if (this.videoEl) {