lunibee 0.1.6 → 0.1.8

package/dist/types/index.js.map

@@ -1,10 +1,11 @@
 {
   "version": 3,
-  "sources": ["../../packages/types/src/index.ts"],
+  "sources": ["../../packages/types/src/gateway.ts", "../../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"
+    "// ─── Gateway Intents ─────────────────────────────────────────────────────────\n\n/** Gateway intent bit flags supported by Discord (PascalCase). */\nexport const GatewayIntentBits = {\n    Guilds: 1 << 0,\n    GuildMembers: 1 << 1,\n    GuildModeration: 1 << 2,\n    GuildExpressions: 1 << 3,\n    GuildIntegrations: 1 << 4,\n    GuildWebhooks: 1 << 5,\n    GuildInvites: 1 << 6,\n    GuildVoiceStates: 1 << 7,\n    GuildPresences: 1 << 8,\n    GuildMessages: 1 << 9,\n    GuildMessageReactions: 1 << 10,\n    GuildMessageTyping: 1 << 11,\n    DirectMessages: 1 << 12,\n    DirectMessageReactions: 1 << 13,\n    DirectMessageTyping: 1 << 14,\n    MessageContent: 1 << 15,\n    GuildScheduledEvents: 1 << 16,\n    AutoModerationConfiguration: 1 << 20,\n    AutoModerationExecution: 1 << 21,\n    GuildMessagePolls: 1 << 24,\n    DirectMessagePolls: 1 << 25,\n} as const;\n\n/** Idiomatic camelCase Gateway intent bit flags supported by Discord. */\nexport const IntentBits = {\n    guild: 1 << 0,\n    guilds: 1 << 0,\n    guildMembers: 1 << 1,\n    guildModeration: 1 << 2,\n    guildBans: 1 << 2,\n    guildExpressions: 1 << 3,\n    guildEmojis: 1 << 3,\n    guildEmojisAndStickers: 1 << 3,\n    guildIntegrations: 1 << 4,\n    guildWebhooks: 1 << 5,\n    guildInvites: 1 << 6,\n    guildVoiceStates: 1 << 7,\n    guildPresences: 1 << 8,\n    guildMessages: 1 << 9,\n    guildMessage: 1 << 9,\n    guildMessageReactions: 1 << 10,\n    guildMessageTyping: 1 << 11,\n    directMessages: 1 << 12,\n    directMessageReactions: 1 << 13,\n    directMessageTyping: 1 << 14,\n    messageContent: 1 << 15,\n    guildScheduledEvents: 1 << 16,\n    autoModerationConfiguration: 1 << 20,\n    autoModerationExecution: 1 << 21,\n    guildMessagePolls: 1 << 24,\n    directMessagePolls: 1 << 25,\n} as const;\n\n/** Alias for IntentBits. */\nexport const Intents = IntentBits;\n\n/** Gateway intent resolvable value (single bitfield, enum key, or array of bitfields/strings). */\nexport type GatewayIntentResolvable =\n    | number\n    | keyof typeof GatewayIntentBits\n    | keyof typeof IntentBits\n    | (\n          | number\n          | keyof typeof GatewayIntentBits\n          | keyof typeof IntentBits\n          | string\n      )[]\n    | { readonly bitfield: number };\n\n/** Resolves any GatewayIntentResolvable into a raw bitfield integer. */\nexport function resolveGatewayIntents(\n    intents: GatewayIntentResolvable,\n): number {\n    if (typeof intents === \"number\") return intents;\n    if (intents && typeof intents === \"object\" && !Array.isArray(intents))\n        return intents.bitfield;\n    if (Array.isArray(intents)) {\n        return intents.reduce<number>((acc, intent) => {\n            return acc | resolveGatewayIntents(intent as any);\n        }, 0);\n    }\n    if (typeof intents === \"string\") {\n        if (intents in GatewayIntentBits)\n            return (GatewayIntentBits as Record<string, number>)[intents]!;\n        if (intents in IntentBits)\n            return (IntentBits as Record<string, number>)[intents]!;\n        const lower = intents.charAt(0).toLowerCase() + intents.slice(1);\n        if (lower in IntentBits)\n            return (IntentBits as Record<string, number>)[lower]!;\n        const num = Number(intents);\n        if (!Number.isNaN(num)) return num;\n    }\n    return 0;\n}\n\n/**\n * Discord.js-familiar intent bitfield.\n * @example new IntentsBitField([IntentsBitField.Flags.Guilds, \"GuildMessages\"])\n */\nexport class IntentsBitField {\n    /** Intent flag values by name. */\n    public static readonly Flags = GatewayIntentBits;\n    /** Raw intent bitfield. */\n    public bitfield: number;\n\n    public constructor(bits: GatewayIntentResolvable = 0) {\n        this.bitfield = resolveGatewayIntents(bits);\n    }\n\n    /** Whether every given intent is set. */\n    public has(bits: GatewayIntentResolvable): boolean {\n        const resolved = resolveGatewayIntents(bits);\n        return (this.bitfield & resolved) === resolved;\n    }\n\n    /** Whether any given intent is set. */\n    public any(bits: GatewayIntentResolvable): boolean {\n        return (this.bitfield & resolveGatewayIntents(bits)) !== 0;\n    }\n\n    /** Adds intents in place. @returns This bitfield. */\n    public add(...bits: GatewayIntentResolvable[]): this {\n        for (const bit of bits) this.bitfield |= resolveGatewayIntents(bit);\n        return this;\n    }\n\n    /** Removes intents in place. @returns This bitfield. */\n    public remove(...bits: GatewayIntentResolvable[]): this {\n        for (const bit of bits) this.bitfield &= ~resolveGatewayIntents(bit);\n        return this;\n    }\n\n    /** Names of the set intents. */\n    public toArray(): (keyof typeof GatewayIntentBits)[] {\n        return (\n            Object.keys(GatewayIntentBits) as (keyof typeof GatewayIntentBits)[]\n        ).filter((name) => this.has(GatewayIntentBits[name]));\n    }\n\n    /** Whether this equals another bitfield. */\n    public equals(bits: GatewayIntentResolvable): boolean {\n        return this.bitfield === resolveGatewayIntents(bits);\n    }\n\n    public valueOf(): number {\n        return this.bitfield;\n    }\n\n    public toJSON(): number {\n        return this.bitfield;\n    }\n}\n\n// ─── Gateway Config ───────────────────────────────────────────────────────────\n\n/** Gateway connection properties (OS, browser, device). */\nexport interface GatewayProperties {\n    os?: string;\n    browser?: string;\n    device?: string;\n    [key: string]: unknown;\n}\n/** Gateway presence activity. */\nexport interface GatewayPresenceActivity {\n    name: string;\n    type?: number;\n    url?: string;\n    state?: string;\n}\n/** Gateway presence data. */\nexport interface GatewayPresence {\n    status?: \"online\" | \"dnd\" | \"idle\" | \"invisible\" | \"offline\";\n    activities?: GatewayPresenceActivity[];\n    afk?: boolean;\n    since?: number | null;\n}\n/** Client configuration. */\nexport interface ClientOptions {\n    token: string;\n    intents: GatewayIntentResolvable;\n    gateway?: GatewayOptions;\n    rest?: RESTOptions;\n}\n/** Gateway connection configuration. */\nexport interface GatewayOptions {\n    intents?: GatewayIntentResolvable;\n    reconnect?: boolean;\n    maxReconnectAttempts?: number;\n    reconnectBaseDelay?: number;\n    reconnectMaxDelay?: number;\n    shardId?: number;\n    shardCount?: number;\n    properties?: GatewayProperties;\n    presence?: GatewayPresence;\n}\n\n/** REST request configuration. */\nexport interface RESTOptions {\n    timeout?: number;\n    retries?: number;\n    baseURL?: string;\n}\n",
+    "/** Discord API snowflake identifier. */\nexport type Snowflake = string;\n\nexport * from \"./gateway.js\";\nexport * from \"./gateway-events.js\";\n\n// ─── Core Discord Objects ─────────────────────────────────────────────────────\n\n/** Discord user object. */\nexport interface UserData {\n    id: Snowflake;\n    username: string;\n    discriminator?: string;\n    global_name?: string | null;\n    avatar?: string | null;\n    bot?: boolean;\n    system?: boolean;\n    public_flags?: number;\n}\n/** Current authenticated bot user. */\nexport type ClientUser = UserData;\n/** Discord Gateway payload envelope. */\nexport interface GatewayPayload<T = unknown> {\n    op: number;\n    d: T | null;\n    s: number | null;\n    t: string | null;\n}\n/** Generic Discord API error payload. */\nexport interface APIError {\n    code?: number;\n    message?: string;\n    errors?: Record<string, unknown>;\n}\n\n// ─── Discord Flags & Enums ────────────────────────────────────────────────────\n\n/** Discord message flags. */\nexport const MessageFlags = {\n    Crossposted: 1,\n    IsCrosspost: 2,\n    SuppressEmbeds: 4,\n    SourceMessageDeleted: 8,\n    Urgent: 16,\n    HasThread: 32,\n    Ephemeral: 64,\n    Loading: 128,\n    IsComponentsV2: 32768,\n} as const;\n\n/** Discord channel types. */\nexport const ChannelType = {\n    GuildText: 0,\n    DM: 1,\n    GuildVoice: 2,\n    GroupDM: 3,\n    GuildCategory: 4,\n    GuildAnnouncement: 5,\n    AnnouncementThread: 10,\n    PublicThread: 11,\n    PrivateThread: 12,\n    GuildStageVoice: 13,\n    GuildDirectory: 14,\n    GuildForum: 15,\n    GuildMedia: 16,\n} as const;\n\n/** Discord component types. */\nexport const ComponentType = {\n    ActionRow: 1,\n    Button: 2,\n    StringSelect: 3,\n    TextInput: 4,\n    UserSelect: 5,\n    RoleSelect: 6,\n    MentionableSelect: 7,\n    ChannelSelect: 8,\n    Section: 9,\n    TextDisplay: 10,\n    Thumbnail: 11,\n    MediaGallery: 12,\n    File: 13,\n    Separator: 14,\n    ContentInventoryEntry: 16,\n    Container: 17,\n} as const;\n\n/** Discord button style types. */\nexport const ButtonStyle = {\n    Primary: 1,\n    Secondary: 2,\n    Success: 3,\n    Danger: 4,\n    Link: 5,\n    Premium: 6,\n} as const;\n\n/** Discord text input style types. */\nexport const TextInputStyle = {\n    Short: 1,\n    Paragraph: 2,\n} as const;\n\n/** Discord interaction response types. */\nexport const InteractionResponseType = {\n    Pong: 1,\n    ChannelMessage: 4,\n    DeferredChannelMessage: 5,\n    DeferredMessageUpdate: 6,\n    MessageUpdate: 7,\n    Autocomplete: 8,\n    Modal: 9,\n} as const;\n\n/** Discord sticker format types. */\nexport const StickerFormatType = {\n    PNG: 1,\n    APNG: 2,\n    Lottie: 3,\n    GIF: 4,\n} as const;\n\n/** Discord sticker types. */\nexport const StickerType = {\n    Standard: 1,\n    Guild: 2,\n} as const;\n\n/** Discord verification levels. */\nexport const VerificationLevel = {\n    None: 0,\n    Low: 1,\n    Medium: 2,\n    High: 3,\n    VeryHigh: 4,\n} as const;\n\n/** Discord premium tiers. */\nexport const PremiumTier = {\n    None: 0,\n    Tier1: 1,\n    Tier2: 2,\n    Tier3: 3,\n} as const;\n\n// ─── Embeds ───────────────────────────────────────────────────────────────────\n\n/** Raw Discord embed footer object. */\nexport interface APIEmbedFooter {\n    text: string;\n    icon_url?: string;\n    proxy_icon_url?: string;\n}\n/** Raw Discord embed image/thumbnail/video object. */\nexport interface APIEmbedMedia {\n    url: string;\n    proxy_url?: string;\n    height?: number;\n    width?: number;\n}\n/** Raw Discord embed provider object. */\nexport interface APIEmbedProvider {\n    name?: string;\n    url?: string;\n}\n/** Raw Discord embed author object. */\nexport interface APIEmbedAuthor {\n    name: string;\n    url?: string;\n    icon_url?: string;\n    proxy_icon_url?: string;\n}\n/** Raw Discord embed field object. */\nexport interface APIEmbedField {\n    name: string;\n    value: string;\n    inline?: boolean;\n}\n/** Raw Discord embed object. */\nexport interface APIEmbed {\n    title?: string;\n    type?: string;\n    description?: string;\n    url?: string;\n    timestamp?: string;\n    color?: number;\n    footer?: APIEmbedFooter;\n    image?: APIEmbedMedia;\n    thumbnail?: APIEmbedMedia;\n    video?: APIEmbedMedia;\n    provider?: APIEmbedProvider;\n    author?: APIEmbedAuthor;\n    fields?: APIEmbedField[];\n}\n\n// ─── Message Components ───────────────────────────────────────────────────────\n\n/** Raw Discord select menu option. */\nexport interface APISelectMenuOption {\n    label: string;\n    value: string;\n    description?: string;\n    emoji?: APIPartialEmoji;\n    default?: boolean;\n}\n/** Raw Discord emoji (partial, as used in components). */\nexport interface APIPartialEmoji {\n    id?: Snowflake | null;\n    name?: string | null;\n    animated?: boolean;\n}\n/** Raw Discord button component. */\nexport interface APIButtonComponent {\n    type: 2;\n    style: number;\n    label?: string;\n    emoji?: APIPartialEmoji;\n    custom_id?: string;\n    url?: string;\n    sku_id?: string;\n    disabled?: boolean;\n}\n/** Raw Discord select menu component. */\nexport interface APISelectMenuComponent {\n    type: 3 | 5 | 6 | 7 | 8;\n    custom_id: string;\n    options?: APISelectMenuOption[];\n    channel_types?: number[];\n    placeholder?: string;\n    min_values?: number;\n    max_values?: number;\n    disabled?: boolean;\n}\n/** Raw Discord text input component. */\nexport interface APITextInputComponent {\n    type: 4;\n    custom_id: string;\n    style: number;\n    label: string;\n    min_length?: number;\n    max_length?: number;\n    required?: boolean;\n    value?: string;\n    placeholder?: string;\n}\n/** Union of all raw message component types. */\nexport type APIMessageActionRowComponent =\n    APIButtonComponent | APISelectMenuComponent | APITextInputComponent;\n/** Raw Discord action row component. */\nexport interface APIActionRowComponent {\n    type: 1;\n    id?: number;\n    components: APIMessageActionRowComponent[];\n}\n/** Union including action rows and V2 components. */\nexport type APIMessageComponent =\n    APIActionRowComponent | { type: Exclude<number, 1>; [key: string]: any };\n\n// ─── Attachments ─────────────────────────────────────────────────────────────\n\n/** Raw Discord attachment object. */\nexport interface APIAttachment {\n    id: Snowflake;\n    filename: string;\n    description?: string | null;\n    content_type?: string;\n    size: number;\n    url: string;\n    proxy_url: string;\n    height?: number | null;\n    width?: number | null;\n    ephemeral?: boolean;\n    duration_secs?: number;\n    waveform?: string;\n    flags?: number;\n}\n\n// ─── Stickers ────────────────────────────────────────────────────────────────\n\n/** Compact sticker item as included in messages. */\nexport interface APIStickerItem {\n    id: Snowflake;\n    name: string;\n    format_type: number;\n}\n/** Full Discord sticker object. */\nexport interface APISticker {\n    id: Snowflake;\n    pack_id?: Snowflake;\n    name: string;\n    description?: string | null;\n    tags?: string;\n    type: number;\n    format_type: number;\n    available?: boolean;\n    guild_id?: Snowflake;\n    user?: UserData;\n    sort_value?: number;\n}\n\n// ─── Messages ────────────────────────────────────────────────────────────────\n\n/** Raw Discord message reference. */\nexport interface APIMessageReference {\n    type?: number;\n    message_id?: Snowflake;\n    channel_id?: Snowflake;\n    guild_id?: Snowflake;\n    fail_if_not_exists?: boolean;\n}\n/** Raw Discord message reaction. */\nexport interface APIMessageReaction {\n    count: number;\n    count_details?: Record<string, number>;\n    me?: boolean;\n    me_burst?: boolean;\n    emoji: APIPartialEmoji;\n    burst_colors?: string[];\n}\n/** Raw Discord message object. */\nexport interface APIMessage {\n    id: Snowflake;\n    channel_id: Snowflake;\n    author: UserData;\n    content: string;\n    timestamp?: string;\n    edited_timestamp?: string | null;\n    tts?: boolean;\n    mention_everyone?: boolean;\n    mentions?: UserData[];\n    mention_roles?: Snowflake[];\n    mention_channels?: Array<Record<string, unknown>>;\n    attachments?: APIAttachment[];\n    embeds?: APIEmbed[];\n    reactions?: APIMessageReaction[];\n    nonce?: string | number | null;\n    pinned?: boolean;\n    webhook_id?: Snowflake;\n    type?: number;\n    activity?: Record<string, unknown>;\n    application?: Record<string, unknown>;\n    application_id?: Snowflake;\n    message_reference?: APIMessageReference;\n    flags?: number;\n    referenced_message?: APIMessage | null;\n    interaction_metadata?: Record<string, unknown>;\n    thread?: Record<string, unknown>;\n    components?: APIMessageComponent[];\n    sticker_items?: APIStickerItem[];\n    stickers?: APISticker[];\n    position?: number;\n    role_subscription_data?: Record<string, unknown>;\n    purchase_notification?: Record<string, unknown>;\n    poll?: Record<string, unknown>;\n    guild_id?: Snowflake;\n}\n\n// ─── Channels ────────────────────────────────────────────────────────────────\n\n/** Raw Discord channel object. */\nexport interface APIChannel {\n    id: Snowflake;\n    type: number;\n    guild_id?: Snowflake;\n    position?: number;\n    permission_overwrites?: Array<Record<string, unknown>>;\n    name?: string | null;\n    topic?: string | null;\n    nsfw?: boolean;\n    last_message_id?: Snowflake | null;\n    bitrate?: number;\n    user_limit?: number;\n    rate_limit_per_user?: number;\n    recipients?: UserData[];\n    icon?: string | null;\n    owner_id?: Snowflake;\n    application_id?: Snowflake;\n    parent_id?: Snowflake | null;\n    last_pin_timestamp?: string | null;\n    rtc_region?: string | null;\n    video_quality_mode?: number;\n    message_count?: number;\n    member_count?: number;\n    thread_metadata?: APIThreadMetadata;\n    default_auto_archive_duration?: number;\n    flags?: number;\n    total_message_sent?: number;\n    available_tags?: APIForumTag[];\n    default_reaction_emoji?: APIPartialEmoji | null;\n    default_thread_rate_limit_per_user?: number;\n    default_sort_order?: number | null;\n    default_forum_layout?: number;\n}\n\n/** Raw Discord thread metadata. */\nexport interface APIThreadMetadata {\n    archived: boolean;\n    auto_archive_duration: number;\n    archive_timestamp: string;\n    locked: boolean;\n    invitable?: boolean;\n    create_timestamp?: string | null;\n}\n\n/** Raw Discord forum tag. */\nexport interface APIForumTag {\n    id: Snowflake;\n    name: string;\n    moderated: boolean;\n    emoji_id?: Snowflake | null;\n    emoji_name?: string | null;\n}\n\n/** Raw Discord thread member. */\nexport interface APIThreadMember {\n    id?: Snowflake;\n    user_id?: Snowflake;\n    join_timestamp: string;\n    flags: number;\n    member?: APIGuildMember;\n}\n\n// ─── Roles ────────────────────────────────────────────────────────────────────\n\n/** Raw Discord role object. */\nexport interface APIRole {\n    id: Snowflake;\n    name: string;\n    color: number;\n    hoist: boolean;\n    icon?: string | null;\n    unicode_emoji?: string | null;\n    position: number;\n    permissions: string;\n    managed: boolean;\n    mentionable: boolean;\n    tags?: Record<string, unknown>;\n    flags?: number;\n}\n\n// ─── Emoji ────────────────────────────────────────────────────────────────────\n\n/** Raw Discord emoji object. */\nexport interface APIEmoji {\n    id: Snowflake | null;\n    name: string | null;\n    roles?: Snowflake[];\n    user?: UserData;\n    require_colons?: boolean;\n    managed?: boolean;\n    animated?: boolean;\n    available?: boolean;\n}\n\n// ─── Guilds ───────────────────────────────────────────────────────────────────\n\n/** Raw Discord guild object. */\nexport interface APIGuild {\n    id: Snowflake;\n    name: string;\n    icon?: string | null;\n    icon_hash?: string | null;\n    splash?: string | null;\n    discovery_splash?: string | null;\n    owner?: boolean;\n    owner_id?: Snowflake;\n    permissions?: string;\n    afk_channel_id?: Snowflake | null;\n    afk_timeout?: number;\n    widget_enabled?: boolean;\n    widget_channel_id?: Snowflake | null;\n    verification_level?: number;\n    default_message_notifications?: number;\n    explicit_content_filter?: number;\n    roles?: APIRole[];\n    emojis?: APIEmoji[];\n    stickers?: APISticker[];\n    features?: string[];\n    mfa_level?: number;\n    application_id?: Snowflake | null;\n    system_channel_id?: Snowflake | null;\n    system_channel_flags?: number;\n    rules_channel_id?: Snowflake | null;\n    max_presences?: number | null;\n    max_members?: number;\n    vanity_url_code?: string | null;\n    description?: string | null;\n    banner?: string | null;\n    premium_tier?: number;\n    premium_subscription_count?: number;\n    preferred_locale?: string;\n    public_updates_channel_id?: Snowflake | null;\n    max_video_channel_users?: number;\n    approximate_member_count?: number;\n    approximate_presence_count?: number;\n    nsfw_level?: number;\n    safety_alerts_channel_id?: Snowflake | null;\n    member_count?: number;\n}\n\n// ─── Welcome Screen ───────────────────────────────────────────────────────────\n\nexport interface APIWelcomeScreenChannel {\n    channel_id: Snowflake;\n    description: string;\n    emoji_id: Snowflake | null;\n    emoji_name: string | null;\n}\n\nexport interface APIGuildWelcomeScreen {\n    description: string | null;\n    welcome_channels: APIWelcomeScreenChannel[];\n}\n\n// ─── Guild Onboarding ─────────────────────────────────────────────────────────\n\nexport interface APIOnboardingPromptOption {\n    id: Snowflake;\n    channel_ids: Snowflake[];\n    role_ids: Snowflake[];\n    emoji?: APIPartialEmoji;\n    title: string;\n    description: string | null;\n}\n\nexport interface APIOnboardingPrompt {\n    id: Snowflake;\n    type: number;\n    options: APIOnboardingPromptOption[];\n    title: string;\n    single_select: boolean;\n    required: boolean;\n    in_onboarding: boolean;\n}\n\nexport interface APIGuildOnboarding {\n    guild_id: Snowflake;\n    prompts: APIOnboardingPrompt[];\n    default_channel_ids: Snowflake[];\n    enabled: boolean;\n    mode: number;\n}\n\n/** Raw Discord guild member object. */\nexport interface APIGuildMember {\n    user: UserData;\n    nick?: string | null;\n    avatar?: string | null;\n    roles: Snowflake[];\n    joined_at: string;\n    premium_since?: string | null;\n    deaf?: boolean;\n    mute?: boolean;\n    flags?: number;\n    pending?: boolean;\n    permissions?: string;\n    communication_disabled_until?: string | null;\n    guild_id?: Snowflake;\n}\n\n// ─── Voice ────────────────────────────────────────────────────────────────────\n\n/** Raw Discord voice state object. */\nexport interface APIVoiceState {\n    guild_id?: Snowflake;\n    channel_id?: Snowflake | null;\n    user_id: Snowflake;\n    member?: APIGuildMember;\n    session_id: string;\n    deaf: boolean;\n    mute: boolean;\n    self_deaf: boolean;\n    self_mute: boolean;\n    self_stream?: boolean;\n    self_video: boolean;\n    suppress: boolean;\n    request_to_speak_timestamp?: string | null;\n}\n\n/** Raw Discord voice server update event. */\nexport interface APIVoiceServerUpdate {\n    token: string;\n    guild_id: Snowflake;\n    endpoint?: string | null;\n}\n\n// ─── Presence ────────────────────────────────────────────────────────────────\n\n/** Raw Discord activity object. */\nexport interface APIActivity {\n    name: string;\n    type: number;\n    url?: string | null;\n    created_at: number;\n    state?: string | null;\n    details?: string | null;\n    emoji?: APIPartialEmoji | null;\n}\n\n/** Raw Discord presence update event. */\nexport interface APIPresenceUpdate {\n    user: { id: Snowflake } & Partial<UserData>;\n    guild_id: Snowflake;\n    status: string;\n    activities: APIActivity[];\n    client_status: { desktop?: string; mobile?: string; web?: string };\n}\n\n// ─── Typing ───────────────────────────────────────────────────────────────────\n\n/** Raw Discord typing start event. */\nexport interface APITypingStart {\n    channel_id: Snowflake;\n    guild_id?: Snowflake;\n    user_id: Snowflake;\n    timestamp: number;\n    member?: APIGuildMember;\n}\n\n// ─── Guilds ──────────────────────────────────────────────────────────────────\n\n/** Raw Discord guild preview. */\nexport interface APIGuildPreview {\n    id: Snowflake;\n    name: string;\n    icon: string | null;\n    splash: string | null;\n    discovery_splash: string | null;\n    emojis: unknown[];\n    features: string[];\n    approximate_member_count: number;\n    approximate_presence_count: number;\n    description: string | null;\n    stickers: unknown[];\n}\n\n// ─── Invites ─────────────────────────────────────────────────────────────────\n\n/** Raw Discord invite. */\nexport interface APIInvite {\n    code: string;\n    guild?: Partial<APIGuild>;\n    channel: Partial<APIChannel>;\n    inviter?: UserData;\n    target_type?: number;\n    target_user?: UserData;\n    approximate_presence_count?: number;\n    approximate_member_count?: number;\n}\n\n/** Raw Discord invite create event. */\nexport interface APIInviteCreate {\n    channel_id: Snowflake;\n    code: string;\n    created_at: string;\n    guild_id?: Snowflake;\n    inviter?: UserData;\n    max_age: number;\n    max_uses: number;\n    target_type?: number;\n    target_user?: UserData;\n    temporary: boolean;\n    uses: number;\n}\n\n/** Raw Discord invite delete event. */\nexport interface APIInviteDelete {\n    channel_id: Snowflake;\n    guild_id?: Snowflake;\n    code: string;\n}\n\n// ─── Webhooks ────────────────────────────────────────────────────────────────\n\n/** Raw Discord webhooks update event. */\nexport interface APIWebhooksUpdate {\n    guild_id: Snowflake;\n    channel_id: Snowflake;\n}\n\n/** Raw Discord webhook object. */\nexport interface APIWebhook {\n    id: Snowflake;\n    type: number;\n    guild_id?: Snowflake | null;\n    channel_id?: Snowflake | null;\n    user?: UserData;\n    name?: string | null;\n    avatar?: string | null;\n    token?: string;\n    application_id?: Snowflake | null;\n    url?: string;\n}\n\n// ─── AutoMod ─────────────────────────────────────────────────────────────────\n\n/** Raw Discord AutoMod action. */\nexport interface APIAutoModerationAction {\n    type: number;\n    metadata?: {\n        channel_id?: Snowflake;\n        duration_seconds?: number;\n        custom_message?: string;\n    };\n}\n\n// ─── Audit Logs ──────────────────────────────────────────────────────────────\n\n/** Raw Discord audit log change object. */\nexport interface APIAuditLogChange {\n    new_value?: unknown;\n    old_value?: unknown;\n    key: string;\n}\n\n/** Raw Discord audit log entry options object. */\nexport interface APIAuditLogOptions {\n    app_id?: Snowflake;\n    auto_moderation_rule_name?: string;\n    auto_moderation_rule_trigger_type?: string;\n    channel_id?: Snowflake;\n    count?: string;\n    delete_member_days?: string;\n    id?: Snowflake;\n    members_removed?: string;\n    message_id?: Snowflake;\n    role_name?: string;\n    type?: string;\n    integration_type?: string;\n}\n\n/** Raw Discord audit log entry object. */\nexport interface APIAuditLogEntry {\n    target_id: string | null;\n    changes?: APIAuditLogChange[];\n    user_id: Snowflake | null;\n    id: Snowflake;\n    action_type: number;\n    options?: APIAuditLogOptions;\n    reason?: string;\n}\n\n/** Raw Discord audit log object. */\nexport interface APIAuditLog {\n    audit_log_entries: APIAuditLogEntry[];\n    guild_scheduled_events: APIGuildScheduledEvent[];\n    integrations: Array<Record<string, unknown>>;\n    threads: APIChannel[];\n    users: UserData[];\n    webhooks: APIWebhook[];\n    application_commands: APIApplicationCommand[];\n    auto_moderation_rules: APIAutoModerationRule[];\n}\n\n/** Raw Discord AutoMod rule object. */\nexport interface APIAutoModerationRule {\n    id: Snowflake;\n    guild_id: Snowflake;\n    name: string;\n    creator_id: Snowflake;\n    event_type: number;\n    trigger_type: number;\n    trigger_metadata: Record<string, unknown>;\n    actions: APIAutoModerationAction[];\n    enabled: boolean;\n    exempt_roles: Snowflake[];\n    exempt_channels: Snowflake[];\n}\n\n/** Raw Discord AutoMod action execution event. */\nexport interface APIAutoModerationActionExecution {\n    guild_id: Snowflake;\n    action: APIAutoModerationAction;\n    rule_id: Snowflake;\n    rule_trigger_type: number;\n    user_id: Snowflake;\n    channel_id?: Snowflake;\n    message_id?: Snowflake;\n    alert_system_message_id?: Snowflake;\n    content: string;\n    matched_keyword?: string | null;\n    matched_content?: string | null;\n}\n\n// ─── Scheduled Events ─────────────────────────────────────────────────────────\n\n/** Raw Discord guild scheduled event entity metadata. */\nexport interface APIGuildScheduledEventEntityMetadata {\n    location?: string;\n}\n\n/** Raw Discord guild scheduled event object. */\nexport interface APIGuildScheduledEvent {\n    id: Snowflake;\n    guild_id: Snowflake;\n    channel_id?: Snowflake | null;\n    creator_id?: Snowflake | null;\n    name: string;\n    description?: string | null;\n    scheduled_start_time: string;\n    scheduled_end_time?: string | null;\n    privacy_level: number;\n    status: number;\n    entity_type: number;\n    entity_id?: Snowflake | null;\n    entity_metadata?: APIGuildScheduledEventEntityMetadata | null;\n    creator?: UserData;\n    user_count?: number;\n    image?: string | null;\n}\n\n// ─── Stage Instances ─────────────────────────────────────────────────────────\n\n/** Raw Discord stage instance object. */\nexport interface APIStageInstance {\n    id: Snowflake;\n    guild_id: Snowflake;\n    channel_id: Snowflake;\n    topic: string;\n    privacy_level: number;\n    discoverable_disabled?: boolean;\n    guild_scheduled_event_id?: Snowflake | null;\n}\n\n// ─── Application Commands ─────────────────────────────────────────────────────\n\n/** Discord application command option types. */\nexport const ApplicationCommandOptionType = {\n    SubCommand: 1,\n    SubCommandGroup: 2,\n    String: 3,\n    Integer: 4,\n    Boolean: 5,\n    User: 6,\n    Channel: 7,\n    Role: 8,\n    Mentionable: 9,\n    Number: 10,\n    Attachment: 11,\n} as const;\n\n/** Discord application command types. */\nexport const ApplicationCommandType = {\n    ChatInput: 1,\n    User: 2,\n    Message: 3,\n} as const;\n\n/** Raw Discord application command option. */\nexport interface APIApplicationCommandOption {\n    type: number;\n    name: string;\n    description: string;\n    required?: boolean;\n    choices?: Array<{ name: string; value: string | number }>;\n    options?: APIApplicationCommandOption[];\n    min_value?: number;\n    max_value?: number;\n    min_length?: number;\n    max_length?: number;\n    autocomplete?: boolean;\n    channel_types?: number[];\n}\n\n/** Raw Discord application command object (from API). */\nexport interface APIApplicationCommand {\n    id: Snowflake;\n    type?: number;\n    application_id: Snowflake;\n    guild_id?: Snowflake;\n    name: string;\n    description: string;\n    options?: APIApplicationCommandOption[];\n    default_member_permissions?: string | null;\n    dm_permission?: boolean;\n    nsfw?: boolean;\n    version: Snowflake;\n}\n\n/** Data for creating/overwriting an application command. */\nexport interface ApplicationCommandData {\n    name: string;\n    description: string;\n    type?: number;\n    options?: APIApplicationCommandOption[];\n    default_member_permissions?: string | null;\n    dm_permission?: boolean;\n    nsfw?: boolean;\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "02206D15DB14DD1464756E2164756E21",
+  "mappings": ";;AAGO,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;AAgBhB,SAAS,qBAAqB,CACjC,SACM;AAAA,EACN,IAAI,OAAO,YAAY;AAAA,IAAU,OAAO;AAAA,EACxC,IAAI,WAAW,OAAO,YAAY,YAAY,CAAC,MAAM,QAAQ,OAAO;AAAA,IAChE,OAAO,QAAQ;AAAA,EACnB,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;AAAA;AAOJ,MAAM,gBAAgB;AAAA,SAEF,QAAQ;AAAA,EAExB;AAAA,EAEA,WAAW,CAAC,OAAgC,GAAG;AAAA,IAClD,KAAK,WAAW,sBAAsB,IAAI;AAAA;AAAA,EAIvC,GAAG,CAAC,MAAwC;AAAA,IAC/C,MAAM,WAAW,sBAAsB,IAAI;AAAA,IAC3C,QAAQ,KAAK,WAAW,cAAc;AAAA;AAAA,EAInC,GAAG,CAAC,MAAwC;AAAA,IAC/C,QAAQ,KAAK,WAAW,sBAAsB,IAAI,OAAO;AAAA;AAAA,EAItD,GAAG,IAAI,MAAuC;AAAA,IACjD,WAAW,OAAO;AAAA,MAAM,KAAK,YAAY,sBAAsB,GAAG;AAAA,IAClE,OAAO;AAAA;AAAA,EAIJ,MAAM,IAAI,MAAuC;AAAA,IACpD,WAAW,OAAO;AAAA,MAAM,KAAK,YAAY,CAAC,sBAAsB,GAAG;AAAA,IACnE,OAAO;AAAA;AAAA,EAIJ,OAAO,GAAuC;AAAA,IACjD,OACI,OAAO,KAAK,iBAAiB,EAC/B,OAAO,CAAC,SAAS,KAAK,IAAI,kBAAkB,KAAK,CAAC;AAAA;AAAA,EAIjD,MAAM,CAAC,MAAwC;AAAA,IAClD,OAAO,KAAK,aAAa,sBAAsB,IAAI;AAAA;AAAA,EAGhD,OAAO,GAAW;AAAA,IACrB,OAAO,KAAK;AAAA;AAAA,EAGT,MAAM,GAAW;AAAA,IACpB,OAAO,KAAK;AAAA;AAEpB;;;ACrHO,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": "C1043445F681533C64756E2164756E21",
   "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. */\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"
   ],
-  "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,115 @@ 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;
+}
+/** Discord.js-familiar alias for {@link VoiceConnectionState}. Member values are Lunibee's. */
+export { VoiceConnectionState as VoiceConnectionStatus };
+/**
+ * Joins (or moves to) a voice channel, reusing the guild's tracked connection.
+ * Mirrors `@discordjs/voice`'s `joinVoiceChannel`; transports are still attached
+ * with {@link VoiceConnection.attachTransports}.
+ * @param options Guild, channel and self mute/deaf flags.
+ * @returns The guild's voice connection.
+ * @throws {TypeError} If the guild or channel ID is empty.
+ */
+export declare function joinVoiceChannel(options: VoiceConnectionOptions & {
+    channelId: string;
+}): VoiceConnection;
+/** Returns the connection tracked by {@link joinVoiceChannel} for a guild, if any. */
+export declare function getVoiceConnection(guildId: string): VoiceConnection | undefined;
+/** Creates an {@link AudioPlayer}. Mirrors `@discordjs/voice`'s `createAudioPlayer`. */
+export declare function createAudioPlayer(): AudioPlayer;
+/** Creates an {@link AudioStream}. Mirrors `@discordjs/voice`'s `createAudioResource`. */
+export declare function createAudioResource(stream: ReadableStream<Uint8Array>, metadata?: {
+    title?: string;
+    duration?: number;
+}): AudioStream;
+/**
+ * Resolves once a connection or player reaches `status`, or rejects after `timeoutMs`.
+ * Mirrors `@discordjs/voice`'s `entersState`.
+ * @returns The same target, for chaining.
+ * @throws {VoiceError} If the state is not reached in time.
+ */
+export declare function entersState<T extends VoiceConnection | AudioPlayer>(target: T, status: T extends VoiceConnection ? VoiceConnectionState : AudioPlayerState, timeoutMs: number): Promise<T>;