exa-local-dev-loop

# Exa Local Dev Loop ## Overview Set up a fast, reproducible local development workflow for Exa integrations. Covers project structure, mock responses for unit tests, integration test patterns, and hot-reload configuration. ## Prerequisites - `exa-js` installed and `EXA_API_KEY` configured - Node.js 18+ with npm/pnpm - `vitest` for testing (or `jest`) ## Instructions ### Step 1: Project Structure ``` my-exa-project/ ├── src/ │ ├── exa/ │ │ ├── client.ts # Singleton Exa client │ │ ├── search.ts # Search wrappers │ │ └── types.ts # Typed interfaces │ └── index.ts ├── tests/ │ ├── exa.unit.test.ts # Mock-based unit tests │ └── exa.integration.test.ts # Real API tests (needs key) ├── .env.local # Local secrets (git-ignored) ├── .env.example # Template for team ├── tsconfig.json ├── vitest.config.ts └── package.json ``` ### Step 2: Package Setup ```json { "scripts": { "dev": "tsx watch src/index.ts", "test": "vitest", "test:unit": "vitest --testPathPattern=unit", "test:integration": "vitest --testPathPattern=integration", "build": "tsc" }, "dependencies": { "exa-js": "^1.0.0" }, "devDependencies": { "tsx": "^4.0.0", "vitest": "^2.0.0", "typescript": "^5.0.0" } } ``` ### Step 3: Mock Exa for Unit Tests ```typescript // tests/exa.unit.test.ts import { describe, it, expect, vi, beforeEach } from "vitest"; // Mock the exa-js module vi.mock("exa-js", () => { retur...