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

package/dist/monitoring.js

@@ -0,0 +1,142 @@
+"use strict";
+/**
+ * v2.0.0 Event System and Monitoring
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RateLimitTracker = exports.PerformanceMetrics = exports.RequestIdGenerator = exports.PcoEventEmitter = void 0;
+class PcoEventEmitter {
+    constructor() {
+        this.handlers = new Map();
+    }
+    on(eventType, handler) {
+        if (!this.handlers.has(eventType)) {
+            this.handlers.set(eventType, new Set());
+        }
+        this.handlers.get(eventType).add(handler);
+    }
+    off(eventType, handler) {
+        const eventHandlers = this.handlers.get(eventType);
+        if (eventHandlers) {
+            eventHandlers.delete(handler);
+            if (eventHandlers.size === 0) {
+                this.handlers.delete(eventType);
+            }
+        }
+    }
+    emit(event) {
+        const eventHandlers = this.handlers.get(event.type);
+        if (eventHandlers) {
+            for (const handler of eventHandlers) {
+                try {
+                    handler(event);
+                }
+                catch (error) {
+                    console.error(`Error in event handler for ${event.type}:`, error);
+                }
+            }
+        }
+    }
+    /** Remove all event handlers */
+    removeAllListeners(eventType) {
+        if (eventType) {
+            this.handlers.delete(eventType);
+        }
+        else {
+            this.handlers.clear();
+        }
+    }
+    /** Get the number of listeners for an event type */
+    listenerCount(eventType) {
+        return this.handlers.get(eventType)?.size || 0;
+    }
+    /** Get all registered event types */
+    eventTypes() {
+        return Array.from(this.handlers.keys());
+    }
+}
+exports.PcoEventEmitter = PcoEventEmitter;
+/**
+ * Request ID generator for tracking requests
+ */
+class RequestIdGenerator {
+    constructor() {
+        this.counter = 0;
+    }
+    generate() {
+        return `req_${Date.now()}_${++this.counter}`;
+    }
+}
+exports.RequestIdGenerator = RequestIdGenerator;
+/**
+ * Performance metrics collector
+ */
+class PerformanceMetrics {
+    constructor() {
+        this.metrics = new Map();
+    }
+    record(operation, duration, success = true) {
+        const existing = this.metrics.get(operation) || {
+            count: 0,
+            totalTime: 0,
+            minTime: Infinity,
+            maxTime: 0,
+            errors: 0,
+        };
+        existing.count++;
+        existing.totalTime += duration;
+        existing.minTime = Math.min(existing.minTime, duration);
+        existing.maxTime = Math.max(existing.maxTime, duration);
+        if (!success) {
+            existing.errors++;
+        }
+        this.metrics.set(operation, existing);
+    }
+    getMetrics() {
+        const result = {};
+        for (const [operation, metrics] of this.metrics) {
+            result[operation] = {
+                count: metrics.count,
+                averageTime: metrics.totalTime / metrics.count,
+                minTime: metrics.minTime === Infinity ? 0 : metrics.minTime,
+                maxTime: metrics.maxTime,
+                errorRate: metrics.errors / metrics.count,
+            };
+        }
+        return result;
+    }
+    reset() {
+        this.metrics.clear();
+    }
+}
+exports.PerformanceMetrics = PerformanceMetrics;
+/**
+ * Rate limit tracker
+ */
+class RateLimitTracker {
+    constructor() {
+        this.limits = new Map();
+    }
+    update(endpoint, limit, remaining, resetTime) {
+        this.limits.set(endpoint, { limit, remaining, resetTime });
+    }
+    getRemaining(endpoint) {
+        const limit = this.limits.get(endpoint);
+        return limit?.remaining || 0;
+    }
+    getResetTime(endpoint) {
+        const limit = this.limits.get(endpoint);
+        return limit?.resetTime || 0;
+    }
+    isRateLimited(endpoint) {
+        const limit = this.limits.get(endpoint);
+        return limit ? limit.remaining <= 0 : false;
+    }
+    getAllLimits() {
+        const result = {};
+        for (const [endpoint, limit] of this.limits) {
+            result[endpoint] = limit;
+        }
+        return result;
+    }
+}
+exports.RateLimitTracker = RateLimitTracker;

package/dist/testing/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * v2.0.0 Testing Utilities
+ */
+export { SimpleMockResponseBuilder as MockResponseBuilder } from './simple-builders';
+export { SimpleMockPcoClient as MockPcoClient, createSimpleMockClient as createMockClient, createTestClient, createErrorMockClient, createSlowMockClient } from './simple-factories';
+export type { SimpleMockClientConfig as MockClientConfig } from './simple-factories';
+export { RequestRecorder } from './recorder';
+export type { RecordingConfig } from './types';
+export declare function createRecordingClient(config: any, recordingConfig: any): any;

package/dist/testing/index.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * v2.0.0 Testing Utilities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestRecorder = exports.createSlowMockClient = exports.createErrorMockClient = exports.createTestClient = exports.createMockClient = exports.MockPcoClient = exports.MockResponseBuilder = void 0;
+exports.createRecordingClient = createRecordingClient;
+// Export simplified versions that work without complex type issues
+var simple_builders_1 = require("./simple-builders");
+Object.defineProperty(exports, "MockResponseBuilder", { enumerable: true, get: function () { return simple_builders_1.SimpleMockResponseBuilder; } });
+var simple_factories_1 = require("./simple-factories");
+Object.defineProperty(exports, "MockPcoClient", { enumerable: true, get: function () { return simple_factories_1.SimpleMockPcoClient; } });
+Object.defineProperty(exports, "createMockClient", { enumerable: true, get: function () { return simple_factories_1.createSimpleMockClient; } });
+Object.defineProperty(exports, "createTestClient", { enumerable: true, get: function () { return simple_factories_1.createTestClient; } });
+Object.defineProperty(exports, "createErrorMockClient", { enumerable: true, get: function () { return simple_factories_1.createErrorMockClient; } });
+Object.defineProperty(exports, "createSlowMockClient", { enumerable: true, get: function () { return simple_factories_1.createSlowMockClient; } });
+// Export recorder (simplified)
+var recorder_1 = require("./recorder");
+Object.defineProperty(exports, "RequestRecorder", { enumerable: true, get: function () { return recorder_1.RequestRecorder; } });
+// Export createRecordingClient (simplified)
+function createRecordingClient(config, recordingConfig) {
+    // Simplified implementation
+    return new (require('./simple-factories').SimpleMockPcoClient)(config);
+}

package/dist/testing/recorder.d.ts

@@ -0,0 +1,58 @@
+/**
+ * v2.0.0 Request/Response Recorder
+ */
+import type { RecordingConfig, RecordedRequest } from './types';
+export declare class RequestRecorder {
+    private config;
+    private requests;
+    private isRecording;
+    constructor(config: RecordingConfig);
+    /**
+     * Start recording requests
+     */
+    startRecording(): void;
+    /**
+     * Stop recording and save to file
+     */
+    stopRecording(): void;
+    /**
+     * Record a request/response pair
+     */
+    recordRequest(endpoint: string, method: string, params: Record<string, any> | undefined, data: any, response: any): void;
+    /**
+     * Replay a recorded request
+     */
+    replayRequest(endpoint: string, method: string, params: Record<string, any> | undefined, data: any): any | null;
+    /**
+     * Check if we should record or replay
+     */
+    shouldRecord(endpoint: string, method: string): boolean;
+    /**
+     * Get all recorded requests
+     */
+    getRequests(): RecordedRequest[];
+    /**
+     * Clear recorded requests
+     */
+    clearRequests(): void;
+    /**
+     * Save the current session to file
+     */
+    private saveSession;
+    /**
+     * Load a session from file
+     */
+    private loadSession;
+    /**
+     * Ensure the record directory exists
+     */
+    private ensureRecordDirectory;
+    /**
+     * Compare two parameter objects
+     */
+    private compareParams;
+    /**
+     * Compare two data objects
+     */
+    private compareData;
+}

package/dist/testing/recorder.js

@@ -0,0 +1,195 @@
+"use strict";
+/**
+ * v2.0.0 Request/Response Recorder
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestRecorder = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+class RequestRecorder {
+    constructor(config) {
+        this.requests = [];
+        this.isRecording = false;
+        this.config = config;
+        this.ensureRecordDirectory();
+    }
+    /**
+     * Start recording requests
+     */
+    startRecording() {
+        this.isRecording = true;
+        this.requests = [];
+    }
+    /**
+     * Stop recording and save to file
+     */
+    stopRecording() {
+        this.isRecording = false;
+        this.saveSession();
+    }
+    /**
+     * Record a request/response pair
+     */
+    recordRequest(endpoint, method, params, data, response) {
+        if (!this.isRecording)
+            return;
+        // Apply filter if provided
+        if (this.config.filter && !this.config.filter(endpoint, method)) {
+            return;
+        }
+        const request = {
+            endpoint,
+            method,
+            params,
+            data,
+            response: this.config.transform ? this.config.transform(response) : response,
+            timestamp: new Date().toISOString(),
+        };
+        this.requests.push(request);
+    }
+    /**
+     * Replay a recorded request
+     */
+    replayRequest(endpoint, method, params, data) {
+        const session = this.loadSession();
+        if (!session)
+            return null;
+        const request = session.requests.find(req => req.endpoint === endpoint &&
+            req.method === method &&
+            this.compareParams(req.params, params) &&
+            this.compareData(req.data, data));
+        return request ? request.response : null;
+    }
+    /**
+     * Check if we should record or replay
+     */
+    shouldRecord(endpoint, method) {
+        if (this.config.mode === 'record')
+            return true;
+        if (this.config.mode === 'replay')
+            return false;
+        // Auto mode: record if no existing session, otherwise replay
+        const session = this.loadSession();
+        return !session;
+    }
+    /**
+     * Get all recorded requests
+     */
+    getRequests() {
+        return [...this.requests];
+    }
+    /**
+     * Clear recorded requests
+     */
+    clearRequests() {
+        this.requests = [];
+    }
+    /**
+     * Save the current session to file
+     */
+    saveSession() {
+        const session = {
+            requests: this.requests,
+            metadata: {
+                recordedAt: new Date().toISOString(),
+                version: '2.0.0',
+                config: {}, // Would be filled with actual config
+            },
+        };
+        try {
+            fs.writeFileSync(this.config.recordPath, JSON.stringify(session, null, 2));
+        }
+        catch (error) {
+            console.error('Failed to save recording session:', error);
+        }
+    }
+    /**
+     * Load a session from file
+     */
+    loadSession() {
+        try {
+            if (!fs.existsSync(this.config.recordPath)) {
+                return null;
+            }
+            const content = fs.readFileSync(this.config.recordPath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch (error) {
+            console.error('Failed to load recording session:', error);
+            return null;
+        }
+    }
+    /**
+     * Ensure the record directory exists
+     */
+    ensureRecordDirectory() {
+        const dir = path.dirname(this.config.recordPath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+    }
+    /**
+     * Compare two parameter objects
+     */
+    compareParams(params1, params2) {
+        if (!params1 && !params2)
+            return true;
+        if (!params1 || !params2)
+            return false;
+        const keys1 = Object.keys(params1).sort();
+        const keys2 = Object.keys(params2).sort();
+        if (keys1.length !== keys2.length)
+            return false;
+        for (let i = 0; i < keys1.length; i++) {
+            if (keys1[i] !== keys2[i])
+                return false;
+            if (params1[keys1[i]] !== params2[keys2[i]])
+                return false;
+        }
+        return true;
+    }
+    /**
+     * Compare two data objects
+     */
+    compareData(data1, data2) {
+        if (!data1 && !data2)
+            return true;
+        if (!data1 || !data2)
+            return false;
+        return JSON.stringify(data1) === JSON.stringify(data2);
+    }
+}
+exports.RequestRecorder = RequestRecorder;

package/dist/testing/simple-builders.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Simplified Mock Response Builders for Testing
+ */
+export declare class SimpleMockResponseBuilder {
+    /**
+     * Build a simple mock person resource
+     */
+    static person(overrides?: any): any;
+    /**
+     * Build a simple mock email resource
+     */
+    static email(overrides?: any): any;
+    /**
+     * Build a simple mock phone number resource
+     */
+    static phoneNumber(overrides?: any): any;
+    /**
+     * Build a simple mock workflow resource
+     */
+    static workflow(overrides?: any): any;
+    /**
+     * Build a simple paginated response
+     */
+    static paginated(data: any[], meta?: any): any;
+    /**
+     * Build a simple single resource response
+     */
+    static single(data: any): any;
+    /**
+     * Build a simple error response
+     */
+    static error(status: number, message: string, details?: any): any;
+}

package/dist/testing/simple-builders.js

@@ -0,0 +1,124 @@
+"use strict";
+/**
+ * Simplified Mock Response Builders for Testing
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SimpleMockResponseBuilder = void 0;
+class SimpleMockResponseBuilder {
+    /**
+     * Build a simple mock person resource
+     */
+    static person(overrides = {}) {
+        return {
+            type: 'Person',
+            id: overrides.id || `person_${Date.now()}`,
+            attributes: {
+                id: overrides.id || `person_${Date.now()}`,
+                first_name: overrides.first_name || 'John',
+                last_name: overrides.last_name || 'Doe',
+                status: 'active',
+                ...overrides,
+            },
+            relationships: {
+                emails: { data: [] },
+                phone_numbers: { data: [] },
+                field_data: { data: [] },
+                workflow_cards: { data: [] },
+                household: { data: null },
+            },
+        };
+    }
+    /**
+     * Build a simple mock email resource
+     */
+    static email(overrides = {}) {
+        return {
+            type: 'Email',
+            id: overrides.id || `email_${Date.now()}`,
+            attributes: {
+                id: overrides.id || `email_${Date.now()}`,
+                address: overrides.address || 'john@example.com',
+                location: 'Home',
+                primary: true,
+                ...overrides,
+            },
+            relationships: {
+                person: { data: { type: 'Person', id: 'person_123' } },
+            },
+        };
+    }
+    /**
+     * Build a simple mock phone number resource
+     */
+    static phoneNumber(overrides = {}) {
+        return {
+            type: 'PhoneNumber',
+            id: overrides.id || `phone_${Date.now()}`,
+            attributes: {
+                id: overrides.id || `phone_${Date.now()}`,
+                number: overrides.number || '555-1234',
+                location: 'Mobile',
+                primary: true,
+                ...overrides,
+            },
+            relationships: {
+                person: { data: { type: 'Person', id: 'person_123' } },
+            },
+        };
+    }
+    /**
+     * Build a simple mock workflow resource
+     */
+    static workflow(overrides = {}) {
+        return {
+            type: 'Workflow',
+            id: overrides.id || `workflow_${Date.now()}`,
+            attributes: {
+                id: overrides.id || `workflow_${Date.now()}`,
+                name: overrides.name || 'New Member Workflow',
+                description: overrides.description || 'Workflow for new members',
+                ...overrides,
+            },
+            relationships: {},
+        };
+    }
+    /**
+     * Build a simple paginated response
+     */
+    static paginated(data, meta = {}) {
+        return {
+            data,
+            meta: {
+                total_count: data.length,
+                count: data.length,
+                ...meta,
+            },
+            links: {
+                self: '/api/v2/people?page=1',
+                next: null,
+                prev: null,
+            },
+        };
+    }
+    /**
+     * Build a simple single resource response
+     */
+    static single(data) {
+        return { data };
+    }
+    /**
+     * Build a simple error response
+     */
+    static error(status, message, details = {}) {
+        return {
+            errors: [
+                {
+                    status: status.toString(),
+                    title: message,
+                    detail: details,
+                },
+            ],
+        };
+    }
+}
+exports.SimpleMockResponseBuilder = SimpleMockResponseBuilder;

package/dist/testing/simple-factories.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Simplified Testing Factory Functions
+ */
+import type { PcoClientConfig } from '../types/client';
+export interface SimpleMockClientConfig {
+    people?: {
+        getAll?: () => Promise<any>;
+        getById?: (id: string) => Promise<any>;
+        create?: (data: any) => Promise<any>;
+        update?: (id: string, data: any) => Promise<any>;
+        delete?: (id: string) => Promise<void>;
+        findOrCreate?: (options: any) => Promise<any>;
+        createWithContacts?: (personData: any, contacts: any) => Promise<any>;
+        search?: (criteria: any) => Promise<any>;
+        getAllPages?: (options?: any) => Promise<any>;
+        addEmail?: (personId: string, data: any) => Promise<any>;
+        addPhoneNumber?: (personId: string, data: any) => Promise<any>;
+        addAddress?: (personId: string, data: any) => Promise<any>;
+        addSocialProfile?: (personId: string, data: any) => Promise<any>;
+    };
+    fields?: {
+        getAllFieldDefinitions?: () => Promise<any[]>;
+        getFieldDefinition?: (id: string) => Promise<any>;
+        getFieldDefinitionBySlug?: (slug: string) => Promise<any>;
+        getFieldDefinitionByName?: (name: string) => Promise<any>;
+        setPersonField?: (personId: string, options: any) => Promise<any>;
+        setPersonFieldById?: (personId: string, fieldId: string, value: string) => Promise<any>;
+        setPersonFieldBySlug?: (personId: string, slug: string, value: string) => Promise<any>;
+        setPersonFieldByName?: (personId: string, name: string, value: string) => Promise<any>;
+    };
+    workflows?: {
+        getAll?: (options?: any) => Promise<any>;
+        getById?: (id: string) => Promise<any>;
+        create?: (data: any) => Promise<any>;
+        update?: (id: string, data: any) => Promise<any>;
+        delete?: (id: string) => Promise<void>;
+        getAllPages?: (options?: any) => Promise<any>;
+        addPersonToWorkflow?: (personId: string, workflowId: string, options?: any) => Promise<any>;
+        createWorkflowCard?: (workflowId: string, personId: string) => Promise<any>;
+        createWorkflowCardNote?: (personId: string, workflowCardId: string, data: any) => Promise<any>;
+    };
+    batch?: {
+        execute?: (operations: any[]) => Promise<any>;
+    };
+}
+export declare class SimpleMockPcoClient {
+    people: any;
+    fields: any;
+    workflows: any;
+    contacts: any;
+    households: any;
+    notes: any;
+    lists: any;
+    batch: any;
+    private config;
+    private mockConfig;
+    constructor(config: PcoClientConfig, mockConfig?: SimpleMockClientConfig);
+    private createPeopleModule;
+    private createFieldsModule;
+    private createWorkflowsModule;
+    private createContactsModule;
+    private createHouseholdsModule;
+    private createNotesModule;
+    private createListsModule;
+    private createBatchModule;
+    on(eventType: string, handler: Function): void;
+    off(eventType: string, handler: Function): void;
+    emit(event: any): void;
+    getConfig(): PcoClientConfig;
+    getPerformanceMetrics(): any;
+    getRateLimitInfo(): any;
+    removeAllListeners(eventType?: string): void;
+    listenerCount(eventType: string): number;
+    eventTypes(): string[];
+}
+/**
+ * Create a simple mock client for testing
+ */
+export declare function createSimpleMockClient(config: PcoClientConfig, mockConfig?: SimpleMockClientConfig): SimpleMockPcoClient;
+/**
+ * Create a test client with common mock responses
+ */
+export declare function createTestClient(overrides?: SimpleMockClientConfig): SimpleMockPcoClient;
+/**
+ * Create a mock client that simulates errors
+ */
+export declare function createErrorMockClient(errorType?: 'network' | 'auth' | 'validation' | 'rate_limit'): SimpleMockPcoClient;
+/**
+ * Create a mock client with specific response delays
+ */
+export declare function createSlowMockClient(delayMs?: number): SimpleMockPcoClient;