vesant-sdk 1.1.0 → 1.2.0

package/dist/{types-DgNbBnEH.d.ts → client-BIfLMfuC.d.mts}

@@ -1,4 +1,4 @@
-import { L as Logger, P as PaginationParams } from './types-DBGM-bFB.js';
+import { b as Logger, P as PaginationParams, B as BaseClient, R as RequestOptions } from './types-BpKxSXGF.mjs';
 
 interface DeviceFingerprintRequest {
     device_id: string;
@@ -73,6 +73,10 @@ type CipherTextReason = 'registration' | 'login' | 'transaction' | 'interval_che
 interface CipherTextOptions {
     /** Reason for collection (required) */
     reason: CipherTextReason;
+    /** Public signing key (pk_) for HMAC signing (produces v02 signed cipherText) */
+    signingKey?: string;
+    /** @deprecated Use signingKey instead. API key for HMAC signing (backward compat) */
+    apiKey?: string;
     /** Request GPS location (default: false) */
     requestLocation?: boolean;
     /** GPS timeout in milliseconds (default: 10000) */
@@ -449,6 +453,8 @@ interface GeolocationConfigResponse {
         registration: boolean;
         transaction: boolean;
     };
+    /** Public signing key (pk_) for client-side HMAC signing */
+    signing_key?: string;
 }
 interface GeolocationClientConfig {
     /** Base URL of the API Gateway (e.g., "https://api.example.com") */
@@ -718,4 +724,270 @@ interface UseLocationCaptureResult {
     captureAndSubmitGPS: () => Promise<LocationCaptureResponse>;
 }
 
-export type { UseLocationRequestsResult as $, AlertStatus as A, DashboardMetrics as B, ComplianceCheckResponse as C, DeviceFingerprintRequest as D, CreateJurisdictionRequest as E, GeofenceRuleType as F, GeolocationClientConfig as G, GeofenceAction as H, GeofenceRule as I, JurisdictionConfig as J, CreateGeofenceRuleRequest as K, LocationVerification as L, UpdateGeofenceRuleRequest as M, UpdateDeviceTrustRequest as N, GeolocationRecord as O, APIError as P, UseGeolocationOptions as Q, ResendLocationRequestRequest as R, UseGeolocationResult as S, UseAlertsOptions as T, UpdateJurisdictionRequest as U, VerifyIPRequest as V, UseAlertsResult as W, LocationRequestStatus as X, LocationRequestChannel as Y, WiFiNetwork as Z, UseLocationRequestsOptions as _, GeolocationConfigResponse as a, UseLocationCaptureOptions as a0, UseLocationCaptureResult as a1, CipherTextReason as b, CipherTextCustomerData as c, ValidateCipherTextResponse as d, CreateLocationRequestRequest as e, LocationRequestResult as f, LocationRequest as g, LocationRequestFilters as h, LocationRequestListResponse as i, LocationShareInfo as j, LocationCaptureRequest as k, LocationCaptureResponse as l, CipherTextPayload as m, CipherTextOptions as n, CipherTextResult as o, DecryptedCipherText as p, ValidateCipherTextRequest as q, GeoIPResult as r, GeofenceEvaluation as s, DeviceFingerprint as t, DeviceTrustResult as u, AlertSeverity as v, AlertType as w, GeolocationAlert as x, AlertFilters as y, AlertListResponse as z };
+/**
+ * GeolocationClient - TypeScript SDK for CGS Geolocation & Compliance Service
+ *
+ * Provides type-safe methods to interact with the geolocation service API.
+ * Extends BaseClient for consistent retry logic, timeout handling, and error management.
+ */
+
+/**
+ * GeolocationClient extends BaseClient for:
+ * - Consistent retry logic with exponential backoff
+ * - Unified error handling (CGSError, 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 cachedSigningKey?;
+    constructor(config: GeolocationClientConfig);
+    /**
+     * Verify an IP address and check compliance
+     *
+     * Uses requestWithRetry() for automatic retry on transient failures.
+     *
+     * @param request - Verification request with IP, user ID, event type, and optional device fingerprint
+     * @returns Location verification result with risk assessment
+     *
+     * @example
+     * ```typescript
+     * const result = await client.verifyIP({
+     *   ip_address: "8.8.8.8",
+     *   user_id: "user_123",
+     *   event_type: "login",
+     *   device_fingerprint: {
+     *     device_id: "device_abc",
+     *     user_agent: navigator.userAgent,
+     *     platform: "web"
+     *   }
+     * });
+     *
+     * if (result.is_blocked) {
+     *   console.log("Access blocked:", result.risk_reasons);
+     * }
+     * ```
+     */
+    verifyIP(request: VerifyIPRequest, requestOptions?: RequestOptions): Promise<LocationVerification>;
+    /**
+     * Check compliance for a specific country
+     *
+     * @param countryISO - ISO 3166-1 alpha-2 country code (e.g., "US", "GB")
+     * @returns Jurisdiction configuration and compliance status
+     *
+     * @example
+     * ```typescript
+     * const compliance = await client.checkCompliance("KP"); // North Korea
+     * if (!compliance.is_compliant) {
+     *   console.log("Country is not allowed:", compliance.jurisdiction?.status);
+     * }
+     * ```
+     */
+    checkCompliance(countryISO: string, requestOptions?: RequestOptions): Promise<ComplianceCheckResponse>;
+    /**
+     * Get the tenant's GPS requirement configuration
+     *
+     * Returns which event types require GPS location to be collected.
+     * Use this to auto-enable GPS collection in generateCipherText when required.
+     *
+     * @returns GPS requirement config per event type
+     *
+     * @example
+     * ```typescript
+     * const config = await client.getGPSConfig();
+     * if (config.require_gps.login) {
+     *   // GPS is required for login — auto-enable location
+     * }
+     * ```
+     */
+    getGPSConfig(requestOptions?: RequestOptions): Promise<GeolocationConfigResponse>;
+    /**
+     * Validate a cipherText generated by the frontend SDK
+     *
+     * The cipherText contains encrypted device fingerprint and optional location data.
+     * This method decrypts and validates the data, returning device info, location,
+     * and risk assessment.
+     *
+     * @param cipherText - The encrypted cipherText string from generateCipherText()
+     * @param userId - User ID associated with this verification
+     * @param eventType - Reason for verification (login, registration, etc.)
+     * @param expectedIP - Optional expected IP address for additional validation
+     * @param customerData - Optional customer data for risk profile creation (used when user is blocked)
+     * @returns Validation result with device info, location, and risk assessment
+     *
+     * @example
+     * ```typescript
+     * // Validate cipherText during registration with customer data
+     * const result = await client.validateCipherText(
+     *   cipherText,
+     *   "user_123",
+     *   "registration",
+     *   clientIP,
+     *   {
+     *     full_name: "John Doe",
+     *     email: "john@example.com",
+     *     country: "US",
+     *     state: "CA"
+     *   }
+     * );
+     *
+     * if (!result.valid) {
+     *   console.log("CipherText validation failed:", result.errors);
+     *   return;
+     * }
+     *
+     * if (result.risk.is_blocked) {
+     *   console.log("Access blocked:", result.risk.block_reasons);
+     *   // A risk profile with full customer data has been created for the alert
+     * }
+     * ```
+     */
+    validateCipherText(cipherText: string, userId: string, eventType: CipherTextReason, expectedIP?: string, customerData?: CipherTextCustomerData, requestOptions?: RequestOptions): Promise<ValidateCipherTextResponse>;
+    /**
+     * Validate cipherText and verify IP in a single call
+     *
+     * Combines cipherText validation with IP verification for complete
+     * location and device verification in one request.
+     *
+     * @param cipherText - The encrypted cipherText string
+     * @param ipAddress - Client IP address
+     * @param userId - User ID
+     * @param eventType - Event type (login, registration, etc.)
+     * @returns Combined validation and verification result
+     *
+     * @example
+     * ```typescript
+     * const result = await client.validateAndVerify(
+     *   cipherText,
+     *   clientIP,
+     *   "user_123",
+     *   "registration"
+     * );
+     *
+     * if (!result.ciphertext_valid) {
+     *   throw new Error("Device verification failed");
+     * }
+     *
+     * if (result.location.is_blocked) {
+     *   throw new Error("Location not allowed");
+     * }
+     * ```
+     */
+    validateAndVerify(cipherText: string, ipAddress: string, userId: string, eventType: CipherTextReason, requestOptions?: RequestOptions): Promise<{
+        ciphertext_valid: boolean;
+        ciphertext_result: ValidateCipherTextResponse;
+        location: LocationVerification;
+    }>;
+    /**
+     * Create a location request to get customer's live location
+     *
+     * @param request - Location request details
+     * @returns Location request result with share link
+     *
+     * @example
+     * ```typescript
+     * const result = await client.createLocationRequest({
+     *   user_id: "customer_123",
+     *   channel: "sms",
+     *   phone: "+1234567890",
+     *   reason: "Verification for high-value transaction"
+     * });
+     *
+     * console.log(`Share link sent: ${result.share_link}`);
+     * console.log(`Expires at: ${result.token_expiry}`);
+     * ```
+     */
+    createLocationRequest(request: CreateLocationRequestRequest, requestOptions?: RequestOptions): Promise<LocationRequestResult>;
+    /**
+     * Get a location request by ID
+     *
+     * @param requestId - Location request ID
+     * @returns Location request details
+     */
+    getLocationRequest(requestId: string, requestOptions?: RequestOptions): Promise<LocationRequest>;
+    /**
+     * List location requests with filters and pagination
+     *
+     * @param filters - Optional filters
+     * @param pagination - Optional pagination
+     * @returns Paginated list of location requests
+     *
+     * @example
+     * ```typescript
+     * const requests = await client.listLocationRequests(
+     *   { status: "completed", user_id: "customer_123" },
+     *   { page: 1, limit: 20 }
+     * );
+     * ```
+     */
+    listLocationRequests(filters?: LocationRequestFilters, pagination?: PaginationParams, requestOptions?: RequestOptions): Promise<LocationRequestListResponse>;
+    /**
+     * Cancel a pending location request
+     *
+     * @param requestId - Location request ID
+     */
+    cancelLocationRequest(requestId: string, requestOptions?: RequestOptions): Promise<void>;
+    /**
+     * Resend notification for a location request
+     *
+     * @param requestId - Location request ID
+     * @param contact - Email or phone to send to
+     */
+    resendLocationRequest(requestId: string, contact: ResendLocationRequestRequest, requestOptions?: RequestOptions): Promise<void>;
+    /**
+     * Get location share info (customer-facing)
+     * This is called from the customer's device to get request details
+     *
+     * @param token - Secure token from share link
+     * @returns Location share info
+     */
+    getLocationShareInfo(token: string, requestOptions?: RequestOptions): Promise<LocationShareInfo>;
+    /**
+     * Submit location capture (customer-facing)
+     * This is called from the customer's device to submit their location
+     *
+     * @param token - Secure token from share link
+     * @param capture - Location capture data (GPS or WiFi)
+     * @returns Capture response
+     *
+     * @example
+     * ```typescript
+     * // Using GPS (preferred)
+     * const result = await client.captureLocation(token, {
+     *   latitude: 37.7749,
+     *   longitude: -122.4194,
+     *   accuracy: 10
+     * });
+     *
+     * // Using WiFi positioning (fallback)
+     * const result = await client.captureLocation(token, {
+     *   wifi_networks: [
+     *     { macAddress: "00:11:22:33:44:55", signalStrength: -50 },
+     *     { macAddress: "AA:BB:CC:DD:EE:FF", signalStrength: -70 }
+     *   ]
+     * });
+     * ```
+     */
+    captureLocation(token: string, capture: LocationCaptureRequest, requestOptions?: RequestOptions): Promise<LocationCaptureResponse>;
+    /**
+     * Generate a signed cipherText containing device and location data.
+     *
+     * Automatically passes the client's API key for HMAC signing (v02 format).
+     * If no API key is configured, falls back to unsigned v01 format.
+     *
+     * @param options - Options for cipherText generation
+     * @param gpsConfig - Optional GPS config (from getGPSConfig)
+     * @returns CipherText result with the signed string
+     *
+     * @example
+     * ```typescript
+     * const result = await client.generateCipherText({ reason: 'login' });
+     * console.log(result.cipherText); // v02 signed cipherText
+     * ```
+     */
+    generateCipherText(options: Omit<CipherTextOptions, 'apiKey' | 'signingKey'>, gpsConfig?: GeolocationConfigResponse): Promise<CipherTextResult>;
+}
+
+export { type UseLocationRequestsOptions as $, type AlertStatus as A, type APIError as B, type CipherTextPayload as C, type DeviceFingerprintRequest as D, type GeolocationConfigResponse as E, type GeolocationClientConfig as F, GeolocationClient as G, type UseGeolocationOptions as H, type UseGeolocationResult as I, type JurisdictionConfig as J, type UseAlertsOptions as K, type LocationVerification as L, type UseAlertsResult as M, type LocationRequestStatus as N, type LocationRequestChannel as O, type LocationRequest as P, type CreateLocationRequestRequest as Q, type LocationRequestResult as R, type LocationRequestFilters as S, type LocationRequestListResponse as T, type UpdateJurisdictionRequest as U, type ValidateCipherTextRequest as V, type ResendLocationRequestRequest as W, type WiFiNetwork as X, type LocationCaptureRequest as Y, type LocationShareInfo as Z, type LocationCaptureResponse as _, type CipherTextReason as a, type UseLocationRequestsResult as a0, type UseLocationCaptureOptions as a1, type UseLocationCaptureResult as a2, type CipherTextOptions as b, type CipherTextResult as c, type DecryptedCipherText as d, type CipherTextCustomerData as e, type ValidateCipherTextResponse as f, type VerifyIPRequest as g, type GeoIPResult as h, type GeofenceEvaluation as i, type DeviceFingerprint as j, type DeviceTrustResult as k, type ComplianceCheckResponse as l, type AlertSeverity as m, type AlertType as n, type GeolocationAlert as o, type AlertFilters as p, type AlertListResponse as q, type DashboardMetrics as r, type CreateJurisdictionRequest as s, type GeofenceRuleType as t, type GeofenceAction as u, type GeofenceRule as v, type CreateGeofenceRuleRequest as w, type UpdateGeofenceRuleRequest as x, type UpdateDeviceTrustRequest as y, type GeolocationRecord as z };

package/dist/{types-DGbuL8c0.d.mts → client-BWp5FI3x.d.ts}

@@ -1,4 +1,4 @@
-import { L as Logger, P as PaginationParams } from './types-DBGM-bFB.mjs';
+import { b as Logger, P as PaginationParams, B as BaseClient, R as RequestOptions } from './types-BpKxSXGF.js';
 
 interface DeviceFingerprintRequest {
     device_id: string;
@@ -73,6 +73,10 @@ type CipherTextReason = 'registration' | 'login' | 'transaction' | 'interval_che
 interface CipherTextOptions {
     /** Reason for collection (required) */
     reason: CipherTextReason;
+    /** Public signing key (pk_) for HMAC signing (produces v02 signed cipherText) */
+    signingKey?: string;
+    /** @deprecated Use signingKey instead. API key for HMAC signing (backward compat) */
+    apiKey?: string;
     /** Request GPS location (default: false) */
     requestLocation?: boolean;
     /** GPS timeout in milliseconds (default: 10000) */
@@ -449,6 +453,8 @@ interface GeolocationConfigResponse {
         registration: boolean;
         transaction: boolean;
     };
+    /** Public signing key (pk_) for client-side HMAC signing */
+    signing_key?: string;
 }
 interface GeolocationClientConfig {
     /** Base URL of the API Gateway (e.g., "https://api.example.com") */
@@ -718,4 +724,270 @@ interface UseLocationCaptureResult {
     captureAndSubmitGPS: () => Promise<LocationCaptureResponse>;
 }
 
-export type { UseLocationRequestsResult as $, AlertStatus as A, DashboardMetrics as B, ComplianceCheckResponse as C, DeviceFingerprintRequest as D, CreateJurisdictionRequest as E, GeofenceRuleType as F, GeolocationClientConfig as G, GeofenceAction as H, GeofenceRule as I, JurisdictionConfig as J, CreateGeofenceRuleRequest as K, LocationVerification as L, UpdateGeofenceRuleRequest as M, UpdateDeviceTrustRequest as N, GeolocationRecord as O, APIError as P, UseGeolocationOptions as Q, ResendLocationRequestRequest as R, UseGeolocationResult as S, UseAlertsOptions as T, UpdateJurisdictionRequest as U, VerifyIPRequest as V, UseAlertsResult as W, LocationRequestStatus as X, LocationRequestChannel as Y, WiFiNetwork as Z, UseLocationRequestsOptions as _, GeolocationConfigResponse as a, UseLocationCaptureOptions as a0, UseLocationCaptureResult as a1, CipherTextReason as b, CipherTextCustomerData as c, ValidateCipherTextResponse as d, CreateLocationRequestRequest as e, LocationRequestResult as f, LocationRequest as g, LocationRequestFilters as h, LocationRequestListResponse as i, LocationShareInfo as j, LocationCaptureRequest as k, LocationCaptureResponse as l, CipherTextPayload as m, CipherTextOptions as n, CipherTextResult as o, DecryptedCipherText as p, ValidateCipherTextRequest as q, GeoIPResult as r, GeofenceEvaluation as s, DeviceFingerprint as t, DeviceTrustResult as u, AlertSeverity as v, AlertType as w, GeolocationAlert as x, AlertFilters as y, AlertListResponse as z };
+/**
+ * GeolocationClient - TypeScript SDK for CGS Geolocation & Compliance Service
+ *
+ * Provides type-safe methods to interact with the geolocation service API.
+ * Extends BaseClient for consistent retry logic, timeout handling, and error management.
+ */
+
+/**
+ * GeolocationClient extends BaseClient for:
+ * - Consistent retry logic with exponential backoff
+ * - Unified error handling (CGSError, 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 cachedSigningKey?;
+    constructor(config: GeolocationClientConfig);
+    /**
+     * Verify an IP address and check compliance
+     *
+     * Uses requestWithRetry() for automatic retry on transient failures.
+     *
+     * @param request - Verification request with IP, user ID, event type, and optional device fingerprint
+     * @returns Location verification result with risk assessment
+     *
+     * @example
+     * ```typescript
+     * const result = await client.verifyIP({
+     *   ip_address: "8.8.8.8",
+     *   user_id: "user_123",
+     *   event_type: "login",
+     *   device_fingerprint: {
+     *     device_id: "device_abc",
+     *     user_agent: navigator.userAgent,
+     *     platform: "web"
+     *   }
+     * });
+     *
+     * if (result.is_blocked) {
+     *   console.log("Access blocked:", result.risk_reasons);
+     * }
+     * ```
+     */
+    verifyIP(request: VerifyIPRequest, requestOptions?: RequestOptions): Promise<LocationVerification>;
+    /**
+     * Check compliance for a specific country
+     *
+     * @param countryISO - ISO 3166-1 alpha-2 country code (e.g., "US", "GB")
+     * @returns Jurisdiction configuration and compliance status
+     *
+     * @example
+     * ```typescript
+     * const compliance = await client.checkCompliance("KP"); // North Korea
+     * if (!compliance.is_compliant) {
+     *   console.log("Country is not allowed:", compliance.jurisdiction?.status);
+     * }
+     * ```
+     */
+    checkCompliance(countryISO: string, requestOptions?: RequestOptions): Promise<ComplianceCheckResponse>;
+    /**
+     * Get the tenant's GPS requirement configuration
+     *
+     * Returns which event types require GPS location to be collected.
+     * Use this to auto-enable GPS collection in generateCipherText when required.
+     *
+     * @returns GPS requirement config per event type
+     *
+     * @example
+     * ```typescript
+     * const config = await client.getGPSConfig();
+     * if (config.require_gps.login) {
+     *   // GPS is required for login — auto-enable location
+     * }
+     * ```
+     */
+    getGPSConfig(requestOptions?: RequestOptions): Promise<GeolocationConfigResponse>;
+    /**
+     * Validate a cipherText generated by the frontend SDK
+     *
+     * The cipherText contains encrypted device fingerprint and optional location data.
+     * This method decrypts and validates the data, returning device info, location,
+     * and risk assessment.
+     *
+     * @param cipherText - The encrypted cipherText string from generateCipherText()
+     * @param userId - User ID associated with this verification
+     * @param eventType - Reason for verification (login, registration, etc.)
+     * @param expectedIP - Optional expected IP address for additional validation
+     * @param customerData - Optional customer data for risk profile creation (used when user is blocked)
+     * @returns Validation result with device info, location, and risk assessment
+     *
+     * @example
+     * ```typescript
+     * // Validate cipherText during registration with customer data
+     * const result = await client.validateCipherText(
+     *   cipherText,
+     *   "user_123",
+     *   "registration",
+     *   clientIP,
+     *   {
+     *     full_name: "John Doe",
+     *     email: "john@example.com",
+     *     country: "US",
+     *     state: "CA"
+     *   }
+     * );
+     *
+     * if (!result.valid) {
+     *   console.log("CipherText validation failed:", result.errors);
+     *   return;
+     * }
+     *
+     * if (result.risk.is_blocked) {
+     *   console.log("Access blocked:", result.risk.block_reasons);
+     *   // A risk profile with full customer data has been created for the alert
+     * }
+     * ```
+     */
+    validateCipherText(cipherText: string, userId: string, eventType: CipherTextReason, expectedIP?: string, customerData?: CipherTextCustomerData, requestOptions?: RequestOptions): Promise<ValidateCipherTextResponse>;
+    /**
+     * Validate cipherText and verify IP in a single call
+     *
+     * Combines cipherText validation with IP verification for complete
+     * location and device verification in one request.
+     *
+     * @param cipherText - The encrypted cipherText string
+     * @param ipAddress - Client IP address
+     * @param userId - User ID
+     * @param eventType - Event type (login, registration, etc.)
+     * @returns Combined validation and verification result
+     *
+     * @example
+     * ```typescript
+     * const result = await client.validateAndVerify(
+     *   cipherText,
+     *   clientIP,
+     *   "user_123",
+     *   "registration"
+     * );
+     *
+     * if (!result.ciphertext_valid) {
+     *   throw new Error("Device verification failed");
+     * }
+     *
+     * if (result.location.is_blocked) {
+     *   throw new Error("Location not allowed");
+     * }
+     * ```
+     */
+    validateAndVerify(cipherText: string, ipAddress: string, userId: string, eventType: CipherTextReason, requestOptions?: RequestOptions): Promise<{
+        ciphertext_valid: boolean;
+        ciphertext_result: ValidateCipherTextResponse;
+        location: LocationVerification;
+    }>;
+    /**
+     * Create a location request to get customer's live location
+     *
+     * @param request - Location request details
+     * @returns Location request result with share link
+     *
+     * @example
+     * ```typescript
+     * const result = await client.createLocationRequest({
+     *   user_id: "customer_123",
+     *   channel: "sms",
+     *   phone: "+1234567890",
+     *   reason: "Verification for high-value transaction"
+     * });
+     *
+     * console.log(`Share link sent: ${result.share_link}`);
+     * console.log(`Expires at: ${result.token_expiry}`);
+     * ```
+     */
+    createLocationRequest(request: CreateLocationRequestRequest, requestOptions?: RequestOptions): Promise<LocationRequestResult>;
+    /**
+     * Get a location request by ID
+     *
+     * @param requestId - Location request ID
+     * @returns Location request details
+     */
+    getLocationRequest(requestId: string, requestOptions?: RequestOptions): Promise<LocationRequest>;
+    /**
+     * List location requests with filters and pagination
+     *
+     * @param filters - Optional filters
+     * @param pagination - Optional pagination
+     * @returns Paginated list of location requests
+     *
+     * @example
+     * ```typescript
+     * const requests = await client.listLocationRequests(
+     *   { status: "completed", user_id: "customer_123" },
+     *   { page: 1, limit: 20 }
+     * );
+     * ```
+     */
+    listLocationRequests(filters?: LocationRequestFilters, pagination?: PaginationParams, requestOptions?: RequestOptions): Promise<LocationRequestListResponse>;
+    /**
+     * Cancel a pending location request
+     *
+     * @param requestId - Location request ID
+     */
+    cancelLocationRequest(requestId: string, requestOptions?: RequestOptions): Promise<void>;
+    /**
+     * Resend notification for a location request
+     *
+     * @param requestId - Location request ID
+     * @param contact - Email or phone to send to
+     */
+    resendLocationRequest(requestId: string, contact: ResendLocationRequestRequest, requestOptions?: RequestOptions): Promise<void>;
+    /**
+     * Get location share info (customer-facing)
+     * This is called from the customer's device to get request details
+     *
+     * @param token - Secure token from share link
+     * @returns Location share info
+     */
+    getLocationShareInfo(token: string, requestOptions?: RequestOptions): Promise<LocationShareInfo>;
+    /**
+     * Submit location capture (customer-facing)
+     * This is called from the customer's device to submit their location
+     *
+     * @param token - Secure token from share link
+     * @param capture - Location capture data (GPS or WiFi)
+     * @returns Capture response
+     *
+     * @example
+     * ```typescript
+     * // Using GPS (preferred)
+     * const result = await client.captureLocation(token, {
+     *   latitude: 37.7749,
+     *   longitude: -122.4194,
+     *   accuracy: 10
+     * });
+     *
+     * // Using WiFi positioning (fallback)
+     * const result = await client.captureLocation(token, {
+     *   wifi_networks: [
+     *     { macAddress: "00:11:22:33:44:55", signalStrength: -50 },
+     *     { macAddress: "AA:BB:CC:DD:EE:FF", signalStrength: -70 }
+     *   ]
+     * });
+     * ```
+     */
+    captureLocation(token: string, capture: LocationCaptureRequest, requestOptions?: RequestOptions): Promise<LocationCaptureResponse>;
+    /**
+     * Generate a signed cipherText containing device and location data.
+     *
+     * Automatically passes the client's API key for HMAC signing (v02 format).
+     * If no API key is configured, falls back to unsigned v01 format.
+     *
+     * @param options - Options for cipherText generation
+     * @param gpsConfig - Optional GPS config (from getGPSConfig)
+     * @returns CipherText result with the signed string
+     *
+     * @example
+     * ```typescript
+     * const result = await client.generateCipherText({ reason: 'login' });
+     * console.log(result.cipherText); // v02 signed cipherText
+     * ```
+     */
+    generateCipherText(options: Omit<CipherTextOptions, 'apiKey' | 'signingKey'>, gpsConfig?: GeolocationConfigResponse): Promise<CipherTextResult>;
+}
+
+export { type UseLocationRequestsOptions as $, type AlertStatus as A, type APIError as B, type CipherTextPayload as C, type DeviceFingerprintRequest as D, type GeolocationConfigResponse as E, type GeolocationClientConfig as F, GeolocationClient as G, type UseGeolocationOptions as H, type UseGeolocationResult as I, type JurisdictionConfig as J, type UseAlertsOptions as K, type LocationVerification as L, type UseAlertsResult as M, type LocationRequestStatus as N, type LocationRequestChannel as O, type LocationRequest as P, type CreateLocationRequestRequest as Q, type LocationRequestResult as R, type LocationRequestFilters as S, type LocationRequestListResponse as T, type UpdateJurisdictionRequest as U, type ValidateCipherTextRequest as V, type ResendLocationRequestRequest as W, type WiFiNetwork as X, type LocationCaptureRequest as Y, type LocationShareInfo as Z, type LocationCaptureResponse as _, type CipherTextReason as a, type UseLocationRequestsResult as a0, type UseLocationCaptureOptions as a1, type UseLocationCaptureResult as a2, type CipherTextOptions as b, type CipherTextResult as c, type DecryptedCipherText as d, type CipherTextCustomerData as e, type ValidateCipherTextResponse as f, type VerifyIPRequest as g, type GeoIPResult as h, type GeofenceEvaluation as i, type DeviceFingerprint as j, type DeviceTrustResult as k, type ComplianceCheckResponse as l, type AlertSeverity as m, type AlertType as n, type GeolocationAlert as o, type AlertFilters as p, type AlertListResponse as q, type DashboardMetrics as r, type CreateJurisdictionRequest as s, type GeofenceRuleType as t, type GeofenceAction as u, type GeofenceRule as v, type CreateGeofenceRuleRequest as w, type UpdateGeofenceRuleRequest as x, type UpdateDeviceTrustRequest as y, type GeolocationRecord as z };

package/dist/compliance/index.d.mts

@@ -1,7 +1,8 @@
-import { E as EntityType, e as CGSConfig, R as RequestOptions, P as PaginationParams } from '../types-DBGM-bFB.mjs';
-import { C as CustomerProfile } from '../types-BQTkTvNp.mjs';
-import { D as DeviceFingerprintRequest, L as LocationVerification, g as LocationRequest, h as LocationRequestFilters, i as LocationRequestListResponse } from '../types-DGbuL8c0.mjs';
-export { e as CreateLocationRequestRequest, k as LocationCaptureRequest, l as LocationCaptureResponse, Y as LocationRequestChannel, f as LocationRequestResult, X as LocationRequestStatus, j as LocationShareInfo, R as ResendLocationRequestRequest } from '../types-DGbuL8c0.mjs';
+import { D as DeviceFingerprintRequest, L as LocationVerification, P as LocationRequest, G as GeolocationClient, S as LocationRequestFilters, T as LocationRequestListResponse } from '../client-BIfLMfuC.mjs';
+export { Q as CreateLocationRequestRequest, Y as LocationCaptureRequest, _ as LocationCaptureResponse, O as LocationRequestChannel, R as LocationRequestResult, N as LocationRequestStatus, Z as LocationShareInfo, W as ResendLocationRequestRequest } from '../client-BIfLMfuC.mjs';
+import { RiskProfileClient } from '../risk-profile/index.mjs';
+import { E as EntityType, e as CGSConfig, R as RequestOptions, P as PaginationParams } from '../types-BpKxSXGF.mjs';
+import { C as CustomerProfile } from '../types-DKCQN4C5.mjs';
 
 interface RegistrationVerificationRequest {
     customerId: string;
@@ -124,6 +125,10 @@ declare class ComplianceClient {
     private _currencyRatesCustomized;
     private _currencyRatesWarned;
     constructor(config: CGSConfig);
+    /** Get the underlying GeolocationClient for direct geolocation API access */
+    getGeolocationClient(): GeolocationClient;
+    /** Get the underlying RiskProfileClient for direct risk profile API access */
+    getRiskProfileClient(): RiskProfileClient;
     /**
      * Verify customer registration with automatic profile creation
      *

package/dist/compliance/index.d.ts

@@ -1,7 +1,8 @@
-import { E as EntityType, e as CGSConfig, R as RequestOptions, P as PaginationParams } from '../types-DBGM-bFB.js';
-import { C as CustomerProfile } from '../types-BF8mYH2W.js';
-import { D as DeviceFingerprintRequest, L as LocationVerification, g as LocationRequest, h as LocationRequestFilters, i as LocationRequestListResponse } from '../types-DgNbBnEH.js';
-export { e as CreateLocationRequestRequest, k as LocationCaptureRequest, l as LocationCaptureResponse, Y as LocationRequestChannel, f as LocationRequestResult, X as LocationRequestStatus, j as LocationShareInfo, R as ResendLocationRequestRequest } from '../types-DgNbBnEH.js';
+import { D as DeviceFingerprintRequest, L as LocationVerification, P as LocationRequest, G as GeolocationClient, S as LocationRequestFilters, T as LocationRequestListResponse } from '../client-BWp5FI3x.js';
+export { Q as CreateLocationRequestRequest, Y as LocationCaptureRequest, _ as LocationCaptureResponse, O as LocationRequestChannel, R as LocationRequestResult, N as LocationRequestStatus, Z as LocationShareInfo, W as ResendLocationRequestRequest } from '../client-BWp5FI3x.js';
+import { RiskProfileClient } from '../risk-profile/index.js';
+import { E as EntityType, e as CGSConfig, R as RequestOptions, P as PaginationParams } from '../types-BpKxSXGF.js';
+import { C as CustomerProfile } from '../types-DfHLp_tz.js';
 
 interface RegistrationVerificationRequest {
     customerId: string;
@@ -124,6 +125,10 @@ declare class ComplianceClient {
     private _currencyRatesCustomized;
     private _currencyRatesWarned;
     constructor(config: CGSConfig);
+    /** Get the underlying GeolocationClient for direct geolocation API access */
+    getGeolocationClient(): GeolocationClient;
+    /** Get the underlying RiskProfileClient for direct risk profile API access */
+    getRiskProfileClient(): RiskProfileClient;
     /**
      * Verify customer registration with automatic profile creation
      *