bun_plugins 1.1.2 → 1.2.0

package/README.md

@@ -163,7 +163,7 @@ Plugins can share APIs with each other safely:
 // Plugin A: Exposes an API
 export class ProviderPlugin implements IPlugin {
   name = "db-provider";
-  getSharedApi() {
+  getApi() {
     return {
       query: (q: string) => `Result for ${q}`,
     };
@@ -174,7 +174,7 @@ export class ProviderPlugin implements IPlugin {
 export class ConsumerPlugin implements IPlugin {
   name = "app-logic";
   async onLoad(context: PluginContext) {
-    const db = context.getPlugin("db-provider");
+    const db = await context.getPlugin("db-provider");
     const result = db.query("SELECT *");
   }
 }

package/dist/Plugin.d.ts

@@ -0,0 +1,28 @@
+import type { IPlugin, PluginContext, PluginBuilder, PluginPermission } from "./types";
+import { z } from "zod";
+/**
+ * Abstract base class for Plugins to extend.
+ * Provides default implementations for optional methods.
+ */
+export declare abstract class Plugin implements IPlugin {
+    abstract name: string;
+    abstract version: string;
+    description?: string;
+    author?: string;
+    dependencies?: Record<string, string>;
+    permissions?: PluginPermission[];
+    allowedDomains?: string[];
+    configSchema?: z.ZodSchema;
+    defaultConfig?: Record<string, any>;
+    onLoad(context: PluginContext): Promise<void> | void;
+    onUnload(): Promise<void> | void;
+    onStarted(): Promise<void> | void;
+    onReload(context: PluginContext): Promise<void> | void;
+    setup(build: PluginBuilder): void | Promise<void>;
+}
+/**
+ * Helper function to define a plugin object with type inference.
+ * Useful for functional-style plugin definitions.
+ */
+export declare function definePlugin(plugin: IPlugin): IPlugin;
+//# sourceMappingURL=Plugin.d.ts.map

package/dist/Plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Plugin.d.ts","sourceRoot":"","sources":["../src/Plugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AACvF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,8BAAsB,MAAO,YAAW,OAAO;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEpC,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIpD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIhC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIjC,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAItD,KAAK,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CAGpD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAErD"}

package/dist/Plugin.js

@@ -0,0 +1,36 @@
+/**
+ * Abstract base class for Plugins to extend.
+ * Provides default implementations for optional methods.
+ */
+export class Plugin {
+    description;
+    author;
+    dependencies;
+    permissions;
+    allowedDomains;
+    configSchema;
+    defaultConfig;
+    onLoad(context) {
+        // Default no-op
+    }
+    onUnload() {
+        // Default no-op
+    }
+    onStarted() {
+        // Default no-op
+    }
+    onReload(context) {
+        // Default no-op defined but not enforced by interface strictly if optional
+    }
+    setup(build) {
+        // Default no-op
+    }
+}
+/**
+ * Helper function to define a plugin object with type inference.
+ * Useful for functional-style plugin definitions.
+ */
+export function definePlugin(plugin) {
+    return plugin;
+}
+//# sourceMappingURL=Plugin.js.map

package/dist/Plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Plugin.js","sourceRoot":"","sources":["../src/Plugin.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,OAAgB,MAAM;IAIxB,WAAW,CAAU;IACrB,MAAM,CAAU;IAChB,YAAY,CAA0B;IACtC,WAAW,CAAsB;IACjC,cAAc,CAAY;IAC1B,YAAY,CAAe;IAC3B,aAAa,CAAuB;IAEpC,MAAM,CAAC,OAAsB;QACzB,gBAAgB;IACpB,CAAC;IAED,QAAQ;QACJ,gBAAgB;IACpB,CAAC;IAED,SAAS;QACL,gBAAgB;IACpB,CAAC;IAED,QAAQ,CAAC,OAAsB;QAC3B,2EAA2E;IAC/E,CAAC;IAED,KAAK,CAAC,KAAoB;QACtB,gBAAgB;IACpB,CAAC;CACJ;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAAe;IACxC,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/PluginManager.d.ts

@@ -1,5 +1,6 @@
 import { EventEmitter } from "node:events";
 import { type IPlugin, type AppEvents, type BunWorkerOptions as WorkerOptions, type OnResolveArgs, type OnLoadArgs, type IPluginManager } from "./types";
+import { PluginTypeByName, KnownPluginNames } from "./pluginRegistry";
 import { HooksManager } from "./managers/HooksManager";
 export declare class PluginManager extends EventEmitter implements IPluginManager {
     private plugins;
@@ -23,6 +24,7 @@ export declare class PluginManager extends EventEmitter implements IPluginManage
     registerIsolated(pluginPath: string, pluginName: string): Promise<void>;
     unregister(pluginName: string): Promise<void>;
     getPlugin(name: string): IPlugin | undefined;
+    getPlugin<TName extends string>(name: TName): TName extends KnownPluginNames ? PluginTypeByName<TName> : IPlugin | undefined;
     getPluginConfig(name: string): Record<string, any>;
     listPlugins(): string[];
     emit<K extends keyof AppEvents>(eventName: K, payload: AppEvents[K]): boolean;
@@ -46,6 +48,9 @@ export declare class PluginManager extends EventEmitter implements IPluginManage
         contents?: string;
         loader?: string;
     } | null>;
+    use(plugin: IPlugin): Promise<void>;
+    plugin(plugin: IPlugin): Promise<void>;
+    remove(pluginName: string): Promise<void>;
     toBunPlugin(): Bun.BunPlugin;
     private hotReloadTimer;
     enableHotReload(pluginDir: string): void;
@@ -59,6 +64,7 @@ export declare class PluginManager extends EventEmitter implements IPluginManage
             pluginCount: number;
         };
         hooks: {
+            onStart: number;
             onResolve: number;
             onLoad: number;
         };

package/dist/PluginManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PluginManager.d.ts","sourceRoot":"","sources":["../src/PluginManager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"PluginManager.d.ts","sourceRoot":"","sources":["../src/PluginManager.ts"],"names":[],"mappings":"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"}

package/dist/PluginManager.js

@@ -12,6 +12,7 @@ import { HooksManager } from "./managers/HooksManager";
 import { createPluginContext } from "./managers/ContextFactory";
 import { errorParser } from "./utils/errorParser";
 import { checkNetworkPermission, checkPermission as checkGeneralPermission } from "./utils/security";
+import { logger } from "./logger";
 export class PluginManager extends EventEmitter {
     plugins = new Map();
     availablePlugins = new Map();
@@ -60,7 +61,7 @@ export class PluginManager extends EventEmitter {
                 throw new Error(`Plugin ${plugin.name} requires host version ${plugin.engines.host}, but found ${this.hostVersion}`);
             }
         }
-        console.log(`Loading plugin: ${plugin.name} v${plugin.version}`);
+        logger.getLogger("PluginManager").info(`Loading plugin: ${plugin.name} v${plugin.version}`);
         // 1. Prepare Storage
         const storage = new JsonPluginStorage(this.storageRoot, plugin.name);
         // 2. Load & Validate Configuration
@@ -71,7 +72,7 @@ export class PluginManager extends EventEmitter {
             }
             catch (e) {
                 const error = errorParser(e, `Error in plugin ${plugin.name}`);
-                console.warn(`[SafeMode] Using default config, validation failed. Error: ${error.message}`);
+                logger.getLogger("PluginManager").warn(`[SafeMode] Using default config, validation failed. Error: ${error.message}`);
             }
         }
         // 3. Initialize Resources
@@ -86,10 +87,10 @@ export class PluginManager extends EventEmitter {
         // 5. Setup Hooks with Performance Monitoring (Delegated to HooksManager via Builder)
         if (plugin.setup) {
             try {
-                await plugin.setup(this.hooksManager.getBuilder(plugin.name));
+                await plugin.setup(this.hooksManager.getBuilder(plugin.name, config));
             }
             catch (e) {
-                console.error(`Error during setup for ${plugin.name}:`, e);
+                logger.getLogger("PluginManager").error(`Error during setup for ${plugin.name}:`, e);
                 throw errorParser(e, `Error during setup for ${plugin.name}`);
             }
         }
@@ -100,19 +101,21 @@ export class PluginManager extends EventEmitter {
             await Promise.race([plugin.onLoad(context), timeoutPromise]);
             const duration = performance.now() - start;
             this.plugins.set(plugin.name, plugin);
-            console.log(`Plugin ${plugin.name} loaded successfully in ${duration.toFixed(2)}ms.`);
+            logger.getLogger("PluginManager").info(`Plugin ${plugin.name} loaded successfully in ${duration.toFixed(2)}ms.`);
             // Trigger onStarted after registration if provided
             if (plugin.onStarted) {
                 try {
                     await plugin.onStarted();
                 }
                 catch (e) {
-                    console.error(`Error in onStarted for ${plugin.name}:`, e);
+                    logger.getLogger("PluginManager").error(`Error in onStarted for ${plugin.name}:`, e);
                 }
             }
+            // 7. Trigger onStart hooks registered via setup()
+            await this.hooksManager.runOnStart();
         }
         catch (error) {
-            console.error(`Failed to load plugin ${plugin.name}:`, error);
+            logger.getLogger("PluginManager").error(`Failed to load plugin ${plugin.name}:`, error);
             // Cleanup resources directly since plugin is not in this.plugins yet
             this.resources.cleanup(plugin.name, this);
             this.hooksManager.cleanup(plugin.name);
@@ -122,7 +125,7 @@ export class PluginManager extends EventEmitter {
     async registerIsolated(pluginPath, pluginName) {
         return new Promise((resolve, reject) => {
             const workerScript = this.workerRunnerPath;
-            console.log("Worker Path:", workerScript);
+            logger.getLogger("PluginManager").info("Worker Path:", workerScript);
             const timeoutId = setTimeout(() => {
                 worker.terminate();
                 reject(new Error(`Isolated plugin ${pluginName} timed out during loading (${this.pluginLoadTimeout}ms)`));
@@ -203,16 +206,22 @@ export class PluginManager extends EventEmitter {
                             else if (type === HookType.ON_LOAD) {
                                 this.hooksManager.registerOnLoad(filterRegExp, proxyCallback, pluginName, options?.order);
                             }
+                            else if (type === HookType.ON_START) {
+                                this.hooksManager.registerOnStart(() => proxyCallback({}), pluginName);
+                            }
                             result = true;
                         }
                         else if (method === RPCMethod.ManagerGetPlugin) {
                             const targetName = args[0];
                             const p = this.getPlugin(targetName);
-                            result = p?.getSharedApi ? p.getSharedApi() : undefined;
+                            result = p && typeof p === 'object' && 'getSharedApi' in p && typeof p.getSharedApi === 'function'
+                                ? p.getSharedApi()
+                                : undefined;
                         }
                         else if (method === RPCMethod.Log) {
                             const level = args[0];
-                            console[level](`[${pluginName}]`, ...args.slice(1));
+                            const [msg, ...restArgs] = args.slice(1);
+                            logger.getLogger(pluginName)[level](msg, ...restArgs);
                             result = true;
                         }
                         else if (method === RPCMethod.PermissionCheck) {
@@ -270,7 +279,7 @@ export class PluginManager extends EventEmitter {
                 else if (msg.type === WorkerMessageType.MANIFEST) {
                     const { metadata } = msg;
                     pluginMetadata = metadata;
-                    console.log(`Metadata received for isolated plugin: ${metadata.name}`);
+                    logger.getLogger("PluginManager").info(`Metadata received for isolated plugin: ${metadata.name}`);
                 }
                 else if (msg.type === WorkerMessageType.LOAD_SUCCESS) {
                     clearTimeout(timeoutId); // Success, clear global timeout
@@ -300,7 +309,7 @@ export class PluginManager extends EventEmitter {
                         },
                     };
                     this.plugins.set(metadata.name, proxyPlugin);
-                    console.log(`Isolated Plugin ${metadata.name} loaded in worker.`);
+                    logger.getLogger("PluginManager").info(`Isolated Plugin ${metadata.name} loaded in worker.`);
                     resolve();
                 }
                 else if (msg.type === WorkerMessageType.LOAD_ERROR) {
@@ -317,7 +326,7 @@ export class PluginManager extends EventEmitter {
             worker.addEventListener("message", (event) => rpcHandler(event.data));
             worker.addEventListener("error", (err) => {
                 clearTimeout(timeoutId);
-                console.error(`[Isolated:${pluginName}] Worker Error:`, err);
+                logger.getLogger("PluginManager").error(`[Isolated:${pluginName}] Worker Error:`, err);
                 // Reject all pending hooks on crash
                 for (const pending of Array.from(pendingHooks.values())) {
                     pending.reject(new Error("Worker terminated unexpectedly"));
@@ -333,24 +342,31 @@ export class PluginManager extends EventEmitter {
             return;
         for (const [name, p] of Array.from(this.plugins.entries())) {
             if (p.dependencies && p.dependencies[pluginName]) {
-                console.warn(`Warning: Plugin ${name} depends on ${pluginName} which is being unloaded.`);
+                logger.getLogger("PluginManager").warn(`Warning: Plugin ${name} depends on ${pluginName} which is being unloaded.`);
             }
         }
         try {
             await plugin.onUnload();
         }
         catch (error) {
-            console.error(`Error unloading plugin ${pluginName}:`, error);
+            logger.getLogger("PluginManager").error(`Error unloading plugin ${pluginName}:`, error);
         }
         finally {
             this.plugins.delete(pluginName);
             this.resources.cleanup(pluginName, this);
             this.hooksManager.cleanup(pluginName);
-            console.log(`Plugin ${pluginName} unloaded.`);
+            logger.getLogger("PluginManager").info(`Plugin ${pluginName} unloaded.`);
         }
     }
     getPlugin(name) {
-        return this.plugins.get(name);
+        const plugin = this.plugins.get(name);
+        if (!plugin)
+            return undefined;
+        // Si el plugin tiene getSharedApi, retornar la API compartida
+        if (plugin.getSharedApi) {
+            return plugin.getSharedApi();
+        }
+        return plugin;
     }
     getPluginConfig(name) {
         return this.configs.get(name) || {};
@@ -382,7 +398,7 @@ export class PluginManager extends EventEmitter {
                 }
             }
             catch (e) {
-                console.warn("Failed to load global plugin config", e);
+                logger.getLogger("PluginManager").warn("Failed to load global plugin config", e);
             }
             const entries = await readdir(directoryPath, { withFileTypes: true });
             this.availablePlugins.clear();
@@ -408,7 +424,9 @@ export class PluginManager extends EventEmitter {
                 }
                 if (fullPath) {
                     try {
-                        const module = await import(fullPath);
+                        // Use cache-busting for hot reload
+                        const query = `?update=${Date.now()}`;
+                        const module = await import(fullPath + query);
                         for (const key in module) {
                             const ExportedItem = module[key];
                             const validation = validatePlugin(ExportedItem);
@@ -417,12 +435,12 @@ export class PluginManager extends EventEmitter {
                             }
                             else {
                                 const errorMsg = validation.error;
-                                console.warn(`Skipping invalid plugin item in ${entry.name}: ${errorMsg}`);
+                                logger.getLogger("PluginManager").warn(`Skipping invalid plugin item in ${entry.name}: ${errorMsg}`);
                             }
                         }
                     }
                     catch (err) {
-                        console.error(`Error importing ${fullPath}:`, err);
+                        logger.getLogger("PluginManager").error(`Error importing ${fullPath}:`, err);
                     }
                 }
             }
@@ -432,7 +450,7 @@ export class PluginManager extends EventEmitter {
                     pluginsToLoad.push(plugin);
                 }
                 else {
-                    console.log(`Plugin ${plugin.name} is disabled.`);
+                    logger.getLogger("PluginManager").info(`Plugin ${plugin.name} is disabled.`);
                 }
             }
             try {
@@ -443,7 +461,7 @@ export class PluginManager extends EventEmitter {
                     if (plugin.dependencies) {
                         for (const dep of Object.keys(plugin.dependencies)) {
                             if (!this.plugins.has(dep)) {
-                                console.warn(`Skipping ${plugin.name}: Dependency ${dep} failed to load or is missing.`);
+                                logger.getLogger("PluginManager").warn(`Skipping ${plugin.name}: Dependency ${dep} failed to load or is missing.`);
                                 dependenciesOk = false;
                                 break;
                             }
@@ -452,13 +470,18 @@ export class PluginManager extends EventEmitter {
                     if (!dependenciesOk)
                         continue;
                     try {
-                        if (!this.plugins.has(plugin.name)) {
+                        if (this.plugins.has(plugin.name)) {
+                            logger.getLogger("PluginManager").info(`Updating plugin: ${plugin.name}`);
+                            await this.reloadPlugin(plugin.name);
+                            loadedPlugins.push(plugin);
+                        }
+                        else {
                             await this.register(plugin);
                             loadedPlugins.push(plugin);
                         }
                     }
                     catch (e) {
-                        console.error(`Failed to load ${plugin.name}:`, e);
+                        logger.getLogger("PluginManager").error(`Failed to load/update ${plugin.name}:`, e);
                     }
                 }
                 for (const plugin of loadedPlugins) {
@@ -467,23 +490,23 @@ export class PluginManager extends EventEmitter {
                             await plugin.onStarted();
                         }
                         catch (e) {
-                            console.error(`Error in onStarted for ${plugin.name}:`, e);
+                            logger.getLogger("PluginManager").error(`Error in onStarted for ${plugin.name}:`, e);
                         }
                     }
                 }
             }
             catch (e) {
-                console.error("Failed to resolve plugin dependencies or load plugins:", e);
+                logger.getLogger("PluginManager").error("Failed to resolve plugin dependencies or load plugins:", e);
             }
         }
         catch (error) {
-            console.error(`Failed to load plugins from ${directoryPath}`, error);
+            logger.getLogger("PluginManager").error(`Failed to load plugins from ${directoryPath}`, error);
         }
     }
     async disablePlugin(name) {
         await this.unregister(name);
         await this.updatePluginState(name, true);
-        console.log(`Plugin ${name} disabled.`);
+        logger.getLogger("PluginManager").info(`Plugin ${name} disabled.`);
     }
     async enablePlugin(name) {
         await this.updatePluginState(name, false);
@@ -493,7 +516,7 @@ export class PluginManager extends EventEmitter {
                 if (plugin.dependencies) {
                     for (const dep of Object.keys(plugin.dependencies)) {
                         if (!this.plugins.has(dep)) {
-                            console.warn(`Cannot enable ${name}: Dependency ${dep} is not loaded.`);
+                            logger.getLogger("PluginManager").warn(`Cannot enable ${name}: Dependency ${dep} is not loaded.`);
                             return;
                         }
                     }
@@ -501,19 +524,33 @@ export class PluginManager extends EventEmitter {
                 await this.register(plugin);
             }
             else {
-                console.warn(`Plugin ${name} enabled but not found in available plugins.`);
+                logger.getLogger("PluginManager").warn(`Plugin ${name} enabled but not found in available plugins.`);
             }
         }
     }
     async reloadPlugin(name) {
-        const plugin = this.plugins.get(name);
-        if (plugin) {
-            console.log(`Reloading plugin ${name}...`);
+        const oldPlugin = this.plugins.get(name);
+        if (oldPlugin) {
+            logger.getLogger("PluginManager").info(`Reloading plugin ${name}...`);
             await this.unregister(name);
         }
         const definition = this.availablePlugins.get(name);
         if (definition) {
             await this.register(definition);
+            const newPlugin = this.plugins.get(name);
+            // If the new version has onReload, call it
+            if (newPlugin && newPlugin.onReload) {
+                // We need a context for onReload as well
+                const storage = new JsonPluginStorage(this.storageRoot, name);
+                const context = createPluginContext(this, newPlugin, this.resources, storage);
+                try {
+                    await newPlugin.onReload(context);
+                }
+                catch (e) {
+                    logger.getLogger("PluginManager").error(`Error in onReload for ${name}:`, e);
+                }
+            }
+            this.emit("plugin:updated", { name: definition.name, version: definition.version });
         }
         else {
             throw new Error(`Plugin ${name} not found in available plugins.`);
@@ -539,7 +576,7 @@ export class PluginManager extends EventEmitter {
             await Bun.write(globalConfigPath, JSON.stringify(config, null, 2));
         }
         catch (e) {
-            console.error("Failed to update plugin state", e);
+            logger.getLogger("PluginManager").error("Failed to update plugin state", e);
         }
     }
     async runOnResolve(args) {
@@ -548,19 +585,23 @@ export class PluginManager extends EventEmitter {
     async runOnLoad(args) {
         return this.hooksManager.runOnLoad(args);
     }
+    // Bun-like Aliases
+    async use(plugin) { return this.register(plugin); }
+    async plugin(plugin) { return this.register(plugin); }
+    async remove(pluginName) { return this.unregister(pluginName); }
     toBunPlugin() {
         return this.hooksManager.toBunPlugin();
     }
     hotReloadTimer = null;
     enableHotReload(pluginDir) {
-        console.log(`[HotReload] Watching ${pluginDir} for changes...`);
+        logger.getLogger("PluginManager").info(`[HotReload] Watching ${pluginDir} for changes...`);
         watch(pluginDir, { recursive: true }, async (event, filename) => {
             if (!filename || (!filename.endsWith(".ts") && !filename.endsWith(".js")))
                 return;
             if (this.hotReloadTimer)
                 clearTimeout(this.hotReloadTimer);
             this.hotReloadTimer = setTimeout(async () => {
-                console.log(`[HotReload] Change detected in ${filename}. Re-scanning plugins...`);
+                logger.getLogger("PluginManager").info(`[HotReload] Change detected in ${filename}. Re-scanning plugins...`);
                 await this.loadPluginsFromDirectory(pluginDir);
             }, 300);
         });
@@ -571,6 +612,7 @@ export class PluginManager extends EventEmitter {
             activePlugins: Array.from(this.plugins.keys()),
             resources: this.resources.getUsageSummary(),
             hooks: {
+                onStart: this.hooksManager.getHookCount(HookType.ON_START),
                 onResolve: this.hooksManager.getHookCount(HookType.ON_RESOLVE),
                 onLoad: this.hooksManager.getHookCount(HookType.ON_LOAD)
             }
@@ -598,16 +640,16 @@ export class PluginManager extends EventEmitter {
             // 1. Check if we are in production
             const isProduction = process.env.NODE_ENV === "production";
             if (isProduction) {
-                console.warn(`[PluginManager] Warning: Plugin at ${pluginPath} is missing node_modules. Auto-install is disabled in production.`);
+                logger.getLogger("PluginManager").warn(`[PluginManager] Warning: Plugin at ${pluginPath} is missing node_modules. Auto-install is disabled in production.`);
                 return;
             }
             // 2. Check if 'bun' CLI is even available in the system
             const bunPath = Bun.which("bun");
             if (!bunPath) {
-                console.warn(`[PluginManager] Warning: node_modules missing in ${pluginPath}, but 'bun' CLI was not found. Cannot auto-install.`);
+                logger.getLogger("PluginManager").warn(`[PluginManager] Warning: node_modules missing in ${pluginPath}, but 'bun' CLI was not found. Cannot auto-install.`);
                 return;
             }
-            console.log(`[PluginManager] Development mode detected. node_modules missing in ${pluginPath}. Installing deps...`);
+            logger.getLogger("PluginManager").info(`[PluginManager] Development mode detected. node_modules missing in ${pluginPath}. Installing deps...`);
             try {
                 const proc = Bun.spawn([bunPath, "install"], {
                     cwd: pluginPath,
@@ -616,11 +658,11 @@ export class PluginManager extends EventEmitter {
                 });
                 const exitCode = await proc.exited;
                 if (exitCode !== 0) {
-                    console.error(`[PluginManager] Failed to install dependencies for ${pluginPath}. Exit code: ${exitCode}`);
+                    logger.getLogger("PluginManager").error(`[PluginManager] Failed to install dependencies for ${pluginPath}. Exit code: ${exitCode}`);
                 }
             }
             catch (e) {
-                console.error(`[PluginManager] Error running bun install for ${pluginPath}:`, e);
+                logger.getLogger("PluginManager").error(`[PluginManager] Error running bun install for ${pluginPath}:`, e);
             }
         }
     }