lunibee 0.1.4 → 0.1.6

package/dist/structures/interactions.d.ts

@@ -6,16 +6,7 @@ export declare const InteractionType: {
     readonly ApplicationCommandAutocomplete: 4;
     readonly ModalSubmit: 5;
 };
-/** Discord interaction response type constants. */
-export declare const InteractionResponseType: {
-    readonly Pong: 1;
-    readonly ChannelMessage: 4;
-    readonly DeferredChannelMessage: 5;
-    readonly DeferredMessageUpdate: 6;
-    readonly MessageUpdate: 7;
-    readonly Autocomplete: 8;
-    readonly Modal: 9;
-};
+export { InteractionResponseType } from "@lunibee/types";
 /** Data shared by Discord interactions. */
 export interface InteractionData {
     /** Interaction identifier. */ id: string;
@@ -44,6 +35,58 @@ export interface InteractionClient {
     /** Deletes the original interaction response. @param token Interaction token. @returns Promise fulfilled after deletion. @throws {Error} When REST fails. */ deleteInteractionReply(token: string): Promise<void>;
     /** Sends a follow-up interaction webhook message. @param token Interaction token. @param data Message payload. @returns Discord response. @throws {Error} When REST fails. */ followUpInteraction(token: string, data: InteractionReplyOptions): Promise<unknown>;
 }
+/** Raw Discord application command interaction data option. */
+export interface APIInteractionDataOption {
+    name: string;
+    type: number;
+    value?: string | number | boolean;
+    options?: APIInteractionDataOption[];
+    focused?: boolean;
+}
+/**
+ * Typed resolver for application command options.
+ * Attached as `CommandInteraction.options`.
+ */
+export declare class CommandOptions {
+    #private;
+    /** @internal */
+    constructor(options: APIInteractionDataOption[], resolved?: Record<string, unknown>);
+    /** Returns the invoked subcommand name, or null if none. */
+    getSubcommand(required?: false): string | null;
+    getSubcommand(required: true): string;
+    /** Returns the invoked subcommand group name, or null if none. */
+    getSubcommandGroup(required?: false): string | null;
+    getSubcommandGroup(required: true): string;
+    /** Gets a string option. @param name Option name. @param required If true, throws when missing. */
+    getString(name: string, required?: false): string | null;
+    getString(name: string, required: true): string;
+    /** Gets an integer option. @param name Option name. @param required If true, throws when missing. */
+    getInteger(name: string, required?: false): number | null;
+    getInteger(name: string, required: true): number;
+    /** Gets a number (float) option. @param name Option name. @param required If true, throws when missing. */
+    getNumber(name: string, required?: false): number | null;
+    getNumber(name: string, required: true): number;
+    /** Gets a boolean option. @param name Option name. @param required If true, throws when missing. */
+    getBoolean(name: string, required?: false): boolean | null;
+    getBoolean(name: string, required: true): boolean;
+    /** Gets the raw resolved user data for a user option. @param name Option name. @param required If true, throws when missing. */
+    getUser(name: string, required?: false): Record<string, unknown> | null;
+    getUser(name: string, required: true): Record<string, unknown>;
+    /** Gets the raw resolved channel data for a channel option. @param name Option name. @param required If true, throws when missing. */
+    getChannel(name: string, required?: false): Record<string, unknown> | null;
+    getChannel(name: string, required: true): Record<string, unknown>;
+    /** Gets the raw resolved role data for a role option. @param name Option name. @param required If true, throws when missing. */
+    getRole(name: string, required?: false): Record<string, unknown> | null;
+    getRole(name: string, required: true): Record<string, unknown>;
+    /** Gets the raw resolved user or role data for a mentionable option. @param name Option name. @param required If true, throws when missing. */
+    getMentionable(name: string, required?: false): Record<string, unknown> | null;
+    getMentionable(name: string, required: true): Record<string, unknown>;
+    /** Gets the raw resolved attachment data for an attachment option. @param name Option name. @param required If true, throws when missing. */
+    getAttachment(name: string, required?: false): Record<string, unknown> | null;
+    getAttachment(name: string, required: true): Record<string, unknown>;
+    /** Returns the raw option list for advanced use cases. */
+    get raw(): readonly APIInteractionDataOption[];
+}
 /** A Discord interaction callback payload. */
 export declare class InteractionResponse {
     readonly type: number;
@@ -73,8 +116,8 @@ export declare class Interaction<TData extends InteractionData = InteractionData
     /** Creates an interaction from a Gateway payload. @param client Interaction transport. @param data Gateway interaction payload. @throws {TypeError} If required identifiers are missing. */ constructor(client: InteractionClient, data: TData);
     /** Whether this interaction is an application command. @returns True for application command interactions. */ isChatInputCommand(): this is CommandInteraction;
     /** Whether this interaction is a message component. @returns True for component interactions. */ isMessageComponent(): this is ComponentInteraction;
-    /** Whether this interaction is a modal submission. @returns True for modal submissions. */ isModalSubmit(): this is ComponentInteraction;
-    /** Whether this interaction is autocomplete. @returns True for autocomplete interactions. */ isAutocomplete(): this is CommandInteraction;
+    /** Whether this interaction is a modal submission. @returns True for modal submissions. */ isModalSubmit(): this is ModalSubmitInteraction;
+    /** Whether this interaction is autocomplete. @returns True for autocomplete interactions. */ isAutocomplete(): this is AutocompleteInteraction;
     /** Ensures the interaction has not already been acknowledged. @returns Nothing. @throws {Error} When already acknowledged. */ protected assertUnacknowledged(): void;
     /** Ensures the interaction has been acknowledged. @returns Nothing. @throws {Error} When not acknowledged. */ protected assertAcknowledged(): void;
     /** Posts a raw interaction response callback. */
@@ -93,9 +136,12 @@ export declare class Interaction<TData extends InteractionData = InteractionData
         [key: string]: unknown;
     }): Promise<unknown>;
 }
-/** Application command interaction. */
+/** Application command interaction with fully typed option resolver. */
 export declare class CommandInteraction extends Interaction {
+    /** Typed option resolver. Access slash command options with full type safety. */
+    readonly options: CommandOptions;
     /** Invoked command name. @returns Command name or an empty string. */ get commandName(): string;
+    constructor(client: InteractionClient, data: InteractionData);
 }
 /** Message component interaction. */
 export declare class ComponentInteraction extends Interaction {
@@ -110,14 +156,14 @@ export declare class ComponentInteraction extends Interaction {
     /** Updates the message to which the component was attached. */
     update(options: InteractionReplyOptions | string): Promise<unknown>;
 }
-/** Creates a specialized interaction structure for a Gateway payload. @param client Interaction transport. @param data Gateway interaction payload. @returns Specialized interaction structure. @throws {TypeError} If required identifiers are missing. */
-export declare function createInteraction(client: InteractionClient, data: InteractionData): Interaction;
 /** Represents a Discord modal submission interaction. */
 export declare class ModalSubmitInteraction extends Interaction {
     /** Gets the submitted modal custom ID. */
     get customId(): string;
-    /** Retrieves the text value for a specific text input custom ID. */
+    /** Retrieves the text value for a specific text input custom ID. @param customId The custom_id of the text input component. @returns The submitted text, or undefined if not found. */
     getInputValue(customId: string): string | undefined;
+    /** Retrieves the text value for a text input, throwing if missing. @param customId The custom_id of the text input component. @returns The submitted text. @throws {TypeError} If the field is not found. */
+    getRequiredInputValue(customId: string): string;
 }
 /** Represents a Discord slash command autocomplete interaction. */
 export declare class AutocompleteInteraction extends Interaction {
@@ -127,10 +173,19 @@ export declare class AutocompleteInteraction extends Interaction {
     get focusedOption(): {
         name: string;
         value: unknown;
+        type: number;
     } | undefined;
-    /** Responds to Discord with autocomplete choices. */
+    /** Responds to Discord with autocomplete choices. @param choices Array of name/value pairs to show. @throws {TypeError} If choices is not an array. */
     respond(choices: {
         name: string;
         value: string | number;
     }[]): Promise<void>;
 }
+/**
+ * Creates a specialized interaction structure for a Gateway payload.
+ * @param client Interaction transport.
+ * @param data Gateway interaction payload.
+ * @returns Specialized interaction structure.
+ * @throws {TypeError} If required identifiers are missing.
+ */
+export declare function createInteraction(client: InteractionClient, data: InteractionData): Interaction;

package/dist/structures/resources.d.ts

@@ -27,7 +27,10 @@ export declare class GuildMember {
         joined_at?: string;
         permissions?: string;
     });
-    /** Effective member display name. @returns Nickname or user display name. */ get displayName(): string;
+    /** Effective member display name. @returns Nickname or user display name. */
+    get displayName(): string;
+    /** Returns the Discord user mention for this member. */
+    toString(): string;
 }
 /** A Discord guild role. */
 export declare class Role extends BaseStructure {
@@ -47,11 +50,11 @@ export declare class Role extends BaseStructure {
         managed?: boolean;
         mentionable?: boolean;
     });
-    /** Discord role mention string. @returns Role mention. */ toString(): string;
+    /** Discord role mention string. Used automatically in template literals. */
+    toString(): string;
 }
 /** A Discord text-capable channel. */
 export declare class TextChannel extends Channel {
-    /** Parent category ID. */ parentId?: string | null;
     /** Creates a text channel from Discord data. @param data Discord channel payload. */
     constructor(data: {
         id: string;
@@ -59,6 +62,7 @@ export declare class TextChannel extends Channel {
         name?: string;
         parent_id?: string | null;
         guild_id?: string;
-    });
-    /** Discord channel mention string. @returns Channel mention. */ toString(): string;
+    }, context?: import("./base.js").ResourceContext);
+    /** Discord channel mention string. Used automatically in template literals. */
+    toString(): string;
 }