@rachelallyson/planning-center-people-ts 2.12.2 → 2.13.0

package/CHANGELOG.md

@@ -5,6 +5,16 @@ 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.13.0] - 2026-01-20
+
+### ✨ **New Features**
+
+- **🎯 Lenient Age Preference Filtering**: Added `agePreferenceLenient` option for flexible age-based filtering
+  - When `agePreferenceLenient: true`, age preferences only filter profiles that have birthdates
+  - Profiles without birthdates are included regardless of `agePreference` setting
+  - Prevents false negatives when searching for existing people with incomplete age data
+  - Backward compatible - default behavior remains strict filtering (only `agePreference: 'any'` includes profiles without birthdates)
+
 ## [2.12.2] - 2026-01-20
 
 ### ✨ **New Features**

package/dist/helpers.d.ts

@@ -35,6 +35,7 @@ export declare function matchesAgeCriteria(birthdate: string | undefined, criter
     minAge?: number;
     maxAge?: number;
     birthYear?: number;
+    agePreferenceLenient?: boolean;
 }): boolean;
 /**
  * Calculate birth year from age

package/dist/helpers.js

@@ -103,8 +103,13 @@ function isChild(birthdate) {
  */
 function matchesAgeCriteria(birthdate, criteria) {
     const age = calculateAgeSafe(birthdate);
-    // If no birthdate, only match if preference is 'any'
+    // If no birthdate, match based on lenient setting
     if (age === null) {
+        if (criteria.agePreferenceLenient) {
+            // Lenient mode: include profiles without birthdates regardless of agePreference
+            return true;
+        }
+        // Strict mode (default): only match if preference is 'any'
         return criteria.agePreference === 'any' || criteria.agePreference === undefined;
     }
     // Check age preference

package/dist/matching/matcher.js

@@ -377,7 +377,8 @@ class PersonMatcher {
                 agePreference: options.agePreference,
                 minAge: options.minAge,
                 maxAge: options.maxAge,
-                birthYear: options.birthYear
+                birthYear: options.birthYear,
+                agePreferenceLenient: options.agePreferenceLenient
             });
         });
     }

package/dist/matching/scoring.js

@@ -164,7 +164,8 @@ class MatchScorer {
             agePreference: options.agePreference,
             minAge: options.minAge,
             maxAge: options.maxAge,
-            birthYear: options.birthYear
+            birthYear: options.birthYear,
+            agePreferenceLenient: options.agePreferenceLenient
         });
         if (!matches) {
             return 0; // No match

package/dist/modules/people.d.ts

@@ -70,6 +70,12 @@ export interface PersonMatchOptions {
     addMissingContactInfo?: boolean;
     /** Age preference filter: 'adults' (18+), 'children' (<18), or 'any' */
     agePreference?: 'adults' | 'children' | 'any';
+    /**
+     * When true, age preference filters only apply to profiles with birthdates.
+     * Profiles without birthdates are included regardless of agePreference.
+     * When false (default), profiles without birthdates only match when agePreference is 'any'.
+     */
+    agePreferenceLenient?: boolean;
     /** Minimum age filter */
     minAge?: number;
     /** Maximum age filter */

package/package.json

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