SDK

Installation

npm install @reasonable-logging/js-sdk

Quick Start

import { ReasonableLogger } from '@reasonable-logging/js-sdk';

// Initialize the logger
const logger = new ReasonableLogger({
  projectId: 'your-project-id',
  apiKey: 'your-api-key',
  application: 'my-app'
});

// Start logging!
await logger.info('User logged in', { userId: '123' });
await logger.error('Payment failed', { error: 'card_declined' });

// Track custom events
await logger.userEvent('signup', 'user-123', { plan: 'pro' });
await logger.businessEvent('purchase', { amount: 99.99 });

Logging Methods

All logging methods return a Promise and accept optional metadata.

// Log levels: debug, info, warn, error, fatal
await logger.debug('Debug message', { context: 'debugging' });
await logger.info('User action', { userId: '123' });
await logger.warn('Rate limit approaching', { current: 95 });
await logger.error('Database error', { query: 'SELECT *' });
await logger.fatal('System crash', { exitCode: 1 });

Event Tracking

// User events
await logger.userEvent('signup', 'user-123', { 
  plan: 'pro', 
  source: 'organic' 
});

// Business events
await logger.businessEvent('purchase', { 
  amount: 99.99, 
  currency: 'USD' 
});

// Performance events
await logger.performanceEvent('page_load', { 
  loadTime: 1250,
  route: '/dashboard' 
});

// Custom events
await logger.customEvent('feature_used', { 
  feature: 'dark_mode',
  enabled: true 
});

Advanced Features

The SDK includes powerful features for production applications:

logger.setGlobalMeta({
  version: '2.1.0',
  environment: 'production',
  region: 'us-west-2'
});

const authLogger = logger.child({ 
  component: 'auth',
  module: 'login' 
});

await authLogger.info('Login attempt');

Framework Integration

import { ReasonableLogger } from '@reasonable-logging/js-sdk';

const logger = new ReasonableLogger({
  projectId: process.env.REACT_APP_PROJECT_ID,
  apiKey: process.env.REACT_APP_API_KEY
});

function App() {
  useEffect(() => {
    logger.info('App initialized');
  }, []);

  const handleClick = async () => {
    await logger.userEvent('button_click');
  };

  return <button onClick={handleClick}>Click me!</button>;
}