@naturalcycles/js-lib 14.105.0 → 14.107.0

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

@@ -24,3 +24,16 @@ export declare function _isHttpErrorObject(o: any): o is ErrorObject<HttpErrorDa
  * Note: any instance of AppError is also automatically an ErrorObject
  */
 export declare function _isErrorObject(o: any): o is ErrorObject;
+/**
+ * Convenience function to safely add properties to Error's `data` object
+ * (even if it wasn't previously existing)
+ *
+ * @example
+ *
+ * try {} catch (err) {
+ *   _errorDataAppend(err, {
+ *     httpStatusCode: 401,
+ *   })
+ * }
+ */
+export declare function _errorDataAppend(err: Error, data: ErrorData): void;

package/dist/error/error.util.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._isErrorObject = exports._isHttpErrorObject = exports._isHttpErrorResponse = exports._errorObjectToError = exports._errorObjectToAppError = exports._errorToErrorObject = exports._anyToErrorObject = exports._anyToError = void 0;
+exports._errorDataAppend = exports._isErrorObject = exports._isHttpErrorObject = exports._isHttpErrorResponse = exports._errorObjectToError = exports._errorObjectToAppError = exports._errorToErrorObject = exports._anyToErrorObject = exports._anyToError = void 0;
 const __1 = require("..");
 /**
  * Useful to ensure that error in `catch (err) { ... }`
@@ -108,3 +108,23 @@ function _isErrorObject(o) {
     return (!!o && typeof o.name === 'string' && typeof o.message === 'string' && typeof o.data === 'object');
 }
 exports._isErrorObject = _isErrorObject;
+/**
+ * Convenience function to safely add properties to Error's `data` object
+ * (even if it wasn't previously existing)
+ *
+ * @example
+ *
+ * try {} catch (err) {
+ *   _errorDataAppend(err, {
+ *     httpStatusCode: 401,
+ *   })
+ * }
+ */
+function _errorDataAppend(err, data) {
+    ;
+    err.data = {
+        ...err.data,
+        ...data,
+    };
+}
+exports._errorDataAppend = _errorDataAppend;

package/dist/index.d.ts

@@ -53,12 +53,15 @@ import { JsonStringifyFunction, StringifyAnyOptions, _stringifyAny } from './str
 export * from './time/time.util';
 export * from './is.util';
 import { Class, ConditionalExcept, ConditionalPick, Merge, Promisable, ReadonlyDeep, Simplify } from './typeFest';
-import { AsyncMapper, AsyncPredicate, BaseDBEntity, CreatedUpdated, CreatedUpdatedId, ObjectWithId, AnyObjectWithId, Saved, Unsaved, UnsavedId, BatchResult, InstanceId, IsoDate, IsoDateString, IsoDateTimeString, KeyValueTuple, Mapper, ObjectMapper, ObjectPredicate, Predicate, PromiseMap, AnyObject, AnyEnum, NumberEnum, StringEnum, AnyFunction, Reviver, SavedDBEntity, StringMap, UnixTimestampNumber, UnixTimestampMillisNumber, UnixTimestamp, Integer, ValueOf, ValuesOf, AbortableMapper, AbortableAsyncPredicate, AbortableAsyncMapper, AbortablePredicate, NullishValue, FalsyValue, END, SKIP, _noop, _objectKeys, _passNothingPredicate, _passthroughMapper, _passthroughPredicate, _passUndefinedMapper, _stringMapEntries, _stringMapValues } from './types';
+import { AsyncMapper, AsyncPredicate, BaseDBEntity, CreatedUpdated, CreatedUpdatedId, ObjectWithId, AnyObjectWithId, Saved, Unsaved, UnsavedId, BatchResult, InstanceId, IsoDate, IsoDateString, IsoDateTimeString, KeyValueTuple, Mapper, ObjectMapper, ObjectPredicate, Predicate, PromiseMap, AnyObject, AnyEnum, NumberEnum, StringEnum, AnyFunction, Reviver, SavedDBEntity, StringMap, UnixTimestampNumber, UnixTimestampMillisNumber, UnixTimestamp, Integer, ValueOf, ValuesOf, AbortableMapper, AbortableAsyncPredicate, AbortableAsyncMapper, AbortablePredicate, NullishValue, FalsyValue } from './types';
+export * from './types';
 export * from './unit/size.util';
 import { is } from './vendor/is';
-import { CommonLogLevel, CommonLogFunction, CommonLogger, commonLoggerMinLevel, commonLoggerNoop, commonLogLevelNumber, commonLoggerPipe, commonLoggerPrefix, CommonLogWithLevelFunction, commonLoggerCreate } from './log/commonLogger';
+import { CommonLogLevel, CommonLogFunction, CommonLogger, CommonLogWithLevelFunction } from './log/commonLogger';
+export * from './log/commonLogger';
 export * from './string/safeJsonStringify';
-import { PQueue, PQueueCfg } from './promise/pQueue';
+import { PQueueCfg } from './promise/pQueue';
+export * from './promise/pQueue';
 export * from './seq/seq';
 export * from './math/stack.util';
 export * from './string/leven';
@@ -71,4 +74,4 @@ import { LocalTimeConfig, LocalTimeFormatter, LocalTimeUnit, LocalTimeComponents
 import { DateIntervalConfig, DateIntervalString } from './datetime/dateInterval';
 import { TimeIntervalConfig, TimeIntervalString } from './datetime/timeInterval';
 export type { DateIntervalConfig, DateIntervalString, TimeIntervalConfig, TimeIntervalString, LocalDateConfig, LocalDateFormatter, LocalDateUnit, LocalDateUnitStrict, Inclusiveness, LocalTimeConfig, LocalTimeFormatter, LocalTimeUnit, ISODayOfWeek, LocalTimeComponents, AbortableMapper, AbortablePredicate, AbortableAsyncPredicate, AbortableAsyncMapper, PQueueCfg, MemoCache, AsyncMemoCache, PromiseDecoratorCfg, PromiseDecoratorResp, ErrorData, ErrorObject, HttpErrorData, HttpErrorResponse, Admin401ErrorData, Admin403ErrorData, StringMap, PromiseMap, AnyObject, AnyEnum, NumberEnum, StringEnum, AnyFunction, ValuesOf, ValueOf, KeyValueTuple, ObjectMapper, ObjectPredicate, InstanceId, IsoDate, IsoDateString, IsoDateTimeString, Reviver, FalsyValue, NullishValue, PMapOptions, Mapper, AsyncMapper, Predicate, AsyncPredicate, BatchResult, DeferredPromise, PRetryOptions, PTimeoutOptions, TryCatchOptions, StringifyAnyOptions, JsonStringifyFunction, Merge, ReadonlyDeep, Promisable, Simplify, ConditionalPick, ConditionalExcept, Class, UnixTimestampNumber, UnixTimestampMillisNumber, UnixTimestamp, Integer, BaseDBEntity, SavedDBEntity, Saved, Unsaved, UnsavedId, CreatedUpdated, CreatedUpdatedId, ObjectWithId, AnyObjectWithId, JsonSchema, JsonSchemaAny, JsonSchemaOneOf, JsonSchemaAllOf, JsonSchemaAnyOf, JsonSchemaNot, JsonSchemaRef, JsonSchemaConst, JsonSchemaEnum, JsonSchemaString, JsonSchemaNumber, JsonSchemaBoolean, JsonSchemaNull, JsonSchemaRootObject, JsonSchemaObject, JsonSchemaArray, JsonSchemaTuple, JsonSchemaBuilder, CommonLogLevel, CommonLogWithLevelFunction, CommonLogFunction, CommonLogger, };
-export { is, _createPromiseDecorator, _stringMapValues, _stringMapEntries, _objectKeys, pMap, _passthroughMapper, _passUndefinedMapper, _passthroughPredicate, _passNothingPredicate, _noop, ErrorMode, pDefer, AggregatedError, pRetry, pRetryFn, pTimeout, pTimeoutFn, _tryCatch, _TryCatch, _stringifyAny, jsonSchema, JsonSchemaAnyBuilder, commonLoggerMinLevel, commonLoggerNoop, commonLogLevelNumber, commonLoggerPipe, commonLoggerPrefix, commonLoggerCreate, PQueue, END, SKIP, };
+export { is, _createPromiseDecorator, pMap, ErrorMode, pDefer, AggregatedError, pRetry, pRetryFn, pTimeout, pTimeoutFn, _tryCatch, _TryCatch, _stringifyAny, jsonSchema, JsonSchemaAnyBuilder, };

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SKIP = exports.END = exports.PQueue = exports.commonLoggerCreate = exports.commonLoggerPrefix = exports.commonLoggerPipe = exports.commonLogLevelNumber = exports.commonLoggerNoop = exports.commonLoggerMinLevel = exports.JsonSchemaAnyBuilder = exports.jsonSchema = exports._stringifyAny = exports._TryCatch = exports._tryCatch = exports.pTimeoutFn = exports.pTimeout = exports.pRetryFn = exports.pRetry = exports.AggregatedError = exports.pDefer = exports.ErrorMode = exports._noop = exports._passNothingPredicate = exports._passthroughPredicate = exports._passUndefinedMapper = exports._passthroughMapper = exports.pMap = exports._objectKeys = exports._stringMapEntries = exports._stringMapValues = exports._createPromiseDecorator = exports.is = void 0;
+exports.JsonSchemaAnyBuilder = exports.jsonSchema = exports._stringifyAny = exports._TryCatch = exports._tryCatch = exports.pTimeoutFn = exports.pTimeout = exports.pRetryFn = exports.pRetry = exports.AggregatedError = exports.pDefer = exports.ErrorMode = exports.pMap = exports._createPromiseDecorator = exports.is = void 0;
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./array/array.util"), exports);
 tslib_1.__exportStar(require("./lazy"), exports);
@@ -67,30 +67,13 @@ const stringifyAny_1 = require("./string/stringifyAny");
 Object.defineProperty(exports, "_stringifyAny", { enumerable: true, get: function () { return stringifyAny_1._stringifyAny; } });
 tslib_1.__exportStar(require("./time/time.util"), exports);
 tslib_1.__exportStar(require("./is.util"), exports);
-const types_1 = require("./types");
-Object.defineProperty(exports, "END", { enumerable: true, get: function () { return types_1.END; } });
-Object.defineProperty(exports, "SKIP", { enumerable: true, get: function () { return types_1.SKIP; } });
-Object.defineProperty(exports, "_noop", { enumerable: true, get: function () { return types_1._noop; } });
-Object.defineProperty(exports, "_objectKeys", { enumerable: true, get: function () { return types_1._objectKeys; } });
-Object.defineProperty(exports, "_passNothingPredicate", { enumerable: true, get: function () { return types_1._passNothingPredicate; } });
-Object.defineProperty(exports, "_passthroughMapper", { enumerable: true, get: function () { return types_1._passthroughMapper; } });
-Object.defineProperty(exports, "_passthroughPredicate", { enumerable: true, get: function () { return types_1._passthroughPredicate; } });
-Object.defineProperty(exports, "_passUndefinedMapper", { enumerable: true, get: function () { return types_1._passUndefinedMapper; } });
-Object.defineProperty(exports, "_stringMapEntries", { enumerable: true, get: function () { return types_1._stringMapEntries; } });
-Object.defineProperty(exports, "_stringMapValues", { enumerable: true, get: function () { return types_1._stringMapValues; } });
+tslib_1.__exportStar(require("./types"), exports);
 tslib_1.__exportStar(require("./unit/size.util"), exports);
 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, "commonLoggerMinLevel", { enumerable: true, get: function () { return commonLogger_1.commonLoggerMinLevel; } });
-Object.defineProperty(exports, "commonLoggerNoop", { enumerable: true, get: function () { return commonLogger_1.commonLoggerNoop; } });
-Object.defineProperty(exports, "commonLogLevelNumber", { enumerable: true, get: function () { return commonLogger_1.commonLogLevelNumber; } });
-Object.defineProperty(exports, "commonLoggerPipe", { enumerable: true, get: function () { return commonLogger_1.commonLoggerPipe; } });
-Object.defineProperty(exports, "commonLoggerPrefix", { enumerable: true, get: function () { return commonLogger_1.commonLoggerPrefix; } });
-Object.defineProperty(exports, "commonLoggerCreate", { enumerable: true, get: function () { return commonLogger_1.commonLoggerCreate; } });
+tslib_1.__exportStar(require("./log/commonLogger"), exports);
 tslib_1.__exportStar(require("./string/safeJsonStringify"), exports);
-const pQueue_1 = require("./promise/pQueue");
-Object.defineProperty(exports, "PQueue", { enumerable: true, get: function () { return pQueue_1.PQueue; } });
+tslib_1.__exportStar(require("./promise/pQueue"), exports);
 tslib_1.__exportStar(require("./seq/seq"), exports);
 tslib_1.__exportStar(require("./math/stack.util"), exports);
 tslib_1.__exportStar(require("./string/leven"), exports);

package/dist/promise/pDefer.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.pDefer = void 0;
+/* eslint-disable @typescript-eslint/promise-function-async */
 /**
  * Returns DeferredPromise - a Promise that has .resolve() and .reject() methods.
  */

package/dist/promise/pDelay.js

@@ -2,6 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.pDelay = void 0;
 async function pDelay(ms = 0, value) {
-    return new Promise(resolve => setTimeout(() => resolve(value), ms));
+    return await new Promise(resolve => setTimeout(() => resolve(value), ms));
 }
 exports.pDelay = pDelay;

package/dist/promise/pHang.js

@@ -5,6 +5,6 @@ exports.pHang = void 0;
  * Returns Promise that never resolves ("hanging").
  */
 async function pHang() {
-    return new Promise(() => void 0);
+    return await new Promise(() => void 0);
 }
 exports.pHang = pHang;

package/dist/promise/pMap.js

@@ -94,7 +94,7 @@ async function pMap(iterable, mapper, opt = {}) {
         }
         return ret;
     }
-    return new Promise((resolve, reject) => {
+    return await new Promise((resolve, reject) => {
         const next = () => {
             if (isSettled) {
                 return;

package/dist/promise/pQueue.js

@@ -39,18 +39,18 @@ class PQueue {
      * Resolves immediately in case the queue is Idle.
      * Idle means 0 queue and 0 inFlight.
      */
-    onIdle() {
+    async onIdle() {
         if (this.queue.length === 0 && this.inFlight === 0)
-            return Promise.resolve();
+            return;
         const listener = (0, pDefer_1.pDefer)();
         this.onIdleListeners.push(listener);
-        return listener;
+        return await listener;
     }
     /**
      * Push PromiseReturningFunction to the Queue.
      * Returns a Promise that resolves (or rejects) with the return value from the Promise.
      */
-    push(fn_) {
+    async push(fn_) {
         const { concurrency } = this.cfg;
         const resolveOnStart = this.cfg.resolveOn === 'start';
         const fn = fn_;
@@ -99,7 +99,7 @@ class PQueue {
             this.queue.push(fn);
             this.debug(`inFlight ${this.inFlight}/${concurrency}, queue++ ${this.queue.length}`);
         }
-        return fn.defer;
+        return await fn.defer;
     }
 }
 exports.PQueue = PQueue;

package/dist/promise/pState.js

@@ -11,7 +11,7 @@ const UNIQUE_VALUE = Symbol('unique');
  * Based on: https://makandracards.com/makandra/46681-javascript-how-to-query-the-state-of-a-native-promise
  */
 async function pState(p) {
-    return Promise.race([p, Promise.resolve(UNIQUE_VALUE)]).then(v => {
+    return await Promise.race([p, Promise.resolve(UNIQUE_VALUE)]).then(v => {
         return v === UNIQUE_VALUE ? 'pending' : 'resolved';
     }, () => 'rejected');
 }

package/dist/types.d.ts

@@ -194,3 +194,15 @@ export declare function _stringMapEntries<T>(m: StringMap<T>): [k: string, v: T]
 export declare function _objectKeys<T extends AnyObject>(obj: T): (keyof T)[];
 export declare type NullishValue = null | undefined;
 export declare type FalsyValue = false | '' | 0 | null | undefined;
+/**
+ * Utility function that helps to cast *existing variable* to needed type T.
+ *
+ * @example
+ * try {} catch (err) {
+ *   // err is unknown here
+ *   _typeCast<AppError>(err)
+ *   // now err is of type AppError
+ *   err.data = {} // can be done, because it was casted
+ * }
+ */
+export declare function _typeCast<T>(v: any): asserts v is T;

package/dist/types.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._objectKeys = exports._stringMapEntries = exports._stringMapValues = exports._passNothingPredicate = exports._passthroughPredicate = exports._noop = exports._passUndefinedMapper = exports._passthroughMapper = exports.SKIP = exports.END = void 0;
+exports._typeCast = exports._objectKeys = exports._stringMapEntries = exports._stringMapValues = exports._passNothingPredicate = exports._passthroughPredicate = exports._noop = exports._passUndefinedMapper = exports._passthroughMapper = exports.SKIP = exports.END = void 0;
 /**
  * Symbol to indicate END of Sequence.
  */
@@ -48,3 +48,16 @@ function _objectKeys(obj) {
     return Object.keys(obj);
 }
 exports._objectKeys = _objectKeys;
+/**
+ * Utility function that helps to cast *existing variable* to needed type T.
+ *
+ * @example
+ * try {} catch (err) {
+ *   // err is unknown here
+ *   _typeCast<AppError>(err)
+ *   // now err is of type AppError
+ *   err.data = {} // can be done, because it was casted
+ * }
+ */
+function _typeCast(v) { }
+exports._typeCast = _typeCast;

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

@@ -96,3 +96,19 @@ export function _isHttpErrorObject(o) {
 export function _isErrorObject(o) {
     return (!!o && typeof o.name === 'string' && typeof o.message === 'string' && typeof o.data === 'object');
 }
+/**
+ * Convenience function to safely add properties to Error's `data` object
+ * (even if it wasn't previously existing)
+ *
+ * @example
+ *
+ * try {} catch (err) {
+ *   _errorDataAppend(err, {
+ *     httpStatusCode: 401,
+ *   })
+ * }
+ */
+export function _errorDataAppend(err, data) {
+    ;
+    err.data = Object.assign(Object.assign({}, err.data), data);
+}

package/dist-esm/index.js

@@ -49,12 +49,12 @@ export * from './string/string.util';
 import { _stringifyAny } from './string/stringifyAny';
 export * from './time/time.util';
 export * from './is.util';
-import { END, SKIP, _noop, _objectKeys, _passNothingPredicate, _passthroughMapper, _passthroughPredicate, _passUndefinedMapper, _stringMapEntries, _stringMapValues, } from './types';
+export * from './types';
 export * from './unit/size.util';
 import { is } from './vendor/is';
-import { commonLoggerMinLevel, commonLoggerNoop, commonLogLevelNumber, commonLoggerPipe, commonLoggerPrefix, commonLoggerCreate, } from './log/commonLogger';
+export * from './log/commonLogger';
 export * from './string/safeJsonStringify';
-import { PQueue } from './promise/pQueue';
+export * from './promise/pQueue';
 export * from './seq/seq';
 export * from './math/stack.util';
 export * from './string/leven';
@@ -63,4 +63,4 @@ export * from './datetime/localTime';
 export * from './datetime/dateInterval';
 export * from './datetime/timeInterval';
 import { ISODayOfWeek, } from './datetime/localTime';
-export { is, _createPromiseDecorator, _stringMapValues, _stringMapEntries, _objectKeys, pMap, _passthroughMapper, _passUndefinedMapper, _passthroughPredicate, _passNothingPredicate, _noop, ErrorMode, pDefer, AggregatedError, pRetry, pRetryFn, pTimeout, pTimeoutFn, _tryCatch, _TryCatch, _stringifyAny, jsonSchema, JsonSchemaAnyBuilder, commonLoggerMinLevel, commonLoggerNoop, commonLogLevelNumber, commonLoggerPipe, commonLoggerPrefix, commonLoggerCreate, PQueue, END, SKIP, };
+export { is, _createPromiseDecorator, pMap, ErrorMode, pDefer, AggregatedError, pRetry, pRetryFn, pTimeout, pTimeoutFn, _tryCatch, _TryCatch, _stringifyAny, jsonSchema, JsonSchemaAnyBuilder, };

package/dist-esm/promise/pDefer.js

@@ -1,3 +1,4 @@
+/* eslint-disable @typescript-eslint/promise-function-async */
 /**
  * Returns DeferredPromise - a Promise that has .resolve() and .reject() methods.
  */

package/dist-esm/promise/pDelay.js

@@ -1,3 +1,3 @@
 export async function pDelay(ms = 0, value) {
-    return new Promise(resolve => setTimeout(() => resolve(value), ms));
+    return await new Promise(resolve => setTimeout(() => resolve(value), ms));
 }

package/dist-esm/promise/pHang.js

@@ -2,5 +2,5 @@
  * Returns Promise that never resolves ("hanging").
  */
 export async function pHang() {
-    return new Promise(() => void 0);
+    return await new Promise(() => void 0);
 }

package/dist-esm/promise/pMap.js

@@ -103,7 +103,7 @@ export async function pMap(iterable, mapper, opt = {}) {
         }
         return ret;
     }
-    return new Promise((resolve, reject) => {
+    return await new Promise((resolve, reject) => {
         const next = () => {
             if (isSettled) {
                 return;

package/dist-esm/promise/pQueue.js

@@ -31,18 +31,18 @@ export class PQueue {
      * Resolves immediately in case the queue is Idle.
      * Idle means 0 queue and 0 inFlight.
      */
-    onIdle() {
+    async onIdle() {
         if (this.queue.length === 0 && this.inFlight === 0)
-            return Promise.resolve();
+            return;
         const listener = pDefer();
         this.onIdleListeners.push(listener);
-        return listener;
+        return await listener;
     }
     /**
      * Push PromiseReturningFunction to the Queue.
      * Returns a Promise that resolves (or rejects) with the return value from the Promise.
      */
-    push(fn_) {
+    async push(fn_) {
         const { concurrency } = this.cfg;
         const resolveOnStart = this.cfg.resolveOn === 'start';
         const fn = fn_;
@@ -91,6 +91,6 @@ export class PQueue {
             this.queue.push(fn);
             this.debug(`inFlight ${this.inFlight}/${concurrency}, queue++ ${this.queue.length}`);
         }
-        return fn.defer;
+        return await fn.defer;
     }
 }

package/dist-esm/promise/pState.js

@@ -8,7 +8,7 @@ const UNIQUE_VALUE = Symbol('unique');
  * Based on: https://makandracards.com/makandra/46681-javascript-how-to-query-the-state-of-a-native-promise
  */
 export async function pState(p) {
-    return Promise.race([p, Promise.resolve(UNIQUE_VALUE)]).then(v => {
+    return await Promise.race([p, Promise.resolve(UNIQUE_VALUE)]).then(v => {
         return v === UNIQUE_VALUE ? 'pending' : 'resolved';
     }, () => 'rejected');
 }

package/dist-esm/types.js

@@ -37,3 +37,15 @@ export function _stringMapEntries(m) {
 export function _objectKeys(obj) {
     return Object.keys(obj);
 }
+/**
+ * Utility function that helps to cast *existing variable* to needed type T.
+ *
+ * @example
+ * try {} catch (err) {
+ *   // err is unknown here
+ *   _typeCast<AppError>(err)
+ *   // now err is of type AppError
+ *   err.data = {} // can be done, because it was casted
+ * }
+ */
+export function _typeCast(v) { }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/js-lib",
-  "version": "14.105.0",
+  "version": "14.107.0",
   "scripts": {
     "prepare": "husky install",
     "build-prod": "build-prod-esm-cjs",
@@ -12,10 +12,11 @@
   },
   "devDependencies": {
     "@naturalcycles/bench-lib": "^1.5.0",
-    "@naturalcycles/dev-lib": "^12.0.0",
+    "@naturalcycles/dev-lib": "^13.0.1",
     "@naturalcycles/nodejs-lib": "^12.33.4",
     "@naturalcycles/time-lib": "^3.5.1",
-    "@types/node": "^17.0.4",
+    "@types/node": "^18.0.0",
+    "expect-type": "^0.13.0",
     "jest": "^28.0.3",
     "patch-package": "^6.2.1",
     "prettier": "^2.1.2",

package/src/error/error.util.ts

@@ -145,3 +145,22 @@ export function _isErrorObject(o: any): o is ErrorObject {
     !!o && typeof o.name === 'string' && typeof o.message === 'string' && typeof o.data === 'object'
   )
 }
+
+/**
+ * Convenience function to safely add properties to Error's `data` object
+ * (even if it wasn't previously existing)
+ *
+ * @example
+ *
+ * try {} catch (err) {
+ *   _errorDataAppend(err, {
+ *     httpStatusCode: 401,
+ *   })
+ * }
+ */
+export function _errorDataAppend(err: Error, data: ErrorData): void {
+  ;(err as any).data = {
+    ...(err as any).data,
+    ...data,
+  }
+}

package/src/index.ts

@@ -137,33 +137,20 @@ import {
   AbortablePredicate,
   NullishValue,
   FalsyValue,
-  END,
-  SKIP,
-  _noop,
-  _objectKeys,
-  _passNothingPredicate,
-  _passthroughMapper,
-  _passthroughPredicate,
-  _passUndefinedMapper,
-  _stringMapEntries,
-  _stringMapValues,
 } from './types'
+export * from './types'
 export * from './unit/size.util'
 import { is } from './vendor/is'
 import {
   CommonLogLevel,
   CommonLogFunction,
   CommonLogger,
-  commonLoggerMinLevel,
-  commonLoggerNoop,
-  commonLogLevelNumber,
-  commonLoggerPipe,
-  commonLoggerPrefix,
   CommonLogWithLevelFunction,
-  commonLoggerCreate,
 } from './log/commonLogger'
+export * from './log/commonLogger'
 export * from './string/safeJsonStringify'
-import { PQueue, PQueueCfg } from './promise/pQueue'
+import { PQueueCfg } from './promise/pQueue'
+export * from './promise/pQueue'
 export * from './seq/seq'
 export * from './math/stack.util'
 export * from './string/leven'
@@ -296,15 +283,7 @@ export type {
 export {
   is,
   _createPromiseDecorator,
-  _stringMapValues,
-  _stringMapEntries,
-  _objectKeys,
   pMap,
-  _passthroughMapper,
-  _passUndefinedMapper,
-  _passthroughPredicate,
-  _passNothingPredicate,
-  _noop,
   ErrorMode,
   pDefer,
   AggregatedError,
@@ -317,13 +296,4 @@ export {
   _stringifyAny,
   jsonSchema,
   JsonSchemaAnyBuilder,
-  commonLoggerMinLevel,
-  commonLoggerNoop,
-  commonLogLevelNumber,
-  commonLoggerPipe,
-  commonLoggerPrefix,
-  commonLoggerCreate,
-  PQueue,
-  END,
-  SKIP,
 }

package/src/promise/pDefer.ts

@@ -6,6 +6,8 @@ export interface DeferredPromise<T = void> extends Promise<T> {
   reject(e?: Error): void
 }
 
+/* eslint-disable @typescript-eslint/promise-function-async */
+
 /**
  * Returns DeferredPromise - a Promise that has .resolve() and .reject() methods.
  */

package/src/promise/pDelay.ts

@@ -1,3 +1,3 @@
 export async function pDelay<T>(ms: number = 0, value?: T): Promise<T> {
-  return new Promise<T>(resolve => setTimeout(() => resolve(value as T), ms))
+  return await new Promise<T>(resolve => setTimeout(() => resolve(value as T), ms))
 }

package/src/promise/pHang.ts

@@ -2,5 +2,5 @@
  * Returns Promise that never resolves ("hanging").
  */
 export async function pHang(): Promise<never> {
-  return new Promise<never>(() => void 0)
+  return await new Promise<never>(() => void 0)
 }

package/src/promise/pMap.ts

@@ -120,7 +120,7 @@ export async function pMap<IN, OUT>(
     return ret as OUT[]
   }
 
-  return new Promise<OUT[]>((resolve, reject) => {
+  return await new Promise<OUT[]>((resolve, reject) => {
     const next = () => {
       if (isSettled) {
         return

package/src/promise/pQueue.ts

@@ -94,19 +94,19 @@ export class PQueue {
    * Resolves immediately in case the queue is Idle.
    * Idle means 0 queue and 0 inFlight.
    */
-  onIdle(): Promise<void> {
-    if (this.queue.length === 0 && this.inFlight === 0) return Promise.resolve()
+  async onIdle(): Promise<void> {
+    if (this.queue.length === 0 && this.inFlight === 0) return
 
     const listener = pDefer()
     this.onIdleListeners.push(listener)
-    return listener
+    return await listener
   }
 
   /**
    * Push PromiseReturningFunction to the Queue.
    * Returns a Promise that resolves (or rejects) with the return value from the Promise.
    */
-  push<R>(fn_: PromiseReturningFunction<R>): Promise<R> {
+  async push<R>(fn_: PromiseReturningFunction<R>): Promise<R> {
     const { concurrency } = this.cfg
     const resolveOnStart = this.cfg.resolveOn === 'start'
 
@@ -155,6 +155,6 @@ export class PQueue {
       this.debug(`inFlight ${this.inFlight}/${concurrency}, queue++ ${this.queue.length}`)
     }
 
-    return fn.defer
+    return await fn.defer
   }
 }

package/src/promise/pState.ts

@@ -9,7 +9,7 @@ const UNIQUE_VALUE = Symbol('unique')
  * Based on: https://makandracards.com/makandra/46681-javascript-how-to-query-the-state-of-a-native-promise
  */
 export async function pState(p: Promise<any>): Promise<'resolved' | 'rejected' | 'pending'> {
-  return Promise.race([p, Promise.resolve(UNIQUE_VALUE)]).then(
+  return await Promise.race([p, Promise.resolve(UNIQUE_VALUE)]).then(
     v => {
       return v === UNIQUE_VALUE ? 'pending' : 'resolved'
     },

package/src/types.ts

@@ -267,3 +267,16 @@ export function _objectKeys<T extends AnyObject>(obj: T): (keyof T)[] {
 
 export type NullishValue = null | undefined
 export type FalsyValue = false | '' | 0 | null | undefined
+
+/**
+ * Utility function that helps to cast *existing variable* to needed type T.
+ *
+ * @example
+ * try {} catch (err) {
+ *   // err is unknown here
+ *   _typeCast<AppError>(err)
+ *   // now err is of type AppError
+ *   err.data = {} // can be done, because it was casted
+ * }
+ */
+export function _typeCast<T>(v: any): asserts v is T {}