navan-local-dev-loop

# Navan Local Dev Loop ## Overview Configure a local development environment for Navan API integrations with token caching, request logging, and mock fixtures. Navan has **no sandbox** — all API calls hit production, making a structured local setup essential. **Purpose:** Establish a safe local dev workflow that minimizes production API calls during iteration. ## Prerequisites - Completed `navan-install-auth` with working OAuth 2.0 credentials - Node.js 18+ with `tsx` for TypeScript execution - `.env` file with `NAVAN_CLIENT_ID`, `NAVAN_CLIENT_SECRET`, `NAVAN_BASE_URL` ## Instructions ### Step 1: Project Structure Set up a clean project layout that separates concerns: ``` my-navan-integration/ ├── .env # Credentials (NEVER commit) ├── .env.example # Template for teammates ├── .gitignore # Must include .env, .token-cache, logs/ ├── src/ │ ├── navan-client.ts # API wrapper (from navan-sdk-patterns) │ ├── navan-types.ts # Response interfaces │ └── index.ts # Entry point ├── tests/ │ ├── fixtures/ # Recorded API responses for offline dev │ │ ├── bookings.json │ │ └── users.json │ └── navan-client.test.ts ├── logs/ # Request/response logs (gitignored) ├── .token-cache # Cached OAuth token (gitignored) ├── package.json └── tsconfig.json ``` ### Step 2: Environment Configuration Create `.env.example` as a safe template and enforce `.gitignore`: ```bash ...