@iflow-mcp/attio-mcp 1.3.6

package/dist/api/operations/lists.js

@@ -0,0 +1,312 @@
+/**
+ * List operations for Attio
+ * Handles list management and list entry operations
+ */
+import { getLazyAttioClient } from '../../api/lazy-client.js';
+import { createScopedLogger } from '../../utils/logger.js';
+import { callWithRetry } from './retry.js';
+import { processListEntries, transformFiltersToApiFormat, } from '../../utils/record-utils.js';
+import { FilterValidationError } from '../../errors/api-errors.js';
+/**
+ * Gets all lists in the workspace
+ *
+ * @param objectSlug - Optional object type to filter lists by (e.g., 'companies', 'people')
+ * @param limit - Maximum number of lists to fetch (default: 20)
+ * @param retryConfig - Optional retry configuration
+ * @returns Array of list objects
+ */
+export async function getAllLists(objectSlug, limit = 20, retryConfig) {
+    const api = getLazyAttioClient();
+    let path = `/lists?limit=${limit}`;
+    if (objectSlug) {
+        path += `&objectSlug=${objectSlug}`;
+    }
+    return callWithRetry(async () => {
+        const response = await api.get(path);
+        // Ensure we always return an array, never undefined/null/objects - handle multiple shape variants
+        const items = Array.isArray(response?.data?.data)
+            ? response.data.data
+            : Array.isArray(response?.data?.lists)
+                ? response.data.lists
+                : Array.isArray(response?.data?.items)
+                    ? response.data.items
+                    : Array.isArray(response?.data)
+                        ? response.data
+                        : [];
+        return items;
+    }, retryConfig);
+}
+/**
+ * Gets details for a specific list
+ *
+ * @param listId - The ID of the list
+ * @param retryConfig - Optional retry configuration
+ * @returns List details
+ */
+export async function getListDetails(listId, retryConfig) {
+    const api = getLazyAttioClient();
+    const path = `/lists/${listId}`;
+    return callWithRetry(async () => {
+        const response = await api.get(path);
+        return (response?.data?.data || response?.data);
+    }, retryConfig);
+}
+/**
+ * Gets entries in a list with pagination and filtering
+ *
+ * @param listId - The ID of the list
+ * @param limit - Maximum number of entries to fetch
+ * @param offset - Number of entries to skip
+ * @param filters - Optional filters to apply
+ * @param retryConfig - Optional retry configuration
+ * @returns Array of list entries
+ */
+export async function getListEntries(listId, limit, offset, filters, retryConfig) {
+    const api = getLazyAttioClient();
+    // Input validation - make sure we have a valid listId
+    if (!listId) {
+        throw new Error('Invalid list ID: No ID provided');
+    }
+    // Coerce input parameters to ensure proper types
+    const safeLimit = typeof limit === 'number' ? limit : undefined;
+    const safeOffset = typeof offset === 'number' ? offset : undefined;
+    // Create request body with parameters and filters
+    const createRequestBody = async () => {
+        // Start with base parameters
+        const body = {
+            expand: ['record'],
+            limit: safeLimit !== undefined ? safeLimit : 20, // Default to 20 if not specified
+            offset: safeOffset !== undefined ? safeOffset : 0, // Default to 0 if not specified
+        };
+        try {
+            // Use our shared utility to transform filters to API format
+            // Pass isListEntryContext=true since we're filtering list entries
+            // Note: resourceType is undefined for list entries as they can contain mixed record types
+            const filterObject = await transformFiltersToApiFormat(filters, true, true, undefined);
+            // Add filter to body if it exists
+            if (filterObject.filter) {
+                body.filter = filterObject.filter;
+                // Log filter transformation for debugging in development
+                if (process.env.NODE_ENV === 'development') {
+                    const log = createScopedLogger('lists.operations', 'getListEntries');
+                    log.debug('Transformed filters', {
+                        originalFilters: JSON.stringify(filters),
+                        transformedFilters: JSON.stringify(filterObject.filter),
+                        useOrLogic: filters?.matchAny === true,
+                        filterCount: filters?.filters?.length || 0,
+                    });
+                }
+            }
+        }
+        catch (err) {
+            const error = err;
+            if (error instanceof FilterValidationError) {
+                // Log the problematic filters for debugging
+                if (process.env.NODE_ENV === 'development') {
+                    const log = createScopedLogger('lists.operations', 'getListEntries');
+                    log.warn('Filter validation error', {
+                        error: error.message,
+                        providedFilters: JSON.stringify(filters),
+                    });
+                }
+                // Rethrow with more context
+                throw new Error(`Filter validation failed: ${error.message}`);
+            }
+            throw error; // Rethrow other errors
+        }
+        return body;
+    };
+    // Enhanced logging function
+    const logger = createScopedLogger('lists.operations', 'getListEntries');
+    const logOperation = (stage, details, isError = false) => {
+        if (process.env.NODE_ENV === 'development') {
+            const data = {
+                ...details,
+                listId,
+                limit: safeLimit,
+                offset: safeOffset,
+                hasFilters: filters && filters.filters ? filters.filters.length > 0 : false,
+                timestamp: new Date().toISOString(),
+            };
+            if (isError || stage.includes('failed')) {
+                logger.warn(stage, data);
+            }
+            else {
+                logger.debug(stage, data);
+            }
+        }
+    };
+    // Call primary endpoint directly (Option A simplification)
+    return callWithRetry(async () => {
+        const path = `/lists/${listId}/entries/query`;
+        const requestBody = await createRequestBody();
+        logOperation('Primary endpoint attempt', {
+            path,
+            requestBody: JSON.stringify(requestBody),
+        });
+        const response = await api.post(path, requestBody);
+        logOperation('Primary endpoint successful', {
+            resultCount: response.data?.data?.length || 0,
+        });
+        return processListEntries(response.data?.data || []);
+    }, retryConfig);
+}
+/**
+ * Adds a record to a list
+ *
+ * @param listId - The ID of the list
+ * @param recordId - The ID of the record to add
+ * @param objectType - Optional object type ('companies', 'people', etc.)
+ * @param initialValues - Optional initial values for the list entry (e.g., stage)
+ * @param retryConfig - Optional retry configuration
+ * @returns The created list entry
+ */
+export async function addRecordToList(listId, recordId, objectType, initialValues, retryConfig) {
+    const api = getLazyAttioClient();
+    const path = `/lists/${listId}/entries`;
+    // Input validation to ensure required parameters
+    if (!listId || typeof listId !== 'string') {
+        throw new Error('Invalid list ID: Must be a non-empty string');
+    }
+    if (!recordId || typeof recordId !== 'string') {
+        throw new Error('Invalid record ID: Must be a non-empty string');
+    }
+    // Default object type to 'companies' if not specified
+    const safeObjectType = objectType || 'companies';
+    return callWithRetry(async () => {
+        const log = createScopedLogger('lists.operations', 'addRecordToList');
+        try {
+            // Construct proper API payload according to Attio API requirements
+            // The API expects parent_record_id, parent_object, and entry_values (required, even if empty)
+            const payload = {
+                data: {
+                    parent_record_id: recordId,
+                    parent_object: safeObjectType,
+                    // entry_values is required by the API, use empty object if no initial values provided
+                    entry_values: initialValues || {},
+                },
+            };
+            if (process.env.NODE_ENV === 'development') {
+                log.info('Adding record to list', {
+                    path,
+                    listId,
+                    recordId,
+                    safeObjectType,
+                    initialValues: initialValues ?? null,
+                    payload,
+                });
+            }
+            const response = await api.post(path, payload);
+            if (process.env.NODE_ENV === 'development') {
+                log.info('Add record success', { data: response.data });
+            }
+            return response?.data?.data || response?.data;
+        }
+        catch (error) {
+            const listError = error;
+            // Enhanced error logging with detailed information
+            if (process.env.NODE_ENV === 'development') {
+                log.warn('Add record error', {
+                    message: listError.message || 'Unknown error',
+                    status: listError.response?.status,
+                    data: listError.response?.data || {},
+                    validationErrors: listError.response?.data?.validation_errors,
+                });
+            }
+            // Add more context to the error message
+            if (listError.response?.status === 400) {
+                const validationErrors = listError.response?.data?.validation_errors || [];
+                const errorDetails = validationErrors
+                    .map((e) => `${e.path.join('.')}: ${e.message}`)
+                    .join('; ');
+                throw new Error(`Validation error adding record to list: ${errorDetails || listError.message}`);
+            }
+            // Let upstream handlers create specific, rich error objects.
+            throw error;
+        }
+    }, retryConfig);
+}
+/**
+ * Updates a list entry (e.g., changing stage)
+ *
+ * @param listId - The ID of the list
+ * @param entryId - The ID of the list entry to update
+ * @param attributes - The attributes to update (e.g., { stage: "Demo Scheduling" })
+ * @param retryConfig - Optional retry configuration
+ * @returns The updated list entry
+ */
+export async function updateListEntry(listId, entryId, attributes, retryConfig) {
+    const api = getLazyAttioClient();
+    const path = `/lists/${listId}/entries/${entryId}`;
+    // Input validation
+    if (!listId || typeof listId !== 'string') {
+        throw new Error('Invalid list ID: Must be a non-empty string');
+    }
+    if (!entryId || typeof entryId !== 'string') {
+        throw new Error('Invalid entry ID: Must be a non-empty string');
+    }
+    if (!attributes ||
+        typeof attributes !== 'object' ||
+        Array.isArray(attributes)) {
+        throw new Error('Invalid attributes: Must be a non-empty object');
+    }
+    return callWithRetry(async () => {
+        const log = createScopedLogger('lists.operations', 'updateListEntry');
+        try {
+            if (process.env.NODE_ENV === 'development') {
+                log.info('Updating list entry', { path, listId, entryId, attributes });
+            }
+            // Attio API expects updates to list entries in the 'data.entry_values' structure
+            // This is specific to list entries, different from record updates in crud.ts
+            const response = await api.patch(path, {
+                data: {
+                    entry_values: attributes,
+                },
+            });
+            if (process.env.NODE_ENV === 'development') {
+                log.info('Update list entry success', { data: response.data });
+            }
+            return response?.data?.data || response?.data;
+        }
+        catch (error) {
+            const updateError = error;
+            // Enhanced error logging with specific error types
+            if (process.env.NODE_ENV === 'development') {
+                log.warn('Update list entry error', {
+                    message: updateError.message || 'Unknown error',
+                    status: updateError.response?.status,
+                    data: updateError.response?.data || {},
+                });
+            }
+            // Add more specific error types based on status codes
+            if (updateError.response?.status === 404) {
+                throw new Error(`List entry ${entryId} not found in list ${listId}`);
+            }
+            else if (updateError.response?.status === 400) {
+                throw new Error(`Invalid attributes for list entry update: ${updateError.response?.data?.message || 'Bad request'}`);
+            }
+            else if (updateError.response?.status === 403) {
+                throw new Error(`Insufficient permissions to update list entry ${entryId} in list ${listId}`);
+            }
+            // Let upstream handlers create specific, rich error objects.
+            throw error;
+        }
+    }, retryConfig);
+}
+/**
+ * Removes a record from a list
+ *
+ * @param listId - The ID of the list
+ * @param entryId - The ID of the list entry to remove
+ * @param retryConfig - Optional retry configuration
+ * @returns True if successful
+ */
+export async function removeRecordFromList(listId, entryId, retryConfig) {
+    const api = getLazyAttioClient();
+    const path = `/lists/${listId}/entries/${entryId}`;
+    return callWithRetry(async () => {
+        await api.delete(path);
+        return true;
+    }, retryConfig);
+}
+//# sourceMappingURL=lists.js.map

package/dist/api/operations/lists.js.map

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

package/dist/api/operations/notes.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Note operations for Attio objects
+ * Handles note creation and retrieval
+ */
+import { AttioNote, ResourceType } from '../../types/attio.js';
+import { RetryConfig } from '../../api/operations/retry.js';
+/**
+ * Generic function to get notes for a specific record
+ *
+ * @param objectType - The type of parent object (people or companies)
+ * @param recordId - ID of the parent record
+ * @param limit - Maximum number of notes to return
+ * @param offset - Number of notes to skip
+ * @param retryConfig - Optional retry configuration
+ * @returns Array of notes
+ */
+export declare function getObjectNotes(objectType: ResourceType, recordId: string, limit?: number, offset?: number, retryConfig?: Partial<RetryConfig>): Promise<AttioNote[]>;
+/**
+ * Generic function to create a note for any object type
+ *
+ * @param objectType - The type of parent object (people or companies)
+ * @param recordId - ID of the parent record
+ * @param noteTitle - Title of the note
+ * @param noteText - Content of the note
+ * @param format - Content format ('plaintext' | 'markdown'), defaults to 'plaintext'
+ * @param retryConfig - Optional retry configuration
+ * @returns Created note
+ */
+export declare function createObjectNote(objectType: ResourceType, recordId: string, noteTitle: string, noteText: string, format?: 'plaintext' | 'markdown', retryConfig?: Partial<RetryConfig>): Promise<AttioNote>;
+//# sourceMappingURL=notes.d.ts.map

package/dist/api/operations/notes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notes.d.ts","sourceRoot":"","sources":["../../../src/api/operations/notes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,SAAS,EACT,YAAY,EAGb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAiB,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAEvE;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,YAAY,EACxB,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,MAAW,EAClB,MAAM,GAAE,MAAU,EAClB,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GACjC,OAAO,CAAC,SAAS,EAAE,CAAC,CAQtB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,YAAY,EACxB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,WAAW,GAAG,UAAwB,EAC9C,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GACjC,OAAO,CAAC,SAAS,CAAC,CAgBpB"}

package/dist/api/operations/notes.js

@@ -0,0 +1,52 @@
+/**
+ * Note operations for Attio objects
+ * Handles note creation and retrieval
+ */
+import { getLazyAttioClient } from '../../api/lazy-client.js';
+import { callWithRetry } from '../../api/operations/retry.js';
+/**
+ * Generic function to get notes for a specific record
+ *
+ * @param objectType - The type of parent object (people or companies)
+ * @param recordId - ID of the parent record
+ * @param limit - Maximum number of notes to return
+ * @param offset - Number of notes to skip
+ * @param retryConfig - Optional retry configuration
+ * @returns Array of notes
+ */
+export async function getObjectNotes(objectType, recordId, limit = 10, offset = 0, retryConfig) {
+    const api = getLazyAttioClient();
+    const path = `/notes?limit=${limit}&offset=${offset}&parent_object=${objectType}&parent_record_id=${recordId}`;
+    return callWithRetry(async () => {
+        const response = await api.get(path);
+        return response?.data?.data || [];
+    }, retryConfig);
+}
+/**
+ * Generic function to create a note for any object type
+ *
+ * @param objectType - The type of parent object (people or companies)
+ * @param recordId - ID of the parent record
+ * @param noteTitle - Title of the note
+ * @param noteText - Content of the note
+ * @param format - Content format ('plaintext' | 'markdown'), defaults to 'plaintext'
+ * @param retryConfig - Optional retry configuration
+ * @returns Created note
+ */
+export async function createObjectNote(objectType, recordId, noteTitle, noteText, format = 'plaintext', retryConfig) {
+    const api = getLazyAttioClient();
+    const path = '/notes';
+    return callWithRetry(async () => {
+        const response = await api.post(path, {
+            data: {
+                format,
+                parent_object: objectType,
+                parent_record_id: recordId,
+                title: `[AI] ${noteTitle}`,
+                content: noteText,
+            },
+        });
+        return (response?.data?.data || response?.data);
+    }, retryConfig);
+}
+//# sourceMappingURL=notes.js.map

package/dist/api/operations/notes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notes.js","sourceRoot":"","sources":["../../../src/api/operations/notes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAO1D,OAAO,EAAE,aAAa,EAAe,MAAM,2BAA2B,CAAC;AAEvE;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,UAAwB,EACxB,QAAgB,EAChB,QAAgB,EAAE,EAClB,SAAiB,CAAC,EAClB,WAAkC;IAElC,MAAM,GAAG,GAAG,kBAAkB,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,gBAAgB,KAAK,WAAW,MAAM,kBAAkB,UAAU,qBAAqB,QAAQ,EAAE,CAAC;IAE/G,OAAO,aAAa,CAAC,KAAK,IAAI,EAAE;QAC9B,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,GAAG,CAA+B,IAAI,CAAC,CAAC;QACnE,OAAO,QAAQ,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;IACpC,CAAC,EAAE,WAAW,CAAC,CAAC;AAClB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,UAAwB,EACxB,QAAgB,EAChB,SAAiB,EACjB,QAAgB,EAChB,SAAmC,WAAW,EAC9C,WAAkC;IAElC,MAAM,GAAG,GAAG,kBAAkB,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,QAAQ,CAAC;IAEtB,OAAO,aAAa,CAAC,KAAK,IAAI,EAAE;QAC9B,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,IAAI,CAAiC,IAAI,EAAE;YACpE,IAAI,EAAE;gBACJ,MAAM;gBACN,aAAa,EAAE,UAAU;gBACzB,gBAAgB,EAAE,QAAQ;gBAC1B,KAAK,EAAE,QAAQ,SAAS,EAAE;gBAC1B,OAAO,EAAE,QAAQ;aAClB;SACF,CAAC,CAAC;QACH,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,IAAI,QAAQ,EAAE,IAAI,CAAc,CAAC;IAC/D,CAAC,EAAE,WAAW,CAAC,CAAC;AAClB,CAAC"}

package/dist/api/operations/query-parser.d.ts

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+declare const parsedQuerySchema: z.ZodObject<{
+    originalQuery: z.ZodString;
+    normalizedQuery: z.ZodString;
+    tokens: z.ZodArray<z.ZodString, "many">;
+    emails: z.ZodArray<z.ZodString, "many">;
+    domains: z.ZodArray<z.ZodString, "many">;
+    phones: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    originalQuery: string;
+    normalizedQuery: string;
+    tokens: string[];
+    emails: string[];
+    domains: string[];
+    phones: string[];
+}, {
+    originalQuery: string;
+    normalizedQuery: string;
+    tokens: string[];
+    emails: string[];
+    domains: string[];
+    phones: string[];
+}>;
+export type ParsedQuery = z.infer<typeof parsedQuerySchema>;
+export declare function parseQuery(query: string): ParsedQuery;
+export {};
+//# sourceMappingURL=query-parser.d.ts.map

package/dist/api/operations/query-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-parser.d.ts","sourceRoot":"","sources":["../../../src/api/operations/query-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,QAAA,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;EAOrB,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AA6G5D,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAiCrD"}

package/dist/api/operations/query-parser.js

@@ -0,0 +1,123 @@
+import { z } from 'zod';
+const NON_DIGIT_PATTERN = /\D+/g;
+const EMAIL_PATTERN = /\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,}\b/g;
+const PHONE_CANDIDATE_PATTERN = /\+?\d[\d().\s-]{5,}\d/g;
+const DOMAIN_PATTERN = /\b(?:[a-zA-Z0-9][-a-zA-Z0-9]*\.)+[a-zA-Z]{2,}\b/g;
+const MIN_PHONE_DIGITS = 7;
+const MAX_PHONE_DIGITS = 15;
+const parsedQuerySchema = z.object({
+    originalQuery: z.string(),
+    normalizedQuery: z.string(),
+    tokens: z.array(z.string()),
+    emails: z.array(z.string()),
+    domains: z.array(z.string()),
+    phones: z.array(z.string()),
+});
+function extractEmails(query) {
+    const matches = query.match(EMAIL_PATTERN) || [];
+    let remaining = query;
+    matches.forEach((match) => {
+        remaining = remaining.replace(match, ' ');
+    });
+    return { emails: matches.map((email) => email.toLowerCase()), remaining };
+}
+function looksLikeNorthAmericanNumber(digitsOnly) {
+    if (digitsOnly.length !== 10) {
+        return false;
+    }
+    const firstDigit = digitsOnly[0];
+    return firstDigit >= '2' && firstDigit <= '9';
+}
+function extractPhones(query) {
+    const matches = query.match(PHONE_CANDIDATE_PATTERN) || [];
+    let remaining = query;
+    const phoneVariants = new Set();
+    matches.forEach((match) => {
+        remaining = remaining.replace(match, ' ');
+        const digitsOnly = match.replace(NON_DIGIT_PATTERN, '');
+        if (digitsOnly.length < MIN_PHONE_DIGITS ||
+            digitsOnly.length > MAX_PHONE_DIGITS) {
+            return;
+        }
+        const trimmed = match.trim();
+        const hasExplicitPlus = trimmed.startsWith('+');
+        phoneVariants.add(digitsOnly);
+        if (hasExplicitPlus || digitsOnly.length > 11) {
+            phoneVariants.add(`+${digitsOnly}`);
+        }
+        if (!hasExplicitPlus && looksLikeNorthAmericanNumber(digitsOnly)) {
+            phoneVariants.add(`+1${digitsOnly}`);
+        }
+        if (!hasExplicitPlus &&
+            digitsOnly.length === 11 &&
+            digitsOnly.startsWith('1')) {
+            phoneVariants.add(`+${digitsOnly}`);
+        }
+    });
+    return { phones: Array.from(phoneVariants), remaining };
+}
+function extractDomains(query, emails) {
+    // Extract domains from emails
+    const domainsFromEmails = emails
+        .map((email) => email.split('@')[1])
+        .filter((domain) => Boolean(domain));
+    // Extract standalone domains from query
+    const standaloneDomains = query.match(DOMAIN_PATTERN) || [];
+    let remaining = query;
+    standaloneDomains.forEach((match) => {
+        remaining = remaining.replace(match, ' ');
+    });
+    return {
+        domains: Array.from(new Set([
+            ...domainsFromEmails,
+            ...standaloneDomains.map((d) => d.toLowerCase()),
+        ])),
+        remaining,
+    };
+}
+function tokenize(query) {
+    const seen = new Set();
+    return query
+        .split(/\s+/)
+        .map((token) => token.trim())
+        .filter((token) => {
+        if (!token) {
+            return false;
+        }
+        const normalized = token.toLowerCase();
+        if (seen.has(normalized)) {
+            return false;
+        }
+        seen.add(normalized);
+        return true;
+    });
+}
+export function parseQuery(query) {
+    const trimmed = query.trim();
+    if (!trimmed) {
+        return parsedQuerySchema.parse({
+            originalQuery: query,
+            normalizedQuery: '',
+            tokens: [],
+            emails: [],
+            domains: [],
+            phones: [],
+        });
+    }
+    const emailResults = extractEmails(trimmed);
+    const phoneResults = extractPhones(emailResults.remaining);
+    const domainResults = extractDomains(phoneResults.remaining, emailResults.emails);
+    const emails = emailResults.emails;
+    const phones = phoneResults.phones;
+    const domains = domainResults.domains;
+    const tokens = tokenize(domainResults.remaining);
+    return parsedQuerySchema.parse({
+        originalQuery: query,
+        normalizedQuery: trimmed.toLowerCase(),
+        tokens,
+        emails,
+        domains,
+        phones,
+    });
+}
+//# sourceMappingURL=query-parser.js.map

package/dist/api/operations/query-parser.js.map

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

package/dist/api/operations/retry.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Retry logic for API operations
+ * Handles retryable errors with configurable backoff strategies
+ */
+import { ApiError } from '../../types/api-operations.js';
+/**
+ * Configuration options for API call retry
+ */
+export interface RetryConfig {
+    /** Maximum number of retry attempts */
+    maxRetries: number;
+    /** Initial delay in milliseconds before the first retry */
+    initialDelay: number;
+    /** Maximum delay in milliseconds between retries */
+    maxDelay: number;
+    /** Whether to use exponential backoff for retry delays */
+    useExponentialBackoff: boolean;
+    /** HTTP status codes that should trigger a retry */
+    retryableStatusCodes: number[];
+}
+/**
+ * Default retry configuration
+ */
+export declare const DEFAULT_RETRY_CONFIG: RetryConfig;
+/**
+ * Calculate delay time for retry with optional exponential backoff
+ *
+ * @param attempt - Current attempt number (0-based)
+ * @param config - Retry configuration
+ * @returns Delay time in milliseconds
+ */
+export declare function calculateRetryDelay(attempt: number, config: RetryConfig): number;
+/**
+ * Determines if an error should trigger a retry
+ *
+ * @param error - Error to check
+ * @param config - Retry configuration
+ * @returns Whether the error should trigger a retry
+ */
+export declare function isRetryableError(error: ApiError, config: RetryConfig): boolean;
+/**
+ * Execute an API call with retry logic
+ *
+ * @param fn - Function that returns a promise for the API call
+ * @param config - Retry configuration
+ * @returns Promise that resolves with the API response
+ */
+export declare function callWithRetry<T>(fn: () => Promise<T>, config?: Partial<RetryConfig>): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/api/operations/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../src/api/operations/retry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAGzD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,qBAAqB,EAAE,OAAO,CAAC;IAC/B,oDAAoD;IACpD,oBAAoB,EAAE,MAAM,EAAE,CAAC;CAChC;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAMlC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,WAAW,GAClB,MAAM,CAYR;AAYD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,QAAQ,EACf,MAAM,EAAE,WAAW,GAClB,OAAO,CAeT;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,CAAC,EACnC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAChC,OAAO,CAAC,CAAC,CAAC,CA6CZ"}