@lavapayments/nodejs 5.3.2 → 6.1.0

package/README.md

@@ -114,4 +114,4 @@ const url = `${lava.baseUrl}forward?u=https://api.yourprovider.com/endpoint`;
 
 ## Related Documentation
 
-For complete documentation on Lava's usage-based billing system and backend integration, visit [lavapayments.com](https://www.lavapayments.com).
+For complete documentation on Lava's usage-based billing system and backend integration, visit [www.lava.so](https://www.lava.so).

package/dist/index.d.mts

@@ -1,8 +1,10 @@
 interface CreateCheckoutSessionParams {
-    checkout_mode: 'onboarding' | 'topup';
+    checkout_mode: 'onboarding' | 'topup' | 'subscription' | 'credit_bundle';
     origin_url: string;
     reference_id?: string;
     connection_id?: string;
+    subscription_config_id?: string;
+    credit_bundle_id?: string;
 }
 interface CheckoutSessionsListParams {
     cursor?: string;
@@ -50,13 +52,24 @@ interface ListResponse<T> {
     has_more: boolean;
     next_cursor?: string;
 }
+interface CreateSubscriptionConfigParams {
+    name: string;
+    period_amount: string;
+    rollover_type: 'full' | 'none';
+}
+interface UpdateSubscriptionConfigParams {
+    name?: string;
+    period_amount?: string;
+    rollover_type?: 'full' | 'none';
+}
 type RestCheckoutSession = {
     checkout_session_id: string;
     checkout_session_token: string;
-    checkout_mode: 'onboarding' | 'topup';
+    checkout_mode: 'onboarding' | 'topup' | 'subscription' | 'credit_bundle';
     origin_url: string;
     connection_id?: string;
     reference_id?: string;
+    subscription_config_id?: string;
     created_at: string;
     completed_at?: string;
 };
@@ -76,6 +89,37 @@ type RestConnection = {
     previous_usage_reset: string;
     created_at: string;
 };
+type RestConnectionSubscriptionCredits = {
+    total_remaining: string;
+    cycle_remaining: string;
+    bundle_remaining: string;
+    cycle_rollover: 'full' | 'none';
+    bundle_rollover: 'full' | 'none';
+};
+type RestConnectionSubscriptionPendingChange = {
+    type: 'cancellation' | 'downgrade';
+    effective_at: string | null;
+    subscription_config_id?: string;
+    name?: string;
+    period_amount?: string;
+    included_credit?: string;
+};
+type RestConnectionSubscriptionDetails = {
+    active_subscription_id: string;
+    subscription_config_id: string;
+    name: string;
+    status: 'active' | 'cancelled';
+    billing_interval: 'month' | 'year';
+    period_amount: string;
+    included_credit: string;
+    cycle_start_at: string | null;
+    cycle_end_at: string | null;
+    credits: RestConnectionSubscriptionCredits;
+    pending_change: RestConnectionSubscriptionPendingChange | null;
+};
+type RestConnectionSubscription = {
+    subscription: RestConnectionSubscriptionDetails | null;
+};
 type RestRequest = {
     request_id: string;
     status: 'pending' | 'completed' | 'error';
@@ -141,6 +185,8 @@ type RestUsage = {
         total_request_cost: string;
         total_wallet_cost: string;
         total_merchant_cost: string;
+        total_gross_volume: string;
+        total_net_volume: string;
     }[];
     totals: {
         total_requests: number;
@@ -151,10 +197,42 @@ type RestUsage = {
         total_request_cost: string;
         total_wallet_cost: string;
         total_merchant_cost: string;
+        total_gross_volume: string;
+        total_net_volume: string;
+    };
+};
+type RestSubscriptionConfig = {
+    subscription_config_id: string;
+    merchant_id: string;
+    name: string;
+    period_amount: string;
+    rollover_type: 'full' | 'none';
+    bundle_rollover_type: 'full' | 'none';
+    created_at: string;
+};
+type RestActiveSubscription = {
+    active_subscription_id: string;
+    wallet_id: string;
+    subscription_config_id: string;
+    started_at: string;
+    billing_anchor: number;
+    cancelled_at?: string;
+    scheduled_cancellation_at: string | null;
+    status: 'active' | 'cancelled';
+    created_at: string;
+    subscription_config: RestSubscriptionConfig;
+    wallet: {
+        wallet_id: string;
+        phone: string;
+        email?: string;
+        first_name?: string;
+        last_name?: string;
+        active_balance: string;
+        created_at: string;
     };
 };
 
-/** biome-ignore-all lint/style/noNamespace: <explanation> */
+/** biome-ignore-all lint/style/noNamespace: package uses namespace */
 
 declare namespace Resources {
     abstract class BaseResource {
@@ -200,6 +278,13 @@ declare namespace Resources {
          * @returns Connection details
          */
         retrieve(connectionId: string): Promise<RestConnection>;
+        /**
+         * Get subscription details for a connection.
+         * Returns plan info, current cycle credits, and any pending changes (cancellation or downgrade).
+         * @param connectionId Connection ID
+         * @returns Subscription details or null if no active subscription
+         */
+        getSubscription(connectionId: string): Promise<RestConnectionSubscription>;
         /**
          * Delete a connection
          * @param connectionId Connection ID
@@ -243,6 +328,47 @@ declare namespace Resources {
          */
         retrieve(params: UsageParams): Promise<RestUsage>;
     }
+    export class SubscriptionsResource extends BaseResource {
+        /**
+         * List subscription configurations
+         * @returns List of subscription configurations
+         */
+        listConfigs(): Promise<RestSubscriptionConfig[]>;
+        /**
+         * Create a subscription configuration
+         * @param params Subscription configuration parameters
+         * @returns Created subscription configuration
+         */
+        createConfig(params: CreateSubscriptionConfigParams): Promise<RestSubscriptionConfig>;
+        /**
+         * Update a subscription configuration
+         * @param id Subscription configuration ID
+         * @param params Update parameters
+         * @returns Updated subscription configuration
+         */
+        updateConfig(id: string, params: UpdateSubscriptionConfigParams): Promise<RestSubscriptionConfig>;
+        /**
+         * Delete a subscription configuration
+         * @param id Subscription configuration ID
+         * @returns Success response
+         */
+        deleteConfig(id: string): Promise<{
+            success: boolean;
+        }>;
+        /**
+         * List active subscriptions for a merchant
+         * @returns List of active subscriptions
+         */
+        listActiveSubscriptions(): Promise<RestActiveSubscription[]>;
+        /**
+         * Cancel an active subscription
+         * @param id Active subscription ID
+         * @returns Success response
+         */
+        cancelActiveSubscription(id: string): Promise<{
+            success: boolean;
+        }>;
+    }
     export {  };
 }
 
@@ -284,6 +410,10 @@ declare class Lava {
      * The usage resource
      */
     readonly usage: Resources.UsageResource;
+    /**
+     * The subscriptions resource
+     */
+    readonly subscriptions: Resources.SubscriptionsResource;
     /**
      * Provider URLs for convenience
      */
@@ -314,6 +444,7 @@ declare class Lava {
         gmicloud: string;
         chutes: string;
         baseten: string;
+        moonshot: string;
     };
     /**
      * Create a new Lava client
@@ -329,7 +460,7 @@ declare class Lava {
      * @returns Response data
      */
     request<T>(method: string, path: string, { data, query }?: {
-        data?: any;
+        data?: unknown;
         query?: Record<string, string>;
     }): Promise<T>;
     /**
@@ -340,4 +471,4 @@ declare class Lava {
     generateForwardToken(options: ForwardTokenOptions): string;
 }
 
-export { type ApiVersion, type CheckoutSessionsListParams, type Config, type ConnectionsListParams, type CreateCheckoutSessionParams, type CreateRequestParams, type ForwardTokenOptions, Lava, type ListResponse, type RequestsListParams, type RequestsListResponse, Resources, type RestCheckoutSession, type RestConnection, type RestRequest, type RestUsage, type UsageParams };
+export { type ApiVersion, type CheckoutSessionsListParams, type Config, type ConnectionsListParams, type CreateCheckoutSessionParams, type CreateRequestParams, type CreateSubscriptionConfigParams, type ForwardTokenOptions, Lava, type ListResponse, type RequestsListParams, type RequestsListResponse, Resources, type RestActiveSubscription, type RestCheckoutSession, type RestConnection, type RestConnectionSubscription, type RestConnectionSubscriptionCredits, type RestConnectionSubscriptionDetails, type RestConnectionSubscriptionPendingChange, type RestRequest, type RestSubscriptionConfig, type RestUsage, type UpdateSubscriptionConfigParams, type UsageParams };

package/dist/index.d.ts

@@ -1,8 +1,10 @@
 interface CreateCheckoutSessionParams {
-    checkout_mode: 'onboarding' | 'topup';
+    checkout_mode: 'onboarding' | 'topup' | 'subscription' | 'credit_bundle';
     origin_url: string;
     reference_id?: string;
     connection_id?: string;
+    subscription_config_id?: string;
+    credit_bundle_id?: string;
 }
 interface CheckoutSessionsListParams {
     cursor?: string;
@@ -50,13 +52,24 @@ interface ListResponse<T> {
     has_more: boolean;
     next_cursor?: string;
 }
+interface CreateSubscriptionConfigParams {
+    name: string;
+    period_amount: string;
+    rollover_type: 'full' | 'none';
+}
+interface UpdateSubscriptionConfigParams {
+    name?: string;
+    period_amount?: string;
+    rollover_type?: 'full' | 'none';
+}
 type RestCheckoutSession = {
     checkout_session_id: string;
     checkout_session_token: string;
-    checkout_mode: 'onboarding' | 'topup';
+    checkout_mode: 'onboarding' | 'topup' | 'subscription' | 'credit_bundle';
     origin_url: string;
     connection_id?: string;
     reference_id?: string;
+    subscription_config_id?: string;
     created_at: string;
     completed_at?: string;
 };
@@ -76,6 +89,37 @@ type RestConnection = {
     previous_usage_reset: string;
     created_at: string;
 };
+type RestConnectionSubscriptionCredits = {
+    total_remaining: string;
+    cycle_remaining: string;
+    bundle_remaining: string;
+    cycle_rollover: 'full' | 'none';
+    bundle_rollover: 'full' | 'none';
+};
+type RestConnectionSubscriptionPendingChange = {
+    type: 'cancellation' | 'downgrade';
+    effective_at: string | null;
+    subscription_config_id?: string;
+    name?: string;
+    period_amount?: string;
+    included_credit?: string;
+};
+type RestConnectionSubscriptionDetails = {
+    active_subscription_id: string;
+    subscription_config_id: string;
+    name: string;
+    status: 'active' | 'cancelled';
+    billing_interval: 'month' | 'year';
+    period_amount: string;
+    included_credit: string;
+    cycle_start_at: string | null;
+    cycle_end_at: string | null;
+    credits: RestConnectionSubscriptionCredits;
+    pending_change: RestConnectionSubscriptionPendingChange | null;
+};
+type RestConnectionSubscription = {
+    subscription: RestConnectionSubscriptionDetails | null;
+};
 type RestRequest = {
     request_id: string;
     status: 'pending' | 'completed' | 'error';
@@ -141,6 +185,8 @@ type RestUsage = {
         total_request_cost: string;
         total_wallet_cost: string;
         total_merchant_cost: string;
+        total_gross_volume: string;
+        total_net_volume: string;
     }[];
     totals: {
         total_requests: number;
@@ -151,10 +197,42 @@ type RestUsage = {
         total_request_cost: string;
         total_wallet_cost: string;
         total_merchant_cost: string;
+        total_gross_volume: string;
+        total_net_volume: string;
+    };
+};
+type RestSubscriptionConfig = {
+    subscription_config_id: string;
+    merchant_id: string;
+    name: string;
+    period_amount: string;
+    rollover_type: 'full' | 'none';
+    bundle_rollover_type: 'full' | 'none';
+    created_at: string;
+};
+type RestActiveSubscription = {
+    active_subscription_id: string;
+    wallet_id: string;
+    subscription_config_id: string;
+    started_at: string;
+    billing_anchor: number;
+    cancelled_at?: string;
+    scheduled_cancellation_at: string | null;
+    status: 'active' | 'cancelled';
+    created_at: string;
+    subscription_config: RestSubscriptionConfig;
+    wallet: {
+        wallet_id: string;
+        phone: string;
+        email?: string;
+        first_name?: string;
+        last_name?: string;
+        active_balance: string;
+        created_at: string;
     };
 };
 
-/** biome-ignore-all lint/style/noNamespace: <explanation> */
+/** biome-ignore-all lint/style/noNamespace: package uses namespace */
 
 declare namespace Resources {
     abstract class BaseResource {
@@ -200,6 +278,13 @@ declare namespace Resources {
          * @returns Connection details
          */
         retrieve(connectionId: string): Promise<RestConnection>;
+        /**
+         * Get subscription details for a connection.
+         * Returns plan info, current cycle credits, and any pending changes (cancellation or downgrade).
+         * @param connectionId Connection ID
+         * @returns Subscription details or null if no active subscription
+         */
+        getSubscription(connectionId: string): Promise<RestConnectionSubscription>;
         /**
          * Delete a connection
          * @param connectionId Connection ID
@@ -243,6 +328,47 @@ declare namespace Resources {
          */
         retrieve(params: UsageParams): Promise<RestUsage>;
     }
+    export class SubscriptionsResource extends BaseResource {
+        /**
+         * List subscription configurations
+         * @returns List of subscription configurations
+         */
+        listConfigs(): Promise<RestSubscriptionConfig[]>;
+        /**
+         * Create a subscription configuration
+         * @param params Subscription configuration parameters
+         * @returns Created subscription configuration
+         */
+        createConfig(params: CreateSubscriptionConfigParams): Promise<RestSubscriptionConfig>;
+        /**
+         * Update a subscription configuration
+         * @param id Subscription configuration ID
+         * @param params Update parameters
+         * @returns Updated subscription configuration
+         */
+        updateConfig(id: string, params: UpdateSubscriptionConfigParams): Promise<RestSubscriptionConfig>;
+        /**
+         * Delete a subscription configuration
+         * @param id Subscription configuration ID
+         * @returns Success response
+         */
+        deleteConfig(id: string): Promise<{
+            success: boolean;
+        }>;
+        /**
+         * List active subscriptions for a merchant
+         * @returns List of active subscriptions
+         */
+        listActiveSubscriptions(): Promise<RestActiveSubscription[]>;
+        /**
+         * Cancel an active subscription
+         * @param id Active subscription ID
+         * @returns Success response
+         */
+        cancelActiveSubscription(id: string): Promise<{
+            success: boolean;
+        }>;
+    }
     export {  };
 }
 
@@ -284,6 +410,10 @@ declare class Lava {
      * The usage resource
      */
     readonly usage: Resources.UsageResource;
+    /**
+     * The subscriptions resource
+     */
+    readonly subscriptions: Resources.SubscriptionsResource;
     /**
      * Provider URLs for convenience
      */
@@ -314,6 +444,7 @@ declare class Lava {
         gmicloud: string;
         chutes: string;
         baseten: string;
+        moonshot: string;
     };
     /**
      * Create a new Lava client
@@ -329,7 +460,7 @@ declare class Lava {
      * @returns Response data
      */
     request<T>(method: string, path: string, { data, query }?: {
-        data?: any;
+        data?: unknown;
         query?: Record<string, string>;
     }): Promise<T>;
     /**
@@ -340,4 +471,4 @@ declare class Lava {
     generateForwardToken(options: ForwardTokenOptions): string;
 }
 
-export { type ApiVersion, type CheckoutSessionsListParams, type Config, type ConnectionsListParams, type CreateCheckoutSessionParams, type CreateRequestParams, type ForwardTokenOptions, Lava, type ListResponse, type RequestsListParams, type RequestsListResponse, Resources, type RestCheckoutSession, type RestConnection, type RestRequest, type RestUsage, type UsageParams };
+export { type ApiVersion, type CheckoutSessionsListParams, type Config, type ConnectionsListParams, type CreateCheckoutSessionParams, type CreateRequestParams, type CreateSubscriptionConfigParams, type ForwardTokenOptions, Lava, type ListResponse, type RequestsListParams, type RequestsListResponse, Resources, type RestActiveSubscription, type RestCheckoutSession, type RestConnection, type RestConnectionSubscription, type RestConnectionSubscriptionCredits, type RestConnectionSubscriptionDetails, type RestConnectionSubscriptionPendingChange, type RestRequest, type RestSubscriptionConfig, type RestUsage, type UpdateSubscriptionConfigParams, type UsageParams };

package/dist/index.js

@@ -125,6 +125,18 @@ var Resources;
         `connections/${connectionId}`
       );
     }
+    /**
+     * Get subscription details for a connection.
+     * Returns plan info, current cycle credits, and any pending changes (cancellation or downgrade).
+     * @param connectionId Connection ID
+     * @returns Subscription details or null if no active subscription
+     */
+    getSubscription(connectionId) {
+      return this.lava.request(
+        "GET",
+        `connections/${connectionId}/subscription`
+      );
+    }
     /**
      * Delete a connection
      * @param connectionId Connection ID
@@ -219,6 +231,80 @@ var Resources;
     }
   }
   Resources2.UsageResource = UsageResource;
+  class SubscriptionsResource extends BaseResource {
+    /**
+     * List subscription configurations
+     * @returns List of subscription configurations
+     */
+    listConfigs() {
+      return this.lava.request(
+        "GET",
+        "subscription-configs"
+      );
+    }
+    /**
+     * Create a subscription configuration
+     * @param params Subscription configuration parameters
+     * @returns Created subscription configuration
+     */
+    createConfig(params) {
+      return this.lava.request(
+        "POST",
+        "subscription-configs",
+        {
+          data: params
+        }
+      );
+    }
+    /**
+     * Update a subscription configuration
+     * @param id Subscription configuration ID
+     * @param params Update parameters
+     * @returns Updated subscription configuration
+     */
+    updateConfig(id, params) {
+      return this.lava.request(
+        "PUT",
+        `subscription-configs/${id}`,
+        {
+          data: params
+        }
+      );
+    }
+    /**
+     * Delete a subscription configuration
+     * @param id Subscription configuration ID
+     * @returns Success response
+     */
+    deleteConfig(id) {
+      return this.lava.request(
+        "DELETE",
+        `subscription-configs/${id}`
+      );
+    }
+    /**
+     * List active subscriptions for a merchant
+     * @returns List of active subscriptions
+     */
+    listActiveSubscriptions() {
+      return this.lava.request(
+        "GET",
+        "active-subscriptions"
+      );
+    }
+    /**
+     * Cancel an active subscription
+     * @param id Active subscription ID
+     * @returns Success response
+     */
+    cancelActiveSubscription(id) {
+      return this.lava.request(
+        "DELETE",
+        `active-subscriptions/${id}`
+      );
+    }
+  }
+  Resources2.SubscriptionsResource = SubscriptionsResource;
 })(Resources || (Resources = {}));
 
 // src/client.ts
@@ -237,6 +323,7 @@ var Lava = class {
     this.connections = new Resources.ConnectionsResource(this);
     this.requests = new Resources.RequestsResource(this);
     this.usage = new Resources.UsageResource(this);
+    this.subscriptions = new Resources.SubscriptionsResource(this);
     this.providers = {
       openai: `${this.baseUrl}forward?u=https://api.openai.com/v1`,
       anthropic: `${this.baseUrl}forward?u=https://api.anthropic.com/v1`,
@@ -263,7 +350,8 @@ var Lava = class {
       targon: `${this.baseUrl}forward?u=https://api.targon.com/v1`,
       gmicloud: `${this.baseUrl}forward?u=https://api.gmi-serving.com/v1`,
       chutes: `${this.baseUrl}forward?u=https://llm.chutes.ai/v1`,
-      baseten: `${this.baseUrl}forward?u=https://inference.baseten.co/v1`
+      baseten: `${this.baseUrl}forward?u=https://inference.baseten.co/v1`,
+      moonshot: `${this.baseUrl}forward?u=https://api.moonshot.ai/v1`
     };
   }
   /**
@@ -276,11 +364,11 @@ var Lava = class {
   async request(method, path, { data, query } = {}) {
     const url = new URL(path, this.baseUrl);
     if (query) {
-      Object.entries(query).forEach(([key, value]) => {
+      for (const [key, value] of Object.entries(query)) {
         if (value !== void 0) {
           url.searchParams.append(key, value.toString());
         }
-      });
+      }
     }
     const headers = {
       Authorization: `Bearer ${this.secretKey}`,

package/dist/index.mjs

@@ -98,6 +98,18 @@ var Resources;
         `connections/${connectionId}`
       );
     }
+    /**
+     * Get subscription details for a connection.
+     * Returns plan info, current cycle credits, and any pending changes (cancellation or downgrade).
+     * @param connectionId Connection ID
+     * @returns Subscription details or null if no active subscription
+     */
+    getSubscription(connectionId) {
+      return this.lava.request(
+        "GET",
+        `connections/${connectionId}/subscription`
+      );
+    }
     /**
      * Delete a connection
      * @param connectionId Connection ID
@@ -192,6 +204,80 @@ var Resources;
     }
   }
   Resources2.UsageResource = UsageResource;
+  class SubscriptionsResource extends BaseResource {
+    /**
+     * List subscription configurations
+     * @returns List of subscription configurations
+     */
+    listConfigs() {
+      return this.lava.request(
+        "GET",
+        "subscription-configs"
+      );
+    }
+    /**
+     * Create a subscription configuration
+     * @param params Subscription configuration parameters
+     * @returns Created subscription configuration
+     */
+    createConfig(params) {
+      return this.lava.request(
+        "POST",
+        "subscription-configs",
+        {
+          data: params
+        }
+      );
+    }
+    /**
+     * Update a subscription configuration
+     * @param id Subscription configuration ID
+     * @param params Update parameters
+     * @returns Updated subscription configuration
+     */
+    updateConfig(id, params) {
+      return this.lava.request(
+        "PUT",
+        `subscription-configs/${id}`,
+        {
+          data: params
+        }
+      );
+    }
+    /**
+     * Delete a subscription configuration
+     * @param id Subscription configuration ID
+     * @returns Success response
+     */
+    deleteConfig(id) {
+      return this.lava.request(
+        "DELETE",
+        `subscription-configs/${id}`
+      );
+    }
+    /**
+     * List active subscriptions for a merchant
+     * @returns List of active subscriptions
+     */
+    listActiveSubscriptions() {
+      return this.lava.request(
+        "GET",
+        "active-subscriptions"
+      );
+    }
+    /**
+     * Cancel an active subscription
+     * @param id Active subscription ID
+     * @returns Success response
+     */
+    cancelActiveSubscription(id) {
+      return this.lava.request(
+        "DELETE",
+        `active-subscriptions/${id}`
+      );
+    }
+  }
+  Resources2.SubscriptionsResource = SubscriptionsResource;
 })(Resources || (Resources = {}));
 
 // src/client.ts
@@ -210,6 +296,7 @@ var Lava = class {
     this.connections = new Resources.ConnectionsResource(this);
     this.requests = new Resources.RequestsResource(this);
     this.usage = new Resources.UsageResource(this);
+    this.subscriptions = new Resources.SubscriptionsResource(this);
     this.providers = {
       openai: `${this.baseUrl}forward?u=https://api.openai.com/v1`,
       anthropic: `${this.baseUrl}forward?u=https://api.anthropic.com/v1`,
@@ -236,7 +323,8 @@ var Lava = class {
       targon: `${this.baseUrl}forward?u=https://api.targon.com/v1`,
       gmicloud: `${this.baseUrl}forward?u=https://api.gmi-serving.com/v1`,
       chutes: `${this.baseUrl}forward?u=https://llm.chutes.ai/v1`,
-      baseten: `${this.baseUrl}forward?u=https://inference.baseten.co/v1`
+      baseten: `${this.baseUrl}forward?u=https://inference.baseten.co/v1`,
+      moonshot: `${this.baseUrl}forward?u=https://api.moonshot.ai/v1`
     };
   }
   /**
@@ -249,11 +337,11 @@ var Lava = class {
   async request(method, path, { data, query } = {}) {
     const url = new URL(path, this.baseUrl);
     if (query) {
-      Object.entries(query).forEach(([key, value]) => {
+      for (const [key, value] of Object.entries(query)) {
         if (value !== void 0) {
           url.searchParams.append(key, value.toString());
         }
-      });
+      }
     }
     const headers = {
       Authorization: `Bearer ${this.secretKey}`,

package/package.json

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