lunibee 0.1.6 → 0.1.7

package/dist/structures/resources.d.ts

@@ -1,5 +1,6 @@
 import { BaseStructure, Channel, User } from "./base.js";
-import { PermissionsBitField } from "./permissions.js";
+import { PermissionsBitField } from "@lunibee/core";
+import type { ImageURLOptions } from "./base.js";
 /** A Discord guild member. */
 export declare class GuildMember {
     /** User represented by the member. */ readonly user: User;
@@ -9,6 +10,10 @@ export declare class GuildMember {
     /** Whether the member is pending membership screening. */ pending: boolean;
     /** Member join timestamp. */ joinedAt?: Date;
     /** Raw effective permission bitfield supplied by Discord. */ readonly permissions: PermissionsBitField;
+    /** Member-specific avatar hash, if set. */ avatarHash: string | null;
+    /** When the member started boosting the guild. */ premiumSince: Date | null;
+    /** When the member's timeout expires (null if not timed out). */ timedOutUntil: Date | null;
+    /** Member flags bitfield. */ flags: number;
     /** Creates a guild member from Discord data. @param data Discord guild-member payload. @throws {TypeError} If the guild ID is invalid. @throws {RangeError} If joined_at is invalid. */
     constructor(data: {
         user: {
@@ -19,6 +24,7 @@ export declare class GuildMember {
             bot?: boolean;
             system?: boolean;
             public_flags?: number;
+            discriminator?: string;
         };
         guild_id: string;
         nick?: string | null;
@@ -26,20 +32,34 @@ export declare class GuildMember {
         pending?: boolean;
         joined_at?: string;
         permissions?: string;
+        avatar?: string | null;
+        premium_since?: string | null;
+        communication_disabled_until?: string | null;
+        flags?: number;
     });
-    /** Effective member display name. @returns Nickname or user display name. */
+    /** Effective member display name — nickname, falling back to user display name. */
     get displayName(): string;
+    /** Whether this member is currently timed out. */
+    get isTimedOut(): boolean;
+    /** Returns the member-specific avatar URL, falling back to the user's avatar, or null if none. */
+    avatarURL(options?: ImageURLOptions): string | null;
+    /** Returns the resolved avatar URL — member avatar, user avatar, or default. */
+    displayAvatarURL(options?: ImageURLOptions): string;
     /** Returns the Discord user mention for this member. */
     toString(): string;
 }
 /** A Discord guild role. */
 export declare class Role extends BaseStructure {
     /** Role name. */ name: string;
-    /** Role color. */ color: number;
+    /** Role color as a 24-bit RGB integer. */ color: number;
     /** Whether the role is hoisted. */ hoist: boolean;
     /** Permission bitfield. */ permissions: PermissionsBitField;
-    /** Whether the role is managed. */ managed: boolean;
+    /** Whether the role is managed by an integration. */ managed: boolean;
     /** Whether the role is mentionable. */ mentionable: boolean;
+    /** Role position in the hierarchy. */ position: number;
+    /** Unicode emoji used as the role icon, if any. */ unicodeEmoji: string | null;
+    /** Hash of the role's custom icon image, if any. */ iconHash: string | null;
+    /** Role tags metadata (bot, premium subscriber, etc). */ tags: Record<string, unknown> | null;
     /** Creates a role from Discord data. @param data Discord role payload. */
     constructor(data: {
         id: string;
@@ -49,7 +69,17 @@ export declare class Role extends BaseStructure {
         permissions?: string;
         managed?: boolean;
         mentionable?: boolean;
+        position?: number;
+        unicode_emoji?: string | null;
+        icon?: string | null;
+        tags?: Record<string, unknown> | null;
     });
+    /** Returns the role's color as a `#RRGGBB` hex string. Returns `#000000` for colorless roles. */
+    get colorHex(): string;
+    /** Returns the role's custom icon URL, or null if the role has no icon. */
+    iconURL(options?: ImageURLOptions): string | null;
+    /** Whether this is the @everyone base role (its ID equals the guild ID). */
+    isEveryone(guildId: string): boolean;
     /** Discord role mention string. Used automatically in template literals. */
     toString(): string;
 }
@@ -66,3 +96,161 @@ export declare class TextChannel extends Channel {
     /** Discord channel mention string. Used automatically in template literals. */
     toString(): string;
 }
+/** A Discord invite link and its metadata. */
+export declare class Invite {
+    /** Invite code (the unique part of the URL). */ readonly code: string;
+    /** Guild this invite belongs to, if any. */ readonly guildId: string | null;
+    /** Channel this invite points to, if any. */ readonly channelId: string | null;
+    /** User who created the invite, if available. */ readonly inviter: User | null;
+    /** Number of times the invite has been used. */ uses: number;
+    /** Maximum number of uses (0 = unlimited). */ maxUses: number;
+    /** Duration in seconds until the invite expires (0 = never). */ maxAge: number;
+    /** Whether the invite is temporary (kicks uninducted members on disconnect). */ temporary: boolean;
+    /** When the invite was created. */ readonly createdAt: Date | null;
+    /** When the invite expires, or null if it never expires. */ readonly expiresAt: Date | null;
+    /** Creates an invite from Discord data. */
+    constructor(data: {
+        code: string;
+        guild?: {
+            id: string;
+        } | null;
+        channel?: {
+            id: string;
+        } | null;
+        inviter?: {
+            id: string;
+            username: string;
+            global_name?: string | null;
+            avatar?: string | null;
+            bot?: boolean;
+            system?: boolean;
+            public_flags?: number;
+            discriminator?: string;
+        } | null;
+        uses?: number;
+        max_uses?: number;
+        max_age?: number;
+        temporary?: boolean;
+        created_at?: string | null;
+        expires_at?: string | null;
+    });
+    /** The full invite URL. */
+    get url(): string;
+    /** Returns the invite URL. Used automatically in template literals. */
+    toString(): string;
+}
+/** Webhook type constants. */
+export declare const WebhookType: {
+    readonly Incoming: 1;
+    readonly ChannelFollower: 2;
+    readonly Application: 3;
+};
+/** A Discord webhook — an HTTP endpoint that can post messages to a channel. */
+export declare class Webhook extends BaseStructure {
+    /** Webhook type. */ readonly type: number;
+    /** Webhook display name. */ name: string | null;
+    /** Webhook avatar hash. */ avatarHash: string | null;
+    /** Channel this webhook posts to. */ readonly channelId: string | null;
+    /** Guild this webhook belongs to. */ readonly guildId: string | null;
+    /** Application that created this webhook, if any. */ readonly applicationId: string | null;
+    /** Webhook token (only present for incoming webhooks). */ readonly token: string | null;
+    /** Creates a webhook from Discord data. */
+    constructor(data: {
+        id: string;
+        type?: number;
+        name?: string | null;
+        avatar?: string | null;
+        channel_id?: string | null;
+        guild_id?: string | null;
+        application_id?: string | null;
+        token?: string;
+    });
+    /** Returns the webhook avatar URL, or null if no avatar is set. */
+    avatarURL(options?: ImageURLOptions): string | null;
+    /** Returns the webhook execution URL, or null if no token is set. */
+    get url(): string | null;
+    /** Returns the webhook URL or its ID as a string. */
+    toString(): string;
+}
+/** A Discord emoji. */
+export declare class Emoji extends BaseStructure {
+    /** Emoji name. */ name: string | null;
+    /** Roles allowed to use this emoji. */ roleIds: string[];
+    /** User that created this emoji. */ user: User | null;
+    /** Whether this emoji must be wrapped in colons. */ requireColons: boolean;
+    /** Whether this emoji is managed. */ managed: boolean;
+    /** Whether this emoji is animated. */ animated: boolean;
+    /** Whether this emoji can be used, may be false due to loss of Server Boosts. */ available: boolean;
+    /** Creates an emoji from Discord data. */
+    constructor(data: {
+        id: string | null;
+        name: string | null;
+        roles?: string[];
+        user?: import("@lunibee/types").UserData;
+        require_colons?: boolean;
+        managed?: boolean;
+        animated?: boolean;
+        available?: boolean;
+    });
+    /** Returns the URL for this emoji if it is custom, or null for unicode emojis. */
+    url(options?: ImageURLOptions): string | null;
+    /** Returns the text required to render this emoji in Discord. */
+    toString(): string;
+}
+/** A Discord AutoModeration Rule. */
+export declare class AutoModerationRule extends BaseStructure {
+    guildId: string;
+    name: string;
+    creatorId: string;
+    eventType: number;
+    triggerType: number;
+    triggerMetadata: Record<string, unknown>;
+    actions: import("@lunibee/types").APIAutoModerationAction[];
+    enabled: boolean;
+    exemptRoles: string[];
+    exemptChannels: string[];
+    /** Creates an auto moderation rule from Discord data. */
+    constructor(data: import("@lunibee/types").APIAutoModerationRule);
+    toJSON(): Record<string, unknown>;
+}
+/** A channel listed in a guild's Welcome Screen. */
+export declare class WelcomeScreenChannel {
+    channelId: string;
+    description: string;
+    emojiId: string | null;
+    emojiName: string | null;
+    constructor(data: import("@lunibee/types").APIWelcomeScreenChannel);
+}
+/** A Discord Guild Welcome Screen. */
+export declare class GuildWelcomeScreen {
+    description: string | null;
+    channels: WelcomeScreenChannel[];
+    constructor(data: import("@lunibee/types").APIGuildWelcomeScreen);
+}
+/** An option within a Guild Onboarding Prompt. */
+export declare class OnboardingPromptOption extends BaseStructure {
+    channelIds: string[];
+    roleIds: string[];
+    emoji: import("@lunibee/types").APIPartialEmoji | undefined;
+    title: string;
+    description: string | null;
+    constructor(data: import("@lunibee/types").APIOnboardingPromptOption);
+}
+/** A prompt shown during Guild Onboarding. */
+export declare class OnboardingPrompt extends BaseStructure {
+    type: number;
+    options: OnboardingPromptOption[];
+    title: string;
+    singleSelect: boolean;
+    required: boolean;
+    inOnboarding: boolean;
+    constructor(data: import("@lunibee/types").APIOnboardingPrompt);
+}
+/** A Discord Guild Onboarding setup. */
+export declare class GuildOnboarding extends BaseStructure {
+    prompts: OnboardingPrompt[];
+    defaultChannelIds: string[];
+    enabled: boolean;
+    mode: number;
+    constructor(data: import("@lunibee/types").APIGuildOnboarding);
+}

package/dist/types/index.d.ts

@@ -582,6 +582,40 @@ export interface APIGuild {
     safety_alerts_channel_id?: Snowflake | null;
     member_count?: number;
 }
+export interface APIWelcomeScreenChannel {
+    channel_id: Snowflake;
+    description: string;
+    emoji_id: Snowflake | null;
+    emoji_name: string | null;
+}
+export interface APIGuildWelcomeScreen {
+    description: string | null;
+    welcome_channels: APIWelcomeScreenChannel[];
+}
+export interface APIOnboardingPromptOption {
+    id: Snowflake;
+    channel_ids: Snowflake[];
+    role_ids: Snowflake[];
+    emoji?: APIPartialEmoji;
+    title: string;
+    description: string | null;
+}
+export interface APIOnboardingPrompt {
+    id: Snowflake;
+    type: number;
+    options: APIOnboardingPromptOption[];
+    title: string;
+    single_select: boolean;
+    required: boolean;
+    in_onboarding: boolean;
+}
+export interface APIGuildOnboarding {
+    guild_id: Snowflake;
+    prompts: APIOnboardingPrompt[];
+    default_channel_ids: Snowflake[];
+    enabled: boolean;
+    mode: number;
+}
 /** Raw Discord guild member object. */
 export interface APIGuildMember {
     user: UserData;
@@ -724,6 +758,48 @@ export interface APIAutoModerationAction {
         custom_message?: string;
     };
 }
+/** Raw Discord audit log change object. */
+export interface APIAuditLogChange {
+    new_value?: unknown;
+    old_value?: unknown;
+    key: string;
+}
+/** Raw Discord audit log entry options object. */
+export interface APIAuditLogOptions {
+    app_id?: Snowflake;
+    auto_moderation_rule_name?: string;
+    auto_moderation_rule_trigger_type?: string;
+    channel_id?: Snowflake;
+    count?: string;
+    delete_member_days?: string;
+    id?: Snowflake;
+    members_removed?: string;
+    message_id?: Snowflake;
+    role_name?: string;
+    type?: string;
+    integration_type?: string;
+}
+/** Raw Discord audit log entry object. */
+export interface APIAuditLogEntry {
+    target_id: string | null;
+    changes?: APIAuditLogChange[];
+    user_id: Snowflake | null;
+    id: Snowflake;
+    action_type: number;
+    options?: APIAuditLogOptions;
+    reason?: string;
+}
+/** Raw Discord audit log object. */
+export interface APIAuditLog {
+    audit_log_entries: APIAuditLogEntry[];
+    guild_scheduled_events: APIGuildScheduledEvent[];
+    integrations: Array<Record<string, unknown>>;
+    threads: APIChannel[];
+    users: UserData[];
+    webhooks: APIWebhook[];
+    application_commands: APIApplicationCommand[];
+    auto_moderation_rules: APIAutoModerationRule[];
+}
 /** Raw Discord AutoMod rule object. */
 export interface APIAutoModerationRule {
     id: Snowflake;

package/dist/types/index.js.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../packages/types/src/index.ts"],
   "sourcesContent": [
-    "/** Discord API snowflake identifier. */\r\nexport type Snowflake = string;\r\n\r\n// ─── Gateway Intents ─────────────────────────────────────────────────────────\r\n\r\n/** Gateway intent bit flags supported by Discord (PascalCase). */\r\nexport const GatewayIntentBits = {\r\n  Guilds: 1 << 0,\r\n  GuildMembers: 1 << 1,\r\n  GuildModeration: 1 << 2,\r\n  GuildExpressions: 1 << 3,\r\n  GuildIntegrations: 1 << 4,\r\n  GuildWebhooks: 1 << 5,\r\n  GuildInvites: 1 << 6,\r\n  GuildVoiceStates: 1 << 7,\r\n  GuildPresences: 1 << 8,\r\n  GuildMessages: 1 << 9,\r\n  GuildMessageReactions: 1 << 10,\r\n  GuildMessageTyping: 1 << 11,\r\n  DirectMessages: 1 << 12,\r\n  DirectMessageReactions: 1 << 13,\r\n  DirectMessageTyping: 1 << 14,\r\n  MessageContent: 1 << 15,\r\n  GuildScheduledEvents: 1 << 16,\r\n  AutoModerationConfiguration: 1 << 20,\r\n  AutoModerationExecution: 1 << 21,\r\n  GuildMessagePolls: 1 << 24,\r\n  DirectMessagePolls: 1 << 25,\r\n} as const;\r\n\r\n/** Idiomatic camelCase Gateway intent bit flags supported by Discord. */\r\nexport const IntentBits = {\r\n  guild: 1 << 0,\r\n  guilds: 1 << 0,\r\n  guildMembers: 1 << 1,\r\n  guildModeration: 1 << 2,\r\n  guildBans: 1 << 2,\r\n  guildExpressions: 1 << 3,\r\n  guildEmojis: 1 << 3,\r\n  guildEmojisAndStickers: 1 << 3,\r\n  guildIntegrations: 1 << 4,\r\n  guildWebhooks: 1 << 5,\r\n  guildInvites: 1 << 6,\r\n  guildVoiceStates: 1 << 7,\r\n  guildPresences: 1 << 8,\r\n  guildMessages: 1 << 9,\r\n  guildMessage: 1 << 9,\r\n  guildMessageReactions: 1 << 10,\r\n  guildMessageTyping: 1 << 11,\r\n  directMessages: 1 << 12,\r\n  directMessageReactions: 1 << 13,\r\n  directMessageTyping: 1 << 14,\r\n  messageContent: 1 << 15,\r\n  guildScheduledEvents: 1 << 16,\r\n  autoModerationConfiguration: 1 << 20,\r\n  autoModerationExecution: 1 << 21,\r\n  guildMessagePolls: 1 << 24,\r\n  directMessagePolls: 1 << 25,\r\n} as const;\r\n\r\n/** Alias for IntentBits. */\r\nexport const Intents = IntentBits;\r\n\r\n/** Gateway intent resolvable value (single bitfield, enum key, or array of bitfields/strings). */\r\nexport type GatewayIntentResolvable =\r\n  | number\r\n  | keyof typeof GatewayIntentBits\r\n  | keyof typeof IntentBits\r\n  | (\r\n      number | keyof typeof GatewayIntentBits | keyof typeof IntentBits | string\r\n    )[];\r\n\r\n/** Resolves any GatewayIntentResolvable into a raw bitfield integer. */\r\nexport function resolveGatewayIntents(\r\n  intents: GatewayIntentResolvable,\r\n): number {\r\n  if (typeof intents === \"number\") return intents;\r\n  if (Array.isArray(intents)) {\r\n    return intents.reduce<number>((acc, intent) => {\r\n      return acc | resolveGatewayIntents(intent as any);\r\n    }, 0);\r\n  }\r\n  if (typeof intents === \"string\") {\r\n    if (intents in GatewayIntentBits)\r\n      return (GatewayIntentBits as Record<string, number>)[intents]!;\r\n    if (intents in IntentBits)\r\n      return (IntentBits as Record<string, number>)[intents]!;\r\n    const lower = intents.charAt(0).toLowerCase() + intents.slice(1);\r\n    if (lower in IntentBits)\r\n      return (IntentBits as Record<string, number>)[lower]!;\r\n    const num = Number(intents);\r\n    if (!Number.isNaN(num)) return num;\r\n  }\r\n  return 0;\r\n}\r\n\r\n// ─── Gateway Config ───────────────────────────────────────────────────────────\r\n\r\n/** Gateway connection properties (OS, browser, device). */\r\nexport interface GatewayProperties {\r\n  os?: string;\r\n  browser?: string;\r\n  device?: string;\r\n  [key: string]: unknown;\r\n}\r\n/** Gateway presence activity. */\r\nexport interface GatewayPresenceActivity {\r\n  name: string;\r\n  type?: number;\r\n  url?: string;\r\n  state?: string;\r\n}\r\n/** Gateway presence data. */\r\nexport interface GatewayPresence {\r\n  status?: \"online\" | \"dnd\" | \"idle\" | \"invisible\" | \"offline\";\r\n  activities?: GatewayPresenceActivity[];\r\n  afk?: boolean;\r\n  since?: number | null;\r\n}\r\n/** Client configuration. */\r\nexport interface ClientOptions {\r\n  token: string;\r\n  intents: GatewayIntentResolvable;\r\n  gateway?: GatewayOptions;\r\n  rest?: RESTOptions;\r\n}\r\n/** Gateway connection configuration. */\r\nexport interface GatewayOptions {\r\n  intents?: GatewayIntentResolvable;\r\n  reconnect?: boolean;\r\n  maxReconnectAttempts?: number;\r\n  reconnectBaseDelay?: number;\r\n  reconnectMaxDelay?: number;\r\n  shardId?: number;\r\n  shardCount?: number;\r\n  properties?: GatewayProperties;\r\n  presence?: GatewayPresence;\r\n}\r\n\r\n/** REST request configuration. */\r\nexport interface RESTOptions {\r\n  timeout?: number;\r\n  retries?: number;\r\n  baseURL?: string;\r\n}\r\n\r\n// ─── Core Discord Objects ─────────────────────────────────────────────────────\r\n\r\n/** Discord user object. */\r\nexport interface UserData {\r\n  id: Snowflake;\r\n  username: string;\r\n  discriminator?: string;\r\n  global_name?: string | null;\r\n  avatar?: string | null;\r\n  bot?: boolean;\r\n  system?: boolean;\r\n  public_flags?: number;\r\n}\r\n/** Current authenticated bot user. */\r\nexport type ClientUser = UserData;\r\n/** Discord Gateway payload envelope. */\r\nexport interface GatewayPayload<T = unknown> {\r\n  op: number;\r\n  d: T | null;\r\n  s: number | null;\r\n  t: string | null;\r\n}\r\n/** Generic Discord API error payload. */\r\nexport interface APIError {\r\n  code?: number;\r\n  message?: string;\r\n  errors?: Record<string, unknown>;\r\n}\r\n\r\n// ─── Discord Flags & Enums ────────────────────────────────────────────────────\r\n\r\n/** Discord message flags. */\r\nexport const MessageFlags = {\r\n  Crossposted: 1,\r\n  IsCrosspost: 2,\r\n  SuppressEmbeds: 4,\r\n  SourceMessageDeleted: 8,\r\n  Urgent: 16,\r\n  HasThread: 32,\r\n  Ephemeral: 64,\r\n  Loading: 128,\r\n  IsComponentsV2: 32768,\r\n} as const;\r\n\r\n/** Discord channel types. */\r\nexport const ChannelType = {\r\n  GuildText: 0,\r\n  DM: 1,\r\n  GuildVoice: 2,\r\n  GroupDM: 3,\r\n  GuildCategory: 4,\r\n  GuildAnnouncement: 5,\r\n  AnnouncementThread: 10,\r\n  PublicThread: 11,\r\n  PrivateThread: 12,\r\n  GuildStageVoice: 13,\r\n  GuildDirectory: 14,\r\n  GuildForum: 15,\r\n  GuildMedia: 16,\r\n} as const;\r\n\r\n/** Discord component types. */\r\nexport const ComponentType = {\r\n  ActionRow: 1,\r\n  Button: 2,\r\n  StringSelect: 3,\r\n  TextInput: 4,\r\n  UserSelect: 5,\r\n  RoleSelect: 6,\r\n  MentionableSelect: 7,\r\n  ChannelSelect: 8,\r\n  Section: 9,\r\n  TextDisplay: 10,\r\n  Thumbnail: 11,\r\n  MediaGallery: 12,\r\n  File: 13,\r\n  Separator: 14,\r\n  ContentInventoryEntry: 16,\r\n  Container: 17,\r\n} as const;\r\n\r\n/** Discord button style types. */\r\nexport const ButtonStyle = {\r\n  Primary: 1,\r\n  Secondary: 2,\r\n  Success: 3,\r\n  Danger: 4,\r\n  Link: 5,\r\n  Premium: 6,\r\n} as const;\r\n\r\n/** Discord text input style types. */\r\nexport const TextInputStyle = {\r\n  Short: 1,\r\n  Paragraph: 2,\r\n} as const;\r\n\r\n/** Discord interaction response types. */\r\nexport const InteractionResponseType = {\r\n  Pong: 1,\r\n  ChannelMessage: 4,\r\n  DeferredChannelMessage: 5,\r\n  DeferredMessageUpdate: 6,\r\n  MessageUpdate: 7,\r\n  Autocomplete: 8,\r\n  Modal: 9,\r\n} as const;\r\n\r\n/** Discord sticker format types. */\r\nexport const StickerFormatType = {\r\n  PNG: 1,\r\n  APNG: 2,\r\n  Lottie: 3,\r\n  GIF: 4,\r\n} as const;\r\n\r\n/** Discord sticker types. */\r\nexport const StickerType = {\r\n  Standard: 1,\r\n  Guild: 2,\r\n} as const;\r\n\r\n/** Discord verification levels. */\r\nexport const VerificationLevel = {\r\n  None: 0,\r\n  Low: 1,\r\n  Medium: 2,\r\n  High: 3,\r\n  VeryHigh: 4,\r\n} as const;\r\n\r\n/** Discord premium tiers. */\r\nexport const PremiumTier = {\r\n  None: 0,\r\n  Tier1: 1,\r\n  Tier2: 2,\r\n  Tier3: 3,\r\n} as const;\r\n\r\n// ─── Embeds ───────────────────────────────────────────────────────────────────\r\n\r\n/** Raw Discord embed footer object. */\r\nexport interface APIEmbedFooter {\r\n  text: string;\r\n  icon_url?: string;\r\n  proxy_icon_url?: string;\r\n}\r\n/** Raw Discord embed image/thumbnail/video object. */\r\nexport interface APIEmbedMedia {\r\n  url: string;\r\n  proxy_url?: string;\r\n  height?: number;\r\n  width?: number;\r\n}\r\n/** Raw Discord embed provider object. */\r\nexport interface APIEmbedProvider {\r\n  name?: string;\r\n  url?: string;\r\n}\r\n/** Raw Discord embed author object. */\r\nexport interface APIEmbedAuthor {\r\n  name: string;\r\n  url?: string;\r\n  icon_url?: string;\r\n  proxy_icon_url?: string;\r\n}\r\n/** Raw Discord embed field object. */\r\nexport interface APIEmbedField {\r\n  name: string;\r\n  value: string;\r\n  inline?: boolean;\r\n}\r\n/** Raw Discord embed object. */\r\nexport interface APIEmbed {\r\n  title?: string;\r\n  type?: string;\r\n  description?: string;\r\n  url?: string;\r\n  timestamp?: string;\r\n  color?: number;\r\n  footer?: APIEmbedFooter;\r\n  image?: APIEmbedMedia;\r\n  thumbnail?: APIEmbedMedia;\r\n  video?: APIEmbedMedia;\r\n  provider?: APIEmbedProvider;\r\n  author?: APIEmbedAuthor;\r\n  fields?: APIEmbedField[];\r\n}\r\n\r\n// ─── Message Components ───────────────────────────────────────────────────────\r\n\r\n/** Raw Discord select menu option. */\r\nexport interface APISelectMenuOption {\r\n  label: string;\r\n  value: string;\r\n  description?: string;\r\n  emoji?: APIPartialEmoji;\r\n  default?: boolean;\r\n}\r\n/** Raw Discord emoji (partial, as used in components). */\r\nexport interface APIPartialEmoji {\r\n  id?: Snowflake | null;\r\n  name?: string | null;\r\n  animated?: boolean;\r\n}\r\n/** Raw Discord button component. */\r\nexport interface APIButtonComponent {\r\n  type: 2;\r\n  style: number;\r\n  label?: string;\r\n  emoji?: APIPartialEmoji;\r\n  custom_id?: string;\r\n  url?: string;\r\n  sku_id?: string;\r\n  disabled?: boolean;\r\n}\r\n/** Raw Discord select menu component. */\r\nexport interface APISelectMenuComponent {\r\n  type: 3 | 5 | 6 | 7 | 8;\r\n  custom_id: string;\r\n  options?: APISelectMenuOption[];\r\n  channel_types?: number[];\r\n  placeholder?: string;\r\n  min_values?: number;\r\n  max_values?: number;\r\n  disabled?: boolean;\r\n}\r\n/** Raw Discord text input component. */\r\nexport interface APITextInputComponent {\r\n  type: 4;\r\n  custom_id: string;\r\n  style: number;\r\n  label: string;\r\n  min_length?: number;\r\n  max_length?: number;\r\n  required?: boolean;\r\n  value?: string;\r\n  placeholder?: string;\r\n}\r\n/** Union of all raw message component types. */\r\nexport type APIMessageActionRowComponent =\r\n  APIButtonComponent | APISelectMenuComponent | APITextInputComponent;\r\n/** Raw Discord action row component. */\r\nexport interface APIActionRowComponent {\r\n  type: 1;\r\n  id?: number;\r\n  components: APIMessageActionRowComponent[];\r\n}\r\n/** Union including action rows and V2 components. */\r\nexport type APIMessageComponent = APIActionRowComponent | { type: Exclude<number, 1>; [key: string]: any };\r\n\r\n// ─── Attachments ─────────────────────────────────────────────────────────────\r\n\r\n/** Raw Discord attachment object. */\r\nexport interface APIAttachment {\r\n  id: Snowflake;\r\n  filename: string;\r\n  description?: string | null;\r\n  content_type?: string;\r\n  size: number;\r\n  url: string;\r\n  proxy_url: string;\r\n  height?: number | null;\r\n  width?: number | null;\r\n  ephemeral?: boolean;\r\n  duration_secs?: number;\r\n  waveform?: string;\r\n  flags?: number;\r\n}\r\n\r\n// ─── Stickers ────────────────────────────────────────────────────────────────\r\n\r\n/** Compact sticker item as included in messages. */\r\nexport interface APIStickerItem {\r\n  id: Snowflake;\r\n  name: string;\r\n  format_type: number;\r\n}\r\n/** Full Discord sticker object. */\r\nexport interface APISticker {\r\n  id: Snowflake;\r\n  pack_id?: Snowflake;\r\n  name: string;\r\n  description?: string | null;\r\n  tags?: string;\r\n  type: number;\r\n  format_type: number;\r\n  available?: boolean;\r\n  guild_id?: Snowflake;\r\n  user?: UserData;\r\n  sort_value?: number;\r\n}\r\n\r\n// ─── Messages ────────────────────────────────────────────────────────────────\r\n\r\n/** Raw Discord message reference. */\r\nexport interface APIMessageReference {\r\n  type?: number;\r\n  message_id?: Snowflake;\r\n  channel_id?: Snowflake;\r\n  guild_id?: Snowflake;\r\n  fail_if_not_exists?: boolean;\r\n}\r\n/** Raw Discord message reaction. */\r\nexport interface APIMessageReaction {\r\n  count: number;\r\n  count_details?: Record<string, number>;\r\n  me?: boolean;\r\n  me_burst?: boolean;\r\n  emoji: APIPartialEmoji;\r\n  burst_colors?: string[];\r\n}\r\n/** Raw Discord message object. */\r\nexport interface APIMessage {\r\n  id: Snowflake;\r\n  channel_id: Snowflake;\r\n  author: UserData;\r\n  content: string;\r\n  timestamp?: string;\r\n  edited_timestamp?: string | null;\r\n  tts?: boolean;\r\n  mention_everyone?: boolean;\r\n  mentions?: UserData[];\r\n  mention_roles?: Snowflake[];\r\n  mention_channels?: Array<Record<string, unknown>>;\r\n  attachments?: APIAttachment[];\r\n  embeds?: APIEmbed[];\r\n  reactions?: APIMessageReaction[];\r\n  nonce?: string | number | null;\r\n  pinned?: boolean;\r\n  webhook_id?: Snowflake;\r\n  type?: number;\r\n  activity?: Record<string, unknown>;\r\n  application?: Record<string, unknown>;\r\n  application_id?: Snowflake;\r\n  message_reference?: APIMessageReference;\r\n  flags?: number;\r\n  referenced_message?: APIMessage | null;\r\n  interaction_metadata?: Record<string, unknown>;\r\n  thread?: Record<string, unknown>;\r\n  components?: APIMessageComponent[];\r\n  sticker_items?: APIStickerItem[];\r\n  stickers?: APISticker[];\r\n  position?: number;\r\n  role_subscription_data?: Record<string, unknown>;\r\n  purchase_notification?: Record<string, unknown>;\r\n  poll?: Record<string, unknown>;\r\n  guild_id?: Snowflake;\r\n}\r\n\r\n// ─── Channels ────────────────────────────────────────────────────────────────\r\n\r\n/** Raw Discord channel object. */\r\nexport interface APIChannel {\r\n  id: Snowflake;\r\n  type: number;\r\n  guild_id?: Snowflake;\r\n  position?: number;\r\n  permission_overwrites?: Array<Record<string, unknown>>;\r\n  name?: string | null;\r\n  topic?: string | null;\r\n  nsfw?: boolean;\r\n  last_message_id?: Snowflake | null;\r\n  bitrate?: number;\r\n  user_limit?: number;\r\n  rate_limit_per_user?: number;\r\n  recipients?: UserData[];\r\n  icon?: string | null;\r\n  owner_id?: Snowflake;\r\n  application_id?: Snowflake;\r\n  parent_id?: Snowflake | null;\r\n  last_pin_timestamp?: string | null;\r\n  rtc_region?: string | null;\r\n  video_quality_mode?: number;\r\n  message_count?: number;\r\n  member_count?: number;\r\n  thread_metadata?: APIThreadMetadata;\r\n  default_auto_archive_duration?: number;\r\n  flags?: number;\r\n  total_message_sent?: number;\r\n  available_tags?: APIForumTag[];\r\n  default_reaction_emoji?: APIPartialEmoji | null;\r\n  default_thread_rate_limit_per_user?: number;\r\n  default_sort_order?: number | null;\r\n  default_forum_layout?: number;\r\n}\r\n\r\n/** Raw Discord thread metadata. */\r\nexport interface APIThreadMetadata {\r\n  archived: boolean;\r\n  auto_archive_duration: number;\r\n  archive_timestamp: string;\r\n  locked: boolean;\r\n  invitable?: boolean;\r\n  create_timestamp?: string | null;\r\n}\r\n\r\n/** Raw Discord forum tag. */\r\nexport interface APIForumTag {\r\n  id: Snowflake;\r\n  name: string;\r\n  moderated: boolean;\r\n  emoji_id?: Snowflake | null;\r\n  emoji_name?: string | null;\r\n}\r\n\r\n/** Raw Discord thread member. */\r\nexport interface APIThreadMember {\r\n  id?: Snowflake;\r\n  user_id?: Snowflake;\r\n  join_timestamp: string;\r\n  flags: number;\r\n  member?: APIGuildMember;\r\n}\r\n\r\n// ─── Roles ────────────────────────────────────────────────────────────────────\r\n\r\n/** Raw Discord role object. */\r\nexport interface APIRole {\r\n  id: Snowflake;\r\n  name: string;\r\n  color: number;\r\n  hoist: boolean;\r\n  icon?: string | null;\r\n  unicode_emoji?: string | null;\r\n  position: number;\r\n  permissions: string;\r\n  managed: boolean;\r\n  mentionable: boolean;\r\n  tags?: Record<string, unknown>;\r\n  flags?: number;\r\n}\r\n\r\n// ─── Emoji ────────────────────────────────────────────────────────────────────\r\n\r\n/** Raw Discord emoji object. */\r\nexport interface APIEmoji {\r\n  id: Snowflake | null;\r\n  name: string | null;\r\n  roles?: Snowflake[];\r\n  user?: UserData;\r\n  require_colons?: boolean;\r\n  managed?: boolean;\r\n  animated?: boolean;\r\n  available?: boolean;\r\n}\r\n\r\n// ─── Guilds ───────────────────────────────────────────────────────────────────\r\n\r\n/** Raw Discord guild object. */\r\nexport interface APIGuild {\r\n  id: Snowflake;\r\n  name: string;\r\n  icon?: string | null;\r\n  icon_hash?: string | null;\r\n  splash?: string | null;\r\n  discovery_splash?: string | null;\r\n  owner?: boolean;\r\n  owner_id?: Snowflake;\r\n  permissions?: string;\r\n  afk_channel_id?: Snowflake | null;\r\n  afk_timeout?: number;\r\n  widget_enabled?: boolean;\r\n  widget_channel_id?: Snowflake | null;\r\n  verification_level?: number;\r\n  default_message_notifications?: number;\r\n  explicit_content_filter?: number;\r\n  roles?: APIRole[];\r\n  emojis?: APIEmoji[];\r\n  stickers?: APISticker[];\r\n  features?: string[];\r\n  mfa_level?: number;\r\n  application_id?: Snowflake | null;\r\n  system_channel_id?: Snowflake | null;\r\n  system_channel_flags?: number;\r\n  rules_channel_id?: Snowflake | null;\r\n  max_presences?: number | null;\r\n  max_members?: number;\r\n  vanity_url_code?: string | null;\r\n  description?: string | null;\r\n  banner?: string | null;\r\n  premium_tier?: number;\r\n  premium_subscription_count?: number;\r\n  preferred_locale?: string;\r\n  public_updates_channel_id?: Snowflake | null;\r\n  max_video_channel_users?: number;\r\n  approximate_member_count?: number;\r\n  approximate_presence_count?: number;\r\n  nsfw_level?: number;\r\n  safety_alerts_channel_id?: Snowflake | null;\r\n  member_count?: number;\r\n}\r\n\r\n/** Raw Discord guild member object. */\r\nexport interface APIGuildMember {\r\n  user: UserData;\r\n  nick?: string | null;\r\n  avatar?: string | null;\r\n  roles: Snowflake[];\r\n  joined_at: string;\r\n  premium_since?: string | null;\r\n  deaf?: boolean;\r\n  mute?: boolean;\r\n  flags?: number;\r\n  pending?: boolean;\r\n  permissions?: string;\r\n  communication_disabled_until?: string | null;\r\n  guild_id?: Snowflake;\r\n}\r\n\r\n// ─── Voice ────────────────────────────────────────────────────────────────────\r\n\r\n/** Raw Discord voice state object. */\r\nexport interface APIVoiceState {\r\n  guild_id?: Snowflake;\r\n  channel_id?: Snowflake | null;\r\n  user_id: Snowflake;\r\n  member?: APIGuildMember;\r\n  session_id: string;\r\n  deaf: boolean;\r\n  mute: boolean;\r\n  self_deaf: boolean;\r\n  self_mute: boolean;\r\n  self_stream?: boolean;\r\n  self_video: boolean;\r\n  suppress: boolean;\r\n  request_to_speak_timestamp?: string | null;\r\n}\r\n\r\n/** Raw Discord voice server update event. */\r\nexport interface APIVoiceServerUpdate {\r\n  token: string;\r\n  guild_id: Snowflake;\r\n  endpoint?: string | null;\r\n}\r\n\r\n// ─── Presence ────────────────────────────────────────────────────────────────\r\n\r\n/** Raw Discord activity object. */\r\nexport interface APIActivity {\r\n  name: string;\r\n  type: number;\r\n  url?: string | null;\r\n  created_at: number;\r\n  state?: string | null;\r\n  details?: string | null;\r\n  emoji?: APIPartialEmoji | null;\r\n}\r\n\r\n/** Raw Discord presence update event. */\r\nexport interface APIPresenceUpdate {\r\n  user: { id: Snowflake } & Partial<UserData>;\r\n  guild_id: Snowflake;\r\n  status: string;\r\n  activities: APIActivity[];\r\n  client_status: { desktop?: string; mobile?: string; web?: string };\r\n}\r\n\r\n// ─── Typing ───────────────────────────────────────────────────────────────────\r\n\r\n/** Raw Discord typing start event. */\r\nexport interface APITypingStart {\r\n  channel_id: Snowflake;\r\n  guild_id?: Snowflake;\r\n  user_id: Snowflake;\r\n  timestamp: number;\r\n  member?: APIGuildMember;\r\n}\r\n\r\n// ─── Guilds ──────────────────────────────────────────────────────────────────\r\n\r\n/** Raw Discord guild preview. */\r\nexport interface APIGuildPreview {\r\n  id: Snowflake;\r\n  name: string;\r\n  icon: string | null;\r\n  splash: string | null;\r\n  discovery_splash: string | null;\r\n  emojis: unknown[];\r\n  features: string[];\r\n  approximate_member_count: number;\r\n  approximate_presence_count: number;\r\n  description: string | null;\r\n  stickers: unknown[];\r\n}\r\n\r\n// ─── Invites ─────────────────────────────────────────────────────────────────\r\n\r\n/** Raw Discord invite. */\r\nexport interface APIInvite {\r\n  code: string;\r\n  guild?: Partial<APIGuild>;\r\n  channel: Partial<APIChannel>;\r\n  inviter?: UserData;\r\n  target_type?: number;\r\n  target_user?: UserData;\r\n  approximate_presence_count?: number;\r\n  approximate_member_count?: number;\r\n}\r\n\r\n/** Raw Discord invite create event. */\r\nexport interface APIInviteCreate {\r\n  channel_id: Snowflake;\r\n  code: string;\r\n  created_at: string;\r\n  guild_id?: Snowflake;\r\n  inviter?: UserData;\r\n  max_age: number;\r\n  max_uses: number;\r\n  target_type?: number;\r\n  target_user?: UserData;\r\n  temporary: boolean;\r\n  uses: number;\r\n}\r\n\r\n/** Raw Discord invite delete event. */\r\nexport interface APIInviteDelete {\r\n  channel_id: Snowflake;\r\n  guild_id?: Snowflake;\r\n  code: string;\r\n}\r\n\r\n// ─── Webhooks ────────────────────────────────────────────────────────────────\r\n\r\n/** Raw Discord webhooks update event. */\r\nexport interface APIWebhooksUpdate {\r\n  guild_id: Snowflake;\r\n  channel_id: Snowflake;\r\n}\r\n\r\n/** Raw Discord webhook object. */\r\nexport interface APIWebhook {\r\n  id: Snowflake;\r\n  type: number;\r\n  guild_id?: Snowflake | null;\r\n  channel_id?: Snowflake | null;\r\n  user?: UserData;\r\n  name?: string | null;\r\n  avatar?: string | null;\r\n  token?: string;\r\n  application_id?: Snowflake | null;\r\n  url?: string;\r\n}\r\n\r\n// ─── AutoMod ─────────────────────────────────────────────────────────────────\r\n\r\n/** Raw Discord AutoMod action. */\r\nexport interface APIAutoModerationAction {\r\n  type: number;\r\n  metadata?: {\r\n    channel_id?: Snowflake;\r\n    duration_seconds?: number;\r\n    custom_message?: string;\r\n  };\r\n}\r\n\r\n/** Raw Discord AutoMod rule object. */\r\nexport interface APIAutoModerationRule {\r\n  id: Snowflake;\r\n  guild_id: Snowflake;\r\n  name: string;\r\n  creator_id: Snowflake;\r\n  event_type: number;\r\n  trigger_type: number;\r\n  trigger_metadata: Record<string, unknown>;\r\n  actions: APIAutoModerationAction[];\r\n  enabled: boolean;\r\n  exempt_roles: Snowflake[];\r\n  exempt_channels: Snowflake[];\r\n}\r\n\r\n/** Raw Discord AutoMod action execution event. */\r\nexport interface APIAutoModerationActionExecution {\r\n  guild_id: Snowflake;\r\n  action: APIAutoModerationAction;\r\n  rule_id: Snowflake;\r\n  rule_trigger_type: number;\r\n  user_id: Snowflake;\r\n  channel_id?: Snowflake;\r\n  message_id?: Snowflake;\r\n  alert_system_message_id?: Snowflake;\r\n  content: string;\r\n  matched_keyword?: string | null;\r\n  matched_content?: string | null;\r\n}\r\n\r\n// ─── Scheduled Events ─────────────────────────────────────────────────────────\r\n\r\n/** Raw Discord guild scheduled event entity metadata. */\r\nexport interface APIGuildScheduledEventEntityMetadata {\r\n  location?: string;\r\n}\r\n\r\n/** Raw Discord guild scheduled event object. */\r\nexport interface APIGuildScheduledEvent {\r\n  id: Snowflake;\r\n  guild_id: Snowflake;\r\n  channel_id?: Snowflake | null;\r\n  creator_id?: Snowflake | null;\r\n  name: string;\r\n  description?: string | null;\r\n  scheduled_start_time: string;\r\n  scheduled_end_time?: string | null;\r\n  privacy_level: number;\r\n  status: number;\r\n  entity_type: number;\r\n  entity_id?: Snowflake | null;\r\n  entity_metadata?: APIGuildScheduledEventEntityMetadata | null;\r\n  creator?: UserData;\r\n  user_count?: number;\r\n  image?: string | null;\r\n}\r\n\r\n// ─── Stage Instances ─────────────────────────────────────────────────────────\r\n\r\n/** Raw Discord stage instance object. */\r\nexport interface APIStageInstance {\r\n  id: Snowflake;\r\n  guild_id: Snowflake;\r\n  channel_id: Snowflake;\r\n  topic: string;\r\n  privacy_level: number;\r\n  discoverable_disabled?: boolean;\r\n  guild_scheduled_event_id?: Snowflake | null;\r\n}\r\n\r\n// ─── Application Commands ─────────────────────────────────────────────────────\r\n\r\n/** Discord application command option types. */\r\nexport const ApplicationCommandOptionType = {\r\n  SubCommand: 1,\r\n  SubCommandGroup: 2,\r\n  String: 3,\r\n  Integer: 4,\r\n  Boolean: 5,\r\n  User: 6,\r\n  Channel: 7,\r\n  Role: 8,\r\n  Mentionable: 9,\r\n  Number: 10,\r\n  Attachment: 11,\r\n} as const;\r\n\r\n/** Discord application command types. */\r\nexport const ApplicationCommandType = {\r\n  ChatInput: 1,\r\n  User: 2,\r\n  Message: 3,\r\n} as const;\r\n\r\n/** Raw Discord application command option. */\r\nexport interface APIApplicationCommandOption {\r\n  type: number;\r\n  name: string;\r\n  description: string;\r\n  required?: boolean;\r\n  choices?: Array<{ name: string; value: string | number }>;\r\n  options?: APIApplicationCommandOption[];\r\n  min_value?: number;\r\n  max_value?: number;\r\n  min_length?: number;\r\n  max_length?: number;\r\n  autocomplete?: boolean;\r\n  channel_types?: number[];\r\n}\r\n\r\n/** Raw Discord application command object (from API). */\r\nexport interface APIApplicationCommand {\r\n  id: Snowflake;\r\n  type?: number;\r\n  application_id: Snowflake;\r\n  guild_id?: Snowflake;\r\n  name: string;\r\n  description: string;\r\n  options?: APIApplicationCommandOption[];\r\n  default_member_permissions?: string | null;\r\n  dm_permission?: boolean;\r\n  nsfw?: boolean;\r\n  version: Snowflake;\r\n}\r\n\r\n/** Data for creating/overwriting an application command. */\r\nexport interface ApplicationCommandData {\r\n  name: string;\r\n  description: string;\r\n  type?: number;\r\n  options?: APIApplicationCommandOption[];\r\n  default_member_permissions?: string | null;\r\n  dm_permission?: boolean;\r\n  nsfw?: boolean;\r\n}\r\n\r\n// ─── Gateway Events ───────────────────────────────────────────────────────────\r\n\r\n/** Raw Discord READY event payload. */\r\nexport interface APIReadyEvent {\r\n  v: number;\r\n  user: UserData;\r\n  guilds: Array<{ id: Snowflake; unavailable?: boolean }>;\r\n  session_id: string;\r\n  resume_gateway_url: string;\r\n  shard?: [number, number];\r\n  application?: { id: Snowflake; flags: number; [key: string]: unknown };\r\n}\r\n\r\n/** Raw Discord reaction event payload. */\r\nexport interface APIMessageReactionEvent {\r\n  user_id: Snowflake;\r\n  channel_id: Snowflake;\r\n  message_id: Snowflake;\r\n  guild_id?: Snowflake;\r\n  member?: APIGuildMember;\r\n  emoji: APIPartialEmoji;\r\n  message_author_id?: Snowflake;\r\n  burst?: boolean;\r\n  type?: number;\r\n}\r\n\r\n/** Raw Discord reaction remove emoji event payload. */\r\nexport interface APIMessageReactionRemoveEmojiEvent {\r\n  channel_id: Snowflake;\r\n  guild_id?: Snowflake;\r\n  message_id: Snowflake;\r\n  emoji: APIPartialEmoji;\r\n}\r\n\r\n/** Raw Discord message deletion event payload. */\r\nexport interface APIMessageDeleteEvent {\r\n  id: Snowflake;\r\n  channel_id: Snowflake;\r\n  guild_id?: Snowflake;\r\n}\r\n\r\n/** Raw Discord bulk message deletion event payload. */\r\nexport interface APIMessageDeleteBulkEvent {\r\n  ids: Snowflake[];\r\n  channel_id: Snowflake;\r\n  guild_id?: Snowflake;\r\n}\r\n\r\n/** Raw Discord channel deletion event payload. */\r\nexport interface APIChannelDeleteEvent extends APIChannel {}\r\n\r\n/** Raw Discord guild deletion event payload. */\r\nexport interface APIGuildDeleteEvent {\r\n  id: Snowflake;\r\n  unavailable?: boolean;\r\n}\r\n\r\n/** Raw Discord thread lifecycle payload. */\r\nexport interface APIThreadEvent extends APIChannel {\r\n  guild_id: Snowflake;\r\n  member?: APIThreadMember;\r\n}\r\n\r\n/** Raw Discord thread list sync event. */\r\nexport interface APIThreadListSync {\r\n  guild_id: Snowflake;\r\n  channel_ids?: Snowflake[];\r\n  threads: APIChannel[];\r\n  members: APIThreadMember[];\r\n}\r\n\r\n/** Raw Discord thread members update event. */\r\nexport interface APIThreadMembersUpdate {\r\n  id: Snowflake;\r\n  guild_id: Snowflake;\r\n  member_count: number;\r\n  added_members?: APIThreadMember[];\r\n  removed_member_ids?: Snowflake[];\r\n}\r\n\r\n/** Raw Discord guild role event payload. */\r\nexport interface APIGuildRoleEvent {\r\n  guild_id: Snowflake;\r\n  role: APIRole;\r\n}\r\n\r\n/** Raw Discord guild role delete event payload. */\r\nexport interface APIGuildRoleDeleteEvent {\r\n  guild_id: Snowflake;\r\n  role_id: Snowflake;\r\n}\r\n\r\n/** Raw Discord guild ban event payload. */\r\nexport interface APIGuildBanEvent {\r\n  guild_id: Snowflake;\r\n  user: UserData;\r\n}\r\n\r\n/** Raw Discord guild emojis update event payload. */\r\nexport interface APIGuildEmojisUpdateEvent {\r\n  guild_id: Snowflake;\r\n  emojis: APIEmoji[];\r\n}\r\n\r\n/** Raw Discord guild stickers update event payload. */\r\nexport interface APIGuildStickersUpdateEvent {\r\n  guild_id: Snowflake;\r\n  stickers: APISticker[];\r\n}\r\n\r\n/** Raw Discord channel pins update event. */\r\nexport interface APIChannelPinsUpdate {\r\n  guild_id?: Snowflake;\r\n  channel_id: Snowflake;\r\n  last_pin_timestamp?: string | null;\r\n}\r\n\r\n/** Raw Discord guild members chunk event. */\r\nexport interface APIGuildMembersChunk {\r\n  guild_id: Snowflake;\r\n  members: APIGuildMember[];\r\n  chunk_index: number;\r\n  chunk_count: number;\r\n  not_found?: Snowflake[];\r\n  presences?: APIPresenceUpdate[];\r\n  nonce?: string;\r\n}\r\n\r\n/** Raw Discord guild scheduled event user add/remove event. */\r\nexport interface APIGuildScheduledEventUserEvent {\r\n  guild_scheduled_event_id: Snowflake;\r\n  user_id: Snowflake;\r\n  guild_id: Snowflake;\r\n}\r\n\r\n/** Raw Discord message poll vote add/remove event. */\r\nexport interface APIMessagePollVoteEvent {\r\n  user_id: Snowflake;\r\n  channel_id: Snowflake;\r\n  message_id: Snowflake;\r\n  guild_id?: Snowflake;\r\n  answer_id: number;\r\n}\r\n"
+    "/** Discord API snowflake identifier. */\r\nexport type Snowflake = string;\r\n\r\n// ─── Gateway Intents ─────────────────────────────────────────────────────────\r\n\r\n/** Gateway intent bit flags supported by Discord (PascalCase). */\r\nexport const GatewayIntentBits = {\r\n    Guilds: 1 << 0,\r\n    GuildMembers: 1 << 1,\r\n    GuildModeration: 1 << 2,\r\n    GuildExpressions: 1 << 3,\r\n    GuildIntegrations: 1 << 4,\r\n    GuildWebhooks: 1 << 5,\r\n    GuildInvites: 1 << 6,\r\n    GuildVoiceStates: 1 << 7,\r\n    GuildPresences: 1 << 8,\r\n    GuildMessages: 1 << 9,\r\n    GuildMessageReactions: 1 << 10,\r\n    GuildMessageTyping: 1 << 11,\r\n    DirectMessages: 1 << 12,\r\n    DirectMessageReactions: 1 << 13,\r\n    DirectMessageTyping: 1 << 14,\r\n    MessageContent: 1 << 15,\r\n    GuildScheduledEvents: 1 << 16,\r\n    AutoModerationConfiguration: 1 << 20,\r\n    AutoModerationExecution: 1 << 21,\r\n    GuildMessagePolls: 1 << 24,\r\n    DirectMessagePolls: 1 << 25,\r\n} as const;\r\n\r\n/** Idiomatic camelCase Gateway intent bit flags supported by Discord. */\r\nexport const IntentBits = {\r\n    guild: 1 << 0,\r\n    guilds: 1 << 0,\r\n    guildMembers: 1 << 1,\r\n    guildModeration: 1 << 2,\r\n    guildBans: 1 << 2,\r\n    guildExpressions: 1 << 3,\r\n    guildEmojis: 1 << 3,\r\n    guildEmojisAndStickers: 1 << 3,\r\n    guildIntegrations: 1 << 4,\r\n    guildWebhooks: 1 << 5,\r\n    guildInvites: 1 << 6,\r\n    guildVoiceStates: 1 << 7,\r\n    guildPresences: 1 << 8,\r\n    guildMessages: 1 << 9,\r\n    guildMessage: 1 << 9,\r\n    guildMessageReactions: 1 << 10,\r\n    guildMessageTyping: 1 << 11,\r\n    directMessages: 1 << 12,\r\n    directMessageReactions: 1 << 13,\r\n    directMessageTyping: 1 << 14,\r\n    messageContent: 1 << 15,\r\n    guildScheduledEvents: 1 << 16,\r\n    autoModerationConfiguration: 1 << 20,\r\n    autoModerationExecution: 1 << 21,\r\n    guildMessagePolls: 1 << 24,\r\n    directMessagePolls: 1 << 25,\r\n} as const;\r\n\r\n/** Alias for IntentBits. */\r\nexport const Intents = IntentBits;\r\n\r\n/** Gateway intent resolvable value (single bitfield, enum key, or array of bitfields/strings). */\r\nexport type GatewayIntentResolvable =\r\n    | number\r\n    | keyof typeof GatewayIntentBits\r\n    | keyof typeof IntentBits\r\n    | (\r\n          | number\r\n          | keyof typeof GatewayIntentBits\r\n          | keyof typeof IntentBits\r\n          | string\r\n      )[];\r\n\r\n/** Resolves any GatewayIntentResolvable into a raw bitfield integer. */\r\nexport function resolveGatewayIntents(\r\n    intents: GatewayIntentResolvable,\r\n): number {\r\n    if (typeof intents === \"number\") return intents;\r\n    if (Array.isArray(intents)) {\r\n        return intents.reduce<number>((acc, intent) => {\r\n            return acc | resolveGatewayIntents(intent as any);\r\n        }, 0);\r\n    }\r\n    if (typeof intents === \"string\") {\r\n        if (intents in GatewayIntentBits)\r\n            return (GatewayIntentBits as Record<string, number>)[intents]!;\r\n        if (intents in IntentBits)\r\n            return (IntentBits as Record<string, number>)[intents]!;\r\n        const lower = intents.charAt(0).toLowerCase() + intents.slice(1);\r\n        if (lower in IntentBits)\r\n            return (IntentBits as Record<string, number>)[lower]!;\r\n        const num = Number(intents);\r\n        if (!Number.isNaN(num)) return num;\r\n    }\r\n    return 0;\r\n}\r\n\r\n// ─── Gateway Config ───────────────────────────────────────────────────────────\r\n\r\n/** Gateway connection properties (OS, browser, device). */\r\nexport interface GatewayProperties {\r\n    os?: string;\r\n    browser?: string;\r\n    device?: string;\r\n    [key: string]: unknown;\r\n}\r\n/** Gateway presence activity. */\r\nexport interface GatewayPresenceActivity {\r\n    name: string;\r\n    type?: number;\r\n    url?: string;\r\n    state?: string;\r\n}\r\n/** Gateway presence data. */\r\nexport interface GatewayPresence {\r\n    status?: \"online\" | \"dnd\" | \"idle\" | \"invisible\" | \"offline\";\r\n    activities?: GatewayPresenceActivity[];\r\n    afk?: boolean;\r\n    since?: number | null;\r\n}\r\n/** Client configuration. */\r\nexport interface ClientOptions {\r\n    token: string;\r\n    intents: GatewayIntentResolvable;\r\n    gateway?: GatewayOptions;\r\n    rest?: RESTOptions;\r\n}\r\n/** Gateway connection configuration. */\r\nexport interface GatewayOptions {\r\n    intents?: GatewayIntentResolvable;\r\n    reconnect?: boolean;\r\n    maxReconnectAttempts?: number;\r\n    reconnectBaseDelay?: number;\r\n    reconnectMaxDelay?: number;\r\n    shardId?: number;\r\n    shardCount?: number;\r\n    properties?: GatewayProperties;\r\n    presence?: GatewayPresence;\r\n}\r\n\r\n/** REST request configuration. */\r\nexport interface RESTOptions {\r\n    timeout?: number;\r\n    retries?: number;\r\n    baseURL?: string;\r\n}\r\n\r\n// ─── Core Discord Objects ─────────────────────────────────────────────────────\r\n\r\n/** Discord user object. */\r\nexport interface UserData {\r\n    id: Snowflake;\r\n    username: string;\r\n    discriminator?: string;\r\n    global_name?: string | null;\r\n    avatar?: string | null;\r\n    bot?: boolean;\r\n    system?: boolean;\r\n    public_flags?: number;\r\n}\r\n/** Current authenticated bot user. */\r\nexport type ClientUser = UserData;\r\n/** Discord Gateway payload envelope. */\r\nexport interface GatewayPayload<T = unknown> {\r\n    op: number;\r\n    d: T | null;\r\n    s: number | null;\r\n    t: string | null;\r\n}\r\n/** Generic Discord API error payload. */\r\nexport interface APIError {\r\n    code?: number;\r\n    message?: string;\r\n    errors?: Record<string, unknown>;\r\n}\r\n\r\n// ─── Discord Flags & Enums ────────────────────────────────────────────────────\r\n\r\n/** Discord message flags. */\r\nexport const MessageFlags = {\r\n    Crossposted: 1,\r\n    IsCrosspost: 2,\r\n    SuppressEmbeds: 4,\r\n    SourceMessageDeleted: 8,\r\n    Urgent: 16,\r\n    HasThread: 32,\r\n    Ephemeral: 64,\r\n    Loading: 128,\r\n    IsComponentsV2: 32768,\r\n} as const;\r\n\r\n/** Discord channel types. */\r\nexport const ChannelType = {\r\n    GuildText: 0,\r\n    DM: 1,\r\n    GuildVoice: 2,\r\n    GroupDM: 3,\r\n    GuildCategory: 4,\r\n    GuildAnnouncement: 5,\r\n    AnnouncementThread: 10,\r\n    PublicThread: 11,\r\n    PrivateThread: 12,\r\n    GuildStageVoice: 13,\r\n    GuildDirectory: 14,\r\n    GuildForum: 15,\r\n    GuildMedia: 16,\r\n} as const;\r\n\r\n/** Discord component types. */\r\nexport const ComponentType = {\r\n    ActionRow: 1,\r\n    Button: 2,\r\n    StringSelect: 3,\r\n    TextInput: 4,\r\n    UserSelect: 5,\r\n    RoleSelect: 6,\r\n    MentionableSelect: 7,\r\n    ChannelSelect: 8,\r\n    Section: 9,\r\n    TextDisplay: 10,\r\n    Thumbnail: 11,\r\n    MediaGallery: 12,\r\n    File: 13,\r\n    Separator: 14,\r\n    ContentInventoryEntry: 16,\r\n    Container: 17,\r\n} as const;\r\n\r\n/** Discord button style types. */\r\nexport const ButtonStyle = {\r\n    Primary: 1,\r\n    Secondary: 2,\r\n    Success: 3,\r\n    Danger: 4,\r\n    Link: 5,\r\n    Premium: 6,\r\n} as const;\r\n\r\n/** Discord text input style types. */\r\nexport const TextInputStyle = {\r\n    Short: 1,\r\n    Paragraph: 2,\r\n} as const;\r\n\r\n/** Discord interaction response types. */\r\nexport const InteractionResponseType = {\r\n    Pong: 1,\r\n    ChannelMessage: 4,\r\n    DeferredChannelMessage: 5,\r\n    DeferredMessageUpdate: 6,\r\n    MessageUpdate: 7,\r\n    Autocomplete: 8,\r\n    Modal: 9,\r\n} as const;\r\n\r\n/** Discord sticker format types. */\r\nexport const StickerFormatType = {\r\n    PNG: 1,\r\n    APNG: 2,\r\n    Lottie: 3,\r\n    GIF: 4,\r\n} as const;\r\n\r\n/** Discord sticker types. */\r\nexport const StickerType = {\r\n    Standard: 1,\r\n    Guild: 2,\r\n} as const;\r\n\r\n/** Discord verification levels. */\r\nexport const VerificationLevel = {\r\n    None: 0,\r\n    Low: 1,\r\n    Medium: 2,\r\n    High: 3,\r\n    VeryHigh: 4,\r\n} as const;\r\n\r\n/** Discord premium tiers. */\r\nexport const PremiumTier = {\r\n    None: 0,\r\n    Tier1: 1,\r\n    Tier2: 2,\r\n    Tier3: 3,\r\n} as const;\r\n\r\n// ─── Embeds ───────────────────────────────────────────────────────────────────\r\n\r\n/** Raw Discord embed footer object. */\r\nexport interface APIEmbedFooter {\r\n    text: string;\r\n    icon_url?: string;\r\n    proxy_icon_url?: string;\r\n}\r\n/** Raw Discord embed image/thumbnail/video object. */\r\nexport interface APIEmbedMedia {\r\n    url: string;\r\n    proxy_url?: string;\r\n    height?: number;\r\n    width?: number;\r\n}\r\n/** Raw Discord embed provider object. */\r\nexport interface APIEmbedProvider {\r\n    name?: string;\r\n    url?: string;\r\n}\r\n/** Raw Discord embed author object. */\r\nexport interface APIEmbedAuthor {\r\n    name: string;\r\n    url?: string;\r\n    icon_url?: string;\r\n    proxy_icon_url?: string;\r\n}\r\n/** Raw Discord embed field object. */\r\nexport interface APIEmbedField {\r\n    name: string;\r\n    value: string;\r\n    inline?: boolean;\r\n}\r\n/** Raw Discord embed object. */\r\nexport interface APIEmbed {\r\n    title?: string;\r\n    type?: string;\r\n    description?: string;\r\n    url?: string;\r\n    timestamp?: string;\r\n    color?: number;\r\n    footer?: APIEmbedFooter;\r\n    image?: APIEmbedMedia;\r\n    thumbnail?: APIEmbedMedia;\r\n    video?: APIEmbedMedia;\r\n    provider?: APIEmbedProvider;\r\n    author?: APIEmbedAuthor;\r\n    fields?: APIEmbedField[];\r\n}\r\n\r\n// ─── Message Components ───────────────────────────────────────────────────────\r\n\r\n/** Raw Discord select menu option. */\r\nexport interface APISelectMenuOption {\r\n    label: string;\r\n    value: string;\r\n    description?: string;\r\n    emoji?: APIPartialEmoji;\r\n    default?: boolean;\r\n}\r\n/** Raw Discord emoji (partial, as used in components). */\r\nexport interface APIPartialEmoji {\r\n    id?: Snowflake | null;\r\n    name?: string | null;\r\n    animated?: boolean;\r\n}\r\n/** Raw Discord button component. */\r\nexport interface APIButtonComponent {\r\n    type: 2;\r\n    style: number;\r\n    label?: string;\r\n    emoji?: APIPartialEmoji;\r\n    custom_id?: string;\r\n    url?: string;\r\n    sku_id?: string;\r\n    disabled?: boolean;\r\n}\r\n/** Raw Discord select menu component. */\r\nexport interface APISelectMenuComponent {\r\n    type: 3 | 5 | 6 | 7 | 8;\r\n    custom_id: string;\r\n    options?: APISelectMenuOption[];\r\n    channel_types?: number[];\r\n    placeholder?: string;\r\n    min_values?: number;\r\n    max_values?: number;\r\n    disabled?: boolean;\r\n}\r\n/** Raw Discord text input component. */\r\nexport interface APITextInputComponent {\r\n    type: 4;\r\n    custom_id: string;\r\n    style: number;\r\n    label: string;\r\n    min_length?: number;\r\n    max_length?: number;\r\n    required?: boolean;\r\n    value?: string;\r\n    placeholder?: string;\r\n}\r\n/** Union of all raw message component types. */\r\nexport type APIMessageActionRowComponent =\r\n    APIButtonComponent | APISelectMenuComponent | APITextInputComponent;\r\n/** Raw Discord action row component. */\r\nexport interface APIActionRowComponent {\r\n    type: 1;\r\n    id?: number;\r\n    components: APIMessageActionRowComponent[];\r\n}\r\n/** Union including action rows and V2 components. */\r\nexport type APIMessageComponent =\r\n    APIActionRowComponent | { type: Exclude<number, 1>; [key: string]: any };\r\n\r\n// ─── Attachments ─────────────────────────────────────────────────────────────\r\n\r\n/** Raw Discord attachment object. */\r\nexport interface APIAttachment {\r\n    id: Snowflake;\r\n    filename: string;\r\n    description?: string | null;\r\n    content_type?: string;\r\n    size: number;\r\n    url: string;\r\n    proxy_url: string;\r\n    height?: number | null;\r\n    width?: number | null;\r\n    ephemeral?: boolean;\r\n    duration_secs?: number;\r\n    waveform?: string;\r\n    flags?: number;\r\n}\r\n\r\n// ─── Stickers ────────────────────────────────────────────────────────────────\r\n\r\n/** Compact sticker item as included in messages. */\r\nexport interface APIStickerItem {\r\n    id: Snowflake;\r\n    name: string;\r\n    format_type: number;\r\n}\r\n/** Full Discord sticker object. */\r\nexport interface APISticker {\r\n    id: Snowflake;\r\n    pack_id?: Snowflake;\r\n    name: string;\r\n    description?: string | null;\r\n    tags?: string;\r\n    type: number;\r\n    format_type: number;\r\n    available?: boolean;\r\n    guild_id?: Snowflake;\r\n    user?: UserData;\r\n    sort_value?: number;\r\n}\r\n\r\n// ─── Messages ────────────────────────────────────────────────────────────────\r\n\r\n/** Raw Discord message reference. */\r\nexport interface APIMessageReference {\r\n    type?: number;\r\n    message_id?: Snowflake;\r\n    channel_id?: Snowflake;\r\n    guild_id?: Snowflake;\r\n    fail_if_not_exists?: boolean;\r\n}\r\n/** Raw Discord message reaction. */\r\nexport interface APIMessageReaction {\r\n    count: number;\r\n    count_details?: Record<string, number>;\r\n    me?: boolean;\r\n    me_burst?: boolean;\r\n    emoji: APIPartialEmoji;\r\n    burst_colors?: string[];\r\n}\r\n/** Raw Discord message object. */\r\nexport interface APIMessage {\r\n    id: Snowflake;\r\n    channel_id: Snowflake;\r\n    author: UserData;\r\n    content: string;\r\n    timestamp?: string;\r\n    edited_timestamp?: string | null;\r\n    tts?: boolean;\r\n    mention_everyone?: boolean;\r\n    mentions?: UserData[];\r\n    mention_roles?: Snowflake[];\r\n    mention_channels?: Array<Record<string, unknown>>;\r\n    attachments?: APIAttachment[];\r\n    embeds?: APIEmbed[];\r\n    reactions?: APIMessageReaction[];\r\n    nonce?: string | number | null;\r\n    pinned?: boolean;\r\n    webhook_id?: Snowflake;\r\n    type?: number;\r\n    activity?: Record<string, unknown>;\r\n    application?: Record<string, unknown>;\r\n    application_id?: Snowflake;\r\n    message_reference?: APIMessageReference;\r\n    flags?: number;\r\n    referenced_message?: APIMessage | null;\r\n    interaction_metadata?: Record<string, unknown>;\r\n    thread?: Record<string, unknown>;\r\n    components?: APIMessageComponent[];\r\n    sticker_items?: APIStickerItem[];\r\n    stickers?: APISticker[];\r\n    position?: number;\r\n    role_subscription_data?: Record<string, unknown>;\r\n    purchase_notification?: Record<string, unknown>;\r\n    poll?: Record<string, unknown>;\r\n    guild_id?: Snowflake;\r\n}\r\n\r\n// ─── Channels ────────────────────────────────────────────────────────────────\r\n\r\n/** Raw Discord channel object. */\r\nexport interface APIChannel {\r\n    id: Snowflake;\r\n    type: number;\r\n    guild_id?: Snowflake;\r\n    position?: number;\r\n    permission_overwrites?: Array<Record<string, unknown>>;\r\n    name?: string | null;\r\n    topic?: string | null;\r\n    nsfw?: boolean;\r\n    last_message_id?: Snowflake | null;\r\n    bitrate?: number;\r\n    user_limit?: number;\r\n    rate_limit_per_user?: number;\r\n    recipients?: UserData[];\r\n    icon?: string | null;\r\n    owner_id?: Snowflake;\r\n    application_id?: Snowflake;\r\n    parent_id?: Snowflake | null;\r\n    last_pin_timestamp?: string | null;\r\n    rtc_region?: string | null;\r\n    video_quality_mode?: number;\r\n    message_count?: number;\r\n    member_count?: number;\r\n    thread_metadata?: APIThreadMetadata;\r\n    default_auto_archive_duration?: number;\r\n    flags?: number;\r\n    total_message_sent?: number;\r\n    available_tags?: APIForumTag[];\r\n    default_reaction_emoji?: APIPartialEmoji | null;\r\n    default_thread_rate_limit_per_user?: number;\r\n    default_sort_order?: number | null;\r\n    default_forum_layout?: number;\r\n}\r\n\r\n/** Raw Discord thread metadata. */\r\nexport interface APIThreadMetadata {\r\n    archived: boolean;\r\n    auto_archive_duration: number;\r\n    archive_timestamp: string;\r\n    locked: boolean;\r\n    invitable?: boolean;\r\n    create_timestamp?: string | null;\r\n}\r\n\r\n/** Raw Discord forum tag. */\r\nexport interface APIForumTag {\r\n    id: Snowflake;\r\n    name: string;\r\n    moderated: boolean;\r\n    emoji_id?: Snowflake | null;\r\n    emoji_name?: string | null;\r\n}\r\n\r\n/** Raw Discord thread member. */\r\nexport interface APIThreadMember {\r\n    id?: Snowflake;\r\n    user_id?: Snowflake;\r\n    join_timestamp: string;\r\n    flags: number;\r\n    member?: APIGuildMember;\r\n}\r\n\r\n// ─── Roles ────────────────────────────────────────────────────────────────────\r\n\r\n/** Raw Discord role object. */\r\nexport interface APIRole {\r\n    id: Snowflake;\r\n    name: string;\r\n    color: number;\r\n    hoist: boolean;\r\n    icon?: string | null;\r\n    unicode_emoji?: string | null;\r\n    position: number;\r\n    permissions: string;\r\n    managed: boolean;\r\n    mentionable: boolean;\r\n    tags?: Record<string, unknown>;\r\n    flags?: number;\r\n}\r\n\r\n// ─── Emoji ────────────────────────────────────────────────────────────────────\r\n\r\n/** Raw Discord emoji object. */\r\nexport interface APIEmoji {\r\n    id: Snowflake | null;\r\n    name: string | null;\r\n    roles?: Snowflake[];\r\n    user?: UserData;\r\n    require_colons?: boolean;\r\n    managed?: boolean;\r\n    animated?: boolean;\r\n    available?: boolean;\r\n}\r\n\r\n// ─── Guilds ───────────────────────────────────────────────────────────────────\r\n\r\n/** Raw Discord guild object. */\r\nexport interface APIGuild {\r\n    id: Snowflake;\r\n    name: string;\r\n    icon?: string | null;\r\n    icon_hash?: string | null;\r\n    splash?: string | null;\r\n    discovery_splash?: string | null;\r\n    owner?: boolean;\r\n    owner_id?: Snowflake;\r\n    permissions?: string;\r\n    afk_channel_id?: Snowflake | null;\r\n    afk_timeout?: number;\r\n    widget_enabled?: boolean;\r\n    widget_channel_id?: Snowflake | null;\r\n    verification_level?: number;\r\n    default_message_notifications?: number;\r\n    explicit_content_filter?: number;\r\n    roles?: APIRole[];\r\n    emojis?: APIEmoji[];\r\n    stickers?: APISticker[];\r\n    features?: string[];\r\n    mfa_level?: number;\r\n    application_id?: Snowflake | null;\r\n    system_channel_id?: Snowflake | null;\r\n    system_channel_flags?: number;\r\n    rules_channel_id?: Snowflake | null;\r\n    max_presences?: number | null;\r\n    max_members?: number;\r\n    vanity_url_code?: string | null;\r\n    description?: string | null;\r\n    banner?: string | null;\r\n    premium_tier?: number;\r\n    premium_subscription_count?: number;\r\n    preferred_locale?: string;\r\n    public_updates_channel_id?: Snowflake | null;\r\n    max_video_channel_users?: number;\r\n    approximate_member_count?: number;\r\n    approximate_presence_count?: number;\r\n    nsfw_level?: number;\r\n    safety_alerts_channel_id?: Snowflake | null;\r\n    member_count?: number;\r\n}\r\n\r\n// ─── Welcome Screen ───────────────────────────────────────────────────────────\r\n\r\nexport interface APIWelcomeScreenChannel {\r\n    channel_id: Snowflake;\r\n    description: string;\r\n    emoji_id: Snowflake | null;\r\n    emoji_name: string | null;\r\n}\r\n\r\nexport interface APIGuildWelcomeScreen {\r\n    description: string | null;\r\n    welcome_channels: APIWelcomeScreenChannel[];\r\n}\r\n\r\n// ─── Guild Onboarding ─────────────────────────────────────────────────────────\r\n\r\nexport interface APIOnboardingPromptOption {\r\n    id: Snowflake;\r\n    channel_ids: Snowflake[];\r\n    role_ids: Snowflake[];\r\n    emoji?: APIPartialEmoji;\r\n    title: string;\r\n    description: string | null;\r\n}\r\n\r\nexport interface APIOnboardingPrompt {\r\n    id: Snowflake;\r\n    type: number;\r\n    options: APIOnboardingPromptOption[];\r\n    title: string;\r\n    single_select: boolean;\r\n    required: boolean;\r\n    in_onboarding: boolean;\r\n}\r\n\r\nexport interface APIGuildOnboarding {\r\n    guild_id: Snowflake;\r\n    prompts: APIOnboardingPrompt[];\r\n    default_channel_ids: Snowflake[];\r\n    enabled: boolean;\r\n    mode: number;\r\n}\r\n\r\n/** Raw Discord guild member object. */\r\nexport interface APIGuildMember {\r\n    user: UserData;\r\n    nick?: string | null;\r\n    avatar?: string | null;\r\n    roles: Snowflake[];\r\n    joined_at: string;\r\n    premium_since?: string | null;\r\n    deaf?: boolean;\r\n    mute?: boolean;\r\n    flags?: number;\r\n    pending?: boolean;\r\n    permissions?: string;\r\n    communication_disabled_until?: string | null;\r\n    guild_id?: Snowflake;\r\n}\r\n\r\n// ─── Voice ────────────────────────────────────────────────────────────────────\r\n\r\n/** Raw Discord voice state object. */\r\nexport interface APIVoiceState {\r\n    guild_id?: Snowflake;\r\n    channel_id?: Snowflake | null;\r\n    user_id: Snowflake;\r\n    member?: APIGuildMember;\r\n    session_id: string;\r\n    deaf: boolean;\r\n    mute: boolean;\r\n    self_deaf: boolean;\r\n    self_mute: boolean;\r\n    self_stream?: boolean;\r\n    self_video: boolean;\r\n    suppress: boolean;\r\n    request_to_speak_timestamp?: string | null;\r\n}\r\n\r\n/** Raw Discord voice server update event. */\r\nexport interface APIVoiceServerUpdate {\r\n    token: string;\r\n    guild_id: Snowflake;\r\n    endpoint?: string | null;\r\n}\r\n\r\n// ─── Presence ────────────────────────────────────────────────────────────────\r\n\r\n/** Raw Discord activity object. */\r\nexport interface APIActivity {\r\n    name: string;\r\n    type: number;\r\n    url?: string | null;\r\n    created_at: number;\r\n    state?: string | null;\r\n    details?: string | null;\r\n    emoji?: APIPartialEmoji | null;\r\n}\r\n\r\n/** Raw Discord presence update event. */\r\nexport interface APIPresenceUpdate {\r\n    user: { id: Snowflake } & Partial<UserData>;\r\n    guild_id: Snowflake;\r\n    status: string;\r\n    activities: APIActivity[];\r\n    client_status: { desktop?: string; mobile?: string; web?: string };\r\n}\r\n\r\n// ─── Typing ───────────────────────────────────────────────────────────────────\r\n\r\n/** Raw Discord typing start event. */\r\nexport interface APITypingStart {\r\n    channel_id: Snowflake;\r\n    guild_id?: Snowflake;\r\n    user_id: Snowflake;\r\n    timestamp: number;\r\n    member?: APIGuildMember;\r\n}\r\n\r\n// ─── Guilds ──────────────────────────────────────────────────────────────────\r\n\r\n/** Raw Discord guild preview. */\r\nexport interface APIGuildPreview {\r\n    id: Snowflake;\r\n    name: string;\r\n    icon: string | null;\r\n    splash: string | null;\r\n    discovery_splash: string | null;\r\n    emojis: unknown[];\r\n    features: string[];\r\n    approximate_member_count: number;\r\n    approximate_presence_count: number;\r\n    description: string | null;\r\n    stickers: unknown[];\r\n}\r\n\r\n// ─── Invites ─────────────────────────────────────────────────────────────────\r\n\r\n/** Raw Discord invite. */\r\nexport interface APIInvite {\r\n    code: string;\r\n    guild?: Partial<APIGuild>;\r\n    channel: Partial<APIChannel>;\r\n    inviter?: UserData;\r\n    target_type?: number;\r\n    target_user?: UserData;\r\n    approximate_presence_count?: number;\r\n    approximate_member_count?: number;\r\n}\r\n\r\n/** Raw Discord invite create event. */\r\nexport interface APIInviteCreate {\r\n    channel_id: Snowflake;\r\n    code: string;\r\n    created_at: string;\r\n    guild_id?: Snowflake;\r\n    inviter?: UserData;\r\n    max_age: number;\r\n    max_uses: number;\r\n    target_type?: number;\r\n    target_user?: UserData;\r\n    temporary: boolean;\r\n    uses: number;\r\n}\r\n\r\n/** Raw Discord invite delete event. */\r\nexport interface APIInviteDelete {\r\n    channel_id: Snowflake;\r\n    guild_id?: Snowflake;\r\n    code: string;\r\n}\r\n\r\n// ─── Webhooks ────────────────────────────────────────────────────────────────\r\n\r\n/** Raw Discord webhooks update event. */\r\nexport interface APIWebhooksUpdate {\r\n    guild_id: Snowflake;\r\n    channel_id: Snowflake;\r\n}\r\n\r\n/** Raw Discord webhook object. */\r\nexport interface APIWebhook {\r\n    id: Snowflake;\r\n    type: number;\r\n    guild_id?: Snowflake | null;\r\n    channel_id?: Snowflake | null;\r\n    user?: UserData;\r\n    name?: string | null;\r\n    avatar?: string | null;\r\n    token?: string;\r\n    application_id?: Snowflake | null;\r\n    url?: string;\r\n}\r\n\r\n// ─── AutoMod ─────────────────────────────────────────────────────────────────\r\n\r\n/** Raw Discord AutoMod action. */\r\nexport interface APIAutoModerationAction {\r\n    type: number;\r\n    metadata?: {\r\n        channel_id?: Snowflake;\r\n        duration_seconds?: number;\r\n        custom_message?: string;\r\n    };\r\n}\r\n\r\n// ─── Audit Logs ──────────────────────────────────────────────────────────────\r\n\r\n/** Raw Discord audit log change object. */\r\nexport interface APIAuditLogChange {\r\n    new_value?: unknown;\r\n    old_value?: unknown;\r\n    key: string;\r\n}\r\n\r\n/** Raw Discord audit log entry options object. */\r\nexport interface APIAuditLogOptions {\r\n    app_id?: Snowflake;\r\n    auto_moderation_rule_name?: string;\r\n    auto_moderation_rule_trigger_type?: string;\r\n    channel_id?: Snowflake;\r\n    count?: string;\r\n    delete_member_days?: string;\r\n    id?: Snowflake;\r\n    members_removed?: string;\r\n    message_id?: Snowflake;\r\n    role_name?: string;\r\n    type?: string;\r\n    integration_type?: string;\r\n}\r\n\r\n/** Raw Discord audit log entry object. */\r\nexport interface APIAuditLogEntry {\r\n    target_id: string | null;\r\n    changes?: APIAuditLogChange[];\r\n    user_id: Snowflake | null;\r\n    id: Snowflake;\r\n    action_type: number;\r\n    options?: APIAuditLogOptions;\r\n    reason?: string;\r\n}\r\n\r\n/** Raw Discord audit log object. */\r\nexport interface APIAuditLog {\r\n    audit_log_entries: APIAuditLogEntry[];\r\n    guild_scheduled_events: APIGuildScheduledEvent[];\r\n    integrations: Array<Record<string, unknown>>;\r\n    threads: APIChannel[];\r\n    users: UserData[];\r\n    webhooks: APIWebhook[];\r\n    application_commands: APIApplicationCommand[];\r\n    auto_moderation_rules: APIAutoModerationRule[];\r\n}\r\n\r\n/** Raw Discord AutoMod rule object. */\r\nexport interface APIAutoModerationRule {\r\n    id: Snowflake;\r\n    guild_id: Snowflake;\r\n    name: string;\r\n    creator_id: Snowflake;\r\n    event_type: number;\r\n    trigger_type: number;\r\n    trigger_metadata: Record<string, unknown>;\r\n    actions: APIAutoModerationAction[];\r\n    enabled: boolean;\r\n    exempt_roles: Snowflake[];\r\n    exempt_channels: Snowflake[];\r\n}\r\n\r\n/** Raw Discord AutoMod action execution event. */\r\nexport interface APIAutoModerationActionExecution {\r\n    guild_id: Snowflake;\r\n    action: APIAutoModerationAction;\r\n    rule_id: Snowflake;\r\n    rule_trigger_type: number;\r\n    user_id: Snowflake;\r\n    channel_id?: Snowflake;\r\n    message_id?: Snowflake;\r\n    alert_system_message_id?: Snowflake;\r\n    content: string;\r\n    matched_keyword?: string | null;\r\n    matched_content?: string | null;\r\n}\r\n\r\n// ─── Scheduled Events ─────────────────────────────────────────────────────────\r\n\r\n/** Raw Discord guild scheduled event entity metadata. */\r\nexport interface APIGuildScheduledEventEntityMetadata {\r\n    location?: string;\r\n}\r\n\r\n/** Raw Discord guild scheduled event object. */\r\nexport interface APIGuildScheduledEvent {\r\n    id: Snowflake;\r\n    guild_id: Snowflake;\r\n    channel_id?: Snowflake | null;\r\n    creator_id?: Snowflake | null;\r\n    name: string;\r\n    description?: string | null;\r\n    scheduled_start_time: string;\r\n    scheduled_end_time?: string | null;\r\n    privacy_level: number;\r\n    status: number;\r\n    entity_type: number;\r\n    entity_id?: Snowflake | null;\r\n    entity_metadata?: APIGuildScheduledEventEntityMetadata | null;\r\n    creator?: UserData;\r\n    user_count?: number;\r\n    image?: string | null;\r\n}\r\n\r\n// ─── Stage Instances ─────────────────────────────────────────────────────────\r\n\r\n/** Raw Discord stage instance object. */\r\nexport interface APIStageInstance {\r\n    id: Snowflake;\r\n    guild_id: Snowflake;\r\n    channel_id: Snowflake;\r\n    topic: string;\r\n    privacy_level: number;\r\n    discoverable_disabled?: boolean;\r\n    guild_scheduled_event_id?: Snowflake | null;\r\n}\r\n\r\n// ─── Application Commands ─────────────────────────────────────────────────────\r\n\r\n/** Discord application command option types. */\r\nexport const ApplicationCommandOptionType = {\r\n    SubCommand: 1,\r\n    SubCommandGroup: 2,\r\n    String: 3,\r\n    Integer: 4,\r\n    Boolean: 5,\r\n    User: 6,\r\n    Channel: 7,\r\n    Role: 8,\r\n    Mentionable: 9,\r\n    Number: 10,\r\n    Attachment: 11,\r\n} as const;\r\n\r\n/** Discord application command types. */\r\nexport const ApplicationCommandType = {\r\n    ChatInput: 1,\r\n    User: 2,\r\n    Message: 3,\r\n} as const;\r\n\r\n/** Raw Discord application command option. */\r\nexport interface APIApplicationCommandOption {\r\n    type: number;\r\n    name: string;\r\n    description: string;\r\n    required?: boolean;\r\n    choices?: Array<{ name: string; value: string | number }>;\r\n    options?: APIApplicationCommandOption[];\r\n    min_value?: number;\r\n    max_value?: number;\r\n    min_length?: number;\r\n    max_length?: number;\r\n    autocomplete?: boolean;\r\n    channel_types?: number[];\r\n}\r\n\r\n/** Raw Discord application command object (from API). */\r\nexport interface APIApplicationCommand {\r\n    id: Snowflake;\r\n    type?: number;\r\n    application_id: Snowflake;\r\n    guild_id?: Snowflake;\r\n    name: string;\r\n    description: string;\r\n    options?: APIApplicationCommandOption[];\r\n    default_member_permissions?: string | null;\r\n    dm_permission?: boolean;\r\n    nsfw?: boolean;\r\n    version: Snowflake;\r\n}\r\n\r\n/** Data for creating/overwriting an application command. */\r\nexport interface ApplicationCommandData {\r\n    name: string;\r\n    description: string;\r\n    type?: number;\r\n    options?: APIApplicationCommandOption[];\r\n    default_member_permissions?: string | null;\r\n    dm_permission?: boolean;\r\n    nsfw?: boolean;\r\n}\r\n\r\n// ─── Gateway Events ───────────────────────────────────────────────────────────\r\n\r\n/** Raw Discord READY event payload. */\r\nexport interface APIReadyEvent {\r\n    v: number;\r\n    user: UserData;\r\n    guilds: Array<{ id: Snowflake; unavailable?: boolean }>;\r\n    session_id: string;\r\n    resume_gateway_url: string;\r\n    shard?: [number, number];\r\n    application?: { id: Snowflake; flags: number; [key: string]: unknown };\r\n}\r\n\r\n/** Raw Discord reaction event payload. */\r\nexport interface APIMessageReactionEvent {\r\n    user_id: Snowflake;\r\n    channel_id: Snowflake;\r\n    message_id: Snowflake;\r\n    guild_id?: Snowflake;\r\n    member?: APIGuildMember;\r\n    emoji: APIPartialEmoji;\r\n    message_author_id?: Snowflake;\r\n    burst?: boolean;\r\n    type?: number;\r\n}\r\n\r\n/** Raw Discord reaction remove emoji event payload. */\r\nexport interface APIMessageReactionRemoveEmojiEvent {\r\n    channel_id: Snowflake;\r\n    guild_id?: Snowflake;\r\n    message_id: Snowflake;\r\n    emoji: APIPartialEmoji;\r\n}\r\n\r\n/** Raw Discord message deletion event payload. */\r\nexport interface APIMessageDeleteEvent {\r\n    id: Snowflake;\r\n    channel_id: Snowflake;\r\n    guild_id?: Snowflake;\r\n}\r\n\r\n/** Raw Discord bulk message deletion event payload. */\r\nexport interface APIMessageDeleteBulkEvent {\r\n    ids: Snowflake[];\r\n    channel_id: Snowflake;\r\n    guild_id?: Snowflake;\r\n}\r\n\r\n/** Raw Discord channel deletion event payload. */\r\nexport interface APIChannelDeleteEvent extends APIChannel {}\r\n\r\n/** Raw Discord guild deletion event payload. */\r\nexport interface APIGuildDeleteEvent {\r\n    id: Snowflake;\r\n    unavailable?: boolean;\r\n}\r\n\r\n/** Raw Discord thread lifecycle payload. */\r\nexport interface APIThreadEvent extends APIChannel {\r\n    guild_id: Snowflake;\r\n    member?: APIThreadMember;\r\n}\r\n\r\n/** Raw Discord thread list sync event. */\r\nexport interface APIThreadListSync {\r\n    guild_id: Snowflake;\r\n    channel_ids?: Snowflake[];\r\n    threads: APIChannel[];\r\n    members: APIThreadMember[];\r\n}\r\n\r\n/** Raw Discord thread members update event. */\r\nexport interface APIThreadMembersUpdate {\r\n    id: Snowflake;\r\n    guild_id: Snowflake;\r\n    member_count: number;\r\n    added_members?: APIThreadMember[];\r\n    removed_member_ids?: Snowflake[];\r\n}\r\n\r\n/** Raw Discord guild role event payload. */\r\nexport interface APIGuildRoleEvent {\r\n    guild_id: Snowflake;\r\n    role: APIRole;\r\n}\r\n\r\n/** Raw Discord guild role delete event payload. */\r\nexport interface APIGuildRoleDeleteEvent {\r\n    guild_id: Snowflake;\r\n    role_id: Snowflake;\r\n}\r\n\r\n/** Raw Discord guild ban event payload. */\r\nexport interface APIGuildBanEvent {\r\n    guild_id: Snowflake;\r\n    user: UserData;\r\n}\r\n\r\n/** Raw Discord guild emojis update event payload. */\r\nexport interface APIGuildEmojisUpdateEvent {\r\n    guild_id: Snowflake;\r\n    emojis: APIEmoji[];\r\n}\r\n\r\n/** Raw Discord guild stickers update event payload. */\r\nexport interface APIGuildStickersUpdateEvent {\r\n    guild_id: Snowflake;\r\n    stickers: APISticker[];\r\n}\r\n\r\n/** Raw Discord channel pins update event. */\r\nexport interface APIChannelPinsUpdate {\r\n    guild_id?: Snowflake;\r\n    channel_id: Snowflake;\r\n    last_pin_timestamp?: string | null;\r\n}\r\n\r\n/** Raw Discord guild members chunk event. */\r\nexport interface APIGuildMembersChunk {\r\n    guild_id: Snowflake;\r\n    members: APIGuildMember[];\r\n    chunk_index: number;\r\n    chunk_count: number;\r\n    not_found?: Snowflake[];\r\n    presences?: APIPresenceUpdate[];\r\n    nonce?: string;\r\n}\r\n\r\n/** Raw Discord guild scheduled event user add/remove event. */\r\nexport interface APIGuildScheduledEventUserEvent {\r\n    guild_scheduled_event_id: Snowflake;\r\n    user_id: Snowflake;\r\n    guild_id: Snowflake;\r\n}\r\n\r\n/** Raw Discord message poll vote add/remove event. */\r\nexport interface APIMessagePollVoteEvent {\r\n    user_id: Snowflake;\r\n    channel_id: Snowflake;\r\n    message_id: Snowflake;\r\n    guild_id?: Snowflake;\r\n    answer_id: number;\r\n}\r\n"
   ],
-  "mappings": "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",
+  "mappings": ";;AAMO,IAAM,oBAAoB;AAAA,EAC7B,QAAQ,KAAK;AAAA,EACb,cAAc,KAAK;AAAA,EACnB,iBAAiB,KAAK;AAAA,EACtB,kBAAkB,KAAK;AAAA,EACvB,mBAAmB,KAAK;AAAA,EACxB,eAAe,KAAK;AAAA,EACpB,cAAc,KAAK;AAAA,EACnB,kBAAkB,KAAK;AAAA,EACvB,gBAAgB,KAAK;AAAA,EACrB,eAAe,KAAK;AAAA,EACpB,uBAAuB,KAAK;AAAA,EAC5B,oBAAoB,KAAK;AAAA,EACzB,gBAAgB,KAAK;AAAA,EACrB,wBAAwB,KAAK;AAAA,EAC7B,qBAAqB,KAAK;AAAA,EAC1B,gBAAgB,KAAK;AAAA,EACrB,sBAAsB,KAAK;AAAA,EAC3B,6BAA6B,KAAK;AAAA,EAClC,yBAAyB,KAAK;AAAA,EAC9B,mBAAmB,KAAK;AAAA,EACxB,oBAAoB,KAAK;AAC7B;AAGO,IAAM,aAAa;AAAA,EACtB,OAAO,KAAK;AAAA,EACZ,QAAQ,KAAK;AAAA,EACb,cAAc,KAAK;AAAA,EACnB,iBAAiB,KAAK;AAAA,EACtB,WAAW,KAAK;AAAA,EAChB,kBAAkB,KAAK;AAAA,EACvB,aAAa,KAAK;AAAA,EAClB,wBAAwB,KAAK;AAAA,EAC7B,mBAAmB,KAAK;AAAA,EACxB,eAAe,KAAK;AAAA,EACpB,cAAc,KAAK;AAAA,EACnB,kBAAkB,KAAK;AAAA,EACvB,gBAAgB,KAAK;AAAA,EACrB,eAAe,KAAK;AAAA,EACpB,cAAc,KAAK;AAAA,EACnB,uBAAuB,KAAK;AAAA,EAC5B,oBAAoB,KAAK;AAAA,EACzB,gBAAgB,KAAK;AAAA,EACrB,wBAAwB,KAAK;AAAA,EAC7B,qBAAqB,KAAK;AAAA,EAC1B,gBAAgB,KAAK;AAAA,EACrB,sBAAsB,KAAK;AAAA,EAC3B,6BAA6B,KAAK;AAAA,EAClC,yBAAyB,KAAK;AAAA,EAC9B,mBAAmB,KAAK;AAAA,EACxB,oBAAoB,KAAK;AAC7B;AAGO,IAAM,UAAU;AAehB,SAAS,qBAAqB,CACjC,SACM;AAAA,EACN,IAAI,OAAO,YAAY;AAAA,IAAU,OAAO;AAAA,EACxC,IAAI,MAAM,QAAQ,OAAO,GAAG;AAAA,IACxB,OAAO,QAAQ,OAAe,CAAC,KAAK,WAAW;AAAA,MAC3C,OAAO,MAAM,sBAAsB,MAAa;AAAA,OACjD,CAAC;AAAA,EACR;AAAA,EACA,IAAI,OAAO,YAAY,UAAU;AAAA,IAC7B,IAAI,WAAW;AAAA,MACX,OAAQ,kBAA6C;AAAA,IACzD,IAAI,WAAW;AAAA,MACX,OAAQ,WAAsC;AAAA,IAClD,MAAM,QAAQ,QAAQ,OAAO,CAAC,EAAE,YAAY,IAAI,QAAQ,MAAM,CAAC;AAAA,IAC/D,IAAI,SAAS;AAAA,MACT,OAAQ,WAAsC;AAAA,IAClD,MAAM,MAAM,OAAO,OAAO;AAAA,IAC1B,IAAI,CAAC,OAAO,MAAM,GAAG;AAAA,MAAG,OAAO;AAAA,EACnC;AAAA,EACA,OAAO;AAAA;AAqFJ,IAAM,eAAe;AAAA,EACxB,aAAa;AAAA,EACb,aAAa;AAAA,EACb,gBAAgB;AAAA,EAChB,sBAAsB;AAAA,EACtB,QAAQ;AAAA,EACR,WAAW;AAAA,EACX,WAAW;AAAA,EACX,SAAS;AAAA,EACT,gBAAgB;AACpB;AAGO,IAAM,cAAc;AAAA,EACvB,WAAW;AAAA,EACX,IAAI;AAAA,EACJ,YAAY;AAAA,EACZ,SAAS;AAAA,EACT,eAAe;AAAA,EACf,mBAAmB;AAAA,EACnB,oBAAoB;AAAA,EACpB,cAAc;AAAA,EACd,eAAe;AAAA,EACf,iBAAiB;AAAA,EACjB,gBAAgB;AAAA,EAChB,YAAY;AAAA,EACZ,YAAY;AAChB;AAGO,IAAM,gBAAgB;AAAA,EACzB,WAAW;AAAA,EACX,QAAQ;AAAA,EACR,cAAc;AAAA,EACd,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,YAAY;AAAA,EACZ,mBAAmB;AAAA,EACnB,eAAe;AAAA,EACf,SAAS;AAAA,EACT,aAAa;AAAA,EACb,WAAW;AAAA,EACX,cAAc;AAAA,EACd,MAAM;AAAA,EACN,WAAW;AAAA,EACX,uBAAuB;AAAA,EACvB,WAAW;AACf;AAGO,IAAM,cAAc;AAAA,EACvB,SAAS;AAAA,EACT,WAAW;AAAA,EACX,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,SAAS;AACb;AAGO,IAAM,iBAAiB;AAAA,EAC1B,OAAO;AAAA,EACP,WAAW;AACf;AAGO,IAAM,0BAA0B;AAAA,EACnC,MAAM;AAAA,EACN,gBAAgB;AAAA,EAChB,wBAAwB;AAAA,EACxB,uBAAuB;AAAA,EACvB,eAAe;AAAA,EACf,cAAc;AAAA,EACd,OAAO;AACX;AAGO,IAAM,oBAAoB;AAAA,EAC7B,KAAK;AAAA,EACL,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,KAAK;AACT;AAGO,IAAM,cAAc;AAAA,EACvB,UAAU;AAAA,EACV,OAAO;AACX;AAGO,IAAM,oBAAoB;AAAA,EAC7B,MAAM;AAAA,EACN,KAAK;AAAA,EACL,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,UAAU;AACd;AAGO,IAAM,cAAc;AAAA,EACvB,MAAM;AAAA,EACN,OAAO;AAAA,EACP,OAAO;AAAA,EACP,OAAO;AACX;AA4qBO,IAAM,+BAA+B;AAAA,EACxC,YAAY;AAAA,EACZ,iBAAiB;AAAA,EACjB,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,SAAS;AAAA,EACT,MAAM;AAAA,EACN,SAAS;AAAA,EACT,MAAM;AAAA,EACN,aAAa;AAAA,EACb,QAAQ;AAAA,EACR,YAAY;AAChB;AAGO,IAAM,yBAAyB;AAAA,EAClC,WAAW;AAAA,EACX,MAAM;AAAA,EACN,SAAS;AACb;",
   "debugId": "02206D15DB14DD1464756E2164756E21",
   "names": []
 }

package/dist/utils/index.js.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../packages/utils/src/index.ts"],
   "sourcesContent": [
-    "/** Returns a promise that resolves after the specified duration. */\nexport function sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/** Returns an integer between the supplied inclusive bounds. */\nexport function randomInt(min: number, max: number): number {\n  return Math.floor(Math.random() * (max - min + 1)) + min;\n}\n\n/** Tests whether a value is a Discord snowflake-like ID. */\nexport function isSnowflake(value: string): boolean {\n  return /^\\d{16,22}$/.test(value);\n}\n"
+    "/** Returns a promise that resolves after the specified duration. */\r\nexport function sleep(ms: number): Promise<void> {\r\n    return new Promise((resolve) => setTimeout(resolve, ms));\r\n}\r\n\r\n/** Returns an integer between the supplied inclusive bounds. */\r\nexport function randomInt(min: number, max: number): number {\r\n    return Math.floor(Math.random() * (max - min + 1)) + min;\r\n}\r\n\r\n/** Tests whether a value is a Discord snowflake-like ID. */\r\nexport function isSnowflake(value: string): boolean {\r\n    return /^\\d{16,22}$/.test(value);\r\n}\r\n"
   ],
-  "mappings": ";;AACO,SAAS,KAAK,CAAC,IAA2B;AAAA,EAC/C,OAAO,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,EAAE,CAAC;AAAA;AAIlD,SAAS,SAAS,CAAC,KAAa,KAAqB;AAAA,EAC1D,OAAO,KAAK,MAAM,KAAK,OAAO,KAAK,MAAM,MAAM,EAAE,IAAI;AAAA;AAIhD,SAAS,WAAW,CAAC,OAAwB;AAAA,EAClD,OAAO,cAAc,KAAK,KAAK;AAAA;",
+  "mappings": ";;AACO,SAAS,KAAK,CAAC,IAA2B;AAAA,EAC7C,OAAO,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,EAAE,CAAC;AAAA;AAIpD,SAAS,SAAS,CAAC,KAAa,KAAqB;AAAA,EACxD,OAAO,KAAK,MAAM,KAAK,OAAO,KAAK,MAAM,MAAM,EAAE,IAAI;AAAA;AAIlD,SAAS,WAAW,CAAC,OAAwB;AAAA,EAChD,OAAO,cAAc,KAAK,KAAK;AAAA;",
   "debugId": "4F20A8D367F5985F64756E2164756E21",
   "names": []
 }

package/dist/voice/index.d.ts

@@ -27,6 +27,8 @@ export interface VoiceUdpTransport {
     send(packet: Uint8Array, host: string, port: number): Promise<void> | void;
     /** Closes the UDP socket. @returns Nothing. */
     close(): void;
+    /** Optional listener for incoming UDP packets. */
+    onMessage?(listener: (packet: Uint8Array) => void): void;
 }
 /** Voice Gateway transport abstraction. */
 export interface VoiceGatewayTransport {
@@ -69,6 +71,8 @@ export declare class VoiceConnection {
     gateway?: VoiceGatewayTransport;
     /** Active UDP transport, when attached. */
     udp?: VoiceUdpTransport;
+    /** Receives incoming audio. */
+    readonly receiver: VoiceReceiver;
     /** Creates a voice connection state manager. @param options Guild ID or connection options. @throws {TypeError} If the guild ID is empty. */
     constructor(options: string | VoiceConnectionOptions);
     /** Registers a voice lifecycle listener. @param event Event name. @param listener Listener callback. @returns This connection. @throws {TypeError} If listener is not callable. */
@@ -95,3 +99,87 @@ export declare class VoiceConnection {
     /** Ensures the connection is still usable. @returns Nothing. @throws {VoiceError} If destroyed. */
     private assertUsable;
 }
+/** Audio player lifecycle states. */
+export type AudioPlayerState = "idle" | "playing" | "paused" | "stopped";
+/** An audio stream — wraps a `ReadableStream<Uint8Array>` with optional metadata. */
+export declare class AudioStream {
+    /** Underlying binary stream. */ readonly stream: ReadableStream<Uint8Array>;
+    /** Optional human-readable title for the stream. */ readonly title?: string;
+    /** Optional duration hint in seconds. */ readonly duration?: number;
+    /** Creates an audio stream.
+     * @param stream Binary audio data stream.
+     * @param metadata Optional metadata: title and duration in seconds.
+     */
+    constructor(stream: ReadableStream<Uint8Array>, metadata?: {
+        title?: string;
+        duration?: number;
+    });
+}
+type AudioPlayerListener<K extends keyof AudioPlayerEvents> = (...args: AudioPlayerEvents[K]) => unknown;
+interface AudioPlayerEvents {
+    stateChange: [from: AudioPlayerState, to: AudioPlayerState];
+    error: [error: Error];
+    finish: [];
+}
+/**
+ * Lightweight audio player with a simple state machine.
+ *
+ * States:
+ * - `idle` — no stream loaded.
+ * - `playing` — actively feeding audio data.
+ * - `paused` — temporarily suspended; can be resumed.
+ * - `stopped` — stream was stopped and discarded; load a new stream to play again.
+ *
+ * Events: `stateChange(from, to)`, `error(err)`, `finish()`.
+ */
+export declare class AudioPlayer {
+    #private;
+    /** Current player state. */
+    get state(): AudioPlayerState;
+    /** The audio stream currently loaded, if any. */
+    get current(): AudioStream | undefined;
+    /**
+     * Begins playing an audio stream.
+     * If a stream is already playing, it is stopped first; the previous
+     * stream's reader cancellation is awaited before the new stream starts so
+     * the old and new pump loops cannot run concurrently.
+     * @param audioStream Stream to play.
+     */
+    play(audioStream: AudioStream): Promise<void>;
+    /** Pauses a currently-playing stream. No-op if not playing. */
+    pause(): void;
+    /** Resumes a paused stream. No-op if not paused. */
+    resume(): void;
+    /**
+     * Stops and discards the current stream. The returned promise resolves once
+     * the underlying reader's cancellation has settled, so a subsequent `play`
+     * never overlaps with the previous pump loop.
+     */
+    stop(): Promise<void>;
+    /** Registers an event listener. @returns `this` for chaining. */
+    on<K extends keyof AudioPlayerEvents>(event: K, listener: AudioPlayerListener<K>): this;
+    /** Removes an event listener. @returns `this` for chaining. */
+    off<K extends keyof AudioPlayerEvents>(event: K, listener: AudioPlayerListener<K>): this;
+    /**
+     * Handles a decoded audio chunk. The base implementation is a no-op;
+     * subclasses override this to pipe audio to a UDP socket or other sink.
+     * @param chunk A chunk of audio bytes read from the current stream.
+     */
+    protected onChunk(chunk: Uint8Array): void;
+}
+/** Tracks incoming audio and maps SSRCs to readable streams per user. */
+export declare class VoiceReceiver {
+    #private;
+    /** The connection this receiver is attached to. */
+    readonly connection: VoiceConnection;
+    /** Creates a VoiceReceiver. @param connection Voice connection. */
+    constructor(connection: VoiceConnection);
+    /** Maps an SSRC to a User ID (usually from gateway speaking events). */
+    mapSsrc(ssrc: number, userId: string): void;
+    /** Subscribes to incoming audio from a specific user. @param userId User identifier. @returns A binary readable stream of the audio. */
+    subscribe(userId: string): AudioStream;
+    /** Processes an incoming UDP packet, extracting SSRC and routing the audio
+     * payload (RTP header stripped) to every subscriber for the mapped user. */
+    onPacket(packet: Uint8Array): void;
+}
+export {};