@naturalcycles/js-lib 14.129.0 → 14.130.1

package/src/promise/pRetry.ts

@@ -43,7 +43,7 @@ export interface PRetryOptions {
    *
    * @default () => true
    */
-  predicate?(err: Error, attempt: number, maxAttempts: number): boolean
+  predicate?: (err: Error, attempt: number, maxAttempts: number) => boolean
 
   /**
    * Log the first attempt (which is not a "retry" yet).

package/src/promise/pTimeout.ts

@@ -23,7 +23,7 @@ export interface PTimeoutOptions {
    * err (which is TimeoutError) is passed as an argument for convenience, so it can
    * be logged or such. You don't have to consume it in any way though.
    */
-  onTimeout?(err: TimeoutError): any
+  onTimeout?: (err: TimeoutError) => any
 
   /**
    * Defaults to true.

package/src/string/pupa.ts

@@ -31,7 +31,7 @@ export interface PupaOptions {
   /**
    * Performs arbitrary operation for each interpolation. If the returned value was `undefined`, it behaves differently depending on the `ignoreMissing` option. Otherwise, the returned value will be interpolated into a string (and escaped when double-braced) and embedded into the template.
    */
-  transform?(data: { value: any; key: string }): unknown
+  transform?: (data: { value: any; key: string }) => unknown
 }
 
 /**

package/src/string/readingTime.ts

@@ -16,7 +16,7 @@ export interface ReadingTimeOptions {
    * A function that returns a boolean value depending on if a character is considered as a word bound.
    * Default: spaces, new lines and tabs
    */
-  wordBound?(char: string): boolean
+  wordBound?: (char: string) => boolean
   /**
    * Default 200
    */

package/src/string/stringifyAny.ts

@@ -3,6 +3,8 @@ import type { Reviver } from '../types'
 import { _jsonParseIfPossible } from './json.util'
 import { _safeJsonStringify } from './safeJsonStringify'
 
+const supportsAggregateError = typeof globalThis.AggregateError === 'function'
+
 let globalStringifyFunction: JsonStringifyFunction = _safeJsonStringify
 
 /**
@@ -45,6 +47,13 @@ export interface StringifyAnyOptions {
    */
   includeErrorStack?: boolean
 
+  /**
+   * Set to false to skip including Error.cause.
+   *
+   * @default true
+   */
+  includeErrorCause?: boolean
+
   /**
    * Allows to pass custom "stringify function".
    * E.g in Node.js you can pass `util.inspect` instead.
@@ -91,6 +100,7 @@ export function _stringifyAny(obj: any, opt: StringifyAnyOptions = {}): string {
   }
 
   if (obj instanceof Error || _isErrorObject(obj)) {
+    const { includeErrorCause = true } = opt
     //
     // Error or ErrorObject
     //
@@ -100,7 +110,7 @@ export function _stringifyAny(obj: any, opt: StringifyAnyOptions = {}): string {
     // if (obj?.name === 'Error') {
     //   s = obj.message
     // }
-    s = [obj.name, obj.message].join(': ')
+    s = [obj.name, obj.message].filter(Boolean).join(': ')
 
     if (opt.includeErrorStack && obj.stack) {
       // Here we're using the previously-generated "title line" (e.g "Error: some_message"),
@@ -128,6 +138,18 @@ export function _stringifyAny(obj: any, opt: StringifyAnyOptions = {}): string {
       // Error that has no `data`, but has `code` property
       s = [s, `code: ${(obj as any).code}`].join('\n')
     }
+
+    if (supportsAggregateError && obj instanceof AggregateError && obj.errors.length) {
+      s = [
+        s,
+        `${obj.errors.length} error(s):`,
+        ...obj.errors.map((err, i) => `${i + 1}. ${_stringifyAny(err, opt)}`),
+      ].join('\n')
+    }
+
+    if (obj.cause && includeErrorCause) {
+      s = s + '\ncaused by: ' + _stringifyAny(obj.cause, opt)
+    }
   } else if (typeof obj === 'string') {
     //
     // String

package/dist/promise/AggregatedError.d.ts

@@ -1,10 +0,0 @@
-/**
- * Error that aggregates a number of other errors.
- * .errors contain raw original errors to be accessed if needed.
- * .results contain the results of some batch operation (if needed).
- */
-export declare class AggregatedError<RESULT = any> extends Error {
-    errors: Error[];
-    results: RESULT[];
-    constructor(errors: Error[], results?: RESULT[]);
-}

package/dist/promise/AggregatedError.js

@@ -1,34 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AggregatedError = void 0;
-/**
- * Error that aggregates a number of other errors.
- * .errors contain raw original errors to be accessed if needed.
- * .results contain the results of some batch operation (if needed).
- */
-class AggregatedError extends Error {
-    constructor(errors, results = []) {
-        const message = [
-            `${errors.length} errors:`,
-            ...errors.map((e, i) => `${i + 1}. ${e.message}`),
-        ].join('\n');
-        super(message);
-        this.errors = errors;
-        this.results = results;
-        Object.defineProperty(this, 'name', {
-            value: this.constructor.name,
-            configurable: true,
-        });
-        if (Error.captureStackTrace) {
-            Error.captureStackTrace(this, this.constructor);
-        }
-        else {
-            Object.defineProperty(this, 'stack', {
-                value: new Error().stack,
-                writable: true,
-                configurable: true,
-            });
-        }
-    }
-}
-exports.AggregatedError = AggregatedError;

package/dist-esm/promise/AggregatedError.js

@@ -1,30 +0,0 @@
-/**
- * Error that aggregates a number of other errors.
- * .errors contain raw original errors to be accessed if needed.
- * .results contain the results of some batch operation (if needed).
- */
-export class AggregatedError extends Error {
-    constructor(errors, results = []) {
-        const message = [
-            `${errors.length} errors:`,
-            ...errors.map((e, i) => `${i + 1}. ${e.message}`),
-        ].join('\n');
-        super(message);
-        this.errors = errors;
-        this.results = results;
-        Object.defineProperty(this, 'name', {
-            value: this.constructor.name,
-            configurable: true,
-        });
-        if (Error.captureStackTrace) {
-            Error.captureStackTrace(this, this.constructor);
-        }
-        else {
-            Object.defineProperty(this, 'stack', {
-                value: new Error().stack,
-                writable: true,
-                configurable: true,
-            });
-        }
-    }
-}

package/src/promise/AggregatedError.ts

@@ -1,36 +0,0 @@
-/**
- * Error that aggregates a number of other errors.
- * .errors contain raw original errors to be accessed if needed.
- * .results contain the results of some batch operation (if needed).
- */
-export class AggregatedError<RESULT = any> extends Error {
-  errors!: Error[]
-  results!: RESULT[]
-
-  constructor(errors: Error[], results: RESULT[] = []) {
-    const message = [
-      `${errors.length} errors:`,
-      ...errors.map((e, i) => `${i + 1}. ${e.message}`),
-    ].join('\n')
-
-    super(message)
-
-    this.errors = errors
-    this.results = results
-
-    Object.defineProperty(this, 'name', {
-      value: this.constructor.name,
-      configurable: true,
-    })
-
-    if (Error.captureStackTrace) {
-      Error.captureStackTrace(this, this.constructor)
-    } else {
-      Object.defineProperty(this, 'stack', {
-        value: new Error().stack, // eslint-disable-line unicorn/error-message
-        writable: true,
-        configurable: true,
-      })
-    }
-  }
-}