vesant-sdk 1.7.2-dev.617dd44 → 1.7.2-dev.9ef17db

package/dist/react.d.mts

@@ -1,8 +1,9 @@
-import { D as DeviceFingerprintRequest, G as GeolocationClient, i as CipherTextOptions, l as CipherTextResult, Y as UseGeolocationOptions, Z as UseGeolocationResult, _ as UseLocationCaptureOptions, $ as UseLocationCaptureResult, a0 as UseLocationRequestsOptions, a1 as UseLocationRequestsResult } from './client-BwXMQA2a.mjs';
-import { e as LoginVerificationResponse, L as LoginVerificationRequest, f as RegistrationVerificationResponse, R as RegistrationVerificationRequest, h as TransactionVerificationResponse, g as TransactionVerificationRequest, C as ComplianceClient } from './client-D23KhWeh.mjs';
+import { D as DeviceFingerprintRequest, G as GeolocationClient, i as CipherTextOptions, l as CipherTextResult, Y as UseGeolocationOptions, Z as UseGeolocationResult, _ as UseLocationCaptureOptions, $ as UseLocationCaptureResult, a0 as UseLocationRequestsOptions, a1 as UseLocationRequestsResult } from './client-XDEhh9VN.mjs';
+import { e as LoginVerificationResponse, L as LoginVerificationRequest, f as RegistrationVerificationResponse, R as RegistrationVerificationRequest, h as TransactionVerificationResponse, g as TransactionVerificationRequest, C as ComplianceClient } from './client-5q4whhGu.mjs';
 import { RiskProfileClient } from './risk-profile/index.mjs';
 import { C as CustomerProfile } from './types-BOFaMQxI.mjs';
-import { KycClient, CreateEventBasedFaceVerificationSessionRequest, CreateEventBasedFaceVerificationSessionResponse, EventBasedFaceVerificationCallback, UseKycAlertsOptions, UseKycAlertsResult, UseKycOverviewOptions, UseKycOverviewResult, UseKycPreferencesResult, UseKycRequestsOptions, UseKycRequestsResult, UseKycSubmissionOptions, UseKycSubmissionResult } from './kyc/index.mjs';
+import { CreateEventBasedFaceVerificationSessionResponse, EventBasedFaceVerificationCallback, KycClient, CreateEventBasedFaceVerificationSessionRequest, UseKycAlertsOptions, UseKycAlertsResult, UseKycOverviewOptions, UseKycOverviewResult, UseKycPreferencesResult, UseKycRequestsOptions, UseKycRequestsResult, UseKycSubmissionOptions, UseKycSubmissionResult } from './kyc/index.mjs';
+import React$1 from 'react';
 import './client-q9fN8Hhf.mjs';
 import './types-CBQRNL-l.mjs';
 
@@ -63,6 +64,12 @@ declare function createDeviceFingerprint(): DeviceFingerprintRequest;
 /**
  * React hook for generating cipherText
  *
+ * The tenant's GPS requirements are read from the client before each generation.
+ * The client reuses a fetched copy for a short period, so this does not add a
+ * request per event, and a requirement changed in the compliance console takes
+ * effect without reloading the page. Call `refreshConfig` to apply a change
+ * immediately.
+ *
  * @example
  * ```tsx
  * function LoginForm() {
@@ -79,6 +86,7 @@ declare function createDeviceFingerprint(): DeviceFingerprintRequest;
  */
 declare function useCipherText(client?: GeolocationClient): {
     generate: (options: CipherTextOptions) => Promise<CipherTextResult | null>;
+    refreshConfig: () => Promise<void>;
     configLoading: boolean;
     configError: Error | null;
 };
@@ -402,7 +410,11 @@ declare function useKycAlerts(client: KycClient, options?: UseKycAlertsOptions):
  */
 declare function useKycOverview(client: KycClient, options?: UseKycOverviewOptions): UseKycOverviewResult;
 /**
- * React hook for managing KYC preferences
+ * React hook for reading KYC preferences
+ *
+ * Preferences are managed in the Vesant console. The returned
+ * `updatePreferences` is deprecated: the platform exposes no update
+ * operation, so it always fails.
  *
  * @param client - KycClient instance
  * @param autoFetch - Auto-fetch preferences on mount (default: true)
@@ -410,31 +422,19 @@ declare function useKycOverview(client: KycClient, options?: UseKycOverviewOptio
  *
  * @example
  * ```tsx
- * function PreferencesForm() {
- *   const { preferences, loading, updatePreferences, refresh } = useKycPreferences(client);
- *
- *   const handleUpdate = async (e: FormEvent) => {
- *     e.preventDefault();
- *     await updatePreferences({
- *       is_face_verification_required: true,
- *       required_document_count: 2
- *     });
- *   };
+ * function PreferencesSummary() {
+ *   const { preferences, loading, refresh } = useKycPreferences(client);
  *
  *   if (loading) return <Spinner />;
  *
  *   return (
- *     <form onSubmit={handleUpdate}>
- *       <Checkbox
- *         label="Require Face Verification"
- *         checked={preferences?.is_face_verification_required}
- *       />
- *       <NumberInput
- *         label="Required Documents"
- *         value={preferences?.required_document_count}
- *       />
- *       <Button type="submit">Save</Button>
- *     </form>
+ *     <dl>
+ *       <dt>Face verification required</dt>
+ *       <dd>{String(preferences?.is_face_verification_required)}</dd>
+ *       <dt>Required documents</dt>
+ *       <dd>{preferences?.required_document_count}</dd>
+ *       <button onClick={refresh}>Refresh</button>
+ *     </dl>
  *   );
  * }
  * ```
@@ -511,6 +511,56 @@ declare function getStatusColor(status: string): string;
  * @returns CSS color class or hex color
  */
 declare function getRiskColor(risk: string): string;
+/**
+ * Detect whether the current browser is a mobile device. The check is
+ * deliberately conservative — anything that doesn't match the mobile
+ * pattern is treated as desktop and gets the QR handoff flow.
+ *
+ * Server-side device detection is intentionally absent; the SDK is the
+ * authority on UX selection.
+ */
+declare function isMobileDevice(userAgent?: string): boolean;
+/**
+ * Build the opaque QR payload a desktop client renders for the mobile
+ * device to scan. Format matches the normal-KYC mobile-handoff scheme so
+ * a single mobile app can handle both flows.
+ */
+declare function buildEventBasedFaceVerificationQrPayload(token: string): string;
+/**
+ * Options for `verifyFace` / `runFlow`. Mirrors `FaceCaptureModalProps`.
+ *
+ * - `defaultDevice` — `'ask'` (default on desktop) shows the device
+ *   picker; `'this'` skips straight to capture; `'mobile'` skips
+ *   straight to the QR handoff. Default on mobile is `'this'`. Ignored
+ *   when the session carries a `verification_url` (hosted journey).
+ * - `renderQR` — bring-your-own QR renderer. Default uses a public QR
+ *   rendering service.
+ * - `onCancel` — fires when the user dismisses the modal without
+ *   reaching a terminal verification result (cancel button or close
+ *   icon). The verifyFace promise still resolves with `null` for the
+ *   same case, so this callback is purely a side-effect hook.
+ * - `mediapipeAssetBasePath` — self-hosted base URL for the
+ *   face-detection assets. Defaults to a public CDN; set when a strict
+ *   CSP blocks it.
+ */
+interface VerifyFaceOptions {
+    defaultDevice?: 'ask' | 'this' | 'mobile';
+    renderQR?: (payload: string) => React.ReactNode;
+    onCancel?: () => void;
+    mediapipeAssetBasePath?: string;
+}
+/** Discriminated result of `runFlow`. */
+type RunFlowResult = {
+    kind: 'not_required';
+    session: CreateEventBasedFaceVerificationSessionResponse;
+} | {
+    kind: 'cancelled';
+    session: CreateEventBasedFaceVerificationSessionResponse;
+} | {
+    kind: 'completed';
+    session: CreateEventBasedFaceVerificationSessionResponse;
+    result: EventBasedFaceVerificationCallback;
+};
 /**
  * Hook for the Event-Based Face Verification face-capture flow.
  *
@@ -530,28 +580,56 @@ declare function getRiskColor(risk: string): string;
  */
 declare function useEventBasedFaceVerificationSubmission(client: KycClient): {
     startSession: (request: CreateEventBasedFaceVerificationSessionRequest) => Promise<CreateEventBasedFaceVerificationSessionResponse>;
-    verifyFace: (session: CreateEventBasedFaceVerificationSessionResponse, opts?: {
-        defaultDevice?: "ask" | "this" | "mobile";
-        renderQR?: (payload: string) => React.ReactNode;
-        onCancel?: () => void;
-        mediapipeAssetBasePath?: string;
-    }) => Promise<EventBasedFaceVerificationCallback | null>;
-    runFlow: (request: CreateEventBasedFaceVerificationSessionRequest, opts?: {
-        defaultDevice?: "ask" | "this" | "mobile";
-        renderQR?: (payload: string) => React.ReactNode;
-        onCancel?: () => void;
-        mediapipeAssetBasePath?: string;
-    }) => Promise<{
-        kind: "not_required";
-        session: CreateEventBasedFaceVerificationSessionResponse;
-    } | {
-        kind: "cancelled";
-        session: CreateEventBasedFaceVerificationSessionResponse;
-    } | {
-        kind: "completed";
-        session: CreateEventBasedFaceVerificationSessionResponse;
-        result: EventBasedFaceVerificationCallback;
-    }>;
+    verifyFace: (session: CreateEventBasedFaceVerificationSessionResponse, opts?: VerifyFaceOptions) => Promise<EventBasedFaceVerificationCallback | null>;
+    runFlow: (request: CreateEventBasedFaceVerificationSessionRequest, opts?: VerifyFaceOptions) => Promise<RunFlowResult>;
 };
 
-export { type UseCustomerProfileOptions, type UseCustomerProfileResult, UseGeolocationOptions, UseGeolocationResult, UseKycAlertsOptions, UseKycAlertsResult, UseKycOverviewOptions, UseKycOverviewResult, UseKycPreferencesResult, UseKycRequestsOptions, UseKycRequestsResult, UseKycSubmissionOptions, UseKycSubmissionResult, UseLocationCaptureOptions, UseLocationCaptureResult, UseLocationRequestsOptions, UseLocationRequestsResult, type UseLoginVerificationOptions, type UseLoginVerificationResult, type UseRegistrationOptions, type UseRegistrationResult, type UseTransactionVerificationOptions, type UseTransactionVerificationResult, createDeviceFingerprint, fileToBase64, formatKycStatus, getBrowserInfo, getRiskColor, getStatusColor, isValidFileSize, isValidFileType, useCipherText, useCustomerProfile, useEventBasedFaceVerificationSubmission, useGeolocation, useKycAlerts, useKycOverview, useKycPreferences, useKycRequests, useKycSubmission, useLocationCapture, useLocationRequests, useLoginVerification, useRegistration, useTransactionVerification };
+interface FaceCaptureModalProps {
+    client: KycClient;
+    session: CreateEventBasedFaceVerificationSessionResponse;
+    onComplete: (result: EventBasedFaceVerificationCallback | null) => void;
+    /**
+     * Optional callback fired when the user dismisses the modal **without
+     * reaching a terminal verification result** — i.e., they click Cancel
+     * in a pre-result stage (choose / qr / capture / error) or close it
+     * via the header close button before the provider returns a final outcome.
+     *
+     * Fires BEFORE `onComplete(null)` so consumers can run cancel-only
+     * logic (analytics, "are you sure?" recovery, etc.) without inspecting
+     * the result parameter.
+     *
+     * NOT fired when the modal closes after a terminal result has been
+     * shown (accepted / declined / max_attempts) — `onComplete(result)`
+     * with the full payload is the right signal for those cases.
+     *
+     * `onComplete(null)` still fires unconditionally for backwards
+     * compatibility with existing integrations that detect cancellation
+     * by checking `result === null`.
+     */
+    onCancel?: () => void;
+    /**
+     * Initial UX. `'ask'` shows the device picker (default on desktop).
+     * `'this'` skips straight to capture (default on mobile). `'mobile'`
+     * skips straight to QR.
+     */
+    defaultDevice?: "ask" | "this" | "mobile";
+    /**
+     * Override the default QR renderer. Receives the payload string and
+     * returns a React node to render inside the QR slot. Default uses a
+     * public QR rendering service (api.qrserver.com).
+     */
+    renderQR?: (payload: string) => React$1.ReactNode;
+    /**
+     * Base URL the MediaPipe face-detection assets (face_detection.js +
+     * companion .wasm/.data/.binarypb files) are loaded from. Defaults to
+     * the jsDelivr CDN. Set this if your CSP blocks jsdelivr.net: self-host
+     * the contents of the @mediapipe/face_detection npm package and point
+     * this at them (e.g. "/mediapipe/face_detection"). If the assets can't
+     * be loaded, the modal falls back to manual capture without detection
+     * guidance — the user is never locked out.
+     */
+    mediapipeAssetBasePath?: string;
+}
+declare function FaceCaptureModal({ client, session, onComplete, onCancel, defaultDevice, renderQR, mediapipeAssetBasePath, }: Readonly<FaceCaptureModalProps>): React$1.ReactElement;
+
+export { FaceCaptureModal, type FaceCaptureModalProps, type RunFlowResult, type UseCustomerProfileOptions, type UseCustomerProfileResult, UseGeolocationOptions, UseGeolocationResult, UseKycAlertsOptions, UseKycAlertsResult, UseKycOverviewOptions, UseKycOverviewResult, UseKycPreferencesResult, UseKycRequestsOptions, UseKycRequestsResult, UseKycSubmissionOptions, UseKycSubmissionResult, UseLocationCaptureOptions, UseLocationCaptureResult, UseLocationRequestsOptions, UseLocationRequestsResult, type UseLoginVerificationOptions, type UseLoginVerificationResult, type UseRegistrationOptions, type UseRegistrationResult, type UseTransactionVerificationOptions, type UseTransactionVerificationResult, type VerifyFaceOptions, buildEventBasedFaceVerificationQrPayload, createDeviceFingerprint, fileToBase64, formatKycStatus, getBrowserInfo, getRiskColor, getStatusColor, isMobileDevice, isValidFileSize, isValidFileType, useCipherText, useCustomerProfile, useEventBasedFaceVerificationSubmission, useGeolocation, useKycAlerts, useKycOverview, useKycPreferences, useKycRequests, useKycSubmission, useLocationCapture, useLocationRequests, useLoginVerification, useRegistration, useTransactionVerification };

package/dist/react.d.ts

@@ -1,8 +1,9 @@
-import { D as DeviceFingerprintRequest, G as GeolocationClient, i as CipherTextOptions, l as CipherTextResult, Y as UseGeolocationOptions, Z as UseGeolocationResult, _ as UseLocationCaptureOptions, $ as UseLocationCaptureResult, a0 as UseLocationRequestsOptions, a1 as UseLocationRequestsResult } from './client-fy3trF2K.js';
-import { e as LoginVerificationResponse, L as LoginVerificationRequest, f as RegistrationVerificationResponse, R as RegistrationVerificationRequest, h as TransactionVerificationResponse, g as TransactionVerificationRequest, C as ComplianceClient } from './client-B3DCAHlg.js';
+import { D as DeviceFingerprintRequest, G as GeolocationClient, i as CipherTextOptions, l as CipherTextResult, Y as UseGeolocationOptions, Z as UseGeolocationResult, _ as UseLocationCaptureOptions, $ as UseLocationCaptureResult, a0 as UseLocationRequestsOptions, a1 as UseLocationRequestsResult } from './client-BaUekQT8.js';
+import { e as LoginVerificationResponse, L as LoginVerificationRequest, f as RegistrationVerificationResponse, R as RegistrationVerificationRequest, h as TransactionVerificationResponse, g as TransactionVerificationRequest, C as ComplianceClient } from './client-DUHC-68_.js';
 import { RiskProfileClient } from './risk-profile/index.js';
 import { C as CustomerProfile } from './types-UGyDl1fd.js';
-import { KycClient, CreateEventBasedFaceVerificationSessionRequest, CreateEventBasedFaceVerificationSessionResponse, EventBasedFaceVerificationCallback, UseKycAlertsOptions, UseKycAlertsResult, UseKycOverviewOptions, UseKycOverviewResult, UseKycPreferencesResult, UseKycRequestsOptions, UseKycRequestsResult, UseKycSubmissionOptions, UseKycSubmissionResult } from './kyc/index.js';
+import { CreateEventBasedFaceVerificationSessionResponse, EventBasedFaceVerificationCallback, KycClient, CreateEventBasedFaceVerificationSessionRequest, UseKycAlertsOptions, UseKycAlertsResult, UseKycOverviewOptions, UseKycOverviewResult, UseKycPreferencesResult, UseKycRequestsOptions, UseKycRequestsResult, UseKycSubmissionOptions, UseKycSubmissionResult } from './kyc/index.js';
+import React$1 from 'react';
 import './client-q9fN8Hhf.js';
 import './types-CBQRNL-l.js';
 
@@ -63,6 +64,12 @@ declare function createDeviceFingerprint(): DeviceFingerprintRequest;
 /**
  * React hook for generating cipherText
  *
+ * The tenant's GPS requirements are read from the client before each generation.
+ * The client reuses a fetched copy for a short period, so this does not add a
+ * request per event, and a requirement changed in the compliance console takes
+ * effect without reloading the page. Call `refreshConfig` to apply a change
+ * immediately.
+ *
  * @example
  * ```tsx
  * function LoginForm() {
@@ -79,6 +86,7 @@ declare function createDeviceFingerprint(): DeviceFingerprintRequest;
  */
 declare function useCipherText(client?: GeolocationClient): {
     generate: (options: CipherTextOptions) => Promise<CipherTextResult | null>;
+    refreshConfig: () => Promise<void>;
     configLoading: boolean;
     configError: Error | null;
 };
@@ -402,7 +410,11 @@ declare function useKycAlerts(client: KycClient, options?: UseKycAlertsOptions):
  */
 declare function useKycOverview(client: KycClient, options?: UseKycOverviewOptions): UseKycOverviewResult;
 /**
- * React hook for managing KYC preferences
+ * React hook for reading KYC preferences
+ *
+ * Preferences are managed in the Vesant console. The returned
+ * `updatePreferences` is deprecated: the platform exposes no update
+ * operation, so it always fails.
  *
  * @param client - KycClient instance
  * @param autoFetch - Auto-fetch preferences on mount (default: true)
@@ -410,31 +422,19 @@ declare function useKycOverview(client: KycClient, options?: UseKycOverviewOptio
  *
  * @example
  * ```tsx
- * function PreferencesForm() {
- *   const { preferences, loading, updatePreferences, refresh } = useKycPreferences(client);
- *
- *   const handleUpdate = async (e: FormEvent) => {
- *     e.preventDefault();
- *     await updatePreferences({
- *       is_face_verification_required: true,
- *       required_document_count: 2
- *     });
- *   };
+ * function PreferencesSummary() {
+ *   const { preferences, loading, refresh } = useKycPreferences(client);
  *
  *   if (loading) return <Spinner />;
  *
  *   return (
- *     <form onSubmit={handleUpdate}>
- *       <Checkbox
- *         label="Require Face Verification"
- *         checked={preferences?.is_face_verification_required}
- *       />
- *       <NumberInput
- *         label="Required Documents"
- *         value={preferences?.required_document_count}
- *       />
- *       <Button type="submit">Save</Button>
- *     </form>
+ *     <dl>
+ *       <dt>Face verification required</dt>
+ *       <dd>{String(preferences?.is_face_verification_required)}</dd>
+ *       <dt>Required documents</dt>
+ *       <dd>{preferences?.required_document_count}</dd>
+ *       <button onClick={refresh}>Refresh</button>
+ *     </dl>
  *   );
  * }
  * ```
@@ -511,6 +511,56 @@ declare function getStatusColor(status: string): string;
  * @returns CSS color class or hex color
  */
 declare function getRiskColor(risk: string): string;
+/**
+ * Detect whether the current browser is a mobile device. The check is
+ * deliberately conservative — anything that doesn't match the mobile
+ * pattern is treated as desktop and gets the QR handoff flow.
+ *
+ * Server-side device detection is intentionally absent; the SDK is the
+ * authority on UX selection.
+ */
+declare function isMobileDevice(userAgent?: string): boolean;
+/**
+ * Build the opaque QR payload a desktop client renders for the mobile
+ * device to scan. Format matches the normal-KYC mobile-handoff scheme so
+ * a single mobile app can handle both flows.
+ */
+declare function buildEventBasedFaceVerificationQrPayload(token: string): string;
+/**
+ * Options for `verifyFace` / `runFlow`. Mirrors `FaceCaptureModalProps`.
+ *
+ * - `defaultDevice` — `'ask'` (default on desktop) shows the device
+ *   picker; `'this'` skips straight to capture; `'mobile'` skips
+ *   straight to the QR handoff. Default on mobile is `'this'`. Ignored
+ *   when the session carries a `verification_url` (hosted journey).
+ * - `renderQR` — bring-your-own QR renderer. Default uses a public QR
+ *   rendering service.
+ * - `onCancel` — fires when the user dismisses the modal without
+ *   reaching a terminal verification result (cancel button or close
+ *   icon). The verifyFace promise still resolves with `null` for the
+ *   same case, so this callback is purely a side-effect hook.
+ * - `mediapipeAssetBasePath` — self-hosted base URL for the
+ *   face-detection assets. Defaults to a public CDN; set when a strict
+ *   CSP blocks it.
+ */
+interface VerifyFaceOptions {
+    defaultDevice?: 'ask' | 'this' | 'mobile';
+    renderQR?: (payload: string) => React.ReactNode;
+    onCancel?: () => void;
+    mediapipeAssetBasePath?: string;
+}
+/** Discriminated result of `runFlow`. */
+type RunFlowResult = {
+    kind: 'not_required';
+    session: CreateEventBasedFaceVerificationSessionResponse;
+} | {
+    kind: 'cancelled';
+    session: CreateEventBasedFaceVerificationSessionResponse;
+} | {
+    kind: 'completed';
+    session: CreateEventBasedFaceVerificationSessionResponse;
+    result: EventBasedFaceVerificationCallback;
+};
 /**
  * Hook for the Event-Based Face Verification face-capture flow.
  *
@@ -530,28 +580,56 @@ declare function getRiskColor(risk: string): string;
  */
 declare function useEventBasedFaceVerificationSubmission(client: KycClient): {
     startSession: (request: CreateEventBasedFaceVerificationSessionRequest) => Promise<CreateEventBasedFaceVerificationSessionResponse>;
-    verifyFace: (session: CreateEventBasedFaceVerificationSessionResponse, opts?: {
-        defaultDevice?: "ask" | "this" | "mobile";
-        renderQR?: (payload: string) => React.ReactNode;
-        onCancel?: () => void;
-        mediapipeAssetBasePath?: string;
-    }) => Promise<EventBasedFaceVerificationCallback | null>;
-    runFlow: (request: CreateEventBasedFaceVerificationSessionRequest, opts?: {
-        defaultDevice?: "ask" | "this" | "mobile";
-        renderQR?: (payload: string) => React.ReactNode;
-        onCancel?: () => void;
-        mediapipeAssetBasePath?: string;
-    }) => Promise<{
-        kind: "not_required";
-        session: CreateEventBasedFaceVerificationSessionResponse;
-    } | {
-        kind: "cancelled";
-        session: CreateEventBasedFaceVerificationSessionResponse;
-    } | {
-        kind: "completed";
-        session: CreateEventBasedFaceVerificationSessionResponse;
-        result: EventBasedFaceVerificationCallback;
-    }>;
+    verifyFace: (session: CreateEventBasedFaceVerificationSessionResponse, opts?: VerifyFaceOptions) => Promise<EventBasedFaceVerificationCallback | null>;
+    runFlow: (request: CreateEventBasedFaceVerificationSessionRequest, opts?: VerifyFaceOptions) => Promise<RunFlowResult>;
 };
 
-export { type UseCustomerProfileOptions, type UseCustomerProfileResult, UseGeolocationOptions, UseGeolocationResult, UseKycAlertsOptions, UseKycAlertsResult, UseKycOverviewOptions, UseKycOverviewResult, UseKycPreferencesResult, UseKycRequestsOptions, UseKycRequestsResult, UseKycSubmissionOptions, UseKycSubmissionResult, UseLocationCaptureOptions, UseLocationCaptureResult, UseLocationRequestsOptions, UseLocationRequestsResult, type UseLoginVerificationOptions, type UseLoginVerificationResult, type UseRegistrationOptions, type UseRegistrationResult, type UseTransactionVerificationOptions, type UseTransactionVerificationResult, createDeviceFingerprint, fileToBase64, formatKycStatus, getBrowserInfo, getRiskColor, getStatusColor, isValidFileSize, isValidFileType, useCipherText, useCustomerProfile, useEventBasedFaceVerificationSubmission, useGeolocation, useKycAlerts, useKycOverview, useKycPreferences, useKycRequests, useKycSubmission, useLocationCapture, useLocationRequests, useLoginVerification, useRegistration, useTransactionVerification };
+interface FaceCaptureModalProps {
+    client: KycClient;
+    session: CreateEventBasedFaceVerificationSessionResponse;
+    onComplete: (result: EventBasedFaceVerificationCallback | null) => void;
+    /**
+     * Optional callback fired when the user dismisses the modal **without
+     * reaching a terminal verification result** — i.e., they click Cancel
+     * in a pre-result stage (choose / qr / capture / error) or close it
+     * via the header close button before the provider returns a final outcome.
+     *
+     * Fires BEFORE `onComplete(null)` so consumers can run cancel-only
+     * logic (analytics, "are you sure?" recovery, etc.) without inspecting
+     * the result parameter.
+     *
+     * NOT fired when the modal closes after a terminal result has been
+     * shown (accepted / declined / max_attempts) — `onComplete(result)`
+     * with the full payload is the right signal for those cases.
+     *
+     * `onComplete(null)` still fires unconditionally for backwards
+     * compatibility with existing integrations that detect cancellation
+     * by checking `result === null`.
+     */
+    onCancel?: () => void;
+    /**
+     * Initial UX. `'ask'` shows the device picker (default on desktop).
+     * `'this'` skips straight to capture (default on mobile). `'mobile'`
+     * skips straight to QR.
+     */
+    defaultDevice?: "ask" | "this" | "mobile";
+    /**
+     * Override the default QR renderer. Receives the payload string and
+     * returns a React node to render inside the QR slot. Default uses a
+     * public QR rendering service (api.qrserver.com).
+     */
+    renderQR?: (payload: string) => React$1.ReactNode;
+    /**
+     * Base URL the MediaPipe face-detection assets (face_detection.js +
+     * companion .wasm/.data/.binarypb files) are loaded from. Defaults to
+     * the jsDelivr CDN. Set this if your CSP blocks jsdelivr.net: self-host
+     * the contents of the @mediapipe/face_detection npm package and point
+     * this at them (e.g. "/mediapipe/face_detection"). If the assets can't
+     * be loaded, the modal falls back to manual capture without detection
+     * guidance — the user is never locked out.
+     */
+    mediapipeAssetBasePath?: string;
+}
+declare function FaceCaptureModal({ client, session, onComplete, onCancel, defaultDevice, renderQR, mediapipeAssetBasePath, }: Readonly<FaceCaptureModalProps>): React$1.ReactElement;
+
+export { FaceCaptureModal, type FaceCaptureModalProps, type RunFlowResult, type UseCustomerProfileOptions, type UseCustomerProfileResult, UseGeolocationOptions, UseGeolocationResult, UseKycAlertsOptions, UseKycAlertsResult, UseKycOverviewOptions, UseKycOverviewResult, UseKycPreferencesResult, UseKycRequestsOptions, UseKycRequestsResult, UseKycSubmissionOptions, UseKycSubmissionResult, UseLocationCaptureOptions, UseLocationCaptureResult, UseLocationRequestsOptions, UseLocationRequestsResult, type UseLoginVerificationOptions, type UseLoginVerificationResult, type UseRegistrationOptions, type UseRegistrationResult, type UseTransactionVerificationOptions, type UseTransactionVerificationResult, type VerifyFaceOptions, buildEventBasedFaceVerificationQrPayload, createDeviceFingerprint, fileToBase64, formatKycStatus, getBrowserInfo, getRiskColor, getStatusColor, isMobileDevice, isValidFileSize, isValidFileType, useCipherText, useCustomerProfile, useEventBasedFaceVerificationSubmission, useGeolocation, useKycAlerts, useKycOverview, useKycPreferences, useKycRequests, useKycSubmission, useLocationCapture, useLocationRequests, useLoginVerification, useRegistration, useTransactionVerification };