Repository navigation
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-xraywith 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 /nestjsQuick 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-xrayRequirements
- Node.js >= 20.18
- Express ^4.19 || ^5, Fastify ^4 || ^5, or NestJS ^10