@iflow-mcp/attio-mcp 1.3.6

package/dist/objects/people/attributes.js

@@ -0,0 +1,169 @@
+import { createScopedLogger } from '../../utils/logger.js';
+import { getRecord } from '../../api/operations/crud.js';
+// Standard fields that are NOT custom (based on actual Attio API)
+const standardFields = new Set([
+    'name',
+    'description',
+    'email_addresses',
+    'job_title',
+    'company',
+    'linkedin',
+    'twitter',
+    'facebook',
+    'instagram',
+    'phone_numbers',
+    'primary_location',
+    'avatar_url',
+    'angellist',
+    'associated_deals',
+    'associated_users',
+]);
+/**
+ * Determines if a field is a standard Attio people field or a custom field
+ *
+ * @param fieldName - The field name to check
+ * @returns True if it's a standard field, false if custom
+ */
+export function isStandardPersonField(fieldName) {
+    return standardFields.has(fieldName);
+}
+/**
+ * Gets a list of all standard people field names
+ *
+ * @returns Array of standard field names
+ */
+export function getStandardPersonFields() {
+    return Array.from(standardFields).sort();
+}
+/**
+ * Checks if a field is custom (not in the standard Attio people schema)
+ *
+ * @param fieldName - The name of the field to check
+ * @returns True if the field is custom, false if it's a standard field
+ */
+export function isCustomPersonField(fieldName) {
+    return !standardFields.has(fieldName);
+}
+/**
+ * Gets person fields with error handling and validation
+ *
+ * @param personIdOrUri - The ID of the person or its URI
+ * @param fields - Array of field names to retrieve
+ * @returns Person data with specified fields
+ */
+export async function getPersonFields(personIdOrUri, fields) {
+    try {
+        const person = await getRecord('people', personIdOrUri, fields);
+        return person;
+    }
+    catch (error) {
+        createScopedLogger('people.attributes', 'getPersonFields').error('Error fetching person fields', error);
+        throw error;
+    }
+}
+/**
+ * Gets basic person information
+ *
+ * @param personIdOrUri - The ID of the person or its URI
+ * @returns Basic person information
+ */
+export async function getPersonBasicInfo(personIdOrUri) {
+    const basicFields = [
+        'name',
+        'email_addresses',
+        'job_title',
+        'company',
+        'phone_numbers',
+    ];
+    return getPersonFields(personIdOrUri, basicFields);
+}
+/**
+ * Gets person contact information
+ *
+ * @param personIdOrUri - The ID of the person or its URI
+ * @returns Person contact information
+ */
+export async function getPersonContactInfo(personIdOrUri) {
+    const contactFields = [
+        'name',
+        'email_addresses',
+        'phone_numbers',
+        'primary_location',
+        'linkedin',
+        'twitter',
+        'facebook',
+        'instagram',
+    ];
+    return getPersonFields(personIdOrUri, contactFields);
+}
+/**
+ * Gets person professional information
+ *
+ * @param personIdOrUri - The ID of the person or its URI
+ * @returns Person professional information
+ */
+export async function getPersonProfessionalInfo(personIdOrUri) {
+    const professionalFields = [
+        'name',
+        'job_title',
+        'company',
+        'linkedin',
+        'associated_deals',
+        'associated_users',
+    ];
+    return getPersonFields(personIdOrUri, professionalFields);
+}
+/**
+ * Gets person social media and online presence
+ *
+ * @param personIdOrUri - The ID of the person or its URI
+ * @returns Person social media information
+ */
+export async function getPersonSocialInfo(personIdOrUri) {
+    const socialFields = ['name', 'linkedin', 'twitter', 'facebook', 'instagram'];
+    return getPersonFields(personIdOrUri, socialFields);
+}
+/**
+ * Validate and categorize person fields
+ *
+ * @param fields - Array of field names to validate
+ * @returns Object with categorized fields
+ */
+export function validateAndCategorizePersonFields(fields) {
+    const result = {
+        standardFields: [],
+        customFields: [],
+        warnings: [],
+    };
+    for (const fieldName of fields) {
+        if (isStandardPersonField(fieldName)) {
+            result.standardFields.push(fieldName);
+        }
+        else {
+            result.customFields.push(fieldName);
+            // Generate warnings for fields that look like they might be standard but aren't
+            if (fieldName.includes('email') && fieldName !== 'email_addresses') {
+                result.warnings.push(`Field '${fieldName}' appears to be email-related. The standard field is 'email_addresses'.`);
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Get comprehensive person attribute information with custom field detection
+ *
+ * @param personIdOrUri - The ID of the person or its URI
+ * @param requestedFields - Optional array of specific fields to retrieve
+ * @returns Person with field categorization info
+ */
+export async function getPersonWithFieldAnalysis(personIdOrUri, requestedFields) {
+    // If no specific fields requested, get all basic fields
+    const fieldsToFetch = requestedFields || getStandardPersonFields();
+    const person = await getPersonFields(personIdOrUri, fieldsToFetch);
+    const fieldAnalysis = validateAndCategorizePersonFields(fieldsToFetch);
+    return {
+        person,
+        fieldAnalysis,
+    };
+}
+//# sourceMappingURL=attributes.js.map

package/dist/objects/people/attributes.js.map

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

package/dist/objects/people/basic.d.ts

@@ -0,0 +1,90 @@
+import { Person } from '../../types/attio.js';
+import { PersonAttributes } from './types.js';
+/**
+ * Creates a new person in Attio
+ *
+ * @param attributes - Person attributes as key-value pairs (must include at least email or name)
+ * @returns Created person record with ID and all attributes
+ * @throws {InvalidPersonDataError} When required fields are missing or validation fails
+ * @throws {PersonOperationError} When the API call fails or other errors occur
+ * @example
+ * const newPerson = await createPerson({
+ *   name: "John Doe",
+ *   email_addresses: ["john@example.com"]
+ * });
+ */
+export declare function createPerson(attributes: PersonAttributes): Promise<Person>;
+/**
+ * Updates an existing person's attributes
+ *
+ * @param personId - Unique ID of the person to update
+ * @param attributes - Key-value pairs of attributes to update (partial update supported)
+ * @returns Updated person record with all current attributes
+ * @throws {InvalidPersonDataError} When person ID is invalid or no attributes provided
+ * @throws {PersonOperationError} When the update operation fails
+ * @example
+ * const updatedPerson = await updatePerson("person_id", {
+ *   name: "Jane Doe",
+ *   phone_numbers: ["+1234567890"]
+ * });
+ */
+export declare function updatePerson(personId: string, attributes: PersonAttributes): Promise<Person>;
+/**
+ * Updates a specific attribute of a person
+ *
+ * @param personId - Unique ID of the person to update
+ * @param attributeName - Name of the attribute to update (e.g., 'email_addresses', 'name')
+ * @param attributeValue - New value for the attribute (type depends on attribute)
+ * @returns Updated person record with all current attributes
+ * @throws {InvalidPersonDataError} When validation fails (invalid email format, etc.)
+ * @throws {PersonOperationError} When the update operation fails
+ * @example
+ * // Update email addresses
+ * await updatePersonAttribute("person_id", "email_addresses", ["new@email.com"]);
+ *
+ * @example
+ * // Update name
+ * await updatePersonAttribute("person_id", "name", "New Name");
+ */
+export declare function updatePersonAttribute(personId: string, attributeName: string, attributeValue: unknown): Promise<Person>;
+/**
+ * Deletes a person from Attio
+ *
+ * @param personId - Unique ID of the person to delete
+ * @returns True if deletion was successful, false otherwise
+ * @throws {InvalidPersonDataError} When person ID is invalid or empty
+ * @throws {PersonOperationError} When the deletion operation fails
+ * @example
+ * const wasDeleted = await deletePerson("person_12345");
+ * if (wasDeleted) {
+ *   console.error("Person deleted successfully");
+ * }
+ */
+export declare function deletePerson(personId: string): Promise<boolean>;
+/**
+ * Gets detailed information about a specific person
+ *
+ * @param personId - Unique ID of the person to retrieve
+ * @returns Complete person record with all attributes and metadata
+ * @throws {Error} When person ID is invalid or person not found
+ * @example
+ * const person = await getPersonDetails("person_12345");
+ * console.error(person.values.name[0].value); // Person's name
+ */
+export declare function getPersonDetails(personId: string): Promise<Person>;
+/**
+ * Lists people from your Attio workspace
+ *
+ * @param limit - Maximum number of people to return (default: 20, max: 500)
+ * @returns Array of person records sorted by most recently interacted
+ * @throws {Error} When the API call fails
+ * @example
+ * // Get the first 20 people
+ * const people = await listPeople();
+ *
+ * @example
+ * // Get up to 100 people
+ * const morePeople = await listPeople(100);
+ */
+export declare function listPeople(limit?: number): Promise<Person[]>;
+//# sourceMappingURL=basic.d.ts.map

package/dist/objects/people/basic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"basic.d.ts","sourceRoot":"","sources":["../../../src/objects/people/basic.ts"],"names":[],"mappings":"AAIA,OAAO,EAAgB,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAQ5D,OAAO,EAIL,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,gBAAgB,GAC3B,OAAO,CAAC,MAAM,CAAC,CA4CjB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,gBAAgB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAsBjB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,OAAO,GACtB,OAAO,CAAC,MAAM,CAAC,CAgCjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAiBrE;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAcxE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,UAAU,CAAC,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAWtE"}

package/dist/objects/people/basic.js

@@ -0,0 +1,168 @@
+/**
+ * Basic CRUD operations for People
+ */
+import { listObjects, getObjectDetails } from '../../api/operations/index.js';
+import { ResourceType } from '../../types/attio.js';
+import { isValidId } from '../../utils/validation.js';
+import { createObjectWithDynamicFields, updateObjectWithDynamicFields, updateObjectAttributeWithDynamicFields, deleteObjectWithValidation, } from '../base-operations.js';
+import { PersonValidator, InvalidPersonDataError, PersonOperationError, } from './types.js';
+/**
+ * Creates a new person in Attio
+ *
+ * @param attributes - Person attributes as key-value pairs (must include at least email or name)
+ * @returns Created person record with ID and all attributes
+ * @throws {InvalidPersonDataError} When required fields are missing or validation fails
+ * @throws {PersonOperationError} When the API call fails or other errors occur
+ * @example
+ * const newPerson = await createPerson({
+ *   name: "John Doe",
+ *   email_addresses: ["john@example.com"]
+ * });
+ */
+export async function createPerson(attributes) {
+    try {
+        const result = await createObjectWithDynamicFields(ResourceType.PEOPLE, attributes, PersonValidator.validateCreate);
+        // Defensive validation: Ensure we have a valid person record
+        if (!result) {
+            throw new PersonOperationError('create', undefined, 'API returned null/undefined response for person creation');
+        }
+        if (!result.id || !result.id.record_id) {
+            throw new PersonOperationError('create', undefined, `API returned invalid person record without proper ID structure. Response: ${JSON.stringify(result)}`);
+        }
+        if (!result.values || typeof result.values !== 'object') {
+            throw new PersonOperationError('create', undefined, `API returned invalid person record without values object. Response: ${JSON.stringify(result)}`);
+        }
+        return result;
+    }
+    catch (error) {
+        if (error instanceof InvalidPersonDataError) {
+            throw error;
+        }
+        throw new PersonOperationError('create', undefined, error instanceof Error ? error.message : String(error));
+    }
+}
+/**
+ * Updates an existing person's attributes
+ *
+ * @param personId - Unique ID of the person to update
+ * @param attributes - Key-value pairs of attributes to update (partial update supported)
+ * @returns Updated person record with all current attributes
+ * @throws {InvalidPersonDataError} When person ID is invalid or no attributes provided
+ * @throws {PersonOperationError} When the update operation fails
+ * @example
+ * const updatedPerson = await updatePerson("person_id", {
+ *   name: "Jane Doe",
+ *   phone_numbers: ["+1234567890"]
+ * });
+ */
+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 - Unique ID of the person to update
+ * @param attributeName - Name of the attribute to update (e.g., 'email_addresses', 'name')
+ * @param attributeValue - New value for the attribute (type depends on attribute)
+ * @returns Updated person record with all current attributes
+ * @throws {InvalidPersonDataError} When validation fails (invalid email format, etc.)
+ * @throws {PersonOperationError} When the update operation fails
+ * @example
+ * // Update email addresses
+ * await updatePersonAttribute("person_id", "email_addresses", ["new@email.com"]);
+ *
+ * @example
+ * // Update name
+ * await updatePersonAttribute("person_id", "name", "New Name");
+ */
+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 from Attio
+ *
+ * @param personId - Unique ID of the person to delete
+ * @returns True if deletion was successful, false otherwise
+ * @throws {InvalidPersonDataError} When person ID is invalid or empty
+ * @throws {PersonOperationError} When the deletion operation fails
+ * @example
+ * const wasDeleted = await deletePerson("person_12345");
+ * if (wasDeleted) {
+ *   console.error("Person deleted successfully");
+ * }
+ */
+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));
+    }
+}
+/**
+ * Gets detailed information about a specific person
+ *
+ * @param personId - Unique ID of the person to retrieve
+ * @returns Complete person record with all attributes and metadata
+ * @throws {Error} When person ID is invalid or person not found
+ * @example
+ * const person = await getPersonDetails("person_12345");
+ * console.error(person.values.name[0].value); // Person's name
+ */
+export async function getPersonDetails(personId) {
+    try {
+        if (!isValidId(personId)) {
+            throw new Error(`Invalid person ID: ${personId}`);
+        }
+        return (await getObjectDetails(ResourceType.PEOPLE, personId));
+    }
+    catch (error) {
+        throw new Error(`Failed to get person details: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Lists people from your Attio workspace
+ *
+ * @param limit - Maximum number of people to return (default: 20, max: 500)
+ * @returns Array of person records sorted by most recently interacted
+ * @throws {Error} When the API call fails
+ * @example
+ * // Get the first 20 people
+ * const people = await listPeople();
+ *
+ * @example
+ * // Get up to 100 people
+ * const morePeople = await listPeople(100);
+ */
+export async function listPeople(limit = 20) {
+    try {
+        const response = await listObjects(ResourceType.PEOPLE, limit);
+        return response;
+    }
+    catch (error) {
+        throw new Error(`Failed to list people: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=basic.js.map

package/dist/objects/people/basic.js.map

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

package/dist/objects/people/batch.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Batch operations for People
+ */
+import { BatchConfig, BatchResponse } from '../../api/operations/index.js';
+import { Person } from '../../types/attio.js';
+/**
+ * Performs batch search operations on people
+ * Searches for multiple people using different queries
+ *
+ * @param queries - Array of search queries
+ * @param config - Optional batch configuration
+ * @returns BatchResponse with results and errors for each query
+ */
+export declare function batchSearchPeople(queries: string[], config?: BatchConfig): Promise<BatchResponse<Person[]>>;
+/**
+ * Performs batch detail retrieval for multiple people
+ * Gets detailed information for multiple people by their IDs
+ *
+ * @param personIds - Array of person IDs
+ * @param config - Optional batch configuration
+ * @returns BatchResponse with details and errors for each person
+ */
+export declare function batchGetPeopleDetails(personIds: string[], config?: BatchConfig): Promise<BatchResponse<Person>>;
+//# sourceMappingURL=batch.d.ts.map

package/dist/objects/people/batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../../../src/objects/people/batch.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAGL,WAAW,EACX,aAAa,EACd,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAgB,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAM5D;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,CAoElC;AAED;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,EAAE,EACnB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAiEhC"}

package/dist/objects/people/batch.js

@@ -0,0 +1,145 @@
+/**
+ * Batch operations for People
+ */
+import { batchSearchObjects, batchGetObjectDetails, } from '../../api/operations/index.js';
+import { ResourceType } from '../../types/attio.js';
+import { FilterValidationError } from '../../errors/api-errors.js';
+import { isValidId } from '../../utils/validation.js';
+import { searchPeople } from './search.js';
+import { getPersonDetails } from './basic.js';
+/**
+ * Performs batch search operations on people
+ * Searches for multiple people using different queries
+ *
+ * @param queries - Array of search queries
+ * @param config - Optional batch configuration
+ * @returns BatchResponse with results and errors for each query
+ */
+export async function batchSearchPeople(queries, config) {
+    try {
+        // Validate queries
+        if (!Array.isArray(queries) || queries.length === 0) {
+            throw new FilterValidationError('Must provide at least one search query');
+        }
+        for (const query of queries) {
+            if (!query || query.trim().length === 0) {
+                throw new FilterValidationError(`Invalid query: cannot be empty`);
+            }
+            if (query.length > 1000) {
+                throw new FilterValidationError(`Invalid query '${query}': too long`);
+            }
+        }
+        try {
+            return await batchSearchObjects(ResourceType.PEOPLE, queries, config);
+        }
+        catch {
+            // Fallback to individual searches
+            const results = [];
+            let succeeded = 0;
+            let failed = 0;
+            for (const query of queries) {
+                try {
+                    const searchResults = await searchPeople(query);
+                    results.push({
+                        query,
+                        data: searchResults,
+                        success: true,
+                    });
+                    succeeded++;
+                }
+                catch (searchError) {
+                    results.push({
+                        query,
+                        error: searchError instanceof Error
+                            ? searchError
+                            : new Error(String(searchError)),
+                        success: false,
+                    });
+                    failed++;
+                }
+            }
+            return {
+                results,
+                summary: {
+                    total: queries.length,
+                    succeeded,
+                    failed,
+                },
+            };
+        }
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        if (errorMessage.includes('validation')) {
+            throw new FilterValidationError(`Batch search validation failed: ${errorMessage}`);
+        }
+        throw new Error(`Failed to batch search people: ${errorMessage}`);
+    }
+}
+/**
+ * Performs batch detail retrieval for multiple people
+ * Gets detailed information for multiple people by their IDs
+ *
+ * @param personIds - Array of person IDs
+ * @param config - Optional batch configuration
+ * @returns BatchResponse with details and errors for each person
+ */
+export async function batchGetPeopleDetails(personIds, config) {
+    try {
+        // Validate person IDs
+        if (!Array.isArray(personIds) || personIds.length === 0) {
+            throw new FilterValidationError('Must provide at least one person ID');
+        }
+        for (const personId of personIds) {
+            if (!isValidId(personId)) {
+                throw new FilterValidationError(`Invalid person ID '${personId}'`);
+            }
+        }
+        try {
+            return await batchGetObjectDetails(ResourceType.PEOPLE, personIds, config);
+        }
+        catch {
+            // Fallback to individual detail retrieval
+            const results = [];
+            let succeeded = 0;
+            let failed = 0;
+            for (const personId of personIds) {
+                try {
+                    const personDetails = await getPersonDetails(personId);
+                    results.push({
+                        id: personId,
+                        data: personDetails,
+                        success: true,
+                    });
+                    succeeded++;
+                }
+                catch (detailError) {
+                    results.push({
+                        id: personId,
+                        error: detailError instanceof Error
+                            ? detailError
+                            : new Error(String(detailError)),
+                        success: false,
+                    });
+                    failed++;
+                }
+            }
+            return {
+                results,
+                summary: {
+                    total: personIds.length,
+                    succeeded,
+                    failed,
+                },
+            };
+        }
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        if (errorMessage.includes('validation')) {
+            throw new FilterValidationError(`Batch get details validation failed: ${errorMessage}`);
+        }
+        throw new Error(`Failed to batch get people details: ${errorMessage}`);
+    }
+}
+//# sourceMappingURL=batch.js.map

package/dist/objects/people/batch.js.map

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

package/dist/objects/people/email-validation.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Email validation service for People operations
+ * Handles batch email duplicate checking for performance optimization
+ */
+/**
+ * Batch email validation for performance optimization
+ * Instead of multiple individual API calls, use a single query to check multiple emails
+ */
+export declare function searchPeopleByEmails(emails: string[]): Promise<{
+    email: string;
+    exists: boolean;
+    personId?: string;
+}[]>;
+//# sourceMappingURL=email-validation.d.ts.map

package/dist/objects/people/email-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-validation.d.ts","sourceRoot":"","sources":["../../../src/objects/people/email-validation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EAAE,GACf,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CA0ElE"}