@neontechspace/fluxerly 1000.0.0-nightly.12

package/dist/internal/invites.js

@@ -0,0 +1,182 @@
+import { identifier, nonNegativeInteger as integer, record } from "./decode/primitives.js";
+import { auditSettings } from "./moderation.js";
+import { InputValidationFailure, inputValidationFailure, unsupportedKeyFailure } from "#sdk/input-validation";
+import { timestamp } from "./decode/timestamp.js";
+const hostedInvite = "https://fluxer.gg";
+const codeValue = (value) => typeof value === "string" &&
+    value.length > 0 &&
+    value.isWellFormed() &&
+    // oxlint-disable-next-line no-control-regex -- rejects control characters in invite codes
+    !/[\s\x00-\x1f\x7f/?#\\]/u.test(value) &&
+    value !== "." &&
+    value !== "..";
+function decode(value, inviteBase = hostedInvite) {
+    if (!record(value) ||
+        !codeValue(value.code) ||
+        (value.type !== 0 && value.type !== 1) ||
+        !record(value.channel) ||
+        !identifier(value.channel.id) ||
+        !integer(value.channel.type) ||
+        (value.channel.name !== undefined && value.channel.name !== null && typeof value.channel.name !== "string") ||
+        !integer(value.member_count) ||
+        typeof value.temporary !== "boolean" ||
+        (value.expires_at !== undefined && value.expires_at !== null && !timestamp(value.expires_at)) ||
+        (value.inviter !== undefined &&
+            value.inviter !== null &&
+            (!record(value.inviter) || !identifier(value.inviter.id))))
+        return undefined;
+    if (value.type === 0 &&
+        (!record(value.guild) ||
+            !identifier(value.guild.id) ||
+            typeof value.guild.name !== "string" ||
+            !integer(value.presence_count)))
+        return undefined;
+    return Object.freeze({
+        code: value.code,
+        url: `${inviteBase}/${encodeURIComponent(value.code)}`,
+        type: value.type === 0 ? "guild" : "group",
+        channel: Object.freeze({
+            id: value.channel.id,
+            type: value.channel.type,
+            ...(value.channel.name === undefined ? {} : { name: value.channel.name }),
+        }),
+        ...(value.type === 0
+            ? {
+                guild: Object.freeze({
+                    id: value.guild.id,
+                    name: value.guild.name,
+                }),
+                presenceCount: value.presence_count,
+            }
+            : {}),
+        ...(value.inviter === undefined
+            ? {}
+            : { inviterId: value.inviter === null ? null : value.inviter.id }),
+        memberCount: value.member_count,
+        ...(value.expires_at === undefined ? {} : { expiresAt: value.expires_at }),
+        temporary: value.temporary,
+    });
+}
+function metadata(value, inviteBase = hostedInvite) {
+    const base = decode(value, inviteBase);
+    if (!base ||
+        !record(value) ||
+        !timestamp(value.created_at) ||
+        !integer(value.uses) ||
+        !integer(value.max_uses) ||
+        (base.type === "guild" && !integer(value.max_age)))
+        return undefined;
+    return Object.freeze({
+        ...base,
+        createdAt: value.created_at,
+        uses: value.uses,
+        maxUses: value.max_uses,
+        ...(base.type === "guild" ? { maxAgeSeconds: value.max_age } : {}),
+    });
+}
+/** Decode the complete metadata emitted by INVITE_CREATE without retaining it */
+export function decodeInviteMetadata(value, inviteBase = hostedInvite) {
+    return metadata(value, inviteBase);
+}
+/** Decode INVITE_DELETE's intentionally smaller terminal identity without retaining it */
+export function decodeInviteDelete(value) {
+    if (!record(value) ||
+        !codeValue(value.code) ||
+        (value.channel_id !== undefined && !identifier(value.channel_id)) ||
+        (value.guild_id !== undefined && !identifier(value.guild_id)))
+        return undefined;
+    return Object.freeze({
+        code: value.code,
+        ...(value.channel_id === undefined ? {} : { channelId: value.channel_id }),
+        ...(value.guild_id === undefined ? {} : { guildId: value.guild_id }),
+    });
+}
+export function inviteFetch(code, inviteBase = hostedInvite) {
+    if (!codeValue(code))
+        return inputValidationFailure("code", "format", "Invite code must be nonempty well-formed text without whitespace, control characters or URL path/query/fragment separators, and cannot be . or ..");
+    return {
+        guildId: "invites",
+        bucket: "invites:code",
+        path: `/invites/${encodeURIComponent(code)}`,
+        method: "GET",
+        status: 200,
+        // Fluxer can resolve a vanity code using a lowercase fallback
+        decode: (value, instance) => {
+            const item = decode(value, instance?.invite ?? inviteBase);
+            return item && (item.code === code || item.code === code.toLowerCase()) ? item : undefined;
+        },
+    };
+}
+export function inviteList(kind, id, inviteBase = hostedInvite) {
+    if (!identifier(id))
+        return inputValidationFailure(kind === "guilds" ? "guildId" : "channelId", "format", kind === "guilds" ? "Guild IDs must be decimal strings" : "Channel IDs must be decimal strings");
+    return {
+        guildId: id,
+        bucket: `${kind}:invites`,
+        path: `/${kind}/${id}/invites`,
+        method: "GET",
+        status: 200,
+        decode: (value, instance) => {
+            if (!Array.isArray(value))
+                return undefined;
+            const result = [];
+            const codes = new Set();
+            for (const entry of value) {
+                const item = metadata(entry, instance?.invite ?? inviteBase);
+                if (!item ||
+                    codes.has(item.code) ||
+                    (kind === "guilds" ? item.guild?.id !== id : item.channel.id !== id))
+                    return undefined;
+                codes.add(item.code);
+                result.push(item);
+            }
+            return Object.freeze(result);
+        },
+    };
+}
+export function inviteCreate(channelId, input, options, inviteBase = hostedInvite) {
+    const value = input === undefined ? {} : input;
+    const base = inviteList("channels", channelId, inviteBase);
+    const audit = auditSettings(options);
+    if (base instanceof InputValidationFailure)
+        return base;
+    if (audit instanceof InputValidationFailure)
+        return audit;
+    if (!record(value))
+        return inputValidationFailure("input", "type", "Invite input must be an object");
+    const unsupported = unsupportedKeyFailure(value, ["maxAgeSeconds", "maxUses", "unique", "temporary"], "input", "the invite input");
+    if (unsupported)
+        return unsupported;
+    const maxAgeSeconds = value.maxAgeSeconds === undefined ? 86_400 : value.maxAgeSeconds;
+    const maxUses = value.maxUses === undefined ? 0 : value.maxUses;
+    const unique = value.unique === undefined ? true : value.unique;
+    const temporary = value.temporary === undefined ? false : value.temporary;
+    if (!integer(maxAgeSeconds, 604_800))
+        return inputValidationFailure("maxAgeSeconds", "range", "Invite maximum age must be an integer from 0 through 604,800 seconds");
+    if (!integer(maxUses, 100))
+        return inputValidationFailure("maxUses", "range", "Invite maximum uses must be an integer from 0 through 100");
+    if (typeof unique !== "boolean")
+        return inputValidationFailure("unique", "type", "Invite option unique must be a boolean");
+    if (typeof temporary !== "boolean")
+        return inputValidationFailure("temporary", "type", "Invite option temporary must be a boolean");
+    return {
+        ...base,
+        ...audit,
+        method: "POST",
+        json: JSON.stringify({ max_age: maxAgeSeconds, max_uses: maxUses, unique, temporary }),
+        decode: (value, instance) => {
+            const item = metadata(value, instance?.invite ?? inviteBase);
+            return item?.channel.id === channelId ? item : undefined;
+        },
+    };
+}
+export function inviteDelete(code, options, inviteBase = hostedInvite) {
+    const base = inviteFetch(code, inviteBase);
+    const audit = auditSettings(options);
+    if (base instanceof InputValidationFailure)
+        return base;
+    if (audit instanceof InputValidationFailure)
+        return audit;
+    return { ...base, ...audit, method: "DELETE", status: 204, decode: () => undefined };
+}
+//# sourceMappingURL=invites.js.map

package/dist/internal/invites.js.map

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

package/dist/internal/logging.d.ts

@@ -0,0 +1,129 @@
+import * as Cause from "effect/Cause";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Logger from "effect/Logger";
+import type { ClientCounters, ErrorInfo, LogCategory, LogLevel, LogRecord, LogSink } from "#sdk/logging";
+import { ConfigurationError } from "#sdk/errors";
+import type { LogCode } from "./code-catalogue.js";
+/** The installed SDK version from the package manifest next to the compiled or source directory */
+export declare function sdkVersion(): string;
+/** Record fields accepted from SDK call sites. The error is converted to ErrorInfo and cause keeps native Cause detail */
+export interface LogInput {
+    readonly level: LogLevel;
+    readonly category: LogCategory;
+    /** A catalogued code, so every emitted code has an entry on the error and log codes page */
+    readonly code: LogCode;
+    readonly message: string;
+    readonly shardId?: number | undefined;
+    readonly route?: string | undefined;
+    readonly event?: string | undefined;
+    readonly command?: string | undefined;
+    readonly subscriptionId?: string | undefined;
+    readonly durationMs?: number | undefined;
+    readonly attempt?: number | undefined;
+    readonly delayMs?: number | undefined;
+    readonly status?: number | undefined;
+    readonly closeCode?: number | undefined;
+    readonly fields?: Readonly<Record<string, string | number | boolean | null | undefined>> | undefined;
+    readonly error?: unknown;
+    readonly origin?: ErrorInfo["origin"] | undefined;
+    readonly cause?: Cause.Cause<unknown> | undefined;
+}
+export type CounterName = Exclude<keyof ClientCounters, "eventsDropped">;
+export type DropReason = keyof ClientCounters["eventsDropped"];
+/** Convert any thrown or failed value to masked ErrorInfo, following the cause chain a few levels.
+ * Never throws: Getters, proxies and null-prototype objects that reject inspection get a guarded description
+ */
+export declare function errorInfo(value: unknown, origin: ErrorInfo["origin"], secrets?: readonly string[], depth?: number): ErrorInfo;
+/** Readable multi-line text for an ErrorInfo, indented for console output: Title, hint, safe details and stack frames
+ * for each error in the cause chain. Consecutive frames inside the SDK and Effect collapse into one line, and SDK
+ * errors other than SdkDefect and ConfigurationError print no frames. JSON output keeps the full stack
+ */
+export declare function errorText(info: ErrorInfo, indent?: string, stack?: boolean): string;
+type Settings = {
+    readonly thresholds: Readonly<Record<LogCategory, number>>;
+    readonly sinks: readonly LogSink[] | undefined;
+    readonly format: "pretty" | "json" | undefined;
+    /** FLUXERLY_LOG_FORMAT read at creation, used by the built-in console output when format is not set */
+    readonly environmentFormat: "pretty" | "json" | undefined;
+    /** FLUXERLY_LOG_COLOR read at creation: `true` forces color, `false` disables it, `undefined` follows the terminal */
+    readonly environmentColor: boolean | undefined;
+    readonly dedupeMs: number | undefined;
+    readonly unsafe: ReadonlySet<LogCategory> | undefined;
+    readonly debugCategories: ReadonlySet<LogCategory>;
+    readonly unknownDebug: readonly string[];
+    /** Logging environment variables whose values were not recognized and are ignored */
+    readonly unknownEnvironment: readonly {
+        readonly variable: string;
+        readonly accepted: string;
+    }[];
+};
+/** One client's logging configuration, counters and output. Emission is synchronous and never fails its caller */
+export declare class ClientLogger {
+    #private;
+    readonly native: boolean;
+    /** Native context used when a record is emitted outside a fiber, normally the client's creation context */
+    context: Context.Context<never> | undefined;
+    /** Receives every Error and Fatal record before level thresholds and deduplication. The test kit sets it, so its
+     * failure checks see unhandled failures however quiet the test client's logging is
+     */
+    errorTap: ((record: LogRecord) => void) | undefined;
+    constructor(settings: Settings, native: boolean);
+    /**
+     * Replace the level and category thresholds from caller settings. A debug setting replaces the Debug categories,
+     * including those from FLUXERLY_DEBUG, and an omitted one keeps the current categories. Invalid settings return
+     * ConfigurationError and change nothing. Caller reads are marked, so the caller must run this under a defect boundary
+     */
+    configure(value: unknown): ConfigurationError | undefined;
+    /** Mask this credential in every later record */
+    addSecret(secret: string): void;
+    get secrets(): readonly string[];
+    enabled(level: LogLevel, category: LogCategory): boolean;
+    unsafePayloads(category: LogCategory): boolean;
+    count(name: CounterName, amount?: number): void;
+    countDrop(reason: DropReason, amount?: number): void;
+    counters(): ClientCounters;
+    /** Record an intentionally discarded item: Count it, then log at Debug for expected drops or Warn for anomalies */
+    drop(counter: CounterName | {
+        readonly event: DropReason;
+        readonly amount?: number;
+    } | undefined, input: LogInput & {
+        readonly level: "debug" | "warn" | "error";
+    }, context?: Context.Context<never>): void;
+    /** Emit the startup banners once per client, including the unsafe payload warning and unknown debug categories */
+    banners(context?: Context.Context<never>): void;
+    /** Print a masked payload body at Trace when unsafe payload logging covers this category.
+     * A silent category prints nothing. Otherwise the unsafe banner precedes the first payload record
+     */
+    payload(category: LogCategory, code: LogCode, message: string, value: unknown, extra?: Partial<LogInput>): void;
+    /** Emit a record synchronously when its category threshold allows it. Output failures never reach the caller */
+    log(input: LogInput, context?: Context.Context<never>): void;
+    /** Whether this error value already appeared in an Error or Fatal record of this logger */
+    loggedError(error: unknown): boolean;
+    /** Emit through the current fiber's context, so native records keep the caller's logger, annotations and spans */
+    logEffect(input: LogInput): Effect.Effect<void>;
+    /** Report suppressed duplicates that no later record announced and the current thresholds allow, normally during shutdown */
+    flush(context?: Context.Context<never>): void;
+    /** The built-in console format and color for one output stream, which decides from its own terminal state.
+     * Warn and higher records go to standard error. Supervisors pass the parent's choice to their children
+     */
+    consoleFormat(stream: "stdout" | "stderr"): {
+        readonly format: "pretty" | "json";
+        readonly color: boolean;
+    };
+    /** Count a log output or failure-reporting fault and describe the first one on standard error. Never throws */
+    outputFailure(error: unknown): void;
+    /** A default-runtime Effect logger that turns stray Effect log calls from SDK internals into SDK records */
+    bridge(): Logger.Logger<unknown, void>;
+    /** Run default-API work with SDK-internal Effect logs routed into this client's records */
+    provide<A, E, R>(effect: Effect.Effect<A, E, R>): Effect.Effect<A, E, R>;
+}
+/** Run client.logging.configure: Replace the logger's thresholds and, when given, its Debug categories, failing with ConfigurationError for invalid settings */
+export declare const configureLogging: (logger: ClientLogger, settings: unknown) => Effect.Effect<void, ConfigurationError>;
+/**
+ * Validate and copy logging settings, then create the logger. Both entry points accept the same keys.
+ * Only reading the caller settings is marked as application input, so the caller must run this under a defect boundary
+ */
+export declare function loggingConfiguration(value: unknown, native: boolean): ClientLogger | ConfigurationError;
+export {};
+//# sourceMappingURL=logging.d.ts.map

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

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