@tn3w/openage 1.0.4 → 1.0.5

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@tn3w/openage",
-    "version": "1.0.4",
+    "version": "1.0.5",
     "description": "Privacy-first age verification widget. On-device face analysis with liveness detection.",
     "type": "module",
     "main": "dist/openage.umd.js",

package/src/challenge.js

@@ -27,6 +27,7 @@ import {
 import {
     BURST_FRAMES,
     BURST_INTERVAL_MS,
+    ERROR_STEP_SECONDS,
     MAX_RETRIES,
     MOTION_CAPTURE_MS,
     MOTION_SAMPLE_MS,
@@ -110,6 +111,64 @@ function sleep(ms) {
     return new Promise((r) => setTimeout(r, ms));
 }
 
+function resolveChallengeErrorMessage(error) {
+    const name = typeof error?.name === 'string' ? error.name : '';
+    const message = typeof error?.message === 'string' ? error.message : String(error || '');
+    const normalized = `${name} ${message}`.toLowerCase();
+
+    if (
+        name === 'NotFoundError' ||
+        /request is not allowed by the user agent or the platform in the current context/.test(
+            normalized
+        ) ||
+        /requested device not found|device not found|no camera|could not start video source/.test(
+            normalized
+        )
+    ) {
+        return 'No camera available. Plug in a camera and try again.';
+    }
+
+    if (
+        name === 'NotAllowedError' ||
+        name === 'PermissionDeniedError' ||
+        /permission|camera access|access denied/.test(normalized)
+    ) {
+        return 'Camera access was blocked. Allow camera access and try again.';
+    }
+
+    if (/positioning timeout/.test(normalized)) {
+        return 'Face positioning timed out. Reopen the check and try again.';
+    }
+
+    return 'Verification failed. Please try again.';
+}
+
+async function showErrorStep(widget, error) {
+    const message = resolveChallengeErrorMessage(error);
+
+    if (!widget.popup) {
+        widget.openPopup?.();
+    }
+
+    widget.showError?.(message);
+
+    for (let seconds = ERROR_STEP_SECONDS; seconds > 0; seconds--) {
+        if (!widget.popup) break;
+        widget.setErrorCountdown?.(seconds);
+        await sleep(1000);
+    }
+
+    widget.closePopup?.();
+    widget.setState?.('retry');
+}
+
+async function handleChallengeError(widget, emitter, error) {
+    console.log('Error during challenge:', error);
+    await showErrorStep(widget, error);
+    emitter.emit('error', error, widget.id);
+    widget.params.errorCallback?.(error);
+}
+
 export async function runChallenge(widget, emitter) {
     const mode = widget.params.mode || 'serverless';
 
@@ -190,10 +249,7 @@ async function runServerless(widget, emitter) {
         emitResult(widget, emitter, result);
     } catch (error) {
         cleanupLocal();
-        console.log('Error during challenge:', error);
-        widget.showResult('fail', 'Verification failed');
-        emitter.emit('error', error, widget.id);
-        params.errorCallback?.(error);
+        await handleChallengeError(widget, emitter, error);
     }
 }
 
@@ -324,11 +380,8 @@ async function runServer(widget, emitter) {
 
         cleanupVM(transport);
     } catch (error) {
-        console.log('Error during challenge:', error);
         cleanupVM();
-        widget.showResult('fail', 'Verification failed');
-        emitter.emit('error', error, widget.id);
-        params.errorCallback?.(error);
+        await handleChallengeError(widget, emitter, error);
     }
 }
 

package/src/constants.d.ts

@@ -8,6 +8,7 @@ export declare const FACEAPI_MODEL_CDN: string;
 export declare const DEFAULT_MIN_AGE: number;
 export declare const FAIL_FLOOR: number;
 export declare const MAX_RETRIES: number;
+export declare const ERROR_STEP_SECONDS: number;
 export declare const BURST_FRAMES: number;
 export declare const BURST_INTERVAL_MS: number;
 export declare const POSITION_CHECK_MS: number;

package/src/constants.js

@@ -1,6 +1,6 @@
 export const VERSION = '1.0.0';
 
-export const MEDIAPIPE_CDN = 'https://cdn.jsdelivr.net/npm/' + '@mediapipe/tasks-vision@0.10.17';
+export const MEDIAPIPE_CDN = 'https://cdn.jsdelivr.net/npm/@mediapipe/tasks-vision@0.10.17';
 
 export const MEDIAPIPE_WASM = `${MEDIAPIPE_CDN}/wasm`;
 
@@ -12,12 +12,13 @@ export const MEDIAPIPE_MODEL =
     'face_landmarker.task';
 
 export const FACEAPI_CDN =
-    'https://cdn.jsdelivr.net/npm/' + 'face-api.js@0.22.2/dist/face-api.min.js';
+    'https://cdn.jsdelivr.net/npm/face-api.js@0.22.2/dist/face-api.min.js';
 
 export const FACEAPI_MODEL_CDN =
-    'https://cdn.jsdelivr.net/gh/' + 'justadudewhohacks/face-api.js@master/weights';
+    'https://cdn.jsdelivr.net/gh/justadudewhohacks/face-api.js@master/weights';
 
 export const MAX_RETRIES = 3;
+export const ERROR_STEP_SECONDS = 5;
 export const BURST_FRAMES = 5;
 export const BURST_INTERVAL_MS = 200;
 export const POSITION_CHECK_MS = 100;

package/src/ui.d.ts

@@ -17,6 +17,10 @@ export declare function heroTemplate(
 
 export declare function challengeTemplate(): string;
 
+export declare function errorStepTemplate(
+  message: string
+): string;
+
 export declare function resultTemplate(
   outcome: "fail" | "retry",
   message: string

package/src/ui.js

@@ -893,6 +893,52 @@ export const STYLES = `
 .oa-result-fail { color: var(--oa-danger); }
 .oa-result-retry { color: var(--oa-warn); }
 
+.oa-error-step {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 0.7rem;
+  padding: 2rem 1.2rem;
+  background: var(--oa-surface);
+  border: 1px solid var(--oa-border);
+  border-radius: var(--oa-radius);
+  margin: 10px;
+  animation: oa-fade-in 0.4s ease;
+  text-align: center;
+}
+
+.oa-error-step-icon {
+  width: 3rem;
+  height: 3rem;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  border-radius: 999px;
+  background: rgba(239, 68, 68, 0.12);
+  color: var(--oa-danger);
+  font-size: 1.7rem;
+  line-height: 1;
+}
+
+.oa-error-step-title {
+  font-size: 1rem;
+  font-weight: 700;
+  color: var(--oa-text);
+}
+
+.oa-error-step-message {
+  font-size: 0.84rem;
+  line-height: 1.5;
+  color: var(--oa-text-muted);
+  max-width: 260px;
+}
+
+.oa-error-step-countdown {
+  font-size: 0.75rem;
+  font-weight: 600;
+  color: var(--oa-danger);
+}
+
 .oa-hidden { display: none !important; }
 
 /* ── Animations ──────────────────────────────── */
@@ -1019,6 +1065,17 @@ export function challengeTemplate() {
   `;
 }
 
+export function errorStepTemplate(message) {
+    return `
+    <div class="oa-error-step">
+      <div class="oa-error-step-icon">✕</div>
+      <div class="oa-error-step-title">Verification stopped</div>
+      <div class="oa-error-step-message">${message}</div>
+      <div class="oa-error-step-countdown"></div>
+    </div>
+  `;
+}
+
 export function resultTemplate(outcome, message) {
     const icons = {
         fail: '✕',

package/src/widget.d.ts

@@ -46,6 +46,7 @@ export declare class Widget {
     message: string
   ): void;
   showError(message: string): void;
+  setErrorCountdown(seconds: number): void;
   clearError(): void;
   setState(state: string): void;
   getToken(): string | null;

package/src/widget.js

@@ -3,6 +3,7 @@ import {
     checkboxTemplate,
     heroTemplate,
     challengeTemplate,
+    errorStepTemplate,
     resultTemplate,
     resolveTheme,
     watchTheme,
@@ -476,8 +477,20 @@ export class Widget {
         }
     }
 
-    showError() {
-        this.setState('retry');
+    showError(message) {
+        if (!this.popupElements?.body) return;
+
+        this.popupElements.body.innerHTML = errorStepTemplate(message);
+        this.popupElements.errorCountdown =
+            this.popupElements.body.querySelector('.oa-error-step-countdown');
+        this.hideActions();
+    }
+
+    setErrorCountdown(seconds) {
+        if (!this.popupElements?.errorCountdown) return;
+
+        const unit = seconds === 1 ? 'second' : 'seconds';
+        this.popupElements.errorCountdown.textContent = `Closing in ${seconds} ${unit}…`;
     }
 
     clearError() {