@nestjs-yalc/event-manager

Structured event, logging, and HTTP-aware error helpers for NestJS applications.

YalcEventService is the usual application entry point. It wraps lower-level event helpers so one call can log, emit through EventEmitter2, and create typed errors from @nestjs-yalc/errors.

Installation

npm install @nestjs-yalc/event-manager

Main Exports

• YalcEventService for logs, domain events, and error helpers.
• EventModule for Nest provider wiring.
• event, eventAsync, and level-specific event helpers.
• simpleDotFormatter, global emitter helpers, and Result helper types.

Example

import { EventModule, YalcEventService } from '@nestjs-yalc/event-manager';

@Module({
  imports: [EventModule.forRootAsync({})],
})
export class AppModule {}

@Injectable()
export class UsersService {
  constructor(private readonly events: YalcEventService) {}

  async loaded(userId: string) {
    await this.events.logAsync(['user', 'loaded'], {
      data: { userId },
    });
  }
}

Documentation

• EventManager module: https://github.com/NestDevLab/nestjs-yalc/blob/dev/docs/event-manager-module.md
• YalcEventService: https://github.com/NestDevLab/nestjs-yalc/blob/dev/docs/event-manager-service.md
• Event helper: https://github.com/NestDevLab/nestjs-yalc/blob/dev/docs/event-manager-event.md