deepgram-local-dev-loop

# Deepgram Local Dev Loop ## Overview Set up a fast local development workflow for Deepgram: test fixtures with sample audio, mock responses for offline unit tests, Vitest integration tests against the real API, and a watch-mode transcription dev server. ## Prerequisites - `@deepgram/sdk` installed, `DEEPGRAM_API_KEY` configured - `npm install -D vitest tsx dotenv` for testing and dev server - Optional: `curl` for downloading test fixtures ## Instructions ### Step 1: Project Structure ```bash mkdir -p src tests/mocks fixtures touch src/transcribe.ts tests/transcribe.test.ts tests/mocks/deepgram-responses.ts ``` ### Step 2: Download Test Fixtures ```bash # Deepgram provides free sample audio files curl -o fixtures/nasa-podcast.wav \ https://static.deepgram.com/examples/nasa-podcast.wav curl -o fixtures/bueller.wav \ https://static.deepgram.com/examples/Bueller-Life-moves-702702706.wav ``` ### Step 3: Environment Config ```bash # .env.development DEEPGRAM_API_KEY=your-dev-key DEEPGRAM_MODEL=nova-3 # .env.test (use a separate test key with low limits) DEEPGRAM_API_KEY=your-test-key DEEPGRAM_MODEL=base ``` ```json { "scripts": { "dev": "tsx watch src/transcribe.ts", "test": "vitest", "test:watch": "vitest --watch", "test:integration": "vitest run tests/integration/" } } ``` ### Step 4: Mock Deepgram Responses ```typescript // tests/mocks/deepgram-responses.ts export const mockPrerecordedResult = { metadata: { request_id: 'mock-request-i...