TypeScript: tipi end-to-end per software che non si rompe

Perché tutto il nostro codice è tipizzato

TypeScript non è una tecnologia che si vende al cliente: è una disciplina interna che il cliente percepisce solo come minor numero di problemi. Dichiarare la forma dei dati significa che l'errore banale — un campo rinominato, un valore che può essere assente, una funzione chiamata con i parametri invertiti — viene segnalato mentre si scrive, non dall'utente al telefono.

È una scelta che si paga in fretta. Su un gestionale con centinaia di campi e decine di stati possibili, la differenza tra codice tipizzato e non tipizzato è la differenza tra poter cambiare qualcosa e avere paura di toccarlo.

Contratti condivisi tra frontend e backend

Il punto in cui le applicazioni si rompono più spesso è il confine tra client e server: il backend cambia un campo, il frontend non lo sa, e il bug si manifesta su una schermata secondaria settimane dopo. Con TypeScript su entrambi i lati definiamo le strutture una volta e le condividiamo, così quel disallineamento diventa un errore di compilazione.

Quando il database è PostgreSQL o Supabase generiamo i tipi direttamente dallo schema: la tabella è la fonte di verità e ogni modifica si propaga fino all'interfaccia. Aggiungere una colonna non obbligatoria e dimenticarsene diventa tecnicamente impossibile.

Stati impossibili resi impossibili

La parte più utile del sistema di tipi è quella che permette di modellare i domini reali con precisione. Un intervento tecnico non ha genericamente una data di chiusura e un motivo di annullamento: o è chiuso e ha un esito, o è annullato e ha una motivazione. Le union discriminate permettono di dichiararlo, e il compilatore obbliga a gestire ogni caso.

Il risultato è che intere categorie di bug — lo stato incoerente, il campo valorizzato quando non dovrebbe esserlo — non arrivano mai al collaudo perché non sono rappresentabili.

Domande frequenti su TypeScript

TypeScript rallenta lo sviluppo?

All'inizio di poco, poi accelera. Il tempo speso a dichiarare i tipi viene restituito con gli interessi in fase di modifica e di ricerca dei problemi, che su un software di lunga vita è dove si concentra la maggior parte del lavoro.

Si può introdurre TypeScript in un progetto JavaScript esistente?

Sì, gradualmente: convive con JavaScript nello stesso repository e si può procedere file per file, partendo dalle parti più critiche. Non serve un blocco dello sviluppo per fare la conversione.

TypeScript serve anche lato backend?

Soprattutto lato backend. È lì che vivono le regole di business e le operazioni che toccano i dati: avere garanzie sulla forma di ciò che si sta scrivendo nel database vale più che averle su un componente grafico.