lunibee 0.1.5 → 0.1.7

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

@@ -1,5 +1,6 @@
 import { BaseStructure, Channel, User } from "./base.js";
-import { PermissionsBitField } from "./permissions.js";
+import { PermissionsBitField } from "@lunibee/core";
+import type { ImageURLOptions } from "./base.js";
 /** A Discord guild member. */
 export declare class GuildMember {
     /** User represented by the member. */ readonly user: User;
@@ -9,6 +10,10 @@ export declare class GuildMember {
     /** Whether the member is pending membership screening. */ pending: boolean;
     /** Member join timestamp. */ joinedAt?: Date;
     /** Raw effective permission bitfield supplied by Discord. */ readonly permissions: PermissionsBitField;
+    /** Member-specific avatar hash, if set. */ avatarHash: string | null;
+    /** When the member started boosting the guild. */ premiumSince: Date | null;
+    /** When the member's timeout expires (null if not timed out). */ timedOutUntil: Date | null;
+    /** Member flags bitfield. */ flags: number;
     /** Creates a guild member from Discord data. @param data Discord guild-member payload. @throws {TypeError} If the guild ID is invalid. @throws {RangeError} If joined_at is invalid. */
     constructor(data: {
         user: {
@@ -19,6 +24,7 @@ export declare class GuildMember {
             bot?: boolean;
             system?: boolean;
             public_flags?: number;
+            discriminator?: string;
         };
         guild_id: string;
         nick?: string | null;
@@ -26,17 +32,34 @@ export declare class GuildMember {
         pending?: boolean;
         joined_at?: string;
         permissions?: string;
+        avatar?: string | null;
+        premium_since?: string | null;
+        communication_disabled_until?: string | null;
+        flags?: number;
     });
-    /** Effective member display name. @returns Nickname or user display name. */ get displayName(): string;
+    /** Effective member display name — nickname, falling back to user display name. */
+    get displayName(): string;
+    /** Whether this member is currently timed out. */
+    get isTimedOut(): boolean;
+    /** Returns the member-specific avatar URL, falling back to the user's avatar, or null if none. */
+    avatarURL(options?: ImageURLOptions): string | null;
+    /** Returns the resolved avatar URL — member avatar, user avatar, or default. */
+    displayAvatarURL(options?: ImageURLOptions): string;
+    /** Returns the Discord user mention for this member. */
+    toString(): string;
 }
 /** A Discord guild role. */
 export declare class Role extends BaseStructure {
     /** Role name. */ name: string;
-    /** Role color. */ color: number;
+    /** Role color as a 24-bit RGB integer. */ color: number;
     /** Whether the role is hoisted. */ hoist: boolean;
     /** Permission bitfield. */ permissions: PermissionsBitField;
-    /** Whether the role is managed. */ managed: boolean;
+    /** Whether the role is managed by an integration. */ managed: boolean;
     /** Whether the role is mentionable. */ mentionable: boolean;
+    /** Role position in the hierarchy. */ position: number;
+    /** Unicode emoji used as the role icon, if any. */ unicodeEmoji: string | null;
+    /** Hash of the role's custom icon image, if any. */ iconHash: string | null;
+    /** Role tags metadata (bot, premium subscriber, etc). */ tags: Record<string, unknown> | null;
     /** Creates a role from Discord data. @param data Discord role payload. */
     constructor(data: {
         id: string;
@@ -46,12 +69,22 @@ export declare class Role extends BaseStructure {
         permissions?: string;
         managed?: boolean;
         mentionable?: boolean;
+        position?: number;
+        unicode_emoji?: string | null;
+        icon?: string | null;
+        tags?: Record<string, unknown> | null;
     });
-    /** Discord role mention string. @returns Role mention. */ toString(): string;
+    /** Returns the role's color as a `#RRGGBB` hex string. Returns `#000000` for colorless roles. */
+    get colorHex(): string;
+    /** Returns the role's custom icon URL, or null if the role has no icon. */
+    iconURL(options?: ImageURLOptions): string | null;
+    /** Whether this is the @everyone base role (its ID equals the guild ID). */
+    isEveryone(guildId: string): boolean;
+    /** 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 +92,165 @@ export declare class TextChannel extends Channel {
         name?: string;
         parent_id?: string | null;
         guild_id?: string;
+    }, context?: import("./base.js").ResourceContext);
+    /** Discord channel mention string. Used automatically in template literals. */
+    toString(): string;
+}
+/** A Discord invite link and its metadata. */
+export declare class Invite {
+    /** Invite code (the unique part of the URL). */ readonly code: string;
+    /** Guild this invite belongs to, if any. */ readonly guildId: string | null;
+    /** Channel this invite points to, if any. */ readonly channelId: string | null;
+    /** User who created the invite, if available. */ readonly inviter: User | null;
+    /** Number of times the invite has been used. */ uses: number;
+    /** Maximum number of uses (0 = unlimited). */ maxUses: number;
+    /** Duration in seconds until the invite expires (0 = never). */ maxAge: number;
+    /** Whether the invite is temporary (kicks uninducted members on disconnect). */ temporary: boolean;
+    /** When the invite was created. */ readonly createdAt: Date | null;
+    /** When the invite expires, or null if it never expires. */ readonly expiresAt: Date | null;
+    /** Creates an invite from Discord data. */
+    constructor(data: {
+        code: string;
+        guild?: {
+            id: string;
+        } | null;
+        channel?: {
+            id: string;
+        } | null;
+        inviter?: {
+            id: string;
+            username: string;
+            global_name?: string | null;
+            avatar?: string | null;
+            bot?: boolean;
+            system?: boolean;
+            public_flags?: number;
+            discriminator?: string;
+        } | null;
+        uses?: number;
+        max_uses?: number;
+        max_age?: number;
+        temporary?: boolean;
+        created_at?: string | null;
+        expires_at?: string | null;
+    });
+    /** The full invite URL. */
+    get url(): string;
+    /** Returns the invite URL. Used automatically in template literals. */
+    toString(): string;
+}
+/** Webhook type constants. */
+export declare const WebhookType: {
+    readonly Incoming: 1;
+    readonly ChannelFollower: 2;
+    readonly Application: 3;
+};
+/** A Discord webhook — an HTTP endpoint that can post messages to a channel. */
+export declare class Webhook extends BaseStructure {
+    /** Webhook type. */ readonly type: number;
+    /** Webhook display name. */ name: string | null;
+    /** Webhook avatar hash. */ avatarHash: string | null;
+    /** Channel this webhook posts to. */ readonly channelId: string | null;
+    /** Guild this webhook belongs to. */ readonly guildId: string | null;
+    /** Application that created this webhook, if any. */ readonly applicationId: string | null;
+    /** Webhook token (only present for incoming webhooks). */ readonly token: string | null;
+    /** Creates a webhook from Discord data. */
+    constructor(data: {
+        id: string;
+        type?: number;
+        name?: string | null;
+        avatar?: string | null;
+        channel_id?: string | null;
+        guild_id?: string | null;
+        application_id?: string | null;
+        token?: string;
+    });
+    /** Returns the webhook avatar URL, or null if no avatar is set. */
+    avatarURL(options?: ImageURLOptions): string | null;
+    /** Returns the webhook execution URL, or null if no token is set. */
+    get url(): string | null;
+    /** Returns the webhook URL or its ID as a string. */
+    toString(): string;
+}
+/** A Discord emoji. */
+export declare class Emoji extends BaseStructure {
+    /** Emoji name. */ name: string | null;
+    /** Roles allowed to use this emoji. */ roleIds: string[];
+    /** User that created this emoji. */ user: User | null;
+    /** Whether this emoji must be wrapped in colons. */ requireColons: boolean;
+    /** Whether this emoji is managed. */ managed: boolean;
+    /** Whether this emoji is animated. */ animated: boolean;
+    /** Whether this emoji can be used, may be false due to loss of Server Boosts. */ available: boolean;
+    /** Creates an emoji from Discord data. */
+    constructor(data: {
+        id: string | null;
+        name: string | null;
+        roles?: string[];
+        user?: import("@lunibee/types").UserData;
+        require_colons?: boolean;
+        managed?: boolean;
+        animated?: boolean;
+        available?: boolean;
     });
-    /** Discord channel mention string. @returns Channel mention. */ toString(): string;
+    /** Returns the URL for this emoji if it is custom, or null for unicode emojis. */
+    url(options?: ImageURLOptions): string | null;
+    /** Returns the text required to render this emoji in Discord. */
+    toString(): string;
+}
+/** A Discord AutoModeration Rule. */
+export declare class AutoModerationRule extends BaseStructure {
+    guildId: string;
+    name: string;
+    creatorId: string;
+    eventType: number;
+    triggerType: number;
+    triggerMetadata: Record<string, unknown>;
+    actions: import("@lunibee/types").APIAutoModerationAction[];
+    enabled: boolean;
+    exemptRoles: string[];
+    exemptChannels: string[];
+    /** Creates an auto moderation rule from Discord data. */
+    constructor(data: import("@lunibee/types").APIAutoModerationRule);
+    toJSON(): Record<string, unknown>;
+}
+/** A channel listed in a guild's Welcome Screen. */
+export declare class WelcomeScreenChannel {
+    channelId: string;
+    description: string;
+    emojiId: string | null;
+    emojiName: string | null;
+    constructor(data: import("@lunibee/types").APIWelcomeScreenChannel);
+}
+/** A Discord Guild Welcome Screen. */
+export declare class GuildWelcomeScreen {
+    description: string | null;
+    channels: WelcomeScreenChannel[];
+    constructor(data: import("@lunibee/types").APIGuildWelcomeScreen);
+}
+/** An option within a Guild Onboarding Prompt. */
+export declare class OnboardingPromptOption extends BaseStructure {
+    channelIds: string[];
+    roleIds: string[];
+    emoji: import("@lunibee/types").APIPartialEmoji | undefined;
+    title: string;
+    description: string | null;
+    constructor(data: import("@lunibee/types").APIOnboardingPromptOption);
+}
+/** A prompt shown during Guild Onboarding. */
+export declare class OnboardingPrompt extends BaseStructure {
+    type: number;
+    options: OnboardingPromptOption[];
+    title: string;
+    singleSelect: boolean;
+    required: boolean;
+    inOnboarding: boolean;
+    constructor(data: import("@lunibee/types").APIOnboardingPrompt);
+}
+/** A Discord Guild Onboarding setup. */
+export declare class GuildOnboarding extends BaseStructure {
+    prompts: OnboardingPrompt[];
+    defaultChannelIds: string[];
+    enabled: boolean;
+    mode: number;
+    constructor(data: import("@lunibee/types").APIGuildOnboarding);
 }