@biwave/winston

Winston transport integration for Biwave, bridging existing Winston loggers directly to Biwave's log buffer.

Features

• Winston Transport: Extends winston-transport to capture structured Winston log events (info, warn, error, debug).
• Batched Ingestion: Bridges directly to @biwave/core's EventBuffer<LogEvent> to batch and send logs efficiently to /api/log.
• Automatic Client Resolution: Uses getCurrentClient() from @biwave/core by default, or accepts an explicit BiwaveClient instance.

Installation

# pnpm
pnpm add @biwave/winston @biwave/core winston

# npm
npm install @biwave/winston @biwave/core winston

# yarn
yarn add @biwave/winston @biwave/core winston

Basic Usage

import winston from 'winston';
import { init } from '@biwave/node';
import { BiwaveTransport } from '@biwave/winston';

// Initialize Biwave SDK first
init({
  clientId: 'your-client-id',
  environment: 'production',
});

// Add BiwaveTransport to Winston logger
const logger = winston.createLogger({
  level: 'info',
  transports: [new winston.transports.Console(), new BiwaveTransport()],
});

// Logs are automatically captured by Biwave
logger.info('Server started on port 3000', { port: 3000 });
logger.error('Unhandled request failure', { route: '/api/checkout' });

License

MIT © Bitech.id