@openvertice/bot-sdk 0.0.0-stage → 0.1.0

package/dist/src/gateway.js

@@ -0,0 +1,299 @@
+/** `WebSocket.readyState` for an open socket. */
+const ABERTO = 1;
+/** How long without any server frame before the connection is assumed dead. */
+const SEM_SINAL_MS = 90_000;
+/** Codes where retrying is pointless: the server refused the bot. */
+const DEFINITIVOS = new Set([4001, 4003, 4005]);
+/** Another connection took over this bot: reconnecting would fight over it. */
+const OUTRA_CONEXAO = 4000;
+/** Session closed (rotated token, disabled bot): it does not come back on its own. */
+const SESSAO_ENCERRADA = 4009;
+/** Expired session: renew the token and come back. */
+const SESSAO_EXPIRADA = 4002;
+/**
+ * WebSocket client for the Vértice gateway.
+ *
+ * It speaks the `{op, t, d, s}` envelope: op 10 `hello`, op 2 `identify` (or
+ * op 6 `resume`), op 1 heartbeat, op 11 heartbeat ack, op 0 dispatch and op 4
+ * action. Heartbeat, session resume and reconnection with exponential backoff
+ * are handled here, so bot authors never have to.
+ *
+ * One instance per bot: `conectar()` resolves only after `ready` arrives.
+ */
+export class Gateway {
+    opcoes;
+    #ws = null;
+    #sessao = null;
+    #seq = 0;
+    #batida = null;
+    #vigia = null;
+    #recuo = null;
+    #tentativa = 0;
+    #encerrado = false;
+    #estado = "conectando";
+    /** @param opcoes Endpoints, credentials and hooks used by the connection. */
+    constructor(opcoes) {
+        this.opcoes = opcoes;
+    }
+    /** Current connection state. */
+    get estado() {
+        return this.#estado;
+    }
+    /** Session in use, or `null` before the first connection attempt. */
+    get sessaoAtual() {
+        return this.#sessao;
+    }
+    /**
+     * Opens the socket and resolves once the bot is identified (`ready`).
+     *
+     * @returns A promise that settles when the gateway is truly ready.
+     * @throws {Error} When the server refuses the bot or the socket cannot open.
+     */
+    conectar() {
+        this.#encerrado = false;
+        return this.#abrir();
+    }
+    /**
+     * Opens one socket attempt.
+     *
+     * Resolves on the first dispatched event — in practice `ready` — and rejects
+     * if the socket fails before that.
+     */
+    async #abrir() {
+        this.#mudar("conectando");
+        const sessao = await this.opcoes.sessao();
+        this.#sessao = sessao;
+        return new Promise((resolver, rejeitar) => {
+            let concluido = false;
+            const falhar = (erro) => {
+                if (concluido)
+                    return;
+                concluido = true;
+                rejeitar(erro);
+            };
+            let ws;
+            try {
+                ws = new WebSocket(this.opcoes.url);
+            }
+            catch (erro) {
+                falhar(erro instanceof Error ? erro : new Error(String(erro)));
+                return;
+            }
+            this.#ws = ws;
+            ws.addEventListener("error", () => falhar(new Error("não consegui abrir o gateway")));
+            ws.addEventListener("message", (evento) => {
+                const envelope = this.#ler(evento);
+                if (!envelope)
+                    return;
+                this.#armarVigia();
+                // hello: now it is safe to identify (or to resume, if a seq exists).
+                if (envelope.op === 10) {
+                    this.#identificar(ws, sessao);
+                    return;
+                }
+                this.#receber(envelope, () => {
+                    if (concluido)
+                        return;
+                    concluido = true;
+                    resolver();
+                });
+            });
+            ws.addEventListener("close", (evento) => {
+                this.#aoFechar(evento.code, evento.reason);
+                if (this.#encerrado)
+                    falhar(new Error("gateway encerrado"));
+            });
+        });
+    }
+    /**
+     * Sends `identify` (op 2) on a fresh connection, or `resume` (op 6) when a
+     * sequence number from a previous connection is available.
+     *
+     * @param ws Socket already past `hello`.
+     * @param sessao Session to present to the server.
+     */
+    #identificar(ws, sessao) {
+        const comandos = this.opcoes.comandos ?? [];
+        const envelope = this.#seq > 0
+            ? { op: 6, d: { sessao: sessao.sessao, seq: this.#seq, comandos } }
+            : {
+                op: 2,
+                d: { sessao: sessao.sessao, intents: this.opcoes.intents, comandos },
+            };
+        ws.send(JSON.stringify(envelope));
+    }
+    /**
+     * Parses one socket frame, discarding anything that is not a valid envelope.
+     *
+     * @param evento Raw `message` event from the socket.
+     * @returns The envelope, or `null` when the payload is not JSON or has no `op`.
+     */
+    #ler(evento) {
+        try {
+            const bruto = typeof evento.data === "string" ? evento.data : String(evento.data);
+            const envelope = JSON.parse(bruto);
+            return typeof envelope?.op === "number" ? envelope : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Handles one gateway frame.
+     *
+     * op 0 is a dispatch, op 11 is the heartbeat ack and everything else is
+     * ignored here.
+     *
+     * @param envelope Frame received from the socket.
+     * @param aoPronto Called once, as soon as `ready` marks the bot as connected.
+     */
+    #receber(envelope, aoPronto) {
+        if (envelope.op === 11)
+            return;
+        if (envelope.op !== 0 || !envelope.t)
+            return;
+        if (typeof envelope.s === "number")
+            this.#seq = envelope.s;
+        if (envelope.t === "ready") {
+            this.#tentativa = 0;
+            this.#mudar("pronto");
+            this.#bater();
+            aoPronto();
+        }
+        this.opcoes.aoEvento(envelope.t, envelope.d);
+    }
+    /**
+     * Sends an action (op 4) to the gateway.
+     *
+     * Voice uses this for `voz.entrar`, `voz.sair` and `voice.signal`; the same
+     * route carries `comandos` updates.
+     *
+     * @param tipo Action name understood by the server.
+     * @param dados Action payload, merged into `d`.
+     * @throws {Error} When the gateway is not connected.
+     */
+    agir(tipo, dados = {}) {
+        const ws = this.#ws;
+        if (!ws || ws.readyState !== ABERTO)
+            throw new Error("O gateway não está conectado.");
+        ws.send(JSON.stringify({ op: 4, d: { tipo, ...dados } }));
+    }
+    /**
+     * Closes the connection on purpose: it will not reconnect.
+     *
+     * @param codigo WebSocket close code sent to the server.
+     * @param motivo Human-readable reason sent to the server.
+     */
+    fechar(codigo = 1000, motivo = "pedido do bot") {
+        this.#encerrado = true;
+        this.#limpar();
+        try {
+            this.#ws?.close(codigo, motivo);
+        }
+        catch {
+            /* it was already closing */
+        }
+        this.#ws = null;
+        this.#mudar("encerrado");
+    }
+    /**
+     * Stores the new state, notifies the bot and logs the detail, when there is one.
+     *
+     * @param estado New connection state.
+     * @param detalhe Optional human-readable explanation for logs and errors.
+     */
+    #mudar(estado, detalhe) {
+        this.#estado = estado;
+        this.opcoes.aoEstado?.(estado, detalhe);
+        if (detalhe)
+            this.opcoes.log?.(`[${estado}] ${detalhe}`);
+    }
+    /**
+     * (Re)starts the heartbeat timer, sending op 1 with the last sequence number.
+     *
+     * The interval is left `unref`'d so it never keeps the process alive.
+     */
+    #bater() {
+        if (this.#batida)
+            clearInterval(this.#batida);
+        this.#batida = setInterval(() => {
+            const ws = this.#ws;
+            if (!ws || ws.readyState !== ABERTO)
+                return;
+            ws.send(JSON.stringify({ op: 1, d: this.#seq }));
+        }, this.opcoes.heartbeatMs);
+        this.#batida.unref?.();
+    }
+    /**
+     * With nothing from the server for more than 90 s, the connection died
+     * silently (proxy, NAT). Drops it so the reconnect logic kicks in: it is the
+     * same deadline the server uses.
+     */
+    #armarVigia() {
+        if (this.#vigia)
+            clearTimeout(this.#vigia);
+        this.#vigia = setTimeout(() => {
+            if (this.#estado === "encerrado")
+                return;
+            this.opcoes.log?.("sem sinal do servidor; reconectando");
+            try {
+                this.#ws?.close(4000, "sem sinal");
+            }
+            catch {
+                /* it had already dropped */
+            }
+        }, SEM_SINAL_MS);
+        this.#vigia.unref?.();
+    }
+    /**
+     * Decides what to do when the socket closes: come back or stop for good.
+     *
+     * @param codigo WebSocket close code.
+     * @param motivo Close reason, used in the log and in the state detail.
+     */
+    #aoFechar(codigo, motivo) {
+        this.#limpar();
+        this.#ws = null;
+        if (this.#encerrado)
+            return;
+        if (DEFINITIVOS.has(codigo)) {
+            this.#mudar("recusado", `${codigo}: ${motivo}`);
+            this.#encerrado = true;
+            return;
+        }
+        if (codigo === OUTRA_CONEXAO) {
+            this.#mudar("recusado", "outra conexão assumiu este bot");
+            this.#encerrado = true;
+            return;
+        }
+        if (codigo === SESSAO_ENCERRADA) {
+            this.#mudar("recusado", "a sessão foi encerrada (token girado ou bot desativado)");
+            this.#encerrado = true;
+            return;
+        }
+        // 4002 (expired session) and network drops: renew the session and come back.
+        this.#tentativa += 1;
+        const espera = Math.min(30_000, 500 * 2 ** Math.min(this.#tentativa, 6));
+        this.#mudar("reconectando", `${codigo || "sem código"}: volta em ${espera} ms (tentativa ${this.#tentativa})`);
+        this.#recuo = setTimeout(() => {
+            if (this.#encerrado)
+                return;
+            // On an expired session, the client's `sessao()` already asks for another one.
+            this.#abrir().catch((erro) => this.#mudar("reconectando", `falhou: ${erro.message}`));
+        }, espera);
+        this.#recuo.unref?.();
+    }
+    /** Clears every timer, so a closed gateway leaves no handles behind. */
+    #limpar() {
+        if (this.#batida)
+            clearInterval(this.#batida);
+        if (this.#vigia)
+            clearTimeout(this.#vigia);
+        if (this.#recuo)
+            clearTimeout(this.#recuo);
+        this.#batida = null;
+        this.#vigia = null;
+        this.#recuo = null;
+    }
+}
+//# sourceMappingURL=gateway.js.map

package/dist/src/gateway.js.map

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

package/dist/src/http.d.ts

@@ -0,0 +1,119 @@
+import type { Descoberta, Intencao, Mensagem, Sessao } from "./tipos.js";
+/**
+ * Error thrown for every non-2xx response from the bot API.
+ *
+ * It carries the HTTP status and, when the server sends one, the machine-readable
+ * `codigo` (e.g. `"canal"`, `"voz"`), so callers can react to the cause instead
+ * of parsing the message.
+ */
+export declare class ErroDaApi extends Error {
+    readonly status: number;
+    readonly codigo: string | null;
+    /**
+     * @param mensagem Human-readable message taken from the server payload.
+     * @param status HTTP status code of the failed response.
+     * @param codigo Server error code, when the payload provided one.
+     */
+    constructor(mensagem: string, status: number, codigo?: string | null);
+}
+/** Credentials and transport used by every {@link Http} call. */
+export interface OpcoesHttp {
+    /** Server base URL, e.g. `https://vertice.example` (default: `http://localhost:8080`). */
+    baseUrl?: string;
+    /** Bot token (`vtb_…`), copied from the admin panel. */
+    token: string;
+    /** Injectable for tests; defaults to the global `fetch`. */
+    fetch?: typeof fetch;
+}
+/**
+ * Minimal HTTP client for the `/api/bots/*` routes.
+ *
+ * Requests authenticate as `Bot <token>` until a session exists, then as
+ * `Bearer <sessao>` — the form the server expects on message routes. There is
+ * no runtime dependency: it uses the global `fetch` from Node 22+.
+ */
+export declare class Http {
+    #private;
+    /**
+     * @param options Base URL, bot token and an optional `fetch` implementation.
+     * @throws {Error} When the token is missing or empty.
+     */
+    constructor({ baseUrl, token, fetch: buscar }: OpcoesHttp);
+    /**
+     * Fetches the discovery document: what this bot may do, as configured in the panel.
+     *
+     * @returns Channels, intents, ICE servers and rate limits granted to the bot.
+     * @throws {ErroDaApi} When the token is rejected.
+     */
+    descobrir(): Promise<Descoberta>;
+    /**
+     * Exchanges the bot token for a short-lived session (15 minutes).
+     *
+     * The SDK renews it on its own shortly before it expires.
+     *
+     * @returns The new session and its expiry.
+     * @throws {ErroDaApi} When the token is invalid or the bot is disabled.
+     */
+    abrirSessao(): Promise<Sessao>;
+    /**
+     * Posts a text message over HTTP (the gateway can do the same over WebSocket).
+     *
+     * @param code Channel code.
+     * @param texto Message content.
+     * @param sessao Session token; when absent, the bot token is used.
+     * @returns The message the server created (id, timestamp, …).
+     * @throws {ErroDaApi} When the channel does not exist or the bot cannot post.
+     */
+    enviar(code: string, texto: string, sessao?: string): Promise<Mensagem>;
+    /**
+     * Reads one page of channel history (up to 100 messages).
+     *
+     * @param code Channel code.
+     * @param options `antesDe` to page backwards; `sessao` to authenticate with a session.
+     * @returns The page, plus `temMais` telling whether another page exists.
+     * @throws {ErroDaApi} When the bot cannot read the channel.
+     */
+    historico(code: string, { antesDe, sessao }?: {
+        antesDe?: number;
+        sessao?: string;
+    }): Promise<{
+        sala: string;
+        mensagens: Mensagem[];
+        temMais: boolean;
+    }>;
+    /**
+     * Uploads a file (or a voice message) to a channel.
+     *
+     * The body goes raw, with the type in the headers — the same path the chat
+     * upload uses, without multipart.
+     *
+     * @param code Channel code.
+     * @param corpo File bytes.
+     * @param options File name, MIME type, whether it is a voice message, and session.
+     * @returns The message the server created.
+     * @throws {ErroDaApi} When the upload fails or the response carries no message.
+     */
+    enviarArquivo(code: string, corpo: Uint8Array, { nome, mime, tipo, sessao, }?: {
+        nome?: string;
+        mime?: string;
+        tipo?: "arquivo" | "voz";
+        sessao?: string;
+    }): Promise<Mensagem>;
+    /**
+     * Deletes one of the bot's own messages (the server refuses anyone else's).
+     *
+     * @param code Channel code the message belongs to.
+     * @param id Message id.
+     * @param sessao Session token; when absent, the bot token is used.
+     * @throws {ErroDaApi} When the message is not the bot's or is already gone.
+     */
+    apagar(code: string, id: string, sessao?: string): Promise<void>;
+    /**
+     * Lists the intents the server granted, for callers that want to check before connecting.
+     *
+     * @returns The intent names granted to this bot.
+     * @throws {ErroDaApi} When discovery fails.
+     */
+    intents(): Promise<Intencao[]>;
+}
+//# sourceMappingURL=http.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/http.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzE;;;;;;GAMG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAQhC,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IARhC;;;;OAIG;gBAED,QAAQ,EAAE,MAAM,EACP,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAM,GAAG,IAAW;CAKxC;AAED,iEAAiE;AACjE,MAAM,WAAW,UAAU;IACzB,0FAA0F;IAC1F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAKD;;;;;;GAMG;AACH,qBAAa,IAAI;;IAKf;;;OAGG;gBACS,EAAE,OAAiC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,UAAU;IAyDnF;;;;;OAKG;IACH,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC;IAIhC;;;;;;;OAOG;IACH,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IAI9B;;;;;;;;OAQG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQ7E;;;;;;;OAOG;IACH,SAAS,CACP,IAAI,EAAE,MAAM,EACZ,EAAE,OAAO,EAAE,MAAM,EAAE,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAC9D,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,QAAQ,EAAE,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAQrE;;;;;;;;;;;OAWG;IACG,aAAa,CACjB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,UAAU,EACjB,EACE,IAAgB,EAChB,IAAiC,EACjC,IAAgB,EAChB,MAAM,GACP,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,SAAS,GAAG,KAAK,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAClF,OAAO,CAAC,QAAQ,CAAC;IAgCpB;;;;;;;OAOG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOtE;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;CAGrC"}

package/dist/src/http.js

@@ -0,0 +1,189 @@
+/**
+ * Error thrown for every non-2xx response from the bot API.
+ *
+ * It carries the HTTP status and, when the server sends one, the machine-readable
+ * `codigo` (e.g. `"canal"`, `"voz"`), so callers can react to the cause instead
+ * of parsing the message.
+ */
+export class ErroDaApi extends Error {
+    status;
+    codigo;
+    /**
+     * @param mensagem Human-readable message taken from the server payload.
+     * @param status HTTP status code of the failed response.
+     * @param codigo Server error code, when the payload provided one.
+     */
+    constructor(mensagem, status, codigo = null) {
+        super(mensagem);
+        this.status = status;
+        this.codigo = codigo;
+        this.name = "ErroDaApi";
+    }
+}
+/** Trailing slashes, removed so every path can safely start with `/`. */
+const SEM_BARRA = /\/+$/;
+/**
+ * Minimal HTTP client for the `/api/bots/*` routes.
+ *
+ * Requests authenticate as `Bot <token>` until a session exists, then as
+ * `Bearer <sessao>` — the form the server expects on message routes. There is
+ * no runtime dependency: it uses the global `fetch` from Node 22+.
+ */
+export class Http {
+    #base;
+    #token;
+    #fetch;
+    /**
+     * @param options Base URL, bot token and an optional `fetch` implementation.
+     * @throws {Error} When the token is missing or empty.
+     */
+    constructor({ baseUrl = "http://localhost:8080", token, fetch: buscar }) {
+        if (!token)
+            throw new Error("Falta o token do bot (o `vtb_…` do painel).");
+        this.#base = baseUrl.replace(SEM_BARRA, "");
+        this.#token = token;
+        this.#fetch = buscar ?? globalThis.fetch;
+    }
+    /**
+     * Performs a JSON request and unwraps the response.
+     *
+     * @typeParam T Expected shape of the response body.
+     * @param caminho Path relative to the base URL (e.g. `/api/bots/gateway`).
+     * @param options HTTP method, session token and JSON body.
+     * @returns The parsed body, or `null` when the server sent no content.
+     * @throws {ErroDaApi} When the response status is not 2xx.
+     */
+    async #pedir(caminho, { metodo = "GET", sessao, corpo, } = {}) {
+        const cabecalhos = {
+            Accept: "application/json",
+            // The bot token always works; the session only once one is in hand.
+            Authorization: sessao ? `Bearer ${sessao}` : `Bot ${this.#token}`,
+        };
+        let envio;
+        if (corpo !== undefined) {
+            cabecalhos["Content-Type"] = "application/json";
+            envio = JSON.stringify(corpo);
+        }
+        const resposta = await this.#fetch(this.#base + caminho, {
+            method: metodo,
+            headers: cabecalhos,
+            body: envio,
+        });
+        const texto = await resposta.text();
+        let dados = null;
+        try {
+            dados = texto ? JSON.parse(texto) : null;
+        }
+        catch {
+            dados = null;
+        }
+        if (!resposta.ok) {
+            const erro = (dados ?? {});
+            throw new ErroDaApi(erro.erro ?? `O servidor respondeu ${resposta.status}.`, resposta.status, erro.codigo ?? null);
+        }
+        return dados;
+    }
+    /**
+     * Fetches the discovery document: what this bot may do, as configured in the panel.
+     *
+     * @returns Channels, intents, ICE servers and rate limits granted to the bot.
+     * @throws {ErroDaApi} When the token is rejected.
+     */
+    descobrir() {
+        return this.#pedir("/api/bots/gateway");
+    }
+    /**
+     * Exchanges the bot token for a short-lived session (15 minutes).
+     *
+     * The SDK renews it on its own shortly before it expires.
+     *
+     * @returns The new session and its expiry.
+     * @throws {ErroDaApi} When the token is invalid or the bot is disabled.
+     */
+    abrirSessao() {
+        return this.#pedir("/api/bots/session", { metodo: "POST" });
+    }
+    /**
+     * Posts a text message over HTTP (the gateway can do the same over WebSocket).
+     *
+     * @param code Channel code.
+     * @param texto Message content.
+     * @param sessao Session token; when absent, the bot token is used.
+     * @returns The message the server created (id, timestamp, …).
+     * @throws {ErroDaApi} When the channel does not exist or the bot cannot post.
+     */
+    async enviar(code, texto, sessao) {
+        const resposta = await this.#pedir(`/api/bots/channels/${encodeURIComponent(code)}/messages`, { metodo: "POST", sessao, corpo: { content: texto } });
+        return resposta.mensagem;
+    }
+    /**
+     * Reads one page of channel history (up to 100 messages).
+     *
+     * @param code Channel code.
+     * @param options `antesDe` to page backwards; `sessao` to authenticate with a session.
+     * @returns The page, plus `temMais` telling whether another page exists.
+     * @throws {ErroDaApi} When the bot cannot read the channel.
+     */
+    historico(code, { antesDe, sessao } = {}) {
+        const consulta = antesDe ? `?antesDe=${antesDe}` : "";
+        return this.#pedir(`/api/bots/channels/${encodeURIComponent(code)}/messages${consulta}`, { sessao });
+    }
+    /**
+     * Uploads a file (or a voice message) to a channel.
+     *
+     * The body goes raw, with the type in the headers — the same path the chat
+     * upload uses, without multipart.
+     *
+     * @param code Channel code.
+     * @param corpo File bytes.
+     * @param options File name, MIME type, whether it is a voice message, and session.
+     * @returns The message the server created.
+     * @throws {ErroDaApi} When the upload fails or the response carries no message.
+     */
+    async enviarArquivo(code, corpo, { nome = "arquivo", mime = "application/octet-stream", tipo = "arquivo", sessao, } = {}) {
+        const resposta = await this.#fetch(`${this.#base}/api/bots/channels/${encodeURIComponent(code)}/messages`, {
+            method: "POST",
+            headers: {
+                Authorization: sessao ? `Bearer ${sessao}` : `Bot ${this.#token}`,
+                "Content-Type": mime,
+                // The server undoes the percent-encoding, so accented names survive intact.
+                "X-Vertice-Nome": encodeURIComponent(nome),
+                "X-Vertice-Tipo": tipo,
+            },
+            body: corpo,
+        });
+        const texto = await resposta.text();
+        const dados = (() => {
+            try {
+                return JSON.parse(texto);
+            }
+            catch {
+                return {};
+            }
+        })();
+        if (!resposta.ok || !dados.mensagem)
+            throw new ErroDaApi(dados.erro ?? `O servidor respondeu ${resposta.status}.`, resposta.status, dados.codigo ?? null);
+        return dados.mensagem;
+    }
+    /**
+     * Deletes one of the bot's own messages (the server refuses anyone else's).
+     *
+     * @param code Channel code the message belongs to.
+     * @param id Message id.
+     * @param sessao Session token; when absent, the bot token is used.
+     * @throws {ErroDaApi} When the message is not the bot's or is already gone.
+     */
+    async apagar(code, id, sessao) {
+        await this.#pedir(`/api/bots/messages/${encodeURIComponent(id)}?canal=${encodeURIComponent(code)}`, { metodo: "DELETE", sessao });
+    }
+    /**
+     * Lists the intents the server granted, for callers that want to check before connecting.
+     *
+     * @returns The intent names granted to this bot.
+     * @throws {ErroDaApi} When discovery fails.
+     */
+    async intents() {
+        return (await this.descobrir()).intents;
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/src/http.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Public surface of `@openvertice/bot-sdk`.
+ *
+ * Everything a bot needs lives behind this module: the {@link Bot} client, the
+ * {@link Voz} mesh client, the contract types and the audio helpers.
+ */
+export { Bot, ErroDaApi } from "./cliente.js";
+export type { ContextoDoComando, OpcoesDoBot } from "./cliente.js";
+export type { EstadoDoGateway, OpcoesGateway } from "./gateway.js";
+export type { AnexoDaMensagem, CanalDeTexto, CanalDeVoz, Descoberta, Eventos, Intencao, Limites, Mensagem, PeerDaVoz, PreviaDeLink, ServidorIce, Sessao, SinalDeVoz, } from "./tipos.js";
+export { CONTRATO } from "./tipos.js";
+export { Voz } from "./voz.js";
+export type { ConexaoDeVoz, EntradaNaVoz, FonteDeAudio, OpcoesDeVoz, TransporteDeVoz, } from "./voz.js";
+export { criarTransporteWrtc } from "./voz-wrtc.js";
+export { tocarTom } from "./audio.js";
+export type { OpcoesDoTom } from "./audio.js";
+export { wavDeTom } from "./wav.js";
+export type { OpcoesDoWav } from "./wav.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACnE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACnE,YAAY,EACV,eAAe,EACf,YAAY,EACZ,UAAU,EACV,UAAU,EACV,OAAO,EACP,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,WAAW,EACX,MAAM,EACN,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,eAAe,GAChB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,16 @@
+// Vértice bot SDK entry point (`@openvertice/bot-sdk`). The contract belongs to
+// the server (server/bots/README.md); this module exports only what a bot needs
+// in order to exist.
+/**
+ * Public surface of `@openvertice/bot-sdk`.
+ *
+ * Everything a bot needs lives behind this module: the {@link Bot} client, the
+ * {@link Voz} mesh client, the contract types and the audio helpers.
+ */
+export { Bot, ErroDaApi } from "./cliente.js";
+export { CONTRATO } from "./tipos.js";
+export { Voz } from "./voz.js";
+export { criarTransporteWrtc } from "./voz-wrtc.js";
+export { tocarTom } from "./audio.js";
+export { wavDeTom } from "./wav.js";
+//# sourceMappingURL=index.js.map