@futdevpro/fsm-dynamo 1.9.9 → 1.9.12

package/src/_models/control-models/error.control-model.ts

@@ -1,722 +1,722 @@
-import { DynamoFM_error_defaults } from '../../_collections/constants/error-defaults.const';
-import { DynamoFM_ErrorLevel } from '../../_enums';
-import { DynamoFM_Log } from '../../_collections/utils/log.util';
-import { DynamoFM_Metadata } from '../data-models/metadata.data-model';
-
-export type DFM_Error = DynamoFM_Error;
-
-export interface DynamoFM_Error_Settings {
-  _id?: string;
-
-  handled?: boolean;
-  status?: number;
-
-  errorCode?: string;
-  message?: string;
-  userMessage?: string;
-  userMessageTranslateCode?: string;
-  addECToUserMsg?: boolean;
-
-  error?: DynamoFM_AnyError;
-  errors?: DynamoFM_AnyError[];
-
-  issuer?: string;
-  issuerSystem?: string;
-  issuerService?: string;
-
-  level?: DynamoFM_ErrorLevel;
-
-  levelUpThis?: boolean;
-  additionalContent?: any;
-  confidentialContent?: any;
-  
-  modestLog?: boolean;
-  log?: boolean;
-
-  __created?: Date;
-  __createdBy?: string;
-  __lastModified?: Date;
-  __lastModifiedBy?: string;
-  __v?: number;
-}
-
-export type DynamoFM_AnyError = Error | DynamoFM_Error;
-
-export class DynamoFM_Error extends DynamoFM_Metadata {
-  readonly flag = 'DYNAMO-ERROR-OBJECT-v2';
-
-  _errorCode?: string;
-  _errorCodes?: string[] = [];
-
-  /** contains all sub error messages, in reversed order */
-  _message?: string;
-  _messages?: string[] = [];
-
-  __userMessage?: string;
-  /** contains all sub error messages, in reversed order */
-  __userMessages?: string[] = [];
-  __userMessageTranslateCode?: string;
-
-  ___handled?: boolean;
-  ___status?: number;
-
-  ___issuer?: string;
-  ___issuerSystem?: string;
-  ___issuerService?: string;
-
-  error?: DynamoFM_AnyError;
-  errors?: DynamoFM_AnyError[] = [];
-
-  level?: DynamoFM_ErrorLevel;
-  
-  levelUpThis?: boolean;
-  additionalContent?: any = {};
-  confidentialContent?: any = {};
-
-  constructor(
-    set?: DynamoFM_Error_Settings
-  ) {
-    super(
-      set, 
-      { 
-        issuer: set?.issuerService ?? 
-          (set?.error as DynamoFM_Error)?.___issuerService ?? 
-            DynamoFM_error_defaults.issuerService,
-      }
-    );
-    
-    try {
-      if (!set) {
-        set = {};
-      }
-
-      /** set simple properties */
-      this.___handled = Boolean(set?.handled ?? (set?.error as DynamoFM_Error)?.___handled);
-      this.___status = set?.status ?? (set?.error as DynamoFM_Error)?.___status;
-      this.___issuer = set?.issuer ?? 
-        (set?.error as DynamoFM_Error)?.___issuer ?? 
-          DynamoFM_error_defaults.issuer;
-      this.___issuerSystem = set?.issuerSystem ??
-        (set?.error as DynamoFM_Error)?.___issuerSystem ?? 
-          DynamoFM_error_defaults.issuerSystem;
-      this.___issuerService = set?.issuerService ?? 
-        (set?.error as DynamoFM_Error)?.___issuerService ?? 
-          DynamoFM_error_defaults.issuerService;
-      
-      this.level = set?.level ?? (set?.error as DynamoFM_Error)?.level ?? DynamoFM_ErrorLevel.error;
-
-      this.levelUpThis = set?.levelUpThis;
-
-      if (set?.additionalContent && (set?.error as DynamoFM_Error)?.additionalContent) {
-        this.additionalContent = {
-          ...(set?.error as DynamoFM_Error)?.additionalContent,
-          ...set.additionalContent,
-        };
-      } else if (set?.additionalContent) {
-        this.additionalContent = set.additionalContent;
-      } else if ((set?.error as DynamoFM_Error)?.additionalContent) {
-        this.additionalContent = (set?.error as DynamoFM_Error)?.additionalContent;
-      }
-
-      if (set?.confidentialContent && (set?.error as DynamoFM_Error)?.confidentialContent) {
-        this.confidentialContent = {
-          ...(set?.error as DynamoFM_Error)?.confidentialContent,
-          ...set.confidentialContent,
-        };
-      } else if (set?.confidentialContent) {
-        this.confidentialContent = set.confidentialContent;
-      } else if ((set?.error as DynamoFM_Error)?.confidentialContent) {
-        this.confidentialContent = (set?.error as DynamoFM_Error)?.confidentialContent;
-      }
-
-      /** set default error code */
-      if (!set.errorCode) {
-        set.errorCode = DynamoFM_error_defaults.errorCode;
-      }
-
-      /** set default error (self defined) */
-      if (!set?.error) {
-        set.error = new Error();
-        const errorStack: string[] = set.error.stack.split('\n');
-
-        errorStack.splice(1, 1);
-        set.error.stack = errorStack.join('\n');
-      }
-
-      /** set errorCodes */
-      let previousErrorCodes: string[] = [];
-
-      if ((set?.error as DynamoFM_Error)?._errorCodes) {
-        previousErrorCodes.push(...((set?.error as DynamoFM_Error)?._errorCodes ?? []));
-      }
-
-      if (!set.errorCode) {
-        set.errorCode = DynamoFM_error_defaults.errorCode;
-      }
-      previousErrorCodes = previousErrorCodes.filter(
-        (code: string): boolean => code !== set.errorCode
-      );
-      this._errorCodes = [ ...previousErrorCodes, set?.errorCode ].filter(Boolean);
-
-      /** bring up non NTS and non default first error */
-      const filteredErrorCodes: string[] = this._errorCodes.filter(
-        (code: string): boolean => 
-          code && code !== DynamoFM_error_defaults.errorCode && !code.includes('NTS-')
-      );
-
-      this._errorCode = filteredErrorCodes[0] ?? this._errorCodes?.[0];
-      const highlightedErrorCodeIndex: number = this._errorCodes.findIndex(
-        (code: string): boolean => code === filteredErrorCodes?.[0]
-      );
-
-      /** set message */
-      if (!set.message) {
-        if (typeof set?.error === 'string') {
-        /** string error */
-          set.message = set.error;
-        } else if (
-          !(set?.error as DynamoFM_Error)?.flag?.includes('DYNAMO') && 
-          (set?.error as Error)?.message
-        ) {
-        /** simple - non-dynamo - error */
-          set.message = (set?.error as Error)?.message;
-        } else if ((set.error as Error).stack) {
-        /** error not defined - self defining */
-          const posFull = (set.error as Error).stack.split('\n')?.[1]?.split('\\');
-
-          set.message = DynamoFM_error_defaults.message + '; ' + posFull[posFull.length - 1];
-        }
-      }
-      /** set messages */
-      let previousMessages: string[] = [];
-      
-      if ((set?.error as DynamoFM_Error)?._messages) {
-        previousMessages.push(...((set?.error as DynamoFM_Error)?._messages ?? []));
-      } else if ((set?.error as Error)?.message) {
-        previousErrorCodes.push((set?.error as Error)?.message);
-      }
-      previousMessages = previousMessages.filter(
-        (msg: string): boolean => msg !== set.message
-      );
-      this._messages = [ ...previousMessages, set?.message, ].filter(Boolean);
-
-      if (
-        -1 < highlightedErrorCodeIndex && 
-        this._messages[highlightedErrorCodeIndex] && 
-        this._messages[highlightedErrorCodeIndex] !== DynamoFM_error_defaults.message
-      ) {
-        this._message = this._messages[highlightedErrorCodeIndex];
-      } else {
-        this._message = this._messages?.[0];
-      }
-
-      /** set userMessages */
-      let previousUserMessages: string[] = [];
-
-      if ((set?.error as DynamoFM_Error)?.__userMessages) {
-        previousUserMessages.push(...((set?.error as DynamoFM_Error)?.__userMessages ?? []));
-      }
-
-      if (!set.userMessage) {
-        set.userMessage = DynamoFM_error_defaults.userMessage;
-      }
-
-      if (
-        set.addECToUserMsg && 
-        set.userMessage !== DynamoFM_error_defaults.userMessage && 
-        set.errorCode
-      ) {
-        set.userMessage += `\nErrorCode: ${set.errorCode}`;
-      }
-      previousUserMessages = previousUserMessages.filter(
-        (msg: string): boolean => msg !== set.userMessage
-      );
-      this.__userMessages = [ ...previousUserMessages, set?.userMessage ].filter(Boolean);
-
-      if (
-        -1 < highlightedErrorCodeIndex && 
-        this.__userMessages[highlightedErrorCodeIndex] && 
-        this.__userMessages[highlightedErrorCodeIndex] !== DynamoFM_error_defaults.userMessage
-      ) {
-        this.__userMessage = this.__userMessages[highlightedErrorCodeIndex];
-      } else {
-        this.__userMessage = this.__userMessages.filter(
-          (msg: string): boolean => msg && msg !== DynamoFM_error_defaults.userMessage
-        )?.[0];
-      }
-
-      /** set userMessageTranslateCode */
-      set.userMessageTranslateCode = 
-        set?.userMessageTranslateCode ?? 
-          (set?.error as DynamoFM_Error)?.__userMessageTranslateCode;
-
-      /** set errors */
-      let previousErrors: DynamoFM_AnyError[] = [];
-
-      if ((set?.error as DynamoFM_Error)?.errors?.length) {
-        previousErrors.push(...(set.error as DynamoFM_Error).errors);
-      } else if (typeof (set?.error as DynamoFM_Error)?.errors == 'object') {
-        this.additionalContent.errors = (set?.error as DynamoFM_Error).errors;
-      }
-      previousErrors = previousErrors.filter(
-        (error: DynamoFM_AnyError): boolean => error !== set.error
-      );
-      this.errors = [ ...previousErrors, set?.error ].filter(Boolean);
-
-      if (set?.errors) {
-        if (0 < this.errors.length) {
-          this.errors.push(...(set.errors ?? []));
-        } else {
-          this.errors.push(
-            new Error('there are multiple errors. check errors after this one'), 
-            ...(set.errors ?? []),
-          );
-        }
-      }
-      this.error = this.errors?.[0];
-      this.errors.map((error: DynamoFM_AnyError): any => {
-        if ((error as DynamoFM_Error)?.flag?.includes('DYNAMO')) {
-          const subError = { ...(error ?? {}) };
-          
-          if ((subError as DynamoFM_Error)?.errors) {
-            delete (subError as DynamoFM_Error).errors;
-          }
-
-          return subError;
-        }
-      });
-      
-      if (set?.modestLog) {
-        console.error(this._message ?? this.__userMessage ?? this.error);
-      }
-
-      if (set?.log) {
-        console.error(this);
-      }
-    } catch (error) {
-      DynamoFM_Log.error(
-        '\n\nInternal Dynamo ERROR: Failed to create DynamoFM_Error...' +
-        '\nerror:\n', error, 
-        '\n\ntrace:', new Error(), 
-        '\n\nset:', set, 
-        '\n\n'
-      );
-    }
-  }
-
-  getErrorSimplified(): DynamoFM_Error {
-    const error: DynamoFM_Error = { ...this };
-
-    delete error.errors;
-
-    if ((error.error as DynamoFM_Error)?.error) {
-      delete (error.error as DynamoFM_Error).error;
-    }
-
-    if ((error.error as DynamoFM_Error)?.errors) {
-      delete (error.error as DynamoFM_Error).errors;
-    }
-
-    return error;
-  }
-
-  getErrorsFlat(): DynamoFM_Error {
-    const error: DynamoFM_Error = { ...this };
-    
-    if ((error.error as DynamoFM_Error)?.error) {
-      delete (error.error as DynamoFM_Error).error;
-    }
-
-    if ((error.error as DynamoFM_Error)?.errors) {
-      delete (error.error as DynamoFM_Error).errors;
-    }
-
-    error.errors.map((err: DynamoFM_Error): void => {
-      const subError = { ...(err ?? {}) };
-
-      if (subError.errors) {
-        delete subError.errors;
-      }
-
-      if ((subError.error as DynamoFM_Error)?.errors) {
-        delete (subError.error as DynamoFM_Error).errors;
-      }
-
-      if ((subError.error as DynamoFM_Error)?.error) {
-        delete (subError.error as DynamoFM_Error).error;
-      }
-    });
-
-    return error;
-  }
-}
-
-/*
-
-//                  //
-// RESPONSE STATUS  //
-//                  //
-
-1XX informational response
-
-  100 Continue
-  101 Switching Protocols
-  102 Processing
-  103 Early Hints
-
-
-2XX success
-
-  200 OK
-  201 Created
-  202 Accepted
-  203 Non-Authoritative Information
-  204 No Content
-  205 Reset Content
-  206 Partial Content 
-  207 Multi-Status
-  208 Already Reported
-  226 IM Used
-
-  
-3XX redirection
-
-  300 Multiple Choices
-  301 Moved Permanently
-  302 Found
-  303 See Other
-  304 Not Modified
-  305 Use Proxy
-  306 Switch Proxy
-  307 Temporary Redirect
-  308 Permanent Redirect
-
-
-4XX client errors
-
-  400 Bad Request
-  401 Unauthorized
-  402 Payment Required
-  403 Forbidden
-  404 Not Found
-  405 Method Not Allowed
-  406 Not Acceptable
-  407 Proxy Authentication Required
-  408 Request Timeout
-  409 Conflict
-  410 Gone
-  411 Length Required
-  412 Precondition Failed
-  413 Payload Too Large 
-  414 URI Too Long
-  415 Unsupported Media Type
-  416 Range Not Satisfiable
-  417 Expectation Failed
-  418 I'm a teapot
-  421 Misdirected Request
-  422 Unprocessable Entity
-  423 Locked
-  424 Failed Dependency
-  425 Too Early
-  426 Upgrade Required
-  428 Precondition Required
-  429 Too Many Requests
-  431 Request Header Fields Too Large
-  451 Unavailable For Legal Reasons
-
-
-5XX server errors
-
-  500 Internal Server Error
-  501 Not Implemented
-  502 Bad Gateway
-  503 Service Unavailable
-  504 Gateway Timeout
-  505 HTTP Version Not Supported
-  506 Variant Also Negotiates
-  507 Insufficient Storage
-  508 Loop Detected 
-  510 Not Extended
-  511 Network Authentication Required
-
-
-Unofficial codes
-
-  103 Checkpoint
-  218 This is fine (Apache Web Server)
-  419 Page Expired (Laravel Framework)
-  420 Enhance Your Calm (Twitter)
-  430 Request Header Fields Too Large (Shopify)
-  450 Blocked by Windows Parental Controls (Microsoft)
-  498 Invalid Token (Esri)
-  499 Token Required (Esri)
-  509 Bandwidth Limit Exceeded (Apache Web Server/cPanel)
-  526 Invalid SSL Certificate
-  529 Site is overloaded
-  530 Site is frozen
-  598 (Informal convention) Network read timeout error
-
-  440 Login Time-out
-  449 Retry With
-  451 Redirect
-
-  444 No Response
-  494 Request header too large
-  495 SSL Certificate Error
-  496 SSL Certificate Required
-  497 HTTP Request Sent to HTTPS Port
-  499 Client Closed Request
-
-  520 Web Server Returned an any Error
-  521 Web Server Is Down
-  522 Connection Timed Out
-  523 Origin Is Unreachable
-  524 A Timeout Occurred
-  525 SSL Handshake Failed
-  526 Invalid SSL Certificate
-  527 Railgun Error
-
-  530
-
-  460
-  463
-
-*/
-
-
-
-
-/**
- * Returns the average of two numbers.
- *
- * @remarks
- * This method is part of the {@link core-library#Statistics | Statistics subsystem}.
- *
- * @param x - The first input number
- * @param y - The second input number
- * @returns The arithmetic mean of `x` and `y`
- *
- * @beta
- * @returns true if the specified tag is surrounded with `{`
- * and `}` characters.
- *
- * @example
- * Prints "true" for `{@link}` but "false" for `@internal`:
- * ```ts
- * console.log(isInlineTag('{@link}'));
- * console.log(isInlineTag('@internal'));
- * ```
- * 
- * 
- * @alpha
- * v
- * sadfas d
- * fs
- * daf
- * d as
- * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
- * a
- * @beta
- * v
- * sadfas d
- * fs
- * daf
- * d as
- * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
- * b
- * @decorator
- * v
- * sadfas d
- * fs
- * daf
- * d as
- * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
- * dc
- * @deprecated
- * v
- * sadfas d
- * fs
- * daf
- * d as
- * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
- * dp
- * @defaultValue
- * v
- * sadfas d
- * fs
- * daf
- * d as
- * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
- * dv
- * @eventProperty
- * v
- * sadfas d
- * fs
- * daf
- * d as
- * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
- * ep
- * @example
- * v
- * sadfas d
- * fs
- * daf
- * d as
- * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
- * ex
- * @experimental
- * v
- * sadfas d
- * fs
- * daf
- * d as
- * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
- * exp
- * @inheritDoc
- * v
- * sadfas d
- * fs
- * daf
- * d as
- * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
- * in
- * @internal
- * v
- * sadfas d
- * fs
- * daf
- * d as
- * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
- * int
- * @label
- * v
- * sadfas d
- * fs
- * daf
- * d as
- * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
- * lab
- * @link
- * v
- * sadfas d
- * fs
- * daf
- * d as
- * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
- * li
- * @override
- * v
- * sadfas d
- * fs
- * daf
- * d as
- * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
- * v
- * sadfas d
- * fs
- * daf
- * d as
- * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
- * ov
- * @packageDocumentation
- * v
- * sadfas d
- * fs
- * daf
- * d as
- * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
- * pad
- * @param
- * v
- * sadfas d
- * fs
- * daf
- * d as
- * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
- * par
- * @privateRemarks
- * v
- * sadfas d
- * fs
- * daf
- * d as
- * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
- * pr
- * @public
- * v
- * sadfas d
- * fs
- * daf
- * d as
- * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
- * p
- * @readonly
- * v
- * sadfas d
- * fs
- * daf
- * d as
- * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
- * re
- * @remarks
- * v
- * sadfas d
- * fs
- * daf
- * d as
- * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
- * rem
- * @returns
- * v
- * sadfas d
- * fs
- * daf
- * d as
- * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
- * ret
- * @sealed
- * v
- * sadfas d
- * fs
- * daf
- * d as
- * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
- * sea
- * @see
- * v
- * sadfas d
- * fs
- * daf
- * d as
- * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
- * see
- * @throws
- * v
- * sadfas d
- * fs
- * daf
- * d as
- * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
- * th
- * @typeParam
- * v
- * sadfas d
- * fs
- * daf
- * d as
- * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
- * typ
- * @virtual
- * v
- * sadfas d
- * fs
- * daf
- * d as
- * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
- * 
- * 
- * @see {@link http://example.com/@internal LINK}
- * @see {@link http://example.com/@internal http://example.com/@internal}
- */
-export interface TestDocumentationComments {}
-
+import { DynamoFM_error_defaults } from '../../_collections/constants/error-defaults.const';
+import { DynamoFM_ErrorLevel } from '../../_enums';
+import { DynamoFM_Log } from '../../_collections/utils/log.util';
+import { DynamoFM_Metadata } from '../data-models/metadata.data-model';
+
+export type DFM_Error = DynamoFM_Error;
+
+export interface DynamoFM_Error_Settings {
+  _id?: string;
+
+  handled?: boolean;
+  status?: number;
+
+  errorCode?: string;
+  message?: string;
+  userMessage?: string;
+  userMessageTranslateCode?: string;
+  addECToUserMsg?: boolean;
+
+  error?: DynamoFM_AnyError;
+  errors?: DynamoFM_AnyError[];
+
+  issuer?: string;
+  issuerSystem?: string;
+  issuerService?: string;
+
+  level?: DynamoFM_ErrorLevel;
+
+  levelUpThis?: boolean;
+  additionalContent?: any;
+  confidentialContent?: any;
+  
+  modestLog?: boolean;
+  log?: boolean;
+
+  __created?: Date;
+  __createdBy?: string;
+  __lastModified?: Date;
+  __lastModifiedBy?: string;
+  __v?: number;
+}
+
+export type DynamoFM_AnyError = Error | DynamoFM_Error;
+
+export class DynamoFM_Error extends DynamoFM_Metadata {
+  readonly flag = 'DYNAMO-ERROR-OBJECT-v2';
+
+  _errorCode?: string;
+  _errorCodes?: string[] = [];
+
+  /** contains all sub error messages, in reversed order */
+  _message?: string;
+  _messages?: string[] = [];
+
+  __userMessage?: string;
+  /** contains all sub error messages, in reversed order */
+  __userMessages?: string[] = [];
+  __userMessageTranslateCode?: string;
+
+  ___handled?: boolean;
+  ___status?: number;
+
+  ___issuer?: string;
+  ___issuerSystem?: string;
+  ___issuerService?: string;
+
+  error?: DynamoFM_AnyError;
+  errors?: DynamoFM_AnyError[] = [];
+
+  level?: DynamoFM_ErrorLevel;
+  
+  levelUpThis?: boolean;
+  additionalContent?: any = {};
+  confidentialContent?: any = {};
+
+  constructor(
+    set?: DynamoFM_Error_Settings
+  ) {
+    super(
+      set, 
+      { 
+        issuer: set?.issuerService ?? 
+          (set?.error as DynamoFM_Error)?.___issuerService ?? 
+            DynamoFM_error_defaults.issuerService,
+      }
+    );
+    
+    try {
+      if (!set) {
+        set = {};
+      }
+
+      /** set simple properties */
+      this.___handled = Boolean(set?.handled ?? (set?.error as DynamoFM_Error)?.___handled);
+      this.___status = set?.status ?? (set?.error as DynamoFM_Error)?.___status;
+      this.___issuer = set?.issuer ?? 
+        (set?.error as DynamoFM_Error)?.___issuer ?? 
+          DynamoFM_error_defaults.issuer;
+      this.___issuerSystem = set?.issuerSystem ??
+        (set?.error as DynamoFM_Error)?.___issuerSystem ?? 
+          DynamoFM_error_defaults.issuerSystem;
+      this.___issuerService = set?.issuerService ?? 
+        (set?.error as DynamoFM_Error)?.___issuerService ?? 
+          DynamoFM_error_defaults.issuerService;
+      
+      this.level = set?.level ?? (set?.error as DynamoFM_Error)?.level ?? DynamoFM_ErrorLevel.error;
+
+      this.levelUpThis = set?.levelUpThis;
+
+      if (set?.additionalContent && (set?.error as DynamoFM_Error)?.additionalContent) {
+        this.additionalContent = {
+          ...(set?.error as DynamoFM_Error)?.additionalContent,
+          ...set.additionalContent,
+        };
+      } else if (set?.additionalContent) {
+        this.additionalContent = set.additionalContent;
+      } else if ((set?.error as DynamoFM_Error)?.additionalContent) {
+        this.additionalContent = (set?.error as DynamoFM_Error)?.additionalContent;
+      }
+
+      if (set?.confidentialContent && (set?.error as DynamoFM_Error)?.confidentialContent) {
+        this.confidentialContent = {
+          ...(set?.error as DynamoFM_Error)?.confidentialContent,
+          ...set.confidentialContent,
+        };
+      } else if (set?.confidentialContent) {
+        this.confidentialContent = set.confidentialContent;
+      } else if ((set?.error as DynamoFM_Error)?.confidentialContent) {
+        this.confidentialContent = (set?.error as DynamoFM_Error)?.confidentialContent;
+      }
+
+      /** set default error code */
+      if (!set.errorCode) {
+        set.errorCode = DynamoFM_error_defaults.errorCode;
+      }
+
+      /** set default error (self defined) */
+      if (!set?.error) {
+        set.error = new Error();
+        const errorStack: string[] = set.error.stack.split('\n');
+
+        errorStack.splice(1, 1);
+        set.error.stack = errorStack.join('\n');
+      }
+
+      /** set errorCodes */
+      let previousErrorCodes: string[] = [];
+
+      if ((set?.error as DynamoFM_Error)?._errorCodes) {
+        previousErrorCodes.push(...((set?.error as DynamoFM_Error)?._errorCodes ?? []));
+      }
+
+      if (!set.errorCode) {
+        set.errorCode = DynamoFM_error_defaults.errorCode;
+      }
+      previousErrorCodes = previousErrorCodes.filter(
+        (code: string): boolean => code !== set.errorCode
+      );
+      this._errorCodes = [ ...previousErrorCodes, set?.errorCode ].filter(Boolean);
+
+      /** bring up non NTS and non default first error */
+      const filteredErrorCodes: string[] = this._errorCodes.filter(
+        (code: string): boolean => 
+          code && code !== DynamoFM_error_defaults.errorCode && !code.includes('NTS-')
+      );
+
+      this._errorCode = filteredErrorCodes[0] ?? this._errorCodes?.[0];
+      const highlightedErrorCodeIndex: number = this._errorCodes.findIndex(
+        (code: string): boolean => code === filteredErrorCodes?.[0]
+      );
+
+      /** set message */
+      if (!set.message) {
+        if (typeof set?.error === 'string') {
+        /** string error */
+          set.message = set.error;
+        } else if (
+          !(set?.error as DynamoFM_Error)?.flag?.includes('DYNAMO') && 
+          (set?.error as Error)?.message
+        ) {
+        /** simple - non-dynamo - error */
+          set.message = (set?.error as Error)?.message;
+        } else if ((set.error as Error).stack) {
+        /** error not defined - self defining */
+          const posFull: string[] = (set.error as Error).stack.split('\n')?.[1]?.split('\\');
+
+          set.message = DynamoFM_error_defaults.message + '; ' + posFull[posFull.length - 1];
+        }
+      }
+      /** set messages */
+      let previousMessages: string[] = [];
+      
+      if ((set?.error as DynamoFM_Error)?._messages) {
+        previousMessages.push(...((set?.error as DynamoFM_Error)?._messages ?? []));
+      } else if ((set?.error as Error)?.message) {
+        previousErrorCodes.push((set?.error as Error)?.message);
+      }
+      previousMessages = previousMessages.filter(
+        (msg: string): boolean => msg !== set.message
+      );
+      this._messages = [ ...previousMessages, set?.message ].filter(Boolean);
+
+      if (
+        -1 < highlightedErrorCodeIndex && 
+        this._messages[highlightedErrorCodeIndex] && 
+        this._messages[highlightedErrorCodeIndex] !== DynamoFM_error_defaults.message
+      ) {
+        this._message = this._messages[highlightedErrorCodeIndex];
+      } else {
+        this._message = this._messages?.[0];
+      }
+
+      /** set userMessages */
+      let previousUserMessages: string[] = [];
+
+      if ((set?.error as DynamoFM_Error)?.__userMessages) {
+        previousUserMessages.push(...((set?.error as DynamoFM_Error)?.__userMessages ?? []));
+      }
+
+      if (!set.userMessage) {
+        set.userMessage = DynamoFM_error_defaults.userMessage;
+      }
+
+      if (
+        set.addECToUserMsg && 
+        set.userMessage !== DynamoFM_error_defaults.userMessage && 
+        set.errorCode
+      ) {
+        set.userMessage += `\nErrorCode: ${set.errorCode}`;
+      }
+      previousUserMessages = previousUserMessages.filter(
+        (msg: string): boolean => msg !== set.userMessage
+      );
+      this.__userMessages = [ ...previousUserMessages, set?.userMessage ].filter(Boolean);
+
+      if (
+        -1 < highlightedErrorCodeIndex && 
+        this.__userMessages[highlightedErrorCodeIndex] && 
+        this.__userMessages[highlightedErrorCodeIndex] !== DynamoFM_error_defaults.userMessage
+      ) {
+        this.__userMessage = this.__userMessages[highlightedErrorCodeIndex];
+      } else {
+        this.__userMessage = this.__userMessages.filter(
+          (msg: string): boolean => msg && msg !== DynamoFM_error_defaults.userMessage
+        )?.[0];
+      }
+
+      /** set userMessageTranslateCode */
+      set.userMessageTranslateCode = 
+        set?.userMessageTranslateCode ?? 
+          (set?.error as DynamoFM_Error)?.__userMessageTranslateCode;
+
+      /** set errors */
+      let previousErrors: DynamoFM_AnyError[] = [];
+
+      if ((set?.error as DynamoFM_Error)?.errors?.length) {
+        previousErrors.push(...(set.error as DynamoFM_Error).errors);
+      } else if (typeof (set?.error as DynamoFM_Error)?.errors == 'object') {
+        this.additionalContent.errors = (set?.error as DynamoFM_Error).errors;
+      }
+      previousErrors = previousErrors.filter(
+        (error: DynamoFM_AnyError): boolean => error !== set.error
+      );
+      this.errors = [ ...previousErrors, set?.error ].filter(Boolean);
+
+      if (set?.errors) {
+        if (0 < this.errors.length) {
+          this.errors.push(...(set.errors ?? []));
+        } else {
+          this.errors.push(
+            new Error('there are multiple errors. check errors after this one'), 
+            ...(set.errors ?? []),
+          );
+        }
+      }
+      this.error = this.errors?.[0];
+      this.errors.map((error: DynamoFM_AnyError): any => {
+        if ((error as DynamoFM_Error)?.flag?.includes('DYNAMO')) {
+          const subError = { ...(error ?? {}) };
+          
+          if ((subError as DynamoFM_Error)?.errors) {
+            delete (subError as DynamoFM_Error).errors;
+          }
+
+          return subError;
+        }
+      });
+      
+      if (set?.modestLog) {
+        console.error(this._message ?? this.__userMessage ?? this.error);
+      }
+
+      if (set?.log) {
+        console.error(this);
+      }
+    } catch (error) {
+      DynamoFM_Log.error(
+        '\n\nInternal Dynamo ERROR: Failed to create DynamoFM_Error...' +
+        '\nerror:\n', error, 
+        '\n\ntrace:', new Error(), 
+        '\n\nset:', set, 
+        '\n\n'
+      );
+    }
+  }
+
+  getErrorSimplified(): DynamoFM_Error {
+    const error: DynamoFM_Error = { ...this };
+
+    delete error.errors;
+
+    if ((error.error as DynamoFM_Error)?.error) {
+      delete (error.error as DynamoFM_Error).error;
+    }
+
+    if ((error.error as DynamoFM_Error)?.errors) {
+      delete (error.error as DynamoFM_Error).errors;
+    }
+
+    return error;
+  }
+
+  getErrorsFlat(): DynamoFM_Error {
+    const error: DynamoFM_Error = { ...this };
+    
+    if ((error.error as DynamoFM_Error)?.error) {
+      delete (error.error as DynamoFM_Error).error;
+    }
+
+    if ((error.error as DynamoFM_Error)?.errors) {
+      delete (error.error as DynamoFM_Error).errors;
+    }
+
+    error.errors.map((err: DynamoFM_Error): void => {
+      const subError = { ...(err ?? {}) };
+
+      if (subError.errors) {
+        delete subError.errors;
+      }
+
+      if ((subError.error as DynamoFM_Error)?.errors) {
+        delete (subError.error as DynamoFM_Error).errors;
+      }
+
+      if ((subError.error as DynamoFM_Error)?.error) {
+        delete (subError.error as DynamoFM_Error).error;
+      }
+    });
+
+    return error;
+  }
+}
+
+/*
+
+//                  //
+// RESPONSE STATUS  //
+//                  //
+
+1XX informational response
+
+  100 Continue
+  101 Switching Protocols
+  102 Processing
+  103 Early Hints
+
+
+2XX success
+
+  200 OK
+  201 Created
+  202 Accepted
+  203 Non-Authoritative Information
+  204 No Content
+  205 Reset Content
+  206 Partial Content 
+  207 Multi-Status
+  208 Already Reported
+  226 IM Used
+
+  
+3XX redirection
+
+  300 Multiple Choices
+  301 Moved Permanently
+  302 Found
+  303 See Other
+  304 Not Modified
+  305 Use Proxy
+  306 Switch Proxy
+  307 Temporary Redirect
+  308 Permanent Redirect
+
+
+4XX client errors
+
+  400 Bad Request
+  401 Unauthorized
+  402 Payment Required
+  403 Forbidden
+  404 Not Found
+  405 Method Not Allowed
+  406 Not Acceptable
+  407 Proxy Authentication Required
+  408 Request Timeout
+  409 Conflict
+  410 Gone
+  411 Length Required
+  412 Precondition Failed
+  413 Payload Too Large 
+  414 URI Too Long
+  415 Unsupported Media Type
+  416 Range Not Satisfiable
+  417 Expectation Failed
+  418 I'm a teapot
+  421 Misdirected Request
+  422 Unprocessable Entity
+  423 Locked
+  424 Failed Dependency
+  425 Too Early
+  426 Upgrade Required
+  428 Precondition Required
+  429 Too Many Requests
+  431 Request Header Fields Too Large
+  451 Unavailable For Legal Reasons
+
+
+5XX server errors
+
+  500 Internal Server Error
+  501 Not Implemented
+  502 Bad Gateway
+  503 Service Unavailable
+  504 Gateway Timeout
+  505 HTTP Version Not Supported
+  506 Variant Also Negotiates
+  507 Insufficient Storage
+  508 Loop Detected 
+  510 Not Extended
+  511 Network Authentication Required
+
+
+Unofficial codes
+
+  103 Checkpoint
+  218 This is fine (Apache Web Server)
+  419 Page Expired (Laravel Framework)
+  420 Enhance Your Calm (Twitter)
+  430 Request Header Fields Too Large (Shopify)
+  450 Blocked by Windows Parental Controls (Microsoft)
+  498 Invalid Token (Esri)
+  499 Token Required (Esri)
+  509 Bandwidth Limit Exceeded (Apache Web Server/cPanel)
+  526 Invalid SSL Certificate
+  529 Site is overloaded
+  530 Site is frozen
+  598 (Informal convention) Network read timeout error
+
+  440 Login Time-out
+  449 Retry With
+  451 Redirect
+
+  444 No Response
+  494 Request header too large
+  495 SSL Certificate Error
+  496 SSL Certificate Required
+  497 HTTP Request Sent to HTTPS Port
+  499 Client Closed Request
+
+  520 Web Server Returned an any Error
+  521 Web Server Is Down
+  522 Connection Timed Out
+  523 Origin Is Unreachable
+  524 A Timeout Occurred
+  525 SSL Handshake Failed
+  526 Invalid SSL Certificate
+  527 Railgun Error
+
+  530
+
+  460
+  463
+
+*/
+
+
+
+
+/**
+ * Returns the average of two numbers.
+ *
+ * @remarks
+ * This method is part of the {@link core-library#Statistics | Statistics subsystem}.
+ *
+ * @param x - The first input number
+ * @param y - The second input number
+ * @returns The arithmetic mean of `x` and `y`
+ *
+ * @beta
+ * @returns true if the specified tag is surrounded with `{`
+ * and `}` characters.
+ *
+ * @example
+ * Prints "true" for `{@link}` but "false" for `@internal`:
+ * ```ts
+ * console.log(isInlineTag('{@link}'));
+ * console.log(isInlineTag('@internal'));
+ * ```
+ * 
+ * 
+ * @alpha
+ * v
+ * sadfas d
+ * fs
+ * daf
+ * d as
+ * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
+ * a
+ * @beta
+ * v
+ * sadfas d
+ * fs
+ * daf
+ * d as
+ * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
+ * b
+ * @decorator
+ * v
+ * sadfas d
+ * fs
+ * daf
+ * d as
+ * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
+ * dc
+ * @deprecated
+ * v
+ * sadfas d
+ * fs
+ * daf
+ * d as
+ * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
+ * dp
+ * @defaultValue
+ * v
+ * sadfas d
+ * fs
+ * daf
+ * d as
+ * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
+ * dv
+ * @eventProperty
+ * v
+ * sadfas d
+ * fs
+ * daf
+ * d as
+ * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
+ * ep
+ * @example
+ * v
+ * sadfas d
+ * fs
+ * daf
+ * d as
+ * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
+ * ex
+ * @experimental
+ * v
+ * sadfas d
+ * fs
+ * daf
+ * d as
+ * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
+ * exp
+ * @inheritDoc
+ * v
+ * sadfas d
+ * fs
+ * daf
+ * d as
+ * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
+ * in
+ * @internal
+ * v
+ * sadfas d
+ * fs
+ * daf
+ * d as
+ * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
+ * int
+ * @label
+ * v
+ * sadfas d
+ * fs
+ * daf
+ * d as
+ * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
+ * lab
+ * @link
+ * v
+ * sadfas d
+ * fs
+ * daf
+ * d as
+ * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
+ * li
+ * @override
+ * v
+ * sadfas d
+ * fs
+ * daf
+ * d as
+ * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
+ * v
+ * sadfas d
+ * fs
+ * daf
+ * d as
+ * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
+ * ov
+ * @packageDocumentation
+ * v
+ * sadfas d
+ * fs
+ * daf
+ * d as
+ * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
+ * pad
+ * @param
+ * v
+ * sadfas d
+ * fs
+ * daf
+ * d as
+ * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
+ * par
+ * @privateRemarks
+ * v
+ * sadfas d
+ * fs
+ * daf
+ * d as
+ * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
+ * pr
+ * @public
+ * v
+ * sadfas d
+ * fs
+ * daf
+ * d as
+ * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
+ * p
+ * @readonly
+ * v
+ * sadfas d
+ * fs
+ * daf
+ * d as
+ * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
+ * re
+ * @remarks
+ * v
+ * sadfas d
+ * fs
+ * daf
+ * d as
+ * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
+ * rem
+ * @returns
+ * v
+ * sadfas d
+ * fs
+ * daf
+ * d as
+ * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
+ * ret
+ * @sealed
+ * v
+ * sadfas d
+ * fs
+ * daf
+ * d as
+ * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
+ * sea
+ * @see
+ * v
+ * sadfas d
+ * fs
+ * daf
+ * d as
+ * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
+ * see
+ * @throws
+ * v
+ * sadfas d
+ * fs
+ * daf
+ * d as
+ * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
+ * th
+ * @typeParam
+ * v
+ * sadfas d
+ * fs
+ * daf
+ * d as
+ * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
+ * typ
+ * @virtual
+ * v
+ * sadfas d
+ * fs
+ * daf
+ * d as
+ * dafs // asd sa `sadf ` sadf asd******* asdf asd f asd
+ * 
+ * 
+ * @see {@link http://example.com/@internal LINK}
+ * @see {@link http://example.com/@internal http://example.com/@internal}
+ */
+export interface TestDocumentationComments {}
+