Add AltURI, linkRichMenuToMultipleUsers & unlinkRichMenusFromMultipleUsers (#135)

* Add AltURI type

* Add linkRichMenuToMultipleUsers and unlinkRichMenusFromMultipleUsers

Author: SombreroElGringo

docs/api-reference/client.md

@@ -37,6 +37,8 @@ class Client {
   getRichMenuIdOfUser(userId: string): Promise<string>
   linkRichMenuToUser(userId: string, richMenuId: string): Promise<any>
   unlinkRichMenuFromUser(userId: string, richMenuId: string): Promise<any>
+  linkRichMenuToMultipleUsers(richMenuId: string, userIds: string[]): Promise<any>
+	unlinkRichMenusFromMultipleUsers(userIds: string[]): Promise<any>
   getRichMenuImage(richMenuId: string): Promise<Readable>
   setRichMenuImage(richMenuId: string, data: Buffer | Readable, contentType?: string): Promise<any>
   getRichMenuList(): Promise<Array<RichMenuResponse>>
@@ -309,6 +311,26 @@ The arguments are a user ID and a rich menu ID.
 client.unlinkRichMenuFromUser('user_id', 'rich_menu_id')
 ```
 
+#### `linkRichMenuToMultipleUsers(richMenuId: string, userIds: string[]): Promise<any>`
+
+	It corresponds to the [Link rich menu to multiple users](https://developers.line.biz/en/reference/messaging-api/#link-rich-menu-to-users) API.
+
+	The arguments are a richMenuId and a array of userIds.
+
+	``` js
+	client.linkRichMenuToMultipleUsers('rich_menu_id', ['user_id'])
+	```
+
+#### `unlinkRichMenusFromMultipleUsers(userIds: string[]): Promise<any>`
+
+	It corresponds to the [Unlink rich menus from multiple users](https://developers.line.biz/en/reference/messaging-api#unlink-rich-menu-from-users) API.
+
+	The argument is a array of userIds.
+
+	``` js
+	client.unlinkRichMenusFromMultipleUsers(['user_id'])
+	```
+
 #### `getRichMenuImage(richMenuId: string): Promise<Readable>`
 
 It corresponds to the [Download rich menu image](https://developers.line.me/en/docs/messaging-api/reference/#download-rich-menu-image) API.

lib/client.ts

@@ -169,6 +169,22 @@ export default class Client {
     return this.http.delete(`/user/${userId}/richmenu`);
   }
 
+  public linkRichMenuToMultipleUsers(
+    richMenuId: string,
+    userIds: string[],
+  ): Promise<any> {
+    return this.http.post("/richmenu/bulk/link", {
+      richMenuId,
+      userIds,
+    });
+  }
+
+  public unlinkRichMenusFromMultipleUsers(userIds: string[]): Promise<any> {
+    return this.http.post("/richmenu/bulk/unlink", {
+      userIds,
+    });
+  }
+
   public getRichMenuImage(richMenuId: string): Promise<Readable> {
     return this.http.getStream(`/richmenu/${richMenuId}/content`);
   }

lib/types.ts

@@ -1552,6 +1552,21 @@ export type URIAction = {
    * Must start with `http`, `https`, or `tel`.
    */
   uri: string;
+  altUri?: AltURI;
+};
+
+/**
+ * URI opened on LINE for macOS and Windows when the action is performed (Max: 1000 characters)
+ * If the altUri.desktop property is set, the uri property is ignored on LINE for macOS and Windows.
+ * The available schemes are http, https, line, and tel.
+ * For more information about the LINE URL scheme, see Using the LINE URL scheme.
+ * This property is supported on the following version of LINE.
+ *
+ * LINE 5.12.0 or later for macOS and Windows
+ * Note: The altUri.desktop property is supported only when you set URI actions in Flex Messages.
+ */
+export type AltURI = {
+  desktop: string;
 };
 
 /**

test/client.spec.ts

@@ -257,6 +257,37 @@ describe("client", () => {
     });
   });
 
+  it("linkRichMenuToMultipleUsers", () => {
+    return client
+      .linkRichMenuToMultipleUsers("test_rich_menu_id", ["test_user_id"])
+      .then((res: any) => {
+        const req = getRecentReq();
+        equal(req.headers.authorization, "Bearer test_channel_access_token");
+        equal(req.path, "/richmenu/bulk/link");
+        equal(req.method, "POST");
+        deepEqual(res, {});
+        deepEqual(req.body, {
+          richMenuId: "test_rich_menu_id",
+          userIds: ["test_user_id"],
+        });
+      });
+  });
+
+  it("unlinkRichMenusFromMultipleUsers", () => {
+    return client
+      .unlinkRichMenusFromMultipleUsers(["test_user_id"])
+      .then((res: any) => {
+        const req = getRecentReq();
+        equal(req.headers.authorization, "Bearer test_channel_access_token");
+        equal(req.path, "/richmenu/bulk/unlink");
+        equal(req.method, "POST");
+        deepEqual(res, {});
+        deepEqual(req.body, {
+          userIds: ["test_user_id"],
+        });
+      });
+  });
+
   it("setRichMenuImage", () => {
     const filepath = join(__dirname, "/helpers/line-icon.png");
     const buffer = readFileSync(filepath);