Feat/websockets

[Sorikairox]

Description

Websocket are a must for real-time application such as chats or video-games.

This PR introduces a new router and associated decorators, the WebsocketRouter.

It has the same features as the OG HttpRouter :

• Guards
• ErrorFitlers
• Middlewares
• Body and Param decorators
• Pattern matching for topics

Example:

@UseGuard(ExampleAuthGuard)
@WebSocketController('ws')
class ExampleController {
	constructor(private service: ExampleService) {
	}

	@UseGuard(ControllerGuard)
	@OnWebSocketMessage('hello')
	sayHello() {
		return { topic: 'hello', data: this.service.sayHello() };
	}
	
	@OnWebSocketMessage('goodbye')
	saygoodbye(@Body() whateverIsSent: any) {
		return { topic: 'goodbye', data: whateverIsSent };
	}

	@OnWebSocketMessage('hello/:name')
	sayHelloWithName(@Param('name') name: string) {
		return { topic: 'hello', data: name };
	}
}

---

Issue Ticket Number

Fixes #(issue_number)

---

Type of change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to
  not work as expected)
• This change requires a documentation update

---

Checklist:

• I have run deno lint AND deno fmt AND deno task test and got no
  errors.
• I have followed the contributing guidelines of this project as mentioned
  in CONTRIBUTING.md
• I have checked to ensure there aren't other open
  Pull Requests for the same
  update/change?
• I have performed a self-review of my own code
• I have made corresponding changes needed to the documentation

[marco-souza]

Great job!
I found the implementation ws router implementation SUPER COOOL! 🙌🏼

[codecov-commenter]

Codecov Report

Attention: Patch coverage is 91.57895% with 24 lines in your changes are missing coverage. Please review.

Project coverage is 88.96%. Comparing base (887c762) to head (3702bba).

❗ Current head 3702bba differs from pull request most recent head 012f2d0. Consider uploading reports for the commit 012f2d0 to get more accurate results

Files	Patch %	Lines
src/router/controller/params/decorators.ts	69.81%	16 Missing ⚠️
src/router/websocket/router.ts	95.03%	8 Missing ⚠️

❗ Your organization needs to install the Codecov GitHub app to enable full functionality.

Additional details and impacted files

@@            Coverage Diff             @@
##             main      #82      +/-   ##
==========================================
+ Coverage   88.39%   88.96%   +0.57%     
==========================================
  Files          63       66       +3     
  Lines        1904     2103     +199     
  Branches      196      212      +16     
==========================================
+ Hits         1683     1871     +188     
- Misses        218      229      +11     
  Partials        3        3              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[marco-souza]

Great job! 🚀

I found one minor, but we can fix it in the upcoming PRs 👍

[marco-souza]

minor, we can fix it later

Suggested change

	): Response | undefined | { topic: string; data: unknown } {
	): Response | undefined | WebSocketPayload {