attio-mcp 0.1.1 → 1.0.0

package/dist/utils/config-migration.js

@@ -2,8 +2,8 @@
  * Configuration migration utility for Attio MCP Server
  * Handles migration of user.json files to fix outdated mappings
  */
-import fs from 'fs';
-import path from 'path';
+import * as fs from 'fs';
+import * as path from 'path';
 import logger from './logger.js';
 /**
  * Known problematic mappings that need to be fixed
@@ -24,8 +24,8 @@ const MAPPINGS_TO_FIX = {
  * Paths for configuration files
  */
 const CONFIG_PATHS = {
-    user: path.resolve(process.cwd(), 'config/mappings/user.json'),
-    backup: path.resolve(process.cwd(), 'config/mappings/backup'),
+    user: path.resolve(process.cwd(), 'configs/runtime/mappings/user.json'),
+    backup: path.resolve(process.cwd(), 'configs/runtime/mappings/backup'),
 };
 /**
  * Detects if user.json needs migration for postal code mappings
@@ -43,7 +43,7 @@ const CONFIG_PATHS = {
  * ```typescript
  * const detection = detectMigrationNeeds();
  * if (detection.needsMigration) {
- *   console.log('Found outdated mappings:', detection.outdatedMappings);
+ *   console.error('Found outdated mappings:', detection.outdatedMappings);
  * }
  * ```
  */
@@ -95,7 +95,7 @@ export function detectMigrationNeeds() {
  * ```typescript
  * const backup = createBackup();
  * if (backup.success) {
- *   console.log('Backup created at:', backup.backupPath);
+ *   console.error('Backup created at:', backup.backupPath);
  * } else {
  *   console.error('Backup failed:', backup.error);
  * }
@@ -142,8 +142,8 @@ export function createBackup() {
  * ```typescript
  * const result = applyMigration();
  * if (result.success) {
- *   console.log('Migration completed:', result.message);
- *   console.log('Changes:', result.changesApplied);
+ *   console.error('Migration completed:', result.message);
+ *   console.error('Changes:', result.changesApplied);
  * } else {
  *   console.error('Migration failed:', result.message);
  * }
@@ -257,12 +257,12 @@ export function validateMigration() {
  * ```typescript
  * // Preview changes without applying
  * const preview = migrateUserConfig({ dryRun: true });
- * console.log('Would apply:', preview.changesApplied);
+ * console.error('Would apply:', preview.changesApplied);
  *
  * // Apply the migration
  * const result = migrateUserConfig();
  * if (result.success) {
- *   console.log('Migration completed successfully');
+ *   console.error('Migration completed successfully');
  * }
  * ```
  */

package/dist/utils/config-migration.js.map

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

package/dist/utils/date-parser.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Date parsing utilities for natural language date expressions
+ * Supports relative dates like "last week", "this month", etc.
+ */
+/**
+ * Supported relative date formats
+ */
+export declare enum RelativeDateFormat {
+    TODAY = "today",
+    YESTERDAY = "yesterday",
+    THIS_WEEK = "this week",
+    LAST_WEEK = "last week",
+    THIS_MONTH = "this month",
+    LAST_MONTH = "last month",
+    THIS_YEAR = "this year",
+    LAST_YEAR = "last year",
+    LAST_N_DAYS = "last {n} days",
+    LAST_N_WEEKS = "last {n} weeks",
+    LAST_N_MONTHS = "last {n} months"
+}
+/**
+ * Date range object for search operations
+ */
+export interface DateRange {
+    start: string;
+    end: string;
+}
+/**
+ * Parse a relative date expression into a date range
+ * @param expression Natural language date expression
+ * @returns DateRange object with start and end dates
+ * @throws Error if expression cannot be parsed
+ */
+export declare function parseRelativeDate(expression: string): DateRange;
+/**
+ * Check if a string is a relative date expression
+ * @param expression String to check
+ * @returns true if the string is a recognized relative date expression
+ */
+export declare function isRelativeDate(expression: string): boolean;
+/**
+ * Convert a date string or relative expression to ISO date format
+ * @param dateInput Date string or relative expression
+ * @returns ISO date string or null if invalid
+ */
+export declare function normalizeDate(dateInput: string): string | null;
+/**
+ * Get a human-readable description of a date range
+ * @param range DateRange object
+ * @returns Human-readable description
+ */
+export declare function describeDateRange(range: DateRange): string;
+//# sourceMappingURL=date-parser.d.ts.map

package/dist/utils/date-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-parser.d.ts","sourceRoot":"","sources":["../../src/utils/date-parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,oBAAY,kBAAkB;IAC5B,KAAK,UAAU;IACf,SAAS,cAAc;IACvB,SAAS,cAAc;IACvB,SAAS,cAAc;IACvB,UAAU,eAAe;IACzB,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,SAAS,cAAc;IACvB,WAAW,kBAAkB;IAC7B,YAAY,mBAAmB;IAC/B,aAAa,oBAAoB;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CA2K/D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAO1D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAqB9D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAoB1D"}

package/dist/utils/date-parser.js

@@ -0,0 +1,239 @@
+/**
+ * Date parsing utilities for natural language date expressions
+ * Supports relative dates like "last week", "this month", etc.
+ */
+/**
+ * Supported relative date formats
+ */
+export var RelativeDateFormat;
+(function (RelativeDateFormat) {
+    RelativeDateFormat["TODAY"] = "today";
+    RelativeDateFormat["YESTERDAY"] = "yesterday";
+    RelativeDateFormat["THIS_WEEK"] = "this week";
+    RelativeDateFormat["LAST_WEEK"] = "last week";
+    RelativeDateFormat["THIS_MONTH"] = "this month";
+    RelativeDateFormat["LAST_MONTH"] = "last month";
+    RelativeDateFormat["THIS_YEAR"] = "this year";
+    RelativeDateFormat["LAST_YEAR"] = "last year";
+    RelativeDateFormat["LAST_N_DAYS"] = "last {n} days";
+    RelativeDateFormat["LAST_N_WEEKS"] = "last {n} weeks";
+    RelativeDateFormat["LAST_N_MONTHS"] = "last {n} months";
+})(RelativeDateFormat || (RelativeDateFormat = {}));
+/**
+ * Parse a relative date expression into a date range
+ * @param expression Natural language date expression
+ * @returns DateRange object with start and end dates
+ * @throws Error if expression cannot be parsed
+ */
+export function parseRelativeDate(expression) {
+    const normalized = expression.toLowerCase().trim();
+    const now = new Date();
+    // Helper to format date as ISO string (YYYY-MM-DD)
+    const toISODate = (date) => {
+        return date.toISOString().split('T')[0];
+    };
+    // Helper to get start of day
+    const startOfDay = (date) => {
+        const d = new Date(date);
+        d.setHours(0, 0, 0, 0);
+        return d;
+    };
+    // Helper to get start of week (Monday)
+    const startOfWeek = (date) => {
+        const d = new Date(date);
+        const day = d.getDay();
+        const diff = d.getDate() - day + (day === 0 ? -6 : 1);
+        d.setDate(diff);
+        return startOfDay(d);
+    };
+    // Helper to get end of week (Sunday)
+    const endOfWeek = (date) => {
+        const d = new Date(date);
+        const day = d.getDay();
+        const diff = d.getDate() - day + (day === 0 ? 0 : 7);
+        d.setDate(diff);
+        return startOfDay(d);
+    };
+    // Helper to get start of month
+    const startOfMonth = (date) => {
+        const d = new Date(date);
+        d.setDate(1);
+        return startOfDay(d);
+    };
+    // Helper to get end of month (last day of month)
+    const endOfMonth = (date) => {
+        const d = new Date(date);
+        d.setMonth(d.getMonth() + 1, 0);
+        return startOfDay(d);
+    };
+    // Helper to get start of year
+    const startOfYear = (date) => {
+        const d = new Date(date);
+        d.setMonth(0, 1);
+        return startOfDay(d);
+    };
+    // Helper to get end of year
+    const endOfYear = (date) => {
+        const d = new Date(date);
+        d.setMonth(11, 31);
+        return startOfDay(d);
+    };
+    // Parse specific relative dates
+    switch (normalized) {
+        case 'today': {
+            const today = startOfDay(now);
+            return {
+                start: toISODate(today),
+                end: toISODate(today),
+            };
+        }
+        case 'yesterday': {
+            const yesterday = new Date(now);
+            yesterday.setDate(yesterday.getDate() - 1);
+            const startYesterday = startOfDay(yesterday);
+            return {
+                start: toISODate(startYesterday),
+                end: toISODate(startYesterday),
+            };
+        }
+        case 'this week': {
+            return {
+                start: toISODate(startOfWeek(now)),
+                end: toISODate(endOfWeek(now)),
+            };
+        }
+        case 'last week': {
+            const lastWeek = new Date(now);
+            lastWeek.setDate(lastWeek.getDate() - 7);
+            return {
+                start: toISODate(startOfWeek(lastWeek)),
+                end: toISODate(endOfWeek(lastWeek)),
+            };
+        }
+        case 'this month': {
+            return {
+                start: toISODate(startOfMonth(now)),
+                end: toISODate(endOfMonth(now)),
+            };
+        }
+        case 'last month': {
+            const lastMonth = new Date(now);
+            lastMonth.setMonth(lastMonth.getMonth() - 1);
+            return {
+                start: toISODate(startOfMonth(lastMonth)),
+                end: toISODate(endOfMonth(lastMonth)),
+            };
+        }
+        case 'this year': {
+            return {
+                start: toISODate(startOfYear(now)),
+                end: toISODate(endOfYear(now)),
+            };
+        }
+        case 'last year': {
+            const lastYear = new Date(now);
+            lastYear.setFullYear(lastYear.getFullYear() - 1);
+            return {
+                start: toISODate(startOfYear(lastYear)),
+                end: toISODate(endOfYear(lastYear)),
+            };
+        }
+    }
+    // Parse "last N days/weeks/months" patterns - handle spaces flexibly
+    const lastNDaysMatch = normalized.match(/^last\s+(\d+)\s+days?$/);
+    if (lastNDaysMatch) {
+        const days = parseInt(lastNDaysMatch[1], 10);
+        const startDate = new Date(now);
+        startDate.setDate(startDate.getDate() - days);
+        return {
+            start: toISODate(startOfDay(startDate)),
+            end: toISODate(startOfDay(now)),
+        };
+    }
+    const lastNWeeksMatch = normalized.match(/^last\s+(\d+)\s+weeks?$/);
+    if (lastNWeeksMatch) {
+        const weeks = parseInt(lastNWeeksMatch[1], 10);
+        const startDate = new Date(now);
+        startDate.setDate(startDate.getDate() - weeks * 7);
+        return {
+            start: toISODate(startOfDay(startDate)),
+            end: toISODate(startOfDay(now)),
+        };
+    }
+    const lastNMonthsMatch = normalized.match(/^last\s+(\d+)\s+months?$/);
+    if (lastNMonthsMatch) {
+        const months = parseInt(lastNMonthsMatch[1], 10);
+        const startDate = new Date(now);
+        startDate.setMonth(startDate.getMonth() - months);
+        return {
+            start: toISODate(startOfDay(startDate)),
+            end: toISODate(startOfDay(now)),
+        };
+    }
+    // If no pattern matches, throw an error
+    throw new Error(`Unable to parse relative date expression: "${expression}". ` +
+        `Supported formats: today, yesterday, this week, last week, this month, ` +
+        `last month, this year, last year, last N days/weeks/months`);
+}
+/**
+ * Check if a string is a relative date expression
+ * @param expression String to check
+ * @returns true if the string is a recognized relative date expression
+ */
+export function isRelativeDate(expression) {
+    try {
+        parseRelativeDate(expression);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Convert a date string or relative expression to ISO date format
+ * @param dateInput Date string or relative expression
+ * @returns ISO date string or null if invalid
+ */
+export function normalizeDate(dateInput) {
+    // Check if it's already an ISO date (YYYY-MM-DD)
+    const isoDateRegex = /^\d{4}-\d{2}-\d{2}$/;
+    if (isoDateRegex.test(dateInput)) {
+        return dateInput;
+    }
+    // Check if it's a relative date
+    if (isRelativeDate(dateInput)) {
+        const range = parseRelativeDate(dateInput);
+        // For single date context, return the start date
+        return range.start;
+    }
+    // Try to parse as a regular date
+    const date = new Date(dateInput);
+    if (!isNaN(date.getTime())) {
+        return date.toISOString().split('T')[0];
+    }
+    return null;
+}
+/**
+ * Get a human-readable description of a date range
+ * @param range DateRange object
+ * @returns Human-readable description
+ */
+export function describeDateRange(range) {
+    // Parse dates as local dates to avoid timezone issues
+    // Adding 'T00:00:00' ensures the date is interpreted in local time
+    const start = new Date(range.start + 'T00:00:00');
+    const end = new Date(range.end + 'T00:00:00');
+    const formatDate = (date) => {
+        return date.toLocaleDateString('en-US', {
+            year: 'numeric',
+            month: 'short',
+            day: 'numeric',
+        });
+    };
+    // Check if it's a single day
+    if (range.start === range.end) {
+        return formatDate(start);
+    }
+    return `${formatDate(start)} to ${formatDate(end)}`;
+}
+//# sourceMappingURL=date-parser.js.map

package/dist/utils/date-parser.js.map

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

package/dist/utils/date-utils.d.ts

@@ -60,4 +60,17 @@ export declare function createRelativeDateRange(value: number, unit: RelativeDat
  * @returns Formatted date string
  */
 export declare function formatDate(dateString: string, format?: 'short' | 'long' | 'relative'): string;
+/**
+ * Validates and creates a date range object for API requests
+ * Ensures dates are properly formatted and handles missing values gracefully
+ *
+ * @param startDate - Optional start date (ISO string or empty)
+ * @param endDate - Optional end date (ISO string or empty)
+ * @returns Validated date range object or throws error
+ * @throws Error when dates are invalid or illogical
+ */
+export declare function validateAndCreateDateRange(startDate?: string, endDate?: string): {
+    start?: string;
+    end?: string;
+} | null;
 //# sourceMappingURL=date-utils.d.ts.map

package/dist/utils/date-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"date-utils.d.ts","sourceRoot":"","sources":["../../src/utils/date-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,SAAS,EAEV,MAAM,mBAAmB,CAAC;AAE3B;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM,CAiEtE;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb,CA+GA;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CA8FA;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAShE;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,gBAAgB,GACrB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CA6BhC;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,OAAO,GAAG,MAAM,GAAG,UAAoB,GAC9C,MAAM,CA2BR"}
+{"version":3,"file":"date-utils.d.ts","sourceRoot":"","sources":["../../src/utils/date-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,SAAS,EAEV,MAAM,mBAAmB,CAAC;AAO3B;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM,CAiEtE;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb,CAmHA;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CA0HA;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAchE;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,gBAAgB,GACrB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CA6BhC;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,OAAO,GAAG,MAAM,GAAG,UAAoB,GAC9C,MAAM,CA4BR;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GACf;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAiEzC"}

package/dist/utils/date-utils.js

@@ -3,6 +3,7 @@
  * Provides functions for handling date ranges, relative dates, and date formatting.
  */
 import { RelativeDateUnit, DateRangePreset, } from '../types/attio.js';
+import { isRelativeDate, parseRelativeDate, normalizeDate, } from './date-parser.js';
 /**
  * Converts a relative date (e.g., "last 7 days") to an absolute ISO date string
  *
@@ -94,17 +95,19 @@ export function createDateRangeFromPreset(preset) {
             start.setDate(today.getDate() - 1);
             end.setDate(today.getDate() - 1);
             break;
-        case DateRangePreset.THIS_WEEK:
+        case DateRangePreset.THIS_WEEK: {
             // Set start to beginning of current week (Sunday)
             const dayOfWeek = today.getDay(); // 0 = Sunday, 6 = Saturday
             start.setDate(today.getDate() - dayOfWeek);
             break;
-        case DateRangePreset.LAST_WEEK:
+        }
+        case DateRangePreset.LAST_WEEK: {
             // Set start to beginning of last week
             const lastWeekDay = today.getDay();
             start.setDate(today.getDate() - lastWeekDay - 7);
             end.setDate(today.getDate() - lastWeekDay - 1);
             break;
+        }
         case DateRangePreset.THIS_MONTH:
             // Set start to beginning of current month
             start.setDate(1);
@@ -115,13 +118,14 @@ export function createDateRangeFromPreset(preset) {
             start.setDate(1);
             end = new Date(today.getFullYear(), today.getMonth(), 0, 23, 59, 59, 999);
             break;
-        case DateRangePreset.THIS_QUARTER:
+        case DateRangePreset.THIS_QUARTER: {
             // Set start to beginning of current quarter
             const currentQuarter = Math.floor(today.getMonth() / 3);
             start.setMonth(currentQuarter * 3);
             start.setDate(1);
             break;
-        case DateRangePreset.LAST_QUARTER:
+        }
+        case DateRangePreset.LAST_QUARTER: {
             // Set start to beginning of last quarter
             const lastQuarter = Math.floor(today.getMonth() / 3) - 1;
             const lastQuarterYear = lastQuarter < 0 ? today.getFullYear() - 1 : today.getFullYear();
@@ -129,6 +133,7 @@ export function createDateRangeFromPreset(preset) {
             start = new Date(lastQuarterYear, normalizedLastQuarter * 3, 1);
             end = new Date(lastQuarterYear, (normalizedLastQuarter + 1) * 3, 0, 23, 59, 59, 999);
             break;
+        }
         case DateRangePreset.THIS_YEAR:
             // Set start to beginning of current year
             start.setMonth(0);
@@ -176,6 +181,11 @@ export function resolveDateRange(dateRange) {
                 console.warn('DateRange contains both preset and start/end specifications. ' +
                     'Using preset and ignoring explicit start/end values.');
             }
+            // First try to parse as a relative date expression (e.g., "last 7 days", "this month")
+            if (isRelativeDate(dateRange.preset)) {
+                return parseRelativeDate(dateRange.preset);
+            }
+            // Otherwise use the standard preset resolution
             const presetRange = createDateRangeFromPreset(dateRange.preset);
             return presetRange;
         }
@@ -189,12 +199,25 @@ export function resolveDateRange(dateRange) {
     if (dateRange.start) {
         try {
             if (typeof dateRange.start === 'string') {
-                // Validate ISO date string format
-                if (!isValidISODateString(dateRange.start)) {
-                    throw new Error(`Invalid ISO date string format: ${dateRange.start}`);
+                // First try to parse as a relative date expression (e.g., "last 7 days")
+                if (isRelativeDate(dateRange.start)) {
+                    const relativeRange = parseRelativeDate(dateRange.start);
+                    result.start = relativeRange.start;
+                }
+                // Then check if it's a valid ISO date string
+                else if (isValidISODateString(dateRange.start)) {
+                    result.start = dateRange.start;
+                }
+                // Otherwise try to normalize it as a natural language date
+                else {
+                    const normalized = normalizeDate(dateRange.start);
+                    if (normalized) {
+                        result.start = normalized;
+                    }
+                    else {
+                        throw new Error(`Unable to parse date: ${dateRange.start}`);
+                    }
                 }
-                // Direct ISO string
-                result.start = dateRange.start;
             }
             else {
                 // Relative date object
@@ -210,12 +233,25 @@ export function resolveDateRange(dateRange) {
     if (dateRange.end) {
         try {
             if (typeof dateRange.end === 'string') {
-                // Validate ISO date string format
-                if (!isValidISODateString(dateRange.end)) {
-                    throw new Error(`Invalid ISO date string format: ${dateRange.end}`);
+                // First try to parse as a relative date expression (e.g., "last 7 days")
+                if (isRelativeDate(dateRange.end)) {
+                    const relativeRange = parseRelativeDate(dateRange.end);
+                    result.end = relativeRange.end;
+                }
+                // Then check if it's a valid ISO date string
+                else if (isValidISODateString(dateRange.end)) {
+                    result.end = dateRange.end;
+                }
+                // Otherwise try to normalize it as a natural language date
+                else {
+                    const normalized = normalizeDate(dateRange.end);
+                    if (normalized) {
+                        result.end = normalized;
+                    }
+                    else {
+                        throw new Error(`Unable to parse date: ${dateRange.end}`);
+                    }
                 }
-                // Direct ISO string
-                result.end = dateRange.end;
             }
             else {
                 // Relative date object
@@ -245,8 +281,11 @@ export function resolveDateRange(dateRange) {
  * @returns True if the string is a valid ISO date, false otherwise
  */
 export function isValidISODateString(dateString) {
-    // Check basic format
-    if (!/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{3})?Z$/.test(dateString)) {
+    // Accept both full ISO format and date-only format
+    // Full ISO: 2025-08-01T00:00:00.000Z
+    // Date only: 2025-08-01
+    if (!/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{3})?Z$/.test(dateString) &&
+        !/^\d{4}-\d{2}-\d{2}$/.test(dateString)) {
         return false;
     }
     // Check if it's a valid date
@@ -307,7 +346,7 @@ export function formatDate(dateString, format = 'short') {
                 month: 'long',
                 day: 'numeric',
             });
-        case 'relative':
+        case 'relative': {
             const now = new Date();
             const diffMs = now.getTime() - date.getTime();
             const diffDays = Math.floor(diffMs / (1000 * 60 * 60 * 24));
@@ -322,8 +361,62 @@ export function formatDate(dateString, format = 'short') {
             if (diffDays < 365)
                 return `${Math.floor(diffDays / 30)} months ago`;
             return `${Math.floor(diffDays / 365)} years ago`;
+        }
         default:
             return date.toISOString();
     }
 }
+/**
+ * Validates and creates a date range object for API requests
+ * Ensures dates are properly formatted and handles missing values gracefully
+ *
+ * @param startDate - Optional start date (ISO string or empty)
+ * @param endDate - Optional end date (ISO string or empty)
+ * @returns Validated date range object or throws error
+ * @throws Error when dates are invalid or illogical
+ */
+export function validateAndCreateDateRange(startDate, endDate) {
+    // If both dates are missing or empty, return null (no date filtering)
+    if ((!startDate || startDate.trim() === '') &&
+        (!endDate || endDate.trim() === '')) {
+        return null;
+    }
+    const result = {};
+    // Validate and process start date
+    if (startDate && startDate.trim() !== '') {
+        const trimmedStart = startDate.trim();
+        if (!isValidISODateString(trimmedStart)) {
+            throw new Error(`Invalid start date format. Expected ISO 8601 format (YYYY-MM-DDTHH:mm:ss.sssZ), got: "${trimmedStart}"`);
+        }
+        result.start = trimmedStart;
+    }
+    // Validate and process end date
+    if (endDate && endDate.trim() !== '') {
+        const trimmedEnd = endDate.trim();
+        if (!isValidISODateString(trimmedEnd)) {
+            throw new Error(`Invalid end date format. Expected ISO 8601 format (YYYY-MM-DDTHH:mm:ss.sssZ), got: "${trimmedEnd}"`);
+        }
+        result.end = trimmedEnd;
+    }
+    // If only one date is provided, it's still valid for open-ended ranges
+    if ((result.start && !result.end) || (!result.start && result.end)) {
+        createScopedLogger('utils.date-utils', 'parseDateRange').info('Creating open-ended date range', { start: result.start, end: result.end });
+    }
+    // Validate logical consistency if both dates are provided
+    if (result.start && result.end) {
+        const startDate = new Date(result.start);
+        const endDate = new Date(result.end);
+        if (startDate > endDate) {
+            throw new Error(`Invalid date range: start date (${result.start}) must be before or equal to end date (${result.end})`);
+        }
+        // Warn if the date range is suspiciously large
+        const diffMs = endDate.getTime() - startDate.getTime();
+        const diffYears = diffMs / (1000 * 60 * 60 * 24 * 365);
+        if (diffYears > 10) {
+            console.warn(`Large date range detected: ${diffYears.toFixed(1)} years. This may impact performance.`);
+        }
+    }
+    return result;
+}
+import { createScopedLogger } from './logger.js';
 //# sourceMappingURL=date-utils.js.map