vesant-sdk 1.6.2 → 1.6.3

package/dist/index.js

@@ -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;