@neontechspace/fluxerly 1000.0.0-nightly.12

package/dist/internal/testing/wait.js

@@ -0,0 +1,55 @@
+/**
+ * Waits for test client controls, such as TestRoute.next and idle.
+ * Invariant: Every wait settles exactly once, by its own condition, its explicit timeout, the caller's abort signal or
+ * test client shutdown, and leaves no timer or listener behind. Without timeoutMs a wait sets no timer, so the test
+ * runner's own timeout bounds a hang.
+ * Implements [SDK contracts: Delivery, requests and caches](/docs/SDK-CONTRACTS.md#delivery-requests-and-caches)
+ */
+// The node:timers functions stay real when a test fakes the global timers, so waits still time out and settle
+import { clearTimeout, setTimeout } from "node:timers";
+import { ConfigurationError } from "#sdk/errors";
+import { TestTimeoutError } from "./errors.js";
+/** Read and check a wait's timeout option, undefined when the wait has no deadline. Misuse throws ConfigurationError */
+export function waitTimeout(options) {
+    if (options !== undefined && (typeof options !== "object" || options === null))
+        throw new ConfigurationError("configuration", "Test wait options must be an object");
+    const timeoutMs = options?.timeoutMs;
+    if (timeoutMs !== undefined && (!Number.isSafeInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 2_147_483_647))
+        throw new ConfigurationError("configuration", "Test wait timeoutMs must be an integer from 1 through 2,147,483,647");
+    return timeoutMs;
+}
+/**
+ * Start a wait and fail it with TestTimeoutError after timeoutMs when one is set, or with the signal's reason when
+ * aborted. The start function receives the settle callback and returns its own cleanup
+ */
+export function timedWait(wait, timeoutMs, signal, start) {
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        let cleanup;
+        const onAbort = () => settle({ error: signal?.reason });
+        const timer = timeoutMs === undefined
+            ? undefined
+            : setTimeout(() => settle({ error: new TestTimeoutError(wait, timeoutMs) }), timeoutMs);
+        function settle(outcome) {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            signal?.removeEventListener("abort", onAbort);
+            cleanup?.();
+            if ("value" in outcome)
+                resolve(outcome.value);
+            else
+                reject(outcome.error);
+        }
+        if (signal?.aborted)
+            return settle({ error: signal.reason });
+        signal?.addEventListener("abort", onAbort, { once: true });
+        const stop = start(settle);
+        if (settled)
+            stop();
+        else
+            cleanup = stop;
+    });
+}
+//# sourceMappingURL=wait.js.map

package/dist/internal/testing/wait.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait.js","sourceRoot":"","sources":["../../../src/internal/testing/wait.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,8GAA8G;AAC9G,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAM9C,wHAAwH;AACxH,MAAM,UAAU,WAAW,CAAC,OAAoC;IAC5D,IAAI,OAAO,KAAK,SAAS,IAAI,CAAC,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,CAAC;QAC1E,MAAM,IAAI,kBAAkB,CAAC,eAAe,EAAE,qCAAqC,CAAC,CAAA;IACxF,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,CAAA;IACpC,IAAI,SAAS,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,IAAI,SAAS,GAAG,aAAa,CAAC;QAC3G,MAAM,IAAI,kBAAkB,CACxB,eAAe,EACf,qEAAqE,CACxE,CAAA;IACL,OAAO,SAAS,CAAA;AACpB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CACrB,IAA8B,EAC9B,SAA6B,EAC7B,MAA+B,EAC/B,KAAgE;IAEhE,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACtC,IAAI,OAAO,GAAG,KAAK,CAAA;QACnB,IAAI,OAAiC,CAAA;QACrC,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;QACvD,MAAM,KAAK,GACP,SAAS,KAAK,SAAS;YACnB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,gBAAgB,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,CAAA;QAC/F,SAAS,MAAM,CAAC,OAAuB;YACnC,IAAI,OAAO;gBAAE,OAAM;YACnB,OAAO,GAAG,IAAI,CAAA;YACd,YAAY,CAAC,KAAK,CAAC,CAAA;YACnB,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;YAC7C,OAAO,EAAE,EAAE,CAAA;YACX,IAAI,OAAO,IAAI,OAAO;gBAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;;gBACzC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QAC9B,CAAC;QACD,IAAI,MAAM,EAAE,OAAO;YAAE,OAAO,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAA;QAC5D,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QAC1D,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAA;QAC1B,IAAI,OAAO;YAAE,IAAI,EAAE,CAAA;;YACd,OAAO,GAAG,IAAI,CAAA;IACvB,CAAC,CAAC,CAAA;AACN,CAAC"}

package/dist/internal/thread-events.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Thread gateway events: Decoders for the THREAD_* dispatches a bot receives and for the threads of a community snapshot.
+ * Invariant: A thread event decodes whole or not at all, like every dispatch. Only a community snapshot's thread list is
+ * decoded entry by entry, so one malformed thread costs only itself and the caller logs each skipped entry.
+ * Payload shapes follow gateway/threads.md and fluxer_gateway guild_thread_dispatch.erl, guild_thread_view.erl and
+ * fluxer_api ThreadDispatch.ts at fluxerapp/fluxer commit 4749eb7f866ceba0c9622014a9824900d5be8172.
+ * Implements [SDK contracts: Validation requirements](/docs/SDK-CONTRACTS.md#validation-requirements)
+ */
+import { type GuildThreadChannel } from "#sdk/channels";
+import type { ThreadCreateEvent, ThreadDeletion, ThreadListSync, ThreadMembersUpdate } from "#sdk/events";
+/**
+ * Channel types that can hold threads. Fluxer deletes such a channel's threads with it and sends no THREAD_DELETE for
+ * them (ChannelOperationsService.deleteChannel and the deleteChannelThreads worker task at the commit above)
+ */
+export declare const threadParentTypes: ReadonlySet<unknown>;
+/** A thread, plus newly_created, which Fluxer sends only as true and only for a thread that was just created */
+export declare function decodeThreadCreate(value: unknown): ThreadCreateEvent | undefined;
+/** A deleted thread's identity, the only fields Fluxer keeps in THREAD_DELETE */
+export declare function decodeThreadDeletion(value: unknown): ThreadDeletion | undefined;
+/** A replaced thread set, with the bot's memberships folded into their threads. channel_ids becomes parentIds */
+export declare function decodeThreadListSync(value: unknown): ThreadListSync | undefined;
+/**
+ * Joined and departed thread members. Fluxer leaves out an empty added_members or removed_member_ids, and adds a
+ * presence to each added member, which is not projected
+ */
+export declare function decodeThreadMembersUpdate(value: unknown): ThreadMembersUpdate | undefined;
+/** The thread whose own membership THREAD_MEMBER_UPDATE reports. The payload is the bot's thread member with guild_id */
+export declare function decodeOwnThreadMemberUpdate(value: unknown): {
+    readonly threadId: string;
+} | undefined;
+/**
+ * Decode the threads of a community snapshot one at a time. Returns the threads in this community and the field path,
+ * such as threads[2], of each entry that is malformed or names another community. A threads value that is present but
+ * not an array skips the whole list, reported as threads
+ */
+export declare function decodeSnapshotThreads(value: Record<string, unknown>, guildId: string): {
+    readonly threads: readonly GuildThreadChannel[];
+    readonly skipped: readonly string[];
+};
+//# sourceMappingURL=thread-events.d.ts.map

package/dist/internal/thread-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-events.d.ts","sourceRoot":"","sources":["../../src/internal/thread-events.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAe,KAAK,kBAAkB,EAAqB,MAAM,eAAe,CAAA;AACvF,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAUzG;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,OAAO,CAKjD,CAAA;AAIF,gHAAgH;AAChH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS,CAKhF;AAED,iFAAiF;AACjF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,SAAS,CAe/E;AAED,iHAAiH;AACjH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,SAAS,CAW/E;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,GAAG,SAAS,CAuBzF;AAED,yHAAyH;AACzH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAIrG;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE,MAAM,GAChB;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAW1F"}

package/dist/internal/thread-events.js

@@ -0,0 +1,121 @@
+/**
+ * Thread gateway events: Decoders for the THREAD_* dispatches a bot receives and for the threads of a community snapshot.
+ * Invariant: A thread event decodes whole or not at all, like every dispatch. Only a community snapshot's thread list is
+ * decoded entry by entry, so one malformed thread costs only itself and the caller logs each skipped entry.
+ * Payload shapes follow gateway/threads.md and fluxer_gateway guild_thread_dispatch.erl, guild_thread_view.erl and
+ * fluxer_api ThreadDispatch.ts at fluxerapp/fluxer commit 4749eb7f866ceba0c9622014a9824900d5be8172.
+ * Implements [SDK contracts: Validation requirements](/docs/SDK-CONTRACTS.md#validation-requirements)
+ */
+import { ChannelType } from "#sdk/channels";
+import { decodeThread, decodeThreadList, decodeThreadMember } from "./channel-decode.js";
+import { count, identifier, record } from "./decode/primitives.js";
+const threadTypes = new Set([
+    ChannelType.AnnouncementThread,
+    ChannelType.PublicThread,
+    ChannelType.PrivateThread,
+]);
+/**
+ * Channel types that can hold threads. Fluxer deletes such a channel's threads with it and sends no THREAD_DELETE for
+ * them (ChannelOperationsService.deleteChannel and the deleteChannelThreads worker task at the commit above)
+ */
+export const threadParentTypes = new Set([
+    ChannelType.Text,
+    ChannelType.Announcement,
+    ChannelType.Forum,
+    ChannelType.Media,
+]);
+const identifiers = (value) => Array.isArray(value) && value.every(identifier);
+/** A thread, plus newly_created, which Fluxer sends only as true and only for a thread that was just created */
+export function decodeThreadCreate(value) {
+    const thread = decodeThread(value);
+    if (!thread || !record(value) || (value.newly_created !== undefined && typeof value.newly_created !== "boolean"))
+        return undefined;
+    return Object.freeze({ ...thread, isNewlyCreated: value.newly_created === true });
+}
+/** A deleted thread's identity, the only fields Fluxer keeps in THREAD_DELETE */
+export function decodeThreadDeletion(value) {
+    if (!record(value) ||
+        !identifier(value.id) ||
+        !identifier(value.guild_id) ||
+        !identifier(value.parent_id) ||
+        !threadTypes.has(value.type))
+        return undefined;
+    return Object.freeze({
+        id: value.id,
+        guildId: value.guild_id,
+        parentId: value.parent_id,
+        type: value.type,
+    });
+}
+/** A replaced thread set, with the bot's memberships folded into their threads. channel_ids becomes parentIds */
+export function decodeThreadListSync(value) {
+    if (!record(value) || !identifier(value.guild_id))
+        return undefined;
+    if (value.channel_ids !== undefined && !identifiers(value.channel_ids))
+        return undefined;
+    const guildId = value.guild_id;
+    const threads = decodeThreadList(value.threads, value.members);
+    if (!threads || threads.some((thread) => thread.guildId !== guildId))
+        return undefined;
+    return Object.freeze({
+        guildId,
+        ...(value.channel_ids === undefined ? {} : { parentIds: Object.freeze([...value.channel_ids]) }),
+        threads,
+    });
+}
+/**
+ * Joined and departed thread members. Fluxer leaves out an empty added_members or removed_member_ids, and adds a
+ * presence to each added member, which is not projected
+ */
+export function decodeThreadMembersUpdate(value) {
+    if (!record(value) ||
+        !identifier(value.id) ||
+        !identifier(value.guild_id) ||
+        !count(value.member_count) ||
+        (value.added_members !== undefined && !Array.isArray(value.added_members)) ||
+        (value.removed_member_ids !== undefined && !identifiers(value.removed_member_ids)))
+        return undefined;
+    const added = [];
+    for (const item of value.added_members ?? []) {
+        const member = decodeThreadMember(item, value.guild_id, value.id);
+        if (!member)
+            return undefined;
+        added.push(member);
+    }
+    return Object.freeze({
+        threadId: value.id,
+        guildId: value.guild_id,
+        memberCount: value.member_count,
+        added: Object.freeze(added),
+        removedUserIds: Object.freeze([...(value.removed_member_ids ?? [])]),
+    });
+}
+/** The thread whose own membership THREAD_MEMBER_UPDATE reports. The payload is the bot's thread member with guild_id */
+export function decodeOwnThreadMemberUpdate(value) {
+    if (!record(value) || !identifier(value.guild_id))
+        return undefined;
+    const member = decodeThreadMember(value, value.guild_id);
+    return member && Object.freeze({ threadId: member.threadId });
+}
+/**
+ * Decode the threads of a community snapshot one at a time. Returns the threads in this community and the field path,
+ * such as threads[2], of each entry that is malformed or names another community. A threads value that is present but
+ * not an array skips the whole list, reported as threads
+ */
+export function decodeSnapshotThreads(value, guildId) {
+    if (value.threads === undefined)
+        return { threads: [], skipped: [] };
+    if (!Array.isArray(value.threads))
+        return { threads: [], skipped: ["threads"] };
+    const threads = [];
+    const skipped = [];
+    value.threads.forEach((item, index) => {
+        const thread = decodeThread(item);
+        if (thread && thread.guildId === guildId)
+            threads.push(thread);
+        else
+            skipped.push(`threads[${index}]`);
+    });
+    return { threads, skipped };
+}
+//# sourceMappingURL=thread-events.js.map

package/dist/internal/thread-events.js.map

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

package/dist/internal/threads.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Thread operations: Request validation and encoding for client.threads, with thread data decoded by
+ * [channel decoding](/projects/sdk/src/internal/channel-decode.ts).
+ * Invariant: Only a request whose result is one thread or the active thread list carries a channel cache hint, so the
+ * channel cache never stores a page or a forum post as a channel. A thread member's community membership is decoded
+ * with the thread's own community, taken from the channel cache or from a thread read, never from caller input.
+ * Implements [SDK contracts: Delivery, requests and caches](/docs/SDK-CONTRACTS.md#delivery-requests-and-caches)
+ */
+import * as Effect from "effect/Effect";
+import { type ChannelOperationFailure, type GuildThreadChannel, type ThreadMember } from "#sdk/channels";
+import { InputValidationFailure } from "#sdk/input-validation";
+import type { MessageCore, MessageReference } from "#sdk/messages";
+import type { ArchivedThreadPage, ArchivedThreadQuery, ForumPost, ForumPostCreate, ThreadCreate, ThreadEdit, ThreadFromMessageCreate, ThreadSearchPage, ThreadSearchQuery } from "#sdk/threads";
+import type { ClientOwner } from "./client.js";
+import { type ChannelRequest } from "./channels.js";
+import type { MessageDecoder } from "./message-fields.js";
+type ThreadValidationResult<A> = ChannelRequest<A> | InputValidationFailure;
+export declare function threadCreate(channelId: string, input: ThreadCreate): ThreadValidationResult<GuildThreadChannel>;
+export declare function threadCreateFromMessage(target: MessageReference, input: ThreadFromMessageCreate): ThreadValidationResult<GuildThreadChannel>;
+export declare function threadPost<M extends MessageCore>(channelId: string, input: ForumPostCreate, decodeMessage: MessageDecoder<M>): ThreadValidationResult<ForumPost<M>>;
+export declare function threadEdit(threadId: string, input: ThreadEdit): ThreadValidationResult<GuildThreadChannel>;
+export declare function threadActive(guildId: string): ThreadValidationResult<readonly GuildThreadChannel[]>;
+export declare function threadArchived(channelId: string, query?: ArchivedThreadQuery): ThreadValidationResult<ArchivedThreadPage>;
+export declare function threadSearch<M extends MessageCore>(channelId: string, query: ThreadSearchQuery | undefined, decodeMessage: MessageDecoder<M>): ThreadValidationResult<ThreadSearchPage<M>>;
+/** Join or leave a thread as the bot, or add or remove another member */
+export declare function threadMembership(threadId: string, userId: string | undefined, method: "PUT" | "DELETE"): ThreadValidationResult<void>;
+/** A validated thread member read. Its request needs the thread's community only when withMember is set */
+interface MemberRead<A> {
+    readonly withMember: boolean;
+    readonly request: (guildId: string | undefined) => ChannelRequest<A>;
+}
+export declare function threadMemberPage(threadId: string, query: unknown): MemberRead<readonly ThreadMember[]> | InputValidationFailure;
+type ThreadOwner = Pick<ClientOwner<MessageCore>, "channel" | "channelCache" | "logical"> & {
+    readonly defaultTimeoutMs?: number;
+};
+/**
+ * Run a thread member read. With withMember, the thread's community comes from the channel cache when the thread is
+ * cached there, otherwise from one thread read, and both requests share the caller's deadline. A pagination
+ * consumption passes resolved to read the community at most once
+ */
+export declare function readThreadMembers<A>(owner: ThreadOwner, operation: "threads.fetchMember" | "threads.fetchMembers", threadId: string, validate: () => MemberRead<A> | InputValidationFailure, options: unknown, resolved?: {
+    guildId?: string;
+}): Effect.Effect<A, ChannelOperationFailure>;
+export declare const fetchThreadMember: (owner: ThreadOwner, threadId: string, userId: string, query: unknown, options: unknown) => Effect.Effect<ThreadMember, ChannelOperationFailure, never>;
+export declare const fetchThreadMembers: (owner: ThreadOwner, threadId: string, query: unknown, options: unknown) => Effect.Effect<readonly ThreadMember[], ChannelOperationFailure, never>;
+export {};
+//# sourceMappingURL=threads.d.ts.map

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

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