novaapp-sdk 1.4.0 → 1.4.1

package/dist/index.mjs

@@ -355,6 +355,74 @@ var MembersAPI = class {
   removeRole(serverId, userId, roleId) {
     return this.http.delete(`/servers/${serverId}/members/${userId}/roles/${roleId}`);
   }
+  /**
+   * Issue a warning to a member.
+   * Requires the `members.moderate` scope.
+   *
+   * @example
+   * await client.members.warn('server-id', 'user-id', 'Spamming')
+   */
+  warn(serverId, userId, reason) {
+    return this.http.post(`/servers/${serverId}/members/${userId}/warn`, { reason });
+  }
+  /**
+   * Fetch warnings for a server (or optionally a specific user).
+   * Requires the `members.moderate` scope.
+   *
+   * @example
+   * const all = await client.members.fetchWarnings('server-id')
+   * const userWarnings = await client.members.fetchWarnings('server-id', { userId: 'user-id' })
+   */
+  fetchWarnings(serverId, options = {}) {
+    const params = new URLSearchParams();
+    if (options.userId) params.set("userId", options.userId);
+    const qs = params.toString() ? `?${params.toString()}` : "";
+    return this.http.get(`/servers/${serverId}/warnings${qs}`);
+  }
+  /**
+   * Remove a warning by its ID.
+   * Requires the `members.moderate` scope.
+   *
+   * @example
+   * await client.members.removeWarning('warning-id')
+   */
+  removeWarning(warningId) {
+    return this.http.delete(`/warnings/${warningId}`);
+  }
+  /**
+   * Get a member's XP and level.
+   * Requires the `members.read` scope.
+   *
+   * @example
+   * const xpData = await client.members.getXP('server-id', 'user-id')
+   * console.log(`Level ${xpData.level} — ${xpData.xp} XP`)
+   */
+  getXP(serverId, userId) {
+    return this.http.get(`/servers/${serverId}/members/${userId}/xp`);
+  }
+  /**
+   * Set or add XP to a member.
+   * Requires the `members.manage` scope.
+   *
+   * @example
+   * // Add 50 XP
+   * await client.members.setXP('server-id', 'user-id', { add: 50 })
+   * // Set XP to a specific value
+   * await client.members.setXP('server-id', 'user-id', { xp: 1000 })
+   */
+  setXP(serverId, userId, options) {
+    return this.http.patch(`/servers/${serverId}/members/${userId}/xp`, options);
+  }
+  /**
+   * Get the XP leaderboard for a server.
+   * Requires the `members.read` scope.
+   *
+   * @example
+   * const top10 = await client.members.leaderboard('server-id', 10)
+   */
+  leaderboard(serverId, limit = 10) {
+    return this.http.get(`/servers/${serverId}/leaderboard?limit=${limit}`);
+  }
 };
 
 // src/api/servers.ts
@@ -404,6 +472,34 @@ var ServersAPI = class {
   listRoles(serverId) {
     return this.http.get(`/servers/${serverId}/roles`);
   }
+  /**
+   * Fetch all channel categories in a server.
+   *
+   * @example
+   * const categories = await client.servers.listCategories('server-id')
+   */
+  listCategories(serverId) {
+    return this.http.get(`/servers/${serverId}/categories`);
+  }
+  /**
+   * Get server statistics (member count, message count, etc.).
+   *
+   * @example
+   * const stats = await client.servers.getStats('server-id')
+   * console.log(`${stats.onlineCount} online / ${stats.memberCount} total`)
+   */
+  getStats(serverId) {
+    return this.http.get(`/servers/${serverId}/stats`);
+  }
+  /**
+   * Fetch all soundboard clips uploaded to a server.
+   *
+   * @example
+   * const clips = await client.servers.listSoundboard('server-id')
+   */
+  listSoundboard(serverId) {
+    return this.http.get(`/servers/${serverId}/soundboard`);
+  }
 };
 
 // src/api/interactions.ts
@@ -681,6 +777,18 @@ var ChannelsAPI = class {
   startTyping(channelId) {
     return this.http.post(`/channels/${channelId}/typing`);
   }
+  /**
+   * Bulk delete up to 100 messages from a channel at once.
+   * Requires the `messages.manage` scope.
+   * Soft-deletes all specified messages in a single operation.
+   *
+   * @example
+   * const result = await client.channels.bulkDelete('channel-id', ['msg1', 'msg2', 'msg3'])
+   * console.log(`Deleted ${result.deleted} messages`)
+   */
+  bulkDelete(channelId, messageIds) {
+    return this.http.post(`/channels/${channelId}/bulk-delete`, { messageIds });
+  }
 };
 
 // src/api/reactions.ts
@@ -989,6 +1097,224 @@ var AuditLogAPI = class {
   }
 };
 
+// src/api/forum.ts
+var ForumAPI = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * List forum posts in a FORUM channel.
+   *
+   * @example
+   * const posts = await client.forum.list('channel-id')
+   */
+  async list(channelId, options = {}) {
+    const params = new URLSearchParams();
+    if (options.limit !== void 0) params.set("limit", String(options.limit));
+    if (options.before) params.set("before", options.before);
+    const qs = params.toString() ? `?${params.toString()}` : "";
+    return this.http.get(`/channels/${channelId}/forum-posts${qs}`);
+  }
+  /**
+   * Create a forum post in a FORUM channel.
+   *
+   * @example
+   * const post = await client.forum.create('channel-id', {
+   *   title: 'Ideas thread',
+   *   body: 'Post your ideas here!',
+   *   tags: ['idea', 'discussion'],
+   * })
+   */
+  async create(channelId, options) {
+    return this.http.post(`/channels/${channelId}/forum-posts`, options);
+  }
+  /**
+   * Edit a forum post.
+   * The bot must be the author of the post.
+   *
+   * @example
+   * await client.forum.edit('post-id', { closed: true })
+   */
+  async edit(postId, options) {
+    return this.http.patch(`/forum-posts/${postId}`, options);
+  }
+  /**
+   * Delete a forum post.
+   * The bot must be the author of the post.
+   *
+   * @example
+   * await client.forum.delete('post-id')
+   */
+  async delete(postId) {
+    await this.http.delete(`/forum-posts/${postId}`);
+  }
+};
+
+// src/api/events.ts
+var EventsAPI = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * List server events.
+   *
+   * @example
+   * const events = await client.events.list('server-id', { upcoming: true })
+   */
+  async list(serverId, options = {}) {
+    const params = new URLSearchParams();
+    if (options.limit !== void 0) params.set("limit", String(options.limit));
+    if (options.upcoming) params.set("upcoming", "true");
+    const qs = params.toString() ? `?${params.toString()}` : "";
+    return this.http.get(`/servers/${serverId}/events${qs}`);
+  }
+  /**
+   * Fetch a single server event by ID.
+   * Returns full attendee list.
+   *
+   * @example
+   * const event = await client.events.fetch('event-id')
+   */
+  async fetch(eventId) {
+    return this.http.get(`/events/${eventId}`);
+  }
+  /**
+   * Create a server event.
+   *
+   * @example
+   * const event = await client.events.create('server-id', {
+   *   title: 'Game Night',
+   *   description: 'Friday fun!',
+   *   startAt: new Date(Date.now() + 86400_000).toISOString(),
+   * })
+   */
+  async create(serverId, options) {
+    return this.http.post(`/servers/${serverId}/events`, options);
+  }
+  /**
+   * Edit a server event.
+   *
+   * @example
+   * await client.events.edit('event-id', { title: 'Game Night v2' })
+   */
+  async edit(eventId, options) {
+    return this.http.patch(`/events/${eventId}`, options);
+  }
+  /**
+   * Delete a server event.
+   *
+   * @example
+   * await client.events.delete('event-id')
+   */
+  async delete(eventId) {
+    await this.http.delete(`/events/${eventId}`);
+  }
+};
+
+// src/api/categories.ts
+var CategoriesAPI = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * List all channel categories in a server, ordered by position.
+   *
+   * @example
+   * const cats = await client.categories.list('server-id')
+   */
+  async list(serverId) {
+    return this.http.get(`/servers/${serverId}/categories`);
+  }
+  /**
+   * Create a new channel category.
+   *
+   * @example
+   * const cat = await client.categories.create('server-id', { name: 'General', position: 0 })
+   */
+  async create(serverId, options) {
+    return this.http.post(`/servers/${serverId}/categories`, options);
+  }
+  /**
+   * Edit an existing channel category.
+   *
+   * @example
+   * await client.categories.edit('cat-id', { name: 'Renamed' })
+   */
+  async edit(categoryId, options) {
+    return this.http.patch(`/categories/${categoryId}`, options);
+  }
+  /**
+   * Delete a channel category.
+   *
+   * @example
+   * await client.categories.delete('cat-id')
+   */
+  async delete(categoryId) {
+    await this.http.delete(`/categories/${categoryId}`);
+  }
+};
+
+// src/api/automod.ts
+var AutoModAPI = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * List all automod rules for a server.
+   *
+   * @example
+   * const rules = await client.automod.list('server-id')
+   */
+  async list(serverId) {
+    return this.http.get(`/servers/${serverId}/automod`);
+  }
+  /**
+   * Create a new automod rule.
+   *
+   * @example
+   * await client.automod.create('server-id', { type: 'BLOCKED_WORD', value: 'badword' })
+   * await client.automod.create('server-id', { type: 'BLOCKED_LINK', value: 'example.com' })
+   */
+  async create(serverId, options) {
+    return this.http.post(`/servers/${serverId}/automod`, options);
+  }
+  /**
+   * Enable / disable a rule or update the blocked value.
+   *
+   * @example
+   * await client.automod.edit('rule-id', { enabled: false })
+   */
+  async edit(ruleId, options) {
+    return this.http.patch(`/automod/${ruleId}`, options);
+  }
+  /**
+   * Delete an automod rule.
+   *
+   * @example
+   * await client.automod.delete('rule-id')
+   */
+  async delete(ruleId) {
+    await this.http.delete(`/automod/${ruleId}`);
+  }
+};
+
+// src/api/users.ts
+var UsersAPI = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Fetch a user's public profile by ID.
+   *
+   * @example
+   * const user = await client.users.fetch('user-id')
+   * console.log(user.displayName)
+   */
+  async fetch(userId) {
+    return this.http.get(`/users/${userId}`);
+  }
+};
+
 // src/structures/NovaInteraction.ts
 var InteractionOptions = class {
   constructor(data) {
@@ -1313,6 +1639,63 @@ var NovaMessage = class _NovaMessage {
     const raw = await this._messages.fetchOne(this.id);
     return new _NovaMessage(raw, this._messages, this._reactions);
   }
+  /**
+   * Forward this message's content (and embed if present) to another channel.
+   * Creates a new message in the target channel.
+   *
+   * @example
+   * const forwarded = await msg.forward('target-channel-id')
+   * console.log('Forwarded to:', forwarded.channelId)
+   */
+  async forward(channelId) {
+    const opts = {
+      content: this.content || void 0,
+      ...this.embed ? { embed: this.embed } : {}
+    };
+    const raw = await this._messages.send(channelId, opts);
+    return new _NovaMessage(raw, this._messages, this._reactions);
+  }
+  /**
+   * Fetch detailed reaction data for a specific emoji on this message.
+   * Returns the users who reacted with that emoji.
+   *
+   * @example
+   * const reactors = await msg.fetchReactionDetails('👍')
+   * for (const r of reactors) console.log(r.username, 'reacted 👍')
+   */
+  fetchReactionDetails(emoji) {
+    return this._reactions.fetchEmoji(this.id, emoji);
+  }
+  /**
+   * Remove **all** reactions from this message.
+   * Requires the `messages.manage` scope.
+   *
+   * @example
+   * await msg.clearAllReactions()
+   */
+  clearAllReactions() {
+    return this._reactions.removeAll(this.id);
+  }
+  /**
+   * Remove all reactions for a specific emoji from this message.
+   * Requires the `messages.manage` scope.
+   *
+   * @example
+   * await msg.clearReactionsFor('👍')
+   */
+  clearReactionsFor(emoji) {
+    return this._reactions.removeEmoji(this.id, emoji);
+  }
+  /**
+   * Fetch a breakdown of all reactions on this message, grouped by emoji.
+   *
+   * @example
+   * const details = await msg.fetchAllReactions()
+   * for (const d of details) console.log(`${d.emoji} — ${d.count}`)
+   */
+  fetchAllReactions() {
+    return this._reactions.fetch(this.id);
+  }
   /**
    * Get a URL to this message (deep link).
    */
@@ -1344,7 +1727,7 @@ var NovaMessage = class _NovaMessage {
 
 // src/structures/NovaChannel.ts
 var NovaChannel = class _NovaChannel {
-  constructor(raw, channels, messages) {
+  constructor(raw, channels, messages, webhooks, forum) {
     this.id = raw.id;
     this.name = raw.name;
     this.type = raw.type;
@@ -1355,6 +1738,8 @@ var NovaChannel = class _NovaChannel {
     this.createdAt = new Date(raw.createdAt);
     this._channels = channels;
     this._messages = messages;
+    this._webhooks = webhooks;
+    this._forum = forum;
   }
   // ─── Type guards ────────────────────────────────────────────────────────────
   /** `true` for text channels. */
@@ -1431,7 +1816,7 @@ var NovaChannel = class _NovaChannel {
    */
   async edit(options) {
     const raw = await this._channels.edit(this.id, options);
-    return new _NovaChannel(raw, this._channels, this._messages);
+    return new _NovaChannel(raw, this._channels, this._messages, this._webhooks, this._forum);
   }
   /**
    * Delete this channel.
@@ -1443,6 +1828,67 @@ var NovaChannel = class _NovaChannel {
   delete() {
     return this._channels.delete(this.id);
   }
+  /**
+   * Bulk-delete multiple messages in this channel (max 100 at once).
+   * Requires the `messages.manage` scope.
+   *
+   * @example
+   * const ids = messages.map(m => m.id)
+   * const result = await channel.bulkDelete(ids)
+   * console.log(`Deleted ${result.deleted} messages`)
+   */
+  bulkDelete(messageIds) {
+    return this._channels.bulkDelete(this.id, messageIds);
+  }
+  // ─── Webhooks ────────────────────────────────────────────────────────────────
+  /**
+   * Create a webhook in this channel.
+   * Requires the `webhooks.manage` scope.
+   *
+   * @example
+   * const wh = await channel.createWebhook({ name: 'Notifications' })
+   * console.log('Token:', wh.token)
+   */
+  createWebhook(options) {
+    if (!this._webhooks) throw new Error("[NovaChannel] WebhooksAPI not available \u2014 ensure you obtained this channel from client.fetchChannel()");
+    return this._webhooks.create(this.id, options);
+  }
+  /**
+   * Fetch all webhooks in this channel.
+   * Requires the `webhooks.manage` scope.
+   *
+   * @example
+   * const webhooks = await channel.fetchWebhooks()
+   */
+  fetchWebhooks() {
+    if (!this._webhooks) throw new Error("[NovaChannel] WebhooksAPI not available \u2014 ensure you obtained this channel from client.fetchChannel()");
+    return this._webhooks.list(this.id);
+  }
+  // ─── Forum ───────────────────────────────────────────────────────────────────
+  /**
+   * Create a new post in this FORUM channel.
+   * Requires the `channels.write` scope.
+   *
+   * @example
+   * const post = await channel.createForumPost({
+   *   title: 'Announcement',
+   *   content: 'Welcome everyone!',
+   * })
+   */
+  createForumPost(options) {
+    if (!this._forum) throw new Error("[NovaChannel] ForumAPI not available \u2014 ensure you obtained this channel from client.fetchChannel()");
+    return this._forum.create(this.id, options);
+  }
+  /**
+   * Fetch posts from this FORUM channel.
+   *
+   * @example
+   * const posts = await channel.fetchForumPosts({ limit: 20 })
+   */
+  fetchForumPosts(options) {
+    if (!this._forum) throw new Error("[NovaChannel] ForumAPI not available \u2014 ensure you obtained this channel from client.fetchChannel()");
+    return this._forum.list(this.id, options);
+  }
   // ─── Serialisation ──────────────────────────────────────────────────────────
   /**
    * Returns the channel as a mention-style string: `#name`.
@@ -1560,29 +2006,106 @@ var NovaMember = class {
   removeRole(roleId) {
     return this._members.removeRole(this.serverId, this.userId, roleId);
   }
-  // ─── Serialisation ──────────────────────────────────────────────────────────
+  // ─── Moderation ─────────────────────────────────────────────────────────────
   /**
-   * Returns a mention-style string: `@displayName`.
+   * Issue a warning to this member.
+   * Requires the `members.moderate` scope.
+   *
+   * @example
+   * await member.warn('Excessive spamming')
    */
-  toString() {
-    return `@${this.displayName}`;
+  warn(reason) {
+    return this._members.warn(this.serverId, this.userId, reason);
   }
-  /** Returns the raw member data. */
-  toJSON() {
-    return {
-      role: this.role,
-      joinedAt: this.joinedAt.toISOString(),
-      user: {
-        id: this.userId,
-        username: this.username,
-        displayName: this.displayName,
-        avatar: this.avatar,
-        status: this.status,
-        isBot: this.isBot
-      }
-    };
-  }
-};
+  /**
+   * Fetch all warnings for this member in this server.
+   * Requires the `members.moderate` scope.
+   *
+   * @example
+   * const warnings = await member.fetchWarnings()
+   * console.log(`${warnings.length} warnings on record`)
+   */
+  fetchWarnings() {
+    return this._members.fetchWarnings(this.serverId, { userId: this.userId });
+  }
+  // ─── XP & Levels ────────────────────────────────────────────────────────────
+  /**
+   * Get this member's current XP and level.
+   * Requires the `members.read` scope.
+   *
+   * @example
+   * const xp = await member.getXP()
+   * console.log(`Level ${xp.level} — ${xp.xp} XP`)
+   */
+  getXP() {
+    return this._members.getXP(this.serverId, this.userId);
+  }
+  /**
+   * Set this member's XP to a specific value.
+   * Requires the `members.manage` scope.
+   *
+   * @example
+   * await member.setXP(500)
+   */
+  setXP(xp) {
+    return this._members.setXP(this.serverId, this.userId, { xp });
+  }
+  /**
+   * Add (or subtract) XP to this member's current total.
+   * Requires the `members.manage` scope.
+   *
+   * @example
+   * await member.addXP(100)   // reward 100 XP
+   * await member.addXP(-50)   // deduct 50 XP
+   */
+  addXP(amount) {
+    return this._members.setXP(this.serverId, this.userId, { add: amount });
+  }
+  /**
+   * Delete all warnings on record for this member in this server.
+   * Requires the `members.moderate` scope.
+   *
+   * @example
+   * await member.clearWarnings()
+   */
+  async clearWarnings() {
+    const warnings = await this.fetchWarnings();
+    await Promise.all(warnings.map((w) => this._members.removeWarning(w.id)));
+    return warnings.length;
+  }
+  /**
+   * Reset this member's XP back to zero.
+   * Requires the `members.manage` scope.
+   *
+   * @example
+   * await member.resetXP()
+   */
+  resetXP() {
+    return this._members.setXP(this.serverId, this.userId, { xp: 0 });
+  }
+  // ─── Serialisation ──────────────────────────────────────────────────────────
+  /**
+   * Returns a mention-style string: `@displayName`.
+   */
+  toString() {
+    return `@${this.displayName}`;
+  }
+  /** Returns the raw member data. */
+  toJSON() {
+    return {
+      role: this.role,
+      joinedAt: this.joinedAt.toISOString(),
+      user: {
+        id: this.userId,
+        username: this.username,
+        displayName: this.displayName,
+        avatar: this.avatar,
+        status: this.status,
+        isBot: this.isBot
+      }
+    };
+  }
+};
 
 // src/structures/NovaRole.ts
 var NovaRole = class {
@@ -1659,7 +2182,7 @@ var NovaRole = class {
 
 // src/structures/NovaServer.ts
 var NovaServerWrapper = class {
-  constructor(raw, servers, channels, members, invites, roles, messages) {
+  constructor(raw, servers, channels, members, invites, roles, messages, categories, events, automod, auditLog) {
     this.id = raw.id;
     this.name = raw.name;
     this.icon = raw.icon;
@@ -1673,6 +2196,10 @@ var NovaServerWrapper = class {
     this._invites = invites;
     this._roles = roles;
     this._messages = messages;
+    this._categories = categories;
+    this._events = events;
+    this._automod = automod;
+    this._auditLog = auditLog;
   }
   // ─── Server management ────────────────────────────────────────────────────
   /**
@@ -1751,14 +2278,25 @@ var NovaServerWrapper = class {
   }
   // ─── Roles ────────────────────────────────────────────────────────────────
   /**
-   * Fetch all custom roles in this server.
+   * List all custom roles in this server, sorted by position.
    *
    * @example
    * const roles = await server.fetchRoles()
+   * const admins = roles.filter(r => r.name === 'Admin')
    */
   fetchRoles() {
     return this._roles.list(this.id);
   }
+  /**
+   * Create a new custom role in this server.
+   * Requires the `roles.manage` scope.
+   *
+   * @example
+   * const role = await server.createRole({ name: 'Supporter', color: '#00d4ff', hoist: true })
+   */
+  createRole(options) {
+    return this._roles.create(this.id, options);
+  }
   // ─── Invites ──────────────────────────────────────────────────────────────
   /**
    * Fetch all active invites for this server.
@@ -1789,6 +2327,133 @@ var NovaServerWrapper = class {
   send(channelId, content) {
     return this._messages.send(channelId, { content });
   }
+  // ─── Categories ───────────────────────────────────────────────────────────
+  /**
+   * Fetch all channel categories in this server.
+   *
+   * @example
+   * const cats = await server.fetchCategories()
+   * const general = cats.find(c => c.name === 'General')
+   */
+  fetchCategories() {
+    if (!this._categories) throw new Error("[NovaServerWrapper] CategoriesAPI not available");
+    return this._categories.list(this.id);
+  }
+  /**
+   * Create a new channel category in this server.
+   * Requires the `channels.manage` scope.
+   *
+   * @example
+   * const cat = await server.createCategory({ name: 'Bot Channels' })
+   */
+  createCategory(options) {
+    if (!this._categories) throw new Error("[NovaServerWrapper] CategoriesAPI not available");
+    return this._categories.create(this.id, options);
+  }
+  // ─── Events ───────────────────────────────────────────────────────────────
+  /**
+   * Fetch server events. Pass `{ upcoming: true }` to only return future events.
+   *
+   * @example
+   * const events = await server.fetchEvents({ upcoming: true })
+   */
+  fetchEvents(options = {}) {
+    if (!this._events) throw new Error("[NovaServerWrapper] EventsAPI not available");
+    return this._events.list(this.id, options);
+  }
+  /**
+   * Create a new server event.
+   * Requires the `server.manage` scope.
+   *
+   * @example
+   * const event = await server.createEvent({
+   *   title: 'Game Night',
+   *   startAt: new Date('2025-09-01T20:00:00Z').toISOString(),
+   * })
+   */
+  createEvent(options) {
+    if (!this._events) throw new Error("[NovaServerWrapper] EventsAPI not available");
+    return this._events.create(this.id, options);
+  }
+  // ─── Stats & Audit Log ────────────────────────────────────────────────────
+  /**
+   * Fetch server statistics (member count, message count, etc.).
+   *
+   * @example
+   * const stats = await server.fetchStats()
+   * console.log(`Online: ${stats.onlineCount} / ${stats.memberCount}`)
+   */
+  fetchStats() {
+    return this._servers.getStats(this.id);
+  }
+  /**
+   * Fetch the audit log for this server.
+   * Requires the `audit-log.read` scope.
+   *
+   * @example
+   * const log = await server.fetchAuditLog({ action: 'member.banned', limit: 20 })
+   */
+  fetchAuditLog(options = {}) {
+    if (!this._auditLog) throw new Error("[NovaServerWrapper] AuditLogAPI not available");
+    return this._auditLog.fetch(this.id, options);
+  }
+  // ─── Warnings & Leaderboard ───────────────────────────────────────────────
+  /**
+   * Issue a warning to a member in this server.
+   * Requires the `members.moderate` scope.
+   *
+   * @example
+   * await server.warn('user-id', 'Insulting other members')
+   */
+  warn(userId, reason) {
+    return this._members.warn(this.id, userId, reason);
+  }
+  /**
+   * Fetch warnings for this server, optionally filtered by user.
+   * Requires the `members.moderate` scope.
+   *
+   * @example
+   * const all = await server.fetchWarnings()
+   * const userWarns = await server.fetchWarnings({ userId: 'user-id' })
+   */
+  fetchWarnings(options = {}) {
+    return this._members.fetchWarnings(this.id, options);
+  }
+  /**
+   * Fetch the XP leaderboard for this server.
+   * Requires the `members.read` scope.
+   *
+   * @example
+   * const top = await server.fetchLeaderboard(10)
+   * top.forEach(e => console.log(`#${e.rank} ${e.user.displayName} — ${e.xp} XP`))
+   */
+  fetchLeaderboard(limit = 10) {
+    return this._members.leaderboard(this.id, limit);
+  }
+  // ─── AutoMod ─────────────────────────────────────────────────────────────
+  /**
+   * Fetch all AutoMod rules for this server.
+   * Requires the `server.manage` scope.
+   *
+   * @example
+   * const rules = await server.fetchAutoModRules()
+   * const active = rules.filter(r => r.enabled)
+   */
+  fetchAutoModRules() {
+    if (!this._automod) throw new Error("[NovaServerWrapper] AutoModAPI not available");
+    return this._automod.list(this.id);
+  }
+  /**
+   * Create a new AutoMod rule for this server.
+   * Requires the `server.manage` scope.
+   *
+   * @example
+   * await server.createAutoModRule({ type: 'BLOCKED_WORD', value: 'badword' })
+   */
+  createAutoModRule(options) {
+    if (!this._automod) throw new Error("[NovaServerWrapper] AutoModAPI not available");
+    return this._automod.create(this.id, options);
+  }
   // ─── Helpers ─────────────────────────────────────────────────────────────
   toJSON() {
     return {
@@ -1916,6 +2581,265 @@ var NovaWebhook = class {
   }
 };
 
+// src/structures/NovaForumPost.ts
+var NovaForumPost = class _NovaForumPost {
+  constructor(raw, forum) {
+    this.raw = raw;
+    this.forum = forum;
+    this.id = raw.id;
+    this.channelId = raw.channelId;
+    this.authorId = raw.authorId;
+    this.title = raw.title;
+    this.body = raw.body;
+    this.tags = raw.tags;
+    this.pinned = raw.pinned;
+    this.closed = raw.closed;
+    this.upvoteCount = raw.upvoteCount;
+    this.replyCount = raw.replyCount;
+    this.author = raw.author;
+    this.createdAt = raw.createdAt;
+    this.updatedAt = raw.updatedAt;
+  }
+  /**
+   * Edit this forum post.
+   *
+   * @example
+   * await post.edit({ title: 'Updated title' })
+   */
+  async edit(options) {
+    const updated = await this.forum.edit(this.id, options);
+    return new _NovaForumPost(updated, this.forum);
+  }
+  /**
+   * Close the forum post (no new replies).
+   *
+   * @example
+   * await post.close()
+   */
+  async close() {
+    return this.edit({ closed: true });
+  }
+  /**
+   * Re-open a closed forum post.
+   *
+   * @example
+   * await post.open()
+   */
+  async open() {
+    return this.edit({ closed: false });
+  }
+  /**
+   * Pin this forum post in the channel.
+   *
+   * @example
+   * await post.pin()
+   */
+  async pin() {
+    return this.edit({ pinned: true });
+  }
+  /**
+   * Unpin this forum post.
+   *
+   * @example
+   * await post.unpin()
+   */
+  async unpin() {
+    return this.edit({ pinned: false });
+  }
+  /**
+   * Delete this forum post.
+   *
+   * @example
+   * await post.delete()
+   */
+  async delete() {
+    await this.forum.delete(this.id);
+  }
+  /** Whether this post was created by the currently connected bot. */
+  get isOwnPost() {
+    return this.authorId === this.author.id;
+  }
+  /** Returns `true` if the post has been closed. */
+  get isClosed() {
+    return this.closed;
+  }
+  /** Returns `true` if the post is pinned. */
+  get isPinned() {
+    return this.pinned;
+  }
+  toJSON() {
+    return { ...this.raw };
+  }
+};
+
+// src/structures/NovaServerEvent.ts
+var NovaServerEvent = class _NovaServerEvent {
+  constructor(raw, events) {
+    this.raw = raw;
+    this.events = events;
+    this.id = raw.id;
+    this.serverId = raw.serverId;
+    this.channelId = raw.channelId;
+    this.createdById = raw.createdById;
+    this.title = raw.title;
+    this.description = raw.description;
+    this.imageUrl = raw.imageUrl;
+    this.location = raw.location;
+    this.startAt = raw.startAt;
+    this.endAt = raw.endAt;
+    this.attendeeCount = raw.attendeeCount;
+    this.createdAt = raw.createdAt;
+  }
+  /**
+   * Edit this event.
+   *
+   * @example
+   * await event.edit({ title: 'New Title' })
+   */
+  async edit(options) {
+    const updated = await this.events.edit(this.id, options);
+    return new _NovaServerEvent(updated, this.events);
+  }
+  /**
+   * Fetch full event details including the attendee list.
+   *
+   * @example
+   * const full = await event.fetchAttendees()
+   * console.log(`${full.attendees.length} attendees`)
+   */
+  async fetchAttendees() {
+    const data = await this.events.fetch(this.id);
+    return {
+      event: new _NovaServerEvent(data, this.events),
+      attendees: data.attendees
+    };
+  }
+  /**
+   * Delete this event.
+   *
+   * @example
+   * await event.delete()
+   */
+  async delete() {
+    await this.events.delete(this.id);
+  }
+  /**
+   * Whether the event has already started.
+   */
+  get hasStarted() {
+    return new Date(this.startAt) <= /* @__PURE__ */ new Date();
+  }
+  /**
+   * Whether the event has ended.
+   * Returns `false` if no `endAt` is set.
+   */
+  get hasEnded() {
+    return this.endAt ? new Date(this.endAt) <= /* @__PURE__ */ new Date() : false;
+  }
+  /**
+   * Whether this is an upcoming event that has not yet started.
+   */
+  get isUpcoming() {
+    return new Date(this.startAt) > /* @__PURE__ */ new Date();
+  }
+  toJSON() {
+    return { ...this.raw };
+  }
+};
+
+// src/structures/NovaBan.ts
+var NovaBan = class {
+  constructor(raw, serverId, members) {
+    this.userId = raw.userId;
+    this.username = raw.username;
+    this.displayName = raw.displayName;
+    this.avatar = raw.avatar;
+    this.reason = raw.reason;
+    this.bannedAt = raw.bannedAt;
+    this.moderatorId = raw.moderatorId;
+    this.serverId = serverId;
+    this._members = members;
+  }
+  /**
+   * Revoke this ban, allowing the user to rejoin the server.
+   * Requires the `members.ban` scope.
+   *
+   * @example
+   * await ban.unban()
+   */
+  unban() {
+    return this._members.unban(this.serverId, this.userId);
+  }
+  /**
+   * When the ban was issued as a `Date` object.
+   */
+  get bannedAtDate() {
+    return new Date(this.bannedAt);
+  }
+  /**
+   * Human-readable label: `"displayName (username)"`.
+   */
+  get label() {
+    return `${this.displayName} (${this.username})`;
+  }
+  toJSON() {
+    return {
+      userId: this.userId,
+      username: this.username,
+      displayName: this.displayName,
+      avatar: this.avatar,
+      reason: this.reason,
+      bannedAt: this.bannedAt,
+      moderatorId: this.moderatorId
+    };
+  }
+};
+
+// src/structures/NovaWarning.ts
+var NovaWarning = class {
+  constructor(raw, members) {
+    this.id = raw.id;
+    this.serverId = raw.serverId;
+    this.userId = raw.userId;
+    this.moderatorId = raw.moderatorId;
+    this.reason = raw.reason;
+    this.createdAt = raw.createdAt;
+    this._members = members;
+  }
+  /**
+   * Delete (expunge) this warning from the record.
+   * Requires the `members.moderate` scope.
+   *
+   * @example
+   * await warning.delete()
+   */
+  delete() {
+    return this._members.removeWarning(this.id);
+  }
+  /**
+   * When the warning was issued as a `Date` object.
+   */
+  get issuedAt() {
+    return new Date(this.createdAt);
+  }
+  /**
+   * How long ago the warning was issued, in milliseconds.
+   */
+  get ageMs() {
+    return Date.now() - this.issuedAt.getTime();
+  }
+  toJSON() {
+    return {
+      id: this.id,
+      serverId: this.serverId,
+      userId: this.userId,
+      moderatorId: this.moderatorId,
+      reason: this.reason,
+      createdAt: this.createdAt
+    };
+  }
+};
+
 // src/client.ts
 var NovaClient = class extends EventEmitter {
   constructor(options) {
@@ -1953,6 +2877,11 @@ var NovaClient = class extends EventEmitter {
     this.invites = new InvitesAPI(this.http);
     this.webhooks = new WebhooksAPI(this.http);
     this.auditLog = new AuditLogAPI(this.http);
+    this.forum = new ForumAPI(this.http);
+    this.events = new EventsAPI(this.http);
+    this.categories = new CategoriesAPI(this.http);
+    this.automod = new AutoModAPI(this.http);
+    this.users = new UsersAPI(this.http);
     this.on("error", () => {
     });
     const cleanup = () => this.disconnect();
@@ -2164,16 +3093,53 @@ var NovaClient = class extends EventEmitter {
           case "server.updated":
             this.emit("serverUpdate", event.data);
             break;
-        }
-      });
-      this.socket.on("bot:error", (err) => {
-        this.emit("error", err);
-      });
-      this.socket.on("disconnect", (reason) => {
-        this.emit("disconnect", reason);
-      });
-    });
-  }
+          case "invite.created":
+            this.emit("inviteCreate", event.data);
+            break;
+          case "invite.deleted":
+            this.emit("inviteDelete", event.data);
+            break;
+          case "forum.post.created": {
+            const rawPost = event.data;
+            this.emit("forumPostCreate", new NovaForumPost(rawPost, this.forum));
+            break;
+          }
+          case "event.created": {
+            const rawEvent = event.data;
+            this.emit("eventCreate", new NovaServerEvent(rawEvent, this.events));
+            break;
+          }
+          case "event.updated":
+            this.emit("eventUpdate", event.data);
+            break;
+          case "event.deleted":
+            this.emit("eventDelete", event.data);
+            break;
+          case "category.created":
+            this.emit("categoryCreate", event.data);
+            break;
+          case "category.updated":
+            this.emit("categoryUpdate", event.data);
+            break;
+          case "category.deleted":
+            this.emit("categoryDelete", event.data);
+            break;
+          case "member.warned":
+            this.emit("memberWarned", event.data);
+            break;
+          case "messages.bulk_deleted":
+            this.emit("messagesBulkDelete", event.data);
+            break;
+        }
+      });
+      this.socket.on("bot:error", (err) => {
+        this.emit("error", err);
+      });
+      this.socket.on("disconnect", (reason) => {
+        this.emit("disconnect", reason);
+      });
+    });
+  }
   /**
    * Register a recurring task that fires at a set interval.
    * All cron tasks are automatically cancelled on `disconnect()`.
@@ -2230,7 +3196,7 @@ var NovaClient = class extends EventEmitter {
    */
   async fetchChannel(channelId) {
     const raw = await this.channels.fetch(channelId);
-    return new NovaChannel(raw, this.channels, this.messages);
+    return new NovaChannel(raw, this.channels, this.messages, this.webhooks, this.forum);
   }
   /**
    * Fetch all channels in a server and return them as `NovaChannel` wrappers.
@@ -2241,7 +3207,7 @@ var NovaClient = class extends EventEmitter {
    */
   async fetchChannels(serverId) {
     const list = await this.channels.list(serverId);
-    return list.map((raw) => new NovaChannel(raw, this.channels, this.messages));
+    return list.map((raw) => new NovaChannel(raw, this.channels, this.messages, this.webhooks, this.forum));
   }
   /**
    * Fetch all members in a server and return them as `NovaMember` wrappers.
@@ -2266,6 +3232,36 @@ var NovaClient = class extends EventEmitter {
     const raw = await this.members.fetch(serverId, userId);
     return new NovaMember(raw, serverId, this.members);
   }
+  /**
+   * Fetch all bans in a server and return them as `NovaBan` wrappers.
+   * Each `NovaBan` has an `.unban()` convenience method.
+   * Requires the `members.ban` scope.
+   *
+   * @example
+   * const bans = await client.fetchBans('server-id')
+   * for (const ban of bans) {
+   *   if (ban.reason === 'test') await ban.unban()
+   * }
+   */
+  async fetchBans(serverId) {
+    const list = await this.members.listBans(serverId);
+    return list.map((raw) => new NovaBan(raw, serverId, this.members));
+  }
+  /**
+   * Fetch warnings for a member (or all members) in a server and return them
+   * as `NovaWarning` wrappers. Each wrapper has a `.delete()` convenience method.
+   * Requires the `members.moderate` scope.
+   *
+   * @example
+   * const warnings = await client.fetchMemberWarnings('server-id', 'user-id')
+   * for (const w of warnings) {
+   *   if (w.ageMs > 30 * 24 * 60 * 60_000) await w.delete() // older than 30 days
+   * }
+   */
+  async fetchMemberWarnings(serverId, userId) {
+    const list = await this.members.fetchWarnings(serverId, userId ? { userId } : {});
+    return list.map((raw) => new NovaWarning(raw, this.members));
+  }
   /**
    * Fetch a single server by ID and return it as a `NovaServerWrapper`.
    *
@@ -2275,7 +3271,7 @@ var NovaClient = class extends EventEmitter {
    */
   async fetchServer(serverId) {
     const raw = await this.servers.fetch(serverId);
-    return new NovaServerWrapper(raw, this.servers, this.channels, this.members, this.invites, this.roles, this.messages);
+    return new NovaServerWrapper(raw, this.servers, this.channels, this.members, this.invites, this.roles, this.messages, this.categories, this.events, this.automod, this.auditLog);
   }
   /**
    * Fetch all servers the bot is in and return them as `NovaServerWrapper` objects.
@@ -2286,7 +3282,7 @@ var NovaClient = class extends EventEmitter {
    */
   async fetchServers() {
     const list = await this.servers.list();
-    return list.map((raw) => new NovaServerWrapper(raw, this.servers, this.channels, this.members, this.invites, this.roles, this.messages));
+    return list.map((raw) => new NovaServerWrapper(raw, this.servers, this.channels, this.members, this.invites, this.roles, this.messages, this.categories, this.events, this.automod, this.auditLog));
   }
   /**
    * Fetch all custom roles in a server and return them as `NovaRole` wrappers.
@@ -2342,6 +3338,116 @@ var NovaClient = class extends EventEmitter {
     const raw = await this.webhooks.fetch(webhookId);
     return new NovaWebhook(raw, this.webhooks);
   }
+  /**
+   * Fetch forum posts from a FORUM channel and return them as `NovaForumPost` wrappers.
+   *
+   * @example
+   * const posts = await client.fetchForumPosts('channel-id', { limit: 20 })
+   * const open = posts.filter(p => !p.isClosed)
+   */
+  async fetchForumPosts(channelId, options) {
+    const list = await this.forum.list(channelId, options);
+    return list.map((raw) => new NovaForumPost(raw, this.forum));
+  }
+  /**
+   * Fetch server events and return them as `NovaServerEvent` wrappers.
+   *
+   * @example
+   * const upcoming = await client.fetchEvents('server-id', { upcoming: true })
+   * for (const event of upcoming) console.log(event.title)
+   */
+  async fetchEvents(serverId, options) {
+    const list = await this.events.list(serverId, options);
+    return list.map((raw) => new NovaServerEvent(raw, this.events));
+  }
+  /**
+   * Fetch a single server event by ID and return it as a `NovaServerEvent` wrapper.
+   *
+   * @example
+   * const event = await client.fetchEvent('event-id')
+   * if (event.isUpcoming) await event.edit({ title: 'Updated!' })
+   */
+  async fetchEvent(eventId) {
+    const raw = await this.events.fetch(eventId);
+    return new NovaServerEvent(raw, this.events);
+  }
+  /**
+   * Fetch a user's public profile.
+   *
+   * @example
+   * const user = await client.fetchUserProfile('user-id')
+   * console.log(user.bio)
+   */
+  fetchUserProfile(userId) {
+    return this.users.fetch(userId);
+  }
+  /**
+   * Fetch the XP leaderboard for a server.
+   *
+   * @example
+   * const top = await client.fetchLeaderboard('server-id', 10)
+   * top.forEach(entry => console.log(`#${entry.rank} ${entry.user.username} — ${entry.xp} XP`))
+   */
+  fetchLeaderboard(serverId, limit = 10) {
+    return this.members.leaderboard(serverId, limit);
+  }
+  /**
+   * Fetch warnings in a server, optionally filtered by user.
+   *
+   * @example
+   * const warnings = await client.fetchWarnings('server-id', { userId: 'user-id' })
+   */
+  fetchWarnings(serverId, options) {
+    return this.members.fetchWarnings(serverId, options);
+  }
+  /**
+   * Fetch all automod rules for a server.
+   *
+   * @example
+   * const rules = await client.fetchAutoModRules('server-id')
+   */
+  fetchAutoModRules(serverId) {
+    return this.automod.list(serverId);
+  }
+  /**
+   * Fetch all channel categories for a server.
+   *
+   * @example
+   * const cats = await client.fetchCategories('server-id')
+   */
+  fetchCategories(serverId) {
+    return this.categories.list(serverId);
+  }
+  /**
+   * Fetch soundboard clips for a server.
+   *
+   * @example
+   * const clips = await client.fetchSoundboard('server-id')
+   */
+  fetchSoundboard(serverId) {
+    return this.servers.listSoundboard(serverId);
+  }
+  /**
+   * Fetch statistics for a server (member count, message count, etc.).
+   *
+   * @example
+   * const stats = await client.fetchServerStats('server-id')
+   * console.log(`${stats.onlineCount}/${stats.memberCount} online`)
+   */
+  fetchServerStats(serverId) {
+    return this.servers.getStats(serverId);
+  }
+  /**
+   * Bulk delete up to 100 messages in a channel.
+   * Requires the `messages.manage` scope.
+   *
+   * @example
+   * const result = await client.bulkDelete('channel-id', messageIds)
+   * console.log(`Deleted ${result.deleted} messages`)
+   */
+  bulkDelete(channelId, messageIds) {
+    return this.channels.bulkDelete(channelId, messageIds);
+  }
   // ─── Event fence ──────────────────────────────────────────────────────────────
   /**
    * Wait for a specific event to be emitted, optionally filtered.
@@ -2371,6 +3477,58 @@ var NovaClient = class extends EventEmitter {
       this.on(event, handler);
     });
   }
+  /**
+   * Wait for the next message matching an optional filter.
+   * Short for `waitFor('messageCreate', filter, timeoutMs)`.
+   *
+   * @example
+   * // Wait for any message in a specific channel
+   * const msg = await client.waitForMessage(
+   *   m => m.channelId === channelId && !m.isFromBot(),
+   *   30_000,
+   * )
+   * console.log(msg.content)
+   */
+  waitForMessage(filter, timeoutMs = 3e4) {
+    return this.waitFor("messageCreate", filter, timeoutMs);
+  }
+  /**
+   * Wait for the next button-click interaction matching an optional filter.
+   * Short for `waitFor('interactionCreate', i => i.isButton() && filter(i), timeoutMs)`.
+   *
+   * @example
+   * // Wait for any button on a specific message
+   * const click = await client.waitForButton(
+   *   i => i.triggerMsgId === message.id,
+   *   60_000,
+   * )
+   * await click.reply('Button clicked!')
+   */
+  waitForButton(filter, timeoutMs = 3e4) {
+    return this.waitFor(
+      "interactionCreate",
+      (i) => i.isButton() && (!filter || filter(i)),
+      timeoutMs
+    );
+  }
+  /**
+   * Wait for the next select-menu interaction matching an optional filter.
+   * Short for `waitFor('interactionCreate', i => i.isSelectMenu() && filter(i), timeoutMs)`.
+   *
+   * @example
+   * const pick = await client.waitForSelectMenu(
+   *   i => i.customId === 'colour_pick',
+   *   60_000,
+   * )
+   * await pick.reply(`You picked: ${pick.values.join(', ')}`)
+   */
+  waitForSelectMenu(filter, timeoutMs = 3e4) {
+    return this.waitFor(
+      "interactionCreate",
+      (i) => i.isSelectMenu() && (!filter || filter(i)),
+      timeoutMs
+    );
+  }
   /**
    * Disconnect from the gateway and clean up.
    */
@@ -3738,46 +4896,1375 @@ function countdown(target) {
     seconds: Math.floor(total % MINUTE / SECOND)
   };
 }
+
+// src/structures/NovaCategory.ts
+var NovaCategory = class _NovaCategory {
+  constructor(raw, categories) {
+    this.id = raw.id;
+    this.name = raw.name;
+    this.position = raw.position;
+    this.serverId = raw.serverId;
+    this.createdAt = raw.createdAt;
+    this._categories = categories;
+  }
+  // ─── Convenience methods ──────────────────────────────────────────────────
+  /**
+   * Edit this category's name and/or position.
+   * Requires the `channels.manage` scope.
+   *
+   * @example
+   * await cat.edit({ name: 'Lounges', position: 0 })
+   */
+  async edit(options) {
+    const updated = await this._categories.edit(this.id, options);
+    return new _NovaCategory(updated, this._categories);
+  }
+  /**
+   * Rename this category.
+   * Requires the `channels.manage` scope.
+   *
+   * @example
+   * await cat.rename('Lounges')
+   */
+  rename(name) {
+    return this.edit({ name });
+  }
+  /**
+   * Move this category to a specific position.
+   * Requires the `channels.manage` scope.
+   *
+   * @example
+   * await cat.setPosition(0)
+   */
+  setPosition(position) {
+    return this.edit({ position });
+  }
+  /**
+   * Delete this category.
+   * Requires the `channels.manage` scope.
+   *
+   * @example
+   * await cat.delete()
+   */
+  async delete() {
+    await this._categories.delete(this.id);
+  }
+  // ─── Serialisation ─────────────────────────────────────────────────────────
+  toJSON() {
+    return {
+      id: this.id,
+      name: this.name,
+      position: this.position,
+      serverId: this.serverId,
+      createdAt: this.createdAt
+    };
+  }
+  toString() {
+    return `NovaCategory(${this.id}): ${this.name}`;
+  }
+};
+
+// src/builders/ForumPostBuilder.ts
+var ForumPostBuilder = class {
+  constructor() {
+    this._title = "";
+    this._body = "";
+    this._tags = [];
+  }
+  /**
+   * Set the post title.
+   */
+  setTitle(title) {
+    this._title = title;
+    return this;
+  }
+  /**
+   * Set the post body / content.
+   */
+  setBody(body) {
+    this._body = body;
+    return this;
+  }
+  /**
+   * Add a tag to the post.
+   * Tags are used to categorise forum posts.
+   */
+  addTag(tag) {
+    this._tags.push(tag);
+    return this;
+  }
+  /**
+   * Set all tags at once, replacing any previously added tags.
+   */
+  setTags(tags) {
+    this._tags = [...tags];
+    return this;
+  }
+  /**
+   * Validate and return the final `CreateForumPostOptions` object.
+   *
+   * @throws {Error} if title or body is missing.
+   */
+  build() {
+    if (!this._title.trim()) throw new Error("[ForumPostBuilder] title is required");
+    if (!this._body.trim()) throw new Error("[ForumPostBuilder] body is required");
+    return {
+      title: this._title.trim(),
+      body: this._body.trim(),
+      tags: this._tags
+    };
+  }
+};
+
+// src/builders/EventBuilder.ts
+var EventBuilder = class {
+  constructor() {
+    this._title = "";
+  }
+  /** Set the event title (required). */
+  setTitle(title) {
+    this._title = title;
+    return this;
+  }
+  /** Set the event description. */
+  setDescription(description) {
+    this._description = description;
+    return this;
+  }
+  /** Set a banner/cover image URL for the event. */
+  setImage(url) {
+    this._imageUrl = url;
+    return this;
+  }
+  /** Set the physical or virtual location for the event. */
+  setLocation(location) {
+    this._location = location;
+    return this;
+  }
+  /** Set when the event starts. Accepts a Date or ISO string. */
+  setStartAt(date) {
+    this._startAt = date instanceof Date ? date.toISOString() : date;
+    return this;
+  }
+  /** Set when the event ends. Accepts a Date or ISO string. */
+  setEndAt(date) {
+    this._endAt = date instanceof Date ? date.toISOString() : date;
+    return this;
+  }
+  /** Link the event to a specific channel. */
+  setChannel(channelId) {
+    this._channelId = channelId;
+    return this;
+  }
+  /**
+   * Validate and return the final `CreateEventOptions` object.
+   *
+   * @throws {Error} if title or startAt is missing.
+   */
+  build() {
+    if (!this._title.trim()) throw new Error("[EventBuilder] title is required");
+    if (!this._startAt) throw new Error("[EventBuilder] startAt is required \u2014 call setStartAt()");
+    return {
+      title: this._title.trim(),
+      ...this._description !== void 0 ? { description: this._description } : {},
+      ...this._imageUrl !== void 0 ? { imageUrl: this._imageUrl } : {},
+      ...this._location !== void 0 ? { location: this._location } : {},
+      startAt: this._startAt,
+      ...this._endAt !== void 0 ? { endAt: this._endAt } : {},
+      ...this._channelId !== void 0 ? { channelId: this._channelId } : {}
+    };
+  }
+};
+
+// src/builders/RoleBuilder.ts
+var RoleBuilder = class {
+  constructor() {
+    this._name = "";
+  }
+  /** Set the role's display name (required). */
+  setName(name) {
+    this._name = name;
+    return this;
+  }
+  /**
+   * Set the role's accent colour.
+   * @param color Hex string — e.g. `'#5865F2'` or `'5865F2'`
+   */
+  setColor(color) {
+    this._color = color.startsWith("#") ? color : `#${color}`;
+    return this;
+  }
+  /**
+   * Whether this role is shown separately in the member sidebar.
+   * Default: `true` when called without arguments.
+   */
+  setHoist(hoist = true) {
+    this._hoist = hoist;
+    return this;
+  }
+  /** Set a specific permission key to true or false. */
+  addPermission(key, value = true) {
+    if (!this._permissions) this._permissions = {};
+    this._permissions[key] = value;
+    return this;
+  }
+  /** Replace all permission overrides at once. */
+  setPermissions(permissions) {
+    this._permissions = { ...permissions };
+    return this;
+  }
+  // ─── Common permission shorthands ─────────────────────────────────────────
+  /** Grant the `sendMessages` permission. */
+  allowSendMessages() {
+    return this.addPermission("sendMessages");
+  }
+  /** Deny the `sendMessages` permission. */
+  denySendMessages() {
+    return this.addPermission("sendMessages", false);
+  }
+  /** Grant the `addReactions` permission. */
+  allowAddReactions() {
+    return this.addPermission("addReactions");
+  }
+  /** Grant the `manageMessages` permission (delete/pin messages). */
+  allowManageMessages() {
+    return this.addPermission("manageMessages");
+  }
+  /** Grant the `manageChannels` permission. */
+  allowManageChannels() {
+    return this.addPermission("manageChannels");
+  }
+  /** Grant the `kickMembers` permission. */
+  allowKickMembers() {
+    return this.addPermission("kickMembers");
+  }
+  /** Grant the `banMembers` permission. */
+  allowBanMembers() {
+    return this.addPermission("banMembers");
+  }
+  /** Grant the `manageServer` permission. */
+  allowManageServer() {
+    return this.addPermission("manageServer");
+  }
+  /** Grant the `manageRoles` permission. */
+  allowManageRoles() {
+    return this.addPermission("manageRoles");
+  }
+  /**
+   * Validate and build the `RoleCreateOptions` object.
+   *
+   * @throws if name is not set.
+   */
+  build() {
+    if (!this._name.trim()) throw new Error("[RoleBuilder] name is required \u2014 call .setName()");
+    return {
+      name: this._name.trim(),
+      ...this._color !== void 0 ? { color: this._color } : {},
+      ...this._hoist !== void 0 ? { hoist: this._hoist } : {},
+      ...this._permissions !== void 0 ? { permissions: this._permissions } : {}
+    };
+  }
+};
+
+// src/builders/ChannelBuilder.ts
+var ChannelBuilder = class {
+  constructor() {
+    this._name = "";
+    this._type = "TEXT";
+  }
+  /** Set the channel name (required). No # prefix needed. */
+  setName(name) {
+    this._name = name;
+    return this;
+  }
+  /**
+   * Set the channel type.
+   * @default 'TEXT'
+   */
+  setType(type) {
+    this._type = type;
+    return this;
+  }
+  // ─── Type shorthands ──────────────────────────────────────────────────────
+  /** Create a TEXT channel. */
+  asText() {
+    return this.setType("TEXT");
+  }
+  /** Create a VOICE channel. */
+  asVoice() {
+    return this.setType("VOICE");
+  }
+  /** Create an ANNOUNCEMENT channel. */
+  asAnnouncement() {
+    return this.setType("ANNOUNCEMENT");
+  }
+  /** Create a FORUM channel. */
+  asForum() {
+    return this.setType("FORUM");
+  }
+  /** Create a STAGE channel. */
+  asStage() {
+    return this.setType("STAGE");
+  }
+  // ─── Properties ───────────────────────────────────────────────────────────
+  /** Set the channel topic / description. */
+  setTopic(topic) {
+    this._topic = topic;
+    return this;
+  }
+  /** Set the channel's sort position. */
+  setPosition(position) {
+    this._position = position;
+    return this;
+  }
+  /** Place the channel inside an existing category by its ID. */
+  setCategory(categoryId) {
+    this._categoryId = categoryId;
+    return this;
+  }
+  /**
+   * Set a slow-mode interval in seconds.
+   * Members must wait this long between messages.
+   * Pass `0` to disable.
+   */
+  setSlowMode(seconds) {
+    this._slowMode = seconds;
+    return this;
+  }
+  /**
+   * Mark the channel as private.
+   * Private channels are only visible to members with explicit access.
+   */
+  setPrivate(isPrivate = true) {
+    this._isPrivate = isPrivate;
+    return this;
+  }
+  /**
+   * Validate and build the `CreateChannelOptions` object.
+   *
+   * @throws if name is not set.
+   */
+  build() {
+    if (!this._name.trim()) throw new Error("[ChannelBuilder] name is required \u2014 call .setName()");
+    return {
+      name: this._name.trim(),
+      type: this._type,
+      ...this._topic !== void 0 ? { topic: this._topic } : {},
+      ...this._position !== void 0 ? { position: this._position } : {},
+      ...this._categoryId !== void 0 ? { categoryId: this._categoryId } : {},
+      ...this._slowMode !== void 0 ? { slowMode: this._slowMode } : {},
+      ...this._isPrivate !== void 0 ? { isPrivate: this._isPrivate } : {}
+    };
+  }
+};
+
+// src/builders/InviteBuilder.ts
+var InviteBuilder = class {
+  /**
+   * Set the maximum number of times this invite can be used.
+   * Pass `null` for unlimited uses.
+   */
+  setMaxUses(maxUses) {
+    this._maxUses = maxUses;
+    return this;
+  }
+  /**
+   * Set an absolute expiry date/time for this invite.
+   * Pass a `Date`, an ISO string, or `null` to never expire.
+   */
+  setExpiresAt(date) {
+    if (date === null) {
+      this._expiresAt = null;
+    } else {
+      this._expiresAt = date instanceof Date ? date.toISOString() : date;
+    }
+    return this;
+  }
+  /**
+   * Set expiry as a duration from now.
+   * @param ms  Duration in milliseconds.
+   *
+   * @example
+   * builder.expiresIn(7 * 24 * 60 * 60 * 1000) // 7 days
+   */
+  expiresIn(ms) {
+    this._expiresAt = new Date(Date.now() + ms).toISOString();
+    return this;
+  }
+  /**
+   * Create a one-time use invite (`maxUses = 1`).
+   */
+  setOneTimeUse() {
+    return this.setMaxUses(1);
+  }
+  /**
+   * Create a permanent invite with no expiry or usage limit.
+   */
+  setPermanent() {
+    this._maxUses = null;
+    this._expiresAt = null;
+    return this;
+  }
+  /**
+   * Build the `InviteCreateOptions` object.
+   */
+  build() {
+    return {
+      ...this._maxUses !== void 0 ? { maxUses: this._maxUses } : {},
+      ...this._expiresAt !== void 0 ? { expiresAt: this._expiresAt } : {}
+    };
+  }
+};
+
+// src/builders/AutoModRuleBuilder.ts
+var AutoModRuleBuilder = class {
+  constructor() {
+    this._value = "";
+    this._enabled = true;
+  }
+  /** Set the rule type explicitly. */
+  setType(type) {
+    this._type = type;
+    return this;
+  }
+  /**
+   * Set the blocked value (word or domain).
+   */
+  setValue(value) {
+    this._value = value;
+    return this;
+  }
+  /**
+   * Shorthand: set type to BLOCKED_WORD and optionally set the value.
+   *
+   * @example
+   * builder.blockWord('badword')
+   */
+  blockWord(word) {
+    this._type = "BLOCKED_WORD";
+    if (word !== void 0) this._value = word;
+    return this;
+  }
+  /**
+   * Shorthand: set type to BLOCKED_LINK and optionally set the domain.
+   *
+   * @example
+   * builder.blockLink('spam.com')
+   */
+  blockLink(domain) {
+    this._type = "BLOCKED_LINK";
+    if (domain !== void 0) this._value = domain;
+    return this;
+  }
+  /**
+   * Whether the rule is active immediately.
+   * @default true
+   */
+  setEnabled(enabled) {
+    this._enabled = enabled;
+    return this;
+  }
+  /**
+   * Validate and build the `CreateAutoModRuleOptions` object.
+   *
+   * @throws if type or value is not set.
+   */
+  build() {
+    if (!this._type) {
+      throw new Error("[AutoModRuleBuilder] type is required \u2014 call .setType(), .blockWord(), or .blockLink()");
+    }
+    if (!this._value.trim()) {
+      throw new Error("[AutoModRuleBuilder] value is required \u2014 call .setValue(), .blockWord(word), or .blockLink(domain)");
+    }
+    return {
+      type: this._type,
+      value: this._value.trim(),
+      enabled: this._enabled
+    };
+  }
+};
+
+// src/builders/ContextMenuCommandBuilder.ts
+var ContextMenuCommandBuilder = class {
+  constructor() {
+    this._name = "";
+    this._target = "MESSAGE";
+    this._guildId = null;
+  }
+  /**
+   * Display name of the command (shown in the context menu).
+   * Max 32 characters. May contain spaces.
+   *
+   * @example
+   * builder.setName('Report Message')
+   */
+  setName(name) {
+    this._name = name.trim();
+    return this;
+  }
+  /**
+   * Set whether the command targets messages or users.
+   *
+   * @example
+   * builder.setTarget('USER')
+   */
+  setTarget(target) {
+    this._target = target;
+    return this;
+  }
+  /**
+   * Shorthand for `setTarget('MESSAGE')`.
+   *
+   * @example
+   * builder.forMessages()
+   */
+  forMessages() {
+    return this.setTarget("MESSAGE");
+  }
+  /**
+   * Shorthand for `setTarget('USER')`.
+   *
+   * @example
+   * builder.forUsers()
+   */
+  forUsers() {
+    return this.setTarget("USER");
+  }
+  /**
+   * Register this command only for a specific server (guild).
+   * Omit (or pass `null`) to make the command available globally.
+   *
+   * @example
+   * builder.setGuildId('server-id')
+   */
+  setGuildId(guildId) {
+    this._guildId = guildId;
+    return this;
+  }
+  /**
+   * Validate and return the final command definition object.
+   * Throws if `name` has not been set.
+   */
+  build() {
+    if (!this._name) {
+      throw new Error("[ContextMenuCommandBuilder] Command name is required");
+    }
+    return {
+      name: this._name,
+      target: this._target,
+      guildId: this._guildId
+    };
+  }
+  /** Alias for `build()`. */
+  toJSON() {
+    return this.build();
+  }
+};
+
+// src/utils/MessageCollector.ts
+var MessageCollector = class {
+  constructor(emitter, options = {}) {
+    this._emitter = emitter;
+    this._options = {
+      count: options.count ?? 1,
+      timeout: options.timeout ?? 6e4,
+      filter: options.filter ?? (() => true)
+    };
+  }
+  /**
+   * Start collecting messages.
+   * Returns a promise that resolves with the collected `NovaMessage` array.
+   */
+  run() {
+    return new Promise((resolve) => {
+      const collected = [];
+      const cleanup = () => {
+        clearTimeout(timer);
+        this._emitter.off("messageCreate", handler);
+      };
+      const handler = (msg) => {
+        if (!this._options.filter(msg)) return;
+        collected.push(msg);
+        if (collected.length >= this._options.count) {
+          cleanup();
+          resolve([...collected]);
+        }
+      };
+      const timer = setTimeout(() => {
+        this._emitter.off("messageCreate", handler);
+        resolve([...collected]);
+      }, this._options.timeout);
+      this._emitter.on("messageCreate", handler);
+    });
+  }
+};
+
+// src/utils/InteractionCollector.ts
+var InteractionCollector = class {
+  constructor(emitter, options = {}) {
+    this._emitter = emitter;
+    this._options = {
+      count: options.count ?? 1,
+      timeout: options.timeout ?? 6e4,
+      filter: options.filter ?? (() => true),
+      messageId: options.messageId
+    };
+  }
+  /**
+   * Start collecting interactions.
+   * Returns a promise that resolves with the collected `NovaInteraction` array.
+   */
+  run() {
+    return new Promise((resolve) => {
+      const collected = [];
+      const cleanup = () => {
+        clearTimeout(timer);
+        this._emitter.off("interactionCreate", handler);
+      };
+      const handler = (interaction) => {
+        if (this._options.messageId && interaction.triggerMsgId !== this._options.messageId) return;
+        if (!this._options.filter(interaction)) return;
+        collected.push(interaction);
+        if (collected.length >= this._options.count) {
+          cleanup();
+          resolve([...collected]);
+        }
+      };
+      const timer = setTimeout(() => {
+        this._emitter.off("interactionCreate", handler);
+        resolve([...collected]);
+      }, this._options.timeout);
+      this._emitter.on("interactionCreate", handler);
+    });
+  }
+};
+
+// src/utils/MentionParser.ts
+var MentionParser = class {
+  // ─── Extraction ────────────────────────────────────────────────────────────
+  /**
+   * Extract all user IDs mentioned in the content (`<@userId>`).
+   *
+   * @example
+   * MentionParser.userIds('Hello <@abc> and <@xyz>!') // ['abc', 'xyz']
+   */
+  static userIds(content) {
+    return [...content.matchAll(/<@([a-zA-Z0-9_-]+)>/g)].map((m) => m[1]);
+  }
+  /**
+   * Extract all channel IDs mentioned in the content (`<#channelId>`).
+   *
+   * @example
+   * MentionParser.channelIds('Go to <#general>!') // ['general']
+   */
+  static channelIds(content) {
+    return [...content.matchAll(/<#([a-zA-Z0-9_-]+)>/g)].map((m) => m[1]);
+  }
+  /**
+   * Extract all role IDs mentioned in the content (`<&roleId>`).
+   *
+   * @example
+   * MentionParser.roleIds('Paging <&mods>!') // ['mods']
+   */
+  static roleIds(content) {
+    return [...content.matchAll(/<&([a-zA-Z0-9_-]+)>/g)].map((m) => m[1]);
+  }
+  /**
+   * Extract all custom emoji IDs mentioned in the content (`<:name:id>`).
+   *
+   * @example
+   * MentionParser.emojiIds('Love it <:nova:12345>!')
+   * // [{ name: 'nova', id: '12345' }]
+   */
+  static emojiIds(content) {
+    return [...content.matchAll(/<:([a-zA-Z0-9_]+):([a-zA-Z0-9_-]+)>/g)].map((m) => ({
+      name: m[1],
+      id: m[2]
+    }));
+  }
+  // ─── Format ─────────────────────────────────────────────────────────────────
+  /**
+   * Format a user ID into a mention string `<@userId>`.
+   *
+   * @example
+   * MentionParser.user('abc123') // '<@abc123>'
+   */
+  static user(userId) {
+    return `<@${userId}>`;
+  }
+  /**
+   * Format a channel ID into a mention string `<#channelId>`.
+   *
+   * @example
+   * MentionParser.channel('general') // '<#general>'
+   */
+  static channel(channelId) {
+    return `<#${channelId}>`;
+  }
+  /**
+   * Format a role ID into a mention string `<&roleId>`.
+   *
+   * @example
+   * MentionParser.role('mods') // '<&mods>'
+   */
+  static role(roleId) {
+    return `<&${roleId}>`;
+  }
+  /**
+   * Format a custom emoji mention `<:name:id>`.
+   *
+   * @example
+   * MentionParser.emoji('nova', '12345') // '<:nova:12345>'
+   */
+  static emoji(name, id) {
+    return `<:${name}:${id}>`;
+  }
+  // ─── Clean ──────────────────────────────────────────────────────────────────
+  /**
+   * Remove all mention tokens from `content` and return the cleaned string.
+   *
+   * @example
+   * MentionParser.stripMentions('Hello <@u1> in <#c1>!')
+   * // 'Hello  in !'
+   */
+  static stripMentions(content) {
+    return content.replace(/<@[a-zA-Z0-9_-]+>/g, "").replace(/<#[a-zA-Z0-9_-]+>/g, "").replace(/<&[a-zA-Z0-9_-]+>/g, "").replace(/<:[a-zA-Z0-9_]+:[a-zA-Z0-9_-]+>/g, "");
+  }
+  /**
+   * Returns `true` if `content` mentions at least one user.
+   * Optionally checks for a specific `userId`.
+   *
+   * @example
+   * MentionParser.hasMention('Hi <@u1>')           // true
+   * MentionParser.hasMention('Hi <@u1>', 'u1')     // true
+   * MentionParser.hasMention('Hi <@u1>', 'u2')     // false
+   */
+  static hasMention(content, userId) {
+    if (userId) return content.includes(`<@${userId}>`);
+    return /<@[a-zA-Z0-9_-]+>/.test(content);
+  }
+  /**
+   * Returns `true` if `content` mentions a specific bot by its ID.
+   *
+   * @example
+   * if (MentionParser.mentionsBotId(message.content, client.user.id)) {
+   *   await message.reply('You called?')
+   * }
+   */
+  static mentionsBotId(content, botId) {
+    return content.includes(`<@${botId}>`);
+  }
+};
+
+// src/utils/EmbedPaginator.ts
+var EmbedPaginator = class {
+  constructor(emitter, messages, interactions, options) {
+    this.emitter = emitter;
+    this.messages = messages;
+    this.interactions = interactions;
+    this.options = options;
+    this.page = 0;
+    const size = Math.max(1, options.pageSize ?? 10);
+    const pages = [];
+    for (let i = 0; i < options.items.length; i += size) {
+      pages.push(options.items.slice(i, i + size));
+    }
+    this.pages = pages;
+  }
+  /** Total number of pages. */
+  get totalPages() {
+    return this.pages.length;
+  }
+  /**
+   * Send the first page to the configured channel.
+   * If there are multiple pages, attaches ◀ ▶ navigation buttons and
+   * listens for clicks for up to `options.timeout` ms.
+   */
+  async send() {
+    if (this.pages.length === 0) {
+      await this.messages.send(this.options.channelId, { content: "*Nothing to display.*" });
+      return;
+    }
+    const msg = await this.messages.send(this.options.channelId, this._buildPayload());
+    if (this.pages.length <= 1) return;
+    const timeout = this.options.timeout ?? 6e4;
+    const deadline = Date.now() + timeout;
+    while (true) {
+      const remaining = deadline - Date.now();
+      if (remaining <= 0) break;
+      const click = await this._awaitClick(msg.id, remaining);
+      if (!click) break;
+      if (click.customId === "_pg_prev" && this.page > 0) this.page--;
+      else if (click.customId === "_pg_next" && this.page < this.pages.length - 1) this.page++;
+      this.interactions.respond(click.id, { content: "\u200B", ephemeral: true }).catch(() => void 0);
+      await this.messages.edit(msg.id, this._buildPayload());
+    }
+  }
+  // ── Internal helpers ────────────────────────────────────────────────────────
+  _awaitClick(msgId, timeoutMs) {
+    return new Promise((resolve) => {
+      const timer = setTimeout(() => {
+        this.emitter.off("interactionCreate", handler);
+        resolve(null);
+      }, timeoutMs);
+      const handler = (i) => {
+        const isOurs = i.triggerMsgId === msgId && (i.customId === "_pg_prev" || i.customId === "_pg_next");
+        const isAllowed = !this.options.userId || i.userId === this.options.userId;
+        if (isOurs && isAllowed) {
+          clearTimeout(timer);
+          this.emitter.off("interactionCreate", handler);
+          resolve({ id: i.id, customId: i.customId });
+        }
+      };
+      this.emitter.on("interactionCreate", handler);
+    });
+  }
+  _buildPayload() {
+    const page = this.pages[this.page];
+    const embed = this.options.renderPage(page, this.page, this.pages.length);
+    if (this.options.showPageCounter !== false && this.pages.length > 1) {
+      const counter = `Page ${this.page + 1} / ${this.pages.length}`;
+      embed.footer = embed.footer ? `${embed.footer}  \u2022  ${counter}` : counter;
+    }
+    const row = new ActionRowBuilder().addComponent(
+      new ButtonBuilder().setCustomId("_pg_prev").setLabel("\u25C0").setStyle("secondary").setDisabled(this.page === 0)
+    ).addComponent(
+      new ButtonBuilder().setCustomId("_pg_next").setLabel("\u25B6").setStyle("secondary").setDisabled(this.page === this.pages.length - 1)
+    );
+    return { embed, components: row.toJSON() };
+  }
+};
+
+// src/utils/ConfirmationDialog.ts
+var ConfirmationDialog = class {
+  constructor(emitter, messages, interactions) {
+    this.emitter = emitter;
+    this.messages = messages;
+    this.interactions = interactions;
+  }
+  /**
+   * Send the confirmation prompt and await the user's choice.
+   * Returns `true` for confirm, `false` for cancel or timeout.
+   */
+  async ask(options) {
+    const content = options.content ?? "Are you sure?";
+    const confirmLabel = options.confirmLabel ?? "Confirm";
+    const cancelLabel = options.cancelLabel ?? "Cancel";
+    const timeout = options.timeout ?? 3e4;
+    const row = new ActionRowBuilder().addComponent(
+      new ButtonBuilder().setCustomId("_confirm_yes").setLabel(confirmLabel).setStyle("success")
+    ).addComponent(
+      new ButtonBuilder().setCustomId("_confirm_no").setLabel(cancelLabel).setStyle("danger")
+    );
+    const msg = await this.messages.send(options.channelId, {
+      content,
+      components: row.toJSON()
+    });
+    const click = await this._awaitClick(msg.id, options.userId, timeout);
+    const disabledRow = new ActionRowBuilder().addComponent(
+      new ButtonBuilder().setCustomId("_confirm_yes").setLabel(confirmLabel).setStyle("success").setDisabled(true)
+    ).addComponent(
+      new ButtonBuilder().setCustomId("_confirm_no").setLabel(cancelLabel).setStyle("danger").setDisabled(true)
+    );
+    await this.messages.edit(msg.id, { content, components: disabledRow.toJSON() }).catch(() => void 0);
+    if (click) {
+      this.interactions.respond(click.id, { content: "\u200B", ephemeral: true }).catch(() => void 0);
+      return click.customId === "_confirm_yes";
+    }
+    return false;
+  }
+  _awaitClick(msgId, userId, timeoutMs) {
+    return new Promise((resolve) => {
+      const timer = setTimeout(() => {
+        this.emitter.off("interactionCreate", handler);
+        resolve(null);
+      }, timeoutMs);
+      const handler = (i) => {
+        const isOurs = i.triggerMsgId === msgId && (i.customId === "_confirm_yes" || i.customId === "_confirm_no");
+        const isAllowed = !userId || i.userId === userId;
+        if (isOurs && isAllowed && typeof i.customId === "string") {
+          clearTimeout(timer);
+          this.emitter.off("interactionCreate", handler);
+          resolve({ id: i.id, customId: i.customId });
+        }
+      };
+      this.emitter.on("interactionCreate", handler);
+    });
+  }
+};
+
+// src/utils/ArgumentParser.ts
+var ParsedArguments = class {
+  constructor(positional, flags) {
+    this.positional = positional;
+    this._flags = flags;
+  }
+  /**
+   * Whether a named flag is present (regardless of value).
+   *
+   * @example
+   * args.has('notify') // true for --notify or --notify true
+   */
+  has(flag) {
+    return this._flags.has(flag);
+  }
+  /**
+   * Get the string value of a named flag, or `null` if absent.
+   *
+   * @example
+   * args.get('reason') // 'rule violation'
+   */
+  get(flag) {
+    return this._flags.get(flag) ?? null;
+  }
+  /**
+   * Get the string value of a named flag, throwing if missing.
+   *
+   * @example
+   * const reason = args.require('reason') // throws if --reason not supplied
+   */
+  require(flag) {
+    const v = this._flags.get(flag);
+    if (v == null) throw new Error(`[ArgumentParser] Required flag "--${flag}" is missing`);
+    return v;
+  }
+  /**
+   * Parse the flag value as an integer, or `null` if absent / not a number.
+   *
+   * @example
+   * args.getInt('days') // 7 from '--days 7'
+   */
+  getInt(flag) {
+    const v = this._flags.get(flag);
+    if (v == null) return null;
+    const n = parseInt(v, 10);
+    return isNaN(n) ? null : n;
+  }
+  /**
+   * Parse the flag value as a float, or `null` if absent / not a number.
+   */
+  getFloat(flag) {
+    const v = this._flags.get(flag);
+    if (v == null) return null;
+    const n = parseFloat(v);
+    return isNaN(n) ? null : n;
+  }
+  /**
+   * Get a positional argument by index (0-based), or `null` if absent.
+   *
+   * @example
+   * args.at(0) // first positional token
+   */
+  at(index) {
+    return this.positional[index] ?? null;
+  }
+  /**
+   * Get positional argument at `index` as an integer, or `null`.
+   *
+   * @example
+   * args.getInt(1) // 7 when positional is ['nick123', '7']
+   */
+  getIntAt(index) {
+    const v = this.positional[index];
+    if (v == null) return null;
+    const n = parseInt(v, 10);
+    return isNaN(n) ? null : n;
+  }
+  /**
+   * All flag names that were parsed.
+   *
+   * @example
+   * args.flags() // ['reason', 'notify']
+   */
+  flags() {
+    return [...this._flags.keys()];
+  }
+  toJSON() {
+    return {
+      positional: this.positional,
+      flags: Object.fromEntries(this._flags)
+    };
+  }
+};
+var ArgumentParser = class _ArgumentParser {
+  /**
+   * Parse a raw string of arguments.
+   * Returns a `ParsedArguments` instance.
+   */
+  static parse(input) {
+    const positional = [];
+    const flags = /* @__PURE__ */ new Map();
+    const tokens = _ArgumentParser._tokenise(input);
+    let i = 0;
+    while (i < tokens.length) {
+      const token = tokens[i];
+      if (token.startsWith("--")) {
+        const key = token.slice(2);
+        const next = tokens[i + 1];
+        if (next && !next.startsWith("-")) {
+          flags.set(key, next);
+          i += 2;
+        } else {
+          flags.set(key, "true");
+          i++;
+        }
+      } else if (token.startsWith("-") && token.length === 2) {
+        flags.set(token.slice(1), "true");
+        i++;
+      } else {
+        positional.push(token);
+        i++;
+      }
+    }
+    return new ParsedArguments(positional, flags);
+  }
+  /**
+   * Strip a user mention like `<@123456>` from the start of the input string
+   * and return the remainder trimmed. Returns the original string unchanged if
+   * no leading mention is found.
+   *
+   * @example
+   * ArgumentParser.stripMention('<@98765> hello world') // 'hello world'
+   */
+  static stripMention(input) {
+    return input.replace(/^<@!?\d+>\s*/, "").trim();
+  }
+  /**
+   * Split `input` into tokens. Quoted strings are treated as single tokens.
+   */
+  static _tokenise(input) {
+    const tokens = [];
+    let current = "";
+    let inDouble = false;
+    let inSingle = false;
+    for (let i = 0; i < input.length; i++) {
+      const ch = input[i];
+      if (ch === '"' && !inSingle) {
+        inDouble = !inDouble;
+        continue;
+      }
+      if (ch === "'" && !inDouble) {
+        inSingle = !inSingle;
+        continue;
+      }
+      if (ch === " " && !inDouble && !inSingle) {
+        if (current.length > 0) {
+          tokens.push(current);
+          current = "";
+        }
+        continue;
+      }
+      current += ch;
+    }
+    if (current.length > 0) tokens.push(current);
+    return tokens;
+  }
+};
+
+// src/utils/CacheMap.ts
+var CacheMap = class {
+  constructor() {
+    this._store = /* @__PURE__ */ new Map();
+  }
+  /**
+   * Store a value.
+   *
+   * @param key   - Cache key.
+   * @param value - Value to store.
+   * @param ttlMs - Optional time-to-live in milliseconds. Omit for permanent storage.
+   */
+  set(key, value, ttlMs) {
+    this._store.set(key, {
+      value,
+      expiresAt: ttlMs != null ? Date.now() + ttlMs : null
+    });
+    return this;
+  }
+  /**
+   * Retrieve a value, or `undefined` if absent or expired.
+   * Expired entries are automatically deleted on access.
+   */
+  get(key) {
+    const entry = this._store.get(key);
+    if (!entry) return void 0;
+    if (entry.expiresAt !== null && Date.now() >= entry.expiresAt) {
+      this._store.delete(key);
+      return void 0;
+    }
+    return entry.value;
+  }
+  /**
+   * Check if a live (non-expired) entry exists for this key.
+   */
+  has(key) {
+    return this.get(key) !== void 0;
+  }
+  /**
+   * Delete an entry.
+   * Returns `true` if the entry existed (even if it was expired).
+   */
+  delete(key) {
+    return this._store.delete(key);
+  }
+  /** Remove all entries. */
+  clear() {
+    this._store.clear();
+  }
+  /**
+   * Number of **live** (non-expired) entries.
+   * This prunes expired entries as a side-effect.
+   */
+  get size() {
+    this.prune();
+    return this._store.size;
+  }
+  /**
+   * Remove all expired entries immediately.
+   * Useful to call occasionally to free memory.
+   *
+   * @example
+   * // Prune every 10 minutes
+   * setInterval(() => cache.prune(), 10 * 60_000)
+   */
+  prune() {
+    const now = Date.now();
+    let removed = 0;
+    for (const [key, entry] of this._store) {
+      if (entry.expiresAt !== null && now >= entry.expiresAt) {
+        this._store.delete(key);
+        removed++;
+      }
+    }
+    return removed;
+  }
+  /**
+   * Return all **live** keys.
+   */
+  keys() {
+    this.prune();
+    return [...this._store.keys()];
+  }
+  /**
+   * Return all **live** values.
+   */
+  values() {
+    this.prune();
+    return [...this._store.values()].map((e) => e.value);
+  }
+  /**
+   * Return all **live** `[key, value]` pairs.
+   */
+  entries() {
+    this.prune();
+    return [...this._store.entries()].map(([k, e]) => [k, e.value]);
+  }
+  /**
+   * Get a value or compute & cache it if missing.
+   * Very useful for "cache-aside" data loading.
+   *
+   * @param key    - Cache key.
+   * @param loader - Async function that produces the value when the cache is cold.
+   * @param ttlMs  - Optional TTL to apply to the newly cached value.
+   *
+   * @example
+   * const profile = await cache.getOrSet(userId, () => client.fetchUserProfile(userId), 60_000)
+   */
+  async getOrSet(key, loader, ttlMs) {
+    const existing = this.get(key);
+    if (existing !== void 0) return existing;
+    const value = await loader();
+    this.set(key, value, ttlMs);
+    return value;
+  }
+  /**
+   * Return the number of milliseconds until a key expires.
+   * Returns `null` if the key has no TTL, `0` if it is already expired.
+   */
+  ttl(key) {
+    const entry = this._store.get(key);
+    if (!entry) return null;
+    if (entry.expiresAt === null) return null;
+    return Math.max(0, entry.expiresAt - Date.now());
+  }
+  [Symbol.iterator]() {
+    return this.entries()[Symbol.iterator]();
+  }
+};
+
+// src/utils/EventScheduler.ts
+var _idCounter = 0;
+function nextId() {
+  return `task_${++_idCounter}`;
+}
+var EventScheduler = class {
+  constructor() {
+    this._tasks = /* @__PURE__ */ new Map();
+  }
+  /**
+   * Schedule a one-shot task to run after `delayMs` milliseconds.
+   * Returns a task ID that can be passed to `cancel()`.
+   *
+   * @example
+   * const id = scheduler.schedule(5_000, () => console.log('5 seconds later'))
+   * // Change your mind:
+   * scheduler.cancel(id)
+   */
+  schedule(delayMs, fn) {
+    const id = nextId();
+    const handle = setTimeout(() => {
+      this._tasks.delete(id);
+      this._run(fn, id);
+    }, delayMs);
+    this._tasks.set(id, { id, handle, type: "once" });
+    return id;
+  }
+  /**
+   * Schedule a one-shot task to run at a specific `Date`.
+   * If the date is in the past, the callback fires on the next event-loop tick.
+   *
+   * @example
+   * const nextMidnight = new Date()
+   * nextMidnight.setHours(24, 0, 0, 0)
+   * scheduler.scheduleAt(nextMidnight, () => console.log('Midnight!'))
+   */
+  scheduleAt(date, fn) {
+    const delay = Math.max(0, date.getTime() - Date.now());
+    return this.schedule(delay, fn);
+  }
+  /**
+   * Schedule a recurring task that fires every `intervalMs` milliseconds.
+   * Returns a task ID that can be passed to `cancel()`.
+   *
+   * @example
+   * // Check incoming messages every minute
+   * const id = scheduler.repeat(60_000, () => checkForAnnouncements())
+   */
+  repeat(intervalMs, fn) {
+    const id = nextId();
+    const handle = setInterval(() => this._run(fn, id), intervalMs);
+    this._tasks.set(id, { id, handle, type: "repeat" });
+    return id;
+  }
+  /**
+   * Cancel a previously scheduled task by its ID.
+   * Returns `true` if the task existed, `false` if it had already fired or
+   * was not found.
+   *
+   * @example
+   * const id = scheduler.schedule(30_000, doSomething)
+   * // …maybe cancel it:
+   * scheduler.cancel(id)
+   */
+  cancel(id) {
+    const task = this._tasks.get(id);
+    if (!task) return false;
+    if (task.type === "once") clearTimeout(task.handle);
+    else clearInterval(task.handle);
+    this._tasks.delete(id);
+    return true;
+  }
+  /**
+   * Cancel all pending tasks.
+   * Useful during graceful shutdown.
+   *
+   * @example
+   * client.once('disconnect', () => scheduler.cancelAll())
+   */
+  cancelAll() {
+    for (const id of this._tasks.keys()) this.cancel(id);
+  }
+  /**
+   * Number of currently active (pending or recurring) tasks.
+   */
+  get pendingCount() {
+    return this._tasks.size;
+  }
+  /**
+   * IDs of all currently registered tasks.
+   */
+  taskIds() {
+    return [...this._tasks.keys()];
+  }
+  _run(fn, id) {
+    try {
+      const result = fn();
+      if (result && typeof result.catch === "function") {
+        ;
+        result.catch((e) => {
+          console.error(`[EventScheduler] Task ${id} threw:`, e);
+        });
+      }
+    } catch (e) {
+      console.error(`[EventScheduler] Task ${id} threw:`, e);
+    }
+  }
+};
 export {
   ActionRowBuilder,
+  ArgumentParser,
   AuditLogAPI,
+  AutoModAPI,
+  AutoModRuleBuilder,
   ButtonBuilder,
+  CacheMap,
+  CategoriesAPI,
+  ChannelBuilder,
   ChannelsAPI,
   Collection,
   CommandsAPI,
+  ConfirmationDialog,
+  ContextMenuCommandBuilder,
   Cooldown,
   CooldownManager,
   EmbedBuilder,
+  EmbedPaginator,
+  EventBuilder,
+  EventScheduler,
+  EventsAPI,
+  ForumAPI,
+  ForumPostBuilder,
   HttpClient,
+  InteractionCollector,
   InteractionOptions,
   InteractionsAPI,
+  InviteBuilder,
   InvitesAPI,
   Logger,
   MembersAPI,
+  MentionParser,
   MessageBuilder,
+  MessageCollector,
   MessagesAPI,
   ModalBuilder,
+  NovaBan,
+  NovaCategory,
   NovaChannel,
   NovaClient,
+  NovaForumPost,
   NovaInteraction,
   NovaInvite,
   NovaMember,
   NovaMessage,
   NovaRole,
+  NovaServerEvent,
   NovaServerWrapper,
+  NovaWarning,
   NovaWebhook,
   Paginator,
+  ParsedArguments,
   Permissions,
   PermissionsAPI,
   PermissionsBitfield,
   PollBuilder,
   ReactionsAPI,
+  RoleBuilder,
   RolesAPI,
   SelectMenuBuilder,
   ServersAPI,
   SlashCommandBuilder,
   SlashCommandOptionBuilder,
   TextInputBuilder,
+  UsersAPI,
   WebhooksAPI,
   countdown,
   formatDuration,