@kuvarpay/sdk 1.2.0 → 1.2.2

package/index.d.ts

@@ -56,6 +56,22 @@ export class KuvarPayServer {
     [key: string]: any;
   }): Promise<{ sessionId: string; authToken?: string; approvalUrl?: string; raw: any }>;
 
+  createDirectPayment(data: {
+    amount: number;
+    currency: string;
+    fromCurrency: string;
+    fromNetwork: string;
+    description?: string;
+    customerEmail?: string;
+    customerName?: string;
+    redirectUrl?: string;
+    callbackUrl?: string;
+    metadata?: Record<string, any>;
+    subaccount?: string;
+    splitCode?: string;
+    [key: string]: any;
+  }): Promise<any>;
+
   createTransaction(transactionData: {
     amount: number;
     currency: string;
@@ -98,6 +114,13 @@ export class KuvarPayServer {
 
   // Subscriptions
   createSubscriptionCheckoutSession(subscriptionData: Record<string, any>): Promise<{ sessionId: string; approvalUrl?: string; raw: any }>;
+  createDirectSubscription(data: {
+    amount: number;
+    currency: string;
+    customer: { email: string; firstName?: string; lastName?: string };
+    billingMode?: 'FIXED' | 'METERED';
+    [key: string]: any;
+  }): Promise<{ sessionId: string; approvalUrl?: string; raw: any }>;
   getSubscriptionCheckoutSession(id: string): Promise<any>;
   confirmSubscriptionCheckoutSession(id: string, body?: Record<string, any>): Promise<any>;
 

package/index.js

@@ -221,13 +221,14 @@ class KuvarPayServer {
     const payload = Object.assign({}, checkoutSessionData, {
       businessId: checkoutSessionData.businessId || this.businessId,
     });
-    // payload can include 'subaccount' (string) or 'split_code' (string)
-    // Guide says /api/v1/checkout-sessions
     const data = await this._post('/api/v1/checkout-sessions', payload);
+    const body = data.data || data.checkoutSession || data;
     return {
-      sessionId: data?.sessionId || data?.id || data?.checkoutSession?.id || data?.data?.sessionId,
-      authToken: data?.authToken || data?.data?.authToken,
-      approvalUrl: data?.approvalUrl || data?.approval_url || data?.checkoutSession?.approval_url || data?.data?.approval_url,
+      sessionId: body.sessionId || body.id || body.uid,
+      amount: body.amount,
+      currency: body.currency,
+      authToken: body.authToken,
+      approvalUrl: body.approvalUrl || body.approval_url,
       raw: data,
     };
   }
@@ -251,6 +252,42 @@ class KuvarPayServer {
     return this._post('/api/v1/transactions/create', payload);
   }
 
+  /**
+   * Create a payment session and initiate a transaction in one call (Headless Flow)
+   * @param {Object} data - Combines checkout session and transaction data
+   * @returns {Promise<any>} The created transaction object
+   */
+  async createDirectPayment(data) {
+    // 1. Create Checkout Session
+    const sessionData = {
+      amount: data.amount,
+      currency: data.currency,
+      description: data.description,
+      customerEmail: data.customerEmail,
+      customerName: data.customerName,
+      redirectUrl: data.redirectUrl,
+      callbackUrl: data.callbackUrl,
+      expiresIn: data.expiresIn,
+      metadata: data.metadata,
+      subaccount: data.subaccount,
+      split_code: data.split_code || data.splitCode
+    };
+
+    const session = await this.createCheckoutSession(sessionData);
+
+    // 2. Create Transaction using the session. We omit toAmount/toCurrency 
+    // to let the API use the values already locked into the session.
+    const transactionData = {
+      checkoutSessionId: session.sessionId,
+      fromCurrency: data.fromCurrency,
+      fromNetwork: data.fromNetwork,
+      description: data.description,
+      metadata: data.metadata,
+    };
+
+    return this.createTransaction(transactionData);
+  }
+
   /**
    * Email an invoice to a customer
    */
@@ -429,6 +466,26 @@ class KuvarPayServer {
     return this.createMeteredInvoice(subscriptionId, invoiceData);
   }
 
+  /**
+   * Convenience method to initiate a subscription setup
+   * @param {Object} data - { amount, currency, customer: {email}, billingMode, ... }
+   */
+  async createDirectSubscription(data) {
+    const payload = Object.assign({
+      billingMode: data.billingMode || 'FIXED',
+    }, data);
+
+    // If amount/currency is provided but expectedUsage is not, map it
+    if (data.amount && data.currency && !data.expectedUsage) {
+      payload.expectedUsage = {
+        amount: data.amount,
+        currency: data.currency
+      };
+    }
+
+    return this.createSubscriptionCheckoutSession(payload);
+  }
+
   /**
    * Schedule a subscription invoice (convenience wrapper)
    */

package/index.mjs

@@ -164,12 +164,14 @@ export class KuvarPayServer {
     const payload = Object.assign({}, checkoutSessionData, {
       businessId: checkoutSessionData.businessId || this.businessId,
     });
-    // payload can include 'subaccount' (string) or 'split_code' (string)
     const data = await this._post('/api/v1/checkout-sessions', payload);
+    const body = data.data || data.checkoutSession || data;
     return {
-      sessionId: data?.sessionId || data?.id || data?.checkoutSession?.id || data?.data?.sessionId,
-      authToken: data?.authToken || data?.data?.authToken,
-      approvalUrl: data?.approvalUrl || data?.approval_url || data?.checkoutSession?.approval_url || data?.data?.approval_url,
+      sessionId: body.sessionId || body.id || body.uid,
+      amount: body.amount,
+      currency: body.currency,
+      authToken: body.authToken,
+      approvalUrl: body.approvalUrl || body.approval_url,
       raw: data,
     };
   }
@@ -187,6 +189,34 @@ export class KuvarPayServer {
     return this._post('/api/v1/transactions/create', payload);
   }
 
+  async createDirectPayment(data) {
+    const sessionData = {
+      amount: data.amount,
+      currency: data.currency,
+      description: data.description,
+      customerEmail: data.customerEmail,
+      customerName: data.customerName,
+      redirectUrl: data.redirectUrl,
+      callbackUrl: data.callbackUrl,
+      expiresIn: data.expiresIn,
+      metadata: data.metadata,
+      subaccount: data.subaccount,
+      split_code: data.split_code || data.splitCode
+    };
+
+    const session = await this.createCheckoutSession(sessionData);
+
+    const transactionData = {
+      checkoutSessionId: session.sessionId,
+      fromCurrency: data.fromCurrency,
+      fromNetwork: data.fromNetwork,
+      description: data.description,
+      metadata: data.metadata,
+    };
+
+    return this.createTransaction(transactionData);
+  }
+
   async sendInvoiceEmail(sessionId) {
     return this._post(`/api/v1/invoices/${encodeURIComponent(sessionId)}/send-email`, {});
   }
@@ -296,6 +326,21 @@ export class KuvarPayServer {
     return this.createMeteredInvoice(subscriptionId, invoiceData);
   }
 
+  async createDirectSubscription(data) {
+    const payload = Object.assign({
+      billingMode: data.billingMode || 'FIXED',
+    }, data);
+
+    if (data.amount && data.currency && !data.expectedUsage) {
+      payload.expectedUsage = {
+        amount: data.amount,
+        currency: data.currency
+      };
+    }
+
+    return this.createSubscriptionCheckoutSession(payload);
+  }
+
   async scheduleSubscriptionInvoice(subscriptionId, invoiceData) {
     if (!invoiceData?.dueDate) throw new Error('dueDate is required to schedule an invoice');
     const payload = Object.assign({}, invoiceData, { chargeSchedule: 'SCHEDULED' });

package/package.json

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