rettiwt-api 4.2.0-alpha.0 → 4.2.0-alpha.2

package/src/Rettiwt.ts

@@ -1,4 +1,5 @@
 import { AuthService } from './services/public/AuthService';
+import { ListService } from './services/public/ListService';
 import { TweetService } from './services/public/TweetService';
 import { UserService } from './services/public/UserService';
 import { IRettiwtConfig } from './types/RettiwtConfig';
@@ -48,6 +49,9 @@ export class Rettiwt {
 	/** The instance used to authenticate. */
 	public auth: AuthService;
 
+	/** The instance used to fetch data related to lists. */
+	public list: ListService;
+
 	/** The instance used to fetch data related to tweets. */
 	public tweet: TweetService;
 
@@ -61,6 +65,7 @@ export class Rettiwt {
 	 */
 	public constructor(config?: IRettiwtConfig) {
 		this.auth = new AuthService(config);
+		this.list = new ListService(config);
 		this.tweet = new TweetService(config);
 		this.user = new UserService(config);
 	}

package/src/cli.ts

@@ -3,6 +3,7 @@
 import { createCommand } from 'commander';
 
 import auth from './commands/Auth';
+import list from './commands/List';
 import tweet from './commands/Tweet';
 import user from './commands/User';
 import { Rettiwt } from './Rettiwt';
@@ -32,6 +33,7 @@ const rettiwt: Rettiwt = new Rettiwt({
 });
 
 // Adding sub-commands
+program.addCommand(list(rettiwt));
 program.addCommand(tweet(rettiwt));
 program.addCommand(user(rettiwt));
 program.addCommand(auth(rettiwt));

package/src/collections/Extractors.ts

@@ -1,5 +1,6 @@
 import {
 	IInitializeMediaUploadResponse,
+	IListMembersResponse,
 	IListTweetsResponse,
 	ITweetDetailsResponse,
 	ITweetLikeResponse,
@@ -42,6 +43,8 @@ import { User } from '../models/data/User';
  */
 export const extractors = {
 	/* eslint-disable @typescript-eslint/naming-convention */
+	LIST_MEMBERS: (response: IListMembersResponse): CursoredData<User> =>
+		new CursoredData<User>(response, EBaseType.USER),
 	LIST_TWEETS: (response: IListTweetsResponse): CursoredData<Tweet> =>
 		new CursoredData<Tweet>(response, EBaseType.TWEET),
 

package/src/collections/Groups.ts

@@ -17,6 +17,7 @@ export const allowGuestAuthentication = [
  * @internal
  */
 export const fetchResources = [
+	EResourceType.LIST_MEMBERS,
 	EResourceType.LIST_TWEETS,
 	EResourceType.TWEET_DETAILS,
 	EResourceType.TWEET_DETAILS_ALT,

package/src/collections/Requests.ts

@@ -19,6 +19,7 @@ const request = new Request();
  */
 export const requests: { [key in keyof typeof EResourceType]: (args: FetchArgs | PostArgs) => AxiosRequestConfig } = {
 	/* eslint-disable @typescript-eslint/naming-convention */
+	LIST_MEMBERS: (args: FetchArgs) => request.list.members(args.id!, args.count, args.cursor),
 	LIST_TWEETS: (args: FetchArgs) => request.list.tweets(args.id!, args.count, args.cursor),
 
 	MEDIA_UPLOAD_APPEND: (args: PostArgs) => request.media.appendUpload(args.upload!.id!, args.upload!.media!),
@@ -32,7 +33,7 @@ export const requests: { [key in keyof typeof EResourceType]: (args: FetchArgs |
 	TWEET_RETWEET: (args: PostArgs) => request.tweet.retweet(args.id!),
 	TWEET_RETWEETERS: (args: FetchArgs) => request.tweet.retweeters(args.id!, args.count, args.cursor),
 	TWEET_SCHEDULE: (args: PostArgs) => request.tweet.schedule(args.tweet!, args.tweet!.scheduleFor!),
-	TWEET_SEARCH: (args: FetchArgs) => request.tweet.search(args.filter!, args.count, args.cursor),
+	TWEET_SEARCH: (args: FetchArgs) => request.tweet.search(args.filter!, args.count, args.cursor, args.results),
 	TWEET_UNLIKE: (args: PostArgs) => request.tweet.unlike(args.id!),
 	TWEET_UNPOST: (args: PostArgs) => request.tweet.unpost(args.id!),
 	TWEET_UNRETWEET: (args: PostArgs) => request.tweet.unretweet(args.id!),

package/src/commands/List.ts

@@ -0,0 +1,49 @@
+import { Command, createCommand } from 'commander';
+
+import { output } from '../helper/CliUtils';
+import { Rettiwt } from '../Rettiwt';
+
+/**
+ * Creates a new 'list' command which uses the given Rettiwt instance.
+ *
+ * @param rettiwt - The Rettiwt instance to use.
+ * @returns The created 'list' command.
+ */
+function createListCommand(rettiwt: Rettiwt): Command {
+	// Creating the 'list' command
+	const list = createCommand('list').description('Access resources releated to lists');
+
+	// Members
+	list.command('members')
+		.description('Fetch the list of members of the given tweet list')
+		.argument('<id>', 'The id of the tweet list')
+		.argument('[count]', 'The number of members to fetch')
+		.argument('[cursor]', 'The cursor to the batch of members to fetch')
+		.action(async (id: string, count?: string, cursor?: string) => {
+			try {
+				const members = await rettiwt.list.members(id, count ? parseInt(count) : undefined, cursor);
+				output(members);
+			} catch (error) {
+				output(error);
+			}
+		});
+
+	// Tweets
+	list.command('tweets')
+		.description('Fetch the list of tweets in the tweet list with the given id')
+		.argument('<id>', 'The id of the tweet list')
+		.argument('[count]', 'The number of tweets to fetch')
+		.argument('[cursor]', 'The cursor to the batch of tweets to fetch')
+		.action(async (id: string, count?: string, cursor?: string) => {
+			try {
+				const tweets = await rettiwt.list.tweets(id, count ? parseInt(count) : undefined, cursor);
+				output(tweets);
+			} catch (error) {
+				output(error);
+			}
+		});
+
+	return list;
+}
+
+export default createListCommand;

package/src/commands/Tweet.ts

@@ -1,5 +1,5 @@
 import { Command, createCommand } from 'commander';
-import { TweetFilter } from 'rettiwt-core';
+import { ESearchResultType, TweetFilter } from 'rettiwt-core';
 
 import { output } from '../helper/CliUtils';
 import { Rettiwt } from '../Rettiwt';
@@ -172,6 +172,7 @@ function createTweetCommand(rettiwt: Rettiwt): Command {
 		.option('--exclude-replies', 'Matches the tweets that are not replies')
 		.option('-s, --start <string>', 'Matches the tweets made since the given date (valid date/time string)')
 		.option('-e, --end <string>', 'Matches the tweets made upto the given date (valid date/time string)')
+		.option('--top', 'Matches top tweets instead of latest')
 		.option('--stream', 'Stream the filtered tweets in pseudo-realtime')
 		.option('-i, --interval <number>', 'The polling interval (in ms) to use for streaming. Default is 60000')
 		.action(async (count?: string, cursor?: string, options?: TweetSearchOptions) => {
@@ -191,6 +192,7 @@ function createTweetCommand(rettiwt: Rettiwt): Command {
 						new TweetSearchOptions(options).toTweetFilter(),
 						count ? parseInt(count) : undefined,
 						cursor,
+						options?.top ? ESearchResultType.TOP : ESearchResultType.LATEST,
 					);
 					output(tweets);
 				}
@@ -296,6 +298,7 @@ class TweetSearchOptions {
 	public start?: string;
 	public stream?: boolean;
 	public to?: string;
+	public top?: boolean;
 	public words?: string;
 
 	/**
@@ -323,6 +326,7 @@ class TweetSearchOptions {
 		this.end = options?.end;
 		this.stream = options?.stream;
 		this.interval = options?.interval;
+		this.top = options?.top;
 	}
 
 	/**

package/src/enums/Resource.ts

@@ -5,6 +5,7 @@
  */
 export enum EResourceType {
 	// LIST
+	LIST_MEMBERS = 'LIST_MEMBERS',
 	LIST_TWEETS = 'LIST_TWEETS',
 
 	// MEDIA

package/src/index.ts

@@ -5,6 +5,7 @@ export * from './Rettiwt';
 export * from './enums/Api';
 export * from './enums/Http';
 export * from './enums/Resource';
+export { ESearchResultType } from 'rettiwt-core';
 
 // ARG MODELS
 export * from './models/args/FetchArgs';
@@ -37,6 +38,7 @@ export * from './types/ErrorHandler';
 // RAW TYPES
 export {
 	IInitializeMediaUploadResponse,
+	IListMembersResponse,
 	IListTweetsResponse,
 	ITweetDetailsResponse,
 	ITweetLikeResponse,
@@ -52,6 +54,7 @@ export {
 	ITweetUnretweetResponse,
 } from 'rettiwt-core';
 export {
+	IUserBookmarksResponse,
 	IUserDetailsResponse,
 	IUserFollowedResponse,
 	IUserFollowersResponse,
@@ -60,6 +63,7 @@ export {
 	IUserHighlightsResponse,
 	IUserLikesResponse,
 	IUserMediaResponse,
+	IUserNotifications as IUserNotificationsResponse,
 	IUserRecommendedResponse,
 	IUserSubscriptionsResponse,
 	IUserTweetsAndRepliesResponse,

package/src/models/args/FetchArgs.ts

@@ -14,7 +14,7 @@ import {
 	validateSync,
 } from 'class-validator';
 
-import { TweetFilter as TweetFilterCore } from 'rettiwt-core';
+import { ESearchResultType, TweetFilter as TweetFilterCore } from 'rettiwt-core';
 
 import { EResourceType } from '../../enums/Resource';
 import { DataValidationError } from '../errors/DataValidationError';
@@ -52,6 +52,7 @@ export class FetchArgs {
 	})
 	@IsOptional({
 		groups: [
+			EResourceType.LIST_MEMBERS,
 			EResourceType.LIST_TWEETS,
 			EResourceType.TWEET_RETWEETERS,
 			EResourceType.TWEET_SEARCH,
@@ -68,6 +69,7 @@ export class FetchArgs {
 	})
 	@Min(1, {
 		groups: [
+			EResourceType.LIST_MEMBERS,
 			EResourceType.LIST_TWEETS,
 			EResourceType.TWEET_RETWEETERS,
 			EResourceType.TWEET_SEARCH,
@@ -84,6 +86,7 @@ export class FetchArgs {
 	})
 	@Max(100, {
 		groups: [
+			EResourceType.LIST_MEMBERS,
 			EResourceType.LIST_TWEETS,
 			EResourceType.TWEET_RETWEETERS,
 			EResourceType.USER_FOLLOWERS,
@@ -119,6 +122,7 @@ export class FetchArgs {
 	})
 	@IsOptional({
 		groups: [
+			EResourceType.LIST_MEMBERS,
 			EResourceType.LIST_TWEETS,
 			EResourceType.TWEET_RETWEETERS,
 			EResourceType.TWEET_SEARCH,
@@ -137,6 +141,7 @@ export class FetchArgs {
 	})
 	@IsString({
 		groups: [
+			EResourceType.LIST_MEMBERS,
 			EResourceType.LIST_TWEETS,
 			EResourceType.TWEET_RETWEETERS,
 			EResourceType.TWEET_SEARCH,
@@ -163,6 +168,7 @@ export class FetchArgs {
 	 */
 	@IsEmpty({
 		groups: [
+			EResourceType.LIST_MEMBERS,
 			EResourceType.LIST_TWEETS,
 			EResourceType.TWEET_DETAILS,
 			EResourceType.TWEET_DETAILS_ALT,
@@ -202,6 +208,7 @@ export class FetchArgs {
 	})
 	@IsNotEmpty({
 		groups: [
+			EResourceType.LIST_MEMBERS,
 			EResourceType.LIST_TWEETS,
 			EResourceType.TWEET_DETAILS,
 			EResourceType.TWEET_DETAILS_ALT,
@@ -220,6 +227,7 @@ export class FetchArgs {
 	})
 	@IsString({
 		groups: [
+			EResourceType.LIST_MEMBERS,
 			EResourceType.LIST_TWEETS,
 			EResourceType.TWEET_DETAILS,
 			EResourceType.TWEET_DETAILS_ALT,
@@ -238,6 +246,7 @@ export class FetchArgs {
 	})
 	@IsNumberString(undefined, {
 		groups: [
+			EResourceType.LIST_MEMBERS,
 			EResourceType.LIST_TWEETS,
 			EResourceType.TWEET_DETAILS,
 			EResourceType.TWEET_DETAILS_ALT,
@@ -255,6 +264,41 @@ export class FetchArgs {
 	})
 	public id?: string;
 
+	/**
+	 * The type of search results to fetch. Can be one of:
+	 * - {@link EResourceType.LATEST}, for latest search results.
+	 * - {@link EResourceType.TOP}, for top search results.
+	 *
+	 * @defaultValue {@link ESearchResultType.LATEST}.
+	 *
+	 * @remarks
+	 * - Applicable only for {@link EResourceType.TWEET_SEARCH}.
+	 */
+	@IsEmpty({
+		groups: [
+			EResourceType.LIST_MEMBERS,
+			EResourceType.LIST_TWEETS,
+			EResourceType.TWEET_DETAILS,
+			EResourceType.TWEET_DETAILS_ALT,
+			EResourceType.TWEET_RETWEETERS,
+			EResourceType.USER_DETAILS_BY_USERNAME,
+			EResourceType.USER_DETAILS_BY_ID,
+			EResourceType.USER_FEED_FOLLOWED,
+			EResourceType.USER_FEED_RECOMMENDED,
+			EResourceType.USER_FOLLOWING,
+			EResourceType.USER_FOLLOWERS,
+			EResourceType.USER_HIGHLIGHTS,
+			EResourceType.USER_LIKES,
+			EResourceType.USER_MEDIA,
+			EResourceType.USER_NOTIFICATIONS,
+			EResourceType.USER_SUBSCRIPTIONS,
+			EResourceType.USER_TIMELINE,
+			EResourceType.USER_TIMELINE_AND_REPLIES,
+		],
+	})
+	@IsOptional({ groups: [EResourceType.TWEET_SEARCH] })
+	public results?: ESearchResultType;
+
 	/**
 	 * @param resource - The resource to be fetched.
 	 * @param args - Additional user-defined arguments for fetching the resource.
@@ -264,6 +308,7 @@ export class FetchArgs {
 		this.count = args.count;
 		this.cursor = args.cursor;
 		this.filter = args.filter ? new TweetFilter(args.filter) : undefined;
+		this.results = args.results;
 
 		// Validating this object
 		const validationResult = validateSync(this, { groups: [resource] });

package/src/models/data/Tweet.ts

@@ -1,5 +1,6 @@
 import {
 	EMediaType,
+	ILimitedVisibilityTweet,
 	IExtendedMedia as IRawExtendedMedia,
 	ITweet as IRawTweet,
 	IEntities as IRawTweetEntities,
@@ -77,7 +78,7 @@ export class Tweet {
 		this.tweetBy = new User(tweet.core.user_results.result);
 		this.entities = new TweetEntities(tweet.legacy.entities);
 		this.media = tweet.legacy.extended_entities?.media?.map((media) => new TweetMedia(media));
-		this.quoted = tweet.quoted_status_result ? new Tweet(tweet.quoted_status_result.result) : undefined;
+		this.quoted = this.getQuotedTweet(tweet);
 		this.fullText = tweet.note_tweet ? tweet.note_tweet.note_tweet_results.result.text : tweet.legacy.full_text;
 		this.replyTo = tweet.legacy.in_reply_to_status_id_str;
 		this.lang = tweet.legacy.lang;
@@ -87,9 +88,51 @@ export class Tweet {
 		this.likeCount = tweet.legacy.favorite_count;
 		this.viewCount = tweet.views.count ? parseInt(tweet.views.count) : 0;
 		this.bookmarkCount = tweet.legacy.bookmark_count;
-		this.retweetedTweet = tweet.legacy.retweeted_status_result?.result?.rest_id
-			? new Tweet(tweet.legacy.retweeted_status_result.result)
-			: undefined;
+		this.retweetedTweet = this.getRetweetedTweet(tweet);
+	}
+
+	/**
+	 * Extract and deserialize the original quoted tweet from the given raw tweet.
+	 *
+	 * @param tweet - The raw tweet.
+	 *
+	 * @returns - The deserialized original quoted tweet.
+	 */
+	private getQuotedTweet(tweet: IRawTweet): Tweet | undefined {
+		// If tweet with limited visibility
+		if (
+			tweet.quoted_status_result &&
+			Object.entries(tweet.quoted_status_result).length &&
+			tweet.quoted_status_result.result.__typename == 'TweetWithVisibilityResults'
+		) {
+			return new Tweet((tweet.quoted_status_result.result as ILimitedVisibilityTweet).tweet);
+		}
+		// If normal tweet
+		else if (tweet.quoted_status_result && Object.entries(tweet.quoted_status_result).length) {
+			return new Tweet(tweet.quoted_status_result.result as ITweet);
+		}
+		// Else, skip
+		else {
+			return undefined;
+		}
+	}
+
+	/**
+	 * Extract and deserialize the original retweeted tweet from the given raw tweet.
+	 *
+	 * @param tweet - The raw tweet.
+	 *
+	 * @returns - The deserialized original retweeted tweet.
+	 */
+	private getRetweetedTweet(tweet: IRawTweet): Tweet | undefined {
+		// If valid retweeted tweet
+		if (tweet.legacy.retweeted_status_result?.result?.rest_id) {
+			return new Tweet(tweet.legacy.retweeted_status_result.result);
+		}
+		// Else, skip
+		else {
+			return undefined;
+		}
 	}
 
 	/**
@@ -112,7 +155,6 @@ export class Tweet {
 			if (item.tweet_results?.result?.legacy) {
 				// Logging
 				LogService.log(ELogActions.DESERIALIZE, { id: item.tweet_results.result.rest_id });
-
 				tweets.push(new Tweet(item.tweet_results.result));
 			} else {
 				// Logging
@@ -210,6 +252,9 @@ export class TweetEntities {
  * @public
  */
 export class TweetMedia {
+	/** The thumbnail URL for the video content of the tweet. */
+	public thumbnailUrl?: string;
+
 	/** The type of media. */
 	public type: EMediaType;
 
@@ -232,6 +277,8 @@ export class TweetMedia {
 		}
 		// If the media is a video
 		else {
+			this.thumbnailUrl = media.media_url_https;
+
 			/** The highest bitrate of all variants. */
 			let highestRate: number = 0;
 

package/src/services/public/FetcherService.ts

@@ -26,19 +26,19 @@ import { AuthService } from './AuthService';
  */
 export class FetcherService {
 	/** The api key to use for authenticating against Twitter API as user. */
-	private readonly apiKey?: string;
+	private readonly _apiKey?: string;
 
 	/** The service used to handle HTTP and API errors */
-	private readonly errorHandler: IErrorHandler;
+	private readonly _errorHandler: IErrorHandler;
 
 	/** The guest key to use for authenticating against Twitter API as guest. */
-	private readonly guestKey?: string;
+	private readonly _guestKey?: string;
 
 	/** The URL To the proxy server to use for all others. */
-	private readonly proxyUrl?: URL;
+	private readonly _proxyUrl?: URL;
 
 	/** The max wait time for a response. */
-	private readonly timeout: number;
+	private readonly _timeout: number;
 
 	/** The URL to the proxy server to use only for authentication. */
 	protected readonly authProxyUrl?: URL;
@@ -51,13 +51,13 @@ export class FetcherService {
 	 */
 	public constructor(config?: IRettiwtConfig) {
 		LogService.enabled = config?.logging ?? false;
-		this.apiKey = config?.apiKey;
-		this.guestKey = config?.guestKey;
+		this._apiKey = config?.apiKey;
+		this._guestKey = config?.guestKey;
 		this.userId = config?.apiKey ? AuthService.getUserId(config.apiKey) : undefined;
 		this.authProxyUrl = config?.authProxyUrl ?? config?.proxyUrl;
-		this.proxyUrl = config?.proxyUrl;
-		this.timeout = config?.timeout ?? 0;
-		this.errorHandler = config?.errorHandler ?? new ErrorService();
+		this._proxyUrl = config?.proxyUrl;
+		this._timeout = config?.timeout ?? 0;
+		this._errorHandler = config?.errorHandler ?? new ErrorService();
 	}
 
 	/**
@@ -83,16 +83,16 @@ export class FetcherService {
 	 * @returns The generated AuthCredential
 	 */
 	private async getCredential(): Promise<AuthCredential> {
-		if (this.apiKey) {
+		if (this._apiKey) {
 			// Logging
 			LogService.log(ELogActions.GET, { target: 'USER_CREDENTIAL' });
 
-			return new AuthCredential(AuthService.decodeCookie(this.apiKey).split(';'));
-		} else if (this.guestKey) {
+			return new AuthCredential(AuthService.decodeCookie(this._apiKey).split(';'));
+		} else if (this._guestKey) {
 			// Logging
 			LogService.log(ELogActions.GET, { target: 'GUEST_CREDENTIAL' });
 
-			return new AuthCredential(undefined, this.guestKey);
+			return new AuthCredential(undefined, this._guestKey);
 		} else {
 			// Logging
 			LogService.log(ELogActions.GET, { target: 'NEW_GUEST_CREDENTIAL' });
@@ -183,7 +183,7 @@ export class FetcherService {
 		args = this.validateArgs(resource, args)!;
 
 		// Getting HTTPS agent
-		const httpsAgent: Agent = this.getHttpsAgent(this.proxyUrl);
+		const httpsAgent: Agent = this.getHttpsAgent(this._proxyUrl);
 
 		// Getting credentials from key
 		const cred: AuthCredential = await this.getCredential();
@@ -195,7 +195,7 @@ export class FetcherService {
 		config.headers = { ...config.headers, ...cred.toHeader() };
 		config.httpAgent = httpsAgent;
 		config.httpsAgent = httpsAgent;
-		config.timeout = this.timeout;
+		config.timeout = this._timeout;
 
 		// Sending the request
 		try {
@@ -203,7 +203,7 @@ export class FetcherService {
 			return (await axios<T>(config)).data;
 		} catch (error) {
 			// If error, delegate handling to error handler
-			this.errorHandler.handle(error);
+			this._errorHandler.handle(error);
 			throw error;
 		}
 	}

package/src/services/public/ListService.ts

@@ -0,0 +1,112 @@
+import { IListMembersResponse, IListTweetsResponse } from 'rettiwt-core';
+
+import { extractors } from '../../collections/Extractors';
+import { EResourceType } from '../../enums/Resource';
+import { CursoredData } from '../../models/data/CursoredData';
+import { Tweet } from '../../models/data/Tweet';
+import { User } from '../../models/data/User';
+import { IRettiwtConfig } from '../../types/RettiwtConfig';
+
+import { FetcherService } from './FetcherService';
+
+export class ListService extends FetcherService {
+	/**
+	 * @param config - The config object for configuring the Rettiwt instance.
+	 *
+	 * @internal
+	 */
+	public constructor(config?: IRettiwtConfig) {
+		super(config);
+	}
+
+	/**
+	 * Get the list of members of a tweet list.
+	 *
+	 * @param id - The id of target list.
+	 * @param count - The number of members to fetch, must be \<= 100.
+	 * @param cursor - The cursor to the batch of members to fetch.
+	 *
+	 * @returns The list tweets in the given list.
+	 *
+	 * @example
+	 * ```
+	 * import { Rettiwt } from 'rettiwt-api';
+	 *
+	 * // Creating a new Rettiwt instance using the given 'API_KEY'
+	 * const rettiwt = new Rettiwt({ apiKey: API_KEY });
+	 *
+	 * // Fetching the first 100 members of the Twitter list with id '1234567890'
+	 * rettiwt.list.members('1234567890')
+	 * .then(res => {
+	 * 	console.log(res);
+	 * })
+	 * .catch(err => {
+	 * 	console.log(err);
+	 * });
+	 * ```
+	 *
+	 * @remarks Due a bug in Twitter API, the count is ignored when no cursor is provided and defaults to 100.
+	 */
+	public async members(id: string, count?: number, cursor?: string): Promise<CursoredData<User>> {
+		const resource: EResourceType = EResourceType.LIST_MEMBERS;
+
+		// Fetching the raw list of members
+		const response = await this.request<IListMembersResponse>(resource, {
+			id: id,
+			count: count,
+			cursor: cursor,
+		});
+
+		// Deserializing response
+		const data = extractors[resource](response);
+
+		return data;
+	}
+
+	/**
+	 * Get the list of tweets from a tweet list.
+	 *
+	 * @param id - The id of target list.
+	 * @param count - The number of tweets to fetch, must be \<= 100.
+	 * @param cursor - The cursor to the batch of tweets to fetch.
+	 *
+	 * @returns The list tweets in the given list.
+	 *
+	 * @example
+	 * ```
+	 * import { Rettiwt } from 'rettiwt-api';
+	 *
+	 * // Creating a new Rettiwt instance using the given 'API_KEY'
+	 * const rettiwt = new Rettiwt({ apiKey: API_KEY });
+	 *
+	 * // Fetching the most recent 100 tweets of the Twitter list with id '1234567890'
+	 * rettiwt.list.tweets('1234567890')
+	 * .then(res => {
+	 * 	console.log(res);
+	 * })
+	 * .catch(err => {
+	 * 	console.log(err);
+	 * });
+	 * ```
+	 *
+	 * @remarks Due a bug in Twitter API, the count is ignored when no cursor is provided and defaults to 100.
+	 */
+	public async tweets(id: string, count?: number, cursor?: string): Promise<CursoredData<Tweet>> {
+		const resource = EResourceType.LIST_TWEETS;
+
+		// Fetching raw list tweets
+		const response = await this.request<IListTweetsResponse>(resource, {
+			id: id,
+			count: count,
+			cursor: cursor,
+		});
+
+		// Deserializing response
+		const data = extractors[resource](response);
+
+		// Sorting the tweets by date, from recent to oldest
+		data.list.sort((a, b) => new Date(b.createdAt).valueOf() - new Date(a.createdAt).valueOf());
+
+		return data;
+	}
+}

package/src/services/public/TweetService.ts

@@ -1,6 +1,7 @@
 import { statSync } from 'fs';
 
 import {
+	ESearchResultType,
 	IInitializeMediaUploadResponse,
 	IListTweetsResponse,
 	ITweetDetailsResponse,
@@ -398,6 +399,7 @@ export class TweetService extends FetcherService {
 	 * @param filter - The filter to be used for searching the tweets.
 	 * @param count - The number of tweets to fetch, must be \<= 20.
 	 * @param cursor - The cursor to the batch of tweets to fetch.
+	 * @param results - The type of search results to fetch. Default is {@link ESearchResultType.LATEST}.
 	 *
 	 * @returns The list of tweets that match the given filter.
 	 *
@@ -420,7 +422,12 @@ export class TweetService extends FetcherService {
 	 *
 	 * @remarks For details about available filters, refer to {@link TweetFilter}
 	 */
-	public async search(filter: TweetFilter, count?: number, cursor?: string): Promise<CursoredData<Tweet>> {
+	public async search(
+		filter: TweetFilter,
+		count?: number,
+		cursor?: string,
+		results?: ESearchResultType,
+	): Promise<CursoredData<Tweet>> {
 		const resource = EResourceType.TWEET_SEARCH;
 
 		// Fetching raw list of filtered tweets
@@ -428,6 +435,7 @@ export class TweetService extends FetcherService {
 			filter: filter,
 			count: count,
 			cursor: cursor,
+			results: results,
 		});
 
 		// Deserializing response