@temboplus/afloat

Type-safe client library for the TemboPlus-Afloat API. Repository classes wrap each resource (wallets, payouts, beneficiaries, profile, team members, identity, auth) so consumers never talk to HTTP directly.

Quick Start

bun add @temboplus/afloat
# or: npm install @temboplus/afloat

import { AuthRepository, WalletRepository } from "@temboplus/afloat";

// 1. Log in. The returned User contains the token.
const authRepo = new AuthRepository();
const user = await authRepo.logIn("[email protected]", "password123");

// 2. Pass the token to any other repository.
const walletRepo = new WalletRepository({ token: user.token });
const [wallet] = await walletRepo.getWallets();

Usage

afloat is session-agnostic — it does not own login state or export an auth singleton. Your application logs in, stores the token, and passes it into every authenticated repository.

const repo = new SomeRepository({
  token: "user-auth-token",
  root: "https://api.afloat.money/v1", // optional override
});

Available repositories:

• AuthRepository — logIn, updatePassword, getAccessList
• WalletRepository — wallets, balances, statements
• PayoutRepository — create, approve, reject, list, count
• BeneficiaryRepository — create, edit, remove, lookup
• ProfileRepository — current profile
• TeamMemberRepository — team members and roles
• IdentityRepository — authenticated /login/me

Permissions

The User returned by logIn carries the permission set:

import { Permissions, PayoutRepository } from "@temboplus/afloat";

if (user.can(Permissions.Payout.Create)) {
  const payoutRepo = new PayoutRepository({ token: user.token });
  await payoutRepo.pay(input);
}

Server-side usage

Repositories work on the server too — extract the bearer token from the incoming request and pass it through:

import { WalletRepository } from "@temboplus/afloat";

app.get("/api/wallets", async (req, res) => {
  const token = req.headers.authorization?.replace(/^Bearer\s+/i, "");
  if (!token) return res.status(401).json({ error: "Unauthorized" });

  const walletRepo = new WalletRepository({ token });
  return res.json({ wallets: await walletRepo.getWallets() });
});

Consumed By

• TemboPlus Afloat (Next.js frontend) — customer-facing app.
• TemboPlus Reports (NestJS backend) — Afloat-specific report generation.

Development

Bun for everything, Biome for lint+format, mise for the toolchain pin.

mise install        # one-time: installs pinned Bun
bun install
bun run dev         # rollup build in watch mode

| Script | Does | | --- | --- | | bun run dev | Rollup build in watch mode | | bun run build | Rollup build to dist/ (CJS + ESM + .d.ts) | | bun run test | bun:test (passes with zero tests; smoke test only) | | bun run lint | Biome check | | bun run format | Biome auto-fix | | bun run typecheck | tsc --noEmit |

Tag-driven releases via .github/workflows/release.yml — update CHANGELOG.md, bump package.json, push a vX.Y.Z tag.

License

MIT © TemboPlus