lunibee 0.2.3 → 0.3.0

package/dist/managers/advanced.d.ts

@@ -1,6 +1,6 @@
 import { Manager } from "./base.js";
 import { type REST } from "@lunibee/rest";
-import type { APIEntitlement, APISKU, APISoundboardSound, APISticker, APISubscription } from "@lunibee/types";
+import type { APIEmoji, APIEntitlement, APISKU, APISoundboardSound, APISticker, APISubscription } from "@lunibee/types";
 export type { APIEntitlement, APISKU, APISoundboardSound, APISubscription, } from "@lunibee/types";
 /** Fields for {@link GuildStickerManager.create}. */
 export interface GuildStickerCreateOptions {
@@ -114,3 +114,31 @@ export declare class MonetizationManager extends Manager<string, APIEntitlement>
     /** Fetches one subscription. */
     fetchSubscription(skuId: string, subscriptionId: string): Promise<APISubscription>;
 }
+/** Fields for {@link ApplicationEmojiManager.create}. */
+export interface ApplicationEmojiCreateOptions {
+    /** 2-32 characters: letters, digits and underscores. */
+    name: string;
+    /** The image as a data URI (PNG, JPEG, GIF or WebP, up to 256 KB). */
+    image: string;
+}
+/**
+ * The application's own emojis: they belong to the bot, not to a guild, so any
+ * server can show them. Cached by emoji ID.
+ */
+export declare class ApplicationEmojiManager extends Manager<string, APIEmoji> {
+    #private;
+    readonly applicationId: string;
+    constructor(rest: REST, applicationId: string);
+    /** Fetches every application emoji, replacing the cache. */
+    fetchAll(): Promise<APIEmoji[]>;
+    /** Fetches one application emoji. */
+    fetch(emojiId: string): Promise<APIEmoji>;
+    /** Uploads a new application emoji. */
+    create(options: ApplicationEmojiCreateOptions): Promise<APIEmoji>;
+    /** Renames an application emoji. */
+    edit(emojiId: string, options: {
+        name: string;
+    }): Promise<APIEmoji>;
+    /** Deletes an application emoji. */
+    remove(emojiId: string): Promise<void>;
+}

package/dist/managers/base.d.ts

@@ -6,9 +6,12 @@ export declare function splitReason<T extends {
 /** Generic cache manager. @typeParam K Cache key type. @typeParam V Cached value type. */
 export declare class Manager<K, V> {
     #private;
-    /** Authoritative resource state. Entries never expire: see {@link Manager.set}. */ readonly cache: Collection<K, V>;
-    /** Gets a cached value. @param id Cache key. @returns Cached value. */ get(id: K): V | undefined;
-    /** Checks whether a value is cached. @param id Cache key. @returns True when cached. */ has(id: K): boolean;
+    /** Authoritative resource state. Entries never expire: see {@link Manager.set}. */
+    readonly cache: Collection<K, V>;
+    /** Gets a cached value. @param id Cache key. @returns Cached value. */
+    get(id: K): V | undefined;
+    /** Checks whether a value is cached. @param id Cache key. @returns True when cached. */
+    has(id: K): boolean;
     /**
      * Runs a REST load for one key. Concurrent loads of that key share a
      * single request. If the key is written (e.g. by a Gateway update) or
@@ -18,17 +21,22 @@ export declare class Manager<K, V> {
      * @param store Stores a fresh result and returns the canonical instance.
      */
     protected fetchOnce(id: K, load: () => Promise<V>, store?: (value: V) => V): Promise<V>;
-    /** Stores a resource with `setWithoutTTL()`, so it leaves only on an explicit delete (e.g. a Gateway `*_DELETE`), never through TTL. @param id Cache key. @param value Value. @returns This manager. */ set(id: K, value: V): this;
-    /** Deletes a cached value. @param id Cache key. @returns True when deleted. */ delete(id: K): boolean;
-    /** Clears the cache. @returns Nothing. */ clear(): void;
-    /** Gets cache size. @returns Number of cached values. */ get size(): number;
-    /** Gets the first cached value. @returns First value. */ first(): V | undefined;
-    /** Returns cached values. @returns Array of values. */ values(): V[];
-    /** Finds a cached value. @param predicate Predicate. @returns Matching value. */ find(predicate: (value: V, key: K) => boolean): V | undefined;
-    /** Iterates cached entries. @returns Cache iterator. */ [Symbol.iterator](): IterableIterator<[
-        K,
-        V
-    ]>;
+    /** Stores a resource with `setWithoutTTL()`, so it leaves only on an explicit delete (e.g. a Gateway `*_DELETE`), never through TTL. @param id Cache key. @param value Value. @returns This manager. */
+    set(id: K, value: V): this;
+    /** Deletes a cached value. @param id Cache key. @returns True when deleted. */
+    delete(id: K): boolean;
+    /** Clears the cache. @returns Nothing. */
+    clear(): void;
+    /** Gets cache size. @returns Number of cached values. */
+    get size(): number;
+    /** Gets the first cached value. @returns First value. */
+    first(): V | undefined;
+    /** Returns cached values. @returns Array of values. */
+    values(): V[];
+    /** Finds a cached value. @param predicate Predicate. @returns Matching value. */
+    find(predicate: (value: V, key: K) => boolean): V | undefined;
+    /** Iterates cached entries. @returns Cache iterator. */
+    [Symbol.iterator](): IterableIterator<[K, V]>;
 }
 /** Generic REST-backed resource manager. @typeParam K Resource key type. @typeParam V Resource type. */
 export declare class ResourceManager<K, V> extends Manager<K, V> {

package/dist/managers/emoji.d.ts

@@ -35,8 +35,6 @@ export declare class EmojiManager extends Manager<string, Emoji> {
     edit(emojiId: string, options: EmojiEditOptions): Promise<Emoji>;
     /** Deletes a custom emoji. @param reason Audit-log reason. */
     remove(emojiId: string, reason?: string): Promise<void>;
-    /** @deprecated Use {@link EmojiManager.remove}, which also takes an audit-log reason. Removed in 0.3.0. */
-    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. */

package/dist/managers/guild-resources.d.ts

@@ -28,6 +28,14 @@ export declare class GuildBanManager extends Manager<string, APIBan> {
     }): Promise<APIBan[]>;
     /** Bans a user. */
     create(userId: string, options?: GuildBanCreateOptions): Promise<void>;
+    /**
+     * Bans up to 200 users at once. Users that cannot be banned (already
+     * banned, higher role, owner) come back in `failed`, not as an error.
+     */
+    bulk(userIds: readonly string[], options?: GuildBanCreateOptions): Promise<{
+        banned: string[];
+        failed: string[];
+    }>;
     /** Lifts a ban. */
     remove(userId: string, reason?: string): Promise<void>;
 }
@@ -50,9 +58,9 @@ export declare class GuildScheduledEventManager extends Manager<string, APIGuild
         withUserCount?: boolean;
     }): Promise<APIGuildScheduledEvent[]>;
     /** Creates an event. */
-    create(options: GuildScheduledEventOptions, reason?: string): Promise<APIGuildScheduledEvent>;
+    create(options: GuildScheduledEventOptions): Promise<APIGuildScheduledEvent>;
     /** Edits an event. */
-    edit(eventId: string, options: GuildScheduledEventOptions, reason?: string): Promise<APIGuildScheduledEvent>;
+    edit(eventId: string, options: GuildScheduledEventOptions): Promise<APIGuildScheduledEvent>;
     /** Deletes an event. @param reason Audit-log reason. */
     remove(eventId: string, reason?: string): Promise<void>;
     /** Fetches users subscribed to an event (`limit` 1-100). */
@@ -80,7 +88,7 @@ export declare class StageInstanceManager extends Manager<string, APIStageInstan
     #private;
     constructor(rest: REST);
     /** Starts a stage instance in a stage channel. */
-    create(channelId: string, options: StageInstanceCreateOptions, reason?: string): Promise<APIStageInstance>;
+    create(channelId: string, options: StageInstanceCreateOptions): Promise<APIStageInstance>;
     /** Fetches the stage instance of a stage channel. */
     fetch(channelId: string): Promise<APIStageInstance>;
     /** Edits a stage instance's topic or privacy level. */
@@ -88,7 +96,7 @@ export declare class StageInstanceManager extends Manager<string, APIStageInstan
         topic?: string;
         privacyLevel?: number;
         reason?: string;
-    }, reason?: string): Promise<APIStageInstance>;
+    }): Promise<APIStageInstance>;
     /** Ends a stage instance. */
     remove(channelId: string, reason?: string): Promise<void>;
 }
@@ -131,7 +139,7 @@ export declare class PermissionOverwriteManager {
         reason?: string;
     }): Promise<void>;
     /** Creates or replaces the overwrite for a role or member. */
-    edit(overwriteId: string, options: PermissionOverwriteOptions, reason?: string): Promise<void>;
+    edit(overwriteId: string, options: PermissionOverwriteOptions): Promise<void>;
     /** Deletes the overwrite for a role or member. */
     remove(overwriteId: string, reason?: string): Promise<void>;
 }

package/dist/managers/guild.d.ts

@@ -4,9 +4,9 @@ import { GuildSoundboardManager, GuildStickerManager } from "./advanced.js";
 import { GuildMemberManager } from "./member.js";
 import { RoleManager } from "./role.js";
 import { GuildBanManager, GuildScheduledEventManager } from "./guild-resources.js";
-import { Guild, AutoModerationRule, type ResourceContext } from "@lunibee/structures";
+import { AuditLog, Guild, AutoModerationRule, type ResourceContext } from "@lunibee/structures";
 import { type REST } from "@lunibee/rest";
-import { type APIChannel, type APIGuildPreview, type APIInvite, type APIWebhook, type APIAutoModerationRule, type APIInviteCreate, type APIVoiceState } from "@lunibee/types";
+import { type APIChannel, type APIGuildPreview, type APIInvite, type APIWebhook, type APIAutoModerationRule, type APIInviteCreate, type APIVoiceState, type APIPresenceUpdate, type APIWelcomeScreen, type APIWelcomeScreenChannel, type APIGuildOnboarding, type APIOnboardingPrompt } from "@lunibee/types";
 type GuildData = ConstructorParameters<typeof Guild>[0];
 export interface GuildCreateOptions extends Record<string, unknown> {
     name: string;
@@ -36,6 +36,8 @@ export declare class GuildManager extends ResourceManager<string, Guild> {
     soundboard(guildId: string): GuildSoundboardManager;
     /** Voice states by user ID for a guild, kept in sync by `GUILD_CREATE` and `VOICE_STATE_UPDATE`. */
     voiceStates(guildId: string): Manager<string, APIVoiceState>;
+    /** Latest presence by user ID for a guild; filled only when `cache.presences` is on. */
+    presences(guildId: string): Manager<string, APIPresenceUpdate>;
     /** Auto-moderation rules by ID for a guild, kept in sync by `AUTO_MODERATION_RULE_*` events. */
     autoModerationRules(guildId: string): Manager<string, APIAutoModerationRule>;
     /** Invites by code for a guild, kept in sync by `INVITE_CREATE` / `INVITE_DELETE`. */
@@ -50,10 +52,38 @@ export declare class GuildManager extends ResourceManager<string, Guild> {
     edit(id: string, options: GuildEditOptions): Promise<Guild>;
     /** Deletes a guild permanently. The bot must own it. */
     remove(id: string): Promise<void>;
-    /** @deprecated Use {@link GuildManager.remove}. Removed in 0.3.0. */
-    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 the welcome screen of a community guild. */
+    fetchWelcomeScreen(id: string): Promise<APIWelcomeScreen>;
+    /** Edits the welcome screen (needs Manage Guild and the Community feature). */
+    editWelcomeScreen(id: string, options: {
+        enabled?: boolean;
+        description?: string | null;
+        welcomeChannels?: APIWelcomeScreenChannel[] | null;
+        reason?: string;
+    }): Promise<APIWelcomeScreen>;
+    /** Fetches a guild's onboarding: prompts, default channels and mode. */
+    fetchOnboarding(id: string): Promise<APIGuildOnboarding>;
+    /** Replaces parts of a guild's onboarding (needs Manage Guild and Manage Roles). */
+    editOnboarding(id: string, options: {
+        prompts?: APIOnboardingPrompt[];
+        defaultChannelIds?: string[];
+        enabled?: boolean;
+        mode?: number;
+        reason?: string;
+    }): Promise<APIGuildOnboarding>;
+    /**
+     * Edits a voice state in a stage channel: unsuppress the bot to speak, or
+     * move a speaker back to the audience. `userId` may be `"@me"`.
+     */
+    editVoiceState(id: string, userId: string, options: {
+        channelId: string;
+        suppress?: boolean;
+        requestToSpeakTimestamp?: string | null;
+    }): Promise<void>;
+    /** Removes an integration (and the bot or role it created) from a guild. */
+    removeIntegration(id: string, integrationId: string, reason?: string): Promise<void>;
     /** Fetches all active threads in the guild. */
     fetchActiveThreads(id: string): Promise<{
         threads: APIChannel[];
@@ -76,6 +106,12 @@ export declare class GuildManager extends ResourceManager<string, Guild> {
         after?: string;
         limit?: number;
     }): Promise<AuditLogResponse>;
+    /**
+     * Fetches the audit log as an {@link AuditLog}: typed `info` per action
+     * type, and `find()` / `filter()` by type, target, user and time.
+     * @example const kick = (await guilds.fetchAuditLogEntries(id, { actionType: AuditLogEvent.MemberKick })).find({ targetId: userId, since: Date.now() - 60_000 });
+     */
+    fetchAuditLogEntries(guildId: string, options?: Parameters<GuildManager["fetchAuditLog"]>[1]): Promise<AuditLog>;
     /**
      * Fetches members from a guild (paginated).
      * @param guildId Guild identifier.

package/dist/managers/index.d.ts

@@ -3,17 +3,15 @@ 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 type { AllowedMentions, APIForumTag, ForumTagInput, MessageCreateOptions, MessageEditOptions } from "@lunibee/types";
 import { Channel, Message, User } from "@lunibee/structures";
-import { MessageManager, type MessageCacheOptions, type MessageCreateOptions as ManagerMessageCreateOptions } from "./message.js";
+import { MessageManager, type MessageCacheOptions } 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;
-};
+export type { MessageCreateOptions, MessageEditOptions } from "./message.js";
 export interface MessageFetchOptions {
     cache?: boolean;
 }
@@ -53,7 +51,7 @@ export declare class ChannelManager extends Manager<string, Channel> {
      */
     constructor(rest: REST, options?: {
         messageCache?: MessageCacheOptions;
-        allowedMentions?: unknown;
+        allowedMentions?: AllowedMentions;
     });
     messages(channelId: string): MessageManager;
     /** Permission overwrite manager for a channel. */
@@ -84,8 +82,6 @@ export declare class ChannelManager extends Manager<string, Channel> {
     edit(channelId: string, options: ChannelEditOptions): Promise<Channel>;
     /** Deletes a channel (or closes a DM). @param reason Audit-log reason. */
     remove(channelId: string, reason?: string): Promise<void>;
-    /** @deprecated Use {@link ChannelManager.remove}, which also takes an audit-log reason. Removed in 0.3.0. */
-    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
@@ -93,8 +89,6 @@ export declare class ChannelManager extends Manager<string, Channel> {
      * messages too, instead of retaining them for the client's lifetime. */
     delete(channelId: string): boolean;
     send(channelId: string, options: MessageCreateOptions): Promise<Message>;
-    /** @deprecated Use {@link ChannelManager.send}. Removed in 0.3.0. */
-    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;
@@ -124,6 +118,22 @@ export declare class ChannelManager extends Manager<string, Channel> {
     removeAllReactions(channelId: string, messageId: string): Promise<void>;
     /** Fetches the newest pinned messages (one page, up to 50, like the endpoint it replaces). */
     fetchPinnedMessages(channelId: string): Promise<Message[]>;
+    /** Fetches pinned messages a page at a time, newest first (`limit` 1-50, `before` an ISO timestamp from the previous page). */
+    fetchPins(channelId: string, options?: {
+        before?: string;
+        limit?: number;
+    }): Promise<{
+        messages: Message[];
+        hasMore: boolean;
+    }>;
+    /** Shows "the bot is typing…" for about ten seconds, or until it sends a message. */
+    triggerTyping(channelId: string): Promise<void>;
+    /** Adds a tag to a forum or media channel and returns the channel's tags. @param reason Audit-log reason. */
+    createForumTag(channelId: string, tag: ForumTagInput, reason?: string): Promise<APIForumTag[]>;
+    /** Changes a forum tag and returns the channel's tags. */
+    editForumTag(channelId: string, tagId: string, changes: Partial<ForumTagInput>, reason?: string): Promise<APIForumTag[]>;
+    /** Removes a forum tag and returns the channel's remaining tags. */
+    removeForumTag(channelId: string, tagId: string, reason?: string): Promise<APIForumTag[]>;
     /** Pins a message. @param reason Audit-log reason. */
     pinMessage(channelId: string, messageId: string, reason?: string): Promise<void>;
     /** Unpins a message. @param reason Audit-log reason. */
@@ -147,8 +157,6 @@ export declare class ChannelManager extends Manager<string, Channel> {
         after?: string;
         hasMore: boolean;
     }>;
-    /** @deprecated Use {@link ChannelManager.bulkDeleteMessages}, which also takes an audit-log reason. Removed in 0.3.0. */
-    bulkDelete(channelId: string, messageIds: string[]): Promise<void>;
     clear(): void;
 }
 export type CreateMessageOptions = MessageCreateOptions;
@@ -159,4 +167,4 @@ export { GuildMemberManager, type MemberEditOptions, type BanOptions, } from "./
 export { ApplicationCommandManager } from "./application.js";
 export { GuildBanManager, GuildScheduledEventManager, StageInstanceManager, PermissionOverwriteManager, type APIBan, type GuildBanCreateOptions, type GuildScheduledEventOptions, type StageInstanceCreateOptions, type PermissionOverwriteOptions, type PermissionOverwriteTargetType, type PermissionOverwriteUpdate, } from "./guild-resources.js";
 export { EmojiManager, type EmojiCreateOptions, type EmojiEditOptions, } from "./emoji.js";
-export { GuildStickerManager, GuildSoundboardManager, MonetizationManager, type APIEntitlement, type APISKU, type APISoundboardSound, type APISubscription, type EntitlementQuery, type GuildStickerCreateOptions, type SoundboardSoundCreateOptions, } from "./advanced.js";
+export { GuildStickerManager, GuildSoundboardManager, MonetizationManager, ApplicationEmojiManager, type APIEntitlement, type APISKU, type APISoundboardSound, type APISubscription, type EntitlementQuery, type GuildStickerCreateOptions, type SoundboardSoundCreateOptions, } from "./advanced.js";