vesant-sdk 1.6.2 → 1.6.4

package/dist/index.d.mts

@@ -1,15 +1,16 @@
 import { L as Logger, B as BaseClient, a as BaseClientConfig, R as RequestOptions } from './client-ePzhQKp9.mjs';
 export { d as CGSConfig, i as CircuitBreaker, C as CircuitBreakerConfig, g as CircuitBreakerState, h as CircuitBreakerStatus, j as RateLimitStatus, k as RateLimitTracker, b as RequestInterceptor, f as RequiredBaseClientConfig, e as RequiredCGSConfig, c as RequiredVesantConfig, V as VesantConfig } from './client-ePzhQKp9.mjs';
-import { T as Timestamp } from './types-B4Ezqo7V.mjs';
-export { A as APIResponse, C as CustomerStatus, E as EntityType, b as ErrorResponse, L as LocationCompliance, a as PaginatedResponse, P as PaginationParams, c as Result, R as RiskLevel, S as SuccessResponse, U as UUID, V as VerificationEventType } from './types-B4Ezqo7V.mjs';
-export { BaseWebhookEvent, ComplianceCheckFailedPayload, DecisionRecordedPayload, GeolocationBlockedPayload, GeolocationVerifiedPayload, KycStatusChangedPayload, LabelAppliedPayload, LocationRequestCompletedPayload, ProfileCreatedPayload, ProfileUpdatedPayload, RiskCategoryChangedPayload, RiskScoreChangedPayload, WebhookAnyHandler, WebhookEvent, WebhookEventHandler, WebhookEventType, WebhookHandler, WebhookHandlerConfig, WebhookMiddlewareOptions, createNextWebhookHandler, createWebhookMiddleware, verifyWebhookSignature } from './webhooks/index.mjs';
+export { A as APIResponse, C as CustomerStatus, E as EntityType, b as ErrorResponse, L as LocationCompliance, a as PaginatedResponse, P as PaginationParams, c as Result, R as RiskLevel, S as SuccessResponse, T as Timestamp, U as UUID, V as VerificationEventType } from './types-B4Ezqo7V.mjs';
+import { T as TransactionCreateDTO, a as TransactionCreateResponse } from './index-B04H4xfJ.mjs';
+export { B as BaseWebhookEvent, C as ComplianceCheckFailedPayload, D as DecisionRecordedPayload, o as GeolocationBlockedPayload, G as GeolocationVerifiedPayload, J as JSONB, K as KycStatusChangedPayload, L as LabelAppliedPayload, p as LocationRequestCompletedPayload, P as ProfileCreatedPayload, n as ProfileUpdatedPayload, m as RiskCategoryChangedPayload, R as RiskScoreChangedPayload, r as TaxFormType, s as TaxReminderSentPayload, q as TaxReminderType, g as Transaction, t as TransactionCallbackPayload, h as TransactionClientConfig, c as TransactionMode, d as TransactionStatus, b as TransactionType, y as WebhookAnyHandler, u as WebhookEvent, x as WebhookEventHandler, l as WebhookEventType, W as WebhookHandler, w as WebhookHandlerConfig, i as WebhookMiddlewareOptions, f as WithholdingReason, e as WithholdingType, k as createNextWebhookHandler, j as createWebhookMiddleware, v as verifyWebhookSignature } from './index-B04H4xfJ.mjs';
 export { B as APIError, p as AlertFilters, q as AlertListResponse, m as AlertSeverity, A as AlertStatus, n as AlertType, e as CipherTextCustomerData, b as CipherTextOptions, C as CipherTextPayload, a as CipherTextReason, c as CipherTextResult, l as ComplianceCheckResponse, w as CreateGeofenceRuleRequest, s as CreateJurisdictionRequest, Q as CreateLocationRequestRequest, r as DashboardMetrics, d as DecryptedCipherText, j as DeviceFingerprint, D as DeviceFingerprintRequest, k as DeviceTrustResult, h as GeoIPResult, u as GeofenceAction, i as GeofenceEvaluation, v as GeofenceRule, t as GeofenceRuleType, o as GeolocationAlert, G as GeolocationClient, F as GeolocationClientConfig, E as GeolocationConfigResponse, z as GeolocationRecord, J as JurisdictionConfig, Y as LocationCaptureRequest, _ as LocationCaptureResponse, P as LocationRequest, O as LocationRequestChannel, S as LocationRequestFilters, T as LocationRequestListResponse, R as LocationRequestResult, N as LocationRequestStatus, Z as LocationShareInfo, L as LocationVerification, W as ResendLocationRequestRequest, y as UpdateDeviceTrustRequest, x as UpdateGeofenceRuleRequest, U as UpdateJurisdictionRequest, K as UseAlertsOptions, M as UseAlertsResult, H as UseGeolocationOptions, I as UseGeolocationResult, a1 as UseLocationCaptureOptions, a2 as UseLocationCaptureResult, $ as UseLocationRequestsOptions, a0 as UseLocationRequestsResult, V as ValidateCipherTextRequest, f as ValidateCipherTextResponse, g as VerifyIPRequest, X as WiFiNetwork } from './client-BlCxjbY2.mjs';
 export { decodeCipherText, generateCipherText, isCipherTextExpired } from './geolocation/index.mjs';
 export { RiskProfileClient } from './risk-profile/index.mjs';
 export { d as CreateCustomerProfileRequest, d as CreateProfileRequest, C as CustomerProfile, e as CustomerProfileFilters, f as CustomerProfileListResponse, E as EmploymentType, L as LegalForm, P as ProfileDetailsResponse, e as ProfileFilters, f as ProfileListResponse, R as RiskCategory, h as RiskConfiguration, g as RiskDashboardMetrics, a as RiskFactor, b as RiskFactorType, c as RiskHistory, S as ScreeningStatus, U as UpdateProfileRequest } from './types-1RzYeSal.mjs';
 export { ComplianceClient, ComplianceLocationRequestInput, ComplianceLocationRequestResult, CurrencyRates, DEFAULT_CURRENCY_RATES, EventVerificationRequest, EventVerificationResponse, LoginVerificationRequest, LoginVerificationResponse, RegistrationVerificationRequest, RegistrationVerificationResponse, TransactionRiskResult, TransactionVerificationRequest, TransactionVerificationResponse } from './compliance/index.mjs';
-export { CheckKycStatusRequest, CheckKycStatusResponse, CreateReuseKycSessionRequest, CreateReuseKycSessionResponse, DocumentType, DocumentVerificationRequest, DocumentVerificationResponse, FaceProof, KycAlert, KycAlertFilters, KycAlertListResponse, KycAlertStatus, KycAlertType, KycClient, KycClientConfig, KycCustomerProfile, KycOverview, KycPagination, KycPreferences, KycRequest, KycRequestFilters, KycRequestListResponse, KycStatus, Name, Proof, ProofDownloadURL, ProofType, RequestAdditionalDocumentsRequest, RequestKycSubmitLinkRequest, RequestKycSubmitLinkResponse, SubmitReuseKycSessionRequest, SubmittedDocument, SupportedDocumentType, UpdateKycAlertRequest, UpdateKycPreferencesRequest, UpdateKycStatusRequest, UseKycAlertsOptions, UseKycAlertsResult, UseKycOverviewOptions, UseKycOverviewResult, UseKycPreferencesResult, UseKycRequestsOptions, UseKycRequestsResult, UseKycSubmissionOptions, UseKycSubmissionResult } from './kyc/index.mjs';
-export { CTPFormStatus, CTPTINStatus, ComplianceStats, ComplianceStatsFilters, CustomerTaxProfileRecord, CustomerType, DocumentRequestBreakdown, EmailSendingMethod, EnableWithholdingInput, EnableWithholdingResponse, GlobalTaxRule, ReRequestTaxFormInput, TINCheckResult, TINStatusBreakdown, TaxClient, TaxClientConfig, TaxRuleApprovalStatus, TaxRuleVersion, TaxRules, TransactionAction, TreatyCountry, TreatyCountryListResponse, UpdateTaxRulesInput, WFormCountBreakdown, WFormStatusBreakdown } from './tax/index.mjs';
+export { CheckKycStatusRequest, CheckKycStatusResponse, CreateReuseKycSessionRequest, CreateReuseKycSessionResponse, DocumentType, DocumentVerificationRequest, DocumentVerificationResponse, FaceProof, KycAlert, KycAlertFilters, KycAlertListResponse, KycAlertStatus, KycAlertType, KycClient, KycClientConfig, KycCustomerProfile, KycOverview, KycPagination, KycPreferences, KycRequest, KycRequestFilters, KycRequestListResponse, KycStatus, KycTriggerEvent, Name, Proof, ProofDownloadURL, ProofType, RequestAdditionalDocumentsRequest, RequestKycSubmitLinkRequest, RequestKycSubmitLinkResponse, SubmitReuseKycSessionRequest, SubmittedDocument, SupportedDocumentType, UpdateKycAlertRequest, UpdateKycPreferencesRequest, UpdateKycStatusRequest, UseKycAlertsOptions, UseKycAlertsResult, UseKycOverviewOptions, UseKycOverviewResult, UseKycPreferencesResult, UseKycRequestsOptions, UseKycRequestsResult, UseKycSubmissionOptions, UseKycSubmissionResult } from './kyc/index.mjs';
+export { CTPFormStatus, CTPTINStatus, ComplianceStats, ComplianceStatsFilters, CustomerTaxProfileRecord, CustomerType, DocumentRequestBreakdown, EmailSendingMethod, EnableWithholdingInput, EnableWithholdingResponse, GlobalTaxRule, ReRequestTaxFormInput, RunRemindersResponse, TINCheckResult, TINStatusBreakdown, TaxClient, TaxClientConfig, TaxRuleApprovalStatus, TaxRuleVersion, TaxRules, TransactionAction, TreatyCountry, TreatyCountryListResponse, UpdateReminderConfigInput, UpdateTaxRulesInput, WFormCountBreakdown, WFormStatusBreakdown } from './tax/index.mjs';
+export { FraudClient, FraudDecision, FraudEventType, FraudReactionType, FraudScoreRequest, FraudScoreResponseData, FraudScoreResponseEnvelope, FraudScoreResponseMetadata, TenantAction } from './fraud/index.mjs';
 
 /**
  * Error hierarchy for Vesant SDK
@@ -66,108 +67,7 @@ declare const noopLogger: Logger;
 /**
  * Single source of truth for the SDK version.
  */
-declare const SDK_VERSION = "1.6.2";
-
-/**
- * TypeScript types for the Transaction Monitoring (TM) Service
- *
- * These definitions mirror the Go structs used in
- * services/transaction-monitoring-service/internal/domain/
- *
- * Only a subset of fields is included; additional helpers may be
- * added as the SDK grows.
- */
-
-/**
- * Supported transaction types.
- * See domain/transaction.go TransactionType constants.
- */
-type TransactionType = "deposit" | "withdrawal" | "transfer" | "payment" | "refund" | "fee" | "adjustment";
-/**
- * Modes or channels by which the transaction was carried out.
- */
-type TransactionMode = "fiat" | "crypto" | "bank_transfer" | "card" | "wallet";
-/**
- * Current status of the transaction record.
- */
-type TransactionStatus = "pending" | "processing" | "completed" | "failed" | "cancelled" | "reversed";
-/**
- * Payload sent when creating a new transaction via the TM API.
- *
- * Numeric decimal types in Go are represented as strings in the SDK to avoid
- * precision loss in JavaScript.  Dates are ISO strings.
- */
-interface TransactionCreateDTO {
-    tx_id: string;
-    reference: string;
-    tenant_id: string;
-    customer_id: string;
-    transaction_type: TransactionType;
-    transaction_mode: TransactionMode;
-    amount: string;
-    currency: string;
-    status: TransactionStatus;
-    source_account: string;
-    destination_account: string;
-    country: string;
-    ip_address: string;
-    metadata: Record<string, any>;
-    benificiary_comment: string;
-    transaction_date: Timestamp;
-}
-/**
- * Representation of a transaction record returned from the TM service.
- */
-type WithholdingType = "none" | "backup_us" | "backup_non_us" | "treaty";
-type JSONB = Record<string, any>;
-type Transaction = {
-    id: string;
-    tx_id: string;
-    reference: string;
-    tenant_id: string;
-    customer_id: string;
-    transaction_type: TransactionType;
-    transaction_mode: TransactionMode;
-    amount: string;
-    withheld_amount: string;
-    released_amount: string;
-    withholding_rate: number;
-    withholding_reason?: string;
-    withholding_type?: WithholdingType;
-    tax_year: number;
-    currency: string;
-    status: TransactionStatus;
-    source_account?: string;
-    destination_account?: string;
-    country?: string;
-    ip_address?: string;
-    risk_score: number;
-    metadata?: JSONB;
-    benificiary_comment?: string;
-    transaction_date: string;
-    created_at: string;
-    updated_at: string;
-    deleted_at?: string | null;
-};
-/**
- * Configuration object consumed by {@link TransactionClient}.
- * Currently identical to {@link import('../core/types').BaseClientConfig},
- * exported here for future extensibility.
- */
-interface TransactionClientConfig {
-    baseURL: string;
-    tenantId: string;
-    apiKey?: string;
-    headers?: Record<string, string>;
-    timeout?: number;
-    retries?: number;
-    debug?: boolean;
-    environment?: 'production' | 'sandbox';
-}
-type TransactionCreateResponse = {
-    transaction: Transaction;
-    message: string;
-};
+declare const SDK_VERSION = "1.6.4";
 
 /**
  * TransactionClient - TypeScript SDK for the Transaction Monitoring service
@@ -226,4 +126,4 @@ declare class TransactionClient extends BaseClient {
     getTransaction(transactionId: string, requestOptions?: RequestOptions): Promise<void>;
 }
 
-export { AuthenticationError, BaseClient, BaseClientConfig, CGSError, CircuitBreakerOpenError, ComplianceBlockedError, ComplianceError, type JSONB, Logger, NetworkError, RateLimitError, RequestOptions, SDK_VERSION, ServiceUnavailableError, TimeoutError, Timestamp, type Transaction, TransactionClient, type TransactionClientConfig, type TransactionCreateDTO, type TransactionCreateResponse, type TransactionMode, type TransactionStatus, type TransactionType, ValidationError, VesantError, type WithholdingType, createConsoleLogger, noopLogger };
+export { AuthenticationError, BaseClient, BaseClientConfig, CGSError, CircuitBreakerOpenError, ComplianceBlockedError, ComplianceError, Logger, NetworkError, RateLimitError, RequestOptions, SDK_VERSION, ServiceUnavailableError, TimeoutError, TransactionClient, TransactionCreateDTO, TransactionCreateResponse, ValidationError, VesantError, createConsoleLogger, noopLogger };

package/dist/index.d.ts

@@ -1,15 +1,16 @@
 import { L as Logger, B as BaseClient, a as BaseClientConfig, R as RequestOptions } from './client-ePzhQKp9.js';
 export { d as CGSConfig, i as CircuitBreaker, C as CircuitBreakerConfig, g as CircuitBreakerState, h as CircuitBreakerStatus, j as RateLimitStatus, k as RateLimitTracker, b as RequestInterceptor, f as RequiredBaseClientConfig, e as RequiredCGSConfig, c as RequiredVesantConfig, V as VesantConfig } from './client-ePzhQKp9.js';
-import { T as Timestamp } from './types-B4Ezqo7V.js';
-export { A as APIResponse, C as CustomerStatus, E as EntityType, b as ErrorResponse, L as LocationCompliance, a as PaginatedResponse, P as PaginationParams, c as Result, R as RiskLevel, S as SuccessResponse, U as UUID, V as VerificationEventType } from './types-B4Ezqo7V.js';
-export { BaseWebhookEvent, ComplianceCheckFailedPayload, DecisionRecordedPayload, GeolocationBlockedPayload, GeolocationVerifiedPayload, KycStatusChangedPayload, LabelAppliedPayload, LocationRequestCompletedPayload, ProfileCreatedPayload, ProfileUpdatedPayload, RiskCategoryChangedPayload, RiskScoreChangedPayload, WebhookAnyHandler, WebhookEvent, WebhookEventHandler, WebhookEventType, WebhookHandler, WebhookHandlerConfig, WebhookMiddlewareOptions, createNextWebhookHandler, createWebhookMiddleware, verifyWebhookSignature } from './webhooks/index.js';
+export { A as APIResponse, C as CustomerStatus, E as EntityType, b as ErrorResponse, L as LocationCompliance, a as PaginatedResponse, P as PaginationParams, c as Result, R as RiskLevel, S as SuccessResponse, T as Timestamp, U as UUID, V as VerificationEventType } from './types-B4Ezqo7V.js';
+import { T as TransactionCreateDTO, a as TransactionCreateResponse } from './index-CItMPmLL.js';
+export { B as BaseWebhookEvent, C as ComplianceCheckFailedPayload, D as DecisionRecordedPayload, o as GeolocationBlockedPayload, G as GeolocationVerifiedPayload, J as JSONB, K as KycStatusChangedPayload, L as LabelAppliedPayload, p as LocationRequestCompletedPayload, P as ProfileCreatedPayload, n as ProfileUpdatedPayload, m as RiskCategoryChangedPayload, R as RiskScoreChangedPayload, r as TaxFormType, s as TaxReminderSentPayload, q as TaxReminderType, g as Transaction, t as TransactionCallbackPayload, h as TransactionClientConfig, c as TransactionMode, d as TransactionStatus, b as TransactionType, y as WebhookAnyHandler, u as WebhookEvent, x as WebhookEventHandler, l as WebhookEventType, W as WebhookHandler, w as WebhookHandlerConfig, i as WebhookMiddlewareOptions, f as WithholdingReason, e as WithholdingType, k as createNextWebhookHandler, j as createWebhookMiddleware, v as verifyWebhookSignature } from './index-CItMPmLL.js';
 export { B as APIError, p as AlertFilters, q as AlertListResponse, m as AlertSeverity, A as AlertStatus, n as AlertType, e as CipherTextCustomerData, b as CipherTextOptions, C as CipherTextPayload, a as CipherTextReason, c as CipherTextResult, l as ComplianceCheckResponse, w as CreateGeofenceRuleRequest, s as CreateJurisdictionRequest, Q as CreateLocationRequestRequest, r as DashboardMetrics, d as DecryptedCipherText, j as DeviceFingerprint, D as DeviceFingerprintRequest, k as DeviceTrustResult, h as GeoIPResult, u as GeofenceAction, i as GeofenceEvaluation, v as GeofenceRule, t as GeofenceRuleType, o as GeolocationAlert, G as GeolocationClient, F as GeolocationClientConfig, E as GeolocationConfigResponse, z as GeolocationRecord, J as JurisdictionConfig, Y as LocationCaptureRequest, _ as LocationCaptureResponse, P as LocationRequest, O as LocationRequestChannel, S as LocationRequestFilters, T as LocationRequestListResponse, R as LocationRequestResult, N as LocationRequestStatus, Z as LocationShareInfo, L as LocationVerification, W as ResendLocationRequestRequest, y as UpdateDeviceTrustRequest, x as UpdateGeofenceRuleRequest, U as UpdateJurisdictionRequest, K as UseAlertsOptions, M as UseAlertsResult, H as UseGeolocationOptions, I as UseGeolocationResult, a1 as UseLocationCaptureOptions, a2 as UseLocationCaptureResult, $ as UseLocationRequestsOptions, a0 as UseLocationRequestsResult, V as ValidateCipherTextRequest, f as ValidateCipherTextResponse, g as VerifyIPRequest, X as WiFiNetwork } from './client-C_A7QLcB.js';
 export { decodeCipherText, generateCipherText, isCipherTextExpired } from './geolocation/index.js';
 export { RiskProfileClient } from './risk-profile/index.js';
 export { d as CreateCustomerProfileRequest, d as CreateProfileRequest, C as CustomerProfile, e as CustomerProfileFilters, f as CustomerProfileListResponse, E as EmploymentType, L as LegalForm, P as ProfileDetailsResponse, e as ProfileFilters, f as ProfileListResponse, R as RiskCategory, h as RiskConfiguration, g as RiskDashboardMetrics, a as RiskFactor, b as RiskFactorType, c as RiskHistory, S as ScreeningStatus, U as UpdateProfileRequest } from './types-X5Md_dD_.js';
 export { ComplianceClient, ComplianceLocationRequestInput, ComplianceLocationRequestResult, CurrencyRates, DEFAULT_CURRENCY_RATES, EventVerificationRequest, EventVerificationResponse, LoginVerificationRequest, LoginVerificationResponse, RegistrationVerificationRequest, RegistrationVerificationResponse, TransactionRiskResult, TransactionVerificationRequest, TransactionVerificationResponse } from './compliance/index.js';
-export { CheckKycStatusRequest, CheckKycStatusResponse, CreateReuseKycSessionRequest, CreateReuseKycSessionResponse, DocumentType, DocumentVerificationRequest, DocumentVerificationResponse, FaceProof, KycAlert, KycAlertFilters, KycAlertListResponse, KycAlertStatus, KycAlertType, KycClient, KycClientConfig, KycCustomerProfile, KycOverview, KycPagination, KycPreferences, KycRequest, KycRequestFilters, KycRequestListResponse, KycStatus, Name, Proof, ProofDownloadURL, ProofType, RequestAdditionalDocumentsRequest, RequestKycSubmitLinkRequest, RequestKycSubmitLinkResponse, SubmitReuseKycSessionRequest, SubmittedDocument, SupportedDocumentType, UpdateKycAlertRequest, UpdateKycPreferencesRequest, UpdateKycStatusRequest, UseKycAlertsOptions, UseKycAlertsResult, UseKycOverviewOptions, UseKycOverviewResult, UseKycPreferencesResult, UseKycRequestsOptions, UseKycRequestsResult, UseKycSubmissionOptions, UseKycSubmissionResult } from './kyc/index.js';
-export { CTPFormStatus, CTPTINStatus, ComplianceStats, ComplianceStatsFilters, CustomerTaxProfileRecord, CustomerType, DocumentRequestBreakdown, EmailSendingMethod, EnableWithholdingInput, EnableWithholdingResponse, GlobalTaxRule, ReRequestTaxFormInput, TINCheckResult, TINStatusBreakdown, TaxClient, TaxClientConfig, TaxRuleApprovalStatus, TaxRuleVersion, TaxRules, TransactionAction, TreatyCountry, TreatyCountryListResponse, UpdateTaxRulesInput, WFormCountBreakdown, WFormStatusBreakdown } from './tax/index.js';
+export { CheckKycStatusRequest, CheckKycStatusResponse, CreateReuseKycSessionRequest, CreateReuseKycSessionResponse, DocumentType, DocumentVerificationRequest, DocumentVerificationResponse, FaceProof, KycAlert, KycAlertFilters, KycAlertListResponse, KycAlertStatus, KycAlertType, KycClient, KycClientConfig, KycCustomerProfile, KycOverview, KycPagination, KycPreferences, KycRequest, KycRequestFilters, KycRequestListResponse, KycStatus, KycTriggerEvent, Name, Proof, ProofDownloadURL, ProofType, RequestAdditionalDocumentsRequest, RequestKycSubmitLinkRequest, RequestKycSubmitLinkResponse, SubmitReuseKycSessionRequest, SubmittedDocument, SupportedDocumentType, UpdateKycAlertRequest, UpdateKycPreferencesRequest, UpdateKycStatusRequest, UseKycAlertsOptions, UseKycAlertsResult, UseKycOverviewOptions, UseKycOverviewResult, UseKycPreferencesResult, UseKycRequestsOptions, UseKycRequestsResult, UseKycSubmissionOptions, UseKycSubmissionResult } from './kyc/index.js';
+export { CTPFormStatus, CTPTINStatus, ComplianceStats, ComplianceStatsFilters, CustomerTaxProfileRecord, CustomerType, DocumentRequestBreakdown, EmailSendingMethod, EnableWithholdingInput, EnableWithholdingResponse, GlobalTaxRule, ReRequestTaxFormInput, RunRemindersResponse, TINCheckResult, TINStatusBreakdown, TaxClient, TaxClientConfig, TaxRuleApprovalStatus, TaxRuleVersion, TaxRules, TransactionAction, TreatyCountry, TreatyCountryListResponse, UpdateReminderConfigInput, UpdateTaxRulesInput, WFormCountBreakdown, WFormStatusBreakdown } from './tax/index.js';
+export { FraudClient, FraudDecision, FraudEventType, FraudReactionType, FraudScoreRequest, FraudScoreResponseData, FraudScoreResponseEnvelope, FraudScoreResponseMetadata, TenantAction } from './fraud/index.js';
 
 /**
  * Error hierarchy for Vesant SDK
@@ -66,108 +67,7 @@ declare const noopLogger: Logger;
 /**
  * Single source of truth for the SDK version.
  */
-declare const SDK_VERSION = "1.6.2";
-
-/**
- * TypeScript types for the Transaction Monitoring (TM) Service
- *
- * These definitions mirror the Go structs used in
- * services/transaction-monitoring-service/internal/domain/
- *
- * Only a subset of fields is included; additional helpers may be
- * added as the SDK grows.
- */
-
-/**
- * Supported transaction types.
- * See domain/transaction.go TransactionType constants.
- */
-type TransactionType = "deposit" | "withdrawal" | "transfer" | "payment" | "refund" | "fee" | "adjustment";
-/**
- * Modes or channels by which the transaction was carried out.
- */
-type TransactionMode = "fiat" | "crypto" | "bank_transfer" | "card" | "wallet";
-/**
- * Current status of the transaction record.
- */
-type TransactionStatus = "pending" | "processing" | "completed" | "failed" | "cancelled" | "reversed";
-/**
- * Payload sent when creating a new transaction via the TM API.
- *
- * Numeric decimal types in Go are represented as strings in the SDK to avoid
- * precision loss in JavaScript.  Dates are ISO strings.
- */
-interface TransactionCreateDTO {
-    tx_id: string;
-    reference: string;
-    tenant_id: string;
-    customer_id: string;
-    transaction_type: TransactionType;
-    transaction_mode: TransactionMode;
-    amount: string;
-    currency: string;
-    status: TransactionStatus;
-    source_account: string;
-    destination_account: string;
-    country: string;
-    ip_address: string;
-    metadata: Record<string, any>;
-    benificiary_comment: string;
-    transaction_date: Timestamp;
-}
-/**
- * Representation of a transaction record returned from the TM service.
- */
-type WithholdingType = "none" | "backup_us" | "backup_non_us" | "treaty";
-type JSONB = Record<string, any>;
-type Transaction = {
-    id: string;
-    tx_id: string;
-    reference: string;
-    tenant_id: string;
-    customer_id: string;
-    transaction_type: TransactionType;
-    transaction_mode: TransactionMode;
-    amount: string;
-    withheld_amount: string;
-    released_amount: string;
-    withholding_rate: number;
-    withholding_reason?: string;
-    withholding_type?: WithholdingType;
-    tax_year: number;
-    currency: string;
-    status: TransactionStatus;
-    source_account?: string;
-    destination_account?: string;
-    country?: string;
-    ip_address?: string;
-    risk_score: number;
-    metadata?: JSONB;
-    benificiary_comment?: string;
-    transaction_date: string;
-    created_at: string;
-    updated_at: string;
-    deleted_at?: string | null;
-};
-/**
- * Configuration object consumed by {@link TransactionClient}.
- * Currently identical to {@link import('../core/types').BaseClientConfig},
- * exported here for future extensibility.
- */
-interface TransactionClientConfig {
-    baseURL: string;
-    tenantId: string;
-    apiKey?: string;
-    headers?: Record<string, string>;
-    timeout?: number;
-    retries?: number;
-    debug?: boolean;
-    environment?: 'production' | 'sandbox';
-}
-type TransactionCreateResponse = {
-    transaction: Transaction;
-    message: string;
-};
+declare const SDK_VERSION = "1.6.4";
 
 /**
  * TransactionClient - TypeScript SDK for the Transaction Monitoring service
@@ -226,4 +126,4 @@ declare class TransactionClient extends BaseClient {
     getTransaction(transactionId: string, requestOptions?: RequestOptions): Promise<void>;
 }
 
-export { AuthenticationError, BaseClient, BaseClientConfig, CGSError, CircuitBreakerOpenError, ComplianceBlockedError, ComplianceError, type JSONB, Logger, NetworkError, RateLimitError, RequestOptions, SDK_VERSION, ServiceUnavailableError, TimeoutError, Timestamp, type Transaction, TransactionClient, type TransactionClientConfig, type TransactionCreateDTO, type TransactionCreateResponse, type TransactionMode, type TransactionStatus, type TransactionType, ValidationError, VesantError, type WithholdingType, createConsoleLogger, noopLogger };
+export { AuthenticationError, BaseClient, BaseClientConfig, CGSError, CircuitBreakerOpenError, ComplianceBlockedError, ComplianceError, Logger, NetworkError, RateLimitError, RequestOptions, SDK_VERSION, ServiceUnavailableError, TimeoutError, TransactionClient, TransactionCreateDTO, TransactionCreateResponse, ValidationError, VesantError, createConsoleLogger, noopLogger };

package/dist/index.js

@@ -242,7 +242,7 @@ var noopLogger = {
 };
 
 // src/core/version.ts
-var SDK_VERSION = "1.6.2";
+var SDK_VERSION = "1.6.4";
 
 // src/shared/browser-utils.ts
 function generateUUID() {
@@ -2606,19 +2606,23 @@ var KycClient = class extends BaseClient {
    *
    * Generates a link that the user can visit to submit their KYC documents.
    *
-   * @param request - Request containing the user ID, optional redirect URL, and optional callback URL (receives POST requests)
-   * @returns Response containing the redirect link and KYC ID
+   * @param request - Request containing the user ID, redirect URL, callback URL, and trigger event
+   * @returns Response containing kyc_required, can_skip, and optionally the redirect link and KYC ID
    *
    * @example
    * ```typescript
    * const result = await client.requestKycSubmitLink({
    *   user_id: "user_123",
-   *   redirect_url: "https://merchant.com/kyc-complete", // optional
-   *   callback_url: "https://merchant.com/api/kyc-webhook" // optional - receives POST requests on status change
+   *   redirect_url: "https://merchant.com/kyc-complete",
+   *   callback_url: "https://merchant.com/api/kyc-webhook",
+   *   trigger_event: "onboarding"
    * });
    *
-   * console.log(`Redirect user to: ${result.link}`);
-   * console.log(`KYC ID: ${result.kyc_id}`);
+   * if (result.kyc_required && result.link) {
+   *   console.log(`Redirect user to: ${result.link}`);
+   * } else if (result.can_skip) {
+   *   console.log("KYC not required, user can proceed");
+   * }
    * ```
    */
   async requestKycSubmitLink(request) {
@@ -3195,6 +3199,41 @@ var TaxClient = class extends BaseClient {
       { ...requestOptions, responseType: "arraybuffer" }
     );
   }
+  async runReminders() {
+    return this.request("/api/v1/tax/reminders/run", {
+      method: "POST"
+    });
+  }
+  /**
+   * Update only the reminder configuration (frequency + max count) without
+   * touching any other tax rule settings. Fetches current rules first and
+   * merges the reminder fields before sending the update.
+   *
+   * Requires the caller to be authenticated as a Tenant Super Admin.
+   * Throws VesantError with status 403 if the role requirement is not met.
+   */
+  async updateReminderConfig(input) {
+    const current = await this.getTaxRules();
+    return this.updateTaxRules({
+      trigger_account_creation: current.trigger_account_creation,
+      trigger_first_withdrawal: current.trigger_first_withdrawal,
+      trigger_threshold: current.trigger_threshold,
+      trigger_manual: current.trigger_manual,
+      trigger_tin_invalid: current.trigger_tin_invalid,
+      trigger_w8ben_expiry: current.trigger_w8ben_expiry,
+      trigger_tin_expired: current.trigger_tin_expired,
+      us_withholding_enabled: current.us_withholding_enabled,
+      non_us_withholding_enabled: current.non_us_withholding_enabled,
+      transaction_action: current.transaction_action,
+      w8ben_expiry_warning_days: current.w8ben_expiry_warning_days,
+      tin_verification_due_date: current.tin_verification_due_date,
+      email_sending_method: current.email_sending_method,
+      display_tin_links_on_platform: current.display_tin_links_on_platform,
+      tax_treaty_support: current.tax_treaty_support,
+      reminder_frequency_days: input.reminder_frequency_days,
+      reminder_max_count: input.reminder_max_count
+    });
+  }
   // ==========================================================================
   // P2 — Tenant Tax Rules
   // ==========================================================================
@@ -3303,6 +3342,64 @@ var TransactionClient = class extends BaseClient {
   }
 };
 
+// src/fraud/client.ts
+var FraudClient = class extends BaseClient {
+  /**
+   * Submit a single fraud event for scoring.
+   */
+  async scoreEvent(request, requestOptions) {
+    this.validateScoreRequest(request);
+    return this.requestWithRetry(
+      "/api/v1/fraud/score",
+      {
+        method: "POST",
+        body: JSON.stringify(request)
+      },
+      void 0,
+      void 0,
+      requestOptions
+    );
+  }
+  /**
+   * Submit multiple fraud events for scoring.
+   */
+  async scoreEventsBulk(requests, requestOptions) {
+    if (!Array.isArray(requests) || requests.length === 0) {
+      throw new ValidationError(
+        "Invalid bulk score request: at least one score request is required",
+        ["requests"]
+      );
+    }
+    requests.forEach((request, index) => this.validateScoreRequest(request, index));
+    return this.requestWithRetry(
+      "/api/v1/fraud/score/bulk",
+      {
+        method: "POST",
+        body: JSON.stringify(requests)
+      },
+      void 0,
+      void 0,
+      requestOptions
+    );
+  }
+  validateScoreRequest(request, index) {
+    const errors = [];
+    const prefix = index === void 0 ? "" : `requests[${index}].`;
+    if (!request.customer_id?.trim()) {
+      errors.push(`${prefix}customer_id is required`);
+    }
+    if (!request.sift_user_id?.trim()) {
+      errors.push(`${prefix}sift_user_id is required`);
+    }
+    if (!request.event_type?.trim()) {
+      errors.push(`${prefix}event_type is required`);
+    }
+    if (errors.length > 0) {
+      throw new ValidationError(`Invalid fraud score request: ${errors.join(", ")}`, errors);
+    }
+  }
+};
+
 // src/webhooks/handler.ts
 var WebhookHandler = class {
   constructor(config) {
@@ -3455,6 +3552,7 @@ exports.ComplianceBlockedError = ComplianceBlockedError;
 exports.ComplianceClient = ComplianceClient;
 exports.ComplianceError = ComplianceError;
 exports.DEFAULT_CURRENCY_RATES = DEFAULT_CURRENCY_RATES;
+exports.FraudClient = FraudClient;
 exports.GeolocationClient = GeolocationClient;
 exports.KycClient = KycClient;
 exports.NetworkError = NetworkError;