@sekolahcode/devpulse-browser

Zero-dependency browser SDK for DevPulse — frontend error tracking and Core Web Vitals monitoring.

Requirements

• A running DevPulse server (v1.0+)
• Any modern browser (ES2017+)

Installation

Via npm

npm install @sekolahcode/devpulse-browser

import { DevPulse } from '@sekolahcode/devpulse-browser';

DevPulse.init({
  dsn: 'https://your-devpulse-host/api/ingest/YOUR_API_KEY',
  environment: 'production',
  release: '1.0.0',
});

Via script tag (UMD, auto-init)

<script
  src="https://your-devpulse-host/devpulse.js"
  data-dsn="https://your-devpulse-host/api/ingest/YOUR_API_KEY"
  data-env="production"
  data-release="1.0.0"
></script>

After init(), uncaught errors and unhandled promise rejections are captured automatically.

API

DevPulse.init(config)

DevPulse.capture(error, extra?)

try {
  await riskyOperation();
} catch (err) {
  DevPulse.capture(err, { orderId: 42 });
}

DevPulse.captureMessage(message, level?)

DevPulse.captureMessage('Quota approaching', 'warning');

DevPulse.setUser(user) / DevPulse.clearUser()

DevPulse.setUser({ id: '123', email: 'user@example.com' });
// On logout:
DevPulse.clearUser();

DevPulse.addBreadcrumb(crumb)

DevPulse.addBreadcrumb({ category: 'auth', message: 'User logged in', level: 'info' });

DevPulse.flush(timeout?) / DevPulse.close()

await DevPulse.flush(3000);  // wait for in-flight requests
DevPulse.close();            // disconnect PerformanceObservers

beforeSend hook

Return null or false to drop an event entirely.

DevPulse.init({
  dsn: '...',
  beforeSend(event) {
    if (event.user?.email?.endsWith('@internal.example.com')) return null;
    return event;
  },
});

Breadcrumbs

Automatically tracked:

Query strings are stripped from XHR/fetch URLs by default to avoid capturing tokens or PII. Set captureQueryStrings: true to preserve them.

Core Web Vitals

When trackVitals: true (default), one vitals event is sent on page hide:

Development

npm install
npm run dev      # watch build
npm test         # vitest
npm run lint     # eslint
npm run format   # prettier
npm run build    # production build

License

MIT — see LICENSE