bamboohr-sdk-patterns

# BambooHR SDK Patterns ## Overview Production-ready patterns for the BambooHR REST API. BambooHR has no official Node.js SDK — you call the API directly via `fetch` or `axios`. These patterns wrap the raw HTTP calls into type-safe, retry-aware, multi-tenant-ready code. ## Prerequisites - Completed `bamboohr-install-auth` setup - Familiarity with async/await and TypeScript generics ## Instructions ### Step 1: Type-Safe Client with Error Handling ```typescript // src/bamboohr/client.ts import 'dotenv/config'; export interface BambooHRConfig { companyDomain: string; apiKey: string; timeoutMs?: number; } export interface BambooEmployee { id: string; firstName: string; lastName: string; displayName: string; jobTitle: string; department: string; division: string; workEmail: string; location: string; status: string; hireDate: string; supervisor: string; employeeNumber: string; photoUrl?: string; } export class BambooHRClient { private base: string; private auth: string; private timeout: number; constructor(config: BambooHRConfig) { this.base = `https://api.bamboohr.com/api/gateway.php/${config.companyDomain}/v1`; this.auth = `Basic ${Buffer.from(`${config.apiKey}:x`).toString('base64')}`; this.timeout = config.timeoutMs ?? 30_000; } async request<T>(method: string, path: string, body?: unknown): Promise<T> { const controller = new AbortController(); const timer = setTimeout(() => controller.abort(), this....