attio-mcp 0.1.0

package/dist/utils/error-handler.js

@@ -0,0 +1,336 @@
+import { safeJsonStringify, sanitizeMcpResponse } from './json-serializer.js';
+/**
+ * Enum for categorizing different types of errors
+ */
+export var ErrorType;
+(function (ErrorType) {
+    ErrorType["VALIDATION_ERROR"] = "validation_error";
+    ErrorType["API_ERROR"] = "api_error";
+    ErrorType["AUTHENTICATION_ERROR"] = "authentication_error";
+    ErrorType["RATE_LIMIT_ERROR"] = "rate_limit_error";
+    ErrorType["NETWORK_ERROR"] = "network_error";
+    ErrorType["NOT_FOUND_ERROR"] = "not_found_error";
+    ErrorType["SERVER_ERROR"] = "server_error";
+    ErrorType["PARAMETER_ERROR"] = "parameter_error";
+    ErrorType["SERIALIZATION_ERROR"] = "serialization_error";
+    ErrorType["FORMAT_ERROR"] = "format_error";
+    ErrorType["UNKNOWN_ERROR"] = "unknown_error";
+})(ErrorType || (ErrorType = {}));
+/**
+ * Custom error class for Attio API errors
+ */
+export class AttioApiError extends Error {
+    status;
+    detail;
+    path;
+    method;
+    responseData;
+    type;
+    constructor(message, status, detail, path, method, type = ErrorType.API_ERROR, responseData = {}) {
+        super(message);
+        this.name = 'AttioApiError';
+        this.status = status;
+        this.detail = detail;
+        this.path = path;
+        this.method = method;
+        this.type = type;
+        this.responseData = responseData;
+    }
+}
+/**
+ * Creates a specific API error based on status code and context
+ *
+ * @param status - HTTP status code
+ * @param path - API path
+ * @param method - HTTP method
+ * @param responseData - Response data from API
+ * @returns Appropriate error instance
+ */
+export function createAttioError(error) {
+    // If it's already an AttioApiError, return it
+    if (error instanceof AttioApiError) {
+        return error;
+    }
+    // Handle Axios errors
+    if (error.isAxiosError && error.response) {
+        const { status, data, config } = error.response;
+        const path = config?.url || 'unknown';
+        const method = config?.method?.toUpperCase() || 'UNKNOWN';
+        return createApiError(status, path, method, data);
+    }
+    // Return the original error if we can't enhance it
+    return error;
+}
+/**
+ * Creates a specific API error based on status code and context
+ *
+ * @param status - HTTP status code
+ * @param path - API path
+ * @param method - HTTP method
+ * @param responseData - Response data from API
+ * @returns Appropriate error instance
+ */
+export function createApiError(status, path, method, responseData = {}) {
+    const defaultMessage = responseData?.error?.message ||
+        responseData?.message ||
+        'Unknown API error';
+    const detail = responseData?.error?.detail ||
+        responseData?.detail ||
+        'No additional details';
+    let errorType = ErrorType.API_ERROR;
+    let message = '';
+    // Create specific error messages based on status code and context
+    switch (status) {
+        case 400:
+            // Detect common parameter and format errors in the 400 response
+            if (defaultMessage.includes('parameter') ||
+                defaultMessage.includes('param') ||
+                responseData?.error?.details?.includes('parameter')) {
+                errorType = ErrorType.PARAMETER_ERROR;
+                message = `Parameter Error: ${defaultMessage}`;
+            }
+            else if (defaultMessage.includes('format') ||
+                defaultMessage.includes('invalid')) {
+                errorType = ErrorType.FORMAT_ERROR;
+                message = `Format Error: ${defaultMessage}`;
+            }
+            else if (defaultMessage.includes('serialize') ||
+                defaultMessage.includes('parse')) {
+                errorType = ErrorType.SERIALIZATION_ERROR;
+                message = `Serialization Error: ${defaultMessage}`;
+            }
+            else {
+                errorType = ErrorType.VALIDATION_ERROR;
+                message = `Bad Request: ${defaultMessage}`;
+            }
+            break;
+        case 401:
+        case 403:
+            errorType = ErrorType.AUTHENTICATION_ERROR;
+            message =
+                status === 401
+                    ? 'Authentication failed. Please check your API key.'
+                    : 'Permission denied. Your API key lacks the necessary permissions.';
+            break;
+        case 404:
+            errorType = ErrorType.NOT_FOUND_ERROR;
+            // Customize 404 message based on path
+            if (path.includes('/objects/people/')) {
+                message = `Person not found: ${path.split('/').pop()}`;
+            }
+            else if (path.includes('/objects/companies/')) {
+                message = `Company not found: ${path.split('/').pop()}`;
+            }
+            else if (path.includes('/lists/')) {
+                const listId = path.split('/').pop();
+                if (path.includes('/entries')) {
+                    message = `List entry not found in list ${path.split('/')[2]}`;
+                }
+                else {
+                    message = `List not found: ${listId}`;
+                }
+            }
+            else {
+                message = `Resource not found: ${path}`;
+            }
+            break;
+        case 422:
+            errorType = ErrorType.PARAMETER_ERROR;
+            message = `Unprocessable Entity: ${defaultMessage}`;
+            break;
+        case 429:
+            errorType = ErrorType.RATE_LIMIT_ERROR;
+            message = 'Rate limit exceeded. Please try again later.';
+            break;
+        case 500:
+        case 502:
+        case 503:
+        case 504:
+            errorType = ErrorType.SERVER_ERROR;
+            message = `Attio API server error (${status}): ${defaultMessage}`;
+            break;
+        default:
+            if (status >= 500) {
+                errorType = ErrorType.SERVER_ERROR;
+            }
+            else if (status >= 400) {
+                errorType = ErrorType.API_ERROR;
+            }
+            else {
+                errorType = ErrorType.UNKNOWN_ERROR;
+            }
+            message = `API Error (${status}): ${defaultMessage}`;
+            break;
+    }
+    return new AttioApiError(message, status, detail, path, method, errorType, responseData);
+}
+/**
+ * Format an error into a standardized response based on error type
+ *
+ * @param error - The error to format
+ * @param type - The error type
+ * @param details - Additional error details
+ * @returns Formatted error response
+ */
+export function formatErrorResponse(error, type = ErrorType.UNKNOWN_ERROR, details) {
+    // Ensure we have a valid error object
+    const normalizedError = error instanceof Error
+        ? error
+        : new Error(typeof error === 'string' ? error : 'Unknown error');
+    // Prevent "undefined" from being returned as an error message
+    const errorMessage = normalizedError.message || 'An unknown error occurred';
+    // Determine appropriate status code based on error type
+    const errorCode = type === ErrorType.VALIDATION_ERROR
+        ? 400
+        : type === ErrorType.AUTHENTICATION_ERROR
+            ? 401
+            : type === ErrorType.RATE_LIMIT_ERROR
+                ? 429
+                : type === ErrorType.NOT_FOUND_ERROR
+                    ? 404
+                    : type === ErrorType.SERVER_ERROR
+                        ? 500
+                        : type === ErrorType.PARAMETER_ERROR
+                            ? 400
+                            : type === ErrorType.FORMAT_ERROR
+                                ? 400
+                                : type === ErrorType.SERIALIZATION_ERROR
+                                    ? 400
+                                    : 500;
+    // Enhance error message with helpful tips for specific error types
+    let helpfulTip = '';
+    if (type === ErrorType.PARAMETER_ERROR) {
+        helpfulTip =
+            '\n\nTIP: Check parameter names and formats. Use direct string parameters instead of constants or placeholders.';
+    }
+    else if (type === ErrorType.FORMAT_ERROR) {
+        helpfulTip =
+            '\n\nTIP: Ensure all parameters use the correct format as specified in the API documentation.';
+    }
+    else if (type === ErrorType.SERIALIZATION_ERROR) {
+        helpfulTip =
+            '\n\nTIP: Verify objects are properly serialized to strings where needed.';
+    }
+    // Create a safe copy of details to prevent circular reference issues during JSON serialization
+    let safeDetails = null;
+    if (details) {
+        try {
+            // Use createSafeCopy which handles circular references and non-serializable values
+            safeDetails = JSON.parse(safeJsonStringify(details, {
+                includeStackTraces: process.env.NODE_ENV === 'development',
+            }));
+        }
+        catch (err) {
+            console.error('[formatErrorResponse] Error with safe stringification:', err instanceof Error ? err.message : String(err));
+            // Ultimate fallback
+            safeDetails = {
+                note: 'Error details could not be serialized',
+                error: String(err),
+                detailsType: typeof details,
+            };
+        }
+    }
+    // Log the error for debugging purposes
+    if (process.env.DEBUG || process.env.NODE_ENV === 'development') {
+        console.error(`[formatErrorResponse] Formatted error [${type}]:`, errorMessage);
+    }
+    // Return properly formatted MCP error response
+    const errorResponse = {
+        content: [
+            {
+                type: 'text',
+                text: `ERROR [${type}]: ${errorMessage}${helpfulTip}${safeDetails
+                    ? '\n\nDetails: ' + safeJsonStringify(safeDetails, { indent: 0 })
+                    : ''}`,
+            },
+        ],
+        isError: true,
+        error: {
+            code: errorCode,
+            message: errorMessage,
+            type,
+            details: safeDetails,
+        },
+    };
+    // Sanitize the final error response to ensure it's MCP-compatible
+    return sanitizeMcpResponse(errorResponse);
+}
+/**
+ * Creates a detailed error response for API errors, suitable for returning to MCP clients
+ *
+ * @param error - The caught error
+ * @param url - The API URL that was called
+ * @param method - The HTTP method used
+ * @param responseData - Any response data received
+ * @returns Formatted error result
+ */
+export function createErrorResult(error, url, method, responseData = {}) {
+    // Ensure we have a valid error object to work with
+    const normalizedError = error instanceof Error
+        ? error
+        : new Error(typeof error === 'string' ? error : 'Unknown error');
+    if (process.env.DEBUG || process.env.NODE_ENV === 'development') {
+        console.error(`[createErrorResult] Processing error for ${method} ${url}:`, normalizedError.message);
+    }
+    // If it's already an AttioApiError, use it directly
+    if (error instanceof AttioApiError) {
+        const errorDetails = {
+            status: error.status,
+            method: error.method,
+            path: error.path,
+            detail: error.detail,
+            responseData: error.responseData,
+        };
+        return formatErrorResponse(error, error.type, errorDetails);
+    }
+    // For Axios errors with response data
+    if (responseData && responseData.status) {
+        try {
+            // Create a specific API error
+            const apiError = createApiError(responseData.status, url, method, responseData);
+            const errorDetails = {
+                status: apiError.status,
+                method: apiError.method,
+                path: apiError.path,
+                detail: apiError.detail,
+                responseData: apiError.responseData,
+                originalError: normalizedError.message,
+            };
+            return formatErrorResponse(apiError, apiError.type, errorDetails);
+        }
+        catch (formattingError) {
+            // If error formatting fails, preserve the original error
+            console.error('Error while formatting API error:', formattingError);
+            const originalErrorDetails = {
+                url,
+                method,
+                status: responseData.status,
+                originalError: normalizedError.message,
+                formattingError: formattingError instanceof Error
+                    ? formattingError.message
+                    : 'Unknown formatting error',
+            };
+            return formatErrorResponse(normalizedError, ErrorType.UNKNOWN_ERROR, originalErrorDetails);
+        }
+    }
+    // For network or unknown errors
+    let errorType = ErrorType.UNKNOWN_ERROR;
+    // Try to determine error type based on message or instance
+    if (normalizedError.message.includes('network') ||
+        normalizedError.message.includes('connection')) {
+        errorType = ErrorType.NETWORK_ERROR;
+    }
+    else if (normalizedError.message.includes('timeout')) {
+        errorType = ErrorType.NETWORK_ERROR;
+    }
+    const errorDetails = {
+        method,
+        url,
+        status: responseData.status || 'Unknown',
+        headers: responseData.headers || {},
+        data: responseData.data || {},
+        rawError: typeof error === 'object' ? JSON.stringify(error) : String(error),
+    };
+    return formatErrorResponse(normalizedError, errorType, errorDetails);
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/utils/error-handler.js.map

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

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

@@ -0,0 +1,13 @@
+/**
+ * Activity related filter builders.
+ */
+import { ListEntryFilters, DateRange, ActivityFilter, InteractionType } from './types.js';
+/**
+ * Creates an activity filter for finding records with specific interaction types within a date range.
+ */
+export declare function createActivityFilter(activityFilter: ActivityFilter): ListEntryFilters;
+/**
+ * Creates a filter for records based on their last interaction date.
+ */
+export declare function createLastInteractionFilter(dateRange: DateRange, interactionType?: InteractionType): ListEntryFilters;
+//# sourceMappingURL=activity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../../../src/utils/filters/builders/activity.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,EAGL,gBAAgB,EAChB,SAAS,EACT,cAAc,EACd,eAAe,EAEhB,MAAM,YAAY,CAAC;AAIpB;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,cAAc,GAC7B,gBAAgB,CAqBlB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,SAAS,EACpB,eAAe,CAAC,EAAE,eAAe,GAChC,gBAAgB,CAoClB"}

package/dist/utils/filters/builders/activity.js

@@ -0,0 +1,65 @@
+/**
+ * Activity related filter builders.
+ */
+// External imports
+import { FilterValidationError } from '../../../errors/api-errors.js';
+import { resolveDateRange } from '../../date-utils.js';
+// Internal imports
+import { FilterConditionType, InteractionType, ATTRIBUTES, } from './types.js';
+import { validateActivityFilter } from '../validators.js';
+import { createDateRangeFilter } from './date.js';
+/**
+ * Creates an activity filter for finding records with specific interaction types within a date range.
+ */
+export function createActivityFilter(activityFilter) {
+    const validated = validateActivityFilter(activityFilter);
+    const filters = [];
+    const dateFilter = createDateRangeFilter(ATTRIBUTES.LAST_INTERACTION, validated.dateRange);
+    if (dateFilter.filters) {
+        filters.push(...dateFilter.filters);
+    }
+    if (validated.interactionType) {
+        filters.push({
+            attribute: { slug: ATTRIBUTES.INTERACTION_TYPE },
+            condition: FilterConditionType.EQUALS,
+            value: validated.interactionType,
+        });
+    }
+    return { filters, matchAny: false };
+}
+/**
+ * Creates a filter for records based on their last interaction date.
+ */
+export function createLastInteractionFilter(dateRange, interactionType) {
+    try {
+        const filters = [];
+        const resolvedRange = resolveDateRange(dateRange);
+        if (resolvedRange.start) {
+            filters.push({
+                attribute: { slug: ATTRIBUTES.LAST_INTERACTION },
+                condition: FilterConditionType.GREATER_THAN_OR_EQUALS,
+                value: resolvedRange.start,
+            });
+        }
+        if (resolvedRange.end) {
+            filters.push({
+                attribute: { slug: ATTRIBUTES.LAST_INTERACTION },
+                condition: FilterConditionType.LESS_THAN_OR_EQUALS,
+                value: resolvedRange.end,
+            });
+        }
+        if (interactionType && interactionType !== InteractionType.ANY) {
+            filters.push({
+                attribute: { slug: ATTRIBUTES.INTERACTION_TYPE },
+                condition: FilterConditionType.EQUALS,
+                value: interactionType,
+            });
+        }
+        return { filters, matchAny: false };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new FilterValidationError(`Failed to create interaction filter: ${message}`);
+    }
+}
+//# sourceMappingURL=activity.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"activity.js","sourceRoot":"","sources":["../../../../src/utils/filters/builders/activity.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,mBAAmB;AACnB,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,mBAAmB;AACnB,OAAO,EACL,mBAAmB,EAKnB,eAAe,EACf,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAElD;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,cAA8B;IAE9B,MAAM,SAAS,GAAG,sBAAsB,CAAC,cAAc,CAAC,CAAC;IACzD,MAAM,OAAO,GAAsB,EAAE,CAAC;IAEtC,MAAM,UAAU,GAAG,qBAAqB,CACtC,UAAU,CAAC,gBAAgB,EAC3B,SAAS,CAAC,SAAS,CACpB,CAAC;IACF,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;QACvB,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,SAAS,CAAC,eAAe,EAAE,CAAC;QAC9B,OAAO,CAAC,IAAI,CAAC;YACX,SAAS,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,gBAAgB,EAAE;YAChD,SAAS,EAAE,mBAAmB,CAAC,MAAM;YACrC,KAAK,EAAE,SAAS,CAAC,eAAe;SACjC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B,CACzC,SAAoB,EACpB,eAAiC;IAEjC,IAAI,CAAC;QACH,MAAM,OAAO,GAAsB,EAAE,CAAC;QACtC,MAAM,aAAa,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAElD,IAAI,aAAa,CAAC,KAAK,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC;gBACX,SAAS,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,gBAAgB,EAAE;gBAChD,SAAS,EAAE,mBAAmB,CAAC,sBAAsB;gBACrD,KAAK,EAAE,aAAa,CAAC,KAAK;aAC3B,CAAC,CAAC;QACL,CAAC;QAED,IAAI,aAAa,CAAC,GAAG,EAAE,CAAC;YACtB,OAAO,CAAC,IAAI,CAAC;gBACX,SAAS,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,gBAAgB,EAAE;gBAChD,SAAS,EAAE,mBAAmB,CAAC,mBAAmB;gBAClD,KAAK,EAAE,aAAa,CAAC,GAAG;aACzB,CAAC,CAAC;QACL,CAAC;QAED,IAAI,eAAe,IAAI,eAAe,KAAK,eAAe,CAAC,GAAG,EAAE,CAAC;YAC/D,OAAO,CAAC,IAAI,CAAC;gBACX,SAAS,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,gBAAgB,EAAE;gBAChD,SAAS,EAAE,mBAAmB,CAAC,MAAM;gBACrC,KAAK,EAAE,eAAe;aACvB,CAAC,CAAC;QACL,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,IAAI,qBAAqB,CAC7B,wCAAwC,OAAO,EAAE,CAClD,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * Basic comparison filter builders.
+ */
+import { ListEntryFilters } from './types.js';
+/**
+ * Creates a simple equals filter for any attribute.
+ */
+export declare function createEqualsFilter(attributeSlug: string, value: any): ListEntryFilters;
+/**
+ * Creates a simple contains filter for text attributes.
+ */
+export declare function createContainsFilter(attributeSlug: string, value: string): ListEntryFilters;
+//# sourceMappingURL=basic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"basic.d.ts","sourceRoot":"","sources":["../../../../src/utils/filters/builders/basic.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAuB,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnE;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,GAAG,GACT,gBAAgB,CAWlB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,GACZ,gBAAgB,CAWlB"}

package/dist/utils/filters/builders/basic.js

@@ -0,0 +1,36 @@
+/**
+ * Basic comparison filter builders.
+ */
+// Internal imports
+import { FilterConditionType } from './types.js';
+/**
+ * Creates a simple equals filter for any attribute.
+ */
+export function createEqualsFilter(attributeSlug, value) {
+    return {
+        filters: [
+            {
+                attribute: { slug: attributeSlug },
+                condition: FilterConditionType.EQUALS,
+                value,
+            },
+        ],
+        matchAny: false,
+    };
+}
+/**
+ * Creates a simple contains filter for text attributes.
+ */
+export function createContainsFilter(attributeSlug, value) {
+    return {
+        filters: [
+            {
+                attribute: { slug: attributeSlug },
+                condition: FilterConditionType.CONTAINS,
+                value,
+            },
+        ],
+        matchAny: false,
+    };
+}
+//# sourceMappingURL=basic.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"basic.js","sourceRoot":"","sources":["../../../../src/utils/filters/builders/basic.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,mBAAmB;AACnB,OAAO,EAAE,mBAAmB,EAAoB,MAAM,YAAY,CAAC;AAEnE;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,aAAqB,EACrB,KAAU;IAEV,OAAO;QACL,OAAO,EAAE;YACP;gBACE,SAAS,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;gBAClC,SAAS,EAAE,mBAAmB,CAAC,MAAM;gBACrC,KAAK;aACN;SACF;QACD,QAAQ,EAAE,KAAK;KAChB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,aAAqB,EACrB,KAAa;IAEb,OAAO;QACL,OAAO,EAAE;YACP;gBACE,SAAS,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;gBAClC,SAAS,EAAE,mBAAmB,CAAC,QAAQ;gBACvC,KAAK;aACN;SACF;QACD,QAAQ,EAAE,KAAK;KAChB,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,31 @@
+/**
+ * Complex and utility filter builders.
+ */
+import { ListEntryFilters } from './types.js';
+/**
+ * Creates a filter for objects in a specific list.
+ */
+export declare function createListFilter(listId: string): ListEntryFilters;
+/**
+ * Creates filters using special field handling rules.
+ */
+export declare function createFilterWithSpecialHandling(attributeSlug: string, operator: string, value: any): ListEntryFilters;
+/**
+ * Combines multiple filter sets using OR logic.
+ */
+export declare function createOrFilter(...filterSets: ListEntryFilters[]): ListEntryFilters;
+/**
+ * Combines multiple filter sets using AND logic.
+ */
+export declare function createAndFilter(...filterSets: ListEntryFilters[]): ListEntryFilters;
+/**
+ * Combines multiple filters with AND logic.
+ */
+export declare function combineWithAnd(...filters: ListEntryFilters[]): ListEntryFilters;
+/**
+ * Combines multiple filters with OR logic.
+ */
+export declare function combineWithOr(...filters: ListEntryFilters[]): ListEntryFilters;
+export declare const combineFiltersWithAnd: typeof combineWithAnd;
+export declare const combineFiltersWithOr: typeof combineWithOr;
+//# sourceMappingURL=complex.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"complex.d.ts","sourceRoot":"","sources":["../../../../src/utils/filters/builders/complex.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAGL,gBAAgB,EAGjB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAWjE;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,GAAG,GACT,gBAAgB,CAiClB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,GAAG,UAAU,EAAE,gBAAgB,EAAE,GAChC,gBAAgB,CAQlB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,GAAG,UAAU,EAAE,gBAAgB,EAAE,GAChC,gBAAgB,CAQlB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,GAAG,OAAO,EAAE,gBAAgB,EAAE,GAC7B,gBAAgB,CAElB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,GAAG,OAAO,EAAE,gBAAgB,EAAE,GAC7B,gBAAgB,CAElB;AAED,eAAO,MAAM,qBAAqB,uBAAiB,CAAC;AACpD,eAAO,MAAM,oBAAoB,sBAAgB,CAAC"}

package/dist/utils/filters/builders/complex.js

@@ -0,0 +1,92 @@
+/**
+ * Complex and utility filter builders.
+ */
+// Internal imports
+import { FilterConditionType, ATTRIBUTES, FIELD_SPECIAL_HANDLING, } from './types.js';
+/**
+ * Creates a filter for objects in a specific list.
+ */
+export function createListFilter(listId) {
+    return {
+        filters: [
+            {
+                attribute: { slug: ATTRIBUTES.LIST_ID },
+                condition: FilterConditionType.EQUALS,
+                value: listId,
+            },
+        ],
+        matchAny: false,
+    };
+}
+/**
+ * Creates filters using special field handling rules.
+ */
+export function createFilterWithSpecialHandling(attributeSlug, operator, value) {
+    const specialHandling = FIELD_SPECIAL_HANDLING[attributeSlug];
+    if (!specialHandling) {
+        return {
+            filters: [
+                {
+                    attribute: { slug: attributeSlug },
+                    condition: operator,
+                    value,
+                },
+            ],
+            matchAny: false,
+        };
+    }
+    const mappedOperator = specialHandling[operator] || operator;
+    let processedValue = value;
+    if (specialHandling.allowStringValue && typeof value === 'string') {
+        processedValue = value;
+    }
+    return {
+        filters: [
+            {
+                attribute: { slug: attributeSlug },
+                condition: mappedOperator,
+                value: processedValue,
+            },
+        ],
+        matchAny: false,
+    };
+}
+/**
+ * Combines multiple filter sets using OR logic.
+ */
+export function createOrFilter(...filterSets) {
+    const allFilters = [];
+    filterSets.forEach((filterSet) => {
+        if (filterSet.filters) {
+            allFilters.push(...filterSet.filters);
+        }
+    });
+    return { filters: allFilters, matchAny: true };
+}
+/**
+ * Combines multiple filter sets using AND logic.
+ */
+export function createAndFilter(...filterSets) {
+    const allFilters = [];
+    filterSets.forEach((filterSet) => {
+        if (filterSet.filters) {
+            allFilters.push(...filterSet.filters);
+        }
+    });
+    return { filters: allFilters, matchAny: false };
+}
+/**
+ * Combines multiple filters with AND logic.
+ */
+export function combineWithAnd(...filters) {
+    return createAndFilter(...filters);
+}
+/**
+ * Combines multiple filters with OR logic.
+ */
+export function combineWithOr(...filters) {
+    return createOrFilter(...filters);
+}
+export const combineFiltersWithAnd = combineWithAnd;
+export const combineFiltersWithOr = combineWithOr;
+//# sourceMappingURL=complex.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"complex.js","sourceRoot":"","sources":["../../../../src/utils/filters/builders/complex.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,mBAAmB;AACnB,OAAO,EACL,mBAAmB,EAGnB,UAAU,EACV,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,OAAO;QACL,OAAO,EAAE;YACP;gBACE,SAAS,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,OAAO,EAAE;gBACvC,SAAS,EAAE,mBAAmB,CAAC,MAAM;gBACrC,KAAK,EAAE,MAAM;aACd;SACF;QACD,QAAQ,EAAE,KAAK;KAChB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,+BAA+B,CAC7C,aAAqB,EACrB,QAAgB,EAChB,KAAU;IAEV,MAAM,eAAe,GAAG,sBAAsB,CAAC,aAAa,CAAC,CAAC;IAE9D,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,SAAS,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;oBAClC,SAAS,EAAE,QAA+B;oBAC1C,KAAK;iBACN;aACF;YACD,QAAQ,EAAE,KAAK;SAChB,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAAG,eAAe,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC;IAC7D,IAAI,cAAc,GAAG,KAAK,CAAC;IAE3B,IAAI,eAAe,CAAC,gBAAgB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAClE,cAAc,GAAG,KAAK,CAAC;IACzB,CAAC;IAED,OAAO;QACL,OAAO,EAAE;YACP;gBACE,SAAS,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;gBAClC,SAAS,EAAE,cAAqC;gBAChD,KAAK,EAAE,cAAc;aACtB;SACF;QACD,QAAQ,EAAE,KAAK;KAChB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAG,UAA8B;IAEjC,MAAM,UAAU,GAAsB,EAAE,CAAC;IACzC,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;QAC/B,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;YACtB,UAAU,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QACxC,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,GAAG,UAA8B;IAEjC,MAAM,UAAU,GAAsB,EAAE,CAAC;IACzC,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;QAC/B,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;YACtB,UAAU,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;QACxC,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAG,OAA2B;IAE9B,OAAO,eAAe,CAAC,GAAG,OAAO,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,GAAG,OAA2B;IAE9B,OAAO,cAAc,CAAC,GAAG,OAAO,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,cAAc,CAAC;AACpD,MAAM,CAAC,MAAM,oBAAoB,GAAG,aAAa,CAAC"}

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

@@ -0,0 +1,17 @@
+/**
+ * Date related filter builders.
+ */
+import { ListEntryFilters, DateRange } from './types.js';
+/**
+ * Creates a date range filter for a specific attribute.
+ */
+export declare function createDateRangeFilter(attributeSlug: string, dateRange: DateRange): ListEntryFilters;
+/**
+ * Creates a filter for records based on their creation date.
+ */
+export declare function createCreatedDateFilter(dateRange: DateRange): ListEntryFilters;
+/**
+ * Creates a filter for records based on their last modification date.
+ */
+export declare function createModifiedDateFilter(dateRange: DateRange): ListEntryFilters;
+//# sourceMappingURL=date.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../../../src/utils/filters/builders/date.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,EAGL,gBAAgB,EAChB,SAAS,EAEV,MAAM,YAAY,CAAC;AAGpB;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,SAAS,GACnB,gBAAgB,CA6BlB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,SAAS,GACnB,gBAAgB,CAElB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,SAAS,GACnB,gBAAgB,CAElB"}