lunibee 0.1.8 → 0.2.0

package/README.md

@@ -130,6 +130,8 @@ Resource managers maintain canonical instances by Discord resource ID. Re-resolv
 
 REST-created and Gateway-updated resources are routed through manager cache mutation APIs so the same resource is not represented by unrelated structure instances.
 
+Discord resources are stored with `Collection.setWithoutTTL()` and leave the cache only through Gateway delete events or an explicit `delete()`, never through expiry. Messages are cached only with the `messageCache: { maxSize?, ttl? }` client option, and `cache: { users, members, roles, emojis }` turns off per-resource caching on large bots. For your own data, `new Collection(null, { ttl, maxSize, onEvict })` is a TTL/LRU cache. See the [0.2.0 upgrade guide](https://lunibee.js.org/getting-started/upgrading/).
+
 ## Permissions
 
 `PermissionSet` provides named and raw permission checks:

package/dist/builders/components.d.ts

@@ -35,6 +35,8 @@ export interface APIButtonComponent {
     label?: string;
     emoji?: APIComponentEmoji;
     url?: string;
+    /** SKU for premium (style 6) buttons. */
+    sku_id?: string;
     disabled?: boolean;
 }
 export interface APISelectOption {
@@ -164,10 +166,13 @@ export declare class StringSelectBuilder {
 }
 export declare class ButtonBuilder {
     #private;
+    /** Sets the style and drops fields that style cannot carry. */
     setStyle(style: APIButtonComponent["style"]): this;
     setCustomId(value: string): this;
     setLabel(value: string): this;
     setURL(value: string): this;
+    /** Makes this a premium (purchase) button for a SKU. Premium buttons carry no label, emoji, custom ID or URL. */
+    setSKUId(skuId: string): this;
     setEmoji(emoji: APIComponentEmoji | string): this;
     setDisabled(value?: boolean): this;
     toJSON(): APIButtonComponent;

package/dist/builders/index.js

@@ -212,10 +212,13 @@ class ActionRowBuilder {
     return this;
   }
   toJSON() {
-    return {
-      type: ComponentType.ActionRow,
-      components: this.#components.map((component) => component.toJSON())
-    };
+    const components = this.#components.map((component) => component.toJSON());
+    if (components.length === 0)
+      throw new RangeError("An action row needs at least one component.");
+    const types = components.map((component) => component.type);
+    if (types.some((type) => type !== ComponentType.Button) && components.length > 1)
+      throw new RangeError("A select menu or text input must be alone in its action row.");
+    return { type: ComponentType.ActionRow, components };
   }
 }
 
@@ -270,6 +273,12 @@ class StringSelectBuilder {
     return this;
   }
   toJSON() {
+    assertSelect(this.#data);
+    const count = this.#data.options?.length ?? 0;
+    if (count === 0)
+      throw new RangeError("A string select needs at least one option.");
+    if ((this.#data.max_values ?? 1) > count)
+      throw new RangeError("max_values cannot exceed the number of options.");
     return structuredClone(this.#data);
   }
 }
@@ -280,9 +289,20 @@ class ButtonBuilder {
     style: ButtonStyle.Secondary
   };
   setStyle(style) {
-    this.#data.style = style;
-    if (style === ButtonStyle.Link)
-      delete this.#data.custom_id;
+    const data = this.#data;
+    data.style = style;
+    if (style === ButtonStyle.Link) {
+      delete data.custom_id;
+      delete data.sku_id;
+    } else if (style === ButtonStyle.Premium) {
+      delete data.custom_id;
+      delete data.url;
+      delete data.label;
+      delete data.emoji;
+    } else {
+      delete data.url;
+      delete data.sku_id;
+    }
     return this;
   }
   setCustomId(value) {
@@ -307,11 +327,16 @@ class ButtonBuilder {
         cause: error
       });
     }
-    this.#data.style = ButtonStyle.Link;
-    delete this.#data.custom_id;
+    this.setStyle(ButtonStyle.Link);
     this.#data.url = url.toString();
     return this;
   }
+  setSKUId(skuId) {
+    validateText(skuId, 20, "Button SKU ID");
+    this.setStyle(ButtonStyle.Premium);
+    this.#data.sku_id = skuId;
+    return this;
+  }
   setEmoji(emoji) {
     this.#data.emoji = typeof emoji === "string" ? { name: emoji } : { ...emoji };
     return this;
@@ -321,7 +346,26 @@ class ButtonBuilder {
     return this;
   }
   toJSON() {
-    return structuredClone(this.#data);
+    const data = this.#data;
+    if (data.style === ButtonStyle.Link) {
+      if (!data.url)
+        throw new TypeError("Link buttons require a URL.");
+      if (data.custom_id || data.sku_id)
+        throw new TypeError("Link buttons cannot have a custom ID or SKU ID.");
+    } else if (data.style === ButtonStyle.Premium) {
+      if (!data.sku_id)
+        throw new TypeError("Premium buttons require a SKU ID.");
+      if (data.custom_id || data.url || data.label || data.emoji)
+        throw new TypeError("Premium buttons cannot have a custom ID, URL, label or emoji.");
+    } else {
+      if (!data.custom_id)
+        throw new TypeError("Non-link buttons require a custom ID.");
+      if (data.url || data.sku_id)
+        throw new TypeError("Only link buttons have a URL and only premium buttons have a SKU ID.");
+    }
+    if (data.style !== ButtonStyle.Premium && !data.label && !data.emoji)
+      throw new TypeError("Buttons require a label or an emoji.");
+    return structuredClone(data);
   }
 }
 
@@ -365,6 +409,7 @@ class EntitySelectBuilder {
     return this;
   }
   toJSON() {
+    assertSelect(this.#data);
     return structuredClone(this.#data);
   }
 }
@@ -392,6 +437,10 @@ class ModalBuilder {
     return this;
   }
   toJSON() {
+    if (!this.#custom_id || !this.#title)
+      throw new TypeError("Modals require a custom ID and a title.");
+    if (this.#components.length === 0)
+      throw new RangeError("Modals require at least one component.");
     return {
       type: 9,
       ...this.#custom_id ? { custom_id: this.#custom_id } : {},
@@ -445,7 +494,12 @@ class TextInputBuilder {
     return this;
   }
   toJSON() {
-    return structuredClone(this.#data);
+    const data = this.#data;
+    if (!data.custom_id)
+      throw new TypeError("Text inputs require a custom ID.");
+    if (data.min_length !== undefined && data.max_length !== undefined && data.min_length > data.max_length)
+      throw new RangeError("min_length cannot exceed max_length.");
+    return structuredClone(data);
   }
 }
 
@@ -672,6 +726,12 @@ class ChannelSelectMenuBuilder extends EntitySelectBuilder {
     super(ComponentType.ChannelSelect);
   }
 }
+function assertSelect(data) {
+  if (!data.custom_id)
+    throw new TypeError("Select menus require a custom ID.");
+  if ((data.min_values ?? 1) > (data.max_values ?? 1))
+    throw new RangeError("min_values cannot exceed max_values.");
+}
 // packages/builders/src/commands.ts
 var ApplicationCommandOptionType = {
   Subcommand: 1,
@@ -1164,4 +1224,4 @@ export {
   UserSelectMenuBuilder
 };
 
-//# debugId=51C5BC8CB8846ABF64756E2164756E21
+//# debugId=91BF5BFA3419A2E364756E2164756E21