kythia-core 0.11.1-beta → 0.12.0-beta

package/src/Kythia.js

@@ -1,556 +0,0 @@
-/**
- * 🌸 Kythia Core Application (The Orchestrator)
- *
- * @file src/Kythia.js
- * @copyright © 2025 kenndeclouv
- * @assistant chaa & graa
- * @version 0.11.1-beta
- *
- * @description
- * The heart of the application lifecycle. This class acts as the central
- * Dependency Injection (DI) container and orchestrator for all subsystems.
- * It manages the startup sequence, module loading, and graceful shutdown procedures.
- *
- * ✨ Core Responsibilities:
- * -  Lifecycle Management: Bootstrapping, Running, and Terminating the bot safely.
- * -  IoC Container: Central hub for Services, Managers, and Database connections.
- * -  Addon Orchestration: Loading and initializing modular addons dynamically.
- * -  Event Dispatching: Routes Gateway events to appropriate handlers.
- */
-
-const { REST, Routes, Collection } = require('discord.js');
-const KythiaClient = require('./KythiaClient');
-const Sentry = require('@sentry/node');
-const figlet = require('figlet');
-
-const InteractionManager = require('./managers/InteractionManager');
-const ShutdownManager = require('./managers/ShutdownManager');
-const AddonManager = require('./managers/AddonManager');
-const EventManager = require('./managers/EventManager');
-
-const KythiaMigrator = require('./database/KythiaMigrator');
-// const ModelLoader = require('./database/ModelLoader');
-const bootModels = require('./database/ModelLoader');
-const KythiaModel = require('./database/KythiaModel');
-
-class Kythia {
-	/**
-	 * 🏗️ Kythia Constructor
-	 * Initializes the Discord client, REST API, and dependency container.
-	 * Sets up manager instances (but doesn't start them yet).
-	 */
-	constructor({
-		config,
-		logger,
-		redis,
-		sequelize,
-		translator,
-		models,
-		helpers,
-		utils,
-		appRoot,
-	}) {
-		const missingDeps = [];
-		if (!config) missingDeps.push('config');
-		if (!logger) missingDeps.push('logger');
-		if (!translator) {
-			missingDeps.push('translator');
-		} else {
-			if (!translator.t) missingDeps.push('translator.t');
-			if (!translator.loadLocales) missingDeps.push('translator.loadLocales');
-		}
-		if (missingDeps.length > 0) {
-			console.error(
-				`FATAL: Missing required dependencies: ${missingDeps.join(', ')}.`,
-			);
-			process.exit(1);
-		}
-		this.kythiaConfig = config;
-		this.appRoot = appRoot || process.cwd();
-
-		this.client = KythiaClient();
-		this.client.commands = new Collection();
-		this.rest = new REST({ version: '10' }).setToken(
-			this.kythiaConfig.bot.token,
-		);
-
-		this.models = models;
-		this.helpers = helpers;
-		this.utils = utils;
-
-		this.redis = redis;
-		this.sequelize = sequelize;
-
-		this.logger = logger;
-		this.translator = translator;
-
-		this.container = {
-			client: this.client,
-			sequelize: this.sequelize,
-			logger: this.logger,
-			t: this.translator.t,
-			redis: this.redis,
-			kythiaConfig: this.kythiaConfig,
-			translator: this.translator,
-
-			models: this.models,
-			helpers: this.helpers,
-			appRoot: this.appRoot,
-		};
-
-		this.client.container = this.container;
-		this.client.cooldowns = new Collection();
-
-		this.dbReadyHooks = [];
-		this.clientReadyHooks = [];
-
-		this.addonManager = null;
-		this.interactionManager = null;
-		this.eventManager = null;
-		this.shutdownManager = null;
-	}
-
-	/**
-	 * 🔍 Check Required Config
-	 * Checks if all required configurations are set.
-	 * Throws an error if any required config is missing.
-	 */
-	_checkRequiredConfig() {
-		const requiredBotConfig = [
-			['bot', 'token'],
-			['bot', 'clientId'],
-			['bot', 'clientSecret'],
-		];
-		const missingBotConfigs = [];
-		for (const pathArr of requiredBotConfig) {
-			let value = this.kythiaConfig;
-			for (const key of pathArr) {
-				value = value?.[key];
-			}
-			if (value === undefined || value === null || value === '') {
-				missingBotConfigs.push(pathArr.join('.'));
-			}
-		}
-
-		if (!this.kythiaConfig.db) this.kythiaConfig.db = {};
-
-		let driver = this.kythiaConfig.db.driver;
-		if (!driver || driver === '') {
-			this.kythiaConfig.db.driver = 'sqlite';
-			driver = 'sqlite';
-			this.logger.info('💡 DB driver not specified. Defaulting to: sqlite');
-		} else {
-			driver = driver.toLowerCase();
-			this.kythiaConfig.db.driver = driver;
-		}
-
-		if (driver === 'sqlite') {
-			if (!this.kythiaConfig.db.name || this.kythiaConfig.db.name === '') {
-				this.kythiaConfig.db.name = 'kythiadata.sqlite';
-			}
-		}
-
-		const requiredDbConfig = [
-			['db', 'driver'],
-			['db', 'name'],
-		];
-
-		if (driver !== 'sqlite') {
-			requiredDbConfig.push(
-				['db', 'host'],
-				['db', 'port'],
-				['db', 'user'],
-				['db', 'pass'],
-			);
-		}
-
-		const missingDbConfigs = [];
-		for (const pathArr of requiredDbConfig) {
-			let value = this.kythiaConfig;
-			for (const key of pathArr) {
-				value = value?.[key];
-			}
-			if (value === undefined || value === null || value === '') {
-				missingDbConfigs.push(pathArr.join('.'));
-			}
-		}
-
-		const missingConfigs = missingBotConfigs.concat(missingDbConfigs);
-
-		if (missingConfigs.length > 0) {
-			this.logger.error('❌ Required configurations are not set:');
-			for (const missing of missingConfigs) {
-				this.logger.error(`   - ${missing}`);
-			}
-			process.exit(1);
-		}
-
-		this.logger.info('✔️  All required configurations are set');
-	}
-
-	/**
-	 * 🔘 Register Button Handler
-	 * Delegates to AddonManager
-	 * @param {string} customId - The customId of the button
-	 * @param {Function} handler - The handler function to execute
-	 */
-	registerButtonHandler(customId, handler) {
-		if (this.addonManager) {
-			this.addonManager.registerButtonHandler(customId, handler);
-		}
-	}
-
-	/**
-	 * 📝 Register Modal Handler
-	 * Delegates to AddonManager
-	 * @param {string} customIdPrefix - The prefix of the modal customId
-	 * @param {Function} handler - The handler function to execute
-	 */
-	registerModalHandler(customIdPrefix, handler) {
-		if (this.addonManager) {
-			this.addonManager.registerModalHandler(customIdPrefix, handler);
-		}
-	}
-	/**
-	 * 🟦 Register Select Menu Handler
-	 * Delegates to AddonManager
-	 * @param {string} customIdPrefix - The prefix of the select menu customId
-	 * @param {Function} handler - The handler function to execute
-	 */
-	registerSelectMenuHandler(customIdPrefix, handler) {
-		if (this.addonManager) {
-			this.addonManager.registerSelectMenuHandler(customIdPrefix, handler);
-		}
-	}
-
-	/**
-	 * 🛡️ Validate License (Stub)
-	 * Placeholder for license validation logic for addons.
-	 * @param {string} licenseKey - The license key to validate
-	 * @param {string} addonName - The name of the addon
-	 * @returns {Promise<boolean>} Always returns true (stub)
-	 */
-	async _validateLicense() {
-		return true;
-	}
-
-	/**
-	 * 🚀 Deploy Commands to Discord
-	 * Deploys all registered slash commands to Discord using the REST API.
-	 * @param {Array} commands - Array of command data to deploy
-	 */
-	async _deployCommands(commands) {
-		if (!commands || commands.length === 0) {
-			this.logger.info('No commands to deploy.');
-			return;
-		}
-		try {
-			const { slash, user, message } = this._getCommandCounts(commands);
-			const clientId = this.kythiaConfig.bot.clientId;
-			const devGuildId = this.kythiaConfig.bot.devGuildId;
-
-			if (
-				this.kythiaConfig.env === 'dev' ||
-				this.kythiaConfig.env === 'development'
-			) {
-				if (!devGuildId) {
-					this.logger.warn(
-						'⚠️ devGuildId not set in config. Skipping guild command deployment.',
-					);
-					return;
-				}
-				this.logger.info(`🟠 Deploying to GUILD ${devGuildId}...`);
-				await this.rest.put(
-					Routes.applicationGuildCommands(clientId, devGuildId),
-					{ body: commands },
-				);
-				this.logger.info('✅ Guild commands deployed instantly!');
-			} else {
-				this.logger.info(`🟢 Deploying globally...`);
-				await this.rest.put(Routes.applicationCommands(clientId), {
-					body: commands,
-				});
-				this.logger.info('✅ Global commands deployed successfully!');
-				if (devGuildId) {
-					this.logger.info(
-						`🧹 Clearing old commands from dev guild: ${devGuildId}...`,
-					);
-					try {
-						await this.rest.put(
-							Routes.applicationGuildCommands(clientId, devGuildId),
-							{ body: [] },
-						);
-						this.logger.info('✅ Dev guild commands cleared successfully.');
-					} catch (err) {
-						this.logger.warn(
-							`⚠️ Could not clear dev guild commands (maybe it was already clean): ${err.message}`,
-						);
-					}
-				}
-			}
-
-			this.logger.info(`⭕ All Slash Commands: ${commands.length}`);
-			this.logger.info(`⭕ Top Level Slash Commands: ${slash}`);
-			this.logger.info(`⭕ User Context Menu: ${user}`);
-			this.logger.info(`⭕ Message Context Menu: ${message}`);
-			this.logger.info('▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬');
-		} catch (err) {
-			this.logger.error('❌ Failed to deploy slash commands:', err);
-		}
-	}
-
-	/**
-	 * 🧮 Count command types from JSON array
-	 * @param {Array} commandJsonArray - Array command data to be deployed
-	 * @returns {object} - Object containing counts { slash, user, message }
-	 * @private
-	 */
-	_getCommandCounts(commandJsonArray) {
-		const counts = { slash: 0, user: 0, message: 0 };
-
-		if (!Array.isArray(commandJsonArray)) {
-			this.logger.warn(
-				'commandJsonArray is not iterable. Returning zero counts.',
-			);
-			return counts;
-		}
-
-		for (const cmd of commandJsonArray) {
-			switch (cmd?.type) {
-				case 1:
-				case undefined:
-					counts.slash++;
-					break;
-				case 2:
-					counts.user++;
-					break;
-				case 3:
-					counts.message++;
-					break;
-			}
-		}
-		return counts;
-	}
-
-	/**
-	 * Adds a callback to be executed when the database is ready.
-	 * The callback will be executed after all database models have been synchronized.
-	 * @param {function} callback - Callback to be executed when the database is ready
-	 */
-	addDbReadyHook(callback) {
-		this.dbReadyHooks.push(callback);
-	}
-
-	/**
-	 * Adds a callback to be executed when the client is ready.
-	 * @param {function} callback - Callback to be executed when the client is ready
-	 */
-	addClientReadyHook(callback) {
-		this.clientReadyHooks.push(callback);
-	}
-
-	/**
-	 * 🌸 Start the Kythia Bot
-	 * Main orchestration method that:
-	 * 1. Initializes Redis cache
-	 * 2. Creates and starts all managers
-	 * 3. Loads addons via AddonManager
-	 * 4. Initializes database
-	 * 5. Sets up interaction and event handlers
-	 * 6. Deploys commands
-	 * 7. Logs in to Discord
-	 */
-	async start() {
-		const version = require('../package.json').version;
-		const clc = require('cli-color');
-		const figletText = (text, opts) =>
-			new Promise((resolve, reject) => {
-				figlet.text(text, opts, (err, data) => {
-					if (err) reject(err);
-					else resolve(data);
-				});
-			});
-
-		try {
-			const data = await figletText('KYTHIA', {
-				font: 'ANSI Shadow',
-				horizontalLayout: 'full',
-				verticalLayout: 'full',
-			});
-
-			const infoLines = [
-				clc.cyan('Created by kenndeclouv'),
-				clc.cyan('Discord Support: ') + clc.underline('https://dsc.gg/kythia'),
-				clc.cyan('Official Documentation: ') +
-					clc.underline('https://docs.kythia.me'),
-				'',
-				clc.cyanBright(`Kythia version: ${version}`),
-				'',
-				clc.yellowBright('Respect my work by not removing the credit'),
-			];
-
-			const rawInfoLines = infoLines.map((line) => clc.strip(line));
-			const infoMaxLen = Math.max(...rawInfoLines.map((l) => l.length));
-			const pad = 8;
-			const borderWidth = infoMaxLen + pad * 2;
-			const borderChar = clc.cyanBright('═');
-			const sideChar = clc.cyanBright('║');
-			const topBorder = clc.cyanBright(`╔${borderChar.repeat(borderWidth)}╗`);
-			const bottomBorder = clc.cyanBright(
-				`╚${borderChar.repeat(borderWidth)}╝`,
-			);
-			const emptyLine = sideChar + ' '.repeat(borderWidth) + sideChar;
-
-			const figletLines = data.split('\n');
-			const centeredFigletInBorder = figletLines
-				.map((line) => {
-					const rawLen = clc.strip(line).length;
-					const spaces = ' '.repeat(
-						Math.max(0, Math.floor((borderWidth - rawLen) / 2)),
-					);
-					return (
-						sideChar +
-						spaces +
-						clc.cyanBright(line) +
-						' '.repeat(borderWidth - spaces.length - rawLen) +
-						sideChar
-					);
-				})
-				.join('\n');
-
-			const centeredInfo = infoLines
-				.map((line, idx) => {
-					const raw = rawInfoLines[idx];
-					const spaces = ' '.repeat(Math.floor((borderWidth - raw.length) / 2));
-					return (
-						sideChar +
-						spaces +
-						line +
-						' '.repeat(borderWidth - spaces.length - raw.length) +
-						sideChar
-					);
-				})
-				.join('\n');
-
-			console.log(`\n${topBorder}`);
-			console.log(emptyLine);
-			console.log(centeredFigletInBorder);
-			console.log(emptyLine);
-			console.log(centeredInfo);
-			console.log(emptyLine);
-			console.log(`${bottomBorder}\n`);
-		} catch (err) {
-			this.logger.error('❌ Failed to render figlet banner:', err);
-		}
-
-		this.logger.info('🚀 Starting kythia...');
-
-		if (this.kythiaConfig.sentry.dsn) {
-			Sentry.init({
-				dsn: this.kythiaConfig.sentry.dsn,
-				tracesSampleRate: 1.0,
-				profilesSampleRate: 1.0,
-			});
-			this.logger.info('✔️  Sentry Error Tracking is ACTIVE');
-		} else {
-			this.logger.warn(
-				'🟠 Sentry DSN not found in config. Error tracking is INACTIVE.',
-			);
-		}
-
-		this._checkRequiredConfig();
-
-		try {
-			const shouldDeploy = process.argv.includes('--deploy');
-
-			this.logger.info('▬▬▬▬▬▬▬▬▬▬▬[ Load Locales & Fonts ]▬▬▬▬▬▬▬▬▬▬▬');
-			this.translator.loadLocales();
-			if (
-				this.helpers?.fonts &&
-				typeof this.helpers.fonts.loadFonts === 'function'
-			) {
-				this.helpers.fonts.loadFonts({ logger: this.logger });
-			}
-
-			this.logger.info('▬▬▬▬▬▬▬▬▬▬▬▬▬▬[ Initialize Cache ]▬▬▬▬▬▬▬▬▬▬▬▬▬▬');
-
-			this.logger.info('▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬[ Kythia Addons ]▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬');
-			this.addonManager = new AddonManager({
-				client: this.client,
-				container: this.container,
-			});
-			const allCommands = await this.addonManager.loadAddons(this);
-
-			this.logger.info('▬▬▬▬▬▬▬▬▬▬▬▬▬▬[ Connect Database ]▬▬▬▬▬▬▬▬▬▬▬▬▬▬');
-			await this.sequelize.authenticate();
-
-			await KythiaMigrator({
-				sequelize: this.sequelize,
-				container: this.container,
-				logger: this.logger,
-			});
-
-			await bootModels(this, this.sequelize);
-
-			this.logger.info('🪝 Attaching Cache Hooks...');
-
-			KythiaModel.attachHooksToAllModels(this.sequelize, this.client);
-
-			const handlers = this.addonManager.getHandlers();
-			this.eventManager = new EventManager({
-				client: this.client,
-				container: this.container,
-				eventHandlers: handlers.eventHandlers,
-			});
-			this.eventManager.initialize();
-
-			this.interactionManager = new InteractionManager({
-				client: this.client,
-				container: this.container,
-				handlers: handlers,
-			});
-			this.interactionManager.initialize();
-
-			this.logger.info('▬▬▬▬▬▬▬▬▬▬▬▬▬[ Deploy Commands ]▬▬▬▬▬▬▬▬▬▬▬▬▬');
-			if (shouldDeploy) {
-				await this._deployCommands(allCommands);
-			} else {
-				this.logger.info(
-					'⏭️  Skipping command deployment. Use --deploy flag to force update.',
-				);
-			}
-
-			this.shutdownManager = new ShutdownManager({
-				client: this.client,
-				container: this.container,
-			});
-			this.shutdownManager.initialize();
-
-			this.logger.info('▬▬▬▬▬▬▬▬▬▬▬[ Systems Initializing ]▬▬▬▬▬▬▬▬▬▬▬▬');
-
-			this.client.once('clientReady', async (c) => {
-				this.logger.info(`🌸 Logged in as ${this.client.user.tag}`);
-				this.logger.info(
-					`🚀 Executing ${this.clientReadyHooks.length} client-ready hooks...`,
-				);
-				for (const hook of this.clientReadyHooks) {
-					try {
-						await hook(c);
-					} catch (error) {
-						this.logger.error('Failed to execute a client-ready hook:', error);
-					}
-				}
-			});
-
-			await this.client.login(this.kythiaConfig.bot.token);
-		} catch (error) {
-			this.logger.error('❌ Kythia initialization failed:', error);
-			if (this.kythiaConfig.sentry.dsn) {
-				Sentry.captureException(error);
-			}
-			process.exit(1);
-		}
-	}
-}
-
-module.exports = Kythia;

package/src/KythiaClient.js

@@ -1,93 +0,0 @@
-/**
- * 🌐 Optimized Discord Client Factory
- *
- * @file src/client/kythiaClient.js
- * @copyright © 2025 kenndeclouv
- * @assistant chaa & graa
- * @version 0.11.1-beta
- *
- * @description
- * Factory function that initializes the Discord.js Client with high-performance
- * memory management strategies tailored for VPS environments.
- *
- * ✨ Optimization Highlights:
- * -  Rolling Buffer Cache: Limits GuildMember cache to active users (Rolling Window) to save RAM.
- * -  Aggressive Sweepers: Periodically clears stale cache data every hour.
- * -  Voice Priority: Always caches members connected to Voice Channels.
- * -  Zero-Presence: Disables PresenceManager completely for maximum efficiency.
- */
-
-const { Client, GatewayIntentBits, Partials, Options } = require('discord.js');
-
-module.exports = function kythiaClient() {
-	const client = new Client({
-		intents: [
-			GatewayIntentBits.Guilds,
-			GatewayIntentBits.GuildMessages,
-			GatewayIntentBits.MessageContent,
-			GatewayIntentBits.GuildMembers,
-			GatewayIntentBits.GuildModeration,
-			GatewayIntentBits.GuildInvites,
-			GatewayIntentBits.GuildVoiceStates,
-			GatewayIntentBits.AutoModerationExecution,
-			GatewayIntentBits.DirectMessages,
-			GatewayIntentBits.DirectMessageReactions,
-			GatewayIntentBits.DirectMessageTyping,
-			GatewayIntentBits.GuildExpressions,
-		],
-
-		partials: [
-			Partials.Message,
-			Partials.Channel,
-			Partials.Reaction,
-			Partials.User,
-			Partials.GuildMember,
-		],
-
-		makeCache: Options.cacheWithLimits({
-			PresenceManager: 0,
-
-			ThreadManager: {
-				maxSize: 25,
-			},
-
-			GuildMemberManager: {
-				maxSize: 200,
-				keepOverLimit: (member) =>
-					(client.user && member.id === client.user.id) ||
-					(member.guild && member.id === member.guild.ownerId) ||
-					(member.voice && member.voice.channelId !== null) ||
-					member.roles.cache.size > 5,
-			},
-
-			UserManager: {
-				maxSize: 1000,
-				keepOverLimit: (user) => user.id === client.user.id,
-			},
-		}),
-
-		sweepers: {
-			...Options.DefaultSweeperSettings,
-			messages: {
-				interval: 3600,
-				lifetime: 1800,
-			},
-			threads: {
-				interval: 3600,
-				lifetime: 1800,
-			},
-
-			users: {
-				interval: 3600,
-
-				filter: () => (user) => {
-					if (user.bot) return false;
-					if (user.id === client.user.id) return false;
-					return true;
-				},
-			},
-		},
-	});
-
-	return client;
-};

package/src/cli/Command.js

@@ -1,68 +0,0 @@
-/**
- * 🏗️ Abstract Base Command
- *
- * @file src/cli/Command.js
- * @copyright © 2025 kenndeclouv
- * @assistant chaa & graa
- * @version 0.11.1-beta
- *
- * @description
- * The base class for all Kythia CLI commands. It enforces a standard structure
- * (signature, description, handle) and manages the integration with Commander.js.
- *
- * ✨ Core Features:
- * -  Standardized Interface: Enforces `handle()` implementation.
- * -  Flexible Parsing: Handles both Options and Arguments intelligently.
- * -  Auto Registration: Simplifies wiring commands to the main program.
- */
-
-class Command {
-	/**
-	 * The name and signature of the console command.
-	 * @type {string}
-	 */
-	signature = '';
-
-	/**
-	 * The console command description.
-	 * @type {string}
-	 */
-	description = '';
-
-	/**
-	 * Execute the console command.
-	 * @param {Object} options - The options object from Commander
-	 * @param {...any} args - Positional arguments (if any)
-	 */
-	async handle(_options, ..._args) {
-		throw new Error('Command must implement handle method');
-	}
-
-	/**
-	 * Register the command with the program.
-	 * @param {import('commander').Command} program
-	 */
-	register(program) {
-		const cmd = program
-			.command(this.signature)
-			.description(this.description)
-			.action((...args) => {
-				const _commandObj = args.pop();
-				const opts = args.pop() || {};
-
-				this.handle(opts, ...args);
-			});
-
-		this.configure(cmd);
-	}
-
-	/**
-	 * Configure additional options or arguments.
-	 * @param {import('commander').Command} cmd
-	 */
-	configure(_cmd) {
-		// Override to add options
-	}
-}
-
-module.exports = Command;