novaapp-sdk 1.3.2 → 1.4.0

package/dist/index.d.ts

@@ -195,6 +195,19 @@ interface Interaction {
     values?: string[];
     /** For MODAL_SUBMIT interactions — field customId → submitted value. */
     modalData?: Record<string, string>;
+    /**
+     * For AUTOCOMPLETE interactions — the option being completed and the
+     * partial string the user has typed so far.
+     */
+    autocomplete?: {
+        name: string;
+        value: string;
+    };
+    /**
+     * For CONTEXT_MENU interactions — the ID of the message or user that was
+     * right-clicked.
+     */
+    contextTargetId?: string | null;
     userId: string;
     channelId: string;
     serverId?: string | null;
@@ -241,12 +254,22 @@ interface BotModalDefinition {
 interface SlashCommandOption {
     name: string;
     description: string;
-    type: 'STRING' | 'INTEGER' | 'BOOLEAN' | 'USER' | 'CHANNEL' | 'ROLE';
+    type: 'STRING' | 'INTEGER' | 'NUMBER' | 'BOOLEAN' | 'USER' | 'CHANNEL' | 'ROLE' | 'ATTACHMENT';
     required?: boolean;
+    /** Whether to enable autocomplete for this option. Mutually exclusive with `choices`. */
+    autocomplete?: boolean;
     choices?: Array<{
         name: string;
         value: string | number;
     }>;
+    /** Minimum value (for INTEGER / NUMBER types). */
+    minValue?: number;
+    /** Maximum value (for INTEGER / NUMBER types). */
+    maxValue?: number;
+    /** Minimum length (for STRING type). */
+    minLength?: number;
+    /** Maximum length (for STRING type). */
+    maxLength?: number;
 }
 interface SlashCommandDefinition {
     name: string;
@@ -292,7 +315,7 @@ interface RegisteredContextCommand {
     enabled: boolean;
     createdAt: string;
 }
-type BotEventType = 'message.created' | 'message.edited' | 'message.deleted' | 'message.reaction_added' | 'message.reaction_removed' | 'message.pinned' | 'user.joined_server' | 'user.left_server' | 'user.updated_profile' | 'user.banned' | 'user.unbanned' | 'user.role_added' | 'user.role_removed' | 'user.started_typing' | 'user.voice_joined' | 'user.voice_left' | 'interaction.slash_command' | 'interaction.button_click' | 'interaction.select_menu' | 'interaction.modal_submit' | 'interaction.autocomplete' | 'server.updated' | 'channel.created' | 'channel.deleted' | 'channel.updated' | 'role.created' | 'role.deleted';
+type BotEventType = 'message.created' | 'message.edited' | 'message.deleted' | 'message.reaction_added' | 'message.reaction_removed' | 'message.pinned' | 'user.joined_server' | 'user.left_server' | 'user.updated_profile' | 'user.banned' | 'user.unbanned' | 'user.role_added' | 'user.role_removed' | 'user.started_typing' | 'user.voice_joined' | 'user.voice_left' | 'interaction.slash_command' | 'interaction.button_click' | 'interaction.select_menu' | 'interaction.modal_submit' | 'interaction.autocomplete' | 'server.updated' | 'channel.created' | 'channel.deleted' | 'channel.updated' | 'role.created' | 'role.updated' | 'role.deleted';
 interface BotEvent<T = unknown> {
     type: BotEventType;
     data: T;
@@ -326,6 +349,10 @@ interface FetchMessagesOptions {
 }
 interface FetchMembersOptions {
     limit?: number;
+    /** Return members whose role matches this value. */
+    role?: 'OWNER' | 'ADMIN' | 'MEMBER';
+    /** Filter by partial username (case-insensitive). */
+    search?: string;
 }
 interface PollInteractionsOptions {
     limit?: number;
@@ -403,6 +430,103 @@ interface VoiceState {
     /** ISO timestamp when the user joined the voice channel. */
     joinedAt: string;
 }
+interface RoleCreateOptions {
+    name: string;
+    color?: string;
+    hoist?: boolean;
+    /**
+     * Permission flags to grant for this role.
+     * Any key not set retains its default value from the server.
+     */
+    permissions?: Partial<{
+        manageServer: boolean;
+        manageChannels: boolean;
+        manageRoles: boolean;
+        viewAuditLog: boolean;
+        createInvites: boolean;
+        manageWebhooks: boolean;
+        kickMembers: boolean;
+        banMembers: boolean;
+        timeoutMembers: boolean;
+        changeNickname: boolean;
+        manageNicknames: boolean;
+        muteMembers: boolean;
+        deafenMembers: boolean;
+        moveMembers: boolean;
+        sendMessages: boolean;
+        manageMessages: boolean;
+        embedLinks: boolean;
+        attachFiles: boolean;
+        addReactions: boolean;
+        mentionEveryone: boolean;
+        readMessageHistory: boolean;
+    }>;
+}
+type RoleEditOptions = Partial<RoleCreateOptions>;
+interface InviteCreateOptions {
+    /** Maximum number of times the invite can be used. `null` = unlimited. */
+    maxUses?: number | null;
+    /** ISO timestamp when the invite expires. `null` = never expires. */
+    expiresAt?: string | null;
+}
+interface Webhook {
+    id: string;
+    serverId: string;
+    channelId: string;
+    name: string;
+    /** A secret token used to post messages via this webhook. */
+    token: string;
+    createdAt: string;
+}
+interface WebhookCreateOptions {
+    /** Display name shown when the webhook posts a message. */
+    name: string;
+}
+interface WebhookEditOptions {
+    /** New display name for the webhook. */
+    name?: string;
+    /** Move the webhook to a different text channel. */
+    channelId?: string;
+}
+interface ExecuteWebhookOptions {
+    content?: string;
+    embed?: Embed;
+    /** Override the default display name for this execution. */
+    username?: string;
+}
+type AuditLogAction = 'member.kicked' | 'member.banned' | 'member.unbanned' | 'member.role_added' | 'member.role_removed' | 'message.deleted' | 'message.pinned' | 'message.unpinned' | 'channel.created' | 'channel.updated' | 'channel.deleted' | 'role.created' | 'role.updated' | 'role.deleted' | 'invite.created' | 'invite.deleted' | 'webhook.created' | 'webhook.updated' | 'webhook.deleted' | 'server.updated' | string;
+interface AuditLogEntry {
+    id: string;
+    serverId: string;
+    action: AuditLogAction;
+    /** The user who performed the action. */
+    actorId: string;
+    actorName: string;
+    /** The entity affected (user, channel, role, etc.). */
+    targetId: string | null;
+    targetName: string | null;
+    /** Extra context (old/new values, reason, etc.). */
+    metadata: Record<string, unknown> | null;
+    createdAt: string;
+}
+interface FetchAuditLogsOptions {
+    limit?: number;
+    /** Only return entries for a specific action type. */
+    action?: AuditLogAction;
+    /** Only return entries targeting a specific user ID. */
+    userId?: string;
+    before?: string;
+}
+interface ServerUpdateOptions {
+    name?: string;
+    description?: string;
+    icon?: string | null;
+}
+/** Extended member object returned when fetching a single member by user ID. */
+interface SingleMember extends Member {
+    /** The custom role assigned to this member, if any. */
+    customRole: Role | null;
+}
 interface NovaClientOptions {
     /** Your bot token — starts with "nova_bot_" */
     token: string;
@@ -585,11 +709,24 @@ declare class MembersAPI {
     constructor(http: HttpClient);
     /**
      * 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: string, options?: FetchMembersOptions): Promise<Member[]>;
+    /**
+     * 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: string, userId: string): Promise<SingleMember>;
     /**
      * Kick a member from a server.
      * Bots cannot kick owners or admins (403 will be thrown).
@@ -673,6 +810,23 @@ declare class ServersAPI {
      * console.log(`Bot is in ${servers.length} servers`)
      */
     list(): Promise<NovaServer[]>;
+    /**
+     * 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: string): Promise<NovaServer>;
+    /**
+     * 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: string, options: ServerUpdateOptions): Promise<NovaServer>;
     /**
      * Fetch all roles in a server.
      * Results are sorted by position (lowest first).
@@ -716,6 +870,26 @@ declare class InteractionsAPI {
         ok: true;
         ephemeral: true;
     }>;
+    /**
+     * 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: string, choices: Array<{
+        name: string;
+        value: string | number;
+    }>): Promise<{
+        ok: true;
+    }>;
     /**
      * Poll for pending (unacknowledged) interactions.
      * Useful when not using the WebSocket gateway.
@@ -945,6 +1119,201 @@ declare class ReactionsAPI {
     fetchEmoji(messageId: string, emoji: string): Promise<ReactionDetail>;
 }
 
+declare class RolesAPI {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * 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: string): Promise<Role[]>;
+    /**
+     * 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: string, options: RoleCreateOptions): Promise<Role>;
+    /**
+     * Edit an existing role.
+     * Requires the `roles.manage` scope.
+     *
+     * @example
+     * await client.roles.edit('role-id', { color: '#ff0000', name: 'Danger' })
+     */
+    edit(roleId: string, options: RoleEditOptions): Promise<Role>;
+    /**
+     * 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: string): Promise<{
+        ok: true;
+    }>;
+    /**
+     * 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: string, userId: string, roleId: string): Promise<{
+        ok: true;
+    }>;
+    /**
+     * 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: string, userId: string, roleId: string): Promise<{
+        ok: true;
+    }>;
+}
+
+declare class InvitesAPI {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * List all active invites for a server.
+     *
+     * @example
+     * const invites = await client.invites.list('server-id')
+     * console.log(`${invites.length} active invites`)
+     */
+    list(serverId: string): Promise<Invite[]>;
+    /**
+     * 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: string, options?: InviteCreateOptions): Promise<Invite>;
+    /**
+     * Fetch a single invite by its code.
+     *
+     * @example
+     * const invite = await client.invites.fetch('abc123')
+     * console.log(`${invite.uses} / ${invite.maxUses ?? '∞'} uses`)
+     */
+    fetch(code: string): Promise<Invite>;
+    /**
+     * Revoke (delete) an invite.
+     * Requires the `invites.manage` scope.
+     *
+     * @example
+     * await client.invites.revoke('abc123')
+     */
+    revoke(code: string): Promise<{
+        ok: true;
+    }>;
+}
+
+declare class WebhooksAPI {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * List all webhooks in a channel.
+     * Requires the `webhooks.manage` scope.
+     *
+     * @example
+     * const webhooks = await client.webhooks.list('channel-id')
+     */
+    list(channelId: string): Promise<Webhook[]>;
+    /**
+     * 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: string, options: WebhookCreateOptions): Promise<Webhook>;
+    /**
+     * Fetch a webhook by its ID.
+     * Requires the `webhooks.manage` scope.
+     *
+     * @example
+     * const webhook = await client.webhooks.fetch('webhook-id')
+     */
+    fetch(webhookId: string): Promise<Webhook>;
+    /**
+     * 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: string, options: WebhookEditOptions): Promise<Webhook>;
+    /**
+     * Delete a webhook.
+     * Requires the `webhooks.manage` scope.
+     *
+     * @example
+     * await client.webhooks.delete('webhook-id')
+     */
+    delete(webhookId: string): Promise<{
+        ok: true;
+    }>;
+    /**
+     * 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: string, options: ExecuteWebhookOptions): Promise<Message>;
+}
+
+declare class AuditLogAPI {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * 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: string, options?: FetchAuditLogsOptions): Promise<AuditLogEntry[]>;
+}
+
 type TextInputStyle = 'short' | 'paragraph';
 /**
  * Fluent builder for a single text-input field inside a modal.
@@ -1130,6 +1499,21 @@ declare class NovaInteraction {
      */
     readonly options: InteractionOptions;
     constructor(_raw: Interaction, _api: InteractionsAPI);
+    /**
+     * 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(): {
+        name: string;
+        value: string;
+    } | null;
     /** `true` when triggered by a `/slash` command. */
     isSlashCommand(): boolean;
     /** `true` when triggered by a `!prefix` command. */
@@ -1144,6 +1528,24 @@ declare class NovaInteraction {
     isModalSubmit(): boolean;
     /** `true` during autocomplete suggestion requests. */
     isAutocomplete(): boolean;
+    /**
+     * 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: Array<{
+        name: string;
+        value: string | number;
+    }>): Promise<{
+        ok: true;
+    }>;
     /** `true` when triggered via a context-menu command. */
     isContextMenu(): boolean;
     /**
@@ -1562,6 +1964,304 @@ declare class NovaMember {
     toJSON(): Member;
 }
 
+/**
+ * A rich wrapper around a raw `Role` with convenience methods.
+ *
+ * Returned by `client.fetchRole()` and `client.fetchRoles()`.
+ *
+ * @example
+ * const roles = await client.fetchRoles('server-id')
+ * const mod = roles.find(r => r.name === 'Moderator')
+ * if (mod) await mod.assign('user-id')
+ */
+declare class NovaRole {
+    /** Unique role ID. */
+    readonly id: string;
+    /** Display name of the role. */
+    readonly name: string;
+    /** Hex colour string (e.g. `'#00d4ff'`), or `null` for no colour. */
+    readonly color: string | null;
+    /** Sort position — lower numbers appear higher in the role list. */
+    readonly position: number;
+    /** The server this role belongs to. */
+    readonly serverId: string;
+    /** Whether this role is displayed separately in the member sidebar. */
+    readonly hoist: boolean;
+    /** When the role was created. */
+    readonly createdAt: Date;
+    private readonly _roles;
+    constructor(raw: Role, roles: RolesAPI);
+    /**
+     * Edit this role's name, colour, hoist flag, or permissions.
+     *
+     * @example
+     * await role.edit({ color: '#ff0000', name: 'Red Team' })
+     */
+    edit(options: RoleEditOptions): Promise<Role>;
+    /**
+     * Delete this role from the server.
+     * Any members currently assigned this role will have it removed.
+     *
+     * @example
+     * await role.delete()
+     */
+    delete(): Promise<{
+        ok: true;
+    }>;
+    /**
+     * Assign this role to a server member.
+     *
+     * @example
+     * await role.assign('user-id')
+     */
+    assign(userId: string): Promise<{
+        ok: true;
+    }>;
+    /**
+     * Remove this role from a server member.
+     *
+     * @example
+     * await role.remove('user-id')
+     */
+    remove(userId: string): Promise<{
+        ok: true;
+    }>;
+    /** Returns `true` if the role has a custom hex colour set. */
+    hasColor(): boolean;
+    /** Returns the CSS-safe hex colour string. Falls back to `'#99aab5'` (grey). */
+    toHex(): string;
+    toJSON(): Role;
+}
+
+/**
+ * A rich wrapper around a raw `NovaServer` with convenience methods.
+ *
+ * Returned by `client.fetchServer()` and `client.fetchServers()`.
+ *
+ * @example
+ * const server = await client.fetchServer('server-id')
+ * console.log(`${server.name} — ${server.memberCount} members`)
+ * await server.send('welcome-channel-id', 'Bot is online! 🤖')
+ */
+declare class NovaServerWrapper {
+    /** Unique server ID. */
+    readonly id: string;
+    /** Server display name. */
+    readonly name: string;
+    /** URL to the server icon, or `null`. */
+    readonly icon: string | null;
+    /** Short description of the server, or `null`. */
+    readonly description: string | null;
+    /** Total member count at time of fetch. */
+    readonly memberCount: number;
+    /** Total channel count at time of fetch. */
+    readonly channelCount: number;
+    /** When the bot joined this server. */
+    readonly joinedAt: Date;
+    private readonly _servers;
+    private readonly _channels;
+    private readonly _members;
+    private readonly _invites;
+    private readonly _roles;
+    private readonly _messages;
+    constructor(raw: NovaServer, servers: ServersAPI, channels: ChannelsAPI, members: MembersAPI, invites: InvitesAPI, roles: RolesAPI, messages: MessagesAPI);
+    /**
+     * Update this server's name, description, or icon.
+     * Requires the `server.manage` scope.
+     *
+     * @example
+     * await server.update({ name: 'New Name' })
+     */
+    update(options: ServerUpdateOptions): Promise<NovaServer>;
+    /**
+     * Fetch all channels in this server.
+     *
+     * @example
+     * const channels = await server.fetchChannels()
+     * const text = channels.filter(c => c.type === 'TEXT')
+     */
+    fetchChannels(): Promise<Channel[]>;
+    /**
+     * 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: CreateChannelOptions): Promise<Channel>;
+    /**
+     * Fetch members in this server.
+     *
+     * @example
+     * const members = await server.fetchMembers({ limit: 100 })
+     */
+    fetchMembers(options?: FetchMembersOptions): Promise<Member[]>;
+    /**
+     * Fetch a single member by user ID.
+     *
+     * @example
+     * const member = await server.fetchMember('user-id')
+     */
+    fetchMember(userId: string): ReturnType<MembersAPI['fetch']>;
+    /**
+     * Kick a member from this server.
+     *
+     * @example
+     * await server.kick('user-id')
+     */
+    kick(userId: string): Promise<{
+        ok: true;
+    }>;
+    /**
+     * Ban a member from this server.
+     *
+     * @example
+     * await server.ban('user-id', 'Spamming')
+     */
+    ban(userId: string, reason?: string): Promise<{
+        ok: true;
+    }>;
+    /**
+     * Fetch the ban list for this server.
+     */
+    fetchBans(): Promise<BanEntry[]>;
+    /**
+     * Fetch all custom roles in this server.
+     *
+     * @example
+     * const roles = await server.fetchRoles()
+     */
+    fetchRoles(): Promise<Role[]>;
+    /**
+     * Fetch all active invites for this server.
+     *
+     * @example
+     * const invites = await server.fetchInvites()
+     */
+    fetchInvites(): Promise<Invite[]>;
+    /**
+     * Create an invite for this server.
+     *
+     * @example
+     * const invite = await server.createInvite({ maxUses: 10 })
+     * console.log(`https://novachatapp.com/invite/${invite.code}`)
+     */
+    createInvite(options?: InviteCreateOptions): Promise<Invite>;
+    /**
+     * Send a message to a channel in this server by channel ID.
+     *
+     * @example
+     * await server.send('channel-id', 'Hello, server!')
+     */
+    send(channelId: string, content: string): ReturnType<MessagesAPI['send']>;
+    toJSON(): NovaServer;
+}
+
+/**
+ * A rich wrapper around a raw `Invite` with convenience methods.
+ *
+ * Returned by `client.fetchInvite()` and `client.fetchInvites()`.
+ *
+ * @example
+ * const invite = await client.fetchInvite('abc123')
+ * if (invite.isExpired()) await invite.revoke()
+ */
+declare class NovaInvite {
+    /** The invite code — appended to `https://novachatapp.com/invite/`. */
+    readonly code: string;
+    /** The server this invite grants access to. */
+    readonly serverId: string;
+    /** The user ID of whoever created this invite. */
+    readonly creatorId: string;
+    /** How many times this invite has been used. */
+    readonly uses: number;
+    /** Maximum allowed uses before the invite deactivates. `null` = unlimited. */
+    readonly maxUses: number | null;
+    /** When the invite expires. `null` = never expires. */
+    readonly expiresAt: Date | null;
+    /** When the invite was created. */
+    readonly createdAt: Date;
+    private readonly _invites;
+    constructor(raw: Invite, invites: InvitesAPI);
+    /** The full URL users can follow to join the server. */
+    get url(): string;
+    /**
+     * Returns `true` if the invite has passed its expiry time.
+     * Always `false` for invites with no expiry.
+     */
+    isExpired(): boolean;
+    /**
+     * Returns `true` if the invite has reached its maximum use count.
+     * Always `false` for unlimited invites.
+     */
+    isExhausted(): boolean;
+    /** Whether this invite is still usable (not expired and not exhausted). */
+    isValid(): boolean;
+    /**
+     * Revoke (delete) this invite, making the code unusable.
+     * Requires the `invites.manage` scope.
+     *
+     * @example
+     * await invite.revoke()
+     */
+    revoke(): Promise<{
+        ok: true;
+    }>;
+    toJSON(): Invite;
+}
+
+/**
+ * A rich wrapper around a raw `Webhook` with convenience methods.
+ *
+ * Returned by `client.fetchWebhook()` and `client.fetchWebhooks()`.
+ *
+ * @example
+ * const webhook = await client.fetchWebhook('webhook-id')
+ * await webhook.execute({ content: '🚀 Build passed!', username: 'CI Bot' })
+ */
+declare class NovaWebhook {
+    /** Unique webhook ID. */
+    readonly id: string;
+    /** The server this webhook belongs to. */
+    readonly serverId: string;
+    /** The channel messages are posted to when this webhook is executed. */
+    readonly channelId: string;
+    /** Display name shown next to messages posted via this webhook. */
+    readonly name: string;
+    /** Secret token — required to execute the webhook via HTTP. */
+    readonly token: string;
+    /** When the webhook was created. */
+    readonly createdAt: Date;
+    private readonly _webhooks;
+    constructor(raw: Webhook, webhooks: WebhooksAPI);
+    /**
+     * 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: WebhookEditOptions): Promise<Webhook>;
+    /**
+     * Delete this webhook.
+     * Requires the `webhooks.manage` scope.
+     *
+     * @example
+     * await webhook.delete()
+     */
+    delete(): Promise<{
+        ok: true;
+    }>;
+    /**
+     * Post a message via this webhook.
+     *
+     * @example
+     * await webhook.execute({ content: '❌ Tests failed on branch main', username: 'CI' })
+     */
+    execute(options: ExecuteWebhookOptions): Promise<Message>;
+    toJSON(): Webhook;
+}
+
 interface NovaClientEvents {
     /** Fired when the bot connects and is identified by the gateway. */
     ready: (bot: BotApplication) => void;
@@ -1569,8 +2269,8 @@ interface NovaClientEvents {
     event: (event: BotEvent) => void;
     /**
      * Fired when an interaction is received (slash command, button click, etc.).
-     * Use `client.command()`, `client.button()`, or `client.selectMenu()` for
-     * convenient routing instead of handling everything here.
+     * Use `client.command()`, `client.button()`, `client.selectMenu()`, or
+     * `client.autocomplete()` for convenient routing instead of handling everything here.
      */
     interactionCreate: (interaction: NovaInteraction) => void;
     /** Fired when the WebSocket connection drops. */
@@ -1635,15 +2335,9 @@ interface NovaClientEvents {
         serverId: string;
     }) => void;
     /** A role was created in a server. */
-    roleCreate: (data: {
-        id: string;
-        name: string;
-        color: string | null;
-        serverId: string;
-        position: number;
-        hoist: boolean;
-        createdAt: string;
-    }) => void;
+    roleCreate: (role: Role) => void;
+    /** A role was updated. */
+    roleUpdate: (role: Role) => void;
     /** A role was deleted. */
     roleDelete: (data: {
         id: string;
@@ -1673,11 +2367,36 @@ interface NovaClientEvents {
         userId: string;
         serverId: string;
     }) => void;
+    /** A member received or lost a custom role. */
+    memberRoleAdded: (data: {
+        serverId: string;
+        userId: string;
+        roleId: string;
+    }) => void;
+    memberRoleRemoved: (data: {
+        serverId: string;
+        userId: string;
+        roleId: string;
+    }) => void;
     /** A member's profile data was updated. */
     memberUpdate: (data: {
         userId: string;
         serverId: string;
     }) => void;
+    /** Server metadata (name, icon, etc.) was updated. */
+    serverUpdate: (data: {
+        id: string;
+        name?: string;
+        icon?: string | null;
+        description?: string | null;
+    }) => void;
+    /** An invite was created. */
+    inviteCreate: (invite: Invite) => void;
+    /** An invite was deleted/revoked. */
+    inviteDelete: (data: {
+        code: string;
+        serverId: string;
+    }) => void;
 }
 /**
  * The main Nova bot client.
@@ -1706,9 +2425,9 @@ declare class NovaClient extends EventEmitter {
     readonly messages: MessagesAPI;
     /** Register and manage slash, prefix, and context menu commands. */
     readonly commands: CommandsAPI;
-    /** List, kick and ban server members. */
+    /** List, kick, ban, and DM server members. */
     readonly members: MembersAPI;
-    /** List servers the bot is a member of. */
+    /** List and update servers the bot is a member of. */
     readonly servers: ServersAPI;
     /** Acknowledge and respond to interactions. */
     readonly interactions: InteractionsAPI;
@@ -1718,6 +2437,14 @@ declare class NovaClient extends EventEmitter {
     readonly channels: ChannelsAPI;
     /** Add, remove and fetch reactions on messages. */
     readonly reactions: ReactionsAPI;
+    /** Create, edit, delete and assign custom roles. */
+    readonly roles: RolesAPI;
+    /** Create, fetch and revoke server invites. */
+    readonly invites: InvitesAPI;
+    /** Create, edit, delete and execute webhooks. */
+    readonly webhooks: WebhooksAPI;
+    /** Fetch server audit logs. */
+    readonly auditLog: AuditLogAPI;
     private socket;
     private readonly http;
     private readonly options;
@@ -1726,6 +2453,7 @@ declare class NovaClient extends EventEmitter {
     private readonly _buttonHandlers;
     private readonly _selectHandlers;
     private readonly _modalHandlers;
+    private readonly _autocompleteHandlers;
     constructor(options: NovaClientOptions);
     /**
      * Register a handler for a slash or prefix command by name.
@@ -1767,6 +2495,23 @@ declare class NovaClient extends EventEmitter {
      * })
      */
     modal(customId: string, handler: (interaction: NovaInteraction) => unknown): 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: string, handler: (interaction: NovaInteraction) => unknown): this;
     /**
      * Connect to the Nova WebSocket gateway.
      * Resolves when the `ready` event is received.
@@ -1828,13 +2573,68 @@ declare class NovaClient extends EventEmitter {
     fetchMembers(serverId: string): Promise<NovaMember[]>;
     /**
      * 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!')
      */
     fetchMember(serverId: string, userId: string): Promise<NovaMember>;
+    /**
+     * 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`)
+     */
+    fetchServer(serverId: string): Promise<NovaServerWrapper>;
+    /**
+     * 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)
+     */
+    fetchServers(): Promise<NovaServerWrapper[]>;
+    /**
+     * 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')
+     */
+    fetchRoles(serverId: string): Promise<NovaRole[]>;
+    /**
+     * 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())
+     */
+    fetchInvites(serverId: string): Promise<NovaInvite[]>;
+    /**
+     * 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()
+     */
+    fetchInvite(code: string): Promise<NovaInvite>;
+    /**
+     * Fetch all webhooks in a channel and return them as `NovaWebhook` wrappers.
+     *
+     * @example
+     * const webhooks = await client.fetchWebhooks('channel-id')
+     */
+    fetchWebhooks(channelId: string): Promise<NovaWebhook[]>;
+    /**
+     * 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! ✅' })
+     */
+    fetchWebhook(webhookId: string): Promise<NovaWebhook>;
     /**
      * Wait for a specific event to be emitted, optionally filtered.
      * Rejects after `timeoutMs` (default 30 s) if the condition never fires.
@@ -2853,4 +3653,4 @@ declare function countdown(target: Date | number | string): {
     total: number;
 };
 
-export { ActionRowBuilder, type Attachment, type BanEntry, type BotApplication, type BotEvent, type BotEventType, type BotModalDefinition, type BotModalField, type BotPermissionRecord, type BotStatus, type BotUser, ButtonBuilder, type ButtonStyle, type Channel, type ChannelType, ChannelsAPI, Collection, CommandsAPI, type ContextCommandDefinition, Cooldown, CooldownManager, type CreateChannelOptions, type DirectMessage, type EditChannelOptions, type EditMessageOptions, type Embed, EmbedBuilder, type EmbedField, type FetchChannelsOptions, type FetchMembersOptions, type FetchMessagesOptions, HttpClient, type Interaction, InteractionOptions, type InteractionType, InteractionsAPI, type Invite, Logger, type Member, MembersAPI, type Message, MessageBuilder, type MessageComponent, MessagesAPI, ModalBuilder, NovaChannel, NovaClient, type NovaClientEvents, type NovaClientOptions, NovaInteraction, NovaMember, NovaMessage, type NovaServer, Paginator, type PermissionKey, Permissions, PermissionsAPI, PermissionsBitfield, type PermissionsQueryOptions, type PermissionsResult, PollBuilder, type PollDefinition, type PollInteractionsOptions, type PollOption, type PrefixCommandDefinition, type Reaction, type ReactionDetail, ReactionsAPI, type RegisteredContextCommand, type RegisteredPrefixCommand, type RegisteredSlashCommand, type RespondInteractionOptions, type Role, SelectMenuBuilder, type SelectMenuOption, type SendMessageOptions, ServersAPI, SlashCommandBuilder, type SlashCommandDefinition, type SlashCommandOption, SlashCommandOptionBuilder, TextInputBuilder, type TextInputStyle, type VoiceState, countdown, formatDuration, formatRelative, parseTimestamp, sleep, withTimeout };
+export { ActionRowBuilder, type Attachment, AuditLogAPI, type AuditLogAction, type AuditLogEntry, type BanEntry, type BotApplication, type BotEvent, type BotEventType, type BotModalDefinition, type BotModalField, type BotPermissionRecord, type BotStatus, type BotUser, ButtonBuilder, type ButtonStyle, type Channel, type ChannelType, ChannelsAPI, Collection, CommandsAPI, type ContextCommandDefinition, Cooldown, CooldownManager, type CreateChannelOptions, type DirectMessage, type EditChannelOptions, type EditMessageOptions, type Embed, EmbedBuilder, type EmbedField, type ExecuteWebhookOptions, type FetchAuditLogsOptions, type FetchChannelsOptions, type FetchMembersOptions, type FetchMessagesOptions, HttpClient, type Interaction, InteractionOptions, type InteractionType, InteractionsAPI, type Invite, type InviteCreateOptions, InvitesAPI, Logger, type Member, MembersAPI, type Message, MessageBuilder, type MessageComponent, MessagesAPI, ModalBuilder, NovaChannel, NovaClient, type NovaClientEvents, type NovaClientOptions, NovaInteraction, NovaInvite, NovaMember, NovaMessage, NovaRole, type NovaServer, NovaServerWrapper, NovaWebhook, Paginator, type PermissionKey, Permissions, PermissionsAPI, PermissionsBitfield, type PermissionsQueryOptions, type PermissionsResult, PollBuilder, type PollDefinition, type PollInteractionsOptions, type PollOption, type PrefixCommandDefinition, type Reaction, type ReactionDetail, ReactionsAPI, type RegisteredContextCommand, type RegisteredPrefixCommand, type RegisteredSlashCommand, type RespondInteractionOptions, type Role, type RoleCreateOptions, type RoleEditOptions, RolesAPI, SelectMenuBuilder, type SelectMenuOption, type SendMessageOptions, type ServerUpdateOptions, ServersAPI, type SingleMember, SlashCommandBuilder, type SlashCommandDefinition, type SlashCommandOption, SlashCommandOptionBuilder, TextInputBuilder, type TextInputStyle, type VoiceState, type Webhook, type WebhookCreateOptions, type WebhookEditOptions, WebhooksAPI, countdown, formatDuration, formatRelative, parseTimestamp, sleep, withTimeout };