Implement getBotInfo API (#261)

* Add getBotInfo API support

* Update doc for getBotInfo

Co-authored-by: xingo xu <xingoxu@users.noreply.github.com>

Author: dlackty

docs/api-reference/client.md

@@ -172,6 +172,9 @@ class Client {
   changeAudienceGroupAuthorityLevel(
     authorityLevel: Types.AudienceGroupAuthorityLevel
   ): Promise<{}>
+
+  // Bot
+  getBotInfo(): Promise<BotInfoResponse>
 }
 ```
 
@@ -667,3 +670,9 @@ It corresponds to the [Get number of followers](https://developers.line.biz/en/r
 #### `getFriendDemographics(): Promise<Types.FriendDemographics>`
 
 It corresponds to the [Get friend demographics](https://developers.line.biz/en/reference/messaging-api/#get-demographic) API.
+
+### Bot
+
+#### `getBotInfo(): Promise<BotInfoResponse>`
+
+It corresponds to the [Get bot info](https://developers.line.biz/en/reference/messaging-api/#get-bot-info) API.

lib/client.ts

@@ -630,6 +630,13 @@ export default class Client {
     );
     return ensureJSON(res);
   }
+
+  public async getBotInfo(): Promise<Types.BotInfoResponse> {
+    const res = await this.http.get<Types.BotInfoResponse>(
+      `${MESSAGING_API_PREFIX}/info`,
+    );
+    return ensureJSON(res);
+  }
 }
 
 export class OAuth {

lib/types.ts

@@ -2482,3 +2482,18 @@ export type GroupSummaryResponse = {
 export type MembersCountResponse = {
   count: number;
 };
+
+/**
+ * Response body of get bot info.
+ *
+ * @see [Get bot info](https://developers.line.biz/en/reference/messaging-api/#get-bot-info)
+ */
+export type BotInfoResponse = {
+  userId: string;
+  basicId: string;
+  premiumId?: string;
+  displayName: string;
+  pictureUrl?: string;
+  chatMode: "chat" | "bot";
+  markAsReadMode: "auto" | "manual";
+};

test/client.spec.ts

@@ -960,6 +960,13 @@ describe("client", () => {
       equal(err.message, "invalid data type for binary data");
     }
   });
+
+  it("getBotInfo", async () => {
+    const scope = mockGet(MESSAGING_API_PREFIX, `/info`);
+
+    await client.getBotInfo();
+    equal(scope.isDone(), true);
+  });
 });
 
 const oauth = new OAuth();