@jazadev/node

Official Node.js backend SDK for Jaza prepaid / metered billing.

Install

npm install @jazadev/node

Quickstart

import { Jaza } from '@jazadev/node';

const jaza = new Jaza({
  secretKey: process.env.JAZA_SECRET_KEY!, // jz_test_sk_…
  publicKey: process.env.JAZA_PUBLIC_KEY!, // jz_test_pk_…
  // apiBaseUrl: 'http://localhost:3001', // local jaza-api
});

// 1. Create a customer once; store customer.id in your DB
const customer = await jaza.createCustomer({
  name: 'Amina Okello',
  email: '[email protected]', // and/or phoneNumber
});

// 2. Issue a top-up JWT for your frontend SDK
const session = await jaza.topUp({ customerId: customer.id });
// Pass session.token + jaza.publicKey to @jazadev/react-native (JazaProvider + JazaTopUpButton).
// Frontend: X-Jaza-Public-Key + Authorization: Bearer <token>
// → bundles, predict, quote, deposits via @jazadev/react-native

// 3. Read balance (for your app’s getBalance BFF → @jazadev/react-native)
const wallet = await jaza.getBalance({ customerId: customer.id });
console.log(wallet.balanceCredits);

// 4. Meter usage
await jaza.consume({
  customerId: customer.id,
  featureCode: 'SEND_MESSAGE',
  idempotencyKey: `msg_${Date.now()}`,
});

// 5. Poll top-up session status
const status = await jaza.check({ topUpId: session.id });
console.log(status.status); // PENDING until deposits complete

API surface

| Method | Description | |--------|-------------| | createCustomer({ name, email?, phoneNumber? }) | Returns cus_… | | topUp({ customerId }) | Returns session + JWT token | | getBalance({ customerId }) | Wallet with balanceCredits | | consume({ customerId, featureCode \| credits, idempotencyKey }) | Debit wallet | | check({ topUpId }) | Session status |

Errors throw JazaError with statusCode, code, and raw.

License

MIT