@ecdt/server-common 1.0.0 → 1.0.1

package/README.md

@@ -0,0 +1,58 @@
+# @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
+
+```bash
+npm install @ecdt/server-common
+```
+
+---
+
+## Uso
+
+```js
+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);
+```
+
+---

package/package.json

@@ -1,11 +1,14 @@
 {
   "name": "@ecdt/server-common",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Conjunto de ferramentas e configurações comuns nos servidores da Econodata",
   "main": "src/index.js",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"
   },
   "author": "",
-  "license": "ISC"
+  "license": "ISC",
+  "dependencies": {
+    "body-parser": "^2.2.2"
+  }
 }

package/src/index.d.ts

@@ -0,0 +1,9 @@
+declare module '@ecdt/server-common' {
+    /**
+     * Aplica bodyParser.text(), bodyParser.json(), bodyParser.urlencoded({extended: false}) e devMktTokenSanitaze()
+     * no middleware do express.
+     * 
+     * Uso: app.use(...expressCommonMiddlewares())
+     */
+    export function expressCommonMiddlewares(): (req: unknown, res: unknown, next: (err?: unknown) => void) => void;
+}

package/src/index.js

@@ -0,0 +1,11 @@
+const bodyParser = require("body-parser");
+const { devMktTokenSanitaze } = require("./services/tokenService.js");
+
+function expressCommonMiddlewares(){
+    return [bodyParser.text(), bodyParser.json(), bodyParser.urlencoded({extended: false}), devMktTokenSanitaze];
+}
+
+
+
+
+module.exports = { expressCommonMiddlewares }

package/src/services/tokenService.js

@@ -0,0 +1,29 @@
+const COOKIESITENAME = `${process.env.ENV == 'hml' ? 'hml-' : ''}ecdt_token_site`
+
+function devMktTokenSanitaze(req, res, next) {
+    if(req?.headers == null) return next();
+
+    if (req.headers.authorization) {
+        req.headers.authorization = req.headers.authorization
+        .replace("+", " ")
+        .replace("%2B", " ");
+    } else if (req.headers.cookie) {
+        req.headers.authorization = `${getCookieSite(
+            req.headers.cookie
+        )}`;
+    }
+
+    return next();
+}
+
+function getCookieSite(cookie){ 
+    let cookies = cookie.split(';');
+    for (let index = 0; index < cookies.length; index++) {
+        if(cookies[index].includes(COOKIESITENAME)){
+            return cookies[index].split('=')[1].replace('+',' ').replace('%2B',' ')
+        }
+    }
+    return '';
+}
+
+module.exports = {devMktTokenSanitaze}