fix(koa)!: use generic config hook types and move dep to dev

[blumamir]

fixes #2228

This PR aims to remove the instrumentation package dependency on the koa types packages, by making the relevant types generic and defaulting to any. That allows users who choose to implement the hook, to either use type any, or install the relevant types packages and populate the generic parameters.

• moved koa types packages to dev dependency instead of regular dependency
• documented how to use in README
• updated tests to verify it compiles correctly when used in recommended way
• compiled the new code and verified that d.ts files transitively imported from index.d.ts do not import types from @types/koa, @types/koa__router or any other dev dependency

Breaking Change

• this PR makes it so that KoaContext is no longer exported as public type from the package
• some hook info properties type will change to any by default, which should not break anyone I believe, but will no not verified this variable typing as before.

Prior Art

defaults to any and allow to use generics to type correctly:

• express instrumentation see concensus here

vendors part of the type as default, but allows to specify the full type when desired:

• kafkajs
• undici

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 90.30%. Comparing base (dfb2dff) to head (faa5cdd).
Report is 174 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #2303      +/-   ##
==========================================
- Coverage   90.97%   90.30%   -0.68%     
==========================================
  Files         146      147       +1     
  Lines        7492     7263     -229     
  Branches     1502     1509       +7     
==========================================
- Hits         6816     6559     -257     
- Misses        676      704      +28     

Files	Coverage Δ
...lemetry-instrumentation-koa/src/instrumentation.ts	95.29% <100.00%> (-0.11%)	⬇️
...elemetry-instrumentation-koa/src/internal-types.ts	100.00% <ø> (ø)
...ode/opentelemetry-instrumentation-koa/src/types.ts	100.00% <ø> (ø)
...ode/opentelemetry-instrumentation-koa/src/utils.ts	100.00% <100.00%> (ø)

... and 58 files with indirect coverage changes

[pichlermarc]

Looks great, thanks 👍
Another instrumentation that had the instrumented package's types part of their public interface crossed of the list 🙂