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

package/CHANGELOG.md

@@ -5,12 +5,101 @@ 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.2] - 2025-01-10
+
+### 🎯 **TYPE DEFINITION ENHANCEMENT**
+
+This patch release adds enhanced type definitions for better TypeScript support and developer experience.
+
+### Added
+
+- **📝 FieldDataType Type**: Added comprehensive type definition for field data types
+  - **Types**: `'boolean' | 'checkboxes' | 'date' | 'file' | 'number' | 'select' | 'string' | 'text'`
+  - **Usage**: Provides type safety for field definition operations
+  - **Benefits**: Better IntelliSense and compile-time validation
+
+### Enhanced Type Safety
+
+```typescript
+// Now you get full type safety for field data types
+const fieldDefinition: FieldDefinitionAttributes = {
+  data_type: 'select', // ✅ TypeScript knows this is valid
+  // ... other properties
+};
+
+// Invalid types will be caught at compile time
+const invalidField = {
+  data_type: 'invalid', // ❌ TypeScript error
+};
+```
+
+### Migration
+
+No breaking changes - this is a type enhancement release:
+
+```typescript
+// Existing code continues to work
+const fields = await client.people.getFieldDefinitions();
+
+// New type safety benefits
+fields.data.forEach(field => {
+  if (field.attributes.data_type === 'select') {
+    // TypeScript knows this is a select field
+    console.log('Select field:', field.attributes.name);
+  }
+});
+```
+
+## [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/dist/people/fields.d.ts

@@ -1,6 +1,6 @@
 import { PcoClientState } from '../core';
 import type { ErrorContext } from '../error-handling';
-import { FieldDataList, FieldDataSingle, FieldDefinitionsList, FieldDefinitionSingle, FieldOptionAttributes, FieldOptionSingle, FieldOptionsList, TabsList } from '../types';
+import { FieldDataList, FieldDataSingle, FieldDataType, FieldDefinitionsList, FieldDefinitionSingle, FieldOptionAttributes, FieldOptionSingle, FieldOptionsList, TabsList } from '../types';
 /**
  * Delete field data for a person
  */
@@ -46,7 +46,7 @@ export declare function getTabs(client: PcoClientState, params?: {
  */
 export declare function createFieldDefinition(client: PcoClientState, tabId: string, data: {
     name: string;
-    data_type: string;
+    data_type: FieldDataType;
     sequence?: number;
     slug?: string;
     config?: string | Record<string, any>;

package/dist/types/people.d.ts

@@ -128,9 +128,10 @@ export interface SocialProfileResource extends ResourceObject<'SocialProfile', S
 }
 export type SocialProfilesList = Paginated<SocialProfileResource>;
 export type SocialProfileSingle = Response<SocialProfileResource>;
+export type FieldDataType = 'boolean' | 'checkboxes' | 'date' | 'file' | 'number' | 'select' | 'string' | 'text';
 export interface FieldDefinitionAttributes extends Attributes {
     config: string | Record<string, any> | null;
-    data_type: string;
+    data_type: FieldDataType;
     deleted_at: string | null | false;
     name: string;
     sequence: number;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@rachelallyson/planning-center-people-ts",
-    "version": "2.6.0",
+    "version": "2.6.2",
     "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",