lunibee 0.1.1 → 0.1.2

package/README.md

@@ -1,11 +1,229 @@
-# @lunibee/lunibee
-
-> Part of the lunibee ecosystem.
-
-## Basic use
-
-```ts
-import { ... } from '@lunibee/lunibee';
-
-// Example basic usage
-```
+# Lunibee 🐝
+
+A lightweight, Bun-first Discord API library for TypeScript.
+
+## Production-readiness status
+
+Lunibee's production-readiness work is being developed on `feat/production-readiness`. **Do not use `master` for active development.**
+
+The roadmap covers:
+
+- strict package dependency boundaries and installability
+- Discord Gateway lifecycle, heartbeat ACK handling, resume/reconnect, and zombie detection
+- canonical resource caching and shared REST/Gateway hydration
+- bucket-aware REST rate limits, retries, timeouts, and `AbortSignal` cancellation
+- typed permissions and ergonomic interaction APIs
+- compile-time-safe component and embed builders
+- graceful client and shard shutdown
+- public API documentation
+
+## Requirements
+
+- [Bun](https://bun.sh/) for the supported runtime and package manager
+- TypeScript for typed application development
+- A Discord bot token for connecting to Discord
+
+## Installation
+
+For repository development:
+
+```bash
+bun install
+```
+
+For application usage, install the published `lunibee` package when a release is available:
+
+```bash
+bun add lunibee
+```
+
+## Getting started
+
+```ts
+import { Client, GatewayIntentBits } from "lunibee";
+
+const client = new Client({
+    token: process.env.DISCORD_TOKEN!,
+    intents: GatewayIntentBits.Guilds | GatewayIntentBits.GuildMessages
+});
+
+client.on("ready", user => {
+    console.log(`Ready as ${user.username}`);
+});
+
+client.on("messageCreate", message => {
+    console.log(message.content);
+});
+
+await client.login();
+```
+
+Destroy the client when the application is shutting down:
+
+```ts
+client.destroy();
+```
+
+## Client
+
+`Client` is the main application entry point. It coordinates the REST transport, resource managers, Gateway, event dispatch, interactions, and lifecycle state.
+
+### Lifecycle
+
+```text
+idle → connecting → ready
+  ↑                 ↓
+  └──── reconnect ──┘
+
+ready → destroyed
+```
+
+Useful APIs include:
+
+- `client.login()` — authenticate and connect to Discord.
+- `client.isReady()` — type guard for a ready client.
+- `client.destroy()` — close the Gateway and clear client-managed resources.
+- `client.rest` — access the REST transport.
+- `client.users`, `client.guilds`, `client.channels` — resource managers.
+
+## Gateway
+
+The Gateway package implements the Discord WebSocket lifecycle:
+
+```text
+CONNECT → HELLO → IDENTIFY/RESUME → READY → DISPATCH
+                              ↘ HEARTBEAT / ACK
+                                      ↓
+                                  RECONNECT
+```
+
+The Gateway tracks sequence numbers and sessions, handles Discord resume URLs, heartbeat acknowledgement timeouts, invalid sessions, server reconnect requests, and stale/zombie connections.
+
+```ts
+import { Gateway } from "@lunibee/ws";
+
+const gateway = new Gateway({
+    token: process.env.DISCORD_TOKEN!,
+    intents: 513
+});
+
+await gateway.connect();
+```
+
+## REST
+
+The REST client supports Discord bucket-aware rate limiting and retries. It consumes Discord's rate-limit headers including bucket identifiers, remaining requests, reset information, and `Retry-After`.
+
+Requests accept an `AbortSignal`:
+
+```ts
+const controller = new AbortController();
+
+const request = client.rest.get("/users/@me", {
+    signal: controller.signal
+});
+
+controller.abort();
+await request;
+```
+
+`RESTError` includes HTTP status, Discord error code, method, path, and the raw error payload when available.
+
+## Structures and caching
+
+Resource managers maintain canonical instances by Discord resource ID. Re-resolving an already cached resource returns the same structure instance, allowing identity-sensitive application code to remain consistent.
+
+REST-created and Gateway-updated resources are routed through manager cache mutation APIs so the same resource is not represented by unrelated structure instances.
+
+## Permissions
+
+`PermissionsBitField` provides named and raw permission checks:
+
+```ts
+if (member.permissions.has("ManageMessages")) {
+    // permitted
+}
+```
+
+Multiple permissions can be checked together, and immutable `add()` / `remove()` operations return a new bitfield.
+
+## Interactions
+
+Interactions expose an ergonomic acknowledgement lifecycle:
+
+```ts
+if (interaction.isChatInputCommand()) {
+    await interaction.deferReply();
+    await interaction.editReply({ content: "Done!" });
+    await interaction.followUp({ content: "Follow-up" });
+}
+```
+
+Available lifecycle methods include `reply()`, `deferReply()`, `editReply()`, `deleteReply()`, and `followUp()`.
+
+## Builders
+
+Lunibee provides strict builders for Discord payloads, including:
+
+- `EmbedBuilder`
+- `ButtonBuilder`
+- `ActionRowBuilder`
+- `StringSelectBuilder`
+- `EntitySelectBuilder`
+- `ModalBuilder`
+- `TextInputBuilder`
+
+Builders validate Discord limits before serialization and expose typed `toJSON()` payloads.
+
+## Sharding
+
+`@lunibee/sharding` manages multiple Gateway connections and supports explicit shard counts or Discord's recommended shard count.
+
+```ts
+import { ShardManager } from "@lunibee/sharding";
+
+const shards = new ShardManager({
+    token: process.env.DISCORD_TOKEN!,
+    intents: 513,
+    shardCount: "auto"
+});
+
+await shards.connect();
+```
+
+Call `destroy()` during shutdown. The manager releases its Gateway instances and can initialize a fresh shard set on a later `connect()`.
+
+## Package layout
+
+The monorepo is organized into focused packages:
+
+| Package | Responsibility |
+| --- | --- |
+| `@lunibee/types` | Discord API and shared TypeScript types |
+| `@lunibee/structures` | Discord resource and interaction structures |
+| `@lunibee/managers` | Resource caches and REST-backed managers |
+| `@lunibee/rest` | HTTP transport, routes, rate limits, retries |
+| `@lunibee/ws` | Discord Gateway connection |
+| `@lunibee/core` | Main client and high-level orchestration |
+| `@lunibee/builders` | Typed Discord payload builders |
+| `@lunibee/sharding` | Multi-Gateway shard management |
+| `lunibee` | End-user package entry point |
+
+## Development
+
+Run the repository's checks before submitting changes:
+
+```bash
+bun install
+bunx tsc --noEmit
+```
+
+Keep production-readiness work on the active feature branch and commit each completed phase separately. Changes must not be made directly on `master`.
+
+## API reference
+
+The source is the authoritative API surface while Lunibee remains pre-1.0. Public exports are intentionally split by responsibility so applications can import either the high-level `lunibee` package or individual packages when appropriate.
+
+## Status
+
+Lunibee is in active development and the API may change before the first stable release.

package/dist/builders/attachment.d.ts

@@ -0,0 +1,20 @@
+export interface AttachmentData {
+    name: string;
+    description?: string;
+    file: Uint8Array | ArrayBuffer | Blob | Buffer | string;
+}
+/** Builder for message attachments and file uploads. */
+export declare class AttachmentBuilder {
+    name: string;
+    description?: string;
+    file: Uint8Array | ArrayBuffer | Blob | Buffer | string;
+    constructor(file: Uint8Array | ArrayBuffer | Blob | Buffer | string, data?: Partial<Omit<AttachmentData, "file">> | string);
+    /** Sets the attachment filename. */
+    setName(name: string): this;
+    /** Sets the attachment description / alt text. */
+    setDescription(description: string): this;
+    /** Sets the file contents. */
+    setFile(file: Uint8Array | ArrayBuffer | Blob | Buffer | string): this;
+    /** Resolves the attachment payload to a binary Uint8Array. */
+    toBuffer(): Promise<Uint8Array>;
+}

package/dist/builders/commands.d.ts

@@ -0,0 +1,118 @@
+/** Discord application command option types. */
+export declare const ApplicationCommandOptionType: {
+    readonly Subcommand: 1;
+    readonly SubcommandGroup: 2;
+    readonly String: 3;
+    readonly Integer: 4;
+    readonly Boolean: 5;
+    readonly User: 6;
+    readonly Channel: 7;
+    readonly Role: 8;
+    readonly Mentionable: 9;
+    readonly Number: 10;
+    readonly Attachment: 11;
+};
+/** Builds Discord application command payloads. */
+export declare class SlashCommandBuilder {
+    #private;
+    /** Sets the command name. */ setName(name: string): this;
+    /** Sets the command description. */ setDescription(description: string): this;
+    /** Sets whether the command is available in direct messages. */ setDMPermission(enabled: boolean): this;
+    /** Sets whether the command is NSFW. */
+    setNSFW(nsfw?: boolean): this;
+    /** Sets whether the command is NSFW. */
+    setNsfw(nsfw?: boolean): this;
+    /** Sets command default member permissions. */ setDefaultMemberPermissions(permissions: bigint | number | string | null): this;
+    /** Sets command integration types. */ setIntegrationTypes(...types: number[]): this;
+    /** Adds a string option. */ addStringOption(configure: (option: StringOptionBuilder) => StringOptionBuilder): this;
+    /** Adds an integer option. */ addIntegerOption(configure: (option: IntegerOptionBuilder) => IntegerOptionBuilder): this;
+    /** Adds a number option. */ addNumberOption(configure: (option: NumberOptionBuilder) => NumberOptionBuilder): this;
+    /** Adds a boolean option. */ addBooleanOption(configure: (option: BooleanOptionBuilder) => BooleanOptionBuilder): this;
+    /** Adds a user option. */ addUserOption(configure: (option: UserOptionBuilder) => UserOptionBuilder): this;
+    /** Adds a channel option. */ addChannelOption(configure: (option: ChannelOptionBuilder) => ChannelOptionBuilder): this;
+    /** Adds a role option. */ addRoleOption(configure: (option: RoleOptionBuilder) => RoleOptionBuilder): this;
+    /** Adds a mentionable option. */ addMentionableOption(configure: (option: MentionableOptionBuilder) => MentionableOptionBuilder): this;
+    /** Adds an attachment option. */ addAttachmentOption(configure: (option: AttachmentOptionBuilder) => AttachmentOptionBuilder): this;
+    /** Adds a subcommand. */ addSubcommand(configure: (option: SubcommandBuilder) => SubcommandBuilder): this;
+    /** Adds a subcommand group. */ addSubcommandGroup(configure: (option: SubcommandGroupBuilder) => SubcommandGroupBuilder): this;
+    /** Serializes the command payload. */ toJSON(): Record<string, unknown>;
+    /** Adds a validated top-level command option. */ protected addOption(option: CommandOptionBuilder): this;
+}
+/** Base builder for command options. */
+export declare class CommandOptionBuilder {
+    protected readonly data: Record<string, unknown>;
+    /** Creates an option builder. */ constructor(type: number);
+    /** Sets the option name. */ setName(name: string): this;
+    /** Sets the option description. */ setDescription(description: string): this;
+    /** Makes the option required or optional. */ setRequired(required?: boolean): this;
+    /** Sets autocomplete. */ setAutocomplete(enabled?: boolean): this;
+    /** Serializes the option payload. */ toJSON(): Record<string, unknown>;
+}
+/** Builds a string command option. */
+export declare class StringOptionBuilder extends CommandOptionBuilder {
+    /** Creates a string option. */ constructor();
+    /** Adds string choices. */ addChoices(...choices: Array<{
+        name: string;
+        value: string;
+    }>): this;
+    /** Sets the minimum string length. */ setMinLength(value: number): this;
+    /** Sets the maximum string length. */ setMaxLength(value: number): this;
+}
+/** Builds an integer command option. */
+export declare class IntegerOptionBuilder extends CommandOptionBuilder {
+    constructor();
+    setMinValue(value: number): this;
+    setMaxValue(value: number): this;
+    setAutocomplete(enabled?: boolean): this;
+    addChoices(...choices: {
+        name: string;
+        value: number;
+    }[]): this;
+}
+/** Builds a number command option. */
+export declare class NumberOptionBuilder extends CommandOptionBuilder {
+    constructor();
+    setMinValue(value: number): this;
+    setMaxValue(value: number): this;
+    setAutocomplete(enabled?: boolean): this;
+    addChoices(...choices: {
+        name: string;
+        value: number;
+    }[]): this;
+}
+/** Builds a boolean command option. */ export declare class BooleanOptionBuilder extends CommandOptionBuilder {
+    /** Creates a boolean option. */ constructor();
+}
+/** Builds a user command option. */ export declare class UserOptionBuilder extends CommandOptionBuilder {
+    /** Creates a user option. */ constructor();
+}
+/** Builds a role command option. */ export declare class RoleOptionBuilder extends CommandOptionBuilder {
+    /** Creates a role option. */ constructor();
+}
+/** Builds a mentionable command option. */ export declare class MentionableOptionBuilder extends CommandOptionBuilder {
+    /** Creates a mentionable option. */ constructor();
+}
+/** Builds an attachment command option. */ export declare class AttachmentOptionBuilder extends CommandOptionBuilder {
+    /** Creates an attachment option. */ constructor();
+}
+/** Builds a channel command option. */ export declare class ChannelOptionBuilder extends CommandOptionBuilder {
+    /** Creates a channel option. */ constructor();
+    /** Restricts accepted channel types. */ addChannelTypes(...types: number[]): this;
+}
+/** Builds a nested subcommand. */ export declare class SubcommandBuilder extends CommandOptionBuilder {
+    /** Creates a subcommand. */ constructor();
+    /** Adds a string option to this subcommand. */ addStringOption(configure: (option: StringOptionBuilder) => StringOptionBuilder): this;
+    /** Adds an integer option to this subcommand. */ addIntegerOption(configure: (option: IntegerOptionBuilder) => IntegerOptionBuilder): this;
+    /** Adds a number option to this subcommand. */ addNumberOption(configure: (option: NumberOptionBuilder) => NumberOptionBuilder): this;
+    /** Adds a boolean option to this subcommand. */ addBooleanOption(configure: (option: BooleanOptionBuilder) => BooleanOptionBuilder): this;
+    /** Adds a user option to this subcommand. */ addUserOption(configure: (option: UserOptionBuilder) => UserOptionBuilder): this;
+    /** Adds a channel option to this subcommand. */ addChannelOption(configure: (option: ChannelOptionBuilder) => ChannelOptionBuilder): this;
+    /** Adds a role option to this subcommand. */ addRoleOption(configure: (option: RoleOptionBuilder) => RoleOptionBuilder): this;
+    /** Adds a mentionable option to this subcommand. */ addMentionableOption(configure: (option: MentionableOptionBuilder) => MentionableOptionBuilder): this;
+    /** Adds an attachment option to this subcommand. */ addAttachmentOption(configure: (option: AttachmentOptionBuilder) => AttachmentOptionBuilder): this;
+    protected addChildOption(option: CommandOptionBuilder): this;
+}
+/** Builds a nested subcommand group. */ export declare class SubcommandGroupBuilder extends CommandOptionBuilder {
+    /** Creates a subcommand group. */ constructor();
+    /** Adds a subcommand to this group. */ addSubcommand(configure: (option: SubcommandBuilder) => SubcommandBuilder): this;
+}

package/dist/builders/components.d.ts

@@ -0,0 +1,151 @@
+/** Component type constants exposed by Lunibee. */
+export declare const ComponentType: {
+    readonly ActionRow: 1;
+    readonly Button: 2;
+    readonly StringSelect: 3;
+    readonly TextInput: 4;
+    readonly UserSelect: 5;
+    readonly RoleSelect: 6;
+    readonly MentionableSelect: 7;
+    readonly ChannelSelect: 8;
+};
+export declare const ButtonStyle: {
+    readonly Primary: 1;
+    readonly Secondary: 2;
+    readonly Success: 3;
+    readonly Danger: 4;
+    readonly Link: 5;
+};
+export declare const TextInputStyle: {
+    readonly Short: 1;
+    readonly Paragraph: 2;
+};
+export interface APIComponentEmoji {
+    id?: string | null;
+    name?: string | null;
+    animated?: boolean;
+}
+export interface APIButtonComponent {
+    type: typeof ComponentType.Button;
+    style: 1 | 2 | 3 | 4 | 5;
+    custom_id?: string;
+    label?: string;
+    emoji?: APIComponentEmoji;
+    url?: string;
+    disabled?: boolean;
+}
+export interface APISelectOption {
+    label: string;
+    value: string;
+    description?: string;
+    emoji?: APIComponentEmoji;
+    default?: boolean;
+}
+export interface APIStringSelectComponent {
+    type: typeof ComponentType.StringSelect;
+    custom_id?: string;
+    placeholder?: string;
+    min_values?: number;
+    max_values?: number;
+    required?: boolean;
+    disabled?: boolean;
+    options?: APISelectOption[];
+}
+export interface APIEntitySelectComponent {
+    type: typeof ComponentType.UserSelect | typeof ComponentType.RoleSelect | typeof ComponentType.MentionableSelect | typeof ComponentType.ChannelSelect;
+    custom_id?: string;
+    placeholder?: string;
+    min_values?: number;
+    max_values?: number;
+    required?: boolean;
+    disabled?: boolean;
+}
+export interface APITextInputComponent {
+    type: typeof ComponentType.TextInput;
+    style: typeof TextInputStyle.Short | typeof TextInputStyle.Paragraph;
+    custom_id?: string;
+    label?: string;
+    placeholder?: string;
+    min_length?: number;
+    max_length?: number;
+    required?: boolean;
+    value?: string;
+}
+export interface APIModalComponent {
+    type: 9;
+    custom_id?: string;
+    title?: string;
+    components: APIActionRowComponent[];
+}
+export type APIActionRowChild = APIButtonComponent | APIStringSelectComponent | APIEntitySelectComponent | APITextInputComponent;
+export interface APIActionRowComponent {
+    type: typeof ComponentType.ActionRow;
+    components: APIActionRowChild[];
+}
+export declare class ActionRowBuilder<T extends {
+    toJSON(): APIActionRowChild;
+} = {
+    toJSON(): APIActionRowChild;
+}> {
+    #private;
+    addComponents(...components: T[]): this;
+    clearComponents(): this;
+    toJSON(): APIActionRowComponent;
+}
+export declare class StringSelectBuilder {
+    #private;
+    setCustomId(value: string): this;
+    setPlaceholder(value: string): this;
+    setMinValues(value: number): this;
+    setMaxValues(value: number): this;
+    setRequired(value?: boolean): this;
+    setDisabled(value?: boolean): this;
+    addOptions(...options: APISelectOption[]): this;
+    toJSON(): APIStringSelectComponent;
+}
+export declare class ButtonBuilder {
+    #private;
+    setStyle(style: APIButtonComponent["style"]): this;
+    setCustomId(value: string): this;
+    setLabel(value: string): this;
+    setURL(value: string): this;
+    setEmoji(emoji: APIComponentEmoji | string): this;
+    setDisabled(value?: boolean): this;
+    toJSON(): APIButtonComponent;
+}
+export declare class EntitySelectBuilder {
+    #private;
+    constructor(type: typeof ComponentType.UserSelect | typeof ComponentType.RoleSelect | typeof ComponentType.MentionableSelect | typeof ComponentType.ChannelSelect);
+    setCustomId(value: string): this;
+    setPlaceholder(value: string): this;
+    setMinValues(value: number): this;
+    setMaxValues(value: number): this;
+    setRequired(value?: boolean): this;
+    setDisabled(value?: boolean): this;
+    setDefaultValues(...values: {
+        id: string;
+        type: "user" | "role" | "channel";
+    }[]): this;
+    toJSON(): APIEntitySelectComponent;
+}
+export declare class ModalBuilder {
+    #private;
+    setCustomId(value: string): this;
+    setTitle(value: string): this;
+    addComponents(...components: Array<{
+        toJSON(): APIActionRowComponent;
+    }>): this;
+    toJSON(): APIModalComponent;
+}
+export declare class TextInputBuilder {
+    #private;
+    setStyle(style: APITextInputComponent["style"]): this;
+    setCustomId(value: string): this;
+    setLabel(value: string): this;
+    setPlaceholder(value: string): this;
+    setMinLength(value: number): this;
+    setMaxLength(value: number): this;
+    setRequired(value?: boolean): this;
+    setValue(value: string): this;
+    toJSON(): APITextInputComponent;
+}

package/dist/builders/embed.d.ts

@@ -0,0 +1,59 @@
+/** Discord API embed field payload. */
+export interface EmbedField {
+    /** Field name. */ name: string;
+    /** Field value. */ value: string;
+    /** Whether the field is displayed inline. */ inline?: boolean;
+}
+/** Discord API embed footer payload. */
+export interface EmbedFooter {
+    /** Footer text. */ text: string;
+    /** Footer icon URL. */ icon_url?: string;
+}
+/** Discord API embed author payload. */
+export interface EmbedAuthor {
+    /** Author display name. */ name: string;
+    /** Author URL. */ url?: string;
+    /** Author icon URL. */ icon_url?: string;
+}
+/** Strict Discord API embed payload. */
+export interface APIEmbed {
+    /** Embed title. */ title?: string;
+    /** Embed description. */ description?: string;
+    /** Embed URL. */ url?: string;
+    /** Embed color. */ color?: number;
+    /** ISO-8601 timestamp. */ timestamp?: string;
+    /** Embed footer. */ footer?: EmbedFooter;
+    /** Embed author. */ author?: EmbedAuthor;
+    /** Thumbnail payload. */ thumbnail?: {
+        url: string;
+    };
+    /** Image payload. */ image?: {
+        url: string;
+    };
+    /** Embed fields. */ fields?: EmbedField[];
+}
+/** Builds compile-time-safe rich embed payloads for Discord API requests. */
+export declare class EmbedBuilder {
+    #private;
+    /** Sets the embed title. @param value Title text. @returns This builder. @throws {RangeError} If title exceeds Discord's limit. */ setTitle(value: string): this;
+    /** Sets the embed description. @param value Description text. @returns This builder. @throws {RangeError} If description exceeds Discord's limit. */ setDescription(value: string): this;
+    /** Sets the embed URL. @param value Absolute URL. @returns This builder. @throws {TypeError} If URL is invalid. */ setURL(value: string): this;
+    /** Sets the embed color. @param value RGB integer. @returns This builder. @throws {RangeError} If color is outside 24-bit RGB range. */ setColor(value: number): this;
+    /** Sets the embed timestamp. @param value Date value. @returns This builder. @throws {RangeError} If date is invalid. */ setTimestamp(value?: Date): this;
+    /** Sets the embed footer. @param value Footer payload. @returns This builder. @throws {RangeError} If footer text exceeds Discord's limit. */ setFooter(value: EmbedFooter): this;
+    /** Sets the embed author. @param value Author payload. @returns This builder. @throws {RangeError} If author name exceeds Discord's limit. */ setAuthor(value: EmbedAuthor): this;
+    /** Sets the thumbnail URL. @param value Thumbnail URL or payload. @returns This builder. @throws {TypeError} If URL is invalid. */ setThumbnail(value: {
+        url: string;
+    } | string): this;
+    /** Sets the image URL. @param value Image URL or payload. @returns This builder. @throws {TypeError} If URL is invalid. */ setImage(value: {
+        url: string;
+    } | string): this;
+    /** Adds embed fields. @param fields Field payloads. @returns This builder. @throws {RangeError} If the 25-field limit is exceeded. */ addFields(...fields: EmbedField[]): this;
+    setFields(fields: EmbedField[]): this;
+    /** Replaces fields starting at an index. @param index Start index. @param deleteCount Number of fields to remove. @param fields Replacement fields. @returns This builder. @throws {RangeError} If arguments are invalid or the 25-field limit is exceeded. */ spliceFields(index: number, deleteCount: number, ...fields: EmbedField[]): this;
+    /** Removes all embed fields. @returns This builder. */ clearFields(): this;
+    /** Removes the embed title. @returns This builder. */ clearTitle(): this;
+    /** Removes the embed description. @returns This builder. */ clearDescription(): this;
+    /** Returns a deep-cloned Discord API payload. @returns Strict embed payload. */ get data(): APIEmbed;
+    toJSON(): APIEmbed;
+}

package/dist/builders/index.d.ts

@@ -0,0 +1,5 @@
+export { EmbedBuilder } from "./embed.js";
+export type { EmbedField } from "./embed.js";
+export { ButtonBuilder, ButtonStyle, ComponentType, ActionRowBuilder, StringSelectBuilder, EntitySelectBuilder, ModalBuilder, TextInputBuilder, TextInputStyle, } from "./components.js";
+export { SlashCommandBuilder, StringOptionBuilder, IntegerOptionBuilder, NumberOptionBuilder, BooleanOptionBuilder, UserOptionBuilder, ChannelOptionBuilder, RoleOptionBuilder, MentionableOptionBuilder, AttachmentOptionBuilder, SubcommandBuilder, SubcommandGroupBuilder, ApplicationCommandOptionType, } from "./commands.js";
+export { AttachmentBuilder, type AttachmentData } from "./attachment.js";