privage.js 0.21.0 → 0.22.0

package/README.md

@@ -205,6 +205,9 @@ which have no source message) or `interaction.reply(...)` — optionally after
 (`reply({ ..., ephemeral: true })`) are visible only to the interacting user
 and never persisted — great for confirmations and errors; valid for every
 kind. Selected values arrive on `interaction.values` (selects only).
+Replies can carry uploads — `reply({ files: [...] })`, same limits and
+`ATTACH_FILES` requirement as `client.send` (non-ephemeral only, no
+embeds/components alongside in v1).
 
 Limits: 5 rows/message; a row holds either ≤5 buttons or exactly one select
 (≤25 interactive components/message); label ≤80, `custom_id` ≤100 and unique

package/dist/rest.d.ts

@@ -119,11 +119,11 @@ export declare class Rest {
     /**
      * Respond to an interaction. `type`: 'update' (terminal — edit the
      * original message), 'reply' (terminal — post a reply; `data.ephemeral:
-     * true` for an only-you reply), 'defer' (extend the window; a terminal
-     * callback must follow), or 'modal' (open a modal — pending interactions
-     * only, once). Response: `{ success, message }` for update/reply (an
-     * ephemeral reply's `message` is a reduced, never-persisted object);
-     * defer/modal are 204s and resolve `null`.
+     * true` for an only-you reply, `data.files` for uploads), 'defer' (extend
+     * the window; a terminal callback must follow), or 'modal' (open a modal
+     * — pending interactions only, once). Response: `{ success, message }`
+     * for update/reply (an ephemeral reply's `message` is a reduced,
+     * never-persisted object); defer/modal are 204s and resolve `null`.
      */
     interactionCallback(interactionId: string, token: string, type: 'update' | 'reply' | 'defer' | 'modal', data?: object): Promise<any>;
     /** PUT /api/bots/commands — bulk overwrite the bot's slash commands (whole-or-400). Response: `{ success, commands }`. */

package/dist/rest.js

@@ -144,14 +144,48 @@ class Rest {
     /**
      * Respond to an interaction. `type`: 'update' (terminal — edit the
      * original message), 'reply' (terminal — post a reply; `data.ephemeral:
-     * true` for an only-you reply), 'defer' (extend the window; a terminal
-     * callback must follow), or 'modal' (open a modal — pending interactions
-     * only, once). Response: `{ success, message }` for update/reply (an
-     * ephemeral reply's `message` is a reduced, never-persisted object);
-     * defer/modal are 204s and resolve `null`.
+     * true` for an only-you reply, `data.files` for uploads), 'defer' (extend
+     * the window; a terminal callback must follow), or 'modal' (open a modal
+     * — pending interactions only, once). Response: `{ success, message }`
+     * for update/reply (an ephemeral reply's `message` is a reduced,
+     * never-persisted object); defer/modal are 204s and resolve `null`.
      */
-    interactionCallback(interactionId, token, type, data) {
-        return this.request(`/interactions/${interactionId}/${encodeURIComponent(token)}/callback`, { method: 'POST', body: data === undefined ? { type } : { type, data } });
+    async interactionCallback(interactionId, token, type, data) {
+        const path = `/interactions/${interactionId}/${encodeURIComponent(token)}/callback`;
+        const d = data;
+        if (d?.files?.length) {
+            // File replies upload as multipart; the server accepts them for
+            // non-ephemeral 'reply' only — fail loud and local on everything else.
+            if (type !== 'reply') {
+                throw new RangeError(`File attachments are only valid on reply callbacks (got '${type}').`);
+            }
+            if (d.ephemeral) {
+                throw new RangeError('Ephemeral replies cannot carry file attachments — nothing is persisted, so there is nowhere for the files to live.');
+            }
+            if (d.embeds?.length || d.components?.length) {
+                throw new RangeError('Attachments cannot be combined with embeds or components in one reply (v1) — send them separately.');
+            }
+            if (d.files.length > 10) {
+                throw new RangeError(`At most 10 attachments per reply (got ${d.files.length}).`);
+            }
+            const { files, ephemeral: _e, embeds: _em, components: _c, nonce, ...rest } = d;
+            const form = new FormData();
+            form.append('type', 'reply');
+            // Always carry a nonce: the server commits the message before the
+            // terminal state change, so a retried callback dedupes against it
+            // instead of inserting a second message.
+            form.append('data', JSON.stringify({ ...rest, nonce: nonce ?? (0, crypto_1.randomUUID)() }));
+            const parts = await (0, attachments_1.resolveFiles)(files);
+            for (const { blob, name } of parts) {
+                form.append('files', blob, name);
+            }
+            if (parts.some((p) => p.spoiler)) {
+                form.append('attachment_spoilers', JSON.stringify(parts.map((p) => p.spoiler)));
+            }
+            // Uploads get a longer budget than ordinary REST calls.
+            return this.request(path, { method: 'POST', body: form, timeoutMs: 60000 });
+        }
+        return this.request(path, { method: 'POST', body: data === undefined ? { type } : { type, data } });
     }
     /** PUT /api/bots/commands — bulk overwrite the bot's slash commands (whole-or-400). Response: `{ success, commands }`. */
     setCommands(commands) {

package/dist/structures/Interaction.d.ts

@@ -1,6 +1,7 @@
 import type { Client } from '../Client';
 import type { EmbedBuilder, Embed } from '../embeds';
 import type { ActionRow, ActionRowBuilder } from '../components';
+import type { AttachmentBuilder, AttachmentSource } from '../attachments';
 import { ModalBuilder, type Modal } from '../modals';
 /** Discriminates what the user did. Pre-v2 envelopes (no `kind`) read as `'button'`. */
 export type InteractionKind = 'button' | 'select' | 'command' | 'modal_submit';
@@ -15,11 +16,22 @@ export interface InteractionReplyData {
     /**
      * Only-you reply: never persisted, delivered as an event to the
      * interacting user alone ("Only you can see this"). Valid for every
-     * interaction kind. Still terminal.
+     * interaction kind. Still terminal. Cannot carry `files` (nothing is
+     * persisted, so there is nowhere for the bytes to live).
      */
     ephemeral?: boolean;
     /** Components on the reply — ephemeral replies only (they render, but aren't clickable v1). */
     components?: (ActionRow | ActionRowBuilder | Record<string, unknown>)[];
+    /**
+     * File attachments on the reply — `AttachmentBuilder`s, paths, raw bytes,
+     * or Blobs (max 10, 25 MB each). Non-ephemeral replies only; cannot be
+     * combined with `embeds` or `components` (v1). Uploads as multipart with
+     * an auto-generated `nonce`, so a retried callback never duplicates the
+     * message.
+     */
+    files?: (AttachmentBuilder | AttachmentSource)[];
+    /** Client-dedupe nonce — auto-generated for file replies when omitted. */
+    nonce?: string;
 }
 export type CommandOptionType = 'string' | 'integer' | 'number' | 'boolean' | 'user' | 'channel' | 'role';
 /** One resolved option of a slash-command invocation (already validated + coerced by the server). */
@@ -112,7 +124,8 @@ export declare class Interaction {
     /**
      * Terminal: post a bot message replying to the original (a plain channel
      * message for commands). Pass `{ ephemeral: true }` for an only-you reply
-     * that is never persisted.
+     * that is never persisted, or `{ files: [...] }` to attach uploads
+     * (non-ephemeral only; needs `ATTACH_FILES` in the channel).
      */
     reply(data: string | InteractionReplyData): Promise<any>;
     /**

package/dist/structures/Interaction.js

@@ -104,7 +104,8 @@ class Interaction {
     /**
      * Terminal: post a bot message replying to the original (a plain channel
      * message for commands). Pass `{ ephemeral: true }` for an only-you reply
-     * that is never persisted.
+     * that is never persisted, or `{ files: [...] }` to attach uploads
+     * (non-ephemeral only; needs `ATTACH_FILES` in the channel).
      */
     reply(data) {
         return this.transition('responded', () => this.client.rest.interactionCallback(this.id, this.token, 'reply', typeof data === 'string' ? { content: data } : data));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "privage.js",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "description": "Official SDK for building Privage bots.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",