novaapp-sdk 1.3.3 → 1.4.0

package/dist/index.mjs

@@ -253,16 +253,33 @@ var MembersAPI = class {
   }
   /**
    * Fetch members of a server the bot is in.
+   * Supports filtering by role and searching by username/displayName.
    *
    * @example
    * const members = await client.members.list('server-id', { limit: 50 })
+   * const admins = await client.members.list('server-id', { role: 'ADMIN' })
+   * const found = await client.members.list('server-id', { search: 'john' })
    */
   list(serverId, options = {}) {
     const params = new URLSearchParams();
     if (options.limit) params.set("limit", String(options.limit));
+    if (options.role) params.set("role", options.role);
+    if (options.search) params.set("search", options.search);
     const qs = params.toString();
     return this.http.get(`/servers/${serverId}/members${qs ? `?${qs}` : ""}`);
   }
+  /**
+   * Fetch a single member from a server by their user ID.
+   * Returns the member's custom role if assigned.
+   * Requires the `members.read` scope.
+   *
+   * @example
+   * const member = await client.members.fetch('server-id', 'user-id')
+   * console.log(member.customRole?.name ?? 'No custom role')
+   */
+  fetch(serverId, userId) {
+    return this.http.get(`/servers/${serverId}/members/${userId}`);
+  }
   /**
    * Kick a member from a server.
    * Bots cannot kick owners or admins (403 will be thrown).
@@ -355,6 +372,27 @@ var ServersAPI = class {
   list() {
     return this.http.get("/servers");
   }
+  /**
+   * Fetch a single server by ID.
+   * The bot must be a member of the server.
+   *
+   * @example
+   * const server = await client.servers.fetch('server-id')
+   * console.log(`${server.name} — ${server.memberCount} members`)
+   */
+  fetch(serverId) {
+    return this.http.get(`/servers/${serverId}`);
+  }
+  /**
+   * Update a server's name, description, or icon.
+   * Requires the `server.manage` scope.
+   *
+   * @example
+   * await client.servers.update('server-id', { name: 'Better Name', description: 'A great place!' })
+   */
+  update(serverId, options) {
+    return this.http.patch(`/servers/${serverId}`, options);
+  }
   /**
    * Fetch all roles in a server.
    * Results are sorted by position (lowest first).
@@ -404,6 +442,26 @@ var InteractionsAPI = class {
       options
     );
   }
+  /**
+   * Respond to an autocomplete interaction with a list of suggested choices.
+   * The gateway fires `AUTOCOMPLETE` interactions when a user is typing in
+   * an option that has `autocomplete: true`.  Call this within ~3 seconds.
+   *
+   * @example
+   * client.autocomplete('search', async (interaction) => {
+   *   const query = interaction.autocomplete?.value ?? ''
+   *   const results = await db.search(query)
+   *   await client.interactions.autocomplete(interaction.id,
+   *     results.map(r => ({ name: r.title, value: r.id }))
+   *   )
+   * })
+   */
+  autocomplete(interactionId, choices) {
+    return this.http.post(
+      `/interactions/${interactionId}/autocomplete`,
+      { choices }
+    );
+  }
   /**
    * Poll for pending (unacknowledged) interactions.
    * Useful when not using the WebSocket gateway.
@@ -698,6 +756,239 @@ var ReactionsAPI = class {
   }
 };
 
+// src/api/roles.ts
+var RolesAPI = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * List all custom roles in a server, sorted by position.
+   *
+   * @example
+   * const roles = await client.roles.list('server-id')
+   * const adminRole = roles.find(r => r.name === 'Admin')
+   */
+  list(serverId) {
+    return this.http.get(`/servers/${serverId}/roles`);
+  }
+  /**
+   * Create a new custom role in a server.
+   * Requires the `roles.manage` scope.
+   *
+   * @example
+   * const role = await client.roles.create('server-id', {
+   *   name: 'Verified',
+   *   color: '#00d4ff',
+   *   hoist: true,
+   *   permissions: { sendMessages: true, addReactions: true },
+   * })
+   */
+  create(serverId, options) {
+    return this.http.post(`/servers/${serverId}/roles`, options);
+  }
+  /**
+   * Edit an existing role.
+   * Requires the `roles.manage` scope.
+   *
+   * @example
+   * await client.roles.edit('role-id', { color: '#ff0000', name: 'Danger' })
+   */
+  edit(roleId, options) {
+    return this.http.patch(`/roles/${roleId}`, options);
+  }
+  /**
+   * Delete a custom role from a server.
+   * Any member currently assigned this role will have it removed automatically.
+   * Requires the `roles.manage` scope.
+   *
+   * @example
+   * await client.roles.delete('role-id')
+   */
+  delete(roleId) {
+    return this.http.delete(`/roles/${roleId}`);
+  }
+  /**
+   * Assign a custom role to a server member.
+   * Requires the `members.roles` scope.
+   *
+   * @example
+   * await client.roles.assign('server-id', 'user-id', 'role-id')
+   */
+  assign(serverId, userId, roleId) {
+    return this.http.post(`/servers/${serverId}/members/${userId}/roles/${roleId}`);
+  }
+  /**
+   * Remove a custom role from a server member.
+   * Requires the `members.roles` scope.
+   *
+   * @example
+   * await client.roles.remove('server-id', 'user-id', 'role-id')
+   */
+  remove(serverId, userId, roleId) {
+    return this.http.delete(`/servers/${serverId}/members/${userId}/roles/${roleId}`);
+  }
+};
+
+// src/api/invites.ts
+var InvitesAPI = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * List all active invites for a server.
+   *
+   * @example
+   * const invites = await client.invites.list('server-id')
+   * console.log(`${invites.length} active invites`)
+   */
+  list(serverId) {
+    return this.http.get(`/servers/${serverId}/invites`);
+  }
+  /**
+   * Create a new invite for a server.
+   * Requires the `invites.manage` scope.
+   *
+   * @example
+   * // A one-time invite that expires in 24 hours
+   * const invite = await client.invites.create('server-id', {
+   *   maxUses: 1,
+   *   expiresAt: new Date(Date.now() + 86_400_000).toISOString(),
+   * })
+   * console.log(`https://novachatapp.com/invite/${invite.code}`)
+   */
+  create(serverId, options = {}) {
+    return this.http.post(`/servers/${serverId}/invites`, options);
+  }
+  /**
+   * Fetch a single invite by its code.
+   *
+   * @example
+   * const invite = await client.invites.fetch('abc123')
+   * console.log(`${invite.uses} / ${invite.maxUses ?? '∞'} uses`)
+   */
+  fetch(code) {
+    return this.http.get(`/invites/${code}`);
+  }
+  /**
+   * Revoke (delete) an invite.
+   * Requires the `invites.manage` scope.
+   *
+   * @example
+   * await client.invites.revoke('abc123')
+   */
+  revoke(code) {
+    return this.http.delete(`/invites/${code}`);
+  }
+};
+
+// src/api/webhooks.ts
+var WebhooksAPI = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * List all webhooks in a channel.
+   * Requires the `webhooks.manage` scope.
+   *
+   * @example
+   * const webhooks = await client.webhooks.list('channel-id')
+   */
+  list(channelId) {
+    return this.http.get(`/channels/${channelId}/webhooks`);
+  }
+  /**
+   * Create a webhook in a channel.
+   * Requires the `webhooks.manage` scope.
+   *
+   * @example
+   * const webhook = await client.webhooks.create('channel-id', { name: 'Announcements' })
+   * console.log('Token:', webhook.token)
+   */
+  create(channelId, options) {
+    return this.http.post(`/channels/${channelId}/webhooks`, options);
+  }
+  /**
+   * Fetch a webhook by its ID.
+   * Requires the `webhooks.manage` scope.
+   *
+   * @example
+   * const webhook = await client.webhooks.fetch('webhook-id')
+   */
+  fetch(webhookId) {
+    return this.http.get(`/webhooks/${webhookId}`);
+  }
+  /**
+   * Edit a webhook's name and/or target channel.
+   * Requires the `webhooks.manage` scope.
+   *
+   * @example
+   * await client.webhooks.edit('webhook-id', { name: 'New Name', channelId: 'other-channel' })
+   */
+  edit(webhookId, options) {
+    return this.http.patch(`/webhooks/${webhookId}`, options);
+  }
+  /**
+   * Delete a webhook.
+   * Requires the `webhooks.manage` scope.
+   *
+   * @example
+   * await client.webhooks.delete('webhook-id')
+   */
+  delete(webhookId) {
+    return this.http.delete(`/webhooks/${webhookId}`);
+  }
+  /**
+   * Execute a webhook — post a message to the webhook's channel.
+   * Does not require any extra scope (uses the webhook data already owned by
+   * this bot application).
+   *
+   * @example
+   * await client.webhooks.execute('webhook-id', {
+   *   content: '🚀 Deployment successful!',
+   *   username: 'Deploy Bot',
+   * })
+   */
+  execute(webhookId, options) {
+    return this.http.post(`/webhooks/${webhookId}/execute`, options);
+  }
+};
+
+// src/api/auditlog.ts
+var AuditLogAPI = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Fetch the audit log for a server.
+   * Requires the `audit-log.read` scope.
+   *
+   * You can filter by action type, actor user ID, and paginate backwards
+   * using the `before` cursor (an ISO timestamp).
+   *
+   * @example
+   * // Most recent 50 entries
+   * const entries = await client.auditLog.fetch('server-id')
+   *
+   * // Only kick and ban actions
+   * const modActions = await client.auditLog.fetch('server-id', {
+   *   action: 'member.banned',
+   *   limit: 20,
+   * })
+   *
+   * // All actions performed by a specific user
+   * const byUser = await client.auditLog.fetch('server-id', { userId: 'user-id' })
+   */
+  fetch(serverId, options = {}) {
+    const params = new URLSearchParams();
+    if (options.limit) params.set("limit", String(options.limit));
+    if (options.action) params.set("action", options.action);
+    if (options.userId) params.set("userId", options.userId);
+    if (options.before) params.set("before", options.before);
+    const qs = params.toString();
+    return this.http.get(`/servers/${serverId}/audit-logs${qs ? `?${qs}` : ""}`);
+  }
+};
+
 // src/structures/NovaInteraction.ts
 var InteractionOptions = class {
   constructor(data) {
@@ -761,6 +1052,20 @@ var NovaInteraction = class _NovaInteraction {
     this.createdAt = _raw.createdAt;
     this.options = new InteractionOptions(_raw.data);
   }
+  /**
+   * For `AUTOCOMPLETE` interactions — the option being completed.
+   * Contains `name` (option name) and `value` (partial text typed so far).
+   * `null` for all other interaction types.
+   *
+   * @example
+   * client.autocomplete('search', async (interaction) => {
+   *   const query = interaction.autocomplete?.value ?? ''
+   *   await interaction.respondAutocomplete([{ name: query, value: query }])
+   * })
+   */
+  get autocomplete() {
+    return this._raw.autocomplete ?? null;
+  }
   // ── Type guards ─────────────────────────────────────────────────────────────
   /** `true` when triggered by a `/slash` command. */
   isSlashCommand() {
@@ -790,6 +1095,21 @@ var NovaInteraction = class _NovaInteraction {
   isAutocomplete() {
     return this.type === "AUTOCOMPLETE";
   }
+  /**
+   * Send autocomplete suggestions back to the user.
+   * Call this inside a `client.autocomplete()` handler.
+   * Up to 25 choices are shown; each needs a `name` (displayed) and `value` (submitted).
+   *
+   * @example
+   * client.autocomplete('color', async (interaction) => {
+   *   const query = interaction.autocomplete?.value ?? ''
+   *   const colors = ['red', 'green', 'blue'].filter(c => c.startsWith(query))
+   *   await interaction.respondAutocomplete(colors.map(c => ({ name: c, value: c })))
+   * })
+   */
+  respondAutocomplete(choices) {
+    return this._api.autocomplete(this.id, choices);
+  }
   /** `true` when triggered via a context-menu command. */
   isContextMenu() {
     return this.type === "CONTEXT_MENU";
@@ -1264,6 +1584,338 @@ var NovaMember = class {
   }
 };
 
+// src/structures/NovaRole.ts
+var NovaRole = class {
+  constructor(raw, roles) {
+    this.id = raw.id;
+    this.name = raw.name;
+    this.color = raw.color;
+    this.position = raw.position;
+    this.serverId = raw.serverId;
+    this.hoist = raw.hoist;
+    this.createdAt = new Date(raw.createdAt);
+    this._roles = roles;
+  }
+  // ─── Convenience methods ──────────────────────────────────────────────────
+  /**
+   * Edit this role's name, colour, hoist flag, or permissions.
+   *
+   * @example
+   * await role.edit({ color: '#ff0000', name: 'Red Team' })
+   */
+  edit(options) {
+    return this._roles.edit(this.id, options);
+  }
+  /**
+   * Delete this role from the server.
+   * Any members currently assigned this role will have it removed.
+   *
+   * @example
+   * await role.delete()
+   */
+  delete() {
+    return this._roles.delete(this.id);
+  }
+  /**
+   * Assign this role to a server member.
+   *
+   * @example
+   * await role.assign('user-id')
+   */
+  assign(userId) {
+    return this._roles.assign(this.serverId, userId, this.id);
+  }
+  /**
+   * Remove this role from a server member.
+   *
+   * @example
+   * await role.remove('user-id')
+   */
+  remove(userId) {
+    return this._roles.remove(this.serverId, userId, this.id);
+  }
+  // ─── Helpers ─────────────────────────────────────────────────────────────
+  /** Returns `true` if the role has a custom hex colour set. */
+  hasColor() {
+    return this.color !== null;
+  }
+  /** Returns the CSS-safe hex colour string. Falls back to `'#99aab5'` (grey). */
+  toHex() {
+    return this.color ?? "#99aab5";
+  }
+  toJSON() {
+    return {
+      id: this.id,
+      name: this.name,
+      color: this.color,
+      position: this.position,
+      serverId: this.serverId,
+      hoist: this.hoist,
+      permissions: {},
+      createdAt: this.createdAt.toISOString()
+    };
+  }
+};
+
+// src/structures/NovaServer.ts
+var NovaServerWrapper = class {
+  constructor(raw, servers, channels, members, invites, roles, messages) {
+    this.id = raw.id;
+    this.name = raw.name;
+    this.icon = raw.icon;
+    this.description = raw.description;
+    this.memberCount = raw.memberCount;
+    this.channelCount = raw.channelCount;
+    this.joinedAt = new Date(raw.joinedAt);
+    this._servers = servers;
+    this._channels = channels;
+    this._members = members;
+    this._invites = invites;
+    this._roles = roles;
+    this._messages = messages;
+  }
+  // ─── Server management ────────────────────────────────────────────────────
+  /**
+   * Update this server's name, description, or icon.
+   * Requires the `server.manage` scope.
+   *
+   * @example
+   * await server.update({ name: 'New Name' })
+   */
+  update(options) {
+    return this._servers.update(this.id, options);
+  }
+  // ─── Channels ─────────────────────────────────────────────────────────────
+  /**
+   * Fetch all channels in this server.
+   *
+   * @example
+   * const channels = await server.fetchChannels()
+   * const text = channels.filter(c => c.type === 'TEXT')
+   */
+  fetchChannels() {
+    return this._channels.list(this.id);
+  }
+  /**
+   * Create a new channel in this server.
+   * Requires the `channels.manage` scope.
+   *
+   * @example
+   * const ch = await server.createChannel({ name: 'bot-logs', type: 'TEXT' })
+   */
+  createChannel(options) {
+    return this._channels.create(this.id, options);
+  }
+  // ─── Members ─────────────────────────────────────────────────────────────
+  /**
+   * Fetch members in this server.
+   *
+   * @example
+   * const members = await server.fetchMembers({ limit: 100 })
+   */
+  fetchMembers(options = {}) {
+    return this._members.list(this.id, options);
+  }
+  /**
+   * Fetch a single member by user ID.
+   *
+   * @example
+   * const member = await server.fetchMember('user-id')
+   */
+  fetchMember(userId) {
+    return this._members.fetch(this.id, userId);
+  }
+  /**
+   * Kick a member from this server.
+   *
+   * @example
+   * await server.kick('user-id')
+   */
+  kick(userId) {
+    return this._members.kick(this.id, userId);
+  }
+  /**
+   * Ban a member from this server.
+   *
+   * @example
+   * await server.ban('user-id', 'Spamming')
+   */
+  ban(userId, reason) {
+    return this._members.ban(this.id, userId, reason);
+  }
+  /**
+   * Fetch the ban list for this server.
+   */
+  fetchBans() {
+    return this._members.listBans(this.id);
+  }
+  // ─── Roles ────────────────────────────────────────────────────────────────
+  /**
+   * Fetch all custom roles in this server.
+   *
+   * @example
+   * const roles = await server.fetchRoles()
+   */
+  fetchRoles() {
+    return this._roles.list(this.id);
+  }
+  // ─── Invites ──────────────────────────────────────────────────────────────
+  /**
+   * Fetch all active invites for this server.
+   *
+   * @example
+   * const invites = await server.fetchInvites()
+   */
+  fetchInvites() {
+    return this._invites.list(this.id);
+  }
+  /**
+   * Create an invite for this server.
+   *
+   * @example
+   * const invite = await server.createInvite({ maxUses: 10 })
+   * console.log(`https://novachatapp.com/invite/${invite.code}`)
+   */
+  createInvite(options = {}) {
+    return this._invites.create(this.id, options);
+  }
+  // ─── Messaging shortcut ───────────────────────────────────────────────────
+  /**
+   * Send a message to a channel in this server by channel ID.
+   *
+   * @example
+   * await server.send('channel-id', 'Hello, server!')
+   */
+  send(channelId, content) {
+    return this._messages.send(channelId, { content });
+  }
+  // ─── Helpers ─────────────────────────────────────────────────────────────
+  toJSON() {
+    return {
+      id: this.id,
+      name: this.name,
+      icon: this.icon,
+      description: this.description,
+      memberCount: this.memberCount,
+      channelCount: this.channelCount,
+      joinedAt: this.joinedAt.toISOString()
+    };
+  }
+};
+
+// src/structures/NovaInvite.ts
+var NovaInvite = class {
+  constructor(raw, invites) {
+    this.code = raw.code;
+    this.serverId = raw.serverId;
+    this.creatorId = raw.creatorId;
+    this.uses = raw.uses;
+    this.maxUses = raw.maxUses;
+    this.expiresAt = raw.expiresAt ? new Date(raw.expiresAt) : null;
+    this.createdAt = new Date(raw.createdAt);
+    this._invites = invites;
+  }
+  // ─── Helpers ─────────────────────────────────────────────────────────────
+  /** The full URL users can follow to join the server. */
+  get url() {
+    return `https://novachatapp.com/invite/${this.code}`;
+  }
+  /**
+   * Returns `true` if the invite has passed its expiry time.
+   * Always `false` for invites with no expiry.
+   */
+  isExpired() {
+    if (!this.expiresAt) return false;
+    return this.expiresAt < /* @__PURE__ */ new Date();
+  }
+  /**
+   * Returns `true` if the invite has reached its maximum use count.
+   * Always `false` for unlimited invites.
+   */
+  isExhausted() {
+    if (this.maxUses === null) return false;
+    return this.uses >= this.maxUses;
+  }
+  /** Whether this invite is still usable (not expired and not exhausted). */
+  isValid() {
+    return !this.isExpired() && !this.isExhausted();
+  }
+  /**
+   * Revoke (delete) this invite, making the code unusable.
+   * Requires the `invites.manage` scope.
+   *
+   * @example
+   * await invite.revoke()
+   */
+  revoke() {
+    return this._invites.revoke(this.code);
+  }
+  toJSON() {
+    return {
+      code: this.code,
+      serverId: this.serverId,
+      creatorId: this.creatorId,
+      uses: this.uses,
+      maxUses: this.maxUses,
+      expiresAt: this.expiresAt?.toISOString() ?? null,
+      createdAt: this.createdAt.toISOString()
+    };
+  }
+};
+
+// src/structures/NovaWebhook.ts
+var NovaWebhook = class {
+  constructor(raw, webhooks) {
+    this.id = raw.id;
+    this.serverId = raw.serverId;
+    this.channelId = raw.channelId;
+    this.name = raw.name;
+    this.token = raw.token;
+    this.createdAt = new Date(raw.createdAt);
+    this._webhooks = webhooks;
+  }
+  // ─── Convenience methods ──────────────────────────────────────────────────
+  /**
+   * Edit this webhook's name or target channel.
+   * Requires the `webhooks.manage` scope.
+   *
+   * @example
+   * await webhook.edit({ name: 'New Name', channelId: 'other-channel-id' })
+   */
+  edit(options) {
+    return this._webhooks.edit(this.id, options);
+  }
+  /**
+   * Delete this webhook.
+   * Requires the `webhooks.manage` scope.
+   *
+   * @example
+   * await webhook.delete()
+   */
+  delete() {
+    return this._webhooks.delete(this.id);
+  }
+  /**
+   * Post a message via this webhook.
+   *
+   * @example
+   * await webhook.execute({ content: '❌ Tests failed on branch main', username: 'CI' })
+   */
+  execute(options) {
+    return this._webhooks.execute(this.id, options);
+  }
+  toJSON() {
+    return {
+      id: this.id,
+      serverId: this.serverId,
+      channelId: this.channelId,
+      name: this.name,
+      token: this.token,
+      createdAt: this.createdAt.toISOString()
+    };
+  }
+};
+
 // src/client.ts
 var NovaClient = class extends EventEmitter {
   constructor(options) {
@@ -1272,11 +1924,12 @@ var NovaClient = class extends EventEmitter {
     this.botUser = null;
     this.socket = null;
     this._cronTimers = [];
-    // ── Command / component routing ───────────────────────────────────────────────────
+    // ── Command / component routing ────────────────────────────────────────────
     this._commandHandlers = /* @__PURE__ */ new Map();
     this._buttonHandlers = /* @__PURE__ */ new Map();
     this._selectHandlers = /* @__PURE__ */ new Map();
     this._modalHandlers = /* @__PURE__ */ new Map();
+    this._autocompleteHandlers = /* @__PURE__ */ new Map();
     if (!options.token) {
       throw new Error("[nova-bot-sdk] A bot token is required.");
     }
@@ -1296,6 +1949,10 @@ var NovaClient = class extends EventEmitter {
     this.permissions = new PermissionsAPI(this.http);
     this.channels = new ChannelsAPI(this.http);
     this.reactions = new ReactionsAPI(this.http);
+    this.roles = new RolesAPI(this.http);
+    this.invites = new InvitesAPI(this.http);
+    this.webhooks = new WebhooksAPI(this.http);
+    this.auditLog = new AuditLogAPI(this.http);
     this.on("error", () => {
     });
     const cleanup = () => this.disconnect();
@@ -1361,6 +2018,26 @@ var NovaClient = class extends EventEmitter {
     this._modalHandlers.set(customId, handler);
     return this;
   }
+  /**
+   * Register a handler for an autocomplete interaction by command name.
+   * Called when the user is typing in an option with `autocomplete: true`.
+   * The handler receives the interaction with `interaction.autocomplete.value`
+   * containing the partial text, and should call `interaction.respondAutocomplete()`
+   * to send completion suggestions.
+   *
+   * @example
+   * client.autocomplete('search', async (interaction) => {
+   *   const query = interaction.autocomplete?.value ?? ''
+   *   const results = await myDB.search(query)
+   *   await interaction.respondAutocomplete(
+   *     results.map(r => ({ name: r.label, value: r.id }))
+   *   )
+   * })
+   */
+  autocomplete(commandName, handler) {
+    this._autocompleteHandlers.set(commandName, handler);
+    return this;
+  }
   /**
    * Connect to the Nova WebSocket gateway.
    * Resolves when the `ready` event is received.
@@ -1412,6 +2089,8 @@ var NovaClient = class extends EventEmitter {
           run(this._selectHandlers.get(interaction.customId));
         } else if (interaction.isModalSubmit() && interaction.customId) {
           run(this._modalHandlers.get(interaction.customId));
+        } else if (interaction.isAutocomplete() && interaction.commandName) {
+          run(this._autocompleteHandlers.get(interaction.commandName));
         }
       });
       this.socket.on("bot:event", (event) => {
@@ -1476,6 +2155,15 @@ var NovaClient = class extends EventEmitter {
           case "user.updated_profile":
             this.emit("memberUpdate", event.data);
             break;
+          case "user.role_added":
+            this.emit("memberRoleAdded", event.data);
+            break;
+          case "user.role_removed":
+            this.emit("memberRoleRemoved", event.data);
+            break;
+          case "server.updated":
+            this.emit("serverUpdate", event.data);
+            break;
         }
       });
       this.socket.on("bot:error", (err) => {
@@ -1568,18 +2256,92 @@ var NovaClient = class extends EventEmitter {
   }
   /**
    * Fetch a single member from a server and return them as a `NovaMember` wrapper.
-   * Throws if the user is not found in the server.
+   * Uses the dedicated single-member endpoint (more efficient than listing all members).
    *
    * @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}`);
+    const raw = await this.members.fetch(serverId, userId);
     return new NovaMember(raw, serverId, this.members);
   }
+  /**
+   * Fetch a single server by ID and return it as a `NovaServerWrapper`.
+   *
+   * @example
+   * const server = await client.fetchServer('server-id')
+   * console.log(`${server.name} — ${server.memberCount} members`)
+   */
+  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);
+  }
+  /**
+   * Fetch all servers the bot is in and return them as `NovaServerWrapper` objects.
+   *
+   * @example
+   * const servers = await client.fetchServers()
+   * for (const s of servers) console.log(s.name)
+   */
+  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));
+  }
+  /**
+   * Fetch all custom roles in a server and return them as `NovaRole` wrappers.
+   *
+   * @example
+   * const roles = await client.fetchRoles('server-id')
+   * const mod = roles.find(r => r.name === 'Moderator')
+   */
+  async fetchRoles(serverId) {
+    const list = await this.roles.list(serverId);
+    return list.map((raw) => new NovaRole(raw, this.roles));
+  }
+  /**
+   * Fetch all active invites for a server and return them as `NovaInvite` wrappers.
+   *
+   * @example
+   * const invites = await client.fetchInvites('server-id')
+   * const active = invites.filter(i => i.isValid())
+   */
+  async fetchInvites(serverId) {
+    const list = await this.invites.list(serverId);
+    return list.map((raw) => new NovaInvite(raw, this.invites));
+  }
+  /**
+   * Fetch a single invite by code and return it as a `NovaInvite` wrapper.
+   *
+   * @example
+   * const invite = await client.fetchInvite('abc123')
+   * if (invite.isExpired()) await invite.revoke()
+   */
+  async fetchInvite(code) {
+    const raw = await this.invites.fetch(code);
+    return new NovaInvite(raw, this.invites);
+  }
+  /**
+   * Fetch all webhooks in a channel and return them as `NovaWebhook` wrappers.
+   *
+   * @example
+   * const webhooks = await client.fetchWebhooks('channel-id')
+   */
+  async fetchWebhooks(channelId) {
+    const list = await this.webhooks.list(channelId);
+    return list.map((raw) => new NovaWebhook(raw, this.webhooks));
+  }
+  /**
+   * Fetch a single webhook by ID and return it as a `NovaWebhook` wrapper.
+   *
+   * @example
+   * const webhook = await client.fetchWebhook('webhook-id')
+   * await webhook.execute({ content: 'Build passed! ✅' })
+   */
+  async fetchWebhook(webhookId) {
+    const raw = await this.webhooks.fetch(webhookId);
+    return new NovaWebhook(raw, this.webhooks);
+  }
   // ─── Event fence ──────────────────────────────────────────────────────────────
   /**
    * Wait for a specific event to be emitted, optionally filtered.
@@ -2978,6 +3740,7 @@ function countdown(target) {
 }
 export {
   ActionRowBuilder,
+  AuditLogAPI,
   ButtonBuilder,
   ChannelsAPI,
   Collection,
@@ -2988,6 +3751,7 @@ export {
   HttpClient,
   InteractionOptions,
   InteractionsAPI,
+  InvitesAPI,
   Logger,
   MembersAPI,
   MessageBuilder,
@@ -2996,19 +3760,25 @@ export {
   NovaChannel,
   NovaClient,
   NovaInteraction,
+  NovaInvite,
   NovaMember,
   NovaMessage,
+  NovaRole,
+  NovaServerWrapper,
+  NovaWebhook,
   Paginator,
   Permissions,
   PermissionsAPI,
   PermissionsBitfield,
   PollBuilder,
   ReactionsAPI,
+  RolesAPI,
   SelectMenuBuilder,
   ServersAPI,
   SlashCommandBuilder,
   SlashCommandOptionBuilder,
   TextInputBuilder,
+  WebhooksAPI,
   countdown,
   formatDuration,
   formatRelative,