service-chat.proto

syntax = "proto3";
package spec;


service ChatService {

    // returns a response header "x-token" to authorize Post() calls.
    // streams all chat messages.
    rpc Join (JoinRequest) returns (stream ChatEvent);

    // post a message to the chat.
    // must set "x-token" request header obtained from Join().
    rpc Post (PostRequest) returns (PostResponse);
}

message JoinRequest {
    string username = 1;
}

message ChatEvent {
    string username = 1;
    oneof event {
        string joined = 2;
        string message = 3;
        string left = 4;
    }
}

message PostRequest {
    string message = 1;
}

message PostResponse {
}