@futdevpro/fsm-dynamo 1.16.7 → 1.16.10

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

@@ -1,1215 +1,1274 @@
-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 Error implements DyFM_Metadata {
+  readonly flag = DyFM_errorFlag + '-v2';
+
+  // ─── DyFM_Metadata mezok (implements DyFM_Metadata) ─────────────────────────
+  // A DyFM_Error mostantol `extends Error` — igy `err instanceof Error === true`, es a
+  // Node 22 strict unhandled-rejection riport a VALODI throw-site stacket mutatja (a korabbi
+  // `extends DyFM_Metadata` mellett a bare-object Promise rejection veletlen specet blame-elt).
+  // A metadata-orokles helyett strukturalisan IMPLEMENTALJUK a DyFM_Metadata-t: a mezoket itt
+  // deklaraljuk, az init-logikat a constructorban a DyFM_Metadata.applyMetadata statikus vegzi.
+  _id?: string;
+  __created?: Date;
+  __createdBy?: string;
+  __lastModified?: Date;
+  __lastModifiedBy?: string;
+  __v?: number;
+  _deleted?: Date;
+  _deletedBy?: string;
+  _archived?: Date;
+  _originalId?: string;
+
+  _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` az Error-bol jon (`extends Error`) — itt NEM deklaraljuk ujra, kulonben a
+  // class-field-init undefined-dal felulirna a natancsolt stacket a super() utan.
+  __localStack?: string;
+
+  level?: DyFM_ErrorLevel;
+  
+  levelUpThis?: boolean;
+  additionalContent?: any = {};
+  confidentialContent?: any = {};
+
+  constructor(
+    set?: DyFM_Error_Settings
+  ) {
+    // az Error-constructort a nyers input-message-dzsel hivjuk (a vegleges _message kesobb all
+    // ossze; a natancsolt Error.message-et a constructor vegen allitjuk ra) — super() KOTELEZOEN
+    // az elso utasitas, a this- erintese elott.
+    super(set?.message);
+
+    // a natancsolt Error.name -> 'DyFM_Error' (non-enumerable, hogy a szerializalt shape ne
+    // valtozzon): igy a logok / Node-riport "DyFM_Error: ..."-kent jelennek meg, nem "Error: ...".
+    Object.defineProperty(this, 'name', {
+      value: 'DyFM_Error',
+      enumerable: false,
+      writable: true,
+      configurable: true,
+    });
+
+    // metadata-init: a korabbi `super(set, { issuer })` helyett (a super most az Error),
+    // target-alapon a DyFM_Metadata.applyMetadata statikuson at.
+    DyFM_Metadata.applyMetadata(
+      this,
+      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))
+      );
+
+      // ─── `extends Error` szerializacios igazitasok ─────────────────────────
+      // A natancsolt Error a stacket NON-ENUMERABLE own-property-kent kezeli, igy a
+      // `{ ...this }` spread (getErrorsFlat) es a JSON.stringify (getParsable / perzisztalas)
+      // elejtene. Enumerable-kent ujradefinialjuk, hogy a szerializacios utak megtartsak.
+      if (this.stack !== undefined) {
+        Object.defineProperty(this, 'stack', {
+          value: this.stack,
+          enumerable: true,
+          writable: true,
+          configurable: true,
+        });
+      }
+
+      // A natancsolt Error.message-et a sajat _message-unkre allitjuk (NON-enumerable marad,
+      // hogy a szerializalt shape valtozatlan legyen — a forras tovabbra is a _message): igy a
+      // `(err as Error).message` fogyasztok ES a Node 22 unhandled-rejection printer a valodi
+      // uzenetet latjak, nem ures stringet.
+      Object.defineProperty(this, 'message', {
+        value: this._message ?? this.__userMessage ?? '',
+        enumerable: false,
+        writable: true,
+        configurable: true,
+      });
+
+      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 {}
+