Support middleware

[Kleidukos]

No description provided.

[Kleidukos]

@TristanCacqueray I'm having a hard finding an example of "usual" Servant setup to showcase how integrating with servant-effectful would look like. I'm blocked on the place that the natural transform would take. Do you have any idea how to showcase "this is what this usually looks like and this is what it will look like"?

[TristanCacqueray]

@Kleidukos I'm not entirely sure what you mean by natural transform, but I would show a named route api implemented with a reader and logger effects. Then we could demonstrate how to serve it along with a basic health-check middleware?

[Kleidukos]

@TristanCacqueray "natural transform" or "nt" is the term used by Servant to talk about the operation that turns your domain monad (custom reader, etc) back to a Handler monad. See https://docs.servant.dev/en/stable/cookbook/using-custom-monad/UsingCustomMonad.html for instance.

For instance, this function runHoogle is used with genericServeTWithContext (https://git.mangoiv.com/mangoiv/modern-hoogle/src/branch/main/src/Hoogle/Modern.hs#L25-L28)

It's roughly the function where you execute your effects: https://github.com/flora-pm/flora-server/blob/development/src/web/FloraWeb/Server.hs#L207-L228 that serveTWithContext accepts