botflare 0.1.0

package/dist/gateway.mjs

@@ -0,0 +1,289 @@
+import { i as sendMessage, n as interactionCallback } from "./discord-DEZe1asd.mjs";
+import { DurableObject } from "cloudflare:workers";
+// src/utils/intents.ts
+const BITS = {
+	Guilds: 1,
+	GuildMembers: 2,
+	GuildModeration: 4,
+	GuildExpressions: 8,
+	GuildIntegrations: 16,
+	GuildWebhooks: 32,
+	GuildInvites: 64,
+	GuildVoiceStates: 128,
+	GuildPresences: 256,
+	GuildMessages: 512,
+	GuildMessageReactions: 1024,
+	GuildMessageTyping: 2048,
+	DirectMessages: 4096,
+	DirectMessageReactions: 8192,
+	DirectMessageTyping: 16384,
+	MessageContent: 32768,
+	GuildScheduledEvents: 65536,
+	AutoModerationConfiguration: 1048576,
+	AutoModerationExecution: 2097152,
+	GuildMessagePolls: 16777216,
+	DirectMessagePolls: 33554432
+};
+function intentBits(names) {
+	return names.reduce((bits, name) => bits | BITS[name], 0);
+}
+// src/utils/shard.ts
+const DISPATCH = 0;
+const HEARTBEAT = 1;
+const IDENTIFY = 2;
+const PRESENCE_UPDATE = 3;
+const RESUME = 6;
+const RECONNECT = 7;
+const INVALID_SESSION = 9;
+const HELLO = 10;
+const HEARTBEAT_ACK = 11;
+const READY = "READY";
+const RESUMED = "RESUMED";
+const FATAL = /* @__PURE__ */ new Set([
+	4004,
+	4010,
+	4011,
+	4012,
+	4013,
+	4014
+]);
+const FRESH = /* @__PURE__ */ new Set([4007, 4009]);
+function afterClose(code) {
+	if (FATAL.has(code)) return "stop";
+	return FRESH.has(code) ? "identify" : "resume";
+}
+var Shard = class {
+	token;
+	identity;
+	hooks;
+	session;
+	acked = true;
+	stopBeat;
+	constructor(token, identity, session, hooks) {
+		this.token = token;
+		this.identity = identity;
+		this.session = session;
+		this.hooks = hooks;
+	}
+	handle(payload) {
+		switch (payload.op) {
+			case HELLO:
+				this.acked = true;
+				this.stopBeat?.();
+				this.stopBeat = this.hooks.every(payload.d.heartbeat_interval, () => this.beat());
+				if (this.session) this.hooks.send({
+					op: RESUME,
+					d: {
+						token: this.token,
+						session_id: this.session.id,
+						seq: this.session.seq ?? 0
+					}
+				});
+				else this.identify();
+				return;
+			case HEARTBEAT_ACK:
+				this.acked = true;
+				return;
+			case HEARTBEAT:
+				this.hooks.send({
+					op: HEARTBEAT,
+					d: this.session?.seq ?? null
+				});
+				return;
+			case RECONNECT:
+				this.hooks.reconnect(true);
+				return;
+			case INVALID_SESSION:
+				if (!payload.d) this.forget();
+				this.hooks.reconnect(payload.d);
+				return;
+			case DISPATCH: this.onDispatch(payload);
+		}
+	}
+	stop() {
+		this.stopBeat?.();
+		this.stopBeat = void 0;
+	}
+	forget() {
+		this.session = null;
+		this.hooks.save(null);
+	}
+	onDispatch(payload) {
+		if (payload.t === READY) this.session = {
+			id: payload.d.session_id,
+			url: payload.d.resume_gateway_url,
+			seq: payload.s,
+			intents: this.identity.intents
+		};
+		else if (this.session) this.session.seq = payload.s;
+		if (this.session) this.hooks.save(this.session);
+		if (payload.t === RESUMED && this.identity.presence) this.hooks.send({
+			op: PRESENCE_UPDATE,
+			d: this.identity.presence
+		});
+		this.hooks.dispatch(payload);
+	}
+	beat() {
+		if (!this.acked) {
+			this.hooks.reconnect(true);
+			return;
+		}
+		this.acked = false;
+		this.hooks.send({
+			op: HEARTBEAT,
+			d: this.session?.seq ?? null
+		});
+	}
+	identify() {
+		this.hooks.send({
+			op: IDENTIFY,
+			d: {
+				token: this.token,
+				intents: this.identity.intents,
+				properties: {
+					os: "cloudflare-workers",
+					browser: "botflare",
+					device: "botflare"
+				},
+				...this.identity.presence && { presence: this.identity.presence }
+			}
+		});
+	}
+};
+// src/gateway.ts
+const GATEWAY = "wss://gateway.discord.gg";
+const WATCH_MS = 6e4;
+const INTERACTION_CREATE = "INTERACTION_CREATE";
+/**
+* Creates a Durable Object class that keeps one connection to the Discord Gateway open and runs your
+* handler for each event. Export it under the `class_name` of a SQLite Durable Object binding in your
+* Wrangler config, and give that binding name to `bot({ gateway })` so a Cron Trigger starts and
+* reconnects it.
+* It reads `DISCORD_TOKEN` from the Worker environment.
+*
+* @param config What the bot listens to.
+* @param config.intents The names of the gateway intents the bot needs, such as `'GuildMessages'`.
+*   Turn on privileged ones, such as `'MessageContent'`, in the Developer Portal first.
+* @param config.presence The status the bot shows while it is connected.
+* @param config.events A handler per dispatch event name. `c.send` posts a message to a channel,
+*   with optional `buttons` and `embeds`.
+* @param config.onError Gets errors from event handlers and from answering interactions.
+* @param config.bot The bot from `bot()`. Its handlers answer the commands, buttons and modals that
+*   arrive over the gateway, so the application needs no Interactions Endpoint URL.
+* @returns The Durable Object class.
+* @example
+* import { bot } from 'botflare';
+* import { gateway } from 'botflare/gateway';
+*
+* const app = bot({ commands: [], gateway: 'GATEWAY' });
+*
+* export const Gateway = gateway({
+*   intents: ['Guilds', 'GuildMessages'],
+*   bot: app,
+*   events: { MESSAGE_CREATE: (message, c) => c.send(message.channel_id, 'heard you') },
+* });
+*
+* export default app;
+*/
+function gateway(config) {
+	return class Gateway extends DurableObject {
+		ws;
+		shard;
+		stopped = false;
+		async ensure() {
+			if (!await this.ctx.storage.getAlarm()) await this.ctx.storage.setAlarm(Date.now() + WATCH_MS);
+			if (!this.ws && !this.stopped) this.dial();
+		}
+		async alarm() {
+			await this.ensure();
+		}
+		dial() {
+			const identity = {
+				intents: intentBits(config.intents),
+				presence: config.presence
+			};
+			const stored = this.ctx.storage.kv.get("session");
+			const saved = stored?.intents === identity.intents ? stored : null;
+			const ws = new WebSocket(`${saved?.url ?? GATEWAY}/?v=10&encoding=json`);
+			const send = (channelId, content, options) => sendMessage(this.env.DISCORD_TOKEN, channelId, content, options);
+			const shard = new Shard(this.env.DISCORD_TOKEN, identity, saved, {
+				send: (payload) => ws.send(JSON.stringify(payload)),
+				reconnect: (resume) => {
+					if (this.ws !== ws) return;
+					this.drop();
+					ws.close(4e3);
+					this.after(resume ? "resume" : "identify");
+				},
+				save: (session) => session ? this.ctx.storage.kv.put("session", session) : this.ctx.storage.kv.delete("session"),
+				dispatch: (event) => {
+					if (event.t === INTERACTION_CREATE && config.bot) {
+						const { answer } = config.bot;
+						const respond = async () => {
+							try {
+								const after = [];
+								const response = await answer(event.d, {
+									waitUntil: (promise) => this.ctx.waitUntil(promise),
+									afterAnswer: (task) => after.push(task)
+								});
+								if (!response.ok) return;
+								const failed = await interactionCallback(event.d.id, event.d.token, response);
+								if (failed) await config.onError?.(failed, event.t);
+								else for (const task of after) this.ctx.waitUntil(task());
+							} catch (error) {
+								await config.onError?.(error, event.t);
+							}
+						};
+						this.ctx.waitUntil(respond());
+					}
+					const handler = config.events[event.t];
+					if (!handler) return;
+					const run = async () => {
+						try {
+							await handler(event.d, { send });
+						} catch (error) {
+							await config.onError?.(error, event.t);
+						}
+					};
+					this.ctx.waitUntil(run());
+				},
+				every: (ms, fn) => {
+					let interval = null;
+					const first = setTimeout(() => {
+						fn();
+						interval = setInterval(fn, ms);
+					}, ms * Math.random());
+					return () => {
+						clearTimeout(first);
+						clearInterval(interval);
+					};
+				}
+			});
+			this.ws = ws;
+			this.shard = shard;
+			ws.addEventListener("message", (event) => {
+				if (this.ws === ws) shard.handle(JSON.parse(String(event.data)));
+			});
+			ws.addEventListener("close", (event) => {
+				if (this.ws !== ws) return;
+				this.drop();
+				this.after(afterClose(event.code));
+			});
+		}
+		drop() {
+			this.shard?.stop();
+			this.shard = void 0;
+			this.ws = void 0;
+		}
+		after(next) {
+			if (next === "stop") {
+				this.stopped = true;
+				return;
+			}
+			if (next === "identify") this.ctx.storage.kv.delete("session");
+			setTimeout(() => this.dial(), 1e3 + Math.random() * 4e3);
+		}
+	};
+}
+export { gateway };
+
+//# sourceMappingURL=gateway.mjs.map

package/dist/gateway.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.mjs","names":[],"sources":["../src/utils/intents.ts","../src/utils/shard.ts","../src/gateway.ts"],"sourcesContent":["import type { GatewayIntentBits } from 'discord-api-types/v10';\n\nexport type Intent = Exclude<\n  keyof typeof GatewayIntentBits,\n  'GuildBans' | 'GuildEmojisAndStickers'\n>;\n\nconst BITS: Record<Intent, GatewayIntentBits> = {\n  Guilds: 1,\n  GuildMembers: 2,\n  GuildModeration: 4,\n  GuildExpressions: 8,\n  GuildIntegrations: 16,\n  GuildWebhooks: 32,\n  GuildInvites: 64,\n  GuildVoiceStates: 128,\n  GuildPresences: 256,\n  GuildMessages: 512,\n  GuildMessageReactions: 1024,\n  GuildMessageTyping: 2048,\n  DirectMessages: 4096,\n  DirectMessageReactions: 8192,\n  DirectMessageTyping: 16384,\n  MessageContent: 32768,\n  GuildScheduledEvents: 65536,\n  AutoModerationConfiguration: 1048576,\n  AutoModerationExecution: 2097152,\n  GuildMessagePolls: 16777216,\n  DirectMessagePolls: 33554432,\n};\n\nexport function intentBits(names: Intent[]): number {\n  return names.reduce((bits, name) => bits | BITS[name], 0);\n}\n","import type {\n  GatewayCloseCodes,\n  GatewayDispatchEvents,\n  GatewayDispatchPayload,\n  GatewayOpcodes,\n  GatewayPresenceUpdateData,\n  GatewayReceivePayload,\n  GatewaySendPayload,\n} from 'discord-api-types/v10';\n\nexport type Session = { id: string; url: string; seq: number | null; intents: number };\n\nconst DISPATCH: GatewayOpcodes.Dispatch = 0;\nconst HEARTBEAT: GatewayOpcodes.Heartbeat = 1;\nconst IDENTIFY: GatewayOpcodes.Identify = 2;\nconst PRESENCE_UPDATE: GatewayOpcodes.PresenceUpdate = 3;\nconst RESUME: GatewayOpcodes.Resume = 6;\nconst RECONNECT: GatewayOpcodes.Reconnect = 7;\nconst INVALID_SESSION: GatewayOpcodes.InvalidSession = 9;\nconst HELLO: GatewayOpcodes.Hello = 10;\nconst HEARTBEAT_ACK: GatewayOpcodes.HeartbeatAck = 11;\n\nconst READY = 'READY' as GatewayDispatchEvents.Ready;\nconst RESUMED = 'RESUMED' as GatewayDispatchEvents.Resumed;\n\nconst FATAL = new Set<GatewayCloseCodes>([4004, 4010, 4011, 4012, 4013, 4014]);\nconst FRESH = new Set<GatewayCloseCodes>([4007, 4009]);\n\nexport function afterClose(code: number): 'stop' | 'identify' | 'resume' {\n  if (FATAL.has(code)) return 'stop';\n\n  return FRESH.has(code) ? 'identify' : 'resume';\n}\n\ntype Identity = { intents: number; presence?: GatewayPresenceUpdateData };\n\ntype Hooks = {\n  send: (payload: GatewaySendPayload) => void;\n  reconnect: (resume: boolean) => void;\n  save: (session: Session | null) => void;\n  dispatch: (event: GatewayDispatchPayload) => void;\n  every: (ms: number, fn: () => void) => () => void;\n};\n\nexport class Shard {\n  private readonly token: string;\n  private readonly identity: Identity;\n  private readonly hooks: Hooks;\n  private session: Session | null;\n  private acked = true;\n  private stopBeat: (() => void) | undefined;\n\n  constructor(token: string, identity: Identity, session: Session | null, hooks: Hooks) {\n    this.token = token;\n    this.identity = identity;\n    this.session = session;\n    this.hooks = hooks;\n  }\n\n  handle(payload: GatewayReceivePayload): void {\n    switch (payload.op) {\n      case HELLO: {\n        this.acked = true;\n        this.stopBeat?.();\n        this.stopBeat = this.hooks.every(payload.d.heartbeat_interval, () => this.beat());\n\n        if (this.session) {\n          this.hooks.send({\n            op: RESUME,\n            d: { token: this.token, session_id: this.session.id, seq: this.session.seq ?? 0 },\n          });\n        } else {\n          this.identify();\n        }\n        return;\n      }\n      case HEARTBEAT_ACK:\n        this.acked = true;\n        return;\n      case HEARTBEAT:\n        this.hooks.send({ op: HEARTBEAT, d: this.session?.seq ?? null });\n        return;\n      case RECONNECT:\n        this.hooks.reconnect(true);\n        return;\n      case INVALID_SESSION:\n        if (!payload.d) this.forget();\n        this.hooks.reconnect(payload.d);\n        return;\n      case DISPATCH:\n        this.onDispatch(payload);\n    }\n  }\n\n  stop(): void {\n    this.stopBeat?.();\n    this.stopBeat = undefined;\n  }\n\n  private forget(): void {\n    this.session = null;\n    this.hooks.save(null);\n  }\n\n  private onDispatch(payload: GatewayDispatchPayload): void {\n    if (payload.t === READY) {\n      this.session = {\n        id: payload.d.session_id,\n        url: payload.d.resume_gateway_url,\n        seq: payload.s,\n        intents: this.identity.intents,\n      };\n    } else if (this.session) {\n      this.session.seq = payload.s;\n    }\n    if (this.session) this.hooks.save(this.session);\n\n    if (payload.t === RESUMED && this.identity.presence) {\n      this.hooks.send({ op: PRESENCE_UPDATE, d: this.identity.presence });\n    }\n\n    this.hooks.dispatch(payload);\n  }\n\n  private beat(): void {\n    if (!this.acked) {\n      this.hooks.reconnect(true);\n      return;\n    }\n\n    this.acked = false;\n    this.hooks.send({ op: HEARTBEAT, d: this.session?.seq ?? null });\n  }\n\n  private identify(): void {\n    this.hooks.send({\n      op: IDENTIFY,\n      d: {\n        token: this.token,\n        intents: this.identity.intents,\n        properties: { os: 'cloudflare-workers', browser: 'botflare', device: 'botflare' },\n        ...(this.identity.presence && { presence: this.identity.presence }),\n      },\n    });\n  }\n}\n","import { DurableObject } from 'cloudflare:workers';\nimport type {\n  GatewayDispatchEvents,\n  GatewayDispatchPayload,\n  GatewayPresenceUpdateData,\n  GatewayReceivePayload,\n} from 'discord-api-types/v10';\n\nimport type { Bot } from '#bot';\nimport { interactionCallback, type Send, sendMessage } from '#lib/discord';\nimport type { ErrorHandler } from '#types';\nimport { type Intent, intentBits } from '#utils/intents';\nimport { afterClose, type Session, Shard } from '#utils/shard';\n\nconst GATEWAY = 'wss://gateway.discord.gg';\nconst WATCH_MS = 60_000;\nconst INTERACTION_CREATE = 'INTERACTION_CREATE' as GatewayDispatchEvents.InteractionCreate;\n\ntype GatewayConfig = {\n  intents: Intent[];\n  presence?: GatewayPresenceUpdateData;\n  bot?: Pick<Bot, 'answer'>;\n  onError?: ErrorHandler;\n  events: {\n    [P in GatewayDispatchPayload as P['t']]?: (data: P['d'], c: { send: Send }) => unknown;\n  };\n};\n\n/**\n * Creates a Durable Object class that keeps one connection to the Discord Gateway open and runs your\n * handler for each event. Export it under the `class_name` of a SQLite Durable Object binding in your\n * Wrangler config, and give that binding name to `bot({ gateway })` so a Cron Trigger starts and\n * reconnects it.\n * It reads `DISCORD_TOKEN` from the Worker environment.\n *\n * @param config What the bot listens to.\n * @param config.intents The names of the gateway intents the bot needs, such as `'GuildMessages'`.\n *   Turn on privileged ones, such as `'MessageContent'`, in the Developer Portal first.\n * @param config.presence The status the bot shows while it is connected.\n * @param config.events A handler per dispatch event name. `c.send` posts a message to a channel,\n *   with optional `buttons` and `embeds`.\n * @param config.onError Gets errors from event handlers and from answering interactions.\n * @param config.bot The bot from `bot()`. Its handlers answer the commands, buttons and modals that\n *   arrive over the gateway, so the application needs no Interactions Endpoint URL.\n * @returns The Durable Object class.\n * @example\n * import { bot } from 'botflare';\n * import { gateway } from 'botflare/gateway';\n *\n * const app = bot({ commands: [], gateway: 'GATEWAY' });\n *\n * export const Gateway = gateway({\n *   intents: ['Guilds', 'GuildMessages'],\n *   bot: app,\n *   events: { MESSAGE_CREATE: (message, c) => c.send(message.channel_id, 'heard you') },\n * });\n *\n * export default app;\n */\nexport function gateway(\n  config: GatewayConfig,\n): new (\n  ctx: DurableObjectState,\n  env: { DISCORD_TOKEN: string },\n) => DurableObject<{ DISCORD_TOKEN: string }> & { ensure(): Promise<void> } {\n  return class Gateway extends DurableObject<{ DISCORD_TOKEN: string }> {\n    private ws: WebSocket | undefined;\n    private shard: Shard | undefined;\n    private stopped = false;\n\n    async ensure(): Promise<void> {\n      if (!(await this.ctx.storage.getAlarm()))\n        await this.ctx.storage.setAlarm(Date.now() + WATCH_MS);\n\n      if (!this.ws && !this.stopped) this.dial();\n    }\n\n    override async alarm(): Promise<void> {\n      await this.ensure();\n    }\n\n    private dial(): void {\n      const identity = { intents: intentBits(config.intents), presence: config.presence };\n      const stored = this.ctx.storage.kv.get<Session>('session');\n      const saved = stored?.intents === identity.intents ? stored : null;\n\n      const ws = new WebSocket(`${saved?.url ?? GATEWAY}/?v=10&encoding=json`);\n      const send: Send = (channelId, content, options) =>\n        sendMessage(this.env.DISCORD_TOKEN, channelId, content, options);\n\n      const shard = new Shard(this.env.DISCORD_TOKEN, identity, saved, {\n        send: (payload) => ws.send(JSON.stringify(payload)),\n        reconnect: (resume) => {\n          if (this.ws !== ws) return;\n\n          this.drop();\n          ws.close(4000);\n          this.after(resume ? 'resume' : 'identify');\n        },\n        save: (session) =>\n          session\n            ? this.ctx.storage.kv.put('session', session)\n            : this.ctx.storage.kv.delete('session'),\n        dispatch: (event) => {\n          if (event.t === INTERACTION_CREATE && config.bot) {\n            const { answer } = config.bot;\n            const respond = async (): Promise<void> => {\n              try {\n                const after: (() => Promise<void>)[] = [];\n                const response = await answer(event.d, {\n                  waitUntil: (promise) => this.ctx.waitUntil(promise),\n                  afterAnswer: (task) => after.push(task),\n                });\n                if (!response.ok) return;\n\n                const failed = await interactionCallback(event.d.id, event.d.token, response);\n                if (failed) await config.onError?.(failed, event.t);\n                else for (const task of after) this.ctx.waitUntil(task());\n              } catch (error) {\n                await config.onError?.(error, event.t);\n              }\n            };\n            this.ctx.waitUntil(respond());\n          }\n\n          const handler = config.events[event.t] as\n            | ((data: unknown, c: { send: typeof send }) => unknown)\n            | undefined;\n          if (!handler) return;\n\n          const run = async (): Promise<void> => {\n            try {\n              await handler(event.d, { send });\n            } catch (error) {\n              await config.onError?.(error, event.t);\n            }\n          };\n          this.ctx.waitUntil(run());\n        },\n        every: (ms, fn) => {\n          let interval: ReturnType<typeof setInterval> | null = null;\n          const first = setTimeout(() => {\n            fn();\n            interval = setInterval(fn, ms);\n          }, ms * Math.random());\n\n          return () => {\n            clearTimeout(first);\n            clearInterval(interval);\n          };\n        },\n      });\n\n      this.ws = ws;\n      this.shard = shard;\n\n      ws.addEventListener('message', (event) => {\n        if (this.ws === ws) shard.handle(JSON.parse(String(event.data)) as GatewayReceivePayload);\n      });\n      ws.addEventListener('close', (event) => {\n        if (this.ws !== ws) return;\n\n        this.drop();\n        this.after(afterClose(event.code));\n      });\n    }\n\n    private drop(): void {\n      this.shard?.stop();\n      this.shard = undefined;\n      this.ws = undefined;\n    }\n\n    private after(next: 'stop' | 'identify' | 'resume'): void {\n      if (next === 'stop') {\n        this.stopped = true;\n        return;\n      }\n\n      if (next === 'identify') this.ctx.storage.kv.delete('session');\n      setTimeout(() => this.dial(), 1000 + Math.random() * 4000);\n    }\n  };\n}\n"],"mappings":"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"}

package/dist/index.d.mts

@@ -0,0 +1,239 @@
+import { C as Locales, S as Suggestion, _ as AutocompleteContext, a as Select, b as OptionValue, c as Access, d as ContextMenu, f as MenuContext, g as SelectType, h as Modal, i as ErrorHandler, l as Command, m as Fields, n as bot, o as SelectContext, p as MenuType, s as SelectValue, t as Bot, u as Context, v as ChannelType, w as Routes, x as Options, y as Option } from "./bot-icKel3r9.mjs";
+import { Locale } from "discord-api-types/v10";
+/**
+ * Declares a slash command and the handler that answers it. To split a command into subcommands,
+ * such as `/config get` and `/config set`, pass `subcommands` instead of `options` and `run`: a list
+ * of commands made with `command()`. A subcommand that has `subcommands` of its own becomes a group,
+ * such as `/config role add`. Discord allows one group level only.
+ *
+ * @param config What Discord shows for the command.
+ * @param config.name The name the user types after `/`.
+ * @param config.description The text Discord shows under the name.
+ * @param config.options The options, keyed by name, made with {@link option}.
+ * @param config.permissions Who sees the command by default: members with all of these
+ *   permissions, such as `['ManageGuild']`. Pass `[]` to show it to admins only. Server admins can
+ *   change this in Server Settings. Applies to a top-level command only.
+ * @param config.contexts Where the command shows: `guild`, `bot_dm` or `private_channel`.
+ * @param config.installs How the app must be installed for the command: `guild` or `user`.
+ * @param config.locales The name and description in other languages, keyed by Discord locale,
+ *   such as `{ th: { name: 'ทอย', description: 'ทอยลูกเต๋า' } }`. The handler still gets the
+ *   default name.
+ * @param run Answers the command. It gets the interaction, the typed option values, `reply`
+ *   for an answer within 3 seconds and `defer` for work that takes longer. Pass
+ *   `{ ephemeral: true }` to either so only the user who ran the command sees the answer, `buttons`
+ *   to add buttons and `embeds` to add embeds. Messages ping nobody, even for `@everyone` or `<@id>`
+ *   in the text. To ping, pass `allowedMentions`, such as `{ users: [id] }` or `{ parse: ['roles'] }`. The work of `defer` returns the text, or
+ *   `{ content, buttons, embeds }`.
+ *
+ *   To send more after the first answer, call `c.after(work)` before you return it. `work` runs once
+ *   Discord has the answer, and can call `c.followUp(text, options)` for a new message,
+ *   `c.editReply(text, options)` and `c.deleteReply()`. Each returns an `Error` if Discord refuses.
+ *   The work of `defer` can call them too. Buttons, select menus, modals and context menus have them.
+ * @returns The command, for the `commands` of {@link bot}.
+ * @example
+ * const greet = command(
+ *   { name: 'greet', description: 'Say hi', options: { name: option('string', { description: 'Who', required: true }) } },
+ *   (c) => c.reply(`hi ${c.options.name}`),
+ * );
+ */
+export declare function command<const O extends Options = never>(config: {
+  name: string;
+  description: string;
+  options?: O;
+} & Access, run: (c: Context<O>) => Response | Promise<Response>): Command<O>;
+export declare function command(config: {
+  name: string;
+  description: string;
+  subcommands: Command[];
+} & Access): Command;
+/**
+ * Declares a context menu command: an item in the Apps menu when the user right-clicks a user or a
+ * message. Add it to the `commands` of {@link bot}, next to the slash commands. It has no options
+ * and no description. The handler gets the user or the message as `c.target`.
+ *
+ * @param menu Whether the item shows on a `user` or on a `message`.
+ * @param config What Discord shows.
+ * @param config.name The name of the item, such as `Report message`.
+ * @param config.permissions Who sees the item by default, as in {@link command}.
+ * @param config.contexts Where the item shows, as in {@link command}.
+ * @param config.installs How the app must be installed for the item, as in {@link command}.
+ * @param config.locales The name in other languages, keyed by Discord locale.
+ * @param run Answers the click, with `reply`, `defer` and `modal` as in a slash command.
+ * @returns The context menu command, for the `commands` of {@link bot}.
+ * @example
+ * const avatar = contextMenu('user', { name: 'Show avatar' }, (c) => c.reply(c.target.username));
+ */
+export declare function contextMenu<const T extends MenuType>(menu: T, config: {
+  name: string;
+  locales?: Partial<Record<`${Locale}`, {
+    name: string;
+  }>>;
+} & Omit<Access, "locales">, run: (c: MenuContext<T>) => Response | Promise<Response>): ContextMenu<T>;
+type Id = string | {
+  id: string;
+};
+/**
+ * Writes a mention for message text. A mention shows as a link to the user, role, channel or
+ * command. It pings nobody unless the message allows it with `allowedMentions`.
+ *
+ * @example
+ * c.reply(`${mention.user(c.interaction.member.user)} joined ${mention.channel('123')}`);
+ */
+export declare const mention: {
+  user: (user: Id) => string;
+  role: (role: Id) => string;
+  channel: (channel: Id) => string;
+  command: (name: string, id: string) => string;
+};
+declare const STYLE: {
+  readonly "short-time": "t";
+  readonly "long-time": "T";
+  readonly "short-date": "d";
+  readonly "long-date": "D";
+  readonly short: "f";
+  readonly long: "F";
+  readonly relative: "R";
+};
+/**
+ * Writes a timestamp for message text. Discord shows it in the time zone and language of each
+ * reader.
+ *
+ * @param date The moment, as a `Date` or as milliseconds since 1970, such as `Date.now()`.
+ * @param style How Discord shows it: `short` (default, such as "5 November 2026 12:30"), `long`,
+ *   `short-date`, `long-date`, `short-time`, `long-time` or `relative` (such as "in 2 hours").
+ * @returns The timestamp markup, such as `<t:1762338600:R>`.
+ * @example
+ * c.reply(`The event starts ${time(start, 'relative')}`);
+ */
+export declare function time(date: Date | number, style?: keyof typeof STYLE): string;
+/**
+ * Declares a modal: a form Discord shows in a popup. Open it with `c.modal()` from a command or a
+ * button, and add it to the `modals` of {@link bot} so the bot gets what the user typed.
+ *
+ * @param config What Discord shows in the popup.
+ * @param config.id The id Discord sends back when the user submits the form.
+ * @param config.title The title of the popup.
+ * @param config.fields The text fields, keyed by name. A field is required unless `required` is `false`.
+ * @param run Answers the submitted form. `c.fields` holds the text of each field, keyed by name.
+ *   A field that is not required and left empty is `undefined`.
+ *   To carry a value through the form, open it with `c.modal(form, value)`. The handler gets that
+ *   value as `c.value`, such as the id of the item the form edits.
+ * @returns The modal, for `c.modal()` and the `modals` of {@link bot}.
+ * @example
+ * const feedback = modal(
+ *   { id: 'feedback', title: 'Feedback', fields: { text: { label: 'Your idea', style: 'paragraph' } } },
+ *   (c) => c.reply(`Thanks: ${c.fields.text}`),
+ * );
+ */
+export declare function modal<const F extends Fields>(config: {
+  id: string;
+  title: string;
+  fields: F;
+}, run: Modal<F>["run"]): Modal<F>;
+type OptionLimits<T extends keyof OptionValue> = T extends "string" ? {
+  minLength?: number;
+  maxLength?: number;
+} : T extends "integer" | "number" ? {
+  min?: number;
+  max?: number;
+} : T extends "channel" ? {
+  channelTypes?: ChannelType[];
+} : unknown;
+type Choice<T extends keyof OptionValue> = T extends "string" ? string : T extends "integer" | "number" ? number : never;
+/**
+ * Declares one option of a slash command. The handler reads its value from `c.options`,
+ * typed from `type`, and `undefined` when the option is not `required`.
+ *
+ * A `string`, `integer` or `number` option also takes `choices`, keyed by the label Discord shows.
+ * The user can pick only those, and the handler gets one of their values. A `string` option takes
+ * `minLength` and `maxLength`, an `integer` or `number` option takes `min` and `max`, and a
+ * `channel` option takes `channelTypes`, such as `['text', 'forum']`.
+ *
+ * Instead of fixed `choices`, a `string`, `integer` or `number` option can take `autocomplete`: a
+ * function that gets what the user has typed so far as `c.value` and returns up to 25 suggestions,
+ * as plain values or as `{ name, value }`. If it throws, `onError` gets the error and Discord shows
+ * no suggestions.
+ *
+ * @param type The value type Discord asks the user for. `user`, `channel` and `role` give the full
+ *   object Discord sends with the command, not only its id.
+ * @param config How Discord shows the option.
+ * @param config.description The text Discord shows under the option name.
+ * @param config.required Whether the user must fill it in. Defaults to `false`.
+ * @param config.locales The name and description in other languages, keyed by Discord locale.
+ * @returns The option, for the `options` of {@link command}.
+ * @example
+ * option('integer', { description: 'How many dice', required: true, min: 1, max: 6 });
+ * option('string', { description: 'Color', choices: { Red: 'red', Blue: 'blue' } });
+ */
+export declare function option<const T extends keyof OptionValue, const R extends boolean = false, const C extends Record<string, Choice<T>> = never>(type: T, config: {
+  description: string;
+  required?: R;
+  choices?: C;
+  locales?: Locales;
+} & OptionLimits<T> & {
+  autocomplete?: [Choice<T>] extends [never] ? never : [C] extends [never] ? (c: AutocompleteContext) => Suggestion<Choice<T>>[] | Promise<Suggestion<Choice<T>>[]> : never;
+}): Option<T, R, [C] extends [never] ? OptionValue[T] : C[keyof C]>;
+type Method = "get" | "post" | "put" | "patch" | "delete";
+type Route<M extends Method> = { [K in keyof Routes]: M extends keyof Routes[K] ? K : never; }[keyof Routes];
+type Operation<P extends keyof Routes, M extends Method> = Routes[P] extends Record<M, infer O extends {
+  args: unknown[];
+  result: unknown;
+}> ? O : never;
+type Result<P extends keyof Routes, M extends Method> = Promise<[Error, null] | [null, Operation<P, M>["result"]]>;
+/** Calls the Discord REST API. Each method takes a route from the Discord API spec. */
+type Rest = { [M in Method]: <P extends Route<M>>(path: P, ...args: Operation<P, M>["args"]) => Result<P, M>; };
+/**
+ * Calls the Discord REST API as the bot, with `DISCORD_TOKEN` from the Worker environment. Each
+ * method takes a route from the Discord API spec, such as `'/guilds/{guild_id}/roles'`, and
+ * types its `path`, `query`, `body` and result from that route. It returns `[error, data]` and
+ * does not throw. When Discord answers 429, it waits for `retry_after` and tries again, up to
+ * three tries in all.
+ *
+ * A request that is not a GET takes `reason`, the text that shows in the audit log of the server.
+ *
+ * @example
+ * import { rest } from 'botflare';
+ *
+ * const [error, member] = await rest.get('/guilds/{guild_id}/members/{user_id}', {
+ *   path: { guild_id: guildId, user_id: userId },
+ * });
+ * if (!error) await rest.put('/guilds/{guild_id}/members/{user_id}/roles/{role_id}', {
+ *   path: { guild_id: guildId, user_id: member.user.id, role_id: roleId },
+ * });
+ */
+export declare const rest: Rest;
+/**
+ * Declares a select menu and the handler that runs when the user picks from it. Put it in the
+ * `selects` of a message, such as `c.reply('Pick one', { selects: [menu] })`, and in the `selects` of
+ * {@link bot} so the bot gets the pick. Each menu takes a row of its own, above the buttons.
+ *
+ * A `string` menu lists `options`, keyed by the label Discord shows, and the handler gets the picked
+ * values. A `user`, `role`, `channel` or `mentionable` menu lets the user pick from the server, and
+ * the handler gets the full objects Discord resolved. A `channel` menu takes `channelTypes`.
+ *
+ * @param type What the user picks from.
+ * @param config How Discord shows the menu.
+ * @param config.id The id Discord sends back with the pick.
+ * @param config.placeholder The text the menu shows before a pick.
+ * @param config.min The fewest items the user must pick. Defaults to 1.
+ * @param config.max The most items the user can pick. Defaults to 1.
+ * @param run Answers the pick. `c.values` holds the picked items.
+ * @returns The select menu.
+ * @example
+ * const fruit = select('string', { id: 'fruit', options: { Apple: 'apple', Mango: 'mango' } }, (c) =>
+ *   c.update(`picked ${c.values.join(', ')}`),
+ * );
+ */
+export declare function select<const T extends SelectType, const O extends Record<string, T extends "string" ? string : never> = never>(type: T, config: {
+  id: string;
+  placeholder?: string;
+  min?: number;
+  max?: number;
+  options?: O;
+} & (T extends "string" ? {
+  options: unknown;
+} : unknown) & (T extends "channel" ? {
+  channelTypes?: ChannelType[];
+} : unknown), run: (c: SelectContext<[O] extends [never] ? SelectValue[T] : O[keyof O]>) => Response | Promise<Response>): Select<T, [O] extends [never] ? SelectValue[T] : O[keyof O]>;
+export { type Bot, type ErrorHandler, type Select, type SelectContext, type SelectValue, bot };
+//# sourceMappingURL=index.d.mts.map