attio-mcp 0.1.1 → 1.0.0

package/dist/utils/filters/utils.js

@@ -2,8 +2,9 @@
  * General filter utility functions
  * Consolidates utilities from filter-utils.ts and filter-utils-additions.ts
  */
-import { ATTRIBUTES, FilterConditionType, } from './types.js';
+import { ATTRIBUTES } from './types.js';
 import { resolveDateRange } from '../date-utils.js';
+import { debug, OperationType } from '../logger.js';
 /**
  * Creates a filter for records based on their creation date
  *
@@ -22,25 +23,8 @@ export function createCreatedDateFilter(dateRange) {
 export function createModifiedDateFilter(dateRange) {
     return createDateRangeFilter(ATTRIBUTES.UPDATED_AT, dateRange);
 }
-/**
- * Creates a filter for B2B Segment (type_persona)
- *
- * @param value - B2B Segment value to filter by
- * @returns Configured filter object
- */
-export function createB2BSegmentFilter(value) {
-    // Using a simple equals filter that will be transformed using the shorthand format
-    return {
-        filters: [
-            {
-                attribute: { slug: 'type_persona' },
-                condition: FilterConditionType.EQUALS, // This won't be used for type_persona due to shorthand format
-                value,
-            },
-        ],
-        matchAny: false,
-    };
-}
+// Note: createB2BSegmentFilter removed as type_persona field doesn't exist in Attio API
+// For custom segment fields, use createEqualsFilter() with the appropriate field name
 /**
  * Validates if a value falls within a numeric range
  *
@@ -89,9 +73,7 @@ export function isInDateRange(dateStr, range) {
  * @param details - Additional details to log
  */
 export function debugFilterLog(operation, details) {
-    if (process.env.NODE_ENV === 'development') {
-        console.log(`[Filter ${operation}]`, details);
-    }
+    debug('utils/filters/utils', `Filter operation: ${operation}`, { operation, details }, 'debugFilterLog', OperationType.DATA_PROCESSING);
 }
 /**
  * Determines if a filter attribute represents a date field
@@ -127,12 +109,62 @@ export function isTextAttribute(attributeSlug) {
     const textAttributes = [
         ATTRIBUTES.NAME,
         ATTRIBUTES.EMAIL,
-        ATTRIBUTES.WEBSITE,
         ATTRIBUTES.NOTE_CONTENT,
-        ATTRIBUTES.INDUSTRY,
     ];
     return textAttributes.includes(attributeSlug);
 }
+/**
+ * List-specific attributes that are stored directly on list entries
+ * These attributes are not part of the parent record but are specific to the list context
+ */
+const LIST_SPECIFIC_ATTRIBUTES = [
+    'stage',
+    'Stage',
+    'status',
+    'Status',
+    'priority',
+    'Priority',
+    'score',
+    'Score',
+    'rating',
+    'Rating',
+    'lead_rating',
+    'Lead Rating',
+    'value',
+    'Value',
+    'notes',
+    'Notes',
+    'list_notes',
+    'List Notes',
+];
+/**
+ * Determines if an attribute is list-specific (stored on the list entry itself)
+ * rather than on the parent record (company, person, etc.)
+ *
+ * @param attributeSlug - The attribute slug to check
+ * @returns True if the attribute is list-specific
+ */
+export function isListSpecificAttribute(attributeSlug) {
+    // Check if it's in our known list-specific attributes
+    if (LIST_SPECIFIC_ATTRIBUTES.includes(attributeSlug)) {
+        return true;
+    }
+    // Check if it's a UUID (attribute IDs are list-specific)
+    const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+    if (uuidRegex.test(attributeSlug)) {
+        return true;
+    }
+    // Check for common patterns in list-specific attribute names
+    const listPatterns = [
+        /^list[_\s]/i,
+        /[_\s]stage$/i,
+        /[_\s]status$/i,
+        /[_\s]priority$/i,
+        /[_\s]score$/i,
+        /[_\s]rating$/i,
+    ];
+    return listPatterns.some((pattern) => pattern.test(attributeSlug));
+}
 /**
  * Helper function to extract attribute mappings as needed
  * Re-exports builder functions as utilities for backward compatibility

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

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

package/dist/utils/filters/validation-utils.d.ts

@@ -61,7 +61,7 @@ export declare function validateFiltersObject(filters: ListEntryFilters | undefi
 export declare function collectInvalidFilters(filters: ListEntryFilter[], validateConditions?: boolean): {
     index: number;
     reason: string;
-    filter: any;
+    filter: unknown;
 }[];
 /**
  * Creates a consistently formatted error message for invalid filters
@@ -72,7 +72,7 @@ export declare function collectInvalidFilters(filters: ListEntryFilter[], valida
 export declare function formatInvalidFiltersError(invalidFilters: {
     index: number;
     reason: string;
-    filter: any;
+    filter: unknown;
 }[]): string;
 /**
  * Full validation of filters with detailed error messages and examples
@@ -112,7 +112,7 @@ export declare function validateFilters(filters: ListEntryFilters | undefined, v
  * @param filter - The filter to analyze
  * @returns A string describing what's wrong with the filter
  */
-export declare function getInvalidFilterReason(filter: any): string;
+export declare function getInvalidFilterReason(filter: unknown): string;
 /**
  * Generate examples for different filter scenarios
  *

package/dist/utils/filters/validation-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation-utils.d.ts","sourceRoot":"","sources":["../../../src/utils/filters/validation-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAG1E;;GAEG;AACH,eAAO,MAAM,cAAc;;8BAEC,MAAM;;;sCAIE,MAAM,UAAU,MAAM;;;;mCAKzB,MAAM,mBAAmB,MAAM,EAAE;;CAMjE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe;;;;CAuC3B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,gBAAgB,GAAG,SAAS,GACpC,yBAAyB,CA2B3B;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,eAAe,EAAE,EAC1B,kBAAkB,GAAE,OAAc,GACjC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,GAAG,CAAA;CAAE,EAAE,CAyDlD;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,cAAc,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,GAAG,CAAA;CAAE,EAAE,GAC/D,MAAM,CAUR;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,gBAAgB,GAAG,SAAS,EACrC,kBAAkB,GAAE,OAAc,GACjC,yBAAyB,CA4C3B;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CAsB1D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,GAAE,QAAQ,GAAG,IAAI,GAAG,UAAqB,GAClD,MAAM,CAUR"}
+{"version":3,"file":"validation-utils.d.ts","sourceRoot":"","sources":["../../../src/utils/filters/validation-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAG1E;;GAEG;AACH,eAAO,MAAM,cAAc;;8BAEC,MAAM;;;sCAqBE,MAAM,UAAU,MAAM;;;;mCAKzB,MAAM,mBAAmB,MAAM,EAAE;;CAMjE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe;;;;CAuC3B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,gBAAgB,GAAG,SAAS,GACpC,yBAAyB,CA2B3B;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,eAAe,EAAE,EAC1B,kBAAkB,GAAE,OAAc,GACjC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,EAAE,CA0DtD;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,cAAc,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,EAAE,GACnE,MAAM,CAUR;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,gBAAgB,GAAG,SAAS,EACrC,kBAAkB,GAAE,OAAc,GACjC,yBAAyB,CAgD3B;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAwB9D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,GAAE,QAAQ,GAAG,IAAI,GAAG,UAAqB,GAClD,MAAM,CAUR"}

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

@@ -11,8 +11,25 @@ import { isValidFilterCondition } from '../../types/attio.js';
  */
 export const ERROR_MESSAGES = {
     MISSING_FILTERS: 'Filter object is required but was undefined or null',
-    FILTERS_NOT_ARRAY: (type) => `Invalid filter structure: 'filters' property must be an array but got ${type}`,
-    MISSING_FILTERS_PROPERTY: 'Filters must include a "filters" array property',
+    FILTERS_NOT_ARRAY: (type) => `Invalid filter structure: 'filters' property must be an array but got ${type}.
+
+Expected format:
+{
+  "filters": [
+    {"attribute": {"slug": "field_name"}, "condition": "contains", "value": "search_term"}
+  ]
+}`,
+    MISSING_FILTERS_PROPERTY: `Invalid filter format. Expected structure:
+{
+  "filters": [
+    {"attribute": {"slug": "field_name"}, "condition": "contains", "value": "search_term"}
+  ]
+}
+
+Common mistake: Using object format instead of array format. 
+Received an object without a "filters" array property.
+
+See documentation for more examples.`,
     EMPTY_FILTERS_ARRAY: 'No filters provided in the filters array',
     INVALID_FILTER_STRUCTURE: (index, reason) => `Invalid filter structure at index ${index}: ${reason}`,
     MISSING_ATTRIBUTE: 'missing attribute object',
@@ -25,7 +42,7 @@ export const ERROR_MESSAGES = {
  * Standard example format for filter structures to include in error messages
  */
 export const FILTER_EXAMPLES = {
-    SIMPLE: `{
+    SIMPLE: `{ 
   "filters": [
     {
       "attribute": { "slug": "name" },
@@ -34,7 +51,7 @@ export const FILTER_EXAMPLES = {
     }
   ]
 }`,
-    OR_LOGIC: `{
+    OR_LOGIC: `{ 
   "filters": [
     {
       "attribute": { "slug": "name" },
@@ -42,14 +59,14 @@ export const FILTER_EXAMPLES = {
       "value": "Inc"
     },
     {
-      "attribute": { "slug": "industry" },
-      "condition": "equals",
+      "attribute": { "slug": "description" },
+      "condition": "contains",
       "value": "Technology"
     }
   ],
   "matchAny": true
 }`,
-    MULTIPLE_CONDITIONS: `{
+    MULTIPLE_CONDITIONS: `{ 
   "filters": [
     {
       "attribute": { "slug": "name" },
@@ -57,7 +74,7 @@ export const FILTER_EXAMPLES = {
       "value": "Inc"
     },
     {
-      "attribute": { "slug": "website" },
+      "attribute": { "slug": "domains" },
       "condition": "contains",
       "value": ".com"
     }
@@ -217,9 +234,12 @@ export function validateFilters(filters, validateConditions = true) {
     if (invalidFilters.length === validatedFilters.filters.length) {
         const errorDetails = formatInvalidFiltersError(invalidFilters);
         let errorMessage = `${ERROR_MESSAGES.ALL_FILTERS_INVALID} ${errorDetails}`;
-        // Add examples to help the user fix their filters
+        // Add examples to help the user fix their filters - show relevant example based on context
+        const relevantExample = invalidFilters.length > 1
+            ? FILTER_EXAMPLES.MULTIPLE_CONDITIONS
+            : FILTER_EXAMPLES.SIMPLE;
         errorMessage +=
-            '\n\nExample of valid filter structure: \n' + FILTER_EXAMPLES.SIMPLE;
+            '\n\nExample of valid filter structure: \n' + relevantExample;
         // Determine most appropriate error category based on invalid filters
         let category = FilterErrorCategory.STRUCTURE;
         // If we have specific attribute issues
@@ -248,17 +268,18 @@ export function getInvalidFilterReason(filter) {
     if (!filter || typeof filter !== 'object') {
         return `filter is ${filter === null ? 'null' : typeof filter}`;
     }
-    if (!filter.attribute) {
+    const filterObj = filter;
+    if (!filterObj.attribute) {
         return ERROR_MESSAGES.MISSING_ATTRIBUTE;
     }
-    if (!filter.attribute.slug) {
+    if (!filterObj.attribute.slug) {
         return ERROR_MESSAGES.MISSING_ATTRIBUTE_SLUG;
     }
-    if (!filter.condition) {
+    if (!filterObj.condition) {
         return ERROR_MESSAGES.MISSING_CONDITION;
     }
-    if (!isValidFilterCondition(filter.condition)) {
-        return `invalid condition '${filter.condition}'`;
+    if (!isValidFilterCondition(filterObj.condition)) {
+        return `invalid condition '${filterObj.condition}'`;
     }
     return 'unknown issue';
 }

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

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

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

@@ -27,7 +27,7 @@ export declare function validateFilterStructure(filter: ListEntryFilter): boolea
  * @returns Validated and normalized date range
  * @throws FilterValidationError if validation fails
  */
-export declare function validateDateRange(dateRange: any): DateRange;
+export declare function validateDateRange(dateRange: Record<string, unknown> | string | null | undefined): DateRange;
 /**
  * Validates an activity filter object
  *
@@ -35,7 +35,7 @@ export declare function validateDateRange(dateRange: any): DateRange;
  * @returns Validated and normalized activity filter
  * @throws FilterValidationError if validation fails
  */
-export declare function validateActivityFilter(activityFilter: any): ActivityFilter;
+export declare function validateActivityFilter(activityFilter: Record<string, unknown> | string | null | undefined): ActivityFilter;
 /**
  * Validates a numeric range object
  *
@@ -43,7 +43,7 @@ export declare function validateActivityFilter(activityFilter: any): ActivityFil
  * @returns Validated and normalized numeric range
  * @throws FilterValidationError if validation fails
  */
-export declare function validateNumericRange(range: any): NumericRange;
+export declare function validateNumericRange(range: Record<string, unknown> | string | null | undefined): NumericRange;
 /**
  * Validates a filter condition string
  *
@@ -61,7 +61,7 @@ export declare function validateFilterCondition(condition: string): FilterCondit
  * @returns The validated number
  * @throws FilterValidationError if validation fails
  */
-export declare function validateNumericParam(value: any, paramName: string, defaultValue?: number): number;
+export declare function validateNumericParam(value: unknown, paramName: string, defaultValue?: number): number;
 /**
  * Validates filter structure and conditions
  *

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

@@ -1 +1 @@
-{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../../src/utils/filters/validators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAQH,OAAO,EACL,SAAS,EACT,cAAc,EAEd,YAAY,EACZ,mBAAmB,EACnB,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAcxE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,GAAG,GAAG,SAAS,CAoJ3D;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,cAAc,EAAE,GAAG,GAAG,cAAc,CA2D1E;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,GAAG,GAAG,YAAY,CAgF7D;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,GAChB,mBAAmB,CAerB;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,GAAG,EACV,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAcR;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,eAAe,EACvB,kBAAkB,GAAE,OAAc,GACjC,IAAI,CAgBN"}
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../../src/utils/filters/validators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAQH,OAAO,EACL,SAAS,EACT,cAAc,EAEd,YAAY,EACZ,mBAAmB,EACnB,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAcxE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAC7D,SAAS,CA6IX;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAClE,cAAc,CA6EhB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GACzD,YAAY,CAuFd;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,GAChB,mBAAmB,CAerB;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAcR;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,eAAe,EACvB,kBAAkB,GAAE,OAAc,GACjC,IAAI,CAgBN"}

package/dist/utils/filters/validators.js

@@ -48,59 +48,64 @@ export function validateDateRange(dateRange) {
         throw new FilterValidationError('Date range is required');
     }
     // Normalize dateRange if it's a string
+    let parsedDateRange;
     if (typeof dateRange === 'string') {
         try {
-            dateRange = JSON.parse(dateRange);
+            parsedDateRange = JSON.parse(dateRange);
         }
         catch (error) {
             throw new FilterValidationError(`Invalid date range format: ${error instanceof Error ? error.message : String(error)}`);
         }
     }
+    else {
+        parsedDateRange = dateRange;
+    }
     // Check if it's a proper object
-    if (typeof dateRange !== 'object' || Array.isArray(dateRange)) {
+    if (typeof parsedDateRange !== 'object' ||
+        Array.isArray(parsedDateRange) ||
+        parsedDateRange === null) {
         throw new FilterValidationError('Date range must be an object with start, end, or preset properties');
     }
     // Must have at least one of preset, start, or end
-    if (!dateRange.preset && !dateRange.start && !dateRange.end) {
+    if (!parsedDateRange.preset &&
+        !parsedDateRange.start &&
+        !parsedDateRange.end) {
         throw new FilterValidationError('Date range must specify at least one of: preset, start, or end');
     }
     // Validate preset if provided
-    if (dateRange.preset) {
-        const normalizedPreset = typeof dateRange.preset === 'string'
-            ? dateRange.preset.toLowerCase().trim()
-            : String(dateRange.preset);
+    if (parsedDateRange.preset) {
+        const normalizedPreset = typeof parsedDateRange.preset === 'string'
+            ? parsedDateRange.preset.toLowerCase().trim()
+            : String(parsedDateRange.preset);
         const validPresets = Object.values(DateRangePreset);
         if (!validPresets.includes(normalizedPreset)) {
-            throw new FilterValidationError(`Invalid date preset: "${dateRange.preset}". ` +
+            throw new FilterValidationError(`Invalid date preset: "${parsedDateRange.preset}". ` +
                 `Valid presets are: ${validPresets.join(', ')}`);
         }
         // Normalize the preset to ensure proper casing
-        dateRange.preset = normalizedPreset;
+        parsedDateRange.preset = normalizedPreset;
     }
     // Validate start date if provided
-    if (dateRange.start) {
-        if (typeof dateRange.start === 'string') {
+    if (parsedDateRange.start) {
+        if (typeof parsedDateRange.start === 'string') {
             // Validate ISO string format
-            if (!isValidISODateString(dateRange.start)) {
-                throw new FilterValidationError(`Invalid ISO date string format for start date: ${dateRange.start}`);
+            if (!isValidISODateString(parsedDateRange.start)) {
+                throw new FilterValidationError(`Invalid ISO date string format for start date: ${parsedDateRange.start}`);
             }
         }
-        else if (typeof dateRange.start === 'object' &&
-            !Array.isArray(dateRange.start)) {
+        else if (typeof parsedDateRange.start === 'object' &&
+            !Array.isArray(parsedDateRange.start)) {
             // It's a relative date object, validate basic structure
-            if (!dateRange.start.unit ||
-                !dateRange.start.value ||
-                !dateRange.start.direction) {
+            const startObj = parsedDateRange.start;
+            if (!startObj.unit || !startObj.value || !startObj.direction) {
                 throw new FilterValidationError('Relative start date must have unit, value, and direction properties');
             }
             // Validate value is a number
-            if (typeof dateRange.start.value !== 'number' ||
-                isNaN(dateRange.start.value)) {
+            if (typeof startObj.value !== 'number' || isNaN(startObj.value)) {
                 throw new FilterValidationError('Relative date value must be a number');
             }
             // Validate direction
-            if (dateRange.start.direction !== 'past' &&
-                dateRange.start.direction !== 'future') {
+            if (startObj.direction !== 'past' && startObj.direction !== 'future') {
                 throw new FilterValidationError('Relative date direction must be either "past" or "future"');
             }
         }
@@ -109,29 +114,26 @@ export function validateDateRange(dateRange) {
         }
     }
     // Validate end date if provided
-    if (dateRange.end) {
-        if (typeof dateRange.end === 'string') {
+    if (parsedDateRange.end) {
+        if (typeof parsedDateRange.end === 'string') {
             // Validate ISO string format
-            if (!isValidISODateString(dateRange.end)) {
-                throw new FilterValidationError(`Invalid ISO date string format for end date: ${dateRange.end}`);
+            if (!isValidISODateString(parsedDateRange.end)) {
+                throw new FilterValidationError(`Invalid ISO date string format for end date: ${parsedDateRange.end}`);
             }
         }
-        else if (typeof dateRange.end === 'object' &&
-            !Array.isArray(dateRange.end)) {
+        else if (typeof parsedDateRange.end === 'object' &&
+            !Array.isArray(parsedDateRange.end)) {
             // It's a relative date object, validate basic structure
-            if (!dateRange.end.unit ||
-                !dateRange.end.value ||
-                !dateRange.end.direction) {
+            const endObj = parsedDateRange.end;
+            if (!endObj.unit || !endObj.value || !endObj.direction) {
                 throw new FilterValidationError('Relative end date must have unit, value, and direction properties');
             }
             // Validate value is a number
-            if (typeof dateRange.end.value !== 'number' ||
-                isNaN(dateRange.end.value)) {
+            if (typeof endObj.value !== 'number' || isNaN(endObj.value)) {
                 throw new FilterValidationError('Relative date value must be a number');
             }
             // Validate direction
-            if (dateRange.end.direction !== 'past' &&
-                dateRange.end.direction !== 'future') {
+            if (endObj.direction !== 'past' && endObj.direction !== 'future') {
                 throw new FilterValidationError('Relative date direction must be either "past" or "future"');
             }
         }
@@ -139,7 +141,7 @@ export function validateDateRange(dateRange) {
             throw new FilterValidationError('End date must be either an ISO date string or a relative date object');
         }
     }
-    return dateRange;
+    return parsedDateRange;
 }
 /**
  * Validates an activity filter object
@@ -153,39 +155,45 @@ export function validateActivityFilter(activityFilter) {
         throw new FilterValidationError('Activity filter is required');
     }
     // Normalize if it's a string
+    let parsedActivityFilter;
     if (typeof activityFilter === 'string') {
         try {
-            activityFilter = JSON.parse(activityFilter);
+            parsedActivityFilter = JSON.parse(activityFilter);
         }
         catch (error) {
             throw new FilterValidationError(`Invalid activity filter format: ${error instanceof Error ? error.message : String(error)}`);
         }
     }
+    else {
+        parsedActivityFilter = activityFilter;
+    }
     // Check if it's a proper object
-    if (typeof activityFilter !== 'object' || Array.isArray(activityFilter)) {
+    if (typeof parsedActivityFilter !== 'object' ||
+        Array.isArray(parsedActivityFilter) ||
+        parsedActivityFilter === null) {
         throw new FilterValidationError('Activity filter must be an object with dateRange and optional interactionType');
     }
     // Validate required dateRange property
-    if (!activityFilter.dateRange) {
+    if (!parsedActivityFilter.dateRange) {
         throw new FilterValidationError('Activity filter must include a dateRange property');
     }
     // Validate dateRange
     try {
-        activityFilter.dateRange = validateDateRange(activityFilter.dateRange);
+        parsedActivityFilter.dateRange = validateDateRange(parsedActivityFilter.dateRange);
     }
     catch (error) {
         throw new FilterValidationError(`Invalid dateRange in activity filter: ${error instanceof Error ? error.message : String(error)}`);
     }
     // Validate interactionType if provided
-    if (activityFilter.interactionType !== undefined) {
+    if (parsedActivityFilter.interactionType !== undefined) {
         const validTypes = Object.values(InteractionType);
-        if (typeof activityFilter.interactionType !== 'string' ||
-            !validTypes.includes(activityFilter.interactionType)) {
-            throw new FilterValidationError(`Invalid interaction type: "${activityFilter.interactionType}". ` +
+        if (typeof parsedActivityFilter.interactionType !== 'string' ||
+            !validTypes.includes(parsedActivityFilter.interactionType)) {
+            throw new FilterValidationError(`Invalid interaction type: "${parsedActivityFilter.interactionType}". ` +
                 `Valid types are: ${validTypes.join(', ')}`);
         }
     }
-    return activityFilter;
+    return parsedActivityFilter;
 }
 /**
  * Validates a numeric range object
@@ -199,55 +207,61 @@ export function validateNumericRange(range) {
         throw new FilterValidationError('Numeric range is required');
     }
     // Normalize if it's a string
+    let parsedRange;
     if (typeof range === 'string') {
         try {
-            range = JSON.parse(range);
+            parsedRange = JSON.parse(range);
         }
         catch (error) {
             throw new FilterValidationError(`Invalid numeric range format: ${error instanceof Error ? error.message : String(error)}`);
         }
     }
+    else {
+        parsedRange = range;
+    }
     // Check if it's a proper object
-    if (typeof range !== 'object' || Array.isArray(range)) {
+    if (typeof parsedRange !== 'object' ||
+        Array.isArray(parsedRange) ||
+        parsedRange === null) {
         throw new FilterValidationError('Numeric range must be an object with min, max, or equals properties');
     }
     // Must have at least one of min, max, or equals
-    if (range.min === undefined &&
-        range.max === undefined &&
-        range.equals === undefined) {
+    if (parsedRange.min === undefined &&
+        parsedRange.max === undefined &&
+        parsedRange.equals === undefined) {
         throw new FilterValidationError('Numeric range must specify at least one of: min, max, or equals');
     }
     // If equals is specified, min and max should not be
-    if (range.equals !== undefined &&
-        (range.min !== undefined || range.max !== undefined)) {
+    if (parsedRange.equals !== undefined &&
+        (parsedRange.min !== undefined || parsedRange.max !== undefined)) {
         throw new FilterValidationError('Cannot specify both equals and min/max in a numeric range');
     }
     // Check types and convert to number if needed
-    if (range.min !== undefined) {
-        range.min = Number(range.min);
-        if (isNaN(range.min)) {
+    if (parsedRange.min !== undefined) {
+        parsedRange.min = Number(parsedRange.min);
+        if (isNaN(parsedRange.min)) {
             throw new FilterValidationError('Min value must be a valid number');
         }
     }
-    if (range.max !== undefined) {
-        range.max = Number(range.max);
-        if (isNaN(range.max)) {
+    if (parsedRange.max !== undefined) {
+        parsedRange.max = Number(parsedRange.max);
+        if (isNaN(parsedRange.max)) {
             throw new FilterValidationError('Max value must be a valid number');
         }
     }
-    if (range.equals !== undefined) {
-        range.equals = Number(range.equals);
-        if (isNaN(range.equals)) {
+    if (parsedRange.equals !== undefined) {
+        parsedRange.equals = Number(parsedRange.equals);
+        if (isNaN(parsedRange.equals)) {
             throw new FilterValidationError('Equals value must be a valid number');
         }
     }
     // Check that min <= max if both are specified
-    if (range.min !== undefined &&
-        range.max !== undefined &&
-        range.min > range.max) {
-        throw new FilterValidationError(`Invalid numeric range: min (${range.min}) cannot be greater than max (${range.max})`);
+    if (parsedRange.min !== undefined &&
+        parsedRange.max !== undefined &&
+        parsedRange.min > parsedRange.max) {
+        throw new FilterValidationError(`Invalid numeric range: min (${parsedRange.min}) cannot be greater than max (${parsedRange.max})`);
     }
-    return range;
+    return parsedRange;
 }
 /**
  * Validates a filter condition string