@iflow-mcp/attio-mcp 1.3.6

package/dist/handlers/tool-configs/universal/field-mapper/transformers/value-transformer.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Field value transformation functions
+ * Extracted from field-mapper.ts during Issue #529 modular refactoring
+ */
+import { UniversalResourceType } from '../../../../../handlers/tool-configs/universal/field-mapper/types.js';
+/**
+ * Transforms field values to match Attio API expectations
+ * Handles complex field value transformations for each resource type
+ */
+export declare function transformFieldValue(resourceType: UniversalResourceType, fieldName: string, value: unknown): Promise<unknown>;
+//# sourceMappingURL=value-transformer.d.ts.map

package/dist/handlers/tool-configs/universal/field-mapper/transformers/value-transformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-transformer.d.ts","sourceRoot":"","sources":["../../../../../../src/handlers/tool-configs/universal/field-mapper/transformers/value-transformer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,yDAAyD,CAAC;AA+BhG;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,qBAAqB,EACnC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,OAAO,CAAC,CAuLlB"}

package/dist/handlers/tool-configs/universal/field-mapper/transformers/value-transformer.js

@@ -0,0 +1,187 @@
+/**
+ * Field value transformation functions
+ * Extracted from field-mapper.ts during Issue #529 modular refactoring
+ */
+import { UniversalResourceType } from '../../../../../handlers/tool-configs/universal/field-mapper/types.js';
+import { normalizeLocation } from '../../../../../utils/location-normalizer.js';
+/**
+ * Converts various value types to boolean for task completion status
+ * Supports common task status strings and values
+ */
+function toBooleanish(v) {
+    if (typeof v === 'boolean')
+        return v;
+    if (typeof v === 'number')
+        return v !== 0;
+    if (typeof v === 'string') {
+        const s = v.trim().toLowerCase();
+        if ([
+            'done',
+            'complete',
+            'completed',
+            'true',
+            'yes',
+            'y',
+            '1',
+            'closed',
+        ].includes(s))
+            return true;
+        if (['open', 'pending', 'in progress', 'false', 'no', 'n', '0'].includes(s))
+            return false;
+    }
+    return undefined;
+}
+/**
+ * Transforms field values to match Attio API expectations
+ * Handles complex field value transformations for each resource type
+ */
+export async function transformFieldValue(resourceType, fieldName, value) {
+    // Handle domains field for companies
+    if (resourceType === UniversalResourceType.COMPANIES &&
+        fieldName === 'domains') {
+        // If value is already in correct format, return as-is
+        if (Array.isArray(value) &&
+            value.every((v) => typeof v === 'object' && 'domain' in v)) {
+            return value;
+        }
+        // If value is an array of strings, transform to domain objects
+        if (Array.isArray(value) && value.every((v) => typeof v === 'string')) {
+            return value.map((domain) => ({ domain }));
+        }
+        // If value is a single string, transform to array with domain object
+        if (typeof value === 'string') {
+            return [{ domain: value }];
+        }
+        // If value is a single domain object, wrap in array
+        if (typeof value === 'object' && value !== null && 'domain' in value) {
+            return [value];
+        }
+    }
+    // Handle email_addresses field for people
+    if (resourceType === UniversalResourceType.PEOPLE &&
+        fieldName === 'email_addresses') {
+        // If value is already in correct format, return as-is
+        if (Array.isArray(value) &&
+            value.every((v) => typeof v === 'object' && 'email_address' in v)) {
+            return value;
+        }
+        // If value is an array of strings, transform to email objects
+        if (Array.isArray(value) && value.every((v) => typeof v === 'string')) {
+            return value.map((email) => ({ email_address: email }));
+        }
+        // If value is a single string, transform to array with email object
+        if (typeof value === 'string') {
+            return [{ email_address: value }];
+        }
+        // If value is a single email object, wrap in array
+        if (typeof value === 'object' &&
+            value !== null &&
+            'email_address' in value) {
+            return [value];
+        }
+    }
+    // Handle phone_numbers field for people
+    if (resourceType === UniversalResourceType.PEOPLE &&
+        fieldName === 'phone_numbers') {
+        // If value is already in correct format, return as-is
+        if (Array.isArray(value) &&
+            value.every((v) => typeof v === 'object' && 'phone_number' in v)) {
+            return value;
+        }
+        // If value is an array of strings, transform to phone objects
+        if (Array.isArray(value) && value.every((v) => typeof v === 'string')) {
+            return value.map((phone) => ({ phone_number: phone }));
+        }
+        // If value is a single string, transform to array with phone object
+        if (typeof value === 'string') {
+            return [{ phone_number: value }];
+        }
+        // If value is a single phone object, wrap in array
+        if (typeof value === 'object' &&
+            value !== null &&
+            'phone_number' in value) {
+            return [value];
+        }
+    }
+    // People.company → [{ record_id }] (normalize all formats to array-of-refs)
+    if (resourceType === UniversalResourceType.PEOPLE &&
+        fieldName === 'company') {
+        const toRef = (v) => {
+            if (typeof v === 'string')
+                return { record_id: v };
+            if (v && typeof v === 'object') {
+                const obj = v;
+                if (obj.record_id)
+                    return { record_id: obj.record_id };
+                if (obj.id && typeof obj.id === 'object') {
+                    const idObj = obj.id;
+                    if (idObj.record_id)
+                        return { record_id: idObj.record_id };
+                }
+                if (obj.id)
+                    return { record_id: obj.id };
+            }
+            return v; // last-resort passthrough
+        };
+        if (Array.isArray(value))
+            return value.map(toRef);
+        return [toRef(value)];
+    }
+    // Deals.associated_company / associated_people → [{ record_id }]
+    if (resourceType === UniversalResourceType.DEALS &&
+        (fieldName === 'associated_company' || fieldName === 'associated_people')) {
+        const toRef = (v) => (typeof v === 'string' && { record_id: v }) ||
+            (v && typeof v === 'object' && 'record_id' in v ? v : null);
+        const arr = Array.isArray(value) ? value : [value];
+        const refs = arr.map(toRef).filter(Boolean);
+        return refs.length ? refs : value;
+    }
+    // Tasks field transformations
+    if (resourceType === UniversalResourceType.TASKS) {
+        if (fieldName === 'is_completed') {
+            const b = toBooleanish(value);
+            return b === undefined ? value : b;
+        }
+        if (fieldName === 'deadline_at') {
+            // accept Date, number (ms), or string; output ISO
+            if (value instanceof Date)
+                return value.toISOString();
+            if (typeof value === 'number')
+                return new Date(value).toISOString();
+            if (typeof value === 'string') {
+                const d = new Date(value);
+                return isNaN(d.getTime()) ? value : d.toISOString();
+            }
+        }
+        if (fieldName === 'assignees') {
+            // Convert single string to array for assignees field
+            if (typeof value === 'string') {
+                return [value];
+            }
+            // If already an array, return as-is
+            if (Array.isArray(value)) {
+                return value;
+            }
+            // For other types, wrap in array
+            return [value];
+        }
+    }
+    // Handle location fields (primary_location, location) for companies and people
+    // Attio requires ALL location fields to be present, even if null
+    // Uses shared normalizeLocation utility for consistent behavior
+    if ((resourceType === UniversalResourceType.COMPANIES ||
+        resourceType === UniversalResourceType.PEOPLE) &&
+        (fieldName === 'primary_location' || fieldName === 'location')) {
+        // If value is a string, Attio will parse it - pass through
+        if (typeof value === 'string') {
+            return value;
+        }
+        // If value is an object, normalize to ensure all required fields are present
+        if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+            return normalizeLocation(value);
+        }
+    }
+    // Default: return value unchanged
+    return value;
+}
+//# sourceMappingURL=value-transformer.js.map

package/dist/handlers/tool-configs/universal/field-mapper/transformers/value-transformer.js.map

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

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

@@ -0,0 +1,108 @@
+/**
+ * Shared types and interfaces for field-mapper modules
+ * Extracted during Issue #529 modular refactoring
+ */
+import { UniversalResourceType } from '../types.js';
+export { UniversalResourceType };
+/**
+ * Field mapping configuration for each resource type
+ */
+export interface FieldMapping {
+    /** Maps incorrect field names to correct ones (null means invalid field) */
+    fieldMappings: Record<string, string | null>;
+    /** List of valid fields for this resource type */
+    validFields: string[];
+    /** Common mistakes and their explanations */
+    commonMistakes: Record<string, string>;
+    /** Required fields for creation */
+    requiredFields?: string[];
+    /** Fields that must be unique */
+    uniqueFields?: string[];
+}
+/**
+ * Result of field mapping operation
+ */
+export interface MappingResult {
+    /** The mapped record data */
+    mapped: Record<string, unknown>;
+    /** Warnings about mappings that were applied */
+    warnings: string[];
+    /** Errors that occurred during mapping */
+    errors?: string[];
+}
+/**
+ * Result of field collision detection
+ */
+export interface CollisionResult {
+    /** Whether collisions were detected */
+    hasCollisions: boolean;
+    /** Array of error messages */
+    errors: string[];
+    /** Map of target fields to arrays of input fields that collide */
+    collisions: Record<string, string[]>;
+}
+/**
+ * Result of resource type validation
+ */
+export interface ResourceValidationResult {
+    /** Whether the resource type is valid */
+    valid: boolean;
+    /** Corrected resource type if invalid but mappable */
+    corrected?: UniversalResourceType;
+    /** Suggestion message for invalid types */
+    suggestion?: string;
+}
+/**
+ * Result of field validation
+ */
+export interface FieldValidationResult {
+    /** Whether all fields are valid */
+    valid: boolean;
+    /** Array of validation errors */
+    errors: string[];
+    /** Array of validation warnings */
+    warnings: string[];
+    /** Array of suggestions for invalid fields */
+    suggestions: string[];
+}
+/**
+ * Result of category validation
+ */
+export interface CategoryValidationResult {
+    /** Whether the categories are valid */
+    isValid: boolean;
+    /** Array of validation errors */
+    errors: string[];
+    /** Array of processed/corrected categories */
+    categories?: string[];
+}
+/**
+ * Result of domain conflict check
+ */
+export interface DomainConflictResult {
+    /** Whether a conflict exists */
+    exists: boolean;
+    /** Information about existing company if conflict found */
+    existingCompany?: {
+        name: string;
+        id: string;
+    };
+}
+/**
+ * Category object structure used in processing
+ */
+export interface CategoryObject {
+    name: string;
+    id?: string;
+    [key: string]: unknown;
+}
+/**
+ * Options for field transformation
+ */
+export interface TransformOptions {
+    /** Skip domain preflight checks */
+    skipDomainPreflight?: boolean;
+    /** Additional context for transformation */
+    context?: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/field-mapper/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGpD,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAEjC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,4EAA4E;IAC5E,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7C,kDAAkD;IAClD,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,6CAA6C;IAC7C,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,mCAAmC;IACnC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,gDAAgD;IAChD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,aAAa,EAAE,OAAO,CAAC;IACvB,8BAA8B;IAC9B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,yCAAyC;IACzC,KAAK,EAAE,OAAO,CAAC;IACf,sDAAsD;IACtD,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,mCAAmC;IACnC,KAAK,EAAE,OAAO,CAAC;IACf,iCAAiC;IACjC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,8CAA8C;IAC9C,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,iCAAiC;IACjC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,gCAAgC;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,2DAA2D;IAC3D,eAAe,CAAC,EAAE;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;KACZ,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mCAAmC;IACnC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC"}

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

@@ -0,0 +1,8 @@
+/**
+ * Shared types and interfaces for field-mapper modules
+ * Extracted during Issue #529 modular refactoring
+ */
+import { UniversalResourceType } from '../types.js';
+// Re-export UniversalResourceType for module-internal use
+export { UniversalResourceType };
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/field-mapper/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD,0DAA0D;AAC1D,OAAO,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/handlers/tool-configs/universal/field-mapper/utils/field-mapping-constants.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Shared utility for creating field mapping constants
+ * Created for Issue #720 to ensure consistent field mapping patterns across resource types
+ */
+export interface DisplayNameConstants {
+    readonly [key: string]: string;
+}
+export interface PluralMappingConstants {
+    readonly [key: string]: string;
+}
+/**
+ * Creates standardized display name constants for field mappings
+ * @param displayNames Object mapping constant keys to display names
+ * @returns Readonly object with display name constants
+ */
+export declare function createDisplayNameConstants<T extends Record<string, string>>(displayNames: T): Readonly<T>;
+/**
+ * Creates standardized plural mapping constants for field mappings
+ * @param pluralMappings Object mapping plural field names to singular API field names
+ * @returns Readonly object with plural mapping constants
+ */
+export declare function createPluralMappingConstants<T extends Record<string, string>>(pluralMappings: T): Readonly<T>;
+/**
+ * Utility to validate field mapping constants for consistency
+ * @param displayNames Display name constants object
+ * @param pluralMappings Plural mapping constants object
+ * @returns Validation result with any inconsistencies found
+ */
+export declare function validateFieldMappingConstants(displayNames: DisplayNameConstants, pluralMappings: PluralMappingConstants): {
+    valid: boolean;
+    issues: string[];
+};
+//# sourceMappingURL=field-mapping-constants.d.ts.map

package/dist/handlers/tool-configs/universal/field-mapper/utils/field-mapping-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-mapping-constants.d.ts","sourceRoot":"","sources":["../../../../../../src/handlers/tool-configs/universal/field-mapper/utils/field-mapping-constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CAChC;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACzE,YAAY,EAAE,CAAC,GACd,QAAQ,CAAC,CAAC,CAAC,CAEb;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC3E,cAAc,EAAE,CAAC,GAChB,QAAQ,CAAC,CAAC,CAAC,CAEb;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,oBAAoB,EAClC,cAAc,EAAE,sBAAsB,GACrC;IACD,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CA4BA"}

package/dist/handlers/tool-configs/universal/field-mapper/utils/field-mapping-constants.js

@@ -0,0 +1,49 @@
+/**
+ * Shared utility for creating field mapping constants
+ * Created for Issue #720 to ensure consistent field mapping patterns across resource types
+ */
+/**
+ * Creates standardized display name constants for field mappings
+ * @param displayNames Object mapping constant keys to display names
+ * @returns Readonly object with display name constants
+ */
+export function createDisplayNameConstants(displayNames) {
+    return Object.freeze(displayNames);
+}
+/**
+ * Creates standardized plural mapping constants for field mappings
+ * @param pluralMappings Object mapping plural field names to singular API field names
+ * @returns Readonly object with plural mapping constants
+ */
+export function createPluralMappingConstants(pluralMappings) {
+    return Object.freeze(pluralMappings);
+}
+/**
+ * Utility to validate field mapping constants for consistency
+ * @param displayNames Display name constants object
+ * @param pluralMappings Plural mapping constants object
+ * @returns Validation result with any inconsistencies found
+ */
+export function validateFieldMappingConstants(displayNames, pluralMappings) {
+    const issues = [];
+    // Check for empty objects
+    if (Object.keys(displayNames).length === 0) {
+        issues.push('Display names object is empty');
+    }
+    if (Object.keys(pluralMappings).length === 0) {
+        issues.push('Plural mappings object is empty');
+    }
+    // Check for potential conflicts between display names and plural mappings
+    const displayValues = Object.values(displayNames);
+    const pluralKeys = Object.keys(pluralMappings);
+    for (const pluralKey of pluralKeys) {
+        if (displayValues.includes(pluralKey)) {
+            issues.push(`Potential conflict: plural key "${pluralKey}" matches a display name value`);
+        }
+    }
+    return {
+        valid: issues.length === 0,
+        issues,
+    };
+}
+//# sourceMappingURL=field-mapping-constants.js.map

package/dist/handlers/tool-configs/universal/field-mapper/utils/field-mapping-constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-mapping-constants.js","sourceRoot":"","sources":["../../../../../../src/handlers/tool-configs/universal/field-mapper/utils/field-mapping-constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACxC,YAAe;IAEf,OAAO,MAAM,CAAC,MAAM,CAAC,YAAY,CAAgB,CAAC;AACpD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAC1C,cAAiB;IAEjB,OAAO,MAAM,CAAC,MAAM,CAAC,cAAc,CAAgB,CAAC;AACtD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAC3C,YAAkC,EAClC,cAAsC;IAKtC,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,0BAA0B;IAC1B,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3C,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7C,MAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IACjD,CAAC;IAED,0EAA0E;IAC1E,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAE/C,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACtC,MAAM,CAAC,IAAI,CACT,mCAAmC,SAAS,gCAAgC,CAC7E,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC1B,MAAM;KACP,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,31 @@
+/**
+ * Category validation for companies
+ * Extracted from field-mapper.ts during Issue #529 modular refactoring
+ */
+import { UniversalResourceType } from '../types.js';
+/**
+ * Validates category values and provides suggestions (Issues #220/#218)
+ * Supports both string and array inputs with auto-conversion
+ */
+export declare function validateCategories(input: string | string[]): {
+    isValid: boolean;
+    validatedCategories: string[];
+    suggestions: string[];
+    errors: string[];
+    autoConverted: boolean;
+};
+/**
+ * Auto-converts and validates categories field for companies (Issues #220/#218)
+ * Main processing function that integrates validation with transformation
+ */
+export declare function processCategories(resourceType: UniversalResourceType, fieldName: string, value: unknown): {
+    processedValue: unknown;
+    warnings: string[];
+    errors: string[];
+};
+/**
+ * Get list of valid categories for companies
+ * Used for error messages and documentation
+ */
+export declare function getValidCategories(): string[];
+//# sourceMappingURL=category-validator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"category-validator.d.ts","sourceRoot":"","sources":["../../../../../../src/handlers/tool-configs/universal/field-mapper/validators/category-validator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AA8CpD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG;IAC5D,OAAO,EAAE,OAAO,CAAC;IACjB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;CACxB,CAgFA;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,qBAAqB,EACnC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,GACb;IACD,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAiDA;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C"}

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

@@ -0,0 +1,157 @@
+/**
+ * Category validation for companies
+ * Extracted from field-mapper.ts during Issue #529 modular refactoring
+ */
+import { UniversalResourceType } from '../types.js';
+import { findSimilarStrings } from './similarity-utils.js';
+/**
+ * Valid category options for companies (from Issues #220/#218)
+ * Comprehensive list of industry categories with proper casing
+ */
+const VALID_COMPANY_CATEGORIES = [
+    'Health Care',
+    'Technology',
+    'Software',
+    'SaaS',
+    'B2B',
+    'B2C',
+    'E-commerce',
+    'Financial Services',
+    'Banking',
+    'Finance',
+    'Insurance',
+    'Manufacturing',
+    'Retail',
+    'Education',
+    'Consulting',
+    'Real Estate',
+    'Media & Entertainment',
+    'Transportation',
+    'Energy',
+    'Food & Beverage',
+    'Construction',
+    'Telecommunications',
+    'Automotive',
+    'Aerospace',
+    'Pharmaceuticals',
+    'Biotechnology',
+    'Non-profit',
+    'Government',
+    'Agriculture',
+    'Mining',
+    'Utilities',
+    'Hospitality',
+    'Travel',
+    'Sports',
+    'Fashion',
+    'Beauty',
+];
+/**
+ * Validates category values and provides suggestions (Issues #220/#218)
+ * Supports both string and array inputs with auto-conversion
+ */
+export function validateCategories(input) {
+    const result = {
+        isValid: true,
+        validatedCategories: [],
+        suggestions: [],
+        errors: [],
+        autoConverted: false,
+    };
+    // Handle string-to-array auto-conversion (Issue #218)
+    let categories;
+    if (typeof input === 'string') {
+        categories = [input];
+        result.autoConverted = true;
+    }
+    else if (Array.isArray(input)) {
+        categories = input;
+    }
+    else {
+        result.isValid = false;
+        result.errors.push('Categories must be a string or array of strings. Use ["category"] format for arrays.');
+        return result;
+    }
+    // Validate each category and deduplicate
+    const processedCategories = new Set();
+    for (const category of categories) {
+        if (typeof category !== 'string') {
+            result.isValid = false;
+            result.errors.push(`Invalid category type: ${typeof category}. All categories must be strings.`);
+            continue;
+        }
+        // Skip empty categories
+        if (!category.trim()) {
+            result.isValid = false;
+            result.errors.push('Empty category is not allowed.');
+            continue;
+        }
+        // Check if category is valid (case-insensitive)
+        const exactMatch = VALID_COMPANY_CATEGORIES.find((valid) => valid.toLowerCase() === category.toLowerCase());
+        if (exactMatch) {
+            processedCategories.add(exactMatch); // Use canonical casing and deduplicate
+        }
+        else {
+            // Find similar categories using fuzzy matching (Issue #220)
+            // Use lower threshold for shorter words
+            const threshold = category.length <= 4 ? 0.3 : 0.5;
+            const suggestions = findSimilarStrings(category, VALID_COMPANY_CATEGORIES, threshold);
+            result.isValid = false;
+            result.errors.push(`Invalid category "${category}". ${suggestions.length > 0
+                ? `Did you mean: ${suggestions.slice(0, 3).join(', ')}?`
+                : 'Please use a valid category.'}`);
+            if (suggestions.length > 0) {
+                result.suggestions.push(...suggestions.slice(0, 5)); // Top 5 suggestions
+            }
+        }
+    }
+    // Convert set back to array and remove duplicates from suggestions
+    result.validatedCategories = Array.from(processedCategories);
+    result.suggestions = Array.from(new Set(result.suggestions));
+    return result;
+}
+/**
+ * Auto-converts and validates categories field for companies (Issues #220/#218)
+ * Main processing function that integrates validation with transformation
+ */
+export function processCategories(resourceType, fieldName, value) {
+    const result = {
+        processedValue: value,
+        warnings: [],
+        errors: [],
+    };
+    // Only process categories for companies
+    if (resourceType !== UniversalResourceType.COMPANIES ||
+        fieldName.toLowerCase() !== 'categories') {
+        return result;
+    }
+    // Validate categories
+    if (typeof value !== 'string' && !Array.isArray(value)) {
+        result.errors.push(`Categories must be a string or array of strings, got: ${typeof value}`);
+        return result;
+    }
+    const validation = validateCategories(value);
+    if (validation.autoConverted) {
+        result.warnings.push(`Categories field auto-converted from string to array format: ["${value}"]`);
+    }
+    if (!validation.isValid) {
+        result.errors.push(...validation.errors);
+        // Always show valid options when there are errors
+        result.warnings.push(`Valid category options (first 10): ${VALID_COMPANY_CATEGORIES.slice(0, 10).join(', ')}`);
+    }
+    else {
+        result.processedValue = validation.validatedCategories;
+        if (validation.autoConverted) {
+            result.warnings.push(`Category value successfully validated and converted to: ${JSON.stringify(validation.validatedCategories)}`);
+        }
+    }
+    return result;
+}
+/**
+ * Get list of valid categories for companies
+ * Used for error messages and documentation
+ */
+export function getValidCategories() {
+    return [...VALID_COMPANY_CATEGORIES];
+}
+//# sourceMappingURL=category-validator.js.map

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

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

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

@@ -0,0 +1,15 @@
+/**
+ * Field collision detection and resolution
+ * Extracted from field-mapper.ts during Issue #529 modular refactoring
+ */
+import { UniversalResourceType } from '../types.js';
+/**
+ * Detects field name collisions where multiple input fields map to the same output field
+ * Essential for preventing data overwrites and API conflicts
+ */
+export declare function detectFieldCollisions(resourceType: UniversalResourceType, recordData: Record<string, unknown>, availableAttributes?: string[]): Promise<{
+    hasCollisions: boolean;
+    errors: string[];
+    collisions: Record<string, string[]>;
+}>;
+//# sourceMappingURL=collision-detector.d.ts.map