eduardweb.
TypeScript avansatAvansat#typescript#type-safety#backend#arhitectura-software

Permisiuni type-safe în TypeScript folosind Template Literal Types

De Gabriela Neagu, 18 oct. 2026 · 33 vizualizări · 3 like-uri

Postat 18 oct. 2026
typescript
type Scope = 'api' | 'admin';
type Resource = 'users' | 'invoices' | 'teams';
type Action = 'read' | 'write' | 'delete';

// Generare automată: 'api:users:read' | 'admin:invoices:delete' etc.
export type Permission = `${Scope}:${Resource}:${Action}`;

// Extragere de componente cu pattern matching
type SplitPermission<T extends Permission> = 
  T extends `${infer S}:${infer R}:${infer A}`
    ? { scope: S; resource: R; action: A }
    : never;

function checkAccess(perm: Permission): void {
  // Type safe la apel
}

// Valid:
checkAccess('api:users:read');

// Eroare TS2345: Argument of type '"api:user:read"' is not assignable...
// checkAccess('api:user:read');

Am bușit de două ori permisiunile în producție din cauza unui amărât de typo: am scris billing:invoice:read în loc de billing:invoices:read. Codul a trecut de PR, linterul n-a zis nimic, iar utilizatorul cu rol de contabil s-a trezit cu un frumos 403 în dashboard. Dacă lucrezi la un SaaS B2B cu zeci de entități, permisiunile sub formă de string-uri libere sunt o bombă cu ceas.

În TypeScript 4.1 au apărut template literal types. De atunci le folosesc cam peste tot unde am convenții stricte de denumire, de la routing intern până la chei de event-uri și sisteme de acces.

Cum legăm bucățile fără enums kilometrice

Abordarea naivă e să declari un enum gigant sau un obiect înghețat cu as const. Problema apare când ai 15 resurse și 5 acțiuni posibile: ajungi la 75 de linii scrise de mână, imposibil de menținut fără să uiți ceva pe drum. Dacă mai adaugi și scope-uri (de exemplu api vs dashboard), munca manuală devine absurdă.

Prin template literals, TypeScript generează uniunea automată prin produs cartezian. Definim resursele de bază, definim acțiunile permise și lăsăm compilatorul să construiască toate combinațiile valide. În momentul în care chemi o funcție de verificare precum hasPermission(user, 'api:users:delete'), ai autocomplete complet în IDE. Dacă ai pus din greșeală un plural greșit, primești eroare instant, înainte de orice test unitar.

Parsarea și extragerea de metadate

Frumusețea nu se oprește la validare. Putem folosi cuvântul cheie infer ca să spargem string-ul înapoi în componente. La un proiect cu 14 microservicii și vreo 60 de rute protejate, am avut nevoie să extragem automat resursa dintr-un header HTTP pentru logging și audit.

Construiești un type helper ParsePermission<T> care extrage resursa și acțiunea direct din string. Asta înseamnă zero regex-uri la nivel de tipuri și zero duplicare între runtime și type system.

Trade-off: Capcana combinatorică din spatele compilatorului

Sună excelent, dar există o problemă gravă dacă exagerezi: TypeScript rezolvă aceste tipuri expandându-le într-o uniune completă în memorie.

Merge perfect când ai 3 scope-uri, 10 resurse și 4 acțiuni (adică 120 de combinații posibile). Dar la un moment dat am încercat să adaug ID-uri dinamice și statusuri în același literal: tenant:${TenantId}:${Resource}:${Action}:${Status}. Rezultatul? Peste 40.000 de variante generate. IDE-ul a început să agațe cu lag de 4 secunde la fiecare apăsare de tastă, iar tsc --noEmit a crăpat elegant cu Type instantiation is excessively deep and possibly infinite.

Regula mea de aur: folosește template literals doar pentru categorii finite, cu cardinalitate mică. Dacă ai nevoie de parametri dinamici (UUID-uri, ID-uri numerice), lasă-i ca argumente separate în funcție, nu-i îndesa în string-ul de permisiune.

Voi cum gestionați permisiunile granulare în TypeScript: mergeți pe string-uri validate la compilare sau lăsați totul pe seama unui layer CASL / schema validation la runtime?

Răspunsuri 0

Se încarcă răspunsurile…

Loghează-te pentru a răspunde

Doar membrii comunității pot lăsa comentarii.