lunibee 0.1.6 → 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

@@ -1,5 +1,5 @@
 import { ResourceManager } from "./base.js";
-import { Guild } from "@lunibee/structures";
+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> {
@@ -27,4 +27,115 @@ export declare class GuildManager extends ResourceManager<string, 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

@@ -6,6 +6,8 @@ import { MessageManager, type MessageCreateOptions as ManagerMessageCreateOption
 import { ThreadManager } from "./thread.js";
 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;
@@ -47,6 +49,12 @@ export declare class ChannelManager extends Manager<string, Channel> {
     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>;
@@ -56,6 +64,8 @@ export declare class ChannelManager extends Manager<string, Channel> {
     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[]>;
@@ -66,7 +76,26 @@ export declare class ChannelManager extends Manager<string, Channel> {
     pinMessage(channelId: string, messageId: string): Promise<void>;
     unpinMessage(channelId: string, messageId: string): Promise<void>;
     createThreadFromMessage(channelId: string, messageId: string, options: MessageThreadOptions): Promise<Channel>;
-    delete(channelId: string): boolean;
+    /**
+     * 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;
 }
 export type CreateMessageOptions = MessageCreateOptions;
@@ -75,3 +104,4 @@ 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";