@iflow-mcp/attio-mcp 1.3.6

package/dist/utils/filters/builders/query-api.js

@@ -0,0 +1,229 @@
+/**
+ * Query API builders for proper Attio API structure
+ * These functions create the correct query API format with path and constraints
+ * as specified in Issue #523
+ */
+/**
+ * Creates a query API filter with proper path and constraints structure
+ *
+ * @param path - Path array for drilling down through objects
+ * @param operator - Filter operator (equals, contains, etc.)
+ * @param value - Filter value
+ * @returns Query API formatted filter
+ */
+export function createQueryApiFilter(path, operator, value) {
+    return {
+        filter: {
+            path,
+            constraints: [
+                {
+                    operator,
+                    value,
+                },
+            ],
+        },
+    };
+}
+/**
+ * Creates a path constraint for relationship queries
+ *
+ * @param path - Path array for navigation
+ * @param operator - Constraint operator
+ * @param value - Constraint value
+ * @returns Path constraint object
+ */
+export function createPathConstraint(path, operator, value) {
+    return {
+        path,
+        constraints: [
+            {
+                operator,
+                value,
+            },
+        ],
+    };
+}
+/**
+ * Creates a relationship query for filtering by connected records (TC-010)
+ *
+ * @param config - Relationship query configuration
+ * @returns Query API filter for relationship search
+ */
+export function createRelationshipQuery(config) {
+    const { sourceObjectType, targetObjectType, targetAttribute, condition, value, } = config;
+    // Validate required parameters
+    if (!sourceObjectType || !targetObjectType || !targetAttribute) {
+        throw new Error('Relationship query requires sourceObjectType, targetObjectType, and targetAttribute');
+    }
+    if (!condition || !value) {
+        throw new Error('Relationship query requires condition and value');
+    }
+    // Create path for relationship navigation
+    // Example: ["company", "id"] for company relationships
+    const path = [targetObjectType, targetAttribute];
+    return createQueryApiFilter(path, condition, value);
+}
+/**
+ * Creates a timeframe/date range query (TC-012)
+ *
+ * @param config - Timeframe query configuration
+ * @returns Query API filter for date filtering
+ */
+export function createTimeframeQuery(config) {
+    const { resourceType, attribute, startDate, endDate, operator } = config;
+    // Validate required parameters
+    if (!attribute) {
+        throw new Error('Timeframe query requires attribute');
+    }
+    if (!operator) {
+        throw new Error('Timeframe query requires operator');
+    }
+    // Build the proper path - use resourceType + attribute if resourceType is provided
+    // Note: Attio API expects path as nested array format: [[objectType, attribute]]
+    const path = resourceType ? [[resourceType, attribute]] : [[attribute]];
+    // For date range queries
+    if (operator === 'between') {
+        if (!startDate || !endDate) {
+            throw new Error('Between operator requires both startDate and endDate');
+        }
+        return {
+            filter: {
+                path,
+                constraints: {
+                    $gte: startDate,
+                    $lte: endDate,
+                },
+            },
+        };
+    }
+    // For single date comparisons
+    const value = startDate || endDate;
+    if (!value) {
+        throw new Error('Timeframe query requires either startDate or endDate');
+    }
+    // Map operators to constraint format (using Attio's $-prefixed operators)
+    const constraintMap = {
+        greater_than: '$gt',
+        less_than: '$lt',
+        greater_than_or_equals: '$gte',
+        less_than_or_equals: '$lte',
+        equals: 'value',
+    };
+    const constraintKey = constraintMap[operator] || 'value';
+    return {
+        filter: {
+            path,
+            constraints: {
+                [constraintKey]: value,
+            },
+        },
+    };
+}
+/**
+ * Creates a content search query using proper path structure (TC-011)
+ *
+ * @param fields - Array of fields to search across
+ * @param query - Search query string
+ * @param useOrLogic - Whether to use OR logic between fields
+ * @returns Query API filter for content search
+ */
+export function createContentSearchQuery(fields, query, useOrLogic = true) {
+    // Validate required parameters
+    if (!fields || fields.length === 0) {
+        throw new Error('Content search requires at least one field');
+    }
+    if (!query || query.trim().length === 0) {
+        throw new Error('Content search requires a non-empty query');
+    }
+    if (fields.length === 1) {
+        // Single field search
+        return createQueryApiFilter(fields, 'contains', query);
+    }
+    if (useOrLogic) {
+        // Multiple fields with OR logic
+        const orConditions = fields.map((field) => ({
+            filter: {
+                path: [field],
+                constraints: [
+                    {
+                        operator: 'contains',
+                        value: query,
+                    },
+                ],
+            },
+        }));
+        return {
+            filter: {
+                $or: orConditions,
+            },
+        };
+    }
+    else {
+        // Multiple fields with AND logic (all fields must contain the query)
+        const andConditions = fields.map((field) => ({
+            filter: {
+                path: [field],
+                constraints: [
+                    {
+                        operator: 'contains',
+                        value: query,
+                    },
+                ],
+            },
+        }));
+        return {
+            filter: {
+                $and: andConditions,
+            },
+        };
+    }
+}
+/**
+ * Creates a date range filter for created_at, updated_at, etc.
+ *
+ * @param attribute - Date attribute (created_at, updated_at, etc.)
+ * @param startDate - Start date in ISO format
+ * @param endDate - End date in ISO format
+ * @returns Query API filter for date range
+ */
+export function createDateRangeQuery(attribute, startDate, endDate) {
+    return createTimeframeQuery({
+        attribute,
+        startDate,
+        endDate,
+        operator: 'between',
+    });
+}
+/**
+ * Combines multiple query API filters with AND logic
+ *
+ * @param filters - Array of query API filters to combine
+ * @returns Combined filter with AND logic
+ */
+export function combineQueryFiltersWithAnd(filters) {
+    if (filters.length === 1) {
+        return filters[0];
+    }
+    return {
+        filter: {
+            $and: filters,
+        },
+    };
+}
+/**
+ * Combines multiple query API filters with OR logic
+ *
+ * @param filters - Array of query API filters to combine
+ * @returns Combined filter with OR logic
+ */
+export function combineQueryFiltersWithOr(filters) {
+    if (filters.length === 1) {
+        return filters[0];
+    }
+    return {
+        filter: {
+            $or: filters,
+        },
+    };
+}
+//# sourceMappingURL=query-api.js.map

package/dist/utils/filters/builders/query-api.js.map

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

package/dist/utils/filters/builders/text.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Text based filter builders.
+ */
+import { FilterConditionType, ListEntryFilters } from './types.js';
+/**
+ * Creates a phone number filter.
+ */
+export declare function createPhoneFilter(phoneCondition: FilterConditionType, phoneValue?: string): ListEntryFilters;
+/**
+ * Creates an email filter.
+ */
+export declare function createEmailFilter(emailCondition: FilterConditionType, emailValue?: string): ListEntryFilters;
+/**
+ * Creates a filter for a specific industry.
+ */
+export declare function createIndustryFilter(industry: string, condition?: FilterConditionType): ListEntryFilters;
+//# sourceMappingURL=text.d.ts.map

package/dist/utils/filters/builders/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../../src/utils/filters/builders/text.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,mBAAmB,EAEnB,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,cAAc,EAAE,mBAAmB,EACnC,UAAU,CAAC,EAAE,MAAM,GAClB,gBAAgB,CAelB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,cAAc,EAAE,mBAAmB,EACnC,UAAU,CAAC,EAAE,MAAM,GAClB,gBAAgB,CAelB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,mBAAgD,GAC1D,gBAAgB,CAKlB"}

package/dist/utils/filters/builders/text.js

@@ -0,0 +1,45 @@
+/**
+ * Text based filter builders.
+ */
+// Internal imports
+import { FilterConditionType, ATTRIBUTES, } from './types.js';
+/**
+ * Creates a phone number filter.
+ */
+export function createPhoneFilter(phoneCondition, phoneValue) {
+    const filter = {
+        attribute: { slug: ATTRIBUTES.PHONE },
+        condition: phoneCondition,
+        value: phoneValue,
+    };
+    if (phoneCondition === FilterConditionType.IS_EMPTY ||
+        phoneCondition === FilterConditionType.IS_NOT_EMPTY) {
+        delete filter.value;
+    }
+    return { filters: [filter], matchAny: false };
+}
+/**
+ * Creates an email filter.
+ */
+export function createEmailFilter(emailCondition, emailValue) {
+    const filter = {
+        attribute: { slug: ATTRIBUTES.EMAIL },
+        condition: emailCondition,
+        value: emailValue,
+    };
+    if (emailCondition === FilterConditionType.IS_EMPTY ||
+        emailCondition === FilterConditionType.IS_NOT_EMPTY) {
+        delete filter.value;
+    }
+    return { filters: [filter], matchAny: false };
+}
+/**
+ * Creates a filter for a specific industry.
+ */
+export function createIndustryFilter(industry, condition = FilterConditionType.EQUALS) {
+    return {
+        filters: [{ attribute: { slug: 'industry' }, condition, value: industry }],
+        matchAny: false,
+    };
+}
+//# sourceMappingURL=text.js.map

package/dist/utils/filters/builders/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../../../src/utils/filters/builders/text.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,mBAAmB;AACnB,OAAO,EACL,mBAAmB,EAGnB,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,cAAmC,EACnC,UAAmB;IAEnB,MAAM,MAAM,GAAoB;QAC9B,SAAS,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,KAAK,EAAE;QACrC,SAAS,EAAE,cAAc;QACzB,KAAK,EAAE,UAAU;KAClB,CAAC;IAEF,IACE,cAAc,KAAK,mBAAmB,CAAC,QAAQ;QAC/C,cAAc,KAAK,mBAAmB,CAAC,YAAY,EACnD,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,cAAmC,EACnC,UAAmB;IAEnB,MAAM,MAAM,GAAoB;QAC9B,SAAS,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,KAAK,EAAE;QACrC,SAAS,EAAE,cAAc;QACzB,KAAK,EAAE,UAAU;KAClB,CAAC;IAEF,IACE,cAAc,KAAK,mBAAmB,CAAC,QAAQ;QAC/C,cAAc,KAAK,mBAAmB,CAAC,YAAY,EACnD,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAgB,EAChB,YAAiC,mBAAmB,CAAC,MAAM;IAE3D,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;QAC1E,QAAQ,EAAE,KAAK;KAChB,CAAC;AACJ,CAAC"}

package/dist/utils/filters/builders/types.d.ts

@@ -0,0 +1,2 @@
+export * from '../types.js';
+//# sourceMappingURL=types.d.ts.map

package/dist/utils/filters/builders/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/utils/filters/builders/types.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/dist/utils/filters/builders/types.js

@@ -0,0 +1,2 @@
+export * from '../types.js';
+//# sourceMappingURL=types.js.map

package/dist/utils/filters/builders/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/utils/filters/builders/types.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/dist/utils/filters/builders.d.ts

@@ -0,0 +1,2 @@
+export * from './builders/index.js';
+//# sourceMappingURL=builders.d.ts.map

package/dist/utils/filters/builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../../src/utils/filters/builders.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC"}

package/dist/utils/filters/builders.js

@@ -0,0 +1,2 @@
+export * from './builders/index.js';
+//# sourceMappingURL=builders.js.map

package/dist/utils/filters/builders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.js","sourceRoot":"","sources":["../../../src/utils/filters/builders.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC"}

package/dist/utils/filters/cache.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Caching layer for filters, especially relationship-based filters
+ * Provides an in-memory LRU cache for expensive filter operations
+ */
+import { ListEntryFilters } from '../../api/operations/index.js';
+import { ResourceType, RelationshipType } from '../../types/attio.js';
+/**
+ * Key structure for relationship filter cache
+ */
+interface RelationshipFilterCacheKey {
+    relationshipType: RelationshipType;
+    sourceType: ResourceType;
+    targetType: ResourceType;
+    targetFilterHash: string;
+    listId?: string;
+    isNested?: boolean;
+}
+/**
+ * Gets a cached relationship filter if available
+ *
+ * @param key - Filter cache key
+ * @returns Cached filter or undefined if not found
+ */
+export declare function getCachedRelationshipFilter(key: RelationshipFilterCacheKey): ListEntryFilters | undefined;
+/**
+ * Caches a relationship filter result
+ *
+ * @param key - Filter cache key
+ * @param filter - Filter to cache
+ */
+export declare function cacheRelationshipFilter(key: RelationshipFilterCacheKey, filter: ListEntryFilters): void;
+/**
+ * Gets a cached list membership filter if available
+ *
+ * @param listId - ID of the list
+ * @param resourceType - Type of records (people or companies)
+ * @returns Cached filter or undefined if not found
+ */
+export declare function getCachedListFilter(listId: string, resourceType: ResourceType): ListEntryFilters | undefined;
+/**
+ * Caches a list membership filter result
+ *
+ * @param listId - ID of the list
+ * @param resourceType - Type of records (people or companies)
+ * @param filter - Filter to cache
+ */
+export declare function cacheListFilter(listId: string, resourceType: ResourceType, filter: ListEntryFilters): void;
+/**
+ * Creates a hash of filter configuration to use as part of the cache key
+ *
+ * @param filters - Filter configuration to hash
+ * @returns String representation of the filter for caching
+ */
+export declare function hashFilters(filters: ListEntryFilters): string;
+/**
+ * Get statistics for the relationship filter cache
+ *
+ * @returns Cache statistics
+ */
+export declare function getRelationshipCacheStats(): {
+    size: number;
+    maxSize: number;
+    ttlMs: number;
+};
+/**
+ * Get statistics for the list membership cache
+ *
+ * @returns Cache statistics
+ */
+export declare function getListCacheStats(): {
+    size: number;
+    maxSize: number;
+    ttlMs: number;
+};
+/**
+ * Clear all caches
+ */
+export declare function clearAllCaches(): void;
+export {};
+//# sourceMappingURL=cache.d.ts.map

package/dist/utils/filters/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/utils/filters/cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AA4JtE;;GAEG;AACH,UAAU,0BAA0B;IAClC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,UAAU,EAAE,YAAY,CAAC;IACzB,UAAU,EAAE,YAAY,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAsBD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,0BAA0B,GAC9B,gBAAgB,GAAG,SAAS,CAE9B;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,0BAA0B,EAC/B,MAAM,EAAE,gBAAgB,GACvB,IAAI,CAEN;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,YAAY,GACzB,gBAAgB,GAAG,SAAS,CAG9B;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,gBAAgB,GACvB,IAAI,CAGN;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAG7D;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf,CAEA;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf,CAEA;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAGrC"}

package/dist/utils/filters/cache.js

@@ -0,0 +1,212 @@
+/**
+ * LRU Cache implementation with time-based expiration
+ */
+class LRUCache {
+    cache;
+    maxSize;
+    ttlMs;
+    /**
+     * Create a new LRU cache
+     *
+     * @param maxSize - Maximum number of entries to store
+     * @param ttlMs - Time to live in milliseconds
+     */
+    constructor(maxSize, ttlMs) {
+        this.cache = new Map();
+        this.maxSize = maxSize;
+        this.ttlMs = ttlMs;
+    }
+    /**
+     * Generate a string key from any object
+     *
+     * @param key - Key object to stringify
+     * @returns String representation
+     */
+    getKeyString(key) {
+        return JSON.stringify(key);
+    }
+    /**
+     * Get a value from the cache
+     *
+     * @param key - Cache key
+     * @returns Cached value or undefined if not found or expired
+     */
+    get(key) {
+        const keyString = this.getKeyString(key);
+        const entry = this.cache.get(keyString);
+        // Return undefined if no entry or entry is expired
+        if (!entry || Date.now() - entry.timestamp > this.ttlMs) {
+            if (entry) {
+                // Remove expired entry
+                this.cache.delete(keyString);
+            }
+            return undefined;
+        }
+        // Update hit count
+        entry.hits++;
+        return entry.value;
+    }
+    /**
+     * Store a value in the cache
+     *
+     * @param key - Cache key
+     * @param value - Value to cache
+     */
+    set(key, value) {
+        // Clean up expired entries first
+        this.cleanExpired();
+        const keyString = this.getKeyString(key);
+        // If we're at capacity and the key doesn't already exist,
+        // remove the least recently used item
+        if (this.cache.size >= this.maxSize && !this.cache.has(keyString)) {
+            this.evictLRU();
+        }
+        // Add or update the cache
+        this.cache.set(keyString, {
+            value,
+            timestamp: Date.now(),
+            hits: 1,
+        });
+    }
+    /**
+     * Remove all expired entries from the cache
+     */
+    cleanExpired() {
+        const now = Date.now();
+        for (const [key, entry] of Array.from(this.cache.entries())) {
+            if (now - entry.timestamp > this.ttlMs) {
+                this.cache.delete(key);
+            }
+        }
+    }
+    /**
+     * Remove the least recently used entry from the cache
+     */
+    evictLRU() {
+        let lruKey = null;
+        let lowestHits = Infinity;
+        let oldestTimestamp = Infinity;
+        // Find the entry with lowest hit count, or oldest if tied
+        for (const [key, entry] of Array.from(this.cache.entries())) {
+            if (entry.hits < lowestHits ||
+                (entry.hits === lowestHits && entry.timestamp < oldestTimestamp)) {
+                lruKey = key;
+                lowestHits = entry.hits;
+                oldestTimestamp = entry.timestamp;
+            }
+        }
+        // Remove the LRU entry
+        if (lruKey) {
+            this.cache.delete(lruKey);
+        }
+    }
+    /**
+     * Clear the entire cache
+     */
+    clear() {
+        this.cache.clear();
+    }
+    /**
+     * Get the current size of the cache
+     */
+    get size() {
+        return this.cache.size;
+    }
+    /**
+     * Get statistics about the cache
+     */
+    getStats() {
+        return {
+            size: this.cache.size,
+            maxSize: this.maxSize,
+            ttlMs: this.ttlMs,
+        };
+    }
+}
+/**
+ * Cache for relationship filters with a 5-minute TTL
+ */
+const relationshipFilterCache = new LRUCache(100, // Store up to 100 filter configurations
+5 * 60 * 1000 // 5 minutes TTL
+);
+/**
+ * Cache for list membership filters with a longer 15-minute TTL
+ * since list membership changes less frequently
+ */
+const listMembershipCache = new LRUCache(50, // Store up to 50 list filters
+15 * 60 * 1000 // 15 minutes TTL
+);
+/**
+ * Gets a cached relationship filter if available
+ *
+ * @param key - Filter cache key
+ * @returns Cached filter or undefined if not found
+ */
+export function getCachedRelationshipFilter(key) {
+    return relationshipFilterCache.get(key);
+}
+/**
+ * Caches a relationship filter result
+ *
+ * @param key - Filter cache key
+ * @param filter - Filter to cache
+ */
+export function cacheRelationshipFilter(key, filter) {
+    relationshipFilterCache.set(key, filter);
+}
+/**
+ * Gets a cached list membership filter if available
+ *
+ * @param listId - ID of the list
+ * @param resourceType - Type of records (people or companies)
+ * @returns Cached filter or undefined if not found
+ */
+export function getCachedListFilter(listId, resourceType) {
+    const key = `${listId}:${resourceType}`;
+    return listMembershipCache.get(key);
+}
+/**
+ * Caches a list membership filter result
+ *
+ * @param listId - ID of the list
+ * @param resourceType - Type of records (people or companies)
+ * @param filter - Filter to cache
+ */
+export function cacheListFilter(listId, resourceType, filter) {
+    const key = `${listId}:${resourceType}`;
+    listMembershipCache.set(key, filter);
+}
+/**
+ * Creates a hash of filter configuration to use as part of the cache key
+ *
+ * @param filters - Filter configuration to hash
+ * @returns String representation of the filter for caching
+ */
+export function hashFilters(filters) {
+    // This is a simple hash function, but it's sufficient for caching purposes
+    return JSON.stringify(filters);
+}
+/**
+ * Get statistics for the relationship filter cache
+ *
+ * @returns Cache statistics
+ */
+export function getRelationshipCacheStats() {
+    return relationshipFilterCache.getStats();
+}
+/**
+ * Get statistics for the list membership cache
+ *
+ * @returns Cache statistics
+ */
+export function getListCacheStats() {
+    return listMembershipCache.getStats();
+}
+/**
+ * Clear all caches
+ */
+export function clearAllCaches() {
+    relationshipFilterCache.clear();
+    listMembershipCache.clear();
+}
+//# sourceMappingURL=cache.js.map

package/dist/utils/filters/cache.js.map

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