@neontechspace/fluxerly 1000.0.0-nightly.12

package/dist/internal/rest/options.js

@@ -0,0 +1,99 @@
+/**
+ * REST scheduling and transport option validation for one client.
+ * Invariant: Validation reads caller options once, copies them and starts no network work. Every limit is an integer
+ * within its documented bounds, replacement transports are functions, and every returned transport sends exactly one
+ * User-Agent: The caller's value or the SDK default.
+ * Implements [SDK contracts: Connection and recovery](/docs/SDK-CONTRACTS.md#connection-and-recovery)
+ */
+import { ConfigurationError } from "#sdk/errors";
+import { record } from "../decode/primitives.js";
+import { readCaller } from "../defects.js";
+import { defaultTransport, defaultUserAgent, platformHttpTransport, platformSocketFactory, userAgentMaxLength, validUserAgent, withSocketUserAgent, withUserAgent, } from "../transport/index.js";
+/** Default concurrent API requests for each local shard */
+export const concurrencyPerShard = 4;
+/** Largest concurrency, and the ceiling of the scaled default */
+export const maximumConcurrency = 64;
+export const defaultRestConfiguration = Object.freeze({
+    concurrency: concurrencyPerShard,
+    concurrencyScales: true,
+    mediaConcurrency: 4,
+    maxQueued: 256,
+    queuedJsonMaxBytes: 4_194_304,
+    defaultTimeoutMs: 30_000,
+});
+/** Inclusive bounds and the ConfigurationError text for each REST limit */
+const restBounds = {
+    concurrency: [1, maximumConcurrency, "The option rest.concurrency must be an integer from 1 through 64"],
+    mediaConcurrency: [1, 64, "The option rest.mediaConcurrency must be an integer from 1 through 64"],
+    maxQueued: [1, 65_536, "The option rest.maxQueued must be an integer from 1 through 65,536"],
+    queuedJsonMaxBytes: [
+        65_536,
+        268_435_456,
+        "The option rest.queuedJsonMaxBytes must be an integer from 65,536 through 268,435,456 bytes",
+    ],
+    defaultTimeoutMs: [
+        1,
+        2_147_483_647,
+        "The option rest.defaultTimeoutMs must be an integer from 1 through 2,147,483,647 ms",
+    ],
+};
+const configurationError = (field, message) => new ConfigurationError(field, message);
+/** Validate the rest client option */
+export function restConfiguration(value) {
+    if (value === undefined)
+        return defaultRestConfiguration;
+    if (!record(value))
+        return configurationError("rest", "The option rest must be an object");
+    const keys = Object.keys(restBounds);
+    if (Object.keys(value).some((key) => !keys.includes(key)))
+        return configurationError("rest", "The option rest may contain only concurrency, mediaConcurrency, maxQueued, queuedJsonMaxBytes, and defaultTimeoutMs");
+    const result = { ...defaultRestConfiguration };
+    for (const [field, [minimum, maximum, message]] of Object.entries(restBounds)) {
+        const setting = value[field];
+        if (setting === undefined)
+            continue;
+        if (typeof setting !== "number" || !Number.isSafeInteger(setting) || setting < minimum || setting > maximum)
+            return configurationError(field, message);
+        result[field] = setting;
+    }
+    // An explicit concurrency is used as given, whatever the shard count
+    if (value.concurrency !== undefined)
+        result.concurrencyScales = false;
+    return Object.freeze(result);
+}
+/**
+ * Validate the transport client option, then wrap the implementations. Only reading the caller settings is marked as
+ * application input, so the caller must run this under a defect boundary
+ */
+export function transportConfiguration(value) {
+    if (value === undefined)
+        return { transport: defaultTransport, userAgent: defaultUserAgent() };
+    if (!record(value))
+        return configurationError("transport", "The option transport must be an object");
+    const read = readCaller(() => {
+        if (Object.keys(value).some((key) => !["fetch", "webSocket", "userAgent"].includes(key)))
+            return undefined;
+        const { fetch, webSocket, userAgent } = value;
+        return { fetch, webSocket, userAgent };
+    });
+    if (read === undefined)
+        return configurationError("transport", "The option transport may contain only fetch, webSocket, and userAgent");
+    const { fetch, webSocket, userAgent } = read;
+    if (fetch !== undefined && typeof fetch !== "function")
+        return configurationError("fetch", "The option transport.fetch must be a function");
+    if (webSocket !== undefined && typeof webSocket !== "function")
+        return configurationError("webSocket", "The option transport.webSocket must be a function");
+    if (userAgent !== undefined && !validUserAgent(userAgent))
+        return configurationError("userAgent", `The option transport.userAgent must contain 1 through ${userAgentMaxLength} printable ASCII characters without leading or trailing spaces`);
+    const agent = userAgent === undefined ? defaultUserAgent : () => userAgent;
+    const http = fetch === undefined ? platformHttpTransport : fetch;
+    // WebSocketLike and GatewaySocket describe the same ws subset
+    const sockets = webSocket === undefined
+        ? platformSocketFactory
+        : webSocket;
+    return {
+        transport: Object.freeze({ http: withUserAgent(http, agent), sockets: withSocketUserAgent(sockets, agent) }),
+        userAgent: agent(),
+    };
+}
+//# sourceMappingURL=options.js.map

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

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

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

@@ -0,0 +1,154 @@
+import * as Deferred from "effect/Deferred";
+import * as Effect from "effect/Effect";
+import type * as Redacted from "effect/Redacted";
+import { ClientClosedError } from "#sdk/errors";
+import { type MessageOperationFailure, type SendError } from "#sdk/message-errors";
+import { InputValidationFailure } from "#sdk/input-validation";
+import type { EditMessageInput, ForwardMessageInput, Message, MessageCore, MessageInput, MessageHistoryQuery, MessageOperationOptions, MessageAuditOperationOptions, MessageReference, SendOptions } from "#sdk/messages";
+import type { Attachment, AttachmentDownloadFailure, AttachmentDownloadOptions, AttachmentRefreshFailure, AttachmentRefreshOptions, RefreshedAttachmentUrl } from "#sdk/attachments";
+import type { ReactionEmojiInput, ReactionUsersQuery, ReactionUsersPage } from "#sdk/reactions";
+import type { MessagePinsPage, MessagePinsQuery } from "#sdk/pins";
+import type { MessageSearchContext, MessageSearchPage, MessageSearchQuery } from "#sdk/message-search";
+import { GuildOperationError, type GuildOperation, type GuildOperationOptions } from "#sdk/guilds";
+import { ChannelOperationError, type ChannelOperation, type ChannelOperationOptions } from "#sdk/channels";
+import { WebhookOperationError, type WebhookOperation, type WebhookOperationOptions } from "#sdk/webhooks";
+import { UserOperationError, type UserOperation, type UserOperationOptions } from "#sdk/users";
+import { BotApplicationOperationError, type BotApplicationOperation, type BotApplicationOperationOptions } from "#sdk/application";
+import type { MessageDecoder } from "../message-fields.js";
+import type { MessageCache } from "../cache.js";
+import type { InstanceEndpointContext } from "../instance.js";
+import type { GuildRequest } from "../guilds.js";
+import type { GuildCache } from "../guild-cache.js";
+import type { ChannelRequest } from "../channels.js";
+import type { ChannelCache } from "../channel-cache.js";
+import type { WebhookRequest } from "../webhooks.js";
+import type { UserRequest } from "../users.js";
+import type { UserCache } from "../user-cache.js";
+import type { BotApplicationRequest } from "../application.js";
+import type { ClientLogger } from "../logging.js";
+import type { LogicalScheduler } from "../logical-scheduler.js";
+import { type HttpTransport } from "../transport/index.js";
+import { RestAdmission } from "./admission.js";
+import { type RestConfiguration } from "./options.js";
+import { type DefaultRestRequest, type RestRequest, type RestRequestFailure, type RestResponse } from "#sdk/rest";
+import { UnobservedDownloadDefects, type AttachmentDownloadSource } from "./download.js";
+/** Construction settings for one REST owner */
+export interface RestOwnerOptions<M extends MessageCore> {
+    /** Message cache coordinated with message reads and writes, when enabled */
+    readonly cache?: MessageCache<M> | undefined;
+    /** Total bytes of attachment files that may be reserved by running operations */
+    readonly uploadMaxBytes: number;
+    readonly resources?: GuildCache | undefined;
+    readonly channels?: ChannelCache | undefined;
+    readonly users?: UserCache | undefined;
+    /** The owner's instance resolver. The first successful result is kept for the owner's lifetime */
+    readonly resolveInstance: () => Effect.Effect<InstanceEndpointContext, unknown>;
+    readonly decodeMessage: MessageDecoder<M>;
+    readonly logical: LogicalScheduler;
+    readonly logging?: ClientLogger | undefined;
+    /** HTTP transport, defaulting to the platform fetch */
+    readonly http?: HttpTransport | undefined;
+    /** Scheduling limits and default deadline, defaulting to the built-in limits */
+    readonly settings?: RestConfiguration | undefined;
+    /** Passes a global pause learned from Fluxer to a supervisor's other children, in milliseconds from now */
+    readonly shareGlobalPause?: ((waitMs: number) => void) | undefined;
+}
+/** Mutable state shared by one owner's operations, attempts and downloads */
+export declare class RestRuntime<M extends MessageCore> {
+    #private;
+    /** Set by stop. No operation starts or continues its request after closure */
+    closed: boolean;
+    /** The owner's resolved instance, kept after the first successful discovery */
+    instance: InstanceEndpointContext | undefined;
+    /** Attachment file bytes reserved by running operations */
+    uploadBytes: number;
+    /** Stream cleanup failures that no caller observed, surfaced by shutdown */
+    readonly unobservedDownloadDefects: UnobservedDownloadDefects;
+    readonly controllers: Set<AbortController>;
+    readonly downloads: Set<AttachmentDownloadSource>;
+    /** Completion signals for every running operation, awaited by shutdown */
+    readonly operations: Set<Deferred.Deferred<void, never>>;
+    readonly admission: RestAdmission;
+    readonly http: HttpTransport;
+    /** Scheduling limits and the default deadline for operations and downloads that omit timeoutMs */
+    readonly settings: RestConfiguration;
+    readonly cache: MessageCache<M> | undefined;
+    readonly resources: GuildCache | undefined;
+    readonly channels: ChannelCache | undefined;
+    readonly users: UserCache | undefined;
+    readonly logical: LogicalScheduler;
+    readonly logging: ClientLogger | undefined;
+    readonly resolveInstance: () => Effect.Effect<InstanceEndpointContext, unknown>;
+    /**
+     * Logical time of the last ratelimit.deadline Warn for requests refused before dispatch, per route template.
+     * Each new Warn first removes entries older than busyWarnIntervalMs, which no longer hold back a Warn, so the map
+     * holds only routes warned within one interval of the latest Warn
+     */
+    readonly deadlineWarnedAt: Map<string, number>;
+    constructor(options: RestOwnerOptions<M>);
+    /**
+     * Count a request that failed with busy, and warn at most once a minute that a REST budget is full, naming the full
+     * budget. Busy failures are returned to the caller, so the Warn exists only to make a saturated client visible
+     */
+    busy(budget: "queue" | "uploads"): void;
+}
+/** One client's transient REST scheduler, without shared-token coordination or durable delivery */
+export declare class RestOwner<M extends MessageCore = Message> {
+    #private;
+    constructor(options: RestOwnerOptions<M>);
+    /** The client's default operation deadline in milliseconds, from rest.defaultTimeoutMs */
+    get defaultTimeoutMs(): number;
+    /** Size the default API request slots for the client's local shard count */
+    scaleConcurrency(localShards: number): void;
+    /** Apply a global pause another process learned, lasting waitMs from now, without sharing it again */
+    pauseGlobal(waitMs: number): void;
+    /** Completion signals of the operations and downloads running now, queued ones included, for a draining shutdown */
+    inFlight(): readonly Deferred.Deferred<void>[];
+    diagnostics(): {
+        activeRequests: number;
+        activeCapacity: number;
+        queuedRequests: number;
+        queuedCapacity: number;
+        queuedJsonBytes: number;
+        queuedJsonByteCapacity: number;
+        reservedUploadBytes: number;
+        uploadByteCapacity: number;
+    };
+    refreshAttachmentUrls(token: Redacted.Redacted<string>, urls: readonly string[], options?: AttachmentRefreshOptions): Effect.Effect<readonly RefreshedAttachmentUrl[], AttachmentRefreshFailure>;
+    openDownload(attachment: Attachment, options?: AttachmentDownloadOptions): Effect.Effect<AttachmentDownloadSource, AttachmentDownloadFailure>;
+    download(attachment: Attachment, options?: AttachmentDownloadOptions): Effect.Effect<Uint8Array, AttachmentDownloadFailure>;
+    reply(token: Redacted.Redacted<string>, target: MessageReference, input: MessageInput | string, options?: SendOptions): Effect.Effect<M, SendError, never>;
+    send(token: Redacted.Redacted<string>, channel: string, input: MessageInput | string, options?: SendOptions, directMessageUser?: string): Effect.Effect<M, SendError>;
+    forward(token: Redacted.Redacted<string>, channel: string, input: ForwardMessageInput, options?: SendOptions): Effect.Effect<M, SendError, never>;
+    fetch(token: Redacted.Redacted<string>, target: MessageReference, options?: MessageOperationOptions): Effect.Effect<M, MessageOperationFailure, never>;
+    publish(token: Redacted.Redacted<string>, target: MessageReference, options?: MessageOperationOptions): Effect.Effect<M, MessageOperationFailure, never>;
+    fetchCrosspostSource(token: Redacted.Redacted<string>, target: MessageReference, options?: MessageOperationOptions): Effect.Effect<import("#sdk/messages").CrosspostSource, MessageOperationFailure, never>;
+    typing(token: Redacted.Redacted<string>, channel: string, options?: MessageOperationOptions): Effect.Effect<void, MessageOperationFailure>;
+    fetchHistory(token: Redacted.Redacted<string>, channel: string, query?: MessageHistoryQuery, options?: MessageOperationOptions): Effect.Effect<readonly M[], MessageOperationFailure>;
+    search(token: Redacted.Redacted<string>, context: MessageSearchContext, query?: MessageSearchQuery, options?: MessageOperationOptions): Effect.Effect<MessageSearchPage<M>, MessageOperationFailure>;
+    edit(token: Redacted.Redacted<string>, target: MessageReference, input: EditMessageInput | string, options?: MessageOperationOptions): Effect.Effect<M, MessageOperationFailure, never>;
+    delete(token: Redacted.Redacted<string>, target: MessageReference, options?: MessageAuditOperationOptions): Effect.Effect<void, MessageOperationFailure, never>;
+    deleteAttachment(token: Redacted.Redacted<string>, target: MessageReference, attachmentId: string, options?: MessageOperationOptions): Effect.Effect<void, MessageOperationFailure>;
+    deleteMany(token: Redacted.Redacted<string>, channelId: string, ids: readonly string[], options?: MessageAuditOperationOptions): Effect.Effect<void, MessageOperationFailure>;
+    deleteOwnMessages(token: Redacted.Redacted<string>, channelId: string, options?: MessageOperationOptions): Effect.Effect<void, MessageOperationFailure>;
+    fetchReactionUsers(token: Redacted.Redacted<string>, target: MessageReference, emoji: ReactionEmojiInput, query?: ReactionUsersQuery, options?: MessageOperationOptions): Effect.Effect<ReactionUsersPage, MessageOperationFailure>;
+    fetchPins(token: Redacted.Redacted<string>, channel: string, query?: MessagePinsQuery, options?: MessageOperationOptions): Effect.Effect<MessagePinsPage<M>, MessageOperationFailure>;
+    pin(token: Redacted.Redacted<string>, operation: "pin" | "unpin", target: MessageReference, options?: MessageAuditOperationOptions): Effect.Effect<void, MessageOperationFailure>;
+    reaction(token: Redacted.Redacted<string>, operation: "addReaction" | "removeReaction" | "removeUserReaction" | "clearReaction" | "clearReactions", target: MessageReference, emoji: ReactionEmojiInput | undefined, options?: MessageOperationOptions, userId?: string): Effect.Effect<void, MessageOperationFailure>;
+    guild<A>(token: Redacted.Redacted<string>, operation: GuildOperation, build: () => GuildRequest<A> | InputValidationFailure, options?: GuildOperationOptions): Effect.Effect<A, ClientClosedError | GuildOperationError, never>;
+    channel<A>(token: Redacted.Redacted<string>, operation: ChannelOperation, build: () => ChannelRequest<A> | InputValidationFailure, options?: ChannelOperationOptions): Effect.Effect<A, ChannelOperationError | ClientClosedError, never>;
+    user<A>(token: Redacted.Redacted<string>, operation: UserOperation, build: () => UserRequest<A> | InputValidationFailure, options?: UserOperationOptions): Effect.Effect<A, ClientClosedError | UserOperationError, never>;
+    application<A>(token: Redacted.Redacted<string>, operation: BotApplicationOperation, build: () => BotApplicationRequest<A>, options?: BotApplicationOperationOptions): Effect.Effect<A, BotApplicationOperationError | ClientClosedError, never>;
+    webhook<A>(token: Redacted.Redacted<string>, operation: WebhookOperation, build: () => WebhookRequest<A> | InputValidationFailure, options?: WebhookOperationOptions): Effect.Effect<A, ClientClosedError | WebhookOperationError, never>;
+    /**
+     * Send one caller-described request through the same discovery, admission, rate-limit learning, 429 waits,
+     * deadline, logging and retry rules as wrapped operations, without message or resource cache coordination.
+     * Files are always sent inline as multipart, never through presigned uploads, because the route is unknown
+     */
+    request<T>(token: Redacted.Redacted<string>, input: RestRequest | DefaultRestRequest): Effect.Effect<RestResponse<T>, RestRequestFailure>;
+    /** Close admission and abort every request and download without waiting */
+    stop(): void;
+    /** Stop, then wait for every running operation and surface unobserved stream cleanup failures */
+    shutdown(): Effect.Effect<void>;
+}
+//# sourceMappingURL=owner.d.ts.map

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

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