@dereekb/util 7.9.0 → 7.11.1

package/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 This file was generated using [@jscutlery/semver](https://github.com/jscutlery/semver).
 
+## [7.11.1](https://github.com/dereekb/dbx-components/compare/v7.11.0-dev...v7.11.1) (2022-06-13)
+
+
+
+# [7.11.0](https://github.com/dereekb/dbx-components/compare/v7.10.0-dev...v7.11.0) (2022-06-13)
+
+
+### Features
+
+* added arrayToObject() ([edc723f](https://github.com/dereekb/dbx-components/commit/edc723f94a39f56dd6d43827595ee267830bf897))
+
+
+
+# [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)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/util",
-  "version": "7.9.0",
+  "version": "7.11.1",
   "type": "commonjs",
   "exports": {
     ".": {
@@ -10,7 +10,8 @@
     },
     "./test": {
       "main": "./test/index.js",
-      "types": "./test/index.d.ts"
+      "types": "./test/index.d.ts",
+      "default": "./test/index.js"
     }
   },
   "main": "./src/index.js",

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

@@ -1,12 +1,21 @@
 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.
  *

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

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

@@ -30,7 +30,3 @@ export declare type RandomArrayFactory<T> = FactoryWithInput<T[], number>;
  * @returns
  */
 export declare function randomArrayFactory<T>(config: RandomArrayFactoryConfig<T>): RandomArrayFactory<T>;
-/**
- * @deprecated Use randomArrayFactory instead.
- */
-export declare const makeRandomArrayFn: typeof randomArrayFactory;

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.makeRandomArrayFn = exports.randomArrayFactory = 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");
@@ -29,8 +29,4 @@ function randomArrayFactory(config) {
     return (count = nextRandomCount()) => factory(count);
 }
 exports.randomArrayFactory = randomArrayFactory;
-/**
- * @deprecated Use randomArrayFactory instead.
- */
-exports.makeRandomArrayFn = 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,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;AAED;;GAEG;AACU,QAAA,iBAAiB,GAAG,kBAAkB,CAAC"}
+{"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.map.d.ts

@@ -6,6 +6,12 @@ import { Maybe } from '../value/maybe.type';
 export declare function arrayToMap<T, V, K extends PrimativeKey = PrimativeKey>(values: T[], keyFn: ReadKeyFunction<T, K>, valueFn: (t: T) => V): Map<Maybe<K>, V>;
 export declare function arrayToMap<T, K extends PrimativeKey = PrimativeKey>(values: T[], keyFn: ReadKeyFunction<T, K>, valueFn: (t: T) => T): Map<Maybe<K>, T>;
 export declare function arrayToMap<T, K extends PrimativeKey = PrimativeKey>(values: T[], keyFn: ReadKeyFunction<T, K>): Map<Maybe<K>, T>;
+/**
+ * Maps the values of the input array to a Record object. Can additionally specify a value function to map out the input value to another value for the map.
+ */
+export declare function arrayToObject<T, V, K extends PrimativeKey = PrimativeKey>(values: T[], keyFn: ReadKeyFunction<T, K>, valueFn: (t: T) => V): Record<K, T>;
+export declare function arrayToObject<T, K extends PrimativeKey = PrimativeKey>(values: T[], keyFn: ReadKeyFunction<T, K>, valueFn: (t: T) => T): Record<K, T>;
+export declare function arrayToObject<T, K extends PrimativeKey = PrimativeKey>(values: T[], keyFn: ReadKeyFunction<T, K>): Record<K, T>;
 /**
  * Generates a value for the input
  *

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

@@ -1,10 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateIfDoesNotExist = exports.arrayToMap = void 0;
+exports.generateIfDoesNotExist = exports.arrayToObject = exports.arrayToMap = void 0;
 function arrayToMap(values, keyFn, valueFn = (t) => t) {
     return new Map(values.map((x) => [keyFn(x), valueFn(x)]));
 }
 exports.arrayToMap = arrayToMap;
+function arrayToObject(values, keyFn, valueFn = (t) => t) {
+    const record = {};
+    values.map((x) => {
+        const key = keyFn(x);
+        const value = valueFn(x);
+        if (key != undefined) {
+            record[key] = value;
+        }
+    });
+    return record;
+}
+exports.arrayToObject = arrayToObject;
 /**
  * Generates a value for the input
  *

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

@@ -1 +1 @@
-{"version":3,"file":"array.map.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/array/array.map.ts"],"names":[],"mappings":";;;AASA,SAAgB,UAAU,CAA8C,MAAW,EAAE,KAA4B,EAAE,UAAuB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAiB;IAChK,OAAO,IAAI,GAAG,CAAc,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACzE,CAAC;AAFD,gCAEC;AAED;;;;;;;;GAQG;AACH,SAAgB,sBAAsB,CAA2C,IAAS,EAAE,QAAa,EAAE,OAA8B,EAAE,UAAyB;IAClK,MAAM,GAAG,GAAG,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAE1C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;;QACpB,MAAM,KAAK,GAAG,MAAA,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,mCAAI,UAAU,CAAC,CAAC,CAAC,CAAC;QAC1C,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAPD,wDAOC"}
+{"version":3,"file":"array.map.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/array/array.map.ts"],"names":[],"mappings":";;;AASA,SAAgB,UAAU,CAA8C,MAAW,EAAE,KAA4B,EAAE,UAAuB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAiB;IAChK,OAAO,IAAI,GAAG,CAAc,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACzE,CAAC;AAFD,gCAEC;AAQD,SAAgB,aAAa,CAA8C,MAAW,EAAE,KAA4B,EAAE,UAAuB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAiB;IACnK,MAAM,MAAM,GAAiB,EAAkB,CAAC;IAEhD,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACf,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACrB,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QAEzB,IAAI,GAAG,IAAI,SAAS,EAAE;YACpB,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;SACrB;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAbD,sCAaC;AAED;;;;;;;;GAQG;AACH,SAAgB,sBAAsB,CAA2C,IAAS,EAAE,QAAa,EAAE,OAA8B,EAAE,UAAyB;IAClK,MAAM,GAAG,GAAG,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAE1C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;;QACpB,MAAM,KAAK,GAAG,MAAA,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,mCAAI,UAAU,CAAC,CAAC,CAAC,CAAC;QAC1C,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAPD,wDAOC"}

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/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/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,6 +1,18 @@
+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;
 }
@@ -11,7 +23,7 @@ export declare type RandomNumberFactoryInput = number | RandomNumberFactoryConfi
  * @param maxOrArgs
  * @returns
  */
-export declare function randomNumberFactory(maxOrArgs: RandomNumberFactoryInput): RandomNumberFactory;
+export declare function randomNumberFactory(maxOrArgs: RandomNumberFactoryInput, roundingInput?: RoundingInput): RandomNumberFactory;
 /**
  * @deprecated use randomNumberFactory() instead.
  */

package/src/lib/number/random.js

@@ -1,15 +1,36 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.makeRandomFunction = exports.randomNumberFactory = 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 randomNumberFactory(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;
@@ -18,6 +39,11 @@ function randomNumberFactory(maxOrArgs) {
     else {
         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.randomNumberFactory = randomNumberFactory;

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":";;;AAWA;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAC,SAAmC;IACrE,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,GAAG,MAAM,CAAC;IAC5B,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,OAAO,EAAE,CAAC;AACZ,CAAC;AAbD,kDAaC;AAED;;GAEG;AACU,QAAA,kBAAkB,GAAG,mBAAmB,CAAC"}
+{"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/test/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 This file was generated using [@jscutlery/semver](https://github.com/jscutlery/semver).
 
+## [7.11.1](https://github.com/dereekb/dbx-components/compare/v7.11.0-dev...v7.11.1) (2022-06-13)
+
+
+
+# [7.11.0](https://github.com/dereekb/dbx-components/compare/v7.10.0-dev...v7.11.0) (2022-06-13)
+
+
+
+# [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)
 
 

package/test/package.json

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