@naturalcycles/js-lib 14.104.1 → 14.105.1

package/dist/enum.util.d.ts

@@ -0,0 +1,55 @@
+import { NumberEnum, StringEnum } from './types';
+/**
+ * Returns all number keys of a number-enum.
+ */
+export declare function _numberEnumKeys(en: NumberEnum): string[];
+/**
+ * Returns all number values of a number-enum.
+ */
+export declare function _numberEnumValues(en: NumberEnum): number[];
+/**
+ * Returns all string keys of a string-enum.
+ */
+export declare function _stringEnumKeys(en: StringEnum): string[];
+/**
+ * Returns all string values of a string-enum.
+ */
+export declare function _stringEnumValues(en: StringEnum): string[];
+/**
+ * Returns all number-enum "entries", where entry is a tuple of [key, value],
+ * where key is a String key, value is a Number value, typed as Enum itself.
+ *
+ * Doesn't work on String-enums!
+ */
+export declare function _numberEnumEntries<T extends NumberEnum>(en: T): [k: string, v: T[keyof T]][];
+/**
+ * Returns all string-enum "entries", where entry is a tuple of [key, value],
+ * where key is a String key, value is a String value, typed as Enum itself.
+ *
+ * Doesn't work on Number-enums!
+ */
+export declare function _stringEnumEntries<T extends StringEnum>(en: T): [k: string, v: T[keyof T]][];
+/**
+ * Allows to return a Number enum value (typed as Enum itself) based on it's String key.
+ * e.g:
+ * const v = SomeEnum['stringValue']
+ * // v is of type SomeEnum, which is of type Number
+ *
+ * Throws if value is not found!
+ */
+export declare function _numberEnumInverse<T extends NumberEnum>(en: T, v: string): T[keyof T];
+/**
+ * _enumInverse, but allows to get/return undefined output.
+ */
+export declare function _numberEnumInverseNullable<T extends NumberEnum>(en: T, v: string | undefined): T[keyof T] | undefined;
+/**
+ * Takes number or string enum input, returns normalized Enum output.
+ * Only works for number enums.
+ *
+ * Throws if value is not found!
+ */
+export declare function _numberEnumNormalize<T extends NumberEnum>(en: T, v: string | number): T[keyof T];
+/**
+ * Same as _enumNormalize, but allows to return undefined values.
+ */
+export declare function _numberEnumNormalizeNullable<T extends NumberEnum>(en: T, v: string | number | undefined): T[keyof T] | undefined;

package/dist/enum.util.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._numberEnumNormalizeNullable = exports._numberEnumNormalize = exports._numberEnumInverseNullable = exports._numberEnumInverse = exports._stringEnumEntries = exports._numberEnumEntries = exports._stringEnumValues = exports._stringEnumKeys = exports._numberEnumValues = exports._numberEnumKeys = void 0;
+/**
+ * Returns all number keys of a number-enum.
+ */
+function _numberEnumKeys(en) {
+    return Object.values(en).filter(k => typeof k === 'string');
+}
+exports._numberEnumKeys = _numberEnumKeys;
+/**
+ * Returns all number values of a number-enum.
+ */
+function _numberEnumValues(en) {
+    return Object.values(en).filter(k => typeof k === 'number');
+}
+exports._numberEnumValues = _numberEnumValues;
+/**
+ * Returns all string keys of a string-enum.
+ */
+function _stringEnumKeys(en) {
+    return Object.keys(en);
+}
+exports._stringEnumKeys = _stringEnumKeys;
+/**
+ * Returns all string values of a string-enum.
+ */
+function _stringEnumValues(en) {
+    // filtering here is unnecessary, but works as a safety in case Number-enum is passed
+    return Object.values(en).filter(k => typeof k === 'string');
+}
+exports._stringEnumValues = _stringEnumValues;
+/**
+ * Returns all number-enum "entries", where entry is a tuple of [key, value],
+ * where key is a String key, value is a Number value, typed as Enum itself.
+ *
+ * Doesn't work on String-enums!
+ */
+function _numberEnumEntries(en) {
+    return Object.values(en)
+        .filter(k => typeof k === 'string')
+        .map(k => [k, en[k]]);
+}
+exports._numberEnumEntries = _numberEnumEntries;
+/**
+ * Returns all string-enum "entries", where entry is a tuple of [key, value],
+ * where key is a String key, value is a String value, typed as Enum itself.
+ *
+ * Doesn't work on Number-enums!
+ */
+function _stringEnumEntries(en) {
+    return Object.keys(en).map(k => [k, en[k]]);
+}
+exports._stringEnumEntries = _stringEnumEntries;
+/**
+ * Allows to return a Number enum value (typed as Enum itself) based on it's String key.
+ * e.g:
+ * const v = SomeEnum['stringValue']
+ * // v is of type SomeEnum, which is of type Number
+ *
+ * Throws if value is not found!
+ */
+function _numberEnumInverse(en, v) {
+    const r = en[v];
+    if (!r)
+        throw new Error(`enumInverse value not found for: ${v}`);
+    return r;
+}
+exports._numberEnumInverse = _numberEnumInverse;
+/**
+ * _enumInverse, but allows to get/return undefined output.
+ */
+function _numberEnumInverseNullable(en, v) {
+    return en[v];
+}
+exports._numberEnumInverseNullable = _numberEnumInverseNullable;
+/**
+ * Takes number or string enum input, returns normalized Enum output.
+ * Only works for number enums.
+ *
+ * Throws if value is not found!
+ */
+function _numberEnumNormalize(en, v) {
+    const r = _numberEnumNormalizeNullable(en, v);
+    if (!r || !en[r])
+        throw new Error(`enumNormalize value not found for: ${v}`);
+    return r;
+}
+exports._numberEnumNormalize = _numberEnumNormalize;
+/**
+ * Same as _enumNormalize, but allows to return undefined values.
+ */
+function _numberEnumNormalizeNullable(en, v) {
+    return typeof v === 'string' ? en[v] : v;
+}
+exports._numberEnumNormalizeNullable = _numberEnumNormalizeNullable;

package/dist/index.d.ts

@@ -16,6 +16,7 @@ export * from './decorators/retry.decorator';
 export * from './decorators/timeout.decorator';
 export * from './error/app.error';
 export * from './error/assert';
+export * from './enum.util';
 import { Admin401ErrorData, Admin403ErrorData, ErrorData, ErrorObject, HttpErrorData, HttpErrorResponse } from './error/error.model';
 export * from './error/error.util';
 import { ErrorMode } from './error/errorMode';
@@ -52,7 +53,7 @@ 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, 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, END, SKIP, _noop, _objectKeys, _passNothingPredicate, _passthroughMapper, _passthroughPredicate, _passUndefinedMapper, _stringMapEntries, _stringMapValues } 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';
@@ -69,5 +70,5 @@ import { LocalDateConfig, LocalDateFormatter, LocalDateUnit, LocalDateUnitStrict
 import { LocalTimeConfig, LocalTimeFormatter, LocalTimeUnit, LocalTimeComponents, ISODayOfWeek } from './datetime/localTime';
 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, 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 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, };

package/dist/index.js

@@ -20,6 +20,7 @@ tslib_1.__exportStar(require("./decorators/retry.decorator"), exports);
 tslib_1.__exportStar(require("./decorators/timeout.decorator"), exports);
 tslib_1.__exportStar(require("./error/app.error"), exports);
 tslib_1.__exportStar(require("./error/assert"), exports);
+tslib_1.__exportStar(require("./enum.util"), exports);
 tslib_1.__exportStar(require("./error/error.util"), exports);
 const errorMode_1 = require("./error/errorMode");
 Object.defineProperty(exports, "ErrorMode", { enumerable: true, get: function () { return errorMode_1.ErrorMode; } });

package/dist/object/object.util.js

@@ -330,6 +330,7 @@ function _set(obj, path, value) {
             a[c]
         : // No: create the key. Is the next key a potential array-index?
             (a[c] =
+                // @ts-ignore
                 // eslint-disable-next-line
                 Math.abs(path[i + 1]) >> 0 === +path[i + 1]
                     ? [] // Yes: assign a new array object

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/pProps.js

@@ -17,6 +17,8 @@ exports.pProps = void 0;
  */
 async function pProps(input) {
     const keys = Object.keys(input);
+    // `as any` here is added to make it compile when `noUncheckedIndexedAccess` is false
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-assertion
     return Object.fromEntries((await Promise.all(Object.values(input))).map((v, i) => [keys[i], v]));
 }
 exports.pProps = pProps;

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/string/url.util.js

@@ -17,7 +17,7 @@ exports._parseQueryString = void 0;
 function _parseQueryString(search) {
     const qs = {};
     search
-        .substr(search[0] === '?' ? 1 : 0)
+        .slice(search[0] === '?' ? 1 : 0)
         .split('&')
         .forEach(p => {
         const [k, v] = p.split('=');

package/dist/types.d.ts

@@ -20,6 +20,9 @@ export interface PromiseMap {
  * Because `object` type is not safe/recommended to be used (e.g discouraged by eslint-typescript due to: https://github.com/microsoft/TypeScript/issues/21732)
  */
 export declare type AnyObject = Record<string, any>;
+export declare type AnyEnum = NumberEnum;
+export declare type NumberEnum = Record<string, number | string>;
+export declare type StringEnum = Record<string, string>;
 export interface CreatedUpdated {
     created: number;
     updated: number;

package/dist-esm/enum.util.js

@@ -0,0 +1,83 @@
+/**
+ * Returns all number keys of a number-enum.
+ */
+export function _numberEnumKeys(en) {
+    return Object.values(en).filter(k => typeof k === 'string');
+}
+/**
+ * Returns all number values of a number-enum.
+ */
+export function _numberEnumValues(en) {
+    return Object.values(en).filter(k => typeof k === 'number');
+}
+/**
+ * Returns all string keys of a string-enum.
+ */
+export function _stringEnumKeys(en) {
+    return Object.keys(en);
+}
+/**
+ * Returns all string values of a string-enum.
+ */
+export function _stringEnumValues(en) {
+    // filtering here is unnecessary, but works as a safety in case Number-enum is passed
+    return Object.values(en).filter(k => typeof k === 'string');
+}
+/**
+ * Returns all number-enum "entries", where entry is a tuple of [key, value],
+ * where key is a String key, value is a Number value, typed as Enum itself.
+ *
+ * Doesn't work on String-enums!
+ */
+export function _numberEnumEntries(en) {
+    return Object.values(en)
+        .filter(k => typeof k === 'string')
+        .map(k => [k, en[k]]);
+}
+/**
+ * Returns all string-enum "entries", where entry is a tuple of [key, value],
+ * where key is a String key, value is a String value, typed as Enum itself.
+ *
+ * Doesn't work on Number-enums!
+ */
+export function _stringEnumEntries(en) {
+    return Object.keys(en).map(k => [k, en[k]]);
+}
+/**
+ * Allows to return a Number enum value (typed as Enum itself) based on it's String key.
+ * e.g:
+ * const v = SomeEnum['stringValue']
+ * // v is of type SomeEnum, which is of type Number
+ *
+ * Throws if value is not found!
+ */
+export function _numberEnumInverse(en, v) {
+    const r = en[v];
+    if (!r)
+        throw new Error(`enumInverse value not found for: ${v}`);
+    return r;
+}
+/**
+ * _enumInverse, but allows to get/return undefined output.
+ */
+export function _numberEnumInverseNullable(en, v) {
+    return en[v];
+}
+/**
+ * Takes number or string enum input, returns normalized Enum output.
+ * Only works for number enums.
+ *
+ * Throws if value is not found!
+ */
+export function _numberEnumNormalize(en, v) {
+    const r = _numberEnumNormalizeNullable(en, v);
+    if (!r || !en[r])
+        throw new Error(`enumNormalize value not found for: ${v}`);
+    return r;
+}
+/**
+ * Same as _enumNormalize, but allows to return undefined values.
+ */
+export function _numberEnumNormalizeNullable(en, v) {
+    return typeof v === 'string' ? en[v] : v;
+}

package/dist-esm/index.js

@@ -15,6 +15,7 @@ export * from './decorators/retry.decorator';
 export * from './decorators/timeout.decorator';
 export * from './error/app.error';
 export * from './error/assert';
+export * from './enum.util';
 export * from './error/error.util';
 import { ErrorMode } from './error/errorMode';
 export * from './error/http.error';

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

@@ -306,6 +306,7 @@ export function _set(obj, path, value) {
             a[c]
         : // No: create the key. Is the next key a potential array-index?
             (a[c] =
+                // @ts-ignore
                 // eslint-disable-next-line
                 Math.abs(path[i + 1]) >> 0 === +path[i + 1]
                     ? [] // Yes: assign a new array object

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/pProps.js

@@ -14,5 +14,7 @@
  */
 export async function pProps(input) {
     const keys = Object.keys(input);
+    // `as any` here is added to make it compile when `noUncheckedIndexedAccess` is false
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-assertion
     return Object.fromEntries((await Promise.all(Object.values(input))).map((v, i) => [keys[i], v]));
 }

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/string/url.util.js

@@ -14,7 +14,7 @@
 export function _parseQueryString(search) {
     const qs = {};
     search
-        .substr(search[0] === '?' ? 1 : 0)
+        .slice(search[0] === '?' ? 1 : 0)
         .split('&')
         .forEach(p => {
         const [k, v] = p.split('=');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/js-lib",
-  "version": "14.104.1",
+  "version": "14.105.1",
   "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/enum.util.ts

@@ -0,0 +1,98 @@
+import { NumberEnum, StringEnum } from './types'
+
+/**
+ * Returns all number keys of a number-enum.
+ */
+export function _numberEnumKeys(en: NumberEnum): string[] {
+  return Object.values(en).filter(k => typeof k === 'string') as string[]
+}
+
+/**
+ * Returns all number values of a number-enum.
+ */
+export function _numberEnumValues(en: NumberEnum): number[] {
+  return Object.values(en).filter(k => typeof k === 'number') as number[]
+}
+
+/**
+ * Returns all string keys of a string-enum.
+ */
+export function _stringEnumKeys(en: StringEnum): string[] {
+  return Object.keys(en)
+}
+
+/**
+ * Returns all string values of a string-enum.
+ */
+export function _stringEnumValues(en: StringEnum): string[] {
+  // filtering here is unnecessary, but works as a safety in case Number-enum is passed
+  return Object.values(en).filter(k => typeof k === 'string')
+}
+
+/**
+ * Returns all number-enum "entries", where entry is a tuple of [key, value],
+ * where key is a String key, value is a Number value, typed as Enum itself.
+ *
+ * Doesn't work on String-enums!
+ */
+export function _numberEnumEntries<T extends NumberEnum>(en: T): [k: string, v: T[keyof T]][] {
+  return Object.values(en)
+    .filter(k => typeof k === 'string')
+    .map(k => [k, en[k]]) as any
+}
+
+/**
+ * Returns all string-enum "entries", where entry is a tuple of [key, value],
+ * where key is a String key, value is a String value, typed as Enum itself.
+ *
+ * Doesn't work on Number-enums!
+ */
+export function _stringEnumEntries<T extends StringEnum>(en: T): [k: string, v: T[keyof T]][] {
+  return Object.keys(en).map(k => [k, en[k]]) as any
+}
+
+/**
+ * Allows to return a Number enum value (typed as Enum itself) based on it's String key.
+ * e.g:
+ * const v = SomeEnum['stringValue']
+ * // v is of type SomeEnum, which is of type Number
+ *
+ * Throws if value is not found!
+ */
+export function _numberEnumInverse<T extends NumberEnum>(en: T, v: string): T[keyof T] {
+  const r = en[v as keyof T] as any
+  if (!r) throw new Error(`enumInverse value not found for: ${v}`)
+  return r
+}
+
+/**
+ * _enumInverse, but allows to get/return undefined output.
+ */
+export function _numberEnumInverseNullable<T extends NumberEnum>(
+  en: T,
+  v: string | undefined,
+): T[keyof T] | undefined {
+  return en[v as keyof T]
+}
+
+/**
+ * Takes number or string enum input, returns normalized Enum output.
+ * Only works for number enums.
+ *
+ * Throws if value is not found!
+ */
+export function _numberEnumNormalize<T extends NumberEnum>(en: T, v: string | number): T[keyof T] {
+  const r = _numberEnumNormalizeNullable(en, v)
+  if (!r || !en[r as keyof T]) throw new Error(`enumNormalize value not found for: ${v}`)
+  return r
+}
+
+/**
+ * Same as _enumNormalize, but allows to return undefined values.
+ */
+export function _numberEnumNormalizeNullable<T extends NumberEnum>(
+  en: T,
+  v: string | number | undefined,
+): T[keyof T] | undefined {
+  return typeof v === 'string' ? en[v as keyof T] : (v as any)
+}

package/src/index.ts

@@ -20,6 +20,7 @@ export * from './decorators/retry.decorator'
 export * from './decorators/timeout.decorator'
 export * from './error/app.error'
 export * from './error/assert'
+export * from './enum.util'
 import {
   Admin401ErrorData,
   Admin403ErrorData,
@@ -117,6 +118,9 @@ import {
   Predicate,
   PromiseMap,
   AnyObject,
+  AnyEnum,
+  NumberEnum,
+  StringEnum,
   AnyFunction,
   Reviver,
   SavedDBEntity,
@@ -217,6 +221,9 @@ export type {
   StringMap,
   PromiseMap,
   AnyObject,
+  AnyEnum,
+  NumberEnum,
+  StringEnum,
   AnyFunction,
   ValuesOf,
   ValueOf,

package/src/object/object.util.ts

@@ -125,7 +125,7 @@ export function _mapValues<T extends AnyObject, OUT = T>(
   mutate = false,
 ): OUT {
   return Object.entries(obj).reduce((map, [k, v]) => {
-    map[k] = mapper(k, v, obj)
+    map[k as keyof OUT] = mapper(k, v, obj)
     return map
   }, (mutate ? obj : {}) as OUT)
 }
@@ -142,9 +142,9 @@ export function _mapKeys<T extends AnyObject>(
 ): StringMap<T[keyof T]> {
   // eslint-disable-next-line unicorn/prefer-object-from-entries
   return Object.entries(obj).reduce((map, [k, v]) => {
-    map[mapper(k, v, obj)] = v
+    map[mapper(k, v, obj) as keyof T] = v
     return map
-  }, {})
+  }, {} as T)
 }
 
 /**
@@ -299,7 +299,7 @@ export function _unset<T extends AnyObject>(obj: T, prop: string): void {
 export function _invert<T extends AnyObject>(o: T): { [k in ValueOf<T>]: keyof T | undefined } {
   const inv = {} as { [k in ValueOf<T>]: keyof T }
   Object.keys(o).forEach(k => {
-    inv[o[k]] = k
+    inv[o[k] as ValueOf<T>] = k
   })
   return inv
 }
@@ -365,6 +365,7 @@ export function _set<IN extends AnyObject, OUT = IN>(
           a[c]
         : // No: create the key. Is the next key a potential array-index?
           (a[c] =
+            // @ts-ignore
             // eslint-disable-next-line
             Math.abs(path[i + 1]) >> 0 === +path[i + 1]
               ? [] // Yes: assign a new array object

package/src/object/sortObjectDeep.ts

@@ -16,7 +16,7 @@ export function _sortObjectDeep<T>(o: T): T {
     Object.keys(o)
       .sort((a, b) => a.localeCompare(b))
       .forEach(k => {
-        out[k] = _sortObjectDeep(o[k])
+        out[k as keyof T] = _sortObjectDeep(o[k as keyof T])
       })
 
     return out

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/pProps.ts

@@ -16,5 +16,9 @@ export async function pProps<T>(input: { [K in keyof T]: T[K] | Promise<T[K]> })
   [K in keyof T]: Awaited<T[K]>
 }> {
   const keys = Object.keys(input)
-  return Object.fromEntries((await Promise.all(Object.values(input))).map((v, i) => [keys[i], v]))
+  // `as any` here is added to make it compile when `noUncheckedIndexedAccess` is false
+  // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-assertion
+  return Object.fromEntries(
+    (await Promise.all(Object.values(input))).map((v, i) => [keys[i], v]),
+  ) as any
 }

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/string/url.util.ts

@@ -14,9 +14,9 @@ import { StringMap } from '../types'
  * Goal of this function is to produce exactly same output as URLSearchParams would.
  */
 export function _parseQueryString(search: string): StringMap {
-  const qs = {}
+  const qs: StringMap = {}
   search
-    .substr(search[0] === '?' ? 1 : 0)
+    .slice(search[0] === '?' ? 1 : 0)
     .split('&')
     .forEach(p => {
       const [k, v] = p.split('=')

package/src/types.ts

@@ -24,6 +24,10 @@ export interface PromiseMap {
  */
 export type AnyObject = Record<string, any>
 
+export type AnyEnum = NumberEnum
+export type NumberEnum = Record<string, number | string>
+export type StringEnum = Record<string, string>
+
 export interface CreatedUpdated {
   created: number
   updated: number