@naturalcycles/js-lib 14.105.1 → 14.107.1

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: any, 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,22 @@ 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/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,18 @@ 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/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.1",
+  "version": "14.107.1",
   "scripts": {
     "prepare": "husky install",
     "build-prod": "build-prod-esm-cjs",

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: any, data: ErrorData): void {
+  err.data = {
+    ...err.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/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 {}