rettiwt-api 6.3.0-alpha.1 → 7.0.0

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

@@ -0,0 +1,65 @@
+/**
+ * The raw data received when fetching the about profile of the given user.
+ *
+ * @public
+ */
+export interface IUserAboutResponse {
+    data: Data;
+}
+interface Data {
+    user_result_by_screen_name: UserResultByScreenName;
+}
+interface UserResultByScreenName {
+    result: IUserAboutResult;
+    id: string;
+}
+export interface IUserAboutResult {
+    __typename: string;
+    id: string;
+    rest_id: string;
+    avatar?: Avatar;
+    core?: Core;
+    profile_image_shape?: string;
+    verification?: Verification;
+    affiliates_highlighted_label?: unknown;
+    is_blue_verified?: boolean;
+    privacy?: Privacy;
+    about_profile?: AboutProfile;
+    verification_info?: VerificationInfo;
+    identity_profile_labels_highlighted_label?: unknown;
+}
+interface Avatar {
+    image_url: string;
+}
+interface Core {
+    created_at: string;
+    name: string;
+    screen_name: string;
+}
+interface Verification {
+    verified: boolean;
+}
+interface Privacy {
+    protected: boolean;
+}
+interface AboutProfile {
+    created_country_accurate?: boolean;
+    account_based_in?: string;
+    location_accurate?: boolean;
+    learn_more_url?: string;
+    source?: string;
+    username_changes?: UsernameChanges;
+}
+interface UsernameChanges {
+    count?: string;
+    last_changed_at_msec?: string;
+}
+interface VerificationInfo {
+    reason?: VerificationReason;
+    id?: string;
+    is_identity_verified?: boolean;
+}
+interface VerificationReason {
+    verified_since_msec?: string;
+}
+export {};

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

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

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * The raw data received when changing the account password.
+ *
+ * @public
+ */
+export interface IUserChangePasswordResponse {
+    status: string;
+}

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

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

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

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

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

@@ -37,6 +37,7 @@ export interface IUserProfileUpdateResponse {
     profile_image_url: string;
     profile_image_url_https: string;
     profile_banner_url: string;
+    profile_banner_url_https?: string;
     profile_link_color: string;
     profile_sidebar_border_color: string;
     profile_sidebar_fill_color: string;

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

@@ -0,0 +1,21 @@
+/**
+ * The raw data received from the account settings endpoint.
+ *
+ * @public
+ */
+export interface IUserSettingsResponse {
+    screen_name: string;
+    protected: boolean;
+    language: string;
+    geo_enabled: boolean;
+    discoverable_by_email: boolean;
+    discoverable_by_mobile_phone: boolean;
+    use_cookie_personalization: boolean;
+    sleep_time: {
+        enabled: boolean;
+        end_time: any;
+        start_time: any;
+    };
+    display_sensitive_media: boolean;
+    allow_media_tagging: string;
+}

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

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

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "rettiwt-api",
-	"version": "6.3.0-alpha.1",
+	"version": "7.0.0",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
 	"description": "An API for fetching data from TwitterAPI, without any rate limits!",
@@ -40,7 +40,7 @@
 		"@typescript-eslint/parser": "^8.24.0",
 		"eslint": "^9.20.1",
 		"eslint-plugin-import": "^2.31.0",
-		"eslint-plugin-tsdoc": "^0.4.0",
+		"eslint-plugin-tsdoc": "^0.5.2",
 		"nodemon": "^3.1.9",
 		"prettier": "^3.5.1",
 		"typedoc": "^0.27.7",
@@ -51,9 +51,11 @@
 		"chalk": "^5.4.1",
 		"commander": "^11.1.0",
 		"cookiejar": "^2.1.4",
+		"http-proxy-agent": "^7.0.2",
 		"https-proxy-agent": "^7.0.6",
-		"jsdom": "^27.2.0",
+		"linkedom": "^0.18.12",
 		"node-html-parser": "^7.0.1",
+		"socks-proxy-agent": "^8.0.5",
 		"x-client-transaction-id": "^0.2.0"
 	}
 }

package/src/Rettiwt.ts

@@ -1,6 +1,9 @@
+import { AxiosProxyConfig } from 'axios';
+
 import { RettiwtConfig } from './models/RettiwtConfig';
 import { DirectMessageService } from './services/public/DirectMessageService';
 import { ListService } from './services/public/ListService';
+import { SpaceService } from './services/public/SpaceService';
 import { TweetService } from './services/public/TweetService';
 import { UserService } from './services/public/UserService';
 import { IRettiwtConfig } from './types/RettiwtConfig';
@@ -56,6 +59,9 @@ export class Rettiwt {
 	/** The instance used to fetch data related to lists. */
 	public list: ListService;
 
+	/** The instance used to fetch data related to spaces. */
+	public space: SpaceService;
+
 	/** The instance used to fetch data related to tweets. */
 	public tweet: TweetService;
 
@@ -71,6 +77,7 @@ export class Rettiwt {
 		this._config = new RettiwtConfig(config);
 		this.dm = new DirectMessageService(this._config);
 		this.list = new ListService(this._config);
+		this.space = new SpaceService(this._config);
 		this.tweet = new TweetService(this._config);
 		this.user = new UserService(this._config);
 	}
@@ -90,8 +97,8 @@ export class Rettiwt {
 		this._config.headers = headers;
 	}
 
-	/** Set the proxy URL for the current instance. */
-	public set proxyUrl(proxyUrl: URL) {
-		this._config.proxyUrl = proxyUrl;
+	/** Set the proxy for the current instance. */
+	public set proxy(proxy: AxiosProxyConfig | string | undefined | null) {
+		this._config.proxy = proxy;
 	}
 }

package/src/cli.ts

@@ -4,6 +4,7 @@ import { createCommand } from 'commander';
 
 import dm from './commands/DirectMessage';
 import list from './commands/List';
+import space from './commands/Space';
 import tweet from './commands/Tweet';
 import user from './commands/User';
 import { Rettiwt } from './Rettiwt';
@@ -32,7 +33,7 @@ Program.parse();
 const RettiwtInstance = new Rettiwt({
 	apiKey: process.env.API_KEY ?? (Program.opts().key as string),
 	logging: Program.opts().log ? true : false,
-	proxyUrl: Program.opts().proxy as URL,
+	proxy: Program.opts().proxy as string,
 	timeout: Program.opts().timeout ? Number(Program.opts().timeout) : undefined,
 	maxRetries: Program.opts().retries as number,
 	delay: Program.opts().delay as number,
@@ -41,6 +42,7 @@ const RettiwtInstance = new Rettiwt({
 // Adding sub-commands
 Program.addCommand(dm(RettiwtInstance));
 Program.addCommand(list(RettiwtInstance));
+Program.addCommand(space(RettiwtInstance));
 Program.addCommand(tweet(RettiwtInstance));
 Program.addCommand(user(RettiwtInstance));
 

package/src/collections/Extractors.ts

@@ -6,8 +6,10 @@ 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 { Space } from '../models/data/Space';
 import { Tweet } from '../models/data/Tweet';
 import { User } from '../models/data/User';
+import { UserAbout } from '../models/data/UserAbout';
 import { IConversationTimelineResponse } from '../types/raw/dm/Conversation';
 import { IInboxInitialResponse } from '../types/raw/dm/InboxInitial';
 import { IInboxTimelineResponse } from '../types/raw/dm/InboxTimeline';
@@ -17,12 +19,13 @@ 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 { 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 { ITweetLikeResponse } from '../types/raw/tweet/Like';
 import { ITweetLikersResponse } from '../types/raw/tweet/Likers';
-import { ITweetPostResponse } from '../types/raw/tweet/Post';
+import { ITweetPostNoteResponse, ITweetPostResponse } from '../types/raw/tweet/Post';
 import { ITweetRepliesResponse } from '../types/raw/tweet/Replies';
 import { ITweetRetweetResponse } from '../types/raw/tweet/Retweet';
 import { ITweetRetweetersResponse } from '../types/raw/tweet/Retweeters';
@@ -33,11 +36,13 @@ 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 { IUserAboutResponse } from '../types/raw/user/About';
 import { IUserAffiliatesResponse } from '../types/raw/user/Affiliates';
 import { IUserAnalyticsResponse } from '../types/raw/user/Analytics';
 import { IUserBookmarkFoldersResponse } from '../types/raw/user/BookmarkFolders';
 import { IUserBookmarkFolderTweetsResponse } from '../types/raw/user/BookmarkFolderTweets';
 import { IUserBookmarksResponse } from '../types/raw/user/Bookmarks';
+import { IUserChangePasswordResponse } from '../types/raw/user/ChangePassword';
 import { IUserDetailsResponse } from '../types/raw/user/Details';
 import { IUserDetailsBulkResponse } from '../types/raw/user/DetailsBulk';
 import { IUserFollowResponse } from '../types/raw/user/Follow';
@@ -52,6 +57,7 @@ import { IUserNotificationsResponse } from '../types/raw/user/Notifications';
 import { IUserProfileUpdateResponse } from '../types/raw/user/ProfileUpdate';
 import { IUserRecommendedResponse } from '../types/raw/user/Recommended';
 import { IUserSearchResponse } from '../types/raw/user/Search';
+import { IUserSettingsResponse } from '../types/raw/user/Settings';
 import { IUserSubscriptionsResponse } from '../types/raw/user/Subscriptions';
 import { IUserTweetsResponse } from '../types/raw/user/Tweets';
 import { IUserTweetsAndRepliesResponse } from '../types/raw/user/TweetsAndReplies';
@@ -85,6 +91,8 @@ export const Extractors = {
 	DM_INBOX_INITIAL_STATE: (response: IInboxInitialResponse): Inbox => new Inbox(response),
 	DM_INBOX_TIMELINE: (response: IInboxTimelineResponse): Inbox => new Inbox(response),
 
+	SPACE_DETAILS: (response: IAudioSpaceByIdResponse): Space | undefined => Space.single(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),
@@ -92,8 +100,12 @@ export const Extractors = {
 	TWEET_LIKE: (response: ITweetLikeResponse): boolean => (response?.data?.favorite_tweet ? true : false),
 	TWEET_LIKERS: (response: ITweetLikersResponse): CursoredData<User> =>
 		new CursoredData<User>(response, BaseType.USER),
-	TWEET_POST: (response: ITweetPostResponse): string =>
-		response?.data?.create_tweet?.tweet_results?.result?.rest_id ?? undefined,
+	TWEET_POST: (response: ITweetPostResponse): string | undefined =>
+		response?.data?.create_tweet?.tweet_results?.result?.rest_id ??
+		response?.data?.create_note_tweet?.tweet_results?.result?.rest_id ??
+		undefined,
+	TWEET_POST_NOTE: (response: ITweetPostNoteResponse): string | undefined =>
+		response?.data?.notetweet_create?.tweet_results?.result?.rest_id ?? undefined,
 	TWEET_REPLIES: (response: ITweetDetailsResponse): CursoredData<Tweet> =>
 		new CursoredData<Tweet>(response, BaseType.TWEET),
 	TWEET_RETWEET: (response: ITweetRetweetResponse): boolean => (response?.data?.create_retweet ? true : false),
@@ -119,6 +131,7 @@ export const Extractors = {
 		new CursoredData<BookmarkFolder>(response, BaseType.BOOKMARK_FOLDER),
 	USER_BOOKMARK_FOLDER_TWEETS: (response: IUserBookmarkFolderTweetsResponse): CursoredData<Tweet> =>
 		new CursoredData<Tweet>(response, BaseType.TWEET),
+	USER_ABOUT_BY_USERNAME: (response: IUserAboutResponse): UserAbout | undefined => UserAbout.single(response),
 	USER_DETAILS_BY_USERNAME: (response: IUserDetailsResponse): User | undefined => User.single(response),
 	USER_DETAILS_BY_ID: (response: IUserDetailsResponse): User | undefined => User.single(response),
 	USER_DETAILS_BY_IDS_BULK: (response: IUserDetailsBulkResponse, ids: string[]): User[] =>
@@ -150,6 +163,12 @@ export const Extractors = {
 		new CursoredData<Tweet>(response, BaseType.TWEET),
 	USER_UNFOLLOW: (response: IUserUnfollowResponse): boolean => (response?.id ? true : false),
 	USER_PROFILE_UPDATE: (response: IUserProfileUpdateResponse): boolean => (response?.name ? true : false),
+	USER_PROFILE_IMAGE_UPDATE: (response: IUserProfileUpdateResponse): boolean =>
+		response?.profile_image_url || response?.profile_image_url_https ? true : false,
+	USER_PROFILE_BANNER_UPDATE: (response: IUserProfileUpdateResponse): boolean =>
+		!response || response?.profile_banner_url || response?.profile_banner_url_https ? true : false,
+	USER_USERNAME_CHANGE: (response: IUserSettingsResponse): string | undefined => response?.screen_name ?? undefined,
+	USER_PASSWORD_CHANGE: (response: IUserChangePasswordResponse): boolean => response?.status === 'ok',
 
 	/* eslint-enable @typescript-eslint/naming-convention */
 };

package/src/collections/Groups.ts

@@ -9,6 +9,7 @@ export const AllowGuestAuthenticationGroup = [
 	ResourceType.TWEET_DETAILS,
 	ResourceType.USER_DETAILS_BY_USERNAME,
 	ResourceType.USER_TIMELINE,
+	ResourceType.SPACE_DETAILS,
 ];
 
 /**
@@ -23,6 +24,7 @@ export const FetchResourcesGroup = [
 	ResourceType.DM_CONVERSATION,
 	ResourceType.DM_INBOX_INITIAL_STATE,
 	ResourceType.DM_INBOX_TIMELINE,
+	ResourceType.SPACE_DETAILS,
 	ResourceType.TWEET_DETAILS,
 	ResourceType.TWEET_DETAILS_ALT,
 	ResourceType.TWEET_DETAILS_BULK,
@@ -35,6 +37,7 @@ export const FetchResourcesGroup = [
 	ResourceType.USER_BOOKMARKS,
 	ResourceType.USER_BOOKMARK_FOLDERS,
 	ResourceType.USER_BOOKMARK_FOLDER_TWEETS,
+	ResourceType.USER_ABOUT_BY_USERNAME,
 	ResourceType.USER_DETAILS_BY_USERNAME,
 	ResourceType.USER_DETAILS_BY_ID,
 	ResourceType.USER_DETAILS_BY_IDS_BULK,
@@ -68,6 +71,7 @@ export const PostResourcesGroup = [
 	ResourceType.TWEET_BOOKMARK,
 	ResourceType.TWEET_LIKE,
 	ResourceType.TWEET_POST,
+	ResourceType.TWEET_POST_NOTE,
 	ResourceType.TWEET_RETWEET,
 	ResourceType.TWEET_SCHEDULE,
 	ResourceType.TWEET_UNBOOKMARK,
@@ -78,4 +82,8 @@ export const PostResourcesGroup = [
 	ResourceType.USER_FOLLOW,
 	ResourceType.USER_UNFOLLOW,
 	ResourceType.USER_PROFILE_UPDATE,
+	ResourceType.USER_PROFILE_IMAGE_UPDATE,
+	ResourceType.USER_PROFILE_BANNER_UPDATE,
+	ResourceType.USER_USERNAME_CHANGE,
+	ResourceType.USER_PASSWORD_CHANGE,
 ];

package/src/collections/Requests.ts

@@ -4,6 +4,7 @@ import { ResourceType } from '../enums/Resource';
 import { DMRequests } from '../requests/DirectMessage';
 import { ListRequests } from '../requests/List';
 import { MediaRequests } from '../requests/Media';
+import { SpaceRequests } from '../requests/Space';
 import { TweetRequests } from '../requests/Tweet';
 import { UserRequests } from '../requests/User';
 import { IFetchArgs } from '../types/args/FetchArgs';
@@ -34,6 +35,9 @@ export const Requests: { [key in keyof typeof ResourceType]: (args: IFetchArgs |
 	DM_INBOX_TIMELINE: (args: IFetchArgs) => DMRequests.inboxTimeline(args.maxId),
 	DM_DELETE_CONVERSATION: (args: IPostArgs) => DMRequests.deleteConversation(args.conversationId!),
 
+	SPACE_DETAILS: (args: IFetchArgs) =>
+		SpaceRequests.details(args.id!, args.withReplays, args.withListeners, args.isMetatagsQuery),
+
 	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!),
@@ -41,6 +45,7 @@ export const Requests: { [key in keyof typeof ResourceType]: (args: IFetchArgs |
 	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!),
+	TWEET_POST_NOTE: (args: IPostArgs) => TweetRequests.postNote(args.tweet!),
 	TWEET_REPLIES: (args: IFetchArgs) =>
 		TweetRequests.replies(args.id!, args.cursor, args.sortBy ? TweetRepliesSortTypeMap[args.sortBy] : undefined),
 	TWEET_RETWEET: (args: IPostArgs) => TweetRequests.retweet(args.id!),
@@ -66,6 +71,7 @@ export const Requests: { [key in keyof typeof ResourceType]: (args: IFetchArgs |
 	USER_BOOKMARK_FOLDERS: (args: IFetchArgs) => UserRequests.bookmarkFolders(args.cursor),
 	USER_BOOKMARK_FOLDER_TWEETS: (args: IFetchArgs) =>
 		UserRequests.bookmarkFolderTweets(args.id!, args.count, args.cursor),
+	USER_ABOUT_BY_USERNAME: (args: IFetchArgs) => UserRequests.aboutByUsername(args.id!),
 	USER_DETAILS_BY_USERNAME: (args: IFetchArgs) => UserRequests.detailsByUsername(args.id!),
 	USER_DETAILS_BY_ID: (args: IFetchArgs) => UserRequests.detailsById(args.id!),
 	USER_DETAILS_BY_IDS_BULK: (args: IFetchArgs) => UserRequests.bulkDetailsByIds(args.ids!),
@@ -85,6 +91,11 @@ export const Requests: { [key in keyof typeof ResourceType]: (args: IFetchArgs |
 	USER_TIMELINE_AND_REPLIES: (args: IFetchArgs) => UserRequests.tweetsAndReplies(args.id!, args.count, args.cursor),
 	USER_UNFOLLOW: (args: IPostArgs) => UserRequests.unfollow(args.id!),
 	USER_PROFILE_UPDATE: (args: IPostArgs) => UserRequests.updateProfile(args.profileOptions!),
+	USER_PROFILE_IMAGE_UPDATE: (args: IPostArgs) => UserRequests.updateProfileImage(args.profileImage!),
+	USER_PROFILE_BANNER_UPDATE: (args: IPostArgs) => UserRequests.updateProfileBanner(args.profileBanner!),
+	USER_USERNAME_CHANGE: (args: IPostArgs) => UserRequests.changeUsername(args.username!),
+	USER_PASSWORD_CHANGE: (args: IPostArgs) =>
+		UserRequests.changePassword(args.changePassword!.currentPassword, args.changePassword!.newPassword),
 
 	/* eslint-enable @typescript-eslint/naming-convention */
 };

package/src/commands/Space.ts

@@ -0,0 +1,46 @@
+import { Command, createCommand } from 'commander';
+
+import { output } from '../helper/CliUtils';
+import { Rettiwt } from '../Rettiwt';
+
+interface ISpaceDetailsOptions {
+	withReplays?: boolean;
+	withListeners?: boolean;
+	metatags?: boolean;
+}
+
+/**
+ * Creates a new 'space' command which uses the given Rettiwt instance.
+ *
+ * @param rettiwt - The Rettiwt instance to use.
+ * @returns The created 'space' command.
+ */
+function createSpaceCommand(rettiwt: Rettiwt): Command {
+	// Creating the 'space' command
+	const space = createCommand('space').description('Access resources related to spaces');
+
+	// Details
+	space
+		.command('details')
+		.description('Fetch the details of a space with the given id')
+		.argument('<id>', 'The id of the space')
+		.option('--with-replays', 'Include replay information')
+		.option('--with-listeners', 'Include listeners information')
+		.option('--metatags', 'Request metatags in the response')
+		.action(async (id: string, options?: ISpaceDetailsOptions) => {
+			try {
+				const details = await rettiwt.space.details(id, {
+					withReplays: options?.withReplays,
+					withListeners: options?.withListeners,
+					isMetatagsQuery: options?.metatags,
+				});
+				output(details);
+			} catch (error) {
+				output(error);
+			}
+		});
+
+	return space;
+}
+
+export default createSpaceCommand;

package/src/commands/User.ts

@@ -1,3 +1,7 @@
+import { readFileSync } from 'fs';
+import { createInterface } from 'readline/promises';
+import { Writable } from 'stream';
+
 import { Command, createCommand } from 'commander';
 
 import { RawAnalyticsGranularity, RawAnalyticsMetric } from '../enums/raw/Analytics';
@@ -110,6 +114,19 @@ function createUserCommand(rettiwt: Rettiwt): Command {
 			}
 		});
 
+	// About
+	user.command('about')
+		.description('Fetch the about profile of the user with the given username')
+		.argument('<username>', 'The username of the user')
+		.action(async (username: string) => {
+			try {
+				const about = await rettiwt.user.about(username);
+				output(about);
+			} catch (error) {
+				output(error);
+			}
+		});
+
 	// Details
 	user.command('details')
 		.description('Fetch the details of the user with the given id/username')
@@ -340,9 +357,144 @@ function createUserCommand(rettiwt: Rettiwt): Command {
 			}
 		});
 
+	// Change Password
+	user.command('change-password')
+		.description('Change your account password')
+		.option('--show-new-key', 'Include rotated apiKey in the output')
+		.action(async (options?: UserPasswordChangeOptions) => {
+			try {
+				const initialApiKey = rettiwt.apiKey;
+				const currentPassword = await promptHidden('Current password: ');
+				const newPassword = await promptHidden('New password: ');
+				const confirmPassword = await promptHidden('Confirm new password: ');
+
+				if (newPassword !== confirmPassword) {
+					throw new Error('New password confirmation does not match');
+				}
+				if (newPassword === currentPassword) {
+					throw new Error('New password must be different from current password');
+				}
+
+				const result = await rettiwt.user.changePassword(currentPassword, newPassword);
+				const apiKeyUpdated = initialApiKey !== rettiwt.apiKey;
+				const response = {
+					success: result,
+					apiKeyUpdated: result ? apiKeyUpdated : false,
+					...(options?.showNewKey ? { apiKey: rettiwt.apiKey } : {}),
+				};
+
+				output(response);
+			} catch (error) {
+				output(error);
+			}
+		});
+
+	// Change Username
+	user.command('change-username')
+		.description('Change your username')
+		.argument('<username>', 'The new username (with or without @)')
+		.action(async (username: string) => {
+			try {
+				const result = await rettiwt.user.changeUsername(username);
+				output(result);
+			} catch (error) {
+				output(error);
+			}
+		});
+
+	// Update Profile Banner
+	user.command('update-profile-banner')
+		.description('Update your profile banner from an image file path')
+		.argument('<path>', 'The path to the banner image file')
+		.action(async (path: string) => {
+			try {
+				const result = await rettiwt.user.updateProfileBanner(fileToBase64(path));
+				output(result);
+			} catch (error) {
+				output(error);
+			}
+		});
+
+	// Update Profile Image
+	user.command('update-profile-image')
+		.description('Update your profile image from an image file path')
+		.argument('<path>', 'The path to the profile image file')
+		.action(async (path: string) => {
+			try {
+				const result = await rettiwt.user.updateProfileImage(fileToBase64(path));
+				output(result);
+			} catch (error) {
+				output(error);
+			}
+		});
+
 	return user;
 }
 
+/**
+ * Reads a file and returns its base64 representation.
+ *
+ * @param path - The path to the file.
+ * @returns The base64 representation of the file contents.
+ */
+function fileToBase64(path: string): string {
+	if (path.trim().length === 0) {
+		throw new Error('File path cannot be empty');
+	}
+
+	try {
+		return readFileSync(path).toString('base64');
+	} catch (error) {
+		if (error instanceof Error) {
+			throw new Error(`Could not read file at '${path}': ${error.message}`);
+		}
+
+		throw new Error(`Could not read file at '${path}'`);
+	}
+}
+
+/**
+ * Prompts user for hidden input without echoing typed characters.
+ *
+ * @param query - The prompt text.
+ * @returns The provided value.
+ */
+async function promptHidden(query: string): Promise<string> {
+	if (!process.stdin.isTTY || !process.stdout.isTTY) {
+		throw new Error('Password prompt requires an interactive terminal');
+	}
+
+	let queryShown = false;
+
+	const mutedOutput = new Writable({
+		write(chunk: Buffer | string, encoding: BufferEncoding, callback: (error?: Error | null) => void): void {
+			const text = chunk.toString();
+
+			if (!queryShown) {
+				process.stdout.write(text);
+				queryShown = text.includes(query);
+			}
+
+			callback();
+		},
+	});
+
+	const input = createInterface({
+		input: process.stdin,
+		output: mutedOutput,
+		terminal: true,
+	});
+
+	try {
+		const value = await input.question(query);
+		process.stdout.write('\n');
+
+		return value;
+	} finally {
+		input.close();
+	}
+}
+
 /**
  * The options for fetching user analytics.
  */
@@ -364,4 +516,11 @@ type UserProfileUpdateOptions = {
 	description?: string;
 };
 
+/**
+ * The options for changing account password.
+ */
+type UserPasswordChangeOptions = {
+	showNewKey?: boolean;
+};
+
 export default createUserCommand;

package/src/enums/Resource.ts

@@ -22,6 +22,9 @@ export enum ResourceType {
 	DM_INBOX_TIMELINE = 'DM_INBOX_TIMELINE',
 	DM_DELETE_CONVERSATION = 'DM_DELETE_CONVERSATION',
 
+	// SPACE
+	SPACE_DETAILS = 'SPACE_DETAILS',
+
 	// TWEET
 	TWEET_BOOKMARK = 'TWEET_BOOKMARK',
 	TWEET_DETAILS = 'TWEET_DETAILS',
@@ -30,6 +33,7 @@ export enum ResourceType {
 	TWEET_LIKE = 'TWEET_LIKE',
 	TWEET_LIKERS = 'TWEET_LIKERS',
 	TWEET_POST = 'TWEET_POST',
+	TWEET_POST_NOTE = 'TWEET_POST_NOTE',
 	TWEET_REPLIES = 'TWEET_REPLIES',
 	TWEET_RETWEET = 'TWEET_RETWEET',
 	TWEET_RETWEETERS = 'TWEET_RETWEETERS',
@@ -47,6 +51,7 @@ export enum ResourceType {
 	USER_BOOKMARKS = 'USER_BOOKMARKS',
 	USER_BOOKMARK_FOLDERS = 'USER_BOOKMARK_FOLDERS',
 	USER_BOOKMARK_FOLDER_TWEETS = 'USER_BOOKMARK_FOLDER_TWEETS',
+	USER_ABOUT_BY_USERNAME = 'USER_ABOUT_BY_USERNAME',
 	USER_DETAILS_BY_USERNAME = 'USER_DETAILS_BY_USERNAME',
 	USER_DETAILS_BY_ID = 'USER_DETAILS_BY_ID',
 	USER_DETAILS_BY_IDS_BULK = 'USER_DETAILS_BY_IDS_BULK',
@@ -66,4 +71,8 @@ export enum ResourceType {
 	USER_TIMELINE_AND_REPLIES = 'USER_TIMELINE_AND_REPLIES',
 	USER_UNFOLLOW = 'USER_UNFOLLOW',
 	USER_PROFILE_UPDATE = 'USER_PROFILE_UPDATE',
+	USER_PROFILE_IMAGE_UPDATE = 'USER_PROFILE_IMAGE_UPDATE',
+	USER_PROFILE_BANNER_UPDATE = 'USER_PROFILE_BANNER_UPDATE',
+	USER_USERNAME_CHANGE = 'USER_USERNAME_CHANGE',
+	USER_PASSWORD_CHANGE = 'USER_PASSWORD_CHANGE',
 }