@rachelallyson/planning-center-people-ts 2.1.0 → 2.2.0

package/CHANGELOG.md

@@ -5,6 +5,87 @@ 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.2.0] - 2025-01-17
+
+### 🏢 **NEW FEATURE - Campus Management Support**
+
+This release adds comprehensive Campus management functionality to the Planning Center People API client.
+
+### Added
+
+#### **🏢 Campus Module**
+
+- **Complete Campus CRUD Operations**: Create, read, update, and delete campuses
+- **Campus-Specific Operations**: Get campus lists and service times
+- **Type-Safe Campus Resource**: Full TypeScript support for campus attributes and relationships
+- **Pagination Support**: Automatic pagination for campus listings
+
+#### **📋 Campus Operations**
+
+- `client.campus.getAll()` - Get all campuses with filtering and pagination
+- `client.campus.getById(id, include?)` - Get specific campus by ID
+- `client.campus.create(data)` - Create new campus
+- `client.campus.update(id, data)` - Update existing campus
+- `client.campus.delete(id)` - Delete campus
+- `client.campus.getLists(campusId)` - Get lists for a specific campus
+- `client.campus.getServiceTimes(campusId)` - Get service times for a specific campus
+- `client.campus.getAllPagesPaginated()` - Get all campuses with automatic pagination
+
+#### **🏗️ Campus Resource Structure**
+
+- **Location Data**: `latitude`, `longitude`, `street`, `city`, `state`, `zip`, `country`
+- **Contact Information**: `phone_number`, `website`
+- **Settings**: `twenty_four_hour_time`, `date_format`, `church_center_enabled`
+- **Metadata**: `description`, `created_at`, `updated_at`
+
+### Documentation
+
+- **Updated README.md** with Campus Management examples
+- **Updated EXAMPLES.md** with comprehensive Campus usage patterns
+- **Updated API_REFERENCE.md** with complete Campus Module documentation
+- **Added Campus types** to resource types documentation
+
+### Testing
+
+- **Integration Tests**: Complete test suite for Campus operations
+- **Type Safety**: Full TypeScript coverage for Campus resources
+- **Error Handling**: Comprehensive error handling for Campus operations
+
+### Example Usage
+
+```typescript
+import { PcoClient } from '@rachelallyson/planning-center-people-ts';
+
+const client = new PcoClient({
+  auth: {
+    type: 'personal_access_token',
+    personalAccessToken: 'your-token'
+  }
+});
+
+// Get all campuses
+const campuses = await client.campus.getAll();
+
+// Create new campus
+const newCampus = await client.campus.create({
+  description: 'Main Campus',
+  street: '123 Church Street',
+  city: 'Anytown',
+  state: 'CA',
+  zip: '12345',
+  country: 'US',
+  phone_number: '555-123-4567',
+  website: 'https://maincampus.example.com',
+  twenty_four_hour_time: false,
+  date_format: 1,
+  church_center_enabled: true
+});
+
+// Get campus-specific data
+const campusLists = await client.campus.getLists('campus-id');
+const serviceTimes = await client.campus.getServiceTimes('campus-id');
+```
+
 ## [2.1.0] - 2025-01-17
 
 ### 🔒 **SECURITY RELEASE - Required Refresh Token Handling**

package/dist/client.d.ts

@@ -10,6 +10,7 @@ import { ContactsModule } from './modules/contacts';
 import { HouseholdsModule } from './modules/households';
 import { NotesModule } from './modules/notes';
 import { ListsModule } from './modules/lists';
+import { CampusModule } from './modules/campus';
 import { BatchExecutor } from './batch';
 export declare class PcoClient implements EventEmitter {
     people: PeopleModule;
@@ -19,6 +20,7 @@ export declare class PcoClient implements EventEmitter {
     households: HouseholdsModule;
     notes: NotesModule;
     lists: ListsModule;
+    campus: CampusModule;
     batch: BatchExecutor;
     private httpClient;
     private paginationHelper;

package/dist/client.js

@@ -14,6 +14,7 @@ const contacts_1 = require("./modules/contacts");
 const households_1 = require("./modules/households");
 const notes_1 = require("./modules/notes");
 const lists_1 = require("./modules/lists");
+const campus_1 = require("./modules/campus");
 const batch_1 = require("./batch");
 class PcoClient {
     constructor(config) {
@@ -29,6 +30,7 @@ class PcoClient {
         this.households = new households_1.HouseholdsModule(this.httpClient, this.paginationHelper, this.eventEmitter);
         this.notes = new notes_1.NotesModule(this.httpClient, this.paginationHelper, this.eventEmitter);
         this.lists = new lists_1.ListsModule(this.httpClient, this.paginationHelper, this.eventEmitter);
+        this.campus = new campus_1.CampusModule(this.httpClient, this.paginationHelper, this.eventEmitter);
         this.batch = new batch_1.BatchExecutor(this, this.eventEmitter);
         // Set up event handlers from config
         this.setupEventHandlers();

package/dist/index.d.ts

@@ -7,7 +7,7 @@ export type { Paginated, Relationship, ResourceIdentifier, ResourceObject, } fro
 export type { PersonResource, PersonAttributes, PersonSingle, PeopleList, EmailResource, EmailAttributes, PhoneNumberResource, PhoneNumberAttributes, AddressResource, AddressAttributes, SocialProfileResource, SocialProfileAttributes, } from './types';
 export type { FieldDefinitionResource, FieldDefinitionAttributes, FieldDatumResource, FieldDatumAttributes, FieldOptionResource, FieldOptionAttributes, TabResource, TabAttributes, } from './types';
 export type { WorkflowResource, WorkflowAttributes, WorkflowCardResource, WorkflowCardAttributes, WorkflowCardNoteResource, WorkflowCardNoteAttributes, } from './types';
-export type { HouseholdResource, HouseholdAttributes, NoteResource, NoteAttributes, ListResource, ListAttributes, OrganizationResource, OrganizationAttributes, } from './types';
+export type { HouseholdResource, HouseholdAttributes, NoteResource, NoteAttributes, ListResource, ListAttributes, OrganizationResource, OrganizationAttributes, CampusResource, CampusAttributes, CampusesList, } from './types';
 export * from './types';
 export type { PcoClientConfig as PcoClientConfigV1, PcoClientState } from './core';
 export { createPcoClient, del, getAllPages, getList, getRateLimitInfo, getSingle, patch, post, } from './core';

package/dist/modules/campus.d.ts

@@ -0,0 +1,63 @@
+import { BaseModule } from './base';
+import type { PcoHttpClient } from '../core/http';
+import type { PaginationHelper } from '../core/pagination';
+import type { PcoEventEmitter } from '../monitoring';
+import type { PaginationOptions, PaginationResult } from '../core/pagination';
+import type { CampusResource, CampusAttributes, CampusesList } from '../types';
+/**
+ * Campus module for managing campus-related operations
+ */
+export declare class CampusModule extends BaseModule {
+    constructor(httpClient: PcoHttpClient, paginationHelper: PaginationHelper, eventEmitter: PcoEventEmitter);
+    /**
+     * Get all campuses
+     */
+    getAll(params?: {
+        where?: Record<string, any>;
+        include?: string[];
+        per_page?: number;
+        page?: number;
+    }): Promise<CampusesList>;
+    /**
+     * Get a specific campus by ID
+     */
+    getById(id: string, include?: string[]): Promise<CampusResource>;
+    /**
+     * Create a new campus
+     */
+    create(data: CampusAttributes): Promise<CampusResource>;
+    /**
+     * Update an existing campus
+     */
+    update(id: string, data: Partial<CampusAttributes>): Promise<CampusResource>;
+    /**
+     * Delete a campus
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * Get lists for a specific campus
+     */
+    getLists(campusId: string, params?: {
+        where?: Record<string, any>;
+        include?: string[];
+        per_page?: number;
+        page?: number;
+    }): Promise<any>;
+    /**
+     * Get service times for a specific campus
+     */
+    getServiceTimes(campusId: string, params?: {
+        where?: Record<string, any>;
+        include?: string[];
+        per_page?: number;
+        page?: number;
+    }): Promise<any>;
+    /**
+     * Get all campuses with pagination support
+     */
+    getAllPagesPaginated(params?: {
+        where?: Record<string, any>;
+        include?: string[];
+        per_page?: number;
+    }, paginationOptions?: PaginationOptions): Promise<PaginationResult<CampusResource>>;
+}

package/dist/modules/campus.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CampusModule = void 0;
+const base_1 = require("./base");
+/**
+ * Campus module for managing campus-related operations
+ */
+class CampusModule extends base_1.BaseModule {
+    constructor(httpClient, paginationHelper, eventEmitter) {
+        super(httpClient, paginationHelper, eventEmitter);
+    }
+    /**
+     * Get all campuses
+     */
+    async getAll(params) {
+        return this.getList('/campuses', params);
+    }
+    /**
+     * Get a specific campus by ID
+     */
+    async getById(id, include) {
+        const params = {};
+        if (include) {
+            params.include = include.join(',');
+        }
+        return this.getSingle(`/campuses/${id}`, params);
+    }
+    /**
+     * Create a new campus
+     */
+    async create(data) {
+        return this.createResource('/campuses', data);
+    }
+    /**
+     * Update an existing campus
+     */
+    async update(id, data) {
+        return this.updateResource(`/campuses/${id}`, data);
+    }
+    /**
+     * Delete a campus
+     */
+    async delete(id) {
+        return this.deleteResource(`/campuses/${id}`);
+    }
+    /**
+     * Get lists for a specific campus
+     */
+    async getLists(campusId, params) {
+        return this.getList(`/campuses/${campusId}/lists`, params);
+    }
+    /**
+     * Get service times for a specific campus
+     */
+    async getServiceTimes(campusId, params) {
+        return this.getList(`/campuses/${campusId}/service_times`, params);
+    }
+    /**
+     * 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 this.getAllPages('/campuses', queryParams, paginationOptions);
+    }
+}
+exports.CampusModule = CampusModule;

package/dist/types/people.d.ts

@@ -376,4 +376,28 @@ export interface OrganizationStatisticResource extends ResourceObject<'Organizat
 }
 export type OrganizationStatisticsList = Paginated<OrganizationStatisticResource>;
 export type OrganizationStatisticSingle = Response<OrganizationStatisticResource>;
-export type PeopleIncluded = EmailResource | AddressResource | PhoneNumberResource | HouseholdResource | SocialProfileResource | FieldDatumResource | TabResource;
+export interface CampusAttributes extends Attributes {
+    latitude?: number;
+    longitude?: number;
+    description?: string;
+    street?: string;
+    city?: string;
+    state?: string;
+    zip?: string;
+    country?: string;
+    phone_number?: string;
+    website?: string;
+    twenty_four_hour_time?: boolean;
+    date_format?: number;
+    church_center_enabled?: boolean;
+    created_at?: string;
+    updated_at?: string;
+}
+export interface CampusRelationships {
+    organization?: Relationship;
+}
+export interface CampusResource extends ResourceObject<'Campus', CampusAttributes, CampusRelationships> {
+}
+export type CampusesList = Paginated<CampusResource>;
+export type CampusSingle = Response<CampusResource>;
+export type PeopleIncluded = EmailResource | AddressResource | PhoneNumberResource | HouseholdResource | SocialProfileResource | FieldDatumResource | TabResource | CampusResource;

package/package.json

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