@iflow-mcp/attio-mcp 1.3.6

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

@@ -0,0 +1,52 @@
+/**
+ * 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, transformFiltersToQueryApiFormat } 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';
+import { createQueryApiFilter, createPathConstraint, createRelationshipQuery, createTimeframeQuery, createContentSearchQuery, createDateRangeQuery, combineQueryFiltersWithAnd, combineQueryFiltersWithOr } from './builders.js';
+export { transformFiltersToApiFormat, transformFiltersToQueryApiFormat, createEqualsFilter, createContainsFilter, combineFiltersWithAnd, combineFiltersWithOr, createDateRangeFilter, createCreatedDateFilter, createModifiedDateFilter, createNumericFilter, createRevenueFilter, createEmployeeCountFilter, createLastInteractionFilter, createActivityFilter, createPeopleByCompanyFilter, createCompaniesByPeopleFilter, createRecordsByListFilter, createPeopleByCompanyListFilter, createCompaniesByPeopleListFilter, createRecordsByNotesFilter, createQueryApiFilter, createPathConstraint, createRelationshipQuery, createTimeframeQuery, createContentSearchQuery, createDateRangeQuery, combineQueryFiltersWithAnd, combineQueryFiltersWithOr, };
+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,EACL,2BAA2B,EAC3B,gCAAgC,EACjC,MAAM,kBAAkB,CAAC;AAC1B,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;AAG5E,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,EAC1B,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,2BAA2B,EAC3B,gCAAgC,EAChC,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,EAE1B,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,GAC1B,CAAC;AAGF,OAAO,EAAE,UAAU,IAAI,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/utils/filters/index.js

@@ -0,0 +1,71 @@
+/**
+ * Central export point for all filter-related functionality
+ * Maintains backward compatibility while providing organized module structure
+ */
+// Export all types
+export * from './types.js';
+// Export all validators
+export * from './validators.js';
+// Export all builders
+export * from './builders.js';
+// Export all translators
+export * from './translators.js';
+// Export all operators
+export * from './operators.js';
+// Export all utilities
+export * from './utils.js';
+// Export cache utilities
+export * from './cache.js';
+// Export relationship utilities
+export * from './relationship.js';
+// Re-export namespaced Basic utilities for backward compatibility
+import { transformFiltersToApiFormat, transformFiltersToQueryApiFormat, } from './translators.js';
+import { validateFilterStructure } from './validators.js';
+import { createEqualsFilter, createContainsFilter, combineWithAnd, combineWithOr, } from './builders.js';
+export const Basic = {
+    validateFilterStructure,
+    transformFiltersToApiFormat,
+    createEqualsFilter,
+    createContainsFilter,
+    combineWithAnd,
+    combineWithOr,
+};
+// Re-export namespaced Range utilities for backward compatibility
+import { createDateRangeFilter, createCreatedDateFilter, createModifiedDateFilter, createNumericFilter, createRevenueFilter, createEmployeeCountFilter, } from './builders.js';
+export const Range = {
+    createDateRangeFilter,
+    createCreatedDateFilter,
+    createModifiedDateFilter,
+    createNumericFilter,
+    createRevenueFilter,
+    createEmployeeCountFilter,
+};
+// Re-export namespaced Activity utilities for backward compatibility
+import { createActivityFilter, createLastInteractionFilter, } from './builders.js';
+export const Activity = {
+    createActivityFilter,
+    createLastInteractionFilter,
+};
+// Re-export namespaced Relationship utilities for backward compatibility
+import { applyRateLimit, createPeopleByCompanyFilter, createCompaniesByPeopleFilter, createRecordsByListFilter, createPeopleByCompanyListFilter, createCompaniesByPeopleListFilter, createRecordsByNotesFilter, } from './relationship.js';
+export const Relationship = {
+    applyRateLimit,
+    createPeopleByCompanyFilter,
+    createCompaniesByPeopleFilter,
+    createRecordsByListFilter,
+    createPeopleByCompanyListFilter,
+    createCompaniesByPeopleListFilter,
+    createRecordsByNotesFilter,
+};
+// Legacy exports for backward compatibility
+import { combineFiltersWithAnd, combineFiltersWithOr } from './builders.js';
+// New Query API imports
+import { createQueryApiFilter, createPathConstraint, createRelationshipQuery, createTimeframeQuery, createContentSearchQuery, createDateRangeQuery, combineQueryFiltersWithAnd, combineQueryFiltersWithOr, } from './builders.js';
+export { transformFiltersToApiFormat, transformFiltersToQueryApiFormat, createEqualsFilter, createContainsFilter, combineFiltersWithAnd, combineFiltersWithOr, createDateRangeFilter, createCreatedDateFilter, createModifiedDateFilter, createNumericFilter, createRevenueFilter, createEmployeeCountFilter, createLastInteractionFilter, createActivityFilter, 
+// Relationship filters
+createPeopleByCompanyFilter, createCompaniesByPeopleFilter, createRecordsByListFilter, createPeopleByCompanyListFilter, createCompaniesByPeopleListFilter, createRecordsByNotesFilter, 
+// New Query API functions
+createQueryApiFilter, createPathConstraint, createRelationshipQuery, createTimeframeQuery, createContentSearchQuery, createDateRangeQuery, combineQueryFiltersWithAnd, combineQueryFiltersWithOr, };
+// Re-export ATTRIBUTES as FILTER_ATTRIBUTES for backward compatibility
+export { ATTRIBUTES as FILTER_ATTRIBUTES } from './types.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/filters/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mBAAmB;AACnB,cAAc,YAAY,CAAC;AAE3B,wBAAwB;AACxB,cAAc,iBAAiB,CAAC;AAEhC,sBAAsB;AACtB,cAAc,eAAe,CAAC;AAE9B,yBAAyB;AACzB,cAAc,kBAAkB,CAAC;AAEjC,uBAAuB;AACvB,cAAc,gBAAgB,CAAC;AAE/B,uBAAuB;AACvB,cAAc,YAAY,CAAC;AAE3B,yBAAyB;AACzB,cAAc,YAAY,CAAC;AAE3B,gCAAgC;AAChC,cAAc,mBAAmB,CAAC;AAElC,kEAAkE;AAClE,OAAO,EACL,2BAA2B,EAC3B,gCAAgC,GACjC,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,aAAa,GACd,MAAM,eAAe,CAAC;AAEvB,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,uBAAuB;IACvB,2BAA2B;IAC3B,kBAAkB;IAClB,oBAAoB;IACpB,cAAc;IACd,aAAa;CACd,CAAC;AAEF,kEAAkE;AAClE,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,eAAe,CAAC;AAEvB,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,qBAAqB;IACrB,uBAAuB;IACvB,wBAAwB;IACxB,mBAAmB;IACnB,mBAAmB;IACnB,yBAAyB;CAC1B,CAAC;AAEF,qEAAqE;AACrE,OAAO,EACL,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,eAAe,CAAC;AAEvB,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,oBAAoB;IACpB,2BAA2B;CAC5B,CAAC;AAEF,yEAAyE;AACzE,OAAO,EACL,cAAc,EACd,2BAA2B,EAC3B,6BAA6B,EAC7B,yBAAyB,EACzB,+BAA+B,EAC/B,iCAAiC,EACjC,0BAA0B,GAC3B,MAAM,mBAAmB,CAAC;AAE3B,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,cAAc;IACd,2BAA2B;IAC3B,6BAA6B;IAC7B,yBAAyB;IACzB,+BAA+B;IAC/B,iCAAiC;IACjC,0BAA0B;CAC3B,CAAC;AAEF,4CAA4C;AAC5C,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE5E,wBAAwB;AACxB,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,2BAA2B,EAC3B,gCAAgC,EAChC,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,2BAA2B,EAC3B,oBAAoB;AACpB,uBAAuB;AACvB,2BAA2B,EAC3B,6BAA6B,EAC7B,yBAAyB,EACzB,+BAA+B,EAC/B,iCAAiC,EACjC,0BAA0B;AAC1B,0BAA0B;AAC1B,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,GAC1B,CAAC;AAEF,uEAAuE;AACvE,OAAO,EAAE,UAAU,IAAI,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,65 @@
+/**
+ * Filter operator implementations and utilities
+ * Provides functionality for working with logical and comparison operators
+ */
+import { ListEntryFilters, FilterConditionType } from './types.js';
+/**
+ * Checks if an operator is supported for a specific field
+ *
+ * @param fieldSlug - The field slug to check
+ * @param operator - The operator to validate
+ * @returns True if the operator is supported for the field
+ */
+export declare function isOperatorSupportedForField(fieldSlug: string, operator: string): boolean;
+/**
+ * Maps a generic operator to a field-specific operator
+ *
+ * @param fieldSlug - The field slug
+ * @param operator - The generic operator
+ * @returns The mapped operator for the specific field
+ */
+export declare function mapOperatorForField(fieldSlug: string, operator: string): string;
+/**
+ * Inverts a filter condition (returns the opposite condition)
+ *
+ * @param condition - The condition to invert
+ * @returns The inverted condition
+ */
+export declare function invertCondition(condition: FilterConditionType): FilterConditionType;
+/**
+ * Creates a NOT filter by inverting all conditions in the given filters
+ *
+ * @param filters - The filters to negate
+ * @returns Negated filter set
+ */
+export declare function createNotFilter(filters: ListEntryFilters): ListEntryFilters;
+/**
+ * Checks if a condition requires a value
+ *
+ * @param condition - The condition to check
+ * @returns True if the condition requires a value
+ */
+export declare function conditionRequiresValue(condition: FilterConditionType): boolean;
+/**
+ * Gets the comparison type for a filter condition
+ *
+ * @param condition - The filter condition
+ * @returns The comparison type (equality, range, text, etc.)
+ */
+export declare function getComparisonType(condition: FilterConditionType): string;
+/**
+ * Determines if two filter conditions are compatible for combination
+ *
+ * @param condition1 - First condition
+ * @param condition2 - Second condition
+ * @returns True if conditions can be combined
+ */
+export declare function areConditionsCompatible(condition1: FilterConditionType, condition2: FilterConditionType): boolean;
+/**
+ * Simplifies a filter by combining compatible conditions
+ *
+ * @param filters - The filters to simplify
+ * @returns Simplified filter set
+ */
+export declare function simplifyFilters(filters: ListEntryFilters): ListEntryFilters;
+//# sourceMappingURL=operators.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operators.d.ts","sourceRoot":"","sources":["../../../src/utils/filters/operators.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,gBAAgB,EAEhB,mBAAmB,EAEpB,MAAM,YAAY,CAAC;AAEpB;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAUT;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,MAAM,CAUR;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,mBAAmB,GAC7B,mBAAmB,CAiBrB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,gBAAgB,CAc3E;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,mBAAmB,GAC7B,OAAO,CAST;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,mBAAmB,GAAG,MAAM,CAiCxE;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,mBAAmB,EAC/B,UAAU,EAAE,mBAAmB,GAC9B,OAAO,CAeT;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,gBAAgB,CA4D3E"}

package/dist/utils/filters/operators.js

@@ -0,0 +1,214 @@
+/**
+ * Filter operator implementations and utilities
+ * Provides functionality for working with logical and comparison operators
+ */
+import { FilterConditionType, FIELD_SPECIAL_HANDLING, } from './types.js';
+/**
+ * Checks if an operator is supported for a specific field
+ *
+ * @param fieldSlug - The field slug to check
+ * @param operator - The operator to validate
+ * @returns True if the operator is supported for the field
+ */
+export function isOperatorSupportedForField(fieldSlug, operator) {
+    const specialHandling = FIELD_SPECIAL_HANDLING[fieldSlug];
+    if (!specialHandling || !specialHandling.operators) {
+        // No special handling defined, assume all operators are supported
+        return true;
+    }
+    // Check if the operator is in the allowed list
+    return specialHandling.operators.includes(operator);
+}
+/**
+ * Maps a generic operator to a field-specific operator
+ *
+ * @param fieldSlug - The field slug
+ * @param operator - The generic operator
+ * @returns The mapped operator for the specific field
+ */
+export function mapOperatorForField(fieldSlug, operator) {
+    const specialHandling = FIELD_SPECIAL_HANDLING[fieldSlug];
+    if (!specialHandling) {
+        return operator;
+    }
+    // Check if there's a mapping for this operator
+    const mappedOperator = specialHandling[operator];
+    return typeof mappedOperator === 'string' ? mappedOperator : operator;
+}
+/**
+ * Inverts a filter condition (returns the opposite condition)
+ *
+ * @param condition - The condition to invert
+ * @returns The inverted condition
+ */
+export function invertCondition(condition) {
+    const inversionMap = {
+        [FilterConditionType.EQUALS]: FilterConditionType.NOT_EQUALS,
+        [FilterConditionType.NOT_EQUALS]: FilterConditionType.EQUALS,
+        [FilterConditionType.CONTAINS]: FilterConditionType.NOT_CONTAINS,
+        [FilterConditionType.NOT_CONTAINS]: FilterConditionType.CONTAINS,
+        [FilterConditionType.GREATER_THAN]: FilterConditionType.LESS_THAN_OR_EQUALS,
+        [FilterConditionType.GREATER_THAN_OR_EQUALS]: FilterConditionType.LESS_THAN,
+        [FilterConditionType.LESS_THAN]: FilterConditionType.GREATER_THAN_OR_EQUALS,
+        [FilterConditionType.LESS_THAN_OR_EQUALS]: FilterConditionType.GREATER_THAN,
+        [FilterConditionType.IS_EMPTY]: FilterConditionType.IS_NOT_EMPTY,
+        [FilterConditionType.IS_NOT_EMPTY]: FilterConditionType.IS_EMPTY,
+    };
+    return inversionMap[condition] || condition;
+}
+/**
+ * Creates a NOT filter by inverting all conditions in the given filters
+ *
+ * @param filters - The filters to negate
+ * @returns Negated filter set
+ */
+export function createNotFilter(filters) {
+    const negatedFilters = (filters.filters &&
+        filters.filters.map((filter) => ({
+            ...filter,
+            condition: invertCondition(filter.condition),
+        }))) ||
+        [];
+    return {
+        filters: negatedFilters,
+        // Invert the matchAny logic as well
+        matchAny: !filters.matchAny,
+    };
+}
+/**
+ * Checks if a condition requires a value
+ *
+ * @param condition - The condition to check
+ * @returns True if the condition requires a value
+ */
+export function conditionRequiresValue(condition) {
+    const noValueConditions = [
+        FilterConditionType.IS_EMPTY,
+        FilterConditionType.IS_NOT_EMPTY,
+        FilterConditionType.IS_SET,
+        FilterConditionType.IS_NOT_SET,
+    ];
+    return !noValueConditions.includes(condition);
+}
+/**
+ * Gets the comparison type for a filter condition
+ *
+ * @param condition - The filter condition
+ * @returns The comparison type (equality, range, text, etc.)
+ */
+export function getComparisonType(condition) {
+    const equalityConditions = [
+        FilterConditionType.EQUALS,
+        FilterConditionType.NOT_EQUALS,
+    ];
+    const rangeConditions = [
+        FilterConditionType.GREATER_THAN,
+        FilterConditionType.GREATER_THAN_OR_EQUALS,
+        FilterConditionType.LESS_THAN,
+        FilterConditionType.LESS_THAN_OR_EQUALS,
+    ];
+    const textConditions = [
+        FilterConditionType.CONTAINS,
+        FilterConditionType.NOT_CONTAINS,
+        FilterConditionType.STARTS_WITH,
+        FilterConditionType.ENDS_WITH,
+    ];
+    const existenceConditions = [
+        FilterConditionType.IS_EMPTY,
+        FilterConditionType.IS_NOT_EMPTY,
+        FilterConditionType.IS_SET,
+        FilterConditionType.IS_NOT_SET,
+    ];
+    if (equalityConditions.includes(condition))
+        return 'equality';
+    if (rangeConditions.includes(condition))
+        return 'range';
+    if (textConditions.includes(condition))
+        return 'text';
+    if (existenceConditions.includes(condition))
+        return 'existence';
+    return 'unknown';
+}
+/**
+ * Determines if two filter conditions are compatible for combination
+ *
+ * @param condition1 - First condition
+ * @param condition2 - Second condition
+ * @returns True if conditions can be combined
+ */
+export function areConditionsCompatible(condition1, condition2) {
+    const type1 = getComparisonType(condition1);
+    const type2 = getComparisonType(condition2);
+    // Same types are generally compatible
+    if (type1 === type2)
+        return true;
+    // Range conditions can be combined (e.g., greater than AND less than)
+    if (type1 === 'range' && type2 === 'range')
+        return true;
+    // Existence conditions cannot be combined with value conditions
+    if (type1 === 'existence' || type2 === 'existence')
+        return false;
+    // Default to incompatible
+    return false;
+}
+/**
+ * Simplifies a filter by combining compatible conditions
+ *
+ * @param filters - The filters to simplify
+ * @returns Simplified filter set
+ */
+export function simplifyFilters(filters) {
+    const simplifiedFilters = [];
+    const filterMap = new Map();
+    // Group filters by attribute
+    filters.filters?.forEach((filter) => {
+        const key = filter.attribute.slug;
+        if (!filterMap.has(key)) {
+            filterMap.set(key, []);
+        }
+        filterMap.get(key).push(filter);
+    });
+    // Simplify each group
+    filterMap.forEach((filterGroup) => {
+        if (filterGroup.length === 1) {
+            // Single filter, no simplification needed
+            simplifiedFilters.push(...filterGroup);
+        }
+        else {
+            // Multiple filters for same attribute, check if they can be combined
+            const rangeFilters = filterGroup.filter((f) => getComparisonType(f.condition) === 'range');
+            if (rangeFilters.length === 2) {
+                // Potentially combinable range filters
+                const [filter1, filter2] = rangeFilters;
+                // Check for min/max combination
+                if ((filter1.condition === FilterConditionType.GREATER_THAN ||
+                    filter1.condition === FilterConditionType.GREATER_THAN_OR_EQUALS) &&
+                    (filter2.condition === FilterConditionType.LESS_THAN ||
+                        filter2.condition === FilterConditionType.LESS_THAN_OR_EQUALS)) {
+                    // This is a valid range, keep both
+                    simplifiedFilters.push(filter1, filter2);
+                }
+                else if ((filter2.condition === FilterConditionType.GREATER_THAN ||
+                    filter2.condition === FilterConditionType.GREATER_THAN_OR_EQUALS) &&
+                    (filter1.condition === FilterConditionType.LESS_THAN ||
+                        filter1.condition === FilterConditionType.LESS_THAN_OR_EQUALS)) {
+                    // This is a valid range, keep both
+                    simplifiedFilters.push(filter1, filter2);
+                }
+                else {
+                    // Incompatible range conditions, keep all
+                    simplifiedFilters.push(...filterGroup);
+                }
+            }
+            else {
+                // Cannot simplify, keep all filters
+                simplifiedFilters.push(...filterGroup);
+            }
+        }
+    });
+    return {
+        filters: simplifiedFilters,
+        matchAny: filters.matchAny,
+    };
+}
+//# sourceMappingURL=operators.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operators.js","sourceRoot":"","sources":["../../../src/utils/filters/operators.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAGL,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAEpB;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CACzC,SAAiB,EACjB,QAAgB;IAEhB,MAAM,eAAe,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAE1D,IAAI,CAAC,eAAe,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,CAAC;QACnD,kEAAkE;QAClE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,+CAA+C;IAC/C,OAAO,eAAe,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,SAAiB,EACjB,QAAgB;IAEhB,MAAM,eAAe,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAE1D,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,+CAA+C;IAC/C,MAAM,cAAc,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IACjD,OAAO,OAAO,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC;AACxE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,SAA8B;IAE9B,MAAM,YAAY,GAEd;QACF,CAAC,mBAAmB,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC,UAAU;QAC5D,CAAC,mBAAmB,CAAC,UAAU,CAAC,EAAE,mBAAmB,CAAC,MAAM;QAC5D,CAAC,mBAAmB,CAAC,QAAQ,CAAC,EAAE,mBAAmB,CAAC,YAAY;QAChE,CAAC,mBAAmB,CAAC,YAAY,CAAC,EAAE,mBAAmB,CAAC,QAAQ;QAChE,CAAC,mBAAmB,CAAC,YAAY,CAAC,EAAE,mBAAmB,CAAC,mBAAmB;QAC3E,CAAC,mBAAmB,CAAC,sBAAsB,CAAC,EAAE,mBAAmB,CAAC,SAAS;QAC3E,CAAC,mBAAmB,CAAC,SAAS,CAAC,EAAE,mBAAmB,CAAC,sBAAsB;QAC3E,CAAC,mBAAmB,CAAC,mBAAmB,CAAC,EAAE,mBAAmB,CAAC,YAAY;QAC3E,CAAC,mBAAmB,CAAC,QAAQ,CAAC,EAAE,mBAAmB,CAAC,YAAY;QAChE,CAAC,mBAAmB,CAAC,YAAY,CAAC,EAAE,mBAAmB,CAAC,QAAQ;KACjE,CAAC;IAEF,OAAO,YAAY,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC;AAC9C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,OAAyB;IACvD,MAAM,cAAc,GAClB,CAAC,OAAO,CAAC,OAAO;QACd,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAC/B,GAAG,MAAM;YACT,SAAS,EAAE,eAAe,CAAC,MAAM,CAAC,SAAgC,CAAC;SACpE,CAAC,CAAC,CAAC;QACN,EAAE,CAAC;IAEL,OAAO;QACL,OAAO,EAAE,cAAc;QACvB,oCAAoC;QACpC,QAAQ,EAAE,CAAC,OAAO,CAAC,QAAQ;KAC5B,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,SAA8B;IAE9B,MAAM,iBAAiB,GAAG;QACxB,mBAAmB,CAAC,QAAQ;QAC5B,mBAAmB,CAAC,YAAY;QAChC,mBAAmB,CAAC,MAAM;QAC1B,mBAAmB,CAAC,UAAU;KAC/B,CAAC;IAEF,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;AAChD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAA8B;IAC9D,MAAM,kBAAkB,GAAG;QACzB,mBAAmB,CAAC,MAAM;QAC1B,mBAAmB,CAAC,UAAU;KAC/B,CAAC;IAEF,MAAM,eAAe,GAAG;QACtB,mBAAmB,CAAC,YAAY;QAChC,mBAAmB,CAAC,sBAAsB;QAC1C,mBAAmB,CAAC,SAAS;QAC7B,mBAAmB,CAAC,mBAAmB;KACxC,CAAC;IAEF,MAAM,cAAc,GAAG;QACrB,mBAAmB,CAAC,QAAQ;QAC5B,mBAAmB,CAAC,YAAY;QAChC,mBAAmB,CAAC,WAAW;QAC/B,mBAAmB,CAAC,SAAS;KAC9B,CAAC;IAEF,MAAM,mBAAmB,GAAG;QAC1B,mBAAmB,CAAC,QAAQ;QAC5B,mBAAmB,CAAC,YAAY;QAChC,mBAAmB,CAAC,MAAM;QAC1B,mBAAmB,CAAC,UAAU;KAC/B,CAAC;IAEF,IAAI,kBAAkB,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,UAAU,CAAC;IAC9D,IAAI,eAAe,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,OAAO,CAAC;IACxD,IAAI,cAAc,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,MAAM,CAAC;IACtD,IAAI,mBAAmB,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,WAAW,CAAC;IAEhE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CACrC,UAA+B,EAC/B,UAA+B;IAE/B,MAAM,KAAK,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAE5C,sCAAsC;IACtC,IAAI,KAAK,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAEjC,sEAAsE;IACtE,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IAExD,gEAAgE;IAChE,IAAI,KAAK,KAAK,WAAW,IAAI,KAAK,KAAK,WAAW;QAAE,OAAO,KAAK,CAAC;IAEjE,0BAA0B;IAC1B,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,OAAyB;IACvD,MAAM,iBAAiB,GAAsB,EAAE,CAAC;IAChD,MAAM,SAAS,GAAG,IAAI,GAAG,EAA6B,CAAC;IAEvD,6BAA6B;IAC7B,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;QAClC,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC;QAClC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACzB,CAAC;QACD,SAAS,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,sBAAsB;IACtB,SAAS,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE;QAChC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,0CAA0C;YAC1C,iBAAiB,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,qEAAqE;YACrE,MAAM,YAAY,GAAG,WAAW,CAAC,MAAM,CACrC,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAgC,CAAC,KAAK,OAAO,CACzE,CAAC;YAEF,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC9B,uCAAuC;gBACvC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,YAAY,CAAC;gBAExC,gCAAgC;gBAChC,IACE,CAAC,OAAO,CAAC,SAAS,KAAK,mBAAmB,CAAC,YAAY;oBACrD,OAAO,CAAC,SAAS,KAAK,mBAAmB,CAAC,sBAAsB,CAAC;oBACnE,CAAC,OAAO,CAAC,SAAS,KAAK,mBAAmB,CAAC,SAAS;wBAClD,OAAO,CAAC,SAAS,KAAK,mBAAmB,CAAC,mBAAmB,CAAC,EAChE,CAAC;oBACD,mCAAmC;oBACnC,iBAAiB,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC3C,CAAC;qBAAM,IACL,CAAC,OAAO,CAAC,SAAS,KAAK,mBAAmB,CAAC,YAAY;oBACrD,OAAO,CAAC,SAAS,KAAK,mBAAmB,CAAC,sBAAsB,CAAC;oBACnE,CAAC,OAAO,CAAC,SAAS,KAAK,mBAAmB,CAAC,SAAS;wBAClD,OAAO,CAAC,SAAS,KAAK,mBAAmB,CAAC,mBAAmB,CAAC,EAChE,CAAC;oBACD,mCAAmC;oBACnC,iBAAiB,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC3C,CAAC;qBAAM,CAAC;oBACN,0CAA0C;oBAC1C,iBAAiB,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;gBACzC,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,oCAAoC;gBACpC,iBAAiB,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE,iBAAiB;QAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CAAC;AACJ,CAAC"}

package/dist/utils/filters/reference-attribute-helper.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Reference Attribute Helper
+ *
+ * Utilities for detecting and handling reference attributes in filter transformations.
+ * Reference attributes (owner, assignee, company, person) require nested field specification
+ * in Attio API filter syntax.
+ */
+import { getAttributeTypeInfo } from '../../api/attribute-types.js';
+export { getAttributeTypeInfo };
+/**
+ * UUID v4 pattern for detecting UUID values
+ * Exported for use in filter translators (PR #904 Phase 2)
+ */
+export declare const UUID_PATTERN: RegExp;
+/**
+ * Email pattern for workspace member validation
+ *
+ * Uses permissive pattern to handle edge cases:
+ * - Test environments may use simplified emails (e.g., test@local.dev)
+ * - Some valid domains have short TLDs or special characters
+ * - Attio API performs canonical validation, so false positives fail fast
+ *
+ * Pattern validates: non-whitespace + @ + non-whitespace + . + non-whitespace
+ * Accepts: user@example.com, test@local.dev, admin@co.uk
+ * Rejects: missing @, missing domain, whitespace, no TLD
+ * Exported for use in filter translators (PR #904 Phase 2)
+ */
+export declare const EMAIL_PATTERN: RegExp;
+/**
+ * Known actor-reference slugs that require special handling in list entry context
+ * When resourceType is unavailable, these slugs with UUID values must use referenced_actor_id
+ * (not record_id) to generate correct actor-reference filter structure
+ * Exported for use in filter translators (PR #904 Phase 2)
+ */
+export declare const KNOWN_ACTOR_REFERENCE_SLUGS: Set<string>;
+/**
+ * Per-request cache for attribute type info to avoid repeated lookups
+ * Key format: `${resourceType}:${attributeSlug}`
+ */
+export type AttributeTypeCache = Map<string, Awaited<ReturnType<typeof getAttributeTypeInfo>>>;
+/**
+ * Check if an attribute is a reference type that requires nested field specification
+ *
+ * @param resourceType - The resource type (e.g., 'deals', 'companies'), or undefined for slug-based fallback
+ * @param attributeSlug - The attribute slug (e.g., 'owner', 'assignee')
+ * @param cache - Optional per-request cache to avoid repeated getAttributeTypeInfo calls
+ * @returns True if the attribute is a reference type
+ */
+export declare function isReferenceAttribute(resourceType: string | undefined, attributeSlug: string, cache?: AttributeTypeCache): Promise<boolean>;
+/**
+ * Determine which field to use for a reference attribute based on the value and type
+ *
+ * @param value - The filter value (can be UUID, name, or array of UUIDs/names for in/not_in operators)
+ * @param attioType - The Attio attribute type (optional)
+ * @returns The field name to use ('record_id', 'name', or 'referenced_actor_id' for actor-reference)
+ */
+export declare function determineReferenceField(value: unknown, attioType?: string): string;
+/**
+ * Get the appropriate reference field for an attribute, considering type-specific mappings
+ *
+ * @param resourceType - The resource type, or undefined for slug-based fallback
+ * @param attributeSlug - The attribute slug
+ * @param value - The filter value
+ * @param cache - Optional per-request cache to avoid repeated getAttributeTypeInfo calls
+ * @returns The field name to use for filtering
+ * @throws FilterValidationError if email validation fails for workspace-member fields
+ */
+export declare function getReferenceFieldForAttribute(resourceType: string | undefined, attributeSlug: string, value: unknown, cache?: AttributeTypeCache): Promise<string>;
+//# sourceMappingURL=reference-attribute-helper.d.ts.map

package/dist/utils/filters/reference-attribute-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-attribute-helper.d.ts","sourceRoot":"","sources":["../../../src/utils/filters/reference-attribute-helper.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAQhE,OAAO,EAAE,oBAAoB,EAAE,CAAC;AAuBhC;;;GAGG;AACH,eAAO,MAAM,YAAY,QACiD,CAAC;AAE3E;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,aAAa,QAA+B,CAAC;AAwB1D;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,aAKtC,CAAC;AAEH;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,GAAG,CAClC,MAAM,EACN,OAAO,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CACjD,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,aAAa,EAAE,MAAM,EACrB,KAAK,CAAC,EAAE,kBAAkB,GACzB,OAAO,CAAC,OAAO,CAAC,CA+BlB;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,EACd,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAuCR;AAED;;;;;;;;;GASG;AACH,wBAAsB,6BAA6B,CACjD,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,OAAO,EACd,KAAK,CAAC,EAAE,kBAAkB,GACzB,OAAO,CAAC,MAAM,CAAC,CA2HjB"}