privage.js 0.21.0

package/dist/formatters.js

@@ -0,0 +1,43 @@
+"use strict";
+/**
+ * Message formatting helpers. Mention syntax matches the wire format the
+ * backend parses and the client renders: `<@userId>`, `<@&roleId>`,
+ * `<#channelId>`, plus the `@everyone` / `@here` broadcasts (rate-limited
+ * server-side). The rest is standard markdown.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.here = exports.everyone = void 0;
+exports.userMention = userMention;
+exports.roleMention = roleMention;
+exports.channelMention = channelMention;
+exports.bold = bold;
+exports.italic = italic;
+exports.strikethrough = strikethrough;
+exports.inlineCode = inlineCode;
+exports.codeBlock = codeBlock;
+function userMention(userId) {
+    return `<@${userId}>`;
+}
+function roleMention(roleId) {
+    return `<@&${roleId}>`;
+}
+function channelMention(channelId) {
+    return `<#${channelId}>`;
+}
+exports.everyone = '@everyone';
+exports.here = '@here';
+function bold(text) {
+    return `**${text}**`;
+}
+function italic(text) {
+    return `*${text}*`;
+}
+function strikethrough(text) {
+    return `~~${text}~~`;
+}
+function inlineCode(text) {
+    return `\`${text.replaceAll('`', '​`')}\``;
+}
+function codeBlock(content, language = '') {
+    return `\`\`\`${language}\n${content.replaceAll('```', '​```')}\n\`\`\``;
+}

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+export { Client } from './Client';
+export { Intents } from './intents';
+export type { Intent } from './intents';
+export { Message, TextChannel } from './structures/Message';
+export type { MessageThread, MessageReference, ReferencedMessage, MessageAttachment, MessageEmbed, } from './structures/Message';
+export { Member } from './structures/Member';
+export { Server } from './structures/Server';
+export { Channel } from './structures/Channel';
+export { Role } from './structures/Role';
+export { ServerChannels } from './structures/ServerChannels';
+export type { SendMessageOptions, KickBanOptions, TimeoutOptions, FetchMessagesOptions, FetchMembersOptions, PresenceStatus, Activity, } from './rest';
+export { ActivityType } from './rest';
+export { EmbedBuilder, EmbedLimits } from './embeds';
+export type { Embed, EmbedField, EmbedAuthor, EmbedFooter } from './embeds';
+export { AttachmentBuilder } from './attachments';
+export type { AttachmentSource } from './attachments';
+export type { CreatePollOptions, CreateWebhookOptions, EditWebhookOptions } from './rest';
+export { ButtonBuilder, SelectMenuBuilder, ActionRowBuilder, ComponentLimits, ButtonStyle } from './components';
+export type { Button, SelectMenu, SelectOption, ActionRow } from './components';
+export { ModalBuilder, TextInputBuilder, ModalLimits, TextInputStyle } from './modals';
+export type { Modal, TextInput } from './modals';
+export { Events, Colors } from './compat';
+export { Interaction, InteractionCommand } from './structures/Interaction';
+export type { InteractionKind, InteractionUpdateData, InteractionReplyData, CommandOptionType, CommandInteractionOption, ModalSubmitField, } from './structures/Interaction';
+export { CommandsManager, CommandLimits, SlashCommandBuilder, SlashCommandOptionBuilder } from './commands';
+export type { BotCommand, BotCommandData, CommandOptionData, CommandChoice } from './commands';
+export type { EditMessageOptions } from './rest';
+export { MessageCollector } from './collectors';
+export type { MessageCollectorOptions, CollectorEndReason } from './collectors';
+export * as formatters from './formatters';
+export { userMention, roleMention, channelMention, bold, italic, strikethrough, inlineCode, codeBlock, } from './formatters';
+export type { ClientOptions, ClientEvents, ReadyPayload, BotUser, Author, MessageDelete, MessageDeleteBulk, ReactionUpdate, ReactionAction, MemberLeave, RoleChange, MemberUpdate, MemberBan, MemberTimeout, MemberUntimeout, MessagePin, TypingEvent, ChannelDelete, RoleDelete, PollVote, PollClose, } from './types';
+export { PrivageError, PrivageAuthError, PrivagePermissionError, PrivageConnectionError, PrivageRateLimitError, PrivageHTTPError, } from './errors';

package/dist/index.js

@@ -0,0 +1,101 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PrivageHTTPError = exports.PrivageRateLimitError = exports.PrivageConnectionError = exports.PrivagePermissionError = exports.PrivageAuthError = exports.PrivageError = exports.codeBlock = exports.inlineCode = exports.strikethrough = exports.italic = exports.bold = exports.channelMention = exports.roleMention = exports.userMention = exports.formatters = exports.MessageCollector = exports.SlashCommandOptionBuilder = exports.SlashCommandBuilder = exports.CommandLimits = exports.CommandsManager = exports.InteractionCommand = exports.Interaction = exports.Colors = exports.Events = exports.TextInputStyle = exports.ModalLimits = exports.TextInputBuilder = exports.ModalBuilder = exports.ButtonStyle = exports.ComponentLimits = exports.ActionRowBuilder = exports.SelectMenuBuilder = exports.ButtonBuilder = exports.AttachmentBuilder = exports.EmbedLimits = exports.EmbedBuilder = exports.ActivityType = exports.ServerChannels = exports.Role = exports.Channel = exports.Server = exports.Member = exports.TextChannel = exports.Message = exports.Intents = exports.Client = void 0;
+var Client_1 = require("./Client");
+Object.defineProperty(exports, "Client", { enumerable: true, get: function () { return Client_1.Client; } });
+var intents_1 = require("./intents");
+Object.defineProperty(exports, "Intents", { enumerable: true, get: function () { return intents_1.Intents; } });
+var Message_1 = require("./structures/Message");
+Object.defineProperty(exports, "Message", { enumerable: true, get: function () { return Message_1.Message; } });
+Object.defineProperty(exports, "TextChannel", { enumerable: true, get: function () { return Message_1.TextChannel; } });
+var Member_1 = require("./structures/Member");
+Object.defineProperty(exports, "Member", { enumerable: true, get: function () { return Member_1.Member; } });
+var Server_1 = require("./structures/Server");
+Object.defineProperty(exports, "Server", { enumerable: true, get: function () { return Server_1.Server; } });
+var Channel_1 = require("./structures/Channel");
+Object.defineProperty(exports, "Channel", { enumerable: true, get: function () { return Channel_1.Channel; } });
+var Role_1 = require("./structures/Role");
+Object.defineProperty(exports, "Role", { enumerable: true, get: function () { return Role_1.Role; } });
+var ServerChannels_1 = require("./structures/ServerChannels");
+Object.defineProperty(exports, "ServerChannels", { enumerable: true, get: function () { return ServerChannels_1.ServerChannels; } });
+var rest_1 = require("./rest");
+Object.defineProperty(exports, "ActivityType", { enumerable: true, get: function () { return rest_1.ActivityType; } });
+var embeds_1 = require("./embeds");
+Object.defineProperty(exports, "EmbedBuilder", { enumerable: true, get: function () { return embeds_1.EmbedBuilder; } });
+Object.defineProperty(exports, "EmbedLimits", { enumerable: true, get: function () { return embeds_1.EmbedLimits; } });
+var attachments_1 = require("./attachments");
+Object.defineProperty(exports, "AttachmentBuilder", { enumerable: true, get: function () { return attachments_1.AttachmentBuilder; } });
+var components_1 = require("./components");
+Object.defineProperty(exports, "ButtonBuilder", { enumerable: true, get: function () { return components_1.ButtonBuilder; } });
+Object.defineProperty(exports, "SelectMenuBuilder", { enumerable: true, get: function () { return components_1.SelectMenuBuilder; } });
+Object.defineProperty(exports, "ActionRowBuilder", { enumerable: true, get: function () { return components_1.ActionRowBuilder; } });
+Object.defineProperty(exports, "ComponentLimits", { enumerable: true, get: function () { return components_1.ComponentLimits; } });
+Object.defineProperty(exports, "ButtonStyle", { enumerable: true, get: function () { return components_1.ButtonStyle; } });
+var modals_1 = require("./modals");
+Object.defineProperty(exports, "ModalBuilder", { enumerable: true, get: function () { return modals_1.ModalBuilder; } });
+Object.defineProperty(exports, "TextInputBuilder", { enumerable: true, get: function () { return modals_1.TextInputBuilder; } });
+Object.defineProperty(exports, "ModalLimits", { enumerable: true, get: function () { return modals_1.ModalLimits; } });
+Object.defineProperty(exports, "TextInputStyle", { enumerable: true, get: function () { return modals_1.TextInputStyle; } });
+var compat_1 = require("./compat");
+Object.defineProperty(exports, "Events", { enumerable: true, get: function () { return compat_1.Events; } });
+Object.defineProperty(exports, "Colors", { enumerable: true, get: function () { return compat_1.Colors; } });
+var Interaction_1 = require("./structures/Interaction");
+Object.defineProperty(exports, "Interaction", { enumerable: true, get: function () { return Interaction_1.Interaction; } });
+Object.defineProperty(exports, "InteractionCommand", { enumerable: true, get: function () { return Interaction_1.InteractionCommand; } });
+var commands_1 = require("./commands");
+Object.defineProperty(exports, "CommandsManager", { enumerable: true, get: function () { return commands_1.CommandsManager; } });
+Object.defineProperty(exports, "CommandLimits", { enumerable: true, get: function () { return commands_1.CommandLimits; } });
+Object.defineProperty(exports, "SlashCommandBuilder", { enumerable: true, get: function () { return commands_1.SlashCommandBuilder; } });
+Object.defineProperty(exports, "SlashCommandOptionBuilder", { enumerable: true, get: function () { return commands_1.SlashCommandOptionBuilder; } });
+var collectors_1 = require("./collectors");
+Object.defineProperty(exports, "MessageCollector", { enumerable: true, get: function () { return collectors_1.MessageCollector; } });
+exports.formatters = __importStar(require("./formatters"));
+var formatters_1 = require("./formatters");
+Object.defineProperty(exports, "userMention", { enumerable: true, get: function () { return formatters_1.userMention; } });
+Object.defineProperty(exports, "roleMention", { enumerable: true, get: function () { return formatters_1.roleMention; } });
+Object.defineProperty(exports, "channelMention", { enumerable: true, get: function () { return formatters_1.channelMention; } });
+Object.defineProperty(exports, "bold", { enumerable: true, get: function () { return formatters_1.bold; } });
+Object.defineProperty(exports, "italic", { enumerable: true, get: function () { return formatters_1.italic; } });
+Object.defineProperty(exports, "strikethrough", { enumerable: true, get: function () { return formatters_1.strikethrough; } });
+Object.defineProperty(exports, "inlineCode", { enumerable: true, get: function () { return formatters_1.inlineCode; } });
+Object.defineProperty(exports, "codeBlock", { enumerable: true, get: function () { return formatters_1.codeBlock; } });
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "PrivageError", { enumerable: true, get: function () { return errors_1.PrivageError; } });
+Object.defineProperty(exports, "PrivageAuthError", { enumerable: true, get: function () { return errors_1.PrivageAuthError; } });
+Object.defineProperty(exports, "PrivagePermissionError", { enumerable: true, get: function () { return errors_1.PrivagePermissionError; } });
+Object.defineProperty(exports, "PrivageConnectionError", { enumerable: true, get: function () { return errors_1.PrivageConnectionError; } });
+Object.defineProperty(exports, "PrivageRateLimitError", { enumerable: true, get: function () { return errors_1.PrivageRateLimitError; } });
+Object.defineProperty(exports, "PrivageHTTPError", { enumerable: true, get: function () { return errors_1.PrivageHTTPError; } });

package/dist/intents.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Public, curated intents. The wire gateway has 16 intents, several of which
+ * are dead or no-ops in v1 (see protocol spec §6/§11); the SDK exposes only
+ * the ones that actually work. Each maps to a wire intent string.
+ *
+ * IMPORTANT: an empty intent list means the gateway delivers ALL events
+ * (firehose). The SDK always sends the explicit resolved list — declare what
+ * you handle.
+ */
+export declare const Intents: {
+    /** New/edited/deleted messages (including in-thread replies), pins, polls, tip jars. */
+    readonly Messages: "messages";
+    /** Reaction updates. */
+    readonly Reactions: "reactions";
+    /** Typing start/stop. */
+    readonly Typing: "typing";
+    /** Member joins/leaves/updates, role add/remove, nickname changes. */
+    readonly Members: "member_events";
+    /** Bans, unbans, kicks, timeouts. */
+    readonly Moderation: "server_moderation";
+    /** Server/channel/category/role/emoji structure + config changes. */
+    readonly Servers: "servers";
+    /** All `interaction` events — button clicks, select-menu choices, slash-command invocations, and modal submissions. Delivered bot-direct — no message reading required. */
+    readonly Interactions: "interactions";
+};
+export type Intent = typeof Intents[keyof typeof Intents];
+/** Dedupe + normalize the declared intents into the wire list. */
+export declare function resolveIntents(intents: Intent[]): string[];

package/dist/intents.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Intents = void 0;
+exports.resolveIntents = resolveIntents;
+/**
+ * Public, curated intents. The wire gateway has 16 intents, several of which
+ * are dead or no-ops in v1 (see protocol spec §6/§11); the SDK exposes only
+ * the ones that actually work. Each maps to a wire intent string.
+ *
+ * IMPORTANT: an empty intent list means the gateway delivers ALL events
+ * (firehose). The SDK always sends the explicit resolved list — declare what
+ * you handle.
+ */
+exports.Intents = {
+    /** New/edited/deleted messages (including in-thread replies), pins, polls, tip jars. */
+    Messages: 'messages',
+    /** Reaction updates. */
+    Reactions: 'reactions',
+    /** Typing start/stop. */
+    Typing: 'typing',
+    /** Member joins/leaves/updates, role add/remove, nickname changes. */
+    Members: 'member_events',
+    /** Bans, unbans, kicks, timeouts. */
+    Moderation: 'server_moderation',
+    /** Server/channel/category/role/emoji structure + config changes. */
+    Servers: 'servers',
+    /** All `interaction` events — button clicks, select-menu choices, slash-command invocations, and modal submissions. Delivered bot-direct — no message reading required. */
+    Interactions: 'interactions',
+};
+/** Dedupe + normalize the declared intents into the wire list. */
+function resolveIntents(intents) {
+    return Array.from(new Set(intents));
+}

package/dist/modals.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Modals (interactions v2 §4) + fluent builders — siblings of the embed and
+ * component builders. A modal is opened with `interaction.showModal(...)`
+ * (valid only from a pending interaction, once, not after `defer()`); the
+ * user's submission arrives as a fresh `interaction` event with
+ * `kind: 'modal_submit'`.
+ *
+ * Wire shape (the `modal` callback payload, exactly per spec §4):
+ *   { title, custom_id, fields: [
+ *     { custom_id, label, style: 'short' | 'paragraph', required?,
+ *       placeholder?, min_length?, max_length?, value? },
+ *   ]}
+ */
+/** Server-enforced modal limits (mirrored client-side). */
+export declare const ModalLimits: {
+    readonly Title: 45;
+    readonly CustomId: 100;
+    /** Text inputs per modal. */
+    readonly Fields: 5;
+    readonly Label: 45;
+    readonly Placeholder: 100;
+    /** Max `min_length`/`max_length` (paragraph style). */
+    readonly FieldLength: 4000;
+    /** `max_length` cap for `short`-style inputs. */
+    readonly ShortFieldLength: 1024;
+};
+export type TextInputStyle = 'short' | 'paragraph';
+/** discord.js-style constants for {@link TextInputStyle} — `setStyle(TextInputStyle.Short)` ports verbatim. */
+export declare const TextInputStyle: {
+    readonly Short: "short";
+    readonly Paragraph: "paragraph";
+};
+/** One text input inside a modal. */
+export interface TextInput {
+    /** ≤100 chars, unique within the modal. Keys the submitted value (`interaction.getField`). */
+    custom_id: string;
+    /** ≤45 chars. */
+    label: string;
+    /** `short` = single line (values cap at 1024), `paragraph` = multi-line. */
+    style: TextInputStyle;
+    /** Server default: true. */
+    required?: boolean;
+    /** ≤100 chars. */
+    placeholder?: string;
+    /** 0–4000. */
+    min_length?: number;
+    /** 1–4000 (`short` caps at 1024). */
+    max_length?: number;
+    /** Prefill (≤ max_length). */
+    value?: string;
+}
+/** The `modal` callback payload. */
+export interface Modal {
+    /** ≤45 chars. */
+    title: string;
+    /** ≤100 chars — round-trips as the modal_submit interaction's `customId`. */
+    custom_id: string;
+    /** 1–5 text inputs. */
+    fields: TextInput[];
+}
+/** Fluent text-input builder — throws at build time where the server would 400. */
+export declare class TextInputBuilder {
+    private readonly data;
+    /** Your opaque field identifier (≤100 chars, unique within the modal). */
+    setCustomId(customId: string): this;
+    /** ≤45 chars. */
+    setLabel(label: string): this;
+    /** `'short'` (single line) or `'paragraph'` (multi-line). */
+    setStyle(style: TextInputStyle): this;
+    /** Server default: true. */
+    setRequired(required?: boolean): this;
+    /** ≤100 chars. */
+    setPlaceholder(placeholder: string): this;
+    /** 0–4000. */
+    setMinLength(min: number): this;
+    /** 1–4000 (`short` style caps at 1024 — checked at build time). */
+    setMaxLength(max: number): this;
+    /** Prefill text (must fit max_length — checked at build time). */
+    setValue(value: string): this;
+    toJSON(): TextInput;
+}
+/**
+ * Fluent modal builder. Pass it straight to `interaction.showModal(...)` —
+ * no `.toJSON()` call needed.
+ */
+export declare class ModalBuilder {
+    private readonly data;
+    private readonly fields;
+    /** ≤45 chars. */
+    setTitle(title: string): this;
+    /** Your opaque modal identifier (≤100 chars) — comes back as the modal_submit's `customId`. */
+    setCustomId(customId: string): this;
+    /** Append text inputs (1–5 total; field custom_ids must be unique). */
+    addFields(...fields: (TextInput | TextInputBuilder)[]): this;
+    toJSON(): Modal;
+}

package/dist/modals.js

@@ -0,0 +1,162 @@
+"use strict";
+/**
+ * Modals (interactions v2 §4) + fluent builders — siblings of the embed and
+ * component builders. A modal is opened with `interaction.showModal(...)`
+ * (valid only from a pending interaction, once, not after `defer()`); the
+ * user's submission arrives as a fresh `interaction` event with
+ * `kind: 'modal_submit'`.
+ *
+ * Wire shape (the `modal` callback payload, exactly per spec §4):
+ *   { title, custom_id, fields: [
+ *     { custom_id, label, style: 'short' | 'paragraph', required?,
+ *       placeholder?, min_length?, max_length?, value? },
+ *   ]}
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModalBuilder = exports.TextInputBuilder = exports.TextInputStyle = exports.ModalLimits = void 0;
+/** Server-enforced modal limits (mirrored client-side). */
+exports.ModalLimits = {
+    Title: 45,
+    CustomId: 100,
+    /** Text inputs per modal. */
+    Fields: 5,
+    Label: 45,
+    Placeholder: 100,
+    /** Max `min_length`/`max_length` (paragraph style). */
+    FieldLength: 4000,
+    /** `max_length` cap for `short`-style inputs. */
+    ShortFieldLength: 1024,
+};
+/** discord.js-style constants for {@link TextInputStyle} — `setStyle(TextInputStyle.Short)` ports verbatim. */
+exports.TextInputStyle = {
+    Short: 'short',
+    Paragraph: 'paragraph',
+};
+function assertLength(what, value, max) {
+    if (value.length === 0 || value.length > max) {
+        throw new RangeError(`Modal ${what} must be 1–${max} characters (got ${value.length}).`);
+    }
+    return value;
+}
+/** Fluent text-input builder — throws at build time where the server would 400. */
+class TextInputBuilder {
+    constructor() {
+        this.data = {};
+    }
+    /** Your opaque field identifier (≤100 chars, unique within the modal). */
+    setCustomId(customId) {
+        this.data.custom_id = assertLength('field custom_id', customId, exports.ModalLimits.CustomId);
+        return this;
+    }
+    /** ≤45 chars. */
+    setLabel(label) {
+        this.data.label = assertLength('field label', label, exports.ModalLimits.Label);
+        return this;
+    }
+    /** `'short'` (single line) or `'paragraph'` (multi-line). */
+    setStyle(style) {
+        if (style !== 'short' && style !== 'paragraph') {
+            throw new RangeError(`Text input style must be "short" or "paragraph" (got "${style}").`);
+        }
+        this.data.style = style;
+        return this;
+    }
+    /** Server default: true. */
+    setRequired(required = true) {
+        this.data.required = required;
+        return this;
+    }
+    /** ≤100 chars. */
+    setPlaceholder(placeholder) {
+        this.data.placeholder = assertLength('field placeholder', placeholder, exports.ModalLimits.Placeholder);
+        return this;
+    }
+    /** 0–4000. */
+    setMinLength(min) {
+        if (!Number.isInteger(min) || min < 0 || min > exports.ModalLimits.FieldLength) {
+            throw new RangeError(`Text input min_length must be an integer between 0 and ${exports.ModalLimits.FieldLength} (got ${min}).`);
+        }
+        this.data.min_length = min;
+        return this;
+    }
+    /** 1–4000 (`short` style caps at 1024 — checked at build time). */
+    setMaxLength(max) {
+        if (!Number.isInteger(max) || max < 1 || max > exports.ModalLimits.FieldLength) {
+            throw new RangeError(`Text input max_length must be an integer between 1 and ${exports.ModalLimits.FieldLength} (got ${max}).`);
+        }
+        this.data.max_length = max;
+        return this;
+    }
+    /** Prefill text (must fit max_length — checked at build time). */
+    setValue(value) {
+        this.data.value = value;
+        return this;
+    }
+    toJSON() {
+        const d = this.data;
+        if (!d.custom_id)
+            throw new RangeError('Text inputs require a custom_id — call setCustomId().');
+        if (!d.label)
+            throw new RangeError('Text inputs require a label — call setLabel().');
+        if (!d.style)
+            throw new RangeError('Text inputs require a style — call setStyle("short" | "paragraph").');
+        const styleCap = d.style === 'short' ? exports.ModalLimits.ShortFieldLength : exports.ModalLimits.FieldLength;
+        if (d.max_length !== undefined && d.max_length > styleCap) {
+            throw new RangeError(`Text input max_length exceeds ${styleCap} (${d.style} style cap; got ${d.max_length}).`);
+        }
+        const effectiveMax = d.max_length ?? styleCap;
+        if (d.min_length !== undefined && d.min_length > effectiveMax) {
+            throw new RangeError(`Text input min_length (${d.min_length}) must not exceed max_length (${effectiveMax}).`);
+        }
+        if (d.value !== undefined && d.value.length > effectiveMax) {
+            throw new RangeError(`Text input prefill value exceeds max_length (${effectiveMax}; got ${d.value.length}).`);
+        }
+        return { ...d };
+    }
+}
+exports.TextInputBuilder = TextInputBuilder;
+/**
+ * Fluent modal builder. Pass it straight to `interaction.showModal(...)` —
+ * no `.toJSON()` call needed.
+ */
+class ModalBuilder {
+    constructor() {
+        this.data = {};
+        this.fields = [];
+    }
+    /** ≤45 chars. */
+    setTitle(title) {
+        this.data.title = assertLength('title', title, exports.ModalLimits.Title);
+        return this;
+    }
+    /** Your opaque modal identifier (≤100 chars) — comes back as the modal_submit's `customId`. */
+    setCustomId(customId) {
+        this.data.custom_id = assertLength('custom_id', customId, exports.ModalLimits.CustomId);
+        return this;
+    }
+    /** Append text inputs (1–5 total; field custom_ids must be unique). */
+    addFields(...fields) {
+        for (const field of fields) {
+            const resolved = field instanceof TextInputBuilder ? field.toJSON() : field;
+            if (this.fields.length >= exports.ModalLimits.Fields) {
+                throw new RangeError(`Modals hold at most ${exports.ModalLimits.Fields} fields.`);
+            }
+            if (this.fields.some((f) => f.custom_id === resolved.custom_id)) {
+                throw new RangeError(`Modal field custom_id "${resolved.custom_id}" is duplicated — field custom_ids must be unique.`);
+            }
+            this.fields.push(resolved);
+        }
+        return this;
+    }
+    toJSON() {
+        const d = this.data;
+        if (!d.title)
+            throw new RangeError('Modals require a title — call setTitle().');
+        if (!d.custom_id)
+            throw new RangeError('Modals require a custom_id — call setCustomId().');
+        if (this.fields.length === 0)
+            throw new RangeError('Modal has no fields — add at least one with addFields().');
+        return { title: d.title, custom_id: d.custom_id, fields: this.fields.map((f) => ({ ...f })) };
+    }
+}
+exports.ModalBuilder = ModalBuilder;