lunibee 0.1.4 → 0.1.6

package/README.md

@@ -2,26 +2,12 @@
 
 [![npm version](https://badge.fury.io/js/lunibee.svg)](https://www.npmjs.com/package/lunibee)
 [![NPM Downloads](https://img.shields.io/npm/dt/lunibee.svg?style=flat-square)](https://www.npmjs.com/package/lunibee)
+[![Discord](https://img.shields.io/badge/Discord-%235865F2.svg?style=flat-square&logo=discord&logoColor=white)](https://discord.gg/SSADgyBpgw)
 
 [![NPM Graph](https://nodei.co/npm/lunibee.png?downloads=true&downloadRank=true&stars=true)](https://www.npmjs.com/package/lunibee)
 
 A lightweight, Bun-first Discord API library for TypeScript.
 
-## Production-readiness status
-
-Lunibee's production-readiness work is being developed on `feat/production-readiness`. **Do not use `master` for active development.**
-
-The roadmap covers:
-
-- strict package dependency boundaries and installability
-- Discord Gateway lifecycle, heartbeat ACK handling, resume/reconnect, and zombie detection
-- canonical resource caching and shared REST/Gateway hydration
-- bucket-aware REST rate limits, retries, timeouts, and `AbortSignal` cancellation
-- typed permissions and ergonomic interaction APIs
-- compile-time-safe component and embed builders
-- graceful client and shard shutdown
-- public API documentation
-
 ## Requirements
 
 - [Bun](https://bun.sh/) for the supported runtime and package manager
@@ -42,6 +28,10 @@ For application usage, install the published `lunibee` package when a release is
 bun add lunibee
 ```
 
+## Documentation
+
+Full documentation, practical guides, and API references are available at **[lunibee.js.org](https://lunibee.js.org)**.
+
 ## Getting started
 
 ```ts
@@ -168,13 +158,12 @@ Available lifecycle methods include `reply()`, `deferReply()`, `editReply()`, `d
 
 ## Builders
 
-Lunibee provides strict builders for Discord payloads, including:
+Lunibee provides strict builders for Discord payloads (Discord.js V2 compatible), including:
 
-- `EmbedBuilder`
-- `ButtonBuilder`
 - `ActionRowBuilder`
-- `StringSelectBuilder`
-- `EntitySelectBuilder`
+- `ButtonBuilder`
+- `StringSelectMenuBuilder`
+- `EmbedBuilder`
 - `ModalBuilder`
 - `TextInputBuilder`
 
@@ -223,11 +212,11 @@ bun install
 bunx tsc --noEmit
 ```
 
-Keep production-readiness work on the active feature branch and commit each completed phase separately. Changes must not be made directly on `master`.
+## Documentation & API Reference
 
-## API reference
+The full, official API reference and practical guides are available at **[lunibee.js.org](https://lunibee.js.org)**. 
 
-The source is the authoritative API surface while Lunibee remains pre-1.0. Public exports are intentionally split by responsibility so applications can import either the high-level `lunibee` package or individual packages when appropriate.
+The source remains the authoritative API surface while Lunibee is pre-1.0. Public exports are intentionally split by responsibility so applications can import either the high-level `lunibee` package or individual packages when appropriate.
 
 ## Status
 

package/dist/builders/components.d.ts

@@ -8,6 +8,14 @@ export declare const ComponentType: {
     readonly RoleSelect: 6;
     readonly MentionableSelect: 7;
     readonly ChannelSelect: 8;
+    readonly Section: 9;
+    readonly TextDisplay: 10;
+    readonly Thumbnail: 11;
+    readonly MediaGallery: 12;
+    readonly File: 13;
+    readonly Separator: 14;
+    readonly ContentInventoryEntry: 16;
+    readonly Container: 17;
 };
 export declare const ButtonStyle: {
     readonly Primary: 1;
@@ -82,6 +90,53 @@ export interface APIActionRowComponent {
     type: typeof ComponentType.ActionRow;
     components: APIActionRowChild[];
 }
+export interface APISectionComponent {
+    type: typeof ComponentType.Section;
+    components?: APIComponent[];
+    accessory?: APIComponent;
+}
+export interface APITextDisplayComponent {
+    type: typeof ComponentType.TextDisplay;
+    content: string;
+}
+export interface APIMediaGalleryComponent {
+    type: typeof ComponentType.MediaGallery;
+    items: {
+        media: {
+            url: string;
+            description?: string;
+        };
+    }[];
+}
+export interface APIFileComponent {
+    type: typeof ComponentType.File;
+    file: {
+        url: string;
+    };
+    spoiler?: boolean;
+}
+export interface APISeparatorComponent {
+    type: typeof ComponentType.Separator;
+    spacing?: 1 | 2;
+    divider?: boolean;
+}
+export interface APIThumbnailComponent {
+    type: typeof ComponentType.Thumbnail;
+    url: string;
+    proxy_url?: string;
+    width?: number;
+    height?: number;
+}
+export interface APIContentInventoryEntryComponent {
+    type: typeof ComponentType.ContentInventoryEntry;
+    id: string;
+}
+export interface APIContainerComponent {
+    type: typeof ComponentType.Container;
+    components: APIComponent[];
+    accent_color?: number;
+}
+export type APIComponent = APIActionRowComponent | APIButtonComponent | APIStringSelectComponent | APIEntitySelectComponent | APITextInputComponent | APISectionComponent | APITextDisplayComponent | APIThumbnailComponent | APIMediaGalleryComponent | APIFileComponent | APISeparatorComponent | APIContentInventoryEntryComponent | APIContainerComponent;
 export declare class ActionRowBuilder<T extends {
     toJSON(): APIActionRowChild;
 } = {
@@ -149,3 +204,56 @@ export declare class TextInputBuilder {
     setValue(value: string): this;
     toJSON(): APITextInputComponent;
 }
+export declare class ContainerBuilder {
+    #private;
+    addComponents(...components: {
+        toJSON(): APIComponent;
+    }[]): this;
+    setAccentColor(color: number): this;
+    toJSON(): APIContainerComponent;
+}
+export declare class SectionBuilder {
+    #private;
+    addComponents(...components: {
+        toJSON(): APIComponent;
+    }[]): this;
+    setAccessory(accessory: {
+        toJSON(): APIComponent;
+    }): this;
+    toJSON(): APISectionComponent;
+}
+export declare class TextDisplayBuilder {
+    #private;
+    setContent(content: string): this;
+    toJSON(): APITextDisplayComponent;
+}
+export declare class MediaGalleryBuilder {
+    #private;
+    addItems(...items: {
+        url: string;
+        description?: string;
+    }[]): this;
+    toJSON(): APIMediaGalleryComponent;
+}
+export declare class FileComponentBuilder {
+    #private;
+    setUrl(url: string): this;
+    setSpoiler(spoiler?: boolean): this;
+    toJSON(): APIFileComponent;
+}
+export declare class SeparatorBuilder {
+    #private;
+    setSpacing(spacing: 1 | 2): this;
+    setDivider(divider?: boolean): this;
+    toJSON(): APISeparatorComponent;
+}
+export declare class ThumbnailBuilder {
+    #private;
+    setUrl(url: string): this;
+    toJSON(): APIThumbnailComponent;
+}
+export declare class ContentInventoryEntryBuilder {
+    #private;
+    setId(id: string): this;
+    toJSON(): APIContentInventoryEntryComponent;
+}

package/dist/builders/index.d.ts

@@ -1,5 +1,5 @@
 export { EmbedBuilder } from "./embed.js";
 export type { EmbedField } from "./embed.js";
-export { ButtonBuilder, ButtonStyle, ComponentType, ActionRowBuilder, StringSelectBuilder, EntitySelectBuilder, ModalBuilder, TextInputBuilder, TextInputStyle, } from "./components.js";
+export { ButtonBuilder, ButtonStyle, ComponentType, ActionRowBuilder, StringSelectBuilder, EntitySelectBuilder, ModalBuilder, TextInputBuilder, TextInputStyle, ContainerBuilder, SectionBuilder, TextDisplayBuilder, MediaGalleryBuilder, FileComponentBuilder, SeparatorBuilder, ThumbnailBuilder, ContentInventoryEntryBuilder, } from "./components.js";
 export { SlashCommandBuilder, StringOptionBuilder, IntegerOptionBuilder, NumberOptionBuilder, BooleanOptionBuilder, UserOptionBuilder, ChannelOptionBuilder, RoleOptionBuilder, MentionableOptionBuilder, AttachmentOptionBuilder, SubcommandBuilder, SubcommandGroupBuilder, ApplicationCommandOptionType, } from "./commands.js";
 export { AttachmentBuilder, type AttachmentData } from "./attachment.js";

package/dist/builders/index.js

@@ -119,7 +119,15 @@ var ComponentType = {
   UserSelect: 5,
   RoleSelect: 6,
   MentionableSelect: 7,
-  ChannelSelect: 8
+  ChannelSelect: 8,
+  Section: 9,
+  TextDisplay: 10,
+  Thumbnail: 11,
+  MediaGallery: 12,
+  File: 13,
+  Separator: 14,
+  ContentInventoryEntry: 16,
+  Container: 17
 };
 var ButtonStyle = {
   Primary: 1,
@@ -379,6 +387,166 @@ class TextInputBuilder {
     return structuredClone(this.#data);
   }
 }
+
+class ContainerBuilder {
+  #components = [];
+  #accentColor;
+  addComponents(...components) {
+    if (!components.length)
+      throw new TypeError("At least one component is required.");
+    this.#components.push(...components);
+    return this;
+  }
+  setAccentColor(color) {
+    if (!Number.isInteger(color) || color < 0 || color > 16777215) {
+      throw new RangeError("Accent color must be an integer between 0 and 16777215 (0xFFFFFF).");
+    }
+    this.#accentColor = color;
+    return this;
+  }
+  toJSON() {
+    return {
+      type: ComponentType.Container,
+      components: this.#components.map((c) => c.toJSON()),
+      accent_color: this.#accentColor
+    };
+  }
+}
+
+class SectionBuilder {
+  #components = [];
+  #accessory;
+  addComponents(...components) {
+    if (!components.length)
+      throw new TypeError("At least one component is required.");
+    this.#components.push(...components);
+    return this;
+  }
+  setAccessory(accessory) {
+    this.#accessory = accessory;
+    return this;
+  }
+  toJSON() {
+    return {
+      type: ComponentType.Section,
+      components: this.#components.length ? this.#components.map((c) => c.toJSON()) : undefined,
+      accessory: this.#accessory?.toJSON()
+    };
+  }
+}
+
+class TextDisplayBuilder {
+  #content = "";
+  setContent(content) {
+    validateText(content, 4000, "Text display content");
+    this.#content = content;
+    return this;
+  }
+  toJSON() {
+    return {
+      type: ComponentType.TextDisplay,
+      content: this.#content
+    };
+  }
+}
+
+class MediaGalleryBuilder {
+  #items = [];
+  addItems(...items) {
+    if (!items.length) {
+      throw new TypeError("At least one media gallery item is required.");
+    }
+    if (this.#items.length + items.length > 10) {
+      throw new RangeError("MediaGallery can only contain up to 10 items.");
+    }
+    this.#items.push(...items.map((item) => ({ media: item })));
+    return this;
+  }
+  toJSON() {
+    return {
+      type: ComponentType.MediaGallery,
+      items: structuredClone(this.#items)
+    };
+  }
+}
+
+class FileComponentBuilder {
+  #url = "";
+  #spoiler;
+  setUrl(url2) {
+    validateText(url2, 2048, "File component URL");
+    this.#url = url2;
+    return this;
+  }
+  setSpoiler(spoiler = true) {
+    this.#spoiler = spoiler;
+    return this;
+  }
+  toJSON() {
+    if (!this.#url)
+      throw new Error("File component must have a URL.");
+    const data = {
+      type: ComponentType.File,
+      file: { url: this.#url }
+    };
+    if (this.#spoiler !== undefined)
+      data.spoiler = this.#spoiler;
+    return data;
+  }
+}
+
+class SeparatorBuilder {
+  #spacing;
+  #divider;
+  setSpacing(spacing) {
+    this.#spacing = spacing;
+    return this;
+  }
+  setDivider(divider = true) {
+    this.#divider = divider;
+    return this;
+  }
+  toJSON() {
+    const data = {
+      type: ComponentType.Separator
+    };
+    if (this.#spacing !== undefined)
+      data.spacing = this.#spacing;
+    if (this.#divider !== undefined)
+      data.divider = this.#divider;
+    return data;
+  }
+}
+
+class ThumbnailBuilder {
+  #url = "";
+  setUrl(url2) {
+    validateText(url2, 2048, "Thumbnail URL");
+    this.#url = url2;
+    return this;
+  }
+  toJSON() {
+    return {
+      type: ComponentType.Thumbnail,
+      url: this.#url
+    };
+  }
+}
+
+class ContentInventoryEntryBuilder {
+  #id = "";
+  setId(id) {
+    validateText(id, 100, "Content inventory entry ID");
+    this.#id = id;
+    return this;
+  }
+  toJSON() {
+    return {
+      type: ComponentType.ContentInventoryEntry,
+      id: this.#id
+    };
+  }
+}
 function validateText(value, max, field) {
   if (typeof value !== "string")
     throw new TypeError(`${field} must be a string.`);
@@ -808,21 +976,29 @@ export {
   ButtonStyle,
   ChannelOptionBuilder,
   ComponentType,
+  ContainerBuilder,
+  ContentInventoryEntryBuilder,
   EmbedBuilder,
   EntitySelectBuilder,
+  FileComponentBuilder,
   IntegerOptionBuilder,
+  MediaGalleryBuilder,
   MentionableOptionBuilder,
   ModalBuilder,
   NumberOptionBuilder,
   RoleOptionBuilder,
+  SectionBuilder,
+  SeparatorBuilder,
   SlashCommandBuilder,
   StringOptionBuilder,
   StringSelectBuilder,
   SubcommandBuilder,
   SubcommandGroupBuilder,
+  TextDisplayBuilder,
   TextInputBuilder,
   TextInputStyle,
+  ThumbnailBuilder,
   UserOptionBuilder
 };
 
-//# debugId=2D9849BFEE96124664756E2164756E21
+//# debugId=14619C67BE7B82B464756E2164756E21