chore(contract): sync flipcash2 protos to 3bb442d

CHANGELOG.md

@@ -8,6 +8,30 @@ called out explicitly even when nothing else did.
 release notes, so a version with no entry here does not release. Write the entry in the same PR that
 syncs the contract, while the diff is still in front of you.
 
+## 0.17.0
+
+Synced to [`flipcash2-protobuf-api@3bb442d3`](https://github.com/code-payments/flipcash2-protobuf-api/commit/3bb442d359dd8452b4e3eca5f5c1ca463e7f5a4b),
+picking up [#134](https://github.com/code-payments/flipcash2-protobuf-api/pull/134). Only `chat.v1`
+moved.
+
+### Added
+
+- Group descriptions, up to 160 characters and moderated like the title.
+  - `chat.v1.Metadata.description` (= 16).
+  - Set at creation through `description` on `PublicGroupChatParameters` (= 4) and
+    `PrivateGroupChatParameters` (= 3). Optional; empty sets none.
+  - Changed through `EditChatRequest.description` (= 4), a `Description { value }` wrapper: unset
+    leaves the description alone, and a set wrapper with an empty `value` clears it.
+  - Announced as `MetadataUpdate.DescriptionChanged` (= 6, `new_description`).
+- `DESCRIPTION_MODERATED` on `StartChatResponse.Result` (= 6) and `EditChatResponse.Result` (= 5).
+  The response's `flagged_category` is set for it, as it is for `TITLE_MODERATED`.
+
+### Upgrading
+
+Nothing existing changed: no renames, and no field or enum renumbering. Both new result cases come
+after the existing ones. A client that ignores `description` keeps working, but one with an
+exhaustive `MetadataUpdate` switch needs a `DescriptionChanged` case.
+
 ## 0.16.0
 
 Synced to [`flipcash2-protobuf-api@ec66e6b1`](https://github.com/code-payments/flipcash2-protobuf-api/commit/ec66e6b12c59d7eae3281341e74fe8853c90a306),

Sources/Flipcash2ClientProtocol/ContractInfo.swift

@@ -1,8 +1,8 @@
 // Generated by scripts/generate-swift.sh. Do not edit.
 
 public enum Flipcash2ContractInfo {
-    public static let version = "0.16.0-dev"
-    public static let protoCommit = "ec66e6b12c59d7eae3281341e74fe8853c90a306"
+    public static let version = "0.17.0-dev"
+    public static let protoCommit = "3bb442d359dd8452b4e3eca5f5c1ca463e7f5a4b"
 
     public static var isLocal: Bool { protoCommit == localSentinel }
 

Sources/Flipcash2ClientProtocol/chat_v1_chat_service.grpc.swift

@@ -578,8 +578,8 @@ extension Flipcash_Chat_V1_Chat {
         /// > 
         /// > Only a group chat may be edited, and only by a member the server permits
         /// > to edit it, as reported by ViewerState.Permissions.can_edit; anyone else
-        /// > is DENIED. A new title is moderated like
-        /// > StartChat's. A new picture is a blob the caller has already uploaded via
+        /// > is DENIED. A new title or description is moderated like StartChat's. A
+        /// > new picture is a blob the caller has already uploaded via
         /// > BlobStorage: the client uploads only the ORIGINAL and passes the
         /// > resulting BlobId once the blob is READY, and the server derives the
         /// > remaining renditions. Setting a field to the value the chat already has
@@ -588,7 +588,8 @@ extension Flipcash_Chat_V1_Chat {
         /// > 
         /// > Every real change reaches the chat's members, including the caller's
         /// > other devices, on the event stream as one MetadataUpdate per field
-        /// > changed: TitleChanged for the title, PictureChanged for the picture.
+        /// > changed: TitleChanged for the title, PictureChanged for the picture,
+        /// > DescriptionChanged for the description.
         ///
         /// - Parameters:
         ///   - request: A request containing a single `Flipcash_Chat_V1_EditChatRequest` message.
@@ -1320,8 +1321,8 @@ extension Flipcash_Chat_V1_Chat {
         /// > 
         /// > Only a group chat may be edited, and only by a member the server permits
         /// > to edit it, as reported by ViewerState.Permissions.can_edit; anyone else
-        /// > is DENIED. A new title is moderated like
-        /// > StartChat's. A new picture is a blob the caller has already uploaded via
+        /// > is DENIED. A new title or description is moderated like StartChat's. A
+        /// > new picture is a blob the caller has already uploaded via
         /// > BlobStorage: the client uploads only the ORIGINAL and passes the
         /// > resulting BlobId once the blob is READY, and the server derives the
         /// > remaining renditions. Setting a field to the value the chat already has
@@ -1330,7 +1331,8 @@ extension Flipcash_Chat_V1_Chat {
         /// > 
         /// > Every real change reaches the chat's members, including the caller's
         /// > other devices, on the event stream as one MetadataUpdate per field
-        /// > changed: TitleChanged for the title, PictureChanged for the picture.
+        /// > changed: TitleChanged for the title, PictureChanged for the picture,
+        /// > DescriptionChanged for the description.
         ///
         /// - Parameters:
         ///   - request: A request containing a single `Flipcash_Chat_V1_EditChatRequest` message.
@@ -2120,8 +2122,8 @@ extension Flipcash_Chat_V1_Chat.ClientProtocol {
     /// > 
     /// > Only a group chat may be edited, and only by a member the server permits
     /// > to edit it, as reported by ViewerState.Permissions.can_edit; anyone else
-    /// > is DENIED. A new title is moderated like
-    /// > StartChat's. A new picture is a blob the caller has already uploaded via
+    /// > is DENIED. A new title or description is moderated like StartChat's. A
+    /// > new picture is a blob the caller has already uploaded via
     /// > BlobStorage: the client uploads only the ORIGINAL and passes the
     /// > resulting BlobId once the blob is READY, and the server derives the
     /// > remaining renditions. Setting a field to the value the chat already has
@@ -2130,7 +2132,8 @@ extension Flipcash_Chat_V1_Chat.ClientProtocol {
     /// > 
     /// > Every real change reaches the chat's members, including the caller's
     /// > other devices, on the event stream as one MetadataUpdate per field
-    /// > changed: TitleChanged for the title, PictureChanged for the picture.
+    /// > changed: TitleChanged for the title, PictureChanged for the picture,
+    /// > DescriptionChanged for the description.
     ///
     /// - Parameters:
     ///   - request: A request containing a single `Flipcash_Chat_V1_EditChatRequest` message.
@@ -2901,8 +2904,8 @@ extension Flipcash_Chat_V1_Chat.ClientProtocol {
     /// > 
     /// > Only a group chat may be edited, and only by a member the server permits
     /// > to edit it, as reported by ViewerState.Permissions.can_edit; anyone else
-    /// > is DENIED. A new title is moderated like
-    /// > StartChat's. A new picture is a blob the caller has already uploaded via
+    /// > is DENIED. A new title or description is moderated like StartChat's. A
+    /// > new picture is a blob the caller has already uploaded via
     /// > BlobStorage: the client uploads only the ORIGINAL and passes the
     /// > resulting BlobId once the blob is READY, and the server derives the
     /// > remaining renditions. Setting a field to the value the chat already has
@@ -2911,7 +2914,8 @@ extension Flipcash_Chat_V1_Chat.ClientProtocol {
     /// > 
     /// > Every real change reaches the chat's members, including the caller's
     /// > other devices, on the event stream as one MetadataUpdate per field
-    /// > changed: TitleChanged for the title, PictureChanged for the picture.
+    /// > changed: TitleChanged for the title, PictureChanged for the picture,
+    /// > DescriptionChanged for the description.
     ///
     /// - Parameters:
     ///   - message: request message to send.