@baas-id/react 0.2.2

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

@@ -0,0 +1,250 @@
+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 Reason = ClientReason | ServerReason;
+export type Recovery = "retry" | "restart" | "support";
+export interface ReasonEntry {
+    message: string;
+    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" | "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 EngineStage = "starting" | "downloading" | "warming" | "downloading_face" | "ready";
+export type DistanceHint = "too_far" | "bit_far" | "ideal" | "bit_close" | "too_close";
+export interface Strings {
+    reasons: Record<Reason, ReasonEntry>;
+    guide: Record<GuideKey, string>;
+    engine: Record<EngineStage, string>;
+    distance: Record<DistanceHint, string>;
+    challenge: Record<"turn_left" | "turn_right" | "move_closer" | "blink_x2" | "nod", string>;
+    meter: {
+        centered: string;
+        centeredAria: string;
+        distance: string;
+        distanceAria: string;
+        near: string;
+        far: string;
+    };
+    turn: {
+        turningLeft: string;
+        turningRight: string;
+        towardLeft: string;
+        towardRight: string;
+        progressAria: string;
+    };
+    loading: {
+        note: string;
+        progressAria: string;
+        processing: string;
+        processingNote: string;
+        processingAria: string;
+    };
+    chip: {
+        sharpness: string;
+        glare: string;
+        light: string;
+        gloss: string;
+        front: string;
+        back: string;
+    };
+    tele: {
+        engineStarting: string;
+        loadingModels: string;
+        loadingFaceDetector: string;
+        engineReady: string;
+        detectorUnavailable: string;
+        searchingDoc: string;
+        uploadingDoc: string;
+        uploadingCapture: string;
+        centerFace: string;
+        side: string;
+        front: string;
+        back: string;
+        sharpness: string;
+        glare: string;
+        light: string;
+        face: string;
+        centered: string;
+        inside: string;
+        area: string;
+        challenge: string;
+        progress: string;
+        recentering: string;
+        id: string;
+        focus: string;
+        moire: string;
+        framing: string;
+        ok: string;
+        mrz: string;
+        reading: string;
+        verified: string;
+        unreadable: string;
+        none: string;
+        grid: string;
+        gloss: string;
+        static: string;
+        corner: string;
+        texture: string;
+        screenCue: string;
+        paperCue: string;
+    };
+    doc: {
+        shutter: string;
+        shutterNote: string;
+        detected: string;
+        captured: string;
+        cardFound: string;
+        edgesLocked: string;
+        photoTaken: string;
+        stepsAria: string;
+        stepOf: string;
+        stepDone: string;
+        stepCurrent: string;
+        reviewTitle: string;
+        reviewNone: string;
+        verify: string;
+        confirmed: string;
+        confirmTitle: string;
+        confirmTitleFront: string;
+        confirmTitleBack: string;
+        confirmHint: string;
+        confirmNote: string;
+        confirmUse: string;
+        confirmRetake: string;
+        confirmAria: string;
+        regionPortrait: string;
+        regionCode: string;
+        fieldName: string;
+        fieldNumber: string;
+        fieldBirth: string;
+        fieldExpiry: string;
+    };
+    retake: {
+        action: string;
+        continue: string;
+        notFrontTitle: string;
+        notFrontBody: string;
+        notBackTitle: string;
+        notBackBody: string;
+        noPortraitTitle: string;
+        noPortraitBody: string;
+        backMismatchTitle: string;
+        backMismatchBody: string;
+        frontMismatchTitle: string;
+        frontMismatchBody: string;
+        unverifiedTitle: string;
+        unverifiedBody: string;
+        mismatchFields: string;
+        pending: string;
+        finalTitle: string;
+    };
+    face: {
+        ovalAria: string;
+        aligned: string;
+        capturing: string;
+        done: string;
+        verifying: string;
+        locked: string;
+        stepDone: string;
+    };
+    intro: {
+        frontTitle: string;
+        frontBody: string;
+        backTitle: string;
+        backBody: string;
+        faceTitle: string;
+        faceBody: string;
+        needs: string;
+        start: string;
+        timeMovements: string;
+        timeMovementsOne: string;
+        timeNone: string;
+        timeSession: string;
+    };
+    handoff: {
+        title: string;
+        lede: string;
+        why1: string;
+        why2: string;
+        why3: string;
+        scan: string;
+        qrAlt: string;
+        linkLabel: string;
+        copy: string;
+        copied: string;
+        copyFailed: string;
+        validFor: string;
+        expired: string;
+        newCode: string;
+        creating: string;
+        createFailed: string;
+        retry: string;
+        forTenant: string;
+        codeHint: string;
+        continueHere: string;
+        cancel: string;
+        waiting: string;
+        connected: string;
+        capturing: string;
+        finished: string;
+        keepOpen: string;
+        stepWaiting: string;
+        stepConnected: string;
+        stepCapturing: string;
+        statusAria: string;
+        regenerateAria: string;
+        phoneTitle: string;
+        phoneBody: string;
+        phoneWarning: string;
+        phoneContinue: string;
+        phoneChecking: string;
+        doneTitle: string;
+        doneBody: string;
+        linkErrorTitle: string;
+    };
+    flow: {
+        stepFront: string;
+        stepBack: string;
+        stepFace: string;
+        titleFront: string;
+        titleBack: string;
+        titleFace: string;
+        titleSignIn: string;
+        opening: string;
+        finalizing: string;
+        serverDecides: string;
+        enrolled: string;
+        signedIn: string;
+        retry: string;
+        restart: string;
+        supportHint: string;
+        failedTitle: string;
+        pending: string;
+        privacy: string;
+        consentTitle: string;
+        consentContinue: string;
+        consentLearnMore: string;
+        assurance: string;
+        match: string;
+        policy: string;
+        assuranceBasic: string;
+        attemptsLeft: string;
+        lastAttempt: string;
+        faceRetry: string;
+        faceRetryLast: string;
+        underReview: string;
+        titleReverify: string;
+        reverifyNote: string;
+        reverifyNoteFace: string;
+        reverified: string;
+        titleIdentify: string;
+        identifying: string;
+        identified: string;
+        noMatch: string;
+        ambiguousMatch: string;
+    };
+}
+export type StringOverrides = {
+    [K in keyof Strings]?: Partial<Strings[K]>;
+};
+export type TeleRecipe = (s: Strings) => string;

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

@@ -0,0 +1,25 @@
+import type { SVGProps } from "react";
+export declare const CheckIcon: (p: SVGProps<SVGSVGElement> & {
+    size?: number;
+}) => import("react").JSX.Element;
+export declare const CardIcon: (p: SVGProps<SVGSVGElement> & {
+    size?: number;
+}) => import("react").JSX.Element;
+export declare const FaceIcon: (p: SVGProps<SVGSVGElement> & {
+    size?: number;
+}) => import("react").JSX.Element;
+export declare const AlertIcon: (p: SVGProps<SVGSVGElement> & {
+    size?: number;
+}) => import("react").JSX.Element;
+export declare const RotateIcon: (p: SVGProps<SVGSVGElement> & {
+    size?: number;
+}) => import("react").JSX.Element;
+export declare const ShieldIcon: (p: SVGProps<SVGSVGElement> & {
+    size?: number;
+}) => import("react").JSX.Element;
+export declare const ClockIcon: (p: SVGProps<SVGSVGElement> & {
+    size?: number;
+}) => import("react").JSX.Element;
+export declare const PhoneIcon: (p: SVGProps<SVGSVGElement> & {
+    size?: number;
+}) => import("react").JSX.Element;

package/dist/types/react/liveness/challenges.d.ts

@@ -0,0 +1,26 @@
+import type { GuideKey } from "../i18n";
+import type { ChallengeKind, FaceSignals } from "./signals";
+export declare const CLOSER_GROWTH = 1.28;
+export declare const RECENTER_YAW = 0.25;
+export interface ChallengeUpdate {
+    done: boolean;
+    feedbackKey: GuideKey;
+    progress: number;
+    peak: number;
+    jumps?: number;
+}
+export interface Challenge {
+    kind: ChallengeKind;
+    update(sig: FaceSignals): ChallengeUpdate;
+}
+export interface Evidence {
+    peak: number;
+    jumps: number;
+}
+export type StepResult = Pick<ChallengeUpdate, "done" | "feedbackKey" | "progress">;
+export declare function createChallenge(kind: ChallengeKind, baseline: {
+    faceFrac: number;
+}): Challenge;
+export declare function createRecenter(): {
+    update(sig: FaceSignals): ChallengeUpdate;
+};

package/dist/types/react/liveness/framing.d.ts

@@ -0,0 +1,33 @@
+import type { FaceSignals } from "./signals";
+export declare const FACE_W_MIN = 0.27;
+export declare const FACE_W_MAX = 0.68;
+export declare const FACE_W_COMFORT_MIN = 0.34;
+export declare const FACE_W_COMFORT_MAX = 0.54;
+export declare function faceWidthOf(s: {
+    faceW?: number;
+    faceFrac: number;
+}): number;
+export declare const CENTER_OFFSET_TOL = 0.6;
+export declare const CENTER_MIN = 0.6;
+export declare const CONTAIN_MIN = 0.9;
+export declare const RECENTER_CENTERING = 0.6;
+export declare function centeringFrom(faceCx: number, faceCy: number, oval: {
+    cx: number;
+    cy: number;
+    rx: number;
+    ry: number;
+}): number;
+export type CenterBlocker = "no_face" | "too_dark" | "too_bright" | "move_closer" | "move_back" | "hold_still" | "recenter";
+export declare function centerBlocker(input: {
+    found: boolean;
+    lighting: FaceSignals["lighting"];
+    centering: number;
+    fill: number;
+    faceW: number;
+    unsteady: boolean;
+}): CenterBlocker | null;
+export type Proximity = "far" | "good" | "close";
+export declare function proximityOf(faceW: number): Proximity;
+export type DistanceHint = "too_far" | "bit_far" | "ideal" | "bit_close" | "too_close";
+export declare function distanceHintOf(faceW: number): DistanceHint;
+export declare function distanceTrackPos(faceW: number): number;

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

@@ -0,0 +1,8 @@
+export { signalsFromFace, type ChallengeKind, type FaceSignals, type FaceGeometry } from "./signals";
+export { FACE_W_MIN, FACE_W_MAX, FACE_W_COMFORT_MIN, FACE_W_COMFORT_MAX, faceWidthOf, CENTER_OFFSET_TOL, CENTER_MIN, CONTAIN_MIN, RECENTER_CENTERING, centeringFrom, centerBlocker, proximityOf, distanceHintOf, distanceTrackPos, type CenterBlocker, type Proximity, type DistanceHint, } from "./framing";
+export { YAW_TARGET, YAW_CONFIDENCE_MIN, YAW_MAX_STEP, JUMP_HELD_TOL, YAW_POSITIVE_SIDE, stepJump, isTurn, type JumpState, type TurnSide, } from "./turn";
+export { NOD_TARGET } from "./nod";
+export { CLOSER_GROWTH, RECENTER_YAW, createChallenge, createRecenter, type Challenge, type ChallengeUpdate, } from "./challenges";
+export { LivenessTracker, periodicityScore, padVerdict, MOIRE_FACE_MAX, MOIRE_DOC_MAX, type PadSummary, } from "./scoring";
+export { ISSUABLE, parseChallengeScript, alternateChallenge, shuffle, type Rng } from "./script";
+export * from "./timing";

package/dist/types/react/liveness/nod.d.ts

@@ -0,0 +1,4 @@
+import type { FaceSignals } from "./signals";
+import type { Evidence, StepResult } from "./challenges";
+export declare const NOD_TARGET = 0.16;
+export declare function createNodStep(): (sig: FaceSignals, ev: Evidence) => StepResult;

package/dist/types/react/liveness/scoring.d.ts

@@ -0,0 +1,29 @@
+import type { FaceSignals } from "./signals";
+export declare class LivenessTracker {
+    private prev;
+    private motionSum;
+    private motionN;
+    private parallaxMax;
+    private yawExtent;
+    private pitchMin;
+    private pitchMax;
+    private yawJumps;
+    private jumpSt;
+    lastJitter: number;
+    ingest(sig: FaceSignals): void;
+    summary(): {
+        motion: number;
+        parallax: number;
+        yaw_extent: number;
+        pitch_extent: number;
+        yaw_jumps: number;
+        frozen: boolean;
+        flat: boolean;
+        cut: boolean;
+    };
+}
+export declare function periodicityScore(gray: Float32Array, w: number, h: number): number;
+export declare const MOIRE_FACE_MAX = 0.5;
+export declare const MOIRE_DOC_MAX = 0.55;
+export type PadSummary = ReturnType<LivenessTracker["summary"]>;
+export declare function padVerdict(pad: Pick<PadSummary, "frozen" | "flat" | "cut">, moire: number): "SPOOF_SUSPECTED" | "MOVEMENT_DISCONTINUOUS" | "PATTERN_SUSPECTED" | null;

package/dist/types/react/liveness/script.d.ts

@@ -0,0 +1,7 @@
+import type { ChallengeKind } from "./signals";
+export declare const ISSUABLE: readonly ChallengeKind[];
+export declare const FALLBACK_SCRIPT: readonly ChallengeKind[];
+export type Rng = () => number;
+export declare function shuffle<T>(items: readonly T[], rng?: Rng): T[];
+export declare function parseChallengeScript(script: readonly string[], rng?: Rng): ChallengeKind[];
+export declare function alternateChallenge(kind: ChallengeKind, rng?: Rng): ChallengeKind;

package/dist/types/react/liveness/signals.d.ts

@@ -0,0 +1,38 @@
+export type ChallengeKind = "turn_left" | "turn_right" | "move_closer" | "blink_x2" | "nod";
+export interface FaceSignals {
+    found: boolean;
+    centering: number;
+    fill: number;
+    brightness: number;
+    lighting: "good" | "too_dark" | "too_bright";
+    yaw: number;
+    yawConfidence: number;
+    roll: number;
+    pitch: number;
+    faceFrac: number;
+    faceW?: number;
+    geom?: FaceGeometry;
+    cx: number;
+    cy: number;
+    eyeDist: number;
+    noseYaw?: number;
+}
+export interface FaceGeometry {
+    box: {
+        x1: number;
+        y1: number;
+        x2: number;
+        y2: number;
+    };
+    landmarks: Array<[number, number]>;
+    W: number;
+    H: number;
+}
+export declare function signalsFromFace(landmarks: Array<[number, number]>, box: {
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+}, frameW: number, frameH: number): Omit<FaceSignals, "found" | "fill" | "centering" | "brightness" | "lighting"> & {
+    noseYaw: number;
+};

package/dist/types/react/liveness/timing.d.ts

@@ -0,0 +1,20 @@
+export declare const FACE_TICK_MS = 180;
+export declare const CENTER_HOLD_MS = 1000;
+export declare const CENTER_JITTER_MAX = 0.055;
+export declare const CENTER_UNSTEADY_FRAMES = 2;
+export declare const HOLD_FRAMES = 3;
+export declare const CHALLENGE_TIMEOUT_MS = 12000;
+export declare const RECENTER_TIMEOUT_MS = 8000;
+export declare const REISSUE_PAUSE_MS = 600;
+export declare const MAX_REISSUES = 1;
+export declare const centerHoldFrames: (tickMs?: number, holdMs?: number) => number;
+export declare function nextUnsteadyFrames(prev: number, found: boolean, jitter: number): number;
+export type DeadlineAction = {
+    k: "continue";
+} | {
+    k: "reissue";
+} | {
+    k: "fail";
+    reason: "FACE_MISSING" | "MOVEMENT_TIMEOUT";
+};
+export declare function challengeDeadline(now: number, deadline: number, gotFace: boolean, reissues: number): DeadlineAction;

package/dist/types/react/liveness/turn.d.ts

@@ -0,0 +1,18 @@
+import type { ChallengeKind, FaceSignals } from "./signals";
+import type { Evidence, StepResult } from "./challenges";
+export declare const YAW_TARGET = 0.42;
+export declare const YAW_CONFIDENCE_MIN = 0.45;
+export declare const YAW_MAX_STEP = 0.8;
+export declare const JUMP_HELD_TOL = 0.22;
+export interface JumpState {
+    prev: number | null;
+    pending: {
+        from: number;
+        to: number;
+    } | null;
+}
+export declare function stepJump(st: JumpState, yaw: number): "open" | "teleport" | null;
+export type TurnSide = "left" | "right";
+export declare const YAW_POSITIVE_SIDE: TurnSide;
+export declare function createTurnStep(kind: "turn_left" | "turn_right"): (sig: FaceSignals, ev: Evidence) => StepResult;
+export declare const isTurn: (k: ChallengeKind) => k is "turn_left" | "turn_right";

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

@@ -0,0 +1,34 @@
+import { type Locale } from "../i18n";
+import { type TenantInstructions } from "../flows/experience";
+import { type CaptureId } from "../flows/state";
+import type { Purpose } from "../flows/types";
+import { type Appearance } from "../theme/appearance";
+export type PreviewScreen = "intro" | "capture" | "success" | "error" | "handoff" | "continue" | "continueDone";
+export interface PreviewHandoff {
+    mode?: "auto" | "suggest";
+    copy?: Partial<Record<Locale, {
+        title?: string;
+        body?: string;
+    }>>;
+    ttlMinutes?: number;
+    tenant?: string;
+    continueUrl?: string;
+}
+export type PreviewChallenge = "center" | "turn_left" | "turn_right" | "move_closer";
+export interface FlowPreviewProps {
+    screen: PreviewScreen;
+    step?: CaptureId;
+    challenge?: PreviewChallenge;
+    purpose?: Purpose;
+    locale: Locale;
+    appearance?: Appearance | null;
+    instructions?: TenantInstructions | null;
+    messages?: unknown;
+    errorCode?: string;
+    documentSides?: "front_back" | "front";
+    document?: boolean;
+    challenges?: number;
+    privacyNote?: string | null;
+    handoff?: PreviewHandoff | null;
+}
+export declare function FlowPreview(props: FlowPreviewProps): import("react").JSX.Element;

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

@@ -0,0 +1,17 @@
+import type { Appearance, ColorKey } from "../theme/appearance";
+export declare const DEFAULT_COLORS: Record<ColorKey, string>;
+export declare const DEFAULT_RADIUS = 12;
+export declare const CONTRAST_PAIRS: ReadonlyArray<{
+    fg: ColorKey;
+    bg: ColorKey;
+    min: number;
+}>;
+export declare function contrastRatio(a: string, b: string): number;
+export interface ContrastCheck {
+    fg: ColorKey;
+    bg: ColorKey;
+    ratio: number;
+    min: number;
+    pass: boolean;
+}
+export declare function contrastChecks(a: Appearance | null | undefined): ContrastCheck[];

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

@@ -0,0 +1,35 @@
+import { type Quad } from "../document/overlay";
+export declare function specimenQuad(viewW: number, viewH: number): Quad;
+export declare function drawDocumentScene(canvas: HTMLCanvasElement, side: "front" | "back"): void;
+export declare function specimenThumb(side: "front" | "back"): string | undefined;
+export declare const FACE_SRC: {
+    w: number;
+    h: number;
+};
+export declare function faceGeometry(yaw?: number, near?: number): {
+    cx: number;
+    cy: number;
+    rx: number;
+    ry: number;
+    eyes: {
+        x: number;
+        y: number;
+    }[];
+    nose: {
+        x: number;
+        y: number;
+    };
+    mouth: {
+        x: number;
+        y: number;
+    };
+    ears: {
+        x: number;
+        y: number;
+    }[];
+};
+export declare function facePoints(yaw?: number, near?: number): {
+    x: number;
+    y: number;
+}[];
+export declare function drawFaceScene(canvas: HTMLCanvasElement, yaw?: number, near?: number): void;

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

@@ -0,0 +1,13 @@
+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";
+export interface ClientEvent {
+    type: ClientEventType;
+    t?: number;
+    step?: string;
+    code?: string;
+    data?: Record<string, string | number | boolean | Array<string | number | boolean> | null | undefined>;
+}
+type Listener = (e: ClientEvent) => void;
+export declare function reportClient(e: ClientEvent): void;
+export declare function subscribeClient(fn: Listener): () => void;
+export declare function trackFacts(stream: MediaStream | null | undefined): ClientEvent["data"];
+export {};

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

@@ -0,0 +1,66 @@
+export type DeviceKind = "mobile" | "tablet" | "desktop";
+export interface DeviceReading {
+    kind: DeviceKind;
+    touch: boolean;
+    reasons: string[];
+}
+type Nav = Navigator & {
+    userAgentData?: {
+        mobile?: boolean;
+        platform?: string;
+        brands?: Array<{
+            brand: string;
+            version: string;
+        }>;
+        getHighEntropyValues?: (hints: string[]) => Promise<Record<string, unknown>>;
+    };
+    connection?: {
+        effectiveType?: string;
+        downlink?: number;
+        rtt?: number;
+        saveData?: boolean;
+    };
+    deviceMemory?: number;
+};
+interface Env {
+    nav?: Nav;
+    matchMedia?: (q: string) => {
+        matches: boolean;
+    };
+    screen?: {
+        width: number;
+        height: number;
+    };
+}
+export declare function detectDevice(e?: Env): DeviceReading;
+export declare function inAppBrowser(ua: string): string | null;
+export interface ParsedUa {
+    os: {
+        name?: string;
+        version?: string;
+    };
+    browser: {
+        name?: string;
+        version?: string;
+    };
+    model?: string;
+}
+export declare function parseUserAgent(ua: string): ParsedUa;
+export interface DeviceSnapshot {
+    [key: string]: unknown;
+}
+export interface SnapshotOptions {
+    sdkVersion: string;
+    locale?: string;
+    runtime?: {
+        tfBackend?: string;
+        models?: Array<{
+            name: string;
+            ms?: number;
+            cache?: "hit" | "miss";
+        }>;
+    };
+    webgl?: boolean;
+}
+export declare function collectSnapshot(opts: SnapshotOptions): Promise<DeviceSnapshot>;
+export {};

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

@@ -0,0 +1,27 @@
+import type { RpidClientConfig } from "../capture";
+import { postClientEvents, postDevice } from "../handoff/api";
+import { type ClientEvent } from "./bus";
+export declare const FLUSH_MS = 2000;
+export declare const BATCH = 10;
+export declare const MAX_EVENTS = 300;
+export declare class TelemetryReporter {
+    private cfg;
+    private locale?;
+    private send;
+    private sendDevice;
+    private queue;
+    private sent;
+    private timer;
+    private last;
+    private models;
+    private runtimeSent;
+    step: string;
+    finished: boolean;
+    constructor(cfg: RpidClientConfig, locale?: string | undefined, send?: typeof postClientEvents, sendDevice?: typeof postDevice);
+    start(): () => void;
+    add(e: ClientEvent): void;
+    private runtimeSnapshot;
+    flush(beacon?: boolean): void;
+    pagehide(): void;
+}
+export declare function useTelemetry(cfg: RpidClientConfig | null, step: string, finished: boolean, locale?: string, enabled?: boolean): TelemetryReporter | null;