lib/src/http/routing/Middleware.ts

import {AppClass} from "../../lifecycle/AppClass"
import {Request} from "../lifecycle/Request"
import {ResponseObject} from "./Route"

/**
 * Base class representing a middleware handler that can be applied to routes.
 */
export abstract class Middleware extends AppClass {
    constructor(
        /** The request that will be handled by this middleware. */
        protected readonly request: Request
    ) { super() }

    protected container() {
        return this.request
    }

    /**
     * Apply the middleware to the request.
     * If this returns a response factory or similar item, that will be sent
     * as a response.
     *
     * If this returns `void | Promise<void>`, the request will continue to the
     * next handler.
     */
    public abstract apply(): ResponseObject
}