lunibee 0.3.3 → 0.4.0

package/dist/managers/member.d.ts

@@ -1,5 +1,5 @@
-import { REST } from "@lunibee/rest";
-import { GuildMember, type ResourceContext } from "@lunibee/structures";
+import { REST } from "../rest/index.js";
+import { GuildMember, type ResourceContext } from "../structures/index.js";
 import { ResourceManager } from "./base.js";
 /** Fields that can change when editing a guild member (nickname, roles, voice state, timeout). */
 export interface MemberEditOptions {

package/dist/managers/message.d.ts

@@ -1,4 +1,4 @@
-import { Collection } from "@lunibee/collection";
+import { Collection } from "../collection/index.js";
 /** Opt-in per-channel message cache. Messages are temporary data, so they
  * use bounded TTL/LRU storage rather than permanent resource storage. */
 export interface MessageCacheOptions {
@@ -7,9 +7,9 @@ export interface MessageCacheOptions {
     /** Sliding TTL in ms. Omit for no expiry. */
     ttl?: number;
 }
-import { REST, type RESTFileAttachment } from "@lunibee/rest";
-import type { AllowedMentions, MessageCreateOptions, MessageEditOptions, MessageFile, MessageFileSource } from "@lunibee/types";
-import { Message, type ResourceContext } from "@lunibee/structures";
+import { REST, type RESTFileAttachment } from "../rest/index.js";
+import type { AllowedMentions, MessageCreateOptions, MessageEditOptions, MessageFile, MessageFileSource } from "../types/index.js";
+import { Message, type ResourceContext } from "../structures/index.js";
 export type { MessageCreateOptions, MessageEditOptions, MessageFile, MessageFileSource, };
 /**
  * Turns message files into REST uploads, encoding string data as UTF-8. A file
@@ -27,9 +27,9 @@ export declare function toAttachments(files: readonly (MessageFile | MessageFile
  * @throws {TypeError} If the object is invalid.
  */
 export declare function assertAllowedMentions(mentions: AllowedMentions): void;
-export declare function toRequest(options: MessageCreateOptions, allowedMentions?: AllowedMentions): Omit<MessageCreateOptions, "files"> | {
+export declare function toRequest(options: MessageCreateOptions, allowedMentions?: AllowedMentions): {
     body: Omit<MessageCreateOptions, "files">;
-    files: RESTFileAttachment[];
+    files?: RESTFileAttachment[];
 };
 export declare class MessageManager {
     #private;
@@ -38,7 +38,15 @@ export declare class MessageManager {
     constructor(rest: REST, context: ResourceContext, channelId: string, cache?: MessageCacheOptions, allowedMentions?: AllowedMentions);
     resolve(messageId: string): Promise<Message>;
     send(options: MessageCreateOptions): Promise<Message>;
+    /**
+     * Fetches a message. Concurrent fetches of one message share a request.
+     * If the message is stored or deleted (e.g. by a Gateway event) while the
+     * request is in flight, the result is returned but not cached, so it
+     * cannot overwrite fresher state or bring back a deleted message.
+     */
     fetch(messageId: string): Promise<Message>;
+    /** Stores a message as the cached version (when caching is on), replacing any cached one. @returns This manager. */
+    set(messageId: string, message: Message): this;
     fetchMany(messageIds: Iterable<string>): Promise<Message[]>;
     upsert(data: ConstructorParameters<typeof Message>[0]): Message;
     delete(messageId: string): boolean;

package/dist/managers/role.d.ts

@@ -1,5 +1,5 @@
-import { REST } from "@lunibee/rest";
-import { Role } from "@lunibee/structures";
+import { REST } from "../rest/index.js";
+import { Role } from "../structures/index.js";
 import { ResourceManager } from "./base.js";
 /** Role fields shared by create and edit. */
 interface RoleStyleOptions {

package/dist/managers/thread.d.ts

@@ -1,6 +1,6 @@
-import { REST } from "@lunibee/rest";
-import { Channel, type ResourceContext } from "@lunibee/structures";
-import type { AllowedMentions, APIGuildMember, APIThreadMember, MessageCreateOptions } from "@lunibee/types";
+import { REST } from "../rest/index.js";
+import { Channel, type ResourceContext } from "../structures/index.js";
+import type { AllowedMentions, APIGuildMember, APIThreadMember, MessageCreateOptions } from "../types/index.js";
 /** Options shared by every way of starting a thread. */
 export interface ThreadCreateOptions {
     name: string;

package/dist/managers/user.d.ts

@@ -1,7 +1,7 @@
 import { ResourceManager } from "./base.js";
-import { User } from "@lunibee/structures";
-import { type REST } from "@lunibee/rest";
-import type { APIChannel } from "@lunibee/types";
+import { User } from "../structures/index.js";
+import { type REST } from "../rest/index.js";
+import type { APIChannel } from "../types/index.js";
 /** A guild as `GET /users/@me/guilds` lists it. */
 export interface APIPartialGuild {
     id: string;
@@ -19,7 +19,10 @@ export interface UserEditOptions {
 }
 export declare class UserManager extends ResourceManager<string, User> {
     #private;
-    constructor(rest: REST);
+    /** @param options.maxSize Most users kept; the least recently used go first. Default: unbounded. */
+    constructor(rest: REST, options?: {
+        maxSize?: number;
+    });
     /** Gets the currently logged-in bot user. */
     fetchMe(): Promise<User>;
     /** Modifies the currently logged-in bot user. */

package/dist/rest/index.d.ts

@@ -1,5 +1,4 @@
 import { type RateLimitStore } from "./store.js";
-import { RESTError } from "./errors.js";
 import { type RESTQuery } from "./route.js";
 import { type CoordinationMode, type RESTTelemetry } from "./telemetry.js";
 import { HttpTransport } from "./transport.js";
@@ -13,9 +12,8 @@ export interface RESTFileAttachment {
 /**
  * Options controlling an individual REST request.
  *
- * Lunibee's canonical call shape is positional (`post(path, body)`); these options
- * add the Discord.js-`@discordjs/rest`-familiar per-request knobs (`query`, `headers`,
- * `reason`, `auth`) additively without changing that positional default.
+ * The body is positional (`post(path, body, options)`); these options carry the
+ * per-request knobs (`query`, `headers`, `reason`, `auth`, `signal`, `maxQueueWait`).
  */
 export interface RESTRequestOptions {
     /** Abort signal used to cancel the request and any queued wait. */
@@ -36,28 +34,15 @@ export interface RESTRequestOptions {
     maxQueueWait?: number;
 }
 /**
- * Discord.js-familiar request payload. Superset of {@link RESTRequestOptions} that also
- * carries the `body` and `files`, matching `@discordjs/rest`'s `RequestData`. It powers the
- * additive `method(path, { body })` overloads without breaking the positional signature.
+ * Request options plus `files` (which upgrade the request to multipart) and, for
+ * `get()` and `delete()` (which take no positional body), an optional `body`.
  */
 export interface RequestData extends RESTRequestOptions {
-    /** Request body. Encoded as JSON unless `files` are present (then multipart). */
+    /** Request body for `get()` and `delete()`; `request()`, `post()`, `put()` and `patch()` take theirs positionally. */
     body?: unknown;
     /** File attachments; presence upgrades the request to `multipart/form-data`. */
     files?: RESTFileAttachment[];
 }
-/**
- * The single-object form of {@link REST.request}, matching `@discordjs/rest`:
- * the route is `path` (or its Discord.js name, `fullRoute`).
- */
-export interface RequestOptionsObject extends RequestData {
-    /** HTTP method. */
-    method: string;
-    /** API path, starting with `/`. */
-    path?: string;
-    /** Alias of `path`, as `@discordjs/rest` names it. */
-    fullRoute?: string;
-}
 /** Context passed to `RESTHooks.onRequest`. */
 export interface RESTRequestContext {
     method: string;
@@ -219,23 +204,19 @@ export declare class REST {
      * @param method HTTP method.
      * @param path API path.
      * @param body Optional JSON body, FormData for file uploads, or undefined.
-     * @param options Request options: cancellation `signal` plus the Discord.js-familiar
-     *   `query`, `headers`, `reason`, `auth`, and `files` (which upgrade to multipart).
+     * @param options Request options: cancellation `signal`, `query`, `headers`,
+     *   `reason`, `auth`, and `files` (which upgrade to multipart).
      * @returns Decoded response body.
      * @throws {RESTError} If Discord or transport rejects the request.
      */
-    request<T>(options: RequestOptionsObject): Promise<T>;
     request<T>(method: string, path: string, body?: unknown, options?: RequestData): Promise<T>;
     /** Sends a GET request. @param path API path. @param options Request options (`query`, `headers`, `signal`, …). @returns Decoded response. @throws {RESTError} When the request fails. */
     get<T>(path: string, options?: RequestData): Promise<T>;
-    /** Sends a POST request. Accepts a raw body (`post(path, body)`) or a Discord.js-familiar `post(path, { body })`. @param path API path. @param body Optional JSON body, or a `RequestData` wrapper. @param options Request options. @returns Decoded response. @throws {RESTError} When the request fails. */
-    post<T>(path: string, options: RequestData): Promise<T>;
+    /** Sends a POST request. @param path API path. @param body Optional JSON body. @param options Request options (`files`, `reason`, `query`, `headers`, `signal`, …). @returns Decoded response. @throws {RESTError} When the request fails. */
     post<T>(path: string, body?: unknown, options?: RequestData): Promise<T>;
-    /** Sends a PATCH request. Accepts a raw body (`patch(path, body)`) or a Discord.js-familiar `patch(path, { body })`. @param path API path. @param body Optional JSON body, or a `RequestData` wrapper. @param options Request options. @returns Decoded response. @throws {RESTError} When the request fails. */
-    patch<T>(path: string, options: RequestData): Promise<T>;
+    /** Sends a PATCH request. @param path API path. @param body Optional JSON body. @param options Request options (`files`, `reason`, `query`, `headers`, `signal`, …). @returns Decoded response. @throws {RESTError} When the request fails. */
     patch<T>(path: string, body?: unknown, options?: RequestData): Promise<T>;
-    /** Sends a PUT request. Accepts a raw body (`put(path, body)`) or a Discord.js-familiar `put(path, { body })`. @param path API path. @param body Optional JSON body, or a `RequestData` wrapper. @param options Request options. @returns Decoded response. @throws {RESTError} When the request fails. */
-    put<T>(path: string, options: RequestData): Promise<T>;
+    /** Sends a PUT request. @param path API path. @param body Optional JSON body. @param options Request options (`files`, `reason`, `query`, `headers`, `signal`, …). @returns Decoded response. @throws {RESTError} When the request fails. */
     put<T>(path: string, body?: unknown, options?: RequestData): Promise<T>;
     /** Sends a DELETE request. @param path API path. @param options Request options (`reason`, `headers`, `signal`, …). @returns Decoded response. @throws {RESTError} When the request fails. */
     delete<T>(path: string, options?: RequestData): Promise<T>;
@@ -275,9 +256,3 @@ export { ResponseDecoder, type DecodedError } from "./decoder.js";
 export { type RateLimitStore, type BucketState, type BucketUpdate, type Reservation, type ReserveOptions, MemoryRateLimitStore, } from "./store.js";
 export { RedisRateLimitStore, fromBunRedis, type RedisRateLimitStoreOptions, type RedisFailurePolicy, type RedisStoreDiagnostics, type MinimalRedisClient, } from "./redis.js";
 export { WebhookClient, type WebhookClientOptions, type WebhookMessageOptions, } from "./webhook.js";
-/**
- * Discord.js-familiar alias for {@link RESTError}. `@discordjs/rest` throws `DiscordAPIError`
- * on a Discord-rejected request; Lunibee keeps `RESTError` as the canonical class and exports
- * this alias so Discord.js-shaped `catch (err) { if (err instanceof DiscordAPIError) … }` works.
- */
-export { RESTError as DiscordAPIError };