@naturalcycles/js-lib 14.101.0 → 14.104.0

package/dist/array/array.util.d.ts

@@ -1,5 +1,5 @@
 import { RecursiveArray } from '../lodash.types';
-import { Mapper, Predicate, StringMap } from '../types';
+import { FalsyValue, Mapper, Predicate, StringMap } from '../types';
 /**
  * Creates an array of elements split into groups the length of size. If collection can’t be split evenly, the
  * final chunk will be the remaining elements.
@@ -115,6 +115,9 @@ export declare function _intersection<T>(...arrays: T[][]): T[];
  * // [1]
  */
 export declare function _difference<T>(source: T[], ...diffs: T[][]): T[];
+/**
+ * Returns the sum of items, or 0 for empty array.
+ */
 export declare function _sum(items: number[]): number;
 export declare function _sumBy<T>(items: T[], mapper: Mapper<T, number | undefined>): number;
 /**
@@ -130,7 +133,7 @@ export declare function _sumBy<T>(items: T[], mapper: Mapper<T, number | undefin
  * _mapToObject([1, 2, 3], n => [n, `id${n}`])
  * // { '1': 'id1, '2': 'id2', '3': 'id3' }
  */
-export declare function _mapToObject<T, V>(array: T[], mapper: (item: T) => [key: any, value: V] | undefined | null | false | 0 | void): StringMap<V>;
+export declare function _mapToObject<T, V>(array: T[], mapper: (item: T) => [key: any, value: V] | FalsyValue): StringMap<V>;
 /**
  * Randomly shuffle an array values.
  * Fisher–Yates algorithm.
@@ -146,7 +149,13 @@ export declare function _last<T>(array: T[]): T;
  * Returns last item of the array (or undefined if array is empty).
  */
 export declare function _lastOrUndefined<T>(array: T[]): T | undefined;
-export declare function _minOrUndefined<T>(array: T[]): T | undefined;
-export declare function _min<T>(array: T[]): T;
-export declare function _maxOrUndefined<T>(array: T[]): T | undefined;
-export declare function _max<T>(array: T[]): T;
+export declare function _minOrUndefined<T>(array: T[]): NonNullable<T> | undefined;
+/**
+ * Filters out nullish values (undefined and null).
+ */
+export declare function _min<T>(array: T[]): NonNullable<T>;
+export declare function _maxOrUndefined<T>(array: T[]): NonNullable<T> | undefined;
+/**
+ * Filters out nullish values (undefined and null).
+ */
+export declare function _max<T>(array: T[]): NonNullable<T>;

package/dist/array/array.util.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports._max = exports._maxOrUndefined = exports._min = exports._minOrUndefined = exports._lastOrUndefined = exports._last = exports._shuffle = exports._mapToObject = exports._sumBy = exports._sum = exports._difference = exports._intersection = exports._countBy = exports._dropRightWhile = exports._dropWhile = exports._takeRightWhile = exports._takeWhile = exports._findLast = exports._sortBy = exports._groupBy = exports._by = exports._uniqBy = exports._uniq = exports._flattenDeep = exports._flatten = exports._chunk = void 0;
+const is_util_1 = require("../is.util");
 /**
  * Creates an array of elements split into groups the length of size. If collection can’t be split evenly, the
  * final chunk will be the remaining elements.
@@ -210,6 +211,9 @@ function _difference(source, ...diffs) {
     return diffs.reduce((a, b) => a.filter(c => !b.includes(c)), source);
 }
 exports._difference = _difference;
+/**
+ * Returns the sum of items, or 0 for empty array.
+ */
 function _sum(items) {
     return items.reduce((sum, n) => sum + n, 0);
 }
@@ -277,26 +281,36 @@ function _lastOrUndefined(array) {
 }
 exports._lastOrUndefined = _lastOrUndefined;
 function _minOrUndefined(array) {
-    if (!array.length)
+    const a = array.filter(is_util_1._isNotNullish);
+    if (!a.length)
         return;
-    return _min(array);
+    return _min(a);
 }
 exports._minOrUndefined = _minOrUndefined;
+/**
+ * Filters out nullish values (undefined and null).
+ */
 function _min(array) {
-    if (!array.length)
+    const a = array.filter(is_util_1._isNotNullish);
+    if (!a.length)
         throw new Error('_min called on empty array');
-    return array.reduce((min, item) => (min <= item ? min : item));
+    return a.reduce((min, item) => (min <= item ? min : item));
 }
 exports._min = _min;
 function _maxOrUndefined(array) {
-    if (!array.length)
+    const a = array.filter(is_util_1._isNotNullish);
+    if (!a.length)
         return;
-    return _max(array);
+    return _max(a);
 }
 exports._maxOrUndefined = _maxOrUndefined;
+/**
+ * Filters out nullish values (undefined and null).
+ */
 function _max(array) {
-    if (!array.length)
+    const a = array.filter(is_util_1._isNotNullish);
+    if (!a.length)
         throw new Error('_max called on empty array');
-    return array.reduce((max, item) => (max >= item ? max : item));
+    return a.reduce((max, item) => (max >= item ? max : item));
 }
 exports._max = _max;

package/dist/decorators/memo.util.js

@@ -1,11 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MapMemoCache = exports.jsonMemoSerializer = void 0;
-const object_util_1 = require("../object/object.util");
+const __1 = require("..");
 const jsonMemoSerializer = args => {
     if (args.length === 0)
         return undefined;
-    if (args.length === 1 && (0, object_util_1._isPrimitive)(args[0]))
+    if (args.length === 1 && (0, __1._isPrimitive)(args[0]))
         return args[0];
     return JSON.stringify(args);
 };

package/dist/index.d.ts

@@ -50,8 +50,9 @@ export * from './string/json.util';
 export * from './string/string.util';
 import { JsonStringifyFunction, StringifyAnyOptions, _stringifyAny } from './string/stringifyAny';
 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, 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, 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';
@@ -68,5 +69,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, 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, 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

@@ -65,6 +65,7 @@ tslib_1.__exportStar(require("./string/string.util"), exports);
 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; } });

package/dist/is.util.d.ts

@@ -0,0 +1,40 @@
+import { Primitive } from './typeFest';
+import { AnyObject, FalsyValue, NullishValue } from './types';
+declare type Nullish<T> = T extends NullishValue ? T : never;
+declare type Truthy<T> = T extends FalsyValue ? never : T;
+declare type Falsy<T> = T extends FalsyValue ? T : never;
+export declare const _isNull: <T>(v: T) => v is T extends null ? T : never;
+export declare const _isUndefined: <T>(v: T) => v is T extends undefined ? T : never;
+export declare const _isNullish: <T>(v: T) => v is Nullish<T>;
+export declare const _isNotNullish: <T>(v: T) => v is NonNullable<T>;
+/**
+ * Same as Boolean, but with correct type output.
+ * Related:
+ * https://github.com/microsoft/TypeScript/issues/16655
+ * https://www.karltarvas.com/2021/03/11/typescript-array-filter-boolean.html
+ *
+ * @example
+ *
+ * [1, 2, undefined].filter(_isTruthy)
+ * // => [1, 2]
+ */
+export declare const _isTruthy: <T>(v: T) => v is Truthy<T>;
+export declare const _isFalsy: <T>(v: T) => v is Falsy<T>;
+/**
+ * Returns true if item is Object, not null and not Array.
+ */
+export declare function _isObject(item: any): item is AnyObject;
+export declare function _isPrimitive(v: any): v is Primitive;
+export declare function _isEmptyObject(obj: any): boolean;
+/**
+ * Object is considered empty if it's one of:
+ * undefined
+ * null
+ * '' (empty string)
+ * [] (empty array)
+ * {} (empty object)
+ * new Map() (empty Map)
+ * new Set() (empty Set)
+ */
+export declare function _isEmpty(obj: any): boolean;
+export {};

package/dist/is.util.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._isEmpty = exports._isEmptyObject = exports._isPrimitive = exports._isObject = exports._isFalsy = exports._isTruthy = exports._isNotNullish = exports._isNullish = exports._isUndefined = exports._isNull = void 0;
+const _isNull = (v) => v === null;
+exports._isNull = _isNull;
+const _isUndefined = (v) => typeof v === 'undefined';
+exports._isUndefined = _isUndefined;
+const _isNullish = (v) => typeof v === 'undefined' || v === null;
+exports._isNullish = _isNullish;
+const _isNotNullish = (v) => v !== undefined && v !== null;
+exports._isNotNullish = _isNotNullish;
+/**
+ * Same as Boolean, but with correct type output.
+ * Related:
+ * https://github.com/microsoft/TypeScript/issues/16655
+ * https://www.karltarvas.com/2021/03/11/typescript-array-filter-boolean.html
+ *
+ * @example
+ *
+ * [1, 2, undefined].filter(_isTruthy)
+ * // => [1, 2]
+ */
+const _isTruthy = (v) => !!v;
+exports._isTruthy = _isTruthy;
+const _isFalsy = (v) => !v;
+exports._isFalsy = _isFalsy;
+/**
+ * Returns true if item is Object, not null and not Array.
+ */
+function _isObject(item) {
+    return (typeof item === 'object' && item !== null && !Array.isArray(item)) || false;
+}
+exports._isObject = _isObject;
+function _isPrimitive(v) {
+    return (v === null ||
+        v === undefined ||
+        typeof v === 'number' ||
+        typeof v === 'boolean' ||
+        typeof v === 'string' ||
+        typeof v === 'bigint' ||
+        typeof v === 'symbol');
+}
+exports._isPrimitive = _isPrimitive;
+function _isEmptyObject(obj) {
+    return obj && obj.constructor === Object && Object.keys(obj).length === 0;
+}
+exports._isEmptyObject = _isEmptyObject;
+/**
+ * Object is considered empty if it's one of:
+ * undefined
+ * null
+ * '' (empty string)
+ * [] (empty array)
+ * {} (empty object)
+ * new Map() (empty Map)
+ * new Set() (empty Set)
+ */
+function _isEmpty(obj) {
+    if (obj === undefined || obj === null)
+        return true;
+    if (typeof obj === 'string' || Array.isArray(obj)) {
+        return obj.length === 0;
+    }
+    if (obj instanceof Map || obj instanceof Set) {
+        return obj.size === 0;
+    }
+    if (typeof obj === 'object') {
+        return Object.keys(obj).length === 0;
+    }
+    return false;
+}
+exports._isEmpty = _isEmpty;

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

@@ -19,6 +19,7 @@ export declare const jsonSchema: {
     number(): JsonSchemaNumberBuilder;
     integer(): JsonSchemaNumberBuilder;
     unixTimestamp(): JsonSchemaNumberBuilder;
+    unixTimestamp2000(): JsonSchemaNumberBuilder;
     string(): JsonSchemaStringBuilder;
     dateString(): JsonSchemaStringBuilder;
     object<T_4 extends AnyObject>(props: { [k in keyof T_4]: JsonSchemaAnyBuilder<T_4[k], JsonSchema<T_4[k]>>; }): JsonSchemaObjectBuilder<T_4>;
@@ -72,7 +73,9 @@ export declare class JsonSchemaNumberBuilder extends JsonSchemaAnyBuilder<number
     float: () => this;
     double: () => this;
     unixTimestamp: () => this;
+    unixTimestamp2000: () => this;
     unixTimestampMillis: () => this;
+    unixTimestampMillis2000: () => this;
     utcOffset: () => this;
     utcOffsetHours: () => this;
 }

package/dist/json-schema/jsonSchemaBuilder.js

@@ -50,6 +50,9 @@ exports.jsonSchema = {
     unixTimestamp() {
         return new JsonSchemaNumberBuilder().unixTimestamp();
     },
+    unixTimestamp2000() {
+        return new JsonSchemaNumberBuilder().unixTimestamp2000();
+    },
     // string types
     string() {
         return new JsonSchemaStringBuilder();
@@ -167,7 +170,9 @@ class JsonSchemaNumberBuilder extends JsonSchemaAnyBuilder {
         this.float = () => this.format('float');
         this.double = () => this.format('double');
         this.unixTimestamp = () => this.format('unixTimestamp');
+        this.unixTimestamp2000 = () => this.format('unixTimestamp2000');
         this.unixTimestampMillis = () => this.format('unixTimestampMillis');
+        this.unixTimestampMillis2000 = () => this.format('unixTimestampMillis2000');
         this.utcOffset = () => this.format('utcOffset');
         this.utcOffsetHours = () => this.format('utcOffsetHours');
     }
@@ -309,8 +314,8 @@ class JsonSchemaObjectBuilder extends JsonSchemaAnyBuilder {
     baseDBEntity(idType = 'string') {
         Object.assign(this.schema.properties, {
             id: { type: idType },
-            created: { type: 'number', format: 'unixTimestamp' },
-            updated: { type: 'number', format: 'unixTimestamp' },
+            created: { type: 'number', format: 'unixTimestamp2000' },
+            updated: { type: 'number', format: 'unixTimestamp2000' },
         });
         return this;
     }

package/dist/json-schema/jsonSchemas.js

@@ -4,11 +4,11 @@ exports.savedDBEntityJsonSchema = exports.baseDBEntityJsonSchema = void 0;
 const jsonSchemaBuilder_1 = require("./jsonSchemaBuilder");
 exports.baseDBEntityJsonSchema = jsonSchemaBuilder_1.jsonSchema.object({
     id: jsonSchemaBuilder_1.jsonSchema.string().optional(),
-    created: jsonSchemaBuilder_1.jsonSchema.unixTimestamp().optional(),
-    updated: jsonSchemaBuilder_1.jsonSchema.unixTimestamp().optional(),
+    created: jsonSchemaBuilder_1.jsonSchema.unixTimestamp2000().optional(),
+    updated: jsonSchemaBuilder_1.jsonSchema.unixTimestamp2000().optional(),
 });
 exports.savedDBEntityJsonSchema = jsonSchemaBuilder_1.jsonSchema.object({
     id: jsonSchemaBuilder_1.jsonSchema.string(),
-    created: jsonSchemaBuilder_1.jsonSchema.unixTimestamp(),
-    updated: jsonSchemaBuilder_1.jsonSchema.unixTimestamp(),
+    created: jsonSchemaBuilder_1.jsonSchema.unixTimestamp2000(),
+    updated: jsonSchemaBuilder_1.jsonSchema.unixTimestamp2000(),
 });

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

@@ -84,23 +84,6 @@ export declare function _objectNullValuesToUndefined<T extends AnyObject>(obj: T
  * Deep copy object (by json parse/stringify, since it has unbeatable performance+simplicity combo).
  */
 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 AnyObject;
-export declare function _isPrimitive(v: any): v is null | undefined | number | boolean | string;
-export declare function _isEmptyObject(obj: any): boolean;
-/**
- * Object is considered empty if it's one of:
- * undefined
- * null
- * '' (empty string)
- * [] (empty array)
- * {} (empty object)
- * new Map() (empty Map)
- * new Set() (empty Set)
- */
-export declare function _isEmpty(obj: any): boolean;
 /**
  * Returns `undefined` if it's empty (according to `_isEmpty()` specification),
  * otherwise returns the original object.

package/dist/object/object.util.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._has = exports._set = exports._get = exports._invertMap = exports._invert = exports._unset = exports._deepTrim = exports._merge = exports._filterEmptyValues = exports._undefinedIfEmpty = exports._isEmpty = exports._isEmptyObject = exports._isPrimitive = exports._isObject = exports._deepCopy = exports._objectNullValuesToUndefined = exports._findKeyByValue = exports._mapObject = exports._mapKeys = exports._mapValues = exports._filterObject = exports._filterEmptyArrays = exports._filterUndefinedValues = exports._filterNullishValues = exports._filterFalsyValues = exports._mask = exports._omit = exports._pick = void 0;
+exports._has = exports._set = exports._get = exports._invertMap = exports._invert = exports._unset = exports._deepTrim = exports._merge = exports._filterEmptyValues = exports._undefinedIfEmpty = exports._deepCopy = exports._objectNullValuesToUndefined = exports._findKeyByValue = exports._mapObject = exports._mapKeys = exports._mapValues = exports._filterObject = exports._filterEmptyArrays = exports._filterUndefinedValues = exports._filterNullishValues = exports._filterFalsyValues = exports._mask = exports._omit = exports._pick = void 0;
+const is_util_1 = require("../is.util");
 /**
  * Returns clone of `obj` with only `props` preserved.
  * Opposite of Omit.
@@ -164,63 +165,19 @@ function _deepCopy(o) {
     return JSON.parse(JSON.stringify(o));
 }
 exports._deepCopy = _deepCopy;
-/**
- * Returns true if item is Object, not null and not Array.
- */
-function _isObject(item) {
-    return (typeof item === 'object' && item !== null && !Array.isArray(item)) || false;
-}
-exports._isObject = _isObject;
-function _isPrimitive(v) {
-    return (v === null ||
-        v === undefined ||
-        typeof v === 'number' ||
-        typeof v === 'boolean' ||
-        typeof v === 'string');
-}
-exports._isPrimitive = _isPrimitive;
-function _isEmptyObject(obj) {
-    return obj && obj.constructor === Object && Object.keys(obj).length === 0;
-}
-exports._isEmptyObject = _isEmptyObject;
-/**
- * Object is considered empty if it's one of:
- * undefined
- * null
- * '' (empty string)
- * [] (empty array)
- * {} (empty object)
- * new Map() (empty Map)
- * new Set() (empty Set)
- */
-function _isEmpty(obj) {
-    if (obj === undefined || obj === null)
-        return true;
-    if (typeof obj === 'string' || Array.isArray(obj)) {
-        return obj.length === 0;
-    }
-    if (obj instanceof Map || obj instanceof Set) {
-        return obj.size === 0;
-    }
-    if (typeof obj === 'object') {
-        return Object.keys(obj).length === 0;
-    }
-    return false;
-}
-exports._isEmpty = _isEmpty;
 /**
  * Returns `undefined` if it's empty (according to `_isEmpty()` specification),
  * otherwise returns the original object.
  */
 function _undefinedIfEmpty(obj) {
-    return _isEmpty(obj) ? undefined : obj;
+    return (0, is_util_1._isEmpty)(obj) ? undefined : obj;
 }
 exports._undefinedIfEmpty = _undefinedIfEmpty;
 /**
  * Filters the object by removing all key-value pairs where Value is Empty (according to _isEmpty() specification).
  */
 function _filterEmptyValues(obj, mutate = false) {
-    return _filterObject(obj, (_k, v) => !_isEmpty(v), mutate);
+    return _filterObject(obj, (_k, v) => !(0, is_util_1._isEmpty)(v), mutate);
 }
 exports._filterEmptyValues = _filterEmptyValues;
 /**
@@ -254,9 +211,9 @@ exports._filterEmptyValues = _filterEmptyValues;
  */
 function _merge(target, ...sources) {
     sources.forEach(source => {
-        if (_isObject(source)) {
+        if ((0, is_util_1._isObject)(source)) {
             Object.keys(source).forEach(key => {
-                if (_isObject(source[key])) {
+                if ((0, is_util_1._isObject)(source[key])) {
                     if (!target[key])
                         Object.assign(target, { [key]: {} });
                     _merge(target[key], source[key]);
@@ -292,7 +249,7 @@ exports._deepTrim = _deepTrim;
 // from: https://github.com/jonschlinkert/unset-value
 // mutates obj
 function _unset(obj, prop) {
-    if (!_isObject(obj)) {
+    if (!(0, is_util_1._isObject)(obj)) {
         return;
     }
     // eslint-disable-next-line no-prototype-builtins
@@ -305,11 +262,11 @@ function _unset(obj, prop) {
     while (segs.length && segs[segs.length - 1].slice(-1) === '\\') {
         last = segs.pop().slice(0, -1) + '.' + last;
     }
-    while (segs.length && _isObject(obj)) {
+    while (segs.length && (0, is_util_1._isObject)(obj)) {
         const k = (prop = segs.shift());
         obj = obj[k];
     }
-    if (!_isObject(obj))
+    if (!(0, is_util_1._isObject)(obj))
         return;
     delete obj[last];
 }

package/dist/object/sortObjectDeep.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports._sortObjectDeep = void 0;
-const object_util_1 = require("./object.util");
+const __1 = require("..");
 /**
  * based on: https://github.com/IndigoUnited/js-deep-sort-object
  */
@@ -11,7 +11,7 @@ function _sortObjectDeep(o) {
         // eslint-disable-next-line unicorn/no-array-callback-reference
         return o.map(_sortObjectDeep);
     }
-    if ((0, object_util_1._isObject)(o)) {
+    if ((0, __1._isObject)(o)) {
         const out = {};
         Object.keys(o)
             .sort((a, b) => a.localeCompare(b))

package/dist/types.d.ts

@@ -189,3 +189,5 @@ export declare function _stringMapEntries<T>(m: StringMap<T>): [k: string, v: T]
  * @experimental
  */
 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;

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

@@ -1,3 +1,4 @@
+import { _isNotNullish } from '../is.util';
 /**
  * Creates an array of elements split into groups the length of size. If collection can’t be split evenly, the
  * final chunk will be the remaining elements.
@@ -191,6 +192,9 @@ export function _intersection(...arrays) {
 export function _difference(source, ...diffs) {
     return diffs.reduce((a, b) => a.filter(c => !b.includes(c)), source);
 }
+/**
+ * Returns the sum of items, or 0 for empty array.
+ */
 export function _sum(items) {
     return items.reduce((sum, n) => sum + n, 0);
 }
@@ -252,22 +256,32 @@ export function _lastOrUndefined(array) {
     return array[array.length - 1];
 }
 export function _minOrUndefined(array) {
-    if (!array.length)
+    const a = array.filter(_isNotNullish);
+    if (!a.length)
         return;
-    return _min(array);
+    return _min(a);
 }
+/**
+ * Filters out nullish values (undefined and null).
+ */
 export function _min(array) {
-    if (!array.length)
+    const a = array.filter(_isNotNullish);
+    if (!a.length)
         throw new Error('_min called on empty array');
-    return array.reduce((min, item) => (min <= item ? min : item));
+    return a.reduce((min, item) => (min <= item ? min : item));
 }
 export function _maxOrUndefined(array) {
-    if (!array.length)
+    const a = array.filter(_isNotNullish);
+    if (!a.length)
         return;
-    return _max(array);
+    return _max(a);
 }
+/**
+ * Filters out nullish values (undefined and null).
+ */
 export function _max(array) {
-    if (!array.length)
+    const a = array.filter(_isNotNullish);
+    if (!a.length)
         throw new Error('_max called on empty array');
-    return array.reduce((max, item) => (max >= item ? max : item));
+    return a.reduce((max, item) => (max >= item ? max : item));
 }

package/dist-esm/datetime/localTime.js

@@ -179,11 +179,10 @@ export class LocalTime {
         return v === undefined ? this.get('second') : this.set('second', v);
     }
     setComponents(c, mutate = false) {
-        var _a;
         const d = mutate ? this.$date : new Date(this.$date);
         // Year, month and day set all-at-once, to avoid 30/31 (and 28/29) mishap
         if (c.day || c.month !== undefined || c.year !== undefined) {
-            d.setFullYear((_a = c.year) !== null && _a !== void 0 ? _a : d.getFullYear(), c.month ? c.month - 1 : d.getMonth(), c.day || d.getDate());
+            d.setFullYear(c.year ?? d.getFullYear(), c.month ? c.month - 1 : d.getMonth(), c.day || d.getDate());
         }
         if (c.hour !== undefined) {
             d.setHours(c.hour);

package/dist-esm/decorators/createPromiseDecorator.js

@@ -19,7 +19,6 @@ export function _createPromiseDecorator(cfg, decoratorParams = {}) {
         const key = String(propertyKey);
         const methodSignature = _getTargetMethodSignature(target, key);
         pd.value = async function (...args) {
-            var _a, _b;
             // console.log(`@${cfg.decoratorName} called inside function`)
             const started = Date.now();
             try {
@@ -47,9 +46,12 @@ export function _createPromiseDecorator(cfg, decoratorParams = {}) {
                     started,
                 };
                 if (cfg.thenFn) {
-                    res = cfg.thenFn(Object.assign(Object.assign({}, resp), { res }));
+                    res = cfg.thenFn({
+                        ...resp,
+                        res,
+                    });
                 }
-                (_a = cfg.finallyFn) === null || _a === void 0 ? void 0 : _a.call(cfg, resp);
+                cfg.finallyFn?.(resp);
                 return res;
             }
             catch (err) {
@@ -64,10 +66,13 @@ export function _createPromiseDecorator(cfg, decoratorParams = {}) {
                 };
                 let handled = false;
                 if (cfg.catchFn) {
-                    cfg.catchFn(Object.assign(Object.assign({}, resp), { err }));
+                    cfg.catchFn({
+                        ...resp,
+                        err,
+                    });
                     handled = true;
                 }
-                (_b = cfg.finallyFn) === null || _b === void 0 ? void 0 : _b.call(cfg, resp);
+                cfg.finallyFn?.(resp);
                 if (!handled) {
                     throw err; // rethrow
                 }

package/dist-esm/decorators/debounce.js

@@ -105,5 +105,10 @@ export function _debounce(func, wait, opt = {}) {
     return debounced;
 }
 export function _throttle(func, wait, opt = {}) {
-    return _debounce(func, wait, Object.assign(Object.assign({ leading: true, trailing: true }, opt), { maxWait: wait }));
+    return _debounce(func, wait, {
+        leading: true,
+        trailing: true,
+        ...opt,
+        maxWait: wait,
+    });
 }

package/dist-esm/decorators/memo.util.js

@@ -1,4 +1,4 @@
-import { _isPrimitive } from '../object/object.util';
+import { _isPrimitive } from '..';
 export const jsonMemoSerializer = args => {
     if (args.length === 0)
         return undefined;