@dereekb/util 2.1.0 → 4.0.1

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

@@ -0,0 +1,63 @@
+import { GetterOrValue } from "../getter/getter";
+import { Maybe } from "../value/maybe";
+import { ApplyMapFunctionWithOptions, MapFunction } from "../value/map";
+export declare type ModelMapFunction<I extends object, O extends object> = ApplyMapFunctionWithOptions<Maybe<I>, O, ModelConversionOptions<I, O>>;
+export declare type ModelFromFunction<V extends object, D extends object> = ModelMapFunction<D, V>;
+export declare type ModelToFunction<V extends object, D extends object> = ModelMapFunction<V, D>;
+export interface ModelMapFunctions<V extends object, D extends object> {
+    from: ModelFromFunction<V, D>;
+    to: ModelToFunction<V, D>;
+}
+export declare type ModelFieldsConversionConfig<I extends object> = {
+    [K in keyof I]: ModelFieldConversionConfig;
+};
+export declare function makeModelMapFunctions<V extends object, D extends object>(fields: ModelFieldsConversionConfig<V>): ModelMapFunctions<V, D>;
+export declare type ModelConversionFieldTuple<I extends object> = [keyof I, ModelFieldMapFunction<any, any>];
+export declare type ModelConversionFieldValuesConfig<I extends object> = ModelConversionFieldTuple<I>[];
+export interface ModelConversionOptions<I extends object, O extends object> {
+    /**
+     * Fields to include.
+     */
+    fields?: (keyof I)[];
+    /**
+     * Whether or not to only convert fields that are defined. Fields with a null value are still converted.
+     */
+    definedOnly?: boolean;
+}
+export declare type ModelConversionFieldValuesFunction<I extends object, O extends object> = ApplyMapFunctionWithOptions<Maybe<I>, O, ModelConversionOptions<I, O>>;
+export declare function makeModelConversionFieldValuesFunction<I extends object, O extends object>(fields: ModelConversionFieldValuesConfig<I>): ModelConversionFieldValuesFunction<I, O>;
+export interface ModelFieldConversionConfig<V = any, D = any> {
+    from?: ModelFieldFromConfig<V, D>;
+    to?: ModelFieldToConfig<V, D>;
+}
+export interface ModelFieldConvertConfig<I, O> {
+    /**
+     * Default value to use if the input value is null/undefined.
+     */
+    default?: GetterOrValue<O>;
+    /**
+     * Whether or not to pass through maybe values to the convert function. Must be explicitly set.
+     *
+     * If a default value is provided, this option is ignored.
+     */
+    convertMaybe?: boolean;
+    /**
+     * Conversion from I to O.
+     */
+    convert?: MapFunction<I, O>;
+}
+export interface ModelFieldFromConfig<V = any, D = any> extends ModelFieldConvertConfig<D, V> {
+}
+export interface ModelFieldToConfig<V = any, D = any> extends ModelFieldConvertConfig<V, D> {
+}
+export declare type ModelFieldMapFunction<I = any, O = any> = MapFunction<Maybe<I>, O>;
+export declare type ModelFieldFromFunction<V, D> = ModelFieldMapFunction<D, V>;
+export declare type ModelFieldToFunction<V, D> = ModelFieldMapFunction<V, D>;
+export interface ModelFieldMapFunctions<V = any, D = any> {
+    from: ModelFieldFromFunction<V, D>;
+    to: ModelFieldToFunction<V, D>;
+}
+export declare function makeModelFieldMapFunction<I, O>(inputConfig: Maybe<ModelFieldConvertConfig<I, O>>): ModelFieldMapFunction<I, O>;
+export declare const makeModelFieldFromFunction: typeof makeModelFieldMapFunction;
+export declare const makeModelFieldToFunction: typeof makeModelFieldMapFunction;
+export declare function makeModelFieldMapFunctions<V = any, D = any>(config: ModelFieldConversionConfig<V, D>): ModelFieldMapFunctions<V, D>;

package/src/lib/model/model.conversion.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeModelFieldMapFunctions = exports.makeModelFieldToFunction = exports.makeModelFieldFromFunction = exports.makeModelFieldMapFunction = exports.makeModelConversionFieldValuesFunction = exports.makeModelMapFunctions = void 0;
+const getter_1 = require("../getter/getter");
+const object_1 = require("../object/object");
+function makeModelMapFunctions(fields) {
+    const keys = (0, object_1.filterKeyValueTuples)(fields);
+    const conversionsByKey = keys.map(([key, field]) => [key, makeModelFieldMapFunctions(field)]);
+    const fromConversions = conversionsByKey.map(([key, configs]) => ([key, configs.from]));
+    const toConversions = conversionsByKey.map(([key, configs]) => ([key, configs.to]));
+    const from = makeModelConversionFieldValuesFunction(fromConversions);
+    const to = makeModelConversionFieldValuesFunction(toConversions);
+    return {
+        from,
+        to
+    };
+}
+exports.makeModelMapFunctions = makeModelMapFunctions;
+function makeModelConversionFieldValuesFunction(fields) {
+    return (input, target, options) => {
+        target = target !== null && target !== void 0 ? target : {};
+        if (input) {
+            let targetFields = fields;
+            // if options are provided, filter down.
+            if (options) {
+                const fieldsToConvert = new Set((0, object_1.findPOJOKeys)(input, {
+                    keysFilter: options.fields,
+                    valueFilter: (options.definedOnly === false) ? object_1.KeyValueTypleValueFilter.NONE : object_1.KeyValueTypleValueFilter.UNDEFINED
+                }));
+                targetFields = fields.filter(x => fieldsToConvert.has(x[0]));
+            }
+            targetFields.forEach(([key, convert]) => target[key] = convert(input[key]));
+        }
+        return target;
+    };
+}
+exports.makeModelConversionFieldValuesFunction = makeModelConversionFieldValuesFunction;
+function makeModelFieldMapFunction(inputConfig) {
+    const config = inputConfig !== null && inputConfig !== void 0 ? inputConfig : {};
+    const { convertMaybe, convert = (x) => x, default: defaultValue } = config;
+    const getDefaultValue = (0, getter_1.asGetter)(defaultValue);
+    return (input) => {
+        if (input == null) {
+            if (convertMaybe) {
+                return convert(input);
+            }
+            else {
+                return getDefaultValue();
+            }
+        }
+        else {
+            return convert(input);
+        }
+    };
+}
+exports.makeModelFieldMapFunction = makeModelFieldMapFunction;
+exports.makeModelFieldFromFunction = makeModelFieldMapFunction;
+exports.makeModelFieldToFunction = makeModelFieldMapFunction;
+function makeModelFieldMapFunctions(config) {
+    return {
+        from: makeModelFieldMapFunction(config.from),
+        to: makeModelFieldMapFunction(config.to),
+    };
+}
+exports.makeModelFieldMapFunctions = makeModelFieldMapFunctions;
+//# sourceMappingURL=model.conversion.js.map

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

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

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

@@ -0,0 +1,16 @@
+import { Maybe } from '../value/maybe';
+export declare type CopySelectModelFieldsConfig<T = any> = Partial<CopyModelFieldsConfig<T>>;
+export declare type CopyModelFieldsConfig<T = any> = {
+    [K in keyof T]: Maybe<CopyModelFieldConfig>;
+};
+export interface CopyModelFieldConfig<V = any> {
+    /**
+     * Default value if not presented. If default is not defined and there is no value, the key will be ignored entirely.
+     */
+    default?: V;
+}
+/**
+ * Used for copying one field from one partial object to a target object.
+ */
+export declare type CopyModelFieldFunction<T> = (from: Partial<T>, target: Partial<T>) => void;
+export declare function makeCopyModelFieldFunction<T extends object>(key: keyof T, inputConfig?: Maybe<CopyModelFieldConfig>): (from: Partial<T>, target: Partial<T>) => void;

package/src/lib/model/model.copy.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeCopyModelFieldFunction = void 0;
+const object_1 = require("../object");
+function makeCopyModelFieldFunction(key, inputConfig) {
+    const config = inputConfig !== null && inputConfig !== void 0 ? inputConfig : {};
+    const hasDefault = (0, object_1.objectHasKey)(config, 'default');
+    const defaultValue = config.default;
+    return (from, target) => {
+        var _a;
+        if ((0, object_1.objectHasKey)(from, key)) {
+            target[key] = (_a = from[key]) !== null && _a !== void 0 ? _a : defaultValue;
+        }
+        else if (hasDefault) {
+            target[key] = defaultValue;
+        }
+    };
+}
+exports.makeCopyModelFieldFunction = makeCopyModelFieldFunction;
+//# sourceMappingURL=model.copy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model.copy.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/model/model.copy.ts"],"names":[],"mappings":";;;AAAA,sCAAyC;AAuBzC,SAAgB,0BAA0B,CAAmB,GAAY,EAAE,WAAyC;IAClH,MAAM,MAAM,GAAG,WAAW,aAAX,WAAW,cAAX,WAAW,GAAI,EAAE,CAAC;IACjC,MAAM,UAAU,GAAG,IAAA,qBAAY,EAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACnD,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC;IAEpC,OAAO,CAAC,IAAgB,EAAE,MAAkB,EAAE,EAAE;;QAC9C,IAAI,IAAA,qBAAY,EAAC,IAAI,EAAE,GAAG,CAAC,EAAE;YAC3B,MAAM,CAAC,GAAG,CAAC,GAAG,MAAA,IAAI,CAAC,GAAG,CAAC,mCAAI,YAAY,CAAC;SACzC;aAAM,IAAI,UAAU,EAAE;YACpB,MAAc,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC;SACrC;IACH,CAAC,CAAC;AACJ,CAAC;AAZD,gEAYC"}

package/src/lib/{model.d.ts → model/model.d.ts}

@@ -1,5 +1,5 @@
-import { ReadKeyFunction, ReadKeysFunction } from './key';
-import { Maybe } from './value';
+import { ReadKeyFunction, ReadKeysFunction } from '../key';
+import { Maybe } from '../value/maybe';
 /**
  * A string model key
  */

package/src/lib/{model.js → model/model.js}

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.decodeModelKeyTypePair = exports.encodeModelKeyTypePair = exports.throwKeyIsRequired = exports.isModelKey = exports.readModelKeyFromObject = exports.readModelKey = exports.requireModelKey = exports.readModelKeys = exports.useModelOrKey = exports.makeMultiModelKeyMap = exports.makeModelMap = exports.removeModelsWithKey = exports.removeModelsWithSameKey = exports.symmetricDifferenceWithModels = exports.readModelKeysFromObjects = exports.uniqueModels = exports.uniqueKeys = exports.AbstractUniqueModel = exports.readUniqueModelKey = void 0;
-const array_set_1 = require("./array/array.set");
-const array_unique_1 = require("./array/array.unique");
+const set_1 = require("../set/set");
+const array_unique_1 = require("../array/array.unique");
 const readUniqueModelKey = (model) => model.id;
 exports.readUniqueModelKey = readUniqueModelKey;
 class AbstractUniqueModel {
@@ -26,7 +26,7 @@ function readModelKeysFromObjects(input, required, read) {
 }
 exports.readModelKeysFromObjects = readModelKeysFromObjects;
 function symmetricDifferenceWithModels(a, b, required, read) {
-    return (0, array_set_1.symmetricDifferenceKeys)(readModelKeys(a, required, read), readModelKeys(b, required, read));
+    return (0, set_1.symmetricDifferenceKeys)(readModelKeys(a, required, read), readModelKeys(b, required, read));
 }
 exports.symmetricDifferenceWithModels = symmetricDifferenceWithModels;
 function removeModelsWithSameKey(input, model, read) {

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

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

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

@@ -0,0 +1,22 @@
+import { GetterOrValue } from '@dereekb/util';
+import { Factory } from './../getter/getter';
+/**
+ * incrementingNumberFactory() configuration.
+ */
+export interface IncrementingNumberFactoryConfig {
+    /**
+     * Value to start at. Defaults to 0.
+     */
+    startAt?: number;
+    /**
+     * Getter to increase by. Defaults to 1.
+     */
+    increaseBy?: GetterOrValue<number>;
+}
+/**
+ * Creates a factory that returns increasing numbers.
+ *
+ * @param config
+ * @returns
+ */
+export declare function incrementingNumberFactory(config?: IncrementingNumberFactoryConfig): Factory<number>;

package/src/lib/number/factory.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.incrementingNumberFactory = void 0;
+const util_1 = require("@dereekb/util");
+/**
+ * Creates a factory that returns increasing numbers.
+ *
+ * @param config
+ * @returns
+ */
+function incrementingNumberFactory(config = {}) {
+    const { startAt: initial, increaseBy: inputIncreaseBy } = config;
+    const increaseBy = (0, util_1.asGetter)(inputIncreaseBy !== null && inputIncreaseBy !== void 0 ? inputIncreaseBy : 1);
+    let i = initial !== null && initial !== void 0 ? initial : 0;
+    return () => {
+        const x = i;
+        i += increaseBy();
+        return x;
+    };
+}
+exports.incrementingNumberFactory = incrementingNumberFactory;
+//# sourceMappingURL=factory.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/number/factory.ts"],"names":[],"mappings":";;;AAAA,wCAAwD;AAiBxD;;;;;GAKG;AACH,SAAgB,yBAAyB,CAAC,SAA0C,EAAE;IACpF,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,GAAG,MAAM,CAAC;IACjE,MAAM,UAAU,GAAG,IAAA,eAAQ,EAAC,eAAe,aAAf,eAAe,cAAf,eAAe,GAAI,CAAC,CAAC,CAAC;IAElD,IAAI,CAAC,GAAG,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,CAAC,CAAC;IAErB,OAAO,GAAG,EAAE;QACV,MAAM,CAAC,GAAG,CAAC,CAAC;QACZ,CAAC,IAAI,UAAU,EAAE,CAAC;QAClB,OAAO,CAAC,CAAC;IACX,CAAC,CAAC;AACJ,CAAC;AAXD,8DAWC"}

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

@@ -0,0 +1,3 @@
+export * from './factory';
+export * from './random';
+export * from './round';

package/src/lib/number/index.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/number/index.ts"],"names":[],"mappings":";;;AAAA,oDAA0B;AAC1B,mDAAyB;AACzB,kDAAwB"}

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

@@ -0,0 +1,13 @@
+export declare type RandomNumberFunction = () => number;
+export interface MakeRandomFunction {
+    min?: number;
+    max: number;
+}
+export declare type MakeRandomFunctionInput = number | MakeRandomFunction;
+/**
+ * Used to generate a RandomNumberFunction that returns a number between the input and the maximum.
+ *
+ * @param maxOrArgs
+ * @returns
+ */
+export declare function makeRandomFunction(maxOrArgs: MakeRandomFunctionInput): RandomNumberFunction;

package/src/lib/number/random.js

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

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

@@ -0,0 +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,CAAC,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5G,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC;IAE5B,IAAI,GAAG,IAAI,IAAI,EAAE;QACf,MAAM,KAAK,GAAG,GAAG,GAAG,GAAG,CAAC;QACxB,OAAO,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC;KAC5C;SAAM;QACL,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC;KAClC;AACH,CAAC;AAVD,gDAUC"}

package/src/lib/{number.d.ts → number/round.d.ts}

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

package/src/lib/{number.js → number/round.js}

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"round.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/number/round.ts"],"names":[],"mappings":";;;AACA,oBAAoB;AACpB;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAAC,KAAa,EAAE,SAAiB;IAC/D,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAC5E,CAAC;AAFD,4CAEC;AAED;;;;;;;;GAQG;AACH,SAAgB,mBAAmB,CAAC,KAAa,EAAE,IAAY;IAC7D,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;AACxC,CAAC;AAFD,kDAEC"}

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

@@ -1,3 +1,4 @@
 export * from './object.array';
 export * from './object.equal';
+export * from './object.map';
 export * from './object';

package/src/lib/object/index.js

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

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/object/index.ts"],"names":[],"mappings":";;;AAAA,8DAA+B;AAC/B,8DAA+B;AAC/B,wDAAyB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/object/index.ts"],"names":[],"mappings":";;;AAAA,yDAA+B;AAC/B,yDAA+B;AAC/B,uDAA6B;AAC7B,mDAAyB"}

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

@@ -1,5 +1,6 @@
 import { FieldOfType } from "../key";
-import { Maybe } from "../value";
+import { Maybe } from "../value/maybe";
+export declare function objectHasNoKeys(obj: object): obj is {};
 export declare function objectHasKey<T, K extends keyof T = keyof T>(obj: T, key: K): boolean;
 export declare function objectHasKey<T>(obj: T, key: string): boolean;
 export declare function applyToMultipleFields<T extends object>(value: any, fields: FieldOfType<T>[]): Partial<T>;
@@ -8,8 +9,46 @@ export declare function mapToObject<T, K extends PropertyKey>(map: Map<K, T>): {
 };
 export interface FilterFromPOJO<T extends object> {
     copy?: boolean;
-    filter?: Omit<FilterKeyValueTuples<T>, 'inverse'>;
+    filter?: Omit<KeyValueTupleFilter<T>, 'inverse'>;
 }
+/**
+ * Returns a copy of the input object with all null and undefined values filtered from it.
+ *
+ * @param obj
+ * @returns
+ */
+export declare function filterNullAndUndefinedValues<T extends object = object>(obj: T): T;
+/**
+ * Returns a copy of the input object with all undefined values filtered from it.
+ *
+ * @param obj
+ * @returns
+ */
+export declare function filterUndefinedValues<T extends object = object>(obj: T, filterNull?: boolean): T;
+/**
+ * Returns all keys that are not associated with an undefined value.
+ *
+ * @param obj
+ * @returns
+ */
+export declare function allNonUndefinedKeys<T extends object = Object>(obj: T): (keyof T)[];
+export declare function allMaybeSoKeys<T extends object = Object>(obj: T): (keyof T)[];
+/**
+ * Finds keys from the POJO that meet the filter.
+ *
+ * @param obj
+ * @param filter
+ * @returns
+ */
+export declare function findPOJOKeys<T extends object = object>(obj: T, filter: FilterKeyValueTuplesInput<T>): (keyof T)[];
+/**
+ * Finds and counts the number of keys from the POJO that meet the filter.
+ *
+ * @param obj
+ * @param filter
+ * @returns
+ */
+export declare function countPOJOKeys<T extends object = object>(obj: T, filter?: FilterKeyValueTuplesInput<T>): number;
 /**
  * Removes values, per the the filter config, from the input object.
  *
@@ -18,11 +57,32 @@ export interface FilterFromPOJO<T extends object> {
  */
 export declare function filterFromPOJO<T extends object = object>(obj: T, { copy, filter }?: FilterFromPOJO<T>): T;
 export declare function assignValuesToPOJO<T extends object = object>(target: T, obj: T, filter?: FilterKeyValueTuplesInput<T>): T;
+/**
+ * Reads all values from the pojo based on the filter and puts them into an array.
+ *
+ * @param target
+ * @param filter
+ * @returns
+ */
+export declare function valuesFromPOJO<O = any, I extends object = object>(target: I, filter?: FilterKeyValueTuplesInput<I>): O[];
 export declare type KeyValueTuple<T extends object = object, K extends keyof T = keyof T> = [K, T[K]];
+export declare function allKeyValueTuples<T extends object = object, K extends keyof T = keyof T>(obj: T): KeyValueTuple<T, K>[];
 export declare enum KeyValueTypleValueFilter {
+    /**
+     * No filter
+     */
     NONE = 0,
+    /**
+     * Only undefined values.
+     */
     UNDEFINED = 1,
+    /**
+     * All values that are null or undefined.
+     */
     NULL = 2,
+    /**
+     * All values that are falsy.
+     */
     FALSY = 3
 }
 export declare type ForEachKeyValueFunction<T extends object = object, K extends keyof T = keyof T> = (tuple: KeyValueTuple<T, K>, index: number) => void;
@@ -31,14 +91,15 @@ export interface ForEachKeyValue<T extends object = object, K extends keyof T =
     forEach: ForEachKeyValueFunction<T, K>;
 }
 export declare function forEachKeyValue<T extends object = object, K extends keyof T = keyof T>(obj: T, { forEach, filter }: ForEachKeyValue<T, K>): void;
-export declare function toKeyValueTuples<T extends object = object, K extends keyof T = keyof T>(obj: T, filter?: FilterKeyValueTuplesInput<T, K>): KeyValueTuple<T, K>[];
-export declare type FilterKeyValueTuplesInput<T extends object = object, K extends keyof T = keyof T> = KeyValueTypleValueFilter | FilterKeyValueTuples<T, K>;
-export interface FilterKeyValueTuples<T extends object = object, K extends keyof T = keyof T> {
+export declare function filterKeyValueTuples<T extends object = object, K extends keyof T = keyof T>(obj: T, filter?: FilterKeyValueTuplesInput<T, K>): KeyValueTuple<T, K>[];
+export interface KeyValueTupleFilter<T extends object = object, K extends keyof T = keyof T> {
     valueFilter?: KeyValueTypleValueFilter;
     invertFilter?: boolean;
     keysFilter?: K[];
 }
-export declare function filterKeyValueTuplesFn<T extends object = object, K extends keyof T = keyof T>(input: FilterKeyValueTuplesInput<T, K>): (tuples: KeyValueTuple<T, K>) => boolean;
+export declare type FilterKeyValueTuplesInput<T extends object = object, K extends keyof T = keyof T> = KeyValueTypleValueFilter | KeyValueTupleFilter<T, K>;
+export declare type FilterKeyValueTupleFunction<T extends object = object, K extends keyof T = keyof T> = (tuples: KeyValueTuple<T, K>) => boolean;
+export declare function filterKeyValueTupleFunction<T extends object = object, K extends keyof T = keyof T>(input: FilterKeyValueTuplesInput<T, K>): FilterKeyValueTupleFunction<T, K>;
 /**
  * Recursively function that returns true if the input is not an object or if every key on the object is empty.
  *
@@ -50,7 +111,7 @@ export declare function objectIsEmpty<T extends object>(obj: Maybe<T>): boolean;
  *
  * @param objects
  */
-export declare function mergeObjects<T extends object>(objects: Maybe<Partial<T>>[], filter?: FilterKeyValueTuples<T>): Partial<T>;
+export declare function mergeObjects<T extends object>(objects: Maybe<Partial<T>>[], filter?: KeyValueTupleFilter<T>): Partial<T>;
 /**
  * Assigns all undefined valeus from one or more objects into the target object.
  *
@@ -58,5 +119,5 @@ export declare function mergeObjects<T extends object>(objects: Maybe<Partial<T>
  */
 export declare function overrideInObject<T extends object>(target: Partial<T>, { from, filter }: {
     from: Partial<T>[];
-    filter?: FilterKeyValueTuples<T>;
+    filter?: KeyValueTupleFilter<T>;
 }): Partial<T>;

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

@@ -1,4 +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;
+export declare function areEqualPOJOValues<F>(a: F, b: F): boolean;

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

@@ -1,12 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.areEqualObjectValues = void 0;
+exports.areEqualPOJOValues = 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) {
+function areEqualPOJOValues(a, b) {
     return (0, lodash_1.isEqual)(a, b);
 }
-exports.areEqualObjectValues = areEqualObjectValues;
+exports.areEqualPOJOValues = areEqualPOJOValues;
 //# sourceMappingURL=object.equal.js.map

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

@@ -1 +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"}
+{"version":3,"file":"object.equal.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/object/object.equal.ts"],"names":[],"mappings":";;;AAAA,mCAAiC;AAEjC;;GAEG;AACH,SAAgB,kBAAkB,CAAI,CAAI,EAAE,CAAI;IAC9C,OAAO,IAAA,gBAAO,EAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACvB,CAAC;AAFD,gDAEC"}