novaapp-sdk 1.0.7 → 1.0.10

package/dist/index.d.mts

@@ -128,12 +128,53 @@ interface Interaction {
     commandName?: string | null;
     customId?: string | null;
     data?: unknown;
+    /** For SELECT_MENU interactions — the chosen option values. */
+    values?: string[];
+    /** For MODAL_SUBMIT interactions — field customId → submitted value. */
+    modalData?: Record<string, string>;
     userId: string;
     channelId: string;
     serverId?: string | null;
     triggerMsgId?: string | null;
     createdAt: string;
 }
+/** A single text input field inside a bot modal. */
+interface BotModalField {
+    /** Unique field ID — returned as key in `modalData` on MODAL_SUBMIT. */
+    customId: string;
+    /** Label displayed above the input. */
+    label: string;
+    /** `'short'` = single-line input, `'paragraph'` = multi-line textarea. */
+    type: 'short' | 'paragraph';
+    placeholder?: string;
+    required?: boolean;
+    minLength?: number;
+    maxLength?: number;
+    /** Optional pre-filled default value. */
+    value?: string;
+}
+/**
+ * Pass this as `modal` inside `client.interactions.respond()` to open a
+ * modal dialog on the user's client instead of sending a message.
+ *
+ * @example
+ * await client.interactions.respond(interaction.id, {
+ *   modal: {
+ *     title: 'Submit a report',
+ *     customId: 'report_modal',
+ *     fields: [
+ *       { customId: 'reason', label: 'Reason', type: 'paragraph', required: true },
+ *     ],
+ *   },
+ * })
+ */
+interface BotModalDefinition {
+    /** Title shown at the top of the modal dialog. */
+    title: string;
+    /** Custom ID passed back with the MODAL_SUBMIT interaction. */
+    customId: string;
+    fields: BotModalField[];
+}
 interface SlashCommandOption {
     name: string;
     description: string;
@@ -210,6 +251,11 @@ interface RespondInteractionOptions {
     embed?: Embed;
     components?: MessageComponent[];
     ephemeral?: boolean;
+    /**
+     * Open a modal dialog on the user's client instead of sending a message.
+     * When set, all other fields are ignored.
+     */
+    modal?: BotModalDefinition;
 }
 interface FetchMessagesOptions {
     limit?: number;
@@ -222,6 +268,39 @@ interface PollInteractionsOptions {
     limit?: number;
     since?: string;
 }
+/** A raw permission record stored for a specific scope (server, role, or channel). */
+interface BotPermissionRecord {
+    id: string;
+    botId: string;
+    serverId: string;
+    /** `null` means this record is server-wide (not channel-scoped). */
+    channelId: string | null;
+    /** `null` means this record applies to all roles. */
+    roleId: string | null;
+    /** Key-value map of permission name → granted flag. */
+    permissions: Record<string, boolean>;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Response from `client.permissions.get()`. */
+interface PermissionsResult {
+    /**
+     * Merged, effective permissions for the requested scope.
+     * Merging order (highest wins): channel > role > server-wide.
+     */
+    permissions: Record<string, boolean>;
+    /** All raw permission records matching the query scope. */
+    records: BotPermissionRecord[];
+}
+/** Options accepted by `client.permissions.get()`. */
+interface PermissionsQueryOptions {
+    /** The server to query permissions for (required). */
+    serverId: string;
+    /** Narrow the scope to a specific channel. */
+    channelId?: string;
+    /** Narrow the scope to a specific role. */
+    roleId?: string;
+}
 interface NovaClientOptions {
     /** Your bot token — starts with "nova_bot_" */
     token: string;
@@ -419,7 +498,8 @@ declare class ServersAPI {
 
 declare class InteractionsAPI {
     private readonly http;
-    constructor(http: HttpClient);
+    private readonly emitter;
+    constructor(http: HttpClient, emitter: EventEmitter);
     /**
      * Acknowledge an interaction without sending a visible response.
      * Shows a loading state to the user. You must follow up with `respond()`.
@@ -459,6 +539,84 @@ declare class InteractionsAPI {
      * }
      */
     poll(options?: PollInteractionsOptions): Promise<Interaction[]>;
+    /**
+     * Open a modal for the user who triggered an interaction and await their submission.
+     *
+     * Internally this:
+     *  1. Calls `respond(interactionId, { modal })` to push the modal to the client UI.
+     *  2. Listens for the next `interactionCreate` event whose type is `MODAL_SUBMIT`
+     *     and whose `customId` matches your modal's `customId`.
+     *  3. Resolves with the submitted `Interaction` (containing `modalData`), or `null`
+     *     if the user closes the modal without submitting within the timeout.
+     *
+     * @param interactionId - ID of the triggering interaction.
+     * @param modal         - Modal definition (title, customId, fields).
+     * @param options.timeout - Max milliseconds to wait (default: 300 000 = 5 min).
+     *
+     * @example
+     * client.on('interactionCreate', async (interaction) => {
+     *   if (interaction.commandName === 'report') {
+     *     const submitted = await client.interactions.awaitModal(interaction.id, {
+     *       title: 'Submit a report',
+     *       customId: 'report_modal',
+     *       fields: [
+     *         { customId: 'reason', label: 'Reason', type: 'paragraph', required: true, maxLength: 500 },
+     *       ],
+     *     })
+     *
+     *     if (!submitted) {
+     *       // User dismissed the modal or timed out — nothing to do
+     *       return
+     *     }
+     *
+     *     const reason = submitted.modalData?.reason
+     *     await client.interactions.respond(submitted.id, {
+     *       content: `Report received: ${reason}`,
+     *       ephemeral: true,
+     *     })
+     *   }
+     * })
+     */
+    awaitModal(interactionId: string, modal: BotModalDefinition, options?: {
+        timeout?: number;
+    }): Promise<Interaction | null>;
+}
+
+declare class PermissionsAPI {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Fetch the bot's effective permissions for a given scope.
+     *
+     * Permissions are merged in priority order:
+     * 1. Server-wide base permissions
+     * 2. Role override (if `roleId` provided)
+     * 3. Channel override (if `channelId` provided, highest priority)
+     *
+     * `serverId` is required. `channelId` and `roleId` are optional filters.
+     *
+     * @example
+     * // Effective server-wide permissions
+     * const { permissions } = await client.permissions.get({
+     *   serverId: 'server-id',
+     * })
+     * console.log(permissions) // { kick_members: true, ban_members: false, ... }
+     *
+     * @example
+     * // Scoped to a specific channel
+     * const { permissions } = await client.permissions.get({
+     *   serverId: 'server-id',
+     *   channelId: 'channel-id',
+     * })
+     *
+     * @example
+     * // Scoped to a specific role
+     * const { permissions } = await client.permissions.get({
+     *   serverId: 'server-id',
+     *   roleId: 'role-id',
+     * })
+     */
+    get(options: PermissionsQueryOptions): Promise<PermissionsResult>;
 }
 
 /**
@@ -494,6 +652,8 @@ declare class NovaClient extends EventEmitter {
     readonly servers: ServersAPI;
     /** Acknowledge and respond to interactions. */
     readonly interactions: InteractionsAPI;
+    /** Query the bot's effective permissions within a server, channel, or role scope. */
+    readonly permissions: PermissionsAPI;
     private socket;
     private readonly http;
     private readonly options;
@@ -536,4 +696,4 @@ declare class NovaClient extends EventEmitter {
     emit(event: string | symbol, ...args: unknown[]): boolean;
 }
 
-export { type Attachment, type BotApplication, type BotEvent, type BotEventType, type BotUser, CommandsAPI, type ContextCommandDefinition, type EditMessageOptions, type Embed, type EmbedField, type FetchMembersOptions, type FetchMessagesOptions, HttpClient, type Interaction, type InteractionType, InteractionsAPI, type Member, MembersAPI, type Message, type MessageComponent, MessagesAPI, NovaClient, type NovaClientEvents, type NovaClientOptions, type NovaServer, type PollInteractionsOptions, type PrefixCommandDefinition, type Reaction, type RegisteredContextCommand, type RegisteredPrefixCommand, type RegisteredSlashCommand, type RespondInteractionOptions, type SendMessageOptions, ServersAPI, type SlashCommandDefinition, type SlashCommandOption };
+export { type Attachment, type BotApplication, type BotEvent, type BotEventType, type BotModalDefinition, type BotModalField, type BotPermissionRecord, type BotUser, CommandsAPI, type ContextCommandDefinition, type EditMessageOptions, type Embed, type EmbedField, type FetchMembersOptions, type FetchMessagesOptions, HttpClient, type Interaction, type InteractionType, InteractionsAPI, type Member, MembersAPI, type Message, type MessageComponent, MessagesAPI, NovaClient, type NovaClientEvents, type NovaClientOptions, type NovaServer, PermissionsAPI, type PermissionsQueryOptions, type PermissionsResult, type PollInteractionsOptions, type PrefixCommandDefinition, type Reaction, type RegisteredContextCommand, type RegisteredPrefixCommand, type RegisteredSlashCommand, type RespondInteractionOptions, type SendMessageOptions, ServersAPI, type SlashCommandDefinition, type SlashCommandOption };

package/dist/index.d.ts

@@ -128,12 +128,53 @@ interface Interaction {
     commandName?: string | null;
     customId?: string | null;
     data?: unknown;
+    /** For SELECT_MENU interactions — the chosen option values. */
+    values?: string[];
+    /** For MODAL_SUBMIT interactions — field customId → submitted value. */
+    modalData?: Record<string, string>;
     userId: string;
     channelId: string;
     serverId?: string | null;
     triggerMsgId?: string | null;
     createdAt: string;
 }
+/** A single text input field inside a bot modal. */
+interface BotModalField {
+    /** Unique field ID — returned as key in `modalData` on MODAL_SUBMIT. */
+    customId: string;
+    /** Label displayed above the input. */
+    label: string;
+    /** `'short'` = single-line input, `'paragraph'` = multi-line textarea. */
+    type: 'short' | 'paragraph';
+    placeholder?: string;
+    required?: boolean;
+    minLength?: number;
+    maxLength?: number;
+    /** Optional pre-filled default value. */
+    value?: string;
+}
+/**
+ * Pass this as `modal` inside `client.interactions.respond()` to open a
+ * modal dialog on the user's client instead of sending a message.
+ *
+ * @example
+ * await client.interactions.respond(interaction.id, {
+ *   modal: {
+ *     title: 'Submit a report',
+ *     customId: 'report_modal',
+ *     fields: [
+ *       { customId: 'reason', label: 'Reason', type: 'paragraph', required: true },
+ *     ],
+ *   },
+ * })
+ */
+interface BotModalDefinition {
+    /** Title shown at the top of the modal dialog. */
+    title: string;
+    /** Custom ID passed back with the MODAL_SUBMIT interaction. */
+    customId: string;
+    fields: BotModalField[];
+}
 interface SlashCommandOption {
     name: string;
     description: string;
@@ -210,6 +251,11 @@ interface RespondInteractionOptions {
     embed?: Embed;
     components?: MessageComponent[];
     ephemeral?: boolean;
+    /**
+     * Open a modal dialog on the user's client instead of sending a message.
+     * When set, all other fields are ignored.
+     */
+    modal?: BotModalDefinition;
 }
 interface FetchMessagesOptions {
     limit?: number;
@@ -222,6 +268,39 @@ interface PollInteractionsOptions {
     limit?: number;
     since?: string;
 }
+/** A raw permission record stored for a specific scope (server, role, or channel). */
+interface BotPermissionRecord {
+    id: string;
+    botId: string;
+    serverId: string;
+    /** `null` means this record is server-wide (not channel-scoped). */
+    channelId: string | null;
+    /** `null` means this record applies to all roles. */
+    roleId: string | null;
+    /** Key-value map of permission name → granted flag. */
+    permissions: Record<string, boolean>;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Response from `client.permissions.get()`. */
+interface PermissionsResult {
+    /**
+     * Merged, effective permissions for the requested scope.
+     * Merging order (highest wins): channel > role > server-wide.
+     */
+    permissions: Record<string, boolean>;
+    /** All raw permission records matching the query scope. */
+    records: BotPermissionRecord[];
+}
+/** Options accepted by `client.permissions.get()`. */
+interface PermissionsQueryOptions {
+    /** The server to query permissions for (required). */
+    serverId: string;
+    /** Narrow the scope to a specific channel. */
+    channelId?: string;
+    /** Narrow the scope to a specific role. */
+    roleId?: string;
+}
 interface NovaClientOptions {
     /** Your bot token — starts with "nova_bot_" */
     token: string;
@@ -419,7 +498,8 @@ declare class ServersAPI {
 
 declare class InteractionsAPI {
     private readonly http;
-    constructor(http: HttpClient);
+    private readonly emitter;
+    constructor(http: HttpClient, emitter: EventEmitter);
     /**
      * Acknowledge an interaction without sending a visible response.
      * Shows a loading state to the user. You must follow up with `respond()`.
@@ -459,6 +539,84 @@ declare class InteractionsAPI {
      * }
      */
     poll(options?: PollInteractionsOptions): Promise<Interaction[]>;
+    /**
+     * Open a modal for the user who triggered an interaction and await their submission.
+     *
+     * Internally this:
+     *  1. Calls `respond(interactionId, { modal })` to push the modal to the client UI.
+     *  2. Listens for the next `interactionCreate` event whose type is `MODAL_SUBMIT`
+     *     and whose `customId` matches your modal's `customId`.
+     *  3. Resolves with the submitted `Interaction` (containing `modalData`), or `null`
+     *     if the user closes the modal without submitting within the timeout.
+     *
+     * @param interactionId - ID of the triggering interaction.
+     * @param modal         - Modal definition (title, customId, fields).
+     * @param options.timeout - Max milliseconds to wait (default: 300 000 = 5 min).
+     *
+     * @example
+     * client.on('interactionCreate', async (interaction) => {
+     *   if (interaction.commandName === 'report') {
+     *     const submitted = await client.interactions.awaitModal(interaction.id, {
+     *       title: 'Submit a report',
+     *       customId: 'report_modal',
+     *       fields: [
+     *         { customId: 'reason', label: 'Reason', type: 'paragraph', required: true, maxLength: 500 },
+     *       ],
+     *     })
+     *
+     *     if (!submitted) {
+     *       // User dismissed the modal or timed out — nothing to do
+     *       return
+     *     }
+     *
+     *     const reason = submitted.modalData?.reason
+     *     await client.interactions.respond(submitted.id, {
+     *       content: `Report received: ${reason}`,
+     *       ephemeral: true,
+     *     })
+     *   }
+     * })
+     */
+    awaitModal(interactionId: string, modal: BotModalDefinition, options?: {
+        timeout?: number;
+    }): Promise<Interaction | null>;
+}
+
+declare class PermissionsAPI {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Fetch the bot's effective permissions for a given scope.
+     *
+     * Permissions are merged in priority order:
+     * 1. Server-wide base permissions
+     * 2. Role override (if `roleId` provided)
+     * 3. Channel override (if `channelId` provided, highest priority)
+     *
+     * `serverId` is required. `channelId` and `roleId` are optional filters.
+     *
+     * @example
+     * // Effective server-wide permissions
+     * const { permissions } = await client.permissions.get({
+     *   serverId: 'server-id',
+     * })
+     * console.log(permissions) // { kick_members: true, ban_members: false, ... }
+     *
+     * @example
+     * // Scoped to a specific channel
+     * const { permissions } = await client.permissions.get({
+     *   serverId: 'server-id',
+     *   channelId: 'channel-id',
+     * })
+     *
+     * @example
+     * // Scoped to a specific role
+     * const { permissions } = await client.permissions.get({
+     *   serverId: 'server-id',
+     *   roleId: 'role-id',
+     * })
+     */
+    get(options: PermissionsQueryOptions): Promise<PermissionsResult>;
 }
 
 /**
@@ -494,6 +652,8 @@ declare class NovaClient extends EventEmitter {
     readonly servers: ServersAPI;
     /** Acknowledge and respond to interactions. */
     readonly interactions: InteractionsAPI;
+    /** Query the bot's effective permissions within a server, channel, or role scope. */
+    readonly permissions: PermissionsAPI;
     private socket;
     private readonly http;
     private readonly options;
@@ -536,4 +696,4 @@ declare class NovaClient extends EventEmitter {
     emit(event: string | symbol, ...args: unknown[]): boolean;
 }
 
-export { type Attachment, type BotApplication, type BotEvent, type BotEventType, type BotUser, CommandsAPI, type ContextCommandDefinition, type EditMessageOptions, type Embed, type EmbedField, type FetchMembersOptions, type FetchMessagesOptions, HttpClient, type Interaction, type InteractionType, InteractionsAPI, type Member, MembersAPI, type Message, type MessageComponent, MessagesAPI, NovaClient, type NovaClientEvents, type NovaClientOptions, type NovaServer, type PollInteractionsOptions, type PrefixCommandDefinition, type Reaction, type RegisteredContextCommand, type RegisteredPrefixCommand, type RegisteredSlashCommand, type RespondInteractionOptions, type SendMessageOptions, ServersAPI, type SlashCommandDefinition, type SlashCommandOption };
+export { type Attachment, type BotApplication, type BotEvent, type BotEventType, type BotModalDefinition, type BotModalField, type BotPermissionRecord, type BotUser, CommandsAPI, type ContextCommandDefinition, type EditMessageOptions, type Embed, type EmbedField, type FetchMembersOptions, type FetchMessagesOptions, HttpClient, type Interaction, type InteractionType, InteractionsAPI, type Member, MembersAPI, type Message, type MessageComponent, MessagesAPI, NovaClient, type NovaClientEvents, type NovaClientOptions, type NovaServer, PermissionsAPI, type PermissionsQueryOptions, type PermissionsResult, type PollInteractionsOptions, type PrefixCommandDefinition, type Reaction, type RegisteredContextCommand, type RegisteredPrefixCommand, type RegisteredSlashCommand, type RespondInteractionOptions, type SendMessageOptions, ServersAPI, type SlashCommandDefinition, type SlashCommandOption };

package/dist/index.js

@@ -26,6 +26,7 @@ __export(index_exports, {
   MembersAPI: () => MembersAPI,
   MessagesAPI: () => MessagesAPI,
   NovaClient: () => NovaClient,
+  PermissionsAPI: () => PermissionsAPI,
   ServersAPI: () => ServersAPI
 });
 module.exports = __toCommonJS(index_exports);
@@ -272,8 +273,9 @@ var ServersAPI = class {
 
 // src/api/interactions.ts
 var InteractionsAPI = class {
-  constructor(http) {
+  constructor(http, emitter) {
     this.http = http;
+    this.emitter = emitter;
   }
   /**
    * Acknowledge an interaction without sending a visible response.
@@ -322,6 +324,115 @@ var InteractionsAPI = class {
     const qs = params.toString();
     return this.http.get(`/interactions${qs ? `?${qs}` : ""}`);
   }
+  /**
+   * Open a modal for the user who triggered an interaction and await their submission.
+   *
+   * Internally this:
+   *  1. Calls `respond(interactionId, { modal })` to push the modal to the client UI.
+   *  2. Listens for the next `interactionCreate` event whose type is `MODAL_SUBMIT`
+   *     and whose `customId` matches your modal's `customId`.
+   *  3. Resolves with the submitted `Interaction` (containing `modalData`), or `null`
+   *     if the user closes the modal without submitting within the timeout.
+   *
+   * @param interactionId - ID of the triggering interaction.
+   * @param modal         - Modal definition (title, customId, fields).
+   * @param options.timeout - Max milliseconds to wait (default: 300 000 = 5 min).
+   *
+   * @example
+   * client.on('interactionCreate', async (interaction) => {
+   *   if (interaction.commandName === 'report') {
+   *     const submitted = await client.interactions.awaitModal(interaction.id, {
+   *       title: 'Submit a report',
+   *       customId: 'report_modal',
+   *       fields: [
+   *         { customId: 'reason', label: 'Reason', type: 'paragraph', required: true, maxLength: 500 },
+   *       ],
+   *     })
+   *
+   *     if (!submitted) {
+   *       // User dismissed the modal or timed out — nothing to do
+   *       return
+   *     }
+   *
+   *     const reason = submitted.modalData?.reason
+   *     await client.interactions.respond(submitted.id, {
+   *       content: `Report received: ${reason}`,
+   *       ephemeral: true,
+   *     })
+   *   }
+   * })
+   */
+  awaitModal(interactionId, modal, options = {}) {
+    const ms = options.timeout ?? 3e5;
+    let listener = null;
+    let timer = null;
+    const waitPromise = new Promise((resolve) => {
+      timer = setTimeout(() => {
+        if (listener) this.emitter.off("interactionCreate", listener);
+        resolve(null);
+      }, ms);
+      listener = (interaction) => {
+        if (interaction.type === "MODAL_SUBMIT" && interaction.customId === modal.customId) {
+          if (timer) clearTimeout(timer);
+          if (listener) this.emitter.off("interactionCreate", listener);
+          resolve(interaction);
+        }
+      };
+      this.emitter.on("interactionCreate", listener);
+    });
+    return this.respond(interactionId, { modal }).then(
+      () => waitPromise,
+      (err) => {
+        if (timer) clearTimeout(timer);
+        if (listener) this.emitter.off("interactionCreate", listener);
+        return Promise.reject(err);
+      }
+    );
+  }
+};
+
+// src/api/permissions.ts
+var PermissionsAPI = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Fetch the bot's effective permissions for a given scope.
+   *
+   * Permissions are merged in priority order:
+   * 1. Server-wide base permissions
+   * 2. Role override (if `roleId` provided)
+   * 3. Channel override (if `channelId` provided, highest priority)
+   *
+   * `serverId` is required. `channelId` and `roleId` are optional filters.
+   *
+   * @example
+   * // Effective server-wide permissions
+   * const { permissions } = await client.permissions.get({
+   *   serverId: 'server-id',
+   * })
+   * console.log(permissions) // { kick_members: true, ban_members: false, ... }
+   *
+   * @example
+   * // Scoped to a specific channel
+   * const { permissions } = await client.permissions.get({
+   *   serverId: 'server-id',
+   *   channelId: 'channel-id',
+   * })
+   *
+   * @example
+   * // Scoped to a specific role
+   * const { permissions } = await client.permissions.get({
+   *   serverId: 'server-id',
+   *   roleId: 'role-id',
+   * })
+   */
+  get(options) {
+    const params = new URLSearchParams({ serverId: options.serverId });
+    if (options.channelId) params.set("channelId", options.channelId);
+    if (options.roleId) params.set("roleId", options.roleId);
+    return this.http.get(`/permissions?${params.toString()}`);
+  }
 };
 
 // src/client.ts
@@ -356,11 +467,12 @@ var NovaClient = class extends import_node_events.EventEmitter {
     this.commands = new CommandsAPI(this.http);
     this.members = new MembersAPI(this.http);
     this.servers = new ServersAPI(this.http);
-    this.interactions = new InteractionsAPI(this.http);
+    this.interactions = new InteractionsAPI(this.http, this);
+    this.permissions = new PermissionsAPI(this.http);
     this.on("error", () => {
     });
     const cleanup = () => this.disconnect();
-    process.once("exit", cleanup);
+    process.once("beforeExit", cleanup);
     process.once("SIGINT", () => {
       cleanup();
       process.exit(0);
@@ -430,12 +542,28 @@ var NovaClient = class extends import_node_events.EventEmitter {
    */
   disconnect() {
     if (this.socket) {
+      const sock = this.socket;
+      this.socket = null;
       try {
-        this.socket.io.reconnection(false);
+        sock.io.reconnection(false);
+      } catch {
+      }
+      try {
+        sock.io?.engine?.socket?.terminate?.();
+      } catch {
+      }
+      try {
+        sock.io?.engine?.socket?.destroy?.();
+      } catch {
+      }
+      try {
+        sock.io?.engine?.close?.();
+      } catch {
+      }
+      try {
+        sock.disconnect();
       } catch {
       }
-      this.socket.disconnect();
-      this.socket = null;
     }
   }
   /**
@@ -484,5 +612,6 @@ var NovaClient = class extends import_node_events.EventEmitter {
   MembersAPI,
   MessagesAPI,
   NovaClient,
+  PermissionsAPI,
   ServersAPI
 });

package/dist/index.mjs

@@ -240,8 +240,9 @@ var ServersAPI = class {
 
 // src/api/interactions.ts
 var InteractionsAPI = class {
-  constructor(http) {
+  constructor(http, emitter) {
     this.http = http;
+    this.emitter = emitter;
   }
   /**
    * Acknowledge an interaction without sending a visible response.
@@ -290,6 +291,115 @@ var InteractionsAPI = class {
     const qs = params.toString();
     return this.http.get(`/interactions${qs ? `?${qs}` : ""}`);
   }
+  /**
+   * Open a modal for the user who triggered an interaction and await their submission.
+   *
+   * Internally this:
+   *  1. Calls `respond(interactionId, { modal })` to push the modal to the client UI.
+   *  2. Listens for the next `interactionCreate` event whose type is `MODAL_SUBMIT`
+   *     and whose `customId` matches your modal's `customId`.
+   *  3. Resolves with the submitted `Interaction` (containing `modalData`), or `null`
+   *     if the user closes the modal without submitting within the timeout.
+   *
+   * @param interactionId - ID of the triggering interaction.
+   * @param modal         - Modal definition (title, customId, fields).
+   * @param options.timeout - Max milliseconds to wait (default: 300 000 = 5 min).
+   *
+   * @example
+   * client.on('interactionCreate', async (interaction) => {
+   *   if (interaction.commandName === 'report') {
+   *     const submitted = await client.interactions.awaitModal(interaction.id, {
+   *       title: 'Submit a report',
+   *       customId: 'report_modal',
+   *       fields: [
+   *         { customId: 'reason', label: 'Reason', type: 'paragraph', required: true, maxLength: 500 },
+   *       ],
+   *     })
+   *
+   *     if (!submitted) {
+   *       // User dismissed the modal or timed out — nothing to do
+   *       return
+   *     }
+   *
+   *     const reason = submitted.modalData?.reason
+   *     await client.interactions.respond(submitted.id, {
+   *       content: `Report received: ${reason}`,
+   *       ephemeral: true,
+   *     })
+   *   }
+   * })
+   */
+  awaitModal(interactionId, modal, options = {}) {
+    const ms = options.timeout ?? 3e5;
+    let listener = null;
+    let timer = null;
+    const waitPromise = new Promise((resolve) => {
+      timer = setTimeout(() => {
+        if (listener) this.emitter.off("interactionCreate", listener);
+        resolve(null);
+      }, ms);
+      listener = (interaction) => {
+        if (interaction.type === "MODAL_SUBMIT" && interaction.customId === modal.customId) {
+          if (timer) clearTimeout(timer);
+          if (listener) this.emitter.off("interactionCreate", listener);
+          resolve(interaction);
+        }
+      };
+      this.emitter.on("interactionCreate", listener);
+    });
+    return this.respond(interactionId, { modal }).then(
+      () => waitPromise,
+      (err) => {
+        if (timer) clearTimeout(timer);
+        if (listener) this.emitter.off("interactionCreate", listener);
+        return Promise.reject(err);
+      }
+    );
+  }
+};
+
+// src/api/permissions.ts
+var PermissionsAPI = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Fetch the bot's effective permissions for a given scope.
+   *
+   * Permissions are merged in priority order:
+   * 1. Server-wide base permissions
+   * 2. Role override (if `roleId` provided)
+   * 3. Channel override (if `channelId` provided, highest priority)
+   *
+   * `serverId` is required. `channelId` and `roleId` are optional filters.
+   *
+   * @example
+   * // Effective server-wide permissions
+   * const { permissions } = await client.permissions.get({
+   *   serverId: 'server-id',
+   * })
+   * console.log(permissions) // { kick_members: true, ban_members: false, ... }
+   *
+   * @example
+   * // Scoped to a specific channel
+   * const { permissions } = await client.permissions.get({
+   *   serverId: 'server-id',
+   *   channelId: 'channel-id',
+   * })
+   *
+   * @example
+   * // Scoped to a specific role
+   * const { permissions } = await client.permissions.get({
+   *   serverId: 'server-id',
+   *   roleId: 'role-id',
+   * })
+   */
+  get(options) {
+    const params = new URLSearchParams({ serverId: options.serverId });
+    if (options.channelId) params.set("channelId", options.channelId);
+    if (options.roleId) params.set("roleId", options.roleId);
+    return this.http.get(`/permissions?${params.toString()}`);
+  }
 };
 
 // src/client.ts
@@ -324,11 +434,12 @@ var NovaClient = class extends EventEmitter {
     this.commands = new CommandsAPI(this.http);
     this.members = new MembersAPI(this.http);
     this.servers = new ServersAPI(this.http);
-    this.interactions = new InteractionsAPI(this.http);
+    this.interactions = new InteractionsAPI(this.http, this);
+    this.permissions = new PermissionsAPI(this.http);
     this.on("error", () => {
     });
     const cleanup = () => this.disconnect();
-    process.once("exit", cleanup);
+    process.once("beforeExit", cleanup);
     process.once("SIGINT", () => {
       cleanup();
       process.exit(0);
@@ -398,12 +509,28 @@ var NovaClient = class extends EventEmitter {
    */
   disconnect() {
     if (this.socket) {
+      const sock = this.socket;
+      this.socket = null;
       try {
-        this.socket.io.reconnection(false);
+        sock.io.reconnection(false);
+      } catch {
+      }
+      try {
+        sock.io?.engine?.socket?.terminate?.();
+      } catch {
+      }
+      try {
+        sock.io?.engine?.socket?.destroy?.();
+      } catch {
+      }
+      try {
+        sock.io?.engine?.close?.();
+      } catch {
+      }
+      try {
+        sock.disconnect();
       } catch {
       }
-      this.socket.disconnect();
-      this.socket = null;
     }
   }
   /**
@@ -451,5 +578,6 @@ export {
   MembersAPI,
   MessagesAPI,
   NovaClient,
+  PermissionsAPI,
   ServersAPI
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "novaapp-sdk",
-  "version": "1.0.7",
+  "version": "1.0.10",
   "description": "Official SDK for building bots on the Nova platform",
   "main": "dist/index.js",
   "module": "dist/index.mjs",