rettiwt-api 3.1.1 → 4.1.0-alpha.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,
@@ -19,6 +21,7 @@ import {
 	IUserHighlightsResponse,
 	IUserLikesResponse,
 	IUserMediaResponse,
+	IUserNotifications as IUserNotificationsResponse,
 	IUserRecommendedResponse,
 	IUserSubscriptionsResponse,
 	IUserTweetsAndRepliesResponse,
@@ -28,6 +31,7 @@ import {
 
 import { EBaseType } from '../enums/Data';
 import { CursoredData } from '../models/data/CursoredData';
+import { Notification } from '../models/data/Notification';
 import { Tweet } from '../models/data/Tweet';
 import { User } from '../models/data/User';
 
@@ -47,20 +51,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),
@@ -79,6 +84,8 @@ export const extractors = {
 		new CursoredData<Tweet>(response, EBaseType.TWEET),
 	USER_MEDIA: (response: IUserMediaResponse): CursoredData<Tweet> =>
 		new CursoredData<Tweet>(response, EBaseType.TWEET),
+	USER_NOTIFICATIONS: (response: IUserNotificationsResponse): CursoredData<Notification> =>
+		new CursoredData<Notification>(response, EBaseType.NOTIFICATION),
 	USER_SUBSCRIPTIONS: (response: IUserSubscriptionsResponse): CursoredData<User> =>
 		new CursoredData<User>(response, EBaseType.USER),
 	USER_TIMELINE: (response: IUserTweetsResponse): CursoredData<Tweet> =>

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,
@@ -31,6 +31,7 @@ export const fetchResources = [
 	EResourceType.USER_HIGHLIGHTS,
 	EResourceType.USER_LIKES,
 	EResourceType.USER_MEDIA,
+	EResourceType.USER_NOTIFICATIONS,
 	EResourceType.USER_SUBSCRIPTIONS,
 	EResourceType.USER_TIMELINE,
 	EResourceType.USER_TIMELINE_AND_REPLIES,
@@ -48,9 +49,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!),
@@ -46,6 +48,7 @@ export const requests: { [key in keyof typeof EResourceType]: (args: FetchArgs |
 	USER_HIGHLIGHTS: (args: FetchArgs) => request.user.highlights(args.id!, args.count, args.cursor),
 	USER_LIKES: (args: FetchArgs) => request.user.likes(args.id!, args.count, args.cursor),
 	USER_MEDIA: (args: FetchArgs) => request.user.media(args.id!, args.count, args.cursor),
+	USER_NOTIFICATIONS: (args: FetchArgs) => request.user.notifications(args.count, args.cursor),
 	USER_SUBSCRIPTIONS: (args: FetchArgs) => request.user.subscriptions(args.id!, args.count, args.cursor),
 	USER_TIMELINE: (args: FetchArgs) => request.user.tweets(args.id!, args.count, args.cursor),
 	USER_TIMELINE_AND_REPLIES: (args: FetchArgs) => request.user.tweetsAndReplies(args.id!, args.count, args.cursor),

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);
@@ -127,6 +126,20 @@ function createUserCommand(rettiwt: Rettiwt): Command {
 			}
 		});
 
+	// Notifications
+	user.command('notifications')
+		.description('Fetch you list of notifications')
+		.argument('[count]', 'The number of notifications to fetch')
+		.argument('[cursor]', 'The cursor to the batch of notifications to fetch')
+		.action(async (count?: string, cursor?: string) => {
+			try {
+				const notifications = await rettiwt.user.notifications(count ? parseInt(count) : undefined, cursor);
+				output(notifications);
+			} catch (error) {
+				output(error);
+			}
+		});
+
 	// Recommended
 	user.command('recommended')
 		.description('Fetch your recommended feed')

package/src/enums/Data.ts

@@ -4,6 +4,7 @@
  * @internal
  */
 export enum EBaseType {
+	NOTIFICATION = 'Notification',
 	TWEET = 'Tweet',
 	USER = 'User',
 }

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',
@@ -35,6 +37,7 @@ export enum EResourceType {
 	USER_HIGHLIGHTS = 'USER_HIGHLIGHTS',
 	USER_LIKES = 'USER_LIKES',
 	USER_MEDIA = 'USER_MEDIA',
+	USER_NOTIFICATIONS = 'USER_NOTIFICATIONS',
 	USER_SUBSCRIPTIONS = 'USER_SUBSCRIPTIONS',
 	USER_TIMELINE = 'USER_TIMELINE',
 	USER_TIMELINE_AND_REPLIES = 'USER_TIMELINE_AND_REPLIES',

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

@@ -27,7 +27,7 @@ export function findByFilter<T>(data: NonNullable<unknown>, key: string, value:
 		res = res.concat(...data.map((item) => findByFilter<T>(item as NonNullable<unknown>, key, value)));
 	}
 	// If the data is an object
-	else if (typeof data == 'object') {
+	else if (data != null && typeof data == 'object') {
 		/**
 		 * If the object includes the key and the value specified by the key matches the filter, add it to the result.
 		 */
@@ -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,52 @@ 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_NOTIFICATIONS,
+			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_NOTIFICATIONS,
+			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,
@@ -54,6 +94,9 @@ export class FetchArgs {
 			EResourceType.USER_SUBSCRIPTIONS,
 		],
 	})
+	@Max(40, {
+		groups: [EResourceType.USER_NOTIFICATIONS],
+	})
 	@Max(20, {
 		groups: [EResourceType.TWEET_SEARCH, EResourceType.USER_TIMELINE, EResourceType.USER_TIMELINE_AND_REPLIES],
 	})
@@ -66,8 +109,50 @@ 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_NOTIFICATIONS,
+			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_NOTIFICATIONS,
+			EResourceType.USER_SUBSCRIPTIONS,
+			EResourceType.USER_TIMELINE,
+			EResourceType.USER_TIMELINE_AND_REPLIES,
+		],
+	})
 	public cursor?: string;
 
 	/**
@@ -76,7 +161,27 @@ 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_NOTIFICATIONS,
+			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 +193,18 @@ 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,
+			EResourceType.USER_NOTIFICATIONS,
+		],
+	})
 	@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 +218,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 +261,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;