aurival 0.3.0 → 0.4.0

package/dist/embeds.js

@@ -0,0 +1,308 @@
+/**
+ * Discord-shaped `Embed` and `Button` builders (AMENDMENT-05). Mirrors
+ * python's builders field for field; the wire shape and every cap sentence
+ * are contractual (`caps.ts`) and must not drift between the two SDKs.
+ *
+ * Two ways in: a builder chain (`new Embed().addField(...)`), validated as
+ * each piece is added, or a plain object literal, accepted anywhere a
+ * builder is (the way `mentions` already accepts a raw `{ user }`) and
+ * validated to the exact same sentences by `serialiseEmbeds`/
+ * `serialiseButtons` before it ever reaches the wire — a plain object is
+ * never a bypass.
+ *
+ * Decoding off the wire (`fromJSON`, used by `embedsFromWire`/
+ * `buttonsFromWire` in events.ts) is deliberately tolerant and never
+ * throws — the caps are an outbound (client -> server) contract, not an
+ * inbound one, and a message already stored by the server is assumed valid.
+ */
+import { BUTTON_STYLES, CAP_BAD_BUTTON_STYLE, CAP_BUTTON_ID_TOO_LONG, CAP_DESCRIPTION_TOO_LONG, CAP_DUPLICATE_BUTTON_ID, CAP_IMAGE_URL_NOT_HTTPS, CAP_LABEL_TOO_LONG, CAP_LINK_STYLE_DEFERRED, CAP_TITLE_TOO_LONG, CAP_TOO_MANY_BUTTONS, CAP_TOO_MANY_EMBEDS, CAP_TOO_MANY_FIELDS, MAX_BUTTON_ID_LENGTH, MAX_BUTTONS, MAX_DESCRIPTION_LENGTH, MAX_EMBED_FIELDS, MAX_EMBEDS, MAX_LABEL_RUNES, MAX_TITLE_LENGTH, } from './caps.js';
+function asRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value)
+        ? value
+        : null;
+}
+function asOptionalString(value) {
+    return typeof value === 'string' ? value : undefined;
+}
+function graphemeLength(text) {
+    return [...text].length;
+}
+function requireHttps(url) {
+    if (!url.startsWith('https://'))
+        throw new Error(CAP_IMAGE_URL_NOT_HTTPS);
+}
+/**
+ * `Embed().addField(...)` builder. Every mutation is validated immediately
+ * (the cap sentence, thrown as a plain `Error`); `toJSON()` emits the wire
+ * shape, omitting absent keys and omitting `fields` when empty.
+ */
+export class Embed {
+    title;
+    description;
+    color;
+    author;
+    thumbnail;
+    image;
+    fields = [];
+    footer;
+    timestamp;
+    #extra = {};
+    constructor(init = {}) {
+        if (init.title !== undefined) {
+            if (init.title.length > MAX_TITLE_LENGTH)
+                throw new Error(CAP_TITLE_TOO_LONG);
+            this.title = init.title;
+        }
+        if (init.description !== undefined) {
+            if (init.description.length > MAX_DESCRIPTION_LENGTH) {
+                throw new Error(CAP_DESCRIPTION_TOO_LONG);
+            }
+            this.description = init.description;
+        }
+        if (init.color !== undefined)
+            this.color = init.color;
+    }
+    /** Refuses the 7th field on ONE embed — the whole-message cap (summed across embeds) is enforced by `serialiseEmbeds`. */
+    addField(name, value, inline = false) {
+        if (this.fields.length >= MAX_EMBED_FIELDS)
+            throw new Error(CAP_TOO_MANY_FIELDS);
+        this.fields.push({ name, value, inline });
+        return this;
+    }
+    setAuthor(name, icon) {
+        if (icon !== undefined) {
+            requireHttps(icon);
+            this.author = { name, icon };
+        }
+        else {
+            this.author = { name };
+        }
+        return this;
+    }
+    setThumbnail(url) {
+        requireHttps(url);
+        this.thumbnail = { url };
+        return this;
+    }
+    setImage(url) {
+        requireHttps(url);
+        this.image = { url };
+        return this;
+    }
+    setFooter(text) {
+        this.footer = { text };
+        return this;
+    }
+    /** A `Date` becomes UTC RFC3339 (`Z`); a string is assumed already in that form. */
+    setTimestamp(value) {
+        this.timestamp = value instanceof Date ? value.toISOString() : value;
+        return this;
+    }
+    toJSON() {
+        const out = { ...this.#extra };
+        if (this.title !== undefined)
+            out['title'] = this.title;
+        if (this.description !== undefined)
+            out['description'] = this.description;
+        if (this.color !== undefined)
+            out['color'] = this.color;
+        if (this.author !== undefined)
+            out['author'] = this.author;
+        if (this.thumbnail !== undefined)
+            out['thumbnail'] = this.thumbnail;
+        if (this.image !== undefined)
+            out['image'] = this.image;
+        if (this.fields.length > 0)
+            out['fields'] = this.fields;
+        if (this.footer !== undefined)
+            out['footer'] = this.footer;
+        if (this.timestamp !== undefined)
+            out['timestamp'] = this.timestamp;
+        return out;
+    }
+    /**
+     * Tolerant decode — never throws, never validates. Used both for wire
+     * messages (already server-validated) and to normalise a plain object
+     * literal before `serialiseEmbeds` validates it for real. Unknown
+     * top-level keys are preserved so a round trip is lossless.
+     */
+    static fromJSON(data) {
+        const record = asRecord(data) ?? {};
+        const { title, description, color, author, thumbnail, image, fields, footer, timestamp, ...rest } = record;
+        const embed = new Embed();
+        const titleStr = asOptionalString(title);
+        if (titleStr !== undefined)
+            embed.title = titleStr;
+        const descriptionStr = asOptionalString(description);
+        if (descriptionStr !== undefined)
+            embed.description = descriptionStr;
+        const colorStr = asOptionalString(color);
+        if (colorStr !== undefined)
+            embed.color = colorStr;
+        const authorRecord = asRecord(author);
+        if (authorRecord) {
+            const name = asOptionalString(authorRecord['name']) ?? '';
+            const icon = asOptionalString(authorRecord['icon']);
+            embed.author = icon !== undefined ? { name, icon } : { name };
+        }
+        const thumbnailRecord = asRecord(thumbnail);
+        const thumbnailUrl = thumbnailRecord ? asOptionalString(thumbnailRecord['url']) : undefined;
+        if (thumbnailUrl !== undefined)
+            embed.thumbnail = { url: thumbnailUrl };
+        const imageRecord = asRecord(image);
+        const imageUrl = imageRecord ? asOptionalString(imageRecord['url']) : undefined;
+        if (imageUrl !== undefined)
+            embed.image = { url: imageUrl };
+        const footerRecord = asRecord(footer);
+        const footerText = footerRecord ? asOptionalString(footerRecord['text']) : undefined;
+        if (footerText !== undefined)
+            embed.footer = { text: footerText };
+        const timestampStr = asOptionalString(timestamp);
+        if (timestampStr !== undefined)
+            embed.timestamp = timestampStr;
+        if (Array.isArray(fields)) {
+            for (const raw of fields) {
+                const fieldRecord = asRecord(raw);
+                if (!fieldRecord)
+                    continue;
+                embed.fields.push({
+                    name: asOptionalString(fieldRecord['name']) ?? '',
+                    value: asOptionalString(fieldRecord['value']) ?? '',
+                    inline: fieldRecord['inline'] === true,
+                });
+            }
+        }
+        embed.#extra = rest;
+        return embed;
+    }
+}
+/** Every cap `serialiseEmbeds` enforces on one already-decoded `Embed`, whichever path built it. */
+function validateEmbedShape(embed) {
+    if (embed.title !== undefined && embed.title.length > MAX_TITLE_LENGTH) {
+        throw new Error(CAP_TITLE_TOO_LONG);
+    }
+    if (embed.description !== undefined && embed.description.length > MAX_DESCRIPTION_LENGTH) {
+        throw new Error(CAP_DESCRIPTION_TOO_LONG);
+    }
+    if (embed.author?.icon !== undefined && !embed.author.icon.startsWith('https://')) {
+        throw new Error(CAP_IMAGE_URL_NOT_HTTPS);
+    }
+    if (embed.thumbnail !== undefined && !embed.thumbnail.url.startsWith('https://')) {
+        throw new Error(CAP_IMAGE_URL_NOT_HTTPS);
+    }
+    if (embed.image !== undefined && !embed.image.url.startsWith('https://')) {
+        throw new Error(CAP_IMAGE_URL_NOT_HTTPS);
+    }
+    if (embed.fields.length > MAX_EMBED_FIELDS)
+        throw new Error(CAP_TOO_MANY_FIELDS);
+}
+function slugify(label) {
+    const slug = label
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    return slug.length > MAX_BUTTON_ID_LENGTH
+        ? slug.slice(0, MAX_BUTTON_ID_LENGTH).replace(/-+$/g, '')
+        : slug;
+}
+function validateButtonShape(button) {
+    if (graphemeLength(button.label) > MAX_LABEL_RUNES)
+        throw new Error(CAP_LABEL_TOO_LONG);
+    if (button.id.length > MAX_BUTTON_ID_LENGTH)
+        throw new Error(CAP_BUTTON_ID_TOO_LONG);
+    if (button.style === 'link')
+        throw new Error(CAP_LINK_STYLE_DEFERRED);
+    if (!BUTTON_STYLES.includes(button.style)) {
+        throw new Error(CAP_BAD_BUTTON_STYLE);
+    }
+}
+/** `new Button({ label: 'Pacific' })` — `id` defaults to a slug of `label`, `style` defaults to `'primary'`. */
+export class Button {
+    label;
+    id;
+    style;
+    constructor(init) {
+        this.label = init.label;
+        this.style = init.style ?? 'primary';
+        this.id = init.id ?? slugify(init.label);
+        validateButtonShape(this);
+    }
+    toJSON() {
+        return { id: this.id, label: this.label, style: this.style };
+    }
+    /** Tolerant decode — never throws. See `Embed.fromJSON` for why. */
+    static fromJSON(data) {
+        const record = asRecord(data) ?? {};
+        const label = asOptionalString(record['label']) ?? '';
+        const id = asOptionalString(record['id']);
+        const style = asOptionalString(record['style']);
+        const button = Object.create(Button.prototype);
+        button.label = label;
+        button.style = style ?? 'primary';
+        button.id = id ?? slugify(label);
+        return button;
+    }
+}
+/** `null` for both an absent key and a JSON `null` — a message's `button_used` is never `undefined`. */
+export function buttonUsedFromWire(value) {
+    const record = asRecord(value);
+    if (!record)
+        return null;
+    return {
+        button: asOptionalString(record['button']) ?? '',
+        user: asOptionalString(record['user']) ?? '',
+        at: asOptionalString(record['at']) ?? '',
+    };
+}
+/** `[]` for both an absent key and a JSON `null` — `Message.embeds` is never `null`/`undefined`. */
+export function embedsFromWire(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.map((entry) => Embed.fromJSON(entry));
+}
+/** `[]` for both an absent key and a JSON `null` — `Message.buttons` is never `null`/`undefined`. */
+export function buttonsFromWire(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.map((entry) => Button.fromJSON(entry));
+}
+/**
+ * Validates and serialises the `embeds` a caller passed to `send`/`reply`,
+ * to shape (a). A plain object literal is decoded (tolerant) then validated
+ * exactly as a builder is — never a bypass. `[]` when `embeds` is absent or
+ * empty, so the caller omits the key.
+ */
+export function serialiseEmbeds(embeds) {
+    if (embeds === undefined || embeds.length === 0)
+        return [];
+    if (embeds.length > MAX_EMBEDS)
+        throw new Error(CAP_TOO_MANY_EMBEDS);
+    const normalised = embeds.map((entry) => entry instanceof Embed ? entry : Embed.fromJSON(entry));
+    for (const embed of normalised)
+        validateEmbedShape(embed);
+    const totalFields = normalised.reduce((sum, embed) => sum + embed.fields.length, 0);
+    if (totalFields > MAX_EMBED_FIELDS)
+        throw new Error(CAP_TOO_MANY_FIELDS);
+    return normalised.map((embed) => embed.toJSON());
+}
+/**
+ * Validates and serialises the `buttons` a caller passed to `send`/`reply`.
+ * `[]` when `buttons` is absent or empty, so the caller omits the key.
+ */
+export function serialiseButtons(buttons) {
+    if (buttons === undefined || buttons.length === 0)
+        return [];
+    if (buttons.length > MAX_BUTTONS)
+        throw new Error(CAP_TOO_MANY_BUTTONS);
+    const normalised = buttons.map((entry) => entry instanceof Button ? entry : Button.fromJSON(entry));
+    for (const button of normalised)
+        validateButtonShape(button);
+    const seen = new Set();
+    for (const button of normalised) {
+        if (seen.has(button.id))
+            throw new Error(CAP_DUPLICATE_BUTTON_ID);
+        seen.add(button.id);
+    }
+    return normalised.map((button) => button.toJSON());
+}
+//# sourceMappingURL=embeds.js.map

package/dist/embeds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeds.js","sourceRoot":"","sources":["../src/embeds.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,WAAW,EACX,sBAAsB,EACtB,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAEnB,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACzE,CAAC,CAAE,KAAiC;QACpC,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,MAAM,CAAC;AAC1B,CAAC;AAED,SAAS,YAAY,CAAC,GAAW;IAC/B,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;AAC5E,CAAC;AA+BD;;;;GAIG;AACH,MAAM,OAAO,KAAK;IAChB,KAAK,CAAU;IACf,WAAW,CAAU;IACrB,KAAK,CAAU;IACf,MAAM,CAAoB;IAC1B,SAAS,CAAuB;IAChC,KAAK,CAAmB;IACxB,MAAM,GAAsB,EAAE,CAAC;IAC/B,MAAM,CAAoB;IAC1B,SAAS,CAAU;IACnB,MAAM,GAA4B,EAAE,CAAC;IAErC,YAAY,IAAI,GAAc,EAAE;QAC9B,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC7B,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,gBAAgB;gBAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;YAC9E,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QAC1B,CAAC;QACD,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACnC,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,sBAAsB,EAAE,CAAC;gBACrD,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;YAC5C,CAAC;YACD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACtC,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACxD,CAAC;IAED,0HAA0H;IAC1H,QAAQ,CAAC,IAAY,EAAE,KAAa,EAAE,MAAM,GAAG,KAAK;QAClD,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,gBAAgB;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACjF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,SAAS,CAAC,IAAY,EAAE,IAAa;QACnC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,YAAY,CAAC,IAAI,CAAC,CAAC;YACnB,IAAI,CAAC,MAAM,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,GAAG,EAAE,IAAI,EAAE,CAAC;QACzB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,YAAY,CAAC,GAAW;QACtB,YAAY,CAAC,GAAG,CAAC,CAAC;QAClB,IAAI,CAAC,SAAS,GAAG,EAAE,GAAG,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,QAAQ,CAAC,GAAW;QAClB,YAAY,CAAC,GAAG,CAAC,CAAC;QAClB,IAAI,CAAC,KAAK,GAAG,EAAE,GAAG,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,SAAS,CAAC,IAAY;QACpB,IAAI,CAAC,MAAM,GAAG,EAAE,IAAI,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oFAAoF;IACpF,YAAY,CAAC,KAAoB;QAC/B,IAAI,CAAC,SAAS,GAAG,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QACrE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM;QACJ,MAAM,GAAG,GAA4B,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACxD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;QACxD,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;YAAE,GAAG,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC;QAC1E,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;QACxD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3D,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;YAAE,GAAG,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;QACpE,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;QACxD,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;QACxD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3D,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;YAAE,GAAG,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;QACpE,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAa;QAC3B,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACpC,MAAM,EACJ,KAAK,EACL,WAAW,EACX,KAAK,EACL,MAAM,EACN,SAAS,EACT,KAAK,EACL,MAAM,EACN,MAAM,EACN,SAAS,EACT,GAAG,IAAI,EACR,GAAG,MAAM,CAAC;QAEX,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,QAAQ,KAAK,SAAS;YAAE,KAAK,CAAC,KAAK,GAAG,QAAQ,CAAC;QACnD,MAAM,cAAc,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;QACrD,IAAI,cAAc,KAAK,SAAS;YAAE,KAAK,CAAC,WAAW,GAAG,cAAc,CAAC;QACrE,MAAM,QAAQ,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,QAAQ,KAAK,SAAS;YAAE,KAAK,CAAC,KAAK,GAAG,QAAQ,CAAC;QAEnD,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,gBAAgB,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;YAC1D,MAAM,IAAI,GAAG,gBAAgB,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;YACpD,KAAK,CAAC,MAAM,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QAChE,CAAC;QAED,MAAM,eAAe,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC5C,MAAM,YAAY,GAAG,eAAe,CAAC,CAAC,CAAC,gBAAgB,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5F,IAAI,YAAY,KAAK,SAAS;YAAE,KAAK,CAAC,SAAS,GAAG,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC;QAExE,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,gBAAgB,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAChF,IAAI,QAAQ,KAAK,SAAS;YAAE,KAAK,CAAC,KAAK,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;QAE5D,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,UAAU,GAAG,YAAY,CAAC,CAAC,CAAC,gBAAgB,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACrF,IAAI,UAAU,KAAK,SAAS;YAAE,KAAK,CAAC,MAAM,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;QAElE,MAAM,YAAY,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;QACjD,IAAI,YAAY,KAAK,SAAS;YAAE,KAAK,CAAC,SAAS,GAAG,YAAY,CAAC;QAE/D,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;gBACzB,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;gBAClC,IAAI,CAAC,WAAW;oBAAE,SAAS;gBAC3B,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC;oBAChB,IAAI,EAAE,gBAAgB,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE;oBACjD,KAAK,EAAE,gBAAgB,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE;oBACnD,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,KAAK,IAAI;iBACvC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;QACpB,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED,oGAAoG;AACpG,SAAS,kBAAkB,CAAC,KAAY;IACtC,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,gBAAgB,EAAE,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,sBAAsB,EAAE,CAAC;QACzF,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC5C,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAClF,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACjF,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,gBAAgB;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;AACnF,CAAC;AAQD,SAAS,OAAO,CAAC,KAAa;IAC5B,MAAM,IAAI,GAAG,KAAK;SACf,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC3B,OAAO,IAAI,CAAC,MAAM,GAAG,oBAAoB;QACvC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QACzD,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAc;IACzC,IAAI,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,eAAe;QAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACxF,IAAI,MAAM,CAAC,EAAE,CAAC,MAAM,GAAG,oBAAoB;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACrF,IAAI,MAAM,CAAC,KAAK,KAAK,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACtE,IAAI,CAAE,aAAmC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACxC,CAAC;AACH,CAAC;AAED,gHAAgH;AAChH,MAAM,OAAO,MAAM;IACjB,KAAK,CAAS;IACd,EAAE,CAAS;IACX,KAAK,CAAS;IAEd,YAAY,IAAgB;QAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,SAAS,CAAC;QACrC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzC,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,MAAM;QACJ,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;IAC/D,CAAC;IAED,oEAAoE;IACpE,MAAM,CAAC,QAAQ,CAAC,IAAa;QAC3B,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QACtD,MAAM,EAAE,GAAG,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1C,MAAM,KAAK,GAAG,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAW,CAAC;QACzD,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;QACrB,MAAM,CAAC,KAAK,GAAG,KAAK,IAAI,SAAS,CAAC;QAClC,MAAM,CAAC,EAAE,GAAG,EAAE,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC;QACjC,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAQD,wGAAwG;AACxG,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO;QACL,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE;QAChD,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE;QAC5C,EAAE,EAAE,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE;KACzC,CAAC;AACJ,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AACtD,CAAC;AAKD;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,MAA4C;IAE5C,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC3D,IAAI,MAAM,CAAC,MAAM,GAAG,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACrE,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CACtC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CACvD,CAAC;IACF,KAAK,MAAM,KAAK,IAAI,UAAU;QAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAC1D,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACpF,IAAI,WAAW,GAAG,gBAAgB;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACzE,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAA8C;IAE9C,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC7D,IAAI,OAAO,CAAC,MAAM,GAAG,WAAW;QAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACxE,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CACvC,KAAK,YAAY,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CACzD,CAAC;IACF,KAAK,MAAM,MAAM,IAAI,UAAU;QAAE,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC7D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;QAChC,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAClE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;AACrD,CAAC"}

package/dist/errors.d.ts

@@ -132,6 +132,57 @@ export declare class BotPlaygroundOnly extends PermissionDeniedError {
 /** `message_not_yours` — 403, `edit()`/`delete()` only work on the bot's own messages. */
 export declare class MessageNotYours extends PermissionDeniedError {
 }
+/** `too_many_embeds` — a message carries more than `MAX_EMBEDS` embeds. */
+export declare class TooManyEmbeds extends InvalidRequestError {
+}
+/** `too_many_embed_fields` — one embed carries more than `MAX_EMBED_FIELDS` fields. */
+export declare class TooManyEmbedFields extends InvalidRequestError {
+}
+/** `too_many_buttons` — a message carries more than `MAX_BUTTONS` buttons. */
+export declare class TooManyButtons extends InvalidRequestError {
+}
+/** `button_missing_field` — a button is missing a field it needs to be rendered or pressed. */
+export declare class ButtonMissingField extends InvalidRequestError {
+}
+/** `button_id_too_long` — a button id is longer than `MAX_BUTTON_ID_LENGTH`. */
+export declare class ButtonIDTooLong extends InvalidRequestError {
+}
+/** `duplicate_button_id` — two buttons in the same message share an id. Button ids must be unique within a message. */
+export declare class DuplicateButtonID extends InvalidRequestError {
+}
+/** `button_label_too_long` — a button label is longer than `MAX_LABEL_RUNES`. */
+export declare class ButtonLabelTooLong extends InvalidRequestError {
+}
+/** `link_button_not_supported` — link-style buttons are not supported in v1. */
+export declare class LinkButtonNotSupported extends InvalidRequestError {
+}
+/** `invalid_button_style` — a button's style is not one of `BUTTON_STYLES`. */
+export declare class InvalidButtonStyle extends InvalidRequestError {
+}
+/** `embed_title_too_long` — an embed title is longer than `MAX_TITLE_LENGTH`. */
+export declare class EmbedTitleTooLong extends InvalidRequestError {
+}
+/** `embed_description_too_long` — an embed description is longer than `MAX_DESCRIPTION_LENGTH`. */
+export declare class EmbedDescriptionTooLong extends InvalidRequestError {
+}
+/** `embed_url_not_https` — an embed image url does not start with `https://`. */
+export declare class EmbedURLNotHTTPS extends InvalidRequestError {
+}
+/**
+ * `embed_empty` — an embed carries none of a title, a description, a field or
+ * a footer. A colour on its own is a coloured rectangle, not a message.
+ */
+export declare class EmbedEmpty extends InvalidRequestError {
+}
+/** `buttons_without_message` — buttons were sent with nothing under them. Send text, embeds, or both alongside them. */
+export declare class ButtonsWithoutMessage extends InvalidRequestError {
+}
+/**
+ * `button_already_used` — a row of actions is spent once a button on it has
+ * been pressed; send a new message for another press.
+ */
+export declare class ButtonAlreadyUsed extends InvalidRequestError {
+}
 export declare class RateLimited extends RateLimitError {
 }
 export declare class PairRateLimited extends RateLimitError {

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,2CAA2C;AAC3C,qBAAa,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,4EAA4E;AAC5E,qBAAa,cAAe,SAAQ,YAAY;CAAG;AAEnD,4EAA4E;AAC5E,qBAAa,aAAc,SAAQ,YAAY;CAAG;AAElD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,2EAA2E;AAC3E,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B,YAAY,IAAI,EAAE,mBAAmB,EAQpC;CACF;AAID,4DAA4D;AAC5D,qBAAa,mBAAoB,SAAQ,eAAe;CAAG;AAE3D,0DAA0D;AAC1D,qBAAa,mBAAoB,SAAQ,eAAe;CAAG;AAE3D,6CAA6C;AAC7C,qBAAa,qBAAsB,SAAQ,eAAe;CAAG;AAE7D,sDAAsD;AACtD,qBAAa,cAAe,SAAQ,eAAe;CAAG;AAEtD,wDAAwD;AACxD,qBAAa,QAAS,SAAQ,eAAe;CAAG;AAIhD,qBAAa,kBAAmB,SAAQ,mBAAmB;CAAG;AAC9D,qBAAa,kBAAmB,SAAQ,mBAAmB;CAAG;AAC9D,qBAAa,UAAW,SAAQ,mBAAmB;CAAG;AACtD,qBAAa,YAAa,SAAQ,mBAAmB;CAAG;AACxD,qBAAa,gBAAiB,SAAQ,mBAAmB;CAAG;AAC5D,qBAAa,eAAgB,SAAQ,mBAAmB;CAAG;AAC3D,qBAAa,QAAS,SAAQ,mBAAmB;CAAG;AACpD,qBAAa,YAAa,SAAQ,mBAAmB;CAAG;AACxD,qBAAa,gBAAiB,SAAQ,mBAAmB;CAAG;AAE5D,qBAAa,QAAS,SAAQ,mBAAmB;CAAG;AACpD,qBAAa,kBAAmB,SAAQ,mBAAmB;CAAG;AAC9D,qBAAa,SAAU,SAAQ,mBAAmB;CAAG;AACrD,qBAAa,WAAY,SAAQ,mBAAmB;CAAG;AACvD,qBAAa,WAAY,SAAQ,mBAAmB;CAAG;AACvD,qBAAa,gBAAiB,SAAQ,mBAAmB;CAAG;AAC5D,qBAAa,gBAAiB,SAAQ,mBAAmB;CAAG;AAC5D,qBAAa,gBAAiB,SAAQ,mBAAmB;CAAG;AAC5D,qBAAa,oBAAqB,SAAQ,mBAAmB;CAAG;AAChE,qBAAa,qBAAsB,SAAQ,mBAAmB;CAAG;AACjE,qBAAa,iBAAkB,SAAQ,mBAAmB;CAAG;AAC7D,qBAAa,iBAAkB,SAAQ,mBAAmB;CAAG;AAC7D,qBAAa,aAAc,SAAQ,mBAAmB;CAAG;AACzD,qBAAa,YAAa,SAAQ,mBAAmB;CAAG;AACxD,qBAAa,gBAAiB,SAAQ,mBAAmB;CAAG;AAC5D,qBAAa,eAAgB,SAAQ,mBAAmB;CAAG;AAE3D;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,mBAAmB;CAAG;AAE3D;;;;;GAKG;AACH,qBAAa,oBAAqB,SAAQ,mBAAmB;CAAG;AAEhE;;;;;;GAMG;AACH,qBAAa,gBAAiB,SAAQ,mBAAmB;CAAG;AAE5D,yFAAyF;AACzF,qBAAa,mBAAoB,SAAQ,mBAAmB;CAAG;AAE/D,qBAAa,YAAa,SAAQ,qBAAqB;CAAG;AAC1D,qBAAa,iBAAkB,SAAQ,qBAAqB;CAAG;AAE/D,0FAA0F;AAC1F,qBAAa,eAAgB,SAAQ,qBAAqB;CAAG;AAM7D,2EAA2E;AAC3E,qBAAa,aAAc,SAAQ,mBAAmB;CAAG;AAEzD,uFAAuF;AACvF,qBAAa,kBAAmB,SAAQ,mBAAmB;CAAG;AAE9D,8EAA8E;AAC9E,qBAAa,cAAe,SAAQ,mBAAmB;CAAG;AAE1D,+FAA+F;AAC/F,qBAAa,kBAAmB,SAAQ,mBAAmB;CAAG;AAE9D,gFAAgF;AAChF,qBAAa,eAAgB,SAAQ,mBAAmB;CAAG;AAE3D,uHAAuH;AACvH,qBAAa,iBAAkB,SAAQ,mBAAmB;CAAG;AAE7D,iFAAiF;AACjF,qBAAa,kBAAmB,SAAQ,mBAAmB;CAAG;AAE9D,gFAAgF;AAChF,qBAAa,sBAAuB,SAAQ,mBAAmB;CAAG;AAElE,+EAA+E;AAC/E,qBAAa,kBAAmB,SAAQ,mBAAmB;CAAG;AAE9D,iFAAiF;AACjF,qBAAa,iBAAkB,SAAQ,mBAAmB;CAAG;AAE7D,mGAAmG;AACnG,qBAAa,uBAAwB,SAAQ,mBAAmB;CAAG;AAEnE,iFAAiF;AACjF,qBAAa,gBAAiB,SAAQ,mBAAmB;CAAG;AAE5D;;;GAGG;AACH,qBAAa,UAAW,SAAQ,mBAAmB;CAAG;AAEtD,wHAAwH;AACxH,qBAAa,qBAAsB,SAAQ,mBAAmB;CAAG;AAEjE;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,mBAAmB;CAAG;AAE7D,qBAAa,WAAY,SAAQ,cAAc;CAAG;AAClD,qBAAa,eAAgB,SAAQ,cAAc;CAAG;AACtD,qBAAa,eAAgB,SAAQ,cAAc;CAAG;AAEtD,qBAAa,aAAc,SAAQ,QAAQ;CAAG;AAC9C,qBAAa,gBAAiB,SAAQ,QAAQ;CAAG;AACjD,qBAAa,WAAY,SAAQ,QAAQ;CAAG;AAE5C,eAAO,MAAM,cAAc,0CAA0C,CAAC;AAEtE,MAAM,MAAM,oBAAoB,GAAG,KAAK,IAAI,EAAE,mBAAmB,KAAK,eAAe,CAAC;AAEtF,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAMvE,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAsDvE,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAYD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,GAAE,mBAAwB,GAChC,eAAe,CAoBjB"}

package/dist/errors.js

@@ -136,6 +136,60 @@ export class BotPlaygroundOnly extends PermissionDeniedError {
 /** `message_not_yours` — 403, `edit()`/`delete()` only work on the bot's own messages. */
 export class MessageNotYours extends PermissionDeniedError {
 }
+// AMENDMENT-05 §2. The card's caps and per-field refusals — every one a 400,
+// and every sentence quotes card.go's CapTemplate* constants (mirrored in
+// caps.ts) so a cap cannot move in the validator without moving here too.
+/** `too_many_embeds` — a message carries more than `MAX_EMBEDS` embeds. */
+export class TooManyEmbeds extends InvalidRequestError {
+}
+/** `too_many_embed_fields` — one embed carries more than `MAX_EMBED_FIELDS` fields. */
+export class TooManyEmbedFields extends InvalidRequestError {
+}
+/** `too_many_buttons` — a message carries more than `MAX_BUTTONS` buttons. */
+export class TooManyButtons extends InvalidRequestError {
+}
+/** `button_missing_field` — a button is missing a field it needs to be rendered or pressed. */
+export class ButtonMissingField extends InvalidRequestError {
+}
+/** `button_id_too_long` — a button id is longer than `MAX_BUTTON_ID_LENGTH`. */
+export class ButtonIDTooLong extends InvalidRequestError {
+}
+/** `duplicate_button_id` — two buttons in the same message share an id. Button ids must be unique within a message. */
+export class DuplicateButtonID extends InvalidRequestError {
+}
+/** `button_label_too_long` — a button label is longer than `MAX_LABEL_RUNES`. */
+export class ButtonLabelTooLong extends InvalidRequestError {
+}
+/** `link_button_not_supported` — link-style buttons are not supported in v1. */
+export class LinkButtonNotSupported extends InvalidRequestError {
+}
+/** `invalid_button_style` — a button's style is not one of `BUTTON_STYLES`. */
+export class InvalidButtonStyle extends InvalidRequestError {
+}
+/** `embed_title_too_long` — an embed title is longer than `MAX_TITLE_LENGTH`. */
+export class EmbedTitleTooLong extends InvalidRequestError {
+}
+/** `embed_description_too_long` — an embed description is longer than `MAX_DESCRIPTION_LENGTH`. */
+export class EmbedDescriptionTooLong extends InvalidRequestError {
+}
+/** `embed_url_not_https` — an embed image url does not start with `https://`. */
+export class EmbedURLNotHTTPS extends InvalidRequestError {
+}
+/**
+ * `embed_empty` — an embed carries none of a title, a description, a field or
+ * a footer. A colour on its own is a coloured rectangle, not a message.
+ */
+export class EmbedEmpty extends InvalidRequestError {
+}
+/** `buttons_without_message` — buttons were sent with nothing under them. Send text, embeds, or both alongside them. */
+export class ButtonsWithoutMessage extends InvalidRequestError {
+}
+/**
+ * `button_already_used` — a row of actions is spent once a button on it has
+ * been pressed; send a new message for another press.
+ */
+export class ButtonAlreadyUsed extends InvalidRequestError {
+}
 export class RateLimited extends RateLimitError {
 }
 export class PairRateLimited extends RateLimitError {
@@ -195,6 +249,21 @@ export const CODE_CLASSES = {
     mention_not_member: MentionNotMember,
     mention_token_missing: MentionTokenMissing,
     message_not_yours: MessageNotYours,
+    too_many_embeds: TooManyEmbeds,
+    too_many_embed_fields: TooManyEmbedFields,
+    too_many_buttons: TooManyButtons,
+    button_missing_field: ButtonMissingField,
+    button_id_too_long: ButtonIDTooLong,
+    duplicate_button_id: DuplicateButtonID,
+    button_label_too_long: ButtonLabelTooLong,
+    link_button_not_supported: LinkButtonNotSupported,
+    invalid_button_style: InvalidButtonStyle,
+    embed_title_too_long: EmbedTitleTooLong,
+    embed_description_too_long: EmbedDescriptionTooLong,
+    embed_url_not_https: EmbedURLNotHTTPS,
+    embed_empty: EmbedEmpty,
+    buttons_without_message: ButtonsWithoutMessage,
+    button_already_used: ButtonAlreadyUsed,
 };
 function asString(value) {
     return typeof value === 'string' ? value : null;

package/dist/errors.js.map

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

package/dist/events.d.ts

@@ -10,6 +10,7 @@
  * holds an `HttpClient` for its actions and nothing else network-shaped —
  * never the seed, a token, or the `Auth` object (SDK-33).
  */
+import type { Button, ButtonLike, ButtonUsed, Embed, EmbedLike } from './embeds.js';
 import type { HttpClient } from './http.js';
 export interface User {
     id: string;
@@ -48,6 +49,12 @@ export interface Message {
     sent_at: string;
     sender: User | null;
     reply_to: string | null;
+    /** `[]` when the wire omits the key or sends `null` (AMENDMENT-05 §3) — never `null`/`undefined`. */
+    embeds: Embed[];
+    /** `[]` when the wire omits the key or sends `null` — never `null`/`undefined`. */
+    buttons: Button[];
+    /** `null` when the wire omits the key, sends `null`, or the message never carried a button. */
+    button_used: ButtonUsed | null;
 }
 export interface EventInit {
     id: string;
@@ -87,6 +94,15 @@ export declare function mention(user: User): Mention;
 export type MentionLike = Mention | User | {
     user: string;
 };
+/** What `reply()` takes besides the text: the card to hang on the message. */
+export interface ReplyOptions {
+    embeds?: ReadonlyArray<EmbedLike>;
+    buttons?: ReadonlyArray<ButtonLike>;
+}
+/** `send()` takes the same, plus who the `@handle` tokens in `text` point at. */
+export interface SendOptions extends ReplyOptions {
+    mentions?: MentionLike[];
+}
 /**
  * One page of `GET /v1/chats/{chat}/members` (CONTRACT-V1 §4, §5.0.1). No
  * auto-loading iterator. `MemberPage` is SDK-constructed — decoded from the
@@ -113,8 +129,10 @@ export type MemberEventType = 'member.joined' | 'member.left';
 export type BotEventType = 'bot.added' | 'bot.removed';
 /** `reaction.added` — on one of this bot's own messages. There is no `reaction.removed`. */
 export type ReactionEventType = 'reaction.added';
+/** `button.pressed` — someone pressed a button on one of this bot's own messages (AMENDMENT-05). */
+export type ButtonEventType = 'button.pressed';
 /** Every event type `bot.on()` names. `command.invoked` goes through `bot.command()`. */
-export type EventType = MemberEventType | BotEventType | ReactionEventType;
+export type EventType = MemberEventType | BotEventType | ReactionEventType | ButtonEventType;
 interface BaseInit {
     chat: Chat;
     event: Event;
@@ -142,16 +160,17 @@ export declare class BaseContext {
      * `HttpClient.request` itself. When the event carried no message id the
      * `reply_to` field is omitted and the reply floats free.
      */
-    reply(text: string): Promise<Message>;
+    reply(text: string, options?: ReplyOptions): Promise<Message>;
+    reply(options: ReplyOptions): Promise<Message>;
     /**
      * Send a message to any chat this bot is in — this one or another.
      * `mentions` names who `@handle` tokens in `text` point at: pass
-     * `mention(user)`, a `User`, or `{ user: 'usr_…' }`. Returns the stored
-     * message.
+     * `mention(user)`, a `User`, or `{ user: 'usr_…' }`. `embeds`/`buttons`
+     * accept a builder or a plain object literal, validated the same either
+     * way. Returns the stored message.
      */
-    send(chat: Chat | string, text: string, options?: {
-        mentions?: MentionLike[];
-    }): Promise<Message>;
+    send(chat: Chat | string, text: string, options?: SendOptions): Promise<Message>;
+    send(chat: Chat | string, options: SendOptions): Promise<Message>;
     /**
      * Show or clear "is thinking…" in this chat. `POST /v1/chats/{chat}/typing`
      * with `{"is_typing": bool}`. Command handlers get this automatically
@@ -248,6 +267,33 @@ export declare class ReactionContext extends BaseContext {
     protected quotes(): string | null;
     static fromEvent(event: Event, http: HttpClient): ReactionContext;
 }
+export interface ButtonContextInit extends BaseInit {
+    user: User;
+    message: Message;
+    button: string;
+    interaction: string;
+}
+/** `button.pressed`: someone pressed a button on one of this bot's own messages (AMENDMENT-05). */
+export declare class ButtonContext extends BaseContext {
+    #private;
+    /** Who pressed the button. */
+    readonly user: User;
+    /** The bot's message the button lives on — id only; the text is not re-sent. `reply()` quotes it. */
+    readonly message: Message;
+    /** The pressed button's id. */
+    readonly button: string;
+    /** The interaction id — `ack()` posts to `/v1/interactions/{interaction}/ack`. */
+    readonly interaction: string;
+    constructor(init: ButtonContextInit);
+    protected quotes(): string | null;
+    /**
+     * Acknowledge the button press — `POST /v1/interactions/{interaction}/ack`,
+     * 204 no body. Acking twice is `InteractionAlreadyUsed` (surfaced through
+     * the existing code -> class mapping; there is no dedicated class here).
+     */
+    ack(): Promise<void>;
+    static fromEvent(event: Event, http: HttpClient): ButtonContext;
+}
 export interface EventContextInit extends BaseInit {
     sender: User | null;
     user: User | null;
@@ -272,10 +318,10 @@ export declare class EventContext extends BaseContext {
     static fromEvent(event: Event, http: HttpClient): EventContext;
 }
 /** Any context a handler can receive. What `bot.onError()` sees beside the error. */
-export type AnyContext = Context | MemberContext | BotContext | ReactionContext | EventContext;
+export type AnyContext = Context | MemberContext | BotContext | ReactionContext | ButtonContext | EventContext;
 /**
  * The context class for an event, by its type. `command.invoked` gets
- * `Context`; the three named families get theirs; anything else gets
+ * `Context`; the four named families get theirs; anything else gets
  * `EventContext`. The dispatch side of BA-R68 — `bot.ts` calls this and
  * hands the result to every handler registered for the type.
  */