@dereekb/util 7.8.0 → 7.10.0

package/CHANGELOG.md

@@ -2,6 +2,36 @@
 
 This file was generated using [@jscutlery/semver](https://github.com/jscutlery/semver).
 
+# [7.10.0](https://github.com/dereekb/dbx-components/compare/v7.9.0-dev...v7.10.0) (2022-06-11)
+
+
+### Features
+
+* added firestoreIdBatchVerifierFactory() ([182f086](https://github.com/dereekb/dbx-components/commit/182f086f80671fa38ed1268a6c98854f114ba629))
+* added idBatchFactory() ([b39510b](https://github.com/dereekb/dbx-components/commit/b39510b7b617e927da48efe03b3121f74fe192e8))
+
+
+
+# [7.9.0](https://github.com/dereekb/dbx-components/compare/v7.8.1-dev...v7.9.0) (2022-06-11)
+
+
+### Features
+
+* added arrayFactory() ([5a7ef13](https://github.com/dereekb/dbx-components/commit/5a7ef13116ebbacd8b7a9502e3298fd30708f944))
+* added makeWithFactory() ([4a6f4a0](https://github.com/dereekb/dbx-components/commit/4a6f4a01a04e7800653bc942fe56b27ec457813e))
+* added performBatchLoop() ([7c6c947](https://github.com/dereekb/dbx-components/commit/7c6c9475eacfd3cc7f153ef949fef1187925a8cb))
+
+
+
+## [7.8.1](https://github.com/dereekb/dbx-components/compare/v7.8.0-dev...v7.8.1) (2022-06-10)
+
+
+### Bug Fixes
+
+* useAsync typings fixes with Maybe ([68f38a4](https://github.com/dereekb/dbx-components/commit/68f38a46559e48c61e8449622e69f2e610aeb1b4))
+
+
+
 # [7.8.0](https://github.com/dereekb/dbx-components/compare/v7.7.0-dev...v7.8.0) (2022-06-09)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/util",
-  "version": "7.8.0",
+  "version": "7.10.0",
   "type": "commonjs",
   "exports": {
     ".": {

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

@@ -0,0 +1,32 @@
+import { Factory, FactoryWithIndex, FactoryWithRequiredInput } from '../getter/getter';
+import { AsyncMapFunction } from '../value/map';
+/**
+ * Factory that generates multiple values given a number of items to make.
+ */
+export declare type ArrayFactory<T> = FactoryWithRequiredInput<T[], number>;
+/**
+ * Async ArrayFactory
+ */
+export declare type AsyncArrayFactory<T> = AsyncMapFunction<ArrayFactory<T>>;
+/**
+ * Factory that generates a value for each input value.
+ */
+export declare type ArrayInputFactory<I, O> = FactoryWithRequiredInput<O[], I[]>;
+/**
+ * Async ArrayInputFactory
+ */
+export declare type AsyncArrayInputFactory<I, O> = AsyncMapFunction<ArrayInputFactory<I, O>>;
+/**
+ * Creates a new ArrayFactory.
+ *
+ * @param factory
+ * @returns
+ */
+export declare function arrayFactory<T>(factory: Factory<T> | FactoryWithIndex<T>): ArrayFactory<T>;
+/**
+ * Creates a ArrayInputFactory.
+ *
+ * @param factory
+ * @returns
+ */
+export declare function arrayInputFactory<O, I>(factory: FactoryWithRequiredInput<O, I>): ArrayInputFactory<I, O>;

package/src/lib/array/array.factory.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.arrayInputFactory = exports.arrayFactory = void 0;
+const getter_1 = require("../getter/getter");
+/**
+ * Creates a new ArrayFactory.
+ *
+ * @param factory
+ * @returns
+ */
+function arrayFactory(factory) {
+    return (count) => (0, getter_1.makeWithFactory)(factory, count);
+}
+exports.arrayFactory = arrayFactory;
+/**
+ * Creates a ArrayInputFactory.
+ *
+ * @param factory
+ * @returns
+ */
+function arrayInputFactory(factory) {
+    return (input) => (0, getter_1.makeWithFactoryInput)(factory, input);
+}
+exports.arrayInputFactory = arrayInputFactory;
+//# sourceMappingURL=array.factory.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"array.factory.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/array/array.factory.ts"],"names":[],"mappings":";;;AAAA,6CAA8H;AAuB9H;;;;;GAKG;AACH,SAAgB,YAAY,CAAI,OAAyC;IACvE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAA,wBAAe,EAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AACpD,CAAC;AAFD,oCAEC;AAED;;;;;GAKG;AACH,SAAgB,iBAAiB,CAAO,OAAuC;IAC7E,OAAO,CAAC,KAAU,EAAE,EAAE,CAAC,IAAA,6BAAoB,EAAO,OAAO,EAAE,KAAK,CAAC,CAAC;AACpE,CAAC;AAFD,8CAEC"}

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

@@ -1,22 +1,32 @@
-import { MakeRandomFunctionInput, RandomNumberFunction } from '../number/random';
+import { FactoryWithInput } from '../getter';
+import { RandomNumberFactoryInput, RandomNumberFactory } from '../number/random';
 export interface MakeArray<T> {
     count: number;
-    make: (i: number) => T;
+    /**
+     * Makes an item
+     */
+    make: FactoryWithInput<T, number>;
 }
 /**
  * Makes an array of values of a certain length using a generator function.
  *
  * @param param0
  * @returns
+ *
+ * @deprecated use makeWithFactory instead.
  */
 export declare function makeArray<T>({ count, make }: MakeArray<T>): T[];
-export interface MakeArrayRandom<T> extends Omit<MakeArray<T>, 'count'> {
-    random: RandomNumberFunction | MakeRandomFunctionInput;
+export interface RandomArrayFactoryConfig<T> extends Omit<MakeArray<T>, 'count'> {
+    random: RandomNumberFactory | RandomNumberFactoryInput;
 }
+/**
+ * Creates an array of a random size and values.
+ */
+export declare type RandomArrayFactory<T> = FactoryWithInput<T[], number>;
 /**
  * Makes a function that generates arrays of a random length of a specific type.
  *
  * @param config
  * @returns
  */
-export declare function makeRandomArrayFn<T>(config: MakeArrayRandom<T>): () => T[];
+export declare function randomArrayFactory<T>(config: RandomArrayFactoryConfig<T>): RandomArrayFactory<T>;

package/src/lib/array/array.make.js

@@ -1,19 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.makeRandomArrayFn = exports.makeArray = void 0;
+exports.randomArrayFactory = exports.makeArray = void 0;
+const getter_1 = require("../getter");
 const random_1 = require("../number/random");
+const array_factory_1 = require("./array.factory");
 /**
  * Makes an array of values of a certain length using a generator function.
  *
  * @param param0
  * @returns
+ *
+ * @deprecated use makeWithFactory instead.
  */
 function makeArray({ count, make }) {
-    const array = [];
-    for (let i = 0; i < count; i += 1) {
-        array.push(make(i));
-    }
-    return array;
+    return (0, getter_1.makeWithFactory)(make, count);
 }
 exports.makeArray = makeArray;
 /**
@@ -22,9 +22,11 @@ exports.makeArray = makeArray;
  * @param config
  * @returns
  */
-function makeRandomArrayFn(config) {
-    const randomFn = typeof config.random === 'function' ? config.random : (0, random_1.makeRandomFunction)(config.random);
-    return () => makeArray({ count: Math.abs(randomFn()), make: config.make });
+function randomArrayFactory(config) {
+    const randomFn = typeof config.random === 'function' ? config.random : (0, random_1.randomNumberFactory)(config.random);
+    const nextRandomCount = () => Math.abs(randomFn());
+    const factory = (0, array_factory_1.arrayFactory)(config.make);
+    return (count = nextRandomCount()) => factory(count);
 }
-exports.makeRandomArrayFn = makeRandomArrayFn;
+exports.randomArrayFactory = randomArrayFactory;
 //# sourceMappingURL=array.make.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"array.make.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/array/array.make.ts"],"names":[],"mappings":";;;AAAA,6CAAqG;AAOrG;;;;;GAKG;AACH,SAAgB,SAAS,CAAI,EAAE,KAAK,EAAE,IAAI,EAAgB;IACxD,MAAM,KAAK,GAAQ,EAAE,CAAC;IAEtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE;QACjC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;KACrB;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AARD,8BAQC;AAMD;;;;;GAKG;AACH,SAAgB,iBAAiB,CAAI,MAA0B;IAC7D,MAAM,QAAQ,GAAG,OAAO,MAAM,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAA,2BAAkB,EAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACzG,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;AAC7E,CAAC;AAHD,8CAGC"}
+{"version":3,"file":"array.make.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/array/array.make.ts"],"names":[],"mappings":";;;AAAA,sCAAuE;AACvE,6CAAsG;AACtG,mDAA+C;AAW/C;;;;;;;GAOG;AACH,SAAgB,SAAS,CAAI,EAAE,KAAK,EAAE,IAAI,EAAgB;IACxD,OAAO,IAAA,wBAAe,EAAC,IAAkB,EAAE,KAAK,CAAC,CAAC;AACpD,CAAC;AAFD,8BAEC;AAYD;;;;;GAKG;AACH,SAAgB,kBAAkB,CAAI,MAAmC;IACvE,MAAM,QAAQ,GAAG,OAAO,MAAM,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAA,4BAAmB,EAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1G,MAAM,eAAe,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,IAAA,4BAAY,EAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1C,OAAO,CAAC,KAAK,GAAG,eAAe,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACvD,CAAC;AALD,gDAKC"}

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

@@ -2,12 +2,14 @@ import { PrimativeKey, ReadKeyFunction } from '../key';
 import { Maybe } from '../value/maybe.type';
 export declare function concatArraysUnique<T extends PrimativeKey = PrimativeKey>(...arrays: Maybe<T[]>[]): T[];
 export declare function flattenArrayUnique<T extends PrimativeKey = PrimativeKey>(array: T[][]): T[];
-export declare function unique<T extends PrimativeKey = PrimativeKey>(values: T[]): T[];
+export declare function unique<T extends PrimativeKey = PrimativeKey>(values: T[], exclude?: T[]): T[];
 export declare function findUnique<T, K extends PrimativeKey = PrimativeKey>(models: T[], readKey: ReadKeyFunction<T, K>, additionalKeys?: K[]): T[];
 /**
  * Finds unique values in the input.
+ *
+ * Can also specify additional keys to exclude.
  */
-export declare type FindUniqueFunction<T> = (input: T[]) => T[];
+export declare type FindUniqueFunction<T> = (input: T[], exclude?: T[]) => T[];
 /**
  * Creates a FindUniqueFunction.
  *

package/src/lib/array/array.unique.js

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.makeFindUniqueFunction = exports.findUnique = exports.unique = exports.flattenArrayUnique = exports.concatArraysUnique = void 0;
 const array_1 = require("./array");
+const array_value_1 = require("./array.value");
+const set_1 = require("../set/set");
 function concatArraysUnique(...arrays) {
     return unique((0, array_1.concatArrays)(...arrays));
 }
@@ -10,8 +12,12 @@ function flattenArrayUnique(array) {
     return unique((0, array_1.flattenArray)(array));
 }
 exports.flattenArrayUnique = flattenArrayUnique;
-function unique(values) {
-    return Array.from(new Set(values));
+function unique(values, exclude) {
+    const unique = new Set(values);
+    if (exclude != null && exclude.length) {
+        (0, set_1.removeFromSet)(unique, exclude);
+    }
+    return Array.from(unique);
 }
 exports.unique = unique;
 function findUnique(models, readKey, additionalKeys = []) {
@@ -34,7 +40,7 @@ exports.findUnique = findUnique;
  * @returns
  */
 function makeFindUniqueFunction(readKey, additionalKeys = []) {
-    return (input) => findUnique(input, readKey, additionalKeys);
+    return (input, exclude) => findUnique(input, readKey, exclude ? (0, array_1.mergeArrays)([(0, array_value_1.filterMaybeValues)(exclude.map(readKey)), additionalKeys]) : additionalKeys);
 }
 exports.makeFindUniqueFunction = makeFindUniqueFunction;
 //# sourceMappingURL=array.unique.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"array.unique.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/array/array.unique.ts"],"names":[],"mappings":";;;AAAA,mCAAqD;AAIrD,SAAgB,kBAAkB,CAAwC,GAAG,MAAoB;IAC/F,OAAO,MAAM,CAAC,IAAA,oBAAY,EAAC,GAAG,MAAM,CAAC,CAAC,CAAC;AACzC,CAAC;AAFD,gDAEC;AAED,SAAgB,kBAAkB,CAAwC,KAAY;IACpF,OAAO,MAAM,CAAC,IAAA,oBAAY,EAAC,KAAK,CAAC,CAAC,CAAC;AACrC,CAAC;AAFD,gDAEC;AAED,SAAgB,MAAM,CAAwC,MAAW;IACvE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AACrC,CAAC;AAFD,wBAEC;AAED,SAAgB,UAAU,CAA2C,MAAW,EAAE,OAA8B,EAAE,iBAAsB,EAAE;IACxI,MAAM,IAAI,GAAG,IAAI,GAAG,CAAW,cAAc,CAAC,CAAC;IAE/C,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACzB,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QAEvB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;YAClB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,OAAO,IAAI,CAAC;SACb;QAED,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAbD,gCAaC;AAOD;;;;;;GAMG;AACH,SAAgB,sBAAsB,CAA2C,OAA8B,EAAE,iBAAsB,EAAE;IACvI,OAAO,CAAC,KAAU,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;AACpE,CAAC;AAFD,wDAEC"}
+{"version":3,"file":"array.unique.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/array/array.unique.ts"],"names":[],"mappings":";;;AAAA,mCAAkE;AAGlE,+CAAkD;AAClD,oCAA2C;AAE3C,SAAgB,kBAAkB,CAAwC,GAAG,MAAoB;IAC/F,OAAO,MAAM,CAAC,IAAA,oBAAY,EAAC,GAAG,MAAM,CAAC,CAAC,CAAC;AACzC,CAAC;AAFD,gDAEC;AAED,SAAgB,kBAAkB,CAAwC,KAAY;IACpF,OAAO,MAAM,CAAC,IAAA,oBAAY,EAAC,KAAK,CAAC,CAAC,CAAC;AACrC,CAAC;AAFD,gDAEC;AAED,SAAgB,MAAM,CAAwC,MAAW,EAAE,OAAa;IACtF,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IAE/B,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE;QACrC,IAAA,mBAAa,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAChC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AARD,wBAQC;AAED,SAAgB,UAAU,CAA2C,MAAW,EAAE,OAA8B,EAAE,iBAAsB,EAAE;IACxI,MAAM,IAAI,GAAG,IAAI,GAAG,CAAW,cAAc,CAAC,CAAC;IAE/C,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACzB,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QAEvB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;YAClB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,OAAO,IAAI,CAAC;SACb;QAED,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAbD,gCAaC;AASD;;;;;;GAMG;AACH,SAAgB,sBAAsB,CAA2C,OAA8B,EAAE,iBAAsB,EAAE;IACvI,OAAO,CAAC,KAAU,EAAE,OAAa,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAA,mBAAW,EAAC,CAAC,IAAA,+BAAiB,EAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;AACtK,CAAC;AAFD,wDAEC"}

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

@@ -1,5 +1,6 @@
 export * from './array.boolean';
 export * from './array.filter';
+export * from './array.factory';
 export * from './array.index';
 export * from './array.limit';
 export * from './array.make';

package/src/lib/array/index.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./array.boolean"), exports);
 tslib_1.__exportStar(require("./array.filter"), exports);
+tslib_1.__exportStar(require("./array.factory"), exports);
 tslib_1.__exportStar(require("./array.index"), exports);
 tslib_1.__exportStar(require("./array.limit"), exports);
 tslib_1.__exportStar(require("./array.make"), exports);

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/array/index.ts"],"names":[],"mappings":";;;AAAA,0DAAgC;AAChC,yDAA+B;AAC/B,wDAA8B;AAC9B,wDAA8B;AAC9B,uDAA6B;AAC7B,sDAA4B;AAC5B,yDAA+B;AAC/B,sDAA4B;AAC5B,yDAA+B;AAC/B,kDAAwB;AACxB,yDAA+B;AAC/B,wDAA8B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/array/index.ts"],"names":[],"mappings":";;;AAAA,0DAAgC;AAChC,yDAA+B;AAC/B,0DAAgC;AAChC,wDAA8B;AAC9B,wDAA8B;AAC9B,uDAA6B;AAC7B,sDAA4B;AAC5B,yDAA+B;AAC/B,sDAA4B;AAC5B,yDAA+B;AAC/B,kDAAwB;AACxB,yDAA+B;AAC/B,wDAA8B"}

package/src/lib/getter/getter.d.ts

@@ -1,4 +1,6 @@
 import { PromiseOrValue } from '../promise/promise';
+import { MapFunction } from '../value/map';
+import { Maybe } from '../value/maybe.type';
 /**
  * Function that returns a value.
  */
@@ -14,7 +16,7 @@ export declare type FactoryWithInput<O, I> = (args?: I) => O;
 /**
  * Function that returns a value with a single argument.
  */
-export declare type FactoryWithRequiredInput<T, A> = (args: A) => T;
+export declare type FactoryWithRequiredInput<T, A> = MapFunction<A, T>;
 /**
  * Either a Getter, or an instance of the item.
  */
@@ -64,3 +66,10 @@ export declare function asGetter<T>(input: GetterOrValue<T>): Getter<T>;
  * @returns
  */
 export declare function makeGetter<T>(input: T): Getter<T>;
+/**
+ * A factory that can take in an index input optionally.
+ */
+export declare type FactoryWithIndex<T> = FactoryWithInput<T, number> | FactoryWithRequiredInput<T, number>;
+export declare function makeWithFactory<T>(factory: Factory<T> | FactoryWithIndex<T>, count: number): T[];
+export declare function makeWithFactoryInput<T, A>(factory: FactoryWithInput<T, A>, input: Maybe<A>[]): T[];
+export declare function makeWithFactoryInput<T, A>(factory: FactoryWithRequiredInput<T, A>, input: A[]): T[];

package/src/lib/getter/getter.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.makeGetter = exports.asGetter = exports.getValueFromGetter = exports.isGetter = void 0;
+exports.makeWithFactoryInput = exports.makeWithFactory = exports.makeGetter = exports.asGetter = exports.getValueFromGetter = exports.isGetter = void 0;
 /**
  * Returns true if the input object looks like a Getter (is a function).
  *
@@ -45,4 +45,16 @@ function makeGetter(input) {
     return () => input;
 }
 exports.makeGetter = makeGetter;
+function makeWithFactory(factory, count) {
+    const results = [];
+    for (let i = 0; i < count; i += 1) {
+        results.push(factory(i));
+    }
+    return results;
+}
+exports.makeWithFactory = makeWithFactory;
+function makeWithFactoryInput(factory, input) {
+    return input.map((x) => factory(x));
+}
+exports.makeWithFactoryInput = makeWithFactoryInput;
 //# sourceMappingURL=getter.js.map

package/src/lib/getter/getter.js.map

@@ -1 +1 @@
-{"version":3,"file":"getter.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/getter/getter.ts"],"names":[],"mappings":";;;AA4CA;;;;;GAKG;AACH,SAAgB,QAAQ,CAAc,KAAc;IAClD,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC;AACrC,CAAC;AAFD,4BAEC;AAaD,SAAgB,kBAAkB,CAAsB,KAAc,EAAE,IAAQ;IAC9E,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE;QAC/B,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC;KACpB;SAAM;QACL,OAAO,KAAU,CAAC;KACnB;AACH,CAAC;AAND,gDAMC;AAED;;;;;GAKG;AACH,SAAgB,QAAQ,CAAI,KAAuB;IACjD,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE;QAC/B,OAAO,KAAkB,CAAC;KAC3B;SAAM;QACL,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;KAC1B;AACH,CAAC;AAND,4BAMC;AAED;;;;;GAKG;AACH,SAAgB,UAAU,CAAI,KAAQ;IACpC,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC;AACrB,CAAC;AAFD,gCAEC"}
+{"version":3,"file":"getter.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/getter/getter.ts"],"names":[],"mappings":";;;AA8CA;;;;;GAKG;AACH,SAAgB,QAAQ,CAAc,KAAc;IAClD,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC;AACrC,CAAC;AAFD,4BAEC;AAaD,SAAgB,kBAAkB,CAAsB,KAAc,EAAE,IAAQ;IAC9E,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE;QAC/B,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC;KACpB;SAAM;QACL,OAAO,KAAU,CAAC;KACnB;AACH,CAAC;AAND,gDAMC;AAED;;;;;GAKG;AACH,SAAgB,QAAQ,CAAI,KAAuB;IACjD,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE;QAC/B,OAAO,KAAkB,CAAC;KAC3B;SAAM;QACL,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;KAC1B;AACH,CAAC;AAND,4BAMC;AAED;;;;;GAKG;AACH,SAAgB,UAAU,CAAI,KAAQ;IACpC,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC;AACrB,CAAC;AAFD,gCAEC;AAOD,SAAgB,eAAe,CAAI,OAAyC,EAAE,KAAa;IACzF,MAAM,OAAO,GAAQ,EAAE,CAAC;IAExB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE;QACjC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;KAC1B;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AARD,0CAQC;AAID,SAAgB,oBAAoB,CAAO,OAAuC,EAAE,KAAU;IAC5F,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AACtC,CAAC;AAFD,oDAEC"}

package/src/lib/getter/getter.util.d.ts

@@ -0,0 +1,12 @@
+import { Factory } from './getter';
+/**
+ * Returns a random value.
+ */
+export declare type RandomFromArrayFactory<T> = Factory<T>;
+/**
+ * Makes a RandomFromArrayFactory
+ *
+ * @param config
+ * @returns
+ */
+export declare function randomFromArrayFactory<T>(values: T[]): RandomFromArrayFactory<T>;

package/src/lib/getter/getter.util.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.randomFromArrayFactory = void 0;
+const random_1 = require("../number/random");
+/**
+ * Makes a RandomFromArrayFactory
+ *
+ * @param config
+ * @returns
+ */
+function randomFromArrayFactory(values) {
+    const random = (0, random_1.randomNumberFactory)({ min: 0, max: values.length - 1, round: 'floor' });
+    return () => values[random()];
+}
+exports.randomFromArrayFactory = randomFromArrayFactory;
+//# sourceMappingURL=getter.util.js.map

package/src/lib/getter/getter.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getter.util.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/getter/getter.util.ts"],"names":[],"mappings":";;;AAAA,6CAAuD;AAQvD;;;;;GAKG;AACH,SAAgB,sBAAsB,CAAI,MAAW;IACnD,MAAM,MAAM,GAAG,IAAA,4BAAmB,EAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IACvF,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;AAChC,CAAC;AAHD,wDAGC"}

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

@@ -1,4 +1,5 @@
 export * from './type';
 export * from './getter';
+export * from './getter.util';
 export * from './getter.cache';
 export * from './getter.map';

package/src/lib/getter/index.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./type"), exports);
 tslib_1.__exportStar(require("./getter"), exports);
+tslib_1.__exportStar(require("./getter.util"), exports);
 tslib_1.__exportStar(require("./getter.cache"), exports);
 tslib_1.__exportStar(require("./getter.map"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/getter/index.ts"],"names":[],"mappings":";;;AAAA,iDAAuB;AACvB,mDAAyB;AACzB,yDAA+B;AAC/B,uDAA6B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/getter/index.ts"],"names":[],"mappings":";;;AAAA,iDAAuB;AACvB,mDAAyB;AACzB,wDAA8B;AAC9B,yDAA+B;AAC/B,uDAA6B"}

package/src/lib/grouping.d.ts

@@ -42,6 +42,35 @@ export interface RestoreOrderParams<T, K extends number | string = number | stri
  * @returns
  */
 export declare function batch<T>(array: T[], batchSize: number): T[][];
+export interface BatchCount {
+    /**
+     * Total number of items to make.
+     */
+    totalItems: number;
+    /**
+     * Size of each batch/expected max number of items to create per make call.
+     */
+    itemsPerBatch: number;
+}
+export interface BatchCalc extends BatchCount {
+    batchCount: number;
+    /**
+     * Total number of full batches.
+     */
+    fullBatchCount: number;
+    /**
+     * The number of items not in a full batch.
+     */
+    remainder: number;
+}
+/**
+ * Calculates a BatchCount given the input.
+ *
+ * @param input
+ * @returns
+ */
+export declare function batchCalc(input: BatchCount): BatchCalc;
+export declare function itemCountForBatchIndex(index: number, calc: BatchCalc): number;
 /**
  * Convenience function for calling restoreOrder with two arrays of values, instead of an array of keys and array of values.
  *

package/src/lib/grouping.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.makeValuesGroupMap = exports.groupValues = exports.separateValues = exports.makeKeyPairs = exports.pairGroupValues = exports.arrayContentsDiffer = exports.restoreOrder = exports.restoreOrderWithValues = exports.batch = void 0;
+exports.makeValuesGroupMap = exports.groupValues = exports.separateValues = exports.makeKeyPairs = exports.pairGroupValues = exports.arrayContentsDiffer = exports.restoreOrder = exports.restoreOrderWithValues = exports.itemCountForBatchIndex = exports.batchCalc = exports.batch = void 0;
 const object_1 = require("./object");
 // MARK: Functions
 /**
@@ -19,6 +19,37 @@ function batch(array, batchSize) {
     return batch;
 }
 exports.batch = batch;
+/**
+ * Calculates a BatchCount given the input.
+ *
+ * @param input
+ * @returns
+ */
+function batchCalc(input) {
+    const { totalItems: total, itemsPerBatch: batchSize } = input;
+    const batchCount = Math.ceil(total / batchSize);
+    const remainder = total % batchSize;
+    const fullBatchCount = remainder ? batchCount - 1 : batchCount;
+    return {
+        totalItems: input.totalItems,
+        itemsPerBatch: input.itemsPerBatch,
+        batchCount,
+        fullBatchCount,
+        remainder
+    };
+}
+exports.batchCalc = batchCalc;
+function itemCountForBatchIndex(index, calc) {
+    let itemCount;
+    if (index < calc.fullBatchCount) {
+        itemCount = calc.itemsPerBatch;
+    }
+    else {
+        itemCount = calc.remainder;
+    }
+    return itemCount;
+}
+exports.itemCountForBatchIndex = itemCountForBatchIndex;
 /**
  * Convenience function for calling restoreOrder with two arrays of values, instead of an array of keys and array of values.
  *

package/src/lib/grouping.js.map

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

package/src/lib/model/id.batch.d.ts

@@ -0,0 +1,36 @@
+import { ArrayFactory, AsyncArrayFactory } from '../array/array.factory';
+import { FindUniqueFunction } from '../array/array.unique';
+import { AsyncMapFunction, MapFunction } from '../value/map';
+/**
+ * Used to verify each id valid and available for use.
+ */
+export declare type IdBatchVerifierFunction<T> = AsyncMapFunction<MapFunction<T[], T[]>>;
+/**
+ * Used by to verify tags have not already been taken.
+ */
+export declare type IdBatchVerifier<T> = {
+    /**
+     * Optional function to ensure uniqueness.
+     */
+    findUnique?: FindUniqueFunction<T>;
+    verify: IdBatchVerifierFunction<T>;
+    /**
+     * Max number of tags that can be verified per batch.
+     */
+    maxBatchSize: number;
+};
+export interface IdBatchFactoryConfig<T> {
+    readonly factory: ArrayFactory<T>;
+    readonly verifier: IdBatchVerifier<T>;
+}
+/**
+ * Used to generate valid, unused identifiers.
+ */
+export declare type IdBatchFactory<T> = AsyncArrayFactory<T>;
+/**
+ * Creates an IdBatchFactory
+ *
+ * @param config
+ * @returns
+ */
+export declare function idBatchFactory<T>(config: IdBatchFactoryConfig<T>): IdBatchFactory<T>;

package/src/lib/model/id.batch.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.idBatchFactory = void 0;
+const tslib_1 = require("tslib");
+const array_1 = require("../array");
+const promise_loop_1 = require("../promise/promise.loop");
+/**
+ * Creates an IdBatchFactory
+ *
+ * @param config
+ * @returns
+ */
+function idBatchFactory(config) {
+    const { factory, verifier } = config;
+    const { maxBatchSize: tagsToGeneratePerBatch, findUnique = (x) => x, verify: verifyTags } = verifier;
+    const maxUniquenessFailures = 20; // arbitrary failure point, but generally shouldn't occur with proper input.
+    return (totalTagIdentifiersToGenerate) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+        const uniquenessAccumulator = []; // used for uniqueness checks
+        function generateIdentifiersBatch(batchSize) {
+            return tslib_1.__awaiter(this, void 0, void 0, function* () {
+                let ids = [];
+                let uniquenessFailure = 0;
+                while (ids.length < batchSize) {
+                    const countToGenerate = batchSize - ids.length;
+                    let newIds = findUnique(factory(countToGenerate), uniquenessAccumulator);
+                    if (newIds.length === 0) {
+                        uniquenessFailure += 1;
+                        if (uniquenessFailure === maxUniquenessFailures) {
+                            throw new Error(`idBatchFactory failed generating unique values "${maxUniquenessFailures}" times. Factory may be insufficient for generating unique values.`);
+                        }
+                        continue;
+                    }
+                    else if (newIds.length > countToGenerate) {
+                        newIds = newIds.slice(0, countToGenerate); // ignore any extra values the generator may return.
+                    }
+                    // add to the uniqueness acumulator to prevent further usage
+                    (0, array_1.mergeIntoArray)(uniquenessAccumulator, newIds);
+                    const verifiedIds = yield verifyTags(newIds);
+                    // concat identifiers
+                    ids = ids.concat(verifiedIds);
+                    // restart loop if there are still items to be generated.
+                }
+                return ids;
+            });
+        }
+        const tagBatches = yield (0, promise_loop_1.performBatchLoop)({
+            totalItems: totalTagIdentifiersToGenerate,
+            itemsPerBatch: tagsToGeneratePerBatch,
+            make: (batchSize) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+                const result = yield generateIdentifiersBatch(batchSize);
+                return result;
+            })
+        });
+        return tagBatches.flat();
+    });
+}
+exports.idBatchFactory = idBatchFactory;
+//# sourceMappingURL=id.batch.js.map

package/src/lib/model/id.batch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.batch.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/model/id.batch.ts"],"names":[],"mappings":";;;;AAAA,oCAA0C;AAG1C,0DAA2D;AAiC3D;;;;;GAKG;AACH,SAAgB,cAAc,CAAI,MAA+B;IAC/D,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IACrC,MAAM,EAAE,YAAY,EAAE,sBAAsB,EAAE,UAAU,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,QAAQ,CAAC;IACrG,MAAM,qBAAqB,GAAG,EAAE,CAAC,CAAC,4EAA4E;IAE9G,OAAO,CAAO,6BAAqC,EAAE,EAAE;QACrD,MAAM,qBAAqB,GAAQ,EAAE,CAAC,CAAC,6BAA6B;QAEpE,SAAe,wBAAwB,CAAC,SAAiB;;gBACvD,IAAI,GAAG,GAAQ,EAAE,CAAC;gBAElB,IAAI,iBAAiB,GAAG,CAAC,CAAC;gBAC1B,OAAO,GAAG,CAAC,MAAM,GAAG,SAAS,EAAE;oBAC7B,MAAM,eAAe,GAAG,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC;oBAC/C,IAAI,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,qBAAqB,CAAC,CAAC;oBAEzE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE;wBACvB,iBAAiB,IAAI,CAAC,CAAC;wBAEvB,IAAI,iBAAiB,KAAK,qBAAqB,EAAE;4BAC/C,MAAM,IAAI,KAAK,CAAC,mDAAmD,qBAAqB,oEAAoE,CAAC,CAAC;yBAC/J;wBACD,SAAS;qBACV;yBAAM,IAAI,MAAM,CAAC,MAAM,GAAG,eAAe,EAAE;wBAC1C,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,oDAAoD;qBAChG;oBAED,4DAA4D;oBAC5D,IAAA,sBAAc,EAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;oBAE9C,MAAM,WAAW,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC;oBAE7C,qBAAqB;oBACrB,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;oBAE9B,yDAAyD;iBAC1D;gBAED,OAAO,GAAG,CAAC;YACb,CAAC;SAAA;QAED,MAAM,UAAU,GAAU,MAAM,IAAA,+BAAgB,EAAI;YAClD,UAAU,EAAE,6BAA6B;YACzC,aAAa,EAAE,sBAAsB;YACrC,IAAI,EAAE,CAAO,SAAiB,EAAE,EAAE;gBAChC,MAAM,MAAM,GAAQ,MAAM,wBAAwB,CAAC,SAAS,CAAC,CAAC;gBAC9D,OAAO,MAAM,CAAC;YAChB,CAAC,CAAA;SACF,CAAC,CAAC;QAEH,OAAO,UAAU,CAAC,IAAI,EAAE,CAAC;IAC3B,CAAC,CAAA,CAAC;AACJ,CAAC;AApDD,wCAoDC"}

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

@@ -3,3 +3,4 @@ export * from './model.copy';
 export * from './model.conversion';
 export * from './model.conversion.field';
 export * from './model.modify';
+export * from './id.batch';

package/src/lib/model/index.js

@@ -6,4 +6,5 @@ tslib_1.__exportStar(require("./model.copy"), exports);
 tslib_1.__exportStar(require("./model.conversion"), exports);
 tslib_1.__exportStar(require("./model.conversion.field"), exports);
 tslib_1.__exportStar(require("./model.modify"), exports);
+tslib_1.__exportStar(require("./id.batch"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/model/index.ts"],"names":[],"mappings":";;;AAAA,kDAAwB;AACxB,uDAA6B;AAC7B,6DAAmC;AACnC,mEAAyC;AACzC,yDAA+B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/model/index.ts"],"names":[],"mappings":";;;AAAA,kDAAwB;AACxB,uDAA6B;AAC7B,6DAAmC;AACnC,mEAAyC;AACzC,yDAA+B;AAC/B,qDAA2B"}

package/src/lib/number/random.d.ts

@@ -1,13 +1,30 @@
-export declare type RandomNumberFunction = () => number;
-export interface MakeRandomFunction {
+import { MapFunction } from '../value/map';
+import { Factory } from './../getter/getter';
+export declare type RandomNumberFactory = Factory<number>;
+export declare type NumberRounding = 'none' | 'floor' | 'ceil' | 'round';
+export declare type RoundingFunction = MapFunction<number, number>;
+export declare function roundingFunction(type: NumberRounding): RoundingFunction;
+export declare type RoundingInput = NumberRounding | RoundingFunction;
+/**
+ * randomNumberFactory configuration
+ */
+export interface RandomNumberFactoryConfig {
+    /**
+     * Rounding type. By default will round to
+     */
+    round?: RoundingInput;
     min?: number;
     max: number;
 }
-export declare type MakeRandomFunctionInput = number | MakeRandomFunction;
+export declare type RandomNumberFactoryInput = number | RandomNumberFactoryConfig;
 /**
  * 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;
+export declare function randomNumberFactory(maxOrArgs: RandomNumberFactoryInput, roundingInput?: RoundingInput): RandomNumberFactory;
+/**
+ * @deprecated use randomNumberFactory() instead.
+ */
+export declare const makeRandomFunction: typeof randomNumberFactory;

package/src/lib/number/random.js

@@ -1,22 +1,54 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.makeRandomFunction = void 0;
+exports.makeRandomFunction = exports.randomNumberFactory = exports.roundingFunction = void 0;
+function roundingFunction(type) {
+    let fn;
+    switch (type) {
+        case 'floor':
+            fn = Math.floor;
+            break;
+        case 'ceil':
+            fn = Math.ceil;
+            break;
+        case 'none':
+            fn = (x) => x;
+            break;
+        case 'round':
+        default:
+            fn = Math.round;
+            break;
+    }
+    return fn;
+}
+exports.roundingFunction = roundingFunction;
 /**
  * Used to generate a RandomNumberFunction that returns a number between the input and the maximum.
  *
  * @param maxOrArgs
  * @returns
  */
-function makeRandomFunction(maxOrArgs) {
+function randomNumberFactory(maxOrArgs, roundingInput) {
     const config = typeof maxOrArgs === 'number' ? { min: 0, max: maxOrArgs } : maxOrArgs;
-    const { min, max } = config;
+    const { min, max, round: roundConfig } = config;
+    const round = roundingInput !== null && roundingInput !== void 0 ? roundingInput : roundConfig;
+    let fn;
     if (min != null) {
         const range = max - min;
-        return () => Math.random() * range + min;
+        fn = () => Math.random() * range + min;
     }
     else {
-        return () => Math.random() * max;
+        fn = () => Math.random() * max;
+    }
+    if (round && round !== 'none') {
+        const roundFn = typeof round === 'function' ? round : roundingFunction(round);
+        const randomFn = fn;
+        fn = () => roundFn(randomFn());
     }
+    return fn;
 }
-exports.makeRandomFunction = makeRandomFunction;
+exports.randomNumberFactory = randomNumberFactory;
+/**
+ * @deprecated use randomNumberFactory() instead.
+ */
+exports.makeRandomFunction = randomNumberFactory;
 //# sourceMappingURL=random.js.map

package/src/lib/number/random.js.map

@@ -1 +1 @@
-{"version":3,"file":"random.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/number/random.ts"],"names":[],"mappings":";;;AASA;;;;;GAKG;AACH,SAAgB,kBAAkB,CAAC,SAAkC;IACnE,MAAM,MAAM,GAAuB,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1G,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,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,GAAG,GAAG,CAAC;KAC1C;SAAM;QACL,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC;KAClC;AACH,CAAC;AAVD,gDAUC"}
+{"version":3,"file":"random.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/number/random.ts"],"names":[],"mappings":";;;AAQA,SAAgB,gBAAgB,CAAC,IAAoB;IACnD,IAAI,EAAoB,CAAC;IAEzB,QAAQ,IAAI,EAAE;QACZ,KAAK,OAAO;YACV,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;YAChB,MAAM;QACR,KAAK,MAAM;YACT,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC;YACf,MAAM;QACR,KAAK,MAAM;YACT,EAAE,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YACd,MAAM;QACR,KAAK,OAAO,CAAC;QACb;YACE,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;YAChB,MAAM;KACT;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AApBD,4CAoBC;AAkBD;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAC,SAAmC,EAAE,aAA6B;IACpG,MAAM,MAAM,GAA8B,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACjH,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IAChD,MAAM,KAAK,GAAG,aAAa,aAAb,aAAa,cAAb,aAAa,GAAI,WAAW,CAAC;IAC3C,IAAI,EAAuB,CAAC;IAE5B,IAAI,GAAG,IAAI,IAAI,EAAE;QACf,MAAM,KAAK,GAAG,GAAG,GAAG,GAAG,CAAC;QACxB,EAAE,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,GAAG,GAAG,CAAC;KACxC;SAAM;QACL,EAAE,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC;KAChC;IAED,IAAI,KAAK,IAAI,KAAK,KAAK,MAAM,EAAE;QAC7B,MAAM,OAAO,GAAG,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC9E,MAAM,QAAQ,GAAG,EAAE,CAAC;QACpB,EAAE,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;KAChC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AApBD,kDAoBC;AAED;;GAEG;AACU,QAAA,kBAAkB,GAAG,mBAAmB,CAAC"}

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

@@ -1,3 +1,4 @@
+import { BatchCount } from '../grouping';
 import { Maybe } from '../value/maybe.type';
 export interface PerformTaskLoopConfig<O> {
     next: (i: number, prev: Maybe<O>) => Promise<O>;
@@ -21,8 +22,17 @@ export interface PerformTaskCountLoopWithInitConfig<O> extends Omit<PerformTaskL
 export declare function performTaskCountLoop<O>(config: PerformTaskCountLoopWithInitConfig<O>): Promise<O>;
 export declare function performTaskCountLoop<O>(config: PerformTaskCountLoopConfig<O>): Promise<Maybe<O>>;
 export declare function performTaskCountLoop(config: PerformTaskCountLoopConfig<void>): Promise<void>;
+export declare type PerformMakeLoopFunction<O> = (i: number, made: O[]) => Promise<O>;
 export interface PerformMakeLoopConfig<O> {
-    make: (i: number, made: O[]) => Promise<O>;
+    make: PerformMakeLoopFunction<O>;
     count: number;
 }
 export declare function performMakeLoop<O>(config: PerformMakeLoopConfig<O>): Promise<O[]>;
+export declare type PerformBatchLoopFunction<O> = (itemsToMake: number, i: number, made: O[][]) => Promise<O[]>;
+export interface PerformBatchLoopConfig<O> extends BatchCount {
+    /**
+     * Makes a certain number of items.
+     */
+    make: PerformBatchLoopFunction<O>;
+}
+export declare function performBatchLoop<O>(config: PerformBatchLoopConfig<O>): Promise<O[][]>;

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

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.performMakeLoop = exports.performTaskCountLoop = exports.performTaskLoop = void 0;
+exports.performBatchLoop = exports.performMakeLoop = exports.performTaskCountLoop = exports.performTaskLoop = void 0;
 const tslib_1 = require("tslib");
+const grouping_1 = require("../grouping");
 function performTaskLoop(config) {
     return tslib_1.__awaiter(this, void 0, void 0, function* () {
         let result;
@@ -41,4 +42,18 @@ function performMakeLoop(config) {
     });
 }
 exports.performMakeLoop = performMakeLoop;
+function performBatchLoop(config) {
+    const { make } = config;
+    const calc = (0, grouping_1.batchCalc)(config);
+    const { batchCount } = calc;
+    return performMakeLoop({
+        count: batchCount,
+        make: (i, made) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const itemsToMake = (0, grouping_1.itemCountForBatchIndex)(i, calc);
+            const batch = yield make(itemsToMake, i, made);
+            return batch;
+        })
+    });
+}
+exports.performBatchLoop = performBatchLoop;
 //# sourceMappingURL=promise.loop.js.map

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":";;;;AAkBA,SAAsB,eAAe,CAAI,MAAmE;;QAC1G,IAAI,MAAS,CAAC;QACd,MAAM,SAAS,GAAI,MAA2C,CAAC,SAAS,CAAC;QACzE,MAAM,SAAS,GAAG,SAAS,IAAI,IAAI,IAAI,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;QAE3E,IAAI,SAAS,EAAE;YACb,IAAI,CAAC,GAAG,CAAC,CAAC;YACV,IAAI,SAAS,GAAa,SAAS,CAAC;YACpC,IAAI,KAAc,CAAC;YAEnB,GAAG;gBACD,SAAS,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;gBAC5C,CAAC,IAAI,CAAC,CAAC;gBACP,KAAK,GAAG,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;aAC5C,QAAQ,KAAK,EAAE;YAEhB,MAAM,GAAG,SAAS,CAAC;SACpB;aAAM;YACL,MAAM,GAAG,SAAS,CAAC;SACpB;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CAAA;AAtBD,0CAsBC;AAcD,SAAgB,oBAAoB,CAAI,MAA6E;IACnH,OAAO,eAAe,CAAI,gCACrB,MAAM,KACT,aAAa,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,GACd,CAAC,CAAC;AACjC,CAAC;AALD,oDAKC;AAQD,SAAgB,eAAe,CAAI,MAAgC;IACjE,OAAO,oBAAoB,CAAM;QAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,SAAS,EAAE,EAAS;QACpB,IAAI,EAAE,CAAO,CAAC,EAAE,WAAgB,EAAE,EAAE;YAClC,MAAM,MAAM,GAAM,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;YACpD,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACzB,OAAO,WAAW,CAAC;QACrB,CAAC,CAAA;KACF,CAAC,CAAC;AACL,CAAC;AAVD,0CAUC"}
+{"version":3,"file":"promise.loop.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/promise/promise.loop.ts"],"names":[],"mappings":";;;;AAAA,0CAAmF;AAmBnF,SAAsB,eAAe,CAAI,MAAmE;;QAC1G,IAAI,MAAS,CAAC;QACd,MAAM,SAAS,GAAI,MAA2C,CAAC,SAAS,CAAC;QACzE,MAAM,SAAS,GAAG,SAAS,IAAI,IAAI,IAAI,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;QAE3E,IAAI,SAAS,EAAE;YACb,IAAI,CAAC,GAAG,CAAC,CAAC;YACV,IAAI,SAAS,GAAa,SAAS,CAAC;YACpC,IAAI,KAAc,CAAC;YAEnB,GAAG;gBACD,SAAS,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;gBAC5C,CAAC,IAAI,CAAC,CAAC;gBACP,KAAK,GAAG,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;aAC5C,QAAQ,KAAK,EAAE;YAEhB,MAAM,GAAG,SAAS,CAAC;SACpB;aAAM;YACL,MAAM,GAAG,SAAS,CAAC;SACpB;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CAAA;AAtBD,0CAsBC;AAcD,SAAgB,oBAAoB,CAAI,MAA6E;IACnH,OAAO,eAAe,CAAI,gCACrB,MAAM,KACT,aAAa,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,GACd,CAAC,CAAC;AACjC,CAAC;AALD,oDAKC;AAUD,SAAgB,eAAe,CAAI,MAAgC;IACjE,OAAO,oBAAoB,CAAM;QAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,SAAS,EAAE,EAAS;QACpB,IAAI,EAAE,CAAO,CAAC,EAAE,WAAgB,EAAE,EAAE;YAClC,MAAM,MAAM,GAAM,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;YACpD,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACzB,OAAO,WAAW,CAAC;QACrB,CAAC,CAAA;KACF,CAAC,CAAC;AACL,CAAC;AAVD,0CAUC;AAYD,SAAgB,gBAAgB,CAAI,MAAiC;IACnE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;IACxB,MAAM,IAAI,GAAG,IAAA,oBAAS,EAAC,MAAM,CAAC,CAAC;IAC/B,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAE5B,OAAO,eAAe,CAAC;QACrB,KAAK,EAAE,UAAU;QACjB,IAAI,EAAE,CAAO,CAAC,EAAE,IAAW,EAAE,EAAE;YAC7B,MAAM,WAAW,GAAG,IAAA,iCAAsB,EAAC,CAAC,EAAE,IAAI,CAAC,CAAC;YACpD,MAAM,KAAK,GAAQ,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;YACpD,OAAO,KAAK,CAAC;QACf,CAAC,CAAA;KACF,CAAC,CAAC;AACL,CAAC;AAbD,4CAaC"}

package/src/lib/value/use.d.ts

@@ -35,8 +35,8 @@ export declare type MappedUseAsyncFunction<A, I> = <O = void>(input: Maybe<A>, u
 /**
  * Creates a MappedUseFunction.
  */
-export declare function mappedUseAsyncFunction<A, I>(map: MapFunction<A, Maybe<PromiseOrValue<I>>>): MappedUseAsyncFunction<A, I>;
+export declare function mappedUseAsyncFunction<A, I>(map: MapFunction<A, Maybe<PromiseOrValue<Maybe<I>>>>): MappedUseAsyncFunction<A, I>;
 /**
  * Wraps another MappedUseFunction or MappedUseAsyncFunction and maps the input values.
  */
-export declare function wrapUseAsyncFunction<A, B, I>(mappedUsePromiseFn: MappedUseAsyncFunction<A, B>, map: MapFunction<B, Maybe<PromiseOrValue<I>>>): MappedUseAsyncFunction<A, I>;
+export declare function wrapUseAsyncFunction<A, B, I>(mappedUsePromiseFn: MappedUseAsyncFunction<A, B>, map: MapFunction<B, Maybe<PromiseOrValue<Maybe<I>>>>): MappedUseAsyncFunction<A, I>;

package/src/lib/value/use.js.map

@@ -1 +1 @@
-{"version":3,"file":"use.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/value/use.ts"],"names":[],"mappings":";;;;AAAA,sCAAkF;AAWlF,SAAgB,QAAQ,CAAc,KAAe,EAAE,GAAmB,EAAE,YAAsC;IAChH,IAAI,MAAgB,CAAC;IAErB,IAAI,KAAK,IAAI,IAAI,EAAE;QACjB,MAAM,GAAG,GAAG,CAAC,KAAK,CAAa,CAAC;KACjC;SAAM;QACL,MAAM,GAAG,IAAA,2BAAkB,EAAC,YAAY,CAAC,CAAC;KAC3C;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAVD,4BAUC;AAKD;;GAEG;AACH,SAAgB,iBAAiB,CAAO,GAA6B;IACnE,OAAO,eAAe,CAAU,QAAe,EAAE,GAAU,CAAC,CAAC;AAC/D,CAAC;AAFD,8CAEC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAU,WAAoC,EAAE,GAA6B;IAC1G,OAAO,CAAC,CAAW,KAAe,EAAE,KAAqB,EAAE,YAAsC,EAAE,EAAE;QACnG,OAAO,WAAW,CAAI,KAAK,EAAE,CAAC,CAAC,KAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,CAAmB,EAAE,YAAY,CAAC,CAAC;IAC1H,CAAC,CAA4B,CAAC;AAChC,CAAC;AAJD,0CAIC;AAOD;;GAEG;AACH,SAAgB,kBAAkB,CAAO,GAAmB,EAAE,YAA+B;IAC3F,OAAO,CAAC,CAAC,KAAe,EAAE,EAAE;QAC1B,IAAI,MAAgB,CAAC;QAErB,IAAI,KAAK,IAAI,IAAI,EAAE;YACjB,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;SACrB;aAAM;YACL,MAAM,GAAG,IAAA,2BAAkB,EAAC,YAAY,CAAC,CAAC;SAC3C;QAED,OAAO,MAAM,CAAC;IAChB,CAAC,CAA0B,CAAC;AAC9B,CAAC;AAZD,gDAYC;AAQD,SAAsB,QAAQ,CAAc,KAAe,EAAE,GAAmB,EAAE,YAAsC;;QACtH,IAAI,MAAgB,CAAC;QAErB,IAAI,KAAK,IAAI,IAAI,EAAE;YACjB,MAAM,GAAG,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,CAAa,CAAC;SACzC;aAAM;YACL,MAAM,GAAG,MAAM,IAAA,2BAAkB,EAAC,YAAY,CAAC,CAAC;SACjD;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CAAA;AAVD,4BAUC;AAKD;;GAEG;AACH,SAAgB,sBAAsB,CAAO,GAA6C;IACxF,OAAO,oBAAoB,CAAU,QAAe,EAAE,GAAU,CAAC,CAAC;AACpE,CAAC;AAFD,wDAEC;AAED;;GAEG;AACH,SAAgB,oBAAoB,CAAU,kBAAgD,EAAE,GAA6C;IAC3I,OAAO,CAAC,CAAW,KAAe,EAAE,KAAqB,EAAE,YAA2C,EAAE,EAAE;QACxG,OAAO,kBAAkB,CAAI,KAAK,EAAE,CAAC,CAAO,KAAQ,EAAE,EAAE,wDAAC,OAAA,QAAQ,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,CAAA,GAAA,CAAmB,EAAE,YAAY,CAAC,CAAC;IAC7I,CAAC,CAAiC,CAAC;AACrC,CAAC;AAJD,oDAIC"}
+{"version":3,"file":"use.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/value/use.ts"],"names":[],"mappings":";;;;AAAA,sCAAkF;AAWlF,SAAgB,QAAQ,CAAc,KAAe,EAAE,GAAmB,EAAE,YAAsC;IAChH,IAAI,MAAgB,CAAC;IAErB,IAAI,KAAK,IAAI,IAAI,EAAE;QACjB,MAAM,GAAG,GAAG,CAAC,KAAK,CAAa,CAAC;KACjC;SAAM;QACL,MAAM,GAAG,IAAA,2BAAkB,EAAC,YAAY,CAAC,CAAC;KAC3C;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAVD,4BAUC;AAKD;;GAEG;AACH,SAAgB,iBAAiB,CAAO,GAA6B;IACnE,OAAO,eAAe,CAAU,QAAe,EAAE,GAAU,CAAC,CAAC;AAC/D,CAAC;AAFD,8CAEC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAU,WAAoC,EAAE,GAA6B;IAC1G,OAAO,CAAC,CAAW,KAAe,EAAE,KAAqB,EAAE,YAAsC,EAAE,EAAE;QACnG,OAAO,WAAW,CAAI,KAAK,EAAE,CAAC,CAAC,KAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,CAAmB,EAAE,YAAY,CAAC,CAAC;IAC1H,CAAC,CAA4B,CAAC;AAChC,CAAC;AAJD,0CAIC;AAOD;;GAEG;AACH,SAAgB,kBAAkB,CAAO,GAAmB,EAAE,YAA+B;IAC3F,OAAO,CAAC,CAAC,KAAe,EAAE,EAAE;QAC1B,IAAI,MAAgB,CAAC;QAErB,IAAI,KAAK,IAAI,IAAI,EAAE;YACjB,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;SACrB;aAAM;YACL,MAAM,GAAG,IAAA,2BAAkB,EAAC,YAAY,CAAC,CAAC;SAC3C;QAED,OAAO,MAAM,CAAC;IAChB,CAAC,CAA0B,CAAC;AAC9B,CAAC;AAZD,gDAYC;AAQD,SAAsB,QAAQ,CAAc,KAAe,EAAE,GAAmB,EAAE,YAAsC;;QACtH,IAAI,MAAgB,CAAC;QAErB,IAAI,KAAK,IAAI,IAAI,EAAE;YACjB,MAAM,GAAG,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,CAAa,CAAC;SACzC;aAAM;YACL,MAAM,GAAG,MAAM,IAAA,2BAAkB,EAAC,YAAY,CAAC,CAAC;SACjD;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CAAA;AAVD,4BAUC;AAKD;;GAEG;AACH,SAAgB,sBAAsB,CAAO,GAAoD;IAC/F,OAAO,oBAAoB,CAAU,QAAe,EAAE,GAAU,CAAC,CAAC;AACpE,CAAC;AAFD,wDAEC;AAED;;GAEG;AACH,SAAgB,oBAAoB,CAAU,kBAAgD,EAAE,GAAoD;IAClJ,OAAO,CAAC,CAAW,KAAe,EAAE,KAAqB,EAAE,YAA2C,EAAE,EAAE;QACxG,OAAO,kBAAkB,CAAI,KAAK,EAAE,CAAC,CAAO,KAAQ,EAAE,EAAE,wDAAC,OAAA,QAAQ,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,CAAA,GAAA,CAAmB,EAAE,YAAY,CAAC,CAAC;IAC7I,CAAC,CAAiC,CAAC;AACrC,CAAC;AAJD,oDAIC"}

package/test/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 This file was generated using [@jscutlery/semver](https://github.com/jscutlery/semver).
 
+# [7.10.0](https://github.com/dereekb/dbx-components/compare/v7.9.0-dev...v7.10.0) (2022-06-11)
+
+
+
+# [7.9.0](https://github.com/dereekb/dbx-components/compare/v7.8.1-dev...v7.9.0) (2022-06-11)
+
+
+
+## [7.8.1](https://github.com/dereekb/dbx-components/compare/v7.8.0-dev...v7.8.1) (2022-06-10)
+
+
+
 # [7.8.0](https://github.com/dereekb/dbx-components/compare/v7.7.0-dev...v7.8.0) (2022-06-09)
 
 

package/test/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@dereekb/util/test",
-  "version": "7.8.0",
+  "version": "7.10.0",
   "main": "./src/index.js",
   "typings": "./src/index.d.ts",
   "dependencies": {},
   "peerDependencies": {
-    "@dereekb/util": "7.8.0",
+    "@dereekb/util": "7.10.0",
     "make-error": "^1.3.0",
     "ts-essentials": "^9.1.2",
     "extra-set": "^2.2.11",