@pack/errors

Shared error-tracking core used by Pack runtime adapters.

Install

npm install @pack/errors

Exports

• sanitizeString(text)
• generateFingerprint(message, stack)
• sendErrorEvents(events, config, options?)
• sendServerErrorEvent(error, request, pack)
• createServerErrorHandler()
• SDK_VERSION, SCHEMA_VERSION

DSN format

sendErrorEvents requires a DSN via config.dsn. Use: https://PUBLIC_KEY@host/ingest/PROJECT_ID

The DSN is parsed into:

• endpoint: https://host/ingest
• X-Pack-Key: PUBLIC_KEY
• X-Pack-Project: PROJECT_ID

Events are sent as a JSON array. Failures are swallowed so tracking never breaks app flow.

Client example

import { sendErrorEvents } from '@pack/errors';

sendErrorEvents(
  [
    {
      timestamp: new Date().toISOString(),
      error_message: 'Something failed',
      error_stack: '',
      error_type: 'manual',
      error_fingerprint: 'abc123',
      url: 'https://store.example.com/products/widget',
      pathname: '/products/widget',
      section_id: '',
      section_type: '',
      component_stack: '',
      user_agent: '',
      screen: '',
      device_category: '',
      sdk_version: '0.1.0',
      schema_version: '1',
      session_id: 'session-1',
      hostname: 'store.example.com',
    },
  ],
  { dsn: 'https://[email protected]/ingest/PROJECT_ID' },
  { keepalive: true },
);

Server usage

Use the helper for route-level error handling:

import { createServerErrorHandler } from '@pack/errors';

export const handleError = createServerErrorHandler();

createServerErrorHandler:

• reads pack from context.pack or context.get('pack')
• sends only when pack.session.id is present
• sanitizes message/stack/url before sending
• deduplicates repeated sends on the same Error object

If you already have request + pack, you can call sendServerErrorEvent(error, request, pack) directly.

Sanitization and fingerprinting

• sanitizeString strips URL query params and masks sensitive JSON-like fields (for example password, token, email, phone)
• generateFingerprint creates a stable hash from message + first non-empty stack line

Development

yarn
yarn build