smartcomply-web-sdk 1.0.50 → 1.0.52

package/dist/esm/flow/SmartComplyFlow.js

@@ -17,15 +17,15 @@ const STEP_ORDER = [
     "result",
 ];
 const COUNTRY_LABELS = {
-    nigeria: "🇳🇬  Nigeria",
-    global: "🌍  Other Countries",
-    ghana: "🇬🇭  Ghana",
-    kenya: "🇰🇪  Kenya",
-    south_africa: "🇿🇦  South Africa",
-    united_states: "🇺🇸  United States",
-    united_kingdom: "🇬🇧  United Kingdom",
+    nigeria: "🇳🇬  Nigeria",
+    global: "🌍  Other Countries",
+    ghana: "🇬🇭  Ghana",
+    kenya: "🇰🇪  Kenya",
+    south_africa: "🇿🇦  South Africa",
+    united_states: "🇺🇸  United States",
+    united_kingdom: "🇬🇧  United Kingdom",
 };
-// Backend/admin data tags document-capture fields inconsistently — the field
+// Backend/admin data tags document-capture fields inconsistently — the field
 // renderer (below) already treats "image" and "file" as file inputs alongside
 // "upload", so flow-routing decisions must recognize the same set or a channel
 // tagged "image"/"file" silently falls back to the number-entry screen.
@@ -35,7 +35,7 @@ function isUploadFieldType(type) {
 function resolveIdTypeInfo(typeName, isDocumentFlow) {
     const u = typeName.toUpperCase();
     const advanced = u.includes("ADVANCED");
-    // Strip UI noise from display labels — users don't need "with face" or "(NIN)" suffixes
+    // Strip UI noise from display labels — users don't need "with face" or "(NIN)" suffixes
     const cleanName = typeName
         .replace(/\s*with\s+face\s*/gi, ' ')
         .replace(/\s*\(NIN\)\s*/gi, ' ')
@@ -50,41 +50,41 @@ function resolveIdTypeInfo(typeName, isDocumentFlow) {
             t.includes("license") ||
             t.includes("national id") ||
             t.includes("national id card");
-        // Note: NIN document (nin_with_face, nin_slip) does NOT require back side —
+        // Note: NIN document (nin_with_face, nin_slip) does NOT require back side —
         // the NIN card is single-sided. Only the physical NIN slip has a back but
         // the OCR pipeline only needs the front.
     };
-    // BVN — always 11 digits
+    // BVN — always 11 digits
     if (u.includes("BVN") || u.includes("BANK VERIFICATION")) {
-        return { icon: "🏦", desc: "Enter your 11-digit Bank Verification Number (BVN)", requiresBack: false };
+        return { icon: "🏦", desc: "Enter your 11-digit Bank Verification Number (BVN)", requiresBack: false };
     }
-    // NIN — always 11 digits (covers nin_with_face, NIN slip, etc.)
+    // NIN — always 11 digits (covers nin_with_face, NIN slip, etc.)
     if (u.includes("NIN") || u.includes("NATIONAL IDENTITY NUMBER")) {
-        return { icon: "🆔", desc: "Enter your 11-digit National Identification Number (NIN)", requiresBack: false };
+        return { icon: "🆔", desc: "Enter your 11-digit National Identification Number (NIN)", requiresBack: false };
     }
     // Ghana Card / Ghana National ID
     if (u.includes("GHANA")) {
         if (isDocumentFlow)
-            return { icon: "🪪", desc: "Capture or upload your Ghana Card", requiresBack: true };
-        return { icon: "🪪", desc: "Enter your Ghana Card number", requiresBack: false };
+            return { icon: "🪪", desc: "Capture or upload your Ghana Card", requiresBack: true };
+        return { icon: "🪪", desc: "Enter your Ghana Card number", requiresBack: false };
     }
     // SSNIT (Ghana social security)
     if (u.includes("SSNIT"))
-        return { icon: "🏛️", desc: "Enter your SSNIT number", requiresBack: false };
+        return { icon: "🏛️", desc: "Enter your SSNIT number", requiresBack: false };
     // Kenya National ID
     if (u.includes("KENYA") || (u.includes("NATIONAL") && u.includes("KENYA")))
-        return { icon: "🆔", desc: "Enter your Kenya National ID number", requiresBack: false };
+        return { icon: "🆔", desc: "Enter your Kenya National ID number", requiresBack: false };
     // TIN
     if (u.includes("TIN") || u.includes("TAX IDENTIFICATION"))
-        return { icon: "🧾", desc: "Enter your Tax Identification Number (TIN)", requiresBack: false };
+        return { icon: "🧾", desc: "Enter your Tax Identification Number (TIN)", requiresBack: false };
     // CAC / Company registration
     if (u.includes("CAC") || u.includes("CORPORATE AFFAIRS") || u.includes("COMPANY"))
-        return { icon: "🏢", desc: advanced ? "Enter RC number, company name & type" : "Enter your company registration number", requiresBack: false };
+        return { icon: "🏢", desc: advanced ? "Enter RC number, company name & type" : "Enter your company registration number", requiresBack: false };
     // Voter / PVC
     if (u.includes("VOTER") || u.includes("PVC")) {
         const requiresBack = requiresBackSide(typeName);
         return {
-            icon: "🗳️",
+            icon: "🗳️",
             desc: isDocumentFlow
                 ? `Capture or upload your voter's card${requiresBack ? " (front & back)" : ""}`
                 : "Enter your voter ID number",
@@ -93,12 +93,12 @@ function resolveIdTypeInfo(typeName, isDocumentFlow) {
     }
     // Passport
     if (u.includes("PASSPORT"))
-        return { icon: "📘", desc: isDocumentFlow ? "Capture or upload your passport" : "Enter your passport number", requiresBack: false };
+        return { icon: "📘", desc: isDocumentFlow ? "Capture or upload your passport" : "Enter your passport number", requiresBack: false };
     // Driver's license
     if (u.includes("DRIVER") || u.includes("LICENSE") || u.includes("LICENCE")) {
         const requiresBack = requiresBackSide(typeName);
         return {
-            icon: "🚗",
+            icon: "🚗",
             desc: isDocumentFlow
                 ? `Capture or upload your driver's license${requiresBack ? " (front & back)" : ""}`
                 : "Enter your driver's license number",
@@ -109,7 +109,7 @@ function resolveIdTypeInfo(typeName, isDocumentFlow) {
     if (u.includes("NATIONAL ID") || (u.includes("NATIONAL") && u.includes("CARD"))) {
         const requiresBack = requiresBackSide(typeName);
         return {
-            icon: "🪪",
+            icon: "🪪",
             desc: isDocumentFlow
                 ? `Capture or upload your ID card${requiresBack ? " (front & back)" : ""}`
                 : "Enter your National ID number",
@@ -118,15 +118,15 @@ function resolveIdTypeInfo(typeName, isDocumentFlow) {
     }
     // Face liveness / comparison
     if (u.includes("LIVENESS") || u.includes("FACE COMPARISON") || u.includes("FACE MATCH"))
-        return { icon: "🤳", desc: "We'll capture a short selfie video to verify you", requiresBack: false };
+        return { icon: "🤳", desc: "We'll capture a short selfie video to verify you", requiresBack: false };
     return {
-        icon: isDocumentFlow ? "📄" : "🆔",
+        icon: isDocumentFlow ? "📄" : "🆔",
         desc: isDocumentFlow ? "Capture or upload your document" : "Enter your ID number",
         requiresBack: false,
     };
 }
-// ─────────────────────────────────────────────────────────────────────
-// ── Widget-side message sanitizer ─────────────────────────────────────────────
+// ─────────────────────────────────────────────────────────────────────
+// ── Widget-side message sanitizer ─────────────────────────────────────────────
 // Strips anything technical before showing text to the end user.
 // Keeps messages that are already written plainly in natural language.
 function _sanitizeUserMessage(raw) {
@@ -155,7 +155,7 @@ function _sanitizeUserMessage(raw) {
         return null;
     return raw.trim();
 }
-// ── B8: OCR date string normaliser ───────────────────────────────────────────
+// ── B8: OCR date string normaliser ───────────────────────────────────────────
 // OCR providers return dates in wildly different formats. new Date(str) is
 // locale-dependent for anything other than ISO 8601 (YYYY-MM-DD), so we
 // attempt a set of known patterns before falling back to the native parser.
@@ -163,14 +163,14 @@ function _parseOcrDate(raw) {
     if (!raw)
         return null;
     const s = raw.trim();
-    // ISO 8601 or near-ISO  — try first, always unambiguous
+    // ISO 8601 or near-ISO  — try first, always unambiguous
     if (/^\d{4}-\d{2}-\d{2}/.test(s))
         return new Date(s.slice(0, 10));
     // DD/MM/YYYY  or  DD-MM-YYYY
     const dmy = s.match(/^(\d{2})[\/\-](\d{2})[\/\-](\d{4})/);
     if (dmy)
         return new Date(`${dmy[3]}-${dmy[2]}-${dmy[1]}`);
-    // MM/DD/YYYY  (US format — less common from OCR but possible)
+    // MM/DD/YYYY  (US format — less common from OCR but possible)
     const mdy = s.match(/^(\d{2})\/(\d{2})\/(\d{4})/);
     if (mdy) {
         // Heuristic: if "month" > 12 it must be day-first
@@ -186,7 +186,7 @@ function _parseOcrDate(raw) {
     const d = new Date(s);
     return isNaN(d.getTime()) ? null : d;
 }
-// ── W12: Image compression before document upload ────────────────────────────
+// ── W12: Image compression before document upload ────────────────────────────
 async function _compressImage(blob, maxWidth = 1600, quality = 0.85) {
     try {
         const bmp = await createImageBitmap(blob);
@@ -204,7 +204,7 @@ async function _compressImage(blob, maxWidth = 1600, quality = 0.85) {
         return blob; // fallback to original on any error
     }
 }
-// ── Document type code → human label ─────────────────────────────────────────
+// ── Document type code → human label ─────────────────────────────────────────
 function _formatDocType(code) {
     const map = {
         passport: "Passport",
@@ -225,7 +225,7 @@ function _formatDocType(code) {
     return code.replace(/_/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
 }
 // SmartComplyFlow
-// ─────────────────────────────────────────────────────────────────────
+// ─────────────────────────────────────────────────────────────────────
 // Add CSS animation keyframes for spin animations
 const style = document.createElement('style');
 style.textContent = `
@@ -267,7 +267,7 @@ export class SmartComplyFlow {
         this.livenessEntryId = null;
         this.isDestroyed = false;
         this.headerBackBtn = null;
-        // Retry safety — max 3 confirmation rejections or liveness failures per session
+        // Retry safety — max 3 confirmation rejections or liveness failures per session
         this._confirmRetries = 0;
         this._livenessFailures = 0;
         // IVS result stored for confirm_identity screen
@@ -282,9 +282,9 @@ export class SmartComplyFlow {
         this._ocrExpirySoon = false;
         // Camera pre-warm stream (created during confirmation screen, used in liveness)
         this._prewarmedStream = null;
-        // OCR gate poll timer — stored so it can be cancelled on navigation or close
+        // OCR gate poll timer — stored so it can be cancelled on navigation or close
         this._ocrPollTimer = null;
-        // UI timeout from _startStatusPolling — stored so close() can cancel it
+        // UI timeout from _startStatusPolling — stored so close() can cancel it
         this._uiTimeoutId = null;
         // Session expiry
         this.sessionExpiryTimer = null;
@@ -354,7 +354,7 @@ export class SmartComplyFlow {
                 try {
                     this.overlay?.remove();
                 }
-                catch (_) { /* extension interference — safe to ignore */ }
+                catch (_) { /* extension interference — safe to ignore */ }
                 this.overlay = null;
                 this.modal = null;
                 this.contentArea = null;
@@ -362,9 +362,9 @@ export class SmartComplyFlow {
         }
         this.options.onClose?.();
     }
-    // ─────────────────────────────────────────────────────────────────
+    // ─────────────────────────────────────────────────────────────────
     // Initialization
-    // ─────────────────────────────────────────────────────────────────
+    // ─────────────────────────────────────────────────────────────────
     mount() {
         // Inject keyframes
         this.injectStyles();
@@ -449,7 +449,7 @@ export class SmartComplyFlow {
             }
             // Load config
             this.sdkConfig = await this.sdk.initializeConfig();
-            // Apply theme from config — use theme_hex to override primary colour if set
+            // Apply theme from config — use theme_hex to override primary colour if set
             if (this.sdkConfig.theme) {
                 this.theme = getTheme(this.sdkConfig.theme, this.sdkConfig.theme_hex || null);
                 this.applyTheme();
@@ -466,9 +466,9 @@ export class SmartComplyFlow {
             this.showErrorStep(err.message || "Failed to initialize. Please try again.");
         }
     }
-    // ─────────────────────────────────────────────────────────────────
+    // ─────────────────────────────────────────────────────────────────
     // Step rendering
-    // ─────────────────────────────────────────────────────────────────
+    // ─────────────────────────────────────────────────────────────────
     showStep(step) {
         this.currentStep = step;
         if (!this.contentArea)
@@ -479,7 +479,7 @@ export class SmartComplyFlow {
             this._ocrPollTimer = null;
         }
         // Release a pre-warmed camera stream if we're navigating anywhere other
-        // than liveness (the only step that consumes it) — otherwise "No, use a
+        // than liveness (the only step that consumes it) — otherwise "No, use a
         // different ID" / "No, retake document" / header back-button leave the
         // camera held open indefinitely with no consumer.
         if (step !== "liveness" && this._prewarmedStream) {
@@ -536,7 +536,7 @@ export class SmartComplyFlow {
                 this.renderDocumentConfirm(wrapper);
                 break;
             case "processing":
-                // C1: processing step is dead code — flow now goes to 'done' after submit
+                // C1: processing step is dead code — flow now goes to 'done' after submit
                 break;
             case "liveness":
                 this.renderLiveness(wrapper);
@@ -545,7 +545,7 @@ export class SmartComplyFlow {
                 this.renderDone(wrapper);
                 break;
             case "result":
-                // C2: result step is dead code — showResult/renderResult removed
+                // C2: result step is dead code — showResult/renderResult removed
                 break;
             case "error":
                 break;
@@ -557,7 +557,7 @@ export class SmartComplyFlow {
             wrapper.style.transform = "translateX(0)";
         });
     }
-    // ── Loading ─────────────────────────────────────────────────────
+    // ── Loading ─────────────────────────────────────────────────────
     renderLoading(container) {
         container.style.cssText += "display:flex;flex-direction:column;align-items:center;justify-content:center;min-height:300px;gap:16px;";
         const spinnerWrap = document.createElement("div");
@@ -588,7 +588,7 @@ export class SmartComplyFlow {
         sub.textContent = "Connecting to the verification service...";
         container.appendChild(sub);
     }
-    // ── Welcome ────────────────────────────────────────────────────
+    // ── Welcome ────────────────────────────────────────────────────
     renderWelcome(container) {
         container.style.cssText += "display:flex;flex-direction:column;align-items:center;text-align:center;gap:12px;";
         const isDocFlow = this.isDocumentFlow();
@@ -603,7 +603,7 @@ export class SmartComplyFlow {
       background:linear-gradient(135deg,${this.theme.primary}22,${this.theme.primaryGlow});
       border:1.5px solid ${this.theme.primary}33;
     `;
-        iconWrap.textContent = isDocFlow ? "🪪" : "🛡️";
+        iconWrap.textContent = isDocFlow ? "🪪" : "🛡️";
         topRow.appendChild(iconWrap);
         const badge = document.createElement("div");
         badge.style.cssText = `
@@ -614,7 +614,7 @@ export class SmartComplyFlow {
       color:${this.theme.primary};
       border:1px solid ${this.theme.primary}30;
     `;
-        badge.textContent = isDocFlow ? "📄  Document Verification" : "🔍  Data Verification";
+        badge.textContent = isDocFlow ? "📄  Document Verification" : "🔍  Data Verification";
         topRow.appendChild(badge);
         container.appendChild(topRow);
         // Title + subtitle (compact)
@@ -641,17 +641,17 @@ export class SmartComplyFlow {
             : "You'll need your ID number and camera access. This takes about 2 minutes.";
         titleWrap.appendChild(desc);
         container.appendChild(titleWrap);
-        // Steps preview — compact rows
+        // Steps preview — compact rows
         const steps = isDocFlow
             ? [
-                { icon: "🪪", text: "Choose your document type", sub: "Passport, National ID, Driver License" },
-                { icon: "📷", text: "Scan your document", sub: "Upload or capture a photo of your ID" },
-                { icon: "🤳", text: "Face check", sub: "Quick selfie to confirm it's you" },
+                { icon: "🪪", text: "Choose your document type", sub: "Passport, National ID, Driver License" },
+                { icon: "📷", text: "Scan your document", sub: "Upload or capture a photo of your ID" },
+                { icon: "🤳", text: "Face check", sub: "Quick selfie to confirm it's you" },
             ]
             : [
-                { icon: "🆔", text: "Choose your ID type", sub: "NIN, BVN, Voter's Card and more" },
-                { icon: "📝", text: "Enter your ID details", sub: "Exactly as shown on your ID" },
-                { icon: "🤳", text: "Face check", sub: "Quick selfie to confirm it's you" },
+                { icon: "🆔", text: "Choose your ID type", sub: "NIN, BVN, Voter's Card and more" },
+                { icon: "📝", text: "Enter your ID details", sub: "Exactly as shown on your ID" },
+                { icon: "🤳", text: "Face check", sub: "Quick selfie to confirm it's you" },
             ];
         const stepsWrap = document.createElement("div");
         stepsWrap.style.cssText = `
@@ -692,21 +692,21 @@ export class SmartComplyFlow {
         });
         container.appendChild(stepsWrap);
         // CTA
-        const btn = this.createPrimaryButton("Get Started →");
+        const btn = this.createPrimaryButton("Get Started →");
         btn.style.cssText += "margin-top:2px;";
         btn.addEventListener("click", () => this.showStep("country"));
         container.appendChild(btn);
-        // Trust badge — "Powered by Adhere" already lives in the persistent
+        // Trust badge — "Powered by Adhere" already lives in the persistent
         // modal footer below; repeating it here just cost vertical space.
         const trust = document.createElement("div");
         trust.style.cssText = `
       display:flex;align-items:center;gap:6px;
       color:${this.theme.textMuted};font-size:10.5px;
     `;
-        trust.textContent = "🔒  End-to-end encrypted";
+        trust.textContent = "🔒  End-to-end encrypted";
         container.appendChild(trust);
     }
-    // ── Country Select ──────────────────────────────────────────────
+    // ── Country Select ──────────────────────────────────────────────
     renderCountrySelect(container) {
         container.style.cssText += "display:flex;flex-direction:column;gap:14px;";
         const channels = this.sdkConfig?.channels || {};
@@ -731,7 +731,7 @@ export class SmartComplyFlow {
             container.appendChild(card);
         }
     }
-    // ── ID Type Select ──────────────────────────────────────────────
+    // ── ID Type Select ──────────────────────────────────────────────
     renderIdTypeSelect(container) {
         container.style.cssText += "display:flex;flex-direction:column;gap:14px;";
         const globalDocFlow = this.isDocumentFlow();
@@ -759,9 +759,9 @@ export class SmartComplyFlow {
             // Add back side indicator to subtitle if needed
             let subtitle = info.desc;
             if (requiresBack && isThisDocFlow) {
-                subtitle += " ⚠️ Both sides required";
+                subtitle += " ⚠️ Both sides required";
             }
-            // Clean display name — strip "with face", "(NIN)", "(BVN)" from user-visible label
+            // Clean display name — strip "with face", "(NIN)", "(BVN)" from user-visible label
             const displayName = typeName
                 .replace(/\s*with\s+face\s*/gi, ' ')
                 .replace(/\s*\(NIN\)\s*/gi, ' ')
@@ -798,7 +798,7 @@ export class SmartComplyFlow {
             container.appendChild(card);
         }
     }
-    // ── ID Input (data verification — dynamic fields) ─────────────
+    // ── ID Input (data verification — dynamic fields) ─────────────
     renderIdInput(container) {
         container.style.cssText += "display:flex;flex-direction:column;gap:14px;";
         const dataFields = this.selectedChannelFields.filter((f) => f.type !== "upload");
@@ -817,7 +817,7 @@ export class SmartComplyFlow {
             ? `Enter your ${this.selectedIdTypeName || this.selectedIdType} details exactly as they appear on your ID.`
             : "Fill in the fields below to continue.";
         container.appendChild(subtitle);
-        // Edge case: no data fields configured — show fallback and allow submission
+        // Edge case: no data fields configured — show fallback and allow submission
         if (dataFields.length === 0) {
             const empty = document.createElement("div");
             empty.style.cssText = `
@@ -836,13 +836,13 @@ export class SmartComplyFlow {
             { match: "BVN", rule: { minLen: 11, maxLen: 11, numeric: true, hint: "BVN must be exactly 11 digits" } },
             { match: "NIN", rule: { minLen: 11, maxLen: 11, numeric: true, hint: "NIN must be exactly 11 digits" } },
             { match: "NATIONAL IDENTITY", rule: { minLen: 11, maxLen: 11, numeric: true, hint: "NIN must be exactly 11 digits" } },
-            { match: "PASSPORT", rule: { minLen: 6, maxLen: 20, alphanumeric: true, hint: "Passport number must be 6–20 alphanumeric characters" } },
-            { match: "DRIVER", rule: { minLen: 3, maxLen: 30, alphanumeric: true, hint: "Licence number must be 3–30 alphanumeric characters" } },
-            { match: "VOTER", rule: { minLen: 6, maxLen: 30, alphanumeric: true, hint: "Voter ID must be 6–30 alphanumeric characters" } },
-            { match: "GHANA", rule: { minLen: 8, maxLen: 20, alphanumeric: true, hint: "Ghana Card number must be 8–20 alphanumeric characters" } },
-            { match: "SSNIT", rule: { minLen: 7, maxLen: 15, alphanumeric: true, hint: "SSNIT number must be 7–15 alphanumeric characters" } },
-            { match: "TIN", rule: { minLen: 8, maxLen: 20, alphanumeric: true, hint: "TIN must be 8–20 characters" } },
-            { match: "KRA", rule: { minLen: 10, maxLen: 12, alphanumeric: true, hint: "KRA PIN must be 10–12 characters" } },
+            { match: "PASSPORT", rule: { minLen: 6, maxLen: 20, alphanumeric: true, hint: "Passport number must be 6–20 alphanumeric characters" } },
+            { match: "DRIVER", rule: { minLen: 3, maxLen: 30, alphanumeric: true, hint: "Licence number must be 3–30 alphanumeric characters" } },
+            { match: "VOTER", rule: { minLen: 6, maxLen: 30, alphanumeric: true, hint: "Voter ID must be 6–30 alphanumeric characters" } },
+            { match: "GHANA", rule: { minLen: 8, maxLen: 20, alphanumeric: true, hint: "Ghana Card number must be 8–20 alphanumeric characters" } },
+            { match: "SSNIT", rule: { minLen: 7, maxLen: 15, alphanumeric: true, hint: "SSNIT number must be 7–15 alphanumeric characters" } },
+            { match: "TIN", rule: { minLen: 8, maxLen: 20, alphanumeric: true, hint: "TIN must be 8–20 characters" } },
+            { match: "KRA", rule: { minLen: 10, maxLen: 12, alphanumeric: true, hint: "KRA PIN must be 10–12 characters" } },
         ];
         function getFieldRule(label) {
             const upper = label.toUpperCase();
@@ -870,7 +870,7 @@ export class SmartComplyFlow {
         // Track input elements for validation
         const inputEls = [];
         for (const field of dataFields) {
-            // Send the raw label as the payload key — the backend's
+            // Send the raw label as the payload key — the backend's
             // _SDK_FIELD_KEY_MAP looks up the exact label text (e.g. "National ID",
             // "CAC Number") to remap it to the canonical IVS key. Pre-normalizing
             // it here (as this used to do) produced keys like "national_id" that
@@ -920,7 +920,7 @@ export class SmartComplyFlow {
                 inputEls.push({ field, el: select });
             }
             else if (field.type === "image" || field.type === "file") {
-                // File upload field — converts to base64 for API submission
+                // File upload field — converts to base64 for API submission
                 const fileInput = document.createElement("input");
                 fileInput.type = "file";
                 fileInput.accept = "image/*";
@@ -1070,14 +1070,14 @@ export class SmartComplyFlow {
                     this._ivsName = [nd.first_name || nd.firstname || "", nd.last_name || nd.lastname || nd.surname || ""]
                         .map(s => String(s || "").trim()).filter(Boolean).join(" ");
                     this._ivsGender = nd.gender || "";
-                    // W4: If IVS returned no name, there is nothing for the user to confirm —
+                    // W4: If IVS returned no name, there is nothing for the user to confirm —
                     // auto-proceed straight to Stage 2 (liveness) instead of showing a
                     // confirmation screen with no identity details to check.
                     if (!this._ivsName) {
                         this.showStep("liveness");
                         return;
                     }
-                    // Route to confirmation screen — user must confirm before liveness
+                    // Route to confirmation screen — user must confirm before liveness
                     this.showStep("confirm_identity");
                 }
                 else {
@@ -1089,10 +1089,10 @@ export class SmartComplyFlow {
                 }
             }
             catch (err) {
-                // Show a single plain-language error — never raw field:message format
+                // Show a single plain-language error — never raw field:message format
                 const fieldErrors = err.data?.errors;
                 if (Array.isArray(fieldErrors) && fieldErrors.length > 0) {
-                    // Pick the first meaningful error message — strip field prefix
+                    // Pick the first meaningful error message — strip field prefix
                     const firstMsg = fieldErrors[0]?.message || fieldErrors[0]?.detail || "";
                     errorEl.textContent = _sanitizeUserMessage(firstMsg)
                         || "Please check your details and try again.";
@@ -1123,7 +1123,7 @@ export class SmartComplyFlow {
             setTimeout(() => firstInput.focus(), 350);
         }
     }
-    // ── Document Capture ────────────────────────────────────────────
+    // ── Document Capture ────────────────────────────────────────────
     renderDocumentCapture(container) {
         container.style.cssText += "display:flex;flex-direction:column;gap:14px;";
         // Strip "with face", "(NIN)", "(BVN)" noise from the user-visible title
@@ -1164,7 +1164,7 @@ export class SmartComplyFlow {
             this.showErrorStep(err.message || "Document capture failed. Please try again.");
         });
     }
-    // ── W3: Identity Confirmation (data verification) ───────────────
+    // ── W3: Identity Confirmation (data verification) ───────────────
     renderConfirmIdentity(container) {
         container.style.cssText += "display:flex;flex-direction:column;align-items:center;text-align:center;gap:16px;padding:8px 0;";
         // W14: Check retry limit before showing screen
@@ -1176,7 +1176,7 @@ export class SmartComplyFlow {
         this._prewarmCamera();
         const iconWrap = document.createElement("div");
         iconWrap.style.cssText = `width:64px;height:64px;border-radius:50%;background:${this.theme.primary}15;border:2px solid ${this.theme.primary}30;display:flex;align-items:center;justify-content:center;font-size:28px;`;
-        iconWrap.textContent = "🛡️";
+        iconWrap.textContent = "🛡️";
         container.appendChild(iconWrap);
         const title = document.createElement("h2");
         title.style.cssText = `color:${this.theme.text};font-size:18px;font-weight:700;margin:0;`;
@@ -1215,7 +1215,7 @@ export class SmartComplyFlow {
             sub.textContent = "Your details have been confirmed. Please continue to the face check.";
             container.appendChild(sub);
         }
-        const yesBtn = this.createPrimaryButton("Yes, that's me — continue");
+        const yesBtn = this.createPrimaryButton("Yes, that's me — continue");
         yesBtn.addEventListener("click", () => {
             // B5: Reset retry counter on successful confirmation
             this._confirmRetries = 0;
@@ -1233,7 +1233,7 @@ export class SmartComplyFlow {
         });
         container.appendChild(noBtn);
     }
-    // ── W4: Document Confirmation (document verification) ────────────
+    // ── W4: Document Confirmation (document verification) ────────────
     renderDocumentConfirm(container) {
         container.style.cssText += "display:flex;flex-direction:column;align-items:center;text-align:center;gap:14px;padding:8px 0;";
         // W14: Check retry limit
@@ -1245,7 +1245,7 @@ export class SmartComplyFlow {
         this._prewarmCamera();
         const iconWrap = document.createElement("div");
         iconWrap.style.cssText = `width:64px;height:64px;border-radius:50%;background:${this.theme.primary}15;border:2px solid ${this.theme.primary}30;display:flex;align-items:center;justify-content:center;font-size:28px;`;
-        iconWrap.textContent = "📄";
+        iconWrap.textContent = "📄";
         container.appendChild(iconWrap);
         const title = document.createElement("h2");
         title.style.cssText = `color:${this.theme.text};font-size:18px;font-weight:700;margin:0;`;
@@ -1270,10 +1270,10 @@ export class SmartComplyFlow {
         if (this._ocrExpirySoon && !this._ocrIsExpired) {
             const warn = document.createElement("div");
             warn.style.cssText = `width:100%;padding:10px 14px;border-radius:10px;background:${this.theme.warning}18;border:1px solid ${this.theme.warning}40;color:${this.theme.warning};font-size:12px;text-align:left;line-height:1.5;`;
-            warn.textContent = "⚠️  Your document expires soon. Some services may not accept it, but you can still continue.";
+            warn.textContent = "⚠️  Your document expires soon. Some services may not accept it, but you can still continue.";
             container.appendChild(warn);
         }
-        // Details card — show whatever OCR returned, never block on missing fields
+        // Details card — show whatever OCR returned, never block on missing fields
         const card = document.createElement("div");
         card.style.cssText = `width:100%;padding:14px 16px;border-radius:14px;background:${this.theme.cardBg};border:1.5px solid ${this.theme.border};text-align:left;display:flex;flex-direction:column;gap:10px;`;
         const docRows = [];
@@ -1331,7 +1331,7 @@ export class SmartComplyFlow {
         });
         container.appendChild(noBtn);
     }
-    // ── W6+W7+W8: OCR Gate (document verification) ───────────────────
+    // ── W6+W7+W8: OCR Gate (document verification) ───────────────────
     renderOcrGate(container) {
         container.style.cssText += "display:flex;flex-direction:column;align-items:center;gap:14px;padding:20px 0;text-align:center;";
         const spinnerWrap = document.createElement("div");
@@ -1340,18 +1340,18 @@ export class SmartComplyFlow {
         ring.style.cssText = `position:absolute;inset:0;border-radius:50%;border:3px solid ${this.theme.border};border-top-color:${this.theme.primary};animation:sc-spin 0.9s linear infinite;`;
         const centre = document.createElement("div");
         centre.style.cssText = "position:absolute;inset:0;display:flex;align-items:center;justify-content:center;font-size:20px;";
-        centre.textContent = "📄";
+        centre.textContent = "📄";
         spinnerWrap.appendChild(ring);
         spinnerWrap.appendChild(centre);
         container.appendChild(spinnerWrap);
         const statusEl = document.createElement("div");
         statusEl.setAttribute("aria-live", "polite");
         statusEl.style.cssText = `color:${this.theme.text};font-size:15px;font-weight:600;`;
-        statusEl.textContent = "Reading your document…";
+        statusEl.textContent = "Reading your document…";
         container.appendChild(statusEl);
         const subEl = document.createElement("div");
         subEl.style.cssText = `color:${this.theme.textSecondary};font-size:12px;max-width:260px;line-height:1.5;`;
-        subEl.textContent = "This usually takes 5–15 seconds. Please wait.";
+        subEl.textContent = "This usually takes 5–15 seconds. Please wait.";
         container.appendChild(subEl);
         if (!this.livenessEntryId) {
             this.showErrorStep("Document upload failed. Please try again.");
@@ -1366,19 +1366,19 @@ export class SmartComplyFlow {
             polls++;
             try {
                 const result = await this.sdk.liveness.pollResult(entryId);
-                // W7: Expired document — stop, do not proceed to liveness
+                // W7: Expired document — stop, do not proceed to liveness
                 if (result.is_expired === true) {
                     container.innerHTML = "";
                     this._renderExpiredDocument(container);
                     return;
                 }
-                // W8: OCR quality fail — offer retake
+                // W8: OCR quality fail — offer retake
                 if (result.ocr_quality_failed === true) {
                     container.innerHTML = "";
                     this._renderOcrQualityFail(container, result.ocr_rejection_reason);
                     return;
                 }
-                // OCR complete — store data and show confirmation screen
+                // OCR complete — store data and show confirmation screen
                 const ocrDone = result.ocr_status === "done" || result.ocr_status === "ocr_complete"
                     || result.ocr_name || result.ocr_document_number || result.ocr_expiry_date;
                 if (ocrDone) {
@@ -1387,7 +1387,7 @@ export class SmartComplyFlow {
                     this._ocrExpiry = result.ocr_expiry_date || "";
                     this._ocrFaceImageUrl = result.ocr_face_image_url || "";
                     this._ocrIsExpired = result.is_expired === true;
-                    // B8: Normalise expiry date string before parsing — OCR may return
+                    // B8: Normalise expiry date string before parsing — OCR may return
                     // DD/MM/YYYY, DD-MM-YYYY, YYYY-MM-DD, or "12 May 2029" etc.
                     // new Date() alone is locale-dependent on non-ISO strings.
                     if (this._ocrExpiry) {
@@ -1401,14 +1401,14 @@ export class SmartComplyFlow {
                     this.showStep("document_confirm");
                     return;
                 }
-                // Still pending — keep polling
+                // Still pending — keep polling
                 if (polls < MAX_POLLS && !this.isDestroyed) {
                     this._ocrPollTimer = setTimeout(poll, 2000);
                 }
                 else if (!this.isDestroyed) {
-                    // Timeout — proceed anyway with whatever we have
-                    statusEl.textContent = "Taking longer than usual…";
-                    subEl.textContent = "We'll continue — you can confirm your details on the next screen.";
+                    // Timeout — proceed anyway with whatever we have
+                    statusEl.textContent = "Taking longer than usual…";
+                    subEl.textContent = "We'll continue — you can confirm your details on the next screen.";
                     this._ocrPollTimer = setTimeout(() => {
                         if (!this.isDestroyed)
                             this.showStep("document_confirm");
@@ -1424,14 +1424,14 @@ export class SmartComplyFlow {
                 }
             }
         };
-        // First poll after 3s — give OCR submission time to start
+        // First poll after 3s — give OCR submission time to start
         this._ocrPollTimer = setTimeout(poll, 3000);
     }
     _renderExpiredDocument(container) {
         container.style.cssText += "display:flex;flex-direction:column;align-items:center;text-align:center;gap:14px;padding:20px 0;";
         const icon = document.createElement("div");
         icon.style.cssText = `width:72px;height:72px;border-radius:50%;background:${this.theme.errorBg};border:3px solid ${this.theme.error};display:flex;align-items:center;justify-content:center;font-size:28px;`;
-        icon.textContent = "📅";
+        icon.textContent = "📅";
         container.appendChild(icon);
         const t = document.createElement("h2");
         t.style.cssText = `color:${this.theme.text};font-size:18px;font-weight:700;margin:0;`;
@@ -1457,7 +1457,7 @@ export class SmartComplyFlow {
         container.style.cssText += "display:flex;flex-direction:column;align-items:center;text-align:center;gap:14px;padding:20px 0;";
         const icon = document.createElement("div");
         icon.style.cssText = `width:72px;height:72px;border-radius:50%;background:${this.theme.errorBg};border:3px solid ${this.theme.error};display:flex;align-items:center;justify-content:center;font-size:28px;`;
-        icon.textContent = "🔍";
+        icon.textContent = "🔍";
         container.appendChild(icon);
         const t = document.createElement("h2");
         t.style.cssText = `color:${this.theme.text};font-size:18px;font-weight:700;margin:0;`;
@@ -1481,14 +1481,14 @@ export class SmartComplyFlow {
         });
         container.appendChild(retryBtn);
     }
-    // ── W11: You're all done (end-user final screen) ─────────────────
+    // ── W11: You're all done (end-user final screen) ─────────────────
     renderDone(container) {
         container.style.cssText += "display:flex;flex-direction:column;align-items:center;text-align:center;gap:16px;padding:24px 0;";
         container.setAttribute("role", "status");
-        // B7: Fire onComplete immediately when the done screen renders — the end
+        // B7: Fire onComplete immediately when the done screen renders — the end
         // user has completed their part regardless of whether they click Close.
         // Firing here means the integrator always gets the event even if the user
-        // closes the modal via the ✕ button instead of the Close button.
+        // closes the modal via the ✕ button instead of the Close button.
         this.options.onComplete?.({
             entryId: this.livenessEntryId || 0,
             sessionId: this.sdk.sessionToken,
@@ -1498,35 +1498,34 @@ export class SmartComplyFlow {
         });
         const iconWrap = document.createElement("div");
         iconWrap.style.cssText = `width:80px;height:80px;border-radius:50%;background:${this.theme.successBg};border:3px solid ${this.theme.success};display:flex;align-items:center;justify-content:center;font-size:36px;font-weight:700;color:${this.theme.success};animation:sc-pop 0.4s ease;`;
-        iconWrap.textContent = "✓";
+        iconWrap.textContent = "✓";
         container.appendChild(iconWrap);
         const title = document.createElement("h2");
         title.style.cssText = `color:${this.theme.text};font-size:22px;font-weight:700;margin:0;`;
         title.textContent = "You're all done!";
         container.appendChild(title);
-        const brandName = this.sdkConfig?.brand_name || "the service";
         const desc = document.createElement("p");
         desc.style.cssText = `color:${this.theme.textSecondary};font-size:14px;line-height:1.6;margin:0;max-width:300px;`;
-        desc.textContent = `Your verification is complete. ${brandName} will review and be in touch shortly.`;
+        desc.textContent = "Your verification is complete.";
         container.appendChild(desc);
         // Subtle info line
         const info = document.createElement("div");
         info.style.cssText = `color:${this.theme.textMuted};font-size:11px;display:flex;align-items:center;gap:4px;`;
-        info.textContent = "🔒  Your data is encrypted and secure";
+        info.textContent = "🔒  Your data is encrypted and secure";
         container.appendChild(info);
         const doneBtn = this.createPrimaryButton("Close");
         doneBtn.addEventListener("click", () => {
-            // onComplete already fired on render — just close the modal
+            // onComplete already fired on render — just close the modal
             this.close();
         });
         container.appendChild(doneBtn);
     }
-    // ── W14: Retry limit reached ─────────────────────────────────────
+    // ── W14: Retry limit reached ─────────────────────────────────────
     _renderRetryLimitReached(container) {
         container.style.cssText += "display:flex;flex-direction:column;align-items:center;text-align:center;gap:14px;padding:24px 0;";
         const icon = document.createElement("div");
         icon.style.cssText = `width:72px;height:72px;border-radius:50%;background:${this.theme.errorBg};border:3px solid ${this.theme.error};display:flex;align-items:center;justify-content:center;font-size:28px;`;
-        icon.textContent = "⚠️";
+        icon.textContent = "⚠️";
         container.appendChild(icon);
         const t = document.createElement("h2");
         t.style.cssText = `color:${this.theme.text};font-size:18px;font-weight:700;margin:0;`;
@@ -1540,7 +1539,7 @@ export class SmartComplyFlow {
         closeBtn.addEventListener("click", () => { this.options.onError?.(new Error("Retry limit reached")); this.close(); });
         container.appendChild(closeBtn);
     }
-    // ── W13: Camera pre-warm ─────────────────────────────────────────
+    // ── W13: Camera pre-warm ─────────────────────────────────────────
     _prewarmCamera() {
         if (this._prewarmedStream || this.isDestroyed)
             return;
@@ -1560,11 +1559,11 @@ export class SmartComplyFlow {
     async processDocumentCaptureResult(result, captureContainer, container) {
         // B2+P2: Compress both images once here. Do NOT assign documentBlob twice
         // (old code set it to the raw blob first, then overwrote with compressed).
-        // processDocumentBlob also ran _compressImage — that second pass is removed
+        // processDocumentBlob also ran _compressImage — that second pass is removed
         // below so compression only happens once.
         this.documentBlob = await _compressImage(result.front, 1600, 0.85);
         this.documentBackBlob = result.back ? await _compressImage(result.back, 1600, 0.85) : null;
-        // Process the front image — pass the already-compressed blob
+        // Process the front image — pass the already-compressed blob
         await this.processDocumentBlob(this.documentBlob, captureContainer, container);
     }
     /**
@@ -1575,7 +1574,7 @@ export class SmartComplyFlow {
         let retryCount = 0;
         const attemptProcessing = async () => {
             try {
-                // Validate blob — compression already done in processDocumentCaptureResult (P2)
+                // Validate blob — compression already done in processDocumentCaptureResult (P2)
                 if (!blob || blob.size === 0) {
                     throw new Error("Failed to capture document. Please try again.");
                 }
@@ -1588,7 +1587,7 @@ export class SmartComplyFlow {
       <div style="display:flex;flex-direction:column;align-items:center;gap:14px;padding:28px 20px;">
         <div style="position:relative;width:52px;height:52px;">
           <div style="position:absolute;inset:0;border-radius:50%;border:3px solid ${this.theme.border};border-top-color:${this.theme.primary};animation:sc-spin 0.8s linear infinite;"></div>
-          <div style="position:absolute;inset:0;display:flex;align-items:center;justify-content:center;font-size:20px;">🔍</div>
+          <div style="position:absolute;inset:0;display:flex;align-items:center;justify-content:center;font-size:20px;">🔍</div>
         </div>
         <div style="color:${this.theme.text};font-size:14px;font-weight:600;">Scanning document...</div>
         <div style="color:${this.theme.textSecondary};font-size:12px;text-align:center;max-width:200px;line-height:1.5;">Running OCR and verifying your identity</div>
@@ -1596,7 +1595,7 @@ export class SmartComplyFlow {
                 // Create liveness entry with document.
                 // Use the first collected field value as identifier when available
                 // (document flow has no data-verification step, so collectedFields is
-                // empty — fall back to the selected ID type code so the webhook
+                // empty — fall back to the selected ID type code so the webhook
                 // subject.identifier is at least human-meaningful, not a raw timestamp).
                 const identifier = Object.values(this.collectedFields)[0]
                     || this.idNumber
@@ -1614,7 +1613,7 @@ export class SmartComplyFlow {
                         identifier,
                         identifier_type: this.selectedIdType,
                         country,
-                        challenge_actions: ["BLINK", "TURN_HEAD", "OPEN_MOUTH"],
+                        challenge_actions: ["BLINK"],
                         document: blob,
                         document_back: this.documentBackBlob || undefined,
                         device_type: deviceMeta.device_type,
@@ -1645,7 +1644,7 @@ export class SmartComplyFlow {
                     }
                 }
                 this.livenessEntryId = createResult.id;
-                // W6: Route to OCR gate — poll until OCR result is ready, validate
+                // W6: Route to OCR gate — poll until OCR result is ready, validate
                 // expiry/quality, then show document_confirm before liveness starts.
                 this.showStep("ocr_gate");
             }
@@ -1660,7 +1659,7 @@ export class SmartComplyFlow {
               <div style="display:flex;flex-direction:column;align-items:center;gap:16px;padding:28px 20px;text-align:center;">
                 <div style="position:relative;width:52px;height:52px;">
                   <div style="position:absolute;inset:0;border-radius:50%;border:3px solid ${this.theme.border};border-top-color:${this.theme.primary};animation:sc-spin 0.8s linear infinite;"></div>
-                  <div style="position:absolute;inset:0;display:flex;align-items:center;justify-content:center;font-size:20px;">🔄</div>
+                  <div style="position:absolute;inset:0;display:flex;align-items:center;justify-content:center;font-size:20px;">🔄</div>
                 </div>
                 <div style="color:${this.theme.text};font-size:14px;font-weight:600;">Retrying...</div>
                 <div style="color:${this.theme.textSecondary};font-size:12px;max-width:240px;line-height:1.5;">Attempt ${retryCount} of ${maxRetries}</div>
@@ -1679,7 +1678,7 @@ export class SmartComplyFlow {
         await attemptProcessing();
     }
     handleDocumentProcessingError(error, captureContainer) {
-        // Map technical errors to user-friendly messages — never pass raw error strings
+        // Map technical errors to user-friendly messages — never pass raw error strings
         let userMessage = "We could not verify your document. Please try again.";
         let canRetry = true;
         const raw = (error?.message || "").toLowerCase();
@@ -1706,13 +1705,13 @@ export class SmartComplyFlow {
             userMessage = "The document does not match the selected ID type. Please choose the correct ID type.";
         }
         if (captureContainer) {
-            // Build with DOM — never interpolate user-derived content into innerHTML
+            // Build with DOM — never interpolate user-derived content into innerHTML
             const wrap = document.createElement("div");
             wrap.style.cssText = "display:flex;flex-direction:column;align-items:center;gap:16px;padding:28px 20px;text-align:center;";
             wrap.setAttribute("role", "alert");
             const icon = document.createElement("div");
             icon.style.cssText = `width:56px;height:56px;border-radius:50%;background:${this.theme.errorBg};border:3px solid ${this.theme.error};display:flex;align-items:center;justify-content:center;font-size:26px;`;
-            icon.textContent = "🔍";
+            icon.textContent = "🔍";
             wrap.appendChild(icon);
             const titleEl = document.createElement("div");
             titleEl.style.cssText = `color:${this.theme.text};font-size:14px;font-weight:700;`;
@@ -1737,7 +1736,7 @@ export class SmartComplyFlow {
             this.showErrorStep(userMessage);
         }
     }
-    // ── Liveness ────────────────────────────────────────────────────
+    // ── Liveness ────────────────────────────────────────────────────
     renderLiveness(container) {
         container.style.cssText += "display:flex;flex-direction:column;gap:14px;";
         // W13: Check retry limit before starting another liveness attempt
@@ -1756,7 +1755,7 @@ export class SmartComplyFlow {
         livenessContainer.style.cssText = "margin:8px 0;width:100%;";
         container.appendChild(livenessContainer);
         // W9: For data verification, identity is already held by the backend via
-        // identity_check_id — the real ID number/type must not be re-sent, and the
+        // identity_check_id — the real ID number/type must not be re-sent, and the
         // backend now accepts liveness/create without them when identity_check is
         // set (see liveness.ts create(), which omits both fields entirely in that
         // case). Only build a real identifier for the non-data-verification path.
@@ -1787,9 +1786,9 @@ export class SmartComplyFlow {
                     : "liveness_only",
             // B4: pass pre-warmed stream so camera.open() is skipped
             prewarmedStream: this._prewarmedStream || undefined,
-        }, ["BLINK", "TURN_HEAD", "OPEN_MOUTH"], this.livenessEntryId || undefined)
+        }, ["BLINK"], this.livenessEntryId || undefined)
             .then((result) => {
-            // W11: After submit, end user is done — show "You're all done" screen.
+            // W11: After submit, end user is done — show "You're all done" screen.
             // Backend processing continues in background; client receives webhook.
             // Track liveness failures for retry limit (W14).
             if (result.status === "failed") {
@@ -1806,9 +1805,9 @@ export class SmartComplyFlow {
         });
     }
     renderResult(_container) {
-        // C2: Dead code — flow routes to 'done' step, not 'result'. Kept as stub.
+        // C2: Dead code — flow routes to 'done' step, not 'result'. Kept as stub.
     }
-    // ── Error ───────────────────────────────────────────────────────
+    // ── Error ───────────────────────────────────────────────────────
     showErrorStep(message) {
         this.currentStep = "error";
         if (!this.contentArea)
@@ -1827,13 +1826,13 @@ export class SmartComplyFlow {
         const isDocQuality = /blurry|blur|quality|glare|dark|bright|lighting/i.test(message);
         const isExpiredDoc = /document.*expired|expired.*document/i.test(message);
         const isFaceMatch = /face.*match|selfie.*match|does not match/i.test(message);
-        const errorIcon = isCameraErr ? "📷"
-            : isNetworkErr ? "📡"
-                : isAuthErr ? "⏱"
-                    : isDocQuality ? "🔍"
-                        : isExpiredDoc ? "📅"
-                            : isFaceMatch ? "🤳"
-                                : "✕";
+        const errorIcon = isCameraErr ? "📷"
+            : isNetworkErr ? "📡"
+                : isAuthErr ? "⏱"
+                    : isDocQuality ? "🔍"
+                        : isExpiredDoc ? "📅"
+                            : isFaceMatch ? "🤳"
+                                : "✕";
         const errorTitle = isCameraErr ? "Camera Access Required"
             : isNetworkErr ? "Connection Problem"
                 : isAuthErr ? "Session Expired"
@@ -1841,7 +1840,7 @@ export class SmartComplyFlow {
                         : isExpiredDoc ? "Document Expired"
                             : isFaceMatch ? "Face Match Failed"
                                 : "Verification Unsuccessful";
-        // Map to user-facing guidance — never show raw internal message
+        // Map to user-facing guidance — never show raw internal message
         const userMessage = isCameraErr
             ? "Please allow camera access in your browser settings and try again."
             : isNetworkErr
@@ -1888,9 +1887,9 @@ export class SmartComplyFlow {
         wrapper.appendChild(closeBtn);
         this.contentArea.appendChild(wrapper);
     }
-    // ─────────────────────────────────────────────────────────────────
+    // ─────────────────────────────────────────────────────────────────
     // UI Helpers
-    // ─────────────────────────────────────────────────────────────────
+    // ─────────────────────────────────────────────────────────────────
     createHeader() {
         const header = document.createElement("div");
         header.setAttribute("role", "banner");
@@ -1960,7 +1959,7 @@ export class SmartComplyFlow {
         header.appendChild(stepIndicator);
         // Close button
         const closeBtn = document.createElement("button");
-        closeBtn.innerHTML = "✕";
+        closeBtn.innerHTML = "✕";
         closeBtn.setAttribute("aria-label", "Close identity verification");
         closeBtn.style.cssText = `
       width:32px;height:32px;border-radius:8px;flex-shrink:0;
@@ -2041,7 +2040,7 @@ export class SmartComplyFlow {
         }
         const arrow = document.createElement("span");
         arrow.style.cssText = `color:${this.theme.textMuted};font-size:18px;flex-shrink:0;`;
-        arrow.textContent = "→";
+        arrow.textContent = "→";
         card.appendChild(textWrap);
         card.appendChild(arrow);
         return card;
@@ -2086,7 +2085,7 @@ export class SmartComplyFlow {
         return btn;
     }
     isDocumentFlow() {
-        // 1. Check verification_type — handle both string and array from backend
+        // 1. Check verification_type — handle both string and array from backend
         const vType = this.sdkConfig?.verification_type;
         if (vType) {
             const types = Array.isArray(vType) ? vType : [vType];
@@ -2095,7 +2094,7 @@ export class SmartComplyFlow {
             if (types.includes("data_verification"))
                 return false;
         }
-        // 2. Fallback: inspect channel fields — any upload field = document flow
+        // 2. Fallback: inspect channel fields — any upload field = document flow
         const channels = this.sdkConfig?.channels || {};
         const allFields = Object.values(channels)
             .flat()
@@ -2106,7 +2105,7 @@ export class SmartComplyFlow {
         const isDocFlow = this.isDocumentFlow();
         const countries = Object.keys(this.sdkConfig?.channels || {});
         const singleCountry = countries.length <= 1;
-        // Two-stage action steps — Stage 1: validate identity, Stage 2: liveness
+        // Two-stage action steps — Stage 1: validate identity, Stage 2: liveness
         const stage1Steps = isDocFlow
             ? ["country", "id_type", "document_capture", "ocr_gate", "document_confirm"].filter(s => !(s === "country" && singleCountry))
             : ["country", "id_type", "id_input", "confirm_identity"].filter(s => !(s === "country" && singleCountry));
@@ -2126,7 +2125,7 @@ export class SmartComplyFlow {
                 this.stepLabel.textContent = "";
             }
             else if (this.currentStep === "done" || this.currentStep === "result") {
-                this.stepLabel.textContent = "Complete ✓";
+                this.stepLabel.textContent = "Complete ✓";
             }
             else if (stage2Steps.includes(this.currentStep)) {
                 this.stepLabel.textContent = "Stage 2 of 2: Face Check";
@@ -2138,7 +2137,7 @@ export class SmartComplyFlow {
                 this.stepLabel.textContent = "";
             }
         }
-        // W3: Stage dots — dot 1 lights once Stage 1 is reached, dot 2 once Stage 2 is reached
+        // W3: Stage dots — dot 1 lights once Stage 1 is reached, dot 2 once Stage 2 is reached
         if (this.stageDots) {
             const dots = Array.from(this.stageDots.children);
             const inStage1 = stage1Steps.includes(this.currentStep);
@@ -2151,7 +2150,7 @@ export class SmartComplyFlow {
             if (dots[1])
                 dots[1].style.background = stage2Active ? this.theme.primary : this.theme.border;
         }
-        // Back button — show for navigable steps only
+        // Back button — show for navigable steps only
         if (this.headerBackBtn) {
             const backTargets = {
                 id_type: () => this.showStep(countries.length > 1 ? "country" : "welcome"),