wip: pagination concept

Author: markharding

protos/polycentric/v2/common.proto

@@ -0,0 +1,9 @@
+syntax = "proto3";
+package polycentric.v2;
+
+message PageInfo {
+  string end_cursor = 1;
+  bool has_next_page = 2;
+  bool has_previous_page = 3;
+  string start_cursor = 4;
+}

protos/polycentric/v2/notifications.proto

@@ -1,8 +1,32 @@
 syntax = "proto3";
 package polycentric.v2;
 
+import "polycentric/v2/common.proto";
+import "polycentric/v2/events.proto";
 import "polycentric/v2/server.proto";
 
+message Notification {
+  // Event that triggered the notification
+  EventBundle trigger_event = 1;
+  // Event that the notification is in relation to
+  EventBundle subject_event = 2;
+}
+
+message GetNotificationsRequest {
+  string identity = 1;
+  // Return the 1 X number of notifications
+  optional uint32 first = 2;
+  // Return notifications after a cursor
+  optional string after = 3;
+}
+
+message GetNotificationsResponse {
+  repeated Notification notification = 1;
+  // Events that help the client resolve with fewer network calls
+  repeated EventHint event_hints = 2;
+  PageInfo page_info = 3;
+}
+
 message RegisterPushNotificationRequest {
   string service = 1;
   string token = 2;
@@ -26,4 +50,4 @@ service NotificationService {
 
   // This endpoint expects a signed UnregisterPushNotificationRequest message
   rpc UnregisterPushNotifications(SignedMessage) returns (UnregisterPushNotificationResponse);
-}
+}