emusks 2.2.1 → 2.3.2

package/README.md

@@ -1,7 +1,7 @@
 <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. Covers tweets, users, DMs, communities, spaces, articles, Grok (X's built-in AI), and XChat (X's end-to-end encrypted chat): send encrypted DMs in one call.
+Log in and interact with the unofficial X API using any client identity - web, Android, iOS, or TweetDeck. Covers tweets, drafts, users, DMs, communities, spaces, articles, Community Notes, the immersive video feed, delegate/act-as, Grok (X's built-in AI), and XChat (X's end-to-end encrypted chat): send encrypted DMs in one call.
 
 officially dmca'd by twitter™ 🏆  •  includes a few leaked ads bearers
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "emusks",
-  "version": "2.2.1",
+  "version": "2.3.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": [
     "client",

package/src/graphql.js

@@ -107,6 +107,7 @@ export default async function graphql(queryName, { variables, fieldToggles, body
     "sec-gpc": "1",
     cookie:
       this.auth.client.headers.cookie + (this.elevatedCookies ? `; ${this.elevatedCookies}` : ""),
+    ...(this.actingAs ? { "x-act-as-user-id": this.actingAs } : {}),
     ...headers,
   };
 

package/src/helpers/account.js

@@ -267,3 +267,8 @@ export async function disableAccountLabel() {
     body: { variables: {} },
   });
 }
+
+export async function supportedLanguages() {
+  const res = await this.graphql("SupportedLanguages", { variables: {} });
+  return res?.data?.supported_languages?.supported_languages ?? res?.data ?? res;
+}

package/src/helpers/delegates.js

@@ -0,0 +1,30 @@
+const CONTRIBUTEES = ["get", "https://api.x.com/1.1/users/contributees.json"];
+const CONTRIBUTORS = ["get", "https://api.x.com/1.1/users/contributors.json"];
+
+export async function contributees(opts = {}) {
+  const params = { ...opts.params };
+  if (opts.userId) params.user_id = opts.userId;
+  if (opts.screenName) params.screen_name = opts.screenName;
+  const res = await this.v1_1(CONTRIBUTEES, { params });
+  return await res.json();
+}
+
+export async function contributors(opts = {}) {
+  const params = { ...opts.params };
+  if (opts.userId) params.user_id = opts.userId;
+  if (opts.screenName) params.screen_name = opts.screenName;
+  const res = await this.v1_1(CONTRIBUTORS, { params });
+  return await res.json();
+}
+
+export function actAs(userId) {
+  return this.setActingAs(userId);
+}
+
+export function stop() {
+  return this.setActingAs(null);
+}
+
+export function current() {
+  return this.actingAs;
+}

package/src/helpers/drafts.js

@@ -0,0 +1,38 @@
+function buildPostTweetRequest(text, opts = {}) {
+  return {
+    status: text ?? "",
+    ...(opts.mediaIds ? { media_ids: opts.mediaIds } : {}),
+    ...(opts.replyTo ? { in_reply_to_status_id: opts.replyTo } : {}),
+    auto_populate_reply_metadata: true,
+    ...opts.postTweetRequest,
+  };
+}
+
+export async function list(opts = {}) {
+  const res = await this.graphql("FetchDraftTweets", {
+    variables: { ascending: opts.ascending ?? false, ...opts.variables },
+  });
+  return res?.data?.viewer?.draft_list?.response_data ?? res;
+}
+
+export async function create(text, opts = {}) {
+  return await this.graphql("CreateDraftTweet", {
+    body: { variables: { post_tweet_request: buildPostTweetRequest(text, opts) } },
+  });
+}
+
+export async function edit(draftId, text, opts = {}) {
+  if (!draftId) throw new Error("edit requires a draftId");
+  return await this.graphql("EditDraftTweet", {
+    body: {
+      variables: { draft_tweet_id: draftId, post_tweet_request: buildPostTweetRequest(text, opts) },
+    },
+  });
+}
+
+export async function remove(draftId) {
+  if (!draftId) throw new Error("remove requires a draftId");
+  return await this.graphql("DeleteDraftTweet", {
+    body: { variables: { draft_tweet_id: draftId } },
+  });
+}

package/src/helpers/immersive.js

@@ -0,0 +1,19 @@
+export async function media(pinnedTweetId, opts = {}) {
+  if (!pinnedTweetId) throw new Error("media requires a pinnedTweetId");
+  const res = await this.graphql("ImmersiveMedia", {
+    variables: {
+      pinned_tweet_id: pinnedTweetId,
+      page_name: opts.pageName ?? "immersive_video",
+      ...opts.variables,
+    },
+  });
+  return res?.data?.immersiveMedia ?? res;
+}
+
+export async function profile(pinnedTweetId, opts = {}) {
+  if (!pinnedTweetId) throw new Error("profile requires a pinnedTweetId");
+  const res = await this.graphql("ImmersiveProfile", {
+    variables: { pinned_tweet_id: pinnedTweetId, ...opts.variables },
+  });
+  return res?.data?.immersiveProfile ?? res;
+}

package/src/helpers/index.js

@@ -2,11 +2,15 @@ import * as account from "./account.js";
 import * as articles from "./articles.js";
 import * as bookmarks from "./bookmarks.js";
 import * as communities from "./communities.js";
+import * as delegates from "./delegates.js";
 import * as dms from "./dms.js";
+import * as drafts from "./drafts.js";
 import * as grok from "./grok.js";
+import * as immersive from "./immersive.js";
 import * as jetfuel from "./jetfuel.js";
 import * as lists from "./lists.js";
 import * as media from "./media.js";
+import * as notes from "./notes.js";
 import * as notifications from "./notifications.js";
 import * as search from "./search.js";
 import * as spaces from "./spaces.js";
@@ -56,4 +60,8 @@ export default function initHelpers(proto) {
   namespace(proto, "jetfuel", jetfuel);
   namespace(proto, "grok", grok);
   namespace(proto, "articles", articles);
+  namespace(proto, "notes", notes);
+  namespace(proto, "delegates", delegates);
+  namespace(proto, "drafts", drafts);
+  namespace(proto, "immersive", immersive);
 }

package/src/helpers/notes.js

@@ -0,0 +1,211 @@
+function data(res) {
+  return res?.data ?? res;
+}
+
+export async function forTweet(tweetId) {
+  if (!tweetId) throw new Error("forTweet requires a tweetId");
+  return data(await this.graphql("BirdwatchFetchNotes", { variables: { tweet_id: tweetId } }));
+}
+
+export async function get(noteId) {
+  if (!noteId) throw new Error("get requires a noteId");
+  const res = await this.graphql("BirdwatchFetchOneNote", { variables: { note_id: noteId } });
+  return res?.data?.birdwatch_note_by_rest_id ?? res;
+}
+
+export async function translation(noteId, opts = {}) {
+  if (!noteId) throw new Error("translation requires a noteId");
+  return data(
+    await this.graphql("BirdwatchFetchNoteTranslation", {
+      variables: { note_id: noteId, ...opts.variables },
+    }),
+  );
+}
+
+export async function myProfile() {
+  const res = await this.graphql("BirdwatchFetchAuthenticatedUserProfile", { variables: {} });
+  return res?.data?.authenticated_user_birdwatch_profile ?? res;
+}
+
+export async function profile(alias) {
+  if (!alias) throw new Error("profile requires an alias");
+  const res = await this.graphql("BirdwatchFetchBirdwatchProfile", { variables: { alias } });
+  return res?.data?.birdwatch_profile_by_alias ?? res;
+}
+
+export async function contributorNotes(alias, opts = {}) {
+  if (!alias) throw new Error("contributorNotes requires an alias");
+  return data(
+    await this.graphql("BirdwatchFetchContributorNotesSlice", {
+      variables: { alias, cursor: opts.cursor, ...opts.variables },
+    }),
+  );
+}
+
+export async function globalTimeline(opts = {}) {
+  return data(
+    await this.graphql("BirdwatchFetchGlobalTimeline", {
+      variables: { cursor: opts.cursor, ...opts.variables },
+    }),
+  );
+}
+
+export async function batSignal(tweetId) {
+  if (!tweetId) throw new Error("batSignal requires a tweetId");
+  return data(await this.graphql("BirdwatchFetchBatSignal", { variables: { tweet_id: tweetId } }));
+}
+
+export async function canBeMediaNote(tweetId) {
+  if (!tweetId) throw new Error("canBeMediaNote requires a tweetId");
+  return data(
+    await this.graphql("BirdwatchFetchCanTweetBeMediaNote", { variables: { tweetId } }),
+  );
+}
+
+export async function clusterData(tweetId) {
+  if (!tweetId) throw new Error("clusterData requires a tweetId");
+  return data(await this.graphql("BirdwatchFetchClusterData", { variables: { tweetId } }));
+}
+
+export async function mediaMatches(tweetId, opts = {}) {
+  if (!tweetId) throw new Error("mediaMatches requires a tweetId");
+  return data(
+    await this.graphql("BirdwatchFetchMediaMatchSlice", {
+      variables: { tweet_id: tweetId, cursor: opts.cursor, ...opts.variables },
+    }),
+  );
+}
+
+export async function prominentMediaMatches(tweetId, opts = {}) {
+  if (!tweetId) throw new Error("prominentMediaMatches requires a tweetId");
+  return data(
+    await this.graphql("BirdwatchFetchProminentMediaMatchSlice", {
+      variables: { tweet_id: tweetId, cursor: opts.cursor, ...opts.variables },
+    }),
+  );
+}
+
+export async function sourceLinks(tweetId, opts = {}) {
+  if (!tweetId) throw new Error("sourceLinks requires a tweetId");
+  return data(
+    await this.graphql("BirdwatchFetchSourceLinkSlice", {
+      variables: { tweet_id: tweetId, cursor: opts.cursor, ...opts.variables },
+    }),
+  );
+}
+
+export async function sourceLinkTweet(tweetId) {
+  if (!tweetId) throw new Error("sourceLinkTweet requires a tweetId");
+  return data(await this.graphql("BirdwatchFetchSourceLinkTweet", { variables: { tweetId } }));
+}
+
+export async function authenticatedMatch(noteId) {
+  if (!noteId) throw new Error("authenticatedMatch requires a noteId");
+  return data(
+    await this.graphql("BirdwatchFetchAuthenticatedBirdwatchMatchSlice", {
+      variables: { note_id: noteId },
+    }),
+  );
+}
+
+export async function aliasOptions() {
+  return data(await this.graphql("BirdwatchFetchAliasSelfSelectOptions", { variables: {} }));
+}
+
+export async function aliasStatus() {
+  const res = await this.graphql("BirdwatchFetchAliasSelfSelectStatus", { variables: {} });
+  return res?.data?.authenticated_user_birdwatch_alias_self_select_status ?? res;
+}
+
+export async function publicData() {
+  const res = await this.graphql("BirdwatchFetchPublicData", { variables: {} });
+  return res?.data?.birdwatch_latest_public_data_file_bundle ?? res;
+}
+
+export async function signUpEligibility() {
+  const res = await this.graphql("BirdwatchFetchSignUpEligiblity", { variables: {} });
+  return res?.data?.birdwatch_sign_up_eligibility ?? res;
+}
+
+export async function suggestionFeedback(suggestionId) {
+  if (!suggestionId) throw new Error("suggestionFeedback requires a suggestionId");
+  return data(
+    await this.graphql("BirdwatchFetchSuggestionFeedbackOverview", {
+      variables: { suggestionId },
+    }),
+  );
+}
+
+export async function create(tweetId, dataV1, opts = {}) {
+  if (!tweetId) throw new Error("create requires a tweetId");
+  if (!dataV1) throw new Error("create requires a data_v1 note payload");
+  return await this.graphql("BirdwatchCreateNote", {
+    body: { variables: { tweet_id: tweetId, data_v1: dataV1, ...opts.variables } },
+  });
+}
+
+export async function remove(noteId) {
+  if (!noteId) throw new Error("remove requires a noteId");
+  return await this.graphql("BirdwatchDeleteNote", { body: { variables: { note_id: noteId } } });
+}
+
+export async function rate(noteId, rating = {}) {
+  if (!noteId) throw new Error("rate requires a noteId");
+  return await this.graphql("BirdwatchCreateRating", {
+    body: { variables: { note_id: noteId, ...rating } },
+  });
+}
+
+export async function deleteRating(noteId) {
+  if (!noteId) throw new Error("deleteRating requires a noteId");
+  return await this.graphql("BirdwatchDeleteRating", {
+    body: { variables: { note_id: noteId } },
+  });
+}
+
+export async function appeal(noteId, opts = {}) {
+  if (!noteId) throw new Error("appeal requires a noteId");
+  return await this.graphql("BirdwatchCreateAppeal", {
+    body: { variables: { note_id: noteId, ...opts.variables } },
+  });
+}
+
+export async function request(tweetId) {
+  if (!tweetId) throw new Error("request requires a tweetId");
+  return await this.graphql("BirdwatchCreateBatSignal", {
+    body: { variables: { tweet_id: tweetId } },
+  });
+}
+
+export async function deleteRequest(tweetId) {
+  if (!tweetId) throw new Error("deleteRequest requires a tweetId");
+  return await this.graphql("BirdwatchDeleteBatSignal", {
+    body: { variables: { tweet_id: tweetId } },
+  });
+}
+
+export async function selectAlias(opts = {}) {
+  return await this.graphql("BirdwatchAliasSelect", { body: { variables: { ...opts.variables } } });
+}
+
+export async function editNotificationSettings(params = {}) {
+  return await this.graphql("BirdwatchEditNotificationSettings", {
+    body: { variables: { ...params } },
+  });
+}
+
+export async function editUserSettings(params = {}) {
+  return await this.graphql("BirdwatchEditUserSettings", { body: { variables: { ...params } } });
+}
+
+export async function acknowledgeEarnOut() {
+  return await this.graphql("BirdwatchProfileAcknowledgeEarnOut", { body: { variables: {} } });
+}
+
+export async function admitUser(opts = {}) {
+  return await this.graphql("BirdwatchAdmitUser", { body: { variables: { ...opts.variables } } });
+}
+
+export async function removeUser(opts = {}) {
+  return await this.graphql("BirdwatchRemoveUser", { body: { variables: { ...opts.variables } } });
+}

package/src/helpers/timelines.js

@@ -80,3 +80,9 @@ export async function creatorSubscriptions(opts = {}) {
   });
   return parseTimeline(raw);
 }
+
+export async function updatePinned(pinnedTimelineItems) {
+  return await this.graphql("UpdatePinnedTimelines", {
+    body: { variables: { pinnedTimelineItems } },
+  });
+}

package/src/helpers/tweets.js

@@ -409,3 +409,23 @@ export async function similar(tweetId) {
     variables: { tweet_id: tweetId },
   });
 }
+
+export async function downvote(tweetId) {
+  return await this.graphql("DownvoteTweet", { body: { variables: { tweet_id: tweetId } } });
+}
+
+export async function undoDownvote(tweetId) {
+  return await this.graphql("UndoDownvoteTweet", { body: { variables: { tweet_id: tweetId } } });
+}
+
+export async function addContentDisclosure(tweetId, opts = {}) {
+  return await this.graphql("AddContentDisclosure", {
+    body: { variables: { tweet_id: tweetId, ...opts.variables } },
+  });
+}
+
+export async function removeContentDisclosure(tweetId, opts = {}) {
+  return await this.graphql("DeleteContentDisclosure", {
+    body: { variables: { tweet_id: tweetId, ...opts.variables } },
+  });
+}

package/src/index.js

@@ -15,6 +15,12 @@ export default class Emusks {
   elevatedCookies = null;
   graphqlEndpoint = "web";
   transactionIds = undefined;
+  actingAs = null;
+
+  setActingAs(userId) {
+    this.actingAs = userId || null;
+    return this;
+  }
 
   async elevate(password) {
     if (!this.auth) throw new Error("must be logged in before calling elevate");

package/src/v1.1.js

@@ -2,7 +2,7 @@ import getCycleTLS from "./cycletls.js";
 import v1_1Api from "./static/v1.1.js";
 
 export default async function v1_1(queryName, { params, body, headers } = {}) {
-  let entry = v1_1Api[queryName];
+  const entry = Array.isArray(queryName) ? queryName : v1_1Api[queryName];
   if (!entry) {
     throw new Error(`v1.1 endpoint ${queryName} not found`);
   }
@@ -62,6 +62,7 @@ export default async function v1_1(queryName, { params, body, headers } = {}) {
     "sec-gpc": "1",
     cookie:
       this.auth.client.headers.cookie + (this.elevatedCookies ? `; ${this.elevatedCookies}` : ""),
+    ...(this.actingAs ? { "x-act-as-user-id": this.actingAs } : {}),
     ...headers,
   };
 
@@ -95,7 +96,9 @@ export default async function v1_1(queryName, { params, body, headers } = {}) {
     const messages = bodyJson.errors
       .map((e) => e.message || (e.code != null ? `code ${e.code}` : "unknown"))
       .join("; ");
-    throw new Error(`twitter v1.1 ${queryName} ${res.status}: ${messages}`);
+    throw new Error(
+      `twitter v1.1 ${Array.isArray(queryName) ? entry[1] : queryName} ${res.status}: ${messages}`,
+    );
   }
   return {
     status: res.status,

package/src/v2.js

@@ -43,6 +43,7 @@ export default async function v2(queryName, { params, body, headers } = {}) {
     "sec-gpc": "1",
     cookie:
       this.auth.client.headers.cookie + (this.elevatedCookies ? `; ${this.elevatedCookies}` : ""),
+    ...(this.actingAs ? { "x-act-as-user-id": this.actingAs } : {}),
     ...headers,
   };