emusks 2.0.0 → 2.0.2

package/README.md

@@ -1,6 +1,6 @@
-<img src="docs/src/icon.svg" width="120">
+<img src="https://emusks.tiago.zip/icon.svg" width="120">
 <h1>emusks: Reverse-engineered Twitter API client</h1>
 
 Log in and interact with the unofficial X API using any client identity — web, Android, iOS, or TweetDeck
 
-[Learn more →](https://emusks.js.org)
+[Learn more →](https://emusks.tiago.zip)

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "emusks",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "Reverse-engineered Twitter API client. Log in and interact with the unofficial X API using any client identity — web, Android, iOS, or TweetDeck",
   "keywords": ["twitter", "twitter-api", "x", "x-api", "reverse-engineering", "client"],
-  "homepage": "https://github.com/tiagozip/cap",
+  "homepage": "https://github.com/tiagozip/emusks",
   "bugs": {
-    "url": "https://github.com/tiagozip/cap/issues"
+    "url": "https://github.com/tiagozip/emusks/issues"
   },
   "license": "AGPL-3.0-only",
   "repository": {
     "type": "git",
-    "url": "https://github.com/tiagozip/cap.git"
+    "url": "https://github.com/tiagozip/emusks.git"
   },
   "dependencies": {
     "cycletls": "^2.0.5",

package/src/helpers/media.js

@@ -127,20 +127,9 @@ async function makeUploadRequest(
 }
 
 export default (client) => ({
-  /**
-   * Upload media (image, GIF, or video) to Twitter.
-   *
-   * @param {string|Buffer|Uint8Array|ArrayBuffer|Blob} source - file path, Buffer, Uint8Array, ArrayBuffer, or Blob
-   * @param {object} [opts]
-   * @param {string} [opts.alt_text]   - alt text for accessibility
-   * @param {string} [opts.mediaType]  - explicit MIME type (e.g. "image/png"); auto-detected when omitted
-   * @param {"tweet"|"dm"} [opts.type] - upload context; defaults to "tweet"
-   * @returns {{ media_id: string }}
-   */
   async create(source, opts = {}) {
     if (!client.auth) throw new Error("you must be logged in to upload media");
 
-    // ── normalise input to Buffer ──────────────────────────────────────
     let buf;
     let mediaType = opts.mediaType;
 
@@ -174,7 +163,6 @@ export default (client) => ({
     const category = getMediaCategory(mediaType, uploadType);
     checkMediaSize(category, totalBytes);
 
-    // ── INIT ───────────────────────────────────────────────────────────
     const initRes = await makeUploadRequest(client, "post", {
       command: "INIT",
       media_type: mediaType,
@@ -188,7 +176,6 @@ export default (client) => ({
     }
     const mediaId = initData.media_id_string;
 
-    // ── APPEND (chunked, base64) ───────────────────────────────────────
     let segmentIndex = 0;
     for (let offset = 0; offset < totalBytes; offset += CHUNK_SIZE) {
       const chunk = buf.slice(
@@ -211,7 +198,6 @@ export default (client) => ({
       segmentIndex++;
     }
 
-    // ── FINALIZE ───────────────────────────────────────────────────────
     const finalizeRes = await makeUploadRequest(client, "post", {
       command: "FINALIZE",
       media_id: mediaId,
@@ -225,7 +211,6 @@ export default (client) => ({
       );
     }
 
-    // ── poll for async processing (videos / gifs) ──────────────────────
     let processingInfo = finalizeData?.processing_info;
     while (processingInfo) {
       if (processingInfo.error) {
@@ -251,7 +236,6 @@ export default (client) => ({
       processingInfo = statusData?.processing_info;
     }
 
-    // ── alt text ───────────────────────────────────────────────────────
     if (opts.alt_text) {
       await client.v1_1("media/metadata/create", {
         body: JSON.stringify({

package/src/helpers/tweets.js

@@ -37,7 +37,6 @@ async function createPollCard(client, poll) {
   };
 
   if (hasImages) {
-    // media poll — uses a different card type and includes image media IDs
     cardObj["twitter:card"] = `poll_choice_images`;
     for (let i = 0; i < poll.choices.length; i++) {
       cardObj[`twitter:string:choice${i + 1}_label`] = labels[i];
@@ -45,7 +44,6 @@ async function createPollCard(client, poll) {
         `mis://${poll.choices[i].image}`;
     }
   } else {
-    // text-only poll
     cardObj["twitter:card"] = `poll${poll.choices.length}choice_text_only`;
     for (let i = 0; i < labels.length; i++) {
       cardObj[`twitter:string:choice${i + 1}_label`] = labels[i];

package/src/parsers/timeline.js

@@ -1,19 +1,6 @@
 import parseTweet from "./tweet.js";
 import parseUser from "./user.js";
 
-/**
- * Recursively find the `instructions` array from any Twitter timeline response.
- *
- * Known response shapes:
- *   data.home.home_timeline_urt.instructions
- *   data.user.result.timeline_v2.timeline.instructions
- *   data.search_by_raw_query.search_timeline.timeline.instructions
- *   data.bookmark_timeline_v2.timeline.instructions
- *   data.bookmark_search_timeline.timeline.instructions
- *   data.list.tweets_timeline.timeline.instructions
- *   data.timeline_by_id.timeline.instructions
- *   ... and many more
- */
 function findInstructions(obj) {
   if (!obj || typeof obj !== "object") return null;
 
@@ -32,11 +19,7 @@ function findInstructions(obj) {
   return null;
 }
 
-/**
- * Extract tweet results from a single timeline entry.
- */
 function extractTweetFromEntry(entry) {
-  // Standard tweet entry
   const tweetResult =
     entry?.content?.itemContent?.tweet_results?.result ||
     entry?.item?.itemContent?.tweet_results?.result;
@@ -46,9 +29,6 @@ function extractTweetFromEntry(entry) {
   return null;
 }
 
-/**
- * Extract user results from a single timeline entry.
- */
 function extractUserFromEntry(entry) {
   const userResult =
     entry?.content?.itemContent?.user_results?.result ||
@@ -59,12 +39,6 @@ function extractUserFromEntry(entry) {
   return null;
 }
 
-/**
- * Parse a raw Twitter timeline/search/bookmark GraphQL response into
- * `{ tweets, users, nextCursor, previousCursor }`.
- *
- * Works universally across all timeline-shaped endpoints.
- */
 export default function parseTimeline(raw) {
   const instructions = findInstructions(raw?.data || raw);
 
@@ -78,17 +52,10 @@ export default function parseTimeline(raw) {
   let previousCursor = null;
 
   for (const instruction of instructions) {
-    const entries =
-      instruction.entries || // TimelineAddEntries
-        instruction.entry // TimelineReplaceEntry (single)
-        ? [instruction.entry]
-        : null;
-
     if (instruction.type === "TimelineAddEntries" || instruction.entries) {
       for (const entry of instruction.entries || []) {
         processEntry(entry, tweets, users);
 
-        // Extract cursors
         if (entry.entryId?.startsWith("cursor-bottom") || entry.entryId?.includes("cursor-bottom")) {
           nextCursor =
             entry.content?.value || entry.content?.itemContent?.value || null;
@@ -115,21 +82,18 @@ export default function parseTimeline(raw) {
 }
 
 function processEntry(entry, tweets, users) {
-  // Direct tweet entry (tweet-*)
   const tweet = extractTweetFromEntry(entry);
   if (tweet) {
     tweets.push(tweet);
     return;
   }
 
-  // Direct user entry (user-*)
   const user = extractUserFromEntry(entry);
   if (user) {
     users.push(user);
     return;
   }
 
-  // Module entries (conversationthread-*, profile-grid-*, etc.)
   if (entry.content?.items) {
     for (const item of entry.content.items) {
       const t = extractTweetFromEntry(item);