Summary

This PR adds the functionality to register middleware and to compose mutliple middlewares to create reusable middleware stacks.

Note: currently there is no way to alter the response inside a middleware function, this will be done in the next PR.

Changes

1. Middleware Composition Logic (src/rest/utils.ts)

• Implemented composeMiddleware() function for chaining middleware execution
• Added protection against multiple next() calls
• Supports middleware short-circuiting by returning responses

2. Router Integration (src/rest/BaseRouter.ts)

• Added use() method for middleware registration
• Updated resolve() method to execute middleware chain before route handlers
• Proper scope binding for class-based handlers

3. Added unit tests (tests/unit/rest/BaseRouter.test.ts)

• Execution Order: Middleware runs before handlers in registration order
• Short-circuiting: Middleware can return responses to bypass remaining chain
• Parameter Passing: Route params and request options passed correctly
• Error Handling: Errors in middleware before/after next() and in handlers
• Edge Cases: Multiple next() calls, middleware not calling next()
• Response Types: Support for both Response objects and JSON objects
• Class Decorators: Integration with class-based handlers preserving this scope

Issue number: closes #4427

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

Disclaimer: We value your time and bandwidth. As such, any pull requests created on non-triaged issues might not be successful.