@iflow-mcp/attio-mcp 1.3.6

package/dist/utils/filters/timeframe-utils.js

@@ -0,0 +1,429 @@
+/**
+ * Timeframe utility functions for converting relative timeframes to date ranges
+ *
+ * This module provides type-safe date range conversion for the Attio MCP Server
+ * timeframe search functionality. All operations use UTC timezone to ensure
+ * consistent behavior across different environments.
+ *
+ * Key Features:
+ * - Type-safe relative timeframe conversion
+ * - UTC timezone handling for consistency
+ * - ISO 8601 date format output
+ * - Comprehensive validation and error handling
+ *
+ * @example
+ * ```typescript
+ * const range = getRelativeTimeframeRange('last_7_days');
+ * // Returns: { startDate: '2024-01-01T00:00:00.000Z', endDate: '2024-01-08T23:59:59.999Z' }
+ * ```
+ */
+/**
+ * Converts a relative timeframe to an absolute date range
+ * All dates are returned in ISO 8601 format
+ *
+ * @param timeframe - The relative timeframe to convert
+ * @param timezone - Optional timezone (defaults to UTC)
+ * @returns Date range with startDate and endDate in ISO format
+ */
+export function getRelativeTimeframeRange(timeframe, 
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+_timezone = 'UTC') {
+    const now = new Date();
+    let startDate;
+    let endDate;
+    switch (timeframe) {
+        case 'today':
+            startDate = getStartOfDay(now);
+            endDate = getEndOfDay(now);
+            break;
+        case 'yesterday': {
+            const yesterday = new Date(now);
+            yesterday.setUTCDate(yesterday.getUTCDate() - 1);
+            startDate = getStartOfDay(yesterday);
+            endDate = getEndOfDay(yesterday);
+            break;
+        }
+        case 'this_week':
+            startDate = getStartOfWeek(now);
+            endDate = getEndOfDay(now);
+            break;
+        case 'last_week': {
+            const lastWeekStart = new Date(now);
+            lastWeekStart.setUTCDate(now.getUTCDate() - 7);
+            startDate = getStartOfWeek(lastWeekStart);
+            const lastWeekEnd = new Date(startDate);
+            lastWeekEnd.setUTCDate(startDate.getUTCDate() + 6);
+            endDate = getEndOfDay(lastWeekEnd);
+            break;
+        }
+        case 'this_month':
+            startDate = getStartOfMonth(now);
+            endDate = getEndOfDay(now);
+            break;
+        case 'last_month': {
+            const lastMonth = new Date(now);
+            lastMonth.setUTCMonth(lastMonth.getUTCMonth() - 1);
+            startDate = getStartOfMonth(lastMonth);
+            endDate = getEndOfMonth(lastMonth);
+            break;
+        }
+        case 'last_7_days': {
+            const weekAgo = new Date(now);
+            weekAgo.setUTCDate(weekAgo.getUTCDate() - 7);
+            startDate = getStartOfDay(weekAgo);
+            endDate = getEndOfDay(now);
+            break;
+        }
+        case 'last_14_days': {
+            const twoWeeksAgo = new Date(now);
+            twoWeeksAgo.setUTCDate(twoWeeksAgo.getUTCDate() - 14);
+            startDate = getStartOfDay(twoWeeksAgo);
+            endDate = getEndOfDay(now);
+            break;
+        }
+        case 'last_30_days': {
+            const monthAgo = new Date(now);
+            monthAgo.setUTCDate(monthAgo.getUTCDate() - 30);
+            startDate = getStartOfDay(monthAgo);
+            endDate = getEndOfDay(now);
+            break;
+        }
+        case 'last_90_days': {
+            const quarterAgo = new Date(now);
+            quarterAgo.setUTCDate(quarterAgo.getUTCDate() - 90);
+            startDate = getStartOfDay(quarterAgo);
+            endDate = getEndOfDay(now);
+            break;
+        }
+        default:
+            throw new Error(`Unsupported timeframe: ${timeframe}`);
+    }
+    return {
+        startDate: startDate.toISOString(),
+        endDate: endDate.toISOString(),
+    };
+}
+/**
+ * Validates if a string is a valid ISO 8601 date
+ *
+ * @param dateString - The date string to validate
+ * @returns True if valid ISO date, false otherwise
+ */
+export function isValidISODate(dateString) {
+    if (!dateString || typeof dateString !== 'string') {
+        return false;
+    }
+    const date = new Date(dateString);
+    return !isNaN(date.getTime()) && dateString.includes('T');
+}
+/**
+ * Validates a date range to ensure start comes before end
+ *
+ * @param startDate - Start date in ISO format
+ * @param endDate - End date in ISO format
+ * @returns True if valid range, false otherwise
+ */
+export function isValidDateRange(startDate, endDate) {
+    if (!isValidISODate(startDate) || !isValidISODate(endDate)) {
+        return false;
+    }
+    const start = new Date(startDate);
+    const end = new Date(endDate);
+    return start <= end;
+}
+/**
+ * Converts user-friendly date parameters to Attio API timeframe query parameters
+ *
+ * @param params - User date parameters
+ * @returns Attio API compatible parameters
+ */
+export function convertDateParamsToTimeframeQuery(params) {
+    const { date_from, date_to, created_after, created_before, updated_after, updated_before, timeframe, date_field = 'created_at', } = params;
+    // If relative timeframe is specified, use it (overrides absolute dates)
+    if (timeframe) {
+        const range = getRelativeTimeframeRange(timeframe);
+        return {
+            timeframe_attribute: date_field,
+            start_date: range.startDate,
+            end_date: range.endDate,
+            date_operator: 'between',
+        };
+    }
+    // Handle date_from/date_to range
+    if (date_from && date_to) {
+        if (!isValidDateRange(date_from, date_to)) {
+            throw new Error('Invalid date range: start date must be before end date');
+        }
+        return {
+            timeframe_attribute: date_field,
+            start_date: date_from,
+            end_date: date_to,
+            date_operator: 'between',
+        };
+    }
+    // Handle single date bounds
+    if (date_from && !date_to) {
+        if (!isValidISODate(date_from)) {
+            throw new Error('Invalid date_from format: must be ISO 8601');
+        }
+        return {
+            timeframe_attribute: date_field,
+            start_date: date_from,
+            date_operator: 'greater_than',
+        };
+    }
+    if (date_to && !date_from) {
+        if (!isValidISODate(date_to)) {
+            throw new Error('Invalid date_to format: must be ISO 8601');
+        }
+        return {
+            timeframe_attribute: date_field,
+            end_date: date_to,
+            date_operator: 'less_than',
+        };
+    }
+    // Handle created_at specific filters
+    if (created_after || created_before) {
+        if (created_after && created_before) {
+            if (!isValidDateRange(created_after, created_before)) {
+                throw new Error('Invalid created date range: created_after must be before created_before');
+            }
+            return {
+                timeframe_attribute: 'created_at',
+                start_date: created_after,
+                end_date: created_before,
+                date_operator: 'between',
+            };
+        }
+        else if (created_after) {
+            if (!isValidISODate(created_after)) {
+                throw new Error('Invalid created_after format: must be ISO 8601');
+            }
+            return {
+                timeframe_attribute: 'created_at',
+                start_date: created_after,
+                date_operator: 'greater_than',
+            };
+        }
+        else if (created_before) {
+            if (!isValidISODate(created_before)) {
+                throw new Error('Invalid created_before format: must be ISO 8601');
+            }
+            return {
+                timeframe_attribute: 'created_at',
+                end_date: created_before,
+                date_operator: 'less_than',
+            };
+        }
+    }
+    // Handle updated_at specific filters
+    if (updated_after || updated_before) {
+        if (updated_after && updated_before) {
+            if (!isValidDateRange(updated_after, updated_before)) {
+                throw new Error('Invalid updated date range: updated_after must be before updated_before');
+            }
+            return {
+                timeframe_attribute: 'updated_at',
+                start_date: updated_after,
+                end_date: updated_before,
+                date_operator: 'between',
+            };
+        }
+        else if (updated_after) {
+            if (!isValidISODate(updated_after)) {
+                throw new Error('Invalid updated_after format: must be ISO 8601');
+            }
+            return {
+                timeframe_attribute: 'updated_at',
+                start_date: updated_after,
+                date_operator: 'greater_than',
+            };
+        }
+        else if (updated_before) {
+            if (!isValidISODate(updated_before)) {
+                throw new Error('Invalid updated_before format: must be ISO 8601');
+            }
+            return {
+                timeframe_attribute: 'updated_at',
+                end_date: updated_before,
+                date_operator: 'less_than',
+            };
+        }
+    }
+    return null; // No date parameters provided
+}
+// Helper functions for date calculations (all in UTC)
+function getStartOfDay(date) {
+    const result = new Date(date);
+    result.setUTCHours(0, 0, 0, 0);
+    return result;
+}
+function getEndOfDay(date) {
+    const result = new Date(date);
+    result.setUTCHours(23, 59, 59, 999);
+    return result;
+}
+function getStartOfWeek(date) {
+    const result = new Date(date);
+    const day = result.getUTCDay();
+    const diff = result.getUTCDate() - day + (day === 0 ? -6 : 1); // Adjust when day is Sunday
+    result.setUTCDate(diff);
+    return getStartOfDay(result);
+}
+function getStartOfMonth(date) {
+    const result = new Date(date);
+    result.setUTCDate(1);
+    return getStartOfDay(result);
+}
+function getEndOfMonth(date) {
+    const result = new Date(date);
+    result.setUTCMonth(result.getUTCMonth() + 1, 0); // Last day of current month
+    return getEndOfDay(result);
+}
+/**
+ * Validates a relative timeframe string against supported options
+ *
+ * @param timeframe - The timeframe string to validate
+ * @returns Validation result with error details if invalid
+ *
+ * @example
+ * ```typescript
+ * const result = validateTimeframe('last_7_days');
+ * if (result.isValid) {
+ *   console.log('Valid timeframe:', result.normalizedTimeframe);
+ * } else {
+ *   console.error('Invalid timeframe:', result.error);
+ * }
+ * ```
+ */
+export function validateTimeframe(timeframe) {
+    const supportedTimeframes = [
+        'today',
+        'yesterday',
+        'this_week',
+        'last_week',
+        'this_month',
+        'last_month',
+        'last_7_days',
+        'last_14_days',
+        'last_30_days',
+        'last_90_days',
+    ];
+    if (!timeframe || typeof timeframe !== 'string') {
+        return {
+            isValid: false,
+            error: 'Timeframe must be a non-empty string',
+        };
+    }
+    const normalizedString = timeframe.toLowerCase().trim();
+    // Check for empty string after trimming
+    if (normalizedString === '') {
+        return {
+            isValid: false,
+            error: 'Timeframe must be a non-empty string',
+        };
+    }
+    const normalizedTimeframe = normalizedString;
+    if (!supportedTimeframes.includes(normalizedTimeframe)) {
+        return {
+            isValid: false,
+            error: `Unsupported timeframe '${timeframe}'. Supported options: ${supportedTimeframes.join(', ')}`,
+        };
+    }
+    return {
+        isValid: true,
+        normalizedTimeframe,
+    };
+}
+/**
+ * Validates that a date range is logical (start before end)
+ *
+ * @param startDate - Start date in ISO 8601 format
+ * @param endDate - End date in ISO 8601 format
+ * @returns true if range is valid, false otherwise
+ *
+ * @example
+ * ```typescript
+ * const isValid = validateDateRange('2024-01-01', '2024-01-31');
+ * // Returns: true
+ * ```
+ */
+export function validateDateRange(startDate, endDate) {
+    try {
+        const start = new Date(startDate);
+        const end = new Date(endDate);
+        if (isNaN(start.getTime()) || isNaN(end.getTime())) {
+            return false;
+        }
+        return start <= end;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Enhanced timeframe parameter conversion with comprehensive validation
+ *
+ * This function provides better error handling and type safety compared to
+ * the basic convertTimeframeParams function.
+ *
+ * @param params - Search parameters potentially containing date/timeframe fields
+ * @returns Validated timeframe query parameters or detailed error
+ *
+ * @throws {Error} With descriptive error messages for invalid parameters
+ */
+export function convertTimeframeParamsWithValidation(params) {
+    const timeframe = params.timeframe;
+    const dateField = params.date_field || 'created_at';
+    // Validate relative timeframe if provided
+    if (timeframe) {
+        const validation = validateTimeframe(timeframe);
+        if (!validation.isValid) {
+            throw new Error(`Timeframe validation failed: ${validation.error}`);
+        }
+        const range = getRelativeTimeframeRange(validation.normalizedTimeframe);
+        return {
+            timeframe_attribute: dateField,
+            start_date: range.startDate,
+            end_date: range.endDate,
+            date_operator: 'between',
+        };
+    }
+    // Validate absolute date ranges
+    const dateFrom = params.date_from;
+    const dateTo = params.date_to;
+    if (dateFrom && dateTo) {
+        if (!validateDateRange(dateFrom, dateTo)) {
+            throw new Error('Date parameter validation failed: start date must be before end date and both must be valid ISO 8601 dates');
+        }
+        return {
+            timeframe_attribute: dateField,
+            start_date: dateFrom,
+            end_date: dateTo,
+            date_operator: 'between',
+        };
+    }
+    // Handle single date bounds with validation
+    if (dateFrom) {
+        if (!isValidISODate(dateFrom)) {
+            throw new Error('Date parameter validation failed: date_from must be a valid ISO 8601 date');
+        }
+        return {
+            timeframe_attribute: dateField,
+            start_date: dateFrom,
+            date_operator: 'greater_than',
+        };
+    }
+    if (dateTo) {
+        if (!isValidISODate(dateTo)) {
+            throw new Error('Date parameter validation failed: date_to must be a valid ISO 8601 date');
+        }
+        return {
+            timeframe_attribute: dateField,
+            end_date: dateTo,
+            date_operator: 'less_than',
+        };
+    }
+    throw new Error('No valid timeframe or date parameters provided');
+}
+//# sourceMappingURL=timeframe-utils.js.map

package/dist/utils/filters/timeframe-utils.js.map

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

package/dist/utils/filters/translators.d.ts

@@ -0,0 +1,68 @@
+/**
+ * @module translators
+ *
+ * Filter translation utilities for converting between formats
+ * Handles transformation between MCP filter format and Attio API format
+ *
+ * This module provides:
+ * - MCP to Attio API format transformation
+ * - Support for AND/OR logical operators
+ * - Operator conversion utilities
+ * - Attribute name transformations
+ * - Reverse transformation (API to MCP)
+ */
+import { ListEntryFilters, ListEntryFilter, AttioApiFilter, AttioQueryApiFilter, FilterConditionType } from './types.js';
+export declare function transformFiltersToApiFormat(filters: ListEntryFilters | undefined, validateConditions?: boolean, isListEntryContext?: boolean, resourceType?: string): Promise<{
+    filter?: AttioApiFilter;
+}>;
+/**
+ * Transforms list entry filters to the new Query API format with path and constraints
+ *
+ * This function creates the proper Attio Query API structure as required by Issue #523.
+ * Uses path-based filtering with constraints for relationship, content, and timeframe searches.
+ *
+ * @param filters - Filter configuration from the MCP API
+ * @param validateConditions - Whether to validate condition types
+ * @returns Query API formatted filter object
+ * @throws FilterValidationError if validation fails
+ */
+export declare function transformFiltersToQueryApiFormat(filters: ListEntryFilters | undefined, validateConditions?: boolean): AttioQueryApiFilter;
+/**
+ * Converts a single filter operator to API format
+ *
+ * @param operator - The operator to convert (e.g., 'equals', 'contains')
+ * @returns The operator in API format (e.g., '$eq', '$contains')
+ */
+export declare function convertOperatorToApiFormat(operator: string): string;
+/**
+ * Transforms attribute names if they require special handling
+ *
+ * @param attributeSlug - The attribute slug to transform
+ * @returns The transformed attribute name
+ */
+export declare function transformAttributeName(attributeSlug: string): string;
+/**
+ * Processes a filter value for API submission
+ * Handles any special value transformations needed
+ *
+ * @param value - The value to process
+ * @param condition - The filter condition being used
+ * @returns The processed value
+ */
+export declare function processFilterValue(value: unknown, condition: FilterConditionType): unknown;
+/**
+ * Transforms a simple filter to API format
+ *
+ * @param filter - The filter to transform
+ * @returns API-formatted filter object
+ */
+export declare function transformSingleFilterToApi(filter: ListEntryFilter): AttioApiFilter;
+/**
+ * Converts API filter format back to MCP filter format
+ * Useful for debugging and reverse transformation
+ *
+ * @param apiFilter - API format filter
+ * @returns MCP format filters
+ */
+export declare function transformApiFormatToFilters(apiFilter: AttioApiFilter): ListEntryFilters;
+//# sourceMappingURL=translators.d.ts.map

package/dist/utils/filters/translators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translators.d.ts","sourceRoot":"","sources":["../../../src/utils/filters/translators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAUH,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EAEpB,MAAM,YAAY,CAAC;AAkIpB,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,gBAAgB,GAAG,SAAS,EACrC,kBAAkB,GAAE,OAAc,EAClC,kBAAkB,GAAE,OAAe,EACnC,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC;IAAE,MAAM,CAAC,EAAE,cAAc,CAAA;CAAE,CAAC,CAkGtC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,gBAAgB,GAAG,SAAS,EACrC,kBAAkB,GAAE,OAAc,GACjC,mBAAmB,CAqGrB;AAgbD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGnE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAOpE;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,mBAAmB,GAC7B,OAAO,CAaT;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,eAAe,GACtB,cAAc,CAoBhB;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,cAAc,GACxB,gBAAgB,CA6ClB"}