@beel_es/sdk 1.3.0 → 2.1.0

package/docs/reference/products.md

@@ -0,0 +1,111 @@
+<!-- Generated by `npm run docs:reference` from the SDK source and openapi/public-api.yaml. Do not edit. -->
+
+# `beel.products` — `ProductsResource`
+
+[Reference index](README.md)
+
+> **Deprecated.** The contract deprecates the session-focus routes. Use `beel.company(companyId).products` instead.
+
+Products of the focused company, on the flat `/v1/products` routes.
+
+## Methods
+
+| Method | HTTP | Summary |
+|---|---|---|
+| [`beel.products.list(params?)`](#products-list) | `GET /v1/products` | List products with optional filters and pagination. |
+| [`beel.products.create(body)`](#products-create) | `POST /v1/products` | Create a new product or service. |
+| [`beel.products.get(id)`](#products-get) | `GET /v1/products/{product_id}` | Get a product by ID. |
+| [`beel.products.update(id, body)`](#products-update) | `PUT /v1/products/{product_id}` | Update a product. |
+| [`beel.products.delete(id)`](#products-delete) | `DELETE /v1/products/{product_id}` | Delete a product permanently. |
+| [`beel.products.search(q, limit?)`](#products-search) | `GET /v1/products/search` | Search products by name or code. |
+
+<a id="products-list"></a>
+### `list(params?)`
+
+List products with optional filters and pagination.
+
+- **HTTP:** `GET /v1/products` · operation `listProducts` · scopes `products:read` · **deprecated in the contract**
+- **Parameters:**
+  - `params?: ListParams` — Filters and pagination.
+- **Returns:** The page of `products` and its `pagination`. Response `200` `data`: `{ products: Product[]; pagination: Pagination }`.
+- **Throws:** `401`/`403` `BeeLAuthError` · `422` `BeeLValidationError` · `500` `BeeLApiError`
+
+**Example**
+
+```typescript
+const { products, pagination } = await beel.products.list({ category: 'SERVICE' });
+```
+
+<a id="products-create"></a>
+### `create(body)`
+
+Create a new product or service.
+
+- **HTTP:** `POST /v1/products` · operation `createProduct` · scopes `products:write` · accepts `Idempotency-Key` · **deprecated in the contract**
+- **Parameters:**
+  - `body: components['schemas']['CreateProductRequest']` — Name, category, price and main tax.
+- **Returns:** The created product. Response `201` `data`: `Product`.
+- **Throws:** `400`/`500` `BeeLApiError` · `401`/`403` `BeeLAuthError` · `409` `BeeLConflictError` · `422` `BeeLValidationError`
+
+**Example**
+
+```typescript
+const product = await beel.products.create({
+  name: 'Consulting',
+  code: 'CONS-001',
+  category: 'SERVICE',
+  default_price: 100,
+  main_tax: { type: 'IVA', percentage: 21 },
+});
+```
+
+<a id="products-get"></a>
+### `get(id)`
+
+Get a product by ID.
+
+- **HTTP:** `GET /v1/products/{product_id}` · operation `getProduct` · scopes `products:read` · **deprecated in the contract**
+- **Parameters:**
+  - `id: string` — Product UUID.
+- **Returns:** The product. Response `200` `data`: `Product`.
+- **Throws:** `400`/`500` `BeeLApiError` · `401`/`403` `BeeLAuthError` · `404` `BeeLNotFoundError`
+
+<a id="products-update"></a>
+### `update(id, body)`
+
+Update a product. Only provided fields are changed.
+
+- **HTTP:** `PUT /v1/products/{product_id}` · operation `updateProduct` · scopes `products:write` · **deprecated in the contract**
+- **Parameters:**
+  - `id: string` — Product UUID.
+  - `body: components['schemas']['UpdateProductRequest']` — Fields to change.
+- **Returns:** The updated product. Response `200` `data`: `Product`.
+- **Throws:** `400`/`500` `BeeLApiError` · `401`/`403` `BeeLAuthError` · `404` `BeeLNotFoundError` · `409` `BeeLConflictError` · `422` `BeeLValidationError`
+
+<a id="products-delete"></a>
+### `delete(id)`
+
+Delete a product permanently.
+
+- **HTTP:** `DELETE /v1/products/{product_id}` · operation `deleteProduct` · scopes `products:write` · **deprecated in the contract**
+- **Parameters:**
+  - `id: string` — Product UUID.
+- **Throws:** `401`/`403` `BeeLAuthError` · `404` `BeeLNotFoundError` · `500` `BeeLApiError`
+
+<a id="products-search"></a>
+### `search(q, limit?)`
+
+Search products by name or code. Returns up to `limit` results.
+
+- **HTTP:** `GET /v1/products/search` · operation `searchProducts` · scopes `products:read` · **deprecated in the contract**
+- **Parameters:**
+  - `q: string` — Text to search in name or code.
+  - `limit?: number` — Maximum results.
+- **Returns:** The matching products, as a bare array. Response `200` `data`: `Product[]`.
+- **Throws:** `400`/`500` `BeeLApiError` · `401`/`403` `BeeLAuthError` · `422` `BeeLValidationError`
+
+**Example**
+
+```typescript
+const results = await beel.products.search('consulting', 5);
+```

package/docs/reference/series.md

@@ -0,0 +1,81 @@
+<!-- Generated by `npm run docs:reference` from the SDK source and openapi/public-api.yaml. Do not edit. -->
+
+# `beel.series` — `SeriesResource`
+
+[Reference index](README.md)
+
+> **Deprecated.** The contract deprecates the session-focus routes. Use `beel.company(companyId).series` instead.
+
+Invoice series of the focused company, on the flat `/v1/configuration/series` routes.
+
+## Methods
+
+| Method | HTTP | Summary |
+|---|---|---|
+| [`beel.series.list(active?)`](#series-list) | `GET /v1/configuration/series` | List all invoice series. |
+| [`beel.series.create(body)`](#series-create) | `POST /v1/configuration/series` | Create a new invoice series (e.g. "A-2026", "RECT"). |
+| [`beel.series.update(id, body)`](#series-update) | `PUT /v1/configuration/series/{series_id}` | Update a series (name, description, etc.). |
+| [`beel.series.delete(id)`](#series-delete) | `DELETE /v1/configuration/series/{series_id}` | Delete an invoice series. |
+| [`beel.series.setDefault(id)`](#series-set-default) | `POST /v1/configuration/series/{series_id}/default` | Set a series as the default for new invoices. |
+
+<a id="series-list"></a>
+### `list(active?)`
+
+List all invoice series. Optionally filter by active status.
+
+- **HTTP:** `GET /v1/configuration/series` · operation `listSeries` · scopes `series:read` · **deprecated in the contract**
+- **Parameters:**
+  - `active?: boolean` — Only active (`true`) or inactive (`false`) series; all when omitted.
+- **Returns:** The series. Response `200` `data`: `{ series: InvoiceSeries[]; pagination?: Pagination }`.
+- **Throws:** `401`/`403` `BeeLAuthError` · `422` `BeeLValidationError` · `500` `BeeLApiError`
+
+**Example**
+
+```typescript
+const series = await beel.series.list();
+const activeSeries = await beel.series.list(true);
+```
+
+<a id="series-create"></a>
+### `create(body)`
+
+Create a new invoice series (e.g. "A-2026", "RECT").
+
+- **HTTP:** `POST /v1/configuration/series` · operation `createSeries` · scopes `series:write` · accepts `Idempotency-Key` · **deprecated in the contract**
+- **Parameters:**
+  - `body: any` — Code, name and format.
+- **Returns:** The created series. Response `201` `data`: `InvoiceSeries`.
+- **Throws:** `400`/`500` `BeeLApiError` · `401`/`403` `BeeLAuthError` · `409` `BeeLConflictError` · `422` `BeeLValidationError`
+
+<a id="series-update"></a>
+### `update(id, body)`
+
+Update a series (name, description, etc.).
+
+- **HTTP:** `PUT /v1/configuration/series/{series_id}` · operation `updateSeries` · scopes `series:write` · **deprecated in the contract**
+- **Parameters:**
+  - `id: string` — Series UUID.
+  - `body: any` — Fields to change.
+- **Returns:** The updated series. Response `200` `data`: `InvoiceSeries`.
+- **Throws:** `400`/`500` `BeeLApiError` · `401`/`403` `BeeLAuthError` · `404` `BeeLNotFoundError` · `422` `BeeLValidationError`
+
+<a id="series-delete"></a>
+### `delete(id)`
+
+Delete an invoice series. Only empty series can be deleted.
+
+- **HTTP:** `DELETE /v1/configuration/series/{series_id}` · operation `deleteSeries` · scopes `series:write` · **deprecated in the contract**
+- **Parameters:**
+  - `id: string` — Series UUID.
+- **Throws:** `400`/`500` `BeeLApiError` · `401`/`403` `BeeLAuthError` · `404` `BeeLNotFoundError`
+
+<a id="series-set-default"></a>
+### `setDefault(id)`
+
+Set a series as the default for new invoices.
+
+- **HTTP:** `POST /v1/configuration/series/{series_id}/default` · operation `setDefaultSeries` · scopes `series:write` · accepts `Idempotency-Key` · **deprecated in the contract**
+- **Parameters:**
+  - `id: string` — Series UUID.
+- **Returns:** The series. Response `200` `data`: `InvoiceSeries`.
+- **Throws:** `400`/`500` `BeeLApiError` · `401`/`403` `BeeLAuthError` · `404` `BeeLNotFoundError` · `409` `BeeLConflictError`

package/docs/reference/types.md

@@ -0,0 +1,222 @@
+<!-- Generated by `npm run docs:reference` from the SDK source and openapi/public-api.yaml. Do not edit. -->
+
+# Types
+
+[Reference index](README.md)
+
+Types defined by the SDK. The API's own types are generated from the contract: `import type { components, operations, paths } from '@beel_es/sdk'`.
+
+<a id="beelconfig"></a>
+## `BeeLConfig`
+
+Options of `new BeeL(config)`. Only `apiKey` is required.
+
+**Retries and idempotency.** A call is retried automatically, up to `maxRetries` times,
+only when sending it again can never apply it twice:
+
+- `429` is always retried, after `Retry-After`: the API refused the request unprocessed.
+- `409 IDEMPOTENCY_KEY_PROCESSING` is retried with the same key after `Retry-After`.
+- `5xx` and network errors are retried for `GET` requests and for requests that carry an
+  `Idempotency-Key` — every `POST` does, unless `autoIdempotencyKey` is `false`. A `5xx`
+  the API marks `Idempotency-Replay: true` is the stored outcome of that key and is not
+  retried: the same key would return it again.
+- `PUT`, `PATCH` and `DELETE` without a key are not retried after a `5xx` or network error.
+
+Every retry of a call reuses that call's `Idempotency-Key`, so an automatic retry never
+creates a second invoice. Two separate calls get two keys: to retry a create yourself
+after it failed with a `5xx` or a network error, use `invoices.createOnce`, or look the
+invoice up by `external_ref` before creating it again.
+
+| Field | Type | Description |
+|---|---|---|
+| `apiKey` | `string` | API key: `beel_sk_live_*` (production) or `beel_sk_test_*` (sandbox). |
+| `baseUrl?` | `string` | Base URL. Default: `https://app.beel.es/api`. |
+| `maxRetries?` | `number` | Automatic retries after the first attempt, for the cases listed on `BeeLConfig`. `0` disables them. Default: `3`. |
+| `retryDelayMs?` | `number` | Base delay of the exponential backoff, in milliseconds. Default: `500`. |
+| `maxRetryDelayMs?` | `number` | Upper bound of any single wait between attempts, `Retry-After` included, in ms. Default: `30000`. |
+| `autoIdempotencyKey?` | `boolean` | Add one `Idempotency-Key` (a UUID) to every `POST` that does not carry its own, reused by every automatic retry of that call. With `false`, a `POST` without a key is only retried after a `429`. Default: `true`. |
+
+<a id="requestoptions"></a>
+## `RequestOptions`
+
+Per-call options, accepted as the last argument of the `company.invoices` methods.
+
+| Field | Type | Description |
+|---|---|---|
+| `idempotencyKey?` | `string` | `Idempotency-Key` of this call, instead of the automatic one: letters, digits, `_` and `-`, up to 255 characters. Every automatic retry of the call reuses it. Persist it with your order to retry the same operation later: within 24 hours the API replays the first `2xx` or `5xx` answer instead of running the operation again. |
+| `signal?` | `AbortSignal` | Aborts the call — the automatic retries and the waits between them included. |
+| `timeoutMs?` | `number` | Aborts the call after this many milliseconds, automatic retries included. |
+
+**Example**
+
+```typescript
+await company.invoices.create(body, undefined, {
+  idempotencyKey: `order-${order.id}`,
+  timeoutMs: 15_000,
+});
+```
+
+<a id="beelerrorcode"></a>
+## `BeeLErrorCode`
+
+One of the `BeeLErrorCodes` values.
+
+```typescript
+type BeeLErrorCode = (typeof BeeLErrorCodes)[keyof typeof BeeLErrorCodes]
+```
+
+<a id="webhookevent"></a>
+## `WebhookEvent`
+
+Union type of all possible webhook events
+
+```typescript
+type WebhookEvent = | VeriFactuStatusUpdatedEvent | InvoiceIssuedEvent | InvoiceVoidedEvent | InvoiceEmailSentEvent | InvoicePdfGeneratedEvent | InvoiceScheduleFailedEvent | RecurringInvoicePausedEvent | AccountClaimedEvent | CompanyCreatedEvent | RepresentationSignedEvent | WebhookTestEvent
+```
+
+<a id="webhookeventenvelope"></a>
+## `WebhookEventEnvelope`
+
+Fields every delivery carries, whatever its type.
+
+```typescript
+type WebhookEventEnvelope = Omit<GeneratedEnvelope, 'type'> & { type: `${WebhookEventType}` }
+```
+
+<a id="verifactustatusupdatedevent"></a>
+## `VeriFactuStatusUpdatedEvent`
+
+`verifactu.status.updated`: AEAT answered for an invoice's VeriFactu record (`new_status`, `qr_url`…).
+
+```typescript
+type VeriFactuStatusUpdatedEvent = BusinessEvent<'verifactu.status.updated', WebhookEventDataVeriFactuStatusUpdated>
+```
+
+<a id="invoiceissuedevent"></a>
+## `InvoiceIssuedEvent`
+
+`invoice.issued`: an invoice was issued.
+
+```typescript
+type InvoiceIssuedEvent = BusinessEvent<'invoice.issued', WebhookEventDataInvoiceIssued>
+```
+
+<a id="invoicevoidedevent"></a>
+## `InvoiceVoidedEvent`
+
+`invoice.voided`: an invoice was voided.
+
+```typescript
+type InvoiceVoidedEvent = BusinessEvent<'invoice.voided', WebhookEventDataInvoiceVoided>
+```
+
+<a id="invoiceemailsentevent"></a>
+## `InvoiceEmailSentEvent`
+
+`invoice.email.sent`: an invoice email was accepted by the email provider.
+
+```typescript
+type InvoiceEmailSentEvent = BusinessEvent<'invoice.email.sent', WebhookEventDataInvoiceEmailSent>
+```
+
+<a id="invoicepdfgeneratedevent"></a>
+## `InvoicePdfGeneratedEvent`
+
+`invoice.pdf.generated`: the PDF of an invoice is ready.
+
+```typescript
+type InvoicePdfGeneratedEvent = BusinessEvent<'invoice.pdf.generated', WebhookEventDataInvoicePdfGenerated>
+```
+
+<a id="invoiceschedulefailedevent"></a>
+## `InvoiceScheduleFailedEvent`
+
+`invoice.schedule_failed`: a scheduled invoice could not be processed.
+
+```typescript
+type InvoiceScheduleFailedEvent = BusinessEvent<'invoice.schedule_failed', WebhookEventDataInvoiceScheduleFailed>
+```
+
+<a id="recurringinvoicepausedevent"></a>
+## `RecurringInvoicePausedEvent`
+
+`recurring_invoice.paused`: a recurring invoice was paused.
+
+```typescript
+type RecurringInvoicePausedEvent = BusinessEvent<'recurring_invoice.paused', WebhookEventDataRecurringInvoicePaused>
+```
+
+<a id="accountclaimedevent"></a>
+## `AccountClaimedEvent`
+
+`account.claimed`: the holder of a provisioned account took ownership.
+
+```typescript
+type AccountClaimedEvent = BusinessEvent<'account.claimed', WebhookEventDataAccountClaimed>
+```
+
+<a id="companycreatedevent"></a>
+## `CompanyCreatedEvent`
+
+`company.created`: a company (NIF) was created.
+
+```typescript
+type CompanyCreatedEvent = BusinessEvent<'company.created', WebhookEventDataCompanyCreated>
+```
+
+<a id="representationsignedevent"></a>
+## `RepresentationSignedEvent`
+
+`representation.signed`: a representation document was signed.
+
+```typescript
+type RepresentationSignedEvent = BusinessEvent<'representation.signed', WebhookEventDataRepresentationSigned>
+```
+
+<a id="webhooktestevent"></a>
+## `WebhookTestEvent`
+
+A delivery sent with "Send test": `test` is `true` and `data` is a synthetic message,
+whatever `type` says. Check `event.test` before narrowing on `event.type`.
+
+```typescript
+type WebhookTestEvent = Omit<GeneratedEnvelope, 'type' | 'test'> & { type: `${WebhookEventType}`; test: true; data: WebhookEventDataTest; }
+```
+
+<a id="external_ref_unique_invoice_types"></a>
+## `EXTERNAL_REF_UNIQUE_INVOICE_TYPES`
+
+Invoice types whose `external_ref` the API keeps unique: at most one live (not deleted)
+invoice of these types per reference and environment, whatever its status — a `VOIDED`
+one included. Correctives are exempt, and proformas are not covered.
+
+| Key | Value | Description |
+|---|---|---|
+
+<a id="createinvoiceoncerequest"></a>
+## `CreateInvoiceOnceRequest`
+
+Body of `invoices.createOnce`: a `CreateInvoiceRequest` whose `type` is `STANDARD` or
+`SIMPLIFIED` and whose `external_ref` is required — it is what makes the call safe to repeat.
+
+```typescript
+type CreateInvoiceOnceRequest = Omit<CreateInvoiceRequest, 'type' | 'external_ref'> & { type: ExternalRefUniqueInvoiceType; external_ref: string; }
+```
+
+<a id="createinvoiceonceparams"></a>
+## `CreateInvoiceOnceParams`
+
+Query of `invoices.createOnce`: the same as `invoices.create`.
+
+```typescript
+type CreateInvoiceOnceParams = operations['createCompanyInvoice']['parameters']['query']
+```
+
+<a id="externalrefuniqueinvoicetype"></a>
+## `ExternalRefUniqueInvoiceType`
+
+Invoice types `createInvoiceOnce` accepts.
+
+```typescript
+type ExternalRefUniqueInvoiceType = (typeof EXTERNAL_REF_UNIQUE_INVOICE_TYPES)[number]
+```

package/docs/reference/webhook-verifier.md

@@ -0,0 +1,95 @@
+<!-- Generated by `npm run docs:reference` from the SDK source and openapi/public-api.yaml. Do not edit. -->
+
+# `WebhookVerifier`
+
+[Reference index](README.md)
+
+Webhook signature verification for BeeL webhooks
+
+Every webhook delivery includes a `BeeL-Signature` header that must be verified
+to ensure the webhook came from BeeL and hasn't been tampered with.
+
+### Security Requirements
+
+1. **Always verify** the signature before processing the webhook
+2. **Use constant-time comparison** to prevent timing attacks
+3. **Reject old events** (older than 5 minutes)
+4. **Use raw request body** (before parsing JSON)
+
+### Header Format
+
+```
+BeeL-Signature: t=1741362026,v1=3c4f7a2e1b9d8e7f6a5b4c3d2e1f0a9b8c7d6e5f4a3b2c1d0e9f8a7b6c5d4e3f
+```
+
+Where:
+- `t` = Unix timestamp when the webhook was sent
+- `v1` = HMAC-SHA256 signature of the payload
+
+**Example — Express.js**
+
+```typescript
+import express from 'express';
+import { WebhookVerifier } from '@beel_es/sdk';
+
+const verifier = new WebhookVerifier('your_webhook_secret');
+
+app.post('/webhooks/beel', express.raw({ type: 'application/json' }), (req, res) => {
+  const signature = req.headers['beel-signature'] as string;
+  const rawBody = req.body.toString('utf8');
+
+  try {
+    const event = verifier.verify(rawBody, signature);
+
+    if (event.type === 'verifactu.status.updated') {
+      console.log('VeriFactu status:', event.data.new_status);
+      if (event.data.new_status === 'ACCEPTED') {
+        console.log('QR URL:', event.data.qr_url);
+      }
+    }
+
+    res.status(200).send('OK');
+  } catch (error) {
+    console.error('Invalid webhook:', error.message);
+    res.status(400).send('Invalid signature');
+  }
+});
+```
+
+## Constructor
+
+```typescript
+new WebhookVerifier(secret: string, toleranceSeconds?: number)
+```
+
+Creates a new WebhookVerifier
+
+## Methods
+
+| Method | HTTP | Summary |
+|---|---|---|
+| [`WebhookVerifier.verify(rawBody, signatureHeader)`](#webhook-verifier-verify) | via `parseSignatureHeader`, `computeSignature`, `secureCompare` | Verify a webhook signature and return the parsed event |
+
+<a id="webhook-verifier-verify"></a>
+### `verify(rawBody, signatureHeader)`
+
+Verify a webhook signature and return the parsed event
+
+- **Parameters:**
+  - `rawBody: string | Buffer` — Raw request body (string or Buffer, before JSON parsing)
+  - `signatureHeader: string | undefined` — Value of the `BeeL-Signature` header
+- **Returns:** Parsed webhook event
+- **Throws:** `WebhookVerificationError` If signature is invalid or event is too old
+
+**Example — Basic usage**
+
+```typescript
+const verifier = new WebhookVerifier('your_secret');
+const event = verifier.verify(rawBody, signature);
+
+if (event.test) return; // a "Send test" delivery carries a synthetic `data`
+if (event.type === 'verifactu.status.updated') {
+  console.log('Invoice:', event.data.invoice_number);
+  console.log('Status:', event.data.new_status);
+}
+```

package/llms.txt

@@ -0,0 +1,52 @@
+# @beel_es/sdk
+
+> Official Node.js/TypeScript SDK for the BeeL invoicing API (Spain, VeriFactu). Read these
+> Markdown files instead of `dist/index.d.ts`: every method, its HTTP operation, parameters,
+> return shape and errors are documented here, generated from the source and the contract.
+
+## Start here
+
+- [README](README.md): client setup and common tasks — find the company id, create and issue
+  invoices, correctives, `external_ref` lookups, VeriFactu status, retries and idempotency.
+- [Reference index](docs/reference/README.md): every resource and method in one table.
+
+## Rules that prevent duplicate invoices
+
+- Always address a company explicitly: `beel.company(companyId)`.
+- Set `external_ref` on every invoice you create from your own order, and create it with
+  `beel.company(id).invoices.createOnce(body)`: it is safe to call again after any failure.
+- Automatic retries reuse the call's `Idempotency-Key`; they never create a second invoice.
+  Do not disable them to write your own unless you reuse one key per operation.
+
+## Reference pages
+
+- [beel](docs/reference/client.md): The BeeL API client.
+- [beel.account(accountId)](docs/reference/account.md): Operations scoped to one account: its companies (NIFs), members, invitations, webhooks and usage.
+- [beel.account(accountId).companies](docs/reference/account-companies.md): Companies (NIFs) of an account — where the `companyId` of `beel.company(companyId)` comes from.
+- [beel.account(accountId).invitations](docs/reference/account-invitations.md): Invitations to join an account.
+- [beel.account(accountId).members](docs/reference/account-members.md): Members of an account and their per-company grants.
+- [beel.account(accountId).webhooks](docs/reference/account-webhooks.md): Webhook subscriptions of an account.
+- [beel.accounts](docs/reference/accounts.md): Accounts you provisioned and manage (multi-account provisioning for platforms and advisory firms).
+- [beel.catalogs](docs/reference/catalogs.md): Account-wide catalogs, the credential's identity and personal preferences, on their canonical paths.
+- [beel.company(companyId)](docs/reference/company.md): Operations scoped to a single company (NIF).
+- [beel.company(companyId).customers](docs/reference/company-customers.md): Customers of one company.
+- [beel.company(companyId).invoices](docs/reference/company-invoices.md): Invoice lifecycle of one company: create a draft (or issue it directly), issue, void, correct, list and read, PDF and email.
+- [beel.company(companyId).invoices.schedule](docs/reference/company-invoices-schedule.md): Scheduled issuing of one invoice: read it, set it, clear it.
+- [beel.company(companyId).paymentConnections](docs/reference/company-payment-connections.md): Payment connections of a company (NIF): the Stripe Connect link whose charges auto-generate invoices under that NIF.
+- [beel.company(companyId).paymentConnections.events(connectionId)](docs/reference/company-payment-connections-events.md): Payment events received through a connection, and the recovery levers for the ones that did not produce an invoice.
+- [beel.company(companyId).products](docs/reference/company-products.md): Products and services of one company.
+- [beel.company(companyId).recurringInvoices](docs/reference/company-recurring-invoices.md): Recurring invoice templates of one company.
+- [beel.company(companyId).series](docs/reference/company-series.md): Invoice series (numbering) of one company.
+- [beel.company(companyId).taxConfiguration](docs/reference/company-tax-configuration.md): Tax defaults of one company (main tax, IRPF, equivalence surcharge).
+- [beel.company(companyId).verifactuConfiguration](docs/reference/company-verifactu-configuration.md): VeriFactu configuration of one company.
+- [beel.nif](docs/reference/nif.md): NIF validation against the AEAT register.
+- [CustomerBuilder](docs/reference/customer-builder.md): Fluent builder for the body of `customers.create`.
+- [InvoiceBuilder](docs/reference/invoice-builder.md): Fluent builder for the body of `invoices.create`.
+- [WebhookVerifier](docs/reference/webhook-verifier.md): Webhook signature verification for BeeL webhooks
+- [beel.configuration](docs/reference/configuration.md) (deprecated): Account-wide configuration on the flat `/v1/configuration/*` routes.
+- [beel.customers](docs/reference/customers.md) (deprecated): Customers of the focused company, on the flat `/v1/customers` routes.
+- [beel.invoices](docs/reference/invoices.md) (deprecated): Invoices of the focused company, on the flat `/v1/invoices` routes.
+- [beel.products](docs/reference/products.md) (deprecated): Products of the focused company, on the flat `/v1/products` routes.
+- [beel.series](docs/reference/series.md) (deprecated): Invoice series of the focused company, on the flat `/v1/configuration/series` routes.
+- [Errors](docs/reference/errors.md): error classes and codes.
+- [Types](docs/reference/types.md): exported interfaces and constants.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beel_es/sdk",
-  "version": "1.3.0",
+  "version": "2.1.0",
   "description": "Official Node.js SDK for BeeL Public API - Spanish invoicing platform with VeriFactu support",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -14,20 +14,26 @@
   },
   "files": [
     "dist",
+    "docs/reference",
+    "llms.txt",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE"
   ],
   "scripts": {
-    "generate": "npx openapi-typescript openapi/public-api.yaml -o src/generated/schema.ts",
+    "generate": "node scripts/generate-types.mjs",
     "generate:webhooks": "npx openapi-typescript-codegen -i openapi/webhook-receiver-api.yaml -o src/generated-webhooks --client fetch",
     "build": "tsup",
+    "typecheck": "tsc --noEmit -p .",
     "build:full": "npm run generate && npm run generate:webhooks && npm run build",
     "dev": "tsup --watch",
     "check:deprecated": "node scripts/check-deprecated.mjs",
-    "test": "npm run check:deprecated && npm run check:coverage && vitest run",
+    "test": "npm run check:deprecated && npm run check:coverage && npm run check:reference && vitest run",
     "test:e2e": "vitest run --config vitest.e2e.config.ts",
     "prepublishOnly": "npm run build:full && npm test",
-    "check:coverage": "node scripts/check-coverage.mjs"
+    "check:coverage": "node scripts/check-coverage.mjs",
+    "docs:reference": "node scripts/generate-reference.mjs",
+    "check:reference": "node scripts/generate-reference.mjs --check"
   },
   "keywords": [
     "beel",
@@ -53,6 +59,7 @@
   "homepage": "https://beel.es",
   "devDependencies": {
     "@types/node": "^22.19.15",
+    "js-yaml": "^4.3.2",
     "openapi-typescript": "^7.13.0",
     "openapi-typescript-codegen": "^0.30.0",
     "tsup": "^8.5.1",