@futdevpro/nts-dynamo 1.5.94 → 1.5.96

package/lib/_services/dynamo-nts-app.server.d.ts

@@ -0,0 +1,275 @@
+/// <reference types="node" />
+import Mongoose = require("mongoose");
+import Express = require("express");
+import * as Https from 'https';
+import { DynamoNTS_SingletonService } from './dynamo-nts-singleton.service';
+import { DynamoNTS_RouteSecurity } from '../_enums/dynamo-nts-route-security.enum';
+import { DynamoNTS_RoutingModule } from './dynamo-nts-routing-module.service';
+import { DynamoNTS_PortSettings } from '../_models/interfaces/dynamo-nts-port-settings.interface';
+import { DynamoNTS_CertificationSettings } from '../_models/interfaces/dynamo-nts-certification-settings.interface';
+import { DynamoNTS_GlobalServiceSettings } from '../_models/interfaces/dynamo-nts-global-service-settings.interface';
+import { DynamoNTS_AppParams } from '../_models/control-models/dynamo-nts-app-params.model';
+/**
+ * This will be the MAIN service of our server project,
+ * follow the types and type instructions while setting up your project
+ *
+ * In this service, there are abstract functions that you will need to implement,
+ * where you need to set up the main params for your application.
+ *
+ * (after the example, you can find the list of services you can/should setup)
+ *
+ * @example
+ * export class App extends DynamoNTS_AppExtended {
+ *
+ *   ...
+ *
+ *   // Setting up App params, and preparing project global settings
+ *   setupAppParams(): void {
+ *     this.params = new DynamoNTS_AppParams({
+ *       name: 'Warbots Server',
+ *       title: warbotsTitleLog,
+ *       version: version,
+ *       dbName: 'warbots',
+ *     });
+ *
+ *     // dynamoNTS_GlobalSettings.logRequestsContent = false;
+ *   }
+ *
+ *   ...
+ *
+ *   // Setting up DBServices
+ *   setGlobalServiceCollection(): void {
+ *     DynamoNTS_GlobalService.setServices({
+ *       authService: AuthService.getInstance(),
+ *       emailServiceCollection: EmailServiceCollectionService.getInstance(),
+ *       dbModels: [
+ *         userModelParams,
+ *         userDataModelParams,
+ *         userOptionsModelParams,
+ *         userStatisticsModelParams,
+ *         userAchievementsModelParams,
+ *         userNotificationsModelParams,
+ *
+ *         matchStatisticsModelParams,
+ *         matchDataModelParams,
+
+ *         usageSessionModelParams,
+ *         customDataModelParams,
+ *       ]
+ *     });
+ *   }
+ *
+ *   ...
+ *
+ *   // Setting up Routes
+ *   setupRoutingModules(): void {
+ *     this.httpPort = env.port;
+
+ *     this.routingModules = [
+ *       new DynamoNTS_RoutingModule({
+ *         route: '/user',
+ *         controllers: [
+ *           UserController.getInstance(),
+ *           UserDataController.getInstance(),
+ *           UserOptionsController.getInstance(),
+ *           UserStatisticsController.getInstance(),
+ *           UserAchievementsController.getInstance(),
+ *           UserNotificationsController.getInstance()
+ *         ]
+ *       }),
+ *       new DynamoNTS_RoutingModule({
+ *         route: '/match',
+ *         controllers: [
+ *           MatchController.getInstance(),
+ *           MatchDistributionController.getInstance(),
+ *           MatchStatisticsController.getInstance(),
+ *         ]
+ *       }),
+ *       new DynamoNTS_RoutingModule({
+ *         route: '/server',
+ *         controllers: [
+ *           ServerController.getInstance(),
+ *         ]
+ *       }),
+
+ *       getTestRoutingModule(),
+ *       getUsageRoutingModule()
+ *     ];
+ *   }
+ * }
+ *
+ * //
+ * // The Services available
+ * //
+ * // Authentication Service
+ * // A commonly used basic service,
+ * // which is necessary fur certain functions (such as registering call issuers)
+ * //
+ * // This will handle Authentication Token checking/refreshing, checking issuer's identifier and routeParams,
+ * // handling JWT Token, or maybe with OAuth2 or other commonly used security procedures
+ * //
+ * // You can create one with this Dynamo Object:
+ * //
+ *
+ * @example
+ * // follow the instructions on the abstract class (DynamoNTS_AuthService)
+ * export class AuthService extends DynamoNTS_AuthService {}
+ *
+ *
+ *
+ * //
+ */
+export declare abstract class DynamoNTS_App extends DynamoNTS_SingletonService {
+    private _params;
+    protected get params(): DynamoNTS_AppParams;
+    protected mongoose: typeof Mongoose;
+    private _security;
+    protected get security(): DynamoNTS_RouteSecurity;
+    protected _ports: DynamoNTS_PortSettings;
+    protected get ports(): DynamoNTS_PortSettings;
+    private _cert?;
+    protected get cert(): DynamoNTS_CertificationSettings;
+    protected openExpress: Express.Application;
+    private secureExpress;
+    protected httpsServer: Https.Server;
+    private _routingModules;
+    private _rootServices;
+    /**
+     * setting this value to true, enables this service debug logs
+     */
+    protected debugLog: boolean;
+    constructor();
+    /**
+     *
+     */
+    private startDB;
+    /**
+     *
+     */
+    private initExpresses;
+    /**
+     *
+     */
+    protected initOpenExpress(): void;
+    /**
+     *
+     */
+    protected initSecureExpress(): void;
+    /**
+     *
+     */
+    private startExpresses;
+    /**
+     *
+     */
+    private mountSecureRoutes;
+    /**
+     *
+     */
+    private mountOpenRoutes;
+    /**
+     *
+     */
+    private setSecurity;
+    /**
+     * #OUTDATED
+     * Setting up App params, and preparing project global settings
+     * You must setup app params in this function like this:
+     *
+     * @example
+     * setupAppParams(): void {
+     *   this.params = new DynamoBEAppParams({
+     *     name: 'Sample Server',
+     *     title: 'A BIG nice header that will be logged on start',
+     *     version: version,
+     *     dbName: 'sampleapp',
+     *   });
+     *
+     *   DBE_Global_S.setGlobalSettings({
+     *     defaultRouteSecurity: DynamoBERouteSecurity.secure,
+     *     logSetup: true,
+     *   });
+     * }
+     */
+    abstract getAppParams(): DynamoNTS_AppParams;
+    /**
+     * MISSING Description (TODO)
+     */
+    abstract overrideDynamoNTSGlobalSettings?(): void;
+    /**
+     * #OUTDATED
+     * Setting up DBServices
+     * You must setup globalServiceCollection and dbServices in this function
+     *
+     * @example
+     * setGlobalServiceCollection(): void {
+     *   DBE_Global_S.setServices({
+     *     authService: AuthService.getInstance(),
+     *     emailServiceCollection: EmailServiceCollectionService.getInstance(),
+     *     dbModels: [
+     *       accountModelParams,
+     *       projectModelParams,
+     *       ...
+     *     ]
+     *   });
+     * }
+     */
+    abstract getGlobalServiceCollection(): DynamoNTS_GlobalServiceSettings;
+    /**
+     * MISSING Description (TODO)
+     */
+    abstract getPortSettings(): DynamoNTS_PortSettings;
+    /**
+     * #OUTDATED
+     * You must setup endpoints and required services in this function
+     *
+     * @example
+     * // Setting up Routes
+     * setupRoutingModules(): void {
+     *   this.httpPort = env.httpPort;
+     *   this.httpsPort = env.httpsPort;
+     *
+     *   this.cert = {
+     *     keyPath: Path.join(__dirname, './_assets/cert/ucc.key'),
+     *     certPath: Path.join(__dirname, './_assets/cert/ucc.crt'),
+     *   };
+     *
+     *   this.routingModules = [
+     *     new DynamoBERountingModule({
+     *       route: '/api/account',
+     *       controllers: [
+     *         AccountController.getInstance(),
+     *         PersonalInformationController.getInstance(),
+     *         ...
+     *       ]
+     *     }),
+     *     new DynamoBERountingModule({
+     *       route: '/api/project',
+     *       controllers: [
+     *         ProjectController.getInstance(),
+     *         ProjectExtensionController.getInstance(),
+     *       ]
+     *     }),
+     *     ...
+     *   ];
+     * }
+     */
+    abstract getRoutingModules(): DynamoNTS_RoutingModule[];
+    /**
+     * MISSING Description (TODO)
+     */
+    getRootServices?(): DynamoNTS_SingletonService[];
+    /**
+     * MISSING Description (TODO)
+     */
+    getCertificationSettings?(): DynamoNTS_CertificationSettings;
+    /**
+     * MISSING Description (TODO)
+     */
+    createEntries?(): void;
+    /**
+     * MISSING Description (TODO)
+     */
+    postProcess?(): void;
+}
+//# sourceMappingURL=dynamo-nts-app.server.d.ts.map

package/lib/_services/dynamo-nts-app.server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamo-nts-app.server.d.ts","sourceRoot":"","sources":["../../src/_services/dynamo-nts-app.server.ts"],"names":[],"mappings":";AACA,OAAO,QAAQ,GAAG,QAAQ,UAAU,CAAC,CAAC;AACtC,OAAO,OAAO,GAAG,QAAQ,SAAS,CAAC,CAAC;AACpC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAM/B,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AACnF,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAE9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,0DAA0D,CAAC;AAClG,OAAO,EAAE,+BAA+B,EAAE,MAAM,mEAAmE,CAAC;AACpH,OAAO,EAAE,+BAA+B,EAAE,MAAM,oEAAoE,CAAC;AAErH,OAAO,EAAE,mBAAmB,EAAE,MAAM,uDAAuD,CAAC;AAG5F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6GG;AACH,8BAAsB,aAAc,SAAQ,0BAA0B;IAEpE,OAAO,CAAC,OAAO,CAAsB;IACrC,SAAS,KAAK,MAAM,IAAI,mBAAmB,CAAyB;IAEpE,SAAS,CAAC,QAAQ,kBAAY;IAE9B,OAAO,CAAC,SAAS,CAA0B;IAC3C,SAAS,KAAK,QAAQ,IAAI,uBAAuB,CAA2B;IAE5E,SAAS,CAAC,MAAM,EAAE,sBAAsB,CAAC;IACzC,SAAS,KAAK,KAAK,IAAI,sBAAsB,CAAwB;IAErE,OAAO,CAAC,KAAK,CAAC,CAAkC;IAChD,SAAS,KAAK,IAAI,IAAI,+BAA+B,CAAuB;IAE5E,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,WAAW,CAAC;IAC3C,OAAO,CAAC,aAAa,CAAsB;IAC3C,SAAS,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC;IAEpC,OAAO,CAAC,eAAe,CAA4B;IAGnD,OAAO,CAAC,aAAa,CAA+B;IAEpD;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC;;IAiE5B;;OAEG;IACH,OAAO,CAAC,OAAO;IAkBf;;OAEG;IACH,OAAO,CAAC,aAAa;IAsErB;;OAEG;IACH,SAAS,CAAC,eAAe,IAAI,IAAI;IAMjC;;OAEG;IACF,SAAS,CAAC,iBAAiB,IAAI,IAAI;IAYpC;;OAEG;YACW,cAAc;IAgC5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAwBzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAwBvB;;OAEG;IACH,OAAO,CAAC,WAAW;IAUnB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,CAAC,YAAY,IAAI,mBAAmB;IAE5C;;OAEG;IACH,QAAQ,CAAC,+BAA+B,CAAC,IAAI,IAAI;IAEjD;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,0BAA0B,IAAI,+BAA+B;IAEtE;;OAEG;IACH,QAAQ,CAAC,eAAe,IAAI,sBAAsB;IAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACH,QAAQ,CAAC,iBAAiB,IAAI,uBAAuB,EAAE;IAEvD;;OAEG;IACH,eAAe,CAAC,IAAI,0BAA0B,EAAE;IAEhD;;OAEG;IACH,wBAAwB,CAAC,IAAI,+BAA+B;IAE5D;;OAEG;IACH,aAAa,CAAC,IAAI,IAAI;IAEtB;;OAEG;IACH,WAAW,CAAC,IAAI,IAAI;CACrB"}

package/lib/_services/dynamo-nts-app.server.js

@@ -0,0 +1,372 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DynamoNTS_App = void 0;
+const tslib_1 = require("tslib");
+const Mongoose = require("mongoose");
+const Express = require("express");
+const Https = tslib_1.__importStar(require("https"));
+const FileSystem = tslib_1.__importStar(require("fs"));
+const BodyParser = tslib_1.__importStar(require("body-parser"));
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const dynamo_nts_singleton_service_1 = require("./dynamo-nts-singleton.service");
+const dynamo_nts_route_security_enum_1 = require("../_enums/dynamo-nts-route-security.enum");
+const dynamo_nts_global_service_1 = require("./dynamo-nts-global.service");
+const dynamo_nts_global_settings_const_1 = require("../_constants/dynamo-nts-global-settings.const");
+/**
+ * This will be the MAIN service of our server project,
+ * follow the types and type instructions while setting up your project
+ *
+ * In this service, there are abstract functions that you will need to implement,
+ * where you need to set up the main params for your application.
+ *
+ * (after the example, you can find the list of services you can/should setup)
+ *
+ * @example
+ * export class App extends DynamoNTS_AppExtended {
+ *
+ *   ...
+ *
+ *   // Setting up App params, and preparing project global settings
+ *   setupAppParams(): void {
+ *     this.params = new DynamoNTS_AppParams({
+ *       name: 'Warbots Server',
+ *       title: warbotsTitleLog,
+ *       version: version,
+ *       dbName: 'warbots',
+ *     });
+ *
+ *     // dynamoNTS_GlobalSettings.logRequestsContent = false;
+ *   }
+ *
+ *   ...
+ *
+ *   // Setting up DBServices
+ *   setGlobalServiceCollection(): void {
+ *     DynamoNTS_GlobalService.setServices({
+ *       authService: AuthService.getInstance(),
+ *       emailServiceCollection: EmailServiceCollectionService.getInstance(),
+ *       dbModels: [
+ *         userModelParams,
+ *         userDataModelParams,
+ *         userOptionsModelParams,
+ *         userStatisticsModelParams,
+ *         userAchievementsModelParams,
+ *         userNotificationsModelParams,
+ *
+ *         matchStatisticsModelParams,
+ *         matchDataModelParams,
+
+ *         usageSessionModelParams,
+ *         customDataModelParams,
+ *       ]
+ *     });
+ *   }
+ *
+ *   ...
+ *
+ *   // Setting up Routes
+ *   setupRoutingModules(): void {
+ *     this.httpPort = env.port;
+
+ *     this.routingModules = [
+ *       new DynamoNTS_RoutingModule({
+ *         route: '/user',
+ *         controllers: [
+ *           UserController.getInstance(),
+ *           UserDataController.getInstance(),
+ *           UserOptionsController.getInstance(),
+ *           UserStatisticsController.getInstance(),
+ *           UserAchievementsController.getInstance(),
+ *           UserNotificationsController.getInstance()
+ *         ]
+ *       }),
+ *       new DynamoNTS_RoutingModule({
+ *         route: '/match',
+ *         controllers: [
+ *           MatchController.getInstance(),
+ *           MatchDistributionController.getInstance(),
+ *           MatchStatisticsController.getInstance(),
+ *         ]
+ *       }),
+ *       new DynamoNTS_RoutingModule({
+ *         route: '/server',
+ *         controllers: [
+ *           ServerController.getInstance(),
+ *         ]
+ *       }),
+
+ *       getTestRoutingModule(),
+ *       getUsageRoutingModule()
+ *     ];
+ *   }
+ * }
+ *
+ * //
+ * // The Services available
+ * //
+ * // Authentication Service
+ * // A commonly used basic service,
+ * // which is necessary fur certain functions (such as registering call issuers)
+ * //
+ * // This will handle Authentication Token checking/refreshing, checking issuer's identifier and routeParams,
+ * // handling JWT Token, or maybe with OAuth2 or other commonly used security procedures
+ * //
+ * // You can create one with this Dynamo Object:
+ * //
+ *
+ * @example
+ * // follow the instructions on the abstract class (DynamoNTS_AuthService)
+ * export class AuthService extends DynamoNTS_AuthService {}
+ *
+ *
+ *
+ * //
+ */
+class DynamoNTS_App extends dynamo_nts_singleton_service_1.DynamoNTS_SingletonService {
+    get params() { return this._params; }
+    get security() { return this._security; }
+    get ports() { return this._ports; }
+    get cert() { return this._cert; }
+    constructor() {
+        var _a, _b;
+        super();
+        this.mongoose = Mongoose;
+        try {
+            this._params = this.getAppParams();
+            if (this.overrideDynamoNTSGlobalSettings) {
+                this.overrideDynamoNTSGlobalSettings();
+            }
+            dynamo_nts_global_service_1.DynamoNTS_GlobalService.setServices(this.getGlobalServiceCollection());
+            dynamo_nts_global_service_1.DynamoNTS_GlobalService.setParams(this.params);
+            this._ports = this.getPortSettings();
+            if (this.getCertificationSettings) {
+                this._cert = this.getCertificationSettings();
+            }
+            this._routingModules = this.getRoutingModules();
+            if (this.createEntries) {
+                this.createEntries();
+            }
+            console.log(`\n\n\nStarting ${this._params.name}... `);
+            if (this._params.title) {
+                console.log(this._params.title);
+            }
+            console.log(`\nVersion: ${this._params.version}`);
+            this.startDB();
+            this.getGlobalServiceCollection();
+            this.debugLog = dynamo_nts_global_settings_const_1.dynamoNTS_GlobalSettings.logSetup;
+            this.getRoutingModules();
+            this.setSecurity();
+            if ((_a = this._routingModules) === null || _a === void 0 ? void 0 : _a.length) {
+                this.initExpresses();
+                this.startExpresses();
+                if (this._security !== dynamo_nts_route_security_enum_1.DynamoNTS_RouteSecurity.secure) {
+                    this.mountOpenRoutes();
+                }
+                if (this._security !== dynamo_nts_route_security_enum_1.DynamoNTS_RouteSecurity.open && this._cert) {
+                    this.mountSecureRoutes();
+                }
+                if (this.debugLog) {
+                    console.log(`\nRoutes mounted.... server using security: ${this._security}`);
+                }
+            }
+            this._rootServices = (_b = this.getRootServices()) !== null && _b !== void 0 ? _b : [];
+            if (this.postProcess) {
+                this.postProcess();
+            }
+        }
+        catch (error) {
+            fsm_dynamo_1.Dynamo_Log.error('\nApplication start failed.\n', error);
+        }
+    }
+    /**
+     *
+     */
+    startDB() {
+        this.mongoose.connection
+            .on('error', (error) => {
+            fsm_dynamo_1.Dynamo_Log.error('\nUnable to connect to MongoDB server, ERROR: ', error);
+        })
+            .once('open', () => {
+            fsm_dynamo_1.Dynamo_Log.success('\nConnected to MongoDB\n');
+        });
+        this.mongoose.connect(this._params.dbUri, {
+            useNewUrlParser: true,
+            useUnifiedTopology: true
+        });
+    }
+    /**
+     *
+     */
+    initExpresses() {
+        if (this._security !== dynamo_nts_route_security_enum_1.DynamoNTS_RouteSecurity.secure) {
+            if (!this._ports.httpPort) {
+                let errorMsg = `\nYou have open routes, but httpPort is not set!` +
+                    `\nsecurity: ${this._security}` +
+                    `\nset httpPort in DynamoBEServer - setupRoutingModules() to enable secure routes.`;
+                errorMsg += '\n\nThe routes setted to use open server:';
+                this._routingModules.forEach((module) => {
+                    if (module.security != dynamo_nts_route_security_enum_1.DynamoNTS_RouteSecurity.secure) {
+                        errorMsg += `\n  ${module.route} (security: ${module.security}) \n  subroutes using open sever:`;
+                        module.endpoints.forEach((endpoint) => {
+                            if (endpoint.security != dynamo_nts_route_security_enum_1.DynamoNTS_RouteSecurity.secure) {
+                                errorMsg += `\n    ${endpoint.endpoint} (security: ${endpoint.security})`;
+                            }
+                        });
+                    }
+                });
+                fsm_dynamo_1.Dynamo_Log.error(errorMsg);
+                let error = new Error('Open routes cannot be established!');
+                let errorStack = error.stack.split('\n');
+                errorStack.splice(1, 2);
+                error.stack = errorStack.join('\n');
+                throw error;
+            }
+            this.initOpenExpress();
+        }
+        if (this._security !== dynamo_nts_route_security_enum_1.DynamoNTS_RouteSecurity.open) {
+            if (!this._cert || !this._ports.httpsPort) {
+                let errorMsg = `\nYou have secure routes, but the certification paths or httpsPort are not set!` +
+                    `\nsecurity: ${this._security}` +
+                    `\nset...` +
+                    `\n  httpsPort and` +
+                    `\n  cert: {` +
+                    `\n    keyPath: FileSystem.PathLike,` +
+                    `\n    certPath: FileSystem.PathLike,` +
+                    `\n  }` +
+                    `\nin DynamoBEServer - setupRoutingModules() to enable secure routes.`;
+                errorMsg += '\n\nThe routes setted to use secure server:';
+                this._routingModules.forEach((module) => {
+                    if (module.security != dynamo_nts_route_security_enum_1.DynamoNTS_RouteSecurity.open) {
+                        errorMsg += `\n  ${module.route} (security: ${module.security}) \n  subroutes using secure sever:`;
+                        module.endpoints.forEach((endpoint) => {
+                            if (endpoint.security != dynamo_nts_route_security_enum_1.DynamoNTS_RouteSecurity.open) {
+                                errorMsg += `\n    ${endpoint.endpoint} (security: ${endpoint.security})`;
+                            }
+                        });
+                    }
+                });
+                fsm_dynamo_1.Dynamo_Log.error(errorMsg);
+                let error = new Error('Secure routes cannot be established!');
+                let errorStack = error.stack.split('\n');
+                errorStack.splice(1, 2);
+                error.stack = errorStack.join('\n');
+                throw error;
+            }
+            this.initSecureExpress();
+        }
+    }
+    /**
+     *
+     */
+    initOpenExpress() {
+        this.openExpress = Express();
+        this.openExpress.use(BodyParser.urlencoded({ limit: '50mb', extended: true }));
+        this.openExpress.use(BodyParser.json({ limit: '50mb' }));
+    }
+    /**
+     *
+     */
+    initSecureExpress() {
+        this.secureExpress = Express();
+        this.secureExpress.use(BodyParser.urlencoded({ limit: '50mb', extended: true }));
+        this.secureExpress.use(BodyParser.json({ limit: '50mb' }));
+        const options = {
+            key: FileSystem.readFileSync(this._cert.keyPath),
+            cert: FileSystem.readFileSync(this._cert.certPath),
+        };
+        this.httpsServer = Https.createServer(options, this.secureExpress);
+    }
+    /**
+     *
+     */
+    startExpresses() {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            try {
+                if (this._security !== dynamo_nts_route_security_enum_1.DynamoNTS_RouteSecurity.open) {
+                    this.httpsServer
+                        .listen(this._ports.httpsPort, 'localhost', 0, () => {
+                        fsm_dynamo_1.Dynamo_Log.success(`\nHTTPS (secure) server is listening on port ${this._ports.httpsPort}\n`);
+                    })
+                        .on('error', (error) => {
+                        fsm_dynamo_1.Dynamo_Log.error(`\nHTTPS (secure) server ERROR`, error);
+                    })
+                        .on('uncaughtException', (ex) => {
+                        fsm_dynamo_1.Dynamo_Log.warn(`\nHTTPS (secure) server uncaughtException`, ex);
+                    });
+                }
+                if (this._security !== dynamo_nts_route_security_enum_1.DynamoNTS_RouteSecurity.secure) {
+                    this.openExpress
+                        .listen(this._ports.httpPort, () => {
+                        fsm_dynamo_1.Dynamo_Log.success(`\nHTTP  (-open-) server is listening on port ${this._ports.httpPort}\n`);
+                    })
+                        .on('error', (error) => {
+                        fsm_dynamo_1.Dynamo_Log.error(`\nHTTP  (-open-) server ERROR`, error);
+                    })
+                        .on('uncaughtException', (ex) => {
+                        fsm_dynamo_1.Dynamo_Log.warn(`\nHTTP  (-open-) server uncaughtException`, ex);
+                    });
+                }
+            }
+            catch (error) {
+                fsm_dynamo_1.Dynamo_Log.error(`startExpresses failed...`, error);
+            }
+        });
+    }
+    /**
+     *
+     */
+    mountSecureRoutes() {
+        this._routingModules.forEach((module) => {
+            if (module.security !== dynamo_nts_route_security_enum_1.DynamoNTS_RouteSecurity.open) {
+                if (this.debugLog) {
+                    console.log(`route mount (secure): ${module.route}`);
+                }
+                const existingRoutes = this._routingModules.filter((mod) => mod.route === module.route);
+                if (1 < existingRoutes.length) {
+                    let error = new Error(`ROUTE DUPLICATION: ${module.route}`);
+                    let errorStack = error.stack.split('\n');
+                    errorStack.splice(1, 4);
+                    error.stack = errorStack.join('\n');
+                    throw error;
+                }
+                this.secureExpress.use(module.route, module.secureRouter);
+            }
+        });
+    }
+    /**
+     *
+     */
+    mountOpenRoutes() {
+        this._routingModules.forEach((module) => {
+            if (module.security !== dynamo_nts_route_security_enum_1.DynamoNTS_RouteSecurity.secure) {
+                if (this.debugLog) {
+                    console.log(`route mount (open): ${module.route}`);
+                }
+                const existingRoutes = this._routingModules.filter((mod) => mod.route === module.route);
+                if (1 < existingRoutes.length) {
+                    let error = new Error(`ROUTE DUPLICATION: ${module.route}`);
+                    let errorStack = error.stack.split('\n');
+                    errorStack.splice(1, 4);
+                    error.stack = errorStack.join('\n');
+                    throw error;
+                }
+                this.openExpress.use(module.route, module.openRouter);
+            }
+        });
+    }
+    /**
+     *
+     */
+    setSecurity() {
+        this._routingModules.forEach((module) => {
+            if (!this._security) {
+                this._security = module.security;
+            }
+            else if (this._security !== module.security) {
+                this._security = dynamo_nts_route_security_enum_1.DynamoNTS_RouteSecurity.both;
+            }
+        });
+    }
+}
+exports.DynamoNTS_App = DynamoNTS_App;
+//# sourceMappingURL=dynamo-nts-app.server.js.map

package/lib/_services/dynamo-nts-app.server.js.map

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

package/lib/_services/dynamo-nts-app.server.spec.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=dynamo-nts-app.server.spec.d.ts.map

package/lib/_services/dynamo-nts-app.server.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamo-nts-app.server.spec.d.ts","sourceRoot":"","sources":["../../src/_services/dynamo-nts-app.server.spec.ts"],"names":[],"mappings":""}

package/lib/_services/dynamo-nts-app.server.spec.js

@@ -0,0 +1,10 @@
+describe('DynamoNTS_App', () => {
+    it('should create an instance', () => {
+        expect(true).toBeTruthy();
+    });
+    /* it('should ') */
+    xit('should create an instance NOT', () => {
+        expect(false).toBeTruthy();
+    });
+});
+//# sourceMappingURL=dynamo-nts-app.server.spec.js.map