node-pluginsmanager-plugin 6.5.0 → 7.0.1

package/lib/cjs/checkers/RangeError/checkNonEmptyNumber.d.ts

@@ -1,2 +1,2 @@
-export declare function checkNonEmptyNumberSync(dataName: string, data: any): ReferenceError | TypeError | RangeError | null;
-export declare function checkNonEmptyNumber(dataName: string, data: any): Promise<void>;
+export declare function checkNonEmptyNumberSync(dataName: string, data: unknown): ReferenceError | TypeError | RangeError | null;
+export declare function checkNonEmptyNumber(dataName: string, data: unknown): Promise<void>;

package/lib/cjs/checkers/RangeError/checkNonEmptyObject.d.ts

@@ -1,2 +1,2 @@
-export declare function checkNonEmptyObjectSync(dataName: string, data: any): ReferenceError | TypeError | RangeError | null;
-export declare function checkNonEmptyObject(dataName: string, data: any): Promise<void>;
+export declare function checkNonEmptyObjectSync(dataName: string, data: unknown): ReferenceError | TypeError | RangeError | null;
+export declare function checkNonEmptyObject(dataName: string, data: unknown): Promise<void>;

package/lib/cjs/checkers/RangeError/checkNonEmptyString.d.ts

@@ -1,2 +1,2 @@
-export declare function checkNonEmptyStringSync(dataName: string, data: any): ReferenceError | TypeError | RangeError | null;
-export declare function checkNonEmptyString(dataName: string, data: any): Promise<void>;
+export declare function checkNonEmptyStringSync(dataName: string, data: unknown): ReferenceError | TypeError | RangeError | null;
+export declare function checkNonEmptyString(dataName: string, data: unknown): Promise<void>;

package/lib/cjs/checkers/ReferenceError/checkExists.d.ts

@@ -1,2 +1,2 @@
-export declare function checkExistsSync(dataName: string, data: any): ReferenceError | null;
-export declare function checkExists(dataName: string, data: any): Promise<void>;
+export declare function checkExistsSync(dataName: string, data: unknown): ReferenceError | null;
+export declare function checkExists(dataName: string, data: unknown): Promise<void>;

package/lib/cjs/checkers/TypeError/checkFunction.d.ts

@@ -1,2 +1,2 @@
-export declare function checkFunctionSync(dataName: string, data: any): ReferenceError | TypeError | null;
-export declare function checkFunction(dataName: string, data: any): Promise<void>;
+export declare function checkFunctionSync(dataName: string, data: unknown): ReferenceError | TypeError | null;
+export declare function checkFunction(dataName: string, data: unknown): Promise<void>;

package/lib/cjs/checkers/TypeError/checkInteger.d.ts

@@ -1,2 +1,2 @@
-export declare function checkIntegerSync(dataName: string, data: any): ReferenceError | TypeError | null;
-export declare function checkInteger(dataName: string, data: any): Promise<void>;
+export declare function checkIntegerSync(dataName: string, data: unknown): ReferenceError | TypeError | null;
+export declare function checkInteger(dataName: string, data: unknown): Promise<void>;

package/lib/cjs/checkers/TypeError/checkNumber.d.ts

@@ -1,2 +1,2 @@
-export declare function checkNumberSync(dataName: string, data: any): ReferenceError | TypeError | null;
-export declare function checkNumber(dataName: string, data: any): Promise<void>;
+export declare function checkNumberSync(dataName: string, data: unknown): ReferenceError | TypeError | null;
+export declare function checkNumber(dataName: string, data: unknown): Promise<void>;

package/lib/cjs/checkers/TypeError/checkObject.d.ts

@@ -1,2 +1,2 @@
-export declare function checkObjectSync(dataName: string, data: any): ReferenceError | TypeError | null;
-export declare function checkObject(dataName: string, data: any): Promise<void>;
+export declare function checkObjectSync(dataName: string, data: unknown): ReferenceError | TypeError | null;
+export declare function checkObject(dataName: string, data: unknown): Promise<void>;

package/lib/cjs/checkers/TypeError/checkString.d.ts

@@ -1,2 +1,2 @@
-export declare function checkStringSync(dataName: string, data: any): ReferenceError | TypeError | null;
-export declare function checkString(dataName: string, data: any): Promise<void>;
+export declare function checkStringSync(dataName: string, data: unknown): ReferenceError | TypeError | null;
+export declare function checkString(dataName: string, data: unknown): Promise<void>;

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

@@ -3,32 +3,31 @@ import type { OpenApiDocument } from "express-openapi-validate";
 export type tLogType = "data" | "debug" | "log" | "info" | "success" | "warning" | "error";
 export type tLogger = (type: tLogType, message: string | Error, bold?: boolean, pluginName?: string) => void;
 export interface iDescriptorUserOptions {
-    "externalRessourcesDirectory": string;
+    "externalResourcesDirectory": string;
     "descriptor"?: OpenApiDocument;
     "logger"?: tLogger;
 }
-export type tEventMap<T> = Record<keyof T, any[]> | tEventsNoEvent;
-export type tEventsNoEvent = [never];
+export type tEventMap<T> = Record<keyof T, unknown[]>;
+export type tEventsNoEvent = {};
 export interface iEventsMinimal {
     "error": [Error];
-    "initialized": [any];
-    "released": [any];
+    "initialized": [unknown];
+    "released": [unknown];
 }
 export default class DescriptorUser<T extends tEventMap<T> = tEventsNoEvent> extends EventEmitter<T> {
     initialized: boolean;
     protected _descriptorValidated: boolean;
-    protected _externalRessourcesDirectory: string;
+    protected _externalResourcesDirectory: string;
     protected _Descriptor: OpenApiDocument | null;
     protected _Logger: tLogger | null;
     constructor(options: iDescriptorUserOptions);
-    protected _initWorkSpace(...data: any): Promise<void>;
-    protected _releaseWorkSpace(...data: any): Promise<void>;
+    protected _initWorkSpace(...data: unknown[]): Promise<void>;
+    protected _releaseWorkSpace(...data: unknown[]): 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;
-    init(...data: any): Promise<void>;
-    release(...data: any): Promise<void>;
+    init(...data: unknown[]): Promise<void>;
+    release(...data: unknown[]): Promise<void>;
     checkDescriptor(): Promise<void>;
 }

package/lib/cjs/components/DescriptorUser.js

@@ -1,6 +1,10 @@
 "use strict";
-//  deps
+/*
+    eslint-disable @typescript-eslint/no-unused-vars
+*/
+// => @typescript-eslint/no-unused-vars is disabled to allow inheritance with proper signature
 Object.defineProperty(exports, "__esModule", { value: true });
+//  deps
 // natives
 const node_events_1 = require("node:events");
 // locals
@@ -16,9 +20,17 @@ const LOG_TYPES_ALLOWED = [
     "error"
 ];
 // module
-// Please note the fact that "_initWorkSpace" and "_releaseWorkSpace" method MUST be re-writted in Mediator class, and not in MediatorUser childs.
-// Please note the fact that "init" and "release" method MUST NOT be re-writted. Each child has is own init logic.
+// Please note the fact that "_initWorkSpace" and "_releaseWorkSpace" method MUST be re-written in Mediator class, and not in MediatorUser childs.
+// Please note the fact that "init" and "release" method MUST NOT be re-written. Each child has its own init logic.
 class DescriptorUser extends node_events_1.EventEmitter {
+    // attributes
+    // public
+    initialized;
+    // protected
+    _descriptorValidated;
+    _externalResourcesDirectory;
+    _Descriptor;
+    _Logger;
     // constructor
     constructor(options) {
         super();
@@ -26,15 +38,17 @@ class DescriptorUser extends node_events_1.EventEmitter {
         this.initialized = false;
         // protected
         this._descriptorValidated = false;
-        this._externalRessourcesDirectory = "string" === typeof (options === null || options === void 0 ? void 0 : options.externalRessourcesDirectory)
-            ? options.externalRessourcesDirectory
-            : "";
-        this._Descriptor = "object" === typeof (options === null || options === void 0 ? void 0 : options.descriptor)
-            ? options.descriptor
-            : null;
-        this._Logger = "function" === typeof (options === null || options === void 0 ? void 0 : options.logger)
-            ? options.logger
-            : null;
+        // mandatory props
+        if ("object" !== typeof options) {
+            throw new ReferenceError("\"options\" must be a non-null object");
+        }
+        if ("string" !== typeof options.externalResourcesDirectory) {
+            throw new ReferenceError("\"options.externalResourcesDirectory\" must be a string");
+        }
+        // optional props
+        this._externalResourcesDirectory = options.externalResourcesDirectory;
+        this._Descriptor = options.descriptor ?? null;
+        this._Logger = options.logger ?? null;
     }
     // protected
     // must be inherited
@@ -51,72 +65,69 @@ 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 : "";
+        return this._Descriptor?.info.title ?? "";
     }
     getPluginVersion() {
-        return this._Descriptor && this._Descriptor.info && this._Descriptor.info.version ? this._Descriptor.info.version : "";
+        return this._Descriptor?.info.version ?? "";
     }
     getPluginDescription() {
-        return this._Descriptor && this._Descriptor.info && this._Descriptor.info.description ? this._Descriptor.info.description : "";
+        return this._Descriptor?.info.description ?? "";
     }
     // must be inherited
     init(...data) {
-        console.log("DescriptorUser", "init", ...data);
         return Promise.reject(new Error("\"init\" method must be inherited"));
     }
     // must be inherited
     release(...data) {
-        console.log("DescriptorUser", "release", ...data);
         return Promise.reject(new Error("\"release\" method must be inherited"));
     }
     // must be inherited
     checkDescriptor() {
+        if (this._descriptorValidated) {
+            return Promise.resolve();
+        }
         // check Descriptor object
-        return this._descriptorValidated ? Promise.resolve() : (0, checkNonEmptyObject_1.checkNonEmptyObject)("Descriptor", this._Descriptor).then(() => {
+        return (0, checkNonEmptyObject_1.checkNonEmptyObject)("Descriptor", this._Descriptor).then(() => {
             // check info object
             return (0, checkNonEmptyObject_1.checkNonEmptyObject)("Descriptor.info", this._Descriptor.info).then(() => {
+                const { title, version } = this._Descriptor.info;
                 // check title
-                return (0, checkNonEmptyString_1.checkNonEmptyString)("Descriptor.info.title", this._Descriptor.info.title).then(() => {
-                    return this._Descriptor.info.title !== this._Descriptor.info.title.toLowerCase()
-                        ? Promise.reject(new Error("The descriptor's title (\"" + this._Descriptor.info.title + "\") "
+                return (0, checkNonEmptyString_1.checkNonEmptyString)("Descriptor.info.title", title).then(() => {
+                    return title !== title.toLowerCase()
+                        ? Promise.reject(new Error("The descriptor's title (\"" + title + "\") "
                             + "is not equals in lower case (package.json convention)"))
                         : Promise.resolve();
                     // check version
                 }).then(() => {
-                    return (0, checkNonEmptyString_1.checkNonEmptyString)("Descriptor.info.version", this._Descriptor.info.version);
+                    return (0, checkNonEmptyString_1.checkNonEmptyString)("Descriptor.info.version", version);
                 });
             });
         }).then(() => {
+            const { paths } = this._Descriptor;
             // check paths object
-            return ((0, checkObject_1.checkObject)("Descriptor.paths", this._Descriptor.paths)).then(() => {
+            return (0, checkObject_1.checkObject)("Descriptor.paths", paths).then(() => {
                 // check multiple operationIds
                 return Promise.resolve().then(() => {
                     const operationIds = [];
-                    Object.keys(this._Descriptor.paths).forEach((p) => {
-                        Object.keys(this._Descriptor.paths[p]).forEach((m) => {
-                            const path = this._Descriptor.paths[p];
-                            if (path[m].operationId) {
-                                operationIds.push(path[m].operationId);
+                    Object.keys(paths).forEach((pathname) => {
+                        const path = paths[pathname];
+                        Object.keys(path).forEach((method) => {
+                            const operation = path[method];
+                            if ("string" === typeof operation?.operationId) {
+                                operationIds.push(operation.operationId);
                             }
                         });
                     });
                     let multiple = false;
-                    for (let i = 0; i < operationIds.length - 1; ++i) {
-                        for (let j = i + 1; j < operationIds.length; ++j) {
-                            if (operationIds[i] === operationIds[j]) {
-                                multiple = true;
-                                break;
-                            }
-                        }
-                        if (multiple) {
+                    const seen = new Set();
+                    for (let i = 0; i < operationIds.length; ++i) {
+                        if (seen.has(operationIds[i])) {
+                            multiple = true;
                             break;
                         }
+                        seen.add(operationIds[i]);
                     }
                     return multiple ? Promise.reject(new Error("There is multiple operationIds in [\" " + operationIds.join("\", ") + " \"]")) : Promise.resolve();
                 });

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

@@ -1,26 +1,21 @@
 import { OpenApiValidator } from "express-openapi-validate";
 import DescriptorUser from "./DescriptorUser";
 import type { iDescriptorUserOptions, tEventMap, iEventsMinimal } from "./DescriptorUser";
-import type { iIncomingMessage, iServerResponse } from "./Server";
-export interface iIncomingMessageForMediatorValidation extends iIncomingMessage {
-    "body": any;
-}
-export interface iServerResponseForMediatorValidation extends iServerResponse {
-    "body": any;
-}
+import type { iFormatedServerResponseForValidation } from "./Server";
 export interface iUrlAllowedParameters {
-    "path"?: Record<string, any>;
-    "query"?: Record<string, any>;
-    "headers"?: Record<string, any>;
-    "cookies"?: Record<string, any>;
-    "header"?: Record<string, any>;
-    "cookie"?: Record<string, any>;
+    "path"?: Record<string, unknown>;
+    "query"?: Record<string, unknown>;
+    "headers"?: Record<string, unknown>;
+    "cookies"?: Record<string, unknown>;
+    "header"?: Record<string, unknown>;
+    "cookie"?: Record<string, unknown>;
 }
+export type iOperationHandler = (url: iUrlAllowedParameters, body: unknown) => Promise<string>;
 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>;
-    checkResponse(operationId: string, res: iServerResponseForMediatorValidation): Promise<void>;
-    init(...data: any): Promise<void>;
-    release(...data: any): Promise<void>;
+    checkParameters(operationId: string, urlParams?: iUrlAllowedParameters, bodyParams?: unknown): Promise<void>;
+    checkResponse(operationId: string, res: iFormatedServerResponseForValidation): Promise<void>;
+    init(...data: unknown[]): Promise<void>;
+    release(...data: unknown[]): Promise<void>;
 }

package/lib/cjs/components/Mediator.js

@@ -14,6 +14,9 @@ const extractPathMethodByOperationId_1 = __importDefault(require("../utils/descr
 const DescriptorUser_1 = __importDefault(require("./DescriptorUser"));
 // module
 class Mediator extends DescriptorUser_1.default {
+    // attributes
+    // protected
+    _validator;
     // constructor
     constructor(options) {
         super(options);
@@ -22,12 +25,11 @@ class Mediator extends DescriptorUser_1.default {
     // public
     // Check sended parameters by method name (used by the Server)
     checkParameters(operationId, urlParams, bodyParams) {
-        var _a, _b, _c, _d, _e, _f;
         const urlControlledParameters = {
-            "path": urlParams ? (_a = urlParams === null || urlParams === void 0 ? void 0 : urlParams.path) !== null && _a !== void 0 ? _a : {} : {},
-            "query": urlParams ? (_b = urlParams === null || urlParams === void 0 ? void 0 : urlParams.query) !== null && _b !== void 0 ? _b : {} : {},
-            "headers": urlParams ? (_d = (_c = urlParams === null || urlParams === void 0 ? void 0 : urlParams.headers) !== null && _c !== void 0 ? _c : urlParams === null || urlParams === void 0 ? void 0 : urlParams.header) !== null && _d !== void 0 ? _d : {} : {},
-            "cookies": urlParams ? (_f = (_e = urlParams === null || urlParams === void 0 ? void 0 : urlParams.cookies) !== null && _e !== void 0 ? _e : urlParams === null || urlParams === void 0 ? void 0 : urlParams.cookie) !== null && _f !== void 0 ? _f : {} : {},
+            "path": urlParams?.path ?? {},
+            "query": urlParams?.query ?? {},
+            "headers": urlParams?.headers ?? urlParams?.header ?? {},
+            "cookies": urlParams?.cookies ?? urlParams?.cookie ?? {}
         };
         // parameters validation
         return this.checkDescriptor().then(() => {
@@ -46,7 +48,7 @@ class Mediator extends DescriptorUser_1.default {
             });
         }).then(() => {
             // search wanted operation
-            const foundPathMethod = (0, extractPathMethodByOperationId_1.default)(this._Descriptor.paths, operationId);
+            const foundPathMethod = (0, extractPathMethodByOperationId_1.default)(this._Descriptor?.paths, operationId);
             return !foundPathMethod ? Promise.reject(new ReferenceError("Unknown operationId \"" + operationId + "\"")) : new Promise((resolve, reject) => {
                 const req = {
                     "path": foundPathMethod.path,
@@ -57,31 +59,51 @@ class Mediator extends DescriptorUser_1.default {
                     "cookies": urlControlledParameters.cookies,
                     "body": bodyParams
                 };
-                const validateRequest = this._validator.validate(req.method, req.path); // set to "any" for ts validation
+                const validateRequest = this._validator.validate(req.method, req.path);
                 validateRequest(req, null, (err) => {
-                    return err ? reject(err) : resolve();
+                    if ("undefined" === typeof err || null === err) {
+                        return resolve();
+                    }
+                    else if (err instanceof Error) {
+                        return reject(err);
+                    }
+                    else if ("object" === typeof err) {
+                        if ("undefined" !== typeof err.message) {
+                            return reject(new Error(err.message));
+                        }
+                        return reject(new Error(err));
+                    }
+                    return reject(new Error(String(err)));
                 });
             });
         }).catch((err) => {
-            return err instanceof express_openapi_validate_1.ValidationError ? Promise.resolve().then(() => {
-                switch (err.data[0].keyword) { // extract first Error
-                    case "required":
-                        return Promise.reject(new ReferenceError(err.message));
-                    case "type":
-                    case "pattern":
-                        return Promise.reject(new TypeError(err.message));
-                    case "minimum":
-                    case "maximum":
-                    case "minLength":
-                    case "maxLength":
-                    case "minItems":
-                    case "maxItems":
-                    case "enum":
-                        return Promise.reject(new RangeError(err.message));
-                    default:
-                        return Promise.reject(new Error(err.message));
-                }
-            }) : Promise.reject(err);
+            if (!(err instanceof express_openapi_validate_1.ValidationError)) {
+                return Promise.reject(err);
+            }
+            if ("object" !== typeof err.data
+                || !(err.data instanceof Array)
+                || 0 >= err.data.length
+                || "object" !== typeof err.data[0]
+                || "string" !== typeof err.data[0].keyword) {
+                return Promise.reject(new Error(err.message));
+            }
+            switch (err.data[0].keyword) { // extract first Error
+                case "required":
+                    return Promise.reject(new ReferenceError(err.message));
+                case "type":
+                case "pattern":
+                    return Promise.reject(new TypeError(err.message));
+                case "minimum":
+                case "maximum":
+                case "minLength":
+                case "maxLength":
+                case "minItems":
+                case "maxItems":
+                case "enum":
+                    return Promise.reject(new RangeError(err.message));
+                default:
+                    return Promise.reject(new Error(err.message));
+            }
         });
     }
     // Check sended parameters by method name (used by the Server)
@@ -91,7 +113,7 @@ class Mediator extends DescriptorUser_1.default {
             return (0, checkNonEmptyString_1.checkNonEmptyString)("operationId", operationId);
         }).then(() => {
             // search wanted operation
-            const foundPathMethod = (0, extractPathMethodByOperationId_1.default)(this._Descriptor.paths, operationId);
+            const foundPathMethod = (0, extractPathMethodByOperationId_1.default)(this._Descriptor?.paths, operationId);
             return !foundPathMethod ? Promise.reject(new ReferenceError("Unknown operationId \"" + operationId + "\"")) : new Promise((resolve, reject) => {
                 // no content, no validation
                 if (204 === res.statusCode) {
@@ -102,18 +124,16 @@ class Mediator extends DescriptorUser_1.default {
                     return resolve();
                 }
                 // validator cannot correctly check pure boolean return
-                else if ("undefined" !== typeof res.body && ["true", "false", true, false].includes(res.body)) {
+                else if ("undefined" !== typeof res.body && [
+                    "true", "false", true, false
+                ].includes(res.body)) {
                     return resolve();
                 }
                 else {
                     try {
-                        const mutedRes = Object.assign({}, res);
-                        mutedRes.headers = res.getHeaders();
-                        if ("undefined" === typeof mutedRes.body || "" === mutedRes.body) {
-                            mutedRes.body = {};
-                        }
-                        const validateResponse = this._validator.validateResponse(foundPathMethod.method, foundPathMethod.path);
-                        validateResponse(mutedRes);
+                        const validateResponse = this._validator
+                            .validateResponse(foundPathMethod.method, foundPathMethod.path);
+                        validateResponse(res);
                         return resolve();
                     }
                     catch (e) {
@@ -122,7 +142,7 @@ class Mediator extends DescriptorUser_1.default {
                             + " (" + foundPathMethod.operationId + ") => "
                             + res.statusCode
                             + "\r\n"
-                            + (e.message ? e.message : e)));
+                            + (e.message ? e.message : String(e))));
                     }
                 }
             });
@@ -133,7 +153,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._emitEventGenericForTSPurposeDONOTUSE("initialized", [...data]);
+            this.emit("initialized", ...data);
         });
     }
     release(...data) {
@@ -142,7 +162,7 @@ class Mediator extends DescriptorUser_1.default {
             this._Descriptor = null;
             this._validator = null;
             this.initialized = false;
-            this._emitEventGenericForTSPurposeDONOTUSE("released", [...data]);
+            this.emit("released", ...data);
         }).then(() => {
             this.removeAllListeners();
         });

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

@@ -7,7 +7,7 @@ export interface iMediatorUserOptions extends iDescriptorUserOptions {
 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>;
-    protected _releaseWorkSpace(...data: any): Promise<void>;
+    protected _initWorkSpace(...data: unknown[]): Promise<void>;
+    protected _releaseWorkSpace(...data: unknown[]): Promise<void>;
     checkMediator(): Promise<void>;
 }

package/lib/cjs/components/MediatorUser.js

@@ -1,21 +1,28 @@
 "use strict";
-//  deps
+/*
+    eslint-disable @typescript-eslint/no-unused-vars
+*/
+// => @typescript-eslint/no-unused-vars is disabled to allow inheritance with proper signature
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+//  deps
 // locals
 const DescriptorUser_1 = __importDefault(require("./DescriptorUser"));
 const Mediator_1 = __importDefault(require("./Mediator"));
 // module
-// Please note the fact that "init" and "release" method MUST NOT be re-writted. Each child has is own init logic
+// Please note the fact that "init" and "release" method MUST NOT be re-written. Each child has its own init logic
 class MediatorUser extends DescriptorUser_1.default {
+    // attributes
+    // protected
+    _Mediator; // provided by "mediator" option, sent by the [Orchestrator](./Orchestrator.md)
     // constructor
     constructor(options) {
         super(options);
-        this._Mediator = options && "undefined" !== typeof options.mediator
-            ? options.mediator
-            : null;
+        // protected
+        // optional props
+        this._Mediator = options.mediator ?? null;
     }
     // protected
     _initWorkSpace(...data) {

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

@@ -1,21 +1,21 @@
 import MediatorUser from "./MediatorUser";
 import Server from "./Server";
-import type { IncomingMessage } from "node:http";
+import type { IncomingMessage, ServerResponse } 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 { Server as SocketIOServerV2 } from "../../@types/socket.io-v2";
 import type { tLogger, tEventMap, iEventsMinimal } from "./DescriptorUser";
 export interface iOrchestratorOptions {
-    "externalRessourcesDirectory": string;
+    "externalResourcesDirectory": string;
     "packageFile": string;
     "descriptorFile": string;
     "mediatorFile": string;
     "serverFile": string;
     "logger"?: tLogger;
 }
-export default class Orchestrator<T extends tEventMap<T> = iEventsMinimal> extends MediatorUser<T> {
+export default class Orchestrator<T extends iEventsMinimal & tEventMap<T> = iEventsMinimal> extends MediatorUser<T> {
     protected _Server: Server | null;
-    protected _socketServer: WebSocketServer | SocketIOServer | null;
+    protected _socketServer: WebSocketServer | SocketIOServer | SocketIOServerV2 | null;
     protected _checkParameters: boolean;
     protected _checkResponse: boolean;
     protected _packageFile: string;
@@ -45,13 +45,13 @@ export default class Orchestrator<T extends tEventMap<T> = iEventsMinimal> exten
     enableCheckResponse(): this;
     disableCors(): this;
     enableCors(): this;
-    appMiddleware(req: IncomingMessage, res: iServerResponse, next: () => void): void;
+    appMiddleware(req: IncomingMessage, res: ServerResponse, next: () => void): void;
     socketMiddleware(server: WebSocketServer | SocketIOServer): void;
-    load(...data: any): Promise<void>;
-    destroy(...data: any): Promise<void>;
-    init(...data: any): Promise<void>;
-    release(...data: any): Promise<void>;
-    install(...data: any): Promise<void>;
-    update(...data: any): Promise<void>;
-    uninstall(...data: any): Promise<void>;
+    load(...data: unknown[]): Promise<void>;
+    destroy(...data: unknown[]): Promise<void>;
+    init(...data: unknown[]): Promise<void>;
+    release(...data: unknown[]): Promise<void>;
+    install(...data: unknown[]): Promise<void>;
+    update(...data: unknown[]): Promise<void>;
+    uninstall(...data: unknown[]): Promise<void>;
 }