Typescript Sentry

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.

laurigates 1c05b61 2 files · 19.9 KB Updated Sep 9, 2026

Install

Press C to copy

$ npx skillmds@latest add laurigates/typescript-sentry

Installs into ~/.claude/skills (or .claude/skills inside a project). Restart Claude Code to pick it up.

＋ Add to collection

README badge

[![SkillMD](https://skillmd.com/badge/laurigates/typescript-sentry.svg)](https://skillmd.com/skills/laurigates/typescript-sentry)

Trust & safety

Audits pending

Not yet audited · commit 1c05b61

Permissions this skill uses

Documentation only
No scripts, network access, or credentials are involved.

Works with: Claude Code Claude.ai OpenAI Codex +

File contents

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.

---name: typescript-sentrydescription: 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.--- # 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 ```bash bun add @sentry/bun ``` ### Node.js ```bash bun add @sentry/node ``` ### Next.js ```bash bun add @sentry/nextjs @sentry/profiling-node ``` ### React/Browser ```bash bun add @sentry/react # or bun add @sentry/browser ``` ## Error Capturing ### captureException ```typescript try { await riskyOperation(); } catch (error) { Sentry.captureException(error); throw error; // Re-throw if needed } ``` ### With Context ```typescript 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 ```typescript // 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](REFERENCE.md).

laurigates/claude-plugins/tree/main/typescript-plugin/skills/typescript-sentry commit 1c05b6148a

Frequently asked questions

npx skillmds@latest add laurigates/typescript-sentry