@botozap/sdk 0.1.0 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +26 -0
- package/README.md +31 -3
- package/dist/index.cjs +35 -2
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +50 -1
- package/dist/index.d.ts +50 -1
- package/dist/index.js +35 -2
- package/dist/index.js.map +1 -1
- package/package.json +2 -1
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# @botozap/sdk
|
|
2
|
+
|
|
3
|
+
## 0.2.0 (2026-08-13)
|
|
4
|
+
|
|
5
|
+
### Novidades
|
|
6
|
+
|
|
7
|
+
- **`media.get(id)`** — busca os metadados de uma mídia RECEBIDA pelo `media_id`
|
|
8
|
+
da Cloud API (`GET /v1/media/:id`), incluindo `download_url` (URL assinada e
|
|
9
|
+
efêmera, válida até `expires_at`). Novo tipo exportado: `MediaAsset`.
|
|
10
|
+
- **Erro distinguível em 2xx** — um corpo `{ error }` agora lança `BotoZapError`
|
|
11
|
+
mesmo com status 2xx. Caso concreto: o 202 `media_not_ready` de `media.get`
|
|
12
|
+
(mídia ainda sendo espelhada) vira um erro com `code: "media_not_ready"` e o
|
|
13
|
+
segundo que falta em `err.headers["retry-after"]`, em vez de passar como
|
|
14
|
+
sucesso malformado.
|
|
15
|
+
|
|
16
|
+
### Notas
|
|
17
|
+
|
|
18
|
+
- `GET /v1/media/:id/download` (302 para a mesma URL assinada) não ganha método
|
|
19
|
+
dedicado de propósito: `download_url` já entrega a URL sem o hop de redirect.
|
|
20
|
+
|
|
21
|
+
## 0.1.0 (2026-07-15)
|
|
22
|
+
|
|
23
|
+
Primeira versão pública: `messages`, `customers`, `templates`, `broadcasts`,
|
|
24
|
+
`contacts`, `conversations`, `webhooks`, `phoneNumbers`, `flows`, `media.upload`,
|
|
25
|
+
`users`, `apiLogs`, `webhookDeliveries`; desempacote de `{ data }`, paginação por
|
|
26
|
+
cursor/offset e `BotoZapError` com headers da resposta.
|
package/README.md
CHANGED
|
@@ -4,8 +4,6 @@ SDK oficial da [BotoZap](https://botozap.com.br) para Node.js. Envie mensagens e
|
|
|
4
4
|
|
|
5
5
|
O core da plataforma é fechado. Este cliente é a camada pública sobre a API HTTP: um envelope fino, tipado, sem dependências de runtime.
|
|
6
6
|
|
|
7
|
-
> **Ainda não publicado no npm — em preparação.** O pacote está em migração para o monorepo `botozap-js`; o comando de instalação abaixo passará a funcionar quando a primeira versão for publicada.
|
|
8
|
-
|
|
9
7
|
## Status: preview `0.x`
|
|
10
8
|
|
|
11
9
|
- Versão `0.x`, **sem promessa de estabilidade de API**: métodos e tipos podem
|
|
@@ -94,6 +92,36 @@ const customer = await boto.customers.get("uuid-do-cliente");
|
|
|
94
92
|
const { data: templates } = await boto.templates.list();
|
|
95
93
|
```
|
|
96
94
|
|
|
95
|
+
## Mídia
|
|
96
|
+
|
|
97
|
+
Suba um arquivo (a BotoZap baixa da URL, com guard SSRF, e envia à Cloud API) e
|
|
98
|
+
use o `media_id` numa mensagem:
|
|
99
|
+
|
|
100
|
+
```ts
|
|
101
|
+
const up = await boto.media.upload({
|
|
102
|
+
source: "https://exemplo.com/foto.png",
|
|
103
|
+
phone_number_id,
|
|
104
|
+
});
|
|
105
|
+
// up.target.media_id → usável no envio
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
Para uma mídia **recebida**, busque metadados e a URL de download pelo `media_id`
|
|
109
|
+
da Cloud API. A mídia é espelhada de forma assíncrona: se ainda não terminou, o
|
|
110
|
+
método lança `BotoZapError` com `code: "media_not_ready"` (202) e você retenta,
|
|
111
|
+
respeitando o `Retry-After`:
|
|
112
|
+
|
|
113
|
+
```ts
|
|
114
|
+
try {
|
|
115
|
+
const media = await boto.media.get(mediaId);
|
|
116
|
+
// media.download_url é uma URL assinada e efêmera — baixe direto (GET).
|
|
117
|
+
} catch (err) {
|
|
118
|
+
if (err instanceof BotoZapError && err.code === "media_not_ready") {
|
|
119
|
+
const wait = Number(err.headers?.["retry-after"] ?? 5);
|
|
120
|
+
// aguarde `wait` segundos e tente de novo
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
```
|
|
124
|
+
|
|
97
125
|
## Retornos e paginação
|
|
98
126
|
|
|
99
127
|
O SDK **desempacota o envelope `{ data }`** da API pra você:
|
|
@@ -178,7 +206,7 @@ O SDK cobre os recursos da API `/v1`:
|
|
|
178
206
|
- `webhooks` — CRUD e teste
|
|
179
207
|
- `phoneNumbers` — listar, buscar, remover, saúde (a rota de update não expõe campos editáveis, então o SDK não tem `phoneNumbers.update`)
|
|
180
208
|
- `flows` — criar, versionar, publicar, data endpoint (as operações por flow exigem `phone_number_id`, que amarra o flow à sua WABA)
|
|
181
|
-
- `media` — subir arquivo
|
|
209
|
+
- `media` — subir arquivo (obter um media_id) e **buscar metadados + URL de download** de uma mídia recebida
|
|
182
210
|
- `users`, `apiLogs`, `webhookDeliveries` — leitura
|
|
183
211
|
|
|
184
212
|
```ts
|
package/dist/index.cjs
CHANGED
|
@@ -582,6 +582,38 @@ var Media = class {
|
|
|
582
582
|
body: params
|
|
583
583
|
});
|
|
584
584
|
}
|
|
585
|
+
/**
|
|
586
|
+
* Busca os metadados de uma mídia RECEBIDA pelo `media_id` da Cloud API,
|
|
587
|
+
* incluindo `download_url` — uma URL assinada e efêmera que você pode baixar
|
|
588
|
+
* direto (GET), válida até `expires_at`.
|
|
589
|
+
*
|
|
590
|
+
* A mídia é espelhada de forma assíncrona; se você consultar antes de terminar,
|
|
591
|
+
* a rota responde 202 e este método lança `BotoZapError` com
|
|
592
|
+
* `code: "media_not_ready"`. Nesse caso, aguarde e retente — o segundo que faltar
|
|
593
|
+
* está em `err.headers?.["retry-after"]`:
|
|
594
|
+
*
|
|
595
|
+
* ```ts
|
|
596
|
+
* try {
|
|
597
|
+
* const media = await boto.media.get("wamid_media_id");
|
|
598
|
+
* // baixe media.download_url direto
|
|
599
|
+
* } catch (err) {
|
|
600
|
+
* if (err instanceof BotoZapError && err.code === "media_not_ready") {
|
|
601
|
+
* const wait = Number(err.headers?.["retry-after"] ?? 5);
|
|
602
|
+
* // retente após `wait` segundos
|
|
603
|
+
* }
|
|
604
|
+
* }
|
|
605
|
+
* ```
|
|
606
|
+
*
|
|
607
|
+
* Existe também `GET /v1/media/:id/download`, que responde 302 redirecionando
|
|
608
|
+
* para a mesma URL assinada; não há método SDK dedicado porque `download_url`
|
|
609
|
+
* (acima) já entrega essa URL sem o hop de redirect.
|
|
610
|
+
*/
|
|
611
|
+
get(id) {
|
|
612
|
+
return this.client.requestItem(
|
|
613
|
+
"GET",
|
|
614
|
+
`/media/${encodeURIComponent(id)}`
|
|
615
|
+
);
|
|
616
|
+
}
|
|
585
617
|
};
|
|
586
618
|
|
|
587
619
|
// src/resources/read-only.ts
|
|
@@ -713,8 +745,9 @@ var BotoZap = class {
|
|
|
713
745
|
}
|
|
714
746
|
const raw = await res.text();
|
|
715
747
|
const data = raw ? safeJson(raw) : void 0;
|
|
716
|
-
|
|
717
|
-
|
|
748
|
+
const envelope = data;
|
|
749
|
+
const hasErrorEnvelope = typeof envelope === "object" && envelope !== null && typeof envelope.error === "object" && envelope.error !== null;
|
|
750
|
+
if (!res.ok || hasErrorEnvelope) {
|
|
718
751
|
const headers = {};
|
|
719
752
|
res.headers.forEach((value, key) => {
|
|
720
753
|
headers[key] = value;
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/resources/messages.ts","../src/resources/customers.ts","../src/resources/templates.ts","../src/resources/broadcasts.ts","../src/resources/contacts.ts","../src/resources/conversations.ts","../src/resources/webhooks.ts","../src/resources/phone-numbers.ts","../src/resources/flows.ts","../src/resources/media.ts","../src/resources/read-only.ts","../src/client.ts"],"sourcesContent":["export { BotoZap } from \"./client.js\";\nexport type { BotoZapOptions, RequestOptions } from \"./client.js\";\nexport { BotoZapError } from \"./errors.js\";\n\nexport type {\n SendTextParams,\n SendTemplateParams,\n ListMessagesParams,\n} from \"./resources/messages.js\";\nexport type {\n CreateCustomerParams,\n UpdateCustomerParams,\n CreateSetupLinkParams,\n UpdateSetupLinkParams,\n} from \"./resources/customers.js\";\nexport type {\n Template,\n ListTemplatesParams,\n CreateTemplateParams,\n} from \"./resources/templates.js\";\nexport type {\n ListBroadcastsParams,\n CreateBroadcastParams,\n UpdateBroadcastParams,\n ScheduleBroadcastParams,\n ListRecipientsParams,\n AddRecipientsResult,\n} from \"./resources/broadcasts.js\";\nexport type { ListContactsParams, CreateContactParams } from \"./resources/contacts.js\";\nexport type {\n ListConversationsParams,\n CreateAssignmentParams,\n} from \"./resources/conversations.js\";\nexport type { CreateWebhookParams } from \"./resources/webhooks.js\";\nexport type { ListPhoneNumbersParams } from \"./resources/phone-numbers.js\";\nexport type {\n CreateFlowParams,\n ListFlowsParams,\n FlowPhoneParams,\n CreateFlowVersionParams,\n SetFlowDataEndpointParams,\n} from \"./resources/flows.js\";\nexport type { UploadMediaParams } from \"./resources/media.js\";\nexport type {\n ListApiLogsParams,\n ListWebhookDeliveriesParams,\n} from \"./resources/read-only.js\";\n\nexport type {\n MessageStatus,\n SendResult,\n TemplatePayload,\n CursorPaging,\n OffsetMeta,\n CursorList,\n OffsetList,\n CursorParams,\n OffsetParams,\n Customer,\n Message,\n Broadcast,\n BroadcastRecipient,\n Contact,\n Conversation,\n Assignment,\n Webhook,\n PhoneNumber,\n Flow,\n FlowVersion,\n User,\n ApiLog,\n WebhookDelivery,\n MediaUploadResult,\n SetupLink,\n} from \"./types.js\";\n","/**\n * Erro lançado quando a API responde fora da faixa 2xx. Carrega o envelope\n * de erro da BotoZap: { error: { code, message } }, mais o status HTTP e, quando\n * houve resposta HTTP (status > 0), os headers dela — úteis num 429 para ler\n * `Retry-After` / `X-RateLimit-*`. Os headers são só os da RESPOSTA; nenhum\n * header de request (que carrega a apiKey) entra aqui.\n */\nexport class BotoZapError extends Error {\n readonly code: string;\n readonly status: number;\n /** Headers da resposta HTTP. Ausente em erros sem resposta (status 0). */\n readonly headers?: Record<string, string>;\n\n constructor(\n code: string,\n message: string,\n status: number,\n headers?: Record<string, string>,\n ) {\n super(message);\n this.name = \"BotoZapError\";\n this.code = code;\n this.status = status;\n this.headers = headers;\n }\n}\n","import type { BotoZap } from \"../client.js\";\nimport { BotoZapError } from \"../errors.js\";\nimport type {\n CursorList,\n CursorParams,\n Message,\n SendResult,\n TemplatePayload,\n} from \"../types.js\";\n\n/** Filtros de `messages.list` (paginação por cursor). Ver GET /v1/messages. */\nexport interface ListMessagesParams extends CursorParams {\n /** id da Meta OU uuid interno do número. */\n phone_number_id?: string;\n /** uuid interno da conversa (o `id` de /v1/conversations). */\n conversation_id?: string;\n direction?: \"inbound\" | \"outbound\";\n /** enum message_status (ex.: \"sent\", \"delivered\", \"read\", \"failed\"). */\n status?: string;\n /** enum message_kind (ex.: \"text\", \"image\", \"template\"). */\n message_type?: string;\n /** true = só mensagens com mídia; false = só sem mídia. */\n has_media?: boolean;\n}\n\nexport interface SendTextParams {\n /** Número de destino em E.164, ex: \"+5531988887777\". */\n to: string;\n /** Corpo do texto. */\n text: string;\n /** phone_number_id de origem (obrigatório se a conta tem mais de um número). */\n from?: string;\n}\n\nexport interface SendTemplateParams {\n to: string;\n template: TemplatePayload;\n from?: string;\n}\n\n/** Endpoints de mensagem (POST /v1/messages, GET /v1/messages/:id). */\nexport class Messages {\n constructor(private readonly client: BotoZap) {}\n\n /** Envia uma mensagem de texto. */\n async send(params: SendTextParams): Promise<SendResult> {\n const result = await this.client.requestObject<SendResult>(\"POST\", \"/messages\", {\n body: {\n to: params.to,\n type: \"text\",\n text: { body: params.text },\n from: params.from,\n },\n });\n return assertSendResult(result);\n }\n\n /** Envia uma mensagem usando um template aprovado. */\n async sendTemplate(params: SendTemplateParams): Promise<SendResult> {\n const result = await this.client.requestObject<SendResult>(\"POST\", \"/messages\", {\n body: {\n to: params.to,\n type: \"template\",\n template: params.template,\n from: params.from,\n },\n });\n return assertSendResult(result);\n }\n\n /** Lista as mensagens da conta (paginação por cursor). */\n list(params: ListMessagesParams = {}): Promise<CursorList<Message>> {\n return this.client.requestCursorList<CursorList<Message>>(\"GET\", \"/messages\", {\n query: {\n limit: params.limit,\n after: params.after,\n before: params.before,\n phone_number_id: params.phone_number_id,\n conversation_id: params.conversation_id,\n direction: params.direction,\n status: params.status,\n message_type: params.message_type,\n has_media:\n params.has_media === undefined ? undefined : String(params.has_media),\n },\n });\n }\n\n /** Busca uma mensagem pelo id interno. */\n get(id: string): Promise<Message> {\n return this.client.requestItem<Message>(\n \"GET\",\n `/messages/${encodeURIComponent(id)}`,\n );\n }\n}\n\nfunction assertSendResult(value: SendResult): SendResult {\n if (\n typeof value.wamid !== \"string\" ||\n typeof value.to !== \"string\" ||\n typeof value.status !== \"string\" ||\n (value.id !== null && typeof value.id !== \"string\")\n ) {\n throw new BotoZapError(\n \"malformed_response\",\n \"resposta de envio sem id/wamid/to/status válidos\",\n 0,\n );\n }\n return value;\n}\n","import type { BotoZap } from \"../client.js\";\nimport type {\n Customer,\n OffsetList,\n OffsetParams,\n SetupLink,\n} from \"../types.js\";\n\nexport interface CreateCustomerParams {\n name: string;\n /** Referência do cliente no seu sistema (único por conta). */\n external_customer_id?: string;\n [key: string]: unknown;\n}\n\n/** Campos editáveis de um cliente (`PATCH /v1/customers/:id`). */\nexport interface UpdateCustomerParams {\n name?: string;\n external_customer_id?: string;\n}\n\n/** Corpo de `POST /v1/customers/:id/setup_links`. */\nexport interface CreateSetupLinkParams {\n /** Tipos de conexão liberados: \"dedicated\" e/ou \"coexistence\". */\n allowed_connection_types?: string[];\n provision_phone_number?: boolean;\n language?: string;\n success_redirect_url?: string;\n failure_redirect_url?: string;\n}\n\n/** Corpo de `PATCH /v1/customers/:id/setup_links/:linkId`. */\nexport interface UpdateSetupLinkParams {\n /** \"active\" | \"expired\" | \"revoked\" (a rota rejeita outros valores). */\n status?: string;\n /** Nova expiração (ISO 8601). */\n expires_at?: string;\n}\n\nfunction enc(id: string): string {\n return encodeURIComponent(id);\n}\n\n/**\n * Endpoints de cliente (`/v1/customers`) e seus links de setup\n * (`/v1/customers/:id/setup_links`).\n */\nexport class Customers {\n constructor(private readonly client: BotoZap) {}\n\n /** Lista os clientes da conta (paginação por offset/página). */\n list(params: OffsetParams = {}): Promise<OffsetList<Customer>> {\n return this.client.requestOffsetList<OffsetList<Customer>>(\"GET\", \"/customers\", {\n query: { page: params.page, per_page: params.per_page },\n });\n }\n\n /** Busca um cliente pelo id. */\n get(id: string): Promise<Customer> {\n return this.client.requestItem<Customer>(\"GET\", `/customers/${enc(id)}`);\n }\n\n /** Cria um cliente. */\n create(params: CreateCustomerParams): Promise<Customer> {\n return this.client.requestItem<Customer>(\"POST\", \"/customers\", {\n body: params,\n });\n }\n\n /** Atualiza `name` / `external_customer_id` de um cliente. */\n update(id: string, params: UpdateCustomerParams): Promise<Customer> {\n return this.client.requestItem<Customer>(\"PATCH\", `/customers/${enc(id)}`, {\n body: params,\n });\n }\n\n /** Exclui um cliente. Responde 204 (sem corpo). */\n delete(id: string): Promise<void> {\n return this.client.request<void>(\"DELETE\", `/customers/${enc(id)}`);\n }\n\n /** Lista os links de setup de um cliente (paginação por offset/página). */\n listSetupLinks(\n customerId: string,\n params: OffsetParams = {},\n ): Promise<OffsetList<SetupLink>> {\n return this.client.requestOffsetList<OffsetList<SetupLink>>(\n \"GET\",\n `/customers/${enc(customerId)}/setup_links`,\n { query: { page: params.page, per_page: params.per_page } },\n );\n }\n\n /** Cria um link de setup sob um cliente. */\n createSetupLink(\n customerId: string,\n params: CreateSetupLinkParams = {},\n ): Promise<SetupLink> {\n return this.client.requestItem<SetupLink>(\n \"POST\",\n `/customers/${enc(customerId)}/setup_links`,\n { body: params },\n );\n }\n\n /** Atualiza status/expiração de um link de setup. */\n updateSetupLink(\n customerId: string,\n linkId: string,\n params: UpdateSetupLinkParams,\n ): Promise<SetupLink> {\n return this.client.requestItem<SetupLink>(\n \"PATCH\",\n `/customers/${enc(customerId)}/setup_links/${enc(linkId)}`,\n { body: params },\n );\n }\n}\n","import type { BotoZap } from \"../client.js\";\nimport type { OffsetList, OffsetParams } from \"../types.js\";\n\nexport interface Template {\n id: string;\n name?: string;\n [key: string]: unknown;\n}\n\n/** Filtros de `templates.list` (paginação por offset). Ver GET /v1/templates. */\nexport interface ListTemplatesParams extends OffsetParams {\n /** Status do template (a rota normaliza para maiúsculas), ex.: \"APPROVED\". */\n status?: string;\n /** Categoria (a rota normaliza para maiúsculas), ex.: \"MARKETING\". */\n category?: string;\n /** Filtra pela conexão WABA. */\n waba_connection_id?: string;\n /** phone_number_id (Meta) → resolve a conexão do número (escopado por conta). */\n phone_number_id?: string;\n}\n\n/**\n * Corpo de `POST /v1/templates` — cria o template e o submete à Meta. A conexão\n * WABA vem de `waba_connection_id` OU `phone_number_id` (um dos dois). Ver a\n * rota para o formato exato de `components`.\n */\nexport interface CreateTemplateParams {\n name: string;\n /** Código de idioma, ex.: \"pt_BR\". */\n language: string;\n /** Categoria da Meta: \"MARKETING\" | \"UTILITY\" | \"AUTHENTICATION\". */\n category: string;\n /** Componentes do template (header/body/buttons…), formato da Cloud API. */\n components: unknown[];\n /** Conexão WABA alvo (alternativa a `phone_number_id`). */\n waba_connection_id?: string;\n /** phone_number_id (Meta) → resolve a conexão do número (alternativa). */\n phone_number_id?: string;\n}\n\n/** Endpoints de template (GET/POST /v1/templates, GET /v1/templates/:id). */\nexport class Templates {\n constructor(private readonly client: BotoZap) {}\n\n /** Lista os templates da conta (paginação por offset/página). */\n list(params: ListTemplatesParams = {}): Promise<OffsetList<Template>> {\n return this.client.requestOffsetList<OffsetList<Template>>(\"GET\", \"/templates\", {\n query: {\n page: params.page,\n per_page: params.per_page,\n status: params.status,\n category: params.category,\n waba_connection_id: params.waba_connection_id,\n phone_number_id: params.phone_number_id,\n },\n });\n }\n\n /** Busca um template pelo id. */\n get(id: string): Promise<Template> {\n return this.client.requestItem<Template>(\n \"GET\",\n `/templates/${encodeURIComponent(id)}`,\n );\n }\n\n /** Cria um template e o submete à Meta para análise. */\n create(params: CreateTemplateParams): Promise<Template> {\n return this.client.requestItem<Template>(\"POST\", \"/templates\", {\n body: params,\n });\n }\n}\n","import type { BotoZap } from \"../client.js\";\nimport type {\n Broadcast,\n BroadcastRecipient,\n CursorList,\n CursorParams,\n OffsetList,\n OffsetParams,\n} from \"../types.js\";\n\nexport interface ListBroadcastsParams extends OffsetParams {\n status?: string;\n customer_id?: string;\n phone_number_id?: string;\n}\n\n/**\n * Corpo de `POST /v1/broadcasts` — espelha o contrato real da rota. A origem é\n * `phone_number_id` OU `waba_connection_id` (um dos dois obrigatório);\n * `template_name` + `template_language` são obrigatórios. A conta vem da chave,\n * nunca do corpo. (A rota NÃO aceita `customer_id` nem um objeto `template`.)\n */\nexport interface CreateBroadcastParams {\n name?: string;\n /** phone_number_id (Meta) do número de origem. */\n phone_number_id?: string;\n /** Alternativa a `phone_number_id`: a conexão WABA de origem. */\n waba_connection_id?: string;\n /** Nome do template aprovado (obrigatório). */\n template_name: string;\n /** Código de idioma do template, ex.: \"pt_BR\" (obrigatório). */\n template_language: string;\n /** Opcional: id interno do template (revalidado por ownership/conexão). */\n template_id?: string;\n}\n\n/** Transição de estado via `PATCH /v1/broadcasts/:id`. */\nexport interface UpdateBroadcastParams {\n /** `stopped` interrompe (sending/scheduled); `draft` cancela um agendamento. */\n status: \"stopped\" | \"draft\";\n}\n\nexport interface ScheduleBroadcastParams {\n /** Data/hora ISO 8601. */\n scheduled_at: string;\n [key: string]: unknown;\n}\n\n/** Filtros de `listRecipients` (paginação por cursor + filtro de status). */\nexport interface ListRecipientsParams extends CursorParams {\n /** Filtra por status do destinatário (ex.: \"pending\", \"sent\", \"failed\"). */\n status?: string;\n}\n\n/** Resultado de `addRecipients`: quantos entraram, quantos eram duplicados, erros. */\nexport interface AddRecipientsResult {\n added: number;\n duplicates: number;\n errors: unknown[];\n}\n\n/** Transmissões: criar, adicionar destinatários, agendar/enviar/cancelar. */\nexport class Broadcasts {\n constructor(private readonly client: BotoZap) {}\n\n /** Lista as transmissões da conta (paginação por offset/página). */\n list(params: ListBroadcastsParams = {}): Promise<OffsetList<Broadcast>> {\n return this.client.requestOffsetList<OffsetList<Broadcast>>(\"GET\", \"/broadcasts\", {\n query: {\n page: params.page,\n per_page: params.per_page,\n status: params.status,\n customer_id: params.customer_id,\n phone_number_id: params.phone_number_id,\n },\n });\n }\n\n get(id: string): Promise<Broadcast> {\n return this.client.requestItem<Broadcast>(\"GET\", `/broadcasts/${enc(id)}`);\n }\n\n create(params: CreateBroadcastParams): Promise<Broadcast> {\n return this.client.requestItem<Broadcast>(\"POST\", \"/broadcasts\", {\n body: params,\n });\n }\n\n update(id: string, params: UpdateBroadcastParams): Promise<Broadcast> {\n return this.client.requestItem<Broadcast>(\n \"PATCH\",\n `/broadcasts/${enc(id)}`,\n { body: params },\n );\n }\n\n /** Lista os destinatários de uma transmissão (paginação por cursor). */\n listRecipients(\n id: string,\n params: ListRecipientsParams = {},\n ): Promise<CursorList<BroadcastRecipient>> {\n return this.client.requestCursorList<CursorList<BroadcastRecipient>>(\n \"GET\",\n `/broadcasts/${enc(id)}/recipients`,\n {\n query: {\n limit: params.limit,\n after: params.after,\n before: params.before,\n status: params.status,\n },\n },\n );\n }\n\n /** Adiciona destinatários (lista de números ou contatos). */\n addRecipients(id: string, recipients: unknown[]): Promise<AddRecipientsResult> {\n return this.client.requestItem<AddRecipientsResult>(\n \"POST\",\n `/broadcasts/${enc(id)}/recipients`,\n { body: { recipients } },\n );\n }\n\n /** Remove TODOS os destinatários. Responde 204 (sem corpo). */\n removeRecipients(id: string): Promise<void> {\n return this.client.request<void>(\n \"DELETE\",\n `/broadcasts/${enc(id)}/recipients`,\n );\n }\n\n schedule(id: string, params: ScheduleBroadcastParams): Promise<Broadcast> {\n return this.client.requestItem<Broadcast>(\n \"POST\",\n `/broadcasts/${enc(id)}/schedule`,\n { body: params },\n );\n }\n\n send(id: string): Promise<Broadcast> {\n return this.client.requestItem<Broadcast>(\n \"POST\",\n `/broadcasts/${enc(id)}/send`,\n );\n }\n\n cancel(id: string): Promise<Broadcast> {\n return this.client.requestItem<Broadcast>(\n \"POST\",\n `/broadcasts/${enc(id)}/cancel`,\n );\n }\n}\n\nfunction enc(id: string): string {\n return encodeURIComponent(id);\n}\n","import type { BotoZap } from \"../client.js\";\nimport type { Contact, CursorList, CursorParams } from \"../types.js\";\n\nexport interface ListContactsParams extends CursorParams {\n /** Filtra pelos números do cliente (derivado da conexão do número). */\n customer_id?: string;\n /**\n * Nesta base todo contato pertence a um cliente; `false` nunca casa (página\n * vazia), `true` é no-op.\n */\n has_customer?: boolean;\n /** Busca parcial (ilike) no nome de perfil. */\n profile_name_contains?: string;\n /** Busca parcial (ilike) no wa_id. */\n wa_id_contains?: string;\n /** Criados em ou após esta data (ISO 8601). */\n created_after?: string;\n /** Criados em ou antes desta data (ISO 8601). */\n created_before?: string;\n}\n\nexport interface CreateContactParams {\n /** wa_id canônico (BSUID \"BR.1A2B…\" ou dígitos E.164). */\n wa_id: string;\n phone_number_id?: string;\n [key: string]: unknown;\n}\n\n/** Contatos: listar, buscar, criar, atualizar, remover. */\nexport class Contacts {\n constructor(private readonly client: BotoZap) {}\n\n /** Lista os contatos da conta (paginação por cursor). */\n list(params: ListContactsParams = {}): Promise<CursorList<Contact>> {\n return this.client.requestCursorList<CursorList<Contact>>(\"GET\", \"/contacts\", {\n query: {\n limit: params.limit,\n after: params.after,\n before: params.before,\n customer_id: params.customer_id,\n has_customer:\n params.has_customer === undefined\n ? undefined\n : String(params.has_customer),\n profile_name_contains: params.profile_name_contains,\n wa_id_contains: params.wa_id_contains,\n created_after: params.created_after,\n created_before: params.created_before,\n },\n });\n }\n\n get(id: string): Promise<Contact> {\n return this.client.requestItem<Contact>(\"GET\", `/contacts/${enc(id)}`);\n }\n\n create(params: CreateContactParams): Promise<Contact> {\n return this.client.requestItem<Contact>(\"POST\", \"/contacts\", {\n body: params,\n });\n }\n\n update(id: string, params: Record<string, unknown>): Promise<Contact> {\n return this.client.requestItem<Contact>(\"PATCH\", `/contacts/${enc(id)}`, {\n body: params,\n });\n }\n\n /** Remove um contato. Responde 204 (sem corpo). */\n delete(id: string): Promise<void> {\n return this.client.request<void>(\"DELETE\", `/contacts/${enc(id)}`);\n }\n}\n\nfunction enc(id: string): string {\n return encodeURIComponent(id);\n}\n","import type { BotoZap } from \"../client.js\";\nimport type {\n Assignment,\n Conversation,\n CursorList,\n CursorParams,\n OffsetList,\n OffsetParams,\n} from \"../types.js\";\n\nexport interface ListConversationsParams extends CursorParams {\n /** id da Meta OU uuid interno do número. */\n phone_number_id?: string;\n /** \"active\" | \"ended\" — derivado da janela de 24h. */\n status?: string;\n /**\n * Busca parcial por contato (nome de perfil, @username, telefone ou wa_id).\n * Tem precedência sobre `phone_number` na rota.\n */\n contact?: string;\n /** Alias de busca por contato (usado quando `contact` não é informado). */\n phone_number?: string;\n}\n\nexport interface CreateAssignmentParams {\n /** Membro a quem atribuir a conversa. */\n user_id: string;\n notes?: string;\n}\n\n/** Conversas (read + status) e atribuições a membros. */\nexport class Conversations {\n constructor(private readonly client: BotoZap) {}\n\n /** Lista as conversas da conta (paginação por cursor). */\n list(params: ListConversationsParams = {}): Promise<CursorList<Conversation>> {\n return this.client.requestCursorList<CursorList<Conversation>>(\n \"GET\",\n \"/conversations\",\n {\n query: {\n limit: params.limit,\n after: params.after,\n before: params.before,\n phone_number_id: params.phone_number_id,\n status: params.status,\n contact: params.contact,\n phone_number: params.phone_number,\n },\n },\n );\n }\n\n get(id: string): Promise<Conversation> {\n return this.client.requestItem<Conversation>(\n \"GET\",\n `/conversations/${enc(id)}`,\n );\n }\n\n update(id: string, params: Record<string, unknown>): Promise<Conversation> {\n return this.client.requestItem<Conversation>(\n \"PATCH\",\n `/conversations/${enc(id)}`,\n { body: params },\n );\n }\n\n /** Lista as atribuições da conversa (paginação por offset/página). */\n listAssignments(\n id: string,\n params: OffsetParams = {},\n ): Promise<OffsetList<Assignment>> {\n return this.client.requestOffsetList<OffsetList<Assignment>>(\n \"GET\",\n `/conversations/${enc(id)}/assignments`,\n { query: { page: params.page, per_page: params.per_page } },\n );\n }\n\n createAssignment(\n id: string,\n params: CreateAssignmentParams,\n ): Promise<Assignment> {\n return this.client.requestItem<Assignment>(\n \"POST\",\n `/conversations/${enc(id)}/assignments`,\n { body: params },\n );\n }\n\n getAssignment(id: string, assignmentId: string): Promise<Assignment> {\n return this.client.requestItem<Assignment>(\n \"GET\",\n `/conversations/${enc(id)}/assignments/${enc(assignmentId)}`,\n );\n }\n\n updateAssignment(\n id: string,\n assignmentId: string,\n params: Record<string, unknown>,\n ): Promise<Assignment> {\n return this.client.requestItem<Assignment>(\n \"PATCH\",\n `/conversations/${enc(id)}/assignments/${enc(assignmentId)}`,\n { body: params },\n );\n }\n}\n\nfunction enc(id: string): string {\n return encodeURIComponent(id);\n}\n","import type { BotoZap } from \"../client.js\";\nimport type { CursorList, CursorParams, Webhook } from \"../types.js\";\n\nexport interface CreateWebhookParams {\n url: string;\n events?: string[];\n active?: boolean;\n [key: string]: unknown;\n}\n\n/** Webhooks: endpoints assinados que recebem os eventos da conta. */\nexport class Webhooks {\n constructor(private readonly client: BotoZap) {}\n\n /** Lista os endpoints de webhook da conta (paginação por cursor). */\n list(params: CursorParams = {}): Promise<CursorList<Webhook>> {\n return this.client.requestCursorList<CursorList<Webhook>>(\"GET\", \"/webhooks\", {\n query: {\n limit: params.limit,\n after: params.after,\n before: params.before,\n },\n });\n }\n\n get(id: string): Promise<Webhook> {\n return this.client.requestItem<Webhook>(\"GET\", `/webhooks/${enc(id)}`);\n }\n\n create(params: CreateWebhookParams): Promise<Webhook> {\n return this.client.requestItem<Webhook>(\"POST\", \"/webhooks\", {\n body: params,\n });\n }\n\n update(id: string, params: Record<string, unknown>): Promise<Webhook> {\n return this.client.requestItem<Webhook>(\"PATCH\", `/webhooks/${enc(id)}`, {\n body: params,\n });\n }\n\n /** Remove um endpoint. Responde 204 (sem corpo). */\n delete(id: string): Promise<void> {\n return this.client.request<void>(\"DELETE\", `/webhooks/${enc(id)}`);\n }\n\n /** Dispara um evento de teste para o endpoint. */\n test(id: string): Promise<{ success: boolean }> {\n return this.client.requestItem<{ success: boolean }>(\n \"POST\",\n `/webhooks/${enc(id)}/test`,\n );\n }\n}\n\nfunction enc(id: string): string {\n return encodeURIComponent(id);\n}\n","import type { BotoZap } from \"../client.js\";\nimport type { OffsetList, OffsetParams, PhoneNumber } from \"../types.js\";\n\nexport interface ListPhoneNumbersParams extends OffsetParams {\n customer_id?: string;\n}\n\n/** Números conectados de cada cliente. */\nexport class PhoneNumbers {\n constructor(private readonly client: BotoZap) {}\n\n /** Lista os números da conta (paginação por offset/página). */\n list(params: ListPhoneNumbersParams = {}): Promise<OffsetList<PhoneNumber>> {\n return this.client.requestOffsetList<OffsetList<PhoneNumber>>(\n \"GET\",\n \"/phone_numbers\",\n {\n query: {\n page: params.page,\n per_page: params.per_page,\n customer_id: params.customer_id,\n },\n },\n );\n }\n\n get(id: string): Promise<PhoneNumber> {\n return this.client.requestItem<PhoneNumber>(\n \"GET\",\n `/phone_numbers/${enc(id)}`,\n );\n }\n\n // NOTA: `update` foi removido de propósito. A rota PATCH /v1/phone_numbers/:id\n // responde SEMPRE 422 `no_updatable_fields` — o schema atual só tem campos de\n // identidade e campos sincronizados da Meta, nenhum editável por aqui. Expor o\n // método só entregaria uma chamada garantidamente quebrada.\n\n /** Remove um número. Responde 204 (sem corpo). */\n delete(id: string): Promise<void> {\n return this.client.request<void>(\"DELETE\", `/phone_numbers/${enc(id)}`);\n }\n\n /** Saúde do número (qualidade, limite, status na Meta). */\n health(id: string): Promise<Record<string, unknown>> {\n return this.client.requestItem<Record<string, unknown>>(\n \"GET\",\n `/phone_numbers/${enc(id)}/health`,\n );\n }\n}\n\nfunction enc(id: string): string {\n return encodeURIComponent(id);\n}\n","import type { BotoZap } from \"../client.js\";\nimport type { Flow, FlowVersion, OffsetList, OffsetParams } from \"../types.js\";\n\nexport interface CreateFlowParams {\n name?: string;\n [key: string]: unknown;\n}\n\n/**\n * Filtros de `flows.list` (paginação por offset). Flows vivem na Meta e a lista\n * é por WABA — a rota GET /v1/flows EXIGE `phone_number_id` OU\n * `waba_connection_id` (sem um deles responde 422 missing_target). Informe um.\n */\nexport interface ListFlowsParams extends OffsetParams {\n /** phone_number_id (Meta) → resolve a conexão do número (escopado por conta). */\n phone_number_id?: string;\n /** Alternativa a `phone_number_id`: a conexão WABA cujos flows listar. */\n waba_connection_id?: string;\n}\n\n/**\n * Flows vivem na Meta, não no nosso banco — a amarração flow → conta é via\n * `phone_number_id` (resolve a WABA e o token). Por isso get/delete/publish/\n * setup_encryption/versions/data_endpoint EXIGEM `phone_number_id`.\n */\nexport interface FlowPhoneParams {\n /** phone_number_id (Meta) do número cuja WABA hospeda o flow. */\n phone_number_id: string;\n}\n\n/** Corpo de `POST /v1/flows/:id/versions` — sobe um novo flow.json. */\nexport interface CreateFlowVersionParams {\n phone_number_id: string;\n /** JSON do flow (objeto ou string JSON válida). */\n flow_json: unknown;\n [key: string]: unknown;\n}\n\n/** Corpo de `POST /v1/flows/:id/data_endpoint` — conecta a forward URL do dev. */\nexport interface SetFlowDataEndpointParams {\n phone_number_id: string;\n /** URL HTTPS do backend do dev que recebe o data_exchange. */\n forward_url: string;\n [key: string]: unknown;\n}\n\n/** WhatsApp Flows: criar, versionar, publicar e configurar data endpoint. */\nexport class Flows {\n constructor(private readonly client: BotoZap) {}\n\n /**\n * Lista os flows de uma WABA (paginação por offset/página). Informe\n * `phone_number_id` OU `waba_connection_id` — a rota exige um deles.\n */\n list(params: ListFlowsParams = {}): Promise<OffsetList<Flow>> {\n return this.client.requestOffsetList<OffsetList<Flow>>(\"GET\", \"/flows\", {\n query: {\n page: params.page,\n per_page: params.per_page,\n phone_number_id: params.phone_number_id,\n waba_connection_id: params.waba_connection_id,\n },\n });\n }\n\n get(id: string, params: FlowPhoneParams): Promise<Flow> {\n return this.client.requestItem<Flow>(\"GET\", `/flows/${enc(id)}`, {\n query: { phone_number_id: params.phone_number_id },\n });\n }\n\n create(params: CreateFlowParams): Promise<Flow> {\n return this.client.requestItem<Flow>(\"POST\", \"/flows\", { body: params });\n }\n\n /** Remove um flow (só DRAFT, regra da Meta). Responde 204 (sem corpo). */\n delete(id: string, params: FlowPhoneParams): Promise<void> {\n return this.client.request<void>(\"DELETE\", `/flows/${enc(id)}`, {\n query: { phone_number_id: params.phone_number_id },\n });\n }\n\n publish(id: string, params: FlowPhoneParams): Promise<Flow> {\n return this.client.requestItem<Flow>(\"POST\", `/flows/${enc(id)}/publish`, {\n body: { phone_number_id: params.phone_number_id },\n });\n }\n\n /** Lista as versões de um flow (paginação por offset/página). */\n listVersions(\n id: string,\n params: OffsetParams = {},\n ): Promise<OffsetList<FlowVersion>> {\n return this.client.requestOffsetList<OffsetList<FlowVersion>>(\n \"GET\",\n `/flows/${enc(id)}/versions`,\n { query: { page: params.page, per_page: params.per_page } },\n );\n }\n\n createVersion(\n id: string,\n params: CreateFlowVersionParams,\n ): Promise<FlowVersion> {\n return this.client.requestItem<FlowVersion>(\n \"POST\",\n `/flows/${enc(id)}/versions`,\n { body: params },\n );\n }\n\n setupEncryption(\n id: string,\n params: FlowPhoneParams,\n ): Promise<Record<string, unknown>> {\n return this.client.requestItem<Record<string, unknown>>(\n \"POST\",\n `/flows/${enc(id)}/setup_encryption`,\n { body: { phone_number_id: params.phone_number_id } },\n );\n }\n\n getDataEndpoint(id: string): Promise<Record<string, unknown>> {\n return this.client.requestItem<Record<string, unknown>>(\n \"GET\",\n `/flows/${enc(id)}/data_endpoint`,\n );\n }\n\n setDataEndpoint(\n id: string,\n params: SetFlowDataEndpointParams,\n ): Promise<Record<string, unknown>> {\n return this.client.requestItem<Record<string, unknown>>(\n \"POST\",\n `/flows/${enc(id)}/data_endpoint`,\n { body: params },\n );\n }\n}\n\nfunction enc(id: string): string {\n return encodeURIComponent(id);\n}\n","import type { BotoZap } from \"../client.js\";\nimport type { MediaUploadResult } from \"../types.js\";\n\n/** Corpo do `POST /v1/media` — espelha o contrato real da rota. */\nexport interface UploadMediaParams {\n /** URL http(s) de origem do arquivo. A BotoZap baixa (com guard SSRF) e sobe pra Cloud API. */\n source: string;\n /** phone_number_id (da Meta) do número de origem. Obrigatório. */\n phone_number_id: string;\n /** Nome do arquivo (default: derivado da URL). */\n filename?: string;\n /** MIME type (default: Content-Type do download). */\n mime_type?: string;\n /** Pipeline de upload: `meta_media` (default) ou `meta_resumable_asset`. */\n delivery?: \"meta_media\" | \"meta_resumable_asset\";\n [key: string]: unknown;\n}\n\n/** Mídia: sobe um arquivo e devolve um media_id usável em mensagens. */\nexport class Media {\n constructor(private readonly client: BotoZap) {}\n\n upload(params: UploadMediaParams): Promise<MediaUploadResult> {\n return this.client.requestItem<MediaUploadResult>(\"POST\", \"/media\", {\n body: params,\n });\n }\n}\n","import type { BotoZap } from \"../client.js\";\nimport type {\n ApiLog,\n CursorList,\n CursorParams,\n OffsetList,\n OffsetParams,\n User,\n WebhookDelivery,\n} from \"../types.js\";\n\n/** Membros da conta (somente leitura via API). */\nexport class Users {\n constructor(private readonly client: BotoZap) {}\n\n /** Lista os membros da conta (paginação por offset/página). */\n list(params: OffsetParams = {}): Promise<OffsetList<User>> {\n return this.client.requestOffsetList<OffsetList<User>>(\"GET\", \"/users\", {\n query: { page: params.page, per_page: params.per_page },\n });\n }\n}\n\nexport interface ListApiLogsParams extends CursorParams {\n /** Origem do log (ex.: \"api\"). */\n source?: string;\n /** Método HTTP (a rota normaliza para maiúsculas). */\n method?: string;\n /** Código HTTP exato (inteiro). */\n status_code?: number;\n}\n\n/** Logs de requisições à API (somente leitura, paginação por cursor). */\nexport class ApiLogs {\n constructor(private readonly client: BotoZap) {}\n\n list(params: ListApiLogsParams = {}): Promise<CursorList<ApiLog>> {\n return this.client.requestCursorList<CursorList<ApiLog>>(\"GET\", \"/api_logs\", {\n query: {\n limit: params.limit,\n after: params.after,\n before: params.before,\n source: params.source,\n method: params.method,\n status_code: params.status_code,\n },\n });\n }\n}\n\nexport interface ListWebhookDeliveriesParams extends CursorParams {\n /** Alias de `endpoint_id` na rota — entregas de um endpoint específico. */\n webhook_id?: string;\n /** delivery_status (pending|success|failed|exhausted). */\n status?: string;\n /** Tipo do evento (ex.: \"webhook.test\", \"messages\"). */\n event_type?: string;\n}\n\n/** Histórico de entregas de webhook (somente leitura, paginação por cursor). */\nexport class WebhookDeliveries {\n constructor(private readonly client: BotoZap) {}\n\n list(\n params: ListWebhookDeliveriesParams = {},\n ): Promise<CursorList<WebhookDelivery>> {\n return this.client.requestCursorList<CursorList<WebhookDelivery>>(\n \"GET\",\n \"/webhook_deliveries\",\n {\n query: {\n limit: params.limit,\n after: params.after,\n before: params.before,\n webhook_id: params.webhook_id,\n status: params.status,\n event_type: params.event_type,\n },\n },\n );\n }\n}\n","import { BotoZapError } from \"./errors.js\";\nimport { Messages } from \"./resources/messages.js\";\nimport { Customers } from \"./resources/customers.js\";\nimport { Templates } from \"./resources/templates.js\";\nimport { Broadcasts } from \"./resources/broadcasts.js\";\nimport { Contacts } from \"./resources/contacts.js\";\nimport { Conversations } from \"./resources/conversations.js\";\nimport { Webhooks } from \"./resources/webhooks.js\";\nimport { PhoneNumbers } from \"./resources/phone-numbers.js\";\nimport { Flows } from \"./resources/flows.js\";\nimport { Media } from \"./resources/media.js\";\nimport { Users, ApiLogs, WebhookDeliveries } from \"./resources/read-only.js\";\n\nexport interface BotoZapOptions {\n /** Chave de API da conta (cabeçalho Authorization: Bearer). */\n apiKey: string;\n /** Sobrescreve a URL base. Padrão: https://botozap.com.br/api/v1 */\n baseUrl?: string;\n /** Injeta um fetch (testes, runtimes sem fetch global). */\n fetch?: typeof fetch;\n}\n\nexport interface RequestOptions {\n query?: Record<string, string | number | undefined>;\n body?: unknown;\n}\n\nconst DEFAULT_BASE_URL = \"https://botozap.com.br/api/v1\";\n\n/**\n * Cliente da API da BotoZap.\n *\n * ```ts\n * const boto = new BotoZap({ apiKey: process.env.BOTOZAP_KEY! });\n * await boto.messages.send({ to: \"+5531988887777\", text: \"Olá!\" });\n * ```\n */\nexport class BotoZap {\n readonly messages: Messages;\n readonly customers: Customers;\n readonly templates: Templates;\n readonly broadcasts: Broadcasts;\n readonly contacts: Contacts;\n readonly conversations: Conversations;\n readonly webhooks: Webhooks;\n readonly phoneNumbers: PhoneNumbers;\n readonly flows: Flows;\n readonly media: Media;\n readonly users: Users;\n readonly apiLogs: ApiLogs;\n readonly webhookDeliveries: WebhookDeliveries;\n\n private readonly apiKey: string;\n private readonly baseUrl: string;\n private readonly fetchImpl: typeof fetch;\n\n constructor(options: BotoZapOptions) {\n if (!options || !options.apiKey) {\n throw new Error(\"BotoZap: apiKey é obrigatório.\");\n }\n this.apiKey = options.apiKey;\n this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n\n const resolvedFetch = options.fetch ?? globalThis.fetch;\n if (typeof resolvedFetch !== \"function\") {\n throw new Error(\n \"BotoZap: fetch global não encontrado. Use Node 20.19+ ou passe a opção `fetch`.\",\n );\n }\n this.fetchImpl = resolvedFetch;\n\n this.messages = new Messages(this);\n this.customers = new Customers(this);\n this.templates = new Templates(this);\n this.broadcasts = new Broadcasts(this);\n this.contacts = new Contacts(this);\n this.conversations = new Conversations(this);\n this.webhooks = new Webhooks(this);\n this.phoneNumbers = new PhoneNumbers(this);\n this.flows = new Flows(this);\n this.media = new Media(this);\n this.users = new Users(this);\n this.apiLogs = new ApiLogs(this);\n this.webhookDeliveries = new WebhookDeliveries(this);\n }\n\n /** Faz uma requisição autenticada e devolve o corpo já parseado. */\n async request<T>(\n method: string,\n path: string,\n opts: RequestOptions = {},\n ): Promise<T> {\n const url = new URL(this.baseUrl + path);\n if (opts.query) {\n for (const [key, value] of Object.entries(opts.query)) {\n if (value !== undefined) url.searchParams.set(key, String(value));\n }\n }\n\n let res: Awaited<ReturnType<typeof fetch>>;\n try {\n res = await this.fetchImpl(url.toString(), {\n method,\n headers: {\n Authorization: `Bearer ${this.apiKey}`,\n \"Content-Type\": \"application/json\",\n Accept: \"application/json\",\n },\n body: opts.body === undefined ? undefined : JSON.stringify(opts.body),\n });\n } catch (cause) {\n // `fetch` REJEITA (DNS, conexão recusada, offline, abort) com um TypeError\n // — não é uma resposta HTTP. Se vazasse cru, o chamador teria dois tipos de\n // erro pra tratar (BotoZapError vs. TypeError). Embrulhamos num BotoZapError\n // de rede: um único tipo pra capturar, com `code` distinguindo rede de HTTP.\n // status 0 = não houve resposta HTTP.\n const detail = cause instanceof Error ? cause.message : String(cause);\n throw new BotoZapError(\n \"network_error\",\n `falha de rede ao chamar a API: ${detail}`,\n 0,\n );\n }\n\n const raw = await res.text();\n const data = raw ? safeJson(raw) : undefined;\n\n if (!res.ok) {\n const envelope = data as\n | { error?: { code?: string; message?: string } }\n | undefined;\n // Expõe os headers da RESPOSTA no erro — num 429 o chamador precisa de\n // `Retry-After`/`X-RateLimit-*` para saber quando reenviar. Só headers da\n // resposta; nada do request (que carrega a apiKey) toca este objeto.\n const headers: Record<string, string> = {};\n res.headers.forEach((value, key) => {\n headers[key] = value;\n });\n throw new BotoZapError(\n envelope?.error?.code ?? \"http_error\",\n envelope?.error?.message ?? `HTTP ${res.status}`,\n res.status,\n headers,\n );\n }\n\n return data as T;\n }\n\n /**\n * Requisição a um endpoint de ITEM (singular). A API embrulha essas respostas\n * em `{ data: <obj> }` (helper `ok`); este método desempacota e devolve a\n * entidade. NÃO é uma heurística \"se tem .data desempacota\" — o desempacote é\n * o contrato conhecido do endpoint, declarado por quem chama este método (as\n * rotas de LISTA usam `request` e devolvem `{ data, paging|meta }` inteiro; a\n * rota POST /messages responde direto e também usa `request`).\n */\n async requestItem<T>(\n method: string,\n path: string,\n opts: RequestOptions = {},\n ): Promise<T> {\n const env = await this.request<{ data: T }>(method, path, opts);\n // Contrato: endpoints de ITEM respondem `{ data: <obj> }`. Sem a chave\n // `data`, `(env).data` seria `undefined` SILENCIOSO — o chamador recebe\n // undefined e só quebra lá na frente, longe da causa. Falha alto e claro\n // aqui. (`data: null` explícito PASSA — a chave existe; é 200-sem-envelope\n // que é violação.) status 0 = erro de contrato do cliente, não HTTP.\n if (env == null || typeof env !== \"object\" || !(\"data\" in env)) {\n throw new BotoZapError(\n \"malformed_response\",\n \"resposta sem envelope data — contrato violado\",\n 0,\n );\n }\n return (env as { data: T }).data;\n }\n\n /** Resposta JSON direta que precisa ser um objeto (ex.: POST /messages). */\n async requestObject<T>(\n method: string,\n path: string,\n opts: RequestOptions = {},\n ): Promise<T> {\n const value = await this.request<unknown>(method, path, opts);\n if (!isObject(value)) {\n throw malformed(\"resposta deveria ser um objeto JSON\");\n }\n return value as T;\n }\n\n /** Lista paginada por cursor: exige `{ data: [], paging: {} }`. */\n async requestCursorList<T>(\n method: string,\n path: string,\n opts: RequestOptions = {},\n ): Promise<T> {\n const value = await this.request<unknown>(method, path, opts);\n if (!isObject(value) || !Array.isArray(value.data) || !isObject(value.paging)) {\n throw malformed(\"resposta sem data[]/paging — contrato de cursor violado\");\n }\n return value as T;\n }\n\n /** Lista paginada por offset: exige `{ data: [], meta: {} }`. */\n async requestOffsetList<T>(\n method: string,\n path: string,\n opts: RequestOptions = {},\n ): Promise<T> {\n const value = await this.request<unknown>(method, path, opts);\n if (!isObject(value) || !Array.isArray(value.data) || !isObject(value.meta)) {\n throw malformed(\"resposta sem data[]/meta — contrato de offset violado\");\n }\n return value as T;\n }\n}\n\nfunction isObject(value: unknown): value is Record<string, unknown> {\n return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction malformed(message: string): BotoZapError {\n return new BotoZapError(\"malformed_response\", message, 0);\n}\n\nfunction safeJson(text: string): unknown {\n try {\n return JSON.parse(text);\n } catch {\n return text;\n }\n}\n"],"mappings":"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","names":["enc","enc","enc","enc","enc","enc"]}
|
|
1
|
+
{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/resources/messages.ts","../src/resources/customers.ts","../src/resources/templates.ts","../src/resources/broadcasts.ts","../src/resources/contacts.ts","../src/resources/conversations.ts","../src/resources/webhooks.ts","../src/resources/phone-numbers.ts","../src/resources/flows.ts","../src/resources/media.ts","../src/resources/read-only.ts","../src/client.ts"],"sourcesContent":["export { BotoZap } from \"./client.js\";\nexport type { BotoZapOptions, RequestOptions } from \"./client.js\";\nexport { BotoZapError } from \"./errors.js\";\n\nexport type {\n SendTextParams,\n SendTemplateParams,\n ListMessagesParams,\n} from \"./resources/messages.js\";\nexport type {\n CreateCustomerParams,\n UpdateCustomerParams,\n CreateSetupLinkParams,\n UpdateSetupLinkParams,\n} from \"./resources/customers.js\";\nexport type {\n Template,\n ListTemplatesParams,\n CreateTemplateParams,\n} from \"./resources/templates.js\";\nexport type {\n ListBroadcastsParams,\n CreateBroadcastParams,\n UpdateBroadcastParams,\n ScheduleBroadcastParams,\n ListRecipientsParams,\n AddRecipientsResult,\n} from \"./resources/broadcasts.js\";\nexport type { ListContactsParams, CreateContactParams } from \"./resources/contacts.js\";\nexport type {\n ListConversationsParams,\n CreateAssignmentParams,\n} from \"./resources/conversations.js\";\nexport type { CreateWebhookParams } from \"./resources/webhooks.js\";\nexport type { ListPhoneNumbersParams } from \"./resources/phone-numbers.js\";\nexport type {\n CreateFlowParams,\n ListFlowsParams,\n FlowPhoneParams,\n CreateFlowVersionParams,\n SetFlowDataEndpointParams,\n} from \"./resources/flows.js\";\nexport type { UploadMediaParams } from \"./resources/media.js\";\nexport type {\n ListApiLogsParams,\n ListWebhookDeliveriesParams,\n} from \"./resources/read-only.js\";\n\nexport type {\n MessageStatus,\n SendResult,\n TemplatePayload,\n CursorPaging,\n OffsetMeta,\n CursorList,\n OffsetList,\n CursorParams,\n OffsetParams,\n Customer,\n Message,\n Broadcast,\n BroadcastRecipient,\n Contact,\n Conversation,\n Assignment,\n Webhook,\n PhoneNumber,\n Flow,\n FlowVersion,\n User,\n ApiLog,\n WebhookDelivery,\n MediaUploadResult,\n MediaAsset,\n SetupLink,\n} from \"./types.js\";\n","/**\n * Erro lançado quando a API responde fora da faixa 2xx. Carrega o envelope\n * de erro da BotoZap: { error: { code, message } }, mais o status HTTP e, quando\n * houve resposta HTTP (status > 0), os headers dela — úteis num 429 para ler\n * `Retry-After` / `X-RateLimit-*`. Os headers são só os da RESPOSTA; nenhum\n * header de request (que carrega a apiKey) entra aqui.\n */\nexport class BotoZapError extends Error {\n readonly code: string;\n readonly status: number;\n /** Headers da resposta HTTP. Ausente em erros sem resposta (status 0). */\n readonly headers?: Record<string, string>;\n\n constructor(\n code: string,\n message: string,\n status: number,\n headers?: Record<string, string>,\n ) {\n super(message);\n this.name = \"BotoZapError\";\n this.code = code;\n this.status = status;\n this.headers = headers;\n }\n}\n","import type { BotoZap } from \"../client.js\";\nimport { BotoZapError } from \"../errors.js\";\nimport type {\n CursorList,\n CursorParams,\n Message,\n SendResult,\n TemplatePayload,\n} from \"../types.js\";\n\n/** Filtros de `messages.list` (paginação por cursor). Ver GET /v1/messages. */\nexport interface ListMessagesParams extends CursorParams {\n /** id da Meta OU uuid interno do número. */\n phone_number_id?: string;\n /** uuid interno da conversa (o `id` de /v1/conversations). */\n conversation_id?: string;\n direction?: \"inbound\" | \"outbound\";\n /** enum message_status (ex.: \"sent\", \"delivered\", \"read\", \"failed\"). */\n status?: string;\n /** enum message_kind (ex.: \"text\", \"image\", \"template\"). */\n message_type?: string;\n /** true = só mensagens com mídia; false = só sem mídia. */\n has_media?: boolean;\n}\n\nexport interface SendTextParams {\n /** Número de destino em E.164, ex: \"+5531988887777\". */\n to: string;\n /** Corpo do texto. */\n text: string;\n /** phone_number_id de origem (obrigatório se a conta tem mais de um número). */\n from?: string;\n}\n\nexport interface SendTemplateParams {\n to: string;\n template: TemplatePayload;\n from?: string;\n}\n\n/** Endpoints de mensagem (POST /v1/messages, GET /v1/messages/:id). */\nexport class Messages {\n constructor(private readonly client: BotoZap) {}\n\n /** Envia uma mensagem de texto. */\n async send(params: SendTextParams): Promise<SendResult> {\n const result = await this.client.requestObject<SendResult>(\"POST\", \"/messages\", {\n body: {\n to: params.to,\n type: \"text\",\n text: { body: params.text },\n from: params.from,\n },\n });\n return assertSendResult(result);\n }\n\n /** Envia uma mensagem usando um template aprovado. */\n async sendTemplate(params: SendTemplateParams): Promise<SendResult> {\n const result = await this.client.requestObject<SendResult>(\"POST\", \"/messages\", {\n body: {\n to: params.to,\n type: \"template\",\n template: params.template,\n from: params.from,\n },\n });\n return assertSendResult(result);\n }\n\n /** Lista as mensagens da conta (paginação por cursor). */\n list(params: ListMessagesParams = {}): Promise<CursorList<Message>> {\n return this.client.requestCursorList<CursorList<Message>>(\"GET\", \"/messages\", {\n query: {\n limit: params.limit,\n after: params.after,\n before: params.before,\n phone_number_id: params.phone_number_id,\n conversation_id: params.conversation_id,\n direction: params.direction,\n status: params.status,\n message_type: params.message_type,\n has_media:\n params.has_media === undefined ? undefined : String(params.has_media),\n },\n });\n }\n\n /** Busca uma mensagem pelo id interno. */\n get(id: string): Promise<Message> {\n return this.client.requestItem<Message>(\n \"GET\",\n `/messages/${encodeURIComponent(id)}`,\n );\n }\n}\n\nfunction assertSendResult(value: SendResult): SendResult {\n if (\n typeof value.wamid !== \"string\" ||\n typeof value.to !== \"string\" ||\n typeof value.status !== \"string\" ||\n (value.id !== null && typeof value.id !== \"string\")\n ) {\n throw new BotoZapError(\n \"malformed_response\",\n \"resposta de envio sem id/wamid/to/status válidos\",\n 0,\n );\n }\n return value;\n}\n","import type { BotoZap } from \"../client.js\";\nimport type {\n Customer,\n OffsetList,\n OffsetParams,\n SetupLink,\n} from \"../types.js\";\n\nexport interface CreateCustomerParams {\n name: string;\n /** Referência do cliente no seu sistema (único por conta). */\n external_customer_id?: string;\n [key: string]: unknown;\n}\n\n/** Campos editáveis de um cliente (`PATCH /v1/customers/:id`). */\nexport interface UpdateCustomerParams {\n name?: string;\n external_customer_id?: string;\n}\n\n/** Corpo de `POST /v1/customers/:id/setup_links`. */\nexport interface CreateSetupLinkParams {\n /** Tipos de conexão liberados: \"dedicated\" e/ou \"coexistence\". */\n allowed_connection_types?: string[];\n provision_phone_number?: boolean;\n language?: string;\n success_redirect_url?: string;\n failure_redirect_url?: string;\n}\n\n/** Corpo de `PATCH /v1/customers/:id/setup_links/:linkId`. */\nexport interface UpdateSetupLinkParams {\n /** \"active\" | \"expired\" | \"revoked\" (a rota rejeita outros valores). */\n status?: string;\n /** Nova expiração (ISO 8601). */\n expires_at?: string;\n}\n\nfunction enc(id: string): string {\n return encodeURIComponent(id);\n}\n\n/**\n * Endpoints de cliente (`/v1/customers`) e seus links de setup\n * (`/v1/customers/:id/setup_links`).\n */\nexport class Customers {\n constructor(private readonly client: BotoZap) {}\n\n /** Lista os clientes da conta (paginação por offset/página). */\n list(params: OffsetParams = {}): Promise<OffsetList<Customer>> {\n return this.client.requestOffsetList<OffsetList<Customer>>(\"GET\", \"/customers\", {\n query: { page: params.page, per_page: params.per_page },\n });\n }\n\n /** Busca um cliente pelo id. */\n get(id: string): Promise<Customer> {\n return this.client.requestItem<Customer>(\"GET\", `/customers/${enc(id)}`);\n }\n\n /** Cria um cliente. */\n create(params: CreateCustomerParams): Promise<Customer> {\n return this.client.requestItem<Customer>(\"POST\", \"/customers\", {\n body: params,\n });\n }\n\n /** Atualiza `name` / `external_customer_id` de um cliente. */\n update(id: string, params: UpdateCustomerParams): Promise<Customer> {\n return this.client.requestItem<Customer>(\"PATCH\", `/customers/${enc(id)}`, {\n body: params,\n });\n }\n\n /** Exclui um cliente. Responde 204 (sem corpo). */\n delete(id: string): Promise<void> {\n return this.client.request<void>(\"DELETE\", `/customers/${enc(id)}`);\n }\n\n /** Lista os links de setup de um cliente (paginação por offset/página). */\n listSetupLinks(\n customerId: string,\n params: OffsetParams = {},\n ): Promise<OffsetList<SetupLink>> {\n return this.client.requestOffsetList<OffsetList<SetupLink>>(\n \"GET\",\n `/customers/${enc(customerId)}/setup_links`,\n { query: { page: params.page, per_page: params.per_page } },\n );\n }\n\n /** Cria um link de setup sob um cliente. */\n createSetupLink(\n customerId: string,\n params: CreateSetupLinkParams = {},\n ): Promise<SetupLink> {\n return this.client.requestItem<SetupLink>(\n \"POST\",\n `/customers/${enc(customerId)}/setup_links`,\n { body: params },\n );\n }\n\n /** Atualiza status/expiração de um link de setup. */\n updateSetupLink(\n customerId: string,\n linkId: string,\n params: UpdateSetupLinkParams,\n ): Promise<SetupLink> {\n return this.client.requestItem<SetupLink>(\n \"PATCH\",\n `/customers/${enc(customerId)}/setup_links/${enc(linkId)}`,\n { body: params },\n );\n }\n}\n","import type { BotoZap } from \"../client.js\";\nimport type { OffsetList, OffsetParams } from \"../types.js\";\n\nexport interface Template {\n id: string;\n name?: string;\n [key: string]: unknown;\n}\n\n/** Filtros de `templates.list` (paginação por offset). Ver GET /v1/templates. */\nexport interface ListTemplatesParams extends OffsetParams {\n /** Status do template (a rota normaliza para maiúsculas), ex.: \"APPROVED\". */\n status?: string;\n /** Categoria (a rota normaliza para maiúsculas), ex.: \"MARKETING\". */\n category?: string;\n /** Filtra pela conexão WABA. */\n waba_connection_id?: string;\n /** phone_number_id (Meta) → resolve a conexão do número (escopado por conta). */\n phone_number_id?: string;\n}\n\n/**\n * Corpo de `POST /v1/templates` — cria o template e o submete à Meta. A conexão\n * WABA vem de `waba_connection_id` OU `phone_number_id` (um dos dois). Ver a\n * rota para o formato exato de `components`.\n */\nexport interface CreateTemplateParams {\n name: string;\n /** Código de idioma, ex.: \"pt_BR\". */\n language: string;\n /** Categoria da Meta: \"MARKETING\" | \"UTILITY\" | \"AUTHENTICATION\". */\n category: string;\n /** Componentes do template (header/body/buttons…), formato da Cloud API. */\n components: unknown[];\n /** Conexão WABA alvo (alternativa a `phone_number_id`). */\n waba_connection_id?: string;\n /** phone_number_id (Meta) → resolve a conexão do número (alternativa). */\n phone_number_id?: string;\n}\n\n/** Endpoints de template (GET/POST /v1/templates, GET /v1/templates/:id). */\nexport class Templates {\n constructor(private readonly client: BotoZap) {}\n\n /** Lista os templates da conta (paginação por offset/página). */\n list(params: ListTemplatesParams = {}): Promise<OffsetList<Template>> {\n return this.client.requestOffsetList<OffsetList<Template>>(\"GET\", \"/templates\", {\n query: {\n page: params.page,\n per_page: params.per_page,\n status: params.status,\n category: params.category,\n waba_connection_id: params.waba_connection_id,\n phone_number_id: params.phone_number_id,\n },\n });\n }\n\n /** Busca um template pelo id. */\n get(id: string): Promise<Template> {\n return this.client.requestItem<Template>(\n \"GET\",\n `/templates/${encodeURIComponent(id)}`,\n );\n }\n\n /** Cria um template e o submete à Meta para análise. */\n create(params: CreateTemplateParams): Promise<Template> {\n return this.client.requestItem<Template>(\"POST\", \"/templates\", {\n body: params,\n });\n }\n}\n","import type { BotoZap } from \"../client.js\";\nimport type {\n Broadcast,\n BroadcastRecipient,\n CursorList,\n CursorParams,\n OffsetList,\n OffsetParams,\n} from \"../types.js\";\n\nexport interface ListBroadcastsParams extends OffsetParams {\n status?: string;\n customer_id?: string;\n phone_number_id?: string;\n}\n\n/**\n * Corpo de `POST /v1/broadcasts` — espelha o contrato real da rota. A origem é\n * `phone_number_id` OU `waba_connection_id` (um dos dois obrigatório);\n * `template_name` + `template_language` são obrigatórios. A conta vem da chave,\n * nunca do corpo. (A rota NÃO aceita `customer_id` nem um objeto `template`.)\n */\nexport interface CreateBroadcastParams {\n name?: string;\n /** phone_number_id (Meta) do número de origem. */\n phone_number_id?: string;\n /** Alternativa a `phone_number_id`: a conexão WABA de origem. */\n waba_connection_id?: string;\n /** Nome do template aprovado (obrigatório). */\n template_name: string;\n /** Código de idioma do template, ex.: \"pt_BR\" (obrigatório). */\n template_language: string;\n /** Opcional: id interno do template (revalidado por ownership/conexão). */\n template_id?: string;\n}\n\n/** Transição de estado via `PATCH /v1/broadcasts/:id`. */\nexport interface UpdateBroadcastParams {\n /** `stopped` interrompe (sending/scheduled); `draft` cancela um agendamento. */\n status: \"stopped\" | \"draft\";\n}\n\nexport interface ScheduleBroadcastParams {\n /** Data/hora ISO 8601. */\n scheduled_at: string;\n [key: string]: unknown;\n}\n\n/** Filtros de `listRecipients` (paginação por cursor + filtro de status). */\nexport interface ListRecipientsParams extends CursorParams {\n /** Filtra por status do destinatário (ex.: \"pending\", \"sent\", \"failed\"). */\n status?: string;\n}\n\n/** Resultado de `addRecipients`: quantos entraram, quantos eram duplicados, erros. */\nexport interface AddRecipientsResult {\n added: number;\n duplicates: number;\n errors: unknown[];\n}\n\n/** Transmissões: criar, adicionar destinatários, agendar/enviar/cancelar. */\nexport class Broadcasts {\n constructor(private readonly client: BotoZap) {}\n\n /** Lista as transmissões da conta (paginação por offset/página). */\n list(params: ListBroadcastsParams = {}): Promise<OffsetList<Broadcast>> {\n return this.client.requestOffsetList<OffsetList<Broadcast>>(\"GET\", \"/broadcasts\", {\n query: {\n page: params.page,\n per_page: params.per_page,\n status: params.status,\n customer_id: params.customer_id,\n phone_number_id: params.phone_number_id,\n },\n });\n }\n\n get(id: string): Promise<Broadcast> {\n return this.client.requestItem<Broadcast>(\"GET\", `/broadcasts/${enc(id)}`);\n }\n\n create(params: CreateBroadcastParams): Promise<Broadcast> {\n return this.client.requestItem<Broadcast>(\"POST\", \"/broadcasts\", {\n body: params,\n });\n }\n\n update(id: string, params: UpdateBroadcastParams): Promise<Broadcast> {\n return this.client.requestItem<Broadcast>(\n \"PATCH\",\n `/broadcasts/${enc(id)}`,\n { body: params },\n );\n }\n\n /** Lista os destinatários de uma transmissão (paginação por cursor). */\n listRecipients(\n id: string,\n params: ListRecipientsParams = {},\n ): Promise<CursorList<BroadcastRecipient>> {\n return this.client.requestCursorList<CursorList<BroadcastRecipient>>(\n \"GET\",\n `/broadcasts/${enc(id)}/recipients`,\n {\n query: {\n limit: params.limit,\n after: params.after,\n before: params.before,\n status: params.status,\n },\n },\n );\n }\n\n /** Adiciona destinatários (lista de números ou contatos). */\n addRecipients(id: string, recipients: unknown[]): Promise<AddRecipientsResult> {\n return this.client.requestItem<AddRecipientsResult>(\n \"POST\",\n `/broadcasts/${enc(id)}/recipients`,\n { body: { recipients } },\n );\n }\n\n /** Remove TODOS os destinatários. Responde 204 (sem corpo). */\n removeRecipients(id: string): Promise<void> {\n return this.client.request<void>(\n \"DELETE\",\n `/broadcasts/${enc(id)}/recipients`,\n );\n }\n\n schedule(id: string, params: ScheduleBroadcastParams): Promise<Broadcast> {\n return this.client.requestItem<Broadcast>(\n \"POST\",\n `/broadcasts/${enc(id)}/schedule`,\n { body: params },\n );\n }\n\n send(id: string): Promise<Broadcast> {\n return this.client.requestItem<Broadcast>(\n \"POST\",\n `/broadcasts/${enc(id)}/send`,\n );\n }\n\n cancel(id: string): Promise<Broadcast> {\n return this.client.requestItem<Broadcast>(\n \"POST\",\n `/broadcasts/${enc(id)}/cancel`,\n );\n }\n}\n\nfunction enc(id: string): string {\n return encodeURIComponent(id);\n}\n","import type { BotoZap } from \"../client.js\";\nimport type { Contact, CursorList, CursorParams } from \"../types.js\";\n\nexport interface ListContactsParams extends CursorParams {\n /** Filtra pelos números do cliente (derivado da conexão do número). */\n customer_id?: string;\n /**\n * Nesta base todo contato pertence a um cliente; `false` nunca casa (página\n * vazia), `true` é no-op.\n */\n has_customer?: boolean;\n /** Busca parcial (ilike) no nome de perfil. */\n profile_name_contains?: string;\n /** Busca parcial (ilike) no wa_id. */\n wa_id_contains?: string;\n /** Criados em ou após esta data (ISO 8601). */\n created_after?: string;\n /** Criados em ou antes desta data (ISO 8601). */\n created_before?: string;\n}\n\nexport interface CreateContactParams {\n /** wa_id canônico (BSUID \"BR.1A2B…\" ou dígitos E.164). */\n wa_id: string;\n phone_number_id?: string;\n [key: string]: unknown;\n}\n\n/** Contatos: listar, buscar, criar, atualizar, remover. */\nexport class Contacts {\n constructor(private readonly client: BotoZap) {}\n\n /** Lista os contatos da conta (paginação por cursor). */\n list(params: ListContactsParams = {}): Promise<CursorList<Contact>> {\n return this.client.requestCursorList<CursorList<Contact>>(\"GET\", \"/contacts\", {\n query: {\n limit: params.limit,\n after: params.after,\n before: params.before,\n customer_id: params.customer_id,\n has_customer:\n params.has_customer === undefined\n ? undefined\n : String(params.has_customer),\n profile_name_contains: params.profile_name_contains,\n wa_id_contains: params.wa_id_contains,\n created_after: params.created_after,\n created_before: params.created_before,\n },\n });\n }\n\n get(id: string): Promise<Contact> {\n return this.client.requestItem<Contact>(\"GET\", `/contacts/${enc(id)}`);\n }\n\n create(params: CreateContactParams): Promise<Contact> {\n return this.client.requestItem<Contact>(\"POST\", \"/contacts\", {\n body: params,\n });\n }\n\n update(id: string, params: Record<string, unknown>): Promise<Contact> {\n return this.client.requestItem<Contact>(\"PATCH\", `/contacts/${enc(id)}`, {\n body: params,\n });\n }\n\n /** Remove um contato. Responde 204 (sem corpo). */\n delete(id: string): Promise<void> {\n return this.client.request<void>(\"DELETE\", `/contacts/${enc(id)}`);\n }\n}\n\nfunction enc(id: string): string {\n return encodeURIComponent(id);\n}\n","import type { BotoZap } from \"../client.js\";\nimport type {\n Assignment,\n Conversation,\n CursorList,\n CursorParams,\n OffsetList,\n OffsetParams,\n} from \"../types.js\";\n\nexport interface ListConversationsParams extends CursorParams {\n /** id da Meta OU uuid interno do número. */\n phone_number_id?: string;\n /** \"active\" | \"ended\" — derivado da janela de 24h. */\n status?: string;\n /**\n * Busca parcial por contato (nome de perfil, @username, telefone ou wa_id).\n * Tem precedência sobre `phone_number` na rota.\n */\n contact?: string;\n /** Alias de busca por contato (usado quando `contact` não é informado). */\n phone_number?: string;\n}\n\nexport interface CreateAssignmentParams {\n /** Membro a quem atribuir a conversa. */\n user_id: string;\n notes?: string;\n}\n\n/** Conversas (read + status) e atribuições a membros. */\nexport class Conversations {\n constructor(private readonly client: BotoZap) {}\n\n /** Lista as conversas da conta (paginação por cursor). */\n list(params: ListConversationsParams = {}): Promise<CursorList<Conversation>> {\n return this.client.requestCursorList<CursorList<Conversation>>(\n \"GET\",\n \"/conversations\",\n {\n query: {\n limit: params.limit,\n after: params.after,\n before: params.before,\n phone_number_id: params.phone_number_id,\n status: params.status,\n contact: params.contact,\n phone_number: params.phone_number,\n },\n },\n );\n }\n\n get(id: string): Promise<Conversation> {\n return this.client.requestItem<Conversation>(\n \"GET\",\n `/conversations/${enc(id)}`,\n );\n }\n\n update(id: string, params: Record<string, unknown>): Promise<Conversation> {\n return this.client.requestItem<Conversation>(\n \"PATCH\",\n `/conversations/${enc(id)}`,\n { body: params },\n );\n }\n\n /** Lista as atribuições da conversa (paginação por offset/página). */\n listAssignments(\n id: string,\n params: OffsetParams = {},\n ): Promise<OffsetList<Assignment>> {\n return this.client.requestOffsetList<OffsetList<Assignment>>(\n \"GET\",\n `/conversations/${enc(id)}/assignments`,\n { query: { page: params.page, per_page: params.per_page } },\n );\n }\n\n createAssignment(\n id: string,\n params: CreateAssignmentParams,\n ): Promise<Assignment> {\n return this.client.requestItem<Assignment>(\n \"POST\",\n `/conversations/${enc(id)}/assignments`,\n { body: params },\n );\n }\n\n getAssignment(id: string, assignmentId: string): Promise<Assignment> {\n return this.client.requestItem<Assignment>(\n \"GET\",\n `/conversations/${enc(id)}/assignments/${enc(assignmentId)}`,\n );\n }\n\n updateAssignment(\n id: string,\n assignmentId: string,\n params: Record<string, unknown>,\n ): Promise<Assignment> {\n return this.client.requestItem<Assignment>(\n \"PATCH\",\n `/conversations/${enc(id)}/assignments/${enc(assignmentId)}`,\n { body: params },\n );\n }\n}\n\nfunction enc(id: string): string {\n return encodeURIComponent(id);\n}\n","import type { BotoZap } from \"../client.js\";\nimport type { CursorList, CursorParams, Webhook } from \"../types.js\";\n\nexport interface CreateWebhookParams {\n url: string;\n events?: string[];\n active?: boolean;\n [key: string]: unknown;\n}\n\n/** Webhooks: endpoints assinados que recebem os eventos da conta. */\nexport class Webhooks {\n constructor(private readonly client: BotoZap) {}\n\n /** Lista os endpoints de webhook da conta (paginação por cursor). */\n list(params: CursorParams = {}): Promise<CursorList<Webhook>> {\n return this.client.requestCursorList<CursorList<Webhook>>(\"GET\", \"/webhooks\", {\n query: {\n limit: params.limit,\n after: params.after,\n before: params.before,\n },\n });\n }\n\n get(id: string): Promise<Webhook> {\n return this.client.requestItem<Webhook>(\"GET\", `/webhooks/${enc(id)}`);\n }\n\n create(params: CreateWebhookParams): Promise<Webhook> {\n return this.client.requestItem<Webhook>(\"POST\", \"/webhooks\", {\n body: params,\n });\n }\n\n update(id: string, params: Record<string, unknown>): Promise<Webhook> {\n return this.client.requestItem<Webhook>(\"PATCH\", `/webhooks/${enc(id)}`, {\n body: params,\n });\n }\n\n /** Remove um endpoint. Responde 204 (sem corpo). */\n delete(id: string): Promise<void> {\n return this.client.request<void>(\"DELETE\", `/webhooks/${enc(id)}`);\n }\n\n /** Dispara um evento de teste para o endpoint. */\n test(id: string): Promise<{ success: boolean }> {\n return this.client.requestItem<{ success: boolean }>(\n \"POST\",\n `/webhooks/${enc(id)}/test`,\n );\n }\n}\n\nfunction enc(id: string): string {\n return encodeURIComponent(id);\n}\n","import type { BotoZap } from \"../client.js\";\nimport type { OffsetList, OffsetParams, PhoneNumber } from \"../types.js\";\n\nexport interface ListPhoneNumbersParams extends OffsetParams {\n customer_id?: string;\n}\n\n/** Números conectados de cada cliente. */\nexport class PhoneNumbers {\n constructor(private readonly client: BotoZap) {}\n\n /** Lista os números da conta (paginação por offset/página). */\n list(params: ListPhoneNumbersParams = {}): Promise<OffsetList<PhoneNumber>> {\n return this.client.requestOffsetList<OffsetList<PhoneNumber>>(\n \"GET\",\n \"/phone_numbers\",\n {\n query: {\n page: params.page,\n per_page: params.per_page,\n customer_id: params.customer_id,\n },\n },\n );\n }\n\n get(id: string): Promise<PhoneNumber> {\n return this.client.requestItem<PhoneNumber>(\n \"GET\",\n `/phone_numbers/${enc(id)}`,\n );\n }\n\n // NOTA: `update` foi removido de propósito. A rota PATCH /v1/phone_numbers/:id\n // responde SEMPRE 422 `no_updatable_fields` — o schema atual só tem campos de\n // identidade e campos sincronizados da Meta, nenhum editável por aqui. Expor o\n // método só entregaria uma chamada garantidamente quebrada.\n\n /** Remove um número. Responde 204 (sem corpo). */\n delete(id: string): Promise<void> {\n return this.client.request<void>(\"DELETE\", `/phone_numbers/${enc(id)}`);\n }\n\n /** Saúde do número (qualidade, limite, status na Meta). */\n health(id: string): Promise<Record<string, unknown>> {\n return this.client.requestItem<Record<string, unknown>>(\n \"GET\",\n `/phone_numbers/${enc(id)}/health`,\n );\n }\n}\n\nfunction enc(id: string): string {\n return encodeURIComponent(id);\n}\n","import type { BotoZap } from \"../client.js\";\nimport type { Flow, FlowVersion, OffsetList, OffsetParams } from \"../types.js\";\n\nexport interface CreateFlowParams {\n name?: string;\n [key: string]: unknown;\n}\n\n/**\n * Filtros de `flows.list` (paginação por offset). Flows vivem na Meta e a lista\n * é por WABA — a rota GET /v1/flows EXIGE `phone_number_id` OU\n * `waba_connection_id` (sem um deles responde 422 missing_target). Informe um.\n */\nexport interface ListFlowsParams extends OffsetParams {\n /** phone_number_id (Meta) → resolve a conexão do número (escopado por conta). */\n phone_number_id?: string;\n /** Alternativa a `phone_number_id`: a conexão WABA cujos flows listar. */\n waba_connection_id?: string;\n}\n\n/**\n * Flows vivem na Meta, não no nosso banco — a amarração flow → conta é via\n * `phone_number_id` (resolve a WABA e o token). Por isso get/delete/publish/\n * setup_encryption/versions/data_endpoint EXIGEM `phone_number_id`.\n */\nexport interface FlowPhoneParams {\n /** phone_number_id (Meta) do número cuja WABA hospeda o flow. */\n phone_number_id: string;\n}\n\n/** Corpo de `POST /v1/flows/:id/versions` — sobe um novo flow.json. */\nexport interface CreateFlowVersionParams {\n phone_number_id: string;\n /** JSON do flow (objeto ou string JSON válida). */\n flow_json: unknown;\n [key: string]: unknown;\n}\n\n/** Corpo de `POST /v1/flows/:id/data_endpoint` — conecta a forward URL do dev. */\nexport interface SetFlowDataEndpointParams {\n phone_number_id: string;\n /** URL HTTPS do backend do dev que recebe o data_exchange. */\n forward_url: string;\n [key: string]: unknown;\n}\n\n/** WhatsApp Flows: criar, versionar, publicar e configurar data endpoint. */\nexport class Flows {\n constructor(private readonly client: BotoZap) {}\n\n /**\n * Lista os flows de uma WABA (paginação por offset/página). Informe\n * `phone_number_id` OU `waba_connection_id` — a rota exige um deles.\n */\n list(params: ListFlowsParams = {}): Promise<OffsetList<Flow>> {\n return this.client.requestOffsetList<OffsetList<Flow>>(\"GET\", \"/flows\", {\n query: {\n page: params.page,\n per_page: params.per_page,\n phone_number_id: params.phone_number_id,\n waba_connection_id: params.waba_connection_id,\n },\n });\n }\n\n get(id: string, params: FlowPhoneParams): Promise<Flow> {\n return this.client.requestItem<Flow>(\"GET\", `/flows/${enc(id)}`, {\n query: { phone_number_id: params.phone_number_id },\n });\n }\n\n create(params: CreateFlowParams): Promise<Flow> {\n return this.client.requestItem<Flow>(\"POST\", \"/flows\", { body: params });\n }\n\n /** Remove um flow (só DRAFT, regra da Meta). Responde 204 (sem corpo). */\n delete(id: string, params: FlowPhoneParams): Promise<void> {\n return this.client.request<void>(\"DELETE\", `/flows/${enc(id)}`, {\n query: { phone_number_id: params.phone_number_id },\n });\n }\n\n publish(id: string, params: FlowPhoneParams): Promise<Flow> {\n return this.client.requestItem<Flow>(\"POST\", `/flows/${enc(id)}/publish`, {\n body: { phone_number_id: params.phone_number_id },\n });\n }\n\n /** Lista as versões de um flow (paginação por offset/página). */\n listVersions(\n id: string,\n params: OffsetParams = {},\n ): Promise<OffsetList<FlowVersion>> {\n return this.client.requestOffsetList<OffsetList<FlowVersion>>(\n \"GET\",\n `/flows/${enc(id)}/versions`,\n { query: { page: params.page, per_page: params.per_page } },\n );\n }\n\n createVersion(\n id: string,\n params: CreateFlowVersionParams,\n ): Promise<FlowVersion> {\n return this.client.requestItem<FlowVersion>(\n \"POST\",\n `/flows/${enc(id)}/versions`,\n { body: params },\n );\n }\n\n setupEncryption(\n id: string,\n params: FlowPhoneParams,\n ): Promise<Record<string, unknown>> {\n return this.client.requestItem<Record<string, unknown>>(\n \"POST\",\n `/flows/${enc(id)}/setup_encryption`,\n { body: { phone_number_id: params.phone_number_id } },\n );\n }\n\n getDataEndpoint(id: string): Promise<Record<string, unknown>> {\n return this.client.requestItem<Record<string, unknown>>(\n \"GET\",\n `/flows/${enc(id)}/data_endpoint`,\n );\n }\n\n setDataEndpoint(\n id: string,\n params: SetFlowDataEndpointParams,\n ): Promise<Record<string, unknown>> {\n return this.client.requestItem<Record<string, unknown>>(\n \"POST\",\n `/flows/${enc(id)}/data_endpoint`,\n { body: params },\n );\n }\n}\n\nfunction enc(id: string): string {\n return encodeURIComponent(id);\n}\n","import type { BotoZap } from \"../client.js\";\nimport type { MediaAsset, MediaUploadResult } from \"../types.js\";\n\n/** Corpo do `POST /v1/media` — espelha o contrato real da rota. */\nexport interface UploadMediaParams {\n /** URL http(s) de origem do arquivo. A BotoZap baixa (com guard SSRF) e sobe pra Cloud API. */\n source: string;\n /** phone_number_id (da Meta) do número de origem. Obrigatório. */\n phone_number_id: string;\n /** Nome do arquivo (default: derivado da URL). */\n filename?: string;\n /** MIME type (default: Content-Type do download). */\n mime_type?: string;\n /** Pipeline de upload: `meta_media` (default) ou `meta_resumable_asset`. */\n delivery?: \"meta_media\" | \"meta_resumable_asset\";\n [key: string]: unknown;\n}\n\n/** Mídia: sobe um arquivo e devolve um media_id usável em mensagens. */\nexport class Media {\n constructor(private readonly client: BotoZap) {}\n\n upload(params: UploadMediaParams): Promise<MediaUploadResult> {\n return this.client.requestItem<MediaUploadResult>(\"POST\", \"/media\", {\n body: params,\n });\n }\n\n /**\n * Busca os metadados de uma mídia RECEBIDA pelo `media_id` da Cloud API,\n * incluindo `download_url` — uma URL assinada e efêmera que você pode baixar\n * direto (GET), válida até `expires_at`.\n *\n * A mídia é espelhada de forma assíncrona; se você consultar antes de terminar,\n * a rota responde 202 e este método lança `BotoZapError` com\n * `code: \"media_not_ready\"`. Nesse caso, aguarde e retente — o segundo que faltar\n * está em `err.headers?.[\"retry-after\"]`:\n *\n * ```ts\n * try {\n * const media = await boto.media.get(\"wamid_media_id\");\n * // baixe media.download_url direto\n * } catch (err) {\n * if (err instanceof BotoZapError && err.code === \"media_not_ready\") {\n * const wait = Number(err.headers?.[\"retry-after\"] ?? 5);\n * // retente após `wait` segundos\n * }\n * }\n * ```\n *\n * Existe também `GET /v1/media/:id/download`, que responde 302 redirecionando\n * para a mesma URL assinada; não há método SDK dedicado porque `download_url`\n * (acima) já entrega essa URL sem o hop de redirect.\n */\n get(id: string): Promise<MediaAsset> {\n return this.client.requestItem<MediaAsset>(\n \"GET\",\n `/media/${encodeURIComponent(id)}`,\n );\n }\n}\n","import type { BotoZap } from \"../client.js\";\nimport type {\n ApiLog,\n CursorList,\n CursorParams,\n OffsetList,\n OffsetParams,\n User,\n WebhookDelivery,\n} from \"../types.js\";\n\n/** Membros da conta (somente leitura via API). */\nexport class Users {\n constructor(private readonly client: BotoZap) {}\n\n /** Lista os membros da conta (paginação por offset/página). */\n list(params: OffsetParams = {}): Promise<OffsetList<User>> {\n return this.client.requestOffsetList<OffsetList<User>>(\"GET\", \"/users\", {\n query: { page: params.page, per_page: params.per_page },\n });\n }\n}\n\nexport interface ListApiLogsParams extends CursorParams {\n /** Origem do log (ex.: \"api\"). */\n source?: string;\n /** Método HTTP (a rota normaliza para maiúsculas). */\n method?: string;\n /** Código HTTP exato (inteiro). */\n status_code?: number;\n}\n\n/** Logs de requisições à API (somente leitura, paginação por cursor). */\nexport class ApiLogs {\n constructor(private readonly client: BotoZap) {}\n\n list(params: ListApiLogsParams = {}): Promise<CursorList<ApiLog>> {\n return this.client.requestCursorList<CursorList<ApiLog>>(\"GET\", \"/api_logs\", {\n query: {\n limit: params.limit,\n after: params.after,\n before: params.before,\n source: params.source,\n method: params.method,\n status_code: params.status_code,\n },\n });\n }\n}\n\nexport interface ListWebhookDeliveriesParams extends CursorParams {\n /** Alias de `endpoint_id` na rota — entregas de um endpoint específico. */\n webhook_id?: string;\n /** delivery_status (pending|success|failed|exhausted). */\n status?: string;\n /** Tipo do evento (ex.: \"webhook.test\", \"messages\"). */\n event_type?: string;\n}\n\n/** Histórico de entregas de webhook (somente leitura, paginação por cursor). */\nexport class WebhookDeliveries {\n constructor(private readonly client: BotoZap) {}\n\n list(\n params: ListWebhookDeliveriesParams = {},\n ): Promise<CursorList<WebhookDelivery>> {\n return this.client.requestCursorList<CursorList<WebhookDelivery>>(\n \"GET\",\n \"/webhook_deliveries\",\n {\n query: {\n limit: params.limit,\n after: params.after,\n before: params.before,\n webhook_id: params.webhook_id,\n status: params.status,\n event_type: params.event_type,\n },\n },\n );\n }\n}\n","import { BotoZapError } from \"./errors.js\";\nimport { Messages } from \"./resources/messages.js\";\nimport { Customers } from \"./resources/customers.js\";\nimport { Templates } from \"./resources/templates.js\";\nimport { Broadcasts } from \"./resources/broadcasts.js\";\nimport { Contacts } from \"./resources/contacts.js\";\nimport { Conversations } from \"./resources/conversations.js\";\nimport { Webhooks } from \"./resources/webhooks.js\";\nimport { PhoneNumbers } from \"./resources/phone-numbers.js\";\nimport { Flows } from \"./resources/flows.js\";\nimport { Media } from \"./resources/media.js\";\nimport { Users, ApiLogs, WebhookDeliveries } from \"./resources/read-only.js\";\n\nexport interface BotoZapOptions {\n /** Chave de API da conta (cabeçalho Authorization: Bearer). */\n apiKey: string;\n /** Sobrescreve a URL base. Padrão: https://botozap.com.br/api/v1 */\n baseUrl?: string;\n /** Injeta um fetch (testes, runtimes sem fetch global). */\n fetch?: typeof fetch;\n}\n\nexport interface RequestOptions {\n query?: Record<string, string | number | undefined>;\n body?: unknown;\n}\n\nconst DEFAULT_BASE_URL = \"https://botozap.com.br/api/v1\";\n\n/**\n * Cliente da API da BotoZap.\n *\n * ```ts\n * const boto = new BotoZap({ apiKey: process.env.BOTOZAP_KEY! });\n * await boto.messages.send({ to: \"+5531988887777\", text: \"Olá!\" });\n * ```\n */\nexport class BotoZap {\n readonly messages: Messages;\n readonly customers: Customers;\n readonly templates: Templates;\n readonly broadcasts: Broadcasts;\n readonly contacts: Contacts;\n readonly conversations: Conversations;\n readonly webhooks: Webhooks;\n readonly phoneNumbers: PhoneNumbers;\n readonly flows: Flows;\n readonly media: Media;\n readonly users: Users;\n readonly apiLogs: ApiLogs;\n readonly webhookDeliveries: WebhookDeliveries;\n\n private readonly apiKey: string;\n private readonly baseUrl: string;\n private readonly fetchImpl: typeof fetch;\n\n constructor(options: BotoZapOptions) {\n if (!options || !options.apiKey) {\n throw new Error(\"BotoZap: apiKey é obrigatório.\");\n }\n this.apiKey = options.apiKey;\n this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n\n const resolvedFetch = options.fetch ?? globalThis.fetch;\n if (typeof resolvedFetch !== \"function\") {\n throw new Error(\n \"BotoZap: fetch global não encontrado. Use Node 20.19+ ou passe a opção `fetch`.\",\n );\n }\n this.fetchImpl = resolvedFetch;\n\n this.messages = new Messages(this);\n this.customers = new Customers(this);\n this.templates = new Templates(this);\n this.broadcasts = new Broadcasts(this);\n this.contacts = new Contacts(this);\n this.conversations = new Conversations(this);\n this.webhooks = new Webhooks(this);\n this.phoneNumbers = new PhoneNumbers(this);\n this.flows = new Flows(this);\n this.media = new Media(this);\n this.users = new Users(this);\n this.apiLogs = new ApiLogs(this);\n this.webhookDeliveries = new WebhookDeliveries(this);\n }\n\n /** Faz uma requisição autenticada e devolve o corpo já parseado. */\n async request<T>(\n method: string,\n path: string,\n opts: RequestOptions = {},\n ): Promise<T> {\n const url = new URL(this.baseUrl + path);\n if (opts.query) {\n for (const [key, value] of Object.entries(opts.query)) {\n if (value !== undefined) url.searchParams.set(key, String(value));\n }\n }\n\n let res: Awaited<ReturnType<typeof fetch>>;\n try {\n res = await this.fetchImpl(url.toString(), {\n method,\n headers: {\n Authorization: `Bearer ${this.apiKey}`,\n \"Content-Type\": \"application/json\",\n Accept: \"application/json\",\n },\n body: opts.body === undefined ? undefined : JSON.stringify(opts.body),\n });\n } catch (cause) {\n // `fetch` REJEITA (DNS, conexão recusada, offline, abort) com um TypeError\n // — não é uma resposta HTTP. Se vazasse cru, o chamador teria dois tipos de\n // erro pra tratar (BotoZapError vs. TypeError). Embrulhamos num BotoZapError\n // de rede: um único tipo pra capturar, com `code` distinguindo rede de HTTP.\n // status 0 = não houve resposta HTTP.\n const detail = cause instanceof Error ? cause.message : String(cause);\n throw new BotoZapError(\n \"network_error\",\n `falha de rede ao chamar a API: ${detail}`,\n 0,\n );\n }\n\n const raw = await res.text();\n const data = raw ? safeJson(raw) : undefined;\n\n const envelope = data as\n | { error?: { code?: string; message?: string } }\n | undefined;\n // Um corpo `{ error: {...} }` é um ERRO ainda que o status seja 2xx. A rota\n // `GET /v1/media/:id` usa exatamente isso: quando a mídia ainda está sendo\n // espelhada, responde 202 + `{error:{code:\"media_not_ready\"}}` + `Retry-After`\n // (o dev deve retentar). Sem tratar o envelope aqui, o 202 passaria como\n // \"sucesso\" e o desempacote de item viraria um `malformed_response` genérico\n // — o dev não conseguiria distinguir o \"retente em instantes\".\n const hasErrorEnvelope =\n typeof envelope === \"object\" &&\n envelope !== null &&\n typeof envelope.error === \"object\" &&\n envelope.error !== null;\n\n if (!res.ok || hasErrorEnvelope) {\n // Expõe os headers da RESPOSTA no erro — num 429 (ou no 202 media_not_ready)\n // o chamador precisa de `Retry-After`/`X-RateLimit-*` para saber quando\n // reenviar. Só headers da resposta; nada do request (que carrega a apiKey)\n // toca este objeto.\n const headers: Record<string, string> = {};\n res.headers.forEach((value, key) => {\n headers[key] = value;\n });\n throw new BotoZapError(\n envelope?.error?.code ?? \"http_error\",\n envelope?.error?.message ?? `HTTP ${res.status}`,\n res.status,\n headers,\n );\n }\n\n return data as T;\n }\n\n /**\n * Requisição a um endpoint de ITEM (singular). A API embrulha essas respostas\n * em `{ data: <obj> }` (helper `ok`); este método desempacota e devolve a\n * entidade. NÃO é uma heurística \"se tem .data desempacota\" — o desempacote é\n * o contrato conhecido do endpoint, declarado por quem chama este método (as\n * rotas de LISTA usam `request` e devolvem `{ data, paging|meta }` inteiro; a\n * rota POST /messages responde direto e também usa `request`).\n */\n async requestItem<T>(\n method: string,\n path: string,\n opts: RequestOptions = {},\n ): Promise<T> {\n const env = await this.request<{ data: T }>(method, path, opts);\n // Contrato: endpoints de ITEM respondem `{ data: <obj> }`. Sem a chave\n // `data`, `(env).data` seria `undefined` SILENCIOSO — o chamador recebe\n // undefined e só quebra lá na frente, longe da causa. Falha alto e claro\n // aqui. (`data: null` explícito PASSA — a chave existe; é 200-sem-envelope\n // que é violação.) status 0 = erro de contrato do cliente, não HTTP.\n if (env == null || typeof env !== \"object\" || !(\"data\" in env)) {\n throw new BotoZapError(\n \"malformed_response\",\n \"resposta sem envelope data — contrato violado\",\n 0,\n );\n }\n return (env as { data: T }).data;\n }\n\n /** Resposta JSON direta que precisa ser um objeto (ex.: POST /messages). */\n async requestObject<T>(\n method: string,\n path: string,\n opts: RequestOptions = {},\n ): Promise<T> {\n const value = await this.request<unknown>(method, path, opts);\n if (!isObject(value)) {\n throw malformed(\"resposta deveria ser um objeto JSON\");\n }\n return value as T;\n }\n\n /** Lista paginada por cursor: exige `{ data: [], paging: {} }`. */\n async requestCursorList<T>(\n method: string,\n path: string,\n opts: RequestOptions = {},\n ): Promise<T> {\n const value = await this.request<unknown>(method, path, opts);\n if (!isObject(value) || !Array.isArray(value.data) || !isObject(value.paging)) {\n throw malformed(\"resposta sem data[]/paging — contrato de cursor violado\");\n }\n return value as T;\n }\n\n /** Lista paginada por offset: exige `{ data: [], meta: {} }`. */\n async requestOffsetList<T>(\n method: string,\n path: string,\n opts: RequestOptions = {},\n ): Promise<T> {\n const value = await this.request<unknown>(method, path, opts);\n if (!isObject(value) || !Array.isArray(value.data) || !isObject(value.meta)) {\n throw malformed(\"resposta sem data[]/meta — contrato de offset violado\");\n }\n return value as T;\n }\n}\n\nfunction isObject(value: unknown): value is Record<string, unknown> {\n return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction malformed(message: string): BotoZapError {\n return new BotoZapError(\"malformed_response\", message, 0);\n}\n\nfunction safeJson(text: string): unknown {\n try {\n return JSON.parse(text);\n } catch {\n return text;\n }\n}\n"],"mappings":"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","names":["enc","enc","enc","enc","enc","enc"]}
|
package/dist/index.d.cts
CHANGED
|
@@ -149,6 +149,28 @@ interface MediaUploadResult {
|
|
|
149
149
|
[key: string]: unknown;
|
|
150
150
|
};
|
|
151
151
|
}
|
|
152
|
+
/**
|
|
153
|
+
* Retorno de GET /v1/media/:id — metadados de uma mídia RECEBIDA (inbound) já
|
|
154
|
+
* espelhada, mais a `download_url` (URL assinada, efêmera) para baixar o binário.
|
|
155
|
+
* O `id` é o `media_id` da Cloud API (não um uuid interno).
|
|
156
|
+
*
|
|
157
|
+
* `mime_type`/`file_size`/`sha256` podem vir `null` (a Meta nem sempre informa
|
|
158
|
+
* todos). Se a mídia AINDA está sendo espelhada, a rota responde 202 e o SDK
|
|
159
|
+
* lança `BotoZapError` com `code: "media_not_ready"` (ver `media.get`) — nesse
|
|
160
|
+
* caso este objeto nunca é devolvido.
|
|
161
|
+
*/
|
|
162
|
+
interface MediaAsset {
|
|
163
|
+
/** media_id da Cloud API. */
|
|
164
|
+
id: string;
|
|
165
|
+
mime_type: string | null;
|
|
166
|
+
/** Tamanho em bytes. */
|
|
167
|
+
file_size: number | null;
|
|
168
|
+
sha256: string | null;
|
|
169
|
+
/** URL assinada para baixar o binário. Válida até `expires_at`. */
|
|
170
|
+
download_url: string;
|
|
171
|
+
/** ISO 8601 — quando a `download_url` deixa de valer. */
|
|
172
|
+
expires_at: string;
|
|
173
|
+
}
|
|
152
174
|
/**
|
|
153
175
|
* Link de setup de um cliente (Embedded Signup). Shape do contrato
|
|
154
176
|
* (ver `/v1/customers/:id/setup_links`): a `url` embute o token opaco; o token
|
|
@@ -562,6 +584,33 @@ declare class Media {
|
|
|
562
584
|
private readonly client;
|
|
563
585
|
constructor(client: BotoZap);
|
|
564
586
|
upload(params: UploadMediaParams): Promise<MediaUploadResult>;
|
|
587
|
+
/**
|
|
588
|
+
* Busca os metadados de uma mídia RECEBIDA pelo `media_id` da Cloud API,
|
|
589
|
+
* incluindo `download_url` — uma URL assinada e efêmera que você pode baixar
|
|
590
|
+
* direto (GET), válida até `expires_at`.
|
|
591
|
+
*
|
|
592
|
+
* A mídia é espelhada de forma assíncrona; se você consultar antes de terminar,
|
|
593
|
+
* a rota responde 202 e este método lança `BotoZapError` com
|
|
594
|
+
* `code: "media_not_ready"`. Nesse caso, aguarde e retente — o segundo que faltar
|
|
595
|
+
* está em `err.headers?.["retry-after"]`:
|
|
596
|
+
*
|
|
597
|
+
* ```ts
|
|
598
|
+
* try {
|
|
599
|
+
* const media = await boto.media.get("wamid_media_id");
|
|
600
|
+
* // baixe media.download_url direto
|
|
601
|
+
* } catch (err) {
|
|
602
|
+
* if (err instanceof BotoZapError && err.code === "media_not_ready") {
|
|
603
|
+
* const wait = Number(err.headers?.["retry-after"] ?? 5);
|
|
604
|
+
* // retente após `wait` segundos
|
|
605
|
+
* }
|
|
606
|
+
* }
|
|
607
|
+
* ```
|
|
608
|
+
*
|
|
609
|
+
* Existe também `GET /v1/media/:id/download`, que responde 302 redirecionando
|
|
610
|
+
* para a mesma URL assinada; não há método SDK dedicado porque `download_url`
|
|
611
|
+
* (acima) já entrega essa URL sem o hop de redirect.
|
|
612
|
+
*/
|
|
613
|
+
get(id: string): Promise<MediaAsset>;
|
|
565
614
|
}
|
|
566
615
|
|
|
567
616
|
/** Membros da conta (somente leitura via API). */
|
|
@@ -672,4 +721,4 @@ declare class BotoZapError extends Error {
|
|
|
672
721
|
constructor(code: string, message: string, status: number, headers?: Record<string, string>);
|
|
673
722
|
}
|
|
674
723
|
|
|
675
|
-
export { type AddRecipientsResult, type ApiLog, type Assignment, BotoZap, BotoZapError, type BotoZapOptions, type Broadcast, type BroadcastRecipient, type Contact, type Conversation, type CreateAssignmentParams, type CreateBroadcastParams, type CreateContactParams, type CreateCustomerParams, type CreateFlowParams, type CreateFlowVersionParams, type CreateSetupLinkParams, type CreateTemplateParams, type CreateWebhookParams, type CursorList, type CursorPaging, type CursorParams, type Customer, type Flow, type FlowPhoneParams, type FlowVersion, type ListApiLogsParams, type ListBroadcastsParams, type ListContactsParams, type ListConversationsParams, type ListFlowsParams, type ListMessagesParams, type ListPhoneNumbersParams, type ListRecipientsParams, type ListTemplatesParams, type ListWebhookDeliveriesParams, type MediaUploadResult, type Message, type MessageStatus, type OffsetList, type OffsetMeta, type OffsetParams, type PhoneNumber, type RequestOptions, type ScheduleBroadcastParams, type SendResult, type SendTemplateParams, type SendTextParams, type SetFlowDataEndpointParams, type SetupLink, type Template, type TemplatePayload, type UpdateBroadcastParams, type UpdateCustomerParams, type UpdateSetupLinkParams, type UploadMediaParams, type User, type Webhook, type WebhookDelivery };
|
|
724
|
+
export { type AddRecipientsResult, type ApiLog, type Assignment, BotoZap, BotoZapError, type BotoZapOptions, type Broadcast, type BroadcastRecipient, type Contact, type Conversation, type CreateAssignmentParams, type CreateBroadcastParams, type CreateContactParams, type CreateCustomerParams, type CreateFlowParams, type CreateFlowVersionParams, type CreateSetupLinkParams, type CreateTemplateParams, type CreateWebhookParams, type CursorList, type CursorPaging, type CursorParams, type Customer, type Flow, type FlowPhoneParams, type FlowVersion, type ListApiLogsParams, type ListBroadcastsParams, type ListContactsParams, type ListConversationsParams, type ListFlowsParams, type ListMessagesParams, type ListPhoneNumbersParams, type ListRecipientsParams, type ListTemplatesParams, type ListWebhookDeliveriesParams, type MediaAsset, type MediaUploadResult, type Message, type MessageStatus, type OffsetList, type OffsetMeta, type OffsetParams, type PhoneNumber, type RequestOptions, type ScheduleBroadcastParams, type SendResult, type SendTemplateParams, type SendTextParams, type SetFlowDataEndpointParams, type SetupLink, type Template, type TemplatePayload, type UpdateBroadcastParams, type UpdateCustomerParams, type UpdateSetupLinkParams, type UploadMediaParams, type User, type Webhook, type WebhookDelivery };
|
package/dist/index.d.ts
CHANGED
|
@@ -149,6 +149,28 @@ interface MediaUploadResult {
|
|
|
149
149
|
[key: string]: unknown;
|
|
150
150
|
};
|
|
151
151
|
}
|
|
152
|
+
/**
|
|
153
|
+
* Retorno de GET /v1/media/:id — metadados de uma mídia RECEBIDA (inbound) já
|
|
154
|
+
* espelhada, mais a `download_url` (URL assinada, efêmera) para baixar o binário.
|
|
155
|
+
* O `id` é o `media_id` da Cloud API (não um uuid interno).
|
|
156
|
+
*
|
|
157
|
+
* `mime_type`/`file_size`/`sha256` podem vir `null` (a Meta nem sempre informa
|
|
158
|
+
* todos). Se a mídia AINDA está sendo espelhada, a rota responde 202 e o SDK
|
|
159
|
+
* lança `BotoZapError` com `code: "media_not_ready"` (ver `media.get`) — nesse
|
|
160
|
+
* caso este objeto nunca é devolvido.
|
|
161
|
+
*/
|
|
162
|
+
interface MediaAsset {
|
|
163
|
+
/** media_id da Cloud API. */
|
|
164
|
+
id: string;
|
|
165
|
+
mime_type: string | null;
|
|
166
|
+
/** Tamanho em bytes. */
|
|
167
|
+
file_size: number | null;
|
|
168
|
+
sha256: string | null;
|
|
169
|
+
/** URL assinada para baixar o binário. Válida até `expires_at`. */
|
|
170
|
+
download_url: string;
|
|
171
|
+
/** ISO 8601 — quando a `download_url` deixa de valer. */
|
|
172
|
+
expires_at: string;
|
|
173
|
+
}
|
|
152
174
|
/**
|
|
153
175
|
* Link de setup de um cliente (Embedded Signup). Shape do contrato
|
|
154
176
|
* (ver `/v1/customers/:id/setup_links`): a `url` embute o token opaco; o token
|
|
@@ -562,6 +584,33 @@ declare class Media {
|
|
|
562
584
|
private readonly client;
|
|
563
585
|
constructor(client: BotoZap);
|
|
564
586
|
upload(params: UploadMediaParams): Promise<MediaUploadResult>;
|
|
587
|
+
/**
|
|
588
|
+
* Busca os metadados de uma mídia RECEBIDA pelo `media_id` da Cloud API,
|
|
589
|
+
* incluindo `download_url` — uma URL assinada e efêmera que você pode baixar
|
|
590
|
+
* direto (GET), válida até `expires_at`.
|
|
591
|
+
*
|
|
592
|
+
* A mídia é espelhada de forma assíncrona; se você consultar antes de terminar,
|
|
593
|
+
* a rota responde 202 e este método lança `BotoZapError` com
|
|
594
|
+
* `code: "media_not_ready"`. Nesse caso, aguarde e retente — o segundo que faltar
|
|
595
|
+
* está em `err.headers?.["retry-after"]`:
|
|
596
|
+
*
|
|
597
|
+
* ```ts
|
|
598
|
+
* try {
|
|
599
|
+
* const media = await boto.media.get("wamid_media_id");
|
|
600
|
+
* // baixe media.download_url direto
|
|
601
|
+
* } catch (err) {
|
|
602
|
+
* if (err instanceof BotoZapError && err.code === "media_not_ready") {
|
|
603
|
+
* const wait = Number(err.headers?.["retry-after"] ?? 5);
|
|
604
|
+
* // retente após `wait` segundos
|
|
605
|
+
* }
|
|
606
|
+
* }
|
|
607
|
+
* ```
|
|
608
|
+
*
|
|
609
|
+
* Existe também `GET /v1/media/:id/download`, que responde 302 redirecionando
|
|
610
|
+
* para a mesma URL assinada; não há método SDK dedicado porque `download_url`
|
|
611
|
+
* (acima) já entrega essa URL sem o hop de redirect.
|
|
612
|
+
*/
|
|
613
|
+
get(id: string): Promise<MediaAsset>;
|
|
565
614
|
}
|
|
566
615
|
|
|
567
616
|
/** Membros da conta (somente leitura via API). */
|
|
@@ -672,4 +721,4 @@ declare class BotoZapError extends Error {
|
|
|
672
721
|
constructor(code: string, message: string, status: number, headers?: Record<string, string>);
|
|
673
722
|
}
|
|
674
723
|
|
|
675
|
-
export { type AddRecipientsResult, type ApiLog, type Assignment, BotoZap, BotoZapError, type BotoZapOptions, type Broadcast, type BroadcastRecipient, type Contact, type Conversation, type CreateAssignmentParams, type CreateBroadcastParams, type CreateContactParams, type CreateCustomerParams, type CreateFlowParams, type CreateFlowVersionParams, type CreateSetupLinkParams, type CreateTemplateParams, type CreateWebhookParams, type CursorList, type CursorPaging, type CursorParams, type Customer, type Flow, type FlowPhoneParams, type FlowVersion, type ListApiLogsParams, type ListBroadcastsParams, type ListContactsParams, type ListConversationsParams, type ListFlowsParams, type ListMessagesParams, type ListPhoneNumbersParams, type ListRecipientsParams, type ListTemplatesParams, type ListWebhookDeliveriesParams, type MediaUploadResult, type Message, type MessageStatus, type OffsetList, type OffsetMeta, type OffsetParams, type PhoneNumber, type RequestOptions, type ScheduleBroadcastParams, type SendResult, type SendTemplateParams, type SendTextParams, type SetFlowDataEndpointParams, type SetupLink, type Template, type TemplatePayload, type UpdateBroadcastParams, type UpdateCustomerParams, type UpdateSetupLinkParams, type UploadMediaParams, type User, type Webhook, type WebhookDelivery };
|
|
724
|
+
export { type AddRecipientsResult, type ApiLog, type Assignment, BotoZap, BotoZapError, type BotoZapOptions, type Broadcast, type BroadcastRecipient, type Contact, type Conversation, type CreateAssignmentParams, type CreateBroadcastParams, type CreateContactParams, type CreateCustomerParams, type CreateFlowParams, type CreateFlowVersionParams, type CreateSetupLinkParams, type CreateTemplateParams, type CreateWebhookParams, type CursorList, type CursorPaging, type CursorParams, type Customer, type Flow, type FlowPhoneParams, type FlowVersion, type ListApiLogsParams, type ListBroadcastsParams, type ListContactsParams, type ListConversationsParams, type ListFlowsParams, type ListMessagesParams, type ListPhoneNumbersParams, type ListRecipientsParams, type ListTemplatesParams, type ListWebhookDeliveriesParams, type MediaAsset, type MediaUploadResult, type Message, type MessageStatus, type OffsetList, type OffsetMeta, type OffsetParams, type PhoneNumber, type RequestOptions, type ScheduleBroadcastParams, type SendResult, type SendTemplateParams, type SendTextParams, type SetFlowDataEndpointParams, type SetupLink, type Template, type TemplatePayload, type UpdateBroadcastParams, type UpdateCustomerParams, type UpdateSetupLinkParams, type UploadMediaParams, type User, type Webhook, type WebhookDelivery };
|
package/dist/index.js
CHANGED
|
@@ -555,6 +555,38 @@ var Media = class {
|
|
|
555
555
|
body: params
|
|
556
556
|
});
|
|
557
557
|
}
|
|
558
|
+
/**
|
|
559
|
+
* Busca os metadados de uma mídia RECEBIDA pelo `media_id` da Cloud API,
|
|
560
|
+
* incluindo `download_url` — uma URL assinada e efêmera que você pode baixar
|
|
561
|
+
* direto (GET), válida até `expires_at`.
|
|
562
|
+
*
|
|
563
|
+
* A mídia é espelhada de forma assíncrona; se você consultar antes de terminar,
|
|
564
|
+
* a rota responde 202 e este método lança `BotoZapError` com
|
|
565
|
+
* `code: "media_not_ready"`. Nesse caso, aguarde e retente — o segundo que faltar
|
|
566
|
+
* está em `err.headers?.["retry-after"]`:
|
|
567
|
+
*
|
|
568
|
+
* ```ts
|
|
569
|
+
* try {
|
|
570
|
+
* const media = await boto.media.get("wamid_media_id");
|
|
571
|
+
* // baixe media.download_url direto
|
|
572
|
+
* } catch (err) {
|
|
573
|
+
* if (err instanceof BotoZapError && err.code === "media_not_ready") {
|
|
574
|
+
* const wait = Number(err.headers?.["retry-after"] ?? 5);
|
|
575
|
+
* // retente após `wait` segundos
|
|
576
|
+
* }
|
|
577
|
+
* }
|
|
578
|
+
* ```
|
|
579
|
+
*
|
|
580
|
+
* Existe também `GET /v1/media/:id/download`, que responde 302 redirecionando
|
|
581
|
+
* para a mesma URL assinada; não há método SDK dedicado porque `download_url`
|
|
582
|
+
* (acima) já entrega essa URL sem o hop de redirect.
|
|
583
|
+
*/
|
|
584
|
+
get(id) {
|
|
585
|
+
return this.client.requestItem(
|
|
586
|
+
"GET",
|
|
587
|
+
`/media/${encodeURIComponent(id)}`
|
|
588
|
+
);
|
|
589
|
+
}
|
|
558
590
|
};
|
|
559
591
|
|
|
560
592
|
// src/resources/read-only.ts
|
|
@@ -686,8 +718,9 @@ var BotoZap = class {
|
|
|
686
718
|
}
|
|
687
719
|
const raw = await res.text();
|
|
688
720
|
const data = raw ? safeJson(raw) : void 0;
|
|
689
|
-
|
|
690
|
-
|
|
721
|
+
const envelope = data;
|
|
722
|
+
const hasErrorEnvelope = typeof envelope === "object" && envelope !== null && typeof envelope.error === "object" && envelope.error !== null;
|
|
723
|
+
if (!res.ok || hasErrorEnvelope) {
|
|
691
724
|
const headers = {};
|
|
692
725
|
res.headers.forEach((value, key) => {
|
|
693
726
|
headers[key] = value;
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/errors.ts","../src/resources/messages.ts","../src/resources/customers.ts","../src/resources/templates.ts","../src/resources/broadcasts.ts","../src/resources/contacts.ts","../src/resources/conversations.ts","../src/resources/webhooks.ts","../src/resources/phone-numbers.ts","../src/resources/flows.ts","../src/resources/media.ts","../src/resources/read-only.ts","../src/client.ts"],"sourcesContent":["/**\n * Erro lançado quando a API responde fora da faixa 2xx. Carrega o envelope\n * de erro da BotoZap: { error: { code, message } }, mais o status HTTP e, quando\n * houve resposta HTTP (status > 0), os headers dela — úteis num 429 para ler\n * `Retry-After` / `X-RateLimit-*`. Os headers são só os da RESPOSTA; nenhum\n * header de request (que carrega a apiKey) entra aqui.\n */\nexport class BotoZapError extends Error {\n readonly code: string;\n readonly status: number;\n /** Headers da resposta HTTP. Ausente em erros sem resposta (status 0). */\n readonly headers?: Record<string, string>;\n\n constructor(\n code: string,\n message: string,\n status: number,\n headers?: Record<string, string>,\n ) {\n super(message);\n this.name = \"BotoZapError\";\n this.code = code;\n this.status = status;\n this.headers = headers;\n }\n}\n","import type { BotoZap } from \"../client.js\";\nimport { BotoZapError } from \"../errors.js\";\nimport type {\n CursorList,\n CursorParams,\n Message,\n SendResult,\n TemplatePayload,\n} from \"../types.js\";\n\n/** Filtros de `messages.list` (paginação por cursor). Ver GET /v1/messages. */\nexport interface ListMessagesParams extends CursorParams {\n /** id da Meta OU uuid interno do número. */\n phone_number_id?: string;\n /** uuid interno da conversa (o `id` de /v1/conversations). */\n conversation_id?: string;\n direction?: \"inbound\" | \"outbound\";\n /** enum message_status (ex.: \"sent\", \"delivered\", \"read\", \"failed\"). */\n status?: string;\n /** enum message_kind (ex.: \"text\", \"image\", \"template\"). */\n message_type?: string;\n /** true = só mensagens com mídia; false = só sem mídia. */\n has_media?: boolean;\n}\n\nexport interface SendTextParams {\n /** Número de destino em E.164, ex: \"+5531988887777\". */\n to: string;\n /** Corpo do texto. */\n text: string;\n /** phone_number_id de origem (obrigatório se a conta tem mais de um número). */\n from?: string;\n}\n\nexport interface SendTemplateParams {\n to: string;\n template: TemplatePayload;\n from?: string;\n}\n\n/** Endpoints de mensagem (POST /v1/messages, GET /v1/messages/:id). */\nexport class Messages {\n constructor(private readonly client: BotoZap) {}\n\n /** Envia uma mensagem de texto. */\n async send(params: SendTextParams): Promise<SendResult> {\n const result = await this.client.requestObject<SendResult>(\"POST\", \"/messages\", {\n body: {\n to: params.to,\n type: \"text\",\n text: { body: params.text },\n from: params.from,\n },\n });\n return assertSendResult(result);\n }\n\n /** Envia uma mensagem usando um template aprovado. */\n async sendTemplate(params: SendTemplateParams): Promise<SendResult> {\n const result = await this.client.requestObject<SendResult>(\"POST\", \"/messages\", {\n body: {\n to: params.to,\n type: \"template\",\n template: params.template,\n from: params.from,\n },\n });\n return assertSendResult(result);\n }\n\n /** Lista as mensagens da conta (paginação por cursor). */\n list(params: ListMessagesParams = {}): Promise<CursorList<Message>> {\n return this.client.requestCursorList<CursorList<Message>>(\"GET\", \"/messages\", {\n query: {\n limit: params.limit,\n after: params.after,\n before: params.before,\n phone_number_id: params.phone_number_id,\n conversation_id: params.conversation_id,\n direction: params.direction,\n status: params.status,\n message_type: params.message_type,\n has_media:\n params.has_media === undefined ? undefined : String(params.has_media),\n },\n });\n }\n\n /** Busca uma mensagem pelo id interno. */\n get(id: string): Promise<Message> {\n return this.client.requestItem<Message>(\n \"GET\",\n `/messages/${encodeURIComponent(id)}`,\n );\n }\n}\n\nfunction assertSendResult(value: SendResult): SendResult {\n if (\n typeof value.wamid !== \"string\" ||\n typeof value.to !== \"string\" ||\n typeof value.status !== \"string\" ||\n (value.id !== null && typeof value.id !== \"string\")\n ) {\n throw new BotoZapError(\n \"malformed_response\",\n \"resposta de envio sem id/wamid/to/status válidos\",\n 0,\n );\n }\n return value;\n}\n","import type { BotoZap } from \"../client.js\";\nimport type {\n Customer,\n OffsetList,\n OffsetParams,\n SetupLink,\n} from \"../types.js\";\n\nexport interface CreateCustomerParams {\n name: string;\n /** Referência do cliente no seu sistema (único por conta). */\n external_customer_id?: string;\n [key: string]: unknown;\n}\n\n/** Campos editáveis de um cliente (`PATCH /v1/customers/:id`). */\nexport interface UpdateCustomerParams {\n name?: string;\n external_customer_id?: string;\n}\n\n/** Corpo de `POST /v1/customers/:id/setup_links`. */\nexport interface CreateSetupLinkParams {\n /** Tipos de conexão liberados: \"dedicated\" e/ou \"coexistence\". */\n allowed_connection_types?: string[];\n provision_phone_number?: boolean;\n language?: string;\n success_redirect_url?: string;\n failure_redirect_url?: string;\n}\n\n/** Corpo de `PATCH /v1/customers/:id/setup_links/:linkId`. */\nexport interface UpdateSetupLinkParams {\n /** \"active\" | \"expired\" | \"revoked\" (a rota rejeita outros valores). */\n status?: string;\n /** Nova expiração (ISO 8601). */\n expires_at?: string;\n}\n\nfunction enc(id: string): string {\n return encodeURIComponent(id);\n}\n\n/**\n * Endpoints de cliente (`/v1/customers`) e seus links de setup\n * (`/v1/customers/:id/setup_links`).\n */\nexport class Customers {\n constructor(private readonly client: BotoZap) {}\n\n /** Lista os clientes da conta (paginação por offset/página). */\n list(params: OffsetParams = {}): Promise<OffsetList<Customer>> {\n return this.client.requestOffsetList<OffsetList<Customer>>(\"GET\", \"/customers\", {\n query: { page: params.page, per_page: params.per_page },\n });\n }\n\n /** Busca um cliente pelo id. */\n get(id: string): Promise<Customer> {\n return this.client.requestItem<Customer>(\"GET\", `/customers/${enc(id)}`);\n }\n\n /** Cria um cliente. */\n create(params: CreateCustomerParams): Promise<Customer> {\n return this.client.requestItem<Customer>(\"POST\", \"/customers\", {\n body: params,\n });\n }\n\n /** Atualiza `name` / `external_customer_id` de um cliente. */\n update(id: string, params: UpdateCustomerParams): Promise<Customer> {\n return this.client.requestItem<Customer>(\"PATCH\", `/customers/${enc(id)}`, {\n body: params,\n });\n }\n\n /** Exclui um cliente. Responde 204 (sem corpo). */\n delete(id: string): Promise<void> {\n return this.client.request<void>(\"DELETE\", `/customers/${enc(id)}`);\n }\n\n /** Lista os links de setup de um cliente (paginação por offset/página). */\n listSetupLinks(\n customerId: string,\n params: OffsetParams = {},\n ): Promise<OffsetList<SetupLink>> {\n return this.client.requestOffsetList<OffsetList<SetupLink>>(\n \"GET\",\n `/customers/${enc(customerId)}/setup_links`,\n { query: { page: params.page, per_page: params.per_page } },\n );\n }\n\n /** Cria um link de setup sob um cliente. */\n createSetupLink(\n customerId: string,\n params: CreateSetupLinkParams = {},\n ): Promise<SetupLink> {\n return this.client.requestItem<SetupLink>(\n \"POST\",\n `/customers/${enc(customerId)}/setup_links`,\n { body: params },\n );\n }\n\n /** Atualiza status/expiração de um link de setup. */\n updateSetupLink(\n customerId: string,\n linkId: string,\n params: UpdateSetupLinkParams,\n ): Promise<SetupLink> {\n return this.client.requestItem<SetupLink>(\n \"PATCH\",\n `/customers/${enc(customerId)}/setup_links/${enc(linkId)}`,\n { body: params },\n );\n }\n}\n","import type { BotoZap } from \"../client.js\";\nimport type { OffsetList, OffsetParams } from \"../types.js\";\n\nexport interface Template {\n id: string;\n name?: string;\n [key: string]: unknown;\n}\n\n/** Filtros de `templates.list` (paginação por offset). Ver GET /v1/templates. */\nexport interface ListTemplatesParams extends OffsetParams {\n /** Status do template (a rota normaliza para maiúsculas), ex.: \"APPROVED\". */\n status?: string;\n /** Categoria (a rota normaliza para maiúsculas), ex.: \"MARKETING\". */\n category?: string;\n /** Filtra pela conexão WABA. */\n waba_connection_id?: string;\n /** phone_number_id (Meta) → resolve a conexão do número (escopado por conta). */\n phone_number_id?: string;\n}\n\n/**\n * Corpo de `POST /v1/templates` — cria o template e o submete à Meta. A conexão\n * WABA vem de `waba_connection_id` OU `phone_number_id` (um dos dois). Ver a\n * rota para o formato exato de `components`.\n */\nexport interface CreateTemplateParams {\n name: string;\n /** Código de idioma, ex.: \"pt_BR\". */\n language: string;\n /** Categoria da Meta: \"MARKETING\" | \"UTILITY\" | \"AUTHENTICATION\". */\n category: string;\n /** Componentes do template (header/body/buttons…), formato da Cloud API. */\n components: unknown[];\n /** Conexão WABA alvo (alternativa a `phone_number_id`). */\n waba_connection_id?: string;\n /** phone_number_id (Meta) → resolve a conexão do número (alternativa). */\n phone_number_id?: string;\n}\n\n/** Endpoints de template (GET/POST /v1/templates, GET /v1/templates/:id). */\nexport class Templates {\n constructor(private readonly client: BotoZap) {}\n\n /** Lista os templates da conta (paginação por offset/página). */\n list(params: ListTemplatesParams = {}): Promise<OffsetList<Template>> {\n return this.client.requestOffsetList<OffsetList<Template>>(\"GET\", \"/templates\", {\n query: {\n page: params.page,\n per_page: params.per_page,\n status: params.status,\n category: params.category,\n waba_connection_id: params.waba_connection_id,\n phone_number_id: params.phone_number_id,\n },\n });\n }\n\n /** Busca um template pelo id. */\n get(id: string): Promise<Template> {\n return this.client.requestItem<Template>(\n \"GET\",\n `/templates/${encodeURIComponent(id)}`,\n );\n }\n\n /** Cria um template e o submete à Meta para análise. */\n create(params: CreateTemplateParams): Promise<Template> {\n return this.client.requestItem<Template>(\"POST\", \"/templates\", {\n body: params,\n });\n }\n}\n","import type { BotoZap } from \"../client.js\";\nimport type {\n Broadcast,\n BroadcastRecipient,\n CursorList,\n CursorParams,\n OffsetList,\n OffsetParams,\n} from \"../types.js\";\n\nexport interface ListBroadcastsParams extends OffsetParams {\n status?: string;\n customer_id?: string;\n phone_number_id?: string;\n}\n\n/**\n * Corpo de `POST /v1/broadcasts` — espelha o contrato real da rota. A origem é\n * `phone_number_id` OU `waba_connection_id` (um dos dois obrigatório);\n * `template_name` + `template_language` são obrigatórios. A conta vem da chave,\n * nunca do corpo. (A rota NÃO aceita `customer_id` nem um objeto `template`.)\n */\nexport interface CreateBroadcastParams {\n name?: string;\n /** phone_number_id (Meta) do número de origem. */\n phone_number_id?: string;\n /** Alternativa a `phone_number_id`: a conexão WABA de origem. */\n waba_connection_id?: string;\n /** Nome do template aprovado (obrigatório). */\n template_name: string;\n /** Código de idioma do template, ex.: \"pt_BR\" (obrigatório). */\n template_language: string;\n /** Opcional: id interno do template (revalidado por ownership/conexão). */\n template_id?: string;\n}\n\n/** Transição de estado via `PATCH /v1/broadcasts/:id`. */\nexport interface UpdateBroadcastParams {\n /** `stopped` interrompe (sending/scheduled); `draft` cancela um agendamento. */\n status: \"stopped\" | \"draft\";\n}\n\nexport interface ScheduleBroadcastParams {\n /** Data/hora ISO 8601. */\n scheduled_at: string;\n [key: string]: unknown;\n}\n\n/** Filtros de `listRecipients` (paginação por cursor + filtro de status). */\nexport interface ListRecipientsParams extends CursorParams {\n /** Filtra por status do destinatário (ex.: \"pending\", \"sent\", \"failed\"). */\n status?: string;\n}\n\n/** Resultado de `addRecipients`: quantos entraram, quantos eram duplicados, erros. */\nexport interface AddRecipientsResult {\n added: number;\n duplicates: number;\n errors: unknown[];\n}\n\n/** Transmissões: criar, adicionar destinatários, agendar/enviar/cancelar. */\nexport class Broadcasts {\n constructor(private readonly client: BotoZap) {}\n\n /** Lista as transmissões da conta (paginação por offset/página). */\n list(params: ListBroadcastsParams = {}): Promise<OffsetList<Broadcast>> {\n return this.client.requestOffsetList<OffsetList<Broadcast>>(\"GET\", \"/broadcasts\", {\n query: {\n page: params.page,\n per_page: params.per_page,\n status: params.status,\n customer_id: params.customer_id,\n phone_number_id: params.phone_number_id,\n },\n });\n }\n\n get(id: string): Promise<Broadcast> {\n return this.client.requestItem<Broadcast>(\"GET\", `/broadcasts/${enc(id)}`);\n }\n\n create(params: CreateBroadcastParams): Promise<Broadcast> {\n return this.client.requestItem<Broadcast>(\"POST\", \"/broadcasts\", {\n body: params,\n });\n }\n\n update(id: string, params: UpdateBroadcastParams): Promise<Broadcast> {\n return this.client.requestItem<Broadcast>(\n \"PATCH\",\n `/broadcasts/${enc(id)}`,\n { body: params },\n );\n }\n\n /** Lista os destinatários de uma transmissão (paginação por cursor). */\n listRecipients(\n id: string,\n params: ListRecipientsParams = {},\n ): Promise<CursorList<BroadcastRecipient>> {\n return this.client.requestCursorList<CursorList<BroadcastRecipient>>(\n \"GET\",\n `/broadcasts/${enc(id)}/recipients`,\n {\n query: {\n limit: params.limit,\n after: params.after,\n before: params.before,\n status: params.status,\n },\n },\n );\n }\n\n /** Adiciona destinatários (lista de números ou contatos). */\n addRecipients(id: string, recipients: unknown[]): Promise<AddRecipientsResult> {\n return this.client.requestItem<AddRecipientsResult>(\n \"POST\",\n `/broadcasts/${enc(id)}/recipients`,\n { body: { recipients } },\n );\n }\n\n /** Remove TODOS os destinatários. Responde 204 (sem corpo). */\n removeRecipients(id: string): Promise<void> {\n return this.client.request<void>(\n \"DELETE\",\n `/broadcasts/${enc(id)}/recipients`,\n );\n }\n\n schedule(id: string, params: ScheduleBroadcastParams): Promise<Broadcast> {\n return this.client.requestItem<Broadcast>(\n \"POST\",\n `/broadcasts/${enc(id)}/schedule`,\n { body: params },\n );\n }\n\n send(id: string): Promise<Broadcast> {\n return this.client.requestItem<Broadcast>(\n \"POST\",\n `/broadcasts/${enc(id)}/send`,\n );\n }\n\n cancel(id: string): Promise<Broadcast> {\n return this.client.requestItem<Broadcast>(\n \"POST\",\n `/broadcasts/${enc(id)}/cancel`,\n );\n }\n}\n\nfunction enc(id: string): string {\n return encodeURIComponent(id);\n}\n","import type { BotoZap } from \"../client.js\";\nimport type { Contact, CursorList, CursorParams } from \"../types.js\";\n\nexport interface ListContactsParams extends CursorParams {\n /** Filtra pelos números do cliente (derivado da conexão do número). */\n customer_id?: string;\n /**\n * Nesta base todo contato pertence a um cliente; `false` nunca casa (página\n * vazia), `true` é no-op.\n */\n has_customer?: boolean;\n /** Busca parcial (ilike) no nome de perfil. */\n profile_name_contains?: string;\n /** Busca parcial (ilike) no wa_id. */\n wa_id_contains?: string;\n /** Criados em ou após esta data (ISO 8601). */\n created_after?: string;\n /** Criados em ou antes desta data (ISO 8601). */\n created_before?: string;\n}\n\nexport interface CreateContactParams {\n /** wa_id canônico (BSUID \"BR.1A2B…\" ou dígitos E.164). */\n wa_id: string;\n phone_number_id?: string;\n [key: string]: unknown;\n}\n\n/** Contatos: listar, buscar, criar, atualizar, remover. */\nexport class Contacts {\n constructor(private readonly client: BotoZap) {}\n\n /** Lista os contatos da conta (paginação por cursor). */\n list(params: ListContactsParams = {}): Promise<CursorList<Contact>> {\n return this.client.requestCursorList<CursorList<Contact>>(\"GET\", \"/contacts\", {\n query: {\n limit: params.limit,\n after: params.after,\n before: params.before,\n customer_id: params.customer_id,\n has_customer:\n params.has_customer === undefined\n ? undefined\n : String(params.has_customer),\n profile_name_contains: params.profile_name_contains,\n wa_id_contains: params.wa_id_contains,\n created_after: params.created_after,\n created_before: params.created_before,\n },\n });\n }\n\n get(id: string): Promise<Contact> {\n return this.client.requestItem<Contact>(\"GET\", `/contacts/${enc(id)}`);\n }\n\n create(params: CreateContactParams): Promise<Contact> {\n return this.client.requestItem<Contact>(\"POST\", \"/contacts\", {\n body: params,\n });\n }\n\n update(id: string, params: Record<string, unknown>): Promise<Contact> {\n return this.client.requestItem<Contact>(\"PATCH\", `/contacts/${enc(id)}`, {\n body: params,\n });\n }\n\n /** Remove um contato. Responde 204 (sem corpo). */\n delete(id: string): Promise<void> {\n return this.client.request<void>(\"DELETE\", `/contacts/${enc(id)}`);\n }\n}\n\nfunction enc(id: string): string {\n return encodeURIComponent(id);\n}\n","import type { BotoZap } from \"../client.js\";\nimport type {\n Assignment,\n Conversation,\n CursorList,\n CursorParams,\n OffsetList,\n OffsetParams,\n} from \"../types.js\";\n\nexport interface ListConversationsParams extends CursorParams {\n /** id da Meta OU uuid interno do número. */\n phone_number_id?: string;\n /** \"active\" | \"ended\" — derivado da janela de 24h. */\n status?: string;\n /**\n * Busca parcial por contato (nome de perfil, @username, telefone ou wa_id).\n * Tem precedência sobre `phone_number` na rota.\n */\n contact?: string;\n /** Alias de busca por contato (usado quando `contact` não é informado). */\n phone_number?: string;\n}\n\nexport interface CreateAssignmentParams {\n /** Membro a quem atribuir a conversa. */\n user_id: string;\n notes?: string;\n}\n\n/** Conversas (read + status) e atribuições a membros. */\nexport class Conversations {\n constructor(private readonly client: BotoZap) {}\n\n /** Lista as conversas da conta (paginação por cursor). */\n list(params: ListConversationsParams = {}): Promise<CursorList<Conversation>> {\n return this.client.requestCursorList<CursorList<Conversation>>(\n \"GET\",\n \"/conversations\",\n {\n query: {\n limit: params.limit,\n after: params.after,\n before: params.before,\n phone_number_id: params.phone_number_id,\n status: params.status,\n contact: params.contact,\n phone_number: params.phone_number,\n },\n },\n );\n }\n\n get(id: string): Promise<Conversation> {\n return this.client.requestItem<Conversation>(\n \"GET\",\n `/conversations/${enc(id)}`,\n );\n }\n\n update(id: string, params: Record<string, unknown>): Promise<Conversation> {\n return this.client.requestItem<Conversation>(\n \"PATCH\",\n `/conversations/${enc(id)}`,\n { body: params },\n );\n }\n\n /** Lista as atribuições da conversa (paginação por offset/página). */\n listAssignments(\n id: string,\n params: OffsetParams = {},\n ): Promise<OffsetList<Assignment>> {\n return this.client.requestOffsetList<OffsetList<Assignment>>(\n \"GET\",\n `/conversations/${enc(id)}/assignments`,\n { query: { page: params.page, per_page: params.per_page } },\n );\n }\n\n createAssignment(\n id: string,\n params: CreateAssignmentParams,\n ): Promise<Assignment> {\n return this.client.requestItem<Assignment>(\n \"POST\",\n `/conversations/${enc(id)}/assignments`,\n { body: params },\n );\n }\n\n getAssignment(id: string, assignmentId: string): Promise<Assignment> {\n return this.client.requestItem<Assignment>(\n \"GET\",\n `/conversations/${enc(id)}/assignments/${enc(assignmentId)}`,\n );\n }\n\n updateAssignment(\n id: string,\n assignmentId: string,\n params: Record<string, unknown>,\n ): Promise<Assignment> {\n return this.client.requestItem<Assignment>(\n \"PATCH\",\n `/conversations/${enc(id)}/assignments/${enc(assignmentId)}`,\n { body: params },\n );\n }\n}\n\nfunction enc(id: string): string {\n return encodeURIComponent(id);\n}\n","import type { BotoZap } from \"../client.js\";\nimport type { CursorList, CursorParams, Webhook } from \"../types.js\";\n\nexport interface CreateWebhookParams {\n url: string;\n events?: string[];\n active?: boolean;\n [key: string]: unknown;\n}\n\n/** Webhooks: endpoints assinados que recebem os eventos da conta. */\nexport class Webhooks {\n constructor(private readonly client: BotoZap) {}\n\n /** Lista os endpoints de webhook da conta (paginação por cursor). */\n list(params: CursorParams = {}): Promise<CursorList<Webhook>> {\n return this.client.requestCursorList<CursorList<Webhook>>(\"GET\", \"/webhooks\", {\n query: {\n limit: params.limit,\n after: params.after,\n before: params.before,\n },\n });\n }\n\n get(id: string): Promise<Webhook> {\n return this.client.requestItem<Webhook>(\"GET\", `/webhooks/${enc(id)}`);\n }\n\n create(params: CreateWebhookParams): Promise<Webhook> {\n return this.client.requestItem<Webhook>(\"POST\", \"/webhooks\", {\n body: params,\n });\n }\n\n update(id: string, params: Record<string, unknown>): Promise<Webhook> {\n return this.client.requestItem<Webhook>(\"PATCH\", `/webhooks/${enc(id)}`, {\n body: params,\n });\n }\n\n /** Remove um endpoint. Responde 204 (sem corpo). */\n delete(id: string): Promise<void> {\n return this.client.request<void>(\"DELETE\", `/webhooks/${enc(id)}`);\n }\n\n /** Dispara um evento de teste para o endpoint. */\n test(id: string): Promise<{ success: boolean }> {\n return this.client.requestItem<{ success: boolean }>(\n \"POST\",\n `/webhooks/${enc(id)}/test`,\n );\n }\n}\n\nfunction enc(id: string): string {\n return encodeURIComponent(id);\n}\n","import type { BotoZap } from \"../client.js\";\nimport type { OffsetList, OffsetParams, PhoneNumber } from \"../types.js\";\n\nexport interface ListPhoneNumbersParams extends OffsetParams {\n customer_id?: string;\n}\n\n/** Números conectados de cada cliente. */\nexport class PhoneNumbers {\n constructor(private readonly client: BotoZap) {}\n\n /** Lista os números da conta (paginação por offset/página). */\n list(params: ListPhoneNumbersParams = {}): Promise<OffsetList<PhoneNumber>> {\n return this.client.requestOffsetList<OffsetList<PhoneNumber>>(\n \"GET\",\n \"/phone_numbers\",\n {\n query: {\n page: params.page,\n per_page: params.per_page,\n customer_id: params.customer_id,\n },\n },\n );\n }\n\n get(id: string): Promise<PhoneNumber> {\n return this.client.requestItem<PhoneNumber>(\n \"GET\",\n `/phone_numbers/${enc(id)}`,\n );\n }\n\n // NOTA: `update` foi removido de propósito. A rota PATCH /v1/phone_numbers/:id\n // responde SEMPRE 422 `no_updatable_fields` — o schema atual só tem campos de\n // identidade e campos sincronizados da Meta, nenhum editável por aqui. Expor o\n // método só entregaria uma chamada garantidamente quebrada.\n\n /** Remove um número. Responde 204 (sem corpo). */\n delete(id: string): Promise<void> {\n return this.client.request<void>(\"DELETE\", `/phone_numbers/${enc(id)}`);\n }\n\n /** Saúde do número (qualidade, limite, status na Meta). */\n health(id: string): Promise<Record<string, unknown>> {\n return this.client.requestItem<Record<string, unknown>>(\n \"GET\",\n `/phone_numbers/${enc(id)}/health`,\n );\n }\n}\n\nfunction enc(id: string): string {\n return encodeURIComponent(id);\n}\n","import type { BotoZap } from \"../client.js\";\nimport type { Flow, FlowVersion, OffsetList, OffsetParams } from \"../types.js\";\n\nexport interface CreateFlowParams {\n name?: string;\n [key: string]: unknown;\n}\n\n/**\n * Filtros de `flows.list` (paginação por offset). Flows vivem na Meta e a lista\n * é por WABA — a rota GET /v1/flows EXIGE `phone_number_id` OU\n * `waba_connection_id` (sem um deles responde 422 missing_target). Informe um.\n */\nexport interface ListFlowsParams extends OffsetParams {\n /** phone_number_id (Meta) → resolve a conexão do número (escopado por conta). */\n phone_number_id?: string;\n /** Alternativa a `phone_number_id`: a conexão WABA cujos flows listar. */\n waba_connection_id?: string;\n}\n\n/**\n * Flows vivem na Meta, não no nosso banco — a amarração flow → conta é via\n * `phone_number_id` (resolve a WABA e o token). Por isso get/delete/publish/\n * setup_encryption/versions/data_endpoint EXIGEM `phone_number_id`.\n */\nexport interface FlowPhoneParams {\n /** phone_number_id (Meta) do número cuja WABA hospeda o flow. */\n phone_number_id: string;\n}\n\n/** Corpo de `POST /v1/flows/:id/versions` — sobe um novo flow.json. */\nexport interface CreateFlowVersionParams {\n phone_number_id: string;\n /** JSON do flow (objeto ou string JSON válida). */\n flow_json: unknown;\n [key: string]: unknown;\n}\n\n/** Corpo de `POST /v1/flows/:id/data_endpoint` — conecta a forward URL do dev. */\nexport interface SetFlowDataEndpointParams {\n phone_number_id: string;\n /** URL HTTPS do backend do dev que recebe o data_exchange. */\n forward_url: string;\n [key: string]: unknown;\n}\n\n/** WhatsApp Flows: criar, versionar, publicar e configurar data endpoint. */\nexport class Flows {\n constructor(private readonly client: BotoZap) {}\n\n /**\n * Lista os flows de uma WABA (paginação por offset/página). Informe\n * `phone_number_id` OU `waba_connection_id` — a rota exige um deles.\n */\n list(params: ListFlowsParams = {}): Promise<OffsetList<Flow>> {\n return this.client.requestOffsetList<OffsetList<Flow>>(\"GET\", \"/flows\", {\n query: {\n page: params.page,\n per_page: params.per_page,\n phone_number_id: params.phone_number_id,\n waba_connection_id: params.waba_connection_id,\n },\n });\n }\n\n get(id: string, params: FlowPhoneParams): Promise<Flow> {\n return this.client.requestItem<Flow>(\"GET\", `/flows/${enc(id)}`, {\n query: { phone_number_id: params.phone_number_id },\n });\n }\n\n create(params: CreateFlowParams): Promise<Flow> {\n return this.client.requestItem<Flow>(\"POST\", \"/flows\", { body: params });\n }\n\n /** Remove um flow (só DRAFT, regra da Meta). Responde 204 (sem corpo). */\n delete(id: string, params: FlowPhoneParams): Promise<void> {\n return this.client.request<void>(\"DELETE\", `/flows/${enc(id)}`, {\n query: { phone_number_id: params.phone_number_id },\n });\n }\n\n publish(id: string, params: FlowPhoneParams): Promise<Flow> {\n return this.client.requestItem<Flow>(\"POST\", `/flows/${enc(id)}/publish`, {\n body: { phone_number_id: params.phone_number_id },\n });\n }\n\n /** Lista as versões de um flow (paginação por offset/página). */\n listVersions(\n id: string,\n params: OffsetParams = {},\n ): Promise<OffsetList<FlowVersion>> {\n return this.client.requestOffsetList<OffsetList<FlowVersion>>(\n \"GET\",\n `/flows/${enc(id)}/versions`,\n { query: { page: params.page, per_page: params.per_page } },\n );\n }\n\n createVersion(\n id: string,\n params: CreateFlowVersionParams,\n ): Promise<FlowVersion> {\n return this.client.requestItem<FlowVersion>(\n \"POST\",\n `/flows/${enc(id)}/versions`,\n { body: params },\n );\n }\n\n setupEncryption(\n id: string,\n params: FlowPhoneParams,\n ): Promise<Record<string, unknown>> {\n return this.client.requestItem<Record<string, unknown>>(\n \"POST\",\n `/flows/${enc(id)}/setup_encryption`,\n { body: { phone_number_id: params.phone_number_id } },\n );\n }\n\n getDataEndpoint(id: string): Promise<Record<string, unknown>> {\n return this.client.requestItem<Record<string, unknown>>(\n \"GET\",\n `/flows/${enc(id)}/data_endpoint`,\n );\n }\n\n setDataEndpoint(\n id: string,\n params: SetFlowDataEndpointParams,\n ): Promise<Record<string, unknown>> {\n return this.client.requestItem<Record<string, unknown>>(\n \"POST\",\n `/flows/${enc(id)}/data_endpoint`,\n { body: params },\n );\n }\n}\n\nfunction enc(id: string): string {\n return encodeURIComponent(id);\n}\n","import type { BotoZap } from \"../client.js\";\nimport type { MediaUploadResult } from \"../types.js\";\n\n/** Corpo do `POST /v1/media` — espelha o contrato real da rota. */\nexport interface UploadMediaParams {\n /** URL http(s) de origem do arquivo. A BotoZap baixa (com guard SSRF) e sobe pra Cloud API. */\n source: string;\n /** phone_number_id (da Meta) do número de origem. Obrigatório. */\n phone_number_id: string;\n /** Nome do arquivo (default: derivado da URL). */\n filename?: string;\n /** MIME type (default: Content-Type do download). */\n mime_type?: string;\n /** Pipeline de upload: `meta_media` (default) ou `meta_resumable_asset`. */\n delivery?: \"meta_media\" | \"meta_resumable_asset\";\n [key: string]: unknown;\n}\n\n/** Mídia: sobe um arquivo e devolve um media_id usável em mensagens. */\nexport class Media {\n constructor(private readonly client: BotoZap) {}\n\n upload(params: UploadMediaParams): Promise<MediaUploadResult> {\n return this.client.requestItem<MediaUploadResult>(\"POST\", \"/media\", {\n body: params,\n });\n }\n}\n","import type { BotoZap } from \"../client.js\";\nimport type {\n ApiLog,\n CursorList,\n CursorParams,\n OffsetList,\n OffsetParams,\n User,\n WebhookDelivery,\n} from \"../types.js\";\n\n/** Membros da conta (somente leitura via API). */\nexport class Users {\n constructor(private readonly client: BotoZap) {}\n\n /** Lista os membros da conta (paginação por offset/página). */\n list(params: OffsetParams = {}): Promise<OffsetList<User>> {\n return this.client.requestOffsetList<OffsetList<User>>(\"GET\", \"/users\", {\n query: { page: params.page, per_page: params.per_page },\n });\n }\n}\n\nexport interface ListApiLogsParams extends CursorParams {\n /** Origem do log (ex.: \"api\"). */\n source?: string;\n /** Método HTTP (a rota normaliza para maiúsculas). */\n method?: string;\n /** Código HTTP exato (inteiro). */\n status_code?: number;\n}\n\n/** Logs de requisições à API (somente leitura, paginação por cursor). */\nexport class ApiLogs {\n constructor(private readonly client: BotoZap) {}\n\n list(params: ListApiLogsParams = {}): Promise<CursorList<ApiLog>> {\n return this.client.requestCursorList<CursorList<ApiLog>>(\"GET\", \"/api_logs\", {\n query: {\n limit: params.limit,\n after: params.after,\n before: params.before,\n source: params.source,\n method: params.method,\n status_code: params.status_code,\n },\n });\n }\n}\n\nexport interface ListWebhookDeliveriesParams extends CursorParams {\n /** Alias de `endpoint_id` na rota — entregas de um endpoint específico. */\n webhook_id?: string;\n /** delivery_status (pending|success|failed|exhausted). */\n status?: string;\n /** Tipo do evento (ex.: \"webhook.test\", \"messages\"). */\n event_type?: string;\n}\n\n/** Histórico de entregas de webhook (somente leitura, paginação por cursor). */\nexport class WebhookDeliveries {\n constructor(private readonly client: BotoZap) {}\n\n list(\n params: ListWebhookDeliveriesParams = {},\n ): Promise<CursorList<WebhookDelivery>> {\n return this.client.requestCursorList<CursorList<WebhookDelivery>>(\n \"GET\",\n \"/webhook_deliveries\",\n {\n query: {\n limit: params.limit,\n after: params.after,\n before: params.before,\n webhook_id: params.webhook_id,\n status: params.status,\n event_type: params.event_type,\n },\n },\n );\n }\n}\n","import { BotoZapError } from \"./errors.js\";\nimport { Messages } from \"./resources/messages.js\";\nimport { Customers } from \"./resources/customers.js\";\nimport { Templates } from \"./resources/templates.js\";\nimport { Broadcasts } from \"./resources/broadcasts.js\";\nimport { Contacts } from \"./resources/contacts.js\";\nimport { Conversations } from \"./resources/conversations.js\";\nimport { Webhooks } from \"./resources/webhooks.js\";\nimport { PhoneNumbers } from \"./resources/phone-numbers.js\";\nimport { Flows } from \"./resources/flows.js\";\nimport { Media } from \"./resources/media.js\";\nimport { Users, ApiLogs, WebhookDeliveries } from \"./resources/read-only.js\";\n\nexport interface BotoZapOptions {\n /** Chave de API da conta (cabeçalho Authorization: Bearer). */\n apiKey: string;\n /** Sobrescreve a URL base. Padrão: https://botozap.com.br/api/v1 */\n baseUrl?: string;\n /** Injeta um fetch (testes, runtimes sem fetch global). */\n fetch?: typeof fetch;\n}\n\nexport interface RequestOptions {\n query?: Record<string, string | number | undefined>;\n body?: unknown;\n}\n\nconst DEFAULT_BASE_URL = \"https://botozap.com.br/api/v1\";\n\n/**\n * Cliente da API da BotoZap.\n *\n * ```ts\n * const boto = new BotoZap({ apiKey: process.env.BOTOZAP_KEY! });\n * await boto.messages.send({ to: \"+5531988887777\", text: \"Olá!\" });\n * ```\n */\nexport class BotoZap {\n readonly messages: Messages;\n readonly customers: Customers;\n readonly templates: Templates;\n readonly broadcasts: Broadcasts;\n readonly contacts: Contacts;\n readonly conversations: Conversations;\n readonly webhooks: Webhooks;\n readonly phoneNumbers: PhoneNumbers;\n readonly flows: Flows;\n readonly media: Media;\n readonly users: Users;\n readonly apiLogs: ApiLogs;\n readonly webhookDeliveries: WebhookDeliveries;\n\n private readonly apiKey: string;\n private readonly baseUrl: string;\n private readonly fetchImpl: typeof fetch;\n\n constructor(options: BotoZapOptions) {\n if (!options || !options.apiKey) {\n throw new Error(\"BotoZap: apiKey é obrigatório.\");\n }\n this.apiKey = options.apiKey;\n this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n\n const resolvedFetch = options.fetch ?? globalThis.fetch;\n if (typeof resolvedFetch !== \"function\") {\n throw new Error(\n \"BotoZap: fetch global não encontrado. Use Node 20.19+ ou passe a opção `fetch`.\",\n );\n }\n this.fetchImpl = resolvedFetch;\n\n this.messages = new Messages(this);\n this.customers = new Customers(this);\n this.templates = new Templates(this);\n this.broadcasts = new Broadcasts(this);\n this.contacts = new Contacts(this);\n this.conversations = new Conversations(this);\n this.webhooks = new Webhooks(this);\n this.phoneNumbers = new PhoneNumbers(this);\n this.flows = new Flows(this);\n this.media = new Media(this);\n this.users = new Users(this);\n this.apiLogs = new ApiLogs(this);\n this.webhookDeliveries = new WebhookDeliveries(this);\n }\n\n /** Faz uma requisição autenticada e devolve o corpo já parseado. */\n async request<T>(\n method: string,\n path: string,\n opts: RequestOptions = {},\n ): Promise<T> {\n const url = new URL(this.baseUrl + path);\n if (opts.query) {\n for (const [key, value] of Object.entries(opts.query)) {\n if (value !== undefined) url.searchParams.set(key, String(value));\n }\n }\n\n let res: Awaited<ReturnType<typeof fetch>>;\n try {\n res = await this.fetchImpl(url.toString(), {\n method,\n headers: {\n Authorization: `Bearer ${this.apiKey}`,\n \"Content-Type\": \"application/json\",\n Accept: \"application/json\",\n },\n body: opts.body === undefined ? undefined : JSON.stringify(opts.body),\n });\n } catch (cause) {\n // `fetch` REJEITA (DNS, conexão recusada, offline, abort) com um TypeError\n // — não é uma resposta HTTP. Se vazasse cru, o chamador teria dois tipos de\n // erro pra tratar (BotoZapError vs. TypeError). Embrulhamos num BotoZapError\n // de rede: um único tipo pra capturar, com `code` distinguindo rede de HTTP.\n // status 0 = não houve resposta HTTP.\n const detail = cause instanceof Error ? cause.message : String(cause);\n throw new BotoZapError(\n \"network_error\",\n `falha de rede ao chamar a API: ${detail}`,\n 0,\n );\n }\n\n const raw = await res.text();\n const data = raw ? safeJson(raw) : undefined;\n\n if (!res.ok) {\n const envelope = data as\n | { error?: { code?: string; message?: string } }\n | undefined;\n // Expõe os headers da RESPOSTA no erro — num 429 o chamador precisa de\n // `Retry-After`/`X-RateLimit-*` para saber quando reenviar. Só headers da\n // resposta; nada do request (que carrega a apiKey) toca este objeto.\n const headers: Record<string, string> = {};\n res.headers.forEach((value, key) => {\n headers[key] = value;\n });\n throw new BotoZapError(\n envelope?.error?.code ?? \"http_error\",\n envelope?.error?.message ?? `HTTP ${res.status}`,\n res.status,\n headers,\n );\n }\n\n return data as T;\n }\n\n /**\n * Requisição a um endpoint de ITEM (singular). A API embrulha essas respostas\n * em `{ data: <obj> }` (helper `ok`); este método desempacota e devolve a\n * entidade. NÃO é uma heurística \"se tem .data desempacota\" — o desempacote é\n * o contrato conhecido do endpoint, declarado por quem chama este método (as\n * rotas de LISTA usam `request` e devolvem `{ data, paging|meta }` inteiro; a\n * rota POST /messages responde direto e também usa `request`).\n */\n async requestItem<T>(\n method: string,\n path: string,\n opts: RequestOptions = {},\n ): Promise<T> {\n const env = await this.request<{ data: T }>(method, path, opts);\n // Contrato: endpoints de ITEM respondem `{ data: <obj> }`. Sem a chave\n // `data`, `(env).data` seria `undefined` SILENCIOSO — o chamador recebe\n // undefined e só quebra lá na frente, longe da causa. Falha alto e claro\n // aqui. (`data: null` explícito PASSA — a chave existe; é 200-sem-envelope\n // que é violação.) status 0 = erro de contrato do cliente, não HTTP.\n if (env == null || typeof env !== \"object\" || !(\"data\" in env)) {\n throw new BotoZapError(\n \"malformed_response\",\n \"resposta sem envelope data — contrato violado\",\n 0,\n );\n }\n return (env as { data: T }).data;\n }\n\n /** Resposta JSON direta que precisa ser um objeto (ex.: POST /messages). */\n async requestObject<T>(\n method: string,\n path: string,\n opts: RequestOptions = {},\n ): Promise<T> {\n const value = await this.request<unknown>(method, path, opts);\n if (!isObject(value)) {\n throw malformed(\"resposta deveria ser um objeto JSON\");\n }\n return value as T;\n }\n\n /** Lista paginada por cursor: exige `{ data: [], paging: {} }`. */\n async requestCursorList<T>(\n method: string,\n path: string,\n opts: RequestOptions = {},\n ): Promise<T> {\n const value = await this.request<unknown>(method, path, opts);\n if (!isObject(value) || !Array.isArray(value.data) || !isObject(value.paging)) {\n throw malformed(\"resposta sem data[]/paging — contrato de cursor violado\");\n }\n return value as T;\n }\n\n /** Lista paginada por offset: exige `{ data: [], meta: {} }`. */\n async requestOffsetList<T>(\n method: string,\n path: string,\n opts: RequestOptions = {},\n ): Promise<T> {\n const value = await this.request<unknown>(method, path, opts);\n if (!isObject(value) || !Array.isArray(value.data) || !isObject(value.meta)) {\n throw malformed(\"resposta sem data[]/meta — contrato de offset violado\");\n }\n return value as T;\n }\n}\n\nfunction isObject(value: unknown): value is Record<string, unknown> {\n return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction malformed(message: string): BotoZapError {\n return new BotoZapError(\"malformed_response\", message, 0);\n}\n\nfunction safeJson(text: string): unknown {\n try {\n return JSON.parse(text);\n } catch {\n return text;\n }\n}\n"],"mappings":"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","names":["enc","enc","enc","enc","enc","enc"]}
|
|
1
|
+
{"version":3,"sources":["../src/errors.ts","../src/resources/messages.ts","../src/resources/customers.ts","../src/resources/templates.ts","../src/resources/broadcasts.ts","../src/resources/contacts.ts","../src/resources/conversations.ts","../src/resources/webhooks.ts","../src/resources/phone-numbers.ts","../src/resources/flows.ts","../src/resources/media.ts","../src/resources/read-only.ts","../src/client.ts"],"sourcesContent":["/**\n * Erro lançado quando a API responde fora da faixa 2xx. Carrega o envelope\n * de erro da BotoZap: { error: { code, message } }, mais o status HTTP e, quando\n * houve resposta HTTP (status > 0), os headers dela — úteis num 429 para ler\n * `Retry-After` / `X-RateLimit-*`. Os headers são só os da RESPOSTA; nenhum\n * header de request (que carrega a apiKey) entra aqui.\n */\nexport class BotoZapError extends Error {\n readonly code: string;\n readonly status: number;\n /** Headers da resposta HTTP. Ausente em erros sem resposta (status 0). */\n readonly headers?: Record<string, string>;\n\n constructor(\n code: string,\n message: string,\n status: number,\n headers?: Record<string, string>,\n ) {\n super(message);\n this.name = \"BotoZapError\";\n this.code = code;\n this.status = status;\n this.headers = headers;\n }\n}\n","import type { BotoZap } from \"../client.js\";\nimport { BotoZapError } from \"../errors.js\";\nimport type {\n CursorList,\n CursorParams,\n Message,\n SendResult,\n TemplatePayload,\n} from \"../types.js\";\n\n/** Filtros de `messages.list` (paginação por cursor). Ver GET /v1/messages. */\nexport interface ListMessagesParams extends CursorParams {\n /** id da Meta OU uuid interno do número. */\n phone_number_id?: string;\n /** uuid interno da conversa (o `id` de /v1/conversations). */\n conversation_id?: string;\n direction?: \"inbound\" | \"outbound\";\n /** enum message_status (ex.: \"sent\", \"delivered\", \"read\", \"failed\"). */\n status?: string;\n /** enum message_kind (ex.: \"text\", \"image\", \"template\"). */\n message_type?: string;\n /** true = só mensagens com mídia; false = só sem mídia. */\n has_media?: boolean;\n}\n\nexport interface SendTextParams {\n /** Número de destino em E.164, ex: \"+5531988887777\". */\n to: string;\n /** Corpo do texto. */\n text: string;\n /** phone_number_id de origem (obrigatório se a conta tem mais de um número). */\n from?: string;\n}\n\nexport interface SendTemplateParams {\n to: string;\n template: TemplatePayload;\n from?: string;\n}\n\n/** Endpoints de mensagem (POST /v1/messages, GET /v1/messages/:id). */\nexport class Messages {\n constructor(private readonly client: BotoZap) {}\n\n /** Envia uma mensagem de texto. */\n async send(params: SendTextParams): Promise<SendResult> {\n const result = await this.client.requestObject<SendResult>(\"POST\", \"/messages\", {\n body: {\n to: params.to,\n type: \"text\",\n text: { body: params.text },\n from: params.from,\n },\n });\n return assertSendResult(result);\n }\n\n /** Envia uma mensagem usando um template aprovado. */\n async sendTemplate(params: SendTemplateParams): Promise<SendResult> {\n const result = await this.client.requestObject<SendResult>(\"POST\", \"/messages\", {\n body: {\n to: params.to,\n type: \"template\",\n template: params.template,\n from: params.from,\n },\n });\n return assertSendResult(result);\n }\n\n /** Lista as mensagens da conta (paginação por cursor). */\n list(params: ListMessagesParams = {}): Promise<CursorList<Message>> {\n return this.client.requestCursorList<CursorList<Message>>(\"GET\", \"/messages\", {\n query: {\n limit: params.limit,\n after: params.after,\n before: params.before,\n phone_number_id: params.phone_number_id,\n conversation_id: params.conversation_id,\n direction: params.direction,\n status: params.status,\n message_type: params.message_type,\n has_media:\n params.has_media === undefined ? undefined : String(params.has_media),\n },\n });\n }\n\n /** Busca uma mensagem pelo id interno. */\n get(id: string): Promise<Message> {\n return this.client.requestItem<Message>(\n \"GET\",\n `/messages/${encodeURIComponent(id)}`,\n );\n }\n}\n\nfunction assertSendResult(value: SendResult): SendResult {\n if (\n typeof value.wamid !== \"string\" ||\n typeof value.to !== \"string\" ||\n typeof value.status !== \"string\" ||\n (value.id !== null && typeof value.id !== \"string\")\n ) {\n throw new BotoZapError(\n \"malformed_response\",\n \"resposta de envio sem id/wamid/to/status válidos\",\n 0,\n );\n }\n return value;\n}\n","import type { BotoZap } from \"../client.js\";\nimport type {\n Customer,\n OffsetList,\n OffsetParams,\n SetupLink,\n} from \"../types.js\";\n\nexport interface CreateCustomerParams {\n name: string;\n /** Referência do cliente no seu sistema (único por conta). */\n external_customer_id?: string;\n [key: string]: unknown;\n}\n\n/** Campos editáveis de um cliente (`PATCH /v1/customers/:id`). */\nexport interface UpdateCustomerParams {\n name?: string;\n external_customer_id?: string;\n}\n\n/** Corpo de `POST /v1/customers/:id/setup_links`. */\nexport interface CreateSetupLinkParams {\n /** Tipos de conexão liberados: \"dedicated\" e/ou \"coexistence\". */\n allowed_connection_types?: string[];\n provision_phone_number?: boolean;\n language?: string;\n success_redirect_url?: string;\n failure_redirect_url?: string;\n}\n\n/** Corpo de `PATCH /v1/customers/:id/setup_links/:linkId`. */\nexport interface UpdateSetupLinkParams {\n /** \"active\" | \"expired\" | \"revoked\" (a rota rejeita outros valores). */\n status?: string;\n /** Nova expiração (ISO 8601). */\n expires_at?: string;\n}\n\nfunction enc(id: string): string {\n return encodeURIComponent(id);\n}\n\n/**\n * Endpoints de cliente (`/v1/customers`) e seus links de setup\n * (`/v1/customers/:id/setup_links`).\n */\nexport class Customers {\n constructor(private readonly client: BotoZap) {}\n\n /** Lista os clientes da conta (paginação por offset/página). */\n list(params: OffsetParams = {}): Promise<OffsetList<Customer>> {\n return this.client.requestOffsetList<OffsetList<Customer>>(\"GET\", \"/customers\", {\n query: { page: params.page, per_page: params.per_page },\n });\n }\n\n /** Busca um cliente pelo id. */\n get(id: string): Promise<Customer> {\n return this.client.requestItem<Customer>(\"GET\", `/customers/${enc(id)}`);\n }\n\n /** Cria um cliente. */\n create(params: CreateCustomerParams): Promise<Customer> {\n return this.client.requestItem<Customer>(\"POST\", \"/customers\", {\n body: params,\n });\n }\n\n /** Atualiza `name` / `external_customer_id` de um cliente. */\n update(id: string, params: UpdateCustomerParams): Promise<Customer> {\n return this.client.requestItem<Customer>(\"PATCH\", `/customers/${enc(id)}`, {\n body: params,\n });\n }\n\n /** Exclui um cliente. Responde 204 (sem corpo). */\n delete(id: string): Promise<void> {\n return this.client.request<void>(\"DELETE\", `/customers/${enc(id)}`);\n }\n\n /** Lista os links de setup de um cliente (paginação por offset/página). */\n listSetupLinks(\n customerId: string,\n params: OffsetParams = {},\n ): Promise<OffsetList<SetupLink>> {\n return this.client.requestOffsetList<OffsetList<SetupLink>>(\n \"GET\",\n `/customers/${enc(customerId)}/setup_links`,\n { query: { page: params.page, per_page: params.per_page } },\n );\n }\n\n /** Cria um link de setup sob um cliente. */\n createSetupLink(\n customerId: string,\n params: CreateSetupLinkParams = {},\n ): Promise<SetupLink> {\n return this.client.requestItem<SetupLink>(\n \"POST\",\n `/customers/${enc(customerId)}/setup_links`,\n { body: params },\n );\n }\n\n /** Atualiza status/expiração de um link de setup. */\n updateSetupLink(\n customerId: string,\n linkId: string,\n params: UpdateSetupLinkParams,\n ): Promise<SetupLink> {\n return this.client.requestItem<SetupLink>(\n \"PATCH\",\n `/customers/${enc(customerId)}/setup_links/${enc(linkId)}`,\n { body: params },\n );\n }\n}\n","import type { BotoZap } from \"../client.js\";\nimport type { OffsetList, OffsetParams } from \"../types.js\";\n\nexport interface Template {\n id: string;\n name?: string;\n [key: string]: unknown;\n}\n\n/** Filtros de `templates.list` (paginação por offset). Ver GET /v1/templates. */\nexport interface ListTemplatesParams extends OffsetParams {\n /** Status do template (a rota normaliza para maiúsculas), ex.: \"APPROVED\". */\n status?: string;\n /** Categoria (a rota normaliza para maiúsculas), ex.: \"MARKETING\". */\n category?: string;\n /** Filtra pela conexão WABA. */\n waba_connection_id?: string;\n /** phone_number_id (Meta) → resolve a conexão do número (escopado por conta). */\n phone_number_id?: string;\n}\n\n/**\n * Corpo de `POST /v1/templates` — cria o template e o submete à Meta. A conexão\n * WABA vem de `waba_connection_id` OU `phone_number_id` (um dos dois). Ver a\n * rota para o formato exato de `components`.\n */\nexport interface CreateTemplateParams {\n name: string;\n /** Código de idioma, ex.: \"pt_BR\". */\n language: string;\n /** Categoria da Meta: \"MARKETING\" | \"UTILITY\" | \"AUTHENTICATION\". */\n category: string;\n /** Componentes do template (header/body/buttons…), formato da Cloud API. */\n components: unknown[];\n /** Conexão WABA alvo (alternativa a `phone_number_id`). */\n waba_connection_id?: string;\n /** phone_number_id (Meta) → resolve a conexão do número (alternativa). */\n phone_number_id?: string;\n}\n\n/** Endpoints de template (GET/POST /v1/templates, GET /v1/templates/:id). */\nexport class Templates {\n constructor(private readonly client: BotoZap) {}\n\n /** Lista os templates da conta (paginação por offset/página). */\n list(params: ListTemplatesParams = {}): Promise<OffsetList<Template>> {\n return this.client.requestOffsetList<OffsetList<Template>>(\"GET\", \"/templates\", {\n query: {\n page: params.page,\n per_page: params.per_page,\n status: params.status,\n category: params.category,\n waba_connection_id: params.waba_connection_id,\n phone_number_id: params.phone_number_id,\n },\n });\n }\n\n /** Busca um template pelo id. */\n get(id: string): Promise<Template> {\n return this.client.requestItem<Template>(\n \"GET\",\n `/templates/${encodeURIComponent(id)}`,\n );\n }\n\n /** Cria um template e o submete à Meta para análise. */\n create(params: CreateTemplateParams): Promise<Template> {\n return this.client.requestItem<Template>(\"POST\", \"/templates\", {\n body: params,\n });\n }\n}\n","import type { BotoZap } from \"../client.js\";\nimport type {\n Broadcast,\n BroadcastRecipient,\n CursorList,\n CursorParams,\n OffsetList,\n OffsetParams,\n} from \"../types.js\";\n\nexport interface ListBroadcastsParams extends OffsetParams {\n status?: string;\n customer_id?: string;\n phone_number_id?: string;\n}\n\n/**\n * Corpo de `POST /v1/broadcasts` — espelha o contrato real da rota. A origem é\n * `phone_number_id` OU `waba_connection_id` (um dos dois obrigatório);\n * `template_name` + `template_language` são obrigatórios. A conta vem da chave,\n * nunca do corpo. (A rota NÃO aceita `customer_id` nem um objeto `template`.)\n */\nexport interface CreateBroadcastParams {\n name?: string;\n /** phone_number_id (Meta) do número de origem. */\n phone_number_id?: string;\n /** Alternativa a `phone_number_id`: a conexão WABA de origem. */\n waba_connection_id?: string;\n /** Nome do template aprovado (obrigatório). */\n template_name: string;\n /** Código de idioma do template, ex.: \"pt_BR\" (obrigatório). */\n template_language: string;\n /** Opcional: id interno do template (revalidado por ownership/conexão). */\n template_id?: string;\n}\n\n/** Transição de estado via `PATCH /v1/broadcasts/:id`. */\nexport interface UpdateBroadcastParams {\n /** `stopped` interrompe (sending/scheduled); `draft` cancela um agendamento. */\n status: \"stopped\" | \"draft\";\n}\n\nexport interface ScheduleBroadcastParams {\n /** Data/hora ISO 8601. */\n scheduled_at: string;\n [key: string]: unknown;\n}\n\n/** Filtros de `listRecipients` (paginação por cursor + filtro de status). */\nexport interface ListRecipientsParams extends CursorParams {\n /** Filtra por status do destinatário (ex.: \"pending\", \"sent\", \"failed\"). */\n status?: string;\n}\n\n/** Resultado de `addRecipients`: quantos entraram, quantos eram duplicados, erros. */\nexport interface AddRecipientsResult {\n added: number;\n duplicates: number;\n errors: unknown[];\n}\n\n/** Transmissões: criar, adicionar destinatários, agendar/enviar/cancelar. */\nexport class Broadcasts {\n constructor(private readonly client: BotoZap) {}\n\n /** Lista as transmissões da conta (paginação por offset/página). */\n list(params: ListBroadcastsParams = {}): Promise<OffsetList<Broadcast>> {\n return this.client.requestOffsetList<OffsetList<Broadcast>>(\"GET\", \"/broadcasts\", {\n query: {\n page: params.page,\n per_page: params.per_page,\n status: params.status,\n customer_id: params.customer_id,\n phone_number_id: params.phone_number_id,\n },\n });\n }\n\n get(id: string): Promise<Broadcast> {\n return this.client.requestItem<Broadcast>(\"GET\", `/broadcasts/${enc(id)}`);\n }\n\n create(params: CreateBroadcastParams): Promise<Broadcast> {\n return this.client.requestItem<Broadcast>(\"POST\", \"/broadcasts\", {\n body: params,\n });\n }\n\n update(id: string, params: UpdateBroadcastParams): Promise<Broadcast> {\n return this.client.requestItem<Broadcast>(\n \"PATCH\",\n `/broadcasts/${enc(id)}`,\n { body: params },\n );\n }\n\n /** Lista os destinatários de uma transmissão (paginação por cursor). */\n listRecipients(\n id: string,\n params: ListRecipientsParams = {},\n ): Promise<CursorList<BroadcastRecipient>> {\n return this.client.requestCursorList<CursorList<BroadcastRecipient>>(\n \"GET\",\n `/broadcasts/${enc(id)}/recipients`,\n {\n query: {\n limit: params.limit,\n after: params.after,\n before: params.before,\n status: params.status,\n },\n },\n );\n }\n\n /** Adiciona destinatários (lista de números ou contatos). */\n addRecipients(id: string, recipients: unknown[]): Promise<AddRecipientsResult> {\n return this.client.requestItem<AddRecipientsResult>(\n \"POST\",\n `/broadcasts/${enc(id)}/recipients`,\n { body: { recipients } },\n );\n }\n\n /** Remove TODOS os destinatários. Responde 204 (sem corpo). */\n removeRecipients(id: string): Promise<void> {\n return this.client.request<void>(\n \"DELETE\",\n `/broadcasts/${enc(id)}/recipients`,\n );\n }\n\n schedule(id: string, params: ScheduleBroadcastParams): Promise<Broadcast> {\n return this.client.requestItem<Broadcast>(\n \"POST\",\n `/broadcasts/${enc(id)}/schedule`,\n { body: params },\n );\n }\n\n send(id: string): Promise<Broadcast> {\n return this.client.requestItem<Broadcast>(\n \"POST\",\n `/broadcasts/${enc(id)}/send`,\n );\n }\n\n cancel(id: string): Promise<Broadcast> {\n return this.client.requestItem<Broadcast>(\n \"POST\",\n `/broadcasts/${enc(id)}/cancel`,\n );\n }\n}\n\nfunction enc(id: string): string {\n return encodeURIComponent(id);\n}\n","import type { BotoZap } from \"../client.js\";\nimport type { Contact, CursorList, CursorParams } from \"../types.js\";\n\nexport interface ListContactsParams extends CursorParams {\n /** Filtra pelos números do cliente (derivado da conexão do número). */\n customer_id?: string;\n /**\n * Nesta base todo contato pertence a um cliente; `false` nunca casa (página\n * vazia), `true` é no-op.\n */\n has_customer?: boolean;\n /** Busca parcial (ilike) no nome de perfil. */\n profile_name_contains?: string;\n /** Busca parcial (ilike) no wa_id. */\n wa_id_contains?: string;\n /** Criados em ou após esta data (ISO 8601). */\n created_after?: string;\n /** Criados em ou antes desta data (ISO 8601). */\n created_before?: string;\n}\n\nexport interface CreateContactParams {\n /** wa_id canônico (BSUID \"BR.1A2B…\" ou dígitos E.164). */\n wa_id: string;\n phone_number_id?: string;\n [key: string]: unknown;\n}\n\n/** Contatos: listar, buscar, criar, atualizar, remover. */\nexport class Contacts {\n constructor(private readonly client: BotoZap) {}\n\n /** Lista os contatos da conta (paginação por cursor). */\n list(params: ListContactsParams = {}): Promise<CursorList<Contact>> {\n return this.client.requestCursorList<CursorList<Contact>>(\"GET\", \"/contacts\", {\n query: {\n limit: params.limit,\n after: params.after,\n before: params.before,\n customer_id: params.customer_id,\n has_customer:\n params.has_customer === undefined\n ? undefined\n : String(params.has_customer),\n profile_name_contains: params.profile_name_contains,\n wa_id_contains: params.wa_id_contains,\n created_after: params.created_after,\n created_before: params.created_before,\n },\n });\n }\n\n get(id: string): Promise<Contact> {\n return this.client.requestItem<Contact>(\"GET\", `/contacts/${enc(id)}`);\n }\n\n create(params: CreateContactParams): Promise<Contact> {\n return this.client.requestItem<Contact>(\"POST\", \"/contacts\", {\n body: params,\n });\n }\n\n update(id: string, params: Record<string, unknown>): Promise<Contact> {\n return this.client.requestItem<Contact>(\"PATCH\", `/contacts/${enc(id)}`, {\n body: params,\n });\n }\n\n /** Remove um contato. Responde 204 (sem corpo). */\n delete(id: string): Promise<void> {\n return this.client.request<void>(\"DELETE\", `/contacts/${enc(id)}`);\n }\n}\n\nfunction enc(id: string): string {\n return encodeURIComponent(id);\n}\n","import type { BotoZap } from \"../client.js\";\nimport type {\n Assignment,\n Conversation,\n CursorList,\n CursorParams,\n OffsetList,\n OffsetParams,\n} from \"../types.js\";\n\nexport interface ListConversationsParams extends CursorParams {\n /** id da Meta OU uuid interno do número. */\n phone_number_id?: string;\n /** \"active\" | \"ended\" — derivado da janela de 24h. */\n status?: string;\n /**\n * Busca parcial por contato (nome de perfil, @username, telefone ou wa_id).\n * Tem precedência sobre `phone_number` na rota.\n */\n contact?: string;\n /** Alias de busca por contato (usado quando `contact` não é informado). */\n phone_number?: string;\n}\n\nexport interface CreateAssignmentParams {\n /** Membro a quem atribuir a conversa. */\n user_id: string;\n notes?: string;\n}\n\n/** Conversas (read + status) e atribuições a membros. */\nexport class Conversations {\n constructor(private readonly client: BotoZap) {}\n\n /** Lista as conversas da conta (paginação por cursor). */\n list(params: ListConversationsParams = {}): Promise<CursorList<Conversation>> {\n return this.client.requestCursorList<CursorList<Conversation>>(\n \"GET\",\n \"/conversations\",\n {\n query: {\n limit: params.limit,\n after: params.after,\n before: params.before,\n phone_number_id: params.phone_number_id,\n status: params.status,\n contact: params.contact,\n phone_number: params.phone_number,\n },\n },\n );\n }\n\n get(id: string): Promise<Conversation> {\n return this.client.requestItem<Conversation>(\n \"GET\",\n `/conversations/${enc(id)}`,\n );\n }\n\n update(id: string, params: Record<string, unknown>): Promise<Conversation> {\n return this.client.requestItem<Conversation>(\n \"PATCH\",\n `/conversations/${enc(id)}`,\n { body: params },\n );\n }\n\n /** Lista as atribuições da conversa (paginação por offset/página). */\n listAssignments(\n id: string,\n params: OffsetParams = {},\n ): Promise<OffsetList<Assignment>> {\n return this.client.requestOffsetList<OffsetList<Assignment>>(\n \"GET\",\n `/conversations/${enc(id)}/assignments`,\n { query: { page: params.page, per_page: params.per_page } },\n );\n }\n\n createAssignment(\n id: string,\n params: CreateAssignmentParams,\n ): Promise<Assignment> {\n return this.client.requestItem<Assignment>(\n \"POST\",\n `/conversations/${enc(id)}/assignments`,\n { body: params },\n );\n }\n\n getAssignment(id: string, assignmentId: string): Promise<Assignment> {\n return this.client.requestItem<Assignment>(\n \"GET\",\n `/conversations/${enc(id)}/assignments/${enc(assignmentId)}`,\n );\n }\n\n updateAssignment(\n id: string,\n assignmentId: string,\n params: Record<string, unknown>,\n ): Promise<Assignment> {\n return this.client.requestItem<Assignment>(\n \"PATCH\",\n `/conversations/${enc(id)}/assignments/${enc(assignmentId)}`,\n { body: params },\n );\n }\n}\n\nfunction enc(id: string): string {\n return encodeURIComponent(id);\n}\n","import type { BotoZap } from \"../client.js\";\nimport type { CursorList, CursorParams, Webhook } from \"../types.js\";\n\nexport interface CreateWebhookParams {\n url: string;\n events?: string[];\n active?: boolean;\n [key: string]: unknown;\n}\n\n/** Webhooks: endpoints assinados que recebem os eventos da conta. */\nexport class Webhooks {\n constructor(private readonly client: BotoZap) {}\n\n /** Lista os endpoints de webhook da conta (paginação por cursor). */\n list(params: CursorParams = {}): Promise<CursorList<Webhook>> {\n return this.client.requestCursorList<CursorList<Webhook>>(\"GET\", \"/webhooks\", {\n query: {\n limit: params.limit,\n after: params.after,\n before: params.before,\n },\n });\n }\n\n get(id: string): Promise<Webhook> {\n return this.client.requestItem<Webhook>(\"GET\", `/webhooks/${enc(id)}`);\n }\n\n create(params: CreateWebhookParams): Promise<Webhook> {\n return this.client.requestItem<Webhook>(\"POST\", \"/webhooks\", {\n body: params,\n });\n }\n\n update(id: string, params: Record<string, unknown>): Promise<Webhook> {\n return this.client.requestItem<Webhook>(\"PATCH\", `/webhooks/${enc(id)}`, {\n body: params,\n });\n }\n\n /** Remove um endpoint. Responde 204 (sem corpo). */\n delete(id: string): Promise<void> {\n return this.client.request<void>(\"DELETE\", `/webhooks/${enc(id)}`);\n }\n\n /** Dispara um evento de teste para o endpoint. */\n test(id: string): Promise<{ success: boolean }> {\n return this.client.requestItem<{ success: boolean }>(\n \"POST\",\n `/webhooks/${enc(id)}/test`,\n );\n }\n}\n\nfunction enc(id: string): string {\n return encodeURIComponent(id);\n}\n","import type { BotoZap } from \"../client.js\";\nimport type { OffsetList, OffsetParams, PhoneNumber } from \"../types.js\";\n\nexport interface ListPhoneNumbersParams extends OffsetParams {\n customer_id?: string;\n}\n\n/** Números conectados de cada cliente. */\nexport class PhoneNumbers {\n constructor(private readonly client: BotoZap) {}\n\n /** Lista os números da conta (paginação por offset/página). */\n list(params: ListPhoneNumbersParams = {}): Promise<OffsetList<PhoneNumber>> {\n return this.client.requestOffsetList<OffsetList<PhoneNumber>>(\n \"GET\",\n \"/phone_numbers\",\n {\n query: {\n page: params.page,\n per_page: params.per_page,\n customer_id: params.customer_id,\n },\n },\n );\n }\n\n get(id: string): Promise<PhoneNumber> {\n return this.client.requestItem<PhoneNumber>(\n \"GET\",\n `/phone_numbers/${enc(id)}`,\n );\n }\n\n // NOTA: `update` foi removido de propósito. A rota PATCH /v1/phone_numbers/:id\n // responde SEMPRE 422 `no_updatable_fields` — o schema atual só tem campos de\n // identidade e campos sincronizados da Meta, nenhum editável por aqui. Expor o\n // método só entregaria uma chamada garantidamente quebrada.\n\n /** Remove um número. Responde 204 (sem corpo). */\n delete(id: string): Promise<void> {\n return this.client.request<void>(\"DELETE\", `/phone_numbers/${enc(id)}`);\n }\n\n /** Saúde do número (qualidade, limite, status na Meta). */\n health(id: string): Promise<Record<string, unknown>> {\n return this.client.requestItem<Record<string, unknown>>(\n \"GET\",\n `/phone_numbers/${enc(id)}/health`,\n );\n }\n}\n\nfunction enc(id: string): string {\n return encodeURIComponent(id);\n}\n","import type { BotoZap } from \"../client.js\";\nimport type { Flow, FlowVersion, OffsetList, OffsetParams } from \"../types.js\";\n\nexport interface CreateFlowParams {\n name?: string;\n [key: string]: unknown;\n}\n\n/**\n * Filtros de `flows.list` (paginação por offset). Flows vivem na Meta e a lista\n * é por WABA — a rota GET /v1/flows EXIGE `phone_number_id` OU\n * `waba_connection_id` (sem um deles responde 422 missing_target). Informe um.\n */\nexport interface ListFlowsParams extends OffsetParams {\n /** phone_number_id (Meta) → resolve a conexão do número (escopado por conta). */\n phone_number_id?: string;\n /** Alternativa a `phone_number_id`: a conexão WABA cujos flows listar. */\n waba_connection_id?: string;\n}\n\n/**\n * Flows vivem na Meta, não no nosso banco — a amarração flow → conta é via\n * `phone_number_id` (resolve a WABA e o token). Por isso get/delete/publish/\n * setup_encryption/versions/data_endpoint EXIGEM `phone_number_id`.\n */\nexport interface FlowPhoneParams {\n /** phone_number_id (Meta) do número cuja WABA hospeda o flow. */\n phone_number_id: string;\n}\n\n/** Corpo de `POST /v1/flows/:id/versions` — sobe um novo flow.json. */\nexport interface CreateFlowVersionParams {\n phone_number_id: string;\n /** JSON do flow (objeto ou string JSON válida). */\n flow_json: unknown;\n [key: string]: unknown;\n}\n\n/** Corpo de `POST /v1/flows/:id/data_endpoint` — conecta a forward URL do dev. */\nexport interface SetFlowDataEndpointParams {\n phone_number_id: string;\n /** URL HTTPS do backend do dev que recebe o data_exchange. */\n forward_url: string;\n [key: string]: unknown;\n}\n\n/** WhatsApp Flows: criar, versionar, publicar e configurar data endpoint. */\nexport class Flows {\n constructor(private readonly client: BotoZap) {}\n\n /**\n * Lista os flows de uma WABA (paginação por offset/página). Informe\n * `phone_number_id` OU `waba_connection_id` — a rota exige um deles.\n */\n list(params: ListFlowsParams = {}): Promise<OffsetList<Flow>> {\n return this.client.requestOffsetList<OffsetList<Flow>>(\"GET\", \"/flows\", {\n query: {\n page: params.page,\n per_page: params.per_page,\n phone_number_id: params.phone_number_id,\n waba_connection_id: params.waba_connection_id,\n },\n });\n }\n\n get(id: string, params: FlowPhoneParams): Promise<Flow> {\n return this.client.requestItem<Flow>(\"GET\", `/flows/${enc(id)}`, {\n query: { phone_number_id: params.phone_number_id },\n });\n }\n\n create(params: CreateFlowParams): Promise<Flow> {\n return this.client.requestItem<Flow>(\"POST\", \"/flows\", { body: params });\n }\n\n /** Remove um flow (só DRAFT, regra da Meta). Responde 204 (sem corpo). */\n delete(id: string, params: FlowPhoneParams): Promise<void> {\n return this.client.request<void>(\"DELETE\", `/flows/${enc(id)}`, {\n query: { phone_number_id: params.phone_number_id },\n });\n }\n\n publish(id: string, params: FlowPhoneParams): Promise<Flow> {\n return this.client.requestItem<Flow>(\"POST\", `/flows/${enc(id)}/publish`, {\n body: { phone_number_id: params.phone_number_id },\n });\n }\n\n /** Lista as versões de um flow (paginação por offset/página). */\n listVersions(\n id: string,\n params: OffsetParams = {},\n ): Promise<OffsetList<FlowVersion>> {\n return this.client.requestOffsetList<OffsetList<FlowVersion>>(\n \"GET\",\n `/flows/${enc(id)}/versions`,\n { query: { page: params.page, per_page: params.per_page } },\n );\n }\n\n createVersion(\n id: string,\n params: CreateFlowVersionParams,\n ): Promise<FlowVersion> {\n return this.client.requestItem<FlowVersion>(\n \"POST\",\n `/flows/${enc(id)}/versions`,\n { body: params },\n );\n }\n\n setupEncryption(\n id: string,\n params: FlowPhoneParams,\n ): Promise<Record<string, unknown>> {\n return this.client.requestItem<Record<string, unknown>>(\n \"POST\",\n `/flows/${enc(id)}/setup_encryption`,\n { body: { phone_number_id: params.phone_number_id } },\n );\n }\n\n getDataEndpoint(id: string): Promise<Record<string, unknown>> {\n return this.client.requestItem<Record<string, unknown>>(\n \"GET\",\n `/flows/${enc(id)}/data_endpoint`,\n );\n }\n\n setDataEndpoint(\n id: string,\n params: SetFlowDataEndpointParams,\n ): Promise<Record<string, unknown>> {\n return this.client.requestItem<Record<string, unknown>>(\n \"POST\",\n `/flows/${enc(id)}/data_endpoint`,\n { body: params },\n );\n }\n}\n\nfunction enc(id: string): string {\n return encodeURIComponent(id);\n}\n","import type { BotoZap } from \"../client.js\";\nimport type { MediaAsset, MediaUploadResult } from \"../types.js\";\n\n/** Corpo do `POST /v1/media` — espelha o contrato real da rota. */\nexport interface UploadMediaParams {\n /** URL http(s) de origem do arquivo. A BotoZap baixa (com guard SSRF) e sobe pra Cloud API. */\n source: string;\n /** phone_number_id (da Meta) do número de origem. Obrigatório. */\n phone_number_id: string;\n /** Nome do arquivo (default: derivado da URL). */\n filename?: string;\n /** MIME type (default: Content-Type do download). */\n mime_type?: string;\n /** Pipeline de upload: `meta_media` (default) ou `meta_resumable_asset`. */\n delivery?: \"meta_media\" | \"meta_resumable_asset\";\n [key: string]: unknown;\n}\n\n/** Mídia: sobe um arquivo e devolve um media_id usável em mensagens. */\nexport class Media {\n constructor(private readonly client: BotoZap) {}\n\n upload(params: UploadMediaParams): Promise<MediaUploadResult> {\n return this.client.requestItem<MediaUploadResult>(\"POST\", \"/media\", {\n body: params,\n });\n }\n\n /**\n * Busca os metadados de uma mídia RECEBIDA pelo `media_id` da Cloud API,\n * incluindo `download_url` — uma URL assinada e efêmera que você pode baixar\n * direto (GET), válida até `expires_at`.\n *\n * A mídia é espelhada de forma assíncrona; se você consultar antes de terminar,\n * a rota responde 202 e este método lança `BotoZapError` com\n * `code: \"media_not_ready\"`. Nesse caso, aguarde e retente — o segundo que faltar\n * está em `err.headers?.[\"retry-after\"]`:\n *\n * ```ts\n * try {\n * const media = await boto.media.get(\"wamid_media_id\");\n * // baixe media.download_url direto\n * } catch (err) {\n * if (err instanceof BotoZapError && err.code === \"media_not_ready\") {\n * const wait = Number(err.headers?.[\"retry-after\"] ?? 5);\n * // retente após `wait` segundos\n * }\n * }\n * ```\n *\n * Existe também `GET /v1/media/:id/download`, que responde 302 redirecionando\n * para a mesma URL assinada; não há método SDK dedicado porque `download_url`\n * (acima) já entrega essa URL sem o hop de redirect.\n */\n get(id: string): Promise<MediaAsset> {\n return this.client.requestItem<MediaAsset>(\n \"GET\",\n `/media/${encodeURIComponent(id)}`,\n );\n }\n}\n","import type { BotoZap } from \"../client.js\";\nimport type {\n ApiLog,\n CursorList,\n CursorParams,\n OffsetList,\n OffsetParams,\n User,\n WebhookDelivery,\n} from \"../types.js\";\n\n/** Membros da conta (somente leitura via API). */\nexport class Users {\n constructor(private readonly client: BotoZap) {}\n\n /** Lista os membros da conta (paginação por offset/página). */\n list(params: OffsetParams = {}): Promise<OffsetList<User>> {\n return this.client.requestOffsetList<OffsetList<User>>(\"GET\", \"/users\", {\n query: { page: params.page, per_page: params.per_page },\n });\n }\n}\n\nexport interface ListApiLogsParams extends CursorParams {\n /** Origem do log (ex.: \"api\"). */\n source?: string;\n /** Método HTTP (a rota normaliza para maiúsculas). */\n method?: string;\n /** Código HTTP exato (inteiro). */\n status_code?: number;\n}\n\n/** Logs de requisições à API (somente leitura, paginação por cursor). */\nexport class ApiLogs {\n constructor(private readonly client: BotoZap) {}\n\n list(params: ListApiLogsParams = {}): Promise<CursorList<ApiLog>> {\n return this.client.requestCursorList<CursorList<ApiLog>>(\"GET\", \"/api_logs\", {\n query: {\n limit: params.limit,\n after: params.after,\n before: params.before,\n source: params.source,\n method: params.method,\n status_code: params.status_code,\n },\n });\n }\n}\n\nexport interface ListWebhookDeliveriesParams extends CursorParams {\n /** Alias de `endpoint_id` na rota — entregas de um endpoint específico. */\n webhook_id?: string;\n /** delivery_status (pending|success|failed|exhausted). */\n status?: string;\n /** Tipo do evento (ex.: \"webhook.test\", \"messages\"). */\n event_type?: string;\n}\n\n/** Histórico de entregas de webhook (somente leitura, paginação por cursor). */\nexport class WebhookDeliveries {\n constructor(private readonly client: BotoZap) {}\n\n list(\n params: ListWebhookDeliveriesParams = {},\n ): Promise<CursorList<WebhookDelivery>> {\n return this.client.requestCursorList<CursorList<WebhookDelivery>>(\n \"GET\",\n \"/webhook_deliveries\",\n {\n query: {\n limit: params.limit,\n after: params.after,\n before: params.before,\n webhook_id: params.webhook_id,\n status: params.status,\n event_type: params.event_type,\n },\n },\n );\n }\n}\n","import { BotoZapError } from \"./errors.js\";\nimport { Messages } from \"./resources/messages.js\";\nimport { Customers } from \"./resources/customers.js\";\nimport { Templates } from \"./resources/templates.js\";\nimport { Broadcasts } from \"./resources/broadcasts.js\";\nimport { Contacts } from \"./resources/contacts.js\";\nimport { Conversations } from \"./resources/conversations.js\";\nimport { Webhooks } from \"./resources/webhooks.js\";\nimport { PhoneNumbers } from \"./resources/phone-numbers.js\";\nimport { Flows } from \"./resources/flows.js\";\nimport { Media } from \"./resources/media.js\";\nimport { Users, ApiLogs, WebhookDeliveries } from \"./resources/read-only.js\";\n\nexport interface BotoZapOptions {\n /** Chave de API da conta (cabeçalho Authorization: Bearer). */\n apiKey: string;\n /** Sobrescreve a URL base. Padrão: https://botozap.com.br/api/v1 */\n baseUrl?: string;\n /** Injeta um fetch (testes, runtimes sem fetch global). */\n fetch?: typeof fetch;\n}\n\nexport interface RequestOptions {\n query?: Record<string, string | number | undefined>;\n body?: unknown;\n}\n\nconst DEFAULT_BASE_URL = \"https://botozap.com.br/api/v1\";\n\n/**\n * Cliente da API da BotoZap.\n *\n * ```ts\n * const boto = new BotoZap({ apiKey: process.env.BOTOZAP_KEY! });\n * await boto.messages.send({ to: \"+5531988887777\", text: \"Olá!\" });\n * ```\n */\nexport class BotoZap {\n readonly messages: Messages;\n readonly customers: Customers;\n readonly templates: Templates;\n readonly broadcasts: Broadcasts;\n readonly contacts: Contacts;\n readonly conversations: Conversations;\n readonly webhooks: Webhooks;\n readonly phoneNumbers: PhoneNumbers;\n readonly flows: Flows;\n readonly media: Media;\n readonly users: Users;\n readonly apiLogs: ApiLogs;\n readonly webhookDeliveries: WebhookDeliveries;\n\n private readonly apiKey: string;\n private readonly baseUrl: string;\n private readonly fetchImpl: typeof fetch;\n\n constructor(options: BotoZapOptions) {\n if (!options || !options.apiKey) {\n throw new Error(\"BotoZap: apiKey é obrigatório.\");\n }\n this.apiKey = options.apiKey;\n this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n\n const resolvedFetch = options.fetch ?? globalThis.fetch;\n if (typeof resolvedFetch !== \"function\") {\n throw new Error(\n \"BotoZap: fetch global não encontrado. Use Node 20.19+ ou passe a opção `fetch`.\",\n );\n }\n this.fetchImpl = resolvedFetch;\n\n this.messages = new Messages(this);\n this.customers = new Customers(this);\n this.templates = new Templates(this);\n this.broadcasts = new Broadcasts(this);\n this.contacts = new Contacts(this);\n this.conversations = new Conversations(this);\n this.webhooks = new Webhooks(this);\n this.phoneNumbers = new PhoneNumbers(this);\n this.flows = new Flows(this);\n this.media = new Media(this);\n this.users = new Users(this);\n this.apiLogs = new ApiLogs(this);\n this.webhookDeliveries = new WebhookDeliveries(this);\n }\n\n /** Faz uma requisição autenticada e devolve o corpo já parseado. */\n async request<T>(\n method: string,\n path: string,\n opts: RequestOptions = {},\n ): Promise<T> {\n const url = new URL(this.baseUrl + path);\n if (opts.query) {\n for (const [key, value] of Object.entries(opts.query)) {\n if (value !== undefined) url.searchParams.set(key, String(value));\n }\n }\n\n let res: Awaited<ReturnType<typeof fetch>>;\n try {\n res = await this.fetchImpl(url.toString(), {\n method,\n headers: {\n Authorization: `Bearer ${this.apiKey}`,\n \"Content-Type\": \"application/json\",\n Accept: \"application/json\",\n },\n body: opts.body === undefined ? undefined : JSON.stringify(opts.body),\n });\n } catch (cause) {\n // `fetch` REJEITA (DNS, conexão recusada, offline, abort) com um TypeError\n // — não é uma resposta HTTP. Se vazasse cru, o chamador teria dois tipos de\n // erro pra tratar (BotoZapError vs. TypeError). Embrulhamos num BotoZapError\n // de rede: um único tipo pra capturar, com `code` distinguindo rede de HTTP.\n // status 0 = não houve resposta HTTP.\n const detail = cause instanceof Error ? cause.message : String(cause);\n throw new BotoZapError(\n \"network_error\",\n `falha de rede ao chamar a API: ${detail}`,\n 0,\n );\n }\n\n const raw = await res.text();\n const data = raw ? safeJson(raw) : undefined;\n\n const envelope = data as\n | { error?: { code?: string; message?: string } }\n | undefined;\n // Um corpo `{ error: {...} }` é um ERRO ainda que o status seja 2xx. A rota\n // `GET /v1/media/:id` usa exatamente isso: quando a mídia ainda está sendo\n // espelhada, responde 202 + `{error:{code:\"media_not_ready\"}}` + `Retry-After`\n // (o dev deve retentar). Sem tratar o envelope aqui, o 202 passaria como\n // \"sucesso\" e o desempacote de item viraria um `malformed_response` genérico\n // — o dev não conseguiria distinguir o \"retente em instantes\".\n const hasErrorEnvelope =\n typeof envelope === \"object\" &&\n envelope !== null &&\n typeof envelope.error === \"object\" &&\n envelope.error !== null;\n\n if (!res.ok || hasErrorEnvelope) {\n // Expõe os headers da RESPOSTA no erro — num 429 (ou no 202 media_not_ready)\n // o chamador precisa de `Retry-After`/`X-RateLimit-*` para saber quando\n // reenviar. Só headers da resposta; nada do request (que carrega a apiKey)\n // toca este objeto.\n const headers: Record<string, string> = {};\n res.headers.forEach((value, key) => {\n headers[key] = value;\n });\n throw new BotoZapError(\n envelope?.error?.code ?? \"http_error\",\n envelope?.error?.message ?? `HTTP ${res.status}`,\n res.status,\n headers,\n );\n }\n\n return data as T;\n }\n\n /**\n * Requisição a um endpoint de ITEM (singular). A API embrulha essas respostas\n * em `{ data: <obj> }` (helper `ok`); este método desempacota e devolve a\n * entidade. NÃO é uma heurística \"se tem .data desempacota\" — o desempacote é\n * o contrato conhecido do endpoint, declarado por quem chama este método (as\n * rotas de LISTA usam `request` e devolvem `{ data, paging|meta }` inteiro; a\n * rota POST /messages responde direto e também usa `request`).\n */\n async requestItem<T>(\n method: string,\n path: string,\n opts: RequestOptions = {},\n ): Promise<T> {\n const env = await this.request<{ data: T }>(method, path, opts);\n // Contrato: endpoints de ITEM respondem `{ data: <obj> }`. Sem a chave\n // `data`, `(env).data` seria `undefined` SILENCIOSO — o chamador recebe\n // undefined e só quebra lá na frente, longe da causa. Falha alto e claro\n // aqui. (`data: null` explícito PASSA — a chave existe; é 200-sem-envelope\n // que é violação.) status 0 = erro de contrato do cliente, não HTTP.\n if (env == null || typeof env !== \"object\" || !(\"data\" in env)) {\n throw new BotoZapError(\n \"malformed_response\",\n \"resposta sem envelope data — contrato violado\",\n 0,\n );\n }\n return (env as { data: T }).data;\n }\n\n /** Resposta JSON direta que precisa ser um objeto (ex.: POST /messages). */\n async requestObject<T>(\n method: string,\n path: string,\n opts: RequestOptions = {},\n ): Promise<T> {\n const value = await this.request<unknown>(method, path, opts);\n if (!isObject(value)) {\n throw malformed(\"resposta deveria ser um objeto JSON\");\n }\n return value as T;\n }\n\n /** Lista paginada por cursor: exige `{ data: [], paging: {} }`. */\n async requestCursorList<T>(\n method: string,\n path: string,\n opts: RequestOptions = {},\n ): Promise<T> {\n const value = await this.request<unknown>(method, path, opts);\n if (!isObject(value) || !Array.isArray(value.data) || !isObject(value.paging)) {\n throw malformed(\"resposta sem data[]/paging — contrato de cursor violado\");\n }\n return value as T;\n }\n\n /** Lista paginada por offset: exige `{ data: [], meta: {} }`. */\n async requestOffsetList<T>(\n method: string,\n path: string,\n opts: RequestOptions = {},\n ): Promise<T> {\n const value = await this.request<unknown>(method, path, opts);\n if (!isObject(value) || !Array.isArray(value.data) || !isObject(value.meta)) {\n throw malformed(\"resposta sem data[]/meta — contrato de offset violado\");\n }\n return value as T;\n }\n}\n\nfunction isObject(value: unknown): value is Record<string, unknown> {\n return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction malformed(message: string): BotoZapError {\n return new BotoZapError(\"malformed_response\", message, 0);\n}\n\nfunction safeJson(text: string): unknown {\n try {\n return JSON.parse(text);\n } catch {\n return text;\n }\n}\n"],"mappings":"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","names":["enc","enc","enc","enc","enc","enc"]}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@botozap/sdk",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.2.0",
|
|
4
4
|
"description": "SDK oficial da BotoZap — envie mensagens e gerencie clientes na WhatsApp Cloud API oficial, multi-tenant.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/index.cjs",
|
|
@@ -21,6 +21,7 @@
|
|
|
21
21
|
"files": [
|
|
22
22
|
"dist",
|
|
23
23
|
"README.md",
|
|
24
|
+
"CHANGELOG.md",
|
|
24
25
|
"LICENSE"
|
|
25
26
|
],
|
|
26
27
|
"engines": {
|