bamboohr-performance-tuning

# BambooHR Performance Tuning ## Overview Optimize BambooHR API performance through request reduction, caching, incremental sync, and connection pooling. The biggest wins come from eliminating N+1 query patterns using custom reports and the changed-since endpoint. ## Prerequisites - BambooHR API client configured - Redis or in-memory cache available (optional) - Performance monitoring in place ## Instructions ### Step 1: Eliminate N+1 Queries with Custom Reports The single biggest performance improvement: use `POST /reports/custom` instead of individual employee GETs. ```typescript // BAD: 501 API calls for 500 employees const dir = await client.getDirectory(); // 1 call for (const emp of dir.employees) { await client.getEmployee(emp.id, ['salary', 'hireDate']); // 500 calls } // GOOD: 1 API call for all employees with all needed fields const report = await client.customReport([ 'firstName', 'lastName', 'department', 'jobTitle', 'hireDate', 'workEmail', 'status', 'location', 'supervisor', 'employeeNumber', ]); // 1 call, returns all employees with all fields ``` **Performance impact:** 500x reduction in API calls. Custom reports return all active employees in one request. ### Step 2: Incremental Sync with Changed-Since ```typescript import { readFileSync, writeFileSync } from 'fs'; const LAST_SYNC_FILE = '.bamboohr-last-sync'; async function incrementalSync(client: BambooHRClient): Promise<string[]> { // Read last sync timestamp ...