novaapp-sdk 1.2.0 → 1.3.0

package/dist/index.js

@@ -36,17 +36,28 @@ __export(index_exports, {
   MessageBuilder: () => MessageBuilder,
   MessagesAPI: () => MessagesAPI,
   ModalBuilder: () => ModalBuilder,
+  NovaChannel: () => NovaChannel,
   NovaClient: () => NovaClient,
   NovaInteraction: () => NovaInteraction,
+  NovaMember: () => NovaMember,
   NovaMessage: () => NovaMessage,
+  Paginator: () => Paginator,
+  Permissions: () => Permissions,
   PermissionsAPI: () => PermissionsAPI,
+  PermissionsBitfield: () => PermissionsBitfield,
   PollBuilder: () => PollBuilder,
   ReactionsAPI: () => ReactionsAPI,
   SelectMenuBuilder: () => SelectMenuBuilder,
   ServersAPI: () => ServersAPI,
   SlashCommandBuilder: () => SlashCommandBuilder,
   SlashCommandOptionBuilder: () => SlashCommandOptionBuilder,
-  TextInputBuilder: () => TextInputBuilder
+  TextInputBuilder: () => TextInputBuilder,
+  countdown: () => countdown,
+  formatDuration: () => formatDuration,
+  formatRelative: () => formatRelative,
+  parseTimestamp: () => parseTimestamp,
+  sleep: () => sleep,
+  withTimeout: () => withTimeout
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -1074,6 +1085,248 @@ var NovaMessage = class _NovaMessage {
   }
 };
 
+// src/structures/NovaChannel.ts
+var NovaChannel = class _NovaChannel {
+  constructor(raw, channels, messages) {
+    this.id = raw.id;
+    this.name = raw.name;
+    this.type = raw.type;
+    this.serverId = raw.serverId;
+    this.topic = raw.topic;
+    this.position = raw.position;
+    this.slowMode = raw.slowMode ?? 0;
+    this.createdAt = new Date(raw.createdAt);
+    this._channels = channels;
+    this._messages = messages;
+  }
+  // ─── Type guards ────────────────────────────────────────────────────────────
+  /** `true` for text channels. */
+  isText() {
+    return this.type === "TEXT";
+  }
+  /** `true` for voice channels. */
+  isVoice() {
+    return this.type === "VOICE";
+  }
+  /** `true` for announcement channels. */
+  isAnnouncement() {
+    return this.type === "ANNOUNCEMENT";
+  }
+  /** `true` for forum channels. */
+  isForum() {
+    return this.type === "FORUM";
+  }
+  /** `true` for stage channels. */
+  isStage() {
+    return this.type === "STAGE";
+  }
+  /** `true` if slow-mode is enabled on this channel. */
+  hasSlowMode() {
+    return this.slowMode > 0;
+  }
+  // ─── Messaging ──────────────────────────────────────────────────────────────
+  /**
+   * Send a message to this channel.
+   * Accepts a plain string or a full options object.
+   *
+   * @example
+   * await channel.send('Hello!')
+   * await channel.send({ content: 'Hi', embed: { title: 'Stats' } })
+   */
+  send(options) {
+    const body = typeof options === "string" ? { content: options } : options;
+    return this._messages.send(this.id, body);
+  }
+  /**
+   * Fetch recent messages from this channel.
+   *
+   * @example
+   * const messages = await channel.fetchMessages({ limit: 50 })
+   */
+  fetchMessages(options = {}) {
+    return this._channels.fetchMessages(this.id, options);
+  }
+  /**
+   * Fetch all pinned messages in this channel.
+   *
+   * @example
+   * const pins = await channel.fetchPins()
+   */
+  fetchPins() {
+    return this._channels.fetchPins(this.id);
+  }
+  /**
+   * Start a typing indicator (shows "Bot is typing…" for ~5 seconds).
+   *
+   * @example
+   * await channel.startTyping()
+   */
+  startTyping() {
+    return this._channels.startTyping(this.id);
+  }
+  // ─── Management ─────────────────────────────────────────────────────────────
+  /**
+   * Edit this channel's properties.
+   * Requires the `channels.manage` scope.
+   *
+   * @example
+   * await channel.edit({ name: 'general-2', topic: 'The second general channel' })
+   */
+  async edit(options) {
+    const raw = await this._channels.edit(this.id, options);
+    return new _NovaChannel(raw, this._channels, this._messages);
+  }
+  /**
+   * Delete this channel.
+   * Requires the `channels.manage` scope.
+   *
+   * @example
+   * await channel.delete()
+   */
+  delete() {
+    return this._channels.delete(this.id);
+  }
+  // ─── Serialisation ──────────────────────────────────────────────────────────
+  /**
+   * Returns the channel as a mention-style string: `#name`.
+   */
+  toString() {
+    return `#${this.name}`;
+  }
+  /** Returns the raw channel data. */
+  toJSON() {
+    return {
+      id: this.id,
+      name: this.name,
+      type: this.type,
+      serverId: this.serverId,
+      topic: this.topic,
+      position: this.position,
+      slowMode: this.slowMode,
+      createdAt: this.createdAt.toISOString()
+    };
+  }
+};
+
+// src/structures/NovaMember.ts
+var NovaMember = class {
+  constructor(raw, serverId, members) {
+    this.userId = raw.user.id;
+    this.serverId = serverId;
+    this.username = raw.user.username;
+    this.displayName = raw.user.displayName;
+    this.avatar = raw.user.avatar;
+    this.role = raw.role;
+    this.status = raw.user.status;
+    this.isBot = raw.user.isBot;
+    this.joinedAt = new Date(raw.joinedAt);
+    this._members = members;
+  }
+  // ─── Type guards ────────────────────────────────────────────────────────────
+  /** `true` if this member is the server owner. */
+  isOwner() {
+    return this.role === "OWNER";
+  }
+  /** `true` if this member is an admin or the server owner. */
+  isAdmin() {
+    return this.role === "ADMIN" || this.role === "OWNER";
+  }
+  /** `true` if this member is a regular (non-privileged) member. */
+  isRegularMember() {
+    return this.role === "MEMBER";
+  }
+  /** `true` if the user is currently online. */
+  isOnline() {
+    return this.status === "ONLINE";
+  }
+  /** `true` if the user is idle / away. */
+  isIdle() {
+    return this.status === "IDLE";
+  }
+  /** `true` if the user is set to Do Not Disturb. */
+  isDND() {
+    return this.status === "DND";
+  }
+  /** `true` if the user appears offline. */
+  isOffline() {
+    return this.status === "OFFLINE";
+  }
+  // ─── Actions ────────────────────────────────────────────────────────────────
+  /**
+   * Kick this member from the server.
+   * Bots cannot kick owners or admins (throws 403).
+   *
+   * @example
+   * await member.kick()
+   */
+  kick() {
+    return this._members.kick(this.serverId, this.userId);
+  }
+  /**
+   * Ban this member from the server with an optional reason.
+   * Bots cannot ban owners or admins (throws 403).
+   *
+   * @example
+   * await member.ban('Repeated rule violations')
+   */
+  ban(reason) {
+    return this._members.ban(this.serverId, this.userId, reason);
+  }
+  /**
+   * Send this user a direct message.
+   * Requires the `messages.write` scope.
+   *
+   * @example
+   * await member.dm('Welcome to the server!')
+   * await member.dm({ content: 'Hello', embed: { title: 'Rules' } })
+   */
+  dm(options) {
+    return this._members.dm(this.userId, options);
+  }
+  /**
+   * Assign a custom role to this member.
+   * Requires the `members.roles` scope.
+   *
+   * @example
+   * await member.addRole('role-id')
+   */
+  addRole(roleId) {
+    return this._members.addRole(this.serverId, this.userId, roleId);
+  }
+  /**
+   * Remove a custom role from this member.
+   * Requires the `members.roles` scope.
+   *
+   * @example
+   * await member.removeRole('role-id')
+   */
+  removeRole(roleId) {
+    return this._members.removeRole(this.serverId, this.userId, roleId);
+  }
+  // ─── 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/client.ts
 var NovaClient = class extends import_node_events.EventEmitter {
   constructor(options) {
@@ -1086,6 +1339,7 @@ var NovaClient = class extends import_node_events.EventEmitter {
     this._commandHandlers = /* @__PURE__ */ new Map();
     this._buttonHandlers = /* @__PURE__ */ new Map();
     this._selectHandlers = /* @__PURE__ */ new Map();
+    this._modalHandlers = /* @__PURE__ */ new Map();
     if (!options.token) {
       throw new Error("[nova-bot-sdk] A bot token is required.");
     }
@@ -1156,6 +1410,20 @@ var NovaClient = class extends import_node_events.EventEmitter {
     this._selectHandlers.set(customId, handler);
     return this;
   }
+  /**
+   * Register a handler for a modal submission by its `customId`.
+   * Called automatically when the user submits a modal with that `customId`.
+   *
+   * @example
+   * client.modal('report_modal', async (interaction) => {
+   *   const reason = interaction.modalData.reason
+   *   await interaction.replyEphemeral(`Report received: ${reason}`)
+   * })
+   */
+  modal(customId, handler) {
+    this._modalHandlers.set(customId, handler);
+    return this;
+  }
   /**
    * Connect to the Nova WebSocket gateway.
    * Resolves when the `ready` event is received.
@@ -1205,6 +1473,8 @@ var NovaClient = class extends import_node_events.EventEmitter {
           run(this._buttonHandlers.get(interaction.customId));
         } else if (interaction.isSelectMenu() && interaction.customId) {
           run(this._selectHandlers.get(interaction.customId));
+        } else if (interaction.isModalSubmit() && interaction.customId) {
+          run(this._modalHandlers.get(interaction.customId));
         }
       });
       this.socket.on("bot:event", (event) => {
@@ -1239,6 +1509,36 @@ var NovaClient = class extends import_node_events.EventEmitter {
           case "message.pinned":
             this.emit("messagePinned", event.data);
             break;
+          case "channel.created":
+            this.emit("channelCreate", event.data);
+            break;
+          case "channel.updated":
+            this.emit("channelUpdate", event.data);
+            break;
+          case "channel.deleted":
+            this.emit("channelDelete", event.data);
+            break;
+          case "role.created":
+            this.emit("roleCreate", event.data);
+            break;
+          case "role.deleted":
+            this.emit("roleDelete", event.data);
+            break;
+          case "user.voice_joined":
+            this.emit("voiceJoin", event.data);
+            break;
+          case "user.voice_left":
+            this.emit("voiceLeave", event.data);
+            break;
+          case "user.banned":
+            this.emit("memberBanned", event.data);
+            break;
+          case "user.unbanned":
+            this.emit("memberUnbanned", event.data);
+            break;
+          case "user.updated_profile":
+            this.emit("memberUpdate", event.data);
+            break;
         }
       });
       this.socket.on("bot:error", (err) => {
@@ -1295,6 +1595,83 @@ var NovaClient = class extends import_node_events.EventEmitter {
   setStatus(status) {
     this.socket?.emit("bot:status", { status });
   }
+  // ─── Rich-wrapper helpers ────────────────────────────────────────────────────
+  /**
+   * Fetch a single channel and return it as a rich `NovaChannel` wrapper.
+   *
+   * @example
+   * const channel = await client.fetchChannel('channel-id')
+   * await channel.send('Hello!')
+   */
+  async fetchChannel(channelId) {
+    const raw = await this.channels.fetch(channelId);
+    return new NovaChannel(raw, this.channels, this.messages);
+  }
+  /**
+   * Fetch all channels in a server and return them as `NovaChannel` wrappers.
+   *
+   * @example
+   * const channels = await client.fetchChannels('server-id')
+   * const textChannels = channels.filter(c => c.isText())
+   */
+  async fetchChannels(serverId) {
+    const list = await this.channels.list(serverId);
+    return list.map((raw) => new NovaChannel(raw, this.channels, this.messages));
+  }
+  /**
+   * Fetch all members in a server and return them as `NovaMember` wrappers.
+   *
+   * @example
+   * const members = await client.fetchMembers('server-id')
+   * const bots = members.filter(m => m.isBot)
+   */
+  async fetchMembers(serverId) {
+    const list = await this.members.list(serverId);
+    return list.map((raw) => new NovaMember(raw, serverId, this.members));
+  }
+  /**
+   * Fetch a single member from a server and return them as a `NovaMember` wrapper.
+   * Throws if the user is not found in the server.
+   *
+   * @example
+   * const member = await client.fetchMember('server-id', 'user-id')
+   * await member.dm('Welcome!')
+   */
+  async fetchMember(serverId, userId) {
+    const list = await this.members.list(serverId);
+    const raw = list.find((m) => m.user.id === userId);
+    if (!raw) throw new Error(`[nova-bot-sdk] Member ${userId} not found in server ${serverId}`);
+    return new NovaMember(raw, serverId, this.members);
+  }
+  // ─── Event fence ──────────────────────────────────────────────────────────────
+  /**
+   * Wait for a specific event to be emitted, optionally filtered.
+   * Rejects after `timeoutMs` (default 30 s) if the condition never fires.
+   *
+   * @example
+   * // Wait for any message in a specific channel
+   * const msg = await client.waitFor('messageCreate', m => m.channelId === channelId)
+   *
+   * // Wait for a button click with a timeout
+   * const i = await client.waitFor('interactionCreate', i => i.isButton(), 60_000)
+   */
+  waitFor(event, filter, timeoutMs = 3e4) {
+    return new Promise((resolve, reject) => {
+      const timer = setTimeout(() => {
+        this.off(event, handler);
+        reject(new Error(`[nova-bot-sdk] waitFor('${String(event)}') timed out after ${timeoutMs}ms`));
+      }, timeoutMs);
+      const handler = (...args) => {
+        const arg = args[0];
+        if (!filter || filter(arg)) {
+          clearTimeout(timer);
+          this.off(event, handler);
+          resolve(arg);
+        }
+      };
+      this.on(event, handler);
+    });
+  }
   /**
    * Disconnect from the gateway and clean up.
    */
@@ -2350,6 +2727,318 @@ var Logger = class {
     }
   }
 };
+
+// src/utils/Paginator.ts
+var Paginator = class {
+  constructor(fetchFn) {
+    this.fetchFn = fetchFn;
+    this._cursor = null;
+    this._done = false;
+    this._totalFetched = 0;
+  }
+  /** Whether all pages have been consumed. */
+  get done() {
+    return this._done;
+  }
+  /** Total number of items fetched so far (across all pages). */
+  get totalFetched() {
+    return this._totalFetched;
+  }
+  /**
+   * Fetch the next page of results.
+   * Returns an empty array when there are no more pages.
+   *
+   * @example
+   * const page1 = await paginator.fetchPage()
+   * const page2 = await paginator.fetchPage()
+   */
+  async fetchPage() {
+    if (this._done) return [];
+    const { items, cursor } = await this.fetchFn(this._cursor);
+    this._totalFetched += items.length;
+    this._cursor = cursor;
+    if (!cursor || items.length === 0) this._done = true;
+    return items;
+  }
+  /**
+   * Fetch **all** remaining pages and return a flat array.
+   *
+   * ⚠️ Use with caution on very large collections.
+   *
+   * @example
+   * const allMembers = await paginator.fetchAll()
+   */
+  async fetchAll() {
+    const all = [];
+    while (!this._done) {
+      const page = await this.fetchPage();
+      all.push(...page);
+    }
+    return all;
+  }
+  /**
+   * Fetch up to `n` items total (across however many pages are needed).
+   *
+   * @example
+   * const first100 = await paginator.fetchN(100)
+   */
+  async fetchN(n) {
+    const result = [];
+    while (!this._done && result.length < n) {
+      const page = await this.fetchPage();
+      result.push(...page.slice(0, n - result.length));
+    }
+    return result;
+  }
+  /**
+   * Async-iterate over every item, one page at a time.
+   *
+   * @example
+   * for await (const msg of paginator) {
+   *   process(msg)
+   * }
+   */
+  async *[Symbol.asyncIterator]() {
+    while (!this._done) {
+      const page = await this.fetchPage();
+      for (const item of page) yield item;
+    }
+  }
+  /**
+   * Reset the paginator so you can iterate from the beginning again.
+   *
+   * @example
+   * await paginator.fetchAll()
+   * paginator.reset()
+   * const againFirst = await paginator.fetchPage()
+   */
+  reset() {
+    this._cursor = null;
+    this._done = false;
+    this._totalFetched = 0;
+  }
+};
+
+// src/utils/PermissionsBitfield.ts
+var Permissions = {
+  /** Read messages in channels. */
+  MESSAGES_READ: "messages.read",
+  /** Send messages in channels. */
+  MESSAGES_WRITE: "messages.write",
+  /** Edit / delete any message (not just the bot's own). */
+  MESSAGES_MANAGE: "messages.manage",
+  /** Create, edit and delete channels. */
+  CHANNELS_MANAGE: "channels.manage",
+  /** Kick members from the server. */
+  MEMBERS_KICK: "members.kick",
+  /** Ban and unban members from the server. */
+  MEMBERS_BAN: "members.ban",
+  /** Assign and remove roles on members. */
+  MEMBERS_ROLES: "members.roles",
+  /** Edit server settings. */
+  SERVERS_MANAGE: "servers.manage"
+};
+var _PermissionsBitfield = class _PermissionsBitfield {
+  constructor(perms = {}) {
+    this._perms = { ...perms };
+  }
+  // ─── Checking ──────────────────────────────────────────────────────────────
+  /**
+   * Returns `true` if the given permission is explicitly granted.
+   *
+   * @example
+   * if (!perms.has(Permissions.MESSAGES_WRITE)) {
+   *   throw new Error('Bot cannot write messages here.')
+   * }
+   */
+  has(permission) {
+    return this._perms[permission] === true;
+  }
+  /**
+   * Returns `true` if **all** listed permissions are granted.
+   *
+   * @example
+   * perms.hasAll('messages.read', 'messages.write') // true
+   */
+  hasAll(...permissions) {
+    return permissions.every((p) => this.has(p));
+  }
+  /**
+   * Returns `true` if **at least one** of the listed permissions is granted.
+   *
+   * @example
+   * perms.hasAny('channels.manage', 'servers.manage') // true if either is set
+   */
+  hasAny(...permissions) {
+    return permissions.some((p) => this.has(p));
+  }
+  /**
+   * Returns the list of permissions that are **not** granted.
+   *
+   * @example
+   * const missing = perms.missing('messages.write', 'members.kick')
+   * if (missing.length) throw new Error(`Missing: ${missing.join(', ')}`)
+   */
+  missing(...permissions) {
+    return permissions.filter((p) => !this.has(p));
+  }
+  // ─── Building ──────────────────────────────────────────────────────────────
+  /**
+   * Return a **new** `PermissionsBitfield` with the given permission granted.
+   *
+   * @example
+   * const updated = perms.grant('channels.manage')
+   */
+  grant(...permissions) {
+    const next = { ...this._perms };
+    for (const p of permissions) next[p] = true;
+    return new _PermissionsBitfield(next);
+  }
+  /**
+   * Return a **new** `PermissionsBitfield` with the given permission denied.
+   *
+   * @example
+   * const restricted = perms.deny('members.kick')
+   */
+  deny(...permissions) {
+    const next = { ...this._perms };
+    for (const p of permissions) next[p] = false;
+    return new _PermissionsBitfield(next);
+  }
+  /**
+   * Merge another record or `PermissionsBitfield` on top of this one.
+   * The incoming values **override** any existing ones.
+   *
+   * @example
+   * const merged = serverPerms.merge(channelOverrides)
+   */
+  merge(other) {
+    const otherRecord = other instanceof _PermissionsBitfield ? other.toRecord() : other;
+    return new _PermissionsBitfield({ ...this._perms, ...otherRecord });
+  }
+  // ─── Inspection ────────────────────────────────────────────────────────────
+  /**
+   * Returns an array of the permission keys that are **currently granted**.
+   *
+   * @example
+   * perms.toArray() // ['messages.read', 'messages.write']
+   */
+  toArray() {
+    return Object.entries(this._perms).filter(([, v]) => v).map(([k]) => k);
+  }
+  /**
+   * Returns the raw `Record<string, boolean>` map.
+   */
+  toRecord() {
+    return { ...this._perms };
+  }
+  /**
+   * Pretty-print the granted permissions.
+   *
+   * @example
+   * console.log(String(perms)) // 'PermissionsBitfield[messages.read, messages.write]'
+   */
+  toString() {
+    const granted = this.toArray();
+    return granted.length > 0 ? `PermissionsBitfield[${granted.join(", ")}]` : "PermissionsBitfield[none]";
+  }
+  // ─── Static helpers ─────────────────────────────────────────────────────────
+  /** Create a `PermissionsBitfield` from an existing record. */
+  static from(perms) {
+    return new _PermissionsBitfield(perms);
+  }
+};
+/** A `PermissionsBitfield` with all known permissions granted. */
+_PermissionsBitfield.ALL = new _PermissionsBitfield({
+  [Permissions.MESSAGES_READ]: true,
+  [Permissions.MESSAGES_WRITE]: true,
+  [Permissions.MESSAGES_MANAGE]: true,
+  [Permissions.CHANNELS_MANAGE]: true,
+  [Permissions.MEMBERS_KICK]: true,
+  [Permissions.MEMBERS_BAN]: true,
+  [Permissions.MEMBERS_ROLES]: true,
+  [Permissions.SERVERS_MANAGE]: true
+});
+/** A `PermissionsBitfield` with no permissions granted. */
+_PermissionsBitfield.NONE = new _PermissionsBitfield({});
+var PermissionsBitfield = _PermissionsBitfield;
+
+// src/utils/time.ts
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function withTimeout(promise, ms, message) {
+  return new Promise((resolve, reject) => {
+    const id = setTimeout(() => {
+      reject(new Error(message ?? `[nova-bot-sdk] Operation timed out after ${ms}ms`));
+    }, ms);
+    promise.then(
+      (v) => {
+        clearTimeout(id);
+        resolve(v);
+      },
+      (e) => {
+        clearTimeout(id);
+        reject(e);
+      }
+    );
+  });
+}
+var SECOND = 1e3;
+var MINUTE = 60 * SECOND;
+var HOUR = 60 * MINUTE;
+var DAY = 24 * HOUR;
+var WEEK = 7 * DAY;
+function formatDuration(ms) {
+  if (ms < SECOND) return "0s";
+  const weeks = Math.floor(ms / WEEK);
+  const days = Math.floor(ms % WEEK / DAY);
+  const hours = Math.floor(ms % DAY / HOUR);
+  const minutes = Math.floor(ms % HOUR / MINUTE);
+  const seconds = Math.floor(ms % MINUTE / SECOND);
+  const parts = [];
+  if (weeks) parts.push(`${weeks}w`);
+  if (days) parts.push(`${days}d`);
+  if (hours) parts.push(`${hours}h`);
+  if (minutes) parts.push(`${minutes}m`);
+  if (seconds) parts.push(`${seconds}s`);
+  return parts.join(" ");
+}
+function formatRelative(timestamp) {
+  const ts = timestamp instanceof Date ? timestamp.getTime() : typeof timestamp === "string" ? new Date(timestamp).getTime() : timestamp;
+  const diff = Date.now() - ts;
+  const abs = Math.abs(diff);
+  const past = diff > 0;
+  const fmt = (n, unit) => past ? `${n} ${unit}${n !== 1 ? "s" : ""} ago` : `in ${n} ${unit}${n !== 1 ? "s" : ""}`;
+  if (abs < 5e3) return "just now";
+  if (abs < MINUTE) return fmt(Math.round(abs / SECOND), "second");
+  if (abs < 2 * MINUTE) return past ? "a minute ago" : "in a minute";
+  if (abs < HOUR) return fmt(Math.round(abs / MINUTE), "minute");
+  if (abs < 2 * HOUR) return past ? "an hour ago" : "in an hour";
+  if (abs < DAY) return fmt(Math.round(abs / HOUR), "hour");
+  if (abs < 2 * DAY) return past ? "yesterday" : "tomorrow";
+  if (abs < WEEK) return fmt(Math.round(abs / DAY), "day");
+  if (abs < 4 * WEEK) return fmt(Math.round(abs / WEEK), "week");
+  return new Date(ts).toLocaleDateString(void 0, { year: "numeric", month: "short", day: "numeric" });
+}
+function parseTimestamp(value) {
+  if (value == null) return null;
+  if (value instanceof Date) return isNaN(value.getTime()) ? null : value;
+  const d = new Date(value);
+  return isNaN(d.getTime()) ? null : d;
+}
+function countdown(target) {
+  const targetMs = target instanceof Date ? target.getTime() : typeof target === "string" ? new Date(target).getTime() : target;
+  const total = Math.max(0, targetMs - Date.now());
+  return {
+    total,
+    weeks: Math.floor(total / WEEK),
+    days: Math.floor(total % WEEK / DAY),
+    hours: Math.floor(total % DAY / HOUR),
+    minutes: Math.floor(total % HOUR / MINUTE),
+    seconds: Math.floor(total % MINUTE / SECOND)
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ActionRowBuilder,
@@ -2368,15 +3057,26 @@ var Logger = class {
   MessageBuilder,
   MessagesAPI,
   ModalBuilder,
+  NovaChannel,
   NovaClient,
   NovaInteraction,
+  NovaMember,
   NovaMessage,
+  Paginator,
+  Permissions,
   PermissionsAPI,
+  PermissionsBitfield,
   PollBuilder,
   ReactionsAPI,
   SelectMenuBuilder,
   ServersAPI,
   SlashCommandBuilder,
   SlashCommandOptionBuilder,
-  TextInputBuilder
+  TextInputBuilder,
+  countdown,
+  formatDuration,
+  formatRelative,
+  parseTimestamp,
+  sleep,
+  withTimeout
 });