node-pluginsmanager-plugin 6.4.5 → 6.5.0

package/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2024, Sébastien Vidal
+Copyright (c) 2025, Sébastien Vidal
 
 Permission to use, copy, modify, and/or distribute this software for any
 purpose with or without fee is hereby granted, provided that the above

package/lib/cjs/components/DescriptorUser.d.ts

@@ -7,7 +7,14 @@ export interface iDescriptorUserOptions {
     "descriptor"?: OpenApiDocument;
     "logger"?: tLogger;
 }
-export default class DescriptorUser extends EventEmitter {
+export type tEventMap<T> = Record<keyof T, any[]> | tEventsNoEvent;
+export type tEventsNoEvent = [never];
+export interface iEventsMinimal {
+    "error": [Error];
+    "initialized": [any];
+    "released": [any];
+}
+export default class DescriptorUser<T extends tEventMap<T> = tEventsNoEvent> extends EventEmitter<T> {
     initialized: boolean;
     protected _descriptorValidated: boolean;
     protected _externalRessourcesDirectory: string;
@@ -17,6 +24,7 @@ export default class DescriptorUser extends EventEmitter {
     protected _initWorkSpace(...data: any): Promise<void>;
     protected _releaseWorkSpace(...data: any): Promise<void>;
     protected _log(type: tLogType, message: string | Error, bold?: boolean): this;
+    protected _emitEventGenericForTSPurposeDONOTUSE(event: string, ...args: any[]): boolean;
     getPluginName(): string;
     getPluginVersion(): string;
     getPluginDescription(): string;

package/lib/cjs/components/DescriptorUser.js

@@ -51,6 +51,10 @@ class DescriptorUser extends node_events_1.EventEmitter {
         }
         return this;
     }
+    // used to faint the typing of EventEmitter for emit into a generic class (which MUST be inherited anyway) like Mediator/Server/Orchestrator
+    _emitEventGenericForTSPurposeDONOTUSE(event, ...args) {
+        return this.emit(event, ...args);
+    }
     // public
     getPluginName() {
         return this._Descriptor && this._Descriptor.info && this._Descriptor.info.title ? this._Descriptor.info.title : "";

package/lib/cjs/components/Mediator.d.ts

@@ -1,5 +1,6 @@
 import { OpenApiValidator } from "express-openapi-validate";
-import DescriptorUser, { type iDescriptorUserOptions } from "./DescriptorUser";
+import DescriptorUser from "./DescriptorUser";
+import type { iDescriptorUserOptions, tEventMap, iEventsMinimal } from "./DescriptorUser";
 import type { iIncomingMessage, iServerResponse } from "./Server";
 export interface iIncomingMessageForMediatorValidation extends iIncomingMessage {
     "body": any;
@@ -15,7 +16,7 @@ export interface iUrlAllowedParameters {
     "header"?: Record<string, any>;
     "cookie"?: Record<string, any>;
 }
-export default class Mediator extends DescriptorUser {
+export default class Mediator<T extends tEventMap<T> = iEventsMinimal> extends DescriptorUser<T> {
     protected _validator: OpenApiValidator | null;
     constructor(options: iDescriptorUserOptions);
     checkParameters(operationId: string, urlParams?: iUrlAllowedParameters, bodyParams?: any): Promise<void>;

package/lib/cjs/components/Mediator.js

@@ -133,7 +133,7 @@ class Mediator extends DescriptorUser_1.default {
         return this._initWorkSpace(...data).then(() => {
             this._validator = new express_openapi_validate_1.OpenApiValidator(this._Descriptor);
             this.initialized = true;
-            this.emit("initialized", ...data);
+            this._emitEventGenericForTSPurposeDONOTUSE("initialized", [...data]);
         });
     }
     release(...data) {
@@ -142,7 +142,7 @@ class Mediator extends DescriptorUser_1.default {
             this._Descriptor = null;
             this._validator = null;
             this.initialized = false;
-            this.emit("released", ...data);
+            this._emitEventGenericForTSPurposeDONOTUSE("released", [...data]);
         }).then(() => {
             this.removeAllListeners();
         });

package/lib/cjs/components/MediatorUser.d.ts

@@ -1,9 +1,10 @@
-import DescriptorUser, { type iDescriptorUserOptions } from "./DescriptorUser";
+import DescriptorUser from "./DescriptorUser";
 import Mediator from "./Mediator";
+import type { iDescriptorUserOptions, tEventMap, tEventsNoEvent } from "./DescriptorUser";
 export interface iMediatorUserOptions extends iDescriptorUserOptions {
     "mediator"?: Mediator;
 }
-export default class MediatorUser extends DescriptorUser {
+export default class MediatorUser<T extends tEventMap<T> = tEventsNoEvent> extends DescriptorUser<T> {
     protected _Mediator: Mediator | null;
     constructor(options: iMediatorUserOptions);
     protected _initWorkSpace(...data: any): Promise<void>;

package/lib/cjs/components/Orchestrator.d.ts

@@ -1,10 +1,10 @@
 import MediatorUser from "./MediatorUser";
 import Server from "./Server";
-import { IncomingMessage } from "node:http";
+import type { IncomingMessage } from "node:http";
 import type { Server as SocketIOServer } from "socket.io";
 import type { Server as WebSocketServer } from "ws";
 import type { iServerResponse } from "./Server";
-import type { tLogger } from "./DescriptorUser";
+import type { tLogger, tEventMap, iEventsMinimal } from "./DescriptorUser";
 export interface iOrchestratorOptions {
     "externalRessourcesDirectory": string;
     "packageFile": string;
@@ -13,7 +13,7 @@ export interface iOrchestratorOptions {
     "serverFile": string;
     "logger"?: tLogger;
 }
-export default class Orchestrator extends MediatorUser {
+export default class Orchestrator<T extends tEventMap<T> = iEventsMinimal> extends MediatorUser<T> {
     protected _Server: Server | null;
     protected _socketServer: WebSocketServer | SocketIOServer | null;
     protected _checkParameters: boolean;

package/lib/cjs/components/Orchestrator.js

@@ -121,7 +121,7 @@ class Orchestrator extends MediatorUser_1.default {
         this.checkServer().then(() => {
             this._Server.disableCors();
         }).catch((err) => {
-            this.emit("error", err);
+            this._emitEventGenericForTSPurposeDONOTUSE("error", err);
         });
         return this;
     }
@@ -129,7 +129,7 @@ class Orchestrator extends MediatorUser_1.default {
         this.checkServer().then(() => {
             this._Server.enableCors();
         }).catch((err) => {
-            this.emit("error", err);
+            this._emitEventGenericForTSPurposeDONOTUSE("error", err);
         });
         return this;
     }
@@ -303,7 +303,7 @@ class Orchestrator extends MediatorUser_1.default {
                     return this.checkMediator().then(() => {
                         // intercept errors to avoid non-catched ones
                         this._Mediator.on("error", (err) => {
-                            this.emit("error", err);
+                            this._emitEventGenericForTSPurposeDONOTUSE("error", err);
                         });
                     });
                 });
@@ -339,7 +339,7 @@ class Orchestrator extends MediatorUser_1.default {
                     return this.checkServer().then(() => {
                         // intercept errors to avoid non-catched ones
                         this._Server.on("error", (err) => {
-                            this.emit("error", err);
+                            this._emitEventGenericForTSPurposeDONOTUSE("error", err);
                         });
                     });
                 });
@@ -363,7 +363,7 @@ class Orchestrator extends MediatorUser_1.default {
                 return this._Mediator.init(...data);
             }).then(() => {
                 this.initialized = true;
-                this.emit("initialized", ...data);
+                this._emitEventGenericForTSPurposeDONOTUSE("initialized", ...data);
             });
         });
     }
@@ -381,7 +381,7 @@ class Orchestrator extends MediatorUser_1.default {
         }).then(() => {
             this._Descriptor = null;
             this.initialized = false;
-            this.emit("released", ...data);
+            this._emitEventGenericForTSPurposeDONOTUSE("released", ...data);
         });
     }
     // write

package/lib/cjs/components/Server.d.ts

@@ -2,6 +2,7 @@ import MediatorUser, { type iMediatorUserOptions } from "./MediatorUser";
 import type { IncomingMessage, ServerResponse } from "node:http";
 import type { Server as WebSocketServer } from "ws";
 import type { Server as SocketIOServer } from "socket.io";
+import type { tEventMap, iEventsMinimal } from "./DescriptorUser";
 export interface iClient {
     "id": string;
     "status": "CONNECTED" | "DISCONNECTED";
@@ -22,7 +23,7 @@ export interface iServerResponse extends ServerResponse {
     "body": string;
     "headers": Record<string, any>;
 }
-export default class Server extends MediatorUser {
+export default class Server<T extends tEventMap<T> = iEventsMinimal> extends MediatorUser<T> {
     protected _socketServer: WebSocketServer | SocketIOServer | null;
     protected _checkParameters: boolean;
     protected _checkResponse: boolean;

package/lib/cjs/components/Server.js

@@ -634,7 +634,7 @@ class Server extends MediatorUser_1.default {
             return this._initWorkSpace(...data);
         }).then(() => {
             this.initialized = true;
-            this.emit("initialized", ...data);
+            this._emitEventGenericForTSPurposeDONOTUSE("initialized", ...data);
         });
     }
     release(...data) {
@@ -650,7 +650,7 @@ class Server extends MediatorUser_1.default {
             this._externalRessourcesDirectory = "";
             this._socketServer = null;
             this.initialized = false;
-            this.emit("released", ...data);
+            this._emitEventGenericForTSPurposeDONOTUSE("released", ...data);
         }).then(() => {
             this.removeAllListeners();
         });

package/lib/cjs/main.d.cts

@@ -20,7 +20,7 @@ import { checkIntegerBetween, checkIntegerBetweenSync } from "./checkers/RangeEr
 import { checkArrayLength, checkArrayLengthSync } from "./checkers/RangeError/checkArrayLength";
 import { checkArrayLengthBetween, checkArrayLengthBetweenSync } from "./checkers/RangeError/checkArrayLengthBetween";
 export { checkExists, checkExistsSync, checkBoolean, checkBooleanSync, checkFunction, checkFunctionSync, checkNumber, checkNumberSync, checkObject, checkObjectSync, checkString, checkStringSync, checkArray, checkArraySync, checkInteger, checkIntegerSync, checkNonEmptyArray, checkNonEmptyArraySync, checkNonEmptyInteger, checkNonEmptyIntegerSync, checkNonEmptyNumber, checkNonEmptyNumberSync, checkNonEmptyObject, checkNonEmptyObjectSync, checkNonEmptyString, checkNonEmptyStringSync, checkNumberBetween, checkNumberBetweenSync, checkObjectLength, checkObjectLengthSync, checkObjectLengthBetween, checkObjectLengthBetweenSync, checkStringLength, checkStringLengthSync, checkStringLengthBetween, checkStringLengthBetweenSync, checkIntegerBetween, checkIntegerBetweenSync, checkArrayLength, checkArrayLengthSync, checkArrayLengthBetween, checkArrayLengthBetweenSync };
-import DescriptorUser, { type iDescriptorUserOptions, type tLogType, type tLogger } from "./components/DescriptorUser";
+import DescriptorUser, { type iDescriptorUserOptions, type tLogType, type tLogger, type iEventsMinimal } from "./components/DescriptorUser";
 import Mediator, { type iUrlAllowedParameters } from "./components/Mediator";
 import MediatorUser, { type iMediatorUserOptions } from "./components/MediatorUser";
 import Orchestrator, { type iOrchestratorOptions } from "./components/Orchestrator";
@@ -28,5 +28,5 @@ import Server, { type iClient, type iServerResponse } from "./components/Server"
 import UnauthorizedError from "./components/errors/UnauthorizedError";
 import NotFoundError from "./components/errors/NotFoundError";
 import LockedError from "./components/errors/LockedError";
-export type { tLogType, tLogger, iUrlAllowedParameters, iClient, iServerResponse };
+export type { tLogType, tLogger, iEventsMinimal, iUrlAllowedParameters, iClient, iServerResponse };
 export { DescriptorUser, type iDescriptorUserOptions, Mediator, MediatorUser, type iMediatorUserOptions, Orchestrator, type iOrchestratorOptions, Server, UnauthorizedError, NotFoundError, LockedError };

package/lib/cjs/utils/descriptor/extractPathMethodByOperationId.d.ts

@@ -1,4 +1,4 @@
-import { OpenApiDocument } from "express-openapi-validate";
+import type { OpenApiDocument } from "express-openapi-validate";
 export type tMethod = "get" | "put" | "post" | "delete" | "options" | "head" | "patch" | "trace";
 export interface iPathMethod {
     "path": string;

package/lib/cjs/utils/request/extractCookies.d.ts

@@ -1,2 +1,2 @@
-import { iIncomingMessage } from "../../components/Server";
+import type { iIncomingMessage } from "../../components/Server";
 export default function extractCookies(req: iIncomingMessage): Record<string, string>;

package/package.json

@@ -1,7 +1,7 @@
 {
 
   "name": "node-pluginsmanager-plugin",
-  "version": "6.4.5",
+  "version": "6.5.0",
   "description": "An abstract parent plugin for node-pluginsmanager",
 
   "type": "commonjs",
@@ -43,13 +43,13 @@
   },
 
   "dependencies": {
-    "@apidevtools/swagger-parser": "12.0.0",
+    "@apidevtools/swagger-parser": "12.1.0",
     "express-openapi-validate": "0.6.1",
     "uniqid": "5.4.0"
   },
   "devDependencies": {
-    "@types/express": "5.0.3",
-    "@types/node": "24.3.0",
+    "@types/express": "5.0.5",
+    "@types/node": "24.9.2",
     "@types/socket.io": "3.0.2",
     "@types/uniqid": "5.3.4",
     "@types/ws": "8.18.1",
@@ -58,13 +58,13 @@
     "eslint-plugin-personnallinter": "git+ssh://git@github.com/Psychopoulet/eslint-plugin-personnallinter",
     "express": "5.1.0",
     "husky": "9.1.7",
-    "mocha": "11.7.1",
+    "mocha": "11.7.4",
     "nyc": "17.1.0",
     "openapi-types": "12.1.3",
-    "rimraf": "6.0.1",
+    "rimraf": "6.1.0",
     "socket.io": "4.8.1",
     "socket.io-client": "4.8.1",
-    "typescript": "5.9.2",
+    "typescript": "5.9.3",
     "used-deps-analyzer": "0.1.8",
     "ws": "8.18.3"
   },