npm - @futdevpro/fsm-dynamo - Versions diffs - 1.15.21 → 1.15.23 - Mend

@futdevpro/fsm-dynamo 1.15.21 → 1.15.23

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (925) hide show

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

@@ -1,1215 +1,1215 @@
-import { DyFM_error_defaults } from '../../_collections/constants/error-defaults.const';
-import { DyFM_Log } from '../../_collections/utils/log.util';
-import { DyFM_Object } from '../../_collections/utils/object.util';
-import { DyFM_getLocalStackLocation } from '../../_collections/utils/stack.util';
-import { DyFM_ErrorLevel } from '../../_enums/error-level.enum';
-import { DyFM_LogStyle } from '../../_enums/log-style.enum';
-import { DyFM_Metadata } from '../data-models/metadata.data-model';
-import { DyFM_HttpErrorResponse, DyFM_httpErrorResponse_name } from './http/http-error-response.control-model';
-export const DyFM_errorFlag = 'DYNAMO-ERROR-OBJECT';
-export const DyFM_errorĐFlagParts= [
-  'DyNTS-',
-  'DyFM-',
-  'DyNX_',
-  'DyNM_',
-  'DyBu_',
-  'DyCLI_',
-]
-export interface DyFM_ValidationError {
-  message: string;
-  /** @deprecated use message instead */
-  userMessage?: string;
-  code: string;
-}
-export type DyFM_ValidationErrors = {
-  [key: string]: DyFM_ValidationError;
-}
-export type DyFM_AnyError = DyFM_Error | DyFM_HttpErrorResponse | Error | any | unknown;
-export type DyFM_NonHttpError = DyFM_Error | Error;
-export interface DyFM_Error_Settings {
-  _id?: string;
-  handled?: boolean;
-  status?: number;
-  errorCode?: string;
-  message?: string;
-  /** @deprecated use message instead */
-  userMessage?: string;
-  /** message translation code */
-  userMessageTranslateCode?: string;
-  addECToUserMsg?: boolean;
-  error?: DyFM_AnyError;
-  errors?: DyFM_AnyError[];
-  validationErrors?: DyFM_ValidationErrors;
-  issuer?: string;
-  issuerSystem?: string;
-  issuerService?: string;
-  systemVersion?: string;
-  level?: DyFM_ErrorLevel;
-  levelUpThis?: boolean;
-  additionalContent?: any;
-  confidentialContent?: any;
-  stack?: string;
-  allowCircular?: boolean;
-  modestLog?: boolean;
-  log?: boolean;
-  __localStack?: string;
-  __created?: Date;
-  __createdBy?: string;
-  __lastModified?: Date;
-  __lastModifiedBy?: string;
-  __v?: number;
-}
-export class DyFM_Error extends DyFM_Metadata {
-  readonly flag = DyFM_errorFlag + '-v2';
-  _errorCode?: string;
-  _errorCodes?: string[] = [];
-  /** contains all sub error messages, in reversed order */
-  _message?: string;
-  _messages?: string[] = [];
-  /** @deprecated use _message instead */
-  __userMessage?: string;
-  /** contains all sub error messages, in reversed order
-   * @deprecated use _messages instead
-  */
-  __userMessages?: string[] = [];
-  /** message translation code */
-  __userMessageTranslateCode?: string;
-  ___handled?: boolean;
-  ___logged?: boolean;
-  ___status?: number;
-  ___issuer?: string;
-  ___issuerSystem?: string;
-  ___issuerService?: string;
-  ___systemVersion?: string;
-  error?: DyFM_AnyError;
-  errors?: DyFM_AnyError[] = [];
-  validationErrors?: DyFM_ValidationErrors;
-  stack?: string;
-  __localStack?: string;
-  level?: DyFM_ErrorLevel;
-  levelUpThis?: boolean;
-  additionalContent?: any = {};
-  confidentialContent?: any = {};
-  constructor(
-    set?: DyFM_Error_Settings
-  ) {
-    super(
-      set,
-      {
-        issuer: set?.issuerService ??
-          (set?.error as DyFM_Error)?.___issuerService ??
-            DyFM_error_defaults.issuerService,
-      }
-    );
-    try {
-      if (!set) {
-        set = {};
-      }
-      /** set simple properties */
-      this.___handled = Boolean(set.handled ?? (set.error as DyFM_Error)?.___handled);
-      this.___status = set.status ?? (set.error as DyFM_Error)?.___status;
-      this.___issuer = set.issuer ??
-        (set.error as DyFM_Error)?.___issuer ??
-          DyFM_error_defaults.issuer;
-      this.___issuerSystem = set.issuerSystem ??
-        (set.error as DyFM_Error)?.___issuerSystem ??
-          DyFM_error_defaults.issuerSystem;
-      this.___issuerService = set.issuerService ??
-        (set.error as DyFM_Error)?.___issuerService ??
-          DyFM_error_defaults.issuerService;
-      this.___systemVersion = set.systemVersion ??
-        (set.error as DyFM_Error)?.___systemVersion ??
-          DyFM_error_defaults.systemVersion;
-      this.__localStack = (set as DyFM_Error)?.__localStack ??
-        (set.error as DyFM_Error)?.__localStack ??
-          DyFM_getLocalStackLocation();
-      this.validationErrors = set.validationErrors ?? (set.error as DyFM_Error)?.validationErrors;
-      this.level = set.level ?? (set.error as DyFM_Error)?.level ?? DyFM_ErrorLevel.error;
-      this.levelUpThis = set.levelUpThis;
-      set.allowCircular = set.allowCircular ??
-        set.additionalContent?.allowCircular ??
-        (set.error as DyFM_Error)?.additionalContent?.allowCircular ??
-        false;
-      if (set.allowCircular) {
-        this.additionalContent.allowCircular = true;
-      }
-      if (((set as DyFM_Error)?.error as DyFM_Error)?.___logged) {
-        this.___logged = true;
-      }
-      if (
-        !set.allowCircular &&
-        set.additionalContent &&
-        Object.keys(set.additionalContent)?.length
-      ) {
-        try {
-          JSON.stringify(set.additionalContent);
-        } catch {
-          DyFM_Log.error(
-            'Internal Dynamo ERROR: additionalContent is not JSON.stringifyable... ' +
-            '(it will be removed!)',
-            '\nerrorCode:', set.errorCode,
-            /* 'additionalContent:', set.additionalContent, */
-          );
-          delete set.additionalContent;
-        }
-      }
-      if (
-        !set.allowCircular &&
-        !set.additionalContent?.allowCircular &&
-        (set.error as DyFM_Error)?.additionalContent &&
-        !(set.error as DyFM_Error)?.additionalContent?.allowCircular &&
-        Object.keys((set.error as DyFM_Error)?.additionalContent)?.length
-      ) {
-        try {
-          JSON.stringify((set.error as DyFM_Error)?.additionalContent);
-        } catch {
-          DyFM_Log.error(
-            'Internal Dynamo ERROR: additionalContent is not JSON.stringifyable... ' +
-            '(it will be removed!)',
-            '\nerrorCode:', set.errorCode,
-            /* 'additionalContent:', (set.error as DyFM_Error)?.additionalContent, */
-          );
-          delete (set.error as DyFM_Error)?.additionalContent;
-        }
-      }
-      // ADDITIONAL CONTENT
-      if ((set.error as DyFM_Error)?.additionalContent) {
-        Object.assign(this.additionalContent, (set.error as DyFM_Error)?.additionalContent);
-      }
-      if (set.additionalContent) {
-        Object.assign(this.additionalContent, set.additionalContent);
-      }
-      // CONFIDENTIAL CONTENT
-      if ((set.error as DyFM_Error)?.confidentialContent) {
-        Object.assign(this.confidentialContent, (set.error as DyFM_Error)?.confidentialContent);
-      }
-      if (set.confidentialContent) {
-        Object.assign(this.confidentialContent, set.confidentialContent);
-      }
-      // ERROR CODE
-      if (!set.errorCode) {
-        set.errorCode = DyFM_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');
-      }
-       if ((set as DyFM_NonHttpError)?.stack) {
-        this.stack = (set as DyFM_NonHttpError)?.stack;
-      } else if ((set.error as DyFM_NonHttpError)?.stack) {
-        this.stack = (set.error as DyFM_NonHttpError)?.stack;
-      } else if (
-        (set.error as DyFM_HttpErrorResponse)?.name === DyFM_httpErrorResponse_name &&
-        (set.error as DyFM_HttpErrorResponse)?.error?.stack
-      ) {
-        this.stack = (set.error as DyFM_HttpErrorResponse)?.error?.stack;
-      } else {
-        this.stack = new Error().stack;
-      }
-      /** set errorCodes */
-      let previousErrorCodes: string[] = [];
-      if ((set.error as DyFM_Error)?._errorCodes) {
-        previousErrorCodes.push(...((set.error as DyFM_Error)?._errorCodes ?? []));
-      }
-      if (!set.errorCode) {
-        set.errorCode = DyFM_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 !== DyFM_error_defaults.errorCode &&
-          !DyFM_errorĐFlagParts.some((part: string): boolean => code.includes(part))
-      );
-      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 DyFM_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('\\');
-          if (posFull?.[posFull?.length - 1]) {
-            set.message = DyFM_error_defaults.message + '; ' + posFull[posFull.length - 1];
-          } else {
-            set.message = DyFM_error_defaults.message;
-          }
-        }
-      }
-      /** set messages */
-      let previousMessages: string[] = [];
-      if ((set.error as DyFM_Error)?._messages) {
-        previousMessages.push(...((set.error as DyFM_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] !== DyFM_error_defaults.message
-      ) {
-        this._message = this._messages[highlightedErrorCodeIndex];
-      } else {
-        this._message = this._messages?.[0];
-      }
-      /** @deprecated use _messages instead */
-      let previousUserMessages: string[] = [];
-      if ((set.error as DyFM_Error)?.__userMessages) {
-        previousUserMessages.push(...((set.error as DyFM_Error)?.__userMessages ?? []));
-      }
-      if (!set.userMessage) {
-        set.userMessage = DyFM_error_defaults.userMessage;
-      }
-      if (
-        set.addECToUserMsg &&
-        set.userMessage !== DyFM_error_defaults.userMessage &&
-        set.errorCode
-      ) {
-        set.userMessage += `\n  ErrorCode: ${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] !== DyFM_error_defaults.userMessage
-      ) {
-        this.__userMessage = this.__userMessages[highlightedErrorCodeIndex];
-      } else {
-        this.__userMessage = this.__userMessages.filter(
-          (msg: string): boolean => msg && msg !== DyFM_error_defaults.userMessage
-        )?.[0];
-      }
-      /** set userMessageTranslateCode */
-      set.userMessageTranslateCode =
-        set.userMessageTranslateCode ??
-          (set.error as DyFM_Error)?.__userMessageTranslateCode;
-      /** set errors */
-      let previousErrors: DyFM_AnyError[] = [];
-      if ((set.error as DyFM_Error)?.errors?.length) {
-        previousErrors.push(...(set.error as DyFM_Error).errors);
-      } else if (typeof (set.error as DyFM_Error)?.errors == 'object') {
-        this.additionalContent.errors = (set.error as DyFM_Error).errors;
-      }
-      previousErrors = previousErrors.filter(
-        (error: DyFM_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 = this.errors.map((subError: DyFM_AnyError): any => {
-        if ((subError as DyFM_Error)?.errors) {
-          subError = { ...subError } as DyFM_Error;
-          delete subError.errors;
-          delete subError.additionalContent;
-        }
-        if (((subError as DyFM_Error).error as DyFM_Error)?.errors) {
-          (subError as DyFM_Error).error = { ...(subError as DyFM_Error).error } as DyFM_Error;
-          delete ((subError as DyFM_Error).error as DyFM_Error).errors;
-          delete ((subError as DyFM_Error).error as DyFM_Error).additionalContent;
-        }
-        return subError;
-      });
-      this.errors = this.errors.filter((error: DyFM_AnyError): boolean =>
-        Boolean(error) && (error instanceof Error || Boolean(Object.keys(error).length))
-      );
-      DyFM_Object.safeCleanObject(this);
-      if (!set.allowCircular) {
-        this.errors = this.errors.filter((subError: DyFM_AnyError): boolean => {
-          if (subError instanceof Error) {
-            return true;
-          }
-          try {
-            JSON.stringify(subError);
-            return true;
-          } catch (error) {
-            DyFM_Log.error(
-              'Internal Dynamo ERROR: error is not JSON.stringifyable... ' +
-              '(it will be removed!)',
-              '\nerrorCode:', (subError as DyFM_Error)?._errorCode,
-            );
-            return false;
-          }
-        });
-      }
-      if (set.modestLog) {
-        console.error(this._message ?? this.__userMessage ?? this.error);
-      }
-      if (set.log) {
-        console.error(this);
-      }
-    } catch (error) {
-      DyFM_Log.H_error(
-        'Internal Dynamo ERROR: Failed to create DyFM_Error...' +
-        'error:\n', error,
-        'stack:', new Error().stack,
-        'set:', set
-      );
-    }
-  }
-  getErrorSimplified(): DyFM_Error_Settings {
-    return {
-      errorCode: this._errorCode,
-      message: this._message,
-      userMessage: this.__userMessage,
-      stack: this.stack,
-    };
-  }
-  getErrorsFlat(): DyFM_Error {
-    const error: any = { ...this };
-    if ((error.error as DyFM_Error)?.error) {
-      delete (error.error as DyFM_Error).error;
-    }
-    if ((error.error as DyFM_Error)?.errors) {
-      delete (error.error as DyFM_Error).errors;
-    }
-    error.errors = error.errors.map(
-      (subError: DyFM_Error): Partial<DyFM_Error> =>
-        error instanceof Error ? error : ({ ...subError })
-    );
-    error.errors.forEach((subError: DyFM_Error): void => {
-      if (subError.errors) {
-        delete subError.errors;
-      }
-      if ((subError.error as DyFM_Error)?.errors) {
-        delete (subError.error as DyFM_Error).errors;
-      }
-      if ((subError.error as DyFM_Error)?.error) {
-        delete (subError.error as DyFM_Error).error;
-      }
-      if (subError.additionalContent) {
-        delete subError.additionalContent;
-      }
-    });
-    return error;
-  }
-  logShort(
-    title: string,
-    setLog?: boolean,
-    forceLog?: boolean,
-    /* logType?: DyFM_Log_Type, */
-  ): void {
-    if (this.___logged && !forceLog) {
-      DyFM_Log.warn(`logShort: already logged (${this._errorCode})`);
-      return;
-    }
-    /* switch (logType) { */
-    DyFM_Log.testError(
-      title,
-      '\n    ErrorCode:', this._errorCode,
-      '\n    Message:', this._message?.replaceAll?.('\n', '\n      '),
-    );
-    if (setLog) {
-      this.___logged = true;
-    }
-  }
-  warnShort(
-    title: string,
-    setLog?: boolean,
-    forceLog?: boolean,
-  ): void {
-    if (this.___logged && !forceLog) {
-      DyFM_Log.warn(`warnShort: already logged (${this._errorCode})`);
-      return;
-    }
-    DyFM_Log.testWarn(
-      title,
-      '\n    ErrorCode:', this._errorCode,
-      '\n    Message:', this._message?.replaceAll?.('\n', '\n      '),
-    );
-    if (setLog) {
-      this.___logged = true;
-    }
-  }
-  logSimple(
-    title: string,
-    logAdditionalContent?: boolean,
-    forceLog?: boolean,
-    logNodeModules?: boolean
-  ): void {
-    if (this.___logged && !forceLog) {
-      DyFM_Log.warn(`logSimple: already logged ${title} (${this._message}; ${this._errorCode})`);
-      return;
-    }
-    // remove node_modules from stack and replace with '...'
-    /* const stack: string = this.stack?.split?.('\n').map((line: string): string => {
-      if (line.includes('node_modules')) {
-        return '...';
-      }
-      return line;
-    }).filter((line: string, index: number, array: string[]): boolean => {
-      if (line === '...' && index < array.length - 1 && array[index + 1] === '...') {
-        return false;
-      }
-      return true;
-    }).join('\n'); */
-    DyFM_Log.H_error(
-      title,
-      `\n${DyFM_Log.errorStyle}ErrorCode:`, this._errorCode,
-      `\n${DyFM_Log.errorStyle}${DyFM_LogStyle.bold}Message:`,
-        this._message?.replaceAll?.('\n', '\n      '),
-      `\n\n${DyFM_LogStyle.reset}${DyFM_Log.errorStyle}UserMessage:`,
-        this.__userMessage?.replaceAll?.('\n', '\n      '),
-          this.__localStack ?
-            `\n${DyFM_Log.errorStyle}LocalStack:\n      ` + this.__localStack : '',
-      `\n\n${DyFM_Log.errorStyle}Stack:`, this.stack?.replaceAll?.('\n', '\n  '),
-        logAdditionalContent && this.additionalContent ?
-          `\n\n${DyFM_Log.errorStyle}AdditionalContent:\n` + this.additionalContent : '',
-    );
-    this.___logged = true;
-  }
-  /* static getSimpleLogContent(error: DyFM_Error): string {
-    return `\n${DyFM_Log.errorStyle}ErrorCode:`, this._errorCode,
-      `\n${DyFM_Log.errorStyle}${DyFM_LogStyle.bold}Message:`,
-        this._message?.replaceAll?.('\n', '\n      '),
-      `\n\n${DyFM_LogStyle.reset}${DyFM_Log.errorStyle}UserMessage:`,
-        this.__userMessage?.replaceAll?.('\n', '\n      '),
-          this.__localStack ?
-            `\n${DyFM_Log.errorStyle}LocalStack:\n      ` + this.__localStack : '',
-      `\n\n${DyFM_Log.errorStyle}Stack:`, this.stack?.replaceAll?.('\n', '\n  '),
-        logAdditionalContent && this.additionalContent ?
-          `\n\n${DyFM_Log.errorStyle}AdditionalContent:\n` + this.additionalContent : '' */
-  /**
-   * Checks if the error is parsable,
-   * simplifies the error,
-   * and returns the error as a string.
-   */
-  getParsable(): string {
-    try {
-      const flat = this.getErrorsFlat();
-      return JSON.stringify(flat);
-    } catch (error) {
-      DyFM_Log.error('Error getting parsable error', error);
-      return JSON.stringify(this.getErrorSimplified());
-    }
-  }
-  static logSimple(message: string, error: DyFM_AnyError): void {
-    if (error instanceof DyFM_Error) {
-      error.logSimple(message);
-    } else {
-      DyFM_Log.T_error(message, error);
-    }
-  }
-  static getErrorMessage(error: DyFM_AnyError): string {
-    return (error as DyFM_Error)?._message ??
-      (error as Error)?.message ??
-      ((error as DyFM_HttpErrorResponse)?.error as DyFM_Error)?._message ??
-      ((error as DyFM_HttpErrorResponse)?.error as Error)?.message;
-  }
-  /**
-   * Returns the message of the error.
-   * Returns the userMessage if the message is not set.
-   * (prioritizes the message over the userMessage)
-   */
-  static getAnyMessage(error: DyFM_AnyError): string {
-    return this.getErrorMessage(error) ?? this.getUserMessage(error);
-  }
-  static getUserMessage(error: DyFM_AnyError): string {
-    return (error as DyFM_Error)?.__userMessage ??
-      ((error as DyFM_HttpErrorResponse)?.error as DyFM_Error)?.__userMessage ??
-      (error as DyFM_Error_Settings)?.userMessage;
-  }
-  /**
-   * Returns the user message of the error.
-   * Returns the message if the userMessage is not set.
-   * (prioritizes the userMessage over the message)
-   */
-  static getAnyUserMessage(error: DyFM_AnyError): string {
-    return this.getUserMessage(error) ?? this.getErrorMessage(error);
-  }
-  /**
-   * A hiba szemantikus szöveges változata: saját üzenet + zárójelben a _messages lista első eleme
-   * (gyökér Dynamo Error üzenete), ha van lánc. Nem az object láncon járunk végig, a _messages-t használjuk.
-   */
-  static getSemanticMessage(error: DyFM_AnyError): string {
-    const ourMessage: string = this.getErrorMessage(error);
-    if (!this.isDyFMError(error)) {
-      return ourMessage;
-    }
-    const messages: string[] | undefined = (error as DyFM_Error)._messages;
-    const firstMessage: string | undefined =
-      messages && messages.length > 1 ? messages[0] : undefined;
-    if (firstMessage && firstMessage !== ourMessage) {
-      return `${ourMessage} (${firstMessage})`;
-    }
-    return ourMessage;
-  }
-  static getErrorStatus(error: DyFM_AnyError): number {
-    return (error as DyFM_Error)?.___status ??
-      (error as DyFM_HttpErrorResponse)?.status ??
-      ((error as DyFM_HttpErrorResponse)?.error as DyFM_Error)?.___status ?? 500;
-  }
-  static getErrorCode(error: DyFM_AnyError): string {
-    return (error as DyFM_Error)?._errorCode ??
-      ((error as DyFM_HttpErrorResponse)?.error as DyFM_Error)?._errorCode ??
-      (error as any)?.errorCode ??
-      (error as any)?.error?.errorCode ??
-      (error as any)?.code ??
-      (error as any)?.error?.code;
-  }
-  static getErrorStack(error: DyFM_AnyError): string {
-    return (error as DyFM_Error)?.stack ??
-      ((error as DyFM_HttpErrorResponse)?.error as DyFM_NonHttpError)?.stack;
-  }
-  static isDyFMError(error: any): error is DyFM_Error {
-    return (error as DyFM_Error)?.flag?.includes('DYNAMO');
-  }
-  static isAnyDyFMError(error: any): error is DyFM_AnyError {
-    return this.isDyFMError(error) ||
-      (error as DyFM_HttpErrorResponse)?.name === DyFM_httpErrorResponse_name ||
-      error instanceof Error;
-  }
-  static deleteErrorContent(error: DyFM_Error): void {
-    delete error.confidentialContent;
-    delete error.additionalContent;
-    delete error.error;
-    delete error.errors;
-    delete error.stack;
-  }
-  static getStatusText(status: number): string {
-    switch (status) {
-      case 100:
-        return 'Continue';
-      case 101:
-        return 'Switching Protocols';
-      case 102:
-        return 'Processing';
-      case 103:
-        return 'Early Hints';
-      case 200:
-        return 'OK';
-      case 201:
-        return 'Created';
-      case 202:
-        return 'Accepted';
-      case 203:
-        return 'Non-Authoritative Information';
-      case 204:
-        return 'No Content';
-      case 205:
-        return 'Reset Content';
-      case 206:
-        return 'Partial Content';
-      case 207:
-        return 'Multi-Status';
-      case 208:
-        return 'Already Reported';
-      case 226:
-        return 'IM Used';
-      case 300:
-        return 'Multiple Choices';
-      case 301:
-        return 'Moved Permanently';
-      case 302:
-        return 'Found';
-      case 303:
-        return 'See Other';
-      case 304:
-        return 'Not Modified';
-      case 305:
-        return 'Use Proxy';
-      case 306:
-        return 'Switch Proxy';
-      case 307:
-        return 'Temporary Redirect';
-      case 308:
-        return 'Permanent Redirect';
-      case 400:
-        return 'Bad Request';
-      case 401:
-        return 'Unauthorized';
-      case 402:
-        return 'Payment Required';
-      case 403:
-        return 'Forbidden';
-      case 404:
-        return 'Not Found';
-      case 405:
-        return 'Method Not Allowed';
-      case 406:
-        return 'Not Acceptable';
-      case 407:
-        return 'Proxy Authentication Required';
-      case 408:
-        return 'Request Timeout';
-      case 409:
-        return 'Conflict';
-      case 410:
-        return 'Gone';
-      case 411:
-        return 'Length Required';
-      case 412:
-        return 'Precondition Failed';
-      case 413:
-        return 'Payload Too Large';
-      case 414:
-        return 'URI Too Long';
-      case 415:
-        return 'Unsupported Media Type';
-      case 416:
-        return 'Range Not Satisfiable';
-      case 417:
-        return 'Expectation Failed';
-      case 418:
-        return "I'm a teapot";
-      case 421:
-        return 'Misdirected Request';
-      case 422:
-        return 'Unprocessable Entity';
-      case 423:
-        return 'Locked';
-      case 424:
-        return 'Failed Dependency';
-      case 425:
-        return 'Too Early';
-      case 426:
-        return 'Upgrade Required';
-      case 428:
-        return 'Precondition Required';
-      case 429:
-        return 'Too Many Requests';
-      case 431:
-        return 'Request Header Fields Too Large';
-      case 451:
-        return 'Unavailable For Legal Reasons';
-      case 500:
-        return 'Internal Server Error';
-      case 501:
-        return 'Not Implemented';
-      case 502:
-        return 'Bad Gateway';
-      case 503:
-        return 'Service Unavailable';
-      case 504:
-        return 'Gateway Timeout';
-      case 505:
-        return 'HTTP Version Not Supported';
-      case 506:
-        return 'Variant Also Negotiates';
-      case 507:
-        return 'Insufficient Storage';
-      case 508:
-        return 'Loop Detected';
-      case 510:
-        return 'Not Extended';
-      case 511:
-        return 'Network Authentication Required';
-      default:
-        return 'Unknown';
-    }
-  }
-}
-/*
-//                  //
-// 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 n network 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)
-  440 Login Time-out
-  444 No Response
-  449 Retry With
-  450 Blocked by Windows Parental Controls (Microsoft)
-  451 Redirect
-  494 Request header too large
-  495 SSL Certificate Error
-  496 SSL Certificate Required
-  497 HTTP Request Sent to HTTPS Port
-  498 Invalid Token (Esri)
-  499 Client Closed Request
-  499 Token Required (Esri)
-  509 Bandwidth Limit Exceeded (Apache Web Server/cPanel)
-  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
-  529 Site is overloaded
-  530 Site is frozen
-  598 (Informal convention) Network read timeout 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 { DyFM_error_defaults } from '../../_collections/constants/error-defaults.const';
+import { DyFM_Log } from '../../_collections/utils/log.util';
+import { DyFM_Object } from '../../_collections/utils/object.util';
+import { DyFM_getLocalStackLocation } from '../../_collections/utils/stack.util';
+import { DyFM_ErrorLevel } from '../../_enums/error-level.enum';
+import { DyFM_LogStyle } from '../../_enums/log-style.enum';
+import { DyFM_Metadata } from '../data-models/metadata.data-model';
+import { DyFM_HttpErrorResponse, DyFM_httpErrorResponse_name } from './http/http-error-response.control-model';
+export const DyFM_errorFlag = 'DYNAMO-ERROR-OBJECT';
+export const DyFM_errorĐFlagParts= [
+  'DyNTS-',
+  'DyFM-',
+  'DyNX_',
+  'DyNM_',
+  'DyBu_',
+  'DyCLI_',
+]
+export interface DyFM_ValidationError {
+  message: string;
+  /** @deprecated use message instead */
+  userMessage?: string;
+  code: string;
+}
+export type DyFM_ValidationErrors = {
+  [key: string]: DyFM_ValidationError;
+}
+export type DyFM_AnyError = DyFM_Error | DyFM_HttpErrorResponse | Error | any | unknown;
+export type DyFM_NonHttpError = DyFM_Error | Error;
+export interface DyFM_Error_Settings {
+  _id?: string;
+  handled?: boolean;
+  status?: number;
+  errorCode?: string;
+  message?: string;
+  /** @deprecated use message instead */
+  userMessage?: string;
+  /** message translation code */
+  userMessageTranslateCode?: string;
+  addECToUserMsg?: boolean;
+  error?: DyFM_AnyError;
+  errors?: DyFM_AnyError[];
+  validationErrors?: DyFM_ValidationErrors;
+  issuer?: string;
+  issuerSystem?: string;
+  issuerService?: string;
+  systemVersion?: string;
+  level?: DyFM_ErrorLevel;
+  levelUpThis?: boolean;
+  additionalContent?: any;
+  confidentialContent?: any;
+  stack?: string;
+  allowCircular?: boolean;
+  modestLog?: boolean;
+  log?: boolean;
+  __localStack?: string;
+  __created?: Date;
+  __createdBy?: string;
+  __lastModified?: Date;
+  __lastModifiedBy?: string;
+  __v?: number;
+}
+export class DyFM_Error extends DyFM_Metadata {
+  readonly flag = DyFM_errorFlag + '-v2';
+  _errorCode?: string;
+  _errorCodes?: string[] = [];
+  /** contains all sub error messages, in reversed order */
+  _message?: string;
+  _messages?: string[] = [];
+  /** @deprecated use _message instead */
+  __userMessage?: string;
+  /** contains all sub error messages, in reversed order
+   * @deprecated use _messages instead
+  */
+  __userMessages?: string[] = [];
+  /** message translation code */
+  __userMessageTranslateCode?: string;
+  ___handled?: boolean;
+  ___logged?: boolean;
+  ___status?: number;
+  ___issuer?: string;
+  ___issuerSystem?: string;
+  ___issuerService?: string;
+  ___systemVersion?: string;
+  error?: DyFM_AnyError;
+  errors?: DyFM_AnyError[] = [];
+  validationErrors?: DyFM_ValidationErrors;
+  stack?: string;
+  __localStack?: string;
+  level?: DyFM_ErrorLevel;
+  levelUpThis?: boolean;
+  additionalContent?: any = {};
+  confidentialContent?: any = {};
+  constructor(
+    set?: DyFM_Error_Settings
+  ) {
+    super(
+      set,
+      {
+        issuer: set?.issuerService ??
+          (set?.error as DyFM_Error)?.___issuerService ??
+            DyFM_error_defaults.issuerService,
+      }
+    );
+    try {
+      if (!set) {
+        set = {};
+      }
+      /** set simple properties */
+      this.___handled = Boolean(set.handled ?? (set.error as DyFM_Error)?.___handled);
+      this.___status = set.status ?? (set.error as DyFM_Error)?.___status;
+      this.___issuer = set.issuer ??
+        (set.error as DyFM_Error)?.___issuer ??
+          DyFM_error_defaults.issuer;
+      this.___issuerSystem = set.issuerSystem ??
+        (set.error as DyFM_Error)?.___issuerSystem ??
+          DyFM_error_defaults.issuerSystem;
+      this.___issuerService = set.issuerService ??
+        (set.error as DyFM_Error)?.___issuerService ??
+          DyFM_error_defaults.issuerService;
+      this.___systemVersion = set.systemVersion ??
+        (set.error as DyFM_Error)?.___systemVersion ??
+          DyFM_error_defaults.systemVersion;
+      this.__localStack = (set as DyFM_Error)?.__localStack ??
+        (set.error as DyFM_Error)?.__localStack ??
+          DyFM_getLocalStackLocation();
+      this.validationErrors = set.validationErrors ?? (set.error as DyFM_Error)?.validationErrors;
+      this.level = set.level ?? (set.error as DyFM_Error)?.level ?? DyFM_ErrorLevel.error;
+      this.levelUpThis = set.levelUpThis;
+      set.allowCircular = set.allowCircular ??
+        set.additionalContent?.allowCircular ??
+        (set.error as DyFM_Error)?.additionalContent?.allowCircular ??
+        false;
+      if (set.allowCircular) {
+        this.additionalContent.allowCircular = true;
+      }
+      if (((set as DyFM_Error)?.error as DyFM_Error)?.___logged) {
+        this.___logged = true;
+      }
+      if (
+        !set.allowCircular &&
+        set.additionalContent &&
+        Object.keys(set.additionalContent)?.length
+      ) {
+        try {
+          JSON.stringify(set.additionalContent);
+        } catch {
+          DyFM_Log.error(
+            'Internal Dynamo ERROR: additionalContent is not JSON.stringifyable... ' +
+            '(it will be removed!)',
+            '\nerrorCode:', set.errorCode,
+            /* 'additionalContent:', set.additionalContent, */
+          );
+          delete set.additionalContent;
+        }
+      }
+      if (
+        !set.allowCircular &&
+        !set.additionalContent?.allowCircular &&
+        (set.error as DyFM_Error)?.additionalContent &&
+        !(set.error as DyFM_Error)?.additionalContent?.allowCircular &&
+        Object.keys((set.error as DyFM_Error)?.additionalContent)?.length
+      ) {
+        try {
+          JSON.stringify((set.error as DyFM_Error)?.additionalContent);
+        } catch {
+          DyFM_Log.error(
+            'Internal Dynamo ERROR: additionalContent is not JSON.stringifyable... ' +
+            '(it will be removed!)',
+            '\nerrorCode:', set.errorCode,
+            /* 'additionalContent:', (set.error as DyFM_Error)?.additionalContent, */
+          );
+          delete (set.error as DyFM_Error)?.additionalContent;
+        }
+      }
+      // ADDITIONAL CONTENT
+      if ((set.error as DyFM_Error)?.additionalContent) {
+        Object.assign(this.additionalContent, (set.error as DyFM_Error)?.additionalContent);
+      }
+      if (set.additionalContent) {
+        Object.assign(this.additionalContent, set.additionalContent);
+      }
+      // CONFIDENTIAL CONTENT
+      if ((set.error as DyFM_Error)?.confidentialContent) {
+        Object.assign(this.confidentialContent, (set.error as DyFM_Error)?.confidentialContent);
+      }
+      if (set.confidentialContent) {
+        Object.assign(this.confidentialContent, set.confidentialContent);
+      }
+      // ERROR CODE
+      if (!set.errorCode) {
+        set.errorCode = DyFM_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');
+      }
+       if ((set as DyFM_NonHttpError)?.stack) {
+        this.stack = (set as DyFM_NonHttpError)?.stack;
+      } else if ((set.error as DyFM_NonHttpError)?.stack) {
+        this.stack = (set.error as DyFM_NonHttpError)?.stack;
+      } else if (
+        (set.error as DyFM_HttpErrorResponse)?.name === DyFM_httpErrorResponse_name &&
+        (set.error as DyFM_HttpErrorResponse)?.error?.stack
+      ) {
+        this.stack = (set.error as DyFM_HttpErrorResponse)?.error?.stack;
+      } else {
+        this.stack = new Error().stack;
+      }
+      /** set errorCodes */
+      let previousErrorCodes: string[] = [];
+      if ((set.error as DyFM_Error)?._errorCodes) {
+        previousErrorCodes.push(...((set.error as DyFM_Error)?._errorCodes ?? []));
+      }
+      if (!set.errorCode) {
+        set.errorCode = DyFM_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 !== DyFM_error_defaults.errorCode &&
+          !DyFM_errorĐFlagParts.some((part: string): boolean => code.includes(part))
+      );
+      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 DyFM_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('\\');
+          if (posFull?.[posFull?.length - 1]) {
+            set.message = DyFM_error_defaults.message + '; ' + posFull[posFull.length - 1];
+          } else {
+            set.message = DyFM_error_defaults.message;
+          }
+        }
+      }
+      /** set messages */
+      let previousMessages: string[] = [];
+      if ((set.error as DyFM_Error)?._messages) {
+        previousMessages.push(...((set.error as DyFM_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] !== DyFM_error_defaults.message
+      ) {
+        this._message = this._messages[highlightedErrorCodeIndex];
+      } else {
+        this._message = this._messages?.[0];
+      }
+      /** @deprecated use _messages instead */
+      let previousUserMessages: string[] = [];
+      if ((set.error as DyFM_Error)?.__userMessages) {
+        previousUserMessages.push(...((set.error as DyFM_Error)?.__userMessages ?? []));
+      }
+      if (!set.userMessage) {
+        set.userMessage = DyFM_error_defaults.userMessage;
+      }
+      if (
+        set.addECToUserMsg &&
+        set.userMessage !== DyFM_error_defaults.userMessage &&
+        set.errorCode
+      ) {
+        set.userMessage += `\n  ErrorCode: ${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] !== DyFM_error_defaults.userMessage
+      ) {
+        this.__userMessage = this.__userMessages[highlightedErrorCodeIndex];
+      } else {
+        this.__userMessage = this.__userMessages.filter(
+          (msg: string): boolean => msg && msg !== DyFM_error_defaults.userMessage
+        )?.[0];
+      }
+      /** set userMessageTranslateCode */
+      set.userMessageTranslateCode =
+        set.userMessageTranslateCode ??
+          (set.error as DyFM_Error)?.__userMessageTranslateCode;
+      /** set errors */
+      let previousErrors: DyFM_AnyError[] = [];
+      if ((set.error as DyFM_Error)?.errors?.length) {
+        previousErrors.push(...(set.error as DyFM_Error).errors);
+      } else if (typeof (set.error as DyFM_Error)?.errors == 'object') {
+        this.additionalContent.errors = (set.error as DyFM_Error).errors;
+      }
+      previousErrors = previousErrors.filter(
+        (error: DyFM_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 = this.errors.map((subError: DyFM_AnyError): any => {
+        if ((subError as DyFM_Error)?.errors) {
+          subError = { ...subError } as DyFM_Error;
+          delete subError.errors;
+          delete subError.additionalContent;
+        }
+        if (((subError as DyFM_Error).error as DyFM_Error)?.errors) {
+          (subError as DyFM_Error).error = { ...(subError as DyFM_Error).error } as DyFM_Error;
+          delete ((subError as DyFM_Error).error as DyFM_Error).errors;
+          delete ((subError as DyFM_Error).error as DyFM_Error).additionalContent;
+        }
+        return subError;
+      });
+      this.errors = this.errors.filter((error: DyFM_AnyError): boolean =>
+        Boolean(error) && (error instanceof Error || Boolean(Object.keys(error).length))
+      );
+      DyFM_Object.safeCleanObject(this);
+      if (!set.allowCircular) {
+        this.errors = this.errors.filter((subError: DyFM_AnyError): boolean => {
+          if (subError instanceof Error) {
+            return true;
+          }
+          try {
+            JSON.stringify(subError);
+            return true;
+          } catch (error) {
+            DyFM_Log.error(
+              'Internal Dynamo ERROR: error is not JSON.stringifyable... ' +
+              '(it will be removed!)',
+              '\nerrorCode:', (subError as DyFM_Error)?._errorCode,
+            );
+            return false;
+          }
+        });
+      }
+      if (set.modestLog) {
+        console.error(this._message ?? this.__userMessage ?? this.error);
+      }
+      if (set.log) {
+        console.error(this);
+      }
+    } catch (error) {
+      DyFM_Log.H_error(
+        'Internal Dynamo ERROR: Failed to create DyFM_Error...' +
+        'error:\n', error,
+        'stack:', new Error().stack,
+        'set:', set
+      );
+    }
+  }
+  getErrorSimplified(): DyFM_Error_Settings {
+    return {
+      errorCode: this._errorCode,
+      message: this._message,
+      userMessage: this.__userMessage,
+      stack: this.stack,
+    };
+  }
+  getErrorsFlat(): DyFM_Error {
+    const error: any = { ...this };
+    if ((error.error as DyFM_Error)?.error) {
+      delete (error.error as DyFM_Error).error;
+    }
+    if ((error.error as DyFM_Error)?.errors) {
+      delete (error.error as DyFM_Error).errors;
+    }
+    error.errors = error.errors.map(
+      (subError: DyFM_Error): Partial<DyFM_Error> =>
+        error instanceof Error ? error : ({ ...subError })
+    );
+    error.errors.forEach((subError: DyFM_Error): void => {
+      if (subError.errors) {
+        delete subError.errors;
+      }
+      if ((subError.error as DyFM_Error)?.errors) {
+        delete (subError.error as DyFM_Error).errors;
+      }
+      if ((subError.error as DyFM_Error)?.error) {
+        delete (subError.error as DyFM_Error).error;
+      }
+      if (subError.additionalContent) {
+        delete subError.additionalContent;
+      }
+    });
+    return error;
+  }
+  logShort(
+    title: string,
+    setLog?: boolean,
+    forceLog?: boolean,
+    /* logType?: DyFM_Log_Type, */
+  ): void {
+    if (this.___logged && !forceLog) {
+      DyFM_Log.warn(`logShort: already logged (${this._errorCode})`);
+      return;
+    }
+    /* switch (logType) { */
+    DyFM_Log.testError(
+      title,
+      '\n    ErrorCode:', this._errorCode,
+      '\n    Message:', this._message?.replaceAll?.('\n', '\n      '),
+    );
+    if (setLog) {
+      this.___logged = true;
+    }
+  }
+  warnShort(
+    title: string,
+    setLog?: boolean,
+    forceLog?: boolean,
+  ): void {
+    if (this.___logged && !forceLog) {
+      DyFM_Log.warn(`warnShort: already logged (${this._errorCode})`);
+      return;
+    }
+    DyFM_Log.testWarn(
+      title,
+      '\n    ErrorCode:', this._errorCode,
+      '\n    Message:', this._message?.replaceAll?.('\n', '\n      '),
+    );
+    if (setLog) {
+      this.___logged = true;
+    }
+  }
+  logSimple(
+    title: string,
+    logAdditionalContent?: boolean,
+    forceLog?: boolean,
+    logNodeModules?: boolean
+  ): void {
+    if (this.___logged && !forceLog) {
+      DyFM_Log.warn(`logSimple: already logged ${title} (${this._message}; ${this._errorCode})`);
+      return;
+    }
+    // remove node_modules from stack and replace with '...'
+    /* const stack: string = this.stack?.split?.('\n').map((line: string): string => {
+      if (line.includes('node_modules')) {
+        return '...';
+      }
+      return line;
+    }).filter((line: string, index: number, array: string[]): boolean => {
+      if (line === '...' && index < array.length - 1 && array[index + 1] === '...') {
+        return false;
+      }
+      return true;
+    }).join('\n'); */
+    DyFM_Log.H_error(
+      title,
+      `\n${DyFM_Log.errorStyle}ErrorCode:`, this._errorCode,
+      `\n${DyFM_Log.errorStyle}${DyFM_LogStyle.bold}Message:`,
+        this._message?.replaceAll?.('\n', '\n      '),
+      `\n\n${DyFM_LogStyle.reset}${DyFM_Log.errorStyle}UserMessage:`,
+        this.__userMessage?.replaceAll?.('\n', '\n      '),
+          this.__localStack ?
+            `\n${DyFM_Log.errorStyle}LocalStack:\n      ` + this.__localStack : '',
+      `\n\n${DyFM_Log.errorStyle}Stack:`, this.stack?.replaceAll?.('\n', '\n  '),
+        logAdditionalContent && this.additionalContent ?
+          `\n\n${DyFM_Log.errorStyle}AdditionalContent:\n` + this.additionalContent : '',
+    );
+    this.___logged = true;
+  }
+  /* static getSimpleLogContent(error: DyFM_Error): string {
+    return `\n${DyFM_Log.errorStyle}ErrorCode:`, this._errorCode,
+      `\n${DyFM_Log.errorStyle}${DyFM_LogStyle.bold}Message:`,
+        this._message?.replaceAll?.('\n', '\n      '),
+      `\n\n${DyFM_LogStyle.reset}${DyFM_Log.errorStyle}UserMessage:`,
+        this.__userMessage?.replaceAll?.('\n', '\n      '),
+          this.__localStack ?
+            `\n${DyFM_Log.errorStyle}LocalStack:\n      ` + this.__localStack : '',
+      `\n\n${DyFM_Log.errorStyle}Stack:`, this.stack?.replaceAll?.('\n', '\n  '),
+        logAdditionalContent && this.additionalContent ?
+          `\n\n${DyFM_Log.errorStyle}AdditionalContent:\n` + this.additionalContent : '' */
+  /**
+   * Checks if the error is parsable,
+   * simplifies the error,
+   * and returns the error as a string.
+   */
+  getParsable(): string {
+    try {
+      const flat = this.getErrorsFlat();
+      return JSON.stringify(flat);
+    } catch (error) {
+      DyFM_Log.error('Error getting parsable error', error);
+      return JSON.stringify(this.getErrorSimplified());
+    }
+  }
+  static logSimple(message: string, error: DyFM_AnyError): void {
+    if (error instanceof DyFM_Error) {
+      error.logSimple(message);
+    } else {
+      DyFM_Log.T_error(message, error);
+    }
+  }
+  static getErrorMessage(error: DyFM_AnyError): string {
+    return (error as DyFM_Error)?._message ??
+      (error as Error)?.message ??
+      ((error as DyFM_HttpErrorResponse)?.error as DyFM_Error)?._message ??
+      ((error as DyFM_HttpErrorResponse)?.error as Error)?.message;
+  }
+  /**
+   * Returns the message of the error.
+   * Returns the userMessage if the message is not set.
+   * (prioritizes the message over the userMessage)
+   */
+  static getAnyMessage(error: DyFM_AnyError): string {
+    return this.getErrorMessage(error) ?? this.getUserMessage(error);
+  }
+  static getUserMessage(error: DyFM_AnyError): string {
+    return (error as DyFM_Error)?.__userMessage ??
+      ((error as DyFM_HttpErrorResponse)?.error as DyFM_Error)?.__userMessage ??
+      (error as DyFM_Error_Settings)?.userMessage;
+  }
+  /**
+   * Returns the user message of the error.
+   * Returns the message if the userMessage is not set.
+   * (prioritizes the userMessage over the message)
+   */
+  static getAnyUserMessage(error: DyFM_AnyError): string {
+    return this.getUserMessage(error) ?? this.getErrorMessage(error);
+  }
+  /**
+   * A hiba szemantikus szöveges változata: saját üzenet + zárójelben a _messages lista első eleme
+   * (gyökér Dynamo Error üzenete), ha van lánc. Nem az object láncon járunk végig, a _messages-t használjuk.
+   */
+  static getSemanticMessage(error: DyFM_AnyError): string {
+    const ourMessage: string = this.getErrorMessage(error);
+    if (!this.isDyFMError(error)) {
+      return ourMessage;
+    }
+    const messages: string[] | undefined = (error as DyFM_Error)._messages;
+    const firstMessage: string | undefined =
+      messages && messages.length > 1 ? messages[0] : undefined;
+    if (firstMessage && firstMessage !== ourMessage) {
+      return `${ourMessage} (${firstMessage})`;
+    }
+    return ourMessage;
+  }
+  static getErrorStatus(error: DyFM_AnyError): number {
+    return (error as DyFM_Error)?.___status ??
+      (error as DyFM_HttpErrorResponse)?.status ??
+      ((error as DyFM_HttpErrorResponse)?.error as DyFM_Error)?.___status ?? 500;
+  }
+  static getErrorCode(error: DyFM_AnyError): string {
+    return (error as DyFM_Error)?._errorCode ??
+      ((error as DyFM_HttpErrorResponse)?.error as DyFM_Error)?._errorCode ??
+      (error as any)?.errorCode ??
+      (error as any)?.error?.errorCode ??
+      (error as any)?.code ??
+      (error as any)?.error?.code;
+  }
+  static getErrorStack(error: DyFM_AnyError): string {
+    return (error as DyFM_Error)?.stack ??
+      ((error as DyFM_HttpErrorResponse)?.error as DyFM_NonHttpError)?.stack;
+  }
+  static isDyFMError(error: any): error is DyFM_Error {
+    return (error as DyFM_Error)?.flag?.includes('DYNAMO');
+  }
+  static isAnyDyFMError(error: any): error is DyFM_AnyError {
+    return this.isDyFMError(error) ||
+      (error as DyFM_HttpErrorResponse)?.name === DyFM_httpErrorResponse_name ||
+      error instanceof Error;
+  }
+  static deleteErrorContent(error: DyFM_Error): void {
+    delete error.confidentialContent;
+    delete error.additionalContent;
+    delete error.error;
+    delete error.errors;
+    delete error.stack;
+  }
+  static getStatusText(status: number): string {
+    switch (status) {
+      case 100:
+        return 'Continue';
+      case 101:
+        return 'Switching Protocols';
+      case 102:
+        return 'Processing';
+      case 103:
+        return 'Early Hints';
+      case 200:
+        return 'OK';
+      case 201:
+        return 'Created';
+      case 202:
+        return 'Accepted';
+      case 203:
+        return 'Non-Authoritative Information';
+      case 204:
+        return 'No Content';
+      case 205:
+        return 'Reset Content';
+      case 206:
+        return 'Partial Content';
+      case 207:
+        return 'Multi-Status';
+      case 208:
+        return 'Already Reported';
+      case 226:
+        return 'IM Used';
+      case 300:
+        return 'Multiple Choices';
+      case 301:
+        return 'Moved Permanently';
+      case 302:
+        return 'Found';
+      case 303:
+        return 'See Other';
+      case 304:
+        return 'Not Modified';
+      case 305:
+        return 'Use Proxy';
+      case 306:
+        return 'Switch Proxy';
+      case 307:
+        return 'Temporary Redirect';
+      case 308:
+        return 'Permanent Redirect';
+      case 400:
+        return 'Bad Request';
+      case 401:
+        return 'Unauthorized';
+      case 402:
+        return 'Payment Required';
+      case 403:
+        return 'Forbidden';
+      case 404:
+        return 'Not Found';
+      case 405:
+        return 'Method Not Allowed';
+      case 406:
+        return 'Not Acceptable';
+      case 407:
+        return 'Proxy Authentication Required';
+      case 408:
+        return 'Request Timeout';
+      case 409:
+        return 'Conflict';
+      case 410:
+        return 'Gone';
+      case 411:
+        return 'Length Required';
+      case 412:
+        return 'Precondition Failed';
+      case 413:
+        return 'Payload Too Large';
+      case 414:
+        return 'URI Too Long';
+      case 415:
+        return 'Unsupported Media Type';
+      case 416:
+        return 'Range Not Satisfiable';
+      case 417:
+        return 'Expectation Failed';
+      case 418:
+        return "I'm a teapot";
+      case 421:
+        return 'Misdirected Request';
+      case 422:
+        return 'Unprocessable Entity';
+      case 423:
+        return 'Locked';
+      case 424:
+        return 'Failed Dependency';
+      case 425:
+        return 'Too Early';
+      case 426:
+        return 'Upgrade Required';
+      case 428:
+        return 'Precondition Required';
+      case 429:
+        return 'Too Many Requests';
+      case 431:
+        return 'Request Header Fields Too Large';
+      case 451:
+        return 'Unavailable For Legal Reasons';
+      case 500:
+        return 'Internal Server Error';
+      case 501:
+        return 'Not Implemented';
+      case 502:
+        return 'Bad Gateway';
+      case 503:
+        return 'Service Unavailable';
+      case 504:
+        return 'Gateway Timeout';
+      case 505:
+        return 'HTTP Version Not Supported';
+      case 506:
+        return 'Variant Also Negotiates';
+      case 507:
+        return 'Insufficient Storage';
+      case 508:
+        return 'Loop Detected';
+      case 510:
+        return 'Not Extended';
+      case 511:
+        return 'Network Authentication Required';
+      default:
+        return 'Unknown';
+    }
+  }
+}
+/*
+//                  //
+// 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 n network 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)
+  440 Login Time-out
+  444 No Response
+  449 Retry With
+  450 Blocked by Windows Parental Controls (Microsoft)
+  451 Redirect
+  494 Request header too large
+  495 SSL Certificate Error
+  496 SSL Certificate Required
+  497 HTTP Request Sent to HTTPS Port
+  498 Invalid Token (Esri)
+  499 Client Closed Request
+  499 Token Required (Esri)
+  509 Bandwidth Limit Exceeded (Apache Web Server/cPanel)
+  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
+  529 Site is overloaded
+  530 Site is frozen
+  598 (Informal convention) Network read timeout 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 {}