alphavalid-sdk 0.0.5 → 0.0.8

package/dist/core/camera.d.ts

@@ -0,0 +1,8 @@
+export interface CameraHandle {
+    video: HTMLVideoElement;
+    stream: MediaStream;
+    stop: () => void;
+}
+export declare function startUserCamera(container: HTMLElement): Promise<CameraHandle>;
+export declare function captureVideoFrameToJpegBlob(video: HTMLVideoElement, quality?: number): Promise<Blob>;
+//# sourceMappingURL=camera.d.ts.map

package/dist/core/camera.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera.d.ts","sourceRoot":"","sources":["../../src/core/camera.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,gBAAgB,CAAC;IACxB,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,wBAAsB,eAAe,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CA0CnF;AAED,wBAAsB,2BAA2B,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,SAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBvG"}

package/dist/core/feedback.d.ts

@@ -0,0 +1,7 @@
+import type { AlphaValidFeedbackMessage, FaceDetectionStatus } from '../types/sdk';
+export interface FeedbackResult {
+    message: AlphaValidFeedbackMessage;
+    valid: boolean;
+}
+export declare function computeFeedback(status: FaceDetectionStatus): FeedbackResult;
+//# sourceMappingURL=feedback.d.ts.map

package/dist/core/feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../../src/core/feedback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnF,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,yBAAyB,CAAC;IACnC,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,mBAAmB,GAAG,cAAc,CA6B3E"}

package/dist/index.d.ts

@@ -1,6 +1,17 @@
+import type { AlphaValidStartOptions } from './types/sdk';
 export declare class AlphaValid {
-    private video;
-    start(options: any): Promise<void>;
+    private _camera;
+    private _overlay;
+    private _container;
+    private _faceDetector;
+    private _loopTimer;
+    private _lastStatusValid;
+    private _options;
+    start(options: AlphaValidStartOptions): Promise<void>;
+    /** Stop camera + overlay + detection loop */
+    stop(): Promise<void>;
     capture(): Promise<Blob>;
+    private startDetectionLoop;
 }
+export type { AlphaValidStartOptions } from './types/sdk';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAAoB;IAE3B,KAAK,CAAC,OAAO,EAAE,GAAG;IAalB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAY/B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAO1D,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,aAAa,CAAsC;IAC3D,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAuC;IAEjD,KAAK,CAAC,OAAO,EAAE,sBAAsB;IAwC3C,6CAA6C;IACvC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAW9B,OAAO,CAAC,kBAAkB;CA2B3B;AAED,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC"}

package/dist/types/sdk.d.ts

@@ -0,0 +1,33 @@
+export type AlphaValidFeedbackMessage = 'Inicializando câmera...' | 'Centralize seu rosto' | 'Aproxime o rosto' | 'Afaste o rosto' | 'Ajuste a iluminação' | 'Apenas 1 rosto por vez' | 'Rosto detectado' | 'Pronto para capturar';
+export interface AlphaValidStartOptions {
+    container: HTMLElement;
+    /** Called when the camera stream is attached and video can play. */
+    onReady?: () => void;
+    /** Called frequently as face detection runs, to guide the user. */
+    onFeedback?: (message: AlphaValidFeedbackMessage) => void;
+    /** Called on errors (permission denied, no camera, etc). */
+    onError?: (error: unknown) => void;
+    /** Optional: enable/disable overlay guide (default true). */
+    overlay?: boolean;
+    /** Optional: circle size ratio (0-1). Default 0.72 of the smallest side. */
+    guideCircleRatio?: number;
+    /** How often to run face detection (ms). Default 200. */
+    detectionIntervalMs?: number;
+    /**
+     * Base URL where face-api.js models are served from.
+     * Option A (recommended): copy this package's /models into your app public assets,
+     * e.g. '/assets/alphavalid-models'.
+     */
+    modelsPath?: string;
+}
+export interface FaceDetectionStatus {
+    faces: number;
+    /** Face box normalized [0..1] relative to video square viewport. */
+    box?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}
+//# sourceMappingURL=sdk.d.ts.map

package/dist/types/sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../src/types/sdk.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,yBAAyB,GACjC,yBAAyB,GACzB,sBAAsB,GACtB,kBAAkB,GAClB,gBAAgB,GAChB,qBAAqB,GACrB,wBAAwB,GACxB,iBAAiB,GACjB,sBAAsB,CAAC;AAE3B,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,WAAW,CAAC;IAEvB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAErB,mEAAmE;IACnE,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,yBAAyB,KAAK,IAAI,CAAC;IAE1D,4DAA4D;IAC5D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAEnC,6DAA6D;IAC7D,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,yDAAyD;IACzD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,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;CAC/D"}

package/dist/ui/overlay.d.ts

@@ -0,0 +1,16 @@
+export interface OverlayHandle {
+    canvas: HTMLCanvasElement;
+    dispose: () => void;
+    render: (status: {
+        message?: string;
+        box?: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        };
+        valid?: boolean;
+    }) => void;
+}
+export declare function createOverlay(container: HTMLElement, guideCircleRatio?: number): OverlayHandle;
+//# sourceMappingURL=overlay.d.ts.map

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

@@ -0,0 +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;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,GAAG,CAAC,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QAC9D,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,KAAK,IAAI,CAAC;CACZ;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,WAAW,EAAE,gBAAgB,SAAO,GAAG,aAAa,CAkF5F"}

package/dist/utils/dom.d.ts

@@ -0,0 +1,3 @@
+export declare function ensureHTMLElement(el: unknown, name: string): asserts el is HTMLElement;
+export declare function cleanupElement(el: HTMLElement | null | undefined): void;
+//# sourceMappingURL=dom.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../src/utils/dom.ts"],"names":[],"mappings":"AAAA,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,EAAE,IAAI,WAAW,CAItF;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAOvE"}

package/dist/vision/faceDetector.d.ts

@@ -0,0 +1,7 @@
+import type { FaceDetectionStatus } from '../types/sdk';
+export interface FaceDetector {
+    load: (modelsPath: string) => Promise<void>;
+    detect: (video: HTMLVideoElement) => Promise<FaceDetectionStatus>;
+}
+export declare function createFaceDetector(): FaceDetector;
+//# sourceMappingURL=faceDetector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"faceDetector.d.ts","sourceRoot":"","sources":["../../src/vision/faceDetector.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACnE;AAED,wBAAgB,kBAAkB,IAAI,YAAY,CAwCjD"}

package/models/README.md

@@ -0,0 +1,8 @@
+Place face-api.js model files here (TinyFaceDetector) to be shipped with the npm package.
+
+Expected files:
+- tiny_face_detector_model-weights_manifest.json
+- tiny_face_detector_model-shard1
+- tiny_face_detector_model-shard2 (if present)
+
+These files will be included in the npm tarball and can be copied by consumer apps into their public assets directory.

package/models/tiny_face_detector_model-weights_manifest.json

@@ -0,0 +1 @@
+[{"weights":[{"name":"conv0/filters","shape":[3,3,3,16],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.009007044399485869,"min":-1.2069439495311063}},{"name":"conv0/bias","shape":[16],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.005263455241334205,"min":-0.9211046672334858}},{"name":"conv1/depthwise_filter","shape":[3,3,16,1],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.004001977630690033,"min":-0.5042491814669441}},{"name":"conv1/pointwise_filter","shape":[1,1,16,32],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.013836609615999109,"min":-1.411334180831909}},{"name":"conv1/bias","shape":[32],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.0015159862590771096,"min":-0.30926119685173037}},{"name":"conv2/depthwise_filter","shape":[3,3,32,1],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.002666276225856706,"min":-0.317286870876948}},{"name":"conv2/pointwise_filter","shape":[1,1,32,64],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.015265831292844286,"min":-1.6792414422128714}},{"name":"conv2/bias","shape":[64],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.0020280554598453,"min":-0.37113414915168985}},{"name":"conv3/depthwise_filter","shape":[3,3,64,1],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.006100742489683862,"min":-0.8907084034938438}},{"name":"conv3/pointwise_filter","shape":[1,1,64,128],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.016276211832083907,"min":-2.0508026908425725}},{"name":"conv3/bias","shape":[128],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.003394414279975143,"min":-0.7637432129944072}},{"name":"conv4/depthwise_filter","shape":[3,3,128,1],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.006716050119961009,"min":-0.8059260143953211}},{"name":"conv4/pointwise_filter","shape":[1,1,128,256],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.021875603993733724,"min":-2.8875797271728514}},{"name":"conv4/bias","shape":[256],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.0041141652009066415,"min":-0.8187188749804216}},{"name":"conv5/depthwise_filter","shape":[3,3,256,1],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.008423839597141042,"min":-0.9013508368940915}},{"name":"conv5/pointwise_filter","shape":[1,1,256,512],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.030007277283014035,"min":-3.8709387695088107}},{"name":"conv5/bias","shape":[512],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.008402082966823203,"min":-1.4871686851277068}},{"name":"conv8/filters","shape":[1,1,512,25],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.028336129469030042,"min":-4.675461362389957}},{"name":"conv8/bias","shape":[25],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.002268134028303857,"min":-0.41053225912299807}}],"paths":["tiny_face_detector_model-shard1"]}]

package/package.json

@@ -1,14 +1,27 @@
 {
   "name": "alphavalid-sdk",
-  "version": "0.0.5",
+  "version": "0.0.8",
   "description": "SDK de validação facial e liveness",
   "main": "dist/alphavalid.umd.js",
   "module": "dist/alphavalid.es.js",
   "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "models",
+    "README.md",
+    "package.json",
+    "vite.config.ts",
+    "tsconfig.json"
+  ],
   "scripts": {
     "build": "npx vite build",
     "types": "tsc -p tsconfig.json",
-    "build:all": "rm -rf dist && npm run build && npm run types"
+    "build:all": "rm -rf dist && npm run build && npm run types",
+    "test:local": "vite preview",
+    "copy-models": "node ./scripts/copy-models.cjs"
+  },
+  "dependencies": {
+    "face-api.js": "^0.22.2"
   },
   "devDependencies": {
     "@types/node": "^25.5.0",

package/.gitattributes

@@ -1,2 +0,0 @@
-# Auto detect text files and perform LF normalization
-* text=auto

package/src/index.ts

@@ -1,29 +0,0 @@
-export class AlphaValid {
-  private video!: HTMLVideoElement;
-
-  async start(options: any) {
-    const stream = await navigator.mediaDevices.getUserMedia({
-      video: { facingMode: "user" }
-    });
-
-    this.video = document.createElement("video");
-    this.video.srcObject = stream;
-    this.video.autoplay = true;
-    this.video.playsInline = true;
-
-    options.container.appendChild(this.video);
-  }
-
-  async capture(): Promise<Blob> {
-    const canvas = document.createElement("canvas");
-    canvas.width = this.video.videoWidth;
-    canvas.height = this.video.videoHeight;
-
-    const ctx = canvas.getContext("2d");
-    ctx?.drawImage(this.video, 0, 0);
-
-    return new Promise((resolve) => {
-      canvas.toBlob((blob) => resolve(blob!), "image/jpeg");
-    });
-  }
-}