kythia-core 0.11.0-beta → 0.12.0-beta

package/src/cli/commands/LangTranslateCommand.js

@@ -1,336 +0,0 @@
-/**
- * 🌐 AI Localization Assistant
- *
- * @file src/cli/commands/LangTranslateCommand.js
- * @copyright © 2025 kenndeclouv
- * @assistant chaa & graa
- * @version 0.11.0-beta
- *
- * @description
- * Automates the translation of the core language file (`en.json`) to a target language
- * using Google's Gemini AI. Handles JSON flattening, batch processing, and placeholder preservation.
- *
- * ✨ Core Features:
- * -  AI-Powered: Uses Gemini 2.5 Flash for natural translations.
- * -  Smart Batching: Splits large files to avoid token limits.
- * -  Context Aware: Preserves keys and complex placeholders.
- */
-
-const Command = require('../Command');
-const pc = require('picocolors');
-
-class LangTranslateCommand extends Command {
-	signature = 'lang:translate <target>';
-	description = 'Translate en.json to target language using Gemini AI';
-
-	async handle(_options, target) {
-		require('@dotenvx/dotenvx/config');
-		const fs = require('node:fs');
-		const path = require('node:path');
-		const { GoogleGenAI } = require('@google/genai');
-
-		const API_KEYS = (process.env.GEMINI_API_KEYS || '')
-			.split(',')
-			.filter(Boolean);
-
-		const targetLang = target || 'ja';
-
-		const TARGET_LANGUAGE =
-			targetLang === 'ja' ? 'Japan (ja)' : `${targetLang}`;
-
-		const rootDir = process.cwd();
-		const INPUT_FILE_SAFE = path.join(
-			rootDir,
-			'addons',
-			'core',
-			'lang',
-			'en.json',
-		);
-		const OUTPUT_FILE_SAFE = path.join(
-			rootDir,
-			'addons',
-			'core',
-			'lang',
-			`${targetLang}.json`,
-		);
-
-		const BATCH_SIZE = 80;
-		const GEMINI_MODEL = 'gemini-2.5-flash';
-		const DELAY_BETWEEN_BATCHES_MS = 5000;
-		const DELAY_ON_ERROR_MS = 5000;
-
-		if (API_KEYS.length === 0) {
-			console.error(pc.red('❌ FATAL: GEMINI_API_KEYS not found in .env!'));
-			process.exit(1);
-		}
-
-		let keyIndex = 0;
-		function getNextGenAI(nextIndex = null) {
-			if (typeof nextIndex === 'number') {
-				keyIndex = nextIndex % API_KEYS.length;
-			}
-			const apiKey = API_KEYS[keyIndex];
-			keyIndex = (keyIndex + 1) % API_KEYS.length;
-			console.log(
-				`[Key Rotator] Using API Key #${keyIndex === 0 ? API_KEYS.length : keyIndex}`,
-			);
-			return new GoogleGenAI({ apiKey });
-		}
-
-		function flattenObject(obj, parentKey = '', result = {}) {
-			for (const key in obj) {
-				const newKey = parentKey ? `${parentKey}.${key}` : key;
-				if (
-					typeof obj[key] === 'object' &&
-					obj[key] !== null &&
-					!Array.isArray(obj[key])
-				) {
-					flattenObject(obj[key], newKey, result);
-				} else {
-					result[newKey] = obj[key];
-				}
-			}
-			return result;
-		}
-
-		function unflattenObject(obj) {
-			const result = {};
-			for (const key in obj) {
-				const keys = key.split('.');
-				keys.reduce((acc, cur, i) => {
-					if (i === keys.length - 1) {
-						acc[cur] = obj[key];
-					} else {
-						acc[cur] = acc[cur] || {};
-					}
-					return acc[cur];
-				}, result);
-			}
-			return result;
-		}
-
-		async function translateBatch(batch) {
-			const placeholderMap = new Map();
-			let placeholderCounter = 0;
-
-			const processedBatch = JSON.parse(
-				JSON.stringify(batch),
-				(_key, value) => {
-					if (typeof value !== 'string') return value;
-					return value.replace(/{([^{}]*)}/g, (match) => {
-						if (!placeholderMap.has(match)) {
-							placeholderMap.set(`__P_${placeholderCounter}__`, match);
-							placeholderCounter++;
-						}
-						for (const [token, ph] of placeholderMap.entries()) {
-							if (ph === match) return token;
-						}
-						return match;
-					});
-				},
-			);
-
-			const prompt = `
-You are a professional localization expert. Translate the JSON values from english to ${TARGET_LANGUAGE}.
-
-- **Target Locale:** ${targetLang} (choose naturally)
-- **DO NOT** translate the JSON keys.
-- **DO NOT** translate any placeholder tokens that look like \`__P_N__\`. Keep them exactly as they are.
-- **KEEP** all original markdown (\`##\`, \`*\`, \`\\\`\`, \`\n\`).
-- Respond ONLY with the translated JSON object, in a VALID JSON format.
-
-Input:
-${JSON.stringify(processedBatch, null, 2)}
-
-Output:
-`;
-
-			let attempt = 1;
-			let usedKeyIndex = keyIndex;
-
-			while (true) {
-				let genAI = getNextGenAI();
-				const GEMINI_API_CLIENT = genAI;
-				try {
-					console.log(`[Batch] Attempt #${attempt}...`);
-
-					const response = await GEMINI_API_CLIENT.models.generateContent({
-						model: GEMINI_MODEL,
-						contents: [{ role: 'user', parts: [{ text: prompt }] }],
-					});
-
-					let text;
-					if (response && typeof response.text === 'function') {
-						text = response.text();
-					} else if (response && typeof response.text === 'string') {
-						text = response.text;
-					}
-					text = typeof text === 'string' ? text.trim() : '';
-
-					if (text.startsWith('```json')) {
-						text = text.substring(7, text.length - 3).trim();
-					} else if (text.startsWith('```')) {
-						text = text
-							.replace(/^```[a-z]*\n?/, '')
-							.replace(/```$/, '')
-							.trim();
-					}
-
-					let translatedBatch = JSON.parse(text);
-					translatedBatch = JSON.parse(
-						JSON.stringify(translatedBatch),
-						(_key, value) => {
-							if (typeof value !== 'string') return value;
-							return value.replace(
-								/__P_(\d+)__/g,
-								(match) => placeholderMap.get(match) || match,
-							);
-						},
-					);
-
-					return translatedBatch;
-				} catch (e) {
-					const errorMessage = e.message || '';
-					console.error(
-						pc.red(`❌ Error in batch (Attempt ${attempt})...`),
-						errorMessage,
-					);
-
-					if (
-						errorMessage.includes('429') ||
-						errorMessage.includes('RESOURCE_EXHAUSTED')
-					) {
-						usedKeyIndex = (usedKeyIndex + 1) % API_KEYS.length;
-						console.warn(
-							pc.yellow(
-								`[RATE LIMIT] Got 429! Rotating to next API key [#${usedKeyIndex + 1}] and retrying.`,
-							),
-						);
-						genAI = getNextGenAI(usedKeyIndex);
-					} else {
-						console.warn(
-							pc.yellow(
-								`[OTHER ERROR] Waiting ${DELAY_ON_ERROR_MS / 1000} seconds...`,
-							),
-						);
-						await new Promise((resolve) =>
-							setTimeout(resolve, DELAY_ON_ERROR_MS),
-						);
-					}
-					attempt++;
-				}
-			}
-		}
-
-		console.log(
-			pc.cyan(`🚀 Starting translation process (to ${targetLang})...`),
-		);
-		console.log(pc.dim(`   Input: ${INPUT_FILE_SAFE}`));
-		console.log(pc.dim(`   Output: ${OUTPUT_FILE_SAFE}`));
-
-		if (!fs.existsSync(INPUT_FILE_SAFE)) {
-			console.error(pc.red(`❌ Input file not found: ${INPUT_FILE_SAFE}`));
-			process.exit(1);
-		}
-
-		const idJsonString = fs.readFileSync(INPUT_FILE_SAFE, 'utf8');
-		const idJson = JSON.parse(idJsonString);
-
-		console.log(pc.dim('Flattening JSON...'));
-		const flatIdJson = flattenObject(idJson);
-		const flatLangJson = {};
-		const allKeys = Object.keys(flatIdJson);
-
-		let existingLangJson = {};
-		if (fs.existsSync(OUTPUT_FILE_SAFE)) {
-			console.log(
-				pc.yellow(`[INFO] File ${OUTPUT_FILE_SAFE} exists, continuing work...`),
-			);
-			try {
-				existingLangJson = flattenObject(
-					JSON.parse(fs.readFileSync(OUTPUT_FILE_SAFE, 'utf8')),
-				);
-			} catch (_e) {
-				console.warn(
-					pc.yellow(
-						`[WARN] File ${OUTPUT_FILE_SAFE} is corrupted, will be overwritten.`,
-					),
-				);
-			}
-		}
-
-		const keysToTranslate = allKeys.filter(
-			(key) =>
-				typeof flatIdJson[key] === 'string' &&
-				(!existingLangJson[key] || existingLangJson[key] === flatIdJson[key]),
-		);
-
-		allKeys.forEach((key) => {
-			if (!keysToTranslate.includes(key)) {
-				flatLangJson[key] = existingLangJson[key] || flatIdJson[key];
-			}
-		});
-
-		const totalBatches = Math.ceil(keysToTranslate.length / BATCH_SIZE);
-
-		console.log(pc.green(`✅ Total of ${allKeys.length} keys.`));
-		console.log(
-			pc.green(
-				`✅ Found ${keysToTranslate.length} keys that need translation.`,
-			),
-		);
-		console.log(
-			pc.green(
-				`✅ Divided into ${totalBatches} batches (up to ${BATCH_SIZE} keys per batch).`,
-			),
-		);
-
-		for (let i = 0; i < totalBatches; i++) {
-			console.log(
-				pc.cyan(`--- 🏃 Working on Batch ${i + 1} / ${totalBatches} ---`),
-			);
-			const batchKeys = keysToTranslate.slice(
-				i * BATCH_SIZE,
-				(i + 1) * BATCH_SIZE,
-			);
-			const batchToTranslate = {};
-			batchKeys.forEach((key) => {
-				batchToTranslate[key] = flatIdJson[key];
-			});
-
-			if (Object.keys(batchToTranslate).length > 0) {
-				const translatedBatch = await translateBatch(batchToTranslate);
-				if (translatedBatch) {
-					Object.assign(flatLangJson, translatedBatch);
-				} else {
-					Object.assign(flatLangJson, batchToTranslate);
-				}
-			}
-
-			if (i < totalBatches - 1) {
-				console.log(
-					pc.yellow(
-						`--- 😴 Waiting ${DELAY_BETWEEN_BATCHES_MS / 1000} seconds between batches ---`,
-					),
-				);
-				await new Promise((resolve) =>
-					setTimeout(resolve, DELAY_BETWEEN_BATCHES_MS),
-				);
-			}
-		}
-
-		console.log(pc.dim('Unflattening JSON...'));
-		const langJson = unflattenObject(flatLangJson);
-
-		console.log(pc.green(`Saving to file: ${OUTPUT_FILE_SAFE}`));
-		fs.writeFileSync(
-			OUTPUT_FILE_SAFE,
-			JSON.stringify(langJson, null, 2),
-			'utf8',
-		);
-
-		console.log(pc.green('🎉 Done! Translation file generated successfully.'));
-	}
-}
-
-module.exports = LangTranslateCommand;

package/src/cli/commands/MakeMigrationCommand.js

@@ -1,82 +0,0 @@
-/**
- * 📐 Migration File Generator
- *
- * @file src/cli/commands/MakeMigrationCommand.js
- * @copyright © 2025 kenndeclouv
- * @assistant chaa & graa
- * @version 0.11.0-beta
- *
- * @description
- * Scaffolds a new database migration file with a precise YYYYMMDD_HHMMSS timestamp prefix.
- * Places the file in the specified addon's migration directory.
- *
- * ✨ Core Features:
- * -  Timestamped Ordering: Ensures migrations run in creation order.
- * -  Addon Aware: Targets the correct module folder automatically.
- * -  Template Injection: Provides standard up/down methods via `queryInterface`.
- */
-
-const Command = require('../Command');
-const fs = require('node:fs');
-const path = require('node:path');
-const pc = require('picocolors');
-
-class MakeMigrationCommand extends Command {
-	signature = 'make:migration <name> <addon>';
-	description = 'Create a new migration file for an addon';
-
-	async handle(_options, name, addon) {
-		const rootDir = process.cwd();
-		const targetDir = path.join(
-			rootDir,
-			'addons',
-			addon,
-			'database',
-			'migrations',
-		);
-
-		if (!fs.existsSync(path.join(rootDir, 'addons', addon))) {
-			console.error(pc.red(`❌ Addon '${addon}' not found!`));
-			process.exit(1);
-		}
-
-		if (!fs.existsSync(targetDir)) {
-			fs.mkdirSync(targetDir, { recursive: true });
-		}
-
-		const now = new Date();
-		const timestamp = now
-			.toISOString()
-			.replace(/T/, '_')
-			.replace(/[-:]/g, '')
-			.split('.')[0];
-		const fileName = `${timestamp}_${name}.js`;
-		const filePath = path.join(targetDir, fileName);
-
-		const template = `/**
- * @namespace: addons/${addon}/database/migrations/${fileName}
- * @type: Database Migration
- * @copyright © 2025 kenndeclouv
- * @assistant chaa & graa
- * @version 0.9.12-beta
- */
-module.exports = {
-    async up(queryInterface, DataTypes) {
-        // await queryInterface.createTable('table_name', { 
-		// 		id: DataTypes.INTEGER 
-		// });
-    },
-
-    async down(queryInterface, DataTypes) {
-        // await queryInterface.dropTable('table_name');
-    }
-};`;
-
-		fs.writeFileSync(filePath, template);
-
-		console.log(pc.green('✅ Created migration:'));
-		console.log(pc.dim(`   addons/${addon}/database/migrations/${fileName}`));
-	}
-}
-
-module.exports = MakeMigrationCommand;

package/src/cli/commands/MakeModelCommand.js

@@ -1,81 +0,0 @@
-/**
- * 📦 Model Scaffolding Tool
- *
- * @file src/cli/commands/MakeModelCommand.js
- * @copyright © 2025 kenndeclouv
- * @assistant chaa & graa
- * @version 0.11.0-beta
- *
- * @description
- * Generates new Sequelize model files extending `KythiaModel`.
- * Automatically creates the directory structure and populates standard boilerplate.
- *
- * ✨ Core Features:
- * -  Smart Scaffolding: Creates models in `addons/{addon}/database/models`.
- * -  Duplicate Protection: Prevents overwriting existing models.
- * -  Standard Boilerplate: Includes `guarded` and `structure` properties by default.
- */
-
-const Command = require('../Command');
-const fs = require('node:fs');
-const path = require('node:path');
-const pc = require('picocolors');
-
-class MakeModelCommand extends Command {
-	signature = 'make:model <name> <addon>';
-	description = 'Create a new KythiaModel file';
-
-	async handle(_options, name, addon) {
-		//
-		const rootDir = process.cwd();
-		const targetDir = path.join(rootDir, 'addons', addon, 'database', 'models');
-
-		if (!fs.existsSync(path.join(rootDir, 'addons', addon))) {
-			console.error(pc.red(`❌ Addon '${addon}' not found!`));
-			process.exit(1);
-		}
-
-		if (!fs.existsSync(targetDir)) {
-			fs.mkdirSync(targetDir, { recursive: true });
-		}
-
-		const fileName = `${name}.js`;
-		const filePath = path.join(targetDir, fileName);
-
-		if (fs.existsSync(filePath)) {
-			console.error(
-				pc.red(`❌ Model '${fileName}' already exists in ${addon}!`),
-			);
-			process.exit(1);
-		}
-
-		const template = `/**
- * @namespace: addons/${addon}/database/models/${fileName}
- * @type: Database Model
- * @copyright © ${new Date().getFullYear()} kenndeclouv
- * @assistant chaa & graa
- * @version 0.9.12-beta
- */
-
-const { KythiaModel } = require("kythia-core");
-
-class ${name} extends KythiaModel {
-    static guarded = ["id"];
-
-    static get structure() {
-        return {
-            options: { timestamps: true },
-        };
-    }
-}
-
-module.exports = ${name};`;
-
-		fs.writeFileSync(filePath, template);
-
-		console.log(pc.green('✅ Created Model:'));
-		console.log(pc.dim(`   addons/${addon}/database/models/${fileName}`));
-	}
-}
-
-module.exports = MakeModelCommand;