@iflow-mcp/attio-mcp 1.3.6

package/dist/objects/people-write.js

@@ -0,0 +1,250 @@
+import { ResourceType } from '../types/attio.js';
+import { createObjectWithDynamicFields, updateObjectWithDynamicFields, updateObjectAttributeWithDynamicFields, deleteObjectWithValidation, } from './base-operations.js';
+import { AttioApiError } from '../utils/error-handler.js';
+import { getAttributeSlugById } from '../api/attribute-types.js';
+import { searchCompanies } from './companies/search.js';
+import { isValidEmail } from '../utils/validation/email-validation.js';
+import { PersonOperationError, InvalidPersonDataError, } from './people/errors.js';
+import { searchPeopleByEmails } from './people/email-validation.js';
+// Type guards for safer email handling
+function hasEmailAddressField(item) {
+    return (typeof item === 'object' &&
+        item !== null &&
+        'email_address' in item &&
+        typeof item.email_address === 'string');
+}
+function hasEmailField(item) {
+    return (typeof item === 'object' &&
+        item !== null &&
+        'email' in item &&
+        typeof item.email === 'string');
+}
+function hasValueField(item) {
+    return (typeof item === 'object' &&
+        item !== null &&
+        'value' in item &&
+        typeof item.value === 'string');
+}
+// Re-export error classes for backward compatibility
+export { PersonOperationError, InvalidPersonDataError, } from './people/errors.js';
+/**
+ * Simple validator for person data
+ * Can be enhanced with more specific validation rules
+ */
+export class PersonValidator {
+    static async validateCreate(attributes) {
+        // Basic validation - ensure we have at least an email or name
+        if (!attributes.email_addresses && !attributes.name) {
+            throw new InvalidPersonDataError('Must provide at least an email address or name');
+        }
+        // Ensure email_addresses is an array if provided
+        if (attributes.email_addresses &&
+            !Array.isArray(attributes.email_addresses)) {
+            attributes.email_addresses = [attributes.email_addresses];
+        }
+        // Validate email format BEFORE checking for duplicates
+        if (attributes.email_addresses) {
+            const extractedEmails = [];
+            const emailArray = Array.isArray(attributes.email_addresses)
+                ? attributes.email_addresses
+                : [attributes.email_addresses];
+            for (const emailItem of emailArray) {
+                let emailAddress;
+                // Type assertion needed here because emailItem can be string or object formats
+                const item = emailItem;
+                // Handle different email formats (same logic as ValidationService)
+                if (typeof item === 'string') {
+                    emailAddress = item;
+                }
+                else if (hasEmailAddressField(item)) {
+                    emailAddress = item.email_address;
+                }
+                else if (hasEmailField(item)) {
+                    emailAddress = item.email;
+                }
+                else if (hasValueField(item)) {
+                    emailAddress = item.value;
+                }
+                else {
+                    throw new InvalidPersonDataError(`Invalid email format: "${JSON.stringify(emailItem)}". Please provide a valid email address (e.g., user@example.com)`);
+                }
+                if (!isValidEmail(emailAddress)) {
+                    throw new InvalidPersonDataError(`Invalid email format: "${emailAddress}". Please provide a valid email address (e.g., user@example.com)`);
+                }
+                extractedEmails.push(emailAddress);
+            }
+            // Check for duplicate emails using batch validation for better performance
+            const emailResults = await searchPeopleByEmails(extractedEmails);
+            const duplicateEmails = emailResults.filter((result) => result.exists);
+            if (duplicateEmails.length > 0) {
+                const duplicateList = duplicateEmails
+                    .map((result) => result.email)
+                    .join(', ');
+                throw new InvalidPersonDataError(`Person(s) with email(s) ${duplicateList} already exist`);
+            }
+        }
+        // Resolve company name to record reference
+        if (attributes.company && typeof attributes.company === 'string') {
+            const companyName = attributes.company;
+            const results = await searchCompanies(companyName);
+            if (results.length === 1) {
+                // TypeScript needs help understanding the type mutation here
+                attributes.company = { record_id: results[0].id?.record_id || '' };
+            }
+            else if (results.length === 0) {
+                throw new InvalidPersonDataError(`Company '${companyName}' not found. Provide a valid company ID.`);
+            }
+            else {
+                throw new InvalidPersonDataError(`Multiple companies match '${companyName}'. Please specify the company ID.`);
+            }
+        }
+        return attributes;
+    }
+    static async validateUpdate(personId, attributes) {
+        if (!personId || typeof personId !== 'string') {
+            throw new InvalidPersonDataError('Person ID must be a non-empty string');
+        }
+        // Ensure at least one attribute is being updated
+        if (!attributes || Object.keys(attributes).length === 0) {
+            throw new InvalidPersonDataError('Must provide at least one attribute to update');
+        }
+        return attributes;
+    }
+    static async validateAttributeUpdate(personId, attributeName, attributeValue) {
+        if (!personId || typeof personId !== 'string') {
+            throw new InvalidPersonDataError('Person ID must be a non-empty string');
+        }
+        if (!attributeName || typeof attributeName !== 'string') {
+            throw new InvalidPersonDataError('Attribute name must be a non-empty string');
+        }
+        // Special validation for email_addresses
+        if (attributeName === 'email_addresses' && attributeValue) {
+            const emails = Array.isArray(attributeValue)
+                ? attributeValue
+                : [attributeValue];
+            for (const emailItem of emails) {
+                let emailAddress;
+                // Type assertion needed here because emailItem can be string or object formats
+                const item = emailItem;
+                // Handle different email formats (same logic as ValidationService)
+                if (typeof item === 'string') {
+                    emailAddress = item;
+                }
+                else if (hasEmailAddressField(item)) {
+                    emailAddress = item.email_address;
+                }
+                else if (hasEmailField(item)) {
+                    emailAddress = item.email;
+                }
+                else if (hasValueField(item)) {
+                    emailAddress = item.value;
+                }
+                else {
+                    throw new InvalidPersonDataError(`Invalid email format: "${JSON.stringify(emailItem)}". Please provide a valid email address (e.g., user@example.com)`);
+                }
+                if (!isValidEmail(emailAddress)) {
+                    throw new InvalidPersonDataError(`Invalid email format: "${emailAddress}". Please provide a valid email address (e.g., user@example.com)`);
+                }
+            }
+        }
+    }
+    static validateDelete(personId) {
+        if (!personId || typeof personId !== 'string') {
+            throw new InvalidPersonDataError('Person ID must be a non-empty string');
+        }
+    }
+}
+/**
+ * Creates a new person
+ *
+ * @param attributes - Person attributes as key-value pairs
+ * @returns Created person record
+ * @throws InvalidPersonDataError if validation fails
+ * @throws PersonOperationError if creation fails
+ */
+export async function createPerson(attributes) {
+    try {
+        return await createObjectWithDynamicFields(ResourceType.PEOPLE, attributes, PersonValidator.validateCreate);
+    }
+    catch (error) {
+        if (error instanceof InvalidPersonDataError) {
+            throw error;
+        }
+        if (error instanceof AttioApiError) {
+            const detail = typeof error.detail === 'string' ? error.detail : '';
+            const match = detail.match(/attribute with ID "([^"]+)"/);
+            if (match) {
+                const slug = await getAttributeSlugById(ResourceType.PEOPLE, match[1]);
+                if (slug) {
+                    const friendly = detail.replace(match[1], slug);
+                    throw new PersonOperationError('create', undefined, friendly);
+                }
+            }
+        }
+        throw new PersonOperationError('create', undefined, error instanceof Error ? error.message : String(error));
+    }
+}
+/**
+ * Updates an existing person
+ *
+ * @param personId - ID of the person to update
+ * @param attributes - Person attributes to update
+ * @returns Updated person record
+ * @throws InvalidPersonDataError if validation fails
+ * @throws PersonOperationError if update fails
+ */
+export async function updatePerson(personId, attributes) {
+    try {
+        return await updateObjectWithDynamicFields(ResourceType.PEOPLE, personId, attributes, PersonValidator.validateUpdate);
+    }
+    catch (error) {
+        if (error instanceof InvalidPersonDataError) {
+            throw error;
+        }
+        throw new PersonOperationError('update', personId, error instanceof Error ? error.message : String(error));
+    }
+}
+/**
+ * Updates a specific attribute of a person
+ *
+ * @param personId - ID of the person to update
+ * @param attributeName - Name of the attribute to update
+ * @param attributeValue - New value for the attribute
+ * @returns Updated person record
+ * @throws InvalidPersonDataError if validation fails
+ * @throws PersonOperationError if update fails
+ */
+export async function updatePersonAttribute(personId, attributeName, attributeValue) {
+    try {
+        // Validate attribute update
+        await PersonValidator.validateAttributeUpdate(personId, attributeName, attributeValue);
+        return await updateObjectAttributeWithDynamicFields(ResourceType.PEOPLE, personId, attributeName, attributeValue, updatePerson);
+    }
+    catch (error) {
+        if (error instanceof InvalidPersonDataError ||
+            error instanceof PersonOperationError) {
+            throw error;
+        }
+        throw new PersonOperationError('update attribute', personId, error instanceof Error ? error.message : String(error));
+    }
+}
+/**
+ * Deletes a person
+ *
+ * @param personId - ID of the person to delete
+ * @returns True if deletion was successful
+ * @throws InvalidPersonDataError if validation fails
+ * @throws PersonOperationError if deletion fails
+ */
+export async function deletePerson(personId) {
+    try {
+        return await deleteObjectWithValidation(ResourceType.PEOPLE, personId, PersonValidator.validateDelete);
+    }
+    catch (error) {
+        if (error instanceof InvalidPersonDataError) {
+            throw error;
+        }
+        throw new PersonOperationError('delete', personId, error instanceof Error ? error.message : String(error));
+    }
+}
+//# sourceMappingURL=people-write.js.map

package/dist/objects/people-write.js.map

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

package/dist/objects/records/formatters.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Record formatting utilities
+ */
+import { RecordAttributes } from '../../types/attio.js';
+/**
+ * Helper function to format a single record attribute based on type
+ *
+ * @param key - Attribute key
+ * @param value - Attribute value to format
+ * @returns Properly formatted attribute value for the API
+ */
+export declare function formatRecordAttribute(key: string, value: unknown): unknown;
+/**
+ * Formats a full set of record attributes for API requests
+ *
+ * @param attributes - Raw attribute key-value pairs
+ * @returns Formatted attributes object ready for API submission
+ */
+export declare function formatRecordAttributes(attributes: Record<string, unknown>): RecordAttributes;
+//# sourceMappingURL=formatters.d.ts.map

package/dist/objects/records/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../../src/objects/records/formatters.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAuC1E;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,gBAAgB,CAQlB"}

package/dist/objects/records/formatters.js

@@ -0,0 +1,50 @@
+/**
+ * Helper function to format a single record attribute based on type
+ *
+ * @param key - Attribute key
+ * @param value - Attribute value to format
+ * @returns Properly formatted attribute value for the API
+ */
+export function formatRecordAttribute(key, value) {
+    if (value === null || value === undefined) {
+        return value;
+    }
+    if (value instanceof Date) {
+        return value.toISOString();
+    }
+    if (typeof value === 'number' &&
+        (key.includes('price') || key.includes('revenue') || key.includes('cost'))) {
+        return value;
+    }
+    if (typeof value === 'object' &&
+        value !== null &&
+        !Array.isArray(value) &&
+        (key.includes('address') || key.includes('location'))) {
+        const addressCandidate = value;
+        if ('street' in addressCandidate ||
+            'city' in addressCandidate ||
+            'country' in addressCandidate) {
+            return addressCandidate;
+        }
+    }
+    if (typeof value === 'string' && value.match(/^record_[a-z0-9]+$/)) {
+        return {
+            record_id: value,
+        };
+    }
+    return value;
+}
+/**
+ * Formats a full set of record attributes for API requests
+ *
+ * @param attributes - Raw attribute key-value pairs
+ * @returns Formatted attributes object ready for API submission
+ */
+export function formatRecordAttributes(attributes) {
+    const formattedAttributes = {};
+    for (const [key, value] of Object.entries(attributes)) {
+        formattedAttributes[key] = formatRecordAttribute(key, value);
+    }
+    return formattedAttributes;
+}
+//# sourceMappingURL=formatters.js.map

package/dist/objects/records/formatters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.js","sourceRoot":"","sources":["../../../src/objects/records/formatters.ts"],"names":[],"mappings":"AAKA;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAW,EAAE,KAAc;IAC/D,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;IAC7B,CAAC;IAED,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAC1E,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACrB,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,EACrD,CAAC;QACD,MAAM,gBAAgB,GAAG,KAAgC,CAAC;QAC1D,IACE,QAAQ,IAAI,gBAAgB;YAC5B,MAAM,IAAI,gBAAgB;YAC1B,SAAS,IAAI,gBAAgB,EAC7B,CAAC;YACD,OAAO,gBAAgB,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,oBAAoB,CAAC,EAAE,CAAC;QACnE,OAAO;YACL,SAAS,EAAE,KAAK;SACjB,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,UAAmC;IAEnC,MAAM,mBAAmB,GAAqB,EAAE,CAAC;IAEjD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACtD,mBAAmB,CAAC,GAAG,CAAC,GAAG,qBAAqB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,mBAAmB,CAAC;AAC7B,CAAC"}

package/dist/objects/records/index.d.ts

@@ -0,0 +1,74 @@
+import { BatchConfig, BatchResponse } from '../../api/operations/index.js';
+import { ResourceType, AttioRecord, RecordAttributes, RecordListParams } from '../../types/attio.js';
+/**
+ * Creates a new record for a specific object type
+ *
+ * @param objectSlug - Object slug (e.g., 'companies', 'people')
+ * @param attributes - Record attributes as key-value pairs
+ * @param objectId - Optional object ID (alternative to slug)
+ * @returns Created record
+ */
+export declare function createObjectRecord<T extends AttioRecord>(objectSlug: string | ResourceType, attributes: RecordAttributes, objectId?: string): Promise<T>;
+/**
+ * Gets details for a specific record
+ *
+ * @param objectSlug - Object slug (e.g., 'companies', 'people')
+ * @param recordId - ID of the record to retrieve
+ * @param attributes - Optional list of attribute slugs to include
+ * @param objectId - Optional object ID (alternative to slug)
+ * @returns Record details
+ */
+export declare function getObjectRecord<T extends AttioRecord>(objectSlug: string, recordId: string, attributes?: string[], objectId?: string): Promise<T>;
+/**
+ * Updates a specific record
+ *
+ * @param objectSlug - Object slug (e.g., 'companies', 'people')
+ * @param recordId - ID of the record to update
+ * @param attributes - Record attributes to update
+ * @param objectId - Optional object ID (alternative to slug)
+ * @returns Updated record
+ */
+export declare function updateObjectRecord<T extends AttioRecord>(objectSlug: string, recordId: string, attributes: RecordAttributes, objectId?: string): Promise<T>;
+/**
+ * Deletes a specific record
+ *
+ * @param objectSlug - Object slug (e.g., 'companies', 'people')
+ * @param recordId - ID of the record to delete
+ * @param objectId - Optional object ID (alternative to slug)
+ * @returns True if deletion was successful
+ */
+export declare function deleteObjectRecord(objectSlug: string, recordId: string, objectId?: string): Promise<boolean>;
+/**
+ * Lists records for a specific object type with filtering options
+ *
+ * @param objectSlug - Object slug (e.g., 'companies', 'people')
+ * @param options - Optional listing options (pagination, filtering, etc.)
+ * @param objectId - Optional object ID (alternative to slug)
+ * @returns Array of records
+ */
+export declare function listObjectRecords<T extends AttioRecord>(objectSlug: string, options?: Omit<RecordListParams, 'objectSlug' | 'objectId'>, objectId?: string): Promise<T[]>;
+/**
+ * Creates multiple records in a batch operation
+ *
+ * @param objectSlug - Object slug (e.g., 'companies', 'people')
+ * @param records - Array of record attributes to create
+ * @param objectId - Optional object ID (alternative to slug)
+ * @param batchConfig - Optional batch configuration
+ * @returns Batch response with created records
+ */
+export declare function batchCreateObjectRecords<T extends AttioRecord>(objectSlug: string, records: RecordAttributes[], objectId?: string, batchConfig?: Partial<BatchConfig>): Promise<BatchResponse<T>>;
+/**
+ * Updates multiple records in a batch operation
+ *
+ * @param objectSlug - Object slug (e.g., 'companies', 'people')
+ * @param records - Array of records with IDs and attributes to update
+ * @param objectId - Optional object ID (alternative to slug)
+ * @param batchConfig - Optional batch configuration
+ * @returns Batch response with updated records
+ */
+export declare function batchUpdateObjectRecords<T extends AttioRecord>(objectSlug: string, records: Array<{
+    id: string;
+    attributes: RecordAttributes;
+}>, objectId?: string, batchConfig?: Partial<BatchConfig>): Promise<BatchResponse<T>>;
+export { formatRecordAttribute, formatRecordAttributes } from './formatters.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/objects/records/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/objects/records/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAQL,WAAW,EACX,aAAa,EACd,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAO9B;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,SAAS,WAAW,EAC5D,UAAU,EAAE,MAAM,GAAG,YAAY,EACjC,UAAU,EAAE,gBAAgB,EAC5B,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,CAAC,CAAC,CAkTZ;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,CAAC,SAAS,WAAW,EACzD,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EAAE,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,CAAC,CAAC,CA6BZ;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,SAAS,WAAW,EAC5D,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,gBAAgB,EAC5B,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,CAAC,CAAC,CA0DZ;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAqClB;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,SAAS,WAAW,EAC3D,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,YAAY,GAAG,UAAU,CAAM,EAC/D,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,CAAC,EAAE,CAAC,CAyDd;AAED;;;;;;;;GAQG;AACH,wBAAsB,wBAAwB,CAAC,CAAC,SAAS,WAAW,EAClE,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,gBAAgB,EAAE,EAC3B,QAAQ,CAAC,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GACjC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CA0E3B;AAED;;;;;;;;GAQG;AACH,wBAAsB,wBAAwB,CAAC,CAAC,SAAS,WAAW,EAClE,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,gBAAgB,CAAA;CAAE,CAAC,EAC5D,QAAQ,CAAC,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GACjC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAyE3B;AAGD,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC"}