@naturalcycles/js-lib 14.63.0 → 14.67.0

package/dist-esm/decorators/memo.decorator.js

@@ -30,7 +30,7 @@ export const _Memo = (opt = {}) => (target, key, descriptor) => {
     // UPD: tests show that normal Map also doesn't leak (to be tested further)
     // Normal Map is needed to allow .dropCache()
     const cache = new Map();
-    const { logHit, logMiss, noLogArgs, cacheFactory = () => new MapMemoCache(), cacheKeyFn = jsonMemoSerializer, noCacheRejected, noCacheResolved, } = opt;
+    const { logHit = false, logMiss = false, noLogArgs = false, logger = console, cacheFactory = () => new MapMemoCache(), cacheKeyFn = jsonMemoSerializer, noCacheRejected = false, noCacheResolved = false, } = opt;
     const awaitPromise = Boolean(noCacheRejected || noCacheResolved);
     const keyStr = String(key);
     const methodSignature = _getTargetMethodSignature(target, keyStr);
@@ -42,7 +42,7 @@ export const _Memo = (opt = {}) => (target, key, descriptor) => {
         }
         else if (cache.get(ctx).has(cacheKey)) {
             if (logHit) {
-                console.log(`${_getMethodSignature(ctx, keyStr)}(${_getArgsSignature(args, noLogArgs)}) @memoInstance hit`);
+                logger.log(`${_getMethodSignature(ctx, keyStr)}(${_getArgsSignature(args, noLogArgs)}) @_Memo hit`);
             }
             const res = cache.get(ctx).get(cacheKey);
             if (awaitPromise) {
@@ -59,7 +59,7 @@ export const _Memo = (opt = {}) => (target, key, descriptor) => {
                 .then(res => {
                 // console.log('RESOLVED', res)
                 if (logMiss) {
-                    console.log(`${_getMethodSignature(ctx, keyStr)}(${_getArgsSignature(args, noLogArgs)}) @memo miss resolved (${_since(started)})`);
+                    logger.log(`${_getMethodSignature(ctx, keyStr)}(${_getArgsSignature(args, noLogArgs)}) @_Memo miss resolved (${_since(started)})`);
                 }
                 if (!noCacheResolved) {
                     cache.get(ctx).set(cacheKey, res);
@@ -69,7 +69,7 @@ export const _Memo = (opt = {}) => (target, key, descriptor) => {
                 .catch(err => {
                 // console.log('REJECTED', err)
                 if (logMiss) {
-                    console.log(`${_getMethodSignature(ctx, keyStr)}(${_getArgsSignature(args, noLogArgs)}) @memo miss rejected (${_since(started)})`);
+                    logger.log(`${_getMethodSignature(ctx, keyStr)}(${_getArgsSignature(args, noLogArgs)}) @_Memo miss rejected (${_since(started)})`);
                 }
                 if (!noCacheRejected) {
                     // We put it to cache as raw Error, not Promise.reject(err)
@@ -82,14 +82,14 @@ export const _Memo = (opt = {}) => (target, key, descriptor) => {
         }
         else {
             if (logMiss) {
-                console.log(`${_getMethodSignature(ctx, keyStr)}(${_getArgsSignature(args, noLogArgs)}) @memo miss (${_since(started)})`);
+                logger.log(`${_getMethodSignature(ctx, keyStr)}(${_getArgsSignature(args, noLogArgs)}) @_Memo miss (${_since(started)})`);
             }
             cache.get(ctx).set(cacheKey, res);
             return res;
         }
     };
     descriptor.value.dropCache = () => {
-        console.log(`${methodSignature} @memo.dropCache()`);
+        logger.log(`${methodSignature} @_Memo.dropCache()`);
         cache.forEach(memoCache => memoCache.clear());
         cache.clear();
     };

package/dist-esm/decorators/memoFn.js

@@ -2,7 +2,7 @@ import { _since } from '../time/time.util';
 import { _getArgsSignature } from './decorator.util';
 import { jsonMemoSerializer, MapMemoCache } from './memo.util';
 export function _memoFn(fn, opt = {}) {
-    const { logHit, logMiss, noLogArgs, noCacheRejected, noCacheResolved, cacheFactory = () => new MapMemoCache(), cacheKeyFn = jsonMemoSerializer, } = opt;
+    const { logHit = false, logMiss = false, noLogArgs = false, logger = console, noCacheRejected = false, noCacheResolved = false, cacheFactory = () => new MapMemoCache(), cacheKeyFn = jsonMemoSerializer, } = opt;
     const cache = cacheFactory();
     const awaitPromise = Boolean(noCacheRejected || noCacheResolved);
     const fnName = fn.name;
@@ -11,7 +11,7 @@ export function _memoFn(fn, opt = {}) {
         const cacheKey = cacheKeyFn(args);
         if (cache.has(cacheKey)) {
             if (logHit) {
-                console.log(`${fnName}(${_getArgsSignature(args, noLogArgs)}) memoFn hit`);
+                logger.log(`${fnName}(${_getArgsSignature(args, noLogArgs)}) memoFn hit`);
             }
             const res = cache.get(cacheKey);
             if (awaitPromise) {
@@ -28,7 +28,7 @@ export function _memoFn(fn, opt = {}) {
                 .then(res => {
                 // console.log('RESOLVED', res)
                 if (logMiss) {
-                    console.log(`${fnName}(${_getArgsSignature(args, noLogArgs)}) memoFn miss resolved (${_since(started)})`);
+                    logger.log(`${fnName}(${_getArgsSignature(args, noLogArgs)}) memoFn miss resolved (${_since(started)})`);
                 }
                 if (!noCacheResolved) {
                     cache.set(cacheKey, res);
@@ -38,7 +38,7 @@ export function _memoFn(fn, opt = {}) {
                 .catch(err => {
                 // console.log('REJECTED', err)
                 if (logMiss) {
-                    console.log(`${fnName}(${_getArgsSignature(args, noLogArgs)}) memoFn miss rejected (${_since(started)})`);
+                    logger.log(`${fnName}(${_getArgsSignature(args, noLogArgs)}) memoFn miss rejected (${_since(started)})`);
                 }
                 if (!noCacheRejected) {
                     // We put it to cache as raw Error, not Promise.reject(err)
@@ -51,7 +51,7 @@ export function _memoFn(fn, opt = {}) {
         }
         else {
             if (logMiss) {
-                console.log(`${fnName}(${_getArgsSignature(args, noLogArgs)}) @memo miss (${_since(started)})`);
+                logger.log(`${fnName}(${_getArgsSignature(args, noLogArgs)}) memoFn miss (${_since(started)})`);
             }
             cache.set(cacheKey, res);
             return res;

package/dist-esm/decorators/memoSimple.decorator.js

@@ -3,12 +3,6 @@
 // http://decodize.com/blog/2012/08/27/javascript-memoization-caching-results-for-better-performance/
 // http://inlehmansterms.net/2015/03/01/javascript-memoization/
 // https://community.risingstack.com/the-worlds-fastest-javascript-memoization-library/
-/*
-Optimized for 0 arguments (using SingleValueCache).
-Optimized for 1 primitive argument (skips JSON.stringify).
-Otherwise resorts to JSON.stringify.
-Benchmark shows similar perf for ObjectCache and MapCache.
- */
 import { _getArgsSignature, _getTargetMethodSignature } from './decorator.util';
 import { jsonMemoSerializer, MapMemoCache } from './memo.util';
 // memoSimple decorator is NOT exported. Only used in benchmarks currently
@@ -40,7 +34,7 @@ export const memoSimple = (opt = {}) => (target, key, descriptor) => {
   }
    */
     const cache = new MapMemoCache();
-    const { logHit, logMiss, noLogArgs } = opt;
+    const { logHit, logMiss, noLogArgs, logger = console } = opt;
     const keyStr = String(key);
     const methodSignature = _getTargetMethodSignature(target, keyStr);
     descriptor.value = function (...args) {
@@ -48,20 +42,20 @@ export const memoSimple = (opt = {}) => (target, key, descriptor) => {
         const cacheKey = jsonMemoSerializer(args);
         if (cache.has(cacheKey)) {
             if (logHit) {
-                console.log(`${methodSignature}(${_getArgsSignature(args, noLogArgs)}) @memo hit`);
+                logger.log(`${methodSignature}(${_getArgsSignature(args, noLogArgs)}) @memo hit`);
             }
             return cache.get(cacheKey);
         }
         const d = Date.now();
         const res = originalFn.apply(ctx, args);
         if (logMiss) {
-            console.log(`${methodSignature}(${_getArgsSignature(args, noLogArgs)}) @memo miss (${Date.now() - d} ms)`);
+            logger.log(`${methodSignature}(${_getArgsSignature(args, noLogArgs)}) @memo miss (${Date.now() - d} ms)`);
         }
         cache.set(cacheKey, res);
         return res;
     };
     descriptor.value.dropCache = () => {
-        console.log(`${methodSignature} @memo.dropCache()`);
+        logger.log(`${methodSignature} @memo.dropCache()`);
         cache.clear();
     };
     return descriptor;

package/dist-esm/error/tryCatch.js

@@ -8,20 +8,20 @@ import { _since, _stringifyAny } from '../index';
  * @experimental
  */
 export function _tryCatch(fn, opt = {}) {
-    const { onError, logError, logSuccess } = Object.assign({ logError: true }, opt);
+    const { onError, logError = true, logSuccess = false, logger = console } = opt;
     const fname = fn.name || 'anonymous';
     return async function (...args) {
         const started = Date.now();
         try {
             const r = await fn.apply(this, args);
             if (logSuccess) {
-                console.log(`tryCatch.${fname} succeeded in ${_since(started)}`);
+                logger.log(`tryCatch.${fname} succeeded in ${_since(started)}`);
             }
             return r;
         }
         catch (err) {
             if (logError) {
-                console.warn(`tryCatch.${fname} error in ${_since(started)}:\n${_stringifyAny(err, {
+                logger.warn(`tryCatch.${fname} error in ${_since(started)}:\n${_stringifyAny(err, {
                     includeErrorData: true,
                 })}`);
             }

package/dist-esm/index.js

@@ -50,6 +50,6 @@ import { _ms, _since } from './time/time.util';
 import { _noop, _objectKeys, _passNothingPredicate, _passthroughMapper, _passthroughPredicate, _passUndefinedMapper, _stringMapEntries, _stringMapValues, } from './types';
 import { _gb, _hb, _kb, _mb } from './unit/size.util';
 import { is } from './vendor/is';
-import { createSimpleLogger, noopLogger, } from './log/commonLogger';
+import { commonLoggerMinLevel, noopLogger, commonLogLevelNumber, commonLoggerPipe, } from './log/commonLogger';
 import { _safeJsonStringify } from './string/safeJsonStringify';
-export { is, _Memo, _memoFn, _LogMethod, _getArgsSignature, _createPromiseDecorator, AppError, HttpError, AssertionError, _isErrorObject, _isHttpErrorObject, _isHttpErrorResponse, _assert, _assertEquals, _assertDeepEquals, _assertIsError, _assertIsString, _assertIsNumber, _assertTypeOf, _randomInt, _randomArrayItem, _createDeterministicRandom, _inRange, _stringMapValues, _stringMapEntries, _objectKeys, _capitalize, _upperFirst, _lowerFirst, _split, _removeWhitespace, _substringBefore, _substringBeforeLast, _substringAfter, _substringAfterLast, _substringBetweenLast, _replaceAll, _nl2br, _truncate, _truncateMiddle, _pick, _omit, _filterFalsyValues, _filterUndefinedValues, _filterNullishValues, _filterEmptyArrays, _filterEmptyValues, _filterObject, _undefinedIfEmpty, _isObject, _isPrimitive, _mapKeys, _mapValues, _mapObject, _objectNullValuesToUndefined, _deepEquals, _deepCopy, _isEmptyObject, _isEmpty, _merge, _deepTrim, _sortObjectDeep, _sortObject, _get, _set, _has, _unset, _mask, _invert, _invertMap, _by, _groupBy, _sortBy, _sortNumbers, _toFixed, _toPrecision, _round, _findLast, _takeWhile, _takeRightWhile, _dropWhile, _dropRightWhile, _countBy, _intersection, _difference, _shuffle, _mapToObject, _findKeyByValue, _anyToError, _anyToErrorObject, _errorToErrorObject, _errorObjectToAppError, _range, _uniq, _uniqBy, _flatten, _flattenDeep, _chunk, SimpleMovingAverage, _average, _averageWeighted, _percentile, _median, _debounce, _throttle, _Debounce, _Throttle, pMap, _passthroughMapper, _passUndefinedMapper, _passthroughPredicate, _passNothingPredicate, _noop, pBatch, ErrorMode, pFilter, pProps, pDelay, pDefer, pHang, pState, AggregatedError, pRetry, pTimeout, pTuple, _Retry, _Timeout, _tryCatch, _TryCatch, _try, pTry, _jsonParseIfPossible, _stringifyAny, _ms, _since, _hb, _gb, _mb, _kb, _snakeCase, _camelCase, _kebabCase, _sum, _sumBy, _clamp, _last, mergeJsonSchemaObjects, jsonSchema, JsonSchemaAnyBuilder, JSON_SCHEMA_ORDER, generateJsonSchemaFromData, _parseQueryString, _defineLazyProperty, _defineLazyProps, _lazyValue, createSimpleLogger, noopLogger, _safeJsonStringify, };
+export { is, _Memo, _memoFn, _LogMethod, _getArgsSignature, _createPromiseDecorator, AppError, HttpError, AssertionError, _isErrorObject, _isHttpErrorObject, _isHttpErrorResponse, _assert, _assertEquals, _assertDeepEquals, _assertIsError, _assertIsString, _assertIsNumber, _assertTypeOf, _randomInt, _randomArrayItem, _createDeterministicRandom, _inRange, _stringMapValues, _stringMapEntries, _objectKeys, _capitalize, _upperFirst, _lowerFirst, _split, _removeWhitespace, _substringBefore, _substringBeforeLast, _substringAfter, _substringAfterLast, _substringBetweenLast, _replaceAll, _nl2br, _truncate, _truncateMiddle, _pick, _omit, _filterFalsyValues, _filterUndefinedValues, _filterNullishValues, _filterEmptyArrays, _filterEmptyValues, _filterObject, _undefinedIfEmpty, _isObject, _isPrimitive, _mapKeys, _mapValues, _mapObject, _objectNullValuesToUndefined, _deepEquals, _deepCopy, _isEmptyObject, _isEmpty, _merge, _deepTrim, _sortObjectDeep, _sortObject, _get, _set, _has, _unset, _mask, _invert, _invertMap, _by, _groupBy, _sortBy, _sortNumbers, _toFixed, _toPrecision, _round, _findLast, _takeWhile, _takeRightWhile, _dropWhile, _dropRightWhile, _countBy, _intersection, _difference, _shuffle, _mapToObject, _findKeyByValue, _anyToError, _anyToErrorObject, _errorToErrorObject, _errorObjectToAppError, _range, _uniq, _uniqBy, _flatten, _flattenDeep, _chunk, SimpleMovingAverage, _average, _averageWeighted, _percentile, _median, _debounce, _throttle, _Debounce, _Throttle, pMap, _passthroughMapper, _passUndefinedMapper, _passthroughPredicate, _passNothingPredicate, _noop, pBatch, ErrorMode, pFilter, pProps, pDelay, pDefer, pHang, pState, AggregatedError, pRetry, pTimeout, pTuple, _Retry, _Timeout, _tryCatch, _TryCatch, _try, pTry, _jsonParseIfPossible, _stringifyAny, _ms, _since, _hb, _gb, _mb, _kb, _snakeCase, _camelCase, _kebabCase, _sum, _sumBy, _clamp, _last, mergeJsonSchemaObjects, jsonSchema, JsonSchemaAnyBuilder, JSON_SCHEMA_ORDER, generateJsonSchemaFromData, _parseQueryString, _defineLazyProperty, _defineLazyProps, _lazyValue, commonLoggerMinLevel, noopLogger, commonLogLevelNumber, commonLoggerPipe, _safeJsonStringify, };

package/dist-esm/log/commonLogger.js

@@ -1,23 +1,57 @@
+import { _noop } from '../index';
+export const commonLogLevelNumber = {
+    log: 10,
+    warn: 20,
+    error: 30,
+};
 /**
- * Creates a SimpleLogger from CommonLogger.
+ * SimpleLogger that does nothing (noop).
  *
  * @experimental
  */
-export function createSimpleLogger(logger) {
-    return Object.assign(((...args) => logger.log(...args)), {
-        log: (...args) => logger.log(...args),
-        warn: (...args) => logger.warn(...args),
-        error: (...args) => logger.error(...args),
-    });
+export const noopLogger = {
+    log: _noop,
+    warn: _noop,
+    error: _noop,
+};
+/**
+ * Creates a "child" logger that is "limited" to the specified CommonLogLevel.
+ */
+export function commonLoggerMinLevel(logger, minLevel, mutate = false) {
+    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;
+    }
+    if (level <= commonLogLevelNumber['log']) {
+        // All levels are kept
+        return logger;
+    }
+    if (level > commonLogLevelNumber['error']) {
+        // "Log nothing" logger
+        return noopLogger;
+    }
+    return {
+        log: _noop,
+        warn: level <= commonLogLevelNumber['warn'] ? logger.warn.bind(logger) : _noop,
+        error: logger.error.bind(logger), // otherwise it's "log nothing" logger (same as noopLogger)
+    };
 }
-const noop = () => { };
 /**
- * SimpleLogger that does nothing (noop).
- *
- * @experimental
+ * Creates a "proxy" CommonLogger that pipes log messages to all provided sub-loggers.
  */
-export const noopLogger = createSimpleLogger({
-    log: noop,
-    warn: noop,
-    error: noop,
-});
+export function commonLoggerPipe(loggers) {
+    return {
+        log: (...args) => loggers.forEach(logger => logger.log(...args)),
+        warn: (...args) => loggers.forEach(logger => logger.warn(...args)),
+        error: (...args) => loggers.forEach(logger => logger.error(...args)),
+    };
+}

package/dist-esm/promise/pRetry.js

@@ -5,7 +5,7 @@ import { _since, _stringifyAny } from '..';
  */
 // eslint-disable-next-line @typescript-eslint/ban-types
 export function pRetry(fn, opt = {}) {
-    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;
     if (opt.logAll) {
         logFirstAttempt = logRetries = logFailures = true;
@@ -23,17 +23,17 @@ export function pRetry(fn, opt = {}) {
                 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(`${fname} attempt #${attempt} error in ${_since(started)}:\n${_stringifyAny(err, {
+                        logger.warn(`${fname} attempt #${attempt} error in ${_since(started)}:\n${_stringifyAny(err, {
                             includeErrorData: true,
                         })}`);
                     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/js-lib",
-  "version": "14.63.0",
+  "version": "14.67.0",
   "scripts": {
     "prepare": "husky install",
     "build-prod": "build-prod-esm-cjs",

package/src/decorators/logMethod.decorator.ts

@@ -1,4 +1,4 @@
-import { SimpleMovingAverage, _stringifyAny } from '..'
+import { SimpleMovingAverage, _stringifyAny, CommonLogger } from '..'
 import { _ms } from '../time/time.util'
 import { _getArgsSignature, _getMethodSignature } from './decorator.util'
 
@@ -46,6 +46,11 @@ export interface LogMethodOptions {
    * Overrides `logResult`.
    */
   logResultFn?: LogResultFn
+
+  /**
+   * Defaults to `console`
+   */
+  logger?: CommonLogger
 }
 
 /**
@@ -65,13 +70,13 @@ export interface LogMethodOptions {
 export function _LogMethod(opt: LogMethodOptions = {}): MethodDecorator {
   return (target, key, descriptor) => {
     if (typeof descriptor.value !== 'function') {
-      throw new TypeError('@LogMillis can be applied only to methods')
+      throw new TypeError('@_LogMethod can be applied only to methods')
     }
 
     const originalFn = descriptor.value
     const keyStr = String(key)
 
-    const { avg, noLogArgs, logStart, logResult, noLogResultLength } = opt
+    const { avg, noLogArgs, logStart, logResult, noLogResultLength, logger = console } = opt
     let { logResultFn } = opt
     if (!logResultFn) {
       if (logResult) {
@@ -93,7 +98,7 @@ export function _LogMethod(opt: LogMethodOptions = {}): MethodDecorator {
       const methodSignature = _getMethodSignature(ctx, keyStr)
       const argsStr = _getArgsSignature(args, noLogArgs)
       const callSignature = `${methodSignature}(${argsStr}) #${++count}`
-      if (logStart) console.log(`>> ${callSignature}`)
+      if (logStart) logger.log(`>> ${callSignature}`)
 
       try {
         const res = originalFn.apply(ctx, args)
@@ -102,20 +107,20 @@ export function _LogMethod(opt: LogMethodOptions = {}): MethodDecorator {
           // Result is a Promise, will wait for resolution or rejection
           return res
             .then((r: any) => {
-              logFinished(callSignature, started, sma, logResultFn, r)
+              logFinished(logger, callSignature, started, sma, logResultFn, r)
               return r
             })
             .catch((err: any) => {
-              logFinished(callSignature, started, sma, logResultFn, undefined, err)
+              logFinished(logger, callSignature, started, sma, logResultFn, undefined, err)
               return Promise.reject(err)
             })
         } else {
           // not a Promise
-          logFinished(callSignature, started, sma, logResultFn, res)
+          logFinished(logger, callSignature, started, sma, logResultFn, res)
           return res
         }
       } catch (err) {
-        logFinished(callSignature, started, sma, logResultFn, undefined, err)
+        logFinished(logger, callSignature, started, sma, logResultFn, undefined, err)
         throw err // rethrow
       }
     } as any
@@ -125,6 +130,7 @@ export function _LogMethod(opt: LogMethodOptions = {}): MethodDecorator {
 }
 
 function logFinished(
+  logger: CommonLogger,
   callSignature: string,
   started: number,
   sma?: SimpleMovingAverage,
@@ -146,5 +152,5 @@ function logFinished(
     t.push(...logResultFn(res))
   }
 
-  console.log(t.filter(Boolean).join(' '))
+  logger.log(t.filter(Boolean).join(' '))
 }

package/src/decorators/memo.decorator.ts

@@ -4,13 +4,20 @@
 // http://inlehmansterms.net/2015/03/01/javascript-memoization/
 // https://community.risingstack.com/the-worlds-fastest-javascript-memoization-library/
 
+import { CommonLogger } from '../log/commonLogger'
 import { _since } from '../time/time.util'
 import { AnyObject } from '../types'
 import { _getArgsSignature, _getMethodSignature, _getTargetMethodSignature } from './decorator.util'
 import { jsonMemoSerializer, MapMemoCache, MemoCache } from './memo.util'
 
 export interface MemoOptions {
+  /**
+   * Default to false
+   */
   logHit?: boolean
+  /**
+   * Default to false
+   */
   logMiss?: boolean
 
   /**
@@ -18,6 +25,11 @@ export interface MemoOptions {
    */
   noLogArgs?: boolean
 
+  /**
+   * Default to `console`
+   */
+  logger?: CommonLogger
+
   /**
    * Provide a custom implementation of MemoCache.
    * Function that creates an instance of `MemoCache`.
@@ -73,13 +85,14 @@ export const _Memo =
     const cache = new Map<AnyObject, MemoCache>()
 
     const {
-      logHit,
-      logMiss,
-      noLogArgs,
+      logHit = false,
+      logMiss = false,
+      noLogArgs = false,
+      logger = console,
       cacheFactory = () => new MapMemoCache(),
       cacheKeyFn = jsonMemoSerializer,
-      noCacheRejected,
-      noCacheResolved,
+      noCacheRejected = false,
+      noCacheResolved = false,
     } = opt
 
     const awaitPromise = Boolean(noCacheRejected || noCacheResolved)
@@ -95,11 +108,8 @@ export const _Memo =
         cache.set(ctx, cacheFactory())
       } else if (cache.get(ctx)!.has(cacheKey)) {
         if (logHit) {
-          console.log(
-            `${_getMethodSignature(ctx, keyStr)}(${_getArgsSignature(
-              args,
-              noLogArgs,
-            )}) @memoInstance hit`,
+          logger.log(
+            `${_getMethodSignature(ctx, keyStr)}(${_getArgsSignature(args, noLogArgs)}) @_Memo hit`,
           )
         }
 
@@ -121,11 +131,11 @@ export const _Memo =
           .then(res => {
             // console.log('RESOLVED', res)
             if (logMiss) {
-              console.log(
+              logger.log(
                 `${_getMethodSignature(ctx, keyStr)}(${_getArgsSignature(
                   args,
                   noLogArgs,
-                )}) @memo miss resolved (${_since(started)})`,
+                )}) @_Memo miss resolved (${_since(started)})`,
               )
             }
 
@@ -138,11 +148,11 @@ export const _Memo =
           .catch(err => {
             // console.log('REJECTED', err)
             if (logMiss) {
-              console.log(
+              logger.log(
                 `${_getMethodSignature(ctx, keyStr)}(${_getArgsSignature(
                   args,
                   noLogArgs,
-                )}) @memo miss rejected (${_since(started)})`,
+                )}) @_Memo miss rejected (${_since(started)})`,
               )
             }
 
@@ -157,11 +167,11 @@ export const _Memo =
           })
       } else {
         if (logMiss) {
-          console.log(
+          logger.log(
             `${_getMethodSignature(ctx, keyStr)}(${_getArgsSignature(
               args,
               noLogArgs,
-            )}) @memo miss (${_since(started)})`,
+            )}) @_Memo miss (${_since(started)})`,
           )
         }
 
@@ -170,7 +180,7 @@ export const _Memo =
       }
     } as any
     ;(descriptor.value as any).dropCache = () => {
-      console.log(`${methodSignature} @memo.dropCache()`)
+      logger.log(`${methodSignature} @_Memo.dropCache()`)
       cache.forEach(memoCache => memoCache.clear())
       cache.clear()
     }

package/src/decorators/memoFn.ts

@@ -12,11 +12,12 @@ export function _memoFn<T extends (...args: any[]) => any>(
   opt: MemoOptions = {},
 ): T & MemoizedFunction {
   const {
-    logHit,
-    logMiss,
-    noLogArgs,
-    noCacheRejected,
-    noCacheResolved,
+    logHit = false,
+    logMiss = false,
+    noLogArgs = false,
+    logger = console,
+    noCacheRejected = false,
+    noCacheResolved = false,
     cacheFactory = () => new MapMemoCache(),
     cacheKeyFn = jsonMemoSerializer,
   } = opt
@@ -31,7 +32,7 @@ export function _memoFn<T extends (...args: any[]) => any>(
 
     if (cache.has(cacheKey)) {
       if (logHit) {
-        console.log(`${fnName}(${_getArgsSignature(args, noLogArgs)}) memoFn hit`)
+        logger.log(`${fnName}(${_getArgsSignature(args, noLogArgs)}) memoFn hit`)
       }
 
       const res = cache.get(cacheKey)
@@ -52,7 +53,7 @@ export function _memoFn<T extends (...args: any[]) => any>(
         .then(res => {
           // console.log('RESOLVED', res)
           if (logMiss) {
-            console.log(
+            logger.log(
               `${fnName}(${_getArgsSignature(args, noLogArgs)}) memoFn miss resolved (${_since(
                 started,
               )})`,
@@ -68,7 +69,7 @@ export function _memoFn<T extends (...args: any[]) => any>(
         .catch(err => {
           // console.log('REJECTED', err)
           if (logMiss) {
-            console.log(
+            logger.log(
               `${fnName}(${_getArgsSignature(args, noLogArgs)}) memoFn miss rejected (${_since(
                 started,
               )})`,
@@ -86,8 +87,8 @@ export function _memoFn<T extends (...args: any[]) => any>(
         }) as any
     } else {
       if (logMiss) {
-        console.log(
-          `${fnName}(${_getArgsSignature(args, noLogArgs)}) @memo miss (${_since(started)})`,
+        logger.log(
+          `${fnName}(${_getArgsSignature(args, noLogArgs)}) memoFn miss (${_since(started)})`,
         )
       }
 

package/src/decorators/memoSimple.decorator.ts

@@ -11,6 +11,7 @@ Otherwise resorts to JSON.stringify.
 Benchmark shows similar perf for ObjectCache and MapCache.
  */
 
+import { CommonLogger } from '../log/commonLogger'
 import { _getArgsSignature, _getTargetMethodSignature } from './decorator.util'
 import { jsonMemoSerializer, MapMemoCache, MemoCache } from './memo.util'
 
@@ -18,6 +19,7 @@ export interface MemoOpts {
   logHit?: boolean
   logMiss?: boolean
   noLogArgs?: boolean
+  logger?: CommonLogger
 }
 
 // memoSimple decorator is NOT exported. Only used in benchmarks currently
@@ -55,7 +57,7 @@ export const memoSimple =
    */
     const cache: MemoCache = new MapMemoCache()
 
-    const { logHit, logMiss, noLogArgs } = opt
+    const { logHit, logMiss, noLogArgs, logger = console } = opt
     const keyStr = String(key)
     const methodSignature = _getTargetMethodSignature(target, keyStr)
 
@@ -65,7 +67,7 @@ export const memoSimple =
 
       if (cache.has(cacheKey)) {
         if (logHit) {
-          console.log(`${methodSignature}(${_getArgsSignature(args, noLogArgs)}) @memo hit`)
+          logger.log(`${methodSignature}(${_getArgsSignature(args, noLogArgs)}) @memo hit`)
         }
         return cache.get(cacheKey)
       }
@@ -75,7 +77,7 @@ export const memoSimple =
       const res: any = originalFn.apply(ctx, args)
 
       if (logMiss) {
-        console.log(
+        logger.log(
           `${methodSignature}(${_getArgsSignature(args, noLogArgs)}) @memo miss (${
             Date.now() - d
           } ms)`,
@@ -87,7 +89,7 @@ export const memoSimple =
       return res
     } as any
     ;(descriptor.value as any).dropCache = () => {
-      console.log(`${methodSignature} @memo.dropCache()`)
+      logger.log(`${methodSignature} @memo.dropCache()`)
       cache.clear()
     }
 

package/src/error/error.model.ts

@@ -43,6 +43,13 @@ export interface HttpErrorData extends ErrorData {
    */
   httpStatusCode: number
 
+  /**
+   * @example
+   *
+   * GET /api/some-endpoint
+   */
+  // endpoint?: string
+
   /**
    * Set to true when the error was thrown after response headers were sent.
    */

package/src/error/tryCatch.ts

@@ -1,4 +1,4 @@
-import { _since, _stringifyAny } from '../index'
+import { _since, _stringifyAny, CommonLogger } from '../index'
 import { AnyFunction } from '../types'
 
 export interface TryCatchOptions {
@@ -17,6 +17,11 @@ export interface TryCatchOptions {
    * @default true
    */
   logError?: boolean
+
+  /**
+   * Default to `console`
+   */
+  logger?: CommonLogger
 }
 
 /**
@@ -28,10 +33,7 @@ export interface TryCatchOptions {
  * @experimental
  */
 export function _tryCatch<T extends AnyFunction>(fn: T, opt: TryCatchOptions = {}): T {
-  const { onError, logError, logSuccess } = {
-    logError: true,
-    ...opt,
-  }
+  const { onError, logError = true, logSuccess = false, logger = console } = opt
 
   const fname = fn.name || 'anonymous'
 
@@ -42,13 +44,13 @@ export function _tryCatch<T extends AnyFunction>(fn: T, opt: TryCatchOptions = {
       const r = await fn.apply(this, args)
 
       if (logSuccess) {
-        console.log(`tryCatch.${fname} succeeded in ${_since(started)}`)
+        logger.log(`tryCatch.${fname} succeeded in ${_since(started)}`)
       }
 
       return r
     } catch (err) {
       if (logError) {
-        console.warn(
+        logger.warn(
           `tryCatch.${fname} error in ${_since(started)}:\n${_stringifyAny(err, {
             includeErrorData: true,
           })}`,