@lavapayments/nodejs 0.1.0

package/README.md

@@ -0,0 +1,117 @@
+# @lavapayments/nodejs
+
+Backend SDK for Lava Payments API - enabling usage-based billing for AI services.
+
+## Installation
+
+```bash
+npm install @lavapayments/nodejs
+```
+
+## Usage
+
+### Initialize the client
+
+```typescript
+import Lava from '@lavapayments/nodejs';
+
+const lava = new Lava('your_secret_key', {
+  apiVersion: '2025-03-10.v1',
+});
+```
+
+### Create a checkout session
+
+```typescript
+const checkoutSession = await lava.checkout.create({
+  checkout_mode: 'onboarding', // or 'topup' for existing connections
+  origin_url: 'https://your-app.com/', // Must match window.location.origin where checkout will be opened
+  reference_id: 'user_123', // Optional: your user ID for tracking this connection
+});
+
+// Use checkout_session_token with @lavapayments/checkout on frontend
+console.log(checkoutSession.checkout_session_token);
+```
+
+### Make a request to an AI provider
+
+```typescript
+// Generate a forward token
+const forwardToken = lava.generateForwardToken({
+  connection_secret: 'connection_secret',
+  product_secret: 'product_secret',
+});
+
+// Use the token to make an API request through Lava's proxy
+const response = await fetch(lava.openaiUrl, {
+  method: 'POST',
+  headers: {
+    'Content-Type': 'application/json',
+    'Authorization': `Bearer ${forwardToken}`
+  },
+  body: JSON.stringify({
+    model: 'gpt-4',
+    messages: [
+      { role: 'user', content: 'Hello, world!' }
+    ]
+  })
+});
+
+// Get the Lava request ID from the response header
+const requestId = response.headers.get('x-lava-request-id');
+console.log('Lava request ID:', requestId);
+
+const data = await response.json();
+console.log(data);
+```
+
+### Check a connection's balance
+
+```typescript
+const connection = await lava.connections.retrieve('connection_id');
+console.log('Current balance:', connection.wallet.balance);
+```
+
+### Get connection requests
+
+```typescript
+const requests = await lava.requests.list({
+  connection_id: 'connection_id',
+  limit: 10,
+});
+
+console.log(requests.data);
+```
+
+### Get usage statistics
+
+```typescript
+const usage = await lava.usage.retrieve({
+  connection_id: 'connection_id',
+  start: '2024-01-01T00:00:00Z',
+  end: '2024-01-31T23:59:59Z',
+});
+
+console.log(usage);
+```
+
+## Supported AI Providers
+
+Convenience URLs are provided for the following AI providers:
+
+- OpenAI: `lava.openaiUrl`
+- Anthropic: `lava.anthropicUrl`
+- Mistral: `lava.mistralUrl`
+- DeepSeek: `lava.deepseekUrl`
+- xAI: `lava.xaiUrl`
+- Google: `lava.googleUrl`
+
+For other providers, you can use the forward endpoint directly:
+
+```typescript
+const url = `${lava.baseUrl}forward?u=https://api.yourprovider.com/endpoint`;
+```
+
+## Documentation
+
+For more information, see the [Lava API documentation](https://docs.lavapayments.com). 

package/dist/index.d.mts

@@ -0,0 +1,270 @@
+type CheckoutMode = "onboarding" | "topup";
+interface CreateCheckoutSessionParams {
+    checkout_mode: CheckoutMode;
+    origin_url: string;
+    reference_id?: string;
+    connection_id?: string;
+}
+interface CheckoutSession {
+    checkout_session_id: string;
+    checkout_session_token: string;
+    checkout_mode: CheckoutMode;
+    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 {
+    connection_id: string;
+    reference_id?: string;
+    wallet: Wallet;
+    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;
+}
+interface Request {
+    request_id: string;
+    connection_id: string;
+    product_id: string;
+    model: string;
+    endpoint: string;
+    response_id: string;
+    model_usage: ModelUsage;
+    fee: Fee;
+    service_charge: ServiceCharge;
+    total_request_cost: string;
+    timestamp: string;
+    created_at: string;
+}
+interface RequestsListParams {
+    cursor?: string;
+    limit?: number;
+    connection_id?: string;
+    product_id?: string;
+}
+interface RequestsListResponse {
+    data: Request[];
+    has_more: boolean;
+    next_cursor?: string;
+}
+interface UsageData {
+    date: string;
+    total_usage_tokens: number;
+    total_usage_cost: string;
+    total_service_charge_amount: string;
+    total_request_cost: string;
+}
+interface UsageParams {
+    start: string;
+    end?: string;
+    connection_id?: string;
+    product_id?: string;
+}
+type Usage = UsageData[];
+
+declare namespace Resources {
+    abstract class BaseResource {
+        protected lava: Lava;
+        constructor(lava: Lava);
+    }
+    /**
+     * Checkout session related endpoints
+     */
+    export class CheckoutResource extends BaseResource {
+        /**
+         * Create a checkout session
+         * @param params Checkout session parameters
+         * @returns Created checkout session
+         */
+        create(params: CreateCheckoutSessionParams): Promise<CheckoutSession>;
+        /**
+         * Retrieve a checkout session
+         * @param checkoutSessionId Checkout session ID
+         * @returns Checkout session details
+         */
+        retrieve(checkoutSessionId: string): Promise<CheckoutSession>;
+    }
+    /**
+     * Connection related endpoints
+     */
+    export class ConnectionsResource extends BaseResource {
+        /**
+         * List connections
+         * @param params List parameters
+         * @returns Paginated list of connections
+         */
+        list(params?: ConnectionsListParams): Promise<ConnectionsListResponse>;
+        /**
+         * Retrieve a connection
+         * @param connectionId Connection ID
+         * @returns Connection details
+         */
+        retrieve(connectionId: string): Promise<Connection>;
+        /**
+         * Delete a connection
+         * @param connectionId Connection ID
+         * @returns Success status
+         */
+        delete(connectionId: string): Promise<{
+            success: boolean;
+        }>;
+    }
+    /**
+     * Request related endpoints
+     */
+    export class RequestsResource extends BaseResource {
+        /**
+         * List requests
+         * @param params List parameters
+         * @returns Paginated list of requests
+         */
+        list(params?: RequestsListParams): Promise<RequestsListResponse>;
+        /**
+         * Retrieve a request
+         * @param requestId Request ID
+         * @returns Request details
+         */
+        retrieve(requestId: string): Promise<Request>;
+    }
+    /**
+     * Usage related endpoints
+     */
+    export class UsageResource extends BaseResource {
+        /**
+         * Retrieve usage statistics
+         * @param params Usage parameters
+         * @returns Usage data
+         */
+        retrieve(params: UsageParams): Promise<Usage>;
+    }
+    export {  };
+}
+
+type ApiVersion = "2025-03-10.v1";
+interface Config {
+    apiVersion: ApiVersion;
+    /**
+     * Base URL for the API.
+     * If not provided, it will be inferred from the secret key (production or sandbox).
+     */
+    baseUrl?: string;
+}
+type ForwardTokenOptions = {
+    connection_secret: string;
+    product_secret: string;
+};
+declare class Lava {
+    private readonly secretKey;
+    private readonly baseUrl;
+    private readonly apiVersion;
+    /**
+     * The checkout resource
+     */
+    readonly checkout: Resources.CheckoutResource;
+    /**
+     * The connections resource
+     */
+    readonly connections: Resources.ConnectionsResource;
+    /**
+     * The requests resource
+     */
+    readonly requests: Resources.RequestsResource;
+    /**
+     * The usage resource
+     */
+    readonly usage: Resources.UsageResource;
+    /**
+     * OpenAI base URL for convenience
+     */
+    readonly openaiUrl: string;
+    /**
+     * Anthropic base URL for convenience
+     */
+    readonly anthropicUrl: string;
+    /**
+     * Mistral base URL for convenience
+     */
+    readonly mistralUrl: string;
+    /**
+     * DeepSeek base URL for convenience
+     */
+    readonly deepseekUrl: string;
+    /**
+     * xAI base URL for convenience
+     */
+    readonly xaiUrl: string;
+    /**
+     * Google base URL for convenience
+     */
+    readonly googleUrl: string;
+    /**
+     * Google OpenAI-compatible base URL for convenience
+     */
+    readonly googleOpenaiCompatibleUrl: string;
+    /**
+     * Create a new Lava client
+     * @param secretKey Your Lava secret key
+     * @param config Configuration options
+     */
+    constructor(secretKey: string, config: Config);
+    /**
+     * Make a request to the Lava API
+     * @param method HTTP method
+     * @param path API path
+     * @param options Request options
+     * @returns Response data
+     */
+    request<T>(method: string, path: string, { data, query }?: {
+        data?: any;
+        query?: Record<string, string>;
+    }): Promise<T>;
+    /**
+     * Generate a token for the forward endpoint
+     * @param options Token options
+     * @returns Base64 encoded token
+     */
+    generateForwardToken(options: ForwardTokenOptions): string;
+}
+
+export { type ApiVersion, type CheckoutMode, type CheckoutSession, type Config, type Connection, type ConnectionsListParams, type ConnectionsListResponse, type CreateCheckoutSessionParams, type Fee, type FeeTierBreakdown, type ForwardTokenOptions, type ModelUsage, type Request, type RequestsListParams, type RequestsListResponse, Resources, type ServiceCharge, type Usage, type UsageData, type UsageParams, type Wallet, Lava as default };

package/dist/index.d.ts

@@ -0,0 +1,270 @@
+type CheckoutMode = "onboarding" | "topup";
+interface CreateCheckoutSessionParams {
+    checkout_mode: CheckoutMode;
+    origin_url: string;
+    reference_id?: string;
+    connection_id?: string;
+}
+interface CheckoutSession {
+    checkout_session_id: string;
+    checkout_session_token: string;
+    checkout_mode: CheckoutMode;
+    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 {
+    connection_id: string;
+    reference_id?: string;
+    wallet: Wallet;
+    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;
+}
+interface Request {
+    request_id: string;
+    connection_id: string;
+    product_id: string;
+    model: string;
+    endpoint: string;
+    response_id: string;
+    model_usage: ModelUsage;
+    fee: Fee;
+    service_charge: ServiceCharge;
+    total_request_cost: string;
+    timestamp: string;
+    created_at: string;
+}
+interface RequestsListParams {
+    cursor?: string;
+    limit?: number;
+    connection_id?: string;
+    product_id?: string;
+}
+interface RequestsListResponse {
+    data: Request[];
+    has_more: boolean;
+    next_cursor?: string;
+}
+interface UsageData {
+    date: string;
+    total_usage_tokens: number;
+    total_usage_cost: string;
+    total_service_charge_amount: string;
+    total_request_cost: string;
+}
+interface UsageParams {
+    start: string;
+    end?: string;
+    connection_id?: string;
+    product_id?: string;
+}
+type Usage = UsageData[];
+
+declare namespace Resources {
+    abstract class BaseResource {
+        protected lava: Lava;
+        constructor(lava: Lava);
+    }
+    /**
+     * Checkout session related endpoints
+     */
+    export class CheckoutResource extends BaseResource {
+        /**
+         * Create a checkout session
+         * @param params Checkout session parameters
+         * @returns Created checkout session
+         */
+        create(params: CreateCheckoutSessionParams): Promise<CheckoutSession>;
+        /**
+         * Retrieve a checkout session
+         * @param checkoutSessionId Checkout session ID
+         * @returns Checkout session details
+         */
+        retrieve(checkoutSessionId: string): Promise<CheckoutSession>;
+    }
+    /**
+     * Connection related endpoints
+     */
+    export class ConnectionsResource extends BaseResource {
+        /**
+         * List connections
+         * @param params List parameters
+         * @returns Paginated list of connections
+         */
+        list(params?: ConnectionsListParams): Promise<ConnectionsListResponse>;
+        /**
+         * Retrieve a connection
+         * @param connectionId Connection ID
+         * @returns Connection details
+         */
+        retrieve(connectionId: string): Promise<Connection>;
+        /**
+         * Delete a connection
+         * @param connectionId Connection ID
+         * @returns Success status
+         */
+        delete(connectionId: string): Promise<{
+            success: boolean;
+        }>;
+    }
+    /**
+     * Request related endpoints
+     */
+    export class RequestsResource extends BaseResource {
+        /**
+         * List requests
+         * @param params List parameters
+         * @returns Paginated list of requests
+         */
+        list(params?: RequestsListParams): Promise<RequestsListResponse>;
+        /**
+         * Retrieve a request
+         * @param requestId Request ID
+         * @returns Request details
+         */
+        retrieve(requestId: string): Promise<Request>;
+    }
+    /**
+     * Usage related endpoints
+     */
+    export class UsageResource extends BaseResource {
+        /**
+         * Retrieve usage statistics
+         * @param params Usage parameters
+         * @returns Usage data
+         */
+        retrieve(params: UsageParams): Promise<Usage>;
+    }
+    export {  };
+}
+
+type ApiVersion = "2025-03-10.v1";
+interface Config {
+    apiVersion: ApiVersion;
+    /**
+     * Base URL for the API.
+     * If not provided, it will be inferred from the secret key (production or sandbox).
+     */
+    baseUrl?: string;
+}
+type ForwardTokenOptions = {
+    connection_secret: string;
+    product_secret: string;
+};
+declare class Lava {
+    private readonly secretKey;
+    private readonly baseUrl;
+    private readonly apiVersion;
+    /**
+     * The checkout resource
+     */
+    readonly checkout: Resources.CheckoutResource;
+    /**
+     * The connections resource
+     */
+    readonly connections: Resources.ConnectionsResource;
+    /**
+     * The requests resource
+     */
+    readonly requests: Resources.RequestsResource;
+    /**
+     * The usage resource
+     */
+    readonly usage: Resources.UsageResource;
+    /**
+     * OpenAI base URL for convenience
+     */
+    readonly openaiUrl: string;
+    /**
+     * Anthropic base URL for convenience
+     */
+    readonly anthropicUrl: string;
+    /**
+     * Mistral base URL for convenience
+     */
+    readonly mistralUrl: string;
+    /**
+     * DeepSeek base URL for convenience
+     */
+    readonly deepseekUrl: string;
+    /**
+     * xAI base URL for convenience
+     */
+    readonly xaiUrl: string;
+    /**
+     * Google base URL for convenience
+     */
+    readonly googleUrl: string;
+    /**
+     * Google OpenAI-compatible base URL for convenience
+     */
+    readonly googleOpenaiCompatibleUrl: string;
+    /**
+     * Create a new Lava client
+     * @param secretKey Your Lava secret key
+     * @param config Configuration options
+     */
+    constructor(secretKey: string, config: Config);
+    /**
+     * Make a request to the Lava API
+     * @param method HTTP method
+     * @param path API path
+     * @param options Request options
+     * @returns Response data
+     */
+    request<T>(method: string, path: string, { data, query }?: {
+        data?: any;
+        query?: Record<string, string>;
+    }): Promise<T>;
+    /**
+     * Generate a token for the forward endpoint
+     * @param options Token options
+     * @returns Base64 encoded token
+     */
+    generateForwardToken(options: ForwardTokenOptions): string;
+}
+
+export { type ApiVersion, type CheckoutMode, type CheckoutSession, type Config, type Connection, type ConnectionsListParams, type ConnectionsListResponse, type CreateCheckoutSessionParams, type Fee, type FeeTierBreakdown, type ForwardTokenOptions, type ModelUsage, type Request, type RequestsListParams, type RequestsListResponse, Resources, type ServiceCharge, type Usage, type UsageData, type UsageParams, type Wallet, Lava as default };

package/dist/index.js

@@ -0,0 +1,228 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Resources: () => Resources,
+  default: () => Lava
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/resources.ts
+var Resources;
+((Resources2) => {
+  class BaseResource {
+    constructor(lava) {
+      this.lava = lava;
+    }
+  }
+  class CheckoutResource 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
+      });
+    }
+    /**
+     * Retrieve a checkout session
+     * @param checkoutSessionId Checkout session ID
+     * @returns Checkout session details
+     */
+    async retrieve(checkoutSessionId) {
+      return this.lava.request(
+        "GET",
+        `checkout_sessions/${checkoutSessionId}`
+      );
+    }
+  }
+  Resources2.CheckoutResource = CheckoutResource;
+  class ConnectionsResource extends BaseResource {
+    /**
+     * List connections
+     * @param params List parameters
+     * @returns Paginated list of connections
+     */
+    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", "connections", {
+        query: queryParams
+      });
+    }
+    /**
+     * Retrieve a connection
+     * @param connectionId Connection ID
+     * @returns Connection details
+     */
+    async retrieve(connectionId) {
+      return this.lava.request(
+        "GET",
+        `connections/${connectionId}`
+      );
+    }
+    /**
+     * Delete a connection
+     * @param connectionId Connection ID
+     * @returns Success status
+     */
+    async delete(connectionId) {
+      return this.lava.request(
+        "DELETE",
+        `connections/${connectionId}`
+      );
+    }
+  }
+  Resources2.ConnectionsResource = ConnectionsResource;
+  class RequestsResource extends BaseResource {
+    /**
+     * List requests
+     * @param params List parameters
+     * @returns Paginated list of requests
+     */
+    async list(params) {
+      const queryParams = {};
+      if (params) {
+        if (params.cursor) queryParams.cursor = params.cursor;
+        if (params.limit) queryParams.limit = params.limit.toString();
+        if (params.connection_id)
+          queryParams.connection_id = params.connection_id;
+        if (params.product_id) queryParams.product_id = params.product_id;
+      }
+      return this.lava.request("GET", "requests", {
+        query: queryParams
+      });
+    }
+    /**
+     * Retrieve a request
+     * @param requestId Request ID
+     * @returns Request details
+     */
+    async retrieve(requestId) {
+      return this.lava.request("GET", `requests/${requestId}`);
+    }
+  }
+  Resources2.RequestsResource = RequestsResource;
+  class UsageResource extends BaseResource {
+    /**
+     * Retrieve usage statistics
+     * @param params Usage parameters
+     * @returns Usage data
+     */
+    async retrieve(params) {
+      const queryParams = {
+        start: params.start
+      };
+      if (params.end) queryParams.end = params.end;
+      if (params.connection_id)
+        queryParams.connection_id = params.connection_id;
+      if (params.product_id) queryParams.product_id = params.product_id;
+      return this.lava.request("GET", "usage", {
+        query: queryParams
+      });
+    }
+  }
+  Resources2.UsageResource = UsageResource;
+})(Resources || (Resources = {}));
+
+// src/index.ts
+var Lava = class {
+  /**
+   * Create a new Lava client
+   * @param secretKey Your Lava secret key
+   * @param config Configuration options
+   */
+  constructor(secretKey, config) {
+    this.secretKey = secretKey;
+    this.apiVersion = config.apiVersion;
+    const isTestMode = secretKey.startsWith("test_");
+    this.baseUrl = config.baseUrl || (isTestMode ? "https://sandbox-api.lavapayments.com/v1/" : "https://api.lavapayments.com/v1/");
+    this.checkout = new Resources.CheckoutResource(this);
+    this.connections = new Resources.ConnectionsResource(this);
+    this.requests = new Resources.RequestsResource(this);
+    this.usage = new Resources.UsageResource(this);
+    this.openaiUrl = `${this.baseUrl}forward?u=https://api.openai.com/v1`;
+    this.anthropicUrl = `${this.baseUrl}forward?u=https://api.anthropic.com/v1`;
+    this.mistralUrl = `${this.baseUrl}forward?u=https://api.mistral.ai/v1`;
+    this.deepseekUrl = `${this.baseUrl}forward?u=https://api.deepseek.com/v1`;
+    this.xaiUrl = `${this.baseUrl}forward?u=https://api.x.ai/v1`;
+    this.googleUrl = `${this.baseUrl}forward?u=https://generativelanguage.googleapis.com/v1beta`;
+    this.googleOpenaiCompatibleUrl = `${this.baseUrl}forward?u=https://generativelanguage.googleapis.com/v1beta/openai`;
+  }
+  /**
+   * Make a request to the Lava API
+   * @param method HTTP method
+   * @param path API path
+   * @param options Request options
+   * @returns Response data
+   */
+  async request(method, path, { data, query } = {}) {
+    const url = new URL(path, this.baseUrl);
+    if (query) {
+      Object.entries(query).forEach(([key, value]) => {
+        if (value !== void 0) {
+          url.searchParams.append(key, value.toString());
+        }
+      });
+    }
+    const headers = {
+      Authorization: `Bearer ${this.secretKey}`,
+      "Content-Type": "application/json",
+      "X-Lava-API-Version": this.apiVersion
+    };
+    const requestOptions = {
+      method,
+      headers,
+      body: data ? JSON.stringify(data) : void 0
+    };
+    const response = await fetch(url.toString(), requestOptions);
+    if (!response.ok) {
+      const errorJson = await response.json().catch(() => ({}));
+      throw new Error(
+        `Lava API Error: ${response.status} ${response.statusText} - ${errorJson.error || "Unknown error"}`
+      );
+    }
+    return response.json();
+  }
+  /**
+   * Generate a token for the forward endpoint
+   * @param options Token options
+   * @returns Base64 encoded token
+   */
+  generateForwardToken(options) {
+    const tokenData = {
+      secret_key: this.secretKey,
+      connection_secret: options.connection_secret,
+      product_secret: options.product_secret
+    };
+    return Buffer.from(JSON.stringify(tokenData)).toString("base64");
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Resources
+});

package/dist/index.mjs

@@ -0,0 +1,201 @@
+// src/resources.ts
+var Resources;
+((Resources2) => {
+  class BaseResource {
+    constructor(lava) {
+      this.lava = lava;
+    }
+  }
+  class CheckoutResource 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
+      });
+    }
+    /**
+     * Retrieve a checkout session
+     * @param checkoutSessionId Checkout session ID
+     * @returns Checkout session details
+     */
+    async retrieve(checkoutSessionId) {
+      return this.lava.request(
+        "GET",
+        `checkout_sessions/${checkoutSessionId}`
+      );
+    }
+  }
+  Resources2.CheckoutResource = CheckoutResource;
+  class ConnectionsResource extends BaseResource {
+    /**
+     * List connections
+     * @param params List parameters
+     * @returns Paginated list of connections
+     */
+    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", "connections", {
+        query: queryParams
+      });
+    }
+    /**
+     * Retrieve a connection
+     * @param connectionId Connection ID
+     * @returns Connection details
+     */
+    async retrieve(connectionId) {
+      return this.lava.request(
+        "GET",
+        `connections/${connectionId}`
+      );
+    }
+    /**
+     * Delete a connection
+     * @param connectionId Connection ID
+     * @returns Success status
+     */
+    async delete(connectionId) {
+      return this.lava.request(
+        "DELETE",
+        `connections/${connectionId}`
+      );
+    }
+  }
+  Resources2.ConnectionsResource = ConnectionsResource;
+  class RequestsResource extends BaseResource {
+    /**
+     * List requests
+     * @param params List parameters
+     * @returns Paginated list of requests
+     */
+    async list(params) {
+      const queryParams = {};
+      if (params) {
+        if (params.cursor) queryParams.cursor = params.cursor;
+        if (params.limit) queryParams.limit = params.limit.toString();
+        if (params.connection_id)
+          queryParams.connection_id = params.connection_id;
+        if (params.product_id) queryParams.product_id = params.product_id;
+      }
+      return this.lava.request("GET", "requests", {
+        query: queryParams
+      });
+    }
+    /**
+     * Retrieve a request
+     * @param requestId Request ID
+     * @returns Request details
+     */
+    async retrieve(requestId) {
+      return this.lava.request("GET", `requests/${requestId}`);
+    }
+  }
+  Resources2.RequestsResource = RequestsResource;
+  class UsageResource extends BaseResource {
+    /**
+     * Retrieve usage statistics
+     * @param params Usage parameters
+     * @returns Usage data
+     */
+    async retrieve(params) {
+      const queryParams = {
+        start: params.start
+      };
+      if (params.end) queryParams.end = params.end;
+      if (params.connection_id)
+        queryParams.connection_id = params.connection_id;
+      if (params.product_id) queryParams.product_id = params.product_id;
+      return this.lava.request("GET", "usage", {
+        query: queryParams
+      });
+    }
+  }
+  Resources2.UsageResource = UsageResource;
+})(Resources || (Resources = {}));
+
+// src/index.ts
+var Lava = class {
+  /**
+   * Create a new Lava client
+   * @param secretKey Your Lava secret key
+   * @param config Configuration options
+   */
+  constructor(secretKey, config) {
+    this.secretKey = secretKey;
+    this.apiVersion = config.apiVersion;
+    const isTestMode = secretKey.startsWith("test_");
+    this.baseUrl = config.baseUrl || (isTestMode ? "https://sandbox-api.lavapayments.com/v1/" : "https://api.lavapayments.com/v1/");
+    this.checkout = new Resources.CheckoutResource(this);
+    this.connections = new Resources.ConnectionsResource(this);
+    this.requests = new Resources.RequestsResource(this);
+    this.usage = new Resources.UsageResource(this);
+    this.openaiUrl = `${this.baseUrl}forward?u=https://api.openai.com/v1`;
+    this.anthropicUrl = `${this.baseUrl}forward?u=https://api.anthropic.com/v1`;
+    this.mistralUrl = `${this.baseUrl}forward?u=https://api.mistral.ai/v1`;
+    this.deepseekUrl = `${this.baseUrl}forward?u=https://api.deepseek.com/v1`;
+    this.xaiUrl = `${this.baseUrl}forward?u=https://api.x.ai/v1`;
+    this.googleUrl = `${this.baseUrl}forward?u=https://generativelanguage.googleapis.com/v1beta`;
+    this.googleOpenaiCompatibleUrl = `${this.baseUrl}forward?u=https://generativelanguage.googleapis.com/v1beta/openai`;
+  }
+  /**
+   * Make a request to the Lava API
+   * @param method HTTP method
+   * @param path API path
+   * @param options Request options
+   * @returns Response data
+   */
+  async request(method, path, { data, query } = {}) {
+    const url = new URL(path, this.baseUrl);
+    if (query) {
+      Object.entries(query).forEach(([key, value]) => {
+        if (value !== void 0) {
+          url.searchParams.append(key, value.toString());
+        }
+      });
+    }
+    const headers = {
+      Authorization: `Bearer ${this.secretKey}`,
+      "Content-Type": "application/json",
+      "X-Lava-API-Version": this.apiVersion
+    };
+    const requestOptions = {
+      method,
+      headers,
+      body: data ? JSON.stringify(data) : void 0
+    };
+    const response = await fetch(url.toString(), requestOptions);
+    if (!response.ok) {
+      const errorJson = await response.json().catch(() => ({}));
+      throw new Error(
+        `Lava API Error: ${response.status} ${response.statusText} - ${errorJson.error || "Unknown error"}`
+      );
+    }
+    return response.json();
+  }
+  /**
+   * Generate a token for the forward endpoint
+   * @param options Token options
+   * @returns Base64 encoded token
+   */
+  generateForwardToken(options) {
+    const tokenData = {
+      secret_key: this.secretKey,
+      connection_secret: options.connection_secret,
+      product_secret: options.product_secret
+    };
+    return Buffer.from(JSON.stringify(tokenData)).toString("base64");
+  }
+};
+export {
+  Resources,
+  Lava as default
+};

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@lavapayments/nodejs",
+  "version": "0.1.0",
+  "description": "Backend SDK for Lava Payments API - enabling usage-based billing for AI services",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup --dts --format cjs,esm src/index.ts",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "prepublishOnly": "npm run build",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "lava",
+    "payments",
+    "billing",
+    "ai",
+    "openai",
+    "anthropic",
+    "usage-based",
+    "proxy"
+  ],
+  "author": "Lava",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/eslint": "^8.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "eslint": "^8.0.0",
+    "prettier": "^3.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}