@iflow-mcp/attio-mcp 1.3.6

package/dist/api/client-strategies.js

@@ -0,0 +1,218 @@
+/**
+ * Client creation strategies for different environments
+ * Implements strategy pattern to handle production, E2E, and test modes
+ */
+import axios from 'axios';
+import { debug } from '../utils/logger.js';
+import { configureStandardInterceptors } from './client-interceptors.js';
+import { ClientMode, EnvironmentModeHandler, } from './client-config.js';
+import { isAttioErrorData } from './types.js';
+/**
+ * Base strategy with common client setup logic
+ */
+class BaseClientStrategy {
+    /**
+     * Creates the base Axios instance with common configuration
+     */
+    createBaseClient(config) {
+        const client = axios.create({
+            baseURL: config.baseURL || EnvironmentModeHandler.getDefaultBaseURL(),
+            timeout: config.timeout || EnvironmentModeHandler.getStandardTimeout(),
+            headers: {
+                Authorization: `Bearer ${config.apiKey}`,
+                'Content-Type': 'application/json',
+                Accept: 'application/json',
+            },
+            // Preserve raw server JSON response
+            transformResponse: [
+                (data) => {
+                    try {
+                        return JSON.parse(data);
+                    }
+                    catch {
+                        return data;
+                    }
+                },
+            ],
+            validateStatus: (status) => status >= 200 && status < 300,
+        });
+        this.configureErrorHandling(client);
+        return client;
+    }
+    /**
+     * Configure standard error handling for Attio API responses
+     */
+    configureErrorHandling(client) {
+        client.interceptors.response.use((response) => response, (error) => {
+            const data = error?.response?.data;
+            if (isAttioErrorData(data)) {
+                // Mirror serverData onto the error so wrappers can preserve it
+                const attioError = error;
+                attioError.serverData = {
+                    status_code: data.status_code ?? error.response?.status,
+                    type: data.type,
+                    code: data.code,
+                    message: data.message,
+                };
+                return Promise.reject(attioError);
+            }
+            return Promise.reject(error);
+        });
+    }
+    /**
+     * Configure interceptors based on provided configuration
+     */
+    configureInterceptors(client, interceptorConfig) {
+        if (!interceptorConfig)
+            return;
+        debug('client-strategies', 'Configuring client interceptors', {
+            prefix: interceptorConfig.prefix,
+            enableDiagnostics: interceptorConfig.enableDiagnostics,
+            enableErrorHandling: interceptorConfig.enableErrorHandling,
+        });
+        configureStandardInterceptors(client, interceptorConfig);
+    }
+}
+/**
+ * Production client strategy - full interceptors, standard configuration
+ */
+export class ProductionClientStrategy extends BaseClientStrategy {
+    createClient(config) {
+        debug('client-strategies', 'Creating production client', {
+            hasApiKey: Boolean(config.apiKey),
+            baseURL: config.baseURL,
+            timeout: config.timeout,
+        });
+        const client = this.createBaseClient(config);
+        this.configureInterceptors(client, config.interceptors);
+        return client;
+    }
+    getDefaultConfig() {
+        return {
+            mode: ClientMode.PRODUCTION,
+            timeout: EnvironmentModeHandler.getStandardTimeout(),
+            interceptors: {
+                prefix: '',
+                enableDiagnostics: true,
+                enableErrorHandling: true,
+            },
+        };
+    }
+}
+/**
+ * E2E client strategy - full interceptors with E2E prefix
+ */
+export class E2EClientStrategy extends BaseClientStrategy {
+    createClient(config) {
+        debug('client-strategies', 'Creating E2E client', {
+            hasApiKey: Boolean(config.apiKey),
+            baseURL: config.baseURL,
+            mode: config.mode,
+        });
+        const client = this.createBaseClient(config);
+        this.configureInterceptors(client, config.interceptors);
+        return client;
+    }
+    getDefaultConfig() {
+        return {
+            mode: ClientMode.E2E,
+            timeout: EnvironmentModeHandler.getStandardTimeout(),
+            interceptors: {
+                prefix: 'E2E',
+                enableDiagnostics: true,
+                enableErrorHandling: true,
+            },
+        };
+    }
+}
+/**
+ * E2E Raw client strategy - minimal interceptors for raw testing
+ */
+export class E2ERawClientStrategy extends BaseClientStrategy {
+    createClient(config) {
+        debug('client-strategies', 'Creating E2E raw client', {
+            hasApiKey: Boolean(config.apiKey),
+            baseURL: config.baseURL,
+        });
+        // Create minimal client for raw E2E testing
+        const client = this.createBaseClient(config);
+        this.configureInterceptors(client, config.interceptors);
+        return client;
+    }
+    getDefaultConfig() {
+        return {
+            mode: ClientMode.E2E_RAW,
+            timeout: EnvironmentModeHandler.getStandardTimeout(),
+            interceptors: {
+                prefix: 'E2E-RAW',
+                enableDiagnostics: true,
+                enableErrorHandling: true,
+            },
+        };
+    }
+}
+/**
+ * Test client strategy - minimal logging, optimized for test performance
+ */
+export class TestClientStrategy extends BaseClientStrategy {
+    createClient(config) {
+        debug('client-strategies', 'Creating test client', {
+            hasApiKey: Boolean(config.apiKey),
+            baseURL: config.baseURL,
+        });
+        const client = this.createBaseClient(config);
+        this.configureInterceptors(client, config.interceptors);
+        return client;
+    }
+    getDefaultConfig() {
+        return {
+            mode: ClientMode.TEST,
+            timeout: EnvironmentModeHandler.getStandardTimeout(),
+            interceptors: {
+                prefix: 'TEST',
+                enableDiagnostics: false,
+                enableErrorHandling: true,
+            },
+        };
+    }
+}
+/**
+ * Strategy factory - determines the appropriate strategy based on mode
+ */
+export class ClientStrategyFactory {
+    static strategies = new Map([
+        [ClientMode.PRODUCTION, new ProductionClientStrategy()],
+        [ClientMode.E2E, new E2EClientStrategy()],
+        [ClientMode.E2E_RAW, new E2ERawClientStrategy()],
+        [ClientMode.TEST, new TestClientStrategy()],
+    ]);
+    /**
+     * Get the appropriate strategy for the given mode
+     */
+    static getStrategy(mode) {
+        const strategy = this.strategies.get(mode);
+        if (!strategy) {
+            throw new Error(`Unsupported client mode: ${mode}`);
+        }
+        return strategy;
+    }
+    /**
+     * Create a client using the appropriate strategy
+     */
+    static createClient(config) {
+        const mode = config.mode || EnvironmentModeHandler.determineMode();
+        const strategy = this.getStrategy(mode);
+        // Merge strategy defaults with provided config
+        const defaultConfig = strategy.getDefaultConfig();
+        const mergedConfig = {
+            ...defaultConfig,
+            ...config,
+            interceptors: {
+                ...defaultConfig.interceptors,
+                ...config.interceptors,
+            },
+        };
+        return strategy.createClient(mergedConfig);
+    }
+}
+//# sourceMappingURL=client-strategies.js.map

package/dist/api/client-strategies.js.map

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

package/dist/api/client.d.ts

@@ -0,0 +1,3 @@
+import type { AxiosInstance } from 'axios';
+export declare function createAttioApiClient(baseURL: string, apiKey: string): AxiosInstance;
+//# sourceMappingURL=client.d.ts.map

package/dist/api/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EAKd,MAAM,OAAO,CAAC;AAWf,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,aAAa,CA0Ff"}

package/dist/api/client.js

@@ -0,0 +1,85 @@
+import axios from 'axios';
+import { enhanceApiError } from '../utils/error-enhancer.js';
+import { createScopedLogger, OperationType } from '../utils/logger.js';
+const MAX_RETRIES = 3;
+const RETRY_DELAY_MS = 1000;
+export function createAttioApiClient(baseURL, apiKey) {
+    const instance = axios.create({
+        baseURL,
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            'Content-Type': 'application/json',
+            Accept: 'application/json',
+        },
+    });
+    instance.interceptors.response.use((response) => response, async (error) => {
+        const log = createScopedLogger('api.client', 'responseInterceptor', OperationType.API_CALL);
+        // Enhanced logging to inspect the error object thoroughly
+        log.error('Raw error received by interceptor', error, {
+            isAxiosError: axios.isAxiosError(error),
+        });
+        if (axios.isAxiosError(error)) {
+            const axiosError = error;
+            log.debug('Axios error config', {
+                config: axiosError.config,
+            });
+            // console.error('[Interceptor] Axios error request:', axiosError.request); // Often large, skip for brevity unless needed
+            log.error('Axios error response details', undefined, {
+                status: axiosError.response?.status,
+                headers: axiosError.response?.headers,
+                data: axiosError.response?.data,
+            });
+            if (axiosError.response) {
+                log.error('API Error', axiosError, {
+                    status: axiosError.response.status,
+                    method: axiosError.config?.method?.toUpperCase(),
+                    url: axiosError.config?.url,
+                });
+                // console.error('[Interceptor] Full error.response object:', JSON.stringify(axiosError.response)); // Can be very verbose
+                const config = (axiosError.config ??
+                    {});
+                const { status } = axiosError.response;
+                // Attempt to enhance the error first
+                const enhancedError = enhanceApiError(axiosError); // Pass the original AxiosError
+                config.retryCount = config.retryCount || 0;
+                // Only retry network errors, 429 (throttling), and 5xx server errors
+                // Never retry 4xx client errors (400, 401, 403, 404, etc.) except 429
+                const shouldRetry = !status || status === 429 || status >= 500;
+                if (config.retryCount < MAX_RETRIES && shouldRetry) {
+                    config.retryCount++;
+                    const target = config.url ?? '(unknown url)';
+                    log.warn('Retrying request due to error status', {
+                        retryCount: config.retryCount,
+                        maxRetries: MAX_RETRIES,
+                        target,
+                        status,
+                    });
+                    // Exponential backoff with jitter to prevent thundering herd
+                    const baseDelay = RETRY_DELAY_MS * Math.pow(2, config.retryCount - 1);
+                    const jitter = Math.floor(Math.random() * 300); // 0-300ms jitter
+                    const totalDelay = Math.min(baseDelay + jitter, 5000); // Cap at 5s
+                    await new Promise((resolve) => setTimeout(resolve, totalDelay));
+                    // Convert InternalAxiosRequestConfig to AxiosRequestConfig before retrying
+                    const retryConfig = { ...config };
+                    return instance.request(retryConfig);
+                }
+                return Promise.reject(enhancedError); // Reject with the potentially enhanced error
+            }
+        }
+        else {
+            log.error('Non-Axios error structure', error);
+        }
+        // Fallback for non-Axios errors or Axios errors without a response
+        return Promise.reject(error);
+    });
+    return instance;
+}
+// Example of creating a default client (ensure env variables are set up)
+// const defaultBaseURL = process.env.ATTIO_API_BASE_URL || 'https://api.attio.com/v2';
+// const defaultApiKey = process.env.ATTIO_API_KEY;
+// if (!defaultApiKey) {
+//   console.warn('ATTIO_API_KEY is not set. Default Attio API client will not be functional.');
+// }
+// export const attio = defaultApiKey ? createAttioApiClient(defaultBaseURL, defaultApiKey) : null;
+// If you had a global Attio instance like this, re-add it. For now, just exporting the factory.
+//# sourceMappingURL=client.js.map

package/dist/api/client.js.map

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

package/dist/api/lazy-client.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Enhanced lazy client - uses unified client architecture
+ * Provides lazy initialization with caching and context management
+ */
+import { AxiosInstance } from 'axios';
+import { ClientConfig } from './client-config.js';
+export declare function getLazyAttioClient(config?: ClientConfig): AxiosInstance;
+export declare function setGlobalContext(context: Record<string, unknown>): void;
+export declare function clearClientCache(): void;
+export declare function getGlobalContext(): Record<string, unknown> | null;
+//# sourceMappingURL=lazy-client.d.ts.map

package/dist/api/lazy-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy-client.d.ts","sourceRoot":"","sources":["../../src/api/lazy-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAItC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,aAAa,CAgBvE;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAEvE;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAEjE"}

package/dist/api/lazy-client.js

@@ -0,0 +1,32 @@
+/**
+ * Enhanced lazy client - uses unified client architecture
+ * Provides lazy initialization with caching and context management
+ */
+import { createAttioClient } from './attio-client.js';
+import { ClientCache, clearAllCaches } from './client-cache.js';
+import { getClientContext, setClientContext } from './client-context.js';
+export function getLazyAttioClient(config) {
+    // Check if we have a cached client
+    const cachedClient = ClientCache.getInstance();
+    if (cachedClient && !config?.bypassCache) {
+        return cachedClient;
+    }
+    // Create new client using unified interface
+    const client = createAttioClient(config || {});
+    // Cache the client for future use
+    if (!config?.bypassCache) {
+        ClientCache.setInstance(client);
+    }
+    return client;
+}
+export function setGlobalContext(context) {
+    setClientContext(context);
+}
+export function clearClientCache() {
+    // Use unified cache clearing
+    clearAllCaches();
+}
+export function getGlobalContext() {
+    return getClientContext();
+}
+//# sourceMappingURL=lazy-client.js.map

package/dist/api/lazy-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy-client.js","sourceRoot":"","sources":["../../src/api/lazy-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGzE,MAAM,UAAU,kBAAkB,CAAC,MAAqB;IACtD,mCAAmC;IACnC,MAAM,YAAY,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC;IAC/C,IAAI,YAAY,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC;QACzC,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,4CAA4C;IAC5C,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IAE/C,kCAAkC;IAClC,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC;QACzB,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAgC;IAC/D,gBAAgB,CAAC,OAAO,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,6BAA6B;IAC7B,cAAc,EAAE,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,gBAAgB,EAAE,CAAC;AAC5B,CAAC"}

package/dist/api/operations/batch.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Batch operations for Attio API
+ * Handles bulk operations with chunking and error handling
+ * Includes DoS protection through size and payload validation
+ * Enhanced for Issue #471: Batch Search Operations Support
+ */
+import { AttioRecord, ResourceType, RecordBatchCreateParams, RecordBatchUpdateParams } from '../../types/attio.js';
+import { BatchRequestItem, BatchResponse, BatchConfig } from './types.js';
+import { RetryConfig } from './retry.js';
+import { UniversalResourceType } from '../../handlers/tool-configs/universal/types.js';
+/**
+ * Creates multiple records in a batch operation
+ * Includes validation for batch size and payload to prevent DoS
+ *
+ * @param params - Batch record creation parameters
+ * @param retryConfig - Optional retry configuration
+ * @returns Array of created records
+ * @throws Error if batch size or payload exceeds limits
+ */
+export declare function batchCreateRecords<T extends AttioRecord>(params: RecordBatchCreateParams, retryConfig?: Partial<RetryConfig>): Promise<T[]>;
+/**
+ * Updates multiple records in a batch operation
+ * Includes validation for batch size and payload to prevent DoS
+ *
+ * @param params - Batch record update parameters
+ * @param retryConfig - Optional retry configuration
+ * @returns Array of updated records
+ * @throws Error if batch size or payload exceeds limits
+ */
+export declare function batchUpdateRecords<T extends AttioRecord>(params: RecordBatchUpdateParams, retryConfig?: Partial<RetryConfig>): Promise<T[]>;
+/**
+ * Default batch configuration with security limits
+ */
+export declare const DEFAULT_BATCH_CONFIG: BatchConfig;
+/**
+ * Execute a batch of operations with chunking, error handling, and retry support
+ * Includes validation for batch size to prevent DoS attacks
+ *
+ * @param operations - Array of operations to process in batch
+ * @param apiCall - Function that processes a single operation
+ * @param config - Batch configuration options
+ * @returns Batch response with individual results and summary
+ * @throws Error if batch size exceeds security limits
+ */
+export declare function executeBatchOperations<T, R>(operations: BatchRequestItem<T>[], apiCall: (params: T) => Promise<R>, config?: Partial<BatchConfig>): Promise<BatchResponse<R>>;
+/**
+ * Generic function to perform batch searches for any object type
+ * Includes validation for query count to prevent DoS
+ *
+ * @param objectType - Type of object to search (people or companies)
+ * @param queries - Array of search query strings
+ * @param batchConfig - Optional batch configuration
+ * @returns Batch response with search results
+ * @throws Error if query count exceeds limits
+ */
+export declare function batchSearchObjects<T extends AttioRecord>(objectType: ResourceType, queries: string[], batchConfig?: Partial<BatchConfig>): Promise<BatchResponse<T[]>>;
+/**
+ * Generic function to get details for multiple records of any object type
+ * Includes validation for ID count to prevent DoS
+ *
+ * @param objectType - Type of object to get details for (people or companies)
+ * @param recordIds - Array of record IDs to fetch
+ * @param batchConfig - Optional batch configuration
+ * @returns Batch response with record details
+ * @throws Error if ID count exceeds limits
+ */
+export declare function batchGetObjectDetails<T extends AttioRecord>(objectType: ResourceType, recordIds: string[], batchConfig?: Partial<BatchConfig>): Promise<BatchResponse<T>>;
+/**
+ * Universal batch search interface for Issue #471
+ * Returns results in the format expected by universal tools with error isolation
+ */
+export interface UniversalBatchSearchResult {
+    success: boolean;
+    query: string;
+    result?: AttioRecord[];
+    error?: string;
+}
+/**
+ * Enhanced batch search for universal tools with error isolation
+ * Supports all universal resource types and returns formatted results
+ *
+ * @param resourceType - Universal resource type to search
+ * @param queries - Array of search query strings
+ * @param searchParams - Additional search parameters (limit, offset, filters)
+ * @param batchConfig - Optional batch configuration
+ * @returns Array of search results with error isolation
+ * @throws Error if validation fails
+ */
+export declare function universalBatchSearch(resourceType: UniversalResourceType, queries: string[], searchParams?: {
+    limit?: number;
+    offset?: number;
+    filters?: Record<string, unknown>;
+}, batchConfig?: Partial<BatchConfig>): Promise<UniversalBatchSearchResult[]>;
+/**
+ * Enhanced batch get details for universal tools
+ * Supports all universal resource types with error isolation
+ *
+ * @param resourceType - Universal resource type
+ * @param recordIds - Array of record IDs to fetch
+ * @param batchConfig - Optional batch configuration
+ * @returns Array of get results with error isolation
+ */
+export declare function universalBatchGetDetails(resourceType: UniversalResourceType, recordIds: string[], batchConfig?: Partial<BatchConfig>): Promise<Array<{
+    success: boolean;
+    recordId: string;
+    result?: AttioRecord;
+    error?: string;
+}>>;
+//# sourceMappingURL=batch.d.ts.map

package/dist/api/operations/batch.d.ts.map

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