face-validator-sdk 1.0.0

package/dist/types/utils.d.ts

@@ -0,0 +1,57 @@
+import type { NormalizedLandmark } from '@mediapipe/tasks-vision';
+import { DetectedFaceData, DetectedHandData, ValidationStatus, BoundingBox } from './types';
+/**
+ * Calcula o brilho médio de uma região da imagem (0-255).
+ */
+export declare function calculateAverageBrightness(imageData: ImageData): number;
+/**
+ * Verifica se a face está na distância adequada (baseado no tamanho do bounding box).
+ */
+export declare function checkFaceDistance(boundingBox: BoundingBox, minFaceSizeFactor?: number, maxFaceSizeFactor?: number): 'OK' | 'TOO_FAR' | 'TOO_CLOSE';
+/**
+ * Verifica se um ponto (normalizado 0-1) está dentro do oval de enquadramento.
+ */
+export declare function isPointInsideOval(pointX: number, pointY: number, frameWidth: number, frameHeight: number): boolean;
+/**
+ * Verifica se o bounding box da face cabe dentro do oval de enquadramento.
+ * Versão simplificada: verifica apenas o centro e limites principais sem margem excessiva.
+ */
+export declare function isFaceBoundingBoxInsideOval(boundingBox: BoundingBox, frameWidth: number, frameHeight: number): boolean;
+/**
+ * Verifica se a cabeça está reta (sem inclinação lateral, horizontal ou vertical).
+ * MediaPipe: usa landmarks dos olhos, nariz e boca.
+ */
+export declare function isHeadStraight(landmarks: NormalizedLandmark[], maxTiltDegrees?: number): boolean;
+/**
+ * Verifica se a geometria do rosto é plausível (boca visível, não obstruída por mão).
+ * MediaPipe: analisa distância nariz-boca e extensão vertical da boca.
+ */
+export declare function isFaceGeometryPlausible(landmarks: NormalizedLandmark[], boundingBox: BoundingBox): boolean;
+/**
+ * Detecta se a pessoa está usando óculos escuros através da análise de luminosidade dos olhos.
+ * Óculos de grau geralmente não bloqueiam completamente a luz, permitindo ver os olhos.
+ */
+export declare function hasDarkGlasses(video: HTMLVideoElement, landmarks: NormalizedLandmark[]): boolean;
+/**
+ * Verifica se a expressão facial é neutra (sem sorriso, boca fechada, olhos abertos).
+ * Rejeita: sorriso, boca aberta, olhos fechados.
+ */
+export declare function isNeutralExpression(landmarks: NormalizedLandmark[]): boolean;
+/**
+ * Verifica yaw (inclinação lateral) usando visibilidade das orelhas.
+ * Quando o rosto está virado para o lado, uma orelha fica mais visível que a outra.
+ */
+export declare function isYawAcceptable(landmarks: NormalizedLandmark[]): boolean;
+/**
+ * Verifica se a face está estável (sem movimento significativo entre frames).
+ */
+export declare function isFaceStable(currentFace: DetectedFaceData | null, previousFace: DetectedFaceData | null, movementThreshold?: number, frameWidth?: number, frameHeight?: number): boolean;
+/**
+ * Calcula distância entre um ponto da mão e o centro do rosto (normalizado).
+ * Retorna true se a mão estiver próxima ao rosto (indicando possível obstrução).
+ */
+export declare function isHandNearFace(handData: DetectedHandData, faceBoundingBox: BoundingBox, maxDistance?: number): boolean;
+/**
+ * Desenha overlay de feedback visual (oval, status, debug info).
+ */
+export declare function drawOverlay(canvas: HTMLCanvasElement, debugMode: boolean, status: ValidationStatus, faceData?: DetectedFaceData, handData?: DetectedHandData[]): void;

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "face-validator-sdk",
+  "version": "1.0.0",
+  "description": "Real-time selfie validation SDK with face detection, i18n (pt-BR, en, es). Built on MediaPipe.",
+  "license": "MIT",
+  "author": "rwmsousa",
+  "main": "dist/face-validator-sdk.cjs.js",
+  "module": "dist/face-validator-sdk.esm.js",
+  "browser": "dist/face-validator-sdk.umd.js",
+  "types": "dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/face-validator-sdk.esm.js"
+      },
+      "require": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/face-validator-sdk.cjs.js"
+      },
+      "browser": "./dist/face-validator-sdk.umd.js",
+      "default": "./dist/face-validator-sdk.cjs.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "start": "webpack serve --config webpack.demo.js --mode development",
+    "demo": "webpack serve --config webpack.demo.js --mode development",
+    "dev": "webpack serve --config webpack.demo.js --mode development",
+    "build": "rimraf dist && webpack --mode production && tsc --emitDeclarationOnly --outDir dist/types",
+    "build:demo": "rimraf demo/dist && webpack --config webpack.demo-prod.js --mode production && cp demo/public/index.html demo/dist/index.html",
+    "build:watch": "webpack --watch --mode development",
+    "lint": "eslint . --ext .ts --report-unused-disable-directives --max-warnings 0",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "test": "jest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "selfie",
+    "validation",
+    "face detection",
+    "hand detection",
+    "mediapipe",
+    "camera",
+    "typescript",
+    "sdk",
+    "javascript",
+    "i18n",
+    "l10n"
+  ],
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "dependencies": {
+    "@mediapipe/tasks-vision": "^0.10.15"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.12",
+    "@typescript-eslint/eslint-plugin": "^7.10.0",
+    "@typescript-eslint/parser": "^7.10.0",
+    "eslint": "^8.57.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-prettier": "^5.1.3",
+    "html-webpack-plugin": "^5.6.6",
+    "jest": "^29.7.0",
+    "prettier": "^3.2.5",
+    "rimraf": "^5.0.7",
+    "ts-jest": "^29.1.4",
+    "ts-loader": "^9.5.1",
+    "typescript": "^5.4.5",
+    "webpack": "^5.91.0",
+    "webpack-cli": "^5.1.4",
+    "webpack-dev-server": "^5.0.4"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rwmsousa/face-validator-sdk.git"
+  }
+}