idmission-web-sdk 2.6.1-changeset-release-develop-78d33ca → 2.6.1-changeset-release-develop-3d44875

package/dist/index.d.ts

@@ -901,6 +901,14 @@ type IdCaptureGuideImage = {
 
 type IdCaptureGuideType = 'fit' | 'overlay';
 
+/**
+ * Why the camera could not be used: `permissionDenied` when the user or the
+ * browser refused the permission, `unavailable` when it could not be started
+ * (in use by another app, blocked by the OS, or no usable camera). Passed to
+ * `onCameraAccessDenied` so a host can word its own screen to match.
+ */
+type CameraAccessDeniedReason = 'permissionDenied' | 'unavailable';
+
 type IdCaptureLoadingOverlayMode = 'default' | 'legacy' | 'ring';
 
 /** How the selfie guide prompts the user to put their head in the oval. */
@@ -8639,8 +8647,15 @@ type CompatCaptureExitProps = {
      * results in the cancel button being rendered on the loading overlay.
      */
     onUserCancel?: () => void;
-    /** Callback function that fires when the camera access is denied. */
-    onCameraAccessDenied?: () => void;
+    /**
+     * Callback function that fires when the camera cannot be used. `reason` is
+     * `'permissionDenied'` when the user or browser refused camera permission,
+     * or `'unavailable'` when the camera could not be started (in use by another
+     * app, blocked by the operating system, or no usable camera found). In
+     * VideoIdValidation it fires during ID capture only, not during the video
+     * recording.
+     */
+    onCameraAccessDenied?: (reason: CameraAccessDeniedReason) => void;
     /** Callback function that fires when the camera tampering is detected. */
     onCameraTamperingDetected?: () => void;
     /**
@@ -11198,7 +11213,7 @@ declare global {
     var IDmissionSDK: IDmissionSDK;
 }
 
-declare const webSdkVersion = "2.6.1-changeset-release-develop-78d33ca";
+declare const webSdkVersion = "2.6.1-changeset-release-develop-3d44875";
 
 /**
  * sdk2's imperative handle on the video-signature capture screen
@@ -11219,4 +11234,4 @@ type VideoSignatureCaptureRef = {
 };
 
 export { CapturedDocumentImg, CustomerBiometricsEnrollment, CustomerIdAndBiometricsEnrollment, CustomerIdentification, CustomerVerification, DocumentCapture, FaceValidation, IDmissionSDK, IdAndFaceValidation, IdValidation, SignatureKYC, VideoIdValidation, allowedAuthUrls, captureMediaIntegrity, createCaptureProgress, defaultAuthUrl, defaultSubmissionUrl, isObject, preloadModels, renderCustomerBiometricsEnrollment, renderCustomerIdAndBiometricsEnrollment, renderCustomerIdentification, renderCustomerVerification, renderDocumentCapture, renderFaceValidation, renderIdAndFaceValidation, renderIdValidation, renderSignatureKYC, renderVideoIdValidation, requiresSignatureRetry, setServerUrl, summarizeQualityWarning, themes, useDocumentUpload, webSdkVersion };
-export type { CaptureProgressOptions, CaptureProgressSession, CaptureProgressTask, CustomerBiometricsEnrollmentAssets, CustomerBiometricsEnrollmentClassNames, CustomerBiometricsEnrollmentColors, CustomerBiometricsEnrollmentProps, CustomerBiometricsEnrollmentVerbiage, CustomerIdAndBiometricsEnrollmentAssets, CustomerIdAndBiometricsEnrollmentClassNames, CustomerIdAndBiometricsEnrollmentColors, CustomerIdAndBiometricsEnrollmentProps, CustomerIdAndBiometricsEnrollmentVerbiage, CustomerIdentificationAssets, CustomerIdentificationClassNames, CustomerIdentificationColors, CustomerIdentificationProps, CustomerIdentificationVerbiage, CustomerSuppliedVerbiage, CustomerVerificationAssets, CustomerVerificationClassNames, CustomerVerificationColors, CustomerVerificationProps, CustomerVerificationVerbiage, DocumentAutoCaptureOptions, DocumentAutoCaptureThresholds, DocumentCaptureClassNames, DocumentCaptureProps, DocumentCaptureVerbiage, DocumentMetadata, DocumentUploadHandlers, DocumentUploadProgressEvent, DocumentUploader, FaceValidationAssets, FaceValidationClassNames, FaceValidationColors, FaceValidationProps, FaceValidationVerbiage, FrameDecodeResult, FrameDecodeStatus, FrameProbeResult, IdAndFaceValidationAssets, IdAndFaceValidationCapturedDocumentType, IdAndFaceValidationClassNames, IdAndFaceValidationColors, IdAndFaceValidationExitReason, IdAndFaceValidationJourneyEvent, IdAndFaceValidationJourneyStage, IdAndFaceValidationProps, IdAndFaceValidationVerbiage, IdValidationAssets, IdValidationClassNames, IdValidationColors, IdValidationProps, IdValidationVerbiage, LoadingSpinnerComponent, LoadingSpinnerProps, LoadingSpinnerStage, MediaIntegrityToken, OnIdAndFaceValidationJourneyEvent, OnVideoSignatureCaptureAnalyzed, OnVideoSignatureCaptureAtRisk, QualityWarningSummary, RecordingInterruptedScreenProps, RemoteDiagnostics, SelfieCaptureQualityException, SelfieCaptureRecoveryOptions, SignatureKYCAssets, SignatureKYCClassNames, SignatureKYCColors, SignatureKYCProps, SignatureKYCVerbiage, SignatureMetricKey, SignatureValidityConfig, SignatureValidityConfigInput, SignatureValidityMetrics, SignatureValidityResult, SubmissionRequest, SubmissionResponse, Theme, UploadDocument, UseDocumentUploadOptions, VideoIdValidationAssets, VideoIdValidationClassNames, VideoIdValidationColors, VideoIdValidationProps, VideoIdValidationVerbiage, VideoSignatureCaptureRef, VideoSignatureMetadata, VideoSignatureQualitySignal, VideoSignatureQualityWarning, WorkflowObservation, WorkflowPhase };
+export type { CameraAccessDeniedReason, CaptureProgressOptions, CaptureProgressSession, CaptureProgressTask, CustomerBiometricsEnrollmentAssets, CustomerBiometricsEnrollmentClassNames, CustomerBiometricsEnrollmentColors, CustomerBiometricsEnrollmentProps, CustomerBiometricsEnrollmentVerbiage, CustomerIdAndBiometricsEnrollmentAssets, CustomerIdAndBiometricsEnrollmentClassNames, CustomerIdAndBiometricsEnrollmentColors, CustomerIdAndBiometricsEnrollmentProps, CustomerIdAndBiometricsEnrollmentVerbiage, CustomerIdentificationAssets, CustomerIdentificationClassNames, CustomerIdentificationColors, CustomerIdentificationProps, CustomerIdentificationVerbiage, CustomerSuppliedVerbiage, CustomerVerificationAssets, CustomerVerificationClassNames, CustomerVerificationColors, CustomerVerificationProps, CustomerVerificationVerbiage, DocumentAutoCaptureOptions, DocumentAutoCaptureThresholds, DocumentCaptureClassNames, DocumentCaptureProps, DocumentCaptureVerbiage, DocumentMetadata, DocumentUploadHandlers, DocumentUploadProgressEvent, DocumentUploader, FaceValidationAssets, FaceValidationClassNames, FaceValidationColors, FaceValidationProps, FaceValidationVerbiage, FrameDecodeResult, FrameDecodeStatus, FrameProbeResult, IdAndFaceValidationAssets, IdAndFaceValidationCapturedDocumentType, IdAndFaceValidationClassNames, IdAndFaceValidationColors, IdAndFaceValidationExitReason, IdAndFaceValidationJourneyEvent, IdAndFaceValidationJourneyStage, IdAndFaceValidationProps, IdAndFaceValidationVerbiage, IdValidationAssets, IdValidationClassNames, IdValidationColors, IdValidationProps, IdValidationVerbiage, LoadingSpinnerComponent, LoadingSpinnerProps, LoadingSpinnerStage, MediaIntegrityToken, OnIdAndFaceValidationJourneyEvent, OnVideoSignatureCaptureAnalyzed, OnVideoSignatureCaptureAtRisk, QualityWarningSummary, RecordingInterruptedScreenProps, RemoteDiagnostics, SelfieCaptureQualityException, SelfieCaptureRecoveryOptions, SignatureKYCAssets, SignatureKYCClassNames, SignatureKYCColors, SignatureKYCProps, SignatureKYCVerbiage, SignatureMetricKey, SignatureValidityConfig, SignatureValidityConfigInput, SignatureValidityMetrics, SignatureValidityResult, SubmissionRequest, SubmissionResponse, Theme, UploadDocument, UseDocumentUploadOptions, VideoIdValidationAssets, VideoIdValidationClassNames, VideoIdValidationColors, VideoIdValidationProps, VideoIdValidationVerbiage, VideoSignatureCaptureRef, VideoSignatureMetadata, VideoSignatureQualitySignal, VideoSignatureQualityWarning, WorkflowObservation, WorkflowPhase };

package/dist/props.json

@@ -1,7 +1,7 @@
 {
   "$comment": "GENERATED by scripts/propsManifest.mjs at build time. Each customer flow's props, read off dist/index.d.ts.",
   "schemaVersion": 1,
-  "version": "2.6.1-changeset-release-develop-78d33ca",
+  "version": "2.6.1-changeset-release-develop-3d44875",
   "components": {
     "IdValidation": {
       "description": "Render a fullscreen ID capture component that instructs the user to\nphotograph both sides of their ID card, or the full page of their passport.",
@@ -266,9 +266,9 @@
         },
         {
           "name": "onCameraAccessDenied",
-          "type": "() => void",
+          "type": "(reason: CameraAccessDeniedReason) => void",
           "required": false,
-          "description": "Callback function that fires when the camera access is denied."
+          "description": "Callback function that fires when the camera cannot be used. `reason` is\n`'permissionDenied'` when the user or browser refused camera permission,\nor `'unavailable'` when the camera could not be started (in use by another\napp, blocked by the operating system, or no usable camera found). In\nVideoIdValidation it fires during ID capture only, not during the video\nrecording."
         },
         {
           "name": "onCameraTamperingDetected",
@@ -949,9 +949,9 @@
         },
         {
           "name": "onCameraAccessDenied",
-          "type": "() => void",
+          "type": "(reason: CameraAccessDeniedReason) => void",
           "required": false,
-          "description": "Callback function that fires when the camera access is denied."
+          "description": "Callback function that fires when the camera cannot be used. `reason` is\n`'permissionDenied'` when the user or browser refused camera permission,\nor `'unavailable'` when the camera could not be started (in use by another\napp, blocked by the operating system, or no usable camera found). In\nVideoIdValidation it fires during ID capture only, not during the video\nrecording."
         },
         {
           "name": "onCameraTamperingDetected",
@@ -1452,9 +1452,9 @@
         },
         {
           "name": "onCameraAccessDenied",
-          "type": "() => void",
+          "type": "(reason: CameraAccessDeniedReason) => void",
           "required": false,
-          "description": "Callback function that fires when the camera access is denied."
+          "description": "Callback function that fires when the camera cannot be used. `reason` is\n`'permissionDenied'` when the user or browser refused camera permission,\nor `'unavailable'` when the camera could not be started (in use by another\napp, blocked by the operating system, or no usable camera found). In\nVideoIdValidation it fires during ID capture only, not during the video\nrecording."
         },
         {
           "name": "onCameraTamperingDetected",
@@ -2075,9 +2075,9 @@
         },
         {
           "name": "onCameraAccessDenied",
-          "type": "() => void",
+          "type": "(reason: CameraAccessDeniedReason) => void",
           "required": false,
-          "description": "Callback function that fires when the camera access is denied."
+          "description": "Callback function that fires when the camera cannot be used. `reason` is\n`'permissionDenied'` when the user or browser refused camera permission,\nor `'unavailable'` when the camera could not be started (in use by another\napp, blocked by the operating system, or no usable camera found). In\nVideoIdValidation it fires during ID capture only, not during the video\nrecording."
         },
         {
           "name": "onCameraTamperingDetected",
@@ -2728,9 +2728,9 @@
         },
         {
           "name": "onCameraAccessDenied",
-          "type": "() => void",
+          "type": "(reason: CameraAccessDeniedReason) => void",
           "required": false,
-          "description": "Callback function that fires when the camera access is denied."
+          "description": "Callback function that fires when the camera cannot be used. `reason` is\n`'permissionDenied'` when the user or browser refused camera permission,\nor `'unavailable'` when the camera could not be started (in use by another\napp, blocked by the operating system, or no usable camera found). In\nVideoIdValidation it fires during ID capture only, not during the video\nrecording."
         },
         {
           "name": "onCameraTamperingDetected",
@@ -3267,9 +3267,9 @@
         },
         {
           "name": "onCameraAccessDenied",
-          "type": "() => void",
+          "type": "(reason: CameraAccessDeniedReason) => void",
           "required": false,
-          "description": "Callback function that fires when the camera access is denied."
+          "description": "Callback function that fires when the camera cannot be used. `reason` is\n`'permissionDenied'` when the user or browser refused camera permission,\nor `'unavailable'` when the camera could not be started (in use by another\napp, blocked by the operating system, or no usable camera found). In\nVideoIdValidation it fires during ID capture only, not during the video\nrecording."
         },
         {
           "name": "onCameraTamperingDetected",
@@ -3584,9 +3584,9 @@
         },
         {
           "name": "onCameraAccessDenied",
-          "type": "() => void",
+          "type": "(reason: CameraAccessDeniedReason) => void",
           "required": false,
-          "description": "Callback function that fires when the camera access is denied."
+          "description": "Callback function that fires when the camera cannot be used. `reason` is\n`'permissionDenied'` when the user or browser refused camera permission,\nor `'unavailable'` when the camera could not be started (in use by another\napp, blocked by the operating system, or no usable camera found). In\nVideoIdValidation it fires during ID capture only, not during the video\nrecording."
         },
         {
           "name": "onCameraTamperingDetected",
@@ -4003,9 +4003,9 @@
         },
         {
           "name": "onCameraAccessDenied",
-          "type": "() => void",
+          "type": "(reason: CameraAccessDeniedReason) => void",
           "required": false,
-          "description": "Callback function that fires when the camera access is denied."
+          "description": "Callback function that fires when the camera cannot be used. `reason` is\n`'permissionDenied'` when the user or browser refused camera permission,\nor `'unavailable'` when the camera could not be started (in use by another\napp, blocked by the operating system, or no usable camera found). In\nVideoIdValidation it fires during ID capture only, not during the video\nrecording."
         },
         {
           "name": "onCameraTamperingDetected",
@@ -4434,9 +4434,9 @@
         },
         {
           "name": "onCameraAccessDenied",
-          "type": "() => void",
+          "type": "(reason: CameraAccessDeniedReason) => void",
           "required": false,
-          "description": "Callback function that fires when the camera access is denied."
+          "description": "Callback function that fires when the camera cannot be used. `reason` is\n`'permissionDenied'` when the user or browser refused camera permission,\nor `'unavailable'` when the camera could not be started (in use by another\napp, blocked by the operating system, or no usable camera found). In\nVideoIdValidation it fires during ID capture only, not during the video\nrecording."
         },
         {
           "name": "onCameraTamperingDetected",
@@ -4979,9 +4979,9 @@
         },
         {
           "name": "onCameraAccessDenied",
-          "type": "() => void",
+          "type": "(reason: CameraAccessDeniedReason) => void",
           "required": false,
-          "description": "Callback function that fires when the camera access is denied."
+          "description": "Callback function that fires when the camera cannot be used. `reason` is\n`'permissionDenied'` when the user or browser refused camera permission,\nor `'unavailable'` when the camera could not be started (in use by another\napp, blocked by the operating system, or no usable camera found). In\nVideoIdValidation it fires during ID capture only, not during the video\nrecording."
         },
         {
           "name": "onCameraTamperingDetected",

package/dist/sdk2.cjs.development.js

@@ -16402,7 +16402,7 @@ function _acquireCamera() {
           });
         case 8:
           if (stream) {
-            _context.next = 12;
+            _context.next = 13;
             break;
           }
           _context.prev = 9;
@@ -16416,21 +16416,26 @@ function _acquireCamera() {
           debug$1(LOG_TAG + " opened fallback stream", {
             maxVideoResolution: maxVideoResolution
           });
-          _context.next = 12;
+          _context.next = 13;
           break;
         case 11:
           _context.prev = 11;
           _t2 = _context["catch"](9);
-          // cameraStore.tsx:288-290 — non-fatal logging path, kept verbatim.
-          debug$1(LOG_TAG + " cannot open stream at all", _t2);
+          if (!(_t2.name === 'NotAllowedError')) {
+            _context.next = 12;
+            break;
+          }
+          throw _t2;
         case 12:
+          debug$1(LOG_TAG + " cannot open stream at all", _t2);
+        case 13:
           if (stream) {
-            _context.next = 13;
+            _context.next = 14;
             break;
           }
           error$1(LOG_TAG + " failed to open camera");
           throw new Error('failed to open camera: ');
-        case 13:
+        case 14:
           debug$1(LOG_TAG + " camera access requested with constraints", constraints);
           handleStreamEnded = function handleStreamEnded() {
             // cameraStore.tsx:303-326 — sdk2 branches on whether a continuity
@@ -16453,7 +16458,7 @@ function _acquireCamera() {
             handleStreamEnded();
           };
           camera = obtainCameraAccess(stream, selectedCamera.label, videoEl);
-          _context.next = 14;
+          _context.next = 15;
           return new Promise(function (resolve) {
             scheduleTimeout(function () {
               // iOS 17 has a strange behavior where the video track flickers
@@ -16469,7 +16474,7 @@ function _acquireCamera() {
               resolve();
             }, 500);
           });
-        case 14:
+        case 15:
           isRearFacing = (_camera$isRearFacing = camera == null ? void 0 : camera.isRearFacing) != null ? _camera$isRearFacing : false;
           return _context.abrupt("return", {
             camera: camera,
@@ -16479,18 +16484,18 @@ function _acquireCamera() {
               return camera.release();
             }
           });
-        case 15:
-          _context.prev = 15;
+        case 16:
+          _context.prev = 16;
           _t3 = _context["catch"](2);
           if (!(_t3 instanceof CaptureAttachError)) {
-            _context.next = 16;
+            _context.next = 17;
             break;
           }
           throw _t3;
-        case 16:
+        case 17:
           err = _t3;
           if (!(err.name === 'NotAllowedError')) {
-            _context.next = 17;
+            _context.next = 18;
             break;
           }
           // cameraStore.tsx:374-381 — outer catch's "blocked by the user" path.
@@ -16501,9 +16506,9 @@ function _acquireCamera() {
             code: 'CAMERA_PERMISSION_DENIED',
             recoverable: true
           });
-        case 17:
+        case 18:
           if (!((_err$message = err.message) != null && _err$message.includes('failed to open camera') || (_err$message2 = err.message) != null && _err$message2.includes('Could not start video source'))) {
-            _context.next = 18;
+            _context.next = 19;
             break;
           }
           error$1(LOG_TAG + " camera access encountered some other error", _t3);
@@ -16512,16 +16517,16 @@ function _acquireCamera() {
             recoverable: true,
             cause: _t3
           });
-        case 18:
+        case 19:
           // cameraStore.tsx:382-385 — genuinely unexpected error; sdk2 rethrows it
           // as-is (no CaptureError bucket exists for it), so we do too.
           error$1(LOG_TAG + " camera access encountered some other error", _t3);
           throw _t3;
-        case 19:
+        case 20:
         case "end":
           return _context.stop();
       }
-    }, _callee, null, [[2, 15], [5, 7], [9, 11]]);
+    }, _callee, null, [[2, 16], [5, 7], [9, 11]]);
   }));
   return _acquireCamera.apply(this, arguments);
 }
@@ -20953,6 +20958,34 @@ var ErrorCard = styledComponents.styled(FlexCard)(_templateObject$A || (_templat
 var Heading$8 = styledComponents.styled.h1(_templateObject2$v || (_templateObject2$v = _taggedTemplateLiteralLoose(["\n  font-size: 1.5rem;\n  margin-top: 0;\n  margin-bottom: 1rem;\n"])));
 var Description$2 = styledComponents.styled.p(_templateObject3$m || (_templateObject3$m = _taggedTemplateLiteralLoose(["\n  line-height: 1.5;\n  margin-bottom: 1.5rem;\n"])));
 
+function reasonFor(code) {
+  if (code === 'CAMERA_PERMISSION_DENIED') return 'permissionDenied';
+  if (code === 'CAMERA_UNAVAILABLE') return 'unavailable';
+  return undefined;
+}
+/**
+ * Calls `onCameraAccessDenied` once per camera failure a controller reports:
+ * when its error code becomes one, changes to the other, or a different
+ * controller reports one. Not per render, and not again when StrictMode
+ * replays effects, since the latch only moves when what it saw changes. A
+ * failure seen with no handler bound is not latched, so a handler bound later
+ * still hears about it; one already reported stays latched while the handler
+ * is briefly unbound.
+ */
+function useCameraAccessDeniedReport(controller, errorCode, onCameraAccessDenied) {
+  var reason = reasonFor(errorCode);
+  var reportedRef = React.useRef(undefined);
+  React.useEffect(function () {
+    var reported = reportedRef.current;
+    var alreadyReported = (reported == null ? void 0 : reported.controller) === controller && reported.reason === reason;
+    reportedRef.current = {
+      controller: controller,
+      reason: onCameraAccessDenied || alreadyReported ? reason : undefined
+    };
+    if (reason && onCameraAccessDenied && !alreadyReported) onCameraAccessDenied(reason);
+  }, [controller, reason, onCameraAccessDenied]);
+}
+
 // The one file-read both fallback screens use.
 //
 // Shared rather than duplicated: they read the same kind of file for the same
@@ -21781,7 +21814,6 @@ function IdCaptureViewContent(_ref) {
   var pendingPrecapturedRef = React.useRef(new Set());
   var seenPrecapturedRef = React.useRef(new Set());
   var tamperReportedRef = React.useRef(false);
-  var cameraDeniedReportedRef = React.useRef(false);
   var reportedModelErrorRef = React.useRef(null);
   // A new controller is a new session, so every notification latch below has
   // to start over — the same reasoning as the attach and overlay-dismissal
@@ -21799,7 +21831,6 @@ function IdCaptureViewContent(_ref) {
     pendingPrecapturedRef.current = new Set();
     seenPrecapturedRef.current = new Set();
     tamperReportedRef.current = false;
-    cameraDeniedReportedRef.current = false;
     reportedModelErrorRef.current = null;
   }, [controller]);
   React.useEffect(function () {
@@ -21851,16 +21882,7 @@ function IdCaptureViewContent(_ref) {
   // controller's typed error, which is where core lands a denied camera and a
   // failed model load alike (dual-truth contract: the same failure is already
   // on screen, so these are notifications, not the error UI).
-  var cameraDenied = ((_state$error2 = state.error) == null ? void 0 : _state$error2.code) === 'CAMERA_PERMISSION_DENIED';
-  React.useEffect(function () {
-    if (!cameraDenied) {
-      cameraDeniedReportedRef.current = false;
-      return;
-    }
-    if (cameraDeniedReportedRef.current) return;
-    cameraDeniedReportedRef.current = true;
-    onCameraAccessDenied == null || onCameraAccessDenied();
-  }, [controller, cameraDenied, onCameraAccessDenied]);
+  useCameraAccessDeniedReport(controller, (_state$error2 = state.error) == null ? void 0 : _state$error2.code, onCameraAccessDenied);
   // Keyed on the ERROR OBJECT's identity, not on its cause: a MODEL_LOAD_FAILED
   // with no cause attached is still a model failure the host asked to hear
   // about, and keying on the cause skipped those entirely. A second, different
@@ -27482,7 +27504,7 @@ var StyledButtonsRow$4 = styledComponents.styled(ButtonsRow$2)(_templateObject6$
 
 var _templateObject$p, _templateObject2$m;
 function SelfieCaptureSurface(_ref) {
-  var _state$error, _state$error2, _state$captureRecover, _state$error5, _state$captureRecover2, _state$prediction, _state$prediction$sam, _state$prediction2, _state$prediction3, _state$prediction4, _state$prediction5, _state$prediction6, _state$prediction7, _state$prediction8, _state$prediction9, _state$prediction0, _state$prediction1, _state$prediction$bri, _state$prediction10, _state$prediction$ran, _state$prediction11, _state$prediction$var, _state$prediction12, _assets$loadingOverla, _classNames$loadingOv, _colors$loadingOverla, _verbiage$loadingOver;
+  var _state$error, _state$error2, _state$captureRecover, _state$error4, _state$error5, _state$captureRecover2, _state$prediction, _state$prediction$sam, _state$prediction2, _state$prediction3, _state$prediction4, _state$prediction5, _state$prediction6, _state$prediction7, _state$prediction8, _state$prediction9, _state$prediction0, _state$prediction1, _state$prediction$bri, _state$prediction10, _state$prediction$ran, _state$prediction11, _state$prediction$var, _state$prediction12, _assets$loadingOverla, _classNames$loadingOv, _colors$loadingOverla, _verbiage$loadingOver;
   var controller = _ref.controller,
     state = _ref.state,
     loadingOverlayMode = _ref.loadingOverlayMode,
@@ -27664,10 +27686,9 @@ function SelfieCaptureSurface(_ref) {
     kind: 'no-prompt'
   });
   var reportedModelErrorRef = React.useRef(null);
-  var cameraDeniedReportedRef = React.useRef(false);
   var tamperReportedRef = React.useRef(false);
   React.useEffect(function () {
-    var _state$error3, _state$error4;
+    var _state$error3;
     var modelError = state.models.error;
     if (modelError && modelError !== reportedModelErrorRef.current) {
       reportedModelErrorRef.current = modelError;
@@ -27675,21 +27696,16 @@ function SelfieCaptureSurface(_ref) {
       onModelError == null || onModelError(modelError);
     }
     if (!modelError) reportedModelErrorRef.current = null;
-    var cameraDenied = ((_state$error3 = state.error) == null ? void 0 : _state$error3.code) === 'CAMERA_PERMISSION_DENIED';
-    if (cameraDenied && !cameraDeniedReportedRef.current) {
-      cameraDeniedReportedRef.current = true;
-      onCameraAccessDenied == null || onCameraAccessDenied();
-    }
-    if (!cameraDenied) cameraDeniedReportedRef.current = false;
     // Same one-shot latch as IdCaptureView's: the host counts detections, not
     // renders, and a cleared-then-re-detected tamper is a second detection.
-    var tampered = ((_state$error4 = state.error) == null ? void 0 : _state$error4.code) === 'CAMERA_TAMPERING_SUSPECTED';
+    var tampered = ((_state$error3 = state.error) == null ? void 0 : _state$error3.code) === 'CAMERA_TAMPERING_SUSPECTED';
     if (tampered && !tamperReportedRef.current) {
       tamperReportedRef.current = true;
       onCameraTamperingDetected == null || onCameraTamperingDetected();
     }
     if (!tampered) tamperReportedRef.current = false;
-  }, [onCameraAccessDenied, onCameraTamperingDetected, onLoadingFailed, onModelError, (_state$error5 = state.error) == null ? void 0 : _state$error5.code, state.models.error]);
+  }, [onCameraTamperingDetected, onLoadingFailed, onModelError, (_state$error4 = state.error) == null ? void 0 : _state$error4.code, state.models.error]);
+  useCameraAccessDeniedReport(controller, (_state$error5 = state.error) == null ? void 0 : _state$error5.code, onCameraAccessDenied);
   var handleLoadingContinue = React.useCallback(function () {
     void controller.actions.start();
     onLoadingOverlayDismissed == null || onLoadingOverlayDismissed();
@@ -36387,7 +36403,7 @@ function DocumentCaptureView(props) {
   });
 }
 function DocumentCaptureSurface(_ref) {
-  var _entry$contentUrl, _entry$uploadState, _uiDocument$cameraFee, _entry$item$aspectRat, _uiDocument$instructi, _entry$item$title, _theme$documentCaptur, _theme$documentCaptur2, _state$autoCaptureShu, _state$autoCaptureShu2, _state$autoCaptureShu3, _state$autoCapture, _theme$documentCaptur3, _theme$documentCaptur4, _theme$colors$positiv, _theme$colors, _entry$item$title2, _entry$captureMetadat, _entry$captureMetadat2, _opaqueColor, _state$error, _state$error2, _guideRect$x, _guideRect$y, _guideRect$width, _guideRect$height, _state$autoCapture$gu, _state$autoCapture2;
+  var _entry$contentUrl, _entry$uploadState, _uiDocument$cameraFee, _entry$item$aspectRat, _uiDocument$instructi, _entry$item$title, _theme$documentCaptur, _theme$documentCaptur2, _state$autoCaptureShu, _state$autoCaptureShu2, _state$autoCaptureShu3, _state$autoCapture, _theme$documentCaptur3, _theme$documentCaptur4, _theme$colors$positiv, _theme$colors, _entry$item$title2, _entry$captureMetadat, _entry$captureMetadat2, _opaqueColor, _state$error, _state$error2, _state$error3, _state$error4, _guideRect$x, _guideRect$y, _guideRect$width, _guideRect$height, _state$autoCapture$gu, _state$autoCapture2;
   var controller = _ref.controller,
     _ref$lang = _ref.lang,
     lang = _ref$lang === void 0 ? 'auto' : _ref$lang,
@@ -36616,20 +36632,13 @@ function DocumentCaptureSurface(_ref) {
     completedRef.current = true;
     onCompleted == null || onCompleted();
   }, [everyUploaded, onCompleted]);
-  var cameraAccessDenied = ((_state$error = state.error) == null ? void 0 : _state$error.code) === 'CAMERA_PERMISSION_DENIED';
-  var cameraTampered = ((_state$error2 = state.error) == null ? void 0 : _state$error2.code) === 'CAMERA_TAMPERING_SUSPECTED';
-  // Latched like the completion effect above: a notification per denial or
-  // detection, not per render.
-  var deniedReportedRef = React.useRef(false);
-  React.useEffect(function () {
-    if (!cameraAccessDenied) {
-      deniedReportedRef.current = false;
-      return;
-    }
-    if (deniedReportedRef.current) return;
-    deniedReportedRef.current = true;
-    onCameraAccessDenied == null || onCameraAccessDenied();
-  }, [cameraAccessDenied, onCameraAccessDenied]);
+  // Either camera failure leaves the capture button stuck on "Loading", so
+  // both get the retry button.
+  var cameraFailed = ((_state$error = state.error) == null ? void 0 : _state$error.code) === 'CAMERA_PERMISSION_DENIED' || ((_state$error2 = state.error) == null ? void 0 : _state$error2.code) === 'CAMERA_UNAVAILABLE';
+  var cameraTampered = ((_state$error3 = state.error) == null ? void 0 : _state$error3.code) === 'CAMERA_TAMPERING_SUSPECTED';
+  // Latched like the completion effect above: a notification per camera
+  // failure or detection, not per render.
+  useCameraAccessDeniedReport(controller, (_state$error4 = state.error) == null ? void 0 : _state$error4.code, onCameraAccessDenied);
   var tamperReportedRef = React.useRef(false);
   React.useEffect(function () {
     if (!cameraTampered) {
@@ -36775,7 +36784,7 @@ function DocumentCaptureSurface(_ref) {
             finished: true,
             onClick: onExitAfterTamperSealPopped,
             children: verbiage.exitBtnText
-          }) : null : cameraAccessDenied ? jsxRuntime.jsx(LoaderButton, {
+          }) : null : cameraFailed ? jsxRuntime.jsx(LoaderButton, {
             className: classNames.retryCameraAccessBtn,
             variant: "negative",
             finished: true,
@@ -48482,7 +48491,7 @@ function mapCustomerIdAndBiometricsEnrollmentProps(props, ctx) {
   });
 }
 
-var webSdkVersion = '2.6.1-changeset-release-develop-78d33ca';
+var webSdkVersion = '2.6.1-changeset-release-develop-3d44875';
 
 // GENERATED by scripts/styleBagTypes.mjs from
 // src/__fixtures__/sdk2StyleBags.json and the mapper sweep — do not