lunibee 0.1.6 → 0.1.8

package/dist/structures/interactions.d.ts

@@ -35,58 +35,8 @@ 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[];
-}
+export { CommandOptions, type APIInteractionDataOption } from "./options.js";
+import { CommandOptions } from "./options.js";
 /** A Discord interaction callback payload. */
 export declare class InteractionResponse {
     readonly type: number;
@@ -118,6 +68,13 @@ export declare class Interaction<TData extends InteractionData = InteractionData
     /** 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 ModalSubmitInteraction;
     /** Whether this interaction is autocomplete. @returns True for autocomplete interactions. */ isAutocomplete(): this is AutocompleteInteraction;
+    /** Whether this is a button interaction. */ isButton(): this is ComponentInteraction;
+    /** Whether this is a string select menu interaction. */ isStringSelectMenu(): this is ComponentInteraction;
+    /** Whether this is a user select menu interaction. */ isUserSelectMenu(): this is ComponentInteraction;
+    /** Whether this is a role select menu interaction. */ isRoleSelectMenu(): this is ComponentInteraction;
+    /** Whether this is a mentionable select menu interaction. */ isMentionableSelectMenu(): this is ComponentInteraction;
+    /** Whether this is a channel select menu interaction. */ isChannelSelectMenu(): this is ComponentInteraction;
+    /** Whether this is any select menu interaction. */ isAnySelectMenu(): this is ComponentInteraction;
     /** 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. */
@@ -167,6 +124,9 @@ export declare class ModalSubmitInteraction extends Interaction {
 }
 /** Represents a Discord slash command autocomplete interaction. */
 export declare class AutocompleteInteraction extends Interaction {
+    /** Option resolver; use `options.getFocused()` for the focused value. */
+    readonly options: CommandOptions;
+    constructor(client: InteractionClient, data: InteractionData);
     /** Gets the target command name. */
     get commandName(): string;
     /** Gets the currently focused autocomplete option. */

package/dist/structures/options.d.ts

@@ -0,0 +1,55 @@
+/** 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;
+    /** Returns the focused option's value (autocomplete), or the full option when `full` is true. @throws {TypeError} If no option is focused. */
+    getFocused(full: true): APIInteractionDataOption;
+    getFocused(full?: false): string | number | boolean;
+    /** 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[];
+}

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,20 +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. */
+    /** 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;
@@ -49,7 +69,17 @@ 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;
     });
+    /** 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;
 }
@@ -59,10 +89,168 @@ export declare class TextChannel extends Channel {
     constructor(data: {
         id: string;
         type: number;
-        name?: string;
+        name?: string | null;
         parent_id?: string | null;
         guild_id?: string;
-    }, context?: import("./base.js").ResourceContext);
+    } & Partial<import("@lunibee/types").APIChannel>, 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;
+    });
+    /** 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);
+}

package/dist/types/gateway-events.d.ts

@@ -0,0 +1,132 @@
+import type { APIChannel, APIEmoji, APIGuildMember, APIPartialEmoji, APIPresenceUpdate, APIRole, APISticker, APIThreadMember, Snowflake, UserData } from "./index.js";
+/** Raw Discord READY event payload. */
+export interface APIReadyEvent {
+    v: number;
+    user: UserData;
+    guilds: Array<{
+        id: Snowflake;
+        unavailable?: boolean;
+    }>;
+    session_id: string;
+    resume_gateway_url: string;
+    shard?: [number, number];
+    application?: {
+        id: Snowflake;
+        flags: number;
+        [key: string]: unknown;
+    };
+}
+/** Raw Discord reaction event payload. */
+export interface APIMessageReactionEvent {
+    user_id: Snowflake;
+    channel_id: Snowflake;
+    message_id: Snowflake;
+    guild_id?: Snowflake;
+    member?: APIGuildMember;
+    emoji: APIPartialEmoji;
+    message_author_id?: Snowflake;
+    burst?: boolean;
+    type?: number;
+}
+/** Raw Discord reaction remove emoji event payload. */
+export interface APIMessageReactionRemoveEmojiEvent {
+    channel_id: Snowflake;
+    guild_id?: Snowflake;
+    message_id: Snowflake;
+    emoji: APIPartialEmoji;
+}
+/** Raw Discord message deletion event payload. */
+export interface APIMessageDeleteEvent {
+    id: Snowflake;
+    channel_id: Snowflake;
+    guild_id?: Snowflake;
+}
+/** Raw Discord bulk message deletion event payload. */
+export interface APIMessageDeleteBulkEvent {
+    ids: Snowflake[];
+    channel_id: Snowflake;
+    guild_id?: Snowflake;
+}
+/** Raw Discord channel deletion event payload. */
+export interface APIChannelDeleteEvent extends APIChannel {
+}
+/** Raw Discord guild deletion event payload. */
+export interface APIGuildDeleteEvent {
+    id: Snowflake;
+    unavailable?: boolean;
+}
+/** Raw Discord thread lifecycle payload. */
+export interface APIThreadEvent extends APIChannel {
+    guild_id: Snowflake;
+    member?: APIThreadMember;
+}
+/** Raw Discord thread list sync event. */
+export interface APIThreadListSync {
+    guild_id: Snowflake;
+    channel_ids?: Snowflake[];
+    threads: APIChannel[];
+    members: APIThreadMember[];
+}
+/** Raw Discord thread members update event. */
+export interface APIThreadMembersUpdate {
+    id: Snowflake;
+    guild_id: Snowflake;
+    member_count: number;
+    added_members?: APIThreadMember[];
+    removed_member_ids?: Snowflake[];
+}
+/** Raw Discord guild role event payload. */
+export interface APIGuildRoleEvent {
+    guild_id: Snowflake;
+    role: APIRole;
+}
+/** Raw Discord guild role delete event payload. */
+export interface APIGuildRoleDeleteEvent {
+    guild_id: Snowflake;
+    role_id: Snowflake;
+}
+/** Raw Discord guild ban event payload. */
+export interface APIGuildBanEvent {
+    guild_id: Snowflake;
+    user: UserData;
+}
+/** Raw Discord guild emojis update event payload. */
+export interface APIGuildEmojisUpdateEvent {
+    guild_id: Snowflake;
+    emojis: APIEmoji[];
+}
+/** Raw Discord guild stickers update event payload. */
+export interface APIGuildStickersUpdateEvent {
+    guild_id: Snowflake;
+    stickers: APISticker[];
+}
+/** Raw Discord channel pins update event. */
+export interface APIChannelPinsUpdate {
+    guild_id?: Snowflake;
+    channel_id: Snowflake;
+    last_pin_timestamp?: string | null;
+}
+/** Raw Discord guild members chunk event. */
+export interface APIGuildMembersChunk {
+    guild_id: Snowflake;
+    members: APIGuildMember[];
+    chunk_index: number;
+    chunk_count: number;
+    not_found?: Snowflake[];
+    presences?: APIPresenceUpdate[];
+    nonce?: string;
+}
+/** Raw Discord guild scheduled event user add/remove event. */
+export interface APIGuildScheduledEventUserEvent {
+    guild_scheduled_event_id: Snowflake;
+    user_id: Snowflake;
+    guild_id: Snowflake;
+}
+/** Raw Discord message poll vote add/remove event. */
+export interface APIMessagePollVoteEvent {
+    user_id: Snowflake;
+    channel_id: Snowflake;
+    message_id: Snowflake;
+    guild_id?: Snowflake;
+    answer_id: number;
+}