@iflow-mcp/attio-mcp 1.3.6

package/dist/handlers/tool-configs/universal/field-mapper/validators/collision-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collision-detector.d.ts","sourceRoot":"","sources":["../../../../../../src/handlers/tool-configs/universal/field-mapper/validators/collision-detector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAoCpD;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,qBAAqB,EACnC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,mBAAmB,CAAC,EAAE,MAAM,EAAE,GAC7B,OAAO,CAAC;IACT,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACtC,CAAC,CAsED"}

package/dist/handlers/tool-configs/universal/field-mapper/validators/collision-detector.js

@@ -0,0 +1,82 @@
+/**
+ * Field collision detection and resolution
+ * Extracted from field-mapper.ts during Issue #529 modular refactoring
+ */
+import { UniversalResourceType } from '../types.js';
+import { RESOURCE_TYPE_MAPPINGS as FIELD_MAPPINGS } from '../constants/index.js';
+import { mapFieldName } from '../transformers/field-mapper.js';
+/**
+ * Gets suggestions for resolving field collisions
+ * Provides intelligent recommendations based on field characteristics
+ */
+function getFieldCollisionSuggestion(resourceType, targetField, conflictingFields) {
+    const mapping = FIELD_MAPPINGS[resourceType];
+    if (!mapping)
+        return '';
+    // Check if any of the conflicting fields is the actual target field
+    const preferredField = conflictingFields.find((f) => f === targetField);
+    if (preferredField) {
+        return `Recommended: Use "${preferredField}" instead of the mapped alternatives.`;
+    }
+    // Find the most "canonical" field name (shortest, most direct)
+    const sortedFields = conflictingFields.sort((a, b) => {
+        // Prefer fields without underscores/prefixes
+        const aScore = (a.includes('_') ? 1 : 0) + (a.includes(resourceType) ? 1 : 0);
+        const bScore = (b.includes('_') ? 1 : 0) + (b.includes(resourceType) ? 1 : 0);
+        if (aScore !== bScore)
+            return aScore - bScore;
+        return a.length - b.length;
+    });
+    return `Recommended: Use "${sortedFields[0]}" for clarity.`;
+}
+/**
+ * Detects field name collisions where multiple input fields map to the same output field
+ * Essential for preventing data overwrites and API conflicts
+ */
+export async function detectFieldCollisions(resourceType, recordData, availableAttributes) {
+    const mapping = FIELD_MAPPINGS[resourceType];
+    if (!mapping) {
+        return { hasCollisions: false, errors: [], collisions: {} };
+    }
+    // Map each target field to all input fields that map to it
+    const targetToInputs = {};
+    const errors = [];
+    for (const [inputField] of Object.entries(recordData)) {
+        // Skip null-mapped fields
+        if (mapping.fieldMappings[inputField.toLowerCase()] === null) {
+            continue;
+        }
+        const targetField = await mapFieldName(resourceType, inputField, availableAttributes);
+        // Harden against Promise-as-key bugs: validate targetField is a valid string
+        if (typeof targetField !== 'string' || !targetField) {
+            errors.push(`Internal mapping error: non-string target for "${inputField}". ` +
+                `Got ${Object.prototype.toString.call(targetField)}`);
+            continue;
+        }
+        if (!targetToInputs[targetField]) {
+            targetToInputs[targetField] = [];
+        }
+        targetToInputs[targetField].push(inputField);
+    }
+    // Find collisions (multiple inputs mapping to same target)
+    const collisions = {};
+    let hasCollisions = false;
+    for (const [targetField, inputFields] of Object.entries(targetToInputs)) {
+        if (inputFields.length > 1) {
+            // Special case: first_name + last_name → name is allowed
+            if (resourceType === UniversalResourceType.PEOPLE &&
+                targetField === 'name' &&
+                inputFields.every((f) => ['first_name', 'last_name'].includes(f))) {
+                continue; // This collision is handled specially
+            }
+            collisions[targetField] = inputFields;
+            hasCollisions = true;
+            const inputFieldsList = inputFields.map((f) => `"${f}"`).join(', ');
+            const suggestion = getFieldCollisionSuggestion(resourceType, targetField, inputFields);
+            errors.push(`Field collision detected: ${inputFieldsList} all map to "${targetField}". ` +
+                `Please use only one field. ${suggestion}`);
+        }
+    }
+    return { hasCollisions, errors, collisions };
+}
+//# sourceMappingURL=collision-detector.js.map

package/dist/handlers/tool-configs/universal/field-mapper/validators/collision-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collision-detector.js","sourceRoot":"","sources":["../../../../../../src/handlers/tool-configs/universal/field-mapper/validators/collision-detector.ts"],"names":[],"mappings":"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"}

package/dist/handlers/tool-configs/universal/field-mapper/validators/domain-validator.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Domain conflict detection for companies
+ * Extracted from field-mapper.ts during Issue #529 modular refactoring
+ */
+/**
+ * Checks if a domain already exists in the system to prevent uniqueness conflicts
+ * Essential for preventing duplicate company creation
+ */
+export declare function checkDomainConflict(domain: string): Promise<{
+    exists: boolean;
+    existingCompany?: {
+        name: string;
+        id: string;
+    };
+}>;
+//# sourceMappingURL=domain-validator.d.ts.map

package/dist/handlers/tool-configs/universal/field-mapper/validators/domain-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-validator.d.ts","sourceRoot":"","sources":["../../../../../../src/handlers/tool-configs/universal/field-mapper/validators/domain-validator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IACjE,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD,CAAC,CAkCD"}

package/dist/handlers/tool-configs/universal/field-mapper/validators/domain-validator.js

@@ -0,0 +1,43 @@
+/**
+ * Domain conflict detection for companies
+ * Extracted from field-mapper.ts during Issue #529 modular refactoring
+ */
+import { getLazyAttioClient } from '../../../../../api/lazy-client.js';
+import { createScopedLogger } from '../../../../../utils/logger.js';
+/**
+ * Checks if a domain already exists in the system to prevent uniqueness conflicts
+ * Essential for preventing duplicate company creation
+ */
+export async function checkDomainConflict(domain) {
+    try {
+        const client = getLazyAttioClient();
+        // Search for companies with this domain
+        const response = await client.post('/objects/companies/records/query', {
+            filter: {
+                domains: {
+                    any_of: [{ domain: domain }],
+                },
+            },
+            limit: 1,
+        });
+        const companies = response?.data?.data || [];
+        if (companies.length > 0) {
+            const existingCompany = companies[0];
+            return {
+                exists: true,
+                existingCompany: {
+                    name: existingCompany.values?.name?.[0]?.value || 'Unknown Company',
+                    id: existingCompany.id?.record_id || existingCompany.id,
+                },
+            };
+        }
+        return { exists: false };
+    }
+    catch (error) {
+        const log = createScopedLogger('validators.domain', 'checkDomainConflict');
+        log.warn('Failed to check domain conflict', { error: String(error) });
+        // If we can't check, assume no conflict to avoid blocking legitimate creates
+        return { exists: false };
+    }
+}
+//# sourceMappingURL=domain-validator.js.map

package/dist/handlers/tool-configs/universal/field-mapper/validators/domain-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-validator.js","sourceRoot":"","sources":["../../../../../../src/handlers/tool-configs/universal/field-mapper/validators/domain-validator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEpE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,MAAc;IAItD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAC;QAEpC,wCAAwC;QACxC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,kCAAkC,EAAE;YACrE,MAAM,EAAE;gBACN,OAAO,EAAE;oBACP,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;iBAC7B;aACF;YACD,KAAK,EAAE,CAAC;SACT,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,QAAQ,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;QAE7C,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,eAAe,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YACrC,OAAO;gBACL,MAAM,EAAE,IAAI;gBACZ,eAAe,EAAE;oBACf,IAAI,EAAE,eAAe,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,iBAAiB;oBACnE,EAAE,EAAE,eAAe,CAAC,EAAE,EAAE,SAAS,IAAI,eAAe,CAAC,EAAE;iBACxD;aACF,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,GAAG,GAAG,kBAAkB,CAAC,mBAAmB,EAAE,qBAAqB,CAAC,CAAC;QAC3E,GAAG,CAAC,IAAI,CAAC,iCAAiC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACtE,6EAA6E;QAC7E,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC3B,CAAC;AACH,CAAC"}

package/dist/handlers/tool-configs/universal/field-mapper/validators/field-validator.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Field validation and suggestion functions
+ * Extracted from field-mapper.ts during Issue #529 modular refactoring
+ */
+import { UniversalResourceType } from '../types.js';
+/**
+ * Gets field suggestions when a field name is not recognized
+ * Provides context-aware error messages and suggestions
+ */
+export declare function getFieldSuggestions(resourceType: UniversalResourceType, fieldName: string): string;
+/**
+ * Validates fields before API call and provides suggestions
+ * Performs comprehensive field validation with error categorization
+ */
+export declare function validateFields(resourceType: UniversalResourceType, recordData: Record<string, unknown>): {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+    suggestions: string[];
+};
+/**
+ * Get valid fields for a resource type
+ * Used for error messages and validation
+ */
+export declare function getValidFields(resourceType: UniversalResourceType): string[];
+//# sourceMappingURL=field-validator.d.ts.map

package/dist/handlers/tool-configs/universal/field-mapper/validators/field-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-validator.d.ts","sourceRoot":"","sources":["../../../../../../src/handlers/tool-configs/universal/field-mapper/validators/field-validator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAgDpD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,qBAAqB,EACnC,SAAS,EAAE,MAAM,GAChB,MAAM,CA4BR;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,YAAY,EAAE,qBAAqB,EACnC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC;IACD,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CAqEA;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,qBAAqB,GAAG,MAAM,EAAE,CAE5E"}

package/dist/handlers/tool-configs/universal/field-mapper/validators/field-validator.js

@@ -0,0 +1,134 @@
+/**
+ * Field validation and suggestion functions
+ * Extracted from field-mapper.ts during Issue #529 modular refactoring
+ */
+import { UniversalResourceType } from '../types.js';
+import { RESOURCE_TYPE_MAPPINGS as FIELD_MAPPINGS } from '../constants/index.js';
+import { strictModeFor } from '../config.js';
+import { findSimilarStrings } from './similarity-utils.js';
+/**
+ * Gets helpful error message with examples for required fields
+ * Provides concrete examples based on resource type
+ */
+function getRequiredFieldErrorMessage(resourceType, fieldName) {
+    const baseMessage = `Required field "${fieldName}" is missing`;
+    // Add resource-specific examples for common required fields
+    if (resourceType === UniversalResourceType.DEALS && fieldName === 'stage') {
+        // Don't hard-code stage examples - they vary by workspace
+        // Instead, guide users to discover valid options
+        return `${baseMessage}. Tip: Use records_get_attribute_options(resource_type="deals", attribute="stage") to see valid stages for your workspace.`;
+    }
+    if (resourceType === UniversalResourceType.DEALS && fieldName === 'name') {
+        return `${baseMessage}. Example: name: "Acme Corp Opportunity"`;
+    }
+    if (resourceType === UniversalResourceType.COMPANIES &&
+        fieldName === 'name') {
+        return `${baseMessage}. Example: name: "Acme Corporation"`;
+    }
+    if (resourceType === UniversalResourceType.PEOPLE &&
+        fieldName === 'email_addresses') {
+        return `${baseMessage}. Example: email_addresses: ["john@company.com"]`;
+    }
+    if (resourceType === UniversalResourceType.TASKS && fieldName === 'content') {
+        return `${baseMessage}. Example: content: "Follow up with prospect about proposal"`;
+    }
+    // Generic fallback
+    return baseMessage;
+}
+/**
+ * Gets field suggestions when a field name is not recognized
+ * Provides context-aware error messages and suggestions
+ */
+export function getFieldSuggestions(resourceType, fieldName) {
+    const mapping = FIELD_MAPPINGS[resourceType];
+    if (!mapping) {
+        return `Unable to provide suggestions for resource type ${resourceType}`;
+    }
+    // Check if there's a known mistake
+    const mistake = mapping.commonMistakes[fieldName.toLowerCase()];
+    if (mistake) {
+        return mistake;
+    }
+    // Check if it maps to null (invalid field)
+    if (mapping.fieldMappings[fieldName.toLowerCase()] === null) {
+        return (mapping.commonMistakes[fieldName.toLowerCase()] ||
+            `Field "${fieldName}" is not available for ${resourceType}`);
+    }
+    // Find similar valid fields
+    const suggestions = findSimilarStrings(fieldName, mapping.validFields);
+    if (suggestions.length > 0) {
+        return `Unknown field "${fieldName}". Did you mean: ${suggestions.join(' or ')}?`;
+    }
+    return `Unknown field "${fieldName}". Valid fields for ${resourceType}: ${mapping.validFields.join(', ')}`;
+}
+/**
+ * Validates fields before API call and provides suggestions
+ * Performs comprehensive field validation with error categorization
+ */
+export function validateFields(resourceType, recordData) {
+    const mapping = FIELD_MAPPINGS[resourceType];
+    if (!mapping) {
+        return {
+            valid: true,
+            errors: [],
+            warnings: [`No field validation available for ${resourceType}`],
+            suggestions: [],
+        };
+    }
+    const errors = [];
+    const warnings = [];
+    const suggestions = [];
+    // Check required fields (simplified version without async mapping)
+    if (mapping.requiredFields) {
+        for (const required of mapping.requiredFields) {
+            if (!(required in recordData)) {
+                // Check if a mapped version exists by checking mappings
+                const hasMappedVersion = Object.keys(recordData).some((key) => mapping.fieldMappings[key.toLowerCase()] === required);
+                if (!hasMappedVersion) {
+                    const errorMessage = getRequiredFieldErrorMessage(resourceType, required);
+                    errors.push(errorMessage);
+                }
+            }
+        }
+    }
+    // Check for unknown fields (simplified version without async mapping)
+    for (const field of Object.keys(recordData)) {
+        // If field maps to null, it's explicitly invalid
+        const lower = field.toLowerCase();
+        const invalidExplicit = mapping.fieldMappings[lower] === null;
+        if (invalidExplicit) {
+            const msg = getFieldSuggestions(resourceType, field);
+            if (strictModeFor(resourceType))
+                errors.push(msg);
+            else
+                warnings.push(msg);
+            continue;
+        }
+        // Check if field exists in valid fields or mappings
+        const hasMapping = !!mapping.fieldMappings[lower];
+        const isValidField = mapping.validFields.includes(field) ||
+            mapping.validFields.includes(lower);
+        // If field doesn't map and isn't in valid fields, it might be wrong
+        if (!hasMapping && !isValidField) {
+            const suggestion = getFieldSuggestions(resourceType, field);
+            if (strictModeFor(resourceType))
+                errors.push(`Unknown field "${field}". ${suggestion}`);
+            else if (suggestion.includes('Did you mean'))
+                suggestions.push(suggestion);
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+        suggestions,
+    };
+}
+/**
+ * Get valid fields for a resource type
+ * Used for error messages and validation
+ */
+export function getValidFields(resourceType) {
+    return FIELD_MAPPINGS[resourceType]?.validFields || [];
+}
+//# sourceMappingURL=field-validator.js.map

package/dist/handlers/tool-configs/universal/field-mapper/validators/field-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-validator.js","sourceRoot":"","sources":["../../../../../../src/handlers/tool-configs/universal/field-mapper/validators/field-validator.ts"],"names":[],"mappings":"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"}

package/dist/handlers/tool-configs/universal/field-mapper/validators/helpers.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Helper utilities for validation modules
+ * Extracted from field-mapper.ts during Issue #529 modular refactoring
+ */
+import { UniversalResourceType } from '../types.js';
+/**
+ * Utility function to check if an attribute exists in available attributes
+ * Case-insensitive matching for attribute names
+ */
+export declare const attrHas: (attrs?: string[], k?: string) => boolean;
+/**
+ * Resource type mappings - maps invalid resource types to valid ones
+ * Includes common typos and variations for user-friendly error correction
+ */
+export declare const RESOURCE_TYPE_MAPPINGS: Record<string, UniversalResourceType>;
+/**
+ * Get a list of valid resource types for error messages
+ */
+export declare function getValidResourceTypes(): string;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/handlers/tool-configs/universal/field-mapper/validators/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../../../src/handlers/tool-configs/universal/field-mapper/validators/helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD;;;GAGG;AACH,eAAO,MAAM,OAAO,GAAI,QAAQ,MAAM,EAAE,EAAE,IAAI,MAAM,KAAG,OACmB,CAAC;AAE3E;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAoBxE,CAAC;AAEF;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C"}

package/dist/handlers/tool-configs/universal/field-mapper/validators/helpers.js

@@ -0,0 +1,42 @@
+/**
+ * Helper utilities for validation modules
+ * Extracted from field-mapper.ts during Issue #529 modular refactoring
+ */
+import { UniversalResourceType } from '../types.js';
+/**
+ * Utility function to check if an attribute exists in available attributes
+ * Case-insensitive matching for attribute names
+ */
+export const attrHas = (attrs, k) => !!attrs && !!k && (attrs.includes(k) || attrs.includes(k.toLowerCase()));
+/**
+ * Resource type mappings - maps invalid resource types to valid ones
+ * Includes common typos and variations for user-friendly error correction
+ */
+export const RESOURCE_TYPE_MAPPINGS = {
+    record: UniversalResourceType.RECORDS,
+    records: UniversalResourceType.RECORDS,
+    company: UniversalResourceType.COMPANIES,
+    companies: UniversalResourceType.COMPANIES,
+    person: UniversalResourceType.PEOPLE,
+    people: UniversalResourceType.PEOPLE,
+    deal: UniversalResourceType.DEALS,
+    deals: UniversalResourceType.DEALS,
+    task: UniversalResourceType.TASKS,
+    tasks: UniversalResourceType.TASKS,
+    note: UniversalResourceType.NOTES,
+    notes: UniversalResourceType.NOTES,
+    // Common typos and variations
+    comapny: UniversalResourceType.COMPANIES,
+    compnay: UniversalResourceType.COMPANIES,
+    poeple: UniversalResourceType.PEOPLE,
+    peolpe: UniversalResourceType.PEOPLE,
+    dela: UniversalResourceType.DEALS,
+    dael: UniversalResourceType.DEALS,
+};
+/**
+ * Get a list of valid resource types for error messages
+ */
+export function getValidResourceTypes() {
+    return Object.values(UniversalResourceType).join(', ');
+}
+//# sourceMappingURL=helpers.js.map

package/dist/handlers/tool-configs/universal/field-mapper/validators/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../../../../src/handlers/tool-configs/universal/field-mapper/validators/helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,KAAgB,EAAE,CAAU,EAAW,EAAE,CAC/D,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;AAE3E;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAA0C;IAC3E,MAAM,EAAE,qBAAqB,CAAC,OAAO;IACrC,OAAO,EAAE,qBAAqB,CAAC,OAAO;IACtC,OAAO,EAAE,qBAAqB,CAAC,SAAS;IACxC,SAAS,EAAE,qBAAqB,CAAC,SAAS;IAC1C,MAAM,EAAE,qBAAqB,CAAC,MAAM;IACpC,MAAM,EAAE,qBAAqB,CAAC,MAAM;IACpC,IAAI,EAAE,qBAAqB,CAAC,KAAK;IACjC,KAAK,EAAE,qBAAqB,CAAC,KAAK;IAClC,IAAI,EAAE,qBAAqB,CAAC,KAAK;IACjC,KAAK,EAAE,qBAAqB,CAAC,KAAK;IAClC,IAAI,EAAE,qBAAqB,CAAC,KAAK;IACjC,KAAK,EAAE,qBAAqB,CAAC,KAAK;IAClC,8BAA8B;IAC9B,OAAO,EAAE,qBAAqB,CAAC,SAAS;IACxC,OAAO,EAAE,qBAAqB,CAAC,SAAS;IACxC,MAAM,EAAE,qBAAqB,CAAC,MAAM;IACpC,MAAM,EAAE,qBAAqB,CAAC,MAAM;IACpC,IAAI,EAAE,qBAAqB,CAAC,KAAK;IACjC,IAAI,EAAE,qBAAqB,CAAC,KAAK;CAClC,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,MAAM,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzD,CAAC"}

package/dist/handlers/tool-configs/universal/field-mapper/validators/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Field validation modules - centralized exports
+ * Extracted from field-mapper.ts during Issue #529 modular refactoring
+ */
+export { validateResourceType } from './resource-validator.js';
+export { getFieldSuggestions, validateFields, getValidFields, } from './field-validator.js';
+export { detectFieldCollisions } from './collision-detector.js';
+export { enhanceUniquenessError } from './uniqueness-validator.js';
+export { validateCategories, processCategories, getValidCategories, } from './category-validator.js';
+export { checkDomainConflict } from './domain-validator.js';
+export { attrHas, RESOURCE_TYPE_MAPPINGS, getValidResourceTypes, } from './helpers.js';
+export { findSimilarStrings, calculateSimilarity, levenshteinDistance, } from './similarity-utils.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/handlers/tool-configs/universal/field-mapper/validators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/handlers/tool-configs/universal/field-mapper/validators/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAG/D,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,cAAc,GACf,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAGnE,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,EACL,OAAO,EACP,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC"}

package/dist/handlers/tool-configs/universal/field-mapper/validators/index.js

@@ -0,0 +1,21 @@
+/**
+ * Field validation modules - centralized exports
+ * Extracted from field-mapper.ts during Issue #529 modular refactoring
+ */
+// Resource validation
+export { validateResourceType } from './resource-validator.js';
+// Field validation
+export { getFieldSuggestions, validateFields, getValidFields, } from './field-validator.js';
+// Collision detection
+export { detectFieldCollisions } from './collision-detector.js';
+// Uniqueness validation
+export { enhanceUniquenessError } from './uniqueness-validator.js';
+// Category validation
+export { validateCategories, processCategories, getValidCategories, } from './category-validator.js';
+// Domain validation
+export { checkDomainConflict } from './domain-validator.js';
+// Helper utilities
+export { attrHas, RESOURCE_TYPE_MAPPINGS, getValidResourceTypes, } from './helpers.js';
+// String similarity utilities
+export { findSimilarStrings, calculateSimilarity, levenshteinDistance, } from './similarity-utils.js';
+//# sourceMappingURL=index.js.map

package/dist/handlers/tool-configs/universal/field-mapper/validators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/handlers/tool-configs/universal/field-mapper/validators/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,sBAAsB;AACtB,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAE/D,mBAAmB;AACnB,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,cAAc,GACf,MAAM,sBAAsB,CAAC;AAE9B,sBAAsB;AACtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,wBAAwB;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,sBAAsB;AACtB,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AAEjC,oBAAoB;AACpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,mBAAmB;AACnB,OAAO,EACL,OAAO,EACP,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAEtB,8BAA8B;AAC9B,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC"}

package/dist/handlers/tool-configs/universal/field-mapper/validators/resource-validator.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Resource type validation functions
+ * Extracted from field-mapper.ts during Issue #529 modular refactoring
+ */
+import { UniversalResourceType } from '../types.js';
+/**
+ * Validates a resource type and provides corrections if invalid
+ * Supports fuzzy matching for common typos and suggestions
+ */
+export declare function validateResourceType(resourceType: string): {
+    valid: boolean;
+    corrected?: UniversalResourceType;
+    suggestion?: string;
+};
+//# sourceMappingURL=resource-validator.d.ts.map

package/dist/handlers/tool-configs/universal/field-mapper/validators/resource-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-validator.d.ts","sourceRoot":"","sources":["../../../../../../src/handlers/tool-configs/universal/field-mapper/validators/resource-validator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAIpD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG;IAC1D,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAgCA"}

package/dist/handlers/tool-configs/universal/field-mapper/validators/resource-validator.js

@@ -0,0 +1,36 @@
+/**
+ * Resource type validation functions
+ * Extracted from field-mapper.ts during Issue #529 modular refactoring
+ */
+import { UniversalResourceType } from '../types.js';
+import { RESOURCE_TYPE_MAPPINGS, getValidResourceTypes } from './helpers.js';
+import { findSimilarStrings } from './similarity-utils.js';
+/**
+ * Validates a resource type and provides corrections if invalid
+ * Supports fuzzy matching for common typos and suggestions
+ */
+export function validateResourceType(resourceType) {
+    // Check if it's already valid
+    if (Object.values(UniversalResourceType).includes(resourceType)) {
+        return { valid: true }; // No corrected field when valid
+    }
+    // Try to map it
+    const mapped = RESOURCE_TYPE_MAPPINGS[resourceType.toLowerCase()];
+    if (mapped) {
+        return {
+            valid: false,
+            corrected: mapped,
+            suggestion: `Did you mean "${mapped}"? The resource type "${resourceType}" was automatically corrected.`,
+        };
+    }
+    // Generate suggestions using fuzzy matching
+    const validTypes = Object.values(UniversalResourceType);
+    const suggestions = findSimilarStrings(resourceType, validTypes);
+    return {
+        valid: false,
+        suggestion: `Invalid resource type "${resourceType}". Valid types are: ${getValidResourceTypes()}${suggestions.length > 0
+            ? `. Did you mean: ${suggestions.join(' or ')}?`
+            : ''}`,
+    };
+}
+//# sourceMappingURL=resource-validator.js.map

package/dist/handlers/tool-configs/universal/field-mapper/validators/resource-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-validator.js","sourceRoot":"","sources":["../../../../../../src/handlers/tool-configs/universal/field-mapper/validators/resource-validator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,YAAoB;IAKvD,8BAA8B;IAC9B,IACE,MAAM,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC,QAAQ,CAC3C,YAAqC,CACtC,EACD,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,gCAAgC;IAC1D,CAAC;IAED,gBAAgB;IAChB,MAAM,MAAM,GAAG,sBAAsB,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,CAAC;IAClE,IAAI,MAAM,EAAE,CAAC;QACX,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,SAAS,EAAE,MAAM;YACjB,UAAU,EAAE,iBAAiB,MAAM,yBAAyB,YAAY,gCAAgC;SACzG,CAAC;IACJ,CAAC;IAED,4CAA4C;IAC5C,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,qBAAqB,CAAa,CAAC;IACpE,MAAM,WAAW,GAAG,kBAAkB,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAEjE,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,UAAU,EAAE,0BAA0B,YAAY,uBAAuB,qBAAqB,EAAE,GAC9F,WAAW,CAAC,MAAM,GAAG,CAAC;YACpB,CAAC,CAAC,mBAAmB,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG;YAChD,CAAC,CAAC,EACN,EAAE;KACH,CAAC;AACJ,CAAC"}

package/dist/handlers/tool-configs/universal/field-mapper/validators/similarity-utils.d.ts

@@ -0,0 +1,20 @@
+/**
+ * String similarity utilities for field and resource type suggestions
+ * Extracted from field-mapper.ts during Issue #529 modular refactoring
+ */
+/**
+ * Simple string similarity function for suggestions
+ * Uses Levenshtein distance to find similar strings
+ */
+export declare function findSimilarStrings(input: string, candidates: string[], threshold?: number): string[];
+/**
+ * Calculate Levenshtein distance-based similarity
+ * Returns a score between 0 (no similarity) and 1 (identical)
+ */
+export declare function calculateSimilarity(str1: string, str2: string): number;
+/**
+ * Calculate Levenshtein distance between two strings
+ * The minimum number of single-character edits required to change one string into another
+ */
+export declare function levenshteinDistance(str1: string, str2: string): number;
+//# sourceMappingURL=similarity-utils.d.ts.map

package/dist/handlers/tool-configs/universal/field-mapper/validators/similarity-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"similarity-utils.d.ts","sourceRoot":"","sources":["../../../../../../src/handlers/tool-configs/universal/field-mapper/validators/similarity-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAAE,EACpB,SAAS,GAAE,MAAY,GACtB,MAAM,EAAE,CAiBV;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAUtE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CA0BtE"}

package/dist/handlers/tool-configs/universal/field-mapper/validators/similarity-utils.js

@@ -0,0 +1,62 @@
+/**
+ * String similarity utilities for field and resource type suggestions
+ * Extracted from field-mapper.ts during Issue #529 modular refactoring
+ */
+/**
+ * Simple string similarity function for suggestions
+ * Uses Levenshtein distance to find similar strings
+ */
+export function findSimilarStrings(input, candidates, threshold = 0.6) {
+    const similarities = [];
+    for (const candidate of candidates) {
+        const score = calculateSimilarity(input.toLowerCase(), candidate.toLowerCase());
+        if (score >= threshold) {
+            similarities.push({ str: candidate, score });
+        }
+    }
+    return similarities
+        .sort((a, b) => b.score - a.score)
+        .slice(0, 3)
+        .map((s) => s.str);
+}
+/**
+ * Calculate Levenshtein distance-based similarity
+ * Returns a score between 0 (no similarity) and 1 (identical)
+ */
+export function calculateSimilarity(str1, str2) {
+    const longer = str1.length > str2.length ? str1 : str2;
+    const shorter = str1.length > str2.length ? str2 : str1;
+    if (longer.length === 0) {
+        return 1.0;
+    }
+    const editDistance = levenshteinDistance(longer, shorter);
+    return (longer.length - editDistance) / longer.length;
+}
+/**
+ * Calculate Levenshtein distance between two strings
+ * The minimum number of single-character edits required to change one string into another
+ */
+export function levenshteinDistance(str1, str2) {
+    const matrix = [];
+    for (let i = 0; i <= str2.length; i++) {
+        matrix[i] = [i];
+    }
+    for (let j = 0; j <= str1.length; j++) {
+        matrix[0][j] = j;
+    }
+    for (let i = 1; i <= str2.length; i++) {
+        for (let j = 1; j <= str1.length; j++) {
+            if (str2.charAt(i - 1) === str1.charAt(j - 1)) {
+                matrix[i][j] = matrix[i - 1][j - 1];
+            }
+            else {
+                matrix[i][j] = Math.min(matrix[i - 1][j - 1] + 1, // substitution
+                matrix[i][j - 1] + 1, // insertion
+                matrix[i - 1][j] + 1 // deletion
+                );
+            }
+        }
+    }
+    return matrix[str2.length][str1.length];
+}
+//# sourceMappingURL=similarity-utils.js.map

package/dist/handlers/tool-configs/universal/field-mapper/validators/similarity-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"similarity-utils.js","sourceRoot":"","sources":["../../../../../../src/handlers/tool-configs/universal/field-mapper/validators/similarity-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAa,EACb,UAAoB,EACpB,YAAoB,GAAG;IAEvB,MAAM,YAAY,GAA0C,EAAE,CAAC;IAE/D,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,mBAAmB,CAC/B,KAAK,CAAC,WAAW,EAAE,EACnB,SAAS,CAAC,WAAW,EAAE,CACxB,CAAC;QACF,IAAI,KAAK,IAAI,SAAS,EAAE,CAAC;YACvB,YAAY,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,OAAO,YAAY;SAChB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;SACjC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,IAAY;IAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACvD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAExD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,YAAY,GAAG,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1D,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,YAAY,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,IAAY;IAC5D,MAAM,MAAM,GAAe,EAAE,CAAC;IAE9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBAC9C,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACtC,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CACrB,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,eAAe;gBACzC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,YAAY;gBAClC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW;iBACjC,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC"}

package/dist/handlers/tool-configs/universal/field-mapper/validators/uniqueness-validator.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Uniqueness constraint error enhancement
+ * Extracted from field-mapper.ts during Issue #529 modular refactoring
+ */
+import { UniversalResourceType } from '../types.js';
+/**
+ * Enhanced uniqueness constraint error message
+ * Converts technical API errors into user-friendly explanations
+ */
+export declare function enhanceUniquenessError(resourceType: UniversalResourceType, errorMessage: string, recordData: Record<string, unknown>): Promise<string>;
+//# sourceMappingURL=uniqueness-validator.d.ts.map

package/dist/handlers/tool-configs/universal/field-mapper/validators/uniqueness-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniqueness-validator.d.ts","sourceRoot":"","sources":["../../../../../../src/handlers/tool-configs/universal/field-mapper/validators/uniqueness-validator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAKpD;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,YAAY,EAAE,qBAAqB,EACnC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC,MAAM,CAAC,CA4DjB"}