attio-mcp 0.1.0

package/dist/utils/filters/relationship.js

@@ -0,0 +1,393 @@
+/**
+ * Relationship filtering utilities
+ * These utilities help create filters based on relationships between records
+ */
+// External dependencies
+import { FilterValidationError, RelationshipFilterError, ListRelationshipError, } from '../../errors/api-errors.js';
+// Internal module dependencies
+import { FilterConditionType, RelationshipType, ResourceType, ATTRIBUTES, RelationshipRateLimitError, } from './types.js';
+// import { isValidListId } from "../../validation.js";
+import { createEqualsFilter } from './builders.js';
+import { getCachedRelationshipFilter, cacheRelationshipFilter, getCachedListFilter, cacheListFilter, hashFilters, } from './cache.js';
+/**
+ * Applies rate limiting to relationship queries
+ * Throws RelationshipRateLimitError if the rate limit is exceeded
+ *
+ * @param req - Request object
+ * @param relationshipType - Type of relationship query
+ * @param isNested - Whether this is a nested relationship query
+ * @throws RelationshipRateLimitError if rate limit exceeded
+ */
+export function applyRateLimit(req, relationshipType, isNested = false) {
+    // Check the rate limit
+    // TODO: Restore when checkRelationshipQueryRateLimit is available
+    // const result = checkRelationshipQueryRateLimit(req, relationshipType, isNested);
+    // If not allowed, throw rate limit error
+    // if (!result.allowed) {
+    //   throw new RelationshipRateLimitError(
+    //     `Rate limit exceeded for ${isNested ? 'nested ' : ''}relationship query of type '${relationshipType}'. Try again in ${Math.ceil(result.msUntilReset / 1000)} seconds.`,
+    //     relationshipType,
+    //     result.resetTime,
+    //     result.msUntilReset
+    //   );
+    // }
+}
+/**
+ * Core function to create relationship-based filters
+ * This translates our internal representation to the format expected by the Attio API
+ *
+ * @param config - Relationship filter configuration
+ * @returns Filter in the format expected by Attio API
+ */
+function createRelationshipFilter(config) {
+    // Map our ResourceType to Attio API object names
+    const getObjectName = (type) => {
+        switch (type) {
+            case ResourceType.PEOPLE:
+                return 'people';
+            case ResourceType.COMPANIES:
+                return 'companies';
+            case ResourceType.LISTS:
+                return 'lists';
+            case ResourceType.RECORDS:
+                return 'records';
+            default:
+                throw new Error(`Unsupported resource type: ${type}`);
+        }
+    };
+    // The relationship field should be a custom attribute in the filter
+    return {
+        filters: [
+            {
+                attribute: {
+                    slug: ATTRIBUTES.RELATIONSHIP,
+                },
+                condition: FilterConditionType.EQUALS,
+                value: {
+                    type: config.relationshipType,
+                    target: {
+                        object: getObjectName(config.targetType),
+                        filter: config.targetFilters,
+                    },
+                },
+            },
+        ],
+        matchAny: false,
+    };
+}
+/**
+ * Creates a filter for people based on their associated company attributes
+ * Includes rate limiting for this resource-intensive operation
+ *
+ * @param companyFilter - Filters to apply to the related companies
+ * @param req - Optional request object for rate limiting (if not provided, rate limiting is skipped)
+ * @returns Filter for finding people based on company attributes
+ * @throws RelationshipRateLimitError if rate limit exceeded
+ */
+export function createPeopleByCompanyFilter(companyFilter, req) {
+    try {
+        // Apply rate limiting if request object is provided
+        if (req) {
+            applyRateLimit(req, RelationshipType.WORKS_AT, false);
+        }
+        // Validate company filters
+        if (!companyFilter ||
+            !companyFilter.filters ||
+            companyFilter.filters.length === 0) {
+            throw new RelationshipFilterError('Company filter must contain at least one valid filter condition', ResourceType.PEOPLE.toString(), ResourceType.COMPANIES.toString(), RelationshipType.WORKS_AT);
+        }
+        // Create a relationship filter configuration
+        const relationshipConfig = {
+            sourceType: ResourceType.PEOPLE,
+            targetType: ResourceType.COMPANIES,
+            relationshipType: RelationshipType.WORKS_AT,
+            targetFilters: companyFilter,
+        };
+        // Convert to an Attio API compatible filter
+        return createRelationshipFilter(relationshipConfig);
+    }
+    catch (error) {
+        // Re-throw if it's already a rate limit error
+        if (error instanceof RelationshipRateLimitError) {
+            throw error;
+        }
+        // Check if it's already another specialized error
+        if (error instanceof RelationshipFilterError) {
+            throw error;
+        }
+        // Otherwise, wrap in a FilterValidationError
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        throw new FilterValidationError(`Failed to create people-by-company filter: ${errorMessage}`);
+    }
+}
+/**
+ * Creates a filter for companies based on their associated people attributes
+ * Includes rate limiting for this resource-intensive operation
+ *
+ * @param peopleFilter - Filters to apply to the related people
+ * @param req - Optional request object for rate limiting (if not provided, rate limiting is skipped)
+ * @returns Filter for finding companies based on people attributes
+ * @throws RelationshipRateLimitError if rate limit exceeded
+ */
+export function createCompaniesByPeopleFilter(peopleFilter, req) {
+    try {
+        // Apply rate limiting if request object is provided
+        if (req) {
+            applyRateLimit(req, RelationshipType.EMPLOYS, false);
+        }
+        // Validate people filters
+        if (!peopleFilter ||
+            !peopleFilter.filters ||
+            peopleFilter.filters.length === 0) {
+            throw new RelationshipFilterError('People filter must contain at least one valid filter condition', ResourceType.COMPANIES.toString(), ResourceType.PEOPLE.toString(), RelationshipType.EMPLOYS);
+        }
+        // Create a relationship filter configuration
+        const relationshipConfig = {
+            sourceType: ResourceType.COMPANIES,
+            targetType: ResourceType.PEOPLE,
+            relationshipType: RelationshipType.EMPLOYS,
+            targetFilters: peopleFilter,
+        };
+        // Convert to an Attio API compatible filter
+        return createRelationshipFilter(relationshipConfig);
+    }
+    catch (error) {
+        // Re-throw if it's already a rate limit error
+        if (error instanceof RelationshipRateLimitError) {
+            throw error;
+        }
+        // Check if it's already another specialized error
+        if (error instanceof RelationshipFilterError) {
+            throw error;
+        }
+        // Otherwise, wrap in a FilterValidationError
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        throw new FilterValidationError(`Failed to create companies-by-people filter: ${errorMessage}`);
+    }
+}
+/**
+ * Creates a filter for records that belong to a specific list
+ * Includes rate limiting for this operation and caching for better performance
+ *
+ * @param resourceType - The type of records to filter (people or companies)
+ * @param listId - The ID of the list to filter by
+ * @param req - Optional request object for rate limiting (if not provided, rate limiting is skipped)
+ * @param useCache - Whether to use caching (default: true)
+ * @returns Filter for finding records that belong to the list
+ * @throws RelationshipRateLimitError if rate limit exceeded
+ */
+export function createRecordsByListFilter(resourceType, listId, req, useCache = true) {
+    try {
+        // Check cache first if caching is enabled
+        if (useCache) {
+            const cachedFilter = getCachedListFilter(listId, resourceType);
+            if (cachedFilter) {
+                return cachedFilter;
+            }
+        }
+        // Apply rate limiting if request object is provided
+        if (req) {
+            applyRateLimit(req, RelationshipType.BELONGS_TO_LIST, false);
+        }
+        // Validate list ID format and security using imported function
+        // Validate list ID format and security
+        // TODO: Fix import issue with validation.js
+        if (!listId || !/^list_[a-zA-Z0-9]+$/.test(listId)) {
+            throw new ListRelationshipError('Invalid list ID format. Expected format: list_[alphanumeric]', resourceType.toString(), listId);
+        }
+        // Create a relationship filter configuration
+        const relationshipConfig = {
+            sourceType: resourceType,
+            targetType: ResourceType.LISTS,
+            relationshipType: RelationshipType.BELONGS_TO_LIST,
+            targetFilters: createEqualsFilter(ATTRIBUTES.LIST_ID, listId),
+        };
+        // Convert to an Attio API compatible filter
+        const result = createRelationshipFilter(relationshipConfig);
+        // Cache the result if caching is enabled
+        if (useCache) {
+            cacheListFilter(listId, resourceType, result);
+        }
+        return result;
+    }
+    catch (error) {
+        // Re-throw if it's already a rate limit error
+        if (error instanceof RelationshipRateLimitError) {
+            throw error;
+        }
+        // Check if it's already another specialized error
+        if (error instanceof ListRelationshipError ||
+            error instanceof RelationshipFilterError) {
+            throw error;
+        }
+        // Otherwise, wrap in a FilterValidationError
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        throw new FilterValidationError(`Failed to create records-by-list filter: ${errorMessage}`);
+    }
+}
+/**
+ * Creates a filter for finding people who work at companies in a specific list
+ * This is a nested relationship query with rate limiting and caching applied
+ *
+ * @param listId - The ID of the list that contains companies
+ * @param req - Optional request object for rate limiting (if not provided, rate limiting is skipped)
+ * @param useCache - Whether to use caching (default: true)
+ * @returns Filter for finding people who work at companies in the specified list
+ * @throws RelationshipRateLimitError if rate limit exceeded
+ */
+export function createPeopleByCompanyListFilter(listId, req, useCache = true) {
+    try {
+        // Create a cache key for this nested relationship
+        const cacheKey = {
+            relationshipType: RelationshipType.WORKS_AT,
+            sourceType: ResourceType.PEOPLE,
+            targetType: ResourceType.COMPANIES,
+            targetFilterHash: '', // Will be set later
+            listId: listId,
+            isNested: true,
+        };
+        // Check cache first if caching is enabled
+        if (useCache) {
+            const cachedFilter = getCachedRelationshipFilter(cacheKey);
+            if (cachedFilter) {
+                return cachedFilter;
+            }
+        }
+        // Apply rate limiting if request object is provided
+        if (req) {
+            applyRateLimit(req, RelationshipType.WORKS_AT, true);
+        }
+        // Validate list ID format and security using imported function
+        // Validate list ID format and security
+        // TODO: Fix import issue with validation.js
+        if (!listId || !/^list_[a-zA-Z0-9]+$/.test(listId)) {
+            throw new Error('Invalid list ID format. Expected format: list_[alphanumeric]');
+        }
+        // First, create a filter for companies in the list
+        const companiesInListFilter = createRecordsByListFilter(ResourceType.COMPANIES, listId, undefined, useCache);
+        // Update cache key with the hash of the target filter
+        cacheKey.targetFilterHash = hashFilters(companiesInListFilter);
+        // Then, create a filter for people who work at those companies
+        const result = createPeopleByCompanyFilter(companiesInListFilter);
+        // Cache the result if caching is enabled
+        if (useCache) {
+            cacheRelationshipFilter(cacheKey, result);
+        }
+        return result;
+    }
+    catch (error) {
+        // Re-throw if it's already a rate limit error
+        if (error instanceof RelationshipRateLimitError) {
+            throw error;
+        }
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        throw new FilterValidationError(`Failed to create people-by-company-list filter: ${errorMessage}`);
+    }
+}
+/**
+ * Creates a filter for finding companies that have people in a specific list
+ * This is a nested relationship query with rate limiting and caching applied
+ *
+ * @param listId - The ID of the list that contains people
+ * @param req - Optional request object for rate limiting (if not provided, rate limiting is skipped)
+ * @param useCache - Whether to use caching (default: true)
+ * @returns Filter for finding companies that have people in the specified list
+ * @throws RelationshipRateLimitError if rate limit exceeded
+ */
+export function createCompaniesByPeopleListFilter(listId, req, useCache = true) {
+    try {
+        // Create a cache key for this nested relationship
+        const cacheKey = {
+            relationshipType: RelationshipType.EMPLOYS,
+            sourceType: ResourceType.COMPANIES,
+            targetType: ResourceType.PEOPLE,
+            targetFilterHash: '', // Will be set later
+            listId: listId,
+            isNested: true,
+        };
+        // Check cache first if caching is enabled
+        if (useCache) {
+            const cachedFilter = getCachedRelationshipFilter(cacheKey);
+            if (cachedFilter) {
+                return cachedFilter;
+            }
+        }
+        // Apply rate limiting if request object is provided
+        if (req) {
+            applyRateLimit(req, RelationshipType.EMPLOYS, true);
+        }
+        // Validate list ID format and security using imported function
+        // Validate list ID format and security
+        // TODO: Fix import issue with validation.js
+        if (!listId || !/^list_[a-zA-Z0-9]+$/.test(listId)) {
+            throw new Error('Invalid list ID format. Expected format: list_[alphanumeric]');
+        }
+        // First, create a filter for people in the list
+        const peopleInListFilter = createRecordsByListFilter(ResourceType.PEOPLE, listId, undefined, useCache);
+        // Update cache key with the hash of the target filter
+        cacheKey.targetFilterHash = hashFilters(peopleInListFilter);
+        // Then, create a filter for companies that have those people
+        const result = createCompaniesByPeopleFilter(peopleInListFilter);
+        // Cache the result if caching is enabled
+        if (useCache) {
+            cacheRelationshipFilter(cacheKey, result);
+        }
+        return result;
+    }
+    catch (error) {
+        // Re-throw if it's already a rate limit error
+        if (error instanceof RelationshipRateLimitError) {
+            throw error;
+        }
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        throw new FilterValidationError(`Failed to create companies-by-people-list filter: ${errorMessage}`);
+    }
+}
+/**
+ * Creates a filter for records that have associated notes matching criteria
+ * Includes rate limiting for text search operations
+ *
+ * @param resourceType - The type of records to filter (people or companies)
+ * @param textSearch - Text to search for in the notes
+ * @param req - Optional request object for rate limiting (if not provided, rate limiting is skipped)
+ * @returns Filter for finding records with matching notes
+ * @throws RelationshipRateLimitError if rate limit exceeded
+ */
+export function createRecordsByNotesFilter(resourceType, textSearch, req) {
+    try {
+        // Apply rate limiting if request object is provided
+        if (req) {
+            applyRateLimit(req, RelationshipType.HAS_NOTE, false);
+        }
+        if (!textSearch || textSearch.trim() === '') {
+            throw new Error('Text search query must be provided');
+        }
+        // Create a relationship filter configuration
+        const relationshipConfig = {
+            sourceType: resourceType,
+            targetType: ResourceType.LISTS, // Notes don't have a ResourceType, using LISTS as a placeholder
+            relationshipType: RelationshipType.HAS_NOTE,
+            targetFilters: {
+                filters: [
+                    {
+                        attribute: { slug: ATTRIBUTES.NOTE_CONTENT },
+                        condition: FilterConditionType.CONTAINS,
+                        value: textSearch,
+                    },
+                ],
+                matchAny: false,
+            },
+        };
+        // Convert to an Attio API compatible filter
+        return createRelationshipFilter(relationshipConfig);
+    }
+    catch (error) {
+        // Re-throw if it's already a rate limit error
+        if (error instanceof RelationshipRateLimitError) {
+            throw error;
+        }
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        throw new FilterValidationError(`Failed to create records-by-notes filter: ${errorMessage}`);
+    }
+}
+//# sourceMappingURL=relationship.js.map

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

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

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

@@ -0,0 +1,120 @@
+/**
+ * @module translators
+ *
+ * Filter translation utilities for converting between formats
+ * Handles transformation between MCP filter format and Attio API format
+ *
+ * This module provides:
+ * - MCP to Attio API format transformation
+ * - Support for AND/OR logical operators
+ * - Operator conversion utilities
+ * - Attribute name transformations
+ * - Reverse transformation (API to MCP)
+ */
+import { ListEntryFilters, ListEntryFilter, AttioApiFilter, FilterConditionType } from './types.js';
+/**
+ * Transforms list entry filters to the format expected by the Attio API
+ *
+ * This is the main transformation function that converts MCP filter specifications
+ * into the format expected by the Attio API. It handles both AND and OR logical
+ * operators and provides comprehensive validation.
+ *
+ * **Key Features:**
+ * - Validates filter structure using centralized validation utilities
+ * - Supports both AND logic (default) and OR logic (matchAny: true)
+ * - Handles empty filter arrays gracefully (returns empty object)
+ * - Preserves filter condition types and values
+ * - Provides detailed error messages with examples on validation failure
+ *
+ * @param filters - Filter configuration from the MCP API (may have optional filters array)
+ * @param validateConditions - Whether to validate condition types against known Attio API operators
+ * @returns Transformed filter object for Attio API, or empty object if no valid filters
+ * @throws FilterValidationError if validation fails with consistent error messages and examples
+ *
+ * @example
+ * // Simple filter with a single condition
+ * const simpleFilter = {
+ *   filters: [
+ *     {
+ *       attribute: { slug: 'name' },
+ *       condition: 'contains',
+ *       value: 'Company Inc'
+ *     }
+ *   ]
+ * };
+ *
+ * // Filter with OR logic between conditions
+ * const orFilter = {
+ *   filters: [
+ *     {
+ *       attribute: { slug: 'name' },
+ *       condition: 'contains',
+ *       value: 'Inc'
+ *     },
+ *     {
+ *       attribute: { slug: 'industry' },
+ *       condition: 'equals',
+ *       value: 'Technology'
+ *     }
+ *   ],
+ *   matchAny: true  // Use OR logic
+ * };
+ *
+ * // Filter with multiple conditions (AND logic by default)
+ * const multipleFilter = {
+ *   filters: [
+ *     {
+ *       attribute: { slug: 'name' },
+ *       condition: 'contains',
+ *       value: 'Inc'
+ *     },
+ *     {
+ *       attribute: { slug: 'website' },
+ *       condition: 'contains',
+ *       value: '.com'
+ *     }
+ *   ]
+ * };
+ */
+export declare function transformFiltersToApiFormat(filters: ListEntryFilters | undefined, validateConditions?: boolean): {
+    filter?: AttioApiFilter;
+};
+/**
+ * Converts a single filter operator to API format
+ *
+ * @param operator - The operator to convert (e.g., 'equals', 'contains')
+ * @returns The operator in API format (e.g., '$equals', '$contains')
+ */
+export declare function convertOperatorToApiFormat(operator: string): string;
+/**
+ * Transforms attribute names if they require special handling
+ *
+ * @param attributeSlug - The attribute slug to transform
+ * @returns The transformed attribute name
+ */
+export declare function transformAttributeName(attributeSlug: string): string;
+/**
+ * Processes a filter value for API submission
+ * Handles any special value transformations needed
+ *
+ * @param value - The value to process
+ * @param condition - The filter condition being used
+ * @returns The processed value
+ */
+export declare function processFilterValue(value: any, condition: FilterConditionType): any;
+/**
+ * Transforms a simple filter to API format
+ *
+ * @param filter - The filter to transform
+ * @returns API-formatted filter object
+ */
+export declare function transformSingleFilterToApi(filter: ListEntryFilter): AttioApiFilter;
+/**
+ * Converts API filter format back to MCP filter format
+ * Useful for debugging and reverse transformation
+ *
+ * @param apiFilter - API format filter
+ * @returns MCP format filters
+ */
+export declare function transformApiFormatToFilters(apiFilter: AttioApiFilter): ListEntryFilters;
+//# sourceMappingURL=translators.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"translators.d.ts","sourceRoot":"","sources":["../../../src/utils/filters/translators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AASH,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,mBAAmB,EAEpB,MAAM,YAAY,CAAC;AAUpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,gBAAgB,GAAG,SAAS,EACrC,kBAAkB,GAAE,OAAc,GACjC;IAAE,MAAM,CAAC,EAAE,cAAc,CAAA;CAAE,CAmF7B;AA4MD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGnE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAOpE;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,GAAG,EACV,SAAS,EAAE,mBAAmB,GAC7B,GAAG,CAaL;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,eAAe,GACtB,cAAc,CAoBhB;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,cAAc,GACxB,gBAAgB,CA6ClB"}