algolia-sdk-patterns

# Algolia SDK Patterns ## Overview Production-ready patterns for `algoliasearch` v5. Key architectural change from v4: all methods live on the client directly — no more `client.initIndex()`. Index name is passed as a parameter to every call. ## Prerequisites - `algoliasearch` v5+ installed - Completed `algolia-install-auth` setup - TypeScript project (patterns work in JS too, you just lose type safety) ## Instructions ### Pattern 1: Typed Singleton Client ```typescript // src/algolia/client.ts import { algoliasearch, type Algoliasearch } from 'algoliasearch'; let _client: Algoliasearch | null = null; export function getClient(): Algoliasearch { if (!_client) { const appId = process.env.ALGOLIA_APP_ID; const apiKey = process.env.ALGOLIA_ADMIN_KEY; if (!appId || !apiKey) { throw new Error( 'ALGOLIA_APP_ID and ALGOLIA_ADMIN_KEY must be set. ' + 'Get them from dashboard.algolia.com > Settings > API Keys' ); } _client = algoliasearch(appId, apiKey); } return _client; } // For testing: reset singleton export function resetClient(): void { _client = null; } ``` ### Pattern 2: Typed Search Results ```typescript // src/algolia/types.ts // Define your record shape — extends Algolia's Hit type interface Product { objectID: string; name: string; category: string; price: number; description: string; image_url: string; } // src/algolia/search.ts import { getClient } from './client'; export async function sea...