tca-js 0.0.0-stage → 0.3.0

package/dist/qr-login.js

@@ -0,0 +1,212 @@
+"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

@@ -0,0 +1,109 @@
+/** 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

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

package/package.json

@@ -1,6 +1,28 @@
 {
   "name": "tca-js",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.3.0",
+  "description": "Unofficial TikTok Chat API for JavaScript — read/send TikTok direct messages (text, images, reactions) and listen over websocket using session cookies, no browser needed.",
+  "license": "MIT",
+  "author": "rice2411",
+  "repository": { "type": "git", "url": "git+https://github.com/rice2411/tca-js.git" },
+  "homepage": "https://github.com/rice2411/tca-js#readme",
+  "bugs": { "url": "https://github.com/rice2411/tca-js/issues" },
+  "keywords": ["tiktok", "tiktok-api", "tiktok-dm", "tiktok-chat", "direct-message", "unofficial", "chat", "websocket", "zca-js"],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": ["dist"],
+  "engines": { "node": ">=22" },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build",
+    "smoke": "node scripts/smoke.mjs"
+  },
+  "dependencies": {
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.11",
+    "typescript": "5.9.3"
+  }
+}