@satorijs/adapter-lark 3.5.3 → 3.6.1

package/src/types/message/content.ts

@@ -1,23 +1,35 @@
-// https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/im-v1/message/create_json
+// https://open.larksuite.com/document/server-docs/im-v1/message-content-description/create_json
 
-export namespace MessageContent {
-  export type Contents =
-    | Text
-    | Image
-    | ShareChat
-    | ShareUser
-    | Audio
-    | Media
-    | File
-    | Sticker
-    | RichText
-
-  export type MediaContents =
-    | Image
-    | Audio
-    | Media
-    | File
+declare global {
+  namespace JSX {
+    interface IntrinsicElements {
+      'lark:share-chat': {
+        'chat-id': string
+      }
+      'lark:share-user': {
+        'user-id': string
+      }
+      'lark:system': {
+        'need-rollup'?: boolean
+      }
+    }
+  }
+}
+
+export interface MessageContent {
+  text: MessageContent.Text
+  post: MessageContent.RichText
+  image: MessageContent.Image
+  file: MessageContent.File
+  audio: MessageContent.Audio
+  media: MessageContent.Media
+  sticker: MessageContent.Sticker
+  share_chat: MessageContent.ShareChat
+  share_user: MessageContent.ShareUser
+  system: MessageContent.System
+}
 
+export namespace MessageContent {
   export interface Text {
     text: string
   }
@@ -40,7 +52,7 @@ export namespace MessageContent {
 
   export interface Media {
     file_key: string
-    image_key: string
+    image_key?: string
   }
 
   export interface File {
@@ -51,52 +63,264 @@ export namespace MessageContent {
     file_key: string
   }
 
+  export interface System {
+    type: 'divider'
+    params: {
+      divider_text: {
+        text: string
+        i18n_text?: Record<string, string>
+      }
+    }
+    options?: {
+      need_rollup?: boolean
+    }
+  }
+
   export interface RichText {
     [locale: string]: {
-      title: string
+      title?: string
       content: RichText.Paragraph[]
     }
   }
 
   export namespace RichText {
-    export interface Paragraph extends Array<RichText.Content> {}
+    export type Style = 'bold' | 'italic' | 'underline' | 'lineThrough'
 
-    export interface BaseContent {
-      tag: string
+    export interface BaseElement<T extends string = string> {
+      tag: T
     }
 
-    export interface TextContent extends BaseContent {
-      tag: 'text'
+    export interface TextElement extends BaseElement<'text'> {
       text: string
       un_escape?: boolean
+      style?: Style[]
     }
-    export interface LinkContent extends BaseContent {
-      tag: 'a'
+
+    export interface LinkElement extends BaseElement<'a'> {
       text: string
       href: string
+      style?: Style[]
     }
-    export interface AtContent extends BaseContent {
-      tag: 'at'
+
+    export interface AtElement extends BaseElement<'at'> {
       user_id: string
-      user_name?: string
+      style?: Style[]
+      // user_name?: string
     }
-    export interface ImageContent extends BaseContent {
-      tag: 'img'
+
+    export interface ImageElement extends BaseElement<'img'> {
       image_key: string
-      height?: number
-      width?: number
+      // height?: number
+      // width?: number
     }
-    export interface MediaContent extends BaseContent {
-      tag: 'media'
+
+    export interface MediaElement extends BaseElement<'media'> {
       file_key: string
       image_key?: string
     }
 
-    export type Content =
-      | RichText.TextContent
-      | RichText.LinkContent
-      | RichText.AtContent
-      | RichText.ImageContent
-      | RichText.MediaContent
+    export interface EmotionElement extends BaseElement<'emoji'> {
+      emoji_type: string
+    }
+
+    export interface CodeBlockElement extends BaseElement<'code_block'> {
+      language?: string
+      text: string
+    }
+
+    export interface HRElement extends BaseElement<'hr'> {}
+
+    export interface MarkdownElement extends BaseElement<'md'> {
+      text: string
+    }
+
+    export type InlineElement =
+      | TextElement
+      | LinkElement
+      | AtElement
+      | EmotionElement
+      | MarkdownElement
+
+    export type BlockElement =
+      | ImageElement
+      | MediaElement
+      | CodeBlockElement
+      | HRElement
+
+    export type Paragraph =
+      | InlineElement[]
+      | [BlockElement]
+  }
+
+  export interface Card {
+    config: Card.Config
+    card_link?: Card.URLs
+    elements?: Card.Element[]
+  }
+
+  export namespace Card {
+    /** @see https://open.larksuite.com/document/common-capabilities/message-card/getting-started/card-structure/card-configuration */
+    export interface Config {
+      enable_forward?: boolean
+      update_multi?: boolean
+    }
+
+    export interface URLs {
+      url: string
+      pc_url?: string
+      ios_url?: string
+      android_url?: string
+    }
+
+    /** @see https://open.larksuite.com/document/common-capabilities/message-card/message-cards-content/card-header */
+    export interface Header {
+      title: I18nPlainTextElement
+      subtitle?: I18nPlainTextElement
+      template?: Header.Template
+      icon?: CustomIconElement
+      ud_icon?: StandardIconElement
+      text_tag_list?: TextTagElement[]
+      i18n_text_tag_list?: Record<string, TextTagElement[]>
+    }
+
+    export namespace Header {
+      export type Template = 'blue' | 'wathet' | 'turquoise' | 'green' | 'yellow' | 'orange' | 'red' | 'carmine' | 'violet' | 'purple' | 'indigo' | 'grey' | 'default'
+    }
+
+    export interface BaseElement<T extends string = string> {
+      tag: T
+    }
+
+    export type TextSize =
+      | 'heading-0' | 'heading-1' | 'heading-2' | 'heading-3' | 'heading-4' | 'heading'
+      | 'normal' | 'notation' | 'xxxx-large' | 'xxx-large' | 'xx-large' | 'x-large' | 'large' | 'medium' | 'small' | 'x-small'
+
+    export type TextAlign = 'left' | 'center' | 'right'
+
+    export interface PlainTextElement extends BaseElement<'plain_text'> {
+      content: string
+    }
+
+    export interface I18nPlainTextElement extends PlainTextElement {
+      i18n?: Record<string, string>
+    }
+
+    export interface DivPlainTextElement extends PlainTextElement {
+      text_size?: TextSize
+      text_color?: string
+      text_align?: TextAlign
+      lines?: number
+      icon?: IconElement
+    }
+
+    export type IconElement = StandardIconElement | CustomIconElement
+
+    export interface CustomIconElement extends BaseElement<'custom_icon'> {
+      img_key: string
+    }
+
+    export interface StandardIconElement extends BaseElement<'standard_icon'> {
+      token: string
+      color?: string
+    }
+
+    export interface TextTagElement extends BaseElement<'text_tag'> {
+      text: PlainTextElement
+      color: TextTagElement.Color
+    }
+
+    export namespace TextTagElement {
+      export type Color = 'neutral' | 'blue' | 'torqoise' | 'lime' | 'orange' | 'violet' | 'indigo' | 'wathet' | 'green' | 'yellow' | 'red' | 'purple' | 'carmine'
+    }
+
+    export interface ImageElement extends BaseElement<'image'> {
+      img_key: string
+      alt?: PlainTextElement
+      title?: PlainTextElement
+      custom_width?: number
+      compact_width?: boolean
+      mode?: 'crop_center' | 'fit_horizontal' | 'large' | 'medium' | 'small' | 'tiny'
+      preview?: boolean
+    }
+
+    export interface HorizontalRuleElement extends BaseElement<'hr'> {}
+
+    export interface DivElement extends BaseElement<'div'> {
+      text?: DivPlainTextElement
+    }
+
+    export interface MarkdownElement extends BaseElement<'markdown'> {
+      content: string
+      text_size?: TextSize
+      text_align?: TextAlign
+      href?: Record<string, URLs>
+    }
+
+    export interface HorizontalRuleElement extends BaseElement<'hr'> {}
+
+    export interface ActionModule extends BaseElement<'action'> {
+      actions: ActionElement[]
+      layout?: 'bisected' | 'trisection' | 'flow'
+    }
+
+    export type ActionElement =
+      | ButtonElement
+
+    export type ActionBehavior =
+      | OpenURLBehavior
+      | CallbackBehavior
+
+    export interface OpenURLBehavior {
+      type: 'open_url'
+      default_url: string
+      pc_url?: string
+      ios_url?: string
+      android_url?: string
+    }
+
+    export interface CallbackBehavior {
+      type: 'callback'
+      value: Record<string, string>
+    }
+
+    export interface ButtonElement extends BaseElement<'button'> {
+      text: PlainTextElement
+      type?: ButtonElement.Type
+      size?: ButtonElement.Size
+      width?: ButtonElement.Width
+      icon?: IconElement
+      hover_tips?: PlainTextElement
+      disabled?: boolean
+      disabled_tips?: PlainTextElement
+      confirm?: {
+        title: PlainTextElement
+        text: PlainTextElement
+      }
+      behaviors?: ActionBehavior[]
+      // form-related fields
+      name?: string
+      required?: boolean
+      action_type?: 'link' | 'request' | 'multi' | 'form_submit' | 'form_reset'
+    }
+
+    export namespace ButtonElement {
+      export type Size = 'tiny' | 'small' | 'medium' | 'large'
+      export type Width = 'default' | 'fill' | string
+      export type Type = 'default' | 'primary' | 'danger' | 'text' | 'primary_text' | 'danger_text' | 'primary_filled' | 'danger_filled' | 'laser'
+    }
+
+    export type Element =
+      | DivElement
+      | MarkdownElement
+      | HorizontalRuleElement
+      | ActionModule
+  }
+
+  export interface Template {
+    type: 'template'
+    data: {
+      template_id: string
+      template_variable: object
+    }
   }
 }

package/src/types/message/index.ts

@@ -1,31 +1,14 @@
-import { Lark } from '..'
-import { MessageContent } from './content'
+import { Lark, MessageContent } from '..'
 
 export * from './content'
 
-export type MessageType = 'text' | 'post' | 'image' | 'file' | 'audio' | 'media' | 'sticker' | 'interactive' | 'share_chat' | 'share_user'
-
-export interface MessageContentMap {
-  'text': MessageContent.Text
-  'post': MessageContent.RichText
-  'image': MessageContent.Image
-  'file': MessageContent.File
-  'audio': MessageContent.Audio
-  'media': MessageContent.Media
-  'sticker': MessageContent.Sticker
-  'share_chat': MessageContent.ShareChat
-  'share_user': MessageContent.ShareUser
-}
-
-export type MessageContentType<T extends MessageType> = T extends keyof MessageContentMap ? MessageContentMap[T] : any
-
 declare module '../event' {
   export interface Events {
     /**
      * Receive message event.
      * @see https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/events/receive
      */
-    'im.message.receive_v1': EventSkeleton<'im.message.receive_v1', {
+    'im.message.receive_v1': {
       sender: {
         sender_id: Lark.UserIds
         sender_type?: string
@@ -38,7 +21,7 @@ declare module '../event' {
         create_time: string
         chat_id: string
         chat_type: string
-        message_type: MessageType
+        message_type: keyof MessageContent
         content: string
         mentions: {
           key: string
@@ -47,18 +30,51 @@ declare module '../event' {
           tenant_key: string
         }[]
       }
-    }>
+    }
     /**
      * Message read event.
      * @see https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/events/message_read
      */
-    'im.message.message_read_v1': EventSkeleton<'im.message.message_read_v1', {
+    'im.message.message_read_v1': {
       reader: {
         reader_id: Lark.UserIds
         read_time: string
         tenant_key: string
       }
       message_id_list: string[]
-    }>
+    }
+    /**
+     * Message card callback event.
+     * @see https://open.feishu.cn/document/uAjLw4CM/ukzMukzMukzM/feishu-cards/card-callback-communication
+     */
+    'card.action.trigger': {
+      operator: {
+        tenant_key: string
+        user_id: string
+        union_id: string
+        open_id: string
+      }
+      token: string
+      action: {
+        value: any
+        tag: string
+        timezone?: string
+        name?: string
+        form_value?: any
+        input_value?: string
+        option?: string
+        options?: string[]
+        checked?: boolean
+      }
+      host: string
+      /** 卡片分发类型，固定取值为 url_preview，表示链接预览卡片。仅链接预览卡片有此字段。 */
+      delivery_type?: 'url_preview'
+      context: {
+        url?: string
+        preview_token?: string
+        open_message_id: string
+        open_chat_id: string
+      }
+    }
   }
 }

package/src/utils.ts

@@ -1,7 +1,7 @@
 import crypto from 'crypto'
 import { Context, h, Session, trimSlash, Universal } from '@satorijs/core'
-import { FeishuBot, LarkBot } from './bot'
-import { AllEvents, Events, GetImChatResponse, Lark, MessageContentType, MessageType } from './types'
+import { LarkBot } from './bot'
+import { EventPayload, Events, GetImChatResponse, Lark } from './types'
 
 export type Sender =
   | {
@@ -22,8 +22,8 @@ export function adaptSender(sender: Sender, session: Session): Session {
   return session
 }
 
-export async function adaptMessage(bot: FeishuBot, data: Events['im.message.receive_v1']['event'], session: Session, details = true): Promise<Session> {
-  const json = JSON.parse(data.message.content) as MessageContentType<MessageType>
+export async function adaptMessage(bot: LarkBot, data: Events['im.message.receive_v1'], session: Session, details = true): Promise<Session> {
+  const json = JSON.parse(data.message.content)
   const assetEndpoint = trimSlash(bot.config.selfUrl ?? bot.ctx.server.config.selfUrl) + bot.config.path + '/assets'
   const content: (string | h)[] = []
   switch (data.message.message_type) {
@@ -71,7 +71,7 @@ export async function adaptMessage(bot: FeishuBot, data: Events['im.message.rece
   return session
 }
 
-export async function adaptSession<C extends Context>(bot: FeishuBot<C>, body: AllEvents) {
+export async function adaptSession<C extends Context>(bot: LarkBot<C>, body: EventPayload) {
   const session = bot.session()
   session.setInternal('lark', body)
 
@@ -84,13 +84,42 @@ export async function adaptSession<C extends Context>(bot: FeishuBot<C>, body: A
       adaptSender(body.event.sender, session)
       await adaptMessage(bot, body.event, session)
       break
+    case 'card.action.trigger':
+      if (body.event.action.value?._satori_type === 'command') {
+        session.type = 'interaction/command'
+        let content = body.event.action.value.content
+        const args = [], options = Object.create(null)
+        for (const [key, value] of Object.entries(body.event.action.form_value ?? {})) {
+          if (+key * 0 === 0) {
+            args[+key] = value
+          } else {
+            options[key] = value
+          }
+        }
+        for (let i = 0; i < args.length; ++i) {
+          if (i in args) {
+            content += ` ${args[i]}`
+          } else {
+            content += ` ''`
+          }
+        }
+        for (const [key, value] of Object.entries(options)) {
+          content += ` --${key} ${value}`
+        }
+        session.content = content
+        session.messageId = body.event.context.open_message_id
+        session.channelId = body.event.context.open_chat_id
+        session.guildId = body.event.context.open_chat_id
+        session.userId = body.event.operator.open_id
+      }
+      break
   }
   return session
 }
 
 // TODO: This function has many duplicated code with `adaptMessage`, should refactor them
 export async function decodeMessage(bot: LarkBot, body: Lark.Message, details = true): Promise<Universal.Message> {
-  const json = JSON.parse(body.body.content) as MessageContentType<MessageType>
+  const json = JSON.parse(body.body.content)
   const assetEndpoint = trimSlash(bot.config.selfUrl ?? bot.ctx.server.config.selfUrl) + bot.config.path + '/assets'
   const content: h[] = []
   switch (body.msg_type) {