lunibee 0.1.7 → 0.2.0

package/dist/structures/interactions.d.ts

@@ -1,3 +1,5 @@
+import { User } from "./base.js";
+import { GuildMember } from "./resources.js";
 /** Discord interaction type constants. */
 export declare const InteractionType: {
     readonly Ping: 1;
@@ -34,59 +36,11 @@ export interface InteractionClient {
     /** Edits the original interaction response. @param token Interaction token. @param data Message payload. @returns Discord response. @throws {Error} When REST fails. */ editInteractionReply(token: string, data: InteractionReplyOptions): Promise<unknown>;
     /** 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>;
+    /** Reads, edits or deletes an interaction webhook message (`@original` or a follow-up ID). Optional; required for {@link Interaction.fetchReply}, {@link Interaction.editFollowUp} and {@link Interaction.deleteFollowUp}. */
+    interactionWebhookMessage?(method: "GET" | "PATCH" | "DELETE", applicationId: string, token: string, messageId: 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,7 +72,36 @@ 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;
+    /**
+     * Sends the initial response exactly once. The in-flight flag is set
+     * before the request, so two concurrent calls cannot both send; it is
+     * cleared if the request fails so the caller may try again.
+     */
+    protected acknowledge(response: InteractionResponse, state: "replied" | "deferred"): Promise<unknown>;
+    /** The invoking user (from `member.user` in guilds, `user` in DMs). */
+    get user(): User | null;
+    /** The invoking guild member, or null outside a guild. */
+    get member(): GuildMember | null;
+    /** Unix timestamp (ms) at which the interaction was created, from its snowflake. */
+    get createdTimestamp(): number;
+    /** When the interaction token stops working (15 minutes after creation). */
+    get expiresAt(): Date;
+    /** Whether the token has expired; no response, edit or follow-up can succeed after that. */
+    get isExpired(): boolean;
+    /** Fetches the original response message. */
+    fetchReply(): Promise<unknown>;
+    /** Edits a follow-up message. @param messageId Follow-up message ID. */
+    editFollowUp(messageId: string, options: InteractionReplyOptions | string): Promise<unknown>;
+    /** Deletes a follow-up message. @param messageId Follow-up message ID. */
+    deleteFollowUp(messageId: string): Promise<void>;
     /** Ensures the interaction has been acknowledged. @returns Nothing. @throws {Error} When not acknowledged. */ protected assertAcknowledged(): void;
     /** Posts a raw interaction response callback. */
     protected postResponse(response: InteractionResponse): Promise<unknown>;
@@ -167,6 +150,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

@@ -78,7 +78,7 @@ export declare class Role extends BaseStructure {
     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). */
+    /** 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;
@@ -89,10 +89,10 @@ 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;
 }

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;
+}

package/dist/types/gateway.d.ts

@@ -0,0 +1,197 @@
+/** Gateway intent bit flags supported by Discord (PascalCase). */
+export declare const GatewayIntentBits: {
+    readonly Guilds: number;
+    readonly GuildMembers: number;
+    readonly GuildModeration: number;
+    readonly GuildExpressions: number;
+    readonly GuildIntegrations: number;
+    readonly GuildWebhooks: number;
+    readonly GuildInvites: number;
+    readonly GuildVoiceStates: number;
+    readonly GuildPresences: number;
+    readonly GuildMessages: number;
+    readonly GuildMessageReactions: number;
+    readonly GuildMessageTyping: number;
+    readonly DirectMessages: number;
+    readonly DirectMessageReactions: number;
+    readonly DirectMessageTyping: number;
+    readonly MessageContent: number;
+    readonly GuildScheduledEvents: number;
+    readonly AutoModerationConfiguration: number;
+    readonly AutoModerationExecution: number;
+    readonly GuildMessagePolls: number;
+    readonly DirectMessagePolls: number;
+};
+/** Idiomatic camelCase Gateway intent bit flags supported by Discord. */
+export declare const IntentBits: {
+    readonly guild: number;
+    readonly guilds: number;
+    readonly guildMembers: number;
+    readonly guildModeration: number;
+    readonly guildBans: number;
+    readonly guildExpressions: number;
+    readonly guildEmojis: number;
+    readonly guildEmojisAndStickers: number;
+    readonly guildIntegrations: number;
+    readonly guildWebhooks: number;
+    readonly guildInvites: number;
+    readonly guildVoiceStates: number;
+    readonly guildPresences: number;
+    readonly guildMessages: number;
+    readonly guildMessage: number;
+    readonly guildMessageReactions: number;
+    readonly guildMessageTyping: number;
+    readonly directMessages: number;
+    readonly directMessageReactions: number;
+    readonly directMessageTyping: number;
+    readonly messageContent: number;
+    readonly guildScheduledEvents: number;
+    readonly autoModerationConfiguration: number;
+    readonly autoModerationExecution: number;
+    readonly guildMessagePolls: number;
+    readonly directMessagePolls: number;
+};
+/** Alias for IntentBits. */
+export declare const Intents: {
+    readonly guild: number;
+    readonly guilds: number;
+    readonly guildMembers: number;
+    readonly guildModeration: number;
+    readonly guildBans: number;
+    readonly guildExpressions: number;
+    readonly guildEmojis: number;
+    readonly guildEmojisAndStickers: number;
+    readonly guildIntegrations: number;
+    readonly guildWebhooks: number;
+    readonly guildInvites: number;
+    readonly guildVoiceStates: number;
+    readonly guildPresences: number;
+    readonly guildMessages: number;
+    readonly guildMessage: number;
+    readonly guildMessageReactions: number;
+    readonly guildMessageTyping: number;
+    readonly directMessages: number;
+    readonly directMessageReactions: number;
+    readonly directMessageTyping: number;
+    readonly messageContent: number;
+    readonly guildScheduledEvents: number;
+    readonly autoModerationConfiguration: number;
+    readonly autoModerationExecution: number;
+    readonly guildMessagePolls: number;
+    readonly directMessagePolls: number;
+};
+/** Gateway intent resolvable value (single bitfield, enum key, or array of bitfields/strings). */
+export type GatewayIntentResolvable = number | keyof typeof GatewayIntentBits | keyof typeof IntentBits | (number | keyof typeof GatewayIntentBits | keyof typeof IntentBits | string)[] | {
+    readonly bitfield: number;
+};
+/** Resolves any GatewayIntentResolvable into a raw bitfield integer. */
+export declare function resolveGatewayIntents(intents: GatewayIntentResolvable): number;
+/**
+ * Discord.js-familiar intent bitfield.
+ * @example new IntentsBitField([IntentsBitField.Flags.Guilds, "GuildMessages"])
+ */
+export declare class IntentsBitField {
+    /** Intent flag values by name. */
+    static readonly Flags: {
+        readonly Guilds: number;
+        readonly GuildMembers: number;
+        readonly GuildModeration: number;
+        readonly GuildExpressions: number;
+        readonly GuildIntegrations: number;
+        readonly GuildWebhooks: number;
+        readonly GuildInvites: number;
+        readonly GuildVoiceStates: number;
+        readonly GuildPresences: number;
+        readonly GuildMessages: number;
+        readonly GuildMessageReactions: number;
+        readonly GuildMessageTyping: number;
+        readonly DirectMessages: number;
+        readonly DirectMessageReactions: number;
+        readonly DirectMessageTyping: number;
+        readonly MessageContent: number;
+        readonly GuildScheduledEvents: number;
+        readonly AutoModerationConfiguration: number;
+        readonly AutoModerationExecution: number;
+        readonly GuildMessagePolls: number;
+        readonly DirectMessagePolls: number;
+    };
+    /** Raw intent bitfield. */
+    bitfield: number;
+    constructor(bits?: GatewayIntentResolvable);
+    /** Whether every given intent is set. */
+    has(bits: GatewayIntentResolvable): boolean;
+    /** Whether any given intent is set. */
+    any(bits: GatewayIntentResolvable): boolean;
+    /** Adds intents in place. @returns This bitfield. */
+    add(...bits: GatewayIntentResolvable[]): this;
+    /** Removes intents in place. @returns This bitfield. */
+    remove(...bits: GatewayIntentResolvable[]): this;
+    /** Names of the set intents. */
+    toArray(): (keyof typeof GatewayIntentBits)[];
+    /** Whether this equals another bitfield. */
+    equals(bits: GatewayIntentResolvable): boolean;
+    valueOf(): number;
+    toJSON(): number;
+}
+/** Gateway connection properties (OS, browser, device). */
+export interface GatewayProperties {
+    os?: string;
+    browser?: string;
+    device?: string;
+    [key: string]: unknown;
+}
+/** Gateway presence activity. */
+export interface GatewayPresenceActivity {
+    name: string;
+    type?: number;
+    url?: string;
+    state?: string;
+}
+/** Gateway presence data. */
+export interface GatewayPresence {
+    status?: "online" | "dnd" | "idle" | "invisible" | "offline";
+    activities?: GatewayPresenceActivity[];
+    afk?: boolean;
+    since?: number | null;
+}
+/** Client configuration. */
+export interface ClientOptions {
+    token: string;
+    intents: GatewayIntentResolvable;
+    gateway?: GatewayOptions;
+    rest?: RESTOptions;
+    /** Opt-in bounded per-channel message cache. Messages are not cached by default. */
+    messageCache?: {
+        maxSize?: number;
+        ttl?: number;
+    };
+    /**
+     * Which resources the client keeps from Gateway events. Everything is
+     * cached by default; large bots can turn off what they do not read.
+     * Events are still emitted either way.
+     */
+    cache?: {
+        users?: boolean;
+        members?: boolean;
+        roles?: boolean;
+        emojis?: boolean;
+    };
+}
+/** Gateway connection configuration. */
+export interface GatewayOptions {
+    intents?: GatewayIntentResolvable;
+    reconnect?: boolean;
+    maxReconnectAttempts?: number;
+    reconnectBaseDelay?: number;
+    reconnectMaxDelay?: number;
+    shardId?: number;
+    shardCount?: number;
+    properties?: GatewayProperties;
+    presence?: GatewayPresence;
+}
+/** REST request configuration. */
+export interface RESTOptions {
+    timeout?: number;
+    retries?: number;
+    baseURL?: string;
+}