perplexity-sdk-patterns

# Perplexity SDK Patterns ## Overview Production-ready patterns for Perplexity Sonar API. Since Perplexity uses the OpenAI wire format, you build wrappers around the `openai` client library with Perplexity-specific response handling (citations, search results, related questions). ## Prerequisites - `openai` package installed (`npm install openai` or `pip install openai`) - API key configured in `PERPLEXITY_API_KEY` - Understanding of OpenAI chat completions format ## Instructions ### Step 1: Typed Client Singleton (TypeScript) ```typescript // src/perplexity/client.ts import OpenAI from "openai"; export interface PerplexityChatCompletion extends OpenAI.ChatCompletion { citations?: string[]; search_results?: Array<{ title: string; url: string; date?: string; snippet: string; }>; related_questions?: string[]; } export interface PerplexityUsage extends OpenAI.CompletionUsage { citation_tokens?: number; num_search_queries?: number; reasoning_tokens?: number; } let instance: OpenAI | null = null; export function getClient(): OpenAI { if (!instance) { if (!process.env.PERPLEXITY_API_KEY) { throw new Error("PERPLEXITY_API_KEY not set"); } instance = new OpenAI({ apiKey: process.env.PERPLEXITY_API_KEY, baseURL: "https://api.perplexity.ai", }); } return instance; } ``` ### Step 2: Search with Full Response Parsing ```typescript // src/perplexity/search.ts import { getClient, PerplexityChatCompletion } from ...