kythia-core 0.9.5-beta → 0.11.0-beta

package/src/cli/index.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+
+/**
+ * ⚡ Kythia CLI Entry Point
+ *
+ * @file src/cli/index.js
+ * @copyright © 2025 kenndeclouv
+ * @assistant chaa & graa
+ * @version 0.11.0-beta
+ *
+ * @description
+ * The main bootstrap entry point for the Kythia CLI.
+ * It dynamically scans, loads, and registers all command classes found in the
+ * `commands` directory, orchestrating the `commander` program execution.
+ *
+ * ✨ Core Features:
+ * -  Dynamic Loading: Automatically finds new commands without manual import.
+ * -  Class-Based Architecture: Supports standard `Command` class structure.
+ * -  Error Handling: Gracefully handles malformed commands during boot.
+ */
+
+const { version } = require('../../package.json');
+const { Command } = require('commander');
+const BaseCommand = require('./Command');
+const path = require('node:path');
+const pc = require('picocolors');
+const fs = require('node:fs');
+
+const program = new Command();
+
+program
+	.name('kythia')
+	.description(pc.cyan('🌸 Kythia Framework CLI'))
+	.version(version);
+
+const commandsDir = path.join(__dirname, 'commands');
+
+if (fs.existsSync(commandsDir)) {
+	const commandFiles = fs
+		.readdirSync(commandsDir)
+		.filter((file) => file.endsWith('.js'));
+
+	for (const file of commandFiles) {
+		const filePath = path.join(commandsDir, file);
+		try {
+			const CommandClass = require(filePath);
+
+			if (
+				typeof CommandClass === 'function' &&
+				CommandClass.prototype instanceof BaseCommand
+			) {
+				const commandInstance = new CommandClass();
+				commandInstance.register(program);
+			} else if (typeof CommandClass.register === 'function') {
+				CommandClass.register(program);
+			} else {
+				console.warn(
+					pc.yellow(
+						`⚠️  Skipped ${file}: Not a valid Command class or missing 'register' function.`,
+					),
+				);
+			}
+		} catch (err) {
+			console.error(pc.red(`❌ Failed to load command ${file}:`), err);
+		}
+	}
+}
+
+program.parse(process.argv);

package/src/cli/utils/db.js

@@ -0,0 +1,117 @@
+/**
+ * 🔌 CLI Database & Migration Bootstrapper
+ *
+ * @file src/cli/utils/db.js
+ * @copyright © 2025 kenndeclouv
+ * @assistant chaa & graa
+ * @version 0.11.0-beta
+ *
+ * @description
+ * Initializes the database connection and migration engine (Umzug) specifically
+ * for CLI operations. It dynamically loads the project configuration and
+ * discovers migration files across all addons.
+ *
+ * ✨ Core Features:
+ * -  Dynamic Config: Loads `kythia.config.js` from the user's project root.
+ * -  Auto-Discovery: Scans `addons` directory for migration files.
+ * -  Pretty Logging: Custom console output using `picocolors` for migration status.
+ * -  Singleton-like: Exports shared instances of Sequelize and Umzug.
+ */
+
+require('@dotenvx/dotenvx/config');
+const fs = require('node:fs');
+const path = require('node:path');
+const { Umzug } = require('umzug');
+const createSequelizeInstance = require('../../database/KythiaSequelize');
+const KythiaStorage = require('../../database/KythiaStorage');
+const pc = require('picocolors');
+
+const configPath = path.resolve(process.cwd(), 'kythia.config.js');
+
+if (!fs.existsSync(configPath)) {
+	console.error('❌ kythia.config.js not found in root directory!');
+	process.exit(1);
+}
+
+const config = require(configPath);
+
+const logger = {
+	info: () => {},
+	error: console.error,
+	debug: () => {},
+};
+
+const sequelize = createSequelizeInstance(config, logger);
+
+function getMigrationFiles() {
+	const rootDir = process.cwd();
+	const addonsDir = path.join(rootDir, 'addons');
+
+	if (!fs.existsSync(addonsDir)) return [];
+
+	const migrationFiles = [];
+	const addonFolders = fs
+		.readdirSync(addonsDir)
+		.filter((f) => fs.statSync(path.join(addonsDir, f)).isDirectory());
+
+	for (const addon of addonFolders) {
+		const migrationDir = path.join(addonsDir, addon, 'database', 'migrations');
+		if (fs.existsSync(migrationDir)) {
+			const files = fs
+				.readdirSync(migrationDir)
+				.filter((f) => f.endsWith('.js'))
+				.map((f) => ({
+					name: f,
+					path: path.join(migrationDir, f),
+				}));
+			migrationFiles.push(...files);
+		}
+	}
+	return migrationFiles.sort((a, b) => a.name.localeCompare(b.name));
+}
+
+const storage = new KythiaStorage({ sequelize });
+
+const umzugLogger = {
+	info: (event) => {
+		if (typeof event === 'object') {
+			if (event.event === 'migrated') {
+				console.log(
+					pc.green(`✅ Migrated:  ${event.name} `) +
+						pc.gray(`(${event.durationSeconds}s)`),
+				);
+			} else if (event.event === 'reverting') {
+				console.log(pc.yellow(`↩️ Reverting: ${event.name}`));
+			} else if (event.event === 'reverted') {
+				console.log(
+					pc.red(`❌ Reverted:  ${event.name} `) +
+						pc.gray(`(${event.durationSeconds}s)`),
+				);
+			}
+		} else {
+			console.log(pc.dim(event));
+		}
+	},
+	warn: (msg) => console.warn(pc.yellow(`⚠️ ${msg}`)),
+	error: (msg) => console.error(pc.red(`🔥 ${msg}`)),
+};
+
+const umzug = new Umzug({
+	migrations: getMigrationFiles().map((m) => ({
+		name: m.name,
+		path: m.path,
+		up: async ({ context }) => {
+			const migration = require(m.path);
+			return migration.up(context, require('sequelize').DataTypes);
+		},
+		down: async ({ context }) => {
+			const migration = require(m.path);
+			return migration.down(context, require('sequelize').DataTypes);
+		},
+	})),
+	context: sequelize.getQueryInterface(),
+	storage: storage,
+	logger: umzugLogger,
+});
+
+module.exports = { sequelize, umzug, storage };

package/src/database/KythiaMigrator.js

@@ -0,0 +1,116 @@
+/**
+ * 🚜 Addon-based Database Migration Manager
+ *
+ * @file src/database/KythiaMigrator.js
+ * @copyright © 2025 kenndeclouv
+ * @assistant chaa & graa
+ * @version 0.11.0-beta
+ *
+ * @description
+ * Scans 'addons' folder for migration files and executes them using Umzug.
+ * It integrates with KythiaStorage (Laravel-style) to track migration batches.
+ *
+ * ✨ Core Features:
+ * -  Auto-Discovery: Recursively finds migrations in `addons/{AddonName}/database/migrations`.
+ * -  Sorting: Ensures migrations run in correct order (YYYYMMDD format).
+ * -  Custom Logger: Clean, non-intrusive logging for the bot console.
+ * -  Batch Integration: Uses KythiaStorage to support rollback by batch.
+ */
+
+const KythiaStorage = require('./KythiaStorage');
+const { DataTypes } = require('sequelize');
+const { Umzug } = require('umzug');
+const path = require('node:path');
+const fs = require('node:fs');
+
+function getMigrationFiles(rootDir) {
+	const addonsDir = path.join(rootDir, 'addons');
+	if (!fs.existsSync(addonsDir)) return [];
+
+	const migrationFiles = [];
+
+	const addonFolders = fs
+		.readdirSync(addonsDir)
+		.filter((f) => fs.statSync(path.join(addonsDir, f)).isDirectory());
+
+	for (const addon of addonFolders) {
+		const migrationDir = path.join(addonsDir, addon, 'database', 'migrations');
+		if (fs.existsSync(migrationDir)) {
+			const files = fs
+				.readdirSync(migrationDir)
+				.filter((f) => f.endsWith('.js'))
+				.map((f) => ({
+					name: f,
+					path: path.join(migrationDir, f),
+					folder: migrationDir,
+				}));
+			migrationFiles.push(...files);
+		}
+	}
+
+	return migrationFiles.sort((a, b) => a.name.localeCompare(b.name));
+}
+
+async function KythiaMigrator({ sequelize, container, logger }) {
+	const rootDir = container.appRoot;
+	const migrations = getMigrationFiles(rootDir);
+
+	if (migrations.length === 0) {
+		logger.info('📭 No migrations found in addons.');
+		return;
+	}
+
+	const umzugLogger = {
+		info: (event) => {
+			if (typeof event === 'object') {
+				if (event.event === 'migrating') {
+				} else if (event.event === 'migrated') {
+					logger.info(`✅ Migrated: ${event.name}`);
+				}
+			} else {
+				logger.info(event);
+			}
+		},
+		warn: (msg) => logger.warn(msg),
+		error: (msg) => logger.error(msg),
+	};
+
+	const umzug = new Umzug({
+		migrations: migrations.map((m) => ({
+			name: m.name,
+			path: m.path,
+			up: async ({ context }) => {
+				const migration = require(m.path);
+				return migration.up(context, DataTypes);
+			},
+			down: async ({ context }) => {
+				const migration = require(m.path);
+				return migration.down(context, DataTypes);
+			},
+		})),
+		context: sequelize.getQueryInterface(),
+
+		storage: new KythiaStorage({ sequelize }),
+		logger: umzugLogger,
+	});
+
+	logger.info(`🚜 Checking migrations for ${migrations.length} files...`);
+
+	try {
+		const pending = await umzug.pending();
+
+		if (pending.length > 0) {
+			const executed = await umzug.up();
+			if (executed.length > 0) {
+				logger.info(`✨ Successfully applied ${executed.length} migrations.`);
+			}
+		} else {
+			logger.info('✨ Database is already up to date.');
+		}
+	} catch (error) {
+		logger.error('🔥 Migration Failed:', error);
+		process.exit(1);
+	}
+}
+
+module.exports = KythiaMigrator;