@neontechspace/fluxerly 1000.0.0-nightly.12

package/dist/internal/gateway/session.js

@@ -0,0 +1,420 @@
+import * as Cause from "effect/Cause";
+import * as Clock from "effect/Clock";
+import * as Exit from "effect/Exit";
+import * as Deferred from "effect/Deferred";
+import * as Effect from "effect/Effect";
+import { AuthenticationError, ConnectionError, ConnectionTimeoutError, RateLimitError, } from "#sdk/errors";
+import { nowMs } from "../clock.js";
+import { failingFieldPath } from "../decode/trace.js";
+import { TransportError } from "../effect-failures.js";
+import { classifyCloseCode, CloseCode, Opcode, opcodeName, resumePreservingCloseCode } from "../protocol/gateway.js";
+import { defaultSocketFactory, SocketState, } from "../transport/index.js";
+import { commandPacer, commandSender, gatewayCommands } from "./commands.js";
+import { routeDispatch } from "./dispatch-table.js";
+import { decodeFrame, maxGatewayMessageBytes, readDispatchEnvelope, readHello, readReady, } from "./frames.js";
+/** Graceful WebSocket closure budget before the socket is terminated */
+const gracefulCloseMs = 5_000;
+/** Retry metadata is internal, not a promise that arbitrary consumer actions are repeatable */
+export class AttemptFailure {
+    failure;
+    retry;
+    resetSession;
+    end;
+    closeCode;
+    _tag = "AttemptFailure";
+    constructor(failure, retry, resetSession = false, end = "network", 
+    /** WebSocket close code when the attempt ended with a gateway closure */
+    closeCode) {
+        this.failure = failure;
+        this.retry = retry;
+        this.resetSession = resetSession;
+        this.end = end;
+        this.closeCode = closeCode;
+    }
+}
+/** Classify a gateway close through the reviewed close-code table. Unlisted codes enter recovery */
+export function classifyClose(code, resuming) {
+    const outcome = classifyCloseCode(code, resuming);
+    const failure = outcome.failure === "authentication"
+        ? new AuthenticationError()
+        : outcome.failure === "rateLimit"
+            ? new RateLimitError("gateway", null)
+            : new ConnectionError("gateway", outcome.failure, code);
+    return new AttemptFailure(failure, outcome.retry, outcome.resetSession, "closed", code);
+}
+function closeSocket(socket, preserveSession) {
+    return Effect.gen(function* () {
+        if (socket.readyState === SocketState.closed)
+            return;
+        const closed = Effect.callback((resume) => {
+            const onClose = () => resume(Effect.void);
+            socket.once("close", onClose);
+            if (socket.readyState === SocketState.closed)
+                onClose();
+            return Effect.sync(() => socket.off("close", onClose));
+        });
+        yield* Effect.sync(() => {
+            if (socket.readyState === SocketState.connecting)
+                socket.terminate();
+            else
+                socket.close(preserveSession ? resumePreservingCloseCode : CloseCode.normal);
+        }).pipe(Effect.onExit((exit) => exit._tag === "Failure"
+            ? Effect.sync(() => socket.terminate()).pipe(Effect.andThen(closed))
+            : Effect.void));
+        yield* closed.pipe(Effect.timeoutOrElse({
+            duration: gracefulCloseMs,
+            orElse: () => Effect.gen(function* () {
+                socket.terminate();
+                yield* closed;
+            }),
+        }));
+    });
+}
+/** Map a local ws receive rejection to its WebSocket close status, or null for other transport failures */
+function localRejectionStatus(code) {
+    if (code === "WS_ERR_UNSUPPORTED_MESSAGE_LENGTH" || code === "WS_ERR_UNSUPPORTED_DATA_PAYLOAD_LENGTH")
+        return CloseCode.messageTooBig;
+    if (code === "WS_ERR_INVALID_UTF8")
+        return CloseCode.invalidPayload;
+    return null;
+}
+/** Run one session in the calling Effect scope. It fails with the AttemptFailure that ended it and never succeeds */
+export const runGatewaySession = (options) => Effect.scoped(Effect.gen(function* () {
+    const { messageDecoder, url, token, session, timeoutMs, onReady, onLatency, onRecovering, onDispatch, onGuild, presence, counts, memberChunks, shard, identify, onRaw, identifyFields, application, inviteBase = "https://fluxer.gg", observer, sockets = defaultSocketFactory, } = options;
+    const clock = yield* Clock.Clock;
+    const now = () => nowMs(clock);
+    const hello = Deferred.makeUnsafe();
+    const ready = Deferred.makeUnsafe();
+    const ended = Deferred.makeUnsafe();
+    let stopping = false;
+    let receivedHello = false;
+    let receivedReady = false;
+    let pendingHeartbeat;
+    const resuming = session.id !== undefined && session.sequence !== null;
+    const fail = (error) => {
+        if (Deferred.doneUnsafe(ended, Effect.fail(error))) {
+            onLatency(null);
+            if (receivedReady && error.retry)
+                onRecovering();
+        }
+    };
+    const logger = observer?.logger;
+    const shardId = observer?.shardId;
+    /**
+     * End the attempt for invalid data. A server anomaly retries with a new session, which the shard loop bounds.
+     * A local policy, such as binary frames or onMalformedDispatch terminate, ends the shard instead
+     */
+    const protocolFailure = (rejection, retry = true) => {
+        logger?.count("protocolFailures");
+        const details = { detail: rejection.detail };
+        if (rejection.opcode !== undefined)
+            details.opcode = rejection.opcode;
+        if (rejection.dispatch !== undefined)
+            details.dispatch = rejection.dispatch;
+        if (rejection.field !== undefined)
+            details.field = rejection.field;
+        fail(new AttemptFailure(new ConnectionError("gateway", "protocol", null, { details }), retry, retry, "protocol"));
+    };
+    const dispatchContext = { messageDecoder, inviteBase };
+    let frameBytes = 0;
+    const sinks = {
+        emit: (event, value) => onDispatch(event, value, frameBytes),
+        guildCache: onGuild,
+        presence,
+        counts,
+        memberChunks,
+        get bytes() {
+            return frameBytes;
+        },
+    };
+    const socket = yield* Effect.acquireRelease(Effect.sync(() => {
+        const socket = sockets(url, {
+            perMessageDeflate: false,
+            followRedirects: false,
+            maxPayload: maxGatewayMessageBytes,
+        });
+        const send = commandSender({
+            socket,
+            logger,
+            shardId,
+            stopping: () => stopping,
+            failed: ({ error }) => fail(new AttemptFailure(error, true, false, "sendFailed")),
+        });
+        const sentAt = (session.commandSentAt ??= []);
+        if (!resuming)
+            sentAt.length = 0;
+        const pacer = commandPacer({ send, now, logger, shardId, sentAt });
+        const commands = gatewayCommands(send, pacer.send, {
+            token,
+            session,
+            resuming,
+            shard,
+            identify: identifyFields,
+        });
+        const heartbeat = () => {
+            // Server requests must be answered even while a previous ACK is pending
+            pendingHeartbeat ??= now();
+            send(Opcode.heartbeat, session.sequence);
+        };
+        const malformed = (type, body, sequence, decode) => {
+            const field = failingFieldPath(decode, body);
+            if (!observer || observer.onMalformedDispatch === "terminate")
+                return protocolFailure({
+                    detail: "a dispatch did not match the expected shape",
+                    opcode: Opcode.dispatch,
+                    dispatch: type,
+                    ...(field === undefined ? {} : { field }),
+                }, false);
+            observer.logger.count("protocolFailures");
+            observer.logger.drop({ event: "malformed" }, {
+                level: "warn",
+                category: "gateway",
+                code: "gateway.dispatchRejected",
+                message: `Skipped a ${type} dispatch because its data did not match the expected shape${field === undefined ? "" : ` at ${field}`}. Handlers do not receive it, and cache entries it could have changed were cleared`,
+                shardId,
+                fields: { dispatch: type, field: field ?? null, sequence },
+            });
+            observer.invalidate(type, body);
+        };
+        const dispatch = (payload, body, bytes) => {
+            const envelope = readDispatchEnvelope(payload, receivedHello);
+            if (envelope.rejected)
+                return protocolFailure(envelope);
+            const { type, sequence } = envelope;
+            if (type === "READY") {
+                const sessionId = readReady(body, { receivedReady, resuming, shard });
+                if (typeof sessionId !== "string")
+                    return protocolFailure(sessionId);
+                session.id = sessionId;
+                receivedReady = true;
+            }
+            else if (type === "RESUMED") {
+                if (!resuming || receivedReady)
+                    return protocolFailure({
+                        detail: "received an unexpected RESUMED",
+                        opcode: Opcode.dispatch,
+                        dispatch: "RESUMED",
+                    });
+                receivedReady = true;
+            }
+            else if (!resuming && !receivedReady)
+                return protocolFailure({
+                    detail: "received a dispatch before READY",
+                    opcode: Opcode.dispatch,
+                    dispatch: type,
+                });
+            if (session.sequence !== null && sequence < session.sequence)
+                return protocolFailure({
+                    detail: "the dispatch sequence went backwards",
+                    opcode: Opcode.dispatch,
+                    dispatch: type,
+                    field: "s",
+                });
+            session.sequence = sequence;
+            onRaw?.(type, sequence, body, bytes);
+            if (logger?.enabled("debug", "gateway"))
+                logger.log({
+                    level: "debug",
+                    category: "gateway",
+                    code: "gateway.dispatch",
+                    message: `Received ${type}`,
+                    shardId,
+                    fields: { dispatch: type, sequence, bytes },
+                });
+            if (type === "READY" || type === "RESUMED") {
+                Deferred.doneUnsafe(ready, Effect.void);
+                return;
+            }
+            frameBytes = bytes;
+            const result = routeDispatch(type, body, dispatchContext, sinks);
+            if (result.kind === "malformed")
+                malformed(type, body, sequence, result.decode);
+            else if (result.kind === "unknown")
+                logger?.drop("unknownDispatches", {
+                    level: "debug",
+                    category: "gateway",
+                    code: "gateway.unknownDispatch",
+                    message: `Ignored dispatch type ${type}, which this SDK version does not handle`,
+                    shardId,
+                    fields: { dispatch: type },
+                });
+        };
+        const processMessage = (data, binary) => {
+            if (stopping)
+                return;
+            const frame = decodeFrame(data, binary);
+            // A binary frame is refused by local policy, so reconnecting would receive it again
+            if (frame.rejected)
+                return protocolFailure(frame, !binary);
+            const { op, body, bytes, payload } = frame;
+            if (logger?.enabled("trace", "gateway"))
+                logger.log({
+                    level: "trace",
+                    category: "gateway",
+                    code: "gateway.receive",
+                    message: `Received opcode ${op} (${opcodeName(op) ?? "UNKNOWN"})`,
+                    shardId,
+                    fields: { opcode: op, bytes },
+                });
+            logger?.payload("gateway", "gateway.payloadReceived", `Received opcode ${op} payload`, payload, {
+                shardId,
+            });
+            switch (op) {
+                case Opcode.hello: {
+                    const interval = readHello(body, receivedHello);
+                    if (typeof interval !== "number")
+                        return protocolFailure(interval);
+                    receivedHello = true;
+                    Deferred.doneUnsafe(hello, Effect.succeed(interval));
+                    break;
+                }
+                case Opcode.dispatch:
+                    dispatch(payload, body, bytes);
+                    break;
+                case Opcode.heartbeat:
+                    heartbeat();
+                    break;
+                case Opcode.heartbeatAck:
+                    if (pendingHeartbeat !== undefined) {
+                        const latency = Math.max(0, now() - pendingHeartbeat);
+                        onLatency(latency);
+                        pendingHeartbeat = undefined;
+                        if (logger?.enabled("trace", "gateway"))
+                            logger.log({
+                                level: "trace",
+                                category: "gateway",
+                                code: "gateway.heartbeatAck",
+                                message: "Heartbeat acknowledged",
+                                shardId,
+                                durationMs: latency,
+                            });
+                    }
+                    break;
+                case Opcode.reconnect:
+                    fail(new AttemptFailure(new ConnectionError("gateway", "closed", null, {
+                        details: { detail: "the gateway requested a reconnect" },
+                    }), true, false, "reconnectRequested"));
+                    break;
+                case Opcode.invalidSession:
+                    // Fluxer never sends d: true (opcodes-and-close-codes.md in fluxerapp/fluxer fluxer_docs)
+                    if (body !== false)
+                        return protocolFailure({
+                            detail: "received INVALID_SESSION with a resumable flag this SDK does not support",
+                            opcode: Opcode.invalidSession,
+                            field: "d",
+                        }, false);
+                    fail(new AttemptFailure(new ConnectionError("gateway", "closed", null, {
+                        details: { detail: "the gateway invalidated the session" },
+                    }), true, true, "invalidSession"));
+                    break;
+                default:
+                    // Unknown server opcodes do not force a reconnect
+                    logger?.drop("unknownOpcodes", {
+                        level: "debug",
+                        category: "gateway",
+                        code: "gateway.unknownOpcode",
+                        message: `Ignored opcode ${op}, which this SDK version does not handle`,
+                        shardId,
+                        fields: { opcode: op },
+                    });
+            }
+        };
+        const onMessage = (data, binary) => {
+            try {
+                processMessage(data, binary);
+            }
+            catch (defect) {
+                Deferred.doneUnsafe(ended, Effect.die(defect));
+            }
+        };
+        const onError = (error) => {
+            if (stopping)
+                return;
+            const status = localRejectionStatus(error.code);
+            const transportCode = typeof error.code === "string" && /^[A-Z0-9_]{1,64}$/.test(error.code)
+                ? error.code
+                : undefined;
+            // Retrying a local receive rejection can replay the same rejected message indefinitely
+            fail(new AttemptFailure(new ConnectionError("gateway", status === null ? "network" : "protocol", status, {
+                cause: new TransportError(error, "gateway connection"),
+                details: {
+                    detail: status === null
+                        ? "the WebSocket transport failed"
+                        : "a received frame was rejected locally",
+                    ...(transportCode === undefined ? {} : { transportCode }),
+                },
+            }), status === null, false, status === null ? "network" : "protocol"));
+        };
+        const onClose = (code) => {
+            if (!stopping)
+                fail(classifyClose(code, resuming && !receivedReady));
+        };
+        socket.on("message", onMessage);
+        socket.on("error", onError);
+        socket.on("close", onClose);
+        return {
+            socket,
+            heartbeat,
+            commands,
+            pacer,
+            detach: () => {
+                socket.off("message", onMessage);
+                socket.off("error", onError);
+                socket.off("close", onClose);
+            },
+        };
+    }), (transport, exit) => Effect.gen(function* () {
+        stopping = true;
+        transport.pacer.close();
+        onLatency(null);
+        const retrying = Exit.isFailure(exit) &&
+            exit.cause.reasons.some((reason) => reason._tag === "Fail" &&
+                reason.error instanceof AttemptFailure &&
+                reason.error.retry &&
+                !reason.error.resetSession);
+        const saving = Exit.isFailure(exit) &&
+            Cause.hasInterruptsOnly(exit.cause) &&
+            options.preserveSessionOnInterrupt?.() === true;
+        const preserveSession = session.id !== undefined && session.sequence !== null && (retrying || saving);
+        yield* closeSocket(transport.socket, preserveSession).pipe(Effect.ensuring(Effect.sync(transport.detach)));
+    }));
+    yield* Effect.addFinalizer(() => Effect.sync(() => {
+        application?.detach();
+        presence?.detach();
+        counts?.detach();
+        memberChunks?.detach();
+    }));
+    const { commands, pacer } = socket;
+    yield* Effect.forkScoped(pacer.run);
+    const startup = Effect.gen(function* () {
+        const interval = yield* Deferred.await(hello);
+        yield* Effect.forkScoped(Effect.forever(Effect.gen(function* () {
+            yield* Effect.sleep(interval);
+            if (pendingHeartbeat !== undefined && now() - pendingHeartbeat >= interval) {
+                fail(new AttemptFailure(new ConnectionError("gateway", "network", null, {
+                    details: { detail: "the heartbeat acknowledgement timed out" },
+                }), true, false, "heartbeatTimeout"));
+            }
+            else if (pendingHeartbeat === undefined)
+                socket.heartbeat();
+        })));
+        yield* !resuming && identify ? identify(commands.authenticate) : Effect.sync(commands.authenticate);
+        yield* Deferred.await(ready);
+    }).pipe(Effect.withSpan("fluxerly.gateway.connect", {
+        attributes: {
+            "fluxerly.mode": resuming ? "resume" : "identify",
+            ...(shardId === undefined ? {} : { "fluxerly.shard": shardId }),
+        },
+    }), Effect.timeoutOrElse({
+        duration: timeoutMs,
+        orElse: () => Effect.fail(new AttemptFailure(new ConnectionTimeoutError(timeoutMs), true, false, "timeout")),
+    }));
+    yield* Effect.raceFirst(startup, Deferred.await(ended));
+    presence?.attach(commands.presence, commands.memberSubscriptions, resuming ? "resume" : "identify");
+    counts?.attach(commands.guildCounts, commands.channelMemberCounts);
+    memberChunks?.attach(commands.memberChunks);
+    application?.attach(pacer.submit);
+    onReady(resuming ? "resume" : "identify");
+    return yield* Deferred.await(ended);
+}));
+//# sourceMappingURL=session.js.map

package/dist/internal/gateway/session.js.map

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

package/dist/internal/gateway-requests.d.ts

@@ -0,0 +1,10 @@
+/** Shared local admission for count and member requests, not a claim about Fluxer's other bounded-command workers */
+export declare class GatewayRequestBudget {
+    #private;
+    diagnostics(): {
+        activeRequests: number;
+        activeCapacity: number;
+    };
+    acquire(): (() => void) | undefined;
+}
+//# sourceMappingURL=gateway-requests.d.ts.map

package/dist/internal/gateway-requests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-requests.d.ts","sourceRoot":"","sources":["../../src/internal/gateway-requests.ts"],"names":[],"mappings":"AAOA,qHAAqH;AACrH,qBAAa,oBAAoB;;IAG7B,WAAW;;;MAEV;IAED,OAAO,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CASlC;CACJ"}

package/dist/internal/gateway-requests.js

@@ -0,0 +1,26 @@
+/**
+ * Gateway request admission shared by count and member-chunk requests.
+ * Invariant: The limit applies to the whole client, not each local shard, and no roster, count or distributed coordinator is kept.
+ * Implements [SDK contracts: Delivery, requests and caches](/docs/SDK-CONTRACTS.md#delivery-requests-and-caches)
+ */
+const activeRequestCapacity = 4;
+/** Shared local admission for count and member requests, not a claim about Fluxer's other bounded-command workers */
+export class GatewayRequestBudget {
+    #active = 0;
+    diagnostics() {
+        return { activeRequests: this.#active, activeCapacity: activeRequestCapacity };
+    }
+    acquire() {
+        if (this.#active === activeRequestCapacity)
+            return undefined;
+        this.#active++;
+        let active = true;
+        return () => {
+            if (!active)
+                return;
+            active = false;
+            this.#active--;
+        };
+    }
+}
+//# sourceMappingURL=gateway-requests.js.map

package/dist/internal/gateway-requests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-requests.js","sourceRoot":"","sources":["../../src/internal/gateway-requests.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,qBAAqB,GAAG,CAAC,CAAA;AAE/B,qHAAqH;AACrH,MAAM,OAAO,oBAAoB;IAC7B,OAAO,GAAG,CAAC,CAAA;IAEX,WAAW;QACP,OAAO,EAAE,cAAc,EAAE,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,CAAA;IAClF,CAAC;IAED,OAAO;QACH,IAAI,IAAI,CAAC,OAAO,KAAK,qBAAqB;YAAE,OAAO,SAAS,CAAA;QAC5D,IAAI,CAAC,OAAO,EAAE,CAAA;QACd,IAAI,MAAM,GAAG,IAAI,CAAA;QACjB,OAAO,GAAG,EAAE;YACR,IAAI,CAAC,MAAM;gBAAE,OAAM;YACnB,MAAM,GAAG,KAAK,CAAA;YACd,IAAI,CAAC,OAAO,EAAE,CAAA;QAClB,CAAC,CAAA;IACL,CAAC;CACJ"}

package/dist/internal/gateway.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Gateway module entry: The per-shard protocol-v1 session the client's recovery loop runs, split into
+ * [session](/projects/sdk/src/internal/gateway/session.ts), [frames](/projects/sdk/src/internal/gateway/frames.ts),
+ * [dispatch table](/projects/sdk/src/internal/gateway/dispatch-table.ts) and
+ * [commands](/projects/sdk/src/internal/gateway/commands.ts).
+ * Invariant: Code outside the gateway reaches it only through this entry. Implements
+ * [SDK contracts: Connection and recovery](/docs/SDK-CONTRACTS.md#connection-and-recovery)
+ */
+import type { Message } from "#sdk/messages";
+import { type GatewaySessionOptions } from "./gateway/session.js";
+export { AttemptFailure, classifyClose, runGatewaySession, type Session } from "./gateway/session.js";
+/**
+ * Full-message gateway entry for independent internal protocol checks.
+ * The supervisor test worker imports it from the built SDK, which lint cannot see before the build
+ *
+ * @public
+ */
+export declare const runGateway: (options: Omit<GatewaySessionOptions<Message>, "messageDecoder">) => import("effect/Effect").Effect<never, import("./gateway/session.js").AttemptFailure, never>;
+//# sourceMappingURL=gateway.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../../src/internal/gateway.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAE5C,OAAO,EAAqB,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAEpF,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,iBAAiB,EAAE,KAAK,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAErG;;;;;GAKG;AACH,eAAO,MAAM,UAAU,YAAa,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC,gGACtB,CAAA"}

package/dist/internal/gateway.js

@@ -0,0 +1,11 @@
+import { decodeMessage } from "./message.js";
+import { runGatewaySession } from "./gateway/session.js";
+export { AttemptFailure, classifyClose, runGatewaySession } from "./gateway/session.js";
+/**
+ * Full-message gateway entry for independent internal protocol checks.
+ * The supervisor test worker imports it from the built SDK, which lint cannot see before the build
+ *
+ * @public
+ */
+export const runGateway = (options) => runGatewaySession({ ...options, messageDecoder: decodeMessage });
+//# sourceMappingURL=gateway.js.map

package/dist/internal/gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.js","sourceRoot":"","sources":["../../src/internal/gateway.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,iBAAiB,EAA8B,MAAM,sBAAsB,CAAA;AAEpF,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,iBAAiB,EAAgB,MAAM,sBAAsB,CAAA;AAErG;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAA+D,EAAE,EAAE,CAC1F,iBAAiB,CAAC,EAAE,GAAG,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC,CAAA"}

package/dist/internal/guild-cache.d.ts

@@ -0,0 +1,69 @@
+import type { CacheDiagnostic } from "#sdk/client";
+import type { Guild, GuildMember, GuildRole } from "#sdk/guilds";
+import type { GuildEmoji, GuildSticker } from "#sdk/expressions";
+import type { EventMap, EventName } from "#sdk/events";
+import type { ResourceCacheSettings } from "#sdk/cache";
+import type { LogicalScheduler } from "./logical-scheduler.js";
+import type { CacheChangeHub } from "./cache-changes.js";
+export type ResourceKind = "guilds" | "members" | "roles" | "emojis" | "stickers";
+export type Resources = {
+    guilds: Guild;
+    members: GuildMember;
+    roles: GuildRole;
+    emojis: GuildEmoji;
+    stickers: GuildSticker;
+};
+export type ResourceConfiguration = Partial<Record<ResourceKind, Required<ResourceCacheSettings>>>;
+type Selection = {
+    kind: ResourceKind;
+    guildId: string;
+    id?: string;
+};
+export type ResourceRequest = {
+    selection: Selection;
+    mutation?: boolean;
+    replace?: boolean;
+    members?: boolean;
+    batch?: boolean;
+    wholeGuild?: boolean;
+};
+export type ResourceGuard = ResourceRequest & {
+    generation: number;
+    invalid: boolean;
+    /** A scoped gateway gap made this read stale, so it must not evict a newer post-gap observation */
+    gapped: boolean;
+    success: boolean;
+};
+/** One client's resource observations. REST owns bounded request admission and this owner retains no historical tombstones */
+export declare class GuildCache {
+    #private;
+    private readonly settings;
+    private readonly now;
+    readonly changes?: CacheChangeHub | undefined;
+    private readonly report;
+    constructor(settings: ResourceConfiguration, now: () => number, logical?: LogicalScheduler, changes?: CacheChangeHub | undefined, report?: (error: unknown) => void);
+    get<K extends ResourceKind>(kind: K, guildId: string, id?: string): Resources[K] | undefined;
+    diagnostics(kind: ResourceKind): CacheDiagnostic;
+    entries<K extends ResourceKind>(kind: K, limit: number): readonly Resources[K][];
+    /** Release all retained resource observations and prevent earlier reads from restoring them */
+    clear(): void;
+    /** Release one kind's observations and prevent earlier reads of that kind from restoring them */
+    clearKind(kind: ResourceKind): void;
+    /** Remove one observation and prevent overlapping earlier reads from restoring it */
+    delete(kind: ResourceKind, guildId: string, id: string): void;
+    begin(request: ResourceRequest): ResourceGuard;
+    complete(guard: ResourceGuard, result: unknown): void;
+    missing(guard: ResourceGuard): void;
+    end(guard: ResourceGuard, uncertain: boolean): void;
+    event(event: EventName, value: EventMap[EventName]): void;
+    guildEvent(event: string, value: unknown): void;
+    gap(affects?: (guildId: string | null | undefined) => boolean): void;
+    /**
+     * Keep in-flight reads for the affected guilds from storing their responses after the gateway connection was lost,
+     * while retained entries stay. A successful Resume replays every missed dispatch, which keeps those entries current
+     */
+    pause(affects: (guildId: string | null | undefined) => boolean): void;
+    close(): void;
+}
+export {};
+//# sourceMappingURL=guild-cache.d.ts.map

package/dist/internal/guild-cache.d.ts.map

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