rettiwt-api 7.0.3 → 7.1.0

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 */
+			},
+		};
+	}
 }

package/src/requests/Tweet.ts

@@ -151,6 +151,66 @@ export class TweetRequests {
 		};
 	}
 
+	/**
+	 * @param id - The id of the tweet whose edit history is to be fetched.
+	 */
+	public static history(id: string): AxiosRequestConfig {
+		return {
+			method: 'get',
+			url: 'https://x.com/i/api/graphql/MGElmrYILE8wUfI8GorUYA/TweetEditHistory',
+			params: {
+				/* eslint-disable @typescript-eslint/naming-convention */
+				variables: JSON.stringify({
+					tweetId: id,
+					withQuickPromoteEligibilityTweetFields: true,
+				}),
+				features: JSON.stringify({
+					premium_content_api_read_enabled: false,
+					communities_web_enable_tweet_community_results_fetch: true,
+					c9s_tweet_anatomy_moderator_badge_enabled: true,
+					responsive_web_grok_analyze_button_fetch_trends_enabled: false,
+					responsive_web_grok_analyze_post_followups_enabled: true,
+					rweb_cashtags_composer_attachment_enabled: true,
+					responsive_web_jetfuel_frame: true,
+					responsive_web_grok_share_attachment_enabled: true,
+					responsive_web_grok_annotations_enabled: true,
+					freedom_of_speech_not_reach_fetch_enabled: true,
+					standardized_nudges_misinfo: true,
+					tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled: true,
+					rweb_video_screen_enabled: false,
+					responsive_web_edit_tweet_api_enabled: true,
+					rweb_conversational_replies_downvote_enabled: false,
+					graphql_is_translatable_rweb_tweet_is_translatable_enabled: true,
+					view_counts_everywhere_api_enabled: true,
+					longform_notetweets_consumption_enabled: true,
+					responsive_web_twitter_article_tweet_consumption_enabled: true,
+					content_disclosure_indicator_enabled: true,
+					content_disclosure_ai_generated_indicator_enabled: true,
+					responsive_web_grok_show_grok_translated_post: true,
+					responsive_web_grok_analysis_button_from_backend: true,
+					post_ctas_fetch_enabled: true,
+					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,
+					rweb_cashtags_enabled: true,
+					longform_notetweets_rich_text_read_enabled: true,
+					longform_notetweets_inline_media_enabled: false,
+					articles_preview_enabled: true,
+					responsive_web_graphql_skip_user_profile_image_extensions_enabled: false,
+					responsive_web_grok_community_note_auto_translation_is_enabled: true,
+					responsive_web_grok_image_annotation_enabled: true,
+					responsive_web_grok_imagine_annotation_enabled: true,
+					responsive_web_graphql_timeline_navigation_enabled: true,
+					creator_subscriptions_tweet_preview_api_enabled: true,
+					responsive_web_enhance_cards_enabled: false,
+				}),
+				/* eslint-enable @typescript-eslint/naming-convention */
+			},
+			paramsSerializer: { encode: encodeURIComponent },
+		};
+	}
+
 	/**
 	 * @param id - The id of the tweet to be liked.
 	 */

package/src/requests/User.ts

@@ -980,6 +980,22 @@ export class UserRequests {
 		};
 	}
 
+	/**
+	 * @param id - The id of the user to remove from the authenticated user's followers.
+	 */
+	public static removeFollower(id: string): AxiosRequestConfig {
+		return {
+			method: 'post',
+			url: 'https://x.com/i/api/graphql/QpNfg0kpPRfjROQ_9eOLXA/RemoveFollower',
+			data: {
+				/* eslint-disable @typescript-eslint/naming-convention */
+				variables: { target_user_id: id },
+				queryId: 'QpNfg0kpPRfjROQ_9eOLXA',
+				/* eslint-enable @typescript-eslint/naming-convention */
+			},
+		};
+	}
+
 	public static scheduled(): AxiosRequestConfig {
 		return {
 			method: 'get',