@iflow-mcp/attio-mcp 1.3.6

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

@@ -0,0 +1 @@
+{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../../../src/utils/filters/builders/activity.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,EAGL,gBAAgB,EAChB,SAAS,EACT,cAAc,EACd,eAAe,EAEhB,MAAM,YAAY,CAAC;AAIpB;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,cAAc,GAC7B,gBAAgB,CAqBlB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,SAAS,EACpB,eAAe,CAAC,EAAE,eAAe,GAChC,gBAAgB,CAoClB"}

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

@@ -0,0 +1,65 @@
+/**
+ * Activity related filter builders.
+ */
+// External imports
+import { FilterValidationError } from '../../../errors/api-errors.js';
+import { resolveDateRange } from '../../date-utils.js';
+// Internal imports
+import { FilterConditionType, InteractionType, ATTRIBUTES, } from './types.js';
+import { validateActivityFilter } from '../validators.js';
+import { createDateRangeFilter } from './date.js';
+/**
+ * Creates an activity filter for finding records with specific interaction types within a date range.
+ */
+export function createActivityFilter(activityFilter) {
+    const validated = validateActivityFilter(activityFilter);
+    const filters = [];
+    const dateFilter = createDateRangeFilter(ATTRIBUTES.LAST_INTERACTION, validated.dateRange);
+    if (dateFilter.filters) {
+        filters.push(...dateFilter.filters);
+    }
+    if (validated.interactionType) {
+        filters.push({
+            attribute: { slug: ATTRIBUTES.INTERACTION_TYPE },
+            condition: FilterConditionType.EQUALS,
+            value: validated.interactionType,
+        });
+    }
+    return { filters, matchAny: false };
+}
+/**
+ * Creates a filter for records based on their last interaction date.
+ */
+export function createLastInteractionFilter(dateRange, interactionType) {
+    try {
+        const filters = [];
+        const resolvedRange = resolveDateRange(dateRange);
+        if (resolvedRange.start) {
+            filters.push({
+                attribute: { slug: ATTRIBUTES.LAST_INTERACTION },
+                condition: FilterConditionType.GREATER_THAN_OR_EQUALS,
+                value: resolvedRange.start,
+            });
+        }
+        if (resolvedRange.end) {
+            filters.push({
+                attribute: { slug: ATTRIBUTES.LAST_INTERACTION },
+                condition: FilterConditionType.LESS_THAN_OR_EQUALS,
+                value: resolvedRange.end,
+            });
+        }
+        if (interactionType && interactionType !== InteractionType.ANY) {
+            filters.push({
+                attribute: { slug: ATTRIBUTES.INTERACTION_TYPE },
+                condition: FilterConditionType.EQUALS,
+                value: interactionType,
+            });
+        }
+        return { filters, matchAny: false };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new FilterValidationError(`Failed to create interaction filter: ${message}`);
+    }
+}
+//# sourceMappingURL=activity.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"activity.js","sourceRoot":"","sources":["../../../../src/utils/filters/builders/activity.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,EAKnB,eAAe,EACf,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAElD;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,cAA8B;IAE9B,MAAM,SAAS,GAAG,sBAAsB,CAAC,cAAc,CAAC,CAAC;IACzD,MAAM,OAAO,GAAsB,EAAE,CAAC;IAEtC,MAAM,UAAU,GAAG,qBAAqB,CACtC,UAAU,CAAC,gBAAgB,EAC3B,SAAS,CAAC,SAAS,CACpB,CAAC;IACF,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;QACvB,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,SAAS,CAAC,eAAe,EAAE,CAAC;QAC9B,OAAO,CAAC,IAAI,CAAC;YACX,SAAS,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,gBAAgB,EAAE;YAChD,SAAS,EAAE,mBAAmB,CAAC,MAAM;YACrC,KAAK,EAAE,SAAS,CAAC,eAAe;SACjC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B,CACzC,SAAoB,EACpB,eAAiC;IAEjC,IAAI,CAAC;QACH,MAAM,OAAO,GAAsB,EAAE,CAAC;QACtC,MAAM,aAAa,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAElD,IAAI,aAAa,CAAC,KAAK,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC;gBACX,SAAS,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,gBAAgB,EAAE;gBAChD,SAAS,EAAE,mBAAmB,CAAC,sBAAsB;gBACrD,KAAK,EAAE,aAAa,CAAC,KAAK;aAC3B,CAAC,CAAC;QACL,CAAC;QAED,IAAI,aAAa,CAAC,GAAG,EAAE,CAAC;YACtB,OAAO,CAAC,IAAI,CAAC;gBACX,SAAS,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,gBAAgB,EAAE;gBAChD,SAAS,EAAE,mBAAmB,CAAC,mBAAmB;gBAClD,KAAK,EAAE,aAAa,CAAC,GAAG;aACzB,CAAC,CAAC;QACL,CAAC;QAED,IAAI,eAAe,IAAI,eAAe,KAAK,eAAe,CAAC,GAAG,EAAE,CAAC;YAC/D,OAAO,CAAC,IAAI,CAAC;gBACX,SAAS,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,gBAAgB,EAAE;gBAChD,SAAS,EAAE,mBAAmB,CAAC,MAAM;gBACrC,KAAK,EAAE,eAAe;aACvB,CAAC,CAAC;QACL,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IACtC,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,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,wCAAwC,OAAO,EAAE,CAClD,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * Basic comparison filter builders.
+ */
+import { ListEntryFilters } from './types.js';
+/**
+ * Creates a simple equals filter for any attribute.
+ */
+export declare function createEqualsFilter(attributeSlug: string, value: unknown): ListEntryFilters;
+/**
+ * Creates a simple contains filter for text attributes.
+ */
+export declare function createContainsFilter(attributeSlug: string, value: string): ListEntryFilters;
+//# sourceMappingURL=basic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"basic.d.ts","sourceRoot":"","sources":["../../../../src/utils/filters/builders/basic.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAuB,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnE;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,OAAO,GACb,gBAAgB,CAWlB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,GACZ,gBAAgB,CAWlB"}

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

@@ -0,0 +1,36 @@
+/**
+ * Basic comparison filter builders.
+ */
+// Internal imports
+import { FilterConditionType } from './types.js';
+/**
+ * Creates a simple equals filter for any attribute.
+ */
+export function createEqualsFilter(attributeSlug, value) {
+    return {
+        filters: [
+            {
+                attribute: { slug: attributeSlug },
+                condition: FilterConditionType.EQUALS,
+                value: value, // TODO: Update FilterValue type to accept unknown
+            },
+        ],
+        matchAny: false,
+    };
+}
+/**
+ * Creates a simple contains filter for text attributes.
+ */
+export function createContainsFilter(attributeSlug, value) {
+    return {
+        filters: [
+            {
+                attribute: { slug: attributeSlug },
+                condition: FilterConditionType.CONTAINS,
+                value,
+            },
+        ],
+        matchAny: false,
+    };
+}
+//# sourceMappingURL=basic.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"basic.js","sourceRoot":"","sources":["../../../../src/utils/filters/builders/basic.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,mBAAmB;AACnB,OAAO,EAAE,mBAAmB,EAAoB,MAAM,YAAY,CAAC;AAEnE;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,aAAqB,EACrB,KAAc;IAEd,OAAO;QACL,OAAO,EAAE;YACP;gBACE,SAAS,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;gBAClC,SAAS,EAAE,mBAAmB,CAAC,MAAM;gBACrC,KAAK,EAAE,KAAgC,EAAE,kDAAkD;aAC5F;SACF;QACD,QAAQ,EAAE,KAAK;KAChB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,aAAqB,EACrB,KAAa;IAEb,OAAO;QACL,OAAO,EAAE;YACP;gBACE,SAAS,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;gBAClC,SAAS,EAAE,mBAAmB,CAAC,QAAQ;gBACvC,KAAK;aACN;SACF;QACD,QAAQ,EAAE,KAAK;KAChB,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,31 @@
+/**
+ * Complex and utility filter builders.
+ */
+import { ListEntryFilters } from './types.js';
+/**
+ * Creates a filter for objects in a specific list.
+ */
+export declare function createListFilter(listId: string): ListEntryFilters;
+/**
+ * Creates filters using special field handling rules.
+ */
+export declare function createFilterWithSpecialHandling(attributeSlug: string, operator: string, value: unknown): ListEntryFilters;
+/**
+ * Combines multiple filter sets using OR logic.
+ */
+export declare function createOrFilter(...filterSets: ListEntryFilters[]): ListEntryFilters;
+/**
+ * Combines multiple filter sets using AND logic.
+ */
+export declare function createAndFilter(...filterSets: ListEntryFilters[]): ListEntryFilters;
+/**
+ * Combines multiple filters with AND logic.
+ */
+export declare function combineWithAnd(...filters: ListEntryFilters[]): ListEntryFilters;
+/**
+ * Combines multiple filters with OR logic.
+ */
+export declare function combineWithOr(...filters: ListEntryFilters[]): ListEntryFilters;
+export declare const combineFiltersWithAnd: typeof combineWithAnd;
+export declare const combineFiltersWithOr: typeof combineWithOr;
+//# sourceMappingURL=complex.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"complex.d.ts","sourceRoot":"","sources":["../../../../src/utils/filters/builders/complex.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAGL,gBAAgB,EAGjB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAWjE;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,GACb,gBAAgB,CAiClB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,GAAG,UAAU,EAAE,gBAAgB,EAAE,GAChC,gBAAgB,CAQlB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,GAAG,UAAU,EAAE,gBAAgB,EAAE,GAChC,gBAAgB,CAQlB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,GAAG,OAAO,EAAE,gBAAgB,EAAE,GAC7B,gBAAgB,CAElB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,GAAG,OAAO,EAAE,gBAAgB,EAAE,GAC7B,gBAAgB,CAElB;AAED,eAAO,MAAM,qBAAqB,uBAAiB,CAAC;AACpD,eAAO,MAAM,oBAAoB,sBAAgB,CAAC"}

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

@@ -0,0 +1,92 @@
+/**
+ * Complex and utility filter builders.
+ */
+// Internal imports
+import { FilterConditionType, ATTRIBUTES, FIELD_SPECIAL_HANDLING, } from './types.js';
+/**
+ * Creates a filter for objects in a specific list.
+ */
+export function createListFilter(listId) {
+    return {
+        filters: [
+            {
+                attribute: { slug: ATTRIBUTES.LIST_ID },
+                condition: FilterConditionType.EQUALS,
+                value: listId,
+            },
+        ],
+        matchAny: false,
+    };
+}
+/**
+ * Creates filters using special field handling rules.
+ */
+export function createFilterWithSpecialHandling(attributeSlug, operator, value) {
+    const specialHandling = FIELD_SPECIAL_HANDLING[attributeSlug];
+    if (!specialHandling) {
+        return {
+            filters: [
+                {
+                    attribute: { slug: attributeSlug },
+                    condition: operator,
+                    value: value, // TODO: Update FilterValue type to accept unknown
+                },
+            ],
+            matchAny: false,
+        };
+    }
+    const mappedOperator = specialHandling[operator] || operator;
+    let processedValue = value;
+    if (specialHandling.allowStringValue && typeof value === 'string') {
+        processedValue = value;
+    }
+    return {
+        filters: [
+            {
+                attribute: { slug: attributeSlug },
+                condition: mappedOperator,
+                value: processedValue, // TODO: Update FilterValue type to accept unknown
+            },
+        ],
+        matchAny: false,
+    };
+}
+/**
+ * Combines multiple filter sets using OR logic.
+ */
+export function createOrFilter(...filterSets) {
+    const allFilters = [];
+    filterSets.forEach((filterSet) => {
+        if (filterSet.filters) {
+            allFilters.push(...filterSet.filters);
+        }
+    });
+    return { filters: allFilters, matchAny: true };
+}
+/**
+ * Combines multiple filter sets using AND logic.
+ */
+export function createAndFilter(...filterSets) {
+    const allFilters = [];
+    filterSets.forEach((filterSet) => {
+        if (filterSet.filters) {
+            allFilters.push(...filterSet.filters);
+        }
+    });
+    return { filters: allFilters, matchAny: false };
+}
+/**
+ * Combines multiple filters with AND logic.
+ */
+export function combineWithAnd(...filters) {
+    return createAndFilter(...filters);
+}
+/**
+ * Combines multiple filters with OR logic.
+ */
+export function combineWithOr(...filters) {
+    return createOrFilter(...filters);
+}
+export const combineFiltersWithAnd = combineWithAnd;
+export const combineFiltersWithOr = combineWithOr;
+//# sourceMappingURL=complex.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"complex.js","sourceRoot":"","sources":["../../../../src/utils/filters/builders/complex.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,mBAAmB;AACnB,OAAO,EACL,mBAAmB,EAGnB,UAAU,EACV,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,OAAO;QACL,OAAO,EAAE;YACP;gBACE,SAAS,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,OAAO,EAAE;gBACvC,SAAS,EAAE,mBAAmB,CAAC,MAAM;gBACrC,KAAK,EAAE,MAAM;aACd;SACF;QACD,QAAQ,EAAE,KAAK;KAChB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,+BAA+B,CAC7C,aAAqB,EACrB,QAAgB,EAChB,KAAc;IAEd,MAAM,eAAe,GAAG,sBAAsB,CAAC,aAAa,CAAC,CAAC;IAE9D,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,SAAS,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;oBAClC,SAAS,EAAE,QAA+B;oBAC1C,KAAK,EAAE,KAAgC,EAAE,kDAAkD;iBAC5F;aACF;YACD,QAAQ,EAAE,KAAK;SAChB,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAAG,eAAe,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC;IAC7D,IAAI,cAAc,GAAG,KAAK,CAAC;IAE3B,IAAI,eAAe,CAAC,gBAAgB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAClE,cAAc,GAAG,KAAK,CAAC;IACzB,CAAC;IAED,OAAO;QACL,OAAO,EAAE;YACP;gBACE,SAAS,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;gBAClC,SAAS,EAAE,cAAqC;gBAChD,KAAK,EAAE,cAAyC,EAAE,kDAAkD;aACrG;SACF;QACD,QAAQ,EAAE,KAAK;KAChB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAG,UAA8B;IAEjC,MAAM,UAAU,GAAsB,EAAE,CAAC;IACzC,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;QAC/B,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;YACtB,UAAU,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QACxC,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,GAAG,UAA8B;IAEjC,MAAM,UAAU,GAAsB,EAAE,CAAC;IACzC,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;QAC/B,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;YACtB,UAAU,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QACxC,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAG,OAA2B;IAE9B,OAAO,eAAe,CAAC,GAAG,OAAO,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,GAAG,OAA2B;IAE9B,OAAO,cAAc,CAAC,GAAG,OAAO,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,cAAc,CAAC;AACpD,MAAM,CAAC,MAAM,oBAAoB,GAAG,aAAa,CAAC"}

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

@@ -0,0 +1,17 @@
+/**
+ * Date related filter builders.
+ */
+import { ListEntryFilters, DateRange } from './types.js';
+/**
+ * Creates a date range filter for a specific attribute.
+ */
+export declare function createDateRangeFilter(attributeSlug: string, dateRange: DateRange): ListEntryFilters;
+/**
+ * Creates a filter for records based on their creation date.
+ */
+export declare function createCreatedDateFilter(dateRange: DateRange): ListEntryFilters;
+/**
+ * Creates a filter for records based on their last modification date.
+ */
+export declare function createModifiedDateFilter(dateRange: DateRange): ListEntryFilters;
+//# sourceMappingURL=date.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../../../src/utils/filters/builders/date.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,EAGL,gBAAgB,EAChB,SAAS,EAEV,MAAM,YAAY,CAAC;AAGpB;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,SAAS,GACnB,gBAAgB,CA6BlB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,SAAS,GACnB,gBAAgB,CAElB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,SAAS,GACnB,gBAAgB,CAElB"}

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,
+                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,SAAS;gBACxC,KAAK,EAAE,QAAQ,CAAC,GAAG;aACpB,CAAC,CAAC;QACL,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IACtC,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,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,9 @@
+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';
+export * from './query-api.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;AAC3B,cAAc,gBAAgB,CAAC"}

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

@@ -0,0 +1,9 @@
+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';
+export * from './query-api.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;AAC3B,cAAc,gBAAgB,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,KAAc,EAAE,CAAC;QACxB,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/query-api.d.ts

@@ -0,0 +1,71 @@
+/**
+ * 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
+ */
+import { AttioQueryApiFilter, PathConstraint, RelationshipQuery, TimeframeQuery } from '../types.js';
+/**
+ * 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 declare function createQueryApiFilter(path: string[], operator: string, value: unknown): AttioQueryApiFilter;
+/**
+ * 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 declare function createPathConstraint(path: string[], operator: string, value: unknown): PathConstraint;
+/**
+ * Creates a relationship query for filtering by connected records (TC-010)
+ *
+ * @param config - Relationship query configuration
+ * @returns Query API filter for relationship search
+ */
+export declare function createRelationshipQuery(config: RelationshipQuery): AttioQueryApiFilter;
+/**
+ * Creates a timeframe/date range query (TC-012)
+ *
+ * @param config - Timeframe query configuration
+ * @returns Query API filter for date filtering
+ */
+export declare function createTimeframeQuery(config: TimeframeQuery): AttioQueryApiFilter;
+/**
+ * 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 declare function createContentSearchQuery(fields: string[], query: string, useOrLogic?: boolean): AttioQueryApiFilter;
+/**
+ * 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 declare function createDateRangeQuery(attribute: string, startDate: string, endDate: string): AttioQueryApiFilter;
+/**
+ * Combines multiple query API filters with AND logic
+ *
+ * @param filters - Array of query API filters to combine
+ * @returns Combined filter with AND logic
+ */
+export declare function combineQueryFiltersWithAnd(filters: AttioQueryApiFilter[]): AttioQueryApiFilter;
+/**
+ * Combines multiple query API filters with OR logic
+ *
+ * @param filters - Array of query API filters to combine
+ * @returns Combined filter with OR logic
+ */
+export declare function combineQueryFiltersWithOr(filters: AttioQueryApiFilter[]): AttioQueryApiFilter;
+//# sourceMappingURL=query-api.d.ts.map

package/dist/utils/filters/builders/query-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-api.d.ts","sourceRoot":"","sources":["../../../../src/utils/filters/builders/query-api.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,cAAc,EACf,MAAM,aAAa,CAAC;AAErB;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EAAE,EACd,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,GACb,mBAAmB,CAYrB;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EAAE,EACd,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,GACb,cAAc,CAUhB;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,iBAAiB,GACxB,mBAAmB,CAyBrB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,cAAc,GACrB,mBAAmB,CAyDrB;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EAAE,EAChB,KAAK,EAAE,MAAM,EACb,UAAU,GAAE,OAAc,GACzB,mBAAmB,CAsDrB;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,mBAAmB,CAOrB;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,mBAAmB,EAAE,GAC7B,mBAAmB,CAUrB;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,mBAAmB,EAAE,GAC7B,mBAAmB,CAUrB"}