@neontechspace/fluxerly 1000.0.0-nightly.12

package/dist/internal/channel-cache.js

@@ -0,0 +1,413 @@
+/**
+ * Optional channel cache: ID-keyed guild-channel and thread observations with client-wide limits and in-flight guards.
+ * Invariant: The cache never decides effective permissions. Dispatched mutations invalidate channel snapshots and pending channel
+ * reads because category and ordering changes can affect descendants, and a rejected multi-entry reorder does not establish
+ * rollback. A mutation confined to one thread invalidates only that thread, which has no descendants or sibling order.
+ * Bulk gateway observations invalidate their guild rather than keeping permissions Fluxer may still be copying, and
+ * create or delete events can be visibility changes, not proof of remote creation or deletion. A deleted or hidden channel
+ * takes its cached threads, because Fluxer sends no thread deletion for them, and a full channel list never removes
+ * threads, which it does not include. Every applied store, removal and whole-cache clear is recorded to the client's change
+ * hub, a replacement counting as one store. Implements [SDK contracts: Delivery, requests and caches](/docs/SDK-CONTRACTS.md#delivery-requests-and-caches)
+ */
+import { isDeepStrictEqual } from "node:util";
+import { isThreadChannel } from "#sdk/channels";
+import { ExpiryQueue, ExpiryTimer } from "./expiry-queue.js";
+import { retentionAge } from "./retention-age.js";
+import { decodeGuildChannels } from "./channel-decode.js";
+import { identifier, record } from "./decode/primitives.js";
+import { decodeSnapshotThreads, threadParentTypes } from "./thread-events.js";
+import { cacheStats, readStats } from "./cache.js";
+const categoryType = 4;
+const selection = (request) => ({
+    ...(request.channelId === undefined ? {} : { channelId: request.channelId }),
+    ...(request.guildId === undefined ? {} : { guildId: request.guildId }),
+});
+const overlaps = (left, right) => {
+    if (left.channelId !== undefined && right.channelId !== undefined)
+        return left.channelId === right.channelId;
+    if (left.guildId !== undefined && right.guildId !== undefined)
+        return left.guildId === right.guildId;
+    // An ID-only route cannot prove that it belongs to a different guild
+    return true;
+};
+const matches = (request, channel) => (request.channelId === undefined || request.channelId === channel.id) &&
+    (request.guildId === undefined || request.guildId === channel.guildId);
+const notThread = (channel) => !isThreadChannel(channel);
+/** One client's bounded guild-channel observations and in-flight guards, never a guild inventory or permission authority */
+export class ChannelCache {
+    settings;
+    now;
+    changes;
+    report;
+    #entries = new Map();
+    #requests = new Set();
+    #bytes = 0;
+    #generation = 0;
+    #closed = false;
+    #stats = cacheStats();
+    #expiry = new ExpiryQueue((entry) => this.#entries.get(entry.value.id) === entry);
+    #timer;
+    constructor(settings, now, logical, changes, report = () => undefined) {
+        this.settings = settings;
+        this.now = now;
+        this.changes = changes;
+        this.report = report;
+        this.#timer = new ExpiryTimer("channel cache", now, () => {
+            this.#purge();
+            this.#schedule();
+        }, logical);
+    }
+    get(channelId) {
+        const entry = this.#peek(channelId);
+        if (!entry) {
+            this.#stats.misses++;
+            return undefined;
+        }
+        this.#stats.hits++;
+        this.#entries.delete(channelId);
+        this.#entries.set(channelId, entry);
+        return entry.value;
+    }
+    /** Whether an unexpired observation of this channel is retained, without making it less likely to be removed */
+    holds(channelId) {
+        return this.#peek(channelId) !== undefined;
+    }
+    diagnostics() {
+        this.#purge();
+        this.#schedule();
+        return {
+            configured: true,
+            retainedEntries: this.#entries.size,
+            accountedBytes: this.#bytes,
+            maxEntries: this.settings.maxEntries,
+            maxBytes: this.settings.maxBytes,
+            ...readStats(this.#stats),
+        };
+    }
+    entries(limit) {
+        this.#purge();
+        this.#schedule();
+        const entries = [];
+        for (const entry of this.#entries.values()) {
+            entries.push(entry.value);
+            if (entries.length === limit)
+                break;
+        }
+        return Object.freeze(entries);
+    }
+    /** Release all retained channels and invalidate requests that could otherwise reintroduce an earlier observation */
+    clear() {
+        if (this.#closed)
+            return;
+        this.gap();
+    }
+    /** Remove one channel and invalidate overlapping requests, including ID-only routes that could belong to it */
+    delete(channelId) {
+        if (this.#closed)
+            return;
+        this.#evict({ channelId });
+        this.#schedule();
+    }
+    begin(request) {
+        const guard = {
+            ...request,
+            generation: this.#generation,
+            invalid: false,
+            gapped: false,
+            success: false,
+        };
+        for (const other of this.#requests) {
+            if (!overlaps(guard, other))
+                continue;
+            if (guard.mutation)
+                other.invalid = true;
+            if (other.mutation)
+                guard.invalid = true;
+        }
+        this.#requests.add(guard);
+        return guard;
+    }
+    complete(guard, result) {
+        guard.success = true;
+        if (this.#closed)
+            return;
+        if (guard.mutation) {
+            this.#mutated(guard);
+            return;
+        }
+        if (guard.generation !== this.#generation || guard.gapped)
+            return;
+        // Request decoders own the result shape and freezing. Void responses never fabricate a snapshot
+        const values = result === undefined
+            ? []
+            : Array.isArray(result)
+                ? result
+                : [result];
+        // Only a conflict-free full guild list can prove absence. CHANNEL_UPDATE_BULK is never passed as replace. Fluxer
+        // never lists threads with a guild's channels, so the list proves nothing about them
+        if (guard.replace && !guard.invalid)
+            this.#evict(selection(guard), guard, notThread);
+        for (const value of values) {
+            if (guard.invalid) {
+                const entry = this.#peek(value.id);
+                if (entry && !isDeepStrictEqual(entry.value, value))
+                    this.#evict({ channelId: value.id, guildId: value.guildId }, guard);
+            }
+            else
+                this.#observe(value, guard);
+        }
+        this.#schedule();
+    }
+    missing(guard) {
+        if (this.#closed || (!guard.mutation && (guard.generation !== this.#generation || guard.gapped)))
+            return;
+        this.#evict(selection(guard), guard);
+        this.#schedule();
+    }
+    end(guard, dispatched) {
+        // A dispatched write can partially apply a category subtree or ordering before a later rejection. Do not let an
+        // ID-only route retain unrelated stale channels. This deliberately clears only this channel cache and its guards
+        if (!guard.success && guard.mutation && dispatched && !this.#closed)
+            this.#mutated(guard);
+        this.#requests.delete(guard);
+    }
+    event(event, value) {
+        if (this.#closed)
+            return;
+        if (event === "guildChannelUpdateBulk") {
+            // Gateway bulk lists are visibility-trimmed and reordered before permission copying, never a full snapshot
+            this.#evict({ guildId: value.guildId });
+        }
+        else if (event === "guildChannelCreate" || event === "guildChannelUpdate" || event === "guildChannelDelete") {
+            const channel = value;
+            // A category can change its children's parentage and order. Its own observation is insufficient to retain
+            // the rest of the guild, so evict every affected channel rather than caching a partial reconciliation
+            if (channel.type === categoryType && event !== "guildChannelCreate")
+                this.#evict({ guildId: channel.guildId });
+            else if (event === "guildChannelDelete") {
+                this.#evict({ channelId: channel.id, guildId: channel.guildId });
+                // A deleted or hidden parent takes its threads, and Fluxer sends no THREAD_DELETE for them. The guild-wide
+                // request also stops ID-only reads in flight, which can name one of those threads
+                if (threadParentTypes.has(channel.type))
+                    this.#evict({ guildId: channel.guildId }, undefined, (candidate) => isThreadChannel(candidate) && candidate.parentId === channel.id);
+            }
+            else
+                this.#observe(channel);
+        }
+        else if (event === "threadCreate") {
+            // isNewlyCreated describes the event, not the thread
+            const { isNewlyCreated: _isNewlyCreated, ...thread } = value;
+            this.#observe(Object.freeze(thread));
+        }
+        else if (event === "threadUpdate")
+            this.#observe(value);
+        else if (event === "threadDelete") {
+            const deletion = value;
+            this.#evict({ channelId: deletion.id, guildId: deletion.guildId });
+        }
+        else if (event === "threadListSync") {
+            const sync = value;
+            const parents = sync.parentIds === undefined ? undefined : new Set(sync.parentIds);
+            this.#evict({ guildId: sync.guildId }, undefined, (candidate) => isThreadChannel(candidate) && (parents === undefined || parents.has(candidate.parentId)));
+            for (const thread of sync.threads)
+                this.#observe(thread);
+        }
+        this.#schedule();
+    }
+    /** Evict one thread, such as one whose cached membership of the bot is no longer current. An unknown guild matches any */
+    evictThread(threadId, guildId) {
+        if (this.#closed)
+            return;
+        this.#evict(guildId === undefined ? { channelId: threadId } : { channelId: threadId, guildId });
+        this.#schedule();
+    }
+    /**
+     * Evict the cached threads of the affected guilds once a shard resumed. Fluxer does not replay THREAD_LIST_SYNC,
+     * so a thread observed before the Resume completed may no longer be visible. Reads in flight for those guilds, and
+     * ID-only reads, which can name a thread, cannot store an answer that may predate the Resume
+     */
+    dropThreads(affects) {
+        if (this.#closed)
+            return;
+        for (const guard of this.#requests)
+            if (guard.guildId === undefined || affects(guard.guildId))
+                guard.invalid = true;
+        for (const entry of this.#entries.values())
+            if (isThreadChannel(entry.value) && affects(entry.value.guildId))
+                this.#remove(entry);
+        this.#schedule();
+    }
+    /**
+     * Apply a raw guild lifecycle body. GUILD_CREATE replaces the guild's channels and threads, decoding its threads one
+     * at a time, and the field paths of the threads it left out as malformed are returned for the caller to log
+     */
+    guildEvent(event, value) {
+        if (this.#closed)
+            return [];
+        if (!record(value) || !identifier(value.id)) {
+            this.gap();
+            return [];
+        }
+        let skipped = [];
+        // Removal or lost guild visibility invalidates observations but does not establish physical deletion
+        if (event === "GUILD_DELETE")
+            this.#evict({ guildId: value.id });
+        else if (event === "GUILD_CREATE") {
+            // The snapshot lists every channel and active thread the bot can view, so it replaces this guild's channels
+            // and threads. An unavailable guild or a malformed channel list leaves no channels
+            this.#evict({ guildId: value.id });
+            for (const channel of decodeGuildChannels(value.channels, value.id) ?? [])
+                this.#observe(channel);
+            const snapshot = decodeSnapshotThreads(value, value.id);
+            for (const thread of snapshot.threads)
+                this.#observe(thread);
+            skipped = snapshot.skipped;
+        }
+        this.#schedule();
+        return skipped;
+    }
+    gap(affects) {
+        if (!affects) {
+            this.#generation++;
+            for (const guard of this.#requests)
+                guard.invalid = true;
+            const held = this.#entries.size > 0;
+            this.#entries.clear();
+            this.#bytes = 0;
+            this.#expiry.clear();
+            if (held && this.changes?.active)
+                this.changes.record("channels", "clear", null);
+        }
+        else {
+            this.pause(affects);
+            for (const entry of this.#entries.values())
+                if (affects(entry.value.guildId))
+                    this.#remove(entry);
+        }
+        this.#schedule();
+    }
+    /**
+     * Keep in-flight reads for the affected guilds from storing their responses after the gateway connection was lost,
+     * while retained channels stay. A successful Resume replays every missed dispatch, which keeps them current
+     */
+    pause(affects) {
+        for (const guard of this.#requests)
+            if (affects(guard.guildId)) {
+                guard.invalid = true;
+                guard.gapped = true;
+            }
+    }
+    close() {
+        this.#closed = true;
+        this.gap();
+        this.#requests.clear();
+    }
+    #peek(channelId) {
+        const entry = this.#entries.get(channelId);
+        if (entry && entry.expires !== null && entry.expires <= this.now()) {
+            this.#remove(entry);
+            this.#stats.evictions.expiry++;
+            return undefined;
+        }
+        return entry;
+    }
+    /** Remove one retained channel, reporting the deletion unless the caller replaces it. Returns whether it was removed */
+    #remove(entry, notify = true) {
+        if (this.#entries.get(entry.value.id) !== entry)
+            return false;
+        this.#entries.delete(entry.value.id);
+        this.#bytes -= entry.bytes;
+        if (notify && this.changes?.active)
+            this.changes.record("channels", "delete", entry.value.id);
+        return true;
+    }
+    #invalidate(request, except) {
+        for (const guard of this.#requests)
+            if (guard !== except && overlaps(request, guard))
+                guard.invalid = true;
+    }
+    /**
+     * Apply a dispatched mutation. One confined to a thread evicts only that thread, and creating a new thread evicts
+     * nothing. Any other can reorder or move category descendants, even when its route names one ID, so it clears every
+     * channel snapshot and invalidates every channel guard, never other resource caches
+     */
+    #mutated(guard) {
+        if (!guard.thread)
+            return this.gap();
+        if (guard.channelId !== undefined)
+            this.#evict(selection(guard), guard);
+        this.#schedule();
+    }
+    /** Remove the retained channels the request selects, narrowed to those that only accepts when it is given */
+    #evict(request, except, only) {
+        this.#invalidate(request, except);
+        const selected = (channel) => matches(request, channel) && (only === undefined || only(channel));
+        if (request.channelId !== undefined) {
+            const entry = this.#entries.get(request.channelId);
+            if (entry && selected(entry.value))
+                this.#remove(entry);
+            return;
+        }
+        for (const entry of this.#entries.values())
+            if (selected(entry.value))
+                this.#remove(entry);
+    }
+    #observe(channel, except) {
+        if (this.#closed)
+            return;
+        this.#invalidate({ channelId: channel.id, guildId: channel.guildId }, except);
+        const resolved = retentionAge(this.settings.maxAgeMs, channel, "channels cache", "snapshot");
+        if (this.#closed)
+            return;
+        const previous = this.#entries.get(channel.id);
+        if ("error" in resolved) {
+            if (previous)
+                this.#remove(previous);
+            this.report(resolved.error);
+            return;
+        }
+        const age = resolved.age;
+        // A replacement reports one set, while an older copy that the new one cannot replace reports a delete
+        const replaced = previous !== undefined && this.#remove(previous, false);
+        const bytes = age === 0
+            ? 0
+            : Buffer.byteLength(JSON.stringify(channel, (_, value) => (typeof value === "bigint" ? value.toString() : value)));
+        if (age === 0 || bytes > this.settings.maxBytes) {
+            if (replaced && this.changes?.active)
+                this.changes.record("channels", "delete", channel.id);
+            return;
+        }
+        this.#purge();
+        while (this.#entries.size >= this.settings.maxEntries || this.#bytes > this.settings.maxBytes - bytes) {
+            this.#remove(this.#entries.values().next().value);
+            this.#stats.evictions.capacity++;
+        }
+        const entry = {
+            value: channel,
+            bytes,
+            expires: age === null ? null : this.now() + age,
+        };
+        this.#entries.set(channel.id, entry);
+        this.#bytes += bytes;
+        if (entry.expires !== null)
+            this.#expiry.push(entry);
+        if (this.changes?.active)
+            this.changes.record("channels", "set", channel.id);
+    }
+    #purge() {
+        this.#expiry.purge(this.now(), (entry) => {
+            if (this.#remove(entry))
+                this.#stats.evictions.expiry++;
+        });
+    }
+    #schedule() {
+        if (this.#closed) {
+            this.#timer.cancel();
+            this.#expiry.clear();
+            return;
+        }
+        this.#expiry.compact(this.#entries.size);
+        this.#timer.set(this.#expiry.next());
+    }
+}
+//# sourceMappingURL=channel-cache.js.map

package/dist/internal/channel-cache.js.map

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

package/dist/internal/channel-decode.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Guild channel projection: Decoders for REST and gateway channel, thread, thread member and forum tag data, shared by
+ * channel operations, the channel cache, gateway dispatch and the message, search and audit-log projections.
+ * Invariant: Each known ChannelType number decodes into its own frozen shape and any other number into "unknown" with
+ * rawType. A thread needs its parent, owner, name and metadata. Unknown flag bits, enum numbers and tag-setting strings
+ * are kept, and a malformed field rejects the whole payload rather than being dropped.
+ * Implements [SDK contracts: Validation requirements](/docs/SDK-CONTRACTS.md#validation-requirements)
+ */
+import { type ForumDefaultReaction, type ForumTag, type GuildChannel, type GuildThreadChannel, type ThreadMember } from "#sdk/channels";
+export declare const channelEvents: {
+    readonly CHANNEL_CREATE: "guildChannelCreate";
+    readonly CHANNEL_UPDATE: "guildChannelUpdate";
+    readonly CHANNEL_DELETE: "guildChannelDelete";
+    readonly CHANNEL_UPDATE_BULK: "guildChannelUpdateBulk";
+};
+/** An absolute URL. Channel validation shares this rule with decoding */
+export declare function url(value: unknown): value is string;
+/** Decode one forum or media channel tag */
+export declare function decodeForumTag(value: unknown): ForumTag | undefined;
+/** Decode the reaction a forum or media channel suggests on each post */
+export declare function decodeForumDefaultReaction(value: unknown): ForumDefaultReaction | undefined;
+/** Decode a complete guild-channel response, with private channels and malformed payloads returning undefined */
+export declare function decodeGuildChannel(value: unknown): GuildChannel | undefined;
+export declare function decodeGuildChannels(value: unknown, guildId: string): readonly GuildChannel[] | undefined;
+/** Decode only guild-scoped channel events, with private-channel events intentionally returning undefined */
+export declare function decodeChannelEvent(event: keyof typeof channelEvents, value: unknown): Readonly<{
+    guildId: string;
+    channels: readonly GuildChannel[];
+}> | GuildChannel | undefined;
+/** Decode one thread, with any other channel type or a malformed payload returning undefined */
+export declare function decodeThread(value: unknown): GuildThreadChannel | undefined;
+/**
+ * Decode one thread member. The nested guild member needs the thread's guild ID, which thread member payloads do not
+ * carry. A payload without its thread ID takes threadId, and one that has it must match threadId when given. A null
+ * member, which Fluxer sends for a user without a guild membership, leaves member out
+ */
+export declare function decodeThreadMember(value: unknown, guildId: string, threadId?: string): ThreadMember | undefined;
+/**
+ * Decode a thread list together with the bot's memberships that Fluxer lists beside it, folding each membership into
+ * its thread. A duplicate thread, a membership naming no listed thread and a second membership for one thread are
+ * malformed, so the whole list is rejected rather than losing or mixing memberships
+ */
+export declare function decodeThreadList(threads: unknown, members: unknown): readonly GuildThreadChannel[] | undefined;
+//# sourceMappingURL=channel-decode.d.ts.map

package/dist/internal/channel-decode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-decode.d.ts","sourceRoot":"","sources":["../../src/internal/channel-decode.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAGH,KAAK,oBAAoB,EACzB,KAAK,QAAQ,EACb,KAAK,YAAY,EAEjB,KAAK,kBAAkB,EAEvB,KAAK,YAAY,EAEpB,MAAM,eAAe,CAAA;AAYtB,eAAO,MAAM,aAAa;aACtB,cAAc,EAAE,oBAAoB;aACpC,cAAc,EAAE,oBAAoB;aACpC,cAAc,EAAE,oBAAoB;aACpC,mBAAmB,EAAE,wBAAwB;CACvC,CAAA;AAaV,yEAAyE;AACzE,wBAAgB,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CASnD;AAqHD,4CAA4C;AAC5C,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAiBnE;AAED,yEAAyE;AACzE,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,GAAG,SAAS,CAG3F;AAmGD,iHAAiH;AACjH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CAsB3E;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,YAAY,EAAE,GAAG,SAAS,CAWxG;AAED,6GAA6G;AAC7G,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,OAAO,aAAa,EAAE,KAAK,EAAE,OAAO;;;8BAOnF;AAED,gGAAgG;AAChG,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,GAAG,SAAS,CAG3E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAc/G;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,SAAS,kBAAkB,EAAE,GAAG,SAAS,CAmB9G"}