@naturalcycles/js-lib 14.58.0 → 14.61.0

package/dist/array/array.util.d.ts

@@ -93,7 +93,7 @@ export declare function _groupBy<T>(items: readonly T[], mapper: Mapper<T, any>)
  * Same:
  * _sortBy([{age: 20}, {age: 10}], o => o.age)
  */
-export declare function _sortBy<T>(items: T[], mapper: Mapper<T, any>, mutate?: boolean): T[];
+export declare function _sortBy<T>(items: T[], mapper: Mapper<T, any>, mutate?: boolean, descending?: boolean): T[];
 /**
  * Like items.find(), but it tries to find from the END of the array.
  */

package/dist/array/array.util.js

@@ -140,12 +140,13 @@ exports._groupBy = _groupBy;
  * Same:
  * _sortBy([{age: 20}, {age: 10}], o => o.age)
  */
-function _sortBy(items, mapper, mutate = false) {
+function _sortBy(items, mapper, mutate = false, descending = false) {
+    const mod = descending ? -1 : 1;
     return (mutate ? items : [...items]).sort((_a, _b) => {
         const [a, b] = [_a, _b].map(mapper); // eslint-disable-line unicorn/no-array-callback-reference
         if (typeof a === 'number' && typeof b === 'number')
-            return a - b;
-        return String(a).localeCompare(String(b));
+            return (a - b) * mod;
+        return String(a).localeCompare(String(b)) * mod;
     });
 }
 exports._sortBy = _sortBy;

package/dist/index.d.ts

@@ -54,5 +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';
-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, };
-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, };
+import { CommonLogLevel, CommonLogFunction, CommonLogger, SimpleLogger, createSimpleLogger, noopLogger } 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, };

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._lazyValue = exports._defineLazyProps = exports._defineLazyProperty = exports._parseQueryString = exports.generateJsonSchemaFromData = void 0;
+exports._safeJsonStringify = exports.noopLogger = exports.createSimpleLogger = 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; } });
@@ -211,3 +211,8 @@ Object.defineProperty(exports, "_kb", { enumerable: true, get: function () { ret
 Object.defineProperty(exports, "_mb", { enumerable: true, get: function () { return size_util_1._mb; } });
 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, "noopLogger", { enumerable: true, get: function () { return commonLogger_1.noopLogger; } });
+const safeJsonStringify_1 = require("./string/safeJsonStringify");
+Object.defineProperty(exports, "_safeJsonStringify", { enumerable: true, get: function () { return safeJsonStringify_1._safeJsonStringify; } });

package/dist/log/commonLogger.d.ts

@@ -0,0 +1,49 @@
+/**
+ * These levels follow console.* naming,
+ * so you can use console[level] safely.
+ *
+ * `log` is considered default level.
+ *
+ * For simplicity - only these 3 levels are kept.
+ *
+ * @experimental
+ */
+export declare type CommonLogLevel = 'log' | 'warn' | 'error';
+/**
+ * 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.
+ *
+ * @experimental
+ */
+export declare type CommonLogFunction = (...args: any[]) => void;
+/**
+ * Interface is inspired/compatible with `console.*`
+ * So, `console` is a valid CommonLogger implementation as-is.
+ *
+ * @experimental
+ */
+export interface CommonLogger {
+    log: CommonLogFunction;
+    warn: CommonLogFunction;
+    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')`
+ *
+ * @experimental
+ */
+export interface SimpleLogger extends CommonLogFunction, CommonLogger {
+}
+/**
+ * Creates a SimpleLogger from CommonLogger.
+ *
+ * @experimental
+ */
+export declare function createSimpleLogger(logger: CommonLogger): SimpleLogger;
+/**
+ * SimpleLogger that does nothing (noop).
+ *
+ * @experimental
+ */
+export declare const noopLogger: SimpleLogger;

package/dist/log/commonLogger.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noopLogger = exports.createSimpleLogger = void 0;
+/**
+ * Creates a SimpleLogger from CommonLogger.
+ *
+ * @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.createSimpleLogger = createSimpleLogger;
+const noop = () => { };
+/**
+ * SimpleLogger that does nothing (noop).
+ *
+ * @experimental
+ */
+exports.noopLogger = createSimpleLogger({
+    log: noop,
+    warn: noop,
+    error: noop,
+});

package/dist/number/number.util.d.ts

@@ -23,7 +23,7 @@ export declare function _clamp(x: number, minIncl: number, maxIncl: number): num
  * _sortNumbers([1, 3, 2])
  * // [1, 2, 3]
  */
-export declare function _sortNumbers(numbers: number[], mutate?: boolean): number[];
+export declare function _sortNumbers(numbers: number[], mutate?: boolean, descending?: boolean): number[];
 /**
  * Same as .toFixed(), but conveniently casts the output to Number.
  *

package/dist/number/number.util.js

@@ -39,8 +39,9 @@ exports._clamp = _clamp;
  * _sortNumbers([1, 3, 2])
  * // [1, 2, 3]
  */
-function _sortNumbers(numbers, mutate = false) {
-    return (mutate ? numbers : [...numbers]).sort((a, b) => a - b);
+function _sortNumbers(numbers, mutate = false, descending = false) {
+    const mod = descending ? -1 : 1;
+    return (mutate ? numbers : [...numbers]).sort((a, b) => (a - b) * mod);
 }
 exports._sortNumbers = _sortNumbers;
 /**

package/dist/string/safeJsonStringify.d.ts

@@ -0,0 +1,7 @@
+import { Reviver } from '../types';
+/**
+ * JSON.stringify that avoids circular references, prints them as [Circular ~]
+ *
+ * Based on: https://github.com/moll/json-stringify-safe/
+ */
+export declare function _safeJsonStringify(obj: any, replacer?: Reviver, spaces?: number, cycleReplacer?: Reviver): string;

package/dist/string/safeJsonStringify.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._safeJsonStringify = void 0;
+/**
+ * JSON.stringify that avoids circular references, prints them as [Circular ~]
+ *
+ * Based on: https://github.com/moll/json-stringify-safe/
+ */
+function _safeJsonStringify(obj, replacer, spaces, cycleReplacer) {
+    try {
+        // Try native first (as it's ~3 times faster)
+        return JSON.stringify(obj, replacer, spaces);
+    }
+    catch {
+        // Native failed - resort to the "safe" serializer
+        return JSON.stringify(obj, serializer(replacer, cycleReplacer), spaces);
+    }
+}
+exports._safeJsonStringify = _safeJsonStringify;
+/* eslint-disable @typescript-eslint/no-unused-expressions, no-bitwise */
+function serializer(replacer, cycleReplacer) {
+    const stack = [];
+    const keys = [];
+    if (cycleReplacer == null) {
+        cycleReplacer = function (key, value) {
+            if (stack[0] === value)
+                return '[Circular ~]';
+            return '[Circular ~.' + keys.slice(0, stack.indexOf(value)).join('.') + ']';
+        };
+    }
+    return function (key, value) {
+        if (stack.length > 0) {
+            const thisPos = stack.indexOf(this);
+            ~thisPos ? stack.splice(thisPos + 1) : stack.push(this);
+            ~thisPos ? keys.splice(thisPos, Infinity, key) : keys.push(key);
+            if (~stack.indexOf(value)) {
+                value = cycleReplacer.call(this, key, value);
+            }
+        }
+        else {
+            stack.push(value);
+        }
+        return replacer == null ? value : replacer.call(this, key, value);
+    };
+}

package/dist/string/stringifyAny.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports._stringifyAny = void 0;
 const error_util_1 = require("../error/error.util");
 const json_util_1 = require("./json.util");
-const jsonStringifyFn = (obj, reviver, space) => JSON.stringify(obj, reviver, space);
+const safeJsonStringify_1 = require("./safeJsonStringify");
 /**
  * Inspired by inspectAny from nodejs-lib, which is based on util.inpect that is not available in the Browser.
  * Potentially can do this (with extra 2Kb gz size): https://github.com/deecewan/browser-util-inspect
@@ -83,7 +83,7 @@ function _stringifyAny(obj, opt = {}) {
         // Other
         //
         try {
-            const { stringifyFn = jsonStringifyFn } = opt;
+            const { stringifyFn = safeJsonStringify_1._safeJsonStringify } = opt;
             s = stringifyFn(obj, undefined, 2);
         }
         catch {

package/dist/types.d.ts

@@ -136,7 +136,7 @@ export declare type BaseDBEntity = Partial<SavedDBEntity>;
 export declare type Saved<E> = Merge<E, SavedDBEntity>;
 export declare type Unsaved<E> = Merge<E, BaseDBEntity>;
 /**
- * Named type for JSON.parse second argument
+ * Named type for JSON.parse / JSON.stringify second argument
  */
 export declare type Reviver = (this: any, key: string, value: any) => any;
 /**

package/dist-esm/array/array.util.js

@@ -130,12 +130,13 @@ export function _groupBy(items, mapper) {
  * Same:
  * _sortBy([{age: 20}, {age: 10}], o => o.age)
  */
-export function _sortBy(items, mapper, mutate = false) {
+export function _sortBy(items, mapper, mutate = false, descending = false) {
+    const mod = descending ? -1 : 1;
     return (mutate ? items : [...items]).sort((_a, _b) => {
         const [a, b] = [_a, _b].map(mapper); // eslint-disable-line unicorn/no-array-callback-reference
         if (typeof a === 'number' && typeof b === 'number')
-            return a - b;
-        return String(a).localeCompare(String(b));
+            return (a - b) * mod;
+        return String(a).localeCompare(String(b)) * mod;
     });
 }
 /**

package/dist-esm/index.js

@@ -50,4 +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';
-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, };
+import { createSimpleLogger, noopLogger, } 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, };

package/dist-esm/log/commonLogger.js

@@ -0,0 +1,23 @@
+/**
+ * Creates a SimpleLogger from CommonLogger.
+ *
+ * @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),
+    });
+}
+const noop = () => { };
+/**
+ * SimpleLogger that does nothing (noop).
+ *
+ * @experimental
+ */
+export const noopLogger = createSimpleLogger({
+    log: noop,
+    warn: noop,
+    error: noop,
+});

package/dist-esm/number/number.util.js

@@ -32,8 +32,9 @@ export function _clamp(x, minIncl, maxIncl) {
  * _sortNumbers([1, 3, 2])
  * // [1, 2, 3]
  */
-export function _sortNumbers(numbers, mutate = false) {
-    return (mutate ? numbers : [...numbers]).sort((a, b) => a - b);
+export function _sortNumbers(numbers, mutate = false, descending = false) {
+    const mod = descending ? -1 : 1;
+    return (mutate ? numbers : [...numbers]).sort((a, b) => (a - b) * mod);
 }
 /**
  * Same as .toFixed(), but conveniently casts the output to Number.

package/dist-esm/string/safeJsonStringify.js

@@ -0,0 +1,41 @@
+/**
+ * JSON.stringify that avoids circular references, prints them as [Circular ~]
+ *
+ * Based on: https://github.com/moll/json-stringify-safe/
+ */
+export function _safeJsonStringify(obj, replacer, spaces, cycleReplacer) {
+    try {
+        // Try native first (as it's ~3 times faster)
+        return JSON.stringify(obj, replacer, spaces);
+    }
+    catch (_a) {
+        // Native failed - resort to the "safe" serializer
+        return JSON.stringify(obj, serializer(replacer, cycleReplacer), spaces);
+    }
+}
+/* eslint-disable @typescript-eslint/no-unused-expressions, no-bitwise */
+function serializer(replacer, cycleReplacer) {
+    const stack = [];
+    const keys = [];
+    if (cycleReplacer == null) {
+        cycleReplacer = function (key, value) {
+            if (stack[0] === value)
+                return '[Circular ~]';
+            return '[Circular ~.' + keys.slice(0, stack.indexOf(value)).join('.') + ']';
+        };
+    }
+    return function (key, value) {
+        if (stack.length > 0) {
+            const thisPos = stack.indexOf(this);
+            ~thisPos ? stack.splice(thisPos + 1) : stack.push(this);
+            ~thisPos ? keys.splice(thisPos, Infinity, key) : keys.push(key);
+            if (~stack.indexOf(value)) {
+                value = cycleReplacer.call(this, key, value);
+            }
+        }
+        else {
+            stack.push(value);
+        }
+        return replacer == null ? value : replacer.call(this, key, value);
+    };
+}

package/dist-esm/string/stringifyAny.js

@@ -1,6 +1,6 @@
 import { _isErrorObject, _isHttpErrorObject, _isHttpErrorResponse } from '../error/error.util';
 import { _jsonParseIfPossible } from './json.util';
-const jsonStringifyFn = (obj, reviver, space) => JSON.stringify(obj, reviver, space);
+import { _safeJsonStringify } from './safeJsonStringify';
 /**
  * Inspired by inspectAny from nodejs-lib, which is based on util.inpect that is not available in the Browser.
  * Potentially can do this (with extra 2Kb gz size): https://github.com/deecewan/browser-util-inspect
@@ -80,7 +80,7 @@ export function _stringifyAny(obj, opt = {}) {
         // Other
         //
         try {
-            const { stringifyFn = jsonStringifyFn } = opt;
+            const { stringifyFn = _safeJsonStringify } = opt;
             s = stringifyFn(obj, undefined, 2);
         }
         catch (_a) {

package/package.json

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

package/src/array/array.util.ts

@@ -140,11 +140,17 @@ export function _groupBy<T>(items: readonly T[], mapper: Mapper<T, any>): String
  * Same:
  * _sortBy([{age: 20}, {age: 10}], o => o.age)
  */
-export function _sortBy<T>(items: T[], mapper: Mapper<T, any>, mutate = false): T[] {
+export function _sortBy<T>(
+  items: T[],
+  mapper: Mapper<T, any>,
+  mutate = false,
+  descending = false,
+): T[] {
+  const mod = descending ? -1 : 1
   return (mutate ? items : [...items]).sort((_a, _b) => {
     const [a, b] = [_a, _b].map(mapper) // eslint-disable-line unicorn/no-array-callback-reference
-    if (typeof a === 'number' && typeof b === 'number') return a - b
-    return String(a).localeCompare(String(b))
+    if (typeof a === 'number' && typeof b === 'number') return (a - b) * mod
+    return String(a).localeCompare(String(b)) * mod
   })
 }
 

package/src/index.ts

@@ -224,6 +224,15 @@ import {
 } 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 { _safeJsonStringify } from './string/safeJsonStringify'
 
 export type {
   MemoCache,
@@ -295,6 +304,10 @@ export type {
   JsonSchemaArray,
   JsonSchemaTuple,
   JsonSchemaBuilder,
+  CommonLogLevel,
+  CommonLogFunction,
+  CommonLogger,
+  SimpleLogger,
 }
 
 export {
@@ -453,4 +466,7 @@ export {
   _defineLazyProperty,
   _defineLazyProps,
   _lazyValue,
+  createSimpleLogger,
+  noopLogger,
+  _safeJsonStringify,
 }

package/src/log/commonLogger.ts

@@ -0,0 +1,65 @@
+/**
+ * These levels follow console.* naming,
+ * so you can use console[level] safely.
+ *
+ * `log` is considered default level.
+ *
+ * For simplicity - only these 3 levels are kept.
+ *
+ * @experimental
+ */
+export type CommonLogLevel = 'log' | 'warn' | 'error'
+
+/**
+ * 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.
+ *
+ * @experimental
+ */
+export type CommonLogFunction = (...args: any[]) => void
+
+/**
+ * Interface is inspired/compatible with `console.*`
+ * So, `console` is a valid CommonLogger implementation as-is.
+ *
+ * @experimental
+ */
+export interface CommonLogger {
+  log: CommonLogFunction
+  warn: CommonLogFunction
+  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')`
+ *
+ * @experimental
+ */
+export interface SimpleLogger extends CommonLogFunction, CommonLogger {}
+
+/**
+ * Creates a SimpleLogger from CommonLogger.
+ *
+ * @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),
+  })
+}
+
+const noop = () => {}
+
+/**
+ * SimpleLogger that does nothing (noop).
+ *
+ * @experimental
+ */
+export const noopLogger: SimpleLogger = createSimpleLogger({
+  log: noop,
+  warn: noop,
+  error: noop,
+})

package/src/number/number.util.ts

@@ -37,8 +37,9 @@ export function _clamp(x: number, minIncl: number, maxIncl: number): number {
  * _sortNumbers([1, 3, 2])
  * // [1, 2, 3]
  */
-export function _sortNumbers(numbers: number[], mutate = false): number[] {
-  return (mutate ? numbers : [...numbers]).sort((a, b) => a - b)
+export function _sortNumbers(numbers: number[], mutate = false, descending = false): number[] {
+  const mod = descending ? -1 : 1
+  return (mutate ? numbers : [...numbers]).sort((a, b) => (a - b) * mod)
 }
 
 /**

package/src/string/safeJsonStringify.ts

@@ -0,0 +1,50 @@
+import { Reviver } from '../types'
+
+/**
+ * JSON.stringify that avoids circular references, prints them as [Circular ~]
+ *
+ * Based on: https://github.com/moll/json-stringify-safe/
+ */
+export function _safeJsonStringify(
+  obj: any,
+  replacer?: Reviver,
+  spaces?: number,
+  cycleReplacer?: Reviver,
+): string {
+  try {
+    // Try native first (as it's ~3 times faster)
+    return JSON.stringify(obj, replacer, spaces)
+  } catch {
+    // Native failed - resort to the "safe" serializer
+    return JSON.stringify(obj, serializer(replacer, cycleReplacer), spaces)
+  }
+}
+
+/* eslint-disable @typescript-eslint/no-unused-expressions, no-bitwise */
+
+function serializer(replacer?: Reviver, cycleReplacer?: Reviver): Reviver {
+  const stack: any[] = []
+  const keys: string[] = []
+
+  if (cycleReplacer == null) {
+    cycleReplacer = function (key, value) {
+      if (stack[0] === value) return '[Circular ~]'
+      return '[Circular ~.' + keys.slice(0, stack.indexOf(value)).join('.') + ']'
+    }
+  }
+
+  return function (key, value) {
+    if (stack.length > 0) {
+      const thisPos = stack.indexOf(this)
+      ~thisPos ? stack.splice(thisPos + 1) : stack.push(this)
+      ~thisPos ? keys.splice(thisPos, Infinity, key) : keys.push(key)
+      if (~stack.indexOf(value)) {
+        value = cycleReplacer!.call(this, key, value)
+      }
+    } else {
+      stack.push(value)
+    }
+
+    return replacer == null ? value : replacer.call(this, key, value)
+  }
+}

package/src/string/stringifyAny.ts

@@ -1,12 +1,10 @@
 import { _isErrorObject, _isHttpErrorObject, _isHttpErrorResponse } from '../error/error.util'
 import { Reviver } from '../types'
 import { _jsonParseIfPossible } from './json.util'
+import { _safeJsonStringify } from './safeJsonStringify'
 
 export type JsonStringifyFunction = (obj: any, reviver?: Reviver, space?: number) => string
 
-const jsonStringifyFn: JsonStringifyFunction = (obj, reviver, space) =>
-  JSON.stringify(obj, reviver, space)
-
 export interface StringifyAnyOptions {
   /**
    * @default 10_000
@@ -116,7 +114,7 @@ export function _stringifyAny(obj: any, opt: StringifyAnyOptions = {}): string {
     // Other
     //
     try {
-      const { stringifyFn = jsonStringifyFn } = opt
+      const { stringifyFn = _safeJsonStringify } = opt
 
       s = stringifyFn(obj, undefined, 2)
     } catch {

package/src/types.ts

@@ -165,7 +165,7 @@ export type Saved<E> = Merge<E, SavedDBEntity>
 export type Unsaved<E> = Merge<E, BaseDBEntity>
 
 /**
- * Named type for JSON.parse second argument
+ * Named type for JSON.parse / JSON.stringify second argument
  */
 export type Reviver = (this: any, key: string, value: any) => any