@iflow-mcp/attio-mcp 1.3.6

package/dist/utils/filters/validation-utils.js

@@ -0,0 +1,303 @@
+/**
+ * @module validation-utils
+ *
+ * Centralized validation utilities for filter structures
+ * Provides consistent error message formatting and reusable validation functions
+ */
+import { FilterValidationError, FilterErrorCategory, } from '../../errors/api-errors.js';
+import { isValidFilterCondition } from '../../types/attio.js';
+/**
+ * Error message templates for consistent error formatting
+ */
+export const ERROR_MESSAGES = {
+    MISSING_FILTERS: 'Filter object is required but was undefined or null',
+    FILTERS_NOT_ARRAY: (type) => `Invalid filter structure: 'filters' property must be an array but got ${type}.
+
+Expected format:
+{
+  "filters": [
+    {"attribute": {"slug": "field_name"}, "condition": "contains", "value": "search_term"}
+  ]
+}`,
+    MISSING_FILTERS_PROPERTY: `Invalid filter format. Expected structure:
+{
+  "filters": [
+    {"attribute": {"slug": "field_name"}, "condition": "contains", "value": "search_term"}
+  ]
+}
+
+Common mistake: Using object format instead of array format. 
+Received an object without a "filters" array property.
+
+See documentation for more examples.`,
+    EMPTY_FILTERS_ARRAY: 'No filters provided in the filters array',
+    INVALID_FILTER_STRUCTURE: (index, reason) => `Invalid filter structure at index ${index}: ${reason}`,
+    MISSING_ATTRIBUTE: 'missing attribute object',
+    MISSING_ATTRIBUTE_SLUG: 'missing attribute.slug property',
+    MISSING_CONDITION: 'missing condition property',
+    INVALID_CONDITION: (condition, validConditions) => `Invalid filter condition '${condition}'. Valid conditions are: ${validConditions.join(', ')}`,
+    ALL_FILTERS_INVALID: 'All filters are invalid. Please provide at least one valid filter.',
+};
+/**
+ * Standard example format for filter structures to include in error messages
+ */
+export const FILTER_EXAMPLES = {
+    SIMPLE: `{ 
+  "filters": [
+    {
+      "attribute": { "slug": "name" },
+      "condition": "contains",
+      "value": "Company Inc"
+    }
+  ]
+}`,
+    OR_LOGIC: `{ 
+  "filters": [
+    {
+      "attribute": { "slug": "name" },
+      "condition": "contains",
+      "value": "Inc"
+    },
+    {
+      "attribute": { "slug": "description" },
+      "condition": "contains",
+      "value": "Technology"
+    }
+  ],
+  "matchAny": true
+}`,
+    MULTIPLE_CONDITIONS: `{ 
+  "filters": [
+    {
+      "attribute": { "slug": "name" },
+      "condition": "contains", 
+      "value": "Inc"
+    },
+    {
+      "attribute": { "slug": "domains" },
+      "condition": "contains",
+      "value": ".com"
+    }
+  ]
+}`,
+};
+/**
+ * Validates the basic filter structure ensuring filters object has required properties
+ *
+ * This function performs structural validation to ensure:
+ * - The filters parameter is not null/undefined
+ * - The filters object has a 'filters' property
+ * - The 'filters' property is an array
+ *
+ * @param filters - The filters object to validate (may be undefined/null from user input)
+ * @returns Validated filters object with guaranteed filters array
+ * @throws FilterValidationError with consistent error messages and appropriate categories
+ *
+ * @example
+ * ```typescript
+ * const validated = validateFiltersObject({
+ *   filters: [{ attribute: { slug: 'name' }, condition: 'equals', value: 'test' }]
+ * });
+ * // validated.filters is guaranteed to be an array
+ * ```
+ */
+export function validateFiltersObject(filters) {
+    // Check if filters is undefined or null
+    if (!filters) {
+        throw new FilterValidationError(ERROR_MESSAGES.MISSING_FILTERS, FilterErrorCategory.STRUCTURE);
+    }
+    // Check if filters has a filters property
+    if (!('filters' in filters)) {
+        throw new FilterValidationError(ERROR_MESSAGES.MISSING_FILTERS_PROPERTY, FilterErrorCategory.STRUCTURE);
+    }
+    // Check if filters.filters is an array
+    if (!Array.isArray(filters.filters)) {
+        throw new FilterValidationError(ERROR_MESSAGES.FILTERS_NOT_ARRAY(typeof filters.filters), FilterErrorCategory.STRUCTURE);
+    }
+    // Return the validated filters with the correct type
+    return filters;
+}
+/**
+ * Validates each individual filter in a filters array
+ * Returns list of invalid filters with reasons
+ *
+ * @param filters - Array of filter objects to validate
+ * @param validateConditions - Whether to validate condition values
+ * @returns Array of objects containing invalid filter index, reason and filter object
+ */
+export function collectInvalidFilters(filters, validateConditions = true) {
+    const invalidFilters = [];
+    // Check each filter in the array
+    filters.forEach((filter, index) => {
+        // Check if filter is a valid object
+        if (!filter || typeof filter !== 'object') {
+            invalidFilters.push({
+                index,
+                reason: `Filter at index ${index} is ${filter === null ? 'null' : typeof filter}`,
+                filter,
+            });
+            return;
+        }
+        // Check for required properties
+        if (!filter.attribute) {
+            invalidFilters.push({
+                index,
+                reason: ERROR_MESSAGES.MISSING_ATTRIBUTE,
+                filter,
+            });
+            return;
+        }
+        if (!filter.attribute.slug) {
+            invalidFilters.push({
+                index,
+                reason: ERROR_MESSAGES.MISSING_ATTRIBUTE_SLUG,
+                filter,
+            });
+            return;
+        }
+        if (!filter.condition) {
+            invalidFilters.push({
+                index,
+                reason: ERROR_MESSAGES.MISSING_CONDITION,
+                filter,
+            });
+            return;
+        }
+        // Validate condition if enabled
+        if (validateConditions && !isValidFilterCondition(filter.condition)) {
+            invalidFilters.push({
+                index,
+                reason: `Invalid condition '${filter.condition}'`,
+                filter,
+            });
+            return;
+        }
+    });
+    return invalidFilters;
+}
+/**
+ * Creates a consistently formatted error message for invalid filters
+ *
+ * @param invalidFilters - Array of invalid filter objects with reasons
+ * @returns Formatted error message with details
+ */
+export function formatInvalidFiltersError(invalidFilters) {
+    if (invalidFilters.length === 0) {
+        return '';
+    }
+    const errorDetails = invalidFilters
+        .map((f) => `Filter [${f.index}]: ${f.reason}`)
+        .join('; ');
+    return errorDetails;
+}
+/**
+ * Full validation of filters with detailed error messages and examples
+ *
+ * This is the primary entry point for filter validation. It performs:
+ * 1. Structural validation using validateFiltersObject()
+ * 2. Individual filter validation for each filter in the array
+ * 3. Condition validation if enabled
+ * 4. Comprehensive error reporting with examples
+ *
+ * @param filters - Filter object to validate (may have optional filters array)
+ * @param validateConditions - Whether to validate condition values against known operators
+ * @returns Validated filters with guaranteed filters array and valid structure
+ * @throws FilterValidationError with detailed messages, examples, and appropriate categories
+ *
+ * @example
+ * ```typescript
+ * // Valid usage
+ * const validated = validateFilters({
+ *   filters: [
+ *     { attribute: { slug: 'name' }, condition: 'equals', value: 'John' },
+ *     { attribute: { slug: 'age' }, condition: 'greater_than', value: 18 }
+ *   ],
+ *   matchAny: false
+ * }, true);
+ *
+ * // validated.filters is guaranteed to exist and be valid
+ * ```
+ *
+ * @see validateFiltersObject For structural validation
+ * @see collectInvalidFilters For individual filter validation logic
+ */
+export function validateFilters(filters, validateConditions = true) {
+    // First validate basic structure
+    const validatedFilters = validateFiltersObject(filters);
+    // Handle empty or undefined filters array (valid but returns no results)
+    if (!validatedFilters.filters || validatedFilters.filters.length === 0) {
+        return validatedFilters;
+    }
+    // Collect invalid filters
+    const invalidFilters = collectInvalidFilters(validatedFilters.filters, validateConditions);
+    // If all filters are invalid, throw error with examples
+    if (invalidFilters.length === validatedFilters.filters.length) {
+        const errorDetails = formatInvalidFiltersError(invalidFilters);
+        let errorMessage = `${ERROR_MESSAGES.ALL_FILTERS_INVALID} ${errorDetails}`;
+        // Add examples to help the user fix their filters - show relevant example based on context
+        const relevantExample = invalidFilters.length > 1
+            ? FILTER_EXAMPLES.MULTIPLE_CONDITIONS
+            : FILTER_EXAMPLES.SIMPLE;
+        errorMessage +=
+            '\n\nExample of valid filter structure: \n' + relevantExample;
+        // Determine most appropriate error category based on invalid filters
+        let category = FilterErrorCategory.STRUCTURE;
+        // If we have specific attribute issues
+        if (invalidFilters.some((f) => f.reason.includes('attribute'))) {
+            category = FilterErrorCategory.ATTRIBUTE;
+        }
+        // If we have specific condition issues
+        else if (invalidFilters.some((f) => f.reason.includes('condition'))) {
+            category = FilterErrorCategory.CONDITION;
+        }
+        // If we have specific value issues
+        else if (invalidFilters.some((f) => f.reason.includes('value'))) {
+            category = FilterErrorCategory.VALUE;
+        }
+        throw new FilterValidationError(errorMessage, category);
+    }
+    return validatedFilters;
+}
+/**
+ * Helper function to get a descriptive reason for an invalid filter
+ *
+ * @param filter - The filter to analyze
+ * @returns A string describing what's wrong with the filter
+ */
+export function getInvalidFilterReason(filter) {
+    if (!filter || typeof filter !== 'object') {
+        return `filter is ${filter === null ? 'null' : typeof filter}`;
+    }
+    const filterObj = filter;
+    if (!filterObj.attribute) {
+        return ERROR_MESSAGES.MISSING_ATTRIBUTE;
+    }
+    if (!filterObj.attribute.slug) {
+        return ERROR_MESSAGES.MISSING_ATTRIBUTE_SLUG;
+    }
+    if (!filterObj.condition) {
+        return ERROR_MESSAGES.MISSING_CONDITION;
+    }
+    if (!isValidFilterCondition(filterObj.condition)) {
+        return `invalid condition '${filterObj.condition}'`;
+    }
+    return 'unknown issue';
+}
+/**
+ * Generate examples for different filter scenarios
+ *
+ * @param filterType - The type of filter example to generate (simple, or, multiple)
+ * @returns A string with the example in JSON format
+ */
+export function getFilterExample(filterType = 'simple') {
+    switch (filterType) {
+        case 'or':
+            return FILTER_EXAMPLES.OR_LOGIC;
+        case 'multiple':
+            return FILTER_EXAMPLES.MULTIPLE_CONDITIONS;
+        case 'simple':
+        default:
+            return FILTER_EXAMPLES.SIMPLE;
+    }
+}
+//# sourceMappingURL=validation-utils.js.map

package/dist/utils/filters/validation-utils.js.map

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

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

@@ -0,0 +1,73 @@
+/**
+ * @module validators
+ *
+ * Consolidated filter validation utilities
+ * Provides functions to validate and normalize filter parameters
+ *
+ * This module provides:
+ * - Structure validation for filter objects
+ * - Date range validation and normalization
+ * - Numeric range validation
+ * - Activity filter validation
+ * - Filter condition validation
+ * - Parameter type validation and conversion
+ */
+import { DateRange, ActivityFilter, NumericRange, FilterConditionType, ListEntryFilter } from './types.js';
+/**
+ * Validates a filter structure for basic required properties
+ *
+ * @param filter - The filter to validate
+ * @returns True if filter is valid, false otherwise
+ */
+export declare function validateFilterStructure(filter: ListEntryFilter): boolean;
+/**
+ * Validates a date range object
+ *
+ * @param dateRange - The date range to validate
+ * @returns Validated and normalized date range
+ * @throws FilterValidationError if validation fails
+ */
+export declare function validateDateRange(dateRange: Record<string, unknown> | string | null | undefined): DateRange;
+/**
+ * Validates an activity filter object
+ *
+ * @param activityFilter - The activity filter to validate
+ * @returns Validated and normalized activity filter
+ * @throws FilterValidationError if validation fails
+ */
+export declare function validateActivityFilter(activityFilter: Record<string, unknown> | string | null | undefined): ActivityFilter;
+/**
+ * Validates a numeric range object
+ *
+ * @param range - The numeric range to validate
+ * @returns Validated and normalized numeric range
+ * @throws FilterValidationError if validation fails
+ */
+export declare function validateNumericRange(range: Record<string, unknown> | string | null | undefined): NumericRange;
+/**
+ * Validates a filter condition string
+ *
+ * @param condition - The condition to validate
+ * @returns The validated condition
+ * @throws FilterValidationError if validation fails
+ */
+export declare function validateFilterCondition(condition: string): FilterConditionType;
+/**
+ * Ensures a value is a number, converting if necessary
+ *
+ * @param value - The value to validate and convert
+ * @param paramName - Name of the parameter (for error messages)
+ * @param defaultValue - Optional default value if undefined
+ * @returns The validated number
+ * @throws FilterValidationError if validation fails
+ */
+export declare function validateNumericParam(value: unknown, paramName: string, defaultValue?: number): number;
+/**
+ * Validates filter structure and conditions
+ *
+ * @param filter - The filter to validate
+ * @param validateConditions - Whether to validate condition types (default: true)
+ * @throws FilterValidationError if validation fails
+ */
+export declare function validateFilterWithConditions(filter: ListEntryFilter, validateConditions?: boolean): void;
+//# sourceMappingURL=validators.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../../src/utils/filters/validators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAQH,OAAO,EACL,SAAS,EACT,cAAc,EAEd,YAAY,EACZ,mBAAmB,EACnB,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAcxE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAC7D,SAAS,CA6IX;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAClE,cAAc,CA6EhB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GACzD,YAAY,CAuFd;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,GAChB,mBAAmB,CAerB;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAcR;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,eAAe,EACvB,kBAAkB,GAAE,OAAc,GACjC,IAAI,CAgBN"}