IDebug is experimental. Prefer enabling only in development.
Changelog

Changelog

Notable product documentation for recent work. For full git history, see the repository log.

Unreleased — call-tree timing bars

  • Inspector Call tree toggle: Tree or Bars (persists in localStorage)
  • Bars waterfall: width ∝ duration, left offset ∝ start, shared request time axis
  • Slow DB/function spans stand out next to the wrapping controller/service

Unreleased — contributor tooling

  • GitHub Actions CI on push/PR to main (pnpm lint + pnpm test)
  • Issue templates (bug / feature) and pull request template
  • Contributor onboarding notes

0.0.1 — database monitor + call-tree queries

  • New @idebug/db: Prisma, TypeORM, Drizzle, Knex, Mongoose, Sequelize
  • dbQuery TraceEvent nested under the wrapping functionCall via ALS callStack
  • Inspector Call tree + teal DB chips on the request path; session header shows db Nq / time
  • configure({ db: true | false | options }) / IDebugModule.forRoot({ db })
  • Sample sample-db-api (samples/db-api, :3003) — Drizzle + Knex + traceQuery call-tree demo

0.0.1 — monorepo, SDKs, UI, CLI, security, brand

Brand

  • Minimal path-nodes logo (request → hop → response)
  • Assets under docs/brand/ (SVG + PNG); wired into docs, README, UI favicon, .github/

Security posture

  • Default hostCheck (localhost/loopback Host only) — DNS rebinding mitigation
  • Default localRemoteOnly — reject non-loopback TCP peers
  • Optional accessToken (Bearer / X-IDebug-Token / ?idebug_token=)
  • Response headers: X-Frame-Options: DENY, Cache-Control: no-store, …
  • Docs: /guides/security

CLI (bin/idebug)

  • idebug init — prompt for project type (express | nest | react)
  • Writes standardized idebug.config.json + scaffolds idebug/setup.ts
  • Installs the matching SDK; projects / status / help commands

Docs

  • Nextra 3 documentation site (apps/docs) with theme-docs
  • Brand styling: primary #384ce3, Uncut Sans, JetBrains Mono, light/dark
  • Full package guides, HTTP API, samples, architecture
  • Root README mirrors monorepo layout, CLI, packages, samples, and contracts

Debug UI (@idebug/ui)

  • AlignUI components + Tailwind
  • Baselayer-inspired light/dark themes
  • Request path graph (double-point enter/exit)
  • App changes only toggle for framework RESΔ noise

SDKs

  • @idebug/core — ALS sessions, ring buffer, redaction, HTTP handler
  • @idebug/node / @idebug/nest — TraceEvents, UI mount, enter/exit functionCall
  • @idebug/react — browser patches + overlay
  • Mutation source: 'app' | 'framework'

Samples & tests

  • samples/express-api (:3001), samples/nest-api (:3002), samples/db-api (:3003), samples/react-app (:5173)
  • E2E: tests/node/e2e, tests/nest/e2e; unit tests in tests/core, tests/db, tests/node/unit (react / ui remain colocated)
Architecture