janus-ledger

TypeScript gRPC client for the Janus double-entry accounting engine.

Install

npm install janus-ledger

Quick Start

import { LedgerClient } from 'janus-ledger';

const ledger = new LedgerClient('your-janus-server:50051');

await ledger.createEntity({ externalId: 'org-1', name: 'Acme Corp' });

await ledger.createBook({ name: 'Cash', type: 'asset', currency: 'USD', entityExternalId: 'org-1' });
await ledger.createBook({ name: 'Revenue', type: 'liability', currency: 'USD', entityExternalId: 'org-1' });

const entry = await ledger.createJournalEntry({
  idempotencyKey: 'sale-001',
  bookEntries: [
    { book: 'cash', debit: 10000 },
    { book: 'revenue', credit: 10000 },
  ],
});

const balance = await ledger.getBalance('cash');
console.log(`Cash balance: ${balance.balance} ${balance.currency}`);

ledger.close();

License

MIT