@hemia/app-context

@hemia/app-context

Middleware y utilidades para gestionar un contexto centralizado en aplicaciones backend de Node.js/Express. Proporciona trazabilidad, metadatos del entorno, datos del usuario, headers relevantes y stack trace de errores.

Instalación

npm install @hemia/app-context

Características principales

• Generación automática de traceId, spanId y stackTrace
• Trazabilidad de entrada y salida (input/output)
• Datos enriquecidos del entorno, aplicación, memoria, host y dispositivo
• Middleware para Express listo para usar
• Permite adjuntar metadatos personalizados y etiquetas (tags)

Uso básico

Integrar el middleware

import express from 'express';
import { appContextMiddleware } from '@hemia/app-context';

const app = express();

app.use(
  appContextMiddleware('Inicio', 'FN001', (context, res) => {
    console.log('Traza finalizada:', context);
  })
);

app.get('/', (req, res) => {
  res.json({ message: 'Hola mundo' });
});

Capturar errores en contexto

import { updateContextStackTrace } from '@hemia/app-context';

try {
  // lógica del sistema
} catch (error) {
  updateContextStackTrace(context, 'Login', error, 'ERR001');
}

Interfaces disponibles

IAppContext

Representa toda la información de trazabilidad, usuario, entorno, etc. Disponible dentro del contexto async del request.

Headers utilizados / generados

• x-trace-id: ID único del request
• x-span-id: ID del proceso actual

Requisitos

• Node.js >= 14
• Express

Licencia

MIT

Autor

Hemia Technologies