vesant-sdk 1.7.2 → 1.8.0-dev.0a33430

package/dist/react.d.mts

@@ -1,7 +1,7 @@
-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-CJI8VO1i.mjs';
 import { RiskProfileClient } from './risk-profile/index.mjs';
-import { C as CustomerProfile } from './types-BOFaMQxI.mjs';
+import { C as CustomerProfile, j as UpdateProfileResult } from './types-DfbnIaW_.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';
@@ -64,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() {
@@ -80,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;
 };
@@ -214,7 +221,13 @@ interface UseCustomerProfileResult {
     loading: boolean;
     error: Error | null;
     fetchProfile: () => Promise<CustomerProfile>;
-    updateProfile: (updates: Partial<CustomerProfile>) => Promise<CustomerProfile>;
+    /**
+     * Update the loaded profile. Resolves to the updated profile, or to a
+     * `ProfileUpdateHeldResponse` when the tenant holds a name / date of birth /
+     * address change behind KYC — narrow with `isProfileUpdateHeld`. The hook's
+     * `profile` state is updated either way (with the profile as stored).
+     */
+    updateProfile: (updates: Partial<CustomerProfile>) => Promise<UpdateProfileResult>;
     refresh: () => Promise<CustomerProfile>;
 }
 /**
@@ -330,6 +343,9 @@ declare function useKycSubmission(client: KycClient, options?: UseKycSubmissionO
  *   );
  * }
  * ```
+ *
+ * @remarks Console session only: `listKycRequests` and `updateKycStatus` need a
+ * dashboard login token. Only `getKycRequest` works with a tenant API key.
  */
 declare function useKycRequests(client: KycClient, options?: UseKycRequestsOptions): UseKycRequestsResult;
 /**
@@ -369,6 +385,9 @@ declare function useKycRequests(client: KycClient, options?: UseKycRequestsOptio
  *   );
  * }
  * ```
+ *
+ * @remarks Console session only: the alert endpoints need a dashboard login
+ * token and fail with a tenant API key.
  */
 declare function useKycAlerts(client: KycClient, options?: UseKycAlertsOptions): UseKycAlertsResult;
 /**
@@ -400,6 +419,9 @@ declare function useKycAlerts(client: KycClient, options?: UseKycAlertsOptions):
  *   );
  * }
  * ```
+ *
+ * @remarks Console session only: the overview endpoint needs a dashboard login
+ * token and fails with a tenant API key.
  */
 declare function useKycOverview(client: KycClient, options?: UseKycOverviewOptions): UseKycOverviewResult;
 /**
@@ -431,6 +453,9 @@ declare function useKycOverview(client: KycClient, options?: UseKycOverviewOptio
  *   );
  * }
  * ```
+ *
+ * @remarks Console session only: the preferences endpoints need a dashboard
+ * login token and fail with a tenant API key.
  */
 declare function useKycPreferences(client: KycClient, autoFetch?: boolean): UseKycPreferencesResult;
 /**

package/dist/react.d.ts

@@ -1,7 +1,7 @@
-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-4oLoc31v.js';
 import { RiskProfileClient } from './risk-profile/index.js';
-import { C as CustomerProfile } from './types-UGyDl1fd.js';
+import { C as CustomerProfile, j as UpdateProfileResult } from './types-1kI4SsKB.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';
@@ -64,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() {
@@ -80,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;
 };
@@ -214,7 +221,13 @@ interface UseCustomerProfileResult {
     loading: boolean;
     error: Error | null;
     fetchProfile: () => Promise<CustomerProfile>;
-    updateProfile: (updates: Partial<CustomerProfile>) => Promise<CustomerProfile>;
+    /**
+     * Update the loaded profile. Resolves to the updated profile, or to a
+     * `ProfileUpdateHeldResponse` when the tenant holds a name / date of birth /
+     * address change behind KYC — narrow with `isProfileUpdateHeld`. The hook's
+     * `profile` state is updated either way (with the profile as stored).
+     */
+    updateProfile: (updates: Partial<CustomerProfile>) => Promise<UpdateProfileResult>;
     refresh: () => Promise<CustomerProfile>;
 }
 /**
@@ -330,6 +343,9 @@ declare function useKycSubmission(client: KycClient, options?: UseKycSubmissionO
  *   );
  * }
  * ```
+ *
+ * @remarks Console session only: `listKycRequests` and `updateKycStatus` need a
+ * dashboard login token. Only `getKycRequest` works with a tenant API key.
  */
 declare function useKycRequests(client: KycClient, options?: UseKycRequestsOptions): UseKycRequestsResult;
 /**
@@ -369,6 +385,9 @@ declare function useKycRequests(client: KycClient, options?: UseKycRequestsOptio
  *   );
  * }
  * ```
+ *
+ * @remarks Console session only: the alert endpoints need a dashboard login
+ * token and fail with a tenant API key.
  */
 declare function useKycAlerts(client: KycClient, options?: UseKycAlertsOptions): UseKycAlertsResult;
 /**
@@ -400,6 +419,9 @@ declare function useKycAlerts(client: KycClient, options?: UseKycAlertsOptions):
  *   );
  * }
  * ```
+ *
+ * @remarks Console session only: the overview endpoint needs a dashboard login
+ * token and fails with a tenant API key.
  */
 declare function useKycOverview(client: KycClient, options?: UseKycOverviewOptions): UseKycOverviewResult;
 /**
@@ -431,6 +453,9 @@ declare function useKycOverview(client: KycClient, options?: UseKycOverviewOptio
  *   );
  * }
  * ```
+ *
+ * @remarks Console session only: the preferences endpoints need a dashboard
+ * login token and fail with a tenant API key.
  */
 declare function useKycPreferences(client: KycClient, autoFetch?: boolean): UseKycPreferencesResult;
 /**

package/dist/react.js

@@ -10,7 +10,7 @@ var React__default = /*#__PURE__*/_interopDefault(React);
 // src/geolocation/hooks.ts
 
 // src/core/version.ts
-var SDK_VERSION = "1.7.2";
+var SDK_VERSION = "1.8.0";
 
 // src/core/errors.ts
 var VesantError = class _VesantError extends Error {
@@ -429,14 +429,11 @@ function useCipherText(client) {
   const [configLoading, setConfigLoading] = React.useState(!!client);
   const [configError, setConfigError] = React.useState(null);
   const configRef = React.useRef(void 0);
-  const configPromiseRef = React.useRef(null);
   React.useEffect(() => {
     if (!client) return;
     let cancelled = false;
     setConfigLoading(true);
-    const promise = client.getGPSConfig();
-    configPromiseRef.current = promise;
-    promise.then((cfg) => {
+    client.getGPSConfig().then((cfg) => {
       if (!cancelled) {
         configRef.current = cfg;
         setConfigLoading(false);
@@ -451,13 +448,21 @@ function useCipherText(client) {
       cancelled = true;
     };
   }, [client]);
+  const refreshConfig = React.useCallback(async () => {
+    if (!client) return;
+    try {
+      configRef.current = await client.refreshGPSConfig();
+      setConfigError(null);
+    } catch (error) {
+      setConfigError(error instanceof Error ? error : new Error("Failed to refresh GPS config"));
+    }
+  }, [client]);
   const generate = React.useCallback(
     async (options) => {
       try {
-        if (configPromiseRef.current) {
+        if (client) {
           try {
-            const cfg = await configPromiseRef.current;
-            configRef.current = cfg;
+            configRef.current = await client.getGPSConfig();
           } catch {
           }
         }
@@ -467,9 +472,9 @@ function useCipherText(client) {
         return null;
       }
     },
-    []
+    [client]
   );
-  return { generate, configLoading, configError };
+  return { generate, refreshConfig, configLoading, configError };
 }
 function useLocationRequests(client, options = {}) {
   const [requests, setRequests] = React.useState([]);
@@ -866,6 +871,13 @@ function useTransactionVerification(client, options = {}) {
     verifyTransaction
   };
 }
+
+// src/risk-profile/types.ts
+function isProfileUpdateHeld(result) {
+  return typeof result === "object" && result !== null && result.status === "kyc_required" && result.kyc_required === true;
+}
+
+// src/risk-profile/hooks.ts
 function useCustomerProfile(client, customerId, options = {}) {
   const [profile, setProfile] = React.useState(null);
   const [loading, setLoading] = React.useState(false);
@@ -894,7 +906,7 @@ function useCustomerProfile(client, customerId, options = {}) {
       setError(null);
       try {
         const updated = await client.updateProfile(profileRef.current.id, updates);
-        setProfile(updated);
+        setProfile(isProfileUpdateHeld(updated) ? updated.profile : updated);
         return updated;
       } catch (err) {
         const error2 = err instanceof Error ? err : new Error("Failed to update profile");