tca-js 0.3.1 → 0.4.0

package/dist/listener.d.ts

@@ -1,43 +0,0 @@
-import { EventEmitter } from 'node:events';
-import type { Context } from './context';
-import type { TikTokMessage } from './types';
-/** Close code used when we call `stop()` ourselves. */
-export declare const MANUAL_CLOSE = 4000;
-export interface ListenerEvents {
-    connected: [];
-    /** A real message in a conversation (including our own — see `isSelf`). */
-    message: [TikTokMessage];
-    /** Hidden command: mark as read… (`content.command_type`). */
-    command: [TikTokMessage];
-    /** Close code + reason. Unless `MANUAL_CLOSE`, the listener reconnects automatically (if enabled). */
-    closed: [number, string];
-    error: [Error];
-}
-/**
- * Listen for new messages via the `im-ws-sg` websocket (aid 1459) — cookies only.
- * Events: `connected`, `message`, `closed`, `error`.
- */
-export declare class Listener extends EventEmitter<ListenerEvents> {
-    private readonly ctx;
-    private ws;
-    private heartbeat;
-    private idle;
-    private reconnectTimer;
-    private backoff;
-    private retry;
-    private readonly seen;
-    constructor(ctx: Context);
-    get connected(): boolean;
-    url(): string;
-    /** Open the connection. `retryOnClose` (on by default): reconnect on drop, backing off up to 1 minute. */
-    start(opts?: {
-        retryOnClose?: boolean;
-    }): void;
-    stop(): void;
-    private connect;
-    private touch;
-    private clearTimers;
-    private onFrame;
-    /** Acknowledge receipt — `ack_id = <base36 time>:<x_frontier_traceid>`, echoing the frame's seq/logid. */
-    private ack;
-}

package/dist/listener.js

@@ -1,181 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Listener = exports.MANUAL_CLOSE = void 0;
-const node_crypto_1 = require("node:crypto");
-const node_events_1 = require("node:events");
-const ws_1 = __importDefault(require("ws"));
-const constants_1 = require("./constants");
-const lz4_1 = require("./lz4");
-const message_1 = require("./message");
-const proto_1 = require("./proto");
-/** The browser sends "hi" every 15–30 seconds; use the lower bound. */
-const HEARTBEAT_MS = 15_000;
-/** If nothing (not even a "hi" reply) arrives for this long, treat it as silently dead and reconnect. */
-const IDLE_TIMEOUT_MS = 75_000;
-const RECONNECT_MIN_MS = 2_000;
-const RECONNECT_MAX_MS = 60_000;
-/** The server pushes the same message several times (one frame per device) — remember this many message IDs to dedupe. */
-const DEDUPE_KEEP = 500;
-/** Close code used when we call `stop()` ourselves. */
-exports.MANUAL_CLOSE = 4000;
-/**
- * Listen for new messages via the `im-ws-sg` websocket (aid 1459) — cookies only.
- * Events: `connected`, `message`, `closed`, `error`.
- */
-class Listener extends node_events_1.EventEmitter {
-    ctx;
-    ws = null;
-    heartbeat = null;
-    idle = null;
-    reconnectTimer = null;
-    backoff = RECONNECT_MIN_MS;
-    retry = true;
-    seen = new Set();
-    constructor(ctx) {
-        super();
-        this.ctx = ctx;
-    }
-    get connected() {
-        return this.ws?.readyState === ws_1.default.OPEN;
-    }
-    url() {
-        const accessKey = (0, node_crypto_1.createHash)('md5')
-            .update(constants_1.FRONTIER_FPID + constants_1.FRONTIER_APP_KEY + this.ctx.deviceId + constants_1.FRONTIER_SALT)
-            .digest('hex');
-        const q = new URLSearchParams({
-            aid: constants_1.AID_FRONTIER,
-            fpid: constants_1.FRONTIER_FPID,
-            device_platform: 'web',
-            version_code: 'fws_1.0.0',
-            access_key: accessKey,
-            device_id: this.ctx.deviceId,
-            // Cookie value is already URL-encoded (`1%7C…`) — decode it so URLSearchParams doesn't double-encode.
-            ttwid: decodeURIComponent(this.ctx.cookies.get('ttwid') ?? ''),
-            xsack: '1',
-            xaack: '1',
-            xsqos: '0',
-        });
-        return `${constants_1.IM_WS}?${q}`;
-    }
-    /** Open the connection. `retryOnClose` (on by default): reconnect on drop, backing off up to 1 minute. */
-    start(opts = {}) {
-        this.retry = opts.retryOnClose ?? true;
-        this.connect();
-    }
-    stop() {
-        this.retry = false;
-        this.clearTimers();
-        if (this.reconnectTimer)
-            clearTimeout(this.reconnectTimer);
-        this.reconnectTimer = null;
-        const ws = this.ws;
-        this.ws = null;
-        if (ws && ws.readyState <= ws_1.default.OPEN)
-            ws.close(exports.MANUAL_CLOSE, 'manual');
-    }
-    connect() {
-        const ws = new ws_1.default(this.url(), {
-            headers: { Cookie: this.ctx.cookieHeader(), 'User-Agent': this.ctx.userAgent, Origin: constants_1.WEB },
-        });
-        this.ws = ws;
-        ws.binaryType = 'nodebuffer';
-        ws.on('open', () => {
-            this.backoff = RECONNECT_MIN_MS;
-            this.heartbeat = setInterval(() => ws.readyState === ws_1.default.OPEN && ws.send('hi'), HEARTBEAT_MS);
-            this.touch();
-            this.ctx.log('debug', 'tca: websocket connected');
-            this.emit('connected');
-        });
-        ws.on('message', (data, isBinary) => {
-            this.touch();
-            if (!isBinary)
-                return; // "hi" reply
-            try {
-                this.onFrame(ws, data);
-            }
-            catch (err) {
-                this.emit('error', err instanceof Error ? err : new Error(String(err)));
-            }
-        });
-        ws.on('error', (err) => this.emit('error', err));
-        ws.on('close', (code, reason) => {
-            if (this.ws !== ws)
-                return; // old connection was replaced
-            this.ws = null;
-            this.clearTimers();
-            this.emit('closed', code, reason.toString());
-            if (!this.retry || code === exports.MANUAL_CLOSE)
-                return;
-            const wait = this.backoff;
-            this.backoff = Math.min(this.backoff * 2, RECONNECT_MAX_MS);
-            this.ctx.log('warn', `tca: websocket closed (${code}) — reconnecting in ${wait / 1000}s`);
-            this.reconnectTimer = setTimeout(() => this.connect(), wait);
-        });
-    }
-    touch() {
-        if (this.idle)
-            clearTimeout(this.idle);
-        this.idle = setTimeout(() => {
-            this.ctx.log('warn', 'tca: websocket silent too long — reconnecting');
-            this.ws?.terminate();
-        }, IDLE_TIMEOUT_MS);
-    }
-    clearTimers() {
-        if (this.heartbeat)
-            clearInterval(this.heartbeat);
-        if (this.idle)
-            clearTimeout(this.idle);
-        this.heartbeat = null;
-        this.idle = null;
-    }
-    onFrame(ws, data) {
-        const m = proto_1.Msg.parse(data);
-        const frame = {
-            seq: m.int(1),
-            logId: m.int(2),
-            headers: m.map(5),
-            encoding: m.str(6),
-            payload: m.bytes(8),
-        };
-        if (frame.headers.need_ack === '1')
-            this.ack(ws, frame);
-        if (frame.payload.length === 0)
-            return;
-        const payload = frame.encoding === '__lz4' ? (0, lz4_1.lz4Decompress)(frame.payload) : frame.payload;
-        const resp = proto_1.Msg.tryParse(payload);
-        if (!resp || resp.num(constants_1.Resp.cmd) !== constants_1.Cmd.NewMessage)
-            return;
-        // NewMessageNotify: {2 conversationId, 3 type, 4 ?, 5 MessageBody}
-        const body = resp.msg(constants_1.Resp.body)?.msg(constants_1.Cmd.NewMessage)?.msg(5);
-        if (!body)
-            return;
-        const msg = (0, message_1.parseMessage)(body, this.ctx.ownId);
-        if (!msg.serverMessageId || this.seen.has(msg.serverMessageId))
-            return;
-        this.seen.add(msg.serverMessageId);
-        if (this.seen.size > DEDUPE_KEEP)
-            this.seen.delete(this.seen.values().next().value);
-        if (msg.kind === 'command')
-            this.emit('command', msg);
-        else
-            this.emit('message', msg);
-    }
-    /** Acknowledge receipt — `ack_id = <base36 time>:<x_frontier_traceid>`, echoing the frame's seq/logid. */
-    ack(ws, f) {
-        const ackId = `${Date.now().toString(36)}:${f.headers.x_frontier_traceid ?? ''}`;
-        const out = new proto_1.Writer()
-            .int(1, f.seq)
-            .int(2, f.logId)
-            .int(3, 5)
-            .int(4, 1)
-            .map(5, { is_ack: '1', ack_id: ackId, ack_code: '0' })
-            .bytes(9, ackId)
-            .finish();
-        if (ws.readyState === ws_1.default.OPEN)
-            ws.send(out);
-    }
-}
-exports.Listener = Listener;

package/dist/lz4.d.ts

@@ -1,5 +0,0 @@
-/**
- * LZ4 block decompression (no frame header) — websocket frames with
- * `payload_encoding = "__lz4"` compress their payload this way. No extra dependency for ~30 lines.
- */
-export declare function lz4Decompress(src: Buffer): Buffer;

package/dist/lz4.js

@@ -1,57 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.lz4Decompress = lz4Decompress;
-/**
- * LZ4 block decompression (no frame header) — websocket frames with
- * `payload_encoding = "__lz4"` compress their payload this way. No extra dependency for ~30 lines.
- */
-function lz4Decompress(src) {
-    let out = Buffer.alloc(Math.max(src.length * 4, 1024));
-    let o = 0;
-    const ensure = (need) => {
-        if (o + need <= out.length)
-            return;
-        let size = out.length * 2;
-        while (o + need > size)
-            size *= 2;
-        const bigger = Buffer.alloc(size);
-        out.copy(bigger, 0, 0, o);
-        out = bigger;
-    };
-    let i = 0;
-    while (i < src.length) {
-        const token = src[i++];
-        let lit = token >> 4;
-        if (lit === 15) {
-            let b;
-            do {
-                b = src[i++];
-                lit += b;
-            } while (b === 255);
-        }
-        ensure(lit);
-        src.copy(out, o, i, i + lit);
-        i += lit;
-        o += lit;
-        if (i >= src.length)
-            break;
-        const offset = src[i] | (src[i + 1] << 8);
-        i += 2;
-        if (offset === 0 || offset > o)
-            throw new Error('lz4: invalid offset');
-        let len = token & 15;
-        if (len === 15) {
-            let b;
-            do {
-                b = src[i++];
-                len += b;
-            } while (b === 255);
-        }
-        len += 4;
-        ensure(len);
-        // Copy byte by byte: source and destination ranges may overlap.
-        for (let k = 0; k < len; k++, o++)
-            out[o] = out[o - offset];
-    }
-    return out.subarray(0, o);
-}

package/dist/media.d.ts

@@ -1,27 +0,0 @@
-import type { Context } from './context';
-import type { ImageInput, TikTokImage } from './types';
-/** Uploaded image, encrypted by the store — enough to send an image message. */
-export interface UploadedImage {
-    uri: string;
-    secretKey: string;
-    width: number;
-    height: number;
-    size: number;
-    filename: string;
-}
-export declare class MediaClient {
-    private readonly ctx;
-    private cred;
-    constructor(ctx: Context);
-    /** `UploadConfig` returns two credential sets: type 1 = ImageX (images), type 2 = VOD (video). Use type 1. */
-    private credential;
-    /** Call ImageX signed with AWS SigV4 (region cn-north-1, service imagex). */
-    private imagex;
-    /**
-     * Upload an image to the private message store: Apply → POST file → Commit (the store encrypts with AES-GCM
-     * and returns the key). Image dimensions come from the Commit result — no need to decode the image.
-     */
-    upload(image: ImageInput): Promise<UploadedImage>;
-    /** Download and decrypt a message image. Layout: 12-byte IV ‖ ciphertext ‖ 16-byte tag. */
-    download(image: TikTokImage, which?: 'origin' | 'thumb'): Promise<Buffer>;
-}

package/dist/media.js

@@ -1,152 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MediaClient = void 0;
-const node_crypto_1 = require("node:crypto");
-const node_zlib_1 = require("node:zlib");
-const constants_1 = require("./constants");
-const errors_1 = require("./errors");
-const sha256 = (s) => (0, node_crypto_1.createHash)('sha256').update(s).digest('hex');
-const hmac = (k, s) => (0, node_crypto_1.createHmac)('sha256', k).update(s).digest();
-const rfc3986 = (s) => encodeURIComponent(s).replace(/[!'()*]/g, (c) => `%${c.charCodeAt(0).toString(16).toUpperCase()}`);
-class MediaClient {
-    ctx;
-    cred = null;
-    constructor(ctx) {
-        this.ctx = ctx;
-    }
-    /** `UploadConfig` returns two credential sets: type 1 = ImageX (images), type 2 = VOD (video). Use type 1. */
-    async credential() {
-        if (this.cred && this.cred.expiresAt - Date.now() > 60_000)
-            return this.cred;
-        const body = await this.ctx.im('/v1/media/upload_config', constants_1.Cmd.UploadConfig, Buffer.alloc(0));
-        const c = body.msgs(1).find((m) => m.num(1) === 1);
-        if (!c)
-            throw new errors_1.TikTokError('UPLOAD_FAILED', 'upload_config has no ImageX credentials');
-        this.cred = {
-            serviceId: c.str(2),
-            host: c.str(3),
-            expiresAt: c.num(4),
-            accessKeyId: c.str(6),
-            sessionToken: c.str(7),
-            secretAccessKey: c.str(8),
-        };
-        return this.cred;
-    }
-    /** Call ImageX signed with AWS SigV4 (region cn-north-1, service imagex). */
-    async imagex(method, params, body) {
-        const c = await this.credential();
-        const amzDate = new Date().toISOString().replace(/[-:]/g, '').replace(/\.\d+/, '');
-        const date = amzDate.slice(0, 8);
-        const query = Object.keys(params)
-            .sort()
-            .map((k) => `${rfc3986(k)}=${rfc3986(params[k])}`)
-            .join('&');
-        const headers = { 'x-amz-date': amzDate, 'x-amz-security-token': c.sessionToken };
-        if (body !== undefined)
-            headers['x-amz-content-sha256'] = sha256(body);
-        const signed = Object.keys(headers).sort();
-        const canonical = [
-            method,
-            '/',
-            query,
-            signed.map((k) => `${k}:${headers[k]}\n`).join(''),
-            signed.join(';'),
-            body !== undefined ? headers['x-amz-content-sha256'] : sha256(''),
-        ].join('\n');
-        const scope = `${date}/${constants_1.IMAGEX_REGION}/${constants_1.IMAGEX_SERVICE}/aws4_request`;
-        const toSign = ['AWS4-HMAC-SHA256', amzDate, scope, sha256(canonical)].join('\n');
-        let k = hmac(`AWS4${c.secretAccessKey}`, date);
-        k = hmac(k, constants_1.IMAGEX_REGION);
-        k = hmac(k, constants_1.IMAGEX_SERVICE);
-        k = hmac(k, 'aws4_request');
-        const signature = (0, node_crypto_1.createHmac)('sha256', k).update(toSign).digest('hex');
-        const res = await fetch(`https://${c.host}/?${query}`, {
-            method,
-            headers: {
-                ...headers,
-                Authorization: `AWS4-HMAC-SHA256 Credential=${c.accessKeyId}/${scope}, SignedHeaders=${signed.join(';')}, Signature=${signature}`,
-                ...(body !== undefined ? { 'Content-Type': 'application/json' } : {}),
-            },
-            body,
-            signal: AbortSignal.timeout(this.ctx.options.timeoutMs ?? 20_000),
-        });
-        const json = (await res.json().catch(() => null));
-        const err = json?.ResponseMetadata?.Error;
-        if (!res.ok || !json || err) {
-            throw new errors_1.TikTokError('UPLOAD_FAILED', `imagex ${params.Action}: ${err?.Message ?? `HTTP ${res.status}`}`, err?.CodeN ?? res.status);
-        }
-        return json;
-    }
-    /**
-     * Upload an image to the private message store: Apply → POST file → Commit (the store encrypts with AES-GCM
-     * and returns the key). Image dimensions come from the Commit result — no need to decode the image.
-     */
-    async upload(image) {
-        const c = await this.credential();
-        const ext = (/\.([a-z0-9]{2,5})$/i.exec(image.filename)?.[1] ?? 'jpg').toLowerCase();
-        const apply = await this.imagex('GET', {
-            Action: 'ApplyImageUpload',
-            Version: constants_1.IMAGEX_VERSION,
-            ServiceId: c.serviceId,
-            FileSize: String(image.data.length),
-            FileExtension: `.${ext}`,
-            s: (0, node_crypto_1.randomBytes)(6).toString('hex').slice(0, 10),
-        });
-        const addr = apply.Result.UploadAddress;
-        const store = addr.StoreInfos[0];
-        const host = addr.UploadHosts[0];
-        if (!store || !host)
-            throw new errors_1.TikTokError('UPLOAD_FAILED', 'ApplyImageUpload returned no upload target');
-        const up = await fetch(`https://${host}/upload/v1/${store.StoreUri}`, {
-            method: 'POST',
-            headers: {
-                Authorization: store.Auth,
-                'Content-CRC32': ((0, node_zlib_1.crc32)(image.data) >>> 0).toString(16).padStart(8, '0'),
-                // Without this header the store returns 4004 Not Found.
-                'X-Storage-U': this.ctx.ownId,
-                'Content-Type': 'application/octet-stream',
-                'Content-Disposition': 'attachment; filename="undefined"',
-            },
-            body: new Uint8Array(image.data),
-            signal: AbortSignal.timeout(this.ctx.options.timeoutMs ?? 60_000),
-        });
-        const upJson = (await up.json().catch(() => null));
-        if (!up.ok || upJson?.code !== 2000) {
-            throw new errors_1.TikTokError('UPLOAD_FAILED', `upload: ${upJson?.message ?? `HTTP ${up.status}`}`, upJson?.code ?? up.status);
-        }
-        const commit = await this.imagex('POST', { Action: 'CommitImageUpload', Version: constants_1.IMAGEX_VERSION, ServiceId: c.serviceId }, JSON.stringify({ SessionKey: addr.SessionKey, Functions: [{ name: 'Encryption', input: { Config: { copies: 'cipher_v2' } } }] }));
-        const enc = commit.Result.Results?.[0]?.Encryption;
-        const plugin = commit.Result.PluginResult?.[0];
-        if (!enc?.Uri || !enc.SecretKey)
-            throw new errors_1.TikTokError('UPLOAD_FAILED', 'CommitImageUpload returned no encrypted result');
-        return {
-            uri: enc.Uri,
-            secretKey: enc.SecretKey,
-            width: plugin?.ImageWidth ?? Number(enc.Extra?.img_width ?? 0),
-            height: plugin?.ImageHeight ?? Number(enc.Extra?.img_height ?? 0),
-            size: plugin?.ImageSize ?? image.data.length,
-            filename: image.filename,
-        };
-    }
-    /** Download and decrypt a message image. Layout: 12-byte IV ‖ ciphertext ‖ 16-byte tag. */
-    async download(image, which = 'origin') {
-        const url = which === 'thumb' && image.thumbUrl ? image.thumbUrl : image.url;
-        if (!url)
-            throw new errors_1.TikTokError('DOWNLOAD_FAILED', 'Image has no URL');
-        const res = await this.ctx.fetch(url);
-        if (!res.ok)
-            throw new errors_1.TikTokError('DOWNLOAD_FAILED', `Image download: HTTP ${res.status}`, res.status);
-        const enc = Buffer.from(await res.arrayBuffer());
-        if (!image.decryptKey)
-            return enc;
-        try {
-            const d = (0, node_crypto_1.createDecipheriv)('aes-256-gcm', Buffer.from(image.decryptKey, 'hex'), enc.subarray(0, 12));
-            d.setAuthTag(enc.subarray(enc.length - 16));
-            return Buffer.concat([d.update(enc.subarray(12, enc.length - 16)), d.final()]);
-        }
-        catch (err) {
-            throw new errors_1.TikTokError('DOWNLOAD_FAILED', `Image decryption: ${err instanceof Error ? err.message : String(err)}`);
-        }
-    }
-}
-exports.MediaClient = MediaClient;

package/dist/message.d.ts

@@ -1,6 +0,0 @@
-import { Msg } from './proto';
-import type { TikTokConversation, TikTokMessage } from './types';
-/** `MessageBody` → `TikTokMessage`. */
-export declare function parseMessage(m: Msg, ownId: string): TikTokMessage;
-/** `ConversationInfo` (field 2 of get_by_user_init): {1 id, 2 shortId, 3 type, 6 {1 {1 uid}}…}. */
-export declare function parseConversation(m: Msg, ownId: string): TikTokConversation;

package/dist/message.js

@@ -1,113 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseMessage = parseMessage;
-exports.parseConversation = parseConversation;
-const constants_1 = require("./constants");
-function parseJson(s) {
-    try {
-        return JSON.parse(s);
-    }
-    catch {
-        return s;
-    }
-}
-/** Image in `attachments` (field 20 → 4): 1 = original, 2 = thumbnail; each {1 uri, 2 url…, 5 {w,h}, 6 key}. */
-function parseImage(m) {
-    const media = m.msg(constants_1.MsgF.attachments)?.msg(4);
-    const origin = media?.msg(1);
-    if (!media || !origin)
-        return null;
-    const size = origin.msg(5);
-    return {
-        uri: origin.str(1),
-        url: origin.strs(2)[0] ?? '',
-        thumbUrl: media.msg(2)?.strs(2)[0] ?? '',
-        width: size?.num(1) ?? 0,
-        height: size?.num(2) ?? 0,
-        decryptKey: origin.str(6),
-    };
-}
-/**
- * Sticker (field 20 → 7): `{1 {1 uri, 2 url, 5 {w,h}}, 2 hint, 200 {1 {2 map a:sticker_id, a:sticker_type…}}}`.
- * Links point to the public sticker CDN (`…-dm-sticker-sign-…`) — not encrypted, no cookies needed.
- */
-function parseSticker(m) {
-    const st = m.msg(constants_1.MsgF.attachments)?.msg(7);
-    const img = st?.msg(1);
-    if (!st || !img)
-        return null;
-    const size = img.msg(5);
-    const ext = st.msg(200)?.msg(1)?.map(2) ?? {};
-    return {
-        stickerId: ext['a:sticker_id'] ?? '',
-        stickerType: Number(ext['a:sticker_type'] ?? 0),
-        url: img.str(2),
-        width: size?.num(1) ?? 0,
-        height: size?.num(2) ?? 0,
-    };
-}
-/**
- * Reaction (field 15, `property_list`): each entry `{1 key, 2 {1 PropertyItem[]}}`, key `e:<emoji>`,
- * `PropertyItem {1 uid, 3 sec, 4 idempotent_id, 6 µs}`. The mobile app writes ❤️ as both `e:❤️` and `e:love` → merged.
- */
-function parseReactions(m) {
-    const byEmoji = new Map();
-    for (const p of m.msgs(constants_1.MsgF.propertyList)) {
-        const key = p.str(1);
-        if (!key.startsWith(constants_1.REACTION_PREFIX))
-            continue;
-        const emoji = key === constants_1.REACTION_LOVE_KEY ? constants_1.REACTION_HEART : key.slice(constants_1.REACTION_PREFIX.length);
-        const uids = byEmoji.get(emoji) ?? new Set();
-        for (const item of p.msg(2)?.msgs(1) ?? [])
-            uids.add(item.id(1));
-        if (uids.size)
-            byEmoji.set(emoji, uids);
-    }
-    return [...byEmoji].map(([emoji, uids]) => ({ emoji, userIds: [...uids] }));
-}
-const KIND = {
-    [constants_1.MessageType.Text]: 'text',
-    [constants_1.MessageType.PrivateImage]: 'image',
-    [constants_1.MessageType.Sticker]: 'sticker',
-    [constants_1.MessageType.ShareVideo]: 'video',
-    [constants_1.MessageType.System]: 'system',
-    [constants_1.MessageType.Command]: 'command',
-};
-/** `MessageBody` → `TikTokMessage`. */
-function parseMessage(m, ownId) {
-    const type = m.num(constants_1.MsgF.type);
-    const content = parseJson(m.str(constants_1.MsgF.content));
-    const ext = m.map(constants_1.MsgF.ext);
-    const senderId = m.id(constants_1.MsgF.sender);
-    const text = type === constants_1.MessageType.Text && content && typeof content === 'object' && 'text' in content
-        ? String(content.text ?? '')
-        : '';
-    return {
-        conversationId: m.str(constants_1.MsgF.conversationId),
-        conversationShortId: m.id(constants_1.MsgF.conversationShortId),
-        serverMessageId: m.id(constants_1.MsgF.serverMessageId),
-        index: m.id(constants_1.MsgF.indexInConversation),
-        type,
-        kind: KIND[type] ?? 'other',
-        senderId,
-        isSelf: senderId === ownId,
-        text,
-        image: type === constants_1.MessageType.PrivateImage ? parseImage(m) : null,
-        sticker: type === constants_1.MessageType.Sticker ? parseSticker(m) : null,
-        reactions: parseReactions(m),
-        content,
-        createdAt: m.num(constants_1.MsgF.createTime),
-        clientMessageId: ext['s:client_message_id'] ?? '',
-        ext,
-    };
-}
-/** `ConversationInfo` (field 2 of get_by_user_init): {1 id, 2 shortId, 3 type, 6 {1 {1 uid}}…}. */
-function parseConversation(m, ownId) {
-    const participants = (m.msg(6)?.msgs(1) ?? []).map((p) => p.id(1));
-    return {
-        conversationId: m.str(1),
-        conversationShortId: m.id(2),
-        participants,
-        peerId: participants.find((p) => p !== ownId) ?? '',
-    };
-}

package/dist/proto.d.ts

@@ -1,43 +0,0 @@
-/**
- * Minimal protobuf, no `.proto` file needed.
- *
- * TikTok doesn't publish its IM `.proto` — field numbers in `constants.ts` were reconstructed from bytes captured
- * in the browser (09/11/2026). Only three wire types are needed: varint (0), length-delimited (2), and skipping 1/5.
- */
-export interface Field {
-    n: number;
-    wire: number;
-    int: bigint;
-    bytes: Buffer;
-}
-/** Split a message into a list of fields. `null` if the bytes are not valid protobuf. */
-export declare function decodeFields(b: Buffer): Field[] | null;
-/** Decoded message — read by field number. */
-export declare class Msg {
-    readonly fields: Field[];
-    private constructor();
-    static parse(b: Buffer): Msg;
-    static tryParse(b: Buffer | undefined): Msg | null;
-    has(n: number): boolean;
-    int(n: number): bigint;
-    num(n: number): number;
-    /** 64-bit integer as a string — uids / message IDs exceed `Number.MAX_SAFE_INTEGER`. */
-    id(n: number): string;
-    bytes(n: number): Buffer;
-    str(n: number): string;
-    strs(n: number): string[];
-    msg(n: number): Msg | null;
-    msgs(n: number): Msg[];
-    /** `map<string,string>` — each entry is a message `{1: key, 2: value}`. */
-    map(n: number): Record<string, string>;
-}
-/** Build a message in call order. */
-export declare class Writer {
-    private readonly parts;
-    int(n: number, v: bigint | number | string): this;
-    bytes(n: number, v: Buffer | string): this;
-    msg(n: number, w: Writer): this;
-    /** `map<string,string>` in the object's key order. */
-    map(n: number, obj: Record<string, string>): this;
-    finish(): Buffer;
-}