✨ feat(event-handlers): add support for custom suspending event handlers in Velocity

[twisti-dev]

This pull request introduces support for custom suspending event handler adapters for the Velocity platform, along with an update to dependencies and the project version. The main changes involve adding reflection-based integration with Velocity internals, refactoring the event handler registration to use this new mechanism, and updating build configuration to include the necessary dependencies.

Velocity suspending event handler support:

• Added VelocityEventManagerReflection, a utility class using reflection to access and create custom handler adapters in Velocity's event system.
• Refactored SuspendingEventHandler to use VelocityEventManagerReflection for registering a custom handler adapter, enabling support for suspending (Kotlin coroutine) event handlers. The registration logic and validation were updated accordingly.

Dependency and build configuration updates:

• Added velocity-proxy-ctd to the dependencies for accessing Velocity internals, and updated surf-api-velocity-server to use it as a compileOnly dependency. [1] [2]
• Bumped project version from 3.9.4 to 3.9.5 in gradle.properties.

[Copilot]

Pull request overview

Adds Velocity support for coroutine-based (suspend) event handlers by registering a custom CustomHandlerAdapter into Velocity’s internal VelocityEventManager via MethodHandles-based reflection. Also updates the Velocity server module’s dependencies and bumps the project version.

Changes:

• Introduces VelocityEventManagerReflection to access handlerAdapters and construct CustomHandlerAdapter reflectively.
• Refactors SuspendingEventHandler to register the new adapter and detect suspend handlers without kotlin-reflect.
• Adds a compileOnly dependency on velocity-proxy-ctd and bumps the root version to 3.9.5.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
surf-api-velocity/surf-api-velocity-server/src/main/kotlin/dev/slne/surf/api/velocity/server/SuspendingEventHandler.kt	Registers a custom suspending handler adapter into Velocity’s event manager using the new reflection helper.
surf-api-velocity/surf-api-velocity-server/src/main/java/dev/slne/surf/api/velocity/server/reflection/VelocityEventManagerReflection.java	New reflection utility to access Velocity internals (field + constructor) via VarHandle/MethodHandle.
surf-api-velocity/surf-api-velocity-server/build.gradle.kts	Adds velocity-proxy-ctd as compileOnly to compile against Velocity internals.
gradle/libs.versions.toml	Adds version-catalog alias for velocity-proxy-ctd.
gradle.properties	Bumps project version from 3.9.4 to 3.9.5.