rettiwt-api 5.0.0-alpha.1 → 5.0.0-alpha.2

package/src/models/args/FetchArgs.ts

@@ -1,7 +1,5 @@
-import { ESearchResultType, TweetFilter } from 'rettiwt-core';
-
 import { EResourceType } from '../../enums/Resource';
-import { IFetchArgs } from '../../types/args/FetchArgs';
+import { IFetchArgs, ITweetFilter } from '../../types/args/FetchArgs';
 
 /**
  * Options specifying the data that is to be fetched.
@@ -13,7 +11,7 @@ export class FetchArgs implements IFetchArgs {
 	public cursor?: string;
 	public filter?: TweetFilter;
 	public id?: string;
-	public results?: ESearchResultType;
+	public ids?: string[];
 
 	/**
 	 * @param resource - The resource to be fetched.
@@ -21,9 +19,127 @@ export class FetchArgs implements IFetchArgs {
 	 */
 	public constructor(resource: EResourceType, args: IFetchArgs) {
 		this.id = args.id;
+		this.ids = args.ids;
 		this.count = args.count;
 		this.cursor = args.cursor;
 		this.filter = args.filter ? new TweetFilter(args.filter) : undefined;
-		this.results = args.results;
+	}
+}
+
+/**
+ * The filter to be used for searching tweets.
+ *
+ * @public
+ */
+export class TweetFilter implements ITweetFilter {
+	public endDate?: Date;
+	public excludeWords?: string[];
+	public fromUsers?: string[];
+	public hashtags?: string[];
+	public includePhrase?: string;
+	public includeWords?: string[];
+	public language?: string;
+	public links?: boolean;
+	public list?: string;
+	public maxId?: string;
+	public mentions?: string[];
+	public minLikes?: number;
+	public minReplies?: number;
+	public minRetweets?: number;
+	public optionalWords?: string[];
+	public quoted?: string;
+	public replies?: boolean;
+	public sinceId?: string;
+	public startDate?: Date;
+	public toUsers?: string[];
+	public top?: boolean;
+
+	/**
+	 * @param filter - The filter configuration.
+	 */
+	public constructor(filter: ITweetFilter) {
+		this.endDate = filter.endDate;
+		this.excludeWords = filter.excludeWords;
+		this.fromUsers = filter.fromUsers;
+		this.hashtags = filter.hashtags;
+		this.includePhrase = filter.includePhrase;
+		this.language = filter.language;
+		this.links = filter.links;
+		this.list = filter.list;
+		this.replies = filter.replies;
+		this.mentions = filter.mentions;
+		this.quoted = filter.quoted;
+		this.sinceId = filter.sinceId;
+		this.maxId = filter.maxId;
+		this.minLikes = filter.minLikes;
+		this.minReplies = filter.minReplies;
+		this.minRetweets = filter.minRetweets;
+		this.optionalWords = filter.optionalWords;
+		this.startDate = filter.startDate;
+		this.toUsers = filter.toUsers;
+		this.top = filter.top;
+		this.includeWords = filter.includeWords;
+	}
+
+	/**
+	 * Convert Date object to Twitter string representation.
+	 * eg - 2023-06-23_11:21:06_UTC
+	 *
+	 * @param date - The date object to convert.
+	 * @returns The Twitter string representation of the date.
+	 */
+	private static dateToTwitterString(date: Date): string {
+		// Converting localized date to UTC date
+		const utc = new Date(
+			Date.UTC(
+				date.getUTCFullYear(),
+				date.getUTCMonth(),
+				date.getUTCDate(),
+				date.getUTCHours(),
+				date.getUTCMinutes(),
+				date.getUTCSeconds(),
+			),
+		);
+
+		/**
+		 * To convert ISO 8601 date string to Twitter date string:
+		 *
+		 * - 'T' between date and time substring is replace with '_'.
+		 * - Milliseconds substring is omitted.
+		 * - '_UTC' is appended as suffix.
+		 */
+		return utc.toISOString().replace(/T/, '_').replace(/\..+/, '') + '_UTC';
+	}
+
+	/**
+	 * @returns The string representation of 'this' filter.
+	 */
+	public toString(): string {
+		return (
+			[
+				this.includeWords ? this.includeWords.join(' ') : '',
+				this.includePhrase ? `"${this.includePhrase}"` : '',
+				this.optionalWords ? `(${this.optionalWords.join(' OR ')})` : '',
+				this.excludeWords ? `${this.excludeWords.map((word) => '-' + word).join(' ')}` : '',
+				this.hashtags ? `(${this.hashtags.map((hashtag) => '#' + hashtag).join(' OR ')})` : '',
+				this.fromUsers ? `(${this.fromUsers.map((user) => `from:${user}`).join(' OR ')})` : '',
+				this.toUsers ? `(${this.toUsers.map((user) => `to:${user}`).join(' OR ')})` : '',
+				this.list ? `list:${this.list}` : '',
+				this.mentions ? `(${this.mentions.map((mention) => '@' + mention).join(' OR ')})` : '',
+				this.minReplies ? `min_replies:${this.minReplies}` : '',
+				this.minLikes ? `min_faves:${this.minLikes}` : '',
+				this.minRetweets ? `min_retweets:${this.minRetweets}` : '',
+				this.language ? `lang:${this.language}` : '',
+				this.startDate ? `since:${TweetFilter.dateToTwitterString(this.startDate)}` : '',
+				this.endDate ? `until:${TweetFilter.dateToTwitterString(this.endDate)}` : '',
+				this.sinceId ? `since_id:${this.sinceId}` : '',
+				this.maxId ? `max_id:${this.maxId}` : '',
+				this.quoted ? `quoted_tweet_id:${this.quoted}` : '',
+			]
+				.filter((item) => item !== '()' && item !== '')
+				.join(' ') +
+			(this.links == false ? ' -filter:links' : '') +
+			(this.replies == false ? ' -filter:replies' : '')
+		);
 	}
 }

package/src/models/args/PostArgs.ts

@@ -1,46 +1,86 @@
-import { NewTweet } from 'rettiwt-core';
-
 import { EResourceType } from '../../enums/Resource';
-import { IPostArgs, IUploadArgs } from '../../types/args/PostArgs';
+import { INewTweet, INewTweetMedia, IPostArgs, IUploadArgs } from '../../types/args/PostArgs';
 
 /**
- * Options specifying the media file to be uploaded.
+ * Options specifying the data that is to be posted.
  *
  * @public
  */
-export class UploadArgs implements IUploadArgs {
+export class PostArgs implements IPostArgs {
 	public id?: string;
-	public media?: string | ArrayBuffer;
-	public size?: number;
+	public tweet?: NewTweet;
+	public upload?: UploadArgs;
 
 	/**
-	 * @param step - The upload step.
-	 * @param args - The upload arguments for uploading the media file.
+	 * @param resource - The resource to be posted.
+	 * @param args - Additional user-defined arguments for posting the resource.
 	 */
-	public constructor(step: EResourceType, args: IUploadArgs) {
-		this.size = args.size;
-		this.media = args.media;
+	public constructor(resource: EResourceType, args: IPostArgs) {
 		this.id = args.id;
+		this.tweet = args.tweet ? new NewTweet(args.tweet) : undefined;
+		this.upload = args.upload ? new UploadArgs(resource, args.upload) : undefined;
 	}
 }
 
 /**
- * Options specifying the data that is to be posted.
+ * Configuration for the new tweet to be posted.
  *
  * @public
  */
-export class PostArgs implements IPostArgs {
+export class NewTweet implements INewTweet {
+	public media?: NewTweetMedia[];
+	public quote?: string;
+	public replyTo?: string;
+	public scheduleFor?: Date;
+	public text: string;
+
+	/**
+	 * @param newTweet - The args specifying the new tweet to be posted.
+	 */
+	public constructor(newTweet: INewTweet) {
+		this.media = newTweet.media;
+		this.quote = newTweet.quote;
+		this.replyTo = newTweet.replyTo;
+		this.scheduleFor = newTweet.scheduleFor;
+		this.text = newTweet.text ?? '';
+	}
+}
+
+/**
+ * Configuration for the media to be uploaded.
+ *
+ * @public
+ */
+export class NewTweetMedia implements INewTweetMedia {
+	public id: string;
+	public tags?: string[];
+
+	/**
+	 * @param newTweetMedia - The args specifying the new media to be posted along with the tweet.
+	 */
+	public constructor(newTweetMedia: INewTweetMedia) {
+		this.id = newTweetMedia.id;
+		this.tags = newTweetMedia.tags;
+	}
+}
+
+/**
+ * Options specifying the media file to be uploaded.
+ *
+ * @public
+ */
+export class UploadArgs implements IUploadArgs {
 	public id?: string;
-	public tweet?: NewTweet;
-	public upload?: UploadArgs;
+	public media?: string | ArrayBuffer;
+	public size?: number;
 
 	/**
-	 * @param resource - The resource to be posted.
-	 * @param args - Additional user-defined arguments for posting the resource.
+	 * @param step - The upload step.
+	 * @param args - The upload arguments for uploading the media file.
 	 */
-	public constructor(resource: EResourceType, args: IPostArgs) {
+	public constructor(step: EResourceType, args: IUploadArgs) {
+		this.size = args.size;
+		this.media = args.media;
 		this.id = args.id;
-		this.tweet = args.tweet ? new NewTweet(args.tweet) : undefined;
-		this.upload = args.upload ? new UploadArgs(resource, args.upload) : undefined;
 	}
 }

package/src/models/auth/AuthCookie.ts

@@ -4,6 +4,8 @@ import { IAuthCookie } from '../../types/auth/AuthCookie';
 
 /**
  * The cookie containing the tokens that are used to authenticate against Twitter.
+ *
+ * @public
  */
 export class AuthCookie implements IAuthCookie {
 	/* eslint-disable @typescript-eslint/naming-convention */

package/src/models/auth/AuthCredential.ts

@@ -14,6 +14,8 @@ import { AuthCookie } from './AuthCookie';
  * - authToken, guestToken =\> Guest authentication.
  * - authToken, csrfToken, cookie =\> User authentication.
  * - authToken, guestToken, cookie =\> Guest authentication while logging in.
+ *
+ * @public
  */
 export class AuthCredential implements IAuthCredential {
 	public authToken?: string;

package/src/models/data/CursoredData.ts

@@ -1,10 +1,9 @@
-import { ICursor as IRawCursor } from 'rettiwt-core';
-
 import { EBaseType } from '../../enums/Data';
 
 import { findByFilter } from '../../helper/JsonUtils';
 
-import { ICursor, ICursoredData } from '../../types/data/CursoredData';
+import { ICursoredData } from '../../types/data/CursoredData';
+import { ICursor as IRawCursor } from '../../types/raw/base/Cursor';
 
 import { Notification } from './Notification';
 import { Tweet } from './Tweet';
@@ -18,8 +17,8 @@ import { User } from './User';
  * @public
  */
 export class CursoredData<T extends Notification | Tweet | User> implements ICursoredData<T> {
-	public list: T[] = [];
-	public next: Cursor = new Cursor('');
+	public list: T[];
+	public next: string;
 
 	/**
 	 * @param response - The raw response.
@@ -28,34 +27,27 @@ export class CursoredData<T extends Notification | Tweet | User> implements ICur
 	public constructor(response: NonNullable<unknown>, type: EBaseType) {
 		// Initializing defaults
 		this.list = [];
-		this.next = new Cursor('');
+		this.next = '';
 
 		if (type == EBaseType.TWEET) {
-			this.list = Tweet.list(response) as T[];
-			this.next = new Cursor(findByFilter<IRawCursor>(response, 'cursorType', 'Bottom')[0]?.value ?? '');
+			this.list = Tweet.timeline(response) as T[];
+			this.next = findByFilter<IRawCursor>(response, 'cursorType', 'Bottom')[0]?.value ?? '';
 		} else if (type == EBaseType.USER) {
-			this.list = User.list(response) as T[];
-			this.next = new Cursor(findByFilter<IRawCursor>(response, 'cursorType', 'Bottom')[0]?.value ?? '');
+			this.list = User.timeline(response) as T[];
+			this.next = findByFilter<IRawCursor>(response, 'cursorType', 'Bottom')[0]?.value ?? '';
 		} else if (type == EBaseType.NOTIFICATION) {
 			this.list = Notification.list(response) as T[];
-			this.next = new Cursor(findByFilter<IRawCursor>(response, 'cursorType', 'Top')[0]?.value ?? '');
+			this.next = findByFilter<IRawCursor>(response, 'cursorType', 'Top')[0]?.value ?? '';
 		}
 	}
-}
-
-/**
- * The cursor to the batch of data to fetch.
- *
- * @public
- */
-export class Cursor implements ICursor {
-	/** The cursor string. */
-	public value: string;
 
 	/**
-	 * @param cursor - The cursor string.
+	 * @returns A serializable JSON representation of `this` object.
 	 */
-	public constructor(cursor: string) {
-		this.value = cursor;
+	public toJSON(): ICursoredData<T> {
+		return {
+			list: this.list.map((item) => item.toJSON() as T),
+			next: this.next,
+		};
 	}
 }

package/src/models/data/List.ts

@@ -1,6 +1,5 @@
-import { IList as IRawList } from 'rettiwt-core';
-
 import { IList } from '../../types/data/List';
+import { IList as IRawList } from '../../types/raw/base/List';
 
 /**
  * The details of a single Twitter List.
@@ -28,4 +27,19 @@ export class List implements IList {
 		this.subscriberCount = list.subscriber_count;
 		this.createdBy = list.user_results.result.id;
 	}
+
+	/**
+	 * @returns A serializable JSON representation of `this` object.
+	 */
+	public toJSON(): IList {
+		return {
+			createdAt: this.createdAt,
+			createdBy: this.createdBy,
+			description: this.description,
+			id: this.id,
+			memberCount: this.memberCount,
+			name: this.name,
+			subscriberCount: this.subscriberCount,
+		};
+	}
 }

package/src/models/data/Notification.ts

@@ -1,12 +1,9 @@
-import {
-	ENotificationType as ENotificationTypeOriginal,
-	INotification as IRawNotification,
-	IUserNotificationsResponse,
-} from 'rettiwt-core';
-
-import { ENotificationType } from '../../enums/Data';
+import { ENotificationType } from '../../enums/Notification';
+import { ERawNotificationType } from '../../enums/raw/Notification';
 import { findKeyByValue } from '../../helper/JsonUtils';
 import { INotification } from '../../types/data/Notification';
+import { INotification as IRawNotification } from '../../types/raw/base/Notification';
+import { IUserNotificationsResponse } from '../../types/raw/user/Notifications';
 
 /**
  * The details of a single notification.
@@ -17,7 +14,7 @@ export class Notification implements INotification {
 	public from: string[];
 	public id: string;
 	public message: string;
-	public receivedAt: Date;
+	public receivedAt: string;
 	public target: string[];
 	public type?: ENotificationType;
 
@@ -26,14 +23,14 @@ export class Notification implements INotification {
 	 */
 	public constructor(notification: IRawNotification) {
 		// Getting the original notification type
-		const notificationType: string | undefined = findKeyByValue(ENotificationTypeOriginal, notification.icon.id);
+		const notificationType: string | undefined = findKeyByValue(ERawNotificationType, notification.icon.id);
 
 		this.from = notification.template?.aggregateUserActionsV1?.fromUsers
 			? notification.template.aggregateUserActionsV1.fromUsers.map((item) => item.user.id)
 			: [];
 		this.id = notification.id;
 		this.message = notification.message.text;
-		this.receivedAt = new Date(Number(notification.timestampMs));
+		this.receivedAt = new Date(Number(notification.timestampMs)).toISOString();
 		this.target = notification.template?.aggregateUserActionsV1?.targetObjects
 			? notification.template.aggregateUserActionsV1.targetObjects.map((item) => item.tweet.id)
 			: [];
@@ -48,8 +45,6 @@ export class Notification implements INotification {
 	 * @param response - The raw response data.
 	 *
 	 * @returns The deserialized list of notifications.
-	 *
-	 * @internal
 	 */
 	public static list(response: NonNullable<unknown>): Notification[] {
 		const notifications: Notification[] = [];
@@ -66,4 +61,18 @@ export class Notification implements INotification {
 
 		return notifications;
 	}
+
+	/**
+	 * @returns A serializable JSON representation of `this` object.
+	 */
+	public toJSON(): INotification {
+		return {
+			from: this.from,
+			id: this.id,
+			message: this.message,
+			receivedAt: this.receivedAt,
+			target: this.target,
+			type: this.type,
+		};
+	}
 }

package/src/models/data/Tweet.ts

@@ -1,18 +1,15 @@
-import {
-	EMediaType,
-	ILimitedVisibilityTweet,
-	IExtendedMedia as IRawExtendedMedia,
-	ITweet as IRawTweet,
-	IEntities as IRawTweetEntities,
-	ITimelineTweet,
-} from 'rettiwt-core';
-
 import { ELogActions } from '../../enums/Logging';
+import { EMediaType } from '../../enums/Media';
+import { ERawMediaType } from '../../enums/raw/Media';
 import { findByFilter } from '../../helper/JsonUtils';
 
 import { LogService } from '../../services/internal/LogService';
 
-import { ITweet } from '../../types/data/Tweet';
+import { ITweet, ITweetEntities, ITweetMedia } from '../../types/data/Tweet';
+import { ILimitedVisibilityTweet } from '../../types/raw/base/LimitedVisibilityTweet';
+import { IExtendedMedia as IRawExtendedMedia } from '../../types/raw/base/Media';
+import { ITweet as IRawTweet, IEntities as IRawTweetEntities } from '../../types/raw/base/Tweet';
+import { ITimelineTweet } from '../../types/raw/composite/TimelineTweet';
 
 import { User } from './User';
 
@@ -47,7 +44,7 @@ export class Tweet implements ITweet {
 	public constructor(tweet: IRawTweet) {
 		this.id = tweet.rest_id;
 		this.conversationId = tweet.legacy.conversation_id_str;
-		this.createdAt = tweet.legacy.created_at;
+		this.createdAt = new Date(tweet.legacy.created_at).toISOString();
 		this.tweetBy = new User(tweet.core.user_results.result);
 		this.entities = new TweetEntities(tweet.legacy.entities);
 		this.media = tweet.legacy.extended_entities?.media?.map((media) => new TweetMedia(media));
@@ -118,39 +115,27 @@ export class Tweet implements ITweet {
 	}
 
 	/**
-	 * Extracts and deserializes the list of tweets from the given raw response data.
+	 * Extracts and deserializes multiple target tweets from the given raw response data.
 	 *
 	 * @param response - The raw response data.
+	 * @param ids - The ids of the target tweets.
 	 *
-	 * @returns The deserialized list of tweets.
-	 *
-	 * @internal
+	 * @returns The target deserialized tweets.
 	 */
-	public static list(response: NonNullable<unknown>): Tweet[] {
-		const tweets: Tweet[] = [];
+	public static multiple(response: NonNullable<unknown>, ids: string[]): Tweet[] {
+		let tweets: Tweet[] = [];
 
 		// Extracting the matching data
-		const extract = findByFilter<ITimelineTweet>(response, '__typename', 'TimelineTweet');
+		const extract = findByFilter<IRawTweet>(response, '__typename', 'Tweet');
 
 		// Deserializing valid data
 		for (const item of extract) {
-			// If tweet with limited visibility
-			if (
-				item.tweet_results?.result &&
-				item.tweet_results?.result?.__typename == 'TweetWithVisibilityResults' &&
-				(item.tweet_results?.result as ILimitedVisibilityTweet)?.tweet?.legacy
-			) {
-				tweets.push(new Tweet((item.tweet_results.result as ILimitedVisibilityTweet).tweet));
-			}
-			// If normal tweet
-			else if ((item.tweet_results?.result as IRawTweet)?.legacy) {
+			if (item.legacy) {
 				// Logging
-				LogService.log(ELogActions.DESERIALIZE, { id: (item.tweet_results.result as IRawTweet).rest_id });
+				LogService.log(ELogActions.DESERIALIZE, { id: item.rest_id });
 
-				tweets.push(new Tweet(item.tweet_results.result as IRawTweet));
-			}
-			// If invalid/unrecognized tweet
-			else {
+				tweets.push(new Tweet(item));
+			} else {
 				// Logging
 				LogService.log(ELogActions.WARNING, {
 					action: ELogActions.DESERIALIZE,
@@ -159,6 +144,11 @@ export class Tweet implements ITweet {
 			}
 		}
 
+		// Filtering only required tweets, if required
+		if (ids && ids.length) {
+			tweets = tweets.filter((tweet) => ids.includes(tweet.id));
+		}
+
 		return tweets;
 	}
 
@@ -169,8 +159,6 @@ export class Tweet implements ITweet {
 	 * @param id - The id of the target tweet.
 	 *
 	 * @returns The target deserialized tweet.
-	 *
-	 * @internal
 	 */
 	public static single(response: NonNullable<unknown>, id: string): Tweet | undefined {
 		const tweets: Tweet[] = [];
@@ -196,6 +184,76 @@ export class Tweet implements ITweet {
 
 		return tweets.length ? tweets[0] : undefined;
 	}
+
+	/**
+	 * Extracts and deserializes the timeline of tweets from the given raw response data.
+	 *
+	 * @param response - The raw response data.
+	 * @param ids - The IDs of specific tweets that need to be extracted.
+	 *
+	 * @returns The deserialized timeline of tweets.
+	 */
+	public static timeline(response: NonNullable<unknown>): Tweet[] {
+		const tweets: Tweet[] = [];
+
+		// Extracting the matching data
+		const extract = findByFilter<ITimelineTweet>(response, '__typename', 'TimelineTweet');
+
+		// Deserializing valid data
+		for (const item of extract) {
+			// If tweet with limited visibility
+			if (
+				item.tweet_results?.result &&
+				item.tweet_results?.result?.__typename == 'TweetWithVisibilityResults' &&
+				(item.tweet_results?.result as ILimitedVisibilityTweet)?.tweet?.legacy
+			) {
+				tweets.push(new Tweet((item.tweet_results.result as ILimitedVisibilityTweet).tweet));
+			}
+			// If normal tweet
+			else if ((item.tweet_results?.result as IRawTweet)?.legacy) {
+				// Logging
+				LogService.log(ELogActions.DESERIALIZE, { id: (item.tweet_results.result as IRawTweet).rest_id });
+
+				tweets.push(new Tweet(item.tweet_results.result as IRawTweet));
+			}
+			// If invalid/unrecognized tweet
+			else {
+				// Logging
+				LogService.log(ELogActions.WARNING, {
+					action: ELogActions.DESERIALIZE,
+					message: `Tweet not found, skipping`,
+				});
+			}
+		}
+
+		return tweets;
+	}
+
+	/**
+	 * @returns A serializable JSON representation of `this` object.
+	 */
+	public toJSON(): ITweet {
+		return {
+			bookmarkCount: this.bookmarkCount,
+			conversationId: this.conversationId,
+			createdAt: this.createdAt,
+			entities: this.entities.toJSON(),
+			fullText: this.fullText,
+			id: this.id,
+			lang: this.lang,
+			likeCount: this.likeCount,
+			media: this.media?.map((item) => item.toJSON()),
+			quoteCount: this.quoteCount,
+			quoted: this.quoted?.toJSON(),
+			replyCount: this.replyCount,
+			replyTo: this.replyTo,
+			retweetCount: this.retweetCount,
+			retweetedTweet: this.retweetedTweet?.toJSON(),
+			tweetBy: this.tweetBy.toJSON(),
+			url: this.url,
+			viewCount: this.viewCount,
+		};
+	}
 }
 
 /**
@@ -238,6 +296,17 @@ export class TweetEntities {
 			}
 		}
 	}
+
+	/**
+	 * @returns A serializable JSON representation of `this` object.
+	 */
+	public toJSON(): ITweetEntities {
+		return {
+			hashtags: this.hashtags,
+			mentionedUsers: this.mentionedUsers,
+			urls: this.urls,
+		};
+	}
 }
 
 /**
@@ -259,18 +328,19 @@ export class TweetMedia {
 	 * @param media - The raw media details.
 	 */
 	public constructor(media: IRawExtendedMedia) {
-		this.type = media.type;
-
 		// If the media is a photo
-		if (media.type == EMediaType.PHOTO) {
+		if (media.type == ERawMediaType.PHOTO) {
+			this.type = EMediaType.PHOTO;
 			this.url = media.media_url_https;
 		}
 		// If the media is a gif
-		else if (media.type == EMediaType.GIF) {
+		else if (media.type == ERawMediaType.GIF) {
+			this.type = EMediaType.GIF;
 			this.url = media.video_info?.variants[0].url as string;
 		}
 		// If the media is a video
 		else {
+			this.type = EMediaType.VIDEO;
 			this.thumbnailUrl = media.media_url_https;
 
 			/** The highest bitrate of all variants. */
@@ -287,4 +357,15 @@ export class TweetMedia {
 			});
 		}
 	}
+
+	/**
+	 * @returns A serializable JSON representation of `this` object.
+	 */
+	public toJSON(): ITweetMedia {
+		return {
+			thumbnailUrl: this.thumbnailUrl,
+			type: this.type,
+			url: this.url,
+		};
+	}
 }