attio-mcp 1.3.5 → 1.4.0

package/dist/services/update/FieldPersistenceHandler.js

@@ -0,0 +1,198 @@
+/**
+ * FieldPersistenceHandler - Post-update field verification
+ *
+ * Extracted from UniversalUpdateService to separate verification concerns.
+ * Handles field persistence checking with configurable strictness.
+ *
+ * **Verification Modes** (controlled by `ENABLE_FIELD_VERIFICATION` env var):
+ * - **Enabled** (default): Any value except `'false'` enables verification
+ * - **Disabled**: Set to `'false'` to skip verification entirely
+ *
+ * **Strictness Modes** (controlled by `STRICT_FIELD_VALIDATION` env var):
+ * - **Strict**: `'true'` - Logs all discrepancies (cosmetic + semantic)
+ * - **Standard** (default): `'false'` - Logs only semantic mismatches
+ *
+ * **Semantic vs Cosmetic Mismatches**:
+ * - Cosmetic: Format differences with same logical value (e.g., "Demo" vs {title: "Demo"})
+ * - Semantic: Actual data loss or corruption (e.g., "Demo" vs "Qualified", missing data)
+ *
+ * @see Issue #984 - Modularize UniversalUpdateService (831→220 lines)
+ * @see PR #1006 Phase 3.2 - Enhanced JSDoc for verification behavior
+ */
+import { UpdateValidation } from './UpdateValidation.js';
+import { debug, error as logError } from '../../utils/logger.js';
+import { UniversalValidationError, ErrorType, } from '../../handlers/tool-configs/universal/schemas.js';
+/**
+ * FieldPersistenceHandler - Post-update verification orchestration
+ *
+ * @example
+ * ```typescript
+ * // Standard mode (semantic mismatches only)
+ * const result = await FieldPersistenceHandler.verifyPersistence(
+ *   UniversalResourceType.COMPANIES,
+ *   'company-123',
+ *   { stage: 'Demo' }
+ * );
+ * // Cosmetic mismatch "Demo" vs {title: "Demo"} → not logged
+ * // Semantic mismatch "Demo" vs "Qualified" → logged
+ *
+ * // Strict mode (all mismatches)
+ * process.env.STRICT_FIELD_VALIDATION = 'true';
+ * // Both cosmetic and semantic mismatches logged
+ * ```
+ */
+export class FieldPersistenceHandler {
+    /**
+     * Verify that fields were persisted correctly after update
+     *
+     * Supports three modes:
+     * 1. Disabled: ENABLE_FIELD_VERIFICATION=false (skip completely)
+     * 2. Warn-only: Default, logs discrepancies as warnings
+     * 3. Strict: STRICT_FIELD_VALIDATION=true, throws on mismatch
+     *
+     * @param resourceType - Resource type being verified
+     * @param recordId - ID of the updated record
+     * @param expectedData - Expected field values after update
+     * @param actualRecord - Optional actual record values. If not provided, will be fetched from API
+     * @param options - Verification options
+     * @returns Verification result with verified status, warnings, and discrepancies
+     * @throws UniversalValidationError if strict mode enabled and verification fails
+     */
+    static async verifyPersistence(resourceType, recordId, expectedData, actualRecord, options = {}) {
+        const result = {
+            verified: true,
+            warnings: [],
+            discrepancies: [],
+            actualValues: {},
+        };
+        // Check if verification is disabled globally
+        if (options.skip || process.env.ENABLE_FIELD_VERIFICATION === 'false') {
+            result.warnings.push('Field persistence verification skipped (disabled via config)');
+            debug('FieldPersistenceHandler', 'Verification skipped', {
+                resourceType,
+                recordId,
+                reason: 'disabled',
+            });
+            return result;
+        }
+        // Fetch actualRecord if not provided
+        let recordData = actualRecord;
+        if (!recordData) {
+            try {
+                const record = await UpdateValidation.fetchRecordForVerification(resourceType, recordId);
+                if (!record) {
+                    result.warnings.push('Could not fetch record for verification: Record not found');
+                    debug('FieldPersistenceHandler', 'Record not found for verification', { resourceType, recordId });
+                    return result;
+                }
+                recordData = record.values || {};
+                debug('FieldPersistenceHandler', 'Fetched record for verification', {
+                    resourceType,
+                    recordId,
+                });
+            }
+            catch (err) {
+                const errorMessage = err instanceof Error ? err.message : String(err);
+                result.warnings.push(`Could not fetch record for verification: ${errorMessage}`);
+                debug('FieldPersistenceHandler', 'Failed to fetch record for verification', { resourceType, recordId, error: errorMessage });
+                return result;
+            }
+        }
+        result.actualValues = recordData || {};
+        try {
+            // Perform verification using existing UpdateValidation service
+            const verification = await UpdateValidation.verifyFieldPersistence(resourceType, recordId, expectedData);
+            result.verified = verification.verified;
+            result.warnings.push(...verification.warnings);
+            if (!verification.verified) {
+                const isStrictMode = options.strict !== undefined
+                    ? options.strict
+                    : process.env.STRICT_FIELD_VALIDATION === 'true';
+                const includeCosmetic = options.includeCosmetic || isStrictMode;
+                // Filter discrepancies based on mode
+                if (includeCosmetic) {
+                    // Include all discrepancies (cosmetic + semantic)
+                    result.discrepancies.push(...verification.discrepancies);
+                }
+                else {
+                    // Filter out cosmetic mismatches (e.g., "Demo" vs {title: "Demo"})
+                    const semanticMismatches = verification.discrepancies.filter((d) => this.isSemanticMismatch(d));
+                    result.discrepancies.push(...semanticMismatches);
+                }
+                // Log discrepancies
+                if (result.discrepancies.length > 0) {
+                    result.warnings.push(...result.discrepancies.map((d) => `Field persistence issue: ${d}`));
+                    logError('FieldPersistenceHandler', `Field persistence warnings for ${resourceType} ${recordId}:`, result.warnings);
+                }
+                // Throw in strict mode if semantic mismatches exist
+                if (isStrictMode && result.discrepancies.length > 0) {
+                    logError('FieldPersistenceHandler', 'Field persistence verification failed (strict mode)', new Error('Verification failed'), {
+                        resourceType,
+                        recordId,
+                        discrepancies: result.discrepancies,
+                    });
+                    throw new UniversalValidationError(`Field persistence verification failed: ${result.discrepancies.join('; ')}`, ErrorType.API_ERROR, {
+                        field: 'field_verification',
+                        suggestion: 'Check that field values are correctly formatted and supported by the API',
+                    });
+                }
+            }
+            else {
+                debug('FieldPersistenceHandler', 'Verification passed', {
+                    resourceType,
+                    recordId,
+                    fieldCount: Object.keys(expectedData).length,
+                });
+            }
+        }
+        catch (error) {
+            // Catch verification errors (network, API errors, etc.)
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            result.warnings.push(`Field verification warning: ${errorMessage}`);
+            logError('FieldPersistenceHandler', 'Field persistence verification error', error);
+            // Re-throw validation errors (strict mode failures)
+            if (error instanceof UniversalValidationError) {
+                throw error;
+            }
+        }
+        return result;
+    }
+    /**
+     * Determine if a discrepancy is semantic (real) vs cosmetic (format-only)
+     *
+     * Cosmetic mismatches occur when the same logical value is represented differently:
+     * - String vs object: "Demo" vs {title: "Demo"}
+     * - Array wrapping: "value" vs ["value"]
+     * - Type coercion: "123" vs 123
+     *
+     * Semantic mismatches indicate actual data loss or corruption:
+     * - Different values: "Demo" vs "Qualified"
+     * - Missing data: {field: "value"} vs {}
+     *
+     * @param discrepancy - Discrepancy message from verification
+     * @returns true if semantic mismatch, false if cosmetic
+     */
+    static isSemanticMismatch(discrepancy) {
+        // Extract expected and actual from: Field "X" persistence mismatch: expected Y, got Z
+        const match = discrepancy.match(/expected (.+?), got (.+?)$/);
+        if (!match) {
+            // If we can't parse, assume semantic (log for safety)
+            return true;
+        }
+        const [, expectedStr, actualStr] = match;
+        try {
+            // Check for cosmetic mismatches
+            // Case 1: String value vs object with title property
+            const isCosmetic = (expectedStr.includes('"') &&
+                actualStr.includes(expectedStr.replace(/^"|"$/g, ''))) ||
+                (actualStr.includes('"') &&
+                    expectedStr.includes(actualStr.replace(/^"|"$/g, '')));
+            return !isCosmetic; // Return true for semantic, false for cosmetic
+        }
+        catch {
+            // On parse errors, assume semantic (safety)
+            return true;
+        }
+    }
+}
+//# sourceMappingURL=FieldPersistenceHandler.js.map

package/dist/services/update/FieldPersistenceHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldPersistenceHandler.js","sourceRoot":"","sources":["../../../src/services/update/FieldPersistenceHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,KAAK,EAAE,KAAK,IAAI,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EACL,wBAAwB,EACxB,SAAS,GACV,MAAM,8CAA8C,CAAC;AA4BtD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,uBAAuB;IAClC;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAC5B,YAAmC,EACnC,QAAgB,EAChB,YAAqC,EACrC,YAAsC,EACtC,UAA+B,EAAE;QAEjC,MAAM,MAAM,GAAuB;YACjC,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,EAAE;YACZ,aAAa,EAAE,EAAE;YACjB,YAAY,EAAE,EAAE;SACjB,CAAC;QAEF,6CAA6C;QAC7C,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,yBAAyB,KAAK,OAAO,EAAE,CAAC;YACtE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAClB,8DAA8D,CAC/D,CAAC;YACF,KAAK,CAAC,yBAAyB,EAAE,sBAAsB,EAAE;gBACvD,YAAY;gBACZ,QAAQ;gBACR,MAAM,EAAE,UAAU;aACnB,CAAC,CAAC;YACH,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,qCAAqC;QACrC,IAAI,UAAU,GAAG,YAAY,CAAC;QAC9B,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,0BAA0B,CAC9D,YAAY,EACZ,QAAQ,CACT,CAAC;gBACF,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,MAAM,CAAC,QAAQ,CAAC,IAAI,CAClB,2DAA2D,CAC5D,CAAC;oBACF,KAAK,CACH,yBAAyB,EACzB,mCAAmC,EACnC,EAAE,YAAY,EAAE,QAAQ,EAAE,CAC3B,CAAC;oBACF,OAAO,MAAM,CAAC;gBAChB,CAAC;gBACD,UAAU,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;gBACjC,KAAK,CAAC,yBAAyB,EAAE,iCAAiC,EAAE;oBAClE,YAAY;oBACZ,QAAQ;iBACT,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,YAAY,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACtE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAClB,4CAA4C,YAAY,EAAE,CAC3D,CAAC;gBACF,KAAK,CACH,yBAAyB,EACzB,yCAAyC,EACzC,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,CAChD,CAAC;gBACF,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QAED,MAAM,CAAC,YAAY,GAAG,UAAU,IAAI,EAAE,CAAC;QAEvC,IAAI,CAAC;YACH,+DAA+D;YAC/D,MAAM,YAAY,GAAG,MAAM,gBAAgB,CAAC,sBAAsB,CAChE,YAAY,EACZ,QAAQ,EACR,YAAY,CACb,CAAC;YAEF,MAAM,CAAC,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC;YACxC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;YAE/C,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;gBAC3B,MAAM,YAAY,GAChB,OAAO,CAAC,MAAM,KAAK,SAAS;oBAC1B,CAAC,CAAC,OAAO,CAAC,MAAM;oBAChB,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,KAAK,MAAM,CAAC;gBACrD,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,YAAY,CAAC;gBAEhE,qCAAqC;gBACrC,IAAI,eAAe,EAAE,CAAC;oBACpB,kDAAkD;oBAClD,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,aAAa,CAAC,CAAC;gBAC3D,CAAC;qBAAM,CAAC;oBACN,mEAAmE;oBACnE,MAAM,kBAAkB,GAAG,YAAY,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACjE,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAC3B,CAAC;oBACF,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC,CAAC;gBACnD,CAAC;gBAED,oBAAoB;gBACpB,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACpC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAClB,GAAG,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,4BAA4B,CAAC,EAAE,CAAC,CACpE,CAAC;oBAEF,QAAQ,CACN,yBAAyB,EACzB,kCAAkC,YAAY,IAAI,QAAQ,GAAG,EAC7D,MAAM,CAAC,QAAQ,CAChB,CAAC;gBACJ,CAAC;gBAED,oDAAoD;gBACpD,IAAI,YAAY,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACpD,QAAQ,CACN,yBAAyB,EACzB,qDAAqD,EACrD,IAAI,KAAK,CAAC,qBAAqB,CAAC,EAChC;wBACE,YAAY;wBACZ,QAAQ;wBACR,aAAa,EAAE,MAAM,CAAC,aAAa;qBACpC,CACF,CAAC;oBAEF,MAAM,IAAI,wBAAwB,CAChC,0CAA0C,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAC3E,SAAS,CAAC,SAAS,EACnB;wBACE,KAAK,EAAE,oBAAoB;wBAC3B,UAAU,EACR,0EAA0E;qBAC7E,CACF,CAAC;gBACJ,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,yBAAyB,EAAE,qBAAqB,EAAE;oBACtD,YAAY;oBACZ,QAAQ;oBACR,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM;iBAC7C,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,wDAAwD;YACxD,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAEzD,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,+BAA+B,YAAY,EAAE,CAAC,CAAC;YAEpE,QAAQ,CACN,yBAAyB,EACzB,sCAAsC,EACtC,KAAK,CACN,CAAC;YAEF,oDAAoD;YACpD,IAAI,KAAK,YAAY,wBAAwB,EAAE,CAAC;gBAC9C,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACI,MAAM,CAAC,kBAAkB,CAAC,WAAmB;QAClD,sFAAsF;QACtF,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC9D,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,sDAAsD;YACtD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,CAAC,EAAE,WAAW,EAAE,SAAS,CAAC,GAAG,KAAK,CAAC;QAEzC,IAAI,CAAC;YACH,gCAAgC;YAChC,qDAAqD;YACrD,MAAM,UAAU,GACd,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC;gBACxB,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;gBACxD,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC;oBACtB,WAAW,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;YAE3D,OAAO,CAAC,UAAU,CAAC,CAAC,+CAA+C;QACrE,CAAC;QAAC,MAAM,CAAC;YACP,4CAA4C;YAC5C,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;CACF"}

package/dist/services/update/FieldValidationHandler.d.ts

@@ -0,0 +1,77 @@
+/**
+ * FieldValidationHandler - Validation orchestration with display name resolution
+ *
+ * Consolidates validation logic and integrates display name resolution
+ * for create/update operations.
+ *
+ * @see Issue #984 - Extend display name resolution to create/update operations
+ */
+import { UniversalResourceType } from '../../handlers/tool-configs/universal/types.js';
+/**
+ * Result of field validation
+ */
+export interface ValidationResult {
+    /** Whether validation passed */
+    valid: boolean;
+    /** Validation errors (blocking) */
+    errors: string[];
+    /** Validation warnings (non-blocking) */
+    warnings: string[];
+    /** Field suggestions for user */
+    suggestions: string[];
+    /** Map of display name → API slug resolutions */
+    resolvedFields?: Map<string, string>;
+}
+/**
+ * FieldValidationHandler - Validation and display name resolution
+ */
+export declare class FieldValidationHandler {
+    /**
+     * Validate fields and optionally resolve display names to API slugs
+     *
+     * Integrates display name resolution (previously only in get_attribute_options)
+     * to work for create/update operations.
+     *
+     * @param resourceType - Resource type being validated
+     * @param values - Field values to validate
+     * @param objectSlug - Optional object slug for display name resolution
+     * @param enableDisplayNameResolution - Whether to attempt display name resolution (default: true)
+     * @returns Validation result with warnings, suggestions, and resolved field names
+     */
+    static validateAndResolve(resourceType: UniversalResourceType, values: Record<string, unknown>, objectSlug?: string, enableDisplayNameResolution?: boolean): Promise<ValidationResult>;
+    /**
+     * Apply deal-specific validation and defaults
+     *
+     * @param values - Deal values to validate
+     * @param skipApiValidation - Whether to skip API validation
+     * @returns Deal validation result with validated data, warnings, and suggestions
+     */
+    static validateDealDefaults(values: Record<string, unknown>, skipApiValidation?: boolean): Promise<{
+        dealData: Record<string, unknown>;
+        warnings: string[];
+        suggestions: string[];
+    }>;
+    /**
+     * Attempt to resolve display names to API slugs for unknown fields
+     *
+     * This extends display name resolution (previously only in get_attribute_options)
+     * to work for create/update operations, improving UX consistency.
+     *
+     * @param values - Field values (may contain display names like "Deal stage")
+     * @param objectSlug - Object slug for attribute lookup
+     * @param result - Validation result to populate with resolutions
+     */
+    private static resolveDisplayNames;
+    /**
+     * Attempt to resolve a display name to an API slug
+     *
+     * Uses the exported resolveAttributeDisplayName from shared-handlers.ts
+     * to support user-friendly field names like "Deal stage" instead of "stage"
+     *
+     * @param objectSlug - The object slug (e.g., "deals", "companies")
+     * @param fieldName - The field name to resolve (e.g., "Deal stage")
+     * @returns The resolved API slug if found, or null
+     */
+    private static attemptDisplayNameResolution;
+}
+//# sourceMappingURL=FieldValidationHandler.d.ts.map

package/dist/services/update/FieldValidationHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldValidationHandler.d.ts","sourceRoot":"","sources":["../../../src/services/update/FieldValidationHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AAKnF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,mCAAmC;IACnC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,iCAAiC;IACjC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,iDAAiD;IACjD,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,qBAAa,sBAAsB;IACjC;;;;;;;;;;;OAWG;WACU,kBAAkB,CAC7B,YAAY,EAAE,qBAAqB,EACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,CAAC,EAAE,MAAM,EACnB,2BAA2B,GAAE,OAAc,GAC1C,OAAO,CAAC,gBAAgB,CAAC;IA2C5B;;;;;;OAMG;WACU,oBAAoB,CAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,iBAAiB,GAAE,OAAe,GACjC,OAAO,CAAC;QACT,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,WAAW,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC;IAqCF;;;;;;;;;OASG;mBACkB,mBAAmB;IA2CxC;;;;;;;;;OASG;mBACkB,4BAA4B;CAoBlD"}

package/dist/services/update/FieldValidationHandler.js

@@ -0,0 +1,157 @@
+/**
+ * FieldValidationHandler - Validation orchestration with display name resolution
+ *
+ * Consolidates validation logic and integrates display name resolution
+ * for create/update operations.
+ *
+ * @see Issue #984 - Extend display name resolution to create/update operations
+ */
+import { validateFields } from '../../handlers/tool-configs/universal/field-mapper.js';
+import { ValidationService } from '../../services/ValidationService.js';
+import { debug, OperationType } from '../../utils/logger.js';
+/**
+ * FieldValidationHandler - Validation and display name resolution
+ */
+export class FieldValidationHandler {
+    /**
+     * Validate fields and optionally resolve display names to API slugs
+     *
+     * Integrates display name resolution (previously only in get_attribute_options)
+     * to work for create/update operations.
+     *
+     * @param resourceType - Resource type being validated
+     * @param values - Field values to validate
+     * @param objectSlug - Optional object slug for display name resolution
+     * @param enableDisplayNameResolution - Whether to attempt display name resolution (default: true)
+     * @returns Validation result with warnings, suggestions, and resolved field names
+     */
+    static async validateAndResolve(resourceType, values, objectSlug, enableDisplayNameResolution = true) {
+        const result = {
+            valid: true,
+            errors: [],
+            warnings: [],
+            suggestions: [],
+            resolvedFields: new Map(),
+        };
+        // Pre-validate fields with suggestions
+        const fieldValidation = validateFields(resourceType, values);
+        // Propagate validation results (PR #1006 Phase 3.1)
+        result.valid = fieldValidation.valid;
+        result.errors.push(...fieldValidation.errors);
+        if (fieldValidation.warnings.length > 0) {
+            result.warnings.push(...fieldValidation.warnings);
+            debug('FieldValidationHandler', 'Field validation warnings', {
+                resourceType,
+                warnings: fieldValidation.warnings.join('\n'),
+            });
+        }
+        if (fieldValidation.suggestions.length > 0) {
+            const truncated = ValidationService.truncateSuggestions(fieldValidation.suggestions);
+            result.suggestions.push(...truncated);
+            debug('FieldValidationHandler', 'Field suggestions', {
+                resourceType,
+                suggestions: truncated.join('\n'),
+            });
+        }
+        // NEW: Attempt display name resolution for unknown fields
+        if (enableDisplayNameResolution && objectSlug) {
+            await this.resolveDisplayNames(values, objectSlug, result);
+        }
+        return result;
+    }
+    /**
+     * Apply deal-specific validation and defaults
+     *
+     * @param values - Deal values to validate
+     * @param skipApiValidation - Whether to skip API validation
+     * @returns Deal validation result with validated data, warnings, and suggestions
+     */
+    static async validateDealDefaults(values, skipApiValidation = false) {
+        try {
+            const { applyDealDefaultsWithValidation } = await import('../../config/deal-defaults.js');
+            const dealValidation = await applyDealDefaultsWithValidation(values, skipApiValidation);
+            debug('FieldValidationHandler', 'Deal validation applied', {
+                warnings: dealValidation.warnings,
+                suggestions: dealValidation.suggestions,
+            });
+            return {
+                dealData: dealValidation.dealData,
+                warnings: dealValidation.warnings,
+                suggestions: dealValidation.suggestions,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            debug('FieldValidationHandler', 'Deal validation failed', {
+                error: errorMessage,
+            });
+            return {
+                dealData: values,
+                warnings: [`Deal validation warning: ${errorMessage}`],
+                suggestions: [],
+            };
+        }
+    }
+    /**
+     * Attempt to resolve display names to API slugs for unknown fields
+     *
+     * This extends display name resolution (previously only in get_attribute_options)
+     * to work for create/update operations, improving UX consistency.
+     *
+     * @param values - Field values (may contain display names like "Deal stage")
+     * @param objectSlug - Object slug for attribute lookup
+     * @param result - Validation result to populate with resolutions
+     */
+    static async resolveDisplayNames(values, objectSlug, result) {
+        // Import display name resolver (will be exported in Phase 4)
+        // For now, we'll use a simplified version until shared-handlers exports it
+        try {
+            const fieldNames = Object.keys(values);
+            for (const fieldName of fieldNames) {
+                // Only attempt resolution for fields with spaces or mixed case (likely display names)
+                const mightBeDisplayName = fieldName.includes(' ') || /[A-Z]/.test(fieldName);
+                if (!mightBeDisplayName) {
+                    continue;
+                }
+                // Attempt to resolve display name to API slug
+                // Uses the exported resolveAttributeDisplayName from shared-handlers.ts
+                const resolved = await this.attemptDisplayNameResolution(objectSlug, fieldName);
+                if (resolved && resolved !== fieldName) {
+                    result.resolvedFields.set(fieldName, resolved);
+                    debug('FieldValidationHandler', 'Resolved display name', {
+                        from: fieldName,
+                        to: resolved,
+                        objectSlug,
+                    });
+                }
+            }
+        }
+        catch (error) {
+            // Silent fallback - display name resolution is best-effort
+            debug('FieldValidationHandler', 'Display name resolution failed', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    /**
+     * Attempt to resolve a display name to an API slug
+     *
+     * Uses the exported resolveAttributeDisplayName from shared-handlers.ts
+     * to support user-friendly field names like "Deal stage" instead of "stage"
+     *
+     * @param objectSlug - The object slug (e.g., "deals", "companies")
+     * @param fieldName - The field name to resolve (e.g., "Deal stage")
+     * @returns The resolved API slug if found, or null
+     */
+    static async attemptDisplayNameResolution(objectSlug, fieldName) {
+        try {
+            const { resolveAttributeDisplayName } = await import('../../handlers/tool-configs/universal/shared-handlers.js');
+            return await resolveAttributeDisplayName(objectSlug, fieldName);
+        }
+        catch (err) {
+            debug('FieldValidationHandler', 'Display name resolution failed', { objectSlug, fieldName, error: err }, 'attemptDisplayNameResolution', OperationType.DATA_PROCESSING);
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=FieldValidationHandler.js.map

package/dist/services/update/FieldValidationHandler.js.map

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

package/dist/services/update/MetadataResolver.d.ts

@@ -0,0 +1,50 @@
+/**
+ * MetadataResolver - Centralized metadata fetching with caching
+ *
+ * Consolidates duplicate metadata fetching from UniversalUpdateService
+ * and value-transformer into a single, cacheable operation.
+ *
+ * @see Issue #984 - Consolidate metadata fetching to reduce API calls by 40-60%
+ */
+import { UniversalResourceType } from '../../handlers/tool-configs/universal/types.js';
+import type { AttributeMetadata } from '../../services/value-transformer/types.js';
+/**
+ * Result of metadata resolution
+ */
+export interface MetadataResolutionResult {
+    /** Map of attribute slug → metadata for transformer */
+    metadataMap: Map<string, AttributeMetadata>;
+    /** Array of attribute slugs (lowercase) for field mapper */
+    availableAttributes: string[];
+    /** Whether result came from cache (true) or fresh fetch (false) */
+    fromCache: boolean;
+}
+/**
+ * MetadataResolver - Single source of truth for metadata fetching
+ */
+export declare class MetadataResolver {
+    /**
+     * Fetch metadata for a resource type with caching
+     *
+     * This is the single entry point for metadata fetching across
+     * UniversalUpdateService, UniversalCreateService, and value-transformer.
+     *
+     * @param resourceType - The resource type to fetch metadata for
+     * @param recordData - Optional record data containing object slug
+     * @returns Metadata map and available attributes for field mapping
+     */
+    static fetchMetadata(resourceType: UniversalResourceType, recordData?: Record<string, unknown>): Promise<MetadataResolutionResult>;
+    /**
+     * Fetch fresh metadata from Attio API
+     */
+    private static fetchFreshMetadata;
+    /**
+     * Extract object slug from resource type and record data
+     */
+    static extractObjectSlug(resourceType: UniversalResourceType, recordData?: Record<string, unknown>): string | undefined;
+    /**
+     * Extract attribute slugs for field mapper (lowercase)
+     */
+    private static extractAttributeSlugs;
+}
+//# sourceMappingURL=MetadataResolver.d.ts.map

package/dist/services/update/MetadataResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetadataResolver.d.ts","sourceRoot":"","sources":["../../../src/services/update/MetadataResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AAGnF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAI/E;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,uDAAuD;IACvD,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC5C,4DAA4D;IAC5D,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,mEAAmE;IACnE,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B;;;;;;;;;OASG;WACU,aAAa,CACxB,YAAY,EAAE,qBAAqB,EACnC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,OAAO,CAAC,wBAAwB,CAAC;IAkFpC;;OAEG;mBACkB,kBAAkB;IAevC;;OAEG;WACW,iBAAiB,CAC7B,YAAY,EAAE,qBAAqB,EACnC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,MAAM,GAAG,SAAS;IAcrB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;CAarC"}

package/dist/services/update/MetadataResolver.js

@@ -0,0 +1,110 @@
+/**
+ * MetadataResolver - Centralized metadata fetching with caching
+ *
+ * Consolidates duplicate metadata fetching from UniversalUpdateService
+ * and value-transformer into a single, cacheable operation.
+ *
+ * @see Issue #984 - Consolidate metadata fetching to reduce API calls by 40-60%
+ */
+import { UniversalResourceType } from '../../handlers/tool-configs/universal/types.js';
+import { CachingService } from '../../services/CachingService.js';
+import { DEFAULT_ATTRIBUTES_CACHE_TTL } from '../../constants/universal.constants.js';
+import { debug, error as logError } from '../../utils/logger.js';
+import { convertToMetadataMap } from '../../utils/metadata-utils.js';
+/**
+ * MetadataResolver - Single source of truth for metadata fetching
+ */
+export class MetadataResolver {
+    /**
+     * Fetch metadata for a resource type with caching
+     *
+     * This is the single entry point for metadata fetching across
+     * UniversalUpdateService, UniversalCreateService, and value-transformer.
+     *
+     * @param resourceType - The resource type to fetch metadata for
+     * @param recordData - Optional record data containing object slug
+     * @returns Metadata map and available attributes for field mapping
+     */
+    static async fetchMetadata(resourceType, recordData) {
+        const objectSlug = this.extractObjectSlug(resourceType, recordData);
+        try {
+            // Try cache first, then load fresh data
+            const result = await CachingService.getOrLoadAttributes(() => this.fetchFreshMetadata(resourceType, objectSlug), resourceType, objectSlug, DEFAULT_ATTRIBUTES_CACHE_TTL);
+            // Use shared utility from metadata-utils (PR #1006 Phase 2.1)
+            const metadataMap = convertToMetadataMap(result.data);
+            const availableAttributes = this.extractAttributeSlugs(metadataMap);
+            debug('MetadataResolver', 'Metadata fetched', {
+                resourceType,
+                objectSlug,
+                fromCache: result.fromCache,
+                attributeCount: metadataMap.size,
+            });
+            return {
+                metadataMap,
+                availableAttributes,
+                fromCache: result.fromCache,
+            };
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            // Re-throw critical authentication errors (Issue #984 extension - PR review feedback)
+            if (error.message.includes('401') ||
+                error.message.includes('403') ||
+                error.message.includes('Unauthorized') ||
+                error.message.includes('Forbidden')) {
+                logError('MetadataResolver', 'Authentication error fetching metadata', error, { resourceType, objectSlug });
+                throw error;
+            }
+            // Re-throw schema validation errors
+            if (error.message.includes('validation') ||
+                error.message.includes('schema')) {
+                logError('MetadataResolver', 'Schema validation error fetching metadata', error, { resourceType, objectSlug });
+                throw error;
+            }
+            // Log and return empty for non-critical errors (transient failures, network issues)
+            logError('MetadataResolver', 'Non-critical metadata fetch error, using empty metadata', error, { resourceType, objectSlug });
+            debug('MetadataResolver', 'Graceful degradation with empty metadata', {
+                resourceType,
+                objectSlug,
+            });
+            return {
+                metadataMap: new Map(),
+                availableAttributes: [],
+                fromCache: false,
+            };
+        }
+    }
+    /**
+     * Fetch fresh metadata from Attio API
+     */
+    static async fetchFreshMetadata(resourceType, objectSlug) {
+        const { UniversalMetadataService } = await import('../../services/UniversalMetadataService.js');
+        const options = objectSlug ? { objectSlug } : undefined;
+        return UniversalMetadataService.discoverAttributesForResourceType(resourceType, options);
+    }
+    /**
+     * Extract object slug from resource type and record data
+     */
+    static extractObjectSlug(resourceType, recordData) {
+        if (resourceType === UniversalResourceType.RECORDS) {
+            return (recordData?.object ||
+                recordData?.object_api_slug ||
+                'records');
+        }
+        if (resourceType === UniversalResourceType.DEALS) {
+            return 'deals';
+        }
+        return undefined;
+    }
+    /**
+     * Extract attribute slugs for field mapper (lowercase)
+     */
+    static extractAttributeSlugs(metadataMap) {
+        return Array.from(new Set(Array.from(metadataMap.values()).flatMap((attr) => {
+            return [attr.api_slug, attr.title, attr.slug]
+                .filter((s) => typeof s === 'string')
+                .map((s) => s.toLowerCase());
+        })));
+    }
+}
+//# sourceMappingURL=MetadataResolver.js.map

package/dist/services/update/MetadataResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetadataResolver.js","sourceRoot":"","sources":["../../../src/services/update/MetadataResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AAElF,OAAO,EAAE,KAAK,EAAE,KAAK,IAAI,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAcjE;;GAEG;AACH,MAAM,OAAO,gBAAgB;IAC3B;;;;;;;;;OASG;IACH,MAAM,CAAC,KAAK,CAAC,aAAa,CACxB,YAAmC,EACnC,UAAoC;QAEpC,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QAEpE,IAAI,CAAC;YACH,wCAAwC;YACxC,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,mBAAmB,CACrD,GAAG,EAAE,CAAC,IAAI,CAAC,kBAAkB,CAAC,YAAY,EAAE,UAAU,CAAC,EACvD,YAAY,EACZ,UAAU,EACV,4BAA4B,CAC7B,CAAC;YAEF,8DAA8D;YAC9D,MAAM,WAAW,GAAG,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACtD,MAAM,mBAAmB,GAAG,IAAI,CAAC,qBAAqB,CAAC,WAAW,CAAC,CAAC;YAEpE,KAAK,CAAC,kBAAkB,EAAE,kBAAkB,EAAE;gBAC5C,YAAY;gBACZ,UAAU;gBACV,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,cAAc,EAAE,WAAW,CAAC,IAAI;aACjC,CAAC,CAAC;YAEH,OAAO;gBACL,WAAW;gBACX,mBAAmB;gBACnB,SAAS,EAAE,MAAM,CAAC,SAAS;aAC5B,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAElE,sFAAsF;YACtF,IACE,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAC7B,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAC7B,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;gBACtC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EACnC,CAAC;gBACD,QAAQ,CACN,kBAAkB,EAClB,wCAAwC,EACxC,KAAK,EACL,EAAE,YAAY,EAAE,UAAU,EAAE,CAC7B,CAAC;gBACF,MAAM,KAAK,CAAC;YACd,CAAC;YAED,oCAAoC;YACpC,IACE,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;gBACpC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAChC,CAAC;gBACD,QAAQ,CACN,kBAAkB,EAClB,2CAA2C,EAC3C,KAAK,EACL,EAAE,YAAY,EAAE,UAAU,EAAE,CAC7B,CAAC;gBACF,MAAM,KAAK,CAAC;YACd,CAAC;YAED,oFAAoF;YACpF,QAAQ,CACN,kBAAkB,EAClB,yDAAyD,EACzD,KAAK,EACL,EAAE,YAAY,EAAE,UAAU,EAAE,CAC7B,CAAC;YAEF,KAAK,CAAC,kBAAkB,EAAE,0CAA0C,EAAE;gBACpE,YAAY;gBACZ,UAAU;aACX,CAAC,CAAC;YAEH,OAAO;gBACL,WAAW,EAAE,IAAI,GAAG,EAAE;gBACtB,mBAAmB,EAAE,EAAE;gBACvB,SAAS,EAAE,KAAK;aACjB,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,KAAK,CAAC,kBAAkB,CACrC,YAAmC,EACnC,UAAmB;QAEnB,MAAM,EAAE,wBAAwB,EAAE,GAAG,MAAM,MAAM,CAC/C,wCAAwC,CACzC,CAAC;QAEF,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACxD,OAAO,wBAAwB,CAAC,iCAAiC,CAC/D,YAAY,EACZ,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,iBAAiB,CAC7B,YAAmC,EACnC,UAAoC;QAEpC,IAAI,YAAY,KAAK,qBAAqB,CAAC,OAAO,EAAE,CAAC;YACnD,OAAO,CACJ,UAAU,EAAE,MAAiB;gBAC7B,UAAU,EAAE,eAA0B;gBACvC,SAAS,CACV,CAAC;QACJ,CAAC;QACD,IAAI,YAAY,KAAK,qBAAqB,CAAC,KAAK,EAAE,CAAC;YACjD,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,qBAAqB,CAClC,WAA2C;QAE3C,OAAO,KAAK,CAAC,IAAI,CACf,IAAI,GAAG,CACL,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;YAChD,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC;iBAC1C,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;iBACjD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QACjC,CAAC,CAAC,CACH,CACF,CAAC;IACJ,CAAC;CACF"}