@sern/handler/dist/core/modules.js

A complete, customizable, typesafe, & reactive framework for discord bots.

"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
exports.scheduledTask = exports.discordEvent = exports.eventModule = exports.commandModule = void 0;
const enums_1 = require("../core/structures/enums");
const functions_1 = require("./functions");
/**
 * Creates a command module with standardized structure and plugin support.
 *
 * @since 1.0.0
 * @param {InputCommand} mod - Command module configuration
 * @returns {Module} Processed command module ready for registration
 *
 * @example
 * // Basic slash command
 * export default commandModule({
 *   type: CommandType.Slash,
 *   description: "Ping command",
 *   execute: async (ctx) => {
 *     await ctx.reply("Pong! 🏓");
 *   }
 * });
 *
 * @example
 * // Command with component interaction
 * export default commandModule({
 *   type: CommandType.Slash,
 *   description: "Interactive command",
 *   execute: async (ctx) => {
 *     const button = new ButtonBuilder({
 *       customId: "btn/someData",
 *       label: "Click me",
 *       style: ButtonStyle.Primary
 *     });
 *     await ctx.reply({
 *       content: "Interactive message",
 *       components: [new ActionRowBuilder().addComponents(button)]
 *     });
 *   }
 * });
 */
function commandModule(mod) {
    const [onEvent, plugins] = (0, functions_1.partitionPlugins)(mod.plugins);
    return { ...mod,
        onEvent,
        plugins,
        locals: {} };
}
exports.commandModule = commandModule;
/**
 * Creates an event module for handling Discord.js or custom events.
 *
 * @since 1.0.0
 * @template T - Event name from ClientEvents
 * @param {InputEvent<T>} mod - Event module configuration
 * @returns {Module} Processed event module ready for registration
 * @throws {Error} If ControlPlugins are used in event modules
 *
 * @example
 * // Discord event listener
 * export default eventModule({
 *   type: EventType.Discord,
 *   execute: async (message) => {
 *     console.log(`${message.author.tag}: ${message.content}`);
 *   }
 * });
 *
 * @example
 * // Custom sern event
 * export default eventModule({
 *   type: EventType.Sern,
 *   execute: async (eventData) => {
 *     // Handle sern-specific event
 *   }
 * });
 */
function eventModule(mod) {
    const [onEvent, plugins] = (0, functions_1.partitionPlugins)(mod.plugins);
    if (onEvent.length !== 0)
        throw Error("Event modules cannot have ControlPlugins");
    return { ...mod,
        plugins,
        locals: {} };
}
exports.eventModule = eventModule;
/** Create event modules from discord.js client events,
 * This was an {@link eventModule} for discord events,
 * where typings were bad.
 * @deprecated Use {@link eventModule} instead
 * @param mod
 */
function discordEvent(mod) {
    return eventModule({ type: enums_1.EventType.Discord, ...mod, });
}
exports.discordEvent = discordEvent;
/**
 * Creates a scheduled task that can be executed at specified intervals using cron patterns
 *
 * @param {ScheduledTask} ism - The scheduled task configuration object
 * @param {string} ism.trigger - A cron pattern that determines when the task should execute
 *                              Format: "* * * * *" (minute hour day month day-of-week)
 * @param {Function} ism.execute - The function to execute when the task is triggered
 * @param {Object} ism.execute.context - The execution context passed to the task
 *
 * @returns {ScheduledTask} The configured scheduled task
 *
 * @example
 * // Create a task that runs every minute
 * export default scheduledTask({
 *   trigger: "* * * * *",
 *   execute: (context) => {
 *     console.log("Task executed!");
 *   }
 * });
 *
 * @remarks
 * - Tasks must be placed in the 'tasks' directory specified in your config
 * - The file name serves as a unique identifier for the task
 * - Tasks can be cancelled using deps['@sern/scheduler'].kill(uuid)
 *
 * @see {@link https://crontab.guru/} for testing and creating cron patterns
 */
function scheduledTask(ism) {
    return ism;
}
exports.scheduledTask = scheduledTask;
//# sourceMappingURL=modules.js.map