Node.js / TypeScript SDK
Official Node.js / TypeScript SDK on npm as @beel_es/sdk, fully typed from the spec.
ChangelogNew
The official BeeL. SDK for Node.js and TypeScript is now published on npm as @beel_es/sdk. It is fully typed from the OpenAPI spec, with automatic retries, idempotency keys, typed errors, and webhook signature verification built in.
What else changed
- Install with
npm install @beel_es/sdk— Node.js 18+, ships both ESM and CommonJS with a single runtime dependency. - Fully-typed client auto-generated from the OpenAPI spec — invoices, customers, products, configuration, series, and NIF validation.
- Automatic retries with exponential backoff on 429 and 5xx, plus auto idempotency keys on every POST so retries never create duplicates.
- Typed errors — catch
BeeLNotFoundError,BeeLValidationError, and friends instead of checking status codes. - Webhook signature verification with HMAC-SHA256 and PDF download as a Buffer.