lunibee 0.3.1 → 0.3.3

package/dist/managers/application.d.ts

@@ -1,5 +1,9 @@
 import { REST } from "@lunibee/rest";
 import type { APIApplicationCommand, ApplicationCommandData } from "@lunibee/types";
+/** Command data, or a builder such as `CreateSlashCommand` (its `toJSON()` is sent). */
+export type ApplicationCommandInput = ApplicationCommandData | {
+    toJSON(): Record<string, unknown>;
+};
 /** Manages global and guild-scoped application commands for a Discord application. */
 export declare class ApplicationCommandManager {
     #private;
@@ -8,21 +12,21 @@ export declare class ApplicationCommandManager {
     /** Fetches all global application commands. @returns Array of registered commands. */
     fetch(): Promise<APIApplicationCommand[]>;
     /** Creates a single global application command. @param data Command data. @returns Created command. */
-    create(data: ApplicationCommandData): Promise<APIApplicationCommand>;
+    create(data: ApplicationCommandInput): Promise<APIApplicationCommand>;
     /** Overwrites all global application commands atomically. @param commands Array of command data. @returns New full command list. */
-    set(commands: ApplicationCommandData[]): Promise<APIApplicationCommand[]>;
+    set(commands: readonly ApplicationCommandInput[]): Promise<APIApplicationCommand[]>;
     /** Edits a global application command. @param commandId Command identifier. @param data Partial command data. @returns Updated command. */
-    edit(commandId: string, data: Partial<ApplicationCommandData>): Promise<APIApplicationCommand>;
+    edit(commandId: string, data: Partial<ApplicationCommandData> | ApplicationCommandInput): Promise<APIApplicationCommand>;
     /** Deletes a global application command. @param commandId Command identifier. @returns Nothing. */
     delete(commandId: string): Promise<void>;
     /** Fetches all guild-scoped application commands. @param guildId Guild identifier. @returns Array of registered guild commands. */
     fetchGuild(guildId: string): Promise<APIApplicationCommand[]>;
     /** Creates a single guild-scoped application command. @param guildId Guild identifier. @param data Command data. @returns Created command. */
-    createGuild(guildId: string, data: ApplicationCommandData): Promise<APIApplicationCommand>;
+    createGuild(guildId: string, data: ApplicationCommandInput): Promise<APIApplicationCommand>;
     /** Overwrites all guild-scoped application commands atomically. @param guildId Guild identifier. @param commands Array of command data. @returns New full command list. */
-    setGuild(guildId: string, commands: ApplicationCommandData[]): Promise<APIApplicationCommand[]>;
+    setGuild(guildId: string, commands: readonly ApplicationCommandInput[]): Promise<APIApplicationCommand[]>;
     /** Edits a guild-scoped application command. @param guildId Guild identifier. @param commandId Command identifier. @param data Partial command data. @returns Updated command. */
-    editGuild(guildId: string, commandId: string, data: Partial<ApplicationCommandData>): Promise<APIApplicationCommand>;
+    editGuild(guildId: string, commandId: string, data: Partial<ApplicationCommandData> | ApplicationCommandInput): Promise<APIApplicationCommand>;
     /** Deletes a guild-scoped application command. @param guildId Guild identifier. @param commandId Command identifier. @returns Nothing. */
     deleteGuild(guildId: string, commandId: string): Promise<void>;
 }

package/dist/managers/base.d.ts

@@ -1,4 +1,11 @@
 import { Collection } from "@lunibee/collection";
+/**
+ * Copies a structure's own fields onto the cached instance. A key loop: on Bun,
+ * Object.assign into an existing object is about twice as slow, on every event.
+ * Structures hold no symbol-keyed fields.
+ * @internal
+ */
+export declare function assignFields<T extends object>(into: T, from: T): T;
 /** Splits the audit-log `reason` off an options object, so it becomes a header, not a body field. */
 export declare function splitReason<T extends {
     reason?: string;
@@ -8,6 +15,8 @@ export declare class Manager<K, V> {
     #private;
     /** Authoritative resource state. Entries never expire: see {@link Manager.set}. */
     readonly cache: Collection<K, V>;
+    /** @param maxSize Most entries kept; the least recently used go first. Default: unbounded. */
+    constructor(maxSize?: number);
     /** 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. */
@@ -41,8 +50,9 @@ export declare class Manager<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> {
     #private;
-    constructor(fetcher: (id: K) => Promise<V>, key: (value: V) => K);
+    constructor(fetcher: (id: K) => Promise<V>, key: (value: V) => K, maxSize?: number);
     resolve(id: K): Promise<V>;
+    /** Fetches from Discord; a cached instance is updated in place, so references to it stay current. */
     fetch(id: K): Promise<V>;
     fetchMany(ids: Iterable<K>): Promise<V[]>;
     /** Stores a resource, merging into the cached instance when there is one so existing references stay current. @returns The canonical instance. */

package/dist/managers/guild.d.ts

@@ -19,7 +19,9 @@ export declare class GuildManager extends ResourceManager<string, Guild> {
     #private;
     /** Lets members from this manager act through a client (`member.kick()`...). Called by the client. */
     attachContext(context: ResourceContext): void;
-    constructor(rest: REST);
+    constructor(rest: REST, options?: {
+        maxMembers?: number;
+    });
     /** Ban manager for a guild (one instance per guild). */
     bans(guildId: string): GuildBanManager;
     /** Scheduled-event manager for a guild (one instance per guild). */

package/dist/managers/index.d.ts

@@ -12,20 +12,24 @@ export { GuildManager } from "./guild.js";
 export type { AuditLogEntry, AuditLogResponse } from "./guild.js";
 export { AuditLogEvent } from "./guild.js";
 export type { MessageCreateOptions, MessageEditOptions } from "./message.js";
+/** Options for fetching one message; `cache: false` skips storing it. */
 export interface MessageFetchOptions {
     cache?: boolean;
 }
+/** Pagination for fetching a channel's messages: `before`, `after` or `around` an ID, and a `limit`. */
 export interface MessageQueryOptions {
     before?: string;
     after?: string;
     around?: string;
     limit?: number;
 }
+/** Options for starting a thread from a message. */
 export interface MessageThreadOptions {
     name: string;
     autoArchiveDuration?: 60 | 1440 | 4320 | 10080;
     rateLimitPerUser?: number;
 }
+/** Pagination for listing the users who reacted with an emoji. */
 export interface ReactionFetchOptions {
     limit?: number;
     after?: string;
@@ -159,12 +163,13 @@ export declare class ChannelManager extends Manager<string, Channel> {
     }>;
     clear(): void;
 }
+/** Discord.js-familiar name for `MessageCreateOptions`. */
 export type CreateMessageOptions = MessageCreateOptions;
 export { MessageManager, toRequest, type MessageCacheOptions, type MessageFile, } from "./message.js";
 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 { ApplicationCommandManager, type ApplicationCommandInput, } 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, ApplicationEmojiManager, type APIEntitlement, type APISKU, type APISoundboardSound, type APISubscription, type EntitlementQuery, type GuildStickerCreateOptions, type SoundboardSoundCreateOptions, } from "./advanced.js";