rettiwt-api 6.0.7 → 6.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "rettiwt-api",
-	"version": "6.0.7",
+	"version": "6.1.0",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
 	"description": "An API for fetching data from TwitterAPI, without any rate limits!",
@@ -11,9 +11,10 @@
 		"build": "tsc",
 		"prepare": "tsc",
 		"format": "prettier --write .",
+		"format:check": "prettier --check .",
 		"lint": "eslint --max-warnings 0 --fix .",
-		"docs": "typedoc --excludePrivate --excludeProtected --excludeInternal src/index.ts",
-		"debug": "nodemon ./dist/index.js --inspect=0.0.0.0:9229"
+		"lint:check": "eslint --max-warnings 0 .",
+		"docs": "typedoc --excludePrivate --excludeProtected --excludeInternal src/index.ts"
 	},
 	"repository": {
 		"type": "git",
@@ -29,10 +30,11 @@
 	},
 	"homepage": "https://rishikant181.github.io/Rettiwt-API/",
 	"engines": {
-		"node": "^22.13.1"
+		"node": "^22.21.0"
 	},
 	"devDependencies": {
 		"@types/cookiejar": "^2.1.5",
+		"@types/jsdom": "^27.0.0",
 		"@types/node": "^22.13.1",
 		"@typescript-eslint/eslint-plugin": "^8.24.0",
 		"@typescript-eslint/parser": "^8.24.0",
@@ -50,7 +52,12 @@
 		"commander": "^11.1.0",
 		"cookiejar": "^2.1.4",
 		"https-proxy-agent": "^7.0.6",
+		"jsdom": "^27.2.0",
 		"node-html-parser": "^7.0.1",
-		"x-client-transaction-id-glacier": "^1.0.0"
-	}
+		"x-client-transaction-id": "^0.1.8"
+	},
+	"workspaces": [
+		"playground",
+		"src"
+	]
 }

package/playground/.env.example

@@ -0,0 +1 @@
+ACCESS_TOKEN=""

package/playground/README.md

@@ -0,0 +1,53 @@
+# Rettiwt Playground
+
+This playground is intended for developers to test and experiment with features from the Rettiwt-API package in a local development environment.
+
+## Getting Started
+
+### Prerequisites
+
+- Node.js (v22 or higher recommended)
+- npm (v7+ recommended for workspace support)
+
+### Setup
+
+1. **Install dependencies**
+   From the root of the monorepo, run:
+
+    ```sh
+    npm install
+    ```
+
+    This will install dependencies for all workspaces, including `playground` and `src`.
+
+2. **Environment Variables**
+   Create a `.env` file in the `playground` directory with your API credentials:
+    ```env
+    ACCESS_TOKEN=your_access_token_here
+    ```
+
+### Usage
+
+- The main entry point is [`index.js`](./index.js), which demonstrates usage of the Rettiwt-API.
+- To run the playground:
+    ```sh
+    npm start --workspace=playground
+    ```
+    or from the `playground` directory:
+    ```sh
+    npm start
+    ```
+
+### Modifying Playground Code
+
+- Edit `index.js` to try different API features or test new functionality.
+- The `rettiwt-api` dependency is linked via npm workspaces, so changes in `src` are immediately available in the playground after rebuilding if necessary.
+
+## Notes
+
+- This playground is for development and testing only. Do not use production credentials.
+- For more advanced usage, add scripts or files as needed.
+
+---
+
+For questions or issues, see the main project README or open an issue.

package/playground/index.js

@@ -0,0 +1,15 @@
+import { Rettiwt } from 'rettiwt-api';
+import 'dotenv/config';
+
+const rettiwt = new Rettiwt({ apiKey: process.env.ACCESS_TOKEN });
+
+async function userDetails() {
+	try {
+		const user = await rettiwt.user.details();
+		console.log(user);
+	} catch (error) {
+		console.error('Error fetching user details:', error);
+	}
+}
+
+await userDetails();

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',
 }