@naturalcycles/js-lib 14.51.0 → 14.55.0

package/CHANGELOG.md

@@ -1,3 +1,31 @@
+# [14.55.0](https://github.com/NaturalCycles/js-lib/compare/v14.54.0...v14.55.0) (2021-10-25)
+
+
+### Features
+
+* _parseQueryString ([ed996de](https://github.com/NaturalCycles/js-lib/commit/ed996de1cfa817071daef9080be6be2c988cab2b))
+
+# [14.54.0](https://github.com/NaturalCycles/js-lib/compare/v14.53.0...v14.54.0) (2021-10-22)
+
+
+### Features
+
+* pTry (variation of pTuple), _try with non-optional RESULT type ([2c1dfdb](https://github.com/NaturalCycles/js-lib/commit/2c1dfdb9e1bad19de17280f181b7a75bcd0971bc))
+
+# [14.53.0](https://github.com/NaturalCycles/js-lib/compare/v14.52.0...v14.53.0) (2021-10-21)
+
+
+### Features
+
+* _ms to support "days" ([6329afe](https://github.com/NaturalCycles/js-lib/commit/6329afe2a319de68e0d4362d865db88e4b26e388))
+
+# [14.52.0](https://github.com/NaturalCycles/js-lib/compare/v14.51.0...v14.52.0) (2021-10-19)
+
+
+### Features
+
+* ObjectWithId, AnyObjectWithId, CreatedUpdated, CreatedUpdatedId ([d7ca213](https://github.com/NaturalCycles/js-lib/commit/d7ca2137d80ea08af55c83b5e7ce02e49e558f2c))
+
 # [14.51.0](https://github.com/NaturalCycles/js-lib/compare/v14.50.0...v14.51.0) (2021-10-18)
 
 

package/dist/error/try.d.ts

@@ -5,8 +5,20 @@
  *
  * Similar to pTuple, but for sync functions.
  *
+ * For convenience, second argument type is non-optional,
+ * so you can use it without `!`. But you SHOULD always check `if (err)` first!
+ *
  * @example
  *
  * const [err, v] = _try(() => someFunction())
+ * if (err) ...do something...
+ * v // go ahead and use v
+ */
+export declare function _try<ERR = unknown, RETURN = void>(fn: () => RETURN): [err: ERR | null, value: RETURN];
+/**
+ * Like _try, but for Promises.
+ *
+ * Also, intentionally types second return item as non-optional,
+ * but you should check for `err` presense first!
  */
-export declare function _try<ERR = unknown, RETURN = void>(fn: () => RETURN): [err: ERR | undefined, value: RETURN | undefined];
+export declare function pTry<ERR = unknown, RETURN = void>(promise: Promise<RETURN>): Promise<[err: ERR | null, value: RETURN]>;

package/dist/error/try.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._try = void 0;
+exports.pTry = exports._try = void 0;
 /**
  * Calls a function, returns a Tuple of [error, value].
  * Allows to write shorter code that avoids `try/catch`.
@@ -8,16 +8,36 @@ exports._try = void 0;
  *
  * Similar to pTuple, but for sync functions.
  *
+ * For convenience, second argument type is non-optional,
+ * so you can use it without `!`. But you SHOULD always check `if (err)` first!
+ *
  * @example
  *
  * const [err, v] = _try(() => someFunction())
+ * if (err) ...do something...
+ * v // go ahead and use v
  */
 function _try(fn) {
     try {
-        return [undefined, fn()];
+        return [null, fn()];
     }
     catch (err) {
         return [err, undefined];
     }
 }
 exports._try = _try;
+/**
+ * Like _try, but for Promises.
+ *
+ * Also, intentionally types second return item as non-optional,
+ * but you should check for `err` presense first!
+ */
+async function pTry(promise) {
+    try {
+        return [null, await promise];
+    }
+    catch (err) {
+        return [err, undefined];
+    }
+}
+exports.pTry = pTry;

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { _by, _chunk, _countBy, _difference, _dropRightWhile, _dropWhile, _findLast, _flatten, _flattenDeep, _groupBy, _intersection, _last, _mapToObject, _shuffle, _sortBy, _sum, _sumBy, _takeRightWhile, _takeWhile, _uniq, _uniqBy } from './array/array.util';
+import { _parseQueryString } from './string/url.util';
 import { _range } from './array/range';
 import { PromiseDecoratorCfg, PromiseDecoratorResp, _createPromiseDecorator } from './decorators/createPromiseDecorator';
 import { _debounce, _throttle } from './decorators/debounce';
@@ -16,7 +17,7 @@ import { Admin401ErrorData, Admin403ErrorData, ErrorData, ErrorObject, HttpError
 import { _anyToError, _anyToErrorObject, _errorObjectToAppError, _errorToErrorObject, _isErrorObject, _isHttpErrorObject, _isHttpErrorResponse } from './error/error.util';
 import { ErrorMode } from './error/errorMode';
 import { HttpError } from './error/http.error';
-import { _try } from './error/try';
+import { _try, pTry } from './error/try';
 import { TryCatchOptions, _TryCatch, _tryCatch } from './error/tryCatch';
 import { generateJsonSchemaFromData } from './json-schema/from-data/generateJsonSchemaFromData';
 import { JSON_SCHEMA_ORDER } from './json-schema/jsonSchema.cnst';
@@ -49,8 +50,8 @@ import { _capitalize, _lowerFirst, _nl2br, _removeWhitespace, _replaceAll, _spli
 import { JsonStringifyFunction, StringifyAnyOptions, _stringifyAny } from './string/stringifyAny';
 import { _ms, _since } from './time/time.util';
 import { Class, ConditionalExcept, ConditionalPick, Merge, Promisable, PromiseValue, ReadonlyDeep, Simplify } from './typeFest';
-import { AsyncMapper, AsyncPredicate, BaseDBEntity, Saved, Unsaved, BatchResult, InstanceId, IsoDate, IsoDateTime, KeyValueTuple, Mapper, ObjectMapper, ObjectPredicate, Predicate, PromiseMap, AnyObject, AnyFunction, Reviver, SavedDBEntity, StringMap, UnixTimestamp, ValueOf, ValuesOf, _noop, _objectKeys, _passNothingPredicate, _passthroughMapper, _passthroughPredicate, _passUndefinedMapper, _stringMapEntries, _stringMapValues } from './types';
+import { AsyncMapper, AsyncPredicate, BaseDBEntity, CreatedUpdated, CreatedUpdatedId, ObjectWithId, AnyObjectWithId, Saved, Unsaved, BatchResult, InstanceId, IsoDate, IsoDateTime, KeyValueTuple, Mapper, ObjectMapper, ObjectPredicate, Predicate, PromiseMap, AnyObject, AnyFunction, Reviver, SavedDBEntity, StringMap, UnixTimestamp, ValueOf, ValuesOf, _noop, _objectKeys, _passNothingPredicate, _passthroughMapper, _passthroughPredicate, _passUndefinedMapper, _stringMapEntries, _stringMapValues } from './types';
 import { _gb, _hb, _kb, _mb } from './unit/size.util';
 import { is } from './vendor/is';
-export type { MemoCache, PromiseDecoratorCfg, PromiseDecoratorResp, ErrorData, ErrorObject, HttpErrorData, HttpErrorResponse, Admin401ErrorData, Admin403ErrorData, StringMap, PromiseMap, AnyObject, AnyFunction, ValuesOf, ValueOf, KeyValueTuple, ObjectMapper, ObjectPredicate, InstanceId, IsoDate, IsoDateTime, Reviver, PMapOptions, Mapper, AsyncMapper, Predicate, AsyncPredicate, BatchResult, DeferredPromise, PRetryOptions, PTimeoutOptions, TryCatchOptions, StringifyAnyOptions, JsonStringifyFunction, Merge, ReadonlyDeep, Promisable, PromiseValue, Simplify, ConditionalPick, ConditionalExcept, Class, UnixTimestamp, BaseDBEntity, SavedDBEntity, Saved, Unsaved, JsonSchema, JsonSchemaAny, JsonSchemaOneOf, JsonSchemaAllOf, JsonSchemaAnyOf, JsonSchemaNot, JsonSchemaRef, JsonSchemaConst, JsonSchemaEnum, JsonSchemaString, JsonSchemaNumber, JsonSchemaBoolean, JsonSchemaNull, JsonSchemaRootObject, JsonSchemaObject, JsonSchemaArray, JsonSchemaTuple, JsonSchemaBuilder, };
-export { is, _Memo, _memoFn, _LogMethod, _getArgsSignature, _createPromiseDecorator, AppError, HttpError, AssertionError, _isErrorObject, _isHttpErrorObject, _isHttpErrorResponse, _assert, _assertEquals, _assertDeepEquals, _assertIsError, _assertIsString, _assertIsNumber, _assertTypeOf, _randomInt, _randomArrayItem, _createDeterministicRandom, _inRange, _stringMapValues, _stringMapEntries, _objectKeys, _capitalize, _upperFirst, _lowerFirst, _split, _removeWhitespace, _substringBefore, _substringBeforeLast, _substringAfter, _substringAfterLast, _substringBetweenLast, _replaceAll, _nl2br, _truncate, _truncateMiddle, _pick, _omit, _filterFalsyValues, _filterUndefinedValues, _filterNullishValues, _filterEmptyArrays, _filterEmptyValues, _filterObject, _undefinedIfEmpty, _isObject, _isPrimitive, _mapKeys, _mapValues, _mapObject, _objectNullValuesToUndefined, _deepEquals, _deepCopy, _isEmptyObject, _isEmpty, _merge, _deepTrim, _sortObjectDeep, _sortObject, _get, _set, _has, _unset, _mask, _invert, _invertMap, _by, _groupBy, _sortBy, _sortNumbers, _toFixed, _toPrecision, _round, _findLast, _takeWhile, _takeRightWhile, _dropWhile, _dropRightWhile, _countBy, _intersection, _difference, _shuffle, _mapToObject, _findKeyByValue, _anyToError, _anyToErrorObject, _errorToErrorObject, _errorObjectToAppError, _range, _uniq, _uniqBy, _flatten, _flattenDeep, _chunk, SimpleMovingAverage, _average, _averageWeighted, _percentile, _median, _debounce, _throttle, _Debounce, _Throttle, pMap, _passthroughMapper, _passUndefinedMapper, _passthroughPredicate, _passNothingPredicate, _noop, pBatch, ErrorMode, pFilter, pProps, pDelay, pDefer, pHang, pState, AggregatedError, pRetry, pTimeout, pTuple, _Retry, _Timeout, _tryCatch, _TryCatch, _try, _jsonParseIfPossible, _stringifyAny, _ms, _since, _hb, _gb, _mb, _kb, _snakeCase, _camelCase, _kebabCase, _sum, _sumBy, _clamp, _last, mergeJsonSchemaObjects, jsonSchema, JsonSchemaAnyBuilder, JSON_SCHEMA_ORDER, generateJsonSchemaFromData, };
+export type { MemoCache, PromiseDecoratorCfg, PromiseDecoratorResp, ErrorData, ErrorObject, HttpErrorData, HttpErrorResponse, Admin401ErrorData, Admin403ErrorData, StringMap, PromiseMap, AnyObject, AnyFunction, ValuesOf, ValueOf, KeyValueTuple, ObjectMapper, ObjectPredicate, InstanceId, IsoDate, IsoDateTime, Reviver, PMapOptions, Mapper, AsyncMapper, Predicate, AsyncPredicate, BatchResult, DeferredPromise, PRetryOptions, PTimeoutOptions, TryCatchOptions, StringifyAnyOptions, JsonStringifyFunction, Merge, ReadonlyDeep, Promisable, PromiseValue, Simplify, ConditionalPick, ConditionalExcept, Class, UnixTimestamp, BaseDBEntity, SavedDBEntity, Saved, Unsaved, CreatedUpdated, CreatedUpdatedId, ObjectWithId, AnyObjectWithId, JsonSchema, JsonSchemaAny, JsonSchemaOneOf, JsonSchemaAllOf, JsonSchemaAnyOf, JsonSchemaNot, JsonSchemaRef, JsonSchemaConst, JsonSchemaEnum, JsonSchemaString, JsonSchemaNumber, JsonSchemaBoolean, JsonSchemaNull, JsonSchemaRootObject, JsonSchemaObject, JsonSchemaArray, JsonSchemaTuple, JsonSchemaBuilder, };
+export { is, _Memo, _memoFn, _LogMethod, _getArgsSignature, _createPromiseDecorator, AppError, HttpError, AssertionError, _isErrorObject, _isHttpErrorObject, _isHttpErrorResponse, _assert, _assertEquals, _assertDeepEquals, _assertIsError, _assertIsString, _assertIsNumber, _assertTypeOf, _randomInt, _randomArrayItem, _createDeterministicRandom, _inRange, _stringMapValues, _stringMapEntries, _objectKeys, _capitalize, _upperFirst, _lowerFirst, _split, _removeWhitespace, _substringBefore, _substringBeforeLast, _substringAfter, _substringAfterLast, _substringBetweenLast, _replaceAll, _nl2br, _truncate, _truncateMiddle, _pick, _omit, _filterFalsyValues, _filterUndefinedValues, _filterNullishValues, _filterEmptyArrays, _filterEmptyValues, _filterObject, _undefinedIfEmpty, _isObject, _isPrimitive, _mapKeys, _mapValues, _mapObject, _objectNullValuesToUndefined, _deepEquals, _deepCopy, _isEmptyObject, _isEmpty, _merge, _deepTrim, _sortObjectDeep, _sortObject, _get, _set, _has, _unset, _mask, _invert, _invertMap, _by, _groupBy, _sortBy, _sortNumbers, _toFixed, _toPrecision, _round, _findLast, _takeWhile, _takeRightWhile, _dropWhile, _dropRightWhile, _countBy, _intersection, _difference, _shuffle, _mapToObject, _findKeyByValue, _anyToError, _anyToErrorObject, _errorToErrorObject, _errorObjectToAppError, _range, _uniq, _uniqBy, _flatten, _flattenDeep, _chunk, SimpleMovingAverage, _average, _averageWeighted, _percentile, _median, _debounce, _throttle, _Debounce, _Throttle, pMap, _passthroughMapper, _passUndefinedMapper, _passthroughPredicate, _passNothingPredicate, _noop, pBatch, ErrorMode, pFilter, pProps, pDelay, pDefer, pHang, pState, AggregatedError, pRetry, pTimeout, pTuple, _Retry, _Timeout, _tryCatch, _TryCatch, _try, pTry, _jsonParseIfPossible, _stringifyAny, _ms, _since, _hb, _gb, _mb, _kb, _snakeCase, _camelCase, _kebabCase, _sum, _sumBy, _clamp, _last, mergeJsonSchemaObjects, jsonSchema, JsonSchemaAnyBuilder, JSON_SCHEMA_ORDER, generateJsonSchemaFromData, _parseQueryString, };

package/dist/index.js

@@ -2,7 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports._isObject = exports._undefinedIfEmpty = exports._filterObject = exports._filterEmptyValues = exports._filterEmptyArrays = exports._filterNullishValues = exports._filterUndefinedValues = exports._filterFalsyValues = exports._omit = exports._pick = exports._truncateMiddle = exports._truncate = exports._nl2br = exports._replaceAll = exports._substringBetweenLast = exports._substringAfterLast = exports._substringAfter = exports._substringBeforeLast = exports._substringBefore = exports._removeWhitespace = exports._split = exports._lowerFirst = exports._upperFirst = exports._capitalize = exports._objectKeys = exports._stringMapEntries = exports._stringMapValues = exports._inRange = exports._createDeterministicRandom = exports._randomArrayItem = exports._randomInt = exports._assertTypeOf = exports._assertIsNumber = exports._assertIsString = exports._assertIsError = exports._assertDeepEquals = exports._assertEquals = exports._assert = exports._isHttpErrorResponse = exports._isHttpErrorObject = exports._isErrorObject = exports.AssertionError = exports.HttpError = exports.AppError = exports._createPromiseDecorator = exports._getArgsSignature = exports._LogMethod = exports._memoFn = exports._Memo = exports.is = void 0;
 exports._average = exports.SimpleMovingAverage = exports._chunk = exports._flattenDeep = exports._flatten = exports._uniqBy = exports._uniq = exports._range = exports._errorObjectToAppError = exports._errorToErrorObject = exports._anyToErrorObject = exports._anyToError = exports._findKeyByValue = exports._mapToObject = exports._shuffle = exports._difference = exports._intersection = exports._countBy = exports._dropRightWhile = exports._dropWhile = exports._takeRightWhile = exports._takeWhile = exports._findLast = exports._round = exports._toPrecision = exports._toFixed = exports._sortNumbers = exports._sortBy = exports._groupBy = exports._by = exports._invertMap = exports._invert = exports._mask = exports._unset = exports._has = exports._set = exports._get = exports._sortObject = exports._sortObjectDeep = exports._deepTrim = exports._merge = exports._isEmpty = exports._isEmptyObject = exports._deepCopy = exports._deepEquals = exports._objectNullValuesToUndefined = exports._mapObject = exports._mapValues = exports._mapKeys = exports._isPrimitive = void 0;
-exports.generateJsonSchemaFromData = exports.JSON_SCHEMA_ORDER = exports.JsonSchemaAnyBuilder = exports.jsonSchema = exports.mergeJsonSchemaObjects = exports._last = exports._clamp = exports._sumBy = exports._sum = exports._kebabCase = exports._camelCase = exports._snakeCase = exports._kb = exports._mb = exports._gb = exports._hb = exports._since = exports._ms = exports._stringifyAny = exports._jsonParseIfPossible = exports._try = exports._TryCatch = exports._tryCatch = exports._Timeout = exports._Retry = exports.pTuple = exports.pTimeout = exports.pRetry = exports.AggregatedError = exports.pState = exports.pHang = exports.pDefer = exports.pDelay = exports.pProps = exports.pFilter = exports.ErrorMode = exports.pBatch = exports._noop = exports._passNothingPredicate = exports._passthroughPredicate = exports._passUndefinedMapper = exports._passthroughMapper = exports.pMap = exports._Throttle = exports._Debounce = exports._throttle = exports._debounce = exports._median = exports._percentile = exports._averageWeighted = void 0;
+exports.JSON_SCHEMA_ORDER = exports.JsonSchemaAnyBuilder = exports.jsonSchema = exports.mergeJsonSchemaObjects = exports._last = exports._clamp = exports._sumBy = exports._sum = exports._kebabCase = exports._camelCase = exports._snakeCase = exports._kb = exports._mb = exports._gb = exports._hb = exports._since = exports._ms = exports._stringifyAny = exports._jsonParseIfPossible = exports.pTry = exports._try = exports._TryCatch = exports._tryCatch = exports._Timeout = exports._Retry = exports.pTuple = exports.pTimeout = exports.pRetry = exports.AggregatedError = exports.pState = exports.pHang = exports.pDefer = exports.pDelay = exports.pProps = exports.pFilter = exports.ErrorMode = exports.pBatch = exports._noop = exports._passNothingPredicate = exports._passthroughPredicate = exports._passUndefinedMapper = exports._passthroughMapper = exports.pMap = exports._Throttle = exports._Debounce = exports._throttle = exports._debounce = exports._median = exports._percentile = exports._averageWeighted = void 0;
+exports._parseQueryString = exports.generateJsonSchemaFromData = void 0;
 const array_util_1 = require("./array/array.util");
 Object.defineProperty(exports, "_by", { enumerable: true, get: function () { return array_util_1._by; } });
 Object.defineProperty(exports, "_chunk", { enumerable: true, get: function () { return array_util_1._chunk; } });
@@ -25,6 +26,8 @@ Object.defineProperty(exports, "_takeRightWhile", { enumerable: true, get: funct
 Object.defineProperty(exports, "_takeWhile", { enumerable: true, get: function () { return array_util_1._takeWhile; } });
 Object.defineProperty(exports, "_uniq", { enumerable: true, get: function () { return array_util_1._uniq; } });
 Object.defineProperty(exports, "_uniqBy", { enumerable: true, get: function () { return array_util_1._uniqBy; } });
+const url_util_1 = require("./string/url.util");
+Object.defineProperty(exports, "_parseQueryString", { enumerable: true, get: function () { return url_util_1._parseQueryString; } });
 const range_1 = require("./array/range");
 Object.defineProperty(exports, "_range", { enumerable: true, get: function () { return range_1._range; } });
 const createPromiseDecorator_1 = require("./decorators/createPromiseDecorator");
@@ -72,6 +75,7 @@ const http_error_1 = require("./error/http.error");
 Object.defineProperty(exports, "HttpError", { enumerable: true, get: function () { return http_error_1.HttpError; } });
 const try_1 = require("./error/try");
 Object.defineProperty(exports, "_try", { enumerable: true, get: function () { return try_1._try; } });
+Object.defineProperty(exports, "pTry", { enumerable: true, get: function () { return try_1.pTry; } });
 const tryCatch_1 = require("./error/tryCatch");
 Object.defineProperty(exports, "_TryCatch", { enumerable: true, get: function () { return tryCatch_1._TryCatch; } });
 Object.defineProperty(exports, "_tryCatch", { enumerable: true, get: function () { return tryCatch_1._tryCatch; } });

package/dist/json-schema/from-data/generateJsonSchemaFromData.d.ts

@@ -1,7 +1,7 @@
-import { JsonSchemaObject } from '../..';
+import { JsonSchemaObject, AnyObject } from '../..';
 /**
  * Each row must be an object (current limitation).
  *
  * `additionalProperties` is set to `true`, cause it's safer.
  */
-export declare function generateJsonSchemaFromData<T = unknown>(rows: any[]): JsonSchemaObject<T>;
+export declare function generateJsonSchemaFromData<T = unknown>(rows: AnyObject[]): JsonSchemaObject<T>;

package/dist/json-schema/jsonSchema.model.d.ts

@@ -1,4 +1,4 @@
-import { StringMap } from '../types';
+import { AnyObject, StringMap } from '../types';
 export declare type JsonSchema<T = unknown> = JsonSchemaAny<T> | JsonSchemaOneOf<T> | JsonSchemaAllOf<T> | JsonSchemaAnyOf<T> | JsonSchemaNot<T> | JsonSchemaRef<T> | JsonSchemaConst<T> | JsonSchemaEnum<T> | JsonSchemaString | JsonSchemaNumber | JsonSchemaBoolean | JsonSchemaNull | JsonSchemaObject<T> | JsonSchemaArray<T> | JsonSchemaTuple<T>;
 export interface JsonSchemaAny<T = unknown> {
     $schema?: string;
@@ -81,10 +81,10 @@ export interface JsonSchemaEnum<T = unknown> extends JsonSchemaAny<T> {
 export interface JsonSchemaRef<T = unknown> extends JsonSchemaAny<T> {
     $ref: string;
 }
-export interface JsonSchemaRootObject<T extends Record<any, any> = Record<any, unknown>> extends JsonSchemaObject<T> {
+export interface JsonSchemaRootObject<T extends AnyObject = AnyObject> extends JsonSchemaObject<T> {
     $id: string;
 }
-export interface JsonSchemaObject<T extends Record<any, any> = Record<any, unknown>> extends JsonSchemaAny<T> {
+export interface JsonSchemaObject<T extends AnyObject = AnyObject> extends JsonSchemaAny<T> {
     type: 'object';
     properties: {
         [k in keyof T]: JsonSchema;

package/dist/json-schema/jsonSchemaBuilder.d.ts

@@ -1,5 +1,5 @@
 /// <reference types="node" />
-import { BaseDBEntity, JsonSchemaAllOf, JsonSchemaArray, JsonSchemaOneOf, JsonSchemaTuple, SavedDBEntity } from '../index';
+import { BaseDBEntity, JsonSchemaAllOf, JsonSchemaArray, JsonSchemaOneOf, JsonSchemaTuple, SavedDBEntity, AnyObject } from '../index';
 import { JsonSchema, JsonSchemaAny, JsonSchemaBoolean, JsonSchemaConst, JsonSchemaEnum, JsonSchemaNull, JsonSchemaNumber, JsonSchemaObject, JsonSchemaRef, JsonSchemaString } from './jsonSchema.model';
 export interface JsonSchemaBuilder<T = unknown> {
     build(): JsonSchema<T>;
@@ -21,8 +21,8 @@ export declare const jsonSchema: {
     unixTimestamp(): JsonSchemaNumberBuilder;
     string(): JsonSchemaStringBuilder;
     dateString(): JsonSchemaStringBuilder;
-    object<T_4 extends Record<any, any>>(props: { [k in keyof T_4]: JsonSchemaAnyBuilder<T_4[k], JsonSchema<T_4[k]>>; }): JsonSchemaObjectBuilder<T_4>;
-    rootObject<T_5 extends Record<any, any>>(props: { [k_1 in keyof T_5]: JsonSchemaAnyBuilder<T_5[k_1], JsonSchema<T_5[k_1]>>; }): JsonSchemaObjectBuilder<T_5>;
+    object<T_4 extends AnyObject>(props: { [k in keyof T_4]: JsonSchemaAnyBuilder<T_4[k], JsonSchema<T_4[k]>>; }): JsonSchemaObjectBuilder<T_4>;
+    rootObject<T_5 extends AnyObject>(props: { [k_1 in keyof T_5]: JsonSchemaAnyBuilder<T_5[k_1], JsonSchema<T_5[k_1]>>; }): JsonSchemaObjectBuilder<T_5>;
     array<ITEM = unknown>(itemSchema: JsonSchemaAnyBuilder<ITEM, JsonSchema<ITEM>>): JsonSchemaArrayBuilder<ITEM>;
     tuple<T_6 extends any[] = unknown[]>(items: JsonSchemaAnyBuilder[]): JsonSchemaTupleBuilder<T_6>;
     oneOf<T_7 = unknown>(items: JsonSchemaAnyBuilder[]): JsonSchemaAnyBuilder<T_7, JsonSchemaOneOf<T_7>>;
@@ -100,7 +100,7 @@ export declare class JsonSchemaStringBuilder extends JsonSchemaAnyBuilder<string
     toUpperCase: (toUpperCase?: boolean) => this;
     private transformModify;
 }
-export declare class JsonSchemaObjectBuilder<T extends Record<any, any>> extends JsonSchemaAnyBuilder<T, JsonSchemaObject<T>> {
+export declare class JsonSchemaObjectBuilder<T extends AnyObject> extends JsonSchemaAnyBuilder<T, JsonSchemaObject<T>> {
     constructor();
     addProperties(props: {
         [k in keyof T]: JsonSchemaBuilder<T[k]>;
@@ -115,7 +115,7 @@ export declare class JsonSchemaObjectBuilder<T extends Record<any, any>> extends
     additionalProps(additionalProperties: boolean): this;
     baseDBEntity(): JsonSchemaObjectBuilder<T & BaseDBEntity>;
     savedDBEntity(): JsonSchemaObjectBuilder<T & SavedDBEntity>;
-    extend<T2 extends Record<any, any>>(s2: JsonSchemaObjectBuilder<T2>): JsonSchemaObjectBuilder<T & T2>;
+    extend<T2 extends AnyObject>(s2: JsonSchemaObjectBuilder<T2>): JsonSchemaObjectBuilder<T & T2>;
 }
 export declare class JsonSchemaArrayBuilder<ITEM> extends JsonSchemaAnyBuilder<ITEM[], JsonSchemaArray<ITEM>> {
     constructor(itemsSchema: JsonSchemaBuilder<ITEM>);

package/dist/object/object.util.d.ts

@@ -1,15 +1,15 @@
 import { PropertyPath } from '../lodash.types';
-import { ObjectMapper, ObjectPredicate, StringMap, ValueOf } from '../types';
+import { AnyObject, ObjectMapper, ObjectPredicate, StringMap, ValueOf } from '../types';
 /**
  * Returns clone of `obj` with only `props` preserved.
  * Opposite of Omit.
  */
-export declare function _pick<T extends Record<string, any>, K extends keyof T>(obj: T, props: readonly K[], mutate?: boolean): T;
+export declare function _pick<T extends AnyObject, K extends keyof T>(obj: T, props: readonly K[], mutate?: boolean): T;
 /**
  * Returns clone of `obj` with `props` omitted.
  * Opposite of Pick.
  */
-export declare function _omit<T extends Record<string, any>, K extends keyof T>(obj: T, props: readonly K[], mutate?: boolean): T;
+export declare function _omit<T extends AnyObject, K extends keyof T>(obj: T, props: readonly K[], mutate?: boolean): T;
 /**
  * Returns object with filtered keys from `props` array.
  * E.g:
@@ -18,26 +18,26 @@ export declare function _omit<T extends Record<string, any>, K extends keyof T>(
  *  'account.updated',
  * ])
  */
-export declare function _mask<T extends Record<string, any>>(obj: T, props: string[], mutate?: boolean): T;
+export declare function _mask<T extends AnyObject>(obj: T, props: string[], mutate?: boolean): T;
 /**
  * Removes "falsy" values from the object.
  */
-export declare function _filterFalsyValues<T extends Record<string, any>>(obj: T, mutate?: boolean): T;
+export declare function _filterFalsyValues<T extends AnyObject>(obj: T, mutate?: boolean): T;
 /**
  * Removes values from the object that are `null` or `undefined`.
  */
-export declare function _filterNullishValues<T extends Record<string, any>>(obj: T, mutate?: boolean): T;
+export declare function _filterNullishValues<T extends AnyObject>(obj: T, mutate?: boolean): T;
 /**
  * Removes values from the object that are `undefined`.
  * Only `undefined` values are removed. `null` values are kept!
  */
-export declare function _filterUndefinedValues<T extends Record<string, any>>(obj: T, mutate?: boolean): T;
-export declare function _filterEmptyArrays<T extends Record<string, any>>(obj: T, mutate?: boolean): T;
+export declare function _filterUndefinedValues<T extends AnyObject>(obj: T, mutate?: boolean): T;
+export declare function _filterEmptyArrays<T extends AnyObject>(obj: T, mutate?: boolean): T;
 /**
  * Returns clone of `obj` without properties that does not pass `predicate`.
  * Allows filtering by both key and value.
  */
-export declare function _filterObject<T extends Record<string, any>>(obj: T, predicate: ObjectPredicate<T>, mutate?: boolean): T;
+export declare function _filterObject<T extends AnyObject>(obj: T, predicate: ObjectPredicate<T>, mutate?: boolean): T;
 /**
  * var users = {
  *  'fred':    { 'user': 'fred',    'age': 40 },
@@ -51,14 +51,14 @@ export declare function _filterObject<T extends Record<string, any>>(obj: T, pre
  * _.mapValues(users, 'age')
  * // => { 'fred': 40, 'pebbles': 1 } (iteration order is not guaranteed)
  */
-export declare function _mapValues<T extends Record<string, any>, OUT = T>(obj: T, mapper: ObjectMapper<T, any>, mutate?: boolean): OUT;
+export declare function _mapValues<T extends AnyObject, OUT = T>(obj: T, mapper: ObjectMapper<T, any>, mutate?: boolean): OUT;
 /**
  * _.mapKeys({ 'a': 1, 'b': 2 }, (key, value) => key + value)
  * // => { 'a1': 1, 'b2': 2 }
  *
  * Does not support `mutate` flag.
  */
-export declare function _mapKeys<T extends Record<string, any>>(obj: T, mapper: ObjectMapper<T, string>): StringMap<T[keyof T]>;
+export declare function _mapKeys<T extends AnyObject>(obj: T, mapper: ObjectMapper<T, string>): StringMap<T[keyof T]>;
 /**
  * Maps object through predicate - a function that receives (k, v, obj)
  * k - key
@@ -75,11 +75,11 @@ export declare function _mapKeys<T extends Record<string, any>>(obj: T, mapper:
  *
  * Non-string keys are passed via String(...)
  */
-export declare function _mapObject<IN extends Record<string, any>, OUT>(obj: IN, mapper: ObjectMapper<IN, [key: string, value: any]>): {
+export declare function _mapObject<IN extends AnyObject, OUT>(obj: IN, mapper: ObjectMapper<IN, [key: string, value: any]>): {
     [P in keyof IN]: OUT;
 };
-export declare function _findKeyByValue<T extends Record<any, any>>(obj: T, v: ValueOf<T>): keyof T | undefined;
-export declare function _objectNullValuesToUndefined<T extends Record<string, any>>(obj: T, mutate?: boolean): T;
+export declare function _findKeyByValue<T extends AnyObject>(obj: T, v: ValueOf<T>): keyof T | undefined;
+export declare function _objectNullValuesToUndefined<T extends AnyObject>(obj: T, mutate?: boolean): T;
 /**
  * Deep copy object (by json parse/stringify, since it has unbeatable performance+simplicity combo).
  */
@@ -87,7 +87,7 @@ export declare function _deepCopy<T>(o: T): T;
 /**
  * Returns true if item is Object, not null and not Array.
  */
-export declare function _isObject(item: any): item is Record<string, any>;
+export declare function _isObject(item: any): item is AnyObject;
 export declare function _isPrimitive(v: any): v is null | undefined | number | boolean | string;
 export declare function _isEmptyObject(obj: any): boolean;
 /**
@@ -109,7 +109,7 @@ export declare function _undefinedIfEmpty<T>(obj: T | undefined): T | undefined;
 /**
  * Filters the object by removing all key-value pairs where Value is Empty (according to _isEmpty() specification).
  */
-export declare function _filterEmptyValues<T extends Record<string, any>>(obj: T, mutate?: boolean): T;
+export declare function _filterEmptyValues<T extends AnyObject>(obj: T, mutate?: boolean): T;
 /**
  * Recursively merges own and inherited enumerable properties of source
  * objects into the destination object, skipping source properties that resolve
@@ -139,15 +139,15 @@ export declare function _filterEmptyValues<T extends Record<string, any>>(obj: T
  *
  * Based on: https://gist.github.com/Salakar/1d7137de9cb8b704e48a
  */
-export declare function _merge<T extends Record<string, any>>(target: T, ...sources: any[]): T;
+export declare function _merge<T extends AnyObject>(target: T, ...sources: any[]): T;
 /**
  * Trims all object VALUES deeply.
  * Doesn't touch object KEYS.
  * Mutates.
  */
-export declare function _deepTrim<T extends Record<string, any> | string>(o: T): T;
-export declare function _unset<T extends Record<string, any>>(obj: T, prop: string): void;
-export declare function _invert<T extends Record<any, any>>(o: T): {
+export declare function _deepTrim<T extends AnyObject | string>(o: T): T;
+export declare function _unset<T extends AnyObject>(obj: T, prop: string): void;
+export declare function _invert<T extends AnyObject>(o: T): {
     [k in ValueOf<T>]: keyof T | undefined;
 };
 export declare function _invertMap<K, V>(m: ReadonlyMap<K, V>): Map<V, K>;
@@ -160,7 +160,7 @@ export declare function _invertMap<K, V>(m: ReadonlyMap<K, V>): Map<V, K>;
  * @param def The value returned if the resolved value is undefined.
  * @return Returns the resolved value.
  */
-export declare function _get<T extends Record<string, any>>(obj?: T, path?: string, def?: any): any;
+export declare function _get<T extends AnyObject>(obj?: T, path?: string, def?: any): any;
 /**
  * Sets the value at path of object. If a portion of path doesn’t exist it’s created. Arrays are created for
  * missing index properties while objects are created for all other missing properties. Use _.setWith to
@@ -173,7 +173,7 @@ export declare function _get<T extends Record<string, any>>(obj?: T, path?: stri
  *
  * Based on: https://stackoverflow.com/a/54733755/4919972
  */
-export declare function _set<IN extends Record<string, any>, OUT = IN>(obj: IN, path: PropertyPath, value?: any): OUT;
+export declare function _set<IN extends AnyObject, OUT = IN>(obj: IN, path: PropertyPath, value?: any): OUT;
 /**
  * Checks if `path` is a direct property of `object` (not null, not undefined).
  *
@@ -198,4 +198,4 @@ export declare function _set<IN extends Record<string, any>, OUT = IN>(obj: IN,
  * _.has(other, 'a');
  * // => false
  */
-export declare function _has<T extends Record<string, any>>(obj: T, path?: string): boolean;
+export declare function _has<T extends AnyObject>(obj: T, path?: string): boolean;

package/dist/object/sortObject.d.ts

@@ -1,6 +1,7 @@
+import { AnyObject } from '../index';
 /**
  * Returns new object with keys sorder in the given order.
  * All keys that are not listed in `keyOrder` go last.
  * Does not mutate original object.
  */
-export declare function _sortObject<T extends Record<any, any>>(obj: T, keyOrder: (keyof T)[]): T;
+export declare function _sortObject<T extends AnyObject>(obj: T, keyOrder: (keyof T)[]): T;

package/dist/promise/pTuple.d.ts

@@ -4,4 +4,4 @@
  *
  * source: https://github.com/scopsy/await-to-js/blob/master/src/await-to-js.ts
  */
-export declare function pTuple<T, U = Error>(promise: Promise<T>): Promise<[U, undefined] | [null, T]>;
+export declare function pTuple<RETURN, ERR = Error>(promise: Promise<RETURN>): Promise<[ERR, undefined] | [null, RETURN]>;

package/dist/promise/pTuple.js

@@ -8,10 +8,6 @@ exports.pTuple = void 0;
  * source: https://github.com/scopsy/await-to-js/blob/master/src/await-to-js.ts
  */
 async function pTuple(promise) {
-    return promise
-        .then((data) => [null, data])
-        .catch((err) => {
-        return [err, undefined];
-    });
+    return promise.then(data => [null, data]).catch(err => [err, undefined]);
 }
 exports.pTuple = pTuple;

package/dist/string/url.util.d.ts

@@ -0,0 +1,15 @@
+import { StringMap } from '../types';
+/**
+ * Parses `location.search` string (e.g `?a=1&b=2`) into a StringMap, e.g:
+ * `{ a: '1', b: '2' }`
+ *
+ * Pass `location.search` to it in the Frontend, or any other string on the Backend (where `location.search` is not available).
+ *
+ * Works both with and without leading `?` character.
+ *
+ * Yes, there's `URLSearchParams` existing in the Frontend (not in Node yet), but it's API is not
+ * as convenient. And the implementation here is super-small.
+ *
+ * Goal of this function is to produce exactly same output as URLSearchParams would.
+ */
+export declare function _parseQueryString(search: string): StringMap;

package/dist/string/url.util.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._parseQueryString = void 0;
+/**
+ * Parses `location.search` string (e.g `?a=1&b=2`) into a StringMap, e.g:
+ * `{ a: '1', b: '2' }`
+ *
+ * Pass `location.search` to it in the Frontend, or any other string on the Backend (where `location.search` is not available).
+ *
+ * Works both with and without leading `?` character.
+ *
+ * Yes, there's `URLSearchParams` existing in the Frontend (not in Node yet), but it's API is not
+ * as convenient. And the implementation here is super-small.
+ *
+ * Goal of this function is to produce exactly same output as URLSearchParams would.
+ */
+function _parseQueryString(search) {
+    const qs = {};
+    search
+        .substr(search[0] === '?' ? 1 : 0)
+        .split('&')
+        .forEach(p => {
+        const [k, v] = p.split('=');
+        if (!k)
+            return;
+        qs[decodeURIComponent(k)] = decodeURIComponent(v || '');
+    });
+    return qs;
+}
+exports._parseQueryString = _parseQueryString;

package/dist/time/time.util.js

@@ -37,7 +37,11 @@ function _ms(millis) {
     if (hrs < 24) {
         return `${hrs}h${min}m`;
     }
-    // >= 24h
-    return `${Math.round(hrs + min / 60)}h`;
+    if (hrs < 48) {
+        return `${Math.round(hrs + min / 60)}h`;
+    }
+    // >= 48 hours
+    const days = Math.floor(hrs / 24);
+    return `${days} days`;
 }
 exports._ms = _ms;

package/dist/types.d.ts

@@ -20,6 +20,18 @@ 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 interface CreatedUpdated {
+    created: number;
+    updated: number;
+}
+export interface CreatedUpdatedId extends CreatedUpdated {
+    id: string;
+}
+export interface ObjectWithId {
+    id: string;
+}
+export interface AnyObjectWithId extends AnyObject, ObjectWithId {
+}
 /**
  * Convenience type shorthand.
  * Because `Function` type is discouraged by eslint.
@@ -143,4 +155,4 @@ export declare function _stringMapEntries<T>(m: StringMap<T>): [k: string, v: T]
  *
  * @experimental
  */
-export declare function _objectKeys<T extends Record<string, any>>(obj: T): (keyof T)[];
+export declare function _objectKeys<T extends AnyObject>(obj: T): (keyof T)[];

package/dist-esm/error/try.js

@@ -5,13 +5,32 @@
  *
  * Similar to pTuple, but for sync functions.
  *
+ * For convenience, second argument type is non-optional,
+ * so you can use it without `!`. But you SHOULD always check `if (err)` first!
+ *
  * @example
  *
  * const [err, v] = _try(() => someFunction())
+ * if (err) ...do something...
+ * v // go ahead and use v
  */
 export function _try(fn) {
     try {
-        return [undefined, fn()];
+        return [null, fn()];
+    }
+    catch (err) {
+        return [err, undefined];
+    }
+}
+/**
+ * Like _try, but for Promises.
+ *
+ * Also, intentionally types second return item as non-optional,
+ * but you should check for `err` presense first!
+ */
+export async function pTry(promise) {
+    try {
+        return [null, await promise];
     }
     catch (err) {
         return [err, undefined];

package/dist-esm/index.js

@@ -1,4 +1,5 @@
 import { _by, _chunk, _countBy, _difference, _dropRightWhile, _dropWhile, _findLast, _flatten, _flattenDeep, _groupBy, _intersection, _last, _mapToObject, _shuffle, _sortBy, _sum, _sumBy, _takeRightWhile, _takeWhile, _uniq, _uniqBy, } from './array/array.util';
+import { _parseQueryString } from './string/url.util';
 import { _range } from './array/range';
 import { _createPromiseDecorator, } from './decorators/createPromiseDecorator';
 import { _debounce, _throttle } from './decorators/debounce';
@@ -14,7 +15,7 @@ import { AssertionError, _assert, _assertDeepEquals, _assertEquals, _assertIsErr
 import { _anyToError, _anyToErrorObject, _errorObjectToAppError, _errorToErrorObject, _isErrorObject, _isHttpErrorObject, _isHttpErrorResponse, } from './error/error.util';
 import { ErrorMode } from './error/errorMode';
 import { HttpError } from './error/http.error';
-import { _try } from './error/try';
+import { _try, pTry } from './error/try';
 import { _TryCatch, _tryCatch } from './error/tryCatch';
 import { generateJsonSchemaFromData } from './json-schema/from-data/generateJsonSchemaFromData';
 import { JSON_SCHEMA_ORDER } from './json-schema/jsonSchema.cnst';
@@ -48,4 +49,4 @@ import { _ms, _since } from './time/time.util';
 import { _noop, _objectKeys, _passNothingPredicate, _passthroughMapper, _passthroughPredicate, _passUndefinedMapper, _stringMapEntries, _stringMapValues, } from './types';
 import { _gb, _hb, _kb, _mb } from './unit/size.util';
 import { is } from './vendor/is';
-export { is, _Memo, _memoFn, _LogMethod, _getArgsSignature, _createPromiseDecorator, AppError, HttpError, AssertionError, _isErrorObject, _isHttpErrorObject, _isHttpErrorResponse, _assert, _assertEquals, _assertDeepEquals, _assertIsError, _assertIsString, _assertIsNumber, _assertTypeOf, _randomInt, _randomArrayItem, _createDeterministicRandom, _inRange, _stringMapValues, _stringMapEntries, _objectKeys, _capitalize, _upperFirst, _lowerFirst, _split, _removeWhitespace, _substringBefore, _substringBeforeLast, _substringAfter, _substringAfterLast, _substringBetweenLast, _replaceAll, _nl2br, _truncate, _truncateMiddle, _pick, _omit, _filterFalsyValues, _filterUndefinedValues, _filterNullishValues, _filterEmptyArrays, _filterEmptyValues, _filterObject, _undefinedIfEmpty, _isObject, _isPrimitive, _mapKeys, _mapValues, _mapObject, _objectNullValuesToUndefined, _deepEquals, _deepCopy, _isEmptyObject, _isEmpty, _merge, _deepTrim, _sortObjectDeep, _sortObject, _get, _set, _has, _unset, _mask, _invert, _invertMap, _by, _groupBy, _sortBy, _sortNumbers, _toFixed, _toPrecision, _round, _findLast, _takeWhile, _takeRightWhile, _dropWhile, _dropRightWhile, _countBy, _intersection, _difference, _shuffle, _mapToObject, _findKeyByValue, _anyToError, _anyToErrorObject, _errorToErrorObject, _errorObjectToAppError, _range, _uniq, _uniqBy, _flatten, _flattenDeep, _chunk, SimpleMovingAverage, _average, _averageWeighted, _percentile, _median, _debounce, _throttle, _Debounce, _Throttle, pMap, _passthroughMapper, _passUndefinedMapper, _passthroughPredicate, _passNothingPredicate, _noop, pBatch, ErrorMode, pFilter, pProps, pDelay, pDefer, pHang, pState, AggregatedError, pRetry, pTimeout, pTuple, _Retry, _Timeout, _tryCatch, _TryCatch, _try, _jsonParseIfPossible, _stringifyAny, _ms, _since, _hb, _gb, _mb, _kb, _snakeCase, _camelCase, _kebabCase, _sum, _sumBy, _clamp, _last, mergeJsonSchemaObjects, jsonSchema, JsonSchemaAnyBuilder, JSON_SCHEMA_ORDER, generateJsonSchemaFromData, };
+export { is, _Memo, _memoFn, _LogMethod, _getArgsSignature, _createPromiseDecorator, AppError, HttpError, AssertionError, _isErrorObject, _isHttpErrorObject, _isHttpErrorResponse, _assert, _assertEquals, _assertDeepEquals, _assertIsError, _assertIsString, _assertIsNumber, _assertTypeOf, _randomInt, _randomArrayItem, _createDeterministicRandom, _inRange, _stringMapValues, _stringMapEntries, _objectKeys, _capitalize, _upperFirst, _lowerFirst, _split, _removeWhitespace, _substringBefore, _substringBeforeLast, _substringAfter, _substringAfterLast, _substringBetweenLast, _replaceAll, _nl2br, _truncate, _truncateMiddle, _pick, _omit, _filterFalsyValues, _filterUndefinedValues, _filterNullishValues, _filterEmptyArrays, _filterEmptyValues, _filterObject, _undefinedIfEmpty, _isObject, _isPrimitive, _mapKeys, _mapValues, _mapObject, _objectNullValuesToUndefined, _deepEquals, _deepCopy, _isEmptyObject, _isEmpty, _merge, _deepTrim, _sortObjectDeep, _sortObject, _get, _set, _has, _unset, _mask, _invert, _invertMap, _by, _groupBy, _sortBy, _sortNumbers, _toFixed, _toPrecision, _round, _findLast, _takeWhile, _takeRightWhile, _dropWhile, _dropRightWhile, _countBy, _intersection, _difference, _shuffle, _mapToObject, _findKeyByValue, _anyToError, _anyToErrorObject, _errorToErrorObject, _errorObjectToAppError, _range, _uniq, _uniqBy, _flatten, _flattenDeep, _chunk, SimpleMovingAverage, _average, _averageWeighted, _percentile, _median, _debounce, _throttle, _Debounce, _Throttle, pMap, _passthroughMapper, _passUndefinedMapper, _passthroughPredicate, _passNothingPredicate, _noop, pBatch, ErrorMode, pFilter, pProps, pDelay, pDefer, pHang, pState, AggregatedError, pRetry, pTimeout, pTuple, _Retry, _Timeout, _tryCatch, _TryCatch, _try, pTry, _jsonParseIfPossible, _stringifyAny, _ms, _since, _hb, _gb, _mb, _kb, _snakeCase, _camelCase, _kebabCase, _sum, _sumBy, _clamp, _last, mergeJsonSchemaObjects, jsonSchema, JsonSchemaAnyBuilder, JSON_SCHEMA_ORDER, generateJsonSchemaFromData, _parseQueryString, };

package/dist-esm/promise/pTuple.js

@@ -5,9 +5,5 @@
  * source: https://github.com/scopsy/await-to-js/blob/master/src/await-to-js.ts
  */
 export async function pTuple(promise) {
-    return promise
-        .then((data) => [null, data])
-        .catch((err) => {
-        return [err, undefined];
-    });
+    return promise.then(data => [null, data]).catch(err => [err, undefined]);
 }

package/dist-esm/string/url.util.js

@@ -0,0 +1,26 @@
+/**
+ * Parses `location.search` string (e.g `?a=1&b=2`) into a StringMap, e.g:
+ * `{ a: '1', b: '2' }`
+ *
+ * Pass `location.search` to it in the Frontend, or any other string on the Backend (where `location.search` is not available).
+ *
+ * Works both with and without leading `?` character.
+ *
+ * Yes, there's `URLSearchParams` existing in the Frontend (not in Node yet), but it's API is not
+ * as convenient. And the implementation here is super-small.
+ *
+ * Goal of this function is to produce exactly same output as URLSearchParams would.
+ */
+export function _parseQueryString(search) {
+    const qs = {};
+    search
+        .substr(search[0] === '?' ? 1 : 0)
+        .split('&')
+        .forEach(p => {
+        const [k, v] = p.split('=');
+        if (!k)
+            return;
+        qs[decodeURIComponent(k)] = decodeURIComponent(v || '');
+    });
+    return qs;
+}

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

@@ -33,6 +33,10 @@ export function _ms(millis) {
     if (hrs < 24) {
         return `${hrs}h${min}m`;
     }
-    // >= 24h
-    return `${Math.round(hrs + min / 60)}h`;
+    if (hrs < 48) {
+        return `${Math.round(hrs + min / 60)}h`;
+    }
+    // >= 48 hours
+    const days = Math.floor(hrs / 24);
+    return `${days} days`;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/js-lib",
-  "version": "14.51.0",
+  "version": "14.55.0",
   "scripts": {
     "prepare": "husky install",
     "build-prod": "build-prod-esm-cjs",
@@ -11,11 +11,10 @@
     "tslib": "^2.0.0"
   },
   "devDependencies": {
+    "@naturalcycles/bench-lib": "^1.5.0",
     "@naturalcycles/dev-lib": "^12.0.0",
     "@naturalcycles/nodejs-lib": "^12.33.4",
-    "@types/benchmark": "^2.1.0",
     "@types/node": "^16.0.0",
-    "benchmark": "^2.1.4",
     "jest": "^27.0.1",
     "patch-package": "^6.2.1",
     "prettier": "^2.1.2",

package/src/error/try.ts

@@ -5,16 +5,37 @@
  *
  * Similar to pTuple, but for sync functions.
  *
+ * For convenience, second argument type is non-optional,
+ * so you can use it without `!`. But you SHOULD always check `if (err)` first!
+ *
  * @example
  *
  * const [err, v] = _try(() => someFunction())
+ * if (err) ...do something...
+ * v // go ahead and use v
  */
 export function _try<ERR = unknown, RETURN = void>(
   fn: () => RETURN,
-): [err: ERR | undefined, value: RETURN | undefined] {
+): [err: ERR | null, value: RETURN] {
+  try {
+    return [null, fn()]
+  } catch (err) {
+    return [err as ERR, undefined as any]
+  }
+}
+
+/**
+ * Like _try, but for Promises.
+ *
+ * Also, intentionally types second return item as non-optional,
+ * but you should check for `err` presense first!
+ */
+export async function pTry<ERR = unknown, RETURN = void>(
+  promise: Promise<RETURN>,
+): Promise<[err: ERR | null, value: RETURN]> {
   try {
-    return [undefined, fn()]
+    return [null, await promise]
   } catch (err) {
-    return [err as ERR, undefined]
+    return [err as ERR, undefined as any]
   }
 }

package/src/index.ts

@@ -21,6 +21,7 @@ import {
   _uniq,
   _uniqBy,
 } from './array/array.util'
+import { _parseQueryString } from './string/url.util'
 import { _range } from './array/range'
 import {
   PromiseDecoratorCfg,
@@ -66,7 +67,7 @@ import {
 } from './error/error.util'
 import { ErrorMode } from './error/errorMode'
 import { HttpError } from './error/http.error'
-import { _try } from './error/try'
+import { _try, pTry } from './error/try'
 import { TryCatchOptions, _TryCatch, _tryCatch } from './error/tryCatch'
 import { generateJsonSchemaFromData } from './json-schema/from-data/generateJsonSchemaFromData'
 import { JSON_SCHEMA_ORDER } from './json-schema/jsonSchema.cnst'
@@ -187,6 +188,10 @@ import {
   AsyncMapper,
   AsyncPredicate,
   BaseDBEntity,
+  CreatedUpdated,
+  CreatedUpdatedId,
+  ObjectWithId,
+  AnyObjectWithId,
   Saved,
   Unsaved,
   BatchResult,
@@ -267,6 +272,10 @@ export type {
   SavedDBEntity,
   Saved,
   Unsaved,
+  CreatedUpdated,
+  CreatedUpdatedId,
+  ObjectWithId,
+  AnyObjectWithId,
   JsonSchema,
   JsonSchemaAny,
   JsonSchemaOneOf,
@@ -418,6 +427,7 @@ export {
   _tryCatch,
   _TryCatch,
   _try,
+  pTry,
   _jsonParseIfPossible,
   _stringifyAny,
   _ms,
@@ -438,4 +448,5 @@ export {
   JsonSchemaAnyBuilder,
   JSON_SCHEMA_ORDER,
   generateJsonSchemaFromData,
+  _parseQueryString,
 }

package/src/json-schema/from-data/generateJsonSchemaFromData.ts

@@ -10,6 +10,7 @@ import {
   StringMap,
   _stringMapEntries,
   _uniq,
+  AnyObject,
 } from '../..'
 
 type PrimitiveType = 'undefined' | 'null' | 'boolean' | 'string' | 'number'
@@ -20,11 +21,11 @@ type Type = PrimitiveType | 'array' | 'object'
  *
  * `additionalProperties` is set to `true`, cause it's safer.
  */
-export function generateJsonSchemaFromData<T = unknown>(rows: any[]): JsonSchemaObject<T> {
+export function generateJsonSchemaFromData<T = unknown>(rows: AnyObject[]): JsonSchemaObject<T> {
   return objectToJsonSchema(rows as any) as JsonSchemaObject<T>
 }
 
-function objectToJsonSchema(rows: Record<string, any>[]): JsonSchemaObject {
+function objectToJsonSchema(rows: AnyObject[]): JsonSchemaObject {
   const typesByKey: StringMap<Set<Type>> = {}
 
   rows.forEach(r => {

package/src/json-schema/jsonSchema.model.ts

@@ -1,4 +1,4 @@
-import { StringMap } from '../types'
+import { AnyObject, StringMap } from '../types'
 
 // eslint-disable-next-line unused-imports/no-unused-vars
 export type JsonSchema<T = unknown> =
@@ -124,13 +124,11 @@ export interface JsonSchemaRef<T = unknown> extends JsonSchemaAny<T> {
   $ref: string
 }
 
-export interface JsonSchemaRootObject<T extends Record<any, any> = Record<any, unknown>>
-  extends JsonSchemaObject<T> {
+export interface JsonSchemaRootObject<T extends AnyObject = AnyObject> extends JsonSchemaObject<T> {
   $id: string
 }
 
-export interface JsonSchemaObject<T extends Record<any, any> = Record<any, unknown>>
-  extends JsonSchemaAny<T> {
+export interface JsonSchemaObject<T extends AnyObject = AnyObject> extends JsonSchemaAny<T> {
   type: 'object'
   // let's be strict and require all these
   properties: {

package/src/json-schema/jsonSchemaBuilder.ts

@@ -9,6 +9,7 @@ import {
   SavedDBEntity,
   _deepCopy,
   _sortObject,
+  AnyObject,
 } from '../index'
 import { JSON_SCHEMA_ORDER } from './jsonSchema.cnst'
 import {
@@ -86,12 +87,12 @@ export const jsonSchema = {
   },
   // email: () => new JsonSchemaStringBuilder().email(),
   // complex types
-  object<T extends Record<any, any>>(props: {
+  object<T extends AnyObject>(props: {
     [k in keyof T]: JsonSchemaAnyBuilder<T[k]>
   }) {
     return new JsonSchemaObjectBuilder<T>().addProperties(props)
   },
-  rootObject<T extends Record<any, any>>(props: {
+  rootObject<T extends AnyObject>(props: {
     [k in keyof T]: JsonSchemaAnyBuilder<T[k]>
   }) {
     return new JsonSchemaObjectBuilder<T>().addProperties(props).$schemaDraft7()
@@ -309,7 +310,7 @@ export class JsonSchemaStringBuilder extends JsonSchemaAnyBuilder<string, JsonSc
   // contentEncoding?: string
 }
 
-export class JsonSchemaObjectBuilder<T extends Record<any, any>> extends JsonSchemaAnyBuilder<
+export class JsonSchemaObjectBuilder<T extends AnyObject> extends JsonSchemaAnyBuilder<
   T,
   JsonSchemaObject<T>
 > {
@@ -378,9 +379,7 @@ export class JsonSchemaObjectBuilder<T extends Record<any, any>> extends JsonSch
     return this.baseDBEntity().addRequired(['id', 'created', 'updated']) as any
   }
 
-  extend<T2 extends Record<any, any>>(
-    s2: JsonSchemaObjectBuilder<T2>,
-  ): JsonSchemaObjectBuilder<T & T2> {
+  extend<T2 extends AnyObject>(s2: JsonSchemaObjectBuilder<T2>): JsonSchemaObjectBuilder<T & T2> {
     const builder = new JsonSchemaObjectBuilder<T & T2>()
     Object.assign(builder.schema, _deepCopy(this.schema))
     mergeJsonSchemaObjects(builder.schema, s2.schema)

package/src/object/object.util.ts

@@ -1,11 +1,11 @@
 import { PropertyPath } from '../lodash.types'
-import { ObjectMapper, ObjectPredicate, StringMap, ValueOf } from '../types'
+import { AnyObject, ObjectMapper, ObjectPredicate, StringMap, ValueOf } from '../types'
 
 /**
  * Returns clone of `obj` with only `props` preserved.
  * Opposite of Omit.
  */
-export function _pick<T extends Record<string, any>, K extends keyof T>(
+export function _pick<T extends AnyObject, K extends keyof T>(
   obj: T,
   props: readonly K[],
   mutate = false,
@@ -29,7 +29,7 @@ export function _pick<T extends Record<string, any>, K extends keyof T>(
  * Returns clone of `obj` with `props` omitted.
  * Opposite of Pick.
  */
-export function _omit<T extends Record<string, any>, K extends keyof T>(
+export function _omit<T extends AnyObject, K extends keyof T>(
   obj: T,
   props: readonly K[],
   mutate = false,
@@ -51,7 +51,7 @@ export function _omit<T extends Record<string, any>, K extends keyof T>(
  *  'account.updated',
  * ])
  */
-export function _mask<T extends Record<string, any>>(obj: T, props: string[], mutate = false): T {
+export function _mask<T extends AnyObject>(obj: T, props: string[], mutate = false): T {
   return props.reduce(
     (r, prop) => {
       _unset(r, prop)
@@ -64,14 +64,14 @@ export function _mask<T extends Record<string, any>>(obj: T, props: string[], mu
 /**
  * Removes "falsy" values from the object.
  */
-export function _filterFalsyValues<T extends Record<string, any>>(obj: T, mutate = false): T {
+export function _filterFalsyValues<T extends AnyObject>(obj: T, mutate = false): T {
   return _filterObject(obj, (_k, v) => !!v, mutate)
 }
 
 /**
  * Removes values from the object that are `null` or `undefined`.
  */
-export function _filterNullishValues<T extends Record<string, any>>(obj: T, mutate = false): T {
+export function _filterNullishValues<T extends AnyObject>(obj: T, mutate = false): T {
   return _filterObject(obj, (_k, v) => v !== undefined && v !== null, mutate)
 }
 
@@ -79,11 +79,11 @@ export function _filterNullishValues<T extends Record<string, any>>(obj: T, muta
  * Removes values from the object that are `undefined`.
  * Only `undefined` values are removed. `null` values are kept!
  */
-export function _filterUndefinedValues<T extends Record<string, any>>(obj: T, mutate = false): T {
+export function _filterUndefinedValues<T extends AnyObject>(obj: T, mutate = false): T {
   return _filterObject(obj, (_k, v) => v !== undefined, mutate)
 }
 
-export function _filterEmptyArrays<T extends Record<string, any>>(obj: T, mutate = false): T {
+export function _filterEmptyArrays<T extends AnyObject>(obj: T, mutate = false): T {
   return _filterObject(obj, (_k, v) => !Array.isArray(v) || v.length > 0, mutate)
 }
 
@@ -91,7 +91,7 @@ export function _filterEmptyArrays<T extends Record<string, any>>(obj: T, mutate
  * Returns clone of `obj` without properties that does not pass `predicate`.
  * Allows filtering by both key and value.
  */
-export function _filterObject<T extends Record<string, any>>(
+export function _filterObject<T extends AnyObject>(
   obj: T,
   predicate: ObjectPredicate<T>,
   mutate = false,
@@ -118,7 +118,7 @@ export function _filterObject<T extends Record<string, any>>(
  * _.mapValues(users, 'age')
  * // => { 'fred': 40, 'pebbles': 1 } (iteration order is not guaranteed)
  */
-export function _mapValues<T extends Record<string, any>, OUT = T>(
+export function _mapValues<T extends AnyObject, OUT = T>(
   obj: T,
   mapper: ObjectMapper<T, any>,
   mutate = false,
@@ -135,7 +135,7 @@ export function _mapValues<T extends Record<string, any>, OUT = T>(
  *
  * Does not support `mutate` flag.
  */
-export function _mapKeys<T extends Record<string, any>>(
+export function _mapKeys<T extends AnyObject>(
   obj: T,
   mapper: ObjectMapper<T, string>,
 ): StringMap<T[keyof T]> {
@@ -162,7 +162,7 @@ export function _mapKeys<T extends Record<string, any>>(
  *
  * Non-string keys are passed via String(...)
  */
-export function _mapObject<IN extends Record<string, any>, OUT>(
+export function _mapObject<IN extends AnyObject, OUT>(
   obj: IN,
   mapper: ObjectMapper<IN, [key: string, value: any]>,
 ): { [P in keyof IN]: OUT } {
@@ -175,17 +175,11 @@ export function _mapObject<IN extends Record<string, any>, OUT>(
   }, {} as { [P in keyof IN]: OUT })
 }
 
-export function _findKeyByValue<T extends Record<any, any>>(
-  obj: T,
-  v: ValueOf<T>,
-): keyof T | undefined {
+export function _findKeyByValue<T extends AnyObject>(obj: T, v: ValueOf<T>): keyof T | undefined {
   return Object.entries(obj).find(([_, value]) => value === v)?.[0] as keyof T
 }
 
-export function _objectNullValuesToUndefined<T extends Record<string, any>>(
-  obj: T,
-  mutate = false,
-): T {
+export function _objectNullValuesToUndefined<T extends AnyObject>(obj: T, mutate = false): T {
   return _mapValues(obj, (_k, v) => (v === null ? undefined : v), mutate)
 }
 
@@ -199,7 +193,7 @@ export function _deepCopy<T>(o: T): T {
 /**
  * Returns true if item is Object, not null and not Array.
  */
-export function _isObject(item: any): item is Record<string, any> {
+export function _isObject(item: any): item is AnyObject {
   return (typeof item === 'object' && item !== null && !Array.isArray(item)) || false
 }
 
@@ -256,7 +250,7 @@ export function _undefinedIfEmpty<T>(obj: T | undefined): T | undefined {
 /**
  * Filters the object by removing all key-value pairs where Value is Empty (according to _isEmpty() specification).
  */
-export function _filterEmptyValues<T extends Record<string, any>>(obj: T, mutate = false): T {
+export function _filterEmptyValues<T extends AnyObject>(obj: T, mutate = false): T {
   return _filterObject(obj, (_k, v) => !_isEmpty(v), mutate)
 }
 
@@ -289,7 +283,7 @@ export function _filterEmptyValues<T extends Record<string, any>>(obj: T, mutate
  *
  * Based on: https://gist.github.com/Salakar/1d7137de9cb8b704e48a
  */
-export function _merge<T extends Record<string, any>>(target: T, ...sources: any[]): T {
+export function _merge<T extends AnyObject>(target: T, ...sources: any[]): T {
   sources.forEach(source => {
     if (_isObject(source)) {
       Object.keys(source).forEach(key => {
@@ -311,7 +305,7 @@ export function _merge<T extends Record<string, any>>(target: T, ...sources: any
  * Doesn't touch object KEYS.
  * Mutates.
  */
-export function _deepTrim<T extends Record<string, any> | string>(o: T): T {
+export function _deepTrim<T extends AnyObject | string>(o: T): T {
   if (!o) return o
 
   if (typeof o === 'string') {
@@ -327,7 +321,7 @@ export function _deepTrim<T extends Record<string, any> | string>(o: T): T {
 
 // from: https://github.com/jonschlinkert/unset-value
 // mutates obj
-export function _unset<T extends Record<string, any>>(obj: T, prop: string): void {
+export function _unset<T extends AnyObject>(obj: T, prop: string): void {
   if (!_isObject(obj)) {
     return
   }
@@ -350,9 +344,7 @@ export function _unset<T extends Record<string, any>>(obj: T, prop: string): voi
   delete obj[last!]
 }
 
-export function _invert<T extends Record<any, any>>(
-  o: T,
-): { [k in ValueOf<T>]: keyof T | undefined } {
+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
@@ -375,7 +367,7 @@ export function _invertMap<K, V>(m: ReadonlyMap<K, V>): Map<V, K> {
  * @param def The value returned if the resolved value is undefined.
  * @return Returns the resolved value.
  */
-export function _get<T extends Record<string, any>>(obj = {} as T, path = '', def?: any): any {
+export function _get<T extends AnyObject>(obj = {} as T, path = '', def?: any): any {
   const res = path
     .replace(/\[([^\]]+)]/g, '.$1')
     .split('.')
@@ -396,7 +388,7 @@ export function _get<T extends Record<string, any>>(obj = {} as T, path = '', de
  *
  * Based on: https://stackoverflow.com/a/54733755/4919972
  */
-export function _set<IN extends Record<string, any>, OUT = IN>(
+export function _set<IN extends AnyObject, OUT = IN>(
   obj: IN,
   path: PropertyPath,
   value?: any,
@@ -455,7 +447,7 @@ export function _set<IN extends Record<string, any>, OUT = IN>(
  * _.has(other, 'a');
  * // => false
  */
-export function _has<T extends Record<string, any>>(obj: T, path?: string): boolean {
+export function _has<T extends AnyObject>(obj: T, path?: string): boolean {
   const v = _get(obj, path)
   return v !== undefined && v !== null
 }

package/src/object/sortObject.ts

@@ -1,11 +1,11 @@
-import { _omit } from '../index'
+import { _omit, AnyObject } from '../index'
 
 /**
  * Returns new object with keys sorder in the given order.
  * All keys that are not listed in `keyOrder` go last.
  * Does not mutate original object.
  */
-export function _sortObject<T extends Record<any, any>>(obj: T, keyOrder: (keyof T)[]): T {
+export function _sortObject<T extends AnyObject>(obj: T, keyOrder: (keyof T)[]): T {
   const r = {} as T
 
   keyOrder.forEach(key => {

package/src/promise/pTuple.ts

@@ -4,12 +4,8 @@
  *
  * source: https://github.com/scopsy/await-to-js/blob/master/src/await-to-js.ts
  */
-export async function pTuple<T, U = Error>(
-  promise: Promise<T>,
-): Promise<[U, undefined] | [null, T]> {
-  return promise
-    .then<[null, T]>((data: T) => [null, data])
-    .catch<[U, undefined]>((err: U) => {
-      return [err, undefined]
-    })
+export async function pTuple<RETURN, ERR = Error>(
+  promise: Promise<RETURN>,
+): Promise<[ERR, undefined] | [null, RETURN]> {
+  return promise.then(data => [null, data] as [null, RETURN]).catch(err => [err as ERR, undefined])
 }

package/src/string/url.util.ts

@@ -0,0 +1,27 @@
+import { StringMap } from '../types'
+
+/**
+ * Parses `location.search` string (e.g `?a=1&b=2`) into a StringMap, e.g:
+ * `{ a: '1', b: '2' }`
+ *
+ * Pass `location.search` to it in the Frontend, or any other string on the Backend (where `location.search` is not available).
+ *
+ * Works both with and without leading `?` character.
+ *
+ * Yes, there's `URLSearchParams` existing in the Frontend (not in Node yet), but it's API is not
+ * as convenient. And the implementation here is super-small.
+ *
+ * Goal of this function is to produce exactly same output as URLSearchParams would.
+ */
+export function _parseQueryString(search: string): StringMap {
+  const qs = {}
+  search
+    .substr(search[0] === '?' ? 1 : 0)
+    .split('&')
+    .forEach(p => {
+      const [k, v] = p.split('=')
+      if (!k) return
+      qs[decodeURIComponent(k)] = decodeURIComponent(v || '')
+    })
+  return qs
+}

package/src/time/time.util.ts

@@ -37,6 +37,12 @@ export function _ms(millis: number): string {
     return `${hrs}h${min}m`
   }
 
-  // >= 24h
-  return `${Math.round(hrs + min / 60)}h`
+  if (hrs < 48) {
+    return `${Math.round(hrs + min / 60)}h`
+  }
+
+  // >= 48 hours
+
+  const days = Math.floor(hrs / 24)
+  return `${days} days`
 }

package/src/types.ts

@@ -24,6 +24,21 @@ export interface PromiseMap {
  */
 export type AnyObject = Record<string, any>
 
+export interface CreatedUpdated {
+  created: number
+  updated: number
+}
+
+export interface CreatedUpdatedId extends CreatedUpdated {
+  id: string
+}
+
+export interface ObjectWithId {
+  id: string
+}
+
+export interface AnyObjectWithId extends AnyObject, ObjectWithId {}
+
 /**
  * Convenience type shorthand.
  * Because `Function` type is discouraged by eslint.
@@ -176,6 +191,6 @@ export function _stringMapEntries<T>(m: StringMap<T>): [k: string, v: T][] {
  *
  * @experimental
  */
-export function _objectKeys<T extends Record<string, any>>(obj: T): (keyof T)[] {
+export function _objectKeys<T extends AnyObject>(obj: T): (keyof T)[] {
   return Object.keys(obj)
 }