tca-js 0.3.0 → 0.4.0

package/dist/proto.js

@@ -1,162 +0,0 @@
-"use strict";
-/**
- * Protobuf tối thiểu, không cần file `.proto`.
- *
- * TikTok không công bố `.proto` của IM — số trường ở `constants.ts` dựng lại từ byte bắt được
- * trên trình duyệt (09/11/2026). Chỉ cần ba kiểu dây: varint (0), độ dài (2), và bỏ qua 1/5.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Writer = exports.Msg = void 0;
-exports.decodeFields = decodeFields;
-function readVarint(b, i) {
-    let x = 0n;
-    let shift = 0n;
-    let c;
-    do {
-        if (i >= b.length)
-            throw new Error('varint vượt cuối buffer');
-        c = b[i++];
-        x |= BigInt(c & 127) << shift;
-        shift += 7n;
-    } while (c & 128);
-    return [x, i];
-}
-/** Tách một message thành danh sách trường. `null` nếu byte không phải protobuf hợp lệ. */
-function decodeFields(b) {
-    const out = [];
-    let i = 0;
-    try {
-        while (i < b.length) {
-            const [key, j] = readVarint(b, i);
-            i = j;
-            const wire = Number(key & 7n);
-            const n = Number(key >> 3n);
-            if (n === 0)
-                return null;
-            if (wire === 0) {
-                const [v, k] = readVarint(b, i);
-                out.push({ n, wire, int: v, bytes: Buffer.alloc(0) });
-                i = k;
-            }
-            else if (wire === 2) {
-                const [len, k] = readVarint(b, i);
-                const end = k + Number(len);
-                if (end > b.length)
-                    return null;
-                out.push({ n, wire, int: 0n, bytes: b.subarray(k, end) });
-                i = end;
-            }
-            else if (wire === 1 || wire === 5) {
-                const size = wire === 1 ? 8 : 4;
-                if (i + size > b.length)
-                    return null;
-                out.push({ n, wire, int: 0n, bytes: b.subarray(i, i + size) });
-                i += size;
-            }
-            else {
-                return null;
-            }
-        }
-    }
-    catch {
-        return null;
-    }
-    return out;
-}
-/** Message đã giải — đọc theo số trường. */
-class Msg {
-    fields;
-    constructor(fields) {
-        this.fields = fields;
-    }
-    static parse(b) {
-        const f = decodeFields(b);
-        if (!f)
-            throw new Error('Không giải được protobuf');
-        return new Msg(f);
-    }
-    static tryParse(b) {
-        if (!b)
-            return null;
-        const f = decodeFields(b);
-        return f ? new Msg(f) : null;
-    }
-    has(n) {
-        return this.fields.some((f) => f.n === n);
-    }
-    int(n) {
-        return this.fields.find((f) => f.n === n)?.int ?? 0n;
-    }
-    num(n) {
-        return Number(this.int(n));
-    }
-    /** Số nguyên 64-bit dạng chuỗi — uid / mã tin vượt `Number.MAX_SAFE_INTEGER`. */
-    id(n) {
-        return this.int(n).toString();
-    }
-    bytes(n) {
-        return this.fields.find((f) => f.n === n)?.bytes ?? Buffer.alloc(0);
-    }
-    str(n) {
-        return this.bytes(n).toString('utf8');
-    }
-    strs(n) {
-        return this.fields.filter((f) => f.n === n).map((f) => f.bytes.toString('utf8'));
-    }
-    msg(n) {
-        return Msg.tryParse(this.fields.find((f) => f.n === n)?.bytes);
-    }
-    msgs(n) {
-        return this.fields
-            .filter((f) => f.n === n)
-            .map((f) => Msg.tryParse(f.bytes))
-            .filter((m) => m !== null);
-    }
-    /** `map<string,string>` — mỗi phần tử là message `{1: key, 2: value}`. */
-    map(n) {
-        const out = {};
-        for (const m of this.msgs(n))
-            out[m.str(1)] = m.str(2);
-        return out;
-    }
-}
-exports.Msg = Msg;
-function varint(x) {
-    let v = BigInt(x);
-    if (v < 0n)
-        v = BigInt.asUintN(64, v);
-    const out = [];
-    do {
-        const c = Number(v & 127n);
-        v >>= 7n;
-        out.push(v ? c | 128 : c);
-    } while (v);
-    return Buffer.from(out);
-}
-const key = (n, wire) => varint((BigInt(n) << 3n) | BigInt(wire));
-/** Ghép message theo thứ tự gọi. */
-class Writer {
-    parts = [];
-    int(n, v) {
-        this.parts.push(key(n, 0), varint(typeof v === 'string' ? BigInt(v) : v));
-        return this;
-    }
-    bytes(n, v) {
-        const b = typeof v === 'string' ? Buffer.from(v, 'utf8') : v;
-        this.parts.push(key(n, 2), varint(b.length), b);
-        return this;
-    }
-    msg(n, w) {
-        return this.bytes(n, w.finish());
-    }
-    /** `map<string,string>` theo đúng thứ tự khoá của object. */
-    map(n, obj) {
-        for (const [k, v] of Object.entries(obj))
-            this.msg(n, new Writer().bytes(1, k).bytes(2, v));
-        return this;
-    }
-    finish() {
-        return Buffer.concat(this.parts);
-    }
-}
-exports.Writer = Writer;

package/dist/qr-login.d.ts

@@ -1,41 +0,0 @@
-import type { Credentials } from './types';
-/**
- * Đăng nhập bằng QR qua Chrome headless.
- *
- * Vì sao cần trình duyệt: API QR của TikTok (`passport/web/check_qrconnect`) đòi chữ ký JS
- * (X-Gnarly / msToken) — gọi trần từ Node bị `error_code 7`. Nên mở đúng trang
- * `tiktok.com/login/qrcode` trong Chrome headless để chính trang tự ký, còn mình chỉ NGHE
- * phản hồi qua CDP: ảnh QR lấy từ body `get_qrcode`, trạng thái từ body `check_qrconnect`.
- * Đăng nhập xong lấy cookie rồi tắt Chrome — mọi việc sau đó (`login`, chat) không cần trình duyệt.
- */
-export type QrLoginEvent = 
-/** Ảnh QR mới (`data:image/png;base64,…`) — hiện cho người dùng quét. Hết hạn thì có ảnh mới. */
-{
-    type: 'qr';
-    image: string;
-    expiresAt: number;
-}
-/** Đã quét, chờ bấm xác nhận trên điện thoại. */
- | {
-    type: 'scanned';
-}
-/** Đã xác nhận — đang lấy cookie. */
- | {
-    type: 'confirmed';
-};
-export interface QrLoginOptions {
-    /** Đường dẫn Chrome / Chromium (vd `/usr/bin/chromium-browser`). */
-    chromePath: string;
-    onEvent?: (e: QrLoginEvent) => void;
-    signal?: AbortSignal;
-    /** Tổng thời gian chờ quét (ms) — mặc định 5 phút. */
-    timeoutMs?: number;
-    /** QR hết hạn (~1 phút) thì tạo lại tối đa chừng này lần. */
-    maxRefresh?: number;
-    userAgent?: string;
-}
-/**
- * Đăng nhập TikTok bằng QR. Trả `Credentials` (cookie `.tiktok.com` + UA) — đưa vào
- * `new TikTok().login(creds)` và LƯU LẠI để lần sau khỏi quét.
- */
-export declare function loginQR(opts: QrLoginOptions): Promise<Credentials>;

package/dist/qr-login.js

@@ -1,212 +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.loginQR = loginQR;
-const node_child_process_1 = require("node:child_process");
-const promises_1 = require("node:fs/promises");
-const node_os_1 = require("node:os");
-const node_path_1 = require("node:path");
-const ws_1 = __importDefault(require("ws"));
-const constants_1 = require("./constants");
-const errors_1 = require("./errors");
-/** Nối CDP vào một tab mới (một session phẳng trên websocket của trình duyệt). */
-async function openTab(browserWs) {
-    const ws = new ws_1.default(browserWs, { perMessageDeflate: false });
-    await new Promise((resolve, reject) => {
-        ws.once('open', () => resolve());
-        ws.once('error', reject);
-    });
-    let id = 0;
-    let sessionId;
-    const pending = new Map();
-    const handlers = [];
-    ws.on('message', (raw) => {
-        const m = JSON.parse(raw.toString());
-        if (m.id !== undefined && pending.has(m.id)) {
-            const p = pending.get(m.id);
-            pending.delete(m.id);
-            if (m.error)
-                p.reject(new Error(m.error.message));
-            else
-                p.resolve(m.result ?? {});
-            return;
-        }
-        if (m.method && (!m.sessionId || m.sessionId === sessionId))
-            for (const h of handlers)
-                h(m.method, m.params ?? {});
-    });
-    const raw = (method, params = {}, sid) => new Promise((resolve, reject) => {
-        const i = ++id;
-        pending.set(i, { resolve: resolve, reject });
-        ws.send(JSON.stringify({ id: i, method, params, ...(sid ? { sessionId: sid } : {}) }));
-    });
-    const target = await raw('Target.createTarget', { url: 'about:blank' });
-    sessionId = (await raw('Target.attachToTarget', { targetId: target.targetId, flatten: true })).sessionId;
-    return {
-        send: (method, params) => raw(method, params, sessionId),
-        on: (h) => handlers.push(h),
-        close: () => ws.close(),
-    };
-}
-/** Chạy Chrome headless, chờ dòng "DevTools listening on ws://…". */
-async function launchChrome(chromePath, userAgent) {
-    const dir = await (0, promises_1.mkdtemp)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'tca-chrome-'));
-    const proc = (0, node_child_process_1.spawn)(chromePath, [
-        '--headless=new',
-        '--remote-debugging-port=0',
-        `--user-data-dir=${dir}`,
-        '--no-first-run',
-        '--no-default-browser-check',
-        '--disable-gpu',
-        '--disable-dev-shm-usage',
-        // Trong container chạy root — Chromium đòi tắt sandbox.
-        '--no-sandbox',
-        '--window-size=1280,900',
-        '--lang=vi-VN',
-        // UA mặc định của headless có chữ "HeadlessChrome" — thay bằng UA thường.
-        `--user-agent=${userAgent}`,
-        'about:blank',
-    ], { stdio: ['ignore', 'ignore', 'pipe'] });
-    const ws = await new Promise((resolve, reject) => {
-        let buf = '';
-        const timer = setTimeout(() => reject(new Error('Chrome không khởi động sau 20s')), 20_000);
-        proc.stderr.on('data', (d) => {
-            buf += d.toString();
-            const m = /DevTools listening on (ws:\/\/\S+)/.exec(buf);
-            if (m) {
-                clearTimeout(timer);
-                resolve(m[1]);
-            }
-        });
-        proc.once('error', (e) => {
-            clearTimeout(timer);
-            reject(e);
-        });
-        proc.once('exit', (code) => {
-            clearTimeout(timer);
-            reject(new Error(`Chrome thoát (${code}) trước khi sẵn sàng`));
-        });
-    }).catch(async (err) => {
-        proc.kill('SIGKILL');
-        await (0, promises_1.rm)(dir, { recursive: true, force: true });
-        throw new errors_1.TikTokError('LOGIN_FAILED', `Không mở được Chrome: ${err instanceof Error ? err.message : String(err)}`);
-    });
-    return { proc, ws, dir };
-}
-/**
- * Đăng nhập TikTok bằng QR. Trả `Credentials` (cookie `.tiktok.com` + UA) — đưa vào
- * `new TikTok().login(creds)` và LƯU LẠI để lần sau khỏi quét.
- */
-async function loginQR(opts) {
-    const userAgent = opts.userAgent || constants_1.DEFAULT_USER_AGENT;
-    const maxRefresh = opts.maxRefresh ?? 3;
-    const { proc, ws, dir } = await launchChrome(opts.chromePath, userAgent);
-    let cdp = null;
-    try {
-        cdp = await openTab(ws);
-        const tab = cdp;
-        await tab.send('Network.enable');
-        await tab.send('Page.enable');
-        const result = new Promise((resolve, reject) => {
-            const urlById = new Map();
-            let refreshes = 0;
-            let scanned = false;
-            let done = false;
-            const finish = (err, creds) => {
-                if (done)
-                    return;
-                done = true;
-                clearTimeout(timer);
-                opts.signal?.removeEventListener('abort', onAbort);
-                if (err)
-                    reject(err);
-                else
-                    resolve(creds);
-            };
-            const timer = setTimeout(() => finish(new errors_1.TikTokError('LOGIN_FAILED', 'Hết thời gian chờ quét QR')), opts.timeoutMs ?? 5 * 60_000);
-            const onAbort = () => finish(new errors_1.TikTokError('LOGIN_ABORTED', 'Đã huỷ đăng nhập QR'));
-            opts.signal?.addEventListener('abort', onAbort);
-            const body = async (requestId) => {
-                const r = await tab.send('Network.getResponseBody', { requestId }).catch(() => null);
-                if (!r)
-                    return null;
-                try {
-                    return JSON.parse(r.base64Encoded ? Buffer.from(r.body, 'base64').toString() : r.body);
-                }
-                catch {
-                    return null;
-                }
-            };
-            /** Sau `confirmed`: trang tự chuyển hướng + đặt cookie phiên — chờ có `sessionid`. */
-            const collectCookies = async () => {
-                for (let i = 0; i < 30 && !done; i++) {
-                    const { cookies } = await tab.send('Network.getAllCookies');
-                    const mine = cookies.filter((c) => c.domain.endsWith('tiktok.com'));
-                    if (mine.some((c) => c.name === 'sessionid' && c.value) && mine.some((c) => c.name === 'ttwid')) {
-                        // Trùng tên ở `.tiktok.com` và `www.tiktok.com` → giữ bản `.tiktok.com`.
-                        const byName = new Map();
-                        for (const c of mine.sort((a, b) => (a.domain === '.tiktok.com' ? 1 : 0) - (b.domain === '.tiktok.com' ? 1 : 0))) {
-                            byName.set(c.name, { name: c.name, value: c.value });
-                        }
-                        return finish(null, { cookies: [...byName.values()], userAgent });
-                    }
-                    await new Promise((r) => setTimeout(r, 1000));
-                }
-                finish(new errors_1.TikTokError('LOGIN_FAILED', 'Đã xác nhận nhưng không thấy cookie sessionid'));
-            };
-            tab.on((method, p) => {
-                if (done)
-                    return;
-                if (method === 'Network.responseReceived') {
-                    const res = p.response;
-                    urlById.set(p.requestId, res.url);
-                    return;
-                }
-                if (method !== 'Network.loadingFinished')
-                    return;
-                const url = urlById.get(p.requestId) ?? '';
-                if (url.includes('/passport/web/get_qrcode/')) {
-                    void body(p.requestId).then((j) => {
-                        const qr = j?.data?.qrcode;
-                        if (typeof qr === 'string' && qr) {
-                            opts.onEvent?.({
-                                type: 'qr',
-                                image: `data:image/png;base64,${qr}`,
-                                expiresAt: Number(j?.data?.expire_time ?? 0) * 1000 || Date.now() + 60_000,
-                            });
-                        }
-                    });
-                }
-                else if (url.includes('/passport/web/check_qrconnect/')) {
-                    // Trang hỏi song song 3 vùng (sg/us/eu) — chỉ vùng của tài khoản đổi trạng thái, còn lại vẫn "new".
-                    void body(p.requestId).then((j) => {
-                        const status = String(j?.data?.status ?? '');
-                        if (status === 'scanned' && !scanned) {
-                            scanned = true;
-                            opts.onEvent?.({ type: 'scanned' });
-                        }
-                        else if (status === 'confirmed') {
-                            opts.onEvent?.({ type: 'confirmed' });
-                            void collectCookies();
-                        }
-                        else if (status === 'expired' && !scanned) {
-                            if (refreshes++ >= maxRefresh)
-                                finish(new errors_1.TikTokError('LOGIN_FAILED', 'QR hết hạn, không ai quét'));
-                            else
-                                void tab.send('Page.reload');
-                        }
-                    });
-                }
-            });
-        });
-        await tab.send('Page.navigate', { url: `${constants_1.WEB}/login/qrcode` });
-        return await result;
-    }
-    finally {
-        cdp?.close();
-        proc.kill('SIGKILL');
-        await (0, promises_1.rm)(dir, { recursive: true, force: true }).catch(() => undefined);
-    }
-}

package/dist/types.d.ts

@@ -1,109 +0,0 @@
-/** Một cookie — đúng dạng `chrome.cookies.getAll` / CDP `Storage.getCookies` trả về (thừa trường không sao). */
-export interface CookieInput {
-    name: string;
-    value: string;
-}
-/** Thứ cần để đăng nhập lại — lưu lại sau mỗi lần đăng nhập, như `{cookie, imei, userAgent}` của zca-js. */
-export interface Credentials {
-    /** Cookie của `.tiktok.com`: mảng `{name, value}`, object `{name: value}`, hoặc chuỗi `a=b; c=d`. */
-    cookies: CookieInput[] | Record<string, string> | string;
-    /** Mã máy IM (`wid`) — bỏ trống thì `login` hỏi TikTok theo `ttwid`. Chỉ dùng khi không hỏi được. */
-    deviceId?: string;
-    userAgent?: string;
-}
-export interface TikTokOptions {
-    /** Ghi log gỡ lỗi — mặc định im lặng. */
-    logger?: (level: 'debug' | 'warn', msg: string) => void;
-    /** Hạn chờ mỗi request HTTP (ms). */
-    timeoutMs?: number;
-}
-/** Đủ để nhắm một hội thoại: gửi tin, đọc tin, đánh dấu đã đọc. Mọi `TikTokMessage` đều thoả. */
-export interface ConversationRef {
-    conversationId: string;
-    conversationShortId: string;
-}
-export interface TikTokImage {
-    /** Mã ảnh trên kho TikTok (đã mã hoá). */
-    uri: string;
-    /** Link tải bản gốc — cần cookie, nội dung là AES-256-GCM. */
-    url: string;
-    thumbUrl: string;
-    width: number;
-    height: number;
-    /** Khoá AES-256-GCM (hex) để giải `url` — `api.downloadImage` lo việc này. */
-    decryptKey: string;
-}
-/** Sticker (nhãn dán) — kể cả sticker khách tự tạo (`stickerType` 15). Link CDN công khai, có chữ ký + hạn vài ngày. */
-export interface TikTokSticker {
-    stickerId: string;
-    /** 14 = sticker có sẵn của TikTok, 15 = sticker người dùng tự tạo (ảnh chế, AI…). */
-    stickerType: number;
-    url: string;
-    width: number;
-    height: number;
-}
-/** Một reaction trên tin: emoji + những người đã thả (uid). `e:love` của app điện thoại đã gộp vào ❤️. */
-export interface TikTokReaction {
-    emoji: string;
-    userIds: string[];
-}
-export interface TikTokMessage extends ConversationRef {
-    serverMessageId: string;
-    /** Vị trí trong hội thoại (µs) — làm mốc đọc tiếp tin cũ hơn. */
-    index: string;
-    /** `MessageType` — 7 chữ, 1802 ảnh, 1805 sticker, 8 chia sẻ video, 1 hệ thống. */
-    type: number;
-    /** `command` = lệnh ẩn (đã đọc…) — listener phát qua sự kiện `command`, không qua `message`. */
-    kind: 'text' | 'image' | 'sticker' | 'video' | 'system' | 'command' | 'other';
-    senderId: string;
-    isSelf: boolean;
-    /** Nội dung chữ (`kind = text`), rỗng với loại khác. */
-    text: string;
-    image: TikTokImage | null;
-    sticker: TikTokSticker | null;
-    reactions: TikTokReaction[];
-    /** JSON thô của nội dung (`{"aweType":0,"text":"…"}`…). */
-    content: unknown;
-    /** Giờ gửi, ms epoch. */
-    createdAt: number;
-    clientMessageId: string;
-    ext: Record<string, string>;
-}
-export interface TikTokConversation extends ConversationRef {
-    participants: string[];
-    /** Người còn lại trong hội thoại 1-1. */
-    peerId: string;
-}
-export interface TikTokUser {
-    uid: string;
-    /** `@username` (không có @). */
-    uniqueId: string;
-    nickname: string;
-    /** Ảnh đại diện tốt nhất (ưu tiên jpeg/webp/png, tránh heic trình duyệt không đọc). */
-    avatar: string;
-    /** Mọi link ảnh đại diện TikTok trả, xếp theo ưu tiên — link có chữ ký, có hạn; `downloadAvatar` thử lần lượt. */
-    avatars: string[];
-}
-export interface TikTokAccount {
-    uid: string;
-    username: string;
-    screenName: string;
-    avatar: string;
-}
-/** File đính kèm — giống `attachments` của zca-js. */
-export interface ImageInput {
-    data: Buffer;
-    /** Chỉ cần đuôi để TikTok biết định dạng: `anh.jpg`, `bill.png`. */
-    filename: string;
-}
-export interface MessagePage {
-    messages: TikTokMessage[];
-    hasMore: boolean;
-}
-export interface ConversationPage {
-    conversations: TikTokConversation[];
-    /** Tin mới nhất kèm theo — tiện dựng danh sách hộp thư. */
-    messages: TikTokMessage[];
-    cursor: string;
-    hasMore: boolean;
-}

package/dist/types.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });