SDK Overview
Package hierarchy, which package to install, and what's included.
The DeepTracer JavaScript SDK is a family of 6 npm packages. Each one builds on the layer below, so you only install the package that matches your framework.
Package hierarchy
@deeptracer/core (zero dependencies)
├── @deeptracer/node (Node.js / Bun)
├── @deeptracer/ai (LLM tracking wrappers)
└── @deeptracer/browser (window errors, console)
└── @deeptracer/react (provider, error boundary, hooks)
└── @deeptracer/nextjs (server + client)Every package re-exports everything from its parent. Install one package and you get the full API surface below it.
Which package to install
| Framework | Package | What you get |
|---|---|---|
| Next.js | @deeptracer/nextjs | Everything. Server logging, error capture, distributed tracing, React components, error boundary. One package, one file. |
| Node.js / Express / Hono / Bun | @deeptracer/node | Logging, error capture, tracing, HTTP middleware, global error handlers. |
| React SPA (Vite, CRA) | @deeptracer/react | Browser logging, React context provider, error boundary, useLogger hook. |
| AI / LLM wrappers | @deeptracer/ai | Vercel AI SDK, OpenAI, and Anthropic wrappers. Install alongside @deeptracer/node or @deeptracer/react. |
| Custom runtime | @deeptracer/core | Logger, transport, tracing, error capture. No platform-specific code. Zero dependencies. |
Quick install
npm install @deeptracer/nextjsnpm install @deeptracer/nodenpm install @deeptracer/reactnpm install @deeptracer/aiAll packages share the same version
Every @deeptracer/* package is released in lockstep. When you see 0.3.1 on one package, all six packages are at 0.3.1. No version matrix to worry about.
ESM and CommonJS
All packages ship both ESM and CommonJS builds, plus TypeScript declarations. Works with import, require(), and any bundler.
Zero dependencies in core
@deeptracer/core has zero runtime dependencies. It uses the Web fetch API and crypto.getRandomValues() for network requests and ID generation -- both available in Node.js 18+, Bun, Deno, and all modern browsers.