Node.js SDK

npm install @debugbundle/sdk-node

import DebugBundle from '@debugbundle/sdk-node';

DebugBundle.init({
  projectToken: 'local',       // 'local' for local-only, or your project token
  environment: 'production',
  service: 'my-api',
});

import DebugBundle from '@debugbundle/sdk-node';
import express from 'express';

DebugBundle.init({
  projectToken: 'local',
  environment: 'production',
  service: 'my-api',
});

const app = express();

// Add DebugBundle middleware — captures request/response context
app.use(DebugBundle.express());

app.get('/api/users', (req, res) => {
  res.json({ users: [] });
});

// Error handler — DebugBundle captures the error with full request context
app.use((err, req, res, next) => {
  res.status(500).json({ error: 'Internal server error' });
});

app.listen(3000);

import DebugBundle from '@debugbundle/sdk-node';
import Fastify from 'fastify';

DebugBundle.init({
  projectToken: 'local',
  environment: 'production',
  service: 'my-api',
});

const app = Fastify({ logger: true });

// Register DebugBundle plugin — auto-hooks pino logger
app.register(DebugBundle.fastify());

app.get('/api/users', async (request, reply) => {
  return { users: [] };
});

app.listen({ port: 3000 });

// pages/api/users.ts (or app route handler)
import DebugBundle from '@debugbundle/sdk-node';

DebugBundle.init({
  projectToken: 'local',
  environment: 'production',
  service: 'my-frontend-api',
});

export default DebugBundle.nextjs(async (req, res) => {
  res.json({ users: [] });
});

import pino from 'pino';
import DebugBundle from '@debugbundle/sdk-node';

const logger = pino();

DebugBundle.init({
  projectToken: 'local',
  environment: 'production',
  service: 'my-api',
  logger: logger,  // or let autoDetectLoggers find it
});

// These log calls are now captured by DebugBundle
logger.info('Server started');
logger.error({ err: new Error('fail') }, 'Request failed');

import winston from 'winston';
import DebugBundle from '@debugbundle/sdk-node';

const logger = winston.createLogger({
  transports: [new winston.transports.Console()],
});

DebugBundle.init({
  projectToken: 'local',
  environment: 'production',
  service: 'my-api',
  logger: logger,
});

logger.error('Something went wrong', { userId: '123' });

import bunyan from 'bunyan';
import DebugBundle from '@debugbundle/sdk-node';

const logger = bunyan.createLogger({ name: 'my-api' });

DebugBundle.init({
  projectToken: 'local',
  environment: 'production',
  service: 'my-api',
  logger: logger,
});

logger.error(new Error('fail'), 'Request failed');

try {
  await riskyOperation();
} catch (error) {
  DebugBundle.captureException(error, {
    request: req,
    response: res,
    tags: { component: 'payment' },
  });
}

DebugBundle.captureLog('User signup completed', 'info', {
  tags: { flow: 'onboarding' },
});

DebugBundle.captureRequest(
  { method: 'POST', url: '/api/charge', headers: req.headers, body: req.body },
  { statusCode: 500, headers: res.getHeaders(), body: responseBody },
);

// This context attaches to all future events
DebugBundle.setContext('user', { id: '123', plan: 'team' });
DebugBundle.setContext('deploy', { version: '1.2.3', region: 'us-east-1' });

// Always-on probe — runs on every request (all tiers)
DebugBundle.probe('db-query-timing', {
  query: 'SELECT * FROM users',
  duration: 142,
  rows: 50,
});

// Lazy probe — callback only invoked when needed
DebugBundle.probe('memory-snapshot', () => ({
  heapUsed: process.memoryUsage().heapUsed,
  rss: process.memoryUsage().rss,
}));

// Heavy probe — only runs when remotely activated (paid tiers)
DebugBundle.probe('full-request-dump', () => ({
  headers: req.headers,
  body: req.body,
  timing: performanceTiming,
}), { heavy: true });

// Express
import { debugBundleRelay } from '@debugbundle/sdk-node/relay/express';
app.use('/debugbundle/browser', debugBundleRelay());

// Fastify
import { debugBundleRelayPlugin } from '@debugbundle/sdk-node/relay/fastify';
app.register(debugBundleRelayPlugin);

// Next.js
import { debugBundleRelay } from '@debugbundle/sdk-node/relay/nextjs';
export const POST = debugBundleRelay;