@iflow-mcp/attio-mcp 1.3.6

package/dist/utils/filters/validators.js

@@ -0,0 +1,325 @@
+/**
+ * @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
+ */
+// External dependencies
+import { DateRangePreset, isValidFilterCondition } from '../../types/attio.js';
+import { FilterValidationError } from '../../errors/api-errors.js';
+import { isValidISODateString } from '../date-utils.js';
+// Internal module dependencies
+import { InteractionType, FilterConditionType, } 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 function validateFilterStructure(filter) {
+    if (!filter) {
+        return false;
+    }
+    if (!filter.attribute || !filter.attribute.slug) {
+        return false;
+    }
+    if (!filter.condition) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Validates a date range object
+ *
+ * @param dateRange - The date range to validate
+ * @returns Validated and normalized date range
+ * @throws FilterValidationError if validation fails
+ */
+export function validateDateRange(dateRange) {
+    if (!dateRange) {
+        throw new FilterValidationError('Date range is required');
+    }
+    // Normalize dateRange if it's a string
+    let parsedDateRange;
+    if (typeof dateRange === 'string') {
+        try {
+            parsedDateRange = JSON.parse(dateRange);
+        }
+        catch (error) {
+            throw new FilterValidationError(`Invalid date range format: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    else {
+        parsedDateRange = dateRange;
+    }
+    // Check if it's a proper object
+    if (typeof parsedDateRange !== 'object' ||
+        Array.isArray(parsedDateRange) ||
+        parsedDateRange === null) {
+        throw new FilterValidationError('Date range must be an object with start, end, or preset properties');
+    }
+    // Must have at least one of preset, start, or end
+    if (!parsedDateRange.preset &&
+        !parsedDateRange.start &&
+        !parsedDateRange.end) {
+        throw new FilterValidationError('Date range must specify at least one of: preset, start, or end');
+    }
+    // Validate preset if provided
+    if (parsedDateRange.preset) {
+        const normalizedPreset = typeof parsedDateRange.preset === 'string'
+            ? parsedDateRange.preset.toLowerCase().trim()
+            : String(parsedDateRange.preset);
+        const validPresets = Object.values(DateRangePreset);
+        if (!validPresets.includes(normalizedPreset)) {
+            throw new FilterValidationError(`Invalid date preset: "${parsedDateRange.preset}". ` +
+                `Valid presets are: ${validPresets.join(', ')}`);
+        }
+        // Normalize the preset to ensure proper casing
+        parsedDateRange.preset = normalizedPreset;
+    }
+    // Validate start date if provided
+    if (parsedDateRange.start) {
+        if (typeof parsedDateRange.start === 'string') {
+            // Validate ISO string format
+            if (!isValidISODateString(parsedDateRange.start)) {
+                throw new FilterValidationError(`Invalid ISO date string format for start date: ${parsedDateRange.start}`);
+            }
+        }
+        else if (typeof parsedDateRange.start === 'object' &&
+            !Array.isArray(parsedDateRange.start)) {
+            // It's a relative date object, validate basic structure
+            const startObj = parsedDateRange.start;
+            if (!startObj.unit || !startObj.value || !startObj.direction) {
+                throw new FilterValidationError('Relative start date must have unit, value, and direction properties');
+            }
+            // Validate value is a number
+            if (typeof startObj.value !== 'number' || isNaN(startObj.value)) {
+                throw new FilterValidationError('Relative date value must be a number');
+            }
+            // Validate direction
+            if (startObj.direction !== 'past' && startObj.direction !== 'future') {
+                throw new FilterValidationError('Relative date direction must be either "past" or "future"');
+            }
+        }
+        else {
+            throw new FilterValidationError('Start date must be either an ISO date string or a relative date object');
+        }
+    }
+    // Validate end date if provided
+    if (parsedDateRange.end) {
+        if (typeof parsedDateRange.end === 'string') {
+            // Validate ISO string format
+            if (!isValidISODateString(parsedDateRange.end)) {
+                throw new FilterValidationError(`Invalid ISO date string format for end date: ${parsedDateRange.end}`);
+            }
+        }
+        else if (typeof parsedDateRange.end === 'object' &&
+            !Array.isArray(parsedDateRange.end)) {
+            // It's a relative date object, validate basic structure
+            const endObj = parsedDateRange.end;
+            if (!endObj.unit || !endObj.value || !endObj.direction) {
+                throw new FilterValidationError('Relative end date must have unit, value, and direction properties');
+            }
+            // Validate value is a number
+            if (typeof endObj.value !== 'number' || isNaN(endObj.value)) {
+                throw new FilterValidationError('Relative date value must be a number');
+            }
+            // Validate direction
+            if (endObj.direction !== 'past' && endObj.direction !== 'future') {
+                throw new FilterValidationError('Relative date direction must be either "past" or "future"');
+            }
+        }
+        else {
+            throw new FilterValidationError('End date must be either an ISO date string or a relative date object');
+        }
+    }
+    return parsedDateRange;
+}
+/**
+ * Validates an activity filter object
+ *
+ * @param activityFilter - The activity filter to validate
+ * @returns Validated and normalized activity filter
+ * @throws FilterValidationError if validation fails
+ */
+export function validateActivityFilter(activityFilter) {
+    if (!activityFilter) {
+        throw new FilterValidationError('Activity filter is required');
+    }
+    // Normalize if it's a string
+    let parsedActivityFilter;
+    if (typeof activityFilter === 'string') {
+        try {
+            parsedActivityFilter = JSON.parse(activityFilter);
+        }
+        catch (error) {
+            throw new FilterValidationError(`Invalid activity filter format: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    else {
+        parsedActivityFilter = activityFilter;
+    }
+    // Check if it's a proper object
+    if (typeof parsedActivityFilter !== 'object' ||
+        Array.isArray(parsedActivityFilter) ||
+        parsedActivityFilter === null) {
+        throw new FilterValidationError('Activity filter must be an object with dateRange and optional interactionType');
+    }
+    // Validate required dateRange property
+    if (!parsedActivityFilter.dateRange) {
+        throw new FilterValidationError('Activity filter must include a dateRange property');
+    }
+    // Validate dateRange
+    try {
+        parsedActivityFilter.dateRange = validateDateRange(parsedActivityFilter.dateRange);
+    }
+    catch (error) {
+        throw new FilterValidationError(`Invalid dateRange in activity filter: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    // Validate interactionType if provided
+    if (parsedActivityFilter.interactionType !== undefined) {
+        const validTypes = Object.values(InteractionType);
+        if (typeof parsedActivityFilter.interactionType !== 'string' ||
+            !validTypes.includes(parsedActivityFilter.interactionType)) {
+            throw new FilterValidationError(`Invalid interaction type: "${parsedActivityFilter.interactionType}". ` +
+                `Valid types are: ${validTypes.join(', ')}`);
+        }
+    }
+    return parsedActivityFilter;
+}
+/**
+ * Validates a numeric range object
+ *
+ * @param range - The numeric range to validate
+ * @returns Validated and normalized numeric range
+ * @throws FilterValidationError if validation fails
+ */
+export function validateNumericRange(range) {
+    if (!range) {
+        throw new FilterValidationError('Numeric range is required');
+    }
+    // Normalize if it's a string
+    let parsedRange;
+    if (typeof range === 'string') {
+        try {
+            parsedRange = JSON.parse(range);
+        }
+        catch (error) {
+            throw new FilterValidationError(`Invalid numeric range format: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    else {
+        parsedRange = range;
+    }
+    // Check if it's a proper object
+    if (typeof parsedRange !== 'object' ||
+        Array.isArray(parsedRange) ||
+        parsedRange === null) {
+        throw new FilterValidationError('Numeric range must be an object with min, max, or equals properties');
+    }
+    // Must have at least one of min, max, or equals
+    if (parsedRange.min === undefined &&
+        parsedRange.max === undefined &&
+        parsedRange.equals === undefined) {
+        throw new FilterValidationError('Numeric range must specify at least one of: min, max, or equals');
+    }
+    // If equals is specified, min and max should not be
+    if (parsedRange.equals !== undefined &&
+        (parsedRange.min !== undefined || parsedRange.max !== undefined)) {
+        throw new FilterValidationError('Cannot specify both equals and min/max in a numeric range');
+    }
+    // Check types and convert to number if needed
+    if (parsedRange.min !== undefined) {
+        parsedRange.min = Number(parsedRange.min);
+        if (isNaN(parsedRange.min)) {
+            throw new FilterValidationError('Min value must be a valid number');
+        }
+    }
+    if (parsedRange.max !== undefined) {
+        parsedRange.max = Number(parsedRange.max);
+        if (isNaN(parsedRange.max)) {
+            throw new FilterValidationError('Max value must be a valid number');
+        }
+    }
+    if (parsedRange.equals !== undefined) {
+        parsedRange.equals = Number(parsedRange.equals);
+        if (isNaN(parsedRange.equals)) {
+            throw new FilterValidationError('Equals value must be a valid number');
+        }
+    }
+    // Check that min <= max if both are specified
+    if (parsedRange.min !== undefined &&
+        parsedRange.max !== undefined &&
+        parsedRange.min > parsedRange.max) {
+        throw new FilterValidationError(`Invalid numeric range: min (${parsedRange.min}) cannot be greater than max (${parsedRange.max})`);
+    }
+    return parsedRange;
+}
+/**
+ * Validates a filter condition string
+ *
+ * @param condition - The condition to validate
+ * @returns The validated condition
+ * @throws FilterValidationError if validation fails
+ */
+export function validateFilterCondition(condition) {
+    if (!condition) {
+        throw new FilterValidationError('Filter condition is required');
+    }
+    // Use the isValidFilterCondition from types/attio.js
+    if (!isValidFilterCondition(condition)) {
+        const validConditions = Object.values(FilterConditionType);
+        throw new FilterValidationError(`Invalid filter condition: "${condition}". ` +
+            `Valid conditions are: ${validConditions.join(', ')}`);
+    }
+    return condition;
+}
+/**
+ * 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 function validateNumericParam(value, paramName, defaultValue) {
+    if (value === undefined || value === null) {
+        if (defaultValue !== undefined) {
+            return defaultValue;
+        }
+        throw new FilterValidationError(`${paramName} is required`);
+    }
+    const num = Number(value);
+    if (isNaN(num)) {
+        throw new FilterValidationError(`${paramName} must be a valid number`);
+    }
+    return num;
+}
+/**
+ * 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 function validateFilterWithConditions(filter, validateConditions = true) {
+    if (!validateFilterStructure(filter)) {
+        const slugInfo = filter?.attribute?.slug ? ` ${filter.attribute.slug}` : '';
+        throw new FilterValidationError(`Invalid filter: Incomplete filter structure for${slugInfo}`);
+    }
+    const { slug } = filter.attribute;
+    if (validateConditions && !isValidFilterCondition(filter.condition)) {
+        throw new FilterValidationError(`Invalid filter condition '${filter.condition}' for attribute '${slug}'. ` +
+            `Valid conditions are: ${Object.values(FilterConditionType).join(', ')}`);
+    }
+}
+//# sourceMappingURL=validators.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../../../src/utils/filters/validators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,wBAAwB;AACxB,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,+BAA+B;AAC/B,OAAO,EAGL,eAAe,EAEf,mBAAmB,GAEpB,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAuB;IAC7D,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,SAA8D;IAE9D,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,qBAAqB,CAAC,wBAAwB,CAAC,CAAC;IAC5D,CAAC;IAED,uCAAuC;IACvC,IAAI,eAAwC,CAAC;IAC7C,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAA4B,CAAC;QACrE,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,IAAI,qBAAqB,CAC7B,8BACE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACvD,EAAE,CACH,CAAC;QACJ,CAAC;IACH,CAAC;SAAM,CAAC;QACN,eAAe,GAAG,SAAS,CAAC;IAC9B,CAAC;IAED,gCAAgC;IAChC,IACE,OAAO,eAAe,KAAK,QAAQ;QACnC,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC;QAC9B,eAAe,KAAK,IAAI,EACxB,CAAC;QACD,MAAM,IAAI,qBAAqB,CAC7B,oEAAoE,CACrE,CAAC;IACJ,CAAC;IAED,kDAAkD;IAClD,IACE,CAAC,eAAe,CAAC,MAAM;QACvB,CAAC,eAAe,CAAC,KAAK;QACtB,CAAC,eAAe,CAAC,GAAG,EACpB,CAAC;QACD,MAAM,IAAI,qBAAqB,CAC7B,gEAAgE,CACjE,CAAC;IACJ,CAAC;IAED,8BAA8B;IAC9B,IAAI,eAAe,CAAC,MAAM,EAAE,CAAC;QAC3B,MAAM,gBAAgB,GACpB,OAAO,eAAe,CAAC,MAAM,KAAK,QAAQ;YACxC,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE;YAC7C,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAErC,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QACpD,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,gBAAmC,CAAC,EAAE,CAAC;YAChE,MAAM,IAAI,qBAAqB,CAC7B,yBAAyB,eAAe,CAAC,MAAM,KAAK;gBAClD,sBAAsB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAClD,CAAC;QACJ,CAAC;QAED,+CAA+C;QAC/C,eAAe,CAAC,MAAM,GAAG,gBAAgB,CAAC;IAC5C,CAAC;IAED,kCAAkC;IAClC,IAAI,eAAe,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAI,OAAO,eAAe,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9C,6BAA6B;YAC7B,IAAI,CAAC,oBAAoB,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjD,MAAM,IAAI,qBAAqB,CAC7B,kDAAkD,eAAe,CAAC,KAAK,EAAE,CAC1E,CAAC;YACJ,CAAC;QACH,CAAC;aAAM,IACL,OAAO,eAAe,CAAC,KAAK,KAAK,QAAQ;YACzC,CAAC,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,EACrC,CAAC;YACD,wDAAwD;YACxD,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAgC,CAAC;YAClE,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;gBAC7D,MAAM,IAAI,qBAAqB,CAC7B,qEAAqE,CACtE,CAAC;YACJ,CAAC;YAED,6BAA6B;YAC7B,IAAI,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAChE,MAAM,IAAI,qBAAqB,CAAC,sCAAsC,CAAC,CAAC;YAC1E,CAAC;YAED,qBAAqB;YACrB,IAAI,QAAQ,CAAC,SAAS,KAAK,MAAM,IAAI,QAAQ,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;gBACrE,MAAM,IAAI,qBAAqB,CAC7B,2DAA2D,CAC5D,CAAC;YACJ,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,qBAAqB,CAC7B,wEAAwE,CACzE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,gCAAgC;IAChC,IAAI,eAAe,CAAC,GAAG,EAAE,CAAC;QACxB,IAAI,OAAO,eAAe,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5C,6BAA6B;YAC7B,IAAI,CAAC,oBAAoB,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC/C,MAAM,IAAI,qBAAqB,CAC7B,gDAAgD,eAAe,CAAC,GAAG,EAAE,CACtE,CAAC;YACJ,CAAC;QACH,CAAC;aAAM,IACL,OAAO,eAAe,CAAC,GAAG,KAAK,QAAQ;YACvC,CAAC,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,EACnC,CAAC;YACD,wDAAwD;YACxD,MAAM,MAAM,GAAG,eAAe,CAAC,GAA8B,CAAC;YAC9D,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;gBACvD,MAAM,IAAI,qBAAqB,CAC7B,mEAAmE,CACpE,CAAC;YACJ,CAAC;YAED,6BAA6B;YAC7B,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5D,MAAM,IAAI,qBAAqB,CAAC,sCAAsC,CAAC,CAAC;YAC1E,CAAC;YAED,qBAAqB;YACrB,IAAI,MAAM,CAAC,SAAS,KAAK,MAAM,IAAI,MAAM,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;gBACjE,MAAM,IAAI,qBAAqB,CAC7B,2DAA2D,CAC5D,CAAC;YACJ,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,qBAAqB,CAC7B,sEAAsE,CACvE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,eAA4B,CAAC;AACtC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CACpC,cAAmE;IAEnE,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,qBAAqB,CAAC,6BAA6B,CAAC,CAAC;IACjE,CAAC;IAED,6BAA6B;IAC7B,IAAI,oBAA6C,CAAC;IAClD,IAAI,OAAO,cAAc,KAAK,QAAQ,EAAE,CAAC;QACvC,IAAI,CAAC;YACH,oBAAoB,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAG/C,CAAC;QACJ,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,IAAI,qBAAqB,CAC7B,mCACE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACvD,EAAE,CACH,CAAC;QACJ,CAAC;IACH,CAAC;SAAM,CAAC;QACN,oBAAoB,GAAG,cAAc,CAAC;IACxC,CAAC;IAED,gCAAgC;IAChC,IACE,OAAO,oBAAoB,KAAK,QAAQ;QACxC,KAAK,CAAC,OAAO,CAAC,oBAAoB,CAAC;QACnC,oBAAoB,KAAK,IAAI,EAC7B,CAAC;QACD,MAAM,IAAI,qBAAqB,CAC7B,+EAA+E,CAChF,CAAC;IACJ,CAAC;IAED,uCAAuC;IACvC,IAAI,CAAC,oBAAoB,CAAC,SAAS,EAAE,CAAC;QACpC,MAAM,IAAI,qBAAqB,CAC7B,mDAAmD,CACpD,CAAC;IACJ,CAAC;IAED,qBAAqB;IACrB,IAAI,CAAC;QACH,oBAAoB,CAAC,SAAS,GAAG,iBAAiB,CAChD,oBAAoB,CAAC,SAIR,CACd,CAAC;IACJ,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,IAAI,qBAAqB,CAC7B,yCACE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACvD,EAAE,CACH,CAAC;IACJ,CAAC;IAED,uCAAuC;IACvC,IAAI,oBAAoB,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QACvD,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QAElD,IACE,OAAO,oBAAoB,CAAC,eAAe,KAAK,QAAQ;YACxD,CAAC,UAAU,CAAC,QAAQ,CAClB,oBAAoB,CAAC,eAAkC,CACxD,EACD,CAAC;YACD,MAAM,IAAI,qBAAqB,CAC7B,8BAA8B,oBAAoB,CAAC,eAAe,KAAK;gBACrE,oBAAoB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC9C,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,oBAAsC,CAAC;AAChD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAA0D;IAE1D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,qBAAqB,CAAC,2BAA2B,CAAC,CAAC;IAC/D,CAAC;IAED,6BAA6B;IAC7B,IAAI,WAAoC,CAAC;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAA4B,CAAC;QAC7D,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,IAAI,qBAAqB,CAC7B,iCACE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACvD,EAAE,CACH,CAAC;QACJ,CAAC;IACH,CAAC;SAAM,CAAC;QACN,WAAW,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,gCAAgC;IAChC,IACE,OAAO,WAAW,KAAK,QAAQ;QAC/B,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;QAC1B,WAAW,KAAK,IAAI,EACpB,CAAC;QACD,MAAM,IAAI,qBAAqB,CAC7B,qEAAqE,CACtE,CAAC;IACJ,CAAC;IAED,gDAAgD;IAChD,IACE,WAAW,CAAC,GAAG,KAAK,SAAS;QAC7B,WAAW,CAAC,GAAG,KAAK,SAAS;QAC7B,WAAW,CAAC,MAAM,KAAK,SAAS,EAChC,CAAC;QACD,MAAM,IAAI,qBAAqB,CAC7B,iEAAiE,CAClE,CAAC;IACJ,CAAC;IAED,oDAAoD;IACpD,IACE,WAAW,CAAC,MAAM,KAAK,SAAS;QAChC,CAAC,WAAW,CAAC,GAAG,KAAK,SAAS,IAAI,WAAW,CAAC,GAAG,KAAK,SAAS,CAAC,EAChE,CAAC;QACD,MAAM,IAAI,qBAAqB,CAC7B,2DAA2D,CAC5D,CAAC;IACJ,CAAC;IAED,8CAA8C;IAC9C,IAAI,WAAW,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAClC,WAAW,CAAC,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,KAAK,CAAC,WAAW,CAAC,GAAa,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,qBAAqB,CAAC,kCAAkC,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAED,IAAI,WAAW,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAClC,WAAW,CAAC,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,KAAK,CAAC,WAAW,CAAC,GAAa,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,qBAAqB,CAAC,kCAAkC,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAED,IAAI,WAAW,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACrC,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,KAAK,CAAC,WAAW,CAAC,MAAgB,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,qBAAqB,CAAC,qCAAqC,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAED,8CAA8C;IAC9C,IACE,WAAW,CAAC,GAAG,KAAK,SAAS;QAC7B,WAAW,CAAC,GAAG,KAAK,SAAS;QAC5B,WAAW,CAAC,GAAc,GAAI,WAAW,CAAC,GAAc,EACzD,CAAC;QACD,MAAM,IAAI,qBAAqB,CAC7B,+BAA+B,WAAW,CAAC,GAAG,iCAAiC,WAAW,CAAC,GAAG,GAAG,CAClG,CAAC;IACJ,CAAC;IAED,OAAO,WAA2B,CAAC;AACrC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CACrC,SAAiB;IAEjB,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,qBAAqB,CAAC,8BAA8B,CAAC,CAAC;IAClE,CAAC;IAED,qDAAqD;IACrD,IAAI,CAAC,sBAAsB,CAAC,SAAS,CAAC,EAAE,CAAC;QACvC,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;QAC3D,MAAM,IAAI,qBAAqB,CAC7B,8BAA8B,SAAS,KAAK;YAC1C,yBAAyB,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACxD,CAAC;IACJ,CAAC;IAED,OAAO,SAAgC,CAAC;AAC1C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAc,EACd,SAAiB,EACjB,YAAqB;IAErB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC1C,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,YAAY,CAAC;QACtB,CAAC;QACD,MAAM,IAAI,qBAAqB,CAAC,GAAG,SAAS,cAAc,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1B,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACf,MAAM,IAAI,qBAAqB,CAAC,GAAG,SAAS,yBAAyB,CAAC,CAAC;IACzE,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,4BAA4B,CAC1C,MAAuB,EACvB,qBAA8B,IAAI;IAElC,IAAI,CAAC,uBAAuB,CAAC,MAAM,CAAC,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,MAAM,IAAI,qBAAqB,CAC7B,kDAAkD,QAAQ,EAAE,CAC7D,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC;IAElC,IAAI,kBAAkB,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,qBAAqB,CAC7B,6BAA6B,MAAM,CAAC,SAAS,oBAAoB,IAAI,KAAK;YACxE,yBAAyB,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC3E,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,37 @@
+/**
+ * Value validation utilities for filter transformation
+ * Validates select/status field values against allowed options
+ */
+/**
+ * Select/status option interface
+ */
+interface SelectOption {
+    id: string;
+    title: string;
+    value?: string;
+    is_archived?: boolean;
+}
+/**
+ * Per-call cache for options to avoid repeated lookups
+ * Key format: `${resourceType}:${attributeSlug}`
+ */
+type OptionsCache = Map<string, SelectOption[]>;
+/**
+ * Validates select or status field values against allowed options
+ *
+ * Strategy:
+ * 1. Try metadata options first (cached, no network call)
+ * 2. Fall back to API call (getStatusOptions/getSelectOptions) if metadata lacks options
+ * 3. Check if value matches any active option (by title or id, case-insensitive)
+ * 4. Throw clear error with valid options if invalid
+ *
+ * @param resourceType - Object type (e.g., 'deals', 'companies')
+ * @param attributeSlug - Attribute slug (e.g., 'stage', 'category')
+ * @param value - Value to validate
+ * @param condition - Filter condition ('equals', 'in', etc.)
+ * @param optionsCache - Per-call cache to avoid repeated lookups
+ * @throws FilterValidationError if value is invalid
+ */
+export declare function validateSelectOrStatusValue(resourceType: string, attributeSlug: string, value: unknown, condition: string, optionsCache: OptionsCache): Promise<void>;
+export {};
+//# sourceMappingURL=value-validators.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"value-validators.d.ts","sourceRoot":"","sources":["../../../src/utils/filters/value-validators.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH;;GAEG;AACH,UAAU,YAAY;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;GAGG;AACH,KAAK,YAAY,GAAG,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;AAEhD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,2BAA2B,CAC/C,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,YAAY,GACzB,OAAO,CAAC,IAAI,CAAC,CAwEf"}

package/dist/utils/filters/value-validators.js

@@ -0,0 +1,107 @@
+/**
+ * Value validation utilities for filter transformation
+ * Validates select/status field values against allowed options
+ */
+import { FilterValidationError, FilterErrorCategory, } from '../../errors/api-errors.js';
+import { getAttributeTypeInfo } from '../../api/attribute-types.js';
+import { getStatusOptions, getSelectOptions } from '../../api/attio-client.js';
+/**
+ * Validates select or status field values against allowed options
+ *
+ * Strategy:
+ * 1. Try metadata options first (cached, no network call)
+ * 2. Fall back to API call (getStatusOptions/getSelectOptions) if metadata lacks options
+ * 3. Check if value matches any active option (by title or id, case-insensitive)
+ * 4. Throw clear error with valid options if invalid
+ *
+ * @param resourceType - Object type (e.g., 'deals', 'companies')
+ * @param attributeSlug - Attribute slug (e.g., 'stage', 'category')
+ * @param value - Value to validate
+ * @param condition - Filter condition ('equals', 'in', etc.)
+ * @param optionsCache - Per-call cache to avoid repeated lookups
+ * @throws FilterValidationError if value is invalid
+ */
+export async function validateSelectOrStatusValue(resourceType, attributeSlug, value, condition, optionsCache) {
+    // Only validate equals and in operators (skip contains/starts_with/etc.)
+    if (condition !== 'equals' && condition !== 'in') {
+        return; // Skip validation for other operators
+    }
+    // Check cache first
+    const cacheKey = `${resourceType}:${attributeSlug}`;
+    let options = optionsCache.get(cacheKey);
+    if (!options) {
+        // Not in cache, fetch options
+        options = await fetchSelectOrStatusOptions(resourceType, attributeSlug);
+        optionsCache.set(cacheKey, options);
+    }
+    // Filter active options only
+    const activeOptions = options.filter((opt) => !opt.is_archived);
+    // Handle array values for 'in' operator
+    const valuesToCheck = Array.isArray(value) ? value : [value];
+    // Check each value
+    const invalidValues = [];
+    for (const val of valuesToCheck) {
+        const valueStr = String(val);
+        const isValid = activeOptions.some((opt) => opt.title.toLowerCase() === valueStr.toLowerCase() ||
+            opt.id === valueStr ||
+            opt.value === valueStr);
+        if (!isValid) {
+            invalidValues.push(val);
+        }
+    }
+    // Throw error if any invalid values found
+    if (invalidValues.length > 0) {
+        const validTitles = activeOptions.map((opt) => opt.title);
+        // Cap suggestion list at 15 options
+        const maxSuggestions = 15;
+        const suggestionList = validTitles.length > maxSuggestions
+            ? `${validTitles.slice(0, maxSuggestions).join(', ')}... and ${validTitles.length - maxSuggestions} more`
+            : validTitles.join(', ');
+        const invalidValuesStr = invalidValues.length === 1
+            ? `"${invalidValues[0]}"`
+            : `[${invalidValues.map((v) => `"${v}"`).join(', ')}]`;
+        throw new FilterValidationError(`Invalid value ${invalidValuesStr} for field "${attributeSlug}". ` +
+            `Valid options are: [${suggestionList}]`, FilterErrorCategory.VALUE);
+    }
+    // Log validation success in development
+    if (process.env.NODE_ENV === 'development') {
+        const validatedStr = valuesToCheck.length === 1
+            ? `"${valuesToCheck[0]}"`
+            : `[${valuesToCheck.map((v) => `"${v}"`).join(', ')}]`;
+        // eslint-disable-next-line no-console
+        console.debug(`[value-validators] Validated ${attributeSlug}: ${validatedStr} (${activeOptions.length} options available)`);
+    }
+}
+/**
+ * Fetches select/status options for an attribute
+ * Prefers metadata options (cached), falls back to API call
+ */
+async function fetchSelectOrStatusOptions(resourceType, attributeSlug) {
+    // Try metadata first (cached, no network call)
+    const typeInfo = await getAttributeTypeInfo(resourceType, attributeSlug);
+    // Check if metadata has options
+    const metadataOptions = typeInfo.metadata?.config?.select?.options;
+    if (metadataOptions &&
+        Array.isArray(metadataOptions) &&
+        metadataOptions.length > 0) {
+        // Use metadata options (already cached)
+        if (process.env.NODE_ENV === 'development') {
+            // eslint-disable-next-line no-console
+            console.debug(`[value-validators] Using metadata options for ${resourceType}.${attributeSlug} (${metadataOptions.length} options)`);
+        }
+        return metadataOptions;
+    }
+    // Metadata lacks options, fall back to API call
+    if (process.env.NODE_ENV === 'development') {
+        // eslint-disable-next-line no-console
+        console.debug(`[value-validators] Fetching options via API for ${resourceType}.${attributeSlug}`);
+    }
+    if (typeInfo.attioType === 'status') {
+        return (await getStatusOptions(resourceType, attributeSlug));
+    }
+    else {
+        // Assume select
+        return (await getSelectOptions(resourceType, attributeSlug));
+    }
+}
+//# sourceMappingURL=value-validators.js.map

package/dist/utils/filters/value-validators.js.map

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

package/dist/utils/json-serializer.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Interface for serialization options
+ */
+export interface SerializationOptions {
+    /** Maximum depth for nested objects (only used in the legacy implementation) */
+    maxDepth?: number;
+    /** Maximum string length before truncation */
+    maxStringLength?: number;
+    /** Whether to include stack traces in error objects */
+    includeStackTraces?: boolean;
+    /** Custom replacer function */
+    replacer?: (key: string, value: unknown) => unknown;
+    /** Indent spaces for pretty printing (default: 2) */
+    indent?: number;
+}
+/**
+ * Safe JSON stringify that handles circular references and non-serializable values
+ *
+ * Uses fast-safe-stringify for high performance and reliability
+ *
+ * @param obj - The object to stringify
+ * @param options - Serialization options
+ * @returns Safe JSON string
+ */
+export declare function safeJsonStringify(obj: unknown, options?: SerializationOptions): string;
+/**
+ * Validates that a JSON string is properly formed and can be parsed
+ *
+ * @param jsonString - The JSON string to validate
+ * @returns Object with validation result and parsed data if successful
+ */
+export declare function validateJsonString(jsonString: string): {
+    isValid: boolean;
+    data?: unknown;
+    error?: string;
+    size: number;
+};
+/**
+ * Detects potential circular references in an object before serialization
+ *
+ * NOTE: This is less critical now with fast-safe-stringify, but kept for
+ * compatibility with existing code that uses it.
+ *
+ * @param obj - The object to check
+ * @param maxDepth - Maximum depth to check
+ * @returns True if circular references are detected
+ */
+export declare function hasCircularReferences(obj: unknown, maxDepth?: number): boolean;
+/**
+ * Creates a safe copy of an object that can be JSON serialized
+ *
+ * Uses fast-safe-stringify for improved performance and reliability
+ *
+ * @param obj - The object to copy
+ * @param options - Serialization options
+ * @returns Safe copy of the object
+ */
+export declare function createSafeCopy(obj: unknown, options?: SerializationOptions): unknown;
+/**
+ * Sanitizes MCP response objects to prevent JSON parsing errors
+ *
+ * Uses fast-safe-stringify to ensure all responses are safely serializable
+ *
+ * @param response - The MCP response object to sanitize
+ * @returns Sanitized response object
+ */
+export declare function sanitizeMcpResponse(response: unknown): unknown;
+//# sourceMappingURL=json-serializer.d.ts.map

package/dist/utils/json-serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-serializer.d.ts","sourceRoot":"","sources":["../../src/utils/json-serializer.ts"],"names":[],"mappings":"AAiFA;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IACpD,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAaD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,oBAAyB,GACjC,MAAM,CA2GR;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG;IACtD,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAiBA;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,OAAO,EACZ,QAAQ,GAAE,MAAW,GACpB,OAAO,CAuBT;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,oBAAyB,GACjC,OAAO,CA0BT;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CA4C9D"}