kythia-core 0.9.4-beta.1 → 0.9.4-beta.3

package/changelog.md

@@ -2,6 +2,20 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [0.9.4-beta.3](https://github.com/kenndeclouv/kythia-core/compare/v0.9.4-beta.2...v0.9.4-beta.3) (2025-11-10)
+
+
+### 🔧 Changed
+
+* Enhance KythiaORM with dialect-specific UPSERT queries for improved database compatibility. Adjusted InteractionManager button handler logic for better flexibility in handling interactions. ([2bfafc4](https://github.com/kenndeclouv/kythia-core/commit/2bfafc47e83b06f5f72a57da162d0c6b244bfe6d))
+
+### [0.9.4-beta.2](https://github.com/kenndeclouv/kythia-core/compare/v0.9.4-beta.1...v0.9.4-beta.2) (2025-11-10)
+
+
+### ✨ Added
+
+* Enhance configuration validation in Kythia by adding checks for required bot and database settings, defaulting to SQLite if no driver is specified, and improving error logging for missing configurations. ([72148fa](https://github.com/kenndeclouv/kythia-core/commit/72148fa6b29a97da026746eb44fa4b8696744cb5))
+
 ### [0.9.4-beta.1](https://github.com/kenndeclouv/kythia-core/compare/v0.9.4-beta.0...v0.9.4-beta.1) (2025-11-09)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "kythia-core",
-    "version": "0.9.4-beta.1",
+    "version": "0.9.4-beta.3",
     "description": "Core library for the Kythia main Discord bot: extensible, modular, and scalable foundation for commands, components, and event management.",
     "main": "index.js",
     "scripts": {

package/src/Kythia.js

@@ -4,7 +4,7 @@
  * @file src/Kythia.js
  * @copyright © 2025 kenndeclouv
  * @assistant chaa & graa
- * @version 0.9.4-beta
+ * @version 0.9.4-beta.3
  *
  * @description
  * This file contains the main Bot class - acting as an orchestrator (CEO) that
@@ -97,30 +97,62 @@ class Kythia {
      * Throws an error if any required config is missing.
      */
     _checkRequiredConfig() {
-        const requiredConfig = [
+        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', 'host'],
-            ['db', 'port'],
             ['db', 'name'],
-            ['db', 'user'],
         ];
 
-        const missingConfigs = [];
+        if (driver !== 'sqlite') {
+            requiredDbConfig.push(['db', 'host'], ['db', 'port'], ['db', 'user'], ['db', 'pass']);
+        }
 
-        for (const pathArr of requiredConfig) {
+        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 === '') {
-                missingConfigs.push(pathArr.join('.'));
+                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) {

package/src/database/KythiaModel.js

@@ -4,7 +4,7 @@
  * @file src/database/KythiaModel.js
  * @copyright © 2025 kenndeclouv
  * @assistant chaa & graa
- * @version 0.9.4-beta
+ * @version 0.9.4-beta.3
  *
  * @description
  * Caching layer for Sequelize Models, now sharding-aware. When config.db.redis.shard === true,

package/src/database/KythiaORM.js

@@ -4,7 +4,7 @@
  * @file src/database/KythiaORM.js
  * @copyright © 2025 kenndeclouv
  * @assistant chaa & graa
- * @version 0.9.4-beta
+ * @version 0.9.4-beta.3
  *
  * @description
  * A utility for intelligent, hash-based syncing of Sequelize models.
@@ -448,7 +448,7 @@ async function KythiaORM({ kythiaInstance, sequelize, KythiaModel, logger, confi
                 }
             }
 
-            const modelNamesToSync = modelsToSync.map(m => m.model.name);
+            const modelNamesToSync = modelsToSync.map((m) => m.model.name);
 
             logger.info(`🔄 Syncing models via sequelize.sync(): ${modelNamesToSync.join(', ')}...`);
             await sequelize.sync({
@@ -459,16 +459,50 @@ async function KythiaORM({ kythiaInstance, sequelize, KythiaModel, logger, confi
 
             logger.info('💾 Updating version hashes in model_versions table...');
             for (const { model, newHash } of modelsToSync) {
-                await sequelize.query(
-                    `INSERT INTO ${versionTableName} (model_name, version_hash, updated_at) 
-                        VALUES (?, ?, CURRENT_TIMESTAMP) 
-                        ON DUPLICATE KEY UPDATE 
-                        version_hash = VALUES(version_hash), updated_at = CURRENT_TIMESTAMP`,
-                    {
-                        replacements: [model.name, newHash],
-                        type: sequelize.QueryTypes.INSERT,
-                    }
-                );
+                const dialect = sequelize.getDialect();
+                let upsertQuery;
+
+                switch (dialect) {
+                    case 'mysql':
+                    case 'mariadb':
+                        upsertQuery = `INSERT INTO ${versionTableName} (model_name, version_hash, updated_at) 
+                                     VALUES (?, ?, CURRENT_TIMESTAMP) 
+                                     ON DUPLICATE KEY UPDATE 
+                                     version_hash = VALUES(version_hash), updated_at = CURRENT_TIMESTAMP`;
+                        break;
+
+                    case 'sqlite':
+                    case 'postgres':
+                        upsertQuery = `INSERT INTO ${versionTableName} (model_name, version_hash, updated_at) 
+                                     VALUES (?, ?, CURRENT_TIMESTAMP) 
+                                     ON CONFLICT(model_name) 
+                                     DO UPDATE SET version_hash = excluded.version_hash, updated_at = CURRENT_TIMESTAMP`;
+                        break;
+
+                    case 'mssql':
+                        upsertQuery = `MERGE INTO ${versionTableName} AS T
+                                     USING (VALUES (?, ?, CURRENT_TIMESTAMP)) AS S (model_name, version_hash, updated_at)
+                                     ON (T.model_name = S.model_name)
+                                     WHEN MATCHED THEN
+                                         UPDATE SET T.version_hash = S.version_hash, T.updated_at = S.updated_at
+                                     WHEN NOT MATCHED THEN
+                                         INSERT (model_name, version_hash, updated_at) 
+                                         VALUES (S.model_name, S.version_hash, S.updated_at);`;
+                        break;
+
+                    default:
+                        logger.warn(`Dialect "${dialect}" does not have a custom UPSERT, attempting fallback to ON CONFLICT...`);
+                        upsertQuery = `INSERT INTO ${versionTableName} (model_name, version_hash, updated_at) 
+                                     VALUES (?, ?, CURRENT_TIMESTAMP) 
+                                     ON CONFLICT(model_name) 
+                                     DO UPDATE SET version_hash = excluded.version_hash, updated_at = CURRENT_TIMESTAMP`;
+                }
+
+                await sequelize.query(upsertQuery, {
+                    replacements: [model.name, newHash],
+
+                    type: sequelize.QueryTypes.INSERT,
+                });
             }
 
             logger.info('✨ Database sync completed successfully!');

package/src/database/KythiaSequelize.js

@@ -4,10 +4,10 @@
  * @file src/database/KythiaSequelize.js
  * @copyright © 2025 kenndeclouv
  * @assistant chaa & graa
- * @version 0.9.4-beta
+ * @version 0.9.4-beta.3
  *
  * @description
- * Main Sequelize connection factory for the application
+ * Main Sequelize connection factory for the application.
  */
 const { Sequelize } = require('sequelize');
 
@@ -21,14 +21,35 @@ const { Sequelize } = require('sequelize');
  */
 function createSequelizeInstance(config, logger) {
     const dbConfig = config.db || {};
+    if (!config.db) config.db = dbConfig;
 
-    const dialect = dbConfig.driver || process.env.DB_DRIVER;
-    const dbName = dbConfig.name || process.env.DB_NAME;
+    let driver = dbConfig.driver || process.env.DB_DRIVER;
+    let name = dbConfig.name || process.env.DB_NAME;
+
+    if (!driver || driver === '') {
+        driver = 'sqlite';
+        if (logger) logger.info('💡 DB driver not specified. Defaulting to: sqlite');
+    } else {
+        driver = driver.toLowerCase();
+    }
+
+    if (driver === 'sqlite') {
+        if (!name || name === '') {
+            name = 'kythiadata.sqlite';
+            if (logger) logger.info('💡 DB name for sqlite not specified. Defaulting to: kythiadata.sqlite');
+        }
+    }
+
+    dbConfig.driver = driver;
+    dbConfig.name = name;
+
+    const dialect = dbConfig.driver;
+    const dbName = dbConfig.name;
     const dbUser = dbConfig.user || process.env.DB_USER;
     const dbPassword = dbConfig.password || process.env.DB_PASSWORD;
     const dbHost = dbConfig.host || process.env.DB_HOST;
     const dbPort = dbConfig.port || process.env.DB_PORT;
-    const dbStorage = dbConfig.storagePath || process.env.DB_STORAGE_PATH;
+
     const dbSocket = dbConfig.socketPath || process.env.DB_SOCKET_PATH;
     const dbSsl = dbConfig.ssl || process.env.DB_SSL;
     const dbDialectOptions = dbConfig.dialectOptions || process.env.DB_DIALECT_OPTIONS;
@@ -45,12 +66,16 @@ function createSequelizeInstance(config, logger) {
             charset: 'utf8mb4',
             collate: 'utf8mb4_unicode_ci',
         },
-        timezone: dbConfig.timezone || '+00:00',
     };
 
+    if (dialect !== 'sqlite') {
+        seqConfig.timezone = dbConfig.timezone || '+00:00';
+    }
+
     switch (dialect) {
         case 'sqlite':
-            seqConfig.storage = dbStorage;
+            seqConfig.storage = dbConfig.name;
+            delete seqConfig.database;
             break;
 
         case 'mysql':

package/src/managers/AddonManager.js

@@ -4,7 +4,7 @@
  * @file src/managers/AddonManager.js
  * @copyright © 2025 kenndeclouv
  * @assistant chaa & graa
- * @version 0.9.4-beta
+ * @version 0.9.4-beta.3
  *
  * @description
  * Handles all addon loading, command registration, and component management.

package/src/managers/EventManager.js

@@ -4,7 +4,7 @@
  * @file src/managers/EventManager.js
  * @copyright © 2025 kenndeclouv
  * @assistant chaa & graa
- * @version 0.9.4-beta
+ * @version 0.9.4-beta.3
  *
  * @description
  * Handles all Discord event listeners except InteractionCreate.

package/src/managers/InteractionManager.js

@@ -4,7 +4,7 @@
  * @file src/managers/InteractionManager.js
  * @copyright © 2025 kenndeclouv
  * @assistant chaa & graa
- * @version 0.9.4-beta
+ * @version 0.9.4-beta.3
  *
  * @description
  * Handles all Discord interaction events including slash commands, buttons, modals,
@@ -280,8 +280,19 @@ class InteractionManager {
      * @private
      */
     async _handleButton(interaction) {
-        const handler = this.buttonHandlers.get(interaction.customId.split('_')[0]);
-        if (handler) await handler(interaction, this.container);
+        const customIdPrefix = interaction.customId.includes('|') 
+            ? interaction.customId.split('|')[0] 
+            : interaction.customId.split(':')[0];
+
+        const handler = this.buttonHandlers.get(customIdPrefix); 
+
+        if (handler) {
+            if (handler.length === 2) {
+                await handler(interaction, this.container);
+            } else {
+                await handler(interaction);
+            }
+        }
     }
 
     /**

package/src/managers/ShutdownManager.js

@@ -4,7 +4,7 @@
  * @file src/managers/ShutdownManager.js
  * @copyright © 2025 kenndeclouv
  * @assistant chaa & graa
- * @version 0.9.4-beta
+ * @version 0.9.4-beta.3
  *
  * @description
  * Handles graceful shutdown procedures including interval tracking,