@the-convocation/twitter-scraper 0.15.1 → 0.16.1

package/dist/default/cjs/index.js

@@ -29,22 +29,43 @@ function _interopNamespaceDefault(e) {
 var OTPAuth__namespace = /*#__PURE__*/_interopNamespaceDefault(OTPAuth);
 
 class ApiError extends Error {
-  constructor(response, data, message) {
-    super(message);
+  constructor(response, data) {
+    super(
+      `Response status: ${response.status} | headers: ${JSON.stringify(
+        headersToString(response.headers)
+      )} | data: ${data}`
+    );
     this.response = response;
     this.data = data;
   }
   static async fromResponse(response) {
     let data = void 0;
     try {
-      data = await response.json();
+      if (response.headers.get("content-type")?.includes("application/json")) {
+        data = await response.json();
+      } else {
+        data = await response.text();
+      }
     } catch {
       try {
         data = await response.text();
       } catch {
       }
     }
-    return new ApiError(response, data, `Response status: ${response.status}`);
+    return new ApiError(response, data);
+  }
+}
+function headersToString(headers) {
+  const result = [];
+  headers.forEach((value, key) => {
+    result.push(`${key}: ${value}`);
+  });
+  return result.join("\n");
+}
+class AuthenticationError extends Error {
+  constructor(message) {
+    super(message || "Authentication failed");
+    this.name = "AuthenticationError";
   }
 }
 
@@ -103,6 +124,10 @@ async function updateCookieJar(cookieJar, headers) {
 }
 
 const bearerToken = "AAAAAAAAAAAAAAAAAAAAAFQODgEAAAAAVHTp76lzh3rFzcHbmHVvQxYYpTw%3DckAlMINMjmCwxUcaXbAN4XqJVdgMJaHqNOFgPMK0zN1qLqLQCF";
+async function jitter(maxMs) {
+  const jitter2 = Math.random() * maxMs;
+  await new Promise((resolve) => setTimeout(resolve, jitter2));
+}
 async function requestApi(url, auth, method = "GET", platform = new Platform()) {
   const headers = new headersPolyfill.Headers();
   await auth.installTo(headers, url);
@@ -275,7 +300,9 @@ class TwitterGuestAuth {
     }
     const token = this.guestToken;
     if (token == null) {
-      throw new Error("Authentication token is null or undefined.");
+      throw new AuthenticationError(
+        "Authentication token is null or undefined."
+      );
     }
     headers.set("authorization", `Bearer ${this.bearerToken}`);
     headers.set("x-guest-token", token);
@@ -322,15 +349,15 @@ class TwitterGuestAuth {
     });
     await updateCookieJar(this.jar, res.headers);
     if (!res.ok) {
-      throw new Error(await res.text());
+      throw new AuthenticationError(await res.text());
     }
     const o = await res.json();
     if (o == null || o["guest_token"] == null) {
-      throw new Error("guest_token not found.");
+      throw new AuthenticationError("guest_token not found.");
     }
     const newGuestToken = o["guest_token"];
     if (typeof newGuestToken !== "string") {
-      throw new Error("guest_token was not a string.");
+      throw new AuthenticationError("guest_token was not a string.");
     }
     this.guestToken = newGuestToken;
     this.guestCreatedAt = /* @__PURE__ */ new Date();
@@ -351,6 +378,47 @@ const TwitterUserAuthSubtask = typebox.Type.Object({
 class TwitterUserAuth extends TwitterGuestAuth {
   constructor(bearerToken, options) {
     super(bearerToken, options);
+    this.subtaskHandlers = /* @__PURE__ */ new Map();
+    this.initializeDefaultHandlers();
+  }
+  /**
+   * Register a custom subtask handler or override an existing one
+   * @param subtaskId The ID of the subtask to handle
+   * @param handler The handler function that processes the subtask
+   */
+  registerSubtaskHandler(subtaskId, handler) {
+    this.subtaskHandlers.set(subtaskId, handler);
+  }
+  initializeDefaultHandlers() {
+    this.subtaskHandlers.set(
+      "LoginJsInstrumentationSubtask",
+      this.handleJsInstrumentationSubtask.bind(this)
+    );
+    this.subtaskHandlers.set(
+      "LoginEnterUserIdentifierSSO",
+      this.handleEnterUserIdentifierSSO.bind(this)
+    );
+    this.subtaskHandlers.set(
+      "LoginEnterAlternateIdentifierSubtask",
+      this.handleEnterAlternateIdentifierSubtask.bind(this)
+    );
+    this.subtaskHandlers.set(
+      "LoginEnterPassword",
+      this.handleEnterPassword.bind(this)
+    );
+    this.subtaskHandlers.set(
+      "AccountDuplicationCheck",
+      this.handleAccountDuplicationCheck.bind(this)
+    );
+    this.subtaskHandlers.set(
+      "LoginTwoFactorAuthChallenge",
+      this.handleTwoFactorAuthChallenge.bind(this)
+    );
+    this.subtaskHandlers.set("LoginAcid", this.handleAcid.bind(this));
+    this.subtaskHandlers.set(
+      "LoginSuccessSubtask",
+      this.handleSuccessSubtask.bind(this)
+    );
   }
   async isLoggedIn() {
     const res = await requestApi(
@@ -365,52 +433,49 @@ class TwitterUserAuth extends TwitterGuestAuth {
   }
   async login(username, password, email, twoFactorSecret) {
     await this.updateGuestToken();
+    const credentials = {
+      username,
+      password,
+      email,
+      twoFactorSecret
+    };
     let next = await this.initLogin();
-    while ("subtask" in next && next.subtask) {
-      if (next.subtask.subtask_id === "LoginJsInstrumentationSubtask") {
-        next = await this.handleJsInstrumentationSubtask(next);
-      } else if (next.subtask.subtask_id === "LoginEnterUserIdentifierSSO") {
-        next = await this.handleEnterUserIdentifierSSO(next, username);
-      } else if (next.subtask.subtask_id === "LoginEnterAlternateIdentifierSubtask") {
-        next = await this.handleEnterAlternateIdentifierSubtask(
-          next,
-          email
-        );
-      } else if (next.subtask.subtask_id === "LoginEnterPassword") {
-        next = await this.handleEnterPassword(next, password);
-      } else if (next.subtask.subtask_id === "AccountDuplicationCheck") {
-        next = await this.handleAccountDuplicationCheck(next);
-      } else if (next.subtask.subtask_id === "LoginTwoFactorAuthChallenge") {
-        if (twoFactorSecret) {
-          next = await this.handleTwoFactorAuthChallenge(next, twoFactorSecret);
-        } else {
-          throw new Error(
-            "Requested two factor authentication code but no secret provided"
-          );
-        }
-      } else if (next.subtask.subtask_id === "LoginAcid") {
-        next = await this.handleAcid(next, email);
-      } else if (next.subtask.subtask_id === "LoginSuccessSubtask") {
-        next = await this.handleSuccessSubtask(next);
+    while (next.status === "success" && next.response.subtasks?.length) {
+      const flowToken = next.response.flow_token;
+      if (flowToken == null) {
+        throw new Error("flow_token not found.");
+      }
+      const subtaskId = next.response.subtasks[0].subtask_id;
+      const handler = this.subtaskHandlers.get(subtaskId);
+      if (handler) {
+        next = await handler(subtaskId, next.response, credentials, {
+          sendFlowRequest: this.executeFlowTask.bind(this),
+          getFlowToken: () => flowToken
+        });
       } else {
-        throw new Error(`Unknown subtask ${next.subtask.subtask_id}`);
+        throw new Error(`Unknown subtask ${subtaskId}`);
       }
     }
-    if ("err" in next) {
+    if (next.status === "error") {
       throw next.err;
     }
   }
   async logout() {
-    if (!this.isLoggedIn()) {
+    if (!this.hasToken()) {
       return;
     }
-    await requestApi(
-      "https://api.twitter.com/1.1/account/logout.json",
-      this,
-      "POST"
-    );
-    this.deleteToken();
-    this.jar = new toughCookie.CookieJar();
+    try {
+      await requestApi(
+        "https://api.twitter.com/1.1/account/logout.json",
+        this,
+        "POST"
+      );
+    } catch (error) {
+      console.warn("Error during logout:", error);
+    } finally {
+      this.deleteToken();
+      this.jar = new toughCookie.CookieJar();
+    }
   }
   async installCsrfToken(headers) {
     const cookies = await this.getCookies();
@@ -449,12 +514,12 @@ class TwitterUserAuth extends TwitterGuestAuth {
       }
     });
   }
-  async handleJsInstrumentationSubtask(prev) {
-    return await this.executeFlowTask({
-      flow_token: prev.flowToken,
+  async handleJsInstrumentationSubtask(subtaskId, _prev, _credentials, api) {
+    return await api.sendFlowRequest({
+      flow_token: api.getFlowToken(),
       subtask_inputs: [
         {
-          subtask_id: "LoginJsInstrumentationSubtask",
+          subtask_id: subtaskId,
           js_instrumentation: {
             response: "{}",
             link: "next_link"
@@ -463,32 +528,32 @@ class TwitterUserAuth extends TwitterGuestAuth {
       ]
     });
   }
-  async handleEnterAlternateIdentifierSubtask(prev, email) {
+  async handleEnterAlternateIdentifierSubtask(subtaskId, _prev, credentials, api) {
     return await this.executeFlowTask({
-      flow_token: prev.flowToken,
+      flow_token: api.getFlowToken(),
       subtask_inputs: [
         {
-          subtask_id: "LoginEnterAlternateIdentifierSubtask",
+          subtask_id: subtaskId,
           enter_text: {
-            text: email,
+            text: credentials.email,
             link: "next_link"
           }
         }
       ]
     });
   }
-  async handleEnterUserIdentifierSSO(prev, username) {
+  async handleEnterUserIdentifierSSO(subtaskId, _prev, credentials, api) {
     return await this.executeFlowTask({
-      flow_token: prev.flowToken,
+      flow_token: api.getFlowToken(),
       subtask_inputs: [
         {
-          subtask_id: "LoginEnterUserIdentifierSSO",
+          subtask_id: subtaskId,
           settings_list: {
             setting_responses: [
               {
                 key: "user_identifier",
                 response_data: {
-                  text_data: { result: username }
+                  text_data: { result: credentials.username }
                 }
               }
             ],
@@ -498,26 +563,26 @@ class TwitterUserAuth extends TwitterGuestAuth {
       ]
     });
   }
-  async handleEnterPassword(prev, password) {
+  async handleEnterPassword(subtaskId, _prev, credentials, api) {
     return await this.executeFlowTask({
-      flow_token: prev.flowToken,
+      flow_token: api.getFlowToken(),
       subtask_inputs: [
         {
-          subtask_id: "LoginEnterPassword",
+          subtask_id: subtaskId,
           enter_password: {
-            password,
+            password: credentials.password,
             link: "next_link"
           }
         }
       ]
     });
   }
-  async handleAccountDuplicationCheck(prev) {
+  async handleAccountDuplicationCheck(subtaskId, _prev, _credentials, api) {
     return await this.executeFlowTask({
-      flow_token: prev.flowToken,
+      flow_token: api.getFlowToken(),
       subtask_inputs: [
         {
-          subtask_id: "AccountDuplicationCheck",
+          subtask_id: subtaskId,
           check_logged_in_account: {
             link: "AccountDuplicationCheck_false"
           }
@@ -525,16 +590,24 @@ class TwitterUserAuth extends TwitterGuestAuth {
       ]
     });
   }
-  async handleTwoFactorAuthChallenge(prev, secret) {
-    const totp = new OTPAuth__namespace.TOTP({ secret });
+  async handleTwoFactorAuthChallenge(subtaskId, _prev, credentials, api) {
+    if (!credentials.twoFactorSecret) {
+      return {
+        status: "error",
+        err: new AuthenticationError(
+          "Two-factor authentication is required but no secret was provided"
+        )
+      };
+    }
+    const totp = new OTPAuth__namespace.TOTP({ secret: credentials.twoFactorSecret });
     let error;
     for (let attempts = 1; attempts < 4; attempts += 1) {
       try {
-        return await this.executeFlowTask({
-          flow_token: prev.flowToken,
+        return await api.sendFlowRequest({
+          flow_token: api.getFlowToken(),
           subtask_inputs: [
             {
-              subtask_id: "LoginTwoFactorAuthChallenge",
+              subtask_id: subtaskId,
               enter_text: {
                 link: "next_link",
                 text: totp.generate()
@@ -549,23 +622,23 @@ class TwitterUserAuth extends TwitterGuestAuth {
     }
     throw error;
   }
-  async handleAcid(prev, email) {
+  async handleAcid(subtaskId, _prev, credentials, api) {
     return await this.executeFlowTask({
-      flow_token: prev.flowToken,
+      flow_token: api.getFlowToken(),
       subtask_inputs: [
         {
-          subtask_id: "LoginAcid",
+          subtask_id: subtaskId,
           enter_text: {
-            text: email,
+            text: credentials.email,
             link: "next_link"
           }
         }
       ]
     });
   }
-  async handleSuccessSubtask(prev) {
+  async handleSuccessSubtask(_subtaskId, _prev, _credentials, api) {
     return await this.executeFlowTask({
-      flow_token: prev.flowToken,
+      flow_token: api.getFlowToken(),
       subtask_inputs: []
     });
   }
@@ -573,7 +646,9 @@ class TwitterUserAuth extends TwitterGuestAuth {
     const onboardingTaskUrl = "https://api.twitter.com/1.1/onboarding/task.json";
     const token = this.guestToken;
     if (token == null) {
-      throw new Error("Authentication token is null or undefined.");
+      throw new AuthenticationError(
+        "Authentication token is null or undefined."
+      );
     }
     const headers = new headersPolyfill.Headers({
       authorization: `Bearer ${this.bearerToken}`,
@@ -594,16 +669,19 @@ class TwitterUserAuth extends TwitterGuestAuth {
     });
     await updateCookieJar(this.jar, res.headers);
     if (!res.ok) {
-      return { status: "error", err: new Error(await res.text()) };
+      return { status: "error", err: await ApiError.fromResponse(res) };
     }
     const flow = await res.json();
     if (flow?.flow_token == null) {
-      return { status: "error", err: new Error("flow_token not found.") };
+      return {
+        status: "error",
+        err: new AuthenticationError("flow_token not found.")
+      };
     }
     if (flow.errors?.length) {
       return {
         status: "error",
-        err: new Error(
+        err: new AuthenticationError(
           `Authentication error (${flow.errors[0].code}): ${flow.errors[0].message}`
         )
       };
@@ -611,7 +689,7 @@ class TwitterUserAuth extends TwitterGuestAuth {
     if (typeof flow.flow_token !== "string") {
       return {
         status: "error",
-        err: new Error("flow_token was not a string.")
+        err: new AuthenticationError("flow_token was not a string.")
       };
     }
     const subtask = flow.subtasks?.length ? flow.subtasks[0] : void 0;
@@ -619,17 +697,73 @@ class TwitterUserAuth extends TwitterGuestAuth {
     if (subtask && subtask.subtask_id === "DenyLoginSubtask") {
       return {
         status: "error",
-        err: new Error("Authentication error: DenyLoginSubtask")
+        err: new AuthenticationError("Authentication error: DenyLoginSubtask")
       };
     }
     return {
       status: "success",
-      subtask,
-      flowToken: flow.flow_token
+      response: flow
     };
   }
 }
 
+const endpoints = {
+  // TODO: Migrate other endpoint URLs here
+  UserTweets: "https://x.com/i/api/graphql/Li2XXGESVev94TzFtntrgA/UserTweets?variables=%7B%22userId%22%3A%221806359170830172162%22%2C%22count%22%3A20%2C%22includePromotedContent%22%3Atrue%2C%22withQuickPromoteEligibilityTweetFields%22%3Atrue%2C%22withVoice%22%3Atrue%7D&features=%7B%22rweb_video_screen_enabled%22%3Afalse%2C%22profile_label_improvements_pcf_label_in_post_enabled%22%3Atrue%2C%22rweb_tipjar_consumption_enabled%22%3Atrue%2C%22verified_phone_label_enabled%22%3Afalse%2C%22creator_subscriptions_tweet_preview_api_enabled%22%3Atrue%2C%22responsive_web_graphql_timeline_navigation_enabled%22%3Atrue%2C%22responsive_web_graphql_skip_user_profile_image_extensions_enabled%22%3Afalse%2C%22premium_content_api_read_enabled%22%3Afalse%2C%22communities_web_enable_tweet_community_results_fetch%22%3Atrue%2C%22c9s_tweet_anatomy_moderator_badge_enabled%22%3Atrue%2C%22responsive_web_grok_analyze_button_fetch_trends_enabled%22%3Afalse%2C%22responsive_web_grok_analyze_post_followups_enabled%22%3Atrue%2C%22responsive_web_jetfuel_frame%22%3Afalse%2C%22responsive_web_grok_share_attachment_enabled%22%3Atrue%2C%22articles_preview_enabled%22%3Atrue%2C%22responsive_web_edit_tweet_api_enabled%22%3Atrue%2C%22graphql_is_translatable_rweb_tweet_is_translatable_enabled%22%3Atrue%2C%22view_counts_everywhere_api_enabled%22%3Atrue%2C%22longform_notetweets_consumption_enabled%22%3Atrue%2C%22responsive_web_twitter_article_tweet_consumption_enabled%22%3Atrue%2C%22tweet_awards_web_tipping_enabled%22%3Afalse%2C%22responsive_web_grok_show_grok_translated_post%22%3Afalse%2C%22responsive_web_grok_analysis_button_from_backend%22%3Atrue%2C%22creator_subscriptions_quote_tweet_preview_enabled%22%3Afalse%2C%22freedom_of_speech_not_reach_fetch_enabled%22%3Atrue%2C%22standardized_nudges_misinfo%22%3Atrue%2C%22tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled%22%3Atrue%2C%22longform_notetweets_rich_text_read_enabled%22%3Atrue%2C%22longform_notetweets_inline_media_enabled%22%3Atrue%2C%22responsive_web_grok_image_annotation_enabled%22%3Atrue%2C%22responsive_web_enhance_cards_enabled%22%3Afalse%7D&fieldToggles=%7B%22withArticlePlainText%22%3Afalse%7D",
+  UserTweetsAndReplies: "https://x.com/i/api/graphql/Hk4KlJ-ONjlJsucqR55P7g/UserTweetsAndReplies?variables=%7B%22userId%22%3A%221806359170830172162%22%2C%22count%22%3A20%2C%22includePromotedContent%22%3Atrue%2C%22withCommunity%22%3Atrue%2C%22withVoice%22%3Atrue%7D&features=%7B%22rweb_video_screen_enabled%22%3Afalse%2C%22profile_label_improvements_pcf_label_in_post_enabled%22%3Atrue%2C%22rweb_tipjar_consumption_enabled%22%3Atrue%2C%22verified_phone_label_enabled%22%3Afalse%2C%22creator_subscriptions_tweet_preview_api_enabled%22%3Atrue%2C%22responsive_web_graphql_timeline_navigation_enabled%22%3Atrue%2C%22responsive_web_graphql_skip_user_profile_image_extensions_enabled%22%3Afalse%2C%22premium_content_api_read_enabled%22%3Afalse%2C%22communities_web_enable_tweet_community_results_fetch%22%3Atrue%2C%22c9s_tweet_anatomy_moderator_badge_enabled%22%3Atrue%2C%22responsive_web_grok_analyze_button_fetch_trends_enabled%22%3Afalse%2C%22responsive_web_grok_analyze_post_followups_enabled%22%3Atrue%2C%22responsive_web_jetfuel_frame%22%3Afalse%2C%22responsive_web_grok_share_attachment_enabled%22%3Atrue%2C%22articles_preview_enabled%22%3Atrue%2C%22responsive_web_edit_tweet_api_enabled%22%3Atrue%2C%22graphql_is_translatable_rweb_tweet_is_translatable_enabled%22%3Atrue%2C%22view_counts_everywhere_api_enabled%22%3Atrue%2C%22longform_notetweets_consumption_enabled%22%3Atrue%2C%22responsive_web_twitter_article_tweet_consumption_enabled%22%3Atrue%2C%22tweet_awards_web_tipping_enabled%22%3Afalse%2C%22responsive_web_grok_show_grok_translated_post%22%3Afalse%2C%22responsive_web_grok_analysis_button_from_backend%22%3Atrue%2C%22creator_subscriptions_quote_tweet_preview_enabled%22%3Afalse%2C%22freedom_of_speech_not_reach_fetch_enabled%22%3Atrue%2C%22standardized_nudges_misinfo%22%3Atrue%2C%22tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled%22%3Atrue%2C%22longform_notetweets_rich_text_read_enabled%22%3Atrue%2C%22longform_notetweets_inline_media_enabled%22%3Atrue%2C%22responsive_web_grok_image_annotation_enabled%22%3Atrue%2C%22responsive_web_enhance_cards_enabled%22%3Afalse%7D&fieldToggles=%7B%22withArticlePlainText%22%3Afalse%7D",
+  UserLikedTweets: "https://x.com/i/api/graphql/XHTMjDbiTGLQ9cP1em-aqQ/Likes?variables=%7B%22userId%22%3A%222244196397%22%2C%22count%22%3A20%2C%22includePromotedContent%22%3Afalse%2C%22withClientEventToken%22%3Afalse%2C%22withBirdwatchNotes%22%3Afalse%2C%22withVoice%22%3Atrue%7D&features=%7B%22rweb_video_screen_enabled%22%3Afalse%2C%22profile_label_improvements_pcf_label_in_post_enabled%22%3Atrue%2C%22rweb_tipjar_consumption_enabled%22%3Atrue%2C%22verified_phone_label_enabled%22%3Afalse%2C%22creator_subscriptions_tweet_preview_api_enabled%22%3Atrue%2C%22responsive_web_graphql_timeline_navigation_enabled%22%3Atrue%2C%22responsive_web_graphql_skip_user_profile_image_extensions_enabled%22%3Afalse%2C%22premium_content_api_read_enabled%22%3Afalse%2C%22communities_web_enable_tweet_community_results_fetch%22%3Atrue%2C%22c9s_tweet_anatomy_moderator_badge_enabled%22%3Atrue%2C%22responsive_web_grok_analyze_button_fetch_trends_enabled%22%3Afalse%2C%22responsive_web_grok_analyze_post_followups_enabled%22%3Atrue%2C%22responsive_web_jetfuel_frame%22%3Afalse%2C%22responsive_web_grok_share_attachment_enabled%22%3Atrue%2C%22articles_preview_enabled%22%3Atrue%2C%22responsive_web_edit_tweet_api_enabled%22%3Atrue%2C%22graphql_is_translatable_rweb_tweet_is_translatable_enabled%22%3Atrue%2C%22view_counts_everywhere_api_enabled%22%3Atrue%2C%22longform_notetweets_consumption_enabled%22%3Atrue%2C%22responsive_web_twitter_article_tweet_consumption_enabled%22%3Atrue%2C%22tweet_awards_web_tipping_enabled%22%3Afalse%2C%22responsive_web_grok_show_grok_translated_post%22%3Afalse%2C%22responsive_web_grok_analysis_button_from_backend%22%3Atrue%2C%22creator_subscriptions_quote_tweet_preview_enabled%22%3Afalse%2C%22freedom_of_speech_not_reach_fetch_enabled%22%3Atrue%2C%22standardized_nudges_misinfo%22%3Atrue%2C%22tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled%22%3Atrue%2C%22longform_notetweets_rich_text_read_enabled%22%3Atrue%2C%22longform_notetweets_inline_media_enabled%22%3Atrue%2C%22responsive_web_grok_image_annotation_enabled%22%3Atrue%2C%22responsive_web_enhance_cards_enabled%22%3Afalse%7D&fieldToggles=%7B%22withArticlePlainText%22%3Afalse%7D",
+  UserByScreenName: "https://x.com/i/api/graphql/xWw45l6nX7DP2FKRyePXSw/UserByScreenName?variables=%7B%22screen_name%22%3A%22geminiapp%22%7D&features=%7B%22hidden_profile_subscriptions_enabled%22%3Atrue%2C%22profile_label_improvements_pcf_label_in_post_enabled%22%3Atrue%2C%22rweb_tipjar_consumption_enabled%22%3Atrue%2C%22verified_phone_label_enabled%22%3Afalse%2C%22subscriptions_verification_info_is_identity_verified_enabled%22%3Atrue%2C%22subscriptions_verification_info_verified_since_enabled%22%3Atrue%2C%22highlights_tweets_tab_ui_enabled%22%3Atrue%2C%22responsive_web_twitter_article_notes_tab_enabled%22%3Atrue%2C%22subscriptions_feature_can_gift_premium%22%3Atrue%2C%22creator_subscriptions_tweet_preview_api_enabled%22%3Atrue%2C%22responsive_web_graphql_skip_user_profile_image_extensions_enabled%22%3Afalse%2C%22responsive_web_graphql_timeline_navigation_enabled%22%3Atrue%7D&fieldToggles=%7B%22withAuxiliaryUserLabels%22%3Atrue%7D",
+  TweetDetail: "https://x.com/i/api/graphql/u5Tij6ERlSH2LZvCUqallw/TweetDetail?variables=%7B%22focalTweetId%22%3A%221924893675529900467%22%2C%22referrer%22%3A%22profile%22%2C%22with_rux_injections%22%3Afalse%2C%22rankingMode%22%3A%22Relevance%22%2C%22includePromotedContent%22%3Atrue%2C%22withCommunity%22%3Atrue%2C%22withQuickPromoteEligibilityTweetFields%22%3Atrue%2C%22withBirdwatchNotes%22%3Atrue%2C%22withVoice%22%3Atrue%7D&features=%7B%22rweb_video_screen_enabled%22%3Afalse%2C%22profile_label_improvements_pcf_label_in_post_enabled%22%3Atrue%2C%22rweb_tipjar_consumption_enabled%22%3Atrue%2C%22verified_phone_label_enabled%22%3Afalse%2C%22creator_subscriptions_tweet_preview_api_enabled%22%3Atrue%2C%22responsive_web_graphql_timeline_navigation_enabled%22%3Atrue%2C%22responsive_web_graphql_skip_user_profile_image_extensions_enabled%22%3Afalse%2C%22premium_content_api_read_enabled%22%3Afalse%2C%22communities_web_enable_tweet_community_results_fetch%22%3Atrue%2C%22c9s_tweet_anatomy_moderator_badge_enabled%22%3Atrue%2C%22responsive_web_grok_analyze_button_fetch_trends_enabled%22%3Afalse%2C%22responsive_web_grok_analyze_post_followups_enabled%22%3Atrue%2C%22responsive_web_jetfuel_frame%22%3Afalse%2C%22responsive_web_grok_share_attachment_enabled%22%3Atrue%2C%22articles_preview_enabled%22%3Atrue%2C%22responsive_web_edit_tweet_api_enabled%22%3Atrue%2C%22graphql_is_translatable_rweb_tweet_is_translatable_enabled%22%3Atrue%2C%22view_counts_everywhere_api_enabled%22%3Atrue%2C%22longform_notetweets_consumption_enabled%22%3Atrue%2C%22responsive_web_twitter_article_tweet_consumption_enabled%22%3Atrue%2C%22tweet_awards_web_tipping_enabled%22%3Afalse%2C%22responsive_web_grok_show_grok_translated_post%22%3Afalse%2C%22responsive_web_grok_analysis_button_from_backend%22%3Atrue%2C%22creator_subscriptions_quote_tweet_preview_enabled%22%3Afalse%2C%22freedom_of_speech_not_reach_fetch_enabled%22%3Atrue%2C%22standardized_nudges_misinfo%22%3Atrue%2C%22tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled%22%3Atrue%2C%22longform_notetweets_rich_text_read_enabled%22%3Atrue%2C%22longform_notetweets_inline_media_enabled%22%3Atrue%2C%22responsive_web_grok_image_annotation_enabled%22%3Atrue%2C%22responsive_web_enhance_cards_enabled%22%3Afalse%7D&fieldToggles=%7B%22withArticleRichContentState%22%3Atrue%2C%22withArticlePlainText%22%3Afalse%2C%22withGrokAnalyze%22%3Afalse%2C%22withDisallowedReplyControls%22%3Afalse%7D",
+  TweetResultByRestId: "https://api.x.com/graphql/Opujkru5iJSDWj4DuJISOw/TweetResultByRestId?variables=%7B%22tweetId%22%3A%221924893675529900467%22%2C%22withCommunity%22%3Afalse%2C%22includePromotedContent%22%3Afalse%2C%22withVoice%22%3Afalse%7D&features=%7B%22creator_subscriptions_tweet_preview_api_enabled%22%3Atrue%2C%22premium_content_api_read_enabled%22%3Afalse%2C%22communities_web_enable_tweet_community_results_fetch%22%3Atrue%2C%22c9s_tweet_anatomy_moderator_badge_enabled%22%3Atrue%2C%22responsive_web_grok_analyze_button_fetch_trends_enabled%22%3Afalse%2C%22responsive_web_grok_analyze_post_followups_enabled%22%3Afalse%2C%22responsive_web_jetfuel_frame%22%3Afalse%2C%22responsive_web_grok_share_attachment_enabled%22%3Atrue%2C%22articles_preview_enabled%22%3Atrue%2C%22responsive_web_edit_tweet_api_enabled%22%3Atrue%2C%22graphql_is_translatable_rweb_tweet_is_translatable_enabled%22%3Atrue%2C%22view_counts_everywhere_api_enabled%22%3Atrue%2C%22longform_notetweets_consumption_enabled%22%3Atrue%2C%22responsive_web_twitter_article_tweet_consumption_enabled%22%3Atrue%2C%22tweet_awards_web_tipping_enabled%22%3Afalse%2C%22responsive_web_grok_show_grok_translated_post%22%3Afalse%2C%22responsive_web_grok_analysis_button_from_backend%22%3Atrue%2C%22creator_subscriptions_quote_tweet_preview_enabled%22%3Afalse%2C%22freedom_of_speech_not_reach_fetch_enabled%22%3Atrue%2C%22standardized_nudges_misinfo%22%3Atrue%2C%22tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled%22%3Atrue%2C%22longform_notetweets_rich_text_read_enabled%22%3Atrue%2C%22longform_notetweets_inline_media_enabled%22%3Atrue%2C%22profile_label_improvements_pcf_label_in_post_enabled%22%3Atrue%2C%22rweb_tipjar_consumption_enabled%22%3Atrue%2C%22verified_phone_label_enabled%22%3Afalse%2C%22responsive_web_grok_image_annotation_enabled%22%3Atrue%2C%22responsive_web_graphql_skip_user_profile_image_extensions_enabled%22%3Afalse%2C%22responsive_web_graphql_timeline_navigation_enabled%22%3Atrue%2C%22responsive_web_enhance_cards_enabled%22%3Afalse%7D&fieldToggles=%7B%22withArticleRichContentState%22%3Atrue%2C%22withArticlePlainText%22%3Afalse%2C%22withGrokAnalyze%22%3Afalse%2C%22withDisallowedReplyControls%22%3Afalse%7D",
+  ListTweets: "https://x.com/i/api/graphql/S1Sm3_mNJwa-fnY9htcaAQ/ListLatestTweetsTimeline?variables=%7B%22listId%22%3A%221736495155002106192%22%2C%22count%22%3A20%7D&features=%7B%22rweb_video_screen_enabled%22%3Afalse%2C%22profile_label_improvements_pcf_label_in_post_enabled%22%3Atrue%2C%22rweb_tipjar_consumption_enabled%22%3Atrue%2C%22verified_phone_label_enabled%22%3Afalse%2C%22creator_subscriptions_tweet_preview_api_enabled%22%3Atrue%2C%22responsive_web_graphql_timeline_navigation_enabled%22%3Atrue%2C%22responsive_web_graphql_skip_user_profile_image_extensions_enabled%22%3Afalse%2C%22premium_content_api_read_enabled%22%3Afalse%2C%22communities_web_enable_tweet_community_results_fetch%22%3Atrue%2C%22c9s_tweet_anatomy_moderator_badge_enabled%22%3Atrue%2C%22responsive_web_grok_analyze_button_fetch_trends_enabled%22%3Afalse%2C%22responsive_web_grok_analyze_post_followups_enabled%22%3Atrue%2C%22responsive_web_jetfuel_frame%22%3Afalse%2C%22responsive_web_grok_share_attachment_enabled%22%3Atrue%2C%22articles_preview_enabled%22%3Atrue%2C%22responsive_web_edit_tweet_api_enabled%22%3Atrue%2C%22graphql_is_translatable_rweb_tweet_is_translatable_enabled%22%3Atrue%2C%22view_counts_everywhere_api_enabled%22%3Atrue%2C%22longform_notetweets_consumption_enabled%22%3Atrue%2C%22responsive_web_twitter_article_tweet_consumption_enabled%22%3Atrue%2C%22tweet_awards_web_tipping_enabled%22%3Afalse%2C%22responsive_web_grok_show_grok_translated_post%22%3Afalse%2C%22responsive_web_grok_analysis_button_from_backend%22%3Atrue%2C%22creator_subscriptions_quote_tweet_preview_enabled%22%3Afalse%2C%22freedom_of_speech_not_reach_fetch_enabled%22%3Atrue%2C%22standardized_nudges_misinfo%22%3Atrue%2C%22tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled%22%3Atrue%2C%22longform_notetweets_rich_text_read_enabled%22%3Atrue%2C%22longform_notetweets_inline_media_enabled%22%3Atrue%2C%22responsive_web_grok_image_annotation_enabled%22%3Atrue%2C%22responsive_web_enhance_cards_enabled%22%3Afalse%7D"
+};
+class ApiRequest {
+  constructor(info) {
+    this.url = info.url;
+    this.variables = info.variables;
+    this.features = info.features;
+    this.fieldToggles = info.fieldToggles;
+  }
+  toRequestUrl() {
+    const params = new URLSearchParams();
+    if (this.variables) {
+      params.set("variables", stringify(this.variables));
+    }
+    if (this.features) {
+      params.set("features", stringify(this.features));
+    }
+    if (this.fieldToggles) {
+      params.set("fieldToggles", stringify(this.fieldToggles));
+    }
+    return `${this.url}?${params.toString()}`;
+  }
+}
+function parseEndpointExample(example) {
+  const { protocol, host, pathname, searchParams: query } = new URL(example);
+  const base = `${protocol}//${host}${pathname}`;
+  const variables = query.get("variables");
+  const features = query.get("features");
+  const fieldToggles = query.get("fieldToggles");
+  return new ApiRequest({
+    url: base,
+    variables: variables ? JSON.parse(variables) : void 0,
+    features: features ? JSON.parse(features) : void 0,
+    fieldToggles: fieldToggles ? JSON.parse(fieldToggles) : void 0
+  });
+}
+function createApiRequestFactory(endpoints2) {
+  return Object.entries(endpoints2).map(([endpointName, endpointExample]) => {
+    return {
+      [`create${endpointName}Request`]: () => {
+        return parseEndpointExample(endpointExample);
+      }
+    };
+  }).reduce((agg, next) => {
+    return Object.assign(agg, next);
+  });
+}
+const apiRequestFactory = createApiRequestFactory(endpoints);
+
 function getAvatarOriginalSizeUrl(avatarUrl) {
   return avatarUrl ? avatarUrl.replace("_normal", "") : void 0;
 }
@@ -666,35 +800,12 @@ function parseProfile(user, isBlueVerified) {
   return profile;
 }
 async function getProfile(username, auth) {
-  const params = new URLSearchParams();
-  params.set(
-    "variables",
-    stringify({
-      screen_name: username,
-      withSafetyModeUserFields: true
-    })
-  );
-  params.set(
-    "features",
-    stringify({
-      hidden_profile_likes_enabled: false,
-      hidden_profile_subscriptions_enabled: false,
-      // Auth-restricted
-      responsive_web_graphql_exclude_directive_enabled: true,
-      verified_phone_label_enabled: false,
-      subscriptions_verification_info_is_identity_verified_enabled: false,
-      subscriptions_verification_info_verified_since_enabled: true,
-      highlights_tweets_tab_ui_enabled: true,
-      creator_subscriptions_tweet_preview_api_enabled: true,
-      responsive_web_graphql_skip_user_profile_image_extensions_enabled: false,
-      responsive_web_graphql_timeline_navigation_enabled: true
-    })
-  );
-  params.set("fieldToggles", stringify({ withAuxiliaryUserLabels: false }));
-  const res = await requestApi(
-    `https://twitter.com/i/api/graphql/G3KGOASz96M-Qu0nwmGXNg/UserByScreenName?${params.toString()}`,
-    auth
-  );
+  const request = apiRequestFactory.createUserByScreenNameRequest();
+  request.variables.screen_name = username;
+  request.variables.withSafetyModeUserFields = true;
+  request.features.hidden_profile_subscriptions_enabled = false;
+  request.fieldToggles.withAuxiliaryUserLabels = false;
+  const res = await requestApi(request.toRequestUrl(), auth);
   if (!res.success) {
     return res;
   }
@@ -778,6 +889,7 @@ async function* getUserTimeline(query, maxProfiles, fetchFunc) {
       nProfiles++;
     }
     if (!next) break;
+    await jitter(1e3);
   }
 }
 async function* getTweetTimeline(query, maxTweets, fetchFunc) {
@@ -802,6 +914,7 @@ async function* getTweetTimeline(query, maxTweets, fetchFunc) {
       }
       nTweets++;
     }
+    await jitter(1e3);
   }
 }
 
@@ -924,7 +1037,7 @@ function getLegacyTweetId(tweet) {
   }
   return tweet.conversation_id_str;
 }
-function parseLegacyTweet(user, tweet, editControl) {
+function parseLegacyTweet(coreUser, user, tweet, editControl) {
   if (tweet == null) {
     return {
       success: false,
@@ -954,6 +1067,8 @@ function parseLegacyTweet(user, tweet, editControl) {
   const { photos, videos, sensitiveContent } = parseMediaGroups(media);
   const tweetVersions = editControl?.edit_tweet_ids ?? [tweetId];
   const editIds = tweetVersions.filter((id) => id !== tweetId);
+  const name = user.name ?? coreUser?.name;
+  const username = user.screen_name ?? coreUser?.screen_name;
   const tw = {
     __raw_UNSTABLE: tweet,
     bookmarkCount: tweet.bookmark_count,
@@ -966,8 +1081,8 @@ function parseLegacyTweet(user, tweet, editControl) {
       username: mention.screen_name,
       name: mention.name
     })),
-    name: user.name,
-    permanentUrl: `https://twitter.com/${user.screen_name}/status/${tweetId}`,
+    name,
+    permanentUrl: `https://twitter.com/${username}/status/${tweetId}`,
     photos,
     replies: tweet.reply_count,
     retweets: tweet.retweet_count,
@@ -975,7 +1090,7 @@ function parseLegacyTweet(user, tweet, editControl) {
     thread: [],
     urls: urls.filter(isFieldDefined("expanded_url")).map((url) => url.expanded_url),
     userId: tweet.user_id_str,
-    username: user.screen_name,
+    username,
     videos,
     isQuoted: false,
     isReply: false,
@@ -1009,6 +1124,7 @@ function parseLegacyTweet(user, tweet, editControl) {
     tw.retweetedStatusId = retweetedStatusIdStr;
     if (retweetedStatusResult) {
       const parsedResult = parseLegacyTweet(
+        retweetedStatusResult?.core?.user_results?.result?.core,
         retweetedStatusResult?.core?.user_results?.result?.legacy,
         retweetedStatusResult?.legacy
       );
@@ -1036,6 +1152,7 @@ function parseResult(result) {
     result.legacy.full_text = noteTweetResultText;
   }
   const tweetResult = parseLegacyTweet(
+    result?.core?.user_results?.result?.core,
     result?.core?.user_results?.result?.legacy,
     result?.legacy
   );
@@ -1186,6 +1303,7 @@ function parseSearchTimelineTweets(timeline) {
         if (itemContent?.tweetDisplayType === "Tweet") {
           const tweetResultRaw = itemContent.tweet_results?.result;
           const tweetResult = parseLegacyTweet(
+            tweetResultRaw?.core?.user_results?.result?.core,
             tweetResultRaw?.core?.user_results?.result?.legacy,
             tweetResultRaw?.legacy,
             tweetResultRaw?.edit_control?.edit_control_initial
@@ -1288,8 +1406,8 @@ async function fetchSearchProfiles(query, maxProfiles, auth, cursor) {
   return parseSearchTimelineUsers(timeline);
 }
 async function getSearchTimeline(query, maxItems, searchMode, auth, cursor) {
-  if (!auth.isLoggedIn()) {
-    throw new Error("Scraper is not logged-in for search.");
+  if (!await auth.isLoggedIn()) {
+    throw new AuthenticationError("Scraper is not logged-in for search.");
   }
   if (maxItems > 50) {
     maxItems = 50;
@@ -1396,6 +1514,11 @@ function getFollowers(userId, maxProfiles, auth) {
   });
 }
 async function fetchProfileFollowing(userId, maxProfiles, auth, cursor) {
+  if (!await auth.isLoggedIn()) {
+    throw new AuthenticationError(
+      "Scraper is not logged-in for profile following."
+    );
+  }
   const timeline = await getFollowingTimeline(
     userId,
     maxProfiles,
@@ -1405,6 +1528,11 @@ async function fetchProfileFollowing(userId, maxProfiles, auth, cursor) {
   return parseRelationshipTimeline(timeline);
 }
 async function fetchProfileFollowers(userId, maxProfiles, auth, cursor) {
+  if (!await auth.isLoggedIn()) {
+    throw new AuthenticationError(
+      "Scraper is not logged-in for profile followers."
+    );
+  }
   const timeline = await getFollowersTimeline(
     userId,
     maxProfiles,
@@ -1415,7 +1543,9 @@ async function fetchProfileFollowers(userId, maxProfiles, auth, cursor) {
 }
 async function getFollowingTimeline(userId, maxItems, auth, cursor) {
   if (!auth.isLoggedIn()) {
-    throw new Error("Scraper is not logged-in for profile following.");
+    throw new AuthenticationError(
+      "Scraper is not logged-in for profile following."
+    );
   }
   if (maxItems > 50) {
     maxItems = 50;
@@ -1448,7 +1578,9 @@ async function getFollowingTimeline(userId, maxItems, auth, cursor) {
 }
 async function getFollowersTimeline(userId, maxItems, auth, cursor) {
   if (!auth.isLoggedIn()) {
-    throw new Error("Scraper is not logged-in for profile followers.");
+    throw new AuthenticationError(
+      "Scraper is not logged-in for profile followers."
+    );
   }
   if (maxItems > 50) {
     maxItems = 50;
@@ -1513,62 +1645,6 @@ async function getTrends(auth) {
   return trends;
 }
 
-const endpoints = {
-  // TODO: Migrate other endpoint URLs here
-  UserTweets: "https://twitter.com/i/api/graphql/V7H0Ap3_Hh2FyS75OCDO3Q/UserTweets?variables=%7B%22userId%22%3A%224020276615%22%2C%22count%22%3A20%2C%22includePromotedContent%22%3Atrue%2C%22withQuickPromoteEligibilityTweetFields%22%3Atrue%2C%22withVoice%22%3Atrue%2C%22withV2Timeline%22%3Atrue%7D&features=%7B%22rweb_tipjar_consumption_enabled%22%3Atrue%2C%22responsive_web_graphql_exclude_directive_enabled%22%3Atrue%2C%22verified_phone_label_enabled%22%3Afalse%2C%22creator_subscriptions_tweet_preview_api_enabled%22%3Atrue%2C%22responsive_web_graphql_timeline_navigation_enabled%22%3Atrue%2C%22responsive_web_graphql_skip_user_profile_image_extensions_enabled%22%3Afalse%2C%22communities_web_enable_tweet_community_results_fetch%22%3Atrue%2C%22c9s_tweet_anatomy_moderator_badge_enabled%22%3Atrue%2C%22articles_preview_enabled%22%3Atrue%2C%22tweetypie_unmention_optimization_enabled%22%3Atrue%2C%22responsive_web_edit_tweet_api_enabled%22%3Atrue%2C%22graphql_is_translatable_rweb_tweet_is_translatable_enabled%22%3Atrue%2C%22view_counts_everywhere_api_enabled%22%3Atrue%2C%22longform_notetweets_consumption_enabled%22%3Atrue%2C%22responsive_web_twitter_article_tweet_consumption_enabled%22%3Atrue%2C%22tweet_awards_web_tipping_enabled%22%3Afalse%2C%22creator_subscriptions_quote_tweet_preview_enabled%22%3Afalse%2C%22freedom_of_speech_not_reach_fetch_enabled%22%3Atrue%2C%22standardized_nudges_misinfo%22%3Atrue%2C%22tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled%22%3Atrue%2C%22rweb_video_timestamps_enabled%22%3Atrue%2C%22longform_notetweets_rich_text_read_enabled%22%3Atrue%2C%22longform_notetweets_inline_media_enabled%22%3Atrue%2C%22responsive_web_enhance_cards_enabled%22%3Afalse%7D&fieldToggles=%7B%22withArticlePlainText%22%3Afalse%7D",
-  UserTweetsAndReplies: "https://twitter.com/i/api/graphql/E4wA5vo2sjVyvpliUffSCw/UserTweetsAndReplies?variables=%7B%22userId%22%3A%224020276615%22%2C%22count%22%3A40%2C%22cursor%22%3A%22DAABCgABGPWl-F-ATiIKAAIY9YfiF1rRAggAAwAAAAEAAA%22%2C%22includePromotedContent%22%3Atrue%2C%22withCommunity%22%3Atrue%2C%22withVoice%22%3Atrue%2C%22withV2Timeline%22%3Atrue%7D&features=%7B%22rweb_tipjar_consumption_enabled%22%3Atrue%2C%22responsive_web_graphql_exclude_directive_enabled%22%3Atrue%2C%22verified_phone_label_enabled%22%3Afalse%2C%22creator_subscriptions_tweet_preview_api_enabled%22%3Atrue%2C%22responsive_web_graphql_timeline_navigation_enabled%22%3Atrue%2C%22responsive_web_graphql_skip_user_profile_image_extensions_enabled%22%3Afalse%2C%22communities_web_enable_tweet_community_results_fetch%22%3Atrue%2C%22c9s_tweet_anatomy_moderator_badge_enabled%22%3Atrue%2C%22articles_preview_enabled%22%3Atrue%2C%22tweetypie_unmention_optimization_enabled%22%3Atrue%2C%22responsive_web_edit_tweet_api_enabled%22%3Atrue%2C%22graphql_is_translatable_rweb_tweet_is_translatable_enabled%22%3Atrue%2C%22view_counts_everywhere_api_enabled%22%3Atrue%2C%22longform_notetweets_consumption_enabled%22%3Atrue%2C%22responsive_web_twitter_article_tweet_consumption_enabled%22%3Atrue%2C%22tweet_awards_web_tipping_enabled%22%3Afalse%2C%22creator_subscriptions_quote_tweet_preview_enabled%22%3Afalse%2C%22freedom_of_speech_not_reach_fetch_enabled%22%3Atrue%2C%22standardized_nudges_misinfo%22%3Atrue%2C%22tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled%22%3Atrue%2C%22rweb_video_timestamps_enabled%22%3Atrue%2C%22longform_notetweets_rich_text_read_enabled%22%3Atrue%2C%22longform_notetweets_inline_media_enabled%22%3Atrue%2C%22responsive_web_enhance_cards_enabled%22%3Afalse%7D&fieldToggles=%7B%22withArticlePlainText%22%3Afalse%7D",
-  UserLikedTweets: "https://twitter.com/i/api/graphql/eSSNbhECHHWWALkkQq-YTA/Likes?variables=%7B%22userId%22%3A%222244196397%22%2C%22count%22%3A20%2C%22includePromotedContent%22%3Afalse%2C%22withClientEventToken%22%3Afalse%2C%22withBirdwatchNotes%22%3Afalse%2C%22withVoice%22%3Atrue%2C%22withV2Timeline%22%3Atrue%7D&features=%7B%22responsive_web_graphql_exclude_directive_enabled%22%3Atrue%2C%22verified_phone_label_enabled%22%3Afalse%2C%22creator_subscriptions_tweet_preview_api_enabled%22%3Atrue%2C%22responsive_web_graphql_timeline_navigation_enabled%22%3Atrue%2C%22responsive_web_graphql_skip_user_profile_image_extensions_enabled%22%3Afalse%2C%22c9s_tweet_anatomy_moderator_badge_enabled%22%3Atrue%2C%22tweetypie_unmention_optimization_enabled%22%3Atrue%2C%22responsive_web_edit_tweet_api_enabled%22%3Atrue%2C%22graphql_is_translatable_rweb_tweet_is_translatable_enabled%22%3Atrue%2C%22view_counts_everywhere_api_enabled%22%3Atrue%2C%22longform_notetweets_consumption_enabled%22%3Atrue%2C%22responsive_web_twitter_article_tweet_consumption_enabled%22%3Atrue%2C%22tweet_awards_web_tipping_enabled%22%3Afalse%2C%22freedom_of_speech_not_reach_fetch_enabled%22%3Atrue%2C%22standardized_nudges_misinfo%22%3Atrue%2C%22tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled%22%3Atrue%2C%22rweb_video_timestamps_enabled%22%3Atrue%2C%22longform_notetweets_rich_text_read_enabled%22%3Atrue%2C%22longform_notetweets_inline_media_enabled%22%3Atrue%2C%22responsive_web_enhance_cards_enabled%22%3Afalse%7D",
-  TweetDetail: "https://twitter.com/i/api/graphql/xOhkmRac04YFZmOzU9PJHg/TweetDetail?variables=%7B%22focalTweetId%22%3A%221237110546383724547%22%2C%22with_rux_injections%22%3Afalse%2C%22includePromotedContent%22%3Atrue%2C%22withCommunity%22%3Atrue%2C%22withQuickPromoteEligibilityTweetFields%22%3Atrue%2C%22withBirdwatchNotes%22%3Atrue%2C%22withVoice%22%3Atrue%2C%22withV2Timeline%22%3Atrue%7D&features=%7B%22responsive_web_graphql_exclude_directive_enabled%22%3Atrue%2C%22verified_phone_label_enabled%22%3Afalse%2C%22creator_subscriptions_tweet_preview_api_enabled%22%3Atrue%2C%22responsive_web_graphql_timeline_navigation_enabled%22%3Atrue%2C%22responsive_web_graphql_skip_user_profile_image_extensions_enabled%22%3Afalse%2C%22tweetypie_unmention_optimization_enabled%22%3Atrue%2C%22responsive_web_edit_tweet_api_enabled%22%3Atrue%2C%22graphql_is_translatable_rweb_tweet_is_translatable_enabled%22%3Atrue%2C%22view_counts_everywhere_api_enabled%22%3Atrue%2C%22longform_notetweets_consumption_enabled%22%3Atrue%2C%22responsive_web_twitter_article_tweet_consumption_enabled%22%3Afalse%2C%22tweet_awards_web_tipping_enabled%22%3Afalse%2C%22freedom_of_speech_not_reach_fetch_enabled%22%3Atrue%2C%22standardized_nudges_misinfo%22%3Atrue%2C%22tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled%22%3Atrue%2C%22longform_notetweets_rich_text_read_enabled%22%3Atrue%2C%22longform_notetweets_inline_media_enabled%22%3Atrue%2C%22responsive_web_media_download_video_enabled%22%3Afalse%2C%22responsive_web_enhance_cards_enabled%22%3Afalse%7D&fieldToggles=%7B%22withArticleRichContentState%22%3Afalse%7D",
-  TweetResultByRestId: "https://twitter.com/i/api/graphql/DJS3BdhUhcaEpZ7B7irJDg/TweetResultByRestId?variables=%7B%22tweetId%22%3A%221237110546383724547%22%2C%22withCommunity%22%3Afalse%2C%22includePromotedContent%22%3Afalse%2C%22withVoice%22%3Afalse%7D&features=%7B%22creator_subscriptions_tweet_preview_api_enabled%22%3Atrue%2C%22tweetypie_unmention_optimization_enabled%22%3Atrue%2C%22responsive_web_edit_tweet_api_enabled%22%3Atrue%2C%22graphql_is_translatable_rweb_tweet_is_translatable_enabled%22%3Atrue%2C%22view_counts_everywhere_api_enabled%22%3Atrue%2C%22longform_notetweets_consumption_enabled%22%3Atrue%2C%22responsive_web_twitter_article_tweet_consumption_enabled%22%3Afalse%2C%22tweet_awards_web_tipping_enabled%22%3Afalse%2C%22freedom_of_speech_not_reach_fetch_enabled%22%3Atrue%2C%22standardized_nudges_misinfo%22%3Atrue%2C%22tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled%22%3Atrue%2C%22longform_notetweets_rich_text_read_enabled%22%3Atrue%2C%22longform_notetweets_inline_media_enabled%22%3Atrue%2C%22responsive_web_graphql_exclude_directive_enabled%22%3Atrue%2C%22verified_phone_label_enabled%22%3Afalse%2C%22responsive_web_media_download_video_enabled%22%3Afalse%2C%22responsive_web_graphql_skip_user_profile_image_extensions_enabled%22%3Afalse%2C%22responsive_web_graphql_timeline_navigation_enabled%22%3Atrue%2C%22responsive_web_enhance_cards_enabled%22%3Afalse%7D",
-  ListTweets: "https://twitter.com/i/api/graphql/whF0_KH1fCkdLLoyNPMoEw/ListLatestTweetsTimeline?variables=%7B%22listId%22%3A%221736495155002106192%22%2C%22count%22%3A20%7D&features=%7B%22responsive_web_graphql_exclude_directive_enabled%22%3Atrue%2C%22verified_phone_label_enabled%22%3Afalse%2C%22creator_subscriptions_tweet_preview_api_enabled%22%3Atrue%2C%22responsive_web_graphql_timeline_navigation_enabled%22%3Atrue%2C%22responsive_web_graphql_skip_user_profile_image_extensions_enabled%22%3Afalse%2C%22c9s_tweet_anatomy_moderator_badge_enabled%22%3Atrue%2C%22tweetypie_unmention_optimization_enabled%22%3Atrue%2C%22responsive_web_edit_tweet_api_enabled%22%3Atrue%2C%22graphql_is_translatable_rweb_tweet_is_translatable_enabled%22%3Atrue%2C%22view_counts_everywhere_api_enabled%22%3Atrue%2C%22longform_notetweets_consumption_enabled%22%3Atrue%2C%22responsive_web_twitter_article_tweet_consumption_enabled%22%3Afalse%2C%22tweet_awards_web_tipping_enabled%22%3Afalse%2C%22freedom_of_speech_not_reach_fetch_enabled%22%3Atrue%2C%22standardized_nudges_misinfo%22%3Atrue%2C%22tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled%22%3Atrue%2C%22rweb_video_timestamps_enabled%22%3Atrue%2C%22longform_notetweets_rich_text_read_enabled%22%3Atrue%2C%22longform_notetweets_inline_media_enabled%22%3Atrue%2C%22responsive_web_media_download_video_enabled%22%3Afalse%2C%22responsive_web_enhance_cards_enabled%22%3Afalse%7D"
-};
-class ApiRequest {
-  constructor(info) {
-    this.url = info.url;
-    this.variables = info.variables;
-    this.features = info.features;
-    this.fieldToggles = info.fieldToggles;
-  }
-  toRequestUrl() {
-    const params = new URLSearchParams();
-    if (this.variables) {
-      params.set("variables", stringify(this.variables));
-    }
-    if (this.features) {
-      params.set("features", stringify(this.features));
-    }
-    if (this.fieldToggles) {
-      params.set("fieldToggles", stringify(this.fieldToggles));
-    }
-    return `${this.url}?${params.toString()}`;
-  }
-}
-function parseEndpointExample(example) {
-  const { protocol, host, pathname, searchParams: query } = new URL(example);
-  const base = `${protocol}//${host}${pathname}`;
-  const variables = query.get("variables");
-  const features = query.get("features");
-  const fieldToggles = query.get("fieldToggles");
-  return new ApiRequest({
-    url: base,
-    variables: variables ? JSON.parse(variables) : void 0,
-    features: features ? JSON.parse(features) : void 0,
-    fieldToggles: fieldToggles ? JSON.parse(fieldToggles) : void 0
-  });
-}
-function createApiRequestFactory(endpoints2) {
-  return Object.entries(endpoints2).map(([endpointName, endpointExample]) => {
-    return {
-      [`create${endpointName}Request`]: () => {
-        return parseEndpointExample(endpointExample);
-      }
-    };
-  }).reduce((agg, next) => {
-    return Object.assign(agg, next);
-  });
-}
-const apiRequestFactory = createApiRequestFactory(endpoints);
-
 function parseListTimelineTweets(timeline) {
   let bottomCursor;
   let topCursor;
@@ -1705,8 +1781,10 @@ function getTweetsAndRepliesByUserId(userId, maxTweets, auth) {
   });
 }
 async function fetchLikedTweets(userId, maxTweets, cursor, auth) {
-  if (!auth.isLoggedIn()) {
-    throw new Error("Scraper is not logged-in for fetching liked tweets.");
+  if (!await auth.isLoggedIn()) {
+    throw new AuthenticationError(
+      "Scraper is not logged-in for fetching liked tweets."
+    );
   }
   if (maxTweets > 200) {
     maxTweets = 200;
@@ -1811,6 +1889,20 @@ class Scraper {
     this.token = bearerToken;
     this.useGuestAuth();
   }
+  /**
+   * Registers a subtask handler for the given subtask ID. This
+   * will override any existing handler for the same subtask.
+   * @param subtaskId The ID of the subtask to register the handler for.
+   * @param subtaskHandler The handler function to register.
+   */
+  registerAuthSubtaskHandler(subtaskId, subtaskHandler) {
+    if (this.auth instanceof TwitterUserAuth) {
+      this.auth.registerSubtaskHandler(subtaskId, subtaskHandler);
+    }
+    if (this.authTrends instanceof TwitterUserAuth) {
+      this.authTrends.registerSubtaskHandler(subtaskId, subtaskHandler);
+    }
+  }
   /**
    * Initializes auth properties using a guest token.
    * Used when creating a new instance of this class, and when logging out.
@@ -2145,6 +2237,7 @@ class Scraper {
 }
 
 exports.ApiError = ApiError;
+exports.AuthenticationError = AuthenticationError;
 exports.ErrorRateLimitStrategy = ErrorRateLimitStrategy;
 exports.Scraper = Scraper;
 exports.SearchMode = SearchMode;