vyrn
Menu
SourceCopy page
▾
Copy pageMarkdown, ready to paste into an LLMView as MarkdownThis page as plain textOpen in ClaudeAsk Claude about this page

std/connect

2 exports, from std/connect.vyrn.

Connect wire compatibility as a library, built on generator imports. connectServer emits the connectHandle router and connectClient the in-Vyrn caller, for Connect's unary JSON flavor over HTTP/1 only: no gRPC, streaming, GET flavor or compression.

POST /<Service>.<Procedure>
content-type: application/json
errors: {"code": "...", "message": "...", "details": [...]}

Wire semantics:

  • success: 200, body toJson(result);
  • a fromJson failure: 400, code: "invalid_argument", every Issue in details;
  • an unknown procedure under the service prefix: 501 unimplemented;
  • a known procedure with a non-POST method: 405, as std/rpc does;
  • an Err from a Result procedure: 200 with the encoded value.

Dependencies

The import graph shows the whole library.

Imported by
no other std module

connectServer fn

std/connect.vyrn, line 162
gen fn connectServer(contract: String) -> String

Emits a module exposing connectHandle(req: Request) -> Option<Response>. The generator and its module link into one flat namespace, so the generator cannot itself be named connectHandle (as rpcServer emits rpcHandle).

connectClient fn

std/connect.vyrn, line 234
gen fn connectClient(contract: String) -> String

Emits the client: the contract's type declarations, one stub per procedure over one vyrnConnectCall extern, and one completion per procedure. The user writes only fn onGetBook(id: Int64, res: Validation<T>).

Tests

2 test blocks in std/connect.vyrn. CI runs all of them.

Test names
  • connectServiceName strips the path and the .vyrn suffix
  • connectCapFirst uppercases only the first ASCII byte

Examples

1 program in examples/ import this module. Each runs as WebAssembly and as a native binary.