@lavapayments/nodejs 2.5.1 → 3.0.0

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-type ApiVersion = "2025-03-27.v1";
+type ApiVersion = "2025-04-21.v1";
 interface Config {
     apiVersion: ApiVersion;
     /**
@@ -21,9 +21,9 @@ declare class Lava {
     private readonly baseUrl;
     private readonly apiVersion;
     /**
-     * The checkout resource
+     * The checkout sessions resource
      */
-    readonly checkout: Resources.CheckoutResource;
+    readonly checkoutSessions: Resources.CheckoutSessionsResource;
     /**
      * The connections resource
      */
@@ -89,76 +89,72 @@ declare class Lava {
     generateForwardToken(options: ForwardTokenOptions): string;
 }
 
-type CheckoutMode = "onboarding" | "topup";
 interface CreateCheckoutSessionParams {
-    checkout_mode: CheckoutMode;
+    checkout_mode: "onboarding" | "topup";
     origin_url: string;
     reference_id?: string;
     connection_id?: string;
 }
-interface CheckoutSession {
+interface CheckoutSessionsListParams {
+    cursor?: string;
+    limit?: number;
+    reference_id?: string;
+}
+interface ConnectionsListParams {
+    cursor?: string;
+    limit?: number;
+    reference_id?: string;
+}
+interface RequestsListParams {
+    cursor?: string;
+    limit?: number;
+    connection_id?: string;
+    product_id?: string;
+    metadata_filters?: Record<string, string>;
+}
+interface RequestsListResponse {
+    data: Request[];
+    has_more: boolean;
+    next_cursor?: string;
+}
+interface UsageParams {
+    start: string;
+    end?: string;
+    connection_id?: string;
+    product_id?: string;
+    metadata_filters?: Record<string, string>;
+}
+interface ListResponse<T> {
+    data: T[];
+    has_more: boolean;
+    next_cursor?: string;
+}
+type RestCheckoutSession = {
     checkout_session_id: string;
     checkout_session_token: string;
-    checkout_mode: CheckoutMode;
+    checkout_mode: "onboarding" | "topup";
     origin_url: string;
     connection_id?: string;
     reference_id?: string;
     created_at: string;
     completed_at?: string;
-}
-interface Wallet {
-    balance: string;
-    phone: string;
-    email: string;
-    first_name: string;
-    last_name: string;
-}
-interface Connection {
+};
+type RestConnection = {
     connection_id: string;
     connection_secret: string;
     reference_id?: string;
-    wallet: Wallet;
+    wallet: {
+        balance: string;
+        phone: string;
+        email: string;
+        first_name: string;
+        last_name: string;
+    };
     next_usage_reset: string;
     previous_usage_reset: string;
     created_at: string;
-}
-interface ConnectionsListParams {
-    cursor?: string;
-    limit?: number;
-    reference_id?: string;
-}
-interface ConnectionsListResponse {
-    data: Connection[];
-    has_more: boolean;
-    next_cursor?: string;
-}
-interface ModelUsage {
-    input_tokens: number;
-    output_tokens: number;
-    total_tokens: number;
-    input_cost: string;
-    output_cost: string;
-    total_cost: string;
-}
-interface FeeTierBreakdown {
-    tier: {
-        start: number;
-        rate: string;
-    };
-    tokens: number;
-    cost: string;
-}
-interface Fee {
-    amount: string;
-    rate_type: "fixed" | "percentage";
-    token_basis: "input+output" | "output";
-    breakdown: FeeTierBreakdown[];
-}
-interface ServiceCharge {
-    amount: string;
-    payer: "wallet" | "merchant";
-}
-interface Request {
+};
+type RestRequest = {
     request_id: string;
     connection_id?: string;
     product_id?: string;
@@ -167,27 +163,40 @@ interface Request {
     model: string;
     endpoint: string;
     response_id?: string;
-    model_usage: ModelUsage;
-    fee: Fee;
-    service_charge: ServiceCharge;
+    model_usage: {
+        input_tokens: number;
+        output_tokens: number;
+        total_tokens: number;
+        input_cost: string;
+        output_cost: string;
+        total_cost: string;
+        payer: "wallet" | "merchant";
+    };
+    fee: {
+        amount: string;
+        rate_type: "fixed" | "percentage";
+        token_basis: "input+output" | "output";
+        breakdown: {
+            tier: {
+                start: number;
+                rate: string;
+            };
+            tokens: number;
+            cost: string;
+        }[];
+    };
+    service_charge: {
+        amount: string;
+        payer: "wallet" | "merchant";
+    };
     total_request_cost: string;
+    total_wallet_cost: string;
+    total_merchant_cost: string;
     metadata: Record<string, string>;
     timestamp: string;
     created_at: string;
-}
-interface RequestsListParams {
-    cursor?: string;
-    limit?: number;
-    connection_id?: string;
-    product_id?: string;
-    metadata_filters?: Record<string, string>;
-}
-interface RequestsListResponse {
-    data: Request[];
-    has_more: boolean;
-    next_cursor?: string;
-}
-interface UsageData {
+};
+type RestUsage = {
     items: {
         date: string;
         total_requests: number;
@@ -196,6 +205,8 @@ interface UsageData {
         total_fee_amount: string;
         total_service_charge_amount: string;
         total_request_cost: string;
+        total_wallet_cost: string;
+        total_merchant_cost: string;
     }[];
     totals: {
         total_requests: number;
@@ -204,16 +215,10 @@ interface UsageData {
         total_fee_amount: string;
         total_service_charge_amount: string;
         total_request_cost: string;
+        total_wallet_cost: string;
+        total_merchant_cost: string;
     };
-}
-interface UsageParams {
-    start: string;
-    end?: string;
-    connection_id?: string;
-    product_id?: string;
-    metadata_filters?: Record<string, string>;
-}
-type Usage = UsageData[];
+};
 
 declare namespace Resources {
     abstract class BaseResource {
@@ -223,19 +228,25 @@ declare namespace Resources {
     /**
      * Checkout session related endpoints
      */
-    export class CheckoutResource extends BaseResource {
+    export class CheckoutSessionsResource extends BaseResource {
         /**
          * Create a checkout session
          * @param params Checkout session parameters
          * @returns Created checkout session
          */
-        create(params: CreateCheckoutSessionParams): Promise<CheckoutSession>;
+        create(params: CreateCheckoutSessionParams): Promise<RestCheckoutSession>;
+        /**
+         * List checkout sessions
+         * @param params List parameters
+         * @returns Paginated list of checkout sessions
+         */
+        list(params?: CheckoutSessionsListParams): Promise<ListResponse<RestCheckoutSession>>;
         /**
          * Retrieve a checkout session
          * @param checkoutSessionId Checkout session ID
          * @returns Checkout session details
          */
-        retrieve(checkoutSessionId: string): Promise<CheckoutSession>;
+        retrieve(checkoutSessionId: string): Promise<RestCheckoutSession>;
     }
     /**
      * Connection related endpoints
@@ -246,13 +257,13 @@ declare namespace Resources {
          * @param params List parameters
          * @returns Paginated list of connections
          */
-        list(params?: ConnectionsListParams): Promise<ConnectionsListResponse>;
+        list(params?: ConnectionsListParams): Promise<ListResponse<RestConnection>>;
         /**
          * Retrieve a connection
          * @param connectionId Connection ID
          * @returns Connection details
          */
-        retrieve(connectionId: string): Promise<Connection>;
+        retrieve(connectionId: string): Promise<RestConnection>;
         /**
          * Delete a connection
          * @param connectionId Connection ID
@@ -271,13 +282,13 @@ declare namespace Resources {
          * @param params List parameters
          * @returns Paginated list of requests
          */
-        list(params?: RequestsListParams): Promise<RequestsListResponse>;
+        list(params?: RequestsListParams): Promise<ListResponse<RestRequest>>;
         /**
          * Retrieve a request
          * @param requestId Request ID
          * @returns Request details
          */
-        retrieve(requestId: string): Promise<Request>;
+        retrieve(requestId: string): Promise<RestRequest>;
     }
     /**
      * Usage related endpoints
@@ -288,9 +299,9 @@ declare namespace Resources {
          * @param params Usage parameters
          * @returns Usage data
          */
-        retrieve(params: UsageParams): Promise<Usage>;
+        retrieve(params: UsageParams): Promise<RestUsage>;
     }
     export {  };
 }
 
-export { type ApiVersion, type CheckoutMode, type CheckoutSession, type Config, type Connection, type ConnectionsListParams, type ConnectionsListResponse, type CreateCheckoutSessionParams, type Fee, type FeeTierBreakdown, type ForwardTokenOptions, Lava, type ModelUsage, type Request, type RequestsListParams, type RequestsListResponse, Resources, type ServiceCharge, type Usage, type UsageData, type UsageParams, type Wallet };
+export { type ApiVersion, type CheckoutSessionsListParams, type Config, type ConnectionsListParams, type CreateCheckoutSessionParams, type ForwardTokenOptions, Lava, type ListResponse, type RequestsListParams, type RequestsListResponse, Resources, type RestCheckoutSession, type RestConnection, type RestRequest, type RestUsage, type UsageParams };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-type ApiVersion = "2025-03-27.v1";
+type ApiVersion = "2025-04-21.v1";
 interface Config {
     apiVersion: ApiVersion;
     /**
@@ -21,9 +21,9 @@ declare class Lava {
     private readonly baseUrl;
     private readonly apiVersion;
     /**
-     * The checkout resource
+     * The checkout sessions resource
      */
-    readonly checkout: Resources.CheckoutResource;
+    readonly checkoutSessions: Resources.CheckoutSessionsResource;
     /**
      * The connections resource
      */
@@ -89,76 +89,72 @@ declare class Lava {
     generateForwardToken(options: ForwardTokenOptions): string;
 }
 
-type CheckoutMode = "onboarding" | "topup";
 interface CreateCheckoutSessionParams {
-    checkout_mode: CheckoutMode;
+    checkout_mode: "onboarding" | "topup";
     origin_url: string;
     reference_id?: string;
     connection_id?: string;
 }
-interface CheckoutSession {
+interface CheckoutSessionsListParams {
+    cursor?: string;
+    limit?: number;
+    reference_id?: string;
+}
+interface ConnectionsListParams {
+    cursor?: string;
+    limit?: number;
+    reference_id?: string;
+}
+interface RequestsListParams {
+    cursor?: string;
+    limit?: number;
+    connection_id?: string;
+    product_id?: string;
+    metadata_filters?: Record<string, string>;
+}
+interface RequestsListResponse {
+    data: Request[];
+    has_more: boolean;
+    next_cursor?: string;
+}
+interface UsageParams {
+    start: string;
+    end?: string;
+    connection_id?: string;
+    product_id?: string;
+    metadata_filters?: Record<string, string>;
+}
+interface ListResponse<T> {
+    data: T[];
+    has_more: boolean;
+    next_cursor?: string;
+}
+type RestCheckoutSession = {
     checkout_session_id: string;
     checkout_session_token: string;
-    checkout_mode: CheckoutMode;
+    checkout_mode: "onboarding" | "topup";
     origin_url: string;
     connection_id?: string;
     reference_id?: string;
     created_at: string;
     completed_at?: string;
-}
-interface Wallet {
-    balance: string;
-    phone: string;
-    email: string;
-    first_name: string;
-    last_name: string;
-}
-interface Connection {
+};
+type RestConnection = {
     connection_id: string;
     connection_secret: string;
     reference_id?: string;
-    wallet: Wallet;
+    wallet: {
+        balance: string;
+        phone: string;
+        email: string;
+        first_name: string;
+        last_name: string;
+    };
     next_usage_reset: string;
     previous_usage_reset: string;
     created_at: string;
-}
-interface ConnectionsListParams {
-    cursor?: string;
-    limit?: number;
-    reference_id?: string;
-}
-interface ConnectionsListResponse {
-    data: Connection[];
-    has_more: boolean;
-    next_cursor?: string;
-}
-interface ModelUsage {
-    input_tokens: number;
-    output_tokens: number;
-    total_tokens: number;
-    input_cost: string;
-    output_cost: string;
-    total_cost: string;
-}
-interface FeeTierBreakdown {
-    tier: {
-        start: number;
-        rate: string;
-    };
-    tokens: number;
-    cost: string;
-}
-interface Fee {
-    amount: string;
-    rate_type: "fixed" | "percentage";
-    token_basis: "input+output" | "output";
-    breakdown: FeeTierBreakdown[];
-}
-interface ServiceCharge {
-    amount: string;
-    payer: "wallet" | "merchant";
-}
-interface Request {
+};
+type RestRequest = {
     request_id: string;
     connection_id?: string;
     product_id?: string;
@@ -167,27 +163,40 @@ interface Request {
     model: string;
     endpoint: string;
     response_id?: string;
-    model_usage: ModelUsage;
-    fee: Fee;
-    service_charge: ServiceCharge;
+    model_usage: {
+        input_tokens: number;
+        output_tokens: number;
+        total_tokens: number;
+        input_cost: string;
+        output_cost: string;
+        total_cost: string;
+        payer: "wallet" | "merchant";
+    };
+    fee: {
+        amount: string;
+        rate_type: "fixed" | "percentage";
+        token_basis: "input+output" | "output";
+        breakdown: {
+            tier: {
+                start: number;
+                rate: string;
+            };
+            tokens: number;
+            cost: string;
+        }[];
+    };
+    service_charge: {
+        amount: string;
+        payer: "wallet" | "merchant";
+    };
     total_request_cost: string;
+    total_wallet_cost: string;
+    total_merchant_cost: string;
     metadata: Record<string, string>;
     timestamp: string;
     created_at: string;
-}
-interface RequestsListParams {
-    cursor?: string;
-    limit?: number;
-    connection_id?: string;
-    product_id?: string;
-    metadata_filters?: Record<string, string>;
-}
-interface RequestsListResponse {
-    data: Request[];
-    has_more: boolean;
-    next_cursor?: string;
-}
-interface UsageData {
+};
+type RestUsage = {
     items: {
         date: string;
         total_requests: number;
@@ -196,6 +205,8 @@ interface UsageData {
         total_fee_amount: string;
         total_service_charge_amount: string;
         total_request_cost: string;
+        total_wallet_cost: string;
+        total_merchant_cost: string;
     }[];
     totals: {
         total_requests: number;
@@ -204,16 +215,10 @@ interface UsageData {
         total_fee_amount: string;
         total_service_charge_amount: string;
         total_request_cost: string;
+        total_wallet_cost: string;
+        total_merchant_cost: string;
     };
-}
-interface UsageParams {
-    start: string;
-    end?: string;
-    connection_id?: string;
-    product_id?: string;
-    metadata_filters?: Record<string, string>;
-}
-type Usage = UsageData[];
+};
 
 declare namespace Resources {
     abstract class BaseResource {
@@ -223,19 +228,25 @@ declare namespace Resources {
     /**
      * Checkout session related endpoints
      */
-    export class CheckoutResource extends BaseResource {
+    export class CheckoutSessionsResource extends BaseResource {
         /**
          * Create a checkout session
          * @param params Checkout session parameters
          * @returns Created checkout session
          */
-        create(params: CreateCheckoutSessionParams): Promise<CheckoutSession>;
+        create(params: CreateCheckoutSessionParams): Promise<RestCheckoutSession>;
+        /**
+         * List checkout sessions
+         * @param params List parameters
+         * @returns Paginated list of checkout sessions
+         */
+        list(params?: CheckoutSessionsListParams): Promise<ListResponse<RestCheckoutSession>>;
         /**
          * Retrieve a checkout session
          * @param checkoutSessionId Checkout session ID
          * @returns Checkout session details
          */
-        retrieve(checkoutSessionId: string): Promise<CheckoutSession>;
+        retrieve(checkoutSessionId: string): Promise<RestCheckoutSession>;
     }
     /**
      * Connection related endpoints
@@ -246,13 +257,13 @@ declare namespace Resources {
          * @param params List parameters
          * @returns Paginated list of connections
          */
-        list(params?: ConnectionsListParams): Promise<ConnectionsListResponse>;
+        list(params?: ConnectionsListParams): Promise<ListResponse<RestConnection>>;
         /**
          * Retrieve a connection
          * @param connectionId Connection ID
          * @returns Connection details
          */
-        retrieve(connectionId: string): Promise<Connection>;
+        retrieve(connectionId: string): Promise<RestConnection>;
         /**
          * Delete a connection
          * @param connectionId Connection ID
@@ -271,13 +282,13 @@ declare namespace Resources {
          * @param params List parameters
          * @returns Paginated list of requests
          */
-        list(params?: RequestsListParams): Promise<RequestsListResponse>;
+        list(params?: RequestsListParams): Promise<ListResponse<RestRequest>>;
         /**
          * Retrieve a request
          * @param requestId Request ID
          * @returns Request details
          */
-        retrieve(requestId: string): Promise<Request>;
+        retrieve(requestId: string): Promise<RestRequest>;
     }
     /**
      * Usage related endpoints
@@ -288,9 +299,9 @@ declare namespace Resources {
          * @param params Usage parameters
          * @returns Usage data
          */
-        retrieve(params: UsageParams): Promise<Usage>;
+        retrieve(params: UsageParams): Promise<RestUsage>;
     }
     export {  };
 }
 
-export { type ApiVersion, type CheckoutMode, type CheckoutSession, type Config, type Connection, type ConnectionsListParams, type ConnectionsListResponse, type CreateCheckoutSessionParams, type Fee, type FeeTierBreakdown, type ForwardTokenOptions, Lava, type ModelUsage, type Request, type RequestsListParams, type RequestsListResponse, Resources, type ServiceCharge, type Usage, type UsageData, type UsageParams, type Wallet };
+export { type ApiVersion, type CheckoutSessionsListParams, type Config, type ConnectionsListParams, type CreateCheckoutSessionParams, type ForwardTokenOptions, Lava, type ListResponse, type RequestsListParams, type RequestsListResponse, Resources, type RestCheckoutSession, type RestConnection, type RestRequest, type RestUsage, type UsageParams };

package/dist/index.js

@@ -33,16 +33,40 @@ var Resources;
       this.lava = lava;
     }
   }
-  class CheckoutResource extends BaseResource {
+  class CheckoutSessionsResource extends BaseResource {
     /**
      * Create a checkout session
      * @param params Checkout session parameters
      * @returns Created checkout session
      */
     async create(params) {
-      return this.lava.request("POST", "checkout_sessions", {
-        data: params
-      });
+      return this.lava.request(
+        "POST",
+        "checkout_sessions",
+        {
+          data: params
+        }
+      );
+    }
+    /**
+     * List checkout sessions
+     * @param params List parameters
+     * @returns Paginated list of checkout sessions
+     */
+    async list(params) {
+      const queryParams = {};
+      if (params) {
+        if (params.cursor) queryParams.cursor = params.cursor;
+        if (params.limit) queryParams.limit = params.limit.toString();
+        if (params.reference_id) queryParams.reference_id = params.reference_id;
+      }
+      return this.lava.request(
+        "GET",
+        "checkout_sessions",
+        {
+          query: queryParams
+        }
+      );
     }
     /**
      * Retrieve a checkout session
@@ -56,7 +80,7 @@ var Resources;
       );
     }
   }
-  Resources2.CheckoutResource = CheckoutResource;
+  Resources2.CheckoutSessionsResource = CheckoutSessionsResource;
   class ConnectionsResource extends BaseResource {
     /**
      * List connections
@@ -70,9 +94,13 @@ var Resources;
         if (params.limit) queryParams.limit = params.limit.toString();
         if (params.reference_id) queryParams.reference_id = params.reference_id;
       }
-      return this.lava.request("GET", "connections", {
-        query: queryParams
-      });
+      return this.lava.request(
+        "GET",
+        "connections",
+        {
+          query: queryParams
+        }
+      );
     }
     /**
      * Retrieve a connection
@@ -169,7 +197,7 @@ var Lava = class {
     this.apiVersion = config.apiVersion;
     const isTestMode = secretKey.startsWith("aks_test_");
     this.baseUrl = config.baseUrl || (isTestMode ? "https://sandbox-api.lavapayments.com/v1/" : "https://api.lavapayments.com/v1/");
-    this.checkout = new Resources.CheckoutResource(this);
+    this.checkoutSessions = new Resources.CheckoutSessionsResource(this);
     this.connections = new Resources.ConnectionsResource(this);
     this.requests = new Resources.RequestsResource(this);
     this.usage = new Resources.UsageResource(this);

package/dist/index.mjs

@@ -6,16 +6,40 @@ var Resources;
       this.lava = lava;
     }
   }
-  class CheckoutResource extends BaseResource {
+  class CheckoutSessionsResource extends BaseResource {
     /**
      * Create a checkout session
      * @param params Checkout session parameters
      * @returns Created checkout session
      */
     async create(params) {
-      return this.lava.request("POST", "checkout_sessions", {
-        data: params
-      });
+      return this.lava.request(
+        "POST",
+        "checkout_sessions",
+        {
+          data: params
+        }
+      );
+    }
+    /**
+     * List checkout sessions
+     * @param params List parameters
+     * @returns Paginated list of checkout sessions
+     */
+    async list(params) {
+      const queryParams = {};
+      if (params) {
+        if (params.cursor) queryParams.cursor = params.cursor;
+        if (params.limit) queryParams.limit = params.limit.toString();
+        if (params.reference_id) queryParams.reference_id = params.reference_id;
+      }
+      return this.lava.request(
+        "GET",
+        "checkout_sessions",
+        {
+          query: queryParams
+        }
+      );
     }
     /**
      * Retrieve a checkout session
@@ -29,7 +53,7 @@ var Resources;
       );
     }
   }
-  Resources2.CheckoutResource = CheckoutResource;
+  Resources2.CheckoutSessionsResource = CheckoutSessionsResource;
   class ConnectionsResource extends BaseResource {
     /**
      * List connections
@@ -43,9 +67,13 @@ var Resources;
         if (params.limit) queryParams.limit = params.limit.toString();
         if (params.reference_id) queryParams.reference_id = params.reference_id;
       }
-      return this.lava.request("GET", "connections", {
-        query: queryParams
-      });
+      return this.lava.request(
+        "GET",
+        "connections",
+        {
+          query: queryParams
+        }
+      );
     }
     /**
      * Retrieve a connection
@@ -142,7 +170,7 @@ var Lava = class {
     this.apiVersion = config.apiVersion;
     const isTestMode = secretKey.startsWith("aks_test_");
     this.baseUrl = config.baseUrl || (isTestMode ? "https://sandbox-api.lavapayments.com/v1/" : "https://api.lavapayments.com/v1/");
-    this.checkout = new Resources.CheckoutResource(this);
+    this.checkoutSessions = new Resources.CheckoutSessionsResource(this);
     this.connections = new Resources.ConnectionsResource(this);
     this.requests = new Resources.RequestsResource(this);
     this.usage = new Resources.UsageResource(this);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lavapayments/nodejs",
-  "version": "2.5.1",
+  "version": "3.0.0",
   "description": "Backend SDK for Lava Payments API - enabling usage-based billing for AI services",
   "main": "dist/index.js",
   "module": "dist/index.mjs",