typescript-sentry

name	typescript-sentry
description	Error monitoring and performance with Sentry SDK for Bun/Node.js/Next.js — error capture, breadcrumbs, spans, cron monitoring, source maps, structured logging, profiling. Use when adding Sentry, instrumenting cron, or uploading sourcemaps.
user-invocable	false
allowed-tools	Bash, Read, Write, Edit, Grep, Glob, TodoWrite
created	"2026-01-22T00:00:00.000Z"
modified	"2026-07-28T00:00:00.000Z"
reviewed	"2026-01-22T00:00:00.000Z"

TypeScript Sentry

This skill covers the SDK-side work: capture, spans, cron monitors, source maps, profiling, filtering. For project-level Sentry compliance (DSN hygiene, sourcemap-upload wiring in CI) use /configure:sentry; for local step-through debugging use typescript-debugging.

Core Expertise

Sentry provides error monitoring and performance tracking:

• Automatic error capture with stack traces
• Performance monitoring with distributed tracing
• Cron job monitoring for scheduled tasks
• Source map integration for readable TypeScript traces
• Rich context with tags, breadcrumbs, and user data
• Structured logging forwarded to Sentry (enableLogs)
• CPU/JS profiling (Node.js + browser)
• Session replay with privacy controls
• User feedback widget
• Enrichment helpers (custom contexts, breadcrumb categories, fingerprinting)

Installation

Bun

bun add @sentry/bun

Node.js

bun add @sentry/node

Next.js

bun add @sentry/nextjs @sentry/profiling-node

React/Browser

bun add @sentry/react
# or
bun add @sentry/browser

Error Capturing

captureException

try {
  await riskyOperation();
} catch (error) {
  Sentry.captureException(error);
  throw error; // Re-throw if needed
}

With Context

Sentry.captureException(error, {
  tags: {
    feature: "checkout",
    paymentProvider: "stripe",
  },
  extra: {
    orderId: order.id,
    userId: user.id,
    cartItems: cart.items.length,
  },
  level: "error", // fatal, error, warning, info, debug
});

captureMessage

// Simple message
Sentry.captureMessage("User completed onboarding");

// With level
Sentry.captureMessage("Rate limit approaching", "warning");

// With context
Sentry.captureMessage("Payment failed", {
  level: "error",
  tags: { gateway: "stripe" },
  extra: { errorCode: "card_declined" },
});

Agentic Optimizations

Context	Command
Install Bun	bun add @sentry/bun
Install Node	bun add @sentry/node
Install Next.js	bun add @sentry/nextjs @sentry/profiling-node
Install React	bun add @sentry/react
Install CLI	bun add -D @sentry/cli
Upload maps	npx sentry-cli sourcemaps inject ./dist && npx sentry-cli sourcemaps upload ./dist
Setup wizard	npx @sentry/wizard@latest -i sourcemaps
Test capture	Sentry.captureMessage("Test from dev")

Quick Reference

Capture Methods

Method	Purpose
captureException(error)	Capture error with stack trace
captureMessage(msg)	Capture text message
captureCheckIn(opts)	Cron job check-in
addBreadcrumb(crumb)	Add navigation/action trail

Context Methods

Method	Purpose
setTag(key, value)	Add filterable tag
setExtra(key, value)	Add debug data
setUser(user)	Set user context
withScope(callback)	Scoped context

Performance Methods

Method	Purpose
startSpan(opts, callback)	Create performance span
withMonitor(slug, callback)	Monitor cron job

Severity Levels

Level	Use Case
fatal	App crash, unrecoverable
error	Error requiring attention
warning	Potential issue
info	Informational
debug	Debugging only

Configuration Options

Option	Description
dsn	Project data source name
environment	Environment name (production, staging)
release	Application version
tracesSampleRate	Transaction sample rate (0.0-1.0)
tracesSampler	Dynamic sampling function
sendDefaultPii	Capture IP/headers
integrations	SDK integrations array
enableLogs	Forward structured logs to Sentry
profileSessionSampleRate	Profiling sample rate (0.0-1.0)
profileLifecycle	"trace" profiles every traced request
replaysSessionSampleRate	Session replay sample rate
replaysOnErrorSampleRate	Replay capture rate on errors
ignoreErrors	Array of error patterns to suppress
beforeSend	Filter/modify events before sending
beforeSendTransaction	Filter transactions before sending
beforeSendLog	Filter structured logs before sending

For detailed examples, advanced patterns, and best practices, see REFERENCE.md.