vesant-sdk 1.1.0 → 1.2.0

package/dist/client-VKJg2GGT.d.mts

@@ -1,253 +0,0 @@
-import { B as BaseClient } from './client-B7YzKVEm.mjs';
-import { R as RequestOptions, P as PaginationParams } from './types-DBGM-bFB.mjs';
-import { G as GeolocationClientConfig, V as VerifyIPRequest, L as LocationVerification, C as ComplianceCheckResponse, a as GeolocationConfigResponse, b as CipherTextReason, c as CipherTextCustomerData, d as ValidateCipherTextResponse, e as CreateLocationRequestRequest, f as LocationRequestResult, g as LocationRequest, h as LocationRequestFilters, i as LocationRequestListResponse, R as ResendLocationRequestRequest, j as LocationShareInfo, k as LocationCaptureRequest, l as LocationCaptureResponse } from './types-DGbuL8c0.mjs';
-
-/**
- * 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 {
-    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>;
-}
-
-export { GeolocationClient as G };

package/dist/client-hXdrPhA4.d.ts

@@ -1,253 +0,0 @@
-import { B as BaseClient } from './client-BaNLT2Df.js';
-import { R as RequestOptions, P as PaginationParams } from './types-DBGM-bFB.js';
-import { G as GeolocationClientConfig, V as VerifyIPRequest, L as LocationVerification, C as ComplianceCheckResponse, a as GeolocationConfigResponse, b as CipherTextReason, c as CipherTextCustomerData, d as ValidateCipherTextResponse, e as CreateLocationRequestRequest, f as LocationRequestResult, g as LocationRequest, h as LocationRequestFilters, i as LocationRequestListResponse, R as ResendLocationRequestRequest, j as LocationShareInfo, k as LocationCaptureRequest, l as LocationCaptureResponse } from './types-DgNbBnEH.js';
-
-/**
- * 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 {
-    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>;
-}
-
-export { GeolocationClient as G };