@naturalcycles/js-lib 14.190.0 → 14.191.0

package/dist/decorators/logMethod.decorator.js

@@ -27,7 +27,7 @@ function _LogMethod(opt = {}) {
         let { logResultFn } = opt;
         if (!logResultFn) {
             if (logResult) {
-                logResultFn = r => ['result:', (0, __1._stringifyAny)(r)];
+                logResultFn = r => ['result:', (0, __1._stringify)(r)];
             }
             else if (logResultLength) {
                 logResultFn = r => (Array.isArray(r) ? [`result: ${r.length} items`] : []);

package/dist/error/assert.js

@@ -36,7 +36,7 @@ exports._assert = _assert;
 function _assertEquals(actual, expected, message, errorData) {
     if (actual !== expected) {
         const msg = message ||
-            ['not equal', `expected: ${(0, __1._stringifyAny)(expected)}`, `got     : ${(0, __1._stringifyAny)(actual)}`]
+            ['not equal', `expected: ${(0, __1._stringify)(expected)}`, `got     : ${(0, __1._stringify)(actual)}`]
                 .filter(Boolean)
                 .join('\n');
         throw new __1.AssertionError(msg, {
@@ -55,11 +55,7 @@ exports._assertEquals = _assertEquals;
 function _assertDeepEquals(actual, expected, message, errorData) {
     if (!(0, __1._deepEquals)(actual, expected)) {
         const msg = message ||
-            [
-                `not deeply equal`,
-                `expected: ${(0, __1._stringifyAny)(expected)}`,
-                `got     : ${(0, __1._stringifyAny)(actual)}`,
-            ]
+            [`not deeply equal`, `expected: ${(0, __1._stringify)(expected)}`, `got     : ${(0, __1._stringify)(actual)}`]
                 .filter(Boolean)
                 .join('\n');
         throw new __1.AssertionError(msg, {

package/dist/error/error.util.d.ts

@@ -12,7 +12,7 @@ export declare function _anyToError<ERROR_TYPE extends Error = Error>(o: any, er
  * Converts "anything" to ErrorObject.
  * Detects if it's HttpErrorResponse, HttpErrorObject, ErrorObject, Error, etc..
  * If object is Error - Error.message will be used.
- * Objects (not Errors) get converted to prettified JSON string (via `_stringifyAny`).
+ * Objects (not Errors) get converted to prettified JSON string (via `_stringify`).
  */
 export declare function _anyToErrorObject<DATA_TYPE extends ErrorData = ErrorData>(o: any, errorData?: Partial<DATA_TYPE>): ErrorObject<DATA_TYPE>;
 export declare function _errorLikeToErrorObject<DATA_TYPE extends ErrorData = ErrorData>(e: AppError<DATA_TYPE> | Error | ErrorLike): ErrorObject<DATA_TYPE>;

package/dist/error/error.util.js

@@ -34,7 +34,7 @@ exports._anyToError = _anyToError;
  * Converts "anything" to ErrorObject.
  * Detects if it's HttpErrorResponse, HttpErrorObject, ErrorObject, Error, etc..
  * If object is Error - Error.message will be used.
- * Objects (not Errors) get converted to prettified JSON string (via `_stringifyAny`).
+ * Objects (not Errors) get converted to prettified JSON string (via `_stringify`).
  */
 function _anyToErrorObject(o, errorData) {
     let eo;
@@ -57,7 +57,7 @@ function _anyToErrorObject(o, errorData) {
             // so, fair to return `data: {}` in the end
             // Also we're sure it includes no "error name", e.g no `Error: ...`,
             // so, fair to include `name: 'Error'`
-            const message = (0, __1._stringifyAny)(o);
+            const message = (0, __1._stringify)(o);
             eo = {
                 name: 'Error',
                 message,

package/dist/error/try.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports._expectedErrorString = exports.pExpectedErrorString = exports.pExpectedError = exports._expectedError = exports.pTry = exports._try = void 0;
-const stringifyAny_1 = require("../string/stringifyAny");
+const stringify_1 = require("../string/stringify");
 const assert_1 = require("./assert");
 const error_util_1 = require("./error.util");
 /**
@@ -101,7 +101,7 @@ exports.pExpectedError = pExpectedError;
  */
 async function pExpectedErrorString(promise, errorClass) {
     const err = await pExpectedError(promise, errorClass);
-    return (0, stringifyAny_1._stringifyAny)(err);
+    return (0, stringify_1._stringify)(err);
 }
 exports.pExpectedErrorString = pExpectedErrorString;
 /**
@@ -109,6 +109,6 @@ exports.pExpectedErrorString = pExpectedErrorString;
  */
 function _expectedErrorString(fn, errorClass) {
     const err = _expectedError(fn, errorClass);
-    return (0, stringifyAny_1._stringifyAny)(err);
+    return (0, stringify_1._stringify)(err);
 }
 exports._expectedErrorString = _expectedErrorString;

package/dist/http/fetcher.js

@@ -12,7 +12,7 @@ const object_util_1 = require("../object/object.util");
 const pDelay_1 = require("../promise/pDelay");
 const pTimeout_1 = require("../promise/pTimeout");
 const json_util_1 = require("../string/json.util");
-const stringifyAny_1 = require("../string/stringifyAny");
+const stringify_1 = require("../string/stringify");
 const time_util_1 = require("../time/time.util");
 const http_model_1 = require("./http.model");
 const acceptByResponseType = {
@@ -392,7 +392,7 @@ class Fetcher {
                 .filter(Boolean)
                 .join(' ') + '\n', 
             // We're stringifying the error here, otherwise Sentry shows it as [object Object]
-            (0, stringifyAny_1._stringifyAny)(res.err.cause || res.err));
+            (0, stringify_1._stringify)(res.err.cause || res.err));
         }
         if (retryStatus.retryStopped)
             return;

package/dist/index.d.ts

@@ -50,7 +50,7 @@ export * from './string/string.util';
 export * from './string/readingTime';
 export * from './string/escape';
 export * from './string/pupa';
-export * from './string/stringifyAny';
+export * from './string/stringify';
 export * from './time/time.util';
 export * from './is.util';
 export * from './typeFest';

package/dist/index.js

@@ -54,7 +54,7 @@ tslib_1.__exportStar(require("./string/string.util"), exports);
 tslib_1.__exportStar(require("./string/readingTime"), exports);
 tslib_1.__exportStar(require("./string/escape"), exports);
 tslib_1.__exportStar(require("./string/pupa"), exports);
-tslib_1.__exportStar(require("./string/stringifyAny"), exports);
+tslib_1.__exportStar(require("./string/stringify"), exports);
 tslib_1.__exportStar(require("./time/time.util"), exports);
 tslib_1.__exportStar(require("./is.util"), exports);
 tslib_1.__exportStar(require("./typeFest"), exports);

package/dist/string/{stringifyAny.d.ts → stringify.d.ts}

@@ -3,7 +3,7 @@ import type { Reviver } from '../types';
  * Allows to set Global "stringifyFunction" that will be used to "pretty-print" objects
  * in various cases.
  *
- * Used, for example, by _stringifyAny() to pretty-print objects/arrays.
+ * Used, for example, by _stringify() to pretty-print objects/arrays.
  *
  * Defaults to _safeJsonStringify.
  *
@@ -14,7 +14,7 @@ import type { Reviver } from '../types';
  */
 export declare function setGlobalStringifyFunction(fn: JsonStringifyFunction): void;
 export type JsonStringifyFunction = (obj: any, reviver?: Reviver, space?: number) => string;
-export interface StringifyAnyOptions {
+export interface StringifyOptions {
     /**
      * @default 10_000
      * Default limit is less than in Node, cause it's likely to be used e.g in Browser alert()
@@ -47,13 +47,13 @@ export interface StringifyAnyOptions {
     stringifyFn?: JsonStringifyFunction;
 }
 /**
- * Inspired by inspectAny from nodejs-lib, which is based on util.inpect that is not available in the Browser.
+ * Inspired by `_inspect` 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
  *
  * Transforms ANY to human-readable string (via JSON.stringify pretty).
  * Safe (no error throwing).
  *
- * Correclty prints Errors, AppErrors, ErrorObjects: error.message + \n + stringifyAny(error.data)
+ * Correctly prints Errors, AppErrors, ErrorObjects: error.message + \n + _stringify(error.data)
  *
  * Enforces max length (default to 1000, pass 0 to skip it).
  *
@@ -64,4 +64,8 @@ export interface StringifyAnyOptions {
  * Returns 'empty_string' if empty string is passed.
  * Returns 'undefined' if undefined is passed (default util.inspect behavior).
  */
-export declare function _stringifyAny(obj: any, opt?: StringifyAnyOptions): string;
+export declare function _stringify(obj: any, opt?: StringifyOptions): string;
+/**
+ * @deprecated renamed to _stringify
+ */
+export declare const _stringifyAny: typeof _stringify;

package/dist/string/{stringifyAny.js → stringify.js}

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._stringifyAny = exports.setGlobalStringifyFunction = void 0;
+exports._stringifyAny = exports._stringify = exports.setGlobalStringifyFunction = void 0;
 const error_util_1 = require("../error/error.util");
 const json_util_1 = require("./json.util");
 const safeJsonStringify_1 = require("./safeJsonStringify");
@@ -10,7 +10,7 @@ let globalStringifyFunction = safeJsonStringify_1._safeJsonStringify;
  * Allows to set Global "stringifyFunction" that will be used to "pretty-print" objects
  * in various cases.
  *
- * Used, for example, by _stringifyAny() to pretty-print objects/arrays.
+ * Used, for example, by _stringify() to pretty-print objects/arrays.
  *
  * Defaults to _safeJsonStringify.
  *
@@ -24,13 +24,13 @@ function setGlobalStringifyFunction(fn) {
 }
 exports.setGlobalStringifyFunction = setGlobalStringifyFunction;
 /**
- * Inspired by inspectAny from nodejs-lib, which is based on util.inpect that is not available in the Browser.
+ * Inspired by `_inspect` 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
  *
  * Transforms ANY to human-readable string (via JSON.stringify pretty).
  * Safe (no error throwing).
  *
- * Correclty prints Errors, AppErrors, ErrorObjects: error.message + \n + stringifyAny(error.data)
+ * Correctly prints Errors, AppErrors, ErrorObjects: error.message + \n + _stringify(error.data)
  *
  * Enforces max length (default to 1000, pass 0 to skip it).
  *
@@ -41,7 +41,7 @@ exports.setGlobalStringifyFunction = setGlobalStringifyFunction;
  * Returns 'empty_string' if empty string is passed.
  * Returns 'undefined' if undefined is passed (default util.inspect behavior).
  */
-function _stringifyAny(obj, opt = {}) {
+function _stringify(obj, opt = {}) {
     if (obj === undefined)
         return 'undefined';
     if (obj === null)
@@ -57,7 +57,7 @@ function _stringifyAny(obj, opt = {}) {
     // HttpErrorResponse
     //
     if ((0, error_util_1._isBackendErrorResponseObject)(obj)) {
-        return _stringifyAny(obj.error, opt);
+        return _stringify(obj.error, opt);
     }
     if (obj instanceof Error || (0, error_util_1._isErrorLike)(obj)) {
         const { includeErrorCause = true } = opt;
@@ -79,7 +79,7 @@ function _stringifyAny(obj, opt = {}) {
             s += `\ncode: ${obj.code}`;
         }
         if (opt.includeErrorData && (0, error_util_1._isErrorObject)(obj) && Object.keys(obj.data).length) {
-            s += '\n' + _stringifyAny(obj.data, opt);
+            s += '\n' + _stringify(obj.data, opt);
         }
         if (opt.includeErrorStack && obj.stack) {
             // Here we're using the previously-generated "title line" (e.g "Error: some_message"),
@@ -94,11 +94,11 @@ function _stringifyAny(obj, opt = {}) {
             s = [
                 s,
                 `${obj.errors.length} error(s):`,
-                ...obj.errors.map((err, i) => `${i + 1}. ${_stringifyAny(err, opt)}`),
+                ...obj.errors.map((err, i) => `${i + 1}. ${_stringify(err, opt)}`),
             ].join('\n');
         }
         if (obj.cause && includeErrorCause) {
-            s = s + '\nCaused by: ' + _stringifyAny(obj.cause, opt);
+            s = s + '\nCaused by: ' + _stringify(obj.cause, opt);
         }
     }
     else if (typeof obj === 'string') {
@@ -129,4 +129,8 @@ function _stringifyAny(obj, opt = {}) {
     }
     return s;
 }
-exports._stringifyAny = _stringifyAny;
+exports._stringify = _stringify;
+/**
+ * @deprecated renamed to _stringify
+ */
+exports._stringifyAny = _stringify;

package/dist/zod/zod.util.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ZodValidationError = exports.zSafeValidate = exports.zValidate = exports.zIsValid = void 0;
 const zod_1 = require("zod");
-const stringifyAny_1 = require("../string/stringifyAny");
+const stringify_1 = require("../string/stringify");
 function zIsValid(value, schema) {
     const { success } = schema.safeParse(value);
     return success;
@@ -48,7 +48,7 @@ class ZodValidationError extends zod_1.ZodError {
             `Invalid ${objectTitle}`,
             '',
             'Input:',
-            (0, stringifyAny_1._stringifyAny)(this.value),
+            (0, stringify_1._stringify)(this.value),
             this.issues.length > 1 ? `\n${this.issues.length} issues:` : '',
             ...this.issues.slice(0, 100).map(i => {
                 return [i.path.join('.'), i.message].filter(Boolean).join(': ');

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

@@ -1,4 +1,4 @@
-import { SimpleMovingAverage, _stringifyAny, _assert } from '..';
+import { SimpleMovingAverage, _stringify, _assert } from '..';
 import { _ms } from '../time/time.util';
 import { _getArgsSignature, _getMethodSignature } from './decorator.util';
 /**
@@ -24,7 +24,7 @@ export function _LogMethod(opt = {}) {
         let { logResultFn } = opt;
         if (!logResultFn) {
             if (logResult) {
-                logResultFn = r => ['result:', _stringifyAny(r)];
+                logResultFn = r => ['result:', _stringify(r)];
             }
             else if (logResultLength) {
                 logResultFn = r => (Array.isArray(r) ? [`result: ${r.length} items`] : []);

package/dist-esm/error/assert.js

@@ -1,4 +1,4 @@
-import { _deepEquals, _isErrorObject, _stringifyAny, AssertionError } from '..';
+import { _deepEquals, _isErrorObject, _stringify, AssertionError } from '..';
 /**
  * Evaluates the `condition` (casts it to Boolean).
  * Expects it to be truthy, otherwise throws AppError.
@@ -29,7 +29,7 @@ message, errorData) {
 export function _assertEquals(actual, expected, message, errorData) {
     if (actual !== expected) {
         const msg = message ||
-            ['not equal', `expected: ${_stringifyAny(expected)}`, `got     : ${_stringifyAny(actual)}`]
+            ['not equal', `expected: ${_stringify(expected)}`, `got     : ${_stringify(actual)}`]
                 .filter(Boolean)
                 .join('\n');
         throw new AssertionError(msg, Object.assign({ userFriendly: true }, errorData));
@@ -44,11 +44,7 @@ export function _assertEquals(actual, expected, message, errorData) {
 export function _assertDeepEquals(actual, expected, message, errorData) {
     if (!_deepEquals(actual, expected)) {
         const msg = message ||
-            [
-                `not deeply equal`,
-                `expected: ${_stringifyAny(expected)}`,
-                `got     : ${_stringifyAny(actual)}`,
-            ]
+            [`not deeply equal`, `expected: ${_stringify(expected)}`, `got     : ${_stringify(actual)}`]
                 .filter(Boolean)
                 .join('\n');
         throw new AssertionError(msg, Object.assign({ userFriendly: true }, errorData));

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

@@ -1,4 +1,4 @@
-import { _jsonParseIfPossible, _stringifyAny, _truncate, _truncateMiddle, isServerSide } from '..';
+import { _jsonParseIfPossible, _stringify, _truncate, _truncateMiddle, isServerSide } from '..';
 /**
  * Useful to ensure that error in `catch (err) { ... }`
  * is indeed an Error (and not e.g `string` or `undefined`).
@@ -27,7 +27,7 @@ export function _anyToError(o, errorClass = Error, errorData) {
  * Converts "anything" to ErrorObject.
  * Detects if it's HttpErrorResponse, HttpErrorObject, ErrorObject, Error, etc..
  * If object is Error - Error.message will be used.
- * Objects (not Errors) get converted to prettified JSON string (via `_stringifyAny`).
+ * Objects (not Errors) get converted to prettified JSON string (via `_stringify`).
  */
 export function _anyToErrorObject(o, errorData) {
     let eo;
@@ -50,7 +50,7 @@ export function _anyToErrorObject(o, errorData) {
             // so, fair to return `data: {}` in the end
             // Also we're sure it includes no "error name", e.g no `Error: ...`,
             // so, fair to include `name: 'Error'`
-            const message = _stringifyAny(o);
+            const message = _stringify(o);
             eo = {
                 name: 'Error',
                 message,

package/dist-esm/error/try.js

@@ -1,4 +1,4 @@
-import { _stringifyAny } from '../string/stringifyAny';
+import { _stringify } from '../string/stringify';
 import { _assertErrorClassOrRethrow } from './assert';
 import { UnexpectedPassError } from './error.util';
 /**
@@ -94,12 +94,12 @@ export async function pExpectedError(promise, errorClass) {
  */
 export async function pExpectedErrorString(promise, errorClass) {
     const err = await pExpectedError(promise, errorClass);
-    return _stringifyAny(err);
+    return _stringify(err);
 }
 /**
  * Shortcut function to simplify error snapshot-matching in tests.
  */
 export function _expectedErrorString(fn, errorClass) {
     const err = _expectedError(fn, errorClass);
-    return _stringifyAny(err);
+    return _stringify(err);
 }

package/dist-esm/http/fetcher.js

@@ -10,7 +10,7 @@ import { _filterNullishValues, _filterUndefinedValues, _mapKeys, _merge, _omit,
 import { pDelay } from '../promise/pDelay';
 import { pTimeout } from '../promise/pTimeout';
 import { _jsonParse, _jsonParseIfPossible } from '../string/json.util';
-import { _stringifyAny } from '../string/stringifyAny';
+import { _stringify } from '../string/stringify';
 import { _ms, _since } from '../time/time.util';
 import { HTTP_METHODS } from './http.model';
 const acceptByResponseType = {
@@ -372,7 +372,7 @@ export class Fetcher {
                 .filter(Boolean)
                 .join(' ') + '\n', 
             // We're stringifying the error here, otherwise Sentry shows it as [object Object]
-            _stringifyAny(res.err.cause || res.err));
+            _stringify(res.err.cause || res.err));
         }
         if (retryStatus.retryStopped)
             return;

package/dist-esm/index.js

@@ -50,7 +50,7 @@ export * from './string/string.util';
 export * from './string/readingTime';
 export * from './string/escape';
 export * from './string/pupa';
-export * from './string/stringifyAny';
+export * from './string/stringify';
 export * from './time/time.util';
 export * from './is.util';
 export * from './typeFest';

package/dist-esm/string/{stringifyAny.js → stringify.js}

@@ -7,7 +7,7 @@ let globalStringifyFunction = _safeJsonStringify;
  * Allows to set Global "stringifyFunction" that will be used to "pretty-print" objects
  * in various cases.
  *
- * Used, for example, by _stringifyAny() to pretty-print objects/arrays.
+ * Used, for example, by _stringify() to pretty-print objects/arrays.
  *
  * Defaults to _safeJsonStringify.
  *
@@ -20,13 +20,13 @@ export function setGlobalStringifyFunction(fn) {
     globalStringifyFunction = fn;
 }
 /**
- * Inspired by inspectAny from nodejs-lib, which is based on util.inpect that is not available in the Browser.
+ * Inspired by `_inspect` 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
  *
  * Transforms ANY to human-readable string (via JSON.stringify pretty).
  * Safe (no error throwing).
  *
- * Correclty prints Errors, AppErrors, ErrorObjects: error.message + \n + stringifyAny(error.data)
+ * Correctly prints Errors, AppErrors, ErrorObjects: error.message + \n + _stringify(error.data)
  *
  * Enforces max length (default to 1000, pass 0 to skip it).
  *
@@ -37,7 +37,7 @@ export function setGlobalStringifyFunction(fn) {
  * Returns 'empty_string' if empty string is passed.
  * Returns 'undefined' if undefined is passed (default util.inspect behavior).
  */
-export function _stringifyAny(obj, opt = {}) {
+export function _stringify(obj, opt = {}) {
     if (obj === undefined)
         return 'undefined';
     if (obj === null)
@@ -53,7 +53,7 @@ export function _stringifyAny(obj, opt = {}) {
     // HttpErrorResponse
     //
     if (_isBackendErrorResponseObject(obj)) {
-        return _stringifyAny(obj.error, opt);
+        return _stringify(obj.error, opt);
     }
     if (obj instanceof Error || _isErrorLike(obj)) {
         const { includeErrorCause = true } = opt;
@@ -75,7 +75,7 @@ export function _stringifyAny(obj, opt = {}) {
             s += `\ncode: ${obj.code}`;
         }
         if (opt.includeErrorData && _isErrorObject(obj) && Object.keys(obj.data).length) {
-            s += '\n' + _stringifyAny(obj.data, opt);
+            s += '\n' + _stringify(obj.data, opt);
         }
         if (opt.includeErrorStack && obj.stack) {
             // Here we're using the previously-generated "title line" (e.g "Error: some_message"),
@@ -90,11 +90,11 @@ export function _stringifyAny(obj, opt = {}) {
             s = [
                 s,
                 `${obj.errors.length} error(s):`,
-                ...obj.errors.map((err, i) => `${i + 1}. ${_stringifyAny(err, opt)}`),
+                ...obj.errors.map((err, i) => `${i + 1}. ${_stringify(err, opt)}`),
             ].join('\n');
         }
         if (obj.cause && includeErrorCause) {
-            s = s + '\nCaused by: ' + _stringifyAny(obj.cause, opt);
+            s = s + '\nCaused by: ' + _stringify(obj.cause, opt);
         }
     }
     else if (typeof obj === 'string') {
@@ -125,3 +125,7 @@ export function _stringifyAny(obj, opt = {}) {
     }
     return s;
 }
+/**
+ * @deprecated renamed to _stringify
+ */
+export const _stringifyAny = _stringify;

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

@@ -1,5 +1,5 @@
 import { ZodError } from 'zod';
-import { _stringifyAny } from '../string/stringifyAny';
+import { _stringify } from '../string/stringify';
 export function zIsValid(value, schema) {
     const { success } = schema.safeParse(value);
     return success;
@@ -43,7 +43,7 @@ export class ZodValidationError extends ZodError {
             `Invalid ${objectTitle}`,
             '',
             'Input:',
-            _stringifyAny(this.value),
+            _stringify(this.value),
             this.issues.length > 1 ? `\n${this.issues.length} issues:` : '',
             ...this.issues.slice(0, 100).map(i => {
                 return [i.path.join('.'), i.message].filter(Boolean).join(': ');

package/package.json

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

package/src/decorators/logMethod.decorator.ts

@@ -1,5 +1,5 @@
 import type { CommonLogger } from '..'
-import { SimpleMovingAverage, _stringifyAny, _assert } from '..'
+import { SimpleMovingAverage, _stringify, _assert } from '..'
 import { _ms } from '../time/time.util'
 import { _getArgsSignature, _getMethodSignature } from './decorator.util'
 
@@ -88,7 +88,7 @@ export function _LogMethod(opt: LogMethodOptions = {}): MethodDecorator {
     let { logResultFn } = opt
     if (!logResultFn) {
       if (logResult) {
-        logResultFn = r => ['result:', _stringifyAny(r)]
+        logResultFn = r => ['result:', _stringify(r)]
       } else if (logResultLength) {
         logResultFn = r => (Array.isArray(r) ? [`result: ${r.length} items`] : [])
       }

package/src/error/assert.ts

@@ -1,5 +1,5 @@
 import type { ErrorData, ErrorObject } from '..'
-import { _deepEquals, _isErrorObject, _stringifyAny, AssertionError, Class } from '..'
+import { _deepEquals, _isErrorObject, _stringify, AssertionError, Class } from '..'
 
 /**
  * Evaluates the `condition` (casts it to Boolean).
@@ -44,7 +44,7 @@ export function _assertEquals<T>(
   if (actual !== expected) {
     const msg =
       message ||
-      ['not equal', `expected: ${_stringifyAny(expected)}`, `got     : ${_stringifyAny(actual)}`]
+      ['not equal', `expected: ${_stringify(expected)}`, `got     : ${_stringify(actual)}`]
         .filter(Boolean)
         .join('\n')
 
@@ -70,11 +70,7 @@ export function _assertDeepEquals<T>(
   if (!_deepEquals(actual, expected)) {
     const msg =
       message ||
-      [
-        `not deeply equal`,
-        `expected: ${_stringifyAny(expected)}`,
-        `got     : ${_stringifyAny(actual)}`,
-      ]
+      [`not deeply equal`, `expected: ${_stringify(expected)}`, `got     : ${_stringify(actual)}`]
         .filter(Boolean)
         .join('\n')
 

package/src/error/error.util.ts

@@ -6,7 +6,7 @@ import type {
   HttpRequestErrorData,
   ErrorLike,
 } from '..'
-import { _jsonParseIfPossible, _stringifyAny, _truncate, _truncateMiddle, isServerSide } from '..'
+import { _jsonParseIfPossible, _stringify, _truncate, _truncateMiddle, isServerSide } from '..'
 
 /**
  * Useful to ensure that error in `catch (err) { ... }`
@@ -46,7 +46,7 @@ export function _anyToError<ERROR_TYPE extends Error = Error>(
  * Converts "anything" to ErrorObject.
  * Detects if it's HttpErrorResponse, HttpErrorObject, ErrorObject, Error, etc..
  * If object is Error - Error.message will be used.
- * Objects (not Errors) get converted to prettified JSON string (via `_stringifyAny`).
+ * Objects (not Errors) get converted to prettified JSON string (via `_stringify`).
  */
 export function _anyToErrorObject<DATA_TYPE extends ErrorData = ErrorData>(
   o: any,
@@ -70,7 +70,7 @@ export function _anyToErrorObject<DATA_TYPE extends ErrorData = ErrorData>(
       // so, fair to return `data: {}` in the end
       // Also we're sure it includes no "error name", e.g no `Error: ...`,
       // so, fair to include `name: 'Error'`
-      const message = _stringifyAny(o)
+      const message = _stringify(o)
 
       eo = {
         name: 'Error',

package/src/error/try.ts

@@ -1,4 +1,4 @@
-import { _stringifyAny } from '../string/stringifyAny'
+import { _stringify } from '../string/stringify'
 import type { Class } from '../typeFest'
 import type { AnyFunction, ErrorDataTuple } from '../types'
 import { _assertErrorClassOrRethrow } from './assert'
@@ -116,7 +116,7 @@ export async function pExpectedErrorString<ERR = Error>(
   errorClass?: Class<ERR>,
 ): Promise<string> {
   const err = await pExpectedError<ERR>(promise, errorClass)
-  return _stringifyAny(err)
+  return _stringify(err)
 }
 
 /**
@@ -127,5 +127,5 @@ export function _expectedErrorString<ERR = Error>(
   errorClass?: Class<ERR>,
 ): string {
   const err = _expectedError<ERR>(fn, errorClass)
-  return _stringifyAny(err)
+  return _stringify(err)
 }

package/src/http/fetcher.ts

@@ -25,7 +25,7 @@ import {
 import { pDelay } from '../promise/pDelay'
 import { pTimeout } from '../promise/pTimeout'
 import { _jsonParse, _jsonParseIfPossible } from '../string/json.util'
-import { _stringifyAny } from '../string/stringifyAny'
+import { _stringify } from '../string/stringify'
 import { _ms, _since } from '../time/time.util'
 import { ErrorDataTuple, NumberOfMilliseconds } from '../types'
 import type {
@@ -504,7 +504,7 @@ export class Fetcher {
           .filter(Boolean)
           .join(' ') + '\n',
         // We're stringifying the error here, otherwise Sentry shows it as [object Object]
-        _stringifyAny(res.err.cause || res.err),
+        _stringify(res.err.cause || res.err),
       )
     }
 

package/src/index.ts

@@ -50,7 +50,7 @@ export * from './string/string.util'
 export * from './string/readingTime'
 export * from './string/escape'
 export * from './string/pupa'
-export * from './string/stringifyAny'
+export * from './string/stringify'
 export * from './time/time.util'
 export * from './is.util'
 export * from './typeFest'

package/src/string/{stringifyAny.ts → stringify.ts}

@@ -11,7 +11,7 @@ let globalStringifyFunction: JsonStringifyFunction = _safeJsonStringify
  * Allows to set Global "stringifyFunction" that will be used to "pretty-print" objects
  * in various cases.
  *
- * Used, for example, by _stringifyAny() to pretty-print objects/arrays.
+ * Used, for example, by _stringify() to pretty-print objects/arrays.
  *
  * Defaults to _safeJsonStringify.
  *
@@ -26,7 +26,7 @@ export function setGlobalStringifyFunction(fn: JsonStringifyFunction): void {
 
 export type JsonStringifyFunction = (obj: any, reviver?: Reviver, space?: number) => string
 
-export interface StringifyAnyOptions {
+export interface StringifyOptions {
   /**
    * @default 10_000
    * Default limit is less than in Node, cause it's likely to be used e.g in Browser alert()
@@ -64,13 +64,13 @@ export interface StringifyAnyOptions {
 }
 
 /**
- * Inspired by inspectAny from nodejs-lib, which is based on util.inpect that is not available in the Browser.
+ * Inspired by `_inspect` 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
  *
  * Transforms ANY to human-readable string (via JSON.stringify pretty).
  * Safe (no error throwing).
  *
- * Correclty prints Errors, AppErrors, ErrorObjects: error.message + \n + stringifyAny(error.data)
+ * Correctly prints Errors, AppErrors, ErrorObjects: error.message + \n + _stringify(error.data)
  *
  * Enforces max length (default to 1000, pass 0 to skip it).
  *
@@ -81,7 +81,7 @@ export interface StringifyAnyOptions {
  * Returns 'empty_string' if empty string is passed.
  * Returns 'undefined' if undefined is passed (default util.inspect behavior).
  */
-export function _stringifyAny(obj: any, opt: StringifyAnyOptions = {}): string {
+export function _stringify(obj: any, opt: StringifyOptions = {}): string {
   if (obj === undefined) return 'undefined'
   if (obj === null) return 'null'
   if (typeof obj === 'function') return 'function'
@@ -96,7 +96,7 @@ export function _stringifyAny(obj: any, opt: StringifyAnyOptions = {}): string {
   // HttpErrorResponse
   //
   if (_isBackendErrorResponseObject(obj)) {
-    return _stringifyAny(obj.error, opt)
+    return _stringify(obj.error, opt)
   }
 
   if (obj instanceof Error || _isErrorLike(obj)) {
@@ -123,7 +123,7 @@ export function _stringifyAny(obj: any, opt: StringifyAnyOptions = {}): string {
     }
 
     if (opt.includeErrorData && _isErrorObject(obj) && Object.keys(obj.data).length) {
-      s += '\n' + _stringifyAny(obj.data, opt)
+      s += '\n' + _stringify(obj.data, opt)
     }
 
     if (opt.includeErrorStack && obj.stack) {
@@ -141,12 +141,12 @@ export function _stringifyAny(obj: any, opt: StringifyAnyOptions = {}): string {
       s = [
         s,
         `${obj.errors.length} error(s):`,
-        ...obj.errors.map((err, i) => `${i + 1}. ${_stringifyAny(err, opt)}`),
+        ...obj.errors.map((err, i) => `${i + 1}. ${_stringify(err, opt)}`),
       ].join('\n')
     }
 
     if (obj.cause && includeErrorCause) {
-      s = s + '\nCaused by: ' + _stringifyAny(obj.cause, opt)
+      s = s + '\nCaused by: ' + _stringify(obj.cause, opt)
     }
   } else if (typeof obj === 'string') {
     //
@@ -178,3 +178,8 @@ export function _stringifyAny(obj: any, opt: StringifyAnyOptions = {}): string {
 
   return s
 }
+
+/**
+ * @deprecated renamed to _stringify
+ */
+export const _stringifyAny = _stringify

package/src/zod/zod.util.ts

@@ -1,5 +1,5 @@
 import { ZodError, ZodSchema, ZodIssue } from 'zod'
-import { _stringifyAny } from '../string/stringifyAny'
+import { _stringify } from '../string/stringify'
 
 export interface ZodErrorResult<T> {
   success: false
@@ -71,7 +71,7 @@ export class ZodValidationError<T> extends ZodError<T> {
       `Invalid ${objectTitle}`,
       '',
       'Input:',
-      _stringifyAny(this.value),
+      _stringify(this.value),
       this.issues.length > 1 ? `\n${this.issues.length} issues:` : '',
       ...this.issues.slice(0, 100).map(i => {
         return [i.path.join('.'), i.message].filter(Boolean).join(': ')