@dereekb/util 0.0.1

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

@@ -0,0 +1,9 @@
+import { ArrayOrValue } from "../array";
+/**
+ * Convenience function for objectMergeMatrix that returns a flat array.
+ */
+export declare function objectFlatMergeMatrix<A extends object = object, B extends object = object>(a: ArrayOrValue<Partial<A>>, b: ArrayOrValue<Partial<B>>): (Partial<A> & Partial<B>)[];
+/**
+ * Creates a matrix of results by merging the input. If either a or b is null/undefined, the result is returned as an array of the other value.
+ */
+export declare function objectMergeMatrix<A extends object = object, B extends object = object>(a: ArrayOrValue<Partial<A>>, b: ArrayOrValue<Partial<B>>): (Partial<A> & Partial<B>)[][];

package/src/lib/object/object.array.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.objectMergeMatrix = exports.objectFlatMergeMatrix = void 0;
+const array_1 = require("../array");
+/**
+ * Convenience function for objectMergeMatrix that returns a flat array.
+ */
+function objectFlatMergeMatrix(a, b) {
+    return (0, array_1.flattenArray)(objectMergeMatrix(a, b));
+}
+exports.objectFlatMergeMatrix = objectFlatMergeMatrix;
+/**
+ * Creates a matrix of results by merging the input. If either a or b is null/undefined, the result is returned as an array of the other value.
+ */
+function objectMergeMatrix(a, b) {
+    if (a && b) {
+        const aNorm = (0, array_1.convertToArray)(a);
+        const bNorm = (0, array_1.convertToArray)(b);
+        const results = aNorm.map((a) => {
+            return bNorm.map(b => (Object.assign(Object.assign({}, a), b)));
+        });
+        return results;
+    }
+    else if (a) {
+        return [(0, array_1.convertToArray)(a)];
+    }
+    else if (b) {
+        return [(0, array_1.convertToArray)(b)];
+    }
+    else {
+        return [[]];
+    }
+}
+exports.objectMergeMatrix = objectMergeMatrix;
+//# sourceMappingURL=object.array.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"object.array.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/object/object.array.ts"],"names":[],"mappings":";;;AAAA,oCAAsE;AAEtE;;GAEG;AACH,SAAgB,qBAAqB,CAAuD,CAA2B,EAAE,CAA2B;IAClJ,OAAO,IAAA,oBAAY,EAAC,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAC/C,CAAC;AAFD,sDAEC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAAuD,CAA2B,EAAE,CAA2B;IAC9I,IAAI,CAAC,IAAI,CAAC,EAAE;QACV,MAAM,KAAK,GAAG,IAAA,sBAAc,EAAC,CAAC,CAAC,CAAC;QAChC,MAAM,KAAK,GAAG,IAAA,sBAAc,EAAC,CAAC,CAAC,CAAC;QAEhC,MAAM,OAAO,GAAkC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC7D,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,iCAAM,CAAC,GAAK,CAAC,EAAG,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC;KAChB;SAAM,IAAI,CAAC,EAAE;QACZ,OAAO,CAAC,IAAA,sBAAc,EAAC,CAAC,CAAO,CAAC,CAAC;KAClC;SAAM,IAAI,CAAC,EAAE;QACZ,OAAO,CAAC,IAAA,sBAAc,EAAC,CAAC,CAAO,CAAC,CAAC;KAClC;SAAM;QACL,OAAO,CAAC,EAAE,CAAC,CAAC;KACb;AACH,CAAC;AAjBD,8CAiBC"}

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

@@ -0,0 +1,12 @@
+import { FieldOfType } from "../key";
+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;
+};
+/**
+ * Removes all undefined values from the input POJO. Will only remove undefined, and not null, etc.
+ *
+ * @param obj POJO to remove undefined values from.
+ * @param copy Whether or not to return a copy with all non-
+ */
+export declare function removeUndefinedFromPOJO<T extends object = object>(obj: T, copy?: boolean): T;

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

@@ -0,0 +1,4 @@
+/**
+ * Performs a deep comparison to check if all values on the input filters are equal.
+ */
+export declare function areEqualObjectValues<F>(a: F, b: F): boolean;

package/src/lib/object/object.equal.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.areEqualObjectValues = void 0;
+const lodash_1 = require("lodash");
+/**
+ * Performs a deep comparison to check if all values on the input filters are equal.
+ */
+function areEqualObjectValues(a, b) {
+    return (0, lodash_1.isEqual)(a, b);
+}
+exports.areEqualObjectValues = areEqualObjectValues;
+//# sourceMappingURL=object.equal.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"object.equal.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/object/object.equal.ts"],"names":[],"mappings":";;;AAAA,mCAAiC;AAEjC;;GAEG;AACH,SAAgB,oBAAoB,CAAI,CAAI,EAAE,CAAI;IAChD,OAAO,IAAA,gBAAO,EAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACvB,CAAC;AAFD,oDAEC"}

package/src/lib/object/object.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeUndefinedFromPOJO = exports.mapToObject = exports.applyToMultipleFields = void 0;
+function applyToMultipleFields(value, fields) {
+    const result = {};
+    fields.forEach((field) => {
+        result[field] = value;
+    });
+    return result;
+}
+exports.applyToMultipleFields = applyToMultipleFields;
+function mapToObject(map) {
+    const object = {};
+    map.forEach((x, key) => {
+        object[key] = x;
+    });
+    return object;
+}
+exports.mapToObject = mapToObject;
+/**
+ * Removes all undefined values from the input POJO. Will only remove undefined, and not null, etc.
+ *
+ * @param obj POJO to remove undefined values from.
+ * @param copy Whether or not to return a copy with all non-
+ */
+function removeUndefinedFromPOJO(obj, copy) {
+    if (copy) {
+        obj = Object.assign({}, obj);
+    }
+    Object.keys(obj).forEach((key) => {
+        if (obj[key] === undefined) {
+            delete obj[key];
+        }
+    });
+    return obj;
+}
+exports.removeUndefinedFromPOJO = removeUndefinedFromPOJO;
+//# sourceMappingURL=object.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,3 @@
+export * from './page';
+export * from './page.calculator';
+export * from './page.filter';

package/src/lib/page/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+(0, tslib_1.__exportStar)(require("./page"), exports);
+(0, tslib_1.__exportStar)(require("./page.calculator"), exports);
+(0, tslib_1.__exportStar)(require("./page.filter"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/page/index.ts"],"names":[],"mappings":";;;AAAA,sDAAuB;AACvB,iEAAkC;AAClC,6DAA8B"}

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

@@ -0,0 +1,24 @@
+import { Page } from "./page";
+export interface PageCalculatorConfig {
+    pageSize: number;
+    limitKey?: string;
+    skipKey?: string;
+}
+/**
+ * Page calcuaktion context for calculating the amount to skip/etc.
+ */
+export declare class PageCalculator {
+    readonly pageSize: number;
+    readonly limitKey: string;
+    readonly skipKey: string;
+    constructor(config: PageCalculatorConfig);
+    get limit(): number;
+    calcWithPage(page?: Page): {
+        [x: string]: number;
+    };
+    calc(page?: number): {
+        [x: string]: number;
+    };
+    calcSkipWithPage(page?: Page): number;
+    calcSkip(page?: number): number;
+}

package/src/lib/page/page.calculator.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PageCalculator = void 0;
+/**
+ * Page calcuaktion context for calculating the amount to skip/etc.
+ */
+class PageCalculator {
+    constructor(config) {
+        var _a, _b;
+        this.pageSize = config.pageSize;
+        if (!this.pageSize) {
+            throw new Error('Page size is required.');
+        }
+        this.limitKey = (_a = config.limitKey) !== null && _a !== void 0 ? _a : 'limit';
+        this.skipKey = (_b = config.skipKey) !== null && _b !== void 0 ? _b : 'skip';
+    }
+    get limit() {
+        return this.pageSize;
+    }
+    calcWithPage(page) {
+        return this.calc(page === null || page === void 0 ? void 0 : page.page);
+    }
+    calc(page = 0) {
+        return {
+            [this.limitKey]: this.pageSize,
+            [this.skipKey]: this.calcSkip(page)
+        };
+    }
+    calcSkipWithPage(page) {
+        return this.calcSkip(page === null || page === void 0 ? void 0 : page.page);
+    }
+    calcSkip(page = 0) {
+        return (page !== null && page !== void 0 ? page : 0) * this.pageSize;
+    }
+}
+exports.PageCalculator = PageCalculator;
+//# sourceMappingURL=page.calculator.js.map

package/src/lib/page/page.calculator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.calculator.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/page/page.calculator.ts"],"names":[],"mappings":";;;AASA;;GAEG;AACH,MAAa,cAAc;IAMzB,YAAY,MAA4B;;QACtC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAEhC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE;YAClB,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;SAC3C;QAED,IAAI,CAAC,QAAQ,GAAG,MAAA,MAAM,CAAC,QAAQ,mCAAI,OAAO,CAAC;QAC3C,IAAI,CAAC,OAAO,GAAG,MAAA,MAAM,CAAC,OAAO,mCAAI,MAAM,CAAC;IAC1C,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,YAAY,CAAC,IAAW;QACtB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,CAAC,OAAe,CAAC;QACnB,OAAO;YACL,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,QAAQ;YAC9B,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;SACpC,CAAC;IACJ,CAAC;IAED,gBAAgB,CAAC,IAAW;QAC1B,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,QAAQ,CAAC,OAAe,CAAC;QACvB,OAAO,CAAC,IAAI,aAAJ,IAAI,cAAJ,IAAI,GAAI,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;IACrC,CAAC;CAEF;AAxCD,wCAwCC"}

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

@@ -0,0 +1,28 @@
+import { Maybe } from "../value";
+/**
+ * Page value used when no list items have been loaded.
+ */
+export declare const UNLOADED_PAGE = -1;
+/**
+ * The first page of results.
+ */
+export declare const FIRST_PAGE = 0;
+/**
+ * Page value used when there are no elements left to load.
+ */
+export declare const FINAL_PAGE = -2;
+export declare type PageNumber = number;
+/**
+ * Represents a page number.
+ */
+export interface Page {
+    /**
+     * Current page number.
+     *
+     * // TODO: Rename to pageNumber
+     */
+    page: PageNumber;
+}
+export declare function getPageNumber(page: Maybe<Page>): number;
+export declare function getNextPageNumber(page: Maybe<Page>): number;
+export declare function isFinalPage(page: Maybe<Page>): boolean;

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

@@ -0,0 +1,54 @@
+import { Filter, OptionalFilter } from '../filter';
+import { Page } from '../page';
+import { IterateFn, IteratePageFn } from '../iterate';
+/**
+ * Represents a page number with a filter.
+ */
+export interface FilteredPage<F> extends Page, OptionalFilter<F> {
+}
+/**
+ * An object that has a Page and a Filter.
+ */
+export interface PageAndFilter<F> extends OptionalFilter<F> {
+    page: Page;
+}
+export interface FilteredPageIterateFn<T> {
+    /**
+     * Uses each model one-by-one.
+     */
+    use?: IterateFn<T>;
+    /**
+     * Uses the entire page of results at once.
+     */
+    usePage?: IteratePageFn<T>;
+}
+/**
+ * Creates a FilteredPage.
+ *
+ * @param page
+ * @param request
+ * @returns
+ */
+export declare function filteredPage<F = any>(page: number, request?: Filter<F>): FilteredPage<F>;
+/**
+ * Iterates using a delegate function sequentially.
+ *
+ * @param inputPage
+ * @param loadFn
+ * @param iterFn
+ * @returns
+ */
+export declare function iterateFilteredPages<T, F>(inputPage: FilteredPage<F>, loadFn: (page: FilteredPage<F>) => Promise<T[]>, iterFn: FilteredPageIterateFn<T>): Promise<number>;
+/**
+ * @deprecated
+ */
+export declare class FilteredPageUtility {
+    static page<F = any>(page: number, request?: FilteredPage<F>): {
+        page: number;
+        filter: {} & F;
+    };
+    static filter<F = any>(filter: F, request?: FilteredPage<F>): {
+        page: number | undefined;
+        filter: {} & F;
+    };
+}

package/src/lib/page/page.filter.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilteredPageUtility = exports.iterateFilteredPages = exports.filteredPage = void 0;
+const tslib_1 = require("tslib");
+const iterate_1 = require("../iterate");
+/**
+ * Creates a FilteredPage.
+ *
+ * @param page
+ * @param request
+ * @returns
+ */
+function filteredPage(page, request) {
+    return {
+        page,
+        filter: (request === null || request === void 0 ? void 0 : request.filter) ? Object.assign({}, request.filter) : undefined
+    };
+}
+exports.filteredPage = filteredPage;
+/**
+ * Iterates using a delegate function sequentially.
+ *
+ * @param inputPage
+ * @param loadFn
+ * @param iterFn
+ * @returns
+ */
+function iterateFilteredPages(inputPage, loadFn, iterFn) {
+    var _a, _b;
+    return (0, tslib_1.__awaiter)(this, void 0, void 0, function* () {
+        let currentPage = (_a = inputPage === null || inputPage === void 0 ? void 0 : inputPage.page) !== null && _a !== void 0 ? _a : 0;
+        let hasMore = true;
+        let count = 0;
+        if (!iterFn.use && !iterFn.usePage) {
+            throw new Error('Neither use nor usePage was specified.');
+        }
+        const useFn = (_b = iterFn.usePage) !== null && _b !== void 0 ? _b : ((values) => (0, iterate_1.iterate)(values, iterFn.use));
+        while (hasMore) {
+            const page = filteredPage(currentPage, inputPage);
+            const values = yield loadFn(page);
+            yield useFn(values);
+            count += values.length;
+            currentPage += 1;
+            hasMore = values.length > 0;
+        }
+        return count;
+    });
+}
+exports.iterateFilteredPages = iterateFilteredPages;
+/**
+ * @deprecated
+ */
+class FilteredPageUtility {
+    static page(page, request) {
+        return {
+            page,
+            filter: Object.assign({}, request === null || request === void 0 ? void 0 : request.filter)
+        };
+    }
+    static filter(filter, request) {
+        return {
+            page: request === null || request === void 0 ? void 0 : request.page,
+            filter: Object.assign({}, request === null || request === void 0 ? void 0 : request.filter, filter)
+        };
+    }
+}
+exports.FilteredPageUtility = FilteredPageUtility;
+//# sourceMappingURL=page.filter.js.map

package/src/lib/page/page.filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.filter.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/page/page.filter.ts"],"names":[],"mappings":";;;;AAEA,wCAA+D;AAyB/D;;;;;;GAMG;AACH,SAAgB,YAAY,CAAU,IAAY,EAAE,OAAmB;IACrE,OAAO;QACL,IAAI;QACJ,MAAM,EAAE,CAAC,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAM,CAAC,CAAC,CAAC,mBAAM,OAAO,CAAC,MAAM,EAAG,CAAC,CAAC,SAAS;KAC9D,CAAC;AACJ,CAAC;AALD,oCAKC;AAGD;;;;;;;GAOG;AACH,SAAsB,oBAAoB,CAAO,SAA0B,EAAE,MAA+C,EAAE,MAAgC;;;QAC5J,IAAI,WAAW,GAAG,MAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,IAAI,mCAAI,CAAC,CAAC;QACvC,IAAI,OAAO,GAAG,IAAI,CAAC;QACnB,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE;YAClC,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;SAC3D;QAED,MAAM,KAAK,GAAG,MAAA,MAAM,CAAC,OAAO,mCAAI,CAAC,CAAC,MAAW,EAAE,EAAE,CAAC,IAAA,iBAAO,EAAC,MAAM,EAAE,MAAM,CAAC,GAAI,CAAC,CAAC,CAAC;QAEhF,OAAO,OAAO,EAAE;YACd,MAAM,IAAI,GAAG,YAAY,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;YAClD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;YAElC,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC;YAEpB,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC;YACvB,WAAW,IAAI,CAAC,CAAC;YACjB,OAAO,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;SAC7B;QAED,OAAO,KAAK,CAAC;;CACd;AAvBD,oDAuBC;AAGD;;GAEG;AACH,MAAa,mBAAmB;IAE9B,MAAM,CAAC,IAAI,CAAU,IAAY,EAAE,OAAyB;QAC1D,OAAO;YACL,IAAI;YACJ,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAM,CAAC;SAC3C,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,MAAM,CAAU,MAAS,EAAE,OAAyB;QACzD,OAAO;YACL,IAAI,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,IAAI;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAM,EAAE,MAAM,CAAC;SACnD,CAAC;IACJ,CAAC;CAEF;AAhBD,kDAgBC"}

package/src/lib/page/page.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isFinalPage = exports.getNextPageNumber = exports.getPageNumber = exports.FINAL_PAGE = exports.FIRST_PAGE = exports.UNLOADED_PAGE = void 0;
+/**
+ * Page value used when no list items have been loaded.
+ */
+exports.UNLOADED_PAGE = -1;
+/**
+ * The first page of results.
+ */
+exports.FIRST_PAGE = 0;
+/**
+ * Page value used when there are no elements left to load.
+ */
+exports.FINAL_PAGE = -2;
+// MARK: Utility
+function getPageNumber(page) {
+    var _a;
+    return (_a = page === null || page === void 0 ? void 0 : page.page) !== null && _a !== void 0 ? _a : exports.UNLOADED_PAGE;
+}
+exports.getPageNumber = getPageNumber;
+function getNextPageNumber(page) {
+    return (getPageNumber(page) + 1);
+}
+exports.getNextPageNumber = getNextPageNumber;
+function isFinalPage(page) {
+    return (page === null || page === void 0 ? void 0 : page.page) === exports.FINAL_PAGE;
+}
+exports.isFinalPage = isFinalPage;
+//# sourceMappingURL=page.js.map

package/src/lib/page/page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/page/page.ts"],"names":[],"mappings":";;;AAEA;;GAEG;AACU,QAAA,aAAa,GAAG,CAAC,CAAC,CAAC;AAEhC;;GAEG;AACU,QAAA,UAAU,GAAG,CAAC,CAAC;AAE5B;;GAEG;AACU,QAAA,UAAU,GAAG,CAAC,CAAC,CAAC;AAkB7B,gBAAgB;AAChB,SAAgB,aAAa,CAAC,IAAiB;;IAC7C,OAAO,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,IAAI,mCAAI,qBAAa,CAAC;AACrC,CAAC;AAFD,sCAEC;AAED,SAAgB,iBAAiB,CAAC,IAAiB;IACjD,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACnC,CAAC;AAFD,8CAEC;AAED,SAAgB,WAAW,CAAC,IAAiB;IAC3C,OAAO,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,IAAI,MAAK,kBAAU,CAAC;AACnC,CAAC;AAFD,kCAEC"}

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

@@ -0,0 +1,2 @@
+export * from './promise';
+export * from './promise.loop';

package/src/lib/promise/index.js

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

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

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

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

@@ -0,0 +1,42 @@
+import { Maybe } from "../value";
+export declare type PromiseTaskFn<T, K = any> = (value: T, tryNumber?: number) => Promise<K>;
+export interface PerformTaskResult<O> {
+    value: Maybe<O>;
+    success: boolean;
+}
+export interface PerformTasksResult<T, K> {
+    succeded: T[];
+    failed: T[];
+    results: [T, K][];
+}
+export interface PerformTaskConfig<T = any> {
+    throwError?: boolean;
+    retriesAllowed?: number;
+    retryWait?: number;
+    /**
+     * Optional function to use before a retry.
+     */
+    beforeRetry?: (value: T, tryNumber?: number) => void | Promise<void>;
+}
+export declare type ValueTaskConfig<T = any> = Omit<PerformTaskConfig<T>, 'throwError'>;
+export interface PerformTasksConfig<T = any> extends PerformTaskConfig<T> {
+    /**
+     * Whether or not tasks are performed sequentially or if tasks are all done in "parellel".
+     */
+    sequential?: boolean;
+}
+export declare class PromiseUtility {
+    /**
+     * Runs the task using the input config, and returns the value. Is always configured to throw the error if it fails.
+     */
+    static runTaskForValue<O>(taskFn: () => Promise<O>, config?: ValueTaskConfig<0>): Promise<Maybe<O>>;
+    /**
+     * Performs the input tasks, and will retry tasks if they fail, up to a certain point.
+     *
+     * This is useful for retrying sections that may experience optimistic concurrency collisions.
+     */
+    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

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromiseUtility = void 0;
+const tslib_1 = require("tslib");
+class PromiseUtility {
+    // MARK: Run
+    /**
+     * Runs the task using the input config, and returns the value. Is always configured to throw the error if it fails.
+     */
+    static runTaskForValue(taskFn, config) {
+        return (0, tslib_1.__awaiter)(this, void 0, void 0, function* () {
+            const { value } = yield this.performTask(taskFn, Object.assign(Object.assign({}, config), { throwError: true }));
+            return value;
+        });
+    }
+    // MARK: Perform
+    /**
+     * Performs the input tasks, and will retry tasks if they fail, up to a certain point.
+     *
+     * This is useful for retrying sections that may experience optimistic concurrency collisions.
+     */
+    static performTasks(input, taskFn, config = { throwError: true }) {
+        return (0, tslib_1.__awaiter)(this, void 0, void 0, function* () {
+            let taskResults;
+            if (config.sequential) {
+                taskResults = [];
+                for (let i = 0; i < input.length; i += 1) {
+                    const value = input[i];
+                    const taskResult = yield PromiseUtility._performTask(value, taskFn, config);
+                    taskResults.push(taskResult);
+                }
+            }
+            else {
+                taskResults = yield Promise.all(input.map((value) => PromiseUtility._performTask(value, taskFn, config)));
+            }
+            const succeded = [];
+            const failed = [];
+            const results = [];
+            taskResults.forEach((x) => {
+                const success = x[2];
+                if (success) {
+                    succeded.push(x[0]);
+                    results.push([x[0], x[1]]);
+                }
+                else {
+                    failed.push(x[0]);
+                }
+            });
+            return {
+                succeded,
+                failed,
+                results
+            };
+        });
+    }
+    static performTask(taskFn, config) {
+        return (0, tslib_1.__awaiter)(this, void 0, void 0, function* () {
+            const [_, value, success] = yield PromiseUtility._performTask(0, () => taskFn(), config);
+            return { value, success };
+        });
+    }
+    static _performTask(value, taskFn, { throwError, retriesAllowed = 5, retryWait = 200, beforeRetry } = { throwError: true }) {
+        return (0, tslib_1.__awaiter)(this, void 0, void 0, function* () {
+            function tryTask(value, tryNumber) {
+                return (0, tslib_1.__awaiter)(this, void 0, void 0, function* () {
+                    try {
+                        const result = yield taskFn(value, tryNumber);
+                        return [result, true];
+                    }
+                    catch (e) {
+                        return [e, false];
+                    }
+                });
+            }
+            function iterateTask(value, tryNumber) {
+                return (0, tslib_1.__awaiter)(this, void 0, void 0, function* () {
+                    const result = yield tryTask(value, tryNumber);
+                    const success = result[1];
+                    if (success) {
+                        return [value, ...result];
+                    }
+                    const retriesRemaining = retriesAllowed - tryNumber;
+                    if (retriesRemaining > 0) {
+                        function doNextTry() {
+                            return (0, tslib_1.__awaiter)(this, void 0, void 0, function* () {
+                                const nextTryNumber = tryNumber + 1;
+                                if (beforeRetry) {
+                                    yield beforeRetry(value, nextTryNumber);
+                                }
+                                return iterateTask(value, tryNumber + 1);
+                            });
+                        }
+                        ;
+                        return (retryWait) ? PromiseUtility.wait(retryWait).then(() => doNextTry()) : doNextTry();
+                    }
+                    else {
+                        // Error out.
+                        if (throwError) {
+                            throw result[0];
+                        }
+                        else {
+                            return [value, undefined, false];
+                        }
+                    }
+                });
+            }
+            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

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

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

@@ -0,0 +1,12 @@
+import { Maybe } from "../value";
+export interface PerformTaskLoopConfig<O> {
+    next: (i: number, prev: Maybe<O>) => Promise<O>;
+    checkContinue: (prev: Maybe<O>, i: number) => boolean;
+}
+export interface PerformTaskLoopWithInitConfig<O> {
+    initValue: O;
+    next: (i: number, prev: O) => Promise<O>;
+    checkContinue: (prev: O, i: number) => boolean;
+}
+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

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.performTaskLoop = void 0;
+const tslib_1 = require("tslib");
+function performTaskLoop(config) {
+    return new Promise((resolve, reject) => (0, tslib_1.__awaiter)(this, void 0, void 0, function* () {
+        try {
+            let startLoop = config.initValue == null || config.checkContinue(config.initValue, -1);
+            if (startLoop) {
+                let i = 0;
+                let prevValue = config.initValue;
+                let check;
+                do {
+                    prevValue = yield config.next(i, prevValue);
+                    i += 1;
+                    check = config.checkContinue(prevValue, i);
+                } while (check);
+                resolve(prevValue);
+            }
+            else {
+                resolve(config.initValue);
+            }
+        }
+        catch (e) {
+            reject(e);
+        }
+    }));
+}
+exports.performTaskLoop = performTaskLoop;
+//# sourceMappingURL=promise.loop.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1 @@
+export * from './relation';

package/src/lib/relation/index.js

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