@ardennguyen/zalo-agent-cli 2.5.9 → 3.0.0

package/src/core/sync-v2/message-types.js

@@ -1,522 +0,0 @@
-/**
- * Classify and unpack messages coming out of the transfer-sync-v2 protobuf.
- *
- * The sync payload is NOT the same shape as a live listener event. `Message`
- * carries a numeric `msgType` and a **string** `content` (protobuf field 7),
- * with everything else — attachments, quote, mentions, TTL, bubble styling —
- * hanging off `meta` (field 8). Media is present only as CDN references:
- * `attach.href` / `attach.thumb` plus a JSON `attach.params` blob. No file
- * bytes ever travel in the sync stream.
- *
- * Because `content` is always a string, a `typeof content === "string"` test
- * can't tell text from a photo — the numeric `msgType` and the attachment
- * shape are the only real signals, which is what this module reads.
- *
- * msgType numbers were recovered empirically from a decoded sync capture and
- * cross-checked against Zalo Web's own switch statements (MSG_PHOTO /
- * MSG_PHOTO_2 / MSG_VIDEO / MSG_FILE / MSG_CONTACT). Zalo adds types over
- * time, so an unknown number degrades to `type_<n>` and — critically — still
- * keeps its full `meta`, rather than being silently flattened to text.
- */
-
-/** Numeric sync msgType -> stable CLI type name. */
-export const SYNC_MSG_TYPES = {
-    0: "text",
-    // A doodle (hand drawing). Measured: the same doodle arrives live as
-    // chat.doodle and from a sync as msgType 2 with a photo-CDN .jpg, which
-    // unmapped was stored as type_2.
-    2: "doodle",
-    3: "photo", // MSG_PHOTO
-    4: "photo", // MSG_PHOTO_2 (jxl-capable variant)
-    // A voice note. Measured: attach href on f2-voice-aac-dl.zdn.vn (.aac),
-    // params m4a/duration/waveformSamples. Unmapped, it was stored as type_6
-    // with a non-media kind, so has_attachment stayed 0 and the audio was
-    // silently never downloaded.
-    6: "voice",
-    10: "sticker",
-    12: "link", // link/media preview, action "recommened.link"
-    15: "card", // OA / system rich card, attach.type "l.a.*"
-    18: "location", // shared location; attach params carry latitude/longitude
-    19: "video", // MSG_VIDEO
-    20: "group_event", // action "msginfo.actionlist"
-    21: "profile_card", // action "show.profile"
-    22: "file", // MSG_FILE
-    23: "gif",
-    24: "event", // zinstant template event (reminders, todos, ...)
-    26: "poll_event",
-    36: "deleted", // undone/recalled; content empty, params.is_deleted
-};
-
-/**
- * CDN host families, used to classify media when `msgType` is unknown.
- * Zalo shards these numerically (photo-stal-10, photo-stal-35, ...), so the
- * patterns match the family rather than a specific host.
- */
-const HOST_KINDS = [
-    [/(^|\.)photo-stal-\d+\./i, "photo"],
-    [/(^|\.)video-stal-\d+\./i, "video"],
-    [/(^|\.)file-stal-\d+\./i, "file"],
-    [/(^|\.)zalo-gif\./i, "gif"],
-];
-
-/** Types whose payload points at a downloadable binary. */
-export const MEDIA_TYPES = new Set(["photo", "video", "file", "gif", "voice", "audio", "doodle"]);
-
-/** Parse a JSON string field that Zalo sometimes leaves empty or malformed. */
-function parseJson(value) {
-    if (!value || typeof value !== "string") return null;
-    try {
-        return JSON.parse(value);
-    } catch {
-        return null;
-    }
-}
-
-/** Classify a single attachment by the URL it points at. */
-function kindFromUrl(url) {
-    if (!url) return null;
-    let host;
-    try {
-        host = new URL(url).host;
-    } catch {
-        return null;
-    }
-    for (const [re, kind] of HOST_KINDS) if (re.test(host)) return kind;
-    return null;
-}
-
-/** First non-empty value among the given params keys. */
-function pick(params, ...keys) {
-    if (!params) return undefined;
-    for (const k of keys) {
-        const v = params[k];
-        if (v !== undefined && v !== null && v !== "" && v !== 0) return v;
-    }
-    return undefined;
-}
-
-/**
- * Unpack `meta.attachsList` into a flat, download-ready shape.
- *
- * Kind resolution is deliberately belt-and-braces: the message's own type
- * wins, but a recognised CDN host can still classify an attachment hanging
- * off a msgType this build has never seen.
- *
- * @param {object} msg - a decoded Sync2.Message.Message (jspb toObject form)
- * @param {string} [msgTypeName] - resolved type name, if already computed
- * @returns {Array<object>} one entry per attachment that carries something useful
- */
-export function extractSyncAttachments(msg, msgTypeName) {
-    const type = msgTypeName || SYNC_MSG_TYPES[msg?.msgType] || `type_${msg?.msgType}`;
-    const out = [];
-    for (const a of msg?.meta?.attachsList || []) {
-        const params = parseJson(a.params) || {};
-        const extInfo = parseJson(a.extInfo);
-        const kind = kindFromUrl(a.href) || (MEDIA_TYPES.has(type) ? type : null) || (a.catId ? "sticker" : null);
-
-        // Fields the normalized shape below does not otherwise name. Carried
-        // verbatim so nothing the phone sent is lost: a later build must be
-        // able to read what this one does not understand, and `params` in
-        // particular holds per-type detail (OCR status, content ids, video
-        // codec settings) that no fixed field list would keep up with.
-        const verbatim = {
-            attachType: a.type || undefined,
-            childNumber: a.childNumber || undefined,
-            extInfo: extInfo || a.extInfo || undefined,
-            params: Object.keys(params).length ? params : a.params || undefined,
-            remains: parseJson(a.remains) || a.remains || undefined,
-            zinstantData: a.zinstantData || undefined,
-            zinstantMsg: a.zinstantMsg || undefined,
-        };
-
-        // A sticker is identified by catalogue + id, not a URL.
-        if (kind === "sticker" || (type === "sticker" && a.catId)) {
-            out.push({
-                kind: "sticker",
-                catId: a.catId ?? null,
-                stickerId: a.id ?? null,
-                stickerType: a.type ?? null,
-                ...verbatim,
-            });
-            continue;
-        }
-
-        const url = a.href || undefined;
-        const thumbUrl = a.thumb || undefined;
-        if (!url && !thumbUrl) {
-            // Pure action/system attachment (group events, zinstant templates).
-            // Keep it only when it carries a payload worth reading back.
-            if (a.action || a.title || Object.keys(params).length) {
-                out.push({
-                    kind: kind || "meta",
-                    action: a.action || undefined,
-                    title: a.title || undefined,
-                    description: a.description || undefined,
-                    catId: a.catId || undefined,
-                    itemId: a.id || undefined,
-                    ...verbatim,
-                });
-            }
-            continue;
-        }
-
-        out.push({
-            // Fall back to the message's own type, NOT a blanket "link": an OA
-            // notification card and a profile card both carry an href, and
-            // calling them links makes "show me the links in this thread"
-            // return mostly notifications. Zalo Web is equally narrow — its
-            // Link store takes only action "recommened.link".
-            kind: kind || type,
-            url,
-            thumbUrl,
-            // Photos carry a separate full-resolution URL in params.hd.
-            hdUrl: typeof params.hd === "string" && params.hd ? params.hd : undefined,
-            title: a.title || undefined,
-            description: a.description || undefined,
-            action: a.action || undefined,
-            fileName: type === "file" ? a.title || undefined : undefined,
-            ext: params.fileExt || undefined,
-            size: Number(pick(params, "fileSize", "video_file_size")) || undefined,
-            checksum: params.checksum || undefined,
-            width: Number(pick(params, "width", "video_width", "tWidth")) || undefined,
-            height: Number(pick(params, "height", "video_height", "tHeight")) || undefined,
-            duration: Number(pick(params, "duration")) || undefined,
-            // Mobile-only renewal hints. Zalo Web never sends these; the phone
-            // uses them to re-upload media whose CDN copy has aged out.
-            urlToRenew: pick(params, "fileUrlToRenew", "video_url_to_renew") || undefined,
-            thumbUrlToRenew: pick(params, "thumbUrlToRenew", "thumb_url_to_renew") || undefined,
-            catId: a.catId || undefined,
-            itemId: a.id || undefined,
-            ...verbatim,
-        });
-    }
-    return out;
-}
-
-// A template placeholder Zalo left for us to fill: `%1$s`, `%2$s`, …
-// Two constants on purpose: `.test()` on a /g regex advances lastIndex and so
-// answers differently on identical input depending on call order.
-const POSITIONAL = /%\d+\$s/;
-const POSITIONAL_ALL = /%(\d+)\$s/g;
-
-/**
- * The values a system-event template interpolates, in `%1$s`, `%2$s` order.
- *
- * Group events carry them as a highlight list — one entry per placeholder, the
- * actor first. Poll events carry no list at all: the actor and the poll are
- * named fields, used in that order by every poll template Zalo sends.
- */
-function systemEventArgs(source, params = source) {
-    const highlights = source?.highLightsV2 ?? source?.highLights ?? params?.highLightsV2 ?? params?.highLights;
-    if (Array.isArray(highlights) && highlights.length) {
-        return highlights.map((h) => (typeof h?.dpn === "string" ? h.dpn : ""));
-    }
-    return [params?.dName, params?.question].filter((v) => typeof v === "string");
-}
-
-/** Substitute a template's positional placeholders, leaving any it cannot fill. */
-function fillTemplate(template, args) {
-    return template.replace(POSITIONAL_ALL, (placeholder, position) => {
-        const value = args[Number(position) - 1];
-        return typeof value === "string" && value !== "" ? value : placeholder;
-    });
-}
-
-/**
- * Localised system-event sentence, preferring Vietnamese then English.
- *
- * Zalo sends the template in two places. The phone nests it under
- * `params.customMsg.msg`; the live socket puts it straight on `params.msg`, and
- * reading only the nested form meant every reminder, poll and membership event
- * captured live fell through to a bare `[poll_event]`.
- *
- * Either way the template is printf-positional — "%1$s khóa bình chọn: %2$s" —
- * so returning it unfilled would store the placeholders verbatim.
- */
-function customMsgText(params) {
-    // The template and the values it interpolates travel together: the phone
-    // nests BOTH under `customMsg`, the live socket puts both at the top of
-    // `params`. Taking the template from one and the highlights from the other
-    // is what left nine cached rows reading "%1$s tạo nhắc hẹn mới %2$s – %3$s".
-    const source = params?.customMsg?.msg ? params.customMsg : params;
-    const msg = source?.msg;
-    if (!msg) return null;
-    const template = typeof msg === "string" ? msg : msg.vi || msg.en || Object.values(msg)[0];
-    if (typeof template !== "string" || !template) return null;
-    return fillTemplate(template, systemEventArgs(source, params));
-}
-
-/**
- * Best-effort human-readable text for a synced message.
- *
- * For media the caption lives in `content` and is frequently empty, so the
- * fallback is a type marker plus whatever identifying detail the attachment
- * carries (a filename, a link title). That keeps `text` searchable instead of
- * leaving a blank row, which is what the previous implementation produced for
- * roughly one row in seven.
- *
- * @param {object} msg - decoded sync message
- * @param {string} type - resolved type name
- * @param {Array<object>} attachments - from extractSyncAttachments()
- * @returns {string}
- */
-export function extractSyncText(msg, type, attachments = []) {
-    const content = typeof msg?.content === "string" ? msg.content.trim() : "";
-    const a = attachments[0] || {};
-    const params = parseJson(msg?.meta?.attachsList?.[0]?.params) || {};
-
-    // A styled message (`action: "rtf"`) is ordinary text whose body Zalo moves
-    // into the attachment title so the style ranges have something to index.
-    // Returning `content` alone stored the literal string "[text]" for it.
-    if (type === "text") return content || a.title || "";
-    if (content && type !== "deleted") {
-        // A real caption / body — keep it verbatim.
-        if (type !== "event" && type !== "group_event" && type !== "poll_event") return content;
-    }
-
-    switch (type) {
-        case "deleted":
-            return "[deleted]";
-        case "sticker":
-            return a.catId ? `[sticker ${a.catId}/${a.stickerId}]` : "[sticker]";
-        case "file":
-            return a.fileName ? `[file] ${a.fileName}` : "[file]";
-        case "photo":
-        case "video":
-        case "gif":
-            return a.title ? `[${type}] ${a.title}` : `[${type}]`;
-        case "link":
-        case "card":
-        case "profile_card":
-            return [a.title, a.description, a.url].filter(Boolean).join(" — ") || `[${type}]`;
-        case "event":
-        case "group_event":
-        case "poll_event": {
-            // Zalo also ships the sentence pre-rendered in the attachment title
-            // for some events. Prefer our own fill, but when the payload did not
-            // carry every value the template asks for, that title is the better
-            // reading than a sentence with "%2$s" left in it.
-            const rendered = customMsgText(params);
-            if (rendered && !POSITIONAL.test(rendered)) return rendered;
-            // A half-filled template reads as a bug to anyone scrolling history,
-            // so it is never stored: Zalo's pre-rendered title, the body, or an
-            // honest type marker all beat leaking "%2$s" into the text column.
-            return a.title || content || `[${type}]`;
-        }
-        default:
-            return content || (a.title ? `[${type}] ${a.title}` : `[${type}]`);
-    }
-}
-
-/**
- * Turn one decoded sync message into the row this CLI stores.
- *
- * `raw_data` keeps the whole payload — including `cliMsgId`, which makes a
- * synced row usable as a reply/forward anchor the way a listener-captured row
- * already is.
- *
- * @param {object} msg - decoded Sync2.Message.Message (jspb toObject form)
- * @returns {{type: string, text: string, hasAttachment: boolean, attachments: Array<object>, raw: object}}
- */
-export function classifySyncMessage(msg) {
-    const type = SYNC_MSG_TYPES[msg?.msgType] ?? `type_${msg?.msgType}`;
-    const attachments = extractSyncAttachments(msg, type);
-    const text = extractSyncText(msg, type, attachments);
-    const meta = msg?.meta || {};
-    // "Has an attachment" means "has a file worth fetching". A link-preview
-    // card carries a URL too, but it points at a web page, so counting it
-    // would make the pending-media figure disagree with what can actually be
-    // downloaded — and `has_attachment` is exactly what the downloader reads.
-    const downloadable = attachments.filter((a) => (a.url || a.thumbUrl) && MEDIA_TYPES.has(a.kind));
-
-    return {
-        type,
-        text,
-        hasAttachment: downloadable.length > 0,
-        attachments,
-        raw: {
-            src: "sync-v2",
-            msgType: msg?.msgType,
-            msgStatus: msg?.msgStatus,
-            cliMsgId: msg?.clientId === undefined || msg?.clientId === null ? undefined : String(msg.clientId),
-            content: typeof msg?.content === "string" && msg.content ? msg.content : undefined,
-            attachments: attachments.length ? attachments : undefined,
-            // Everything else the payload carried, kept verbatim so a later
-            // build can read fields this one doesn't understand yet.
-            quote: meta.quote || undefined,
-            mentions: meta.mentionsList?.length ? meta.mentionsList : undefined,
-            reference: meta.reference || undefined,
-            property: meta.property || undefined,
-            ttl: meta.ttl ? Number(meta.ttl) : undefined,
-        },
-    };
-}
-
-/**
- * zca-js live-event msgType -> the SAME vocabulary the sync path uses.
- *
- * The listener and the mobile sync describe identical things in different
- * words: a photo arrives as `chat.photo` live and as numeric msgType 3 from the
- * phone. Stored verbatim, `WHERE type = 'photo'` silently misses every
- * listener-captured row and `WHERE type = 'chat.photo'` misses every synced
- * one. One vocabulary, one set of queries.
- */
-export const LIVE_MSG_TYPES = {
-    webchat: "text",
-    "chat.photo": "photo",
-    "chat.video.msg": "video",
-    "share.file": "file",
-    "chat.gif": "gif",
-    "chat.sticker": "sticker",
-    "chat.voice": "voice",
-    "chat.doodle": "doodle",
-    "chat.link": "link",
-    "chat.recommended": "link",
-    "chat.zalo.me": "link",
-    "chat.location.new": "location",
-    "chat.todo": "event",
-    // Zalo's "zinstant" rich content -- a bank card is one. Measured: the same
-    // action zinstant.bankcard arrives as chat.webcontent live and as msgType 24
-    // from a sync, so unmapped it was stored under the raw spelling live.
-    "chat.webcontent": "event",
-    "group.poll": "poll_event",
-    "chat.undo": "deleted",
-    "chat.delete": "deleted",
-    "chat.ecard": "card",
-};
-
-/** Read `params` from a live payload, which may be an object or a JSON string. */
-function liveParams(content) {
-    const p = content?.params;
-    if (!p) return {};
-    if (typeof p === "object") return p;
-    try {
-        return JSON.parse(p);
-    } catch {
-        return {};
-    }
-}
-
-/**
- * Classify a live listener message into the same shape as a synced one.
- *
- * The payload differs from the protobuf: here `content` really is an object for
- * media, URLs are named `href`/`oriUrl`/`normalUrl`/`hdUrl`, and there is no
- * `meta` wrapper. What comes out is deliberately identical to
- * {@link classifySyncMessage} so both paths write interchangeable rows and one
- * downloader serves both.
- *
- * @param {{msgType?: string, content?: object|string, msgId?: string|number, cliMsgId?: string|number}} data
- *   the zca-js `msg.data` object
- * @returns {{type: string, text: string, hasAttachment: boolean, attachments: Array<object>, raw: object}}
- */
-export function classifyLiveMessage(data) {
-    const rawType = data?.msgType || "";
-    const content = data?.content;
-    let type = LIVE_MSG_TYPES[rawType] || (typeof content === "string" ? "text" : rawType || "attachment");
-    // `webchat` carries two different things: a real text message, whose content
-    // is a string, and a group system event (a member added, a reminder
-    // deleted), whose content is an object with this action. The phone reports
-    // the latter as msgType 20 -> group_event, so classifying on msgType alone
-    // filed the same event as `text` live and as `group_event` from a sync —
-    // and the text path, seeing no string body, stored the literal "[text]".
-    if (type === "text" && content && typeof content === "object" && content.action === "msginfo.actionlist") {
-        type = "group_event";
-    }
-    const attachments = [];
-
-    if (content && typeof content === "object") {
-        const params = liveParams(content);
-        const url = content.href || content.oriUrl || content.normalUrl || undefined;
-        const thumbUrl = content.thumb || content.thumbUrl || undefined;
-        const kind = kindFromUrl(url) || (MEDIA_TYPES.has(type) ? type : type);
-        // A sticker is identified by catalogue + id, not a URL, so the generic
-        // test below never fired for one: the same sticker produced one
-        // attachment from a sync and zero from the listener, and its text read
-        // "[sticker]" instead of "[sticker <cat>/<id>]". Mirrors the sync
-        // branch in extractSyncAttachments.
-        if (type === "sticker") {
-            attachments.push({
-                kind: "sticker",
-                catId: content.catId ?? content.cat_id ?? null,
-                stickerId: content.id ?? content.stickerId ?? null,
-                stickerType: content.type ?? null,
-                params: Object.keys(params).length ? params : undefined,
-            });
-        } else if (url || thumbUrl || content.title || Object.keys(params).length) {
-            attachments.push({
-                kind,
-                url,
-                thumbUrl,
-                hdUrl: content.hdUrl || (typeof params.hd === "string" ? params.hd : undefined),
-                title: content.title || undefined,
-                description: content.description || undefined,
-                action: content.action || undefined,
-                fileName: type === "file" ? content.title || undefined : undefined,
-                ext: params.fileExt || content.fileExt || undefined,
-                size: Number(pick(params, "fileSize", "video_file_size")) || Number(content.fileSize) || undefined,
-                checksum: params.checksum || content.checksum || undefined,
-                width: Number(pick(params, "width", "video_width", "tWidth")) || undefined,
-                height: Number(pick(params, "height", "video_height", "tHeight")) || undefined,
-                duration: Number(pick(params, "duration")) || undefined,
-                params: Object.keys(params).length ? params : undefined,
-            });
-        }
-    }
-
-    const downloadable = attachments.filter((a) => (a.url || a.thumbUrl) && MEDIA_TYPES.has(a.kind));
-    // Hand extractSyncText the SAME shape the sync path gives it. It reads the
-    // first attachment's params to build an event/poll sentence, so passing a
-    // synthetic empty meta made every system event read as a bare "[event]"
-    // when captured live and as its real text when restored from the phone.
-    const liveMeta =
-        attachments.length && attachments[0].params
-            ? { attachsList: [{ params: JSON.stringify(attachments[0].params) }] }
-            : {};
-    const text =
-        typeof content === "string"
-            ? content.trim()
-            : extractSyncText({ content: "", meta: liveMeta }, type, attachments) || `[${type}]`;
-
-    return {
-        type,
-        text,
-        hasAttachment: downloadable.length > 0,
-        attachments,
-        raw: {
-            src: "listen",
-            msgType: rawType || undefined,
-            cliMsgId: data?.cliMsgId === undefined || data?.cliMsgId === null ? undefined : String(data.cliMsgId),
-            content: typeof content === "string" ? content || undefined : content,
-            attachments: attachments.length ? attachments : undefined,
-            // The sync path records these; the live path dropped them, so the
-            // same message was richer or poorer depending on how it was
-            // captured. zca-js supplies all of them on a live event.
-            quote: data?.quote || undefined,
-            mentions: data?.mentions?.length ? data.mentions : undefined,
-            ttl: data?.ttl ? Number(data.ttl) : undefined,
-            property: data?.propertyExt || undefined,
-            // A seen or delivered receipt names its message by these three, and
-            // they exist nowhere but on the socket frame: Zalo Web echoes them
-            // back verbatim (captured `"st":3,"at":9,"cmd":501`), and `at`
-            // differs per message, so they cannot be rebuilt later -- only kept.
-            // 0 is a real value (card receipts carry "at":0), so only an absent
-            // field is left out. See src/core/receipts.js.
-            st: frameNumber(data?.st),
-            at: frameNumber(data?.at),
-            cmd: frameNumber(data?.cmd),
-        },
-    };
-}
-
-/**
- * A numeric socket-frame field, or undefined when the frame did not carry one.
- *
- * @param {unknown} v
- * @returns {number|undefined}
- */
-function frameNumber(v) {
-    if (v === undefined || v === null || v === "") return undefined;
-    const n = Number(v);
-    return Number.isFinite(n) ? n : undefined;
-}

package/src/core/sync-v2/renewlink.js

@@ -1,124 +0,0 @@
-/**
- * Refresh an expired media URL — the same call Zalo Web makes when a photo,
- * video or file in the timeline has aged past its signed URL.
- *
- *   POST {fileDomain}/api/message/renewlink   (cmd 12094)
- *     params = AES({ toId, msgType, msgInfo, clientId, imei, isGroup })
- *     msgInfo = JSON({ normalUrl, hdUrl, thumbUrl, oriUrl, isE2EE, isOriginal })
- *
- * Zalo media lives in three places, and this covers only the first:
- *
- *   1. Zalo's CDN — the `href`/`thumb` in the sync payload. The signature has
- *      a lifetime tied to the message's age; while the server still holds the
- *      file, renewlink hands back fresh URLs. That is this module.
- *   2. zCloud (personal cloud) — a per-message E2EE backup, looked up by msgId.
- *      See ./zcloud.js.
- *   3. The sending device itself. No server path exists; the phone's own
- *      re-upload hints (`fileUrlToRenew`, `video_url_to_renew`) ride along in
- *      the sync payload and are preserved on the attachment record, but only
- *      the Zalo mobile client can act on them.
- *
- * Built on zca-js's apiFactory so the authenticated envelope matches what the
- * file service expects, the same way ./gid.js reaches /api/gid/decrypt.
- */
-import { createRequire } from "node:module";
-import { dirname, join } from "node:path";
-
-const require = createRequire(import.meta.url);
-
-let _utils = null;
-function zcaUtils() {
-    if (_utils) return _utils;
-    _utils = require(join(dirname(require.resolve("zca-js")), "utils.cjs"));
-    return _utils;
-}
-
-/**
- * Zalo Web strips its internal `jxl` marker before sending a URL back for
- * renewal. Our URLs come straight off the wire and normally have none, so this
- * is defensive rather than load-bearing.
- */
-function removeJxlProtocol(url) {
-    if (typeof url !== "string") return url;
-    return url.replace(/^jxl:\/\//i, "").replace(/\/jxl\//i, "/");
-}
-
-/** Group threads (and the self-chat) take the group form of the request. */
-function isGroupThread(threadType) {
-    return threadType === "group";
-}
-
-/**
- * Build a renewlink caller bound to this session.
- *
- * @param {object} api - logged-in zca-js api
- * @returns {(req: object) => Promise<object>}
- */
-export function makeRenewLink(api) {
-    const zu = zcaUtils();
-    const base = `${api.zpwServiceMap.file[0]}/api/message/renewlink`;
-    return zu.apiFactory()((_api, ctx, utils) => async ({ threadId, threadType, msgType, msgInfo, clientId }) => {
-        const info = {
-            ...msgInfo,
-            normalUrl: removeJxlProtocol(msgInfo.normalUrl),
-            hdUrl: removeJxlProtocol(msgInfo.hdUrl),
-            thumbUrl: removeJxlProtocol(msgInfo.thumbUrl),
-            oriUrl: removeJxlProtocol(msgInfo.oriUrl),
-            isE2EE: 0,
-            isOriginal: 0,
-        };
-        for (const k of Object.keys(info)) if (info[k] === undefined) delete info[k];
-
-        const params = {
-            toId: String(threadId),
-            msgType: Number(msgType) || 0,
-            msgInfo: JSON.stringify(info),
-            clientId: String(clientId || Date.now()),
-            imei: ctx.imei,
-            isGroup: isGroupThread(threadType) ? 1 : 0,
-        };
-        const enc = utils.encodeAES(JSON.stringify(params));
-        if (!enc) throw new Error("failed to encrypt renewlink params");
-        const resp = await utils.request(utils.makeURL(base), {
-            method: "POST",
-            body: new URLSearchParams({ params: enc }),
-        });
-        return utils.resolve(resp);
-    })(api.getContext(), api);
-}
-
-/**
- * Pull refreshed URLs out of a renewlink response.
- *
- * The response envelope is not documented anywhere and Zalo has more than one
- * shape for "here is the message again", so this reads defensively: it accepts
- * the URL bag at the top level, under `data`, or nested one level deeper, and
- * returns null when it finds nothing it recognises rather than guessing.
- *
- * @param {object} resp
- * @returns {{normalUrl?: string, hdUrl?: string, thumbUrl?: string, oriUrl?: string}|null}
- */
-export function extractRenewedUrls(resp) {
-    const KEYS = ["normalUrl", "hdUrl", "thumbUrl", "oriUrl", "url", "href"];
-    const candidates = [resp, resp?.data, resp?.data?.data, resp?.data?.msgInfo, resp?.msgInfo];
-    for (let c of candidates) {
-        if (typeof c === "string") {
-            try {
-                c = JSON.parse(c);
-            } catch {
-                continue;
-            }
-        }
-        if (!c || typeof c !== "object") continue;
-        const found = {};
-        for (const k of KEYS) if (typeof c[k] === "string" && /^https?:\/\//.test(c[k])) found[k] = c[k];
-        if (Object.keys(found).length) {
-            // `url`/`href` are aliases for the main download link.
-            if (!found.normalUrl && (found.url || found.href)) found.normalUrl = found.url || found.href;
-            delete found.url;
-            delete found.href;
-            return found;
-        }
-    }
-    return null;
-}