@juzi/wechaty-grpc 1.0.11 → 1.0.12

package/dist/cjs/out/wechaty/puppet.swagger.json

@@ -3,7 +3,7 @@
   "info": {
     "title": "Wechaty Puppet Service OpenAPI Specification",
     "description": "Wechaty is a Conversational RPA SDK for chatbot makers. With only 6 lines of code, you can create a bot on the most popular IMs like WeChat, Whatsapp, WeCom, Gitter, etc.\n\nWechaty Puppet Service is the RESTful API for Wechaty API, which is build on top of the Wechaty Puppet Abstraction and the gRPC proto definition.",
-    "version": "1.0.11",
+    "version": "1.0.12",
     "contact": {
       "name": "Wechaty",
       "url": "https://github.com/wechaty/openapi",
@@ -303,88 +303,6 @@
         ]
       }
     },
-    "/contacts/{contactId}/tag/tags/{tagId}": {
-      "delete": {
-        "operationId": "Puppet_TagContactTagRemove",
-        "responses": {
-          "200": {
-            "description": "A successful response.",
-            "schema": {
-              "$ref": "#/definitions/puppetTagContactTagRemoveResponse"
-            }
-          },
-          "default": {
-            "description": "An unexpected error response.",
-            "schema": {
-              "$ref": "#/definitions/rpcStatus"
-            }
-          }
-        },
-        "parameters": [
-          {
-            "name": "contactId",
-            "in": "path",
-            "required": true,
-            "type": "string"
-          },
-          {
-            "name": "tagId",
-            "in": "path",
-            "required": true,
-            "type": "string"
-          },
-          {
-            "name": "tagGroupId",
-            "in": "query",
-            "required": false,
-            "type": "string"
-          }
-        ],
-        "tags": [
-          "Puppet"
-        ]
-      },
-      "put": {
-        "operationId": "Puppet_TagContactTagAdd",
-        "responses": {
-          "200": {
-            "description": "A successful response.",
-            "schema": {
-              "$ref": "#/definitions/puppetTagContactTagAddResponse"
-            }
-          },
-          "default": {
-            "description": "An unexpected error response.",
-            "schema": {
-              "$ref": "#/definitions/rpcStatus"
-            }
-          }
-        },
-        "parameters": [
-          {
-            "name": "contactId",
-            "in": "path",
-            "required": true,
-            "type": "string"
-          },
-          {
-            "name": "tagId",
-            "in": "path",
-            "required": true,
-            "type": "string"
-          },
-          {
-            "name": "tagGroupId",
-            "in": "query",
-            "required": false,
-            "type": "string"
-          }
-        ],
-        "tags": [
-          "Puppet"
-        ]
-      }
-    },
     "/contacts/{id}": {
       "get": {
         "summary": "Get a contact payload",
@@ -2029,6 +1947,16 @@
             "in": "path",
             "required": true,
             "type": "string"
+          },
+          {
+            "name": "contactIds",
+            "in": "query",
+            "required": false,
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "collectionFormat": "multi"
           }
         ],
         "tags": [
@@ -2222,14 +2150,14 @@
         ]
       }
     },
-    "/tag/groups": {
-      "get": {
-        "operationId": "Puppet_TagGroupList",
+    "/tag/add": {
+      "post": {
+        "operationId": "Puppet_TagTagAdd",
         "responses": {
           "200": {
             "description": "A successful response.",
             "schema": {
-              "$ref": "#/definitions/puppetTagGroupListResponse"
+              "$ref": "#/definitions/puppetTagTagAddResponse"
             }
           },
           "default": {
@@ -2239,19 +2167,29 @@
             }
           }
         },
+        "parameters": [
+          {
+            "name": "body",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/puppetTagTagAddRequest"
+            }
+          }
+        ],
         "tags": [
           "Puppet"
         ]
       }
     },
-    "/tag/groups/{tagGroupId}/tags": {
-      "get": {
-        "operationId": "Puppet_TagGroupTagList",
+    "/tag/addContactTag": {
+      "post": {
+        "operationId": "Puppet_TagContactTagAdd",
         "responses": {
           "200": {
             "description": "A successful response.",
             "schema": {
-              "$ref": "#/definitions/puppetTagGroupTagListResponse"
+              "$ref": "#/definitions/puppetTagContactTagAddResponse"
             }
           },
           "default": {
@@ -2263,10 +2201,12 @@
         },
         "parameters": [
           {
-            "name": "tagGroupId",
-            "in": "path",
+            "name": "body",
+            "in": "body",
             "required": true,
-            "type": "string"
+            "schema": {
+              "$ref": "#/definitions/puppetTagContactTagAddRequest"
+            }
           }
         ],
         "tags": [
@@ -2274,14 +2214,14 @@
         ]
       }
     },
-    "/tag/tags": {
-      "get": {
-        "operationId": "Puppet_TagTagList",
+    "/tag/delete": {
+      "post": {
+        "operationId": "Puppet_TagTagDelete",
         "responses": {
           "200": {
             "description": "A successful response.",
             "schema": {
-              "$ref": "#/definitions/puppetTagTagListResponse"
+              "$ref": "#/definitions/puppetTagTagDeleteResponse"
             }
           },
           "default": {
@@ -2291,19 +2231,29 @@
             }
           }
         },
+        "parameters": [
+          {
+            "name": "body",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/puppetTagTagDeleteRequest"
+            }
+          }
+        ],
         "tags": [
           "Puppet"
         ]
       }
     },
-    "/tag/{tagGroupId}/{tagId}/contacts": {
+    "/tag/groups/{tagGroupId}/tags": {
       "get": {
-        "operationId": "Puppet_TagTagContactList",
+        "operationId": "Puppet_TagGroupTagList",
         "responses": {
           "200": {
             "description": "A successful response.",
             "schema": {
-              "$ref": "#/definitions/puppetTagTagContactListResponse"
+              "$ref": "#/definitions/puppetTagGroupTagListResponse"
             }
           },
           "default": {
@@ -2319,12 +2269,6 @@
             "in": "path",
             "required": true,
             "type": "string"
-          },
-          {
-            "name": "tagId",
-            "in": "path",
-            "required": true,
-            "type": "string"
           }
         ],
         "tags": [
@@ -2332,14 +2276,36 @@
         ]
       }
     },
-    "/tags/groups/{tagGroupId}": {
-      "delete": {
-        "operationId": "Puppet_TagGroupDelete",
+    "/tag/list": {
+      "get": {
+        "operationId": "Puppet_TagTagList",
         "responses": {
           "200": {
             "description": "A successful response.",
             "schema": {
-              "$ref": "#/definitions/puppetTagGroupDeleteResponse"
+              "$ref": "#/definitions/puppetTagTagListResponse"
+            }
+          },
+          "default": {
+            "description": "An unexpected error response.",
+            "schema": {
+              "$ref": "#/definitions/rpcStatus"
+            }
+          }
+        },
+        "tags": [
+          "Puppet"
+        ]
+      }
+    },
+    "/tag/removeContactTag": {
+      "post": {
+        "operationId": "Puppet_TagContactTagRemove",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/puppetTagContactTagRemoveResponse"
             }
           },
           "default": {
@@ -2351,10 +2317,12 @@
         },
         "parameters": [
           {
-            "name": "tagGroupId",
-            "in": "path",
+            "name": "body",
+            "in": "body",
             "required": true,
-            "type": "string"
+            "schema": {
+              "$ref": "#/definitions/puppetTagContactTagRemoveRequest"
+            }
           }
         ],
         "tags": [
@@ -2362,14 +2330,14 @@
         ]
       }
     },
-    "/tags/groups/{tagGroupId}/tags/{tagId}": {
-      "delete": {
-        "operationId": "Puppet_TagTagDelete",
+    "/tag/{tag.groupId}/{tag.id}/contacts": {
+      "get": {
+        "operationId": "Puppet_TagTagContactList",
         "responses": {
           "200": {
             "description": "A successful response.",
             "schema": {
-              "$ref": "#/definitions/puppetTagTagDeleteResponse"
+              "$ref": "#/definitions/puppetTagTagContactListResponse"
             }
           },
           "default": {
@@ -2381,13 +2349,13 @@
         },
         "parameters": [
           {
-            "name": "tagGroupId",
+            "name": "tag.groupId",
             "in": "path",
             "required": true,
             "type": "string"
           },
           {
-            "name": "tagId",
+            "name": "tag.id",
             "in": "path",
             "required": true,
             "type": "string"
@@ -2398,14 +2366,14 @@
         ]
       }
     },
-    "/tags/groups/{tagGroupId}/tags/{tagName}": {
-      "put": {
-        "operationId": "Puppet_TagTagAdd",
+    "/tagGroup/add": {
+      "post": {
+        "operationId": "Puppet_TagGroupAdd",
         "responses": {
           "200": {
             "description": "A successful response.",
             "schema": {
-              "$ref": "#/definitions/puppetTagTagAddResponse"
+              "$ref": "#/definitions/puppetTagGroupAddResponse"
             }
           },
           "default": {
@@ -2417,16 +2385,12 @@
         },
         "parameters": [
           {
-            "name": "tagGroupId",
-            "in": "path",
-            "required": true,
-            "type": "string"
-          },
-          {
-            "name": "tagName",
-            "in": "path",
+            "name": "body",
+            "in": "body",
             "required": true,
-            "type": "string"
+            "schema": {
+              "$ref": "#/definitions/puppetTagGroupAddRequest"
+            }
           }
         ],
         "tags": [
@@ -2434,14 +2398,14 @@
         ]
       }
     },
-    "/tags/groups/{tagGroupName}": {
-      "put": {
-        "operationId": "Puppet_TagGroupAdd",
+    "/tagGroup/delete": {
+      "post": {
+        "operationId": "Puppet_TagGroupDelete",
         "responses": {
           "200": {
             "description": "A successful response.",
             "schema": {
-              "$ref": "#/definitions/puppetTagGroupAddResponse"
+              "$ref": "#/definitions/puppetTagGroupDeleteResponse"
             }
           },
           "default": {
@@ -2453,10 +2417,12 @@
         },
         "parameters": [
           {
-            "name": "tagGroupName",
-            "in": "path",
+            "name": "body",
+            "in": "body",
             "required": true,
-            "type": "string"
+            "schema": {
+              "$ref": "#/definitions/puppetTagGroupDeleteRequest"
+            }
           }
         ],
         "tags": [
@@ -2464,6 +2430,28 @@
         ]
       }
     },
+    "/tagGroup/list": {
+      "get": {
+        "operationId": "Puppet_TagGroupList",
+        "responses": {
+          "200": {
+            "description": "A successful response.",
+            "schema": {
+              "$ref": "#/definitions/puppetTagGroupListResponse"
+            }
+          },
+          "default": {
+            "description": "An unexpected error response.",
+            "schema": {
+              "$ref": "#/definitions/rpcStatus"
+            }
+          }
+        },
+        "tags": [
+          "Puppet"
+        ]
+      }
+    },
     "/upload": {
       "post": {
         "operationId": "Puppet_Upload",
@@ -3757,6 +3745,23 @@
     "puppetStopResponse": {
       "type": "object"
     },
+    "puppetTagContactTagAddRequest": {
+      "type": "object",
+      "properties": {
+        "tags": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/puppetTagIdentifier"
+          }
+        },
+        "contactIds": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
     "puppetTagContactTagAddResponse": {
       "type": "object"
     },
@@ -3771,9 +3776,34 @@
         }
       }
     },
+    "puppetTagContactTagRemoveRequest": {
+      "type": "object",
+      "properties": {
+        "tags": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/puppetTagIdentifier"
+          }
+        },
+        "contactIds": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
     "puppetTagContactTagRemoveResponse": {
       "type": "object"
     },
+    "puppetTagGroupAddRequest": {
+      "type": "object",
+      "properties": {
+        "tagGroupName": {
+          "type": "string"
+        }
+      }
+    },
     "puppetTagGroupAddResponse": {
       "type": "object",
       "properties": {
@@ -3782,6 +3812,14 @@
         }
       }
     },
+    "puppetTagGroupDeleteRequest": {
+      "type": "object",
+      "properties": {
+        "tagGroupId": {
+          "type": "string"
+        }
+      }
+    },
     "puppetTagGroupDeleteResponse": {
       "type": "object"
     },
@@ -3818,6 +3856,17 @@
         }
       }
     },
+    "puppetTagIdentifier": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "groupId": {
+          "type": "string"
+        }
+      }
+    },
     "puppetTagPayload": {
       "type": "object",
       "properties": {
@@ -3835,6 +3884,17 @@
         }
       }
     },
+    "puppetTagTagAddRequest": {
+      "type": "object",
+      "properties": {
+        "tagName": {
+          "type": "string"
+        },
+        "tagGroupId": {
+          "type": "string"
+        }
+      }
+    },
     "puppetTagTagAddResponse": {
       "type": "object",
       "properties": {
@@ -3854,6 +3914,14 @@
         }
       }
     },
+    "puppetTagTagDeleteRequest": {
+      "type": "object",
+      "properties": {
+        "tag": {
+          "$ref": "#/definitions/puppetTagIdentifier"
+        }
+      }
+    },
     "puppetTagTagDeleteResponse": {
       "type": "object"
     },

package/dist/cjs/proto/wechaty/puppet/room.proto

@@ -1,8 +1,8 @@
 syntax = "proto3";
 package wechaty.puppet;
 
-option go_package="github.com/wechaty/go-grpc/wechaty/puppet";
-option java_package="io.github.wechaty.grpc.puppet";
+option go_package       = "github.com/wechaty/go-grpc/wechaty/puppet";
+option java_package     = "io.github.wechaty.grpc.puppet";
 option csharp_namespace = "github.wechaty.grpc.puppet";
 
 import "google/protobuf/wrappers.proto";
@@ -27,8 +27,8 @@ message RoomPayloadResponse {
 }
 
 message RoomAddRequest {
-  string id = 1;
-  string contact_id = 2;
+  string id          = 1;
+  string contact_id  = 2;
   bool   invite_only = 3;
 }
 message RoomAddResponse {}
@@ -42,15 +42,16 @@ message RoomAvatarResponse {
 
 message RoomCreateRequest {
   repeated string contact_ids = 1;
-  string topic = 2;
+  string   topic              = 2;
 }
 message RoomCreateResponse {
   string id = 1;
 }
 
 message RoomDelRequest {
-  string id = 1;
-  string contact_id = 2;
+  string   id                 = 1;
+  string   contact_id         = 2 [deprecated = true]; // Deprecated, will be removed after bot updated
+  repeated string contact_ids = 3;
 }
 message RoomDelResponse {}
 
@@ -60,13 +61,13 @@ message RoomQuitRequest {
 message RoomQuitResponse {}
 
 message RoomTopicRequest {
-  string id = 1;
+  string                      id                            = 1;
   google.protobuf.StringValue topic_string_value_deprecated = 2 [deprecated = true];  // DEPRECATED, will be removed after Dec 31, 2022
-  optional string topic = 3;
+  optional                    string topic                  = 3;
 }
 message RoomTopicResponse {
   google.protobuf.StringValue topic_string_value_deprecated = 1 [deprecated = true];  // DEPRECATED, will be removed after Dec 31, 2022
-  string topic = 2;
+  string                      topic                         = 2;
 }
 
 message RoomQRCodeRequest {
@@ -77,12 +78,12 @@ message RoomQRCodeResponse {
 }
 
 message RoomAnnounceRequest {
-  string id = 1;
+  string                      id                           = 1;
   google.protobuf.StringValue text_string_value_deprecated = 2 [deprecated = true];  // DEPRECATED, will be removed after Dec 31, 2022
-  optional string text = 3;
+  optional                    string text                  = 3;
 }
 message RoomAnnounceResponse {
   google.protobuf.StringValue text_string_value_deprecated = 1 [deprecated = true];  // DEPRECATED, will be removed after Dec 31, 2022
-  string text = 2;
+  string                      text                         = 2;
 }
 

package/dist/cjs/proto/wechaty/puppet/tag.proto

@@ -17,24 +17,27 @@ message TagPayload {
   TagType type     = 4;
 }
 
+message TagIdentifier {
+  string id       = 1;
+  string group_id = 2;
+}
+
 message TagGroupPayload {
   string id   = 1;
   string name = 2;
 }
 
 message TagContactTagAddRequest {
-  string tag_group_id = 1;
-  string tag_id       = 2;
-  string contact_id        = 3;
+  repeated TagIdentifier tags = 1;
+  repeated string contact_ids = 2;
 }
 
 message TagContactTagAddResponse {
 }
 
 message TagContactTagRemoveRequest {
-  string tag_group_id = 1;
-  string tag_id       = 2;
-  string contact_id        = 3;
+  repeated TagIdentifier tags = 1;
+  repeated string contact_ids = 2;
 }
 
 message TagContactTagRemoveResponse {
@@ -56,8 +59,8 @@ message TagGroupDeleteResponse {
 }
 
 message TagTagAddRequest {
-  string tag_group_id = 1;
-  string tag_name     = 2;
+  string tag_name     = 1;
+  string tag_group_id = 2;
 }
 
 message TagTagAddResponse {
@@ -65,8 +68,7 @@ message TagTagAddResponse {
 }
 
 message TagTagDeleteRequest {
-  string tag_group_id = 1;
-  string tag_id       = 2;
+  TagIdentifier tag = 1;
 }
 
 message TagTagDeleteResponse {
@@ -103,8 +105,7 @@ message TagContactTagListResponse {
 }
 
 message TagTagContactListRequest {
-  string tag_group_id = 1;
-  string tag_id = 2;
+  TagIdentifier tag = 1;
 }
 
 message TagTagContactListResponse {