@dereekb/util 0.0.1 → 1.0.0

package/src/lib/number.d.ts

@@ -16,3 +16,16 @@ export declare function roundToPrecision(value: number, precision: number): numb
  * @returns Step that contains the value.
  */
 export declare function roundNumberUpToStep(value: number, step: number): number;
+export declare type RandomNumberFunction = () => number;
+export interface MakeRandomFunction {
+    min?: number;
+    max: number;
+}
+export declare type MakeRandomFunctionInput = number | MakeRandomFunction;
+/**
+ * Used to generate a RandomNumberFunction that returns a number between the input and the maximum.
+ *
+ * @param maxOrArgs
+ * @returns
+ */
+export declare function makeRandomFunction(maxOrArgs: MakeRandomFunctionInput): RandomNumberFunction;

package/src/lib/number.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.roundNumberUpToStep = exports.roundToPrecision = void 0;
+exports.makeRandomFunction = exports.roundNumberUpToStep = exports.roundToPrecision = void 0;
 // MARK: Number/Math
 /**
  * Rounds the input number to the given precision.
@@ -26,4 +26,22 @@ function roundNumberUpToStep(value, step) {
     return Math.ceil(value / step) * step;
 }
 exports.roundNumberUpToStep = roundNumberUpToStep;
+/**
+ * Used to generate a RandomNumberFunction that returns a number between the input and the maximum.
+ *
+ * @param maxOrArgs
+ * @returns
+ */
+function makeRandomFunction(maxOrArgs) {
+    const config = (typeof maxOrArgs === 'number') ? { min: 0, max: maxOrArgs } : maxOrArgs;
+    const { min, max } = config;
+    if (min != null) {
+        const range = max - min;
+        return () => (Math.random() * range) + min;
+    }
+    else {
+        return () => Math.random() * max;
+    }
+}
+exports.makeRandomFunction = makeRandomFunction;
 //# sourceMappingURL=number.js.map

package/src/lib/number.js.map

@@ -1 +1 @@
-{"version":3,"file":"number.js","sourceRoot":"","sources":["../../../../../packages/util/src/lib/number.ts"],"names":[],"mappings":";;;AACA,oBAAoB;AACpB;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAAC,KAAa,EAAE,SAAiB;IAC/D,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAC5E,CAAC;AAFD,4CAEC;AAED;;;;;;;;GAQG;AACH,SAAgB,mBAAmB,CAAC,KAAa,EAAE,IAAY;IAC7D,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;AACxC,CAAC;AAFD,kDAEC"}
+{"version":3,"file":"number.js","sourceRoot":"","sources":["../../../../../packages/util/src/lib/number.ts"],"names":[],"mappings":";;;AAEA,oBAAoB;AACpB;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAAC,KAAa,EAAE,SAAiB;IAC/D,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAC5E,CAAC;AAFD,4CAEC;AAED;;;;;;;;GAQG;AACH,SAAgB,mBAAmB,CAAC,KAAa,EAAE,IAAY;IAC7D,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;AACxC,CAAC;AAFD,kDAEC;AAYD;;;;;GAKG;AACH,SAAgB,kBAAkB,CAAC,SAAkC;IACnE,MAAM,MAAM,GAAuB,CAAC,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5G,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC;IAE5B,IAAI,GAAG,IAAI,IAAI,EAAE;QACf,MAAM,KAAK,GAAG,GAAG,GAAG,GAAG,CAAC;QACxB,OAAO,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC;KAC5C;SAAM;QACL,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC;KAClC;AACH,CAAC;AAVD,gDAUC"}

package/src/lib/object/object.d.ts

@@ -1,12 +1,62 @@
 import { FieldOfType } from "../key";
+import { Maybe } from "../value";
+export declare function objectHasKey<T, K extends keyof T = keyof T>(obj: T, key: K): boolean;
+export declare function objectHasKey<T>(obj: T, key: string): boolean;
 export declare function applyToMultipleFields<T extends object>(value: any, fields: FieldOfType<T>[]): Partial<T>;
 export declare function mapToObject<T, K extends PropertyKey>(map: Map<K, T>): {
     [key: string]: T;
 };
+export interface FilterFromPOJO<T extends object> {
+    copy?: boolean;
+    filter?: Omit<FilterKeyValueTuples<T>, 'inverse'>;
+}
 /**
- * Removes all undefined values from the input POJO. Will only remove undefined, and not null, etc.
+ * Removes values, per the the filter config, from the input object.
  *
  * @param obj POJO to remove undefined values from.
- * @param copy Whether or not to return a copy with all non-
+ * @param copy Whether or not to return a copy of the input object. Default is true.
  */
-export declare function removeUndefinedFromPOJO<T extends object = object>(obj: T, copy?: boolean): T;
+export declare function filterFromPOJO<T extends object = object>(obj: T, { copy, filter }?: FilterFromPOJO<T>): T;
+export declare function assignValuesToPOJO<T extends object = object>(target: T, obj: T, filter?: FilterKeyValueTuplesInput<T>): T;
+export declare type KeyValueTuple<T extends object = object, K extends keyof T = keyof T> = [K, T[K]];
+export declare enum KeyValueTypleValueFilter {
+    NONE = 0,
+    UNDEFINED = 1,
+    NULL = 2,
+    FALSY = 3
+}
+export declare type ForEachKeyValueFunction<T extends object = object, K extends keyof T = keyof T> = (tuple: KeyValueTuple<T, K>, index: number) => void;
+export interface ForEachKeyValue<T extends object = object, K extends keyof T = keyof T> {
+    filter?: FilterKeyValueTuplesInput<T, K>;
+    forEach: ForEachKeyValueFunction<T, K>;
+}
+export declare function forEachKeyValue<T extends object = object, K extends keyof T = keyof T>(obj: T, { forEach, filter }: ForEachKeyValue<T, K>): void;
+export declare function toKeyValueTuples<T extends object = object, K extends keyof T = keyof T>(obj: T, filter?: FilterKeyValueTuplesInput<T, K>): KeyValueTuple<T, K>[];
+export declare type FilterKeyValueTuplesInput<T extends object = object, K extends keyof T = keyof T> = KeyValueTypleValueFilter | FilterKeyValueTuples<T, K>;
+export interface FilterKeyValueTuples<T extends object = object, K extends keyof T = keyof T> {
+    valueFilter?: KeyValueTypleValueFilter;
+    invertFilter?: boolean;
+    keysFilter?: K[];
+}
+export declare function filterKeyValueTuplesFn<T extends object = object, K extends keyof T = keyof T>(input: FilterKeyValueTuplesInput<T, K>): (tuples: KeyValueTuple<T, K>) => boolean;
+/**
+ * Recursively function that returns true if the input is not an object or if every key on the object is empty.
+ *
+ * @param obj
+ */
+export declare function objectIsEmpty<T extends object>(obj: Maybe<T>): boolean;
+/**
+ * Merges all input objects into one. The order of overrides is kept, so the right-most item in the array will have priority over all objects before it.
+ *
+ * @param objects
+ */
+export declare function mergeObjects<T extends object>(objects: Maybe<Partial<T>>[], filter?: FilterKeyValueTuples<T>): Partial<T>;
+/**
+ * Assigns all undefined valeus from one or more objects into the target object.
+ *
+ * @param object
+ */
+export declare function overrideInObject<T extends object>(target: Partial<T>, { from, filter }: {
+    from: Partial<T>[];
+    filter?: FilterKeyValueTuples<T>;
+}): Partial<T>;

package/src/lib/object/object.js

@@ -1,6 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.removeUndefinedFromPOJO = exports.mapToObject = exports.applyToMultipleFields = void 0;
+exports.overrideInObject = exports.mergeObjects = exports.objectIsEmpty = exports.filterKeyValueTuplesFn = exports.toKeyValueTuples = exports.forEachKeyValue = exports.KeyValueTypleValueFilter = exports.assignValuesToPOJO = exports.filterFromPOJO = exports.mapToObject = exports.applyToMultipleFields = exports.objectHasKey = void 0;
+const value_1 = require("../value");
+const array_value_1 = require("../array/array.value");
+const filter_1 = require("../filter/filter");
+function objectHasKey(obj, key) {
+    return Object.prototype.hasOwnProperty.call(obj, key);
+}
+exports.objectHasKey = objectHasKey;
 function applyToMultipleFields(value, fields) {
     const result = {};
     fields.forEach((field) => {
@@ -18,21 +25,126 @@ function mapToObject(map) {
 }
 exports.mapToObject = mapToObject;
 /**
- * Removes all undefined values from the input POJO. Will only remove undefined, and not null, etc.
+ * Removes values, per the the filter config, from the input object.
  *
  * @param obj POJO to remove undefined values from.
- * @param copy Whether or not to return a copy with all non-
+ * @param copy Whether or not to return a copy of the input object. Default is true.
  */
-function removeUndefinedFromPOJO(obj, copy) {
+function filterFromPOJO(obj, { copy = false, filter = { valueFilter: KeyValueTypleValueFilter.UNDEFINED } } = {}) {
     if (copy) {
         obj = Object.assign({}, obj);
     }
-    Object.keys(obj).forEach((key) => {
-        if (obj[key] === undefined) {
+    forEachKeyValue(obj, {
+        filter: Object.assign(Object.assign({}, filter), { invertFilter: !filter.invertFilter }),
+        forEach: ([key]) => {
             delete obj[key];
         }
     });
     return obj;
 }
-exports.removeUndefinedFromPOJO = removeUndefinedFromPOJO;
+exports.filterFromPOJO = filterFromPOJO;
+function assignValuesToPOJO(target, obj, filter = KeyValueTypleValueFilter.UNDEFINED) {
+    forEachKeyValue(obj, {
+        filter,
+        forEach: ([key, value]) => {
+            target[key] = value;
+        }
+    });
+    return obj;
+}
+exports.assignValuesToPOJO = assignValuesToPOJO;
+var KeyValueTypleValueFilter;
+(function (KeyValueTypleValueFilter) {
+    KeyValueTypleValueFilter[KeyValueTypleValueFilter["NONE"] = 0] = "NONE";
+    KeyValueTypleValueFilter[KeyValueTypleValueFilter["UNDEFINED"] = 1] = "UNDEFINED";
+    KeyValueTypleValueFilter[KeyValueTypleValueFilter["NULL"] = 2] = "NULL";
+    KeyValueTypleValueFilter[KeyValueTypleValueFilter["FALSY"] = 3] = "FALSY";
+})(KeyValueTypleValueFilter = exports.KeyValueTypleValueFilter || (exports.KeyValueTypleValueFilter = {}));
+function forEachKeyValue(obj, { forEach, filter }) {
+    const keyValues = toKeyValueTuples(obj, filter);
+    keyValues.forEach(forEach);
+}
+exports.forEachKeyValue = forEachKeyValue;
+function toKeyValueTuples(obj, filter) {
+    let pairs = Object.entries(obj);
+    if (filter) {
+        const filterFn = filterKeyValueTuplesFn(filter);
+        pairs = pairs.filter(filterFn);
+    }
+    return pairs;
+}
+exports.toKeyValueTuples = toKeyValueTuples;
+function filterKeyValueTuplesFn(input) {
+    const filter = (typeof input === 'object') ? input : { valueFilter: input };
+    const { valueFilter: type, invertFilter: inverseFilter, keysFilter } = filter;
+    let filterFn;
+    switch (type) {
+        case KeyValueTypleValueFilter.UNDEFINED:
+            filterFn = ([_, x]) => x !== undefined;
+            break;
+        case KeyValueTypleValueFilter.NULL:
+            filterFn = ([_, x]) => x != null;
+            break;
+        case KeyValueTypleValueFilter.FALSY:
+            filterFn = ([_, x]) => Boolean(x);
+            break;
+        case KeyValueTypleValueFilter.NONE:
+        default:
+            filterFn = () => true;
+            break;
+    }
+    if (keysFilter) {
+        const filterByTypeFn = filterFn;
+        const keysSet = new Set(keysFilter);
+        filterFn = (x) => filterByTypeFn(x) && keysSet.has(x[0]);
+    }
+    return (0, filter_1.invertFilter)(filterFn, inverseFilter);
+}
+exports.filterKeyValueTuplesFn = filterKeyValueTuplesFn;
+/**
+ * Recursively function that returns true if the input is not an object or if every key on the object is empty.
+ *
+ * @param obj
+ */
+function objectIsEmpty(obj) {
+    if (obj != null && typeof obj === 'object') {
+        const keys = Object.keys(obj);
+        if (keys.length > 0) {
+            for (let i = 0; i < keys.length; i += 1) {
+                const key = keys[i];
+                const value = obj[key];
+                const isEmpty = (typeof obj === 'object') ? objectIsEmpty(value) : !(0, value_1.hasValueOrNotEmpty)(value);
+                if (!isEmpty) {
+                    return false;
+                }
+            }
+        }
+    }
+    return true;
+}
+exports.objectIsEmpty = objectIsEmpty;
+/**
+ * Merges all input objects into one. The order of overrides is kept, so the right-most item in the array will have priority over all objects before it.
+ *
+ * @param objects
+ */
+function mergeObjects(objects, filter) {
+    let object = {};
+    overrideInObject(object, { from: (0, array_value_1.filterMaybeValues)(objects), filter });
+    return object;
+}
+exports.mergeObjects = mergeObjects;
+/**
+ * Assigns all undefined valeus from one or more objects into the target object.
+ *
+ * @param object
+ */
+function overrideInObject(target, { from, filter }) {
+    from.forEach(((x) => {
+        const relevantValues = filterFromPOJO(Object.assign({}, x), { filter, copy: false });
+        Object.assign(target, relevantValues);
+    }));
+    return target;
+}
+exports.overrideInObject = overrideInObject;
 //# sourceMappingURL=object.js.map

package/src/lib/object/object.js.map

@@ -1 +1 @@
-{"version":3,"file":"object.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/object/object.ts"],"names":[],"mappings":";;;AAEA,SAAgB,qBAAqB,CAAmB,KAAU,EAAE,MAAwB;IAC1F,MAAM,MAAM,GAAQ,EAAE,CAAC;IAEvB,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACvB,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;IACxB,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AARD,sDAQC;AAED,SAAgB,WAAW,CAA2B,GAAc;IAClE,MAAM,MAAM,GAAG,EAAS,CAAC;IAEzB,GAAG,CAAC,OAAO,CAAC,CAAC,CAAI,EAAE,GAAM,EAAE,EAAE;QAC3B,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AARD,kCAQC;AAGD;;;;;GAKG;AACH,SAAgB,uBAAuB,CAA4B,GAAM,EAAE,IAAc;IACvF,IAAI,IAAI,EAAE;QACR,GAAG,qBACE,GAAG,CACP,CAAC;KACH;IAED,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,GAAW,EAAE,EAAE;QACvC,IAAK,GAAW,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE;YACnC,OAAQ,GAAW,CAAC,GAAG,CAAC,CAAC;SAC1B;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC;AAdD,0DAcC"}
+{"version":3,"file":"object.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/object/object.ts"],"names":[],"mappings":"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"}

package/src/lib/page/page.filter.d.ts

@@ -14,7 +14,7 @@ export interface PageAndFilter<F> extends OptionalFilter<F> {
 }
 export interface FilteredPageIterateFn<T> {
     /**
-     * Uses each model one-by-one.
+     * Uses each value one-by-one.
      */
     use?: IterateFn<T>;
     /**

package/src/lib/promise/index.d.ts

@@ -1,2 +1,4 @@
+export * from './poll';
 export * from './promise';
 export * from './promise.loop';
+export * from './wait';

package/src/lib/promise/index.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
+(0, tslib_1.__exportStar)(require("./poll"), exports);
 (0, tslib_1.__exportStar)(require("./promise"), exports);
 (0, tslib_1.__exportStar)(require("./promise.loop"), exports);
+(0, tslib_1.__exportStar)(require("./wait"), exports);
 //# sourceMappingURL=index.js.map

package/src/lib/promise/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/promise/index.ts"],"names":[],"mappings":";;;AAAA,yDAA0B;AAC1B,8DAA+B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/promise/index.ts"],"names":[],"mappings":";;;AAAA,sDAAuB;AACvB,yDAA0B;AAC1B,8DAA+B;AAC/B,sDAAuB"}

package/src/lib/promise/poll.d.ts

@@ -0,0 +1,18 @@
+export interface PollConfig {
+    /**
+     * How long to wait between polling checks in ms.
+     */
+    wait?: number;
+    /**
+     * Checks to see the poll has been met.
+     */
+    check: () => boolean;
+    /**
+     * Max number of times to poll before giving up.
+     */
+    timesToGiveup?: number;
+}
+/**
+ * Polls every number of ms to check that a condition has been met.
+ */
+export declare function poll({ check, wait, timesToGiveup }: PollConfig): Promise<void>;

package/src/lib/promise/poll.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.poll = void 0;
+const util_1 = require("@dereekb/util");
+const wait_1 = require("./wait");
+/**
+ * Polls every number of ms to check that a condition has been met.
+ */
+function poll({ check, wait = 250, timesToGiveup = Number.MAX_SAFE_INTEGER }) {
+    return (0, util_1.performTaskLoop)({
+        next: (i) => (i > 0) ? (0, wait_1.waitForMs)(wait) : Promise.resolve(),
+        checkContinue: (_, i) => !check() && timesToGiveup > i
+    });
+}
+exports.poll = poll;
+//# sourceMappingURL=poll.js.map

package/src/lib/promise/poll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"poll.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/promise/poll.ts"],"names":[],"mappings":";;;AAAA,wCAAgD;AAChD,iCAAmC;AAiBnC;;GAEG;AACH,SAAgB,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,GAAG,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC,gBAAgB,EAAc;IAC7F,OAAO,IAAA,sBAAe,EAAC;QACrB,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAA,gBAAS,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE;QAC1D,aAAa,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,aAAa,GAAG,CAAC;KACvD,CAAC,CAAC;AACL,CAAC;AALD,oBAKC"}

package/src/lib/promise/promise.d.ts

@@ -38,5 +38,4 @@ export declare class PromiseUtility {
     static performTasks<T, K = any>(input: T[], taskFn: PromiseTaskFn<T, K>, config?: PerformTasksConfig<T>): Promise<PerformTasksResult<T, K>>;
     static performTask<O>(taskFn: () => Promise<O>, config?: PerformTaskConfig<0>): Promise<PerformTaskResult<O>>;
     static _performTask<I, O>(value: I, taskFn: PromiseTaskFn<I, O>, { throwError, retriesAllowed, retryWait, beforeRetry }?: PerformTaskConfig<I>): Promise<[I, O, boolean]>;
-    static wait(ms: number): Promise<void>;
 }

package/src/lib/promise/promise.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PromiseUtility = void 0;
 const tslib_1 = require("tslib");
+const wait_1 = require("./wait");
 class PromiseUtility {
     // MARK: Run
     /**
@@ -91,7 +92,7 @@ class PromiseUtility {
                             });
                         }
                         ;
-                        return (retryWait) ? PromiseUtility.wait(retryWait).then(() => doNextTry()) : doNextTry();
+                        return (retryWait) ? (0, wait_1.waitForMs)(retryWait).then(() => doNextTry()) : doNextTry();
                     }
                     else {
                         // Error out.
@@ -107,11 +108,6 @@ class PromiseUtility {
             return iterateTask(value, 0);
         });
     }
-    static wait(ms, value) {
-        return (0, tslib_1.__awaiter)(this, void 0, void 0, function* () {
-            return new Promise(resolve => setTimeout(resolve, ms, value));
-        });
-    }
 }
 exports.PromiseUtility = PromiseUtility;
 //# sourceMappingURL=promise.js.map

package/src/lib/promise/promise.js.map

@@ -1 +1 @@
-{"version":3,"file":"promise.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/promise/promise.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"promise.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/promise/promise.ts"],"names":[],"mappings":";;;;AACA,iCAAmC;AAkCnC,MAAa,cAAc;IAEzB,YAAY;IACZ;;OAEG;IACH,MAAM,CAAO,eAAe,CAAI,MAAwB,EAAE,MAA2B;;YACnF,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,kCAC1C,MAAM,KACT,UAAU,EAAE,IAAI,IAChB,CAAC;YAEH,OAAO,KAAK,CAAC;QACf,CAAC;KAAA;IAED,gBAAgB;IAChB;;;;OAIG;IACH,MAAM,CAAO,YAAY,CAAa,KAAU,EAAE,MAA2B,EAAE,SAAgC,EAAE,UAAU,EAAE,IAAI,EAAE;;YACjI,IAAI,WAA8B,CAAC;YAEnC,IAAI,MAAM,CAAC,UAAU,EAAE;gBACrB,WAAW,GAAG,EAAE,CAAC;gBACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE;oBACxC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;oBACvB,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;oBAC5E,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;iBAC9B;aACF;iBAAM;gBACL,WAAW,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;aAC3G;YAED,MAAM,QAAQ,GAAQ,EAAE,CAAC;YACzB,MAAM,MAAM,GAAQ,EAAE,CAAC;YACvB,MAAM,OAAO,GAAa,EAAE,CAAC;YAE7B,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;gBACxB,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBAErB,IAAI,OAAO,EAAE;oBACX,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;oBACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;iBAC5B;qBAAM;oBACL,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;iBACnB;YACH,CAAC,CAAC,CAAC;YAEH,OAAO;gBACL,QAAQ;gBACR,MAAM;gBACN,OAAO;aACR,CAAC;QACJ,CAAC;KAAA;IAED,MAAM,CAAO,WAAW,CAAI,MAAwB,EAAE,MAA6B;;YACjF,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,MAAM,cAAc,CAAC,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC;YACzF,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QAC5B,CAAC;KAAA;IAED,MAAM,CAAO,YAAY,CAAO,KAAQ,EAAE,MAA2B,EAAE,EAAE,UAAU,EAAE,cAAc,GAAG,CAAC,EAAE,SAAS,GAAG,GAAG,EAAE,WAAW,KAA2B,EAAE,UAAU,EAAE,IAAI,EAAE;;YAElL,SAAe,OAAO,CAAC,KAAQ,EAAE,SAAiB;;oBAChD,IAAI;wBACF,MAAM,MAAM,GAAM,MAAM,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;wBACjD,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;qBACvB;oBAAC,OAAO,CAAC,EAAE;wBACV,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;qBACnB;gBACH,CAAC;aAAA;YAED,SAAe,WAAW,CAAC,KAAQ,EAAE,SAAiB;;oBACpD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;oBAC/C,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;oBAE1B,IAAI,OAAO,EAAE;wBACX,OAAO,CAAC,KAAK,EAAE,GAAG,MAAM,CAAC,CAAC;qBAC3B;oBAED,MAAM,gBAAgB,GAAG,cAAc,GAAG,SAAS,CAAC;oBAEpD,IAAI,gBAAgB,GAAG,CAAC,EAAE;wBACxB,SAAe,SAAS;;gCACtB,MAAM,aAAa,GAAG,SAAS,GAAG,CAAC,CAAC;gCAEpC,IAAI,WAAW,EAAE;oCACf,MAAM,WAAW,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;iCACzC;gCAED,OAAO,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC;4BAC3C,CAAC;yBAAA;wBAAA,CAAC;wBAEF,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAA,gBAAS,EAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;qBACjF;yBAAM;wBACL,aAAa;wBACb,IAAI,UAAU,EAAE;4BACd,MAAM,MAAM,CAAC,CAAC,CAAC,CAAC;yBACjB;6BAAM;4BACL,OAAO,CAAC,KAAK,EAAE,SAAgB,EAAE,KAAK,CAAC,CAAC;yBACzC;qBACF;gBACH,CAAC;aAAA;YAED,OAAO,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC/B,CAAC;KAAA;CAEF;AA5GD,wCA4GC"}

package/src/lib/promise/promise.loop.d.ts

@@ -8,5 +8,6 @@ export interface PerformTaskLoopWithInitConfig<O> {
     next: (i: number, prev: O) => Promise<O>;
     checkContinue: (prev: O, i: number) => boolean;
 }
+export declare function performTaskLoop(config: PerformTaskLoopConfig<void>): Promise<void>;
 export declare function performTaskLoop<O>(config: PerformTaskLoopConfig<O>): Promise<Maybe<O>>;
 export declare function performTaskLoop<O>(config: PerformTaskLoopWithInitConfig<O>): Promise<O>;

package/src/lib/promise/promise.loop.js.map

@@ -1 +1 @@
-{"version":3,"file":"promise.loop.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/promise/promise.loop.ts"],"names":[],"mappings":";;;;AAgBA,SAAgB,eAAe,CAAI,MAAW;IAC5C,OAAO,IAAI,OAAO,CAAI,CAAO,OAAO,EAAE,MAAM,EAAE,EAAE;QAC9C,IAAI;YACF,IAAI,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,IAAI,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;YAEvF,IAAI,SAAS,EAAE;gBACb,IAAI,CAAC,GAAG,CAAC,CAAC;gBACV,IAAI,SAAS,GAAa,MAAM,CAAC,SAAS,CAAC;gBAC3C,IAAI,KAAc,CAAC;gBAEnB,GAAG;oBACD,SAAS,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;oBAC5C,CAAC,IAAI,CAAC,CAAC;oBACP,KAAK,GAAG,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;iBAC5C,QAAQ,KAAK,EAAE;gBAEhB,OAAO,CAAC,SAAU,CAAC,CAAC;aACrB;iBAAM;gBACL,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;aAC3B;SACF;QAAC,OAAO,CAAC,EAAE;YACV,MAAM,CAAC,CAAC,CAAC,CAAC;SACX;IACH,CAAC,CAAA,CAAC,CAAC;AACL,CAAC;AAxBD,0CAwBC"}
+{"version":3,"file":"promise.loop.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/promise/promise.loop.ts"],"names":[],"mappings":";;;;AAiBA,SAAgB,eAAe,CAAI,MAAW;IAC5C,OAAO,IAAI,OAAO,CAAI,CAAO,OAAO,EAAE,MAAM,EAAE,EAAE;QAC9C,IAAI;YACF,IAAI,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,IAAI,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;YAEvF,IAAI,SAAS,EAAE;gBACb,IAAI,CAAC,GAAG,CAAC,CAAC;gBACV,IAAI,SAAS,GAAa,MAAM,CAAC,SAAS,CAAC;gBAC3C,IAAI,KAAc,CAAC;gBAEnB,GAAG;oBACD,SAAS,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;oBAC5C,CAAC,IAAI,CAAC,CAAC;oBACP,KAAK,GAAG,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;iBAC5C,QAAQ,KAAK,EAAE;gBAEhB,OAAO,CAAC,SAAU,CAAC,CAAC;aACrB;iBAAM;gBACL,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;aAC3B;SACF;QAAC,OAAO,CAAC,EAAE;YACV,MAAM,CAAC,CAAC,CAAC,CAAC;SACX;IACH,CAAC,CAAA,CAAC,CAAC;AACL,CAAC;AAxBD,0CAwBC"}

package/src/lib/promise/wait.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Waits a certain number of ms before resolving the promise.
+ *
+ * @param ms
+ */
+export declare function waitForMs(ms: number): Promise<void>;

package/src/lib/promise/wait.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.waitForMs = void 0;
+const tslib_1 = require("tslib");
+function waitForMs(ms, value) {
+    return (0, tslib_1.__awaiter)(this, void 0, void 0, function* () {
+        return new Promise(resolve => setTimeout(resolve, ms, value));
+    });
+}
+exports.waitForMs = waitForMs;
+//# sourceMappingURL=wait.js.map

package/src/lib/promise/wait.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/promise/wait.ts"],"names":[],"mappings":";;;;AAOA,SAAsB,SAAS,CAAI,EAAU,EAAE,KAAS;;QACtD,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;IAChE,CAAC;CAAA;AAFD,8BAEC"}

package/src/lib/string.d.ts

@@ -11,6 +11,7 @@ export declare function caseInsensitiveString(input: undefined): undefined;
 export declare function caseInsensitiveString(input: Maybe<string>): Maybe<string>;
 export declare function splitCommaSeparatedString(input: CommaSeparatedString<string>): string[];
 export declare function splitCommaSeparatedString<T = any>(input: CommaSeparatedString<T>, mapFn: MapStringFn<T>): T[];
+export declare function splitCommaSeparatedStringToSet(input: Maybe<CommaSeparatedString>): Set<string>;
 /**
  * Adds a plus prefix to the input value and converts it to a string. If the value is negative or 0, no prefix is added.
  *

package/src/lib/string.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.addPlusPrefixToNumber = exports.splitCommaSeparatedString = exports.caseInsensitiveString = void 0;
+exports.addPlusPrefixToNumber = exports.splitCommaSeparatedStringToSet = exports.splitCommaSeparatedString = exports.caseInsensitiveString = void 0;
 function caseInsensitiveString(input) {
     return input === null || input === void 0 ? void 0 : input.toLocaleLowerCase();
 }
@@ -10,6 +10,10 @@ function splitCommaSeparatedString(input, mapFn = (x) => x) {
     return splits.map(x => mapFn(x.trim()));
 }
 exports.splitCommaSeparatedString = splitCommaSeparatedString;
+function splitCommaSeparatedStringToSet(input) {
+    return new Set(input != null ? splitCommaSeparatedString(input) : []);
+}
+exports.splitCommaSeparatedStringToSet = splitCommaSeparatedStringToSet;
 /**
  * Adds a plus prefix to the input value and converts it to a string. If the value is negative or 0, no prefix is added.
  *

package/src/lib/string.js.map

@@ -1 +1 @@
-{"version":3,"file":"string.js","sourceRoot":"","sources":["../../../../../packages/util/src/lib/string.ts"],"names":[],"mappings":";;;AAaA,SAAgB,qBAAqB,CAAC,KAAU;IAC9C,OAAO,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,iBAAiB,EAAE,CAAC;AACpC,CAAC;AAFD,sDAEC;AAID,SAAgB,yBAAyB,CAAU,KAA8B,EAAE,QAAwB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAQ;IACxH,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAC1C,CAAC;AAHD,8DAGC;AAED;;;;GAIG;AACH,SAAgB,qBAAqB,CAAC,KAAqB,EAAE,MAAM,GAAG,GAAG;IACvE,IAAI,KAAK,IAAI,IAAI,EAAE;QACjB,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC;KACvD;SAAM;QACL,OAAO,SAAS,CAAC;KAClB;AACH,CAAC;AAND,sDAMC"}
+{"version":3,"file":"string.js","sourceRoot":"","sources":["../../../../../packages/util/src/lib/string.ts"],"names":[],"mappings":";;;AAaA,SAAgB,qBAAqB,CAAC,KAAU;IAC9C,OAAO,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,iBAAiB,EAAE,CAAC;AACpC,CAAC;AAFD,sDAEC;AAID,SAAgB,yBAAyB,CAAU,KAA8B,EAAE,QAAwB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAQ;IACxH,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAC1C,CAAC;AAHD,8DAGC;AAED,SAAgB,8BAA8B,CAAC,KAAkC;IAC/E,OAAO,IAAI,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACxE,CAAC;AAFD,wEAEC;AAED;;;;GAIG;AACH,SAAgB,qBAAqB,CAAC,KAAqB,EAAE,MAAM,GAAG,GAAG;IACvE,IAAI,KAAK,IAAI,IAAI,EAAE;QACjB,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC;KACvD;SAAM;QACL,OAAO,SAAS,CAAC;KAClB;AACH,CAAC;AAND,sDAMC"}

package/src/lib/tree/index.d.ts

@@ -0,0 +1,4 @@
+export * from './tree';
+export * from './tree.expand';
+export * from './tree.flatten';
+export * from './tree.array';

package/src/lib/tree/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+(0, tslib_1.__exportStar)(require("./tree"), exports);
+(0, tslib_1.__exportStar)(require("./tree.expand"), exports);
+(0, tslib_1.__exportStar)(require("./tree.flatten"), exports);
+(0, tslib_1.__exportStar)(require("./tree.array"), exports);
+//# sourceMappingURL=index.js.map

package/src/lib/tree/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/tree/index.ts"],"names":[],"mappings":";;;AAAA,sDAAuB;AACvB,6DAA8B;AAC9B,8DAA+B;AAC/B,4DAA6B"}

package/src/lib/tree/tree.array.d.ts

@@ -0,0 +1,15 @@
+import { TreeNode } from "./tree";
+import { ExpandTreeFunction } from "./tree.expand";
+import { FlattenTreeFunction } from './tree.flatten';
+/**
+ * Function that expands the input values into a tree, and then flattens the tree to produce a single array of values of another type.
+ */
+export declare type ExpandFlattenTreeFunction<T, V> = (values: T[]) => V[];
+/**
+ * Creates an ExpandFlattenTree function.
+ *
+ * @param expand
+ * @param flatten
+ * @returns
+ */
+export declare function expandFlattenTreeFunction<T, V, N extends TreeNode<T, N> = TreeNode<T, any>>(expand: ExpandTreeFunction<T, N>, flatten: FlattenTreeFunction<N, V>): ExpandFlattenTreeFunction<T, V>;

package/src/lib/tree/tree.array.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.expandFlattenTreeFunction = void 0;
+const tree_expand_1 = require("./tree.expand");
+const tree_flatten_1 = require("./tree.flatten");
+/**
+ * Creates an ExpandFlattenTree function.
+ *
+ * @param expand
+ * @param flatten
+ * @returns
+ */
+function expandFlattenTreeFunction(expand, flatten) {
+    return (values) => {
+        return (0, tree_flatten_1.flattenTrees)((0, tree_expand_1.expandTrees)(values, expand), flatten);
+    };
+}
+exports.expandFlattenTreeFunction = expandFlattenTreeFunction;
+//# sourceMappingURL=tree.array.js.map

package/src/lib/tree/tree.array.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.array.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/tree/tree.array.ts"],"names":[],"mappings":";;;AACA,+CAAgE;AAChE,iDAAmE;AAOnE;;;;;;GAMG;AACH,SAAgB,yBAAyB,CAAoD,MAAgC,EAAE,OAAkC;IAC/J,OAAO,CAAC,MAAW,EAAE,EAAE;QACrB,OAAO,IAAA,2BAAY,EAAC,IAAA,yBAAW,EAAC,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC,CAAA;AACH,CAAC;AAJD,8DAIC"}

package/src/lib/tree/tree.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Represends a traversable tree with values of type T.
+ */
+export interface TreeNode<T, N extends TreeNode<T, N> = TreeNode<T, any>> {
+    depth: number;
+    value: T;
+    parent?: N;
+    children?: N[];
+}
+/**
+ * A TreeNode with no children values available. Used when building a tree.
+ */
+export declare type TreeNodeWithoutChildren<T, N extends TreeNode<T, N> = TreeNode<T, any>> = Omit<TreeNode<T, N>, 'children'>;

package/src/lib/tree/tree.expand.d.ts

@@ -0,0 +1,40 @@
+import { TreeNode, TreeNodeWithoutChildren } from "./tree";
+import { Maybe } from "../value";
+/**
+ * ExpandTreeFunction configuration.
+ */
+export interface ExpandTree<T> {
+    /**
+     * Returns child values from the value, if they exist.
+     * @param value
+     */
+    getChildren(value: T): Maybe<T[]>;
+}
+/**
+ * Extended ExpandTree configuration with custom node building.
+ */
+export interface ExpandTreeWithNodeBuilder<T, N extends TreeNode<T, N>> extends ExpandTree<T> {
+    /**
+     * Creates a TreeNode of type N, minus the children values that are attached afterwards.
+     */
+    makeNode: (node: TreeNodeWithoutChildren<T, N>) => Omit<N, 'children'>;
+}
+/**
+ * Expands the input value into a TreeNode.
+ */
+export declare type ExpandTreeFunction<T, N extends TreeNode<T, N> = TreeNode<T, any>> = (value: T) => N;
+/**
+ * Creates an ExpandTreeFunction from the input configuration.
+ *
+ * @param config
+ */
+export declare function expandTreeFunction<T>(config: ExpandTree<T>): ExpandTreeFunction<T, TreeNode<T>>;
+export declare function expandTreeFunction<T, N extends TreeNode<T, N>>(config: ExpandTreeWithNodeBuilder<T, N>): ExpandTreeFunction<T, N>;
+/**
+ * Convenience function for expanding multiple values into trees then merging them together into a single array.
+ *
+ * @param values
+ * @param expandFn
+ * @returns
+ */
+export declare function expandTrees<T, N extends TreeNode<T, N>>(values: T[], expandFn: ExpandTreeFunction<T, N>): N[];

package/src/lib/tree/tree.expand.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.expandTrees = exports.expandTreeFunction = void 0;
+;
+function expandTreeFunction(config) {
+    var _a;
+    const makeNode = (_a = config.makeNode) !== null && _a !== void 0 ? _a : ((node) => node);
+    const expandFn = (value, parent) => {
+        const depth = (parent) ? parent.depth + 1 : 0;
+        const treeNode = {
+            depth,
+            parent,
+            value
+        };
+        const node = makeNode(treeNode);
+        const childrenValues = config.getChildren(value);
+        node.children = (childrenValues) ? childrenValues.map(x => expandFn(x, node)) : undefined;
+        return node;
+    };
+    return (root) => expandFn(root);
+}
+exports.expandTreeFunction = expandTreeFunction;
+/**
+ * Convenience function for expanding multiple values into trees then merging them together into a single array.
+ *
+ * @param values
+ * @param expandFn
+ * @returns
+ */
+function expandTrees(values, expandFn) {
+    return values.map(expandFn);
+}
+exports.expandTrees = expandTrees;
+//# sourceMappingURL=tree.expand.js.map