gralonium 0.2.0

package/lib/classes/builders/GroupBuilder.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GroupBuilder = void 0;
+
+const CommandBuilder_js_1 = require("./CommandBuilder.js");
+const shapeshift_1 = require("@sapphire/shapeshift");
+
+const permissionStringPredicate = shapeshift_1.s.string.lengthGreaterThan(0);
+const permissionArrayPredicate = shapeshift_1.s.array(permissionStringPredicate);
+
+class GroupBuilder {
+  name;
+  aliases;
+  description;
+  commands;
+  as_slash;
+  as_prefix;
+  guildOnly;
+  defaultMemberPermissions;
+  userPermissions;
+  botPermissions;
+  guards;
+
+  constructor(options) {
+    this.commands = [];
+    this.name = options?.name ?? "";
+    this.aliases = options?.aliases ?? [];
+    this.description = options?.description ?? "...";
+    this.as_prefix = options?.as_prefix ?? true;
+    this.as_slash = options?.as_slash ?? true;
+    this.guildOnly = options?.guildOnly;
+    this.defaultMemberPermissions = options?.defaultMemberPermissions;
+    this.userPermissions = permissionArrayPredicate.parse(options?.userPermissions ?? []);
+    this.botPermissions = permissionArrayPredicate.parse(options?.botPermissions ?? []);
+    this.guards = options?.guards ?? [];
+  }
+
+  setName(name) {
+    this.name = name;
+    return this;
+  }
+
+  setDescription(description) {
+    this.description = description;
+    return this;
+  }
+
+  addCommand(command) {
+    this.commands.push(command);
+    return this;
+  }
+
+  setGuards(...guards) {
+    this.guards = guards;
+    return this;
+  }
+
+  setUserPermissions(...permissions) {
+    this.userPermissions = permissionArrayPredicate.parse(permissions);
+    return this;
+  }
+
+  setBotPermissions(...permissions) {
+    this.botPermissions = permissionArrayPredicate.parse(permissions);
+    return this;
+  }
+
+  allowPrefix(allow) {
+    this.as_prefix = allow;
+    return this;
+  }
+
+  allowSlash(allow) {
+    this.as_slash = allow;
+    return this;
+  }
+
+  toJSON() {
+    return {
+      name: this.name,
+      description: this.description,
+      options: [],
+      default_member_permissions: this.defaultMemberPermissions
+        ? (0, CommandBuilder_js_1.validateDefaultMemberPermissions)(this.defaultMemberPermissions)
+        : undefined,
+      dm_permission: typeof this.guildOnly === "boolean" ? !this.guildOnly : undefined,
+    };
+  }
+}
+exports.GroupBuilder = GroupBuilder;

package/lib/classes/builders/InteractionBuilder.d.ts

@@ -0,0 +1,32 @@
+export declare enum Interactions {
+    AnyInteraction = "anyInteraction",
+    Autocomplete = "autocomplete",
+    Button = "button",
+    ChatInput = "chatInput",
+    MessageContextMenu = "messageContextMenu",
+    Modal = "modalSubmit",
+    UserContextMenu = "userContextMenu",
+    ChannelSelectMenu = "channelSelectMenu",
+    RoleSelectMenu = "roleSelectMenu",
+    StringSelectMenu = "stringSelectMenu",
+    UserSelectMenu = "userSelectMenu",
+    MentionableSelectMenu = "mentionableSelectMenu"
+}
+export interface InteractionDataBuilder {
+    name?: string;
+    type: Interactions;
+    description?: string;
+}
+export declare class InteractionBuilder {
+    name?: string;
+    type: Interactions;
+    description: string;
+    constructor(options?: InteractionDataBuilder);
+    /**
+     * Returns the command data parsed as JSON.
+     */
+    toJSON(): {
+        name: string | undefined;
+        description: string;
+    };
+}

package/lib/classes/builders/InteractionBuilder.js

@@ -0,0 +1 @@
+"use strict";var Interactions;Object.defineProperty(exports,"__esModule",{value:!0}),exports.InteractionBuilder=exports.Interactions=void 0,function(e){e.AnyInteraction="anyInteraction",e.Autocomplete="autocomplete",e.Button="button",e.ChatInput="chatInput",e.MessageContextMenu="messageContextMenu",e.Modal="modalSubmit",e.UserContextMenu="userContextMenu",e.ChannelSelectMenu="channelSelectMenu",e.RoleSelectMenu="roleSelectMenu",e.StringSelectMenu="stringSelectMenu",e.UserSelectMenu="userSelectMenu",e.MentionableSelectMenu="mentionableSelectMenu"}(Interactions||(exports.Interactions=Interactions={}));class InteractionBuilder{name;type;description;constructor(e){this.name=e?.name,this.type=e?.type||Interactions.ChatInput,this.description=e?.description||"..."}toJSON(){return{name:this.name,description:this.description}}}exports.InteractionBuilder=InteractionBuilder;

package/lib/classes/builders/ParamsBuilder.d.ts

@@ -0,0 +1,87 @@
+import { ApplicationCommandOptionType, ChannelType } from "discord.js";
+export interface BaseParam {
+    /** The name for this parameter. */
+    name: string;
+    /** The description for this parameter. */
+    description: string;
+    /** Mark this param as required or not. */
+    required: boolean;
+    /** Parameter type. (if needed) */
+    type?: ApplicationCommandOptionType;
+    /** Parameter default value. */
+    value?: any;
+    /** Mostly to be used for string. Return all arguments after this parameter (including this one) */
+    ellipsis?: boolean;
+}
+export interface StringParam extends BaseParam {
+    /** String choices. */
+    choices?: {
+        name: string;
+        value: string;
+    }[];
+    /** Maximum string length. */
+    max_length?: number;
+    /** Minimum string length. */
+    min_length?: number;
+    /** Mark this command as automplete */
+    autocomplete?: boolean;
+}
+export interface NumberParam extends BaseParam {
+    /** Maximum number length. */
+    max_value?: number;
+    /** Minimum string length. */
+    min_value?: number;
+    /** Number choices. */
+    choices?: {
+        name: string;
+        value: string;
+    }[];
+}
+export interface ChannelParam extends BaseParam {
+    /** An array of allowed channel types. */
+    channel_types?: ChannelType[];
+}
+export declare class ParamsBuilder {
+    params: BaseParam[];
+    quoted: boolean;
+    /**
+     * Enable or disable quoted arguments.
+     * @param value Boolean value.
+     */
+    setQuoted(value: boolean): ParamsBuilder;
+    /**
+     * Adds a string option.
+     * @param param Parameter data.
+     */
+    addString(param: StringParam): ParamsBuilder;
+    /**
+     * Adds a number option.
+     * @param param Parameter data.
+     */
+    addNumber(param: NumberParam): ParamsBuilder;
+    /**
+     * Adds a boolean option.
+     * @param param Parameter data.
+     */
+    addBoolean(param: BaseParam): ParamsBuilder;
+    /**
+     * Adds a guild member option.
+     * @param param Parameter data.
+     */
+    addMember(param: BaseParam): ParamsBuilder;
+    /**
+     * Adds a guild channel option.
+     * @param param Parameter data.
+     */
+    addChannel(param: ChannelParam): ParamsBuilder;
+    /**
+     * Adds a role option.
+     * @param param Parameter data.
+     */
+    addRole(param: BaseParam): ParamsBuilder;
+    /**
+     * Adds an attachment option.
+     * @param param Parameter data.
+     */
+    addAttachment(param: BaseParam): ParamsBuilder;
+}

package/lib/classes/builders/ParamsBuilder.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.ParamsBuilder=void 0;const discord_js_1=require("discord.js");class ParamsBuilder{params=[];quoted=!0;setQuoted(t){return this.quoted=t,this}addString(t){return t.type=discord_js_1.ApplicationCommandOptionType.String,this.params.push(t),this}addNumber(t){return t.type=discord_js_1.ApplicationCommandOptionType.Number,this.params.push(t),this}addBoolean(t){return t.type=discord_js_1.ApplicationCommandOptionType.Boolean,this.params.push(t),this}addMember(t){return t.type=discord_js_1.ApplicationCommandOptionType.User,this.params.push(t),this}addChannel(t){return t.type=discord_js_1.ApplicationCommandOptionType.Channel,this.params.push(t),this}addRole(t){return t.type=discord_js_1.ApplicationCommandOptionType.Role,this.params.push(t),this}addAttachment(t){return t.type=discord_js_1.ApplicationCommandOptionType.Attachment,this.params.push(t),this}}exports.ParamsBuilder=ParamsBuilder;

package/lib/classes/builders/components/StyleMapper.d.ts

@@ -0,0 +1,10 @@
+import { ButtonStyle } from "discord.js";
+
+export type ButtonStyleName = "primary" | "secondary" | "success" | "danger" | "link";
+export type ButtonStyleInput = ButtonStyleName | ButtonStyle;
+
+/**
+ * Maps a button style name (string) or ButtonStyle enum value to a ButtonStyle.
+ * Defaults to Primary if the provided value is not recognized.
+ */
+export declare function mapButtonStyle(style?: ButtonStyleInput | null): ButtonStyle;

package/lib/classes/builders/components/StyleMapper.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapButtonStyle = void 0;
+
+const discord_js_1 = require("discord.js");
+
+const STYLE_MAP = {
+  primary: discord_js_1.ButtonStyle.Primary,
+  secondary: discord_js_1.ButtonStyle.Secondary,
+  success: discord_js_1.ButtonStyle.Success,
+  danger: discord_js_1.ButtonStyle.Danger,
+  link: discord_js_1.ButtonStyle.Link,
+};
+
+/**
+ * Maps a button style name (string) or ButtonStyle enum value to a ButtonStyle.
+ * Defaults to Primary if the provided value is not recognized.
+ */
+function mapButtonStyle(style) {
+  if (style === undefined || style === null) {
+    return discord_js_1.ButtonStyle.Primary;
+  }
+  if (typeof style === "number") {
+    return style;
+  }
+  const mapped = STYLE_MAP[style.toLowerCase()];
+  if (mapped === undefined) {
+    return discord_js_1.ButtonStyle.Primary;
+  }
+  return mapped;
+}
+exports.mapButtonStyle = mapButtonStyle;

package/lib/classes/builders/components/helpers.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Validates that text content is non-empty.
+ * Throws a descriptive error if validation fails.
+ */
+export declare function validateTextContent(content: unknown): void;
+
+/**
+ * Validates that a button row does not exceed 5 buttons.
+ * Throws a descriptive error if validation fails.
+ */
+export declare function validateButtonCount(count: number): void;
+
+/**
+ * Validates that a select menu does not exceed 25 options.
+ * Throws a descriptive error if validation fails.
+ */
+export declare function validateSelectMenuOptions(count: number): void;
+
+/**
+ * Generates a unique custom ID with an optional prefix.
+ */
+export declare function generateCustomId(prefix?: string): string;

package/lib/classes/builders/components/helpers.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateCustomId = exports.validateSelectMenuOptions = exports.validateButtonCount = exports.validateTextContent = void 0;
+
+/**
+ * Validates that text content is non-empty.
+ * Throws a descriptive error if validation fails.
+ */
+function validateTextContent(content) {
+  if (typeof content !== "string" || content.trim().length === 0) {
+    throw new Error("[ComponentsV2Builder] Text content must be a non-empty string.");
+  }
+}
+exports.validateTextContent = validateTextContent;
+
+/**
+ * Validates that a button row does not exceed 5 buttons.
+ * Throws a descriptive error if validation fails.
+ */
+function validateButtonCount(count) {
+  if (count > 5) {
+    throw new Error("[ComponentsV2Builder] An ActionRow cannot contain more than 5 buttons.");
+  }
+}
+exports.validateButtonCount = validateButtonCount;
+
+/**
+ * Validates that a select menu does not exceed 25 options.
+ * Throws a descriptive error if validation fails.
+ */
+function validateSelectMenuOptions(count) {
+  if (count > 25) {
+    throw new Error("[ComponentsV2Builder] A StringSelectMenu cannot have more than 25 options.");
+  }
+}
+exports.validateSelectMenuOptions = validateSelectMenuOptions;
+
+/**
+ * Generates a unique custom ID with an optional prefix.
+ * Uses crypto.randomUUID when available, otherwise falls back to a
+ * timestamp + random number combination to avoid collisions in clustered
+ * or multi-process environments.
+ */
+function generateCustomId(prefix) {
+  const base = prefix ? `${prefix}_` : "cv2_";
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+    return `${base}${crypto.randomUUID()}`;
+  }
+  return `${base}${Date.now()}_${Math.random().toString(36).slice(2)}`;
+}
+exports.generateCustomId = generateCustomId;

package/lib/classes/builders/components/templates.d.ts

@@ -0,0 +1,13 @@
+import { ComponentsV2Builder } from "../ComponentsV2Builder.js";
+
+/** Create a Confirm / Cancel button container. */
+export declare function createConfirm(confirmId?: string, cancelId?: string): ComponentsV2Builder;
+
+/** Create a ticket category select menu container. */
+export declare function createTicketMenu(customId?: string): ComponentsV2Builder;
+
+/** Create a plan selector container. */
+export declare function createPlanSelector(customId?: string): ComponentsV2Builder;
+
+/** Create a role selector menu container. */
+export declare function createRoleMenu(customId?: string): ComponentsV2Builder;

package/lib/classes/builders/components/templates.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * templates.js — re-exports the static template factories from ComponentsV2Builder
+ * as standalone named functions for convenient direct imports.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRoleMenu = exports.createPlanSelector = exports.createTicketMenu = exports.createConfirm = void 0;
+
+const ComponentsV2Builder_js_1 = require("../ComponentsV2Builder.js");
+
+/**
+ * Create a Confirm / Cancel button container.
+ */
+function createConfirm(confirmId, cancelId) {
+  return ComponentsV2Builder_js_1.ComponentsV2Builder.createConfirm(confirmId, cancelId);
+}
+exports.createConfirm = createConfirm;
+
+/**
+ * Create a ticket category select menu container.
+ */
+function createTicketMenu(customId) {
+  return ComponentsV2Builder_js_1.ComponentsV2Builder.createTicketMenu(customId);
+}
+exports.createTicketMenu = createTicketMenu;
+
+/**
+ * Create a plan selector container.
+ */
+function createPlanSelector(customId) {
+  return ComponentsV2Builder_js_1.ComponentsV2Builder.createPlanSelector(customId);
+}
+exports.createPlanSelector = createPlanSelector;
+
+/**
+ * Create a role selector menu container.
+ */
+function createRoleMenu(customId) {
+  return ComponentsV2Builder_js_1.ComponentsV2Builder.createRoleMenu(customId);
+}
+exports.createRoleMenu = createRoleMenu;

package/lib/classes/experiments/Confirmator.d.ts

@@ -0,0 +1,58 @@
+import { User, Message, CollectedInteraction } from "discord.js";
+import { AsyncFunction } from "../Loader.js";
+import { Erine } from "../Client.js";
+export type ConfirmatorOptions = {
+    author: User;
+    filter?: ConfirmatorProcess;
+    timeout?: number;
+};
+export type ConfirmatorProcess = AsyncFunction<CollectedInteraction, any>;
+export type ConfirmatorButtonsOptions = {
+    continue?: {
+        label?: string;
+    };
+    cancel?: {
+        label?: string;
+    };
+};
+export declare class Confirmator {
+    private _author;
+    private _continue;
+    private _cancel;
+    private _filter;
+    filter: ConfirmatorProcess;
+    timeout: number;
+    message?: Message;
+    bot: Erine;
+    constructor(bot: Erine, options: ConfirmatorOptions);
+    /**
+     *
+     * @param predicate The function to call when someone clicks the continue button
+     */
+    setContinueProcess(predicate: ConfirmatorProcess): this;
+    /**
+     * @param predicate The function to call when someone clicks the cancel button.
+     */
+    setCancelProcess(predicate: ConfirmatorProcess): this;
+    /**
+     * @param predicate The function to call when the filter process returns false
+     */
+    setFilterErrorProcess(predicate: ConfirmatorProcess): this;
+    /**
+     * @param predicate The function to call and check if is true, if not  it will throw an error (setted with .setFilterErrorProcess())
+     */
+    setFilterCheckProcess(predicate: ConfirmatorProcess): this;
+    /**
+     * You have to use this after you send the message with the buttons, this is required.
+     * @param message The message that will be used in the process
+     */
+    setMessage(message: Message): this;
+    /**
+     * @param options Optional options to customize your buttons
+     */
+    static Buttons(options?: ConfirmatorButtonsOptions): import("discord.js").APIActionRowComponent<import("discord.js").APIStringSelectComponent | import("discord.js").APIChannelSelectComponent | import("discord.js").APIMentionableSelectComponent | import("discord.js").APIUserSelectComponent | import("discord.js").APIRoleSelectComponent | import("discord.js").APIButtonComponent | import("discord.js").APITextInputComponent>;
+    /**
+     * Start the confirmator, we recommend you to start it after using Confirmator.setMessage()
+     */
+    start(): void;
+}

package/lib/classes/experiments/Confirmator.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Confirmator = void 0;
+
+const discord_js_1 = require("discord.js");
+
+class Confirmator {
+  _author;
+  _continue = async () => null;
+  _cancel = async (interaction) => interaction.reply({ content: "Cancelled process.", ephemeral: true });
+  _filter = async (interaction) => interaction.reply({ content: "This interaction isn't for you!", ephemeral: true });
+  filter = async (interaction) => interaction.user.id !== this._author.id;
+  timeout;
+  message;
+  bot;
+
+  constructor(bot, options) {
+    this._author = options.author;
+    this.bot = bot;
+    this.timeout = options.timeout ?? 60;
+  }
+
+  setContinueProcess(predicate) {
+    this._continue = predicate;
+    return this;
+  }
+
+  setCancelProcess(predicate) {
+    this._cancel = predicate;
+    return this;
+  }
+
+  setFilterErrorProcess(predicate) {
+    this._filter = predicate;
+    return this;
+  }
+
+  setFilterCheckProcess(predicate) {
+    this.filter = predicate;
+    return this;
+  }
+
+  setMessage(message) {
+    this.message = message;
+    return this;
+  }
+
+  static Buttons(options) {
+    const continueButton = new discord_js_1.ButtonBuilder()
+      .setLabel(options?.continue?.label || "Continue")
+      .setStyle(discord_js_1.ButtonStyle.Danger)
+      .setCustomId("continueButton");
+
+    const cancelButton = new discord_js_1.ButtonBuilder()
+      .setLabel(options?.cancel?.label || "Cancel")
+      .setStyle(discord_js_1.ButtonStyle.Success)
+      .setCustomId("cancelButton");
+
+    return new discord_js_1.ActionRowBuilder().addComponents(continueButton, cancelButton).toJSON();
+  }
+
+  async #disableMessageComponents() {
+    if (!this.message?.editable || !this.message.components?.length) return;
+
+    const components = this.message.components.map((row) => {
+      const cloned = discord_js_1.ActionRowBuilder.from(row);
+      for (const component of cloned.components) {
+        component.setDisabled(true);
+      }
+      return cloned;
+    });
+
+    await this.message.edit({ components }).catch(() => null);
+  }
+
+  start() {
+    if (!this.message) {
+      throw new Error("Confirmator.start() requires a message via setMessage().");
+    }
+
+    const collector = this.message.createMessageComponentCollector({
+      time: this.timeout * 1000,
+      componentType: discord_js_1.ComponentType.Button,
+    });
+
+    collector.on("collect", async (interaction) => {
+      if (interaction.customId !== "continueButton" && interaction.customId !== "cancelButton") {
+        return;
+      }
+
+      if (await this.filter(interaction)) {
+        await this._filter(interaction);
+        return;
+      }
+
+      if (interaction.customId === "continueButton") {
+        await interaction.deferUpdate();
+        await collector.stop("confirmed");
+        await this._continue(interaction);
+        return;
+      }
+
+      await interaction.deferUpdate();
+      await collector.stop("cancelled");
+      await this._cancel(interaction);
+    });
+
+    collector.on("end", async () => {
+      await this.#disableMessageComponents();
+    });
+  }
+}
+
+exports.Confirmator = Confirmator;

package/lib/classes/experiments/Paginator.d.ts

@@ -0,0 +1,65 @@
+import { User, Message, ButtonStyle, CollectedInteraction } from "discord.js";
+import { AsyncFunction } from "../Loader.js";
+import { Erine } from "../Client.js";
+export type ButtonSchema = {
+    style?: ButtonStyle;
+    label?: string;
+};
+export type PaginatorProcess = AsyncFunction<CollectedInteraction, boolean>;
+export type PaginatorOptions<P = any> = {
+    pages: P[];
+    author: User;
+    filter?: PaginatorProcess;
+    timeout?: number;
+};
+export type PaginatorButtonsOptions = {
+    next?: ButtonSchema;
+    previous?: ButtonSchema;
+};
+export declare class Paginator<P = any> {
+    pages: P[];
+    filter: PaginatorProcess;
+    bot: Erine;
+    message?: Message;
+    timeout: number;
+    private _author;
+    private _page;
+    private _filter;
+    private _update;
+    constructor(bot: Erine, options: PaginatorOptions);
+    /**
+     * Get the page content (provided in the constructor).
+     */
+    get page(): P;
+    /**
+     * Get the current page number.
+     */
+    get pageNumber(): number;
+    /**
+     * Get the page footer.
+     * @example "3/10"
+     */
+    get pagesFooter(): string;
+    /**
+     * @param predicate The function to call when someone clicks the cancel button.
+     */
+    setUpdateProcess(predicate: AsyncFunction<P, any>): this;
+    /**
+     * @param predicate The function to call when the filter process returns false
+     */
+    setFilterProcess(predicate: PaginatorProcess): this;
+    /**
+     * @param predicate The function to call and check if is true, if not  it will throw an error (setted with .setFilterErrorProcess())
+     */
+    setFilterCheckProcess(predicate: PaginatorProcess): this;
+    /**
+     * You have to use this after you send the message with the buttons, this is required.
+     * @param message The message that will be used in the process
+     */
+    setMessage(message: Message): this;
+    /**
+     * @param options Optional options to customize your buttons
+     */
+    static Buttons(options?: PaginatorButtonsOptions): import("discord.js").APIActionRowComponent<import("discord.js").APIStringSelectComponent | import("discord.js").APIChannelSelectComponent | import("discord.js").APIMentionableSelectComponent | import("discord.js").APIUserSelectComponent | import("discord.js").APIRoleSelectComponent | import("discord.js").APIButtonComponent | import("discord.js").APITextInputComponent>;
+    start(): void;
+}