smartcomply-web-sdk 1.0.58 → 1.0.59

package/dist/camera/CameraManager.d.ts

@@ -1,5 +1,11 @@
 export declare class CameraManager {
     private stream;
+    private onInterrupted;
+    private trackEndedHandlers;
+    /**
+     * Opens the camera via requestCameraAccess(), which maps browser errors
+     * (denied, no device, in-use-by-another-app) to a clean message thrown here.
+     */
     open(constraints?: MediaStreamConstraints): Promise<MediaStream>;
     getStream(): MediaStream | null;
     /**
@@ -9,6 +15,16 @@ export declare class CameraManager {
      * stop() becomes a no-op for it, leaking the camera.
      */
     setStream(stream: MediaStream): void;
+    /**
+     * Register a callback fired the moment any track in the current stream
+     * ends unexpectedly (OS revokes camera permission mid-session, another
+     * app steals the camera, device sleeps and the driver drops the feed).
+     * Without this, a dead stream is silently invisible — the video element
+     * just freezes on its last frame and face detection quietly fails
+     * forever with no indication anything went wrong.
+     */
+    onStreamInterrupted(callback: () => void): void;
+    private _watchTracks;
     stop(): void;
 }
 //# sourceMappingURL=CameraManager.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"CameraManager.d.ts","sourceRoot":"","sources":["../../src/camera/CameraManager.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAA4B;IAEpC,IAAI,CAAC,WAAW,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,WAAW,CAAC;IAiBtE,SAAS,IAAI,WAAW,GAAG,IAAI;IAI/B;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAIpC,IAAI,IAAI,IAAI;CAMb"}
+{"version":3,"file":"CameraManager.d.ts","sourceRoot":"","sources":["../../src/camera/CameraManager.ts"],"names":[],"mappings":"AAEA,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,kBAAkB,CAAyB;IAEnD;;;OAGG;IACG,IAAI,CAAC,WAAW,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,WAAW,CAAC;IAqBtE,SAAS,IAAI,WAAW,GAAG,IAAI;IAI/B;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAKpC;;;;;;;OAOG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAI/C,OAAO,CAAC,YAAY;IAiBpB,IAAI,IAAI,IAAI;CAQb"}

package/dist/camera/CameraManager.js

@@ -1,10 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CameraManager = void 0;
+const Permission_1 = require("./Permission");
 class CameraManager {
     constructor() {
         this.stream = null;
+        this.onInterrupted = null;
+        this.trackEndedHandlers = [];
     }
+    /**
+     * Opens the camera via requestCameraAccess(), which maps browser errors
+     * (denied, no device, in-use-by-another-app) to a clean message thrown here.
+     */
     async open(constraints) {
         const defaults = {
             video: {
@@ -14,7 +21,12 @@ class CameraManager {
             },
             audio: false,
         };
-        this.stream = await navigator.mediaDevices.getUserMedia(constraints || defaults);
+        const { stream, permission } = await (0, Permission_1.requestCameraAccess)(constraints || defaults);
+        if (!stream) {
+            throw new Error(permission.reason || "Unable to access the camera.");
+        }
+        this.stream = stream;
+        this._watchTracks();
         return this.stream;
     }
     getStream() {
@@ -28,12 +40,43 @@ class CameraManager {
      */
     setStream(stream) {
         this.stream = stream;
+        this._watchTracks();
+    }
+    /**
+     * Register a callback fired the moment any track in the current stream
+     * ends unexpectedly (OS revokes camera permission mid-session, another
+     * app steals the camera, device sleeps and the driver drops the feed).
+     * Without this, a dead stream is silently invisible — the video element
+     * just freezes on its last frame and face detection quietly fails
+     * forever with no indication anything went wrong.
+     */
+    onStreamInterrupted(callback) {
+        this.onInterrupted = callback;
+    }
+    _watchTracks() {
+        this.trackEndedHandlers = [];
+        if (!this.stream)
+            return;
+        this.stream.getTracks().forEach((track) => {
+            const handler = () => {
+                // A track we intentionally stopped (via stop()) also fires "ended" —
+                // only treat this as an interruption if we still think we have a
+                // live stream (stop() nulls this.stream before that would happen).
+                if (this.stream) {
+                    this.onInterrupted?.();
+                }
+            };
+            track.addEventListener("ended", handler);
+            this.trackEndedHandlers.push(() => track.removeEventListener("ended", handler));
+        });
     }
     stop() {
         if (this.stream) {
             this.stream.getTracks().forEach((track) => track.stop());
             this.stream = null;
         }
+        this.trackEndedHandlers.forEach((remove) => remove());
+        this.trackEndedHandlers = [];
     }
 }
 exports.CameraManager = CameraManager;

package/dist/camera/CameraManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"CameraManager.js","sourceRoot":"","sources":["../../src/camera/CameraManager.ts"],"names":[],"mappings":";;;AAAA,MAAa,aAAa;IAA1B;QACU,WAAM,GAAuB,IAAI,CAAC;IAuC5C,CAAC;IArCC,KAAK,CAAC,IAAI,CAAC,WAAoC;QAC7C,MAAM,QAAQ,GAA2B;YACvC,KAAK,EAAE;gBACL,UAAU,EAAE,MAAM;gBAClB,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;gBACtB,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE;aACvB;YACD,KAAK,EAAE,KAAK;SACb,CAAC;QAEF,IAAI,CAAC,MAAM,GAAG,MAAM,SAAS,CAAC,YAAY,CAAC,YAAY,CACrD,WAAW,IAAI,QAAQ,CACxB,CAAC;QAEF,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,MAAmB;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACzD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACrB,CAAC;IACH,CAAC;CACF;AAxCD,sCAwCC"}
+{"version":3,"file":"CameraManager.js","sourceRoot":"","sources":["../../src/camera/CameraManager.ts"],"names":[],"mappings":";;;AAAA,6CAAmD;AAEnD,MAAa,aAAa;IAA1B;QACU,WAAM,GAAuB,IAAI,CAAC;QAClC,kBAAa,GAAwB,IAAI,CAAC;QAC1C,uBAAkB,GAAsB,EAAE,CAAC;IA+ErD,CAAC;IA7EC;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,WAAoC;QAC7C,MAAM,QAAQ,GAA2B;YACvC,KAAK,EAAE;gBACL,UAAU,EAAE,MAAM;gBAClB,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;gBACtB,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE;aACvB;YACD,KAAK,EAAE,KAAK;SACb,CAAC;QAEF,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,IAAA,gCAAmB,EAAC,WAAW,IAAI,QAAQ,CAAC,CAAC;QAClF,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,IAAI,8BAA8B,CAAC,CAAC;QACvE,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,YAAY,EAAE,CAAC;QAEpB,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,MAAmB;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,YAAY,EAAE,CAAC;IACtB,CAAC;IAED;;;;;;;OAOG;IACH,mBAAmB,CAAC,QAAoB;QACtC,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAC;IAChC,CAAC;IAEO,YAAY;QAClB,IAAI,CAAC,kBAAkB,GAAG,EAAE,CAAC;QAC7B,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QACzB,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YACxC,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,qEAAqE;gBACrE,iEAAiE;gBACjE,mEAAmE;gBACnE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;oBAChB,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;gBACzB,CAAC;YACH,CAAC,CAAC;YACF,KAAK,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACzC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QAClF,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACzD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACrB,CAAC;QACD,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;QACtD,IAAI,CAAC,kBAAkB,GAAG,EAAE,CAAC;IAC/B,CAAC;CACF;AAlFD,sCAkFC"}

package/dist/camera/VideoRecorder.d.ts

@@ -2,6 +2,9 @@ export declare class VideoRecorder {
     private recorder;
     private chunks;
     private startedAt;
+    private onRecordingError;
+    /** Fires immediately on a mid-recording error, unlike stop()'s onerror which only fires when stop() is later called. */
+    onError(callback: () => void): void;
     start(stream: MediaStream): void;
     stop(): Promise<{
         blob: Blob;

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

@@ -1 +1 @@
-{"version":3,"file":"VideoRecorder.d.ts","sourceRoot":"","sources":["../../src/camera/VideoRecorder.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,SAAS,CAAa;IAE9B,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAsBhC,IAAI,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC;IA0BxD,WAAW,IAAI,OAAO;CAGvB"}
+{"version":3,"file":"VideoRecorder.d.ts","sourceRoot":"","sources":["../../src/camera/VideoRecorder.ts"],"names":[],"mappings":"AAEA,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,gBAAgB,CAA6B;IAErD,wHAAwH;IACxH,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAInC,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IA0BhC,IAAI,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC;IA0BxD,WAAW,IAAI,OAAO;CAGvB"}

package/dist/camera/VideoRecorder.js

@@ -1,11 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VideoRecorder = void 0;
+const constants_1 = require("../utils/constants");
 class VideoRecorder {
     constructor() {
         this.recorder = null;
         this.chunks = [];
         this.startedAt = 0;
+        this.onRecordingError = null;
+    }
+    /** Fires immediately on a mid-recording error, unlike stop()'s onerror which only fires when stop() is later called. */
+    onError(callback) {
+        this.onRecordingError = callback;
     }
     start(stream) {
         this.chunks = [];
@@ -14,13 +20,16 @@ class VideoRecorder {
             : "video/webm";
         this.recorder = new MediaRecorder(stream, {
             mimeType,
-            videoBitsPerSecond: 800000, // raised from 250k — higher bitrate = sharper frames for SmartComply face extractor
+            videoBitsPerSecond: constants_1.RECORDING_BITS_PER_SECOND,
         });
         this.recorder.ondataavailable = (e) => {
             if (e.data.size > 0) {
                 this.chunks.push(e.data);
             }
         };
+        this.recorder.addEventListener("error", () => {
+            this.onRecordingError?.();
+        });
         this.startedAt = Date.now();
         this.recorder.start();
     }

package/dist/camera/VideoRecorder.js.map

@@ -1 +1 @@
-{"version":3,"file":"VideoRecorder.js","sourceRoot":"","sources":["../../src/camera/VideoRecorder.ts"],"names":[],"mappings":";;;AAAA,MAAa,aAAa;IAA1B;QACU,aAAQ,GAAyB,IAAI,CAAC;QACtC,WAAM,GAAW,EAAE,CAAC;QACpB,cAAS,GAAW,CAAC,CAAC;IAqDhC,CAAC;IAnDC,KAAK,CAAC,MAAmB;QACvB,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QAEjB,MAAM,QAAQ,GAAG,aAAa,CAAC,eAAe,CAAC,uBAAuB,CAAC;YACrE,CAAC,CAAC,uBAAuB;YACzB,CAAC,CAAC,YAAY,CAAC;QAEjB,IAAI,CAAC,QAAQ,GAAG,IAAI,aAAa,CAAC,MAAM,EAAE;YACxC,QAAQ;YACR,kBAAkB,EAAE,MAAO,EAAE,oFAAoF;SAClH,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,eAAe,GAAG,CAAC,CAAC,EAAE,EAAE;YACpC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBACpB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC,CAAC;QAEF,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED,IAAI;QACF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;gBACzD,MAAM,CAAC,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC,CAAC;gBAC5C,OAAO;YACT,CAAC;YAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAE7B,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,GAAG,EAAE;gBAC1B,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;gBAC3D,MAAM,eAAe,GAAG,UAAU,CAChC,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CACjD,CAAC;gBACF,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;gBACjB,OAAO,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;YACrC,CAAC,CAAC;YAEF,IAAI,CAAC,QAAQ,CAAC,OAAO,GAAG,GAAG,EAAE;gBAC3B,MAAM,CAAC,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC;YACxC,CAAC,CAAC;YAEF,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,EAAE,KAAK,KAAK,WAAW,CAAC;IAC9C,CAAC;CACF;AAxDD,sCAwDC"}
+{"version":3,"file":"VideoRecorder.js","sourceRoot":"","sources":["../../src/camera/VideoRecorder.ts"],"names":[],"mappings":";;;AAAA,kDAA+D;AAE/D,MAAa,aAAa;IAA1B;QACU,aAAQ,GAAyB,IAAI,CAAC;QACtC,WAAM,GAAW,EAAE,CAAC;QACpB,cAAS,GAAW,CAAC,CAAC;QACtB,qBAAgB,GAAwB,IAAI,CAAC;IA8DvD,CAAC;IA5DC,wHAAwH;IACxH,OAAO,CAAC,QAAoB;QAC1B,IAAI,CAAC,gBAAgB,GAAG,QAAQ,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,MAAmB;QACvB,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QAEjB,MAAM,QAAQ,GAAG,aAAa,CAAC,eAAe,CAAC,uBAAuB,CAAC;YACrE,CAAC,CAAC,uBAAuB;YACzB,CAAC,CAAC,YAAY,CAAC;QAEjB,IAAI,CAAC,QAAQ,GAAG,IAAI,aAAa,CAAC,MAAM,EAAE;YACxC,QAAQ;YACR,kBAAkB,EAAE,qCAAyB;SAC9C,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,eAAe,GAAG,CAAC,CAAC,EAAE,EAAE;YACpC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBACpB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;YAC3C,IAAI,CAAC,gBAAgB,EAAE,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED,IAAI;QACF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;gBACzD,MAAM,CAAC,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC,CAAC;gBAC5C,OAAO;YACT,CAAC;YAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAE7B,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,GAAG,EAAE;gBAC1B,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;gBAC3D,MAAM,eAAe,GAAG,UAAU,CAChC,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CACjD,CAAC;gBACF,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;gBACjB,OAAO,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;YACrC,CAAC,CAAC;YAEF,IAAI,CAAC,QAAQ,CAAC,OAAO,GAAG,GAAG,EAAE;gBAC3B,MAAM,CAAC,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC;YACxC,CAAC,CAAC;YAEF,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,EAAE,KAAK,KAAK,WAAW,CAAC;IAC9C,CAAC;CACF;AAlED,sCAkEC"}

package/dist/esm/camera/CameraManager.d.ts

@@ -1,5 +1,11 @@
 export declare class CameraManager {
     private stream;
+    private onInterrupted;
+    private trackEndedHandlers;
+    /**
+     * Opens the camera via requestCameraAccess(), which maps browser errors
+     * (denied, no device, in-use-by-another-app) to a clean message thrown here.
+     */
     open(constraints?: MediaStreamConstraints): Promise<MediaStream>;
     getStream(): MediaStream | null;
     /**
@@ -9,6 +15,16 @@ export declare class CameraManager {
      * stop() becomes a no-op for it, leaking the camera.
      */
     setStream(stream: MediaStream): void;
+    /**
+     * Register a callback fired the moment any track in the current stream
+     * ends unexpectedly (OS revokes camera permission mid-session, another
+     * app steals the camera, device sleeps and the driver drops the feed).
+     * Without this, a dead stream is silently invisible — the video element
+     * just freezes on its last frame and face detection quietly fails
+     * forever with no indication anything went wrong.
+     */
+    onStreamInterrupted(callback: () => void): void;
+    private _watchTracks;
     stop(): void;
 }
 //# sourceMappingURL=CameraManager.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"CameraManager.d.ts","sourceRoot":"","sources":["../../../src/camera/CameraManager.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAA4B;IAEpC,IAAI,CAAC,WAAW,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,WAAW,CAAC;IAiBtE,SAAS,IAAI,WAAW,GAAG,IAAI;IAI/B;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAIpC,IAAI,IAAI,IAAI;CAMb"}
+{"version":3,"file":"CameraManager.d.ts","sourceRoot":"","sources":["../../../src/camera/CameraManager.ts"],"names":[],"mappings":"AAEA,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,kBAAkB,CAAyB;IAEnD;;;OAGG;IACG,IAAI,CAAC,WAAW,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,WAAW,CAAC;IAqBtE,SAAS,IAAI,WAAW,GAAG,IAAI;IAI/B;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAKpC;;;;;;;OAOG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAI/C,OAAO,CAAC,YAAY;IAiBpB,IAAI,IAAI,IAAI;CAQb"}

package/dist/esm/camera/CameraManager.js

@@ -1,7 +1,14 @@
+import { requestCameraAccess } from "./Permission";
 export class CameraManager {
     constructor() {
         this.stream = null;
+        this.onInterrupted = null;
+        this.trackEndedHandlers = [];
     }
+    /**
+     * Opens the camera via requestCameraAccess(), which maps browser errors
+     * (denied, no device, in-use-by-another-app) to a clean message thrown here.
+     */
     async open(constraints) {
         const defaults = {
             video: {
@@ -11,7 +18,12 @@ export class CameraManager {
             },
             audio: false,
         };
-        this.stream = await navigator.mediaDevices.getUserMedia(constraints || defaults);
+        const { stream, permission } = await requestCameraAccess(constraints || defaults);
+        if (!stream) {
+            throw new Error(permission.reason || "Unable to access the camera.");
+        }
+        this.stream = stream;
+        this._watchTracks();
         return this.stream;
     }
     getStream() {
@@ -25,12 +37,43 @@ export class CameraManager {
      */
     setStream(stream) {
         this.stream = stream;
+        this._watchTracks();
+    }
+    /**
+     * Register a callback fired the moment any track in the current stream
+     * ends unexpectedly (OS revokes camera permission mid-session, another
+     * app steals the camera, device sleeps and the driver drops the feed).
+     * Without this, a dead stream is silently invisible — the video element
+     * just freezes on its last frame and face detection quietly fails
+     * forever with no indication anything went wrong.
+     */
+    onStreamInterrupted(callback) {
+        this.onInterrupted = callback;
+    }
+    _watchTracks() {
+        this.trackEndedHandlers = [];
+        if (!this.stream)
+            return;
+        this.stream.getTracks().forEach((track) => {
+            const handler = () => {
+                // A track we intentionally stopped (via stop()) also fires "ended" —
+                // only treat this as an interruption if we still think we have a
+                // live stream (stop() nulls this.stream before that would happen).
+                if (this.stream) {
+                    this.onInterrupted?.();
+                }
+            };
+            track.addEventListener("ended", handler);
+            this.trackEndedHandlers.push(() => track.removeEventListener("ended", handler));
+        });
     }
     stop() {
         if (this.stream) {
             this.stream.getTracks().forEach((track) => track.stop());
             this.stream = null;
         }
+        this.trackEndedHandlers.forEach((remove) => remove());
+        this.trackEndedHandlers = [];
     }
 }
 //# sourceMappingURL=CameraManager.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"CameraManager.js","sourceRoot":"","sources":["../../../src/camera/CameraManager.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,aAAa;IAA1B;QACU,WAAM,GAAuB,IAAI,CAAC;IAuC5C,CAAC;IArCC,KAAK,CAAC,IAAI,CAAC,WAAoC;QAC7C,MAAM,QAAQ,GAA2B;YACvC,KAAK,EAAE;gBACL,UAAU,EAAE,MAAM;gBAClB,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;gBACtB,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE;aACvB;YACD,KAAK,EAAE,KAAK;SACb,CAAC;QAEF,IAAI,CAAC,MAAM,GAAG,MAAM,SAAS,CAAC,YAAY,CAAC,YAAY,CACrD,WAAW,IAAI,QAAQ,CACxB,CAAC;QAEF,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,MAAmB;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACzD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACrB,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"CameraManager.js","sourceRoot":"","sources":["../../../src/camera/CameraManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,OAAO,aAAa;IAA1B;QACU,WAAM,GAAuB,IAAI,CAAC;QAClC,kBAAa,GAAwB,IAAI,CAAC;QAC1C,uBAAkB,GAAsB,EAAE,CAAC;IA+ErD,CAAC;IA7EC;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,WAAoC;QAC7C,MAAM,QAAQ,GAA2B;YACvC,KAAK,EAAE;gBACL,UAAU,EAAE,MAAM;gBAClB,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;gBACtB,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE;aACvB;YACD,KAAK,EAAE,KAAK;SACb,CAAC;QAEF,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,mBAAmB,CAAC,WAAW,IAAI,QAAQ,CAAC,CAAC;QAClF,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,IAAI,8BAA8B,CAAC,CAAC;QACvE,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,YAAY,EAAE,CAAC;QAEpB,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,MAAmB;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,YAAY,EAAE,CAAC;IACtB,CAAC;IAED;;;;;;;OAOG;IACH,mBAAmB,CAAC,QAAoB;QACtC,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAC;IAChC,CAAC;IAEO,YAAY;QAClB,IAAI,CAAC,kBAAkB,GAAG,EAAE,CAAC;QAC7B,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QACzB,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YACxC,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,qEAAqE;gBACrE,iEAAiE;gBACjE,mEAAmE;gBACnE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;oBAChB,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;gBACzB,CAAC;YACH,CAAC,CAAC;YACF,KAAK,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACzC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QAClF,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACzD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACrB,CAAC;QACD,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;QACtD,IAAI,CAAC,kBAAkB,GAAG,EAAE,CAAC;IAC/B,CAAC;CACF"}

package/dist/esm/camera/VideoRecorder.d.ts

@@ -2,6 +2,9 @@ export declare class VideoRecorder {
     private recorder;
     private chunks;
     private startedAt;
+    private onRecordingError;
+    /** Fires immediately on a mid-recording error, unlike stop()'s onerror which only fires when stop() is later called. */
+    onError(callback: () => void): void;
     start(stream: MediaStream): void;
     stop(): Promise<{
         blob: Blob;

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

@@ -1 +1 @@
-{"version":3,"file":"VideoRecorder.d.ts","sourceRoot":"","sources":["../../../src/camera/VideoRecorder.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,SAAS,CAAa;IAE9B,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAsBhC,IAAI,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC;IA0BxD,WAAW,IAAI,OAAO;CAGvB"}
+{"version":3,"file":"VideoRecorder.d.ts","sourceRoot":"","sources":["../../../src/camera/VideoRecorder.ts"],"names":[],"mappings":"AAEA,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,gBAAgB,CAA6B;IAErD,wHAAwH;IACxH,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAInC,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IA0BhC,IAAI,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC;IA0BxD,WAAW,IAAI,OAAO;CAGvB"}

package/dist/esm/camera/VideoRecorder.js

@@ -1,8 +1,14 @@
+import { RECORDING_BITS_PER_SECOND } from "../utils/constants";
 export class VideoRecorder {
     constructor() {
         this.recorder = null;
         this.chunks = [];
         this.startedAt = 0;
+        this.onRecordingError = null;
+    }
+    /** Fires immediately on a mid-recording error, unlike stop()'s onerror which only fires when stop() is later called. */
+    onError(callback) {
+        this.onRecordingError = callback;
     }
     start(stream) {
         this.chunks = [];
@@ -11,13 +17,16 @@ export class VideoRecorder {
             : "video/webm";
         this.recorder = new MediaRecorder(stream, {
             mimeType,
-            videoBitsPerSecond: 800000, // raised from 250k — higher bitrate = sharper frames for SmartComply face extractor
+            videoBitsPerSecond: RECORDING_BITS_PER_SECOND,
         });
         this.recorder.ondataavailable = (e) => {
             if (e.data.size > 0) {
                 this.chunks.push(e.data);
             }
         };
+        this.recorder.addEventListener("error", () => {
+            this.onRecordingError?.();
+        });
         this.startedAt = Date.now();
         this.recorder.start();
     }

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

@@ -1 +1 @@
-{"version":3,"file":"VideoRecorder.js","sourceRoot":"","sources":["../../../src/camera/VideoRecorder.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,aAAa;IAA1B;QACU,aAAQ,GAAyB,IAAI,CAAC;QACtC,WAAM,GAAW,EAAE,CAAC;QACpB,cAAS,GAAW,CAAC,CAAC;IAqDhC,CAAC;IAnDC,KAAK,CAAC,MAAmB;QACvB,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QAEjB,MAAM,QAAQ,GAAG,aAAa,CAAC,eAAe,CAAC,uBAAuB,CAAC;YACrE,CAAC,CAAC,uBAAuB;YACzB,CAAC,CAAC,YAAY,CAAC;QAEjB,IAAI,CAAC,QAAQ,GAAG,IAAI,aAAa,CAAC,MAAM,EAAE;YACxC,QAAQ;YACR,kBAAkB,EAAE,MAAO,EAAE,oFAAoF;SAClH,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,eAAe,GAAG,CAAC,CAAC,EAAE,EAAE;YACpC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBACpB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC,CAAC;QAEF,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED,IAAI;QACF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;gBACzD,MAAM,CAAC,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC,CAAC;gBAC5C,OAAO;YACT,CAAC;YAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAE7B,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,GAAG,EAAE;gBAC1B,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;gBAC3D,MAAM,eAAe,GAAG,UAAU,CAChC,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CACjD,CAAC;gBACF,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;gBACjB,OAAO,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;YACrC,CAAC,CAAC;YAEF,IAAI,CAAC,QAAQ,CAAC,OAAO,GAAG,GAAG,EAAE;gBAC3B,MAAM,CAAC,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC;YACxC,CAAC,CAAC;YAEF,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,EAAE,KAAK,KAAK,WAAW,CAAC;IAC9C,CAAC;CACF"}
+{"version":3,"file":"VideoRecorder.js","sourceRoot":"","sources":["../../../src/camera/VideoRecorder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,MAAM,OAAO,aAAa;IAA1B;QACU,aAAQ,GAAyB,IAAI,CAAC;QACtC,WAAM,GAAW,EAAE,CAAC;QACpB,cAAS,GAAW,CAAC,CAAC;QACtB,qBAAgB,GAAwB,IAAI,CAAC;IA8DvD,CAAC;IA5DC,wHAAwH;IACxH,OAAO,CAAC,QAAoB;QAC1B,IAAI,CAAC,gBAAgB,GAAG,QAAQ,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,MAAmB;QACvB,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QAEjB,MAAM,QAAQ,GAAG,aAAa,CAAC,eAAe,CAAC,uBAAuB,CAAC;YACrE,CAAC,CAAC,uBAAuB;YACzB,CAAC,CAAC,YAAY,CAAC;QAEjB,IAAI,CAAC,QAAQ,GAAG,IAAI,aAAa,CAAC,MAAM,EAAE;YACxC,QAAQ;YACR,kBAAkB,EAAE,yBAAyB;SAC9C,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,eAAe,GAAG,CAAC,CAAC,EAAE,EAAE;YACpC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBACpB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;YAC3C,IAAI,CAAC,gBAAgB,EAAE,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED,IAAI;QACF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;gBACzD,MAAM,CAAC,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC,CAAC;gBAC5C,OAAO;YACT,CAAC;YAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAE7B,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,GAAG,EAAE;gBAC1B,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;gBAC3D,MAAM,eAAe,GAAG,UAAU,CAChC,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CACjD,CAAC;gBACF,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;gBACjB,OAAO,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;YACrC,CAAC,CAAC;YAEF,IAAI,CAAC,QAAQ,CAAC,OAAO,GAAG,GAAG,EAAE;gBAC3B,MAAM,CAAC,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC;YACxC,CAAC,CAAC;YAEF,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,EAAE,KAAK,KAAK,WAAW,CAAC;IAC9C,CAAC;CACF"}

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

@@ -44,6 +44,7 @@ export declare class SmartComplyFlow {
     private livenessEntryId;
     private isDestroyed;
     private headerBackBtn;
+    private _keydownHandler;
     private _confirmRetries;
     private _livenessFailures;
     private static readonly MAX_RETRIES;
@@ -82,6 +83,7 @@ export declare class SmartComplyFlow {
     close(): void;
     private mount;
     private initialize;
+    private _showExpiryWarningWhenSafe;
     private showStep;
     private renderStep;
     private renderLoading;
@@ -108,7 +110,6 @@ export declare class SmartComplyFlow {
     private processDocumentBlob;
     private handleDocumentProcessingError;
     private renderLiveness;
-    private renderResult;
     private showErrorStep;
     private createHeader;
     private createFooter;
@@ -116,6 +117,8 @@ export declare class SmartComplyFlow {
     private createOptionCard;
     private createPrimaryButton;
     private createSecondaryButton;
+    /** Click handler that fires once and disables the button, preventing a double-tap double-dispatch. */
+    private _onceClick;
     private isDocumentFlow;
     private updateProgress;
     private applyTheme;

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

@@ -1 +1 @@
-{"version":3,"file":"SmartComplyFlow.d.ts","sourceRoot":"","sources":["../../../src/flow/SmartComplyFlow.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SmartComplyFlow.d.ts","sourceRoot":"","sources":["../../../src/flow/SmartComplyFlow.ts"],"names":[],"mappings":"AACA,OAAO,EAA6B,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAIxF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAO/C,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC;IAC1C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,kBAAkB,CAAC,EAAE,sBAAsB,CAAC;CAC7C;AAoSD,qBAAa,eAAe;IAC1B,OAAO,CAAC,GAAG,CAAc;IACzB,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,KAAK,CAAoC;IAGjD,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,UAAU,CAA+B;IAGjD,OAAO,CAAC,SAAS,CAA8B;IAC/C,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,eAAe,CAAc;IACrC,OAAO,CAAC,iBAAiB,CAAa;IACtC,OAAO,CAAC,qBAAqB,CAA6D;IAC1F,OAAO,CAAC,cAAc,CAAc;IACpC,OAAO,CAAC,kBAAkB,CAAc;IACxC,OAAO,CAAC,oBAAoB,CAAkC;IAC9D,OAAO,CAAC,eAAe,CAA8B;IACrD,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,gBAAgB,CAAqB;IAC7C,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,kBAAkB,CAAuC;IACjE,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,eAAe,CAA6C;IAGpE,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAK;IAGxC,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,UAAU,CAAc;IAGhC,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,gBAAgB,CAAc;IACtC,OAAO,CAAC,aAAa,CAAkB;IACvC,OAAO,CAAC,cAAc,CAAkB;IAGxC,OAAO,CAAC,gBAAgB,CAA4B;IAGpD,OAAO,CAAC,aAAa,CAA8C;IAGnE,OAAO,CAAC,YAAY,CAA8C;IAGlE,OAAO,CAAC,kBAAkB,CAA8C;IAGxE,OAAO,CAAC,gBAAgB,CAA8C;IAGtE,OAAO,CAAC,UAAU,CAAgC;IAElD,OAAO;IAUP;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,eAAe;IAOlD;;OAEG;IACH,KAAK,IAAI,IAAI;IAkDb,OAAO,CAAC,KAAK;YAkGC,UAAU;IA4CxB,OAAO,CAAC,0BAA0B;IAclC,OAAO,CAAC,QAAQ;IAmChB,OAAO,CAAC,UAAU;IA4ElB,OAAO,CAAC,aAAa;IAqCrB,OAAO,CAAC,aAAa;IA0IrB,OAAO,CAAC,mBAAmB;IAoC3B,OAAO,CAAC,kBAAkB;IAoF1B,OAAO,CAAC,aAAa;IAuWrB,OAAO,CAAC,qBAAqB;IAqD7B,OAAO,CAAC,qBAAqB;IA+E7B,OAAO,CAAC,qBAAqB;IAsG7B,OAAO,CAAC,aAAa;IAsHrB,OAAO,CAAC,sBAAsB;IAyB9B,OAAO,CAAC,qBAAqB;IA6B7B,OAAO,CAAC,UAAU;IA+ClB,OAAO,CAAC,wBAAwB;IAqBhC,OAAO,CAAC,cAAc;IAUtB;;OAEG;YACW,4BAA4B;IAgB1C;;OAEG;YACW,mBAAmB;IAqHjC,OAAO,CAAC,6BAA6B;IA8DrC,OAAO,CAAC,cAAc;IAkFtB,OAAO,CAAC,aAAa;IAsGrB,OAAO,CAAC,YAAY;IAmGpB,OAAO,CAAC,YAAY;IAoBpB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,gBAAgB;IAkDxB,OAAO,CAAC,mBAAmB;IAsB3B,OAAO,CAAC,qBAAqB;IAmB7B,sGAAsG;IACtG,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,cAAc;IAgBtB,OAAO,CAAC,cAAc;IAkFtB,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,YAAY;CAoCrB"}

package/dist/esm/flow/SmartComplyFlow.js

@@ -14,7 +14,6 @@ const STEP_ORDER = [
     "document_confirm",
     "liveness",
     "done",
-    "result",
 ];
 const COUNTRY_LABELS = {
     nigeria: "🇳🇬  Nigeria",
@@ -279,6 +278,7 @@ export class SmartComplyFlow {
         this.livenessEntryId = null;
         this.isDestroyed = false;
         this.headerBackBtn = null;
+        this._keydownHandler = null;
         // Retry safety — max 3 confirmation rejections or liveness failures per session
         this._confirmRetries = 0;
         this._livenessFailures = 0;
@@ -336,6 +336,10 @@ export class SmartComplyFlow {
      */
     close() {
         this.isDestroyed = true;
+        if (this._keydownHandler) {
+            document.removeEventListener("keydown", this._keydownHandler);
+            this._keydownHandler = null;
+        }
         this.docCapture?.destroy();
         // Release any pre-warmed camera stream
         if (this._prewarmedStream) {
@@ -442,6 +446,30 @@ export class SmartComplyFlow {
             if (this.modal)
                 this.modal.style.transform = "translateY(0) scale(1)";
         });
+        // Escape closes the dialog; Tab is trapped inside it (standard WCAG dialog pattern).
+        this._keydownHandler = (e) => {
+            if (e.key === "Escape") {
+                e.preventDefault();
+                this.close();
+                return;
+            }
+            if (e.key === "Tab" && this.modal) {
+                const focusable = this.modal.querySelectorAll('button:not([disabled]), [href], input:not([disabled]), select:not([disabled]), textarea:not([disabled]), [tabindex]:not([tabindex="-1"])');
+                if (focusable.length === 0)
+                    return;
+                const first = focusable[0];
+                const last = focusable[focusable.length - 1];
+                if (e.shiftKey && document.activeElement === first) {
+                    e.preventDefault();
+                    last.focus();
+                }
+                else if (!e.shiftKey && document.activeElement === last) {
+                    e.preventDefault();
+                    first.focus();
+                }
+            }
+        };
+        document.addEventListener("keydown", this._keydownHandler);
     }
     async initialize() {
         this.showStep("loading");
@@ -453,11 +481,7 @@ export class SmartComplyFlow {
             if (expiresAt) {
                 const expiresMs = new Date(expiresAt).getTime() - Date.now();
                 const warnMs = Math.max(expiresMs - 120000, 0); // warn 2 min before
-                this.sessionExpiryTimer = setTimeout(() => {
-                    if (!this.isDestroyed && this.currentStep !== "result") {
-                        this.showErrorStep("Your session is about to expire. Please complete verification quickly or restart.");
-                    }
-                }, warnMs);
+                this.sessionExpiryTimer = setTimeout(() => this._showExpiryWarningWhenSafe(), warnMs);
             }
             // Load config
             this.sdkConfig = await this.sdk.initializeConfig();
@@ -478,6 +502,19 @@ export class SmartComplyFlow {
             this.showErrorStep(err.message || "Failed to initialize. Please try again.");
         }
     }
+    // Defers the expiry warning while the user is on a camera-active step
+    // (document_capture/liveness) — showing it there would blow away a live
+    // video element and in-progress MediaRecorder mid-scan.
+    _showExpiryWarningWhenSafe() {
+        if (this.isDestroyed)
+            return;
+        const cameraActiveSteps = ["document_capture", "liveness"];
+        if (cameraActiveSteps.includes(this.currentStep)) {
+            this.sessionExpiryTimer = setTimeout(() => this._showExpiryWarningWhenSafe(), 5000);
+            return;
+        }
+        this.showErrorStep("Your session is about to expire. Please complete verification quickly or restart.");
+    }
     // ─────────────────────────────────────────────────────────────────
     // Step rendering
     // ─────────────────────────────────────────────────────────────────
@@ -547,18 +584,12 @@ export class SmartComplyFlow {
             case "document_confirm":
                 this.renderDocumentConfirm(wrapper);
                 break;
-            case "processing":
-                // C1: processing step is dead code — flow now goes to 'done' after submit
-                break;
             case "liveness":
                 this.renderLiveness(wrapper);
                 break;
             case "done":
                 this.renderDone(wrapper);
                 break;
-            case "result":
-                // C2: result step is dead code — showResult/renderResult removed
-                break;
             case "error":
                 break;
         }
@@ -568,6 +599,23 @@ export class SmartComplyFlow {
             wrapper.style.opacity = "1";
             wrapper.style.transform = "translateX(0)";
         });
+        // Move focus to the new step's heading so keyboard/screen-reader users
+        // aren't left on a now-detached button. Skipped for camera-active steps
+        // and id_input, which already focuses its first field itself.
+        const skipAutoFocusSteps = ["document_capture", "liveness", "id_input"];
+        if (!skipAutoFocusSteps.includes(step)) {
+            requestAnimationFrame(() => {
+                const heading = wrapper.querySelector("h1, h2, h3");
+                const target = heading ||
+                    wrapper.querySelector('button:not([disabled]), input:not([disabled]), select:not([disabled]), textarea:not([disabled]), [tabindex]:not([tabindex="-1"])');
+                if (target) {
+                    if (heading && !heading.hasAttribute("tabindex")) {
+                        heading.setAttribute("tabindex", "-1");
+                    }
+                    target.focus({ preventScroll: true });
+                }
+            });
+        }
     }
     // ── Loading ─────────────────────────────────────────────────────
     renderLoading(container) {
@@ -1239,14 +1287,14 @@ export class SmartComplyFlow {
             container.appendChild(sub);
         }
         const yesBtn = this.createPrimaryButton("Yes, that's me — continue");
-        yesBtn.addEventListener("click", () => {
+        this._onceClick(yesBtn, () => {
             // B5: Reset retry counter on successful confirmation
             this._confirmRetries = 0;
             this.showStep("liveness");
         });
         container.appendChild(yesBtn);
         const noBtn = this.createSecondaryButton("No, use a different ID");
-        noBtn.addEventListener("click", () => {
+        this._onceClick(noBtn, () => {
             this._confirmRetries++;
             this._ivsName = "";
             this._ivsGender = "";
@@ -1332,14 +1380,14 @@ export class SmartComplyFlow {
         }
         container.appendChild(card);
         const yesBtn = this.createPrimaryButton("Yes, continue");
-        yesBtn.addEventListener("click", () => {
+        this._onceClick(yesBtn, () => {
             // B5: Reset retry counter on successful confirmation
             this._confirmRetries = 0;
             this.showStep("liveness");
         });
         container.appendChild(yesBtn);
         const noBtn = this.createSecondaryButton("No, retake document");
-        noBtn.addEventListener("click", () => {
+        this._onceClick(noBtn, () => {
             this._confirmRetries++;
             this._ocrName = "";
             this._ocrDocNumber = "";
@@ -1840,9 +1888,6 @@ export class SmartComplyFlow {
             this.showErrorStep(err.message || "Liveness verification failed. Please try again.");
         });
     }
-    renderResult(_container) {
-        // C2: Dead code — flow routes to 'done' step, not 'result'. Kept as stub.
-    }
     // ── Error ───────────────────────────────────────────────────────
     showErrorStep(message) {
         this.currentStep = "error";
@@ -2128,6 +2173,17 @@ export class SmartComplyFlow {
         });
         return btn;
     }
+    /** Click handler that fires once and disables the button, preventing a double-tap double-dispatch. */
+    _onceClick(btn, handler) {
+        btn.addEventListener("click", () => {
+            if (btn.disabled)
+                return;
+            btn.disabled = true;
+            btn.style.opacity = "0.6";
+            btn.style.cursor = "default";
+            handler();
+        });
+    }
     isDocumentFlow() {
         // 1. Check verification_type — handle both string and array from backend
         const vType = this.sdkConfig?.verification_type;
@@ -2157,7 +2213,7 @@ export class SmartComplyFlow {
         const allActionSteps = [...stage1Steps, ...stage2Steps];
         const totalSteps = allActionSteps.length;
         const actionIndex = allActionSteps.indexOf(this.currentStep);
-        const pct = this.currentStep === "done" || this.currentStep === "result" ? 100
+        const pct = this.currentStep === "done" ? 100
             : actionIndex >= 0 ? ((actionIndex + 1) / totalSteps) * 100
                 : 0;
         if (this.progressBar) {
@@ -2168,7 +2224,7 @@ export class SmartComplyFlow {
             if (this.currentStep === "loading" || this.currentStep === "welcome") {
                 this.stepLabel.textContent = "";
             }
-            else if (this.currentStep === "done" || this.currentStep === "result") {
+            else if (this.currentStep === "done") {
                 this.stepLabel.textContent = "Complete ✓";
             }
             else if (stage2Steps.includes(this.currentStep)) {
@@ -2186,7 +2242,7 @@ export class SmartComplyFlow {
             const dots = Array.from(this.stageDots.children);
             const inStage1 = stage1Steps.includes(this.currentStep);
             const inStage2 = stage2Steps.includes(this.currentStep);
-            const isComplete = this.currentStep === "done" || this.currentStep === "result";
+            const isComplete = this.currentStep === "done";
             const stage1Active = inStage1 || inStage2 || isComplete;
             const stage2Active = inStage2 || isComplete;
             if (dots[0])