Implemented class

src/scripts/classes/platform-user.ts

@@ -0,0 +1,139 @@
+"use strict";
+
+// Public modules from npm
+import cheerio from "cheerio";
+import luxon from "luxon";
+
+// Modules from files
+import { urls } from "../constants/url.js";
+import { fetchHTML } from "../network-helper.js";
+import { MEMBER } from "../constants/css-selector.js";
+
+/**
+ * Represents a generic user registered on the platform.
+ */
+export default class PlatformUser {
+
+    //#region Fields
+
+    private _id: number;
+    private _name: string;
+    private _title: string;
+    private _banners: string[];
+    private _messages: number;
+    private _reactionScore: number;
+    private _points: number;
+    private _ratingsReceived: number;
+    private _joined: Date;
+    private _lastSeen: Date;
+    private _followed: boolean;
+    private _ignored: boolean;
+    private _avatar: string;
+    private _amountDonated: number;
+
+    //#endregion Fields
+
+    //#region Getters
+    
+    /**
+    * Unique user ID.
+    */
+    public get id() { return this._id; }
+    /**
+     * Username.
+     */
+    public get name() { return this._name; }
+    /**
+     * Title assigned to the user by the platform.
+     */
+    public get title() { return this._title; }
+    /**
+     * List of banners assigned by the platform.
+     */
+    public get banners() { return this._banners; }
+    /**
+     * Number of messages written by the user.
+     */
+    public get messages() { return this._messages; }
+    /**
+     * @todo Reaction score.
+     */
+    public get reactionScore() { return this._reactionScore; }
+    /**
+     * @todo Points.
+     */
+    public get points() { return this._points; }
+    /**
+     * Number of ratings received.
+     */
+    public get ratingsReceived() { return this._ratingsReceived; }
+    /**
+     * Date of joining the platform.
+     */
+    public get joined() { return this._joined; }
+    /**
+     * Date of the last connection to the platform.
+     */
+    public get lastSeen() { return this._lastSeen; }
+    /**
+     * Indicates whether the user is followed by the currently logged in user.
+     */
+    public get followed() { return this._followed; }
+    /**
+     * Indicates whether the user is ignored by the currently logged on user.
+     */
+    public get ignored() { return this._ignored; }
+    /**
+     * URL of the image used as the user's avatar.
+     */
+    public get avatar() { return this._avatar; }
+    /**
+     * Value of donations made.
+     */
+    public get donation() { return this._amountDonated; }
+
+    //#endregion Getters
+
+    constructor(id: number) { this._id = id; }
+
+    //#region Public methods
+
+    public async fetch() {
+        // Prepare the URL
+        const url = new URL(this.id.toString(), `${urls.F95_MEMBERS}/`).toString();
+
+        // Fetch the page
+        const htmlResponse = await fetchHTML(url);
+
+        if (htmlResponse.isSuccess()) {
+            // Prepare cheerio
+            const $ = cheerio.load(htmlResponse.value);
+
+            // Parse the elements
+            this._name = $(MEMBER.NAME).text();
+            this._title = $(MEMBER.TITLE).text();
+            this._banners = $(MEMBER.BANNERS).toArray().map((idx, el) => $(el).text().trim()).filter(el => !el);
+            this._avatar = $(MEMBER.AVATAR).attr("src");
+            this._followed = $(MEMBER.FOLLOWED).text() === "Unfollow";
+            this._ignored = $(MEMBER.IGNORED).text() === "Unignore";
+            this._messages = parseInt($(MEMBER.MESSAGES).text());
+            this._reactionScore = parseInt($(MEMBER.REACTION_SCORE).text());
+            this._points = parseInt($(MEMBER.POINTS).text());
+            this._ratingsReceived = parseInt($(MEMBER.RATINGS_RECEIVED).text());
+            
+            // Parse date
+            const joined = $(MEMBER.JOINED)?.attr("datetime");
+            if (luxon.DateTime.fromISO(joined).isValid) this._joined = new Date(joined);
+
+            const lastSeen = $(MEMBER.LAST_SEEN)?.attr("datetime");
+            if (luxon.DateTime.fromISO(lastSeen).isValid) this._joined = new Date(lastSeen);
+
+            // Parse donation
+            const donation = $(MEMBER.AMOUNT_DONATED)?.text().replace("$", "");
+            this._amountDonated = donation ? parseInt(donation) : 0;
+
+        } else throw htmlResponse.value;
+    }
+
+    //#endregion Public method
+}