@futdevpro/fsm-dynamo 1.20.9 → 1.20.10

package/src/_collections/utils/log.util.ts

@@ -1,667 +0,0 @@
-
-import { DyFM_LogStyle, DyFM_allLogStyles } from '../../_enums/log-style.enum';
-
-/* export class D_Log implements DyFM_Log {}; */
-export type DyFM_L = DyFM_Log;
-
-/**
- * DyFM_Log is a class that provides a set of methods to log messages to the console.
- * This class have methods to log messages with different styles and colors, 
- * such as success, error, warn, info and highlighted for each of them.
- */
-export class DyFM_Log {
-
-  static readonly infoStyle: string = DyFM_LogStyle.cyan;
-  static readonly errorStyle: string = DyFM_LogStyle.red;
-  static readonly warnStyle: string = DyFM_LogStyle.brightOrange;
-  static readonly successStyle: string = DyFM_LogStyle.green;
-  static readonly highlightedStyle: string = `${DyFM_LogStyle.white}${DyFM_LogStyle.bold}`;
-  static readonly boldStyle: string = DyFM_LogStyle.bold;
-
-   
-  static readonly h_test: string =  '||||||||||';
-   
-  static readonly h_before: string = '\\\\\\\\\\\\\\\\\\\\';
-   
-  static readonly h_after: string =  '//////////';
-   
-  static readonly h_small: string =  '----------';
-
-  /**
-   * Sets the style of the console log.
-   * @param styles - The styles to set.
-   * 
-   * @example
-   * ```ts
-   * DyFM_Log.setStyle([ DyFM_LogStyle.bold, DyFM_LogStyle.underline ]);
-   * ```
-   */
-  static setStyle(styles: DyFM_LogStyle[]): void {
-    let styleSets = '';
-
-    styles.forEach((style: DyFM_LogStyle): void => {
-      styleSets += style;
-    });
-    
-    console.log(styleSets);
-  }
-
-  /**
-   * Resets the style of the console log.
-   * 
-   * @example
-   * ```ts
-   * DyFM_Log.resetStyle();
-   * ```
-   */
-  static resetStyle(): void {
-    console.log(DyFM_LogStyle.reset);
-  }
-
-  /**
-   * Adds a style to the console log.
-   * @param input - The input to add the style to.
-   * @param styles - The styles to add.
-   * @param dontReset - Whether to not reset the style.
-   * @returns The input with the style added.
-   * 
-   * @example
-   * ```ts
-   * const result = DyFM_Log.addStyle('Hello, world!', [ DyFM_LogStyle.bold, DyFM_LogStyle.underline ]);
-   * ```
-   */
-  static addStyle(input: string, styles: DyFM_LogStyle[], dontReset?: boolean): string {
-    let result = '';
-
-    styles.forEach((style: DyFM_LogStyle): void => {
-      result += style;
-    });
-
-    result += input;
-
-    if (!dontReset) {
-      result += DyFM_LogStyle.reset;
-    }
-
-    return result;
-  }
-
-  /**
-   * Logs a success message.
-   * @param message - The message to log.
-   * @param optionalParams - The optional parameters to log.
-   *
-   * @example
-   * ```ts
-   * DyFM_Log.success('Hello, world!');
-   * ```
-   */
-  static success(message: string, ...optionalParams: any[]): void {
-    if (0 < optionalParams.length) {
-      console.log(
-        `${this.successStyle}${message}`, 
-        ...optionalParams, DyFM_LogStyle.reset
-      );
-    } else {
-      console.log(`${this.successStyle}${message}${DyFM_LogStyle.reset}`);
-    }
-  }
-  /** 
-   * @deprecated use DyFM_Log.success instead
-   */
-  static readonly logSuccess = this.success;
-
-  /**
-   * Logs an error message.
-   * @param message - The message to log.
-   * @param optionalParams - The optional parameters to log.
-   * 
-   * @example
-   * ```ts
-   * DyFM_Log.error('An error occurred: {errorMessage}', errorMessage);
-   * ```
-   */
-  static error(message: string, ...optionalParams: any[]): void {
-    if (0 < optionalParams.length) {
-      console.error(
-        `${this.errorStyle}${message}`,
-        ...optionalParams, DyFM_LogStyle.reset
-      );
-    } else {
-      console.error(`${this.errorStyle}${message}${DyFM_LogStyle.reset}`);
-    }
-  }
-  /** 
-   * @deprecated use DyFM_Log.error instead
-   */
-  static readonly logError = this.error;
-
-  /**
-   * Logs a warning message.
-   * @param message - The message to log.
-   * @param optionalParams - The optional parameters to log.
-   * 
-   * @example
-   * ```ts
-   * DyFM_Log.warn('A warning occurred: {warningMessage}', warningMessage);
-   * ```
-   */
-  static warn(message: string, ...optionalParams: any[]): void {
-    if (0 < optionalParams.length) {
-      console.warn(
-        `${this.warnStyle}${message}`, 
-        ...optionalParams, DyFM_LogStyle.reset
-      );
-    } else {
-      console.warn(`${this.warnStyle}${message}${DyFM_LogStyle.reset}`);
-    }
-  }
-  /** 
-   * @deprecated use DyFM_Log.warn instead
-   */
-  static readonly warning = this.warn;
-  /** 
-   * @deprecated use DyFM_Log.warn instead
-   */
-  static readonly logWarning = this.warn;
-
-  // ez azért nem egy sima "static readonly info = console.info;", 
-  // mert azon nincs rajta az első input típusa, ami csak string lehet
-  /**
-   * Logs an info message.
-   * @param message - The message to log.
-   * @param optionalParams - The optional parameters to log.
-   * 
-   * @example
-   * ```ts
-   * DyFM_Log.info('An info message: {infoMessage}', infoMessage);
-   * ```
-   */
-  static info(message: string, ...optionalParams: any[]): void {
-    if (0 < optionalParams.length) {
-      console.info(
-        `${this.infoStyle}${message}`, 
-        ...optionalParams, DyFM_LogStyle.reset
-      );
-    } else {
-      console.info(`${this.infoStyle}${message}${DyFM_LogStyle.reset}`);
-    }
-  }
-
-  // ez azért nem egy sima "static readonly log = console.log;", 
-  // mert azon nincs rajta az első input típusa, ami csak string lehet
-  /**
-   * Logs a log message.
-   * @param message - The message to log.
-   * @param optionalParams - The optional parameters to log.
-   * 
-   * @example
-   * ```ts
-   * DyFM_Log.log('A log message: {logMessage}', logMessage);
-   * ```
-   */
-  static log(message: string, ...optionalParams: any[]): void {
-    console.log(message, ...optionalParams);
-  }
-
-  /**
-   * Gets a highlighted message.
-   * @param message - The message to highlight.
-   * @param optionalParams - The optional parameters to highlight.
-   * @returns The highlighted message.
-   * 
-   * @example
-   * ```ts
-   * const highlightedMessage = DyFM_Log.getHighlighted('A highlighted message: {highlightedMessage}', highlightedMessage);
-   * console.log(highlightedMessage); // A highlighted message: {highlightedMessage}
-   * ```
-   */
-  static getHighlighted(message: string, ...optionalParams: any[]): string {
-    return `${this.highlightedStyle}${message}${DyFM_LogStyle.reset}`;
-  }
-
-  /**
-   * Logs a highlighted message.
-   * @param message - The message to highlight.
-   * @param optionalParams - The optional parameters to highlight.
-   * 
-   * @example
-   * ```ts
-   * DyFM_Log.highlighted('A highlighted message: {highlightedMessage}', highlightedMessage);
-   * ```
-   */
-  static highlighted(message: string, ...optionalParams: any[]): void {
-    if (0 < optionalParams.length) {
-      console.log(
-        `${this.highlightedStyle}${message}`, 
-        ...optionalParams, DyFM_LogStyle.reset
-      );
-    } else {
-      console.log(
-        `${this.highlightedStyle}${message}${DyFM_LogStyle.reset}`
-      );
-    }
-  }
-
-  /**
-   * Logs a small Highlighted log message.
-   * @param message - The message to log.
-   * @param optionalParams - The optional parameters to log.
-   * 
-   * @example
-   * ```ts
-   * DyFM_Log.smallLog('A small log message: {smallLogMessage}', smallLogMessage);
-   * ```
-   */
-  static smallLog(message: string, ...optionalParams: any[]): void {
-    console.log(
-      this.h_small + 
-      '\n  ' + this.asfel(message, 2), ...this.asfesop(optionalParams, 2),
-      '\n' + this.h_small
-    );
-  }
-  static readonly S_log = DyFM_Log.smallLog;
-
-  /**
-   * Highlighted Tests a log message.
-   * @param message - The message to test.
-   * @param optionalParams - The optional parameters to test.
-   * 
-   * @example
-   * ```ts
-   * DyFM_Log.testLog('A test log message: {testLogMessage}', testLogMessage);
-   * ```
-   */
-  static testLog(message: string, ...optionalParams: any[]): void {
-    this.log(
-      '\n' + this.h_test + 
-      '\n\n    ' + this.asfel(message, 4), ...this.asfesop(optionalParams, 4),
-      '\n\n' + this.h_test + '\n'
-    );
-  }  
-  static readonly test = DyFM_Log.testLog;
-  static readonly T_log = DyFM_Log.testLog;
-  
-  /**
-   * Logs a highlighted log message.
-   * @param message - The message to highlight.
-   * @param optionalParams - The optional parameters to highlight.
-   * 
-   * @example
-   * ```ts
-   * DyFM_Log.highlightedLog('A highlighted log message: {highlightedLogMessage}', highlightedLogMessage);
-   * ```
-   */
-  static highlightedLog(message: string, ...optionalParams: any[]): void {
-    this.log(
-      '\n\n' + this.h_before + 
-      '\n ' + this.h_before + 
-      '\n  ' + this.h_before + 
-      '\n\n    ' + this.asfel(message, 4), ...this.asfesop(optionalParams, 4),
-      '\n\n  ' + this.h_after +
-      '\n ' + this.h_after +
-      '\n' + this.h_after + '\n\n'
-    );
-  }  
-  static readonly H_log = DyFM_Log.highlightedLog;
-
-  /**
-   * Logs a small Highlighted info message.
-   * @param message - The message to log.
-   * @param optionalParams - The optional parameters to log.
-   * 
-   * @example
-   * ```ts
-   * DyFM_Log.smallInfo('A small info message: {smallInfoMessage}', smallInfoMessage);
-   * ```
-   */
-  static smallInfo(message: string, ...optionalParams: any[]): void {
-    this.info(
-      this.h_small + 
-      '\n  ' + this.asfel(message, 2), ...this.asfesop(optionalParams, 2),
-      '\n' + this.infoStyle + this.h_small
-    );
-  }
-  static readonly S_info = DyFM_Log.smallInfo;
-
-  /**
-   * Highlighted Tests an info message.
-   * @param message - The message to test.
-   * @param optionalParams - The optional parameters to test.
-   * 
-   * @example
-   * ```ts
-   * DyFM_Log.testInfo('A test info message: {testInfoMessage}', testInfoMessage);
-   * ```
-   */
-  static testInfo(message: string, ...optionalParams: any[]): void {
-    this.info(
-      '\n' + this.h_test + 
-      '\n\n    ' + this.asfel(message, 4), ...this.asfesop(optionalParams, 4),
-      '\n\n' + this.infoStyle + this.h_test + '\n'
-    );
-  }
-  static readonly T_info = DyFM_Log.testInfo;
-
-  /**
-   * Logs a highlighted info message.
-   * @param message - The message to highlight.
-   * @param optionalParams - The optional parameters to highlight.
-   * 
-   * @example
-   * ```ts
-   * DyFM_Log.highlightedInfo('A highlighted info message: {highlightedInfoMessage}', highlightedInfoMessage);
-   * ```
-   */
-  static highlightedInfo(message: string, ...optionalParams: any[]): void {
-    this.info(
-      '\n\n' + this.h_before + 
-      '\n ' + this.h_before + 
-      '\n  ' + this.h_before + 
-      '\n\n    ' + this.asfel(message, 4), ...this.asfesop(optionalParams, 4),
-      '\n\n  ' + this.infoStyle + this.h_after +
-      '\n ' + this.h_after +
-      '\n' + this.h_after + '\n\n'
-    );
-  }
-  static readonly H_info = DyFM_Log.highlightedInfo;
-
-  /**
-   * Logs a small Highlighted error message.
-   * @param message - The message to log.
-   * @param optionalParams - The optional parameters to log.
-   * 
-   * @example
-   * ```ts
-   * DyFM_Log.smallError('A small error message: {smallErrorMessage}', smallErrorMessage);
-   * ```
-   */
-  static smallError(message: string, ...optionalParams: any[]): void {
-    this.error(
-      this.h_small + 
-      '\n  ' + this.asfel(message, 2), ...this.asfesop(optionalParams, 2),
-      '\n' + this.errorStyle + this.h_small
-    );
-  }
-  static readonly S_error = DyFM_Log.smallError;
-
-  /**
-   * Highlighted Tests an error message.
-   * @param message - The message to test.
-   * @param optionalParams - The optional parameters to test.
-   * 
-   * @example
-   * ```ts
-   * DyFM_Log.testError('A test error message: {testErrorMessage}', testErrorMessage);
-   * ```
-   */
-  static testError(message: string, ...optionalParams: any[]): void {
-    this.error(
-      '\n' + this.h_test + 
-      '\n\n    ' + this.asfel(message, 4), ...this.asfesop(optionalParams, 4),
-      '\n\n' + this.errorStyle + this.h_test + '\n'
-    );
-  }
-  static readonly T_error = DyFM_Log.testError;
-
-  /**
-   * Logs a highlighted error message.
-   * @param message - The message to highlight.
-   * @param optionalParams - The optional parameters to highlight.
-   * 
-   * @example
-   * ```ts
-   * DyFM_Log.highlightedError('A highlighted error message: {highlightedErrorMessage}', highlightedErrorMessage);
-   * ```
-   */
-  static highlightedError(message: string, ...optionalParams: any[]): void {
-    this.error(
-      '\n\n' + this.h_before + 
-      '\n ' + this.h_before + 
-      '\n  ' + this.h_before + 
-      '\n\n    ' + this.asfel(message, 4), ...this.asfesop(optionalParams, 4),
-      '\n\n  ' + this.errorStyle + this.h_after +
-      '\n ' + this.h_after +
-      '\n' + this.h_after + '\n\n'
-    );
-  }
-  static readonly H_error = DyFM_Log.highlightedError;
-
-  /**
-   * Logs a small Highlighted warning message.
-   * @param message - The message to log.
-   * @param optionalParams - The optional parameters to log.
-   * 
-   * @example
-   * ```ts
-   * DyFM_Log.smallWarn('A small warning message: {smallWarnMessage}', smallWarnMessage);
-   * ```
-   */
-  static smallWarn(message: string, ...optionalParams: any[]): void {
-    this.warn(
-      this.h_small + 
-      '\n  ' + this.asfel(message, 2), ...this.asfesop(optionalParams, 2),
-      '\n' + this.warnStyle + this.h_small
-    );
-  }
-  static readonly S_warn = DyFM_Log.smallWarn;
-
-  /**
-   * Highlighted Tests a warning message.
-   * @param message - The message to test.
-   * @param optionalParams - The optional parameters to test.
-   * 
-   * @example
-   * ```ts
-   * DyFM_Log.testWarn('A test warning message: {testWarnMessage}', testWarnMessage);
-   * ```
-   */
-  static testWarn(message: string, ...optionalParams: any[]): void {
-    this.warn(
-      '\n' + this.h_test + 
-      '\n\n    ' + this.asfel(message, 4), ...this.asfesop(optionalParams, 4),
-      '\n\n' + this.warnStyle + this.h_test + '\n'
-    );
-  }
-  static readonly T_warn = DyFM_Log.testWarn;
-
-  /**
-   * Logs a highlighted warning message.
-   * @param message - The message to highlight.
-   * @param optionalParams - The optional parameters to highlight.
-   * 
-   * @example
-   * ```ts
-   * DyFM_Log.highlightedWarn('A highlighted warning message: {highlightedWarnMessage}', highlightedWarnMessage);
-   * ```
-   */
-  static highlightedWarn(message: string, ...optionalParams: any[]): void {
-    this.warn(
-      '\n\n' + this.h_before + 
-      '\n ' + this.h_before + 
-      '\n  ' + this.h_before + 
-      '\n\n    ' + this.asfel(message, 4), ...this.asfesop(optionalParams, 4),
-      '\n\n  ' + this.warnStyle + this.h_after +
-      '\n ' + this.h_after +
-      '\n' + this.h_after + '\n\n'
-    );
-  }  
-  static readonly H_warn = DyFM_Log.highlightedWarn;
-
-  /**
-   * Logs a small success message.
-   * @param message - The message to log.
-   * @param optionalParams - The optional parameters to log.
-   * 
-   * @example
-   * ```ts
-   * DyFM_Log.smallSuccess('A small success message: {smallSuccessMessage}', smallSuccessMessage);
-   * ```
-   */
-  static smallSuccess(message: string, ...optionalParams: any[]): void {
-    this.success(
-      this.h_small + 
-      '\n  ' + this.asfel(message, 2), ...this.asfesop(optionalParams, 2),
-      '\n' + this.successStyle + this.h_small
-    );
-  }
-  static readonly S_success = DyFM_Log.smallSuccess;
-
-  /**
-   * Tests a success message.
-   * @param message - The message to test.
-   * @param optionalParams - The optional parameters to test.
-   * 
-   * @example
-   * ```ts
-   * DyFM_Log.testSuccess('A test success message: {testSuccessMessage}', testSuccessMessage);
-   * ```
-   */
-  static testSuccess(message: string, ...optionalParams: any[]): void {
-    this.success(
-      '\n' + this.h_test + 
-      '\n\n    ' + this.asfel(message, 4), ...this.asfesop(optionalParams, 4),
-      '\n\n' + this.successStyle + this.h_test + '\n'
-    );
-  }
-  static readonly T_success = DyFM_Log.testSuccess;
-
-  /**
-   * Logs a highlighted success message.
-   * @param message - The message to highlight.
-   * @param optionalParams - The optional parameters to highlight.
-   */
-  static highlightedSuccess(message: string, ...optionalParams: any[]): void {
-    this.success(
-      '\n\n' + this.h_before + 
-      '\n ' + this.h_before + 
-      '\n  ' + this.h_before + 
-      '\n\n    ' + this.asfel(message, 4), ...this.asfesop(optionalParams, 4),
-      '\n\n  ' + this.successStyle + this.h_after +
-      '\n ' + this.h_after +
-      '\n' + this.h_after + '\n\n'
-    );
-  } 
-  static readonly H_success = DyFM_Log.highlightedSuccess;
-
-  /**
-   * Removes the log styles from a message.
-   * @param message - The message to remove the styles from.
-   * @returns The message without the styles.
-   */
-  static removeLogStyles(message: string): string {
-    for (const styleKey of DyFM_allLogStyles) {
-      message = message.replaceAll(styleKey, '');
-    }
-
-    return message;
-  }
-
-  /**
-   * Silences all logs.
-   * 
-   * @example
-   * ```ts
-   * DyFM_Log.silenceLogs();
-   * ```
-   */
-  static silenceLogs(): void {
-    console.log = (): void => {};
-  }
-
-  /**
-   * Silences non-error logs.
-   * 
-   * @example
-   * ```ts
-   * DyFM_Log.silenceNonErrorLogs();
-   * ```
-   */
-  static silenceNonErrorLogs(): void {
-    console.log = (): void => {};
-    console.info = (): void => {};
-    console.warn = (): void => {};
-  }
-
-  /**
-   * Silences all logs.
-   * 
-   * @example
-   * ```ts
-   * DyFM_Log.silenceConsole();
-   * ```
-   */
-  static silenceConsole(): void {
-    console.log = (): void => {};
-    console.info = (): void => {};
-    console.warn = (): void => {};
-    console.error = (): void => {};
-  }
-
-  /**
-   * Adds breaks and tabs to the string parameters.
-   * @param params - The parameters to add the breaks and tabs to.
-   * @returns The parameters with the breaks and tabs added.
-   * 
-   * @example
-   * ```ts
-   * const params = [ 'Hello, world!', 'Hello, world!', 'Hello, world!' ];
-   * const result = DyFM_Log.addBreaksAndTabsToStringParams(params);
-   * console.log(result); // [ 'Hello, world!', 'Hello, world!', 'Hello, world!' ]
-   * ```
-   */
-  static addBreaksAndTabsToStringParams(params: any[]): any[] {
-    return params.map((param: any): string => {
-      if (typeof param === 'string') {
-        return '\n    ' + param;
-      }
- 
-      return param;
-      
-    });
-  }
-
-  /**
-   * Adds spaces for each line.
-   * @param message - The message to add the spaces to.
-   * @param spaces - The number of spaces to add.
-   * @returns The message with the spaces added.
-   * 
-   * @example
-   * ```ts
-   * const message = 'Hello, world!\nHello, world!\nHello, world!';
-   * const result = DyFM_Log.addSpacesForEachLine(message, 2);
-   * console.log(result); // Hello, world!  Hello, world!  Hello, world!
-   * ```
-   */
-  static addSpacesForEachLine(message: string, spaces: number): string {
-    return message.replaceAll('\n', '\n' + ' '.repeat(spaces));
-  }
-  private static asfel = this.addSpacesForEachLine;
-
-  /**
-   * Adds spaces for each string optional parameter.
-   * @param params - The parameters to add the spaces to.
-   * @param spaces - The number of spaces to add.
-   * @returns The parameters with the spaces added.
-   * 
-   * @example
-   * ```ts
-   * const params = [ 'Hello, world!', 'Hello, world!', 'Hello, world!' ];
-   * const result = DyFM_Log.addSpacesForEachStringOptionalParam(params, 2);
-   * console.log(result); // [ 'Hello, world!  Hello, world!  Hello, world!' ]
-   * ```
-   */
-  static addSpacesForEachStringOptionalParam(params: any[], spaces: number): any[] {
-    return params.map((param: any): any => {
-      if (typeof param === 'string') {
-        return this.addSpacesForEachLine(param, spaces);
-      }
- 
-      return param;
-      
-    });
-  }
-  private static asfesop = this.addSpacesForEachStringOptionalParam;
-}
-