pluginsdk/abi/proto/v1/http.proto

// http.proto — buffered HTTP request/response payloads for the HANDLE_HTTP
// hook (WO-WZ-001).
//
// v1 buffers full bodies: no streaming, SSE, or WebSockets inside plugins
// (per the wasm migration design spec §5). The guest runs its real
// chi/connect mux internally and answers one HttpRequest with one
// HttpResponse.

syntax = "proto3";

package abi.v1;

option go_package = "git.dev.alexdunmow.com/block/pluginsdk/abi/v1;abiv1";

// HttpRequest is a fully buffered HTTP request forwarded to the guest mux.
message HttpRequest {
  string method = 1;
  // Request path (no scheme/host/query).
  string path = 2;
  // Raw query string (without the leading '?').
  string raw_query = 3;
  // Canonical header name → values.
  map<string, HeaderValues> headers = 4;
  bytes body = 5;
}

// HeaderValues holds the values of one multi-valued HTTP header.
message HeaderValues {
  repeated string values = 1;
}

// HttpResponse is the guest's fully buffered response.
message HttpResponse {
  int32 status = 1;
  map<string, HeaderValues> headers = 2;
  bytes body = 3;
}