feat: Auto generate swagger docs

[codekeyz]

[codecov-commenter]

Codecov Report

Attention: Patch coverage is 21.65605% with 123 lines in your changes missing coverage. Please review.

Project coverage is 66.06%. Comparing base (fd75d39) to head (cd2bee0).

Files with missing lines	Patch %	Lines
packages/pharaoh/lib/src/_next/openapi.dart	0.00%	84 Missing :warning:
...ages/pharaoh/lib/src/_next/_router/definition.dart	17.39%	19 Missing :warning:
...ackages/pharaoh/lib/src/_next/_core/core_impl.dart	0.00%	15 Missing :warning:
...ackages/pharaoh/lib/src/_next/_core/reflector.dart	66.66%	3 Missing :warning:
packages/pharaoh/lib/src/_next/core.dart	90.90%	1 Missing :warning:
packages/pharaoh/lib/src/_next/router.dart	66.66%	1 Missing :warning:

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #136      +/-   ##
==========================================
- Coverage   70.87%   66.06%   -4.82%     
==========================================
  Files          43       44       +1     
  Lines        1528     1656     +128     
==========================================
+ Hits         1083     1094      +11     
- Misses        445      562     +117     

:umbrella: View full report in Codecov by Sentry.
:loudspeaker: Have feedback on the report? Share it here.

:rocket: New features to boost your workflow:

• :snowflake: Test Analytics: Detect flaky tests, report on failures, and find test suite problems.