rettiwt-api 3.1.0 → 4.0.0

package/src/collections/Extractors.ts

@@ -3,14 +3,16 @@ import {
 	IListTweetsResponse,
 	ITweetDetailsResponse,
 	ITweetLikeResponse,
-	ITweetLikersResponse,
 	ITweetPostResponse,
+	ITweetRepliesResponse,
 	ITweetRetweetersResponse,
 	ITweetRetweetResponse,
+	ITweetScheduleResponse,
 	ITweetSearchResponse,
 	ITweetUnlikeResponse,
 	ITweetUnpostResponse,
 	ITweetUnretweetResponse,
+	ITweetUnscheduleResponse,
 	IUserDetailsResponse,
 	IUserFollowedResponse,
 	IUserFollowersResponse,
@@ -47,20 +49,21 @@ export const extractors = {
 		response.media_id_string ?? undefined,
 
 	TWEET_DETAILS: (response: ITweetDetailsResponse, id: string): Tweet | undefined => Tweet.single(response, id),
+	TWEET_DETAILS_ALT: (response: ITweetRepliesResponse, id: string): Tweet | undefined => Tweet.single(response, id),
 	TWEET_LIKE: (response: ITweetLikeResponse): boolean => (response?.data?.favorite_tweet ? true : false),
-	TWEET_LIKERS: (response: ITweetLikersResponse): CursoredData<User> =>
-		new CursoredData<User>(response, EBaseType.USER),
 	TWEET_POST: (response: ITweetPostResponse): string =>
 		response?.data?.create_tweet?.tweet_results?.result?.rest_id ?? undefined,
 	TWEET_RETWEET: (response: ITweetRetweetResponse): boolean => (response?.data?.create_retweet ? true : false),
 	TWEET_RETWEETERS: (response: ITweetRetweetersResponse): CursoredData<User> =>
 		new CursoredData<User>(response, EBaseType.USER),
+	TWEET_SCHEDULE: (response: ITweetScheduleResponse): string => response?.data?.tweet?.rest_id ?? undefined,
 	TWEET_SEARCH: (response: ITweetSearchResponse): CursoredData<Tweet> =>
 		new CursoredData<Tweet>(response, EBaseType.TWEET),
 	TWEET_UNLIKE: (response: ITweetUnlikeResponse): boolean => (response?.data?.unfavorite_tweet ? true : false),
 	TWEET_UNPOST: (response: ITweetUnpostResponse): boolean => (response?.data?.delete_tweet ? true : false),
 	TWEET_UNRETWEET: (response: ITweetUnretweetResponse): boolean =>
 		response?.data?.unretweet?.source_tweet_results?.result ? true : false,
+	TWEET_UNSCHEDULE: (response: ITweetUnscheduleResponse): boolean => response?.data?.scheduledtweet_delete == 'Done',
 
 	USER_DETAILS_BY_USERNAME: (response: IUserDetailsResponse): User | undefined => User.single(response),
 	USER_DETAILS_BY_ID: (response: IUserDetailsResponse): User | undefined => User.single(response),

package/src/collections/Groups.ts

@@ -19,7 +19,7 @@ export const allowGuestAuthentication = [
 export const fetchResources = [
 	EResourceType.LIST_TWEETS,
 	EResourceType.TWEET_DETAILS,
-	EResourceType.TWEET_LIKERS,
+	EResourceType.TWEET_DETAILS_ALT,
 	EResourceType.TWEET_RETWEETERS,
 	EResourceType.TWEET_SEARCH,
 	EResourceType.USER_DETAILS_BY_USERNAME,
@@ -48,9 +48,11 @@ export const postResources = [
 	EResourceType.TWEET_LIKE,
 	EResourceType.TWEET_POST,
 	EResourceType.TWEET_RETWEET,
+	EResourceType.TWEET_SCHEDULE,
 	EResourceType.TWEET_UNLIKE,
 	EResourceType.TWEET_UNPOST,
 	EResourceType.TWEET_UNRETWEET,
+	EResourceType.TWEET_UNSCHEDULE,
 	EResourceType.USER_FOLLOW,
 	EResourceType.USER_UNFOLLOW,
 ];

package/src/collections/Requests.ts

@@ -26,15 +26,17 @@ export const requests: { [key in keyof typeof EResourceType]: (args: FetchArgs |
 	MEDIA_UPLOAD_INITIALIZE: (args: PostArgs) => request.media.initializeUpload(args.upload!.size!),
 
 	TWEET_DETAILS: (args: FetchArgs) => request.tweet.details(args.id!),
+	TWEET_DETAILS_ALT: (args: FetchArgs) => request.tweet.replies(args.id!),
 	TWEET_LIKE: (args: PostArgs) => request.tweet.like(args.id!),
-	TWEET_LIKERS: (args: FetchArgs) => request.tweet.likers(args.id!, args.count, args.cursor),
 	TWEET_POST: (args: PostArgs) => request.tweet.post(args.tweet!),
 	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_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!),
+	TWEET_UNSCHEDULE: (args: PostArgs) => request.tweet.unschedule(args.id!),
 
 	USER_DETAILS_BY_USERNAME: (args: FetchArgs) => request.user.detailsByUsername(args.id!),
 	USER_DETAILS_BY_ID: (args: FetchArgs) => request.user.detailsById(args.id!),

package/src/commands/Tweet.ts

@@ -42,22 +42,6 @@ function createTweetCommand(rettiwt: Rettiwt): Command {
 			}
 		});
 
-	// Likers
-	tweet
-		.command('likers')
-		.description('Fetch the list of users who liked the given tweets')
-		.argument('<id>', 'The id of the tweet')
-		.argument('[count]', 'The number of likers to fetch')
-		.argument('[cursor]', 'The cursor to the batch of likers to fetch')
-		.action(async (id: string, count?: string, cursor?: string) => {
-			try {
-				const tweets = await rettiwt.tweet.likers(id, count ? parseInt(count) : undefined, cursor);
-				output(tweets);
-			} catch (error) {
-				output(error);
-			}
-		});
-
 	// List
 	tweet
 		.command('list')
@@ -129,6 +113,33 @@ function createTweetCommand(rettiwt: Rettiwt): Command {
 			}
 		});
 
+	// Schedule
+	tweet
+		.command('schedule')
+		.description('Schedule a tweet to be posted at a given date/time')
+		.argument('<text>', 'The text to post as a tweet')
+		.argument('<time>', 'The date/time at which the tweet is to be scheduled (valid date/time string)')
+		.option('-m, --media [string]', 'Comma-separated list of ids of the media item(s) to be posted')
+		.option('-q, --quote [string]', 'The id of the tweet to quote in the tweet to be posted')
+		.option(
+			'-r, --reply [string]',
+			'The id of the tweet to which the reply is to be made, if the tweet is to be a reply',
+		)
+		.action(async (text: string, time: string, options?: { media?: string; quote?: string; reply?: string }) => {
+			try {
+				const result = await rettiwt.tweet.schedule({
+					text: text,
+					media: options?.media ? options?.media.split(',').map((item) => ({ id: item })) : undefined,
+					quote: options?.quote,
+					replyTo: options?.reply,
+					scheduleFor: new Date(time),
+				});
+				output(result);
+			} catch (error) {
+				output(error);
+			}
+		});
+
 	// Search
 	tweet
 		.command('search')
@@ -158,8 +169,8 @@ function createTweetCommand(rettiwt: Rettiwt): Command {
 		.option('-q, --quoted <string>', 'Matches the tweets that quote the tweet with the given id')
 		.option('--exclude-links', 'Matches tweets that do not contain links')
 		.option('--exclude-replies', 'Matches the tweets that are not replies')
-		.option('-s, --start <string>', 'Matches the tweets made since the given date (valid date string)')
-		.option('-e, --end <string>', 'Matches the tweets made upto the given date (valid date string)')
+		.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('--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) => {
@@ -229,6 +240,20 @@ function createTweetCommand(rettiwt: Rettiwt): Command {
 			}
 		});
 
+	// Unschedule
+	tweet
+		.command('unschedule')
+		.description('Unschedule a tweet')
+		.argument('<id>', 'The id of the tweet')
+		.action(async (id: string) => {
+			try {
+				const result = await rettiwt.tweet.unschedule(id);
+				output(result);
+			} catch (error) {
+				output(error);
+			}
+		});
+
 	// Upload
 	tweet
 		.command('upload')

package/src/commands/User.ts

@@ -99,13 +99,12 @@ function createUserCommand(rettiwt: Rettiwt): Command {
 
 	// Likes
 	user.command('likes')
-		.description('Fetch the list of tweets liked by the given user')
-		.argument('<id>', 'The id of the user')
+		.description('Fetch your list of liked tweet')
 		.argument('[count]', 'The number of liked tweets to fetch')
 		.argument('[cursor]', 'The cursor to the batch of liked tweets to fetch')
-		.action(async (id: string, count?: string, cursor?: string) => {
+		.action(async (count?: string, cursor?: string) => {
 			try {
-				const tweets = await rettiwt.user.likes(id, count ? parseInt(count) : undefined, cursor);
+				const tweets = await rettiwt.user.likes(count ? parseInt(count) : undefined, cursor);
 				output(tweets);
 			} catch (error) {
 				output(error);

package/src/enums/Resource.ts

@@ -14,15 +14,17 @@ export enum EResourceType {
 
 	// TWEET
 	TWEET_DETAILS = 'TWEET_DETAILS',
+	TWEET_DETAILS_ALT = 'TWEET_DETAILS_ALT',
 	TWEET_LIKE = 'TWEET_LIKE',
-	TWEET_LIKERS = 'TWEET_LIKERS',
 	TWEET_POST = 'TWEET_POST',
 	TWEET_RETWEET = 'TWEET_RETWEET',
 	TWEET_RETWEETERS = 'TWEET_RETWEETERS',
+	TWEET_SCHEDULE = 'TWEET_SCHEDULE',
 	TWEET_SEARCH = 'TWEET_SEARCH',
 	TWEET_UNLIKE = 'TWEET_UNLIKE',
 	TWEET_UNPOST = 'TWEET_UNPOST',
 	TWEET_UNRETWEET = 'TWEET_UNRETWEET',
+	TWEET_UNSCHEDULE = 'TWEET_UNSCHEDULE',
 
 	// USER
 	USER_DETAILS_BY_USERNAME = 'USER_DETAILS_BY_USERNAME',

package/src/helper/CliUtils.ts

@@ -2,6 +2,8 @@
  * Outputs the given JSON data.
  *
  * @param data - The data to be output.
+ *
+ * @internal
  */
 export function output(data: unknown): void {
 	// If data is string, output as is

package/src/helper/JsonUtils.ts

@@ -52,6 +52,8 @@ export function findByFilter<T>(data: NonNullable<unknown>, key: string, value:
  * @param data - The data on which search is to be performed.
  * @param value - The value to search.
  * @returns The key with the given value.
+ *
+ * @internal
  */
 export function findKeyByValue(data: NonNullable<unknown>, value: string): string | undefined {
 	// Finding the key-value pairs that have the given value

package/src/index.ts

@@ -39,23 +39,27 @@ export {
 	IListTweetsResponse,
 	ITweetDetailsResponse,
 	ITweetLikeResponse,
-	ITweetLikersResponse,
 	ITweetPostResponse,
+	ITweetRepliesResponse,
 	ITweetRetweetersResponse,
 	ITweetRetweetResponse,
+	ITweetScheduleResponse,
 	ITweetSearchResponse,
 	ITweetUnlikeResponse,
 	ITweetUnpostResponse,
+	ITweetUnscheduleResponse,
 	ITweetUnretweetResponse,
 } from 'rettiwt-core';
 export {
 	IUserDetailsResponse,
+	IUserFollowedResponse,
 	IUserFollowersResponse,
 	IUserFollowingResponse,
 	IUserFollowResponse,
 	IUserHighlightsResponse,
 	IUserLikesResponse,
 	IUserMediaResponse,
+	IUserRecommendedResponse,
 	IUserSubscriptionsResponse,
 	IUserTweetsAndRepliesResponse,
 	IUserTweetsResponse,

package/src/models/args/FetchArgs.ts

@@ -2,6 +2,7 @@ import {
 	IsArray,
 	IsBoolean,
 	IsDate,
+	IsEmpty,
 	IsNotEmpty,
 	IsNumber,
 	IsNumberString,
@@ -9,6 +10,7 @@ import {
 	IsOptional,
 	IsString,
 	Max,
+	Min,
 	validateSync,
 } from 'class-validator';
 
@@ -37,14 +39,50 @@ export class FetchArgs {
 	 * - Has not effect for:
 	 * 	- {@link EResourceType.USER_FEED_FOLLOWED}
 	 * 	- {@link EResourceType.USER_FEED_RECOMMENDED}
-	 *
-	 * @defaultValue 20
 	 */
-	@IsOptional({ groups: [EResourceType.USER_FEED_FOLLOWED, EResourceType.USER_FEED_RECOMMENDED] })
+	@IsEmpty({
+		groups: [
+			EResourceType.TWEET_DETAILS,
+			EResourceType.TWEET_DETAILS_ALT,
+			EResourceType.USER_DETAILS_BY_ID,
+			EResourceType.USER_DETAILS_BY_USERNAME,
+			EResourceType.USER_FEED_FOLLOWED,
+			EResourceType.USER_FEED_RECOMMENDED,
+		],
+	})
+	@IsOptional({
+		groups: [
+			EResourceType.LIST_TWEETS,
+			EResourceType.TWEET_RETWEETERS,
+			EResourceType.TWEET_SEARCH,
+			EResourceType.USER_FOLLOWERS,
+			EResourceType.USER_FOLLOWING,
+			EResourceType.USER_HIGHLIGHTS,
+			EResourceType.USER_LIKES,
+			EResourceType.USER_MEDIA,
+			EResourceType.USER_SUBSCRIPTIONS,
+			EResourceType.USER_TIMELINE,
+			EResourceType.USER_TIMELINE_AND_REPLIES,
+		],
+	})
+	@Min(1, {
+		groups: [
+			EResourceType.LIST_TWEETS,
+			EResourceType.TWEET_RETWEETERS,
+			EResourceType.TWEET_SEARCH,
+			EResourceType.USER_FOLLOWERS,
+			EResourceType.USER_FOLLOWING,
+			EResourceType.USER_HIGHLIGHTS,
+			EResourceType.USER_LIKES,
+			EResourceType.USER_MEDIA,
+			EResourceType.USER_SUBSCRIPTIONS,
+			EResourceType.USER_TIMELINE,
+			EResourceType.USER_TIMELINE_AND_REPLIES,
+		],
+	})
 	@Max(100, {
 		groups: [
 			EResourceType.LIST_TWEETS,
-			EResourceType.TWEET_LIKERS,
 			EResourceType.TWEET_RETWEETERS,
 			EResourceType.USER_FOLLOWERS,
 			EResourceType.USER_FOLLOWING,
@@ -66,8 +104,48 @@ export class FetchArgs {
 	 * - May be used for cursored resources.
 	 * - Has no effect for other resources.
 	 */
-	@IsOptional()
-	@IsString()
+	@IsEmpty({
+		groups: [
+			EResourceType.TWEET_DETAILS,
+			EResourceType.TWEET_DETAILS_ALT,
+			EResourceType.USER_DETAILS_BY_ID,
+			EResourceType.USER_DETAILS_BY_USERNAME,
+		],
+	})
+	@IsOptional({
+		groups: [
+			EResourceType.LIST_TWEETS,
+			EResourceType.TWEET_RETWEETERS,
+			EResourceType.TWEET_SEARCH,
+			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_SUBSCRIPTIONS,
+			EResourceType.USER_TIMELINE,
+			EResourceType.USER_TIMELINE_AND_REPLIES,
+		],
+	})
+	@IsString({
+		groups: [
+			EResourceType.LIST_TWEETS,
+			EResourceType.TWEET_RETWEETERS,
+			EResourceType.TWEET_SEARCH,
+			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_SUBSCRIPTIONS,
+			EResourceType.USER_TIMELINE,
+			EResourceType.USER_TIMELINE_AND_REPLIES,
+		],
+	})
 	public cursor?: string;
 
 	/**
@@ -76,7 +154,26 @@ export class FetchArgs {
 	 * @remarks
 	 * Required when searching for tweets using {@link EResourceType.TWEET_SEARCH}.
 	 */
-	@IsOptional()
+	@IsEmpty({
+		groups: [
+			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_SUBSCRIPTIONS,
+			EResourceType.USER_TIMELINE,
+			EResourceType.USER_TIMELINE_AND_REPLIES,
+		],
+	})
 	@IsNotEmpty({ groups: [EResourceType.TWEET_SEARCH] })
 	@IsObject({ groups: [EResourceType.TWEET_SEARCH] })
 	public filter?: TweetFilter;
@@ -88,12 +185,14 @@ export class FetchArgs {
 	 * - Required for all resources except {@link EResourceType.TWEET_SEARCH} and {@link EResourceType.USER_TIMELINE_RECOMMENDED}.
 	 * - For {@link EResourceType.USER_DETAILS_BY_USERNAME}, can be alphanumeric, while for others, is strictly numeric.
 	 */
-	@IsOptional()
+	@IsEmpty({
+		groups: [EResourceType.USER_FEED_FOLLOWED, EResourceType.USER_FEED_RECOMMENDED],
+	})
 	@IsNotEmpty({
 		groups: [
 			EResourceType.LIST_TWEETS,
 			EResourceType.TWEET_DETAILS,
-			EResourceType.TWEET_LIKERS,
+			EResourceType.TWEET_DETAILS_ALT,
 			EResourceType.TWEET_RETWEETERS,
 			EResourceType.USER_DETAILS_BY_USERNAME,
 			EResourceType.USER_DETAILS_BY_ID,
@@ -107,11 +206,29 @@ export class FetchArgs {
 			EResourceType.USER_TIMELINE_AND_REPLIES,
 		],
 	})
+	@IsString({
+		groups: [
+			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_FOLLOWING,
+			EResourceType.USER_FOLLOWERS,
+			EResourceType.USER_HIGHLIGHTS,
+			EResourceType.USER_LIKES,
+			EResourceType.USER_MEDIA,
+			EResourceType.USER_SUBSCRIPTIONS,
+			EResourceType.USER_TIMELINE,
+			EResourceType.USER_TIMELINE_AND_REPLIES,
+		],
+	})
 	@IsNumberString(undefined, {
 		groups: [
 			EResourceType.LIST_TWEETS,
 			EResourceType.TWEET_DETAILS,
-			EResourceType.TWEET_LIKERS,
+			EResourceType.TWEET_DETAILS_ALT,
 			EResourceType.TWEET_RETWEETERS,
 			EResourceType.USER_DETAILS_BY_ID,
 			EResourceType.USER_FOLLOWERS,
@@ -132,7 +249,7 @@ export class FetchArgs {
 	 */
 	public constructor(resource: EResourceType, args: FetchArgs) {
 		this.id = args.id;
-		this.count = args.count ?? 20;
+		this.count = args.count;
 		this.cursor = args.cursor;
 		this.filter = args.filter ? new TweetFilter(args.filter) : undefined;
 

package/src/models/args/PostArgs.ts

@@ -1,6 +1,8 @@
 import {
 	ArrayMaxSize,
 	IsArray,
+	IsDate,
+	IsEmpty,
 	IsNotEmpty,
 	IsNumberString,
 	IsObject,
@@ -8,6 +10,7 @@ import {
 	IsString,
 	Max,
 	MaxLength,
+	MinDate,
 	validateSync,
 } from 'class-validator';
 
@@ -35,7 +38,15 @@ export class PostArgs {
 	 * - {@link EResourceType.USER_FOLLOW}
 	 * - {@link EResourceType.USER_UNFOLLOW}
 	 */
-	@IsOptional()
+	@IsEmpty({
+		groups: [
+			EResourceType.MEDIA_UPLOAD_APPEND,
+			EResourceType.MEDIA_UPLOAD_FINALIZE,
+			EResourceType.MEDIA_UPLOAD_INITIALIZE,
+			EResourceType.TWEET_POST,
+			EResourceType.TWEET_SCHEDULE,
+		],
+	})
 	@IsNotEmpty({
 		groups: [
 			EResourceType.TWEET_LIKE,
@@ -43,6 +54,7 @@ export class PostArgs {
 			EResourceType.TWEET_UNLIKE,
 			EResourceType.TWEET_UNPOST,
 			EResourceType.TWEET_UNRETWEET,
+			EResourceType.TWEET_UNSCHEDULE,
 			EResourceType.USER_FOLLOW,
 			EResourceType.USER_UNFOLLOW,
 		],
@@ -54,6 +66,7 @@ export class PostArgs {
 			EResourceType.TWEET_UNLIKE,
 			EResourceType.TWEET_UNPOST,
 			EResourceType.TWEET_UNRETWEET,
+			EResourceType.TWEET_UNSCHEDULE,
 			EResourceType.USER_FOLLOW,
 			EResourceType.USER_UNFOLLOW,
 		],
@@ -66,9 +79,23 @@ export class PostArgs {
 	 * @remarks
 	 * Required only when posting a tweet using {@link EResourceType.TWEET_POST}
 	 */
-	@IsOptional()
-	@IsNotEmpty({ groups: [EResourceType.TWEET_POST] })
-	@IsObject({ groups: [EResourceType.TWEET_POST] })
+	@IsEmpty({
+		groups: [
+			EResourceType.MEDIA_UPLOAD_APPEND,
+			EResourceType.MEDIA_UPLOAD_FINALIZE,
+			EResourceType.MEDIA_UPLOAD_INITIALIZE,
+			EResourceType.TWEET_LIKE,
+			EResourceType.TWEET_RETWEET,
+			EResourceType.TWEET_UNLIKE,
+			EResourceType.TWEET_UNPOST,
+			EResourceType.TWEET_UNRETWEET,
+			EResourceType.TWEET_UNSCHEDULE,
+			EResourceType.USER_FOLLOW,
+			EResourceType.USER_UNFOLLOW,
+		],
+	})
+	@IsNotEmpty({ groups: [EResourceType.TWEET_POST, EResourceType.TWEET_SCHEDULE] })
+	@IsObject({ groups: [EResourceType.TWEET_POST, EResourceType.TWEET_SCHEDULE] })
 	public tweet?: TweetArgs;
 
 	/**
@@ -80,7 +107,13 @@ export class PostArgs {
 	 * - {@link EResourceType.MEDIA_UPLOAD_FINALIZE}
 	 * - {@link EResourceType.MEDIA_UPLOAD_INITIALIZE}
 	 */
-	@IsOptional()
+	@IsEmpty({
+		groups: [
+			EResourceType.MEDIA_UPLOAD_APPEND,
+			EResourceType.MEDIA_UPLOAD_FINALIZE,
+			EResourceType.MEDIA_UPLOAD_INITIALIZE,
+		],
+	})
 	@IsNotEmpty({
 		groups: [
 			EResourceType.MEDIA_UPLOAD_INITIALIZE,
@@ -103,7 +136,7 @@ export class PostArgs {
 	 */
 	public constructor(resource: EResourceType, args: PostArgs) {
 		this.id = args.id;
-		this.tweet = args.tweet ? new TweetArgs(args.tweet) : undefined;
+		this.tweet = args.tweet ? new TweetArgs(resource, args.tweet) : undefined;
 		this.upload = args.upload ? new UploadArgs(resource, args.upload) : undefined;
 
 		// Validating this object
@@ -128,45 +161,53 @@ export class TweetArgs extends NewTweet {
 	 * @remarks
 	 * Maximum number of media items that can be posted is 4.
 	 */
-	@IsOptional()
-	@IsArray()
-	@ArrayMaxSize(4)
-	@IsObject({ each: true })
+	@IsOptional({ groups: [EResourceType.TWEET_POST, EResourceType.TWEET_SCHEDULE] })
+	@IsArray({ groups: [EResourceType.TWEET_POST, EResourceType.TWEET_SCHEDULE] })
+	@ArrayMaxSize(4, { groups: [EResourceType.TWEET_POST, EResourceType.TWEET_SCHEDULE] })
+	@IsObject({ each: true, groups: [EResourceType.TWEET_POST, EResourceType.TWEET_SCHEDULE] })
 	public media?: TweetMediaArgs[];
 
 	/** The id of the tweet to quote. */
-	@IsOptional()
-	@IsNumberString()
+	@IsOptional({ groups: [EResourceType.TWEET_POST, EResourceType.TWEET_SCHEDULE] })
+	@IsNumberString(undefined, { groups: [EResourceType.TWEET_POST, EResourceType.TWEET_SCHEDULE] })
 	public quote?: string;
 
 	/** The id of the tweet to which the given tweet must be a reply. */
-	@IsOptional()
-	@IsNumberString()
+	@IsOptional({ groups: [EResourceType.TWEET_POST, EResourceType.TWEET_SCHEDULE] })
+	@IsNumberString(undefined, { groups: [EResourceType.TWEET_POST, EResourceType.TWEET_SCHEDULE] })
 	public replyTo?: string;
 
+	/** The date/time at which the tweet must be scheduled to be posted. */
+	@IsEmpty({ groups: [EResourceType.TWEET_POST] })
+	@IsNotEmpty({ groups: [EResourceType.TWEET_SCHEDULE] })
+	@IsDate({ groups: [EResourceType.TWEET_SCHEDULE] })
+	@MinDate(() => new Date(), { groups: [EResourceType.TWEET_SCHEDULE] })
+	public scheduleFor?: Date;
+
 	/**
 	 * The text for the tweet to be created.
 	 *
 	 * @remarks
 	 * Length of the tweet must be \<= 280 characters.
 	 */
-	@IsNotEmpty()
-	@IsString()
-	@MaxLength(280)
+	@IsNotEmpty({ groups: [EResourceType.TWEET_POST, EResourceType.TWEET_SCHEDULE] })
+	@IsString({ groups: [EResourceType.TWEET_POST, EResourceType.TWEET_SCHEDULE] })
+	@MaxLength(280, { groups: [EResourceType.TWEET_POST, EResourceType.TWEET_SCHEDULE] })
 	public text: string;
 
 	/**
 	 * @param args - Arguments specifying the tweet to be posted.
 	 */
-	public constructor(args: TweetArgs) {
+	public constructor(resource: EResourceType, args: TweetArgs) {
 		super();
-		this.text = args.text;
-		this.quote = args.quote;
 		this.media = args.media ? args.media.map((item) => new TweetMediaArgs(item)) : undefined;
+		this.quote = args.quote;
 		this.replyTo = args.replyTo;
+		this.scheduleFor = args.scheduleFor;
+		this.text = args.text;
 
 		// Validating this object
-		const validationResult = validateSync(this);
+		const validationResult = validateSync(this, { groups: [resource] });
 
 		// If valiation error occured
 		if (validationResult.length) {
@@ -223,13 +264,13 @@ export class TweetMediaArgs extends NewTweetMedia {
  */
 export class UploadArgs {
 	/** The id allocated to the media file to be uploaded. */
-	@IsOptional()
+	@IsEmpty({ groups: [EResourceType.MEDIA_UPLOAD_INITIALIZE] })
 	@IsNotEmpty({ groups: [EResourceType.MEDIA_UPLOAD_APPEND, EResourceType.MEDIA_UPLOAD_FINALIZE] })
 	@IsNumberString(undefined, { groups: [EResourceType.MEDIA_UPLOAD_APPEND, EResourceType.MEDIA_UPLOAD_FINALIZE] })
 	public id?: string;
 
 	/** The media file to be uploaded. */
-	@IsOptional()
+	@IsEmpty({ groups: [EResourceType.MEDIA_UPLOAD_FINALIZE, EResourceType.MEDIA_UPLOAD_INITIALIZE] })
 	@IsNotEmpty({ groups: [EResourceType.MEDIA_UPLOAD_APPEND] })
 	public media?: string | ArrayBuffer;
 
@@ -238,7 +279,7 @@ export class UploadArgs {
 	 *
 	 * @remarks The size must be \<= 5242880 bytes.
 	 */
-	@IsOptional()
+	@IsEmpty({ groups: [EResourceType.MEDIA_UPLOAD_APPEND, EResourceType.MEDIA_UPLOAD_FINALIZE] })
 	@IsNotEmpty({ groups: [EResourceType.MEDIA_UPLOAD_INITIALIZE] })
 	@Max(5242880, { groups: [EResourceType.MEDIA_UPLOAD_INITIALIZE] })
 	public size?: number;

package/src/models/data/Tweet.ts

@@ -48,8 +48,8 @@ export class Tweet {
 	/** The number of quotes of the tweet. */
 	public quoteCount: number;
 
-	/** The rest id of the tweet which is quoted in the tweet. */
-	public quoted?: string;
+	/** The tweet which is quoted in the tweet. */
+	public quoted?: Tweet;
 
 	/** The number of replies to the tweet. */
 	public replyCount: number;
@@ -60,7 +60,7 @@ export class Tweet {
 	/** The number of retweets of the tweet. */
 	public retweetCount: number;
 
-	/** The tweet which was retweeted in this tweet (if any). */
+	/** The tweet which is retweeted in this tweet (if any). */
 	public retweetedTweet?: Tweet;
 
 	/** The details of the user who made the tweet. */
@@ -78,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.legacy.quoted_status_id_str;
+		this.quoted = tweet.quoted_status_result ? new Tweet(tweet.quoted_status_result.result) : undefined;
 		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;