@rikaidev/yomi 0.4.2 → 0.5.0

package/dist/line/auth/pwless/index.js

@@ -49,7 +49,7 @@ export const PAAK_AUTH_CLIENT_CEILING_MS = PWLESS_POLL_TIMEOUT_MS * PAAK_AUTH_PO
  * This is an EXTERNAL FACT, not derived from any of our code or protocol
  * traffic. Source: LINE Help Center (zh-Hant),
  * https://help.line.me/line/IOSSecondary/?contentId=20018574&lang=zh-Hant
- * — on the primary device, tick the device signing in and tap 「用戶確認」
+ * — on the primary device, select the device signing in and confirm the user
  * within 3 minutes of the code being displayed.
  */
 export const LINE_PIN_CODE_LIFETIME_MS = 3 * 60 * 1000;

package/dist/line/client/index.js

@@ -128,8 +128,6 @@ export class LineClient extends EventEmitter {
     openAuthSession;
     issueV3TokenForPrimary;
     restoreE2EEKeyBackup;
-    downloadMessageContent;
-    downloadMessageContentPreview;
     logoutZ;
     getOwnedStickerPackages;
     updateChatName;

package/dist/line/client/obs-media-client.js

@@ -9,6 +9,43 @@ const OBS_HOST = 'obs.line-apps.com';
 // (LINE_GW_HOST_DOMAIN). obs.line-apps.com returns 400 for the /oa/ upload
 // route; only the gateway accepts it, and only with an encrypted access token.
 const OBS_UPLOAD_HOST = 'gwz.line.naver.jp';
+/**
+ * Download media sent by a legacy/non-E2EE Talk client.
+ *
+ * These messages do not carry the OID/SID pair used by the newer E2EE OBS
+ * object format.  LINE's self-client protocol exposes them under the message
+ * object route instead:
+ *   GET https://obs.line-apps.com/r/talk/m/{messageId}[\/preview]
+ *
+ * This is deliberately not implemented as a TalkService call.  There is no
+ * `downloadMessageContent*` method on the current `/S4` service; sending such
+ * a Thrift call yields `Invalid method name`.
+ */
+export async function downloadLineMessageData(client, options) {
+    const messageId = String(options.messageId || '').trim();
+    if (!messageId) {
+        throw new Error('LINE legacy media download requires a message id');
+    }
+    const suffix = options.preview ? '/preview' : '';
+    const requestUrl = `https://${OBS_HOST}/r/talk/m/${encodeURIComponent(messageId)}${suffix}`;
+    const response = await fetch(requestUrl, {
+        method: 'GET',
+        headers: {
+            Accept: 'application/json, text/plain, */*',
+            'User-Agent': LINE_APP_CONFIG.userAgent,
+            'X-Line-Access': client.authToken,
+            'X-Line-Application': LINE_APP_CONFIG.lineApp,
+        },
+    });
+    const bytes = Buffer.from(await response.arrayBuffer());
+    if (!response.ok || bytes.length === 0) {
+        throw new Error(`LINE legacy media download failed: status=${response.status} bytes=${bytes.length}`);
+    }
+    return {
+        bytes,
+        mimeType: response.headers.get('content-type')?.split(';', 1)[0] || null,
+    };
+}
 /**
  * Build LINE talk metadata required for OBS media downloads.
  *

package/dist/line/client/parsers.js

@@ -26,6 +26,7 @@ export function parseMessage(msg) {
                 ? Number(msg[7])
                 : (msg[6] ?? msg[7]),
         text: msg[10] || null,
+        contentPreview: msg[17] || null,
         contentType: msg[15] || 0,
         contentMetadata: msg[18] || {},
         chunks: msg[20] || null,

package/dist/line/client/sticker-meta.js

@@ -8,6 +8,30 @@
  * package the caller wants to expand into sendable sticker ids.
  */
 const CDN = 'https://stickershop.line-scdn.net/stickershop/v1/product';
+// Metadata is public and immutable for the lifetime of a picker session. Keep
+// one in-flight/result promise per package so opening the picker or changing
+// locale does not refetch the same package repeatedly.
+const packageMetaCache = new Map();
+/** Pick the title users expect for the app's current language. */
+export function localizedStickerTitle(titles, language = 'en', fallback = '') {
+    const values = titles ?? {};
+    const normalized = language.replace('_', '-').toLowerCase();
+    const preferred = normalized.startsWith('zh')
+        ? ['zh-Hant', 'zh_TW', 'zh-TW', 'zh']
+        : normalized.startsWith('ja')
+            ? ['ja']
+            : ['en'];
+    for (const key of preferred) {
+        const value = values[key];
+        if (typeof value === 'string' && value.trim())
+            return value.trim();
+    }
+    const english = values.en;
+    if (typeof english === 'string' && english.trim())
+        return english.trim();
+    const first = Object.values(values).find((value) => typeof value === 'string' && value.trim());
+    return first?.trim() || fallback;
+}
 /**
  * Fetch one sticker package's public metadata (title + individual sticker ids).
  *
@@ -31,6 +55,14 @@ export async function fetchStickerPackageMeta(packageId) {
             .filter((id) => id !== null),
     };
 }
+export function fetchStickerPackageMetaCached(packageId) {
+    const cached = packageMetaCache.get(packageId);
+    if (cached)
+        return cached;
+    const request = fetchStickerPackageMeta(packageId);
+    packageMetaCache.set(packageId, request);
+    return request;
+}
 /**
  * Fetch one sticker's PNG preview image from the public sticker CDN.
  *

package/dist/line/client/sync-service/client.js

@@ -52,6 +52,29 @@ function buildSyncPayload(runtime, count) {
     ];
     return encodeCallMessage('sync', runtime.seq++, fields);
 }
+/**
+ * A negative revision is uninitialised, never a valid LINE checkpoint.
+ * Short-lived callers (for example the desktop `chats` bridge) call
+ * syncLongPoll directly, so initialise the cursor at the protocol boundary.
+ */
+export async function ensureSyncRevision(runtime, lineLog) {
+    const current = Number(runtime.revision);
+    if (Number.isFinite(current) && current >= 0)
+        return;
+    const result = await runtime.sendTalk('getLastOpRevision', []);
+    if (result.fields?.[1]) {
+        const exc = result.fields[1];
+        lineLog.error('revision.fetch.failed', { error: JSON.stringify(exc) });
+        throw new Error(`getLastOpRevision: ${exc[2] || exc[1] || 'unknown'}`);
+    }
+    const rawRevision = result.fields?.[0];
+    const revision = typeof rawRevision === 'bigint' ? Number(rawRevision) : Number(rawRevision);
+    if (!Number.isFinite(revision) || revision < 0) {
+        throw new Error(`getLastOpRevision returned invalid revision: ${String(rawRevision)}`);
+    }
+    runtime.revision = revision;
+    lineLog.info('revision.fetch', { type: typeof rawRevision, value: revision });
+}
 /**
  * Parse raw LINE operations into normalized operation objects.
  *
@@ -99,15 +122,18 @@ function throwSyncException(result, lineLog) {
  * @param response - Top-level sync response payload.
  * @returns Raw operations array.
  */
-function updateSyncRevisions(runtime, response) {
+export function updateSyncRevisions(runtime, response) {
     const operationResponse = response?.[1];
     const ops = operationResponse?.[1];
     const nextRevision = response?.[2];
     const lastGlobalRevision = operationResponse?.[2];
     const lastIndividualRevision = operationResponse?.[3];
     if (typeof nextRevision === 'number' || typeof nextRevision === 'bigint') {
-        runtime.revision =
-            typeof nextRevision === 'bigint' ? Number(nextRevision) : nextRevision;
+        const candidate = typeof nextRevision === 'bigint' ? Number(nextRevision) : nextRevision;
+        if (Number.isFinite(candidate) &&
+            candidate >= Number(runtime.revision || 0)) {
+            runtime.revision = candidate;
+        }
     }
     if (typeof lastGlobalRevision === 'number' ||
         typeof lastGlobalRevision === 'bigint') {
@@ -218,6 +244,7 @@ export function createSyncClient(runtime) {
          * @returns Parsed operations.
          */
         async sync(count = 50) {
+            await ensureSyncRevision(runtime, getLineLog(runtime));
             const data = buildSyncPayload(runtime, count);
             const result = await sendRequest(runtime.host, LINE_APP_CONFIG.syncPath, data, { 'X-Line-Access': runtime.authToken }, 10000);
             if (result.error === 'timeout') {
@@ -236,6 +263,7 @@ export function createSyncClient(runtime) {
         async syncLongPoll(count = 50, timeoutMs = 60000) {
             const lineLog = getLineLog(runtime);
             const startedAt = Date.now();
+            await ensureSyncRevision(runtime, lineLog);
             const data = buildSyncPayload(runtime, count);
             const result = await sendRequest(runtime.host, LINE_APP_CONFIG.syncPath, data, { 'X-Line-Access': runtime.authToken }, timeoutMs + 5000);
             if (result.error === 'timeout') {

package/dist/line/client/talk-service/contact-query.js

@@ -8,7 +8,10 @@ function normalizeNumericValue(value) {
     if (typeof value === 'bigint') {
         return Number(value);
     }
-    return value || null;
+    if (value === null || value === undefined || value === '')
+        return null;
+    const number = Number(value);
+    return Number.isFinite(number) ? number : null;
 }
 /**
  * Extract profile fields from one raw contact struct.
@@ -27,6 +30,10 @@ function mapContactProfileFields(contact) {
         picturePath: contact[37] || null,
         statusMessageContentMetadata: contact[43] || {},
         profileId: contact[49] || null,
+        attributes: normalizeNumericValue(contact[35]),
+        settings: normalizeNumericValue(contact[36]),
+        notificationDisabled: Boolean((normalizeNumericValue(contact[36]) ?? 0) & 1),
+        isOfficial: Boolean((normalizeNumericValue(contact[35]) ?? 0) & 32),
     };
 }
 /**

package/dist/line/client/talk-service/message-box-query.js

@@ -106,6 +106,23 @@ export function mapMessageBoxList(boxes) {
             .filter(Boolean)
         : [];
 }
+/** Merge paged message boxes without duplicate rows and stop on a stalled cursor. */
+export function mergeMessageBoxPages(pages) {
+    const merged = new Map();
+    for (const page of pages) {
+        for (const box of page.messageBoxes ?? []) {
+            if (box?.id)
+                merged.set(String(box.id), box);
+        }
+    }
+    return [...merged.values()];
+}
+export function nextMessageBoxCursor(boxes, previous) {
+    const next = String(boxes.at(-1)?.id ?? '');
+    if (!next || next === previous)
+        return undefined;
+    return next;
+}
 /**
  * Emit one debug log for previous-message responses.
  *

package/dist/line/client/talk-service/query-client.js

@@ -6,9 +6,9 @@
 import { parseMessages } from '../parsers.js';
 import { fetchChats } from './chat-query.js';
 import { mapContactList } from './contact-query.js';
-import { buildEndMessageIdFields, buildMessageBoxRequest, logPreviousMessagesResponse, logRecentMessagesResponse, mapMessageBoxList, } from './message-box-query.js';
+import { buildEndMessageIdFields, buildMessageBoxRequest, logPreviousMessagesResponse, logRecentMessagesResponse, mapMessageBoxList, mergeMessageBoxPages, nextMessageBoxCursor, } from './message-box-query.js';
 import { fetchMessagesByIds } from './message-id-query.js';
-import { buildDownloadMessageContentRequest, buildGetAllChatMidsRequest, buildGetAllContactIdsRequest, buildGetMessageBoxesRequest, buildMidListRequest, buildMidLookupRequest, buildPreviousMessagesRequest, buildRecentMessagesRequest, } from './requests.js';
+import { buildGetAllChatMidsRequest, buildGetAllContactIdsRequest, buildGetMessageBoxesRequest, buildMidListRequest, buildMidLookupRequest, buildPreviousMessagesRequest, buildRecentMessagesRequest, } from './requests.js';
 /** Sync reason constant matching CHRLINE reference. */
 const SYNC_REASON = 7;
 /** Sync reason used by getPreviousMessagesV2WithRequest for secondary-device history sync. */
@@ -122,6 +122,36 @@ export function createTalkQueryClient(runtime) {
                 hasNext: Boolean(root?.[2]),
             };
         },
+        /** Retrieve every message box using the server's min/max chat cursor. */
+        async getAllMessageBoxes(options = {}) {
+            const pageSize = Math.max(1, options.messageBoxCountLimit ?? 100);
+            const pages = [];
+            // getMessageBoxes paginates toward older boxes with minChatId. Using
+            // maxChatId here makes LINE repeat almost the whole first page (and can
+            // make a full inbox look capped at 100 rows).
+            let minChatId = options.minChatId;
+            const seenCursors = new Set();
+            for (;;) {
+                const page = await this.getMessageBoxes({
+                    ...options,
+                    messageBoxCountLimit: pageSize,
+                    ...(minChatId ? { minChatId } : {}),
+                });
+                pages.push(page);
+                const boxes = page.messageBoxes;
+                if (!page.hasNext || boxes.length === 0)
+                    break;
+                const next = nextMessageBoxCursor(boxes, minChatId);
+                if (!next || seenCursors.has(next))
+                    break;
+                seenCursors.add(next);
+                minChatId = next;
+            }
+            return {
+                messageBoxes: mergeMessageBoxPages(pages),
+                hasNext: false,
+            };
+        },
         /**
          * Retrieve previous messages through one message-box cursor.
          *
@@ -191,29 +221,5 @@ export function createTalkQueryClient(runtime) {
             logRecentMessagesResponse(chatId, count, raw, messages);
             return messages;
         },
-        /**
-         * Retrieve binary media content for one LINE message.
-         *
-         * @param messageId - LINE message identifier.
-         * @param requestId - Client request identifier.
-         * @returns Message content bytes.
-         */
-        async downloadMessageContent(messageId, requestId = `yomi-${Date.now()}`) {
-            const result = await runtime.sendTalk('downloadMessageContent', buildDownloadMessageContentRequest(requestId, messageId));
-            const content = result.fields?.[0];
-            return Buffer.isBuffer(content) ? content : Buffer.from(content || '');
-        },
-        /**
-         * Retrieve binary preview media content for one LINE message.
-         *
-         * @param messageId - LINE message identifier.
-         * @param requestId - Client request identifier.
-         * @returns Message preview bytes.
-         */
-        async downloadMessageContentPreview(messageId, requestId = `yomi-${Date.now()}`) {
-            const result = await runtime.sendTalk('downloadMessageContentPreview', buildDownloadMessageContentRequest(requestId, messageId));
-            const content = result.fields?.[0];
-            return Buffer.isBuffer(content) ? content : Buffer.from(content || '');
-        },
     };
 }

package/dist/line/client/talk-service/requests.js

@@ -148,16 +148,6 @@ export function buildPreviousMessagesRequest(request, endMessageIdFields, syncRe
 export function buildRecentMessagesRequest(chatId, count) {
     return [stringField(2, chatId), i32Field(3, count)];
 }
-/**
- * Build a message-content download request.
- *
- * @param requestId - Client request identifier.
- * @param messageId - LINE message identifier.
- * @returns Thrift request fields.
- */
-export function buildDownloadMessageContentRequest(requestId, messageId) {
-    return [stringField(1, requestId), stringField(2, messageId)];
-}
 /**
  * Build a single-MID lookup request.
  *
@@ -300,7 +290,7 @@ export function buildCreateChatRequest(name, mids, chatType = 1) {
  * Single struct arg at field 1: `{ reqSeq, messageId, reactionType{ predefined } }`.
  * The messageId is a thrift i64 (LINE message ids are 64-bit), so it is passed
  * as a BigInt. `reactionType` is LINE's predefinedReactionType enum:
- * 2 = LIKE 👍, 3 = LOVE ❤️, 4 = LAUGH 😆, 5 = SURPRISE 😮, 6 = SAD 😢, 7 = ANGRY 😡.
+ * Protocol emoji mapping: 2 = LIKE 👍, 3 = LOVE ❤️, 4 = LAUGH 😆, 5 = SURPRISE 😮, 6 = SAD 😢, 7 = ANGRY 😡.
  *
  * @param messageId - Target message id (numeric string).
  * @param reactionType - Predefined reaction type (default 2 = LIKE).

package/dist/line/core/auth-session-runtime.js

@@ -58,7 +58,9 @@ async function restoreE2EEState(service, lineLog) {
  * @param lineLog - Logger instance.
  */
 async function restoreBootstrapKeys(service, lineLog) {
-    const bootstrapKeys = await recoverBootstrapKeys(service);
+    // Resume is intentionally read-only.  Recovered keys are imported into
+    // this process but are not written back to the durable Keychain blob.
+    const bootstrapKeys = await recoverBootstrapKeys(service, { persist: false });
     if (bootstrapKeys?.length) {
         service.e2eeWarning = false;
         service.emit('e2eeWarning', {
@@ -89,6 +91,11 @@ async function validateRestoredSession(service, lineLog) {
         const profile = await service.client.getProfile();
         if (profile) {
             service.profile = profile;
+            // Session resume is a read-only/background path.  Persisting profile
+            // metadata here rewrites the entire macOS Keychain blob on every
+            // desktop polling process and triggers a security permission prompt.
+            // Login and explicit account changes own durable profile writes; a
+            // resume may use this in-memory profile for the current request only.
             lineLog.info('session.restore.validated', {
                 profile: profile.displayName || profile.mid,
             });
@@ -130,6 +137,14 @@ async function handleSessionValidationError(service, lineLog, validationErr) {
         return false;
     }
     if (AUTH_ERROR_REGEX.test(msg)) {
+        if (process.env.YOMI_READ_ONLY_SESSION === '1') {
+            lineLog.info('auth.refresh.skip', { reason: 'read_only_session' });
+            service.loginRequired = true;
+            service.loginReason = 'expired';
+            service.setState(STATE.DISCONNECTED);
+            service.emit('line:loginRequired');
+            return false;
+        }
         lineLog.info('session.restore.refresh_attempt');
         const refreshed = await tryRefreshToken(service);
         if (refreshed) {

package/dist/line/core/chat-event.js

@@ -0,0 +1,33 @@
+export function chatEventParticipantMids(message) {
+    if (Number(message?.contentType) !== 18)
+        return [];
+    const raw = message?.contentMetadata?.LOC_ARGS;
+    if (typeof raw !== 'string')
+        return [];
+    return raw
+        .split('\u001e')
+        .map((value) => value.trim())
+        .filter((value) => value.startsWith('u'));
+}
+/**
+ * Interpret LINE's private ChatEvent localization keys observed in real group
+ * traffic. Unknown keys remain explicit so new events never masquerade as a
+ * decoded action.
+ */
+export function interpretChatEvent(message, names) {
+    const key = typeof message?.contentMetadata?.LOC_KEY === 'string'
+        ? message.contentMetadata.LOC_KEY
+        : '';
+    const mids = chatEventParticipantMids(message);
+    const name = (index) => names.get(mids[index]) || '一位成員';
+    switch (key) {
+        case 'C_GI':
+            return mids.length >= 2
+                ? `${name(0)} 邀請 ${name(1)} 加入群組`
+                : '有人邀請成員加入群組';
+        case 'C_MJ':
+            return mids.length >= 1 ? `${name(0)} 加入群組` : '有成員加入群組';
+        default:
+            return key ? `[聊天室活動：${key}]` : '[聊天室活動]';
+    }
+}

package/dist/line/core/chat-runtime-service.js

@@ -154,26 +154,6 @@ export function createChatRuntimeService(service) {
         async getPreviousMessages(chatId, count = 50, before = {}) {
             return createMessageQueryService(() => service.client, service.e2eeManager).getPreviousMessages(chatId, count, before);
         },
-        /**
-         * Download the original LINE content bytes for one message.
-         *
-         * @param messageId - LINE message identifier.
-         * @param requestId - Optional request identifier.
-         * @returns Original message content bytes.
-         */
-        async downloadMessageContent(messageId, requestId) {
-            return createMessageQueryService(() => service.client, service.e2eeManager).downloadMessageContent(messageId, requestId);
-        },
-        /**
-         * Download the LINE preview bytes for one message.
-         *
-         * @param messageId - LINE message identifier.
-         * @param requestId - Optional request identifier.
-         * @returns Preview content bytes.
-         */
-        async downloadMessageContentPreview(messageId, requestId) {
-            return createMessageQueryService(() => service.client, service.e2eeManager).downloadMessageContentPreview(messageId, requestId);
-        },
         /**
          * Mark a LINE conversation read up to a message via the explicit
          * sendChatChecked boundary. When messageId is omitted, resolves the most

package/dist/line/core/directory-runtime-service.js

@@ -1,7 +1,7 @@
 /**
  * LINE core directory/runtime capability.
  */
-import { fetchStickerPackageMeta } from '../client/sticker-meta.js';
+import { fetchStickerPackageMeta, localizedStickerTitle, } from '../client/sticker-meta.js';
 import { createContactQueryService } from './contact-query-service.js';
 import { createGroupQueryService } from './group-query-service.js';
 /**
@@ -46,7 +46,15 @@ export function createDirectoryRuntimeService(service) {
          * @returns Owned sticker packages: { packageId, title, version }.
          */
         async listStickerPackages(language = 'en') {
-            return service.client.getOwnedStickerPackages(language);
+            const owned = await service.client.getOwnedStickerPackages(language);
+            return Promise.all(owned.map(async (pkg) => {
+                const meta = await fetchStickerPackageMeta(String(pkg.packageId)).catch(() => null);
+                return {
+                    ...pkg,
+                    title: localizedStickerTitle(meta?.title, language, pkg.title),
+                    titles: meta?.title ?? {},
+                };
+            }));
         },
         /**
          * Search the account's OWNED sticker packages by title substring, and

package/dist/line/core/e2ee/recovery/bootstrap-keys.js

@@ -12,7 +12,7 @@ import { decryptKeyChain } from '../index.js';
  * @param service - LineProtocolService-like object
  * @returns Recovered key list, or null when bootstrap material is unavailable
  */
-export async function recoverBootstrapKeys(service) {
+export async function recoverBootstrapKeys(service, options = {}) {
     const bootstrapInput = await readBootstrapRecoveryInput(service);
     if (!bootstrapInput) {
         return null;
@@ -21,7 +21,13 @@ export async function recoverBootstrapKeys(service) {
     if (!keys) {
         return null;
     }
-    await persistRecoveredKeys(service, keys, bootstrapInput.mid);
+    service.e2eeManager.importKeys(keys);
+    if (bootstrapInput.mid) {
+        service.e2eeManager.bindSelfKeysToMid(bootstrapInput.mid);
+    }
+    if (options.persist !== false) {
+        await service.sessionState.saveE2EEKeys(keys);
+    }
     return keys;
 }
 /**
@@ -122,20 +128,6 @@ function rebuildBootstrapKeys(input) {
     }));
     return Array.isArray(keys) && keys.length > 0 ? keys : null;
 }
-/**
- * Persist recovered keys into the in-memory manager and session state.
- *
- * @param service - LineProtocolService-like object.
- * @param keys - Recovered key list.
- * @param mid - Optional self MID.
- */
-async function persistRecoveredKeys(service, keys, mid) {
-    service.e2eeManager.importKeys(keys);
-    if (mid) {
-        service.e2eeManager.bindSelfKeysToMid(mid);
-    }
-    await service.sessionState.saveE2EEKeys(keys);
-}
 /**
  * Decode a base64-encoded string into a Buffer when possible.
  *

package/dist/line/core/flex-message.js

@@ -0,0 +1,130 @@
+const FLEX_PAYLOAD_KEYS = [
+    'FLEX_JSON',
+    'FLEX_CONTENTS',
+    'FLEX_MESSAGE',
+    'CONTENTS',
+    'MARKUP_JSON',
+];
+function parseObject(value) {
+    if (typeof value !== 'string')
+        return value;
+    const trimmed = value.trim();
+    if (!trimmed.startsWith('{') && !trimmed.startsWith('['))
+        return null;
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        return null;
+    }
+}
+function webUrl(value) {
+    if (typeof value !== 'string')
+        return null;
+    try {
+        const url = new URL(value);
+        return url.protocol === 'http:' || url.protocol === 'https:'
+            ? url.toString()
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Interpret LINE bubble/carousel content in header→hero→body→footer order. */
+export function interpretFlexPayload(payload) {
+    const texts = [];
+    const images = [];
+    const actions = [];
+    const seen = new Set();
+    let visited = 0;
+    const addText = (value) => {
+        if (typeof value !== 'string')
+            return;
+        const clean = value.replace(/\s+/g, ' ').trim();
+        if (clean && !texts.includes(clean))
+            texts.push(clean);
+    };
+    const walk = (raw, depth = 0) => {
+        if (depth > 24 || visited >= 800)
+            return;
+        const value = parseObject(raw);
+        if (!value || typeof value !== 'object' || seen.has(value))
+            return;
+        seen.add(value);
+        visited += 1;
+        if (Array.isArray(value)) {
+            for (const item of value)
+                walk(item, depth + 1);
+            return;
+        }
+        const node = value;
+        const type = typeof node.type === 'string' ? node.type.toLowerCase() : '';
+        if (type === 'text' || type === 'span')
+            addText(node.text);
+        if (type === 'image' || type === 'video') {
+            const image = webUrl(node.url) || webUrl(node.previewUrl);
+            if (image && !images.includes(image))
+                images.push(image);
+        }
+        const action = parseObject(node.action);
+        if (action && typeof action === 'object' && !Array.isArray(action)) {
+            const record = action;
+            const label = [record.label, record.displayText, record.text].find((item) => typeof item === 'string' && item.trim().length > 0) ?? '';
+            const url = webUrl(record.uri);
+            if (label || url)
+                actions.push({ label: label.trim(), url });
+        }
+        const ordered = [
+            'header',
+            'hero',
+            'body',
+            'footer',
+            'contents',
+            'altContent',
+        ];
+        for (const key of ordered)
+            if (key in node)
+                walk(node[key], depth + 1);
+        for (const [key, child] of Object.entries(node)) {
+            if (ordered.includes(key) ||
+                ['action', 'type', 'text', 'url', 'previewUrl'].includes(key))
+                continue;
+            if (child && typeof child === 'object')
+                walk(child, depth + 1);
+        }
+    };
+    walk(payload);
+    const machineLabels = new Set(['uri', 'url', 'link', 'open', 'action']);
+    const actionLabels = actions.map((item) => item.label).filter(Boolean);
+    const readableActionLabels = actionLabels.filter((label) => !machineLabels.has(label.toLowerCase()));
+    const readable = [
+        ...texts,
+        ...readableActionLabels.filter((label) => !texts.includes(label)),
+    ];
+    return {
+        summary: readable.join(' · ').slice(0, 700),
+        imageUrl: images[0] ?? null,
+        actionUrl: actions.find((item) => item.url)?.url ?? null,
+        actionLabels,
+    };
+}
+export function interpretFlexMessage(message) {
+    const metadata = message?.contentMetadata && typeof message.contentMetadata === 'object'
+        ? message.contentMetadata
+        : {};
+    for (const key of FLEX_PAYLOAD_KEYS) {
+        const parsed = parseObject(metadata[key]);
+        if (parsed)
+            return interpretFlexPayload(parsed);
+    }
+    const textPayload = parseObject(message?.text);
+    return textPayload
+        ? interpretFlexPayload(textPayload)
+        : {
+            summary: '',
+            imageUrl: null,
+            actionUrl: null,
+            actionLabels: [],
+        };
+}

package/dist/line/core/mention.js

@@ -10,7 +10,7 @@
  * - `M` is the mentioned user's MID; `S`/`E` are the start/end offsets as
  *   *strings*, not numbers.
  * - The range is half-open `[S, E)`, measured in UTF-16 code units — i.e.
- *   plain JS string indices (`"@鄭富源".length === 4` matched `S:"0", E:"4"`).
+ *   plain JavaScript string indices (a three-code-unit name plus `@` matched `S:"0", E:"4"`).
  * - Key order inside a mentionee object is not significant.
  * - MENTION rides in `contentMetadata`, which is never part of an E2EE
  *   ciphertext payload — it was observed in the clear on a real message.