attio-mcp 0.1.0

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

@@ -0,0 +1,51 @@
+/**
+ * Date related filter builders.
+ */
+// External imports
+import { FilterValidationError } from '../../../errors/api-errors.js';
+import { resolveDateRange } from '../../date-utils.js';
+// Internal imports
+import { FilterConditionType, ATTRIBUTES, } from './types.js';
+import { validateDateRange } from '../validators.js';
+/**
+ * Creates a date range filter for a specific attribute.
+ */
+export function createDateRangeFilter(attributeSlug, dateRange) {
+    try {
+        const validated = validateDateRange(dateRange);
+        const resolved = resolveDateRange(validated);
+        const filters = [];
+        if (resolved.start) {
+            filters.push({
+                attribute: { slug: attributeSlug },
+                condition: FilterConditionType.GREATER_THAN_OR_EQUALS,
+                value: resolved.start,
+            });
+        }
+        if (resolved.end) {
+            filters.push({
+                attribute: { slug: attributeSlug },
+                condition: FilterConditionType.LESS_THAN_OR_EQUALS,
+                value: resolved.end,
+            });
+        }
+        return { filters, matchAny: false };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new FilterValidationError(`Failed to create date range filter: ${message}`);
+    }
+}
+/**
+ * Creates a filter for records based on their creation date.
+ */
+export function createCreatedDateFilter(dateRange) {
+    return createDateRangeFilter(ATTRIBUTES.CREATED_AT, dateRange);
+}
+/**
+ * Creates a filter for records based on their last modification date.
+ */
+export function createModifiedDateFilter(dateRange) {
+    return createDateRangeFilter(ATTRIBUTES.UPDATED_AT, dateRange);
+}
+//# sourceMappingURL=date.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"date.js","sourceRoot":"","sources":["../../../../src/utils/filters/builders/date.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,mBAAmB;AACnB,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,mBAAmB;AACnB,OAAO,EACL,mBAAmB,EAInB,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,aAAqB,EACrB,SAAoB;IAEpB,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAsB,EAAE,CAAC;QAEtC,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YACnB,OAAO,CAAC,IAAI,CAAC;gBACX,SAAS,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;gBAClC,SAAS,EAAE,mBAAmB,CAAC,sBAAsB;gBACrD,KAAK,EAAE,QAAQ,CAAC,KAAK;aACtB,CAAC,CAAC;QACL,CAAC;QAED,IAAI,QAAQ,CAAC,GAAG,EAAE,CAAC;YACjB,OAAO,CAAC,IAAI,CAAC;gBACX,SAAS,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;gBAClC,SAAS,EAAE,mBAAmB,CAAC,mBAAmB;gBAClD,KAAK,EAAE,QAAQ,CAAC,GAAG;aACpB,CAAC,CAAC;QACL,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,IAAI,qBAAqB,CAC7B,uCAAuC,OAAO,EAAE,CACjD,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,SAAoB;IAEpB,OAAO,qBAAqB,CAAC,UAAU,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;AACjE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,SAAoB;IAEpB,OAAO,qBAAqB,CAAC,UAAU,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;AACjE,CAAC"}

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

@@ -0,0 +1,8 @@
+export * from './basic.js';
+export * from './date.js';
+export * from './numeric.js';
+export * from './text.js';
+export * from './activity.js';
+export * from './complex.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/filters/builders/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

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

@@ -0,0 +1,8 @@
+export * from './basic.js';
+export * from './date.js';
+export * from './numeric.js';
+export * from './text.js';
+export * from './activity.js';
+export * from './complex.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/utils/filters/builders/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

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

@@ -0,0 +1,17 @@
+/**
+ * Numeric range filter builders.
+ */
+import { ListEntryFilters, NumericRange } from './types.js';
+/**
+ * Creates a numeric filter for a specific attribute.
+ */
+export declare function createNumericFilter(attributeSlug: string, range: NumericRange): ListEntryFilters;
+/**
+ * Creates a filter for employee count.
+ */
+export declare function createEmployeeCountFilter(range: NumericRange): ListEntryFilters;
+/**
+ * Creates a filter for annual revenue.
+ */
+export declare function createRevenueFilter(range: NumericRange): ListEntryFilters;
+//# sourceMappingURL=numeric.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"numeric.d.ts","sourceRoot":"","sources":["../../../../src/utils/filters/builders/numeric.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAGL,gBAAgB,EAChB,YAAY,EAEb,MAAM,YAAY,CAAC;AAGpB;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,YAAY,GAClB,gBAAgB,CA0ClB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,YAAY,GAClB,gBAAgB,CAElB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,gBAAgB,CAEzE"}

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

@@ -0,0 +1,61 @@
+/**
+ * Numeric range filter builders.
+ */
+// External imports
+import { FilterValidationError } from '../../../errors/api-errors.js';
+// Internal imports
+import { FilterConditionType, ATTRIBUTES, } from './types.js';
+import { validateNumericRange } from '../validators.js';
+/**
+ * Creates a numeric filter for a specific attribute.
+ */
+export function createNumericFilter(attributeSlug, range) {
+    try {
+        const validatedRange = validateNumericRange(range);
+        if (validatedRange.equals !== undefined) {
+            return {
+                filters: [
+                    {
+                        attribute: { slug: attributeSlug },
+                        condition: FilterConditionType.EQUALS,
+                        value: validatedRange.equals,
+                    },
+                ],
+                matchAny: false,
+            };
+        }
+        const filters = [];
+        if (validatedRange.min !== undefined) {
+            filters.push({
+                attribute: { slug: attributeSlug },
+                condition: FilterConditionType.GREATER_THAN_OR_EQUALS,
+                value: validatedRange.min,
+            });
+        }
+        if (validatedRange.max !== undefined) {
+            filters.push({
+                attribute: { slug: attributeSlug },
+                condition: FilterConditionType.LESS_THAN_OR_EQUALS,
+                value: validatedRange.max,
+            });
+        }
+        return { filters, matchAny: false };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new FilterValidationError(`Failed to create numeric filter: ${message}`);
+    }
+}
+/**
+ * Creates a filter for employee count.
+ */
+export function createEmployeeCountFilter(range) {
+    return createNumericFilter(ATTRIBUTES.EMPLOYEE_COUNT, range);
+}
+/**
+ * Creates a filter for annual revenue.
+ */
+export function createRevenueFilter(range) {
+    return createNumericFilter(ATTRIBUTES.REVENUE, range);
+}
+//# sourceMappingURL=numeric.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"numeric.js","sourceRoot":"","sources":["../../../../src/utils/filters/builders/numeric.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,mBAAmB;AACnB,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,mBAAmB;AACnB,OAAO,EACL,mBAAmB,EAInB,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,aAAqB,EACrB,KAAmB;IAEnB,IAAI,CAAC;QACH,MAAM,cAAc,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAEnD,IAAI,cAAc,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACxC,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,SAAS,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;wBAClC,SAAS,EAAE,mBAAmB,CAAC,MAAM;wBACrC,KAAK,EAAE,cAAc,CAAC,MAAM;qBAC7B;iBACF;gBACD,QAAQ,EAAE,KAAK;aAChB,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAsB,EAAE,CAAC;QAEtC,IAAI,cAAc,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;YACrC,OAAO,CAAC,IAAI,CAAC;gBACX,SAAS,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;gBAClC,SAAS,EAAE,mBAAmB,CAAC,sBAAsB;gBACrD,KAAK,EAAE,cAAc,CAAC,GAAG;aAC1B,CAAC,CAAC;QACL,CAAC;QAED,IAAI,cAAc,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;YACrC,OAAO,CAAC,IAAI,CAAC;gBACX,SAAS,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;gBAClC,SAAS,EAAE,mBAAmB,CAAC,mBAAmB;gBAClD,KAAK,EAAE,cAAc,CAAC,GAAG;aAC1B,CAAC,CAAC;QACL,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,IAAI,qBAAqB,CAC7B,oCAAoC,OAAO,EAAE,CAC9C,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAAmB;IAEnB,OAAO,mBAAmB,CAAC,UAAU,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;AAC/D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAmB;IACrD,OAAO,mBAAmB,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AACxD,CAAC"}

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,CAOlB"}

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

@@ -0,0 +1,47 @@
+/**
+ * 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: ATTRIBUTES.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;YACP,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE;SACzE;QACD,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 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 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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"}

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

@@ -0,0 +1,51 @@
+/**
+ * Central export point for all filter-related functionality
+ * Maintains backward compatibility while providing organized module structure
+ */
+export * from './types.js';
+export * from './validators.js';
+export * from './builders.js';
+export * from './translators.js';
+export * from './operators.js';
+export * from './utils.js';
+export * from './cache.js';
+export * from './relationship.js';
+import { transformFiltersToApiFormat } from './translators.js';
+import { validateFilterStructure } from './validators.js';
+import { createEqualsFilter, createContainsFilter, combineWithAnd, combineWithOr } from './builders.js';
+export declare const Basic: {
+    validateFilterStructure: typeof validateFilterStructure;
+    transformFiltersToApiFormat: typeof transformFiltersToApiFormat;
+    createEqualsFilter: typeof createEqualsFilter;
+    createContainsFilter: typeof createContainsFilter;
+    combineWithAnd: typeof combineWithAnd;
+    combineWithOr: typeof combineWithOr;
+};
+import { createDateRangeFilter, createCreatedDateFilter, createModifiedDateFilter, createNumericFilter, createRevenueFilter, createEmployeeCountFilter } from './builders.js';
+export declare const Range: {
+    createDateRangeFilter: typeof createDateRangeFilter;
+    createCreatedDateFilter: typeof createCreatedDateFilter;
+    createModifiedDateFilter: typeof createModifiedDateFilter;
+    createNumericFilter: typeof createNumericFilter;
+    createRevenueFilter: typeof createRevenueFilter;
+    createEmployeeCountFilter: typeof createEmployeeCountFilter;
+};
+import { createActivityFilter, createLastInteractionFilter } from './builders.js';
+export declare const Activity: {
+    createActivityFilter: typeof createActivityFilter;
+    createLastInteractionFilter: typeof createLastInteractionFilter;
+};
+import { applyRateLimit, createPeopleByCompanyFilter, createCompaniesByPeopleFilter, createRecordsByListFilter, createPeopleByCompanyListFilter, createCompaniesByPeopleListFilter, createRecordsByNotesFilter } from './relationship.js';
+export declare const Relationship: {
+    applyRateLimit: typeof applyRateLimit;
+    createPeopleByCompanyFilter: typeof createPeopleByCompanyFilter;
+    createCompaniesByPeopleFilter: typeof createCompaniesByPeopleFilter;
+    createRecordsByListFilter: typeof createRecordsByListFilter;
+    createPeopleByCompanyListFilter: typeof createPeopleByCompanyListFilter;
+    createCompaniesByPeopleListFilter: typeof createCompaniesByPeopleListFilter;
+    createRecordsByNotesFilter: typeof createRecordsByNotesFilter;
+};
+import { combineFiltersWithAnd, combineFiltersWithOr } from './builders.js';
+export { transformFiltersToApiFormat, createEqualsFilter, createContainsFilter, combineFiltersWithAnd, combineFiltersWithOr, createDateRangeFilter, createCreatedDateFilter, createModifiedDateFilter, createNumericFilter, createRevenueFilter, createEmployeeCountFilter, createLastInteractionFilter, createActivityFilter, createPeopleByCompanyFilter, createCompaniesByPeopleFilter, createRecordsByListFilter, createPeopleByCompanyListFilter, createCompaniesByPeopleListFilter, createRecordsByNotesFilter, };
+export { ATTRIBUTES as FILTER_ATTRIBUTES } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/filters/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,YAAY,CAAC;AAG3B,cAAc,iBAAiB,CAAC;AAGhC,cAAc,eAAe,CAAC;AAG9B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,YAAY,CAAC;AAG3B,cAAc,YAAY,CAAC;AAG3B,cAAc,mBAAmB,CAAC;AAGlC,OAAO,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,aAAa,EACd,MAAM,eAAe,CAAC;AAEvB,eAAO,MAAM,KAAK;;;;;;;CAOjB,CAAC;AAGF,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EAC1B,MAAM,eAAe,CAAC;AAEvB,eAAO,MAAM,KAAK;;;;;;;CAOjB,CAAC;AAGF,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC5B,MAAM,eAAe,CAAC;AAEvB,eAAO,MAAM,QAAQ;;;CAGpB,CAAC;AAGF,OAAO,EACL,cAAc,EACd,2BAA2B,EAC3B,6BAA6B,EAC7B,yBAAyB,EACzB,+BAA+B,EAC/B,iCAAiC,EACjC,0BAA0B,EAC3B,MAAM,mBAAmB,CAAC;AAE3B,eAAO,MAAM,YAAY;;;;;;;;CAQxB,CAAC;AAGF,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE5E,OAAO,EACL,2BAA2B,EAC3B,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,2BAA2B,EAC3B,oBAAoB,EAEpB,2BAA2B,EAC3B,6BAA6B,EAC7B,yBAAyB,EACzB,+BAA+B,EAC/B,iCAAiC,EACjC,0BAA0B,GAC3B,CAAC;AAGF,OAAO,EAAE,UAAU,IAAI,iBAAiB,EAAE,MAAM,YAAY,CAAC"}