@pawells/typescript-common 1.0.0

package/build/object/equals.js

@@ -0,0 +1,104 @@
+/**
+ * Performs a deep comparison between two values to determine if they are equivalent.
+ * Handles primitives, objects, arrays, dates, regular expressions, and special values like NaN.
+ *
+ * @param a - First value to compare
+ * @param b - Second value to compare
+ * @returns True if the values are equivalent, false otherwise
+ *
+ * @example
+ * ```typescript
+ * // Primitive values
+ * ObjectEquals(42, 42); // true
+ * ObjectEquals('hello', 'hello'); // true
+ * ObjectEquals(true, false); // false
+ *
+ * // Objects
+ * ObjectEquals({ a: 1, b: 2 }, { a: 1, b: 2 }); // true
+ * ObjectEquals({ a: 1, b: 2 }, { a: 1, b: 3 }); // false
+ *
+ * // Nested objects
+ * const obj1 = { user: { name: 'John', age: 30 }, active: true };
+ * const obj2 = { user: { name: 'John', age: 30 }, active: true };
+ * ObjectEquals(obj1, obj2); // true
+ *
+ * // Arrays
+ * ObjectEquals([1, 2, 3], [1, 2, 3]); // true
+ * ObjectEquals([1, [2, 3]], [1, [2, 3]]); // true
+ *
+ * // Date objects
+ * const date1 = new Date('2023-01-01');
+ * const date2 = new Date('2023-01-01');
+ * ObjectEquals(date1, date2); // true
+ *
+ * // Regular expressions
+ * ObjectEquals(/abc/g, /abc/g); // true
+ * ObjectEquals(/abc/g, /abc/i); // false
+ *
+ * // Special cases
+ * ObjectEquals(NaN, NaN); // true (unlike === comparison)
+ * ObjectEquals(null, undefined); // false
+ * ```
+ */
+export function ObjectEquals(a, b) {
+    // If the values are strictly equal, return true
+    if (a === b)
+        return true;
+    // Handle NaN special case - NaN should equal NaN for assertion purposes
+    if (typeof a === 'number' && typeof b === 'number' && isNaN(a) && isNaN(b)) {
+        return true;
+    }
+    // If either value is null, undefined, or not an object, they can't be equivalent
+    if (a === null || b === null || a === undefined || b === undefined)
+        return false;
+    if (typeof a !== typeof b)
+        return false;
+    if (typeof a !== 'object')
+        return false;
+    // Handle Date objects
+    if (a instanceof Date && b instanceof Date) {
+        return a.getTime() === b.getTime();
+    }
+    // Handle RegExp objects
+    if (a instanceof RegExp && b instanceof RegExp) {
+        return a.toString() === b.toString();
+    }
+    // Handle arrays
+    if (Array.isArray(a) && Array.isArray(b)) {
+        if (a.length !== b.length)
+            return false;
+        // Compare each element in the arrays
+        for (let i = 0; i < a.length; i++) {
+            if (!ObjectEquals(a[i], b[i]))
+                return false;
+        }
+        return true;
+    }
+    // If one is array and the other isn't, they're not equal
+    if (Array.isArray(a) !== Array.isArray(b))
+        return false;
+    // Compare object properties
+    const keysA = Object.keys(a);
+    const keysB = Object.keys(b);
+    if (keysA.length !== keysB.length)
+        return false;
+    // Also compare symbol properties
+    const symbolsA = Object.getOwnPropertySymbols(a);
+    const symbolsB = Object.getOwnPropertySymbols(b);
+    if (symbolsA.length !== symbolsB.length)
+        return false;
+    for (const key of keysA) {
+        if (!Object.hasOwn(b, key))
+            return false;
+        if (!ObjectEquals(a[key], b[key]))
+            return false;
+    }
+    for (const symbol of symbolsA) {
+        if (!Object.getOwnPropertySymbols(b).includes(symbol))
+            return false;
+        if (!ObjectEquals(a[symbol], b[symbol]))
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=equals.js.map

package/build/object/equals.js.map

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

package/build/object/filter-cached.d.ts

@@ -0,0 +1,9 @@
+import type { ICachedObjectFilterOptions, TCachedObjectFilterFunction } from './types.js';
+/**
+ * Creates a cached version of filter for improved performance when filtering the same objects repeatedly
+ *
+ * @param options Configuration options for both the cache and the underlying filter
+ * @returns A cached version of the filter function
+ */
+export declare function ObjectFilterCached<T extends object>(options?: ICachedObjectFilterOptions): TCachedObjectFilterFunction<T>;
+//# sourceMappingURL=filter-cached.d.ts.map

package/build/object/filter-cached.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-cached.d.ts","sourceRoot":"","sources":["../../src/object/filter-cached.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,0BAA0B,EAAE,2BAA2B,EAAwB,MAAM,YAAY,CAAC;AAOhH;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,GAAE,0BAA+B,GAAG,2BAA2B,CAAC,CAAC,CAAC,CAmH7H"}

package/build/object/filter-cached.js

@@ -0,0 +1,108 @@
+import { ObjectFilter } from './filter.js';
+import { ObjectHash } from './hash.js';
+// Cache configuration constants
+const DEFAULT_MAX_CACHE_SIZE = 1000;
+const CACHE_EVICTION_PERCENTAGE = 0.2; // 20%
+const INITIAL_CACHE_HASH_LENGTH = 16;
+/**
+ * Creates a cached version of filter for improved performance when filtering the same objects repeatedly
+ *
+ * @param options Configuration options for both the cache and the underlying filter
+ * @returns A cached version of the filter function
+ */
+export function ObjectFilterCached(options = {}) {
+    const { maxCacheSize = DEFAULT_MAX_CACHE_SIZE, useDeepEqual = false, caseInsensitiveStrings = false, validatePaths = true, } = options;
+    const cache = new Map();
+    let totalCachedEntries = 0;
+    /**
+     * Evicts approximately 20% of entries from the largest per-filter cache bucket
+     * when the total number of cached results exceeds `maxCacheSize`.
+     *
+     * The eviction strategy targets the most-populated bucket to reclaim the most
+     * memory in a single pass while preserving results for other active filters.
+     */
+    const clearOldestEntries = () => {
+        if (cache.size === 0)
+            return;
+        // Find the cache with the most entries
+        let largestCache = null;
+        let largestCacheKey = '';
+        let largestSize = 0;
+        for (const [key, objectCache] of cache.entries()) {
+            if (objectCache.size > largestSize) {
+                largestCache = objectCache;
+                largestCacheKey = key;
+                largestSize = objectCache.size;
+            }
+        }
+        if (largestCache) {
+            // Remove approximately 20% of entries from the largest cache
+            const entriesToRemove = Math.ceil(largestSize * CACHE_EVICTION_PERCENTAGE);
+            let removed = 0;
+            for (const key of largestCache.keys()) {
+                largestCache.delete(key);
+                removed++;
+                if (removed >= entriesToRemove)
+                    break;
+            }
+            // If the cache is now empty, remove it completely
+            if (largestCache.size === 0) {
+                cache.delete(largestCacheKey);
+            }
+            totalCachedEntries -= removed;
+        }
+    };
+    return (cursor, filter) => {
+        // Validate inputs
+        if (!cursor || typeof cursor !== 'object') {
+            return Promise.resolve(false);
+        }
+        if (!filter || typeof filter !== 'object') {
+            return Promise.resolve(true); // Empty filter matches everything
+        }
+        // Optimize cache key generation with shorter hash for better performance
+        const filterKey = ObjectHash(filter).substring(0, INITIAL_CACHE_HASH_LENGTH);
+        // Try to get the object cache for this filter
+        let objectCache = cache.get(filterKey);
+        if (!objectCache) {
+            objectCache = new Map();
+            cache.set(filterKey, objectCache);
+        }
+        // Create optimized hash-based cache key for the object being filtered
+        // Use shorter hash for better memory efficiency and performance
+        let objectKey;
+        try {
+            objectKey = ObjectHash(cursor).substring(0, INITIAL_CACHE_HASH_LENGTH);
+        }
+        catch {
+            // If object has circular references, skip caching and compute directly
+            const filterOptions = {
+                useDeepEqual,
+                caseInsensitiveStrings,
+                validatePaths,
+            };
+            return Promise.resolve(ObjectFilter(cursor, filter, filterOptions));
+        }
+        // Check if we have a cached result
+        if (objectCache.has(objectKey)) {
+            const cachedResult = objectCache.get(objectKey);
+            return Promise.resolve(cachedResult ?? false);
+        }
+        // Calculate the result
+        const filterOptions = {
+            useDeepEqual,
+            caseInsensitiveStrings,
+            validatePaths,
+        };
+        const result = ObjectFilter(cursor, filter, filterOptions);
+        // Cache the result
+        objectCache.set(objectKey, result);
+        totalCachedEntries++;
+        // Ensure the cache size does not exceed the limit
+        if (totalCachedEntries > maxCacheSize) {
+            clearOldestEntries();
+        }
+        return Promise.resolve(result);
+    };
+}
+//# sourceMappingURL=filter-cached.js.map

package/build/object/filter-cached.js.map

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

package/build/object/filter.d.ts

@@ -0,0 +1,85 @@
+import type { IObjectFilterOptions, TPropertyFilter } from './types.js';
+/**
+ * Filters an object based on a provided filter using flexible matching criteria.
+ * Supports dot notation for nested properties, deep equality comparison, case-insensitive string matching,
+ * and array inclusion/subset matching.
+ *
+ * @template T - The type of object being filtered
+ * @param object - The object to filter
+ * @param filter - The filter criteria to apply
+ * @param options - Optional configuration for filtering behavior
+ * @returns True if the object satisfies the filter, false otherwise
+ *
+ * @example
+ * ```typescript
+ * // Basic property matching
+ * const user = { name: 'John', age: 30, active: true };
+ * ObjectFilter(user, { name: 'John' }); // true
+ * ObjectFilter(user, { age: 25 }); // false
+ *
+ * // Multiple properties (AND logic)
+ * ObjectFilter(user, { name: 'John', active: true }); // true
+ * ObjectFilter(user, { name: 'John', age: 25 }); // false
+ *
+ * // Dot notation for nested properties
+ * const profile = {
+ *   user: { name: 'John', details: { age: 30, city: 'NYC' } },
+ *   meta: { created: '2023-01-01', active: true }
+ * };
+ * ObjectFilter(profile, { 'user.name': 'John' }); // true
+ * ObjectFilter(profile, { 'user.details.city': 'NYC' }); // true
+ * ObjectFilter(profile, { 'meta.active': true }); // true
+ *
+ * // Case-insensitive string matching
+ * ObjectFilter(user, { name: 'john' }, { caseInsensitiveStrings: true }); // true
+ * ObjectFilter(user, { name: 'JOHN' }, { caseInsensitiveStrings: true }); // true
+ *
+ * // Array matching - inclusion check
+ * const post = { tags: ['javascript', 'typescript', 'node'], category: 'tech' };
+ * ObjectFilter(post, { tags: 'javascript' }); // true (string in array)
+ * ObjectFilter(post, { tags: 'python' }); // false
+ *
+ * // Array subset matching
+ * ObjectFilter(post, { tags: ['javascript', 'typescript'] }); // true (subset)
+ * ObjectFilter(post, { tags: ['javascript', 'python'] }); // false (not subset)
+ *
+ * // Deep equality for nested objects
+ * const order = {
+ *   items: [{ id: 1, name: 'Book' }, { id: 2, name: 'Pen' }],
+ *   shipping: { address: { city: 'NYC', zip: '10001' } }
+ * };
+ * ObjectFilter(order,
+ *   { shipping: { address: { city: 'NYC' } } },
+ *   { useDeepEqual: true }
+ * ); // true (partial match with deep equality)
+ *
+ * // Path validation (security)
+ * ObjectFilter(profile, { '../malicious': 'value' }, { validatePaths: true }); // false
+ * ObjectFilter(profile, { 'user..name': 'John' }, { validatePaths: true }); // false
+ * ```
+ */
+export declare function ObjectFilter<T>(object: T, filter: Record<string, any>, options?: IObjectFilterOptions): boolean;
+/**
+ * Filters an object's properties using a predicate function.
+ * Creates a new object containing only the properties for which the predicate returns true.
+ *
+ * @template T - The type of the source object
+ * @param obj - The object to filter
+ * @param predicate - A function that takes a property key and value, returning true to include the property
+ * @returns A new object with only the filtered properties
+ *
+ * @example
+ * ```typescript
+ * const obj = { a: 1, b: 2, c: 3, d: 4 };
+ * const filtered = FilterObject(obj, (key, value) => value > 2);
+ * // Result: { c: 3, d: 4 }
+ *
+ * // Type-safe filtering
+ * interface User { id: number; name: string; age: number; }
+ * const user: User = { id: 1, name: 'John', age: 30 };
+ * const publicData = FilterObject(user, (key, value) => key !== 'age');
+ * // Result: { id: 1, name: 'John' }
+ * ```
+ */
+export declare function FilterObject<T extends object>(obj: T, predicate: TPropertyFilter<T>): Partial<T>;
+//# sourceMappingURL=filter.d.ts.map

package/build/object/filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../src/object/filter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AA2HxE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAgDnH;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAiBhG"}

package/build/object/filter.js

@@ -0,0 +1,248 @@
+import { ObjectEquals } from './equals.js';
+import { isPropertyPathSafe } from './security-utils.js';
+/**
+ * Navigates to a nested property value using dot notation path
+ *
+ * @param object - The object to navigate
+ * @param path - The dot notation path (e.g., 'meta.details.category')
+ * @returns The value at the path, or undefined if path doesn't exist
+ */
+function objectGetValueByPath(object, path) {
+    const pathSegments = path.split('.');
+    let current = object;
+    for (const segment of pathSegments) {
+        current = current?.[segment];
+        if (current === undefined || current === null) {
+            return undefined;
+        }
+    }
+    return current;
+}
+/**
+ * Compares two objects using deep equality logic for ObjectFilter
+ *
+ * @param objValue - The object value to compare
+ * @param filterValue - The filter value to compare against
+ * @param caseInsensitiveStrings - Whether to use case-insensitive string comparison
+ * @returns True if the values match according to deep equality rules
+ */
+function objectDeepComparison(objValue, filterValue, caseInsensitiveStrings = false) {
+    // Handle string comparison with case insensitivity option
+    if (caseInsensitiveStrings && typeof objValue === 'string' && typeof filterValue === 'string') {
+        return objValue.toLowerCase() === filterValue.toLowerCase();
+    }
+    // Special handling for Date objects
+    if (objValue instanceof Date && filterValue instanceof Date) {
+        return objValue.getTime() === filterValue.getTime();
+    }
+    // Handle array cases: if objValue is an array, use array comparison logic
+    if (Array.isArray(objValue)) {
+        return objectHandleArrayComparison(objValue, filterValue, caseInsensitiveStrings, true);
+    }
+    // For deeply nested structures, check if filter is a subset of the object
+    if (typeof objValue === 'object' && objValue !== null && typeof filterValue === 'object' && filterValue !== null && !Array.isArray(filterValue)) {
+        return ObjectFilter(objValue, filterValue, { useDeepEqual: true, caseInsensitiveStrings });
+    }
+    // Default case: use full object equality
+    return ObjectEquals(objValue, filterValue);
+}
+/**
+ * Handles array filtering logic with support for string inclusion and subset matching
+ *
+ * @param objValue - The array value from the object
+ * @param filterValue - The filter value to match against
+ * @param caseInsensitiveStrings - Whether to use case-insensitive string comparison
+ * @param useDeepEqual - Whether to use deep equality for nested objects
+ * @returns True if the filter matches the array value
+ */
+function objectHandleArrayComparison(objValue, filterValue, caseInsensitiveStrings, useDeepEqual) {
+    // If filterValue is a string, check if it exists in the array
+    if (typeof filterValue === 'string') {
+        if (caseInsensitiveStrings) {
+            return objValue.some((item) => typeof item === 'string' && item.toLowerCase() === filterValue.toLowerCase());
+        }
+        return objValue.includes(filterValue);
+    }
+    // If filterValue is also an array, check if it's a subset
+    if (Array.isArray(filterValue)) {
+        return filterValue.every((item) => objValue.some((objItem) => objectCompareValues(objItem, item, caseInsensitiveStrings, useDeepEqual)));
+    }
+    // For non-string, non-array filter values, check direct inclusion
+    return objValue.some((item) => objectCompareValues(item, filterValue, caseInsensitiveStrings, useDeepEqual));
+}
+/**
+ * Compare values based on filter criteria
+ *
+ * @param objValue The object value
+ * @param filterValue The filter value to compare against
+ * @param caseInsensitiveStrings Whether to do case-insensitive string comparison
+ * @param useDeepEqual Whether to use deep equality for nested objects
+ * @returns True if values match according to specified criteria
+ */
+function objectCompareValues(objValue, filterValue, caseInsensitiveStrings, useDeepEqual = false) {
+    // Check if objValue is an array
+    if (Array.isArray(objValue)) {
+        return objectHandleArrayComparison(objValue, filterValue, caseInsensitiveStrings, useDeepEqual);
+    }
+    // Handle string comparison with case insensitivity option
+    if (caseInsensitiveStrings && typeof objValue === 'string' && typeof filterValue === 'string') {
+        return objValue.toLowerCase() === filterValue.toLowerCase();
+    }
+    // Special handling for NaN
+    if (typeof objValue === 'number' && typeof filterValue === 'number' && isNaN(objValue) && isNaN(filterValue)) {
+        return true;
+    }
+    // For object filtering with useDeepEqual, check if filterValue is a subset of objValue
+    if (useDeepEqual && typeof objValue === 'object' && objValue !== null && typeof filterValue === 'object' && filterValue !== null && !Array.isArray(filterValue)) {
+        return ObjectFilter(objValue, filterValue, { useDeepEqual: true, caseInsensitiveStrings });
+    }
+    // Use deep equality if requested
+    if (useDeepEqual) {
+        return ObjectEquals(objValue, filterValue);
+    }
+    // Default strict equality
+    return objValue === filterValue;
+}
+/**
+ * Filters an object based on a provided filter using flexible matching criteria.
+ * Supports dot notation for nested properties, deep equality comparison, case-insensitive string matching,
+ * and array inclusion/subset matching.
+ *
+ * @template T - The type of object being filtered
+ * @param object - The object to filter
+ * @param filter - The filter criteria to apply
+ * @param options - Optional configuration for filtering behavior
+ * @returns True if the object satisfies the filter, false otherwise
+ *
+ * @example
+ * ```typescript
+ * // Basic property matching
+ * const user = { name: 'John', age: 30, active: true };
+ * ObjectFilter(user, { name: 'John' }); // true
+ * ObjectFilter(user, { age: 25 }); // false
+ *
+ * // Multiple properties (AND logic)
+ * ObjectFilter(user, { name: 'John', active: true }); // true
+ * ObjectFilter(user, { name: 'John', age: 25 }); // false
+ *
+ * // Dot notation for nested properties
+ * const profile = {
+ *   user: { name: 'John', details: { age: 30, city: 'NYC' } },
+ *   meta: { created: '2023-01-01', active: true }
+ * };
+ * ObjectFilter(profile, { 'user.name': 'John' }); // true
+ * ObjectFilter(profile, { 'user.details.city': 'NYC' }); // true
+ * ObjectFilter(profile, { 'meta.active': true }); // true
+ *
+ * // Case-insensitive string matching
+ * ObjectFilter(user, { name: 'john' }, { caseInsensitiveStrings: true }); // true
+ * ObjectFilter(user, { name: 'JOHN' }, { caseInsensitiveStrings: true }); // true
+ *
+ * // Array matching - inclusion check
+ * const post = { tags: ['javascript', 'typescript', 'node'], category: 'tech' };
+ * ObjectFilter(post, { tags: 'javascript' }); // true (string in array)
+ * ObjectFilter(post, { tags: 'python' }); // false
+ *
+ * // Array subset matching
+ * ObjectFilter(post, { tags: ['javascript', 'typescript'] }); // true (subset)
+ * ObjectFilter(post, { tags: ['javascript', 'python'] }); // false (not subset)
+ *
+ * // Deep equality for nested objects
+ * const order = {
+ *   items: [{ id: 1, name: 'Book' }, { id: 2, name: 'Pen' }],
+ *   shipping: { address: { city: 'NYC', zip: '10001' } }
+ * };
+ * ObjectFilter(order,
+ *   { shipping: { address: { city: 'NYC' } } },
+ *   { useDeepEqual: true }
+ * ); // true (partial match with deep equality)
+ *
+ * // Path validation (security)
+ * ObjectFilter(profile, { '../malicious': 'value' }, { validatePaths: true }); // false
+ * ObjectFilter(profile, { 'user..name': 'John' }, { validatePaths: true }); // false
+ * ```
+ */
+export function ObjectFilter(object, filter, options = {}) {
+    // Default options
+    const { useDeepEqual = false, caseInsensitiveStrings = false, validatePaths = false } = options;
+    for (const key in filter) {
+        // Skip properties that are not own properties of the filter object
+        if (!Object.hasOwn(filter, key))
+            continue;
+        // Handle dot notation paths
+        if (key.includes('.')) {
+            if (validatePaths && !isPropertyPathSafe(key)) {
+                return false;
+            }
+            const objValue = objectGetValueByPath(object, key);
+            if (objValue === undefined) {
+                return false;
+            }
+            // Compare the values
+            const filterValue = filter[key];
+            if (useDeepEqual) {
+                if (!objectDeepComparison(objValue, filterValue, caseInsensitiveStrings)) {
+                    return false;
+                }
+            }
+            else if (!objectCompareValues(objValue, filterValue, caseInsensitiveStrings, useDeepEqual)) {
+                return false;
+            }
+        }
+        else {
+            // Direct property comparison
+            const objValue = object[key];
+            const filterValue = filter[key];
+            if (!(key in object)) {
+                return false;
+            }
+            if (useDeepEqual) {
+                if (!objectDeepComparison(objValue, filterValue, caseInsensitiveStrings)) {
+                    return false;
+                }
+            }
+            else if (!objectCompareValues(objValue, filterValue, caseInsensitiveStrings, useDeepEqual)) {
+                return false;
+            }
+        }
+    }
+    return true;
+}
+/**
+ * Filters an object's properties using a predicate function.
+ * Creates a new object containing only the properties for which the predicate returns true.
+ *
+ * @template T - The type of the source object
+ * @param obj - The object to filter
+ * @param predicate - A function that takes a property key and value, returning true to include the property
+ * @returns A new object with only the filtered properties
+ *
+ * @example
+ * ```typescript
+ * const obj = { a: 1, b: 2, c: 3, d: 4 };
+ * const filtered = FilterObject(obj, (key, value) => value > 2);
+ * // Result: { c: 3, d: 4 }
+ *
+ * // Type-safe filtering
+ * interface User { id: number; name: string; age: number; }
+ * const user: User = { id: 1, name: 'John', age: 30 };
+ * const publicData = FilterObject(user, (key, value) => key !== 'age');
+ * // Result: { id: 1, name: 'John' }
+ * ```
+ */
+export function FilterObject(obj, predicate) {
+    if (!obj || typeof obj !== 'object') {
+        return {};
+    }
+    const result = {};
+    for (const key in obj) {
+        if (Object.hasOwn(obj, key)) {
+            const value = obj[key];
+            if (predicate(key, value)) {
+                result[key] = value;
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=filter.js.map

package/build/object/filter.js.map

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

package/build/object/has-circular-reference.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Checks whether an object contains circular references
+ *
+ * @param obj - The object to check for circular references
+ * @returns True if the object contains circular references, false otherwise
+ */
+export declare function ObjectHasCircularReference(obj: unknown): boolean;
+//# sourceMappingURL=has-circular-reference.d.ts.map

package/build/object/has-circular-reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"has-circular-reference.d.ts","sourceRoot":"","sources":["../../src/object/has-circular-reference.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAyChE"}

package/build/object/has-circular-reference.js

@@ -0,0 +1,40 @@
+/**
+ * Checks whether an object contains circular references
+ *
+ * @param obj - The object to check for circular references
+ * @returns True if the object contains circular references, false otherwise
+ */
+export function ObjectHasCircularReference(obj) {
+    const seen = new WeakSet();
+    const detectCircular = (value) => {
+        // Only check for circular references in non-null objects
+        if (value === null || typeof value !== 'object') {
+            return false;
+        }
+        // If we've seen this object before, it's a circular reference
+        if (seen.has(value)) {
+            return true;
+        }
+        // Mark this object as seen
+        seen.add(value);
+        // For arrays, check each element
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                if (detectCircular(item)) {
+                    return true;
+                }
+            }
+            return false;
+        }
+        // For objects, check each own enumerable property
+        const keys = Object.keys(value);
+        for (const key of keys) {
+            if (detectCircular(value[key])) {
+                return true;
+            }
+        }
+        return false;
+    };
+    return detectCircular(obj);
+}
+//# sourceMappingURL=has-circular-reference.js.map

package/build/object/has-circular-reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"has-circular-reference.js","sourceRoot":"","sources":["../../src/object/has-circular-reference.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CAAC,GAAY;IACtD,MAAM,IAAI,GAAG,IAAI,OAAO,EAAE,CAAC;IAE3B,MAAM,cAAc,GAAG,CAAC,KAAc,EAAW,EAAE;QAClD,yDAAyD;QACzD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACjD,OAAO,KAAK,CAAC;QACd,CAAC;QAED,8DAA8D;QAC9D,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC;QACb,CAAC;QAED,2BAA2B;QAC3B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAEhB,iCAAiC;QACjC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBAC1B,IAAI,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC1B,OAAO,IAAI,CAAC;gBACb,CAAC;YACF,CAAC;YAED,OAAO,KAAK,CAAC;QACd,CAAC;QAED,kDAAkD;QAClD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAgC,CAAC,CAAC;QAE3D,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACxB,IAAI,cAAc,CAAE,KAAiC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBAC7D,OAAO,IAAI,CAAC;YACb,CAAC;QACF,CAAC;QAED,OAAO,KAAK,CAAC;IACd,CAAC,CAAC;IAEF,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC"}