@neontechspace/fluxerly 1000.0.0-nightly.12

package/dist/internal/response-json.js

@@ -0,0 +1,74 @@
+/**
+ * Bounded JSON response reading.
+ * Invariant: Decoded body bytes are bounded before parsing, and reader cancellation and release are always awaited.
+ * Implements [SDK contracts: Delivery, requests and caches](/docs/SDK-CONTRACTS.md#delivery-requests-and-caches)
+ */
+import { TransportError } from "./effect-failures.js";
+/** Bounded response parsing completed, but releasing its owned reader failed */
+export class ResponseJsonCleanupError extends Error {
+    cause;
+    status;
+    constructor(cause, status) {
+        super("JSON response cleanup failed", { cause });
+        this.cause = cause;
+        this.status = status;
+        this.name = "ResponseJsonCleanupError";
+    }
+}
+/**
+ * Bound decoded HTTP body bytes before parsing JSON, then await reader cancellation and release.
+ * Invalid UTF-8 or JSON returns undefined. A body whose connection fails mid-read throws a TransportError
+ */
+export async function readResponseJson(response, maxBytes = 16_777_216, signal) {
+    const reader = response.body?.getReader();
+    if (!reader)
+        return undefined;
+    const decoder = new TextDecoder("utf-8", { fatal: true });
+    let result = "", bytes = 0, ended = false;
+    try {
+        while (true) {
+            const next = await reader.read().catch((error) => {
+                // A failed read leaves the stream errored, so it needs no cancellation
+                ended = true;
+                throw new TransportError(error, "response body read");
+            });
+            if (next.done) {
+                ended = true;
+                break;
+            }
+            bytes += next.value.byteLength;
+            if (bytes > maxBytes)
+                return undefined;
+            result += decoder.decode(next.value, { stream: true });
+        }
+        return JSON.parse(result + decoder.decode());
+    }
+    catch (error) {
+        if (error instanceof TransportError)
+            throw error;
+        // allow-silent: Invalid UTF-8 or JSON returns undefined, which the decoder reports as an unusable response
+        return undefined;
+    }
+    finally {
+        const failures = [];
+        const actions = [
+            ...(!ended ? [() => reader.cancel()] : []),
+            () => reader.releaseLock(),
+        ];
+        for (const action of actions) {
+            try {
+                await action();
+            }
+            catch (error) {
+                // Re-cancelling a fetch reader after its own request abort can reject with that exact reason
+                if (signal?.aborted && error === signal.reason)
+                    continue;
+                failures.push(error);
+            }
+        }
+        if (failures.length)
+            // oxlint-disable-next-line no-unsafe-finally -- a reader cleanup failure deliberately replaces the parsed result
+            throw new ResponseJsonCleanupError(failures.length === 1 ? failures[0] : new AggregateError(failures, "JSON response cleanup failed"), response.status);
+    }
+}
+//# sourceMappingURL=response-json.js.map

package/dist/internal/response-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-json.js","sourceRoot":"","sources":["../../src/internal/response-json.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAErD,gFAAgF;AAChF,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IAElC,KAAK;IACL,MAAM;IAFnB,YACa,KAAc,EACd,MAAc;QAEvB,KAAK,CAAC,8BAA8B,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;qBAHvC,KAAK;sBACL,MAAM;QAGf,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAA;IAC1C,CAAC;CACJ;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAClC,QAAkB,EAClB,QAAQ,GAAG,UAAU,EACrB,MAAoB;IAEpB,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,CAAA;IACzC,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAA;IAC7B,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IACzD,IAAI,MAAM,GAAG,EAAE,EACX,KAAK,GAAG,CAAC,EACT,KAAK,GAAG,KAAK,CAAA;IACjB,IAAI,CAAC;QACD,OAAO,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBACtD,uEAAuE;gBACvE,KAAK,GAAG,IAAI,CAAA;gBACZ,MAAM,IAAI,cAAc,CAAC,KAAK,EAAE,oBAAoB,CAAC,CAAA;YACzD,CAAC,CAAC,CAAA;YACF,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACZ,KAAK,GAAG,IAAI,CAAA;gBACZ,MAAK;YACT,CAAC;YACD,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,CAAA;YAC9B,IAAI,KAAK,GAAG,QAAQ;gBAAE,OAAO,SAAS,CAAA;YACtC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;QAC1D,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAY,CAAA;IAC3D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,IAAI,KAAK,YAAY,cAAc;YAAE,MAAM,KAAK,CAAA;QAChD,2GAA2G;QAC3G,OAAO,SAAS,CAAA;IACpB,CAAC;YAAS,CAAC;QACP,MAAM,QAAQ,GAAc,EAAE,CAAA;QAC9B,MAAM,OAAO,GAAmC;YAC5C,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1C,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE;SAC7B,CAAA;QACD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACD,MAAM,MAAM,EAAE,CAAA;YAClB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,6FAA6F;gBAC7F,IAAI,MAAM,EAAE,OAAO,IAAI,KAAK,KAAK,MAAM,CAAC,MAAM;oBAAE,SAAQ;gBACxD,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACxB,CAAC;QACL,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM;YACf,iHAAiH;YACjH,MAAM,IAAI,wBAAwB,CAC9B,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,cAAc,CAAC,QAAQ,EAAE,8BAA8B,CAAC,EAClG,QAAQ,CAAC,MAAM,CAClB,CAAA;IACT,CAAC;AACL,CAAC"}

package/dist/internal/rest/admission.d.ts

@@ -0,0 +1,77 @@
+/**
+ * REST admission for one client: The bounded request queue, active-request slots, learned rate-limit waits and the
+ * shared global pause.
+ * Invariant: Admission coordinates requests and rate state within one client. The only state that crosses processes is
+ * the global pause, which a supervised child shares with the other children of its supervisor. A request waits in the
+ * queue only while count and JSON-byte budgets allow it and no learned wait outlasts its deadline, media transfers use
+ * their own slots so upload sources cannot starve their own reads, and closure fails every waiting request.
+ * Implements [SDK contracts: Delivery, requests and caches](/docs/SDK-CONTRACTS.md#delivery-requests-and-caches)
+ */
+import * as Effect from "effect/Effect";
+import { ClientClosedError } from "#sdk/errors";
+import type { LogicalScheduler } from "../logical-scheduler.js";
+import { RateLimits } from "../rate-limits.js";
+import { RestFailure } from "./classify.js";
+import { type RestConfiguration } from "./options.js";
+/** Where a waiting request goes and what it charges */
+export interface AdmissionRequest {
+    /** Rate-limit route key the request reserves when it enters */
+    readonly route: string;
+    /** JSON bytes charged against the queue budget while it waits */
+    readonly bytes: number;
+    /** Logical time before which it may not enter, used for retry backoff */
+    readonly until?: number;
+    /**
+     * Logical deadline of the request. When a learned route or global wait lasts until then, the request fails at once
+     * with reason rateLimit and the remaining wait instead of waiting
+     */
+    readonly deadline?: number;
+    /** Whether learned route and global waits apply. Discovery and media reads are not rate limited */
+    readonly rateLimited?: boolean;
+    /** Whether it uses a media transfer slot instead of an API request slot */
+    readonly media?: boolean;
+}
+export declare class RestAdmission {
+    #private;
+    private readonly logical;
+    /** Slot, queue and byte limits, defaulting to the built-in limits */
+    private readonly settings;
+    /** Called when a request fails with busy because the queue budgets are full */
+    private readonly onBusy;
+    /** Receives each longer global pause learned from Fluxer, in milliseconds from now, to share with other processes */
+    private readonly shareGlobalPause?;
+    /** Learned buckets and aliases for this client's routes */
+    readonly rates: RateLimits;
+    constructor(logical: LogicalScheduler, 
+    /** Slot, queue and byte limits, defaulting to the built-in limits */
+    settings?: RestConfiguration, 
+    /** Called when a request fails with busy because the queue budgets are full */
+    onBusy?: () => void, 
+    /** Receives each longer global pause learned from Fluxer, in milliseconds from now, to share with other processes */
+    shareGlobalPause?: ((waitMs: number) => void) | undefined);
+    /**
+     * Size the default API request slots for the local shard count, four per shard up to 64. An explicit
+     * rest.concurrency stays as configured
+     */
+    scaleConcurrency(localShards: number): void;
+    diagnostics(): {
+        activeRequests: number;
+        activeCapacity: number;
+        queuedRequests: number;
+        queuedCapacity: number;
+        queuedJsonBytes: number;
+        queuedJsonByteCapacity: number;
+    };
+    /** Whether one more request with these JSON bytes fits the queue budgets now */
+    hasRoom(bytes: number): boolean;
+    /**
+     * Hold every rate-limited route until the given logical time, keeping any later pause. A longer pause learned from
+     * Fluxer goes to shareGlobalPause, while one shared by another process is not passed on again
+     */
+    pauseGlobal(until: number, shared?: boolean): void;
+    /** Wait for a slot. The returned function releases it and is safe to call more than once */
+    acquire(request: AdmissionRequest): Effect.Effect<() => void, RestFailure | ClientClosedError>;
+    /** Stop admission, forget learned rate state and fail every waiting request with ClientClosedError */
+    close(): void;
+}
+//# sourceMappingURL=admission.d.ts.map

package/dist/internal/rest/admission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admission.d.ts","sourceRoot":"","sources":["../../../src/internal/rest/admission.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAgB,MAAM,yBAAyB,CAAA;AAC7E,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAqE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAexH,uDAAuD;AACvD,MAAM,WAAW,gBAAgB;IAC7B,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,yEAAyE;IACzE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,mGAAmG;IACnG,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAA;IAC9B,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED,qBAAa,aAAa;;IAclB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,qEAAqE;IACrE,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,+EAA+E;IAC/E,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,qHAAqH;IACrH,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAVtC,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,aAAmB;IAEjC,YACqB,OAAO,EAAE,gBAAgB;IAC1C,qEAAqE;IACpD,QAAQ,GAAE,iBAA4C;IACvE,+EAA+E;IAC9D,MAAM,GAAE,MAAM,IAAe;IAC9C,qHAAqH;IACpG,gBAAgB,CAAC,GAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,aAAA,EAG/D;IAED;;;OAGG;IACH,gBAAgB,CAAC,WAAW,EAAE,MAAM,QAInC;IAED,WAAW;QAEH,cAAc;QACd,cAAc;QACd,cAAc;QACd,cAAc;QACd,eAAe;QACf,sBAAsB;MAE7B;IAED,gFAAgF;IAChF,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE9B;IAED;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,UAAQ,QAIxC;IA+DD,4FAA4F;IAC5F,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,WAAW,GAAG,iBAAiB,CAAC,CA0B7F;IAED,sGAAsG;IACtG,KAAK,SAQJ;CACJ"}

package/dist/internal/rest/admission.js

@@ -0,0 +1,178 @@
+/**
+ * REST admission for one client: The bounded request queue, active-request slots, learned rate-limit waits and the
+ * shared global pause.
+ * Invariant: Admission coordinates requests and rate state within one client. The only state that crosses processes is
+ * the global pause, which a supervised child shares with the other children of its supervisor. A request waits in the
+ * queue only while count and JSON-byte budgets allow it and no learned wait outlasts its deadline, media transfers use
+ * their own slots so upload sources cannot starve their own reads, and closure fails every waiting request.
+ * Implements [SDK contracts: Delivery, requests and caches](/docs/SDK-CONTRACTS.md#delivery-requests-and-caches)
+ */
+import * as Effect from "effect/Effect";
+import { ClientClosedError } from "#sdk/errors";
+import { RateLimits } from "../rate-limits.js";
+import { RestFailure } from "./classify.js";
+import { concurrencyPerShard, defaultRestConfiguration, maximumConcurrency } from "./options.js";
+/** Longest single timer delay */
+const maximumTimerMs = 2_147_483_647;
+export class RestAdmission {
+    logical;
+    settings;
+    onBusy;
+    shareGlobalPause;
+    #pending = [];
+    #bytes = 0;
+    #active = 0;
+    #activeMedia = 0;
+    #timer;
+    #closed = false;
+    #globalUntil = 0;
+    /** API request slots: The configured concurrency, or the default scaled with the local shard count */
+    #concurrency;
+    /** Learned buckets and aliases for this client's routes */
+    rates = new RateLimits();
+    constructor(logical, 
+    /** Slot, queue and byte limits, defaulting to the built-in limits */
+    settings = defaultRestConfiguration, 
+    /** Called when a request fails with busy because the queue budgets are full */
+    onBusy = () => { }, 
+    /** Receives each longer global pause learned from Fluxer, in milliseconds from now, to share with other processes */
+    shareGlobalPause) {
+        this.logical = logical;
+        this.settings = settings;
+        this.onBusy = onBusy;
+        this.shareGlobalPause = shareGlobalPause;
+        this.#concurrency = settings.concurrency;
+    }
+    /**
+     * Size the default API request slots for the local shard count, four per shard up to 64. An explicit
+     * rest.concurrency stays as configured
+     */
+    scaleConcurrency(localShards) {
+        if (!this.settings.concurrencyScales)
+            return;
+        this.#concurrency = Math.min(maximumConcurrency, concurrencyPerShard * Math.max(1, localShards));
+        this.#pump();
+    }
+    diagnostics() {
+        return {
+            activeRequests: this.#active + this.#activeMedia,
+            activeCapacity: this.#concurrency + this.settings.mediaConcurrency,
+            queuedRequests: this.#pending.length,
+            queuedCapacity: this.settings.maxQueued,
+            queuedJsonBytes: this.#bytes,
+            queuedJsonByteCapacity: this.settings.queuedJsonMaxBytes,
+        };
+    }
+    /** Whether one more request with these JSON bytes fits the queue budgets now */
+    hasRoom(bytes) {
+        return this.#pending.length < this.settings.maxQueued && bytes <= this.settings.queuedJsonMaxBytes - this.#bytes;
+    }
+    /**
+     * Hold every rate-limited route until the given logical time, keeping any later pause. A longer pause learned from
+     * Fluxer goes to shareGlobalPause, while one shared by another process is not passed on again
+     */
+    pauseGlobal(until, shared = false) {
+        if (until <= this.#globalUntil)
+            return;
+        this.#globalUntil = until;
+        if (!shared)
+            this.shareGlobalPause?.(Math.ceil(until - this.logical.now()));
+    }
+    #pump() {
+        this.logical.clear(this.#timer);
+        this.#timer = undefined;
+        const now = this.logical.now();
+        if (this.#closed)
+            return;
+        let earliest = Infinity;
+        for (let index = 0; index < this.#pending.length;) {
+            const item = this.#pending[index];
+            // A request that cannot enter before its deadline would only time out, so it fails now with the remaining wait
+            const held = item.rateLimited ? Math.max(this.#globalUntil, this.rates.wait(item.route, now, true)) : 0;
+            if (held > now && held >= item.deadline) {
+                this.#pending.splice(index, 1);
+                this.#bytes -= item.bytes;
+                item.resume(Effect.fail(new RestFailure({
+                    reason: "rateLimit",
+                    outcome: "notDispatched",
+                    retryAfterMs: Math.ceil(held - now),
+                })));
+                continue;
+            }
+            // Source GETs must remain admissible while uploads await their lazy stream bodies
+            if (item.media ? this.#activeMedia >= this.settings.mediaConcurrency : this.#active >= this.#concurrency) {
+                index++;
+                continue;
+            }
+            const until = item.rateLimited
+                ? Math.max(item.until, this.#globalUntil, this.rates.wait(item.route, now))
+                : item.until;
+            if (until > now) {
+                earliest = Math.min(earliest, until);
+                index++;
+                continue;
+            }
+            this.#pending.splice(index, 1);
+            this.#bytes -= item.bytes;
+            if (item.media)
+                this.#activeMedia++;
+            else
+                this.#active++;
+            if (item.rateLimited)
+                this.rates.reserve(item.route, now);
+            let released = false;
+            item.resume(Effect.succeed(() => {
+                if (released)
+                    return;
+                released = true;
+                if (item.media)
+                    this.#activeMedia--;
+                else
+                    this.#active--;
+                this.#pump();
+            }));
+        }
+        if (earliest !== Infinity)
+            this.#timer = this.logical.set(() => this.#pump(), Math.min(maximumTimerMs, Math.max(1, earliest - now)), "REST admission queue");
+    }
+    /** Wait for a slot. The returned function releases it and is safe to call more than once */
+    acquire(request) {
+        const { route, bytes, until = 0, deadline = Infinity, rateLimited = true, media = false } = request;
+        return Effect.callback((resume) => {
+            if (this.#closed) {
+                resume(Effect.fail(new ClientClosedError()));
+                return;
+            }
+            // A new request may enter directly when there is no backlog and a slot is available
+            if (!this.hasRoom(bytes)) {
+                this.onBusy();
+                resume(Effect.fail(new RestFailure({ reason: "busy", outcome: "notDispatched" })));
+                return;
+            }
+            const item = { route, bytes, until, deadline, rateLimited, media, resume };
+            this.#pending.push(item);
+            this.#bytes += bytes;
+            this.#pump();
+            return Effect.sync(() => {
+                const index = this.#pending.indexOf(item);
+                if (index !== -1) {
+                    this.#pending.splice(index, 1);
+                    this.#bytes -= bytes;
+                    this.#pump();
+                }
+            });
+        });
+    }
+    /** Stop admission, forget learned rate state and fail every waiting request with ClientClosedError */
+    close() {
+        this.#closed = true;
+        this.logical.clear(this.#timer);
+        this.#timer = undefined;
+        const pending = this.#pending.splice(0);
+        this.#bytes = 0;
+        this.rates.clear();
+        for (const item of pending)
+            item.resume(Effect.fail(new ClientClosedError()));
+    }
+}
+//# sourceMappingURL=admission.js.map

package/dist/internal/rest/admission.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admission.js","sourceRoot":"","sources":["../../../src/internal/rest/admission.ts"],"names":[],"mappings":"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"}

package/dist/internal/rest/attempt.d.ts

@@ -0,0 +1,124 @@
+import * as Effect from "effect/Effect";
+import type * as Fiber from "effect/Fiber";
+import * as Redacted from "effect/Redacted";
+import { ClientClosedError } from "#sdk/errors";
+import { type ApiErrorDetail } from "#sdk/api-errors";
+import type { MessageCore } from "#sdk/messages";
+import type { EncodedBody } from "../attachments.js";
+import type { CacheRequest } from "../cache.js";
+import type { ChannelCacheGuard, ChannelCacheRequest } from "../channel-cache.js";
+import type { ResourceGuard, ResourceRequest } from "../guild-cache.js";
+import type { InstanceEndpointContext } from "../instance.js";
+import { type RateRoute } from "../rate-limits.js";
+import { AttachmentTransferSource } from "../transfer-source.js";
+import { RestFailure, type Outcome } from "./classify.js";
+import type { RestRuntime } from "./owner.js";
+/**
+ * One REST request as the owner schedules it: Routing, cache coordination, upload handling and decoding.
+ * The owner fills instance, sources and the cache guards before the first attempt
+ */
+export type Request<A> = {
+    method: "POST" | "GET" | "PATCH" | "DELETE" | "PUT";
+    /** Major resource for route grouping and message-cache ownership: A channel or guild ID, or a fixed label such as "application" */
+    channel: string;
+    /** Path after /v1, including any query string. Empty for a signed upload PUT */
+    path: string;
+    /** Log-safe route template, when the owner builds a stricter one than routeTemplate for a caller-supplied path */
+    template?: string;
+    /** JSON text and attachment files. The owner snapshots byte files before any wait */
+    body: EncodedBody | undefined;
+    /** Required success status. Another 2xx status is a response failure */
+    status?: number;
+    /** Decode an accepted response. A thrown RestFailure keeps its reason, other throws become response failures */
+    decode: (response: Response, instance: InstanceEndpointContext, signal: AbortSignal) => Promise<A>;
+    /** Rate-limit group that separates routes sharing a major resource, such as "history" or "pins" */
+    bucket?: string;
+    /** A false value skips message-cache coordination for requests that never read or change cached messages */
+    cache?: false;
+    /** Explicit message mutation for methods such as POST that do not otherwise imply one to the cache guard */
+    messageMutation?: true;
+    /** Message ID the request reads or changes, used by the message-cache guard and deletion */
+    target?: string;
+    /** Record a successful value in the message cache under the attempt's guard */
+    observe?: (value: A, guard: CacheRequest) => void;
+    /** Message IDs a bulk deletion removes from the message cache once dispatched */
+    deleteIds?: readonly string[];
+    /** Author whose cached messages are removed once the request is dispatched */
+    deleteAuthorId?: string;
+    /** Clear the message cache when the request is sent and again after it completes, because it can delete any message */
+    invalidateMessages?: true;
+    /** A moderation request invalidates its guarded resources once dispatched, not only when its outcome is unknown */
+    moderation?: true;
+    /** X-Audit-Log-Reason header value */
+    auditReason?: string;
+    /** X-Fluxer-Features capabilities required by one provider-gated route */
+    features?: readonly string[];
+    /** Guild-cache resources this request reads or changes, registered as a guard before any wait */
+    resourceCache?: ResourceRequest;
+    /** The registered guild-cache guard, set by the owner */
+    resourceGuard?: ResourceGuard;
+    /** Channel-cache resources this request reads or changes, registered as a guard before any wait */
+    channelCache?: ChannelCacheRequest;
+    /** The registered channel-cache guard, set by the owner */
+    channelGuard?: ChannelCacheGuard;
+    /** Webhook ID for token-authenticated webhook routes, which carry the token in the path instead of a header */
+    webhookId?: string;
+    /** Recipient of a direct message. The owner opens the conversation first, then sends to its channel */
+    directMessageUser?: string;
+    /** Decoder used once the direct-message channel is known */
+    decodeDirectMessage?: (response: Response, channel: string, signal: AbortSignal) => Promise<A>;
+    /** A preparation step, such as opening a DM or planning uploads, that never marks the operation dispatched or rejected */
+    preparation?: boolean;
+    /** The resolved instance, set by the owner before the first attempt */
+    instance?: InstanceEndpointContext;
+    /** Transfer sources for the body's files, created by the owner */
+    sources?: readonly AttachmentTransferSource[];
+    /** Send files inline as multipart because presigned uploads are unavailable */
+    inlineAttachments?: true;
+    /** A client.rest.request route, which has no expected response shape, so an unusable response is not logged */
+    callerDescribed?: true;
+    /** Successful value for Fluxer's temporarily-disabled-feature rejection */
+    featureDisabled?: () => A;
+    /** Signed upload of one part of a source to external storage, sent without SDK credentials */
+    put?: {
+        url: string;
+        source: AttachmentTransferSource;
+        offset: number;
+        size: number;
+        contentType?: string;
+    };
+};
+/** Everything one attempt needs from its operation */
+export interface AttemptContext<A, M extends MessageCore = MessageCore> {
+    readonly runtime: RestRuntime<M>;
+    readonly token: Redacted.Redacted<string>;
+    readonly request: Request<A>;
+    readonly route: RateRoute;
+    /** The operation's outcome, shared across its attempts and preparation steps */
+    readonly progress: {
+        outcome: Outcome;
+    };
+    /** Message-cache generation at operation start, so a later gap stops this operation's cache writes */
+    readonly generation: number;
+    /** Fiber whose context carries the caller's logger, tracing and metrics services */
+    readonly fiber: Fiber.Fiber<unknown, unknown>;
+    /** Zero-based attempt number, reported in logs and spans */
+    readonly retryCount: number;
+}
+/** A decoded value, or a confirmed rate limit that the operation waits out before sending again */
+export type AttemptResult<A> = {
+    readonly kind: "success";
+    readonly value: A;
+} | {
+    readonly kind: "retry";
+    readonly retry: number;
+    readonly global: boolean;
+    readonly bucket: string;
+    readonly apiError: ApiErrorDetail | null;
+    readonly providerCode: string | undefined;
+};
+/** Run every cleanup action, then rethrow the one failure or an AggregateError of several */
+export declare function completeCleanup(actions: readonly (() => void | PromiseLike<void>)[]): Promise<void>;
+/** Send one request, classify and decode its response and apply cache effects */
+export declare function runAttempt<A, M extends MessageCore>(context: AttemptContext<A, M>): Effect.Effect<AttemptResult<A>, RestFailure | ClientClosedError>;
+//# sourceMappingURL=attempt.d.ts.map

package/dist/internal/rest/attempt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attempt.d.ts","sourceRoot":"","sources":["../../../src/internal/rest/attempt.ts"],"names":[],"mappings":"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"}