@metagames/channel-bot-sdk 1.0.0

package/dist/examples/echo-bot.js

@@ -0,0 +1,24 @@
+// (c) 2026 Meta Games LLC. All rights reserved.
+import { ChannelBotClient, CommandRouter } from "../src/index";
+async function main() {
+    const token = process.env.BOT_TOKEN;
+    if (!token)
+        throw new Error("BOT_TOKEN is required");
+    const client = new ChannelBotClient({
+        token,
+        apiBaseUrl: process.env.BOT_API_BASE_URL || "https://api.brickverse.gg",
+    });
+    const router = new CommandRouter()
+        .command("ping", async (ctx) => {
+        await ctx.replyMention("pong");
+    })
+        .command("echo", async (ctx) => {
+        await ctx.reply(ctx.args.join(" ") || "Nothing to echo.");
+    });
+    client.useCommandRouter(router);
+    client.on("guildBot.ready", (event) => {
+        console.log(`ready as ${event.bot.username}`);
+    });
+    await client.connect();
+}
+void main();

package/dist/examples/moderation-helper-bot.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=moderation-helper-bot.d.ts.map

package/dist/examples/moderation-helper-bot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moderation-helper-bot.d.ts","sourceRoot":"","sources":["../../examples/moderation-helper-bot.ts"],"names":[],"mappings":""}

package/dist/examples/moderation-helper-bot.js

@@ -0,0 +1,31 @@
+// (c) 2026 Meta Games LLC. All rights reserved.
+import { ChannelBotClient, CommandRouter } from "../src/index";
+async function main() {
+    const token = process.env.BOT_TOKEN;
+    if (!token)
+        throw new Error("BOT_TOKEN is required");
+    const client = new ChannelBotClient({
+        token,
+        apiBaseUrl: process.env.BOT_API_BASE_URL || "https://api.brickverse.gg",
+    });
+    const router = new CommandRouter().command("warn", async (ctx) => {
+        const target = ctx.args[0];
+        const reason = ctx.args.slice(1).join(" ") || "No reason provided";
+        if (!target) {
+            await ctx.reply("Usage: /warn <username> <reason>");
+            return;
+        }
+        await ctx.replyEmbed({
+            title: "Moderator Warning",
+            description: `@${target} was warned by @${ctx.user.username}.`,
+            fields: [{ name: "Reason", value: reason }],
+            color: "#ff6b6b",
+        });
+    });
+    client.useCommandRouter(router);
+    client.on("guildBot.ready", (event) => {
+        console.log(`ready as ${event.bot.username}`);
+    });
+    await client.connect();
+}
+void main();

package/dist/http.d.ts

@@ -0,0 +1,12 @@
+export declare function normalizeApiBaseUrl(input: string): string;
+export declare function createWebSocketUrl(apiBaseUrl: string): string;
+export declare function requestWithBotToken<T>(args: {
+    fetchImpl: typeof fetch;
+    apiBaseUrl: string;
+    token: string;
+    path: string;
+    options?: Omit<RequestInit, "body"> & {
+        body?: unknown;
+    };
+}): Promise<T>;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAEA,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAK7D;AAED,wBAAsB,mBAAmB,CAAC,CAAC,EAAE,IAAI,EAAE;IAClD,SAAS,EAAE,OAAO,KAAK,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACzD,GAAG,OAAO,CAAC,CAAC,CAAC,CAqBb"}

package/dist/http.js

@@ -0,0 +1,28 @@
+// (c) 2026 Meta Games LLC. All rights reserved.
+export function normalizeApiBaseUrl(input) {
+    return input.replace(/\/+$/, "");
+}
+export function createWebSocketUrl(apiBaseUrl) {
+    const normalized = normalizeApiBaseUrl(apiBaseUrl);
+    const resolved = new URL("/v3/social/guild-bots/ws", `${normalized}/`);
+    resolved.protocol = resolved.protocol === "https:" ? "wss:" : "ws:";
+    return resolved.toString();
+}
+export async function requestWithBotToken(args) {
+    const endpoint = args.path.startsWith("/") ? args.path : `/${args.path}`;
+    const options = args.options || {};
+    const response = await args.fetchImpl(`${args.apiBaseUrl}${endpoint}`, {
+        method: options.method || "GET",
+        headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bot ${args.token}`,
+            ...(options.headers || {}),
+        },
+        body: options.body === undefined ? undefined : JSON.stringify(options.body),
+    });
+    const data = (await response.json().catch(() => ({})));
+    if (!response.ok || data.success === false) {
+        throw new Error(data.message || `Channel bot request failed (${response.status})`);
+    }
+    return data;
+}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { ChannelBotClient } from "./client";
+export { CommandContext, CommandRouter, messageInputFromInteraction, } from "./commands";
+export type { ChannelBotClientOptions, ChannelBotEmbed, ChannelBotEmbedField, ChannelBotMessage, ChannelBotMessageInput, GuildBotInteraction, GuildBotMeResponse, GuildBotSocketEvent, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EACN,cAAc,EACd,aAAa,EACb,2BAA2B,GAC3B,MAAM,YAAY,CAAC;AACpB,YAAY,EACX,uBAAuB,EACvB,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,GACnB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+// (c) 2026 Meta Games LLC. All rights reserved.
+export { ChannelBotClient } from "./client";
+export { CommandContext, CommandRouter, messageInputFromInteraction, } from "./commands";

package/dist/src/client.d.ts

@@ -0,0 +1,49 @@
+import { CommandRouter } from "./commands";
+import type { ChannelBotClientOptions, ChannelBotEmbed, ChannelBotMessage, ChannelBotMessageInput, GuildBotMeResponse, GuildBotSocketEvent } from "./types";
+export declare class ChannelBotClient {
+    private readonly token;
+    private readonly apiBaseUrl;
+    private readonly websocketUrl;
+    private readonly fetchImpl;
+    private readonly WebSocketImpl;
+    private readonly autoReconnect;
+    private readonly reconnectDelayMs;
+    private reconnectTimer;
+    private manuallyClosed;
+    private ws;
+    private readonly events;
+    private commandRouter;
+    constructor(options: ChannelBotClientOptions);
+    on<TEvent = GuildBotSocketEvent>(eventName: string, listener: (event: TEvent) => void): () => void;
+    off<TEvent = GuildBotSocketEvent>(eventName: string, listener: (event: TEvent) => void): void;
+    useCommandRouter(router: CommandRouter): this;
+    connect(): Promise<void>;
+    private scheduleReconnect;
+    disconnect(): void;
+    private request;
+    getMe(): Promise<GuildBotMeResponse>;
+    sendMessage(input: ChannelBotMessageInput): Promise<{
+        success: boolean;
+        message: ChannelBotMessage;
+    }>;
+    sendEmbed(input: {
+        guildId: string;
+        channelId: string;
+        embed: ChannelBotEmbed;
+        content?: string;
+    }): Promise<{
+        success: boolean;
+        message: ChannelBotMessage;
+    }>;
+    editMessage(messageId: string, input: {
+        content?: string;
+        embeds?: ChannelBotEmbed[];
+    }): Promise<{
+        success: boolean;
+        message: ChannelBotMessage;
+    }>;
+    deleteMessage(messageId: string): Promise<{
+        success: boolean;
+    }>;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EACX,uBAAuB,EACvB,eAAe,EACf,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,MAAM,SAAS,CAAC;AAEjB,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAmB;IACjD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IACxC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,aAAa,CAA8B;gBAEvC,OAAO,EAAE,uBAAuB;IAkB5C,EAAE,CAAC,MAAM,GAAG,mBAAmB,EAC9B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI;IAKlC,GAAG,CAAC,MAAM,GAAG,mBAAmB,EAC/B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI;IAKlC,gBAAgB,CAAC,MAAM,EAAE,aAAa;IAKhC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAyE9B,OAAO,CAAC,iBAAiB;IAQzB,UAAU;IAYV,OAAO,CAAC,OAAO;IAaf,KAAK;IAIL,WAAW,CAAC,KAAK,EAAE,sBAAsB;iBACT,OAAO;iBAAW,iBAAiB;;IASnE,SAAS,CAAC,KAAK,EAAE;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,eAAe,CAAC;QACvB,OAAO,CAAC,EAAE,MAAM,CAAC;KACjB;iBAd+B,OAAO;iBAAW,iBAAiB;;IAuBnE,WAAW,CACV,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,eAAe,EAAE,CAAA;KAAE;iBAExB,OAAO;iBAAW,iBAAiB;;IASnE,aAAa,CAAC,SAAS,EAAE,MAAM;iBACC,OAAO;;CAKvC"}

package/dist/src/client.js

@@ -0,0 +1,159 @@
+// (c) 2026 Meta Games LLC. All rights reserved.
+import { EventEmitter } from "./events";
+import { createWebSocketUrl, normalizeApiBaseUrl, requestWithBotToken, } from "./http";
+export class ChannelBotClient {
+    token;
+    apiBaseUrl;
+    websocketUrl;
+    fetchImpl;
+    WebSocketImpl;
+    autoReconnect;
+    reconnectDelayMs;
+    reconnectTimer = null;
+    manuallyClosed = false;
+    ws = null;
+    events = new EventEmitter();
+    commandRouter = null;
+    constructor(options) {
+        if (!options.token?.trim()) {
+            throw new Error("ChannelBotClient requires a bot token");
+        }
+        if (!options.apiBaseUrl?.trim()) {
+            throw new Error("ChannelBotClient requires apiBaseUrl");
+        }
+        this.token = options.token.trim();
+        this.apiBaseUrl = normalizeApiBaseUrl(options.apiBaseUrl);
+        this.websocketUrl =
+            options.websocketUrl || createWebSocketUrl(this.apiBaseUrl);
+        this.fetchImpl = options.fetchImpl || fetch;
+        this.WebSocketImpl = options.WebSocketImpl || WebSocket;
+        this.autoReconnect = options.autoReconnect !== false;
+        this.reconnectDelayMs = Math.max(250, options.reconnectDelayMs || 2500);
+    }
+    on(eventName, listener) {
+        return this.events.on(eventName, listener);
+    }
+    off(eventName, listener) {
+        return this.events.off(eventName, listener);
+    }
+    useCommandRouter(router) {
+        this.commandRouter = router;
+        return this;
+    }
+    async connect() {
+        this.manuallyClosed = false;
+        if (this.ws && this.ws.readyState <= 1)
+            return;
+        await new Promise((resolve, reject) => {
+            const ws = new this.WebSocketImpl(this.websocketUrl);
+            this.ws = ws;
+            let resolved = false;
+            ws.onopen = () => {
+                ws.send(JSON.stringify({ type: "guildBot.authenticate", token: this.token }));
+            };
+            ws.onmessage = (rawEvent) => {
+                if (!rawEvent.data)
+                    return;
+                let parsed;
+                try {
+                    parsed = JSON.parse(String(rawEvent.data));
+                }
+                catch {
+                    return;
+                }
+                this.events.emit("raw", parsed);
+                this.events.emit(parsed.type, parsed);
+                if (parsed.type === "guildBot.interactionCreate" &&
+                    this.commandRouter) {
+                    void this.commandRouter.handle(parsed, this).catch((error) => {
+                        this.events.emit("guildBot.commandError", {
+                            type: "guildBot.commandError",
+                            error,
+                            event: parsed,
+                        });
+                    });
+                }
+                if (parsed.type === "guildBot.ready" && !resolved) {
+                    resolved = true;
+                    resolve();
+                    return;
+                }
+                if (parsed.type === "guildBot.error" && !resolved) {
+                    resolved = true;
+                    reject(new Error(parsed.message || "Guild bot websocket error"));
+                }
+            };
+            ws.onerror = () => {
+                if (resolved)
+                    return;
+                resolved = true;
+                reject(new Error("Guild bot websocket connection failed"));
+            };
+            ws.onclose = () => {
+                this.ws = null;
+                this.events.emit("disconnected", { type: "disconnected" });
+                if (!this.manuallyClosed && this.autoReconnect) {
+                    this.scheduleReconnect();
+                }
+                if (!resolved) {
+                    resolved = true;
+                    reject(new Error("Guild bot websocket closed before ready"));
+                }
+            };
+        });
+    }
+    scheduleReconnect() {
+        if (this.reconnectTimer)
+            return;
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            void this.connect().catch(() => { });
+        }, this.reconnectDelayMs);
+    }
+    disconnect() {
+        this.manuallyClosed = true;
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+        }
+    }
+    request(path, options = {}) {
+        return requestWithBotToken({
+            fetchImpl: this.fetchImpl,
+            apiBaseUrl: this.apiBaseUrl,
+            token: this.token,
+            path,
+            options,
+        });
+    }
+    getMe() {
+        return this.request("/v3/social/guild-bots/@me");
+    }
+    sendMessage(input) {
+        return this.request("/v3/social/guild-bots/@me/messages", {
+            method: "POST",
+            body: input,
+        });
+    }
+    sendEmbed(input) {
+        return this.sendMessage({
+            guildId: input.guildId,
+            channelId: input.channelId,
+            content: input.content,
+            embeds: [input.embed],
+        });
+    }
+    editMessage(messageId, input) {
+        return this.request(`/v3/social/guild-bots/@me/messages/${messageId}`, {
+            method: "PUT",
+            body: input,
+        });
+    }
+    deleteMessage(messageId) {
+        return this.request(`/v3/social/guild-bots/@me/messages/${messageId}`, { method: "DELETE" });
+    }
+}

package/dist/src/commands.d.ts

@@ -0,0 +1,52 @@
+import type { ChannelBotEmbed, ChannelBotMessage, ChannelBotMessageInput, GuildBotInteraction, GuildBotSocketEvent } from "./types";
+import type { ChannelBotClient } from "./client";
+export declare class CommandContext {
+    readonly client: ChannelBotClient;
+    readonly guildId: string;
+    readonly channelId: string;
+    readonly interaction: GuildBotInteraction;
+    constructor(args: {
+        client: ChannelBotClient;
+        guildId: string;
+        channelId: string;
+        interaction: GuildBotInteraction;
+    });
+    get commandName(): string;
+    get args(): string[];
+    get user(): {
+        id: string;
+        username: string;
+    };
+    reply(input: string | {
+        content?: string;
+        embeds?: ChannelBotEmbed[];
+    }): Promise<{
+        success: boolean;
+        message: ChannelBotMessage;
+    }>;
+    replyMention(content: string): Promise<{
+        success: boolean;
+        message: ChannelBotMessage;
+    }>;
+    replyEmbed(embed: ChannelBotEmbed, content?: string): Promise<{
+        success: boolean;
+        message: ChannelBotMessage;
+    }>;
+}
+export type CommandHandler = (ctx: CommandContext) => Promise<unknown> | unknown;
+export declare class CommandRouter {
+    private readonly handlers;
+    command(name: string, handler: CommandHandler): this;
+    remove(name: string): this;
+    handle(event: Extract<GuildBotSocketEvent, {
+        type: "guildBot.interactionCreate";
+    }>, client: ChannelBotClient): Promise<boolean>;
+}
+export type ChannelBotMessageResponse = {
+    success: boolean;
+    message: ChannelBotMessage;
+};
+export declare function messageInputFromInteraction(event: Extract<GuildBotSocketEvent, {
+    type: "guildBot.interactionCreate";
+}>, input: Omit<ChannelBotMessageInput, "guildId" | "channelId">): ChannelBotMessageInput;
+//# sourceMappingURL=commands.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/commands.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,eAAe,EACf,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,qBAAa,cAAc;IAC1B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAC;gBAE9B,IAAI,EAAE;QACjB,MAAM,EAAE,gBAAgB,CAAC;QACzB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,mBAAmB,CAAC;KACjC;IAOD,IAAI,WAAW,WAEd;IAED,IAAI,IAAI,aAEP;IAED,IAAI,IAAI;;;MAEP;IAED,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,eAAe,EAAE,CAAA;KAAE;;;;IAiBtE,YAAY,CAAC,OAAO,EAAE,MAAM;;;;IAI5B,UAAU,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,MAAM;;;;CAMnD;AAED,MAAM,MAAM,cAAc,GAAG,CAC5B,GAAG,EAAE,cAAc,KACf,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;AAEhC,qBAAa,aAAa;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;IAE9D,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;IAOpD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKpB,MAAM,CACX,KAAK,EAAE,OAAO,CAAC,mBAAmB,EAAE;QAAE,IAAI,EAAE,4BAA4B,CAAA;KAAE,CAAC,EAC3E,MAAM,EAAE,gBAAgB;CAiBzB;AAED,MAAM,MAAM,yBAAyB,GAAG;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,iBAAiB,CAAC;CAC3B,CAAC;AAEF,wBAAgB,2BAA2B,CAC1C,KAAK,EAAE,OAAO,CAAC,mBAAmB,EAAE;IAAE,IAAI,EAAE,4BAA4B,CAAA;CAAE,CAAC,EAC3E,KAAK,EAAE,IAAI,CAAC,sBAAsB,EAAE,SAAS,GAAG,WAAW,CAAC,GAC1D,sBAAsB,CAOxB"}

package/dist/src/commands.js

@@ -0,0 +1,80 @@
+// (c) 2026 Meta Games LLC. All rights reserved.
+export class CommandContext {
+    client;
+    guildId;
+    channelId;
+    interaction;
+    constructor(args) {
+        this.client = args.client;
+        this.guildId = args.guildId;
+        this.channelId = args.channelId;
+        this.interaction = args.interaction;
+    }
+    get commandName() {
+        return this.interaction.commandName;
+    }
+    get args() {
+        return this.interaction.arguments;
+    }
+    get user() {
+        return this.interaction.user;
+    }
+    reply(input) {
+        if (typeof input === "string") {
+            return this.client.sendMessage({
+                guildId: this.guildId,
+                channelId: this.channelId,
+                content: input,
+            });
+        }
+        return this.client.sendMessage({
+            guildId: this.guildId,
+            channelId: this.channelId,
+            content: input.content,
+            embeds: input.embeds,
+        });
+    }
+    replyMention(content) {
+        return this.reply(`@${this.user.username} ${content}`);
+    }
+    replyEmbed(embed, content) {
+        return this.reply({
+            content,
+            embeds: [embed],
+        });
+    }
+}
+export class CommandRouter {
+    handlers = new Map();
+    command(name, handler) {
+        const normalized = name.trim().toLowerCase();
+        if (!normalized)
+            throw new Error("Command name is required");
+        this.handlers.set(normalized, handler);
+        return this;
+    }
+    remove(name) {
+        this.handlers.delete(name.trim().toLowerCase());
+        return this;
+    }
+    async handle(event, client) {
+        const handler = this.handlers.get(event.interaction.commandName.toLowerCase());
+        if (!handler)
+            return false;
+        await handler(new CommandContext({
+            client,
+            guildId: event.guildId,
+            channelId: event.channelId,
+            interaction: event.interaction,
+        }));
+        return true;
+    }
+}
+export function messageInputFromInteraction(event, input) {
+    return {
+        guildId: event.guildId,
+        channelId: event.channelId,
+        content: input.content,
+        embeds: input.embeds,
+    };
+}

package/dist/src/events.d.ts

@@ -0,0 +1,9 @@
+import type { GuildBotSocketEvent } from "./types";
+export type Listener<TEvent> = (event: TEvent) => void;
+export declare class EventEmitter {
+    private listeners;
+    on<TEvent = GuildBotSocketEvent>(eventName: string, listener: Listener<TEvent>): () => void;
+    off<TEvent = GuildBotSocketEvent>(eventName: string, listener: Listener<TEvent>): void;
+    emit<TEvent = GuildBotSocketEvent>(eventName: string, event: TEvent): void;
+}
+//# sourceMappingURL=events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/events.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD,MAAM,MAAM,QAAQ,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;AAEvD,qBAAa,YAAY;IACxB,OAAO,CAAC,SAAS,CAAyC;IAE1D,EAAE,CAAC,MAAM,GAAG,mBAAmB,EAC9B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC;IAQ3B,GAAG,CAAC,MAAM,GAAG,mBAAmB,EAC/B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC;IAU3B,IAAI,CAAC,MAAM,GAAG,mBAAmB,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAOnE"}

package/dist/src/events.js

@@ -0,0 +1,27 @@
+// (c) 2026 Meta Games LLC. All rights reserved.
+export class EventEmitter {
+    listeners = new Map();
+    on(eventName, listener) {
+        const listeners = this.listeners.get(eventName) || new Set();
+        listeners.add(listener);
+        this.listeners.set(eventName, listeners);
+        return () => this.off(eventName, listener);
+    }
+    off(eventName, listener) {
+        const listeners = this.listeners.get(eventName);
+        if (!listeners)
+            return;
+        listeners.delete(listener);
+        if (listeners.size === 0) {
+            this.listeners.delete(eventName);
+        }
+    }
+    emit(eventName, event) {
+        const listeners = this.listeners.get(eventName);
+        if (!listeners)
+            return;
+        for (const listener of listeners) {
+            listener(event);
+        }
+    }
+}

package/dist/src/http.d.ts

@@ -0,0 +1,12 @@
+export declare function normalizeApiBaseUrl(input: string): string;
+export declare function createWebSocketUrl(apiBaseUrl: string): string;
+export declare function requestWithBotToken<T>(args: {
+    fetchImpl: typeof fetch;
+    apiBaseUrl: string;
+    token: string;
+    path: string;
+    options?: Omit<RequestInit, "body"> & {
+        body?: unknown;
+    };
+}): Promise<T>;
+//# 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,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAK7D;AAED,wBAAsB,mBAAmB,CAAC,CAAC,EAAE,IAAI,EAAE;IAClD,SAAS,EAAE,OAAO,KAAK,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACzD,GAAG,OAAO,CAAC,CAAC,CAAC,CAqBb"}

package/dist/src/http.js

@@ -0,0 +1,28 @@
+// (c) 2026 Meta Games LLC. All rights reserved.
+export function normalizeApiBaseUrl(input) {
+    return input.replace(/\/+$/, "");
+}
+export function createWebSocketUrl(apiBaseUrl) {
+    const normalized = normalizeApiBaseUrl(apiBaseUrl);
+    const resolved = new URL("/v3/social/guild-bots/ws", `${normalized}/`);
+    resolved.protocol = resolved.protocol === "https:" ? "wss:" : "ws:";
+    return resolved.toString();
+}
+export async function requestWithBotToken(args) {
+    const endpoint = args.path.startsWith("/") ? args.path : `/${args.path}`;
+    const options = args.options || {};
+    const response = await args.fetchImpl(`${args.apiBaseUrl}${endpoint}`, {
+        method: options.method || "GET",
+        headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bot ${args.token}`,
+            ...(options.headers || {}),
+        },
+        body: options.body === undefined ? undefined : JSON.stringify(options.body),
+    });
+    const data = (await response.json().catch(() => ({})));
+    if (!response.ok || data.success === false) {
+        throw new Error(data.message || `Channel bot request failed (${response.status})`);
+    }
+    return data;
+}

package/dist/src/index.d.ts

@@ -0,0 +1,4 @@
+export { ChannelBotClient } from "./client";
+export { CommandContext, CommandRouter, messageInputFromInteraction, } from "./commands";
+export type { ChannelBotClientOptions, ChannelBotEmbed, ChannelBotEmbedField, ChannelBotMessage, ChannelBotMessageInput, GuildBotInteraction, GuildBotMeResponse, GuildBotSocketEvent, } from "./types";
+//# 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":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EACN,cAAc,EACd,aAAa,EACb,2BAA2B,GAC3B,MAAM,YAAY,CAAC;AACpB,YAAY,EACX,uBAAuB,EACvB,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,GACnB,MAAM,SAAS,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,3 @@
+// (c) 2026 Meta Games LLC. All rights reserved.
+export { ChannelBotClient } from "./client";
+export { CommandContext, CommandRouter, messageInputFromInteraction, } from "./commands";