@lucasygu/redbook 0.1.0

package/dist/lib/client.js

@@ -0,0 +1,342 @@
+/**
+ * XHS API Client
+ *
+ * Handles all HTTP requests to edith.xiaohongshu.com and creator.xiaohongshu.com
+ * with proper signing, headers, and error handling.
+ */
+import { signMainApi, USER_AGENT, buildGetUri } from "./signing.js";
+import { signCreator } from "./creator-signing.js";
+import { cookiesToString } from "./cookies.js";
+const EDITH_HOST = "https://edith.xiaohongshu.com";
+const CREATOR_HOST = "https://creator.xiaohongshu.com";
+const HOME_URL = "https://www.xiaohongshu.com";
+const UPLOAD_HOST = "https://ros-upload.xiaohongshu.com";
+export class XhsApiError extends Error {
+    code;
+    response;
+    constructor(message, code, response) {
+        super(message);
+        this.code = code;
+        this.response = response;
+        this.name = "XhsApiError";
+    }
+}
+export class NeedVerifyError extends XhsApiError {
+    verifyType;
+    verifyUuid;
+    constructor(verifyType, verifyUuid) {
+        super(`Captcha required: type=${verifyType}, uuid=${verifyUuid}`);
+        this.verifyType = verifyType;
+        this.verifyUuid = verifyUuid;
+        this.name = "NeedVerifyError";
+    }
+}
+export class XhsClient {
+    cookies;
+    constructor(cookies) {
+        this.cookies = cookies;
+    }
+    baseHeaders() {
+        return {
+            "user-agent": USER_AGENT,
+            "content-type": "application/json",
+            cookie: cookiesToString(this.cookies),
+            origin: HOME_URL,
+            referer: `${HOME_URL}/`,
+        };
+    }
+    async mainApiGet(uri, params) {
+        const signHeaders = signMainApi("GET", uri, this.cookies, params);
+        const fullUri = buildGetUri(uri, params);
+        const url = `${EDITH_HOST}${fullUri}`;
+        const res = await fetch(url, {
+            method: "GET",
+            headers: { ...this.baseHeaders(), ...signHeaders },
+        });
+        return this.handleResponse(res);
+    }
+    async mainApiPost(uri, data) {
+        const signHeaders = signMainApi("POST", uri, this.cookies, undefined, data);
+        const url = `${EDITH_HOST}${uri}`;
+        const res = await fetch(url, {
+            method: "POST",
+            headers: { ...this.baseHeaders(), ...signHeaders },
+            body: JSON.stringify(data),
+        });
+        return this.handleResponse(res);
+    }
+    // /web_api/ endpoints → edith host; /api/galaxy/ → creator host
+    creatorHost(uri) {
+        return uri.startsWith("/api/galaxy/") ? CREATOR_HOST : EDITH_HOST;
+    }
+    async creatorGet(uri, params) {
+        let apiStr = `url=${uri}`;
+        if (params) {
+            const qs = Object.entries(params)
+                .map(([k, v]) => `${k}=${v}`)
+                .join("&");
+            apiStr = `url=${uri}?${qs}`;
+        }
+        const sign = signCreator(apiStr, null, this.cookies.a1);
+        const fullUri = params
+            ? `${uri}?${Object.entries(params).map(([k, v]) => `${k}=${v}`).join("&")}`
+            : uri;
+        const host = this.creatorHost(uri);
+        const res = await fetch(`${host}${fullUri}`, {
+            method: "GET",
+            headers: {
+                ...this.baseHeaders(),
+                "x-s": sign["x-s"],
+                "x-t": sign["x-t"],
+                origin: CREATOR_HOST,
+                referer: `${CREATOR_HOST}/`,
+            },
+        });
+        return this.handleResponse(res);
+    }
+    async creatorPost(uri, data) {
+        const sign = signCreator(`url=${uri}`, data, this.cookies.a1);
+        const host = this.creatorHost(uri);
+        const res = await fetch(`${host}${uri}`, {
+            method: "POST",
+            headers: {
+                ...this.baseHeaders(),
+                "x-s": sign["x-s"],
+                "x-t": sign["x-t"],
+                origin: CREATOR_HOST,
+                referer: `${CREATOR_HOST}/`,
+            },
+            body: JSON.stringify(data),
+        });
+        return this.handleResponse(res);
+    }
+    async handleResponse(res) {
+        if (res.status === 461 || res.status === 471) {
+            throw new NeedVerifyError(res.headers.get("verifytype") ?? "unknown", res.headers.get("verifyuuid") ?? "unknown");
+        }
+        const text = await res.text();
+        if (!text)
+            return null;
+        let data;
+        try {
+            data = JSON.parse(text);
+        }
+        catch {
+            throw new XhsApiError(`Non-JSON response: ${text.substring(0, 200)}`);
+        }
+        if (data.success) {
+            return data.data ?? data.success;
+        }
+        const code = data.code;
+        if (code === 300012) {
+            throw new XhsApiError("IP blocked by XHS", code, data);
+        }
+        if (code === 300015) {
+            throw new XhsApiError("Signature verification failed", code, data);
+        }
+        if (code === -100) {
+            throw new XhsApiError("Session expired — please re-login", code, data);
+        }
+        throw new XhsApiError(`API error: ${JSON.stringify(data).substring(0, 300)}`, code, data);
+    }
+    // ─── Reading Endpoints ──────────────────────────────────────────────────
+    async getSelfInfo() {
+        return this.mainApiGet("/api/sns/web/v2/user/me");
+    }
+    async getUserInfo(userId) {
+        return this.mainApiGet("/api/sns/web/v1/user/otherinfo", {
+            target_user_id: userId,
+        });
+    }
+    async getUserNotes(userId, cursor = "") {
+        return this.mainApiGet("/api/sns/web/v1/user_posted", {
+            num: 30,
+            cursor,
+            user_id: userId,
+            image_scenes: "FD_WM_WEBP",
+        });
+    }
+    async searchNotes(keyword, page = 1, pageSize = 20, sort = "general", noteType = 0) {
+        const searchId = generateSearchId();
+        return this.mainApiPost("/api/sns/web/v1/search/notes", {
+            keyword,
+            page,
+            page_size: pageSize,
+            search_id: searchId,
+            sort,
+            note_type: noteType,
+        });
+    }
+    async getNoteById(noteId, xsecToken, xsecSource = "pc_feed") {
+        return this.mainApiPost("/api/sns/web/v1/feed", {
+            source_note_id: noteId,
+            image_formats: ["jpg", "webp", "avif"],
+            extra: { need_body_topic: 1 },
+            xsec_source: xsecSource,
+            xsec_token: xsecToken,
+        });
+    }
+    async getHomeFeed(category = "homefeed_recommend") {
+        return this.mainApiPost("/api/sns/web/v1/homefeed", {
+            cursor_score: "",
+            num: 40,
+            refresh_type: 1,
+            note_index: 0,
+            unread_begin_note_id: "",
+            unread_end_note_id: "",
+            unread_note_count: 0,
+            category,
+            search_key: "",
+            need_num: 40,
+            image_scenes: ["FD_PRV_WEBP", "FD_WM_WEBP"],
+        });
+    }
+    async getComments(noteId, cursor = "", xsecToken = "") {
+        return this.mainApiGet("/api/sns/web/v2/comment/page", {
+            note_id: noteId,
+            cursor,
+            image_formats: "jpg,webp,avif",
+            xsec_token: xsecToken,
+        });
+    }
+    async getSubComments(noteId, rootCommentId, num = 30, cursor = "") {
+        return this.mainApiGet("/api/sns/web/v2/comment/sub/page", {
+            note_id: noteId,
+            root_comment_id: rootCommentId,
+            num,
+            cursor,
+        });
+    }
+    async postComment(noteId, content) {
+        return this.mainApiPost("/api/sns/web/v1/comment/post", {
+            note_id: noteId,
+            content,
+            at_users: [],
+        });
+    }
+    // ─── HTML Fallback ────────────────────────────────────────────────────
+    async getNoteFromHtml(noteId, xsecToken) {
+        const url = `${HOME_URL}/explore/${noteId}?xsec_token=${xsecToken}&xsec_source=pc_feed`;
+        const res = await fetch(url, {
+            headers: {
+                "user-agent": USER_AGENT,
+                referer: `${HOME_URL}/`,
+                cookie: cookiesToString(this.cookies),
+            },
+        });
+        const html = await res.text();
+        const match = html.match(/window\.__INITIAL_STATE__=({.*})<\/script>/);
+        if (!match) {
+            throw new XhsApiError("Could not parse __INITIAL_STATE__ from HTML");
+        }
+        // Replace bare `undefined` values (not inside strings) with ""
+        const stateStr = match[1].replace(/:\s*undefined/g, ':""').replace(/,\s*undefined/g, ',""');
+        const state = JSON.parse(stateStr);
+        const detailMap = state.note?.noteDetailMap;
+        if (detailMap) {
+            // Try exact noteId first, then fall back to first entry
+            const entry = detailMap[noteId] ?? Object.values(detailMap)[0];
+            if (entry && entry.note) {
+                return entry.note;
+            }
+        }
+        throw new XhsApiError("Note not found in HTML state");
+    }
+    // ─── Creator/Posting Endpoints ────────────────────────────────────────
+    async getUploadPermit(fileType, count = 1) {
+        const data = (await this.creatorGet("/api/media/v1/upload/web/permit", {
+            biz_name: "spectrum",
+            scene: fileType,
+            file_count: count,
+            version: 1,
+            source: "web",
+        }));
+        const permit = data.uploadTempPermits[0];
+        return { fileId: permit.fileIds[0], token: permit.token };
+    }
+    async uploadFile(fileId, token, filePath, contentType = "image/jpeg") {
+        const fs = await import("node:fs");
+        const fileData = fs.readFileSync(filePath);
+        const url = `${UPLOAD_HOST}/${fileId}`;
+        const res = await fetch(url, {
+            method: "PUT",
+            headers: {
+                "X-Cos-Security-Token": token,
+                "Content-Type": contentType,
+            },
+            body: fileData,
+        });
+        if (!res.ok) {
+            throw new XhsApiError(`Upload failed: ${res.status} ${res.statusText}`);
+        }
+    }
+    async createImageNote(title, desc, imageFileIds, options = {}) {
+        const images = imageFileIds.map((fileId) => ({
+            file_id: fileId,
+            metadata: { source: -1 },
+        }));
+        const businessBinds = {
+            version: 1,
+            noteId: 0,
+            noteOrderBind: {},
+            notePostTiming: { postTime: options.postTime ? new Date(options.postTime).getTime() : null },
+            noteCollectionBind: { id: "" },
+        };
+        const data = {
+            common: {
+                type: "normal",
+                title,
+                note_id: "",
+                desc,
+                source: '{"type":"web","ids":"","extraInfo":"{\\"subType\\":\\"official\\"}"}',
+                business_binds: JSON.stringify(businessBinds),
+                ats: options.ats ?? [],
+                hash_tag: options.topics ?? [],
+                post_loc: {},
+                privacy_info: { op_type: 1, type: options.isPrivate ? 1 : 0 },
+            },
+            image_info: { images },
+            video_info: null,
+        };
+        return this.creatorPost("/web_api/sns/v2/note", data);
+    }
+    async searchTopics(keyword) {
+        return this.creatorPost("/web_api/sns/v1/search/topic", {
+            keyword,
+            suggest_topic_request: { title: "", desc: "" },
+            page: { page_size: 20, page: 1 },
+        });
+    }
+    async searchUsers(keyword) {
+        return this.creatorPost("/web_api/sns/v1/search/user_info", {
+            keyword,
+            search_id: String(Date.now()),
+            page: { page_size: 20, page: 1 },
+        });
+    }
+    async getCreatorNoteList(tab = 0, page = 0) {
+        return this.creatorGet("/api/galaxy/creator/note/user/posted", {
+            tab,
+            page,
+        });
+    }
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function generateSearchId() {
+    const e = BigInt(Date.now()) << 64n;
+    const t = BigInt(Math.floor(Math.random() * 2147483646));
+    return base36Encode(e + t);
+}
+function base36Encode(num) {
+    const alphabet = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ";
+    if (num === 0n)
+        return "0";
+    let result = "";
+    let n = num;
+    while (n > 0n) {
+        result = alphabet[Number(n % 36n)] + result;
+        n = n / 36n;
+    }
+    return result;
+}
+//# sourceMappingURL=client.js.map

package/dist/lib/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/lib/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAc,MAAM,cAAc,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAmB,MAAM,cAAc,CAAC;AAEhE,MAAM,UAAU,GAAG,+BAA+B,CAAC;AACnD,MAAM,YAAY,GAAG,iCAAiC,CAAC;AACvD,MAAM,QAAQ,GAAG,6BAA6B,CAAC;AAC/C,MAAM,WAAW,GAAG,oCAAoC,CAAC;AAEzD,MAAM,OAAO,WAAY,SAAQ,KAAK;IAG3B;IACA;IAHT,YACE,OAAe,EACR,IAAsB,EACtB,QAAkB;QAEzB,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,SAAI,GAAJ,IAAI,CAAkB;QACtB,aAAQ,GAAR,QAAQ,CAAU;QAGzB,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,WAAW;IAErC;IACA;IAFT,YACS,UAAkB,EAClB,UAAkB;QAEzB,KAAK,CAAC,0BAA0B,UAAU,UAAU,UAAU,EAAE,CAAC,CAAC;QAH3D,eAAU,GAAV,UAAU,CAAQ;QAClB,eAAU,GAAV,UAAU,CAAQ;QAGzB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,SAAS;IACZ,OAAO,CAAa;IAE5B,YAAY,OAAmB;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAEO,WAAW;QACjB,OAAO;YACL,YAAY,EAAE,UAAU;YACxB,cAAc,EAAE,kBAAkB;YAClC,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC;YACrC,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE,GAAG,QAAQ,GAAG;SACxB,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,UAAU,CACtB,GAAW,EACX,MAAmD;QAEnD,MAAM,WAAW,GAAG,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAClE,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,GAAG,UAAU,GAAG,OAAO,EAAE,CAAC;QAEtC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC3B,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,EAAE,GAAG,WAAW,EAAE;SACnD,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAEO,KAAK,CAAC,WAAW,CACvB,GAAW,EACX,IAA6B;QAE7B,MAAM,WAAW,GAAG,WAAW,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;QAC5E,MAAM,GAAG,GAAG,GAAG,UAAU,GAAG,GAAG,EAAE,CAAC;QAElC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC3B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,EAAE,GAAG,WAAW,EAAE;YAClD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAED,gEAAgE;IACxD,WAAW,CAAC,GAAW;QAC7B,OAAO,GAAG,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC;IACpE,CAAC;IAEO,KAAK,CAAC,UAAU,CACtB,GAAW,EACX,MAAwC;QAExC,IAAI,MAAM,GAAG,OAAO,GAAG,EAAE,CAAC;QAC1B,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;iBAC9B,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;iBAC5B,IAAI,CAAC,GAAG,CAAC,CAAC;YACb,MAAM,GAAG,OAAO,GAAG,IAAI,EAAE,EAAE,CAAC;QAC9B,CAAC;QAED,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACxD,MAAM,OAAO,GAAG,MAAM;YACpB,CAAC,CAAC,GAAG,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;YAC3E,CAAC,CAAC,GAAG,CAAC;QAER,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,GAAG,OAAO,EAAE,EAAE;YAC3C,MAAM,EAAE,KAAK;YACb,OAAO,EAAE;gBACP,GAAG,IAAI,CAAC,WAAW,EAAE;gBACrB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC;gBAClB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC;gBAClB,MAAM,EAAE,YAAY;gBACpB,OAAO,EAAE,GAAG,YAAY,GAAG;aAC5B;SACF,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAEO,KAAK,CAAC,WAAW,CACvB,GAAW,EACX,IAA6B;QAE7B,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAE9D,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,GAAG,GAAG,EAAE,EAAE;YACvC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,GAAG,IAAI,CAAC,WAAW,EAAE;gBACrB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC;gBAClB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC;gBAClB,MAAM,EAAE,YAAY;gBACpB,OAAO,EAAE,GAAG,YAAY,GAAG;aAC5B;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAEO,KAAK,CAAC,cAAc,CAAC,GAAa;QACxC,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC7C,MAAM,IAAI,eAAe,CACvB,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,SAAS,EAC1C,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,SAAS,CAC3C,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QAEvB,IAAI,IAA6B,CAAC;QAClC,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,WAAW,CAAC,sBAAsB,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QACxE,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC;QACnC,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,IAAmC,CAAC;QACtD,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACpB,MAAM,IAAI,WAAW,CAAC,mBAAmB,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACpB,MAAM,IAAI,WAAW,CAAC,+BAA+B,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACrE,CAAC;QACD,IAAI,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;YAClB,MAAM,IAAI,WAAW,CAAC,mCAAmC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACzE,CAAC;QAED,MAAM,IAAI,WAAW,CACnB,cAAc,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EACtD,IAAI,EACJ,IAAI,CACL,CAAC;IACJ,CAAC;IAED,2EAA2E;IAE3E,KAAK,CAAC,WAAW;QACf,OAAO,IAAI,CAAC,UAAU,CAAC,yBAAyB,CAAC,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAAc;QAC9B,OAAO,IAAI,CAAC,UAAU,CAAC,gCAAgC,EAAE;YACvD,cAAc,EAAE,MAAM;SACvB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,MAAc,EACd,SAAiB,EAAE;QAEnB,OAAO,IAAI,CAAC,UAAU,CAAC,6BAA6B,EAAE;YACpD,GAAG,EAAE,EAAE;YACP,MAAM;YACN,OAAO,EAAE,MAAM;YACf,YAAY,EAAE,YAAY;SAC3B,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,WAAW,CACf,OAAe,EACf,OAAe,CAAC,EAChB,WAAmB,EAAE,EACrB,OAAgE,SAAS,EACzE,WAAsB,CAAC;QAEvB,MAAM,QAAQ,GAAG,gBAAgB,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC,WAAW,CAAC,8BAA8B,EAAE;YACtD,OAAO;YACP,IAAI;YACJ,SAAS,EAAE,QAAQ;YACnB,SAAS,EAAE,QAAQ;YACnB,IAAI;YACJ,SAAS,EAAE,QAAQ;SACpB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,WAAW,CACf,MAAc,EACd,SAAiB,EACjB,aAAqB,SAAS;QAE9B,OAAO,IAAI,CAAC,WAAW,CAAC,sBAAsB,EAAE;YAC9C,cAAc,EAAE,MAAM;YACtB,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC;YACtC,KAAK,EAAE,EAAE,eAAe,EAAE,CAAC,EAAE;YAC7B,WAAW,EAAE,UAAU;YACvB,UAAU,EAAE,SAAS;SACtB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,WAAW,CACf,WAAmB,oBAAoB;QAEvC,OAAO,IAAI,CAAC,WAAW,CAAC,0BAA0B,EAAE;YAClD,YAAY,EAAE,EAAE;YAChB,GAAG,EAAE,EAAE;YACP,YAAY,EAAE,CAAC;YACf,UAAU,EAAE,CAAC;YACb,oBAAoB,EAAE,EAAE;YACxB,kBAAkB,EAAE,EAAE;YACtB,iBAAiB,EAAE,CAAC;YACpB,QAAQ;YACR,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE,EAAE;YACZ,YAAY,EAAE,CAAC,aAAa,EAAE,YAAY,CAAC;SAC5C,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,WAAW,CACf,MAAc,EACd,SAAiB,EAAE,EACnB,YAAoB,EAAE;QAEtB,OAAO,IAAI,CAAC,UAAU,CAAC,8BAA8B,EAAE;YACrD,OAAO,EAAE,MAAM;YACf,MAAM;YACN,aAAa,EAAE,eAAe;YAC9B,UAAU,EAAE,SAAS;SACtB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,MAAc,EACd,aAAqB,EACrB,MAAc,EAAE,EAChB,SAAiB,EAAE;QAEnB,OAAO,IAAI,CAAC,UAAU,CAAC,kCAAkC,EAAE;YACzD,OAAO,EAAE,MAAM;YACf,eAAe,EAAE,aAAa;YAC9B,GAAG;YACH,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,WAAW,CACf,MAAc,EACd,OAAe;QAEf,OAAO,IAAI,CAAC,WAAW,CAAC,8BAA8B,EAAE;YACtD,OAAO,EAAE,MAAM;YACf,OAAO;YACP,QAAQ,EAAE,EAAE;SACb,CAAC,CAAC;IACL,CAAC;IAED,yEAAyE;IAEzE,KAAK,CAAC,eAAe,CACnB,MAAc,EACd,SAAiB;QAEjB,MAAM,GAAG,GAAG,GAAG,QAAQ,YAAY,MAAM,eAAe,SAAS,sBAAsB,CAAC;QACxF,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC3B,OAAO,EAAE;gBACP,YAAY,EAAE,UAAU;gBACxB,OAAO,EAAE,GAAG,QAAQ,GAAG;gBACvB,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC;aACtC;SACF,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CACtB,4CAA4C,CAC7C,CAAC;QACF,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,WAAW,CAAC,6CAA6C,CAAC,CAAC;QACvE,CAAC;QAED,+DAA+D;QAC/D,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;QAC5F,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAEnC,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,EAAE,aAAa,CAAC;QAC5C,IAAI,SAAS,EAAE,CAAC;YACd,wDAAwD;YACxD,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/D,IAAI,KAAK,IAAK,KAAiC,CAAC,IAAI,EAAE,CAAC;gBACrD,OAAQ,KAAiC,CAAC,IAAI,CAAC;YACjD,CAAC;QACH,CAAC;QAED,MAAM,IAAI,WAAW,CAAC,8BAA8B,CAAC,CAAC;IACxD,CAAC;IAED,yEAAyE;IAEzE,KAAK,CAAC,eAAe,CACnB,QAA2B,EAC3B,QAAgB,CAAC;QAEjB,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,iCAAiC,EAAE;YACrE,QAAQ,EAAE,UAAU;YACpB,KAAK,EAAE,QAAQ;YACf,UAAU,EAAE,KAAK;YACjB,OAAO,EAAE,CAAC;YACV,MAAM,EAAE,KAAK;SACd,CAAC,CAAuE,CAAC;QAE1E,MAAM,MAAM,GAAG,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;QACzC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,UAAU,CACd,MAAc,EACd,KAAa,EACb,QAAgB,EAChB,cAAsB,YAAY;QAElC,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;QACnC,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC3C,MAAM,GAAG,GAAG,GAAG,WAAW,IAAI,MAAM,EAAE,CAAC;QAEvC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC3B,MAAM,EAAE,KAAK;YACb,OAAO,EAAE;gBACP,sBAAsB,EAAE,KAAK;gBAC7B,cAAc,EAAE,WAAW;aAC5B;YACD,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,WAAW,CAAC,kBAAkB,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,KAAa,EACb,IAAY,EACZ,YAAsB,EACtB,UAKI,EAAE;QAEN,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAC3C,OAAO,EAAE,MAAM;YACf,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE;SACzB,CAAC,CAAC,CAAC;QAEJ,MAAM,aAAa,GAAG;YACpB,OAAO,EAAE,CAAC;YACV,MAAM,EAAE,CAAC;YACT,aAAa,EAAE,EAAE;YACjB,cAAc,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE;YAC5F,kBAAkB,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;SAC/B,CAAC;QAEF,MAAM,IAAI,GAAG;YACX,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,KAAK;gBACL,OAAO,EAAE,EAAE;gBACX,IAAI;gBACJ,MAAM,EAAE,sEAAsE;gBAC9E,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC;gBAC7C,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,EAAE;gBACtB,QAAQ,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;gBAC9B,QAAQ,EAAE,EAAE;gBACZ,YAAY,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;aAC9D;YACD,UAAU,EAAE,EAAE,MAAM,EAAE;YACtB,UAAU,EAAE,IAAI;SACjB,CAAC;QAEF,OAAO,IAAI,CAAC,WAAW,CAAC,sBAAsB,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,OAAe;QAChC,OAAO,IAAI,CAAC,WAAW,CAAC,8BAA8B,EAAE;YACtD,OAAO;YACP,qBAAqB,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;YAC9C,IAAI,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE;SACjC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAe;QAC/B,OAAO,IAAI,CAAC,WAAW,CAAC,kCAAkC,EAAE;YAC1D,OAAO;YACP,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7B,IAAI,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE;SACjC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,kBAAkB,CACtB,MAAc,CAAC,EACf,OAAe,CAAC;QAEhB,OAAO,IAAI,CAAC,UAAU,CAAC,sCAAsC,EAAE;YAC7D,GAAG;YACH,IAAI;SACL,CAAC,CAAC;IACL,CAAC;CACF;AAED,iFAAiF;AAEjF,SAAS,gBAAgB;IACvB,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,GAAG,CAAC;IACpC,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC;IACzD,OAAO,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,YAAY,CAAC,GAAW;IAC/B,MAAM,QAAQ,GAAG,sCAAsC,CAAC;IACxD,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,GAAG,CAAC;IAC3B,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,CAAC,GAAG,GAAG,CAAC;IACZ,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC;QACd,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC;QAC5C,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACd,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/lib/cookies.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Cookie extraction module — wraps @steipete/sweet-cookie
+ * Same pattern as bird.fast for Chrome/Safari/Firefox cookie extraction
+ */
+export interface XhsCookies {
+    a1: string;
+    web_session: string;
+    webId: string;
+    [key: string]: string;
+}
+export type CookieSource = "chrome" | "safari" | "firefox";
+/**
+ * Extract XHS cookies from browser cookie store.
+ * Requires user to be logged into xiaohongshu.com in the specified browser.
+ */
+export declare function extractCookies(source?: CookieSource): Promise<XhsCookies>;
+/**
+ * Format cookies as a cookie header string: "a1=xxx; web_session=yyy; ..."
+ */
+export declare function cookiesToString(cookies: XhsCookies): string;
+//# sourceMappingURL=cookies.d.ts.map

package/dist/lib/cookies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookies.d.ts","sourceRoot":"","sources":["../../src/lib/cookies.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE3D;;;GAGG;AACH,wBAAsB,cAAc,CAClC,MAAM,GAAE,YAAuB,GAC9B,OAAO,CAAC,UAAU,CAAC,CAkBrB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAI3D"}

package/dist/lib/cookies.js

@@ -0,0 +1,32 @@
+/**
+ * Cookie extraction module — wraps @steipete/sweet-cookie
+ * Same pattern as bird.fast for Chrome/Safari/Firefox cookie extraction
+ */
+import { getCookies } from "@steipete/sweet-cookie";
+/**
+ * Extract XHS cookies from browser cookie store.
+ * Requires user to be logged into xiaohongshu.com in the specified browser.
+ */
+export async function extractCookies(source = "chrome") {
+    const result = await getCookies({
+        url: "https://www.xiaohongshu.com/",
+        browsers: [source],
+    });
+    const cookieMap = {};
+    for (const cookie of result.cookies) {
+        cookieMap[cookie.name] = cookie.value;
+    }
+    if (!cookieMap.a1) {
+        throw new Error(`No 'a1' cookie found for xiaohongshu.com in ${source}. Are you logged into xiaohongshu.com?`);
+    }
+    return cookieMap;
+}
+/**
+ * Format cookies as a cookie header string: "a1=xxx; web_session=yyy; ..."
+ */
+export function cookiesToString(cookies) {
+    return Object.entries(cookies)
+        .map(([k, v]) => `${k}=${v}`)
+        .join("; ");
+}
+//# sourceMappingURL=cookies.js.map

package/dist/lib/cookies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookies.js","sourceRoot":"","sources":["../../src/lib/cookies.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAWpD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,SAAuB,QAAQ;IAE/B,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC;QAC9B,GAAG,EAAE,8BAA8B;QACnC,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB,CAAC,CAAC;IAEH,MAAM,SAAS,GAA2B,EAAE,CAAC;IAC7C,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACpC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;IACxC,CAAC;IAED,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,+CAA+C,MAAM,wCAAwC,CAC9F,CAAC;IACJ,CAAC;IAED,OAAO,SAAuB,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,OAAmB;IACjD,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;SAC3B,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;SAC5B,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/lib/creator-signing.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Creator platform signing (XYW_ prefix)
+ * Used for creator.xiaohongshu.com endpoints (posting, analytics)
+ *
+ * Algorithm: MD5(api + JSON(data)) → AES-128-CBC encrypt → XYW_ prefix
+ * Much simpler than main API signing.
+ *
+ * Ported from: Spider_XHS/static/xhs_creator_xs.js + ReaJason/xhs help.py
+ */
+export interface CreatorSignResult {
+    "x-s": string;
+    "x-t": string;
+}
+/**
+ * Generate creator platform signature headers.
+ *
+ * @param api - The API path, prefixed with "url=" (e.g., "url=/web_api/sns/v2/note")
+ * @param data - Request body data (null for GET requests)
+ * @param a1 - The a1 cookie value
+ * @returns Object with x-s and x-t headers
+ */
+export declare function signCreator(api: string, data: Record<string, unknown> | null, a1: string): CreatorSignResult;
+//# sourceMappingURL=creator-signing.d.ts.map

package/dist/lib/creator-signing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"creator-signing.d.ts","sourceRoot":"","sources":["../../src/lib/creator-signing.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAcH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACpC,EAAE,EAAE,MAAM,GACT,iBAAiB,CA6BnB"}

package/dist/lib/creator-signing.js

@@ -0,0 +1,52 @@
+/**
+ * Creator platform signing (XYW_ prefix)
+ * Used for creator.xiaohongshu.com endpoints (posting, analytics)
+ *
+ * Algorithm: MD5(api + JSON(data)) → AES-128-CBC encrypt → XYW_ prefix
+ * Much simpler than main API signing.
+ *
+ * Ported from: Spider_XHS/static/xhs_creator_xs.js + ReaJason/xhs help.py
+ */
+import crypto from "node:crypto";
+const AES_KEY = Buffer.from("7cc4adla5ay0701v");
+const AES_IV = Buffer.from("4uzjr7mbsibcaldp");
+function aesEncrypt(data) {
+    const cipher = crypto.createCipheriv("aes-128-cbc", AES_KEY, AES_IV);
+    let encrypted = cipher.update(data, "utf8", "hex");
+    encrypted += cipher.final("hex");
+    return encrypted;
+}
+/**
+ * Generate creator platform signature headers.
+ *
+ * @param api - The API path, prefixed with "url=" (e.g., "url=/web_api/sns/v2/note")
+ * @param data - Request body data (null for GET requests)
+ * @param a1 - The a1 cookie value
+ * @returns Object with x-s and x-t headers
+ */
+export function signCreator(api, data, a1) {
+    let content = api;
+    if (data) {
+        content += JSON.stringify(data);
+    }
+    const md5 = crypto.createHash("md5");
+    const x1 = md5.update(content).digest("hex");
+    const x2 = "0|0|0|1|0|0|1|0|0|0|1|0|0|0|0|1|0|0|0";
+    const x3 = a1;
+    const x4 = Date.now();
+    const plaintext = `x1=${x1};x2=${x2};x3=${x3};x4=${x4};`;
+    const payload = aesEncrypt(Buffer.from(plaintext).toString("base64"));
+    const envelope = {
+        signSvn: "56",
+        signType: "x2",
+        appId: "ugc",
+        signVersion: "1",
+        payload,
+    };
+    const xs = "XYW_" + Buffer.from(JSON.stringify(envelope)).toString("base64");
+    return {
+        "x-s": xs,
+        "x-t": String(x4),
+    };
+}
+//# sourceMappingURL=creator-signing.js.map

package/dist/lib/creator-signing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"creator-signing.js","sourceRoot":"","sources":["../../src/lib/creator-signing.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;AAChD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;AAE/C,SAAS,UAAU,CAAC,IAAY;IAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,CAAC,aAAa,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACrE,IAAI,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACnD,SAAS,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACjC,OAAO,SAAS,CAAC;AACnB,CAAC;AAOD;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CACzB,GAAW,EACX,IAAoC,EACpC,EAAU;IAEV,IAAI,OAAO,GAAG,GAAG,CAAC;IAClB,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACrC,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,EAAE,GAAG,uCAAuC,CAAC;IACnD,MAAM,EAAE,GAAG,EAAE,CAAC;IACd,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEtB,MAAM,SAAS,GAAG,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC;IACzD,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEtE,MAAM,QAAQ,GAAG;QACf,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,KAAK;QACZ,WAAW,EAAE,GAAG;QAChB,OAAO;KACR,CAAC;IAEF,MAAM,EAAE,GAAG,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAE7E,OAAO;QACL,KAAK,EAAE,EAAE;QACT,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;KAClB,CAAC;AACJ,CAAC"}

package/dist/lib/fingerprint-data.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Fingerprint data constants for generating realistic browser fingerprints.
+ * Ported from: Cloxl/xhshow data/fingerprint_data.py
+ */
+export declare const GPU_VENDORS: string[];
+export declare const SCREEN_RESOLUTIONS: {
+    resolutions: string[];
+    weights: number[];
+};
+export declare const FINGERPRINT_DEFAULTS: {
+    browserPlugins: string;
+    fonts: string;
+};
+//# sourceMappingURL=fingerprint-data.d.ts.map

package/dist/lib/fingerprint-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint-data.d.ts","sourceRoot":"","sources":["../../src/lib/fingerprint-data.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,WAAW,UAevB,CAAC;AAEF,eAAO,MAAM,kBAAkB;;;CAS9B,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;CAKhC,CAAC"}

package/dist/lib/fingerprint-data.js

@@ -0,0 +1,35 @@
+/**
+ * Fingerprint data constants for generating realistic browser fingerprints.
+ * Ported from: Cloxl/xhshow data/fingerprint_data.py
+ */
+export const GPU_VENDORS = [
+    "Google Inc. (Intel)|ANGLE (Intel, Intel(R) HD Graphics 520 (0x1912) Direct3D11 vs_5_0 ps_5_0, D3D11)",
+    "Google Inc. (Intel)|ANGLE (Intel, Intel(R) UHD Graphics 620 (0x00003EA0) Direct3D11 vs_5_0 ps_5_0, D3D11)",
+    "Google Inc. (Intel)|ANGLE (Intel, Intel(R) UHD Graphics 630 (0x00003E9B) Direct3D11 vs_5_0 ps_5_0, D3D11)",
+    "Google Inc. (Intel)|ANGLE (Intel, Intel(R) Iris(R) Xe Graphics (0x000046A8) Direct3D11 vs_5_0 ps_5_0, D3D11)",
+    "Google Inc. (AMD)|ANGLE (AMD, AMD Radeon Graphics (0x00001636) Direct3D11 vs_5_0 ps_5_0, D3D11)",
+    "Google Inc. (AMD)|ANGLE (AMD, AMD Radeon RX 580 2048SP (0x00006FDF) Direct3D11 vs_5_0 ps_5_0, D3D11)",
+    "Google Inc. (AMD)|ANGLE (AMD, AMD Radeon RX 6600 XT (0x000073FF) Direct3D11 vs_5_0 ps_5_0, D3D11)",
+    "Google Inc. (NVIDIA)|ANGLE (NVIDIA, NVIDIA GeForce GTX 1060 6GB (0x000010DE) Direct3D11 vs_5_0 ps_5_0, D3D11)",
+    "Google Inc. (NVIDIA)|ANGLE (NVIDIA, NVIDIA GeForce RTX 3060 (0x0000250F) Direct3D11 vs_5_0 ps_5_0, D3D11)",
+    "Google Inc. (NVIDIA)|ANGLE (NVIDIA, NVIDIA GeForce RTX 3070 (0x00002488) Direct3D11 vs_5_0 ps_5_0, D3D11)",
+    "Google Inc. (NVIDIA)|ANGLE (NVIDIA, NVIDIA GeForce RTX 4060 (0x00002882) Direct3D11 vs_5_0 ps_5_0, D3D11)",
+    "Google Inc. (NVIDIA)|ANGLE (NVIDIA, NVIDIA GeForce RTX 4070 (0x00002786) Direct3D11 vs_5_0 ps_5_0, D3D11)",
+    "Google Inc. (NVIDIA)|ANGLE (NVIDIA, NVIDIA GeForce RTX 4090 (0x00002684) Direct3D11 vs_5_0 ps_5_0, D3D11)",
+    "Google Inc. (Google)|ANGLE (Google, Vulkan 1.3.0 (SwiftShader Device (Subzero) (0x0000C0DE)), SwiftShader driver)",
+];
+export const SCREEN_RESOLUTIONS = {
+    resolutions: [
+        "1366;768",
+        "1600;900",
+        "1920;1080",
+        "2560;1440",
+        "3840;2160",
+    ],
+    weights: [0.25, 0.15, 0.4, 0.15, 0.05],
+};
+export const FINGERPRINT_DEFAULTS = {
+    browserPlugins: "PDF Viewer,Chrome PDF Viewer,Chromium PDF Viewer,Microsoft Edge PDF Viewer,WebKit built-in PDF",
+    fonts: 'system-ui, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji", -apple-system, "Segoe UI", Roboto, Ubuntu, Cantarell, "Noto Sans", sans-serif, BlinkMacSystemFont, "Helvetica Neue", Arial, "PingFang SC", "PingFang TC", "PingFang HK", "Microsoft Yahei", "Microsoft JhengHei"',
+};
+//# sourceMappingURL=fingerprint-data.js.map

package/dist/lib/fingerprint-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint-data.js","sourceRoot":"","sources":["../../src/lib/fingerprint-data.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,sGAAsG;IACtG,2GAA2G;IAC3G,2GAA2G;IAC3G,8GAA8G;IAC9G,iGAAiG;IACjG,sGAAsG;IACtG,mGAAmG;IACnG,+GAA+G;IAC/G,2GAA2G;IAC3G,2GAA2G;IAC3G,2GAA2G;IAC3G,2GAA2G;IAC3G,2GAA2G;IAC3G,mHAAmH;CACpH,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,WAAW,EAAE;QACX,UAAU;QACV,UAAU;QACV,WAAW;QACX,WAAW;QACX,WAAW;KACZ;IACD,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC;CACvC,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,cAAc,EACZ,gGAAgG;IAClG,KAAK,EACH,2SAA2S;CAC9S,CAAC"}

package/dist/lib/signing.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Main API signing (XYS_ prefix) for edith.xiaohongshu.com
+ *
+ * Generates x-s, x-s-common, x-t, x-b3-traceid, x-xray-traceid headers.
+ *
+ * Algorithm overview:
+ *   1. MD5 hash of content string (URI + params/body)
+ *   2. Build 124-byte binary payload array
+ *   3. XOR with static 124-byte hex key
+ *   4. Custom Base64 encode (shuffled alphabet)
+ *   5. Wrap in JSON envelope → another custom Base64 → XYS_ prefix
+ *
+ * Ported from: Cloxl/xhshow (MIT license)
+ */
+declare const USER_AGENT = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/142.0.0.0 Safari/537.36 Edg/142.0.0.0";
+declare function extractUri(url: string): string;
+declare function buildGetUri(uri: string, params?: Record<string, string | number | string[]>): string;
+export interface SignHeaders {
+    "x-s": string;
+    "x-s-common": string;
+    "x-t": string;
+    "x-b3-traceid": string;
+    "x-xray-traceid": string;
+}
+/**
+ * Generate all signing headers for a main API (edith.xiaohongshu.com) request.
+ */
+export declare function signMainApi(method: "GET" | "POST", uri: string, cookies: Record<string, string>, params?: Record<string, string | number | string[]>, payload?: Record<string, unknown>, timestamp?: number): SignHeaders;
+export { USER_AGENT, extractUri, buildGetUri };
+//# sourceMappingURL=signing.d.ts.map

package/dist/lib/signing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signing.d.ts","sourceRoot":"","sources":["../../src/lib/signing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AA2DH,QAAA,MAAM,UAAU,kIACiH,CAAC;AAkdlI,iBAAS,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQvC;AAED,iBAAS,WAAW,CAClB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC,GAClD,MAAM,CASR;AAID,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,KAAK,GAAG,MAAM,EACtB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC,EACnD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,SAAS,CAAC,EAAE,MAAM,GACjB,WAAW,CA8Cb;AAED,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC"}