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

# 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

// 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

// 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

// 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

import { describe, it, expect } from 'vitest';
import { createTestClient } from './test-utils/juicebox';

describe('Juicebox Search', () => {
  it('returns profiles for valid query', async () => {
    const client = createTestClient();
    const results = await client.search.people({
      query: 'engineer',
      limit: 5
    });

    expect(results.profiles.length).toBeGreaterThan(0);
  });
});

Resources

Next Steps

With local dev configured, explore juicebox-sdk-patterns for production patterns.