@rachelallyson/planning-center-people-ts 2.6.0 → 2.6.1

package/CHANGELOG.md

@@ -5,12 +5,56 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.6.1] - 2025-01-10
+
+### 🐛 **CRITICAL BUG FIXES**
+
+This patch release fixes critical bugs in the `findOrCreate` method that would cause runtime errors and API failures.
+
+### Fixed
+
+- **🐛 Critical Bug in findOrCreate**: Fixed broken contact creation in `findOrCreate` method
+  - **Issue**: `createWithContacts` method didn't exist, causing runtime errors
+  - **Issue**: Email/phone passed to person creation caused 422 API errors
+  - **Fix**: Now properly creates person first, then adds contacts separately
+  - **Enhancement**: Added campus assignment support with `campusId` option
+  - **Enhancement**: Added proper error handling for contact creation failures
+
+### Changed
+
+- **🧹 Cleaned up PersonMatchOptions interface**: Removed unused `campus` field, kept only functional `campusId` field
+- **📝 Better error handling**: Contact creation failures now log warnings instead of crashing
+
+### Migration
+
+No breaking changes - this is a bug fix release:
+
+```typescript
+// This now works correctly (was broken in 2.6.0)
+const person = await client.people.findOrCreate({
+    firstName: 'John',
+    lastName: 'Doe',
+    email: 'john@example.com',
+    phone: '555-1234',
+    campusId: 'campus-123'  // NEW: Campus assignment support
+});
+```
+
 ## [2.6.0] - 2025-01-10
 
 ### 🎯 **PERFORMANCE & DEPENDENCY OPTIMIZATION**
 
 This release focuses on performance improvements and dependency optimization, making the library lighter, faster, and more efficient.
 
+### Fixed
+
+- **🐛 Critical Bug in findOrCreate**: Fixed broken contact creation in `findOrCreate` method
+  - **Issue**: `createWithContacts` method didn't exist, causing runtime errors
+  - **Issue**: Email/phone passed to person creation caused 422 API errors
+  - **Fix**: Now properly creates person first, then adds contacts separately
+  - **Enhancement**: Added campus assignment support with `campusId` option
+  - **Enhancement**: Added proper error handling for contact creation failures
+
 ### Removed
 
 - **📦 Axios Dependency**: Completely removed axios dependency by replacing it with native fetch API

package/dist/matching/matcher.js

@@ -132,26 +132,46 @@ class PersonMatcher {
      * Create a new person
      */
     async createPerson(options) {
+        // Create basic person data (only name fields)
         const personData = {};
         if (options.firstName)
             personData.first_name = options.firstName;
         if (options.lastName)
             personData.last_name = options.lastName;
-        if (options.email)
-            personData.email = options.email;
-        if (options.phone)
-            personData.phone = options.phone;
+        // Create the person first
         const person = await this.peopleModule.create(personData);
-        // Add contact information if provided
-        const contacts = {};
+        // Add email contact if provided
         if (options.email) {
-            contacts.email = { address: options.email, primary: true };
+            try {
+                await this.peopleModule.addEmail(person.id, {
+                    address: options.email,
+                    primary: true
+                });
+            }
+            catch (error) {
+                console.warn('Failed to create email contact:', error);
+            }
         }
+        // Add phone contact if provided
         if (options.phone) {
-            contacts.phone = { number: options.phone, primary: true };
+            try {
+                await this.peopleModule.addPhoneNumber(person.id, {
+                    number: options.phone,
+                    primary: true
+                });
+            }
+            catch (error) {
+                console.warn('Failed to create phone contact:', error);
+            }
         }
-        if (Object.keys(contacts).length > 0) {
-            await this.peopleModule.createWithContacts(personData, contacts);
+        // Set campus if provided
+        if (options.campusId) {
+            try {
+                await this.peopleModule.setPrimaryCampus(person.id, options.campusId);
+            }
+            catch (error) {
+                console.warn('Failed to set campus:', error);
+            }
         }
         return person;
     }

package/dist/modules/people.d.ts

@@ -48,7 +48,7 @@ export interface PersonMatchOptions {
     email?: string;
     phone?: string;
     matchStrategy?: 'exact' | 'fuzzy' | 'aggressive';
-    campus?: string;
+    campusId?: string;
     createIfNotFound?: boolean;
     agePreference?: 'adults' | 'children' | 'any';
     minAge?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@rachelallyson/planning-center-people-ts",
-    "version": "2.6.0",
+    "version": "2.6.1",
     "description": "A strictly typed TypeScript client for Planning Center Online People API with smart matching, batch operations, and enhanced developer experience",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",