fix: add detailed debug logging for AdminForth and CodeInjector initialization and plugin activation

Author: SerVitasik

adminforth/index.ts

@@ -124,31 +124,58 @@ class AdminForth implements IAdminForth {
   }
 
   constructor(config: AdminForthInputConfig) {
+    process.env.HEAVY_DEBUG && console.log('🔧 AdminForth constructor started');
+    
     if (global.adminforth) {
       throw new Error('AdminForth instance already created in this process. '+
         'If you want to use multiple instances, consider using different process for each instance');
     }
+    
+    process.env.HEAVY_DEBUG && console.log('🔧 Creating CodeInjector...');
     this.codeInjector = new CodeInjector(this);
+    process.env.HEAVY_DEBUG && console.log('🔧 CodeInjector created');
+    
+    process.env.HEAVY_DEBUG && console.log('🔧 Creating ConfigValidator...');
     this.configValidator = new ConfigValidator(this, config);
+    process.env.HEAVY_DEBUG && console.log('🔧 ConfigValidator created');
+    
+    process.env.HEAVY_DEBUG && console.log('🔧 Creating AdminForthRestAPI...');
     this.restApi = new AdminForthRestAPI(this);
+    process.env.HEAVY_DEBUG && console.log('🔧 AdminForthRestAPI created');
+    
+    process.env.HEAVY_DEBUG && console.log('🔧 Creating SocketBroker...');
     this.websocket = new SocketBroker(this);
+    process.env.HEAVY_DEBUG && console.log('🔧 SocketBroker created');
+    
     this.activatedPlugins = [];
 
+    process.env.HEAVY_DEBUG && console.log('🔧 Validating config...');
     this.configValidator.validateConfig();
+    process.env.HEAVY_DEBUG && console.log('🔧 Config validated');
+    
+    process.env.HEAVY_DEBUG && console.log('🔧 Activating plugins...');
     this.activatePlugins();
+    process.env.HEAVY_DEBUG && console.log('🔧 Plugins activated');
 
+    process.env.HEAVY_DEBUG && console.log('🔧 Creating ExpressServer...');
     this.express = new ExpressServer(this);
+    process.env.HEAVY_DEBUG && console.log('🔧 ExpressServer created');
+    
     // this.fastify = new FastifyServer(this);
+    process.env.HEAVY_DEBUG && console.log('🔧 Creating AdminForthAuth...');
     this.auth = new AdminForthAuth(this);
+    process.env.HEAVY_DEBUG && console.log('🔧 AdminForthAuth created');
+    
     this.connectors = {};
     this.statuses = {
       dbDiscover: 'running',
     };
 
-   
-
     console.log(`${this.formatAdminForth()} v${ADMINFORTH_VERSION} initializing...`);
+    process.env.HEAVY_DEBUG && console.log('🔧 About to set global.adminforth...');
     global.adminforth = this;
+    process.env.HEAVY_DEBUG && console.log('🔧 global.adminforth set successfully');
+    process.env.HEAVY_DEBUG && console.log('🔧 AdminForth constructor completed');
   }
 
   formatAdminForth() {
@@ -174,14 +201,21 @@ class AdminForth implements IAdminForth {
     process.env.HEAVY_DEBUG && console.log('🔌🔌🔌 Activating plugins');
     const allPluginInstances = [];
     for (let resource of this.config.resources) {
+      process.env.HEAVY_DEBUG && console.log(`🔌 Checking plugins for resource: ${resource.resourceId}`);
       for (let pluginInstance of resource.plugins || []) {
+        process.env.HEAVY_DEBUG && console.log(`🔌 Found plugin: ${pluginInstance.constructor.name} for resource ${resource.resourceId}`);
         allPluginInstances.push({pi: pluginInstance, resource});
       }
     }
+    process.env.HEAVY_DEBUG && console.log(`🔌 Total plugins to activate: ${allPluginInstances.length}`);
     allPluginInstances.sort(({pi: a}, {pi: b}) => a.activationOrder - b.activationOrder);
+    
     allPluginInstances.forEach(
-      ({pi: pluginInstance, resource}) => {
+      ({pi: pluginInstance, resource}, index) => {
+        process.env.HEAVY_DEBUG && console.log(`🔌 Activating plugin ${index + 1}/${allPluginInstances.length}: ${pluginInstance.constructor.name} for resource ${resource.resourceId}`);
         pluginInstance.modifyResourceConfig(this, resource);
+        process.env.HEAVY_DEBUG && console.log(`🔌 Plugin ${pluginInstance.constructor.name} modifyResourceConfig completed`);
+        
         const plugin = this.activatedPlugins.find((p) => p.pluginInstanceId === pluginInstance.pluginInstanceId);
         if (plugin) {
           process.env.HEAVY_DEBUG && console.log(`Current plugin pluginInstance.pluginInstanceId ${pluginInstance.pluginInstanceId}`);
@@ -190,8 +224,10 @@ class AdminForth implements IAdminForth {
             To support multiple plugin instance pre one resource, plugin should return unique string values for each installation from instanceUniqueRepresentation`);
         }
         this.activatedPlugins.push(pluginInstance);
+        process.env.HEAVY_DEBUG && console.log(`🔌 Plugin ${pluginInstance.constructor.name} activated successfully`);
       }
     );
+    process.env.HEAVY_DEBUG && console.log('🔌 All plugins activation completed');
   }
 
   getPluginsByClassName<T>(className: string): T[] {

adminforth/modules/codeInjector.ts

@@ -83,11 +83,14 @@ class CodeInjector implements ICodeInjector {
   devServerPort: number = null;
 
   spaTmpPath(): string {
-    const brandSlug = this.adminforth.config.customization.brandNameSlug
+    const brandSlug = this.adminforth.config.customization?.brandNameSlug;
+    process.env.HEAVY_DEBUG && console.log(`🔧 spaTmpPath() - brandSlug: "${brandSlug}", TMP_DIR: "${TMP_DIR}"`);
     if (!brandSlug) {
       throw new Error('brandSlug is empty, but it should be populated at least by config Validator ');
     }
-    return path.join(TMP_DIR, 'adminforth', brandSlug, 'spa_tmp');
+    const fullPath = path.join(TMP_DIR, 'adminforth', brandSlug, 'spa_tmp');
+    process.env.HEAVY_DEBUG && console.log(`🔧 spaTmpPath() result: "${fullPath}"`);
+    return fullPath;
   }
 
   cleanup() {
@@ -234,12 +237,18 @@ class CodeInjector implements ICodeInjector {
 
   async prepareSources() {
     // collects all files and folders into SPA_TMP_DIR
+    process.env.HEAVY_DEBUG && console.log(`🔧 prepareSources() started`);
 
     // check spa tmp folder exists and create if not
     try {
+      process.env.HEAVY_DEBUG && console.log(`🔧 Checking if spaTmpPath exists: ${this.spaTmpPath()}`);
       await fs.promises.access(this.spaTmpPath(), fs.constants.F_OK);
+      process.env.HEAVY_DEBUG && console.log(`🔧 spaTmpPath already exists`);
     } catch (e) {
-      await fs.promises.mkdir(this.spaTmpPath(), { recursive: true });
+        process.env.HEAVY_DEBUG && console.log(`🔧 spaTmpPath doesn't exist, creating directory: ${this.spaTmpPath()}`);
+        await fs.promises.mkdir(this.spaTmpPath(), { recursive: true });
+        process.env.HEAVY_DEBUG && console.log(`🔧 Successfully created spaTmpPath directory`);
+
     }
 
     const icons = [];
@@ -809,7 +818,12 @@ class CodeInjector implements ICodeInjector {
     console.log(`${this.adminforth.formatAdminForth()} Bundling ${hotReload ? 'and listening for changes (🔥 Hotreload)' : ' (no hot reload)'}`);
     this.adminforth.runningHotReload = hotReload;
 
+    process.env.HEAVY_DEBUG && console.log(`🔧 Starting prepareSources() - Platform: ${process.platform}, TMP_DIR: ${TMP_DIR}`);
+    process.env.HEAVY_DEBUG && console.log(`🔧 spaTmpPath: ${this.spaTmpPath()}`);
+    
     await this.prepareSources();
+    process.env.HEAVY_DEBUG && console.log(`🔧 prepareSources() completed successfully`);
+
 
     if (hotReload) {
       await Promise.all([