taon 19.0.66 → 19.0.68

package/lib/endpoint-context.js

@@ -21,11 +21,12 @@ const lib_4 = require("taon-typeorm/lib"); // @websql
 const lib_5 = require("taon-typeorm/lib"); // @websql
 const lib_6 = require("taon-typeorm/lib");
 const lib_7 = require("tnp-config/lib");
-const lib_8 = require("tnp-core/lib"); // @backend
-const lib_9 = require("tnp-core/lib");
+const lib_8 = require("tnp-core/lib");
+const lib_9 = require("tnp-core/lib"); // @backend
 const lib_10 = require("tnp-core/lib");
 const lib_11 = require("tnp-core/lib");
 const lib_12 = require("tnp-core/lib");
+const lib_13 = require("tnp-core/lib");
 const constants_1 = require("./constants");
 const context_db_migrations_1 = require("./context-db-migrations");
 const di_container_1 = require("./dependency-injection/di-container");
@@ -43,10 +44,6 @@ class EndpointContext {
     configFn;
     cloneOptions;
     //#region static
-    /**
-     * JUST FOR TESTING PURPOSES
-     */
-    USE_MARIADB_MYSQL_IN_DOCKER = false;
     /* */
     /* */
     /* */
@@ -55,15 +52,14 @@ class EndpointContext {
     /* */
     /* */
     /* */
-    // public static findForTraget(classFnOrObject: any): EndpointContext {
-    //   const obj = ClassHelpers.getClassFnFromObject(classFnOrObject) || {};
-    //   return (
-    //     classFnOrObject[Symbols.ctxInClassOrClassObj] ||
-    //     obj[Symbols.ctxInClassOrClassObj]
-    //   );
-    // }
     //#endregion
     //#region fields
+    //#region fields / use mariadb mysql in docker
+    /**
+     * JUST FOR TESTING PURPOSES
+     */
+    USE_MARIADB_MYSQL_IN_DOCKER = false;
+    //#endregion
     //#region fields / flags
     disabledRealtime = false;
     /**
@@ -72,8 +68,12 @@ class EndpointContext {
      */
     inited = false;
     //#endregion
+    //#region fields / db migrations
     dbMigrations = new context_db_migrations_1.ContextDbMigrations(this);
+    //#endregion
+    //#region fields / local instance obj symbol
     localInstaceObjSymbol = Symbol('localInstaceObjSymbol');
+    //#endregion
     //#region fields / all instances of classes from context
     /**
      * all instances of classes from context
@@ -100,7 +100,9 @@ class EndpointContext {
         return this.cloneOptions?.sourceContext;
     }
     //#endregion
+    //#region fields / skip writing server routes
     skipWritingServerRoutes = false;
+    //#endregion
     //#region fields / types from contexts
     injectableTypesfromContexts = [
         models_1.Models.ClassType.CONTROLLER,
@@ -111,11 +113,12 @@ class EndpointContext {
         models_1.Models.ClassType.MIGRATION,
     ];
     //#endregion
+    //#region fields / all types from contexts
     allTypesfromContexts = [
         ...this.injectableTypesfromContexts,
         models_1.Models.ClassType.ENTITY,
     ];
-    // public __contextForControllerInstanceAccess?: EndpointContext;
+    //#endregion
     //#region fields / express app
     expressApp = {};
     //#endregion
@@ -161,31 +164,37 @@ class EndpointContext {
     //#endregion
     //#region fields / logs
     get logHttp() {
-        if (lib_11._.isObject(this.config?.logs)) {
+        if (lib_12._.isObject(this.config?.logs)) {
             return !!this.config.logs.http;
         }
         return this.config?.logs === true;
     }
     get logRealtime() {
-        if (lib_11._.isObject(this.config?.logs)) {
+        if (lib_12._.isObject(this.config?.logs)) {
             return !!this.config.logs.realtime;
         }
         return this.config?.logs === true;
     }
     get logFramework() {
-        if (lib_11._.isObject(this.config?.logs)) {
+        if (lib_12._.isObject(this.config?.logs)) {
             return !!this.config.logs.framework;
         }
         return this.config?.logs === true;
     }
+    get logRoutes() {
+        if (lib_12._.isObject(this.config?.logs)) {
+            return !!this.config.logs.routes;
+        }
+        return this.config?.logs === true;
+    }
     get logDb() {
-        if (lib_11._.isObject(this.config?.logs)) {
+        if (lib_12._.isObject(this.config?.logs)) {
             return !!this.config.logs.db;
         }
         return this.config?.logs === true;
     }
     get logMigrations() {
-        if (lib_11._.isObject(this.config?.logs)) {
+        if (lib_12._.isObject(this.config?.logs)) {
             return !!this.config.logs.migrations;
         }
         return this.config?.logs === true;
@@ -209,7 +218,7 @@ class EndpointContext {
         this.configFn = configFn;
         this.cloneOptions = cloneOptions;
         this.cloneOptions = this.cloneOptions || {};
-        this.isRunningInsideDocker = lib_9.UtilsOs.isRunningInDocker();
+        this.isRunningInsideDocker = lib_10.UtilsOs.isRunningInDocker();
     }
     //#endregion
     //#region methods & getters / init
@@ -221,7 +230,7 @@ class EndpointContext {
         // @ts-ignore
         this.onlyMigrationRevertToTimestamp = onlyMigrationRevertToTimestamp;
         this.config = this.configFn({});
-        if (lib_11._.isObject(this.config.database)) {
+        if (lib_12._.isObject(this.config.database)) {
             this.config.database = models_1.Models.DatabaseConfig.from(this.config.database).databaseConfigTypeORM;
         }
         this.config.host = this.host === null ? void 0 : this.host;
@@ -236,15 +245,15 @@ class EndpointContext {
         if (this.config.host &&
             !this.config.host.startsWith('http://') &&
             !this.config.host.startsWith('https://')) {
-            lib_11.Helpers.throw(`[taon-config] Your${this.host ? ' remote' : ''} 'host' must start with http:// or https://`);
+            lib_12.Helpers.throw(`[taon-config] Your${this.host ? ' remote' : ''} 'host' must start with http:// or https://`);
         }
-        if (lib_11._.isUndefined(this.config.useIpcWhenElectron)) {
+        if (lib_12._.isUndefined(this.config.useIpcWhenElectron)) {
             this.config.useIpcWhenElectron = true;
         }
         // console.log(`config for ${this.contextName}`, this.config);
         //#region resolve if skipping writing server routes
         //@ts-expect-error overriding readonly
-        this.skipWritingServerRoutes = lib_11._.isBoolean(this.config.skipWritingServerRoutes)
+        this.skipWritingServerRoutes = lib_12._.isBoolean(this.config.skipWritingServerRoutes)
             ? this.config.skipWritingServerRoutes
             : false;
         //#endregion
@@ -261,8 +270,8 @@ class EndpointContext {
         //   useIpcWhenElectron: ${this.config.useIpcWhenElectron}
         //   Helpers.isElectron: ${Helpers.isElectron}
         //   `)
-        if (this.config.useIpcWhenElectron && lib_11.Helpers.isElectron) {
-            if (lib_11.Helpers.isWebSQL) {
+        if (this.config.useIpcWhenElectron && lib_12.Helpers.isElectron) {
+            if (lib_12.Helpers.isWebSQL) {
                 this.mode = 'backend-frontend(websql-electron)';
             }
             else {
@@ -277,7 +286,7 @@ class EndpointContext {
         if (!this.mode && !this.config.abstract) {
             const errMsg = `You need to provide host property or ` +
                 `useIpcWhenElectron or mark it as abstract`;
-            lib_11.Helpers.error(`[taon][Context=${this.contextName}]: ${errMsg}`, false, true);
+            lib_12.Helpers.error(`[taon][Context=${this.contextName}]: ${errMsg}`, false, true);
             //#region @backend
             process.exit(1);
             //#endregion
@@ -293,7 +302,7 @@ class EndpointContext {
         `);
             this.databaseConfig = this.getAutoGeneratedConfig();
         }
-        else if (lib_11._.isObject(this.config.database)) {
+        else if (lib_12._.isObject(this.config.database)) {
             this.logFramework &&
                 console.log(`
 
@@ -302,13 +311,13 @@ class EndpointContext {
         `);
             this.databaseConfig = this.getAutoGeneratedConfig();
             lib_2.walk.Object(this.config.database, (value, lodashPath) => {
-                if (lib_11._.isNil(value) || lib_11._.isFunction(value) || lib_11._.isObject(value)) {
+                if (lib_12._.isNil(value) || lib_12._.isFunction(value) || lib_12._.isObject(value)) {
                     // skipping
                 }
                 else {
                     this.logFramework &&
                         console.info(`Overriding database config: ${lodashPath}=${value}`);
-                    lib_11._.set(this.databaseConfig, lodashPath, value);
+                    lib_12._.set(this.databaseConfig, lodashPath, value);
                 }
             }, {
                 walkGetters: false,
@@ -317,7 +326,7 @@ class EndpointContext {
         //#endregion
         //#region resolve session
         if (this.config.session) {
-            this.session = lib_11._.cloneDeep(this.config.session);
+            this.session = lib_12._.cloneDeep(this.config.session);
             const oneHour = 1000 * 60 * 60 * 1; // 24;
             if (!this.session.cookieMaxAge) {
                 this.session.cookieMaxAge = oneHour;
@@ -424,17 +433,17 @@ class EndpointContext {
                 await this.initCustomBackendMiddlewares();
                 const shouldStartHttpsSecureServer = this.isHttpServer && !this.isRunningInsideDocker;
                 this.logFramework &&
-                    lib_11.Helpers.info(`
+                    lib_12.Helpers.info(`
 
           Starting server ${shouldStartHttpsSecureServer ? 'with' : 'without'} HTTPS secure server
 
           `);
                 this.serverTcpUdp = shouldStartHttpsSecureServer
-                    ? new lib_8.https.Server({
+                    ? new lib_9.https.Server({
                         key: this.config.https?.key,
                         cert: this.config.https?.cert,
                     }, this.expressApp)
-                    : new lib_8.http.Server(this.expressApp);
+                    : new lib_9.http.Server(this.expressApp);
                 this.publicAssets.forEach(asset => {
                     this.expressApp.use(asset.serverPath, express.static(asset.locationOnDisk));
                 });
@@ -455,7 +464,7 @@ class EndpointContext {
                 // }
                 //#endregion
                 this.logRealtime &&
-                    lib_11.Helpers.info(`[ctx=${this.contextName}] Init Realtime for ${this.mode}`);
+                    lib_12.Helpers.info(`[ctx=${this.contextName}] Init Realtime for ${this.mode}`);
                 this.realtime = new realtime_core_1.RealtimeCore(this);
             }
             //#endregion
@@ -464,16 +473,16 @@ class EndpointContext {
         // console.log({ ref })
         if (this.config.abstract) {
             this.logFramework &&
-                lib_11.Helpers.info(`[taon] Create abstract context: ${this.config.contextName}`);
+                lib_12.Helpers.info(`[taon] Create abstract context: ${this.config.contextName}`);
         }
         else {
             if (this.isRemoteHost) {
                 this.logFramework &&
-                    lib_11.Helpers.info(`[taon] Create context for remote host: ${this.config.host}`);
+                    lib_12.Helpers.info(`[taon] Create context for remote host: ${this.config.host}`);
             }
             else {
                 this.logFramework &&
-                    lib_11.Helpers.info(`[taon] Create context for host: ${this.config.host}`);
+                    lib_12.Helpers.info(`[taon] Create context for host: ${this.config.host}`);
             }
         }
         //#endregion
@@ -518,7 +527,7 @@ class EndpointContext {
 
           `);
                 //#region @backend
-                const locationOfTheDatabase = (0, lib_10.crossPlatformPath)([
+                const locationOfTheDatabase = (0, lib_11.crossPlatformPath)([
                     process.cwd(),
                     `db-${this.contextName}.sqlite`,
                 ]);
@@ -531,14 +540,14 @@ class EndpointContext {
                     logging: true,
                 });
                 //#region @backend
-                if (!lib_8.fse.existsSync(locationOfTheDatabase)) {
+                if (!lib_9.fse.existsSync(locationOfTheDatabase)) {
                     databaseConfig.recreateMode = 'DROP_DB+MIGRATIONS';
                 }
                 // TODO @LAST add same thing for mariadb/mysql
                 this.logFramework &&
                     console.log(`
           location of database: ${locationOfTheDatabase}
-          db file exists: ${lib_8.fse.existsSync(locationOfTheDatabase)}
+          db file exists: ${lib_9.fse.existsSync(locationOfTheDatabase)}
           synchronize: ${databaseConfig.synchronize}
           dropSchema: ${databaseConfig.dropSchema}
         `);
@@ -548,24 +557,24 @@ class EndpointContext {
         else {
             //#region auto resolve db config
             this.logFramework &&
-                lib_11.Helpers.info(`[taon][database] Automatically resolving database config for mode ${this.mode}`);
+                lib_12.Helpers.info(`[taon][database] Automatically resolving database config for mode ${this.mode}`);
             switch (this.mode) {
                 //#region resolve database config for backend-frontend(ipc-electron)
                 case 'backend-frontend(ipc-electron)':
                     let dbLocationInOs;
                     //#region @backend
-                    if (lib_9.UtilsOs.isElectron) {
-                        dbLocationInOs = (0, lib_10.crossPlatformPath)([
-                            lib_9.UtilsOs.getRealHomeDir(),
-                            `.taon/databases-for-electron-apps/${this.appId || lib_11._.snakeCase(process.cwd()).replace(/\_/, '.')}/${this.contextName}.sqlite`,
+                    if (lib_10.UtilsOs.isElectron) {
+                        dbLocationInOs = (0, lib_11.crossPlatformPath)([
+                            lib_10.UtilsOs.getRealHomeDir(),
+                            `.taon/databases-for-electron-apps/${this.appId || lib_12._.snakeCase(process.cwd()).replace(/\_/, '.')}/${this.contextName}.sqlite`,
                         ]);
-                        if (!lib_11.Helpers.exists(lib_12.path.dirname(dbLocationInOs))) {
-                            lib_11.Helpers.mkdirp(lib_12.path.dirname(dbLocationInOs));
+                        if (!lib_12.Helpers.exists(lib_13.path.dirname(dbLocationInOs))) {
+                            lib_12.Helpers.mkdirp(lib_13.path.dirname(dbLocationInOs));
                         }
                     }
                     //#endregion
                     databaseConfig = models_1.Models.DatabaseConfig.from({
-                        location: lib_9.UtilsOs.isElectron
+                        location: lib_10.UtilsOs.isElectron
                             ? dbLocationInOs
                             : `db-${this.contextName}.sqlite`,
                         type: 'sqljs',
@@ -629,9 +638,9 @@ class EndpointContext {
                     // this.displayRoutes(this.expressApp);
                     this.serverTcpUdp.listen(Number(this.uriPort), '0.0.0.0', () => {
                         this.logFramework &&
-                            lib_11.Helpers.log(`[ctx=${this.contextName}] Express server (inside docker) started 0.0.0.0:${this.uriPort}`);
+                            lib_12.Helpers.log(`[ctx=${this.contextName}] Express server (inside docker) started 0.0.0.0:${this.uriPort}`);
                         this.logFramework &&
-                            lib_11.Helpers.log(`[taon][express-server]listening on port: ${this.uriPort}, hostname: ${this.uriPathname},
+                            lib_12.Helpers.log(`[taon][express-server]listening on port: ${this.uriPort}, hostname: ${this.uriPathname},
     address: ${this.uriProtocol}//localhost:${this.uriPort}${this.uriPathname}
     ExpressJS mode: ${this.expressApp.settings.env}
     `);
@@ -642,9 +651,9 @@ class EndpointContext {
                     // this.displayRoutes(this.expressApp);
                     this.serverTcpUdp.listen(Number(this.uriPort), () => {
                         this.logFramework &&
-                            lib_11.Helpers.log(`[ctx=${this.contextName}] Express server (inside nodejs app) started on localhost:${this.uriPort}`);
+                            lib_12.Helpers.log(`[ctx=${this.contextName}] Express server (inside nodejs app) started on localhost:${this.uriPort}`);
                         this.logFramework &&
-                            lib_11.Helpers.log(`[taon][express-server]listening on port: ${this.uriPort}, hostname: ${this.uriPathname},
+                            lib_12.Helpers.log(`[taon][express-server]listening on port: ${this.uriPort}, hostname: ${this.uriPathname},
     address: ${this.uriProtocol}//localhost:${this.uriPort}${this.uriPathname}
     expressJS mode: ${this.expressApp.settings.env}
             `);
@@ -655,7 +664,7 @@ class EndpointContext {
         }
         else {
             this.logFramework &&
-                lib_11.Helpers.info('Ipc communication enable instead tcp/upd');
+                lib_12.Helpers.info('Ipc communication enable instead tcp/upd');
         }
         //#endregion
     }
@@ -763,7 +772,7 @@ class EndpointContext {
         for (const key of Object.keys(classesInput || {})) {
             const BaseClass = classesInput[key];
             if (!BaseClass) {
-                lib_11.Helpers.error(`Class ${key} is not defined in context ${ctx.contextName}
+                lib_12.Helpers.error(`Class ${key} is not defined in context ${ctx.contextName}
 
         Please check if you have correct import in context file
 
@@ -842,7 +851,7 @@ class EndpointContext {
             let entityName = '';
             // entity thing is only for repositories local repositories
             // if (className === 'BaseRepository') {
-            const entityFn = lib_11._.first(locaInstanceConstructorArgs);
+            const entityFn = lib_12._.first(locaInstanceConstructorArgs);
             const entity = entityFn && entityFn();
             entityName = (entity && class_helpers_1.ClassHelpers.getName(entity)) || '';
             // console.log(`entityName `, entityName);
@@ -905,7 +914,7 @@ class EndpointContext {
     //#endregion
     //#region methods & getters / check if context initialized
     checkIfContextInitialized() {
-        if (lib_11._.isUndefined(this.config)) {
+        if (lib_12._.isUndefined(this.config)) {
             throw new Error(`Please check if your context has been initialized.
 
       // ...
@@ -1003,7 +1012,7 @@ class EndpointContext {
         ]) {
             //#region init class static _ property
             for (const classFun of this.getClassFunByArr(classTypeName)) {
-                if (lib_11._.isFunction(classFun._)) {
+                if (lib_12._.isFunction(classFun._)) {
                     await classFun._();
                 }
             }
@@ -1021,7 +1030,7 @@ class EndpointContext {
             //   `[taon] REINITING _ INS FN ${classTypeName} ${this.contextName} STARTED`,
             // );
             for (const ctrl of this.getClassesInstancesArrBy(classTypeName)) {
-                if (lib_11._.isFunction(ctrl._)) {
+                if (lib_12._.isFunction(ctrl._)) {
                     await ctrl._();
                 }
             }
@@ -1093,7 +1102,7 @@ class EndpointContext {
         return isNonRootProperPathName ? this.uri.pathname.replace(/\/$/, '') : '';
     }
     //#endregion
-    //#region port from uri
+    //#region methods & getters / port from uri
     get uriPort() {
         if (!this.uri?.origin?.includes('localhost')) {
             return this.config?.hostPortNumber?.toString();
@@ -1114,12 +1123,15 @@ class EndpointContext {
         return this.uriProtocol === 'https:';
     }
     //#endregion
-    //#region methods & getters / public assets
+    //#region methods & getters / is remote host
+    /**
+     * Check if context is for remote only
+     */
     get isRemoteHost() {
         return !!this.cloneOptions?.useAsRemoteContext;
     }
     //#endregion
-    //#region methods & getters / public assets
+    //#region methods & getters / context name
     /**
      * ipc/udp needs this
      */
@@ -1128,7 +1140,7 @@ class EndpointContext {
         return this.config?.contextName || this.originalConfig?.contextName;
     }
     //#endregion
-    //#region methods & getters / public assets
+    //#region methods & getters / context name for communication
     /**
      * ipc/udp needs this
      */
@@ -1147,7 +1159,7 @@ class EndpointContext {
         return contextName;
     }
     //#endregion
-    //#region methods & getters / public assets
+    //#region methods & getters / get context type
     /**
      * Check context type
      */
@@ -1191,8 +1203,8 @@ class EndpointContext {
         return this.config.host;
     }
     //#endregion
-    //#region methods & getters / host
-    get orgin() {
+    //#region methods & getters / origin
+    get origin() {
         return this.uri?.origin;
     }
     //#endregion
@@ -1221,7 +1233,7 @@ class EndpointContext {
         const entities = this.getClassFunByArr(models_1.Models.ClassType.ENTITY);
         for (const entity of entities) {
             const options = Reflect.getMetadata(symbols_1.Symbols.metadata.options.entity, entity);
-            const createTable = lib_11._.isUndefined(options.createTable)
+            const createTable = lib_12._.isUndefined(options.createTable)
                 ? true
                 : options.createTable;
             const nameForEntity = class_helpers_1.ClassHelpers.getName(entity);
@@ -1269,7 +1281,7 @@ class EndpointContext {
         });
         const subscribers = this.getClassFunByArr(models_1.Models.ClassType.SUBSCRIBER);
         let autoSave = false;
-        if (!lib_11._.isNil(this.databaseConfig.autoSave)) {
+        if (!lib_12._.isNil(this.databaseConfig.autoSave)) {
             autoSave = this.databaseConfig.autoSave;
         }
         else {
@@ -1280,7 +1292,7 @@ class EndpointContext {
                 autoSave = true; // on docker with sqljs I need to save db
             }
         }
-        const dataSourceDbConfig = lib_11._.isObject(this.databaseConfig)
+        const dataSourceDbConfig = lib_12._.isObject(this.databaseConfig)
             ? {
                 type: this.databaseConfig.type,
                 port: this.databaseConfig.databasePort,
@@ -1309,7 +1321,7 @@ class EndpointContext {
         if (this.modeAllowsDatabaseCreation && this.databaseConfig) {
             this.logDb &&
                 this.logFramework &&
-                lib_11.Helpers.info('[taon][database] prepare typeorm connection...');
+                lib_12.Helpers.info('[taon][database] prepare typeorm connection...');
             try {
                 const connection = new lib_6.DataSource(dataSourceDbConfig);
                 this.connection = connection;
@@ -1351,7 +1363,7 @@ class EndpointContext {
             //     debugger;
         }
         else {
-            lib_11.Helpers.info(`[taon][typeorm] Not initing db for mode ${this.mode}`);
+            lib_12.Helpers.info(`[taon][typeorm] Not initing db for mode ${this.mode}`);
         }
         //#endregion
     }
@@ -1359,7 +1371,7 @@ class EndpointContext {
     //#region methods & getters / initialize metadata
     //#region methods & getters / update class calculate path
     updateCalculatedPathsForControllers(rawConfigs, classConfig, controllerClassFn) {
-        const parentsCalculatedPath = lib_11._.slice(rawConfigs, 1)
+        const parentsCalculatedPath = lib_12._.slice(rawConfigs, 1)
             .reverse()
             .map(bc => {
             if (taon_helpers_1.TaonHelpers.isGoodPath(bc.path)) {
@@ -1379,7 +1391,7 @@ class EndpointContext {
                 .replace(/\/\//g, '/')
                 .split('/')
                 .reduce((acc, bc) => {
-                return lib_11._.last(acc) === bc ? acc : [...acc, bc];
+                return lib_12._.last(acc) === bc ? acc : [...acc, bc];
             }, [])
                 .join('/');
         }
@@ -1389,8 +1401,8 @@ class EndpointContext {
     //#region methods & getters / dedupe class configs
     mergeControllerMethodsConfigs(rawConfigs, classConfig, controllerClassFn) {
         const currentControllerMethodsConfig = classConfig.methods;
-        lib_11._.slice(rawConfigs, 1).forEach(bc => {
-            const parentControllerMethods = lib_11._.cloneDeep(bc.methods);
+        lib_12._.slice(rawConfigs, 1).forEach(bc => {
+            const parentControllerMethods = lib_12._.cloneDeep(bc.methods);
             for (const methodsName in parentControllerMethods) {
                 if (parentControllerMethods.hasOwnProperty(methodsName)) {
                     if (!currentControllerMethodsConfig[methodsName]) {
@@ -1411,7 +1423,7 @@ class EndpointContext {
         const allControllers = this.getClassFunByArr(models_1.Models.ClassType.CONTROLLER);
         for (const controllerClassFn of allControllers) {
             const instance = this.getInstanceBy(controllerClassFn);
-            if (lib_11._.isFunction(instance.afterAllCtxInited)) {
+            if (lib_12._.isFunction(instance.afterAllCtxInited)) {
                 await instance.afterAllCtxInited({ ctxStorage });
             }
         }
@@ -1441,7 +1453,7 @@ class EndpointContext {
             //#region combine middlewares from controllers
             classConfig.calculatedMiddlewaresControllerObj = {};
             [...rawConfigs].reverse().forEach(rc => {
-                if (lib_11._.isFunction(rc.middlewares)) {
+                if (lib_12._.isFunction(rc.middlewares)) {
                     classConfig.calculatedMiddlewaresControllerObj = rc.middlewares({
                         parentMiddlewares: classConfig.calculatedMiddlewaresControllerObj,
                         className(middlewareClass) {
@@ -1453,7 +1465,7 @@ class EndpointContext {
             //#endregion
             //#region group start
             //#region @backend
-            if (!lib_11.Helpers.isRunningIn.cliMode()) {
+            if (!lib_12.Helpers.isRunningIn.cliMode()) {
                 //#endregion
                 this.logHttp &&
                     console.groupCollapsed(`[taon][express-server] routes [${classConfig.className}]`);
@@ -1470,7 +1482,7 @@ class EndpointContext {
                 [...rawConfigs].reverse().forEach(rc => {
                     if (rc.methods[methodName]) {
                         const parentMethodConfig = rc.methods[methodName];
-                        if (lib_11._.isFunction(parentMethodConfig.middlewares)) {
+                        if (lib_12._.isFunction(parentMethodConfig.middlewares)) {
                             calculatedMiddlewaresMethodObj = parentMethodConfig.middlewares({
                                 parentMiddlewares: calculatedMiddlewaresMethodObj,
                                 className(middlewareClass) {
@@ -1501,7 +1513,7 @@ class EndpointContext {
                 //#endregion
                 //#region init server
                 // console.log({ expressPath });
-                if (lib_11.Helpers.isNode || lib_11.Helpers.isWebSQL) {
+                if (lib_12.Helpers.isNode || lib_12.Helpers.isWebSQL) {
                     //#region @websql
                     const route = this.initServer(httpMethodType, methodConfig, classConfig, expressPath, controllerClassFn);
                     this.activeRoutes.push({
@@ -1512,7 +1524,7 @@ class EndpointContext {
                 }
                 //#endregion
                 //#region init client
-                const shouldInitClient = lib_11.Helpers.isBrowser || this.isRemoteHost || lib_11.Helpers.isWebSQL;
+                const shouldInitClient = lib_12.Helpers.isBrowser || this.isRemoteHost || lib_12.Helpers.isWebSQL;
                 // console.log('shouldInitClient', shouldInitClient);
                 if (shouldInitClient) {
                     // console.log(
@@ -1529,7 +1541,7 @@ class EndpointContext {
             //#endregion
             //#region group end
             //#region @backend
-            if (!lib_11.Helpers.isRunningIn.cliMode()) {
+            if (!lib_12.Helpers.isRunningIn.cliMode()) {
                 //#endregion
                 this.logHttp && console.groupEnd();
                 //#region @backend
@@ -1541,18 +1553,16 @@ class EndpointContext {
     //#endregion
     //#region methods & getters / write active routes
     writeActiveRoutes() {
-        if (this.isRemoteHost ||
-            this.isRunOrRevertOnlyMigrationAppStart ||
-            this.skipWritingServerRoutes) {
+        if (this.isRemoteHost || this.isRunOrRevertOnlyMigrationAppStart) {
             return;
         }
         // const contexts: EndpointContext[] = [this];
         //#region @websql
-        const troutes = lib_9.Utils.uniqArray(this.activeRoutes.map(f => {
+        const troutes = lib_10.Utils.uniqArray(this.activeRoutes.map(f => {
             return `${f.method} ${f.expressPath}`;
         })).map(f => {
             const [method, expressPath] = f.split(' ');
-            return (`\n### ${lib_11._.startCase(lib_11._.last(expressPath.split('/')))}\n` +
+            return (`\n### ${lib_12._.startCase(lib_12._.last(expressPath.split('/')))}\n` +
                 taon_helpers_1.TaonHelpers.fillUpTo(method.toUpperCase() + ' ', 10) +
                 this.uriOrigin +
                 expressPath);
@@ -1563,17 +1573,17 @@ class EndpointContext {
             ...['', `#  ROUTES FOR HOST ${this.uriOrigin} `],
             ...troutes,
         ].join('\n');
-        const fileName = (0, lib_10.crossPlatformPath)([
+        const fileName = (0, lib_11.crossPlatformPath)([
             //#region @backend
             process.cwd(),
             //#endregion
             `routes-${this.config.contextName}.rest`,
         ]);
         this.logFramework && console.log(`[taon] routes file: ${fileName} `);
-        // Helpers.log(JSON.stringify(routes, null, 4))
+        this.logRoutes && console.log(routes);
         //#region @backend
-        if (!lib_9.UtilsOs.isElectron) {
-            lib_11.Helpers.writeFile(fileName, routes);
+        if (!lib_10.UtilsOs.isElectron && !this.skipWritingServerRoutes) {
+            lib_12.Helpers.writeFile(fileName, routes);
         }
         //#endregion
         //#endregion
@@ -1590,7 +1600,7 @@ class EndpointContext {
     async initCustomClientMiddlewares() {
         const middlewares = this.getClassesInstancesArrBy(models_1.Models.ClassType.MIDDLEWARE)
             .map(f => f)
-            .filter(f => lib_11._.isFunction(f.interceptClient));
+            .filter(f => lib_12._.isFunction(f.interceptClient));
         middlewares.forEach(middlewareInstanceName => {
             const contextName = this.contextName;
             const interceptorName = `${contextName}-${class_helpers_1.ClassHelpers.getName(middlewareInstanceName)}`;
@@ -1615,7 +1625,7 @@ class EndpointContext {
         const middlewares = this.getClassesInstancesArrBy(models_1.Models.ClassType.MIDDLEWARE);
         for (const middleware of middlewares) {
             const middlewareInstance = middleware;
-            if (lib_11._.isFunction(middlewareInstance.interceptServer)) {
+            if (lib_12._.isFunction(middlewareInstance.interceptServer)) {
                 const middlewareFn = class_helpers_1.ClassHelpers.asyncHandler(async (req, res, next) => {
                     if (req.originalUrl.startsWith(`${this.uriPathnameOrNothingIfRoot}/${constants_1.apiPrefix}/${this.contextName}/`)) {
                         await middlewareInstance.interceptServer({
@@ -1651,7 +1661,7 @@ class EndpointContext {
         app.use(methodOverride());
         app.use(cookieParser());
         if (this.session) {
-            lib_11.Helpers.info('[taon][express-server] session enabled for this context ' +
+            lib_12.Helpers.info('[taon][express-server] session enabled for this context ' +
                 this.contextName);
             const { cookieMaxAge } = this.session;
             const frontendHost = this.config.frontendHost;
@@ -1677,7 +1687,7 @@ class EndpointContext {
         else {
             // if(this.config?.serverLogs) {
             this.logHttp &&
-                lib_11.Helpers.info(`[taon][express-server] session not enabled for this context '${this.contextName}'`);
+                lib_12.Helpers.info(`[taon][express-server] session not enabled for this context '${this.contextName}'`);
             // }
             app.use(cors({
             // origin: "http://localhost:5555",
@@ -1734,7 +1744,7 @@ class EndpointContext {
             .map(middlewareClassFun => {
             const middlewareInstance = this.getInstanceBy(middlewareClassFun);
             if (middlewareInstance &&
-                lib_11._.isFunction(middlewareInstance.interceptServerMethod)) {
+                lib_12._.isFunction(middlewareInstance.interceptServerMethod)) {
                 const middlewareFn = class_helpers_1.ClassHelpers.asyncHandler(async (req, res, next) => {
                     await middlewareInstance.interceptServerMethod({
                         req,
@@ -1768,7 +1778,7 @@ class EndpointContext {
         //#endregion
         // console.log(`BACKEND: expressPath: "${expressPath}" `);
         //#endregion
-        if (lib_11.Helpers.isElectron) {
+        if (lib_12.Helpers.isElectron) {
             //#region @backend
             const ipcKeyName = taon_helpers_1.TaonHelpers.ipcKeyNameRequest(target, methodConfig, expressPath);
             electron_1.ipcMain.on(ipcKeyName, async (event, paramsFromBrowser) => {
@@ -1786,7 +1796,7 @@ class EndpointContext {
         if (!this.isRemoteHost) {
             //#region apply dummy websql express routers
             //#region @websql
-            if (lib_11.Helpers.isWebSQL) {
+            if (lib_12.Helpers.isWebSQL) {
                 if (!this.expressApp[httpMethodType.toLowerCase()]) {
                     this.expressApp[httpMethodType.toLowerCase()] = () => { };
                     // TODO add middlewares for WEBSQL and ELECTRON mode
@@ -1795,8 +1805,8 @@ class EndpointContext {
             //#endregion
             //#endregion
             //#region @backend
-            this.logHttp &&
-                console.log(`[${httpMethodType.toUpperCase()}] ${expressPath} `);
+            // this.logHttp &&
+            //   console.log(`[${httpMethodType.toUpperCase()}] ${expressPath} `);
             this.expressApp[httpMethodType.toLowerCase()](expressPath, ...middlewareHandlers, async (req, res) => {
                 // console.log(`[${type.toUpperCase()}] ${expressPath} `);
                 //#region process params
@@ -1806,13 +1816,13 @@ class EndpointContext {
                 let tQuery = req.query;
                 if (req.headers[symbols_1.Symbols.old.CIRCURAL_OBJECTS_MAP_BODY]) {
                     try {
-                        tBody = JSON.parse(JSON.stringify(tBody), JSON.parse(req.headers[symbols_1.Symbols.old.CIRCURAL_OBJECTS_MAP_BODY]));
+                        tBody = JSON.parse(JSON.stringify(tBody), JSON.parse(taon_helpers_1.TaonHelpers.firstStringOrElemFromArray(req.headers[symbols_1.Symbols.old.CIRCURAL_OBJECTS_MAP_BODY])));
                     }
                     catch (e) { }
                 }
                 if (req.headers[symbols_1.Symbols.old.CIRCURAL_OBJECTS_MAP_QUERY_PARAM]) {
                     try {
-                        tQuery = JSON.parse(JSON.stringify(tQuery), JSON.parse(req.headers[symbols_1.Symbols.old.CIRCURAL_OBJECTS_MAP_QUERY_PARAM]));
+                        tQuery = JSON.parse(JSON.stringify(tQuery), JSON.parse(taon_helpers_1.TaonHelpers.firstStringOrElemFromArray(req.headers[symbols_1.Symbols.old.CIRCURAL_OBJECTS_MAP_QUERY_PARAM])));
                     }
                     catch (e) { }
                 }
@@ -1820,7 +1830,7 @@ class EndpointContext {
                 // console.log('req.headers', req.headers)
                 if (req.headers[symbols_1.Symbols.old.MAPPING_CONFIG_HEADER_BODY_PARAMS]) {
                     try {
-                        const entity = JSON.parse(req.headers[symbols_1.Symbols.old.MAPPING_CONFIG_HEADER_BODY_PARAMS]);
+                        const entity = JSON.parse(taon_helpers_1.TaonHelpers.firstStringOrElemFromArray(req.headers[symbols_1.Symbols.old.MAPPING_CONFIG_HEADER_BODY_PARAMS]));
                         tBody = lib_3.Mapping.encode(tBody, entity);
                     }
                     catch (e) { }
@@ -1828,7 +1838,7 @@ class EndpointContext {
                 else {
                     Object.keys(tBody).forEach(paramName => {
                         try {
-                            const entityForParam = JSON.parse(req.headers[`${symbols_1.Symbols.old.MAPPING_CONFIG_HEADER_BODY_PARAMS}${paramName} `]);
+                            const entityForParam = JSON.parse(taon_helpers_1.TaonHelpers.firstStringOrElemFromArray(req.headers[`${symbols_1.Symbols.old.MAPPING_CONFIG_HEADER_BODY_PARAMS}${paramName} `]));
                             tBody[paramName] = lib_3.Mapping.encode(tBody[paramName], entityForParam);
                         }
                         catch (e) { }
@@ -1838,7 +1848,7 @@ class EndpointContext {
                 // console.log('req.headers', tQuery)
                 if (req.headers[symbols_1.Symbols.old.MAPPING_CONFIG_HEADER_QUERY_PARAMS]) {
                     try {
-                        const entity = JSON.parse(req.headers[symbols_1.Symbols.old.MAPPING_CONFIG_HEADER_QUERY_PARAMS]);
+                        const entity = JSON.parse(taon_helpers_1.TaonHelpers.firstStringOrElemFromArray(req.headers[symbols_1.Symbols.old.MAPPING_CONFIG_HEADER_QUERY_PARAMS]));
                         tQuery = taon_helpers_1.TaonHelpers.parseJSONwithStringJSONs(lib_3.Mapping.encode(tQuery, entity));
                     }
                     catch (e) { }
@@ -1846,9 +1856,9 @@ class EndpointContext {
                 else {
                     Object.keys(tQuery).forEach(queryParamName => {
                         try {
-                            const entityForParam = JSON.parse(req.headers[`${symbols_1.Symbols.old.MAPPING_CONFIG_HEADER_QUERY_PARAMS}${queryParamName} `]);
+                            const entityForParam = JSON.parse(taon_helpers_1.TaonHelpers.firstStringOrElemFromArray(req.headers[`${symbols_1.Symbols.old.MAPPING_CONFIG_HEADER_QUERY_PARAMS}${queryParamName} `]));
                             let beforeTransofrm = tQuery[queryParamName];
-                            if (lib_11._.isString(beforeTransofrm)) {
+                            if (lib_12._.isString(beforeTransofrm)) {
                                 try {
                                     const paresed = taon_helpers_1.TaonHelpers.tryTransformParam(beforeTransofrm);
                                     beforeTransofrm = paresed;
@@ -1896,6 +1906,16 @@ class EndpointContext {
                     .map(v => taon_helpers_1.TaonHelpers.tryTransformParam(v));
                 try {
                     let result = await getResult(resolvedParams, req, res);
+                    if (methodConfig.responseType)
+                        if (res.headersSent) {
+                            // SKIP FURTHER PROCESSING IF RESPONSE ALREADY SENT
+                            return;
+                        }
+                    if (methodConfig.overrideExpressSendAsHtml) {
+                        res.setHeader('Content-Type', 'text/html');
+                        res.send(result);
+                        return;
+                    }
                     if (result instanceof Blob &&
                         methodConfig.responseType ===
                             'blob') {
@@ -1910,7 +1930,7 @@ class EndpointContext {
                         res.end(file);
                         //#endregion
                     }
-                    else if (lib_11._.isString(result) &&
+                    else if (lib_12._.isString(result) &&
                         methodConfig.responseType ===
                             'blob') {
                         // console.log('BASE64')
@@ -1936,36 +1956,16 @@ class EndpointContext {
                     }
                 }
                 catch (error) {
-                    //#region process error
-                    if (lib_11._.isString(error)) {
-                        res.status(400).send(lib_1.JSON10.stringify({
-                            message: `
-    Error inside: ${req.path}
-
-    ${error}
-
-`,
-                        }));
-                    }
-                    else if (error instanceof models_1.Models.Http.Errors) {
-                        lib_11.Helpers.error(error, true, false);
-                        const err = error;
-                        res.status(400).send(lib_1.JSON10.stringify(err));
+                    if (res.headersSent) {
+                        // SKIP FURTHER PROCESSING IF RESPONSE ALREADY SENT
+                        return;
                     }
-                    else if (error instanceof Error) {
-                        const err = error;
-                        lib_11.Helpers.error(error, true, false);
-                        res.status(400).send(lib_1.JSON10.stringify({
-                            stack: err.stack,
-                            message: err.message,
-                        }));
+                    if (methodConfig.overrideExpressSendAsHtml) {
+                        res.setHeader('Content-Type', 'text/html');
+                        res.send(error);
+                        return;
                     }
-                    else {
-                        lib_11.Helpers.log(error);
-                        lib_11.Helpers.error(`[Taon] Bad result isomorphic method: ${error} `, true, false);
-                        res.status(400).send(lib_1.JSON10.stringify(error));
-                    }
-                    //#endregion
+                    this.sendError(res, error, req, expressPath);
                 }
             });
             //#endregion
@@ -1976,6 +1976,43 @@ class EndpointContext {
         };
     }
     //#endregion
+    //#region methods & getters / send error
+    sendError(res, error, req, expressPath) {
+        //#region @backendFunc
+        let status = 500;
+        let message = 'Internal Server Error';
+        let details = undefined;
+        let success = false;
+        let code = undefined;
+        if (typeof error === 'function') {
+            const obj = error(res) || {};
+            status = obj.status || 400;
+            message = obj.message;
+            details = obj.details;
+            code = obj.code;
+        }
+        else if (typeof error === 'string') {
+            message = error;
+            status = 400;
+        }
+        else if (error instanceof Error) {
+            message = error.message;
+            details = process.env.NODE_ENV !== 'production' ? error.stack : undefined;
+        }
+        else {
+            message = 'Unexpected error';
+            details = error;
+        }
+        res.status(status).json({
+            success,
+            message,
+            details,
+            code,
+            [lib_8.CoreModels.TaonHttpErrorCustomProp]: true,
+        });
+        //#endregion
+    }
+    //#endregion
     //#region methods & getters / init client
     /**
      * client can be browser or nodejs (when remote host)
@@ -1990,7 +2027,7 @@ class EndpointContext {
         const middlewares = methodConfig.calculatedMiddlewares;
         const middlewaresInstances = middlewares
             .map(f => this.getInstanceBy(f))
-            .filter(f => lib_11._.isFunction(f.interceptClientMethod));
+            .filter(f => lib_12._.isFunction(f.interceptClientMethod));
         middlewaresInstances.forEach(instance => {
             const middlewareName = class_helpers_1.ClassHelpers.getName(instance);
             // middlewareName - only needed for inheritace and uniqness of interceptors
@@ -2010,8 +2047,8 @@ class EndpointContext {
         });
         //#endregion
         // : { received: any; /* Rest<any, any>  */ }
-        this.logHttp &&
-            console.log(`${httpRequestType?.toUpperCase()} ${expressPath} `);
+        // this.logHttp &&
+        //   console.log(`${httpRequestType?.toUpperCase()} ${expressPath} `);
         // console.log('INITING', methodConfig); // TODO inject in static
         //#region resolve storage
         // TODO not a good idea
@@ -2019,7 +2056,7 @@ class EndpointContext {
         //#endregion
         const orgMethods = target.prototype[methodConfig.methodName];
         //#region handle electron ipc request
-        if (lib_11.Helpers.isElectron) {
+        if (lib_12.Helpers.isElectron) {
             const ipcRenderer = window.require('electron').ipcRenderer;
             target.prototype[methodConfig.methodName] = function (...args) {
                 const received = new Promise(async (resolve, reject) => {
@@ -2302,7 +2339,7 @@ class EndpointContext {
                         if (mapping) {
                             rest.headers.set(symbols_1.Symbols.old.MAPPING_CONFIG_HEADER_QUERY_PARAMS, JSON.stringify(mapping));
                         }
-                        queryParams = lib_11._.cloneDeep(param);
+                        queryParams = lib_12._.cloneDeep(param);
                     }
                 }
                 if (currentParam.paramType === 'Header') {