node-pluginsmanager 2.4.4 → 2.5.1

package/lib/cjs/cmd/stdToString.js

@@ -1,16 +1,15 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-// module
-function stdToString(msg) {
-    if ("object" !== typeof msg) {
-        return String(msg);
-    }
-    else if (msg instanceof Buffer) {
-        return msg.toString("utf8");
-    }
-    else {
-        return msg.message ? msg.message : String(msg);
-    }
-}
-exports.default = stdToString;
-;
+"use strict";
+// module
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = stdToString;
+function stdToString(msg) {
+    if ("object" !== typeof msg) {
+        return String(msg);
+    }
+    else if (msg instanceof Buffer) {
+        return msg.toString("utf8");
+    }
+    else {
+        return msg.message ? msg.message : String(msg);
+    }
+}

package/lib/cjs/createPluginByDirectory.d.ts

@@ -1,2 +1,2 @@
-import { Orchestrator, tLogger } from "node-pluginsmanager-plugin";
-export default function createPluginByDirectory(directory: string, externalRessourcesDirectory: string, logger: tLogger | null, ...data: any): Promise<Orchestrator>;
+import type { Orchestrator, tLogger } from "node-pluginsmanager-plugin";
+export default function createPluginByDirectory(directory: string, externalRessourcesDirectory: string, logger: tLogger | null, ...data: any): Promise<Orchestrator>;

package/lib/cjs/createPluginByDirectory.js

@@ -1,61 +1,60 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-// deps
-// natives
-const path_1 = require("path");
-// locals
-const checkAbsoluteDirectory_1 = __importDefault(require("./checkers/checkAbsoluteDirectory"));
-const checkOrchestrator_1 = __importDefault(require("./checkers/checkOrchestrator"));
-const checkFunction_1 = __importDefault(require("./checkers/checkFunction"));
-// module
-function createPluginByDirectory(directory, externalRessourcesDirectory, logger, ...data) {
-    return (0, checkAbsoluteDirectory_1.default)("createPluginByDirectory/directory", directory).then(() => {
-        return (0, checkAbsoluteDirectory_1.default)("createPluginByDirectory/externalRessourcesDirectory", externalRessourcesDirectory);
-    }).then(() => {
-        return new Promise((resolve, reject) => {
-            try {
-                resolve(require(directory));
-            }
-            catch (e) {
-                reject(e);
-            }
-        }).then((Plugin) => {
-            if (Plugin.Orchestrator) {
-                return Promise.resolve(Plugin.Orchestrator);
-            }
-            else if (Plugin.default) {
-                return Promise.resolve(Plugin.default);
-            }
-            else {
-                return Promise.resolve(Plugin);
-            }
-        }).then((Plugin) => {
-            return (0, checkFunction_1.default)("createPluginByDirectory/function", Plugin).then(() => {
-                const pluginBaseNameDirectory = (0, path_1.basename)(directory);
-                const plugin = new Plugin({
-                    // usefull for inherited Orchestrators
-                    "externalRessourcesDirectory": (0, path_1.join)(externalRessourcesDirectory, pluginBaseNameDirectory),
-                    "logger": logger,
-                    // useless, setted in inherited Orchestrators
-                    "packageFile": "",
-                    "descriptorFile": "",
-                    "mediatorFile": "",
-                    "serverFile": ""
-                });
-                return (0, checkOrchestrator_1.default)("createPluginByDirectory/orchestrator", plugin).then(() => {
-                    plugin.name = pluginBaseNameDirectory;
-                    return plugin.load(...data).then(() => {
-                        return plugin.name === pluginBaseNameDirectory ? Promise.resolve() : Promise.reject(new Error("Plugin's name (\"" + plugin.name + "\") does not fit with plugin's directory basename (\"" + pluginBaseNameDirectory + "\")"));
-                    });
-                }).then(() => {
-                    return Promise.resolve(plugin);
-                });
-            });
-        });
-    });
-}
-exports.default = createPluginByDirectory;
-;
+"use strict";
+// deps
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = createPluginByDirectory;
+// natives
+const node_path_1 = require("node:path");
+// locals
+const checkAbsoluteDirectory_1 = __importDefault(require("./checkers/checkAbsoluteDirectory"));
+const checkOrchestrator_1 = __importDefault(require("./checkers/checkOrchestrator"));
+const checkFunction_1 = __importDefault(require("./checkers/checkFunction"));
+// module
+function createPluginByDirectory(directory, externalRessourcesDirectory, logger, ...data) {
+    return (0, checkAbsoluteDirectory_1.default)("createPluginByDirectory/directory", directory).then(() => {
+        return (0, checkAbsoluteDirectory_1.default)("createPluginByDirectory/externalRessourcesDirectory", externalRessourcesDirectory);
+    }).then(() => {
+        return new Promise((resolve, reject) => {
+            try {
+                resolve(require(directory));
+            }
+            catch (e) {
+                reject(e);
+            }
+        }).then((Plugin) => {
+            if (Plugin.Orchestrator) {
+                return Promise.resolve(Plugin.Orchestrator);
+            }
+            else if (Plugin.default) {
+                return Promise.resolve(Plugin.default);
+            }
+            else {
+                return Promise.resolve(Plugin);
+            }
+        }).then((Plugin) => {
+            return (0, checkFunction_1.default)("createPluginByDirectory/function", Plugin).then(() => {
+                const pluginBaseNameDirectory = (0, node_path_1.basename)(directory);
+                const plugin = new Plugin({
+                    // usefull for inherited Orchestrators
+                    "externalRessourcesDirectory": (0, node_path_1.join)(externalRessourcesDirectory, pluginBaseNameDirectory),
+                    "logger": logger,
+                    // useless, setted in inherited Orchestrators
+                    "packageFile": "",
+                    "descriptorFile": "",
+                    "mediatorFile": "",
+                    "serverFile": ""
+                });
+                return (0, checkOrchestrator_1.default)("createPluginByDirectory/orchestrator", plugin).then(() => {
+                    plugin.name = pluginBaseNameDirectory;
+                    return plugin.load(...data).then(() => {
+                        return plugin.name === pluginBaseNameDirectory ? Promise.resolve() : Promise.reject(new Error("Plugin's name (\"" + plugin.name + "\") does not fit with plugin's directory basename (\"" + pluginBaseNameDirectory + "\")"));
+                    });
+                }).then(() => {
+                    return Promise.resolve(plugin);
+                });
+            });
+        });
+    });
+}

package/lib/cjs/extractGithub.d.ts

@@ -1 +1,7 @@
-export default function extractGithub(plugin: any): string;
+import type { Orchestrator } from "node-pluginsmanager-plugin";
+interface OrchestratorExtended extends Orchestrator {
+    "github"?: string;
+    "repository"?: string | Record<string, string>;
+}
+export default function extractGithub(plugin: OrchestratorExtended): string;
+export {};

package/lib/cjs/extractGithub.js

@@ -1,20 +1,20 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-// module
-function extractGithub(plugin) {
-    let github = "";
-    if ("object" === typeof plugin) {
-        if ("string" === typeof plugin.github) {
-            github = plugin.github;
-        }
-        else if ("string" === typeof plugin.repository) {
-            github = plugin.repository;
-        }
-        else if (plugin.repository && "string" === typeof plugin.repository.url) {
-            github = plugin.repository.url;
-        }
-    }
-    return github;
-}
-exports.default = extractGithub;
-;
+"use strict";
+// types & interfaces
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = extractGithub;
+// module
+function extractGithub(plugin) {
+    let github = "";
+    if ("object" === typeof plugin) {
+        if ("string" === typeof plugin.github) {
+            github = plugin.github;
+        }
+        else if ("string" === typeof plugin.repository) {
+            github = plugin.repository;
+        }
+        else if ("object" === typeof plugin.repository && "string" === typeof plugin.repository.url) {
+            github = plugin.repository.url;
+        }
+    }
+    return github;
+}

package/lib/cjs/initSortedPlugins.d.ts

@@ -1,2 +1,2 @@
-import { Orchestrator } from "node-pluginsmanager-plugin";
-export default function initSortedPlugins(plugins: Array<Orchestrator>, orderedPluginsNames: Array<string>, emit: (eventName: string, ...subdata: any) => void, ...data: any): Promise<void>;
+import type { Orchestrator } from "node-pluginsmanager-plugin";
+export default function initSortedPlugins(plugins: Orchestrator[], orderedPluginsNames: string[], emit: (eventName: string, ...subdata: any) => void, ...data: any): Promise<void>;

package/lib/cjs/initSortedPlugins.js

@@ -1,60 +1,60 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-// private
-// methods
-function _initPlugin(plugin, emit, ...data) {
-    emit("initializing", plugin, ...data);
-    return plugin.init(...data).then(() => {
-        emit("initialized", plugin, ...data);
-        return Promise.resolve();
-    });
-}
-function _initPlugins(pluginsToInit, emit, data, i = 0) {
-    return i < pluginsToInit.length ? Promise.resolve().then(() => {
-        return _initPlugin(pluginsToInit[i], emit, ...data);
-        // loop
-    }).then(() => {
-        return _initPlugins(pluginsToInit, emit, data, i + 1);
-    }) : Promise.resolve();
-}
-// module
-function initSortedPlugins(plugins, orderedPluginsNames, emit, ...data) {
-    // if no plugins, does not run
-    return !plugins.length ? Promise.resolve() : Promise.resolve().then(() => {
-        const sortedPlugins = [];
-        orderedPluginsNames.forEach((pluginName) => {
-            const plugin = plugins.find((p) => {
-                return p.name === pluginName;
-            });
-            if (plugin) {
-                sortedPlugins.push(plugin);
-            }
-        });
-        // first, sorted plugins
-        return sortedPlugins.length ?
-            _initPlugins(sortedPlugins, emit, data) :
-            Promise.resolve();
-    }).then(() => {
-        const unsortedPlugin = [
-            ...plugins.filter((plugin) => {
-                return !orderedPluginsNames.includes(plugin.name);
-            }).sort((a, b) => {
-                if (a.name < b.name) {
-                    return -1;
-                }
-                else if (a.name > b.name) {
-                    return 1;
-                }
-                else {
-                    return 0;
-                }
-            })
-        ];
-        // then, all other plugins, asynchronously
-        return unsortedPlugin.length ?
-            _initPlugins(unsortedPlugin, emit, data) :
-            Promise.resolve();
-    });
-}
-exports.default = initSortedPlugins;
-;
+"use strict";
+// types & interfaces
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = initSortedPlugins;
+// private
+// methods
+function _initPlugin(plugin, emit, ...data) {
+    emit("initializing", plugin, ...data);
+    return plugin.init(...data).then(() => {
+        emit("initialized", plugin, ...data);
+        return Promise.resolve();
+    });
+}
+function _initPlugins(pluginsToInit, emit, data, i = 0) {
+    return i < pluginsToInit.length ? Promise.resolve().then(() => {
+        return _initPlugin(pluginsToInit[i], emit, ...data);
+        // loop
+    }).then(() => {
+        return _initPlugins(pluginsToInit, emit, data, i + 1);
+    }) : Promise.resolve();
+}
+// module
+function initSortedPlugins(plugins, orderedPluginsNames, emit, ...data) {
+    // if no plugins, does not run
+    return !plugins.length ? Promise.resolve() : Promise.resolve().then(() => {
+        const sortedPlugins = [];
+        orderedPluginsNames.forEach((pluginName) => {
+            const plugin = plugins.find((p) => {
+                return p.name === pluginName;
+            });
+            if (plugin) {
+                sortedPlugins.push(plugin);
+            }
+        });
+        // first, sorted plugins
+        return sortedPlugins.length
+            ? _initPlugins(sortedPlugins, emit, data)
+            : Promise.resolve();
+    }).then(() => {
+        const unsortedPlugin = [
+            ...plugins.filter((plugin) => {
+                return !orderedPluginsNames.includes(plugin.name);
+            }).sort((a, b) => {
+                if (a.name < b.name) {
+                    return -1;
+                }
+                else if (a.name > b.name) {
+                    return 1;
+                }
+                else {
+                    return 0;
+                }
+            })
+        ];
+        // then, all other plugins, asynchronously
+        return unsortedPlugin.length
+            ? _initPlugins(unsortedPlugin, emit, data)
+            : Promise.resolve();
+    });
+}

package/lib/cjs/loadSortedPlugins.d.ts

@@ -1,2 +1,2 @@
-import { Orchestrator, tLogger } from "node-pluginsmanager-plugin";
-export default function loadSortedPlugins(globalDirectory: string, externalRessourcesDirectory: string, files: Array<string>, loadedPlugins: Array<Orchestrator>, orderedPluginsNames: Array<string>, emit: (eventName: string, ...subdata: any) => void, logger: tLogger | null, ...data: any): Promise<void>;
+import type { Orchestrator, tLogger } from "node-pluginsmanager-plugin";
+export default function loadSortedPlugins(globalDirectory: string, externalRessourcesDirectory: string, files: string[], loadedPlugins: Orchestrator[], orderedPluginsNames: string[], emit: (eventName: string, ...subdata: any) => void, logger: tLogger | null, ...data: any): Promise<void>;

package/lib/cjs/loadSortedPlugins.js

@@ -1,78 +1,77 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-// deps
-// natives
-const path_1 = require("path");
-// locals
-const createPluginByDirectory_1 = __importDefault(require("./createPluginByDirectory"));
-// private
-// methods
-function _loadPlugin(globalDirectory, externalRessourcesDirectory, pluginFileName, loadedPlugins, emit, logger, ...data) {
-    // is already loaded ?
-    const plugin = loadedPlugins.find((p) => {
-        return pluginFileName === p.name;
-    });
-    // is already exists ?
-    return plugin ? Promise.resolve() : Promise.resolve().then(() => {
-        emit("loading", pluginFileName, ...data);
-        const directory = (0, path_1.join)(globalDirectory, pluginFileName);
-        return (0, createPluginByDirectory_1.default)(directory, externalRessourcesDirectory, logger, ...data);
-        // emit event
-    }).then((createdPlugin) => {
-        emit("loaded", createdPlugin, ...data);
-        loadedPlugins.push(createdPlugin);
-        return Promise.resolve();
-    });
-}
-function _loadPlugins(globalDirectory, externalRessourcesDirectory, pluginsToLoad, loadedPlugins, emit, logger, data, i = 0) {
-    return i < pluginsToLoad.length ? Promise.resolve().then(() => {
-        return _loadPlugin(globalDirectory, externalRessourcesDirectory, pluginsToLoad[i], loadedPlugins, emit, logger, ...data);
-        // loop
-    }).then(() => {
-        return _loadPlugins(globalDirectory, externalRessourcesDirectory, pluginsToLoad, loadedPlugins, emit, logger, data, i + 1);
-    }) : Promise.resolve();
-}
-// module
-function loadSortedPlugins(globalDirectory, externalRessourcesDirectory, files, loadedPlugins, orderedPluginsNames, emit, logger, ...data) {
-    // if no files, does not run
-    return !files.length ? Promise.resolve() : Promise.resolve().then(() => {
-        const sortedPluginsNames = [];
-        orderedPluginsNames.forEach((pluginName) => {
-            const plugin = files.find((p) => {
-                return p === pluginName;
-            });
-            if (plugin) {
-                sortedPluginsNames.push(pluginName);
-            }
-        });
-        // first, sorted plugins
-        return sortedPluginsNames.length ?
-            _loadPlugins(globalDirectory, externalRessourcesDirectory, sortedPluginsNames, loadedPlugins, emit, logger, data) :
-            Promise.resolve();
-    }).then(() => {
-        const unsortedPluginsNames = [
-            ...files.filter((pluginName) => {
-                return !orderedPluginsNames.includes(pluginName);
-            }).sort((a, b) => {
-                if (a < b) {
-                    return -1;
-                }
-                else if (a > b) {
-                    return 1;
-                }
-                else {
-                    return 0;
-                }
-            })
-        ];
-        // then, all other plugins, asynchronously
-        return unsortedPluginsNames.length ?
-            _loadPlugins(globalDirectory, externalRessourcesDirectory, unsortedPluginsNames, loadedPlugins, emit, logger, data) :
-            Promise.resolve();
-    });
-}
-exports.default = loadSortedPlugins;
-;
+"use strict";
+// deps
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = loadSortedPlugins;
+// natives
+const node_path_1 = require("node:path");
+// locals
+const createPluginByDirectory_1 = __importDefault(require("./createPluginByDirectory"));
+// private
+// methods
+function _loadPlugin(globalDirectory, externalRessourcesDirectory, pluginFileName, loadedPlugins, emit, logger, ...data) {
+    // is already loaded ?
+    const plugin = loadedPlugins.find((p) => {
+        return pluginFileName === p.name;
+    });
+    // is already exists ?
+    return plugin ? Promise.resolve() : Promise.resolve().then(() => {
+        emit("loading", pluginFileName, ...data);
+        const directory = (0, node_path_1.join)(globalDirectory, pluginFileName);
+        return (0, createPluginByDirectory_1.default)(directory, externalRessourcesDirectory, logger, ...data);
+        // emit event
+    }).then((createdPlugin) => {
+        emit("loaded", createdPlugin, ...data);
+        loadedPlugins.push(createdPlugin);
+        return Promise.resolve();
+    });
+}
+function _loadPlugins(globalDirectory, externalRessourcesDirectory, pluginsToLoad, loadedPlugins, emit, logger, data, i = 0) {
+    return i < pluginsToLoad.length ? Promise.resolve().then(() => {
+        return _loadPlugin(globalDirectory, externalRessourcesDirectory, pluginsToLoad[i], loadedPlugins, emit, logger, ...data);
+        // loop
+    }).then(() => {
+        return _loadPlugins(globalDirectory, externalRessourcesDirectory, pluginsToLoad, loadedPlugins, emit, logger, data, i + 1);
+    }) : Promise.resolve();
+}
+// module
+function loadSortedPlugins(globalDirectory, externalRessourcesDirectory, files, loadedPlugins, orderedPluginsNames, emit, logger, ...data) {
+    // if no files, does not run
+    return !files.length ? Promise.resolve() : Promise.resolve().then(() => {
+        const sortedPluginsNames = [];
+        orderedPluginsNames.forEach((pluginName) => {
+            const plugin = files.find((p) => {
+                return p === pluginName;
+            });
+            if (plugin) {
+                sortedPluginsNames.push(pluginName);
+            }
+        });
+        // first, sorted plugins
+        return sortedPluginsNames.length
+            ? _loadPlugins(globalDirectory, externalRessourcesDirectory, sortedPluginsNames, loadedPlugins, emit, logger, data)
+            : Promise.resolve();
+    }).then(() => {
+        const unsortedPluginsNames = [
+            ...files.filter((pluginName) => {
+                return !orderedPluginsNames.includes(pluginName);
+            }).sort((a, b) => {
+                if (a < b) {
+                    return -1;
+                }
+                else if (a > b) {
+                    return 1;
+                }
+                else {
+                    return 0;
+                }
+            })
+        ];
+        // then, all other plugins, asynchronously
+        return unsortedPluginsNames.length
+            ? _loadPlugins(globalDirectory, externalRessourcesDirectory, unsortedPluginsNames, loadedPlugins, emit, logger, data)
+            : Promise.resolve();
+    });
+}

package/lib/cjs/main.cjs

@@ -1,8 +1,8 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-// deps
-// locals
-const PluginsManager_1 = __importDefault(require("./PluginsManager"));
-module.exports = PluginsManager_1.default;
+"use strict";
+// deps
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+// locals
+const PluginsManager_1 = __importDefault(require("./PluginsManager"));
+module.exports = PluginsManager_1.default;

package/lib/cjs/main.d.cts

@@ -1,2 +1,2 @@
-import PluginsManager from "./PluginsManager";
-export = PluginsManager;
+import PluginsManager from "./PluginsManager";
+export = PluginsManager;

package/lib/cjs/utils/isDirectory.d.ts

@@ -0,0 +1 @@
+export default function isDirectory(directory: string): Promise<boolean>;

package/lib/cjs/utils/isDirectory.js

@@ -0,0 +1,25 @@
+"use strict";
+// deps
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = isDirectory;
+// natives
+const node_fs_1 = require("node:fs");
+// module
+function isDirectory(directory) {
+    return new Promise((resolve, reject) => {
+        if ("undefined" === typeof directory) {
+            reject(new ReferenceError("missing \"directory\" argument"));
+        }
+        else if ("string" !== typeof directory) {
+            reject(new TypeError("\"directory\" argument is not a string"));
+        }
+        else if ("" === directory.trim()) {
+            reject(new Error("\"directory\" argument is empty"));
+        }
+        else {
+            (0, node_fs_1.lstat)(directory, (err, stats) => {
+                return resolve(Boolean(!err && stats.isDirectory()));
+            });
+        }
+    });
+}

package/lib/cjs/utils/rmdirp.d.ts

@@ -0,0 +1 @@
+export default function rmdirp(directory: string): Promise<void>;

package/lib/cjs/utils/rmdirp.js

@@ -0,0 +1,19 @@
+"use strict";
+// deps
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = rmdirp;
+// natives
+const promises_1 = require("node:fs/promises");
+// locals
+const isDirectory_1 = __importDefault(require("./isDirectory"));
+// module
+function rmdirp(directory) {
+    return (0, isDirectory_1.default)(directory).then((exists) => {
+        return exists ? (0, promises_1.rm)(directory, {
+            "recursive": true
+        }) : Promise.resolve();
+    });
+}