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

package/dist/index.js

@@ -15,90 +15,47 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getNote = exports.runList = exports.getLists = exports.getListCategories = exports.getListById = exports.getTab = exports.getTabs = exports.getHouseholds = exports.getHousehold = exports.getFieldOptions = exports.getFieldDefinitions = exports.deleteSocialProfile = exports.deletePersonFieldData = exports.deletePerson = exports.deleteFieldDefinition = exports.createWorkflowCardNote = exports.createWorkflowCard = exports.createPersonSocialProfile = exports.createPersonPhoneNumber = exports.createPersonFieldData = exports.createPersonEmail = exports.createPersonAddress = exports.createPerson = exports.createFieldOption = exports.createFieldDefinition = exports.withErrorBoundary = exports.shouldNotRetry = exports.retryWithBackoff = exports.PcoError = exports.handleValidationError = exports.handleTimeoutError = exports.handleNetworkError = exports.ErrorSeverity = exports.ErrorCategory = exports.PcoRateLimiter = exports.PcoApiError = exports.updateClientTokens = exports.refreshAccessToken = exports.hasRefreshTokenCapability = exports.attemptTokenRefresh = exports.post = exports.patch = exports.getSingle = exports.getRateLimitInfo = exports.getList = exports.getAllPages = exports.del = exports.createPcoClient = exports.PcoClientManager = exports.PcoClient = void 0;
-exports.normalizeEmail = exports.isValidPhone = exports.isValidEmail = exports.isFileUrl = exports.isFileUpload = exports.getPrimaryContact = exports.getPersonWorkflowCardsWithNotes = exports.getPeopleByHousehold = exports.getOrganizationInfo = exports.getListsWithCategories = exports.getFilename = exports.getFileExtension = exports.getCompletePersonProfile = exports.formatPersonName = exports.formatDate = exports.extractFileUrl = exports.extractEmailDomain = exports.exportAllPeopleData = exports.emailDomainsMatch = exports.DEFAULT_TRUST_WINDOW = exports.createWorkflowCardWithNote = exports.createPersonWithContact = exports.calculateTrust = exports.calculateAge = exports.buildQueryParams = exports.withTimeout = exports.TIMEOUT_CONFIG = exports.retryWithExponentialBackoff = exports.executeBulkOperation = exports.DEFAULT_RETRY_CONFIG = exports.createErrorReport = exports.classifyError = exports.CircuitBreaker = exports.attemptRecovery = exports.updatePersonAddress = exports.updatePerson = exports.getWorkflows = exports.getWorkflowCards = exports.getWorkflowCardNotes = exports.getWorkflow = exports.getPersonSocialProfiles = exports.getPersonPhoneNumbers = exports.getPersonFieldData = exports.getPersonEmails = exports.getPersonAddresses = exports.getPerson = exports.getPeople = exports.getOrganization = exports.getNotes = exports.getNoteCategories = void 0;
-exports.createSlowMockClient = exports.createErrorMockClient = exports.createTestClient = exports.createRecordingClient = exports.createMockClient = exports.RequestRecorder = exports.MockResponseBuilder = exports.MockPcoClient = exports.streamPeopleData = exports.processLargeDataset = exports.processInBatches = exports.PerformanceMonitor = exports.monitorPerformance = exports.getCachedPeople = exports.fetchAllPages = exports.batchFetchPersonDetails = exports.ApiCache = exports.AdaptiveRateLimiter = exports.DEFAULT_AGGRESSIVE_RETRY_CONFIG = exports.DEFAULT_INITIAL_RETRY_CONFIG = exports.validatePersonData = exports.validateContactSimilarity = exports.searchPeople = exports.processFileValue = exports.phoneNumbersSimilar = exports.normalizePhone = void 0;
+exports.getPrimaryContact = exports.getPersonWorkflowCardsWithNotes = exports.getPeopleByHousehold = exports.getOrganizationInfo = exports.getListsWithCategories = exports.getFilename = exports.getFileExtension = exports.getCompletePersonProfile = exports.formatPersonName = exports.formatDate = exports.extractFileUrl = exports.extractEmailDomain = exports.exportAllPeopleData = exports.emailDomainsMatch = exports.DEFAULT_TRUST_WINDOW = exports.createWorkflowCardWithNote = exports.createPersonWithContact = exports.calculateTrust = exports.calculateAge = exports.withTimeout = exports.TIMEOUT_CONFIG = exports.retryWithExponentialBackoff = exports.executeBulkOperation = exports.DEFAULT_RETRY_CONFIG = exports.createErrorReport = exports.classifyError = exports.CircuitBreaker = exports.attemptRecovery = exports.withErrorBoundary = exports.shouldNotRetry = exports.retryWithBackoff = exports.PcoError = exports.handleValidationError = exports.handleTimeoutError = exports.handleNetworkError = exports.ErrorSeverity = exports.ErrorCategory = exports.PcoRateLimiter = exports.PcoApiError = exports.hasRefreshTokenCapability = exports.updateClientTokens = exports.refreshAccessToken = exports.attemptTokenRefresh = exports.getRateLimitInfo = exports.createPcoClient = exports.formatDebugEvent = exports.createDebugLogger = exports.attachDebugListener = exports.PcoClientManager = exports.PcoClient = void 0;
+exports.createSlowMockClient = exports.createErrorMockClient = exports.createTestClient = exports.createRecordingClient = exports.createMockClient = exports.RequestRecorder = exports.MockResponseBuilder = exports.MockPcoClient = exports.streamPeopleData = exports.processLargeDataset = exports.processInBatches = exports.PerformanceMonitor = exports.monitorPerformance = exports.getCachedPeople = exports.fetchAllPages = exports.batchFetchPersonDetails = exports.ApiCache = exports.AdaptiveRateLimiter = exports.DEFAULT_AGGRESSIVE_RETRY_CONFIG = exports.DEFAULT_INITIAL_RETRY_CONFIG = exports.createIncludedLookup = exports.resolveIncluded = exports.findIncluded = exports.validatePersonData = exports.validateContactSimilarity = exports.searchPeople = exports.processFileValue = exports.phoneNumbersSimilar = exports.normalizePhone = exports.normalizeEmail = exports.isValidPhone = exports.isValidEmail = exports.isFileUrl = exports.isFileUpload = void 0;
 // Main client class
 var client_1 = require("./client");
 Object.defineProperty(exports, "PcoClient", { enumerable: true, get: function () { return client_1.PcoClient; } });
 // Client manager for caching and lifecycle management
 var client_manager_1 = require("./client-manager");
 Object.defineProperty(exports, "PcoClientManager", { enumerable: true, get: function () { return client_manager_1.PcoClientManager; } });
-// ===== v1.x Compatibility Exports (Deprecated) =====
-// Export all types for backward compatibility
-__exportStar(require("./types"), exports);
+// Debug (turn logs on/off, see everything that happens — from base, shared across PCO packages)
+var planning_center_base_ts_1 = require("@rachelallyson/planning-center-base-ts");
+Object.defineProperty(exports, "attachDebugListener", { enumerable: true, get: function () { return planning_center_base_ts_1.attachDebugListener; } });
+Object.defineProperty(exports, "createDebugLogger", { enumerable: true, get: function () { return planning_center_base_ts_1.createDebugLogger; } });
+Object.defineProperty(exports, "formatDebugEvent", { enumerable: true, get: function () { return planning_center_base_ts_1.formatDebugEvent; } });
+// ===== Core Functions (for testing and advanced usage) =====
 var core_1 = require("./core");
 Object.defineProperty(exports, "createPcoClient", { enumerable: true, get: function () { return core_1.createPcoClient; } });
-Object.defineProperty(exports, "del", { enumerable: true, get: function () { return core_1.del; } });
-Object.defineProperty(exports, "getAllPages", { enumerable: true, get: function () { return core_1.getAllPages; } });
-Object.defineProperty(exports, "getList", { enumerable: true, get: function () { return core_1.getList; } });
 Object.defineProperty(exports, "getRateLimitInfo", { enumerable: true, get: function () { return core_1.getRateLimitInfo; } });
-Object.defineProperty(exports, "getSingle", { enumerable: true, get: function () { return core_1.getSingle; } });
-Object.defineProperty(exports, "patch", { enumerable: true, get: function () { return core_1.patch; } });
-Object.defineProperty(exports, "post", { enumerable: true, get: function () { return core_1.post; } });
+// ===== Auth Functions =====
 var auth_1 = require("./auth");
 Object.defineProperty(exports, "attemptTokenRefresh", { enumerable: true, get: function () { return auth_1.attemptTokenRefresh; } });
-Object.defineProperty(exports, "hasRefreshTokenCapability", { enumerable: true, get: function () { return auth_1.hasRefreshTokenCapability; } });
 Object.defineProperty(exports, "refreshAccessToken", { enumerable: true, get: function () { return auth_1.refreshAccessToken; } });
 Object.defineProperty(exports, "updateClientTokens", { enumerable: true, get: function () { return auth_1.updateClientTokens; } });
+Object.defineProperty(exports, "hasRefreshTokenCapability", { enumerable: true, get: function () { return auth_1.hasRefreshTokenCapability; } });
+// ===== v1.x Compatibility Exports (Deprecated) =====
+// Export all types for backward compatibility
+__exportStar(require("./types"), exports);
 // Export API error (re-exported from base)
-var planning_center_base_ts_1 = require("@rachelallyson/planning-center-base-ts");
-Object.defineProperty(exports, "PcoApiError", { enumerable: true, get: function () { return planning_center_base_ts_1.PcoApiError; } });
 var planning_center_base_ts_2 = require("@rachelallyson/planning-center-base-ts");
-Object.defineProperty(exports, "PcoRateLimiter", { enumerable: true, get: function () { return planning_center_base_ts_2.PcoRateLimiter; } });
+Object.defineProperty(exports, "PcoApiError", { enumerable: true, get: function () { return planning_center_base_ts_2.PcoApiError; } });
 var planning_center_base_ts_3 = require("@rachelallyson/planning-center-base-ts");
-Object.defineProperty(exports, "ErrorCategory", { enumerable: true, get: function () { return planning_center_base_ts_3.ErrorCategory; } });
-Object.defineProperty(exports, "ErrorSeverity", { enumerable: true, get: function () { return planning_center_base_ts_3.ErrorSeverity; } });
-Object.defineProperty(exports, "handleNetworkError", { enumerable: true, get: function () { return planning_center_base_ts_3.handleNetworkError; } });
-Object.defineProperty(exports, "handleTimeoutError", { enumerable: true, get: function () { return planning_center_base_ts_3.handleTimeoutError; } });
-Object.defineProperty(exports, "handleValidationError", { enumerable: true, get: function () { return planning_center_base_ts_3.handleValidationError; } });
-Object.defineProperty(exports, "PcoError", { enumerable: true, get: function () { return planning_center_base_ts_3.PcoError; } });
-Object.defineProperty(exports, "retryWithBackoff", { enumerable: true, get: function () { return planning_center_base_ts_3.retryWithBackoff; } });
-Object.defineProperty(exports, "shouldNotRetry", { enumerable: true, get: function () { return planning_center_base_ts_3.shouldNotRetry; } });
-Object.defineProperty(exports, "withErrorBoundary", { enumerable: true, get: function () { return planning_center_base_ts_3.withErrorBoundary; } });
-// Export People-specific functions (deprecated)
-var people_1 = require("./people");
-Object.defineProperty(exports, "createFieldDefinition", { enumerable: true, get: function () { return people_1.createFieldDefinition; } });
-Object.defineProperty(exports, "createFieldOption", { enumerable: true, get: function () { return people_1.createFieldOption; } });
-Object.defineProperty(exports, "createPerson", { enumerable: true, get: function () { return people_1.createPerson; } });
-Object.defineProperty(exports, "createPersonAddress", { enumerable: true, get: function () { return people_1.createPersonAddress; } });
-Object.defineProperty(exports, "createPersonEmail", { enumerable: true, get: function () { return people_1.createPersonEmail; } });
-Object.defineProperty(exports, "createPersonFieldData", { enumerable: true, get: function () { return people_1.createPersonFieldData; } });
-Object.defineProperty(exports, "createPersonPhoneNumber", { enumerable: true, get: function () { return people_1.createPersonPhoneNumber; } });
-Object.defineProperty(exports, "createPersonSocialProfile", { enumerable: true, get: function () { return people_1.createPersonSocialProfile; } });
-Object.defineProperty(exports, "createWorkflowCard", { enumerable: true, get: function () { return people_1.createWorkflowCard; } });
-Object.defineProperty(exports, "createWorkflowCardNote", { enumerable: true, get: function () { return people_1.createWorkflowCardNote; } });
-Object.defineProperty(exports, "deleteFieldDefinition", { enumerable: true, get: function () { return people_1.deleteFieldDefinition; } });
-Object.defineProperty(exports, "deletePerson", { enumerable: true, get: function () { return people_1.deletePerson; } });
-Object.defineProperty(exports, "deletePersonFieldData", { enumerable: true, get: function () { return people_1.deletePersonFieldData; } });
-Object.defineProperty(exports, "deleteSocialProfile", { enumerable: true, get: function () { return people_1.deleteSocialProfile; } });
-Object.defineProperty(exports, "getFieldDefinitions", { enumerable: true, get: function () { return people_1.getFieldDefinitions; } });
-Object.defineProperty(exports, "getFieldOptions", { enumerable: true, get: function () { return people_1.getFieldOptions; } });
-Object.defineProperty(exports, "getHousehold", { enumerable: true, get: function () { return people_1.getHousehold; } });
-Object.defineProperty(exports, "getHouseholds", { enumerable: true, get: function () { return people_1.getHouseholds; } });
-Object.defineProperty(exports, "getTabs", { enumerable: true, get: function () { return people_1.getTabs; } });
-Object.defineProperty(exports, "getTab", { enumerable: true, get: function () { return people_1.getTab; } });
-Object.defineProperty(exports, "getListById", { enumerable: true, get: function () { return people_1.getListById; } });
-Object.defineProperty(exports, "getListCategories", { enumerable: true, get: function () { return people_1.getListCategories; } });
-Object.defineProperty(exports, "getLists", { enumerable: true, get: function () { return people_1.getLists; } });
-Object.defineProperty(exports, "runList", { enumerable: true, get: function () { return people_1.runList; } });
-Object.defineProperty(exports, "getNote", { enumerable: true, get: function () { return people_1.getNote; } });
-Object.defineProperty(exports, "getNoteCategories", { enumerable: true, get: function () { return people_1.getNoteCategories; } });
-Object.defineProperty(exports, "getNotes", { enumerable: true, get: function () { return people_1.getNotes; } });
-Object.defineProperty(exports, "getOrganization", { enumerable: true, get: function () { return people_1.getOrganization; } });
-Object.defineProperty(exports, "getPeople", { enumerable: true, get: function () { return people_1.getPeople; } });
-Object.defineProperty(exports, "getPerson", { enumerable: true, get: function () { return people_1.getPerson; } });
-Object.defineProperty(exports, "getPersonAddresses", { enumerable: true, get: function () { return people_1.getPersonAddresses; } });
-Object.defineProperty(exports, "getPersonEmails", { enumerable: true, get: function () { return people_1.getPersonEmails; } });
-Object.defineProperty(exports, "getPersonFieldData", { enumerable: true, get: function () { return people_1.getPersonFieldData; } });
-Object.defineProperty(exports, "getPersonPhoneNumbers", { enumerable: true, get: function () { return people_1.getPersonPhoneNumbers; } });
-Object.defineProperty(exports, "getPersonSocialProfiles", { enumerable: true, get: function () { return people_1.getPersonSocialProfiles; } });
-Object.defineProperty(exports, "getWorkflow", { enumerable: true, get: function () { return people_1.getWorkflow; } });
-Object.defineProperty(exports, "getWorkflowCardNotes", { enumerable: true, get: function () { return people_1.getWorkflowCardNotes; } });
-Object.defineProperty(exports, "getWorkflowCards", { enumerable: true, get: function () { return people_1.getWorkflowCards; } });
-Object.defineProperty(exports, "getWorkflows", { enumerable: true, get: function () { return people_1.getWorkflows; } });
-Object.defineProperty(exports, "updatePerson", { enumerable: true, get: function () { return people_1.updatePerson; } });
-Object.defineProperty(exports, "updatePersonAddress", { enumerable: true, get: function () { return people_1.updatePersonAddress; } });
+Object.defineProperty(exports, "PcoRateLimiter", { enumerable: true, get: function () { return planning_center_base_ts_3.PcoRateLimiter; } });
+var planning_center_base_ts_4 = require("@rachelallyson/planning-center-base-ts");
+Object.defineProperty(exports, "ErrorCategory", { enumerable: true, get: function () { return planning_center_base_ts_4.ErrorCategory; } });
+Object.defineProperty(exports, "ErrorSeverity", { enumerable: true, get: function () { return planning_center_base_ts_4.ErrorSeverity; } });
+Object.defineProperty(exports, "handleNetworkError", { enumerable: true, get: function () { return planning_center_base_ts_4.handleNetworkError; } });
+Object.defineProperty(exports, "handleTimeoutError", { enumerable: true, get: function () { return planning_center_base_ts_4.handleTimeoutError; } });
+Object.defineProperty(exports, "handleValidationError", { enumerable: true, get: function () { return planning_center_base_ts_4.handleValidationError; } });
+Object.defineProperty(exports, "PcoError", { enumerable: true, get: function () { return planning_center_base_ts_4.PcoError; } });
+Object.defineProperty(exports, "retryWithBackoff", { enumerable: true, get: function () { return planning_center_base_ts_4.retryWithBackoff; } });
+Object.defineProperty(exports, "shouldNotRetry", { enumerable: true, get: function () { return planning_center_base_ts_4.shouldNotRetry; } });
+Object.defineProperty(exports, "withErrorBoundary", { enumerable: true, get: function () { return planning_center_base_ts_4.withErrorBoundary; } });
 // ===== Enhanced Error Handling =====
 var error_scenarios_1 = require("./error-scenarios");
 Object.defineProperty(exports, "attemptRecovery", { enumerable: true, get: function () { return error_scenarios_1.attemptRecovery; } });
@@ -112,7 +69,6 @@ Object.defineProperty(exports, "TIMEOUT_CONFIG", { enumerable: true, get: functi
 Object.defineProperty(exports, "withTimeout", { enumerable: true, get: function () { return error_scenarios_1.withTimeout; } });
 // ===== Helper Functions =====
 var helpers_1 = require("./helpers");
-Object.defineProperty(exports, "buildQueryParams", { enumerable: true, get: function () { return helpers_1.buildQueryParams; } });
 Object.defineProperty(exports, "calculateAge", { enumerable: true, get: function () { return helpers_1.calculateAge; } });
 Object.defineProperty(exports, "calculateTrust", { enumerable: true, get: function () { return helpers_1.calculateTrust; } });
 Object.defineProperty(exports, "createPersonWithContact", { enumerable: true, get: function () { return helpers_1.createPersonWithContact; } });
@@ -143,10 +99,13 @@ Object.defineProperty(exports, "processFileValue", { enumerable: true, get: func
 Object.defineProperty(exports, "searchPeople", { enumerable: true, get: function () { return helpers_1.searchPeople; } });
 Object.defineProperty(exports, "validateContactSimilarity", { enumerable: true, get: function () { return helpers_1.validateContactSimilarity; } });
 Object.defineProperty(exports, "validatePersonData", { enumerable: true, get: function () { return helpers_1.validatePersonData; } });
+Object.defineProperty(exports, "findIncluded", { enumerable: true, get: function () { return helpers_1.findIncluded; } });
+Object.defineProperty(exports, "resolveIncluded", { enumerable: true, get: function () { return helpers_1.resolveIncluded; } });
+Object.defineProperty(exports, "createIncludedLookup", { enumerable: true, get: function () { return helpers_1.createIncludedLookup; } });
 // ===== Matching Configuration =====
-var people_2 = require("./modules/people");
-Object.defineProperty(exports, "DEFAULT_INITIAL_RETRY_CONFIG", { enumerable: true, get: function () { return people_2.DEFAULT_INITIAL_RETRY_CONFIG; } });
-Object.defineProperty(exports, "DEFAULT_AGGRESSIVE_RETRY_CONFIG", { enumerable: true, get: function () { return people_2.DEFAULT_AGGRESSIVE_RETRY_CONFIG; } });
+var people_1 = require("./modules/people");
+Object.defineProperty(exports, "DEFAULT_INITIAL_RETRY_CONFIG", { enumerable: true, get: function () { return people_1.DEFAULT_INITIAL_RETRY_CONFIG; } });
+Object.defineProperty(exports, "DEFAULT_AGGRESSIVE_RETRY_CONFIG", { enumerable: true, get: function () { return people_1.DEFAULT_AGGRESSIVE_RETRY_CONFIG; } });
 // ===== Performance Optimization =====
 var performance_1 = require("./performance");
 Object.defineProperty(exports, "AdaptiveRateLimiter", { enumerable: true, get: function () { return performance_1.AdaptiveRateLimiter; } });

package/dist/matching/matcher.d.ts

@@ -1,11 +1,12 @@
 /**
  * v2.0.0 Person Matching Logic
  */
+import type { PcoClientConfig } from '@rachelallyson/planning-center-base-ts';
 import type { PeopleModule } from '../modules/people';
-import type { PersonResource } from '../types';
+import type { FlattenedPersonResource } from '../types';
 import { PersonMatchOptions } from '../modules/people';
 export interface MatchResult {
-    person: PersonResource;
+    person: FlattenedPersonResource;
     score: number;
     reason: string;
     isVerifiedContactMatch?: boolean;
@@ -14,7 +15,10 @@ export declare class PersonMatcher {
     private peopleModule;
     private strategies;
     private scorer;
-    constructor(peopleModule: PeopleModule);
+    private getConfig?;
+    constructor(peopleModule: PeopleModule, getConfig?: () => PcoClientConfig);
+    /** Log only when client config has debug enabled; no-op otherwise */
+    private debugLog;
     /**
      * Resolve retry configuration from options, with defaults
      */
@@ -34,7 +38,7 @@ export declare class PersonMatcher {
      * @param options.retryConfig - Configuration for retry logic to handle PCO contact verification delays
      * @param options.searchStrategy - 'single' for standard search, 'multi-step' for trying multiple strategies
      */
-    findOrCreate(options: PersonMatchOptions): Promise<PersonResource>;
+    findOrCreate(options: PersonMatchOptions): Promise<FlattenedPersonResource>;
     /**
      * Final aggressive search before creating a new person
      *

package/dist/matching/matcher.js

@@ -4,15 +4,23 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PersonMatcher = void 0;
+const planning_center_base_ts_1 = require("@rachelallyson/planning-center-base-ts");
 const people_1 = require("../modules/people");
 const strategies_1 = require("./strategies");
 const scoring_1 = require("./scoring");
 const helpers_1 = require("../helpers");
 class PersonMatcher {
-    constructor(peopleModule) {
+    constructor(peopleModule, getConfig) {
         this.peopleModule = peopleModule;
+        this.getConfig = getConfig;
         this.strategies = new strategies_1.MatchStrategies();
-        this.scorer = new scoring_1.MatchScorer(peopleModule);
+        this.scorer = new scoring_1.MatchScorer(peopleModule, getConfig);
+    }
+    /** Log only when client config has debug enabled; no-op otherwise */
+    debugLog(message, data) {
+        const logger = (0, planning_center_base_ts_1.createDebugLogger)(this.getConfig?.());
+        if (logger.enabled)
+            logger.log(message, data);
     }
     /**
      * Resolve retry configuration from options, with defaults
@@ -101,7 +109,7 @@ class PersonMatcher {
     async findWithAggressiveRetry(options) {
         const { matchStrategy = 'fuzzy', searchStrategy = 'single', retryConfigs } = options;
         const aggressiveConfig = this.resolveRetryConfig(undefined, retryConfigs?.aggressive, people_1.DEFAULT_AGGRESSIVE_RETRY_CONFIG);
-        console.log(`[PERSON_MATCH] Starting aggressive final search before create`, {
+        this.debugLog(`findOrCreate  aggressive final search before create`, {
             maxWaitTime: aggressiveConfig.maxWaitTime,
             maxRetries: aggressiveConfig.maxRetries,
         });
@@ -116,7 +124,7 @@ class PersonMatcher {
                     match = await this.findMatch({ ...options, matchStrategy });
                 }
                 if (match) {
-                    console.log(`[PERSON_MATCH] Aggressive search found person (would have created duplicate)`, {
+                    this.debugLog(`findOrCreate  aggressive search found person (would have created duplicate)`, {
                         personId: match.person.id,
                         attempt,
                         totalWaitTime,
@@ -125,7 +133,7 @@ class PersonMatcher {
                 }
             }
             catch (error) {
-                console.warn(`[PERSON_MATCH] Aggressive search attempt ${attempt} failed:`, error);
+                this.debugLog(`findOrCreate  aggressive search attempt ${attempt} failed`, { error: String(error) });
             }
             // Don't wait on the last attempt
             if (attempt === aggressiveConfig.maxRetries) {
@@ -139,7 +147,7 @@ class PersonMatcher {
             totalWaitTime += delay;
             await new Promise(resolve => setTimeout(resolve, delay));
         }
-        console.log(`[PERSON_MATCH] Aggressive search completed - no match found, safe to create`, {
+        this.debugLog(`findOrCreate  aggressive search completed - no match found, safe to create`, {
             totalWaitTime,
             maxRetries: aggressiveConfig.maxRetries,
         });
@@ -172,7 +180,7 @@ class PersonMatcher {
                 }
                 const match = await this.findMatch(searchOptions);
                 if (match) {
-                    console.log(`[PERSON_MATCH] Multi-step search found match using ${strategy.description}`, {
+                    this.debugLog(`findOrCreate  multi-step search found match using ${strategy.description}`, {
                         personId: match.person.id,
                         score: match.score,
                         reason: match.reason,
@@ -182,7 +190,7 @@ class PersonMatcher {
             }
             catch (error) {
                 // Log but continue to next strategy
-                console.warn(`[PERSON_MATCH] Multi-step strategy "${strategy.description}" failed:`, error);
+                this.debugLog(`findOrCreate  multi-step strategy "${strategy.description}" failed`, { error: String(error) });
             }
         }
         return null;
@@ -226,7 +234,7 @@ class PersonMatcher {
                     }
                     // Log success if we had to retry
                     if (attempt > 1) {
-                        console.log(`[PERSON_MATCH] Found person after ${attempt} attempts (waited ${totalWaitTime}ms)`, {
+                        this.debugLog(`findOrCreate  found person after ${attempt} attempts (waited ${totalWaitTime}ms)`, {
                             personId: person.id,
                             attempt,
                             totalWaitTime,
@@ -250,7 +258,7 @@ class PersonMatcher {
             );
             // Check if we've exceeded max wait time
             if (totalWaitTime + delay > maxWaitTime) {
-                console.warn(`[PERSON_MATCH] Max wait time (${maxWaitTime}ms) exceeded, stopping retries`, {
+                this.debugLog(`findOrCreate  max wait time (${maxWaitTime}ms) exceeded, stopping retries`, {
                     attempt,
                     totalWaitTime,
                     remainingDelay: maxWaitTime - totalWaitTime
@@ -259,7 +267,7 @@ class PersonMatcher {
             }
             totalWaitTime += delay;
             // Log retry attempt
-            console.log(`[PERSON_MATCH] Attempt ${attempt} failed, retrying in ${delay}ms`, {
+            this.debugLog(`findOrCreate  attempt ${attempt} failed, retrying in ${delay}ms`, {
                 attempt,
                 delay,
                 totalWaitTime,
@@ -284,18 +292,15 @@ class PersonMatcher {
         // Search by email (with normalization and validation)
         if (email) {
             // Validate email format to avoid wasted API calls
-            if (!(0, helpers_1.isValidEmail)(email)) {
-                console.warn('Invalid email format, skipping email search:', email);
-            }
-            else {
+            if ((0, helpers_1.isValidEmail)(email)) {
                 try {
                     // Normalize email before search to improve PCO search results
                     const normalizedEmail = (0, helpers_1.normalizeEmail)(email);
                     const emailResults = await this.peopleModule.search({ email: normalizedEmail });
                     emailPhoneMatches.push(...emailResults.data);
                 }
-                catch (error) {
-                    console.warn('Email search failed:', error);
+                catch {
+                    // Email search failed, continue without email results
                 }
             }
         }
@@ -307,8 +312,8 @@ class PersonMatcher {
                 const phoneResults = await this.peopleModule.search({ phone: normalizedPhone });
                 emailPhoneMatches.push(...phoneResults.data);
             }
-            catch (error) {
-                console.warn('Phone search failed:', error);
+            catch {
+                // Phone search failed, continue without phone results
             }
         }
         // Remove duplicates
@@ -342,7 +347,7 @@ class PersonMatcher {
                     nameOnlyMatches.push(...nameResults.data);
                 }
                 catch (error) {
-                    console.warn('Name search failed:', error);
+                    this.debugLog('findMatch  name search failed', { error: String(error) });
                 }
             }
         }
@@ -407,7 +412,6 @@ class PersonMatcher {
      */
     async findMatchByNameWithContactValidation(firstName, lastName, searchEmail, searchPhone, validationStrategy, options) {
         try {
-            console.log(`[PERSON_MATCH] Attempting name-based search fallback for ${firstName} ${lastName}`);
             const nameResults = await this.peopleModule.search({
                 name: `${firstName} ${lastName}`
             });
@@ -420,11 +424,6 @@ class PersonMatcher {
                 if (isValid) {
                     const score = await this.scorer.scoreMatch(candidate, options);
                     const reason = await this.scorer.getMatchReason(candidate, options);
-                    console.log(`[PERSON_MATCH] Name-based search found validated match`, {
-                        personId: candidate.id,
-                        validationStrategy,
-                        score,
-                    });
                     return {
                         person: candidate,
                         score,
@@ -433,14 +432,9 @@ class PersonMatcher {
                     };
                 }
             }
-            console.log(`[PERSON_MATCH] Name-based search found candidates but none passed contact validation`, {
-                candidateCount: nameResults.data.length,
-                validationStrategy,
-            });
             return null;
         }
-        catch (error) {
-            console.warn('[PERSON_MATCH] Name-based search fallback failed:', error);
+        catch {
             return null;
         }
     }
@@ -451,8 +445,8 @@ class PersonMatcher {
         try {
             // Get person's contact info
             const [personEmails, personPhones] = await Promise.all([
-                this.peopleModule.getEmails(candidate.id).then(r => r.data?.map(e => e.attributes?.address || '').filter(Boolean) || []).catch(() => []),
-                this.peopleModule.getPhoneNumbers(candidate.id).then(r => r.data?.map(p => p.attributes?.number || '').filter(Boolean) || []).catch(() => []),
+                this.peopleModule.getEmails(candidate.id).then(r => r.data?.map(e => e.address || '').filter(Boolean) || []).catch(() => []),
+                this.peopleModule.getPhoneNumbers(candidate.id).then(r => r.data?.map(p => p.number || '').filter(Boolean) || []).catch(() => []),
             ]);
             switch (validationStrategy) {
                 case 'strict':
@@ -490,7 +484,7 @@ class PersonMatcher {
             }
         }
         catch (error) {
-            console.warn(`[PERSON_MATCH] Contact validation failed for person ${candidate.id}:`, error);
+            this.debugLog(`findMatch  contact validation failed for person ${candidate.id}`, { error: String(error) });
             return false;
         }
     }
@@ -508,7 +502,7 @@ class PersonMatcher {
                 candidates.push(...emailMatches.data);
             }
             catch (error) {
-                console.warn('Email search failed:', error);
+                this.debugLog('findMatch  email search failed', { error: String(error) });
             }
         }
         // Strategy 2: Exact phone match
@@ -518,7 +512,7 @@ class PersonMatcher {
                 candidates.push(...phoneMatches.data);
             }
             catch (error) {
-                console.warn('Phone search failed:', error);
+                this.debugLog('findMatch  phone search failed', { error: String(error) });
             }
         }
         // Strategy 3: Name-based search
@@ -530,7 +524,7 @@ class PersonMatcher {
                 candidates.push(...nameMatches.data);
             }
             catch (error) {
-                console.warn('Name search failed:', error);
+                this.debugLog('findMatch  name search failed', { error: String(error) });
             }
         }
         // Strategy 4: Broader search if no exact matches
@@ -542,7 +536,7 @@ class PersonMatcher {
                 candidates.push(...broadMatches.data);
             }
             catch (error) {
-                console.warn('Broad search failed:', error);
+                this.debugLog('findMatch  broad search failed', { error: String(error) });
             }
         }
         // Remove duplicates based on person ID
@@ -558,7 +552,7 @@ class PersonMatcher {
         try {
             const personEmails = await this.peopleModule.getEmails(person.id);
             const normalizedSearchEmail = (0, helpers_1.normalizeEmail)(email);
-            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);
         }
         catch {
@@ -572,7 +566,7 @@ class PersonMatcher {
         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);
         }
         catch {
@@ -597,7 +591,7 @@ class PersonMatcher {
                 }
             }
             catch (error) {
-                console.warn(`Failed to add email contact for person ${person.id}:`, error);
+                this.debugLog(`addMissingContactInfo  failed to add email for person ${person.id}`, { error: String(error) });
             }
         }
         // Check and add phone if provided and missing
@@ -613,7 +607,7 @@ class PersonMatcher {
                 }
             }
             catch (error) {
-                console.warn(`Failed to add phone contact for person ${person.id}:`, error);
+                this.debugLog(`addMissingContactInfo  failed to add phone for person ${person.id}`, { error: String(error) });
             }
         }
     }
@@ -629,7 +623,7 @@ class PersonMatcher {
             return candidates;
         }
         return candidates.filter(person => {
-            const birthdate = person.attributes?.birthdate;
+            const birthdate = person.birthdate;
             return (0, helpers_1.matchesAgeCriteria)(birthdate, {
                 agePreference: options.agePreference,
                 minAge: options.minAge,
@@ -648,11 +642,14 @@ class PersonMatcher {
             throw new Error('First name is required to create a person');
         }
         // Create basic person data (only name fields)
+        // Use camelCase as expected by PersonCreateOptions
         const personData = {};
         if (options.firstName)
-            personData.first_name = options.firstName;
+            personData.firstName = options.firstName;
         if (options.lastName)
-            personData.last_name = options.lastName;
+            personData.lastName = options.lastName;
+        // Status is required by the API
+        personData.status = 'active';
         // Create the person first
         const person = await this.peopleModule.create(personData);
         // Add email contact if provided
@@ -665,7 +662,7 @@ class PersonMatcher {
                 });
             }
             catch (error) {
-                console.warn(`Failed to create email contact for person ${person.id}:`, error);
+                this.debugLog(`createPerson  failed to create email for person ${person.id}`, { error: String(error) });
             }
         }
         // Add phone contact if provided
@@ -678,19 +675,15 @@ class PersonMatcher {
                 });
             }
             catch (error) {
-                console.warn(`Failed to create phone contact for person ${person.id}:`, error);
+                this.debugLog(`createPerson  failed to create phone for person ${person.id}`, { error: String(error) });
             }
         }
         // Set campus if provided
         if (options.campusId) {
-            try {
-                await this.peopleModule.setPrimaryCampus(person.id, options.campusId);
-            }
-            catch (error) {
-                console.warn(`Failed to set campus for person ${person.id}:`, error);
-            }
+            await this.peopleModule.setPrimaryCampus(person.id, options.campusId);
         }
-        return person;
+        // Return the flattened person resource to match the type expected by the rest of the code
+        return this.peopleModule.getById(person.id);
     }
     /**
      * Get all potential matches with detailed scoring
@@ -706,7 +699,7 @@ class PersonMatcher {
                 emailPhoneMatches.push(...emailResults.data);
             }
             catch (error) {
-                console.warn('Email search failed:', error);
+                this.debugLog('findMatch  email search failed', { error: String(error) });
             }
         }
         if (phone) {
@@ -715,7 +708,7 @@ class PersonMatcher {
                 emailPhoneMatches.push(...phoneResults.data);
             }
             catch (error) {
-                console.warn('Phone search failed:', error);
+                this.debugLog('findMatch  phone search failed', { error: String(error) });
             }
         }
         const uniqueEmailPhoneMatches = emailPhoneMatches.filter((person, index, self) => index === self.findIndex(p => p.id === person.id));
@@ -742,7 +735,7 @@ class PersonMatcher {
                     nameOnlyMatches.push(...nameResults.data);
                 }
                 catch (error) {
-                    console.warn('Name search failed:', error);
+                    this.debugLog('findMatch  name search failed', { error: String(error) });
                 }
             }
         }

package/dist/matching/scoring.d.ts

@@ -1,27 +1,30 @@
 /**
  * v2.0.0 Person Match Scoring
  */
-import type { PersonResource } from '../types';
+import type { PcoClientConfig } from '@rachelallyson/planning-center-base-ts';
+import type { FlattenedPersonResource } from '../types';
 import type { PersonMatchOptions, PeopleModule } from '../modules/people';
 export declare class MatchScorer {
     private peopleModule;
-    constructor(peopleModule: PeopleModule);
+    private getConfig?;
+    constructor(peopleModule: PeopleModule, getConfig?: () => PcoClientConfig);
+    private debugLog;
     /**
      * Score a person match based on various criteria
      */
-    scoreMatch(person: PersonResource, options: PersonMatchOptions): Promise<number>;
+    scoreMatch(person: FlattenedPersonResource, options: PersonMatchOptions): Promise<number>;
     /**
      * Get a human-readable reason for the match
      */
-    getMatchReason(person: PersonResource, options: PersonMatchOptions): Promise<string>;
+    getMatchReason(person: FlattenedPersonResource, options: PersonMatchOptions): Promise<string>;
     /**
      * Score email matching - verifies actual email matches
      */
-    scoreEmailMatch(person: PersonResource, email: string): Promise<number>;
+    scoreEmailMatch(person: FlattenedPersonResource, email: string): Promise<number>;
     /**
      * Score phone matching - verifies actual phone matches
      */
-    scorePhoneMatch(person: PersonResource, phone: string): Promise<number>;
+    scorePhoneMatch(person: FlattenedPersonResource, phone: string): Promise<number>;
     /**
      * Score name matching - only exact matches
      */