@deeptracer/browser

DeepTracer SDK for browsers — window error handlers and console capture. Re-exports everything from @deeptracer/core.

Most users should install @deeptracer/react or @deeptracer/nextjs instead. This package is the low-level browser runtime used internally by those packages.

Installation

npm install @deeptracer/browser

Quick Start

import { createLogger, captureGlobalErrors } from "@deeptracer/browser"

const logger = createLogger({
  service: "web",
  environment: "production",
  endpoint: "https://deeptracer.example.com",
  apiKey: "dt_xxx",
})

// Capture all unhandled errors and promise rejections
captureGlobalErrors(logger)

// Log events
logger.info("Page loaded", { route: "/dashboard" })

API Reference

captureGlobalErrors(logger)

Automatically capture unhandled errors and promise rejections via window.addEventListener("error") and window.addEventListener("unhandledrejection").

• Uncaught exceptions: reported with severity "critical"
• Unhandled rejections: reported with severity "high"

import { createLogger, captureGlobalErrors } from "@deeptracer/browser"

const logger = createLogger({ ... })
captureGlobalErrors(logger)

captureConsole(logger)

Intercept all console.log/info/warn/error/debug calls and forward them to DeepTracer as log entries. Original console output is preserved.

import { createLogger, captureConsole } from "@deeptracer/browser"

const logger = createLogger({ ... })
captureConsole(logger)

// console.log("hello") → goes to BOTH console AND DeepTracer

Re-exported from @deeptracer/core

All public exports from @deeptracer/core are available directly:

• createLogger(config) — create a Logger instance
• Logger class — debug, info, warn, error, captureError, startSpan, setUser, setTags, setContext, addBreadcrumb, flush, destroy
• Types: LoggerConfig, LogLevel, LogEntry, ErrorReport, LLMUsageReport, Span, InactiveSpan, SpanData, MiddlewareOptions, User, Breadcrumb, BeforeSendEvent
• Constants: SDK_VERSION, SDK_NAME

See the @deeptracer/core README for full documentation.

Monorepo

This package is part of the DeepTracer JavaScript SDK monorepo:

| Package | Description | |---------|-------------| | @deeptracer/core | Zero-dependency shared core | | @deeptracer/node | Node.js/Bun SDK | | @deeptracer/ai | AI SDK wrappers | | @deeptracer/browser | Browser SDK (this package) | | @deeptracer/react | React integration | | @deeptracer/nextjs | Next.js integration |

Links

• deeptracer.dev — Homepage
• Docs — Documentation
• GitHub — Source code

License

MIT