@tc-libs/response

Layer di risposta HTTP uniforme per il monorepo.

Fornisce:

• ResponseModule
• decorator Response() e ResponsePaging()
• interceptor per wrapping standard delle risposte
• serializzazioni Swagger-friendly

Come si usa

Risposta standard

@Get(':id')
@Response('user.get', {
  serialization: UserGetSerialization,
})
async getOne() {
  return {
    data: user,
  };
}

Risposta paginata

@Get()
@ResponsePaging('user.list', {
  serialization: UserListSerialization,
})
async list() {
  return {
    _pagination: { total: 100, totalPages: 5 },
    data: rows,
  };
}

Cosa fanno gli interceptor

ResponseDefaultInterceptor e ResponsePagingInterceptor:

• leggono messagePath e serializzazione dai metadata del decorator
• serializzano data con plainToInstance
• costruiscono _metadata con request id, version, timezone, lingue, repoVersion
• nel caso paginato aggiungono metadata pagination e link cursor
• risolvono il messaggio tramite MessageService

Shape attesa del return

Standard:

{ data }

Paginato:

{
  _pagination: { total, totalPages },
  data
}

E' supportato anche _metadata.customProperty per override di statusCode, message e messageProperties.

Export utili

• Response
• ResponsePaging
• ResponseSerializationOptions
• ResponseDefaultSerialization
• ResponsePagingSerialization

Sviluppo

nx build response
nx test response