@neontechspace/fluxerly 1000.0.0-nightly.12

package/dist/internal/users.js

@@ -0,0 +1,333 @@
+import { decodeMessage } from "./message.js";
+import { identifier, record, safeInteger as integer } from "./decode/primitives.js";
+import { InputValidationFailure, inputValidationFailure, unsupportedKeyFailure } from "#sdk/input-validation";
+import { channelName, normalizedText } from "./field-text.js";
+const nullableText = (value) => value === null || typeof value === "string";
+const text = (value, min, max) => 
+// oxlint-disable-next-line typescript/no-misused-spread -- length limits count Unicode code points
+typeof value === "string" && [...value].length >= min && [...value].length <= max;
+/** Public-field allowlist, shared by explicit reads and complete user observations */
+export function decodeUser(value) {
+    if (!record(value) ||
+        !identifier(value.id) ||
+        typeof value.username !== "string" ||
+        typeof value.discriminator !== "string" ||
+        !nullableText(value.global_name) ||
+        !nullableText(value.avatar) ||
+        !(value.avatar_color === null || integer(value.avatar_color)) ||
+        !integer(value.flags) ||
+        (value.bot !== undefined && typeof value.bot !== "boolean") ||
+        (value.system !== undefined && typeof value.system !== "boolean"))
+        return undefined;
+    return Object.freeze({
+        id: value.id,
+        username: value.username,
+        discriminator: value.discriminator,
+        displayName: value.global_name,
+        avatar: value.avatar,
+        avatarColor: value.avatar_color,
+        isBot: value.bot === true,
+        isSystem: value.system === true,
+        flags: value.flags,
+    });
+}
+export function decodeDirectMessage(value) {
+    if (!record(value) ||
+        !identifier(value.id) ||
+        (value.type !== 1 && value.type !== 3) ||
+        (value.guild_id !== undefined && value.guild_id !== null) ||
+        (!(value.type === 3 && value.recipients === undefined) && !Array.isArray(value.recipients)) ||
+        (value.name !== undefined && !nullableText(value.name)) ||
+        (value.icon !== undefined && !nullableText(value.icon)) ||
+        (value.owner_id !== undefined && value.owner_id !== null && !identifier(value.owner_id)) ||
+        (value.last_message_id !== undefined && value.last_message_id !== null && !identifier(value.last_message_id)))
+        return undefined;
+    const recipients = [];
+    const ids = new Set();
+    for (const input of (value.recipients ?? [])) {
+        const user = decodeUser(input);
+        if (!user || ids.has(user.id))
+            return undefined;
+        ids.add(user.id);
+        recipients.push(user);
+    }
+    const nicknames = {};
+    if (value.nicks !== undefined) {
+        if (!record(value.nicks))
+            return undefined;
+        for (const [id, nick] of Object.entries(value.nicks)) {
+            if (!identifier(id) || !text(nick, 1, 32))
+                return undefined;
+            nicknames[id] = nick;
+        }
+    }
+    return Object.freeze({
+        id: value.id,
+        type: value.type === 1 ? "dm" : "group",
+        recipients: Object.freeze(recipients),
+        name: value.name ?? null,
+        icon: value.icon ?? null,
+        ownerId: value.owner_id ?? null,
+        lastMessageId: value.last_message_id ?? null,
+        nicknames: Object.freeze(nicknames),
+    });
+}
+export function userFetch(id) {
+    if (id !== "@me" && !identifier(id))
+        return inputValidationFailure("userId", "format", "User IDs must be decimal strings or @me");
+    return {
+        majorId: id,
+        path: `/users/${id}`,
+        method: "GET",
+        status: 200,
+        resource: "users",
+        ...(id === "@me" ? {} : { id }),
+        decode: (value) => {
+            const user = decodeUser(value);
+            return user && (id === "@me" || user.id === id) ? user : undefined;
+        },
+    };
+}
+/** Build one explicit profile read with only a caller-selected guild context and no relationship-expansion flags */
+export function userProfile(id, query) {
+    if (!identifier(id))
+        return inputValidationFailure("userId", "format", "User IDs must be decimal strings");
+    if (query !== undefined && !record(query))
+        return inputValidationFailure("query", "type", "User profile query must be an object");
+    const unsupported = record(query)
+        ? unsupportedKeyFailure(query, ["guildId"], "query", "the user profile query")
+        : undefined;
+    if (unsupported)
+        return unsupported;
+    if (record(query) && query.guildId !== undefined && !identifier(query.guildId))
+        return inputValidationFailure("query.guildId", "format", "Guild IDs must be decimal strings");
+    const guildId = typeof query?.guildId === "string" ? query.guildId : undefined;
+    const path = `/users/${id}/profile${guildId === undefined ? "" : `?guild_id=${encodeURIComponent(guildId)}`}`;
+    return {
+        majorId: id,
+        path,
+        method: "GET",
+        status: 200,
+        resource: "users",
+        noCache: true,
+        decode: (value) => {
+            if (!record(value) ||
+                !record(value.user) ||
+                !record(value.user_profile) ||
+                (value.profile_limited !== undefined && typeof value.profile_limited !== "boolean"))
+                return undefined;
+            const user = decodeUser(value.user);
+            const profile = decodeUserProfileFields(value.user_profile, true);
+            if (!user || user.id !== id || !profile)
+                return undefined;
+            const member = value.guild_member;
+            if (member !== undefined) {
+                if (!record(member))
+                    return undefined;
+                if (member.guild_id !== undefined && (!identifier(member.guild_id) || member.guild_id !== guildId))
+                    return undefined;
+                if (member.user !== undefined && (!record(member.user) || member.user.id !== id))
+                    return undefined;
+            }
+            let guildProfile = null;
+            if (value.guild_member_profile !== undefined && value.guild_member_profile !== null) {
+                if (guildId === undefined)
+                    return undefined;
+                const decodedGuildProfile = decodeUserProfileFields(value.guild_member_profile, false);
+                if (!decodedGuildProfile)
+                    return undefined;
+                guildProfile = decodedGuildProfile;
+            }
+            return Object.freeze({ user, profile, guildProfile, isLimited: value.profile_limited === true });
+        },
+    };
+}
+function decodeUserProfileFields(value, accountProfile) {
+    if (!record(value) ||
+        !nullableText(value.bio) ||
+        !nullableText(value.pronouns) ||
+        !nullableText(value.banner) ||
+        !(value.accent_color === null || integer(value.accent_color)))
+        return undefined;
+    let bannerColor;
+    if (accountProfile && value.banner_color !== undefined) {
+        if (!(value.banner_color === null || integer(value.banner_color)))
+            return undefined;
+        bannerColor = value.banner_color;
+    }
+    const profile = {
+        bio: value.bio,
+        pronouns: value.pronouns,
+        banner: value.banner,
+        ...(bannerColor === undefined ? {} : { bannerColor }),
+        accentColor: value.accent_color,
+    };
+    return Object.freeze(profile);
+}
+export function directMessageOpen(id) {
+    if (!identifier(id))
+        return inputValidationFailure("userId", "format", "User IDs must be decimal strings");
+    const json = JSON.stringify({ recipient_id: id });
+    if (Buffer.byteLength(json) > 4_194_304)
+        return inputValidationFailure("userId", "size", "Direct message request must not exceed 4,194,304 encoded bytes");
+    return {
+        majorId: "@me",
+        path: "/users/@me/channels",
+        method: "POST",
+        status: 200,
+        resource: "directMessages",
+        json,
+        decode: (value) => {
+            const channel = decodeDirectMessage(value);
+            return channel?.type === "dm" && channel.recipients.some((user) => user.id === id) ? channel : undefined;
+        },
+    };
+}
+export function directMessageFetch(id) {
+    if (!identifier(id))
+        return inputValidationFailure("channelId", "format", "Channel IDs must be decimal strings");
+    return {
+        majorId: id,
+        id,
+        path: `/channels/${id}`,
+        method: "GET",
+        status: 200,
+        resource: "directMessages",
+        decode: (value) => {
+            const channel = decodeDirectMessage(value);
+            return channel?.id === id ? channel : undefined;
+        },
+    };
+}
+export function directMessageList() {
+    return {
+        majorId: "@me",
+        path: "/users/@me/channels",
+        method: "GET",
+        status: 200,
+        resource: "directMessages",
+        replace: true,
+        decode: (value) => {
+            if (!Array.isArray(value))
+                return undefined;
+            const result = [];
+            const ids = new Set();
+            for (const item of value) {
+                // Personal notes are not conversations and are deliberately excluded
+                if (record(item) && item.type === 999)
+                    continue;
+                const channel = decodeDirectMessage(item);
+                if (!channel || ids.has(channel.id))
+                    return undefined;
+                ids.add(channel.id);
+                result.push(channel);
+            }
+            return Object.freeze(result);
+        },
+    };
+}
+export function directMessageLatestMessages(ids, decode = decodeMessage) {
+    if (!Array.isArray(ids))
+        return inputValidationFailure("channelIds", "type", "Channel IDs must be an array");
+    const count = ids.length;
+    if (count === 0 || count > 100)
+        return inputValidationFailure("channelIds", "length", "Latest-message reads require 1 through 100 channel IDs");
+    // oxlint-disable-next-line unicorn/no-new-array -- preallocates the counted length once, and the loop below assigns every index
+    const channelIds = new Array(count);
+    for (let index = 0; index < count; index++)
+        channelIds[index] = ids[index];
+    if (channelIds.some((id) => !identifier(id)))
+        return inputValidationFailure("channelIds[]", "format", "Channel IDs must be decimal strings");
+    if (new Set(channelIds).size !== channelIds.length)
+        return inputValidationFailure("channelIds", "unique", "Channel IDs must be unique");
+    const json = JSON.stringify({ channels: channelIds });
+    return {
+        majorId: "@me",
+        path: "/users/@me/channels/messages/preload",
+        method: "POST",
+        status: 200,
+        resource: "directMessages",
+        json,
+        noCache: true,
+        decode: (value) => {
+            if (!record(value) || Object.keys(value).some((id) => !channelIds.includes(id)))
+                return undefined;
+            const messages = {};
+            for (const [id, item] of Object.entries(value)) {
+                if (item === null) {
+                    messages[id] = null;
+                    continue;
+                }
+                const message = decode(item);
+                if (!message || message.channelId !== id)
+                    return undefined;
+                messages[id] = message;
+            }
+            const omittedChannelIds = channelIds.filter((id) => !(id in messages));
+            return Object.freeze({
+                messages: Object.freeze(messages),
+                omittedChannelIds: Object.freeze(omittedChannelIds),
+            });
+        },
+    };
+}
+export function directMessageEdit(id, input) {
+    if (!identifier(id))
+        return inputValidationFailure("channelId", "format", "Channel IDs must be decimal strings");
+    if (!record(input))
+        return inputValidationFailure("input", "type", "Group DM input must be an object");
+    if (Object.keys(input).length === 0)
+        return inputValidationFailure("input", "required", "Group DM input must contain at least one field");
+    const unsupported = unsupportedKeyFailure(input, ["name", "icon", "ownerId", "nicknames"], "input", "the group DM input");
+    if (unsupported)
+        return unsupported;
+    if (input.name !== undefined && input.name !== null && !channelName(input.name))
+        return inputValidationFailure("input", "format", "Group DM name must be null or contain 1 through 100 UTF-16 code units after Fluxer's normalization, and at most 10,000 before it");
+    if (input.icon !== undefined &&
+        input.icon !== null &&
+        (typeof input.icon !== "string" ||
+            !/^data:image\/[a-zA-Z0-9.+-]+;base64,[A-Za-z0-9+/]+={0,2}$/.test(input.icon)))
+        return inputValidationFailure("input", "format", "Group DM icon must be null or a base64 image data URI");
+    if (input.ownerId !== undefined && !identifier(input.ownerId))
+        return inputValidationFailure("input", "format", "Group DM owner IDs must be decimal strings");
+    if (input.nicknames !== undefined &&
+        input.nicknames !== null &&
+        (!record(input.nicknames) ||
+            Object.entries(input.nicknames).some(([id, value]) => !identifier(id) || (value !== null && (value === "" || !normalizedText(value, 0, 32))))))
+        return inputValidationFailure("nicknames", "format", "Group DM nicknames must map decimal user IDs to null or nonempty strings of at most 32 UTF-16 code units after Fluxer's normalization");
+    const json = JSON.stringify({ name: input.name, icon: input.icon, owner_id: input.ownerId, nicks: input.nicknames });
+    if (json === "{}")
+        return inputValidationFailure("input", "required", "Group DM input must set at least one field to a defined value");
+    if (Buffer.byteLength(json) > 4_194_304)
+        return inputValidationFailure("input", "size", "Group DM input must not exceed 4,194,304 encoded bytes");
+    const current = directMessageFetch(id);
+    if (current instanceof InputValidationFailure)
+        return current;
+    return {
+        ...current,
+        method: "PATCH",
+        json,
+        verifyType: "group",
+        decode: (value) => {
+            const channel = decodeDirectMessage(value);
+            return channel?.id === id && channel.type === "group" ? channel : undefined;
+        },
+    };
+}
+export function directMessageClose(id, recipient) {
+    if (!identifier(id))
+        return inputValidationFailure("channelId", "format", "Channel IDs must be decimal strings");
+    if (recipient !== undefined && !identifier(recipient))
+        return inputValidationFailure("recipientId", "format", "Recipient IDs must be decimal strings");
+    return {
+        majorId: id,
+        id,
+        path: `/channels/${id}${recipient === undefined ? "" : `/recipients/${recipient}`}`,
+        method: "DELETE",
+        status: 204,
+        resource: "directMessages",
+        verifyType: recipient === undefined ? "private" : "group",
+        decode: () => undefined,
+    };
+}
+//# sourceMappingURL=users.js.map

package/dist/internal/users.js.map

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

package/dist/internal/vanity-url.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Vanity URL operations.
+ * Invariant: Codes are validated locally, and URLs are built from the instance's discovered invite base.
+ * Implements [SDK contracts: Delivery, requests and caches](/docs/SDK-CONTRACTS.md#delivery-requests-and-caches)
+ */
+import type { GuildVanityUrl, GuildVanityUrlUsage, ModerationOptions } from "#sdk/guilds";
+import type { GuildRequest } from "./guilds.js";
+import { InputValidationFailure } from "#sdk/input-validation";
+export declare function vanityUrlFetch(guildId: string, inviteBase?: string): GuildRequest<GuildVanityUrlUsage> | InputValidationFailure;
+export declare function vanityUrlEdit(guildId: string, code: string | null, options?: ModerationOptions, inviteBase?: string): GuildRequest<GuildVanityUrl> | InputValidationFailure;
+//# sourceMappingURL=vanity-url.d.ts.map

package/dist/internal/vanity-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vanity-url.d.ts","sourceRoot":"","sources":["../../src/internal/vanity-url.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AACzF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG/C,OAAO,EAAE,sBAAsB,EAA0B,MAAM,uBAAuB,CAAA;AAetF,wBAAgB,cAAc,CAC1B,OAAO,EAAE,MAAM,EACf,UAAU,SAAe,GAC1B,YAAY,CAAC,mBAAmB,CAAC,GAAG,sBAAsB,CAsB5D;AAED,wBAAgB,aAAa,CACzB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,OAAO,CAAC,EAAE,iBAAiB,EAC3B,UAAU,SAAe,GAC1B,YAAY,CAAC,cAAc,CAAC,GAAG,sBAAsB,CAuBvD"}

package/dist/internal/vanity-url.js

@@ -0,0 +1,58 @@
+import { identifier, record } from "./decode/primitives.js";
+import { auditSettings } from "./moderation.js";
+import { InputValidationFailure, inputValidationFailure } from "#sdk/input-validation";
+const hostedInvite = "https://fluxer.gg";
+const codeValue = (value) => typeof value === "string" && value.length >= 2 && value.length <= 32 && /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(value);
+function decode(value, inviteBase = hostedInvite) {
+    if (!record(value) || (value.code !== null && !codeValue(value.code)))
+        return undefined;
+    return Object.freeze({
+        code: value.code,
+        url: value.code === null ? null : `${inviteBase}/${encodeURIComponent(value.code)}`,
+    });
+}
+export function vanityUrlFetch(guildId, inviteBase = hostedInvite) {
+    if (!identifier(guildId))
+        return inputValidationFailure("guildId", "format", "Guild IDs must be decimal strings");
+    return {
+        guildId,
+        bucket: "guild:vanity:read",
+        path: `/guilds/${guildId}/vanity-url`,
+        method: "GET",
+        status: 200,
+        decode: (value, instance) => {
+            const result = decode(value, instance?.invite ?? inviteBase);
+            if (!result ||
+                !record(value) ||
+                typeof value.uses !== "number" ||
+                !Number.isSafeInteger(value.uses) ||
+                value.uses < 0 ||
+                value.uses > 2_147_483_647)
+                return undefined;
+            return Object.freeze({ ...result, uses: value.uses });
+        },
+    };
+}
+export function vanityUrlEdit(guildId, code, options, inviteBase = hostedInvite) {
+    const base = vanityUrlFetch(guildId, inviteBase);
+    const audit = auditSettings(options);
+    if (base instanceof InputValidationFailure)
+        return base;
+    if (audit instanceof InputValidationFailure)
+        return audit;
+    if (code !== null && !codeValue(code))
+        return inputValidationFailure("code", "format", "Vanity code must be null or contain 2 through 32 lowercase alphanumeric hyphen-separated characters");
+    return {
+        ...base,
+        ...audit,
+        bucket: "guild:vanity:update",
+        method: "PATCH",
+        json: JSON.stringify({ code }),
+        cache: { selection: { kind: "guilds", guildId }, mutation: true },
+        decode: (value, instance) => {
+            const result = decode(value, instance?.invite ?? inviteBase);
+            return result?.code === code ? result : undefined;
+        },
+    };
+}
+//# sourceMappingURL=vanity-url.js.map

package/dist/internal/vanity-url.js.map

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

package/dist/internal/webhooks.d.ts

@@ -0,0 +1,58 @@
+import * as Effect from "effect/Effect";
+import * as Scope from "effect/Scope";
+import { ClientClosedError, ConfigurationError } from "#sdk/errors";
+import type { Message, MessageOperationOptions } from "#sdk/messages";
+import { type CreatedWebhook, type IncomingWebhook, type Webhook, type WebhookCreate, type WebhookEdit, type WebhookMessageInput, type WebhookMessageEdit, type WebhookTokenEdit, type WebhookOperation, type WebhookMessageOperationOptions, type WebhookOperationOptions, type WebhookClientOptions } from "#sdk/webhooks";
+import type { EncodedBody } from "./attachments.js";
+import { RestOwner } from "./rest.js";
+import { type ClientLogger } from "./logging.js";
+import { InstanceResolver, type InstanceConfiguration } from "./instance.js";
+import { InputValidationFailure } from "#sdk/input-validation";
+import { type LogicalScheduler } from "./logical-scheduler.js";
+export type WebhookRequest<A> = {
+    majorId: string;
+    method: "GET" | "POST" | "PATCH" | "DELETE";
+    path: string;
+    status: number;
+    body?: EncodedBody;
+    tokenAuth?: true;
+    auditReason?: string;
+    /** The operation's options may carry threadId, which the builder already folded into the path */
+    threadOption?: true;
+    decode: (value: unknown) => A | undefined;
+};
+type WebhookValidationResult<A> = WebhookRequest<A> | InputValidationFailure;
+export declare function webhookCreate(channelId: string, input: WebhookCreate, options?: WebhookOperationOptions): WebhookValidationResult<CreatedWebhook>;
+export declare function webhookFetch(id: string): WebhookValidationResult<Webhook>;
+export declare function webhookList(id: string, kind: "channels" | "guilds"): WebhookValidationResult<readonly Webhook[]>;
+export declare function webhookEdit(id: string, input: WebhookEdit, options?: WebhookOperationOptions): WebhookValidationResult<Webhook>;
+export declare function webhookDelete(id: string, options?: WebhookOperationOptions): WebhookValidationResult<void>;
+export declare function webhookTokenFetch(id: string): WebhookValidationResult<IncomingWebhook>;
+export declare function webhookTokenEdit(id: string, input: WebhookTokenEdit): WebhookValidationResult<IncomingWebhook>;
+export declare function webhookTokenDelete(id: string): WebhookValidationResult<void>;
+export declare function webhookSend(id: string, value: WebhookMessageInput | string): WebhookValidationResult<Message>;
+export declare function webhookMessageFetch(id: string, messageId: string, options?: WebhookMessageOperationOptions): WebhookValidationResult<Message>;
+export declare function webhookMessageEdit(id: string, messageId: string, value: WebhookMessageEdit | string, options?: WebhookMessageOperationOptions): WebhookValidationResult<Message>;
+export declare function webhookMessageDelete(id: string, messageId: string, options?: WebhookMessageOperationOptions): WebhookValidationResult<void>;
+/** Token-only lifetime with its own bounded scheduler and no gateway, token store or observation cache */
+declare class WebhookOwner {
+    #private;
+    readonly id: string;
+    readonly rest: RestOwner;
+    /** Token-only clients still own an independent immutable instance result and discovery worker */
+    readonly instance: InstanceResolver;
+    constructor(id: string, token: string, settings: {
+        readonly maxBytes: number;
+        readonly instance: InstanceConfiguration;
+        readonly logging: ClientLogger;
+    }, scope: Scope.Closeable, logical: LogicalScheduler);
+    run<A>(operation: WebhookOperation, build: () => WebhookRequest<A> | InputValidationFailure, options?: MessageOperationOptions): Effect.Effect<A, ClientClosedError | import("#sdk/webhooks").WebhookOperationError, never>;
+    shutdown(): Effect.Effect<void, never, never>;
+}
+/**
+ * Validate webhook client options, reading each field once, then create the owner. Reading the options, including
+ * calling revealToken, is marked as application input, while creating the owner is SDK work
+ */
+export declare function makeWebhookClient(options: WebhookClientOptions, native?: boolean): Effect.Effect<WebhookOwner, ConfigurationError>;
+export {};
+//# sourceMappingURL=webhooks.d.ts.map

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

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