API Overview

const healthCheck = await trpc.healthCheck.useQuery();
// Returns: { message: 'IM ALIVE!!!!', timestamp: string, status: 'healthy' }

const createBounty = await trpc.bounties.create.useMutation({
  title: 'Fix authentication bug',
  amount: 500,
  // ... other fields
});

// Health check endpoint
trpc.healthCheck.useQuery()
// Returns: { message: 'IM ALIVE!!!!', timestamp: string, status: 'healthy' }

// Ping endpoint
trpc.ping.useQuery()
// Returns: { message: 'pong', timestamp: string, status: 'healthy' }

// Protected data example
trpc.privateData.useQuery()
// Returns: { message: 'This is private' }
// Requires authentication

{
  code: 'TOO_MANY_REQUESTS',
  message: 'Rate limit exceeded. Try again in 45 seconds.',
  data: {
    reason: 'rate_limited',
    retryAfter: 45,
    limit: 100,
    reset: 1234567890
  }
}

ctx.rateLimit = {
  remaining: 95,  // Requests remaining in window
  limit: 100,     // Total requests allowed
  reset: 1234567890  // Timestamp when limit resets
}

{
  code: 'UNAUTHORIZED' | 'FORBIDDEN' | 'BAD_REQUEST' | 'TOO_MANY_REQUESTS' | ...,
  message: 'Human-readable error message',
  data: {
    reason: 'unauthenticated' | 'forbidden' | 'rate_limited' | ...,
    // Additional context based on error type
  }
}

interface Context {
  session: Session | null;  // Better Auth session
  clientIP: string;         // Client IP address
  requestId: string;        // Unique request identifier
  req: NextRequest;         // Next.js request object
  db: Database;             // Drizzle ORM instance
}

import type { AppRouter } from '@bounty/api';

// Use with tRPC client
const trpc = createTRPCClient<AppRouter>({
  // ... configuration
});