better-logger

🎯 Features

🚀 Getting Started

1. Install

npm install @better-logger/core

2. Import

import { better } from '@better-logger/core'
// or
const { better } = require('@better-logger/core')

3. Use

// Drop-in for console.log
better.log('Server started on port 3000')
better.log('User created', { email: 'test@example.com' })
better.log.warn('Slow query detected', { duration: 250 })
better.log.error('Database connection failed', error)

4. That's It

No configuration needed. Your logs are now structured, timed, and grouped automatically.

📖 API Reference

Core API

Flow Methods

Configuration

Explicit Flow Example

const flow = better.flow('user-checkout', {
  tags: ['ecommerce', 'payment'],
  initialContext: { userId: 'user-123', cartId: 'cart-456' }
})

flow.setContext({ orderId: 'order-789' })

// Async step with auto-complete
const result = await flow.run('charge-card', async () => {
  return await paymentGateway.charge({ amount: 99.99 })
})

// Manual step
const notifyStep = flow.step('send-confirmation')
await sendEmail(user.email, 'Order confirmed')
notifyStep.success()

flow.success()

🔌 Framework Integrations

Official integrations for popular frameworks. Auto-instrument your app with zero configuration.

Express.js

const express = require('express')
const { betterLogger, betterErrorHandler } = require('@better-logger/express')

const app = express()
app.use(betterLogger({ logBody: false, redactFields: ['password'] }))
app.use(betterErrorHandler)

app.post('/api/users', async (req, res) => {
  // Each request is auto-logged with timing
  const user = await createUser(req.body)
  res.json(user)
})

Fastify

const fastify = require('fastify')()
await fastify.register(require('@better-logger/fastify'))

Next.js

// next.config.js
const withBetter = require('@better-logger/nextjs')
module.exports = withBetter({ /* your config */ })

// pages/api/users.js
import { withBetterLoggerAPI } from '@better-logger/nextjs'
export default withBetterLoggerAPI(async (req, res) => {
  // Auto-logged
})

React

import { useComponentLogger, useAsyncLogger, BetterErrorBoundary } from '@better-logger/react'

function UserProfile({ userId }) {
  const logger = useComponentLogger('UserProfile')
  const fetchData = useAsyncLogger('fetch-user')

  useEffect(() => {
    logger.mount({ userId })
    return () => logger.unmount({ userId })
  }, [userId])

  const loadUser = () => fetchData(() => api.getUser(userId))
}

CLI Tools

const { command, step, progress, table } = require('@better-logger/cli')

await command('build', async () => {
  await step('compile', async () => { /* ... */ })
  await step('bundle', async () => { /* ... */ })
  progress(50, 100, 'bundling...')
})

🚚 Transports

Write logs anywhere — files, streams, HTTP endpoints. Zero external dependencies.

File Transport

better.log.toFile('app.log', { append: true })
better.log.toFile('error.log', { append: true })

Stream Transport

better.log.toStream(process.stdout)
better.log.toStream(fs.createWriteStream('logs.json'))

HTTP Transport

better.log.toHttp('https://api.example.com/logs', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer token' }
})

Multiple Transports

better.log.toFile('app.log')
better.log.toHttp('https://logs.example.com')
// All logs go to both destinations

🔒 Production Features

PII Redaction

better.log.redact(['password', 'ssn', 'creditCard'])

better.log('User login', { username: 'alice', password: 'secret', ssn: '123-45-6789' })
// Output: { username: "alice", password: "[REDACTED]", ssn: "[REDACTED]" }

better.log.redact([]) // Clear redaction

Async Logging

// Non-blocking buffered logging for high-throughput
better.log.async(true)

better.log('msg1')
better.log('msg2')
better.log('msg3')
// All buffered

better.log.flush()
// All processed at once

better.log.async(false) // Disable auto-flushes remaining

Silent Mode

// Globally disable all logging
better.setEnabled(false)

// Per-flow silent mode
const flow = better.flow('health-check', { enabled: false })
// No output, near-zero overhead

🔄 Migration Guides

From console.log

// Before
console.log('User created:', user)
console.error('Payment failed:', error)

// After — just add "better."
better.log('User created:', user)
better.log.error('Payment failed:', error)

From Pino

// Before (pino)
const logger = pino({ transport: { target: 'pino/file', options: { destination: 'app.log' } } })
logger.info('User created', { email })

// After (better-logger)
const { better } = require('@better-logger/core')
better.log.toFile('app.log')
better.log.info('User created', { email })

From Winston

// Before (winston)
const logger = winston.createLogger({
  transports: [
    new winston.transports.File({ filename: 'app.log' }),
    new winston.transports.Http({ url: 'https://logs.example.com' })
  ]
})
logger.info('User created', { email })

// After (better-logger)
better.log.toFile('app.log')
better.log.toHttp('https://logs.example.com')
better.log.info('User created', { email })

See full guides: Migrate from Pino · Migrate from Winston

📊 Why better-logger?