# Open-source TypeScript SDK

2026-07-21

The official BioFlow TypeScript SDK is open source. It wraps the full /v1 surface with types generated from the OpenAPI spec, a typed RFC 9457 error hierarchy, automatic retries with auto-generated idempotency keys, cursor-pagination helpers, and a Standard Webhooks verifier. The source was published on GitHub first; the npm package followed on 14 August 2026.

## Added

- SDK source published at github.com/DevinoSolutions/bioflow-node under the MIT licence.
- Types generated from the same OpenAPI 3.1 spec the API serves — a spec-drift gate keeps them byte-honest.
- Typed error hierarchy: every RFC 9457 problem code becomes a typed error class you can catch on.
- Safe automatic retries: idempotency keys are generated for consequential POSTs before the first attempt.
- Cursor pagination helpers (for-await iteration over data/has_more/next_cursor envelopes).
- verifyWebhook: Standard Webhooks v1 signature verification returning a typed event union.

## Changed

- The webhooks guide now shows SDK-based verification alongside the raw Node.js crypto variant.

Back to the changelog: https://getbioflow.com/changelog