attio-mcp 0.1.1 → 1.0.0

package/dist/handlers/tool-configs/universal/core/value-extractors.js

@@ -0,0 +1,212 @@
+/**
+ * Type-Safe Value Extraction Utilities
+ *
+ * Replaces the generic coercion functions with properly typed interfaces
+ * and type guards to improve type safety and reduce any usage.
+ */
+import { UniversalResourceType } from '../types.js';
+/**
+ * Type guard to check if a value is an AttioFieldValue
+ */
+export const isAttioFieldValue = (value) => {
+    if (!value || typeof value !== 'object')
+        return false;
+    const obj = value;
+    return (typeof obj.value === 'string' ||
+        typeof obj.full_name === 'string' ||
+        typeof obj.formatted === 'string' ||
+        typeof obj.display_value === 'string');
+};
+/**
+ * Type guard to check if a value is an array of AttioFieldValue objects
+ */
+export const isAttioFieldValueArray = (value) => {
+    return Array.isArray(value) && value.every(isAttioFieldValue);
+};
+/**
+ * Ordered keys to attempt when extracting display values
+ */
+const DISPLAY_VALUE_KEYS = [
+    'display_value',
+    'formatted',
+    'full_name',
+    'value',
+];
+/**
+ * Type-safe extraction of display value from an AttioFieldValue object
+ */
+export const extractFromAttioFieldValue = (fieldValue) => {
+    for (const key of DISPLAY_VALUE_KEYS) {
+        const value = fieldValue[key];
+        if (typeof value === 'string' && value.trim().length > 0) {
+            return value.trim();
+        }
+    }
+    return undefined;
+};
+/**
+ * Type-safe extraction of display value from an array of AttioFieldValue objects
+ */
+export const extractFromAttioFieldValueArray = (fieldValueArray) => {
+    if (fieldValueArray.length === 0)
+        return undefined;
+    // Try to extract from the first element
+    const firstValue = extractFromAttioFieldValue(fieldValueArray[0]);
+    if (firstValue)
+        return firstValue;
+    // If first element doesn't yield a value, try others
+    for (let i = 1; i < fieldValueArray.length; i++) {
+        const value = extractFromAttioFieldValue(fieldValueArray[i]);
+        if (value)
+            return value;
+    }
+    return undefined;
+};
+/**
+ * Type-safe extraction that handles various value types
+ */
+export const extractDisplayValue = (value) => {
+    // Handle null/undefined
+    if (value == null)
+        return undefined;
+    // Handle direct string values
+    if (typeof value === 'string') {
+        return value.trim().length > 0 ? value.trim() : undefined;
+    }
+    // Handle arrays of AttioFieldValue objects
+    if (isAttioFieldValueArray(value)) {
+        return extractFromAttioFieldValueArray(value);
+    }
+    // Handle single AttioFieldValue objects
+    if (isAttioFieldValue(value)) {
+        return extractFromAttioFieldValue(value);
+    }
+    // Handle arrays that might contain strings or objects
+    if (Array.isArray(value) && value.length > 0) {
+        const first = value[0];
+        if (typeof first === 'string') {
+            return first.trim().length > 0 ? first.trim() : undefined;
+        }
+        // Try to extract from first object-like element
+        return extractDisplayValue(first);
+    }
+    // Handle objects with a value property
+    if (typeof value === 'object') {
+        const obj = value;
+        if ('value' in obj) {
+            return extractDisplayValue(obj.value);
+        }
+    }
+    return undefined;
+};
+const RESOURCE_FIELD_PRIORITIES = {
+    [UniversalResourceType.PEOPLE]: {
+        primaryFields: ['name', 'full_name', 'display_name'],
+        secondaryFields: ['first_name', 'last_name', 'email_address'],
+        fallbackFields: ['title', 'company_name'],
+    },
+    [UniversalResourceType.COMPANIES]: {
+        primaryFields: ['name', 'company_name', 'display_name'],
+        secondaryFields: ['legal_name', 'trading_name'],
+        fallbackFields: ['domain', 'website'],
+    },
+    [UniversalResourceType.DEALS]: {
+        primaryFields: ['name', 'deal_name', 'title'],
+        secondaryFields: ['description'],
+        fallbackFields: ['stage', 'amount'],
+    },
+    [UniversalResourceType.TASKS]: {
+        primaryFields: ['title', 'name', 'content'],
+        secondaryFields: ['description', 'summary'],
+        fallbackFields: ['assignee', 'status'],
+    },
+    [UniversalResourceType.NOTES]: {
+        primaryFields: ['title', 'content', 'name'],
+        secondaryFields: ['summary', 'description'],
+        fallbackFields: ['author', 'created_at'],
+    },
+    [UniversalResourceType.LISTS]: {
+        primaryFields: ['name', 'title', 'list_name'],
+        secondaryFields: ['description'],
+        fallbackFields: ['type', 'status'],
+    },
+    [UniversalResourceType.RECORDS]: {
+        primaryFields: ['name', 'title'],
+        secondaryFields: ['description', 'content'],
+        fallbackFields: ['id', 'created_at'],
+    },
+};
+/**
+ * Extract display name with resource-type-specific field prioritization
+ */
+export const extractDisplayName = (values, resourceType) => {
+    if (!values || typeof values !== 'object')
+        return 'Unnamed';
+    const priority = resourceType
+        ? RESOURCE_FIELD_PRIORITIES[resourceType]
+        : RESOURCE_FIELD_PRIORITIES[UniversalResourceType.RECORDS];
+    // Try primary fields first
+    for (const fieldName of priority.primaryFields) {
+        const value = values[fieldName];
+        const extracted = extractDisplayValue(value);
+        if (extracted)
+            return extracted;
+    }
+    // Try secondary fields
+    for (const fieldName of priority.secondaryFields) {
+        const value = values[fieldName];
+        const extracted = extractDisplayValue(value);
+        if (extracted)
+            return extracted;
+    }
+    // Try fallback fields
+    for (const fieldName of priority.fallbackFields) {
+        const value = values[fieldName];
+        const extracted = extractDisplayValue(value);
+        if (extracted)
+            return extracted;
+    }
+    // Final fallback - try any string-like field
+    for (const [key, value] of Object.entries(values)) {
+        if (key.toLowerCase().includes('name') ||
+            key.toLowerCase().includes('title')) {
+            const extracted = extractDisplayValue(value);
+            if (extracted)
+                return extracted;
+        }
+    }
+    return 'Unnamed';
+};
+/**
+ * Extract multiple display values (useful for validation metadata)
+ */
+export const extractMultipleDisplayValues = (values, fieldNames) => {
+    const result = {};
+    if (!values || typeof values !== 'object')
+        return result;
+    for (const fieldName of fieldNames) {
+        const value = values[fieldName];
+        const extracted = extractDisplayValue(value);
+        if (extracted) {
+            result[fieldName] = extracted;
+        }
+    }
+    return result;
+};
+/**
+ * Legacy compatibility function
+ * @deprecated Use extractDisplayValue instead
+ */
+export const coerceScalar = (value) => {
+    return extractDisplayValue(value);
+};
+/**
+ * Legacy compatibility function
+ * @deprecated Use extractFromAttioFieldValueArray instead
+ */
+export const coerceArrayValue = (value) => {
+    if (!Array.isArray(value))
+        return undefined;
+    return extractDisplayValue(value);
+};
+//# sourceMappingURL=value-extractors.js.map

package/dist/handlers/tool-configs/universal/core/value-extractors.js.map

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

package/dist/handlers/tool-configs/universal/errors/validation-errors.d.ts

@@ -0,0 +1,44 @@
+export declare enum ErrorType {
+    USER_ERROR = "USER_ERROR",
+    SYSTEM_ERROR = "SYSTEM_ERROR",
+    API_ERROR = "API_ERROR"
+}
+export declare enum HttpStatusCode {
+    BAD_REQUEST = 400,
+    UNAUTHORIZED = 401,
+    FORBIDDEN = 403,
+    NOT_FOUND = 404,
+    CONFLICT = 409,
+    UNPROCESSABLE_ENTITY = 422,
+    INTERNAL_SERVER_ERROR = 500,
+    BAD_GATEWAY = 502,
+    SERVICE_UNAVAILABLE = 503
+}
+import { BaseWrappedError } from '../../../../errors/BaseWrappedError.js';
+export declare class UniversalValidationError extends BaseWrappedError {
+    readonly errorType: ErrorType;
+    readonly suggestion?: string;
+    readonly example?: string;
+    readonly field?: string;
+    readonly httpStatusCode: HttpStatusCode;
+    constructor(message: string, errorType?: ErrorType, options?: {
+        suggestion?: string;
+        example?: string;
+        field?: string;
+        cause?: Error;
+        httpStatusCode?: HttpStatusCode;
+    });
+    private getDefaultHttpStatus;
+    toErrorResponse(): {
+        error: {
+            type: ErrorType;
+            message: string;
+            field: string | undefined;
+            suggestion: string | undefined;
+            example: string | undefined;
+            httpStatusCode: HttpStatusCode;
+            timestamp: string;
+        };
+    };
+}
+//# sourceMappingURL=validation-errors.d.ts.map

package/dist/handlers/tool-configs/universal/errors/validation-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-errors.d.ts","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/errors/validation-errors.ts"],"names":[],"mappings":"AAAA,oBAAY,SAAS;IACnB,UAAU,eAAe;IACzB,YAAY,iBAAiB;IAC7B,SAAS,cAAc;CACxB;AAED,oBAAY,cAAc;IACxB,WAAW,MAAM;IACjB,YAAY,MAAM;IAClB,SAAS,MAAM;IACf,SAAS,MAAM;IACf,QAAQ,MAAM;IACd,oBAAoB,MAAM;IAC1B,qBAAqB,MAAM;IAC3B,WAAW,MAAM;IACjB,mBAAmB,MAAM;CAC1B;AAED,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAE1E,qBAAa,wBAAyB,SAAQ,gBAAgB;IAC5D,SAAgB,SAAS,EAAE,SAAS,CAAC;IACrC,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjC,SAAgB,KAAK,CAAC,EAAE,MAAM,CAAC;IAC/B,SAAgB,cAAc,EAAE,cAAc,CAAC;gBAG7C,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,SAAgC,EAC3C,OAAO,GAAE;QACP,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,KAAK,CAAC;QACd,cAAc,CAAC,EAAE,cAAc,CAAC;KAC5B;IAeR,OAAO,CAAC,oBAAoB;IAa5B,eAAe;;;;;;;;;;;CAahB"}

package/dist/handlers/tool-configs/universal/errors/validation-errors.js

@@ -0,0 +1,61 @@
+export var ErrorType;
+(function (ErrorType) {
+    ErrorType["USER_ERROR"] = "USER_ERROR";
+    ErrorType["SYSTEM_ERROR"] = "SYSTEM_ERROR";
+    ErrorType["API_ERROR"] = "API_ERROR";
+})(ErrorType || (ErrorType = {}));
+export var HttpStatusCode;
+(function (HttpStatusCode) {
+    HttpStatusCode[HttpStatusCode["BAD_REQUEST"] = 400] = "BAD_REQUEST";
+    HttpStatusCode[HttpStatusCode["UNAUTHORIZED"] = 401] = "UNAUTHORIZED";
+    HttpStatusCode[HttpStatusCode["FORBIDDEN"] = 403] = "FORBIDDEN";
+    HttpStatusCode[HttpStatusCode["NOT_FOUND"] = 404] = "NOT_FOUND";
+    HttpStatusCode[HttpStatusCode["CONFLICT"] = 409] = "CONFLICT";
+    HttpStatusCode[HttpStatusCode["UNPROCESSABLE_ENTITY"] = 422] = "UNPROCESSABLE_ENTITY";
+    HttpStatusCode[HttpStatusCode["INTERNAL_SERVER_ERROR"] = 500] = "INTERNAL_SERVER_ERROR";
+    HttpStatusCode[HttpStatusCode["BAD_GATEWAY"] = 502] = "BAD_GATEWAY";
+    HttpStatusCode[HttpStatusCode["SERVICE_UNAVAILABLE"] = 503] = "SERVICE_UNAVAILABLE";
+})(HttpStatusCode || (HttpStatusCode = {}));
+import { BaseWrappedError } from '../../../../errors/BaseWrappedError.js';
+export class UniversalValidationError extends BaseWrappedError {
+    errorType;
+    suggestion;
+    example;
+    field;
+    httpStatusCode;
+    constructor(message, errorType = ErrorType.USER_ERROR, options = {}) {
+        super('UniversalValidationError', message, options.cause ? { cause: options.cause } : undefined);
+        this.errorType = errorType;
+        this.suggestion = options.suggestion;
+        this.example = options.example;
+        this.field = options.field;
+        this.httpStatusCode =
+            options.httpStatusCode ?? this.getDefaultHttpStatus(errorType);
+    }
+    getDefaultHttpStatus(errorType) {
+        switch (errorType) {
+            case ErrorType.USER_ERROR:
+                return HttpStatusCode.BAD_REQUEST;
+            case ErrorType.API_ERROR:
+                return HttpStatusCode.BAD_GATEWAY;
+            case ErrorType.SYSTEM_ERROR:
+                return HttpStatusCode.INTERNAL_SERVER_ERROR;
+            default:
+                return HttpStatusCode.INTERNAL_SERVER_ERROR;
+        }
+    }
+    toErrorResponse() {
+        return {
+            error: {
+                type: this.errorType,
+                message: this.message,
+                field: this.field,
+                suggestion: this.suggestion,
+                example: this.example,
+                httpStatusCode: this.httpStatusCode,
+                timestamp: new Date().toISOString(),
+            },
+        };
+    }
+}
+//# sourceMappingURL=validation-errors.js.map

package/dist/handlers/tool-configs/universal/errors/validation-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-errors.js","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/errors/validation-errors.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,SAIX;AAJD,WAAY,SAAS;IACnB,sCAAyB,CAAA;IACzB,0CAA6B,CAAA;IAC7B,oCAAuB,CAAA;AACzB,CAAC,EAJW,SAAS,KAAT,SAAS,QAIpB;AAED,MAAM,CAAN,IAAY,cAUX;AAVD,WAAY,cAAc;IACxB,mEAAiB,CAAA;IACjB,qEAAkB,CAAA;IAClB,+DAAe,CAAA;IACf,+DAAe,CAAA;IACf,6DAAc,CAAA;IACd,qFAA0B,CAAA;IAC1B,uFAA2B,CAAA;IAC3B,mEAAiB,CAAA;IACjB,mFAAyB,CAAA;AAC3B,CAAC,EAVW,cAAc,KAAd,cAAc,QAUzB;AAED,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAE1E,MAAM,OAAO,wBAAyB,SAAQ,gBAAgB;IAC5C,SAAS,CAAY;IACrB,UAAU,CAAU;IACpB,OAAO,CAAU;IACjB,KAAK,CAAU;IACf,cAAc,CAAiB;IAE/C,YACE,OAAe,EACf,YAAuB,SAAS,CAAC,UAAU,EAC3C,UAMI,EAAE;QAEN,KAAK,CACH,0BAA0B,EAC1B,OAAO,EACP,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CACrD,CAAC;QACF,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,cAAc;YACjB,OAAO,CAAC,cAAc,IAAI,IAAI,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACnE,CAAC;IAEO,oBAAoB,CAAC,SAAoB;QAC/C,QAAQ,SAAS,EAAE,CAAC;YAClB,KAAK,SAAS,CAAC,UAAU;gBACvB,OAAO,cAAc,CAAC,WAAW,CAAC;YACpC,KAAK,SAAS,CAAC,SAAS;gBACtB,OAAO,cAAc,CAAC,WAAW,CAAC;YACpC,KAAK,SAAS,CAAC,YAAY;gBACzB,OAAO,cAAc,CAAC,qBAAqB,CAAC;YAC9C;gBACE,OAAO,cAAc,CAAC,qBAAqB,CAAC;QAChD,CAAC;IACH,CAAC;IAED,eAAe;QACb,OAAO;YACL,KAAK,EAAE;gBACL,IAAI,EAAE,IAAI,CAAC,SAAS;gBACpB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,18 @@
+/**
+ * Field mapper configuration and settings
+ * Extracted from ../config.ts during Issue #529 modular refactoring
+ */
+import { UniversalResourceType } from '../types.js';
+/**
+ * Mapping configuration defaults for each resource type
+ * Controls strict mode behavior for field validation
+ */
+export declare const MappingDefaults: Record<UniversalResourceType, {
+    strictMode: boolean;
+}>;
+/**
+ * Determines if strict mode validation should be applied for a resource type
+ * In strict mode, field validation errors become blocking errors instead of warnings
+ */
+export declare const strictModeFor: (rt: UniversalResourceType) => boolean;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/field-mapper/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAClC,qBAAqB,EACrB;IAAE,UAAU,EAAE,OAAO,CAAA;CAAE,CASxB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,IAAI,qBAAqB,KAAG,OAChB,CAAC"}

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

@@ -0,0 +1,24 @@
+/**
+ * Field mapper configuration and settings
+ * Extracted from ../config.ts during Issue #529 modular refactoring
+ */
+import { UniversalResourceType } from '../types.js';
+/**
+ * Mapping configuration defaults for each resource type
+ * Controls strict mode behavior for field validation
+ */
+export const MappingDefaults = {
+    [UniversalResourceType.COMPANIES]: { strictMode: false },
+    [UniversalResourceType.PEOPLE]: { strictMode: false },
+    [UniversalResourceType.DEALS]: { strictMode: true },
+    [UniversalResourceType.TASKS]: { strictMode: false },
+    [UniversalResourceType.RECORDS]: { strictMode: true },
+    [UniversalResourceType.NOTES]: { strictMode: true },
+    [UniversalResourceType.LISTS]: { strictMode: false },
+};
+/**
+ * Determines if strict mode validation should be applied for a resource type
+ * In strict mode, field validation errors become blocking errors instead of warnings
+ */
+export const strictModeFor = (rt) => MappingDefaults[rt]?.strictMode ?? false;
+//# sourceMappingURL=config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../../src/handlers/tool-configs/universal/field-mapper/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAGxB;IACF,CAAC,qBAAqB,CAAC,SAAS,CAAC,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE;IACxD,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE;IACrD,CAAC,qBAAqB,CAAC,KAAK,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE;IACnD,CAAC,qBAAqB,CAAC,KAAK,CAAC,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE;IACpD,CAAC,qBAAqB,CAAC,OAAO,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE;IACrD,CAAC,qBAAqB,CAAC,KAAK,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE;IACnD,CAAC,qBAAqB,CAAC,KAAK,CAAC,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE;CACrD,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,EAAyB,EAAW,EAAE,CAClE,eAAe,CAAC,EAAE,CAAC,EAAE,UAAU,IAAI,KAAK,CAAC"}

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

@@ -0,0 +1,10 @@
+/**
+ * Company field mappings and validation rules
+ * Extracted from field-mapper.ts during Issue #529 modular refactoring
+ */
+import { FieldMapping } from '../types.js';
+/**
+ * Field mapping configuration for companies resource type
+ */
+export declare const COMPANIES_FIELD_MAPPING: FieldMapping;
+//# sourceMappingURL=companies.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"companies.d.ts","sourceRoot":"","sources":["../../../../../../src/handlers/tool-configs/universal/field-mapper/constants/companies.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAkC3C;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,YAqDrC,CAAC"}

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

@@ -0,0 +1,79 @@
+/**
+ * Company field mappings and validation rules
+ * Extracted from field-mapper.ts during Issue #529 modular refactoring
+ */
+import { createDisplayNameConstants, createPluralMappingConstants, validateFieldMappingConstants, } from '../utils/field-mapping-constants.js';
+// Display name constants for better maintainability (Issue #720)
+const DISPLAY_NAMES = createDisplayNameConstants({
+    COMPANY_NAME: 'company name',
+    COMPANY_DOMAIN: 'company domain',
+    COMPANY_TYPE: 'company type',
+    FOUNDED_DATE: 'founded date',
+});
+// Plural to singular mapping pattern (Issue #720)
+const PLURAL_MAPPINGS = createPluralMappingConstants({
+    websites: 'domains',
+    urls: 'domains',
+    domains: 'domains', // Keep for consistency
+});
+// Validate constants for consistency
+const validation = validateFieldMappingConstants(DISPLAY_NAMES, PLURAL_MAPPINGS);
+if (!validation.valid) {
+    console.warn('Companies field mapping constants validation issues:', validation.issues);
+}
+/**
+ * Field mapping configuration for companies resource type
+ */
+export const COMPANIES_FIELD_MAPPING = {
+    fieldMappings: {
+        // Display names from discover-attributes
+        [DISPLAY_NAMES.COMPANY_NAME]: 'name',
+        [DISPLAY_NAMES.COMPANY_DOMAIN]: 'domains',
+        [DISPLAY_NAMES.COMPANY_TYPE]: 'type',
+        [DISPLAY_NAMES.FOUNDED_DATE]: 'founded',
+        // Common incorrect field names -> correct ones
+        website: 'domains',
+        url: 'domains',
+        company_name: 'name',
+        company_domain: 'domains',
+        primary_domain: 'domains',
+        ...PLURAL_MAPPINGS, // Use consolidated plural mappings
+        // Note: Companies have a 'description' field - don't map to 'notes'
+        note: 'description',
+        size: 'estimated_arr',
+        revenue: 'estimated_arr',
+        // Remove harmful mappings that break valid fields
+        // typpe: 'type', // Don't map - 'typpe' is a valid field in Attio
+        company_type: 'type',
+        founded_date: 'founded',
+        founding_date: 'founded',
+        year_founded: 'founded',
+    },
+    validFields: [
+        'name',
+        'domains',
+        'type',
+        'typpe',
+        'industry',
+        'categories',
+        'description',
+        'founded',
+        'estimated_arr',
+        'employee_count',
+        'location',
+        'notes',
+        'primary_domain',
+        'twitter',
+        'linkedin',
+        'facebook',
+    ],
+    commonMistakes: {
+        domain: 'Use "domains" (plural) as an array, e.g., domains: ["example.com"]',
+        website: 'Use "domains" field with an array of domain names',
+        notes: 'Notes are separate objects linked to companies, not company attributes. Use "description" field for company descriptions',
+        revenue: 'Use "estimated_arr" for revenue/ARR data',
+    },
+    requiredFields: ['name'],
+    uniqueFields: ['domains'],
+};
+//# sourceMappingURL=companies.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"companies.js","sourceRoot":"","sources":["../../../../../../src/handlers/tool-configs/universal/field-mapper/constants/companies.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,qCAAqC,CAAC;AAE7C,iEAAiE;AACjE,MAAM,aAAa,GAAG,0BAA0B,CAAC;IAC/C,YAAY,EAAE,cAAc;IAC5B,cAAc,EAAE,gBAAgB;IAChC,YAAY,EAAE,cAAc;IAC5B,YAAY,EAAE,cAAc;CAC7B,CAAC,CAAC;AAEH,kDAAkD;AAClD,MAAM,eAAe,GAAG,4BAA4B,CAAC;IACnD,QAAQ,EAAE,SAAS;IACnB,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,SAAS,EAAE,uBAAuB;CAC5C,CAAC,CAAC;AAEH,qCAAqC;AACrC,MAAM,UAAU,GAAG,6BAA6B,CAC9C,aAAa,EACb,eAAe,CAChB,CAAC;AACF,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IACtB,OAAO,CAAC,IAAI,CACV,sDAAsD,EACtD,UAAU,CAAC,MAAM,CAClB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAiB;IACnD,aAAa,EAAE;QACb,yCAAyC;QACzC,CAAC,aAAa,CAAC,YAAY,CAAC,EAAE,MAAM;QACpC,CAAC,aAAa,CAAC,cAAc,CAAC,EAAE,SAAS;QACzC,CAAC,aAAa,CAAC,YAAY,CAAC,EAAE,MAAM;QACpC,CAAC,aAAa,CAAC,YAAY,CAAC,EAAE,SAAS;QACvC,+CAA+C;QAC/C,OAAO,EAAE,SAAS;QAClB,GAAG,EAAE,SAAS;QACd,YAAY,EAAE,MAAM;QACpB,cAAc,EAAE,SAAS;QACzB,cAAc,EAAE,SAAS;QACzB,GAAG,eAAe,EAAE,mCAAmC;QACvD,oEAAoE;QACpE,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,eAAe;QACxB,kDAAkD;QAClD,kEAAkE;QAClE,YAAY,EAAE,MAAM;QACpB,YAAY,EAAE,SAAS;QACvB,aAAa,EAAE,SAAS;QACxB,YAAY,EAAE,SAAS;KACxB;IACD,WAAW,EAAE;QACX,MAAM;QACN,SAAS;QACT,MAAM;QACN,OAAO;QACP,UAAU;QACV,YAAY;QACZ,aAAa;QACb,SAAS;QACT,eAAe;QACf,gBAAgB;QAChB,UAAU;QACV,OAAO;QACP,gBAAgB;QAChB,SAAS;QACT,UAAU;QACV,UAAU;KACX;IACD,cAAc,EAAE;QACd,MAAM,EACJ,oEAAoE;QACtE,OAAO,EAAE,mDAAmD;QAC5D,KAAK,EACH,0HAA0H;QAC5H,OAAO,EAAE,0CAA0C;KACpD;IACD,cAAc,EAAE,CAAC,MAAM,CAAC;IACxB,YAAY,EAAE,CAAC,SAAS,CAAC;CAC1B,CAAC"}

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

@@ -0,0 +1,10 @@
+/**
+ * Deals field mappings and validation rules
+ * Extracted from field-mapper.ts during Issue #529 modular refactoring
+ */
+import { FieldMapping } from '../types.js';
+/**
+ * Field mapping configuration for deals resource type
+ */
+export declare const DEALS_FIELD_MAPPING: FieldMapping;
+//# sourceMappingURL=deals.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deals.d.ts","sourceRoot":"","sources":["../../../../../../src/handlers/tool-configs/universal/field-mapper/constants/deals.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAmC3C;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,YA+FxB,CAAC"}

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

@@ -0,0 +1,115 @@
+/**
+ * Deals field mappings and validation rules
+ * Extracted from field-mapper.ts during Issue #529 modular refactoring
+ */
+import { createDisplayNameConstants, createPluralMappingConstants, validateFieldMappingConstants, } from '../utils/field-mapping-constants.js';
+// Display name constants for better maintainability (Issue #720)
+const DISPLAY_NAMES = createDisplayNameConstants({
+    DEAL_NAME: 'deal name',
+    DEAL_STAGE: 'deal stage',
+    DEAL_VALUE: 'deal value',
+    ASSOCIATED_COMPANY: 'associated company',
+});
+// Plural to singular mapping pattern (Issue #720)
+const PLURAL_MAPPINGS = createPluralMappingConstants({
+    companies: 'associated_company',
+    organizations: 'associated_company',
+    clients: 'associated_company',
+    accounts: 'associated_company',
+    customers: 'associated_company',
+    contacts: 'associated_people',
+    owners: 'owner',
+});
+// Validate constants for consistency
+const validation = validateFieldMappingConstants(DISPLAY_NAMES, PLURAL_MAPPINGS);
+if (!validation.valid) {
+    console.warn('Field mapping constants validation issues:', validation.issues);
+}
+/**
+ * Field mapping configuration for deals resource type
+ */
+export const DEALS_FIELD_MAPPING = {
+    fieldMappings: {
+        // Display names from discover-attributes (Issue #687)
+        [DISPLAY_NAMES.DEAL_NAME]: 'name',
+        [DISPLAY_NAMES.DEAL_STAGE]: 'stage',
+        [DISPLAY_NAMES.DEAL_VALUE]: 'value',
+        [DISPLAY_NAMES.ASSOCIATED_COMPANY]: 'associated_company',
+        // Value variations
+        amount: 'value',
+        deal_amount: 'value',
+        price: 'value',
+        revenue: 'value',
+        // Name variations
+        title: 'name',
+        deal_name: 'name',
+        deal_title: 'name',
+        opportunity_name: 'name',
+        // Stage variations
+        status: 'stage',
+        deal_stage: 'stage',
+        pipeline_stage: 'stage',
+        deal_status: 'stage',
+        // Company variations (Issue #720: Enhanced field name validation)
+        company: 'associated_company',
+        ...PLURAL_MAPPINGS, // Use consolidated plural mappings
+        company_id: 'associated_company',
+        primary_company: 'associated_company',
+        account: 'associated_company',
+        customer: 'associated_company',
+        client: 'associated_company',
+        organization: 'associated_company',
+        // People variations
+        contact: 'associated_people',
+        person: 'associated_people', // Singular form
+        primary_contact: 'associated_people',
+        people: 'associated_people',
+        // Invalid fields that users often try
+        description: null, // Not available for deals
+        notes: null, // Should be created separately
+        close_date: null, // Not a built-in field
+        expected_close_date: null,
+        probability: null,
+        source: null,
+        lead_source: null,
+        currency: null, // Handled automatically
+        tags: null,
+        labels: null,
+        type: null,
+        deal_type: null,
+    },
+    validFields: [
+        'name',
+        'stage',
+        'value',
+        'owner',
+        'associated_company',
+        'associated_people',
+    ],
+    commonMistakes: {
+        'deal name': 'Display name from discover-attributes. Maps to API field "name"',
+        'deal stage': 'Display name from discover-attributes. Maps to API field "stage"',
+        'deal value': 'Display name from discover-attributes. Maps to API field "value"',
+        'associated company': 'Display name from discover-attributes. Maps to API field "associated_company"',
+        company_id: 'Use "associated_company" to link deals to companies',
+        company: 'Use "associated_company" with the company record ID',
+        companies: 'Use "associated_company" to link deals to companies (maps plural to singular form)',
+        primary_company: 'Use "associated_company" instead of "primary_company"',
+        client: 'Use "associated_company" to link clients to deals',
+        clients: 'Use "associated_company" to link clients to deals (maps plural to singular form)',
+        organization: 'Use "associated_company" to link organizations to deals',
+        organizations: 'Use "associated_company" to link organizations to deals (maps plural to singular form)',
+        amount: 'Use "value" for deal amounts (numeric only, no currency symbols)',
+        status: 'Use "stage" for deal pipeline stages',
+        description: 'Deals do not have a description field. Create notes separately after the deal',
+        close_date: 'Close date is not a built-in field. Use custom fields if needed',
+        probability: 'Probability is not a built-in field. Track in stage names or custom fields',
+        currency: 'Currency is set automatically based on workspace settings',
+        contact: 'Use "associated_people" to link contacts to deals',
+        person: 'Use "associated_people" to link people to deals (maps singular to plural form)',
+        owners: 'Use "owner" to assign deal ownership (maps plural to singular form)',
+    },
+    requiredFields: ['name', 'stage'],
+    uniqueFields: [],
+};
+//# sourceMappingURL=deals.js.map

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

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

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

@@ -0,0 +1,20 @@
+/**
+ * Field mapping constants - centralized exports
+ * Extracted from field-mapper.ts during Issue #529 modular refactoring
+ */
+import { UniversalResourceType } from '../types.js';
+import { FieldMapping } from '../types.js';
+import { COMPANIES_FIELD_MAPPING } from './companies.js';
+import { PEOPLE_FIELD_MAPPING } from './people.js';
+import { DEALS_FIELD_MAPPING } from './deals.js';
+import { TASKS_FIELD_MAPPING } from './tasks.js';
+import { RECORDS_FIELD_MAPPING } from './records.js';
+import { NOTES_FIELD_MAPPING } from './notes.js';
+import { LISTS_FIELD_MAPPING } from './lists.js';
+export { COMPANIES_FIELD_MAPPING, PEOPLE_FIELD_MAPPING, DEALS_FIELD_MAPPING, TASKS_FIELD_MAPPING, RECORDS_FIELD_MAPPING, NOTES_FIELD_MAPPING, LISTS_FIELD_MAPPING, };
+/**
+ * Unified resource type mappings - maintains backward compatibility
+ * with the original FIELD_MAPPINGS object structure
+ */
+export declare const RESOURCE_TYPE_MAPPINGS: Record<UniversalResourceType, FieldMapping>;
+//# sourceMappingURL=index.d.ts.map