cgs-compliance-sdk 2.0.4 → 2.0.5

package/dist/compliance/index.d.mts

@@ -0,0 +1,231 @@
+import { D as DeviceFingerprintRequest, L as LocationVerification, G as GeolocationClient } from '../client-CPBy8d1H.mjs';
+import { d as CustomerProfile, C as CGSConfig, R as RiskProfileClient } from '../index-CzElZ3T6.mjs';
+import { c as EntityType } from '../types-mQdu71xf.mjs';
+
+/**
+ * Compliance orchestration types
+ *
+ * Types for unified compliance verification flows that combine
+ * geolocation verification with customer risk profiling.
+ */
+
+interface RegistrationVerificationRequest {
+    customerId: string;
+    fullName: string;
+    emailAddress: string;
+    phoneNumber?: string;
+    dateOfBirth?: string;
+    address?: string;
+    entityType?: EntityType;
+    ipAddress: string;
+    deviceFingerprint?: DeviceFingerprintRequest;
+    metadata?: Record<string, unknown>;
+}
+interface RegistrationVerificationResponse {
+    allowed: boolean;
+    geolocation: LocationVerification;
+    profile: CustomerProfile;
+    requiresKYC: boolean;
+    requiresEDD: boolean;
+    blockReasons: string[];
+    processingTime: number;
+}
+interface LoginVerificationRequest {
+    customerId: string;
+    ipAddress: string;
+    deviceFingerprint?: DeviceFingerprintRequest;
+    metadata?: Record<string, unknown>;
+}
+interface LoginVerificationResponse {
+    allowed: boolean;
+    geolocation: LocationVerification;
+    profile: CustomerProfile;
+    requiresStepUp: boolean;
+    blockReasons: string[];
+    processingTime: number;
+}
+interface TransactionVerificationRequest {
+    customerId: string;
+    ipAddress: string;
+    amount: number;
+    currency: string;
+    transactionType?: 'deposit' | 'withdrawal' | 'bet' | 'transfer' | 'payout';
+    deviceFingerprint?: DeviceFingerprintRequest;
+    metadata?: Record<string, unknown>;
+}
+interface TransactionVerificationResponse {
+    allowed: boolean;
+    geolocation: LocationVerification;
+    profile: CustomerProfile;
+    transactionRisk: TransactionRiskResult;
+    requiresApproval: boolean;
+    blockReasons: string[];
+    processingTime: number;
+}
+interface TransactionRiskResult {
+    score: number;
+    level: 'low' | 'medium' | 'high' | 'critical';
+    factors: string[];
+    allowed: boolean;
+    requiresManualReview: boolean;
+}
+interface EventVerificationRequest {
+    customerId: string;
+    ipAddress: string;
+    eventType: string;
+    deviceFingerprint?: DeviceFingerprintRequest;
+    metadata?: Record<string, unknown>;
+}
+interface EventVerificationResponse {
+    allowed: boolean;
+    geolocation: LocationVerification;
+    blockReasons: string[];
+    processingTime: number;
+}
+interface CurrencyRates {
+    [currency: string]: number;
+}
+declare const DEFAULT_CURRENCY_RATES: CurrencyRates;
+
+/**
+ * ComplianceClient - Unified Compliance Orchestration
+ *
+ * Main integration point for casino platforms. Orchestrates geolocation
+ * verification with customer risk profiling for complete compliance coverage.
+ *
+ * GeoComply-style approach: SDK is the primary data injection point.
+ */
+
+declare class ComplianceClient {
+    private geoClient;
+    private riskClient;
+    private config;
+    private currencyRates;
+    constructor(config: CGSConfig);
+    /**
+     * 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.
+     *
+     * @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): Promise<RegistrationVerificationResponse>;
+    /**
+     * 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): 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): Promise<TransactionVerificationResponse>;
+    /**
+     * Generic event verification (for other touchpoints)
+     *
+     * @param request - Event verification request
+     * @returns Verification response
+     */
+    verifyEvent(request: EventVerificationRequest): Promise<EventVerificationResponse>;
+    private shouldUpdateProfile;
+    private createProfileFromGeo;
+    private calculateTransactionRisk;
+    private checkJurisdictionLimits;
+    private normalizeToUSD;
+    private getRiskLevel;
+    private getBlockReasons;
+    private getTransactionBlockReasons;
+    /**
+     * Update currency exchange rates
+     *
+     * @param rates - Currency to USD exchange rates
+     */
+    updateCurrencyRates(rates: CurrencyRates): void;
+    /**
+     * Get underlying geolocation client
+     */
+    getGeolocationClient(): GeolocationClient;
+    /**
+     * Get underlying risk profile client
+     */
+    getRiskProfileClient(): RiskProfileClient;
+    /**
+     * Update configuration
+     */
+    updateConfig(config: Partial<CGSConfig>): void;
+}
+
+export { ComplianceClient, type CurrencyRates, DEFAULT_CURRENCY_RATES, type EventVerificationRequest, type EventVerificationResponse, type LoginVerificationRequest, type LoginVerificationResponse, type RegistrationVerificationRequest, type RegistrationVerificationResponse, type TransactionRiskResult, type TransactionVerificationRequest, type TransactionVerificationResponse };

package/dist/compliance/index.d.ts

@@ -0,0 +1,231 @@
+import { D as DeviceFingerprintRequest, L as LocationVerification, G as GeolocationClient } from '../client-BIRcQF2C.js';
+import { d as CustomerProfile, C as CGSConfig, R as RiskProfileClient } from '../index-BQPX1yNM.js';
+import { c as EntityType } from '../types-mQdu71xf.js';
+
+/**
+ * Compliance orchestration types
+ *
+ * Types for unified compliance verification flows that combine
+ * geolocation verification with customer risk profiling.
+ */
+
+interface RegistrationVerificationRequest {
+    customerId: string;
+    fullName: string;
+    emailAddress: string;
+    phoneNumber?: string;
+    dateOfBirth?: string;
+    address?: string;
+    entityType?: EntityType;
+    ipAddress: string;
+    deviceFingerprint?: DeviceFingerprintRequest;
+    metadata?: Record<string, unknown>;
+}
+interface RegistrationVerificationResponse {
+    allowed: boolean;
+    geolocation: LocationVerification;
+    profile: CustomerProfile;
+    requiresKYC: boolean;
+    requiresEDD: boolean;
+    blockReasons: string[];
+    processingTime: number;
+}
+interface LoginVerificationRequest {
+    customerId: string;
+    ipAddress: string;
+    deviceFingerprint?: DeviceFingerprintRequest;
+    metadata?: Record<string, unknown>;
+}
+interface LoginVerificationResponse {
+    allowed: boolean;
+    geolocation: LocationVerification;
+    profile: CustomerProfile;
+    requiresStepUp: boolean;
+    blockReasons: string[];
+    processingTime: number;
+}
+interface TransactionVerificationRequest {
+    customerId: string;
+    ipAddress: string;
+    amount: number;
+    currency: string;
+    transactionType?: 'deposit' | 'withdrawal' | 'bet' | 'transfer' | 'payout';
+    deviceFingerprint?: DeviceFingerprintRequest;
+    metadata?: Record<string, unknown>;
+}
+interface TransactionVerificationResponse {
+    allowed: boolean;
+    geolocation: LocationVerification;
+    profile: CustomerProfile;
+    transactionRisk: TransactionRiskResult;
+    requiresApproval: boolean;
+    blockReasons: string[];
+    processingTime: number;
+}
+interface TransactionRiskResult {
+    score: number;
+    level: 'low' | 'medium' | 'high' | 'critical';
+    factors: string[];
+    allowed: boolean;
+    requiresManualReview: boolean;
+}
+interface EventVerificationRequest {
+    customerId: string;
+    ipAddress: string;
+    eventType: string;
+    deviceFingerprint?: DeviceFingerprintRequest;
+    metadata?: Record<string, unknown>;
+}
+interface EventVerificationResponse {
+    allowed: boolean;
+    geolocation: LocationVerification;
+    blockReasons: string[];
+    processingTime: number;
+}
+interface CurrencyRates {
+    [currency: string]: number;
+}
+declare const DEFAULT_CURRENCY_RATES: CurrencyRates;
+
+/**
+ * ComplianceClient - Unified Compliance Orchestration
+ *
+ * Main integration point for casino platforms. Orchestrates geolocation
+ * verification with customer risk profiling for complete compliance coverage.
+ *
+ * GeoComply-style approach: SDK is the primary data injection point.
+ */
+
+declare class ComplianceClient {
+    private geoClient;
+    private riskClient;
+    private config;
+    private currencyRates;
+    constructor(config: CGSConfig);
+    /**
+     * 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.
+     *
+     * @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): Promise<RegistrationVerificationResponse>;
+    /**
+     * 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): 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): Promise<TransactionVerificationResponse>;
+    /**
+     * Generic event verification (for other touchpoints)
+     *
+     * @param request - Event verification request
+     * @returns Verification response
+     */
+    verifyEvent(request: EventVerificationRequest): Promise<EventVerificationResponse>;
+    private shouldUpdateProfile;
+    private createProfileFromGeo;
+    private calculateTransactionRisk;
+    private checkJurisdictionLimits;
+    private normalizeToUSD;
+    private getRiskLevel;
+    private getBlockReasons;
+    private getTransactionBlockReasons;
+    /**
+     * Update currency exchange rates
+     *
+     * @param rates - Currency to USD exchange rates
+     */
+    updateCurrencyRates(rates: CurrencyRates): void;
+    /**
+     * Get underlying geolocation client
+     */
+    getGeolocationClient(): GeolocationClient;
+    /**
+     * Get underlying risk profile client
+     */
+    getRiskProfileClient(): RiskProfileClient;
+    /**
+     * Update configuration
+     */
+    updateConfig(config: Partial<CGSConfig>): void;
+}
+
+export { ComplianceClient, type CurrencyRates, DEFAULT_CURRENCY_RATES, type EventVerificationRequest, type EventVerificationResponse, type LoginVerificationRequest, type LoginVerificationResponse, type RegistrationVerificationRequest, type RegistrationVerificationResponse, type TransactionRiskResult, type TransactionVerificationRequest, type TransactionVerificationResponse };

package/dist/compliance/index.js

@@ -1024,6 +1024,22 @@ var RiskProfileClient = class extends BaseClient {
   }
 };
 
+// src/compliance/types.ts
+var DEFAULT_CURRENCY_RATES = {
+  USD: 1,
+  EUR: 1.1,
+  GBP: 1.27,
+  CAD: 0.74,
+  AUD: 0.66,
+  JPY: 67e-4,
+  CHF: 1.13,
+  CNY: 0.14,
+  INR: 0.012,
+  BRL: 0.2,
+  MXN: 0.058,
+  ZAR: 0.055
+};
+
 // src/compliance/client.ts
 var ComplianceClient = class {
   constructor(config) {
@@ -1045,7 +1061,6 @@ var ComplianceClient = class {
       apiKey: this.config.apiKey,
       headers: this.config.headers,
       timeout: this.config.timeout,
-      retries: this.config.retries,
       debug: this.config.debug
     });
     this.riskClient = new RiskProfileClient({
@@ -1054,7 +1069,6 @@ var ComplianceClient = class {
       apiKey: this.config.apiKey,
       headers: this.config.headers,
       timeout: this.config.timeout,
-      retries: this.config.retries,
       debug: this.config.debug
     });
     this.currencyRates = DEFAULT_CURRENCY_RATES;
@@ -1456,23 +1470,7 @@ var ComplianceClient = class {
   }
 };
 
-// src/compliance/types.ts
-var DEFAULT_CURRENCY_RATES2 = {
-  USD: 1,
-  EUR: 1.1,
-  GBP: 1.27,
-  CAD: 0.74,
-  AUD: 0.66,
-  JPY: 67e-4,
-  CHF: 1.13,
-  CNY: 0.14,
-  INR: 0.012,
-  BRL: 0.2,
-  MXN: 0.058,
-  ZAR: 0.055
-};
-
 exports.ComplianceClient = ComplianceClient;
-exports.DEFAULT_CURRENCY_RATES = DEFAULT_CURRENCY_RATES2;
+exports.DEFAULT_CURRENCY_RATES = DEFAULT_CURRENCY_RATES;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map