vesant-sdk 1.5.0 → 1.5.2

package/dist/index.mjs

@@ -240,7 +240,7 @@ var noopLogger = {
 };
 
 // src/core/version.ts
-var SDK_VERSION = "1.5.0";
+var SDK_VERSION = "1.5.2";
 
 // src/shared/browser-utils.ts
 function generateUUID() {
@@ -528,6 +528,8 @@ var BaseClient = class {
           return new VesantError(message, "FORBIDDEN", 403);
         case 404:
           return new VesantError(message, "NOT_FOUND", 404);
+        case 409:
+          return new VesantError(message, "DUPLICATE_PROFILE", 409);
         case 429: {
           const retryAfter = data.retry_after || data.retryAfter;
           return new RateLimitError(retryAfter);
@@ -2836,152 +2838,315 @@ var KycClient = class extends BaseClient {
   // ============================================================================
 };
 
-// src/decisions/client.ts
-var DecisionsClient = class extends BaseClient {
+// src/tax/client.ts
+var TaxClient = class extends BaseClient {
+  constructor(config) {
+    const baseConfig = {
+      baseURL: config.baseURL,
+      tenantId: config.tenantId,
+      apiKey: config.apiKey,
+      headers: config.headers,
+      timeout: config.timeout,
+      retries: 3,
+      debug: config.debug,
+      environment: config.environment
+    };
+    super(baseConfig);
+  }
+  // ============================================================================
+  // Tax Enable / Disable Configuration
+  // ============================================================================
   /**
-   * Record a new decision for a customer.
+   * Get the tax enabled/disabled state for the tenant
+   *
+   * @returns The current tax config (tax_enabled flag)
+   *
+   * @example
+   * ```typescript
+   * const config = await client.getTaxConfig();
+   * console.log(`Tax enabled: ${config.tax_enabled}`);
+   * ```
    */
-  async recordDecision(request, requestOptions) {
-    return this.requestWithRetry(
-      "/api/v1/decisions",
-      { method: "POST", body: JSON.stringify(request) },
-      void 0,
-      void 0,
-      requestOptions
-    );
+  async getTaxConfig() {
+    const res = await this.request("/api/v1/tax/config");
+    return res.tax_config;
   }
   /**
-   * Get decisions for a customer.
+   * Enable or disable tax compliance features for the tenant
+   *
+   * @param request - Object with tax_enabled boolean
+   * @returns Updated tax config
+   *
+   * @example
+   * ```typescript
+   * // Enable tax
+   * const config = await client.updateTaxConfig({ tax_enabled: true });
+   *
+   * // Disable tax
+   * const config = await client.updateTaxConfig({ tax_enabled: false });
+   * ```
    */
-  async getDecisions(customerId, filters, requestOptions) {
-    const queryString = this.buildQueryString({
-      customer_id: customerId,
-      ...filters
+  async updateTaxConfig(request) {
+    const res = await this.request("/api/v1/tax/config", {
+      method: "PUT",
+      body: JSON.stringify({ tax_config: request })
     });
-    return this.requestWithRetry(
-      `/api/v1/decisions${queryString}`,
-      { method: "GET" },
-      void 0,
-      void 0,
-      requestOptions
-    );
+    return res.tax_config;
   }
+  // ============================================================================
+  // Solicitation Trigger Configuration
+  // ============================================================================
   /**
-   * Get a specific decision by ID.
+   * Get solicitation triggers for the tenant
+   *
+   * @returns List of solicitation triggers with their enabled state
+   *
+   * @example
+   * ```typescript
+   * const triggers = await client.getSolicitationTriggers();
+   * triggers.forEach(t => console.log(`${t.label}: ${t.enabled}`));
+   * ```
    */
-  async getDecision(decisionId, requestOptions) {
-    return this.requestWithRetry(
-      `/api/v1/decisions/${encodeURIComponent(decisionId)}`,
-      { method: "GET" },
-      void 0,
-      void 0,
-      requestOptions
+  async getSolicitationTriggers() {
+    const res = await this.request(
+      "/api/v1/tax/solicitation/config"
     );
+    return res.solicitation_triggers;
   }
   /**
-   * Apply a label to a customer.
+   * Update solicitation triggers for the tenant
+   *
+   * @param triggers - Array of triggers with updated enabled/threshold values
+   * @returns Updated triggers
+   *
+   * @example
+   * ```typescript
+   * const triggers = await client.updateSolicitationTriggers([
+   *   { type: 'first_withdrawal', enabled: true, label: 'First Withdrawal', description: '...' },
+   *   { type: 'threshold_based', enabled: true, label: 'Threshold', description: '...', threshold_amount: 600 },
+   * ]);
+   * ```
    */
-  async applyLabel(request, requestOptions) {
-    return this.requestWithRetry(
-      "/api/v1/labels",
-      { method: "POST", body: JSON.stringify(request) },
-      void 0,
-      void 0,
-      requestOptions
+  async updateSolicitationTriggers(triggers) {
+    const res = await this.request(
+      "/api/v1/tax/solicitation/config",
+      {
+        method: "PUT",
+        body: JSON.stringify({ solicitation_triggers: triggers })
+      }
     );
+    return res.solicitation_triggers;
   }
+  // ============================================================================
+  // Reminder Configuration
+  // ============================================================================
   /**
-   * Remove a label from a customer.
+   * Get the reminder configuration for the tenant
+   *
+   * @returns Reminder config (enabled, max_reminders, frequency_days)
+   *
+   * @example
+   * ```typescript
+   * const config = await client.getReminderConfig();
+   * console.log(`Reminders enabled: ${config.enabled}, every ${config.frequency_days} days`);
+   * ```
    */
-  async removeLabel(customerId, requestOptions) {
-    return this.requestWithRetry(
-      `/api/v1/labels/${encodeURIComponent(customerId)}`,
-      { method: "DELETE" },
-      void 0,
-      void 0,
-      requestOptions
+  async getReminderConfig() {
+    const res = await this.request(
+      "/api/v1/tax/solicitation/reminder-config"
     );
+    return res.reminder_config;
   }
   /**
-   * Get labels for a customer.
+   * Update the reminder configuration for the tenant
+   *
+   * @param config - Reminder configuration to set
+   * @returns Updated reminder config
+   *
+   * @example
+   * ```typescript
+   * const updated = await client.updateReminderConfig({
+   *   enabled: true,
+   *   max_reminders: 3,
+   *   frequency_days: 7,
+   * });
+   * ```
    */
-  async getLabels(customerId, requestOptions) {
-    const queryString = this.buildQueryString({ customer_id: customerId });
-    return this.requestWithRetry(
-      `/api/v1/labels${queryString}`,
-      { method: "GET" },
-      void 0,
-      void 0,
-      requestOptions
+  async updateReminderConfig(config) {
+    const res = await this.request(
+      "/api/v1/tax/solicitation/reminder-config",
+      {
+        method: "PUT",
+        body: JSON.stringify({ reminder_config: config })
+      }
     );
+    return res.reminder_config;
   }
-};
-
-// src/scores/client.ts
-var ScoresClient = class extends BaseClient {
+  // ============================================================================
+  // Tax Forms
+  // ============================================================================
   /**
-   * Get the current risk score for a customer.
+   * List tax forms with optional filters and pagination
+   *
+   * @param filters - Optional filters (customer_id, form_type, form_status, etc.)
+   * @returns Paginated list of tax forms
+   *
+   * @example
+   * ```typescript
+   * const result = await client.listTaxForms({ form_type: 'W-9', form_status: 'Pending' });
+   * console.log(`Found ${result.total} forms`);
+   * ```
    */
-  async getScore(customerId, requestOptions) {
-    return this.requestWithRetry(
-      `/api/v1/scores/${encodeURIComponent(customerId)}`,
-      { method: "GET" },
-      void 0,
-      void 0,
-      requestOptions
-    );
+  async listTaxForms(filters) {
+    const params = {};
+    if (filters) {
+      if (filters.customer_id) params.customer_id = filters.customer_id;
+      if (filters.form_type) params.form_type = filters.form_type;
+      if (filters.form_status) params.form_status = filters.form_status;
+      if (filters.tin_status) params.tin_status = filters.tin_status;
+      if (filters.avalara_company_id) params.avalara_company_id = filters.avalara_company_id;
+      if (filters.search) params.search = filters.search;
+      if (filters.start_date) params.start_date = filters.start_date;
+      if (filters.end_date) params.end_date = filters.end_date;
+      if (filters.page) params.page = filters.page;
+      if (filters.page_size) params.limit = filters.page_size;
+    }
+    return this.request(`/api/v1/tax/forms${this.buildQueryString(params)}`);
   }
   /**
-   * Get a detailed score breakdown for a customer.
+   * Get a tax form by ID
+   *
+   * @param formId - Tax form UUID
+   * @returns Tax form details
    */
-  async getScoreBreakdown(customerId, requestOptions) {
-    return this.requestWithRetry(
-      `/api/v1/scores/${encodeURIComponent(customerId)}/breakdown`,
-      { method: "GET" },
-      void 0,
-      void 0,
-      requestOptions
-    );
+  async getTaxForm(formId) {
+    return this.request(`/api/v1/tax/forms/${formId}`);
   }
-};
-var WorkflowClient = class extends BaseClient {
   /**
-   * Get the current workflow status for a customer.
+   * Get lifecycle events for a tax form
+   *
+   * @param formId - Tax form UUID
+   * @returns List of lifecycle events
    */
-  async getWorkflowStatus(customerId, requestOptions) {
-    return this.requestWithRetry(
-      `/api/v1/workflows/${encodeURIComponent(customerId)}/status`,
-      { method: "GET" },
-      void 0,
-      void 0,
-      requestOptions
+  async getTaxFormLifecycleEvents(formId) {
+    const res = await this.request(
+      `/api/v1/tax/forms/${formId}/lifecycle`
     );
+    return res.lifecycle_events;
   }
+  // ============================================================================
+  // Customer Tax Profile
+  // ============================================================================
   /**
-   * List workflows with optional filters.
+   * Get the full tax profile for a customer (all forms + lifecycle events)
+   *
+   * @param customerID - Customer ID
+   * @returns Customer tax profile with all forms and events
+   *
+   * @example
+   * ```typescript
+   * const profile = await client.getCustomerTaxProfile('cust_123');
+   * console.log(`Customer has ${profile.tax_forms.length} tax forms`);
+   * ```
    */
-  async listWorkflows(filters, requestOptions) {
-    const queryString = this.buildQueryString(filters || {});
-    return this.requestWithRetry(
-      `/api/v1/workflows${queryString}`,
-      { method: "GET" },
-      void 0,
-      void 0,
-      requestOptions
-    );
+  async getCustomerTaxProfile(customerID) {
+    return this.request(`/api/v1/tax/profile/${customerID}`);
   }
+  // ============================================================================
+  // Tax Companies
+  // ============================================================================
   /**
-   * Get a specific workflow by ID.
+   * List Avalara tax companies for the tenant
+   *
+   * @param page - Page number (default: 1)
+   * @param pageSize - Items per page (default: 20)
+   * @returns Paginated list of tax companies
    */
-  async getWorkflow(workflowId, requestOptions) {
-    return this.requestWithRetry(
-      `/api/v1/workflows/${encodeURIComponent(workflowId)}`,
-      { method: "GET" },
-      void 0,
-      void 0,
-      requestOptions
+  async listTaxCompanies(page, pageSize) {
+    const params = {};
+    if (page) params.page = page;
+    if (pageSize) params.limit = pageSize;
+    return this.request(
+      `/api/v1/tax/companies${this.buildQueryString(params)}`
     );
   }
+  /**
+   * Get a tax company by ID
+   *
+   * @param companyId - Tax company UUID
+   * @returns Tax company details
+   */
+  async getTaxCompany(companyId) {
+    return this.request(`/api/v1/tax/companies/${companyId}`);
+  }
+  // ============================================================================
+  // Utility Methods (inherited from BaseClient: healthCheck, updateConfig, getConfig, buildQueryString)
+  // ============================================================================
+};
+
+// src/transaction/client.ts
+var TransactionClient = class extends BaseClient {
+  constructor(config) {
+    super(config);
+  }
+  // ==========================================================================
+  // Transaction creation
+  // ==========================================================================
+  /**
+   * Submit a new transaction record to the monitoring service.
+   *
+   * The gateway endpoint is `POST /api/v1/tm/transactions` and returns 201
+   * with no body on success.  The SDK method resolves to `void` to reflect
+   * that behaviour.
+   *
+   * @param request - Data required to create the transaction
+   * @param requestOptions - Optional request options (e.g. AbortSignal)
+   *
+   * @example
+   * ```ts
+   * const client = new TransactionClient({
+   *   baseURL: process.env.API_GATEWAY_URL!,
+   *   tenantId: 'tenant-123',
+   *   apiKey: 'pk_test_...',
+   * });
+   *
+   * await client.createTransaction({
+   *   tx_id: 'tx-1',
+   *   reference: 'ref-1',
+   *   tenant_id: 'tenant-123',
+   *   customer_id: 'cust-1',
+   *   transaction_type: 'deposit',
+   *   transaction_mode: 'ach',
+   *   amount: '100.00',
+   *   currency: 'USD',
+   *   status: 'pending',
+   *   source_account: 'acct-1',
+   *   destination_account: 'acct-2',
+   *   country: 'US',
+   *   ip_address: '10.0.0.1',
+   *   metadata: {},
+   *   benificiary_comment: '',
+   *   transaction_date: new Date().toISOString(),
+   * });
+   * ```
+   */
+  async createTransaction(request, requestOptions) {
+    const data = await this.requestWithRetry("/api/v1/tm/transactions", {
+      method: "POST",
+      body: JSON.stringify(request)
+    }, void 0, void 0, requestOptions);
+    return data;
+  }
+  /**
+   * 
+   * @param transactionId tx_id of the transaction 
+   * @param requestOptions  optional request options (e.g. AbortSignal)
+   */
+  async getTransaction(transactionId, requestOptions) {
+    await this.requestWithRetry(`/api/v1/tm/transactions/status/${transactionId}`, {
+      method: "GET"
+    }, void 0, void 0, requestOptions);
+  }
 };
 
 // src/webhooks/handler.ts
@@ -3127,6 +3292,6 @@ function buildHandler(options) {
   return handler;
 }
 
-export { AuthenticationError, BaseClient, CGSError, CircuitBreaker, CircuitBreakerOpenError, ComplianceBlockedError, ComplianceClient, ComplianceError, DEFAULT_CURRENCY_RATES, DecisionsClient, GeolocationClient, KycClient, NetworkError, RateLimitError, RateLimitTracker, RiskProfileClient, SDK_VERSION, ScoresClient, ServiceUnavailableError, TimeoutError, ValidationError, VesantError, WebhookHandler, WorkflowClient, createConsoleLogger, createNextWebhookHandler, createWebhookMiddleware, decodeCipherText, generateCipherText, isCipherTextExpired, noopLogger, verifyWebhookSignature };
+export { AuthenticationError, BaseClient, CGSError, CircuitBreaker, CircuitBreakerOpenError, ComplianceBlockedError, ComplianceClient, ComplianceError, DEFAULT_CURRENCY_RATES, GeolocationClient, KycClient, NetworkError, RateLimitError, RateLimitTracker, RiskProfileClient, SDK_VERSION, ServiceUnavailableError, TaxClient, TimeoutError, TransactionClient, ValidationError, VesantError, WebhookHandler, createConsoleLogger, createNextWebhookHandler, createWebhookMiddleware, decodeCipherText, generateCipherText, isCipherTextExpired, noopLogger, verifyWebhookSignature };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map