traceflow.core.ts

import type { INestApplication } from '@nestjs/common';
import { createTraceFlowHttpMiddleware, startTraceFlow } from 'traceflow';

export function initializeTraceFlow(): void {
  startTraceFlow({
    serviceName: process.env.TRACEFLOW_SERVICE_NAME || 'nombre-backend',
    studioUrl: process.env.TRACEFLOW_STUDIO_URL || 'http://127.0.0.1:4789',
    enabled: process.env.TRACEFLOW_ENABLED?.toLowerCase() === 'true' && process.env.PROD !== 'true',
    instrumentHttp: process.env.TRACEFLOW_INSTRUMENT_HTTP?.toLowerCase() === 'true',
    debug: process.env.TRACEFLOW_DEBUG?.toLowerCase() === 'true',
  });
}

export function setupTraceFlow(app: INestApplication): void {
  // TraceFlow se utiliza únicamente en el entorno local de desarrollo.
  if (process.env.PROD === 'true' || process.env.TRACEFLOW_ENABLED?.toLowerCase() !== 'true') {
    return;
  }

  app.use(
    createTraceFlowHttpMiddleware({
      capture: {
        query: true,
        body: true,
        formData: true,
        cookies: true,
        authorization: 'full',
        headers: true,
      },
    }),
  );
}

cd /ruta/absoluta/traceflow
npm run dev

cd /ruta/absoluta/mi-proyecto
npm link traceflow traceflow-kit