@tc-libs/errors

@tc-libs/errors

Catalogo di errori custom del monorepo.

Il package contiene:

• errori HTTP derivati da ApiError
• errori applicativi puri (AppError)
• errori di connessione/database/queue
• interfacce di supporto

Struttura

Le cartelle api/400, api/401, api/403, ecc. espongono classi gia pronte per gli status code piu comuni.

Esempi di uso reale nel monorepo:

• Api422ValidationError
• Api401JWTAccessTokenUnauthorizedError
• Api403AccessForError
• Api404EntityNotFoundError
• Api415UnsupportedMediaTypeError
• Api408RequestTimeoutError

Base class

ApiError

Estende HttpException e aggiunge:

• type
• description
• data
• hasToLogConsole

Esempio:

throw new Api404EntityNotFoundError({ entity: 'User' });

AppError

Errore applicativo non HTTP, utile nel bootstrap o in flussi interni:

throw new AppMissingPortError();

Quando usarlo

Usa questo package quando vuoi:

• lanciare errori HTTP coerenti con il formato atteso da @tc-libs/error-handler
• evitare throw new HttpException(...) sparsi nel codice
• standardizzare i message path usati da @tc-libs/message

Note operative

• Gli handler e filtri del monorepo si aspettano eccezioni derivate da ApiError per arricchire la risposta.
• Le classi sono numerose: conviene importare solo gli errori che ti servono.

Sviluppo

nx build errors
nx test errors