alphavalid-sdk 0.0.24 → 0.1.0

package/dist/ui/overlay.d.ts

@@ -12,7 +12,96 @@ export interface OverlayRenderInput {
         height: number;
     };
     valid: boolean;
-    /** Optional: debug landmark points (normalized [0..1]) */
+    /** Optional: current challenge direction for overlays that support it (e.g. Coxinha zoom hole). */
+    challenge?: {
+        direction?: 'left' | 'right' | 'up' | 'down' | 'zoomIn' | 'zoomOut';
+    };
+    /** Optional: structured debug info to be printed in an on-screen panel. */
+    debug?: {
+        status?: string;
+        ready?: boolean;
+        feedbackCode?: string;
+        challenge?: string;
+        faces?: number;
+        eyeL?: number;
+        eyeR?: number;
+        /** Total de piscadas detectadas desde que a câmera iniciou (start()). */
+        blinkCount?: number;
+        /** True quando ambos olhos estão abaixo do limiar de "fechado" (momento atual). */
+        blinkClosedNow?: boolean;
+        /** Limiar utilizado para considerar olho "fechado". */
+        blinkClosedThreshold?: number;
+        /** 0..1: progresso de hold do challenge atual (usado por overlays como o Coxinha). */
+        challengeHoldProgress?: number;
+        mouthAvg?: {
+            x: number;
+            y: number;
+        } | null;
+        jawMid?: {
+            x: number;
+            y: number;
+        } | null;
+        faceH?: number | null;
+        mouthVsJawMidRaw?: number | null;
+        mouthVsJawMidClamped?: number | null;
+        /** Ratio de sorriso detectado (0..1) */
+        mouthSmileRatio?: number;
+        /** Ponto base da "queijo" (smile calibration) */
+        cheeseBaseline?: number;
+        /** Ponto alvo da "queijo" (smile calibration) */
+        cheeseTarget?: number;
+        /** Optional: allow hiding some debug rows without disabling the whole panel. */
+        debugDraw?: {
+            cheese?: boolean;
+        };
+        currentStep?: string | null;
+        stepPassed?: boolean;
+        /** Distâncias boca->olho (esquerdo/direito) e diferença média (debug opcional). */
+        jawEyeDistL?: number;
+        jawEyeDistR?: number;
+        jawEyeDistDiff?: number;
+        jawEyeDiffTol?: number;
+        /** Campo extra para flags customizadas vindas do debug do SDK. */
+        extra?: any;
+        /**
+         * Objeto de debug detalhado para todos os valores de boca (mouth)
+         */
+        mouthDebug?: {
+            mouthPoints?: any;
+            mouthLeft?: any;
+            mouthRight?: any;
+            mouthUpper?: any;
+            mouthLower?: any;
+            mouthOpenPx?: number;
+            mouthOpenNorm?: number;
+            mouthJawLeftDist?: number;
+            mouthJawRightDist?: number;
+            mouthSmileRatio?: number;
+            mouthWidthRatio?: number;
+            mouthAvg?: any;
+            mouthVsJawMidRaw?: number;
+            mouthVsJawMidClamped?: number;
+            cheeseBaseline?: number;
+            cheeseTarget?: number;
+            mouthOpenRatio?: number;
+        };
+    };
+    /** Optional: visual hint for challenges (e.g. arrow directions). */
+    hint?: {
+        type: 'arrow';
+        direction: 'left' | 'right' | 'up' | 'down';
+        intensity?: number;
+        label?: string;
+    } | {
+        type: 'pulse';
+        label?: string;
+        intensity?: number;
+    };
+    /**
+     * Optional: debug landmark points (normalized [0..1] *in video space*).
+     * IMPORTANT: when the <video> is rendered with object-fit: cover, the displayed region is cropped.
+     * The overlay must map video-space coordinates to container-space coordinates.
+     */
     landmarks?: {
         leftEye?: Array<{
             x: number;
@@ -30,6 +119,102 @@ export interface OverlayRenderInput {
             x: number;
             y: number;
         };
+        /** Optional: nose tip (normalized video space) */
+        noseTip?: {
+            x: number;
+            y: number;
+        };
+        /** Optional: nose ridge/base points (normalized video space) */
+        nosePoints?: Array<{
+            x: number;
+            y: number;
+        }>;
+        /** Optional: outer mouth points (normalized video space) */
+        mouthPoints?: Array<{
+            x: number;
+            y: number;
+        }>;
+        /** Optional: mouth corners (normalized video space) */
+        mouthLeft?: {
+            x: number;
+            y: number;
+        };
+        mouthRight?: {
+            x: number;
+            y: number;
+        };
+        /** Optional: jawline polyline points (normalized video space) */
+        jawPoints?: Array<{
+            x: number;
+            y: number;
+        }>;
+        /** Optional: jaw side points (normalized video space) */
+        jawLeft?: {
+            x: number;
+            y: number;
+        };
+        jawRight?: {
+            x: number;
+            y: number;
+        };
+        /** Optional: jaw center (normalized video space) */
+        jawCenter?: {
+            x: number;
+            y: number;
+        };
+        /** Optional: distances (mouth corner to jaw side), normalized by eye distance */
+        mouthJawLeftDist?: number;
+        mouthJawRightDist?: number;
+        /** Pontos centrais do lábio superior (51) e inferior (57) (normalized video space). */
+        mouthUpper?: {
+            x: number;
+            y: number;
+        };
+        mouthLower?: {
+            x: number;
+            y: number;
+        };
+        /** Distância vertical absoluta (px) e normalizada por eyeDist entre lábio superior e inferior. */
+        mouthOpenPx?: number;
+        mouthOpenNorm?: number;
+        jawTopL?: {
+            x: number;
+            y: number;
+        };
+        jawTopR?: {
+            x: number;
+            y: number;
+        };
+    };
+    /**
+     * Optional: provide the underlying <video> element so the overlay can compensate object-fit cropping.
+     * If omitted, overlay assumes video fills container 1:1 (may be wrong on cover/contain).
+     */
+    video?: HTMLVideoElement;
+    /** Optional: override objectFit; if omitted we read computedStyle(video).objectFit (fallback: 'cover'). */
+    videoObjectFit?: 'cover' | 'contain' | 'fill' | 'none' | 'scale-down';
+    /**
+     * If true, overlay will mirror X coordinates (use when the underlying <video> preview is mirrored).
+     * Default: auto-detect from computedStyle(video).transform.
+     */
+    mirrored?: boolean;
+    /** If provided, draw a small analog-style axis widget showing face direction. */
+    poseVector?: {
+        /** -1..1: negative=left, positive=right (already in preview semantics if you want). */
+        x: number;
+        /** -1..1: negative=up, positive=down. */
+        y: number;
+        /** Optional: label shown under the widget (e.g. 'yawProxy' / 'center'). */
+        label?: string;
+    };
+    /** Fine-grained overlay debug toggles (allows the demo/app to enable only what it needs). */
+    landmarkDraw?: {
+        eyes?: boolean;
+        mouth?: boolean;
+        nose?: boolean;
+        jaw?: boolean;
+        mouthJaw?: boolean;
+        cheese?: boolean;
     };
 }
 export declare function createOverlay(container: HTMLElement, guideCircleRatio?: number): OverlayHandle;

package/dist/ui/overlay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../../src/ui/overlay.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;CAC9C;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9D,KAAK,EAAE,OAAO,CAAC;IACf,0DAA0D;IAC1D,SAAS,CAAC,EAAE;QACV,OAAO,CAAC,EAAE,KAAK,CAAC;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC1C,QAAQ,CAAC,EAAE,KAAK,CAAC;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC3C,aAAa,CAAC,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACzC,cAAc,CAAC,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC3C,CAAC;CACH;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,WAAW,EAAE,gBAAgB,SAAO,GAAG,aAAa,CAiP5F"}
+{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../../src/ui/overlay.ts"],"names":[],"mappings":"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"}

package/dist/ui/overlayCoxinhaMobile.d.ts

@@ -0,0 +1,10 @@
+import { OverlayHandle } from './overlay';
+/**
+ * Overlay "Coxinha Mobile" (inverted teardrop):
+ * - Máscara em formato de gota invertida, topo e base arredondados
+ * - Linhas guias centralizadas (vertical e horizontal)
+ * - Fundo glassmorphism
+ * - Pronto para integração com landmarks para checagem de alinhamento
+ */
+export declare function createOverlayCoxinhaMobile(container: HTMLElement): OverlayHandle;
+//# sourceMappingURL=overlayCoxinhaMobile.d.ts.map

package/dist/ui/overlayCoxinhaMobile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlayCoxinhaMobile.d.ts","sourceRoot":"","sources":["../../src/ui/overlayCoxinhaMobile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAgD,MAAM,WAAW,CAAC;AA0BxF;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,WAAW,GAAG,aAAa,CA8oBhF"}

package/dist/ui/userPreviewCoxinha.d.ts

@@ -0,0 +1,20 @@
+import type { AlphaValidStartOptions } from '../types/sdk';
+export type UserPreviewUiHandle = {
+    show: (srcUrl: string, metaText?: string) => void;
+    hide: () => void;
+    dispose: () => void;
+};
+export declare function createUserPreviewCoxinhaUi(params: {
+    container: HTMLElement;
+    labels?: {
+        ok?: string;
+        retake?: string;
+    };
+    onOk: () => void;
+    onRetake: () => void;
+}): UserPreviewUiHandle;
+export declare function labelsFromStartOptions(options: AlphaValidStartOptions): {
+    ok: string | undefined;
+    retake: string | undefined;
+};
+//# sourceMappingURL=userPreviewCoxinha.d.ts.map

package/dist/ui/userPreviewCoxinha.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"userPreviewCoxinha.d.ts","sourceRoot":"","sources":["../../src/ui/userPreviewCoxinha.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAOF,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IACjD,SAAS,EAAE,WAAW,CAAC;IACvB,MAAM,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB,GAAG,mBAAmB,CA8GtB;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,sBAAsB;;YAGpB,MAAM,GAAG,SAAS;EAEnE"}

package/dist/utils/canvas.d.ts

@@ -0,0 +1,27 @@
+export declare function clamp(v: number, a: number, b: number): number;
+export declare function clamp01(v: number): number;
+export declare function resizeToContainer(canvas: HTMLCanvasElement, container: HTMLElement, ctx?: CanvasRenderingContext2D): {
+    w: number;
+    h: number;
+};
+export declare function getVideoToContainerMapper(w: number, h: number, video?: HTMLVideoElement, objectFit?: string, mirrored?: boolean): {
+    mapPt: (p: {
+        x: number;
+        y: number;
+    }) => {
+        x: number;
+        y: number;
+    };
+    mapRect: (r: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }) => {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+};
+//# sourceMappingURL=canvas.d.ts.map

package/dist/utils/canvas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas.d.ts","sourceRoot":"","sources":["../../src/utils/canvas.ts"],"names":[],"mappings":"AAGA,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7D;AAGD,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzC;AAGD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,CAAC,EAAE,wBAAwB;;;EAalH;AAGD,wBAAgB,yBAAyB,CACvC,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,KAAK,CAAC,EAAE,gBAAgB,EACxB,SAAS,CAAC,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,OAAO;eAKH;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE;;;;iBACtB;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;;;;;;EAwCzE"}

package/dist/vision/faceDetector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"faceDetector.d.ts","sourceRoot":"","sources":["../../src/vision/faceDetector.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAsB,MAAM,cAAc,CAAC;AAE5E,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E,MAAM,EAAE,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACvG;AA+BD,wBAAgB,kBAAkB,IAAI,YAAY,CAsHjD"}
+{"version":3,"file":"faceDetector.d.ts","sourceRoot":"","sources":["../../src/vision/faceDetector.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAsB,MAAM,cAAc,CAAC;AAE5E,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E,MAAM,EAAE,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACvG;AA+BD,wBAAgB,kBAAkB,IAAI,YAAY,CAsOjD"}

package/package.json

@@ -1,10 +1,13 @@
 {
   "name": "alphavalid-sdk",
-  "version": "0.0.24",
+  "version": "0.1.0",
   "description": "SDK de validação facial e liveness",
   "main": "dist/alphavalid.umd.js",
   "module": "dist/alphavalid.es.js",
   "types": "dist/index.d.ts",
+  "bin": {
+    "alphavalid-sdk": "bin/alphavalid.js"
+  },
   "files": [
     "dist",
     "models",
@@ -19,7 +22,11 @@
     "types": "tsc -p tsconfig.json",
     "build:all": "rm -rf dist && npm run build && npm run types",
     "test:local": "vite preview",
-    "copy-models": "node ./scripts/copy-models.cjs"
+    "copy-models": "node ./scripts/copy-models.cjs",
+    "copy-models:demo": "node ./scripts/copy-models.cjs ./demo/public/alphavalid-models",
+    "demo:install": "cd demo && npm i",
+    "demo:dev": "cd demo && npm run dev",
+    "demo:preview": "cd demo && npm run preview"
   },
   "dependencies": {
     "face-api.js": "^0.22.2"

package/scripts/copy-models.cjs

@@ -7,70 +7,25 @@
 const fs = require('fs');
 const path = require('path');
 
-function copyDir(src, dest) {
-  fs.mkdirSync(dest, { recursive: true });
-  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
-    const srcPath = path.join(src, entry.name);
-    const destPath = path.join(dest, entry.name);
-    if (entry.isDirectory()) {
-      copyDir(srcPath, destPath);
-    } else {
-      fs.copyFileSync(srcPath, destPath);
-    }
-  }
+function detectProjectType() {
+  if (fs.existsSync('angular.json')) return 'angular';
+  if (fs.existsSync('vite.config.js') || fs.existsSync('vite.config.ts') || fs.existsSync('index.html') || fs.existsSync('public')) return 'vite';
+  return 'unknown';
 }
-
-function patchManifest(destDir) {
-  const candidates = [
-    'tiny_face_detector_model-weights_manifest.json',
-    'face_landmark_68_tiny_model-weights_manifest.json'
-  ];
-
-  for (const file of candidates) {
-    const manifestPath = path.join(destDir, file);
-    if (!fs.existsSync(manifestPath)) continue;
-
-    const raw = fs.readFileSync(manifestPath, 'utf8');
-    let patched = raw;
-
-    patched = patched.replaceAll('tiny_face_detector_model-shard1"', 'tiny_face_detector_model-shard1.bin"');
-    patched = patched.replaceAll('face_landmark_68_tiny_model-shard1"', 'face_landmark_68_tiny_model-shard1.bin"');
-
-    if (patched !== raw) fs.writeFileSync(manifestPath, patched);
-  }
+function getTargetDir() {
+  const type = detectProjectType();
+  if (type === 'angular') return path.join('src', 'assets', 'alphavalid-models');
+  if (type === 'vite') return path.join('public', 'alphavalid-models');
+  return path.join('alphavalid-models');
 }
-
-function ensureBinShard(destDir) {
-  const renames = [
-    ['tiny_face_detector_model-shard1', 'tiny_face_detector_model-shard1.bin'],
-    ['face_landmark_68_tiny_model-shard1', 'face_landmark_68_tiny_model-shard1.bin']
-  ];
-
-  for (const [from, to] of renames) {
-    const oldShard = path.join(destDir, from);
-    const binShard = path.join(destDir, to);
-    if (fs.existsSync(oldShard) && !fs.existsSync(binShard)) {
-      fs.renameSync(oldShard, binShard);
-    }
-  }
-}
-
-const destArg = process.argv[2];
-if (!destArg) {
-  console.error('Missing destination path. Example: node copy-models.cjs ./src/assets/alphavalid-models');
+const src = path.join(__dirname, '../models');
+const dest = path.resolve(process.cwd(), getTargetDir());
+if (!fs.existsSync(src)) {
+  console.error('[AlphaValid] Pasta de models não encontrada:', src);
   process.exit(1);
 }
-
-const pkgRoot = path.resolve(__dirname, '..');
-const srcModels = path.join(pkgRoot, 'models');
-if (!fs.existsSync(srcModels)) {
-  console.error('models/ folder not found in package.');
-  process.exit(1);
+fs.mkdirSync(dest, { recursive: true });
+for (const file of fs.readdirSync(src)) {
+  fs.copyFileSync(path.join(src, file), path.join(dest, file));
 }
-
-const dest = path.resolve(process.cwd(), destArg);
-copyDir(srcModels, dest);
-ensureBinShard(dest);
-patchManifest(dest);
-
-console.log(`[alphavalid-sdk] Models copied to: ${dest}`);
+console.log(`[AlphaValid] Models copiados para ${dest}`);