@neontechspace/fluxerly 1000.0.0-nightly.12

package/dist/internal/agents-section.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Writes the SDK's essential rules into an application's AGENTS.md, which many coding agent tools load automatically.
+ * Invariant: Only the text between the Fluxerly markers is replaced, so the rest of the file stays byte for byte
+ */
+/** Outcome of one run, with the notes to print for the user */
+export interface AgentsSectionResult {
+    readonly status: "created" | "added" | "updated" | "current";
+    readonly file: string;
+    readonly notes: readonly string[];
+}
+/** Thrown when AGENTS.md or the packaged guide cannot be updated safely, so no file was changed */
+export declare class AgentsSectionError extends Error {
+    readonly name = "AgentsSectionError";
+}
+/** The AGENTS.md text that writeAgentsSection creates when `project` has none */
+export declare function newAgentsFile(project: string, packageRoot: string): string;
+/**
+ * Add or refresh the Fluxerly section in `project`/AGENTS.md, creating the file when it is missing.
+ * Line endings follow the existing file. Nothing is written when the section is already current or a marker is broken
+ */
+export declare function writeAgentsSection(project: string, packageRoot: string): AgentsSectionResult;
+//# sourceMappingURL=agents-section.d.ts.map

package/dist/internal/agents-section.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-section.d.ts","sourceRoot":"","sources":["../../src/internal/agents-section.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,+DAA+D;AAC/D,MAAM,WAAW,mBAAmB;IAChC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAA;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CACpC;AAED,mGAAmG;AACnG,qBAAa,kBAAmB,SAAQ,KAAK;IACzC,SAAkB,IAAI,wBAAuB;CAChD;AA2CD,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,mBAAmB,CA0B5F"}

package/dist/internal/agents-section.js

@@ -0,0 +1,101 @@
+/**
+ * Writes the SDK's essential rules into an application's AGENTS.md, which many coding agent tools load automatically.
+ * Invariant: Only the text between the Fluxerly markers is replaced, so the rest of the file stays byte for byte
+ */
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+const start = "<!-- fluxerly:start -->";
+const end = "<!-- fluxerly:end -->";
+const rulesStart = "<!-- fluxerly-rules:start -->";
+const rulesEnd = "<!-- fluxerly-rules:end -->";
+/** Thrown when AGENTS.md or the packaged guide cannot be updated safely, so no file was changed */
+export class AgentsSectionError extends Error {
+    name = "AgentsSectionError";
+}
+// The recorded command must run the installed copy and never download one, since the unscoped fluxerly package on npm is not this SDK
+function refreshCommand(project) {
+    if (existsSync(join(project, "pnpm-lock.yaml")))
+        return "pnpm exec fluxerly agents";
+    if (existsSync(join(project, "bun.lock")) || existsSync(join(project, "bun.lockb")))
+        return "bunx --no-install fluxerly agents";
+    return "npx --no fluxerly agents";
+}
+function between(text, open, close, where) {
+    const first = text.indexOf(open);
+    const last = text.indexOf(close);
+    if (first < 0 && last < 0)
+        return undefined;
+    if (first < 0 || last < first || text.indexOf(open, first + 1) >= 0 || text.indexOf(close, last + 1) >= 0)
+        throw new AgentsSectionError(`${where} must contain exactly one ${open} followed by one ${close}`);
+    return { first, last: last + close.length, inner: text.slice(first + open.length, last) };
+}
+/** Build the section for one SDK version from the rules in the packaged agent guide */
+function agentsSection(guide, version, command) {
+    const rules = between(guide, rulesStart, rulesEnd, "The packaged agent guide");
+    if (!rules)
+        throw new AgentsSectionError("The packaged agent guide has no rules section");
+    return [
+        start,
+        "## Fluxerly",
+        "",
+        `These rules come from @neontechspace/fluxerly ${version}. When the version installed in package.json differs, run \`${command}\` to refresh this section`,
+        "",
+        "Read `node_modules/@neontechspace/fluxerly/agents/AGENTS.md` for the complete guide before writing code with the SDK",
+        "",
+        rules.inner.trim(),
+        end,
+    ].join("\n");
+}
+/** The section for `project` built from the installed package at `packageRoot` */
+function packagedSection(project, packageRoot) {
+    const guide = readFileSync(join(packageRoot, "agents/AGENTS.md"), "utf8").replaceAll("\r\n", "\n");
+    const { version } = JSON.parse(readFileSync(join(packageRoot, "package.json"), "utf8"));
+    return agentsSection(guide, version, refreshCommand(project));
+}
+/** The AGENTS.md text that writeAgentsSection creates when `project` has none */
+export function newAgentsFile(project, packageRoot) {
+    return `# Agent instructions\n\n${packagedSection(project, packageRoot)}\n`;
+}
+/**
+ * Add or refresh the Fluxerly section in `project`/AGENTS.md, creating the file when it is missing.
+ * Line endings follow the existing file. Nothing is written when the section is already current or a marker is broken
+ */
+export function writeAgentsSection(project, packageRoot) {
+    const file = join(project, "AGENTS.md");
+    const notes = [...linkNotes(project)];
+    if (!existsSync(file)) {
+        writeFileSync(file, newAgentsFile(project, packageRoot));
+        return { status: "created", file, notes };
+    }
+    const section = packagedSection(project, packageRoot);
+    const current = readFileSync(file, "utf8");
+    const newline = current.includes("\r\n") ? "\r\n" : "\n";
+    const written = section.replaceAll("\n", newline);
+    const existing = between(current, start, end, "AGENTS.md");
+    if (!existing) {
+        const separator = current.length === 0 || current.endsWith(newline + newline)
+            ? ""
+            : current.endsWith(newline)
+                ? newline
+                : newline + newline;
+        writeFileSync(file, `${current}${separator}${written}${newline}`);
+        return { status: "added", file, notes };
+    }
+    const next = current.slice(0, existing.first) + written + current.slice(existing.last);
+    if (next === current)
+        return { status: "current", file, notes };
+    writeFileSync(file, next);
+    return { status: "updated", file, notes };
+}
+// Some tools read their own instruction file instead of AGENTS.md. Their files are reported, never changed
+function* linkNotes(project) {
+    for (const [name, fix] of [
+        ["CLAUDE.md", "add a line containing @AGENTS.md to it"],
+        ["GEMINI.md", "reference AGENTS.md from it"],
+    ]) {
+        const path = join(project, name);
+        if (existsSync(path) && !readFileSync(path, "utf8").includes("AGENTS.md"))
+            yield `${name} does not mention AGENTS.md, so tools that read ${name} can miss these rules. To connect them, ${fix}`;
+    }
+}
+//# sourceMappingURL=agents-section.js.map

package/dist/internal/agents-section.js.map

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

package/dist/internal/application.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Bot application request: Validates the current-application read and projects its response.
+ * Invariant: The operation is a bot-token read, and the projection keeps only the listed public application fields and the owner user ID.
+ * Implements [SDK contracts: Delivery, requests and caches](/docs/SDK-CONTRACTS.md#delivery-requests-and-caches)
+ */
+import type { BotApplication } from "#sdk/application";
+/** Validated current-application request. Shared REST owns admission, retries, and cleanup */
+export interface BotApplicationRequest<A> {
+    readonly path: string;
+    readonly method: "GET";
+    readonly status: 200;
+    readonly decode: (value: unknown) => A | undefined;
+}
+/** Fetch only the bot-token response's public application fields and owner ID, without cache retention or application management */
+export declare function applicationCurrent(): BotApplicationRequest<BotApplication>;
+//# sourceMappingURL=application.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../../src/internal/application.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAGtD,8FAA8F;AAC9F,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC,GAAG,SAAS,CAAA;CACrD;AA4BD,oIAAoI;AACpI,wBAAgB,kBAAkB,IAAI,qBAAqB,CAAC,cAAc,CAAC,CAO1E"}

package/dist/internal/application.js

@@ -0,0 +1,33 @@
+import { identifier, record } from "./decode/primitives.js";
+const nullableText = (value) => value === null || typeof value === "string";
+function decodeApplication(value) {
+    if (!record(value) ||
+        !identifier(value.id) ||
+        typeof value.name !== "string" ||
+        !nullableText(value.icon) ||
+        !nullableText(value.description) ||
+        typeof value.bot_public !== "boolean" ||
+        typeof value.bot_require_code_grant !== "boolean" ||
+        !record(value.owner) ||
+        !identifier(value.owner.id))
+        return undefined;
+    return Object.freeze({
+        id: value.id,
+        name: value.name,
+        icon: value.icon,
+        description: value.description,
+        botPublic: value.bot_public,
+        botRequireCodeGrant: value.bot_require_code_grant,
+        ownerId: value.owner.id,
+    });
+}
+/** Fetch only the bot-token response's public application fields and owner ID, without cache retention or application management */
+export function applicationCurrent() {
+    return {
+        path: "/oauth2/applications/@me",
+        method: "GET",
+        status: 200,
+        decode: decodeApplication,
+    };
+}
+//# sourceMappingURL=application.js.map

package/dist/internal/application.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application.js","sourceRoot":"","sources":["../../src/internal/application.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AAU3D,MAAM,YAAY,GAAG,CAAC,KAAc,EAA0B,EAAE,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAA;AAE5G,SAAS,iBAAiB,CAAC,KAAc;IACrC,IACI,CAAC,MAAM,CAAC,KAAK,CAAC;QACd,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC9B,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC;QACzB,CAAC,YAAY,CAAC,KAAK,CAAC,WAAW,CAAC;QAChC,OAAO,KAAK,CAAC,UAAU,KAAK,SAAS;QACrC,OAAO,KAAK,CAAC,sBAAsB,KAAK,SAAS;QACjD,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;QACpB,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QAE3B,OAAO,SAAS,CAAA;IACpB,OAAO,MAAM,CAAC,MAAM,CAAC;QACjB,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,SAAS,EAAE,KAAK,CAAC,UAAU;QAC3B,mBAAmB,EAAE,KAAK,CAAC,sBAAsB;QACjD,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE;KAC1B,CAAC,CAAA;AACN,CAAC;AAED,oIAAoI;AACpI,MAAM,UAAU,kBAAkB;IAC9B,OAAO;QACH,IAAI,EAAE,0BAA0B;QAChC,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,GAAG;QACX,MAAM,EAAE,iBAAiB;KAC5B,CAAA;AACL,CAAC"}

package/dist/internal/attachment-refresh.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Attachment URL refresh request: Validates one ordered batch of attachment URLs and decodes the refreshed URLs.
+ * Invariant: Requested strings are never parsed, normalized or dereferenced, and results keep the request order.
+ * Implements [SDK contracts: Delivery, requests and caches](/docs/SDK-CONTRACTS.md#delivery-requests-and-caches)
+ */
+import type { RefreshedAttachmentUrl } from "#sdk/attachments";
+import { InputValidationFailure } from "#sdk/input-validation";
+/** Validated attachment URL refresh request. Shared REST owns admission, deadlines and bounded response parsing */
+export interface AttachmentRefreshRequest {
+    readonly path: "/attachments/refresh-urls";
+    readonly method: "POST";
+    readonly status: 200;
+    readonly json: string;
+    readonly decode: (value: unknown) => readonly RefreshedAttachmentUrl[] | undefined;
+}
+/** Build one explicit ordered refresh without parsing, normalizing or dereferencing any requested string */
+export declare function attachmentRefresh(urls: readonly string[]): AttachmentRefreshRequest | InputValidationFailure;
+//# sourceMappingURL=attachment-refresh.d.ts.map

package/dist/internal/attachment-refresh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-refresh.d.ts","sourceRoot":"","sources":["../../src/internal/attachment-refresh.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAC9D,OAAO,EAAE,sBAAsB,EAA0B,MAAM,uBAAuB,CAAA;AAGtF,mHAAmH;AACnH,MAAM,WAAW,wBAAwB;IACrC,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAA;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAA;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,SAAS,sBAAsB,EAAE,GAAG,SAAS,CAAA;CACrF;AAED,4GAA4G;AAC5G,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,wBAAwB,GAAG,sBAAsB,CAqC5G"}

package/dist/internal/attachment-refresh.js

@@ -0,0 +1,39 @@
+import { InputValidationFailure, inputValidationFailure } from "#sdk/input-validation";
+import { record } from "./decode/primitives.js";
+/** Build one explicit ordered refresh without parsing, normalizing or dereferencing any requested string */
+export function attachmentRefresh(urls) {
+    if (!Array.isArray(urls))
+        return inputValidationFailure("urls", "type", "Attachment URLs must be an array");
+    const length = urls.length;
+    if (length < 1 || length > 50)
+        return inputValidationFailure("urls", "length", "Attachment URL refresh requires 1 through 50 entries");
+    const original = Array.from({ length }, (_, index) => urls[index]);
+    if (!original.every((url) => typeof url === "string"))
+        return inputValidationFailure("urls[]", "type", "Each attachment URL must be a string");
+    if (!original.every((url) => url.length <= 2_048))
+        return inputValidationFailure("urls[]", "length", "Each attachment URL must contain at most 2,048 UTF-16 code units");
+    return {
+        path: "/attachments/refresh-urls",
+        method: "POST",
+        status: 200,
+        json: JSON.stringify({ attachment_urls: original }),
+        decode: (value) => {
+            if (!record(value) || !Array.isArray(value.refreshed_urls))
+                return undefined;
+            if (value.refreshed_urls.length !== original.length)
+                return undefined;
+            const refreshed = [];
+            for (let index = 0; index < original.length; index++) {
+                const item = value.refreshed_urls[index];
+                if (!record(item) ||
+                    typeof item.original !== "string" ||
+                    item.original !== original[index] ||
+                    typeof item.refreshed !== "string")
+                    return undefined;
+                refreshed.push(Object.freeze({ original: item.original, refreshed: item.refreshed }));
+            }
+            return Object.freeze(refreshed);
+        },
+    };
+}
+//# sourceMappingURL=attachment-refresh.js.map

package/dist/internal/attachment-refresh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-refresh.js","sourceRoot":"","sources":["../../src/internal/attachment-refresh.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AACtF,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AAW/C,4GAA4G;AAC5G,MAAM,UAAU,iBAAiB,CAAC,IAAuB;IACrD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,kCAAkC,CAAC,CAAA;IAC3G,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;IAC1B,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,EAAE;QACzB,OAAO,sBAAsB,CAAC,MAAM,EAAE,QAAQ,EAAE,sDAAsD,CAAC,CAAA;IAC3G,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;IAClE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC;QACjD,OAAO,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,sCAAsC,CAAC,CAAA;IAC3F,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,IAAI,KAAK,CAAC;QAC7C,OAAO,sBAAsB,CACzB,QAAQ,EACR,QAAQ,EACR,kEAAkE,CACrE,CAAA;IACL,OAAO;QACH,IAAI,EAAE,2BAA2B;QACjC,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,GAAG;QACX,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC;QACnD,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YACd,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC;gBAAE,OAAO,SAAS,CAAA;YAC5E,IAAI,KAAK,CAAC,cAAc,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM;gBAAE,OAAO,SAAS,CAAA;YACrE,MAAM,SAAS,GAA6B,EAAE,CAAA;YAC9C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;gBACnD,MAAM,IAAI,GAAG,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,CAAA;gBACxC,IACI,CAAC,MAAM,CAAC,IAAI,CAAC;oBACb,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ;oBACjC,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,KAAK,CAAC;oBACjC,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ;oBAElC,OAAO,SAAS,CAAA;gBACpB,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAA;YACzF,CAAC;YACD,OAAO,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QACnC,CAAC;KACJ,CAAA;AACL,CAAC"}

package/dist/internal/attachments.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Attachment encoding and projection: Message attachment inputs, their file sources and received attachment metadata.
+ * Invariant: Byte inputs are copied before any wait, while sized files and finite streams stay caller-owned until a transfer
+ * reader is acquired. Implements [SDK contracts: Delivery, requests and caches](/docs/SDK-CONTRACTS.md#delivery-requests-and-caches)
+ */
+import type { Attachment, AttachmentFileSource, AttachmentStreamSource } from "#sdk/attachments";
+import { InputValidationFailure } from "#sdk/input-validation";
+export type FileSource = {
+    readonly kind: "bytes";
+    readonly data: Uint8Array;
+} | {
+    readonly kind: "file";
+    readonly file: AttachmentFileSource;
+} | {
+    readonly kind: "stream";
+    readonly stream: AttachmentStreamSource;
+};
+export type FilePart = {
+    id: number;
+    filename: string;
+    contentType: string;
+    size: number;
+    source: FileSource;
+};
+export type EncodedBody = {
+    json: string;
+    files: FilePart[];
+};
+/**
+ * Validate attachment structure without reading caller files or streams. Admission later snapshots byte arrays and
+ * reserves exact source sizes. The list is read by index and each attachment field at most once, so the validated
+ * values are the ones sent
+ */
+export declare function encodeAttachments(value: unknown, edit: boolean): InputValidationFailure | {
+    metadata: undefined;
+    files: FilePart[];
+    uploadedFilenames: string[];
+} | {
+    metadata: Record<string, unknown>[];
+    files: FilePart[];
+    uploadedFilenames: string[];
+};
+export declare function decodeAttachments(value: unknown): readonly Attachment[] | undefined;
+export declare function decodeAttachments(value: unknown, construct: boolean): readonly Attachment[] | true | undefined;
+//# sourceMappingURL=attachments.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../../src/internal/attachments.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAChG,OAAO,EAAE,sBAAsB,EAAiD,MAAM,uBAAuB,CAAA;AAM7G,MAAM,MAAM,UAAU,GAChB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAA;CAAE,GAC9D;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAA;CAAE,CAAA;AAE1E,MAAM,MAAM,QAAQ,GAAG;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,UAAU,CAAA;CACrB,CAAA;AACD,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,QAAQ,EAAE,CAAA;CAAE,CAAA;AAwE7D;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO;;WACS,QAAQ,EAAE;uBAA2B,MAAM,EAAE;;;;;EAkJpH;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,UAAU,EAAE,GAAG,SAAS,CAAA;AACpF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,GAAG,SAAS,UAAU,EAAE,GAAG,IAAI,GAAG,SAAS,CAAA"}

package/dist/internal/attachments.js

@@ -0,0 +1,230 @@
+import { InputValidationFailure, inputValidationFailure, unsupportedKeyFailure } from "#sdk/input-validation";
+import { fieldsOnce, identifier, record } from "./decode/primitives.js";
+import { normalizedText } from "./field-text.js";
+const attachmentMaxBytes = 52_428_800;
+function filename(value) {
+    // oxlint-disable-next-line no-control-regex -- rejects control characters in attachment filenames
+    return typeof value === "string" && value.length >= 1 && value.length <= 255 && !/[\x00-\x1f\x7f/\\]/.test(value);
+}
+function contentType(value) {
+    return typeof value === "string" && /^[\x20-\x7e]{1,255}$/.test(value);
+}
+function metadata(field, id, values) {
+    const acceptedFilename = field("filename");
+    if (!filename(acceptedFilename))
+        return inputValidationFailure("attachments[].filename", "format", "Attachment filenames must contain 1 through 255 UTF-16 code units without slashes, backslashes, or control characters");
+    const providedContentType = field("contentType");
+    if (providedContentType !== undefined && !contentType(providedContentType))
+        return inputValidationFailure("attachments[].contentType", "format", "Attachment content types must contain 1 through 255 printable ASCII characters");
+    for (const [key, max] of [
+        ["title", 1024],
+        ["description", 4096],
+    ])
+        if (field(key) !== undefined && !normalizedText(field(key), 1, max))
+            return inputValidationFailure(`attachments[].${key}`, "length", `Attachment ${key} must contain 1 through ${max} UTF-16 code units after Fluxer's normalization`);
+    const spoiler = field("spoiler");
+    if (spoiler !== undefined && typeof spoiler !== "boolean")
+        return inputValidationFailure("attachments[].spoiler", "type", "Attachment spoiler must be a boolean");
+    values.push({
+        id,
+        filename: acceptedFilename,
+        ...(providedContentType === undefined ? {} : { content_type: providedContentType }),
+        ...(field("title") === undefined ? {} : { title: field("title") }),
+        ...(field("description") === undefined ? {} : { description: field("description") }),
+        flags: spoiler === true ? 8 : 0,
+    });
+    return providedContentType ?? "application/octet-stream";
+}
+/** The validated size of a bounded file source, read once with its method checks, or undefined for another value */
+function fileSourceSize(value) {
+    if (!record(value))
+        return undefined;
+    const size = value.size;
+    return typeof size === "number" &&
+        Number.isSafeInteger(size) &&
+        size >= 0 &&
+        size <= attachmentMaxBytes &&
+        typeof value.slice === "function" &&
+        typeof value.stream === "function"
+        ? size
+        : undefined;
+}
+function streamSource(value) {
+    return record(value) && typeof value.getReader === "function";
+}
+/**
+ * Validate attachment structure without reading caller files or streams. Admission later snapshots byte arrays and
+ * reserves exact source sizes. The list is read by index and each attachment field at most once, so the validated
+ * values are the ones sent
+ */
+export function encodeAttachments(value, edit) {
+    if (value === undefined)
+        return { metadata: undefined, files: [], uploadedFilenames: [] };
+    if (!Array.isArray(value))
+        return inputValidationFailure("attachments", "type", "Attachments must be an array");
+    const metadataValues = [];
+    const files = [];
+    const uploadedFilenames = [];
+    const retained = new Set();
+    const count = value.length;
+    for (let index = 0; index < count; index += 1) {
+        const item = value[index];
+        if (!record(item))
+            return inputValidationFailure("attachments[]", "type", "Each attachment must be an object");
+        const field = fieldsOnce(item);
+        const retainedId = field("id");
+        if (retainedId !== undefined) {
+            if (!edit)
+                return inputValidationFailure("attachments[].id", "relationship", "Retained attachment IDs are accepted only when editing a message");
+            if (!identifier(retainedId))
+                return inputValidationFailure("attachments[].id", "format", "Attachment IDs must be decimal strings");
+            const unsupported = unsupportedKeyFailure(item, ["id", "title", "description"], "attachments[]", "A retained attachment");
+            if (unsupported)
+                return unsupported;
+            if (retained.has(retainedId))
+                return inputValidationFailure("attachments[].id", "unique", "Retained attachment IDs must be unique");
+            for (const [key, max] of [
+                ["title", 1024],
+                ["description", 4096],
+            ])
+                if (field(key) !== undefined && field(key) !== null && !normalizedText(field(key), 1, max))
+                    return inputValidationFailure(`attachments[].${key}`, "length", `Retained attachment ${key} must be null or contain 1 through ${max} UTF-16 code units after Fluxer's normalization`);
+            retained.add(retainedId);
+            metadataValues.push({
+                id: retainedId,
+                ...(field("title") === undefined ? {} : { title: field("title") }),
+                ...(field("description") === undefined ? {} : { description: field("description") }),
+            });
+            continue;
+        }
+        const id = metadataValues.length;
+        let source;
+        let size;
+        if (Object.prototype.hasOwnProperty.call(item, "data")) {
+            const unsupported = unsupportedKeyFailure(item, ["data", "filename", "contentType", "title", "description", "spoiler"], "attachments[]", "A byte attachment");
+            if (unsupported)
+                return unsupported;
+            const data = field("data");
+            const buffer = data instanceof Uint8Array ? data.buffer : undefined;
+            if (!(data instanceof Uint8Array) || !(buffer instanceof ArrayBuffer))
+                return inputValidationFailure("attachments[].data", "type", "Attachment data must be an ArrayBuffer-backed Uint8Array");
+            const byteLength = data.byteLength;
+            if (byteLength > attachmentMaxBytes)
+                return inputValidationFailure("attachments[].data", "size", "Attachment data must not exceed 52,428,800 bytes (50 MiB)");
+            try {
+                new Uint8Array(buffer, data.byteOffset, byteLength);
+            }
+            catch {
+                // allow-silent: A detached or invalid buffer becomes the typed input failure returned below
+                return inputValidationFailure("attachments[].data", "type", "Attachment data must reference an accessible ArrayBuffer range");
+            }
+            source = { kind: "bytes", data };
+            size = byteLength;
+        }
+        else if (Object.prototype.hasOwnProperty.call(item, "file")) {
+            const unsupported = unsupportedKeyFailure(item, ["file", "filename", "contentType", "title", "description", "spoiler"], "attachments[]", "A file attachment");
+            if (unsupported)
+                return unsupported;
+            const file = field("file");
+            const fileSize = fileSourceSize(file);
+            if (fileSize === undefined)
+                return inputValidationFailure("attachments[].file", "type", "Attachment files must be File or Blob objects with slice and stream methods and a size from 0 through 52,428,800 bytes (50 MiB)");
+            source = { kind: "file", file: file };
+            size = fileSize;
+        }
+        else if (Object.prototype.hasOwnProperty.call(item, "stream")) {
+            const unsupported = unsupportedKeyFailure(item, ["stream", "size", "filename", "contentType", "title", "description", "spoiler"], "attachments[]", "A stream attachment");
+            if (unsupported)
+                return unsupported;
+            const stream = field("stream");
+            if (!streamSource(stream))
+                return inputValidationFailure("attachments[].stream", "type", "Attachment streams must be ReadableStream objects with a getReader method");
+            const streamSize = field("size");
+            if (typeof streamSize !== "number" ||
+                !Number.isSafeInteger(streamSize) ||
+                streamSize < 0 ||
+                streamSize > attachmentMaxBytes)
+                return inputValidationFailure("attachments[].size", "range", "Attachment stream size must be an integer from 0 through 52,428,800 bytes (50 MiB)");
+            source = { kind: "stream", stream };
+            size = streamSize;
+        }
+        else
+            return inputValidationFailure("attachments[]", "required", "Each new attachment must contain exactly one of data, file, or stream");
+        const acceptedContentType = metadata(field, id, metadataValues);
+        if (acceptedContentType instanceof InputValidationFailure)
+            return acceptedContentType;
+        const acceptedFilename = field("filename");
+        uploadedFilenames.push(acceptedFilename);
+        files.push({ id, filename: acceptedFilename, contentType: acceptedContentType, size, source });
+    }
+    return { metadata: metadataValues, files, uploadedFilenames };
+}
+/** False validates metadata without constructing a projection. The value true is the validation-only success marker */
+export function decodeAttachments(value, construct = true) {
+    if (value === undefined || value === null)
+        return construct ? Object.freeze([]) : true;
+    if (!Array.isArray(value))
+        return undefined;
+    const result = construct ? [] : undefined;
+    for (const item of value) {
+        if (!record(item) ||
+            !identifier(item.id) ||
+            typeof item.filename !== "string" ||
+            typeof item.size !== "number" ||
+            !Number.isSafeInteger(item.size) ||
+            item.size < 0 ||
+            typeof item.flags !== "number" ||
+            !Number.isSafeInteger(item.flags) ||
+            item.flags < 0)
+            return undefined;
+        const out = construct
+            ? {
+                id: item.id,
+                filename: item.filename,
+                size: item.size,
+                flags: item.flags,
+            }
+            : undefined;
+        for (const [key, wire] of Object.entries({
+            title: "title",
+            description: "description",
+            contentType: "content_type",
+            contentHash: "content_hash",
+            url: "url",
+            proxyUrl: "proxy_url",
+            placeholder: "placeholder",
+            waveform: "waveform",
+            expiresAt: "expires_at",
+        })) {
+            if (item[wire] == null)
+                continue;
+            if (typeof item[wire] !== "string")
+                return undefined;
+            if (out)
+                out[key] = item[wire];
+        }
+        for (const key of ["width", "height", "duration"]) {
+            if (item[key] == null)
+                continue;
+            if (typeof item[key] !== "number" ||
+                !Number.isInteger(item[key]) ||
+                item[key] < -2_147_483_648 ||
+                item[key] > 2_147_483_647)
+                return undefined;
+            if (out)
+                out[key] = item[key];
+        }
+        for (const key of ["nsfw", "expired"]) {
+            if (item[key] == null)
+                continue;
+            if (typeof item[key] !== "boolean")
+                return undefined;
+            if (out)
+                out[key] = item[key];
+        }
+        if (out)
+            result.push(Object.freeze(out));
+    }
+    return result ? Object.freeze(result) : true;
+}
+//# sourceMappingURL=attachments.js.map

package/dist/internal/attachments.js.map

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

package/dist/internal/audit-logs.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Audit-log reads: Page queries and the projection of audit entries, including gateway audit entries.
+ * Invariant: Reasons, options and changes are projected as provider data and never used as safe diagnostic text.
+ * Implements [SDK contracts: Delivery, requests and caches](/docs/SDK-CONTRACTS.md#delivery-requests-and-caches)
+ */
+import type { AuditLogEntry, AuditLogPage } from "#sdk/audit-logs";
+import { InputValidationFailure } from "#sdk/input-validation";
+import type { GuildRequest } from "./guilds.js";
+/** REST and gateway audit options share numeric and boolean types, with older string forms normalized here */
+export declare function decodeAuditLogEntry(value: unknown): AuditLogEntry | undefined;
+/** Builds a remote-only, filtered audit-log page request without cache admission or a provider-side consolidation write */
+export declare function auditLogPage(guildId: string, query?: unknown): GuildRequest<AuditLogPage> | InputValidationFailure;
+//# sourceMappingURL=audit-logs.d.ts.map

package/dist/internal/audit-logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-logs.d.ts","sourceRoot":"","sources":["../../src/internal/audit-logs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAIR,aAAa,EAEb,YAAY,EAGf,MAAM,iBAAiB,CAAA;AAKxB,OAAO,EAAE,sBAAsB,EAAiD,MAAM,uBAAuB,CAAA;AAC7G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAqI/C,8GAA8G;AAC9G,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,GAAG,SAAS,CA0B7E;AA8ID,2HAA2H;AAC3H,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,YAAY,CAAC,YAAY,CAAC,GAAG,sBAAsB,CAYlH"}