// The `wasi:http/incoming-handler` interface is meant to be exported by
// components and called by the host in response to a new incoming HTTP
// response.
//
// NOTE: in Preview3, this interface will be merged with
// `wasi:http/outgoing-handler` into a single `wasi:http/handler` interface
// that takes a `request` parameter and returns a `response` result.
//
default interface incoming-handler {
use pkg.types.{incoming-request, response-outparam}
// The `handle` function takes an outparam instead of returning its response
// so that the component may stream its response while streaming any other
// request or response bodies. The callee MUST write a response to the
// `response-out` and then finish the response before returning. The caller
// is expected to start streaming the response once `set-response-outparam`
// is called and finish streaming the response when `drop-response-outparam`
// is called. The `handle` function is then allowed to continue executing
// any post-response logic before returning. While this post-response
// execution is taken off the critical path, since there is no return value,
// there is no way to report its success or failure.
handle: func(
request: incoming-request,
response-out: response-outparam
)
}