@kuvarpay/sdk 1.4.0 → 1.4.2

package/index.d.ts

@@ -30,6 +30,26 @@ export interface VerifyPaymentResult {
   raw: any;
 }
 
+export interface CreateSubaccountRequest {
+  business_name: string;
+  percentage_charge?: number | string;
+  currency?: string;
+  account_name?: string;
+  settlement_bank?: string;
+  account_number?: string;
+  mobile_money_number?: string;
+  mobile_money_provider?: string;
+  crypto_currency?: string;
+  crypto_network?: string;
+  wallet_address?: string;
+  primary_contact_email?: string;
+  primary_contact_phone?: string;
+  description?: string;
+  metadata?: Record<string, any>;
+  type?: string | 'BANK_TRANSFER' | 'MOBILE_MONEY' | 'CRYPTO';
+  [key: string]: any;
+}
+
 export class KuvarPayServer {
   constructor(config?: KuvarPayServerConfig);
   getSessionStatus(sessionId: string): Promise<SessionStatusResult>;
@@ -97,11 +117,10 @@ export class KuvarPayServer {
   getOptimalTransferFee(amount: number, currency?: string): Promise<any>;
   sendInvoiceEmail(sessionId: string): Promise<any>;
 
-  // Subaccounts
-  createSubaccount(subaccountData: Record<string, any>): Promise<any>;
+  createSubaccount(subaccountData: CreateSubaccountRequest): Promise<any>;
   listSubaccounts(params?: { page?: number; perPage?: number }): Promise<any>;
   getSubaccount(code: string): Promise<any>;
-  updateSubaccount(code: string, subaccountData: Record<string, any>): Promise<any>;
+  updateSubaccount(code: string, subaccountData: Partial<CreateSubaccountRequest>): Promise<any>;
   deleteSubaccount(code: string): Promise<any>;
 
   // Split Groups
@@ -143,6 +162,7 @@ export class KuvarPayServer {
   renewSubscription(subscriptionId: string, body?: Record<string, any>): Promise<any>;
 
   // Banks
+  getBanks(currency: string, options?: { type?: 'bank' | 'mobile_money'; country?: string }): Promise<any>;
   getBanks(params?: { currency?: string; type?: 'bank' | 'mobile_money'; country?: string }): Promise<any>;
   resolveBankAccount(data: { bank_code: string; account_number: string; country_code?: string }): Promise<any>;
 

package/index.js

@@ -299,7 +299,7 @@ class KuvarPayServer {
 
   /**
    * Create a new subaccount
-   * @param {Object} subaccountData - { business_name, percentage_charge, ... }
+   * @param {Object} subaccountData - { business_name, percentage_charge, currency, type, crypto_currency, crypto_network, wallet_address, ... }
    */
   async createSubaccount(subaccountData) {
     return this._post('/api/v1/subaccounts', subaccountData);
@@ -437,16 +437,26 @@ class KuvarPayServer {
 
   /**
    * List supported banks
-   * GET /api/v1/banks
-   * @param {Object} params - { currency, type, country }
+   * GET /api/v1/banks or GET /api/v1/banks/:currency
+   * @param {string|Object} [params] - Currency string or params object { currency, type, country }
+   * @param {Object} [options] - Additional query params if first arg is currency string
    */
-  async getBanks(params = {}) {
-    // If params is a string, treat it as currency and use path-based endpoint for better reliability
+  async getBanks(params = {}, options = {}) {
+    // Handle (currency, options) signature
     if (typeof params === 'string') {
-      return this._get(`/api/v1/banks/${encodeURIComponent(params)}`);
+      const query = new URLSearchParams(options).toString();
+      const path = query ? `/api/v1/banks/${encodeURIComponent(params)}?${query}` : `/api/v1/banks/${encodeURIComponent(params)}`;
+      return this._get(path);
     }
 
-    const query = new URLSearchParams(params).toString();
+    const { currency, ...rest } = params || {};
+    if (currency) {
+      const query = new URLSearchParams(rest).toString();
+      const path = query ? `/api/v1/banks/${encodeURIComponent(currency)}?${query}` : `/api/v1/banks/${encodeURIComponent(currency)}`;
+      return this._get(path);
+    }
+
+    const query = new URLSearchParams(rest).toString();
     const path = query ? `/api/v1/banks?${query}` : '/api/v1/banks';
     return this._get(path);
   }

package/index.mjs

@@ -305,10 +305,28 @@ export class KuvarPayServer {
     return data;
   }
 
-  // --- Banks & Account Verification ---
+  /**
+   * List supported banks
+   * GET /api/v1/banks or GET /api/v1/banks/:currency
+   * @param {string|Object} [params] - Currency string or params object { currency, type, country }
+   * @param {Object} [options] - Additional query params if first arg is currency string
+   */
+  async getBanks(params = {}, options = {}) {
+    // Handle (currency, options) signature
+    if (typeof params === 'string') {
+      const query = new URLSearchParams(options).toString();
+      const path = query ? `/api/v1/banks/${encodeURIComponent(params)}?${query}` : `/api/v1/banks/${encodeURIComponent(params)}`;
+      return this._get(path);
+    }
 
-  async getBanks(params = {}) {
-    const query = new URLSearchParams(params).toString();
+    const { currency, ...rest } = params || {};
+    if (currency) {
+      const query = new URLSearchParams(rest).toString();
+      const path = query ? `/api/v1/banks/${encodeURIComponent(currency)}?${query}` : `/api/v1/banks/${encodeURIComponent(currency)}`;
+      return this._get(path);
+    }
+
+    const query = new URLSearchParams(rest).toString();
     const path = query ? `/api/v1/banks?${query}` : '/api/v1/banks';
     return this._get(path);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kuvarpay/sdk",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "description": "Official KuvarPay Server SDK for Node.js",
   "main": "index.js",
   "module": "index.mjs",