Skip to content

v1.0.0

Latest

Choose a tag to compare

@bapibiswas703 bapibiswas703 released this 04 Aug 15:27
· 3 commits to main since this release

node-xray v1.0.0

First stable release of the @node-xray package family — a live runtime inspector for Node.js backends.

Packages

Package Version
@node-xray/types 1.0.0
@node-xray/core 1.0.0
@node-xray/dashboard 1.0.0
@node-xray/express 1.0.0
@node-xray/fastify 1.0.0
@node-xray/nestjs 1.0.0

Features

  • One-line integration for Express, Fastify, and NestJS
  • Request/response body capture with automatic redaction of sensitive fields (passwords, tokens, cookies)
  • Per-request call stacks — sanitized, sampled at configurable rate
  • Event-loop health — real-time lag (p50/p99/max), utilization sampling
  • Live WebSocket dashboard at /node-xray with real-time stats bar
  • AsyncLocalStorage context — correlates all async ops within a single request
  • Bounded memory — in-memory ring buffer with configurable size (default 200 requests)
  • Configurable auth — basic, bearer, or custom auth for non-dev environments
  • Production safety — refuses to mount without auth in production

Install

npm install --save-dev @node-xray/express   # or /fastify or /nestjs

Quick start

const express = require('express');
const { xray } = require('@node-xray/express');

const app = express();
app.use(xray());
app.listen(3000);
// Dashboard: http://localhost:3000/node-xray

Requirements

  • Node.js >= 20.18
  • Express ^4.19 || ^5, Fastify ^4 || ^5, or NestJS ^10