lunibee 0.1.5 → 0.1.7

package/dist/managers/emoji.d.ts

@@ -0,0 +1,38 @@
+import { Manager } from "./base.js";
+import { Emoji } from "@lunibee/structures";
+import { type REST } from "@lunibee/rest";
+/** Strict payload for creating a custom guild emoji. */
+export interface EmojiCreateOptions {
+    /** Emoji name (1-32 chars, alphanumeric + underscores). */
+    name: string;
+    /** Base64-encoded 128x128 image data URI. */
+    image: string;
+    /** Role IDs allowed to use the emoji. */
+    roles?: string[];
+}
+/** Strict payload for editing a custom guild emoji. */
+export interface EmojiEditOptions {
+    /** New emoji name. */
+    name?: string;
+    /** Role IDs allowed to use the emoji. */
+    roles?: string[];
+}
+/** Manages custom emojis for a guild. */
+export declare class EmojiManager extends Manager<string, Emoji> {
+    #private;
+    constructor(rest: REST, guildId: string);
+    /** Fetches an emoji by ID from Discord. */
+    fetch(emojiId: string): Promise<Emoji>;
+    /** Fetches all emojis for this guild. */
+    fetchAll(): Promise<Emoji[]>;
+    /** Creates a new custom emoji. */
+    create(options: EmojiCreateOptions): Promise<Emoji>;
+    /** Edits an existing custom emoji. */
+    edit(emojiId: string, options: EmojiEditOptions): Promise<Emoji>;
+    /** Deletes a custom emoji. */
+    deleteEmoji(emojiId: string): Promise<void>;
+    /** Upserts an emoji into the manager cache. Custom emojis are keyed by their
+     * snowflake ID; unicode emojis (no ID) are keyed by `unicode:${name}` so repeated
+     * upserts reuse the same cached instance instead of allocating a new one each call. */
+    upsert(data: ConstructorParameters<typeof Emoji>[0]): Emoji;
+}

package/dist/managers/guild.d.ts

@@ -0,0 +1,141 @@
+import { ResourceManager } from "./base.js";
+import { Guild, AutoModerationRule } from "@lunibee/structures";
+import { type REST } from "@lunibee/rest";
+import { type APIChannel, type APIGuildPreview, type APIInvite, type APIWebhook } from "@lunibee/types";
+export interface GuildCreateOptions extends Record<string, unknown> {
+    name: string;
+}
+export interface GuildEditOptions extends Record<string, unknown> {
+}
+export declare class GuildManager extends ResourceManager<string, Guild> {
+    #private;
+    constructor(rest: REST);
+    /** Creates a new guild. (Bot must be in fewer than 10 guilds). */
+    create(options: GuildCreateOptions): Promise<Guild>;
+    /** Modifies a guild's settings. */
+    edit(id: string, options: GuildEditOptions): Promise<Guild>;
+    /** Deletes a guild permanently. User must be the owner. */
+    deleteGuild(id: string): Promise<void>;
+    /** Fetches a guild's preview (even if the bot is not in the guild). */
+    fetchPreview(id: string): Promise<APIGuildPreview>;
+    /** Fetches all active threads in the guild. */
+    fetchActiveThreads(id: string): Promise<{
+        threads: APIChannel[];
+        members: unknown[];
+    }>;
+    /** Fetches all webhooks in the guild. */
+    fetchWebhooks(id: string): Promise<APIWebhook[]>;
+    /** Fetches all invites in the guild. */
+    fetchInvites(id: string): Promise<APIInvite[]>;
+    /**
+     * Fetches audit log entries for a guild.
+     * @param guildId Guild identifier.
+     * @param options Filter options: userId (filter by actor), actionType (AuditLogEvent number), before (entry ID cursor), limit (1–100, default 50).
+     * @returns Typed audit log response with `audit_log_entries` and related resources.
+     */
+    fetchAuditLog(guildId: string, options?: {
+        userId?: string;
+        actionType?: number;
+        before?: string;
+        after?: string;
+        limit?: number;
+    }): Promise<AuditLogResponse>;
+    /**
+     * Fetches members from a guild (paginated).
+     * @param guildId Guild identifier.
+     * @param options Fetch options: limit (1–1000, default 100), after (member ID cursor).
+     * @returns Array of raw member data payloads.
+     */
+    fetchMembers(guildId: string, options?: {
+        limit?: number;
+        after?: string;
+    }): Promise<Record<string, unknown>[]>;
+    /** Fetches a list of all auto moderation rules currently configured for guild. */
+    fetchAutoModerationRules(guildId: string): Promise<AutoModerationRule[]>;
+    /** Fetches a single auto moderation rule. */
+    fetchAutoModerationRule(guildId: string, ruleId: string): Promise<AutoModerationRule>;
+    /** Creates a new auto moderation rule. */
+    createAutoModerationRule(guildId: string, options: Record<string, unknown>): Promise<AutoModerationRule>;
+    /** Modifies an existing auto moderation rule. */
+    editAutoModerationRule(guildId: string, ruleId: string, options: Record<string, unknown>): Promise<AutoModerationRule>;
+    /** Deletes an auto moderation rule. */
+    deleteAutoModerationRule(guildId: string, ruleId: string): Promise<void>;
+}
+/** A single audit log entry as returned by the Discord API. */
+export interface AuditLogEntry {
+    id: string;
+    action_type: number;
+    user_id: string | null;
+    target_id: string | null;
+    reason?: string;
+    changes?: Array<{
+        key: string;
+        old_value?: unknown;
+        new_value?: unknown;
+    }>;
+    options?: Record<string, unknown>;
+}
+/** Discord API audit log response payload. */
+export interface AuditLogResponse {
+    audit_log_entries: AuditLogEntry[];
+    users: Record<string, unknown>[];
+    integrations: Record<string, unknown>[];
+    webhooks: Record<string, unknown>[];
+    guild_scheduled_events: Record<string, unknown>[];
+    threads: Record<string, unknown>[];
+    application_commands: Record<string, unknown>[];
+}
+/** Known Discord audit log event type numbers. */
+export declare const AuditLogEvent: {
+    readonly GuildUpdate: 1;
+    readonly ChannelCreate: 10;
+    readonly ChannelUpdate: 11;
+    readonly ChannelDelete: 12;
+    readonly ChannelOverwriteCreate: 13;
+    readonly ChannelOverwriteUpdate: 14;
+    readonly ChannelOverwriteDelete: 15;
+    readonly MemberKick: 20;
+    readonly MemberPrune: 21;
+    readonly MemberBanAdd: 22;
+    readonly MemberBanRemove: 23;
+    readonly MemberUpdate: 24;
+    readonly MemberRoleUpdate: 25;
+    readonly MemberMove: 26;
+    readonly MemberDisconnect: 27;
+    readonly BotAdd: 28;
+    readonly RoleCreate: 30;
+    readonly RoleUpdate: 31;
+    readonly RoleDelete: 32;
+    readonly InviteCreate: 40;
+    readonly InviteUpdate: 41;
+    readonly InviteDelete: 42;
+    readonly WebhookCreate: 50;
+    readonly WebhookUpdate: 51;
+    readonly WebhookDelete: 52;
+    readonly EmojiCreate: 60;
+    readonly EmojiUpdate: 61;
+    readonly EmojiDelete: 62;
+    readonly MessageDelete: 72;
+    readonly MessageBulkDelete: 73;
+    readonly MessagePin: 74;
+    readonly MessageUnpin: 75;
+    readonly IntegrationCreate: 80;
+    readonly IntegrationUpdate: 81;
+    readonly IntegrationDelete: 82;
+    readonly StageInstanceCreate: 83;
+    readonly StageInstanceUpdate: 84;
+    readonly StageInstanceDelete: 85;
+    readonly StickerCreate: 90;
+    readonly StickerUpdate: 91;
+    readonly StickerDelete: 92;
+    readonly ScheduledEventCreate: 100;
+    readonly ScheduledEventUpdate: 101;
+    readonly ScheduledEventDelete: 102;
+    readonly ThreadCreate: 110;
+    readonly ThreadUpdate: 111;
+    readonly ThreadDelete: 112;
+    readonly AutoModerationRuleCreate: 140;
+    readonly AutoModerationRuleUpdate: 141;
+    readonly AutoModerationRuleDelete: 142;
+    readonly AutoModerationBlockMessage: 143;
+};

package/dist/managers/index.d.ts

@@ -1,96 +1,107 @@
-import { Manager, ResourceManager } from "./base.js";
+import { Manager } from "./base.js";
 export { Manager, ResourceManager } from "./base.js";
 import { REST } from "@lunibee/rest";
-import { Channel, Message, User, Guild } from "@lunibee/structures";
-import { MessageManager } from "./message.js";
+import { Channel, Message, User } from "@lunibee/structures";
+import { MessageManager, type MessageCreateOptions as ManagerMessageCreateOptions } from "./message.js";
 import { ThreadManager } from "./thread.js";
-/** Manages users. */
-export declare class UserManager extends ResourceManager<string, User> {
-    /** Creates a user manager. @param rest REST transport. */ constructor(rest: REST);
-}
-/** Manages guilds. */
-export declare class GuildManager extends ResourceManager<string, Guild> {
-    /** Creates a guild manager. @param rest REST transport. */ constructor(rest: REST);
-}
-/** Message creation options. */
-export interface MessageCreateOptions {
-    /** Message content. */ content?: string;
-}
-/** Message edit options. */
-export interface MessageEditOptions {
-    /** New message content. */ content?: string;
-}
-/** Message fetch options. */
+export { UserManager } from "./user.js";
+export { GuildManager } from "./guild.js";
+export type { AuditLogEntry, AuditLogResponse } from "./guild.js";
+export { AuditLogEvent } from "./guild.js";
+export type MessageCreateOptions = ManagerMessageCreateOptions;
+export type MessageEditOptions = Record<string, unknown> & {
+    content?: string;
+};
 export interface MessageFetchOptions {
-    /** Whether to use cache. */ cache?: boolean;
+    cache?: boolean;
 }
-/** Message list query options. */
 export interface MessageQueryOptions {
-    /** Message before this ID. */ before?: string;
-    /** Message after this ID. */ after?: string;
-    /** Message around this ID. */ around?: string;
-    /** Maximum number of messages. */ limit?: number;
+    before?: string;
+    after?: string;
+    around?: string;
+    limit?: number;
 }
-/** Message thread creation options. */
 export interface MessageThreadOptions {
-    /** Thread name. */ name: string;
-    /** Auto archive duration. */ autoArchiveDuration?: 60 | 1440 | 4320 | 10080;
-    /** Slowmode duration. */ rateLimitPerUser?: number;
+    name: string;
+    autoArchiveDuration?: 60 | 1440 | 4320 | 10080;
+    rateLimitPerUser?: number;
 }
-/** Reaction list options. */
 export interface ReactionFetchOptions {
-    /** Maximum reactions. */ limit?: number;
-    /** Reaction pagination cursor. */ after?: string;
+    limit?: number;
+    after?: string;
+}
+export interface ChannelCreateOptions extends Record<string, unknown> {
+    name: string;
+    type: number;
+    guild_id?: string;
+    parent_id?: string | null;
 }
-/** Runtime compatibility placeholders for legacy value imports. */
-export declare const MessageCreateOptions: undefined;
-/** Runtime compatibility placeholder. */
-export declare const MessageEditOptions: undefined;
-/** Runtime compatibility placeholder. */
-export declare const MessageFetchOptions: undefined;
-/** Runtime compatibility placeholder. */
-export declare const MessageThreadOptions: undefined;
-/** Runtime compatibility placeholder. */
-export declare const ReactionFetchOptions: undefined;
-/** Manages Discord channels and their message APIs. */
+export type ChannelEditOptions = Record<string, unknown>;
 export declare class ChannelManager extends Manager<string, Channel> {
     #private;
-    /** Creates a channel manager. @param rest REST transport. */
     constructor(rest: REST);
-    /** Gets the canonical message manager for a channel. @param channelId Channel ID. @returns Message manager. */ messages(channelId: string): MessageManager;
-    /** Creates a thread manager. @param channelId Channel ID. @returns Thread manager. */ threads(channelId: string): ThreadManager;
-    /** Fetches a channel. @param channelId Channel ID. @returns Channel. */ fetch(channelId: string): Promise<Channel>;
-    /** Resolves a channel. @param channelId Channel ID. @returns Canonical channel. */ resolve(channelId: string): Promise<Channel>;
-    /** Inserts or updates a channel. @param data Channel payload. @returns Canonical channel. */ upsert(data: ConstructorParameters<typeof Channel>[0]): Channel;
-    /** Updates a channel. @param channel Channel. @returns This manager. */ update(channel: Channel): this;
-    /** Sends a message. @param channelId Channel ID. @param options Message options. @returns Created message. */ send(channelId: string, options: MessageCreateOptions): Promise<Message>;
-    /** Alias for send. @param channelId Channel ID. @param options Message options. @returns Created message. */ sendMessage(channelId: string, options: MessageCreateOptions): Promise<Message>;
-    /** Fetches one message. @param channelId Channel ID. @param messageId Message ID. @param options Fetch options. @returns Message. */ fetchMessage(channelId: string, messageId: string, options?: MessageFetchOptions): Promise<Message>;
-    /** Fetches messages by query or by iterable IDs. @param channelId Channel ID. @param query Query options or message IDs. @returns Messages. */ fetchMessages(channelId: string, query: MessageQueryOptions | Iterable<string>): Promise<Message[]>;
-    /** Inserts a message through the canonical cache path. @param data Message payload. @returns Canonical message. */ upsertMessage(data: ConstructorParameters<typeof Message>[0]): Message;
-    /** Edits a message. @param channelId Channel ID. @param messageId Message ID. @param options Edit options. @returns Updated message. */ editMessage(channelId: string, messageId: string, options: MessageEditOptions): Promise<Message>;
-    /** Deletes a message. @param channelId Channel ID. @param messageId Message ID. @returns Nothing. */ deleteMessage(channelId: string, messageId: string): Promise<void>;
-    /** Deletes a cached message. @param channelId Channel ID. @param messageId Message ID. @returns Whether removed. */ deleteCachedMessage(channelId: string, messageId: string): boolean;
-    /** Crossposts a message. @param channelId Channel ID. @param messageId Message ID. @returns Crossposted message. */ crosspostMessage(channelId: string, messageId: string): Promise<Message>;
-    /** Bulk deletes messages. @param channelId Channel ID. @param messageIds Message IDs. @returns Nothing. */ bulkDeleteMessages(channelId: string, messageIds: Iterable<string>): Promise<void>;
-    /** Adds a reaction. @param channelId Channel ID. @param messageId Message ID. @param emoji Emoji identifier. @returns Nothing. */ addReaction(channelId: string, messageId: string, emoji: string): Promise<void>;
-    /** Fetches users who reacted. @param channelId Channel ID. @param messageId Message ID. @param emoji Emoji identifier. @param options Query options. @returns Users. */ fetchReactions(channelId: string, messageId: string, emoji: string, options?: ReactionFetchOptions): Promise<User[]>;
-    /** Removes the current bot user's reaction. @param channelId Channel ID. @param messageId Message ID. @param emoji Emoji identifier. @returns Nothing. */ removeOwnReaction(channelId: string, messageId: string, emoji: string): Promise<void>;
-    /** Removes a user's reaction. @param channelId Channel ID. @param messageId Message ID. @param emoji Emoji identifier. @param userId User ID. @returns Nothing. */ removeReaction(channelId: string, messageId: string, emoji: string, userId: string): Promise<void>;
-    /** Removes all reactions. @param channelId Channel ID. @param messageId Message ID. @returns Nothing. */ removeAllReactions(channelId: string, messageId: string): Promise<void>;
-    /** Fetches pinned messages. @param channelId Channel ID. @returns Pinned messages. */ fetchPinnedMessages(channelId: string): Promise<Message[]>;
-    /** Pins a message. @param channelId Channel ID. @param messageId Message ID. @returns Nothing. */ pinMessage(channelId: string, messageId: string): Promise<void>;
-    /** Unpins a message. @param channelId Channel ID. @param messageId Message ID. @returns Nothing. */ unpinMessage(channelId: string, messageId: string): Promise<void>;
-    /** Creates a thread from a message. @param channelId Channel ID. @param messageId Message ID. @param options Thread options. @returns Created thread channel. */ createThreadFromMessage(channelId: string, messageId: string, options: MessageThreadOptions): Promise<Channel>;
-    /** Deletes a channel and its message manager. @param channelId Channel ID. @returns Whether removed. */ delete(channelId: string): boolean;
-    /** Clears all channels and message managers. @returns Nothing. */ clear(): void;
+    messages(channelId: string): MessageManager;
+    threads(channelId: string): ThreadManager;
+    fetch(channelId: string): Promise<Channel>;
+    resolve(channelId: string): Promise<Channel>;
+    upsert(data: ConstructorParameters<typeof Channel>[0]): Channel;
+    update(channel: Channel): this;
+    create(guildId: string, options: ChannelCreateOptions): Promise<Channel>;
+    edit(channelId: string, options: ChannelEditOptions): Promise<Channel>;
+    deleteChannel(channelId: string): Promise<void>;
+    /** Evicts a channel, dropping its per-channel message manager with it.
+     * Overrides {@link Manager.delete} so cache eviction driven by a Gateway
+     * `CHANNEL_DELETE`/`THREAD_DELETE` — which calls `delete` rather than
+     * {@link deleteChannel} — releases the message manager and its cached
+     * messages too, instead of retaining them for the client's lifetime. */
+    delete(channelId: string): boolean;
+    send(channelId: string, options: MessageCreateOptions): Promise<Message>;
+    sendMessage(channelId: string, options: MessageCreateOptions): Promise<Message>;
+    fetchMessage(channelId: string, messageId: string, options?: MessageFetchOptions): Promise<Message>;
+    fetchMessages(channelId: string, query: MessageQueryOptions | Iterable<string>): Promise<Message[]>;
+    upsertMessage(data: ConstructorParameters<typeof Message>[0]): Message;
+    editMessage(channelId: string, messageId: string, options: MessageEditOptions): Promise<Message>;
+    deleteMessage(channelId: string, messageId: string): Promise<void>;
+    deleteCachedMessage(channelId: string, messageId: string): boolean;
+    crosspostMessage(channelId: string, messageId: string): Promise<Message>;
+    /** Bulk-deletes messages in a channel.
+     * @throws {RangeError} If fewer than 2 or more than 100 message IDs are provided. */
+    bulkDeleteMessages(channelId: string, messageIds: Iterable<string>): Promise<void>;
+    addReaction(channelId: string, messageId: string, emoji: string): Promise<void>;
+    fetchReactions(channelId: string, messageId: string, emoji: string, options?: ReactionFetchOptions): Promise<User[]>;
+    removeOwnReaction(channelId: string, messageId: string, emoji: string): Promise<void>;
+    removeReaction(channelId: string, messageId: string, emoji: string, userId: string): Promise<void>;
+    removeAllReactions(channelId: string, messageId: string): Promise<void>;
+    fetchPinnedMessages(channelId: string): Promise<Message[]>;
+    pinMessage(channelId: string, messageId: string): Promise<void>;
+    unpinMessage(channelId: string, messageId: string): Promise<void>;
+    createThreadFromMessage(channelId: string, messageId: string, options: MessageThreadOptions): Promise<Channel>;
+    /**
+     * Fetches a page of messages with cursor metadata.
+     * @param channelId Channel to fetch from.
+     * @param options Page options — `before`, `after`, `around`, and `limit` (max 100).
+     * @returns `{ messages, before, after, hasMore }` — use `before` or `after` as cursors for the next page.
+     */
+    fetchPage(channelId: string, options?: MessageQueryOptions): Promise<{
+        messages: Message[];
+        before?: string;
+        after?: string;
+        hasMore: boolean;
+    }>;
+    /**
+     * Bulk-deletes 2–100 messages from a channel.
+     * Only messages younger than 14 days are accepted by Discord.
+     * @param channelId Channel to delete from.
+     * @param messageIds Array of message IDs to delete.
+     * @throws {RangeError} If fewer than 2 or more than 100 IDs are provided.
+     */
+    bulkDelete(channelId: string, messageIds: string[]): Promise<void>;
+    clear(): void;
 }
-/** Backward-compatible message option alias. */
 export type CreateMessageOptions = MessageCreateOptions;
-/** Exposes the message manager class. */
 export { MessageManager } from "./message.js";
-/** Exposes the thread manager class. */
 export { ThreadManager } from "./thread.js";
 export { RoleManager, type RoleCreateOptions, type RoleEditOptions, } from "./role.js";
 export { GuildMemberManager, type MemberEditOptions, type BanOptions, } from "./member.js";
 export { ApplicationCommandManager } from "./application.js";
+export { EmojiManager, type EmojiCreateOptions, type EmojiEditOptions } from "./emoji.js";