@iflow-mcp/attio-mcp 1.3.6

package/dist/objects/notes.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Notes operations for Attio API
+ *
+ * Notes are first-class resources under /v2/notes (NOT /objects/notes/records)
+ * They link to records via parent_object + parent_record_id
+ */
+import type { AttioNote } from '../types/attio.js';
+/**
+ * Create note body for Attio API
+ */
+export interface CreateNoteBody {
+    parent_object: string;
+    parent_record_id: string;
+    title?: string;
+    content: string;
+    format?: 'markdown' | 'plaintext';
+    created_at?: string;
+    meeting_id?: string;
+}
+/**
+ * List notes query parameters
+ */
+export interface ListNotesQuery extends Record<string, unknown> {
+    parent_object?: string;
+    parent_record_id?: string;
+    limit?: number;
+    offset?: number;
+    cursor?: string;
+}
+/**
+ * Create a note linked to a record
+ */
+export declare function createNote(body: CreateNoteBody): Promise<{
+    data: AttioNote;
+}>;
+/**
+ * List notes with optional filtering
+ */
+export declare function listNotes(query?: ListNotesQuery): Promise<{
+    data: AttioNote[];
+    meta?: {
+        next_cursor?: string;
+    };
+}>;
+/**
+ * Get a specific note by ID
+ */
+export declare function getNote(noteId: string): Promise<{
+    data: AttioNote;
+}>;
+/**
+ * Delete a note by ID
+ */
+export declare function deleteNote(noteId: string): Promise<{
+    success: boolean;
+}>;
+/**
+ * Normalize note data to universal response format
+ */
+export declare function normalizeNoteResponse(note: AttioNote): {
+    id: {
+        record_id: string;
+    };
+    resource_type: 'notes';
+    values: {
+        title?: string;
+        content_markdown?: string;
+        content_plaintext?: string;
+        parent_object: string;
+        parent_record_id: string;
+        created_at: string;
+        meeting_id?: string | null;
+        tags: string[];
+    };
+    raw: AttioNote;
+};
+//# sourceMappingURL=notes.d.ts.map

package/dist/objects/notes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notes.d.ts","sourceRoot":"","sources":["../../src/objects/notes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AASnD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,UAAU,GAAG,WAAW,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,CA4E9B;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,KAAK,GAAE,cAAmB,GAAG,OAAO,CAAC;IACnE,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACjC,CAAC,CA6BD;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,CAkC1E;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CA2B/B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,GAAG;IACtD,EAAE,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1B,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE;QACN,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,aAAa,EAAE,MAAM,CAAC;QACtB,gBAAgB,EAAE,MAAM,CAAC;QACzB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,IAAI,EAAE,MAAM,EAAE,CAAC;KAChB,CAAC;IACF,GAAG,EAAE,SAAS,CAAC;CAChB,CA+CA"}

package/dist/objects/notes.js

@@ -0,0 +1,180 @@
+/**
+ * Notes operations for Attio API
+ *
+ * Notes are first-class resources under /v2/notes (NOT /objects/notes/records)
+ * They link to records via parent_object + parent_record_id
+ */
+import { getLazyAttioClient } from '../api/lazy-client.js';
+import { UniversalValidationError, ErrorType, } from '../handlers/tool-configs/universal/schemas.js';
+import { createRecordNotFoundError } from '../utils/validation/uuid-validation.js';
+import { debug } from '../utils/logger.js';
+import { getErrorStatus, getErrorMessage, } from '../types/error-interfaces.js';
+/**
+ * Create a note linked to a record
+ */
+export async function createNote(body) {
+    debug('notes', 'Creating note', {
+        parent_object: body.parent_object,
+        parent_record_id: body.parent_record_id,
+        hasContent: !!body.content,
+        format: body.format || 'plaintext',
+    });
+    // Validate required fields
+    if (!body.content || !body.content.trim()) {
+        throw new UniversalValidationError('Content is required and cannot be empty', ErrorType.USER_ERROR, { field: 'content' });
+    }
+    if (!body.parent_object ||
+        typeof body.parent_object !== 'string' ||
+        !body.parent_object.trim()) {
+        throw new UniversalValidationError('parent_object is required and must be a valid object slug', ErrorType.USER_ERROR, { field: 'parent_object' });
+    }
+    if (!body.parent_record_id) {
+        throw new UniversalValidationError('parent_record_id is required', ErrorType.USER_ERROR, { field: 'parent_record_id' });
+    }
+    const api = getLazyAttioClient();
+    try {
+        const response = await api.post('/notes', { data: body });
+        const data = response?.data;
+        if (!data) {
+            throw new UniversalValidationError('Note creation returned empty response', ErrorType.SYSTEM_ERROR);
+        }
+        return data;
+    }
+    catch (error) {
+        debug('notes', 'Create note failed', {
+            error: getErrorMessage(error) || 'Unknown error',
+        });
+        // Map HTTP errors to universal validation errors
+        if (getErrorStatus(error) === 422) {
+            throw new UniversalValidationError(`Validation failed: ${(typeof error === 'object' && error !== null
+                ? error.response?.data?.message
+                : undefined) || 'Invalid note data'}`, ErrorType.USER_ERROR, { field: 'content' });
+        }
+        if (getErrorStatus(error) === 404) {
+            throw createRecordNotFoundError(body.parent_record_id, body.parent_object);
+        }
+        throw error;
+    }
+}
+/**
+ * List notes with optional filtering
+ */
+export async function listNotes(query = {}) {
+    debug('notes', 'Listing notes', query);
+    const api = getLazyAttioClient();
+    try {
+        // Always use the official /notes endpoint with query params.
+        // Some environments may not support record-scoped endpoints like
+        // /objects/{object}/records/{record}/notes, which can 404.
+        // The /notes endpoint accepts filters (parent_object, parent_record_id)
+        // and returns an empty array when no notes exist.
+        const response = await api.get('/notes', { params: query });
+        const res = response?.data ?? { data: [] };
+        const items = Array.isArray(res.data) ? res.data : [];
+        return { data: items, meta: res.meta };
+    }
+    catch (error) {
+        debug('notes', 'List notes failed', {
+            error: getErrorMessage(error) || 'Unknown error',
+        });
+        // Prefer returning an empty list on benign 404s for list operations
+        const status = getErrorStatus(error);
+        if (status === 404) {
+            return { data: [], meta: undefined };
+        }
+        throw error;
+    }
+}
+/**
+ * Get a specific note by ID
+ */
+export async function getNote(noteId) {
+    debug('notes', 'Getting note', { noteId });
+    if (!noteId) {
+        throw new UniversalValidationError('Note ID is required', ErrorType.USER_ERROR, { field: 'note_id' });
+    }
+    const api = getLazyAttioClient();
+    try {
+        const response = await api.get(`/notes/${noteId}`);
+        const data = response?.data;
+        if (!data) {
+            throw new UniversalValidationError('Note lookup returned empty response', ErrorType.SYSTEM_ERROR);
+        }
+        return data;
+    }
+    catch (error) {
+        debug('notes', 'Get note failed', {
+            error: getErrorMessage(error) || 'Unknown error',
+        });
+        if (getErrorStatus(error) === 404) {
+            throw createRecordNotFoundError(noteId, 'note');
+        }
+        throw error;
+    }
+}
+/**
+ * Delete a note by ID
+ */
+export async function deleteNote(noteId) {
+    debug('notes', 'Deleting note', { noteId });
+    if (!noteId) {
+        throw new UniversalValidationError('Note ID is required', ErrorType.USER_ERROR, { field: 'note_id' });
+    }
+    const api = getLazyAttioClient();
+    try {
+        await api.delete(`/notes/${noteId}`);
+        return { success: true };
+    }
+    catch (error) {
+        debug('notes', 'Delete note failed', {
+            error: getErrorMessage(error) || 'Unknown error',
+        });
+        if (getErrorStatus(error) === 404) {
+            throw createRecordNotFoundError(noteId, 'note');
+        }
+        throw error;
+    }
+}
+/**
+ * Normalize note data to universal response format
+ */
+export function normalizeNoteResponse(note) {
+    const noteRecord = note;
+    const meetingIdField = 'meeting_id' in noteRecord ? noteRecord.meeting_id : undefined;
+    const tagsField = 'tags' in noteRecord ? noteRecord.tags : undefined;
+    const tags = Array.isArray(tagsField)
+        ? tagsField.filter((tag) => typeof tag === 'string')
+        : [];
+    const idObject = typeof note.id === 'object' && note.id !== null ? note.id : undefined;
+    const derivedRecordId = (typeof note.id === 'string' ? note.id : undefined) ??
+        note.record_id ??
+        note.note_id ??
+        idObject?.record_id ??
+        idObject?.note_id ??
+        idObject?.id ??
+        'unknown';
+    const title = note.title ?? null;
+    const contentMarkdown = note.content_markdown ?? note.content ?? null;
+    const contentPlaintext = note.content_plaintext ?? note.content ?? null;
+    const parentObject = note.parent_object ?? 'notes';
+    const parentRecordId = note.parent_record_id ?? derivedRecordId;
+    const createdAt = note.created_at ?? note.timestamp ?? '';
+    return {
+        id: { record_id: derivedRecordId },
+        resource_type: 'notes',
+        values: {
+            title: title ?? undefined,
+            content_markdown: contentMarkdown ?? undefined,
+            content_plaintext: contentPlaintext ?? undefined,
+            parent_object: parentObject,
+            parent_record_id: parentRecordId,
+            created_at: createdAt,
+            meeting_id: typeof meetingIdField === 'string' || meetingIdField === null
+                ? meetingIdField
+                : null,
+            tags,
+        },
+        raw: note,
+    };
+}
+//# sourceMappingURL=notes.js.map

package/dist/objects/notes.js.map

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

package/dist/objects/paginated-people.d.ts

@@ -0,0 +1,50 @@
+import { DateRange, InteractionType, ActivityFilter, Person } from '../types/attio.js';
+import { ListEntryFilters } from '../api/operations/index.js';
+import { PaginatedResponse } from '../utils/pagination.js';
+/**
+ * Advanced search for people with built-in pagination
+ *
+ * @param filters - Filter configuration
+ * @param page - Page number to return (default: 1)
+ * @param pageSize - Number of results per page (default: 20)
+ * @returns Paginated response with matching people
+ */
+export declare function paginatedSearchPeople(filters: ListEntryFilters, page?: number, pageSize?: number): Promise<PaginatedResponse<Person>>;
+/**
+ * Search for people by creation date with pagination
+ *
+ * @param dateRange - Date range to filter by (when people were created)
+ * @param page - Page number to return (default: 1)
+ * @param pageSize - Number of results per page (default: 20)
+ * @returns Paginated response with matching people
+ */
+export declare function paginatedSearchPeopleByCreationDate(dateRange: DateRange | string | Record<string, unknown> | undefined, page?: number | string, pageSize?: number | string): Promise<PaginatedResponse<Person>>;
+/**
+ * Search for people by modification date with pagination
+ *
+ * @param dateRange - Date range to filter by (when people were last modified)
+ * @param page - Page number to return (default: 1)
+ * @param pageSize - Number of results per page (default: 20)
+ * @returns Paginated response with matching people
+ */
+export declare function paginatedSearchPeopleByModificationDate(dateRange: DateRange | string | Record<string, unknown> | undefined, page?: number | string, pageSize?: number | string): Promise<PaginatedResponse<Person>>;
+/**
+ * Search for people by last interaction with pagination
+ *
+ * @param dateRange - Date range to filter by (when the last interaction occurred)
+ * @param interactionType - Optional type of interaction to filter by
+ * @param page - Page number to return (default: 1)
+ * @param pageSize - Number of results per page (default: 20)
+ * @returns Paginated response with matching people
+ */
+export declare function paginatedSearchPeopleByLastInteraction(dateRange: DateRange | string | Record<string, unknown> | undefined, interactionType?: InteractionType | string, page?: number | string, pageSize?: number | string): Promise<PaginatedResponse<Person>>;
+/**
+ * Search for people by activity with pagination
+ *
+ * @param activityFilter - Activity filter configuration
+ * @param page - Page number to return (default: 1)
+ * @param pageSize - Number of results per page (default: 20)
+ * @returns Paginated response with matching people
+ */
+export declare function paginatedSearchPeopleByActivity(activityFilter: ActivityFilter | string | Record<string, unknown> | undefined, page?: number | string, pageSize?: number | string): Promise<PaginatedResponse<Person>>;
+//# sourceMappingURL=paginated-people.d.ts.map

package/dist/objects/paginated-people.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paginated-people.d.ts","sourceRoot":"","sources":["../../src/objects/paginated-people.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,SAAS,EACT,eAAe,EACf,cAAc,EACd,MAAM,EACP,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EACL,iBAAiB,EAElB,MAAM,wBAAwB,CAAC;AAQhC;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,gBAAgB,EACzB,IAAI,GAAE,MAAU,EAChB,QAAQ,GAAE,MAAW,GACpB,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CA4BpC;AAED;;;;;;;GAOG;AACH,wBAAsB,mCAAmC,CACvD,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EACnE,IAAI,GAAE,MAAM,GAAG,MAAU,EACzB,QAAQ,GAAE,MAAM,GAAG,MAAW,GAC7B,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAgCpC;AAED;;;;;;;GAOG;AACH,wBAAsB,uCAAuC,CAC3D,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EACnE,IAAI,GAAE,MAAM,GAAG,MAAU,EACzB,QAAQ,GAAE,MAAM,GAAG,MAAW,GAC7B,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CA+BpC;AAED;;;;;;;;GAQG;AACH,wBAAsB,sCAAsC,CAC1D,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EACnE,eAAe,CAAC,EAAE,eAAe,GAAG,MAAM,EAC1C,IAAI,GAAE,MAAM,GAAG,MAAU,EACzB,QAAQ,GAAE,MAAM,GAAG,MAAW,GAC7B,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAoDpC;AAED;;;;;;;GAOG;AACH,wBAAsB,+BAA+B,CACnD,cAAc,EAAE,cAAc,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC7E,IAAI,GAAE,MAAM,GAAG,MAAU,EACzB,QAAQ,GAAE,MAAM,GAAG,MAAW,GAC7B,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CA+BpC"}

package/dist/objects/paginated-people.js

@@ -0,0 +1,171 @@
+/**
+ * Enhanced people search functions with pagination support
+ */
+import { searchPeopleByCreationDate, searchPeopleByModificationDate, searchPeopleByLastInteraction, searchPeopleByActivity, advancedSearchPeople, } from './people/index.js';
+import { InteractionType, } from '../types/attio.js';
+import { createPaginatedResponse, } from '../utils/pagination.js';
+import { validateDateRange, validateActivityFilter, validateNumericParam, } from '../utils/filters/index.js';
+import { FilterValidationError } from '../errors/api-errors.js';
+/**
+ * Advanced search for people with built-in pagination
+ *
+ * @param filters - Filter configuration
+ * @param page - Page number to return (default: 1)
+ * @param pageSize - Number of results per page (default: 20)
+ * @returns Paginated response with matching people
+ */
+export async function paginatedSearchPeople(filters, page = 1, pageSize = 20) {
+    try {
+        // Validate pagination parameters
+        const validPage = Math.max(1, page);
+        const validPageSize = Math.min(100, Math.max(1, pageSize));
+        // Calculate offset from page and page size
+        const offset = (validPage - 1) * validPageSize;
+        // Perform the search
+        const results = await advancedSearchPeople(filters, {
+            limit: validPageSize,
+            offset,
+        });
+        // advancedSearchPeople now returns a PaginatedResponse
+        // So we can use its data directly
+        return results;
+    }
+    catch (error) {
+        if (error instanceof FilterValidationError) {
+            throw error;
+        }
+        throw new Error(`Failed to search people with pagination: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Search for people by creation date with pagination
+ *
+ * @param dateRange - Date range to filter by (when people were created)
+ * @param page - Page number to return (default: 1)
+ * @param pageSize - Number of results per page (default: 20)
+ * @returns Paginated response with matching people
+ */
+export async function paginatedSearchPeopleByCreationDate(dateRange, page = 1, pageSize = 20) {
+    try {
+        // Validate and normalize inputs
+        const validatedDateRange = validateDateRange(dateRange);
+        const validPage = validateNumericParam(page, 'page', 1);
+        const validPageSize = validateNumericParam(pageSize, 'pageSize', 20);
+        // Perform the search
+        const results = await searchPeopleByCreationDate(validatedDateRange);
+        // Apply pagination to the results
+        const startIndex = (validPage - 1) * validPageSize;
+        const endIndex = startIndex + validPageSize;
+        const paginatedResults = results.slice(startIndex, endIndex);
+        // Return paginated response
+        return createPaginatedResponse(paginatedResults, results.length, validPage, validPageSize);
+    }
+    catch (error) {
+        if (error instanceof FilterValidationError) {
+            throw error;
+        }
+        throw new Error(`Failed to search people by creation date: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Search for people by modification date with pagination
+ *
+ * @param dateRange - Date range to filter by (when people were last modified)
+ * @param page - Page number to return (default: 1)
+ * @param pageSize - Number of results per page (default: 20)
+ * @returns Paginated response with matching people
+ */
+export async function paginatedSearchPeopleByModificationDate(dateRange, page = 1, pageSize = 20) {
+    try {
+        // Validate and normalize inputs
+        const validatedDateRange = validateDateRange(dateRange);
+        const validPage = validateNumericParam(page, 'page', 1);
+        const validPageSize = validateNumericParam(pageSize, 'pageSize', 20);
+        // Perform the search
+        const results = await searchPeopleByModificationDate(validatedDateRange);
+        // Apply pagination to the results
+        const startIndex = (validPage - 1) * validPageSize;
+        const endIndex = startIndex + validPageSize;
+        const paginatedResults = results.slice(startIndex, endIndex);
+        return createPaginatedResponse(paginatedResults, results.length, validPage, validPageSize);
+    }
+    catch (error) {
+        if (error instanceof FilterValidationError) {
+            throw error;
+        }
+        throw new Error(`Failed to search people by modification date: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Search for people by last interaction with pagination
+ *
+ * @param dateRange - Date range to filter by (when the last interaction occurred)
+ * @param interactionType - Optional type of interaction to filter by
+ * @param page - Page number to return (default: 1)
+ * @param pageSize - Number of results per page (default: 20)
+ * @returns Paginated response with matching people
+ */
+export async function paginatedSearchPeopleByLastInteraction(dateRange, interactionType, page = 1, pageSize = 20) {
+    try {
+        // Validate and normalize inputs
+        const validatedDateRange = validateDateRange(dateRange);
+        const validPage = validateNumericParam(page, 'page', 1);
+        const validPageSize = validateNumericParam(pageSize, 'pageSize', 20);
+        // Validate interactionType if provided
+        let validatedInteractionType = undefined;
+        if (interactionType !== undefined) {
+            // Convert to string if not already
+            const typeString = String(interactionType).toLowerCase();
+            // Validate against enum values
+            const validTypes = Object.values(InteractionType);
+            if (!validTypes.includes(typeString)) {
+                throw new FilterValidationError(`Invalid interaction type: "${interactionType}". ` +
+                    `Valid types are: ${validTypes.join(', ')}`);
+            }
+            validatedInteractionType = typeString;
+        }
+        // Perform the search
+        const results = await searchPeopleByLastInteraction(validatedDateRange, validatedInteractionType);
+        // Apply pagination to the results
+        const startIndex = (validPage - 1) * validPageSize;
+        const endIndex = startIndex + validPageSize;
+        const paginatedResults = results.slice(startIndex, endIndex);
+        return createPaginatedResponse(paginatedResults, results.length, validPage, validPageSize);
+    }
+    catch (error) {
+        if (error instanceof FilterValidationError) {
+            throw error;
+        }
+        throw new Error(`Failed to search people by last interaction: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Search for people by activity with pagination
+ *
+ * @param activityFilter - Activity filter configuration
+ * @param page - Page number to return (default: 1)
+ * @param pageSize - Number of results per page (default: 20)
+ * @returns Paginated response with matching people
+ */
+export async function paginatedSearchPeopleByActivity(activityFilter, page = 1, pageSize = 20) {
+    try {
+        // Validate and normalize inputs
+        const validatedActivityFilter = validateActivityFilter(activityFilter);
+        const validPage = validateNumericParam(page, 'page', 1);
+        const validPageSize = validateNumericParam(pageSize, 'pageSize', 20);
+        // Perform the search
+        const results = await searchPeopleByActivity(validatedActivityFilter);
+        // Apply pagination to the results
+        const startIndex = (validPage - 1) * validPageSize;
+        const endIndex = startIndex + validPageSize;
+        const paginatedResults = results.slice(startIndex, endIndex);
+        return createPaginatedResponse(paginatedResults, results.length, validPage, validPageSize);
+    }
+    catch (error) {
+        if (error instanceof FilterValidationError) {
+            throw error;
+        }
+        throw new Error(`Failed to search people by activity: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=paginated-people.js.map

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

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

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

@@ -0,0 +1,88 @@
+/**
+ * People attributes and related operations
+ * Contains functions for getting people information with different levels of detail
+ */
+import { AttioRecord } from '../../types/attio.js';
+/**
+ * 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 declare function isStandardPersonField(fieldName: string): boolean;
+/**
+ * Gets a list of all standard people field names
+ *
+ * @returns Array of standard field names
+ */
+export declare function getStandardPersonFields(): string[];
+/**
+ * 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 declare function isCustomPersonField(fieldName: string): boolean;
+/**
+ * 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 declare function getPersonFields(personIdOrUri: string, fields: string[]): Promise<Partial<AttioRecord>>;
+/**
+ * Gets basic person information
+ *
+ * @param personIdOrUri - The ID of the person or its URI
+ * @returns Basic person information
+ */
+export declare function getPersonBasicInfo(personIdOrUri: string): Promise<Partial<AttioRecord>>;
+/**
+ * Gets person contact information
+ *
+ * @param personIdOrUri - The ID of the person or its URI
+ * @returns Person contact information
+ */
+export declare function getPersonContactInfo(personIdOrUri: string): Promise<Partial<AttioRecord>>;
+/**
+ * Gets person professional information
+ *
+ * @param personIdOrUri - The ID of the person or its URI
+ * @returns Person professional information
+ */
+export declare function getPersonProfessionalInfo(personIdOrUri: string): Promise<Partial<AttioRecord>>;
+/**
+ * Gets person social media and online presence
+ *
+ * @param personIdOrUri - The ID of the person or its URI
+ * @returns Person social media information
+ */
+export declare function getPersonSocialInfo(personIdOrUri: string): Promise<Partial<AttioRecord>>;
+/**
+ * Validate and categorize person fields
+ *
+ * @param fields - Array of field names to validate
+ * @returns Object with categorized fields
+ */
+export declare function validateAndCategorizePersonFields(fields: string[]): {
+    standardFields: string[];
+    customFields: string[];
+    warnings: string[];
+};
+/**
+ * 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 declare function getPersonWithFieldAnalysis(personIdOrUri: string, requestedFields?: string[]): Promise<{
+    person: Partial<AttioRecord>;
+    fieldAnalysis: {
+        standardFields: string[];
+        customFields: string[];
+        warnings: string[];
+    };
+}>;
+//# sourceMappingURL=attributes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"attributes.d.ts","sourceRoot":"","sources":["../../../src/objects/people/attributes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAuBnD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,EAAE,CAElD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,EAAE,GACf,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAW/B;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAU/B;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAa/B;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC7C,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAW/B;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAI/B;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG;IACnE,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAuBA;AAED;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAC9C,aAAa,EAAE,MAAM,EACrB,eAAe,CAAC,EAAE,MAAM,EAAE,GACzB,OAAO,CAAC;IACT,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7B,aAAa,EAAE;QACb,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACH,CAAC,CAWD"}