@ecdt/server-common 1.0.6 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -8,7 +8,7 @@ Conjunto de ferramentas e configurações comuns para servidores Express da Econ
8
8
 
9
9
  `@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.
10
10
 
11
- ### `expressCommonMiddlewares()`
11
+ ### `expressCommonMiddlewares(options?)`
12
12
 
13
13
  Retorna um array com os seguintes middlewares já configurados, prontos para serem aplicados no Express via `app.use()`:
14
14
 
@@ -26,7 +26,24 @@ Este middleware normaliza tokens de autenticação que chegam codificados na URL
26
26
  1. O header `Authorization` — se presente, sanitiza o valor diretamente.
27
27
  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`.
28
28
 
29
- > **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`.
29
+ #### Resolução do nome do cookie de sessão
30
+
31
+ Por padrão, o nome do cookie é resolvido **por requisição**, a partir da origem (`Origin` > `Referer` > `Host`):
32
+
33
+ - Origem com subdomínio `hml` (ex: `hml.econodata.com.br`, `api.hml.econodata.com.br`, `hml-site.econodata.com.br`) → cookie `hml-ecdt_token_site`
34
+ - Demais origens → cookie `ecdt_token_site`
35
+
36
+ Em ambos os casos, se o cookie preferido não existir na requisição, o outro nome é usado como fallback. A busca é por **match exato** do nome do cookie.
37
+
38
+ Também é possível fixar o nome explicitamente via `options.cookieName` (string ou array em ordem de preferência), ignorando a detecção por origem:
39
+
40
+ ```js
41
+ // Nome fixo
42
+ app.use(...expressCommonMiddlewares({ cookieName: "hml-ecdt_token_site" }));
43
+
44
+ // Múltiplos nomes, em ordem de preferência
45
+ app.use(...expressCommonMiddlewares({ cookieName: ["hml-ecdt_token_site", "ecdt_token_site"] }));
46
+ ```
30
47
 
31
48
  ### `expressCors(options)`
32
49
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ecdt/server-common",
3
- "version": "1.0.6",
3
+ "version": "1.1.0",
4
4
  "description": "Conjunto de ferramentas e configurações comuns nos servidores da Econodata",
5
5
  "main": "src/index.js",
6
6
  "scripts": {
package/src/index.d.ts CHANGED
@@ -1,11 +1,22 @@
1
1
  declare module '@ecdt/server-common' {
2
+ export interface ExpressCommonMiddlewaresOptions {
3
+ /**
4
+ * Nome(s) do cookie de sessão, em ordem de preferência.
5
+ * Quando omitido, o nome é resolvido por requisição a partir da origem (origin > referer > host):
6
+ * origens com subdomínio "hml" usam `hml-ecdt_token_site`, as demais usam `ecdt_token_site`.
7
+ */
8
+ cookieName?: string | string[];
9
+ }
10
+
2
11
  /**
3
- * Aplica bodyParser.text(), bodyParser.json(), bodyParser.urlencoded({extended: false}) e devMktTokenSanitaze()
12
+ * Aplica bodyParser.text(), bodyParser.json(), bodyParser.urlencoded({extended: false}) e devMktTokenSanitaze()
4
13
  * no middleware do express.
5
- *
14
+ *
6
15
  * Uso: app.use(...expressCommonMiddlewares())
7
16
  */
8
- export function expressCommonMiddlewares(): (req: unknown, res: unknown, next: (err?: unknown) => void) => void;
17
+ export function expressCommonMiddlewares(
18
+ options?: ExpressCommonMiddlewaresOptions
19
+ ): Array<(req: unknown, res: unknown, next: (err?: unknown) => void) => void>;
9
20
 
10
21
  export interface ExpressCorsOptions {
11
22
  /** Origins permitidas (ex: ["https://app.econodata.com.br"]). Obrigatório se econodataOrigins não for true. */
package/src/index.js CHANGED
@@ -2,8 +2,8 @@ const bodyParser = require("body-parser");
2
2
  const { devMktTokenSanitaze } = require("./services/tokenService.js");
3
3
  const { expressCors } = require("./services/corsService.js");
4
4
 
5
- function expressCommonMiddlewares(){
6
- return [bodyParser.text(), bodyParser.json(), bodyParser.urlencoded({extended: false}), devMktTokenSanitaze];
5
+ function expressCommonMiddlewares({ cookieName } = {}){
6
+ return [bodyParser.text(), bodyParser.json(), bodyParser.urlencoded({extended: false}), devMktTokenSanitaze({ cookieName })];
7
7
  }
8
8
 
9
9
 
@@ -1,29 +1,65 @@
1
- const COOKIESITENAME = `${process.env.ENV == 'hml' ? 'hml-' : ''}ecdt_token_site`
2
-
3
- function devMktTokenSanitaze(req, res, next) {
4
- if(req?.headers == null) return next();
5
-
6
- if (req.headers.authorization) {
7
- req.headers.authorization = req.headers.authorization
8
- .replace("+", " ")
9
- .replace("%2B", " ");
10
- } else if (req.headers.cookie) {
11
- req.headers.authorization = `${getCookieSite(
12
- req.headers.cookie
13
- )}`;
14
- }
1
+ const SITE_COOKIE_NAME = "ecdt_token_site";
2
+ const HML_SITE_COOKIE_NAME = `hml-${SITE_COOKIE_NAME}`;
15
3
 
16
- return next();
17
- }
4
+ /**
5
+ * @param {object} [options]
6
+ * @param {string|string[]} [options.cookieName] - Nome(s) do cookie de sessão, em ordem de preferência.
7
+ * Quando omitido, o nome é resolvido por requisição a partir da origem (origin > referer > host):
8
+ * origens com subdomínio "hml" usam o cookie de hml, as demais usam o de produção.
9
+ * @returns middleware do express
10
+ */
11
+ function devMktTokenSanitaze({ cookieName } = {}) {
12
+ const fixedCookieNames = cookieName
13
+ ? (Array.isArray(cookieName) ? cookieName : [cookieName])
14
+ : null;
15
+
16
+ return function devMktTokenSanitazeMiddleware(req, _res, next) {
17
+ if (req?.headers == null) return next();
18
18
 
19
- function getCookieSite(cookie){
20
- let cookies = cookie.split(';');
21
- for (let index = 0; index < cookies.length; index++) {
22
- if(cookies[index].includes(COOKIESITENAME)){
23
- return cookies[index].split('=')[1].replace('+',' ').replace('%2B',' ')
19
+ if (req.headers.authorization) {
20
+ req.headers.authorization = req.headers.authorization
21
+ .replace("+", " ")
22
+ .replace("%2B", " ");
23
+ } else if (req.headers.cookie) {
24
+ const cookieNames = fixedCookieNames ?? resolveCookieNamesByRequest(req);
25
+ req.headers.authorization = getCookieValue(req.headers.cookie, cookieNames);
24
26
  }
27
+
28
+ return next();
29
+ };
30
+ }
31
+
32
+ function resolveCookieNamesByRequest(req) {
33
+ // O nome alternativo fica como fallback para o caso do cookie preferido não existir
34
+ return isHmlRequest(req)
35
+ ? [HML_SITE_COOKIE_NAME, SITE_COOKIE_NAME]
36
+ : [SITE_COOKIE_NAME, HML_SITE_COOKIE_NAME];
37
+ }
38
+
39
+ function isHmlRequest(req) {
40
+ const source = req.headers.origin ?? req.headers.referer ?? req.headers.host ?? "";
41
+ const hostname = String(source).replace(/^[a-z]+:\/\//i, "").split(/[/:?#]/)[0];
42
+ // "hml" como parte do hostname delimitado por ponto ou hífen
43
+ // (ex: hml.econodata.com.br, api.hml.econodata.com.br, hml-site.econodata.com.br)
44
+ return /(^|[.-])hml([.-]|$)/i.test(hostname);
45
+ }
46
+
47
+ function getCookieValue(cookieHeader, cookieNames) {
48
+ const cookies = cookieHeader.split(";").map((entry) => {
49
+ const separatorIndex = entry.indexOf("=");
50
+ if (separatorIndex === -1) return { name: entry.trim(), value: "" };
51
+ return {
52
+ name: entry.slice(0, separatorIndex).trim(),
53
+ value: entry.slice(separatorIndex + 1).trim(),
54
+ };
55
+ });
56
+
57
+ for (const name of cookieNames) {
58
+ const found = cookies.find((c) => c.name === name);
59
+ if (found) return found.value.replace("+", " ").replace("%2B", " ");
25
60
  }
26
- return '';
61
+
62
+ return "";
27
63
  }
28
64
 
29
- module.exports = {devMktTokenSanitaze}
65
+ module.exports = { devMktTokenSanitaze, SITE_COOKIE_NAME, HML_SITE_COOKIE_NAME };