@rachelallyson/planning-center-people-ts 2.14.1 → 3.0.0

package/dist/modules/people.js

@@ -25,55 +25,43 @@ exports.DEFAULT_AGGRESSIVE_RETRY_CONFIG = {
     backoffMultiplier: 2,
 };
 class PeopleModule extends planning_center_base_ts_1.BaseModule {
-    constructor(httpClient, paginationHelper, eventEmitter) {
-        super(httpClient, paginationHelper, eventEmitter);
-        this.personMatcher = new matcher_1.PersonMatcher(this);
+    constructor(httpClient, paginationHelper, eventEmitter, getConfig) {
+        super(httpClient, paginationHelper, eventEmitter, getConfig);
+        this.personMatcher = new matcher_1.PersonMatcher(this, getConfig);
     }
     /**
-     * Get all people with optional filtering
+     * Get all people across all pages with optional filtering
      */
     async getAll(options = {}) {
-        const params = {};
-        if (options.where) {
-            Object.entries(options.where).forEach(([key, value]) => {
-                params[`where[${key}]`] = value;
-            });
-        }
-        if (options.include) {
-            params.include = options.include.join(',');
-        }
-        if (options.perPage) {
-            params.per_page = options.perPage;
-        }
-        if (options.page) {
-            params.page = options.page;
-        }
-        return this.getList('/people', params);
+        this.debugLog('people.getAll', { options });
+        return await this.getAllPages('/people', {
+            where: options.where,
+            include: options.include,
+            order: options.order
+        });
     }
     /**
-     * Get all people across all pages
+     * Get a single page of people with optional filtering and pagination control
+     * Use this when you need a specific page or want to limit the number of results
+     * @param options - List options including where, include, perPage, page, and order
+     * @returns A single page of results with meta and links for pagination
      */
-    async getAllPagesPaginated(options = {}, paginationOptions) {
-        const params = {};
-        if (options.where) {
-            Object.entries(options.where).forEach(([key, value]) => {
-                params[`where[${key}]`] = value;
-            });
-        }
-        if (options.include) {
-            params.include = options.include.join(',');
-        }
-        return this.getAllPages('/people', params, paginationOptions);
+    async getPage(options = {}) {
+        this.debugLog('people.getPage', { options });
+        return this.getList('/people', {
+            where: options.where,
+            include: options.include,
+            per_page: options.perPage,
+            page: options.page,
+            order: options.order
+        });
     }
     /**
      * Get a single person by ID
      */
     async getById(id, include) {
-        const params = {};
-        if (include) {
-            params.include = include.join(',');
-        }
-        return this.getSingle(`/people/${id}`, params);
+        this.debugLog('people.getById', { id, include });
+        return this.getSingle(`/people/${id}`, include);
     }
     /**
      * Verify that a person exists in PCO
@@ -87,7 +75,7 @@ class PeopleModule extends planning_center_base_ts_1.BaseModule {
      * @returns True if person exists, false if not found
      * @throws Error if request times out or other error occurs (except 404)
      *
-     * @example
+     * @gmail.com
      * ```typescript
      * const exists = await client.people.verifyPersonExists(cachedPersonId);
      * if (!exists) {
@@ -97,12 +85,15 @@ class PeopleModule extends planning_center_base_ts_1.BaseModule {
      * ```
      */
     async verifyPersonExists(personId, options) {
+        this.debugLog('people.verifyPersonExists', { personId, options });
         const timeout = options?.timeout ?? 30000;
         const verificationPromise = this.getById(personId)
             .then(() => true)
             .catch((error) => {
             // 404 means person doesn't exist (merged or deleted)
-            if (error?.status === 404 || error?.response?.status === 404) {
+            const status = error?.status
+                ?? error?.response?.status;
+            if (status === 404) {
                 return false;
             }
             // Re-throw other errors
@@ -115,22 +106,167 @@ class PeopleModule extends planning_center_base_ts_1.BaseModule {
         });
         return Promise.race([verificationPromise, timeoutPromise]);
     }
+    /**
+     * Transform PersonCreateOptions (camelCase) to API format (snake_case)
+     * Also handles snake_case input directly (passes through)
+     */
+    transformPersonData(data) {
+        const transformed = {};
+        const dataObj = data;
+        // If data is already in snake_case format, copy those fields directly
+        if (dataObj.first_name !== undefined)
+            transformed.first_name = dataObj.first_name;
+        if (dataObj.last_name !== undefined)
+            transformed.last_name = dataObj.last_name;
+        if (dataObj.given_name !== undefined)
+            transformed.given_name = dataObj.given_name;
+        if (dataObj.middle_name !== undefined)
+            transformed.middle_name = dataObj.middle_name;
+        if (dataObj.nickname !== undefined)
+            transformed.nickname = dataObj.nickname;
+        if (dataObj.birthdate !== undefined)
+            transformed.birthdate = dataObj.birthdate;
+        if (dataObj.anniversary !== undefined)
+            transformed.anniversary = dataObj.anniversary;
+        if (dataObj.gender !== undefined)
+            transformed.gender = dataObj.gender;
+        if (dataObj.grade !== undefined)
+            transformed.grade = dataObj.grade;
+        if (dataObj.child !== undefined)
+            transformed.child = dataObj.child;
+        if (dataObj.status !== undefined)
+            transformed.status = dataObj.status;
+        if (dataObj.medical_notes !== undefined)
+            transformed.medical_notes = dataObj.medical_notes;
+        if (dataObj.job_title !== undefined)
+            transformed.job_title = dataObj.job_title;
+        if (dataObj.employer !== undefined)
+            transformed.employer = dataObj.employer;
+        if (dataObj.school !== undefined)
+            transformed.school = dataObj.school;
+        if (dataObj.graduation_year !== undefined)
+            transformed.graduation_year = dataObj.graduation_year;
+        if (dataObj.avatar !== undefined)
+            transformed.avatar = dataObj.avatar;
+        if (dataObj.site_administrator !== undefined)
+            transformed.site_administrator = dataObj.site_administrator;
+        if (dataObj.accounting_administrator !== undefined)
+            transformed.accounting_administrator = dataObj.accounting_administrator;
+        if (dataObj.people_permissions !== undefined)
+            transformed.people_permissions = dataObj.people_permissions;
+        if (dataObj.directory_status !== undefined)
+            transformed.directory_status = dataObj.directory_status;
+        if (dataObj.login_identifier !== undefined)
+            transformed.login_identifier = dataObj.login_identifier;
+        if (dataObj.membership !== undefined)
+            transformed.membership = dataObj.membership;
+        if (dataObj.remote_id !== undefined)
+            transformed.remote_id = dataObj.remote_id;
+        if (dataObj.demographic_avatar_url !== undefined)
+            transformed.demographic_avatar_url = dataObj.demographic_avatar_url;
+        if (dataObj.inactivated_at !== undefined)
+            transformed.inactivated_at = dataObj.inactivated_at;
+        if (dataObj.resource_permission_flags !== undefined)
+            transformed.resource_permission_flags = dataObj.resource_permission_flags;
+        if (dataObj.primary_campus_id !== undefined)
+            transformed.primary_campus_id = dataObj.primary_campus_id;
+        if (dataObj.household_id !== undefined)
+            transformed.household_id = dataObj.household_id;
+        // Handle PersonCreateOptions fields (camelCase)
+        if (dataObj.firstName !== undefined)
+            transformed.first_name = dataObj.firstName;
+        if (dataObj.lastName !== undefined)
+            transformed.last_name = dataObj.lastName;
+        if (dataObj.givenName !== undefined)
+            transformed.given_name = dataObj.givenName;
+        if (dataObj.middleName !== undefined)
+            transformed.middle_name = dataObj.middleName;
+        if (dataObj.nickname !== undefined)
+            transformed.nickname = dataObj.nickname;
+        if (dataObj.birthdate !== undefined)
+            transformed.birthdate = dataObj.birthdate;
+        if (dataObj.anniversary !== undefined)
+            transformed.anniversary = dataObj.anniversary;
+        if (dataObj.gender !== undefined)
+            transformed.gender = dataObj.gender;
+        if (dataObj.grade !== undefined)
+            transformed.grade = dataObj.grade;
+        if (dataObj.child !== undefined)
+            transformed.child = dataObj.child;
+        if (dataObj.status !== undefined)
+            transformed.status = dataObj.status;
+        if (dataObj.medicalNotes !== undefined)
+            transformed.medical_notes = dataObj.medicalNotes;
+        if (dataObj.jobTitle !== undefined)
+            transformed.job_title = dataObj.jobTitle;
+        if (dataObj.employer !== undefined)
+            transformed.employer = dataObj.employer;
+        if (dataObj.school !== undefined)
+            transformed.school = dataObj.school;
+        if (dataObj.graduationYear !== undefined)
+            transformed.graduation_year = dataObj.graduationYear;
+        if (dataObj.avatar !== undefined)
+            transformed.avatar = dataObj.avatar;
+        if (dataObj.siteAdministrator !== undefined)
+            transformed.site_administrator = dataObj.siteAdministrator;
+        if (dataObj.accountingAdministrator !== undefined)
+            transformed.accounting_administrator = dataObj.accountingAdministrator;
+        if (dataObj.peoplePermissions !== undefined)
+            transformed.people_permissions = dataObj.peoplePermissions;
+        if (dataObj.directoryStatus !== undefined)
+            transformed.directory_status = dataObj.directoryStatus;
+        if (dataObj.loginIdentifier !== undefined)
+            transformed.login_identifier = dataObj.loginIdentifier;
+        if (dataObj.membership !== undefined)
+            transformed.membership = dataObj.membership;
+        if (dataObj.remoteId !== undefined)
+            transformed.remote_id = dataObj.remoteId;
+        if (dataObj.demographicAvatarUrl !== undefined)
+            transformed.demographic_avatar_url = dataObj.demographicAvatarUrl;
+        if (dataObj.inactivatedAt !== undefined)
+            transformed.inactivated_at = dataObj.inactivatedAt;
+        if (dataObj.resourcePermissionFlags !== undefined)
+            transformed.resource_permission_flags = dataObj.resourcePermissionFlags;
+        // Handle relationship fields
+        if (dataObj.primaryCampusId !== undefined)
+            transformed.primary_campus_id = dataObj.primaryCampusId;
+        if (dataObj.householdId !== undefined)
+            transformed.household_id = dataObj.householdId;
+        return transformed;
+    }
     /**
      * Create a new person
+     * Accepts both camelCase (PersonCreateOptions) and snake_case (PersonAttributes) fields
      */
     async create(data) {
-        return this.createResource('/people', data);
+        this.debugLog('people.create', { data });
+        // Check if data is already in snake_case format (has first_name, last_name, etc.)
+        const hasSnakeCase = Object.keys(data).some(key => key.includes('_'));
+        // If it's already in snake_case, use it directly; otherwise transform
+        const transformedData = hasSnakeCase
+            ? data
+            : this.transformPersonData(data);
+        return this.createResource('/people', transformedData);
     }
     /**
      * Update a person
+     * Accepts both camelCase (PersonCreateOptions) and snake_case (PersonAttributes) fields
      */
     async update(id, data) {
-        return this.updateResource(`/people/${id}`, data);
+        this.debugLog('people.update', { id, data });
+        // Check if data is already in snake_case format (has first_name, last_name, etc.)
+        const hasSnakeCase = Object.keys(data).some(key => key.includes('_'));
+        // If it's already in snake_case, use it directly; otherwise transform
+        const transformedData = hasSnakeCase
+            ? data
+            : this.transformPersonData(data);
+        return this.updateResource(`/people/${id}`, transformedData);
     }
     /**
      * Delete a person
      */
     async delete(id) {
+        this.debugLog('people.delete', { id });
         return this.deleteResource(`/people/${id}`);
     }
     // ===== Relationship Management =====
@@ -138,203 +274,193 @@ class PeopleModule extends planning_center_base_ts_1.BaseModule {
      * Get a person's primary campus
      */
     async getPrimaryCampus(personId) {
+        this.debugLog('people.getPrimaryCampus', { personId });
         const person = await this.getById(personId, ['primary_campus']);
-        const campusData = person.relationships?.primary_campus?.data;
-        if (!campusData || Array.isArray(campusData) || !campusData.id) {
+        const campusData = person.primary_campus;
+        // campusData can be CampusResource, ResourceIdentifier, or null
+        if (!campusData || Array.isArray(campusData)) {
             return null;
         }
-        // Get the full campus resource
-        return this.httpClient.request({
-            method: 'GET',
-            endpoint: `/campuses/${campusData.id}`
-        }).then(response => response.data.data);
+        // Check if it's a ResourceIdentifier (has id but might not have full attributes)
+        if ('id' in campusData && 'type' in campusData) {
+            // Get the full campus resource
+            return this.getSingle(`/campuses/${campusData.id}`);
+        }
+        // If it's already a full resource, return it
+        return campusData;
     }
     /**
      * Set a person's primary campus
      */
     async setPrimaryCampus(personId, campusId) {
-        return this.httpClient.request({
-            method: 'PATCH',
-            endpoint: `/people/${personId}`,
-            data: {
-                data: {
-                    type: 'Person',
-                    id: personId,
-                    attributes: {
-                        primary_campus_id: campusId
-                    }
-                }
-            }
-        }).then(response => response.data.data);
+        this.debugLog('people.setPrimaryCampus', { personId, campusId });
+        const transformedData = this.transformPersonData({ primaryCampusId: campusId });
+        return this.updateResource(`/people/${personId}`, transformedData);
     }
     /**
      * Remove a person's primary campus
      */
     async removePrimaryCampus(personId) {
-        return this.httpClient.request({
-            method: 'PATCH',
-            endpoint: `/people/${personId}`,
-            data: {
-                data: {
-                    type: 'Person',
-                    id: personId,
-                    attributes: {
-                        primary_campus_id: null
-                    }
-                }
-            }
-        }).then(response => response.data.data);
+        this.debugLog('people.removePrimaryCampus', { personId });
+        const transformedData = this.transformPersonData({ primaryCampusId: null });
+        return this.updateResource(`/people/${personId}`, transformedData);
     }
     /**
      * Get a person's household
      */
     async getHousehold(personId) {
+        this.debugLog('people.getHousehold', { personId });
         const person = await this.getById(personId, ['household']);
-        const householdData = person.relationships?.household?.data;
-        if (!householdData || Array.isArray(householdData) || !householdData.id) {
+        const householdData = person.household;
+        // householdData can be HouseholdResource, ResourceIdentifier, or null
+        if (!householdData || Array.isArray(householdData)) {
             return null;
         }
-        // Get the full household resource
-        return this.httpClient.request({
-            method: 'GET',
-            endpoint: `/households/${householdData.id}`
-        }).then(response => response.data.data);
+        // Check if it's a ResourceIdentifier (has id but might not have full attributes)
+        if ('id' in householdData && 'type' in householdData) {
+            // Get the full household resource
+            return this.getSingle(`/households/${householdData.id}`);
+        }
+        // If it's already a full resource, return it
+        return householdData;
     }
     /**
      * Set a person's household
+     * Uses the household_memberships endpoint to create a membership record
      */
     async setHousehold(personId, householdId) {
-        return this.httpClient.request({
-            method: 'PATCH',
-            endpoint: `/people/${personId}`,
-            data: {
-                data: {
-                    type: 'Person',
-                    id: personId,
-                    attributes: {
-                        household_id: householdId
+        this.debugLog('people.setHousehold', { personId, householdId });
+        await this.createResource(`/households/${householdId}/household_memberships`, {
+            relationships: {
+                person: {
+                    data: {
+                        type: 'Person',
+                        id: personId
                     }
                 }
             }
-        }).then(response => response.data.data);
+        });
+        // Return the updated person
+        return this.getById(personId);
     }
     /**
      * Remove a person from their household
+     * Uses the household_memberships endpoint to delete the membership record
      */
     async removeFromHousehold(personId) {
-        return this.httpClient.request({
-            method: 'PATCH',
-            endpoint: `/people/${personId}`,
-            data: {
-                data: {
-                    type: 'Person',
-                    id: personId,
-                    attributes: {
-                        household_id: null
-                    }
+        this.debugLog('people.removeFromHousehold', { personId });
+        const membershipsResponse = await this.httpClient.request({
+            method: 'GET',
+            endpoint: `/people/${personId}/household_memberships`
+        });
+        if (!membershipsResponse.data.data || membershipsResponse.data.data.length === 0) {
+            throw new Error(`Person ${personId} is not in a household`);
+        }
+        // Get the first membership (a person can only be in one household)
+        const membership = membershipsResponse.data.data[0];
+        const membershipId = membership.id;
+        // Get the household ID from the membership relationship
+        const membershipHousehold = membership.relationships?.household?.data;
+        if (!membershipHousehold || Array.isArray(membershipHousehold) || !membershipHousehold.id) {
+            const membershipDetails = await this.httpClient.request({
+                method: 'GET',
+                endpoint: `/people/${personId}/household_memberships/${membershipId}`,
+                params: {
+                    include: 'household'
                 }
+            });
+            const householdData = membershipDetails.data.data.relationships?.household?.data;
+            if (!householdData || Array.isArray(householdData) || !householdData.id) {
+                throw new Error(`Could not determine household ID for membership ${membershipId}`);
             }
-        }).then(response => response.data.data);
+            const householdId = householdData.id;
+            await this.deleteResource(`/households/${householdId}/household_memberships/${membershipId}`);
+        }
+        else {
+            const householdId = membershipHousehold.id;
+            await this.deleteResource(`/households/${householdId}/household_memberships/${membershipId}`);
+        }
+        // Return the updated person
+        return this.getById(personId);
     }
     /**
      * Get all people in a specific household
+     * Note: This uses getList() internally, so it returns a single page. Use getAll() with where[household_id] for all pages.
      */
     async getHouseholdMembers(householdId, options = {}) {
-        const params = {
-            'where[household_id]': householdId
-        };
-        if (options.include) {
+        this.debugLog('people.getHouseholdMembers', { householdId, options });
+        // household_id is not in PersonWhereClause, so we need to use flat params
+        // Build the where clause manually and merge with other options
+        const params = {};
+        if (options.include)
             params.include = options.include.join(',');
-        }
-        if (options.perPage) {
+        if (options.perPage)
             params.per_page = options.perPage;
-        }
-        if (options.page) {
+        if (options.page)
             params.page = options.page;
-        }
+        params['where[household_id]'] = householdId;
         return this.getList('/people', params);
     }
     /**
      * Get people by campus
+     * Note: This uses getList() internally, so it returns a single page. Use getAll() with where[primary_campus_id] for all pages.
      */
     async getByCampus(campusId, options = {}) {
-        const params = {
-            'where[primary_campus_id]': campusId
-        };
-        if (options.include) {
-            params.include = options.include.join(',');
-        }
-        if (options.perPage) {
-            params.per_page = options.perPage;
-        }
-        if (options.page) {
-            params.page = options.page;
-        }
-        return this.getList('/people', params);
+        this.debugLog('people.getByCampus', { campusId, options });
+        const campusIdNum = Number(campusId);
+        if (isNaN(campusIdNum)) {
+            throw new Error(`Invalid campus ID: ${campusId}`);
+        }
+        return this.getList('/people', {
+            where: { primary_campus_id: campusIdNum },
+            include: options.include,
+            per_page: options.perPage,
+            page: options.page
+        });
     }
     /**
      * Get a person's workflow cards
      */
     async getWorkflowCards(personId, options = {}) {
-        const params = {};
-        if (options.include) {
-            params.include = options.include.join(',');
-        }
-        if (options.perPage) {
-            params.per_page = options.perPage;
-        }
-        if (options.page) {
-            params.page = options.page;
-        }
-        return this.getList(`/people/${personId}/workflow_cards`, params);
+        this.debugLog('people.getWorkflowCards', { personId, options });
+        return this.getList(`/people/${personId}/workflow_cards`, {
+            include: options.include,
+            per_page: options.perPage,
+            page: options.page
+        });
     }
     /**
      * Get a person's notes
      */
     async getNotes(personId, options = {}) {
-        const params = {};
-        if (options.include) {
-            params.include = options.include.join(',');
-        }
-        if (options.perPage) {
-            params.per_page = options.perPage;
-        }
-        if (options.page) {
-            params.page = options.page;
-        }
-        return this.getList(`/people/${personId}/notes`, params);
+        this.debugLog('people.getNotes', { personId, options });
+        return this.getList(`/people/${personId}/notes`, {
+            include: options.include,
+            per_page: options.perPage,
+            page: options.page
+        });
     }
     /**
      * Get a person's field data
      */
     async getFieldData(personId, options = {}) {
-        const params = {};
-        if (options.include) {
-            params.include = options.include.join(',');
-        }
-        if (options.perPage) {
-            params.per_page = options.perPage;
-        }
-        if (options.page) {
-            params.page = options.page;
-        }
-        return this.getList(`/people/${personId}/field_data`, params);
+        this.debugLog('people.getFieldData', { personId, options });
+        return this.getList(`/people/${personId}/field_data`, {
+            include: options.include,
+            per_page: options.perPage,
+            page: options.page
+        });
     }
     /**
      * Get a person's social profiles
      */
     async getSocialProfiles(personId, options = {}) {
-        const params = {};
-        if (options.include) {
-            params.include = options.include.join(',');
-        }
-        if (options.perPage) {
-            params.per_page = options.perPage;
-        }
-        if (options.page) {
-            params.page = options.page;
-        }
-        return this.getList(`/people/${personId}/social_profiles`, params);
+        this.debugLog('people.getSocialProfiles', { personId, options });
+        return this.getList(`/people/${personId}/social_profiles`, {
+            include: options.include,
+            per_page: options.perPage,
+            page: options.page
+        });
     }
     /**
      * Find or create a person with smart matching
@@ -347,13 +473,13 @@ class PeopleModule extends planning_center_base_ts_1.BaseModule {
      *   to a person's profile when a match is found. The contacts are added as non-primary
      *   to preserve existing primary contacts.
      *
-     * @example
+     * @gmail.com
      * ```typescript
      * // Basic find or create
      * const person = await client.people.findOrCreate({
      *   firstName: 'John',
      *   lastName: 'Doe',
-     *   email: 'john@example.com',
+     *   email: 'john@gmail.com',
      *   phone: '+1234567890'
      * });
      *
@@ -361,7 +487,7 @@ class PeopleModule extends planning_center_base_ts_1.BaseModule {
      * const person = await client.people.findOrCreate({
      *   firstName: 'Jane',
      *   lastName: 'Smith',
-     *   email: 'jane@example.com',
+     *   email: 'jane@gmail.com',
      *   phone: '+1987654321',
      *   addMissingContactInfo: true  // Will add phone if person only has email
      * });
@@ -370,12 +496,14 @@ class PeopleModule extends planning_center_base_ts_1.BaseModule {
      * @returns The found or newly created person
      */
     async findOrCreate(options) {
+        this.debugLog('people.findOrCreate', { options });
         return this.personMatcher.findOrCreate(options);
     }
     /**
      * Search people by multiple criteria
      */
     async search(criteria) {
+        this.debugLog('people.search', { criteria });
         const where = {};
         // Use flexible search when we have multiple criteria or want broader matching
         if (criteria.email || criteria.phone) {
@@ -394,9 +522,16 @@ class PeopleModule extends planning_center_base_ts_1.BaseModule {
         if (criteria.status) {
             where.status = criteria.status;
         }
+        // If pagination options are provided, use getPage instead of getAll
+        if (criteria.perPage !== undefined || criteria.page !== undefined) {
+            return this.getPage({
+                where,
+                perPage: criteria.perPage,
+                page: criteria.page,
+            });
+        }
         return this.getAll({
             where,
-            perPage: criteria.perPage || 25,
         });
     }
     // Contact methods
@@ -404,96 +539,112 @@ class PeopleModule extends planning_center_base_ts_1.BaseModule {
      * Get person's emails
      */
     async getEmails(personId) {
+        this.debugLog('people.getEmails', { personId });
         return this.getList(`/people/${personId}/emails`);
     }
     /**
      * Add an email to a person
      */
     async addEmail(personId, data) {
+        this.debugLog('people.addEmail', { personId, data });
         return this.createResource(`/people/${personId}/emails`, data);
     }
     /**
      * Update a person's email
      */
     async updateEmail(personId, emailId, data) {
+        this.debugLog('people.updateEmail', { personId, emailId, data });
         return this.updateResource(`/people/${personId}/emails/${emailId}`, data);
     }
     /**
      * Delete a person's email
      */
     async deleteEmail(personId, emailId) {
+        this.debugLog('people.deleteEmail', { personId, emailId });
         return this.deleteResource(`/people/${personId}/emails/${emailId}`);
     }
     /**
      * Get person's phone numbers
      */
     async getPhoneNumbers(personId) {
+        this.debugLog('people.getPhoneNumbers', { personId });
         return this.getList(`/people/${personId}/phone_numbers`);
     }
     /**
      * Add a phone number to a person
      */
     async addPhoneNumber(personId, data) {
+        this.debugLog('people.addPhoneNumber', { personId, data });
         return this.createResource(`/people/${personId}/phone_numbers`, data);
     }
     /**
      * Update a person's phone number
      */
     async updatePhoneNumber(personId, phoneId, data) {
+        this.debugLog('people.updatePhoneNumber', { personId, phoneId, data });
         return this.updateResource(`/people/${personId}/phone_numbers/${phoneId}`, data);
     }
     /**
      * Delete a person's phone number
      */
     async deletePhoneNumber(personId, phoneId) {
+        this.debugLog('people.deletePhoneNumber', { personId, phoneId });
         return this.deleteResource(`/people/${personId}/phone_numbers/${phoneId}`);
     }
     /**
      * Get person's addresses
      */
     async getAddresses(personId) {
+        this.debugLog('people.getAddresses', { personId });
         return this.getList(`/people/${personId}/addresses`);
     }
     /**
      * Add an address to a person
      */
     async addAddress(personId, data) {
+        this.debugLog('people.addAddress', { personId, data });
         return this.createResource(`/people/${personId}/addresses`, data);
     }
     /**
      * Update a person's address
      */
     async updateAddress(personId, addressId, data) {
+        this.debugLog('people.updateAddress', { personId, addressId, data });
         return this.updateResource(`/people/${personId}/addresses/${addressId}`, data);
     }
     /**
      * Delete a person's address
      */
     async deleteAddress(personId, addressId) {
+        this.debugLog('people.deleteAddress', { personId, addressId });
         return this.deleteResource(`/people/${personId}/addresses/${addressId}`);
     }
     /**
      * Add a social profile to a person
      */
     async addSocialProfile(personId, data) {
+        this.debugLog('people.addSocialProfile', { personId, data });
         return this.createResource(`/people/${personId}/social_profiles`, data);
     }
     /**
      * Update a person's social profile
      */
     async updateSocialProfile(personId, profileId, data) {
+        this.debugLog('people.updateSocialProfile', { personId, profileId, data });
         return this.updateResource(`/people/${personId}/social_profiles/${profileId}`, data);
     }
     /**
      * Delete a person's social profile
      */
     async deleteSocialProfile(personId, profileId) {
+        this.debugLog('people.deleteSocialProfile', { personId, profileId });
         return this.deleteResource(`/people/${personId}/social_profiles/${profileId}`);
     }
     /**
      * Create a person with contact information
      */
     async createWithContacts(personData, contacts) {
+        this.debugLog('people.createWithContacts', { personData, contacts });
         const person = await this.create(personData);
         const result = { person };
         if (contacts?.email) {