@neontechspace/fluxerly 1000.0.0-nightly.12

package/dist/internal/reaction-pages.js

@@ -0,0 +1,213 @@
+/**
+ * Reaction pages: One message whose page changes on ◀ and ▶ clicks, read through one reaction collector.
+ * Invariant: Clicks are turned one at a time by the collector's callback, the SDK never removes reactions other than its
+ * own arrows and, with removeClicks, the clicker's arrow, and the bot's arrows are removed once listening ends, however
+ * it ends. A failure, cancellation or interruption wins over a later cleanup failure.
+ * Implements [SDK contracts: Results and failures](/docs/SDK-CONTRACTS.md#results-and-failures)
+ */
+import * as Cause from "effect/Cause";
+import * as Deferred from "effect/Deferred";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import { ConfigurationError } from "#sdk/errors";
+import { collectorBudgetMessage } from "./collector.js";
+import { record } from "./decode/primitives.js";
+import { readInput } from "./defects.js";
+import { collectReactions } from "./reaction-collector.js";
+import { unsupportedKeyHint } from "./suggest.js";
+/** The arrows the bot adds, previous first. Clicks also match the text-presentation forms without U+FE0F */
+const arrows = ["◀️", "▶️"];
+/** Page step for a clicked emoji name: -1 for previous, 1 for next and 0 for anything else */
+function step(name) {
+    const plain = name.replace("️", "");
+    return plain === "◀" ? -1 : plain === "▶" ? 1 : 0;
+}
+const optionKeys = ["users", "idleMs", "timeoutMs", "removeClicks", "signal"];
+/** Copy and check the pages once. Page bodies are checked by send and edit, so only their shape is checked here */
+function copyPages(pages) {
+    if (!Array.isArray(pages) || pages.length === 0)
+        return new ConfigurationError("pages", "Pages must be a nonempty array of strings or page objects");
+    const copied = [];
+    for (const page of Array.from(pages)) {
+        if (typeof page === "string") {
+            if (page.length === 0)
+                return new ConfigurationError("pages", "A text page must not be empty");
+            copied.push(page);
+            continue;
+        }
+        if (!record(page))
+            return new ConfigurationError("pages", "Each page must be a string or a page object");
+        const unsupported = Object.keys(page).find((key) => key !== "content" && key !== "embeds");
+        if (unsupported !== undefined)
+            return new ConfigurationError("pages", `Unsupported page property ${JSON.stringify(unsupported)}`, {
+                hint: unsupportedKeyHint(unsupported, ["content", "embeds"]),
+            });
+        const { content, embeds } = page;
+        if (content !== undefined && typeof content !== "string")
+            return new ConfigurationError("pages", "Page content must be a string");
+        if (embeds !== undefined && !Array.isArray(embeds))
+            return new ConfigurationError("pages", "Page embeds must be an array");
+        const list = embeds === undefined ? undefined : Object.freeze(Array.from(embeds));
+        if (!content && !list?.length)
+            return new ConfigurationError("pages", "Each page object needs nonempty content or at least one embed");
+        copied.push(Object.freeze({
+            ...(content === undefined ? {} : { content }),
+            ...(list === undefined ? {} : { embeds: list }),
+        }));
+    }
+    return Object.freeze(copied);
+}
+/** Copy and check pages and options once, before anything is sent */
+function settings(pages, options) {
+    const copied = copyPages(pages);
+    if (copied instanceof ConfigurationError)
+        return copied;
+    const input = options === undefined ? {} : options;
+    if (!record(input))
+        return new ConfigurationError("paginateOptions", "Page options must be an object");
+    const unsupported = Object.keys(input).find((key) => !optionKeys.includes(key));
+    if (unsupported !== undefined)
+        return new ConfigurationError("paginateOptions", `Unsupported page option ${JSON.stringify(unsupported)}`, {
+            hint: unsupportedKeyHint(unsupported, optionKeys),
+        });
+    const { users, idleMs = 60_000, timeoutMs = 300_000 } = input;
+    const removeClicks = input.removeClicks ?? false;
+    if (!milliseconds(idleMs))
+        return new ConfigurationError("idleMs", collectorBudgetMessage("idleMs"));
+    if (!milliseconds(timeoutMs))
+        return new ConfigurationError("timeoutMs", collectorBudgetMessage("timeoutMs"));
+    if (typeof removeClicks !== "boolean")
+        return new ConfigurationError("removeClicks", 'The page option "removeClicks" must be true or false');
+    let turners;
+    if (typeof users === "function")
+        turners = users;
+    else if (Array.isArray(users) &&
+        users.every((id) => typeof id === "string" && /^[1-9][0-9]{0,19}$/.test(id)))
+        turners = Object.freeze([...users]);
+    else
+        return new ConfigurationError("users", users === undefined
+            ? 'The page option "users" is required, as a list of user IDs or a check such as () => true'
+            : 'The page option "users" must be a list of decimal user IDs or a function');
+    return { pages: copied, users: turners, idleMs, timeoutMs, removeClicks };
+}
+const milliseconds = (value) => typeof value === "number" && Number.isSafeInteger(value) && value > 0 && value <= 2_147_483_647;
+const sendInput = (page) => page;
+/** A page change replaces both text and embeds, so nothing from the previous page stays */
+const editInput = (page) => (typeof page === "string"
+    ? { content: page, embeds: [] }
+    : { content: page.content ?? "", embeds: page.embeds ?? [] });
+/**
+ * Send the first page to a channel, add the arrows and turn pages on clicks until idle, timeout, failure or
+ * interruption. Command contexts supply their author as users through askerPageOptions
+ */
+export function paginate(owner, channelId, pages, options) {
+    return Effect.gen(function* () {
+        const config = yield* readInput(() => settings(pages, options));
+        if (config instanceof ConfigurationError)
+            return yield* Effect.fail(config);
+        const first = yield* owner.send(channelId, sendInput(config.pages[0]));
+        if (config.pages.length === 1)
+            return Object.freeze({ message: first, page: 0, reason: "singlePage" });
+        return yield* listen(owner, first, config);
+    });
+}
+function listen(owner, first, config) {
+    const target = { id: first.id, channelId: first.channelId };
+    const botId = first.author.id;
+    const { pages, users } = config;
+    let page = 0;
+    let message = first;
+    let failure;
+    let collector;
+    // The users check is application code, so the collector reports its throws and non-boolean returns as filter failures
+    const filter = (reaction) => reaction.userId !== botId &&
+        reaction.emoji.id === undefined &&
+        step(reaction.emoji.name) !== 0 &&
+        (typeof users === "function" ? users(reaction) : users.includes(reaction.userId));
+    // SDK requests fail the pages rather than the collector callback, so they are not reported as application failures
+    const turn = (reaction) => Effect.gen(function* () {
+        const next = (page + step(reaction.emoji.name) + pages.length) % pages.length;
+        message = yield* owner.edit(target, editInput(pages[next]));
+        page = next;
+        if (config.removeClicks)
+            yield* owner.reaction("removeUserReaction", target, reaction.emoji, undefined, reaction.userId);
+    }).pipe(Effect.catch((error) => Effect.sync(() => {
+        failure ??= error;
+        collector?.stop();
+    })));
+    return Effect.uninterruptibleMask((restore) => Effect.gen(function* () {
+        const registered = yield* collectReactions(owner, target, {
+            maxReactions: Number.MAX_SAFE_INTEGER,
+            idleMs: config.idleMs,
+            timeoutMs: config.timeoutMs,
+            filter,
+            ...(first.guildId === undefined ? {} : { guildId: first.guildId }),
+        }, false, turn, !config.removeClicks);
+        collector = registered;
+        const exit = yield* Effect.exit(restore(Effect.gen(function* () {
+            for (const arrow of arrows)
+                yield* owner.reaction("addReaction", target, arrow);
+            const ended = yield* Deferred.await(registered.closed);
+            if (failure !== undefined)
+                return yield* Effect.fail(failure);
+            return Object.freeze({ message, page, reason: ended.reason === "idle" ? "idle" : "timeout" });
+        })));
+        registered.stop();
+        // Wait for an active page change to finish, so it cannot run after the arrows are gone
+        yield* Effect.exit(Deferred.await(registered.closed));
+        let removal;
+        let defects = Cause.empty;
+        for (const arrow of arrows) {
+            const removed = yield* Effect.exit(owner.reaction("removeReaction", target, arrow));
+            if (Exit.isSuccess(removed))
+                continue;
+            const failed = removed.cause.reasons.find((reason) => reason._tag === "Fail");
+            if (failed?._tag === "Fail")
+                removal ??= failed.error;
+            defects = Cause.combine(defects, Cause.fromReasons(removed.cause.reasons.filter((reason) => reason._tag === "Die")));
+        }
+        if (Exit.isFailure(exit))
+            return yield* Effect.failCause(Cause.combine(exit.cause, defects));
+        if (defects.reasons.length)
+            return yield* Effect.failCause(defects);
+        if (removal !== undefined)
+            return yield* Effect.fail(removal);
+        return exit.value;
+    }));
+}
+/**
+ * Options for a command context's paginate: The users option defaults to the command's author, and a default-API
+ * handler signal is combined with any supplied signal. Getters defer each read to the operation, so a throwing caller
+ * getter is still marked as application input there, and malformed options pass through to be rejected there
+ */
+export function askerPageOptions(options, asker, signal) {
+    if (options === undefined)
+        return { users: [asker], ...(signal === undefined ? {} : { signal }) };
+    if (typeof options !== "object" || options === null || Array.isArray(options))
+        return options;
+    let combined;
+    const read = (property) => {
+        if (property === "users")
+            return Reflect.get(options, "users", options) ?? [asker];
+        if (property !== "signal" || signal === undefined)
+            return Reflect.get(options, property, options);
+        if (combined !== undefined)
+            return combined;
+        const own = Reflect.get(options, "signal", options);
+        // An invalid caller signal passes through unchanged, so the operation rejects it with ConfigurationError
+        return (combined =
+            own === undefined ? signal : own instanceof AbortSignal ? AbortSignal.any([signal, own]) : own);
+    };
+    const added = signal === undefined ? ["users"] : ["users", "signal"];
+    return new Proxy(Object.create(null), {
+        get: (_target, property) => read(property),
+        ownKeys: () => [...new Set([...Reflect.ownKeys(options), ...added])],
+        getOwnPropertyDescriptor: (_target, property) => {
+            if (added.includes(property))
+                return { value: read(property), enumerable: true, configurable: true, writable: false };
+            const descriptor = Reflect.getOwnPropertyDescriptor(options, property);
+            return descriptor === undefined ? undefined : { ...descriptor, configurable: true };
+        },
+    });
+}
+//# sourceMappingURL=reaction-pages.js.map

package/dist/internal/reaction-pages.js.map

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

package/dist/internal/reactions.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Reaction operations, reaction user pages and reaction gateway projections.
+ * Invariant: Reaction events never change cached message snapshots.
+ * Implements [SDK contracts: Delivery, requests and caches](/docs/SDK-CONTRACTS.md#delivery-requests-and-caches)
+ */
+import type { ReactionEmojiInput, ReactionTarget, ReactionUsersPage } from "#sdk/reactions";
+export declare function encodeReactionUsersQuery(query: unknown): import("#sdk/input-validation").InputValidationFailure | {
+    limit: number;
+    after: string | undefined;
+    params: URLSearchParams;
+};
+export declare function decodeReactionUsersPage(value: unknown, query: {
+    readonly limit: number;
+    readonly after: string | undefined;
+    readonly params: URLSearchParams;
+}): ReactionUsersPage | undefined;
+export declare function resolveReactionEmoji(value: ReactionEmojiInput): string | {
+    readonly name: string;
+    readonly id: string;
+} | undefined;
+export declare function encodeReactionEmoji(value: ReactionEmojiInput): string | undefined;
+export declare const reactionEvents: {
+    readonly MESSAGE_REACTION_ADD: "messageReactionAdd";
+    readonly MESSAGE_REACTION_ADD_MANY: "messageReactionAddMany";
+    readonly MESSAGE_REACTION_REMOVE: "messageReactionRemove";
+    readonly MESSAGE_REACTION_REMOVE_ALL: "messageReactionRemoveAll";
+    readonly MESSAGE_REACTION_REMOVE_EMOJI: "messageReactionRemoveEmoji";
+};
+export declare function decodeReaction(event: keyof typeof reactionEvents, value: unknown): Readonly<ReactionTarget> | undefined;
+//# sourceMappingURL=reactions.d.ts.map

package/dist/internal/reactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactions.d.ts","sourceRoot":"","sources":["../../src/internal/reactions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAiB,kBAAkB,EAAE,cAAc,EAAgB,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAMxH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO;;;;EAmBtD;AAED,wBAAgB,uBAAuB,CACnC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;CAAE,GACxG,iBAAiB,GAAG,SAAS,CA+B/B;AAUD,wBAAgB,oBAAoB,CAChC,KAAK,EAAE,kBAAkB,GAC1B,MAAM,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAmCrE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,GAAG,SAAS,CAKjF;AAcD,eAAO,MAAM,cAAc;aACvB,oBAAoB,EAAE,oBAAoB;aAC1C,yBAAyB,EAAE,wBAAwB;aACnD,uBAAuB,EAAE,uBAAuB;aAChD,2BAA2B,EAAE,0BAA0B;aACvD,6BAA6B,EAAE,4BAA4B;CACrD,CAAA;AAEV,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,OAAO,cAAc,EAAE,KAAK,EAAE,OAAO,wCA+BhF"}

package/dist/internal/reactions.js

@@ -0,0 +1,160 @@
+import { inputValidationFailure, unsupportedKeyFailure } from "#sdk/input-validation";
+import { format } from "#sdk/helpers";
+import { identifier, record } from "./decode/primitives.js";
+import { rejectCheck } from "./decode/trace.js";
+export function encodeReactionUsersQuery(query) {
+    const input = query === undefined ? {} : query;
+    if (!record(input))
+        return inputValidationFailure("query", "type", "Reaction user query must be an object");
+    const unsupported = unsupportedKeyFailure(input, ["limit", "after"], "query", "the reaction user query");
+    if (unsupported)
+        return unsupported;
+    const limitInput = input.limit;
+    const after = input.after;
+    const limit = limitInput === undefined ? 25 : limitInput;
+    if (typeof limit !== "number" || !Number.isInteger(limit) || limit < 1 || limit > 100)
+        return inputValidationFailure("query.limit", "range", "Reaction user limit must be an integer from 1 through 100");
+    if (after !== undefined && !identifier(after))
+        return inputValidationFailure("query.after", "format", "Reaction user cursor must be a decimal ID string");
+    const params = new URLSearchParams({ limit: String(limit) });
+    if (after !== undefined)
+        params.set("after", after);
+    return { limit, after, params };
+}
+export function decodeReactionUsersPage(value, query) {
+    if (!record(value) ||
+        !Array.isArray(value.items) ||
+        value.items.length > query.limit ||
+        typeof value.has_more !== "boolean")
+        return undefined;
+    const items = [];
+    let previous = query.after === undefined ? undefined : BigInt(query.after);
+    for (const item of value.items) {
+        if (!record(item) ||
+            !identifier(item.id) ||
+            typeof item.username !== "string" ||
+            (item.bot !== undefined && typeof item.bot !== "boolean"))
+            return undefined;
+        const id = BigInt(item.id);
+        if (previous !== undefined && id <= previous)
+            return rejectCheck("order");
+        previous = id;
+        items.push(Object.freeze({ id: item.id, username: item.username, isBot: item.bot === true }));
+    }
+    if (value.has_more) {
+        if (items.length === 0 || value.next_after !== items.at(-1).id)
+            return undefined;
+    }
+    else if (value.next_after !== null)
+        return undefined;
+    return Object.freeze({
+        items: Object.freeze(items),
+        hasMore: value.has_more,
+        nextAfter: value.next_after,
+    });
+}
+const name = (value) => typeof value === "string" &&
+    value.length > 0 &&
+    value.length <= 128 &&
+    value.isWellFormed() &&
+    // oxlint-disable-next-line no-control-regex -- rejects control characters and spaces in emoji names
+    !/[\x00-\x20\x7f]/.test(value);
+export function resolveReactionEmoji(value) {
+    if (typeof value === "string") {
+        if (!value.startsWith("<"))
+            return name(value) && !/[%/:<>]/.test(value) ? value : undefined;
+        const parsed = format.tryParseCustomEmoji(value);
+        if (parsed.isErr())
+            return undefined;
+        value = parsed.value;
+    }
+    if (!record(value))
+        return undefined;
+    const hasGuildId = "guildId" in value;
+    const hasAnimated = "animated" in value;
+    const guildId = hasGuildId ? value.guildId : undefined;
+    const animated = hasAnimated ? value.animated : undefined;
+    const snapshot = hasGuildId && hasAnimated && identifier(guildId) && typeof animated === "boolean";
+    const allowCloning = snapshot ? value.allowCloning : undefined;
+    const metadata = snapshot && typeof allowCloning === "boolean";
+    if (Object.keys(value).some((key) => ![
+        "name",
+        "id",
+        "animated",
+        ...(snapshot ? ["guildId"] : []),
+        ...(metadata ? ["allowCloning"] : []),
+    ].includes(key)))
+        return undefined;
+    const id = value.id;
+    if (animated !== undefined && (typeof animated !== "boolean" || id === undefined))
+        return undefined;
+    const nameValue = value.name;
+    if (id === undefined)
+        return name(nameValue) && !/[%/:<>]/.test(nameValue) ? nameValue : undefined;
+    return typeof nameValue === "string" && /^[A-Za-z0-9_-]{1,32}$/.test(nameValue) && identifier(id)
+        ? { name: nameValue, id }
+        : undefined;
+}
+export function encodeReactionEmoji(value) {
+    const emoji = resolveReactionEmoji(value);
+    return emoji === undefined
+        ? undefined
+        : encodeURIComponent(typeof emoji === "string" ? emoji : `${emoji.name}:${emoji.id}`);
+}
+function emoji(value) {
+    if (!record(value) || !name(value.name))
+        return undefined;
+    if (value.id !== undefined && !identifier(value.id))
+        return undefined;
+    if (value.animated !== undefined && (typeof value.animated !== "boolean" || value.id === undefined))
+        return undefined;
+    return Object.freeze({
+        name: value.name,
+        ...(value.id === undefined ? {} : { id: value.id }),
+        ...(value.animated === undefined ? {} : { animated: value.animated }),
+    });
+}
+export const reactionEvents = {
+    MESSAGE_REACTION_ADD: "messageReactionAdd",
+    MESSAGE_REACTION_ADD_MANY: "messageReactionAddMany",
+    MESSAGE_REACTION_REMOVE: "messageReactionRemove",
+    MESSAGE_REACTION_REMOVE_ALL: "messageReactionRemoveAll",
+    MESSAGE_REACTION_REMOVE_EMOJI: "messageReactionRemoveEmoji",
+};
+export function decodeReaction(event, value) {
+    if (!record(value) ||
+        !identifier(value.channel_id) ||
+        !identifier(value.message_id) ||
+        (value.guild_id !== undefined && !identifier(value.guild_id)))
+        return undefined;
+    const target = {
+        id: value.message_id,
+        channelId: value.channel_id,
+        ...(value.guild_id === undefined ? {} : { guildId: value.guild_id }),
+    };
+    if (event === "MESSAGE_REACTION_REMOVE_ALL")
+        return Object.freeze(target);
+    if (event === "MESSAGE_REACTION_ADD_MANY") {
+        if (!Array.isArray(value.reactions) || value.reactions.length === 0 || value.reactions.length > 512)
+            return undefined;
+        const reactions = [];
+        for (const item of value.reactions) {
+            if (!record(item) || !identifier(item.user_id))
+                return undefined;
+            const decoded = emoji(item.emoji);
+            if (!decoded)
+                return undefined;
+            reactions.push(Object.freeze({ userId: item.user_id, emoji: decoded }));
+        }
+        return Object.freeze({ ...target, reactions: Object.freeze(reactions) });
+    }
+    const decoded = emoji(value.emoji);
+    if (!decoded)
+        return undefined;
+    if (event === "MESSAGE_REACTION_REMOVE_EMOJI")
+        return Object.freeze({ ...target, emoji: decoded });
+    if (!identifier(value.user_id))
+        return undefined;
+    return Object.freeze({ ...target, emoji: decoded, userId: value.user_id });
+}
+//# sourceMappingURL=reactions.js.map

package/dist/internal/reactions.js.map

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

package/dist/internal/rejection-scope.d.ts

@@ -0,0 +1,25 @@
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import type { ClientLogger, LogInput } from "./logging.js";
+/** Link a converted failure to its source without changing the public error's cause or retaining either globally */
+export declare function linkRejectionError<A>(error: A, source: object): A;
+export declare class RejectionScope {
+    #private;
+    /** Hold a rejection record for this invocation. False when the invocation already ended, so the caller logs it */
+    hold(logger: ClientLogger, input: LogInput, context: Context.Context<never> | undefined, error: object): boolean;
+    /** Drop only records for this failure's identity, following a bounded cause chain and domain conversion links */
+    claim(error: unknown): void;
+    /** Log every held record */
+    flush(): void;
+    /** End the invocation: Log what is still held, and log later rejections at once */
+    end(): void;
+}
+/** Run default-API handler code so that the operations it starts hold their rejection records in scope */
+export declare function inRejectionScope<A>(scope: RejectionScope | undefined, run: () => A): A;
+/** The scope of the running default-API handler code, if any */
+export declare function currentRejectionScope(): RejectionScope | undefined;
+/** Provide a scope to an Effect, so its operations and callbacks hold their rejection records in it */
+export declare function withRejectionScope<A, E, R>(effect: Effect.Effect<A, E, R>, scope: RejectionScope | undefined): Effect.Effect<A, E, R>;
+/** The scope in a fiber context */
+export declare function fiberRejectionScope(context: Context.Context<never>): RejectionScope | undefined;
+//# sourceMappingURL=rejection-scope.d.ts.map

package/dist/internal/rejection-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rejection-scope.d.ts","sourceRoot":"","sources":["../../src/internal/rejection-scope.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAe1D,oHAAoH;AACpH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,CAGjE;AAED,qBAAa,cAAc;;IAKvB,kHAAkH;IAClH,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAQ/G;IAED,iHAAiH;IACjH,KAAK,CAAC,KAAK,EAAE,OAAO,QAmBnB;IAED,4BAA4B;IAC5B,KAAK,SAMJ;IAED,mFAAmF;IACnF,GAAG,SAGF;CACJ;AAUD,0GAA0G;AAC1G,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,CAEtF;AAED,gEAAgE;AAChE,wBAAgB,qBAAqB,IAAI,cAAc,GAAG,SAAS,CAElE;AAED,uGAAuG;AACvG,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EACtC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAC9B,KAAK,EAAE,cAAc,GAAG,SAAS,GAClC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAExB;AAED,mCAAmC;AACnC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,cAAc,GAAG,SAAS,CAE/F"}

package/dist/internal/rejection-scope.js

@@ -0,0 +1,103 @@
+/**
+ * Rejection scope: Holds the rest.rejected Warn records of one handler invocation, so a rejected token or permission
+ * that fails the handler within one second is logged once, as the handler's failure record, instead of as a Warn and then an Error.
+ * Invariant: A held record is logged when the invocation ends, after at most holdMs, or never, when the handler's
+ * failure is logged at Error for that rejection's identity, directly or in its cause chain. A handler that fails more
+ * than one second after the rejection also logs its failure, because the Warn has already been flushed. A failure that reaches an onError hook claims
+ * nothing, so the Warn still shows a rejection that the application handles. Native handlers find the scope in their
+ * fiber context. Default-API handler code runs in async context storage, which an operation reads when it starts and
+ * passes on in its fiber context.
+ * Implements [SDK contracts: User-handler failures](/docs/SDK-CONTRACTS.md#user-handler-failures)
+ */
+import { AsyncLocalStorage } from "node:async_hooks";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+/** Longest time a record waits for its handler, so a handler that runs for a long time still shows its rejections */
+const holdMs = 1_000;
+/** Private identity links keep domain error conversion from changing which rejection a handler reports */
+const rejectionSources = new WeakMap();
+/** Link a converted failure to its source without changing the public error's cause or retaining either globally */
+export function linkRejectionError(error, source) {
+    if (typeof error === "object" && error !== null)
+        rejectionSources.set(error, source);
+    return error;
+}
+export class RejectionScope {
+    #held = [];
+    #timer;
+    #ended = false;
+    /** Hold a rejection record for this invocation. False when the invocation already ended, so the caller logs it */
+    hold(logger, input, context, error) {
+        if (this.#ended)
+            return false;
+        this.#held.push({ logger, input, context, error });
+        if (this.#timer === undefined) {
+            this.#timer = setTimeout(() => this.flush(), holdMs);
+            this.#timer.unref?.();
+        }
+        return true;
+    }
+    /** Drop only records for this failure's identity, following a bounded cause chain and domain conversion links */
+    claim(error) {
+        if (this.#held.length === 0)
+            return;
+        const identities = new Set();
+        for (let depth = 0; depth <= 4 && typeof error === "object" && error !== null; depth++) {
+            if (identities.has(error))
+                break;
+            let source = error;
+            for (let links = 0; links <= 4 && source !== undefined; links++) {
+                if (identities.has(source))
+                    break;
+                identities.add(source);
+                source = rejectionSources.get(source);
+            }
+            try {
+                error = error.cause;
+            }
+            catch {
+                // allow-silent: A hostile cause getter ends traversal, while already matched identities remain usable
+                break;
+            }
+        }
+        this.#held = this.#held.filter(({ error }) => !identities.has(error));
+    }
+    /** Log every held record */
+    flush() {
+        if (this.#timer !== undefined)
+            clearTimeout(this.#timer);
+        this.#timer = undefined;
+        const held = this.#held;
+        this.#held = [];
+        for (const { logger, input, context } of held)
+            logger.log(input, context);
+    }
+    /** End the invocation: Log what is still held, and log later rejections at once */
+    end() {
+        this.#ended = true;
+        this.flush();
+    }
+}
+/** The scope of the handler invocation a fiber runs for */
+const CurrentRejectionScope = Context.Reference("@neontechspace/fluxerly/RejectionScope", {
+    defaultValue: () => undefined,
+});
+/** The scope of the default-API handler whose code is running, read when an operation starts */
+const storage = new AsyncLocalStorage();
+/** Run default-API handler code so that the operations it starts hold their rejection records in scope */
+export function inRejectionScope(scope, run) {
+    return scope === undefined ? run() : storage.run(scope, run);
+}
+/** The scope of the running default-API handler code, if any */
+export function currentRejectionScope() {
+    return storage.getStore();
+}
+/** Provide a scope to an Effect, so its operations and callbacks hold their rejection records in it */
+export function withRejectionScope(effect, scope) {
+    return scope === undefined ? effect : Effect.provideService(effect, CurrentRejectionScope, scope);
+}
+/** The scope in a fiber context */
+export function fiberRejectionScope(context) {
+    return Context.get(context, CurrentRejectionScope);
+}
+//# sourceMappingURL=rejection-scope.js.map

package/dist/internal/rejection-scope.js.map

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

package/dist/internal/response-json.d.ts

@@ -0,0 +1,12 @@
+/** Bounded response parsing completed, but releasing its owned reader failed */
+export declare class ResponseJsonCleanupError extends Error {
+    readonly cause: unknown;
+    readonly status: number;
+    constructor(cause: unknown, status: number);
+}
+/**
+ * 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 declare function readResponseJson(response: Response, maxBytes?: number, signal?: AbortSignal): Promise<unknown>;
+//# sourceMappingURL=response-json.d.ts.map

package/dist/internal/response-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-json.d.ts","sourceRoot":"","sources":["../../src/internal/response-json.ts"],"names":[],"mappings":"AAOA,gFAAgF;AAChF,qBAAa,wBAAyB,SAAQ,KAAK;IAE3C,QAAQ,CAAC,KAAK,EAAE,OAAO;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM;IAF3B,YACa,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,MAAM,EAI1B;CACJ;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAClC,QAAQ,EAAE,QAAQ,EAClB,QAAQ,SAAa,EACrB,MAAM,CAAC,EAAE,WAAW,GACrB,OAAO,CAAC,OAAO,CAAC,CAiDlB"}