Merge pull request #269 from line/next

Release 7.2.0

Author: xingoxu

CHANGELOG.md

@@ -1,3 +1,13 @@
+## 7.2.0 (18 Sep 2020)
+
+### Feature
+* Messaging API - December 2020 update (#268)
+* Messaging API - October 2020 update (#261)(#264)
+* update some Flex Message Update 2 (#265)
+
+### Misc
+* Update dependencies (#267)
+
 ## 7.1.0 (18 Sep 2020)
 
 ### Feature

docs/api-reference/client.md

@@ -54,7 +54,7 @@ class Client {
   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>
+  unlinkRichMenusFromMultipleUsers(userIds: string[]): Promise<any>
   getRichMenuImage(richMenuId: string): Promise<Readable>
   setRichMenuImage(richMenuId: string, data: Buffer | Readable, contentType?: string): Promise<any>
   getRichMenuList(): Promise<Array<RichMenuResponse>>
@@ -172,6 +172,23 @@ class Client {
   changeAudienceGroupAuthorityLevel(
     authorityLevel: Types.AudienceGroupAuthorityLevel
   ): Promise<{}>
+
+  // Bot
+  getBotInfo(): Promise<BotInfoResponse>
+
+  // Webhook
+  setWebhookEndpointUrl(endpoint: string): Promise<{}>
+  getWebhookEndpointInfo(): Promise<{
+    endpoint: string;
+    active: boolean;
+  }>
+  testWebhookEndpoint(endpoint?: string): Promise<{
+    success: boolean;
+    timestamp: string;
+    statusCode: number;
+    reason: string;
+    detail: string;
+  }>
 }
 ```
 
@@ -667,3 +684,24 @@ 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.
+
+### Webhook
+
+#### `setWebhookEndpointUrl(endpoint: string): Promise<{}}>`
+
+It corresponds to the [Set webhook endpoint URL](https://developers.line.biz/en/reference/messaging-api/#set-webhook-endpoint-url) API.
+
+
+#### `getWebhookEndpointInfo(): Promise<Types.WebhookEndpointInfoResponse>`
+
+It corresponds to the [Get webhook endpoint information](https://developers.line.biz/en/reference/messaging-api/#get-webhook-endpoint-information) API.
+
+#### `testWebhookEndpoint(endpoint?: string): Promise<Types.TestWebhookEndpointResponse>`
+
+It corresponds to the [Test webhook endpoint](https://developers.line.biz/en/reference/messaging-api/#test-webhook-endpoint) API.

lib/client.ts

@@ -630,6 +630,35 @@ 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);
+  }
+
+  public async setWebhookEndpointUrl(endpoint: string) {
+    return this.http.put<{}>(
+      `${MESSAGING_API_PREFIX}/channel/webhook/endpoint`,
+      { endpoint },
+    );
+  }
+
+  public async getWebhookEndpointInfo() {
+    const res = await this.http.get<Types.WebhookEndpointInfoResponse>(
+      `${MESSAGING_API_PREFIX}/channel/webhook/endpoint`,
+    );
+    return ensureJSON(res);
+  }
+
+  public async testWebhookEndpoint(endpoint?: string) {
+    const res = await this.http.post<Types.TestWebhookEndpointResponse>(
+      `${MESSAGING_API_PREFIX}/channel/webhook/test`,
+      { endpoint },
+    );
+    return ensureJSON(res);
+  }
 }
 
 export class OAuth {

lib/types.ts

@@ -479,7 +479,9 @@ export type StickerEventMessage = {
     | "ANIMATION_SOUND"
     | "POPUP"
     | "POPUP_SOUND"
-    | "NAME_TEXT";
+    | "NAME_TEXT"
+    | "PER_STICKER_TEXT";
+  keywords: string[];
 } & EventMessageBase;
 
 export type Postback = {
@@ -888,7 +890,7 @@ export type FlexBlockStyle = {
 export type FlexCarousel = {
   type: "carousel";
   /**
-   * (Max: 10 bubbles)
+   * (Max: 12 bubbles)
    */
   contents: FlexBubble[];
 };
@@ -1059,6 +1061,25 @@ export type FlexBox = {
    * Specify an [action object](https://developers.line.biz/en/reference/messaging-api/#action-objects).
    */
   action?: Action;
+  /**
+   * How child elements are aligned along the main axis of the parent element. If the
+   * parent element is a horizontal box, this only takes effect when its child elements have
+   * their `flex` property set equal to 0. For more information, see [Arranging a box's child elements and free space](https://developers.line.biz/en/docs/messaging-api/flex-message-layout/#justify-property)
+   * in the Messaging API documentation.
+   */
+  justifyContent?:
+    | "flex-start"
+    | "center"
+    | "flex-end"
+    | "space-between"
+    | "space-around"
+    | "space-evenly";
+  /**
+   * How child elements are aligned along the cross axis of the parent element. For more
+   * information, see [Arranging a box's child elements and free space](https://developers.line.biz/en/docs/messaging-api/flex-message-layout/#justify-property) in the Messaging API documentation.
+   */
+  alignItems?: "flex-start" | "center" | "flex-end";
+  background?: Background;
 } & Offset;
 
 export type Offset = {
@@ -1093,6 +1114,49 @@ export type Offset = {
   offsetEnd?: string;
 };
 
+export type Background = {
+  /**
+   * The type of background used. Specify these values:
+   * - `linearGradient`: Linear gradient. For more information, see [Linear gradient backgrounds](https://developers.line.biz/en/docs/messaging-api/flex-message-layout/#linear-gradient-bg) in the Messaging API documentation.
+   */
+  type: "linearGradient";
+  /**
+   * The angle at which a linear gradient moves. Specify the angle using an integer value
+   * like `90deg` (90 degrees) or a decimal number like `23.5deg` (23.5 degrees) in the
+   * half-open interval [0, 360). The direction of the linear gradient rotates clockwise as the
+   * angle increases. Given a value of `0deg`, the gradient starts at the bottom and ends at
+   * the top; given a value of `45deg`, the gradient starts at the bottom-left corner and ends
+   * at the top-right corner; given a value of 90deg, the gradient starts at the left and ends
+   * at the right; and given a value of `180deg`, the gradient starts at the top and ends at
+   * the bottom. For more information, see [Direction (angle) of linear gradient backgrounds](https://developers.line.biz/en/docs/messaging-api/flex-message-layout/#linear-gradient-bg-angle) in the Messaging API documentation.
+   */
+  angle: string;
+  /**
+   * The color at the gradient's starting point. Use a hexadecimal color code in the
+   * `#RRGGBB` or `#RRGGBBAA` format.
+   */
+  startColor: string;
+  /**
+   * The color at the gradient's ending point. Use a hexadecimal color code in the
+   * `#RRGGBB` or `#RRGGBBAA` format.
+   */
+  endColor: string;
+  /**
+   * The color in the middle of the gradient. Use a hexadecimal color code in the `#RRGGBB`
+   * or `#RRGGBBAA` format. Specify a value for the `background.centerColor` property to
+   * create a gradient that has three colors. For more information, see [Intermediate color stops for linear gradients](https://developers.line.biz/en/docs/messaging-api/flex-message-layout/#linear-gradient-bg-center-color) in the
+   * Messaging API documentation.
+   */
+  centerColor?: string;
+  /**
+   * The position of the intermediate color stop. Specify an integer or decimal value
+   * between `0%` (the starting point) and `100%` (the ending point). This is `50%` by
+   * default. For more information, see [Intermediate color stops for linear gradients](https://developers.line.biz/en/docs/messaging-api/flex-message-layout/#linear-gradient-bg-center-color) in the
+   * Messaging API documentation.
+   */
+  centerPosition?: string;
+};
+
 /**
  * This component draws a button.
  *
@@ -1161,6 +1225,18 @@ export type FlexButton = {
    * property will be ignored.
    */
   gravity?: "top" | "bottom" | "center";
+  /**
+   * The method by which to adjust the text font size. Specify this value:
+   *
+   * - `shrink-to-fit`: Automatically shrink the font
+   *   size to fit the width of the component. This
+   *   property takes a "best-effort" approach that may
+   *   work differently—or not at all!—on some platforms.
+   *   For more information, see [Automatically shrink fonts to fit](https://developers.line.biz/en/docs/messaging-api/flex-message-layout/#adjusts-fontsize-to-fit)
+   *   in the Messaging API documentation.
+   * - LINE 10.13.0 or later for iOS and Android
+   */
+  adjustMode?: "shrink-to-fit";
 } & Offset;
 
 /**
@@ -1207,8 +1283,10 @@ export type FlexIcon = {
    * Maximum size of the icon width.
    * The size increases in the order of listing.
    * The default value is `md`.
+   * For more information, see [Icon, text, and span size](https://developers.line.biz/en/docs/messaging-api/flex-message-layout/#other-component-size) in the Messaging API documentation.
    */
   size?:
+    | string
     | "xxs"
     | "xs"
     | "sm"
@@ -1290,8 +1368,10 @@ export type FlexImage = {
    * Maximum size of the image width.
    * The size increases in the order of listing.
    * The default value is `md`.
+   * For more information, see [Image size](https://developers.line.biz/en/docs/messaging-api/flex-message-layout/#image-size) in the Messaging API documentation.
    */
   size?:
+    | string
     | "xxs"
     | "xs"
     | "sm"
@@ -1359,6 +1439,7 @@ export type FlexSeparator = {
 /**
  * This is an invisible component that places a fixed-size space at the
  * beginning or end of the box.
+ * @deprecated
  */
 export type FlexSpacer = {
   type: "spacer";
@@ -1377,6 +1458,18 @@ export type FlexText = {
    * Array of spans. Be sure to set either one of the `text` property or `contents` property. If you set the `contents` property, `text` is ignored.
    */
   contents?: FlexSpan[];
+  /**
+   * The method by which to adjust the text font size. Specify this value:
+   *
+   * - `shrink-to-fit`: Automatically shrink the font
+   *   size to fit the width of the component. This
+   *   property takes a "best-effort" approach that may
+   *   work differently—or not at all!—on some platforms.
+   *   For more information, see [Automatically shrink fonts to fit](https://developers.line.biz/en/docs/messaging-api/flex-message-layout/#adjusts-fontsize-to-fit)
+   *   in the Messaging API documentation.
+   * - LINE 10.13.0 or later for iOS and Android
+   */
+  adjustMode?: "shrink-to-fit";
   /**
    * The ratio of the width or height of this box within the parent box.
    *
@@ -1403,8 +1496,10 @@ export type FlexText = {
    * Font size.
    * The size increases in the order of listing.
    * The default value is `md`.
+   * For more information, see [Icon, text, and span size](https://developers.line.biz/en/docs/messaging-api/flex-message-layout/#other-component-size) in the Messaging API documentation.
    */
   size?:
+    | string
     | "xxs"
     | "xs"
     | "sm"
@@ -1502,8 +1597,20 @@ export type FlexSpan = {
   color?: string;
   /**
    * Font size. You can specify one of the following values: `xxs`, `xs`, `sm`, `md`, `lg`, `xl`, `xxl`, `3xl`, `4xl`, or `5xl`. The size increases in the order of listing. The default value is `md`.
+   * For more information, see [Icon, text, and span size](https://developers.line.biz/en/docs/messaging-api/flex-message-layout/#other-component-size) in the Messaging API documentation.
    */
-  size?: string;
+  size?:
+    | string
+    | "xxs"
+    | "xs"
+    | "sm"
+    | "md"
+    | "lg"
+    | "xl"
+    | "xxl"
+    | "3xl"
+    | "4xl"
+    | "5xl";
   /**
    * Font weight. You can specify one of the following values: `regular` or `bold`. Specifying `bold` makes the font bold. The default value is `regular`.
    */
@@ -2480,3 +2587,41 @@ 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";
+};
+
+/**
+ * Response body of get webhook endpoint info.
+ *
+ * @see [Get get webhook endpoint info](https://developers.line.biz/en/reference/messaging-api/#get-webhook-endpoint-information)
+ */
+export type WebhookEndpointInfoResponse = {
+  endpoint: string;
+  active: boolean;
+};
+
+/**
+ * Response body of test webhook endpoint.
+ *
+ * @see [Test webhook endpoint](https://developers.line.biz/en/reference/messaging-api/#test-webhook-endpoint)
+ */
+export type TestWebhookEndpointResponse = {
+  success: boolean;
+  timestamp: string;
+  statusCode: number;
+  reason: string;
+  detail: string;
+};