fiberx-backend-toolkit 0.0.26 → 0.0.28

package/dist/database/connectors/base_connector.d.ts

@@ -7,6 +7,6 @@ declare abstract class BaseConnector<TConnection> {
     readonly env_manager: EnvManagerUtil;
     readonly logger: LoggerUtil;
     protected constructor(connector_name: string);
-    abstract connect(): TConnection;
+    abstract connect(): Promise<TConnection>;
 }
 export default BaseConnector;

package/dist/database/connectors/sequelize_connector.d.ts

@@ -8,8 +8,8 @@ declare class SequelizeConnector extends BaseConnector<Sequelize> {
     static getInstance(): SequelizeConnector;
     private formatSQLQueryLog;
     private ensureDatabaseExists;
-    connect(options?: SequelizeConnectionOptions): Sequelize;
-    connectNamed(name: string, options?: SequelizeConnectionOptions): Sequelize;
+    connect(options?: SequelizeConnectionOptions): Promise<Sequelize>;
+    connectNamed(name: string, options?: SequelizeConnectionOptions): Promise<Sequelize>;
     getConnection(name?: string): Sequelize | undefined;
     hasConnection(name?: string): boolean;
     closeConnection(name?: string): Promise<void>;

package/dist/database/connectors/sequelize_connector.js

@@ -55,6 +55,7 @@ class SequelizeConnector extends base_connector_1.default {
             if (dialect === "mssql") {
                 admin_db = "master";
             }
+            this.logger.info(`🔌 Connecting to admin database: ${admin_db}`);
             const admin = new sequelize_1.Sequelize(admin_db, username, password, {
                 host,
                 port,
@@ -62,6 +63,7 @@ class SequelizeConnector extends base_connector_1.default {
                 logging: false,
             });
             await admin.authenticate();
+            this.logger.success(`🔌 Connected to admin database: ${admin_db}`);
             this.logger.info(`🔍 Checking database existence: ${database}`);
             switch (dialect) {
                 case "postgres":
@@ -95,47 +97,53 @@ class SequelizeConnector extends base_connector_1.default {
     // ----------------------------------
     // Single default connection
     // ----------------------------------
-    connect(options = {}) {
-        return this.connectNamed(options.name ?? "default", options);
+    async connect(options = {}) {
+        return await this.connectNamed(options.name ?? "default", options);
     }
     // ----------------------------------
     // Multiple named connections
     // ----------------------------------
-    connectNamed(name, options = {}) {
-        if (SequelizeConnector.connections.has(name)) {
-            return SequelizeConnector.connections.get(name);
+    async connectNamed(name, options = {}) {
+        try {
+            if (SequelizeConnector.connections.has(name)) {
+                return SequelizeConnector.connections.get(name);
+            }
+            const dialect = options.dialect ?? this.env_manager.getEnvVar("DB_DIALECT", "postgres");
+            const logging_enabled = options.logging ?? this.env_manager.getEnvVar("DB_LOGGING", false);
+            const logging = logging_enabled ? this.formatSQLQueryLog : false;
+            const database = options.database ?? this.env_manager.getEnvVar("DB_NAME");
+            const username = options.username ?? this.env_manager.getEnvVar("DB_USER");
+            const password = options.password ?? this.env_manager.getEnvVar("DB_PASSWORD");
+            const host = options.host ?? this.env_manager.getEnvVar("DB_HOST");
+            const port = options.port ?? this.env_manager.getEnvVar("DB_PORT", 5432);
+            // 🔴 IMPORTANT: Attempt to ensure DB exists BEFORE connecting
+            await this.ensureDatabaseExists({
+                dialect,
+                database,
+                username,
+                password,
+                host,
+                port,
+                logging,
+            }).catch(() => { });
+            const sequelize = new sequelize_1.Sequelize({
+                database,
+                username,
+                password,
+                host,
+                port,
+                dialect,
+                logging,
+                benchmark: logging_enabled,
+            });
+            SequelizeConnector.connections.set(name, sequelize);
+            this.logger.success(`✅ Sequelize connected [${name}]`);
+            return sequelize;
+        }
+        catch (error) {
+            this.logger.error(`❌ Failed to connect Sequelize [${name}]`, { error });
+            throw error;
         }
-        const dialect = options.dialect ?? this.env_manager.getEnvVar("DB_DIALECT", "postgres");
-        const logging_enabled = options.logging ?? this.env_manager.getEnvVar("DB_LOGGING", false);
-        const logging = logging_enabled ? this.formatSQLQueryLog : false;
-        const database = options.database ?? this.env_manager.getEnvVar("DB_NAME");
-        const username = options.username ?? this.env_manager.getEnvVar("DB_USER");
-        const password = options.password ?? this.env_manager.getEnvVar("DB_PASSWORD");
-        const host = options.host ?? this.env_manager.getEnvVar("DB_HOST");
-        const port = options.port ?? this.env_manager.getEnvVar("DB_PORT", 5432);
-        // 🔴 IMPORTANT: Attempt to ensure DB exists BEFORE connecting
-        this.ensureDatabaseExists({
-            dialect,
-            database,
-            username,
-            password,
-            host,
-            port,
-            logging,
-        }).catch(() => { });
-        const sequelize = new sequelize_1.Sequelize({
-            database,
-            username,
-            password,
-            host,
-            port,
-            dialect,
-            logging,
-            benchmark: logging_enabled,
-        });
-        SequelizeConnector.connections.set(name, sequelize);
-        this.logger.success(`✅ Sequelize connected [${name}]`);
-        return sequelize;
     }
     // ----------------------------------
     // Utilities

package/dist/database/scripts/migration_runner_script.d.ts

@@ -4,7 +4,7 @@ declare class MigrationRunnerScript {
     private readonly migrations_dir;
     private readonly db_connection;
     private readonly logger;
-    private readonly sequelize_instance;
+    private sequelize_instance;
     constructor();
     private getMigrationFiles;
     private ensureMetaTable;

package/dist/database/scripts/migration_runner_script.js

@@ -14,10 +14,9 @@ class MigrationRunnerScript {
     migrations_dir = constants_1.MIGRATIONS_DIR;
     db_connection = main_1.SequelizeConnector?.getInstance?.();
     logger = new main_2.LoggerUtil(this.module_name);
-    sequelize_instance;
+    sequelize_instance = null;
     constructor() {
         main_2.InputValidatorUtil.dirExists(this.migrations_dir, true);
-        this.sequelize_instance = this.db_connection.connect();
     }
     // Fetch all migration files
     getMigrationFiles(schema_name) {
@@ -28,8 +27,8 @@ class MigrationRunnerScript {
         return files;
     }
     // Ensure SequelizeMeta table exists
-    async ensureMetaTable() {
-        const queryInterface = this.sequelize_instance.getQueryInterface();
+    async ensureMetaTable(sequelize_instance) {
+        const queryInterface = sequelize_instance.getQueryInterface();
         const table_names = await queryInterface.showAllTables();
         if (!table_names.includes(constants_1.SEQUELIZE_META_TABLE_NAME)) {
             this.logger.info("⏳ Creating SequelizeMeta table...");
@@ -44,12 +43,12 @@ class MigrationRunnerScript {
         }
     }
     // Fetch already applied migrations
-    async getAppliedMigrations() {
-        const [results] = await this.sequelize_instance.query(`SELECT name FROM \"${constants_1.SEQUELIZE_META_TABLE_NAME}\";`);
+    async getAppliedMigrations(sequelize_instance) {
+        const [results] = await sequelize_instance.query(`SELECT name FROM \"${constants_1.SEQUELIZE_META_TABLE_NAME}\";`);
         return Array.isArray(results) ? results.map((r) => r.name) : [];
     }
     // Apply a single migration
-    async applyMigration(file_path, operation) {
+    async applyMigration(sequelize_instance, file_path, operation) {
         const MigrationClass = require(file_path)?.default;
         if (!MigrationClass) {
             const log_msg = `Migration file has no default export: ${file_path}`;
@@ -57,22 +56,24 @@ class MigrationRunnerScript {
             throw new Error(log_msg);
         }
         const migration_instance = new MigrationClass();
-        const queryInterface = this.sequelize_instance.getQueryInterface();
+        const queryInterface = sequelize_instance.getQueryInterface();
         if (operation === "up") {
-            await migration_instance.up.bind(migration_instance)(queryInterface, this.sequelize_instance);
-            await this.sequelize_instance.getQueryInterface().bulkInsert(constants_1.SEQUELIZE_META_TABLE_NAME, [{ name: path_1.default.basename(file_path) }]);
+            await migration_instance.up.bind(migration_instance)(queryInterface, sequelize_instance);
+            await sequelize_instance.getQueryInterface().bulkInsert(constants_1.SEQUELIZE_META_TABLE_NAME, [{ name: path_1.default.basename(file_path) }]);
         }
         else {
-            await migration_instance.down.bind(migration_instance)(queryInterface, this.sequelize_instance);
-            await this.sequelize_instance.getQueryInterface().bulkDelete(constants_1.SEQUELIZE_META_TABLE_NAME, { name: path_1.default.basename(file_path) });
+            await migration_instance.down.bind(migration_instance)(queryInterface, sequelize_instance);
+            await sequelize_instance.getQueryInterface().bulkDelete(constants_1.SEQUELIZE_META_TABLE_NAME, { name: path_1.default.basename(file_path) });
         }
     }
     // Main runner
     async run(operation, schema_name, migration_file) {
         this.logger.info(`🏃‍♂️ Starting Migration process Operation: ${operation.toUpperCase()}, Schema: ${schema_name}, File: ${migration_file || "all"}`);
+        this.logger.info("🔌 Connecting to database...");
+        this.sequelize_instance = await this.db_connection.connect();
         await this.sequelize_instance?.authenticate();
         this.logger.success("✅ Database connected.");
-        await this.ensureMetaTable();
+        await this.ensureMetaTable(this.sequelize_instance);
         let files = [];
         if (migration_file) {
             const full_path = path_1.default.join(this.migrations_dir, migration_file);
@@ -99,7 +100,7 @@ class MigrationRunnerScript {
                 ? a_priority - b_priority
                 : b_priority - a_priority;
         });
-        const applied_migrations = await this.getAppliedMigrations();
+        const applied_migrations = await this.getAppliedMigrations(this.sequelize_instance);
         for (const file of files) {
             const file_name = path_1.default.basename(file);
             if (operation === "up" && applied_migrations.includes(file_name)) {
@@ -111,7 +112,7 @@ class MigrationRunnerScript {
                 continue;
             }
             this.logger.info(`${operation === "up" ? "Applying" : "Reverting"} migration: ${file_name}`);
-            await this.applyMigration(file, operation);
+            await this.applyMigration(this.sequelize_instance, file, operation);
             this.logger.success(`${operation === "up" ? "Applied" : "Reverted"} migration: ${file_name}`);
         }
         this.logger.success(`🏁 Migration process completed.`);

package/dist/database/scripts/seeder_runner_script.d.ts

@@ -4,7 +4,7 @@ declare class SeederRunnerScript {
     private readonly seeders_dir;
     private readonly db_connection;
     private readonly logger;
-    private readonly sequelize_instance;
+    private sequelize_instance;
     constructor();
     private getSeederFiles;
     private ensureMetaTable;

package/dist/database/scripts/seeder_runner_script.js

@@ -14,10 +14,9 @@ class SeederRunnerScript {
     seeders_dir = constants_1.SEEDERS_DIR;
     db_connection = main_1.SequelizeConnector?.getInstance?.();
     logger = new main_2.LoggerUtil(this.name);
-    sequelize_instance;
+    sequelize_instance = null;
     constructor() {
         main_2.InputValidatorUtil.dirExists(this.seeders_dir, true);
-        this.sequelize_instance = this.db_connection.connect();
     }
     // Get all seeder files
     getSeederFiles(seeder_name) {
@@ -28,8 +27,8 @@ class SeederRunnerScript {
         return files;
     }
     // Ensure SequelizeSeederMeta table exists
-    async ensureMetaTable() {
-        const queryInterface = this.sequelize_instance.getQueryInterface();
+    async ensureMetaTable(sequelize_instance) {
+        const queryInterface = sequelize_instance.getQueryInterface();
         const tables = await queryInterface.showAllTables();
         if (!tables.includes(constants_1.SEQUELIZE_SEEDER_META_TABLE_NAME)) {
             this.logger.info("⏳ Creating Sequelize seeder meta table table...");
@@ -40,24 +39,24 @@ class SeederRunnerScript {
         }
     }
     // Get already applied seeders
-    async getAppliedSeeders() {
-        const [results] = await this.sequelize_instance.query(`SELECT name FROM "${constants_1.SEQUELIZE_SEEDER_META_TABLE_NAME}";`);
+    async getAppliedSeeders(sequelize_instance) {
+        const [results] = await sequelize_instance.query(`SELECT name FROM "${constants_1.SEQUELIZE_SEEDER_META_TABLE_NAME}";`);
         return Array.isArray(results) ? results.map((r) => r.name) : [];
     }
     // Apply a single seeder
-    async applySeeder(file_path, operation) {
+    async applySeeder(sequelize_instance, file_path, operation) {
         const SeederClass = require(file_path)?.default;
         if (!SeederClass) {
             throw new Error(`Seeder file has no default export: ${file_path}`);
         }
         const seeder_instance = new SeederClass();
-        const queryInterface = this.sequelize_instance.getQueryInterface();
+        const queryInterface = sequelize_instance.getQueryInterface();
         if (operation === "up") {
-            await seeder_instance.up(queryInterface, this.sequelize_instance);
+            await seeder_instance.up(queryInterface, sequelize_instance);
             await queryInterface.bulkInsert(constants_1.SEQUELIZE_SEEDER_META_TABLE_NAME, [{ name: path_1.default.basename(file_path) }]);
         }
         else {
-            await seeder_instance.down(queryInterface, this.sequelize_instance);
+            await seeder_instance.down(queryInterface, sequelize_instance);
             await queryInterface.bulkDelete(constants_1.SEQUELIZE_SEEDER_META_TABLE_NAME, { name: path_1.default.basename(file_path) });
         }
     }
@@ -65,9 +64,11 @@ class SeederRunnerScript {
     async run(operation, seeder_name, seeder_file) {
         try {
             this.logger.info(`🏃‍♂️ Starting seeder process Operation: ${operation.toUpperCase()}, Seeder: ${seeder_name || "all"}, File: ${seeder_file || "none"}`);
+            this.logger.info("🔌 Connecting to database...");
+            this.sequelize_instance = await this.db_connection.connect();
             await this.sequelize_instance?.authenticate();
             this.logger.success("✅ Database connected.");
-            await this.ensureMetaTable();
+            await this.ensureMetaTable(this.sequelize_instance);
             let files = [];
             if (seeder_file) {
                 const full_path = path_1.default.join(this.seeders_dir, seeder_file);
@@ -82,7 +83,7 @@ class SeederRunnerScript {
             }
             // Sort by filename: ascending for UP, descending for DOWN
             files.sort((a, b) => (operation === "up" ? a.localeCompare(b) : b.localeCompare(a)));
-            const applied_seeders = await this.getAppliedSeeders();
+            const applied_seeders = await this.getAppliedSeeders(this.sequelize_instance);
             for (const file of files) {
                 const file_name = path_1.default.basename(file);
                 if (operation === "up" && applied_seeders.includes(file_name)) {
@@ -94,7 +95,7 @@ class SeederRunnerScript {
                     continue;
                 }
                 this.logger.info(`${operation === "up" ? "Applying" : "Reverting"} seeder: ${file_name}`);
-                await this.applySeeder(file, operation);
+                await this.applySeeder(this.sequelize_instance, file, operation);
                 this.logger.success(`${operation === "up" ? "Applied" : "Reverted"} seeder: ${file_name}`);
             }
             this.logger.success("🏁 Seeder process completed.");

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "fiberx-backend-toolkit",
-    "version": "0.0.26",
+    "version": "0.0.28",
     "description": "A TypeScript backend toolkit providing shared domain logic, infrastructure helpers, and utilities for FiberX server-side applications and services.",
     "type": "commonjs",
     "main": "./dist/index.js",