@ecdt/server-common

Conjunto de ferramentas e configurações comuns para servidores Express da Econodata.

O que esta biblioteca faz

@ecdt/server-common fornece um conjunto de middlewares pré-configurados para aplicações Express, eliminando a necessidade de configurar manualmente o parsing de requisições e a sanitização de tokens em cada serviço.

expressCommonMiddlewares()

Retorna um array com os seguintes middlewares já configurados, prontos para serem aplicados no Express via app.use():

| Middleware | Descrição | |---|---| | bodyParser.text() | Faz o parse de corpos de requisição como texto puro | | bodyParser.json() | Faz o parse de corpos de requisição no formato JSON | | bodyParser.urlencoded({ extended: false }) | Faz o parse de corpos no formato application/x-www-form-urlencoded | | devMktTokenSanitaze | Sanitiza o token de autenticação recebido no header Authorization ou no cookie de sessão |

Sobre o devMktTokenSanitaze

Este middleware normaliza tokens de autenticação que chegam codificados na URL (substituindo + e %2B por espaço). Ele verifica:

1. O header Authorization — se presente, sanitiza o valor diretamente.
2. O cookie da requisição — se não houver Authorization, extrai o token do cookie de sessão e o define em req.headers.authorization.

Atenção: O nome do cookie de sessão é determinado pela variável de ambiente ENV. Se ENV=hml, o cookie esperado é hml-ecdt_token_site; nos demais ambientes (beta, prd), é ecdt_token_site.

Instalação

npm install @ecdt/server-common

Uso

const express = require("express");
const { expressCommonMiddlewares } = require("@ecdt/server-common");

const app = express();

app.use(...expressCommonMiddlewares());

app.get("/health", (req, res) => {
  res.json({ status: "ok" });
});

app.listen(3000);