@beel_es/sdk 2.5.0 → 2.6.0

package/CHANGELOG.md

@@ -7,6 +7,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.6.0] - 2026-11-09
+
+Contract resynced with the API contract of the next release and types regenerated. Publish it
+once that contract is in production: until then the new routes answer `404`.
+
+### Added
+- **Invoice replies.** `beel.company(companyId).invoiceReplies` with `list`, `create`, `get`,
+  `delete` and `getAttachment`, over `/v1/companies/{company_id}/invoice-replies`. Each
+  attachment carries `id`, a relative `url` and `file_expires_at`; `getAttachment` returns a
+  temporary `download_url` and its `download_url_expires_at`, both `null` when there is no file
+  to download.
+- Webhook events `invoice.reply.received` and `invoice.reply.deleted` are typed
+  (`InvoiceReplyReceivedEvent`, `InvoiceReplyDeletedEvent`) and narrow on `event.type`.
+- The webhook contract is resynced too: `WebhookEventType` gains `invoice.reply.*`,
+  `connection.*` and `email_domain.*`. Only the reply events have their own event type so far.
+- **Company connections.** Typed routes for `/v1/companies/{company_id}/connections` (list,
+  create, get, delete). Not yet wrapped as resource methods.
+
 ## [2.5.0] - 2026-11-07
 
 Contract resynced with the API as it runs in production today and types regenerated.

package/README.md

@@ -311,6 +311,34 @@ await events.resolve('event-uuid');
 await company.paymentConnections.disconnect(connections[0].id);
 ```
 
+### Invoice replies
+
+Replies of your customers about an invoice, on any channel. The list masks personal data;
+`get` returns the full text. An attachment gives a temporary `download_url` for its file,
+requested on each call: ask again rather than storing it. It is `null` when there is no file
+to download.
+
+```typescript
+const { replies } = await company.invoiceReplies.list({ invoice_id: 'invoice-uuid' });
+const reply = await company.invoiceReplies.get(replies[0].id);
+
+const attachment = await company.invoiceReplies.getAttachment(reply.id, reply.attachments![0].id);
+if (attachment.download_url) {
+  const file = await fetch(attachment.download_url); // expires at download_url_expires_at
+}
+
+// A message received on a channel of your own
+await company.invoiceReplies.create({
+  invoice_id: 'invoice-uuid',
+  channel: 'WHATSAPP',
+  external_id: 'wamid.EXAMPLE0001',
+  sender: { address: '+34600123456' },
+  text: 'Can you send it to Distribuciones Ejemplo S.L.?',
+});
+
+await company.invoiceReplies.delete(reply.id); // erases its content
+```
+
 ## Catalogs and preferences
 
 ```typescript