npm.io
4.5.0 • Published yesterday

@tc-libs/error-handler

Licence
Version
4.5.0
Deps
10
Size
23 kB
Vulns
0
Weekly
0

@tc-libs/error-handler

Gestione centralizzata degli errori HTTP del monorepo.

Il package registra globalmente:

  • ErrorHttpFilter come APP_FILTER
  • ErrorMetaGuard come APP_GUARD

Registrazione

ErrorHandlerModule.register(
  {
    availableLanguages: ['it', 'en'],
    versioning: {
      version: '1',
    },
    repoVersion: '1.0.0',
  },
  true,
);

Cosa fa ErrorHttpFilter

  • intercetta eccezioni ApiError e fallback generici
  • legge dati request da @tc-libs/request
  • traduce validation/import errors tramite @tc-libs/message
  • costruisce _metadata coerente con @tc-libs/response
  • logga tramite @tc-libs/debugger quando necessario

Il body finale contiene tipicamente:

  • message
  • data
  • errors
  • _error
  • _metadata

Decorator ErrorMeta

Permette di forzare nome classe/funzione mostrati nei log:

@ErrorMeta('UserController', 'create')
@Post()
create() {}

Se non lo usi, ErrorMetaGuard deduce classe e metodo dal contesto Nest.

Quando usarlo

Usa questo package se vuoi che tutte le API del progetto restituiscano errori nello stesso formato, con metadata e logging uniformi.

Sviluppo

nx build error-handler
nx test error-handler