lunibee 0.1.8 → 0.2.0

package/dist/managers/message.d.ts

@@ -1,4 +1,12 @@
 import { Collection } from "@lunibee/collection";
+/** 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 {
+    /** Messages kept per channel; least-recently-used are evicted. Default 100. */
+    maxSize?: number;
+    /** Sliding TTL in ms. Omit for no expiry. */
+    ttl?: number;
+}
 import { REST } from "@lunibee/rest";
 import { Message, type ResourceContext } from "@lunibee/structures";
 export type MessageCreateOptions = Record<string, unknown> & {
@@ -9,8 +17,9 @@ export type MessageEditOptions = Record<string, unknown> & {
 };
 export declare class MessageManager {
     #private;
+    /** Cached messages; always empty unless a message cache is configured. */
     readonly cache: Collection<string, Message>;
-    constructor(rest: REST, context: ResourceContext, channelId: string);
+    constructor(rest: REST, context: ResourceContext, channelId: string, cache?: MessageCacheOptions);
     resolve(messageId: string): Promise<Message>;
     send(options: MessageCreateOptions): Promise<Message>;
     fetch(messageId: string): Promise<Message>;

package/dist/rest/errors.d.ts

@@ -1,5 +1,34 @@
+/** Why a REST request failed, for handling without matching on status codes. */
+export type RESTErrorKind = 
+/** Cancelled through an AbortSignal. */
+"aborted"
+/** The attempt exceeded the transport timeout. */
+ | "timeout"
+/** No response: DNS, TLS, connection reset. */
+ | "network"
+/** 429 that outlived the retry budget. */
+ | "rateLimited"
+/** 401: invalid or revoked token. */
+ | "authentication"
+/** 403: missing access or permissions. */
+ | "permission"
+/** 404: unknown resource. */
+ | "notFound"
+/** 400 / 422: the request body or parameters were rejected. */
+ | "validation"
+/** 5xx: Discord failed to handle the request. */
+ | "server"
+/** Any other 4xx. */
+ | "client";
+/**
+ * Replaces the token segment of webhook and interaction paths with `:token`,
+ * so request paths can appear in errors, hooks and logs without leaking a
+ * credential.
+ */
+export declare function redactPath(path: string): string;
 /** Error thrown when Discord rejects a REST request. */
 export declare class RESTError extends Error {
+    /** Failure category. */ readonly kind: RESTErrorKind;
     /** HTTP status returned by Discord. */ readonly status: number;
     /** Discord API error code, when provided. */ readonly code?: number;
     /** Raw Discord validation/error payload. */ readonly errors?: unknown;
@@ -10,7 +39,11 @@ export declare class RESTError extends Error {
         method?: string;
         path?: string;
         cause?: unknown;
+        kind?: RESTErrorKind;
     });
+    /** Whether sending the same request again later could succeed. Validation,
+     * permission, authentication and not-found failures never will. */
+    get retryable(): boolean;
 }
 /** Creates the cancellation error shared by every stage of the request pipeline. */
 export declare function abortError(path: string, reason: unknown): RESTError;

package/dist/rest/index.d.ts

@@ -160,7 +160,7 @@ export declare class REST {
     patchWithFiles<T>(path: string, payload: unknown, files: RESTFileAttachment[], options?: RESTRequestOptions): Promise<T>;
 }
 export { Routes } from "./routes.js";
-export { RESTError, abortError } from "./errors.js";
+export { RESTError, abortError, redactPath, type RESTErrorKind, } from "./errors.js";
 export { createRouteKey, normalizeRoutePath, majorParameter, scopeBucket, serializeQuery, type RouteKey, type RESTQuery, } from "./route.js";
 export { RequestScheduler } from "./scheduler.js";
 export { RateLimiter } from "./limiter.js";

package/dist/rest/index.js

@@ -2,7 +2,7 @@
 // packages/rest/package.json
 var package_default = {
   name: "@lunibee/rest",
-  version: "0.1.8",
+  version: "0.2.0",
   type: "module",
   module: "./src/index.ts",
   types: "./src/index.ts",
@@ -62,7 +62,29 @@ class MemoryRateLimitStore {
 }
 
 // packages/rest/src/errors.ts
+function kindFromStatus(status) {
+  if (status === 429)
+    return "rateLimited";
+  if (status === 401)
+    return "authentication";
+  if (status === 403)
+    return "permission";
+  if (status === 404)
+    return "notFound";
+  if (status === 400 || status === 422)
+    return "validation";
+  if (status >= 500)
+    return "server";
+  if (status === 0)
+    return "network";
+  return "client";
+}
+function redactPath(path) {
+  return path.replace(/^(\/webhooks\/[^/?]+\/)[^/?]+/, "$1:token").replace(/^(\/interactions\/[^/?]+\/)[^/?]+/, "$1:token");
+}
+
 class RESTError extends Error {
+  kind;
   status;
   code;
   errors;
@@ -72,14 +94,18 @@ class RESTError extends Error {
     super(message, options.cause === undefined ? undefined : { cause: options.cause });
     this.name = "RESTError";
     this.status = status;
+    this.kind = options.kind ?? kindFromStatus(status);
     this.code = code;
     this.errors = errors;
     this.method = options.method;
-    this.path = options.path;
+    this.path = options.path === undefined ? undefined : redactPath(options.path);
+  }
+  get retryable() {
+    return this.kind === "rateLimited" || this.kind === "server" || this.kind === "network" || this.kind === "timeout";
   }
 }
 function abortError(path, reason) {
-  return new RESTError(reason instanceof Error ? reason.message : "Discord REST request was aborted", 0, undefined, undefined, { path, cause: reason });
+  return new RESTError(reason instanceof Error ? reason.message : "Discord REST request was aborted", 0, undefined, undefined, { path, cause: reason, kind: "aborted" });
 }
 async function sleep(delay, signal, path) {
   if (delay <= 0)
@@ -414,8 +440,23 @@ var Routes = {
   invite: (code) => `/invites/${encodeURIComponent(code)}`,
   guildVanity: (guildId) => `/guilds/${snowflake(guildId, "Guild ID")}/vanity-url`,
   guildEmoji: (guildId, emojiId) => emojiId ? `/guilds/${snowflake(guildId, "Guild ID")}/emojis/${snowflake(emojiId, "Emoji ID")}` : `/guilds/${snowflake(guildId, "Guild ID")}/emojis`,
-  applicationEmoji: (applicationId, emojiId) => emojiId ? `/applications/${snowflake(applicationId, "Application ID")}/emojis/${snowflake(emojiId, "Emoji ID")}` : `/applications/${snowflake(applicationId, "Application ID")}/emojis`
+  applicationEmoji: (applicationId, emojiId) => emojiId ? `/applications/${snowflake(applicationId, "Application ID")}/emojis/${snowflake(emojiId, "Emoji ID")}` : `/applications/${snowflake(applicationId, "Application ID")}/emojis`,
+  pollExpire: (channelId, messageId) => `/channels/${snowflake(channelId, "Channel ID")}/polls/${snowflake(messageId, "Message ID")}/expire`,
+  pollAnswerVoters: (channelId, messageId, answerId) => `/channels/${snowflake(channelId, "Channel ID")}/polls/${snowflake(messageId, "Message ID")}/answers/${integer(answerId, "Answer ID")}`,
+  guildSticker: (guildId, stickerId) => stickerId ? `/guilds/${snowflake(guildId, "Guild ID")}/stickers/${snowflake(stickerId, "Sticker ID")}` : `/guilds/${snowflake(guildId, "Guild ID")}/stickers`,
+  sendSoundboardSound: (channelId) => `/channels/${snowflake(channelId, "Channel ID")}/send-soundboard-sound`,
+  soundboardDefaultSounds: () => "/soundboard-default-sounds",
+  guildSoundboardSound: (guildId, soundId) => soundId ? `/guilds/${snowflake(guildId, "Guild ID")}/soundboard-sounds/${snowflake(soundId, "Sound ID")}` : `/guilds/${snowflake(guildId, "Guild ID")}/soundboard-sounds`,
+  applicationSkus: (applicationId) => `/applications/${snowflake(applicationId, "Application ID")}/skus`,
+  applicationEntitlement: (applicationId, entitlementId) => entitlementId ? `/applications/${snowflake(applicationId, "Application ID")}/entitlements/${snowflake(entitlementId, "Entitlement ID")}` : `/applications/${snowflake(applicationId, "Application ID")}/entitlements`,
+  consumeEntitlement: (applicationId, entitlementId) => `/applications/${snowflake(applicationId, "Application ID")}/entitlements/${snowflake(entitlementId, "Entitlement ID")}/consume`,
+  skuSubscription: (skuId, subscriptionId) => subscriptionId ? `/skus/${snowflake(skuId, "SKU ID")}/subscriptions/${snowflake(subscriptionId, "Subscription ID")}` : `/skus/${snowflake(skuId, "SKU ID")}/subscriptions`
 };
+function integer(value, field) {
+  if (!Number.isInteger(value) || value < 0)
+    throw new TypeError(`${field} must be a non-negative integer.`);
+  return String(value);
+}
 function snowflake(value, field) {
   if (!/^\d{1,20}$/.test(value))
     throw new TypeError(`${field} must be a valid Discord snowflake.`);
@@ -729,7 +770,8 @@ class REST {
         throw new RESTError(failure.message, 0, undefined, undefined, {
           method,
           path,
-          cause: failure.cause ?? failure
+          cause: failure.cause ?? failure,
+          kind: failure.timedOut ? "timeout" : "network"
         });
       }
       this.#emit(this.#hooks.onResponse, {
@@ -828,6 +870,9 @@ class REST {
   #emit(hook, ctx) {
     if (!hook)
       return;
+    const withPath = ctx;
+    if (typeof withPath.path === "string")
+      ctx = { ...ctx, path: redactPath(withPath.path) };
     Promise.resolve().then(() => hook(ctx)).catch(() => {});
   }
 }
@@ -849,8 +894,9 @@ export {
   createRouteKey,
   majorParameter,
   normalizeRoutePath,
+  redactPath,
   scopeBucket,
   serializeQuery
 };
 
-//# debugId=CCF20CDF4862826C64756E2164756E21
+//# debugId=3E6A1976705386FE64756E2164756E21