@ecdt/server-common 1.6.0 → 1.6.1

package/README.md

@@ -176,14 +176,19 @@ publicarEvento({
 |---|---|---|
 | `tipo` | — | Nome do evento, em `snake_case` |
 | `autorizacao` | — | Header `Authorization` da requisição que originou o evento |
+| `idVisitante` | — | Identificador anônimo, para quando não há token |
 | `payload` | `{}` | Campos do evento |
 | `url` | `process.env.MOTOR_EVENTOS_URL` | URL completa do coletor; a função não monta caminho nenhum |
 | `timeoutMs` | `2000` | Aborta a requisição |
 | `aoFalhar` | `console.error` | Recebe a mensagem quando a publicação não acontece |
 
-A identidade sai do token, nunca do corpo: o coletor resolve o usuário a partir do `Authorization`
-repassado. Sem `tipo` ou sem `autorizacao` a função não faz nada; sem `url` ela ainda registra um
-`console.warn`, porque url ausente é configuração faltando e não um evento que não se aplica.
+A identidade do usuário sai do token, nunca do corpo: o coletor a resolve a partir do `Authorization`
+repassado. Quando não há token — rota pública, visitante anônimo — vale o `idVisitante`, que vai no
+corpo como `id_visitante`. Ele não é identidade autenticada, é um identificador de correlação: forjá-lo
+não atribui nada à conta de ninguém, e por isso pode vir do corpo da requisição. Basta um dos dois.
+
+Sem `tipo`, ou sem nenhum dos dois identificadores, a função não faz nada; sem `url` ela ainda registra
+um `console.warn`, porque url ausente é configuração faltando e não um evento que não se aplica.
 
 **A função nunca lança e nunca devolve promise.** O evento é secundário ao fluxo que o gerou —
 falha de publicação não pode virar erro de quem chamou, e o retorno `undefined` impede que alguém

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ecdt/server-common",
-  "version": "1.6.0",
+  "version": "1.6.1",
   "description": "Conjunto de ferramentas e configurações comuns nos servidores da Econodata",
   "main": "src/index.js",
   "types": "src/index.d.ts",

package/src/index.d.ts

@@ -138,7 +138,8 @@ export declare function renderMetrics(
 
 export interface PublicarEventoOptions {
   tipo: string;
-  autorizacao: string;
+  autorizacao?: string;
+  idVisitante?: string;
   payload?: Record<string, unknown>;
   url?: string;
   timeoutMs?: number;

package/src/services/motorEventosService.js

@@ -11,9 +11,14 @@ function urlConfigurada(url) {
     return configurada.trim();
 }
 
+function textoNaoVazio(valor) {
+    return typeof valor === "string" && valor.trim() !== "" ? valor.trim() : null;
+}
+
 function publicarEvento({
     tipo,
     autorizacao,
+    idVisitante,
     payload,
     url,
     timeoutMs = TIMEOUT_PADRAO_MS,
@@ -21,19 +26,30 @@ function publicarEvento({
 } = {}) {
     try {
         const destino = urlConfigurada(url);
+        const visitante = textoNaoVazio(idVisitante);
 
-        if (!destino || !tipo || !autorizacao) {
+        if (!destino || !tipo || (!autorizacao && !visitante)) {
             return;
         }
 
+        const cabecalhos = { "Content-Type": "application/json" };
+        if (autorizacao) {
+            cabecalhos.Authorization = autorizacao;
+        }
+
+        const corpo = {
+            tipo,
+            dt_evento: new Date().toISOString(),
+            payload: payload ?? {},
+        };
+        if (visitante) {
+            corpo.id_visitante = visitante;
+        }
+
         fetch(destino, {
             method: "POST",
-            headers: { "Content-Type": "application/json", Authorization: autorizacao },
-            body: JSON.stringify({
-                tipo,
-                dt_evento: new Date().toISOString(),
-                payload: payload ?? {},
-            }),
+            headers: cabecalhos,
+            body: JSON.stringify(corpo),
             signal: AbortSignal.timeout(timeoutMs),
         })
             .then((resposta) => {

package/test/motorEventosService.test.js

@@ -101,9 +101,10 @@ describe('publicarEvento', () => {
         assert.equal(avisos.length, 2);
     });
 
-    test('nao publica sem tipo ou sem autorizacao', async () => {
+    test('nao publica sem tipo, nem sem identidade nenhuma', async () => {
         publicarEvento({ autorizacao: 'Bearer jwt', url: URL, aoFalhar });
         publicarEvento({ tipo: 'meu_evento', url: URL, aoFalhar });
+        publicarEvento({ tipo: 'meu_evento', url: URL, idVisitante: '   ', aoFalhar });
         await esperarMicrotasks();
 
         assert.equal(chamadas.length, 0);
@@ -111,6 +112,36 @@ describe('publicarEvento', () => {
         assert.deepEqual(avisos, []);
     });
 
+    test('publica so com idVisitante, sem header de autorizacao', async () => {
+        publicarEvento({ tipo: 'meu_evento', idVisitante: 'visitante-1', url: URL, aoFalhar });
+        await esperarMicrotasks();
+
+        assert.equal(chamadas.length, 1);
+        assert.equal(chamadas[0].opcoes.headers.Authorization, undefined);
+        assert.equal(JSON.parse(chamadas[0].opcoes.body).id_visitante, 'visitante-1');
+    });
+
+    test('manda os dois quando tem token e visitante', async () => {
+        publicarEvento({
+            tipo: 'meu_evento',
+            autorizacao: 'Bearer jwt',
+            idVisitante: 'visitante-1',
+            url: URL,
+            aoFalhar,
+        });
+        await esperarMicrotasks();
+
+        assert.equal(chamadas[0].opcoes.headers.Authorization, 'Bearer jwt');
+        assert.equal(JSON.parse(chamadas[0].opcoes.body).id_visitante, 'visitante-1');
+    });
+
+    test('omite id_visitante do corpo quando nao ha visitante', async () => {
+        publicarEvento({ tipo: 'meu_evento', autorizacao: 'Bearer jwt', url: URL, aoFalhar });
+        await esperarMicrotasks();
+
+        assert.ok(!('id_visitante' in JSON.parse(chamadas[0].opcoes.body)));
+    });
+
     test('nao quebra quando chamado sem argumento nenhum', () => {
         delete process.env.MOTOR_EVENTOS_URL;