@naturalcycles/js-lib 14.63.0 → 14.67.0

package/dist/decorators/logMethod.decorator.d.ts

@@ -1,3 +1,4 @@
+import { CommonLogger } from '..';
 /**
  * $r - result
  *
@@ -36,6 +37,10 @@ export interface LogMethodOptions {
      * Overrides `logResult`.
      */
     logResultFn?: LogResultFn;
+    /**
+     * Defaults to `console`
+     */
+    logger?: CommonLogger;
 }
 /**
  * Console-logs when method had started, when it finished, time taken and if error happened.

package/dist/decorators/logMethod.decorator.js

@@ -21,11 +21,11 @@ const decorator_util_1 = require("./decorator.util");
 function _LogMethod(opt = {}) {
     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) {
@@ -46,29 +46,29 @@ function _LogMethod(opt = {}) {
             const argsStr = (0, decorator_util_1._getArgsSignature)(args, noLogArgs);
             const callSignature = `${methodSignature}(${argsStr}) #${++count}`;
             if (logStart)
-                console.log(`>> ${callSignature}`);
+                logger.log(`>> ${callSignature}`);
             try {
                 const res = originalFn.apply(ctx, args);
                 if (res && typeof res.then === 'function') {
                     // Result is a Promise, will wait for resolution or rejection
                     return res
                         .then((r) => {
-                        logFinished(callSignature, started, sma, logResultFn, r);
+                        logFinished(logger, callSignature, started, sma, logResultFn, r);
                         return r;
                     })
                         .catch((err) => {
-                        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
             }
         };
@@ -76,7 +76,7 @@ function _LogMethod(opt = {}) {
     };
 }
 exports._LogMethod = _LogMethod;
-function logFinished(callSignature, started, sma, logResultFn, res, err) {
+function logFinished(logger, callSignature, started, sma, logResultFn, res, err) {
     const millis = Date.now() - started;
     const t = ['<<', callSignature, 'took', (0, time_util_1._ms)(millis)];
     if (sma) {
@@ -88,5 +88,5 @@ function logFinished(callSignature, started, sma, logResultFn, res, err) {
     else if (logResultFn) {
         t.push(...logResultFn(res));
     }
-    console.log(t.filter(Boolean).join(' '));
+    logger.log(t.filter(Boolean).join(' '));
 }

package/dist/decorators/memo.decorator.d.ts

@@ -1,11 +1,22 @@
+import { CommonLogger } from '../log/commonLogger';
 import { MemoCache } from './memo.util';
 export interface MemoOptions {
+    /**
+     * Default to false
+     */
     logHit?: boolean;
+    /**
+     * Default to false
+     */
     logMiss?: boolean;
     /**
      * Skip logging method arguments.
      */
     noLogArgs?: boolean;
+    /**
+     * Default to `console`
+     */
+    logger?: CommonLogger;
     /**
      * Provide a custom implementation of MemoCache.
      * Function that creates an instance of `MemoCache`.

package/dist/decorators/memo.decorator.js

@@ -33,7 +33,7 @@ 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 memo_util_1.MapMemoCache(), cacheKeyFn = memo_util_1.jsonMemoSerializer, noCacheRejected, noCacheResolved, } = opt;
+    const { logHit = false, logMiss = false, noLogArgs = false, logger = console, cacheFactory = () => new memo_util_1.MapMemoCache(), cacheKeyFn = memo_util_1.jsonMemoSerializer, noCacheRejected = false, noCacheResolved = false, } = opt;
     const awaitPromise = Boolean(noCacheRejected || noCacheResolved);
     const keyStr = String(key);
     const methodSignature = (0, decorator_util_1._getTargetMethodSignature)(target, keyStr);
@@ -45,7 +45,7 @@ const _Memo = (opt = {}) => (target, key, descriptor) => {
         }
         else if (cache.get(ctx).has(cacheKey)) {
             if (logHit) {
-                console.log(`${(0, decorator_util_1._getMethodSignature)(ctx, keyStr)}(${(0, decorator_util_1._getArgsSignature)(args, noLogArgs)}) @memoInstance hit`);
+                logger.log(`${(0, decorator_util_1._getMethodSignature)(ctx, keyStr)}(${(0, decorator_util_1._getArgsSignature)(args, noLogArgs)}) @_Memo hit`);
             }
             const res = cache.get(ctx).get(cacheKey);
             if (awaitPromise) {
@@ -62,7 +62,7 @@ const _Memo = (opt = {}) => (target, key, descriptor) => {
                 .then(res => {
                 // console.log('RESOLVED', res)
                 if (logMiss) {
-                    console.log(`${(0, decorator_util_1._getMethodSignature)(ctx, keyStr)}(${(0, decorator_util_1._getArgsSignature)(args, noLogArgs)}) @memo miss resolved (${(0, time_util_1._since)(started)})`);
+                    logger.log(`${(0, decorator_util_1._getMethodSignature)(ctx, keyStr)}(${(0, decorator_util_1._getArgsSignature)(args, noLogArgs)}) @_Memo miss resolved (${(0, time_util_1._since)(started)})`);
                 }
                 if (!noCacheResolved) {
                     cache.get(ctx).set(cacheKey, res);
@@ -72,7 +72,7 @@ const _Memo = (opt = {}) => (target, key, descriptor) => {
                 .catch(err => {
                 // console.log('REJECTED', err)
                 if (logMiss) {
-                    console.log(`${(0, decorator_util_1._getMethodSignature)(ctx, keyStr)}(${(0, decorator_util_1._getArgsSignature)(args, noLogArgs)}) @memo miss rejected (${(0, time_util_1._since)(started)})`);
+                    logger.log(`${(0, decorator_util_1._getMethodSignature)(ctx, keyStr)}(${(0, decorator_util_1._getArgsSignature)(args, noLogArgs)}) @_Memo miss rejected (${(0, time_util_1._since)(started)})`);
                 }
                 if (!noCacheRejected) {
                     // We put it to cache as raw Error, not Promise.reject(err)
@@ -85,14 +85,14 @@ const _Memo = (opt = {}) => (target, key, descriptor) => {
         }
         else {
             if (logMiss) {
-                console.log(`${(0, decorator_util_1._getMethodSignature)(ctx, keyStr)}(${(0, decorator_util_1._getArgsSignature)(args, noLogArgs)}) @memo miss (${(0, time_util_1._since)(started)})`);
+                logger.log(`${(0, decorator_util_1._getMethodSignature)(ctx, keyStr)}(${(0, decorator_util_1._getArgsSignature)(args, noLogArgs)}) @_Memo miss (${(0, time_util_1._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/decorators/memoFn.js

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

package/dist/decorators/memoSimple.decorator.d.ts

@@ -1,7 +1,9 @@
+import { CommonLogger } from '../log/commonLogger';
 export interface MemoOpts {
     logHit?: boolean;
     logMiss?: boolean;
     noLogArgs?: boolean;
+    logger?: CommonLogger;
 }
 /**
  * Memoizes the method of the class, so it caches the output and returns the cached version if the "key"

package/dist/decorators/memoSimple.decorator.js

@@ -6,12 +6,6 @@
 // https://community.risingstack.com/the-worlds-fastest-javascript-memoization-library/
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.memoSimple = void 0;
-/*
-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.
- */
 const decorator_util_1 = require("./decorator.util");
 const memo_util_1 = require("./memo.util");
 // memoSimple decorator is NOT exported. Only used in benchmarks currently
@@ -43,7 +37,7 @@ const memoSimple = (opt = {}) => (target, key, descriptor) => {
   }
    */
     const cache = new memo_util_1.MapMemoCache();
-    const { logHit, logMiss, noLogArgs } = opt;
+    const { logHit, logMiss, noLogArgs, logger = console } = opt;
     const keyStr = String(key);
     const methodSignature = (0, decorator_util_1._getTargetMethodSignature)(target, keyStr);
     descriptor.value = function (...args) {
@@ -51,20 +45,20 @@ const memoSimple = (opt = {}) => (target, key, descriptor) => {
         const cacheKey = (0, memo_util_1.jsonMemoSerializer)(args);
         if (cache.has(cacheKey)) {
             if (logHit) {
-                console.log(`${methodSignature}(${(0, decorator_util_1._getArgsSignature)(args, noLogArgs)}) @memo hit`);
+                logger.log(`${methodSignature}(${(0, decorator_util_1._getArgsSignature)(args, noLogArgs)}) @memo hit`);
             }
             return cache.get(cacheKey);
         }
         const d = Date.now();
         const res = originalFn.apply(ctx, args);
         if (logMiss) {
-            console.log(`${methodSignature}(${(0, decorator_util_1._getArgsSignature)(args, noLogArgs)}) @memo miss (${Date.now() - d} ms)`);
+            logger.log(`${methodSignature}(${(0, decorator_util_1._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/error/error.model.d.ts

@@ -36,6 +36,11 @@ export interface HttpErrorData extends ErrorData {
      * @default 500
      */
     httpStatusCode: number;
+    /**
+     * @example
+     *
+     * GET /api/some-endpoint
+     */
     /**
      * Set to true when the error was thrown after response headers were sent.
      */

package/dist/error/tryCatch.d.ts

@@ -1,3 +1,4 @@
+import { CommonLogger } from '../index';
 import { AnyFunction } from '../types';
 export interface TryCatchOptions {
     /**
@@ -13,6 +14,10 @@ export interface TryCatchOptions {
      * @default true
      */
     logError?: boolean;
+    /**
+     * Default to `console`
+     */
+    logger?: CommonLogger;
 }
 /**
  * Decorates a function with "try/catch", so it'll never reject/throw.

package/dist/error/tryCatch.js

@@ -11,23 +11,20 @@ const index_1 = require("../index");
  * @experimental
  */
 function _tryCatch(fn, opt = {}) {
-    const { onError, logError, logSuccess } = {
-        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 ${(0, index_1._since)(started)}`);
+                logger.log(`tryCatch.${fname} succeeded in ${(0, index_1._since)(started)}`);
             }
             return r;
         }
         catch (err) {
             if (logError) {
-                console.warn(`tryCatch.${fname} error in ${(0, index_1._since)(started)}:\n${(0, index_1._stringifyAny)(err, {
+                logger.warn(`tryCatch.${fname} error in ${(0, index_1._since)(started)}:\n${(0, index_1._stringifyAny)(err, {
                     includeErrorData: true,
                 })}`);
             }

package/dist/index.d.ts

@@ -54,7 +54,7 @@ import { Class, ConditionalExcept, ConditionalPick, Merge, Promisable, PromiseVa
 import { AsyncMapper, AsyncPredicate, BaseDBEntity, CreatedUpdated, CreatedUpdatedId, ObjectWithId, AnyObjectWithId, Saved, Unsaved, BatchResult, InstanceId, IsoDate, IsoDateTime, KeyValueTuple, Mapper, ObjectMapper, ObjectPredicate, Predicate, PromiseMap, AnyObject, AnyFunction, Reviver, SavedDBEntity, StringMap, UnixTimestamp, ValueOf, ValuesOf, _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 { CommonLogLevel, CommonLogFunction, CommonLogger, SimpleLogger, createSimpleLogger, noopLogger } from './log/commonLogger';
+import { CommonLogLevel, CommonLogFunction, CommonLogger, commonLoggerMinLevel, noopLogger, commonLogLevelNumber, commonLoggerPipe } from './log/commonLogger';
 import { _safeJsonStringify } from './string/safeJsonStringify';
-export type { MemoCache, PromiseDecoratorCfg, PromiseDecoratorResp, ErrorData, ErrorObject, HttpErrorData, HttpErrorResponse, Admin401ErrorData, Admin403ErrorData, StringMap, PromiseMap, AnyObject, AnyFunction, ValuesOf, ValueOf, KeyValueTuple, ObjectMapper, ObjectPredicate, InstanceId, IsoDate, IsoDateTime, Reviver, PMapOptions, Mapper, AsyncMapper, Predicate, AsyncPredicate, BatchResult, DeferredPromise, PRetryOptions, PTimeoutOptions, TryCatchOptions, StringifyAnyOptions, JsonStringifyFunction, Merge, ReadonlyDeep, Promisable, PromiseValue, Simplify, ConditionalPick, ConditionalExcept, Class, UnixTimestamp, BaseDBEntity, SavedDBEntity, Saved, Unsaved, CreatedUpdated, CreatedUpdatedId, ObjectWithId, AnyObjectWithId, JsonSchema, JsonSchemaAny, JsonSchemaOneOf, JsonSchemaAllOf, JsonSchemaAnyOf, JsonSchemaNot, JsonSchemaRef, JsonSchemaConst, JsonSchemaEnum, JsonSchemaString, JsonSchemaNumber, JsonSchemaBoolean, JsonSchemaNull, JsonSchemaRootObject, JsonSchemaObject, JsonSchemaArray, JsonSchemaTuple, JsonSchemaBuilder, CommonLogLevel, CommonLogFunction, CommonLogger, SimpleLogger, };
-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 type { MemoCache, PromiseDecoratorCfg, PromiseDecoratorResp, ErrorData, ErrorObject, HttpErrorData, HttpErrorResponse, Admin401ErrorData, Admin403ErrorData, StringMap, PromiseMap, AnyObject, AnyFunction, ValuesOf, ValueOf, KeyValueTuple, ObjectMapper, ObjectPredicate, InstanceId, IsoDate, IsoDateTime, Reviver, PMapOptions, Mapper, AsyncMapper, Predicate, AsyncPredicate, BatchResult, DeferredPromise, PRetryOptions, PTimeoutOptions, TryCatchOptions, StringifyAnyOptions, JsonStringifyFunction, Merge, ReadonlyDeep, Promisable, PromiseValue, Simplify, ConditionalPick, ConditionalExcept, Class, UnixTimestamp, BaseDBEntity, SavedDBEntity, Saved, Unsaved, CreatedUpdated, CreatedUpdatedId, ObjectWithId, AnyObjectWithId, JsonSchema, JsonSchemaAny, JsonSchemaOneOf, JsonSchemaAllOf, JsonSchemaAnyOf, JsonSchemaNot, JsonSchemaRef, JsonSchemaConst, JsonSchemaEnum, JsonSchemaString, JsonSchemaNumber, JsonSchemaBoolean, JsonSchemaNull, JsonSchemaRootObject, JsonSchemaObject, JsonSchemaArray, JsonSchemaTuple, JsonSchemaBuilder, CommonLogLevel, CommonLogFunction, CommonLogger, };
+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/index.js

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

package/dist/log/commonLogger.d.ts

@@ -9,6 +9,7 @@
  * @experimental
  */
 export declare type CommonLogLevel = 'log' | 'warn' | 'error';
+export declare const commonLogLevelNumber: Record<CommonLogLevel, number>;
 /**
  * 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.
@@ -28,22 +29,16 @@ export interface CommonLogger {
     error: CommonLogFunction;
 }
 /**
- * Same as CommonLogger, but also is a "convenience function" itself.
- * So you can do `logger('hey')` which is the same as `logger.log('hey')`
+ * SimpleLogger that does nothing (noop).
  *
  * @experimental
  */
-export interface SimpleLogger extends CommonLogFunction, CommonLogger {
-}
+export declare const noopLogger: CommonLogger;
 /**
- * Creates a SimpleLogger from CommonLogger.
- *
- * @experimental
+ * Creates a "child" logger that is "limited" to the specified CommonLogLevel.
  */
-export declare function createSimpleLogger(logger: CommonLogger): SimpleLogger;
+export declare function commonLoggerMinLevel(logger: CommonLogger, minLevel: CommonLogLevel, mutate?: boolean): CommonLogger;
 /**
- * SimpleLogger that does nothing (noop).
- *
- * @experimental
+ * Creates a "proxy" CommonLogger that pipes log messages to all provided sub-loggers.
  */
-export declare const noopLogger: SimpleLogger;
+export declare function commonLoggerPipe(loggers: CommonLogger[]): CommonLogger;

package/dist/log/commonLogger.js

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

package/dist/promise/pRetry.d.ts

@@ -1,3 +1,4 @@
+import { CommonLogger } from '..';
 export interface PRetryOptions {
     /**
      * How many attempts to try.
@@ -52,6 +53,10 @@ export interface PRetryOptions {
      * @default false
      */
     logNone?: boolean;
+    /**
+     * Default to `console`
+     */
+    logger?: CommonLogger;
 }
 /**
  * Returns a Function (!), enhanced with retry capabilities.

package/dist/promise/pRetry.js

@@ -8,7 +8,7 @@ const __1 = require("..");
  */
 // eslint-disable-next-line @typescript-eslint/ban-types
 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;
@@ -26,17 +26,17 @@ 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 ${(0, __1._since)(started)}`);
+                        logger.log(`${fname} attempt #${attempt} succeeded in ${(0, __1._since)(started)}`);
                     }
                     resolve(r);
                 }
                 catch (err) {
                     if (logFailures) {
-                        console.warn(`${fname} attempt #${attempt} error in ${(0, __1._since)(started)}:\n${(0, __1._stringifyAny)(err, {
+                        logger.warn(`${fname} attempt #${attempt} error in ${(0, __1._since)(started)}:\n${(0, __1._stringifyAny)(err, {
                             includeErrorData: true,
                         })}`);
                     }

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

@@ -18,11 +18,11 @@ import { _getArgsSignature, _getMethodSignature } from './decorator.util';
 export function _LogMethod(opt = {}) {
     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) {
@@ -43,36 +43,36 @@ export function _LogMethod(opt = {}) {
             const argsStr = _getArgsSignature(args, noLogArgs);
             const callSignature = `${methodSignature}(${argsStr}) #${++count}`;
             if (logStart)
-                console.log(`>> ${callSignature}`);
+                logger.log(`>> ${callSignature}`);
             try {
                 const res = originalFn.apply(ctx, args);
                 if (res && typeof res.then === 'function') {
                     // Result is a Promise, will wait for resolution or rejection
                     return res
                         .then((r) => {
-                        logFinished(callSignature, started, sma, logResultFn, r);
+                        logFinished(logger, callSignature, started, sma, logResultFn, r);
                         return r;
                     })
                         .catch((err) => {
-                        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
             }
         };
         return descriptor;
     };
 }
-function logFinished(callSignature, started, sma, logResultFn, res, err) {
+function logFinished(logger, callSignature, started, sma, logResultFn, res, err) {
     const millis = Date.now() - started;
     const t = ['<<', callSignature, 'took', _ms(millis)];
     if (sma) {
@@ -84,5 +84,5 @@ function logFinished(callSignature, started, sma, logResultFn, res, err) {
     else if (logResultFn) {
         t.push(...logResultFn(res));
     }
-    console.log(t.filter(Boolean).join(' '));
+    logger.log(t.filter(Boolean).join(' '));
 }