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

package/dist/matching/scoring.js

@@ -4,10 +4,17 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MatchScorer = void 0;
+const planning_center_base_ts_1 = require("@rachelallyson/planning-center-base-ts");
 const helpers_1 = require("../helpers");
 class MatchScorer {
-    constructor(peopleModule) {
+    constructor(peopleModule, getConfig) {
         this.peopleModule = peopleModule;
+        this.getConfig = getConfig;
+    }
+    debugLog(message, data) {
+        const logger = (0, planning_center_base_ts_1.createDebugLogger)(this.getConfig?.());
+        if (logger.enabled)
+            logger.log(message, data);
     }
     /**
      * Score a person match based on various criteria
@@ -74,7 +81,7 @@ class MatchScorer {
         // Add age-based match reasons
         const ageScore = this.scoreAgeMatch(person, options);
         if (ageScore > 0.8) {
-            const age = (0, helpers_1.calculateAgeSafe)(person.attributes?.birthdate);
+            const age = (0, helpers_1.calculateAgeSafe)(person.birthdate);
             if (age !== null) {
                 if (options.agePreference === 'adults') {
                     reasons.push('adult age match');
@@ -100,11 +107,11 @@ class MatchScorer {
             const personEmails = await this.peopleModule.getEmails(person.id);
             const normalizedSearchEmail = (0, helpers_1.normalizeEmail)(email);
             // Check if any of the person's emails match
-            const emails = personEmails.data?.map(e => (0, helpers_1.normalizeEmail)(e.attributes?.address || '')).filter(Boolean) || [];
+            const emails = personEmails.data?.map(e => (0, helpers_1.normalizeEmail)(e.address || '')).filter(Boolean) || [];
             return emails.includes(normalizedSearchEmail) ? 1.0 : 0.0;
         }
         catch (error) {
-            console.warn(`Failed to verify email match for person ${person.id}:`, error);
+            this.debugLog('scoring  failed to verify email match', { personId: person.id, error: String(error) });
             return 0.0;
         }
     }
@@ -115,11 +122,11 @@ class MatchScorer {
         try {
             const personPhones = await this.peopleModule.getPhoneNumbers(person.id);
             const normalizedSearchPhone = (0, helpers_1.normalizePhone)(phone);
-            const phones = personPhones.data?.map(p => (0, helpers_1.normalizePhone)(p.attributes?.number || '')).filter(Boolean) || [];
+            const phones = personPhones.data?.map(p => (0, helpers_1.normalizePhone)(p.number || '')).filter(Boolean) || [];
             return phones.includes(normalizedSearchPhone) ? 1.0 : 0.0;
         }
         catch (error) {
-            console.warn(`Failed to verify phone match for person ${person.id}:`, error);
+            this.debugLog('scoring  failed to verify phone match', { personId: person.id, error: String(error) });
             return 0.0;
         }
     }
@@ -127,18 +134,15 @@ class MatchScorer {
      * Score name matching - only exact matches
      */
     scoreNameMatch(person, options) {
-        const attrs = person.attributes;
-        if (!attrs)
-            return 0;
         let score = 0;
         // First name matching - exact match only
-        if (options.firstName && attrs.first_name) {
-            const firstNameMatch = options.firstName.toLowerCase() === attrs.first_name.toLowerCase();
+        if (options.firstName && person.first_name) {
+            const firstNameMatch = options.firstName.toLowerCase() === person.first_name.toLowerCase();
             score += firstNameMatch ? 0.5 : 0;
         }
         // Last name matching - exact match only
-        if (options.lastName && attrs.last_name) {
-            const lastNameMatch = options.lastName.toLowerCase() === attrs.last_name.toLowerCase();
+        if (options.lastName && person.last_name) {
+            const lastNameMatch = options.lastName.toLowerCase() === person.last_name.toLowerCase();
             score += lastNameMatch ? 0.5 : 0;
         }
         return score;
@@ -147,7 +151,7 @@ class MatchScorer {
      * Score age matching
      */
     scoreAgeMatch(person, options) {
-        const birthdate = person.attributes?.birthdate;
+        const birthdate = person.birthdate;
         // If no age criteria specified, return neutral score
         if (!options.agePreference &&
             options.minAge === undefined &&

package/dist/modules/campus.d.ts

@@ -1,35 +1,38 @@
 import { BaseModule } from '@rachelallyson/planning-center-base-ts';
-import type { PcoHttpClient } from '@rachelallyson/planning-center-base-ts';
-import type { PaginationHelper } from '@rachelallyson/planning-center-base-ts';
-import type { PcoEventEmitter } from '@rachelallyson/planning-center-base-ts';
-import type { PaginationOptions, PaginationResult } from '@rachelallyson/planning-center-base-ts';
-import type { CampusResource, CampusAttributes, CampusesList } from '../types';
+import type { CampusResource, CampusAttributes, Meta, TopLevelLinks } from '../types';
+import type { ListWhereClause } from '../types/api-options';
+import type { CampusListOptions, CampusPageOptions } from '../types/api-options';
 /**
  * Campus module for managing campus-related operations
  */
 export declare class CampusModule extends BaseModule {
-    constructor(httpClient: PcoHttpClient, paginationHelper: PaginationHelper, eventEmitter: PcoEventEmitter);
     /**
-     * Get all campuses
+     * Get all campuses across all pages
      */
-    getAll(params?: {
-        where?: Record<string, any>;
-        include?: string[];
-        per_page?: number;
-        page?: number;
-    }): Promise<CampusesList>;
+    getAll(params?: CampusListOptions): Promise<import("@rachelallyson/planning-center-base-ts").PaginationResult<CampusResource, import("@rachelallyson/planning-center-base-ts").ResourceObject<string, any, any>, Record<string, never>>>;
+    /**
+     * Get a single page of campuses with optional filtering and pagination control
+     * Use this when you need a specific page or want to limit the number of results
+     * @param params - List parameters including where, include, perPage, page, and order
+     * @returns A single page of results with meta and links for pagination
+     */
+    getPage(params?: CampusPageOptions): Promise<{
+        data: import("@rachelallyson/planning-center-base-ts").FlattenedResource<"Campus", CampusAttributes, import("../types").CampusRelationships, Record<string, never>>[];
+        meta?: Meta;
+        links?: TopLevelLinks;
+    }>;
     /**
      * Get a specific campus by ID
      */
-    getById(id: string, include?: string[]): Promise<CampusResource>;
+    getById(id: string, include?: string[]): Promise<import("@rachelallyson/planning-center-base-ts").FlattenedResource<"Campus", CampusAttributes, import("../types").CampusRelationships>>;
     /**
      * Create a new campus
      */
-    create(data: CampusAttributes): Promise<CampusResource>;
+    create(data: CampusAttributes): Promise<import("@rachelallyson/planning-center-base-ts").FlattenedResource<"Campus", CampusAttributes, import("../types").CampusRelationships>>;
     /**
      * Update an existing campus
      */
-    update(id: string, data: Partial<CampusAttributes>): Promise<CampusResource>;
+    update(id: string, data: Partial<CampusAttributes>): Promise<import("@rachelallyson/planning-center-base-ts").FlattenedResource<"Campus", CampusAttributes, import("../types").CampusRelationships>>;
     /**
      * Delete a campus
      */
@@ -38,34 +41,26 @@ export declare class CampusModule extends BaseModule {
      * Get lists for a specific campus
      */
     getLists(campusId: string, params?: {
-        where?: Record<string, any>;
+        where?: ListWhereClause;
         include?: string[];
         per_page?: number;
         page?: number;
-    }): Promise<any>;
+    }): Promise<{
+        data: import("@rachelallyson/planning-center-base-ts").FlattenedResource<"List", import("../types").ListAttributes, {}, Record<string, never>>[];
+        meta?: Meta;
+        links?: TopLevelLinks;
+    }>;
     /**
      * Get service times for a specific campus
      */
     getServiceTimes(campusId: string, params?: {
-        where?: Record<string, any>;
+        where?: never;
         include?: string[];
         per_page?: number;
         page?: number;
-    }): Promise<any>;
-    /**
-     * Get all campuses with pagination
-     */
-    getAllCampuses(params?: {
-        where?: Record<string, any>;
-        include?: string[];
-        per_page?: number;
-    }): Promise<CampusResource[]>;
-    /**
-     * Get all campuses with pagination support
-     */
-    getAllPagesPaginated(params?: {
-        where?: Record<string, any>;
-        include?: string[];
-        per_page?: number;
-    }, paginationOptions?: PaginationOptions): Promise<PaginationResult<CampusResource>>;
+    }): Promise<{
+        data: import("@rachelallyson/planning-center-base-ts").FlattenedResource<"ServiceTime", import("../types").ServiceTimeAttributes, import("../types").ServiceTimeRelationships, Record<string, never>>[];
+        meta?: Meta;
+        links?: TopLevelLinks;
+    }>;
 }

package/dist/modules/campus.js

@@ -6,24 +6,38 @@ const planning_center_base_ts_1 = require("@rachelallyson/planning-center-base-t
  * Campus module for managing campus-related operations
  */
 class CampusModule extends planning_center_base_ts_1.BaseModule {
-    constructor(httpClient, paginationHelper, eventEmitter) {
-        super(httpClient, paginationHelper, eventEmitter);
-    }
     /**
-     * Get all campuses
+     * Get all campuses across all pages
      */
     async getAll(params) {
-        return this.getList('/campuses', params);
+        this.debugLog('campus.getAll', { params });
+        return this.getAllPages('/campuses', {
+            where: params?.where,
+            include: params?.include,
+            order: params?.order
+        });
+    }
+    /**
+     * Get a single page of campuses with optional filtering and pagination control
+     * Use this when you need a specific page or want to limit the number of results
+     * @param params - List parameters including where, include, perPage, page, and order
+     * @returns A single page of results with meta and links for pagination
+     */
+    async getPage(params) {
+        this.debugLog('campus.getPage', { params });
+        return this.getList('/campuses', {
+            where: params?.where,
+            include: params?.include,
+            per_page: params?.perPage,
+            page: params?.page,
+            order: params?.order
+        });
     }
     /**
      * Get a specific campus by ID
      */
     async getById(id, include) {
-        const params = {};
-        if (include) {
-            params.include = include.join(',');
-        }
-        return this.getSingle(`/campuses/${id}`, params);
+        return this.getSingle(`/campuses/${id}`, include);
     }
     /**
      * Create a new campus
@@ -47,50 +61,23 @@ class CampusModule extends planning_center_base_ts_1.BaseModule {
      * Get lists for a specific campus
      */
     async getLists(campusId, params) {
-        return this.getList(`/campuses/${campusId}/lists`, params);
+        this.debugLog('campus.getLists', { campusId, params });
+        return this.getList(`/campuses/${campusId}/lists`, {
+            where: params?.where,
+            include: params?.include,
+            per_page: params?.per_page,
+            page: params?.page
+        });
     }
     /**
      * Get service times for a specific campus
      */
     async getServiceTimes(campusId, params) {
-        return this.getList(`/campuses/${campusId}/service_times`, params);
-    }
-    /**
-     * Get all campuses with pagination
-     */
-    async getAllCampuses(params) {
-        const queryParams = {};
-        if (params?.where) {
-            Object.entries(params.where).forEach(([key, value]) => {
-                queryParams[`where[${key}]`] = value;
-            });
-        }
-        if (params?.include) {
-            queryParams.include = params.include.join(',');
-        }
-        if (params?.per_page) {
-            queryParams.per_page = params.per_page;
-        }
-        const result = await super.getAllPages('/campuses', queryParams);
-        return result.data;
-    }
-    /**
-     * Get all campuses with pagination support
-     */
-    async getAllPagesPaginated(params, paginationOptions) {
-        const queryParams = {};
-        if (params?.where) {
-            Object.entries(params.where).forEach(([key, value]) => {
-                queryParams[`where[${key}]`] = value;
-            });
-        }
-        if (params?.include) {
-            queryParams.include = params.include.join(',');
-        }
-        if (params?.per_page) {
-            queryParams.per_page = params.per_page;
-        }
-        return super.getAllPages('/campuses', queryParams, paginationOptions);
+        return this.getList(`/campuses/${campusId}/service_times`, {
+            include: params?.include,
+            per_page: params?.per_page,
+            page: params?.page
+        });
     }
 }
 exports.CampusModule = CampusModule;

package/dist/modules/contacts.d.ts

@@ -2,28 +2,29 @@
  * v2.0.0 Contacts Module
  */
 import { BaseModule } from '@rachelallyson/planning-center-base-ts';
-import type { EmailResource, EmailAttributes, PhoneNumberResource, PhoneNumberAttributes, AddressResource, AddressAttributes, SocialProfileResource, SocialProfileAttributes } from '../types';
+import type { EmailAttributes, PhoneNumberAttributes, AddressAttributes, SocialProfileAttributes, Meta, TopLevelLinks } from '../types';
 export declare class ContactsModule extends BaseModule {
     /**
      * Get all emails
      */
     getAllEmails(): Promise<{
-        data: EmailResource[];
-        meta?: any;
-        links?: any;
+        data: import("@rachelallyson/planning-center-base-ts").FlattenedResource<"Email", EmailAttributes, import("../types").EmailRelationships, Record<string, never>>[];
+        meta?: Meta;
+        links?: TopLevelLinks;
     }>;
     /**
      * Get a single email by ID
      */
-    getEmailById(id: string): Promise<EmailResource>;
+    getEmailById(id: string): Promise<import("@rachelallyson/planning-center-base-ts").FlattenedResource<"Email", EmailAttributes, import("../types").EmailRelationships>>;
     /**
-     * Create an email
+     * Create an email for a person
+     * Note: Emails must be created via person-specific endpoint
      */
-    createEmail(data: EmailAttributes): Promise<EmailResource>;
+    createEmail(personId: string, data: EmailAttributes): Promise<import("@rachelallyson/planning-center-base-ts").FlattenedResource<"Email", EmailAttributes, import("../types").EmailRelationships>>;
     /**
      * Update an email
      */
-    updateEmail(id: string, data: Partial<EmailAttributes>): Promise<EmailResource>;
+    updateEmail(id: string, data: Partial<EmailAttributes>): Promise<import("@rachelallyson/planning-center-base-ts").FlattenedResource<"Email", EmailAttributes, import("../types").EmailRelationships>>;
     /**
      * Delete an email
      */
@@ -32,22 +33,23 @@ export declare class ContactsModule extends BaseModule {
      * Get all phone numbers
      */
     getAllPhoneNumbers(): Promise<{
-        data: PhoneNumberResource[];
-        meta?: any;
-        links?: any;
+        data: import("@rachelallyson/planning-center-base-ts").FlattenedResource<"PhoneNumber", PhoneNumberAttributes, import("../types").PhoneNumberRelationships, Record<string, never>>[];
+        meta?: Meta;
+        links?: TopLevelLinks;
     }>;
     /**
      * Get a single phone number by ID
      */
-    getPhoneNumberById(id: string): Promise<PhoneNumberResource>;
+    getPhoneNumberById(id: string): Promise<import("@rachelallyson/planning-center-base-ts").FlattenedResource<"PhoneNumber", PhoneNumberAttributes, import("../types").PhoneNumberRelationships>>;
     /**
-     * Create a phone number
+     * Create a phone number for a person
+     * Note: Phone numbers must be created via person-specific endpoint
      */
-    createPhoneNumber(data: PhoneNumberAttributes): Promise<PhoneNumberResource>;
+    createPhoneNumber(personId: string, data: PhoneNumberAttributes): Promise<import("@rachelallyson/planning-center-base-ts").FlattenedResource<"PhoneNumber", PhoneNumberAttributes, import("../types").PhoneNumberRelationships>>;
     /**
      * Update a phone number
      */
-    updatePhoneNumber(id: string, data: Partial<PhoneNumberAttributes>): Promise<PhoneNumberResource>;
+    updatePhoneNumber(id: string, data: Partial<PhoneNumberAttributes>): Promise<import("@rachelallyson/planning-center-base-ts").FlattenedResource<"PhoneNumber", PhoneNumberAttributes, import("../types").PhoneNumberRelationships>>;
     /**
      * Delete a phone number
      */
@@ -56,22 +58,23 @@ export declare class ContactsModule extends BaseModule {
      * Get all addresses
      */
     getAllAddresses(): Promise<{
-        data: AddressResource[];
-        meta?: any;
-        links?: any;
+        data: import("@rachelallyson/planning-center-base-ts").FlattenedResource<"Address", AddressAttributes, import("../types").AddressRelationships, Record<string, never>>[];
+        meta?: Meta;
+        links?: TopLevelLinks;
     }>;
     /**
      * Get a single address by ID
      */
-    getAddressById(id: string): Promise<AddressResource>;
+    getAddressById(id: string): Promise<import("@rachelallyson/planning-center-base-ts").FlattenedResource<"Address", AddressAttributes, import("../types").AddressRelationships>>;
     /**
-     * Create an address
+     * Create an address for a person
+     * Note: Addresses must be created via person-specific endpoint
      */
-    createAddress(data: AddressAttributes): Promise<AddressResource>;
+    createAddress(personId: string, data: AddressAttributes): Promise<import("@rachelallyson/planning-center-base-ts").FlattenedResource<"Address", AddressAttributes, import("../types").AddressRelationships>>;
     /**
      * Update an address
      */
-    updateAddress(id: string, data: Partial<AddressAttributes>): Promise<AddressResource>;
+    updateAddress(id: string, data: Partial<AddressAttributes>): Promise<import("@rachelallyson/planning-center-base-ts").FlattenedResource<"Address", AddressAttributes, import("../types").AddressRelationships>>;
     /**
      * Delete an address
      */
@@ -80,22 +83,23 @@ export declare class ContactsModule extends BaseModule {
      * Get all social profiles
      */
     getAllSocialProfiles(): Promise<{
-        data: SocialProfileResource[];
-        meta?: any;
-        links?: any;
+        data: import("@rachelallyson/planning-center-base-ts").FlattenedResource<"SocialProfile", SocialProfileAttributes, import("../types").SocialProfileRelationships, Record<string, never>>[];
+        meta?: Meta;
+        links?: TopLevelLinks;
     }>;
     /**
      * Get a single social profile by ID
      */
-    getSocialProfileById(id: string): Promise<SocialProfileResource>;
+    getSocialProfileById(id: string): Promise<import("@rachelallyson/planning-center-base-ts").FlattenedResource<"SocialProfile", SocialProfileAttributes, import("../types").SocialProfileRelationships>>;
     /**
-     * Create a social profile
+     * Create a social profile for a person
+     * Note: Social profiles must be created via person-specific endpoint
      */
-    createSocialProfile(data: SocialProfileAttributes): Promise<SocialProfileResource>;
+    createSocialProfile(personId: string, data: SocialProfileAttributes): Promise<import("@rachelallyson/planning-center-base-ts").FlattenedResource<"SocialProfile", SocialProfileAttributes, import("../types").SocialProfileRelationships>>;
     /**
      * Update a social profile
      */
-    updateSocialProfile(id: string, data: Partial<SocialProfileAttributes>): Promise<SocialProfileResource>;
+    updateSocialProfile(id: string, data: Partial<SocialProfileAttributes>): Promise<import("@rachelallyson/planning-center-base-ts").FlattenedResource<"SocialProfile", SocialProfileAttributes, import("../types").SocialProfileRelationships>>;
     /**
      * Delete a social profile
      */

package/dist/modules/contacts.js

@@ -10,120 +10,144 @@ class ContactsModule extends planning_center_base_ts_1.BaseModule {
      * Get all emails
      */
     async getAllEmails() {
+        this.debugLog('contacts.getAllEmails');
         return this.getList('/emails');
     }
     /**
      * Get a single email by ID
      */
     async getEmailById(id) {
+        this.debugLog('contacts.getEmailById', { id });
         return this.getSingle(`/emails/${id}`);
     }
     /**
-     * Create an email
+     * Create an email for a person
+     * Note: Emails must be created via person-specific endpoint
      */
-    async createEmail(data) {
-        return this.createResource('/emails', data);
+    async createEmail(personId, data) {
+        this.debugLog('contacts.createEmail', { personId, data });
+        return this.createResource(`/people/${personId}/emails`, data);
     }
     /**
      * Update an email
      */
     async updateEmail(id, data) {
+        this.debugLog('contacts.updateEmail', { id, data });
         return this.updateResource(`/emails/${id}`, data);
     }
     /**
      * Delete an email
      */
     async deleteEmail(id) {
+        this.debugLog('contacts.deleteEmail', { id });
         return this.deleteResource(`/emails/${id}`);
     }
     /**
      * Get all phone numbers
      */
     async getAllPhoneNumbers() {
+        this.debugLog('contacts.getAllPhoneNumbers');
         return this.getList('/phone_numbers');
     }
     /**
      * Get a single phone number by ID
      */
     async getPhoneNumberById(id) {
+        this.debugLog('contacts.getPhoneNumberById', { id });
         return this.getSingle(`/phone_numbers/${id}`);
     }
     /**
-     * Create a phone number
+     * Create a phone number for a person
+     * Note: Phone numbers must be created via person-specific endpoint
      */
-    async createPhoneNumber(data) {
-        return this.createResource('/phone_numbers', data);
+    async createPhoneNumber(personId, data) {
+        this.debugLog('contacts.createPhoneNumber', { personId, data });
+        return this.createResource(`/people/${personId}/phone_numbers`, data);
     }
     /**
      * Update a phone number
      */
     async updatePhoneNumber(id, data) {
+        this.debugLog('contacts.updatePhoneNumber', { id, data });
         return this.updateResource(`/phone_numbers/${id}`, data);
     }
     /**
      * Delete a phone number
      */
     async deletePhoneNumber(id) {
+        this.debugLog('contacts.deletePhoneNumber', { id });
         return this.deleteResource(`/phone_numbers/${id}`);
     }
     /**
      * Get all addresses
      */
     async getAllAddresses() {
+        this.debugLog('contacts.getAllAddresses');
         return this.getList('/addresses');
     }
     /**
      * Get a single address by ID
      */
     async getAddressById(id) {
+        this.debugLog('contacts.getAddressById', { id });
         return this.getSingle(`/addresses/${id}`);
     }
     /**
-     * Create an address
+     * Create an address for a person
+     * Note: Addresses must be created via person-specific endpoint
      */
-    async createAddress(data) {
-        return this.createResource('/addresses', data);
+    async createAddress(personId, data) {
+        this.debugLog('contacts.createAddress', { personId, data });
+        return this.createResource(`/people/${personId}/addresses`, data);
     }
     /**
      * Update an address
      */
     async updateAddress(id, data) {
+        this.debugLog('contacts.updateAddress', { id, data });
         return this.updateResource(`/addresses/${id}`, data);
     }
     /**
      * Delete an address
      */
     async deleteAddress(id) {
+        this.debugLog('contacts.deleteAddress', { id });
         return this.deleteResource(`/addresses/${id}`);
     }
     /**
      * Get all social profiles
      */
     async getAllSocialProfiles() {
+        this.debugLog('contacts.getAllSocialProfiles');
         return this.getList('/social_profiles');
     }
     /**
      * Get a single social profile by ID
      */
     async getSocialProfileById(id) {
+        this.debugLog('contacts.getSocialProfileById', { id });
         return this.getSingle(`/social_profiles/${id}`);
     }
     /**
-     * Create a social profile
+     * Create a social profile for a person
+     * Note: Social profiles must be created via person-specific endpoint
      */
-    async createSocialProfile(data) {
-        return this.createResource('/social_profiles', data);
+    async createSocialProfile(personId, data) {
+        this.debugLog('contacts.createSocialProfile', { personId, data });
+        return this.createResource(`/people/${personId}/social_profiles`, data);
     }
     /**
      * Update a social profile
      */
     async updateSocialProfile(id, data) {
+        this.debugLog('contacts.updateSocialProfile', { id, data });
         return this.updateResource(`/social_profiles/${id}`, data);
     }
     /**
      * Delete a social profile
      */
     async deleteSocialProfile(id) {
+        this.debugLog('contacts.deleteSocialProfile', { id });
         return this.deleteResource(`/social_profiles/${id}`);
     }
 }