#shiguri-01/jsonrpc

#Install

moon add shiguri-01/jsonrpc

#Packages

• shiguri-01/jsonrpc: core endpoint
• shiguri-01/jsonrpc/session: optional transport-neutral session helper
• shiguri-01/jsonrpc/stdio: native-only stdin/stdout transport

#Core Endpoint

#Usage

///|
#warnings("-unnecessary_annotation")
struct EchoParams {
  message : String
} derive(FromJson)

///|
struct EchoResult {
  message : String
} derive(ToJson)

///|
#warnings("-unused_async-unused_error_type")
async fn echo(params : EchoParams) -> EchoResult raise @jsonrpc.RpcError {
  { message: params.message }
}

///|
/// Demonstrate building an endpoint and creating JSON-RPC documents.
pub async fn usage() -> Unit {
  let endpoint = @jsonrpc.EndpointBuilder()
    .handle("echo", @jsonrpc.typed(echo))
    .build()

  let received = endpoint.receive_text(
    (
      #|{"jsonrpc":"2.0","method":"echo","params":{"message":"hello"},"id":1}
    ),
  )

  let request = endpoint.request("workspace/configuration")

  let notification = endpoint.notify("window/logMessage", params=null)

  // In an application, write these JSON values to your transport.
  ignore(received)
  ignore(request)
  ignore(notification)
}

///|
struct Config {
  prefix : String
}

///|
#warnings("-unused_async")
async fn greet(config : Config, params : Json?) -> Json raise @jsonrpc.RpcError {
  guard params is Some(Object({ "name": String(name), .. })) else {
    raise @jsonrpc.invalid_params()
  }
  Json::string("\{config.prefix}, \{name}")
}

///|
/// Demonstrate capturing application configuration in a handler.
pub fn configured_usage() -> Unit raise @jsonrpc.EndpointError {
  let config : Config = { prefix: "hello" }

  let endpoint = @jsonrpc.EndpointBuilder()
    .handle("greet", async fn(params) -> Json raise @jsonrpc.RpcError {
      greet(config, params)
    })
    .build()

  // Reuse the endpoint from the transport loop that drives your application.
  ignore(endpoint)
}