@dereekb/util 7.1.0 → 7.4.0

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

@@ -1,6 +1,4 @@
 import { FieldOfType } from '../key';
-import { Maybe } from '../value/maybe';
-import { FilterFunction } from '../filter/filter';
 export declare type EmptyObject = Record<string, never>;
 export declare function objectHasNoKeys(obj: object): obj is EmptyObject;
 export declare function objectHasKey<T, K extends keyof T = keyof T>(obj: T, key: K): boolean;
@@ -11,117 +9,11 @@ export declare function applyToMultipleFields<T extends object, X = unknown>(val
 export declare function mapToObject<T, K extends PropertyKey>(map: Map<K, T>): {
     [key: PropertyKey]: T;
 };
-export interface FilterFromPOJO<T extends object> {
-    copy?: boolean;
-    filter?: Omit<KeyValueTupleFilter<T>, 'inverse'>;
-}
+export declare type CopyObjectFunction<T> = (input: T) => T;
 /**
- * Returns a copy of the input object with all null and undefined values filtered from it.
+ * Creates a shallow copy of an object using the spread operator.
  *
- * @param obj
+ * @param input
  * @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.
- *
- * @param obj POJO to remove undefined values from.
- * @param copy Whether or not to return a copy of the input object. Default is true.
- */
-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 = unknown, 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;
-export interface ForEachKeyValue<T extends object = object, K extends keyof T = keyof T> {
-    filter?: FilterKeyValueTuplesInput<T, K>;
-    forEach: ForEachKeyValueFunction<T, K>;
-}
-export declare function forEachKeyValue<T extends object = object, K extends keyof T = keyof T>(obj: T, { forEach, filter }: ForEachKeyValue<T, K>): void;
-export declare function 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 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> = FilterFunction<KeyValueTuple<T, K>>;
-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.
- *
- * @param obj
- */
-export declare function objectIsEmpty<T extends object>(obj: Maybe<T>): boolean;
-/**
- * Merges all input objects into one. The order of overrides is kept, so the right-most item in the array will have priority over all objects before it.
- *
- * @param objects
- */
-export declare function mergeObjects<T extends object>(objects: Maybe<Partial<T>>[], filter?: KeyValueTupleFilter<T>): Partial<T>;
-/**
- * Assigns all undefined valeus from one or more objects into the target object.
- *
- * @param object
- */
-export declare function overrideInObject<T extends object>(target: Partial<T>, { from, filter }: {
-    from: Partial<T>[];
-    filter?: KeyValueTupleFilter<T>;
-}): Partial<T>;
+export declare function copyObject<T extends object>(input: T): T;

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

@@ -0,0 +1,7 @@
+import { Maybe } from '../value/maybe.type';
+/**
+ * Recursively function that returns true if the input is not an object or if every key on the object is empty.
+ *
+ * @param obj
+ */
+export declare function objectIsEmpty<T extends object>(obj: Maybe<T>): boolean;

package/src/lib/object/object.empty.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.objectIsEmpty = void 0;
+const maybe_1 = require("../value/maybe");
+/**
+ * Recursively function that returns true if the input is not an object or if every key on the object is empty.
+ *
+ * @param obj
+ */
+function objectIsEmpty(obj) {
+    if (obj != null && typeof obj === 'object') {
+        const keys = Object.keys(obj);
+        if (keys.length > 0) {
+            for (let i = 0; i < keys.length; i += 1) {
+                const key = keys[i];
+                const value = obj[key];
+                const isEmpty = typeof obj === 'object' ? objectIsEmpty(value) : !(0, maybe_1.hasValueOrNotEmpty)(value);
+                if (!isEmpty) {
+                    return false;
+                }
+            }
+        }
+    }
+    return true;
+}
+exports.objectIsEmpty = objectIsEmpty;
+//# sourceMappingURL=object.empty.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"object.empty.js","sourceRoot":"","sources":["../../../../../../packages/util/src/lib/object/object.empty.ts"],"names":[],"mappings":";;;AACA,0CAAoD;AAEpD;;;;GAIG;AACH,SAAgB,aAAa,CAAmB,GAAa;IAC3D,IAAI,GAAG,IAAI,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE;QAC1C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAE9B,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE;YACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE;gBACvC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;gBACpB,MAAM,KAAK,GAAI,GAAS,CAAC,GAAc,CAAC,CAAC;gBACzC,MAAM,OAAO,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAS,KAAiC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAA,0BAAkB,EAAC,KAAK,CAAC,CAAC;gBAEhI,IAAI,CAAC,OAAO,EAAE;oBACZ,OAAO,KAAK,CAAC;iBACd;aACF;SACF;KACF;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAlBD,sCAkBC"}

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

@@ -0,0 +1,154 @@
+import { Maybe } from '../value/maybe.type';
+import { FilterKeyValueTuplesInput, KeyValueTuple, KeyValueTupleFilter } from './object.filter.tuple';
+/**
+ * Assigns all undefined values from one or more objects into the target object.
+ *
+ * @param object
+ */
+export declare function overrideInObject<T extends object>(target: Partial<T>, { copy, from, filter }: {
+    copy?: boolean;
+    from: Partial<T>[];
+    filter?: KeyValueTupleFilter<T>;
+}): Partial<T>;
+export declare type OverrideInObjectFunction<T> = (target: Partial<T>) => Partial<T>;
+export declare type OverrideInObjectFunctionFactory<T> = (from: Partial<T>[]) => OverrideInObjectFunction<T>;
+export interface OverrideInObjectFunctionFactoryConfig<T extends object> {
+    filter?: KeyValueTupleFilter<T>;
+    /**
+     * Whether or not to return a copy of the input value, rather than change it directly.
+     * If true, a copy of the input object will be returned.
+     * If false, the input object will be modified.
+     *
+     * False by default.
+     */
+    copy?: boolean;
+    /**
+     * Whether or not the template being applied to objects should be recalculated each time.
+     *
+     * This is only necessary if you expect the input targets to change and you want those changes reflected in your copy functions.
+     *
+     * False by default.
+     */
+    dynamic?: boolean;
+}
+export declare function overrideInObjectFunctionFactory<T extends object>({ filter, copy, dynamic }: OverrideInObjectFunctionFactoryConfig<T>): OverrideInObjectFunctionFactory<T>;
+/**
+ * Merges all input objects into one. The order of overrides is kept, so the right-most item in the array will have priority over all objects before it.
+ *
+ * @param objects
+ */
+export declare function mergeObjects<T extends object>(objects: Maybe<Partial<T>>[], filter?: KeyValueTupleFilter<T>): Partial<T>;
+/**
+ * Merges all values from the input objects into a single object.
+ *
+ * The order of overrides is kept, so the right-most item in the array will have priority over all objects before it.
+ */
+export declare type MergeObjectsFunction<T extends object> = (objects: Maybe<Partial<T>>[]) => Partial<T>;
+export declare function mergeObjectsFunction<T extends object>(filter?: KeyValueTupleFilter<T>): MergeObjectsFunction<T>;
+/**
+ * Returns a copy of the input object with all undefined (and null values if filterNull=true) values filtered/removed from it.
+ *
+ * @param obj
+ * @returns
+ */
+export declare function filterUndefinedValues<T extends object>(obj: T, filterNull?: boolean): T;
+/**
+ * Returns a copy of the input object with all undefined values filtered from it.
+ *
+ * @param obj
+ * @returns
+ */
+export declare const filterOnlyUndefinedValues: GeneralFilterFromPOJOFunction;
+/**
+ * Returns a copy of the input object with all null and undefined values filtered from it.
+ *
+ * @param obj
+ * @returns
+ */
+export declare const filterNullAndUndefinedValues: GeneralFilterFromPOJOFunction;
+/**
+ * Returns all keys that are not associated with an undefined value.
+ *
+ * @param obj
+ * @returns
+ */
+export declare const allNonUndefinedKeys: GeneralFindPOJOKeysFunction;
+/**
+ * Returns all keys that are not associated with a null/undefined value.
+ *
+ * @param obj
+ * @returns
+ */
+export declare const allMaybeSoKeys: GeneralFindPOJOKeysFunction;
+/**
+ * Finds keys from the POJO that meet the filter.
+ *
+ * @param obj
+ * @param filter
+ * @returns
+ */
+export declare function findPOJOKeys<T extends object>(obj: T, filter: FilterKeyValueTuplesInput<T>): (keyof T)[];
+/**
+ * Finds and finds the number of keys from the POJO that meet the filter.
+ */
+export declare type FindPOJOKeysFunction<T> = (obj: T) => (keyof T)[];
+export declare type GeneralFindPOJOKeysFunction = <T extends object>(obj: T) => (keyof T)[];
+export declare function findPOJOKeysFunction<T extends object>(filter: FilterKeyValueTuplesInput<T>): FindPOJOKeysFunction<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>(obj: T, filter?: FilterKeyValueTuplesInput<T>): number;
+/**
+ * Finds and counts the number of keys from the POJO that meet the filter.
+ */
+export declare type CountPOJOKeysFunction<T> = (obj: T) => number;
+export declare function countPOJOKeysFunction<T extends object>(filter?: FilterKeyValueTuplesInput<T>): CountPOJOKeysFunction<T>;
+export interface FilterFromPOJO<T extends object> {
+    copy?: boolean;
+    filter?: Omit<FilterKeyValueTuplesInput<T>, 'inverse'>;
+}
+/**
+ * Removes values, per the the filter config, from the input object.
+ *
+ * @param obj POJO to remove undefined values from.
+ * @param copy Whether or not to return a copy of the input object. Default is true.
+ */
+export declare function filterFromPOJO<T extends object>(obj: T, config?: FilterFromPOJO<T>): T;
+/**
+ * Removes values from the input object.
+ *
+ * @param obj POJO to remove undefined values from.
+ * @param copy Whether or not to return a copy of the input object. Default is true.
+ */
+export declare type FilterFromPOJOFunction<T> = (input: T) => T;
+export declare type GeneralFilterFromPOJOFunction<X = object> = <T extends X>(input: T) => T;
+export declare function filterFromPOJOFunction<T extends object>({ copy, filter: inputFilter }?: FilterFromPOJO<T>): FilterFromPOJOFunction<T>;
+/**
+ * Convenience function from filterFromPOJOFunction with copy set to false and using the default filter.
+ */
+export declare const defaultFilterFromPOJOFunctionNoCopy: FilterFromPOJOFunction<object>;
+export declare function assignValuesToPOJO<T extends object>(target: T, obj: T, filter?: FilterKeyValueTuplesInput<T>): T;
+export declare type AssignValuesToPOJOFunction<T> = (target: T, obj: T) => T;
+export declare function assignValuesToPOJOFunction<T extends object>(filter?: FilterKeyValueTuplesInput<T>): AssignValuesToPOJOFunction<T>;
+/**
+ * Reads values from matching keys based on the filter and puts them into an array.
+ */
+export declare function valuesFromPOJO<O = unknown, I extends object = object>(target: I, filter?: FilterKeyValueTuplesInput<I>): O[];
+/**
+ * Reads values from matching keys based on the filter and puts them into an array.
+ */
+export declare type ValuesFromPOJOFunction<O = unknown, I extends object = object> = (obj: I) => O[];
+export declare function valuesFromPOJOFunction<O = unknown, I extends object = object>(filter?: FilterKeyValueTuplesInput<I>): ValuesFromPOJOFunction<O, I>;
+export declare type ForEachKeyValueOnPOJOTupleFunction<T extends object, C = unknown, K extends keyof T = keyof T> = (tuple: KeyValueTuple<T, K>, index: number, object: T, context: C) => void;
+export declare type ForEachKeyValueOnPOJOFunction<T extends object, C = unknown> = C extends void ? ForEachKeyValueOnPOJOFunctionWithoutContext<T> : ForEachKeyValueOnPOJOFunctionWithContext<T, C>;
+export declare type ForEachKeyValueOnPOJOFunctionWithoutContext<T extends object> = (object: T) => void;
+export declare type ForEachKeyValueOnPOJOFunctionWithContext<T extends object, C = unknown> = (object: T, context: C) => void;
+export declare type ForEachKeyValueOnPOJOConfig<T extends object, C = unknown, K extends keyof T = keyof T> = {
+    filter?: FilterKeyValueTuplesInput<T, K>;
+    forEach: ForEachKeyValueOnPOJOTupleFunction<T, C, K>;
+};
+export declare function forEachKeyValueOnPOJOFunction<T extends object, C = unknown, K extends keyof T = keyof T>({ forEach, filter }: ForEachKeyValueOnPOJOConfig<T, C, K>): ForEachKeyValueOnPOJOFunction<T, C>;

package/src/lib/object/object.filter.pojo.js

@@ -0,0 +1,235 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.forEachKeyValueOnPOJOFunction = exports.valuesFromPOJOFunction = exports.valuesFromPOJO = exports.assignValuesToPOJOFunction = exports.assignValuesToPOJO = exports.defaultFilterFromPOJOFunctionNoCopy = exports.filterFromPOJOFunction = exports.filterFromPOJO = exports.countPOJOKeysFunction = exports.countPOJOKeys = exports.findPOJOKeysFunction = exports.findPOJOKeys = exports.allMaybeSoKeys = exports.allNonUndefinedKeys = exports.filterNullAndUndefinedValues = exports.filterOnlyUndefinedValues = exports.filterUndefinedValues = exports.mergeObjectsFunction = exports.mergeObjects = exports.overrideInObjectFunctionFactory = exports.overrideInObject = void 0;
+const array_value_1 = require("../array/array.value");
+const object_filter_tuple_1 = require("./object.filter.tuple");
+const getter_1 = require("../getter");
+const object_1 = require("./object");
+// MARK: Object Merging/Overriding
+/**
+ * Assigns all undefined values from one or more objects into the target object.
+ *
+ * @param object
+ */
+function overrideInObject(target, { copy = false, from, filter }) {
+    return overrideInObjectFunctionFactory({
+        copy,
+        filter,
+        dynamic: true // using only once, so no need to use the cache
+    })(from)(target);
+}
+exports.overrideInObject = overrideInObject;
+function overrideInObjectFunctionFactory({ filter, copy, dynamic = false }) {
+    const filterToRelevantValuesObject = filter != null ? filterFromPOJOFunction({ filter, copy: false }) : exports.defaultFilterFromPOJOFunctionNoCopy;
+    return (from) => {
+        const rebuildTemplate = () => {
+            const template = {};
+            from.forEach((x) => {
+                const relevantValues = filterToRelevantValuesObject(Object.assign({}, x));
+                Object.assign(template, relevantValues);
+            });
+            return template;
+        };
+        const templateGetter = dynamic ? rebuildTemplate : (0, getter_1.cachedGetter)(rebuildTemplate);
+        return (target) => {
+            const template = templateGetter();
+            if (copy) {
+                target = (0, object_1.copyObject)(target);
+            }
+            Object.assign(target, template);
+            return target;
+        };
+    };
+}
+exports.overrideInObjectFunctionFactory = overrideInObjectFunctionFactory;
+/**
+ * Merges all input objects into one. The order of overrides is kept, so the right-most item in the array will have priority over all objects before it.
+ *
+ * @param objects
+ */
+function mergeObjects(objects, filter) {
+    return mergeObjectsFunction(filter)(objects);
+}
+exports.mergeObjects = mergeObjects;
+function mergeObjectsFunction(filter) {
+    const overrideFn = overrideInObjectFunctionFactory({
+        filter,
+        copy: false,
+        dynamic: true // no need to use cache, as cache won't be used.
+    });
+    return (objects) => overrideFn((0, array_value_1.filterMaybeValues)(objects))({});
+}
+exports.mergeObjectsFunction = mergeObjectsFunction;
+// MARK: POJO
+/**
+ * Returns a copy of the input object with all undefined (and null values if filterNull=true) values filtered/removed from it.
+ *
+ * @param obj
+ * @returns
+ */
+function filterUndefinedValues(obj, filterNull = false) {
+    const filterFn = filterNull ? exports.filterNullAndUndefinedValues : exports.filterOnlyUndefinedValues;
+    return filterFn(obj);
+}
+exports.filterUndefinedValues = filterUndefinedValues;
+/**
+ * Returns a copy of the input object with all undefined values filtered from it.
+ *
+ * @param obj
+ * @returns
+ */
+exports.filterOnlyUndefinedValues = filterFromPOJOFunction({ copy: true, filter: { valueFilter: object_filter_tuple_1.KeyValueTypleValueFilter.UNDEFINED } });
+/**
+ * Returns a copy of the input object with all null and undefined values filtered from it.
+ *
+ * @param obj
+ * @returns
+ */
+exports.filterNullAndUndefinedValues = filterFromPOJOFunction({ copy: true, filter: { valueFilter: object_filter_tuple_1.KeyValueTypleValueFilter.NULL } });
+/**
+ * Returns all keys that are not associated with an undefined value.
+ *
+ * @param obj
+ * @returns
+ */
+exports.allNonUndefinedKeys = findPOJOKeysFunction({ valueFilter: object_filter_tuple_1.KeyValueTypleValueFilter.UNDEFINED });
+/**
+ * Returns all keys that are not associated with a null/undefined value.
+ *
+ * @param obj
+ * @returns
+ */
+exports.allMaybeSoKeys = findPOJOKeysFunction({ valueFilter: object_filter_tuple_1.KeyValueTypleValueFilter.NULL });
+// MARK: FindPOJOKeys
+/**
+ * Finds keys from the POJO that meet the filter.
+ *
+ * @param obj
+ * @param filter
+ * @returns
+ */
+function findPOJOKeys(obj, filter) {
+    return findPOJOKeysFunction(filter)(obj);
+}
+exports.findPOJOKeys = findPOJOKeys;
+function findPOJOKeysFunction(filter) {
+    const findEachMatchingKeyOnTarget = forEachKeyValueOnPOJOFunction({
+        filter,
+        forEach: ([key], i, obj, context) => {
+            context.keys.push(key);
+        }
+    });
+    return (obj) => {
+        const context = { keys: [] };
+        findEachMatchingKeyOnTarget(obj, context);
+        return context.keys;
+    };
+}
+exports.findPOJOKeysFunction = findPOJOKeysFunction;
+// MARK: CountPOJOKeys
+/**
+ * Finds and counts the number of keys from the POJO that meet the filter.
+ *
+ * @param obj
+ * @param filter
+ * @returns
+ */
+function countPOJOKeys(obj, filter = object_filter_tuple_1.KeyValueTypleValueFilter.UNDEFINED) {
+    return countPOJOKeysFunction(filter)(obj);
+}
+exports.countPOJOKeys = countPOJOKeys;
+function countPOJOKeysFunction(filter = object_filter_tuple_1.KeyValueTypleValueFilter.UNDEFINED) {
+    const countEachMatchingKeyOnTarget = forEachKeyValueOnPOJOFunction({
+        filter,
+        forEach: (x, i, obj, context) => {
+            context.count += 1;
+        }
+    });
+    return (obj) => {
+        const context = { count: 0 };
+        countEachMatchingKeyOnTarget(obj, context);
+        return context.count;
+    };
+}
+exports.countPOJOKeysFunction = countPOJOKeysFunction;
+/**
+ * Removes values, per the the filter config, from the input object.
+ *
+ * @param obj POJO to remove undefined values from.
+ * @param copy Whether or not to return a copy of the input object. Default is true.
+ */
+function filterFromPOJO(obj, config = {}) {
+    return filterFromPOJOFunction(config)(obj);
+}
+exports.filterFromPOJO = filterFromPOJO;
+function filterFromPOJOFunction({ copy = false, filter: inputFilter = { valueFilter: object_filter_tuple_1.KeyValueTypleValueFilter.UNDEFINED } } = {}) {
+    const filter = (0, object_filter_tuple_1.filterKeyValueTuplesInputToFilter)(inputFilter);
+    filter.invertFilter = !filter.invertFilter; // use the inversion of the filter to retain values
+    const forEachFn = forEachKeyValueOnPOJOFunction({
+        filter,
+        forEach: ([key], i, object) => {
+            delete object[key];
+        }
+    });
+    return (obj) => {
+        if (copy) {
+            obj = Object.assign({}, obj);
+        }
+        forEachFn(obj);
+        return obj;
+    };
+}
+exports.filterFromPOJOFunction = filterFromPOJOFunction;
+/**
+ * Convenience function from filterFromPOJOFunction with copy set to false and using the default filter.
+ */
+exports.defaultFilterFromPOJOFunctionNoCopy = filterFromPOJOFunction({ copy: false });
+// MARK: AssignValuesToPOJO
+function assignValuesToPOJO(target, obj, filter) {
+    return assignValuesToPOJOFunction(filter)(target, obj);
+}
+exports.assignValuesToPOJO = assignValuesToPOJO;
+function assignValuesToPOJOFunction(filter = object_filter_tuple_1.KeyValueTypleValueFilter.UNDEFINED) {
+    const assignEachValueToTarget = forEachKeyValueOnPOJOFunction({
+        filter,
+        forEach: ([key, value], i, object, target) => {
+            target[key] = value;
+        }
+    });
+    return (target, obj) => {
+        assignEachValueToTarget(obj, target);
+        return obj;
+    };
+}
+exports.assignValuesToPOJOFunction = assignValuesToPOJOFunction;
+// MARK: ValuesFromPOJO
+/**
+ * Reads values from matching keys based on the filter and puts them into an array.
+ */
+function valuesFromPOJO(target, filter = object_filter_tuple_1.KeyValueTypleValueFilter.UNDEFINED) {
+    return valuesFromPOJOFunction(filter)(target);
+}
+exports.valuesFromPOJO = valuesFromPOJO;
+function valuesFromPOJOFunction(filter = object_filter_tuple_1.KeyValueTypleValueFilter.UNDEFINED) {
+    const addValuesFromObjectToContext = forEachKeyValueOnPOJOFunction({
+        filter,
+        forEach: ([, value], i, obj, context) => {
+            context.values.push(value);
+        }
+    });
+    return (obj) => {
+        const context = { values: [] };
+        addValuesFromObjectToContext(obj, context);
+        return context.values;
+    };
+}
+exports.valuesFromPOJOFunction = valuesFromPOJOFunction;
+function forEachKeyValueOnPOJOFunction({ forEach, filter }) {
+    const filterKeyValues = (0, object_filter_tuple_1.filterKeyValueTuplesFunction)(filter);
+    return ((obj, context) => {
+        const keyValues = filterKeyValues(obj);
+        keyValues.forEach((x, i) => forEach(x, i, obj, context));
+    });
+}
+exports.forEachKeyValueOnPOJOFunction = forEachKeyValueOnPOJOFunction;
+//# sourceMappingURL=object.filter.pojo.js.map

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

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

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

@@ -0,0 +1,64 @@
+import { FilterFunction } from '../filter/filter';
+export declare type ForEachKeyValueTupleFunction<T extends object = object, K extends keyof T = keyof T> = (tuple: KeyValueTuple<T, K>, index: number) => void;
+export interface ForEachKeyValue<T extends object = object, K extends keyof T = keyof T> {
+    filter?: FilterKeyValueTuplesInput<T, K>;
+    forEach: ForEachKeyValueTupleFunction<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 filterKeyValueTuples<T extends object = object, K extends keyof T = keyof T>(obj: T, filter?: FilterKeyValueTuplesInput<T, K>): KeyValueTuple<T, K>[];
+/**
+ * A Key-Value pair within an Tuple array value.
+ */
+export declare type KeyValueTuple<T extends object = object, K extends keyof T = keyof T> = [K, T[K]];
+export declare type FilterKeyValueTuplesFunction<T extends object = object, K extends keyof T = keyof T> = (obj: T) => KeyValueTuple<T, K>[];
+export declare function filterKeyValueTuplesFunction<T extends object = object, K extends keyof T = keyof T>(filter?: FilterKeyValueTuplesInput<T, K>): FilterKeyValueTuplesFunction<T, K>;
+export declare function allKeyValueTuples<T extends object = object, K extends keyof T = keyof T>(obj: T): KeyValueTuple<T, K>[];
+export declare type FilterKeyValueTuplesInput<T extends object = object, K extends keyof T = keyof T> = KeyValueTypleValueFilter | KeyValueTupleFilter<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,
+    /**
+     * All values that are empty.
+     */
+    EMPTY = 4,
+    /**
+     * All values that are empty. Objects that have no keys are considered empty too.
+     */
+    EMPTY_STRICT = 5,
+    /**
+     * All values that are falsy or empty.
+     */
+    FALSY_AND_EMPTY = 6,
+    /**
+     * All values that are falsy or empty or an empty objects.
+     */
+    FALSY_AND_EMPTY_STRICT = 7
+}
+export interface KeyValueTupleFilter<T extends object = object, K extends keyof T = keyof T> {
+    valueFilter?: KeyValueTypleValueFilter;
+    invertFilter?: boolean;
+    keysFilter?: K[];
+}
+/**
+ * Converts an input FilterKeyValueTuplesInput to a KeyValueTupleFilter.
+ *
+ * @param input
+ * @returns
+ */
+export declare function filterKeyValueTuplesInputToFilter<T extends object = object, K extends keyof T = keyof T>(input: FilterKeyValueTuplesInput<T, K>): KeyValueTupleFilter<T, K>;
+export declare type FilterKeyValueTupleFunction<T extends object = object, K extends keyof T = keyof T> = FilterFunction<KeyValueTuple<T, K>>;
+export declare function filterKeyValueTupleFunction<T extends object = object, K extends keyof T = keyof T>(inputFilter: FilterKeyValueTuplesInput<T, K>): FilterKeyValueTupleFunction<T, K>;