bun_plugins 1.2.6 → 1.2.7

package/dist/src/storage/JsonPluginStorage.js

@@ -0,0 +1,240 @@
+import { join, dirname } from "node:path";
+import { mkdir } from "node:fs/promises";
+import { watch, existsSync } from "node:fs";
+import { logger } from "../logger";
+/**
+ * JsonPluginStorage con soporte singleton para evitar múltiples instancias del mismo plugin.
+ * Usa un Map estático para almacenar las instancias por nombre de plugin y basePath.
+ */
+export class JsonPluginStorage {
+    static instances = new Map();
+    filePath;
+    data = null;
+    lastModified = 0;
+    watcher = null;
+    watchDebounceTimer = null;
+    onDataChangeCallbacks = [];
+    /**
+     * Obtiene una instancia singleton de JsonPluginStorage.
+     * Si la instancia ya existe para el plugin dado, la reutiliza.
+     * @param basePath Ruta base del storage
+     * @param pluginName Nombre del plugin
+     * @returns Instancia de JsonPluginStorage
+     */
+    static getInstance(basePath, pluginName) {
+        const key = `${basePath}:${pluginName}`;
+        if (!JsonPluginStorage.instances.has(key)) {
+            const instance = new JsonPluginStorage(basePath, pluginName);
+            JsonPluginStorage.instances.set(key, instance);
+            if (logger) {
+                logger.getLogger("JsonPluginStorage").debug(`Created new storage instance for ${pluginName}`);
+            }
+        }
+        return JsonPluginStorage.instances.get(key);
+    }
+    /**
+     * Obtiene todas las instancias registradas.
+     */
+    static getAllInstances() {
+        return new Map(JsonPluginStorage.instances);
+    }
+    /**
+     * Obtiene una instancia específica por nombre de plugin.
+     * @param pluginName Nombre del plugin
+     * @returns Instancia o undefined si no existe
+     */
+    static getInstanceByName(pluginName) {
+        for (const [key, instance] of JsonPluginStorage.instances) {
+            if (key.endsWith(`:${pluginName}`)) {
+                return instance;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Elimina una instancia específica.
+     * @param basePath Ruta base del storage
+     * @param pluginName Nombre del plugin
+     */
+    static removeInstance(basePath, pluginName) {
+        const key = `${basePath}:${pluginName}`;
+        const instance = JsonPluginStorage.instances.get(key);
+        if (instance) {
+            instance.stopWatching(); // Limpiar watcher al eliminar
+            JsonPluginStorage.instances.delete(key);
+            if (logger) {
+                logger.getLogger("JsonPluginStorage").debug(`Removed storage instance for ${pluginName}`);
+            }
+        }
+    }
+    /**
+     * Limpia todas las instancias (útil para testing).
+     */
+    static clearAllInstances() {
+        for (const [key, instance] of JsonPluginStorage.instances) {
+            instance.stopWatching();
+        }
+        JsonPluginStorage.instances.clear();
+        if (!logger)
+            return;
+        logger.getLogger("JsonPluginStorage").debug(`Cleared all storage instances`);
+    }
+    constructor(basePath, pluginName) {
+        this.filePath = join(basePath, "plugins", pluginName, "storage.json");
+    }
+    async ensureLoaded(force = false) {
+        try {
+            const file = Bun.file(this.filePath);
+            const exists = await file.exists();
+            if (!exists) {
+                this.data = this.data || {};
+                this.lastModified = 0;
+                return;
+            }
+            const stats = await import("node:fs/promises").then(fs => fs.stat(this.filePath));
+            const mtime = stats.mtimeMs;
+            if (force || this.data === null || mtime > this.lastModified) {
+                this.data = await file.json();
+                this.lastModified = mtime;
+            }
+        }
+        catch (e) {
+            if (this.data === null) {
+                logger.getLogger("JsonPluginStorage").error(`Failed to load storage for ${this.filePath}`, e);
+                this.data = {};
+            }
+        }
+    }
+    async save() {
+        if (this.data === null)
+            return;
+        try {
+            await mkdir(dirname(this.filePath), { recursive: true });
+            const content = JSON.stringify(this.data, null, 2);
+            await Bun.write(this.filePath, content);
+            // Update local mtime to avoid immediate reload
+            const stats = await import("node:fs/promises").then(fs => fs.stat(this.filePath));
+            this.lastModified = stats.mtimeMs;
+        }
+        catch (e) {
+            logger.getLogger("JsonPluginStorage").error(`Failed to save storage for ${this.filePath}`, e);
+        }
+    }
+    async get(key, defaultValue) {
+        await this.ensureLoaded();
+        return this.data?.[key] ?? defaultValue;
+    }
+    async set(key, value) {
+        await this.ensureLoaded();
+        if (this.data) {
+            this.data[key] = value;
+            await this.save();
+        }
+    }
+    async delete(key) {
+        await this.ensureLoaded();
+        if (this.data) {
+            delete this.data[key];
+            await this.save();
+        }
+    }
+    async clear() {
+        this.data = {};
+        await this.save();
+    }
+    async reload() {
+        await this.ensureLoaded(true);
+    }
+    /**
+     * init watch for storage file changes
+     * When the file changes externally, the data will be reloaded automatically.
+     * @param debounceMs Time to wait in ms before reloading (default: 100ms)
+     */
+    startWatching(debounceMs = 100) {
+        if (this.watcher) {
+            logger.getLogger("JsonPluginStorage").warn(`Already watching ${this.filePath}`);
+            return;
+        }
+        const dir = dirname(this.filePath);
+        if (!existsSync(dir)) {
+            logger.getLogger("JsonPluginStorage").warn(`Cannot watch non-existent directory: ${dir}`);
+            return;
+        }
+        try {
+            this.watcher = watch(dir, { persistent: false }, async (eventType, filename) => {
+                if (filename && filename.endsWith('.json')) {
+                    // Debounce para evitar múltiples recargas rápidas
+                    if (this.watchDebounceTimer) {
+                        clearTimeout(this.watchDebounceTimer);
+                    }
+                    this.watchDebounceTimer = setTimeout(async () => {
+                        try {
+                            const oldData = this.data ? { ...this.data } : null;
+                            await this.ensureLoaded(true);
+                            // Notificar a los suscriptores si los datos cambiaron
+                            if (oldData && this.data && JSON.stringify(oldData) !== JSON.stringify(this.data)) {
+                                this.notifyDataChange(this.data);
+                                logger.getLogger("JsonPluginStorage").info(`Storage auto-reloaded for ${this.filePath}`);
+                            }
+                        }
+                        catch (e) {
+                            logger.getLogger("JsonPluginStorage").error(`Error auto-reloading storage:`, e);
+                        }
+                    }, debounceMs);
+                }
+            });
+            logger.getLogger("JsonPluginStorage").info(`Started watching ${this.filePath}`);
+        }
+        catch (e) {
+            logger.getLogger("JsonPluginStorage").error(`Failed to start watching ${this.filePath}:`, e);
+        }
+    }
+    /**
+     * stop watching for storage file changes
+     */
+    stopWatching() {
+        if (this.watchDebounceTimer) {
+            clearTimeout(this.watchDebounceTimer);
+            this.watchDebounceTimer = null;
+        }
+        if (this.watcher) {
+            this.watcher.close();
+            this.watcher = null;
+            logger.getLogger("JsonPluginStorage").info(`Stopped watching ${this.filePath}`);
+        }
+    }
+    /**
+     * register a callback that will be called when the storage data changes.
+     * @param callback function to call when the data changes
+     * @returns function to cancel the subscription
+     */
+    onDataChange(callback) {
+        this.onDataChangeCallbacks.push(callback);
+        return () => {
+            const index = this.onDataChangeCallbacks.indexOf(callback);
+            if (index > -1) {
+                this.onDataChangeCallbacks.splice(index, 1);
+            }
+        };
+    }
+    /**
+     * notify all subscribers about data changes.
+     */
+    notifyDataChange(data) {
+        for (const callback of this.onDataChangeCallbacks) {
+            try {
+                callback(data);
+            }
+            catch (e) {
+                logger.getLogger("JsonPluginStorage").error(`Error in data change callback:`, e);
+            }
+        }
+    }
+    /**
+     * check if the storage is being watched.
+     */
+    isWatching() {
+        return this.watcher !== null;
+    }
+}
+//# sourceMappingURL=JsonPluginStorage.js.map

package/dist/src/storage/JsonPluginStorage.js.map

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

package/dist/src/types/plugin-registry-base.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Base types for plugin registry that can be extended by users using declaration merging.
+ * This solves issue where published libraries can't know about user's plugins.
+ */
+import type { IPlugin } from "../types";
+/**
+ * Base API interface that all plugins extend.
+ * Users can extend this interface with their own plugin APIs.
+ */
+export interface BasePluginApi {
+    name: string;
+    version: string;
+    actions?: string[];
+    type?: string;
+    loaded?: string;
+}
+/**
+ * Plugin factory map - users can extend this with their own plugins.
+ *
+ * This interface can be extended by users using declaration merging.
+ *
+ * Example of how users extend this:
+ * ```typescript
+ * declare module "bun_plugins" {
+ *   export interface PluginFactory {
+ *     "my-custom-plugin": {
+ *       name: "my-custom-plugin";
+ *       version: "1.0.0";
+ *       class: MyCustomPlugin;
+ *       api: MyCustomPluginApi;
+ *     };
+ *   }
+ * }
+ *
+ * // Now you can use context.getPlugin("my-custom-plugin") with full autocomplete
+ * const api = await context.getPlugin("my-custom-plugin");
+ * api.myCustomMethod();
+ * ```
+ */
+export interface PluginFactory {
+}
+/**
+ * Union type of all plugin names.
+ * This is dynamically computed from PluginFactory keys.
+ * For development, we allow any string to be used as plugin name.
+ */
+export type PluginNames = keyof PluginFactory | string;
+/**
+ * Get the API type for a specific plugin.
+ * Falls back to BasePluginApi if the plugin is not found.
+ */
+export type PluginApiType<T extends string> = T extends keyof PluginFactory ? PluginFactory[T]["api"] : BasePluginApi;
+/**
+ * Get the class type for a specific plugin.
+ * Falls back to IPlugin if the plugin is not found.
+ */
+export type PluginClassType<T extends string> = T extends keyof PluginFactory ? PluginFactory[T]["class"] : IPlugin;
+/**
+ * Get the API type for a specific plugin.
+ */
+export type GetPluginApi<T extends string> = PluginApiType<T>;
+/**
+ * Get the class type for a specific plugin.
+ */
+export type GetPluginClass<T extends string> = PluginClassType<T>;
+/**
+ * Helper to check if a plugin name is valid.
+ * Returns true if the plugin is in PluginFactory.
+ */
+export type IsValidPlugin<T extends string> = T extends PluginNames ? true : false;
+/**
+ * Type-safe plugin retrieval from the factory.
+ * Returns the plugin info if found, undefined otherwise.
+ */
+export type PluginFromFactory<T extends PluginNames> = T extends keyof PluginFactory ? PluginFactory[T] : undefined;
+/**
+ * Plugin instance type - combines class and API types.
+ */
+export type PluginInstanceType<T extends string> = T extends keyof PluginFactory ? PluginFactory[T]["class"] : IPlugin;
+//# sourceMappingURL=plugin-registry-base.d.ts.map

package/dist/src/types/plugin-registry-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-registry-base.d.ts","sourceRoot":"","sources":["../../../src/types/plugin-registry-base.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,aAAa;CAE7B;AAED;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,aAAa,GAAG,MAAM,CAAC;AAEvD;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,MAAM,IACxC,CAAC,SAAS,MAAM,aAAa,GACzB,aAAa,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GACvB,aAAa,CAAC;AAEpB;;;GAGG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,MAAM,IAC1C,CAAC,SAAS,MAAM,aAAa,GACzB,aAAa,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GACzB,OAAO,CAAC;AAEd;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,MAAM,IAAI,aAAa,CAAC,CAAC,CAAC,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,MAAM,IAAI,eAAe,CAAC,CAAC,CAAC,CAAC;AAElE;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,WAAW,GAAG,IAAI,GAAG,KAAK,CAAC;AAEnF;;;GAGG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,WAAW,IACjD,CAAC,SAAS,MAAM,aAAa,GACzB,aAAa,CAAC,CAAC,CAAC,GAChB,SAAS,CAAC;AAEhB;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,MAAM,IAC7C,CAAC,SAAS,MAAM,aAAa,GACzB,aAAa,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GACzB,OAAO,CAAC"}

package/dist/src/types/plugin-registry-base.js

@@ -0,0 +1,6 @@
+/**
+ * Base types for plugin registry that can be extended by users using declaration merging.
+ * This solves issue where published libraries can't know about user's plugins.
+ */
+export {};
+//# sourceMappingURL=plugin-registry-base.js.map

package/dist/src/types/plugin-registry-base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-registry-base.js","sourceRoot":"","sources":["../../../src/types/plugin-registry-base.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/{types.d.ts → src/types.d.ts}

@@ -1,4 +1,8 @@
 import { z } from "zod";
+export { z };
+export * from "./types/plugin-registry-base";
+export type PluginNames = string;
+export type PluginApiType<T extends string> = any;
 export declare enum WorkerMessageType {
     RPC_CALL = "RPC_CALL",
     HOOK_CALL = "HOOK_CALL",
@@ -25,13 +29,17 @@ export declare enum RPCMethod {
     EventsOn = "events:on",
     HooksRegister = "hooks:register",
     ManagerGetPlugin = "manager:getPlugin",
+    ManagerRegisterApi = "manager:registerApi",
     Log = "log",
     NetworkFetch = "network:fetch",
-    PermissionCheck = "perm:check"
+    PermissionCheck = "perm:check",
+    ConfigGet = "config:get",
+    StorageReload = "storage:reload"
 }
 export declare enum HookType {
     ON_RESOLVE = "onResolve",
-    ON_LOAD = "onLoad"
+    ON_LOAD = "onLoad",
+    ON_START = "onStart"
 }
 export declare enum HookOrder {
     PRE = "pre",
@@ -41,7 +49,7 @@ export interface PluginResource {
     workers: Worker[];
     timers: {
         id: number | Timer;
-        type: 'timeout' | 'interval';
+        type: "timeout" | "interval";
     }[];
     eventListeners: {
         event: string;
@@ -55,13 +63,13 @@ export interface HookRegistry<T> {
     order?: HookOrder;
 }
 export interface AppEvents {
-    "log": {
+    log: {
         level: "info" | "error" | "warn";
         message: string;
     };
-    "cmd:input": {
-        command: string;
-        args: string[];
+    "plugin:updated": {
+        name: string;
+        version: string;
     };
     [key: string]: any;
 }
@@ -71,11 +79,41 @@ export interface IPluginStorage {
     set<T>(key: string, value: T): Promise<void>;
     delete(key: string): Promise<void>;
     clear(): Promise<void>;
+    reload(): Promise<void>;
 }
 export interface Logger {
     info(msg: string, ...args: any[]): void;
     warn(msg: string, ...args: any[]): void;
     error(msg: string, ...args: any[]): void;
+    debug?(msg: string, ...args: any[]): void;
+    child?(context: string): Logger;
+}
+export interface IPluginManager {
+    register(plugin: IPlugin): Promise<void>;
+    registerIsolated(pluginPath: string, pluginName: string): Promise<void>;
+    unregister(pluginName: string): Promise<void>;
+    getPlugin(name: string): IPlugin | undefined;
+    listPlugins(): string[];
+    loadPluginsFromDirectory(directoryPath?: string): Promise<void>;
+    disablePlugin(name: string): Promise<void>;
+    enablePlugin(name: string): Promise<void>;
+    reloadPlugin(name: string): Promise<void>;
+    runOnResolve(args: OnResolveArgs): Promise<any>;
+    runOnLoad(args: OnLoadArgs): Promise<any>;
+    toBunPlugin(): any;
+    enableHotReload(pluginDir: string): void;
+    getWorkerFactory(): (url: string | URL, options?: BunWorkerOptions) => Worker;
+    getMetrics(): any;
+    getPluginStatus(): Record<string, any>;
+    registerApi(pluginName: string, api: any): void;
+    getPluginApi(pluginName: string): any | undefined;
+    use(plugin: IPlugin): Promise<void>;
+    plugin(plugin: IPlugin): Promise<void>;
+    remove(pluginName: string): Promise<void>;
+    emit<K extends keyof AppEvents>(eventName: K, payload: AppEvents[K]): boolean;
+    on<K extends keyof AppEvents>(eventName: K & string, listener: (payload: AppEvents[K]) => void): this;
+    once<K extends keyof AppEvents>(eventName: K & string, listener: (payload: AppEvents[K]) => void): this;
+    off<K extends keyof AppEvents>(eventName: K & string, listener: (payload: AppEvents[K]) => void): this;
 }
 export interface PluginContext {
     emit<K extends keyof AppEvents>(event: K, payload: AppEvents[K]): void;
@@ -86,8 +124,9 @@ export interface PluginContext {
     };
     storage: IPluginStorage;
     config: Record<string, any>;
-    manager: any;
-    getPlugin(name: string): unknown | undefined;
+    manager: IPluginManager;
+    getPlugin<TName extends string>(name: TName): Promise<import("./types/plugin-registry-base").PluginApiType<TName> | undefined>;
+    registerApi(api: any): void;
     log: Logger;
     createWorker(url: string | URL, options?: BunWorkerOptions): BunWorker;
     network: {
@@ -116,13 +155,7 @@ export declare class AccessDeniedError extends Error {
 export declare const BasicPluginSchema: z.ZodObject<{
     name: z.ZodString;
     version: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    name: string;
-    version: string;
-}, {
-    name: string;
-    version: string;
-}>;
+}, z.core.$strip>;
 export interface IPlugin {
     name: string;
     version: string;
@@ -139,7 +172,7 @@ export interface IPlugin {
     onLoad(context: PluginContext): Promise<void> | void;
     onStarted?: () => Promise<void> | void;
     onUnload(): Promise<void> | void;
-    getSharedApi?: () => unknown;
+    onReload?: (context: PluginContext) => Promise<void> | void;
     setup?: (build: PluginBuilder) => void | Promise<void>;
 }
 export type OnResolveArgs = {
@@ -163,11 +196,19 @@ export type OnLoadResult = {
 } | undefined | null;
 export type OnLoadCallback = (args: OnLoadArgs) => OnLoadResult | Promise<OnLoadResult>;
 export interface PluginBuilder {
-    onResolve(filter: RegExp, callback: OnResolveCallback, options?: {
+    onStart(callback: () => void | Promise<void>): void;
+    onResolve(filter: RegExp | {
+        filter: RegExp;
+        namespace?: string;
+    }, callback: OnResolveCallback, options?: {
         order?: HookOrder;
     }): void;
-    onLoad(filter: RegExp, callback: OnLoadCallback, options?: {
+    onLoad(filter: RegExp | {
+        filter: RegExp;
+        namespace?: string;
+    }, callback: OnLoadCallback, options?: {
         order?: HookOrder;
     }): void;
+    config: Record<string, any>;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

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

package/dist/{types.js → src/types.js}

@@ -1,4 +1,6 @@
 import { z } from "zod";
+export { z };
+export * from "./types/plugin-registry-base";
 export var WorkerMessageType;
 (function (WorkerMessageType) {
     WorkerMessageType["RPC_CALL"] = "RPC_CALL";
@@ -28,14 +30,18 @@ export var RPCMethod;
     RPCMethod["EventsOn"] = "events:on";
     RPCMethod["HooksRegister"] = "hooks:register";
     RPCMethod["ManagerGetPlugin"] = "manager:getPlugin";
+    RPCMethod["ManagerRegisterApi"] = "manager:registerApi";
     RPCMethod["Log"] = "log";
     RPCMethod["NetworkFetch"] = "network:fetch";
     RPCMethod["PermissionCheck"] = "perm:check";
+    RPCMethod["ConfigGet"] = "config:get";
+    RPCMethod["StorageReload"] = "storage:reload";
 })(RPCMethod || (RPCMethod = {}));
 export var HookType;
 (function (HookType) {
     HookType["ON_RESOLVE"] = "onResolve";
     HookType["ON_LOAD"] = "onLoad";
+    HookType["ON_START"] = "onStart";
 })(HookType || (HookType = {}));
 export var HookOrder;
 (function (HookOrder) {

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,CAAC,EAAE,CAAC;AAEb,cAAc,8BAA8B,CAAA;AAM5C,MAAM,CAAN,IAAY,iBAWX;AAXD,WAAY,iBAAiB;IAC3B,0CAAqB,CAAA;IACrB,4CAAuB,CAAA;IACvB,gDAA2B,CAAA;IAC3B,8CAAyB,CAAA;IACzB,8CAAyB,CAAA;IACzB,0CAAqB,CAAA;IACrB,kDAA6B,CAAA;IAC7B,8CAAyB,CAAA;IACzB,0CAAqB,CAAA;IACrB,sCAAiB,CAAA;AACnB,CAAC,EAXW,iBAAiB,KAAjB,iBAAiB,QAW5B;AAED,MAAM,CAAN,IAAY,gBAIX;AAJD,WAAY,gBAAgB;IAC1B,uCAAmB,CAAA;IACnB,6CAAyB,CAAA;IACzB,+BAAW,CAAA;AACb,CAAC,EAJW,gBAAgB,KAAhB,gBAAgB,QAI3B;AAED,MAAM,CAAN,IAAY,SAeX;AAfD,WAAY,SAAS;IACnB,uCAA0B,CAAA;IAC1B,uCAA0B,CAAA;IAC1B,6CAAgC,CAAA;IAChC,2CAA8B,CAAA;IAC9B,uCAA0B,CAAA;IAC1B,mCAAsB,CAAA;IACtB,6CAAgC,CAAA;IAChC,mDAAsC,CAAA;IACtC,uDAA0C,CAAA;IAC1C,wBAAW,CAAA;IACX,2CAA8B,CAAA;IAC9B,2CAA8B,CAAA;IAC9B,qCAAwB,CAAA;IACxB,6CAAgC,CAAA;AAClC,CAAC,EAfW,SAAS,KAAT,SAAS,QAepB;AAED,MAAM,CAAN,IAAY,QAIX;AAJD,WAAY,QAAQ;IAClB,oCAAwB,CAAA;IACxB,8BAAkB,CAAA;IAClB,gCAAoB,CAAA;AACtB,CAAC,EAJW,QAAQ,KAAR,QAAQ,QAInB;AAED,MAAM,CAAN,IAAY,SAGX;AAHD,WAAY,SAAS;IACnB,wBAAW,CAAA;IACX,0BAAa,CAAA;AACf,CAAC,EAHW,SAAS,KAAT,SAAS,QAGpB;AA+JD,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,UAAkB,EAAE,UAAkB;QAChD,KAAK,CACH,WAAW,UAAU,sBAAsB,UAAU,iCAAiC,CACvF,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED,2DAA2D;AAC3D,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC"}

package/dist/src/utils/errorParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorParser.d.ts","sourceRoot":"","sources":["../../../src/utils/errorParser.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAoBlE;AACD,eAAe,WAAW,CAAC"}

package/dist/{utils → src/utils}/errorParser.js

@@ -1,11 +1,8 @@
 export function errorParser(error, prefix) {
     let parsedError;
-    // Parse the error - always create a new Error to avoid readonly issues
+    // Parse the error
     if (error instanceof Error) {
-        // Create a new Error to avoid modifying potentially frozen Zod errors
-        parsedError = new Error(error.message);
-        parsedError.name = error.name;
-        parsedError.stack = error.stack;
+        parsedError = error;
     }
     else if (typeof error === "string") {
         parsedError = new Error(error);

package/dist/src/utils/errorParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorParser.js","sourceRoot":"","sources":["../../../src/utils/errorParser.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,WAAW,CAAC,KAAc,EAAE,MAAe;IACzD,IAAI,WAAkB,CAAC;IAEvB,kBAAkB;IAClB,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,WAAW,GAAG,KAAK,CAAC;IACtB,CAAC;SAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrC,WAAW,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;SAAM,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,IAAI,KAAK,EAAE,CAAC;QACpE,WAAW,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IACjD,CAAC;SAAM,CAAC;QACN,WAAW,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,6BAA6B;IAC7B,IAAI,MAAM,EAAE,CAAC;QACX,WAAW,CAAC,OAAO,GAAG,GAAG,MAAM,KAAK,WAAW,CAAC,OAAO,EAAE,CAAC;IAC5D,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AACD,eAAe,WAAW,CAAC"}

package/dist/src/utils/pluginValidator.d.ts

@@ -0,0 +1,17 @@
+import type { IPlugin } from "../types";
+export type ValidationResult = {
+    valid: true;
+    plugin: IPlugin;
+} | {
+    valid: false;
+    error: string;
+};
+/**
+ * Validates if an unknown object is a valid plugin.
+ * Handles:
+ * 1. Class instances (Standard)
+ * 2. Plain objects
+ * 3. Class Constructors (instantiates them) // TODO if we want to move that logic here
+ */
+export declare function validatePlugin(candidate: unknown): ValidationResult;
+//# sourceMappingURL=pluginValidator.d.ts.map

package/dist/src/utils/pluginValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginValidator.d.ts","sourceRoot":"","sources":["../../../src/utils/pluginValidator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AA2BxC,MAAM,MAAM,gBAAgB,GACxB;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAChC;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpC;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,OAAO,GAAG,gBAAgB,CAqBnE"}

package/dist/{utils → src/utils}/pluginValidator.js

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { errorParser } from "../utils/errorParser";
-export const PluginSchema = z.object({
+// Internal schemas - NOT exported to avoid Zod type leakage
+const pluginSchemaDefinition = z.object({
     name: z.string().min(1, "Plugin name is required"),
     version: z.string().min(1, "Plugin version is required").default("1.0.0"),
     description: z.string().optional(),
@@ -16,16 +17,8 @@ export const PluginSchema = z.object({
     onLoad: z.function(),
     onStarted: z.function().optional(),
     onUnload: z.function().optional(),
-    getSharedApi: z.function().optional(),
     setup: z.function().optional(),
 });
-// We can have a stricter schema for the full IPlugin
-export const StrictPluginSchema = z.object({
-    name: z.string(),
-    version: z.string(),
-    onLoad: z.function(),
-    onUnload: z.function(),
-});
 /**
  * Validates if an unknown object is a valid plugin.
  * Handles:
@@ -57,17 +50,21 @@ export function validatePlugin(candidate) {
     }
 }
 function validatePluginInstance(obj) {
-    const result = PluginSchema.safeParse(obj);
+    const result = pluginSchemaDefinition.safeParse(obj);
     if (!result.success) {
         return {
             valid: false,
             error: result.error.issues.map((e) => `${e.path.join('.')}: ${e.message}`).join(', ')
         };
     }
-    // Cast to IPlugin (fill in missing optional methods if needed)
-    const plugin = result.data;
-    // Shim onUnload if missing (since we made it optional in schema but it is required in IPlugin interface usually, 
-    // though we can be lenient)
+    // Use the original object to preserve prototype and 'this' context,
+    // but we can use the parsed data to ensure defaults are applied if we want.
+    // For now, let's just return the original object casted to IPlugin.
+    const plugin = obj;
+    // Apply defaults/formatting from Zod if needed (optional)
+    if (!plugin.version && result.data.version)
+        plugin.version = result.data.version;
+    // Shim onUnload if missing
     if (!plugin.onUnload) {
         plugin.onUnload = () => { };
     }