ccn/Services/Website/Sources/Library/Public/Controllers/RootController.swift

import Hummingbird
import HummingbirdElementary

/// Serves the website's root routes.
///
/// The controller exposes its routes as a `RouteCollection` so they can be added to a router
/// (or a sub-group) by the application that composes it:
///
/// ```swift
/// router.addRoutes(RootController<AppRequestContext>().routes)
/// ```
///
/// - Note: `Context` is the request context the routes are resolved against, and must match the
///   context of the router the routes are added to.
public struct RootController<Context: RequestContext> : Sendable{

    // MARK: Initializers

    /// Creates a root controller.
    public init() {}

    // MARK: Properties

    /// The routes served by the controller.
    ///
    /// Serves a `GET` request for the root path (`/`) by rendering the ``IndexPage``.
    public var routes: RouteCollection<Context> {
        let routes = RouteCollection(context: Context.self)

        routes.get(
            .Root.index,
            use: index
        )

        return routes
    }

}

// MARK: - Helpers

private extension RootController {
    
    // MARK: Methods

    /// Handles a request for the landing page.
    /// - Parameters:
    ///   - request: the incoming request.
    ///   - context: the context the request is resolved against.
    /// - Returns: an HTML response that renders the ``IndexPage``.
    @Sendable
    func index(
        request: Request,
        context: some RequestContext
    ) -> HTMLResponse {
        .init {
            IndexPage()
        }
    }
    
}

// MARK: - Constants

extension RouterPath {
    /// A namespace for the ``RootController`` route paths.
    enum Root {
        /// The path of the landing page.
        static let index: RouterPath = "/"
    }
}