@voltom.io/sdk 1.0.2 → 1.0.4

package/dist/assets/locales/zh.json

@@ -0,0 +1,121 @@
+{
+  "invalidDocument": "Invalid document",
+  "checkingFaceMatch": "正在检查人脸匹配",
+  "checkingDocument": "正在检查证件",
+  "loadingAssets": "正在加载验证资源",
+  "loadingProgress": "{percent}% · {downloaded} MB / {total} MB",
+  "loadingRemaining": "预计剩余 {time}",
+  "readyToStart": "准备开始",
+  "preparingModels": "正在准备验证模型",
+  "document": "证件",
+  "documentNotReadable": "证件无法读取",
+  "documentBlurry": "证件图像模糊",
+  "error": "错误：{message}",
+  "face": "人脸",
+  "faceNotFound": "请将脸部置于摄像头画面中央，并确保脸部完整可见",
+  "faceInPolygon": "这不是真人。请展示您的真实人脸。",
+  "faceTooSmall": "请靠近摄像头，直到脸部填满画面",
+  "faceNotVisibleInDocument": "证件中未检测到人脸",
+  "frameDocument": "请将证件正面放入画面中",
+  "framePassport": "请将护照照片页放入画面中",
+  "passportMrzNotReadable": "请让所有文字和代码行清晰可读",
+  "documentAlignmentInvalid": "请将证件摆正，让照片和文字完整可见",
+  "frameDocumentBack": "请将证件背面放入画面中",
+  "stayStill": "请保持不动",
+  "holdDocumentStill": "请保持证件稳定",
+  "lookDown": "请稍微低下下巴",
+  "lookLeft": "请稍微向左转头",
+  "lookRight": "请稍微向右转头",
+  "lookStraight": "请直视镜头",
+  "raisePhone": "请将手机举到眼睛高度",
+  "centerFace": "请让脸部保持在摄像头画面中央",
+  "tiltScreen": "请调整屏幕角度，直到您可以直视摄像头",
+  "lookUp": "请稍微抬起下巴",
+  "turnLess": "请少转一些",
+  "raiseLess": "请少抬一些",
+  "lowerLess": "请少低一些",
+  "tiltLess": "请少倾斜一些",
+  "smile": "请微笑",
+  "tiltLeft": "将头稍微向左倾斜",
+  "tiltRight": "将头稍微向右倾斜",
+  "winkLeft": "请保持左眼闭合",
+  "winkRight": "请保持右眼闭合",
+  "match": "匹配 ({score}%)",
+  "noMatch": "不匹配 ({score}%)",
+  "start": "开始",
+  "stop": "停止",
+  "straightenHead": "请摆正头部",
+  "verificationCapture": "验证拍摄 {index}",
+  "cameraPermissionDenied": "Allow camera access to continue.",
+  "cameraNotFound": "No camera was found.",
+  "cameraUnavailable": "The camera is unavailable.",
+  "networkError": "Connection failed.",
+  "serviceUnavailable": "The verification service is unavailable.",
+  "modelLoadFailed": "Verification assets could not be loaded.",
+  "faceNotUsable": "Use a clear face image with even lighting.",
+  "verificationFailed": "Verification could not be completed.",
+  "capturesIncomplete": "缺少必要的采集。",
+  "documentValidationFailed": "无法验证证件。",
+  "invalidOptions": "验证设置无效。",
+  "invalidPoses": "人脸验证顺序无效。",
+  "invalidServiceResponse": "验证服务返回了无效响应。",
+  "poseBackgroundMismatch": "进行人脸验证时请保持相同背景。",
+  "poseIdentityMismatch": "人脸验证图像不匹配。",
+  "imageEncodeFailed": "无法准备图像。",
+  "imageProcessingFailed": "无法处理图像。",
+  "invalidImage": "请选择有效的图像文件。",
+  "clientKeyRequired": "缺少验证密钥。",
+  "verificationSaveFailed": "无法保存验证结果。",
+  "retry": "重试",
+  "faceCenterMoveLeft": "将脸向左移动，直到位于摄像头画面中央",
+  "faceCenterMoveRight": "将脸向右移动，直到位于摄像头画面中央",
+  "faceCenterMoveUp": "将脸向上移动，直到位于摄像头画面中央",
+  "faceCenterMoveDown": "将脸向下移动，直到位于摄像头画面中央",
+  "faceTiltMoreLeft": "Tilt your head slightly to your left to straighten it.",
+  "faceTiltMoreRight": "Tilt your head slightly to your right to straighten it.",
+  "faceTurnLeft": "Turn your head slightly to your left.",
+  "faceTurnRight": "Turn your head slightly to your right.",
+  "faceLookMoreUp": "Raise your chin slightly.",
+  "faceLookMoreDown": "Lower your chin slightly.",
+  "faceSmileRequired": "Smile more clearly.",
+  "faceWinkLeftRequired": "Close your left eye and keep your right eye open.",
+  "faceWinkRightRequired": "Close your right eye and keep your left eye open.",
+  "documentNotDetected": "找不到文件",
+  "documentBoxTooSmall": "请将文件靠近镜头",
+  "documentBoxTooLarge": "请将文件远离镜头",
+  "documentBoxNearEdge": "请将文件稍微远离镜头",
+  "documentBoxTouchesEdges": "请将整份文件放入画面",
+  "documentShapeInvalid": "文件形状无效",
+  "documentNotSupported": "不支持此文件",
+  "documentPhotoNotVisible": "Make sure the photo on the document is fully visible.",
+  "documentPhotoNotContained": "Make sure the document photo is fully visible.",
+  "documentPhotoSizeInvalid": "Make sure the document photo and text are fully visible.",
+  "documentLayoutInvalid": "Keep the document straight, with the photo on the left and text on the right.",
+  "documentNotRecognized": "This document could not be recognized. Use a supported identity document.",
+  "documentCodeNotReadable": "Make all text and code lines visible and readable.",
+  "documentBackHasFace": "请显示背面，不是正面",
+  "documentBackSameAsFront": "背面必须与正面不同",
+  "documentPhotoTooSmall": "证件上的照片太小",
+  "invalidPdf": "Invalid PDF",
+  "pdfPasswordRequired": "Password protected PDFs are not supported",
+  "pdfLoadFailed": "Could not load PDF support. Try again.",
+  "preparingCamera": "正在准备摄像头",
+  "checkingFace": "正在检查您的人脸",
+  "done": "完成",
+  "faceNotRecognized": "无法识别人脸",
+  "faceNotCentered": "请将脸部置于圆圈中央",
+  "setUpFaceKey": "设置 FaceKey",
+  "unlockWithFaceKey": "使用 FaceKey 解锁",
+  "cameraPreview": "摄像头预览",
+  "faceCaptureProgress": "人脸拍摄进度",
+  "moveHeadLeft": "将头转向左边",
+  "moveHeadRight": "将头转向右边",
+  "moveHeadUp": "抬起头",
+  "moveHeadDown": "低下头",
+  "tiltHeadLeft": "将头向左倾斜",
+  "tiltHeadRight": "将头向右倾斜",
+  "cancel": "取消",
+  "faceRetryPose": "无法识别人脸。请重试此姿势。",
+  "faceRetryMatch": "人脸不匹配。请重试此姿势。",
+  "faceRetryUsable": "人脸不可用。请重试此姿势。"
+}

package/dist/sdk/PoseSilhouette-CTZ5kqI_.js

@@ -0,0 +1,2 @@
+/*! Copyright (c) 2026 VOLTOM. All rights reserved. Proprietary software. See LICENSE at https://voltom.io/license. */
+import{r as e}from"./PoseSuccess-CxL2ugaZ.js";var t=({className:t,entries:n,kind:r})=>e(`div`,{className:n.length?t:`hidden`,[`data-${r}-debug`]:``,children:n.map(({label:t,valid:n,value:r})=>e(`div`,{children:[e(`span`,{children:[t,`: `]}),e(`span`,{"data-valid":n===void 0?void 0:String(n),children:r})]},t))}),n={faceLeft:`M 78 50 L 22 50`,faceRight:`M 22 50 L 78 50`,faceUp:`M 50 78 L 50 22`,faceDown:`M 50 22 L 50 78`,faceTiltLeft:`M 68 26 Q 44 34 32 62`,faceTiltRight:`M 32 26 Q 56 34 68 62`},r=()=>e(`defs`,{children:e(`marker`,{id:`pose-arrowhead`,markerWidth:`6`,markerHeight:`6`,refX:`4.4`,refY:`3`,orient:`auto`,children:e(`path`,{"data-pose-arrowhead":``,d:`M0,0 L6,3 L0,6 Z`})})}),i=({pose:t})=>{let r=n[t];return r?e(`path`,{"data-pose-motion":``,d:r,"marker-end":`url(#pose-arrowhead)`}):null},a=({pose:t})=>t===`faceSmile`?e(`path`,{"data-pose-smile":``,d:`M 15 45 A 35 35 0 0 0 85 45`}):null,o=({className:t,pose:n})=>e(`svg`,{className:t,"data-pose-arrow":``,"data-pose":n,viewBox:`0 0 100 100`,"aria-hidden":`true`,children:[e(r,{}),e(i,{pose:n}),e(a,{pose:n})]});export{t as n,o as t};

package/dist/sdk/PoseSuccess-CxL2ugaZ.js

@@ -0,0 +1,2 @@
+/*! Copyright (c) 2026 VOLTOM. All rights reserved. Proprietary software. See LICENSE at https://voltom.io/license. */
+import{C as e}from"./media-KU3CWepq.js";var t=Symbol.for(`pv`),n=0;Array.isArray;function r(r,i,a,o,s,c){i||={};var l,u,d=i;if(`ref`in d&&typeof r!=`function`)for(u in d={},i)u==`ref`?l=i[u]:d[u]=i[u];var f={type:r,props:d,key:a,ref:l,__k:null,__:null,__b:0,__e:null,__c:null,constructor:t,__v:--n,__i:-1,__u:0};return(s||c)&&(f.__source=s,f.__self=c),e.vnode&&e.vnode(f),f}var i=100,a=2,o=({total:e})=>i/e-(e===1?0:a),s=({arc:e,index:t,total:n})=>({dasharray:`${e} ${i-e}`,offset:`${-t*i/n}`}),c=({className:e,completed:t,label:n,total:a,variant:c=`bar`})=>{if(c===`ring`){let c=o({total:a});return r(`svg`,{className:e,"data-pose-progress":``,"data-variant":`ring`,viewBox:`0 0 100 100`,role:`progressbar`,"aria-label":n,"aria-valuemin":0,"aria-valuemax":a,"aria-valuenow":t,children:r(`g`,{transform:`rotate(-90 50 50)`,children:Array.from({length:a},(e,n)=>{let{dasharray:o,offset:l}=s({arc:c,index:n,total:a});return r(`circle`,{cx:`50`,cy:`50`,r:`50`,pathLength:i,ref:e=>{e&&(e.setAttribute(`stroke-dasharray`,o),e.setAttribute(`stroke-dashoffset`,l))},"data-pose-progress-step":``,"data-complete":n<t?``:void 0},n)})})})}return r(`div`,{className:e,"data-pose-progress":``,"data-variant":`bar`,role:`progressbar`,"aria-valuemin":0,"aria-valuemax":a,"aria-valuenow":t,children:Array.from({length:a},(e,n)=>r(`span`,{"data-pose-progress-step":``,"data-complete":n<t?``:void 0},n))})},l=({className:e,visible:t})=>r(`svg`,{className:e,"data-pose-success":``,"data-visible":t?``:void 0,viewBox:`0 0 100 100`,"aria-hidden":`true`,children:[r(`circle`,{cx:`50`,cy:`50`,r:`44`}),r(`path`,{d:`M29 51 43 65 72 36`,pathLength:`1`})]});export{c as n,r,l as t};

package/dist/sdk/facegate/global.d.ts

@@ -0,0 +1,5 @@
+import type VoltomFaceGateType from "./facegate.d.ts";
+
+declare global {
+  var VoltomFaceGate: typeof VoltomFaceGateType;
+}

package/dist/sdk/facegate.d.ts

@@ -0,0 +1,51 @@
+export type FaceGatePose = "faceStraight" | "faceUp" | "faceLeft" | "faceRight" | "faceSmile";
+
+export type FaceGateOutcome = "pass" | "fail" | "error";
+
+export type VoltomFaceGateOptions = {
+  clientKey: string;
+  apiUrl?: string;
+  debug?: boolean;
+  language?: "ar" | "ch" | "de" | "en" | "es" | "fr" | "it" | "ja" | "pt" | "zh";
+};
+
+export type FaceGateReject = {
+  outcome: "fail" | "error";
+  code: string | null;
+};
+
+export type FaceGateArmOptions = {
+  action: string;
+  subjectId?: () => Promise<string>;
+  context?: () => Promise<string>;
+  onPass: (token: string) => void | Promise<void>;
+  onReject: (reject: FaceGateReject) => void;
+  signal?: AbortSignal;
+};
+
+export type FaceGateHandle = {
+  control: HTMLElement;
+  options: FaceGateArmOptions;
+  detach: () => void;
+};
+
+export type FaceGateState = {
+  active: boolean;
+  phase: "idle" | "capturing" | "checking" | "pass" | "reject";
+  prompt: string;
+  completed: number;
+  total: number;
+  outcome: FaceGateOutcome | null;
+};
+
+export declare class VoltomFaceGate {
+  constructor(options: VoltomFaceGateOptions);
+  prepare(): Promise<void>;
+  arm(control: HTMLElement, options: FaceGateArmOptions): FaceGateHandle;
+  disarm(handle: FaceGateHandle): void;
+  stop(): void;
+  dispose(): void;
+  getState(): FaceGateState;
+}
+
+export default VoltomFaceGate;