@baas-id/react 0.2.9 → 0.3.1

package/dist/types/react/capture/api.d.ts

@@ -24,6 +24,18 @@ export declare function uploadCaptureSignal(cfg: RpidClientConfig, kind: "docume
 export declare function uploadCapture(cfg: RpidClientConfig, kind: "document" | "face", blob: Blob, side?: "front" | "back", meta?: Record<string, unknown>, mrzReadings?: string[]): Promise<any>;
 export declare function finalizeSessionSignal(cfg: RpidClientConfig, signal?: AbortSignal): Promise<any>;
 export declare function finalizeSession(cfg: RpidClientConfig): Promise<any>;
+export interface MrzLayout {
+    rotation: 0 | 180;
+    orientation_source?: "mrz" | null;
+    type?: string | null;
+    image: [number, number];
+    box: number[] | null;
+    lines: number[][];
+    fields: Record<string, {
+        box: number[];
+        valid: boolean | null;
+    }>;
+}
 export interface MrzProbe {
     available: boolean;
     mrz: {
@@ -36,6 +48,7 @@ export interface MrzProbe {
         checks?: Record<string, boolean>;
         failed?: string[];
         fields?: Record<string, string | null>;
+        layout?: MrzLayout | null;
     };
     screen?: {
         available: boolean;

package/dist/types/react/capture/debugCapture.d.ts

@@ -0,0 +1,31 @@
+import { type RpidClientConfig } from "./api";
+export interface DebugCaptureStatus {
+    enabled: boolean;
+    max_fps?: number;
+    long_side?: number;
+    quality?: number;
+}
+export declare function debugCaptureOf(cfg: RpidClientConfig): Promise<DebugCaptureStatus>;
+export declare function resetDebugCapture(): void;
+type Meta = Record<string, unknown>;
+export declare class DebugRecorder {
+    private cfg;
+    private step;
+    private t0;
+    private status;
+    private last;
+    private seq;
+    private inflight;
+    private scratch;
+    readonly ready: Promise<void>;
+    constructor(cfg: RpidClientConfig | null, step: "front" | "back" | "face", t0?: number);
+    get on(): boolean;
+    offer(source: CanvasImageSource & {
+        width?: number;
+        height?: number;
+        videoWidth?: number;
+        videoHeight?: number;
+    }, meta: Meta, now?: number, force?: boolean): void;
+}
+export declare const r2: (v: number | null | undefined, d?: number) => number | null;
+export {};

package/dist/types/react/capture/debugLog.d.ts

@@ -0,0 +1,25 @@
+import { type RpidClientConfig } from "./api";
+export type DebugEntry = Record<string, string | number | boolean | null | Array<string | number | null>>;
+export declare function scrub(s: unknown, max?: number): string;
+declare class DebugLog {
+    private cfg;
+    private queue;
+    private sent;
+    private seq;
+    private timer;
+    private undo;
+    private t0;
+    get on(): boolean;
+    start(cfg: RpidClientConfig): Promise<boolean>;
+    stop(): void;
+    add(e: DebugEntry): void;
+    perf(step: string, data: Record<string, number | string | null>): void;
+    camera(step: string, track: MediaStreamTrack | null | undefined): void;
+    flush(beacon: boolean): void;
+    private realFetch;
+    private hookConsole;
+    private hookErrors;
+    private hookFetch;
+}
+export declare const debugLog: DebugLog;
+export {};

package/dist/types/react/capture/index.d.ts

@@ -1,4 +1,4 @@
-export { uploadCapture, finalizeSession, probeDocument, uploadCaptureSignal, finalizeSessionSignal, probeDocumentSignal, errorCode, isAbort, rejectionOf, authenticityOf, apiHeaders, langHeaders, withLanguage, type RpidClientConfig, type MrzProbe, type CaptureUpload, type Rejection, type DocumentAuthenticity, } from "./api";
+export { uploadCapture, finalizeSession, probeDocument, uploadCaptureSignal, finalizeSessionSignal, probeDocumentSignal, errorCode, isAbort, rejectionOf, authenticityOf, apiHeaders, langHeaders, withLanguage, type RpidClientConfig, type MrzProbe, type MrzLayout, type CaptureUpload, type Rejection, type DocumentAuthenticity, } from "./api";
 export { openCamera, parkCamera, stopStream, cameraConstraints, type CameraProfile } from "./camera";
 export { analyzeFrame, moireProbe, grabFrame, canvasToJpeg, thumbnailOf, readPixels, haptic, type Quality, type ProbeRegion, } from "./frames";
 export { demoDocumentFrame, demoFaceFrame } from "./demo";

package/dist/types/react/document/CardFrame.d.ts

@@ -1,6 +1,17 @@
 import type { Strings } from "../i18n";
+import { type Quad } from "./overlay";
 import type { QuadSource } from "./track";
 export type FrameState = "searching" | "tracking" | "holding" | "locked";
+export interface OutlinePath {
+    d: string;
+    length: number;
+    corners: Array<[number, number]>;
+    sides: number[];
+}
+export declare function outlinePath(q: Quad, radius: number): OutlinePath;
+export type Dash = readonly [string, string];
+export declare function dashOnly(from: number, to: number, length: number): Dash;
+export declare function dashProgress(o: OutlinePath, pct: number): Dash;
 export declare function CardFrame({ source, pct, state, label, t, }: {
     source: QuadSource | null;
     pct: number;

package/dist/types/react/document/DocumentParts.d.ts

@@ -24,6 +24,10 @@ export declare function CaptureReview({ image, aspect, review, t, confirm, outli
     confirm?: boolean;
     outline?: CardInset | null;
 }): import("react").JSX.Element;
+export declare function MrzOverlay({ mrz, t }: {
+    mrz: NonNullable<Review["mrz"]>;
+    t: Strings;
+}): import("react").JSX.Element;
 export declare function ReviewSheet({ review, t, confirm }: {
     review: Review;
     t: Strings;

package/dist/types/react/document/cornerOrder.d.ts

@@ -8,6 +8,8 @@ export declare function canonicalQuad(q: Quad): {
 export declare function alignToPrevious(q: Quad, prev: Quad | null): Quad;
 export declare function modelRotation(model: Quad, ordered: Quad): number | null;
 export declare function geometricRotation(ordered: Quad): number;
+export declare const HEAD_MIN = 0.6;
+export declare function headRotation(canonical: Quad, stable: Quad, orient: readonly number[]): number | null;
 export declare class OrientationVote {
     private readonly n;
     private readonly share;
@@ -19,11 +21,18 @@ export declare class OrientationVote {
     get value(): number | null;
     shift(by: number): void;
     reset(): void;
+    private held;
+    lock(k: number): void;
+    get locked(): boolean;
 }
 export declare class CornerOrder {
     private prev;
     readonly orient: OrientationVote;
-    read(raw: Quad, fromModel: boolean): Quad;
+    read(raw: Quad, fromModel: boolean, orient?: readonly number[] | null): Quad;
+    private canonLock;
     rotationFor(stable: Quad): number;
-    reset(): void;
+    settle(held: Quad, k: number): number;
+    flip(stable: Quad): number;
+    orientQuad(q: Quad): Quad;
+    reset(full?: boolean): void;
 }

package/dist/types/react/document/mrz.d.ts

@@ -1,4 +1,4 @@
-import type { MrzProbe } from "../capture";
+import type { MrzLayout, MrzProbe } from "../capture";
 export declare const MRZ_PROBE_MS = 1100;
 export declare const MRZ_GRACE_MS = 5200;
 export declare const MRZ_READINGS_MAX = 7;
@@ -18,6 +18,8 @@ export declare class MrzGate {
     unavailable: boolean;
     readonly readings: string[];
     readonly enabled: boolean;
+    settledAbsent: boolean;
+    layout: MrzLayout | null;
     constructor(enabled: boolean);
     get initialStage(): MrzStage;
     private get active();
@@ -27,3 +29,4 @@ export declare class MrzGate {
     decide(now: number, goodSince: number): MrzDecision;
     reset(): void;
 }
+export declare function finalMrzStage(extraction: unknown, live: MrzStage): MrzStage | null;

package/dist/types/react/document/mrzMap.d.ts

@@ -0,0 +1,19 @@
+import type { MrzLayout } from "../capture";
+import type { Pt, Quad } from "./overlay";
+export interface CardRect {
+    key: string;
+    uv: [Pt, Pt, Pt, Pt];
+    valid?: boolean | null;
+}
+export interface MrzMap {
+    zone: CardRect | null;
+    lines: CardRect[];
+    fields: CardRect[];
+    center: Pt | null;
+}
+export declare function invert3(m: number[]): number[] | null;
+export declare function cardToQuad(q: Quad, p: Pt): Pt;
+export declare function boxToSent(b: number[], W: number, H: number, rotation: number): [Pt, Pt, Pt, Pt];
+export declare function mapLayout(layout: MrzLayout | null | undefined, quad: Quad | null): MrzMap | null;
+export declare const upsideDown: (m: MrzMap | null) => boolean;
+export declare function turnMap(m: MrzMap): MrzMap;

package/dist/types/react/document/review.d.ts

@@ -9,11 +9,26 @@ export interface ExtractionLike {
         kind?: string;
         valid?: boolean | null;
         raw?: unknown;
+        format?: string | null;
     }>;
     portrait?: {
         present?: boolean;
         box?: number[] | null;
     } | null;
+    orientation?: {
+        rotation?: number;
+        source?: string;
+    } | null;
+    mrz_layout?: {
+        rotation?: number;
+        orientation_source?: string | null;
+        image?: number[];
+        lines?: number[][];
+        fields?: Record<string, {
+            box?: number[];
+            valid?: boolean | null;
+        } | undefined>;
+    } | null;
 }
 export interface ReviewRegion {
     key: string;
@@ -29,11 +44,25 @@ export interface ReviewField {
     value: string;
     confirmed: boolean;
 }
+export interface ReviewMrzField extends ReviewRegion {
+    value: string;
+    valid: boolean | null;
+    n: number;
+    field: string;
+}
+export interface ReviewMrz {
+    status: "verified" | "unreadable";
+    lines: ReviewRegion[];
+    fields: ReviewMrzField[];
+}
 export interface Review {
     regions: ReviewRegion[];
     fields: ReviewField[];
+    mrz?: ReviewMrz | null;
+    turned?: 0 | 180;
 }
 export declare function maskNumber(v: string): string;
+export declare function turnOf(x: ExtractionLike | null | undefined): 0 | 180;
 export declare function reviewOf(x: ExtractionLike | null | undefined, imgW: number, imgH: number, t: Strings): Review;
 export declare const hasReview: (r: Review) => boolean;
 export interface CardInset {

package/dist/types/react/document/stats.d.ts

@@ -10,7 +10,7 @@ export declare class CaptureStats {
     private coach;
     private mode;
     constructor(t0: number);
-    frame(found: boolean, confidence: number, veto?: "geometry" | "edges" | "content"): void;
+    frame(found: boolean, confidence: number, veto?: "geometry" | "edges" | "content" | "face", relaxed?: "held" | "stable"): void;
     outline(mode: "edges" | "box" | null): void;
     tick(gate: Gate | null, pFront: number | null, motion: number | null, stillOk: boolean | null, hold: number, coach: string): void;
     searching(coach: string): void;

package/dist/types/react/document/steady.d.ts

@@ -84,6 +84,7 @@ export declare class OneEuro {
 }
 export declare class CornerFilter {
     private f;
+    constructor(minCutoff?: number, beta?: number);
     filter(q: Quad, t: number): Quad;
     reset(): void;
 }

package/dist/types/react/document/track.d.ts

@@ -32,5 +32,10 @@ export interface QuadSource {
     info?(): {
         kind: "edges" | "box" | null;
         locks: readonly [boolean, boolean, boolean, boolean];
+        rot?: number | null;
+        mrz?: {
+            map: import("./mrzMap").MrzMap;
+            verified: boolean;
+        } | null;
     };
 }

package/dist/types/react/document/useDocumentCapture.d.ts

@@ -19,6 +19,8 @@ export interface Snapshot {
 }
 export declare const LOCK_MS = 520;
 export declare const REVIEW_MS = 2600;
+export declare const CROP_TURN_MIN = 1;
+export declare const OUTLINE_BETA = 0.015;
 export declare const FLIP_MANUAL_MS = 15000;
 export declare function cutUpload(full: HTMLCanvasElement, b: Box): HTMLCanvasElement;
 export interface UploadCandidate {
@@ -67,6 +69,7 @@ export declare function useDocumentCapture(props: DocumentCaptureProps): {
         checks?: Record<string, boolean>;
         failed?: string[];
         fields?: Record<string, string | null>;
+        layout?: import("../capture").MrzLayout | null;
     } | null;
     mrzStage: MrzStage;
     retry: () => void;

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

@@ -1,9 +1,11 @@
 import type { GuideKey, Strings } from "../i18n";
 import { type Ellipse } from "./faceView";
+import type { PointsMotion } from "../document/track";
 import { type ScanState } from "./scanState";
 export type FaceGuideState = "neutral" | "aligned" | "capturing" | "done" | "warn";
 export type FaceCue = "turn_left" | "turn_right" | "move_closer" | null;
-export declare function FaceGuide({ src, oval, state, scan, fills, progress, cue, guide, errorKey, t, }: {
+export declare function FaceGuide({ src, oval, state, scan, fills, progress, cue, guide, errorKey, t, motion, }: {
+    motion?: PointsMotion | null;
     src: {
         w: number;
         h: number;

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

@@ -0,0 +1,32 @@
+import type { Ellipse } from "./faceView";
+export declare const SNAP_FROM = 1;
+export declare class FaceFollow {
+    private f;
+    private blend;
+    private last;
+    step(face: Ellipse | null, oval: Ellipse, locked: boolean, now: number): {
+        e: Ellipse;
+        alpha: number;
+        dashed: boolean;
+    } | null;
+    reset(): void;
+}
+export declare class FaceTrackStats {
+    frames: number;
+    found: number;
+    private prev;
+    private jit;
+    private t0;
+    alignedMs: number | null;
+    frame(center: {
+        x: number;
+        y: number;
+    } | null, aligned: boolean, now: number): void;
+    summary(): {
+        frames: number;
+        found: number;
+        rate: number;
+        jitterPx: number | null;
+        alignedMs: number | null;
+    };
+}

package/dist/types/react/handoff/ContinueFlow.d.ts

@@ -26,6 +26,10 @@ export declare function ContinueConfirmView({ t, tenant, codeHint, onContinue }:
     codeHint: string;
     onContinue?: () => void;
 }): import("react").JSX.Element;
-export declare function ContinueDoneView({ t }: {
+export type DoneStep = "front" | "back" | "face";
+export declare function ContinueDoneView({ t, tenant, codeHint, steps }: {
     t: Strings;
+    tenant?: string | null;
+    codeHint?: string | null;
+    steps?: readonly DoneStep[];
 }): import("react").JSX.Element;

package/dist/types/react/handoff/ContinueOnPhone.d.ts

@@ -19,10 +19,11 @@ export interface HandoffPanelProps {
     onResult: (result: VerificationResult) => void;
     onContinueHere?: () => void;
     onError?: (code: string) => void;
+    onFailed?: (code: string, detail?: unknown) => void;
     onEvent?: (e: RpidFlowEvent) => void;
     pollMs?: number;
 }
-export declare function HandoffPanel({ config, t, mode, copy, onResult, onContinueHere, onError, onEvent, pollMs, }: HandoffPanelProps): import("react").JSX.Element;
+export declare function HandoffPanel({ config, t, mode, copy, onResult, onContinueHere, onError, onFailed, onEvent, pollMs, }: HandoffPanelProps): import("react").JSX.Element;
 export interface HandoffViewProps {
     t: Strings;
     mode: HandoffMode;
@@ -42,8 +43,15 @@ export interface HandoffViewProps {
     onCopy?: () => void;
     onNewCode?: () => void;
     onContinueHere?: () => void;
+    stopped?: {
+        kind: "failed" | "abandoned";
+        title: string | null;
+        body: string | null;
+        final: boolean;
+    } | null;
+    onAgain?: () => void;
 }
-export declare function HandoffView({ t, mode, copy, link, leftMs, expired, failed, phase, device, copied, linkId, onCopy, onNewCode, onContinueHere, }: HandoffViewProps): import("react").JSX.Element;
+export declare function HandoffView({ t, mode, copy, link, leftMs, expired, failed, phase, device, copied, linkId, onCopy, onNewCode, onContinueHere, stopped, onAgain, }: HandoffViewProps): import("react").JSX.Element;
 export declare function CodeChip({ t, code, instruction }: {
     t: Strings;
     code: string;
@@ -60,6 +68,7 @@ export interface ContinueOnPhoneProps {
     onResult: (result: VerificationResult) => void;
     onContinueHere?: () => void;
     onError?: (code: string) => void;
+    onFailed?: (code: string, detail?: unknown) => void;
     onEvent?: (e: RpidFlowEvent) => void;
     appearance?: Appearance | null;
     colorScheme?: ColorScheme;

package/dist/types/react/handoff/api.d.ts

@@ -10,7 +10,7 @@ export interface HandoffCode {
     codeHint: string;
     tenant: string;
 }
-export type HandoffPhase = "waiting" | "connected" | "capturing" | "finished";
+export type HandoffPhase = "waiting" | "connected" | "capturing" | "finished" | "failed" | "abandoned";
 export interface HandoffStatus {
     status: "none" | "pending" | "claimed" | "expired" | "revoked";
     phase: HandoffPhase | null;
@@ -20,6 +20,10 @@ export interface HandoffStatus {
     claimedAt: string | null;
     result: Json | null;
     sessionExpired: boolean;
+    reason: string | null;
+    reasonTitle: string | null;
+    reasonDescription: string | null;
+    final: boolean;
 }
 export declare function createHandoff(cfg: RpidClientConfig, device?: string, signal?: AbortSignal): Promise<HandoffCode>;
 export declare function handoffStatus(cfg: RpidClientConfig, signal?: AbortSignal): Promise<HandoffStatus>;
@@ -41,6 +45,11 @@ export interface CallLanguage {
 export declare function peekHandoff(apiUrl: string, code: string, signal?: AbortSignal, lang?: CallLanguage): Promise<HandoffPeek>;
 export declare function claimHandoff(apiUrl: string, code: string, device?: string, signal?: AbortSignal, lang?: CallLanguage): Promise<Json>;
 export declare function reportProgress(cfg: RpidClientConfig, step: "front" | "back" | "face"): Promise<void>;
+export declare function reportPhone(cfg: RpidClientConfig, event: "heartbeat" | "failed" | "abandoned", info?: {
+    step?: "front" | "back" | "face";
+    reason?: string;
+    final?: boolean;
+}, beacon?: boolean): void;
 export declare function postDevice(cfg: RpidClientConfig, snapshot: DeviceSnapshot): Promise<void>;
 export declare function postClientEvents(cfg: RpidClientConfig, events: ClientEvent[], beacon?: boolean): void;
 export {};

package/dist/types/react/handoff/phoneLink.d.ts

@@ -0,0 +1,7 @@
+import type { RpidClientConfig } from "../capture";
+export declare const HEARTBEAT_MS = 10000;
+export interface PhoneFailure {
+    reason: string;
+    final: boolean;
+}
+export declare function usePhoneLink(cfg: RpidClientConfig | null, step: "front" | "back" | "face" | null, failure: PhoneFailure | null, finished: boolean): void;

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

@@ -120,6 +120,14 @@ export interface Strings {
         fieldNumber: string;
         fieldBirth: string;
         fieldExpiry: string;
+        fieldNationality: string;
+        regionMrz: string;
+        mrzReading: string;
+        mrzDetected: string;
+        mrzVerified: string;
+        mrzUnreadable: string;
+        mrzNone: string;
+        turnedUpright: string;
     };
     retake: {
         action: string;
@@ -190,6 +198,21 @@ export interface Strings {
         capturing: string;
         finished: string;
         keepOpen: string;
+        phoneFailedTitle: string;
+        phoneFailedBody: string;
+        retryOnPhone: string;
+        useThisComputer: string;
+        phoneClosedTitle: string;
+        phoneClosedBody: string;
+        resumeOnPhone: string;
+        continueHereShort: string;
+        doneHeading: string;
+        doneSent: string;
+        doneOnComputer: string;
+        doneFor: string;
+        doneCode: string;
+        doneClose: string;
+        doneCloseHint: string;
         stepWaiting: string;
         stepConnected: string;
         stepCapturing: string;

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";
+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 interface ClientEvent {
     type: ClientEventType;
     t?: number;

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

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

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

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

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

@@ -1,4 +1,4 @@
-export declare const MODELS_VERSION = "v-68335fb410d8";
+export declare const MODELS_VERSION = "v-9debdb36923f";
 export declare const MODELS_CDN = "https://baaslatam.com/sdk-models";
-export declare const DEFAULT_MODELS_URL = "https://baaslatam.com/sdk-models/v-68335fb410d8";
+export declare const DEFAULT_MODELS_URL = "https://baaslatam.com/sdk-models/v-9debdb36923f";
 export declare const modelsUrlOf: (url?: string | null) => string;

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

@@ -11,11 +11,14 @@ export interface TinyPhases {
     where: "worker" | "main";
     backendName: string;
 }
+export interface TinyOut {
+    hm: Float32Array;
+    side: Float32Array;
+    orient?: Float32Array;
+}
 export interface TinyCore {
-    run(pixels: Parameters<TF["browser"]["fromPixels"]>[0]): Promise<{
-        hm: Float32Array;
-        side: Float32Array;
-    }>;
+    run(pixels: Parameters<TF["browser"]["fromPixels"]>[0]): Promise<TinyOut>;
     phases: TinyPhases;
 }
 export declare function loadTinyCore(tf: TF, urls: string[], where: "worker" | "main", blank: () => Parameters<TF["browser"]["fromPixels"]>[0], onProgress?: (f: number) => void, backends?: string[]): Promise<TinyCore>;
+export declare function sortOutputs(data: Float32Array[]): TinyOut;

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

@@ -1,6 +1,12 @@
 import { type Quad } from "./corners";
 import type { CardDetection, DocumentEngine, ProgressFn } from "./types";
-export declare const TINY_FOLDERS: readonly ["card-tinydet-r4"];
+export declare const TINY_FOLDERS: readonly ["card-tinydet-r6", "card-tinydet-r4"];
+export declare const RELAX_STREAK = 3;
+export declare const RELAX_MOTION = 0.04;
+export declare const RELAX_DETAIL = 0.25;
+export declare const RELAX_SIDES = 2;
+export declare const FACE_FILL_MAX = 0.2;
+export declare const ORIENT_VOTE_MIN = 0.6;
 export declare const TINY_INPUT = 224;
 export declare const TINY_GRID = 28;
 export declare const FOUND_PEAK = 0.03;
@@ -20,14 +26,16 @@ export interface CornerPeak {
 }
 export declare function decodeHeatmaps(hm: ArrayLike<number>, G?: number): CornerPeak[];
 export declare function frontProbability(logits: ArrayLike<number>): number;
+export declare function orientProbabilities(logits: ArrayLike<number> | undefined | null): [number, number, number, number] | null;
 export interface TinyReading {
     quad: Quad;
     conf: [number, number, number, number];
     pFront: number;
     found: boolean;
     present: boolean;
+    orient: [number, number, number, number] | null;
 }
-export declare function readTiny(hm: ArrayLike<number>, sideLogits: ArrayLike<number>, w: number, h: number): TinyReading;
+export declare function readTiny(hm: ArrayLike<number>, sideLogits: ArrayLike<number>, w: number, h: number, orientLogits?: ArrayLike<number> | null): TinyReading;
 export declare function plausible(q: Quad, w: number, h: number): boolean;
 export declare function tinyDetection(r: TinyReading, w: number, h: number, ms?: number): CardDetection;
 export declare function rectifyCanvas(crop: HTMLCanvasElement, quad: Quad, margin: number, maxLong: number): HTMLCanvasElement;

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

@@ -13,7 +13,8 @@ export interface CardDetection {
     };
     weak?: boolean;
     corners?: FrameCorners;
-    veto?: "geometry" | "edges" | "content";
+    veto?: "geometry" | "edges" | "content" | "face";
+    relaxed?: "held" | "stable";
 }
 export interface SideResult {
     isFront: boolean;
@@ -40,11 +41,19 @@ export interface DocumentEngine {
     detectCard(source: HTMLCanvasElement | HTMLVideoElement, srcW?: number, srcH?: number, opts?: DetectOptions): Promise<CardDetection>;
     rectify(crop: HTMLCanvasElement, quad: Quad, margin: number, maxLong: number): Promise<HTMLCanvasElement>;
     classifySide(crop: HTMLCanvasElement): Promise<SideResult>;
+    cropTurn?(card: HTMLCanvasElement): Promise<{
+        upsideDown: boolean;
+        margin: number;
+    } | null>;
 }
 export interface DetectOptions {
     corners?: {
         ks: number;
         hint?: Quad | null;
+        faces?: (source: HTMLCanvasElement) => Promise<Array<{
+            topLeft: [number, number];
+            bottomRight: [number, number];
+        }>>;
     };
 }
 export interface FaceEngine {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@baas-id/react",
-  "version": "0.2.9",
+  "version": "0.3.1",
   "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.",