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 # 5000: 5 seconds in ms }); }

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

• Sandbox Environment

• Testing Guide

Next Steps

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