bamboohr-local-dev-loop

# BambooHR Local Dev Loop ## Overview Set up a fast, reproducible local development workflow for BambooHR integrations with request mocking, hot reload, and integration testing against the real API. ## Prerequisites - Completed `bamboohr-install-auth` setup - Node.js 18+ with npm or pnpm - `BAMBOOHR_API_KEY` and `BAMBOOHR_COMPANY_DOMAIN` set in `.env` ## Instructions ### Step 1: Project Structure ``` my-bamboohr-project/ ├── src/ │ ├── bamboohr/ │ │ ├── client.ts # Reusable API client │ │ ├── types.ts # BambooHR response types │ │ └── employees.ts # Employee operations │ └── index.ts ├── tests/ │ ├── mocks/ │ │ └── bamboohr.ts # API response fixtures │ ├── unit/ │ │ └── employees.test.ts │ └── integration/ │ └── bamboohr.test.ts ├── .env.local # Real API key (git-ignored) ├── .env.example # Template for team ├── .env.test # Test config (sandbox key) └── package.json ``` ### Step 2: Create Reusable API Client ```typescript // src/bamboohr/client.ts import 'dotenv/config'; export class BambooHRClient { private baseUrl: string; private authHeader: string; constructor(companyDomain?: string, apiKey?: string) { const domain = companyDomain || process.env.BAMBOOHR_COMPANY_DOMAIN!; const key = apiKey || process.env.BAMBOOHR_API_KEY!; this.baseUrl = `https://api.bamboohr.com/api/gateway.php/${domain}/v1`; this.authHeader = `Basic ${Buffer.from(`${key}...