@dudousxd/nestjs-telescope (core)

pnpm add @dudousxd/nestjs-telescope

npm install @dudousxd/nestjs-telescope

Core is everything you need to start capturing: it wires request and exception watchers automatically, turns on a zero-config SQLite store and pruner, and exposes the headless API. Import the module and you're recording — no adapter required.

import { TelescopeModule } from '@dudousxd/nestjs-telescope';

@Module({
  imports: [
    TelescopeModule.forRoot({
      enabled: process.env.NODE_ENV !== 'production',
      authorizer: () => true, // gates the API; defaults to deny in production
      prune: { after: '24h' },
    }),
  ],
})
export class AppModule {}

Hit GET /telescope/api/entries (or /telescope/api/entries/:id for a request and everything it caused).

Built-in watchers

import { TelescopeModule, HttpClientWatcher } from '@dudousxd/nestjs-telescope';

TelescopeModule.forRoot({ watchers: [new HttpClientWatcher({ slowMs: 1000 })] });

HttpClientWatcher + axios / @nestjs/axios

fetch is patched out of the box, but NestJS apps mostly call out through @nestjs/axios's HttpService — and in Node, axios uses the http adapter, not fetch, so those calls are invisible to the fetch patch. Pass an axios source to capture them too, via axios's public interceptor API (no monkey-patching). Both paths share the same content shape, tags, and family-hash, so axios and fetch entries are indistinguishable in the dashboard.

@nestjs/axios — resolve HttpService lazily. HttpService isn't constructed until the container is up, so use the custom-source instrument hook to grab axiosRef at register time from ctx.moduleRef:

import { TelescopeModule, HttpClientWatcher } from '@dudousxd/nestjs-telescope';
import { HttpService } from '@nestjs/axios';

TelescopeModule.forRoot({
  watchers: [
    new HttpClientWatcher({
      slowMs: 1000,
      axios: {
        instrument(attach, ctx) {
          const http = ctx.moduleRef.get(HttpService, { strict: false });
          attach(http.axiosRef); // wire interceptors onto the real instance
        },
      },
    }),
  ],
});

Plain axios instance — hand it over directly:

import axios from 'axios';
import { TelescopeModule, HttpClientWatcher } from '@dudousxd/nestjs-telescope';

const client = axios.create({ baseURL: 'https://api.example.com' });

TelescopeModule.forRoot({ watchers: [new HttpClientWatcher({ axios: client })] });

On a non-2xx response the entry records error.response.status; on a transport failure (no response) it records statusCode: null (tagged failed). Either way the rejection is re-thrown, so your error handling is untouched. Instrumentation is idempotent per axios instance, so sharing one instance across watchers never double-records.

Headless API

Key options

See Capture & correlation for the recorder pipeline and the Entry / Watcher / StorageProvider SPIs.