glean-sdk-patterns

# Glean SDK Patterns ## Overview Production-ready patterns for the Glean enterprise search platform. Glean uses POST-based REST endpoints for both search and indexing. Search queries go to the Client API while document ingestion uses the Indexing API. A structured client centralizes token management, enforces batch pagination for bulk indexing, and provides typed responses for search results. ## Singleton Client ```typescript let _client: GleanClient | null = null; export function getClient(): GleanClient { if (!_client) { const domain = process.env.GLEAN_DOMAIN, key = process.env.GLEAN_API_KEY; if (!domain || !key) throw new Error('GLEAN_DOMAIN and GLEAN_API_KEY must be set'); _client = new GleanClient(domain, key); } return _client; } class GleanClient { private base: string; private h: Record<string, string>; constructor(domain: string, key: string) { this.base = `https://${domain}/api`; this.h = { 'Authorization': `Bearer ${key}`, 'Content-Type': 'application/json' }; } async search(query: string, opts: { pageSize?: number; datasource?: string } = {}) { const r = await fetch(`${this.base}/client/v1/search`, { method: 'POST', headers: { ...this.h, 'X-Glean-Auth-Type': 'BEARER' }, body: JSON.stringify({ query, pageSize: opts.pageSize ?? 20, requestOptions: opts.datasource ? { datasourceFilter: opts.datasource } : undefined }) }); if (!r.ok) throw new GleanError(r.status, await r.text()); return r.json() as Prom...