@saga-bus/middleware-logging

Structured logging middleware for saga-bus.

Installation

pnpm add @saga-bus/middleware-logging

Usage

import { createLoggingMiddleware } from "@saga-bus/middleware-logging";
import { createBus } from "@saga-bus/core";

const loggingMiddleware = createLoggingMiddleware({
  logger: console,
  level: "info",
});

const bus = createBus({
  middleware: [loggingMiddleware],
  sagas: [...],
  transport,
});

Log Events

| Event | Level | Description | |-------|-------|-------------| | saga.message.received | info | Message received for processing | | saga.handler.start | debug | Handler execution started | | saga.handler.success | info | Handler completed successfully | | saga.handler.error | error | Handler threw an error | | saga.state.created | info | New saga instance created | | saga.state.completed | info | Saga marked as complete |

Configuration

| Option | Type | Default | Description | |--------|------|---------|-------------| | logger | Logger | console | Logger instance | | level | string | "info" | Minimum log level | | includeState | boolean | false | Include state in logs |

License

MIT