vesant-sdk 1.7.1-dev.9fc141f → 1.7.1-dev.a461ee2

package/dist/kyc/index.d.mts

@@ -571,6 +571,13 @@ interface CreateEventBasedFaceVerificationSessionResponse {
      * (`reuse_kyc_reactions.max_retry_attempts + 1`).
      */
     max_attempts: number;
+    /**
+     * Hosted verification journey URL. When present, the capture runs on a
+     * hosted page (embedded by `FaceCaptureModal` in an iframe) instead of the
+     * SDK's local camera; the verdict is read via the session status poll.
+     * Absent when the platform runs the local-capture flow.
+     */
+    verification_url?: string;
 }
 /**
  * Reaction outcome returned on every face-submit callback. Tenant apps
@@ -619,9 +626,10 @@ interface EventBasedFaceVerificationCallback {
     data: EventBasedFaceVerificationReactionResult;
 }
 /**
- * Server-side handoff session backed by Redis (TTL: 15 minutes). Shared
- * with the normal KYC mobile/desktop handoff. Desktop clients poll this
- * to detect when a mobile device has attached to the same token via QR.
+ * Server-side handoff state backed by the normal KYC Redis store (15-minute
+ * cache TTL). Event-Based Face Verification remains valid for 10 minutes;
+ * this cache does not extend that session. Desktop clients poll it to detect
+ * when a mobile device has attached to the same token via QR.
  */
 interface KycHandoffSession {
     document: string;
@@ -879,10 +887,9 @@ declare class KycClient extends BaseClient {
      * Create a Event-Based Face Verification session.
      *
      * Inspect the response before showing UI:
-     * - `is_required === false` → skip face capture; `reason` explains why.
-     * - `device_type === 'desktop'` → render `qr_payload` as a QR; the
-     *   mobile device picks up the session via the connect endpoint.
-     * - `device_type === 'mobile'` → open the face capture modal directly.
+     * - `is_required === false` → skip face verification; `reason` explains why.
+     * - `verification_url` present → embed the hosted journey and poll status.
+     * - `verification_url` absent → use the local camera / QR fallback.
      *
      * @param request - Reference, customer_id, event, amount (for threshold events), optional URLs.
      */
@@ -912,11 +919,22 @@ declare class KycClient extends BaseClient {
      * @param token - The session token returned by `createEventBasedFaceVerificationSession`.
      */
     getEventBasedFaceVerificationSessionStatus(token: string): Promise<EventBasedFaceVerificationCallback>;
+    /**
+     * Mint a fresh hosted verification journey for the next attempt on an
+     * active session whose previous hosted-journey attempt was declined.
+     * Only valid while the session is active and attempts remain; the
+     * response carries the new `verification_url` to embed. Used internally
+     * by `FaceCaptureModal`'s Try Again flow in hosted-journey mode.
+     *
+     * @param token - The session token returned by `createEventBasedFaceVerificationSession`.
+     */
+    retryEventBasedFaceVerificationJourney(token: string): Promise<CreateEventBasedFaceVerificationSessionResponse>;
     /**
      * Fetch the Redis-backed handoff session for a token. Same backing
-     * store as normal KYC (`kyc:session:<token>`, 15-minute TTL). Desktop
-     * callers poll `mobile_connected` to detect when a mobile device has
-     * scanned the QR and attached.
+     * store as normal KYC (`kyc:session:<token>`, 15-minute TTL). The
+     * Event-Based Face Verification database session still expires after
+     * 10 minutes. Desktop callers poll `mobile_connected` to detect when a
+     * mobile device has scanned the QR and attached.
      *
      * @param token - The session token returned by `createEventBasedFaceVerificationSession`.
      */

package/dist/kyc/index.d.ts

@@ -571,6 +571,13 @@ interface CreateEventBasedFaceVerificationSessionResponse {
      * (`reuse_kyc_reactions.max_retry_attempts + 1`).
      */
     max_attempts: number;
+    /**
+     * Hosted verification journey URL. When present, the capture runs on a
+     * hosted page (embedded by `FaceCaptureModal` in an iframe) instead of the
+     * SDK's local camera; the verdict is read via the session status poll.
+     * Absent when the platform runs the local-capture flow.
+     */
+    verification_url?: string;
 }
 /**
  * Reaction outcome returned on every face-submit callback. Tenant apps
@@ -619,9 +626,10 @@ interface EventBasedFaceVerificationCallback {
     data: EventBasedFaceVerificationReactionResult;
 }
 /**
- * Server-side handoff session backed by Redis (TTL: 15 minutes). Shared
- * with the normal KYC mobile/desktop handoff. Desktop clients poll this
- * to detect when a mobile device has attached to the same token via QR.
+ * Server-side handoff state backed by the normal KYC Redis store (15-minute
+ * cache TTL). Event-Based Face Verification remains valid for 10 minutes;
+ * this cache does not extend that session. Desktop clients poll it to detect
+ * when a mobile device has attached to the same token via QR.
  */
 interface KycHandoffSession {
     document: string;
@@ -879,10 +887,9 @@ declare class KycClient extends BaseClient {
      * Create a Event-Based Face Verification session.
      *
      * Inspect the response before showing UI:
-     * - `is_required === false` → skip face capture; `reason` explains why.
-     * - `device_type === 'desktop'` → render `qr_payload` as a QR; the
-     *   mobile device picks up the session via the connect endpoint.
-     * - `device_type === 'mobile'` → open the face capture modal directly.
+     * - `is_required === false` → skip face verification; `reason` explains why.
+     * - `verification_url` present → embed the hosted journey and poll status.
+     * - `verification_url` absent → use the local camera / QR fallback.
      *
      * @param request - Reference, customer_id, event, amount (for threshold events), optional URLs.
      */
@@ -912,11 +919,22 @@ declare class KycClient extends BaseClient {
      * @param token - The session token returned by `createEventBasedFaceVerificationSession`.
      */
     getEventBasedFaceVerificationSessionStatus(token: string): Promise<EventBasedFaceVerificationCallback>;
+    /**
+     * Mint a fresh hosted verification journey for the next attempt on an
+     * active session whose previous hosted-journey attempt was declined.
+     * Only valid while the session is active and attempts remain; the
+     * response carries the new `verification_url` to embed. Used internally
+     * by `FaceCaptureModal`'s Try Again flow in hosted-journey mode.
+     *
+     * @param token - The session token returned by `createEventBasedFaceVerificationSession`.
+     */
+    retryEventBasedFaceVerificationJourney(token: string): Promise<CreateEventBasedFaceVerificationSessionResponse>;
     /**
      * Fetch the Redis-backed handoff session for a token. Same backing
-     * store as normal KYC (`kyc:session:<token>`, 15-minute TTL). Desktop
-     * callers poll `mobile_connected` to detect when a mobile device has
-     * scanned the QR and attached.
+     * store as normal KYC (`kyc:session:<token>`, 15-minute TTL). The
+     * Event-Based Face Verification database session still expires after
+     * 10 minutes. Desktop callers poll `mobile_connected` to detect when a
+     * mobile device has scanned the QR and attached.
      *
      * @param token - The session token returned by `createEventBasedFaceVerificationSession`.
      */

package/dist/kyc/index.js

@@ -704,10 +704,9 @@ var KycClient = class extends BaseClient {
    * Create a Event-Based Face Verification session.
    *
    * Inspect the response before showing UI:
-   * - `is_required === false` → skip face capture; `reason` explains why.
-   * - `device_type === 'desktop'` → render `qr_payload` as a QR; the
-   *   mobile device picks up the session via the connect endpoint.
-   * - `device_type === 'mobile'` → open the face capture modal directly.
+   * - `is_required === false` → skip face verification; `reason` explains why.
+   * - `verification_url` present → embed the hosted journey and poll status.
+   * - `verification_url` absent → use the local camera / QR fallback.
    *
    * @param request - Reference, customer_id, event, amount (for threshold events), optional URLs.
    */
@@ -754,11 +753,28 @@ var KycClient = class extends BaseClient {
       headers: this.getUserHeaders()
     });
   }
+  /**
+   * Mint a fresh hosted verification journey for the next attempt on an
+   * active session whose previous hosted-journey attempt was declined.
+   * Only valid while the session is active and attempts remain; the
+   * response carries the new `verification_url` to embed. Used internally
+   * by `FaceCaptureModal`'s Try Again flow in hosted-journey mode.
+   *
+   * @param token - The session token returned by `createEventBasedFaceVerificationSession`.
+   */
+  async retryEventBasedFaceVerificationJourney(token) {
+    return this.request("/api/v1/kyc/face/onsite/journey", {
+      method: "POST",
+      body: JSON.stringify({ token }),
+      headers: this.getUserHeaders()
+    });
+  }
   /**
    * Fetch the Redis-backed handoff session for a token. Same backing
-   * store as normal KYC (`kyc:session:<token>`, 15-minute TTL). Desktop
-   * callers poll `mobile_connected` to detect when a mobile device has
-   * scanned the QR and attached.
+   * store as normal KYC (`kyc:session:<token>`, 15-minute TTL). The
+   * Event-Based Face Verification database session still expires after
+   * 10 minutes. Desktop callers poll `mobile_connected` to detect when a
+   * mobile device has scanned the QR and attached.
    *
    * @param token - The session token returned by `createEventBasedFaceVerificationSession`.
    */