@futdevpro/fsm-dynamo 1.20.9 → 1.20.12

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

@@ -1,1280 +0,0 @@
-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;
-      }
-
-      // BFR-FDPTOKENSERVICE-013: (1) a `DyFM_error_defaults.addECToUserMsg === false` globális
-      // kill-switch minden utótagot letilt (a kód a `_errorCode`-ban úgyis ott van);
-      // (2) ha a userMessage MÁR hordoz `ErrorCode:` sort (wrapper-lánc), nem fűzünk újra —
-      // a dupla-fűzés a KÜLSŐ wrapper kódját mutatta a valódi `_errorCode` helyett.
-      if (
-        set.addECToUserMsg &&
-        DyFM_error_defaults.addECToUserMsg !== false &&
-        set.userMessage !== DyFM_error_defaults.userMessage &&
-        set.errorCode &&
-        !set.userMessage.includes('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 {}
-