juicebox-local-dev-loop

# Juicebox Local Dev Loop

## Overview
Configure a fast local development workflow for Juicebox integration with mock data and testing utilities.

## Prerequisites
- Juicebox SDK installed
- Node.js or Python environment
- Test API key (sandbox mode)

## Instructions

### Step 1: Configure Development Environment
```bash
# Create development config
cat > .env.development << 'EOF'
JUICEBOX_API_KEY=jb_test_xxxxxxxxxxxx
JUICEBOX_ENVIRONMENT=sandbox
JUICEBOX_LOG_LEVEL=debug
EOF
```

### Step 2: Set Up Mock Data
```typescript
// mocks/juicebox.ts
export const mockProfiles = [
  {
    id: 'mock-1',
    name: 'Test User',
    title: 'Software Engineer',
    company: 'Test Corp',
    location: 'San Francisco, CA'
  }
];

export const mockSearchResponse = {
  total: 1,
  profiles: mockProfiles,
  hasMore: false
};
```

### Step 3: Create Test Utilities
```typescript
// test-utils/juicebox.ts
import { JuiceboxClient } from '@juicebox/sdk';

export function createTestClient() {
  return new JuiceboxClient({
    apiKey: process.env.JUICEBOX_API_KEY,
    sandbox: true,
    timeout: 5000
  });
}

export async function withMockSearch<T>(
  fn: (client: JuiceboxClient) => Promise<T>
): Promise<T> {
  const client = createTestClient();
  return fn(client);
}
```

### Step 4: Hot Reload Setup
```json
// package.json
{
  "scripts": {
    "dev": "nodemon --watch src --exec ts-node src/index.ts",
    "test:watch": "vitest watch"
  }
}
```

## Output
- Development environment configuration
- Mock data for offline testing
- Test utilities for integration tests
- Hot reload for rapid iteration

## Error Handling
| Error | Cause | Solution |
|-------|-------|----------|
| Sandbox Limit | Exceeded test quota | Wait or upgrade plan |
| Mock Mismatch | Schema changed | Update mock data |
| Hot Reload Fail | File lock | Restart dev server |

## Examples

### Integration Test
```typescript
import { describe, it, expect } from 'vitest';
import { createTestClient } from './test-utils/juicebox';

d