lunibee 0.1.7 → 0.1.8

package/dist/rest/decoder.d.ts

@@ -0,0 +1,23 @@
+/** Normalised shape of a Discord error payload. */
+export interface DecodedError {
+    message?: string;
+    code?: number;
+    retry_after?: number;
+    global?: boolean;
+}
+/** Turns a raw {@link Response} into a payload and the error metadata retries need. */
+export declare class ResponseDecoder {
+    /** Reads a Discord response payload as JSON, text, or nothing for 204. */
+    read(response: Response): Promise<unknown>;
+    /** Extracts Discord's error metadata from a decoded payload. */
+    errorData(payload: unknown): DecodedError;
+    /**
+     * Resolves Retry-After (seconds) from the payload, falling back to the
+     * header and finally to one second.
+     *
+     * An absent header is explicitly *not* a zero delay: `Number(null)` is 0,
+     * which is finite, so reading it directly would answer a 429 that carries
+     * no Retry-After by retrying immediately — exactly when backing off matters.
+     */
+    retryAfter(response: Response, data: DecodedError): number;
+}

package/dist/rest/errors.d.ts

@@ -0,0 +1,20 @@
+/** Error thrown when Discord rejects a REST request. */
+export declare class RESTError extends Error {
+    /** 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;
+    /** HTTP method used for the failed request. */ readonly method?: string;
+    /** API path used for the failed request. */ readonly path?: string;
+    /** Creates a REST error with request context. @param message Error message. @param status HTTP status. @param code Discord error code. @param errors Raw error payload. @param options Request context and cause. */
+    constructor(message: string, status: number, code?: number, errors?: unknown, options?: {
+        method?: string;
+        path?: string;
+        cause?: unknown;
+    });
+}
+/** Creates the cancellation error shared by every stage of the request pipeline. */
+export declare function abortError(path: string, reason: unknown): RESTError;
+/** Waits for a delay, rejecting early if the signal aborts. */
+export declare function sleep(delay: number, signal: AbortSignal | undefined, path: string): Promise<void>;
+/** Awaits a promise, rejecting early if the signal aborts. */
+export declare function abortable(promise: Promise<void>, signal: AbortSignal | undefined, path: string): Promise<void>;

package/dist/rest/index.d.ts

@@ -1,26 +1,13 @@
-/** Error thrown when Discord rejects a REST request. */
-export declare class RESTError extends Error {
-    /** 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;
-    /** HTTP method used for the failed request. */ readonly method?: string;
-    /** API path used for the failed request. */ readonly path?: string;
-    /** Creates a REST error with request context. @param message Error message. @param status HTTP status. @param code Discord error code. @param errors Raw error payload. @param options Request context and cause. */
-    constructor(message: string, status: number, code?: number, errors?: unknown, options?: {
-        method?: string;
-        path?: string;
-        cause?: unknown;
-    });
-}
 import { type RateLimitStore } from "./store.js";
+import { RESTError } from "./errors.js";
+import { type RESTQuery } from "./route.js";
+import { HttpTransport } from "./transport.js";
 /** A file attachment sent as part of a multipart REST request. */
 export interface RESTFileAttachment {
     name: string;
     data: Blob | Uint8Array | ArrayBuffer;
     contentType?: string;
 }
-/** Query-string value accepted by {@link RESTRequestOptions.query}. */
-export type RESTQuery = URLSearchParams | Record<string, string | number | boolean | null | undefined> | string;
 /**
  * Options controlling an individual REST request.
  *
@@ -112,7 +99,18 @@ export declare class REST {
         baseURL?: string;
         hooks?: RESTHooks;
         store?: RateLimitStore;
+        /** Replaces the HTTP stage, e.g. with a recording transport in tests. */
+        transport?: HttpTransport;
+        /**
+         * Lets requests on a bucket whose limit is known run concurrently, up
+         * to its `remaining` allowance, instead of one at a time. Requires a
+         * store with `reserve`. Requests on one bucket may then complete out
+         * of order (e.g. messages to one channel). Defaults to `false`.
+         */
+        concurrentBuckets?: boolean;
     });
+    /** The rate-limit store backing this transport. */
+    get store(): RateLimitStore;
     /** Replaces the current hook set. Pass an empty object to clear all hooks. */
     setHooks(hooks: RESTHooks): this;
     /** Sets the authentication token. @param token Discord bot token. @returns Nothing. @throws {TypeError} If token is empty. */
@@ -162,7 +160,13 @@ export declare class REST {
     patchWithFiles<T>(path: string, payload: unknown, files: RESTFileAttachment[], options?: RESTRequestOptions): Promise<T>;
 }
 export { Routes } from "./routes.js";
-export { type RateLimitStore, type BucketState, MemoryRateLimitStore, } from "./store.js";
+export { RESTError, abortError } 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";
+export { HttpTransport, TransportError, type TransportRequest, type FetchLike, } from "./transport.js";
+export { ResponseDecoder, type DecodedError } from "./decoder.js";
+export { type RateLimitStore, type BucketState, type Reservation, MemoryRateLimitStore, } from "./store.js";
 export { RedisRateLimitStore, type RedisRateLimitStoreOptions, type MinimalRedisClient, } from "./redis.js";
 export { WebhookClient, type WebhookClientOptions, type WebhookMessageOptions, } from "./webhook.js";
 /**