smartcomply-web-sdk 1.0.3 → 1.0.4

package/dist/esm/utils/ImageQuality.js

@@ -0,0 +1,177 @@
+/**
+ * Image Quality Assessment for Document Capture
+ * Client-side quality checks before sending to backend
+ */
+/**
+ * Calculate image sharpness using Laplacian variance
+ * Higher values = sharper image
+ */
+export function calculateSharpness(imageData) {
+    const { width, height, data } = imageData;
+    // Convert to grayscale
+    const gray = new Uint8Array(width * height);
+    for (let i = 0; i < width * height; i++) {
+        const idx = i * 4;
+        gray[i] = Math.round(0.299 * data[idx] + 0.587 * data[idx + 1] + 0.114 * data[idx + 2]);
+    }
+    // Apply Laplacian kernel
+    const laplacian = new Float32Array(width * height);
+    let sum = 0;
+    let sumSq = 0;
+    let count = 0;
+    for (let y = 1; y < height - 1; y++) {
+        for (let x = 1; x < width - 1; x++) {
+            const idx = y * width + x;
+            // Laplacian kernel
+            const val = -1 * gray[idx - width] +
+                -1 * gray[idx - 1] +
+                4 * gray[idx] +
+                -1 * gray[idx + 1] +
+                -1 * gray[idx + width];
+            laplacian[idx] = val;
+            sum += val;
+            sumSq += val * val;
+            count++;
+        }
+    }
+    // Calculate variance
+    const mean = sum / count;
+    const variance = (sumSq / count) - (mean * mean);
+    return Math.abs(variance);
+}
+/**
+ * Detect glare (overexposed areas)
+ */
+export function detectGlare(imageData, threshold = 250) {
+    const { data } = imageData;
+    let overexposed = 0;
+    for (let i = 0; i < data.length; i += 4) {
+        const brightness = (data[i] + data[i + 1] + data[i + 2]) / 3;
+        if (brightness > threshold) {
+            overexposed++;
+        }
+    }
+    return overexposed / (data.length / 4);
+}
+/**
+ * Calculate contrast (standard deviation)
+ */
+export function calculateContrast(imageData) {
+    const { data } = imageData;
+    let sum = 0;
+    let sumSq = 0;
+    const pixelCount = data.length / 4;
+    for (let i = 0; i < data.length; i += 4) {
+        const gray = 0.299 * data[i] + 0.587 * data[i + 1] + 0.114 * data[i + 2];
+        sum += gray;
+        sumSq += gray * gray;
+    }
+    const mean = sum / pixelCount;
+    const variance = (sumSq / pixelCount) - (mean * mean);
+    return Math.sqrt(variance);
+}
+/**
+ * Calculate brightness (mean pixel value)
+ */
+export function calculateBrightness(imageData) {
+    const { data } = imageData;
+    let sum = 0;
+    for (let i = 0; i < data.length; i += 4) {
+        sum += (data[i] + data[i + 1] + data[i + 2]) / 3;
+    }
+    return sum / (data.length / 4);
+}
+/**
+ * Full quality assessment
+ */
+export function assessQuality(imageData) {
+    const sharpness = calculateSharpness(imageData);
+    const glare = detectGlare(imageData);
+    const contrast = calculateContrast(imageData);
+    const brightness = calculateBrightness(imageData);
+    const isBlurry = sharpness < 80;
+    const hasGlare = glare > 0.15;
+    const isTooDark = brightness < 50;
+    const isTooBright = brightness > 200;
+    const lowContrast = contrast < 30;
+    // Calculate overall score (0-100)
+    let score = 100;
+    if (isBlurry)
+        score -= 40;
+    if (hasGlare)
+        score -= 25;
+    if (isTooDark)
+        score -= 20;
+    if (isTooBright)
+        score -= 20;
+    if (lowContrast)
+        score -= 15;
+    const metrics = {
+        sharpness: Math.round(sharpness * 10) / 10,
+        contrast: Math.round(contrast * 10) / 10,
+        brightness: Math.round(brightness * 10) / 10,
+        isBlurry,
+        hasGlare,
+        overallScore: Math.max(0, score),
+    };
+    // Generate feedback
+    const issues = [];
+    const recommendations = [];
+    if (isBlurry) {
+        issues.push("Too blurry");
+        recommendations.push("Hold camera steady");
+        recommendations.push("Ensure good lighting");
+    }
+    if (hasGlare) {
+        issues.push("Too much glare");
+        recommendations.push("Avoid direct light on document");
+        recommendations.push("Tilt document slightly");
+    }
+    if (isTooDark) {
+        issues.push("Too dark");
+        recommendations.push("Move to brighter area");
+        recommendations.push("Turn on more lights");
+    }
+    if (isTooBright) {
+        issues.push("Too bright");
+        recommendations.push("Reduce lighting");
+        recommendations.push("Move away from direct sun");
+    }
+    if (lowContrast) {
+        issues.push("Low contrast");
+        recommendations.push("Ensure even lighting");
+    }
+    const isValid = score >= 60;
+    const message = issues.length > 0
+        ? issues.join(", ")
+        : "Good quality";
+    return {
+        isValid,
+        message,
+        recommendations: recommendations.slice(0, 3), // Max 3 recommendations
+        quality: metrics,
+    };
+}
+/**
+ * Get quality color for UI feedback
+ */
+export function getQualityColor(score) {
+    if (score >= 80)
+        return "#22c55e"; // Green
+    if (score >= 60)
+        return "#eab308"; // Yellow
+    return "#ef4444"; // Red
+}
+/**
+ * Get quality message for display
+ */
+export function getQualityMessage(score) {
+    if (score >= 80)
+        return "Excellent - Ready to capture";
+    if (score >= 60)
+        return "Good - Can capture";
+    if (score >= 40)
+        return "Fair - Improve if possible";
+    return "Poor - Please adjust";
+}
+//# sourceMappingURL=ImageQuality.js.map

package/dist/esm/utils/ImageQuality.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageQuality.js","sourceRoot":"","sources":["../../../src/utils/ImageQuality.ts"],"names":[],"mappings":"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"}

package/dist/esm/utils/constants.d.ts

@@ -0,0 +1,59 @@
+/**
+ * SDK-wide constants — single source of truth for limits, defaults and
+ * backend-defined magic values.
+ */
+export declare const ENDPOINTS: {
+    readonly SESSION_CREATE: "/v1/sdk/session/create/";
+    readonly SDK_INITIALIZE: "/v1/sdk/initialize/";
+    readonly ONBOARDING_VERIFY: "/v1/sdk/onboarding/verify/";
+    readonly LIVENESS_CREATE: "/v1/sdk/liveness/create/";
+    readonly LIVENESS_SUBMIT: "/v1/sdk/liveness/submit/";
+    readonly AVAILABLE_CHANNELS: "/v1/sdk/available-channels/";
+};
+/** Backend session TTL in milliseconds (30 minutes). */
+export declare const SESSION_TTL_MS: number;
+/** Warn the user this many ms before session expires. */
+export declare const SESSION_WARN_BEFORE_MS: number;
+/** Default request timeout in milliseconds. */
+export declare const DEFAULT_TIMEOUT_MS = 30000;
+/** Number of automatic retries on transient network errors. */
+export declare const MAX_RETRIES = 2;
+/** Delay between retries in milliseconds. */
+export declare const RETRY_DELAY_MS = 1000;
+/** Maximum document image size the backend accepts (5 MB). */
+export declare const MAX_DOCUMENT_BYTES: number;
+/** Maximum video size the backend accepts (50 MB). */
+export declare const MAX_VIDEO_BYTES: number;
+/** Maximum snapshot / autoshot size (2 MB). */
+export declare const MAX_SNAPSHOT_BYTES: number;
+/** Accepted MIME types for document images. */
+export declare const ACCEPTED_IMAGE_TYPES: readonly ["image/jpeg", "image/png", "image/webp"];
+/** JPEG quality used when encoding captured frames (0–1). */
+export declare const CAPTURE_JPEG_QUALITY = 0.92;
+/** Backend-accepted challenge actions (UPPERCASE). */
+export declare const CHALLENGE_ACTIONS: readonly ["BLINK", "TURN_LEFT", "TURN_RIGHT", "TURN_HEAD", "OPEN_MOUTH"];
+/** Default set sent when the caller does not specify actions. */
+export declare const DEFAULT_CHALLENGE_ACTIONS: readonly ["BLINK", "TURN_LEFT", "OPEN_MOUTH"];
+/** Time limit per liveness attempt in seconds. */
+export declare const LIVENESS_TIME_LIMIT_SECONDS = 45;
+/** Milliseconds to pause after all actions before capturing the final snapshot. */
+export declare const POST_ACTION_SETTLE_MS = 800;
+/** Ideal resolution for the front-facing liveness camera. */
+export declare const CAMERA_IDEAL_WIDTH = 640;
+export declare const CAMERA_IDEAL_HEIGHT = 480;
+/** Ideal resolution for rear-facing document capture camera. */
+export declare const DOC_CAMERA_IDEAL_WIDTH = 1280;
+export declare const DOC_CAMERA_IDEAL_HEIGHT = 960;
+/** Video bitrate used by MediaRecorder for liveness recordings (~1.4 MB / 45 s). */
+export declare const RECORDING_BITS_PER_SECOND = 250000;
+/** Max milliseconds to wait for an initial face detection before proceeding. */
+export declare const FACE_DETECT_TIMEOUT_MS = 10000;
+/** Polling interval for the face-present check (ms). */
+export declare const FACE_DETECT_POLL_MS = 100;
+/** How long (ms) the success overlay is shown before the flow advances. */
+export declare const RESULT_OVERLAY_DURATION_MS = 2800;
+/** localStorage key used to persist the browser fingerprint ID. */
+export declare const FINGERPRINT_STORAGE_KEY = "_adhere_fid";
+/** z-index for the SDK overlay — high enough to sit above any app content. */
+export declare const OVERLAY_Z_INDEX = 99999;
+//# sourceMappingURL=constants.d.ts.map

package/dist/esm/utils/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/utils/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,eAAO,MAAM,SAAS;;;;;;;CAOZ,CAAC;AAIX,wDAAwD;AACxD,eAAO,MAAM,cAAc,QAAiB,CAAC;AAE7C,yDAAyD;AACzD,eAAO,MAAM,sBAAsB,QAAgB,CAAC;AAIpD,+CAA+C;AAC/C,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAEzC,+DAA+D;AAC/D,eAAO,MAAM,WAAW,IAAI,CAAC;AAE7B,6CAA6C;AAC7C,eAAO,MAAM,cAAc,OAAQ,CAAC;AAIpC,8DAA8D;AAC9D,eAAO,MAAM,kBAAkB,QAAkB,CAAC;AAElD,sDAAsD;AACtD,eAAO,MAAM,eAAe,QAAmB,CAAC;AAEhD,+CAA+C;AAC/C,eAAO,MAAM,kBAAkB,QAAkB,CAAC;AAElD,+CAA+C;AAC/C,eAAO,MAAM,oBAAoB,oDAAqD,CAAC;AAEvF,6DAA6D;AAC7D,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAIzC,sDAAsD;AACtD,eAAO,MAAM,iBAAiB,0EAA2E,CAAC;AAE1G,iEAAiE;AACjE,eAAO,MAAM,yBAAyB,+CAAgD,CAAC;AAEvF,kDAAkD;AAClD,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAE9C,mFAAmF;AACnF,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAIzC,6DAA6D;AAC7D,eAAO,MAAM,kBAAkB,MAAO,CAAC;AACvC,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC,gEAAgE;AAChE,eAAO,MAAM,sBAAsB,OAAQ,CAAC;AAC5C,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C,oFAAoF;AACpF,eAAO,MAAM,yBAAyB,SAAU,CAAC;AAIjD,gFAAgF;AAChF,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAE7C,wDAAwD;AACxD,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAIvC,2EAA2E;AAC3E,eAAO,MAAM,0BAA0B,OAAQ,CAAC;AAEhD,mEAAmE;AACnE,eAAO,MAAM,uBAAuB,gBAAgB,CAAC;AAErD,8EAA8E;AAC9E,eAAO,MAAM,eAAe,QAAS,CAAC"}

package/dist/esm/utils/constants.js

@@ -0,0 +1,67 @@
+/**
+ * SDK-wide constants — single source of truth for limits, defaults and
+ * backend-defined magic values.
+ */
+// ── API endpoints ────────────────────────────────────────────────────────────
+export const ENDPOINTS = {
+    SESSION_CREATE: "/v1/sdk/session/create/",
+    SDK_INITIALIZE: "/v1/sdk/initialize/",
+    ONBOARDING_VERIFY: "/v1/sdk/onboarding/verify/",
+    LIVENESS_CREATE: "/v1/sdk/liveness/create/",
+    LIVENESS_SUBMIT: "/v1/sdk/liveness/submit/",
+    AVAILABLE_CHANNELS: "/v1/sdk/available-channels/",
+};
+// ── Session ──────────────────────────────────────────────────────────────────
+/** Backend session TTL in milliseconds (30 minutes). */
+export const SESSION_TTL_MS = 30 * 60 * 1000;
+/** Warn the user this many ms before session expires. */
+export const SESSION_WARN_BEFORE_MS = 2 * 60 * 1000;
+// ── Network ──────────────────────────────────────────────────────────────────
+/** Default request timeout in milliseconds. */
+export const DEFAULT_TIMEOUT_MS = 30000;
+/** Number of automatic retries on transient network errors. */
+export const MAX_RETRIES = 2;
+/** Delay between retries in milliseconds. */
+export const RETRY_DELAY_MS = 1000;
+// ── File uploads ─────────────────────────────────────────────────────────────
+/** Maximum document image size the backend accepts (5 MB). */
+export const MAX_DOCUMENT_BYTES = 5 * 1024 * 1024;
+/** Maximum video size the backend accepts (50 MB). */
+export const MAX_VIDEO_BYTES = 50 * 1024 * 1024;
+/** Maximum snapshot / autoshot size (2 MB). */
+export const MAX_SNAPSHOT_BYTES = 2 * 1024 * 1024;
+/** Accepted MIME types for document images. */
+export const ACCEPTED_IMAGE_TYPES = ["image/jpeg", "image/png", "image/webp"];
+/** JPEG quality used when encoding captured frames (0–1). */
+export const CAPTURE_JPEG_QUALITY = 0.92;
+// ── Liveness challenge ───────────────────────────────────────────────────────
+/** Backend-accepted challenge actions (UPPERCASE). */
+export const CHALLENGE_ACTIONS = ["BLINK", "TURN_LEFT", "TURN_RIGHT", "TURN_HEAD", "OPEN_MOUTH"];
+/** Default set sent when the caller does not specify actions. */
+export const DEFAULT_CHALLENGE_ACTIONS = ["BLINK", "TURN_LEFT", "OPEN_MOUTH"];
+/** Time limit per liveness attempt in seconds. */
+export const LIVENESS_TIME_LIMIT_SECONDS = 45;
+/** Milliseconds to pause after all actions before capturing the final snapshot. */
+export const POST_ACTION_SETTLE_MS = 800;
+// ── Camera ───────────────────────────────────────────────────────────────────
+/** Ideal resolution for the front-facing liveness camera. */
+export const CAMERA_IDEAL_WIDTH = 640;
+export const CAMERA_IDEAL_HEIGHT = 480;
+/** Ideal resolution for rear-facing document capture camera. */
+export const DOC_CAMERA_IDEAL_WIDTH = 1280;
+export const DOC_CAMERA_IDEAL_HEIGHT = 960;
+/** Video bitrate used by MediaRecorder for liveness recordings (~1.4 MB / 45 s). */
+export const RECORDING_BITS_PER_SECOND = 250000;
+// ── Face detection ───────────────────────────────────────────────────────────
+/** Max milliseconds to wait for an initial face detection before proceeding. */
+export const FACE_DETECT_TIMEOUT_MS = 10000;
+/** Polling interval for the face-present check (ms). */
+export const FACE_DETECT_POLL_MS = 100;
+// ── UI / UX ──────────────────────────────────────────────────────────────────
+/** How long (ms) the success overlay is shown before the flow advances. */
+export const RESULT_OVERLAY_DURATION_MS = 2800;
+/** localStorage key used to persist the browser fingerprint ID. */
+export const FINGERPRINT_STORAGE_KEY = "_adhere_fid";
+/** z-index for the SDK overlay — high enough to sit above any app content. */
+export const OVERLAY_Z_INDEX = 99999;
+//# sourceMappingURL=constants.js.map

package/dist/esm/utils/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/utils/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,gFAAgF;AAEhF,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,cAAc,EAAO,yBAAyB;IAC9C,cAAc,EAAO,qBAAqB;IAC1C,iBAAiB,EAAI,4BAA4B;IACjD,eAAe,EAAM,0BAA0B;IAC/C,eAAe,EAAM,0BAA0B;IAC/C,kBAAkB,EAAG,6BAA6B;CAC1C,CAAC;AAEX,gFAAgF;AAEhF,wDAAwD;AACxD,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAE7C,yDAAyD;AACzD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAEpD,gFAAgF;AAEhF,+CAA+C;AAC/C,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAM,CAAC;AAEzC,+DAA+D;AAC/D,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC;AAE7B,6CAA6C;AAC7C,MAAM,CAAC,MAAM,cAAc,GAAG,IAAK,CAAC;AAEpC,gFAAgF;AAEhF,8DAA8D;AAC9D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAElD,sDAAsD;AACtD,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAEhD,+CAA+C;AAC/C,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAElD,+CAA+C;AAC/C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,YAAY,EAAE,WAAW,EAAE,YAAY,CAAU,CAAC;AAEvF,6DAA6D;AAC7D,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAEzC,gFAAgF;AAEhF,sDAAsD;AACtD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,CAAU,CAAC;AAE1G,iEAAiE;AACjE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,YAAY,CAAU,CAAC;AAEvF,kDAAkD;AAClD,MAAM,CAAC,MAAM,2BAA2B,GAAG,EAAE,CAAC;AAE9C,mFAAmF;AACnF,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAEzC,gFAAgF;AAEhF,6DAA6D;AAC7D,MAAM,CAAC,MAAM,kBAAkB,GAAI,GAAG,CAAC;AACvC,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEvC,gEAAgE;AAChE,MAAM,CAAC,MAAM,sBAAsB,GAAI,IAAI,CAAC;AAC5C,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAE3C,oFAAoF;AACpF,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAO,CAAC;AAEjD,gFAAgF;AAEhF,gFAAgF;AAChF,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAM,CAAC;AAE7C,wDAAwD;AACxD,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEvC,gFAAgF;AAEhF,2EAA2E;AAC3E,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAK,CAAC;AAEhD,mEAAmE;AACnE,MAAM,CAAC,MAAM,uBAAuB,GAAG,aAAa,CAAC;AAErD,8EAA8E;AAC9E,MAAM,CAAC,MAAM,eAAe,GAAG,KAAM,CAAC"}

package/dist/esm/utils/device.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Collects device / browser context metadata.
+ * All values are derived from standard browser APIs — no external library needed.
+ * Sent to the backend at liveness/create so they appear in the webhook
+ * request_context block.
+ */
+export interface DeviceMetadata {
+    device_type: "mobile" | "desktop" | "tablet";
+    os_name: string;
+    browser_timezone: string;
+    fingerprint_id: string;
+}
+export declare function collectDeviceMetadata(): DeviceMetadata;
+//# sourceMappingURL=device.d.ts.map

package/dist/esm/utils/device.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../../../src/utils/device.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;CACxB;AA8BD,wBAAgB,qBAAqB,IAAI,cAAc,CAuBtD"}

package/dist/esm/utils/device.js

@@ -0,0 +1,52 @@
+function detectOs(ua) {
+    if (/Windows NT/i.test(ua))
+        return "Windows";
+    if (/Mac OS X|Macintosh/i.test(ua))
+        return "macOS";
+    if (/Android/i.test(ua))
+        return "Android";
+    if (/iPhone|iPad|iPod/i.test(ua))
+        return "iOS";
+    if (/Linux/i.test(ua))
+        return "Linux";
+    if (/CrOS/i.test(ua))
+        return "ChromeOS";
+    return "Unknown";
+}
+function getOrCreateFingerprintId() {
+    const KEY = "_adhere_fid";
+    try {
+        let fid = localStorage.getItem(KEY);
+        if (!fid) {
+            fid =
+                typeof crypto !== "undefined" && typeof crypto.randomUUID === "function"
+                    ? crypto.randomUUID()
+                    : Math.random().toString(36).slice(2) + Date.now().toString(36);
+            localStorage.setItem(KEY, fid);
+        }
+        return fid;
+    }
+    catch {
+        // localStorage unavailable (e.g. private browsing with strict settings)
+        return Math.random().toString(36).slice(2) + Date.now().toString(36);
+    }
+}
+export function collectDeviceMetadata() {
+    const ua = navigator.userAgent;
+    const isTablet = /iPad/i.test(ua) ||
+        (/Android/i.test(ua) && !/Mobile/i.test(ua));
+    const isMobile = !isTablet &&
+        /Mobi|Android|iPhone|iPod|BlackBerry|IEMobile|Opera Mini/i.test(ua);
+    const device_type = isTablet
+        ? "tablet"
+        : isMobile
+            ? "mobile"
+            : "desktop";
+    return {
+        device_type,
+        os_name: detectOs(ua),
+        browser_timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
+        fingerprint_id: getOrCreateFingerprintId(),
+    };
+}
+//# sourceMappingURL=device.js.map

package/dist/esm/utils/device.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.js","sourceRoot":"","sources":["../../../src/utils/device.ts"],"names":[],"mappings":"AAaA,SAAS,QAAQ,CAAC,EAAU;IAC1B,IAAI,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;QAAE,OAAO,SAAS,CAAC;IAC7C,IAAI,qBAAqB,CAAC,IAAI,CAAC,EAAE,CAAC;QAAE,OAAO,OAAO,CAAC;IACnD,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/C,IAAI,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAAE,OAAO,OAAO,CAAC;IACtC,IAAI,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAAE,OAAO,UAAU,CAAC;IACxC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,wBAAwB;IAC/B,MAAM,GAAG,GAAG,aAAa,CAAC;IAC1B,IAAI,CAAC;QACH,IAAI,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG;gBACD,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,UAAU;oBACtE,CAAC,CAAC,MAAM,CAAC,UAAU,EAAE;oBACrB,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YACpE,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACP,wEAAwE;QACxE,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,MAAM,EAAE,GAAG,SAAS,CAAC,SAAS,CAAC;IAE/B,MAAM,QAAQ,GACZ,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChB,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAE/C,MAAM,QAAQ,GACZ,CAAC,QAAQ;QACT,0DAA0D,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEtE,MAAM,WAAW,GAAkC,QAAQ;QACzD,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,SAAS,CAAC;IAEd,OAAO;QACL,WAAW;QACX,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;QACrB,gBAAgB,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,eAAe,EAAE,CAAC,QAAQ;QAClE,cAAc,EAAE,wBAAwB,EAAE;KAC3C,CAAC;AACJ,CAAC"}

package/dist/esm/utils/logger.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Lightweight SDK logger.
+ *
+ * Debug output is suppressed in production. Enable verbose logging by calling
+ * SDKLogger.setDebug(true) before initialising the SDK, or by setting the
+ * global flag: window.__SC_DEBUG__ = true
+ */
+export declare const SDKLogger: {
+    /** Emit an informational message (debug mode only). */
+    info(message: string, ...args: unknown[]): void;
+    /** Emit a warning (always visible). */
+    warn(message: string, ...args: unknown[]): void;
+    /** Emit an error (always visible). */
+    error(message: string, ...args: unknown[]): void;
+    /** Emit a debug trace (debug mode only — lowest priority). */
+    debug(message: string, ...args: unknown[]): void;
+    /** Log a timed group of related messages (debug mode only). */
+    group(label: string, fn: () => void): void;
+    /**
+     * Enable or disable verbose debug output at runtime.
+     *
+     * Example:
+     *   import { SDKLogger } from "smartcomply-web-sdk";
+     *   SDKLogger.setDebug(true);
+     */
+    setDebug(enabled: boolean): void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/esm/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,eAAO,MAAM,SAAS;IACpB,uDAAuD;kBACzC,MAAM,WAAW,OAAO,EAAE,GAAG,IAAI;IAK/C,uCAAuC;kBACzB,MAAM,WAAW,OAAO,EAAE,GAAG,IAAI;IAI/C,sCAAsC;mBACvB,MAAM,WAAW,OAAO,EAAE,GAAG,IAAI;IAIhD,8DAA8D;mBAC/C,MAAM,WAAW,OAAO,EAAE,GAAG,IAAI;IAKhD,+DAA+D;iBAClD,MAAM,MAAM,MAAM,IAAI,GAAG,IAAI;IAO1C;;;;;;OAMG;sBACe,OAAO,GAAG,IAAI;CAOjC,CAAC"}

package/dist/esm/utils/logger.js

@@ -0,0 +1,64 @@
+/**
+ * Lightweight SDK logger.
+ *
+ * Debug output is suppressed in production. Enable verbose logging by calling
+ * SDKLogger.setDebug(true) before initialising the SDK, or by setting the
+ * global flag: window.__SC_DEBUG__ = true
+ */
+const PREFIX = "[SmartComply SDK]";
+function isDebugEnabled() {
+    try {
+        return !!window.__SC_DEBUG__;
+    }
+    catch {
+        return false;
+    }
+}
+export const SDKLogger = {
+    /** Emit an informational message (debug mode only). */
+    info(message, ...args) {
+        if (!isDebugEnabled())
+            return;
+        console.info(`${PREFIX} ℹ ${message}`, ...args);
+    },
+    /** Emit a warning (always visible). */
+    warn(message, ...args) {
+        console.warn(`${PREFIX} ⚠ ${message}`, ...args);
+    },
+    /** Emit an error (always visible). */
+    error(message, ...args) {
+        console.error(`${PREFIX} ✖ ${message}`, ...args);
+    },
+    /** Emit a debug trace (debug mode only — lowest priority). */
+    debug(message, ...args) {
+        if (!isDebugEnabled())
+            return;
+        console.debug(`${PREFIX} ⬡ ${message}`, ...args);
+    },
+    /** Log a timed group of related messages (debug mode only). */
+    group(label, fn) {
+        if (!isDebugEnabled()) {
+            fn();
+            return;
+        }
+        console.group(`${PREFIX} ${label}`);
+        fn();
+        console.groupEnd();
+    },
+    /**
+     * Enable or disable verbose debug output at runtime.
+     *
+     * Example:
+     *   import { SDKLogger } from "smartcomply-web-sdk";
+     *   SDKLogger.setDebug(true);
+     */
+    setDebug(enabled) {
+        try {
+            window.__SC_DEBUG__ = enabled;
+        }
+        catch {
+            /* no-op in non-browser environments */
+        }
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/esm/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,GAAG,mBAAmB,CAAC;AAEnC,SAAS,cAAc;IACrB,IAAI,CAAC;QACH,OAAO,CAAC,CAAE,MAAc,CAAC,YAAY,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,uDAAuD;IACvD,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,CAAC,cAAc,EAAE;YAAE,OAAO;QAC9B,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,MAAM,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IAClD,CAAC;IAED,uCAAuC;IACvC,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,MAAM,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IAClD,CAAC;IAED,sCAAsC;IACtC,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,MAAM,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IACnD,CAAC;IAED,8DAA8D;IAC9D,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,CAAC,cAAc,EAAE;YAAE,OAAO;QAC9B,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,MAAM,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IACnD,CAAC;IAED,+DAA+D;IAC/D,KAAK,CAAC,KAAa,EAAE,EAAc;QACjC,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;YAAC,EAAE,EAAE,CAAC;YAAC,OAAO;QAAC,CAAC;QACxC,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,KAAK,EAAE,CAAC,CAAC;QACpC,EAAE,EAAE,CAAC;QACL,OAAO,CAAC,QAAQ,EAAE,CAAC;IACrB,CAAC;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,OAAgB;QACvB,IAAI,CAAC;YACF,MAAc,CAAC,YAAY,GAAG,OAAO,CAAC;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,uCAAuC;QACzC,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/esm/utils/validator.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Input validation helpers.
+ *
+ * All functions throw a descriptive Error on invalid input so callers can
+ * surface actionable messages without catching generic exceptions.
+ */
+import type { ChallengeAction } from "../types/liveness";
+/** Returns true when s is a non-empty string after trimming. */
+export declare function isNonEmpty(s: unknown): s is string;
+/**
+ * Validates that apiKey looks like a SmartComply public key.
+ * Format: pk_live_<...> or pk_test_<...>
+ */
+export declare function validateApiKey(apiKey: unknown): void;
+/** Throws if clientId is not a valid UUID v4. */
+export declare function validateClientId(clientId: unknown): void;
+/** Throws if countryCode is not a 2-letter ISO 3166-1 alpha-2 code. */
+export declare function validateCountryCode(countryCode: unknown): void;
+/** Throws if the blob is empty or exceeds the given byte limit. */
+export declare function validateFileSize(blob: Blob | File, maxBytes: number, label: string): void;
+/** Throws if the blob's MIME type is not in the accepted image types list. */
+export declare function validateImageType(blob: Blob | File, label: string): void;
+/** Combined validation for a document image blob. */
+export declare function validateDocumentBlob(blob: Blob | File): void;
+/** Combined validation for a liveness video blob. */
+export declare function validateVideoBlob(blob: Blob): void;
+/** Combined validation for a snapshot / autoshot blob. */
+export declare function validateSnapshotBlob(blob: Blob): void;
+/** Throws if any entry in actions is not a backend-accepted challenge action. */
+export declare function validateChallengeActions(actions: unknown[]): void;
+/** Type-guard that narrows a string[] to ChallengeAction[]. */
+export declare function toChallengeActions(actions: string[]): ChallengeAction[];
+/** Throws if identifier is missing or too short to be plausible. */
+export declare function validateIdentifier(identifier: unknown, minLength?: number): void;
+//# sourceMappingURL=validator.d.ts.map

package/dist/esm/utils/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/utils/validator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIzD,gEAAgE;AAChE,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,MAAM,CAElD;AAID;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CASpD;AAOD,iDAAiD;AACjD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CASxD;AAMD,uEAAuE;AACvE,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,OAAO,GAAG,IAAI,CAM9D;AAID,mEAAmE;AACnE,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,IAAI,GAAG,IAAI,EACjB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,IAAI,CAUN;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAMxE;AAED,qDAAqD;AACrD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAG5D;AAED,qDAAqD;AACrD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAElD;AAED,0DAA0D;AAC1D,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAErD;AAID,iFAAiF;AACjF,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAWjE;AAED,+DAA+D;AAC/D,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,eAAe,EAAE,CAGvE;AAID,oEAAoE;AACpE,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,OAAO,EAAE,SAAS,SAAI,GAAG,IAAI,CAS3E"}

package/dist/esm/utils/validator.js

@@ -0,0 +1,102 @@
+/**
+ * Input validation helpers.
+ *
+ * All functions throw a descriptive Error on invalid input so callers can
+ * surface actionable messages without catching generic exceptions.
+ */
+import { MAX_DOCUMENT_BYTES, MAX_VIDEO_BYTES, MAX_SNAPSHOT_BYTES, ACCEPTED_IMAGE_TYPES, CHALLENGE_ACTIONS, } from "./constants";
+// ── String helpers ───────────────────────────────────────────────────────────
+/** Returns true when s is a non-empty string after trimming. */
+export function isNonEmpty(s) {
+    return typeof s === "string" && s.trim().length > 0;
+}
+// ── API key ──────────────────────────────────────────────────────────────────
+/**
+ * Validates that apiKey looks like a SmartComply public key.
+ * Format: pk_live_<...> or pk_test_<...>
+ */
+export function validateApiKey(apiKey) {
+    if (!isNonEmpty(apiKey)) {
+        throw new Error("SDK: apiKey is required.");
+    }
+    if (!/^pk_(live|test|sandbox)_/.test(apiKey)) {
+        throw new Error('SDK: apiKey must start with "pk_live_", "pk_test_" or "pk_sandbox_".');
+    }
+}
+// ── Client ID (UUID) ─────────────────────────────────────────────────────────
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/** Throws if clientId is not a valid UUID v4. */
+export function validateClientId(clientId) {
+    if (!isNonEmpty(clientId)) {
+        throw new Error("SDK: clientId is required.");
+    }
+    if (!UUID_RE.test(clientId.trim())) {
+        throw new Error("SDK: clientId must be a valid UUID (e.g. a1b2c3d4-e5f6-7890-abcd-ef1234567890).");
+    }
+}
+// ── Country code ─────────────────────────────────────────────────────────────
+const COUNTRY_CODE_RE = /^[A-Z]{2}$/;
+/** Throws if countryCode is not a 2-letter ISO 3166-1 alpha-2 code. */
+export function validateCountryCode(countryCode) {
+    if (!isNonEmpty(countryCode) || !COUNTRY_CODE_RE.test(countryCode.trim())) {
+        throw new Error(`SDK: Invalid country code "${countryCode}". Expected a 2-letter ISO code (e.g. "NG", "GH").`);
+    }
+}
+// ── File / Blob ──────────────────────────────────────────────────────────────
+/** Throws if the blob is empty or exceeds the given byte limit. */
+export function validateFileSize(blob, maxBytes, label) {
+    if (!blob || blob.size === 0) {
+        throw new Error(`SDK: ${label} is empty. Please capture or upload a valid file.`);
+    }
+    if (blob.size > maxBytes) {
+        const limitMB = (maxBytes / (1024 * 1024)).toFixed(0);
+        throw new Error(`SDK: ${label} exceeds the ${limitMB} MB limit (file is ${(blob.size / (1024 * 1024)).toFixed(1)} MB).`);
+    }
+}
+/** Throws if the blob's MIME type is not in the accepted image types list. */
+export function validateImageType(blob, label) {
+    if (blob.type && !ACCEPTED_IMAGE_TYPES.includes(blob.type)) {
+        throw new Error(`SDK: ${label} must be a JPEG, PNG or WebP image (received "${blob.type}").`);
+    }
+}
+/** Combined validation for a document image blob. */
+export function validateDocumentBlob(blob) {
+    validateFileSize(blob, MAX_DOCUMENT_BYTES, "Document image");
+    validateImageType(blob, "Document image");
+}
+/** Combined validation for a liveness video blob. */
+export function validateVideoBlob(blob) {
+    validateFileSize(blob, MAX_VIDEO_BYTES, "Liveness video");
+}
+/** Combined validation for a snapshot / autoshot blob. */
+export function validateSnapshotBlob(blob) {
+    validateFileSize(blob, MAX_SNAPSHOT_BYTES, "Snapshot");
+}
+// ── Challenge actions ─────────────────────────────────────────────────────────
+/** Throws if any entry in actions is not a backend-accepted challenge action. */
+export function validateChallengeActions(actions) {
+    if (!Array.isArray(actions) || actions.length === 0) {
+        throw new Error("SDK: At least one challenge action is required.");
+    }
+    for (const a of actions) {
+        if (!CHALLENGE_ACTIONS.includes(a)) {
+            throw new Error(`SDK: "${a}" is not a valid challenge action. Accepted: ${CHALLENGE_ACTIONS.join(", ")}.`);
+        }
+    }
+}
+/** Type-guard that narrows a string[] to ChallengeAction[]. */
+export function toChallengeActions(actions) {
+    validateChallengeActions(actions);
+    return actions;
+}
+// ── Identifier / ID number ────────────────────────────────────────────────────
+/** Throws if identifier is missing or too short to be plausible. */
+export function validateIdentifier(identifier, minLength = 3) {
+    if (!isNonEmpty(identifier)) {
+        throw new Error("SDK: identifier is required.");
+    }
+    if (identifier.trim().length < minLength) {
+        throw new Error(`SDK: identifier must be at least ${minLength} characters long.`);
+    }
+}
+//# sourceMappingURL=validator.js.map