@bitbeater/ecma-utils 2.7.0

package/dist/object.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPathKeys = getPathKeys;
+exports.isPlainObject = isPlainObject;
+exports.keysOf = keysOf;
+/**
+ * Returns an array of a given object's keys paths (own and nested key names) in a reccursive manner, iterated in the same order that a normal loop would.
+ *
+ * @example ```ts
+ * const object={
+ * 	str:"hello",
+ * 	nr:1,
+ * 	fn: (a:number,b:number)=> a+b,
+ * 	arr:[1,2,3],
+ * 	nestedObject:{
+ * 		str:"world",
+ * 		nr:2,
+ * 		fn: (a:number,b:number)=> a+b,
+ * 		arr:[4.5],
+ * 	}
+ * };
+ *
+ * getPathKeys(object)
+ *
+ * // RETURNS:
+ * // [  'str',
+ * //	 'nr',
+ * //	 'fn',
+ * //	 'arr',
+ * //	 'nestedObject',
+ * //	 'nestedObject.str',
+ * //	 'nestedObject.nr',
+ * //	 'nestedObject.fn',
+ * //	 'nestedObject.arr' ]
+ * ```
+ *
+ * @example ```ts
+ * const object={
+ * 	str:"hello",
+ * 	nestedObject:{
+ * 		str:"world",
+ * 		nr:2,
+ * 		fn: (a:number,b:number)=> a+b,
+ * 		arr:[4.5],
+ * 	}
+ * };
+ *
+ * getPathKeys(object,{omitFirstLevel:true})
+ *
+ * // RETURNS:
+ * // [  'str',
+ * //	 'nestedObject.str',
+ * //	 'nestedObject.nr',
+ * //	 'nestedObject.fn',
+ * //	 'nestedObject.arr' ]
+ * ```
+ *
+ * @param obj object from which to derive the paths
+ * @param options options object
+ * @returns
+ */
+function getPathKeys(obj, options) {
+    if (!obj)
+        return;
+    if (typeof obj === 'string')
+        return;
+    const pathKeys = [];
+    for (const rawKey of Object.keys(obj)) {
+        const value = obj[rawKey];
+        if (typeof value === 'function' && options?.ignoreFunctions)
+            continue;
+        const key = Array.isArray(obj) ? '[' + rawKey + ']' : rawKey;
+        if (Array.isArray(value) || typeof value !== 'object' || !options?.omitFirstLevel)
+            pathKeys.push(key);
+        if (typeof value === 'object') {
+            if (Array.isArray(value) && !options?.unfoldArrays)
+                continue;
+            const secondLevelSeparator = Array.isArray(value) ? '' : '.';
+            const secondLevelKeys = getPathKeys(value, options);
+            if (!secondLevelKeys?.length)
+                continue;
+            const secondLevelPathKeys = secondLevelKeys.map(k => key + secondLevelSeparator + k);
+            pathKeys.push(...secondLevelPathKeys);
+        }
+    }
+    return pathKeys;
+}
+/**
+ * Checks if a value is a plain object (not null, not array, not date, not promise, not function)
+ *
+ * @param v value to check
+ * @returns boolean indicating if the value is a plain object
+ *
+ * @example
+ * ```ts
+ * isPlainObject({}) // => true
+ * isPlainObject({ a: 1, b: { c: 2 } }) // => true
+ * isPlainObject(() => {}) // => false
+ * isPlainObject(null) // => false
+ * isPlainObject(undefined) // => false
+ * isPlainObject([]) // => false
+ * isPlainObject(new Date()) // => false
+ * isPlainObject("hello") // => false
+ * isPlainObject(123) // => false
+ * isPlainObject(true) // => false
+ * isPlainObject(Symbol("sym")) // => false
+ * isPlainObject(BigInt(123)) // => false
+ * isPlainObject(Promise.resolve(123)) // => false
+ * ```
+ */
+function isPlainObject(v) {
+    return typeof v === 'object' && v !== null && !(v instanceof Date) && !Array.isArray(v) && !(v instanceof Promise);
+}
+/**
+ * returns the keys of an object as an array, with proper typing.
+ * @example
+ * ```ts
+ * const obj = { a: 1, b: 2, c: 3 };
+ * const keys = keysOf(obj); // ['a', 'b', 'c']
+ * ```
+ * @param o
+ * @returns
+ */
+function keysOf(o) {
+    return Object.keys(o);
+}
+//# sourceMappingURL=object.js.map

package/dist/object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.js","sourceRoot":"","sources":["../src/object.ts"],"names":[],"mappings":";;AA8DA,kCA2BC;AAyBD,sCAEC;AAYD,wBAEC;AA5HD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,SAAgB,WAAW,CAAC,GAAQ,EAAE,OAAyB;IAC9D,IAAI,CAAC,GAAG;QAAE,OAAO;IACjB,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO;IAEpC,MAAM,QAAQ,GAAG,EAAE,CAAC;IACpB,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;QAE1B,IAAI,OAAO,KAAK,KAAK,UAAU,IAAI,OAAO,EAAE,eAAe;YAAE,SAAS;QAEtE,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;QAE7D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,OAAO,EAAE,cAAc;YAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEtG,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC/B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY;gBAAE,SAAS;YAE7D,MAAM,oBAAoB,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;YAE7D,MAAM,eAAe,GAAG,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACpD,IAAI,CAAC,eAAe,EAAE,MAAM;gBAAE,SAAS;YACvC,MAAM,mBAAmB,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,oBAAoB,GAAG,CAAC,CAAC,CAAC;YACrF,QAAQ,CAAC,IAAI,CAAC,GAAG,mBAAmB,CAAC,CAAC;QACvC,CAAC;IACF,CAAC;IAED,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,SAAgB,aAAa,CAAC,CAAU;IACvC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,OAAO,CAAC,CAAC;AACpH,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,MAAM,CAAmB,CAAI;IAC5C,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAgB,CAAC;AACtC,CAAC"}

package/dist/path/path.d.ts

@@ -0,0 +1,2 @@
+declare function getPathExtension(path: string): string;
+//# sourceMappingURL=path.d.ts.map

package/dist/path/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/path/path.ts"],"names":[],"mappings":"AAAA,iBAAS,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM9C"}

package/dist/path/path.js

@@ -0,0 +1,8 @@
+function getPathExtension(path) {
+    const lastDotIndex = path.lastIndexOf('.');
+    if (lastDotIndex === -1 || lastDotIndex === path.length - 1) {
+        return '';
+    }
+    return path.substring(lastDotIndex + 1);
+}
+//# sourceMappingURL=path.js.map

package/dist/path/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../src/path/path.ts"],"names":[],"mappings":"AAAA,SAAS,gBAAgB,CAAC,IAAY;IACrC,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC3C,IAAI,YAAY,KAAK,CAAC,CAAC,IAAI,YAAY,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7D,OAAO,EAAE,CAAC;IACX,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;AACzC,CAAC"}

package/dist/promises.d.ts

@@ -0,0 +1,3 @@
+export declare function of<T>(data?: T): Promise<T>;
+export declare function delay(ms: number): Promise<void>;
+//# sourceMappingURL=promises.d.ts.map

package/dist/promises.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promises.d.ts","sourceRoot":"","sources":["../src/promises.ts"],"names":[],"mappings":"AAAA,wBAAgB,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAE1C;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/C"}

package/dist/promises.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.of = of;
+exports.delay = delay;
+function of(data) {
+    return Promise.resolve(data);
+}
+function delay(ms) {
+    return new Promise((resolve, _reject) => {
+        setTimeout(resolve, ms);
+    });
+}
+//# sourceMappingURL=promises.js.map

package/dist/promises.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promises.js","sourceRoot":"","sources":["../src/promises.ts"],"names":[],"mappings":";;AAAA,gBAEC;AAED,sBAIC;AARD,SAAgB,EAAE,CAAI,IAAQ;IAC7B,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,SAAgB,KAAK,CAAC,EAAU;IAC/B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;QACvC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/random.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Returns a random floating-point number between min and max (inclusive).
+ * @param min The minimum value.
+ * @param max The maximum value.
+ * @returns A random floating-point number between min and max.
+ */
+export declare function getRandom(min?: number, max?: number): number;
+/**
+ * Returns a random integer between min and max (inclusive).
+ * @param min The minimum value.
+ * @param max The maximum value.
+ * @returns A random integer between min and max.
+ */
+export declare function getRandomInt(min?: number, max?: number): number;
+/**
+ * Returns a random boolean value.
+ * @param trueProbability A number between 0 and 1 representing the probability of returning true. Default is 0.5.
+ * @returns A random boolean value.
+ */
+export declare function getRandomBool(trueProbability?: number): boolean;
+/**
+ * Returns either 1 or -1, with equal probability.
+ * @returns Either 1 or -1.
+ */
+export declare function getRandomSign(positiveProbability?: number): 1 | -1;
+/**]
+ * Returns a random character from the given string of characters.
+ * @param chars A string containing the characters to choose from. Default is alphanumeric characters.
+ * @returns A random character from the given string.
+ */
+export declare function getRandomChar(chars?: string): string;
+/**
+ * Returns a random string of the specified length using the given characters.
+ * @param length The length of the random string to generate.
+ * @param chars A string containing the characters to choose from. Default is alphanumeric characters.
+ * @returns A random string of the specified length.
+ */
+export declare function getRandomString(length: number, chars?: string): string;
+/**
+ * Returns a random date between the specified start and end dates.
+ * @param start The start date (inclusive).
+ * @param end The end date (inclusive).
+ * @returns A random date between the start and end dates.
+ */
+export declare function getRandomDate(start?: Date, end?: Date): Date;
+//# sourceMappingURL=random.d.ts.map

package/dist/random.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.d.ts","sourceRoot":"","sources":["../src/random.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,SAAmB,EAAE,GAAG,SAAmB,GAAG,MAAM,CAEhF;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;;;GAIG;AAEH,wBAAgB,aAAa,CAAC,eAAe,SAAM,GAAG,OAAO,CAE5D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,mBAAmB,SAAM,GAAG,CAAC,GAAG,CAAC,CAAC,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,SAAmE,GAAG,MAAM,CAE9G;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,SAAmE,GAAG,MAAM,CAMhI;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,OAAc,EAAE,GAAG,OAAwB,GAAG,IAAI,CAEpF"}

package/dist/random.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRandom = getRandom;
+exports.getRandomInt = getRandomInt;
+exports.getRandomBool = getRandomBool;
+exports.getRandomSign = getRandomSign;
+exports.getRandomChar = getRandomChar;
+exports.getRandomString = getRandomString;
+exports.getRandomDate = getRandomDate;
+const collectionOperations_1 = require("./collection/collectionOperations");
+const time_1 = require("./time/time");
+/**
+ * Returns a random floating-point number between min and max (inclusive).
+ * @param min The minimum value.
+ * @param max The maximum value.
+ * @returns A random floating-point number between min and max.
+ */
+function getRandom(min = Number.MIN_VALUE, max = Number.MAX_VALUE) {
+    return Math.random() * (max - min) + min;
+}
+/**
+ * Returns a random integer between min and max (inclusive).
+ * @param min The minimum value.
+ * @param max The maximum value.
+ * @returns A random integer between min and max.
+ */
+function getRandomInt(min, max) {
+    return Math.floor(getRandom(min, max));
+}
+/**
+ * Returns a random boolean value.
+ * @param trueProbability A number between 0 and 1 representing the probability of returning true. Default is 0.5.
+ * @returns A random boolean value.
+ */
+function getRandomBool(trueProbability = 0.5) {
+    return Math.random() < trueProbability;
+}
+/**
+ * Returns either 1 or -1, with equal probability.
+ * @returns Either 1 or -1.
+ */
+function getRandomSign(positiveProbability = 0.5) {
+    return getRandomBool(positiveProbability) ? 1 : -1;
+}
+/**]
+ * Returns a random character from the given string of characters.
+ * @param chars A string containing the characters to choose from. Default is alphanumeric characters.
+ * @returns A random character from the given string.
+ */
+function getRandomChar(chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789') {
+    return (0, collectionOperations_1.takeRandomElement)(chars.split(''));
+}
+/**
+ * Returns a random string of the specified length using the given characters.
+ * @param length The length of the random string to generate.
+ * @param chars A string containing the characters to choose from. Default is alphanumeric characters.
+ * @returns A random string of the specified length.
+ */
+function getRandomString(length, chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789') {
+    let result = '';
+    for (let i = 0; i < length; i++) {
+        result += getRandomChar(chars);
+    }
+    return result;
+}
+/**
+ * Returns a random date between the specified start and end dates.
+ * @param start The start date (inclusive).
+ * @param end The end date (inclusive).
+ * @returns A random date between the start and end dates.
+ */
+function getRandomDate(start = new Date(0), end = new Date(time_1.MAX_JS_DATE)) {
+    return new Date(getRandomInt(start.getTime(), end.getTime()));
+}
+/// return new Date(getRandomInt(start.getTime(), end.getTime()));
+//# sourceMappingURL=random.js.map

package/dist/random.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.js","sourceRoot":"","sources":["../src/random.ts"],"names":[],"mappings":";;AASA,8BAEC;AAQD,oCAEC;AAQD,sCAEC;AAMD,sCAEC;AAOD,sCAEC;AAQD,0CAMC;AAQD,sCAEC;AAxED,4EAAsE;AACtE,sCAA0C;AAE1C;;;;;GAKG;AACH,SAAgB,SAAS,CAAC,GAAG,GAAG,MAAM,CAAC,SAAS,EAAE,GAAG,GAAG,MAAM,CAAC,SAAS;IACvE,OAAO,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AAC1C,CAAC;AAED;;;;;GAKG;AACH,SAAgB,YAAY,CAAC,GAAY,EAAE,GAAY;IACtD,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AACxC,CAAC;AAED;;;;GAIG;AAEH,SAAgB,aAAa,CAAC,eAAe,GAAG,GAAG;IAClD,OAAO,IAAI,CAAC,MAAM,EAAE,GAAG,eAAe,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,SAAgB,aAAa,CAAC,mBAAmB,GAAG,GAAG;IACtD,OAAO,aAAa,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC;AAED;;;;GAIG;AACH,SAAgB,aAAa,CAAC,KAAK,GAAG,gEAAgE;IACrG,OAAO,IAAA,wCAAiB,EAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,MAAc,EAAE,KAAK,GAAG,gEAAgE;IACvH,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACjC,MAAM,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,IAAI,IAAI,CAAC,kBAAW,CAAC;IAC7E,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED,kEAAkE"}

package/dist/revivers.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @link  https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/parse#using_the_reviver_parameter
+ */
+export type Reviver<T> = (key: string, value: any) => T;
+/**
+ * @link  https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/parse#using_the_reviver_parameter
+ */
+export type Replacer<T> = Reviver<T> | (number | string)[] | null;
+/**
+ * revive
+ * @param _key
+ * @param value
+ * @returns
+ */
+export declare const ISO_8601StringtoDate: Reviver<Date>;
+/**
+ * merge multiple reviver in one, the resulted value is equal to the result of the first reviver that resolve,
+ * so reviver order determine theire priority
+ *
+ * @param revivers
+ * @returns
+ * @link  https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/parse#using_the_reviver_parameter
+ */
+export declare function mergeRevivers(...revivers: Reviver<any>[]): Reviver<any>;
+//# sourceMappingURL=revivers.d.ts.map

package/dist/revivers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revivers.d.ts","sourceRoot":"","sources":["../src/revivers.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,IAAI,CAAC;AAElE;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,OAAO,CAAC,IAAI,CAA+H,CAAC;AAE/K;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,GAAG,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CASvE"}

package/dist/revivers.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ISO_8601StringtoDate = void 0;
+exports.mergeRevivers = mergeRevivers;
+const consts_1 = require("./consts");
+/**
+ * revive
+ * @param _key
+ * @param value
+ * @returns
+ */
+const ISO_8601StringtoDate = (_key, value) => (typeof value === 'string' && consts_1.ISO_8601_DATE_FORMAT_REX.test(value) ? new Date(value) : value);
+exports.ISO_8601StringtoDate = ISO_8601StringtoDate;
+/**
+ * merge multiple reviver in one, the resulted value is equal to the result of the first reviver that resolve,
+ * so reviver order determine theire priority
+ *
+ * @param revivers
+ * @returns
+ * @link  https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/parse#using_the_reviver_parameter
+ */
+function mergeRevivers(...revivers) {
+    if (!revivers?.length)
+        return;
+    return (key, value) => {
+        for (const reviver of revivers) {
+            const revived = reviver(key, value);
+            if (revived !== value)
+                return revived;
+        }
+        return value;
+    };
+}
+//# sourceMappingURL=revivers.js.map

package/dist/revivers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"revivers.js","sourceRoot":"","sources":["../src/revivers.ts"],"names":[],"mappings":";;;AA4BA,sCASC;AArCD,qCAAoD;AAYpD;;;;;GAKG;AACI,MAAM,oBAAoB,GAAkB,CAAC,IAAY,EAAE,KAAU,EAAE,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,iCAAwB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAAlK,QAAA,oBAAoB,wBAA8I;AAE/K;;;;;;;GAOG;AACH,SAAgB,aAAa,CAAC,GAAG,QAAwB;IACxD,IAAI,CAAC,QAAQ,EAAE,MAAM;QAAE,OAAO;IAC9B,OAAO,CAAC,GAAW,EAAE,KAAU,EAAE,EAAE;QAClC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAChC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACpC,IAAI,OAAO,KAAK,KAAK;gBAAE,OAAO,OAAO,CAAC;QACvC,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC,CAAC;AACH,CAAC"}

package/dist/strings.d.ts

@@ -0,0 +1,16 @@
+export declare function isJson(str: string): boolean;
+/**
+ * convert a template string to a normal string.
+ * example:
+ * ```ts
+ * const name = 'world';
+ * const str = templateToString`hello ${name}!`;
+ * // str = 'hello world!'
+ *
+ * @param template
+ * @param expressions
+ * @returns
+ */
+export declare function templateToString(template: TemplateStringsArray, ...expressions: TemplateExpression[]): string;
+export type TemplateExpression = string | number | Array<string | number>;
+//# sourceMappingURL=strings.d.ts.map

package/dist/strings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strings.d.ts","sourceRoot":"","sources":["../src/strings.ts"],"names":[],"mappings":"AAAA,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO3C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,WAAW,EAAE,kBAAkB,EAAE,GAAG,MAAM,CAS7G;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC"}

package/dist/strings.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isJson = isJson;
+exports.templateToString = templateToString;
+function isJson(str) {
+    try {
+        JSON.parse(str);
+    }
+    catch (e) {
+        return false;
+    }
+    return true;
+}
+/**
+ * convert a template string to a normal string.
+ * example:
+ * ```ts
+ * const name = 'world';
+ * const str = templateToString`hello ${name}!`;
+ * // str = 'hello world!'
+ *
+ * @param template
+ * @param expressions
+ * @returns
+ */
+function templateToString(template, ...expressions) {
+    const merged = [];
+    for (let i = 0; i < template.length; i++) {
+        merged.push(template[i]);
+        merged.push(expressions[i]);
+    }
+    return merged.join('');
+}
+//# sourceMappingURL=strings.js.map

package/dist/strings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strings.js","sourceRoot":"","sources":["../src/strings.ts"],"names":[],"mappings":";;AAAA,wBAOC;AAcD,4CASC;AA9BD,SAAgB,MAAM,CAAC,GAAW;IACjC,IAAI,CAAC;QACJ,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACZ,OAAO,KAAK,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,gBAAgB,CAAC,QAA8B,EAAE,GAAG,WAAiC;IACpG,MAAM,MAAM,GAAG,EAAE,CAAC;IAElB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxB,CAAC"}

package/dist/time/time.d.ts

@@ -0,0 +1,189 @@
+export declare const MAX_JS_DATE = 8640000000000000;
+/** in millis */
+export declare const millis = 1;
+/** in millis */
+export declare const second: number;
+/** in millis */
+export declare const minute: number;
+/** in millis */
+export declare const hour: number;
+/** in millis */
+export declare const day: number;
+/** in millis */
+export declare const week: number;
+/**
+ * In millis
+ * The average month is 365/12 = 30.42 days in a regular year and 366/12 = 30.50 days in a leap year. The Gregorian (western) solar calendar has 365.2425/12 = 30.436875 days on the average, varying between 28 and 31 days.
+ */
+export declare const solarYear: number;
+/** in millis */
+export declare const month: number;
+/** in millis */
+export declare const year: number;
+/** 366 days */
+export declare const leapYear: number;
+/** 29 days */
+export declare const leapFebruary: number;
+/** in millis */
+export declare const january: number;
+/** in millis */
+export declare const february: number;
+/** in millis */
+export declare const march: number;
+/** in millis */
+export declare const april: number;
+/** in millis */
+export declare const may: number;
+/** in millis */
+export declare const june: number;
+/** in millis */
+export declare const july: number;
+/** in millis */
+export declare const august: number;
+/** in millis */
+export declare const september: number;
+/** in millis */
+export declare const october: number;
+/** in millis */
+export declare const november: number;
+/** in millis */
+export declare const december: number;
+export declare const months: number[];
+export declare const leapMonths: number[];
+export interface Duration {
+    years?: number;
+    months?: number;
+    weeks?: number;
+    days?: number;
+    hours?: number;
+    minutes?: number;
+    seconds?: number;
+    milliseconds?: number;
+}
+export interface Interval {
+    start?: Date;
+    end?: Date;
+}
+/**
+ * parse a duration into millisecconds
+ *
+ * @example
+ * ```js
+ * durationToMilliSeconds({seconds:1}) // => 1000
+ * durationToMilliSeconds({minutes:1}) // => 60_000
+ * durationToMilliSeconds({hours:1}) // => 3_600_000
+ * durationToMilliSeconds({minutes:1,seconds:1}) // => 61_000
+ * durationToMilliSeconds({hours:1,minutes:1,seconds:1}) // => 3_661_000
+ * ```
+ */
+export declare function durationToMilliSeconds(duration: Duration): number;
+export declare function millisecondsToDuration(millis: number): Duration;
+/**
+ * parse a duration into millisecconds
+ *
+ * @example
+ * ```js
+ * durationToMilliSeconds({seconds:1}) // => 1
+ * durationToMilliSeconds({minutes:1}) // => 60
+ * durationToMilliSeconds({hours:1}) // => 3_600
+ * durationToMilliSeconds({minutes:1,seconds:1}) // => 61
+ * durationToMilliSeconds({hours:1,minutes:1,seconds:1}) // => 3_661
+ * ```
+ */
+export declare function durationToSeconds(duration: Duration): number;
+/**
+ * check if the duration is larger than the interval
+ */
+export declare function isDurationBiggerThanInterval(interval: Interval, duration: Duration): boolean;
+/**
+ * divide the given interval into smaller intervals, each having the duration equal to the given duration
+ *
+ * @example
+ * ```js
+ * const start=new Date('2000-01-01');
+ * const end=new Date('2000-01-10');
+ *
+ * splitIntervalByDuration({start, end},{days:1});
+ * // [
+ * //   {start:2000-01-01, end:2000-01-02},
+ * //   {start:2000-01-02, end:2000-01-03},
+ * //   {start:2000-01-03, end:2000-01-04},
+ * //   {start:2000-01-04, end:2000-01-05},
+ * //   {start:2000-01-05, end:2000-01-06},
+ * //   {start:2000-01-06, end:2000-01-07},
+ * //   {start:2000-01-07, end:2000-01-08},
+ * //   {start:2000-01-08, end:2000-01-09},
+ * //   {start:2000-01-09, end:2000-01-10},
+ * // ]
+ * ```
+ */
+export declare function splitIntervalByDuration(interval: Interval, duration: Duration): Interval[];
+/**
+ * multiply the given duration
+ *
+ * @example
+ * ```js
+ * const duration={moths:2, days:3, hours:4};
+ *
+ * multiplyDuration(duration:Duration,multiplier:number) // => {moths:4, days:6, hours:8}
+ * ```
+ */
+export declare function multiplyDuration(duration: Duration, multiplier: number): Duration;
+/**
+ * add the given durations
+ *
+ * @example
+ * ```js
+ * const duration1={moths:2, days:3, hours:4};
+ * const duration2={moths:2, days:3, hours:4};
+ * const duration3={moths:2, days:3, hours:4};
+ *
+ * addDurations(duration1,duration2,duration3) // => {moths:6, days:9, hours:12}
+ * ```
+ */
+export declare function addDurations(...durations: Duration[]): Duration;
+export declare function isValidDate(value: any): value is Date;
+/**
+ * Format a date into sql datetime value
+ * @param date
+ * @returns
+ *  * @example
+ * ```js
+ * const date = new Date();
+ * toSqlDate() // => "2017-06-29 17:54:04"
+ *
+ */
+export declare function toSqlDate(date: Date): string;
+/**
+ * Convert an interval to a duration
+ * @param interval
+ * @returns
+ *
+ * @example
+ * ```ts
+ * const interval = { start: new Date('2000-01-01'), end: new Date('2000-01-10') };
+ * const duration = IntervalToDuration(interval);
+ * // { years: 0, months: 0, weeks: 0, days: 9, hours: 0, minutes: 0, seconds: 0, milliseconds: 0 }
+ * ```
+ */
+export declare function intervalToDuration(interval: Interval): Duration;
+/**
+ * Humanize a duration object into a human-readable string.
+ * @example
+ * ```js
+ * const duration = { years: 1, months: 2, days: 3, hours: 4, minutes: 5, seconds: 6 };
+ * humanizeDuration(duration) // => "1 year, 2 months, 3 days, 4 hours, 5 minutes and 6 seconds"
+ * ```
+ *  * @example
+ * ```js
+ * const duration = { seconds: 4000 };
+ * humanizeDuration(duration) // => "1 hour, 6 minutes and 40 seconds"
+ * ```
+ * @param inDuration
+ * @param options
+ * @returns
+ */
+export declare function humanizeDuration(inDuration: Duration, options?: {
+    reduce?: boolean;
+}): string;
+//# sourceMappingURL=time.d.ts.map

package/dist/time/time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../src/time/time.ts"],"names":[],"mappings":"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"}