rettiwt-api 6.0.7 → 6.1.0

package/src/enums/Resource.ts

@@ -5,6 +5,9 @@
  */
 export enum ResourceType {
 	// LIST
+	LIST_DETAILS = 'LIST_DETAILS',
+	LIST_MEMBER_ADD = 'LIST_MEMBER_ADD',
+	LIST_MEMBER_REMOVE = 'LIST_MEMBER_REMOVE',
 	LIST_MEMBERS = 'LIST_MEMBERS',
 	LIST_TWEETS = 'LIST_TWEETS',
 
@@ -13,7 +16,14 @@ export enum ResourceType {
 	MEDIA_UPLOAD_FINALIZE = 'MEDIA_UPLOAD_FINALIZE',
 	MEDIA_UPLOAD_INITIALIZE = 'MEDIA_UPLOAD_INITIALIZE',
 
+	// DM
+	DM_CONVERSATION = 'DM_CONVERSATION',
+	DM_INBOX_INITIAL_STATE = 'DM_INBOX_INITIAL_STATE',
+	DM_INBOX_TIMELINE = 'DM_INBOX_TIMELINE',
+	DM_DELETE_CONVERSATION = 'DM_DELETE_CONVERSATION',
+
 	// TWEET
+	TWEET_BOOKMARK = 'TWEET_BOOKMARK',
 	TWEET_DETAILS = 'TWEET_DETAILS',
 	TWEET_DETAILS_ALT = 'TWEET_DETAILS_ALT',
 	TWEET_DETAILS_BULK = 'TWEET_DETAILS_BULK',
@@ -25,6 +35,7 @@ export enum ResourceType {
 	TWEET_RETWEETERS = 'TWEET_RETWEETERS',
 	TWEET_SCHEDULE = 'TWEET_SCHEDULE',
 	TWEET_SEARCH = 'TWEET_SEARCH',
+	TWEET_UNBOOKMARK = 'TWEET_UNBOOKMARK',
 	TWEET_UNLIKE = 'TWEET_UNLIKE',
 	TWEET_UNPOST = 'TWEET_UNPOST',
 	TWEET_UNRETWEET = 'TWEET_UNRETWEET',
@@ -32,6 +43,7 @@ export enum ResourceType {
 
 	// USER
 	USER_AFFILIATES = 'USER_AFFILIATES',
+	USER_ANALYTICS = 'USER_ANALYTICS',
 	USER_BOOKMARKS = 'USER_BOOKMARKS',
 	USER_DETAILS_BY_USERNAME = 'USER_DETAILS_BY_USERNAME',
 	USER_DETAILS_BY_ID = 'USER_DETAILS_BY_ID',
@@ -43,6 +55,7 @@ export enum ResourceType {
 	USER_FOLLOWERS = 'USER_FOLLOWERS',
 	USER_HIGHLIGHTS = 'USER_HIGHLIGHTS',
 	USER_LIKES = 'USER_LIKES',
+	USER_LISTS = 'USER_LISTS',
 	USER_MEDIA = 'USER_MEDIA',
 	USER_NOTIFICATIONS = 'USER_NOTIFICATIONS',
 	USER_SUBSCRIPTIONS = 'USER_SUBSCRIPTIONS',

package/src/enums/raw/Analytics.ts

@@ -19,11 +19,14 @@ export enum RawAnalyticsMetric {
 	IMPRESSIONS = 'Impressions',
 	PROFILE_VISITS = 'ProfileVisits',
 	FOLLOWS = 'Follows',
-	VIDEO_VIEWS = 'VideoViews',
 	REPLIES = 'Replies',
 	LIKES = 'Likes',
 	RETWEETS = 'Retweets',
-	MEDIA_VIEWS = 'MediaViews',
 	BOOKMARK = 'Bookmark',
 	SHARE = 'Share',
+	URL_CLICKS = 'UrlClicks',
+	CREATE_TWEET = 'CreateTweet',
+	CREATE_QUOTE = 'CreateQuote',
+	CREATE_REPLY = 'CreateReply',
+	UNFOLLOWS = 'Unfollows',
 }

package/src/index.ts

@@ -18,7 +18,10 @@ export * from './enums/Tweet';
 // MODELS
 export * from './models/args/FetchArgs';
 export * from './models/args/PostArgs';
+export * from './models/data/Conversation';
 export * from './models/data/CursoredData';
+export * from './models/data/DirectMessage';
+export * from './models/data/Inbox';
 export * from './models/data/List';
 export * from './models/data/Notification';
 export * from './models/data/Tweet';
@@ -26,12 +29,14 @@ export * from './models/data/User';
 export * from './models/errors/TwitterError';
 
 // REQUESTS
+export * from './requests/DirectMessage';
 export * from './requests/List';
 export * from './requests/Media';
 export * from './requests/Tweet';
 export * from './requests/User';
 
 // SERVICES
+export * from './services/public/DirectMessageService';
 export * from './services/public/FetcherService';
 export * from './services/public/ListService';
 export * from './services/public/TweetService';
@@ -40,7 +45,10 @@ export * from './services/public/UserService';
 // TYPES
 export * from './types/args/FetchArgs';
 export * from './types/args/PostArgs';
+export * from './types/data/Conversation';
 export * from './types/data/CursoredData';
+export * from './types/data/DirectMessage';
+export * from './types/data/Inbox';
 export * from './types/data/List';
 export * from './types/data/Notification';
 export * from './types/data/Tweet';
@@ -53,6 +61,7 @@ export { IErrorData as IRawErrorData, IErrorDetails as IRawErrorDetails } from '
 export { ILimitedVisibilityTweet as IRawLimitedVisibilityTweet } from './types/raw/base/LimitedVisibilityTweet';
 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 { ITweet as IRawTweet } from './types/raw/base/Tweet';
@@ -61,6 +70,8 @@ export { IDataResult as IRawDataResult } from './types/raw/composite/DataResult'
 export { ITimelineTweet as IRawTimelineTweet } from './types/raw/composite/TimelineTweet';
 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 { IListDetailsResponse as IRawListDetailsResponse } from './types/raw/list/Details';
 export { IListMembersResponse as IRawListMembersResponse } from './types/raw/list/Members';
 export { IListTweetsResponse as IRawListTweetsResponse } from './types/raw/list/Tweets';
@@ -102,3 +113,7 @@ export { IUserTweetsAndRepliesResponse as IRawUserTweetsAndRepliesResponse } fro
 export { IUserUnfollowResponse as IRawUserUnfollowResponse } from './types/raw/user/Unfollow';
 export * from './types/ErrorHandler';
 export * from './types/RettiwtConfig';
+export { IConversationTimelineResponse as IRawConversationTimelineResponse } from './types/raw/dm/Conversation';
+export { IInboxInitialResponse as IRawInboxInitialResponse } from './types/raw/dm/InboxInitial';
+export { IInboxTimelineResponse as IRawInboxTimelineResponse } from './types/raw/dm/InboxTimeline';
+export { IUserUpdatesResponse as IRawUserUpdatesResponse } from './types/raw/dm/UserUpdates';

package/src/models/args/FetchArgs.ts

@@ -1,18 +1,27 @@
 import { TweetRepliesSortType } from '../../enums/Tweet';
 import { IFetchArgs, ITweetFilter } from '../../types/args/FetchArgs';
 
+import type { RawAnalyticsGranularity, RawAnalyticsMetric } from '../../enums/raw/Analytics';
 /**
  * Options specifying the data that is to be fetched.
  *
  * @public
  */
 export class FetchArgs implements IFetchArgs {
+	public activeConversationId?: string;
+	public conversationId?: string;
 	public count?: number;
 	public cursor?: string;
 	public filter?: TweetFilter;
+	public fromTime?: Date;
+	public granularity?: RawAnalyticsGranularity;
 	public id?: string;
 	public ids?: string[];
+	public maxId?: string;
+	public metrics?: RawAnalyticsMetric[];
+	public showVerifiedFollowers?: boolean;
 	public sortBy?: TweetRepliesSortType;
+	public toTime?: Date;
 
 	/**
 	 * @param args - Additional user-defined arguments for fetching the resource.
@@ -24,6 +33,14 @@ export class FetchArgs implements IFetchArgs {
 		this.cursor = args.cursor;
 		this.filter = args.filter ? new TweetFilter(args.filter) : undefined;
 		this.sortBy = args.sortBy;
+		this.fromTime = args.fromTime;
+		this.toTime = args.toTime;
+		this.granularity = args.granularity;
+		this.metrics = args.metrics;
+		this.showVerifiedFollowers = args.showVerifiedFollowers;
+		this.activeConversationId = args.activeConversationId;
+		this.conversationId = args.conversationId;
+		this.maxId = args.maxId;
 	}
 }
 

package/src/models/args/PostArgs.ts

@@ -9,6 +9,7 @@ export class PostArgs implements IPostArgs {
 	public id?: string;
 	public tweet?: NewTweet;
 	public upload?: UploadArgs;
+	public userId?: string;
 
 	/**
 	 * @param resource - The resource to be posted.
@@ -18,6 +19,7 @@ export class PostArgs implements IPostArgs {
 		this.id = args.id;
 		this.tweet = args.tweet ? new NewTweet(args.tweet) : undefined;
 		this.upload = args.upload ? new UploadArgs(args.upload) : undefined;
+		this.userId = args.userId;
 	}
 }
 

package/src/models/data/Analytics.ts

@@ -0,0 +1,97 @@
+import { RawAnalyticsMetric } from '../../enums/raw/Analytics';
+import { IAnalytics as IRawAnalytics } from '../../types/raw/base/Analytic';
+
+import type { IAnalytics } from '../../types/data/Analytics';
+import type { IAnalyticsMetric } from '../../types/raw/base/Analytic';
+
+/**
+ * The details of the analytic result of the connected User.
+ *
+ * @public
+ */
+export class Analytics implements IAnalytics {
+	/** The raw analytic details. */
+	private readonly _raw: IRawAnalytics;
+
+	public bookmarks: number;
+	public createQuote: number;
+	public createReply: number;
+	public createTweets: number;
+	public createdAt: string;
+	public engagements: number;
+	public followers: number;
+	public follows: number;
+	public impressions: number;
+	public likes: number;
+	public organicMetricsTimeSeries: IAnalyticsMetric[];
+	public profileVisits: number;
+	public replies: number;
+	public retweets: number;
+	public shares: number;
+	public unfollows: number;
+	public verifiedFollowers: number;
+
+	public constructor(analytics: IRawAnalytics) {
+		this._raw = { ...analytics };
+		this.organicMetricsTimeSeries = analytics.organic_metrics_time_series;
+		this.createdAt = new Date().toISOString();
+		this.followers = analytics.relationship_counts.followers;
+		this.verifiedFollowers = parseInt(analytics.verified_follower_count, 10);
+		this.impressions = this._reduceMetrics(RawAnalyticsMetric.IMPRESSIONS);
+		this.profileVisits = this._reduceMetrics(RawAnalyticsMetric.PROFILE_VISITS);
+		this.engagements = this._reduceMetrics(RawAnalyticsMetric.ENGAGEMENTS);
+		this.follows = this._reduceMetrics(RawAnalyticsMetric.FOLLOWS);
+		this.replies = this._reduceMetrics(RawAnalyticsMetric.REPLIES);
+		this.likes = this._reduceMetrics(RawAnalyticsMetric.LIKES);
+		this.retweets = this._reduceMetrics(RawAnalyticsMetric.RETWEETS);
+		this.bookmarks = this._reduceMetrics(RawAnalyticsMetric.BOOKMARK);
+		this.shares = this._reduceMetrics(RawAnalyticsMetric.SHARE);
+		this.createTweets = this._reduceMetrics(RawAnalyticsMetric.CREATE_TWEET);
+		this.createQuote = this._reduceMetrics(RawAnalyticsMetric.CREATE_QUOTE);
+		this.createReply = this._reduceMetrics(RawAnalyticsMetric.CREATE_REPLY);
+		this.unfollows = this._reduceMetrics(RawAnalyticsMetric.UNFOLLOWS);
+	}
+
+	/** The raw analytic details. */
+	public get raw(): IRawAnalytics {
+		return { ...this._raw };
+	}
+
+	/**
+	 * Reduces the organic metrics time series to a total value for a specific metric type.
+	 *
+	 * @param metricType - metricType The type of metric to reduce.
+	 * @returns the total value of the specified metric type across all time series.
+	 */
+	private _reduceMetrics(metricType: RawAnalyticsMetric): number {
+		return this.organicMetricsTimeSeries.reduce((acc, metric) => {
+			const metricValue = metric.metric_values.find((m) => m.metric_type === (metricType as string));
+			return acc + (metricValue ? metricValue.metric_value : 0);
+		}, 0);
+	}
+
+	/**
+	 * @returns A serializable JSON representation of `this` object.
+	 */
+	public toJSON(): IAnalytics {
+		return {
+			createdAt: this.createdAt,
+			followers: this.followers,
+			verifiedFollowers: this.verifiedFollowers,
+			impressions: this.impressions,
+			profileVisits: this.profileVisits,
+			engagements: this.engagements,
+			follows: this.follows,
+			replies: this.replies,
+			likes: this.likes,
+			retweets: this.retweets,
+			bookmarks: this.bookmarks,
+			shares: this.shares,
+			createTweets: this.createTweets,
+			createQuote: this.createQuote,
+			unfollows: this.unfollows,
+			createReply: this.createReply,
+			organicMetricsTimeSeries: this.organicMetricsTimeSeries,
+		};
+	}
+}

package/src/models/data/Conversation.ts

@@ -0,0 +1,344 @@
+import { IConversation } from '../../types/data/Conversation';
+import { IConversationTimelineResponse } from '../../types/raw/dm/Conversation';
+import {
+	IInboxInitialResponse,
+	Conversation as RawConversation,
+	Conversations as RawConversations,
+} from '../../types/raw/dm/InboxInitial';
+import { IInboxTimelineResponse } from '../../types/raw/dm/InboxTimeline';
+
+import { DirectMessage } from './DirectMessage';
+
+/**
+ * Type guard to check if the response is an IConversationTimelineResponse
+ */
+function isConversationTimelineResponse(
+	response: IConversationTimelineResponse | IInboxInitialResponse | IInboxTimelineResponse,
+): response is IConversationTimelineResponse {
+	return 'conversation_timeline' in response;
+}
+
+/**
+ * Type guard to check if the response is an IInboxInitialResponse
+ */
+function isInboxInitialResponse(
+	response: IConversationTimelineResponse | IInboxInitialResponse | IInboxTimelineResponse,
+): response is IInboxInitialResponse {
+	return 'inbox_initial_state' in response;
+}
+
+/**
+ * Type guard to check if the response is an IInboxTimelineResponse
+ */
+function isInboxTimelineResponse(
+	response: IConversationTimelineResponse | IInboxInitialResponse | IInboxTimelineResponse,
+): response is IInboxTimelineResponse {
+	return 'inbox_timeline' in response;
+}
+
+/**
+ * Extract typed conversation data from raw conversations object
+ */
+function extractConversationData(rawConversations: RawConversations): Array<[string, RawConversation]> {
+	return Object.entries(rawConversations);
+}
+
+/**
+ * The details of a single conversation.
+ *
+ * @public
+ */
+export class Conversation implements IConversation {
+	/** The raw conversation details. */
+	private readonly _raw: RawConversation;
+
+	public avatarUrl?: string;
+	public hasMore: boolean;
+	public id: string;
+	public lastActivityAt: string;
+	public lastMessageId?: string;
+	public messages: DirectMessage[];
+	public muted: boolean;
+	public name?: string;
+	public notificationsDisabled: boolean;
+	public participants: string[];
+	public trusted: boolean;
+	public type: 'ONE_TO_ONE' | 'GROUP_DM';
+
+	/**
+	 * @param conversation - The raw conversation details from the API response.
+	 * @param messages - Array of messages in this conversation.
+	 */
+	public constructor(conversation: unknown, messages: DirectMessage[] = []) {
+		this._raw = conversation as RawConversation;
+
+		const conv = conversation as Record<string, unknown>;
+
+		this.id = conv.conversation_id && typeof conv.conversation_id === 'string' ? conv.conversation_id : '';
+		this.type = this._parseConversationType(conv.type);
+		this.participants = this._parseParticipants(conv.participants);
+		this.name = conv.name && typeof conv.name === 'string' ? conv.name : undefined;
+		this.avatarUrl = this._parseAvatarUrl(conv);
+		this.trusted = Boolean(conv.trusted);
+		this.muted = Boolean(conv.muted);
+		this.notificationsDisabled = Boolean(conv.notifications_disabled);
+		this.lastActivityAt = this._parseTimestamp(conv.sort_timestamp);
+		this.lastMessageId =
+			conv.sort_event_id && typeof conv.sort_event_id === 'string' ? conv.sort_event_id : undefined;
+		this.hasMore = conv.status === 'HAS_MORE';
+		this.messages = messages;
+	}
+
+	/** The raw conversation details. */
+	public get raw(): RawConversation {
+		return this._raw;
+	}
+
+	/**
+	 * Parse avatar URL from conversation data
+	 */
+	private _parseAvatarUrl(conv: Record<string, unknown>): string | undefined {
+		// Try avatar_image_https first
+		if (conv.avatar_image_https && typeof conv.avatar_image_https === 'string') {
+			return conv.avatar_image_https;
+		}
+
+		// Try nested avatar.image.original_info.url
+		const avatar = conv.avatar as Record<string, unknown> | undefined;
+		const image = avatar?.image as Record<string, unknown> | undefined;
+		const originalInfo = image?.original_info as Record<string, unknown> | undefined;
+
+		if (originalInfo?.url && typeof originalInfo.url === 'string') {
+			return originalInfo.url;
+		}
+
+		return undefined;
+	}
+
+	/**
+	 * Parse conversation type with proper fallback
+	 */
+	private _parseConversationType(type: unknown): 'ONE_TO_ONE' | 'GROUP_DM' {
+		if (type === 'ONE_TO_ONE' || type === 'GROUP_DM') {
+			return type;
+		}
+		return 'ONE_TO_ONE';
+	}
+
+	/**
+	 * Parse participants array with type safety
+	 */
+	private _parseParticipants(participants: unknown): string[] {
+		if (!Array.isArray(participants)) {
+			return [];
+		}
+
+		return participants
+			.map((p) => {
+				if (p && typeof p === 'object' && 'user_id' in p) {
+					// eslint-disable-next-line @typescript-eslint/naming-convention
+					const participantObj = p as { user_id: unknown };
+					if (typeof participantObj.user_id === 'string') {
+						return participantObj.user_id;
+					}
+				}
+				return '';
+			})
+			.filter(Boolean);
+	}
+
+	/**
+	 * Parse timestamp with proper fallback
+	 */
+	private _parseTimestamp(timestamp: unknown): string {
+		if (timestamp && (typeof timestamp === 'string' || typeof timestamp === 'number')) {
+			const date = new Date(Number(timestamp));
+			if (!isNaN(date.getTime())) {
+				return date.toISOString();
+			}
+		}
+		return new Date().toISOString();
+	}
+
+	/**
+	 * Extracts a single conversation from conversation timeline response.
+	 *
+	 * @param response - The raw response data.
+	 *
+	 * @returns The deserialized conversation with full message history.
+	 */
+	public static fromConversationTimeline(response: IConversationTimelineResponse): Conversation | undefined {
+		if (!response.conversation_timeline?.conversations) {
+			return undefined;
+		}
+
+		const rawConversations = response.conversation_timeline.conversations;
+		const entries = response.conversation_timeline.entries ?? [];
+
+		// Extract messages from entries
+		const messages: DirectMessage[] = [];
+		for (const entry of entries) {
+			if ('message' in entry && entry.message) {
+				messages.push(new DirectMessage(entry.message));
+			}
+		}
+
+		// Get the first (and typically only) conversation
+		const conversationEntries = extractConversationData(rawConversations);
+		const firstEntry = conversationEntries[0];
+
+		if (firstEntry) {
+			const [, conversationData] = firstEntry;
+			return new Conversation(conversationData, messages);
+		}
+
+		return undefined;
+	}
+
+	/**
+	 * Extracts conversations from inbox initial state response.
+	 *
+	 * @param response - The raw response data.
+	 *
+	 * @returns The deserialized list of conversations with their preview messages.
+	 */
+	public static listFromInboxInitial(response: IInboxInitialResponse): Conversation[] {
+		const conversations: Conversation[] = [];
+
+		if (!response.inbox_initial_state?.conversations) {
+			return conversations;
+		}
+
+		const rawConversations = response.inbox_initial_state.conversations;
+		const entries = response.inbox_initial_state.entries ?? [];
+
+		// Group messages by conversation ID
+		const messagesByConversation = new Map<string, DirectMessage[]>();
+		for (const entry of entries) {
+			if ('message' in entry && entry.message) {
+				const message = new DirectMessage(entry.message);
+				const convId = message.conversationId;
+				if (convId) {
+					if (!messagesByConversation.has(convId)) {
+						messagesByConversation.set(convId, []);
+					}
+					messagesByConversation.get(convId)!.push(message);
+				}
+			}
+		}
+
+		// Create conversations with their messages
+		const conversationEntries = extractConversationData(rawConversations);
+		for (const [, conversation] of conversationEntries) {
+			const convId = (conversation as unknown as Record<string, unknown>).conversation_id as string;
+			const messages = messagesByConversation.get(convId) ?? [];
+			conversations.push(new Conversation(conversation, messages));
+		}
+
+		return conversations;
+	}
+
+	/**
+	 * Extracts conversations from inbox timeline response.
+	 *
+	 * @param response - The raw response data.
+	 *
+	 * @returns The deserialized list of conversations with their messages.
+	 */
+	public static listFromInboxTimeline(response: IInboxTimelineResponse): Conversation[] {
+		const conversations: Conversation[] = [];
+
+		if (!response.inbox_timeline?.conversations) {
+			return conversations;
+		}
+
+		const rawConversations = response.inbox_timeline.conversations;
+		const entries = response.inbox_timeline.entries ?? [];
+
+		// Group messages by conversation ID
+		const messagesByConversation = new Map<string, DirectMessage[]>();
+		for (const entry of entries) {
+			if ('message' in entry && entry.message) {
+				const message = new DirectMessage(entry.message);
+				const convId = message.conversationId;
+				if (convId) {
+					if (!messagesByConversation.has(convId)) {
+						messagesByConversation.set(convId, []);
+					}
+					messagesByConversation.get(convId)!.push(message);
+				}
+			}
+		}
+
+		// Create conversations with their messages
+		const conversationEntries = extractConversationData(rawConversations);
+		for (const [, conversation] of conversationEntries) {
+			const convId = (conversation as unknown as Record<string, unknown>).conversation_id as string;
+			const messages = messagesByConversation.get(convId) ?? [];
+			conversations.push(new Conversation(conversation, messages));
+		}
+
+		return conversations;
+	}
+
+	/**
+	 * Generic method to extract conversations from any supported response type
+	 */
+	public static listFromResponse(
+		response: IConversationTimelineResponse | IInboxInitialResponse | IInboxTimelineResponse,
+	): Conversation[] {
+		if (isConversationTimelineResponse(response)) {
+			const conversation = Conversation.fromConversationTimeline(response);
+			return conversation ? [conversation] : [];
+		} else if (isInboxInitialResponse(response)) {
+			return Conversation.listFromInboxInitial(response);
+		} else if (isInboxTimelineResponse(response)) {
+			return Conversation.listFromInboxTimeline(response);
+		}
+		return [];
+	}
+
+	/**
+	 * Get the other participant's ID (only for one-to-one conversations)
+	 */
+	public getOtherParticipant(currentUserId: string): string | undefined {
+		if (!this.isOneToOne() || this.participants.length !== 2) {
+			return undefined;
+		}
+		return this.participants.find((id) => id !== currentUserId);
+	}
+
+	/**
+	 * Check if this conversation is a group DM
+	 */
+	public isGroupDM(): boolean {
+		return this.type === 'GROUP_DM';
+	}
+
+	/**
+	 * Check if this conversation is one-to-one
+	 */
+	public isOneToOne(): boolean {
+		return this.type === 'ONE_TO_ONE';
+	}
+
+	/**
+	 * @returns A serializable JSON representation of `this` object.
+	 */
+	public toJSON(): IConversation {
+		return {
+			avatarUrl: this.avatarUrl,
+			hasMore: this.hasMore,
+			id: this.id,
+			lastActivityAt: this.lastActivityAt,
+			lastMessageId: this.lastMessageId,
+			messages: this.messages.map((msg) => msg.toJSON()),
+			muted: this.muted,
+			name: this.name,
+			notificationsDisabled: this.notificationsDisabled,
+			participants: this.participants,
+			trusted: this.trusted,
+			type: this.type,
+		};
+	}
+}

package/src/models/data/CursoredData.ts

@@ -5,6 +5,8 @@ import { findByFilter } from '../../helper/JsonUtils';
 import { ICursoredData } from '../../types/data/CursoredData';
 import { ICursor as IRawCursor } from '../../types/raw/base/Cursor';
 
+import { List } from './List';
+
 import { Notification } from './Notification';
 import { Tweet } from './Tweet';
 import { User } from './User';
@@ -16,7 +18,7 @@ import { User } from './User';
  *
  * @public
  */
-export class CursoredData<T extends Notification | Tweet | User> implements ICursoredData<T> {
+export class CursoredData<T extends Notification | Tweet | User | List> implements ICursoredData<T> {
 	public list: T[];
 	public next: string;
 
@@ -35,9 +37,12 @@ export class CursoredData<T extends Notification | Tweet | User> implements ICur
 		} else if (type == BaseType.USER) {
 			this.list = User.timeline(response) as T[];
 			this.next = findByFilter<IRawCursor>(response, 'cursorType', 'Bottom')[0]?.value ?? '';
+		} else if (type == BaseType.LIST) {
+			this.list = List.timeline(response) as T[];
+			this.next = findByFilter<IRawCursor>(response, 'cursorType', 'Bottom')[0]?.value ?? '';
 		} else if (type == BaseType.NOTIFICATION) {
 			this.list = Notification.list(response) as T[];
-			this.next = findByFilter<IRawCursor>(response, 'cursorType', 'Top')[0]?.value ?? '';
+			this.next = findByFilter<IRawCursor>(response, 'cursorType', 'Bottom')[0]?.value ?? '';
 		}
 	}