alphavalid-sdk 1.0.1 → 1.0.2

package/dist/ui/overlay.d.ts

@@ -0,0 +1,221 @@
+export interface OverlayHandle {
+    canvas: HTMLCanvasElement;
+    dispose: () => void;
+    render: (status: OverlayRenderInput) => void;
+}
+export interface OverlayRenderInput {
+    message: string;
+    box?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    valid: boolean;
+    /** 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;
+            y: number;
+        }>;
+        rightEye?: Array<{
+            x: number;
+            y: number;
+        }>;
+        leftEyeCenter?: {
+            x: number;
+            y: number;
+        };
+        rightEyeCenter?: {
+            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;
+//# 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":"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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/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,11 @@
+import type { FaceDetectionStatus } from '../types/sdk';
+export interface FaceDetector {
+    load: (modelsPath: string, opts?: {
+        timeoutMs?: number;
+    }) => Promise<void>;
+    detect: (video: HTMLVideoElement, opts?: {
+        withLandmarks?: boolean;
+    }) => 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,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/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/face_landmark_68_tiny_model-weights_manifest.json

@@ -0,0 +1 @@
+[{"weights":[{"name":"dense0/conv0/filters","shape":[3,3,3,32],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.008194216092427571,"min":-0.9423348506291708}},{"name":"dense0/conv0/bias","shape":[32],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.006839508168837603,"min":-0.8412595047670252}},{"name":"dense0/conv1/depthwise_filter","shape":[3,3,32,1],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.009194007106855804,"min":-1.2779669878529567}},{"name":"dense0/conv1/pointwise_filter","shape":[1,1,32,32],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.0036026100317637128,"min":-0.3170296827952067}},{"name":"dense0/conv1/bias","shape":[32],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.000740380117706224,"min":-0.06367269012273527}},{"name":"dense0/conv2/depthwise_filter","shape":[3,3,32,1],"dtype":"float32","quantization":{"dtype":"uint8","scale":1,"min":0}},{"name":"dense0/conv2/pointwise_filter","shape":[1,1,32,32],"dtype":"float32","quantization":{"dtype":"uint8","scale":1,"min":0}},{"name":"dense0/conv2/bias","shape":[32],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.0037702228508743585,"min":-0.6220867703942692}},{"name":"dense1/conv0/depthwise_filter","shape":[3,3,32,1],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.0033707996209462483,"min":-0.421349952618281}},{"name":"dense1/conv0/pointwise_filter","shape":[1,1,32,64],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.014611541991140328,"min":-1.8556658328748217}},{"name":"dense1/conv0/bias","shape":[64],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.002832523046755323,"min":-0.30307996600281956}},{"name":"dense1/conv1/depthwise_filter","shape":[3,3,64,1],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.006593170586754294,"min":-0.6329443763284123}},{"name":"dense1/conv1/pointwise_filter","shape":[1,1,64,64],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.012215249211180444,"min":-1.6001976466646382}},{"name":"dense1/conv1/bias","shape":[64],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.002384825547536214,"min":-0.3028728445370992}},{"name":"dense1/conv2/depthwise_filter","shape":[3,3,64,1],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.005859645441466687,"min":-0.7617539073906693}},{"name":"dense1/conv2/pointwise_filter","shape":[1,1,64,64],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.013121426806730382,"min":-1.7845140457153321}},{"name":"dense1/conv2/bias","shape":[64],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.0032247188044529336,"min":-0.46435950784122243}},{"name":"dense2/conv0/depthwise_filter","shape":[3,3,64,1],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.002659512618008782,"min":-0.32977956463308894}},{"name":"dense2/conv0/pointwise_filter","shape":[1,1,64,128],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.015499923743453681,"min":-1.9839902391620712}},{"name":"dense2/conv0/bias","shape":[128],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.0032450980999890497,"min":-0.522460794098237}},{"name":"dense2/conv1/depthwise_filter","shape":[3,3,128,1],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.005911862382701799,"min":-0.792189559282041}},{"name":"dense2/conv1/pointwise_filter","shape":[1,1,128,128],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.021025861478319356,"min":-2.2077154552235325}},{"name":"dense2/conv1/bias","shape":[128],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.00349616945958605,"min":-0.46149436866535865}},{"name":"dense2/conv2/depthwise_filter","shape":[3,3,128,1],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.008104994250278847,"min":-1.013124281284856}},{"name":"dense2/conv2/pointwise_filter","shape":[1,1,128,128],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.029337059282789044,"min":-3.5791212325002633}},{"name":"dense2/conv2/bias","shape":[128],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.0038808938334969913,"min":-0.4230174278511721}},{"name":"fc/weights","shape":[128,136],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.014016061670639936,"min":-1.8921683255363912}},{"name":"fc/bias","shape":[136],"dtype":"float32","quantization":{"dtype":"uint8","scale":0.0029505149698724935,"min":0.088760145008564}}],"paths":["face_landmark_68_tiny_model-shard1.bin"]}]

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.bin"]}]

package/package.json

@@ -1,15 +1,39 @@
 {
   "name": "alphavalid-sdk",
-  "version": "1.0.1",
-  "description": "",
-  "main": "index.js",
+  "version": "1.0.2",
+  "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",
+    "scripts",
+    "public/images/alphaloader.gif",
+    "README.md",
+    "package.json",
+    "vite.config.ts",
+    "tsconfig.json"
+  ],
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "build": "npx vite build && npm run types",
+    "types": "tsc -p tsconfig.json && cp dist/index.d.ts dist/alphavalid.umd.d.ts && cp dist/index.d.ts dist/alphavalid.es.d.ts",
+    "build:all": "rm -rf dist && npm run build && npm run types",
+    "test:local": "vite preview",
+    "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"
   },
-  "keywords": [],
-  "author": "",
-  "license": "ISC",
   "devDependencies": {
+    "@types/node": "^25.5.0",
     "typescript": "^6.0.2",
     "vite": "^8.0.2"
   }

package/scripts/copy-models.cjs

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+
+// Copies alphavalid-sdk face-api model files from this package into a consumer app folder.
+// Usage (from consumer app):
+//   node ./node_modules/alphavalid-sdk/scripts/copy-models.cjs ./src/assets/alphavalid-models
+
+const fs = require('fs');
+const path = require('path');
+
+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 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');
+}
+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);
+}
+fs.mkdirSync(dest, { recursive: true });
+for (const file of fs.readdirSync(src)) {
+  fs.copyFileSync(path.join(src, file), path.join(dest, file));
+}
+console.log(`[AlphaValid] Models copiados para ${dest}`);

package/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "lib": ["DOM", "ES2022", "ESNext"],
+
+    "declaration": true,
+    "declarationMap": true,
+    "emitDeclarationOnly": true,
+
+    "outDir": "dist",
+    "rootDir": "src",
+
+    "strict": true,
+    "skipLibCheck": true,
+
+    "types": [],
+    "moduleResolution": "Bundler"
+  },
+  "include": ["src"]
+}

package/vite.config.ts

@@ -0,0 +1,19 @@
+import { defineConfig } from 'vite';
+
+export default defineConfig({
+  appType: 'custom', // 🔥 ISSO AQUI RESOLVE O BUG DO INDEX.HTML
+
+  publicDir: false,
+
+  build: {
+    lib: {
+      entry: 'src/index.ts',
+      name: 'AlphaValid',
+      formats: ['es', 'umd'],
+      fileName: (format) => `alphavalid.${format}.js`
+    },
+    rollupOptions: {
+      external: []
+    }
+  }
+});

package/.gitattributes

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