Package Exports

error-logger-sendsms
error-logger-sendsms/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (error-logger-sendsms) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Error Logger SendSMS

Lightweight error logging with Discord/Slack notifications - no database required.

Features

🚀 Zero Database - No database setup required
📢 Multi-Platform - Send to Discord and/or Slack webhooks
🔒 Privacy First - Automatic sanitization of sensitive data (passwords, tokens, PII)
♻️ Retry Logic - Exponential backoff with circuit breaker
🌍 Environment Aware - Auto-detects development/staging/production
📦 Minimal Config - Sensible defaults, works out of the box
⚡ Fast - <5s notification delivery, <100ms initialization
🎯 TypeScript - Full type safety with TypeScript

Installation

npm install error-logger-sendsms

Quick Start

Option 1: Using Environment Variables (Recommended)

Create .env file:

# Discord configuration
DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/YOUR_WEBHOOK_ID/YOUR_TOKEN

# Or Slack configuration
SLACK_WEBHOOK_URL=https://hooks.slack.com/services/YOUR/SLACK/WEBHOOK
SLACK_CHANNEL=#errors

Use in code:

import { ErrorLogger } from 'error-logger-sendsms';

// Automatically loads configuration from environment variables
const logger = new ErrorLogger();

// Ready to use immediately!
try {
  throw new Error('Something went wrong!');
} catch (error) {
  await logger.captureException(error);
}

await logger.captureMessage('User logged in', 'info', { userId: '123' });

Option 2: Explicit Configuration

import { ErrorLogger } from 'error-logger-sendsms';

const logger = new ErrorLogger({
  discord: {
    webhookUrl: 'https://discord.com/api/webhooks/YOUR_WEBHOOK_ID/YOUR_TOKEN'
  }
});

// Capture exceptions
try {
  throw new Error('Something went wrong!');
} catch (error) {
  await logger.captureException(error);
}

// Capture messages
await logger.captureMessage('User logged in', 'info', { userId: '123' });

Environment Variables

Node.js / Backend

# Discord
DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/...
DISCORD_USERNAME=Error Bot
DISCORD_AVATAR_URL=https://example.com/avatar.png

# Slack
SLACK_WEBHOOK_URL=https://hooks.slack.com/services/...
SLACK_CHANNEL=#errors
SLACK_USERNAME=Error Monitor

# Global Settings
ERROR_LOGGER_ENABLED=true
ERROR_LOGGER_ENVIRONMENT=production

Vite / Frontend

When using Vite, use the VITE_ prefix:

# .env
VITE_DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/...
VITE_SLACK_WEBHOOK_URL=https://hooks.slack.com/services/...
VITE_ERROR_LOGGER_ENABLED=true

Next.js

# .env.local
NEXT_PUBLIC_DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/...
NEXT_PUBLIC_SLACK_WEBHOOK_URL=https://hooks.slack.com/services/...

Use in code:

const logger = new ErrorLogger({
  discord: {
    webhookUrl: process.env.NEXT_PUBLIC_DISCORD_WEBHOOK_URL
  }
});

Both Discord and Slack

const logger = new ErrorLogger({
  discord: {
    webhookUrl: 'https://discord.com/api/webhooks/...'
  },
  slack: {
    webhookUrl: 'https://hooks.slack.com/services/...'
  }
});

// Sends to BOTH platforms
await logger.captureException(new Error('Critical error'));

Configuration

Retry Policy

const logger = new ErrorLogger({
  discord: { webhookUrl: '...' },
  retry: {
    maxAttempts: 3,        // 1-5 attempts
    baseDelay: 1000,       // Initial delay (ms)
    maxDelay: 30000,       // Maximum delay (ms)
    jitter: true           // Add randomization
  }
});

Data Sanitization

const logger = new ErrorLogger({
  discord: { webhookUrl: '...' },
  sanitization: {
    enabled: true,
    customPatterns: ['creditCard', 'ssn'],
    excludeDefaults: false  // Use built-in patterns
  }
});

Default patterns automatically sanitize:

Passwords (password, passwd, pwd)
Tokens (token, bearer, jwt, apikey)
Secrets (secret, private_key)
Email addresses
Credit card numbers
Social Security Numbers

Environment Detection

// Auto-detects from NODE_ENV, import.meta.env, or window.location
const logger = new ErrorLogger({
  discord: { webhookUrl: '...' }
});

// Or set manually
const logger = new ErrorLogger({
  discord: { webhookUrl: '...' },
  environment: 'production'
});

Runtime Configuration

const logger = new ErrorLogger({
  discord: { webhookUrl: '...' }
});

// Disable temporarily
logger.configure({ enabled: false });

// Add Slack
logger.configure({
  enabled: true,
  slack: { webhookUrl: '...' }
});

// Change environment
logger.setEnvironment('staging');

API Reference

`ErrorLogger`

Constructor

new ErrorLogger(config?: Partial<NotificationConfig>)

Methods

captureException(error: Error | string, metadata?: Record<string, any>): Promise<void>

Capture and send an exception.

await logger.captureException(new Error('Failed'), { userId: '123' });

captureMessage(message: string, level?: 'error' | 'warning' | 'info', metadata?: Record<string, any>): Promise<void>

Capture and send a message.

await logger.captureMessage('User action', 'info', { action: 'login' });

configure(config: Partial<NotificationConfig>): void

Update configuration at runtime.

logger.configure({ enabled: false });

setEnvironment(environment: string): void

Set environment override.

logger.setEnvironment('production');

Examples

See the examples/ directory for integration examples with:

Basic usage
Advanced configuration
React applications
Express.js servers

Performance

Notification delivery: <5 seconds
Initialization: <100ms
Package size: <10MB
Throughput: 1000 notifications/minute

Constitutional Principles

This package adheres to strict development principles:

Reliability First: Never fails silently, implements fallbacks
Privacy by Design: Automatic data sanitization
Test-First Development: 85%+ code coverage
Minimal Configuration: Works with sensible defaults
Performance Conscious: Minimal overhead on applications

License

MIT

Contributing

Contributions welcome! Please read our contributing guidelines and submit pull requests.