emusks 2.3.4 → 2.3.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "emusks",
-  "version": "2.3.4",
+  "version": "2.3.5",
   "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/helpers/index.js

@@ -12,6 +12,7 @@ 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 report from "./report.js";
 import * as search from "./search.js";
 import * as spaces from "./spaces.js";
 import * as syndication from "./syndication.js";
@@ -52,6 +53,7 @@ export default function initHelpers(proto) {
   namespace(proto, "spaces", spaces);
   namespace(proto, "account", account);
   namespace(proto, "notifications", notifications);
+  namespace(proto, "report", report);
   namespace(proto, "trends", trends);
   namespace(proto, "topics", topics);
   namespace(proto, "media", media);

package/src/helpers/report.js

@@ -0,0 +1,100 @@
+export const REPORT_REASONS = {
+  hate: "HateOrAbuseSimpleOption",
+  abuse: "HateOrAbuseSimpleOption",
+  harassment: "HateOrAbuseSimpleOption",
+  violent_speech: "ViolentSpeechSimpleOption",
+  child_safety: "ChildSafetySimpleOption",
+  private: "PrivateContentSimpleOption",
+  nonconsensual: "PrivateContentSimpleOption",
+  illegal: "IRBSimpleOption",
+  regulated: "IRBSimpleOption",
+  spam: "SpamSimpleOption",
+  self_harm: "SuicideSelfHarmSimpleOption",
+  suicide: "SuicideSelfHarmSimpleOption",
+  adult: "AdultContentSimpleOption",
+  nsfw: "AdultContentSimpleOption",
+  violent_media: "ViolentMediaSimpleOption",
+  graphic: "ViolentMediaSimpleOption",
+  impersonation: "ImpersonationSimpleOption",
+  terrorism: "TerrorismSimpleOption",
+  extremism: "TerrorismSimpleOption",
+};
+
+function resolveReason(reason) {
+  if (typeof reason !== "string" || !reason) throw new Error("a report reason is required");
+  if (reason.endsWith("SimpleOption")) return reason;
+  const mapped = REPORT_REASONS[reason.toLowerCase().replace(/[\s-]+/g, "_")];
+  if (!mapped) {
+    throw new Error(
+      `unknown report reason "${reason}". use a raw *SimpleOption id or one of: ${Object.keys(REPORT_REASONS).join(", ")}`,
+    );
+  }
+  return mapped;
+}
+
+async function submitReport(instance, { variant, startLocation, reason }) {
+  const init = await instance.v1_1("report/flow", {
+    params: { flow_name: "report-flow" },
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify({
+      input_flow_data: {
+        requested_variant: JSON.stringify(variant),
+        flow_context: { start_location: { location: startLocation } },
+      },
+    }),
+  });
+
+  const { flow_token } = await init.json();
+  if (!flow_token) throw new Error("failed to start report flow");
+
+  const res = await instance.v1_1("report/flow", {
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify({
+      flow_token,
+      subtask_inputs: [
+        {
+          subtask_id: "single-selection",
+          choice_selection: { link: "next_link", selected_choices: [reason] },
+        },
+      ],
+    }),
+  });
+
+  return await res.json();
+}
+
+export async function tweet(tweetId, reason, opts = {}) {
+  if (!tweetId) throw new Error("tweetId is required");
+  return await submitReport(this, {
+    startLocation: opts.startLocation || "home",
+    reason: resolveReason(reason),
+    variant: {
+      client_app_id: "3033300",
+      client_location: "home:home:",
+      client_referer: "/home",
+      is_media: false,
+      is_promoted: false,
+      reported_tweet_id: tweetId,
+      source: "reporttweet",
+      ...opts.variant,
+    },
+  });
+}
+
+export async function user(userId, reason, opts = {}) {
+  if (!userId) throw new Error("userId is required");
+  return await submitReport(this, {
+    startLocation: opts.startLocation || "profile",
+    reason: resolveReason(reason),
+    variant: {
+      client_app_id: "3033300",
+      client_location: "profile:header:",
+      client_referer: opts.username ? `/${opts.username}` : "/",
+      is_media: false,
+      is_promoted: false,
+      reported_user_id: userId,
+      source: "reportprofile",
+      ...opts.variant,
+    },
+  });
+}

package/src/helpers/tweets.js

@@ -353,6 +353,10 @@ export async function unmoderate(tweetId) {
   });
 }
 
+export async function report(tweetId, reason, opts = {}) {
+  return await this.report.tweet(tweetId, reason, opts);
+}
+
 export async function pinReply(tweetId) {
   return await this.graphql("PinReply", {
     body: { variables: { tweet_id: tweetId } },

package/src/helpers/users.js

@@ -220,6 +220,10 @@ export async function unmute(userId) {
   return json ? parseUser(json) : res;
 }
 
+export async function report(userId, reason, opts = {}) {
+  return await this.report.user(userId, reason, opts);
+}
+
 export async function removeFollower(userId) {
   return await this.graphql("RemoveFollower", {
     body: { variables: { target_user_id: userId } },

package/src/index.js

@@ -204,3 +204,5 @@ Emusks.prototype.v2 = v2;
 Emusks.prototype.jf = jetfuel;
 Emusks.prototype.grokApi = grokApi;
 initHelpers(Emusks.prototype);
+
+export { REPORT_REASONS } from "./helpers/report.js";