Stripe-connect-reckon – a read-only monitor for Stripe Connect balance risk

I worked on a marketplace where a connected account went negative, Stripe suspended its payouts, and refunds silently queued as pending — no error, no alert, discovered via a customer complaint.

stripe-connect-reckon is a small read-only TypeScript library that watches connected accounts and reports issues with severity:

• NEGATIVE_BALANCE_RISK (per-currency)


• FAILED_PAYOUT


• UNRECONCILED_REFUND (vs. the state your app reports)


• EVENT_GAP (within Stripe's 30-day events window)

Design notes:

• Read-only by design: only calls list/retrieve endpoints, never writes. v0 takes no corrective action on purpose.


• Clean architecture: a pure core (no I/O, no stripe import) behind a thin read-only adapter, so detection is unit-tested with fixtures and zero network (47 tests).


• Not a sync engine — it works a level up: read, evaluate, report.
  Pinned to stripe-node v22 / API version 2026-06-24.dahlia. Dual ESM+CJS, MIT.


• It's v0.1.0 and honest about its limits (two detectors need your app's state; the event window is 30 days; it never remediates). I'd love feedback on what other read-only signals are worth catching.

npm: