nupp.runtime.services.http

High-level HTTP provider contract for host.http API 1.

Import service for setup before requiring nupp.io.http. Provider functions have no implicit receiver; Client and Response methods do. Request, Options, Version, and Capabilities come from nupp.io.http.messages, URI from nupp.io.uri, and Body is the canonical nupp.io Reader interface.

A Client owns its transport and outstanding work. A successful send returns an affine Response owning the response resources and body reader. Preserve borrowing of the Request during send and exclusive access during flush. Closing clients and responses must release resources on success, error, and cancellation paths. Implementers must not replace these affine contracts with unowned table aliases.

Capabilities describe actual behavior, including streaming, policy control, and protocol observability. Unsupported options must follow the public HTTP API's error behavior. The facade selects the implementation at require-time; clients and resource methods retain direct provider operations.

type Body = ResponseBody

affine interface Client is nupp.Closeable
    readonly flush: function(exclusive self: Client): nil
    readonly pending: function(self: Client): integer
    readonly send: function(self: Client, borrows request: Request): (Response?, string?)
end

flush: function(exclusive self: Client): nil

pending: function(self: Client): integer

send: function(self: Client, borrows request: Request): (Response?, string?)

interface Provider
    readonly client: function(options: Options?): Client
    readonly capabilities: function(): Capabilities
end

client: function(options: Options?): Client

capabilities: function(): Capabilities

affine interface Response is nupp.Closeable
    readonly status: integer
    readonly version: Version?
    readonly url: URI
    readonly body: Body
    readonly ok: function(self: Response): boolean
    readonly header: function(self: Response, name: string): string?
    readonly getAll: function(self: Response, name: string): {string}
    readonly headers: function(self: Response): {[string]: string}
end

ok: function(self: Response): boolean

header: function(self: Response, name: string): string?

getAll: function(self: Response, name: string): {string}

headers: function(self: Response): {[string]: string}

status: integer

version: Version?

url: URI

body: Body

const service: services.Service<Provider>