lunibee 0.1.0 → 0.1.2

package/dist/managers/application.d.ts

@@ -0,0 +1,28 @@
+import { REST } from "@lunibee/rest";
+import type { APIApplicationCommand, ApplicationCommandData } from "@lunibee/types";
+/** Manages global and guild-scoped application commands for a Discord application. */
+export declare class ApplicationCommandManager {
+    #private;
+    /** Creates an application command manager. @param rest REST transport. @param applicationId Application identifier. */
+    constructor(rest: REST, applicationId: string);
+    /** 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>;
+    /** Overwrites all global application commands atomically. @param commands Array of command data. @returns New full command list. */
+    set(commands: ApplicationCommandData[]): 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>;
+    /** 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>;
+    /** 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[]>;
+    /** 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>;
+    /** 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

@@ -0,0 +1,28 @@
+import { Collection } from "@lunibee/collection";
+/** Generic cache manager. @typeParam K Cache key type. @typeParam V Cached value type. */
+export declare class Manager<K, V> {
+    /** Cached resources. */ 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;
+    /** Stores a value. @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> {
+    #private;
+    constructor(fetcher: (id: K) => Promise<V>, key: (value: V) => K);
+    resolve(id: K): Promise<V>;
+    fetch(id: K): Promise<V>;
+    fetchMany(ids: Iterable<K>): Promise<V[]>;
+    upsert(resource: V): V;
+    update(resource: V): V;
+}

package/dist/managers/index.d.ts

@@ -0,0 +1,96 @@
+import { Manager, ResourceManager } 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 { 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 interface MessageFetchOptions {
+    /** Whether to use cache. */ 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;
+}
+/** Message thread creation options. */
+export interface MessageThreadOptions {
+    /** Thread name. */ name: string;
+    /** Auto archive duration. */ autoArchiveDuration?: 60 | 1440 | 4320 | 10080;
+    /** Slowmode duration. */ rateLimitPerUser?: number;
+}
+/** Reaction list options. */
+export interface ReactionFetchOptions {
+    /** Maximum reactions. */ limit?: number;
+    /** Reaction pagination cursor. */ after?: string;
+}
+/** 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 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;
+}
+/** 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";