cgs-compliance-sdk 2.0.8 → 2.0.9

package/dist/{client-CBy3JJSM.d.ts → client-K-qkyEBM.d.ts}

@@ -21,6 +21,158 @@ interface DeviceFingerprintRequest {
     language?: string;
     timezone?: string;
 }
+/**
+ * Raw device and location data collected from the client
+ * This data is encrypted into a cipherText before being sent to the server
+ */
+interface CipherTextPayload {
+    /** Device fingerprint data */
+    device: {
+        device_id: string;
+        user_agent: string;
+        platform: string;
+        browser?: string;
+        browser_version?: string;
+        os?: string;
+        os_version?: string;
+        screen_resolution?: string;
+        language?: string;
+        timezone?: string;
+        color_depth?: number;
+        hardware_concurrency?: number;
+        device_memory?: number;
+        touch_support?: boolean;
+        webgl_vendor?: string;
+        webgl_renderer?: string;
+    };
+    /** GPS/Geolocation data (if available) */
+    location?: {
+        latitude: number;
+        longitude: number;
+        accuracy: number;
+        altitude?: number;
+        altitude_accuracy?: number;
+        heading?: number;
+        speed?: number;
+        timestamp: number;
+    };
+    /** Network information */
+    network?: {
+        effective_type?: string;
+        downlink?: number;
+        rtt?: number;
+        save_data?: boolean;
+    };
+    /** Collection metadata */
+    metadata: {
+        collected_at: string;
+        sdk_version: string;
+        collection_reason: CipherTextReason;
+        page_url?: string;
+        referrer?: string;
+    };
+}
+/**
+ * Reason for collecting the cipherText
+ */
+type CipherTextReason = 'registration' | 'login' | 'transaction' | 'interval_check' | 'ip_change' | 'game_launch' | 'withdrawal' | 'manual_verification';
+/**
+ * Options for generating cipherText
+ */
+interface CipherTextOptions {
+    /** Reason for collection (required) */
+    reason: CipherTextReason;
+    /** Request GPS location (default: false) */
+    requestLocation?: boolean;
+    /** GPS timeout in milliseconds (default: 10000) */
+    locationTimeout?: number;
+    /** High accuracy GPS (default: true) */
+    highAccuracy?: boolean;
+    /** Include network info (default: true) */
+    includeNetworkInfo?: boolean;
+    /** Include WebGL info for fingerprinting (default: true) */
+    includeWebGL?: boolean;
+    /** Custom user ID to include */
+    userId?: string;
+}
+/**
+ * Result from cipherText generation
+ */
+interface CipherTextResult {
+    /** The encrypted cipherText string */
+    cipherText: string;
+    /** Whether GPS location was successfully captured */
+    locationCaptured: boolean;
+    /** Any errors that occurred during collection (non-fatal) */
+    warnings?: string[];
+    /** Timestamp when cipherText was generated */
+    generatedAt: string;
+    /** Expiry time for the cipherText */
+    expiresAt: string;
+}
+/**
+ * Decrypted cipherText data (returned by server after validation)
+ */
+interface DecryptedCipherText {
+    /** Whether the cipherText is valid */
+    valid: boolean;
+    /** Validation errors if any */
+    errors?: string[];
+    /** The decrypted payload */
+    payload?: CipherTextPayload;
+    /** Extracted device UUID */
+    device_uuid?: string;
+    /** Extracted IP address (from server) */
+    ip_address?: string;
+    /** Risk assessment */
+    risk?: {
+        score: number;
+        level: 'low' | 'medium' | 'high' | 'critical';
+        factors: string[];
+    };
+}
+/**
+ * Request to validate cipherText on the server
+ */
+interface ValidateCipherTextRequest {
+    cipher_text: string;
+    user_id: string;
+    event_type: CipherTextReason;
+    expected_ip?: string;
+}
+/**
+ * Response from cipherText validation
+ */
+interface ValidateCipherTextResponse {
+    valid: boolean;
+    device_uuid: string;
+    ip_address: string;
+    location?: {
+        latitude: number;
+        longitude: number;
+        accuracy: number;
+        country?: string;
+        country_iso?: string;
+        city?: string;
+        region?: string;
+    };
+    device: {
+        platform: string;
+        browser?: string;
+        os?: string;
+        is_mobile: boolean;
+        is_tablet: boolean;
+    };
+    risk: {
+        score: number;
+        level: 'low' | 'medium' | 'high' | 'critical';
+        factors: string[];
+        is_vpn: boolean;
+        is_proxy: boolean;
+        is_tor: boolean;
+    };
+    errors?: string[];
+}
 interface VerifyIPRequest {
     ip_address: string;
     user_id: string;
@@ -573,6 +725,78 @@ declare class GeolocationClient extends BaseClient {
      * ```
      */
     checkCompliance(countryISO: string): Promise<ComplianceCheckResponse>;
+    /**
+     * 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
+     * @returns Validation result with device info, location, and risk assessment
+     *
+     * @example
+     * ```typescript
+     * // Validate cipherText during login
+     * const result = await client.validateCipherText(
+     *   cipherText,
+     *   "user_123",
+     *   "login"
+     * );
+     *
+     * if (!result.valid) {
+     *   console.log("CipherText validation failed:", result.errors);
+     *   return;
+     * }
+     *
+     * console.log("Device UUID:", result.device_uuid);
+     * console.log("IP Address:", result.ip_address);
+     * console.log("Risk Level:", result.risk.level);
+     *
+     * if (result.risk.is_vpn) {
+     *   console.log("VPN detected");
+     * }
+     * ```
+     */
+    validateCipherText(cipherText: string, userId: string, eventType: CipherTextReason, expectedIP?: string): 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): Promise<{
+        ciphertext_valid: boolean;
+        ciphertext_result: ValidateCipherTextResponse;
+        location: LocationVerification;
+    }>;
     /**
      * Get location history for a user
      *
@@ -881,4 +1105,4 @@ declare class GeolocationClient extends BaseClient {
     captureLocation(token: string, capture: LocationCaptureRequest): Promise<LocationCaptureResponse>;
 }
 
-export { type AlertStatus as A, type LocationRequest as B, type ComplianceCheckResponse as C, type DeviceFingerprintRequest as D, type CreateLocationRequestRequest as E, type LocationRequestResult as F, GeolocationClient as G, type LocationRequestFilters as H, type LocationRequestListResponse as I, type JurisdictionConfig as J, type LocationCaptureRequest as K, type LocationVerification as L, type LocationShareInfo as M, type LocationCaptureResponse as N, type UseLocationRequestsOptions as O, type UseLocationRequestsResult as P, type UseLocationCaptureOptions as Q, type ResendLocationRequestRequest as R, type UseLocationCaptureResult as S, type UpdateJurisdictionRequest as U, type VerifyIPRequest as V, type WiFiNetwork as W, type GeoIPResult as a, type GeofenceEvaluation as b, type DeviceFingerprint as c, type DeviceTrustResult as d, type AlertSeverity as e, type AlertType as f, type GeolocationAlert as g, type AlertFilters as h, type AlertListResponse as i, type DashboardMetrics as j, type CreateJurisdictionRequest as k, type GeofenceRuleType as l, type GeofenceAction as m, type GeofenceRule as n, type CreateGeofenceRuleRequest as o, type UpdateGeofenceRuleRequest as p, type UpdateDeviceTrustRequest as q, type GeolocationRecord as r, type APIError as s, type GeolocationClientConfig as t, type UseGeolocationOptions as u, type UseGeolocationResult as v, type UseAlertsOptions as w, type UseAlertsResult as x, type LocationRequestStatus as y, type LocationRequestChannel as z };
+export { type UseLocationCaptureOptions as $, type AlertStatus as A, type GeolocationClientConfig as B, type CipherTextPayload as C, type DeviceFingerprintRequest as D, type UseGeolocationOptions as E, type UseGeolocationResult as F, GeolocationClient as G, type UseAlertsOptions as H, type UseAlertsResult as I, type JurisdictionConfig as J, type LocationRequestStatus as K, type LocationVerification as L, type LocationRequestChannel as M, type LocationRequest as N, type CreateLocationRequestRequest as O, type LocationRequestResult as P, type LocationRequestFilters as Q, type LocationRequestListResponse as R, type ResendLocationRequestRequest as S, type LocationCaptureRequest as T, type UpdateJurisdictionRequest as U, type ValidateCipherTextRequest as V, type WiFiNetwork as W, type LocationShareInfo as X, type LocationCaptureResponse as Y, type UseLocationRequestsOptions as Z, type UseLocationRequestsResult as _, type CipherTextReason as a, type UseLocationCaptureResult as a0, type CipherTextOptions as b, type CipherTextResult as c, type DecryptedCipherText as d, type ValidateCipherTextResponse as e, type VerifyIPRequest as f, type GeoIPResult as g, type GeofenceEvaluation as h, type DeviceFingerprint as i, type DeviceTrustResult as j, type ComplianceCheckResponse as k, type AlertSeverity as l, type AlertType as m, type GeolocationAlert as n, type AlertFilters as o, type AlertListResponse as p, type DashboardMetrics as q, type CreateJurisdictionRequest as r, type GeofenceRuleType as s, type GeofenceAction as t, type GeofenceRule as u, type CreateGeofenceRuleRequest as v, type UpdateGeofenceRuleRequest as w, type UpdateDeviceTrustRequest as x, type GeolocationRecord as y, type APIError as z };

package/dist/{client-BGI23PLG.d.mts → client-fisRnxD5.d.mts}

@@ -21,6 +21,158 @@ interface DeviceFingerprintRequest {
     language?: string;
     timezone?: string;
 }
+/**
+ * Raw device and location data collected from the client
+ * This data is encrypted into a cipherText before being sent to the server
+ */
+interface CipherTextPayload {
+    /** Device fingerprint data */
+    device: {
+        device_id: string;
+        user_agent: string;
+        platform: string;
+        browser?: string;
+        browser_version?: string;
+        os?: string;
+        os_version?: string;
+        screen_resolution?: string;
+        language?: string;
+        timezone?: string;
+        color_depth?: number;
+        hardware_concurrency?: number;
+        device_memory?: number;
+        touch_support?: boolean;
+        webgl_vendor?: string;
+        webgl_renderer?: string;
+    };
+    /** GPS/Geolocation data (if available) */
+    location?: {
+        latitude: number;
+        longitude: number;
+        accuracy: number;
+        altitude?: number;
+        altitude_accuracy?: number;
+        heading?: number;
+        speed?: number;
+        timestamp: number;
+    };
+    /** Network information */
+    network?: {
+        effective_type?: string;
+        downlink?: number;
+        rtt?: number;
+        save_data?: boolean;
+    };
+    /** Collection metadata */
+    metadata: {
+        collected_at: string;
+        sdk_version: string;
+        collection_reason: CipherTextReason;
+        page_url?: string;
+        referrer?: string;
+    };
+}
+/**
+ * Reason for collecting the cipherText
+ */
+type CipherTextReason = 'registration' | 'login' | 'transaction' | 'interval_check' | 'ip_change' | 'game_launch' | 'withdrawal' | 'manual_verification';
+/**
+ * Options for generating cipherText
+ */
+interface CipherTextOptions {
+    /** Reason for collection (required) */
+    reason: CipherTextReason;
+    /** Request GPS location (default: false) */
+    requestLocation?: boolean;
+    /** GPS timeout in milliseconds (default: 10000) */
+    locationTimeout?: number;
+    /** High accuracy GPS (default: true) */
+    highAccuracy?: boolean;
+    /** Include network info (default: true) */
+    includeNetworkInfo?: boolean;
+    /** Include WebGL info for fingerprinting (default: true) */
+    includeWebGL?: boolean;
+    /** Custom user ID to include */
+    userId?: string;
+}
+/**
+ * Result from cipherText generation
+ */
+interface CipherTextResult {
+    /** The encrypted cipherText string */
+    cipherText: string;
+    /** Whether GPS location was successfully captured */
+    locationCaptured: boolean;
+    /** Any errors that occurred during collection (non-fatal) */
+    warnings?: string[];
+    /** Timestamp when cipherText was generated */
+    generatedAt: string;
+    /** Expiry time for the cipherText */
+    expiresAt: string;
+}
+/**
+ * Decrypted cipherText data (returned by server after validation)
+ */
+interface DecryptedCipherText {
+    /** Whether the cipherText is valid */
+    valid: boolean;
+    /** Validation errors if any */
+    errors?: string[];
+    /** The decrypted payload */
+    payload?: CipherTextPayload;
+    /** Extracted device UUID */
+    device_uuid?: string;
+    /** Extracted IP address (from server) */
+    ip_address?: string;
+    /** Risk assessment */
+    risk?: {
+        score: number;
+        level: 'low' | 'medium' | 'high' | 'critical';
+        factors: string[];
+    };
+}
+/**
+ * Request to validate cipherText on the server
+ */
+interface ValidateCipherTextRequest {
+    cipher_text: string;
+    user_id: string;
+    event_type: CipherTextReason;
+    expected_ip?: string;
+}
+/**
+ * Response from cipherText validation
+ */
+interface ValidateCipherTextResponse {
+    valid: boolean;
+    device_uuid: string;
+    ip_address: string;
+    location?: {
+        latitude: number;
+        longitude: number;
+        accuracy: number;
+        country?: string;
+        country_iso?: string;
+        city?: string;
+        region?: string;
+    };
+    device: {
+        platform: string;
+        browser?: string;
+        os?: string;
+        is_mobile: boolean;
+        is_tablet: boolean;
+    };
+    risk: {
+        score: number;
+        level: 'low' | 'medium' | 'high' | 'critical';
+        factors: string[];
+        is_vpn: boolean;
+        is_proxy: boolean;
+        is_tor: boolean;
+    };
+    errors?: string[];
+}
 interface VerifyIPRequest {
     ip_address: string;
     user_id: string;
@@ -573,6 +725,78 @@ declare class GeolocationClient extends BaseClient {
      * ```
      */
     checkCompliance(countryISO: string): Promise<ComplianceCheckResponse>;
+    /**
+     * 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
+     * @returns Validation result with device info, location, and risk assessment
+     *
+     * @example
+     * ```typescript
+     * // Validate cipherText during login
+     * const result = await client.validateCipherText(
+     *   cipherText,
+     *   "user_123",
+     *   "login"
+     * );
+     *
+     * if (!result.valid) {
+     *   console.log("CipherText validation failed:", result.errors);
+     *   return;
+     * }
+     *
+     * console.log("Device UUID:", result.device_uuid);
+     * console.log("IP Address:", result.ip_address);
+     * console.log("Risk Level:", result.risk.level);
+     *
+     * if (result.risk.is_vpn) {
+     *   console.log("VPN detected");
+     * }
+     * ```
+     */
+    validateCipherText(cipherText: string, userId: string, eventType: CipherTextReason, expectedIP?: string): 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): Promise<{
+        ciphertext_valid: boolean;
+        ciphertext_result: ValidateCipherTextResponse;
+        location: LocationVerification;
+    }>;
     /**
      * Get location history for a user
      *
@@ -881,4 +1105,4 @@ declare class GeolocationClient extends BaseClient {
     captureLocation(token: string, capture: LocationCaptureRequest): Promise<LocationCaptureResponse>;
 }
 
-export { type AlertStatus as A, type LocationRequest as B, type ComplianceCheckResponse as C, type DeviceFingerprintRequest as D, type CreateLocationRequestRequest as E, type LocationRequestResult as F, GeolocationClient as G, type LocationRequestFilters as H, type LocationRequestListResponse as I, type JurisdictionConfig as J, type LocationCaptureRequest as K, type LocationVerification as L, type LocationShareInfo as M, type LocationCaptureResponse as N, type UseLocationRequestsOptions as O, type UseLocationRequestsResult as P, type UseLocationCaptureOptions as Q, type ResendLocationRequestRequest as R, type UseLocationCaptureResult as S, type UpdateJurisdictionRequest as U, type VerifyIPRequest as V, type WiFiNetwork as W, type GeoIPResult as a, type GeofenceEvaluation as b, type DeviceFingerprint as c, type DeviceTrustResult as d, type AlertSeverity as e, type AlertType as f, type GeolocationAlert as g, type AlertFilters as h, type AlertListResponse as i, type DashboardMetrics as j, type CreateJurisdictionRequest as k, type GeofenceRuleType as l, type GeofenceAction as m, type GeofenceRule as n, type CreateGeofenceRuleRequest as o, type UpdateGeofenceRuleRequest as p, type UpdateDeviceTrustRequest as q, type GeolocationRecord as r, type APIError as s, type GeolocationClientConfig as t, type UseGeolocationOptions as u, type UseGeolocationResult as v, type UseAlertsOptions as w, type UseAlertsResult as x, type LocationRequestStatus as y, type LocationRequestChannel as z };
+export { type UseLocationCaptureOptions as $, type AlertStatus as A, type GeolocationClientConfig as B, type CipherTextPayload as C, type DeviceFingerprintRequest as D, type UseGeolocationOptions as E, type UseGeolocationResult as F, GeolocationClient as G, type UseAlertsOptions as H, type UseAlertsResult as I, type JurisdictionConfig as J, type LocationRequestStatus as K, type LocationVerification as L, type LocationRequestChannel as M, type LocationRequest as N, type CreateLocationRequestRequest as O, type LocationRequestResult as P, type LocationRequestFilters as Q, type LocationRequestListResponse as R, type ResendLocationRequestRequest as S, type LocationCaptureRequest as T, type UpdateJurisdictionRequest as U, type ValidateCipherTextRequest as V, type WiFiNetwork as W, type LocationShareInfo as X, type LocationCaptureResponse as Y, type UseLocationRequestsOptions as Z, type UseLocationRequestsResult as _, type CipherTextReason as a, type UseLocationCaptureResult as a0, type CipherTextOptions as b, type CipherTextResult as c, type DecryptedCipherText as d, type ValidateCipherTextResponse as e, type VerifyIPRequest as f, type GeoIPResult as g, type GeofenceEvaluation as h, type DeviceFingerprint as i, type DeviceTrustResult as j, type ComplianceCheckResponse as k, type AlertSeverity as l, type AlertType as m, type GeolocationAlert as n, type AlertFilters as o, type AlertListResponse as p, type DashboardMetrics as q, type CreateJurisdictionRequest as r, type GeofenceRuleType as s, type GeofenceAction as t, type GeofenceRule as u, type CreateGeofenceRuleRequest as v, type UpdateGeofenceRuleRequest as w, type UpdateDeviceTrustRequest as x, type GeolocationRecord as y, type APIError as z };

package/dist/compliance/index.d.mts

@@ -1,5 +1,5 @@
-import { D as DeviceFingerprintRequest, L as LocationVerification, B as LocationRequest, J as JurisdictionConfig, H as LocationRequestFilters, I as LocationRequestListResponse, G as GeolocationClient } from '../client-BGI23PLG.mjs';
-export { E as CreateLocationRequestRequest, K as LocationCaptureRequest, N as LocationCaptureResponse, z as LocationRequestChannel, F as LocationRequestResult, y as LocationRequestStatus, M as LocationShareInfo, R as ResendLocationRequestRequest } from '../client-BGI23PLG.mjs';
+import { D as DeviceFingerprintRequest, L as LocationVerification, N as LocationRequest, J as JurisdictionConfig, Q as LocationRequestFilters, R as LocationRequestListResponse, G as GeolocationClient } from '../client-fisRnxD5.mjs';
+export { O as CreateLocationRequestRequest, T as LocationCaptureRequest, Y as LocationCaptureResponse, M as LocationRequestChannel, P as LocationRequestResult, K as LocationRequestStatus, X as LocationShareInfo, S as ResendLocationRequestRequest } from '../client-fisRnxD5.mjs';
 import { CustomerProfile, RiskProfileClient } from '../risk-profile/index.mjs';
 import { g as EntityType, C as CGSConfig, P as PaginationParams } from '../types-DxnfRzF_.mjs';
 

package/dist/compliance/index.d.ts

@@ -1,5 +1,5 @@
-import { D as DeviceFingerprintRequest, L as LocationVerification, B as LocationRequest, J as JurisdictionConfig, H as LocationRequestFilters, I as LocationRequestListResponse, G as GeolocationClient } from '../client-CBy3JJSM.js';
-export { E as CreateLocationRequestRequest, K as LocationCaptureRequest, N as LocationCaptureResponse, z as LocationRequestChannel, F as LocationRequestResult, y as LocationRequestStatus, M as LocationShareInfo, R as ResendLocationRequestRequest } from '../client-CBy3JJSM.js';
+import { D as DeviceFingerprintRequest, L as LocationVerification, N as LocationRequest, J as JurisdictionConfig, Q as LocationRequestFilters, R as LocationRequestListResponse, G as GeolocationClient } from '../client-K-qkyEBM.js';
+export { O as CreateLocationRequestRequest, T as LocationCaptureRequest, Y as LocationCaptureResponse, M as LocationRequestChannel, P as LocationRequestResult, K as LocationRequestStatus, X as LocationShareInfo, S as ResendLocationRequestRequest } from '../client-K-qkyEBM.js';
 import { CustomerProfile, RiskProfileClient } from '../risk-profile/index.js';
 import { g as EntityType, C as CGSConfig, P as PaginationParams } from '../types-DxnfRzF_.js';
 

package/dist/compliance/index.js

@@ -296,6 +296,115 @@ var GeolocationClient = class extends BaseClient {
       }
     );
   }
+  // ============================================================================
+  // CipherText Validation
+  // ============================================================================
+  /**
+   * 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
+   * @returns Validation result with device info, location, and risk assessment
+   *
+   * @example
+   * ```typescript
+   * // Validate cipherText during login
+   * const result = await client.validateCipherText(
+   *   cipherText,
+   *   "user_123",
+   *   "login"
+   * );
+   *
+   * if (!result.valid) {
+   *   console.log("CipherText validation failed:", result.errors);
+   *   return;
+   * }
+   *
+   * console.log("Device UUID:", result.device_uuid);
+   * console.log("IP Address:", result.ip_address);
+   * console.log("Risk Level:", result.risk.level);
+   *
+   * if (result.risk.is_vpn) {
+   *   console.log("VPN detected");
+   * }
+   * ```
+   */
+  async validateCipherText(cipherText, userId, eventType, expectedIP) {
+    const request = {
+      cipher_text: cipherText,
+      user_id: userId,
+      event_type: eventType,
+      expected_ip: expectedIP
+    };
+    return this.requestWithRetry(
+      "/api/v1/geo/validate-ciphertext",
+      {
+        method: "POST",
+        body: JSON.stringify(request)
+      }
+    );
+  }
+  /**
+   * 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");
+   * }
+   * ```
+   */
+  async validateAndVerify(cipherText, ipAddress, userId, eventType) {
+    const cipherTextResult = await this.validateCipherText(
+      cipherText,
+      userId,
+      eventType,
+      ipAddress
+    );
+    const locationResult = await this.verifyIP({
+      ip_address: ipAddress,
+      user_id: userId,
+      event_type: eventType,
+      device_fingerprint: cipherTextResult.valid && cipherTextResult.device ? {
+        device_id: cipherTextResult.device_uuid,
+        user_agent: "",
+        platform: cipherTextResult.device.platform,
+        browser: cipherTextResult.device.browser,
+        os: cipherTextResult.device.os
+      } : void 0
+    });
+    return {
+      ciphertext_valid: cipherTextResult.valid,
+      ciphertext_result: cipherTextResult,
+      location: locationResult
+    };
+  }
   /**
    * Get location history for a user
    *