@youmind-openlab/rettiwt-api 1.0.1 → 1.0.2

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,

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!),
@@ -66,6 +70,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!),

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

@@ -110,6 +110,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')

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',
@@ -47,6 +50,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',

package/src/index.ts

@@ -26,14 +26,17 @@ export * from './models/data/DirectMessage';
 export * from './models/data/Inbox';
 export * from './models/data/List';
 export * from './models/data/Notification';
+export * from './models/data/Space';
 export * from './models/data/Tweet';
 export * from './models/data/User';
+export * from './models/data/UserAbout';
 export * from './models/errors/TwitterError';
 
 // REQUESTS
 export * from './requests/DirectMessage';
 export * from './requests/List';
 export * from './requests/Media';
+export * from './requests/Space';
 export * from './requests/Tweet';
 export * from './requests/User';
 
@@ -41,6 +44,7 @@ export * from './requests/User';
 export * from './services/public/DirectMessageService';
 export * from './services/public/FetcherService';
 export * from './services/public/ListService';
+export * from './services/public/SpaceService';
 export * from './services/public/TweetService';
 export * from './services/public/UserService';
 
@@ -55,8 +59,10 @@ export * from './types/data/DirectMessage';
 export * from './types/data/Inbox';
 export * from './types/data/List';
 export * from './types/data/Notification';
+export * from './types/data/Space';
 export * from './types/data/Tweet';
 export * from './types/data/User';
+export * from './types/data/UserAbout';
 export * from './types/errors/TwitterError';
 export * from './types/params/Variables';
 export { IAnalytics as IRawAnalytics } from './types/raw/base/Analytic';
@@ -68,7 +74,7 @@ export { IList as IRawList } from './types/raw/base/List';
 export { IMedia as IRawMedia } from './types/raw/base/Media';
 export { IMessage as IRawMessage } from './types/raw/base/Message';
 export { INotification as IRawNotification } from './types/raw/base/Notification';
-export { ISpace as IRawSpace } from './types/raw/base/Space';
+export { IRawSpace } from './types/raw/base/Space';
 export { ITweet as IRawTweet } from './types/raw/base/Tweet';
 export { IUser as IRawUser } from './types/raw/base/User';
 export { IDataResult as IRawDataResult } from './types/raw/composite/DataResult';
@@ -83,6 +89,7 @@ export { IListTweetsResponse as IRawListTweetsResponse } from './types/raw/list/
 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 { ITweetLikeResponse as IRawTweetLikeResponse } from './types/raw/tweet/Like';
@@ -97,6 +104,7 @@ export { ITweetUnlikeResponse as IRawTweetUnlikeResponse } from './types/raw/twe
 export { ITweetUnpostResponse as IRawTweetUnpostResponse } from './types/raw/tweet/Unpost';
 export { ITweetUnretweetResponse as IRawTweetUnretweetResponse } from './types/raw/tweet/Unretweet';
 export { ITweetUnscheduleResponse as ITRawTweetUnscheduleResponse } from './types/raw/tweet/Unschedule';
+export { IUserAboutResponse as IRawUserAboutResponse } from './types/raw/user/About';
 export { IUserAffiliatesResponse as IRawUserAffiliatesResponse } from './types/raw/user/Affiliates';
 export { IUserAnalyticsResponse as IRawUserAnalyticsResponse } from './types/raw/user/Analytics';
 export { IUserBookmarkFoldersResponse as IRawUserBookmarkFoldersResponse } from './types/raw/user/BookmarkFolders';

package/src/models/args/FetchArgs.ts

@@ -17,11 +17,14 @@ export class FetchArgs implements IFetchArgs {
 	public granularity?: RawAnalyticsGranularity;
 	public id?: string;
 	public ids?: string[];
+	public isMetatagsQuery?: boolean;
 	public maxId?: string;
 	public metrics?: RawAnalyticsMetric[];
 	public showVerifiedFollowers?: boolean;
 	public sortBy?: TweetRepliesSortType;
 	public toTime?: Date;
+	public withListeners?: boolean;
+	public withReplays?: boolean;
 
 	/**
 	 * @param args - Additional user-defined arguments for fetching the resource.
@@ -29,6 +32,7 @@ export class FetchArgs implements IFetchArgs {
 	public constructor(args: IFetchArgs) {
 		this.id = args.id;
 		this.ids = args.ids;
+		this.isMetatagsQuery = args.isMetatagsQuery;
 		this.count = args.count;
 		this.cursor = args.cursor;
 		this.filter = args.filter ? new TweetFilter(args.filter) : undefined;
@@ -41,6 +45,8 @@ export class FetchArgs implements IFetchArgs {
 		this.activeConversationId = args.activeConversationId;
 		this.conversationId = args.conversationId;
 		this.maxId = args.maxId;
+		this.withListeners = args.withListeners;
+		this.withReplays = args.withReplays;
 	}
 }
 

package/src/models/data/Space.ts

@@ -0,0 +1,201 @@
+import { LogActions } from '../../enums/Logging';
+import { LogService } from '../../services/internal/LogService';
+import { ISpace, ISpaceParticipant, ISpaceParticipants } from '../../types/data/Space';
+import {
+	IAudioSpace,
+	IAudioSpaceByIdResponse,
+	IAudioSpaceParticipant,
+	IAudioSpaceParticipants,
+} from '../../types/raw/space/AudioSpaceById';
+
+/**
+ * The details of a single Space.
+ *
+ * @public
+ */
+export class Space implements ISpace {
+	/** The raw space details. */
+	private readonly _raw: IAudioSpace;
+
+	public conversationControls?: number;
+	public createdAt?: string;
+	public creatorId?: string;
+	public disallowJoin?: boolean;
+	public endedAt?: string;
+	public id: string;
+	public isEmployeeOnly?: boolean;
+	public isLocked?: boolean;
+	public isMuted?: boolean;
+	public isSpaceAvailableForClipping?: boolean;
+	public isSpaceAvailableForReplay?: boolean;
+	public isSubscribed?: boolean;
+	public mediaKey?: string;
+	public noIncognito?: boolean;
+	public participantCount?: number;
+	public participants?: ISpaceParticipants;
+	public scheduledStart?: string;
+	public startedAt?: string;
+	public state?: string;
+	public title?: string;
+	public totalLiveListeners?: number;
+	public totalReplayWatched?: number;
+	public updatedAt?: string;
+
+	/**
+	 * @param space - The raw space details.
+	 */
+	public constructor(space: IAudioSpace) {
+		this._raw = { ...space };
+
+		const metadata = space.metadata;
+
+		this.id = metadata?.rest_id ?? '';
+		this.state = metadata?.state;
+		this.title = metadata?.title;
+		this.mediaKey = metadata?.media_key;
+		this.createdAt = Space._timestampToIso(metadata?.created_at);
+		this.scheduledStart = Space._timestampToIso(metadata?.scheduled_start);
+		this.startedAt = Space._timestampToIso(metadata?.started_at);
+		this.endedAt = Space._timestampToIso(metadata?.ended_at);
+		this.updatedAt = Space._timestampToIso(metadata?.updated_at);
+		this.creatorId = metadata?.creator_results?.result?.rest_id ?? metadata?.creator_id;
+		this.conversationControls = metadata?.conversation_controls;
+		this.disallowJoin = metadata?.disallow_join;
+		this.isEmployeeOnly = metadata?.is_employee_only;
+		this.isLocked = metadata?.is_locked;
+		this.isMuted = metadata?.is_muted;
+		this.isSpaceAvailableForClipping = metadata?.is_space_available_for_clipping;
+		this.isSpaceAvailableForReplay = metadata?.is_space_available_for_replay;
+		this.noIncognito = metadata?.no_incognito;
+		this.totalLiveListeners = metadata?.total_live_listeners;
+		this.totalReplayWatched = metadata?.total_replay_watched;
+		this.participantCount = space.participants?.total ?? metadata?.participant_count;
+		this.isSubscribed = space.is_subscribed;
+		this.participants = Space._mapParticipants(space.participants);
+	}
+
+	/** The raw space details. */
+	public get raw(): IAudioSpace {
+		return { ...this._raw };
+	}
+
+	/**
+	 * Maps a raw participant to a deserialized participant.
+	 *
+	 * @param participant - The raw participant data.
+	 */
+	private static _mapParticipant(participant: IAudioSpaceParticipant): ISpaceParticipant {
+		const userId = participant.user_results?.rest_id ?? participant.user_results?.result?.rest_id;
+
+		return {
+			id: userId,
+			screenName: participant.twitter_screen_name,
+			displayName: participant.display_name,
+			avatarUrl: participant.avatar_url,
+			isVerified: participant.is_verified,
+			isMutedByAdmin: participant.is_muted_by_admin,
+			isMutedByGuest: participant.is_muted_by_guest,
+		};
+	}
+
+	/**
+	 * Maps raw participants to deserialized participants.
+	 *
+	 * @param participants - The raw participants data.
+	 */
+	private static _mapParticipants(participants?: IAudioSpaceParticipants): ISpaceParticipants | undefined {
+		if (!participants) {
+			return undefined;
+		}
+
+		return {
+			total: participants.total,
+			admins: (participants.admins ?? []).map((participant) => Space._mapParticipant(participant)),
+			speakers: (participants.speakers ?? []).map((participant) => Space._mapParticipant(participant)),
+			listeners: (participants.listeners ?? []).map((participant) => Space._mapParticipant(participant)),
+		};
+	}
+
+	/**
+	 * Convert timestamp to ISO string.
+	 *
+	 * @param value - The timestamp value.
+	 */
+	private static _timestampToIso(value?: number | string): string | undefined {
+		if (value == undefined) {
+			return undefined;
+		}
+
+		const numeric = typeof value === 'string' ? Number(value) : value;
+
+		if (!Number.isNaN(numeric)) {
+			return new Date(numeric).toISOString();
+		}
+
+		const parsed = new Date(value);
+
+		if (!Number.isNaN(parsed.getTime())) {
+			return parsed.toISOString();
+		}
+
+		return undefined;
+	}
+
+	/**
+	 * Extracts and deserializes a single target space from the given raw response data.
+	 *
+	 * @param response - The raw response data.
+	 *
+	 * @returns The target deserialized space.
+	 */
+	public static single(response: IAudioSpaceByIdResponse): Space | undefined {
+		const audioSpace = response.data?.audioSpace;
+		const spaceId = audioSpace?.metadata?.rest_id;
+
+		if (audioSpace && spaceId) {
+			// Logging
+			LogService.log(LogActions.DESERIALIZE, { id: spaceId });
+
+			return new Space(audioSpace);
+		}
+
+		// Logging
+		LogService.log(LogActions.WARNING, {
+			action: LogActions.DESERIALIZE,
+			message: 'Space not found, skipping',
+		});
+
+		return undefined;
+	}
+
+	/**
+	 * @returns A serializable JSON representation of `this` object.
+	 */
+	public toJSON(): ISpace {
+		return {
+			id: this.id,
+			state: this.state,
+			title: this.title,
+			mediaKey: this.mediaKey,
+			createdAt: this.createdAt,
+			scheduledStart: this.scheduledStart,
+			startedAt: this.startedAt,
+			endedAt: this.endedAt,
+			updatedAt: this.updatedAt,
+			creatorId: this.creatorId,
+			conversationControls: this.conversationControls,
+			disallowJoin: this.disallowJoin,
+			isEmployeeOnly: this.isEmployeeOnly,
+			isLocked: this.isLocked,
+			isMuted: this.isMuted,
+			isSpaceAvailableForClipping: this.isSpaceAvailableForClipping,
+			isSpaceAvailableForReplay: this.isSpaceAvailableForReplay,
+			noIncognito: this.noIncognito,
+			totalLiveListeners: this.totalLiveListeners,
+			totalReplayWatched: this.totalReplayWatched,
+			participantCount: this.participantCount,
+			isSubscribed: this.isSubscribed,
+			participants: this.participants,
+		};
+	}
+}

package/src/models/data/UserAbout.ts

@@ -0,0 +1,161 @@
+import { LogActions } from '../../enums/Logging';
+import { LogService } from '../../services/internal/LogService';
+import {
+	IUserAbout,
+	IUserAboutProfile,
+	IUserAboutUsernameChanges,
+	IUserAboutVerificationInfo,
+} from '../../types/data/UserAbout';
+import { IUserAboutResponse, IUserAboutResult } from '../../types/raw/user/About';
+
+/* eslint-disable @typescript-eslint/naming-convention */
+type IRawUsernameChanges = {
+	count?: string;
+	last_changed_at_msec?: string;
+};
+/* eslint-enable @typescript-eslint/naming-convention */
+
+/**
+ * The about profile details of a single user.
+ *
+ * @public
+ */
+export class UserAbout implements IUserAbout {
+	/** The raw about profile details. */
+	private readonly _raw: IUserAboutResult;
+
+	public aboutProfile?: IUserAboutProfile;
+	public createdAt: string;
+	public fullName: string;
+	public id: string;
+	public isProtected?: boolean;
+	public isVerified: boolean;
+	public profileImage: string;
+	public profileImageShape?: string;
+	public userName: string;
+	public verificationInfo?: IUserAboutVerificationInfo;
+
+	/**
+	 * @param user - The raw about profile details.
+	 */
+	public constructor(user: IUserAboutResult) {
+		this._raw = { ...user };
+
+		this.id = user.rest_id ?? user.id ?? '';
+		this.userName = user.core?.screen_name ?? '';
+		this.fullName = user.core?.name ?? '';
+		this.createdAt = new Date(user.core?.created_at ?? 0).toISOString();
+		this.profileImage = user.avatar?.image_url ?? '';
+		this.profileImageShape = user.profile_image_shape;
+		this.isVerified = user.is_blue_verified ?? false;
+		this.isProtected = user.privacy?.protected;
+		this.aboutProfile = UserAbout._buildAboutProfile(user);
+		this.verificationInfo = UserAbout._buildVerificationInfo(user);
+	}
+
+	/** The raw about profile details. */
+	public get raw(): IUserAboutResult {
+		return { ...this._raw };
+	}
+
+	private static _buildAboutProfile(user: IUserAboutResult): IUserAboutProfile | undefined {
+		const profile = user.about_profile;
+
+		if (!profile) {
+			return undefined;
+		}
+
+		const usernameChanges = UserAbout._buildUsernameChanges(profile.username_changes);
+
+		return {
+			createdCountryAccurate: profile.created_country_accurate,
+			accountBasedIn: profile.account_based_in,
+			locationAccurate: profile.location_accurate,
+			learnMoreUrl: profile.learn_more_url,
+			source: profile.source,
+			usernameChanges: usernameChanges,
+		};
+	}
+
+	private static _buildUsernameChanges(changes?: IRawUsernameChanges): IUserAboutUsernameChanges | undefined {
+		if (!changes) {
+			return undefined;
+		}
+
+		return {
+			count: UserAbout._toNumber(changes.count),
+			lastChangedAt: UserAbout._toIsoFromMsec(changes.last_changed_at_msec),
+		};
+	}
+
+	private static _buildVerificationInfo(user: IUserAboutResult): IUserAboutVerificationInfo | undefined {
+		const info = user.verification_info;
+
+		if (!info) {
+			return undefined;
+		}
+
+		return {
+			isIdentityVerified: info.is_identity_verified,
+			verifiedSince: UserAbout._toIsoFromMsec(info.reason?.verified_since_msec),
+		};
+	}
+
+	private static _toIsoFromMsec(value?: string | number): string | undefined {
+		const parsed = UserAbout._toNumber(value);
+
+		return parsed === undefined ? undefined : new Date(parsed).toISOString();
+	}
+
+	private static _toNumber(value?: string | number): number | undefined {
+		if (value === undefined || value === null) {
+			return undefined;
+		}
+
+		const parsed = typeof value === 'number' ? value : Number(value);
+
+		return Number.isFinite(parsed) ? parsed : undefined;
+	}
+
+	/**
+	 * Extracts and deserializes a single target user about profile from the given raw response data.
+	 *
+	 * @param response - The raw response data.
+	 *
+	 * @returns The target deserialized user about profile.
+	 */
+	public static single(response: NonNullable<unknown>): UserAbout | undefined {
+		const result = (response as IUserAboutResponse)?.data?.user_result_by_screen_name?.result;
+
+		if (!result || result.__typename !== 'User') {
+			LogService.log(LogActions.WARNING, {
+				action: LogActions.DESERIALIZE,
+				message: `User not found, skipping`,
+			});
+			return undefined;
+		}
+
+		// Logging
+		LogService.log(LogActions.DESERIALIZE, { id: result.rest_id ?? result.id });
+
+		return new UserAbout(result);
+	}
+
+	/**
+	 * @returns A serializable JSON representation of `this` object.
+	 */
+	public toJSON(): IUserAbout {
+		return {
+			id: this.id,
+			userName: this.userName,
+			fullName: this.fullName,
+			createdAt: this.createdAt,
+			profileImage: this.profileImage,
+			profileImageShape: this.profileImageShape,
+			isVerified: this.isVerified,
+			isProtected: this.isProtected,
+			aboutProfile: this.aboutProfile,
+			verificationInfo: this.verificationInfo,
+		};
+	}
+}

package/src/requests/List.ts

@@ -67,7 +67,7 @@ export class ListRequests {
 	public static members(id: string, count?: number, cursor?: string): AxiosRequestConfig {
 		return {
 			method: 'get',
-			url: 'https://x.com/i/api/graphql/Bnhcen0kdsMAU1tW7U79qQ/ListMembers',
+			url: 'https://x.com/i/api/graphql/7FPk01hdc1jyzL6Gj8vMZw/ListMembers',
 			params: {
 				/* eslint-disable @typescript-eslint/naming-convention */
 				variables: JSON.stringify({
@@ -153,7 +153,7 @@ export class ListRequests {
 	public static tweets(id: string, count?: number, cursor?: string): AxiosRequestConfig {
 		return {
 			method: 'get',
-			url: 'https://x.com/i/api/graphql/fqNUs_6rqLf89u_2waWuqg/ListLatestTweetsTimeline',
+			url: 'https://x.com/i/api/graphql/aJxgBm1YveGJCRiWJFx5WA/ListLatestTweetsTimeline',
 			params: {
 				/* eslint-disable @typescript-eslint/naming-convention */
 				variables: JSON.stringify({

package/src/requests/Space.ts

@@ -0,0 +1,76 @@
+import { AxiosRequestConfig } from 'axios';
+
+/**
+ * Collection of requests related to spaces.
+ *
+ * @public
+ */
+export class SpaceRequests {
+	/**
+	 * @param id - The id of the space whose details are to be fetched.
+	 * @param withReplays - Whether to include replay information.
+	 * @param withListeners - Whether to include listeners information.
+	 * @param isMetatagsQuery - Whether the request is a metatags query.
+	 */
+	public static details(
+		id: string,
+		withReplays?: boolean,
+		withListeners?: boolean,
+		isMetatagsQuery?: boolean,
+	): AxiosRequestConfig {
+		return {
+			method: 'get',
+			url: 'https://x.com/i/api/graphql/rR7CQrr8kxb6fatlUaB61Q/AudioSpaceById',
+			params: {
+				/* eslint-disable @typescript-eslint/naming-convention */
+				variables: JSON.stringify({
+					id: id,
+					isMetatagsQuery: isMetatagsQuery ?? false,
+					withReplays: withReplays ?? true,
+					withListeners: withListeners ?? false,
+				}),
+				features: JSON.stringify({
+					spaces_2022_h2_spaces_communities: true,
+					spaces_2022_h2_clipping: true,
+					creator_subscriptions_tweet_preview_api_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,
+					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,
+					responsive_web_jetfuel_frame: true,
+					responsive_web_grok_share_attachment_enabled: true,
+					responsive_web_grok_annotations_enabled: false,
+					articles_preview_enabled: true,
+					responsive_web_graphql_skip_user_profile_image_extensions_enabled: false,
+					responsive_web_edit_tweet_api_enabled: true,
+					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,
+					tweet_awards_web_tipping_enabled: false,
+					responsive_web_grok_show_grok_translated_post: false,
+					responsive_web_grok_analysis_button_from_backend: true,
+					post_ctas_fetch_enabled: true,
+					creator_subscriptions_quote_tweet_preview_enabled: false,
+					freedom_of_speech_not_reach_fetch_enabled: true,
+					standardized_nudges_misinfo: true,
+					tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled: true,
+					longform_notetweets_rich_text_read_enabled: true,
+					longform_notetweets_inline_media_enabled: true,
+					responsive_web_grok_image_annotation_enabled: true,
+					responsive_web_grok_imagine_annotation_enabled: true,
+					responsive_web_graphql_timeline_navigation_enabled: true,
+					responsive_web_grok_community_note_auto_translation_is_enabled: false,
+					responsive_web_enhance_cards_enabled: false,
+				}),
+				/* eslint-enable @typescript-eslint/naming-convention */
+			},
+			paramsSerializer: { encode: encodeURIComponent },
+		};
+	}
+}