Readme

Este pack exporta alguns utilitários e middlewares para projetos de web api que utilizam express e simple-node-framework (não existe dependencia direta)

Middlewares

Existem 2 hooks exportados neste modulo ag-pack-backend-utils/middlewares/hooks.js

• useBeforeRoutes: deve ser executado antes das importações de rotas
• useAfterRoutes: deve ser executado após as inmportações de rotas

Esses hooks irão configurar os seguintes middlewares:

• setLogger: insere no request um instancia do logger utilizado pela aplicação, nesse exemplo abaixo estamos utilizando o logger do simple-node-framework
• setRequestId: insere o requestId no request
• setAuthorization: faz o parse das informações de autorização
• setApplicationVersion: insere no response um header com a versão da aplicação
• setContentBody: armazena o body num atributo contentBody que será utilizado pelo logResponse
• logRequest: executa o log do request
• errorHandler: captura e trata os erros da aplicação
• logResponse: executa o log do response

Ex:

1
2import express from 'express'
3import snf from 'simple-node-framework'
4import { useBeforeRoutes, useAfterRoutes } from 'ag-pack-backend-utils/middlewares/hooks.js'
5
6import sampleRouter from './api/modules/sample/router'
7
8
9const app = express()
10const { config, log } = snf.Singleton
11
12// call before import routers
13useBeforeRoutes(app, config, log)
14
15// import routes here
16app.use(sampleRouter)
17
18// call after import routers
19useAfterRoutes(app, config)
20

Middleware Settings

Settings:

• errorHandler.ignoreDetail: não adiciona os detalhes internos do erro no response
• log.requestResponse.ignore: ignora log de request/response para as rotas configuradas
• log.requestResponse.ignoreBody: não adiciona o body no log de response

1errorHandler:
2  ignoreDetail: true
3log:
4  requestResponse:
5    ignore:
6      - /api/v1/sample/ignored-route
7    ignoreBody:
8      - /api/v1/sample/ignored-body
9
10# config.yaml

Custom Errors

• ApplicationError
• ClientError
• NotFoundError

ApplicationError

Define um erro de aplicação na faixa de 5xx, define alguns padrões

• name: ApplicationError
• isCustomError: true
• message: Sorry, an unexpected error occurred
• status: 500
• code: APPLICATION_ERROR

ClientError

Define um erro gerado pelo usuário extende ApplicationError, geralmente um erro de validação na faixa de 4xx

• name: ClientError
• status: 400
• code: CLIENT_ERROR
• message: Invalid request, check the data and try again

NotFoundError

Define um erro para objeto não encontrado, extende ClientError

• name: NotFoundError
• status: 404
• message: This resource is not found

Utils

Divididos em dois grupos errors e request, são utilizados internamente pelos os middlewares

Errors

• getDetailFromError: monta um objeto detalhado sobre um erro, especialmente para erros do Axios

1// AxiosError
2{
3  name: 'AxiosError',
4  origin: 'https://example.com',
5  endpoint: '[POST] /api/v1/sample',
6  message: 'ORA-08103 Object no longer exists',
7  status: 500,
8  response: {
9    code: 'INTERNAL_SERVER_ERROR',
10    message: 'ORA-08103 Object no longer exists'
11  }
12}
13// Error
14{
15  name: 'Error',
16  stack: 'Error stack...',
17  message: 'cannot access id from undefined object'
18}

• isServerTimeout: verifica se o erro foi um erro 502/504

Request

• getRequestId: recupera o request id ou cria, ele tenta recuperar o requestId apartir dos headers x-request-id, request-id ou request_id caso não seja informado ele cria um id e atribui a req.id
• getRequestIp:: recupera o ip do cliente através do request
• getTraceFields: recupera algumas informações de trace apartir do request

1{
2  requestId: '8f9e5100-bc19-423c-824e-b7ae77146bf6',
3  requestPath: '/api/v1/sample'
4  sessionId: 'db3dff03-5df5-437b-8bcb-e7bb113bfaaa'
5  origin: {
6    ip: '127.0.0.1',
7    application: 'application name',
8    channel: 'application channel name',
9    user: 'username',
10    referrer: 'origin of request'
11  }
12}