@futdevpro/nts-dynamo 1.10.49 → 1.10.51

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,cAAc;AACd,sEAA4C;AAC5C,+EAAqD;AAGrD,QAAQ;AACR,wEAA8C;AAC9C,8EAAoD;AACpD,8EAAoD;AACpD,uEAA6C;AAG7C,6CAA6C;AAC7C,oBAAoB;AACpB,gGAAsE;AACtE,iGAAuE;AACvE,yFAA+D;AAC/D,iGAAuE;AAEvE,wBAAwB;AACxB,iGAAuE;AACvE,yGAA8E;AAC9E,4FAAkE;AAClE,qGAA2E;AAC3E,iGAAuE;AACvE,+FAAqE;AACrE,gGAAsE;AAEtE,eAAe;AACf,yEAA+C;AAG/C,WAAW;AACX,gBAAgB;AAChB,uEAA6C;AAC7C,wEAA8C;AAC9C,yEAA+C;AAC/C,0EAAgD;AAChD,sFAA4D;AAE5D,gBAAgB;AAChB,gFAAsD;AACtD,wEAA8C;AAC9C,sEAA4C;AAC5C,6EAAmD;AAEnD,kBAAkB;AAClB,wEAA8C;AAC9C,qEAA2C;AAE3C,iBAAiB;AACjB,+EAAqD;AACrD,mFAAyD;AAEzD,kBAAkB;AAClB,4EAAkD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,cAAc;AACd;;;;;;;;GAQG;AACH,sEAA4C;AAE5C;;;;;;;GAOG;AACH,+EAAqD;AAGrD,QAAQ;AACR;;GAEG;AACH,wEAA8C;AAE9C;;GAEG;AACH,8EAAoD;AAEpD;;GAEG;AACH,8EAAoD;AAEpD;;GAEG;AACH,uEAA6C;AAG7C,6CAA6C;AAE7C,mEAAmE;AACnE,gGAAsE;AACtE,iGAAuE;AACvE,yFAA+D;AAC/D,iGAAuE;AAEvE,wBAAwB;AAExB,wEAAwE;AACxE,iGAAuE;AACvE,yGAA8E;AAC9E,4FAAkE;AAClE,qGAA2E;AAC3E,iGAAuE;AACvE,+FAAqE;AACrE,gGAAsE;AAEtE,eAAe;AAEf,qDAAqD;AACrD,yEAA+C;AAG/C,WAAW;AACX,gBAAgB;AAChB,mDAAmD;AACnD,uEAA6C;AAE7C,6CAA6C;AAC7C,wEAA8C;AAE9C,gDAAgD;AAChD,yEAA+C;AAE/C,2DAA2D;AAC3D,0EAAgD;AAEhD,mCAAmC;AACnC,sFAA4D;AAE5D,gBAAgB;AAChB,kDAAkD;AAClD,gFAAsD;AAEtD,kDAAkD;AAClD,wEAA8C;AAE9C,+CAA+C;AAC/C,sEAA4C;AAE5C,sDAAsD;AACtD,6EAAmD;AAEnD,kBAAkB;AAClB,8BAA8B;AAC9B,wEAA8C;AAE9C,qCAAqC;AACrC,qEAA2C;AAE3C,iBAAiB;AACjB,oDAAoD;AACpD,+EAAqD;AAErD,+CAA+C;AAC/C,mFAAyD;AAEzD,kBAAkB;AAClB,qDAAqD;AACrD,4EAAkD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/nts-dynamo",
-  "version": "01.10.49",
+  "version": "01.10.51",
   "description": "Dynamic NodeTS (NodeJS-Typescript), MongoDB Backend System Framework by Future Development Program Ltd.",
   "DyBu_settings": {
     "packageType": "server-package",
@@ -136,12 +136,12 @@
   },
   "homepage": "https:/futdevpro.hu/projects/dynamo",
   "DISABLED": {
-    "@futdevpro/fsm-dynamo": "file:../tgz-collection/dynamo-fsm/futdevpro-fsm-dynamo-01.10.38.tgz",
+    "@futdevpro/fsm-dynamo": "file:../tgz-collection/dynamo-fsm/futdevpro-fsm-dynamo-01.10.39.tgz",
     
     "empty": ""
   },
   "peerDependencies": {
-    "@futdevpro/fsm-dynamo": "1.10.38",
+    "@futdevpro/fsm-dynamo": "1.10.39",
 
     "@types/express": "4.17.21",
     "@types/geoip-lite": "~1.4.1",

package/src/_collections/archive.util.ts

@@ -1,8 +1,17 @@
 
 
-
+/** Suffix appended to database names when archived. */
 export const DyNTS_archiveSuffix = 'archived';
 
+/**
+ * Create the archive database name for a given base database.
+ *
+ * @example
+ * ```ts
+ * const name = DyNTS_getArchivedDBName('users');
+ * // => 'users_archived'
+ * ```
+ */
 export function DyNTS_getArchivedDBName(dbName: string): string {
   return `${dbName}_${DyNTS_archiveSuffix}`;
 }

package/src/_collections/global-settings.const.ts

@@ -5,6 +5,10 @@ import { DyNTS_RouteSecurity } from '../_enums/route-security.enum';
 import { DyNTS_Global_Settings } from '../_models/interfaces/global-settings.interface';
 import { DyNTS_SocketSecurity } from '../_modules/socket/_enums/socket-security.enum';
 
+/**
+ * Default configuration used across the NodeTS framework.
+ * These values can be overridden when bootstrapping the server.
+ */
 export const DyNTS_global_settings: DyNTS_Global_Settings = {
   baseUrl: '/api',
   systemVersion: 'unknown-version',

package/src/_enums/data-model-type.enum.ts

@@ -1,10 +1,10 @@
 
 /**
- * DataModelType is declaring where the data type is used
- * 
- * dataModel: used in DB
- * controlModel: used only in runtime
- * interfaceModel: used only in runtime and doesnt need constructor
+ * Declares where a given model definition is used.
+ *
+ * - `dataModel`: persisted in the database
+ * - `controlModel`: runtime only
+ * - `interfaceModel`: runtime without constructor
  */
 /** @deprecated */
 export enum DyNTS_DataModelType {

package/src/_enums/data-service-function.enum.ts

@@ -1,15 +1,24 @@
 
 /**
- * DataServiceFunctions
- * 
- * #unconnected TODO
+ * Commonly used operations within data services.
+ *
+ * Each value represents a standard CRUD style method
+ * that can be implemented by a service.
  */
 export enum DyNTS_DSF {
+  /** Retrieve all documents from the store. */
   getAll = 'getAll',
+
+  /** Load a single document by its identifier. */
   getDataById = 'getDataById',
   /* checkIfDataExists = 'checkIfDataExists',
   createData = 'createNewData', */
+  /** Update an existing document. */
   modifyData = 'modifyData',
+
+  /** Remove a document. */
   deleteData = 'deleteData',
+
+  /** Return data supplied directly rather than fetched. */
   getProvidedData = 'getProvidedData',
 }

package/src/_enums/predefined-data-types.enum.ts

@@ -1,9 +1,10 @@
 
 /**
- * the most basic data types
+ * A small set of primitive data type names used when
+ * describing field types in various models.
  */
 export enum DyanmoNTS_PredefinedDataTypes {
-  'string', 
+  'string',
   'number',
   'boolean',
   'Date',
@@ -11,18 +12,6 @@ export enum DyanmoNTS_PredefinedDataTypes {
 }
 
 /**
- * 'null' | 'boolean' | 'number' | 'string' | 'array' | 'object' | 
- * 'date' | 'objectId' | 'mixed' | 'decimal128' | 'buffer' | 'map' | 
- * 'documentArray' | 'embedded' | 'array' | 'objectId' | 'string' | 
- * 'number' | 'boolean' | 'date' | 'buffer' | 'mixed' | 'decimal128' | 
- * 'map' | 'documentArray' | 'embedded' | 'array' | 'objectId' | 
- * 'string' | 'number' | 'boolean' | 'date' | 'buffer' | 'mixed' | 
- * 'decimal128' | 'map' | 'documentArray' | 'embedded' | 'array' | 
- * 'objectId' | 'string' | 'number' | 'boolean' | 'date' | 'buffer' | 
- * 'mixed' | 'decimal128' | 'map' | 'documentArray' | 'embedded' | 
- * 'array' | 'objectId' | 'string' | 'number' | 'boolean' | 'date' | 
- * 'buffer' | 'mixed' | 'decimal128' | 'map' | 'documentArray' | 
- * 'embedded' | 'array' | 'objectId' | 'string' | 'number' | 'boolean' | 
- * 'date' | 'buffer' | 'mixed' | 'decimal128' | 'map' | 'documentArray' | 
- * 'embedded'
+ * Full list of complex types supported by the framework
+ * when interacting with the database.
  */

package/src/_models/control-models/app-params.control-model.spec.ts

@@ -8,7 +8,7 @@ describe('| DyNTS_App_Params', () => {
       title: 'Test Application',
       version: '1.0.0',
       dbName: 'testdb',
-      dbUri: 'mongodb://localhost:27017/testdb',
+      dbUri: 'mongodb://0.0.0.0:27017/testdb',
       systemName: 'Test-App',
       systemShortCodeName: 'TA'
     };
@@ -19,7 +19,7 @@ describe('| DyNTS_App_Params', () => {
     expect(appParams.title).toBe('Test Application');
     expect(appParams.version).toBe('1.0.0');
     expect(appParams.dbName).toBe('testdb');
-    expect(appParams.dbUri).toBe('mongodb://localhost:27017/testdb');
+    expect(appParams.dbUri).toBe('mongodb://0.0.0.0:27017/testdb');
     expect(appParams.systemName).toBe('Test-App');
     expect(appParams.systemShortCodeName).toBe('TA');
   });
@@ -37,7 +37,7 @@ describe('| DyNTS_App_Params', () => {
     expect(appParams.title).toBe('');
     expect(appParams.version).toBe('1.0.0');
     expect(appParams.dbName).toBe('testdb');
-    expect(appParams.dbUri).toBe('mongodb://localhost:27017/testdb');
+    expect(appParams.dbUri).toBe('mongodb://0.0.0.0:27017/testdb');
     expect(appParams.systemName).toBe('TestApp');
     expect(appParams.systemShortCodeName).toBe('TA');
   });

package/src/_models/control-models/app-params.control-model.ts

@@ -33,9 +33,7 @@ export class DyNTS_App_Params {
   /**
    * options for the MongoDB connection
    */
-  readonly dbOptions?: ConnectOptions = {
-    directConnection: true,
-  }
+  readonly dbOptions?: ConnectOptions;
 
   readonly openHost?: string;
   readonly secureHost?: string;
@@ -56,12 +54,17 @@ export class DyNTS_App_Params {
     this.name = set.name;
     this.title = set.title ?? '';
     this.version = set.version;
-    this.dbName = set.dbName;
-    this.dbUri = set.dbUri ?? `mongodb://localhost:27017/${this.dbName}`;
+    if (set.dbName || set.dbUri || set.dbOptions) {
+      this.dbName = set.dbName;
+      this.dbUri = set.dbUri ?? `mongodb://0.0.0.0:27017/${this.dbName}`;
+      this.dbOptions = set.dbOptions ?? {
+        directConnection: true,
+      };
+    }
     this.systemName = set.systemName ?? this.name.replace(' ', '-');
     this.systemShortCodeName = set.systemShortCodeName ?? this.systemName.replace(/[^A-Z]/g, '');
-    this.openHost = set.openHost ?? 'localhost';
-    this.secureHost = set.secureHost ?? 'localhost';
+    this.openHost = set.openHost ?? '0.0.0.0';
+    this.secureHost = set.secureHost ?? '0.0.0.0';
     this.expressBacklog = set.expressBacklog ?? 0;
 
     if (!this.dbName) {
@@ -80,20 +83,12 @@ export class DyNTS_App_Params {
       );
     }
 
-    if (this.dbName?.includes('-')) {
+    /* if (this.dbName?.includes('-')) {
       DyFM_Log.warn(
         'DyNTS_App_Params.constructor: ' +
         `dbName should not contain "-" in "${this.dbName}" model.` +
         'For future compatibility.'
       );
-    }
+    } */
   }
 }
-
-/* export function DyNTS_App_Params_Settings(
-  set: DyNTS_App_Params
-) {
-  return function (target: Function) {
-    target.prototype._params = set;
-  }
-} */

package/src/_modules/mock/app-extended-server.mock.ts

@@ -34,6 +34,7 @@ export class DyNTS_AppExtendedBase_Mock extends DyNTS_AppExtended {
       name: 'test-extended-base',
       version: '1.0.1',
       dbName: 'test-base',
+      systemShortCodeName: 'MEB',
     });
   }
 
@@ -70,6 +71,7 @@ export class DyNTS_AppExtendedFull_Mock extends DyNTS_AppExtended {
       name: 'test-extended-full',
       version: 'x.0.101',
       dbName: 'test-full',
+      systemShortCodeName: 'MEF',
     });
   }
     
@@ -140,6 +142,7 @@ export class DyNTS_AppWbMock_Mock extends DyNTS_AppExtended {
       name: 'test-wb-mock',
       version: 'x.0.101',
       dbName: 'test-full',
+      systemShortCodeName: 'MWB',
     });
   }
     

package/src/_modules/mock/app-server.mock.ts

@@ -27,6 +27,7 @@ export class DyNTS_AppBase_Mock extends DyNTS_App {
       name: 'test-base',
       version: 'x1.0.1',
       dbName: 'test-base',
+      systemShortCodeName: 'ABM',
     });
   }
 
@@ -58,6 +59,7 @@ export class DyNTS_AppFull_Mock extends DyNTS_App {
       name: 'test-full',
       version: 'xx.0.101',
       dbName: 'test-full',
+      systemShortCodeName: 'AFM',
     });
   }
   
@@ -149,6 +151,7 @@ export class DyNTS_AppTEST_Mock extends DyNTS_App {
       name: 'test-partial',
       version: 'p.0.1',
       dbName: 'test-partial',
+      systemShortCodeName: 'APM',
     });
   }
   

package/src/_modules/socket/app-extended.server.spec.ts

@@ -1,14 +1,22 @@
-import { DyFM_delay, DyFM_Error, DyFM_Log } from '@futdevpro/fsm-dynamo';
+import { DyFM_delay, DyFM_Error, DyFM_Log, DyFM_waitUntil, second } from '@futdevpro/fsm-dynamo';
 import {
   DyNTS_AppExtendedBase_Mock, DyNTS_AppExtendedFull_Mock, DyNTS_AppWbMock_Mock
 } from '../mock/app-extended-server.mock';
+import { DyNTS_AppExtended } from './app-extended.server';
 
 describe('| DyNTS_AppExtended;', (): void => {
-  describe('| a extended-base instance;', (): void => {
-    let app: DyNTS_AppExtendedBase_Mock;
+  jasmine.DEFAULT_TIMEOUT_INTERVAL = 30 * second;
+  process.setMaxListeners(20);
+  let app: DyNTS_AppExtended;
 
+  describe('| a extended-base instance;', (): void => {
     beforeEach(async (): Promise<void> => {
       try {
+        await DyFM_waitUntil(
+          (): boolean => !app,
+          second
+        );
+
         app = new DyNTS_AppExtendedBase_Mock();
 
         await DyFM_delay(100);
@@ -17,7 +25,19 @@ describe('| DyNTS_AppExtended;', (): void => {
 
         await DyFM_delay(100);
       } catch (error) {
-        DyFM_Log.test('test beforeEach error:', (error as DyFM_Error)?._message);
+        DyFM_Log.testError(
+          '| DyNTS_AppExtended; | a extended-base instance; test beforeEach error:\n', 
+          (error as DyFM_Error)?._message,
+          '\nadditionalContent:',
+          (error as DyFM_Error)?.additionalContent?.errors?.reverse()?.map(
+            (error: DyFM_Error | Error) => (error as DyFM_Error)._messages?.join('\n') ?? 
+              (error as DyFM_Error)._message ?? 
+              (error as Error).message
+          ) ?? (error as DyFM_Error)?.additionalContent,
+          '\n\n    Stack:', 
+          (new Error()).stack,
+          (error as DyFM_Error)?.additionalContent?.errors?.reverse()?.unshift()?.stack
+        );
       }
     });
 
@@ -29,7 +49,19 @@ describe('| DyNTS_AppExtended;', (): void => {
 
         app = null;
       } catch (error) {
-        DyFM_Log.test('test afterEach error:', (error as DyFM_Error)?._message);
+        DyFM_Log.testError(
+          '| DyNTS_AppExtended; | a extended-base instance; test afterEach error:\n', 
+          (error as DyFM_Error)?._message,
+          '\nadditionalContent:',
+          (error as DyFM_Error)?.additionalContent?.errors?.reverse()?.map(
+            (error: DyFM_Error | Error) => (error as DyFM_Error)._messages?.join('\n') ?? 
+              (error as DyFM_Error)._message ?? 
+              (error as Error).message
+          ) ?? (error as DyFM_Error)?.additionalContent,
+          '\n\n    Stack:', 
+          (new Error()).stack,
+          (error as DyFM_Error)?.additionalContent?.errors?.reverse()?.unshift()?.stack
+        );
       }
     });
 
@@ -43,10 +75,13 @@ describe('| DyNTS_AppExtended;', (): void => {
   });
 
   describe('| a extended-full instance;', (): void => {
-    let app: DyNTS_AppExtendedFull_Mock;
-
     beforeEach(async (): Promise<void> => {
       try {
+        await DyFM_waitUntil(
+          (): boolean => !app,
+          second
+        );
+
         app = new DyNTS_AppExtendedFull_Mock();
 
         await DyFM_delay(100);
@@ -55,7 +90,19 @@ describe('| DyNTS_AppExtended;', (): void => {
 
         await DyFM_delay(100);
       } catch (error) {
-        DyFM_Log.test('test beforeEach error:', (error as DyFM_Error)?._message);
+        DyFM_Log.testError(
+          '| DyNTS_AppExtended; | a extended-full instance; test beforeEach error:\n', 
+          (error as DyFM_Error)?._message,
+          '\nadditionalContent:',
+          (error as DyFM_Error)?.additionalContent?.errors?.reverse()?.map(
+            (error: DyFM_Error | Error) => (error as DyFM_Error)._messages?.join('\n') ?? 
+              (error as DyFM_Error)._message ?? 
+              (error as Error).message
+          ) ?? (error as DyFM_Error)?.additionalContent,
+          '\n\n    Stack:', 
+          (new Error()).stack,
+          (error as DyFM_Error)?.additionalContent?.errors?.reverse()?.unshift()?.stack
+        );
       }
     });
 
@@ -67,7 +114,19 @@ describe('| DyNTS_AppExtended;', (): void => {
 
         app = null;
       } catch (error) {
-        DyFM_Log.test('test afterEach error:', (error as DyFM_Error)?._message);
+        DyFM_Log.testError(
+          '| DyNTS_AppExtended; | a extended-full instance; test afterEach error:\n', 
+          (error as DyFM_Error)?._message,
+          '\nadditionalContent:',
+          (error as DyFM_Error)?.additionalContent?.errors?.reverse()?.map(
+            (error: DyFM_Error | Error) => (error as DyFM_Error)._messages?.join('\n') ?? 
+              (error as DyFM_Error)._message ?? 
+              (error as Error).message
+          ) ?? (error as DyFM_Error)?.additionalContent,
+          '\n\n    Stack:', 
+          (new Error()).stack,
+          (error as DyFM_Error)?.additionalContent?.errors?.reverse()?.unshift()?.stack
+        );
       }
     });
 
@@ -81,22 +140,35 @@ describe('| DyNTS_AppExtended;', (): void => {
   });
 
   describe('| a wb-mock instance;', (): void => {
-    let app: DyNTS_AppWbMock_Mock;
-
     beforeEach(async (): Promise<void> => {
       try {
-        app = new DyNTS_AppWbMock_Mock();
+        await DyFM_waitUntil(
+          (): boolean => !app,
+          second
+        );
 
+        app = new DyNTS_AppWbMock_Mock();
         await DyFM_delay(100);
         
         await app.ready();
 
         await DyFM_delay(100);
       } catch (error) {
-        DyFM_Log.test('test beforeEach error:', (error as DyFM_Error)?._message);
+        DyFM_Log.testError(
+          '| DyNTS_AppExtended; | a wb-mock instance; test beforeEach error:\n', 
+          (error as DyFM_Error)?._message,
+          '\nadditionalContent:',
+          (error as DyFM_Error)?.additionalContent?.errors?.reverse()?.map(
+            (error: DyFM_Error | Error) => (error as DyFM_Error)._messages?.join('\n') ?? 
+              (error as DyFM_Error)._message ?? 
+              (error as Error).message
+          ) ?? (error as DyFM_Error)?.additionalContent,
+          '\n\n    Stack:', 
+          (new Error()).stack,
+          (error as DyFM_Error)?.additionalContent?.errors?.reverse()?.unshift()?.stack
+        );
       }
     });
-
     afterEach(async (): Promise<void> => {
       try {
         await DyFM_delay(100);
@@ -105,7 +177,19 @@ describe('| DyNTS_AppExtended;', (): void => {
 
         app = null;
       } catch (error) {
-        DyFM_Log.test('test afterEach error:', (error as DyFM_Error)?._message);
+        DyFM_Log.testError(
+          '| DyNTS_AppExtended; | a wb-mock instance; test afterEach error:\n', 
+          (error as DyFM_Error)?._message,
+          '\nadditionalContent:',
+          (error as DyFM_Error)?.additionalContent?.errors?.reverse()?.map(
+            (error: DyFM_Error | Error) => (error as DyFM_Error)._messages?.join('\n') ?? 
+              (error as DyFM_Error)._message ?? 
+              (error as Error).message
+          ) ?? (error as DyFM_Error)?.additionalContent,
+          '\n\n    Stack:', 
+          (new Error()).stack,
+          (error as DyFM_Error)?.additionalContent?.errors?.reverse()?.unshift()?.stack
+        );
       }
     });
 

package/src/_services/server/app.server.spec.ts

@@ -1,16 +1,21 @@
 
-import { DyFM_Error, DyFM_Log, DyFM_delay, second } from '@futdevpro/fsm-dynamo';
+import { DyFM_Error, DyFM_Log, DyFM_delay, DyFM_waitUntil, second } from '@futdevpro/fsm-dynamo';
 import { DyNTS_AppBase_Mock, DyNTS_AppFull_Mock } from '../../_modules/mock/app-server.mock';
+import { DyNTS_App } from './app.server';
 
 describe('| DyNTS_App AND DyNTS_AppExtended?;', (): void => {
-  jasmine.DEFAULT_TIMEOUT_INTERVAL = 15 * second;
+  jasmine.DEFAULT_TIMEOUT_INTERVAL = 30 * second;
   process.setMaxListeners(20);
+  let app: DyNTS_App;
 
   describe('| a base instance;', (): void => {
-    let app: DyNTS_AppBase_Mock;
-
     beforeEach(async (): Promise<void> => {
       try {
+        await DyFM_waitUntil(
+          (): boolean => !app,
+          second
+        );
+
         app = new DyNTS_AppBase_Mock();
 
         await DyFM_delay(100);
@@ -19,7 +24,19 @@ describe('| DyNTS_App AND DyNTS_AppExtended?;', (): void => {
 
         await DyFM_delay(100);
       } catch (error) {
-        DyFM_Log.test('test beforeEach error:', (error as DyFM_Error)?._message);
+        DyFM_Log.testError(
+          '| DyNTS_App; | a base instance; test beforeEach error:\n', 
+          (error as DyFM_Error)?._message,
+          '\nadditionalContent:',
+          (error as DyFM_Error)?.additionalContent?.errors?.reverse()?.map(
+            (error: DyFM_Error | Error) => (error as DyFM_Error)._messages?.join('\n') ?? 
+              (error as DyFM_Error)._message ?? 
+              (error as Error).message
+          ) ?? (error as DyFM_Error)?.additionalContent,
+          '\n\n    Stack:', 
+          (new Error()).stack,
+          (error as DyFM_Error)?.additionalContent?.errors?.reverse()?.unshift()?.stack
+        );
       }
     });
 
@@ -33,7 +50,19 @@ describe('| DyNTS_App AND DyNTS_AppExtended?;', (): void => {
 
         await DyFM_delay(100);
       } catch (error) {
-        DyFM_Log.test('test afterEach error:', (error as DyFM_Error)?._message);
+        DyFM_Log.testError(
+          '| DyNTS_App; | a base instance; test afterEach error:\n', 
+          (error as DyFM_Error)?._message,
+          '\nadditionalContent:',
+          (error as DyFM_Error)?.additionalContent?.errors?.reverse()?.map(
+            (error: DyFM_Error | Error) => (error as DyFM_Error)._messages?.join('\n') ?? 
+              (error as DyFM_Error)._message ?? 
+              (error as Error).message
+          ) ?? (error as DyFM_Error)?.additionalContent,
+          '\n\n    Stack:', 
+          (new Error()).stack,
+          (error as DyFM_Error)?.additionalContent?.errors?.reverse()?.unshift()?.stack
+        );
       }
     });
 
@@ -47,10 +76,13 @@ describe('| DyNTS_App AND DyNTS_AppExtended?;', (): void => {
   });
 
   describe('| a full instance;', (): void => {
-    let app: DyNTS_AppFull_Mock;
-
     beforeEach(async (): Promise<void> => {
       try {
+        await DyFM_waitUntil(
+          (): boolean => !app,
+          second
+        );
+
         app = new DyNTS_AppFull_Mock();
 
         await DyFM_delay(100);
@@ -59,7 +91,19 @@ describe('| DyNTS_App AND DyNTS_AppExtended?;', (): void => {
 
         await DyFM_delay(100);
       } catch (error) {
-        DyFM_Log.test('test beforeEach error:', (error as DyFM_Error)?._message);
+        DyFM_Log.testError(
+          '| DyNTS_App; | a full instance; test beforeEach error:\n', 
+          (error as DyFM_Error)?._message,
+          '\nadditionalContent:',
+          (error as DyFM_Error)?.additionalContent?.errors?.reverse()?.map(
+            (error: DyFM_Error | Error) => (error as DyFM_Error)._messages?.join('\n') ?? 
+              (error as DyFM_Error)._message ?? 
+              (error as Error).message
+          ) ?? (error as DyFM_Error)?.additionalContent,
+          '\n\n    Stack:', 
+          (new Error()).stack,
+          (error as DyFM_Error)?.additionalContent?.errors?.reverse()?.unshift()?.stack
+        );
       }
     });
 
@@ -73,7 +117,19 @@ describe('| DyNTS_App AND DyNTS_AppExtended?;', (): void => {
 
         await DyFM_delay(100);
       } catch (error) {
-        DyFM_Log.test('test afterEach error:', (error as DyFM_Error)?._message);
+        DyFM_Log.testError(
+          '| DyNTS_App; | a full instance; test afterEach error:\n', 
+          (error as DyFM_Error)?._message,
+          '\nadditionalContent:',
+          (error as DyFM_Error)?.additionalContent?.errors?.reverse()?.map(
+            (error: DyFM_Error | Error) => (error as DyFM_Error)._messages?.join('\n') ?? 
+              (error as DyFM_Error)._message ?? 
+              (error as Error).message
+          ) ?? (error as DyFM_Error)?.additionalContent,
+          '\n\n    Stack:', 
+          (new Error()).stack,
+          (error as DyFM_Error)?.additionalContent?.errors?.reverse()?.unshift()?.stack
+        );
       }
     });
 

package/src/_services/server/app.server.ts

@@ -414,7 +414,9 @@ export abstract class DyNTS_App extends DyNTS_SingletonService {
         this._routingModules = this.getRoutingModules();
       }
 
-      await this.startDB();
+      if (this._params.dbUri) {
+        await this.startDB();
+      }
 
       await this.createEntries?.();
 
@@ -706,6 +708,8 @@ export abstract class DyNTS_App extends DyNTS_SingletonService {
             await this.mongoose.connection.close();
             await disconnect;
 
+            this.mongoose.connection.removeAllListeners();
+
             while (
               this.mongoose.connection.readyState !== 0 && 
               !this.constructErrors.length
@@ -766,6 +770,30 @@ export abstract class DyNTS_App extends DyNTS_SingletonService {
   private async startDB(): Promise<void> {
     if (this.fnLogs && this.deepLog) DyFM_Log.log('\nfn:. startDB');
 
+    if (!this._params.dbUri) {
+      throw new DyFM_Error({
+        ...this._getDefaultErrorSettings('startDB', new Error('DB URI is not set.')),
+        
+        errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-AS0-SDB0`,
+      });
+    }
+
+    if (!this._params.dbOptions) {
+      throw new DyFM_Error({
+        ...this._getDefaultErrorSettings('startDB', new Error('DB OPTIONS are not set.')),
+        
+        errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-AS0-SDB0`,
+      });
+    }
+
+    if (this.systemControls.mongoose.init || this.systemControls.mongoose.started) {
+      throw new DyFM_Error({
+        ...this._getDefaultErrorSettings('startDB', new Error('Mongoose is already initialized.')),
+        
+        errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-AS0-SDB0`,
+      });
+    }
+
     try {
       await new Promise<void>(
         (resolve, reject): void => {
@@ -791,7 +819,8 @@ export abstract class DyNTS_App extends DyNTS_SingletonService {
                   ...this._getDefaultErrorSettings('startDB', error),
     
                   errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-AS0-SDB1`,
-                  message: `Unable to start connection to MongoDB server, ERROR: ${error}`,
+                  message: `Unable to start connection to MongoDB server (${this._params.dbUri}), ` +
+                    `ERROR: ${error}`,
                 });
 
                 DyNTS_GlobalService.globalErrorHandler?.(d_error);