lunibee 0.1.0 → 0.1.2

package/dist/core/index.d.ts

@@ -0,0 +1,111 @@
+export { Permission, Permissions, PermissionFlagsBits, PermissionSet, PermissionsBitField, PermissionOverwriteType, type PermissionName, } from "./permissions.js";
+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];
+}
+/** Lifecycle state of a client. */
+export type ClientState = "idle" | "connecting" | "ready" | "destroyed";
+type Listener<T extends unknown[]> = (...args: T) => unknown;
+/** Minimal typed event emitter used by the client. */
+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;
+}
+/** 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;
+    };
+    /** 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 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>;
+}
+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";