smartcomply-web-sdk 1.0.75 → 1.0.77

package/dist/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":"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"}

package/dist/flow/SmartComplyFlow.js

@@ -331,10 +331,12 @@ class SmartComplyFlow {
         this._uiTimeoutId = null;
         // Session expiry
         this.sessionExpiryTimer = null;
+        this.sessionExpiredTimer = null;
         // Status polling (result screen)
         this._pollStatusTimer = null;
         // Components
         this.docCapture = null;
+        this._expiryDeferrals = 0;
         this.options = options;
         this.sdk = new Smartcomply_1.SmartComply({
             apiKey: options.apiKey,
@@ -401,6 +403,10 @@ class SmartComplyFlow {
             clearTimeout(this.sessionExpiryTimer);
             this.sessionExpiryTimer = null;
         }
+        if (this.sessionExpiredTimer) {
+            clearTimeout(this.sessionExpiredTimer);
+            this.sessionExpiredTimer = null;
+        }
         if (this._pollStatusTimer) {
             clearTimeout(this._pollStatusTimer);
             this._pollStatusTimer = null;
@@ -591,6 +597,15 @@ class SmartComplyFlow {
                 const expiresMs = new Date(expiresAt).getTime() - Date.now();
                 const warnMs = Math.max(expiresMs - 120000, 0); // warn 2 min before
                 this.sessionExpiryTimer = setTimeout(() => this._showExpiryWarningWhenSafe(), warnMs);
+                // The warning above is advisory only and can defer indefinitely
+                // while the user sits on a camera-active step — without a hard
+                // stop, an ignored/deferred warning left the widget open against
+                // an already-expired backend session (SessionToken.expires_at,
+                // 30 min — see sdk/views.py's SessionToken.objects.create call)
+                // for as long as the host page stayed open. Force-close once the
+                // real deadline passes so the widget's lifetime never exceeds
+                // what the backend actually honors.
+                this.sessionExpiredTimer = setTimeout(() => this._enforceSessionExpiry(), Math.max(expiresMs, 0));
             }
             // Load config
             this.sdkConfig = await this.sdk.initializeConfig();
@@ -624,6 +639,19 @@ class SmartComplyFlow {
         }
         this.showErrorStep("Your session is about to expire. Please complete verification quickly or restart.");
     }
+    _enforceSessionExpiry() {
+        if (this.isDestroyed)
+            return;
+        const cameraActiveSteps = ["document_capture", "liveness"];
+        if (cameraActiveSteps.includes(this.currentStep) &&
+            this._expiryDeferrals < SmartComplyFlow.MAX_EXPIRY_DEFERRALS) {
+            this._expiryDeferrals += 1;
+            this.sessionExpiredTimer = setTimeout(() => this._enforceSessionExpiry(), 5000);
+            return;
+        }
+        this.showErrorStep("Your session has expired. Please restart verification.");
+        this.close();
+    }
     // ─────────────────────────────────────────────────────────────────
     // Step rendering
     // ─────────────────────────────────────────────────────────────────
@@ -742,7 +770,8 @@ class SmartComplyFlow {
     // ── Welcome ────────────────────────────────────────────────────
     renderWelcome(container) {
         container.style.cssText += "display:flex;flex-direction:column;align-items:center;text-align:center;gap:12px;";
-        const isDocFlow = this.isDocumentFlow();
+        const isLivenessOnly = this.isLivenessOnlyFlow();
+        const isDocFlow = isLivenessOnly ? false : this.isDocumentFlow();
         // Icon + badge row (side by side to save vertical space)
         const topRow = document.createElement("div");
         topRow.style.cssText = "display:flex;flex-direction:column;align-items:center;gap:8px;";
@@ -765,7 +794,9 @@ class SmartComplyFlow {
       color:${this.theme.primary};
       border:1px solid ${this.theme.primary}30;
     `;
-        badge.textContent = isDocFlow ? "📄  Document Verification" : "🔍  Data Verification";
+        badge.textContent = isLivenessOnly
+            ? "🤳  Liveness Check"
+            : isDocFlow ? "📄  Document Verification" : "🔍  Data Verification";
         topRow.appendChild(badge);
         container.appendChild(topRow);
         // Title + subtitle (compact)
@@ -787,23 +818,29 @@ class SmartComplyFlow {
       color:${this.theme.textSecondary};font-size:13px;line-height:1.5;
       margin:0 auto;max-width:300px;text-align:center;
     `;
-        desc.textContent = isDocFlow
-            ? "You'll need your document and camera access. This takes about 2 minutes."
-            : "You'll need your ID number and camera access. This takes about 2 minutes.";
+        desc.textContent = isLivenessOnly
+            ? "You'll just need camera access. This takes about 30 seconds."
+            : isDocFlow
+                ? "You'll need your document and camera access. This takes about 2 minutes."
+                : "You'll need your ID number and camera access. This takes about 2 minutes.";
         titleWrap.appendChild(desc);
         container.appendChild(titleWrap);
         // Steps preview — compact rows
-        const steps = isDocFlow
+        const steps = isLivenessOnly
             ? [
-                { 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" },
-            ];
+            : 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 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 = `
       width:100%;display:flex;flex-direction:column;gap:0;
@@ -845,7 +882,27 @@ class SmartComplyFlow {
         // CTA
         const btn = this.createPrimaryButton("Get Started →");
         btn.style.cssText += "margin-top:2px;";
-        btn.addEventListener("click", () => this.showStep("country"));
+        btn.addEventListener("click", () => {
+            if (isLivenessOnly) {
+                // Liveness-only has no channels at all, so renderCountrySelect's
+                // single-country auto-skip (countries.length === 1) never fires for
+                // it — going through "country" here would render an empty,
+                // dead-end country-picker screen. Go straight to liveness instead.
+                //
+                // selectedCountry defaults to "" and is otherwise only ever set by
+                // renderCountrySelect, which this mode never visits — renderLiveness
+                // sends it as a required, non-blank `country` field, so leaving it
+                // empty would fail create() validation before the scan even starts.
+                // There's no real country to report here (no identity lookup runs
+                // in this mode), so this is a neutral placeholder, not a claim
+                // about the user's actual location.
+                this.selectedCountry = this.selectedCountry || "global";
+                this.showStep("liveness");
+            }
+            else {
+                this.showStep("country");
+            }
+        });
         container.appendChild(btn);
         // Plain-language line on what the camera/photo is for and what happens
         // to it — shown before the "Get Started" tap that leads to the first
@@ -2389,6 +2446,21 @@ class SmartComplyFlow {
             .flatMap((ch) => ch.fields || []);
         return allFields.some((f) => isUploadFieldType(f.type));
     }
+    /**
+     * True when the SDK Config is set to skip data/document verification
+     * entirely and only run the liveness/selfie check — no country picker,
+     * no ID-type picker, no ID-number entry or document capture. Unlike
+     * isDocumentFlow(), there's no channel-shape fallback to infer this from:
+     * a liveness-only config carries no channels at all, so the only signal
+     * is verification_type itself.
+     */
+    isLivenessOnlyFlow() {
+        const vType = this.sdkConfig?.verification_type;
+        if (!vType)
+            return false;
+        const types = Array.isArray(vType) ? vType : [vType];
+        return types.includes("liveness_only");
+    }
     /**
      * The "go back one step" target for a given step, if that step is
      * navigable — shared by the header back button and the browser
@@ -2405,16 +2477,28 @@ class SmartComplyFlow {
             document_capture: () => { this.docCapture?.destroy(); this.showStep("id_type"); },
             document_confirm: () => { this.docCapture?.destroy(); this.showStep("document_capture"); },
         };
+        // liveness-only skips straight from welcome to liveness with nothing in
+        // between — deliberately no backTargets["liveness"] entry added here,
+        // so the back button stays hidden on that step in this mode, same as
+        // it already is for every other mode (liveness has no back target for
+        // document/data flows either — nothing to go back to except closing).
         return backTargets[step];
     }
     updateProgress() {
-        const isDocFlow = this.isDocumentFlow();
+        const isLivenessOnly = this.isLivenessOnlyFlow();
+        const isDocFlow = isLivenessOnly ? false : 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
-        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));
+        // Two-stage action steps — Stage 1: validate identity, Stage 2: liveness.
+        // Liveness-only has no Stage 1 at all — welcome goes straight to
+        // liveness — so stage1Steps stays empty and the progress bar reflects
+        // a genuinely single-stage flow instead of implying a step that never
+        // happens in this mode.
+        const stage1Steps = isLivenessOnly
+            ? []
+            : 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));
         const stage2Steps = ["liveness"];
         const allActionSteps = [...stage1Steps, ...stage2Steps];
         const totalSteps = allActionSteps.length;
@@ -2426,6 +2510,8 @@ class SmartComplyFlow {
             this.progressBar.style.width = `${pct}%`;
         }
         // Stage label: "Stage 1 of 2: Verify Identity" / "Stage 2 of 2: Face Check"
+        // — liveness-only has no Stage 1, so it just says "Face Check" with no
+        // "of 2" framing, since there's only ever the one stage in this mode.
         if (this.stepLabel) {
             if (this.currentStep === "loading" || this.currentStep === "welcome") {
                 this.stepLabel.textContent = "";
@@ -2434,7 +2520,7 @@ class SmartComplyFlow {
                 this.stepLabel.textContent = "Complete ✓";
             }
             else if (stage2Steps.includes(this.currentStep)) {
-                this.stepLabel.textContent = "Stage 2 of 2: Face Check";
+                this.stepLabel.textContent = isLivenessOnly ? "Face Check" : "Stage 2 of 2: Face Check";
             }
             else if (stage1Steps.includes(this.currentStep)) {
                 this.stepLabel.textContent = isDocFlow ? "Stage 1 of 2: Scan Document" : "Stage 1 of 2: Verify Identity";
@@ -2525,4 +2611,11 @@ class SmartComplyFlow {
 }
 exports.SmartComplyFlow = SmartComplyFlow;
 SmartComplyFlow.MAX_RETRIES = 3;
+// Hard stop once the backend session (SessionToken.expires_at, 30 min)
+// has actually passed. Deferred the same way as the warning above while
+// a camera is live so we don't tear down an in-progress scan, but capped
+// — the earlier warning already gave the user 2 minutes' notice, so
+// there's no reason to keep deferring past a short grace window the way
+// the advisory warning does.
+SmartComplyFlow.MAX_EXPIRY_DEFERRALS = 12; // 12 * 5s = 60s grace
 //# sourceMappingURL=SmartComplyFlow.js.map