feat: new bertychat service (protobuf + go)

api/bertychat.proto

@@ -0,0 +1,44 @@
+syntax = "proto3";
+
+package berty.chat;
+
+import "github.com/gogo/protobuf/gogoproto/gogo.proto";
+//import "bertytypes.proto";
+
+option go_package = "berty.tech/berty/go/pkg/bertychat";
+
+// ChatService is the top-level API that uses the Berty Protocol to implement the Berty Chat specific logic.
+// Today, most of the Berty Chat logic is implemented directly in the application (see the /js folder of this repo).
+service ChatService {
+  // InstanceShareableBertyID returns a Berty ID that can be shared as a string, QR code or deep link.
+  rpc InstanceShareableBertyID(InstanceShareableBertyID.Request) returns (InstanceShareableBertyID.Reply);
+
+  // DevShareInstanceBertyID shares your Berty ID on a dev channel.
+  // TODO: remove for public.
+  rpc DevShareInstanceBertyID(DevShareInstanceBertyID.Request) returns (DevShareInstanceBertyID.Reply);
+}
+
+message InstanceShareableBertyID {
+  message Request {
+    // reset will regenerate a new link
+    bool reset = 1;
+
+    string display_name = 2;
+  }
+  message Reply {
+    string berty_id = 1 [(gogoproto.customname) = "BertyID"];
+    string deep_link = 2 [(gogoproto.customname) = "DeepLink"];
+    string html_url = 3 [(gogoproto.customname) = "HTMLURL"];
+    string display_name = 4;
+  }
+}
+
+message DevShareInstanceBertyID {
+  message Request {
+    // reset will regenerate a new link
+    bool reset = 1;
+
+    string display_name = 2;
+  }
+  message Reply {}
+}

docs/Makefile

@@ -33,8 +33,10 @@ PROTOC_OPTS = -I ../vendor/github.com/grpc-ecosystem/grpc-gateway:../api:../vend
 .PHONY: generate_local
 generate_local:
 	protoc $(PROTOC_OPTS) --doc_out=./protocol --doc_opt=markdown,api.md.tmp ../api/bertyprotocol.proto ../api/bertytypes.proto
+	protoc $(PROTOC_OPTS) --doc_out=./chat --doc_opt=markdown,api.md.tmp ../api/bertychat.proto
 	@# repace multiple empty lines with one
 	cat protocol/api.md.tmp | sed '/^$$/N;/^\n$$/D' > protocol/api.md
+	cat chat/api.md.tmp | sed '/^$$/N;/^\n$$/D' > chat/api.md
 	rm -f */*.md.tmp
 	shasum $(GEN_SRC) | sort -k 2 > $(GEN_SUM).tmp
 	mv $(GEN_SUM).tmp $(GEN_SUM)