@neontechspace/fluxerly 1000.0.0-nightly.12

package/dist/internal/rest/attempt.js

@@ -0,0 +1,410 @@
+/**
+ * One REST attempt: Send a scheduled request through the HTTP transport, classify the response, decode it and record
+ * cache effects, then release every resource the attempt acquired.
+ * Invariant: An attempt registers its abort controller and message-cache guard only after caller-owned sources open,
+ * always awaits response-body and transfer cleanup, and reports cleanup failures without replacing the operation result.
+ * Cancellation or a lost response after dispatch cannot establish non-delivery or rollback.
+ * Implements [SDK contracts: Delivery, requests and caches](/docs/SDK-CONTRACTS.md#delivery-requests-and-caches)
+ */
+import * as Cause from "effect/Cause";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as Redacted from "effect/Redacted";
+import { ClientClosedError } from "#sdk/errors";
+import { apiErrorHint, routeAction } from "#sdk/api-errors";
+import { TransportError } from "../effect-failures.js";
+import { metrics } from "../metrics.js";
+import { emitObservation } from "../observer.js";
+import { fiberRejectionScope } from "../rejection-scope.js";
+import { multipart } from "../multipart.js";
+import { routeTemplate } from "../rate-limits.js";
+import { ResponseJsonCleanupError } from "../response-json.js";
+import { AttachmentTransferCleanupError, AttachmentTransferSource, AttachmentTransferVerificationCleanupError, } from "../transfer-source.js";
+import { classifyResponse, RestFailure } from "./classify.js";
+/** Run every cleanup action, then rethrow the one failure or an AggregateError of several */
+export async function completeCleanup(actions) {
+    const failures = [];
+    for (const action of actions) {
+        try {
+            await action();
+        }
+        catch (error) {
+            failures.push(error);
+        }
+    }
+    if (failures.length === 1)
+        throw failures[0];
+    if (failures.length > 1)
+        throw new AggregateError(failures, "REST cleanup failed");
+}
+/** Parse a payload for unsafe debugging, keeping text that is not JSON */
+function parsedPayload(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        // allow-silent: Non-JSON bodies are logged as their text instead
+        return text;
+    }
+}
+/** Bytes of a response body that unsafe payload logging reads before cancelling its copy */
+const payloadReadLimit = 65_536;
+/** Read at most payloadReadLimit bytes from a copy of the response, then cancel the copy so the rest is never held */
+async function payloadText(response) {
+    const body = response.clone().body;
+    if (!body)
+        return { text: "", truncated: false };
+    const reader = body.getReader();
+    const chunks = [];
+    let size = 0;
+    let truncated = false;
+    try {
+        while (true) {
+            const next = await reader.read();
+            if (next.done)
+                break;
+            chunks.push(next.value);
+            size += next.value.byteLength;
+            if (size > payloadReadLimit) {
+                truncated = true;
+                break;
+            }
+        }
+    }
+    finally {
+        // allow-silent: Cancelling the logging copy cannot affect the response that decoding reads
+        reader.cancel().catch(() => undefined);
+    }
+    return { text: Buffer.concat(chunks).subarray(0, payloadReadLimit).toString("utf8"), truncated };
+}
+function requestUrl(context) {
+    const { request, token } = context;
+    return (request.put?.url ??
+        `${request.instance.apiPublic}/v1${request.webhookId ? `/webhooks/${request.webhookId}/${encodeURIComponent(Redacted.value(token))}` : ""}${request.path}`);
+}
+function requestHeaders(context, state) {
+    const { request, token } = context;
+    if (request.put)
+        return {
+            "Content-Length": String(request.put.size),
+            ...(request.put.contentType ? { "Content-Type": request.put.contentType } : {}),
+        };
+    return {
+        ...(request.webhookId ? {} : { Authorization: `Bot ${Redacted.value(token)}` }),
+        ...(request.auditReason === undefined ? {} : { "X-Audit-Log-Reason": request.auditReason }),
+        ...(request.features === undefined ? {} : { "X-Fluxer-Features": request.features.join(",") }),
+        ...(state.multipartHeaders
+            ? state.multipartHeaders
+            : request.body === undefined
+                ? {}
+                : { "Content-Type": "application/json" }),
+    };
+}
+/** Send one request, classify and decode its response and apply cache effects */
+export function runAttempt(context) {
+    const { runtime, request, route, progress, generation, fiber, retryCount } = context;
+    const rateAttempt = runtime.admission.rates.begin(route);
+    const template = request.template ?? routeTemplate(request.put ? "/attachments/upload" : request.path, request.webhookId);
+    const failure = (error, state) => {
+        if (error instanceof AttachmentTransferCleanupError)
+            throw error;
+        if (error instanceof AttachmentTransferVerificationCleanupError) {
+            state?.cleanupDefects.push(error.cleanup);
+            return new RestFailure({ reason: "network", outcome: progress.outcome });
+        }
+        if (error instanceof ResponseJsonCleanupError) {
+            state?.cleanupDefects.push(error.cause);
+            const rejected = error.status >= 400;
+            if (rejected && !request.preparation)
+                progress.outcome = "rejected";
+            return new RestFailure({
+                reason: rejected ? "rejected" : "response",
+                outcome: progress.outcome,
+                status: error.status,
+            });
+        }
+        return runtime.closed
+            ? new ClientClosedError()
+            : error instanceof RestFailure || error instanceof ClientClosedError
+                ? error
+                : // A connection lost while the response body arrives is a network failure that an eligible read may retry
+                    error instanceof TransportError
+                        ? new RestFailure({ reason: "network", outcome: progress.outcome, retryableRead: true, cause: error })
+                        : new RestFailure({ reason: "network", outcome: progress.outcome });
+    };
+    const send = (state) => Effect.suspend(() => {
+        const startedAt = runtime.logical.now();
+        return Effect.tryPromise({
+            try: () => {
+                if (runtime.closed)
+                    throw new ClientClosedError();
+                if (!request.preparation) {
+                    progress.outcome = "unknown";
+                    if (request.invalidateMessages)
+                        runtime.cache?.gap();
+                }
+                if (request.body && !request.put && runtime.logging?.unsafePayloads("rest")) {
+                    const route = template;
+                    runtime.logging.payload("rest", "rest.payloadSent", `${request.method} ${route} request body`, parsedPayload(request.body.json), { route });
+                }
+                const work = runtime
+                    .http(requestUrl(context), {
+                    method: request.method,
+                    redirect: "error",
+                    signal: state.controller.signal,
+                    headers: requestHeaders(context, state),
+                    ...(state.upload
+                        ? { body: state.upload.body }
+                        : request.body
+                            ? { body: request.body.json }
+                            : {}),
+                    ...(state.upload === undefined ? {} : { duplex: "half" }),
+                })
+                    .then((response) => {
+                    state.response = response;
+                    return response;
+                })
+                    .catch((error) => {
+                    if (error instanceof AttachmentTransferCleanupError ||
+                        error instanceof AttachmentTransferVerificationCleanupError)
+                        throw error;
+                    throw new RestFailure({
+                        reason: "network",
+                        outcome: progress.outcome,
+                        retryableRead: true,
+                        cause: new TransportError(error),
+                    });
+                });
+                // allow-silent: The work promise itself is returned and its rejection observed by the caller, so this only records settlement
+                state.settled = work.then(() => undefined, () => undefined);
+                return work;
+            },
+            catch: (error) => failure(error, state),
+        }).pipe(Effect.onExit(() => Effect.sync(() => {
+            const durationMs = Math.round(runtime.logical.now() - startedAt);
+            state.requestMs = durationMs;
+            metrics.rest(template, state.response?.status ?? null, durationMs, fiber.context);
+            emitObservation(runtime.logging, {
+                type: "rest",
+                method: request.method,
+                route: template,
+                status: state.response?.status ?? null,
+                durationMs,
+                attempt: retryCount + 1,
+            });
+        })), Effect.withSpan("fluxerly.rest.request", {
+            attributes: {
+                "http.request.method": request.method,
+                "fluxerly.route": template,
+                "fluxerly.attempt": retryCount + 1,
+            },
+        }));
+    });
+    /** The guild or channel a request targets, for rejection records. IDs are safe to log, unlike other path segments */
+    const targetText = (path) => {
+        const target = /^\/(channels|guilds)\/(\d{1,20})(?:[/?]|$)/.exec(path);
+        return target === null ? "" : ` for ${target[1] === "channels" ? "channel" : "community"} ${target[2]}`;
+    };
+    /** Log one attempt after its response was classified. The duration covers the request until response headers */
+    const logRequest = (state, exit) => Effect.sync(() => {
+        const durationMs = state.requestMs ?? 0;
+        const status = state.response?.status ?? null;
+        const failed = Exit.isFailure(exit)
+            ? exit.cause.reasons.find((reason) => reason._tag === "Fail")
+            : undefined;
+        const rejection = failed?._tag === "Fail" && failed.error instanceof RestFailure ? failed.error : undefined;
+        // The sanitized Fluxer code, recognized or not, so even Debug output names the rejection
+        const apiError = rejection?.apiError?.providerCode ?? rejection?.providerCode ?? undefined;
+        // A rejected token or permission persists until someone changes the configuration, so it is
+        // logged once per route and code even when the application handles the Result. Signed upload
+        // destinations are external storage and never report Fluxer permissions. Inside a handler the record
+        // waits in the invocation's rejection scope, so a handler failure that reports it is logged only once
+        if (runtime.logging !== undefined &&
+            rejection !== undefined &&
+            (status === 401 || status === 403) &&
+            request.put === undefined) {
+            const rejected = {
+                level: "warn",
+                category: "rest",
+                code: "rest.rejected",
+                message: `${request.method} ${template} was rejected${targetText(request.path)}: ${rejection.apiError?.explanation ??
+                    (apiError === undefined
+                        ? "Fluxer refused the request"
+                        : `Fluxer returned ${apiError}, a code this SDK version does not describe yet`)} (${rejection.apiError === null || apiError === undefined ? "" : `${apiError}, `}HTTP ${status})`,
+                route: template,
+                status,
+                fields: {
+                    method: request.method,
+                    apiError,
+                    // Token-authenticated webhook routes send the webhook token, not the bot token
+                    hint: apiErrorHint(rejection.apiError, status, request.webhookId === undefined ? "bot" : "webhook", routeAction(template)),
+                },
+            };
+            if (!fiberRejectionScope(fiber.context)?.hold(runtime.logging, rejected, fiber.context, rejection))
+                runtime.logging.log(rejected, fiber.context);
+        }
+        if (!runtime.logging?.enabled("debug", "rest"))
+            return;
+        runtime.logging.log({
+            level: "debug",
+            category: "rest",
+            code: "rest.request",
+            message: `${request.method} ${template} ${status !== null
+                ? `returned ${status}`
+                : Exit.isFailure(exit) && Cause.hasInterrupts(exit.cause)
+                    ? "was cancelled"
+                    : "failed before a response"} in ${durationMs} ms`,
+            route: template,
+            ...(status === null ? {} : { status }),
+            durationMs,
+            attempt: retryCount + 1,
+            fields: { method: request.method, apiError },
+        }, fiber.context);
+    });
+    const receive = (state, response) => {
+        const bucket = request.put
+            ? route.key
+            : runtime.admission.rates.observe(rateAttempt, response, runtime.logical.now());
+        return Effect.tryPromise({
+            try: () => {
+                const work = (async () => {
+                    const classified = await classifyResponse(response, {
+                        method: request.method,
+                        upload: request.put !== undefined,
+                        preparation: request.preparation === true,
+                        hasFeatureFallback: request.featureDisabled !== undefined,
+                        progress,
+                        signal: state.controller.signal,
+                        cleanupDefects: state.cleanupDefects,
+                        now: () => runtime.logical.now(),
+                        pauseGlobal: (until) => runtime.admission.pauseGlobal(until),
+                        pauseBucket: (until) => runtime.admission.rates.pause(bucket, until, runtime.logical.now(), rateAttempt.sequence),
+                        notFound: () => {
+                            if (request.resourceGuard)
+                                runtime.resources.missing(request.resourceGuard);
+                            if (request.channelGuard)
+                                runtime.channels.missing(request.channelGuard);
+                        },
+                    });
+                    if (classified.kind === "retry")
+                        return { ...classified, bucket };
+                    if (classified.kind === "featureDisabled")
+                        return { kind: "success", value: request.featureDisabled() };
+                    if (request.status !== undefined && response.status !== request.status)
+                        throw new RestFailure({
+                            reason: "response",
+                            outcome: progress.outcome,
+                            status: response.status,
+                        });
+                    if (runtime.logging?.unsafePayloads("rest")) {
+                        // Unsafe debugging reads a copy, so decoding keeps its own bounded stream
+                        const route = template;
+                        void payloadText(response).then(({ text, truncated }) => runtime.logging?.payload("rest", "rest.payloadReceived", `${request.method} ${route} response body${truncated ? `, first ${payloadReadLimit} bytes` : ""}`, truncated ? text : parsedPayload(text), { route, status: response.status, fields: { truncated } }), 
+                        // allow-silent: A failed read of the logging copy leaves decoding to report the body
+                        () => undefined);
+                    }
+                    const value = await request.decode(response, request.instance, state.controller.signal);
+                    return { kind: "success", value };
+                })();
+                // allow-silent: The work promise itself is returned and its rejection observed by the caller, so this only records settlement
+                state.settled = work.then(() => undefined, () => undefined);
+                return work;
+            },
+            catch: (error) => failure(error, state),
+        });
+    };
+    return Effect.acquireUseRelease(Effect.sync(() => {
+        // Opening a caller-owned source can throw before it is consumed. Do that
+        // before registering client-owned controller or cache state, whose release
+        // only runs after successful acquisition
+        const putUpload = request.put ? request.put.source.open(request.put.offset, request.put.size) : undefined;
+        const upload = putUpload ??
+            ((request.webhookId || request.inlineAttachments) && request.body?.files.length
+                ? multipart(request.body, request.sources ?? [])
+                : undefined);
+        const multipartHeaders = upload && "contentType" in upload && "size" in upload
+            ? { "Content-Type": String(upload.contentType), "Content-Length": String(upload.size) }
+            : undefined;
+        const controller = new AbortController();
+        runtime.controllers.add(controller);
+        const guard = request.cache === false ||
+            request.preparation ||
+            request.bucket === "reaction" ||
+            (request.bucket === "pins" && request.method === "GET")
+            ? undefined
+            : runtime.cache?.begin(request.channel, request.target, request.messageMutation === true ||
+                request.method === "PATCH" ||
+                request.method === "DELETE" ||
+                request.bucket === "pins", generation);
+        return {
+            controller,
+            settled: Promise.resolve(),
+            response: undefined,
+            guard,
+            success: false,
+            upload,
+            putUpload,
+            multipartHeaders,
+            cleanupDefects: [],
+        };
+    }), (state) => send(state).pipe(Effect.flatMap((response) => receive(state, response)), Effect.onExit((exit) => logRequest(state, exit)), Effect.flatMap((result) => result.kind === "success" && state.putUpload
+        ? Effect.tryPromise({
+            try: () => state.putUpload.verify(),
+            catch: (error) => failure(error, state),
+        }).pipe(Effect.flatMap(() => Effect.promise(() => state.putUpload.finish())), Effect.as(result))
+        : Effect.succeed(result)), Effect.map((result) => {
+        if (result.kind === "success") {
+            state.success = true;
+            if (request.resourceGuard)
+                runtime.resources.complete(request.resourceGuard, result.value);
+            if (request.channelGuard)
+                runtime.channels.complete(request.channelGuard, result.value);
+            if (state.guard) {
+                if (request.method === "DELETE" || request.bucket === "pins")
+                    runtime.cache.delete({ id: request.target, channelId: request.channel }, state.guard);
+                else
+                    request.observe?.(result.value, state.guard);
+            }
+        }
+        return result;
+    })), (state) => Effect.uninterruptible(Effect.promise(async () => {
+        let cancelled = false;
+        await completeCleanup([
+            async () => {
+                if (state.response && !state.response.bodyUsed) {
+                    await state.response.body?.cancel();
+                    cancelled = true;
+                }
+            },
+            () => state.controller.abort(),
+            () => state.upload?.stop(),
+            () => state.settled,
+            async () => {
+                const response = state.response;
+                if (!cancelled && response && !response.bodyUsed) {
+                    try {
+                        await response.body?.cancel();
+                    }
+                    catch (error) {
+                        if (!state.controller.signal.aborted || error !== state.controller.signal.reason)
+                            throw error;
+                    }
+                }
+            },
+            () => {
+                if (state.cleanupDefects.length === 1)
+                    throw state.cleanupDefects[0];
+                if (state.cleanupDefects.length > 1)
+                    throw new AggregateError(state.cleanupDefects, "REST response cleanup failed");
+            },
+        ]);
+    }).pipe(Effect.ensuring(Effect.sync(() => {
+        runtime.controllers.delete(state.controller);
+        if (state.guard) {
+            if (!state.success && progress.outcome === "unknown" && state.guard.mutation)
+                runtime.cache.delete({ id: request.target, channelId: request.channel }, state.guard);
+            runtime.cache.end(state.guard);
+        }
+    })))));
+}
+//# sourceMappingURL=attempt.js.map

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

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

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

@@ -0,0 +1,93 @@
+/**
+ * REST failure classification: The internal RestFailure, response rejection and rate-limit classification, bounded
+ * provider error-body reads and the conversion into public operation errors.
+ * Invariant: Mutations retry only after a confirmed rate-limit rejection, a rejected response marks the outcome rejected
+ * only for real operation requests, and provider error bodies keep only sanitized codes, messages and field paths.
+ * Implements [SDK contracts: Results and failures](/docs/SDK-CONTRACTS.md#results-and-failures)
+ */
+import { ClientClosedError, type OperationErrorOptions } from "#sdk/errors";
+import type { MessageOperationError } from "#sdk/message-errors";
+import { type ApiErrorDetail } from "#sdk/api-errors";
+import { type InputValidationConstraint, type InputValidationDetail } from "#sdk/input-validation";
+/** Whether an operation's request may have reached Fluxer */
+export type Outcome = MessageOperationError["outcome"];
+/** Fields of one internal REST failure. Omitted values are null or false */
+export interface RestFailureOptions {
+    readonly reason: MessageOperationError["reason"];
+    readonly outcome: Outcome;
+    readonly status?: number | null;
+    readonly retryAfterMs?: number | null;
+    /** Whether a GET may be repeated after this failure under the bounded read-retry policy */
+    readonly retryableRead?: boolean;
+    readonly apiError?: ApiErrorDetail | null;
+    readonly inputValidation?: InputValidationDetail | null;
+    /** Unrecognized Fluxer error code with a safe shape, when apiError is null */
+    readonly providerCode?: string | null;
+    /** For reason response, the response field path or named check that failed */
+    readonly responseField?: string | null;
+    /** Underlying transport failure, kept as the public error's cause */
+    readonly cause?: unknown;
+}
+/** One REST operation failure before it becomes a domain-specific public error */
+export declare class RestFailure extends Error {
+    readonly reason: MessageOperationError["reason"];
+    readonly outcome: Outcome;
+    readonly status: number | null;
+    readonly retryAfterMs: number | null;
+    readonly retryableRead: boolean;
+    readonly apiError: ApiErrorDetail | null;
+    readonly inputValidation: InputValidationDetail | null;
+    readonly providerCode: string | null;
+    readonly responseField: string | null;
+    readonly cause?: unknown;
+    /** Whether the failed request was a GET, set once where the request method is known */
+    read: boolean;
+    constructor(options: RestFailureOptions);
+    /** The same failure recorded under the operation's current outcome */
+    withOutcome(outcome: Outcome): RestFailure;
+}
+/** A local validation failure before any request was sent */
+export declare function inputFailure(detail: InputValidationDetail): RestFailure;
+export declare function localInputFailure(path: string, constraint: InputValidationConstraint, explanation: string): RestFailure;
+export declare function operationFailure<Operation extends string, Failure>(error: RestFailure | ClientClosedError, ErrorType: new (options: OperationErrorOptions<Operation>) => Failure, operation: NoInfer<Operation>): Failure | ClientClosedError;
+/** Translate an instance-discovery failure into the operation's not-dispatched failure */
+export declare function instanceFailure(error: unknown): RestFailure | ClientClosedError;
+/** What classification needs from the attempt that received the response */
+export interface ClassifyContext {
+    readonly method: string;
+    /** A signed upload PUT, whose destination is external storage rather than the Fluxer API */
+    readonly upload: boolean;
+    /** A preparation step, such as upload planning, that cannot change the operation's outcome */
+    readonly preparation: boolean;
+    /** The request accepts Fluxer's temporarily-disabled-feature rejection as a successful fallback */
+    readonly hasFeatureFallback: boolean;
+    /** The operation's shared outcome, updated when Fluxer confirms a rejection */
+    readonly progress: {
+        outcome: Outcome;
+    };
+    readonly signal: AbortSignal;
+    /** Cleanup failures collected for the attempt's release step */
+    readonly cleanupDefects: unknown[];
+    readonly now: () => number;
+    /** Pause every route until the given logical time */
+    readonly pauseGlobal: (until: number) => void;
+    /** Pause the learned bucket until the given logical time */
+    readonly pauseBucket: (until: number) => void;
+    /** Tell guarded caches that a GET found no resource */
+    readonly notFound: () => void;
+}
+/** A response the attempt continues with, or a rate-limit wait before the same request is sent again */
+export type ResponseClass = {
+    readonly kind: "accepted";
+} | {
+    readonly kind: "featureDisabled";
+} | {
+    readonly kind: "retry";
+    readonly retry: number;
+    readonly global: boolean;
+    readonly apiError: ApiErrorDetail | null;
+    readonly providerCode: string | undefined;
+};
+/** Classify a received response. Rejections throw a RestFailure with the outcome Fluxer established */
+export declare function classifyResponse(response: Response, context: ClassifyContext): Promise<ResponseClass>;
+//# sourceMappingURL=classify.d.ts.map

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

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