@kuvarpay/sdk 1.1.0 → 1.2.1

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

@@ -10,10 +10,10 @@
 
 const crypto = require('crypto');
 
-const DEFAULT_BASE = (process.env.PAYMENT_API_BASE_URL
-  || process.env.PAYMENT_SERVER_URL
-  || process.env.NEXT_PUBLIC_PAYMENT_API_BASE_URL
-  || 'http://localhost:3002').replace(/\/+$/, '');
+const DEFAULT_BASE = (process.env.KUVARPAY_API_BASE_URL
+  || process.env.PAYMENT_API_BASE_URL
+  || 'https://payment.kuvarpay.com'
+).replace(/\/$/, '');
 
 class KuvarPayServer {
   /**
@@ -251,6 +251,45 @@ 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 new Session ID
+    const transactionData = {
+      checkoutSessionId: session.sessionId,
+      fromCurrency: data.fromCurrency,
+      fromNetwork: data.fromNetwork,
+      toCurrency: data.toCurrency || data.currency,
+      toAmount: data.toAmount || data.amount,
+      subaccountCode: data.subaccountCode || data.subaccount,
+      splitCode: data.splitCode || data.split_code,
+      description: data.description,
+      metadata: data.metadata,
+    };
+
+    return this.createTransaction(transactionData);
+  }
+
   /**
    * Email an invoice to a customer
    */
@@ -429,6 +468,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

@@ -8,10 +8,10 @@
 
 import crypto from 'node:crypto';
 
-const DEFAULT_BASE = (process.env.PAYMENT_API_BASE_URL
-  || process.env.PAYMENT_SERVER_URL
-  || process.env.NEXT_PUBLIC_PAYMENT_API_BASE_URL
-  || 'http://localhost:3002').replace(/\/+$/, '');
+const DEFAULT_BASE = (process.env.KUVARPAY_API_BASE_URL
+  || process.env.PAYMENT_API_BASE_URL
+  || 'https://payment.kuvarpay.com'
+).replace(/\/$/, '');
 
 export class KuvarPayServer {
   /**
@@ -187,6 +187,38 @@ 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,
+      toCurrency: data.toCurrency || data.currency,
+      toAmount: data.toAmount || data.amount,
+      subaccountCode: data.subaccountCode || data.subaccount,
+      splitCode: data.splitCode || data.split_code,
+      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 +328,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.1.0",
+  "version": "1.2.1",
   "description": "Official KuvarPay Server SDK for Node.js",
   "main": "index.js",
   "module": "index.mjs",