vesant-sdk 1.7.1-next.edfc6a6 → 1.7.2-dev.03a9c84

package/README.md

@@ -355,6 +355,10 @@ interface ComplianceClientConfig {
 | `listKycRequests(filters)` | List KYC requests |
 | `getPreferences()` | Get KYC preferences |
 | `listAlerts(filters)` | List KYC alerts |
+| `createEventBasedFaceVerificationSession(request)` | Start a face re-verification session (backend) |
+| `submitEventBasedFaceVerificationSession(request)` | Submit a face capture for a session |
+| `getEventBasedFaceVerificationSessionStatus(token)` | Look up a session's current result |
+| `retryEventBasedFaceVerificationJourney(token)` | Mint the next hosted journey after a decline |
 
 ## Documentation
 

package/dist/{client-D23KhWeh.d.mts → client-5q4whhGu.d.mts}

@@ -1,4 +1,4 @@
-import { D as DeviceFingerprintRequest, L as LocationVerification, V as ValidateCipherTextResponse, a as LocationRequest, G as GeolocationClient, b as LocationRequestFilters, c as LocationRequestListResponse } from './client-BwXMQA2a.mjs';
+import { D as DeviceFingerprintRequest, L as LocationVerification, V as ValidateCipherTextResponse, a as LocationRequest, G as GeolocationClient, b as LocationRequestFilters, c as LocationRequestListResponse } from './client-XDEhh9VN.mjs';
 import { RiskProfileClient } from './risk-profile/index.mjs';
 import { V as VesantConfig, R as RequestOptions } from './client-q9fN8Hhf.mjs';
 import { C as CustomerProfile } from './types-BOFaMQxI.mjs';

package/dist/{client-fy3trF2K.d.ts → client-BaUekQT8.d.ts}

@@ -534,6 +534,15 @@ interface GeolocationClientConfig {
     logger?: Logger;
     /** Environment mode - 'sandbox' uses isolated sandbox data */
     environment?: 'production' | 'sandbox';
+    /**
+     * How long a fetched GPS requirement config is reused before it is read again,
+     * in milliseconds (default: 300000, i.e. 5 minutes).
+     *
+     * These requirements are edited in the compliance console while your
+     * application is running, so a lower value makes changes take effect sooner at
+     * the cost of more requests. Use `refreshGPSConfig()` to re-read immediately.
+     */
+    gpsConfigTtlMs?: number;
 }
 interface UseGeolocationOptions {
     /** Auto-detect and verify user's IP on mount */
@@ -786,17 +795,9 @@ interface UseLocationCaptureResult {
  * Extends BaseClient for consistent retry logic, timeout handling, and error management.
  */
 
-/**
- * GeolocationClient extends BaseClient for:
- * - Consistent retry logic with exponential backoff
- * - Unified error handling (VesantError, NetworkError, TimeoutError, etc.)
- * - Automatic timeout management
- * - Debug logging
- *
- * All geolocation verification calls use requestWithRetry() to handle
- * transient failures gracefully.
- */
 declare class GeolocationClient extends BaseClient {
+    private readonly gpsConfigTtlMs;
+    private gpsConfigCache;
     constructor(config: GeolocationClientConfig);
     /**
      * Verify an IP address and check compliance
@@ -857,6 +858,27 @@ declare class GeolocationClient extends BaseClient {
      * ```
      */
     getGPSConfig(requestOptions?: RequestOptions): Promise<GeolocationConfigResponse>;
+    /**
+     * Re-read the tenant's GPS requirement configuration, ignoring any copy held
+     * from an earlier read.
+     *
+     * These requirements are edited in the compliance console while your
+     * application is running. `getGPSConfig` reuses a fetched copy for a short
+     * period so a long-lived session does not call the API on every event; call
+     * this when you need a change to take effect immediately — for example right
+     * after an administrator saves new settings.
+     *
+     * @returns The current GPS requirement config per event type
+     *
+     * @example
+     * ```typescript
+     * const config = await client.refreshGPSConfig();
+     * if (config.require_gps.login) {
+     *   // GPS is now required for login
+     * }
+     * ```
+     */
+    refreshGPSConfig(requestOptions?: RequestOptions): Promise<GeolocationConfigResponse>;
     /**
      * Mint a short-lived, single-use device-signals nonce.
      *

package/dist/{client-B3DCAHlg.d.ts → client-DUHC-68_.d.ts}

@@ -1,4 +1,4 @@
-import { D as DeviceFingerprintRequest, L as LocationVerification, V as ValidateCipherTextResponse, a as LocationRequest, G as GeolocationClient, b as LocationRequestFilters, c as LocationRequestListResponse } from './client-fy3trF2K.js';
+import { D as DeviceFingerprintRequest, L as LocationVerification, V as ValidateCipherTextResponse, a as LocationRequest, G as GeolocationClient, b as LocationRequestFilters, c as LocationRequestListResponse } from './client-BaUekQT8.js';
 import { RiskProfileClient } from './risk-profile/index.js';
 import { V as VesantConfig, R as RequestOptions } from './client-q9fN8Hhf.js';
 import { C as CustomerProfile } from './types-UGyDl1fd.js';

package/dist/{client-BwXMQA2a.d.mts → client-XDEhh9VN.d.mts}

@@ -534,6 +534,15 @@ interface GeolocationClientConfig {
     logger?: Logger;
     /** Environment mode - 'sandbox' uses isolated sandbox data */
     environment?: 'production' | 'sandbox';
+    /**
+     * How long a fetched GPS requirement config is reused before it is read again,
+     * in milliseconds (default: 300000, i.e. 5 minutes).
+     *
+     * These requirements are edited in the compliance console while your
+     * application is running, so a lower value makes changes take effect sooner at
+     * the cost of more requests. Use `refreshGPSConfig()` to re-read immediately.
+     */
+    gpsConfigTtlMs?: number;
 }
 interface UseGeolocationOptions {
     /** Auto-detect and verify user's IP on mount */
@@ -786,17 +795,9 @@ interface UseLocationCaptureResult {
  * Extends BaseClient for consistent retry logic, timeout handling, and error management.
  */
 
-/**
- * GeolocationClient extends BaseClient for:
- * - Consistent retry logic with exponential backoff
- * - Unified error handling (VesantError, NetworkError, TimeoutError, etc.)
- * - Automatic timeout management
- * - Debug logging
- *
- * All geolocation verification calls use requestWithRetry() to handle
- * transient failures gracefully.
- */
 declare class GeolocationClient extends BaseClient {
+    private readonly gpsConfigTtlMs;
+    private gpsConfigCache;
     constructor(config: GeolocationClientConfig);
     /**
      * Verify an IP address and check compliance
@@ -857,6 +858,27 @@ declare class GeolocationClient extends BaseClient {
      * ```
      */
     getGPSConfig(requestOptions?: RequestOptions): Promise<GeolocationConfigResponse>;
+    /**
+     * Re-read the tenant's GPS requirement configuration, ignoring any copy held
+     * from an earlier read.
+     *
+     * These requirements are edited in the compliance console while your
+     * application is running. `getGPSConfig` reuses a fetched copy for a short
+     * period so a long-lived session does not call the API on every event; call
+     * this when you need a change to take effect immediately — for example right
+     * after an administrator saves new settings.
+     *
+     * @returns The current GPS requirement config per event type
+     *
+     * @example
+     * ```typescript
+     * const config = await client.refreshGPSConfig();
+     * if (config.require_gps.login) {
+     *   // GPS is now required for login
+     * }
+     * ```
+     */
+    refreshGPSConfig(requestOptions?: RequestOptions): Promise<GeolocationConfigResponse>;
     /**
      * Mint a short-lived, single-use device-signals nonce.
      *

package/dist/compliance/index.d.mts

@@ -1,6 +1,6 @@
 import { B as BlockReason } from '../types-CBQRNL-l.mjs';
-export { C as ComplianceClient, a as ComplianceLocationRequestInput, b as ComplianceLocationRequestResult, c as CurrencyRates, D as DEFAULT_CURRENCY_RATES, E as EventVerificationRequest, d as EventVerificationResponse, L as LoginVerificationRequest, e as LoginVerificationResponse, R as RegistrationVerificationRequest, f as RegistrationVerificationResponse, T as TransactionRiskResult, g as TransactionVerificationRequest, h as TransactionVerificationResponse } from '../client-D23KhWeh.mjs';
-export { p as CreateLocationRequestRequest, I as LocationCaptureRequest, K as LocationCaptureResponse, a as LocationRequest, M as LocationRequestChannel, b as LocationRequestFilters, c as LocationRequestListResponse, N as LocationRequestResult, O as LocationRequestStatus, P as LocationShareInfo, R as ResendLocationRequestRequest } from '../client-BwXMQA2a.mjs';
+export { C as ComplianceClient, a as ComplianceLocationRequestInput, b as ComplianceLocationRequestResult, c as CurrencyRates, D as DEFAULT_CURRENCY_RATES, E as EventVerificationRequest, d as EventVerificationResponse, L as LoginVerificationRequest, e as LoginVerificationResponse, R as RegistrationVerificationRequest, f as RegistrationVerificationResponse, T as TransactionRiskResult, g as TransactionVerificationRequest, h as TransactionVerificationResponse } from '../client-5q4whhGu.mjs';
+export { p as CreateLocationRequestRequest, I as LocationCaptureRequest, K as LocationCaptureResponse, a as LocationRequest, M as LocationRequestChannel, b as LocationRequestFilters, c as LocationRequestListResponse, N as LocationRequestResult, O as LocationRequestStatus, P as LocationShareInfo, R as ResendLocationRequestRequest } from '../client-XDEhh9VN.mjs';
 import '../risk-profile/index.mjs';
 import '../client-q9fN8Hhf.mjs';
 import '../types-BOFaMQxI.mjs';

package/dist/compliance/index.d.ts

@@ -1,6 +1,6 @@
 import { B as BlockReason } from '../types-CBQRNL-l.js';
-export { C as ComplianceClient, a as ComplianceLocationRequestInput, b as ComplianceLocationRequestResult, c as CurrencyRates, D as DEFAULT_CURRENCY_RATES, E as EventVerificationRequest, d as EventVerificationResponse, L as LoginVerificationRequest, e as LoginVerificationResponse, R as RegistrationVerificationRequest, f as RegistrationVerificationResponse, T as TransactionRiskResult, g as TransactionVerificationRequest, h as TransactionVerificationResponse } from '../client-B3DCAHlg.js';
-export { p as CreateLocationRequestRequest, I as LocationCaptureRequest, K as LocationCaptureResponse, a as LocationRequest, M as LocationRequestChannel, b as LocationRequestFilters, c as LocationRequestListResponse, N as LocationRequestResult, O as LocationRequestStatus, P as LocationShareInfo, R as ResendLocationRequestRequest } from '../client-fy3trF2K.js';
+export { C as ComplianceClient, a as ComplianceLocationRequestInput, b as ComplianceLocationRequestResult, c as CurrencyRates, D as DEFAULT_CURRENCY_RATES, E as EventVerificationRequest, d as EventVerificationResponse, L as LoginVerificationRequest, e as LoginVerificationResponse, R as RegistrationVerificationRequest, f as RegistrationVerificationResponse, T as TransactionRiskResult, g as TransactionVerificationRequest, h as TransactionVerificationResponse } from '../client-DUHC-68_.js';
+export { p as CreateLocationRequestRequest, I as LocationCaptureRequest, K as LocationCaptureResponse, a as LocationRequest, M as LocationRequestChannel, b as LocationRequestFilters, c as LocationRequestListResponse, N as LocationRequestResult, O as LocationRequestStatus, P as LocationShareInfo, R as ResendLocationRequestRequest } from '../client-BaUekQT8.js';
 import '../risk-profile/index.js';
 import '../client-q9fN8Hhf.js';
 import '../types-UGyDl1fd.js';

package/dist/compliance/index.js

@@ -312,7 +312,7 @@ function createConsoleLogger() {
 }
 
 // src/core/version.ts
-var SDK_VERSION = "1.7.1";
+var SDK_VERSION = "1.7.2";
 
 // src/shared/browser-utils.ts
 function generateUUID() {
@@ -969,6 +969,7 @@ async function generateCipherText(options, config) {
 }
 
 // src/geolocation/client.ts
+var DEFAULT_GPS_CONFIG_TTL_MS = 5 * 60 * 1e3;
 var GeolocationClient = class extends BaseClient {
   constructor(config) {
     const baseConfig = {
@@ -984,6 +985,8 @@ var GeolocationClient = class extends BaseClient {
       environment: config.environment
     };
     super(baseConfig);
+    this.gpsConfigCache = null;
+    this.gpsConfigTtlMs = config.gpsConfigTtlMs ?? DEFAULT_GPS_CONFIG_TTL_MS;
   }
   // ============================================================================
   // IP Verification & Compliance
@@ -1069,7 +1072,42 @@ var GeolocationClient = class extends BaseClient {
    * ```
    */
   async getGPSConfig(requestOptions) {
-    return this.requestWithRetry("/api/v1/geo/config", void 0, void 0, void 0, requestOptions);
+    const cached = this.gpsConfigCache;
+    if (cached && cached.expiresAt > Date.now()) {
+      return cached.value;
+    }
+    return this.refreshGPSConfig(requestOptions);
+  }
+  /**
+   * Re-read the tenant's GPS requirement configuration, ignoring any copy held
+   * from an earlier read.
+   *
+   * These requirements are edited in the compliance console while your
+   * application is running. `getGPSConfig` reuses a fetched copy for a short
+   * period so a long-lived session does not call the API on every event; call
+   * this when you need a change to take effect immediately — for example right
+   * after an administrator saves new settings.
+   *
+   * @returns The current GPS requirement config per event type
+   *
+   * @example
+   * ```typescript
+   * const config = await client.refreshGPSConfig();
+   * if (config.require_gps.login) {
+   *   // GPS is now required for login
+   * }
+   * ```
+   */
+  async refreshGPSConfig(requestOptions) {
+    const value = await this.requestWithRetry(
+      "/api/v1/geo/config",
+      void 0,
+      void 0,
+      void 0,
+      requestOptions
+    );
+    this.gpsConfigCache = { value, expiresAt: Date.now() + this.gpsConfigTtlMs };
+    return value;
   }
   /**
    * Mint a short-lived, single-use device-signals nonce.