lunibee 0.1.6 → 0.1.8

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-resources.d.ts

@@ -0,0 +1,109 @@
+import { Manager } from "./base.js";
+import { type REST } from "@lunibee/rest";
+import type { APIGuildScheduledEvent, APIStageInstance, UserData } from "@lunibee/types";
+/** Raw Discord ban object. */
+export interface APIBan {
+    user: UserData;
+    reason: string | null;
+}
+/** Options for {@link GuildBanManager.create}. */
+export interface GuildBanCreateOptions {
+    /** Seconds of message history to delete (0-604800). */
+    deleteMessageSeconds?: number;
+    /** Audit-log reason. */
+    reason?: string;
+}
+/** Manages a guild's bans, cached by user ID. Discord.js-familiar. */
+export declare class GuildBanManager extends Manager<string, APIBan> {
+    #private;
+    readonly guildId: string;
+    constructor(rest: REST, guildId: string);
+    /** Fetches one ban. */
+    fetch(userId: string): Promise<APIBan>;
+    /** Fetches a page of bans (`limit` 1-1000, `before`/`after` user-ID cursors). */
+    fetchAll(options?: {
+        limit?: number;
+        before?: string;
+        after?: string;
+    }): Promise<APIBan[]>;
+    /** Bans a user. */
+    create(userId: string, options?: GuildBanCreateOptions): Promise<void>;
+    /** Lifts a ban. */
+    remove(userId: string, reason?: string): Promise<void>;
+}
+/** Fields accepted when creating or editing a scheduled event. */
+export type GuildScheduledEventOptions = Partial<Omit<APIGuildScheduledEvent, "id" | "guild_id" | "creator" | "user_count">> & Record<string, unknown>;
+/** Manages a guild's scheduled events, cached by event ID. Discord.js-familiar. */
+export declare class GuildScheduledEventManager extends Manager<string, APIGuildScheduledEvent> {
+    #private;
+    readonly guildId: string;
+    constructor(rest: REST, guildId: string);
+    /** Fetches one event. */
+    fetch(eventId: string, options?: {
+        withUserCount?: boolean;
+    }): Promise<APIGuildScheduledEvent>;
+    /** Fetches every event in the guild. */
+    fetchAll(options?: {
+        withUserCount?: boolean;
+    }): Promise<APIGuildScheduledEvent[]>;
+    /** Creates an event. */
+    create(options: GuildScheduledEventOptions, reason?: string): Promise<APIGuildScheduledEvent>;
+    /** Edits an event. */
+    edit(eventId: string, options: GuildScheduledEventOptions, reason?: string): Promise<APIGuildScheduledEvent>;
+    /** Deletes an event. */
+    remove(eventId: string): Promise<void>;
+    /** Fetches users subscribed to an event (`limit` 1-100). */
+    fetchSubscribers(eventId: string, options?: {
+        limit?: number;
+        withMember?: boolean;
+        before?: string;
+        after?: string;
+    }): Promise<{
+        guild_scheduled_event_id: string;
+        user: UserData;
+    }[]>;
+}
+/** Options for creating a stage instance. */
+export interface StageInstanceCreateOptions {
+    topic: string;
+    privacyLevel?: number;
+    sendStartNotification?: boolean;
+    guildScheduledEventId?: string;
+}
+/** Manages stage instances, cached by stage channel ID. Discord.js-familiar. */
+export declare class StageInstanceManager extends Manager<string, APIStageInstance> {
+    #private;
+    constructor(rest: REST);
+    /** Starts a stage instance in a stage channel. */
+    create(channelId: string, options: StageInstanceCreateOptions, reason?: string): Promise<APIStageInstance>;
+    /** Fetches the stage instance of a stage channel. */
+    fetch(channelId: string): Promise<APIStageInstance>;
+    /** Edits a stage instance's topic or privacy level. */
+    edit(channelId: string, options: {
+        topic?: string;
+        privacyLevel?: number;
+    }, reason?: string): Promise<APIStageInstance>;
+    /** Ends a stage instance. */
+    remove(channelId: string, reason?: string): Promise<void>;
+}
+/** Overwrite target type: 0 = role, 1 = member. */
+export type PermissionOverwriteTargetType = 0 | 1;
+/** Permission values accepted by {@link PermissionOverwriteManager.edit}. */
+export interface PermissionOverwriteOptions {
+    /** Target type: 0 = role, 1 = member. */
+    type: PermissionOverwriteTargetType;
+    /** Allowed permission bits. */
+    allow?: bigint | number | string;
+    /** Denied permission bits. */
+    deny?: bigint | number | string;
+}
+/** Manages a channel's permission overwrites. Discord.js-familiar. */
+export declare class PermissionOverwriteManager {
+    #private;
+    readonly channelId: string;
+    constructor(rest: REST, channelId: string);
+    /** Creates or replaces the overwrite for a role or member. */
+    edit(overwriteId: string, options: PermissionOverwriteOptions, reason?: string): Promise<void>;
+    /** Deletes the overwrite for a role or member. */
+    remove(overwriteId: string, reason?: string): Promise<void>;
+}

package/dist/managers/guild.d.ts

@@ -1,5 +1,6 @@
 import { ResourceManager } from "./base.js";
-import { Guild } from "@lunibee/structures";
+import { GuildBanManager, GuildScheduledEventManager } from "./guild-resources.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> {
@@ -10,6 +11,10 @@ export interface GuildEditOptions extends Record<string, unknown> {
 export declare class GuildManager extends ResourceManager<string, Guild> {
     #private;
     constructor(rest: REST);
+    /** Ban manager for a guild (one instance per guild). */
+    bans(guildId: string): GuildBanManager;
+    /** Scheduled-event manager for a guild (one instance per guild). */
+    scheduledEvents(guildId: string): GuildScheduledEventManager;
     /** Creates a new guild. (Bot must be in fewer than 10 guilds). */
     create(options: GuildCreateOptions): Promise<Guild>;
     /** Modifies a guild's settings. */
@@ -27,4 +32,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

@@ -1,11 +1,15 @@
 import { Manager } from "./base.js";
 export { Manager, ResourceManager } from "./base.js";
+/** Discord.js-familiar alias for {@link ResourceManager}. */
+export { ResourceManager as CachedManager } from "./base.js";
 import { REST } from "@lunibee/rest";
 import { Channel, Message, User } from "@lunibee/structures";
 import { MessageManager, type MessageCreateOptions as ManagerMessageCreateOptions } from "./message.js";
 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;
@@ -35,10 +39,13 @@ export interface ChannelCreateOptions extends Record<string, unknown> {
     parent_id?: string | null;
 }
 export type ChannelEditOptions = Record<string, unknown>;
+import { PermissionOverwriteManager } from "./guild-resources.js";
 export declare class ChannelManager extends Manager<string, Channel> {
     #private;
     constructor(rest: REST);
     messages(channelId: string): MessageManager;
+    /** Permission overwrite manager for a channel. */
+    permissionOverwrites(channelId: string): PermissionOverwriteManager;
     threads(channelId: string): ThreadManager;
     fetch(channelId: string): Promise<Channel>;
     resolve(channelId: string): Promise<Channel>;
@@ -47,6 +54,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 +69,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 +81,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 +109,5 @@ 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 { GuildBanManager, GuildScheduledEventManager, StageInstanceManager, PermissionOverwriteManager, type APIBan, type GuildBanCreateOptions, type GuildScheduledEventOptions, type StageInstanceCreateOptions, type PermissionOverwriteOptions, type PermissionOverwriteTargetType, } from "./guild-resources.js";
+export { EmojiManager, type EmojiCreateOptions, type EmojiEditOptions, } from "./emoji.js";