rettiwt-api 1.0.6 → 1.0.8

package/src/services/helper/extractors/Tweets.ts

@@ -0,0 +1,252 @@
+// TYPES
+import { DataExtract } from '../../../types/Resolvers';
+import { DataErrors } from '../../../types/data/Errors';
+import RawTweet from '../../../types/raw/tweet/Tweet';
+import RawTweets from '../../../types/raw/tweet/Tweets';
+import RawRetweeters from '../../../types/raw/tweet/Retweeters';
+import RawLikers from '../../../types/raw/tweet/Favouriters';
+
+// PARSERS
+import * as Parsers from '../Parser';
+
+/**
+ * @returns The raw tweets data formatted and sorted into required and additional data
+ * @param res The raw response received from TwitterAPI
+ */
+export function extractTweets(res: RawTweets): DataExtract {
+    let required: any[] = [];                                               // To store the reqruied raw data
+    let cursor: string = '';                                                // To store the cursor to next batch
+    let users: any[] = [];                                                  // To store additional user data
+    let tweets: any[] = [];                                                 // To store additional tweet data
+
+    // Getting raw tweet list
+    let dataTweets = res.globalObjects.tweets;
+
+    // Getting raw users list
+    let dataUsers = res.globalObjects.users;
+
+    // If tweets found
+    if (!Parsers.isJSONEmpty(dataTweets)) {
+        // Destructuring the list of tweets
+        for (let key of Object.keys(dataTweets)) {
+            required.push({ rest_id: dataTweets[key].id_str, legacy: dataTweets[key] });
+            tweets.push({ rest_id: dataTweets[key].id_str, legacy: dataTweets[key] });
+        }
+
+        // Destructuring the list of users
+        for (let key of Object.keys(dataUsers)) {
+            users.push({ rest_id: dataUsers[key].id_str, legacy: dataUsers[key] });
+        }
+
+        // Getting the cursor to next batch
+        // If not first batch
+        if (res.timeline.instructions.length > 2) {
+            cursor = res.timeline.instructions[2]?.replaceEntry.entry.content.operation?.cursor.value ?? '';
+        }
+        // If first batch
+        else {
+            cursor = res.timeline.instructions[0].addEntries?.entries.filter(item => item.entryId.indexOf('cursor-bottom') != -1)[0].content.operation?.cursor.value ?? '';
+        }
+    }
+
+    // Returning the data
+    return {
+        required: required,
+        cursor: cursor,
+        users: users,
+        tweets: tweets
+    };
+}
+
+/**
+ * @returns The raw tweet data formatted and sorted into required and additional data
+ * @param res The raw response received from TwitterAPI
+ * @param tweetId The rest id of the tweet to fetch
+ */
+export function extractTweet(res: RawTweet, tweetId: string): DataExtract {
+    let required: any[] = [];                                               // To store the reqruied raw data
+    let cursor: string = '';                                                // To store the cursor to next batch
+    let users: any[] = [];                                                  // To store additional user data
+    let tweets: any[] = [];                                                 // To store additional tweet data
+
+    // If tweet does not exist
+    if (Parsers.isJSONEmpty(res.data)) {
+        throw new Error(DataErrors.TweetNotFound);
+    }
+
+    // Destructuring the received raw data
+    res.data.threaded_conversation_with_injections_v2.instructions.filter(item => item['type'] === 'TimelineAddEntries')[0].entries?.forEach(entry => {
+        // If entry is of type tweet and tweet exists
+        if (entry.entryId.indexOf('tweet') != -1 && entry.content.itemContent?.tweet_results?.result.__typename === 'Tweet') {
+            // If this is the required tweet
+            if (entry.entryId.indexOf(tweetId) != -1) {
+                required.push(entry.content.itemContent.tweet_results.result);
+            }
+            tweets.push(entry.content.itemContent.tweet_results.result);
+            users.push(entry.content.itemContent.tweet_results.result.core.user_results.result);
+        }
+        // If entry if of type conversation
+        else if (entry.entryId.indexOf('conversationthread') != -1) {
+            // Iterating over the conversation
+            entry.content.items?.forEach(item => {
+                // If item is of type tweet and tweet exists
+                if (item.entryId.indexOf('tweet') != -1 && item.item.itemContent.tweet_results?.result.__typename === 'Tweet') {
+                    required.push(item.item.itemContent.tweet_results.result);
+                    tweets.push(item.item.itemContent.tweet_results.result);
+                    users.push(item.item.itemContent.tweet_results.result.core.user_results.result);
+                }
+            });
+        }
+    });
+
+    // Returning the data
+    return {
+        required: required,
+        cursor: cursor,
+        users: users,
+        tweets: tweets
+    };
+}
+
+/**
+ * @returns The raw tweet likers data formatted and sorted into required and additional data
+ * @param res The raw response received from TwitterAPI
+ */
+export function extractTweetLikers(res: RawLikers): DataExtract {
+    let required: any[] = [];                                               // To store the reqruied raw data
+    let cursor: string = '';                                                // To store the cursor to next batch
+    let users: any[] = [];                                                  // To store additional user data
+    let tweets: any[] = [];                                                 // To store additional tweet data
+
+    // If tweet does not exist
+    if (Parsers.isJSONEmpty(res.data.favoriters_timeline)) {
+        throw new Error(DataErrors.TweetNotFound);
+    }
+
+    // If likes found
+    if (res.data.favoriters_timeline.timeline.instructions.length) {
+        // Destructuring raw list of likers
+        res.data.favoriters_timeline.timeline.instructions.filter(item => item.type === 'TimelineAddEntries')[0].entries.forEach(entry => {
+            // If entry is of type user and user exists
+            if (entry.entryId.indexOf('user') != -1 && entry.content.itemContent?.user_results.result.__typename === 'User') {
+                required.push(entry.content.itemContent.user_results.result);
+                users.push(entry.content.itemContent.user_results.result);
+            }
+            // If entry is of type cursor
+            else if (entry.entryId.indexOf('cursor-bottom') != -1) {
+                cursor = entry.content.value ?? '';
+            }
+        });
+    }
+
+    // Returning the data
+    return {
+        required: required,
+        cursor: cursor,
+        users: users,
+        tweets: tweets
+    };
+}
+
+/**
+ * @returns The raw tweet retweeters data formatted and sorted into required and additional data
+ * @param res The raw response received from TwitterAPI
+ */
+export function extractTweetRetweeters(res: RawRetweeters): DataExtract {
+    let required: any[] = [];                                               // To store the reqruied raw data
+    let cursor: string = '';                                                // To store the cursor to next batch
+    let users: any[] = [];                                                  // To store additional user data
+    let tweets: any[] = [];                                                 // To store additional tweet data
+
+    // If tweet does not exist
+    if (Parsers.isJSONEmpty(res.data.retweeters_timeline)) {
+        throw new Error(DataErrors.TweetNotFound);
+    }
+
+    // If retweeters found
+    if (res.data.retweeters_timeline.timeline.instructions.length) {
+        // Destructuring raw list of retweeters
+        res.data.retweeters_timeline.timeline.instructions.filter(item => item.type === 'TimelineAddEntries')[0].entries.forEach(entry => {
+            // If entry is of type user and user exists
+            if (entry.entryId.indexOf('user') != -1 && entry.content.itemContent?.user_results.result.__typename === 'User') {
+                required.push(entry.content.itemContent.user_results.result);
+                users.push(entry.content.itemContent.user_results.result);
+            }
+            // If entry is of type cursor
+            else if (entry.entryId.indexOf('cursor-bottom') != -1) {
+                cursor = entry.content.value ?? '';
+            }
+        });
+    }
+
+    // Returning the data
+    return {
+        required: required,
+        cursor: cursor,
+        users: users,
+        tweets: tweets
+    };
+}
+
+/**
+ * @returns The raw tweet replies data formatted and sorted into required and additional data
+ * @param res The raw response received from TwitterAPI
+ * @param tweetId The id of the tweet whose replies must be extracted
+ */
+export function extractTweetReplies(res: RawTweet, tweetId: string): DataExtract {
+    let required: any[] = [];                                               // To store the reqruied raw data
+    let cursor: string = '';                                                // To store the cursor to next batch
+    let users: any[] = [];                                                  // To store additional user data
+    let tweets: any[] = [];                                                 // To store additional tweet data
+
+    // If tweet does not exist
+    if (Parsers.isJSONEmpty(res.data)) {
+        throw new Error(DataErrors.TweetNotFound);
+    }
+
+    // Destructuring the received raw data
+    res.data.threaded_conversation_with_injections_v2.instructions.filter(item => item.type === 'TimelineAddEntries')[0].entries?.map(entry => {
+        // If entry is of type tweet
+        if (entry.entryId.indexOf('tweet') != -1) {
+            // If tweet exists
+            if (entry.content.itemContent?.tweet_results?.result.__typename === 'Tweet') {
+                tweets.push(entry.content.itemContent.tweet_results.result);
+                users.push(entry.content.itemContent.tweet_results.result.core.user_results.result);
+            }
+        }
+        // If entry if of type conversation/reply
+        else if (entry.entryId.indexOf('conversationthread') != -1) {
+            // If tweet exists
+            if (entry.content.items?.at(0)?.item.itemContent.tweet_results?.result.__typename === 'Tweet') {
+                // Adding the 1st entry, which is a reply, to required list
+                required.push(entry.content.items[0].item.itemContent.tweet_results?.result);
+                tweets.push(entry.content.items[0].item.itemContent.tweet_results?.result);
+                users.push(entry.content.items[0].item.itemContent.tweet_results?.result.core.user_results.result);
+            }
+
+            // Iterating over the rest of the conversation
+            entry.content.items?.forEach(item => {
+                // If item is of type tweet
+                if (item.entryId.indexOf('tweet') != -1) {
+                    // If tweet exists
+                    if (item.item.itemContent.tweet_results?.result.__typename === 'Tweet') {
+                        tweets.push(item.item.itemContent.tweet_results.result);
+                        users.push(item.item.itemContent.tweet_results.result.core.user_results.result);
+                    }
+                }
+            });
+        }
+        // If entry is of type bottom cursor
+        else if (entry.entryId.indexOf('cursor-bottom') != -1) {
+            cursor = entry.content.itemContent?.value ?? '';
+        }
+    });
+
+    // Returning the data
+    return {
+        required: required,
+        cursor: cursor,
+        users: users,
+        tweets: tweets
+    };
+}

package/src/services/helper/extractors/Users.ts

@@ -0,0 +1,137 @@
+// TYPES
+import { DataExtract } from '../../../types/Resolvers'
+import { DataErrors } from '../../../types/data/Errors';
+import RawUser from '../../../types/raw/user/User';
+import RawUserFollowers from '../../../types/raw/user/Followers';
+import RawUserFollowing from '../../../types/raw/user/Following';
+import RawUserLikes from '../../../types/raw/user/Likes';
+
+// PARSERS
+import * as Parsers from '../Parser';
+
+/**
+ * @returns The raw user account data formatted and sorted into required and additional data
+ * @param res The raw response received from Twitter
+ */
+export function extractUserDetails(res: RawUser): DataExtract {
+    let required: any[] = [];                                               // To store the reqruied raw data
+    let cursor: string = '';                                                // To store the cursor to next batch
+    let users: any[] = [];                                                  // To store additional user data
+    let tweets: any[] = [];                                                 // To store additional tweet data
+
+    // If user not found or account suspended
+    if (res.data?.user?.result?.__typename !== 'User') {
+        throw new Error(DataErrors.UserNotFound);
+    }
+
+    // Destructuring user account data
+    required.push(res.data.user.result);
+    users.push(res.data.user.result);
+
+    // Returning the data
+    return {
+        required: required,
+        cursor: cursor,
+        users: users,
+        tweets: tweets
+    };
+}
+
+/**
+ * @returns The raw user following/followers data formatted and sorted into required and additional data
+ * @param res The raw response received from TwitterAPI
+ */
+export function extractUserFollow(res: RawUserFollowers | RawUserFollowing): DataExtract {
+    let required: any[] = [];                                               // To store the reqruied raw data
+    let cursor: string = '';                                                // To store the cursor to next batch
+    let users: any[] = [];                                                  // To store additional user data
+    let tweets: any[] = [];                                                 // To store additional tweet data
+
+    // If user does not exist
+    if (Parsers.isJSONEmpty(res.data.user)) {
+        throw new Error(DataErrors.UserNotFound);
+    }
+
+    // Extracting the raw list
+    res.data.user.result.timeline.timeline.instructions.forEach(item => {
+        if (item.type === 'TimelineAddEntries') {
+            // If no follow found
+            if (item.entries?.length == 2) {
+                // Returning the data
+                return {
+                    required: required,
+                    cursor: cursor,
+                    users: users,
+                    tweets: tweets
+                };
+            }
+
+            // Destructuring data
+            item.entries?.forEach(entry => {
+                // If entry is of type user and user account exists
+                if (entry.entryId.indexOf('user') != -1 && entry.content.itemContent?.user_results.result.__typename === 'User') {
+                    required.push(entry.content.itemContent.user_results.result);
+                    users.push(entry.content.itemContent.user_results.result);
+                }
+                // If entry is of type cursor
+                else if (entry.entryId.indexOf('cursor-bottom') != -1) {
+                    cursor = entry.content.value ?? '';
+                }
+            });
+        }
+    });
+
+    // Returning the data
+    return {
+        required: required,
+        cursor: cursor,
+        users: users,
+        tweets: tweets
+    };
+}
+
+/**
+ * @returns The raw user likes data formatted and sorted into required and additional data
+ * @param res The raw response received from TwitterAPI
+ */
+export function extractUserLikes(res: RawUserLikes): DataExtract {
+    let required: any[] = [];                                               // To store the reqruied raw data
+    let cursor: string = '';                                                // To store the cursor to next batch
+    let users: any[] = [];                                                  // To store additional user data
+    let tweets: any[] = [];                                                 // To store additional tweet data
+
+    // If user does not exist
+    if (Parsers.isJSONEmpty(res.data.user)) {
+        throw new Error(DataErrors.UserNotFound);
+    }
+
+    // If user likes found
+    if (res.data.user.result.timeline_v2.timeline.instructions.length) {
+        // Extracting the raw list
+        res.data.user.result.timeline_v2.timeline.instructions.forEach(item => {
+            if (item.type === 'TimelineAddEntries') {
+                // Destructuring data
+                item.entries.forEach(entry => {
+                    // If entry is of type tweet and tweet exists
+                    if (entry.entryId.indexOf('tweet') != -1 && entry.content.itemContent?.tweet_results.result.__typename === 'Tweet') {
+                        required.push(entry.content.itemContent.tweet_results.result);
+                        users.push(entry.content.itemContent.tweet_results.result.core.user_results.result);
+                        tweets.push(entry.content.itemContent.tweet_results.result);
+                    }
+                    // If entry is of type cursor
+                    else if (entry.entryId.indexOf('cursor-bottom') != -1) {
+                        cursor = entry.content.value ?? '';
+                    }
+                });
+            }
+        });
+    }
+
+    // Returning the data
+    return {
+        required: required,
+        cursor: cursor,
+        users: users,
+        tweets: tweets
+    };
+}

package/src/services/helper/urls/Authentication.ts

@@ -0,0 +1,6 @@
+/**
+ * @returns The url for fetching a guest token
+ */
+export function guestTokenUrl(): string {
+    return `https://api.twitter.com/1.1/guest/activate.json`;
+}

package/src/services/helper/urls/Tweets.ts

@@ -0,0 +1,46 @@
+/**
+ * @returns The url for fetching the list of tweets matching the given filter
+ * @param query The query to be used for searching tweets
+ * @param count The number of tweets to fetch
+ * @param cursor The cusor to next batch * 
+ */
+export function tweetsUrl(query: string, count: number, cursor: string): string {
+    return `https://api.twitter.com/2/search/adaptive.json?include_want_retweets=1&include_quote_count=true&include_reply_count=1&tweet_mode=extended&include_entities=true&include_user_entities=true&simple_quoted_tweet=true&q=${encodeURIComponent(query)}&tweet_search_mode=live&count=${count}&query_source=typed_query&cursor=${encodeURIComponent(cursor)}`;
+}
+
+/**
+ * @returns The url for fetching the details of a given tweet
+ * @param tweetId The rest id of the target tweet
+ */
+export function tweetDetailsUrl(tweetId: string): string {
+    return `https://api.twitter.com/graphql/lXI2kaM2hgmbf7h42kpxuA/TweetDetail?variables=%7B%22focalTweetId%22%3A%22${tweetId}%22%2C%22referrer%22%3A%22profile%22%2C%22with_rux_injections%22%3Afalse%2C%22includePromotedContent%22%3Atrue%2C%22withCommunity%22%3Atrue%2C%22withQuickPromoteEligibilityTweetFields%22%3Atrue%2C%22withBirdwatchNotes%22%3Atrue%2C%22withSuperFollowsUserFields%22%3Atrue%2C%22withDownvotePerspective%22%3Afalse%2C%22withReactionsMetadata%22%3Afalse%2C%22withReactionsPerspective%22%3Afalse%2C%22withSuperFollowsTweetFields%22%3Atrue%2C%22withVoice%22%3Atrue%2C%22withV2Timeline%22%3Atrue%7D&features=%7B%22responsive_web_twitter_blue_verified_badge_is_enabled%22%3Atrue%2C%22verified_phone_label_enabled%22%3Atrue%2C%22responsive_web_graphql_timeline_navigation_enabled%22%3Atrue%2C%22view_counts_public_visibility_enabled%22%3Atrue%2C%22longform_notetweets_consumption_enabled%22%3Afalse%2C%22tweetypie_unmention_optimization_enabled%22%3Atrue%2C%22responsive_web_uc_gql_enabled%22%3Atrue%2C%22vibe_api_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%22standardized_nudges_misinfo%22%3Atrue%2C%22tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled%22%3Afalse%2C%22interactive_text_enabled%22%3Atrue%2C%22responsive_web_text_conversations_enabled%22%3Afalse%2C%22responsive_web_enhance_cards_enabled%22%3Afalse%7D`;
+}
+
+/**
+ * @returns The url for fetching the list of replies to a given tweet
+ * @param tweetId The rest of the target tweet
+ * @param cursor The curor to next batch
+ */
+export function tweetRepliesUrl(tweetId: string, cursor: string): string {
+    return `https://api.twitter.com/graphql/lXI2kaM2hgmbf7h42kpxuA/TweetDetail?variables=%7B%22focalTweetId%22%3A%22${tweetId}%22%2C%22cursor%22%3A%22${encodeURIComponent(cursor)}%22%2C%22referrer%22%3A%22tweet%22%2C%22with_rux_injections%22%3Afalse%2C%22includePromotedContent%22%3Atrue%2C%22withCommunity%22%3Atrue%2C%22withQuickPromoteEligibilityTweetFields%22%3Atrue%2C%22withBirdwatchNotes%22%3Atrue%2C%22withSuperFollowsUserFields%22%3Atrue%2C%22withDownvotePerspective%22%3Afalse%2C%22withReactionsMetadata%22%3Afalse%2C%22withReactionsPerspective%22%3Afalse%2C%22withSuperFollowsTweetFields%22%3Atrue%2C%22withVoice%22%3Atrue%2C%22withV2Timeline%22%3Atrue%7D&features=%7B%22responsive_web_twitter_blue_verified_badge_is_enabled%22%3Atrue%2C%22verified_phone_label_enabled%22%3Atrue%2C%22responsive_web_graphql_timeline_navigation_enabled%22%3Atrue%2C%22view_counts_public_visibility_enabled%22%3Atrue%2C%22longform_notetweets_consumption_enabled%22%3Afalse%2C%22tweetypie_unmention_optimization_enabled%22%3Atrue%2C%22responsive_web_uc_gql_enabled%22%3Atrue%2C%22vibe_api_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%22standardized_nudges_misinfo%22%3Atrue%2C%22tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled%22%3Afalse%2C%22interactive_text_enabled%22%3Atrue%2C%22responsive_web_text_conversations_enabled%22%3Afalse%2C%22responsive_web_enhance_cards_enabled%22%3Afalse%7D`;
+}
+
+/**
+ * @returns The url for fetching the list of users who liked a given tweet
+ * @param tweetId The rest id of the target tweet
+ * @param count The batch size of the list of users
+ * @param cursor The curor to next batch
+ */
+export function tweetLikesUrl(tweetId: string, count: number, cursor: string): string {
+    return `https://api.twitter.com/graphql/56ZwFC3Vui31fF8IYX8EGA/Favoriters?variables=%7B%22tweetId%22%3A%22${tweetId}%22%2C%22count%22%3A${count}%2C%22cursor%22%3A%22${encodeURIComponent(cursor)}%22%2C%22includePromotedContent%22%3Atrue%2C%22withSuperFollowsUserFields%22%3Atrue%2C%22withDownvotePerspective%22%3Afalse%2C%22withReactionsMetadata%22%3Afalse%2C%22withReactionsPerspective%22%3Afalse%2C%22withSuperFollowsTweetFields%22%3Atrue%7D&features=%7B%22responsive_web_twitter_blue_verified_badge_is_enabled%22%3Atrue%2C%22verified_phone_label_enabled%22%3Atrue%2C%22responsive_web_graphql_timeline_navigation_enabled%22%3Atrue%2C%22view_counts_public_visibility_enabled%22%3Atrue%2C%22longform_notetweets_consumption_enabled%22%3Afalse%2C%22tweetypie_unmention_optimization_enabled%22%3Atrue%2C%22responsive_web_uc_gql_enabled%22%3Atrue%2C%22vibe_api_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%22standardized_nudges_misinfo%22%3Atrue%2C%22tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled%22%3Afalse%2C%22interactive_text_enabled%22%3Atrue%2C%22responsive_web_text_conversations_enabled%22%3Afalse%2C%22responsive_web_enhance_cards_enabled%22%3Afalse%7D`;
+}
+
+/**
+ * @returns The url for fetching the list of user who retweeted the given tweet
+ * @param tweetId The rest id of the target tweet
+ * @param count The batch size of the list of users
+ * @param cursor The curor to next batch
+ */
+export function tweetRetweetUrl(tweetId: string, count: number, cursor: string): string {
+    return `https://api.twitter.com/graphql/Wd7DVeLqMj_JQiTL0tjJwQ/Retweeters?variables=%7B%22tweetId%22%3A%22${tweetId}%22%2C%22count%22%3A${count}%2C%22cursor%22%3A%22${encodeURIComponent(cursor)}%22%2C%22includePromotedContent%22%3Atrue%2C%22withSuperFollowsUserFields%22%3Atrue%2C%22withDownvotePerspective%22%3Afalse%2C%22withReactionsMetadata%22%3Afalse%2C%22withReactionsPerspective%22%3Afalse%2C%22withSuperFollowsTweetFields%22%3Atrue%7D&features=%7B%22responsive_web_twitter_blue_verified_badge_is_enabled%22%3Atrue%2C%22verified_phone_label_enabled%22%3Atrue%2C%22responsive_web_graphql_timeline_navigation_enabled%22%3Atrue%2C%22view_counts_public_visibility_enabled%22%3Atrue%2C%22longform_notetweets_consumption_enabled%22%3Afalse%2C%22tweetypie_unmention_optimization_enabled%22%3Atrue%2C%22responsive_web_uc_gql_enabled%22%3Atrue%2C%22vibe_api_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%22standardized_nudges_misinfo%22%3Atrue%2C%22tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled%22%3Afalse%2C%22interactive_text_enabled%22%3Atrue%2C%22responsive_web_text_conversations_enabled%22%3Afalse%2C%22responsive_web_enhance_cards_enabled%22%3Afalse%7D`;
+}

package/src/services/helper/urls/Users.ts

@@ -0,0 +1,62 @@
+/**
+ * @returns The url for fetching user account details.
+ * @param screenName The screen name of the target user
+ */
+export function userDetailsUrl(screenName: string): string {
+    return `https://api.twitter.com/graphql/hVhfo_TquFTmgL7gYwf91Q/UserByScreenName?variables=%7B%22screen_name%22%3A%22${screenName}%22%2C%22withSafetyModeUserFields%22%3Atrue%2C%22withSuperFollowsUserFields%22%3Atrue%7D&features=%7B%22responsive_web_twitter_blue_verified_badge_is_enabled%22%3Atrue%2C%22verified_phone_label_enabled%22%3Atrue%2C%22responsive_web_graphql_timeline_navigation_enabled%22%3Atrue%7D`
+}
+
+/**
+ * @returns The url for fetching user account details.
+ * @param restid The restId of the target user
+ */
+export function userDetailsByIdUrl(restId: string): string {
+    return `https://api.twitter.com/graphql/mi_IjXgFyr41N9zkszPz9w/UserByRestId?variables=%7B%22userId%22%3A%22${restId}%22%2C%22withSafetyModeUserFields%22%3Atrue%2C%22withSuperFollowsUserFields%22%3Atrue%7D&features=%7B%22responsive_web_twitter_blue_verified_badge_is_enabled%22%3Atrue%2C%22verified_phone_label_enabled%22%3Atrue%2C%22responsive_web_graphql_timeline_navigation_enabled%22%3Atrue%7D`;
+}
+
+/**
+ * @returns The url for fetching the list of users followed bu target user.
+ * @param userId The rest id of the target user
+ * @param count The batch size of the list of following, should be >= 40 and <=100
+ * @param cursor The cursor to next batch
+ */
+export function userFollowingUrl(userId: string, count: number, cursor: string): string {
+    /** 
+     * Twitter has a ver odd behaviour here.
+     * If no cursor is provided, the number of followings fetched is slightly more the given count.
+     * If a cursor if provided, the number of followings is sometimes less than the provided count.
+     * NO SOLUTION EXISTS AS OF NOW!
+     */
+    return `https://api.twitter.com/graphql/mSnjZc5CTm2Z5Lu_i4XsPQ/Following?variables=%7B%22userId%22%3A%22${userId}%22%2C%22count%22%3A${count}%2C%22cursor%22%3A%22${encodeURIComponent(cursor)}%22%2C%22includePromotedContent%22%3Afalse%2C%22withSuperFollowsUserFields%22%3Atrue%2C%22withDownvotePerspective%22%3Afalse%2C%22withReactionsMetadata%22%3Afalse%2C%22withReactionsPerspective%22%3Afalse%2C%22withSuperFollowsTweetFields%22%3Atrue%7D&features=%7B%22responsive_web_twitter_blue_verified_badge_is_enabled%22%3Atrue%2C%22verified_phone_label_enabled%22%3Atrue%2C%22responsive_web_graphql_timeline_navigation_enabled%22%3Atrue%2C%22view_counts_public_visibility_enabled%22%3Atrue%2C%22longform_notetweets_consumption_enabled%22%3Afalse%2C%22tweetypie_unmention_optimization_enabled%22%3Atrue%2C%22responsive_web_uc_gql_enabled%22%3Atrue%2C%22vibe_api_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%22standardized_nudges_misinfo%22%3Atrue%2C%22tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled%22%3Afalse%2C%22interactive_text_enabled%22%3Atrue%2C%22responsive_web_text_conversations_enabled%22%3Afalse%2C%22responsive_web_enhance_cards_enabled%22%3Afalse%7D`;
+}
+
+/**
+ * @return The url for fetching the list of followers of the target user
+ * @param userId The rest id of the target user
+ * @param count The batch size for the list of followers, should be >= 40 and <=100
+ * @param cursor The cusor to next batch
+ */
+export function userFollowersUrl(userId: string, count: number, cursor: string): string {
+    /**
+     * Twitter has a very odd behaviour here.
+     * If no cursor is provided, the number of followers fetched is equal to count + 20.
+     * If a cursor is provided, the number of followers fetched is equal to count.
+     * The solution is to check accordingly, if a cursor if provided or not and manipulate the count
+     */
+    // If no cursor if provided
+    if (!cursor) {
+        count = count - 20;
+    }
+
+    return `https://api.twitter.com/graphql/nwlAnaw7oKXcVLi91ehy7Q/Followers?variables=%7B%22userId%22%3A%22${userId}%22%2C%22count%22%3A${count}%2C%22cursor%22%3A%22${encodeURIComponent(cursor)}%22%2C%22includePromotedContent%22%3Afalse%2C%22withSuperFollowsUserFields%22%3Atrue%2C%22withDownvotePerspective%22%3Afalse%2C%22withReactionsMetadata%22%3Afalse%2C%22withReactionsPerspective%22%3Afalse%2C%22withSuperFollowsTweetFields%22%3Atrue%7D&features=%7B%22responsive_web_twitter_blue_verified_badge_is_enabled%22%3Atrue%2C%22verified_phone_label_enabled%22%3Atrue%2C%22responsive_web_graphql_timeline_navigation_enabled%22%3Atrue%2C%22view_counts_public_visibility_enabled%22%3Atrue%2C%22longform_notetweets_consumption_enabled%22%3Afalse%2C%22tweetypie_unmention_optimization_enabled%22%3Atrue%2C%22responsive_web_uc_gql_enabled%22%3Atrue%2C%22vibe_api_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%22standardized_nudges_misinfo%22%3Atrue%2C%22tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled%22%3Afalse%2C%22interactive_text_enabled%22%3Atrue%2C%22responsive_web_text_conversations_enabled%22%3Afalse%2C%22responsive_web_enhance_cards_enabled%22%3Afalse%7D`;
+}
+
+/**
+ * @returns The url for fetching the list of tweets liked by the target user
+ * @param userId The rest id of the target user
+ * @param count The batch size for the list of tweets
+ * @param cursor The cusor to next batch
+ */
+export function userLikesUrl(userId: string, count: number, cursor: string): string {
+    return `https://api.twitter.com/graphql/gP4ZKghLd4tpILgS6VudAQ/Likes?variables=%7B%22userId%22%3A%22${userId}%22%2C%22count%22%3A${count}%2C%22cursor%22%3A%22${encodeURIComponent(cursor)}%22%2C%22includePromotedContent%22%3Afalse%2C%22withSuperFollowsUserFields%22%3Atrue%2C%22withDownvotePerspective%22%3Afalse%2C%22withReactionsMetadata%22%3Afalse%2C%22withReactionsPerspective%22%3Afalse%2C%22withSuperFollowsTweetFields%22%3Atrue%2C%22withClientEventToken%22%3Afalse%2C%22withBirdwatchNotes%22%3Afalse%2C%22withVoice%22%3Atrue%2C%22withV2Timeline%22%3Atrue%7D&features=%7B%22responsive_web_twitter_blue_verified_badge_is_enabled%22%3Atrue%2C%22verified_phone_label_enabled%22%3Atrue%2C%22responsive_web_graphql_timeline_navigation_enabled%22%3Atrue%2C%22view_counts_public_visibility_enabled%22%3Atrue%2C%22longform_notetweets_consumption_enabled%22%3Afalse%2C%22tweetypie_unmention_optimization_enabled%22%3Atrue%2C%22responsive_web_uc_gql_enabled%22%3Atrue%2C%22vibe_api_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%22standardized_nudges_misinfo%22%3Atrue%2C%22tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled%22%3Afalse%2C%22interactive_text_enabled%22%3Atrue%2C%22responsive_web_text_conversations_enabled%22%3Afalse%2C%22responsive_web_enhance_cards_enabled%22%3Afalse%7D`;
+}

package/src/types/Resolvers.ts

@@ -0,0 +1,9 @@
+/**
+ * @summary Stores the data returned from extractors
+ */
+export interface DataExtract {
+    required: any;                                              // To store the required data extracted
+    cursor: string;                                             // To store the cursor extracted
+    users: any;                                                 // To store all user details extracted
+    tweets: any;                                                // To store all tweets exracted
+}

package/src/types/data/Errors.ts

@@ -0,0 +1,28 @@
+/**
+ * @summary Stores different types of error messages related to authentication
+ */
+export enum AuthenticationErrors {
+    NotAuthenticated = "Cannot fetch this data without authentication",
+};
+
+/**
+ * @summary Stores different types error messages for validation errors
+ */
+export enum ValidationErrors {
+    InvalidTweetFilter = "Atleast one of fromUsers/toUsers/mentions/hashtags/words argument is required",
+    NoUserIdentification = "Either userName or id must be given",
+    InvalidCount = "Invalid count provided"
+};
+
+/**
+ * @summary Stores all the different type of error messages that are returned by services
+ */
+export enum DataErrors {
+    UserNotFound = "An account with given username/id was not found",
+    TweetNotFound = "A tweet with the given id was not found",
+    NoTweetsFound = "No tweets matching the given criteria found",
+    NoLikersFound = "No likers found for the tweet with the given id",
+    NoRetweetersFound = "No retweeters found for the tweet with the given id",
+    NoFollowsFound = "No follow details were found for the user with the given id",
+    NoLikedTweetsFound = "No liked tweets were found for the user with the given id"
+};

package/src/types/{Service.ts → data/Service.ts}

@@ -1,7 +1,7 @@
 // SERVICES
-import { AccountService } from "../services/accounts/AccountService";
-import { TweetService } from "../services/data/TweetService";
-import { UserAccountService } from "../services/data/UserAccountService";
+import { AccountService } from "../../services/accounts/AccountService";
+import { TweetService } from "../../services/data/TweetService";
+import { UserService } from "../../services/data/UserService";
 
 /**
  * @summary Stores the cursor to the batch of data
@@ -26,14 +26,13 @@ export class Cursor {
 export interface CursoredData<Type> {
     list?: Type[];                                                      // To store the list data
     next?: Cursor;                                                      // To store the information about cursor to the next batch
-    error?: Error;                                                      // To store the error message, if any
 }
 
 /**
  * @summary Stores the data context from where data is to be fetched
  */
 export interface DataContext {
-    users: UserAccountService,                                          // To store the source for fetching user account data
+    users: UserService,                                                 // To store the source for fetching user data
     tweets: TweetService,                                               // To store the source for fetching tweet data
     account: AccountService                                             // To store the source for account related operations
 }

package/src/types/{Tweet.ts → data/Tweet.ts}

@@ -11,6 +11,7 @@ export interface TweetFilter {
     mentions?: string[];                                                // To store the list of mentioned users
     startDate?: string;                                                 // To store the beginning date to search tweets
     endDate?: string;                                                   // To store the ending date to search tweets
+    sinceId?: string;                                                   // To store the first id (exclusive) from which to search tweets
     quoted?: string;                                                    // To store the id of the tweet which is quoted
     links?: boolean;                                                    // To store whether to fetch link tweets or not
 };

package/tsconfig.json

@@ -22,8 +22,8 @@
 		// "useDefineForClassFields": true,                  /* Emit ECMAScript-standard-compliant class fields. */
 		// "moduleDetection": "auto",                        /* Control what method is used to detect module-format JS files. */
 		/* Modules */
-		// "module": "commonjs",                              /* Specify what module code is generated. */
-		// "rootDir": "./",                                  /* Specify the root folder within your source files. */
+		// "module": "commonjs",                             /* Specify what module code is generated. */
+		"rootDir": "./src",                                  /* Specify the root folder within your source files. */
 		// "moduleResolution": "node",                       /* Specify how TypeScript looks up a file from a given module specifier. */
 		// "baseUrl": "./",                                  /* Specify the base directory to resolve non-relative module names. */
 		// "paths": {},                                      /* Specify a set of entries that re-map imports to additional lookup locations. */

package/dist/models/graphql/Global.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Global.js","sourceRoot":"","sources":["../../../src/models/graphql/Global.ts"],"names":[],"mappings":";;;AAAA,UAAU;AACV,mCAA4D;AAE/C,QAAA,MAAM,GAAG,IAAI,2BAAiB,CAAC;IACxC,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,6CAA6C;IAC1D,MAAM,EAAE,cAAM,OAAA,CAAC;QACX,KAAK,EAAE,EAAE,IAAI,EAAE,uBAAa,EAAE;KACjC,CAAC,EAFY,CAEZ;CACL,CAAC,CAAC"}

package/dist/models/graphql/TweetTypes.d.ts

@@ -1,6 +0,0 @@
-import { GraphQLList, GraphQLObjectType } from "graphql";
-export declare const TweetTokens: GraphQLObjectType<any, any, {
-    [key: string]: any;
-}>;
-export declare const Tweet: any;
-export declare const TweetList: GraphQLList<import("graphql").GraphQLType>;

package/dist/models/graphql/TweetTypes.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"TweetTypes.js","sourceRoot":"","sources":["../../../src/models/graphql/TweetTypes.ts"],"names":[],"mappings":"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"}

package/dist/models/graphql/UserTypes.d.ts

@@ -1,3 +0,0 @@
-import { GraphQLList } from 'graphql';
-export declare const User: any;
-export declare const UserList: GraphQLList<import("graphql").GraphQLType>;