@erlancarreira/evolution-chat 0.1.0

package/README.md

@@ -0,0 +1,202 @@
+# @erlancarreira/evolution-chat
+
+Widget de chat (React) + bridge para a **Evolution API v2** (WhatsApp): o visitante abre uma
+conversa no site, o SDK cria um grupo no WhatsApp com o número da plataforma, relaya as
+mensagens nos dois sentidos e entrega tudo em tempo real no painel — com polling de 5 s como
+fallback quando o canal cai. Arquitetura hexagonal: o núcleo (`bridge`) só conhece **portas**
+(`SessionStore`, `RealtimeTransport`, `RealtimeHandle`, `ChatLimiter`) — persistência e
+transporte são injetados; o adapter oficial usa Supabase, mas qualquer banco serve.
+
+| Subpath | O que entrega |
+| --- | --- |
+| `./api` | `createEvolutionClient`, parser de webhook, ids, telefone |
+| `./bridge` | `ChatBridge`, portas (`SessionStore`, `RealtimeTransport`, …), router |
+| `./next` | `createChatRoutes`, `createWebhookRoute` (App Router, sem importar `next`) |
+| `./transports/supabase` | `createSupabaseTransport` (server) · `createSupabaseRealtimeHandle` (widget) |
+| `./widget` | `<ChatWidget>` React + `injectWidgetStyles` + i18n (pt/en/es) |
+| `widget-embed/evolution-chat.iife.js` | `<evolution-chat>` standalone (`<script>`, React embutido) |
+
+## Instalação
+
+```bash
+npm install @erlancarreira/evolution-chat   # npm (react + react-dom são peers)
+npm install github:erlancarreira/evolution-chat     # do repositório — rode `npm run build` (a saída não é versionada)
+npm install file:../evolution-chat          # cópia local em desenvolvimento (idem)
+```
+
+`@supabase/supabase-js` é peer **opcional** (só para os adapters de realtime). No `<script>`
+nada disso se aplica: React, react-dom e supabase-js vão embutidos.
+
+## Quickstart — Next.js (App Router)
+
+**1. Monte o bridge uma vez (server-only).** `getConfig` é resolvido a cada request, então a
+config pode viver numa tabela de settings do tenant.
+
+```ts
+// lib/chat/server.ts
+import { createClient } from "@supabase/supabase-js";
+import { createEvolutionClient } from "@erlancarreira/evolution-chat/api";
+import { ChatBridge } from "@erlancarreira/evolution-chat/bridge";
+import { createSupabaseTransport } from "@erlancarreira/evolution-chat/transports/supabase";
+import { createChatRoutes, createWebhookRoute } from "@erlancarreira/evolution-chat/next";
+import { createSessionStore } from "./session-store";   // seu adapter (ver seção)
+import { getChatConfig } from "./settings";              // () => Promise<ChatConfig>
+
+const admin = createClient(process.env.SUPABASE_URL!, process.env.SUPABASE_SERVICE_ROLE_KEY!);
+const bridge = new ChatBridge({
+  client: createEvolutionClient({ baseUrl: process.env.EVOLUTION_URL!, apiKey: process.env.EVOLUTION_API_KEY! }),
+  store: createSessionStore(admin),
+  transport: createSupabaseTransport(admin),
+});
+
+export const chat = createChatRoutes({ bridge, getConfig: getChatConfig, getIpHash: hashIp });
+// hashIp: (req) => sha256(ip + salt) — sem isto o limite de sessões por IP não roda
+export const webhook = createWebhookRoute({ bridge, getConfig: getChatConfig });
+```
+
+**2. Encaminhe as rotas.**
+
+```ts
+// app/api/chat/route.ts
+export const GET = (req: Request) => chat.GET(req);
+export const POST = (req: Request) => chat.POST(req);
+
+// app/api/chat/webhook/route.ts  →  Evolution aponta para /api/chat/webhook?token=<webhookToken>
+export const POST = (req: Request) => webhook.POST(req);
+```
+
+**3. Renderize o widget** (client component). O CSS é auto-injetado no mount (prefere `<link>`?
+importe `@erlancarreira/evolution-chat/widget/styles.css`); `realtime` é a porta que assina o canal da sessão.
+
+```tsx
+"use client";
+import { ChatWidget } from "@erlancarreira/evolution-chat/widget";
+import { createSupabaseRealtimeHandle } from "@erlancarreira/evolution-chat/transports/supabase";
+
+const realtime = createSupabaseRealtimeHandle(process.env.NEXT_PUBLIC_SUPABASE_URL!,
+  process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY!);
+
+export function SupportChat() {
+  return <ChatWidget endpoint="/api/chat" locale="pt" projectName="Aulivra"
+    welcome="Fale com a gente no WhatsApp" accentColor="#25D366" realtime={realtime} />;
+}
+```
+
+## Quickstart — `<script>` (sem bundler)
+
+Sirva `widget-embed/evolution-chat.iife.js` (copie para `public/` ou aponte para o CDN;
+≈1 MB não minificado, ~207 kB gzip) e use a tag: atributos viram props, e
+`data-supabase-url`/`data-supabase-key` ligam o realtime — sem eles o widget cai no polling de
+5 s em vez de quebrar.
+
+```html
+<script src="/evolution-chat.iife.js"></script>
+<evolution-chat
+  endpoint="/api/chat"
+  locale="pt"
+  welcome="Precisa de ajuda?"
+  project="Aulivra"
+  accent="#25D366"
+  data-supabase-url="https://xyz.supabase.co"
+  data-supabase-key="chave-anon-publica"
+></evolution-chat>
+```
+
+O widget monta dentro de um **shadow root** (o CSS `.ecw-*` é injetado lá dentro, isolando os dois
+lados). A global do bundle é `EvolutionChatEmbed`; incluir o script duas vezes não lança.
+
+## `ChatConfig`
+
+É o objeto que `getConfig` devolve, a cada request. O padrão é ler de settings do tenant, com os segredos vindos de env:
+
+```ts
+import type { ChatConfig } from "@erlancarreira/evolution-chat/next";
+
+export async function getChatConfig(): Promise<ChatConfig> {
+  const s = await db.settings.findFirst();
+  return {
+    enabled: s?.chatEnabled ?? false,                    // false → POST /api/chat devolve 404
+    projectName: s?.chatProjectName ?? "Aulivra",        // assunto do grupo: "<projectName> — <nome> (#CODE)"
+    platformNumber: s?.chatPlatformNumber ?? "5511999998888", // número da plataforma (só dígitos, com DDI)
+    evolutionUrl: process.env.EVOLUTION_URL!,            // ex.: https://evolution.exemplo.com.br
+    instance: process.env.EVOLUTION_INSTANCE!,           // instância conectada a esse número
+    apiKey: process.env.EVOLUTION_API_KEY!,              // apikey da instância (NUNCA vai ao cliente)
+    welcome: s?.chatWelcome ?? "Como podemos ajudar?",
+    closeHours: s?.chatCloseHours ?? 24,                 // inatividade p/ fechar (0 = nunca)
+    leaveOnClose: s?.chatLeaveOnClose ?? true,           // sai do grupo ao encerrar
+    webhookToken: process.env.CHAT_WEBHOOK_TOKEN!,       // segredo do webhook
+  };
+}
+```
+
+`closeHours`/`leaveOnClose` são consumidos pelo **hospedeiro**: quem fecha (cron, painel do
+atendente) chama `store.markStatus(id, "closed")` e, se `leaveOnClose`,
+`client.leaveGroup(instance, groupJid)`. Para avisar o visitante na hora, publique
+`{ type: "session", status: "closed" }` via `transport.publish` — hoje o SDK publica só
+`{ type: "message" }`; sem esse publish o status chega ao widget apenas no GET (reabrir o
+painel, ou o polling quando o canal cai).
+
+## Implementando um `SessionStore` próprio
+
+`import type { SessionStore, ChatSession, ChatMessage } from "@erlancarreira/evolution-chat/bridge"`
+— é a única superfície de persistência que o bridge usa. Não há cache nem estado em memória.
+
+```ts
+export interface SessionStore {
+  createSession(input: { code: string; realtimeToken: string; visitorName: string;
+    visitorPhone: string; visitorContact?: string | null; groupJid: string | null;
+    ipHash?: string | null; userAgent?: string | null }): Promise<ChatSession>;
+  getSessionByToken(token: string): Promise<ChatSession | null>;         // token = realtimeToken
+  getSessionByGroupJid(jid: string): Promise<ChatSession | null>;        // roteia o webhook pelo grupo
+  appendMessage(input: { sessionId: string; direction: ChatMessageDirection; body: string;
+    waMessageId?: string | null; status?: ChatMessageStatus }): Promise<ChatMessage>;
+  updateMessageStatus(id: string, status: ChatMessageStatus): Promise<void>;
+  listMessages(sessionId: string, afterIso?: string | null): Promise<ChatMessage[]>;
+  findMessageByWaId(sessionId: string, waMessageId: string): Promise<ChatMessage | null>;
+  registerSentMessageId(sessionId: string, waMessageId: string): Promise<void>;
+  isEcho(sessionId: string, waMessageId: string): Promise<boolean>;
+  touchSession(sessionId: string, atIso: string): Promise<void>;
+  setGroupJid(sessionId: string, groupJid: string): Promise<void>;
+  markStatus(sessionId: string, status: ChatSessionStatus, reason?: string): Promise<void>;
+  countRecentSessionsByIpHash(ipHash: string, windowMs: number): Promise<number>;
+}
+```
+
+O que o bridge **espera** do seu adapter:
+
+- `appendMessage` devolve a mensagem com `id` e `createdAt` (ISO) preenchidos — `createdAt` é o
+  cursor do polling/replay.
+- `findMessageByWaId` + `registerSentMessageId`/`isEcho` sustentam a idempotência: a Evolution
+  reenvia enquanto não devolvemos `handled: true`, e o eco das mensagens que **nós** enviamos
+  precisa ser reconhecido (tabela própria de ids, não uma coluna em `messages`).
+- `getSessionByGroupJid` é 1 grupo ↔ 1 sessão; o router **não** filtra por status, então
+  devolva `null` em `closed`/`failed` para não anexar mensagens a conversa encerrada.
+  `touchSession` atualiza `lastMessageAt` (o que alimenta um job de `closeHours`).
+- `countRecentSessionsByIpHash` é a guarda de 5 sessões/IP/10 min. O `ipHash` e o `userAgent`
+  da requisição chegam ao adapter via `createSession({ ..., ipHash, userAgent })`, então basta
+  persistir as colunas `ip_hash`/`user_agent` da migration para a contagem funcionar contra a
+  mesma tabela `chat_sessions` (o adapter Supabase do LMS faz isso). O `limiter` de
+  `createChatRoutes` (30 POSTs/min/IP) funciona independente, via a porta `ChatLimiter`.
+- Falha de infraestrutura: `throw` — as rotas mapeiam para 500/502 (nunca 422).
+
+## Segurança
+
+- **Webhook sempre responde 200.** Um 5xx faz a Evolution reentregar para sempre; token
+  inválido, corpo não-JSON e erro interno devolvem `{ ignored: true }` com log server-side, sem
+  vazar o motivo. O `webhookToken` (URL `?token=…` ou header `x-webhook-token`) é a única
+  credencial do endpoint: valor longo e aleatório, trocado se vazar.
+- **Não logue segredos.** `apiKey` e `webhookToken` ficam no servidor (`getConfig`); as rotas
+  nunca devolvem a sessão completa — só `code`/`status`/`visitorName` (mais o `realtimeToken` no
+  POST que abre a conversa). Telefone do visitante e `groupJid` não saem do servidor.
+- **Rate limit em duas camadas:** 5 sessões/IP/10 min no bridge e 30 POSTs/min/IP no `limiter`
+  das rotas. O honeypot `website` faz o bot receber sucesso falso, sem tocar em banco nem
+  Evolution.
+- **RLS no Supabase:** as tabelas ficam só para a service role (adapter server-side); habilite
+  RLS sem policies para `anon`. O canal de realtime é **broadcast** (não passa por RLS) — por
+  isso a credencial de escuta é o `realtimeToken` de 192 bits gerado por sessão. No `<script>`,
+  `data-supabase-key` é a chave **anon/public** — nunca a service role.
+
+## Desenvolvimento
+
+`npm run build` (tsup → `{api,bridge,next,transports/supabase,widget,widget-embed}` na raiz do pacote) ·
+`npm test` (vitest, node + jsdom) · `npm run typecheck` · `npm run lint`. Licença: MIT.

package/api/index.cjs

@@ -0,0 +1,278 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/api/index.ts
+var api_exports = {};
+__export(api_exports, {
+  EvolutionApiError: () => EvolutionApiError,
+  createEvolutionClient: () => createEvolutionClient,
+  generateRealtimeToken: () => generateRealtimeToken,
+  generateSessionCode: () => generateSessionCode,
+  isValidPhone: () => isValidPhone,
+  normalizePhone: () => normalizePhone,
+  parseWebhookEvent: () => parseWebhookEvent,
+  toWhatsappJid: () => toWhatsappJid
+});
+module.exports = __toCommonJS(api_exports);
+
+// src/errors.ts
+var ChatError = class extends Error {
+  code;
+  cause;
+  constructor(message, code, cause) {
+    super(message);
+    this.name = "ChatError";
+    this.code = code;
+    this.cause = cause;
+  }
+};
+
+// src/api/phone.ts
+var NON_DIGITS = /\D+/g;
+function normalizePhone(raw, defaultDdi = "55") {
+  const digits = raw.replace(NON_DIGITS, "");
+  if (!digits) throw new ChatError("Telefone vazio", "invalid_input");
+  const explicitDdi = raw.includes("+");
+  const withDdi = digits.length <= 11 && !explicitDdi && !digits.startsWith(defaultDdi) ? defaultDdi + digits : digits;
+  if (withDdi.length < 10 || withDdi.length > 15) {
+    throw new ChatError("Telefone inv\xE1lido", "invalid_input");
+  }
+  return withDdi;
+}
+function isValidPhone(digits) {
+  return digits.length >= 10 && digits.length <= 15;
+}
+function toWhatsappJid(phoneDigits) {
+  return `${phoneDigits}@s.whatsapp.net`;
+}
+
+// src/api/ids.ts
+var SESSION_ALPHABET = "ABCDEFGHJKMNPQRSTUVWXYZ23456789";
+var SESSION_CODE_LENGTH = 4;
+var SESSION_ACCEPT_LIMIT = 256 - 256 % SESSION_ALPHABET.length;
+var BASE64URL_ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_";
+var TOKEN_BYTES = 24;
+function randomChar(alphabet, acceptLimit) {
+  const buffer = new Uint8Array(1);
+  for (; ; ) {
+    globalThis.crypto.getRandomValues(buffer);
+    const byte = buffer[0];
+    if (byte !== void 0 && byte < acceptLimit) {
+      return alphabet.charAt(byte % alphabet.length);
+    }
+  }
+}
+function generateSessionCode() {
+  return Array.from({ length: SESSION_CODE_LENGTH }, () => randomChar(SESSION_ALPHABET, SESSION_ACCEPT_LIMIT)).join("");
+}
+function generateRealtimeToken() {
+  const bytes = new Uint8Array(TOKEN_BYTES);
+  globalThis.crypto.getRandomValues(bytes);
+  let token = "";
+  let acc = 0;
+  let bits = 0;
+  for (const byte of bytes) {
+    acc = acc << 8 | byte;
+    bits += 8;
+    while (bits >= 6) {
+      bits -= 6;
+      token += BASE64URL_ALPHABET.charAt(acc >>> bits & 63);
+    }
+  }
+  return token;
+}
+
+// src/api/client.ts
+var EvolutionApiError = class extends Error {
+  constructor(status, body, operation) {
+    super(`Evolution ${operation} falhou (${status})`);
+    this.status = status;
+    this.body = body;
+    this.name = "EvolutionApiError";
+  }
+  status;
+  body;
+};
+function readPath(json, ...path) {
+  let cur = json;
+  for (const key of path) {
+    if (!cur || typeof cur !== "object") return void 0;
+    cur = cur[key];
+  }
+  return cur;
+}
+function createEvolutionClient(cfg) {
+  const doFetch = cfg.fetchImpl ?? fetch;
+  const base = cfg.baseUrl.replace(/\/+$/, "");
+  const headers = { "content-type": "application/json", apikey: cfg.apiKey };
+  async function request(operation, method, path, body) {
+    const response = await doFetch(`${base}${path}`, {
+      method,
+      headers,
+      ...body === void 0 ? {} : { body: JSON.stringify(body) }
+    });
+    if (!response.ok) throw new EvolutionApiError(response.status, await response.text(), operation);
+    return response;
+  }
+  async function requestJson(operation, method, path, body) {
+    const response = await request(operation, method, path, body);
+    const text = await response.text();
+    let parsed;
+    try {
+      parsed = JSON.parse(text);
+    } catch {
+      throw new EvolutionApiError(response.status, text, operation);
+    }
+    if (!parsed || typeof parsed !== "object") throw new EvolutionApiError(response.status, text, operation);
+    return { operation, status: response.status, text, json: parsed };
+  }
+  function requireString(res, ...path) {
+    const value = readPath(res.json, ...path);
+    if (typeof value !== "string" || value === "") throw new EvolutionApiError(res.status, res.text, res.operation);
+    return value;
+  }
+  return {
+    async sendText(instance, number, text) {
+      const res = await requestJson("sendText", "POST", `/message/sendText/${instance}`, { number, text });
+      return { waMessageId: requireString(res, "key", "id") };
+    },
+    async createGroup(instance, subject, participants, description) {
+      const payload = description === void 0 ? { subject, participants } : { subject, participants, description };
+      const res = await requestJson("createGroup", "POST", `/group/create/${instance}`, payload);
+      const groupJid = readPath(res.json, "group", "id") ?? res.json.id;
+      if (typeof groupJid !== "string" || groupJid === "") {
+        throw new ChatError("Evolution createGroup: groupJid ausente/inv\xE1lido na resposta", "send_failed");
+      }
+      return { groupJid };
+    },
+    async leaveGroup(instance, groupJid) {
+      await request("leaveGroup", "DELETE", `/group/leave/${instance}`, { groupId: groupJid });
+    },
+    async getConnectionState(instance) {
+      const res = await requestJson("getConnectionState", "GET", `/instance/connectionState/${instance}`);
+      const state = readPath(res.json, "instance", "state");
+      if (state === "open" || state === "connecting" || state === "close") return state;
+      throw new EvolutionApiError(res.status, res.text, res.operation);
+    },
+    async connectQR(instance) {
+      const res = await requestJson("connectQR", "GET", `/instance/connect/${instance}`);
+      const base64 = readPath(res.json, "base64");
+      const pairingCode = readPath(res.json, "pairingCode");
+      const code = readPath(res.json, "code");
+      return {
+        qrBase64: typeof base64 === "string" ? base64 : null,
+        pairingCode: typeof pairingCode === "string" ? pairingCode : typeof code === "string" ? code : null
+      };
+    },
+    async setWebhook(instance, url, events) {
+      await request("setWebhook", "POST", `/webhook/set/${instance}`, {
+        webhook: { enabled: true, url, events, webhookByEvents: false, webhookBase64: false }
+      });
+    }
+  };
+}
+
+// src/api/webhook-parser.ts
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function textFromMessage(message) {
+  if (!isRecord(message)) return null;
+  const conversation = message["conversation"];
+  if (typeof conversation === "string") {
+    const trimmed = conversation.trim();
+    return trimmed.length > 0 ? trimmed : null;
+  }
+  const extended = message["extendedTextMessage"];
+  if (isRecord(extended)) {
+    const text = extended["text"];
+    if (typeof text === "string") {
+      const trimmed = text.trim();
+      return trimmed.length > 0 ? trimmed : null;
+    }
+  }
+  return null;
+}
+function timestampSeconds(value) {
+  const seconds = typeof value === "number" ? value : typeof value === "string" ? Number(value) : Number.NaN;
+  return Number.isFinite(seconds) ? Math.floor(seconds) : 0;
+}
+function parseMessageItem(item) {
+  if (!isRecord(item)) return { kind: "ignored", reason: "messages.upsert sem data v\xE1lido" };
+  const key = isRecord(item["key"]) ? item["key"] : null;
+  const waMessageId = key?.["id"];
+  const jid = key?.["remoteJid"];
+  if (typeof waMessageId !== "string" || waMessageId.length === 0) {
+    return { kind: "ignored", reason: "mensagem sem key.id" };
+  }
+  if (typeof jid !== "string" || jid.length === 0) {
+    return { kind: "ignored", reason: "mensagem sem key.remoteJid" };
+  }
+  const text = textFromMessage(item["message"]);
+  if (text === null) {
+    return { kind: "ignored", reason: "mensagem sem texto (conversation/extendedTextMessage)" };
+  }
+  const senderJid = key?.["participant"];
+  return {
+    kind: "message",
+    event: {
+      waMessageId,
+      jid,
+      fromMe: key?.["fromMe"] === true,
+      senderJid: typeof senderJid === "string" ? senderJid : null,
+      text,
+      timestamp: timestampSeconds(item["messageTimestamp"]),
+      raw: item
+    }
+  };
+}
+function parseWebhookEvent(payload) {
+  if (!isRecord(payload)) return { kind: "ignored", reason: "payload n\xE3o \xE9 um objeto" };
+  const event = payload["event"];
+  if (typeof event !== "string") return { kind: "ignored", reason: "payload sem campo event" };
+  const data = payload["data"];
+  if (event === "connection.update") {
+    const state = isRecord(data) ? data["state"] : void 0;
+    if (typeof state === "string" && state.length > 0) return { kind: "connection", state };
+    return { kind: "ignored", reason: "connection.update sem state" };
+  }
+  if (event !== "messages.upsert") {
+    return { kind: "ignored", reason: `evento n\xE3o tratado: ${event}` };
+  }
+  const items = Array.isArray(data) ? data : [data];
+  let lastIgnored = { kind: "ignored", reason: "messages.upsert sem data v\xE1lido" };
+  for (const item of items) {
+    const parsed = parseMessageItem(item);
+    if (parsed.kind !== "ignored") return parsed;
+    lastIgnored = parsed;
+  }
+  return lastIgnored;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  EvolutionApiError,
+  createEvolutionClient,
+  generateRealtimeToken,
+  generateSessionCode,
+  isValidPhone,
+  normalizePhone,
+  parseWebhookEvent,
+  toWhatsappJid
+});
+//# sourceMappingURL=index.cjs.map

package/api/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/api/index.ts","../src/errors.ts","../src/api/phone.ts","../src/api/ids.ts","../src/api/client.ts","../src/api/webhook-parser.ts"],"sourcesContent":["// src/api/index.ts — superfície pública do subpacote `evolution-chat/api`.\n//\n// Cliente HTTP tipado e framework-agnóstico da Evolution API v2. Auth por header\n// `apikey`. Sem dependências pesadas (fetch global). O erro de transporte\n// (EvolutionApiError) é exportado daqui para o painel distinguir evolution_error\n// de config_error.\n\nexport * from \"./phone\";\nexport * from \"./ids\";\nexport * from \"./client\";\nexport * from \"./webhook-parser\";\n\n// Tipos canônicos compartilhados (re-export para conveniência).\nexport type { InboundMessage } from \"../types\";\n","// src/errors.ts — erro de domínio canônico do SDK.\n//\n// ChatError carrega um `code` estável para mapear em HTTP nas rotas sem depender\n// de instanceof entre bundles (cada entry do tsup inline-iza a classe; usamos\n// `.code` para decidir o status). O erro de transporte da Evolution vive em\n// src/api/client.ts (EvolutionApiError), junto do cliente que o lança.\n\nexport type ChatErrorCode =\n  | \"invalid_input\"\n  | \"rate_limited\"\n  | \"group_create_failed\"\n  | \"send_failed\"\n  | \"session_not_found\"\n  | \"session_closed\"\n  | \"disabled\"\n  | \"unauthorized\"\n  | \"store_error\"\n  | \"webhook_invalid\";\n\nexport class ChatError extends Error {\n  public readonly code: ChatErrorCode;\n  public override readonly cause?: unknown;\n\n  constructor(message: string, code: ChatErrorCode, cause?: unknown) {\n    super(message);\n    this.name = \"ChatError\";\n    this.code = code;\n    this.cause = cause;\n  }\n}\n","import { ChatError } from \"../errors\";\n\nconst NON_DIGITS = /\\D+/g;\n\nexport function normalizePhone(raw: string, defaultDdi = \"55\"): string {\n  const digits = raw.replace(NON_DIGITS, \"\");\n  if (!digits) throw new ChatError(\"Telefone vazio\", \"invalid_input\");\n  // Prefixo \"+\" explícito (E.164) sinaliza DDI já presente — ex.: \"+1 415 555 2671\" permanece \"14155552671\".\n  const explicitDdi = raw.includes(\"+\");\n  const withDdi = digits.length <= 11 && !explicitDdi && !digits.startsWith(defaultDdi) ? defaultDdi + digits : digits;\n  if (withDdi.length < 10 || withDdi.length > 15) {\n    throw new ChatError(\"Telefone inválido\", \"invalid_input\");\n  }\n  return withDdi;\n}\nexport function isValidPhone(digits: string): boolean {\n  return digits.length >= 10 && digits.length <= 15;\n}\nexport function toWhatsappJid(phoneDigits: string): string {\n  return `${phoneDigits}@s.whatsapp.net`;\n}\n","// src/api/ids.ts — geração de ids com webcrypto (isomórfico, sem node:crypto).\n\nconst SESSION_ALPHABET = \"ABCDEFGHJKMNPQRSTUVWXYZ23456789\"; // sem 0/O/1/I\nconst SESSION_CODE_LENGTH = 4;\n// Rejection sampling: só aceita bytes < 248 (múltiplo de 31 ≤ 256), evitando viés de módulo.\nconst SESSION_ACCEPT_LIMIT = 256 - (256 % SESSION_ALPHABET.length);\n\nconst BASE64URL_ALPHABET = \"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_\";\nconst TOKEN_BYTES = 24; // 24 bytes → exatamente 32 caracteres base64url, sem padding\n\nfunction randomChar(alphabet: string, acceptLimit: number): string {\n  const buffer = new Uint8Array(1);\n  for (;;) {\n    globalThis.crypto.getRandomValues(buffer);\n    const byte = buffer[0];\n    if (byte !== undefined && byte < acceptLimit) {\n      return alphabet.charAt(byte % alphabet.length);\n    }\n  }\n}\n\nexport function generateSessionCode(): string {\n  return Array.from({ length: SESSION_CODE_LENGTH }, () => randomChar(SESSION_ALPHABET, SESSION_ACCEPT_LIMIT)).join(\"\");\n}\n\nexport function generateRealtimeToken(): string {\n  const bytes = new Uint8Array(TOKEN_BYTES);\n  globalThis.crypto.getRandomValues(bytes);\n  let token = \"\";\n  let acc = 0;\n  let bits = 0;\n  for (const byte of bytes) {\n    acc = (acc << 8) | byte;\n    bits += 8;\n    while (bits >= 6) {\n      bits -= 6;\n      token += BASE64URL_ALPHABET.charAt((acc >>> bits) & 0x3f);\n    }\n  }\n  return token;\n}\n","// src/api/client.ts — Adapter REST da Evolution API v2 (fetch injetável p/ testes).\nimport { ChatError } from \"../errors\";\n\nexport interface EvolutionFetch { (url: string, init: RequestInit): Promise<Response>; } // ponto de injeção (DI)\n\nexport interface SendTextResult { waMessageId: string; }\nexport interface CreateGroupResult { groupJid: string; }\n\nexport interface EvolutionClient {\n  sendText(instance: string, number: string, text: string): Promise<SendTextResult>;\n  createGroup(instance: string, subject: string, participants: string[], description?: string): Promise<CreateGroupResult>;\n  leaveGroup(instance: string, groupJid: string): Promise<void>;\n  getConnectionState(instance: string): Promise<\"open\" | \"connecting\" | \"close\">;\n  connectQR(instance: string): Promise<{ qrBase64: string | null; pairingCode: string | null }>;\n  setWebhook(instance: string, url: string, events: string[]): Promise<void>;\n}\n\nexport class EvolutionApiError extends Error {\n  constructor(readonly status: number, readonly body: string, operation: string) {\n    super(`Evolution ${operation} falhou (${status})`);\n    this.name = \"EvolutionApiError\";\n  }\n}\n\ninterface JsonOk { operation: string; status: number; text: string; json: Record<string, unknown>; }\n\n// Lê path aninhado (ex.: \"key\", \"id\") sem lançar: devolve undefined se faltar ou não for objeto.\nfunction readPath(json: Record<string, unknown>, ...path: string[]): unknown {\n  let cur: unknown = json;\n  for (const key of path) {\n    if (!cur || typeof cur !== \"object\") return undefined;\n    cur = (cur as Record<string, unknown>)[key];\n  }\n  return cur;\n}\n\nexport function createEvolutionClient(cfg: { baseUrl: string; apiKey: string; fetchImpl?: EvolutionFetch }): EvolutionClient {\n  const doFetch: EvolutionFetch = cfg.fetchImpl ?? fetch;\n  const base = cfg.baseUrl.replace(/\\/+$/, \"\"); // normaliza p/ evitar double slash na concatenação\n  const headers = { \"content-type\": \"application/json\", apikey: cfg.apiKey };\n\n  async function request(operation: string, method: string, path: string, body?: unknown): Promise<Response> {\n    const response = await doFetch(`${base}${path}`, {\n      method,\n      headers,\n      ...(body === undefined ? {} : { body: JSON.stringify(body) }),\n    });\n    if (!response.ok) throw new EvolutionApiError(response.status, await response.text(), operation);\n    return response;\n  }\n\n  // Contrato: toda falha de HTTP/parse/shape é EvolutionApiError (a ponte captura via instanceof).\n  async function requestJson(operation: string, method: string, path: string, body?: unknown): Promise<JsonOk> {\n    const response = await request(operation, method, path, body);\n    const text = await response.text();\n    let parsed: unknown;\n    try {\n      parsed = JSON.parse(text);\n    } catch {\n      throw new EvolutionApiError(response.status, text, operation);\n    }\n    if (!parsed || typeof parsed !== \"object\") throw new EvolutionApiError(response.status, text, operation);\n    return { operation, status: response.status, text, json: parsed as Record<string, unknown> };\n  }\n\n  function requireString(res: JsonOk, ...path: string[]): string {\n    const value = readPath(res.json, ...path);\n    if (typeof value !== \"string\" || value === \"\") throw new EvolutionApiError(res.status, res.text, res.operation);\n    return value;\n  }\n\n  return {\n    async sendText(instance, number, text) {\n      const res = await requestJson(\"sendText\", \"POST\", `/message/sendText/${instance}`, { number, text });\n      return { waMessageId: requireString(res, \"key\", \"id\") };\n    },\n\n    async createGroup(instance, subject, participants, description) {\n      const payload = description === undefined ? { subject, participants } : { subject, participants, description };\n      const res = await requestJson(\"createGroup\", \"POST\", `/group/create/${instance}`, payload);\n      const groupJid = readPath(res.json, \"group\", \"id\") ?? res.json.id; // mesmo derivador de antes, sem cast\n      if (typeof groupJid !== \"string\" || groupJid === \"\") {\n        throw new ChatError(\"Evolution createGroup: groupJid ausente/inválido na resposta\", \"send_failed\");\n      }\n      return { groupJid };\n    },\n\n    async leaveGroup(instance, groupJid) {\n      await request(\"leaveGroup\", \"DELETE\", `/group/leave/${instance}`, { groupId: groupJid });\n    },\n\n    async getConnectionState(instance) {\n      const res = await requestJson(\"getConnectionState\", \"GET\", `/instance/connectionState/${instance}`);\n      const state = readPath(res.json, \"instance\", \"state\");\n      if (state === \"open\" || state === \"connecting\" || state === \"close\") return state;\n      throw new EvolutionApiError(res.status, res.text, res.operation);\n    },\n\n    async connectQR(instance) {\n      const res = await requestJson(\"connectQR\", \"GET\", `/instance/connect/${instance}`);\n      const base64 = readPath(res.json, \"base64\");\n      const pairingCode = readPath(res.json, \"pairingCode\");\n      const code = readPath(res.json, \"code\");\n      return {\n        qrBase64: typeof base64 === \"string\" ? base64 : null,\n        pairingCode: typeof pairingCode === \"string\" ? pairingCode : typeof code === \"string\" ? code : null,\n      };\n    },\n\n    async setWebhook(instance, url, events) {\n      await request(\"setWebhook\", \"POST\", `/webhook/set/${instance}`, {\n        webhook: { enabled: true, url, events, webhookByEvents: false, webhookBase64: false },\n      });\n    },\n  };\n}\n","// src/api/webhook-parser.ts — normalização defensiva de webhooks da Evolution API v2.\n//\n// Contrato: parseWebhookEvent(payload: unknown): ParsedWebhook.\n// NUNCA lança exceção — qualquer payload inesperado/inválido vira { kind: \"ignored\", reason }.\n\nimport type { InboundMessage } from \"../types\";\n\nexport type ParsedWebhook =\n  | { kind: \"message\"; event: InboundMessage }\n  | { kind: \"connection\"; state: string }\n  | { kind: \"ignored\"; reason: string };\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n// Texto só sai de `conversation` ou `extendedTextMessage.text`; string vazia/só espaços → null.\nfunction textFromMessage(message: unknown): string | null {\n  if (!isRecord(message)) return null;\n  const conversation = message[\"conversation\"];\n  if (typeof conversation === \"string\") {\n    const trimmed = conversation.trim();\n    return trimmed.length > 0 ? trimmed : null;\n  }\n  const extended = message[\"extendedTextMessage\"];\n  if (isRecord(extended)) {\n    const text = extended[\"text\"];\n    if (typeof text === \"string\") {\n      const trimmed = text.trim();\n      return trimmed.length > 0 ? trimmed : null;\n    }\n  }\n  return null;\n}\n\n// messageTimestamp em segundos (aceita número ou string numérica; ausente/inválido → 0).\nfunction timestampSeconds(value: unknown): number {\n  const seconds = typeof value === \"number\" ? value : typeof value === \"string\" ? Number(value) : Number.NaN;\n  return Number.isFinite(seconds) ? Math.floor(seconds) : 0;\n}\n\nfunction parseMessageItem(item: unknown): ParsedWebhook {\n  if (!isRecord(item)) return { kind: \"ignored\", reason: \"messages.upsert sem data válido\" };\n\n  const key = isRecord(item[\"key\"]) ? item[\"key\"] : null;\n  const waMessageId = key?.[\"id\"];\n  const jid = key?.[\"remoteJid\"];\n  if (typeof waMessageId !== \"string\" || waMessageId.length === 0) {\n    return { kind: \"ignored\", reason: \"mensagem sem key.id\" };\n  }\n  if (typeof jid !== \"string\" || jid.length === 0) {\n    return { kind: \"ignored\", reason: \"mensagem sem key.remoteJid\" };\n  }\n\n  const text = textFromMessage(item[\"message\"]);\n  if (text === null) {\n    return { kind: \"ignored\", reason: \"mensagem sem texto (conversation/extendedTextMessage)\" };\n  }\n\n  const senderJid = key?.[\"participant\"];\n  return {\n    kind: \"message\",\n    event: {\n      waMessageId,\n      jid,\n      fromMe: key?.[\"fromMe\"] === true,\n      senderJid: typeof senderJid === \"string\" ? senderJid : null,\n      text,\n      timestamp: timestampSeconds(item[\"messageTimestamp\"]),\n      raw: item,\n    },\n  };\n}\n\nexport function parseWebhookEvent(payload: unknown): ParsedWebhook {\n  if (!isRecord(payload)) return { kind: \"ignored\", reason: \"payload não é um objeto\" };\n\n  const event = payload[\"event\"];\n  if (typeof event !== \"string\") return { kind: \"ignored\", reason: \"payload sem campo event\" };\n\n  const data = payload[\"data\"];\n\n  if (event === \"connection.update\") {\n    const state = isRecord(data) ? data[\"state\"] : undefined;\n    if (typeof state === \"string\" && state.length > 0) return { kind: \"connection\", state };\n    return { kind: \"ignored\", reason: \"connection.update sem state\" };\n  }\n\n  if (event !== \"messages.upsert\") {\n    return { kind: \"ignored\", reason: `evento não tratado: ${event}` };\n  }\n\n  // Evolution v2 pode mandar `data` como objeto único ou array de mensagens (queue-flush/bulk).\n  // Contrato de evento único: devolve o PRIMEIRO item válido, não `items[0]` — senão um item\n  // nulo/inválido na frente descartaria silenciosamente as mensagens válidas seguintes.\n  const items: readonly unknown[] = Array.isArray(data) ? data : [data];\n  let lastIgnored: ParsedWebhook = { kind: \"ignored\", reason: \"messages.upsert sem data válido\" };\n  for (const item of items) {\n    const parsed = parseMessageItem(item);\n    if (parsed.kind !== \"ignored\") return parsed;\n    lastIgnored = parsed;\n  }\n  return lastIgnored;\n}\n"],"mappings":"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","names":[]}

package/api/index.d.cts

@@ -0,0 +1,65 @@
+declare function normalizePhone(raw: string, defaultDdi?: string): string;
+declare function isValidPhone(digits: string): boolean;
+declare function toWhatsappJid(phoneDigits: string): string;
+
+declare function generateSessionCode(): string;
+declare function generateRealtimeToken(): string;
+
+interface EvolutionFetch {
+    (url: string, init: RequestInit): Promise<Response>;
+}
+interface SendTextResult {
+    waMessageId: string;
+}
+interface CreateGroupResult {
+    groupJid: string;
+}
+interface EvolutionClient {
+    sendText(instance: string, number: string, text: string): Promise<SendTextResult>;
+    createGroup(instance: string, subject: string, participants: string[], description?: string): Promise<CreateGroupResult>;
+    leaveGroup(instance: string, groupJid: string): Promise<void>;
+    getConnectionState(instance: string): Promise<"open" | "connecting" | "close">;
+    connectQR(instance: string): Promise<{
+        qrBase64: string | null;
+        pairingCode: string | null;
+    }>;
+    setWebhook(instance: string, url: string, events: string[]): Promise<void>;
+}
+declare class EvolutionApiError extends Error {
+    readonly status: number;
+    readonly body: string;
+    constructor(status: number, body: string, operation: string);
+}
+declare function createEvolutionClient(cfg: {
+    baseUrl: string;
+    apiKey: string;
+    fetchImpl?: EvolutionFetch;
+}): EvolutionClient;
+
+/**
+ * Mensagem de entrada normalizada do webhook da Evolution, independente do
+ * formato bruto do payload.
+ */
+interface InboundMessage {
+    waMessageId: string;
+    jid: string;
+    fromMe: boolean;
+    senderJid: string | null;
+    text: string | null;
+    timestamp: number;
+    raw: unknown;
+}
+
+type ParsedWebhook = {
+    kind: "message";
+    event: InboundMessage;
+} | {
+    kind: "connection";
+    state: string;
+} | {
+    kind: "ignored";
+    reason: string;
+};
+declare function parseWebhookEvent(payload: unknown): ParsedWebhook;
+
+export { type CreateGroupResult, EvolutionApiError, type EvolutionClient, type EvolutionFetch, type InboundMessage, type ParsedWebhook, type SendTextResult, createEvolutionClient, generateRealtimeToken, generateSessionCode, isValidPhone, normalizePhone, parseWebhookEvent, toWhatsappJid };

package/api/index.d.ts

@@ -0,0 +1,65 @@
+declare function normalizePhone(raw: string, defaultDdi?: string): string;
+declare function isValidPhone(digits: string): boolean;
+declare function toWhatsappJid(phoneDigits: string): string;
+
+declare function generateSessionCode(): string;
+declare function generateRealtimeToken(): string;
+
+interface EvolutionFetch {
+    (url: string, init: RequestInit): Promise<Response>;
+}
+interface SendTextResult {
+    waMessageId: string;
+}
+interface CreateGroupResult {
+    groupJid: string;
+}
+interface EvolutionClient {
+    sendText(instance: string, number: string, text: string): Promise<SendTextResult>;
+    createGroup(instance: string, subject: string, participants: string[], description?: string): Promise<CreateGroupResult>;
+    leaveGroup(instance: string, groupJid: string): Promise<void>;
+    getConnectionState(instance: string): Promise<"open" | "connecting" | "close">;
+    connectQR(instance: string): Promise<{
+        qrBase64: string | null;
+        pairingCode: string | null;
+    }>;
+    setWebhook(instance: string, url: string, events: string[]): Promise<void>;
+}
+declare class EvolutionApiError extends Error {
+    readonly status: number;
+    readonly body: string;
+    constructor(status: number, body: string, operation: string);
+}
+declare function createEvolutionClient(cfg: {
+    baseUrl: string;
+    apiKey: string;
+    fetchImpl?: EvolutionFetch;
+}): EvolutionClient;
+
+/**
+ * Mensagem de entrada normalizada do webhook da Evolution, independente do
+ * formato bruto do payload.
+ */
+interface InboundMessage {
+    waMessageId: string;
+    jid: string;
+    fromMe: boolean;
+    senderJid: string | null;
+    text: string | null;
+    timestamp: number;
+    raw: unknown;
+}
+
+type ParsedWebhook = {
+    kind: "message";
+    event: InboundMessage;
+} | {
+    kind: "connection";
+    state: string;
+} | {
+    kind: "ignored";
+    reason: string;
+};
+declare function parseWebhookEvent(payload: unknown): ParsedWebhook;
+
+export { type CreateGroupResult, EvolutionApiError, type EvolutionClient, type EvolutionFetch, type InboundMessage, type ParsedWebhook, type SendTextResult, createEvolutionClient, generateRealtimeToken, generateSessionCode, isValidPhone, normalizePhone, parseWebhookEvent, toWhatsappJid };