Add LINE export parser

Author: ndbroadbent

README.md

@@ -7,10 +7,10 @@ Transform chat exports into geocoded activity suggestions.
 
 ## Overview
 
-ChatToMap extracts "things to do" from WhatsApp, iMessage, and Telegram exports - restaurants to try, places to visit, trips to take. It finds suggestions buried in years of chat history and puts them on a map.
+ChatToMap extracts "things to do" from WhatsApp, iMessage, Telegram, and LINE exports - restaurants to try, places to visit, trips to take. It finds suggestions buried in years of chat history and puts them on a map.
 
 **Features:**
-- Parse WhatsApp (iOS/Android), iMessage, and Telegram Desktop JSON exports
+- Parse WhatsApp (iOS/Android), iMessage, Telegram Desktop JSON, and LINE text exports
 - Extract suggestions using multilingual regex patterns, embeddings, and URL detection
 - Classify with AI (activity vs errand, mappable vs general)
 - Scrape metadata from TikTok and YouTube links
@@ -53,6 +53,9 @@ chat-to-map analyze <input>
 # Telegram Desktop exports
 chat-to-map analyze "/path/to/ChatExport_2026-04-26/result.json"
 
+# LINE text exports
+chat-to-map analyze "/path/to/[LINE] Chat with Friends.txt"
+
 # List previously processed chats
 chat-to-map list
 ```

src/cli/commands/parse.ts

@@ -19,7 +19,8 @@ import { initContext, stepParse } from '../steps/index'
 function formatSource(source: ChatSource): string {
   if (source === 'whatsapp') return 'WhatsApp'
   if (source === 'imessage') return 'iMessage'
-  return 'Telegram'
+  if (source === 'telegram') return 'Telegram'
+  return 'LINE'
 }
 
 /**

src/core/index.ts

@@ -151,12 +151,15 @@ export {
 export {
   detectChatSource,
   detectFormat,
+  isLineExport,
   isTelegramExport,
   parseChat,
   parseChatStream,
   parseChatWithStats,
   parseIMessageChat,
   parseIMessageChatStream,
+  parseLineChat,
+  parseLineChatStream,
   parseTelegramExport,
   parseWhatsAppChat,
   parseWhatsAppChatStream

src/parser/index.ts

@@ -1,15 +1,17 @@
 /**
  * Parser Module
  *
- * Parse WhatsApp, iMessage, and Telegram exports into structured messages.
+ * Parse WhatsApp, iMessage, Telegram, and LINE exports into structured messages.
  */
 
 import type { ChatSource, MediaType, ParsedMessage, ParseResult, ParserOptions } from '../types'
 import { parseIMessageChat, parseIMessageChatStream } from './imessage'
+import { isLineExport, parseLineChat, parseLineChatStream } from './line'
 import { isTelegramExport, parseTelegramExport } from './telegram'
 import { parseWhatsAppChat, parseWhatsAppChatStream } from './whatsapp'
 
 export { parseIMessageChat, parseIMessageChatStream } from './imessage'
+export { isLineExport, parseLineChat, parseLineChatStream } from './line'
 export { isTelegramExport, parseTelegramExport } from './telegram'
 export {
   detectFormat,
@@ -183,6 +185,10 @@ export function detectChatSource(content: string): ChatSource {
     return 'telegram'
   }
 
+  if (isLineExport(content)) {
+    return 'line'
+  }
+
   // Check for WhatsApp patterns (timestamp in brackets)
   if (/^\[\d{1,2}\/\d{1,2}\/\d{2,4},/.test(content)) {
     return 'whatsapp'
@@ -216,6 +222,10 @@ export function parseChat(raw: string, options?: ParserOptions): ParsedMessage[]
     return parseTelegramExport(raw)
   }
 
+  if (source === 'line') {
+    return parseLineChat(raw)
+  }
+
   return parseWhatsAppChat(raw, options)
 }
 
@@ -255,6 +265,8 @@ export async function* parseChatStream(
     yield* parseIMessageChatStream(lines)
   } else if (source === 'telegram') {
     throw new Error('Telegram JSON exports must be parsed with parseChat')
+  } else if (source === 'line') {
+    yield* parseLineChatStream(lines)
   } else {
     yield* parseWhatsAppChatStream(lines, options)
   }

src/parser/line.test.ts

@@ -0,0 +1,98 @@
+import { describe, expect, it } from 'vitest'
+import { detectChatSource, parseChat, parseChatStream } from './index'
+import { isLineExport, parseLineChat } from './line'
+
+const SAMPLE_EXPORT = `[LINE] Chat history with Travel Friends
+Saved on: 26/04/2026, 04:36PM
+
+Sun, 26/04/2026
+04:35PM\tAlex\tLet's try the ramen place https://example.com.
+04:36PM\tMaya\t[Sticker]
+`
+
+describe('LINE parser', () => {
+  it('detects LINE text exports', () => {
+    expect(isLineExport(SAMPLE_EXPORT)).toBe(true)
+    expect(detectChatSource(SAMPLE_EXPORT)).toBe('line')
+  })
+
+  it('parses tab-separated LINE messages', () => {
+    const messages = parseLineChat(SAMPLE_EXPORT)
+
+    expect(messages).toHaveLength(2)
+    expect(messages[0]?.id).toBe(0)
+    expect(messages[0]?.sender).toBe('Alex')
+    expect(messages[0]?.content).toBe("Let's try the ramen place https://example.com.")
+    expect(messages[0]?.source).toBe('line')
+    expect(messages[0]?.timestamp).toEqual(new Date(2026, 3, 26, 16, 35, 0))
+    expect(messages[0]?.urls).toEqual(['https://example.com'])
+  })
+
+  it('detects LINE media placeholders', () => {
+    const messages = parseLineChat(SAMPLE_EXPORT)
+
+    expect(messages[1]?.content).toBe('[Sticker]')
+    expect(messages[1]?.hasMedia).toBe(true)
+    expect(messages[1]?.mediaType).toBe('sticker')
+  })
+
+  it('parses year-first date lines and 24-hour times', () => {
+    const raw = `[LINE] Chat history with Travel Friends
+
+2026.04.26 Sunday
+16:35\tAlex\tDinner tomorrow?
+`
+
+    const messages = parseLineChat(raw)
+
+    expect(messages).toHaveLength(1)
+    expect(messages[0]?.timestamp).toEqual(new Date(2026, 3, 26, 16, 35, 0))
+  })
+
+  it('preserves continuation lines in multi-line messages', () => {
+    const raw = `[LINE] Chat history with Travel Friends
+
+Sun, 26/04/2026
+04:35PM\tAlex\tFirst line
+second line
+04:36PM\tMaya\tNext message
+`
+
+    const messages = parseLineChat(raw)
+
+    expect(messages).toHaveLength(2)
+    expect(messages[0]?.content).toBe('First line\nsecond line')
+    expect(messages[0]?.rawLine).toContain('second line')
+  })
+
+  it('routes LINE exports through parseChat auto-detection', () => {
+    const messages = parseChat(SAMPLE_EXPORT)
+
+    expect(messages).toHaveLength(2)
+    expect(messages[0]?.source).toBe('line')
+  })
+
+  it('streams LINE messages', async () => {
+    const lines = (async function* () {
+      yield '[LINE] Chat history with Travel Friends'
+      yield ''
+      yield 'Sun, 26/04/2026'
+      yield '04:35PM\tAlex\tOne'
+      yield '04:36PM\tMaya\tTwo'
+    })()
+    const messages = []
+
+    for await (const message of parseChatStream(lines, 'line')) {
+      messages.push(message)
+    }
+
+    expect(messages).toHaveLength(2)
+    expect(messages[0]?.content).toBe('One')
+    expect(messages[1]?.sender).toBe('Maya')
+  })
+
+  it('does not detect generic text as LINE', () => {
+    expect(isLineExport('Some random text')).toBe(false)
+    expect(detectChatSource('Some random text')).toBe('whatsapp')
+  })
+})