rettiwt-api 7.0.2 → 7.1.0

package/dist/types/raw/tweet/History.d.ts

@@ -0,0 +1,48 @@
+import { ITimelineTweet } from '../composite/TimelineTweet';
+/**
+ * Represents the raw response received when fetching a tweet's edit history.
+ *
+ * @public
+ */
+export interface ITweetHistoryResponse {
+    data?: {
+        tweet_result_by_rest_id?: {
+            result?: {
+                edit_history_timeline?: {
+                    timeline?: ITweetHistoryTimeline;
+                };
+            };
+        };
+    };
+}
+export interface ITweetHistoryTimeline {
+    instructions?: ITweetHistoryInstruction[];
+}
+export interface ITweetHistoryInstruction {
+    direction?: string;
+    entries?: ITweetHistoryEntry[];
+    type: string;
+}
+export interface ITweetHistoryEntry {
+    content?: ITweetHistoryModule;
+    entryId: string;
+    sortIndex?: string;
+}
+export interface ITweetHistoryModule {
+    __typename: string;
+    displayType: string;
+    entryType: string;
+    header?: ITweetHistoryHeader;
+    items?: ITweetHistoryItem[];
+}
+export interface ITweetHistoryHeader {
+    displayType: string;
+    sticky: boolean;
+    text: string;
+}
+export interface ITweetHistoryItem {
+    entryId: string;
+    item: {
+        itemContent: ITimelineTweet;
+    };
+}

package/dist/types/raw/tweet/History.js

@@ -0,0 +1,4 @@
+"use strict";
+/* eslint-disable */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=History.js.map

package/dist/types/raw/tweet/History.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"History.js","sourceRoot":"","sources":["../../../../src/types/raw/tweet/History.ts"],"names":[],"mappings":";AAAA,oBAAoB"}

package/dist/types/raw/user/RemoveFollower.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The raw data received when removing a given user from the authenticated user's followers.
+ *
+ * @public
+ */
+export interface IUserRemoveFollowerResponse {
+    data?: {
+        remove_follower?: {
+            __typename?: string;
+            unfollow_success_reason?: string;
+        };
+    };
+}

package/dist/types/raw/user/RemoveFollower.js

@@ -0,0 +1,4 @@
+"use strict";
+/* eslint-disable */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=RemoveFollower.js.map

package/dist/types/raw/user/RemoveFollower.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoveFollower.js","sourceRoot":"","sources":["../../../../src/types/raw/user/RemoveFollower.ts"],"names":[],"mappings":";AAAA,oBAAoB"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "rettiwt-api",
-	"version": "7.0.2",
+	"version": "7.1.0",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
 	"description": "An API for fetching data from TwitterAPI, without any rate limits!",

package/src/collections/Extractors.ts

@@ -14,15 +14,21 @@ 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 { IListCreateResponse } from '../types/raw/list/Create';
+import { IListDeleteResponse } from '../types/raw/list/Delete';
 import { IListDetailsResponse } from '../types/raw/list/Details';
 import { IListMembersResponse } from '../types/raw/list/Members';
+import { IListMuteResponse } from '../types/raw/list/Mute';
 import { IListMemberRemoveResponse } from '../types/raw/list/RemoveMember';
 import { IListTweetsResponse } from '../types/raw/list/Tweets';
+import { IListUnmuteResponse } from '../types/raw/list/Unmute';
+import { IListUpdateResponse } from '../types/raw/list/Update';
 import { IMediaInitializeUploadResponse } from '../types/raw/media/InitalizeUpload';
 import { IAudioSpaceByIdResponse } from '../types/raw/space/AudioSpaceById';
 import { ITweetBookmarkResponse } from '../types/raw/tweet/Bookmark';
 import { ITweetDetailsResponse } from '../types/raw/tweet/Details';
 import { ITweetDetailsBulkResponse } from '../types/raw/tweet/DetailsBulk';
+import { ITweetHistoryResponse } from '../types/raw/tweet/History';
 import { ITweetLikeResponse } from '../types/raw/tweet/Like';
 import { ITweetLikersResponse } from '../types/raw/tweet/Likers';
 import { ITweetPostNoteResponse, ITweetPostResponse } from '../types/raw/tweet/Post';
@@ -56,6 +62,7 @@ import { IUserMediaResponse } from '../types/raw/user/Media';
 import { IUserNotificationsResponse } from '../types/raw/user/Notifications';
 import { IUserProfileUpdateResponse } from '../types/raw/user/ProfileUpdate';
 import { IUserRecommendedResponse } from '../types/raw/user/Recommended';
+import { IUserRemoveFollowerResponse } from '../types/raw/user/RemoveFollower';
 import { IUserSearchResponse } from '../types/raw/user/Search';
 import { IUserSettingsResponse } from '../types/raw/user/Settings';
 import { IUserSubscriptionsResponse } from '../types/raw/user/Subscriptions';
@@ -71,6 +78,8 @@ import { IUserUnfollowResponse } from '../types/raw/user/Unfollow';
 export const Extractors = {
 	/* eslint-disable @typescript-eslint/naming-convention */
 
+	LIST_CREATE: (response: IListCreateResponse): string | undefined => response.data?.list?.id_str ?? undefined,
+	LIST_DELETE: (response: IListDeleteResponse): boolean => response.data?.list_delete === 'Done',
 	LIST_DETAILS: (response: IListDetailsResponse, id: string): List | undefined => List.single(response, id),
 	LIST_MEMBERS: (response: IListMembersResponse): CursoredData<User> =>
 		new CursoredData<User>(response, BaseType.USER),
@@ -78,8 +87,12 @@ export const Extractors = {
 		response.data?.list?.member_count ?? undefined,
 	LIST_MEMBER_REMOVE: (response: IListMemberRemoveResponse): number | undefined =>
 		response.data?.list?.member_count ?? undefined,
+	LIST_MUTE: (response: IListMuteResponse): boolean => response.data?.list === 'Done',
 	LIST_TWEETS: (response: IListTweetsResponse): CursoredData<Tweet> =>
 		new CursoredData<Tweet>(response, BaseType.TWEET),
+	LIST_UNMUTE: (response: IListUnmuteResponse): boolean => response.data?.list === 'Done',
+	LIST_UPDATE: (response: IListUpdateResponse): List | undefined =>
+		response.data?.list ? new List(response.data.list) : undefined,
 
 	MEDIA_UPLOAD_APPEND: (): void => undefined,
 	MEDIA_UPLOAD_FINALIZE: (): void => undefined,
@@ -97,6 +110,7 @@ export const Extractors = {
 	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),
+	TWEET_HISTORY: (response: ITweetHistoryResponse): Tweet[] => Tweet.timeline(response),
 	TWEET_LIKE: (response: ITweetLikeResponse): boolean => (response?.data?.favorite_tweet ? true : false),
 	TWEET_LIKERS: (response: ITweetLikersResponse): CursoredData<User> =>
 		new CursoredData<User>(response, BaseType.USER),
@@ -154,6 +168,8 @@ export const Extractors = {
 		new CursoredData<Tweet>(response, BaseType.TWEET),
 	USER_NOTIFICATIONS: (response: IUserNotificationsResponse): CursoredData<Notification> =>
 		new CursoredData<Notification>(response, BaseType.NOTIFICATION),
+	USER_REMOVE_FOLLOWER: (response: IUserRemoveFollowerResponse): boolean =>
+		response?.data?.remove_follower?.unfollow_success_reason ? true : false,
 	USER_SEARCH: (response: IUserSearchResponse): CursoredData<User> => new CursoredData<User>(response, BaseType.USER),
 	USER_SUBSCRIPTIONS: (response: IUserSubscriptionsResponse): CursoredData<User> =>
 		new CursoredData<User>(response, BaseType.USER),

package/src/collections/Groups.ts

@@ -28,6 +28,7 @@ export const FetchResourcesGroup = [
 	ResourceType.TWEET_DETAILS,
 	ResourceType.TWEET_DETAILS_ALT,
 	ResourceType.TWEET_DETAILS_BULK,
+	ResourceType.TWEET_HISTORY,
 	ResourceType.TWEET_LIKERS,
 	ResourceType.TWEET_REPLIES,
 	ResourceType.TWEET_RETWEETERS,
@@ -62,8 +63,13 @@ export const FetchResourcesGroup = [
  * @internal
  */
 export const PostResourcesGroup = [
+	ResourceType.LIST_CREATE,
+	ResourceType.LIST_DELETE,
 	ResourceType.LIST_MEMBER_ADD,
 	ResourceType.LIST_MEMBER_REMOVE,
+	ResourceType.LIST_MUTE,
+	ResourceType.LIST_UNMUTE,
+	ResourceType.LIST_UPDATE,
 	ResourceType.MEDIA_UPLOAD_APPEND,
 	ResourceType.MEDIA_UPLOAD_FINALIZE,
 	ResourceType.MEDIA_UPLOAD_INITIALIZE,
@@ -80,6 +86,7 @@ export const PostResourcesGroup = [
 	ResourceType.TWEET_UNRETWEET,
 	ResourceType.TWEET_UNSCHEDULE,
 	ResourceType.USER_FOLLOW,
+	ResourceType.USER_REMOVE_FOLLOWER,
 	ResourceType.USER_UNFOLLOW,
 	ResourceType.USER_PROFILE_UPDATE,
 	ResourceType.USER_PROFILE_IMAGE_UPDATE,

package/src/collections/Requests.ts

@@ -20,11 +20,16 @@ import { TweetRepliesSortTypeMap } from './Tweet';
 export const Requests: { [key in keyof typeof ResourceType]: (args: IFetchArgs | IPostArgs) => AxiosRequestConfig } = {
 	/* eslint-disable @typescript-eslint/naming-convention */
 
+	LIST_CREATE: (args: IPostArgs) => ListRequests.create(args.list!),
+	LIST_DELETE: (args: IPostArgs) => ListRequests.delete(args.id!),
 	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_MUTE: (args: IPostArgs) => ListRequests.mute(args.id!),
 	LIST_TWEETS: (args: IFetchArgs) => ListRequests.tweets(args.id!, args.count, args.cursor),
+	LIST_UNMUTE: (args: IPostArgs) => ListRequests.unmute(args.id!),
+	LIST_UPDATE: (args: IPostArgs) => ListRequests.update(args.id!, args.listUpdates!),
 
 	MEDIA_UPLOAD_APPEND: (args: IPostArgs) => MediaRequests.appendUpload(args.upload!.id!, args.upload!.media!),
 	MEDIA_UPLOAD_FINALIZE: (args: IPostArgs) => MediaRequests.finalizeUpload(args.upload!.id!),
@@ -42,6 +47,7 @@ export const Requests: { [key in keyof typeof ResourceType]: (args: IFetchArgs |
 	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!),
+	TWEET_HISTORY: (args: IFetchArgs) => TweetRequests.history(args.id!),
 	TWEET_LIKE: (args: IPostArgs) => TweetRequests.like(args.id!),
 	TWEET_LIKERS: (args: IFetchArgs) => TweetRequests.likers(args.id!, args.count, args.cursor),
 	TWEET_POST: (args: IPostArgs) => TweetRequests.post(args.tweet!),
@@ -85,6 +91,7 @@ export const Requests: { [key in keyof typeof ResourceType]: (args: IFetchArgs |
 	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_REMOVE_FOLLOWER: (args: IPostArgs) => UserRequests.removeFollower(args.id!),
 	USER_SEARCH: (args: IFetchArgs) => UserRequests.search(args.id!, args.count, args.cursor),
 	USER_SUBSCRIPTIONS: (args: IFetchArgs) => UserRequests.subscriptions(args.id!, args.count, args.cursor),
 	USER_TIMELINE: (args: IFetchArgs) => UserRequests.tweets(args.id!, args.count, args.cursor),

package/src/commands/List.ts

@@ -2,6 +2,20 @@ import { Command, createCommand } from 'commander';
 
 import { output } from '../helper/CliUtils';
 import { Rettiwt } from '../Rettiwt';
+import { IListUpdates } from '../types/args/PostArgs';
+
+type ListCreateOptions = {
+	description?: boolean | string;
+	private?: boolean;
+};
+
+type ListUpdateOptions = ListCreateOptions & {
+	public?: boolean;
+};
+
+function getDescription(description?: boolean | string): string | undefined {
+	return typeof description === 'string' ? description : undefined;
+}
 
 /**
  * Creates a new 'list' command which uses the given Rettiwt instance.
@@ -13,6 +27,92 @@ function createListCommand(rettiwt: Rettiwt): Command {
 	// Creating the 'list' command
 	const list = createCommand('list').description('Access resources related to lists');
 
+	// Create
+	list.command('create')
+		.description('Create a new list')
+		.argument('<name>', 'The name of the tweet list')
+		.option('-d, --description [string]', 'The description of the tweet list')
+		.option('--private', 'Create a private list')
+		.action(async (name: string, options?: ListCreateOptions) => {
+			try {
+				const id = await rettiwt.list.create({
+					name: name,
+					description: getDescription(options?.description),
+					isPrivate: options?.private,
+				});
+				output(id);
+			} catch (error) {
+				output(error);
+			}
+		});
+
+	// Update
+	list.command('update')
+		.description('Update a list')
+		.argument('<id>', 'The ID of the tweet list')
+		.argument('[name]', 'The updated name of the tweet list')
+		.option('-d, --description [string]', 'The updated description of the tweet list')
+		.option('--private', 'Update to a private list')
+		.option('--public', 'Update to a public list')
+		.action(async (id: string, name?: string, options?: ListUpdateOptions) => {
+			try {
+				if (options?.private && options?.public) {
+					throw new Error('List cannot be both private and public');
+				}
+
+				const updates: IListUpdates = {
+					...(name !== undefined ? { name: name } : {}),
+					...(typeof options?.description === 'string' ? { description: options.description } : {}),
+					...(options?.private ? { isPrivate: true } : {}),
+					...(options?.public ? { isPrivate: false } : {}),
+				};
+
+				const details = await rettiwt.list.update(id, updates);
+				output(details);
+			} catch (error) {
+				output(error);
+			}
+		});
+
+	// Delete
+	list.command('delete')
+		.description('Delete a list')
+		.argument('<id>', 'The ID of the tweet list')
+		.action(async (id: string) => {
+			try {
+				const deleted = await rettiwt.list.delete(id);
+				output(deleted);
+			} catch (error) {
+				output(error);
+			}
+		});
+
+	// Mute
+	list.command('mute')
+		.description('Mute a list')
+		.argument('<id>', 'The ID of the tweet list')
+		.action(async (id: string) => {
+			try {
+				const muted = await rettiwt.list.mute(id);
+				output(muted);
+			} catch (error) {
+				output(error);
+			}
+		});
+
+	// Unmute
+	list.command('unmute')
+		.description('Unmute a list')
+		.argument('<id>', 'The ID of the tweet list')
+		.action(async (id: string) => {
+			try {
+				const unmuted = await rettiwt.list.unmute(id);
+				output(unmuted);
+			} catch (error) {
+				output(error);
+			}
+		});
+
 	// Add member
 	list.command('add-member')
 		.description('Add a new member to a list')

package/src/commands/Tweet.ts

@@ -55,6 +55,20 @@ function createTweetCommand(rettiwt: Rettiwt): Command {
 			}
 		});
 
+	// History
+	tweet
+		.command('history')
+		.description('Fetch the edit history of a tweet')
+		.argument('<id>', 'The id of the tweet')
+		.action(async (id: string) => {
+			try {
+				const tweets = await rettiwt.tweet.history(id);
+				output(tweets);
+			} catch (error) {
+				output(error);
+			}
+		});
+
 	// Like
 	tweet
 		.command('like')

package/src/commands/User.ts

@@ -278,6 +278,19 @@ function createUserCommand(rettiwt: Rettiwt): Command {
 			}
 		});
 
+	// Remove Follower
+	user.command('remove-follower')
+		.description("Remove a user from the authenticated user's followers")
+		.argument('<id>', 'The user to remove as a follower')
+		.action(async (id: string) => {
+			try {
+				const result = await rettiwt.user.removeFollower(id);
+				output(result);
+			} catch (error) {
+				output(error);
+			}
+		});
+
 	// Replies
 	user.command('replies')
 		.description('Fetch the replies timeline the given user')

package/src/enums/Resource.ts

@@ -5,11 +5,16 @@
  */
 export enum ResourceType {
 	// LIST
+	LIST_CREATE = 'LIST_CREATE',
+	LIST_DELETE = 'LIST_DELETE',
 	LIST_DETAILS = 'LIST_DETAILS',
 	LIST_MEMBER_ADD = 'LIST_MEMBER_ADD',
 	LIST_MEMBER_REMOVE = 'LIST_MEMBER_REMOVE',
 	LIST_MEMBERS = 'LIST_MEMBERS',
+	LIST_MUTE = 'LIST_MUTE',
 	LIST_TWEETS = 'LIST_TWEETS',
+	LIST_UNMUTE = 'LIST_UNMUTE',
+	LIST_UPDATE = 'LIST_UPDATE',
 
 	// MEDIA
 	MEDIA_UPLOAD_APPEND = 'MEDIA_UPLOAD_APPEND',
@@ -30,6 +35,7 @@ export enum ResourceType {
 	TWEET_DETAILS = 'TWEET_DETAILS',
 	TWEET_DETAILS_ALT = 'TWEET_DETAILS_ALT',
 	TWEET_DETAILS_BULK = 'TWEET_DETAILS_BULK',
+	TWEET_HISTORY = 'TWEET_HISTORY',
 	TWEET_LIKE = 'TWEET_LIKE',
 	TWEET_LIKERS = 'TWEET_LIKERS',
 	TWEET_POST = 'TWEET_POST',
@@ -65,6 +71,7 @@ export enum ResourceType {
 	USER_LISTS = 'USER_LISTS',
 	USER_MEDIA = 'USER_MEDIA',
 	USER_NOTIFICATIONS = 'USER_NOTIFICATIONS',
+	USER_REMOVE_FOLLOWER = 'USER_REMOVE_FOLLOWER',
 	USER_SEARCH = 'USER_SEARCH',
 	USER_SUBSCRIPTIONS = 'USER_SUBSCRIPTIONS',
 	USER_TIMELINE = 'USER_TIMELINE',

package/src/index.ts

@@ -82,16 +82,22 @@ export { ITimelineTweet as IRawTimelineTweet } from './types/raw/composite/Timel
 export { ITimelineUser as IRawTimelineUser } from './types/raw/composite/TimelineUser';
 export { IResponse as IRawResponse } from './types/raw/generic/Response';
 export { IListMemberAddResponse as IRawListMemberAddResponse } from './types/raw/list/AddMember';
-export { IListMemberRemoveResponse as IRawListMemberRemoveResponse } from './types/raw/list/RemoveMember';
+export { IListCreateResponse as IRawListCreateResponse } from './types/raw/list/Create';
+export { IListDeleteResponse as IRawListDeleteResponse } from './types/raw/list/Delete';
 export { IListDetailsResponse as IRawListDetailsResponse } from './types/raw/list/Details';
 export { IListMembersResponse as IRawListMembersResponse } from './types/raw/list/Members';
+export { IListMuteResponse as IRawListMuteResponse } from './types/raw/list/Mute';
+export { IListMemberRemoveResponse as IRawListMemberRemoveResponse } from './types/raw/list/RemoveMember';
 export { IListTweetsResponse as IRawListTweetsResponse } from './types/raw/list/Tweets';
+export { IListUnmuteResponse as IRawListUnmuteResponse } from './types/raw/list/Unmute';
+export { IListUpdateResponse as IRawListUpdateResponse } from './types/raw/list/Update';
 export { IMediaFinalizeUploadResponse as IRawMediaFinalizeUploadResponse } from './types/raw/media/FinalizeUpload';
 export { IMediaInitializeUploadResponse as IRawMediaInitializeUploadResponse } from './types/raw/media/InitalizeUpload';
 export { IMediaLiveVideoStreamResponse as IRawMediaLiveVideoStreamResponse } from './types/raw/media/LiveVideoStream';
 export { IAudioSpaceByIdResponse as IRawSpaceDetailsResponse } from './types/raw/space/AudioSpaceById';
 export { ITweetDetailsResponse as IRawTweetDetailsResponse } from './types/raw/tweet/Details';
 export { ITweetDetailsBulkResponse as IRawTweetDetailsBulkResponse } from './types/raw/tweet/DetailsBulk';
+export { ITweetHistoryResponse as IRawTweetHistoryResponse } from './types/raw/tweet/History';
 export { ITweetLikeResponse as IRawTweetLikeResponse } from './types/raw/tweet/Like';
 export { ITweetLikersResponse as IRawTweetLikersResponse } from './types/raw/tweet/Likers';
 export { ITweetPostResponse as IRawTweetPostResponse } from './types/raw/tweet/Post';

package/src/models/args/PostArgs.ts

@@ -1,4 +1,12 @@
-import { IChangePasswordArgs, INewTweet, INewTweetMedia, IPostArgs, IUploadArgs } from '../../types/args/PostArgs';
+import {
+	IChangePasswordArgs,
+	IListUpdates,
+	INewList,
+	INewTweet,
+	INewTweetMedia,
+	IPostArgs,
+	IUploadArgs,
+} from '../../types/args/PostArgs';
 
 import { ProfileUpdateOptions } from './ProfileArgs';
 
@@ -11,6 +19,8 @@ export class PostArgs implements IPostArgs {
 	public changePassword?: ChangePasswordArgs;
 	public conversationId?: string;
 	public id?: string;
+	public list?: NewList;
+	public listUpdates?: ListUpdates;
 	public profileBanner?: string;
 	public profileImage?: string;
 	public profileOptions?: ProfileUpdateOptions;
@@ -25,6 +35,7 @@ export class PostArgs implements IPostArgs {
 	 */
 	public constructor(args: IPostArgs) {
 		this.id = args.id;
+		this.list = args.list ? new NewList(args.list) : undefined;
 		this.tweet = args.tweet ? new NewTweet(args.tweet) : undefined;
 		this.upload = args.upload ? new UploadArgs(args.upload) : undefined;
 		this.userId = args.userId;
@@ -34,6 +45,7 @@ export class PostArgs implements IPostArgs {
 		this.profileImage = PostArgs._validateNonEmptyString(args.profileImage, 'Profile image');
 		this.profileBanner = PostArgs._validateNonEmptyString(args.profileBanner, 'Profile banner');
 		this.changePassword = args.changePassword ? new ChangePasswordArgs(args.changePassword) : undefined;
+		this.listUpdates = args.listUpdates ? new ListUpdates(args.listUpdates) : undefined;
 	}
 
 	/**
@@ -61,6 +73,46 @@ export class PostArgs implements IPostArgs {
 	}
 }
 
+/**
+ * Configuration for the list to be created.
+ *
+ * @public
+ */
+export class NewList implements INewList {
+	public description?: string;
+	public isPrivate: boolean;
+	public name: string;
+
+	/**
+	 * @param newList - The args specifying the list to be created.
+	 */
+	public constructor(newList: INewList) {
+		this.name = newList.name;
+		this.description = newList.description;
+		this.isPrivate = newList.isPrivate ?? false;
+	}
+}
+
+/**
+ * Configuration for the updates to apply to an existing list.
+ *
+ * @public
+ */
+export class ListUpdates implements IListUpdates {
+	public description?: string;
+	public isPrivate?: boolean;
+	public name?: string;
+
+	/**
+	 * @param updates - The updates to apply to the target list.
+	 */
+	public constructor(updates: IListUpdates) {
+		this.name = updates.name;
+		this.description = updates.description;
+		this.isPrivate = updates.isPrivate;
+	}
+}
+
 /**
  * Configuration for the new tweet to be posted.
  *

package/src/requests/List.ts

@@ -1,5 +1,7 @@
 import { AxiosRequestConfig } from 'axios';
 
+import { IListUpdates, INewList } from '../types/args/PostArgs';
+
 /**
  * Collection of requests related to lists.
  *
@@ -35,6 +37,54 @@ export class ListRequests {
 		};
 	}
 
+	/**
+	 * @param list - The details of the list to create.
+	 */
+	public static create(list: INewList): AxiosRequestConfig {
+		return {
+			method: 'post',
+			headers: { referer: 'https://x.com/i/lists/create' },
+			url: 'https://x.com/i/api/graphql/4lSOF4GqldI-NbiFET4ofQ/CreateList',
+			data: {
+				/* eslint-disable @typescript-eslint/naming-convention */
+
+				variables: {
+					isPrivate: list.isPrivate ?? false,
+					name: list.name,
+					...(list.description !== undefined ? { description: list.description } : {}),
+				},
+				features: {
+					profile_label_improvements_pcf_label_in_post_enabled: true,
+					responsive_web_profile_redirect_enabled: false,
+					rweb_tipjar_consumption_enabled: false,
+					verified_phone_label_enabled: false,
+					responsive_web_graphql_skip_user_profile_image_extensions_enabled: false,
+					responsive_web_graphql_timeline_navigation_enabled: true,
+				},
+				queryId: '4lSOF4GqldI-NbiFET4ofQ',
+
+				/* eslint-enable @typescript-eslint/naming-convention */
+			},
+		};
+	}
+
+	/**
+	 * @param id - The ID of the list to delete.
+	 */
+	public static delete(id: string): AxiosRequestConfig {
+		return {
+			method: 'post',
+			headers: { referer: `https://x.com/i/lists/${id}/info` },
+			url: 'https://x.com/i/api/graphql/UnN9Th1BDbeLjpgjGSpL3Q/DeleteList',
+			data: {
+				variables: {
+					listId: id,
+				},
+				queryId: 'UnN9Th1BDbeLjpgjGSpL3Q',
+			},
+		};
+	}
+
 	/**
 	 * @param id - The id of the list whose details are to be fetched.
 	 */
@@ -116,6 +166,23 @@ export class ListRequests {
 		};
 	}
 
+	/**
+	 * @param id - The ID of the list to mute.
+	 */
+	public static mute(id: string): AxiosRequestConfig {
+		return {
+			method: 'post',
+			headers: { referer: `https://x.com/i/lists/${id}` },
+			url: 'https://x.com/i/api/graphql/ZYyanJsskNUcltu9bliMLA/MuteList',
+			data: {
+				variables: {
+					listId: id,
+				},
+				queryId: 'ZYyanJsskNUcltu9bliMLA',
+			},
+		};
+	}
+
 	/**
 	 * @param listId - The ID of the target list.
 	 * @param userId - The ID of the user to remove as a member.
@@ -202,4 +269,54 @@ export class ListRequests {
 			paramsSerializer: { encode: encodeURIComponent },
 		};
 	}
+
+	/**
+	 * @param id - The ID of the list to unmute.
+	 */
+	public static unmute(id: string): AxiosRequestConfig {
+		return {
+			method: 'post',
+			headers: { referer: `https://x.com/i/lists/${id}` },
+			url: 'https://x.com/i/api/graphql/pMZrHRNsmEkXgbn3tOyr7Q/UnmuteList',
+			data: {
+				variables: {
+					listId: id,
+				},
+				queryId: 'pMZrHRNsmEkXgbn3tOyr7Q',
+			},
+		};
+	}
+
+	/**
+	 * @param id - The ID of the list to update.
+	 * @param updates - The updates to apply.
+	 */
+	public static update(id: string, updates: IListUpdates): AxiosRequestConfig {
+		return {
+			method: 'post',
+			headers: { referer: `https://x.com/i/lists/${id}/info` },
+			url: 'https://x.com/i/api/graphql/UzVGAR_brbQw1n3mH_PqRA/UpdateList',
+			data: {
+				/* eslint-disable @typescript-eslint/naming-convention */
+
+				variables: {
+					listId: id,
+					...(updates.isPrivate !== undefined ? { isPrivate: updates.isPrivate } : {}),
+					...(updates.description !== undefined ? { description: updates.description } : {}),
+					...(updates.name !== undefined ? { name: updates.name } : {}),
+				},
+				features: {
+					profile_label_improvements_pcf_label_in_post_enabled: true,
+					responsive_web_profile_redirect_enabled: false,
+					rweb_tipjar_consumption_enabled: false,
+					verified_phone_label_enabled: false,
+					responsive_web_graphql_skip_user_profile_image_extensions_enabled: false,
+					responsive_web_graphql_timeline_navigation_enabled: true,
+				},
+				queryId: 'UzVGAR_brbQw1n3mH_PqRA',
+
+				/* eslint-enable @typescript-eslint/naming-convention */
+			},
+		};
+	}
 }