feat: add command interceptors

[V3RON]

PR Checklist

Please check if your PR fulfills the following requirements:

• The commit message follows our guidelines: https://github.com/nestjs/nest/blob/master/CONTRIBUTING.md
• Tests for the changes have been added (for bug fixes / features)
• Docs have been added / updated (for bug fixes / features)

PR Type

What kind of change does this PR introduce?

• Bugfix
• Feature
• Code style update (formatting, local variables)
• Refactoring (no functional changes, no api changes)
• Build related changes
• CI related changes
• Other... Please describe:

What is the current behavior?

None. It's not possible to intercept commands. Things like logging must be handled by extension of CommandBus class in the application code.

What is the new behavior?

Additional actions can be executed both before and after the command is handled. This feature enhances the flexibility and extensibility of command processing. For instance, one can implement ValidationCommandInterceptor, run validation on commands.

Does this PR introduce a breaking change?

• Yes
• No

Other information

[kamilmysliwiec]

Apologies for the delay in reviewing this PR, and thank you for your contribution!

I just wanted to confirm that I haven’t missed anything here—wouldn't it be simpler to create your own abstraction over the CommandBus? For example:

@Injectable()
class MyCommandBus {
  constructor(private readonly commandBus: CommandBus) {}

  async execute<T extends ICommand>(command: T): Promise<T> {
    console.log('Before command execution');
    const result = await this.commandBus.execute(command);
    console.log('After command execution');
    return result;
  }
}

I'm a bit hesitant about introducing another abstraction here. If we merge this PR, we’d likely need to add similar annotations for queries and possibly even events—introducing a total of three new annotations to achieve something that appears manageable with the approach above.

Please let me know if there’s something I might be overlooking—whether it’s something currently too complex, requires too much overhead, or isn’t feasible at the moment but would be resolved by merging this PR.

Thank you again!