rettiwt-api 6.0.8 → 6.1.1

package/playground/package.json

@@ -0,0 +1,15 @@
+{
+	"name": "rettiwt-playground",
+	"version": "1.0.0",
+	"description": "A playground for testing Rettiwt-API features and functionalities.",
+	"main": "index.js",
+	"type": "module",
+	"scripts": {
+		"start": "node index.js",
+		"test": "echo \"No tests specified\" && exit 0"
+	},
+	"dependencies": {
+		"dotenv": "^17.2.0",
+		"rettiwt-api": "workspace"
+	}
+}

package/src/Rettiwt.ts

@@ -1,4 +1,5 @@
 import { RettiwtConfig } from './models/RettiwtConfig';
+import { DirectMessageService } from './services/public/DirectMessageService';
 import { ListService } from './services/public/ListService';
 import { TweetService } from './services/public/TweetService';
 import { UserService } from './services/public/UserService';
@@ -49,6 +50,9 @@ export class Rettiwt {
 	/** The configuration for Rettiwt. */
 	private _config: RettiwtConfig;
 
+	/** The instance used to fetch data related to direct messages. */
+	public dm: DirectMessageService;
+
 	/** The instance used to fetch data related to lists. */
 	public list: ListService;
 
@@ -65,6 +69,7 @@ export class Rettiwt {
 	 */
 	public constructor(config?: IRettiwtConfig) {
 		this._config = new RettiwtConfig(config);
+		this.dm = new DirectMessageService(this._config);
 		this.list = new ListService(this._config);
 		this.tweet = new TweetService(this._config);
 		this.user = new UserService(this._config);

package/src/cli.ts

@@ -2,6 +2,7 @@
 
 import { createCommand } from 'commander';
 
+import dm from './commands/DirectMessage';
 import list from './commands/List';
 import tweet from './commands/Tweet';
 import user from './commands/User';
@@ -38,6 +39,7 @@ const RettiwtInstance = new Rettiwt({
 });
 
 // Adding sub-commands
+Program.addCommand(dm(RettiwtInstance));
 Program.addCommand(list(RettiwtInstance));
 Program.addCommand(tweet(RettiwtInstance));
 Program.addCommand(user(RettiwtInstance));

package/src/collections/Extractors.ts

@@ -1,11 +1,22 @@
 import { BaseType } from '../enums/Data';
+import { Analytics } from '../models/data/Analytics';
+import { Conversation } from '../models/data/Conversation';
 import { CursoredData } from '../models/data/CursoredData';
+import { Inbox } from '../models/data/Inbox';
+import { List } from '../models/data/List';
 import { Notification } from '../models/data/Notification';
 import { Tweet } from '../models/data/Tweet';
 import { User } from '../models/data/User';
+import { IConversationTimelineResponse } from '../types/raw/dm/Conversation';
+import { IInboxInitialResponse } from '../types/raw/dm/InboxInitial';
+import { IInboxTimelineResponse } from '../types/raw/dm/InboxTimeline';
+import { IListMemberAddResponse } from '../types/raw/list/AddMember';
+import { IListDetailsResponse } from '../types/raw/list/Details';
 import { IListMembersResponse } from '../types/raw/list/Members';
+import { IListMemberRemoveResponse } from '../types/raw/list/RemoveMember';
 import { IListTweetsResponse } from '../types/raw/list/Tweets';
 import { IMediaInitializeUploadResponse } from '../types/raw/media/InitalizeUpload';
+import { ITweetBookmarkResponse } from '../types/raw/tweet/Bookmark';
 import { ITweetDetailsResponse } from '../types/raw/tweet/Details';
 import { ITweetDetailsBulkResponse } from '../types/raw/tweet/DetailsBulk';
 import { ITweetLikeResponse } from '../types/raw/tweet/Like';
@@ -16,11 +27,13 @@ import { ITweetRetweetResponse } from '../types/raw/tweet/Retweet';
 import { ITweetRetweetersResponse } from '../types/raw/tweet/Retweeters';
 import { ITweetScheduleResponse } from '../types/raw/tweet/Schedule';
 import { ITweetSearchResponse } from '../types/raw/tweet/Search';
+import { ITweetUnbookmarkResponse } from '../types/raw/tweet/Unbookmark';
 import { ITweetUnlikeResponse } from '../types/raw/tweet/Unlike';
 import { ITweetUnpostResponse } from '../types/raw/tweet/Unpost';
 import { ITweetUnretweetResponse } from '../types/raw/tweet/Unretweet';
 import { ITweetUnscheduleResponse } from '../types/raw/tweet/Unschedule';
 import { IUserAffiliatesResponse } from '../types/raw/user/Affiliates';
+import { IUserAnalyticsResponse } from '../types/raw/user/Analytics';
 import { IUserBookmarksResponse } from '../types/raw/user/Bookmarks';
 import { IUserDetailsResponse } from '../types/raw/user/Details';
 import { IUserDetailsBulkResponse } from '../types/raw/user/DetailsBulk';
@@ -30,6 +43,7 @@ import { IUserFollowersResponse } from '../types/raw/user/Followers';
 import { IUserFollowingResponse } from '../types/raw/user/Following';
 import { IUserHighlightsResponse } from '../types/raw/user/Highlights';
 import { IUserLikesResponse } from '../types/raw/user/Likes';
+import { IUserListsResponse } from '../types/raw/user/Lists';
 import { IUserMediaResponse } from '../types/raw/user/Media';
 import { IUserNotificationsResponse } from '../types/raw/user/Notifications';
 import { IUserRecommendedResponse } from '../types/raw/user/Recommended';
@@ -46,8 +60,13 @@ import { IUserUnfollowResponse } from '../types/raw/user/Unfollow';
 export const Extractors = {
 	/* eslint-disable @typescript-eslint/naming-convention */
 
+	LIST_DETAILS: (response: IListDetailsResponse, id: string): List | undefined => List.single(response, id),
 	LIST_MEMBERS: (response: IListMembersResponse): CursoredData<User> =>
 		new CursoredData<User>(response, BaseType.USER),
+	LIST_MEMBER_ADD: (response: IListMemberAddResponse): number | undefined =>
+		response.data?.list?.member_count ?? undefined,
+	LIST_MEMBER_REMOVE: (response: IListMemberRemoveResponse): number | undefined =>
+		response.data?.list?.member_count ?? undefined,
 	LIST_TWEETS: (response: IListTweetsResponse): CursoredData<Tweet> =>
 		new CursoredData<Tweet>(response, BaseType.TWEET),
 
@@ -56,6 +75,12 @@ export const Extractors = {
 	MEDIA_UPLOAD_INITIALIZE: (response: IMediaInitializeUploadResponse): string =>
 		response.media_id_string ?? undefined,
 
+	DM_CONVERSATION: (response: IConversationTimelineResponse): Conversation | undefined =>
+		Conversation.fromConversationTimeline(response),
+	DM_INBOX_INITIAL_STATE: (response: IInboxInitialResponse): Inbox => new Inbox(response),
+	DM_INBOX_TIMELINE: (response: IInboxTimelineResponse): Inbox => new Inbox(response),
+
+	TWEET_BOOKMARK: (response: ITweetBookmarkResponse): boolean => response?.data?.tweet_bookmark_put === 'Done',
 	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_DETAILS_BULK: (response: ITweetDetailsBulkResponse, ids: string[]): Tweet[] => Tweet.multiple(response, ids),
@@ -72,6 +97,7 @@ export const Extractors = {
 	TWEET_SCHEDULE: (response: ITweetScheduleResponse): string => response?.data?.tweet?.rest_id ?? undefined,
 	TWEET_SEARCH: (response: ITweetSearchResponse): CursoredData<Tweet> =>
 		new CursoredData<Tweet>(response, BaseType.TWEET),
+	TWEET_UNBOOKMARK: (response: ITweetUnbookmarkResponse): boolean => response?.data?.tweet_bookmark_delete === 'Done',
 	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 =>
@@ -80,6 +106,8 @@ export const Extractors = {
 
 	USER_AFFILIATES: (response: IUserAffiliatesResponse): CursoredData<User> =>
 		new CursoredData<User>(response, BaseType.USER),
+	USER_ANALYTICS: (response: IUserAnalyticsResponse): Analytics =>
+		new Analytics(response.data.viewer_v2.user_results.result),
 	USER_BOOKMARKS: (response: IUserBookmarksResponse): CursoredData<Tweet> =>
 		new CursoredData<Tweet>(response, BaseType.TWEET),
 	USER_DETAILS_BY_USERNAME: (response: IUserDetailsResponse): User | undefined => User.single(response),
@@ -97,6 +125,7 @@ export const Extractors = {
 		new CursoredData<User>(response, BaseType.USER),
 	USER_HIGHLIGHTS: (response: IUserHighlightsResponse): CursoredData<Tweet> =>
 		new CursoredData<Tweet>(response, BaseType.TWEET),
+	USER_LISTS: (response: IUserListsResponse): CursoredData<List> => new CursoredData<List>(response, BaseType.LIST),
 	USER_LIKES: (response: IUserLikesResponse): CursoredData<Tweet> =>
 		new CursoredData<Tweet>(response, BaseType.TWEET),
 	USER_MEDIA: (response: IUserMediaResponse): CursoredData<Tweet> =>

package/src/collections/Groups.ts

@@ -17,8 +17,12 @@ export const AllowGuestAuthenticationGroup = [
  * @internal
  */
 export const FetchResourcesGroup = [
+	ResourceType.LIST_DETAILS,
 	ResourceType.LIST_MEMBERS,
 	ResourceType.LIST_TWEETS,
+	ResourceType.DM_CONVERSATION,
+	ResourceType.DM_INBOX_INITIAL_STATE,
+	ResourceType.DM_INBOX_TIMELINE,
 	ResourceType.TWEET_DETAILS,
 	ResourceType.TWEET_DETAILS_ALT,
 	ResourceType.TWEET_DETAILS_BULK,
@@ -27,6 +31,7 @@ export const FetchResourcesGroup = [
 	ResourceType.TWEET_RETWEETERS,
 	ResourceType.TWEET_SEARCH,
 	ResourceType.USER_AFFILIATES,
+	ResourceType.USER_ANALYTICS,
 	ResourceType.USER_BOOKMARKS,
 	ResourceType.USER_DETAILS_BY_USERNAME,
 	ResourceType.USER_DETAILS_BY_ID,
@@ -37,6 +42,7 @@ export const FetchResourcesGroup = [
 	ResourceType.USER_FOLLOWERS,
 	ResourceType.USER_HIGHLIGHTS,
 	ResourceType.USER_LIKES,
+	ResourceType.USER_LISTS,
 	ResourceType.USER_MEDIA,
 	ResourceType.USER_NOTIFICATIONS,
 	ResourceType.USER_SUBSCRIPTIONS,
@@ -50,13 +56,18 @@ export const FetchResourcesGroup = [
  * @internal
  */
 export const PostResourcesGroup = [
+	ResourceType.LIST_MEMBER_ADD,
+	ResourceType.LIST_MEMBER_REMOVE,
 	ResourceType.MEDIA_UPLOAD_APPEND,
 	ResourceType.MEDIA_UPLOAD_FINALIZE,
 	ResourceType.MEDIA_UPLOAD_INITIALIZE,
+	ResourceType.DM_DELETE_CONVERSATION,
+	ResourceType.TWEET_BOOKMARK,
 	ResourceType.TWEET_LIKE,
 	ResourceType.TWEET_POST,
 	ResourceType.TWEET_RETWEET,
 	ResourceType.TWEET_SCHEDULE,
+	ResourceType.TWEET_UNBOOKMARK,
 	ResourceType.TWEET_UNLIKE,
 	ResourceType.TWEET_UNPOST,
 	ResourceType.TWEET_UNRETWEET,

package/src/collections/Requests.ts

@@ -1,6 +1,7 @@
 import { AxiosRequestConfig } from 'axios';
 
 import { ResourceType } from '../enums/Resource';
+import { DMRequests } from '../requests/DirectMessage';
 import { ListRequests } from '../requests/List';
 import { MediaRequests } from '../requests/Media';
 import { TweetRequests } from '../requests/Tweet';
@@ -18,13 +19,22 @@ import { TweetRepliesSortTypeMap } from './Tweet';
 export const Requests: { [key in keyof typeof ResourceType]: (args: IFetchArgs | IPostArgs) => AxiosRequestConfig } = {
 	/* eslint-disable @typescript-eslint/naming-convention */
 
+	LIST_DETAILS: (args: IFetchArgs) => ListRequests.details(args.id!),
 	LIST_MEMBERS: (args: IFetchArgs) => ListRequests.members(args.id!, args.count, args.cursor),
+	LIST_MEMBER_ADD: (args: IPostArgs) => ListRequests.addMember(args.id!, args.userId!),
+	LIST_MEMBER_REMOVE: (args: IPostArgs) => ListRequests.removeMember(args.id!, args.userId!),
 	LIST_TWEETS: (args: IFetchArgs) => ListRequests.tweets(args.id!, args.count, args.cursor),
 
 	MEDIA_UPLOAD_APPEND: (args: IPostArgs) => MediaRequests.appendUpload(args.upload!.id!, args.upload!.media!),
 	MEDIA_UPLOAD_FINALIZE: (args: IPostArgs) => MediaRequests.finalizeUpload(args.upload!.id!),
 	MEDIA_UPLOAD_INITIALIZE: (args: IPostArgs) => MediaRequests.initializeUpload(args.upload!.size!),
 
+	DM_CONVERSATION: (args: IFetchArgs) => DMRequests.conversation(args.conversationId!, args.maxId),
+	DM_INBOX_INITIAL_STATE: () => DMRequests.inboxInitial(),
+	DM_INBOX_TIMELINE: (args: IFetchArgs) => DMRequests.inboxTimeline(args.maxId),
+	DM_DELETE_CONVERSATION: (args: IPostArgs) => DMRequests.deleteConversation(args.conversationId!),
+
+	TWEET_BOOKMARK: (args: IPostArgs) => TweetRequests.bookmark(args.id!),
 	TWEET_DETAILS: (args: IFetchArgs) => TweetRequests.details(args.id!),
 	TWEET_DETAILS_ALT: (args: IFetchArgs) => TweetRequests.replies(args.id!),
 	TWEET_DETAILS_BULK: (args: IFetchArgs) => TweetRequests.bulkDetails(args.ids!),
@@ -37,12 +47,21 @@ export const Requests: { [key in keyof typeof ResourceType]: (args: IFetchArgs |
 	TWEET_RETWEETERS: (args: IFetchArgs) => TweetRequests.retweeters(args.id!, args.count, args.cursor),
 	TWEET_SCHEDULE: (args: IPostArgs) => TweetRequests.schedule(args.tweet!),
 	TWEET_SEARCH: (args: IFetchArgs) => TweetRequests.search(args.filter!, args.count, args.cursor),
+	TWEET_UNBOOKMARK: (args: IPostArgs) => TweetRequests.unbookmark(args.id!),
 	TWEET_UNLIKE: (args: IPostArgs) => TweetRequests.unlike(args.id!),
 	TWEET_UNPOST: (args: IPostArgs) => TweetRequests.unpost(args.id!),
 	TWEET_UNRETWEET: (args: IPostArgs) => TweetRequests.unretweet(args.id!),
 	TWEET_UNSCHEDULE: (args: IPostArgs) => TweetRequests.unschedule(args.id!),
 
 	USER_AFFILIATES: (args: IFetchArgs) => UserRequests.affiliates(args.id!, args.count, args.cursor),
+	USER_ANALYTICS: (args: IFetchArgs) =>
+		UserRequests.analytics(
+			args.fromTime!,
+			args.toTime!,
+			args.granularity!,
+			args.metrics!,
+			args.showVerifiedFollowers!,
+		),
 	USER_BOOKMARKS: (args: IFetchArgs) => UserRequests.bookmarks(args.count, args.cursor),
 	USER_DETAILS_BY_USERNAME: (args: IFetchArgs) => UserRequests.detailsByUsername(args.id!),
 	USER_DETAILS_BY_ID: (args: IFetchArgs) => UserRequests.detailsById(args.id!),
@@ -54,6 +73,7 @@ export const Requests: { [key in keyof typeof ResourceType]: (args: IFetchArgs |
 	USER_FOLLOWERS: (args: IFetchArgs) => UserRequests.followers(args.id!, args.count, args.cursor),
 	USER_HIGHLIGHTS: (args: IFetchArgs) => UserRequests.highlights(args.id!, args.count, args.cursor),
 	USER_LIKES: (args: IFetchArgs) => UserRequests.likes(args.id!, args.count, args.cursor),
+	USER_LISTS: (args: IFetchArgs) => UserRequests.lists(args.id!, args.count, args.cursor),
 	USER_MEDIA: (args: IFetchArgs) => UserRequests.media(args.id!, args.count, args.cursor),
 	USER_NOTIFICATIONS: (args: IFetchArgs) => UserRequests.notifications(args.count, args.cursor),
 	USER_SUBSCRIPTIONS: (args: IFetchArgs) => UserRequests.subscriptions(args.id!, args.count, args.cursor),

package/src/commands/DirectMessage.ts

@@ -0,0 +1,62 @@
+import { Command, createCommand } from 'commander';
+
+import { output } from '../helper/CliUtils';
+import { Rettiwt } from '../Rettiwt';
+
+/**
+ * Creates a new 'dm' command which uses the given Rettiwt instance.
+ *
+ * @param rettiwt - The Rettiwt instance to use.
+ * @returns The created 'dm' command.
+ */
+function createDirectMessageCommand(rettiwt: Rettiwt): Command {
+	// Creating the 'dm' command
+	const dm = createCommand('dm').description('Access resources related to direct messages');
+
+	// Conversation
+	dm.command('conversation')
+		.description('Get the full conversation history for a specific conversation')
+		.argument('<conversation-id>', 'The ID of the conversation (e.g., "394028042-1712730991884689408")')
+		.argument('[cursor]', 'The cursor for pagination (maxId from previous response)')
+		.action(async (conversationId: string, cursor?: string) => {
+			try {
+				const conversation = await rettiwt.dm.conversation(conversationId, cursor);
+				output(conversation);
+			} catch (error) {
+				output(error);
+			}
+		});
+
+	// Delete conversation
+	dm.command('delete-conversation')
+		.description('Delete a conversation (you will leave the conversation and it will be removed from your inbox)')
+		.argument('<conversation-id>', 'The ID of the conversation to delete')
+		.action(async (conversationId: string) => {
+			try {
+				await rettiwt.dm.deleteConversation(conversationId);
+				output({ success: true, message: 'Conversation deleted successfully' });
+			} catch (error) {
+				output(error);
+			}
+		});
+
+	// Inbox
+	dm.command('inbox')
+		.description('Get your DM inbox')
+		.argument(
+			'[cursor]',
+			'The cursor to the batch of conversations to fetch. If not provided, initial inbox is fetched',
+		)
+		.action(async (cursor?: string) => {
+			try {
+				const inbox = await rettiwt.dm.inbox(cursor);
+				output(inbox);
+			} catch (error) {
+				output(error);
+			}
+		});
+
+	return dm;
+}
+
+export default createDirectMessageCommand;

package/src/commands/List.ts

@@ -11,12 +11,39 @@ import { Rettiwt } from '../Rettiwt';
  */
 function createListCommand(rettiwt: Rettiwt): Command {
 	// Creating the 'list' command
-	const list = createCommand('list').description('Access resources releated to lists');
+	const list = createCommand('list').description('Access resources related to lists');
+
+	// Add member
+	list.command('add-member')
+		.description('Add a new member to a list')
+		.argument('<list-id>', 'The ID of the tweet list')
+		.argument('<user-id>', 'The ID of the user to add')
+		.action(async (listId: string, userId: string) => {
+			try {
+				const memberCount = await rettiwt.list.addMember(listId, userId);
+				output(memberCount);
+			} catch (error) {
+				output(error);
+			}
+		});
+
+	// Details
+	list.command('details')
+		.description('Fetch the details of a list')
+		.argument('<id>', 'The ID of the tweet list')
+		.action(async (id: string) => {
+			try {
+				const details = await rettiwt.list.details(id);
+				output(details);
+			} catch (error) {
+				output(error);
+			}
+		});
 
 	// Members
 	list.command('members')
 		.description('Fetch the list of members of the given tweet list')
-		.argument('<id>', 'The id of the 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) => {
@@ -28,10 +55,24 @@ function createListCommand(rettiwt: Rettiwt): Command {
 			}
 		});
 
+	// Remove member
+	list.command('remove-member')
+		.description('Remove a new member from a list')
+		.argument('<list-id>', 'The ID of the tweet list')
+		.argument('<user-id>', 'The ID of the user to remove')
+		.action(async (listId: string, userId: string) => {
+			try {
+				const memberCount = await rettiwt.list.removeMember(listId, userId);
+				output(memberCount);
+			} 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('<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) => {

package/src/commands/Tweet.ts

@@ -14,7 +14,21 @@ import { ITweetFilter } from '../types/args/FetchArgs';
  */
 function createTweetCommand(rettiwt: Rettiwt): Command {
 	// Creating the 'tweet' command
-	const tweet = createCommand('tweet').description('Access resources releated to tweets');
+	const tweet = createCommand('tweet').description('Access resources related to tweets');
+
+	// Bookmark
+	tweet
+		.command('bookmark')
+		.description('Bookmark a tweet')
+		.argument('<id>', 'The tweet to bookmark')
+		.action(async (id: string) => {
+			try {
+				const result = await rettiwt.tweet.bookmark(id);
+				output(result);
+			} catch (error) {
+				output(error);
+			}
+		});
 
 	// Details
 	tweet
@@ -243,6 +257,20 @@ function createTweetCommand(rettiwt: Rettiwt): Command {
 			}
 		});
 
+	// Unbookmark
+	tweet
+		.command('unbookmark')
+		.description('Unbookmark a tweet')
+		.argument('<id>', 'The id of the tweet')
+		.action(async (id: string) => {
+			try {
+				const result = await rettiwt.tweet.unbookmark(id);
+				output(result);
+			} catch (error) {
+				output(error);
+			}
+		});
+
 	// Unlike
 	tweet
 		.command('unlike')

package/src/commands/User.ts

@@ -1,5 +1,6 @@
 import { Command, createCommand } from 'commander';
 
+import { RawAnalyticsGranularity, RawAnalyticsMetric } from '../enums/raw/Analytics';
 import { output } from '../helper/CliUtils';
 import { Rettiwt } from '../Rettiwt';
 
@@ -11,7 +12,7 @@ import { Rettiwt } from '../Rettiwt';
  */
 function createUserCommand(rettiwt: Rettiwt): Command {
 	// Creating the 'user' command
-	const user = createCommand('user').description('Access resources releated to users');
+	const user = createCommand('user').description('Access resources related to users');
 
 	// Affiliates
 	user.command('affiliates')
@@ -28,6 +29,44 @@ function createUserCommand(rettiwt: Rettiwt): Command {
 			}
 		});
 
+	// Analytics
+	user.command('analytics')
+		.description('Fetch the analytics of the logged-in user (premium accounts only)')
+		.option('-f, --from-time <string>', 'The start time for fetching analytics')
+		.option('-t, --to-time <string>', 'The end time for fetching analytics')
+		.option(
+			'-g, --granularity <string>',
+			'The granularity of the analytics data. Defaults to daily. Check https://rishikant181.github.io/Rettiwt-API/enums/RawAnalyticsGranularity.html for granularity options',
+		)
+		.option(
+			'-m, --metrics <string>',
+			'Comma-separated list of metrics required. Check https://rishikant181.github.io/Rettiwt-API/enums/RawAnalyticsMetric.html for available metrics',
+		)
+		.option(
+			'-v, --verified-followers',
+			'Whether to include verified follower count and relationship counts in the response. Defaults to true',
+		)
+		.action(async (options?: UserAnalyticsOptions) => {
+			try {
+				const analytics = await rettiwt.user.analytics(
+					options?.fromTime ? new Date(options.fromTime) : undefined,
+					options?.toTime ? new Date(options.toTime) : undefined,
+					options?.granularity
+						? RawAnalyticsGranularity[options.granularity as keyof typeof RawAnalyticsGranularity]
+						: undefined,
+					options?.metrics
+						? options.metrics
+								.split(',')
+								.map((item) => RawAnalyticsMetric[item as keyof typeof RawAnalyticsMetric])
+						: undefined,
+					options?.verifiedFollowers,
+				);
+				output(analytics);
+			} catch (error) {
+				output(error);
+			}
+		});
+
 	user.command('bookmarks')
 		.description('Fetch your list of bookmarks')
 		.argument('[count]', 'The number of bookmarks to fetch')
@@ -150,6 +189,20 @@ function createUserCommand(rettiwt: Rettiwt): Command {
 			}
 		});
 
+	// Lists
+	user.command('lists')
+		.description('Fetch your lists')
+		.argument('[count]', 'The number of lists to fetch')
+		.argument('[cursor]', 'The cursor to the batch of lists to fetch')
+		.action(async (count?: string, cursor?: string) => {
+			try {
+				const lists = await rettiwt.user.lists(count ? parseInt(count) : undefined, cursor);
+				output(lists);
+			} catch (error) {
+				output(error);
+			}
+		});
+
 	// Media
 	user.command('media')
 		.description('Fetch the media timeline the given user')
@@ -224,4 +277,15 @@ function createUserCommand(rettiwt: Rettiwt): Command {
 	return user;
 }
 
+/**
+ * The options for fetching user analytics.
+ */
+type UserAnalyticsOptions = {
+	fromTime?: string;
+	toTime?: string;
+	granularity?: string;
+	metrics?: string;
+	verifiedFollowers?: boolean;
+};
+
 export default createUserCommand;

package/src/enums/Data.ts

@@ -4,7 +4,9 @@
  * @internal
  */
 export enum BaseType {
+	DIRECT_MESSAGE = 'DIRECT_MESSAGE',
 	NOTIFICATION = 'NOTIFICATION',
 	TWEET = 'TWEET',
 	USER = 'USER',
+	LIST = 'LIST',
 }

package/src/enums/Resource.ts

@@ -5,6 +5,9 @@
  */
 export enum ResourceType {
 	// LIST
+	LIST_DETAILS = 'LIST_DETAILS',
+	LIST_MEMBER_ADD = 'LIST_MEMBER_ADD',
+	LIST_MEMBER_REMOVE = 'LIST_MEMBER_REMOVE',
 	LIST_MEMBERS = 'LIST_MEMBERS',
 	LIST_TWEETS = 'LIST_TWEETS',
 
@@ -13,7 +16,14 @@ export enum ResourceType {
 	MEDIA_UPLOAD_FINALIZE = 'MEDIA_UPLOAD_FINALIZE',
 	MEDIA_UPLOAD_INITIALIZE = 'MEDIA_UPLOAD_INITIALIZE',
 
+	// DM
+	DM_CONVERSATION = 'DM_CONVERSATION',
+	DM_INBOX_INITIAL_STATE = 'DM_INBOX_INITIAL_STATE',
+	DM_INBOX_TIMELINE = 'DM_INBOX_TIMELINE',
+	DM_DELETE_CONVERSATION = 'DM_DELETE_CONVERSATION',
+
 	// TWEET
+	TWEET_BOOKMARK = 'TWEET_BOOKMARK',
 	TWEET_DETAILS = 'TWEET_DETAILS',
 	TWEET_DETAILS_ALT = 'TWEET_DETAILS_ALT',
 	TWEET_DETAILS_BULK = 'TWEET_DETAILS_BULK',
@@ -25,6 +35,7 @@ export enum ResourceType {
 	TWEET_RETWEETERS = 'TWEET_RETWEETERS',
 	TWEET_SCHEDULE = 'TWEET_SCHEDULE',
 	TWEET_SEARCH = 'TWEET_SEARCH',
+	TWEET_UNBOOKMARK = 'TWEET_UNBOOKMARK',
 	TWEET_UNLIKE = 'TWEET_UNLIKE',
 	TWEET_UNPOST = 'TWEET_UNPOST',
 	TWEET_UNRETWEET = 'TWEET_UNRETWEET',
@@ -32,6 +43,7 @@ export enum ResourceType {
 
 	// USER
 	USER_AFFILIATES = 'USER_AFFILIATES',
+	USER_ANALYTICS = 'USER_ANALYTICS',
 	USER_BOOKMARKS = 'USER_BOOKMARKS',
 	USER_DETAILS_BY_USERNAME = 'USER_DETAILS_BY_USERNAME',
 	USER_DETAILS_BY_ID = 'USER_DETAILS_BY_ID',
@@ -43,6 +55,7 @@ export enum ResourceType {
 	USER_FOLLOWERS = 'USER_FOLLOWERS',
 	USER_HIGHLIGHTS = 'USER_HIGHLIGHTS',
 	USER_LIKES = 'USER_LIKES',
+	USER_LISTS = 'USER_LISTS',
 	USER_MEDIA = 'USER_MEDIA',
 	USER_NOTIFICATIONS = 'USER_NOTIFICATIONS',
 	USER_SUBSCRIPTIONS = 'USER_SUBSCRIPTIONS',

package/src/enums/raw/Analytics.ts

@@ -19,11 +19,14 @@ export enum RawAnalyticsMetric {
 	IMPRESSIONS = 'Impressions',
 	PROFILE_VISITS = 'ProfileVisits',
 	FOLLOWS = 'Follows',
-	VIDEO_VIEWS = 'VideoViews',
 	REPLIES = 'Replies',
 	LIKES = 'Likes',
 	RETWEETS = 'Retweets',
-	MEDIA_VIEWS = 'MediaViews',
 	BOOKMARK = 'Bookmark',
 	SHARE = 'Share',
+	URL_CLICKS = 'UrlClicks',
+	CREATE_TWEET = 'CreateTweet',
+	CREATE_QUOTE = 'CreateQuote',
+	CREATE_REPLY = 'CreateReply',
+	UNFOLLOWS = 'Unfollows',
 }