vesant-sdk 1.6.6 → 1.7.0-next.f221d37

package/README.md

@@ -27,6 +27,16 @@ yarn add vesant-sdk
 pnpm add vesant-sdk
 ```
 
+### Fraud scoring
+
+Fraud event scoring uses a separate package (not a `vesant-sdk` subpath export):
+
+```bash
+npm install @vesant-sdk/fraud
+```
+
+See [Fraud integration guide](./docs/guides/fraud-integration.md).
+
 ## Quick Start
 
 ### Initialize the SDK
@@ -64,7 +74,7 @@ if (result.allowed) {
     // Redirect to KYC flow
   }
 } else {
-  console.log('Registration blocked:', result.blockReasons);
+  console.log('Registration blocked:', result.blockReasons.map(r => r.message).join(', '));
 }
 ```
 
@@ -84,7 +94,7 @@ if (result.allowed) {
     // Allow login
   }
 } else {
-  console.log('Login blocked:', result.blockReasons);
+  console.log('Login blocked:', result.blockReasons.map(r => r.message).join(', '));
 }
 ```
 
@@ -104,7 +114,7 @@ if (result.allowed) {
 } else if (result.requiresApproval) {
   // Queue for manual review
 } else {
-  console.log('Transaction blocked:', result.blockReasons);
+  console.log('Transaction blocked:', result.blockReasons.map(r => r.message).join(', '));
 }
 ```
 
@@ -216,7 +226,7 @@ function RegistrationForm() {
       navigate('/dashboard');
     },
     onBlocked: (result) => {
-      alert(`Registration blocked: ${result.blockReasons.join(', ')}`);
+      alert(`Registration blocked: ${result.blockReasons.map(r => r.message).join(', ')}`);
     },
   });
 

package/dist/{client-ePzhQKp9.d.mts → client-BolQlL5e.d.mts}

@@ -237,4 +237,4 @@ declare abstract class BaseClient {
     }>;
 }
 
-export { BaseClient as B, type CircuitBreakerConfig as C, type Logger as L, type RequestOptions as R, type VesantConfig as V, type BaseClientConfig as a, type RequestInterceptor as b, type RequiredVesantConfig as c, type CGSConfig as d, type RequiredCGSConfig as e, type RequiredBaseClientConfig as f, type CircuitBreakerState as g, type CircuitBreakerStatus as h, CircuitBreaker as i, type RateLimitStatus as j, RateLimitTracker as k };
+export { BaseClient as B, type CGSConfig as C, type Logger as L, type RequestOptions as R, type VesantConfig as V, type BaseClientConfig as a, CircuitBreaker as b, type CircuitBreakerConfig as c, type CircuitBreakerState as d, type CircuitBreakerStatus as e, type RateLimitStatus as f, RateLimitTracker as g, type RequestInterceptor as h, type RequiredBaseClientConfig as i, type RequiredCGSConfig as j, type RequiredVesantConfig as k };

package/dist/{client-ePzhQKp9.d.ts → client-BolQlL5e.d.ts}

@@ -237,4 +237,4 @@ declare abstract class BaseClient {
     }>;
 }
 
-export { BaseClient as B, type CircuitBreakerConfig as C, type Logger as L, type RequestOptions as R, type VesantConfig as V, type BaseClientConfig as a, type RequestInterceptor as b, type RequiredVesantConfig as c, type CGSConfig as d, type RequiredCGSConfig as e, type RequiredBaseClientConfig as f, type CircuitBreakerState as g, type CircuitBreakerStatus as h, CircuitBreaker as i, type RateLimitStatus as j, RateLimitTracker as k };
+export { BaseClient as B, type CGSConfig as C, type Logger as L, type RequestOptions as R, type VesantConfig as V, type BaseClientConfig as a, CircuitBreaker as b, type CircuitBreakerConfig as c, type CircuitBreakerState as d, type CircuitBreakerStatus as e, type RateLimitStatus as f, RateLimitTracker as g, type RequestInterceptor as h, type RequiredBaseClientConfig as i, type RequiredCGSConfig as j, type RequiredVesantConfig as k };

package/dist/client-C3DCmGe9.d.ts

@@ -0,0 +1,436 @@
+import { D as DeviceFingerprintRequest, L as LocationVerification, V as ValidateCipherTextResponse, a as LocationRequest, G as GeolocationClient, b as LocationRequestFilters, c as LocationRequestListResponse } from './client-DoMSYMMR.js';
+import { RiskProfileClient } from './risk-profile/index.js';
+import { V as VesantConfig, R as RequestOptions } from './client-BolQlL5e.js';
+import { C as CustomerProfile } from './types-UGyDl1fd.js';
+import { E as EntityType, B as BlockReason, P as PaginationParams } from './types-CBQRNL-l.js';
+
+interface RegistrationVerificationRequest {
+    customerId: string;
+    fullName: string;
+    emailAddress: string;
+    phoneNumber?: string;
+    dateOfBirth?: string;
+    address?: string;
+    entityType?: EntityType;
+    ipAddress: string;
+    deviceFingerprint?: DeviceFingerprintRequest;
+    cipherText?: string;
+    metadata?: Record<string, unknown>;
+}
+interface RegistrationVerificationResponse {
+    allowed: boolean;
+    geolocation: LocationVerification;
+    profile: CustomerProfile | null;
+    requiresKYC: boolean;
+    requiresEDD: boolean;
+    blockReasons: string[];
+    blockReasonsStructured?: BlockReason[];
+    processingTime: number;
+    cipherTextValidation?: ValidateCipherTextResponse;
+}
+interface LoginVerificationRequest {
+    customerId: string;
+    ipAddress: string;
+    deviceFingerprint?: DeviceFingerprintRequest;
+    cipherText?: string;
+    metadata?: Record<string, unknown>;
+}
+interface LoginVerificationResponse {
+    allowed: boolean;
+    geolocation: LocationVerification;
+    profile: CustomerProfile | null;
+    requiresStepUp: boolean;
+    blockReasons: string[];
+    blockReasonsStructured?: BlockReason[];
+    processingTime: number;
+    cipherTextValidation?: ValidateCipherTextResponse;
+}
+interface TransactionVerificationRequest {
+    customerId: string;
+    ipAddress: string;
+    amount: number;
+    currency: string;
+    transactionType?: 'deposit' | 'withdrawal' | 'bet' | 'transfer' | 'payout';
+    deviceFingerprint?: DeviceFingerprintRequest;
+    cipherText?: string;
+    metadata?: Record<string, unknown>;
+}
+interface TransactionVerificationResponse {
+    allowed: boolean;
+    geolocation: LocationVerification;
+    profile: CustomerProfile | null;
+    transactionRisk: TransactionRiskResult;
+    requiresApproval: boolean;
+    blockReasons: string[];
+    blockReasonsStructured?: BlockReason[];
+    processingTime: number;
+    cipherTextValidation?: ValidateCipherTextResponse;
+}
+interface TransactionRiskResult {
+    score: number;
+    level: 'low' | 'medium' | 'high' | 'critical';
+    factors: string[];
+    factorsStructured?: BlockReason[];
+    allowed: boolean;
+    requiresManualReview: boolean;
+}
+interface EventVerificationRequest {
+    customerId: string;
+    ipAddress: string;
+    eventType: string;
+    deviceFingerprint?: DeviceFingerprintRequest;
+    cipherText?: string;
+    metadata?: Record<string, unknown>;
+}
+interface EventVerificationResponse {
+    allowed: boolean;
+    geolocation: LocationVerification;
+    blockReasons: string[];
+    blockReasonsStructured?: BlockReason[];
+    processingTime: number;
+    cipherTextValidation?: ValidateCipherTextResponse;
+}
+interface CurrencyRates {
+    [currency: string]: number;
+}
+declare const DEFAULT_CURRENCY_RATES: CurrencyRates;
+
+interface ComplianceLocationRequestInput {
+    /** Customer user ID to request location from */
+    customerId: string;
+    /** Notification channel to use */
+    channel: 'sms' | 'email' | 'push';
+    /** Reason for requesting location (for compliance/audit) */
+    reason: string;
+    /** Customer email (required for email channel) */
+    email?: string;
+    /** Customer phone (required for SMS channel) */
+    phone?: string;
+    /** Custom expiry time in hours (default: 24) */
+    expiryHours?: number;
+}
+interface ComplianceLocationRequestResult {
+    /** The created location request */
+    request: LocationRequest;
+    /** Shareable link for the customer */
+    shareLink: string;
+    /** Token expiration time */
+    tokenExpiry: string;
+    /** Customer profile (if available) */
+    profile?: CustomerProfile;
+}
+
+/**
+ * ComplianceClient - Unified Compliance Orchestration
+ *
+ * Main integration point for casino platforms. Orchestrates geolocation
+ * verification with customer risk profiling for complete compliance coverage.
+ *
+ * SDK is the primary data injection point for compliance verification.
+ */
+
+declare class ComplianceClient {
+    private geoClient;
+    private riskClient;
+    private config;
+    private logger;
+    private currencyRates;
+    private _currencyRatesCustomized;
+    private _currencyRatesWarned;
+    constructor(config: VesantConfig);
+    /** 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
+     *
+     * This is the primary integration point for new customer sign-ups.
+     * Combines geolocation verification with customer risk profile creation.
+     *
+     * Important: Profile is only created if geolocation verification passes.
+     * This prevents orphaned geolocation records when registration is blocked.
+     *
+     * @param request - Registration verification request
+     * @returns Verification response with profile and compliance status
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.verifyAtRegistration({
+     *   customerId: 'CUST-12345',
+     *   fullName: 'John Doe',
+     *   emailAddress: 'john@example.com',
+     *   ipAddress: req.ip,
+     *   deviceFingerprint: getDeviceFingerprint()
+     * });
+     *
+     * if (result.allowed) {
+     *   // Create account
+     *   console.log('Profile created:', result.profile);
+     *   if (result.requiresKYC) {
+     *     // Redirect to KYC flow
+     *   }
+     * } else {
+     *   // Block registration
+     *   console.log('Blocked:', result.blockReasons);
+     * }
+     * ```
+     */
+    verifyAtRegistration(request: RegistrationVerificationRequest, requestOptions?: RequestOptions): Promise<RegistrationVerificationResponse>;
+    /**
+     * Evaluate if registration should be blocked based on geolocation verification
+     *
+     * Checks:
+     * 1. General compliance status (is_compliant)
+     * 2. Explicit block flag (is_blocked)
+     * 3. Jurisdiction-specific registration allowance (allow_registration)
+     * 4. Risk level thresholds
+     *
+     * @param geoVerification - Geolocation verification result
+     * @returns Array of block reasons (empty if allowed)
+     */
+    private evaluateRegistrationBlock;
+    /**
+     * Validate registration request has all required fields
+     *
+     * @param request - Registration request to validate
+     * @throws ValidationError if required fields are missing or invalid
+     */
+    private validateRegistrationRequest;
+    /**
+     * Validate IP address format (IPv4 or IPv6)
+     */
+    private isValidIP;
+    /**
+     * Validate email address format
+     */
+    private isValidEmail;
+    private validateLoginRequest;
+    private validateTransactionRequest;
+    private validateEventRequest;
+    /**
+     * Verify customer login with profile activity update
+     *
+     * Verifies geolocation and updates customer profile with latest activity.
+     *
+     * @param request - Login verification request
+     * @returns Verification response with compliance status
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.verifyAtLogin({
+     *   customerId: 'CUST-12345',
+     *   ipAddress: req.ip,
+     *   deviceFingerprint: getDeviceFingerprint()
+     * });
+     *
+     * if (result.allowed) {
+     *   // Allow login
+     *   if (result.requiresStepUp) {
+     *     // Trigger MFA or additional verification
+     *   }
+     * } else {
+     *   // Block login
+     *   console.log('Blocked:', result.blockReasons);
+     * }
+     * ```
+     */
+    verifyAtLogin(request: LoginVerificationRequest, requestOptions?: RequestOptions): Promise<LoginVerificationResponse>;
+    /**
+     * Verify transaction with amount-based risk assessment
+     *
+     * Combines geolocation verification with transaction amount analysis
+     * and customer risk profile for comprehensive transaction screening.
+     *
+     * @param request - Transaction verification request
+     * @returns Verification response with transaction risk assessment
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.verifyAtTransaction({
+     *   customerId: 'CUST-12345',
+     *   ipAddress: req.ip,
+     *   amount: 5000,
+     *   currency: 'USD',
+     *   transactionType: 'withdrawal',
+     *   deviceFingerprint: getDeviceFingerprint()
+     * });
+     *
+     * if (result.allowed) {
+     *   // Process transaction
+     * } else if (result.requiresApproval) {
+     *   // Queue for manual review
+     * } else {
+     *   // Block transaction
+     *   console.log('Blocked:', result.blockReasons);
+     * }
+     * ```
+     */
+    verifyAtTransaction(request: TransactionVerificationRequest, requestOptions?: RequestOptions): Promise<TransactionVerificationResponse>;
+    /**
+     * Generic event verification (for other touchpoints)
+     *
+     * @param request - Event verification request
+     * @returns Verification response
+     */
+    verifyEvent(request: EventVerificationRequest, requestOptions?: RequestOptions): Promise<EventVerificationResponse>;
+    private buildReasonTail;
+    private shouldUpdateProfile;
+    private createProfileFromGeo;
+    /**
+     * Execute cipherText validation with graceful degradation.
+     * Returns undefined if cipherText is not provided or validation fails.
+     */
+    private executeCipherTextValidation;
+    /**
+     * Build a LocationVerification from a ValidateCipherTextResponse.
+     * The validate-ciphertext endpoint now returns the full geo-verification data
+     * (is_compliant, jurisdiction, geofence_evaluation, record_id, gps_required),
+     * so a separate verifyIP call is unnecessary.
+     */
+    private buildLocationFromCipherText;
+    private calculateTransactionRisk;
+    private checkJurisdictionLimits;
+    private normalizeToUSD;
+    private getRiskLevel;
+    private getBlockReasons;
+    private getTransactionBlockReasons;
+    /**
+     * Request live location from a customer
+     *
+     * Creates a location request and sends a notification to the customer
+     * via the specified channel (SMS, email, or push). The customer receives
+     * a link to share their location.
+     *
+     * @param input - Location request details
+     * @returns Location request result with share link
+     *
+     * @example
+     * ```typescript
+     * // Request location via SMS for transaction verification
+     * const result = await sdk.requestCustomerLocation({
+     *   customerId: 'CUST-12345',
+     *   channel: 'sms',
+     *   phone: '+1234567890',
+     *   reason: 'Verification required for high-value transaction'
+     * });
+     *
+     * console.log('Share link sent:', result.shareLink);
+     * console.log('Expires at:', result.tokenExpiry);
+     *
+     * // Request location via email
+     * const emailResult = await sdk.requestCustomerLocation({
+     *   customerId: 'CUST-12345',
+     *   channel: 'email',
+     *   email: 'customer@example.com',
+     *   reason: 'Account verification',
+     *   expiryHours: 48
+     * });
+     * ```
+     */
+    requestCustomerLocation(input: ComplianceLocationRequestInput, requestOptions?: RequestOptions): Promise<ComplianceLocationRequestResult>;
+    /**
+     * Get a specific location request by ID
+     *
+     * @param requestId - Location request ID
+     * @returns Location request details
+     *
+     * @example
+     * ```typescript
+     * const request = await sdk.getLocationRequest('req_abc123');
+     * console.log('Status:', request.status);
+     * if (request.latitude && request.longitude) {
+     *   console.log('Location captured:', request.latitude, request.longitude);
+     * }
+     * ```
+     */
+    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
+     * // Get pending requests for a customer
+     * const pending = await sdk.listLocationRequests(
+     *   { status: 'pending', user_id: 'CUST-12345' },
+     *   { page: 1, limit: 20 }
+     * );
+     *
+     * // Get all completed requests from last week
+     * const completed = await sdk.listLocationRequests({
+     *   status: 'completed',
+     *   date_from: new Date(Date.now() - 7 * 24 * 60 * 60 * 1000).toISOString()
+     * });
+     * ```
+     */
+    listLocationRequests(filters?: LocationRequestFilters, pagination?: PaginationParams, requestOptions?: RequestOptions): Promise<LocationRequestListResponse>;
+    /**
+     * Cancel a pending location request
+     *
+     * @param requestId - Location request ID
+     *
+     * @example
+     * ```typescript
+     * await sdk.cancelLocationRequest('req_abc123');
+     * ```
+     */
+    cancelLocationRequest(requestId: string, requestOptions?: RequestOptions): Promise<void>;
+    /**
+     * Resend notification for a location request
+     *
+     * @param requestId - Location request ID
+     * @param contact - Contact details (email or phone)
+     *
+     * @example
+     * ```typescript
+     * // Resend to a different phone number
+     * await sdk.resendLocationRequest('req_abc123', { phone: '+0987654321' });
+     *
+     * // Resend to email
+     * await sdk.resendLocationRequest('req_abc123', { email: 'new@example.com' });
+     * ```
+     */
+    resendLocationRequest(requestId: string, contact: {
+        email?: string;
+        phone?: string;
+    }, requestOptions?: RequestOptions): Promise<void>;
+    /**
+     * Validate location request input
+     */
+    private validateLocationRequestInput;
+    /**
+     * Update currency exchange rates
+     *
+     * Use this to keep currency rates current for accurate transaction risk
+     * calculation. Rates should be updated regularly (e.g., daily).
+     *
+     * @param rates - Currency to USD exchange rates
+     *
+     * @example
+     * ```typescript
+     * // Update specific rates
+     * sdk.updateCurrencyRates({
+     *   EUR: 1.08,
+     *   GBP: 1.25,
+     *   BTC: 42000, // For crypto support
+     * });
+     *
+     * // Or fetch from external service
+     * const rates = await fetchExchangeRates();
+     * sdk.updateCurrencyRates(rates);
+     * ```
+     */
+    updateCurrencyRates(rates: CurrencyRates): void;
+    /**
+     * Get current currency rates
+     *
+     * @returns Current currency to USD exchange rates
+     */
+    getCurrencyRates(): Readonly<CurrencyRates>;
+}
+
+export { ComplianceClient as C, DEFAULT_CURRENCY_RATES as D, type EventVerificationRequest as E, type LoginVerificationRequest as L, type RegistrationVerificationRequest as R, type TransactionRiskResult as T, type ComplianceLocationRequestInput as a, type ComplianceLocationRequestResult as b, type CurrencyRates as c, type EventVerificationResponse as d, type LoginVerificationResponse as e, type RegistrationVerificationResponse as f, type TransactionVerificationRequest as g, type TransactionVerificationResponse as h };

package/dist/{client-C_A7QLcB.d.ts → client-DMIRx7Tu.d.mts}

@@ -1,5 +1,5 @@
-import { L as Logger, B as BaseClient, R as RequestOptions } from './client-ePzhQKp9.js';
-import { P as PaginationParams } from './types-B4Ezqo7V.js';
+import { L as Logger, B as BaseClient, R as RequestOptions } from './client-BolQlL5e.mjs';
+import { B as BlockReason, P as PaginationParams } from './types-CBQRNL-l.mjs';
 
 interface DeviceFingerprintRequest {
     device_id: string;
@@ -200,6 +200,7 @@ interface ValidateCipherTextResponse {
         is_blocked: boolean;
         /** Reasons for blocking (only present if is_blocked is true) */
         block_reasons?: string[];
+        block_reasons_structured?: BlockReason[];
         /** GPS-vs-IP location mismatch detected (possible spoofing) */
         location_mismatch?: boolean;
         /** Distance in km between GPS and IP-derived location */
@@ -297,6 +298,7 @@ interface LocationVerification {
     risk_level: 'low' | 'medium' | 'high' | 'critical';
     risk_score: number;
     risk_reasons: string[];
+    risk_reasons_structured?: BlockReason[];
     jurisdiction?: JurisdictionConfig;
     geofence_evaluation?: GeofenceEvaluation;
     device_trust?: DeviceTrustResult;
@@ -1016,4 +1018,4 @@ declare class GeolocationClient extends BaseClient {
     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 };
+export { type UseLocationRequestsResult as $, type APIError as A, type GeolocationClientConfig as B, type CipherTextCustomerData as C, type DeviceFingerprintRequest as D, type GeolocationConfigResponse as E, type GeolocationRecord as F, GeolocationClient as G, type LocationCaptureRequest as H, type LocationCaptureResponse as I, type JurisdictionConfig as J, type LocationRequestChannel as K, type LocationVerification as L, type LocationRequestResult as M, type LocationRequestStatus as N, type LocationShareInfo as O, type UpdateGeofenceRuleRequest as P, type UpdateJurisdictionRequest as Q, type ResendLocationRequestRequest as R, type UseAlertsOptions as S, type UseAlertsResult as T, type UpdateDeviceTrustRequest as U, type ValidateCipherTextResponse as V, type UseGeolocationOptions as W, type UseGeolocationResult as X, type UseLocationCaptureOptions as Y, type UseLocationCaptureResult as Z, type UseLocationRequestsOptions as _, type LocationRequest as a, type ValidateCipherTextRequest as a0, type VerifyIPRequest as a1, type WiFiNetwork as a2, type LocationRequestFilters as b, type LocationRequestListResponse as c, type AlertFilters as d, type AlertListResponse as e, type AlertSeverity as f, type AlertStatus as g, type AlertType as h, type CipherTextOptions as i, type CipherTextPayload as j, type CipherTextReason as k, type CipherTextResult as l, type ComplianceCheckResponse as m, type CreateGeofenceRuleRequest as n, type CreateJurisdictionRequest as o, type CreateLocationRequestRequest as p, type DashboardMetrics as q, type DecryptedCipherText as r, type DeviceFingerprint as s, type DeviceTrustResult as t, type GeoIPResult as u, type GeofenceAction as v, type GeofenceEvaluation as w, type GeofenceRule as x, type GeofenceRuleType as y, type GeolocationAlert as z };

package/dist/{client-BlCxjbY2.d.mts → client-DoMSYMMR.d.ts}

@@ -1,5 +1,5 @@
-import { L as Logger, B as BaseClient, R as RequestOptions } from './client-ePzhQKp9.mjs';
-import { P as PaginationParams } from './types-B4Ezqo7V.mjs';
+import { L as Logger, B as BaseClient, R as RequestOptions } from './client-BolQlL5e.js';
+import { B as BlockReason, P as PaginationParams } from './types-CBQRNL-l.js';
 
 interface DeviceFingerprintRequest {
     device_id: string;
@@ -200,6 +200,7 @@ interface ValidateCipherTextResponse {
         is_blocked: boolean;
         /** Reasons for blocking (only present if is_blocked is true) */
         block_reasons?: string[];
+        block_reasons_structured?: BlockReason[];
         /** GPS-vs-IP location mismatch detected (possible spoofing) */
         location_mismatch?: boolean;
         /** Distance in km between GPS and IP-derived location */
@@ -297,6 +298,7 @@ interface LocationVerification {
     risk_level: 'low' | 'medium' | 'high' | 'critical';
     risk_score: number;
     risk_reasons: string[];
+    risk_reasons_structured?: BlockReason[];
     jurisdiction?: JurisdictionConfig;
     geofence_evaluation?: GeofenceEvaluation;
     device_trust?: DeviceTrustResult;
@@ -1016,4 +1018,4 @@ declare class GeolocationClient extends BaseClient {
     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 };
+export { type UseLocationRequestsResult as $, type APIError as A, type GeolocationClientConfig as B, type CipherTextCustomerData as C, type DeviceFingerprintRequest as D, type GeolocationConfigResponse as E, type GeolocationRecord as F, GeolocationClient as G, type LocationCaptureRequest as H, type LocationCaptureResponse as I, type JurisdictionConfig as J, type LocationRequestChannel as K, type LocationVerification as L, type LocationRequestResult as M, type LocationRequestStatus as N, type LocationShareInfo as O, type UpdateGeofenceRuleRequest as P, type UpdateJurisdictionRequest as Q, type ResendLocationRequestRequest as R, type UseAlertsOptions as S, type UseAlertsResult as T, type UpdateDeviceTrustRequest as U, type ValidateCipherTextResponse as V, type UseGeolocationOptions as W, type UseGeolocationResult as X, type UseLocationCaptureOptions as Y, type UseLocationCaptureResult as Z, type UseLocationRequestsOptions as _, type LocationRequest as a, type ValidateCipherTextRequest as a0, type VerifyIPRequest as a1, type WiFiNetwork as a2, type LocationRequestFilters as b, type LocationRequestListResponse as c, type AlertFilters as d, type AlertListResponse as e, type AlertSeverity as f, type AlertStatus as g, type AlertType as h, type CipherTextOptions as i, type CipherTextPayload as j, type CipherTextReason as k, type CipherTextResult as l, type ComplianceCheckResponse as m, type CreateGeofenceRuleRequest as n, type CreateJurisdictionRequest as o, type CreateLocationRequestRequest as p, type DashboardMetrics as q, type DecryptedCipherText as r, type DeviceFingerprint as s, type DeviceTrustResult as t, type GeoIPResult as u, type GeofenceAction as v, type GeofenceEvaluation as w, type GeofenceRule as x, type GeofenceRuleType as y, type GeolocationAlert as z };