@openvertice/bot-sdk 0.0.0-stage → 0.1.0

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,gFAAgF;AAChF,qBAAqB;AACrB;;;;;GAKG;AACH,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAkB9C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAQ/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC"}

package/dist/src/tipos.d.ts

@@ -0,0 +1,243 @@
+/** Contract version this SDK implements. */
+export declare const CONTRATO = "2026-10";
+/** Gateway event families a bot may subscribe to. */
+export type Intencao = "MESSAGES" | "MEMBERS" | "ROOMS" | "PRESENCE";
+/** A text channel as the server grants it to this bot. */
+export interface CanalDeTexto {
+    /** Stable channel code used in every API call (for example `"MURAL"`). */
+    code: string;
+    /** Name people see ("Música"); falls back to `code` if the room is gone. */
+    nome: string;
+    /** Whether the bot may read what is posted here. */
+    escutar: boolean;
+    /** Whether the bot may post here. */
+    falar: boolean;
+    /** Command prefix of the channel; `null` = the bot receives everything it can hear. */
+    prefixo: string | null;
+}
+/** A voice channel the bot is allowed to join. */
+export interface CanalDeVoz {
+    code: string;
+    nome: string;
+}
+/** STUN/TURN server handed to the WebRTC peer connection. */
+export interface ServidorIce {
+    /** One URL or a list of them (`stun:`, `turn:`). */
+    urls: string | string[];
+    username?: string;
+    credential?: string;
+}
+/** Rate limits the server enforces for this bot. */
+export interface Limites {
+    /** Messages per minute. */
+    mensagensPorMinuto: number;
+    /** `identify` attempts per minute. */
+    identifyPorMinuto: number;
+    /** Session lifetime in seconds. */
+    sessaoSegundos: number;
+}
+/** Response of `GET /api/bots/gateway`: everything this bot is allowed to do. */
+export interface Descoberta {
+    /** Contract version the server speaks; compare it with `CONTRATO`. */
+    contrato: string;
+    /** The identity the server assigned to the bot. */
+    bot: {
+        id: string;
+        usuario: string;
+        exibicao: string;
+    };
+    /** Where to connect and how often to send heartbeats. */
+    gateway: {
+        versao: number;
+        url: string;
+        heartbeatMs: number;
+    };
+    /** Channels the panel granted, split by kind. */
+    canais: {
+        texto: CanalDeTexto[];
+        voz: CanalDeVoz[];
+    };
+    /** Event families the panel granted. */
+    intents: Intencao[];
+    /** ICE servers to use for voice. */
+    iceServers: ServidorIce[];
+    /** Effective rate limits. */
+    limites: Limites;
+}
+/** Response of `POST /api/bots/session`: a short-lived gateway credential. */
+export interface Sessao {
+    /** The session token, sent on `identify` and on message requests. */
+    sessao: string;
+    /** Expiry as a Unix timestamp in milliseconds. */
+    expiraEm: number;
+    /** Gateway endpoint and cadence to use with this session. */
+    gateway: {
+        versao: number;
+        url: string;
+        heartbeatMs: number;
+    };
+}
+/** A file attached to a message. */
+export interface AnexoDaMensagem {
+    /** Original file name, as uploaded. */
+    nome: string;
+    /** MIME type. */
+    mime: string;
+    /** Size in bytes. */
+    tamanho: number;
+    /** Absolute URL to download the file. */
+    url: string;
+}
+/** Link preview the server resolved for a message. */
+export interface PreviaDeLink {
+    /** URL the preview was built from. */
+    url: string;
+    /** Page title, when the server could read one. */
+    titulo: string | null;
+    /** Page description, when available. */
+    descricao: string | null;
+    /** Preview image URL, when available. */
+    imagem: string | null;
+    /** Site name (host) shown next to the preview. */
+    site: string;
+}
+/** A message, as delivered by `message.created` and returned by the send routes. */
+export interface Mensagem {
+    /** Message id, unique inside the channel. */
+    id: string;
+    /** Code of the channel the message belongs to. */
+    sala?: string;
+    /** Display name of the author. */
+    autor: string;
+    /** Author id, used to tell the bot's own messages apart. */
+    autorId?: string | null;
+    /** `true` when the author is a bot — this one included. */
+    autorBot: boolean;
+    /** Kind of payload the message carries. */
+    tipo?: "texto" | "arquivo" | "voz";
+    /** Text content; `null` for attachments without a caption. */
+    texto: string | null;
+    /** Creation time as a Unix timestamp in milliseconds. */
+    criadaEm: number;
+    /** When the message was pinned, if it was. */
+    fixadaEm?: number | null;
+    /** Who pinned the message. */
+    fixadaPor?: string | null;
+    /** Attachment, when `tipo` is `arquivo` or `voz`. */
+    arquivo?: AnexoDaMensagem | null;
+    /** Resolved link preview, when the message contains a link. */
+    previa?: PreviaDeLink | null;
+}
+/**
+ * The payload of `voice.signal` — the raw WebRTC `signal`, untranslated.
+ *
+ * The SDP travels under two names because both sides of the protocol already
+ * existed: `sdp` is the bot contract's name (server/bots/README.md) and
+ * `description.sdp` is what the browser client reads
+ * (`client/src/types/signaling.ts`). Senders fill in both; receivers accept
+ * either one.
+ */
+export interface SinalDeVoz {
+    /** `"offer"`, `"answer"` or `"candidate"`. */
+    type?: string;
+    /** Session description, in the bot contract's name. */
+    sdp?: string;
+    /** Session description, in the browser client's shape. */
+    description?: {
+        type?: string;
+        sdp?: string;
+    };
+    /** ICE candidate, when `type` is `"candidate"`. */
+    candidate?: unknown;
+    [chave: string]: unknown;
+}
+/** A command announced on `identify`, used by the client's autocomplete. */
+export interface ComandoAnunciado {
+    /** Command name, without the channel prefix (e.g. `"tocar"`). */
+    nome: string;
+    /** Short, human-readable summary shown next to the suggestion. */
+    descricao?: string;
+}
+/** Someone else in the voice room. */
+export interface PeerDaVoz {
+    /** Peer id inside the room. */
+    id: string;
+    /** Display name. */
+    nome: string;
+    /** `true` when the peer is a bot. */
+    bot?: boolean;
+}
+/** Events dispatched by the gateway (op 0), keyed by event name, with the shape of their `d`. */
+export interface Eventos {
+    /** Sent once per connection, right after `identify` (or `resume`) succeeds. */
+    ready: {
+        /** The bot's identity on the server. */
+        bot: {
+            id: string;
+            usuario: string;
+            exibicao: string;
+        };
+        /** Text channels with full settings; voice channels as bare codes. */
+        canais: {
+            texto: CanalDeTexto[];
+            voz: string[];
+        };
+        /** Event families the server accepted. */
+        intents: Intencao[];
+        /** Channels where the read subscription took effect (they exist and grant access). */
+        ouvindo: string[];
+        /** Commands this process announced, for the client's autocomplete. */
+        comandos: ComandoAnunciado[];
+        /** ICE servers to use for voice. */
+        iceServers: ServidorIce[];
+        /** Id of the session this connection is using. */
+        sessao: string;
+    };
+    /** A message was posted in a channel the bot listens to. */
+    "message.created": Mensagem;
+    /**
+     * Someone called the bot with `@login`/`@display`.
+     *
+     * Arrives even in channels with a prefix (where `message.created` would not)
+     * and, in channels without a prefix, alongside it.
+     */
+    mention: Mensagem;
+    /** A message was deleted; `sala` is the channel code it belonged to. */
+    "message.deleted": {
+        id: string;
+        sala: string;
+    };
+    /** An operation failed; `codigo` tells channel errors from voice errors. */
+    error: {
+        codigo: string;
+        mensagem: string;
+    };
+    /** The bot is now in the voice room. */
+    "voice.joined": {
+        /** Channel code. */
+        code: string;
+        /** Channel name. */
+        nome: string;
+        /** The bot's id in the room: it settles the crossed offer (glare). */
+        eu: string;
+        /** Peers already in the room. */
+        peers: PeerDaVoz[];
+    };
+    /** Another peer joined the voice room. */
+    "voice.peer.joined": PeerDaVoz;
+    /** Another peer left the voice room. */
+    "voice.peer.left": {
+        id: string;
+    };
+    /** The bot left (or was removed from) the voice room. */
+    "voice.left": {
+        code: string;
+        motivo: string;
+    };
+    /** WebRTC signaling addressed to this bot by peer `de`. */
+    "voice.signal": {
+        de: string;
+        signal: SinalDeVoz;
+    };
+}
+//# sourceMappingURL=tipos.d.ts.map

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

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

package/dist/src/tipos.js

@@ -0,0 +1,5 @@
+// Types of the Vértice contract (server/bots/README.md, version 2026-10).
+// They are the boundary: if the server changes a field, it changes here too.
+/** Contract version this SDK implements. */
+export const CONTRATO = "2026-10";
+//# sourceMappingURL=tipos.js.map

package/dist/src/tipos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tipos.js","sourceRoot":"","sources":["../../src/tipos.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,6EAA6E;AAE7E,4CAA4C;AAC5C,MAAM,CAAC,MAAM,QAAQ,GAAG,SAAS,CAAC"}

package/dist/src/voz-wrtc.d.ts

@@ -0,0 +1,20 @@
+import type { TransporteDeVoz } from "./voz.js";
+/**
+ * Creates the Node voice transport backed by `@roamhq/wrtc`.
+ *
+ * The returned transport mirrors the browser's `RTCPeerConnection` API, so the
+ * mesh code in voz.ts does not need to know which runtime it is running on.
+ * Every connection it opens is tracked, and `fechar()` closes them all.
+ *
+ * @returns A transport that creates peer connections and audio sources.
+ * @throws {Error} When `@roamhq/wrtc` is not installed.
+ *
+ * @example
+ * ```ts
+ * const transporte = await criarTransporteWrtc();
+ * const voz = new Voz(bot, { transporte });
+ * await voz.entrar("PATIO");
+ * ```
+ */
+export declare function criarTransporteWrtc(): Promise<TransporteDeVoz>;
+//# sourceMappingURL=voz-wrtc.d.ts.map

package/dist/src/voz-wrtc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voz-wrtc.d.ts","sourceRoot":"","sources":["../../src/voz-wrtc.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAA8B,eAAe,EAAE,MAAM,UAAU,CAAC;AAqD5E;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,eAAe,CAAC,CAwBpE"}

package/dist/src/voz-wrtc.js

@@ -0,0 +1,68 @@
+/** Module cache: the native addon is imported at most once per process. */
+let carregado = null;
+/**
+ * Imports `@roamhq/wrtc` on first use.
+ *
+ * The import is dynamic on purpose: a bot that only handles text must not pay
+ * for (or fail because of) a native dependency it never uses.
+ *
+ * @returns The wrtc module, memoised after the first call.
+ * @throws {Error} With install instructions when the optional dependency is missing.
+ */
+async function carregarWrtc() {
+    if (carregado)
+        return carregado;
+    try {
+        const modulo = (await import("@roamhq/wrtc"));
+        carregado = "RTCPeerConnection" in modulo ? modulo : modulo.default;
+        return carregado;
+    }
+    catch (erro) {
+        throw new Error("A voz do bot precisa de `@roamhq/wrtc`. Instale com `npm i @roamhq/wrtc` " +
+            `no projeto do bot (o texto funciona sem ele). Detalhe: ${erro instanceof Error ? erro.message : String(erro)}`);
+    }
+}
+/**
+ * Creates the Node voice transport backed by `@roamhq/wrtc`.
+ *
+ * The returned transport mirrors the browser's `RTCPeerConnection` API, so the
+ * mesh code in voz.ts does not need to know which runtime it is running on.
+ * Every connection it opens is tracked, and `fechar()` closes them all.
+ *
+ * @returns A transport that creates peer connections and audio sources.
+ * @throws {Error} When `@roamhq/wrtc` is not installed.
+ *
+ * @example
+ * ```ts
+ * const transporte = await criarTransporteWrtc();
+ * const voz = new Voz(bot, { transporte });
+ * await voz.entrar("PATIO");
+ * ```
+ */
+export async function criarTransporteWrtc() {
+    const wrtc = await carregarWrtc();
+    const abertas = new Set();
+    return {
+        /** Opens a peer connection configured with the server-provided ICE servers. */
+        criarConexao({ iceServers }) {
+            const conexao = new wrtc.RTCPeerConnection({
+                iceServers: iceServers.map((servidor) => ({
+                    urls: servidor.urls,
+                    ...(servidor.username ? { username: servidor.username } : {}),
+                    ...(servidor.credential ? { credential: servidor.credential } : {}),
+                })),
+            });
+            abertas.add(conexao);
+            return conexao;
+        },
+        /** Creates the PCM source that feeds the published audio track. */
+        criarFonteDeAudio: () => new wrtc.nonstandard.RTCAudioSource(),
+        /** Closes every connection this transport opened. */
+        fechar() {
+            for (const conexao of abertas)
+                conexao.close();
+            abertas.clear();
+        },
+    };
+}
+//# sourceMappingURL=voz-wrtc.js.map

package/dist/src/voz-wrtc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voz-wrtc.js","sourceRoot":"","sources":["../../src/voz-wrtc.ts"],"names":[],"mappings":"AA4BA,2EAA2E;AAC3E,IAAI,SAAS,GAAsB,IAAI,CAAC;AAExC;;;;;;;;GAQG;AACH,KAAK,UAAU,YAAY;IACzB,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,cAAc,CAAC,CAEjB,CAAC;QAC5B,SAAS,GAAG,mBAAmB,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;QACpE,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,OAAO,IAAI,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,2EAA2E;YACzE,0DACE,IAAI,YAAY,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CACpD,EAAE,CACL,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB;IACvC,MAAM,IAAI,GAAG,MAAM,YAAY,EAAE,CAAC;IAClC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAgB,CAAC;IACxC,OAAO;QACL,+EAA+E;QAC/E,YAAY,CAAC,EAAE,UAAU,EAAiC;YACxD,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,iBAAiB,CAAC;gBACzC,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;oBACxC,IAAI,EAAE,QAAQ,CAAC,IAAI;oBACnB,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC7D,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACpE,CAAC,CAAC;aACJ,CAAC,CAAC;YACH,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACrB,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,mEAAmE;QACnE,iBAAiB,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE;QAC9D,qDAAqD;QACrD,MAAM;YACJ,KAAK,MAAM,OAAO,IAAI,OAAO;gBAAE,OAAO,CAAC,KAAK,EAAE,CAAC;YAC/C,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/src/voz.d.ts

@@ -0,0 +1,150 @@
+import type { Bot } from "./cliente.js";
+import type { ServidorIce } from "./tipos.js";
+/**
+ * The minimum voice needs from WebRTC — swappable in tests.
+ *
+ * `criarTransporteWrtc()` provides the Node implementation.
+ */
+export interface TransporteDeVoz {
+    /** Opens one peer connection, configured with the given ICE servers. */
+    criarConexao(opcoes: {
+        iceServers: ServidorIce[];
+    }): ConexaoDeVoz;
+    /** Creates the PCM source that feeds the published track. */
+    criarFonteDeAudio(): FonteDeAudio;
+    /** Closes every connection this transport opened. */
+    fechar(): void;
+}
+/** The slice of `RTCPeerConnection` the mesh actually uses. */
+export interface ConexaoDeVoz {
+    /** Standard `signalingState` (`stable`, `have-local-offer`, …). */
+    signalingState: string;
+    /** Local session description, once one has been set. */
+    localDescription: {
+        type: string;
+        sdp?: string;
+    } | null;
+    /** Adds an `audio` or `video` m-line and returns the transceiver. */
+    addTransceiver(tipo: "audio" | "video", opcoes?: {
+        direction?: string;
+    }): unknown;
+    /** Current transceivers, in SDP order. */
+    getTransceivers(): {
+        direction: string;
+        sender: {
+            track: unknown;
+            replaceTrack(track: unknown): Promise<void>;
+        };
+    }[];
+    /** Builds an offer from the current transceivers. */
+    createOffer(): Promise<{
+        type: "offer";
+        sdp: string;
+    }>;
+    /** Builds an answer to the current remote offer. */
+    createAnswer(): Promise<{
+        type: "answer";
+        sdp: string;
+    }>;
+    /** Applies a local session description. */
+    setLocalDescription(descricao: {
+        type: string;
+        sdp?: string;
+    }): Promise<void>;
+    /** Applies the remote session description. */
+    setRemoteDescription(descricao: {
+        type: string;
+        sdp?: string;
+    }): Promise<void>;
+    /** Adds a remote ICE candidate. */
+    addIceCandidate(candidato: unknown): Promise<void>;
+    /** Closes the connection and releases its resources. */
+    close(): void;
+    /** Emits local ICE candidates as they are gathered. */
+    onicecandidate: ((evento: {
+        candidate: unknown;
+    }) => void) | null;
+    /** Emits remote tracks as they arrive. */
+    ontrack: ((evento: {
+        track: unknown;
+    }) => void) | null;
+}
+/** Audio source: where the track the bot publishes comes from. */
+export interface FonteDeAudio {
+    /** Creates the track fed by this source. */
+    createTrack(): unknown;
+}
+/** What {@link Voz} needs to run. */
+export interface OpcoesDeVoz {
+    /** Runtime that creates peer connections and audio sources. */
+    transporte: TransporteDeVoz;
+    /**
+     * The track the bot publishes. Without it, voice creates one from
+     * `transporte.criarFonteDeAudio()` — and you feed that source (see audio.ts).
+     */
+    track?: unknown;
+    /** What to do with the audio that arrives from the other peers. */
+    aoReceberTrack?: (peerId: string, track: unknown) => void;
+    /** Diagnostic sink. */
+    log?: (mensagem: string) => void;
+}
+/** Result of a successful {@link Voz.entrar}. */
+export interface EntradaNaVoz {
+    /** Channel code the bot joined. */
+    code: string;
+    /** Channel name. */
+    nome: string;
+    /** The bot's id in the room (it settles the crossed offer). */
+    eu: string;
+    /** Peers that were already in the room. */
+    peers: {
+        id: string;
+        nome: string;
+        bot?: boolean;
+    }[];
+}
+/**
+ * Voice client for a {@link Bot}.
+ *
+ * The bot is one more peer in the mesh: it offers to peers that are already in
+ * the room, answers offers, exchanges ICE candidates and publishes one audio
+ * track. Create it once, before `bot.start()`, so the listeners are in place
+ * when `voice.joined` arrives.
+ *
+ * @example
+ * ```ts
+ * const transporte = await criarTransporteWrtc();
+ * const voz = new Voz(bot, { transporte });
+ * await bot.start();
+ * await voz.entrar("PATIO");
+ * ```
+ */
+export declare class Voz {
+    #private;
+    /**
+     * Wires the voice client to a bot.
+     *
+     * It subscribes to the voice events right away, so the instance must exist
+     * before the bot starts.
+     *
+     * @param bot Bot whose gateway carries the signaling.
+     * @param opcoes Transport, optional track and logging.
+     */
+    constructor(bot: Bot, opcoes: OpcoesDeVoz);
+    /** Channel the bot is in (`null` = not in voice). */
+    get canal(): string | null;
+    /** The published track; created on demand when it was not passed in the options. */
+    get track(): unknown;
+    /**
+     * Joins a voice channel and offers to everyone already there.
+     *
+     * @param code Channel code (case-insensitive).
+     * @returns The room information, once the server confirms the join.
+     * @throws {Error} When the server rejects the join or does not confirm it
+     * within {@link ESPERA_DA_ENTRADA_MS}.
+     */
+    entrar(code: string): Promise<EntradaNaVoz>;
+    /** Leaves the voice room, if the bot is in one. */
+    sair(): void;
+}
+//# sourceMappingURL=voz.d.ts.map

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

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