@naturalcycles/js-lib 14.62.0 → 14.66.0

package/src/log/commonLogger.ts

@@ -1,3 +1,5 @@
+import { _noop } from '../index'
+
 /**
  * These levels follow console.* naming,
  * so you can use console[level] safely.
@@ -10,6 +12,12 @@
  */
 export type CommonLogLevel = 'log' | 'warn' | 'error'
 
+export const commonLogLevelNumber: Record<CommonLogLevel, number> = {
+  log: 10,
+  warn: 20,
+  error: 30,
+}
+
 /**
  * Function that takes any number of arguments and logs them all.
  * It is expected that logged arguments are separated by "space", like console.log does.
@@ -31,35 +39,41 @@ export interface CommonLogger {
 }
 
 /**
- * Same as CommonLogger, but also is a "convenience function" itself.
- * So you can do `logger('hey')` which is the same as `logger.log('hey')`
- *
- * @experimental
- */
-export interface SimpleLogger extends CommonLogFunction, CommonLogger {}
-
-/**
- * Creates a SimpleLogger from CommonLogger.
+ * SimpleLogger that does nothing (noop).
  *
  * @experimental
  */
-export function createSimpleLogger(logger: CommonLogger): SimpleLogger {
-  return Object.assign(((...args: any[]) => logger.log(...args)) as any, {
-    log: (...args: any[]) => logger.log(...args),
-    warn: (...args: any[]) => logger.warn(...args),
-    error: (...args: any[]) => logger.error(...args),
-  })
+export const noopLogger: CommonLogger = {
+  log: _noop,
+  warn: _noop,
+  error: _noop,
 }
 
-const noop = () => {}
-
 /**
- * SimpleLogger that does nothing (noop).
- *
- * @experimental
+ * Creates a "child" logger that is "limited" to the specified CommonLogLevel.
  */
-export const noopLogger: SimpleLogger = createSimpleLogger({
-  log: noop,
-  warn: noop,
-  error: noop,
-})
+export function commonLoggerMinLevel(
+  logger: CommonLogger,
+  minLevel: CommonLogLevel,
+  mutate = false,
+): CommonLogger {
+  const level = commonLogLevelNumber[minLevel]
+  if (mutate) {
+    if (level > commonLogLevelNumber['log']) {
+      logger.log = _noop
+      if (level > commonLogLevelNumber['warn']) {
+        logger.warn = _noop
+        if (level > commonLogLevelNumber['error']) {
+          logger.error = _noop
+        }
+      }
+    }
+    return logger
+  }
+
+  return {
+    log: level <= commonLogLevelNumber['log'] ? (...args) => logger.log(...args) : _noop,
+    warn: level <= commonLogLevelNumber['warn'] ? (...args) => logger.warn(...args) : _noop,
+    error: level <= commonLogLevelNumber['error'] ? (...args) => logger.error(...args) : _noop,
+  }
+}

package/src/promise/pRetry.ts

@@ -1,4 +1,4 @@
-import { _since, _stringifyAny } from '..'
+import { _since, _stringifyAny, CommonLogger } from '..'
 
 export interface PRetryOptions {
   /**
@@ -63,6 +63,11 @@ export interface PRetryOptions {
    * @default false
    */
   logNone?: boolean
+
+  /**
+   * Default to `console`
+   */
+  logger?: CommonLogger
 }
 
 /**
@@ -71,7 +76,13 @@ export interface PRetryOptions {
  */
 // eslint-disable-next-line @typescript-eslint/ban-types
 export function pRetry<T extends Function>(fn: T, opt: PRetryOptions = {}): T {
-  const { maxAttempts = 4, delay: initialDelay = 1000, delayMultiplier = 2, predicate } = opt
+  const {
+    maxAttempts = 4,
+    delay: initialDelay = 1000,
+    delayMultiplier = 2,
+    predicate,
+    logger = console,
+  } = opt
 
   let { logFirstAttempt = false, logRetries = true, logFailures = false, logSuccess = false } = opt
 
@@ -95,18 +106,18 @@ export function pRetry<T extends Function>(fn: T, opt: PRetryOptions = {}): T {
         try {
           attempt++
           if ((attempt === 1 && logFirstAttempt) || (attempt > 1 && logRetries)) {
-            console.log(`${fname} attempt #${attempt}...`)
+            logger.log(`${fname} attempt #${attempt}...`)
           }
 
           const r = await fn.apply(this, args)
 
           if (logSuccess) {
-            console.log(`${fname} attempt #${attempt} succeeded in ${_since(started)}`)
+            logger.log(`${fname} attempt #${attempt} succeeded in ${_since(started)}`)
           }
           resolve(r)
         } catch (err) {
           if (logFailures) {
-            console.warn(
+            logger.warn(
               `${fname} attempt #${attempt} error in ${_since(started)}:\n${_stringifyAny(err, {
                 includeErrorData: true,
               })}`,