@iflow-mcp/attio-mcp 1.3.6

package/dist/services/UniversalDeleteService.js

@@ -0,0 +1,184 @@
+/**
+ * UniversalDeleteService - Centralized record deletion operations
+ *
+ * Extracted from shared-handlers.ts as part of Issue #489 Phase 3.
+ * Provides universal delete functionality across all resource types.
+ */
+import { UniversalResourceType } from '../handlers/tool-configs/universal/types.js';
+import { isValidId } from '../utils/validation.js';
+import { debug } from '../utils/logger.js';
+// Import shared type definitions and utilities
+import { is404Error, createNotFoundError, } from '../types/universal-service-types.js';
+// Import delete functions for each resource type
+import { deleteCompany } from '../objects/companies/index.js';
+import { deletePerson } from '../objects/people-write.js';
+import { deleteList } from '../objects/lists.js';
+import { deleteObjectRecord } from '../objects/records/index.js';
+import { deleteTask, getTask } from '../objects/tasks.js';
+import { deleteNote } from '../objects/notes.js';
+import { shouldUseMockData } from './create/index.js';
+/**
+ * UniversalDeleteService provides centralized record deletion functionality
+ *
+ * **Type Safety Improvements**: This service now uses shared type definitions from
+ * universal-service-types.ts to eliminate repeated inline types and improve
+ * runtime safety through type guards.
+ *
+ * **Record<string, unknown> vs any**: Throughout this service, we use
+ * Record<string, unknown> instead of any for better type safety. This allows
+ * property access while preventing unsafe operations on unknown data structures.
+ */
+export class UniversalDeleteService {
+    /**
+     * Delete a record across any supported resource type
+     *
+     * @param params - Delete operation parameters
+     * @returns Promise resolving to success status and record ID
+     */
+    static async deleteRecord(params) {
+        const { resource_type, record_id } = params;
+        switch (resource_type) {
+            case UniversalResourceType.COMPANIES:
+                try {
+                    await deleteCompany(record_id);
+                    return { success: true, record_id };
+                }
+                catch (error) {
+                    // Map API errors to structured format using shared type guards
+                    if (is404Error(error)) {
+                        throw createNotFoundError(UniversalResourceType.COMPANIES, record_id);
+                    }
+                    throw error;
+                }
+            case UniversalResourceType.PEOPLE:
+                try {
+                    await deletePerson(record_id);
+                    return { success: true, record_id };
+                }
+                catch (error) {
+                    // Map API errors to structured format using shared type guards
+                    if (is404Error(error)) {
+                        throw createNotFoundError(UniversalResourceType.PEOPLE, record_id);
+                    }
+                    throw error;
+                }
+            case UniversalResourceType.LISTS:
+                await deleteList(record_id);
+                return { success: true, record_id };
+            case UniversalResourceType.RECORDS:
+                try {
+                    await deleteObjectRecord('records', record_id);
+                    return { success: true, record_id };
+                }
+                catch (error) {
+                    // Map API errors to structured format using shared type guards
+                    if (is404Error(error)) {
+                        throw createNotFoundError(UniversalResourceType.RECORDS, record_id);
+                    }
+                    throw error;
+                }
+            case UniversalResourceType.DEALS:
+                await deleteObjectRecord('deals', record_id);
+                return { success: true, record_id };
+            case UniversalResourceType.TASKS:
+                // In mock mode, pre-validate IDs and emit deterministic message expected by tests
+                if (shouldUseMockData()) {
+                    if (!isValidId(record_id)) {
+                        /**
+                         * **Type Safety Note**: Using TaskError interface instead of any
+                         * to maintain type safety while preserving test compatibility.
+                         */
+                        const err = new Error(`Task not found: ${record_id}`);
+                        err.status = 404;
+                        err.body = {
+                            code: 'not_found',
+                            message: `Task not found: ${record_id}`,
+                        };
+                        throw err;
+                    }
+                    if (process.env.NODE_ENV === 'development' ||
+                        process.env.VERBOSE_TESTS === 'true') {
+                        debug('UniversalDeleteService', '[MockInjection] Using mock data for task deletion');
+                    }
+                    return { success: true, record_id };
+                }
+                try {
+                    const resp = await deleteTask(record_id);
+                    // deleteTask returns boolean - if false, treat as not found
+                    if (resp === false) {
+                        /**
+                         * **Type Safety Note**: Using TaskError interface for structured error
+                         * properties while maintaining Error base class for compatibility.
+                         */
+                        const err = new Error(`Task with ID "${record_id}" not found.`);
+                        err.status = 404;
+                        err.body = {
+                            code: 'not_found',
+                            message: `Task with ID "${record_id}" not found.`,
+                        };
+                        throw err;
+                    }
+                    return { success: true, record_id };
+                }
+                catch (error) {
+                    // Map API errors to structured format, with a single retry for occasional eventual consistency
+                    if (is404Error(error)) {
+                        // Best-effort verification: if task still exists, wait briefly and retry once
+                        try {
+                            const exists = await getTask(record_id).then(() => true, () => false);
+                            if (exists) {
+                                await new Promise((r) => setTimeout(r, 500));
+                                const retried = await deleteTask(record_id);
+                                if (retried)
+                                    return { success: true, record_id };
+                            }
+                        }
+                        catch {
+                            // ignore and fall through to not_found mapping
+                        }
+                        /**
+                         * **Type Safety**: Using TaskError instead of any for structured error properties
+                         */
+                        const err = new Error(`Task with ID "${record_id}" not found.`);
+                        err.status = 404;
+                        err.body = {
+                            code: 'not_found',
+                            message: `Task with ID "${record_id}" not found.`,
+                        };
+                        throw err; // dispatcher should mark isError=true
+                    }
+                    // Map specific 400 errors for task ID validation to clearer messages
+                    /**
+                     * **Type Safety**: Using ApiErrorWithResponse interface instead of inline any casting
+                     * to provide proper type checking while maintaining flexibility for error handling.
+                     */
+                    const apiErr = error;
+                    const status = apiErr?.response?.status ?? apiErr?.status;
+                    const errorMessage = (apiErr?.response?.data?.message ??
+                        apiErr?.message ??
+                        '')
+                        .toString()
+                        .toLowerCase();
+                    if (status === 400) {
+                        // Only map task_id related 400 errors to avoid masking other validation issues
+                        if (errorMessage.includes('task_id') ||
+                            errorMessage.includes('invalid task') ||
+                            errorMessage.includes('malformed')) {
+                            // Throw a plain Error so the MCP wrapper surfaces the message text (matches test regex)
+                            throw new Error(`Invalid request to delete task ${record_id}`);
+                        }
+                        // For other 400 errors, preserve original error to maintain validation visibility
+                        debug('UniversalDeleteService', `Preserving 400 error for task deletion (not task_id related): ${errorMessage}`);
+                    }
+                    throw error;
+                }
+            case UniversalResourceType.NOTES: {
+                const result = await deleteNote(record_id);
+                return { success: result.success, record_id };
+            }
+            default:
+                throw new Error(`Unsupported resource type for delete: ${resource_type}`);
+        }
+    }
+}
+//# sourceMappingURL=UniversalDeleteService.js.map

package/dist/services/UniversalDeleteService.js.map

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

package/dist/services/UniversalMetadataService.d.ts

@@ -0,0 +1,68 @@
+/**
+ * UniversalMetadataService - Metadata orchestration facade
+ *
+ * Rebuilt for Issue #648 to delegate responsibilities to specialised metadata services
+ * while preserving the existing API surface for universal handlers.
+ */
+import { UniversalResourceType } from '../handlers/tool-configs/universal/types.js';
+import type { UniversalAttributesParams } from '../handlers/tool-configs/universal/types.js';
+import type { JsonObject } from '../types/attio.js';
+import { MetadataServicesDeps } from './metadata/index.js';
+import type { DiscoveryMetricsSummary, MetricsFilter } from './metadata/index.js';
+declare class UniversalMetadataFacade {
+    private readonly deps;
+    constructor(deps: MetadataServicesDeps);
+    private get discoveryService();
+    private get recordService();
+    private get transformService();
+    private get metricsService();
+    discoverAttributesForResourceType(resourceType: UniversalResourceType, options?: {
+        categories?: string[];
+        objectSlug?: string;
+        useCache?: boolean;
+        cacheTtl?: number;
+    }): Promise<JsonObject>;
+    discoverTaskAttributes(options?: {
+        categories?: string[];
+    }): Promise<JsonObject>;
+    getAttributesForRecord(resourceType: UniversalResourceType, recordId: string): Promise<JsonObject>;
+    filterAttributesByCategory(attributes: Record<string, unknown> | unknown[], categories?: string[]): Record<string, unknown> | unknown[];
+    getAttributes(params: UniversalAttributesParams): Promise<JsonObject>;
+    discoverAttributes(resource_type: UniversalResourceType, options?: {
+        categories?: string[];
+        objectSlug?: string;
+    }): Promise<JsonObject>;
+    getPerformanceMetrics(options?: MetricsFilter): DiscoveryMetricsSummary;
+    clearPerformanceMetrics(): void;
+}
+export declare class UniversalMetadataService {
+    private static facade;
+    /**
+     * Replace the underlying facade (useful for testing custom dependencies)
+     */
+    static useFacade(facade: UniversalMetadataFacade): void;
+    /**
+     * Reset the facade back to default dependencies
+     */
+    static reset(): void;
+    static discoverAttributesForResourceType(resourceType: UniversalResourceType, options?: {
+        categories?: string[];
+        objectSlug?: string;
+        useCache?: boolean;
+        cacheTtl?: number;
+    }): Promise<Record<string, unknown>>;
+    static discoverTaskAttributes(options?: {
+        categories?: string[];
+    }): Promise<Record<string, unknown>>;
+    static getAttributesForRecord(resourceType: UniversalResourceType, recordId: string): Promise<Record<string, unknown>>;
+    static filterAttributesByCategory(attributes: Record<string, unknown> | unknown[], categories?: string[]): Record<string, unknown> | unknown[];
+    static getAttributes(params: UniversalAttributesParams): Promise<Record<string, unknown>>;
+    static discoverAttributes(resource_type: UniversalResourceType, options?: {
+        categories?: string[];
+        objectSlug?: string;
+    }): Promise<Record<string, unknown>>;
+    static getPerformanceMetrics(options?: MetricsFilter): DiscoveryMetricsSummary;
+    static clearPerformanceMetrics(): void;
+}
+export { UniversalMetadataFacade };
+//# sourceMappingURL=UniversalMetadataService.d.ts.map

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

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

package/dist/services/UniversalMetadataService.js

@@ -0,0 +1,215 @@
+/**
+ * UniversalMetadataService - Metadata orchestration facade
+ *
+ * Rebuilt for Issue #648 to delegate responsibilities to specialised metadata services
+ * while preserving the existing API surface for universal handlers.
+ */
+import { UniversalResourceType } from '../handlers/tool-configs/universal/types.js';
+import { getCompanyAttributes, discoverCompanyAttributes, } from '../objects/companies/index.js';
+import { getListAttributes } from '../objects/lists.js';
+import { createDefaultMetadataServices, } from './metadata/index.js';
+class UniversalMetadataFacade {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    get discoveryService() {
+        return this.deps.discoveryService;
+    }
+    get recordService() {
+        return this.deps.recordService;
+    }
+    get transformService() {
+        return this.deps.transformService;
+    }
+    get metricsService() {
+        return this.deps.metricsService;
+    }
+    async discoverAttributesForResourceType(resourceType, options) {
+        const discoverOptions = {
+            resourceType,
+            categories: options?.categories,
+            objectSlug: options?.objectSlug,
+            useCache: options?.useCache,
+            cacheTtl: options?.cacheTtl,
+        };
+        return this.discoveryService.discoverForType(discoverOptions);
+    }
+    async discoverTaskAttributes(options) {
+        return this.discoveryService.discoverTasks(options);
+    }
+    async getAttributesForRecord(resourceType, recordId) {
+        return this.recordService.getAttributesForRecord(resourceType, recordId);
+    }
+    filterAttributesByCategory(attributes, categories) {
+        return this.transformService.filterByCategory(attributes, categories);
+    }
+    async getAttributes(params) {
+        const { resource_type, record_id, categories } = params;
+        let result;
+        switch (resource_type) {
+            case UniversalResourceType.COMPANIES: {
+                if (record_id) {
+                    result = await getCompanyAttributes(record_id);
+                }
+                else {
+                    result = await discoverCompanyAttributes();
+                }
+                break;
+            }
+            case UniversalResourceType.PEOPLE: {
+                if (record_id) {
+                    result = await this.recordService.getAttributesForRecord(resource_type, record_id);
+                }
+                else {
+                    result = await this.discoverAttributesForResourceType(resource_type, {
+                        categories,
+                    });
+                }
+                break;
+            }
+            case UniversalResourceType.LISTS: {
+                result = await getListAttributes();
+                break;
+            }
+            case UniversalResourceType.RECORDS: {
+                if (record_id) {
+                    result = await this.recordService.getAttributesForRecord(resource_type, record_id);
+                }
+                else {
+                    result = await this.discoverAttributesForResourceType(resource_type, {
+                        categories,
+                    });
+                }
+                break;
+            }
+            case UniversalResourceType.DEALS: {
+                if (record_id) {
+                    result = await this.recordService.getAttributesForRecord(resource_type, record_id);
+                }
+                else {
+                    result = await this.discoverAttributesForResourceType(resource_type, {
+                        categories,
+                    });
+                }
+                break;
+            }
+            case UniversalResourceType.TASKS: {
+                if (record_id) {
+                    result = await this.recordService.getAttributesForRecord(resource_type, record_id);
+                }
+                else {
+                    result = await this.discoverAttributesForResourceType(resource_type, {
+                        categories,
+                    });
+                }
+                break;
+            }
+            default:
+                throw new Error(`Unsupported resource type for get attributes: ${resource_type}`);
+        }
+        const filtered = this.transformService.filterByCategory(result, categories);
+        return filtered;
+    }
+    async discoverAttributes(resource_type, options) {
+        switch (resource_type) {
+            case UniversalResourceType.COMPANIES: {
+                const res = await discoverCompanyAttributes();
+                if (!options?.categories?.length) {
+                    return res;
+                }
+                return this.transformService.filterByCategory(res, options.categories);
+            }
+            case UniversalResourceType.PEOPLE:
+                return this.discoverAttributesForResourceType(resource_type, options);
+            case UniversalResourceType.LISTS:
+                return getListAttributes();
+            case UniversalResourceType.RECORDS: {
+                if (options?.objectSlug) {
+                    return this.discoverAttributesForResourceType(resource_type, {
+                        categories: options.categories,
+                        objectSlug: options.objectSlug,
+                    });
+                }
+                return this.discoverAttributesForResourceType(resource_type, options);
+            }
+            case UniversalResourceType.DEALS: {
+                const baseResult = await this.discoverAttributesForResourceType(resource_type, options);
+                const { FIELD_MAPPINGS } = await import('../handlers/tool-configs/universal/field-mapper.js');
+                const dealsMapping = FIELD_MAPPINGS[UniversalResourceType.DEALS];
+                if (dealsMapping?.fieldMappings) {
+                    const mappings = {};
+                    Object.entries(dealsMapping.fieldMappings).forEach(([displayName, apiField]) => {
+                        if (apiField) {
+                            mappings[displayName] = apiField;
+                        }
+                    });
+                    mappings['Deal name'] = 'name';
+                    mappings['Deal stage'] = 'stage';
+                    mappings['Deal value'] = 'value';
+                    mappings['Associated company'] = 'associated_company';
+                    return {
+                        ...baseResult,
+                        mappings: {
+                            ...baseResult.mappings,
+                            ...mappings,
+                        },
+                        note: 'Use mappings to convert display names to API field names for create-record',
+                    };
+                }
+                return baseResult;
+            }
+            case UniversalResourceType.TASKS:
+                return this.discoverAttributesForResourceType(resource_type, options);
+            default:
+                throw new Error(`Unsupported resource type for discover attributes: ${resource_type}`);
+        }
+    }
+    getPerformanceMetrics(options) {
+        return this.metricsService.getMetrics(options);
+    }
+    clearPerformanceMetrics() {
+        this.metricsService.clear();
+    }
+}
+export class UniversalMetadataService {
+    static facade = new UniversalMetadataFacade(createDefaultMetadataServices());
+    /**
+     * Replace the underlying facade (useful for testing custom dependencies)
+     */
+    static useFacade(facade) {
+        this.facade = facade;
+    }
+    /**
+     * Reset the facade back to default dependencies
+     */
+    static reset() {
+        this.facade = new UniversalMetadataFacade(createDefaultMetadataServices());
+    }
+    static async discoverAttributesForResourceType(resourceType, options) {
+        return this.facade.discoverAttributesForResourceType(resourceType, options);
+    }
+    static async discoverTaskAttributes(options) {
+        return this.facade.discoverTaskAttributes(options);
+    }
+    static async getAttributesForRecord(resourceType, recordId) {
+        return this.facade.getAttributesForRecord(resourceType, recordId);
+    }
+    static filterAttributesByCategory(attributes, categories) {
+        return this.facade.filterAttributesByCategory(attributes, categories);
+    }
+    static async getAttributes(params) {
+        return this.facade.getAttributes(params);
+    }
+    static async discoverAttributes(resource_type, options) {
+        return this.facade.discoverAttributes(resource_type, options);
+    }
+    static getPerformanceMetrics(options) {
+        return this.facade.getPerformanceMetrics(options);
+    }
+    static clearPerformanceMetrics() {
+        this.facade.clearPerformanceMetrics();
+    }
+}
+export { UniversalMetadataFacade };
+//# sourceMappingURL=UniversalMetadataService.js.map

package/dist/services/UniversalMetadataService.js.map

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

package/dist/services/UniversalRetrievalService.d.ts

@@ -0,0 +1,70 @@
+/**
+ * UniversalRetrievalService - Centralized record retrieval operations
+ *
+ * Extracted from shared-handlers.ts as part of Issue #489 Phase 3.
+ * Provides universal record retrieval functionality across all resource types.
+ */
+import { UniversalResourceType } from '../handlers/tool-configs/universal/types.js';
+import type { UniversalRecordDetailsParams } from '../handlers/tool-configs/universal/types.js';
+import { AttioRecord } from '../types/attio.js';
+/**
+ * UniversalRetrievalService provides centralized record retrieval functionality
+ *
+ * **Type Safety Strategy**: This service employs Record<string, unknown> instead of any
+ * for handling dynamic API responses. This approach provides:
+ * - Compile-time type checking for known properties
+ * - Safe property access for unknown API data structures
+ * - Prevention of runtime errors from property misuse
+ *
+ * **Record<string, unknown> Benefits**: Unlike any, this type prevents accidental
+ * operations while maintaining flexibility for varied API response formats.
+ */
+export declare class UniversalRetrievalService {
+    /**
+     * Get record details across any supported resource type
+     *
+     * @param params - Retrieval operation parameters
+     * @returns Promise resolving to AttioRecord
+     */
+    static getRecordDetails(params: UniversalRecordDetailsParams): Promise<AttioRecord>;
+    /**
+     * Retrieve record by resource type with type-specific handling
+     */
+    private static retrieveRecordByType;
+    /**
+     * Retrieve list record with format conversion
+     */
+    private static retrieveListRecord;
+    /**
+     * Retrieve task record with conversion and error handling
+     */
+    private static retrieveTaskRecord;
+    /**
+     * Retrieve note record with normalization and error handling
+     */
+    private static retrieveNoteRecord;
+    /**
+     * Filter response fields to only include requested fields
+     */
+    private static filterResponseFields;
+    /**
+     * Check if a record exists (lightweight check)
+     */
+    static recordExists(resource_type: UniversalResourceType, record_id: string): Promise<boolean>;
+    /**
+     * Get multiple records with batch optimization
+     */
+    static getMultipleRecords(resource_type: UniversalResourceType, record_ids: string[], fields?: string[]): Promise<(AttioRecord | null)[]>;
+    /**
+     * Get record with performance metrics
+     */
+    static getRecordWithMetrics(params: UniversalRecordDetailsParams): Promise<{
+        record: AttioRecord;
+        metrics: {
+            duration: number;
+            cached: boolean;
+            source: 'cache' | 'live';
+        };
+    }>;
+}
+//# sourceMappingURL=UniversalRetrievalService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"UniversalRetrievalService.d.ts","sourceRoot":"","sources":["../../src/services/UniversalRetrievalService.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,6CAA6C,CAAC;AACpF,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,6CAA6C,CAAC;AAChG,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAiChD;;;;;;;;;;;GAWG;AACH,qBAAa,yBAAyB;IACpC;;;;;OAKG;WACU,gBAAgB,CAC3B,MAAM,EAAE,4BAA4B,GACnC,OAAO,CAAC,WAAW,CAAC;IAgPvB;;OAEG;mBACkB,oBAAoB;IAiCzC;;OAEG;mBACkB,kBAAkB;IA0FvC;;OAEG;mBACkB,kBAAkB;IAwFvC;;OAEG;mBACkB,kBAAkB;IA4DvC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAuDnC;;OAEG;WACU,YAAY,CACvB,aAAa,EAAE,qBAAqB,EACpC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC;IA8CnB;;OAEG;WACU,kBAAkB,CAC7B,aAAa,EAAE,qBAAqB,EACpC,UAAU,EAAE,MAAM,EAAE,EACpB,MAAM,CAAC,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC,CAAC,WAAW,GAAG,IAAI,CAAC,EAAE,CAAC;IAclC;;OAEG;WACU,oBAAoB,CAC/B,MAAM,EAAE,4BAA4B,GACnC,OAAO,CAAC;QACT,MAAM,EAAE,WAAW,CAAC;QACpB,OAAO,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,OAAO,CAAC;YAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAA;SAAE,CAAC;KAC1E,CAAC;CAqBH"}