SDK TypeScript per consumer di API AI: streaming SSE, error recovery, cost tracking lato client
Un'applicazione AI consumer-facing richiede un SDK TypeScript robusto lato client: streaming SSE che gestisce reconnect su disconnessione rete, error recovery discriminando errori transitori da permanenti, cost tracking per mostrare il consumo utente, tipizzazione forte sugli output strutturati del backend. Ti mostro l'architettura dell'SDK che ho costruito come libreria interna: API pulita, zero dipendenze browser, supporto React/Vue/vanilla, pattern di ripresa sessione dopo navigazione. Continua a leggere
Ultima modifica:
Le chat AI moderne richiedono streaming token-per-token a latenza sub-secondo. PHP non è lo strumento giusto per questo: Node.js lo è. Ti mostro l'architettura ibrida che ho implementato: Laravel gestisce sessione e business logic, un servizio Node/TypeScript standalone gestisce lo streaming via SSE verso il browser. Con gestione di backpressure, reconnect, cost tracking e integrazione con Claude API. 
Dopo aver migrato tre applicazioni enterprise da Vue 2 Options API a Vue 3 Composition API + TypeScript, ho catalogato i pattern che funzionano in produzione e quelli che sembrano buoni online ma si rivelano problematici a scala. Vi mostro le strutture di composable, store Pinia e i tipi per le API Laravel. 
Un'applicazione che aggregava dati da cinque API legacy diverse aveva un frontend che faceva 40 richieste HTTP per caricare una dashboard. Ho introdotto un BFF Node.js che aggrega, trasforma e cache le risposte: la dashboard si carica con una sola richiesta, il backend PHP non è stato toccato. 
Ho iniziato a scrivere TypeScript seriamente due anni fa dopo vent'anni di PHP. La curva di apprendimento è stata più breve di quanto pensassi, ma i punti di attrito erano diversi da quelli che mi aspettavo. Vi racconto il percorso con le analogie che mi hanno aiutato e gli errori che ho fatto all'inizio.