@iflow-mcp/attio-mcp 1.3.6

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

@@ -0,0 +1,228 @@
+/**
+ * UUID Validation Utilities for Issue #416
+ *
+ * This module provides UUID format validation to properly distinguish between
+ * "Invalid format" and "Not found" errors, addressing the misleading error
+ * messages reported in Issue #416.
+ */
+import { EnhancedApiError, ErrorTemplates, } from '../../errors/enhanced-api-errors.js';
+/**
+ * UUID format validation regex
+ * Matches standard UUID v4 format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
+ */
+const UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/**
+ * Validate if a string is in proper UUID format
+ *
+ * @param uuid - String to validate
+ * @returns true if the string is a valid UUID format
+ */
+export function isValidUUID(uuid) {
+    return UUID_REGEX.test(uuid);
+}
+/**
+ * Validate record ID format and throw appropriate error if invalid
+ *
+ * This function addresses Issue #416 by ensuring that format validation
+ * errors are distinct from "not found" errors.
+ *
+ * @param recordId - Record ID to validate
+ * @param resourceType - Type of resource for context
+ * @throws EnhancedApiError with proper format error message
+ */
+export function validateRecordId(recordId, resourceType) {
+    if (!isValidUUID(recordId)) {
+        throw ErrorTemplates.INVALID_UUID_FORMAT(recordId, resourceType);
+    }
+}
+export function validateUUIDWithDetails(uuid, 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+_options) {
+    if (!uuid || typeof uuid !== 'string') {
+        return {
+            isValid: false,
+            error: 'Record ID is required and must be a string',
+            suggestion: 'Provide a valid UUID format (e.g., "a1b2c3d4-e5f6-7890-abcd-ef1234567890")',
+        };
+    }
+    if (uuid.length !== 36) {
+        return {
+            isValid: false,
+            error: `Invalid UUID length: ${uuid.length} characters (expected 36)`,
+            suggestion: 'UUIDs must be exactly 36 characters long with dashes at positions 8, 13, 18, 23',
+        };
+    }
+    if (!UUID_REGEX.test(uuid)) {
+        // Analyze what's wrong with the format
+        const issues = [];
+        if (uuid.charAt(8) !== '-' ||
+            uuid.charAt(13) !== '-' ||
+            uuid.charAt(18) !== '-' ||
+            uuid.charAt(23) !== '-') {
+            issues.push('incorrect dash positions (should be at 8, 13, 18, 23)');
+        }
+        const nonHexChars = uuid.replace(/-/g, '').match(/[^0-9a-fA-F]/g);
+        if (nonHexChars) {
+            issues.push(`invalid characters: ${Array.from(new Set(nonHexChars)).join(', ')}`);
+        }
+        return {
+            isValid: false,
+            error: `Invalid UUID format: ${issues.join('; ')}`,
+            suggestion: 'Use hexadecimal characters (0-9, a-f) with dashes at positions 8, 13, 18, 23',
+        };
+    }
+    return { isValid: true };
+}
+/**
+ * Create a properly formatted error for invalid UUIDs
+ *
+ * @param recordId - The invalid record ID
+ * @param resourceType - Resource type for context
+ * @param operation - Operation being performed
+ * @returns EnhancedApiError with detailed UUID format guidance
+ */
+export function createInvalidUUIDError(recordId, resourceType, operation = 'GET') {
+    const validation = validateUUIDWithDetails(recordId, {
+        resourceType,
+        operation,
+    });
+    return new EnhancedApiError(`Invalid record identifier format: '${recordId}'`, 400, `/objects/${resourceType}`, operation, {
+        field: 'record_id',
+        fieldType: 'uuid',
+        resourceType,
+        documentationHint: validation.suggestion ||
+            'Expected UUID format (e.g., "a1b2c3d4-e5f6-7890-abcd-ef1234567890")',
+    });
+}
+/**
+ * Create a properly formatted error for records not found
+ *
+ * @param recordId - The record ID that wasn't found
+ * @param resourceType - Resource type for context
+ * @returns EnhancedApiError with clear "not found" message
+ */
+export function createRecordNotFoundError(recordId, resourceType) {
+    return new EnhancedApiError(`Record not found`, 404, `/objects/${resourceType}/${recordId}`, 'GET', {
+        recordId,
+        resourceType,
+        httpStatus: 404,
+        documentationHint: `Use search-records to find valid ${resourceType} IDs.`,
+    });
+}
+/**
+ * Utility to distinguish between format errors and not found errors
+ *
+ * This function encapsulates the core logic for Issue #416 - it determines
+ * whether an error should be treated as a format issue or a not found issue.
+ *
+ * @param error - Original error from API
+ * @param recordId - Record ID that was requested
+ * @param resourceType - Resource type for context
+ * @returns Appropriate EnhancedApiError
+ */
+export function classifyRecordError(error, recordId, resourceType) {
+    const errorMessage = error.message.toLowerCase();
+    // If the UUID format is invalid, it's definitely a format error
+    if (!isValidUUID(recordId)) {
+        return createInvalidUUIDError(recordId, resourceType);
+    }
+    // If UUID format is valid but we got an error, check the error type
+    const statusLike = error;
+    if (errorMessage.includes('not found') ||
+        errorMessage.includes('does not exist') ||
+        statusLike.status === 404 ||
+        statusLike.statusCode === 404) {
+        return createRecordNotFoundError(recordId, resourceType);
+    }
+    // For other errors with valid UUIDs, preserve the original error but enhance it
+    const statusCode = statusLike.statusCode || statusLike.status || 500;
+    return new EnhancedApiError(error.message, statusCode, `/objects/${resourceType}/${recordId}`, 'GET', {
+        recordId,
+        resourceType,
+        originalError: error,
+    });
+}
+/**
+ * Generate example UUIDs for error messages and documentation
+ */
+export function generateExampleUUID() {
+    // Generate a valid UUID v4 for examples
+    const hex = '0123456789abcdef';
+    let uuid = '';
+    for (let i = 0; i < 36; i++) {
+        if (i === 8 || i === 13 || i === 18 || i === 23) {
+            uuid += '-';
+        }
+        else {
+            uuid += hex[Math.floor(Math.random() * 16)];
+        }
+    }
+    return uuid;
+}
+/**
+ * Extract UUID from various input formats including URIs
+ *
+ * Handles:
+ * - Raw UUIDs: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
+ * - URI paths: "https://app.attio.com/records/companies/a1b2c3d4-e5f6-7890-abcd-ef1234567890"
+ * - Custom schemes: "attio://companies/a1b2c3d4-e5f6-7890-abcd-ef1234567890"
+ *
+ * @param input - Input string that may contain a UUID
+ * @returns Extracted UUID string or null if no valid UUID found
+ */
+export function extractRecordId(input) {
+    if (!input || typeof input !== 'string') {
+        return null;
+    }
+    // First try direct UUID matching
+    const directMatch = input.match(UUID_REGEX);
+    if (directMatch) {
+        return directMatch[0];
+    }
+    // Try URL parsing for URI-style inputs
+    try {
+        const url = new URL(input);
+        const pathSegments = url.pathname.split('/').filter(Boolean);
+        // Check each path segment for a UUID
+        for (const segment of pathSegments) {
+            if (UUID_REGEX.test(segment)) {
+                return segment;
+            }
+        }
+    }
+    catch {
+        // Not a valid URL, continue with other strategies
+    }
+    // Try extracting UUID from anywhere in the string as fallback
+    const anyMatch = input.match(/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/i);
+    if (anyMatch) {
+        return anyMatch[0];
+    }
+    return null;
+}
+/**
+ * Common UUID validation patterns for testing
+ */
+export const UUIDTestPatterns = {
+    VALID: [
+        'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+        '123e4567-e89b-12d3-a456-426614174000',
+        '00000000-0000-0000-0000-000000000000',
+    ],
+    INVALID_FORMAT: [
+        'not-a-uuid',
+        'a1b2c3d4e5f6-7890-abcd-ef1234567890', // Missing dash
+        'a1b2c3d4-e5f6-7890-abcd-ef1234567890x', // Too long
+        'a1b2c3d4-e5f6-7890-abcd-ef123456789', // Too short
+        'g1b2c3d4-e5f6-7890-abcd-ef1234567890', // Invalid character
+        '12345678901234567890123456789012345678', // No dashes
+    ],
+    EDGE_CASES: [
+        '', // Empty string
+        null, // Null
+        undefined, // Undefined
+        123, // Number
+        {},
+    ],
+};
+//# sourceMappingURL=uuid-validation.js.map

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

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

package/dist/utils/validation-utils.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Enhanced validation utilities for improving error messages and user experience
+ *
+ * This module provides comprehensive validation for:
+ * - Select field options with helpful suggestions
+ * - Read-only field detection
+ * - Field name suggestions using similarity algorithms
+ * - Structured error responses
+ */
+export interface ValidationResult {
+    isValid: boolean;
+    error?: string;
+}
+export interface AttributeInfo {
+    api_slug: string;
+    type: string;
+    title?: string;
+    read_only?: boolean;
+    options?: Array<{
+        title?: string;
+        value: string;
+    }>;
+}
+/**
+ * Get resource attributes with caching
+ * Enhanced cache key includes workspace context to prevent collisions
+ */
+export declare function getResourceAttributes(resourceType: string): Promise<AttributeInfo[]>;
+/**
+ * Enhanced select field validation with dynamic option suggestions
+ */
+export declare function validateSelectField(resourceType: string, fieldName: string, value: string): Promise<ValidationResult>;
+/**
+ * Multi-select field validation
+ */
+export declare function validateMultiSelectField(resourceType: string, fieldName: string, values: string[]): Promise<ValidationResult>;
+/**
+ * Read-only field validation
+ */
+export declare function validateReadOnlyFields(resourceType: string, updateFields: Record<string, unknown>): Promise<ValidationResult>;
+/**
+ * Smart field name suggestions using similarity algorithms
+ */
+export declare function suggestFieldName(resourceType: string, invalidFieldName: string): Promise<string[]>;
+/**
+ * Field existence validation with suggestions
+ */
+export declare function validateFieldExistence(resourceType: string, fieldNames: string[]): Promise<ValidationResult>;
+/**
+ * Comprehensive field validation for record operations
+ */
+export declare function validateRecordFields(resourceType: string, fields: Record<string, unknown>, isUpdate?: boolean): Promise<ValidationResult>;
+/**
+ * Clear the attribute cache (useful for testing)
+ */
+export declare function clearAttributeCache(): void;
+//# sourceMappingURL=validation-utils.d.ts.map

package/dist/utils/validation-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-utils.d.ts","sourceRoot":"","sources":["../../src/utils/validation-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;CACJ;AA2BD;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,aAAa,EAAE,CAAC,CAqC1B;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,gBAAgB,CAAC,CA8B3B;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EAAE,GACf,OAAO,CAAC,gBAAgB,CAAC,CAkC3B;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,OAAO,CAAC,gBAAgB,CAAC,CAkC3B;AAyCD;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,MAAM,EACpB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,MAAM,EAAE,CAAC,CAiCnB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,gBAAgB,CAAC,CAmC3B;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,GAAE,OAAe,GACxB,OAAO,CAAC,gBAAgB,CAAC,CAkD3B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C"}

package/dist/utils/validation-utils.js

@@ -0,0 +1,275 @@
+/**
+ * Enhanced validation utilities for improving error messages and user experience
+ *
+ * This module provides comprehensive validation for:
+ * - Select field options with helpful suggestions
+ * - Read-only field detection
+ * - Field name suggestions using similarity algorithms
+ * - Structured error responses
+ */
+import { createScopedLogger, OperationType } from './logger.js';
+import { getValidatedAttioClient } from './client-resolver.js';
+/**
+ * Configuration from environment variables
+ */
+const CONFIG = {
+    CACHE_TTL: parseInt(process.env.ATTIO_CACHE_TTL || '300000', 10), // Default: 5 minutes
+    SIMILARITY_THRESHOLD: parseInt(process.env.ATTIO_SIMILARITY_THRESHOLD || '5', 10), // Default: 5 (more permissive to catch common typos)
+    MAX_SUGGESTIONS: parseInt(process.env.ATTIO_MAX_FIELD_SUGGESTIONS || '3', 10), // Default: 3
+};
+/**
+ * Cache for resource attributes to avoid repeated API calls
+ * Enhanced to include workspace/tenant context to prevent collisions
+ */
+const attributeCache = new Map();
+const cacheTimestamps = new Map();
+/**
+ * Get resource attributes with caching
+ * Enhanced cache key includes workspace context to prevent collisions
+ */
+export async function getResourceAttributes(resourceType) {
+    // Enhanced cache key to include workspace/tenant context
+    const workspaceId = process.env.ATTIO_WORKSPACE_ID || 'default';
+    const cacheKey = `${workspaceId}:${resourceType}`;
+    const now = Date.now();
+    // Check if we have cached data that's still valid
+    if (attributeCache.has(cacheKey) &&
+        cacheTimestamps.has(cacheKey) &&
+        now - cacheTimestamps.get(cacheKey) < CONFIG.CACHE_TTL) {
+        return attributeCache.get(cacheKey);
+    }
+    try {
+        // Use type-safe client resolver instead of dynamic any types
+        const client = getValidatedAttioClient();
+        const response = (await client.get(`/objects/${resourceType}/attributes`));
+        const attributes = response?.data?.data || [];
+        // Cache the results
+        attributeCache.set(cacheKey, attributes);
+        cacheTimestamps.set(cacheKey, now);
+        return attributes;
+    }
+    catch (error) {
+        createScopedLogger('utils/validation-utils', 'getResourceAttributes', OperationType.API_CALL).error(`Failed to fetch attributes for ${resourceType}`, error);
+        // Return empty array if fetch fails, don't break validation
+        return [];
+    }
+}
+/**
+ * Enhanced select field validation with dynamic option suggestions
+ */
+export async function validateSelectField(resourceType, fieldName, value) {
+    try {
+        const attributes = await getResourceAttributes(resourceType);
+        const field = attributes.find((attr) => attr.api_slug === fieldName);
+        if (field?.type === 'select' && field.options) {
+            // Check if the value matches any option's value (not title)
+            const validValues = field.options.map((opt) => opt.value);
+            const validTitles = field.options.map((opt) => opt.title || opt.value);
+            if (!validValues.includes(value)) {
+                return {
+                    isValid: false,
+                    error: `Invalid value '${value}' for field '${fieldName}'. Valid options are: [${validTitles
+                        .map((opt) => `'${opt}'`)
+                        .join(', ')}]. Please choose one of the valid values.`,
+                };
+            }
+        }
+        return { isValid: true };
+    }
+    catch (error) {
+        // Don't fail validation due to attribute fetch errors
+        createScopedLogger('utils/validation-utils', 'validateSelectField', OperationType.VALIDATION).error(`Error validating select field ${fieldName}`, error);
+        return { isValid: true };
+    }
+}
+/**
+ * Multi-select field validation
+ */
+export async function validateMultiSelectField(resourceType, fieldName, values) {
+    try {
+        const attributes = await getResourceAttributes(resourceType);
+        const field = attributes.find((attr) => attr.api_slug === fieldName);
+        if (field?.type === 'multi_select' && field.options) {
+            // Check against actual values, not titles
+            const validValues = field.options.map((opt) => opt.value);
+            const validTitles = field.options.map((opt) => opt.title || opt.value);
+            const invalidValues = values.filter((val) => !validValues.includes(val));
+            if (invalidValues.length > 0) {
+                return {
+                    isValid: false,
+                    error: `Invalid values [${invalidValues
+                        .map((v) => `'${v}'`)
+                        .join(', ')}] for multi-select field '${fieldName}'. Valid options are: [${validTitles
+                        .map((opt) => `'${opt}'`)
+                        .join(', ')}]. Please use only valid options.`,
+                };
+            }
+        }
+        return { isValid: true };
+    }
+    catch (error) {
+        createScopedLogger('utils/validation-utils', 'validateMultiSelectField', OperationType.VALIDATION).error(`Error validating multi-select field ${fieldName}`, error);
+        return { isValid: true };
+    }
+}
+/**
+ * Read-only field validation
+ */
+export async function validateReadOnlyFields(resourceType, updateFields) {
+    try {
+        const attributes = await getResourceAttributes(resourceType);
+        const readOnlyFields = attributes
+            .filter((attr) => attr.read_only === true)
+            .map((attr) => attr.api_slug);
+        const attemptedReadOnlyUpdates = Object.keys(updateFields).filter((fieldName) => readOnlyFields.includes(fieldName));
+        if (attemptedReadOnlyUpdates.length > 0) {
+            const fieldList = attemptedReadOnlyUpdates
+                .map((field) => `'${field}'`)
+                .join(', ');
+            const plural = attemptedReadOnlyUpdates.length > 1 ? 's' : '';
+            return {
+                isValid: false,
+                error: `Cannot update read-only field${plural} ${fieldList}. These fields are automatically managed by the system and cannot be modified. Remove ${plural ? 'these fields' : 'this field'} from your update request.`,
+            };
+        }
+        return { isValid: true };
+    }
+    catch (error) {
+        createScopedLogger('utils/validation-utils', 'validateReadOnlyFields', OperationType.VALIDATION).error(`Error validating read-only fields`, error);
+        return { isValid: true };
+    }
+}
+/**
+ * Optimized Levenshtein distance calculation using two-row optimization
+ * Reduces space complexity from O(n*m) to O(min(n,m))
+ */
+function calculateSimilarity(a, b) {
+    // Early exit for empty strings
+    if (a.length === 0)
+        return b.length;
+    if (b.length === 0)
+        return a.length;
+    // Ensure 'a' is the shorter string for space optimization
+    if (a.length > b.length) {
+        [a, b] = [b, a];
+    }
+    // Use two rows instead of full matrix
+    let prevRow = Array(a.length + 1)
+        .fill(0)
+        .map((_, i) => i);
+    let currRow = Array(a.length + 1).fill(0);
+    for (let j = 1; j <= b.length; j++) {
+        currRow[0] = j;
+        for (let i = 1; i <= a.length; i++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            currRow[i] = Math.min(currRow[i - 1] + 1, // deletion
+            prevRow[i] + 1, // insertion
+            prevRow[i - 1] + cost // substitution
+            );
+        }
+        // Swap rows
+        [prevRow, currRow] = [currRow, prevRow];
+    }
+    return prevRow[a.length];
+}
+/**
+ * Smart field name suggestions using similarity algorithms
+ */
+export async function suggestFieldName(resourceType, invalidFieldName) {
+    try {
+        const attributes = await getResourceAttributes(resourceType);
+        const validFieldNames = attributes.map((attr) => attr.api_slug);
+        // Exact match shortcut
+        if (validFieldNames.includes(invalidFieldName)) {
+            return [invalidFieldName];
+        }
+        // Find similar field names using configurable threshold
+        const suggestions = validFieldNames
+            .map((validName) => ({
+            name: validName,
+            distance: calculateSimilarity(invalidFieldName.toLowerCase(), validName.toLowerCase()),
+        }))
+            .filter((item) => item.distance <= CONFIG.SIMILARITY_THRESHOLD)
+            .sort((a, b) => a.distance - b.distance)
+            .slice(0, CONFIG.MAX_SUGGESTIONS) // Configurable suggestion limit
+            .map((item) => item.name);
+        return suggestions;
+    }
+    catch (error) {
+        createScopedLogger('utils/validation-utils', 'suggestFieldName', OperationType.VALIDATION).error(`Error suggesting field names for ${resourceType}`, error);
+        return [];
+    }
+}
+/**
+ * Field existence validation with suggestions
+ */
+export async function validateFieldExistence(resourceType, fieldNames) {
+    try {
+        const attributes = await getResourceAttributes(resourceType);
+        const validFields = attributes.map((attr) => attr.api_slug);
+        for (const fieldName of fieldNames) {
+            if (!validFields.includes(fieldName)) {
+                const suggestions = await suggestFieldName(resourceType, fieldName);
+                let errorMessage = `Unknown field '${fieldName}' for resource type '${resourceType}'.`;
+                if (suggestions.length > 0) {
+                    errorMessage += ` Did you mean: ${suggestions
+                        .map((s) => `'${s}'`)
+                        .join(', ')}?`;
+                }
+                errorMessage += ` Use get-attributes to see all available fields for this resource type.`;
+                return {
+                    isValid: false,
+                    error: errorMessage,
+                };
+            }
+        }
+        return { isValid: true };
+    }
+    catch (error) {
+        createScopedLogger('utils/validation-utils', 'validateFieldExistence', OperationType.VALIDATION).error('Error validating field existence', error);
+        return { isValid: true };
+    }
+}
+/**
+ * Comprehensive field validation for record operations
+ */
+export async function validateRecordFields(resourceType, fields, isUpdate = false) {
+    const fieldNames = Object.keys(fields);
+    // 1. Check if fields exist
+    const existenceValidation = await validateFieldExistence(resourceType, fieldNames);
+    if (!existenceValidation.isValid) {
+        return existenceValidation;
+    }
+    // 2. Check for read-only fields (only for updates)
+    if (isUpdate) {
+        const readOnlyValidation = await validateReadOnlyFields(resourceType, fields);
+        if (!readOnlyValidation.isValid) {
+            return readOnlyValidation;
+        }
+    }
+    // 3. Validate select fields
+    for (const [fieldName, value] of Object.entries(fields)) {
+        if (typeof value === 'string') {
+            const selectValidation = await validateSelectField(resourceType, fieldName, value);
+            if (!selectValidation.isValid) {
+                return selectValidation;
+            }
+        }
+        else if (Array.isArray(value) &&
+            value.every((v) => typeof v === 'string')) {
+            const multiSelectValidation = await validateMultiSelectField(resourceType, fieldName, value);
+            if (!multiSelectValidation.isValid) {
+                return multiSelectValidation;
+            }
+        }
+    }
+    return { isValid: true };
+}
+/**
+ * Clear the attribute cache (useful for testing)
+ */
+export function clearAttributeCache() {
+    attributeCache.clear();
+    cacheTimestamps.clear();
+}
+//# sourceMappingURL=validation-utils.js.map

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

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

package/dist/utils/validation.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Validation utility for validating input data against schemas
+ */
+import { ErrorType } from './error-handler.js';
+/**
+ * Result of a validation operation
+ */
+export interface ValidationResult {
+    isValid: boolean;
+    errors: string[];
+}
+/**
+ * Schema definition for validation
+ */
+export interface ValidationSchema {
+    type: string;
+    required?: string[];
+    properties?: Record<string, unknown>;
+    items?: ValidationSchema;
+    enum?: unknown[];
+    minLength?: number;
+    maxLength?: number;
+    minimum?: number;
+    maximum?: number;
+    pattern?: string;
+}
+/**
+ * Validates input data against a schema and returns the validation result
+ *
+ * @param input - Input data to validate
+ * @param schema - Schema to validate against
+ * @returns Validation result
+ */
+export declare function validateInput(input: unknown, schema: ValidationSchema): ValidationResult;
+/**
+ * Validates request parameters against a schema and returns a formatted error response if invalid
+ *
+ * @param input - Input data to validate
+ * @param schema - Schema to validate against
+ * @param errorFormatter - Function to format error response
+ * @returns Error response if invalid, null if valid
+ */
+export declare function validateRequest(input: unknown, schema: ValidationSchema, errorFormatter: (error: Error, type: ErrorType, details: Record<string, unknown>) => unknown): unknown | null;
+/**
+ * Validates that an ID string is valid and secure to use
+ *
+ * @param id - The ID to validate
+ * @returns True if the ID is valid, false otherwise
+ */
+export declare function isValidId(id: string): boolean;
+/**
+ * Validates that a list ID is valid and safe to use
+ * Contains additional validation specific to Attio list IDs
+ *
+ * @param listId - The list ID to validate
+ * @returns True if the list ID is valid, false otherwise
+ */
+export declare function isValidListId(listId: string): boolean;
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA6PD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,gBAAgB,GACvB,gBAAgB,CAOlB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,gBAAgB,EACxB,cAAc,EAAE,CACd,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,OAAO,GACX,OAAO,GAAG,IAAI,CAYhB;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CA2D7C;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAkBrD"}