attio-mcp 0.1.0

package/dist/utils/filters/translators.js

@@ -0,0 +1,397 @@
+/**
+ * @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)
+ */
+// External dependencies
+import { FilterValidationError, FilterErrorCategory, } from '../../errors/api-errors.js';
+// Internal module dependencies
+import { FilterConditionType, FIELD_SPECIAL_HANDLING, } from './types.js';
+import { validateFilterStructure } from './validators.js';
+import { validateFilters, collectInvalidFilters, formatInvalidFiltersError, ERROR_MESSAGES, getFilterExample, } from './validation-utils.js';
+/**
+ * Transforms list entry filters to the format expected by the Attio API
+ *
+ * This is the main transformation function that converts MCP filter specifications
+ * into the format expected by the Attio API. It handles both AND and OR logical
+ * operators and provides comprehensive validation.
+ *
+ * **Key Features:**
+ * - Validates filter structure using centralized validation utilities
+ * - Supports both AND logic (default) and OR logic (matchAny: true)
+ * - Handles empty filter arrays gracefully (returns empty object)
+ * - Preserves filter condition types and values
+ * - Provides detailed error messages with examples on validation failure
+ *
+ * @param filters - Filter configuration from the MCP API (may have optional filters array)
+ * @param validateConditions - Whether to validate condition types against known Attio API operators
+ * @returns Transformed filter object for Attio API, or empty object if no valid filters
+ * @throws FilterValidationError if validation fails with consistent error messages and examples
+ *
+ * @example
+ * // Simple filter with a single condition
+ * const simpleFilter = {
+ *   filters: [
+ *     {
+ *       attribute: { slug: 'name' },
+ *       condition: 'contains',
+ *       value: 'Company Inc'
+ *     }
+ *   ]
+ * };
+ *
+ * // Filter with OR logic between conditions
+ * const orFilter = {
+ *   filters: [
+ *     {
+ *       attribute: { slug: 'name' },
+ *       condition: 'contains',
+ *       value: 'Inc'
+ *     },
+ *     {
+ *       attribute: { slug: 'industry' },
+ *       condition: 'equals',
+ *       value: 'Technology'
+ *     }
+ *   ],
+ *   matchAny: true  // Use OR logic
+ * };
+ *
+ * // Filter with multiple conditions (AND logic by default)
+ * const multipleFilter = {
+ *   filters: [
+ *     {
+ *       attribute: { slug: 'name' },
+ *       condition: 'contains',
+ *       value: 'Inc'
+ *     },
+ *     {
+ *       attribute: { slug: 'website' },
+ *       condition: 'contains',
+ *       value: '.com'
+ *     }
+ *   ]
+ * };
+ */
+export function transformFiltersToApiFormat(filters, validateConditions = true) {
+    // Handle undefined/null filters gracefully
+    if (!filters) {
+        return {};
+    }
+    // Check if filters has a filters property and it's an array
+    if (!('filters' in filters) || !Array.isArray(filters.filters)) {
+        return {};
+    }
+    // If filters array is empty, return empty result
+    if (filters.filters.length === 0) {
+        return {};
+    }
+    try {
+        // Use the central validation utility for consistent error messages
+        const validatedFilters = validateFilters(filters, validateConditions);
+        // Check if filters array exists and handle undefined case
+        if (!validatedFilters.filters || validatedFilters.filters.length === 0) {
+            if (process.env.NODE_ENV === 'development') {
+                console.log('[transformFiltersToApiFormat] Empty or undefined filters array provided, returning empty result');
+            }
+            return {};
+        }
+    }
+    catch (error) {
+        // Check if this is a FilterValidationError
+        if (error instanceof FilterValidationError) {
+            // For condition validation errors when validateConditions is true, re-throw
+            if (validateConditions &&
+                (error.message.includes('Invalid condition') ||
+                    error.message.includes('Invalid filter condition'))) {
+                throw error;
+            }
+            // For structure errors (missing properties), return empty result instead of throwing
+            if (process.env.NODE_ENV === 'development') {
+                console.log('[transformFiltersToApiFormat] Validation failed, returning empty result:', error);
+            }
+            return {};
+        }
+        // Re-throw non-FilterValidationError errors
+        throw error;
+    }
+    // Re-validate for the actual processing (this should not throw since we already validated)
+    const validatedFilters = validateFilters(filters, validateConditions);
+    // Determine if we need to use the $or operator based on matchAny
+    // matchAny: true = use $or logic, matchAny: false (or undefined) = use standard AND logic
+    const useOrLogic = validatedFilters.matchAny === true;
+    if (process.env.NODE_ENV === 'development') {
+        console.log(`[transformFiltersToApiFormat] Using ${useOrLogic ? 'OR' : 'AND'} logic for filters`);
+        console.log(`[transformFiltersToApiFormat] Processing ${validatedFilters.filters.length} filter conditions`);
+    }
+    // For OR logic, we need a completely different structure with filter objects in an array
+    if (useOrLogic) {
+        return createOrFilterStructure(validatedFilters.filters, validateConditions);
+    }
+    // Standard AND logic
+    return createAndFilterStructure(validatedFilters.filters, validateConditions);
+}
+/**
+ * Creates an OR filter structure for the API
+ *
+ * @param filters - Array of filters to combine with OR logic
+ * @param validateConditions - Whether to validate condition types
+ * @returns Filter object with $or structure
+ * @throws FilterValidationError for invalid filter structures or when all filters are invalid
+ */
+function createOrFilterStructure(filters, validateConditions) {
+    const orConditions = [];
+    // Use centralized validation utility to collect invalid filters with consistent messages
+    const invalidFilters = collectInvalidFilters(filters, validateConditions);
+    // Log invalid filters in development mode
+    if (invalidFilters.length > 0 && process.env.NODE_ENV === 'development') {
+        console.warn('[createOrFilterStructure] Found invalid filters:', invalidFilters.map((f) => `Index ${f.index}: ${f.reason}`));
+    }
+    // If all filters are invalid, throw a descriptive error with example
+    if (invalidFilters.length === filters.length) {
+        const errorDetails = formatInvalidFiltersError(invalidFilters);
+        let errorMessage = `${ERROR_MESSAGES.ALL_FILTERS_INVALID} ${errorDetails}`;
+        // Add example of valid OR filter structure
+        errorMessage +=
+            '\n\nExample of valid OR filter structure: \n' + getFilterExample('or');
+        throw new FilterValidationError(errorMessage, FilterErrorCategory.TRANSFORMATION);
+    }
+    // Process valid filters
+    filters.forEach((filter, index) => {
+        // Skip if this filter was found invalid
+        if (invalidFilters.some((invalid) => invalid.index === index)) {
+            return;
+        }
+        // Debug log each filter
+        if (process.env.NODE_ENV === 'development') {
+            console.log(`[createOrFilterStructure] Processing filter ${index}:`, {
+                attribute: filter.attribute,
+                condition: filter.condition,
+                value: filter.value,
+            });
+        }
+        const { slug } = filter.attribute;
+        // Create a condition object for this individual filter
+        const condition = {};
+        // Check for special case handling
+        if (FIELD_SPECIAL_HANDLING[slug] &&
+            FIELD_SPECIAL_HANDLING[slug].useShorthandFormat) {
+            // For special fields that need shorthand format
+            if (process.env.NODE_ENV === 'development') {
+                console.log(`[OR Logic] Using shorthand filter format for field ${slug}`);
+            }
+            // Direct value assignment for shorthand format
+            condition[slug] = filter.value;
+        }
+        else {
+            // Standard operator handling for normal fields
+            const operator = filter.condition;
+            // Create the condition with operator
+            condition[slug] = {
+                [`$${operator}`]: filter.value,
+            };
+        }
+        // Add to the OR conditions array
+        orConditions.push(condition);
+    });
+    // Return the $or structure with valid conditions
+    if (orConditions.length > 0) {
+        return {
+            filter: { $or: orConditions },
+        };
+    }
+    // This shouldn't happen given the earlier check, but just in case
+    return {};
+}
+/**
+ * Creates an AND filter structure for the API
+ *
+ * @param filters - Array of filters to combine with AND logic
+ * @param validateConditions - Whether to validate condition types
+ * @returns Filter object with standard AND structure
+ * @throws FilterValidationError for invalid filter structures or when all filters are invalid
+ */
+function createAndFilterStructure(filters, validateConditions) {
+    const apiFilter = {};
+    // Use centralized validation utility to collect invalid filters with consistent messages
+    const invalidFilters = collectInvalidFilters(filters, validateConditions);
+    // Log invalid filters in development mode
+    if (invalidFilters.length > 0 && process.env.NODE_ENV === 'development') {
+        console.warn('[createAndFilterStructure] Found invalid filters:', invalidFilters.map((f) => `Index ${f.index}: ${f.reason}`));
+    }
+    // If all filters are invalid, throw a descriptive error with example
+    if (invalidFilters.length === filters.length) {
+        const errorDetails = formatInvalidFiltersError(invalidFilters);
+        let errorMessage = `${ERROR_MESSAGES.ALL_FILTERS_INVALID} ${errorDetails}`;
+        // Add example of valid filter structure for AND logic (multiple conditions)
+        errorMessage +=
+            '\n\nExample of valid filter structure with multiple conditions: \n' +
+                getFilterExample('multiple');
+        throw new FilterValidationError(errorMessage, FilterErrorCategory.TRANSFORMATION);
+    }
+    // Process valid filters
+    let hasValidFilters = false;
+    filters.forEach((filter, index) => {
+        // Skip if this filter was found invalid
+        if (invalidFilters.some((invalid) => invalid.index === index)) {
+            return;
+        }
+        // Debug log each filter
+        if (process.env.NODE_ENV === 'development') {
+            console.log(`[createAndFilterStructure] Processing filter ${index}:`, {
+                attribute: filter.attribute,
+                condition: filter.condition,
+                value: filter.value,
+            });
+        }
+        const { slug } = filter.attribute;
+        // Check for special case handling
+        if (FIELD_SPECIAL_HANDLING[slug] &&
+            FIELD_SPECIAL_HANDLING[slug].useShorthandFormat) {
+            // For special fields that need shorthand format
+            if (process.env.NODE_ENV === 'development') {
+                console.log(`[AND Logic] Using shorthand filter format for field ${slug}`);
+            }
+            // Direct value assignment for shorthand format
+            if (!apiFilter[slug]) {
+                apiFilter[slug] = filter.value;
+            }
+            else {
+                console.warn(`Multiple filters for ${slug} using shorthand format will overwrite previous values`);
+                apiFilter[slug] = filter.value;
+            }
+        }
+        else {
+            // Standard operator handling for normal fields
+            const operator = filter.condition;
+            // Initialize attribute entry if needed for operator-based filtering
+            if (!apiFilter[slug]) {
+                apiFilter[slug] = {};
+            }
+            // Add operator with $ prefix as required by Attio API
+            apiFilter[slug][`$${operator}`] = filter.value;
+        }
+        hasValidFilters = true;
+    });
+    // Return the filter object only if valid filters were found
+    return hasValidFilters ? { filter: apiFilter } : {};
+}
+/**
+ * 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., '$equals', '$contains')
+ */
+export function convertOperatorToApiFormat(operator) {
+    // Ensure the operator starts with $ for Attio API format
+    return operator.startsWith('$') ? operator : `$${operator}`;
+}
+/**
+ * Transforms attribute names if they require special handling
+ *
+ * @param attributeSlug - The attribute slug to transform
+ * @returns The transformed attribute name
+ */
+export function transformAttributeName(attributeSlug) {
+    // Special transformations for certain attributes
+    if (attributeSlug === 'relationship') {
+        return '$relationship';
+    }
+    return attributeSlug;
+}
+/**
+ * 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 function processFilterValue(value, condition) {
+    // Empty conditions should not have a value
+    if (condition === FilterConditionType.IS_EMPTY ||
+        condition === FilterConditionType.IS_NOT_EMPTY ||
+        condition === FilterConditionType.IS_SET ||
+        condition === FilterConditionType.IS_NOT_SET) {
+        return undefined;
+    }
+    // Return value as-is for other conditions
+    return value;
+}
+/**
+ * Transforms a simple filter to API format
+ *
+ * @param filter - The filter to transform
+ * @returns API-formatted filter object
+ */
+export function transformSingleFilterToApi(filter) {
+    if (!validateFilterStructure(filter)) {
+        throw new FilterValidationError('Invalid filter structure', FilterErrorCategory.STRUCTURE);
+    }
+    const { slug } = filter.attribute;
+    const apiOperator = convertOperatorToApiFormat(filter.condition);
+    const value = processFilterValue(filter.value, filter.condition);
+    return {
+        [slug]: {
+            [apiOperator]: value,
+        },
+    };
+}
+/**
+ * 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 function transformApiFormatToFilters(apiFilter) {
+    const filters = [];
+    // Check for $or structure
+    if (apiFilter.$or && Array.isArray(apiFilter.$or)) {
+        // Handle OR logic
+        apiFilter.$or.forEach((condition) => {
+            if (condition && typeof condition === 'object') {
+                Object.entries(condition).forEach(([slug, conditions]) => {
+                    if (conditions && typeof conditions === 'object') {
+                        Object.entries(conditions).forEach(([operator, value]) => {
+                            filters.push({
+                                attribute: { slug },
+                                condition: operator.replace('$', ''),
+                                value,
+                            });
+                        });
+                    }
+                });
+            }
+        });
+        return {
+            filters,
+            matchAny: true,
+        };
+    }
+    // Handle standard AND logic
+    Object.entries(apiFilter).forEach(([slug, conditions]) => {
+        if (conditions && typeof conditions === 'object') {
+            Object.entries(conditions).forEach(([operator, value]) => {
+                filters.push({
+                    attribute: { slug },
+                    condition: operator.replace('$', ''),
+                    value,
+                });
+            });
+        }
+    });
+    return {
+        filters,
+        matchAny: false,
+    };
+}
+//# sourceMappingURL=translators.js.map

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

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

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

@@ -0,0 +1,77 @@
+/**
+ * @module types
+ *
+ * Consolidated filter type definitions for Attio API
+ * Central location for all filter-related interfaces, types, enums, and constants
+ *
+ * This module provides:
+ * - Type definitions for filters and filter configurations
+ * - Attribute constants for consistent field references
+ * - Error types specific to filter operations
+ * - Enums and interfaces from external dependencies
+ */
+import { FilterConditionType, DateRange, NumericRange, InteractionType, ActivityFilter, RelationshipType, ResourceType } from '../../types/attio.js';
+import { ListEntryFilter, ListEntryFilters } from '../../api/operations/types.js';
+/**
+ * Attribute constants for better code readability and consistency
+ */
+export declare const ATTRIBUTES: {
+    CREATED_AT: string;
+    UPDATED_AT: string;
+    LAST_INTERACTION: string;
+    INTERACTION_TYPE: string;
+    EMAIL: string;
+    PHONE: string;
+    NAME: string;
+    WEBSITE: string;
+    INDUSTRY: string;
+    REVENUE: string;
+    EMPLOYEE_COUNT: string;
+    LIST_ID: string;
+    NOTE_CONTENT: string;
+    RELATIONSHIP: string;
+};
+/**
+ * Type for the Attio API filter object format
+ * Represents the structure expected by Attio API endpoints
+ */
+export type AttioApiFilter = {
+    [attributeSlug: string]: {
+        [condition: string]: any;
+    };
+};
+/**
+ * Error type for rate-limiting on relationship queries
+ */
+export declare class RelationshipRateLimitError extends Error {
+    readonly relationshipType: string;
+    readonly resetTime: number;
+    readonly msUntilReset: number;
+    constructor(message: string, relationshipType: string, resetTime: number, msUntilReset: number);
+}
+/**
+ * Configuration for a relationship-based filter
+ */
+export interface RelationshipFilterConfig {
+    sourceType: ResourceType;
+    targetType: ResourceType;
+    relationshipType: RelationshipType;
+    targetFilters: ListEntryFilters;
+}
+/**
+ * Special case field-operator mappings and handling flags
+ */
+export declare const FIELD_SPECIAL_HANDLING: Record<string, any>;
+/**
+ * Valid interaction types for activity filtering
+ */
+export declare const VALID_INTERACTION_TYPES: Set<InteractionType>;
+/**
+ * Common filter operation types
+ */
+export type FilterOperation = 'equals' | 'not_equals' | 'contains' | 'not_contains' | 'greater_than' | 'less_than' | 'greater_than_or_equals' | 'less_than_or_equals' | 'in' | 'not_in' | 'is_empty' | 'not_empty';
+/**
+ * Export reusable filter-related types from dependencies
+ */
+export { FilterConditionType, type DateRange, type NumericRange, InteractionType, type ActivityFilter, RelationshipType, ResourceType, type ListEntryFilter, type ListEntryFilters, };
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/filters/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,mBAAmB,EACnB,SAAS,EACT,YAAY,EACZ,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,YAAY,EACb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,eAAe,EACf,gBAAgB,EACjB,MAAM,+BAA+B,CAAC;AAEvC;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;CAetB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,CAAC,aAAa,EAAE,MAAM,GAAG;QACvB,CAAC,SAAS,EAAE,MAAM,GAAG,GAAG,CAAC;KAC1B,CAAC;CACH,CAAC;AAEF;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;aAGjC,gBAAgB,EAAE,MAAM;aACxB,SAAS,EAAE,MAAM;aACjB,YAAY,EAAE,MAAM;gBAHpC,OAAO,EAAE,MAAM,EACC,gBAAgB,EAAE,MAAM,EACxB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM;CAQvC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IAEvC,UAAU,EAAE,YAAY,CAAC;IAGzB,UAAU,EAAE,YAAY,CAAC;IAGzB,gBAAgB,EAAE,gBAAgB,CAAC;IAGnC,aAAa,EAAE,gBAAgB,CAAC;CACjC;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAgBtD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,sBAOlC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,QAAQ,GACR,YAAY,GACZ,UAAU,GACV,cAAc,GACd,cAAc,GACd,WAAW,GACX,wBAAwB,GACxB,qBAAqB,GACrB,IAAI,GACJ,QAAQ,GACR,UAAU,GACV,WAAW,CAAC;AAEhB;;GAEG;AACH,OAAO,EACL,mBAAmB,EACnB,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,eAAe,EACf,KAAK,cAAc,EACnB,gBAAgB,EAChB,YAAY,EACZ,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,CAAC"}

package/dist/utils/filters/types.js

@@ -0,0 +1,85 @@
+/**
+ * @module types
+ *
+ * Consolidated filter type definitions for Attio API
+ * Central location for all filter-related interfaces, types, enums, and constants
+ *
+ * This module provides:
+ * - Type definitions for filters and filter configurations
+ * - Attribute constants for consistent field references
+ * - Error types specific to filter operations
+ * - Enums and interfaces from external dependencies
+ */
+import { FilterConditionType, InteractionType, RelationshipType, ResourceType, } from '../../types/attio.js';
+/**
+ * Attribute constants for better code readability and consistency
+ */
+export const ATTRIBUTES = {
+    CREATED_AT: 'created_at',
+    UPDATED_AT: 'updated_at',
+    LAST_INTERACTION: 'last_interaction',
+    INTERACTION_TYPE: 'interaction_type',
+    EMAIL: 'email',
+    PHONE: 'phone',
+    NAME: 'name',
+    WEBSITE: 'website',
+    INDUSTRY: 'industry',
+    REVENUE: 'annual_revenue',
+    EMPLOYEE_COUNT: 'employee_count',
+    LIST_ID: 'list_id',
+    NOTE_CONTENT: 'note_content',
+    RELATIONSHIP: '$relationship',
+};
+/**
+ * Error type for rate-limiting on relationship queries
+ */
+export class RelationshipRateLimitError extends Error {
+    relationshipType;
+    resetTime;
+    msUntilReset;
+    constructor(message, relationshipType, resetTime, msUntilReset) {
+        super(message);
+        this.relationshipType = relationshipType;
+        this.resetTime = resetTime;
+        this.msUntilReset = msUntilReset;
+        this.name = 'RelationshipRateLimitError';
+        // This line is needed to properly capture the stack trace
+        Object.setPrototypeOf(this, RelationshipRateLimitError.prototype);
+    }
+}
+/**
+ * Special case field-operator mappings and handling flags
+ */
+export const FIELD_SPECIAL_HANDLING = {
+    // Special handling for B2B Segment field (type_persona)
+    type_persona: {
+        in: 'contains_any',
+        contains_any: 'contains_any',
+        not_empty: 'not_empty',
+        operators: ['in', 'contains_any', 'not_empty'],
+        allowStringValue: true,
+        disableDebugLogging: true,
+    },
+    // Other fields can be added here as needed
+    segment: {
+        in: 'contains_any',
+        contains_any: 'contains_any',
+        operators: ['in', 'contains_any'],
+    },
+};
+/**
+ * Valid interaction types for activity filtering
+ */
+export const VALID_INTERACTION_TYPES = new Set([
+    InteractionType.EMAIL,
+    InteractionType.CALENDAR,
+    InteractionType.PHONE,
+    InteractionType.MEETING,
+    InteractionType.CUSTOM,
+    InteractionType.ANY,
+]);
+/**
+ * Export reusable filter-related types from dependencies
+ */
+export { FilterConditionType, InteractionType, RelationshipType, ResourceType, };
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/utils/filters/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,mBAAmB,EAGnB,eAAe,EAEf,gBAAgB,EAChB,YAAY,GACb,MAAM,sBAAsB,CAAC;AAM9B;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,YAAY;IACxB,gBAAgB,EAAE,kBAAkB;IACpC,gBAAgB,EAAE,kBAAkB;IACpC,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,gBAAgB;IACzB,cAAc,EAAE,gBAAgB;IAChC,OAAO,EAAE,SAAS;IAClB,YAAY,EAAE,cAAc;IAC5B,YAAY,EAAE,eAAe;CAC9B,CAAC;AAYF;;GAEG;AACH,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAGjC;IACA;IACA;IAJlB,YACE,OAAe,EACC,gBAAwB,EACxB,SAAiB,EACjB,YAAoB;QAEpC,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,qBAAgB,GAAhB,gBAAgB,CAAQ;QACxB,cAAS,GAAT,SAAS,CAAQ;QACjB,iBAAY,GAAZ,YAAY,CAAQ;QAGpC,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;QAEzC,0DAA0D;QAC1D,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,0BAA0B,CAAC,SAAS,CAAC,CAAC;IACpE,CAAC;CACF;AAmBD;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAwB;IACzD,wDAAwD;IACxD,YAAY,EAAE;QACZ,EAAE,EAAE,cAAc;QAClB,YAAY,EAAE,cAAc;QAC5B,SAAS,EAAE,WAAW;QACtB,SAAS,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,WAAW,CAAC;QAC9C,gBAAgB,EAAE,IAAI;QACtB,mBAAmB,EAAE,IAAI;KAC1B;IACD,2CAA2C;IAC3C,OAAO,EAAE;QACP,EAAE,EAAE,cAAc;QAClB,YAAY,EAAE,cAAc;QAC5B,SAAS,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC;KAClC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAkB;IAC9D,eAAe,CAAC,KAAK;IACrB,eAAe,CAAC,QAAQ;IACxB,eAAe,CAAC,KAAK;IACrB,eAAe,CAAC,OAAO;IACvB,eAAe,CAAC,MAAM;IACtB,eAAe,CAAC,GAAG;CACpB,CAAC,CAAC;AAmBH;;GAEG;AACH,OAAO,EACL,mBAAmB,EAGnB,eAAe,EAEf,gBAAgB,EAChB,YAAY,GAGb,CAAC"}

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

@@ -0,0 +1,86 @@
+/**
+ * General filter utility functions
+ * Consolidates utilities from filter-utils.ts and filter-utils-additions.ts
+ */
+import { DateRange, NumericRange, FilterConditionType } from './types.js';
+/**
+ * Creates a filter for records based on their creation date
+ *
+ * @param dateRange - Date range specification
+ * @returns Configured filter object
+ */
+export declare function createCreatedDateFilter(dateRange: DateRange): import("./types.js").ListEntryFilters;
+/**
+ * Creates a filter for records based on their last modification date
+ *
+ * @param dateRange - Date range specification
+ * @returns Configured filter object
+ */
+export declare function createModifiedDateFilter(dateRange: DateRange): import("./types.js").ListEntryFilters;
+/**
+ * Creates a filter for B2B Segment (type_persona)
+ *
+ * @param value - B2B Segment value to filter by
+ * @returns Configured filter object
+ */
+export declare function createB2BSegmentFilter(value: string): {
+    filters: {
+        attribute: {
+            slug: string;
+        };
+        condition: FilterConditionType;
+        value: string;
+    }[];
+    matchAny: boolean;
+};
+/**
+ * Validates if a value falls within a numeric range
+ *
+ * @param value - The value to check
+ * @param range - The numeric range to validate against
+ * @returns True if value is within range
+ */
+export declare function isInNumericRange(value: number, range: NumericRange): boolean;
+/**
+ * Checks if a date string falls within a date range
+ *
+ * @param dateStr - ISO date string to check
+ * @param range - Date range to validate against
+ * @returns True if date is within range
+ */
+export declare function isInDateRange(dateStr: string, range: DateRange): boolean;
+/**
+ * Debug logging for filter operations
+ *
+ * @param operation - The operation being performed
+ * @param details - Additional details to log
+ */
+export declare function debugFilterLog(operation: string, details: any): void;
+/**
+ * Determines if a filter attribute represents a date field
+ *
+ * @param attributeSlug - The attribute slug to check
+ * @returns True if the attribute is a date field
+ */
+export declare function isDateAttribute(attributeSlug: string): boolean;
+/**
+ * Determines if a filter attribute represents a numeric field
+ *
+ * @param attributeSlug - The attribute slug to check
+ * @returns True if the attribute is a numeric field
+ */
+export declare function isNumericAttribute(attributeSlug: string): boolean;
+/**
+ * Determines if a filter attribute represents a text field
+ *
+ * @param attributeSlug - The attribute slug to check
+ * @returns True if the attribute is a text field
+ */
+export declare function isTextAttribute(attributeSlug: string): boolean;
+/**
+ * Helper function to extract attribute mappings as needed
+ * Re-exports builder functions as utilities for backward compatibility
+ */
+import { createDateRangeFilter, createEqualsFilter, createContainsFilter } from './builders.js';
+export { createDateRangeFilter, createEqualsFilter, createContainsFilter };
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/utils/filters/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,SAAS,EACT,YAAY,EAEZ,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAGpB;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,yCAE3D;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,SAAS,yCAE5D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM;;;;;;;;;EAYnD;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAc5E;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAexE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,IAAI,CAIpE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAQ9D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAIjE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAU9D;AAED;;;GAGG;AACH,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,CAAC"}