lunibee 0.1.4 → 0.1.6

package/dist/core/index.d.ts

@@ -1,58 +1,11 @@
 export { Permission, Permissions, PermissionFlagsBits, PermissionSet, PermissionsBitField, PermissionOverwriteType, type PermissionName, } from "./permissions.js";
+export { ClientEvent, type ClientEventName, type ClientListener, } from "./events.js";
+export { GatewayIntentBits, IntentBits, Intents, resolveGatewayIntents, type GatewayIntentResolvable, } from "@lunibee/types";
 import { ApplicationCommandManager, ChannelManager, GuildManager, UserManager } from "@lunibee/managers";
 import { REST } from "@lunibee/rest";
 import { Channel, Message, Interaction, type InteractionClient } from "@lunibee/structures";
 import { Gateway } from "@lunibee/ws";
-import type { APIChannel, APIGuild, APIGuildMember, APIGuildRoleEvent, APIGuildRoleDeleteEvent, APIGuildBanEvent, APIGuildEmojisUpdateEvent, APIMessageDeleteBulkEvent, APIMessageDeleteEvent, APIMessageReactionEvent, APIThreadEvent, ClientOptions, ClientUser } from "@lunibee/types";
-/** Events emitted by the Lunibee client. */
-export interface ClientEvents {
-    /** Client is ready. */ ready: [ClientUser];
-    /** Raw gateway dispatch envelope. */ raw: [{
-        event: string;
-        data: unknown;
-    }];
-    /** Normalized client error. */ error: [Error];
-    /** Gateway opened. */ open: [];
-    /** Gateway closed. */ close: [{
-        code: number;
-        action: string;
-    }];
-    /** Message created. */ messageCreate: [Message];
-    /** Message updated. */ messageUpdate: [Message];
-    /** Message deleted. */ messageDelete: [APIMessageDeleteEvent];
-    /** Messages deleted in bulk. */ messageDeleteBulk: [
-        APIMessageDeleteBulkEvent
-    ];
-    /** Guild became available. */ guildCreate: [APIGuild];
-    /** Guild updated. */ guildUpdate: [APIGuild];
-    /** Guild became unavailable or was removed. */ guildDelete: [
-        {
-            id: string;
-            unavailable?: boolean;
-        }
-    ];
-    /** Channel created. */ channelCreate: [Channel];
-    /** Channel updated. */ channelUpdate: [Channel];
-    /** Channel deleted. */ channelDelete: [APIChannel];
-    /** Thread created. */ threadCreate: [Channel];
-    /** Thread updated. */ threadUpdate: [Channel];
-    /** Thread deleted. */ threadDelete: [APIThreadEvent];
-    /** Guild member added. */ guildMemberAdd: [APIGuildMember];
-    /** Guild member updated. */ guildMemberUpdate: [APIGuildMember];
-    /** Guild member removed. */ guildMemberRemove: [APIGuildMember];
-    /** Reaction added. */ messageReactionAdd: [APIMessageReactionEvent];
-    /** Reaction removed. */ messageReactionRemove: [APIMessageReactionEvent];
-    /** All reactions removed. */ messageReactionRemoveAll: [
-        APIMessageDeleteEvent
-    ];
-    /** Interaction created. */ interactionCreate: [Interaction];
-    /** Guild role created. */ guildRoleCreate: [APIGuildRoleEvent];
-    /** Guild role updated. */ guildRoleUpdate: [APIGuildRoleEvent];
-    /** Guild role deleted. */ guildRoleDelete: [APIGuildRoleDeleteEvent];
-    /** Guild ban added. */ guildBanAdd: [APIGuildBanEvent];
-    /** Guild ban removed. */ guildBanRemove: [APIGuildBanEvent];
-    /** Guild emojis updated. */ guildEmojisUpdate: [APIGuildEmojisUpdateEvent];
-}
+import type { APIChannel, APIGuild, APIGuildMember, APIGuildRoleEvent, APIGuildRoleDeleteEvent, APIGuildBanEvent, APIGuildEmojisUpdateEvent, APIGuildStickersUpdateEvent, APIMessageDeleteBulkEvent, APIMessageDeleteEvent, APIMessageReactionEvent, APIMessageReactionRemoveEmojiEvent, APIThreadEvent, APIThreadListSync, APIThreadMembersUpdate, APIVoiceState, APIVoiceServerUpdate, APIPresenceUpdate, APITypingStart, APIInviteCreate, APIInviteDelete, APIWebhooksUpdate, APIAutoModerationRule, APIAutoModerationActionExecution, APIGuildScheduledEvent, APIGuildScheduledEventUserEvent, APIStageInstance, APIChannelPinsUpdate, APIGuildMembersChunk, APIMessagePollVoteEvent, APIThreadMember, ClientOptions, ClientUser } from "@lunibee/types";
 /** Lifecycle state of a client. */
 export type ClientState = "idle" | "connecting" | "ready" | "destroyed";
 type Listener<T extends unknown[]> = (...args: T) => unknown;
@@ -61,51 +14,128 @@ declare class EventEmitter<Events extends {
     [K in keyof Events]: unknown[];
 }> {
     #private;
-    /** Registers a listener. @param event Event name. @param listener Listener callback. @returns This emitter. */ on<K extends keyof Events>(event: K, listener: Listener<Events[K]>): this;
-    /** Registers a one-shot listener. @param event Event name. @param listener Listener callback. @returns This emitter. */ once<K extends keyof Events>(event: K, listener: Listener<Events[K]>): this;
-    /** Removes a listener. @param event Event name. @param listener Listener callback. @returns This emitter. */ off<K extends keyof Events>(event: K, listener: Listener<Events[K]>): this;
-    /** Removes listeners. @param event Optional event name. @returns This emitter. */ removeAllListeners<K extends keyof Events>(event?: K): this;
-    /** Emits an event. @param event Event name. @param args Event arguments. @returns Whether listeners were invoked. */ protected emit<K extends keyof Events>(event: K, ...args: Events[K]): boolean;
+    on<K extends keyof Events>(event: K, listener: Listener<Events[K]>): this;
+    once<K extends keyof Events>(event: K, listener: Listener<Events[K]>): this;
+    off<K extends keyof Events>(event: K, listener: Listener<Events[K]>): this;
+    removeAllListeners<K extends keyof Events>(event?: K): this;
+    protected emit<K extends keyof Events>(event: K, ...args: Events[K]): boolean;
 }
 /** Main Lunibee Discord client. */
 export declare class Client extends EventEmitter<ClientEvents> implements InteractionClient {
     #private;
     readonly options: ClientOptions;
-    /** REST transport used by all managers. */ readonly rest: REST;
-    /** User resource manager. */ readonly users: UserManager;
-    /** Guild resource manager. */ readonly guilds: GuildManager;
-    /** Channel and message resource manager. */ readonly channels: ChannelManager;
-    /** Application command manager (available after login). */ readonly application: {
-        /** Application command registration API. */ commands: ApplicationCommandManager;
+    readonly rest: REST;
+    readonly users: UserManager;
+    readonly guilds: GuildManager;
+    readonly channels: ChannelManager;
+    readonly application: {
+        commands: ApplicationCommandManager;
     };
-    /** Underlying WebSocket Gateway connection. */ get ws(): Gateway;
-    /** Underlying WebSocket Gateway connection. */ get gateway(): Gateway;
-    /** Current authenticated bot user. */ user?: ClientUser;
-    /** Time at which the gateway became ready. */ readyAt?: Date;
-    /** Current client lifecycle state. */ state: ClientState;
-    /** Time in milliseconds since the client became ready, or null if not ready. */
+    get ws(): Gateway;
+    get gateway(): Gateway;
+    user?: ClientUser;
+    readyAt?: Date;
+    state: ClientState;
     get uptime(): number | null;
-    /** Creates a client. @param options Client configuration. @throws {TypeError} If no token is supplied. */ constructor(options: ClientOptions);
-    /** Indicates whether the client has completed gateway readiness. @returns True when ready. */ isReady(): this is Client & {
-        user: ClientUser;
-        readyAt: Date;
-    };
-    /** Connects the REST and gateway clients. @returns A promise fulfilled after the gateway socket opens. @throws {Error} If the client is destroyed or connection fails. */ login(): Promise<void>;
-    /** Closes the gateway and destroys cached resources. @returns Nothing. */ destroy(): void;
-    /** Posts an interaction callback through REST. @param id Interaction identifier. @param token Interaction token. @param response Interaction response. @returns REST response. */ postInteractionResponse(id: string, token: string, response: import("@lunibee/structures").InteractionResponse): Promise<unknown>;
-    /** Edits the original interaction response. @param token Interaction token. @param data Reply payload. @returns REST response. */ editInteractionReply(token: string, data: import("@lunibee/structures").InteractionReplyOptions): Promise<unknown>;
-    /** Deletes the original interaction response. @param token Interaction token. @returns Nothing. */ deleteInteractionReply(token: string): Promise<void>;
-    /** Sets the client gateway presence. @param presence Presence options. @returns Whether the presence update was sent. */
-    setPresence(presence: import("@lunibee/types").GatewayPresence): boolean;
-    /** Sends a follow-up interaction webhook message. @param token Interaction token. @param data Follow-up payload. @returns REST response. */ followUpInteraction(token: string, data: import("@lunibee/structures").InteractionReplyOptions): Promise<unknown>;
+    /** Whether the client is ready and connected. */
+    isReady(): boolean;
+    /** Sets the bot's presence / status. @param data Presence payload. @returns Whether the payload was sent. */
+    setPresence(data: import("@lunibee/types").GatewayPresence): boolean;
+    constructor(options: ClientOptions);
+    /**
+     * Convenience method to connect the bot to Discord.
+     * Optionally overrides the configured token.
+     * @param token Optional token override.
+     * @returns The token used to log in.
+     * @throws {TypeError} If the resulting token is empty.
+     */
+    login(token?: string): Promise<string>;
+    /**
+     * Destroys the client, permanently closing the Gateway connection.
+     */
+    destroy(): void;
+    postInteractionResponse(id: string, token: string, response: import("@lunibee/structures").InteractionResponse): Promise<unknown>;
+    editInteractionReply(token: string, data: Record<string, unknown>): Promise<unknown>;
+    deleteInteractionReply(token: string): Promise<void>;
+    followUpInteraction(token: string, data: Record<string, unknown>): Promise<unknown>;
 }
-export { Collection } from "@lunibee/collection";
-export { REST, RESTError, Routes } from "@lunibee/rest";
-export { Gateway, GatewayError, GatewayOpcodes } from "@lunibee/ws";
-export { User, Guild, Channel, Message, type ResourceContext, } from "@lunibee/structures";
-export { EmbedBuilder, ButtonBuilder, ActionRowBuilder, StringSelectBuilder, SlashCommandBuilder, StringOptionBuilder, } from "@lunibee/builders";
-export * from "@lunibee/types";
-export { Manager, ResourceManager, UserManager, GuildManager, ChannelManager, MessageCreateOptions, MessageEditOptions, MessageFetchOptions, MessageThreadOptions, ReactionFetchOptions, } from "@lunibee/managers";
-export { Collector, type CollectorOptions } from "./collector.js";
-export { ApplicationCommandManager } from "@lunibee/managers";
-export type { APIApplicationCommand, ApplicationCommandData, APIRole, APIGuildRoleEvent, APIGuildRoleDeleteEvent, APIGuildBanEvent, APIEmoji, APIGuildEmojisUpdateEvent, ApplicationCommandOptionType, ApplicationCommandType, } from "@lunibee/types";
+export type ClientEvents = {
+    ready: [user: ClientUser];
+    raw: [data: {
+        event: string;
+        data: unknown;
+    }];
+    error: [error: Error];
+    open: [];
+    close: [data: {
+        code: number;
+        action: string;
+    }];
+    messageCreate: [message: Message];
+    messageUpdate: [message: Message];
+    messageDelete: [data: APIMessageDeleteEvent];
+    messageDeleteBulk: [data: APIMessageDeleteBulkEvent];
+    messageReactionAdd: [data: APIMessageReactionEvent];
+    messageReactionRemove: [data: APIMessageReactionEvent];
+    messageReactionRemoveAll: [data: APIMessageDeleteEvent];
+    messageReactionRemoveEmoji: [data: APIMessageReactionRemoveEmojiEvent];
+    messagePollVoteAdd: [data: APIMessagePollVoteEvent];
+    messagePollVoteRemove: [data: APIMessagePollVoteEvent];
+    guildCreate: [data: APIGuild];
+    guildUpdate: [data: APIGuild];
+    guildDelete: [data: {
+        id: string;
+        unavailable?: boolean;
+    }];
+    guildAvailable: [data: APIGuild & {
+        unavailable?: boolean;
+    }];
+    guildUnavailable: [data: {
+        id: string;
+        unavailable?: boolean;
+    }];
+    guildMemberAdd: [member: APIGuildMember];
+    guildMemberUpdate: [member: APIGuildMember];
+    guildMemberRemove: [member: APIGuildMember];
+    guildMembersChunk: [data: APIGuildMembersChunk];
+    guildBanAdd: [data: APIGuildBanEvent];
+    guildBanRemove: [data: APIGuildBanEvent];
+    guildRoleCreate: [data: APIGuildRoleEvent];
+    guildRoleUpdate: [data: APIGuildRoleEvent];
+    guildRoleDelete: [data: APIGuildRoleDeleteEvent];
+    guildEmojisUpdate: [data: APIGuildEmojisUpdateEvent];
+    guildStickersUpdate: [data: APIGuildStickersUpdateEvent];
+    guildIntegrationsUpdate: [data: {
+        guild_id: string;
+    }];
+    guildScheduledEventCreate: [data: APIGuildScheduledEvent];
+    guildScheduledEventUpdate: [data: APIGuildScheduledEvent];
+    guildScheduledEventDelete: [data: APIGuildScheduledEvent];
+    guildScheduledEventUserAdd: [data: APIGuildScheduledEventUserEvent];
+    guildScheduledEventUserRemove: [data: APIGuildScheduledEventUserEvent];
+    autoModerationRuleCreate: [data: APIAutoModerationRule];
+    autoModerationRuleUpdate: [data: APIAutoModerationRule];
+    autoModerationRuleDelete: [data: APIAutoModerationRule];
+    autoModerationActionExecution: [data: APIAutoModerationActionExecution];
+    channelCreate: [channel: Channel];
+    channelUpdate: [channel: Channel];
+    channelDelete: [data: APIChannel];
+    channelPinsUpdate: [data: APIChannelPinsUpdate];
+    threadCreate: [channel: Channel];
+    threadUpdate: [channel: Channel];
+    threadDelete: [data: APIThreadEvent];
+    threadListSync: [data: APIThreadListSync];
+    threadMembersUpdate: [data: APIThreadMembersUpdate];
+    threadMemberUpdate: [data: APIThreadMember];
+    stageInstanceCreate: [data: APIStageInstance];
+    stageInstanceUpdate: [data: APIStageInstance];
+    stageInstanceDelete: [data: APIStageInstance];
+    inviteCreate: [data: APIInviteCreate];
+    inviteDelete: [data: APIInviteDelete];
+    webhooksUpdate: [data: APIWebhooksUpdate];
+    voiceStateUpdate: [data: APIVoiceState];
+    voiceServerUpdate: [data: APIVoiceServerUpdate];
+    presenceUpdate: [data: APIPresenceUpdate];
+    typingStart: [data: APITypingStart];
+    interactionCreate: [interaction: Interaction];
+};