Make the router wait for running handlers before shutdown

Co-authored-by: Miłosz Smółka <milosz.smolka@gmail.com>
Co-authored-by: Robert Laszczak <roblaszczak@gmail.com>

[docs] added missing docs

Co-authored-by: Miłosz Smółka <milosz.smolka@gmail.com>

* improve examples validate script

* fix examples validation

* update examples deps

* update Watermill deps

* added example steps to Makefile

* update leftover examples deps

* Validate examples CI (#326)

* refacotored sending lock of subscriber to the SendToSubscriber loop to be as close as possible to the sending part of the logic. This results in the outputbuffer acutally being utilized and fixes blocking behavior mentioned in issue 275/382

* Fix lint

* Fix race

---------

Co-authored-by: Miłosz Smółka <milosz.smolka@gmail.com>

* Adds feature to use ULID instead of UUID in topic name and consumer group

* split ULID id generation into a seperate function

* changed func name

* added a field for setting function used in ID generation

* Refactor a bit

---------

Co-authored-by: Miłosz Smółka <milosz.smolka@gmail.com>

* Clean up resources related to the topic if there are no subscribers (#391)

* fix: clean up resources in go channel pub sub

* fix: removed unnecessary subscriber data removal code

* fix: added timeout to test allowing cleanup to finish

* fix: modified test for subscriber cleanup

---------

Co-authored-by: stong <498327580@qq.com>

* Add NewMessageWithContext()

This is the equivalent of calling `NewMessage()` and `SetContext()`
separately, but should give a hint that when publishing messages,
the message's context is used.

* Docs

…umentation (#597)

Signed-off-by: pxwanglu <pxwanglu@icloud.com>

Co-authored-by: Robert Laszczak <roblaszczak@gmail.com>

* migrate to backoff v5 + bump go version

* slight cleanup

* simplify retry middleware and fix tests

---------

Co-authored-by: Evan Madurai <evan.p.madurai@pwc.com>
Co-authored-by: Miłosz Smółka <milosz.smolka@gmail.com>
Co-authored-by: Robert Laszczak <roblaszczak@gmail.com>

* Update TestMessageContext

This test seems dedicated more to the GoChannel behavior (the ctx not
being propagated), which makes no sense in the context of all Pub/Subs.

Solves #464

* Bump deps

* Add CommandEventMarshalerDecorator

A common operation is adding some metadata to the message during marshaling. A universal decorator makes it easier than writing one from scratch.

* AddConsumerHandle

The current AddNoPublisherHandler name can be confusing, especially since it's the one most often used.

* added sqlite docs PoC

* cleanups

* added sqlite examples and polish docs

* Complete SQLite driver documention with examples (#617)

* fix installation commands for SQLite drivers

* fix docs sqlite example, add transaction

* fix docs sqlite zombiezen and its example

* expand sqlite documentation with a beta version warning and additional explanations

* bump sqlite pubsub version

* bump sqlite pubsub versions to 0.1.1

* fix include

---------

Co-authored-by: Dmitry Kotik <7944694+dkotik@users.noreply.github.com>

Minor finishing touches to give the documentation a sense of completion.
Fix one major error in transaction example: Rollback was deferred
instead of Commit.

Co-authored-by: adrian.zajkowski <adrian.zajkowski@nordsec.com>

Signed-off-by: efcking <efcking@outlook.com>