@velobaseai/billing 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Velobase
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,282 @@
+# @velobaseai/billing
+
+Official Velobase Billing SDK for JavaScript and TypeScript.
+
+- Zero runtime dependencies — uses native `fetch`
+- Works with Node.js 18+, Deno, Bun, and Cloudflare Workers
+- ESM and CommonJS dual build with full TypeScript declarations
+- Automatic retries with exponential backoff
+
+## Installation
+
+```bash
+npm install @velobaseai/billing
+# or
+pnpm add @velobaseai/billing
+# or
+yarn add @velobaseai/billing
+```
+
+## Quick Start
+
+```typescript
+import Velobase from '@velobaseai/billing';
+
+const vb = new Velobase({ apiKey: 'vb_live_xxx' });
+
+// 1. Deposit credits to a customer (creates the customer if new)
+const deposit = await vb.customers.deposit({
+  customerId: 'user_123',
+  amount: 1000,
+});
+
+// 2. Check balance
+const customer = await vb.customers.get('user_123');
+console.log(customer.balance.available); // 1000
+
+// 3. Freeze credits before doing work
+const freeze = await vb.billing.freeze({
+  customerId: 'user_123',
+  amount: 50,
+  businessId: 'job_abc',
+});
+
+// 4a. Job succeeded — consume (supports partial)
+const consume = await vb.billing.consume({
+  businessId: 'job_abc',
+  actualAmount: 32, // only charge 32, return 18
+});
+
+// 4b. Or if the job failed — unfreeze to return all
+const unfreeze = await vb.billing.unfreeze({
+  businessId: 'job_abc',
+});
+```
+
+## How It Works
+
+Velobase Billing uses a **freeze-then-consume** pattern to safely manage credits:
+
+```
+deposit → freeze → consume   (normal flow)
+                 → unfreeze  (failure/cancellation)
+```
+
+1. **Deposit** — Add credits to a customer's account. Creates the customer automatically on first deposit.
+2. **Freeze** — Pre-authorize an amount before performing work. The frozen credits are deducted from `available` but not yet `used`. Each freeze is identified by a unique `businessId` you provide.
+3. **Consume** — After the work is done, settle the frozen amount. You can pass `actualAmount` to charge less than what was frozen; the difference is automatically returned.
+4. **Unfreeze** — If the work fails or is cancelled, release the full frozen amount back to the customer.
+
+All write operations are **idempotent** — repeating the same `businessId` (freeze/consume/unfreeze) or `idempotencyKey` (deposit) returns the original result without double-charging.
+
+## Configuration
+
+```typescript
+const vb = new Velobase({
+  apiKey: 'vb_live_xxx',             // Required. Your Velobase API key.
+  baseUrl: 'https://api.velobase.io', // Optional. Override the API endpoint.
+  timeout: 30000,                     // Optional. Request timeout in ms (default: 30s).
+  maxRetries: 2,                      // Optional. Retry count on 5xx/network errors (default: 2).
+});
+```
+
+## Usage Examples
+
+### Deposit with idempotency
+
+```typescript
+// Safe to retry — the second call returns the same result without double-charging
+const result = await vb.customers.deposit({
+  customerId: 'user_123',
+  amount: 500,
+  idempotencyKey: 'order_abc_payment',
+  description: 'Purchase of 500 credits',
+});
+
+console.log(result.addedAmount);        // 500
+console.log(result.isIdempotentReplay); // false on first call, true on retries
+```
+
+### Deposit with customer metadata
+
+```typescript
+const result = await vb.customers.deposit({
+  customerId: 'user_123',
+  amount: 1000,
+  name: 'Alice',
+  email: 'alice@example.com',
+  metadata: { plan: 'pro', source: 'stripe' },
+});
+```
+
+### Full billing flow
+
+```typescript
+const CUSTOMER = 'user_123';
+const JOB_ID = 'video_gen_001';
+
+// Check balance before starting
+const before = await vb.customers.get(CUSTOMER);
+console.log('Available:', before.balance.available);
+
+// Freeze the estimated cost
+await vb.billing.freeze({
+  customerId: CUSTOMER,
+  amount: 100,
+  businessId: JOB_ID,
+  businessType: 'video_generation',
+  description: '1080p video, ~60s',
+});
+
+// ... do the work ...
+
+// Settle with the actual cost (partial consumption)
+const result = await vb.billing.consume({
+  businessId: JOB_ID,
+  actualAmount: 73,
+});
+console.log('Charged:', result.consumedAmount);  // 73
+console.log('Returned:', result.returnedAmount); // 27
+
+// Verify final balance
+const after = await vb.customers.get(CUSTOMER);
+console.log('Available:', after.balance.available);
+```
+
+### Customer balance structure
+
+```typescript
+const customer = await vb.customers.get('user_123');
+
+// Aggregate balance across all accounts
+customer.balance.total;     // total deposited
+customer.balance.used;      // total consumed
+customer.balance.frozen;    // currently frozen (pending)
+customer.balance.available; // total - used - frozen
+
+// Individual accounts (e.g., different credit types/expiry)
+for (const account of customer.accounts) {
+  console.log(account.accountType);    // 'CREDIT'
+  console.log(account.subAccountType); // 'DEFAULT'
+  console.log(account.available);
+  console.log(account.expiresAt);      // null or ISO date string
+}
+```
+
+## API Reference
+
+### `vb.customers.deposit(params): Promise<DepositResponse>`
+
+Deposit credits. Creates the customer if they don't exist.
+
+| Parameter | Type | Required | Description |
+|---|---|---|---|
+| `customerId` | `string` | Yes | Your unique customer identifier |
+| `amount` | `number` | Yes | Amount to deposit (must be > 0) |
+| `idempotencyKey` | `string` | No | Prevents duplicate deposits on retry |
+| `name` | `string \| null` | No | Customer display name |
+| `email` | `string \| null` | No | Customer email |
+| `metadata` | `object` | No | Arbitrary key-value metadata |
+| `description` | `string` | No | Description for the deposit |
+
+**Returns:** `{ customerId, accountId, totalAmount, addedAmount, recordId, isIdempotentReplay }`
+
+### `vb.customers.get(customerId): Promise<CustomerResponse>`
+
+Retrieve a customer's balance and account details.
+
+**Returns:** `{ id, name, email, metadata, balance, accounts, createdAt }`
+
+### `vb.billing.freeze(params): Promise<FreezeResponse>`
+
+Freeze credits before performing work.
+
+| Parameter | Type | Required | Description |
+|---|---|---|---|
+| `customerId` | `string` | Yes | Customer identifier |
+| `amount` | `number` | Yes | Amount to freeze (must be > 0) |
+| `businessId` | `string` | Yes | Your unique ID for this operation (idempotency key) |
+| `businessType` | `string` | No | Category label (e.g., `'video_generation'`) |
+| `description` | `string` | No | Human-readable description |
+
+**Returns:** `{ businessId, frozenAmount, freezeDetails, isIdempotentReplay }`
+
+### `vb.billing.consume(params): Promise<ConsumeResponse>`
+
+Settle a frozen amount. Supports partial consumption.
+
+| Parameter | Type | Required | Description |
+|---|---|---|---|
+| `businessId` | `string` | Yes | The `businessId` from the freeze |
+| `actualAmount` | `number` | No | Actual amount to charge. Defaults to full frozen amount. |
+
+**Returns:** `{ businessId, consumedAmount, returnedAmount, consumeDetails, consumedAt, isIdempotentReplay }`
+
+### `vb.billing.unfreeze(params): Promise<UnfreezeResponse>`
+
+Release a frozen amount back to the customer.
+
+| Parameter | Type | Required | Description |
+|---|---|---|---|
+| `businessId` | `string` | Yes | The `businessId` from the freeze |
+
+**Returns:** `{ businessId, unfrozenAmount, unfreezeDetails, unfrozenAt, isIdempotentReplay }`
+
+## Error Handling
+
+All API errors throw typed exceptions that extend `VelobaseError`:
+
+```typescript
+import {
+  VelobaseError,
+  VelobaseAuthenticationError,
+  VelobaseValidationError,
+  VelobaseNotFoundError,
+} from '@velobaseai/billing';
+
+try {
+  await vb.billing.freeze({
+    customerId: 'user_123',
+    amount: 999999,
+    businessId: 'job_xyz',
+  });
+} catch (err) {
+  if (err instanceof VelobaseValidationError) {
+    // 400 — bad request or insufficient balance
+    console.error(err.message); // "insufficient balance"
+  } else if (err instanceof VelobaseAuthenticationError) {
+    // 401 — invalid or missing API key
+  } else if (err instanceof VelobaseNotFoundError) {
+    // 404 — customer not found
+  } else if (err instanceof VelobaseError) {
+    // catch-all for other API errors
+    console.error(err.status, err.type, err.message);
+  }
+}
+```
+
+| Error Class | HTTP Status | When |
+|---|---|---|
+| `VelobaseAuthenticationError` | 401 | Invalid or missing API key |
+| `VelobaseValidationError` | 400 | Bad params, insufficient balance |
+| `VelobaseNotFoundError` | 404 | Customer or resource not found |
+| `VelobaseConflictError` | 409 | Conflicting operation |
+| `VelobaseInternalError` | 500 | Server-side error (auto-retried) |
+
+## Retries
+
+The SDK automatically retries on 5xx errors and network failures with exponential backoff (500ms, 1s, 2s..., capped at 5s). Retries are safe because all Velobase write operations are idempotent.
+
+4xx errors (validation, auth, not found) are never retried.
+
+## CommonJS
+
+```javascript
+const { Velobase } = require('@velobaseai/billing');
+
+const vb = new Velobase({ apiKey: 'vb_live_xxx' });
+```
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,140 @@
+interface HttpClientOptions {
+    baseUrl: string;
+    apiKey: string;
+    timeout: number;
+    maxRetries: number;
+}
+declare class HttpClient {
+    private baseUrl;
+    private apiKey;
+    private timeout;
+    private maxRetries;
+    constructor(opts: HttpClientOptions);
+    request<T>(method: string, path: string, body?: unknown, headers?: Record<string, string>): Promise<T>;
+}
+
+interface FreezeParams {
+    customerId: string;
+    amount: number;
+    businessId: string;
+    businessType?: string;
+    description?: string;
+}
+interface FreezeResponse {
+    businessId: string;
+    frozenAmount: number;
+    freezeDetails: unknown[];
+    isIdempotentReplay: boolean;
+}
+interface ConsumeParams {
+    businessId: string;
+    actualAmount?: number;
+}
+interface ConsumeResponse {
+    businessId: string;
+    consumedAmount: number;
+    returnedAmount?: number;
+    consumeDetails: unknown[];
+    consumedAt: string;
+    isIdempotentReplay: boolean;
+}
+interface UnfreezeParams {
+    businessId: string;
+}
+interface UnfreezeResponse {
+    businessId: string;
+    unfrozenAmount: number;
+    unfreezeDetails: unknown[];
+    unfrozenAt: string;
+    isIdempotentReplay: boolean;
+}
+interface DepositParams {
+    customerId: string;
+    amount: number;
+    idempotencyKey?: string;
+    name?: string | null;
+    email?: string | null;
+    metadata?: Record<string, unknown>;
+    description?: string;
+}
+interface DepositResponse {
+    customerId: string;
+    accountId: string;
+    totalAmount: number;
+    addedAmount: number;
+    recordId: string;
+    isIdempotentReplay: boolean;
+}
+interface CustomerBalance {
+    total: number;
+    used: number;
+    frozen: number;
+    available: number;
+}
+interface CustomerAccount {
+    accountType: string;
+    subAccountType: string;
+    total: number;
+    used: number;
+    frozen: number;
+    available: number;
+    startsAt: string | null;
+    expiresAt: string | null;
+}
+interface CustomerResponse {
+    id: string;
+    name: string | null;
+    email: string | null;
+    metadata: Record<string, unknown> | null;
+    balance: CustomerBalance;
+    accounts: CustomerAccount[];
+    createdAt: string;
+}
+interface VelobaseOptions {
+    apiKey: string;
+    baseUrl?: string;
+    timeout?: number;
+    maxRetries?: number;
+}
+
+declare class BillingResource {
+    private http;
+    constructor(http: HttpClient);
+    freeze(params: FreezeParams): Promise<FreezeResponse>;
+    consume(params: ConsumeParams): Promise<ConsumeResponse>;
+    unfreeze(params: UnfreezeParams): Promise<UnfreezeResponse>;
+}
+declare class CustomersResource {
+    private http;
+    constructor(http: HttpClient);
+    deposit(params: DepositParams): Promise<DepositResponse>;
+    get(customerId: string): Promise<CustomerResponse>;
+}
+declare class Velobase {
+    readonly billing: BillingResource;
+    readonly customers: CustomersResource;
+    constructor(opts: VelobaseOptions);
+}
+
+declare class VelobaseError extends Error {
+    status: number;
+    type: string;
+    constructor(message: string, status: number, type: string);
+}
+declare class VelobaseAuthenticationError extends VelobaseError {
+    constructor(message: string);
+}
+declare class VelobaseValidationError extends VelobaseError {
+    constructor(message: string);
+}
+declare class VelobaseNotFoundError extends VelobaseError {
+    constructor(message: string);
+}
+declare class VelobaseConflictError extends VelobaseError {
+    constructor(message: string);
+}
+declare class VelobaseInternalError extends VelobaseError {
+    constructor(message: string);
+}
+
+export { type ConsumeParams, type ConsumeResponse, type CustomerAccount, type CustomerBalance, type CustomerResponse, type DepositParams, type DepositResponse, type FreezeParams, type FreezeResponse, type UnfreezeParams, type UnfreezeResponse, Velobase, VelobaseAuthenticationError, VelobaseConflictError, VelobaseError, VelobaseInternalError, VelobaseNotFoundError, type VelobaseOptions, VelobaseValidationError, Velobase as default };

package/dist/index.d.ts

@@ -0,0 +1,140 @@
+interface HttpClientOptions {
+    baseUrl: string;
+    apiKey: string;
+    timeout: number;
+    maxRetries: number;
+}
+declare class HttpClient {
+    private baseUrl;
+    private apiKey;
+    private timeout;
+    private maxRetries;
+    constructor(opts: HttpClientOptions);
+    request<T>(method: string, path: string, body?: unknown, headers?: Record<string, string>): Promise<T>;
+}
+
+interface FreezeParams {
+    customerId: string;
+    amount: number;
+    businessId: string;
+    businessType?: string;
+    description?: string;
+}
+interface FreezeResponse {
+    businessId: string;
+    frozenAmount: number;
+    freezeDetails: unknown[];
+    isIdempotentReplay: boolean;
+}
+interface ConsumeParams {
+    businessId: string;
+    actualAmount?: number;
+}
+interface ConsumeResponse {
+    businessId: string;
+    consumedAmount: number;
+    returnedAmount?: number;
+    consumeDetails: unknown[];
+    consumedAt: string;
+    isIdempotentReplay: boolean;
+}
+interface UnfreezeParams {
+    businessId: string;
+}
+interface UnfreezeResponse {
+    businessId: string;
+    unfrozenAmount: number;
+    unfreezeDetails: unknown[];
+    unfrozenAt: string;
+    isIdempotentReplay: boolean;
+}
+interface DepositParams {
+    customerId: string;
+    amount: number;
+    idempotencyKey?: string;
+    name?: string | null;
+    email?: string | null;
+    metadata?: Record<string, unknown>;
+    description?: string;
+}
+interface DepositResponse {
+    customerId: string;
+    accountId: string;
+    totalAmount: number;
+    addedAmount: number;
+    recordId: string;
+    isIdempotentReplay: boolean;
+}
+interface CustomerBalance {
+    total: number;
+    used: number;
+    frozen: number;
+    available: number;
+}
+interface CustomerAccount {
+    accountType: string;
+    subAccountType: string;
+    total: number;
+    used: number;
+    frozen: number;
+    available: number;
+    startsAt: string | null;
+    expiresAt: string | null;
+}
+interface CustomerResponse {
+    id: string;
+    name: string | null;
+    email: string | null;
+    metadata: Record<string, unknown> | null;
+    balance: CustomerBalance;
+    accounts: CustomerAccount[];
+    createdAt: string;
+}
+interface VelobaseOptions {
+    apiKey: string;
+    baseUrl?: string;
+    timeout?: number;
+    maxRetries?: number;
+}
+
+declare class BillingResource {
+    private http;
+    constructor(http: HttpClient);
+    freeze(params: FreezeParams): Promise<FreezeResponse>;
+    consume(params: ConsumeParams): Promise<ConsumeResponse>;
+    unfreeze(params: UnfreezeParams): Promise<UnfreezeResponse>;
+}
+declare class CustomersResource {
+    private http;
+    constructor(http: HttpClient);
+    deposit(params: DepositParams): Promise<DepositResponse>;
+    get(customerId: string): Promise<CustomerResponse>;
+}
+declare class Velobase {
+    readonly billing: BillingResource;
+    readonly customers: CustomersResource;
+    constructor(opts: VelobaseOptions);
+}
+
+declare class VelobaseError extends Error {
+    status: number;
+    type: string;
+    constructor(message: string, status: number, type: string);
+}
+declare class VelobaseAuthenticationError extends VelobaseError {
+    constructor(message: string);
+}
+declare class VelobaseValidationError extends VelobaseError {
+    constructor(message: string);
+}
+declare class VelobaseNotFoundError extends VelobaseError {
+    constructor(message: string);
+}
+declare class VelobaseConflictError extends VelobaseError {
+    constructor(message: string);
+}
+declare class VelobaseInternalError extends VelobaseError {
+    constructor(message: string);
+}
+
+export { type ConsumeParams, type ConsumeResponse, type CustomerAccount, type CustomerBalance, type CustomerResponse, type DepositParams, type DepositResponse, type FreezeParams, type FreezeResponse, type UnfreezeParams, type UnfreezeResponse, Velobase, VelobaseAuthenticationError, VelobaseConflictError, VelobaseError, VelobaseInternalError, VelobaseNotFoundError, type VelobaseOptions, VelobaseValidationError, Velobase as default };

package/dist/index.js

@@ -0,0 +1,268 @@
+"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, {
+  Velobase: () => Velobase,
+  VelobaseAuthenticationError: () => VelobaseAuthenticationError,
+  VelobaseConflictError: () => VelobaseConflictError,
+  VelobaseError: () => VelobaseError,
+  VelobaseInternalError: () => VelobaseInternalError,
+  VelobaseNotFoundError: () => VelobaseNotFoundError,
+  VelobaseValidationError: () => VelobaseValidationError,
+  default: () => Velobase
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/errors.ts
+var VelobaseError = class extends Error {
+  status;
+  type;
+  constructor(message, status, type) {
+    super(message);
+    this.name = "VelobaseError";
+    this.status = status;
+    this.type = type;
+  }
+};
+var VelobaseAuthenticationError = class extends VelobaseError {
+  constructor(message) {
+    super(message, 401, "auth_error");
+    this.name = "VelobaseAuthenticationError";
+  }
+};
+var VelobaseValidationError = class extends VelobaseError {
+  constructor(message) {
+    super(message, 400, "validation_error");
+    this.name = "VelobaseValidationError";
+  }
+};
+var VelobaseNotFoundError = class extends VelobaseError {
+  constructor(message) {
+    super(message, 404, "not_found");
+    this.name = "VelobaseNotFoundError";
+  }
+};
+var VelobaseConflictError = class extends VelobaseError {
+  constructor(message) {
+    super(message, 409, "conflict");
+    this.name = "VelobaseConflictError";
+  }
+};
+var VelobaseInternalError = class extends VelobaseError {
+  constructor(message) {
+    super(message, 500, "server_error");
+    this.name = "VelobaseInternalError";
+  }
+};
+
+// src/http.ts
+function toSnakeCase(str) {
+  return str.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`);
+}
+function toCamelCase(str) {
+  return str.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+}
+function convertKeys(obj, converter) {
+  if (Array.isArray(obj)) {
+    return obj.map((item) => convertKeys(item, converter));
+  }
+  if (obj !== null && typeof obj === "object") {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+      result[converter(key)] = convertKeys(value, converter);
+    }
+    return result;
+  }
+  return obj;
+}
+function toSnakeCaseKeys(obj) {
+  return convertKeys(obj, toSnakeCase);
+}
+function toCamelCaseKeys(obj) {
+  return convertKeys(obj, toCamelCase);
+}
+function isRetryable(status) {
+  return status >= 500 || status === 429;
+}
+function throwForStatus(status, message, type) {
+  switch (status) {
+    case 400:
+      throw new VelobaseValidationError(message);
+    case 401:
+      throw new VelobaseAuthenticationError(message);
+    case 404:
+      throw new VelobaseNotFoundError(message);
+    case 409:
+      throw new VelobaseConflictError(message);
+    case 500:
+      throw new VelobaseInternalError(message);
+    default:
+      throw new VelobaseError(message, status, type);
+  }
+}
+var HttpClient = class {
+  baseUrl;
+  apiKey;
+  timeout;
+  maxRetries;
+  constructor(opts) {
+    this.baseUrl = opts.baseUrl.replace(/\/+$/, "");
+    this.apiKey = opts.apiKey;
+    this.timeout = opts.timeout;
+    this.maxRetries = opts.maxRetries;
+  }
+  async request(method, path, body, headers) {
+    const url = `${this.baseUrl}${path}`;
+    let lastError;
+    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+      if (attempt > 0) {
+        const delay = Math.min(500 * 2 ** (attempt - 1), 5e3);
+        await new Promise((r) => setTimeout(r, delay));
+      }
+      const controller = new AbortController();
+      const timer = setTimeout(() => controller.abort(), this.timeout);
+      try {
+        const res = await fetch(url, {
+          method,
+          headers: {
+            "Authorization": `Bearer ${this.apiKey}`,
+            "Content-Type": "application/json",
+            ...headers
+          },
+          body: body ? JSON.stringify(toSnakeCaseKeys(body)) : void 0,
+          signal: controller.signal
+        });
+        clearTimeout(timer);
+        if (!res.ok) {
+          const json2 = await res.json().catch(() => ({}));
+          const msg = json2.error?.message ?? `HTTP ${res.status}`;
+          const type = json2.error?.type ?? "unknown_error";
+          if (isRetryable(res.status) && attempt < this.maxRetries) {
+            lastError = new VelobaseError(msg, res.status, type);
+            continue;
+          }
+          throwForStatus(res.status, msg, type);
+        }
+        const json = await res.json();
+        return toCamelCaseKeys(json);
+      } catch (err) {
+        clearTimeout(timer);
+        if (err instanceof VelobaseError) {
+          throw err;
+        }
+        lastError = err;
+        if (attempt < this.maxRetries) {
+          continue;
+        }
+        throw new VelobaseError(
+          `Request failed: ${lastError.message}`,
+          0,
+          "network_error"
+        );
+      }
+    }
+    throw lastError;
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.velobase.io";
+var DEFAULT_TIMEOUT = 3e4;
+var DEFAULT_MAX_RETRIES = 2;
+var BillingResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  async freeze(params) {
+    return this.http.request(
+      "POST",
+      "/v1/billing/freeze",
+      params
+    );
+  }
+  async consume(params) {
+    return this.http.request(
+      "POST",
+      "/v1/billing/consume",
+      params
+    );
+  }
+  async unfreeze(params) {
+    return this.http.request(
+      "POST",
+      "/v1/billing/unfreeze",
+      params
+    );
+  }
+};
+var CustomersResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  async deposit(params) {
+    const headers = {};
+    if (params.idempotencyKey) {
+      headers["Idempotency-Key"] = params.idempotencyKey;
+    }
+    return this.http.request(
+      "POST",
+      "/v1/customers/deposit",
+      params,
+      headers
+    );
+  }
+  async get(customerId) {
+    return this.http.request(
+      "GET",
+      `/v1/customers/${encodeURIComponent(customerId)}`
+    );
+  }
+};
+var Velobase = class {
+  billing;
+  customers;
+  constructor(opts) {
+    if (!opts.apiKey) {
+      throw new Error(
+        "apiKey is required. Get your API key at https://velobase.io"
+      );
+    }
+    const http = new HttpClient({
+      baseUrl: opts.baseUrl ?? DEFAULT_BASE_URL,
+      apiKey: opts.apiKey,
+      timeout: opts.timeout ?? DEFAULT_TIMEOUT,
+      maxRetries: opts.maxRetries ?? DEFAULT_MAX_RETRIES
+    });
+    this.billing = new BillingResource(http);
+    this.customers = new CustomersResource(http);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Velobase,
+  VelobaseAuthenticationError,
+  VelobaseConflictError,
+  VelobaseError,
+  VelobaseInternalError,
+  VelobaseNotFoundError,
+  VelobaseValidationError
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/http.ts","../src/client.ts"],"sourcesContent":["export { Velobase } from \"./client\";\nexport {\n  VelobaseError,\n  VelobaseAuthenticationError,\n  VelobaseValidationError,\n  VelobaseNotFoundError,\n  VelobaseConflictError,\n  VelobaseInternalError,\n} from \"./errors\";\nexport type {\n  VelobaseOptions,\n  FreezeParams,\n  FreezeResponse,\n  ConsumeParams,\n  ConsumeResponse,\n  UnfreezeParams,\n  UnfreezeResponse,\n  DepositParams,\n  DepositResponse,\n  CustomerBalance,\n  CustomerAccount,\n  CustomerResponse,\n} from \"./types\";\n\n// default export for convenience\nexport { Velobase as default } from \"./client\";\n","export class VelobaseError extends Error {\n  status: number;\n  type: string;\n\n  constructor(message: string, status: number, type: string) {\n    super(message);\n    this.name = \"VelobaseError\";\n    this.status = status;\n    this.type = type;\n  }\n}\n\nexport class VelobaseAuthenticationError extends VelobaseError {\n  constructor(message: string) {\n    super(message, 401, \"auth_error\");\n    this.name = \"VelobaseAuthenticationError\";\n  }\n}\n\nexport class VelobaseValidationError extends VelobaseError {\n  constructor(message: string) {\n    super(message, 400, \"validation_error\");\n    this.name = \"VelobaseValidationError\";\n  }\n}\n\nexport class VelobaseNotFoundError extends VelobaseError {\n  constructor(message: string) {\n    super(message, 404, \"not_found\");\n    this.name = \"VelobaseNotFoundError\";\n  }\n}\n\nexport class VelobaseConflictError extends VelobaseError {\n  constructor(message: string) {\n    super(message, 409, \"conflict\");\n    this.name = \"VelobaseConflictError\";\n  }\n}\n\nexport class VelobaseInternalError extends VelobaseError {\n  constructor(message: string) {\n    super(message, 500, \"server_error\");\n    this.name = \"VelobaseInternalError\";\n  }\n}\n","import {\n  VelobaseAuthenticationError,\n  VelobaseConflictError,\n  VelobaseError,\n  VelobaseInternalError,\n  VelobaseNotFoundError,\n  VelobaseValidationError,\n} from \"./errors\";\n\nexport interface HttpClientOptions {\n  baseUrl: string;\n  apiKey: string;\n  timeout: number;\n  maxRetries: number;\n}\n\nfunction toSnakeCase(str: string): string {\n  return str.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`);\n}\n\nfunction toCamelCase(str: string): string {\n  return str.replace(/_([a-z])/g, (_, c: string) => c.toUpperCase());\n}\n\nfunction convertKeys(\n  obj: unknown,\n  converter: (key: string) => string,\n): unknown {\n  if (Array.isArray(obj)) {\n    return obj.map((item) => convertKeys(item, converter));\n  }\n  if (obj !== null && typeof obj === \"object\") {\n    const result: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(obj as Record<string, unknown>)) {\n      result[converter(key)] = convertKeys(value, converter);\n    }\n    return result;\n  }\n  return obj;\n}\n\nexport function toSnakeCaseKeys<T>(obj: T): unknown {\n  return convertKeys(obj, toSnakeCase);\n}\n\nexport function toCamelCaseKeys<T>(obj: T): unknown {\n  return convertKeys(obj, toCamelCase);\n}\n\nfunction isRetryable(status: number): boolean {\n  return status >= 500 || status === 429;\n}\n\nfunction throwForStatus(\n  status: number,\n  message: string,\n  type: string,\n): never {\n  switch (status) {\n    case 400:\n      throw new VelobaseValidationError(message);\n    case 401:\n      throw new VelobaseAuthenticationError(message);\n    case 404:\n      throw new VelobaseNotFoundError(message);\n    case 409:\n      throw new VelobaseConflictError(message);\n    case 500:\n      throw new VelobaseInternalError(message);\n    default:\n      throw new VelobaseError(message, status, type);\n  }\n}\n\nexport class HttpClient {\n  private baseUrl: string;\n  private apiKey: string;\n  private timeout: number;\n  private maxRetries: number;\n\n  constructor(opts: HttpClientOptions) {\n    this.baseUrl = opts.baseUrl.replace(/\\/+$/, \"\");\n    this.apiKey = opts.apiKey;\n    this.timeout = opts.timeout;\n    this.maxRetries = opts.maxRetries;\n  }\n\n  async request<T>(\n    method: string,\n    path: string,\n    body?: unknown,\n    headers?: Record<string, string>,\n  ): Promise<T> {\n    const url = `${this.baseUrl}${path}`;\n    let lastError: Error | undefined;\n\n    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {\n      if (attempt > 0) {\n        const delay = Math.min(500 * 2 ** (attempt - 1), 5000);\n        await new Promise((r) => setTimeout(r, delay));\n      }\n\n      const controller = new AbortController();\n      const timer = setTimeout(() => controller.abort(), this.timeout);\n\n      try {\n        const res = await fetch(url, {\n          method,\n          headers: {\n            \"Authorization\": `Bearer ${this.apiKey}`,\n            \"Content-Type\": \"application/json\",\n            ...headers,\n          },\n          body: body ? JSON.stringify(toSnakeCaseKeys(body)) : undefined,\n          signal: controller.signal,\n        });\n\n        clearTimeout(timer);\n\n        if (!res.ok) {\n          const json = (await res.json().catch(() => ({}))) as {\n            error?: { message?: string; type?: string };\n          };\n          const msg =\n            json.error?.message ?? `HTTP ${res.status}`;\n          const type = json.error?.type ?? \"unknown_error\";\n\n          if (isRetryable(res.status) && attempt < this.maxRetries) {\n            lastError = new VelobaseError(msg, res.status, type);\n            continue;\n          }\n\n          throwForStatus(res.status, msg, type);\n        }\n\n        const json = await res.json();\n        return toCamelCaseKeys(json) as T;\n      } catch (err) {\n        clearTimeout(timer);\n\n        if (err instanceof VelobaseError) {\n          throw err;\n        }\n\n        lastError = err as Error;\n\n        if (attempt < this.maxRetries) {\n          continue;\n        }\n\n        throw new VelobaseError(\n          `Request failed: ${lastError.message}`,\n          0,\n          \"network_error\",\n        );\n      }\n    }\n\n    throw lastError;\n  }\n}\n","import { HttpClient } from \"./http\";\nimport type {\n  ConsumeParams,\n  ConsumeResponse,\n  CustomerResponse,\n  DepositParams,\n  DepositResponse,\n  FreezeParams,\n  FreezeResponse,\n  UnfreezeParams,\n  UnfreezeResponse,\n  VelobaseOptions,\n} from \"./types\";\n\nconst DEFAULT_BASE_URL = \"https://api.velobase.io\";\nconst DEFAULT_TIMEOUT = 30_000;\nconst DEFAULT_MAX_RETRIES = 2;\n\nclass BillingResource {\n  constructor(private http: HttpClient) {}\n\n  async freeze(params: FreezeParams): Promise<FreezeResponse> {\n    return this.http.request<FreezeResponse>(\n      \"POST\",\n      \"/v1/billing/freeze\",\n      params,\n    );\n  }\n\n  async consume(params: ConsumeParams): Promise<ConsumeResponse> {\n    return this.http.request<ConsumeResponse>(\n      \"POST\",\n      \"/v1/billing/consume\",\n      params,\n    );\n  }\n\n  async unfreeze(params: UnfreezeParams): Promise<UnfreezeResponse> {\n    return this.http.request<UnfreezeResponse>(\n      \"POST\",\n      \"/v1/billing/unfreeze\",\n      params,\n    );\n  }\n}\n\nclass CustomersResource {\n  constructor(private http: HttpClient) {}\n\n  async deposit(params: DepositParams): Promise<DepositResponse> {\n    const headers: Record<string, string> = {};\n    if (params.idempotencyKey) {\n      headers[\"Idempotency-Key\"] = params.idempotencyKey;\n    }\n    return this.http.request<DepositResponse>(\n      \"POST\",\n      \"/v1/customers/deposit\",\n      params,\n      headers,\n    );\n  }\n\n  async get(customerId: string): Promise<CustomerResponse> {\n    return this.http.request<CustomerResponse>(\n      \"GET\",\n      `/v1/customers/${encodeURIComponent(customerId)}`,\n    );\n  }\n}\n\nexport class Velobase {\n  readonly billing: BillingResource;\n  readonly customers: CustomersResource;\n\n  constructor(opts: VelobaseOptions) {\n    if (!opts.apiKey) {\n      throw new Error(\n        \"apiKey is required. Get your API key at https://velobase.io\",\n      );\n    }\n\n    const http = new HttpClient({\n      baseUrl: opts.baseUrl ?? DEFAULT_BASE_URL,\n      apiKey: opts.apiKey,\n      timeout: opts.timeout ?? DEFAULT_TIMEOUT,\n      maxRetries: opts.maxRetries ?? DEFAULT_MAX_RETRIES,\n    });\n\n    this.billing = new BillingResource(http);\n    this.customers = new CustomersResource(http);\n  }\n}\n"],"mappings":"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","names":["json"]}

package/dist/index.mjs

@@ -0,0 +1,235 @@
+// src/errors.ts
+var VelobaseError = class extends Error {
+  status;
+  type;
+  constructor(message, status, type) {
+    super(message);
+    this.name = "VelobaseError";
+    this.status = status;
+    this.type = type;
+  }
+};
+var VelobaseAuthenticationError = class extends VelobaseError {
+  constructor(message) {
+    super(message, 401, "auth_error");
+    this.name = "VelobaseAuthenticationError";
+  }
+};
+var VelobaseValidationError = class extends VelobaseError {
+  constructor(message) {
+    super(message, 400, "validation_error");
+    this.name = "VelobaseValidationError";
+  }
+};
+var VelobaseNotFoundError = class extends VelobaseError {
+  constructor(message) {
+    super(message, 404, "not_found");
+    this.name = "VelobaseNotFoundError";
+  }
+};
+var VelobaseConflictError = class extends VelobaseError {
+  constructor(message) {
+    super(message, 409, "conflict");
+    this.name = "VelobaseConflictError";
+  }
+};
+var VelobaseInternalError = class extends VelobaseError {
+  constructor(message) {
+    super(message, 500, "server_error");
+    this.name = "VelobaseInternalError";
+  }
+};
+
+// src/http.ts
+function toSnakeCase(str) {
+  return str.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`);
+}
+function toCamelCase(str) {
+  return str.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+}
+function convertKeys(obj, converter) {
+  if (Array.isArray(obj)) {
+    return obj.map((item) => convertKeys(item, converter));
+  }
+  if (obj !== null && typeof obj === "object") {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+      result[converter(key)] = convertKeys(value, converter);
+    }
+    return result;
+  }
+  return obj;
+}
+function toSnakeCaseKeys(obj) {
+  return convertKeys(obj, toSnakeCase);
+}
+function toCamelCaseKeys(obj) {
+  return convertKeys(obj, toCamelCase);
+}
+function isRetryable(status) {
+  return status >= 500 || status === 429;
+}
+function throwForStatus(status, message, type) {
+  switch (status) {
+    case 400:
+      throw new VelobaseValidationError(message);
+    case 401:
+      throw new VelobaseAuthenticationError(message);
+    case 404:
+      throw new VelobaseNotFoundError(message);
+    case 409:
+      throw new VelobaseConflictError(message);
+    case 500:
+      throw new VelobaseInternalError(message);
+    default:
+      throw new VelobaseError(message, status, type);
+  }
+}
+var HttpClient = class {
+  baseUrl;
+  apiKey;
+  timeout;
+  maxRetries;
+  constructor(opts) {
+    this.baseUrl = opts.baseUrl.replace(/\/+$/, "");
+    this.apiKey = opts.apiKey;
+    this.timeout = opts.timeout;
+    this.maxRetries = opts.maxRetries;
+  }
+  async request(method, path, body, headers) {
+    const url = `${this.baseUrl}${path}`;
+    let lastError;
+    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+      if (attempt > 0) {
+        const delay = Math.min(500 * 2 ** (attempt - 1), 5e3);
+        await new Promise((r) => setTimeout(r, delay));
+      }
+      const controller = new AbortController();
+      const timer = setTimeout(() => controller.abort(), this.timeout);
+      try {
+        const res = await fetch(url, {
+          method,
+          headers: {
+            "Authorization": `Bearer ${this.apiKey}`,
+            "Content-Type": "application/json",
+            ...headers
+          },
+          body: body ? JSON.stringify(toSnakeCaseKeys(body)) : void 0,
+          signal: controller.signal
+        });
+        clearTimeout(timer);
+        if (!res.ok) {
+          const json2 = await res.json().catch(() => ({}));
+          const msg = json2.error?.message ?? `HTTP ${res.status}`;
+          const type = json2.error?.type ?? "unknown_error";
+          if (isRetryable(res.status) && attempt < this.maxRetries) {
+            lastError = new VelobaseError(msg, res.status, type);
+            continue;
+          }
+          throwForStatus(res.status, msg, type);
+        }
+        const json = await res.json();
+        return toCamelCaseKeys(json);
+      } catch (err) {
+        clearTimeout(timer);
+        if (err instanceof VelobaseError) {
+          throw err;
+        }
+        lastError = err;
+        if (attempt < this.maxRetries) {
+          continue;
+        }
+        throw new VelobaseError(
+          `Request failed: ${lastError.message}`,
+          0,
+          "network_error"
+        );
+      }
+    }
+    throw lastError;
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.velobase.io";
+var DEFAULT_TIMEOUT = 3e4;
+var DEFAULT_MAX_RETRIES = 2;
+var BillingResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  async freeze(params) {
+    return this.http.request(
+      "POST",
+      "/v1/billing/freeze",
+      params
+    );
+  }
+  async consume(params) {
+    return this.http.request(
+      "POST",
+      "/v1/billing/consume",
+      params
+    );
+  }
+  async unfreeze(params) {
+    return this.http.request(
+      "POST",
+      "/v1/billing/unfreeze",
+      params
+    );
+  }
+};
+var CustomersResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  async deposit(params) {
+    const headers = {};
+    if (params.idempotencyKey) {
+      headers["Idempotency-Key"] = params.idempotencyKey;
+    }
+    return this.http.request(
+      "POST",
+      "/v1/customers/deposit",
+      params,
+      headers
+    );
+  }
+  async get(customerId) {
+    return this.http.request(
+      "GET",
+      `/v1/customers/${encodeURIComponent(customerId)}`
+    );
+  }
+};
+var Velobase = class {
+  billing;
+  customers;
+  constructor(opts) {
+    if (!opts.apiKey) {
+      throw new Error(
+        "apiKey is required. Get your API key at https://velobase.io"
+      );
+    }
+    const http = new HttpClient({
+      baseUrl: opts.baseUrl ?? DEFAULT_BASE_URL,
+      apiKey: opts.apiKey,
+      timeout: opts.timeout ?? DEFAULT_TIMEOUT,
+      maxRetries: opts.maxRetries ?? DEFAULT_MAX_RETRIES
+    });
+    this.billing = new BillingResource(http);
+    this.customers = new CustomersResource(http);
+  }
+};
+export {
+  Velobase,
+  VelobaseAuthenticationError,
+  VelobaseConflictError,
+  VelobaseError,
+  VelobaseInternalError,
+  VelobaseNotFoundError,
+  VelobaseValidationError,
+  Velobase as default
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/http.ts","../src/client.ts"],"sourcesContent":["export class VelobaseError extends Error {\n  status: number;\n  type: string;\n\n  constructor(message: string, status: number, type: string) {\n    super(message);\n    this.name = \"VelobaseError\";\n    this.status = status;\n    this.type = type;\n  }\n}\n\nexport class VelobaseAuthenticationError extends VelobaseError {\n  constructor(message: string) {\n    super(message, 401, \"auth_error\");\n    this.name = \"VelobaseAuthenticationError\";\n  }\n}\n\nexport class VelobaseValidationError extends VelobaseError {\n  constructor(message: string) {\n    super(message, 400, \"validation_error\");\n    this.name = \"VelobaseValidationError\";\n  }\n}\n\nexport class VelobaseNotFoundError extends VelobaseError {\n  constructor(message: string) {\n    super(message, 404, \"not_found\");\n    this.name = \"VelobaseNotFoundError\";\n  }\n}\n\nexport class VelobaseConflictError extends VelobaseError {\n  constructor(message: string) {\n    super(message, 409, \"conflict\");\n    this.name = \"VelobaseConflictError\";\n  }\n}\n\nexport class VelobaseInternalError extends VelobaseError {\n  constructor(message: string) {\n    super(message, 500, \"server_error\");\n    this.name = \"VelobaseInternalError\";\n  }\n}\n","import {\n  VelobaseAuthenticationError,\n  VelobaseConflictError,\n  VelobaseError,\n  VelobaseInternalError,\n  VelobaseNotFoundError,\n  VelobaseValidationError,\n} from \"./errors\";\n\nexport interface HttpClientOptions {\n  baseUrl: string;\n  apiKey: string;\n  timeout: number;\n  maxRetries: number;\n}\n\nfunction toSnakeCase(str: string): string {\n  return str.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`);\n}\n\nfunction toCamelCase(str: string): string {\n  return str.replace(/_([a-z])/g, (_, c: string) => c.toUpperCase());\n}\n\nfunction convertKeys(\n  obj: unknown,\n  converter: (key: string) => string,\n): unknown {\n  if (Array.isArray(obj)) {\n    return obj.map((item) => convertKeys(item, converter));\n  }\n  if (obj !== null && typeof obj === \"object\") {\n    const result: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(obj as Record<string, unknown>)) {\n      result[converter(key)] = convertKeys(value, converter);\n    }\n    return result;\n  }\n  return obj;\n}\n\nexport function toSnakeCaseKeys<T>(obj: T): unknown {\n  return convertKeys(obj, toSnakeCase);\n}\n\nexport function toCamelCaseKeys<T>(obj: T): unknown {\n  return convertKeys(obj, toCamelCase);\n}\n\nfunction isRetryable(status: number): boolean {\n  return status >= 500 || status === 429;\n}\n\nfunction throwForStatus(\n  status: number,\n  message: string,\n  type: string,\n): never {\n  switch (status) {\n    case 400:\n      throw new VelobaseValidationError(message);\n    case 401:\n      throw new VelobaseAuthenticationError(message);\n    case 404:\n      throw new VelobaseNotFoundError(message);\n    case 409:\n      throw new VelobaseConflictError(message);\n    case 500:\n      throw new VelobaseInternalError(message);\n    default:\n      throw new VelobaseError(message, status, type);\n  }\n}\n\nexport class HttpClient {\n  private baseUrl: string;\n  private apiKey: string;\n  private timeout: number;\n  private maxRetries: number;\n\n  constructor(opts: HttpClientOptions) {\n    this.baseUrl = opts.baseUrl.replace(/\\/+$/, \"\");\n    this.apiKey = opts.apiKey;\n    this.timeout = opts.timeout;\n    this.maxRetries = opts.maxRetries;\n  }\n\n  async request<T>(\n    method: string,\n    path: string,\n    body?: unknown,\n    headers?: Record<string, string>,\n  ): Promise<T> {\n    const url = `${this.baseUrl}${path}`;\n    let lastError: Error | undefined;\n\n    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {\n      if (attempt > 0) {\n        const delay = Math.min(500 * 2 ** (attempt - 1), 5000);\n        await new Promise((r) => setTimeout(r, delay));\n      }\n\n      const controller = new AbortController();\n      const timer = setTimeout(() => controller.abort(), this.timeout);\n\n      try {\n        const res = await fetch(url, {\n          method,\n          headers: {\n            \"Authorization\": `Bearer ${this.apiKey}`,\n            \"Content-Type\": \"application/json\",\n            ...headers,\n          },\n          body: body ? JSON.stringify(toSnakeCaseKeys(body)) : undefined,\n          signal: controller.signal,\n        });\n\n        clearTimeout(timer);\n\n        if (!res.ok) {\n          const json = (await res.json().catch(() => ({}))) as {\n            error?: { message?: string; type?: string };\n          };\n          const msg =\n            json.error?.message ?? `HTTP ${res.status}`;\n          const type = json.error?.type ?? \"unknown_error\";\n\n          if (isRetryable(res.status) && attempt < this.maxRetries) {\n            lastError = new VelobaseError(msg, res.status, type);\n            continue;\n          }\n\n          throwForStatus(res.status, msg, type);\n        }\n\n        const json = await res.json();\n        return toCamelCaseKeys(json) as T;\n      } catch (err) {\n        clearTimeout(timer);\n\n        if (err instanceof VelobaseError) {\n          throw err;\n        }\n\n        lastError = err as Error;\n\n        if (attempt < this.maxRetries) {\n          continue;\n        }\n\n        throw new VelobaseError(\n          `Request failed: ${lastError.message}`,\n          0,\n          \"network_error\",\n        );\n      }\n    }\n\n    throw lastError;\n  }\n}\n","import { HttpClient } from \"./http\";\nimport type {\n  ConsumeParams,\n  ConsumeResponse,\n  CustomerResponse,\n  DepositParams,\n  DepositResponse,\n  FreezeParams,\n  FreezeResponse,\n  UnfreezeParams,\n  UnfreezeResponse,\n  VelobaseOptions,\n} from \"./types\";\n\nconst DEFAULT_BASE_URL = \"https://api.velobase.io\";\nconst DEFAULT_TIMEOUT = 30_000;\nconst DEFAULT_MAX_RETRIES = 2;\n\nclass BillingResource {\n  constructor(private http: HttpClient) {}\n\n  async freeze(params: FreezeParams): Promise<FreezeResponse> {\n    return this.http.request<FreezeResponse>(\n      \"POST\",\n      \"/v1/billing/freeze\",\n      params,\n    );\n  }\n\n  async consume(params: ConsumeParams): Promise<ConsumeResponse> {\n    return this.http.request<ConsumeResponse>(\n      \"POST\",\n      \"/v1/billing/consume\",\n      params,\n    );\n  }\n\n  async unfreeze(params: UnfreezeParams): Promise<UnfreezeResponse> {\n    return this.http.request<UnfreezeResponse>(\n      \"POST\",\n      \"/v1/billing/unfreeze\",\n      params,\n    );\n  }\n}\n\nclass CustomersResource {\n  constructor(private http: HttpClient) {}\n\n  async deposit(params: DepositParams): Promise<DepositResponse> {\n    const headers: Record<string, string> = {};\n    if (params.idempotencyKey) {\n      headers[\"Idempotency-Key\"] = params.idempotencyKey;\n    }\n    return this.http.request<DepositResponse>(\n      \"POST\",\n      \"/v1/customers/deposit\",\n      params,\n      headers,\n    );\n  }\n\n  async get(customerId: string): Promise<CustomerResponse> {\n    return this.http.request<CustomerResponse>(\n      \"GET\",\n      `/v1/customers/${encodeURIComponent(customerId)}`,\n    );\n  }\n}\n\nexport class Velobase {\n  readonly billing: BillingResource;\n  readonly customers: CustomersResource;\n\n  constructor(opts: VelobaseOptions) {\n    if (!opts.apiKey) {\n      throw new Error(\n        \"apiKey is required. Get your API key at https://velobase.io\",\n      );\n    }\n\n    const http = new HttpClient({\n      baseUrl: opts.baseUrl ?? DEFAULT_BASE_URL,\n      apiKey: opts.apiKey,\n      timeout: opts.timeout ?? DEFAULT_TIMEOUT,\n      maxRetries: opts.maxRetries ?? DEFAULT_MAX_RETRIES,\n    });\n\n    this.billing = new BillingResource(http);\n    this.customers = new CustomersResource(http);\n  }\n}\n"],"mappings":"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","names":["json"]}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@velobaseai/billing",
+  "version": "0.1.0",
+  "description": "Velobase Billing SDK for JavaScript/TypeScript",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "velobase",
+    "billing",
+    "credits",
+    "api",
+    "sdk"
+  ],
+  "author": "Velobase",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/velobase/billing-sdk-js.git"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.5.0"
+  }
+}