attio-mcp 0.1.1 → 1.0.0

package/dist/services/UniversalUpdateService.d.ts

@@ -0,0 +1,77 @@
+/**
+ * UniversalUpdateService - Centralized record update operations
+ *
+ * Extracted from shared-handlers.ts as part of Issue #489 Phase 3.
+ * Provides universal update functionality across all resource types.
+ *
+ * ENVIRONMENT VARIABLES (Runtime Behavior Configuration):
+ *
+ * @env ENABLE_ENHANCED_VALIDATION - Enable additional validation checks (default: false)
+ *      Values: "true" | "false" | undefined
+ *      Example: ENABLE_ENHANCED_VALIDATION="true"
+ *      Impact: Adds extra field validation before API calls
+ *      Production Risk: May reject previously valid requests
+ *
+ * @env ENABLE_FIELD_VERIFICATION - Enable post-update field verification (default: true)
+ *      Values: "true" | "false" | undefined
+ *      Example: ENABLE_FIELD_VERIFICATION="false"
+ *      Impact: Skips verification that fields were persisted correctly
+ *      Production Risk: Silent data consistency issues if disabled
+ *
+ * @env STRICT_FIELD_VALIDATION - Fail operations on verification failures (default: false)
+ *      Values: "true" | "false" | undefined
+ *      Example: STRICT_FIELD_VALIDATION="true"
+ *      Impact: Throws errors when field verification fails instead of logging warnings
+ *      Production Risk: Operations may fail that previously succeeded with warnings
+ *
+ * PRODUCTION SAFETY NOTES:
+ * - These environment variables significantly change runtime behavior
+ * - Test thoroughly in staging before changing production values
+ * - Monitor error rates and data consistency when changing validation settings
+ * - Consider gradual rollout with feature flags for validation strictness changes
+ * - Document all environment variable usage in deployment runbooks
+ */
+import type { UniversalUpdateParams } from '../handlers/tool-configs/universal/types.js';
+import { AttioRecord } from '../types/attio.js';
+/**
+ * Validation result containing warnings and actual persisted values
+ */
+export interface ValidationResult {
+    warnings: string[];
+    actualValues: Record<string, unknown>;
+    suggestions: string[];
+}
+/**
+ * Enhanced update result that includes validation metadata
+ */
+export interface EnhancedUpdateResult {
+    record: AttioRecord;
+    validation: ValidationResult;
+}
+/**
+ * UniversalUpdateService provides centralized record update functionality
+ *
+ * **Type Safety Enhancements**: This service uses Record<string, unknown> instead of any
+ * for better type safety. This provides compile-time checking while allowing dynamic
+ * property access needed for flexible API data handling.
+ *
+ * **Design Rationale**: Record<string, unknown> prevents accidental misuse of properties
+ * while maintaining the flexibility required for varied API response structures.
+ */
+export declare class UniversalUpdateService {
+    /**
+     * Enhanced update method that returns validation metadata
+     */
+    static updateRecordWithValidation(params: UniversalUpdateParams): Promise<EnhancedUpdateResult>;
+    static updateRecord(params: UniversalUpdateParams): Promise<AttioRecord>;
+    /**
+     * Internal update record implementation with validation tracking
+     */
+    private static _updateRecordInternalWithValidation;
+    /**
+     * Internal update record implementation
+     */
+    private static _updateRecordInternal;
+    private static handleUnsupportedResourceType;
+}
+//# sourceMappingURL=UniversalUpdateService.d.ts.map

package/dist/services/UniversalUpdateService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UniversalUpdateService.d.ts","sourceRoot":"","sources":["../../src/services/UniversalUpdateService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAGH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6CAA6C,CAAC;AACzF,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAiBhD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,EAAE,gBAAgB,CAAC;CAC9B;AAkBD;;;;;;;;;GASG;AACH,qBAAa,sBAAsB;IACjC;;OAEG;WACU,0BAA0B,CACrC,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,oBAAoB,CAAC;WA6DnB,YAAY,CACvB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,WAAW,CAAC;IA6DvB;;OAEG;mBACkB,mCAAmC;IAoJxD;;OAEG;mBACkB,qBAAqB;mBAmUrB,6BAA6B;CA2BnD"}

package/dist/services/UniversalUpdateService.js

@@ -0,0 +1,456 @@
+/**
+ * UniversalUpdateService - Centralized record update operations
+ *
+ * Extracted from shared-handlers.ts as part of Issue #489 Phase 3.
+ * Provides universal update functionality across all resource types.
+ *
+ * ENVIRONMENT VARIABLES (Runtime Behavior Configuration):
+ *
+ * @env ENABLE_ENHANCED_VALIDATION - Enable additional validation checks (default: false)
+ *      Values: "true" | "false" | undefined
+ *      Example: ENABLE_ENHANCED_VALIDATION="true"
+ *      Impact: Adds extra field validation before API calls
+ *      Production Risk: May reject previously valid requests
+ *
+ * @env ENABLE_FIELD_VERIFICATION - Enable post-update field verification (default: true)
+ *      Values: "true" | "false" | undefined
+ *      Example: ENABLE_FIELD_VERIFICATION="false"
+ *      Impact: Skips verification that fields were persisted correctly
+ *      Production Risk: Silent data consistency issues if disabled
+ *
+ * @env STRICT_FIELD_VALIDATION - Fail operations on verification failures (default: false)
+ *      Values: "true" | "false" | undefined
+ *      Example: STRICT_FIELD_VALIDATION="true"
+ *      Impact: Throws errors when field verification fails instead of logging warnings
+ *      Production Risk: Operations may fail that previously succeeded with warnings
+ *
+ * PRODUCTION SAFETY NOTES:
+ * - These environment variables significantly change runtime behavior
+ * - Test thoroughly in staging before changing production values
+ * - Monitor error rates and data consistency when changing validation settings
+ * - Consider gradual rollout with feature flags for validation strictness changes
+ * - Document all environment variable usage in deployment runbooks
+ */
+import { UniversalResourceType } from '../handlers/tool-configs/universal/types.js';
+import { UniversalValidationError, ErrorType, } from '../handlers/tool-configs/universal/schemas.js';
+import { debug, error as logError } from '../utils/logger.js';
+// Import shared type definitions for better type safety
+import { createNotFoundError, isAttributeObject, } from '../types/universal-service-types.js';
+// Import services
+import { ValidationService } from './ValidationService.js';
+// Import field mapping utilities
+import { mapRecordFields, validateResourceType, validateFields, getValidResourceTypes, mapTaskFields, } from '../handlers/tool-configs/universal/field-mapper.js';
+// Import validation utilities
+import { validateRecordFields } from '../utils/validation-utils.js';
+// Note: Deal defaults configuration removed as unused in update service
+// Note: Removed unused resource-specific function imports as service now uses strategy pattern
+/**
+ * UniversalUpdateService provides centralized record update functionality
+ *
+ * **Type Safety Enhancements**: This service uses Record<string, unknown> instead of any
+ * for better type safety. This provides compile-time checking while allowing dynamic
+ * property access needed for flexible API data handling.
+ *
+ * **Design Rationale**: Record<string, unknown> prevents accidental misuse of properties
+ * while maintaining the flexibility required for varied API response structures.
+ */
+export class UniversalUpdateService {
+    /**
+     * Enhanced update method that returns validation metadata
+     */
+    static async updateRecordWithValidation(params) {
+        // Validate resource type is supported
+        const validResourceTypes = Object.values(UniversalResourceType);
+        if (!validResourceTypes.includes(params.resource_type)) {
+            throw new UniversalValidationError(`Unsupported resource type: ${params.resource_type}`, ErrorType.USER_ERROR, {
+                field: 'resource_type',
+                suggestion: `Valid resource types are: ${validResourceTypes.join(', ')}`,
+            });
+        }
+        try {
+            return await this._updateRecordInternalWithValidation(params);
+        }
+        catch (error) {
+            // Check if this is already a structured HTTP response - if so, pass it through unchanged
+            if (error &&
+                typeof error === 'object' &&
+                'status' in error &&
+                'body' in error) {
+                throw error; // Pass through HTTP-like errors unchanged
+            }
+            // Handle TypeError exceptions that occur from malformed data
+            if (error instanceof TypeError &&
+                error.message.includes('Cannot read properties of undefined')) {
+                // For TypeErrors caused by malformed data structure, return 404 for tasks
+                const { resource_type, record_id } = params;
+                if (resource_type === UniversalResourceType.TASKS) {
+                    // Using shared error creation utility for consistency
+                    throw createNotFoundError(resource_type, record_id);
+                }
+            }
+            // Also handle wrapped TypeErrors from MockService
+            if (error instanceof Error &&
+                error.message.includes('Failed to update task: Cannot read properties of undefined')) {
+                const { resource_type, record_id } = params;
+                if (resource_type === UniversalResourceType.TASKS) {
+                    // Using shared error creation utility for consistency
+                    throw createNotFoundError(resource_type, record_id);
+                }
+            }
+            // Re-throw all other errors with cause preserved
+            throw error;
+        }
+    }
+    static async updateRecord(params) {
+        // Validate resource type is supported
+        const validResourceTypes = Object.values(UniversalResourceType);
+        if (!validResourceTypes.includes(params.resource_type)) {
+            throw new UniversalValidationError(`Unsupported resource type: ${params.resource_type}`, ErrorType.USER_ERROR, {
+                field: 'resource_type',
+                suggestion: `Valid resource types are: ${validResourceTypes.join(', ')}`,
+            });
+        }
+        try {
+            return await this._updateRecordInternal(params);
+        }
+        catch (error) {
+            // Check if this is already a structured HTTP response - if so, pass it through unchanged
+            if (error &&
+                typeof error === 'object' &&
+                'status' in error &&
+                'body' in error) {
+                throw error; // Pass through HTTP-like errors unchanged
+            }
+            // Handle TypeError exceptions that occur from malformed data
+            if (error instanceof TypeError &&
+                error.message.includes('Cannot read properties of undefined')) {
+                // For TypeErrors caused by malformed data structure, return 404 for tasks
+                const { resource_type, record_id } = params;
+                if (resource_type === UniversalResourceType.TASKS) {
+                    // Using shared error creation utility for consistency
+                    throw createNotFoundError(resource_type, record_id);
+                }
+            }
+            // Also handle wrapped TypeErrors from MockService
+            if (error instanceof Error &&
+                error.message.includes('Failed to update task: Cannot read properties of undefined')) {
+                const { resource_type, record_id } = params;
+                if (resource_type === UniversalResourceType.TASKS) {
+                    // Using shared error creation utility for consistency
+                    throw createNotFoundError(resource_type, record_id);
+                }
+            }
+            // Re-throw all other errors with cause preserved
+            throw error;
+        }
+    }
+    /**
+     * Internal update record implementation with validation tracking
+     */
+    static async _updateRecordInternalWithValidation(params) {
+        const validationResult = {
+            warnings: [],
+            actualValues: {},
+            suggestions: [],
+        };
+        const { resource_type, record_id, record_data } = params;
+        const legacyData = params.data;
+        const actualRecordData = (record_data ?? legacyData);
+        // Enhanced null-safety: Guard against undefined values access
+        /**
+         * **Record<string, unknown> Rationale**: Using Record<string, unknown> instead of any
+         * ensures type safety while allowing dynamic property access for API data structures.
+         * This prevents runtime errors while maintaining flexibility for varied data formats.
+         */
+        const raw = actualRecordData && typeof actualRecordData === 'object'
+            ? actualRecordData
+            : {};
+        const values = raw.values ?? raw;
+        // Pre-validate fields and provide helpful suggestions (less strict for updates)
+        const fieldValidation = validateFields(resource_type, values);
+        if (fieldValidation.warnings.length > 0) {
+            validationResult.warnings.push(...fieldValidation.warnings);
+            // Use structured logging for field validation warnings
+            debug('UniversalUpdateService', 'Field validation warnings', {
+                warnings: fieldValidation.warnings.join('\n'),
+            });
+        }
+        if (fieldValidation.suggestions.length > 0) {
+            validationResult.suggestions.push(...fieldValidation.suggestions);
+            const truncated = ValidationService.truncateSuggestions(fieldValidation.suggestions);
+            debug('UniversalUpdateService', 'Field suggestions:', {
+                suggestions: truncated.join('\n'),
+            });
+        }
+        // Apply deal-specific validation for deals
+        if (resource_type === UniversalResourceType.DEALS) {
+            try {
+                const { applyDealDefaultsWithValidation } = await import('../config/deal-defaults.js');
+                const dealValidation = await applyDealDefaultsWithValidation(values, false // Don't skip API validation for user requests
+                );
+                // Update values with validated deal data
+                Object.assign(values, dealValidation.dealData);
+                // Collect deal-specific warnings and suggestions
+                validationResult.warnings.push(...dealValidation.warnings);
+                validationResult.suggestions.push(...dealValidation.suggestions);
+                debug('UniversalUpdateService', 'Deal validation applied', {
+                    warnings: dealValidation.warnings,
+                    suggestions: dealValidation.suggestions,
+                });
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                validationResult.warnings.push(`Deal validation warning: ${errorMessage}`);
+                debug('UniversalUpdateService', 'Deal validation failed', {
+                    error: errorMessage,
+                });
+            }
+        }
+        // Continue with the rest of the update process using existing logic
+        // Skip verification in _updateRecordInternal to avoid duplication
+        const record = await this._updateRecordInternal(params, true);
+        // Store actual values for comparison
+        validationResult.actualValues = record.values || {};
+        // Capture field persistence verification warnings if enabled
+        if (process.env.ENABLE_FIELD_VERIFICATION !== 'false') {
+            try {
+                // Reconstruct sanitized data for verification
+                const { mapped: mappedData } = await mapRecordFields(resource_type, values);
+                const attioPayload = { values: mappedData };
+                const { UpdateValidation } = await import('./update/UpdateValidation.js');
+                const sanitizedData = UpdateValidation.sanitizeSpecialCharacters(attioPayload.values);
+                const verification = await UpdateValidation.verifyFieldPersistence(resource_type, record_id, sanitizedData);
+                // Add field persistence warnings to validation result
+                if (verification.warnings.length > 0) {
+                    validationResult.warnings.push(...verification.warnings);
+                }
+                if (!verification.verified) {
+                    // Add discrepancies as warnings for user visibility
+                    validationResult.warnings.push(...verification.discrepancies.map((discrepancy) => `Field persistence issue: ${discrepancy}`));
+                }
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                validationResult.warnings.push(`Field verification warning: ${errorMessage}`);
+            }
+        }
+        return {
+            record,
+            validation: validationResult,
+        };
+    }
+    /**
+     * Internal update record implementation
+     */
+    static async _updateRecordInternal(params, skipVerification = false) {
+        const { resource_type, record_id, record_data } = params;
+        const legacyData = params.data;
+        const actualRecordData = (record_data ?? legacyData);
+        // Enhanced null-safety: Guard against undefined values access
+        /**
+         * **Record<string, unknown> Rationale**: Using Record<string, unknown> instead of any
+         * ensures type safety while allowing dynamic property access for API data structures.
+         * This prevents runtime errors while maintaining flexibility for varied data formats.
+         */
+        const raw = actualRecordData && typeof actualRecordData === 'object'
+            ? actualRecordData
+            : {};
+        const values = raw.values ?? raw;
+        // Pre-validate fields and provide helpful suggestions (less strict for updates)
+        const fieldValidation = validateFields(resource_type, values);
+        if (fieldValidation.warnings.length > 0) {
+            // Use structured logging for field validation warnings
+            debug('UniversalUpdateService', 'Field validation warnings', {
+                warnings: fieldValidation.warnings.join('\n'),
+            });
+        }
+        if (fieldValidation.suggestions.length > 0) {
+            const truncated = ValidationService.truncateSuggestions(fieldValidation.suggestions);
+            debug('UniversalUpdateService', 'Field suggestions:', {
+                suggestions: truncated.join('\n'),
+            });
+        }
+        // Fetch available attributes for attribute-aware mapping (optional; best-effort)
+        let availableAttributes;
+        try {
+            const { UniversalMetadataService } = await import('./UniversalMetadataService.js');
+            const options = resource_type === UniversalResourceType.RECORDS
+                ? {
+                    objectSlug: actualRecordData?.object ||
+                        actualRecordData?.object_api_slug ||
+                        'records',
+                }
+                : resource_type === UniversalResourceType.DEALS
+                    ? { objectSlug: 'deals' }
+                    : undefined;
+            const attributeResult = await UniversalMetadataService.discoverAttributesForResourceType(resource_type, options);
+            const attrs = attributeResult?.attributes ?? [];
+            /**
+             * **Type Guard Usage**: Using isAttributeObject type guard instead of inline casting
+             * for safer attribute processing and better runtime type validation.
+             */
+            availableAttributes = Array.from(new Set(attrs.flatMap((a) => {
+                if (!isAttributeObject(a)) {
+                    return [];
+                }
+                return [a.api_slug, a.title, a.name].filter((s) => typeof s === 'string');
+            }))).map((s) => s.toLowerCase());
+        }
+        catch (error) {
+            debug('UniversalUpdateService', 'Failed to fetch attributes', {
+                resource_type,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            availableAttributes = undefined;
+        }
+        // Map field names to correct ones with collision detection
+        const mappingResult = await mapRecordFields(resource_type, values, availableAttributes);
+        if (mappingResult.errors && mappingResult.errors.length > 0) {
+            throw new UniversalValidationError(mappingResult.errors.join(' '), ErrorType.USER_ERROR, {
+                field: 'record_data',
+                suggestion: 'Please use only one field for each target. Multiple aliases mapping to the same field are not allowed.',
+                cause: undefined, // No specific cause for mapping errors
+            });
+        }
+        const { mapped: mappedData, warnings } = mappingResult;
+        if (warnings.length > 0) {
+            debug('UniversalUpdateService', 'Field mapping applied:', {
+                warnings: warnings.join('\n'),
+            });
+        }
+        // Always wrap in Attio envelope format
+        const attioPayload = {
+            values: mappedData,
+        };
+        // Apply operation-specific field mapping for tasks (prevent content injection on update)
+        if (resource_type === UniversalResourceType.TASKS) {
+            const updatedTaskData = mapTaskFields('update', mappedData);
+            attioPayload.values = updatedTaskData;
+        }
+        // Normalize values (e.g., phone numbers to E.164)
+        const { normalizeValues } = await import('./normalizers/AttributeAwareNormalizer.js');
+        attioPayload.values = await normalizeValues(resource_type, attioPayload.values, availableAttributes);
+        // Sanitize special characters while preserving intended content
+        const { UpdateValidation } = await import('./update/UpdateValidation.js');
+        const sanitizedData = UpdateValidation.sanitizeSpecialCharacters(attioPayload.values);
+        attioPayload.values = sanitizedData;
+        // Optional enhanced validation
+        // WARNING: This environment variable changes runtime behavior
+        // Production Impact: May reject previously valid requests
+        if (process.env.ENABLE_ENHANCED_VALIDATION === 'true') {
+            const validation = await validateRecordFields(resource_type, attioPayload.values, false);
+            if (!validation.isValid) {
+                const errorMessage = validation.error || 'Validation failed';
+                throw new UniversalValidationError(errorMessage, ErrorType.USER_ERROR, {
+                    suggestion: 'Please fix the validation errors and try again.',
+                    field: undefined,
+                    cause: undefined, // No specific cause for validation errors
+                });
+            }
+        }
+        let updatedRecord;
+        switch (resource_type) {
+            case UniversalResourceType.COMPANIES: {
+                const { CompanyUpdateStrategy } = await import('./update/strategies/CompanyUpdateStrategy.js');
+                const strategy = new CompanyUpdateStrategy();
+                updatedRecord = await strategy.update(record_id, attioPayload.values, resource_type);
+                break;
+            }
+            case UniversalResourceType.LISTS: {
+                const { ListUpdateStrategy } = await import('./update/strategies/ListUpdateStrategy.js');
+                const strategy = new ListUpdateStrategy();
+                updatedRecord = await strategy.update(record_id, attioPayload.values, resource_type);
+                break;
+            }
+            case UniversalResourceType.PEOPLE: {
+                const { PersonUpdateStrategy } = await import('./update/strategies/PersonUpdateStrategy.js');
+                const strategy = new PersonUpdateStrategy();
+                updatedRecord = await strategy.update(record_id, attioPayload.values, resource_type);
+                break;
+            }
+            case UniversalResourceType.RECORDS:
+            case UniversalResourceType.DEALS: {
+                const { RecordUpdateStrategy } = await import('./update/strategies/RecordUpdateStrategy.js');
+                const strategy = new RecordUpdateStrategy();
+                /**
+                 * **Safe Property Access**: Using type-safe property access for object slug
+                 * extraction while providing sensible defaults.
+                 */
+                const recordsObjectSlug = (typeof actualRecordData?.object === 'string'
+                    ? actualRecordData.object
+                    : undefined) ||
+                    (typeof actualRecordData?.object_api_slug === 'string'
+                        ? actualRecordData.object_api_slug
+                        : undefined) ||
+                    'records';
+                updatedRecord = await strategy.update(record_id, attioPayload.values, resource_type, { objectSlug: recordsObjectSlug });
+                break;
+            }
+            case UniversalResourceType.TASKS: {
+                const { TaskUpdateStrategy } = await import('./update/strategies/TaskUpdateStrategy.js');
+                const strategy = new TaskUpdateStrategy();
+                updatedRecord = await strategy.update(record_id, attioPayload.values, resource_type);
+                break;
+            }
+            default: {
+                updatedRecord = await this.handleUnsupportedResourceType(resource_type, params);
+                break;
+            }
+        }
+        const { ResponseNormalizer } = await import('./update/ResponseNormalizer.js');
+        const normalizedRecord = ResponseNormalizer.normalizeResponseFormat(resource_type, updatedRecord);
+        // Field persistence verification (enabled by default)
+        // WARNING: Disabling this can cause silent data consistency issues
+        // Skip verification if called from validation-aware path to avoid duplication
+        if (!skipVerification &&
+            process.env.ENABLE_FIELD_VERIFICATION !== 'false') {
+            try {
+                const verification = await UpdateValidation.verifyFieldPersistence(resource_type, record_id, sanitizedData);
+                if (verification.warnings.length > 0) {
+                    logError('UniversalUpdateService', `Field persistence warnings for ${resource_type} ${record_id}:`, verification.warnings);
+                }
+                if (!verification.verified) {
+                    // Use structured logging for field persistence verification failures
+                    logError('UniversalUpdateService', 'Field persistence verification failed', new Error('Verification failed'), {
+                        resource_type,
+                        record_id,
+                        discrepancies: verification.discrepancies,
+                    });
+                    // If strict validation is enabled, fail the operation
+                    // WARNING: This environment variable changes runtime behavior
+                    // Production Impact: Operations may fail that previously succeeded
+                    if (process.env.STRICT_FIELD_VALIDATION === 'true') {
+                        throw new UniversalValidationError(`Field persistence verification failed: ${verification.discrepancies.join('; ')}`, ErrorType.API_ERROR, {
+                            field: 'field_verification',
+                            suggestion: 'Check that the field values are correctly formatted and supported by the API',
+                        });
+                    }
+                }
+            }
+            catch (error) {
+                logError('UniversalUpdateService', 'Field persistence verification error', error);
+            }
+        }
+        return normalizedRecord;
+    }
+    static async handleUnsupportedResourceType(resource_type, params) {
+        // Check if resource type can be corrected
+        const resourceValidation = validateResourceType(resource_type);
+        if (resourceValidation.corrected) {
+            // Retry with corrected resource type
+            debug('UniversalUpdateService', `Resource type corrected`, {
+                from: resource_type,
+                to: resourceValidation.corrected,
+            });
+            return this.updateRecord({
+                ...params,
+                resource_type: resourceValidation.corrected,
+            });
+        }
+        throw new UniversalValidationError(`Unsupported resource type: ${resource_type}`, ErrorType.USER_ERROR, {
+            suggestion: resourceValidation.suggestion ||
+                `Valid resource types are: ${getValidResourceTypes()}`,
+        });
+    }
+}
+//# sourceMappingURL=UniversalUpdateService.js.map

package/dist/services/UniversalUpdateService.js.map

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

package/dist/services/UniversalUtilityService.d.ts

@@ -0,0 +1,92 @@
+/**
+ * UniversalUtilityService - Centralized utility functions
+ *
+ * Extracted from shared-handlers.ts as part of Issue #489 Phase 3.
+ * Provides universal utility functions for resource type formatting, validation, and data conversion.
+ */
+import { UniversalResourceType } from '../handlers/tool-configs/universal/types.js';
+import { AttioRecord, AttioTask, AttioRecordValues } from '../types/attio.js';
+/**
+ * UniversalUtilityService provides centralized utility functions
+ */
+export declare class UniversalUtilityService {
+    /**
+     * Utility function to format resource type for display
+     */
+    static formatResourceType(resourceType: UniversalResourceType): string;
+    /**
+     * Utility function to get singular form of resource type
+     */
+    static getSingularResourceType(resourceType: UniversalResourceType): string;
+    /**
+     * Utility function to validate resource type
+     */
+    static isValidResourceType(resourceType: string): resourceType is UniversalResourceType;
+    /**
+     * Converts an AttioTask to an AttioRecord for universal tool compatibility.
+     *
+     * This function provides proper type conversion from the task-specific format
+     * to the generic record format used by universal tools, ensuring data integrity
+     * without unsafe type casting.
+     *
+     * @param task - The AttioTask object to convert
+     * @returns An AttioRecord representation of the task with properly mapped fields
+     *
+     * @example
+     * const task = await getTask('task-123');
+     * const record = UniversalUtilityService.convertTaskToRecord(task);
+     * // record.values now contains: content, status, assignee, due_date, linked_records
+     */
+    static convertTaskToRecord(task: AttioTask): AttioRecord;
+    /**
+     * Extract display name from AttioRecord values with proper field priority
+     *
+     * Centralizes the logic for determining display names from record field values.
+     * Handles both direct object access and array-wrapped values patterns used
+     * throughout the codebase. Eliminates code duplication between formatResult functions.
+     *
+     * Field Priority Order:
+     * 1. name (checks both 'value' and 'full_name' properties)
+     * 2. full_name
+     * 3. title
+     * 4. content
+     * 5. fallback to 'Unnamed'
+     *
+     * @param values - The record values object (can be from record.values or direct values)
+     * @returns The extracted display name string or 'Unnamed' if no suitable field found
+     *
+     * @example
+     * ```typescript
+     * const displayName = UniversalUtilityService.extractDisplayName(record.values);
+     * // For tasks: "Follow up with client" (from content field)
+     * // For companies: "Acme Corp" (from name field)
+     * // For empty record: "Unnamed"
+     * ```
+     */
+    static extractDisplayName(values: AttioRecordValues | Record<string, unknown>): string;
+    /**
+     * Get the plural form of a resource type (opposite of getSingularResourceType)
+     */
+    static getPluralResourceType(resourceType: UniversalResourceType): string;
+    /**
+     * Check if a resource type supports object records API
+     */
+    static supportsObjectRecordsApi(resourceType: UniversalResourceType): boolean;
+    /**
+     * Get the API endpoint pattern for a resource type
+     */
+    static getApiEndpoint(resourceType: UniversalResourceType): string;
+    /**
+     * Check if a resource type requires special handling
+     */
+    static requiresSpecialHandling(resourceType: UniversalResourceType): boolean;
+    /**
+     * Normalize resource type string (handle case variations and common aliases)
+     */
+    static normalizeResourceType(input: string): UniversalResourceType | null;
+    /**
+     * Get human-readable description of a resource type
+     */
+    static getResourceTypeDescription(resourceType: UniversalResourceType): string;
+}
+//# sourceMappingURL=UniversalUtilityService.d.ts.map