agent-messenger 2.14.1 → 2.15.0

package/src/platforms/kakaotalk/listener.test.ts

@@ -4,6 +4,7 @@ import type { KakaoSessionEvent, KakaoSessionEventHandler, KakaoPushHandler, Kak
 import { KakaoTalkListener } from './listener'
 import type { LocoPacket } from './protocol/types'
 import type {
+  KakaoTalkPushEmoticonEvent,
   KakaoTalkPushGenericEvent,
   KakaoTalkPushMemberEvent,
   KakaoTalkPushMessageEvent,
@@ -176,6 +177,388 @@ describe('KakaoTalkListener', () => {
     })
   })
 
+  describe('emoticon events', () => {
+    it('emits emoticon on MSG push with type=20 (animated sticker)', async () => {
+      const { listener: l, client } = createListener()
+      listener = l
+
+      const emoticons: KakaoTalkPushEmoticonEvent[] = []
+      listener.on('emoticon', (event) => emoticons.push(event))
+
+      await listener.start()
+      client.emitPush('MSG', {
+        chatId: { high: 0, low: 100 },
+        chatLog: {
+          logId: { high: 0, low: 200 },
+          authorId: 42,
+          message: '',
+          type: 20,
+          sendAt: 1700000000,
+          attachment: '{"path":"4412724.emot_001.webp","emoticonItemPath":"4412724.emot_001.webp","name":"(emoticon)"}',
+        },
+      })
+
+      expect(emoticons.length).toBe(1)
+      expect(emoticons[0].type).toBe('EMOTICON')
+      expect(emoticons[0].chat_id).toBe('100')
+      expect(emoticons[0].log_id).toBe('200')
+      expect(emoticons[0].author_id).toBe(42)
+      expect(emoticons[0].message_type).toBe(20)
+      expect(emoticons[0].emoticon_kind).toBe('sticker_ani')
+      expect(emoticons[0].pack_id).toBe('4412724')
+      expect(emoticons[0].sticker_path).toBe('4412724.emot_001.webp')
+      expect(emoticons[0].sent_at).toBe(1700000000)
+    })
+
+    it('emits emoticon on MSG push with type=12 (static sticker)', async () => {
+      const { listener: l, client } = createListener()
+      listener = l
+
+      const emoticons: KakaoTalkPushEmoticonEvent[] = []
+      listener.on('emoticon', (event) => emoticons.push(event))
+
+      await listener.start()
+      client.emitPush('MSG', {
+        chatId: { high: 0, low: 100 },
+        chatLog: {
+          logId: { high: 0, low: 201 },
+          authorId: 42,
+          message: '',
+          type: 12,
+          sendAt: 1700000001,
+          attachment: '{"path":"2222149.emot_004.png","emoticonItemPath":"2222149.emot_004.png","name":"(emoticon)"}',
+        },
+      })
+
+      expect(emoticons.length).toBe(1)
+      expect(emoticons[0].emoticon_kind).toBe('sticker')
+      expect(emoticons[0].pack_id).toBe('2222149')
+      expect(emoticons[0].sticker_path).toBe('2222149.emot_004.png')
+    })
+
+    it.each([
+      [6, 'ditem_emoticon' as const],
+      [22, 'actioncon' as const],
+      [25, 'sticker_gif' as const],
+    ])('maps message_type=%i to emoticon_kind=%s', async (msgType, expectedKind) => {
+      const { listener: l, client } = createListener()
+      listener = l
+
+      const emoticons: KakaoTalkPushEmoticonEvent[] = []
+      listener.on('emoticon', (event) => emoticons.push(event))
+
+      await listener.start()
+      client.emitPush('MSG', {
+        chatId: { high: 0, low: 100 },
+        chatLog: {
+          logId: { high: 0, low: 202 },
+          authorId: 42,
+          message: '',
+          type: msgType,
+          sendAt: 1700000002,
+          attachment: '{"path":"9999999.emot_001.webp"}',
+        },
+      })
+
+      expect(emoticons[0].emoticon_kind).toBe(expectedKind)
+    })
+
+    it('still emits the message event for back-compat when emoticon arrives', async () => {
+      const { listener: l, client } = createListener()
+      listener = l
+
+      const messages: KakaoTalkPushMessageEvent[] = []
+      const emoticons: KakaoTalkPushEmoticonEvent[] = []
+      listener.on('message', (event) => messages.push(event))
+      listener.on('emoticon', (event) => emoticons.push(event))
+
+      await listener.start()
+      client.emitPush('MSG', {
+        chatId: { high: 0, low: 100 },
+        chatLog: {
+          logId: { high: 0, low: 203 },
+          authorId: 42,
+          message: '',
+          type: 12,
+          sendAt: 1700000003,
+          attachment: '{"path":"2222149.emot_004.png"}',
+        },
+      })
+
+      expect(messages.length).toBe(1)
+      expect(messages[0].message_type).toBe(12)
+      expect(emoticons.length).toBe(1)
+    })
+
+    it('does not emit emoticon for non-sticker types', async () => {
+      const { listener: l, client } = createListener()
+      listener = l
+
+      const emoticons: KakaoTalkPushEmoticonEvent[] = []
+      listener.on('emoticon', (event) => emoticons.push(event))
+
+      await listener.start()
+      client.emitPush('MSG', {
+        chatId: { high: 0, low: 100 },
+        chatLog: {
+          logId: { high: 0, low: 204 },
+          authorId: 42,
+          message: 'hello',
+          type: 1,
+          sendAt: 1700000004,
+          attachment: '{}',
+        },
+      })
+
+      expect(emoticons.length).toBe(0)
+    })
+
+    it('emits emoticon with null fields when attachment is malformed JSON', async () => {
+      const { listener: l, client } = createListener()
+      listener = l
+
+      const emoticons: KakaoTalkPushEmoticonEvent[] = []
+      listener.on('emoticon', (event) => emoticons.push(event))
+
+      await listener.start()
+      client.emitPush('MSG', {
+        chatId: { high: 0, low: 100 },
+        chatLog: {
+          logId: { high: 0, low: 205 },
+          authorId: 42,
+          message: '',
+          type: 12,
+          sendAt: 1700000005,
+          attachment: 'not-json',
+        },
+      })
+
+      expect(emoticons.length).toBe(1)
+      expect(emoticons[0].sticker_path).toBeNull()
+      expect(emoticons[0].pack_id).toBeNull()
+    })
+
+    it('emits emoticon with null fields when attachment is missing', async () => {
+      const { listener: l, client } = createListener()
+      listener = l
+
+      const emoticons: KakaoTalkPushEmoticonEvent[] = []
+      listener.on('emoticon', (event) => emoticons.push(event))
+
+      await listener.start()
+      client.emitPush('MSG', {
+        chatId: { high: 0, low: 100 },
+        chatLog: {
+          logId: { high: 0, low: 206 },
+          authorId: 42,
+          message: '',
+          type: 20,
+          sendAt: 1700000006,
+        },
+      })
+
+      expect(emoticons.length).toBe(1)
+      expect(emoticons[0].sticker_path).toBeNull()
+      expect(emoticons[0].pack_id).toBeNull()
+    })
+
+    it('falls back to emoticonItemPath when path is absent', async () => {
+      const { listener: l, client } = createListener()
+      listener = l
+
+      const emoticons: KakaoTalkPushEmoticonEvent[] = []
+      listener.on('emoticon', (event) => emoticons.push(event))
+
+      await listener.start()
+      client.emitPush('MSG', {
+        chatId: { high: 0, low: 100 },
+        chatLog: {
+          logId: { high: 0, low: 207 },
+          authorId: 42,
+          message: '',
+          type: 12,
+          sendAt: 1700000007,
+          attachment: '{"emoticonItemPath":"3333.emot_009.png"}',
+        },
+      })
+
+      expect(emoticons[0].sticker_path).toBe('3333.emot_009.png')
+      expect(emoticons[0].pack_id).toBe('3333')
+    })
+
+    it('does not throw or leak invalid types when attachment.path is a non-string', async () => {
+      const { listener: l, client } = createListener()
+      listener = l
+
+      const emoticons: KakaoTalkPushEmoticonEvent[] = []
+      listener.on('emoticon', (event) => emoticons.push(event))
+
+      await listener.start()
+      client.emitPush('MSG', {
+        chatId: { high: 0, low: 100 },
+        chatLog: {
+          logId: { high: 0, low: 208 },
+          authorId: 42,
+          message: '',
+          type: 12,
+          sendAt: 1700000008,
+          attachment: '{"path":12345,"emoticonItemPath":null,"name":{"nested":"obj"}}',
+        },
+      })
+
+      expect(emoticons.length).toBe(1)
+      expect(emoticons[0].sticker_path).toBeNull()
+      expect(emoticons[0].pack_id).toBeNull()
+    })
+  })
+
+  describe('attachment field', () => {
+    it('parses chatLog.attachment JSON into a structured field', async () => {
+      const { listener: l, client } = createListener()
+      listener = l
+
+      const messages: KakaoTalkPushMessageEvent[] = []
+      listener.on('message', (event) => messages.push(event))
+
+      await listener.start()
+      client.emitPush('MSG', {
+        chatId: { high: 0, low: 100 },
+        chatLog: {
+          logId: { high: 0, low: 200 },
+          authorId: 42,
+          message: '사진',
+          type: 2,
+          sendAt: 1700000000,
+          attachment:
+            '{"k":"abc/photo.jpg","w":1320,"h":2868,"s":438315,"mt":"image/jpeg","url":"https://talk.kakaocdn.net/p"}',
+        },
+      })
+
+      expect(messages[0].attachment).toEqual({
+        k: 'abc/photo.jpg',
+        w: 1320,
+        h: 2868,
+        s: 438315,
+        mt: 'image/jpeg',
+        url: 'https://talk.kakaocdn.net/p',
+      })
+    })
+
+    it('returns null when attachment is "{}" (text messages have no payload)', async () => {
+      const { listener: l, client } = createListener()
+      listener = l
+
+      const messages: KakaoTalkPushMessageEvent[] = []
+      listener.on('message', (event) => messages.push(event))
+
+      await listener.start()
+      client.emitPush('MSG', {
+        chatId: { high: 0, low: 100 },
+        chatLog: {
+          logId: { high: 0, low: 201 },
+          authorId: 42,
+          message: 'hi',
+          type: 1,
+          sendAt: 1700000001,
+          attachment: '{}',
+        },
+      })
+
+      expect(messages[0].attachment).toBeNull()
+    })
+
+    it('returns null when attachment is absent', async () => {
+      const { listener: l, client } = createListener()
+      listener = l
+
+      const messages: KakaoTalkPushMessageEvent[] = []
+      listener.on('message', (event) => messages.push(event))
+
+      await listener.start()
+      client.emitPush('MSG', {
+        chatId: { high: 0, low: 100 },
+        chatLog: {
+          logId: { high: 0, low: 202 },
+          authorId: 42,
+          message: 'hi',
+          type: 1,
+          sendAt: 1700000002,
+        },
+      })
+
+      expect(messages[0].attachment).toBeNull()
+    })
+
+    it('returns null when attachment is an empty string', async () => {
+      const { listener: l, client } = createListener()
+      listener = l
+
+      const messages: KakaoTalkPushMessageEvent[] = []
+      listener.on('message', (event) => messages.push(event))
+
+      await listener.start()
+      client.emitPush('MSG', {
+        chatId: { high: 0, low: 100 },
+        chatLog: {
+          logId: { high: 0, low: 203 },
+          authorId: 42,
+          message: '',
+          type: 1,
+          sendAt: 1700000003,
+          attachment: '',
+        },
+      })
+
+      expect(messages[0].attachment).toBeNull()
+    })
+
+    it('returns null when attachment is malformed JSON', async () => {
+      const { listener: l, client } = createListener()
+      listener = l
+
+      const messages: KakaoTalkPushMessageEvent[] = []
+      listener.on('message', (event) => messages.push(event))
+
+      await listener.start()
+      client.emitPush('MSG', {
+        chatId: { high: 0, low: 100 },
+        chatLog: {
+          logId: { high: 0, low: 204 },
+          authorId: 42,
+          message: '',
+          type: 1,
+          sendAt: 1700000004,
+          attachment: 'not-json{',
+        },
+      })
+
+      expect(messages[0].attachment).toBeNull()
+    })
+
+    it('returns null when attachment is a JSON array (non-object)', async () => {
+      const { listener: l, client } = createListener()
+      listener = l
+
+      const messages: KakaoTalkPushMessageEvent[] = []
+      listener.on('message', (event) => messages.push(event))
+
+      await listener.start()
+      client.emitPush('MSG', {
+        chatId: { high: 0, low: 100 },
+        chatLog: {
+          logId: { high: 0, low: 205 },
+          authorId: 42,
+          message: '',
+          type: 1,
+          sendAt: 1700000005,
+          attachment: '[1,2,3]',
+        },
+      })
+
+      expect(messages[0].attachment).toBeNull()
+    })
+  })
+
   describe('member events', () => {
     it('emits member_joined on NEWMEM push', async () => {
       const { listener: l, client } = createListener()

package/src/platforms/kakaotalk/listener.ts

@@ -2,12 +2,15 @@ import { EventEmitter } from 'events'
 
 import type { KakaoSessionEvent, KakaoTalkClient } from './client'
 import type { LocoPacket } from './protocol/types'
-import type {
-  KakaoTalkListenerEventMap,
-  KakaoTalkPushGenericEvent,
-  KakaoTalkPushMemberEvent,
-  KakaoTalkPushMessageEvent,
-  KakaoTalkPushReadEvent,
+import {
+  KAKAO_EMOTICON_KIND_BY_TYPE,
+  type KakaoEmoticonMessageType,
+  type KakaoTalkListenerEventMap,
+  type KakaoTalkPushEmoticonEvent,
+  type KakaoTalkPushGenericEvent,
+  type KakaoTalkPushMemberEvent,
+  type KakaoTalkPushMessageEvent,
+  type KakaoTalkPushReadEvent,
 } from './types'
 
 type EventKey = keyof KakaoTalkListenerEventMap
@@ -20,6 +23,34 @@ function longToString(v: unknown): string {
   return String(v ?? 0)
 }
 
+function isEmoticonType(type: number): type is KakaoEmoticonMessageType {
+  return type in KAKAO_EMOTICON_KIND_BY_TYPE
+}
+
+function parseAttachmentJson(raw: unknown): Record<string, unknown> | null {
+  if (typeof raw !== 'string' || raw.length === 0) return null
+  try {
+    const parsed = JSON.parse(raw) as unknown
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) return null
+    const attachment = parsed as Record<string, unknown>
+    return Object.keys(attachment).length > 0 ? attachment : null
+  } catch {
+    return null
+  }
+}
+
+function nonEmptyString(value: unknown): string | null {
+  return typeof value === 'string' && value.length > 0 ? value : null
+}
+
+function extractPackIdFromPath(path: string | null): string | null {
+  if (!path) return null
+  const dotIndex = path.indexOf('.')
+  if (dotIndex <= 0) return null
+  const head = path.slice(0, dotIndex)
+  return /^\d+$/.test(head) ? head : null
+}
+
 export class KakaoTalkListener {
   private client: KakaoTalkClient
   private running = false
@@ -111,17 +142,43 @@ export class KakaoTalkListener {
         const chatLog = body.chatLog as Record<string, unknown>
         const chatId = longToString(body.chatId)
         const authorId = chatLog.authorId as number
-        const event: KakaoTalkPushMessageEvent = {
+        const logId = longToString(chatLog.logId)
+        const messageType = chatLog.type as number
+        const authorName = this.client.lookupAuthorName?.(chatId, authorId) ?? null
+        const sentAt = chatLog.sendAt as number
+
+        const attachment = parseAttachmentJson(chatLog.attachment)
+
+        const messageEvent: KakaoTalkPushMessageEvent = {
           type: 'MSG',
           chat_id: chatId,
-          log_id: longToString(chatLog.logId),
+          log_id: logId,
           author_id: authorId,
-          author_name: this.client.lookupAuthorName?.(chatId, authorId) ?? null,
+          author_name: authorName,
           message: chatLog.message as string,
-          message_type: chatLog.type as number,
-          sent_at: chatLog.sendAt as number,
+          message_type: messageType,
+          attachment,
+          sent_at: sentAt,
+        }
+        this.emitter.emit('message', messageEvent)
+
+        if (isEmoticonType(messageType)) {
+          const stickerPath = nonEmptyString(attachment?.path) ?? nonEmptyString(attachment?.emoticonItemPath)
+          const emoticonEvent: KakaoTalkPushEmoticonEvent = {
+            type: 'EMOTICON',
+            chat_id: chatId,
+            log_id: logId,
+            author_id: authorId,
+            author_name: authorName,
+            message_type: messageType,
+            emoticon_kind: KAKAO_EMOTICON_KIND_BY_TYPE[messageType],
+            pack_id: extractPackIdFromPath(stickerPath),
+            sticker_path: stickerPath,
+            sent_at: sentAt,
+          }
+          this.emitter.emit('emoticon', emoticonEvent)
         }
-        this.emitter.emit('message', event)
+
         this.emitter.emit('kakaotalk_event', { type: method, ...body })
         break
       }

package/src/platforms/kakaotalk/types.ts

@@ -90,6 +90,7 @@ export interface KakaoMessage {
   author_id: number
   author_name: string | null
   message: string
+  attachment: Record<string, unknown> | null
   sent_at: number
 }
 
@@ -148,6 +149,7 @@ export const KakaoMessageSchema = z.object({
   author_id: z.number(),
   author_name: z.string().nullable(),
   message: z.string(),
+  attachment: z.record(z.string(), z.unknown()).nullable(),
   sent_at: z.number(),
 })
 
@@ -237,6 +239,36 @@ export interface KakaoTalkPushMessageEvent {
   author_name: string | null
   message: string
   message_type: number
+  attachment: Record<string, unknown> | null
+  sent_at: number
+}
+
+export type KakaoEmoticonKind = 'sticker' | 'sticker_ani' | 'actioncon' | 'sticker_gif' | 'ditem_emoticon'
+
+export const KAKAO_EMOTICON_KIND_BY_TYPE = {
+  6: 'ditem_emoticon',
+  12: 'sticker',
+  20: 'sticker_ani',
+  22: 'actioncon',
+  25: 'sticker_gif',
+} as const satisfies Record<number, KakaoEmoticonKind>
+
+export type KakaoEmoticonMessageType = keyof typeof KAKAO_EMOTICON_KIND_BY_TYPE
+
+export const KAKAO_EMOTICON_MESSAGE_TYPES = Object.keys(KAKAO_EMOTICON_KIND_BY_TYPE).map(
+  Number,
+) as KakaoEmoticonMessageType[]
+
+export interface KakaoTalkPushEmoticonEvent {
+  type: 'EMOTICON'
+  chat_id: string
+  log_id: string
+  author_id: number
+  author_name: string | null
+  message_type: KakaoEmoticonMessageType
+  emoticon_kind: KakaoEmoticonKind
+  pack_id: string | null
+  sticker_path: string | null
   sent_at: number
 }
 
@@ -260,12 +292,14 @@ export interface KakaoTalkPushGenericEvent {
 
 export type KakaoTalkPushEvent =
   | KakaoTalkPushMessageEvent
+  | KakaoTalkPushEmoticonEvent
   | KakaoTalkPushMemberEvent
   | KakaoTalkPushReadEvent
   | KakaoTalkPushGenericEvent
 
 export interface KakaoTalkListenerEventMap {
   message: [event: KakaoTalkPushMessageEvent]
+  emoticon: [event: KakaoTalkPushEmoticonEvent]
   member_joined: [event: KakaoTalkPushMemberEvent]
   member_left: [event: KakaoTalkPushMemberEvent]
   read: [event: KakaoTalkPushReadEvent]
@@ -283,6 +317,20 @@ export const KakaoTalkPushMessageEventSchema = z.object({
   author_name: z.string().nullable(),
   message: z.string(),
   message_type: z.number(),
+  attachment: z.record(z.string(), z.unknown()).nullable(),
+  sent_at: z.number(),
+})
+
+export const KakaoTalkPushEmoticonEventSchema = z.object({
+  type: z.literal('EMOTICON'),
+  chat_id: z.string(),
+  log_id: z.string(),
+  author_id: z.number(),
+  author_name: z.string().nullable(),
+  message_type: z.union([z.literal(6), z.literal(12), z.literal(20), z.literal(22), z.literal(25)]),
+  emoticon_kind: z.enum(['sticker', 'sticker_ani', 'actioncon', 'sticker_gif', 'ditem_emoticon']),
+  pack_id: z.string().nullable(),
+  sticker_path: z.string().nullable(),
   sent_at: z.number(),
 })