@baas-id/react 0.3.1 → 0.3.7

package/dist/types/react/i18n/types.d.ts

@@ -1,6 +1,6 @@
 export type Locale = "en" | "es-419";
-export type ClientReason = "CAMERA_UNAVAILABLE" | "ENGINE_UNAVAILABLE" | "UPLOAD_FAILED" | "SESSION_OPEN_FAILED" | "MOVEMENT_TIMEOUT" | "RECENTER_TIMEOUT" | "MOIRE_SUSPECTED" | "SPOOF_SUSPECTED" | "MOVEMENT_DISCONTINUOUS" | "PATTERN_SUSPECTED" | "LOW_QUALITY" | "DOC_DAMAGED_REPEATED";
-export type ServerReason = "DOC_QUALITY_LOW" | "DOC_SIDE_MISMATCH" | "PORTRAIT_NOT_FOUND" | "FACE_MISMATCH" | "TEMPLATE_STALE" | "FACE_NOT_FOUND" | "FACE_MISSING" | "DOCUMENT_MISSING" | "PAD_REJECTED" | "NOT_ENROLLED" | "ALREADY_ENROLLED" | "SESSION_EXPIRED" | "SESSION_FINALIZED" | "SESSION_NOT_FOUND" | "WRONG_PURPOSE" | "CAPTURE_TOKEN_INVALID" | "CAPTURE_TOKEN_EXPIRED" | "CAPTURE_TOKEN_SESSION_MISMATCH" | "CREDENTIALS_REQUIRED" | "INVALID_API_KEY" | "RPID_UNREACHABLE" | "RETRIES_EXHAUSTED" | "FACE_RETRY" | "AI_ASSESSMENT" | "DOC_SCREEN_REPLAY" | "DOC_PAPER_COPY" | "DOC_TAMPERED" | "DOC_DAMAGED" | "DOC_SIDES_INCONSISTENT" | "DOC_FIELDS_CHANGED" | "DUPLICATE_SUSPECT" | "MATCH_FOUND" | "NO_MATCH" | "AMBIGUOUS_MATCH" | "DOC_BACK_MISMATCH" | "DOC_BACK_UNREADABLE" | "REPLAY_SUSPECTED" | "INJECTION_SUSPECTED" | "CHALLENGE_UNVERIFIED" | "PAD_SUSPECTED" | "HANDOFF_CODE_INVALID" | "HANDOFF_CODE_EXPIRED" | "HANDOFF_CODE_USED" | "HANDOFF_REVOKED" | "HANDOFF_ACTIVE" | "HANDOFF_DISABLED" | "HANDOFF_ALREADY_CLAIMED" | "HANDOFF_RATE_LIMITED" | "CAPTURE_TOKEN_REVOKED";
+export type ClientReason = "CAMERA_UNAVAILABLE" | "ENGINE_UNAVAILABLE" | "UPLOAD_FAILED" | "SESSION_OPEN_FAILED" | "MOVEMENT_TIMEOUT" | "RECENTER_TIMEOUT" | "MOIRE_SUSPECTED" | "SPOOF_SUSPECTED" | "MOVEMENT_DISCONTINUOUS" | "PATTERN_SUSPECTED" | "LOW_QUALITY" | "DOC_DAMAGED_REPEATED" | "NFC_UNAVAILABLE" | "CHIP_READ_FAILED" | "CHIP_TIMEOUT";
+export type ServerReason = "DOC_QUALITY_LOW" | "DOC_SIDE_MISMATCH" | "PORTRAIT_NOT_FOUND" | "FACE_MISMATCH" | "TEMPLATE_STALE" | "FACE_NOT_FOUND" | "FACE_MISSING" | "DOCUMENT_MISSING" | "PAD_REJECTED" | "NOT_ENROLLED" | "ALREADY_ENROLLED" | "SESSION_EXPIRED" | "SESSION_FINALIZED" | "SESSION_NOT_FOUND" | "WRONG_PURPOSE" | "CAPTURE_TOKEN_INVALID" | "CAPTURE_TOKEN_EXPIRED" | "CAPTURE_TOKEN_SESSION_MISMATCH" | "CREDENTIALS_REQUIRED" | "INVALID_API_KEY" | "RPID_UNREACHABLE" | "RETRIES_EXHAUSTED" | "FACE_RETRY" | "AI_ASSESSMENT" | "DOC_SCREEN_REPLAY" | "DOC_PAPER_COPY" | "DOC_TAMPERED" | "DOC_DAMAGED" | "DOC_SIDES_INCONSISTENT" | "DOC_FIELDS_CHANGED" | "DUPLICATE_SUSPECT" | "MATCH_FOUND" | "NO_MATCH" | "AMBIGUOUS_MATCH" | "DOC_BACK_MISMATCH" | "DOC_BACK_UNREADABLE" | "REPLAY_SUSPECTED" | "INJECTION_SUSPECTED" | "CHALLENGE_UNVERIFIED" | "PAD_SUSPECTED" | "HANDOFF_CODE_INVALID" | "HANDOFF_CODE_EXPIRED" | "HANDOFF_CODE_USED" | "HANDOFF_REVOKED" | "HANDOFF_ACTIVE" | "HANDOFF_DISABLED" | "HANDOFF_ALREADY_CLAIMED" | "HANDOFF_RATE_LIMITED" | "CAPTURE_TOKEN_REVOKED" | "CHIP_MISSING" | "CHIP_UNAVAILABLE" | "CHIP_PASSIVE_AUTH_FAILED" | "CHIP_HASH_MISMATCH" | "CHIP_CSCA_UNKNOWN" | "CHIP_CLONE_SUSPECTED" | "CHIP_MRZ_MISMATCH" | "CHIP_PORTRAIT_MISMATCH" | "CHIP_UNREADABLE" | "CHIP_ACCESS_DENIED" | "FINGER_NOT_FOUND" | "FINGER_QUALITY_LOW" | "FINGER_PAD_SUSPECTED" | "FINGER_MISMATCH" | "FINGER_NOT_ENROLLED" | "FINGER_TEMPLATE_STALE" | "FINGER_MISSING";
 export type Reason = ClientReason | ServerReason;
 export type Formality = "informal" | "formal";
 export type Recovery = "retry" | "restart" | "support";
@@ -9,7 +9,7 @@ export interface ReasonEntry {
     recovery: Recovery;
     title?: string;
 }
-export type GuideKey = "no_face" | "no_card" | "too_dark" | "too_bright" | "hold_still" | "move_closer" | "move_back" | "recenter" | "perfect" | "ready" | "find_light" | "look_straight" | "loading" | "too_far" | "bad_framing" | "screen_suspected" | "paper_suspected" | "tilt_less" | "low_contrast" | "wrong_side_front" | "wrong_side_back" | "turn_over" | "blurred" | "glare" | "steady" | "uploading" | "mrz_reading" | "mrz_unreadable" | "mrz_verified" | "closer_more" | "done_short" | "abrupt" | "a_bit_more" | "nod_start" | "nod_return" | "turn_left" | "turn_right" | "turn_wrong_left" | "turn_wrong_right" | "turn_slower" | "turn_lost" | "turn_return_center" | "turn_done" | "turn_hold_steady" | "turn_going_well" | "turn_almost" | "turn_complete" | "recenter_front" | "recenter_center" | "try_other_movement";
+export type GuideKey = "no_face" | "no_card" | "too_dark" | "too_bright" | "hold_still" | "move_closer" | "move_back" | "recenter" | "perfect" | "ready" | "find_light" | "look_straight" | "loading" | "too_far" | "bad_framing" | "screen_suspected" | "paper_suspected" | "tilt_less" | "low_contrast" | "wrong_side_front" | "wrong_side_back" | "turn_over" | "blurred" | "glare" | "steady" | "uploading" | "mrz_reading" | "mrz_unreadable" | "mrz_verified" | "closer_more" | "done_short" | "abrupt" | "a_bit_more" | "nod_start" | "nod_return" | "turn_left" | "turn_right" | "turn_wrong_left" | "turn_wrong_right" | "turn_slower" | "turn_lost" | "turn_return_center" | "turn_done" | "turn_hold_steady" | "turn_going_well" | "turn_almost" | "turn_complete" | "recenter_front" | "recenter_center" | "try_other_movement" | "no_hand" | "fingers_closer" | "fingers_back" | "fingers_together" | "hold_fingers_still" | "finger_glare" | "finger_blurry" | "show_left_hand" | "show_right_hand";
 export type EngineStage = "starting" | "downloading" | "warming" | "downloading_face" | "ready";
 export type DistanceHint = "too_far" | "bit_far" | "ideal" | "bit_close" | "too_close";
 export interface Strings {
@@ -47,6 +47,33 @@ export interface Strings {
         gloss: string;
         front: string;
         back: string;
+        place: string;
+        hold: string;
+        reading: string;
+        readingDg: string;
+        done: string;
+        skip: string;
+        skipRequired: string;
+        openApp: string;
+        unsupported: string;
+        nfcOff: string;
+        wrongMrz: string;
+        unavailable: string;
+        handoff: string;
+        uploading: string;
+        presence: string;
+        progressAria: string;
+    };
+    finger: {
+        placeRight: string;
+        placeLeft: string;
+        placeThumbRight: string;
+        placeThumbLeft: string;
+        hold: string;
+        torchOn: string;
+        done: string;
+        guideAria: string;
+        uploading: string;
     };
     tele: {
         engineStarting: string;
@@ -138,12 +165,15 @@ export interface Strings {
         notBackBody: string;
         noPortraitTitle: string;
         noPortraitBody: string;
+        qualityTitle: string;
+        qualityBody: string;
         backMismatchTitle: string;
         backMismatchBody: string;
         frontMismatchTitle: string;
         frontMismatchBody: string;
         unverifiedTitle: string;
         unverifiedBody: string;
+        backAccepted: string;
         mismatchFields: string;
         pending: string;
         finalTitle: string;
@@ -156,6 +186,7 @@ export interface Strings {
         verifying: string;
         locked: string;
         stepDone: string;
+        retrying: string;
     };
     intro: {
         frontTitle: string;
@@ -164,6 +195,10 @@ export interface Strings {
         backBody: string;
         faceTitle: string;
         faceBody: string;
+        chipTitle: string;
+        chipBody: string;
+        fingerTitle: string;
+        fingerBody: string;
         needs: string;
         start: string;
         timeMovements: string;
@@ -206,6 +241,9 @@ export interface Strings {
         phoneClosedBody: string;
         resumeOnPhone: string;
         continueHereShort: string;
+        phoneRetryWait: string;
+        retrying: string;
+        resumed: string;
         doneHeading: string;
         doneSent: string;
         doneOnComputer: string;
@@ -234,6 +272,10 @@ export interface Strings {
         stepFront: string;
         stepBack: string;
         stepFace: string;
+        stepChip: string;
+        stepFinger: string;
+        titleChip: string;
+        titleFinger: string;
         titleFront: string;
         titleBack: string;
         titleFace: string;

package/dist/types/react/preview/FlowPreview.d.ts

@@ -30,6 +30,7 @@ export interface FlowPreviewProps {
     errorCode?: string;
     documentSides?: "front_back" | "front";
     document?: boolean;
+    steps?: CaptureId[];
     challenges?: number;
     privacyNote?: string | null;
     handoff?: PreviewHandoff | null;

package/dist/types/react/telemetry/bus.d.ts

@@ -1,4 +1,4 @@
-export type ClientEventType = "camera_permission" | "camera_error" | "camera_not_found" | "camera_started" | "model_load_start" | "model_load_done" | "model_load_failed" | "model_load_timeout" | "engine_unavailable" | "visibility" | "step_shown" | "retry" | "abandoned" | "flow_failed" | "handoff_shown" | "continue_here" | "capture_review_shown" | "capture_confirmed" | "capture_retaken" | "detector_stats" | "detector_summary" | "orientation_fixed" | "face_tracking";
+export type ClientEventType = "camera_permission" | "camera_error" | "camera_not_found" | "camera_started" | "model_load_start" | "model_load_done" | "model_load_failed" | "model_load_timeout" | "engine_unavailable" | "visibility" | "step_shown" | "retry" | "abandoned" | "flow_failed" | "handoff_shown" | "continue_here" | "capture_review_shown" | "capture_confirmed" | "capture_retaken" | "detector_stats" | "detector_summary" | "orientation_fixed" | "face_tracking" | "nfc_capability" | "nfc_scan_start" | "nfc_scan_error" | "finger_stats" | "finger_summary" | "torch_state";
 export interface ClientEvent {
     type: ClientEventType;
     t?: number;

package/dist/types/react/theme/scheme.d.ts

@@ -19,5 +19,22 @@ export declare function darkPalette(a?: Appearance | null): {
 };
 export declare function darkGroups(a?: Appearance | null): Array<Record<string, string>>;
 export declare const DARK_DERIVED: Record<string, string>;
+export declare function parseCssColor(c: string | null | undefined): [number, number, number, number] | null;
+export declare function relLuminance([r, g, b]: readonly number[]): number;
+export declare const ratioOf: (a: readonly number[], b: readonly number[]) => number;
+export type SchemeSource = "prop" | "page" | "color-scheme" | "device";
+export declare function effectiveBackground(from: Element | null): [number, number, number] | null;
+export declare function hostScheme(from: Element | null): {
+    scheme: "light" | "dark";
+    from: SchemeSource;
+} | null;
+export declare function useSchemeOf(pref: ColorScheme | undefined, ref?: {
+    current: Element | null;
+}): {
+    scheme: "light" | "dark";
+    from: SchemeSource;
+    rev: number;
+};
 export declare function useColorScheme(pref: ColorScheme | undefined): "light" | "dark";
+export declare function guardInk(ink: readonly number[] | null, grounds: ReadonlyArray<readonly number[]>): string | null;
 export declare const isColorScheme: (v: unknown) => v is ColorScheme;

package/dist/types/react/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.3.1";
+export declare const SDK_VERSION = "0.3.7";

package/dist/types/react/vision/corners.d.ts

@@ -34,7 +34,7 @@ export interface CornerResult {
     aspect: number;
     contrast: number;
     reason: CornerReason | null;
-    via: "edges" | "hint" | "model" | null;
+    via: "edges" | "hint" | "model" | "refined" | null;
     orient?: [number, number, number, number];
 }
 export interface CornerOptions {

package/dist/types/react/vision/face.d.ts

@@ -6,12 +6,25 @@ type Oval = {
     rx: number;
     ry: number;
 };
+export declare const SQUARE_SIDE = 384;
+export declare function letterboxSquare(W: number, H: number, side: number): {
+    k: number;
+    x: number;
+    y: number;
+};
+export declare function fromSquare(f: FaceDetection, lb: {
+    k: number;
+    x: number;
+    y: number;
+}): FaceDetection;
 export interface FaceDetection {
     topLeft: [number, number];
     bottomRight: [number, number];
     landmarks: Array<[number, number]>;
 }
 export declare function signalsFromDetection(f: FaceDetection | null, W: number, H: number, brightness: number, oval: Oval): FaceSignals;
+export declare const FACE_W_PER_IOD = 2.03;
+export declare function faceWidthFrom(landmarks: Array<[number, number]>, x1: number, x2: number, W: number, H: number): number;
 export declare function ovalContainment(pts: Array<[number, number]>, oval: Oval): number;
 export declare const loadFaceEngine: (modelsUrl: string, onProgress?: ProgressFn) => Promise<FaceEngine>;
 export {};

package/dist/types/react/vision/quality.d.ts

@@ -1,7 +1,10 @@
 import type { CropQuality } from "./types";
-export declare function cropQuality(crop: HTMLCanvasElement): CropQuality;
+export declare function cropQuality(crop: HTMLCanvasElement, card?: ReadonlyArray<{
+    x: number;
+    y: number;
+}> | null): CropQuality;
 export declare function lightingOf(brightness: number): "good" | "too_dark" | "too_bright";
-export declare function frameLuma(video: HTMLVideoElement): number;
+export declare function frameLuma(video: HTMLVideoElement | HTMLCanvasElement): number;
 export declare function cropCanvas(source: HTMLCanvasElement, box: {
     left: number;
     top: number;

package/dist/types/react/vision/refine.d.ts

@@ -0,0 +1,71 @@
+import { type Quad } from "./corners";
+export interface Luma {
+    data: Float32Array;
+    width: number;
+    height: number;
+}
+export interface Refined {
+    quad: Quad | null;
+    ok: boolean;
+    support: [number, number, number, number];
+    aspect: number;
+    tilt: number;
+    score: number;
+    reason: "ok" | "no_lines" | "no_card_shape" | "small";
+}
+export declare const BAND_OUT = 0.08;
+export declare const BAND_IN = 0.24;
+export declare const VALLEY = 2;
+export declare const NEAR = 0.035;
+export declare const SCANS = 28;
+export declare const SIDE_SUPPORT_MIN = 0.45;
+export declare const MEAN_SUPPORT_MIN = 0.6;
+export declare const REFINE_TILT_MAX = 50;
+export declare const MAX_SHIFT = 0.2;
+export declare const refineAspectTol: (tilt: number) => number;
+interface Pt {
+    x: number;
+    y: number;
+    t: number;
+    sign: number;
+    mag: number;
+}
+interface Line {
+    px: number;
+    py: number;
+    dx: number;
+    dy: number;
+    support: number;
+    mag: number;
+    sign: number;
+    span: number;
+}
+export declare function sidePoints(g: Luma, a: {
+    x: number;
+    y: number;
+}, b: {
+    x: number;
+    y: number;
+}, cen: {
+    x: number;
+    y: number;
+}, size: number, band?: {
+    out: number;
+    inn: number;
+}): Pt[];
+export declare function sideLines(pts: Pt[], ux: number, uy: number, max?: number): Line[];
+export declare function refineQuad(g: Luma, coarse: Quad, cam: {
+    focal: number;
+    cx: number;
+    cy: number;
+}, debug?: (x: unknown) => void, opts?: {
+    search?: boolean;
+}): Refined;
+export declare function trackQuad(g: Luma, hint: Quad, cam: {
+    focal: number;
+    cx: number;
+    cy: number;
+}): Refined;
+export declare const TRACK_BAND = 0.05;
+export declare function lumaOfRegion(rgba: Uint8ClampedArray, width: number, height: number): Luma;
+export {};

package/dist/types/react/vision/resample.d.ts

@@ -0,0 +1,7 @@
+import type { PixelData } from "./authenticity";
+export declare function areaResampleLuma(px: PixelData, box: {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}, outW: number, outH: number): Float32Array | null;

package/dist/types/react/vision/tinyDetector.d.ts

@@ -11,6 +11,7 @@ export declare const TINY_INPUT = 224;
 export declare const TINY_GRID = 28;
 export declare const FOUND_PEAK = 0.03;
 export declare const LOCK_PEAK = 0.05;
+export declare const RESCUE_PEAK: number;
 export declare const MIN_AREA_FRAC = 0.02;
 export declare const EDGE_PRESENT = 0.25;
 export interface Letterbox {

package/dist/types/react/vision/types.d.ts

@@ -44,12 +44,14 @@ export interface DocumentEngine {
     cropTurn?(card: HTMLCanvasElement): Promise<{
         upsideDown: boolean;
         margin: number;
+        probs?: [number, number, number, number];
     } | null>;
 }
 export interface DetectOptions {
     corners?: {
         ks: number;
         hint?: Quad | null;
+        recent?: Quad | null;
         faces?: (source: HTMLCanvasElement) => Promise<Array<{
             topLeft: [number, number];
             bottomRight: [number, number];
@@ -57,7 +59,7 @@ export interface DetectOptions {
     };
 }
 export interface FaceEngine {
-    signals(video: HTMLVideoElement, oval: {
+    signals(video: HTMLVideoElement | HTMLCanvasElement, oval: {
         cx: number;
         cy: number;
         rx: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@baas-id/react",
-  "version": "0.3.1",
+  "version": "0.3.7",
   "description": "BaaS identity verification for React: guided ID and face capture with on-device quality gating, server-side verdicts, phone handoff. Requires a BaaS account.",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "BaaS, S.A.",
@@ -46,6 +46,11 @@
       "import": "./dist/esm/continue.js",
       "default": "./dist/esm/continue.js"
     },
+    "./native": {
+      "types": "./dist/types/native.d.ts",
+      "import": "./dist/esm/native.js",
+      "default": "./dist/esm/native.js"
+    },
     "./styles.css": "./dist/esm/baas-id-react.css",
     "./package.json": "./package.json"
   },