e621 3.4.0 → 3.5.0

package/dist/lib/client.d.ts

@@ -1,6 +1,53 @@
 import type { Client } from "./generated/client/types.js";
 import type { NoV2Options, PostFormatOptions } from "./modules/posts/Format.js";
 /** @category Main */
+export interface RatelimitInfo {
+    /** The 1-indexed attempt that just got rate limited. */
+    attempt: number;
+    /** The configured {@link RatelimitOptions.maxRetries}, for context. */
+    maxRetries: number;
+    request: Request;
+    response: Response;
+    /** Seconds parsed from the response's `Retry-After` header - `null` if missing/unparsable. */
+    retryAfter: number | null;
+    /** Whether this request will be retried, or is about to fail with a {@link RatelimitError}. */
+    willRetry: boolean;
+}
+/** @category Main */
+export interface RatelimitOptions {
+    /**
+     * The maximum number of times to retry a rate limited (HTTP 429) request before giving up and
+     * throwing a {@link RatelimitError}.
+     * @default 3
+     */
+    maxRetries?: number;
+    /**
+     * The maximum delay, in seconds, to wait before retrying, regardless of what the `Retry-After` header
+     * says or how many attempts have been made.
+     * @default 60
+     */
+    maxRetryDelay?: number;
+    /**
+     * Called every time a request gets rate limited, before the retry delay (or before throwing, if
+     * retries are exhausted or disabled). Useful for logging/metrics.
+     * @default none
+     */
+    onRatelimit?: (info: RatelimitInfo) => void;
+    /**
+     * Whether to automatically retry requests that get rate limited (HTTP 429), waiting for the duration
+     * in the response's `Retry-After` header (or `retryDelay`, backed off exponentially per attempt, if
+     * the header is missing or unusable) before retrying.
+     * @default true
+     */
+    retry?: boolean;
+    /**
+     * The delay, in seconds, to wait before retrying a rate limited request when the response has no (or
+     * an unusable) `Retry-After` header. Doubled per attempt (capped at `maxRetryDelay`).
+     * @default 1
+     */
+    retryDelay?: number;
+}
+/** @category Main */
 export interface Options<PF extends PostFormatOptions = NoV2Options> {
     /**
      * The api key you want to authenticate with (Account -> Manage API Access)
@@ -25,6 +72,11 @@ export interface Options<PF extends PostFormatOptions = NoV2Options> {
      * @default legacy (v2: false)
      */
     defaultPostFormat?: PF;
+    /**
+     * Controls how rate limited (HTTP 429) requests are retried.
+     * @default \{ retry: true, maxRetries: 3, retryDelay: 1, maxRetryDelay: 60 \}
+     */
+    ratelimit?: RatelimitOptions;
     /**
      * The number of seconds before a request times out
      * @default 30
@@ -49,10 +101,19 @@ export interface Options<PF extends PostFormatOptions = NoV2Options> {
     userAgentInQuery?: boolean;
 }
 /** @category Main */
+export interface ResolvedRatelimitOptions {
+    maxRetries: number;
+    maxRetryDelay: number;
+    onRatelimit?: (info: RatelimitInfo) => void;
+    retry: boolean;
+    retryDelay: number;
+}
+/** @category Main */
 export interface InstanceOptions {
     authKey: string | null;
     authUser: string | null;
     baseURL: string;
+    ratelimit: ResolvedRatelimitOptions;
     requestTimeout: number;
     statusCheckURL: string;
     userAgent: string;

package/dist/lib/client.js

@@ -1,4 +1,5 @@
 import Debug from "./Debug.js";
+import { parseRetryAfter } from "./errors.js";
 import { createClient } from "./generated/client/client.js";
 import { createConfig } from "./generated/client/utils.js";
 import { VERSION } from "./version.js";
@@ -16,6 +17,13 @@ export function createE621Client(options) {
         authKey: options?.authKey ?? null,
         authUser: options?.authUser ?? null,
         baseURL: options?.baseURL ?? "https://e621.net",
+        ratelimit: {
+            maxRetries: options?.ratelimit?.maxRetries ?? 3,
+            maxRetryDelay: options?.ratelimit?.maxRetryDelay ?? 60,
+            onRatelimit: options?.ratelimit?.onRatelimit,
+            retry: options?.ratelimit?.retry ?? true,
+            retryDelay: options?.ratelimit?.retryDelay ?? 1,
+        },
         requestTimeout: options?.requestTimeout ?? 30,
         statusCheckURL: options?.statusCheckURL ?? "https://status.e621.church/json",
         userAgent: options?.userAgent ?? `E621/${VERSION} (https://github.com/DonovanDMC/E621${options?.authUser ? `; "${options.authUser}"` : ""})`,
@@ -33,7 +41,7 @@ export function createE621Client(options) {
             if (input instanceof Request) {
                 url = input.url;
                 method = input.method.toLowerCase();
-                if (!input.headers.has("Auithorization") && resolved.authKey && resolved.authUser) {
+                if (!input.headers.has("Authorization") && resolved.authKey && resolved.authUser) {
                     input.headers.set("Authorization", `Basic ${btoa(`${resolved.authUser}:${resolved.authKey}`)}`);
                 }
             }
@@ -55,8 +63,33 @@ export function createE621Client(options) {
                 url = requestURL.toString();
             }
             Debug(`request:${method}`, `-> ${url}`);
-            const res = await fetch(input, init);
-            Debug(`response:${method}`, `<- ${url} ${res.status} ${res.statusText}`);
+            let attempt = 0, res;
+            for (;;) {
+                // clone so a retry can re-send the body - `input` itself is never fetched directly, so it's
+                // never disturbed and can be cloned again on the next attempt
+                res = await fetch(input instanceof Request ? input.clone() : input, init);
+                Debug(`response:${method}`, `<- ${url} ${res.status} ${res.statusText}`);
+                if (res.status !== 429)
+                    break;
+                const retryAfter = parseRetryAfter(res);
+                const willRetry = resolved.ratelimit.retry && attempt < resolved.ratelimit.maxRetries;
+                resolved.ratelimit.onRatelimit?.({
+                    attempt: attempt + 1,
+                    maxRetries: resolved.ratelimit.maxRetries,
+                    request: input instanceof Request ? input : new Request(url, init),
+                    response: res,
+                    retryAfter,
+                    willRetry,
+                });
+                if (!willRetry)
+                    break;
+                const delay = Math.min(retryAfter ?? resolved.ratelimit.retryDelay * 2 ** attempt, resolved.ratelimit.maxRetryDelay);
+                Debug(`response:${method}`, `<- ${url} ratelimited, retrying in ${delay}s (attempt ${attempt + 1}/${resolved.ratelimit.maxRetries})`);
+                // free the connection, the body of a response we're discarding is never read
+                await res.body?.cancel().catch(() => { });
+                await new Promise(resolve => setTimeout(resolve, delay * 1000));
+                attempt++;
+            }
             return res;
         },
     };
@@ -76,4 +109,4 @@ export function createE621Client(options) {
     }
     return { client: createClient(config), options: resolved };
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpZW50LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vbGliL2NsaWVudC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssTUFBTSxZQUFZLENBQUM7QUFDL0IsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLDhCQUE4QixDQUFDO0FBQzVELE9BQU8sRUFBRSxZQUFZLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUMzRCxPQUFPLEVBQUUsT0FBTyxFQUFFLE1BQU0sY0FBYyxDQUFDO0FBdUV2Qzs7Ozs7Ozs7R0FRRztBQUNILE1BQU0sVUFBVSxnQkFBZ0IsQ0FBbUQsT0FBcUI7SUFDcEcsTUFBTSxRQUFRLEdBQW9CO1FBQzlCLE9BQU8sRUFBRSxPQUFPLEVBQUUsT0FBTyxJQUFJLElBQUk7UUFDakMsUUFBUSxFQUFFLE9BQU8sRUFBRSxRQUFRLElBQUksSUFBSTtRQUNuQyxPQUFPLEVBQUUsT0FBTyxFQUFFLE9BQU8sSUFBSSxrQkFBa0I7UUFDL0MsY0FBYyxFQUFFLE9BQU8sRUFBRSxjQUFjLElBQUksRUFBRTtRQUM3QyxjQUFjLEVBQUUsT0FBTyxFQUFFLGNBQWMsSUFBSSxpQ0FBaUM7UUFDNUUsU0FBUyxFQUFFLE9BQU8sRUFBRSxTQUFTLElBQUksUUFBUSxPQUFPLHVDQUF1QyxPQUFPLEVBQUUsUUFBUSxDQUFDLENBQUMsQ0FBQyxNQUFNLE9BQU8sQ0FBQyxRQUFRLEdBQUcsQ0FBQyxDQUFDLENBQUMsRUFBRSxHQUFHO1FBQzVJLGdCQUFnQixFQUFFLE9BQU8sRUFBRSxnQkFBZ0IsSUFBSSxRQUFRLElBQUksVUFBVTtLQUN4RSxDQUFDO0lBQ0YsSUFBSSxNQUFjLENBQUM7SUFDbkIsTUFBTSxZQUFZLEdBQWdEO1FBQzlELE9BQU8sRUFBRSxRQUFRLENBQUMsT0FBTztRQUN6QixPQUFPLEVBQUUsUUFBUSxDQUFDLGdCQUFnQixDQUFDLENBQUMsQ0FBQyxTQUFTLENBQUMsQ0FBQyxDQUFDO1lBQzdDLFlBQVksRUFB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
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpZW50LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vbGliL2NsaWVudC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssTUFBTSxZQUFZLENBQUM7QUFDL0IsT0FBTyxFQUFFLGVBQWUsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUM5QyxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sOEJBQThCLENBQUM7QUFDNUQsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLDZCQUE2QixDQUFDO0FBQzNELE9BQU8sRUFBRSxPQUFPLEVBQUUsTUFBTSxjQUFjLENBQUM7QUF1SXZDOzs7Ozs7OztHQVFHO0FBQ0gsTUFBTSxVQUFVLGdCQUFnQixDQUFtRCxPQUFxQjtJQUNwRyxNQUFNLFFBQVEsR0FBb0I7UUFDOUIsT0FBTyxFQUFFLE9BQU8sRUFBRSxPQUFPLElBQUksSUFBSTtRQUNqQyxRQUFRLEVBQUUsT0FBTyxFQUFFLFFBQVEsSUFBSSxJQUFJO1FBQ25DLE9BQU8sRUFBRSxPQUFPLEVBQUUsT0FBTyxJQUFJLGtCQUFrQjtRQUMvQyxTQUFTLEVBQUU7WUFDUCxVQUFVLEVBQUUsT0FBTyxFQUFFLFNBQVMsRUFBRSxVQUFVLElBQUksQ0FBQztZQUMvQyxhQUFhLEVBQUUsT0FBTyxFQUFFLFNBQVMsRUFBRSxhQUFhLElBQUksRUFBRTtZQUN0RCxXQUFXLEVBQUUsT0FBTyxFQUFFLFNBQVMsRUFBRSxXQUFXO1lBQzVDLEtBQUssRUFBRSxPQUFPLEVBQUUsU0FBUyxFQUFFLEtBQUssSUFBSSxJQUFJO1lBQ3hDLFVBQVUsRUFBRSxPQUFPLEVBQUUsU0FBUyxFQUFFLFVBQVUsSUFBSSxDQUFDO1NBQ2xEO1FBQ0QsY0FBYyxFQUFFLE9BQU8sRUFBRSxjQUFjLElBQUksRUFBRTtRQUM3QyxjQUFjLEVBQUUsT0FBTyxFQUFFLGNBQWMsSUFBSSxpQ0FBaUM7UUFDNUUsU0FBUyxFQUFFLE9BQU8sRUFBRSxTQUFTLElBQUksUUFBUSxPQUFPLHVD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

package/dist/lib/errors.d.ts

@@ -1,3 +1,5 @@
+/** Parses a response's `Retry-After` header (seconds or an HTTP-date) into seconds - `null` if missing/unparsable. @category Errors */
+export declare function parseRetryAfter(response?: Response): number | null;
 /** @category Errors */
 export declare class UnexpectedResponseError extends Error {
     error: unknown;
@@ -6,3 +8,14 @@ export declare class UnexpectedResponseError extends Error {
     response?: Response;
     constructor(request: Request | undefined, response: Response | undefined, error: unknown);
 }
+/**
+ * Thrown when e621 responds with `429 Too Many Requests` and the request either wasn't set to retry (see
+ * {@link RatelimitOptions.retry}) or ran out of retries.
+ * @category Errors
+ */
+export declare class RatelimitError extends UnexpectedResponseError {
+    name: string;
+    /** Seconds to wait before retrying, parsed from the response's `Retry-After` header - `null` if it was missing or unparsable. */
+    retryAfter: number | null;
+    constructor(request: Request | undefined, response: Response | undefined, error: unknown);
+}

package/dist/lib/errors.js

@@ -1,3 +1,14 @@
+/** Parses a response's `Retry-After` header (seconds or an HTTP-date) into seconds - `null` if missing/unparsable. @category Errors */
+export function parseRetryAfter(response) {
+    const header = response?.headers.get("Retry-After");
+    if (!header)
+        return null;
+    const seconds = Number(header);
+    if (!Number.isNaN(seconds))
+        return Math.max(0, seconds);
+    const timestamp = Date.parse(header);
+    return Number.isNaN(timestamp) ? null : Math.max(0, Math.round((timestamp - Date.now()) / 1000));
+}
 /** @category Errors */
 export class UnexpectedResponseError extends Error {
     error;
@@ -39,4 +50,19 @@ export class UnexpectedResponseError extends Error {
         });
     }
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXJyb3JzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vbGliL2Vycm9ycy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSx1QkFBdUI7QUFDdkIsTUFBTSxPQUFPLHVCQUF3QixTQUFRLEtBQUs7SUFDOUMsS0FBSyxDQUFXO0lBQ1AsSUFBSSxHQUFHLHlCQUF5QixDQUFDO0lBQzFDLE9BQU8sQ0FBVztJQUNsQixRQUFRLENBQVk7SUFDcEIsWUFBWSxPQUE0QixFQUFFLFFBQThCLEVBQUUsS0FBYztRQUNwRixJQUFJLE9BQU8sR0FBRyxRQUFRO1lBQ2xCLENBQUMsQ0FBQyxjQUFjLFFBQVEsQ0FBQyxNQUFNLElBQUksUUFBUSxDQUFDLFVBQVUsT0FBTyxPQUFPLEVBQUUsTUFBTSxJQUFJLEdBQUcsSUFBSSxPQUFPLEVBQUUsR0FBRyxJQUFJLFFBQVEsQ0FBQyxHQUFHLEVBQUU7WUFDckgsQ0FBQyxDQUFDLE9BQU87Z0JBQ0wsQ0FBQyxDQUFDLG9CQUFvQixPQUFPLENBQUMsTUFBTSxJQUFJLE9BQU8sQ0FBQyxHQUFHLEVBQUU7Z0JBQ3JELENBQUMsQ0FBQywwQ0FBMEMsQ0FBQztRQUNyRCxJQUFJLEtBQUssRUFBRSxDQUFDO1lBQ1IsSUFBSSxPQUFPLEtBQUssS0FBSyxRQUFRO2dCQUFFLE9BQU8sSUFBSSxLQUFLLEtBQUssRUFBRSxDQUFDO2lCQUNsRCxJQUFJLEtBQUssWUFBWSxLQUFLO2dCQUFFLE9BQU8sSUFBSSxLQUFLLEtBQUssQ0FBQyxPQUFPLEVBQUUsQ0FBQztZQUNqRSx1RUFBdUU7aUJBQ2xFLElBQUksT0FBTyxLQUFLLEtBQUssUUFBUSxJQUFJLEtBQUssS0FBSyxJQUFJLEVBQUUsQ0FBQztnQkFDbkQsSUFBSSxTQUFTLElBQUksS0FBSyxJQUFJLE9BQU8sS0FBSyxDQUFDLE9BQU8sS0FBSyxRQUFRO29CQUFFLE9BQU8sSUFBSSxLQUFLLEtBQUssQ0FBQyxPQUFPLEVBQUUsQ0FBQztxQkFDeEYsSUFBSSxPQUFPLElBQUksS0FBSyxJQUFJLE9BQU8sS0FBSyxDQUFDLEtBQUssS0FBSyxRQUFRO29CQUFFLE9BQU8sSUFBSSxLQUFLLEtBQUssQ0FBQyxLQUFLLEVBQUUsQ0FBQztxQkFDdkYsSUFBSSxRQUFRLElBQUksS0FBSyxJQUFJLE9BQU8sS0FBSyxDQUFDLE1BQU0sS0FBSyxRQUFRLElBQUksS0FBSyxDQUFDLE1BQU0sS0FBSyxJQUFJLEVBQUUsQ0FBQztvQkFDdEYsS0FBSyxNQUFNLENBQUMsR0FBRyxFQUFFLEtBQUssQ0FBQyxJQUFJLE1BQU0sQ0FBQyxPQUFPLENBQUMsS0FBSyxDQUFDLE1BQU0sQ0FBQyxFQUFFLENBQUM7d0JBQ3RELElBQUksT0FBTyxLQUFLLEtBQUssUUFBUTs0QkFBRSxPQUFPLElBQUksS0FBSyxHQUFHLEtBQUssS0FBSyxFQUFFLENBQUM7NkJBQzFELElBQUksS0FBSyxDQUFDLE9BQU8sQ0FBQyxLQUFLLENBQUM7NEJBQUUsT0FBTyxJQUFJLEtBQUssR0FBRyxLQUFLLEtBQUssQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLEVBQUUsQ0FBQztvQkFDOUUsQ0FBQztnQkFDTCxDQUFDO1lBQ0wsQ0FBQztRQUNMLENBQUM7UUFDRCxLQUFLLENBQUMsT0FBTyxDQUFDLENBQUM7UUFDZixNQUFNLENBQUMsZ0JBQWdCLENBQUMsSUFBSSxFQUFFO1lBQzFCLE9BQU8sRUFBRSxFQUFFLEtBQUssRUFBRSxPQUFPLEVBQUUsVUFBVSxFQUFFLEtBQUssRUFBRTtZQUM5QyxRQUFRLEVBQUUsRUFBRSxLQUFLLEVBQUUsUUFBUSxFQUFFLFVBQVUsRUFBRSxLQUFLLEVBQUU7WUFDaEQsS0FBSyxFQUFFLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxVQUFVLEVBQUUsS0FBSyxFQUFFO1NBQzdDLENBQUMsQ0FBQztJQUNQLENBQUM7Q0FDSiJ9
+/**
+ * Thrown when e621 responds with `429 Too Many Requests` and the request either wasn't set to retry (see
+ * {@link RatelimitOptions.retry}) or ran out of retries.
+ * @category Errors
+ */
+export class RatelimitError extends UnexpectedResponseError {
+    name = "RatelimitError";
+    /** Seconds to wait before retrying, parsed from the response's `Retry-After` header - `null` if it was missing or unparsable. */
+    retryAfter;
+    constructor(request, response, error) {
+        super(request, response, error);
+        this.retryAfter = parseRetryAfter(response);
+        this.message = this.message.replace("Unexpected", "Ratelimited") + (this.retryAfter === null ? "" : `\nRetry after ${this.retryAfter}s`);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXJyb3JzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vbGliL2Vycm9ycy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSx1SUFBdUk7QUFDdkksTUFBTSxVQUFVLGVBQWUsQ0FBQyxRQUFtQjtJQUMvQyxNQUFNLE1BQU0sR0FBRyxRQUFRLEVBQUUsT0FBTyxDQUFDLEdBQUcsQ0FBQyxhQUFhLENBQUMsQ0FBQztJQUNwRCxJQUFJLENBQUMsTUFBTTtRQUFFLE9BQU8sSUFBSSxDQUFDO0lBQ3pCLE1BQU0sT0FBTyxHQUFHLE1BQU0sQ0FBQyxNQUFNLENBQUMsQ0FBQztJQUMvQixJQUFJLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUM7UUFBRSxPQUFPLElBQUksQ0FBQyxHQUFHLENBQUMsQ0FBQyxFQUFFLE9BQU8sQ0FBQyxDQUFDO0lBQ3hELE1BQU0sU0FBUyxHQUFHLElBQUksQ0FBQyxLQUFLLENBQUMsTUFBTSxDQUFDLENBQUM7SUFDckMsT0FBTyxNQUFNLENBQUMsS0FBSyxDQUFDLFNBQVMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsQ0FBQyxFQUFFLElBQUksQ0FBQyxLQUFLLENBQUMsQ0FBQyxTQUFTLEdBQUcsSUFBSSxDQUFDLEdBQUcsRUFBRSxDQUFDLEdBQUcsSUFBSSxDQUFDLENBQUMsQ0FBQztBQUNyRyxDQUFDO0FBRUQsdUJBQXVCO0FBQ3ZCLE1BQU0sT0FBTyx1QkFBd0IsU0FBUSxLQUFLO0lBQzlDLEtBQUssQ0FBVztJQUNQLElBQUksR0FBRyx5QkFBeUIsQ0FBQztJQUMxQyxPQUFPLENBQVc7SUFDbEIsUUFBUSxDQUFZO0lBQ3BCLFlBQVksT0FBNEIsRUFBRSxRQUE4QixFQUFFLEtBQWM7UUFDcEYsSUFBSSxPQUFPLEdBQUcsUUFBUTtZQUNsQixDQUFDLENBQUMsY0FBYyxRQUFRLENBQUMsTUFBTSxJQUFJLFFBQVEsQ0FBQyxVQUFV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

package/dist/lib/generated/schemas.d.ts

@@ -1093,7 +1093,7 @@ export declare const ExtendedPostSchema: {
 };
 export declare const ForumPostSchema: {
     readonly type: "object";
-    readonly required: readonly ["id", "topic_id", "creator_id", "updater_id", "body", "is_hidden", "created_at", "updated_at", "warning_type", "warning_user_id"];
+    readonly required: readonly ["id", "topic_id", "creator_id", "updater_id", "body", "is_hidden", "created_at", "updated_at", "warning_type", "warning_user_id", "vote_score", "creator_name", "updater_name"];
     readonly properties: {
         readonly id: {
             readonly type: "integer";
@@ -1128,6 +1128,17 @@ export declare const ForumPostSchema: {
             readonly type: "integer";
             readonly nullable: true;
         };
+        readonly vote_score: {
+            readonly type: "string";
+            readonly nullable: true;
+            readonly description: "Net votes divided by total votes, from -1 to 1. Null if the post has never been voted on.";
+        };
+        readonly creator_name: {
+            readonly type: "string";
+        };
+        readonly updater_name: {
+            readonly type: "string";
+        };
     };
 };
 export declare const ForumPostVoteSchema: {
@@ -1161,7 +1172,7 @@ export declare const ForumPostVoteSchema: {
 };
 export declare const ForumTopicSchema: {
     readonly type: "object";
-    readonly required: readonly ["id", "creator_id", "updater_id", "title", "response_count", "is_sticky", "is_locked", "is_hidden", "created_at", "updated_at", "category_id"];
+    readonly required: readonly ["id", "creator_id", "updater_id", "title", "response_count", "is_sticky", "is_locked", "is_hidden", "created_at", "updated_at", "category_id", "last_bumped_at", "creator_name", "updater_name"];
     readonly properties: {
         readonly id: {
             readonly type: "integer";
@@ -1198,6 +1209,16 @@ export declare const ForumTopicSchema: {
         readonly category_id: {
             readonly type: "integer";
         };
+        readonly last_bumped_at: {
+            readonly type: "string";
+            readonly format: "date-time";
+        };
+        readonly creator_name: {
+            readonly type: "string";
+        };
+        readonly updater_name: {
+            readonly type: "string";
+        };
     };
 };
 export declare const FullCurrentUserSchema: {
@@ -1601,6 +1622,10 @@ export declare const LegacyPostSchema: {
                     readonly type: "string";
                     readonly nullable: true;
                 };
+                readonly alt: {
+                    readonly type: "string";
+                    readonly nullable: true;
+                };
             };
         };
         readonly sample: {
@@ -1622,6 +1647,10 @@ export declare const LegacyPostSchema: {
                     readonly type: "string";
                     readonly nullable: true;
                 };
+                readonly alt: {
+                    readonly type: "string";
+                    readonly nullable: true;
+                };
                 readonly alternates: {
                     readonly type: "object";
                     readonly properties: {
@@ -2562,6 +2591,40 @@ export declare const PostFilesSchema: {
         readonly sample: {
             readonly $ref: "#/components/schemas/PostFilesSample";
         };
+        readonly video: {
+            readonly type: "object";
+            readonly required: readonly ["has", "original", "variants", "samples"];
+            readonly properties: {
+                readonly has: {
+                    readonly type: "boolean";
+                };
+                readonly original: {
+                    readonly $ref: "#/components/schemas/PostSampleAlternate";
+                };
+                readonly variants: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly webm: {
+                            readonly $ref: "#/components/schemas/PostSampleAlternate";
+                        };
+                        readonly mp4: {
+                            readonly $ref: "#/components/schemas/PostSampleAlternate";
+                        };
+                    };
+                };
+                readonly samples: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly '480p': {
+                            readonly $ref: "#/components/schemas/PostSampleAlternate";
+                        };
+                        readonly '720p': {
+                            readonly $ref: "#/components/schemas/PostSampleAlternate";
+                        };
+                    };
+                };
+            };
+        };
     };
 };
 export declare const PostFilesMetaSchema: {
@@ -2838,6 +2901,7 @@ export declare const PostSampleAlternateSchema: {
         };
         readonly codec: {
             readonly type: "string";
+            readonly nullable: true;
         };
         readonly size: {
             readonly type: "integer";
@@ -2852,6 +2916,7 @@ export declare const PostSampleAlternateSchema: {
         readonly url: {
             readonly type: "string";
             readonly format: "uri";
+            readonly nullable: true;
         };
     };
 };
@@ -2901,7 +2966,7 @@ export declare const PostSetSchema: {
 };
 export declare const PostStatsSchema: {
     readonly type: "object";
-    readonly required: readonly ["score", "fav_count", "is_favorited", "vote", "comment_count"];
+    readonly required: readonly ["score", "fav_count", "is_favorited", "vote", "comment_count", "hotness"];
     readonly properties: {
         readonly score: {
             readonly $ref: "#/components/schemas/PostStatsScore";
@@ -2918,6 +2983,10 @@ export declare const PostStatsSchema: {
         readonly comment_count: {
             readonly type: "integer";
         };
+        readonly hotness: {
+            readonly type: "number";
+            readonly format: "float";
+        };
     };
 };
 export declare const PostStatsScoreSchema: {
@@ -2937,7 +3006,7 @@ export declare const PostStatsScoreSchema: {
 };
 export declare const PostVersionSchema: {
     readonly type: "object";
-    readonly required: readonly ["id", "post_id", "tags", "updater_id", "updated_at", "rating", "parent_id", "source", "description", "reason", "locked_tags", "added_tags", "removed_tags", "added_locked_tags", "removed_locked_tags", "rating_changed", "parent_changed", "source_changed", "description_changed", "version", "obsolete_added_tags", "obsolete_removed_tags", "unchanged_tags", "updater_name", "is_hidden"];
+    readonly required: readonly ["id", "post_id", "tags", "updater_id", "updated_at", "rating", "parent_id", "source", "description", "reason", "locked_tags", "added_tags", "removed_tags", "original_tags", "added_locked_tags", "removed_locked_tags", "rating_changed", "parent_changed", "source_changed", "description_changed", "version", "obsolete_added_tags", "obsolete_removed_tags", "unchanged_tags", "updater_name", "is_hidden"];
     readonly properties: {
         readonly id: {
             readonly type: "integer";
@@ -2988,6 +3057,13 @@ export declare const PostVersionSchema: {
                 readonly type: "string";
             };
         };
+        readonly original_tags: {
+            readonly type: "array";
+            readonly description: "The tag changes as the user submitted them, before aliases, implications, and automatic tags. Removed tags are prefixed with `-`. May include metatags such as `rating:`, `pool:`, `parent:`, and `source:`.";
+            readonly items: {
+                readonly type: "string";
+            };
+        };
         readonly added_locked_tags: {
             readonly type: "array";
             readonly items: {
@@ -3290,6 +3366,51 @@ export declare const RisingSearchTrendSchema: {
         };
     };
 };
+export declare const SavedSearchSchema: {
+    readonly type: "object";
+    readonly required: readonly ["id", "query", "name", "is_tracked", "is_subscription", "last_seen_post_id", "created_at", "updated_at", "new_count"];
+    readonly properties: {
+        readonly id: {
+            readonly type: "integer";
+        };
+        readonly query: {
+            readonly type: "string";
+            readonly description: "Empty for the subscription search, its tags are managed through tag subscriptions.";
+        };
+        readonly name: {
+            readonly type: "string";
+            readonly nullable: true;
+        };
+        readonly is_tracked: {
+            readonly type: "boolean";
+        };
+        readonly is_subscription: {
+            readonly type: "boolean";
+            readonly description: "True for the search that holds the user's tag subscriptions.";
+        };
+        readonly last_seen_post_id: {
+            readonly type: "integer";
+            readonly nullable: true;
+        };
+        readonly created_at: {
+            readonly type: "string";
+            readonly format: "date-time";
+        };
+        readonly updated_at: {
+            readonly type: "string";
+            readonly format: "date-time";
+        };
+        readonly tag_count: {
+            readonly type: "integer";
+            readonly description: "Only present on the subscription search.";
+        };
+        readonly new_count: {
+            readonly type: "integer";
+            readonly nullable: true;
+            readonly description: "New posts since the search was last seen, capped at 100. Null for untracked searches, when no counts are cached, or when the search could not be evaluated.";
+        };
+    };
+};
 export declare const SearchTrendSchema: {
     readonly type: "object";
     readonly required: readonly ["tag", "count", "day"];
@@ -3975,6 +4096,28 @@ export declare const TagPreviewSchema: {
         };
     };
 };
+export declare const TagSubscriptionSchema: {
+    readonly type: "object";
+    readonly required: readonly ["id", "tag_id", "created_at", "tag_name", "category"];
+    readonly properties: {
+        readonly id: {
+            readonly type: "integer";
+        };
+        readonly tag_id: {
+            readonly type: "integer";
+        };
+        readonly created_at: {
+            readonly type: "string";
+            readonly format: "date-time";
+        };
+        readonly tag_name: {
+            readonly type: "string";
+        };
+        readonly category: {
+            readonly $ref: "#/components/schemas/TagCategory";
+        };
+    };
+};
 export declare const TagTypeVersionSchema: {
     readonly type: "object";
     readonly required: readonly ["id", "created_at", "updated_at", "old_type", "new_type", "is_locked", "tag_id", "creator_id"];
@@ -4055,7 +4198,7 @@ export declare const TakedownSchema: {
 };
 export declare const ThumbnailPostSchema: {
     readonly type: "object";
-    readonly required: readonly ["id", "created_at", "md5", "file_ext", "width", "height", "size", "preview_url", "preview_webp", "sample_url", "file_url", "preview_width", "preview_height", "uploader_id", "uploader", "score", "fav_count", "is_favorited", "vote", "comment_count", "flags", "pools", "rating", "tags"];
+    readonly required: readonly ["id", "created_at", "md5", "file_ext", "width", "height", "size", "duration", "preview_url", "preview_webp", "sample_url", "file_url", "preview_width", "preview_height", "uploader_id", "uploader", "score", "fav_count", "is_favorited", "vote", "comment_count", "flags", "pools", "rating", "tags"];
     readonly properties: {
         readonly id: {
             readonly type: "integer";
@@ -4080,6 +4223,10 @@ export declare const ThumbnailPostSchema: {
             readonly type: "integer";
             readonly format: "int64";
         };
+        readonly duration: {
+            readonly type: "number";
+            readonly nullable: true;
+        };
         readonly preview_url: {
             readonly type: "string";
             readonly format: "uri";
@@ -4210,7 +4357,7 @@ export declare const TrackedSearchTrendSchema: {
 };
 export declare const UploadSchema: {
     readonly type: "object";
-    readonly required: readonly ["id", "source", "rating", "uploader_id", "tag_string", "status", "backtrace", "post_id", "md5_confirmation", "created_at", "updated_at", "parent_id", "md5", "file_ext", "file_size", "image_width", "image_height", "description", "uploader_name"];
+    readonly required: readonly ["id", "source", "rating", "uploader_id", "tag_string", "status", "post_id", "created_at", "updated_at", "parent_id", "md5", "file_ext", "file_size", "image_width", "image_height", "description", "processing_step", "error_message", "warning_messages", "is_animated", "duration", "has_sound", "locked_tags", "locked_rating", "as_pending", "submitted_tag_string", "processing_started_at", "processed_at", "requeued_at", "uploader_name", "duplicate_post_id"];
     readonly properties: {
         readonly id: {
             readonly type: "integer";
@@ -4229,12 +4376,13 @@ export declare const UploadSchema: {
         };
         readonly status: {
             readonly type: "string";
-            readonly description: "Note: The \"error\" status will be proceeded by an error, ex: \"error: RuntimeError - No file or source URL provided\"\n";
-            readonly enum: readonly ["completed", "duplicate", "error", "processing", "pending"];
+            readonly description: "Note: The \"duplicate\" status will be followed by the duplicate post's id, ex: \"duplicate: 123\"\n";
+            readonly enum: readonly ["completed", "duplicate", "failed", "processing", "queued", "pending"];
         };
         readonly backtrace: {
             readonly type: "string";
             readonly nullable: true;
+            readonly description: "Only visible to Staff+.";
         };
         readonly post_id: {
             readonly type: "integer";
@@ -4244,6 +4392,7 @@ export declare const UploadSchema: {
             readonly type: "string";
             readonly nullable: true;
             readonly deprecated: true;
+            readonly description: "Only visible to Staff+.";
         };
         readonly created_at: {
             readonly type: "string";
@@ -4280,9 +4429,68 @@ export declare const UploadSchema: {
         readonly description: {
             readonly type: "string";
         };
+        readonly processing_step: {
+            readonly type: "string";
+            readonly nullable: true;
+            readonly description: "The step currently being processed.";
+            readonly enum: readonly ["integrity", "thumbnail", "sound", "post", null];
+        };
+        readonly error_message: {
+            readonly type: "string";
+            readonly nullable: true;
+        };
+        readonly warning_messages: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+        };
+        readonly is_animated: {
+            readonly type: "boolean";
+        };
+        readonly duration: {
+            readonly type: "string";
+            readonly nullable: true;
+        };
+        readonly has_sound: {
+            readonly type: "boolean";
+        };
+        readonly locked_tags: {
+            readonly type: "string";
+            readonly nullable: true;
+        };
+        readonly locked_rating: {
+            readonly type: "boolean";
+        };
+        readonly as_pending: {
+            readonly type: "boolean";
+        };
+        readonly submitted_tag_string: {
+            readonly type: "string";
+            readonly nullable: true;
+        };
+        readonly processing_started_at: {
+            readonly type: "string";
+            readonly format: "date-time";
+            readonly nullable: true;
+        };
+        readonly processed_at: {
+            readonly type: "string";
+            readonly format: "date-time";
+            readonly nullable: true;
+        };
+        readonly requeued_at: {
+            readonly type: "string";
+            readonly format: "date-time";
+            readonly nullable: true;
+        };
         readonly uploader_name: {
             readonly type: "string";
         };
+        readonly duplicate_post_id: {
+            readonly type: "integer";
+            readonly nullable: true;
+        };
     };
 };
 export declare const UploadWhitelistSchema: {
@@ -4726,7 +4934,8 @@ export declare const AccessDeniedResponseSchema: {
         };
         readonly reason: {
             readonly type: "string";
-            readonly enum: readonly ["Access Denied"];
+            readonly description: "Usually `Access Denied`, but may include more detail, ex: `Access Denied: Must be logged in`.";
+            readonly example: "Access Denied";
         };
     };
 };