novaapp-sdk 1.0.7 → 1.0.9

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;
@@ -461,6 +540,43 @@ declare class InteractionsAPI {
     poll(options?: PollInteractionsOptions): Promise<Interaction[]>;
 }
 
+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>;
+}
+
 /**
  * The main Nova bot client.
  *
@@ -494,6 +610,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 +654,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;
@@ -461,6 +540,43 @@ declare class InteractionsAPI {
     poll(options?: PollInteractionsOptions): Promise<Interaction[]>;
 }
 
+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>;
+}
+
 /**
  * The main Nova bot client.
  *
@@ -494,6 +610,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 +654,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);
@@ -324,6 +325,50 @@ var InteractionsAPI = class {
   }
 };
 
+// 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
 var EVENT_MAP = {
   "message.created": "messageCreate",
@@ -357,10 +402,11 @@ var NovaClient = class extends import_node_events.EventEmitter {
     this.members = new MembersAPI(this.http);
     this.servers = new ServersAPI(this.http);
     this.interactions = new InteractionsAPI(this.http);
+    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 +476,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 +546,6 @@ var NovaClient = class extends import_node_events.EventEmitter {
   MembersAPI,
   MessagesAPI,
   NovaClient,
+  PermissionsAPI,
   ServersAPI
 });

package/dist/index.mjs

@@ -292,6 +292,50 @@ var InteractionsAPI = class {
   }
 };
 
+// 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
 var EVENT_MAP = {
   "message.created": "messageCreate",
@@ -325,10 +369,11 @@ var NovaClient = class extends EventEmitter {
     this.members = new MembersAPI(this.http);
     this.servers = new ServersAPI(this.http);
     this.interactions = new InteractionsAPI(this.http);
+    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 +443,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 +512,6 @@ export {
   MembersAPI,
   MessagesAPI,
   NovaClient,
+  PermissionsAPI,
   ServersAPI
 };

package/package.json

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