@openvertice/bot-sdk 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,199 @@
-# Temporary Holding Version
+# `@openvertice/bot-sdk`
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Escreva um bot para o Vértice: ele entra num canal de texto, responde a
+comandos e — quando você quiser — entra na sala de voz como mais um par da
+malha, publicando áudio de verdade.
+
+O contrato do servidor (versão `2026-10`) vive em `server/bots/README.md`, no
+repositório do Vértice. Este pacote é um cliente desse contrato, não uma segunda
+verdade: se os dois discordarem, o servidor está certo.
+
+## Instalar
+
+```bash
+npm i @openvertice/bot-sdk                  # texto
+npm i @openvertice/bot-sdk @roamhq/wrtc     # texto + voz
+```
+
+Node **22 ou mais novo**. Para texto, o SDK não tem dependência nenhuma: usa o
+`WebSocket` e o `fetch` do próprio Node. `@roamhq/wrtc` é opcional e só é
+carregado quando alguém usa voz (no Node 24 ele vem com binário pronto —
+verificado: ABI 137, sem compilar nada).
+
+## Criar o bot
+
+1. Abra o painel administrativo (`VERTICE_ADMIN_PORT` + `VERTICE_ADMIN_SENHA`).
+2. Aba **Bots** → dê um nome, marque os canais de texto (com `escutar`/`falar`)
+   e os de voz.
+3. Copie o token `vtb_…` **na hora**: ele aparece uma única vez.
+4. Guarde no `.env` da raiz do pacote (`cp .env.example .env`) — os exemplos
+   leem de lá. Rodar `npm run eco` com o token só no arquivo funciona.
+
+Se você não quer manter um processo rodando, o painel também gera um **webhook**
+(`POST /api/bots/webhook/<segredo>?canal=CODE`, corpo = texto): serve para
+publicar em nome do bot a partir de outro sistema. É credencial separada do
+token.
+
+## Texto
+
+```ts
+import { Bot } from "@openvertice/bot-sdk";
+
+const bot = new Bot({
+  token: process.env.VERTICE_BOT_TOKEN!,
+  baseUrl: "http://localhost:8080",
+  intents: ["MESSAGES"],
+});
+
+bot.on("message.created", (m) => {
+  if (m.autorBot) return; // sem isso o bot conversa consigo mesmo
+  console.log(`${m.autor}: ${m.texto}`);
+});
+
+bot.command("ping", { descricao: "responde pong" }, async ({ responder }) => {
+  await responder("pong");
+});
+
+await bot.start();
+```
+
+- `bot.on(evento, fn)` — `ready`, `message.created`, `message.deleted`,
+  `mention`, `voice.joined`, `voice.left`, `voice.signal`,
+  `voice.peer.joined`, `voice.peer.left`, `error`.
+- `bot.command(nome, fn)` / `bot.command(nome, { descricao, canais }, fn)` — o
+  prefixo (`!`) é do canal, não do comando. O bot **não** executa os próprios
+  comandos.
+- Os comandos registrados são anunciados no `identify`: o cliente completa
+  `!to` → `!tocar` no compositor, com a descrição ao lado. Registrar depois de
+  `start()` também aparece — sem reconectar (`bot.comandos` é a lista viva).
+- `await bot.enviar("MURAL", "oi")` — devolve o item criado (id, horário).
+- `await bot.enviarVoz("MURAL", wav)` — manda áudio como **mensagem de voz**;
+  `enviarArquivo(canal, bytes, { nome, mime })` faz o mesmo como anexo comum.
+- `await bot.historico("MURAL", antesDe?)` e `bot.apagar("MURAL", id)`.
+- `bot.agir(tipo, dados)` — ação crua no gateway (a voz usa por baixo).
+
+O SDK cuida do que ninguém quer escrever duas vezes: troca o token por sessão,
+renova antes de vencer, manda batimento, retoma com `resume` e reconecta com
+espera crescente. Falhas transitórias — servidor fora, rede caindo, sessão que
+não pôde ser renovada — são tentadas **indefinidamente** (espera de 1 s até
+30 s); desistir só acontece nos casos definitivos abaixo. Token girado, bot
+desativado ou outra conexão assumindo o mesmo bot **não** reconectam:
+`bot.estado` vira `recusado` e o erro fica em `bot.ultimoErro`.
+
+## Mensagem de voz (áudio no chat)
+
+```ts
+import { Bot, wavDeTom } from "@openvertice/bot-sdk";
+
+const wav = wavDeTom({ segundos: 1, frequencia: 440 }); // Uint8Array PCM 16 bits
+const mensagem = await bot.enviarVoz("MURAL", wav, { nome: "recado.wav" });
+mensagem.tipo;            // "voz"
+mensagem.arquivo?.url;    // /chat/arquivos/<id>?exp=…&sig=… (pronta para <audio>)
+```
+
+O corpo vai cru, com o tipo no cabeçalho — não há multipart. Para um arquivo
+que não seja voz, use `enviarArquivo` (sem `X-Vertice-Tipo`). O limite é o do
+chat (`VERTICE_CHAT_MAX_MB`) e a rajada de 30 mensagens por minuto vale igual.
+
+## Ser chamado com `@`
+
+```ts
+bot.on("mention", async (m) => {
+  if (m.autorBot) return;
+  await bot.enviar(m.sala!, `oi, ${m.autor}!`);
+});
+```
+
+`mention` chega quando alguém escreve `@login` ou `@nome de exibição` (sem
+caixa nem acento) e o bot tem o canal com `escutar`. Ele **atravessa o prefixo**
+do canal — é o que deixa chamar o bot numa sala de comandos (`!`) sem que ele
+leia a conversa toda. Em canal sem prefixo, `mention` vem junto com
+`message.created` (mesmo `id`): trate como aviso, não como segunda mensagem.
+
+## Voz
+
+```ts
+import { Bot, Voz, criarTransporteWrtc, tocarTom } from "@openvertice/bot-sdk";
+
+const bot = new Bot({ token, intents: ["MESSAGES"] });
+await bot.start();
+
+const transporte = await criarTransporteWrtc();
+// A track sai da fonte que você alimenta; sem `track` a `Voz` cria outra fonte
+// e o bot publica silêncio.
+const fonte = transporte.criarFonteDeAudio();
+const voz = new Voz(bot, { transporte, track: fonte.createTrack() });
+const parar = tocarTom({ fonte, frequencia: 440 });
+
+await voz.entrar("PATIO");   // resolve no `voice.joined`
+voz.sair();
+parar();
+```
+
+O bot entra **só quando pede** — `start()` nunca entra na voz. O layout dos
+transceivers é o mesmo dos clientes (`audio[0]` = microfone, `audio[1]` = som da
+transmissão, `video[0]` = tela) e a oferta cruzada é resolvida pelo id, como nos
+dois lados. `aoReceberTrack` recebe o áudio dos outros pares, se você quiser
+monitorar ou gravar.
+
+`@roamhq/wrtc` exige blocos de **480 amostras** em 48 kHz (10 ms) no
+`RTCAudioSource` — é o que `tocarTom` faz; lendo arquivo, respeite o mesmo
+tamanho.
+
+## Exemplos
+
+```bash
+npm run build
+cp .env.example .env        # e edite o VERTICE_BOT_TOKEN
+npm run eco                 # repete e responde !ping
+npm run radio               # !entrar toca um tom na voz
+npm run recado              # !recado manda áudio no chat
+```
+
+Os exemplos carregam o `.env` da raiz do pacote na partida (com o leitor nativo
+do Node — nada de `dotenv`). Variável do ambiente ganha do arquivo, então
+`VERTICE_BOT_TOKEN=vtb_… npm run eco` também funciona — e é o que vale se você
+rodar `node dist/exemplos/eco.js` de outro diretório.
+
+## Testes
+
+A reconexão do gateway tem teste próprio, **sem servidor** (usa um `WebSocket`
+falso e o `dist/` compilado):
+
+```bash
+npm run build && node testes/gateway-reconexao.mjs   # backoff, recusa, queda e fechar()
+```
+
+Os testes de fumaça sobem o servidor de verdade (precisa do repositório do
+Vértice ao lado):
+
+```bash
+node testes/fumaca.mjs        # dois bots: comando, histórico, apagar, eventos
+node testes/voz.mjs           # dois bots na voz: ICE + DTLS fechados, track recebida
+node testes/voz-cliente.mjs   # bot ↔ cliente do navegador: SDP nos dois nomes e áudio
+# (o fumaca.mjs também manda um recado de voz e baixa o áudio de volta)
+```
+
+## Limites (do servidor, não do SDK)
+
+- 30 mensagens por minuto por bot; 1 sessão por minuto (o SDK só pede outra
+  quando a atual está para vencer).
+- O bot só vê os canais marcados no painel e, com prefixo, só o que começa por
+  ele.
+- Bot não é conta: não aparece na gestão de membros, não recebe cargo e não
+  apaga mensagem de outra pessoa.
+
+## Publicar no npm
+
+O pacote vai para o escopo `@openvertice` como **público** (`publishConfig.access`):
+
+```bash
+npm login                 # conta com acesso à org @openvertice
+npm run build             # o `prepack` também compila durante o publish
+npm pack --dry-run        # confere exatamente o que entra no tarball
+npm publish               # @openvertice/bot-sdk@<versão>
+```
+
+O tarball leva `dist/src` (JS + `.d.ts`), `src` (para os source maps) e este
+README. Testes, exemplos, `.env` e `node_modules` ficam de fora. Para publicar
+uma versão nova: `npm version patch|minor|major` e `npm publish`.

package/dist/src/audio.d.ts

@@ -0,0 +1,32 @@
+import type { FonteDeAudio } from "./voz.js";
+/** Everything `tocarTom` needs in order to publish a sine wave. */
+export interface OpcoesDoTom {
+    /** The transport source (`transporte.criarFonteDeAudio()`). */
+    fonte: FonteDeAudio;
+    /** Frequency in Hz. 440 is concert A. */
+    frequencia?: number;
+    /** 0…1. Anything above 0.5 starts to clip and distort. */
+    amplitude?: number;
+    /** 48 kHz: wrtc requires blocks of 480 samples. */
+    sampleRate?: number;
+}
+/**
+ * Starts playing the tone on the given source.
+ *
+ * Keep the returned stop function for as long as the bot stays in the room:
+ * stopping mid-flight leaves the peer with silence, not with an error — which
+ * is exactly what a bot that stops speaking should do.
+ *
+ * @param options Tone parameters; every field has a sensible default.
+ * @returns A function that stops the tone and clears its timer.
+ *
+ * @example
+ * ```ts
+ * const fonte = transporte.criarFonteDeAudio();
+ * const parar = tocarTom({ fonte, frequencia: 440, amplitude: 0.15 });
+ * // …later, on shutdown:
+ * parar();
+ * ```
+ */
+export declare function tocarTom({ fonte, frequencia, amplitude, sampleRate, }: OpcoesDoTom): () => void;
+//# sourceMappingURL=audio.d.ts.map

package/dist/src/audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../src/audio.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAmB7C,mEAAmE;AACnE,MAAM,WAAW,WAAW;IAC1B,+DAA+D;IAC/D,KAAK,EAAE,YAAY,CAAC;IACpB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EACL,UAAgB,EAChB,SAAe,EACf,UAAmB,GACpB,EAAE,WAAW,GAAG,MAAM,IAAI,CA2B1B"}

package/dist/src/audio.js

@@ -0,0 +1,47 @@
+/**
+ * Starts playing the tone on the given source.
+ *
+ * Keep the returned stop function for as long as the bot stays in the room:
+ * stopping mid-flight leaves the peer with silence, not with an error — which
+ * is exactly what a bot that stops speaking should do.
+ *
+ * @param options Tone parameters; every field has a sensible default.
+ * @returns A function that stops the tone and clears its timer.
+ *
+ * @example
+ * ```ts
+ * const fonte = transporte.criarFonteDeAudio();
+ * const parar = tocarTom({ fonte, frequencia: 440, amplitude: 0.15 });
+ * // …later, on shutdown:
+ * parar();
+ * ```
+ */
+export function tocarTom({ fonte, frequencia = 440, amplitude = 0.2, sampleRate = 48_000, }) {
+    const comDados = fonte;
+    // 10 ms per block: it is the frame size of wrtc's RTCAudioSource.
+    const quadros = Math.round(sampleRate / 100);
+    const passo = (2 * Math.PI * frequencia) / sampleRate;
+    const limite = Math.max(0, Math.min(1, amplitude)) * 0x7fff;
+    let fase = 0;
+    const timer = setInterval(() => {
+        const amostras = new Int16Array(quadros);
+        for (let i = 0; i < quadros; i += 1) {
+            amostras[i] = Math.round(Math.sin(fase) * limite);
+            fase += passo;
+            if (fase > 2 * Math.PI)
+                fase -= 2 * Math.PI;
+        }
+        comDados.onData({
+            samples: amostras,
+            sampleRate,
+            bitsPerSample: 16,
+            channelCount: 1,
+            numberOfFrames: quadros,
+        });
+    }, 10);
+    // Without `unref` the process would not exit while the tone plays — and the
+    // bot must be able to leave the room and still shut down cleanly.
+    timer.unref?.();
+    return () => clearInterval(timer);
+}
+//# sourceMappingURL=audio.js.map

package/dist/src/audio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.js","sourceRoot":"","sources":["../../src/audio.ts"],"names":[],"mappings":"AAqCA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,QAAQ,CAAC,EACvB,KAAK,EACL,UAAU,GAAG,GAAG,EAChB,SAAS,GAAG,GAAG,EACf,UAAU,GAAG,MAAM,GACP;IACZ,MAAM,QAAQ,GAAG,KAAsB,CAAC;IACxC,kEAAkE;IAClE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,UAAU,CAAC,GAAG,UAAU,CAAC;IACtD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,GAAG,MAAM,CAAC;IAC5D,IAAI,IAAI,GAAG,CAAC,CAAC;IAEb,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,MAAM,QAAQ,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;QACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;YAClD,IAAI,IAAI,KAAK,CAAC;YACd,IAAI,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE;gBAAE,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;QAC9C,CAAC;QACD,QAAQ,CAAC,MAAM,CAAC;YACd,OAAO,EAAE,QAAQ;YACjB,UAAU;YACV,aAAa,EAAE,EAAE;YACjB,YAAY,EAAE,CAAC;YACf,cAAc,EAAE,OAAO;SACxB,CAAC,CAAC;IACL,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,4EAA4E;IAC5E,kEAAkE;IAClE,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;IAChB,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC"}

package/dist/src/cliente.d.ts

@@ -0,0 +1,213 @@
+import { ErroDaApi } from "./http.js";
+import { type EstadoDoGateway } from "./gateway.js";
+import type { CanalDeTexto, Descoberta, ServidorIce, Eventos, Intencao, Mensagem } from "./tipos.js";
+/** Everything needed to build a {@link Bot}. */
+export interface OpcoesDoBot {
+    /** Bot token (`vtb_…`), copied from the admin panel (Bots tab). */
+    token: string;
+    /** Server base URL. Default: `http://localhost:8080`. */
+    baseUrl?: string;
+    /** Intents this process wants; the server refuses whatever the panel did not grant. */
+    intents?: Intencao[];
+    /** Diagnostics: one line per state change. */
+    log?: (mensagem: string) => void;
+}
+/** What a command handler receives on every invocation. */
+export interface ContextoDoComando {
+    /** The message that triggered the command. */
+    mensagem: Mensagem;
+    /** The channel where the command was typed, with its settings. */
+    canal: CanalDeTexto;
+    /** `!tocar a.mp3` → `["a.mp3"]` (already split on whitespace). */
+    args: string[];
+    /** Everything typed after the command name, as-is. */
+    resto: string;
+    /** Replies in the same channel. */
+    responder(texto: string): Promise<Mensagem>;
+    /** Deletes the triggering message — only works when the bot wrote it. */
+    apagar(): Promise<void>;
+}
+/** Handler signature for one gateway event. */
+type Ouvinte<K extends keyof Eventos> = (dados: Eventos[K]) => void | Promise<void>;
+/**
+ * A Vértice bot.
+ *
+ * Create one, register listeners with {@link on} and commands with
+ * {@link command}, then call {@link start}. Sessions, heartbeats, `resume` and
+ * reconnection are handled internally, so the author only has to react to
+ * events.
+ *
+ * @example
+ * ```ts
+ * const bot = new Bot({ token: process.env.VERTICE_BOT_TOKEN! });
+ *
+ * bot.command("ping", { descricao: "responde pong" }, async ({ responder }) => {
+ *   await responder("pong");
+ * });
+ *
+ * await bot.start();
+ * ```
+ */
+export declare class Bot {
+    #private;
+    /** @param opcoes Token, base URL and the intents this process wants. */
+    constructor(opcoes: OpcoesDoBot);
+    /** Identity the server assigned, or `null` before {@link start}. */
+    get bot(): Descoberta["bot"] | null;
+    /** Channels granted to the bot, or `null` before {@link start}. */
+    get canais(): Descoberta["canais"] | null;
+    /** ICE servers from discovery (the bot's voice uses the same ones). */
+    get iceServers(): ServidorIce[];
+    /** Current gateway state, or `"parado"` before {@link start} and after {@link stop}. */
+    get estado(): EstadoDoGateway | "parado";
+    /**
+     * Registers a listener for every gateway state change.
+     *
+     * Voice uses it to leave the room when the connection drops: `resume` brings
+     * the events back, but not the seat in the voice room.
+     *
+     * @param ouvinte Called with the new state.
+     * @returns This bot, for chaining.
+     */
+    aoMudarEstado(ouvinte: (estado: EstadoDoGateway) => void): this;
+    /** Last connection error, for callers that want to show it in a `/status` command. */
+    get ultimoErro(): Error | null;
+    /**
+     * Discovers what the bot may do, opens a session and connects the gateway.
+     *
+     * @returns This bot, once the gateway reports `ready`.
+     * @throws {ErroDaApi} When discovery or session creation fails.
+     * @throws {Error} When the server refuses the bot.
+     */
+    start(): Promise<this>;
+    /**
+     * Sends a raw gateway action (voice uses it to join, leave and signal).
+     *
+     * @param tipo Action name understood by the server.
+     * @param dados Action payload.
+     * @throws {Error} When `start()` has not been called yet.
+     */
+    agir(tipo: string, dados?: Record<string, unknown>): void;
+    /** Closes the gateway for good and forgets the session. */
+    stop(): Promise<void>;
+    /**
+     * Subscribes to a gateway event (`message.created`, `voice.joined`, …).
+     *
+     * @param nome Event name.
+     * @param ouvinte Handler; it may be async. Failures are logged, never thrown.
+     * @returns This bot, for chaining.
+     */
+    on<K extends keyof Eventos>(nome: K, ouvinte: Ouvinte<K>): this;
+    /**
+     * Removes a listener previously registered with {@link on}.
+     *
+     * @param nome Event name.
+     * @param ouvinte The exact handler reference that was registered.
+     * @returns This bot, for chaining.
+     */
+    off<K extends keyof Eventos>(nome: K, ouvinte: Ouvinte<K>): this;
+    /**
+     * Registers a command.
+     *
+     * The channel prefix (`!`) belongs to the server: here the name is just
+     * `tocar`. Without `canais`, the command works in every channel where the bot
+     * may speak. Every registered command is announced to the client's
+     * autocomplete, including ones registered after `start()`.
+     *
+     * @param nome Command name; a leading `!` or `/` is stripped.
+     * @param opcoesOuFn Either the options object or the handler itself.
+     * @param talvezFn Handler, when the second argument carries the options.
+     * @returns This bot, for chaining.
+     * @throws {Error} When no handler is provided.
+     *
+     * @example
+     * ```ts
+     * bot.command("ping", async ({ responder }) => {
+     *   await responder("pong");
+     * });
+     *
+     * bot.command("eco", { descricao: "repete o texto" }, async ({ resto, responder }) => {
+     *   await responder(resto);
+     * });
+     * ```
+     */
+    command(nome: string, opcoesOuFn: {
+        descricao?: string;
+        canais?: string[];
+    } | ((contexto: ContextoDoComando) => void | Promise<void>), talvezFn?: (contexto: ContextoDoComando) => void | Promise<void>): this;
+    /** Registered commands, in registration order (handy in a `!help` command). */
+    get comandos(): {
+        nome: string;
+        descricao?: string;
+    }[];
+    /**
+     * Sends a text message.
+     *
+     * It goes over HTTP on purpose: the response carries the created item (id,
+     * timestamp), and the gateway delivers `message.created` to everyone anyway.
+     *
+     * @param canal Channel code (case-insensitive; uppercased before sending).
+     * @param texto Message content.
+     * @returns The message the server created.
+     * @throws {ErroDaApi} When the bot cannot post in the channel.
+     */
+    enviar(canal: string, texto: string): Promise<Mensagem>;
+    /**
+     * Sends audio as a **voice message** — the item the client renders as a
+     * "voice message" and plays inline.
+     *
+     * @param canal Channel code.
+     * @param audio The audio bytes (WAV by default; see `wavDeTom`).
+     * @param opcoes File name and MIME type; defaults to `recado.wav` / `audio/wav`.
+     * @returns The message the server created.
+     * @throws {ErroDaApi} When the upload fails.
+     */
+    enviarVoz(canal: string, audio: Uint8Array, opcoes?: {
+        nome?: string;
+        mime?: string;
+    }): Promise<Mensagem>;
+    /**
+     * Sends any other file (image, PDF, audio as a regular attachment).
+     *
+     * @param canal Channel code.
+     * @param conteudo File bytes.
+     * @param opcoes File name and MIME type; defaults to `arquivo` /
+     * `application/octet-stream`.
+     * @returns The message the server created.
+     * @throws {ErroDaApi} When the upload fails.
+     */
+    enviarArquivo(canal: string, conteudo: Uint8Array, opcoes?: {
+        nome?: string;
+        mime?: string;
+    }): Promise<Mensagem>;
+    /**
+     * Reads a page of history (100 items; `antesDe` pages backwards).
+     *
+     * @param canal Channel code.
+     * @param antesDe Timestamp cursor: returns messages older than this one.
+     * @returns The page, plus `temMais` telling whether another page exists.
+     * @throws {ErroDaApi} When the bot cannot read the channel.
+     */
+    historico(canal: string, antesDe?: number): Promise<{
+        sala: string;
+        mensagens: Mensagem[];
+        temMais: boolean;
+    }>;
+    /**
+     * Deletes a message the bot wrote.
+     *
+     * @param canal Channel code.
+     * @param id Message id.
+     * @throws {ErroDaApi} When the message is not the bot's or is already gone.
+     */
+    apagar(canal: string, id: string): Promise<void>;
+    /**
+     * Re-runs only the discovery step (e.g. after changing channels in the panel).
+     *
+     * @returns The fresh discovery document.
+     * @throws {ErroDaApi} When the token is rejected.
+     */
+    recarregar(): Promise<Descoberta>;
+}
+export { ErroDaApi };
+//# sourceMappingURL=cliente.d.ts.map

package/dist/src/cliente.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliente.d.ts","sourceRoot":"","sources":["../../src/cliente.ts"],"names":[],"mappings":"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"}