gj-boomlings-api 2.0.0 → 2.0.2

package/functions/getCreatorScores.js

@@ -1,4 +1,22 @@
+/**
+ * @typedef {Object} ScoresUser
+ * @property {string} name - The player's username.
+ * @property {number} playerID - The player's player ID.
+ * @property {number} accountID - The player's account ID.
+ * @property {number} rank - The player's ranking on the leaderboard.
+ * @property {number} stars - The amount of stars the player has.
+ * @property {number} diamonds - The amount of diamonds the player has.
+ * @property {number} secretCoins - The amount of secret coins the player has.
+ * @property {number} userCoins - The amount of user coins the player has.
+ * @property {number} demons - The amount of demons the player has completed.
+ * @property {number} moons - The amount of moons the player has.
+ * @property {number} creatorPoints - The amount of creator points the player has.
+ */
 module.exports = {
+    /**
+     * Fetches the player leaderboard based on the amount of creator points.
+     * @returns {ScoresUser[]}
+     */
     getCreatorScores: async function () {
         let GJDecode = require("../misc/GJDecode");
         const { decodeScoresUser } = new GJDecode;

package/functions/getDailyLevel.js

@@ -1,6 +1,10 @@
 module.exports = {
+    /**
+     * Gets the current daily level.
+     * @returns {import("./dlLevel").Level}
+     */
     getDailyLevel: async function () {
-        const { dlLevel } = require("./dlLevel")
+        const { dlLevel } = require("./dlLevel");
         let res = await dlLevel(-1);
         return res;
     }

package/functions/getFriendsList.js

@@ -1,14 +1,29 @@
+/**
+ * @typedef {Object} Friend
+ * @property {string} username - The friend's username.
+ * @property {number} playerID - The friend's player ID.
+ * @property {number} accountID - The friend's account ID.
+ * @property {string} color1 - The HEX code of the friend's primary color.
+ * @property {string} color2 - The HEX code of the friend's secondary color.
+ * @property {string} messages - The current state of messaging the friend. Returns "all" if anyone can message the person, "friends" if it's limited to friends, and "none" if no one can.
+ */
 module.exports = {
-    getFriendsList: async function (user, pass) {
-        if (!user) throw new Error("Please provide a player ID or username!");
-        if (!pass) throw new Error("Please provide a password!");
+    /**
+     * Gets the list of a user's friends.
+     * @param {string} username - The user's username or player ID.
+     * @param {string} password - The user's password.
+     * @returns {Friend[]}
+     */
+    getFriendsList: async function (username, password) {
+        if (!username) throw new Error("Please provide a player ID or username!");
+        if (!password) throw new Error("Please provide a password!");
 
         const { gjReq } = require("../gjReq");
         const XOR = require("../xor");
         const xor = new XOR;
 
         let search = await gjReq("getGJUsers20", {
-            str: user,
+            str: username,
             secret: "Wmfd2893gb7"
         });
         if (search.data == -1) return [];
@@ -16,7 +31,7 @@ module.exports = {
 
         const data = {
             accountID: accID,
-            gjp: xor.encrypt(pass, 37526),
+            gjp: xor.encrypt(password, 37526),
             secret: "Wmfd2893gb7"
         }
 
@@ -30,7 +45,7 @@ module.exports = {
         const { rgbToHEX } = require("../misc/rgbToHEX");
 
         players.forEach(p => {
-            let s=p.split(":");
+            let s = p.split(":");
             let username = s[1];
             let playerID = s[3];
             let p1 = s[7];

package/functions/getGauntlets.js

@@ -1,4 +1,14 @@
+/**
+ * @typedef {Object} Gauntlet
+ * @property {string} name - The gauntlet's name.
+ * @property {number} id - The gauntlet's ID.
+ * @property {Array<Number>} levels - The list of level IDs in the gauntlet.
+ */
 module.exports = {
+    /**
+     * Gets the list of gauntlets.
+     * @returns {Gauntlet[]}
+     */
     getGauntlets: async function () {
         const glIDs = require("../misc/gauntlets.json");
         const { gjReq } = require("../gjReq");
@@ -15,6 +25,7 @@ module.exports = {
             }
             result.push({
                 name: `${glIDs[g.split(":")[1]]} Gauntlet`,
+                id: Number(g.split(":")[1]),
                 levels: list
             });
         })

package/functions/getLevelByID.js

@@ -1,4 +1,47 @@
+/**
+ * @typedef {Object} Song
+ * @property {string} name - The song's name.
+ * @property {number} id - The song's ID.
+ * @property {string} artist - The song artist.
+ * @property {number} artistId - The song artist's ID on Newgrounds.
+ * @property {number} fileSize - The song's file size in megabytes.
+ * @property {string} link - The direct link to download the song file.
+ */
+
+/**
+ * @typedef {Object} Level
+ * @property {number} id - The level's ID.
+ * @property {string} name - The level's name.
+ * @property {string} description - The level's description.
+ * @property {string} levelVersion - The level's current version number.
+ * @property {number} playerID - The level uploader's player ID.
+ * @property {string} difficulty - The level's difficulty.
+ * @property {number} stars - The amount of given stars when completing the level.
+ * @property {number} downloads - The amount of times the level has been downloaded.
+ * @property {number} likes - The amount of likes the level has.
+ * @property {boolean} disliked - Whether the level is disliked (i.e. if the likes count is less than 0).
+ * @property {string} length - The level's length.
+ * @property {boolean} demon - Whether the level is a demon.
+ * @property {boolean} featured - Whether the level is featured.
+ * @property {boolean} epic - Whether the level is epic-rated.
+ * @property {string|boolean} rating - Primarily used for new 2.2 ratings. Returns either "epic", "legendary", "mythic", or `false` if the level's rating is lower than epic.
+ * @property {number} objects - The amount of objects the level has (inaccurate because it could be circumvented, and caps at 65,535).
+ * @property {number} starsRequested - The amount of stars the uploader requested for this level.
+ * @property {string} gameVersion - The version of the game used to upload the current version of the level. Returns "Pre-1.7" if the level was last updated in 1.6 or earlier.
+ * @property {number} copiedID - The original level's ID if this level was copied. Returns 0 if the level is original on itself.
+ * @property {boolean} large - Whether the level is considered "large" (i.e. has more than 40k objects).
+ * @property {boolean} twoPlayer - Whether the level can be played by two people.
+ * @property {number} coins - The amount of coins the level has.
+ * @property {boolean} verifiedCoins - Whether the coins are verified.
+ * @property {string} creator - The level uploader's username.
+ * @property {Song} song - The main song used in the level.
+ */
 module.exports = {
+    /**
+     * Gets a level by its ID. Works considerably faster than dlLevel(), yet lacks the last update/upload date, password, LDM, accurate object count, SFX and additional songs (if any).
+     * @param {number} id - The level's ID.
+     * @returns {Level}
+     */
     getLevelByID: async function (id) {
         if (isNaN(id)) throw new Error("Please provide a valid level ID!");
         const { gjReq } = require("../gjReq");

package/functions/getLevelScores.js

@@ -1,16 +1,39 @@
+/**
+ * @typedef {Object} LevelScore
+ * @property {string} username - The player's username.
+ * @property {number} playerID - The player's player ID.
+ * @property {number} accountID - The player's account ID.
+ * @property {number} rank - The player's ranking on the leaderboard.
+ * @property {string} color1 - The player's primary color.
+ * @property {string} color2 - The player's secondary color.
+ * @property {string} iconID - The player's icon ID.
+ * @property {string} iconType - The player's selected game mode to be displayed as an icon.
+ * @property {string} glow - Whether the player's icon has the "glow" feature enabled.
+ * @property {string} percent - The record's percentage.
+ * @property {string} coins - The amount of coins collected.
+ * @property {string} age - How long ago the record was published.
+ */
 module.exports = {
-    getLevelScores: async function (lvl, type, user, pass) {
+    /**
+     * Fetches leaderboards from a specified level.
+     * @param {number} level - The level to fetch leaderboards from.
+     * @param {("week"|"top"|"player")} type - The leaderboard type. Possible types: \"week\", \"top\", \"friends\".
+     * @param {string} username - The user's username or player ID. For whatever reason, RobTop made this required, even for simple fetching.
+     * @param {string} password - The user's password. For whatever reason, RobTop made this required, even for simple fetching.
+     * @returns {LevelScore[]}
+     */
+    getLevelScores: async function (level, type, username, password) {
         let types = { week: "2", top: "1", friends: "0" }
-        if (!lvl) throw new Error("Please provide a level ID!");
+        if (!level) throw new Error("Please provide a level ID!");
         if (!types[type.toLowerCase()]) throw new Error("Please provide a valid leaderboard type! Possible types: \"week\", \"top\", \"friends\".")
-        if (!user) throw new Error("Please provide a username or a Player ID!");
-        if (!pass) throw new Error("Please provide a password!");
+        if (!username) throw new Error("Please provide a username or a Player ID!");
+        if (!password) throw new Error("Please provide a password!");
 
         const { gjReq } = require("../gjReq.js");
         const { rgbToHEX } = require("../misc/rgbToHEX");
         const colors = require("../misc/colors.json");
         let search = await gjReq("getGJUsers20", {
-            str: user,
+            str: username,
             secret: "Wmfd2893gb7"
         });
         if (search.data == -1) return [];
@@ -21,8 +44,8 @@ module.exports = {
 
         const data = {
             accountID: accID,
-            gjp: xor.encrypt(pass, 37526),
-            levelID: lvl,
+            gjp: xor.encrypt(password, 37526),
+            levelID: level,
             secret: "Wmfd2893gb7",
             type: types[type.toLowerCase()]
         }
@@ -51,8 +74,8 @@ module.exports = {
                 playerID: Number(s[3]),
                 accountID: Number(s[15]),
                 rank: Number(s[19]),
-                c1: rgbToHEX(colors[user[7]]),
-                c2: rgbToHEX(colors[user[9]]),
+                color1: rgbToHEX(colors[username[7]]),
+                color2: rgbToHEX(colors[username[9]]),
                 iconID: Number(s[5]),
                 iconType: iconObj[s[11]],
                 glow: s[13] == "2" ? true : false,

package/functions/getMapPacks.js

@@ -1,4 +1,20 @@
+/**
+ * @typedef {Object} MapPack
+ * @property {string} name - The map pack's name.
+ * @property {number} id - The map pack's ID.
+ * @property {Array<Number>} levels - The list of level IDs in the map pack.
+ * @property {Number} stars - The amount of stars received from completing the map pack.
+ * @property {number} coins - The amount of secret coins received from completing the map pack.
+ * @property {string} difficulty - The map pack's difficulty.
+ * @property {string} textColor - The map pack's title color.
+ * @property {string} barColor - The map pack's progress bar color.
+ */
 module.exports = {
+    /**
+     * Gets the map packs from a specified page.
+     * @param {number} page - The page to search through. Defaults to 1.
+     * @returns {MapPack[]}
+     */
     getMapPacks: async function (page = 1) {
         const { gjReq } = require("../gjReq");
         const data = {

package/functions/getMessages.js

@@ -1,7 +1,24 @@
+/**
+ * @typedef {Object} Message
+ * @property {string} username - The message sender's username.
+ * @property {string} title - The message's title.
+ * @property {number} playerID - The message sender's player ID.
+ * @property {number} accountID - The message sender's account ID.
+ * @property {number} messageID - The message ID.
+ * @property {string} age - How long ago the message was sent.
+ * @property {boolean} read - Whether the message was already read.
+ */
 module.exports = {
-    getMessages: async function (user, pass, page = 1) {
-        if (!user) throw new Error("Please provide a player ID or username!");
-        if (!pass) throw new Error("Please provide a password!");
+    /**
+     * Gets the list of messages received by a user.
+     * @param {string} username - The user's username or player ID.
+     * @param {string} password - The user's password.
+     * @param {number} page - The page to search through. Defaults to 1.
+     * @returns {Message[]}
+     */
+    getMessages: async function (username, password, page = 1) {
+        if (!username) throw new Error("Please provide a player ID or username!");
+        if (!password) throw new Error("Please provide a password!");
         if (isNaN(page)) throw new Error("The page should be a number!");
 
         const { gjReq } = require("../gjReq");
@@ -9,7 +26,7 @@ module.exports = {
         const xor = new XOR;
 
         let search = await gjReq("getGJUsers20", {
-            str: user,
+            str: username,
             secret: "Wmfd2893gb7"
         });
         if (search.data == -1) return [];
@@ -17,7 +34,7 @@ module.exports = {
 
         let res = await gjReq("getGJMessages20", {
             accountID: accID,
-            gjp: xor.encrypt(pass, 37526),
+            gjp: xor.encrypt(password, 37526),
             secret: "Wmfd2893gb7",
             page: page - 1
         });

package/functions/getOfficialSongInfo.js

@@ -1,11 +1,22 @@
+/**
+ * @typedef {Object} Song
+ * @property {string} name - The song's name.
+ * @property {string} id - The ID of the level the song is used in (e.g. "Level 1").
+ * @property {string} artist - The song artist.
+ * @property {string} link - The link to listen to the song.
+ */
 module.exports = {
+    /**
+     * Gets song info about an official song.
+     * @param {number} song - The song ID.
+     * @returns {Song}
+     */
     getOfficialSongInfo: function (song) {
         if (isNaN(song)) throw new Error("Please provide a valid official song ID.");
-        const { sm, bot, pg, dout, bab, clg, j, tm, c, xs, cf, toe, ea, cs, ed, hf, bp, toeii, gd, d, fd, dash, exp, tss, va, ar, tc, p, bm, m, y, f, sp, s, e, round, mdo, ps, ne, pt, unknown } = require("../misc/officialsongs.json");
-        const jsons = { 1: sm, 2: bot, 3: pg, 4: dout, 5: bab, 6: clg, 7: j, 8: tm, 9: c, 10: xs, 11: cf, 12: toe, 13: ea, 14: cs, 15: ed, 16: hf, 17: bp, 18: toeii, 19: gd, 20: d, 21: fd, 22: dash, 23: exp, 24: tss, 25: va, 26: ar, 27: tc, 28: p, 29: bm, 30: m, 31: y, 32: f, 33: sp, 34: s, 35: e, 36: round, 37: mdo, 38: ps, 39: ne, 40: pt };
+        const officialSongs = require("../misc/officialsongs.json");
 
-        let result = jsons[Number(song)];
-        if (!result) result = unknown;
+        let result = officialSongs[Number(song)];
+        if (!result) result = officialSongs["-1"];
         return result;
     }
 }

package/functions/getProfile.js

@@ -1 +1,198 @@
-module.exports={getProfile:async function(name,mode="auto"){const{gjReq}=require("../gjReq");const{rgbToHEX}=require("../misc/rgbToHEX");const colors=require("../misc/colors.json");if(!name)throw new Error("Please provide an account name, player ID or account ID!");if(!["name","accountid","playerid","auto"].includes(mode))throw new Error('Please provide a valid search mode! It\'s either "name", "accountid", "playerid", or "auto"');function decodeUser(array){let accName=array[1];let playerID=Number(array[3]);let secretCoins=Number(array[5]);let userCoins=Number(array[7]);let c1=array[9];let c2=array[11];let stars=Number(array[15]);let moons=Number(array[17]);let diamonds=Number(array[19]);let demons=Number(array[21]);let cp=Number(array[23]);let msg=array[25];let friendReqs=array[27];let commentHistory=array[29];let yt=array[31];let cube=Number(array[33]);let ship=Number(array[35]);let ball=Number(array[37]);let ufo=Number(array[39]);let wave=Number(array[41]);let robot=Number(array[43]);let spider=Number(array[47]);let swing=Number(array[51]);let jetpack=Number(array[53]);let glow=Boolean(Number(array[45]));let explosion=Number(array[49]);let rank=Number(array[55]);let accID=Number(array[57]);let twitter=array[61];let twitch=array[63];let mod=array[65];let msgObj={0:"all",1:"friends",2:"none"};let friendReqsObj={0:"all",1:"none"};let modObj={0:"none",1:"mod",2:"elder"};return{username:accName,playerID:playerID,accountID:accID,rank:rank,stars:stars,diamonds:diamonds,secretCoins:secretCoins,userCoins:userCoins,demons:demons,moons:moons,creatorPoints:cp,c1:rgbToHEX(colors[c1]),c2:rgbToHEX(colors[c2]),cubeID:cube,shipID:ship,ballID:ball,ufoID:ufo,waveID:wave,robotID:robot,spiderID:spider,swingID:swing,jetpackID:jetpack,explosionID:explosion,glow:glow,messages:msgObj[msg],friendRequests:friendReqsObj[friendReqs],commentHistory:msgObj[commentHistory],mod:modObj[mod],youtube:yt,twitter:twitter,twitch:twitch}}async function accIDSearch(){let res=await gjReq("getGJUserInfo20",{targetAccountID:name,secret:"Wmfd2893gb7"});if(res.data==-1)return{};let accArray=res.data.split(":");return decodeUser(accArray)}async function nonAccIDSearch(){let search=await gjReq("getGJUsers20",{str:name,secret:"Wmfd2893gb7"});if(search.data==-1)return{};let targetAccID=search.data.split(":")[21];let res=await gjReq("getGJUserInfo20",{targetAccountID:targetAccID,secret:"Wmfd2893gb7"});let accArray=res.data.split(":");return decodeUser(accArray)}let result;if(mode=="accountid"){const user=await new Promise(resolve=>{accIDSearch().then(u=>resolve(u))});return user}if(mode=="name"||mode=="playerid"){const user=await new Promise(resolve=>{nonAccIDSearch().then(u=>resolve(u))});return user}if(isNaN(name)){const user=await new Promise(resolve=>{nonAccIDSearch().then(u=>resolve(u))});return user}else{let user;const accIDUser=await new Promise(resolve=>{accIDSearch().then(u=>resolve(u))});if(!Object.keys(user).length){const nonAccIDUser=await new Promise(resolve=>{nonAccIDSearch().then(u=>resolve(u))});user=nonAccIDUser}else{user=accIDUser}return user}}};
+/**
+ * @typedef {Object} Player
+ * @property {string} username - The player's username.
+ * @property {number} playerID - The player's player ID.
+ * @property {number} accountID - The player's account ID.
+ * @property {number} rank - The player's position on the global leaderboard.
+ * @property {number} stars - The amount of stars the player has.
+ * @property {number} diamonds - The amount of diamonds the player has.
+ * @property {number} secretCoins - The amount of secret coins the player has.
+ * @property {number} userCoins - The amount of user coins the player has.
+ * @property {number} demons - The amount of demons the player has completed.
+ * @property {number} moons - The amount of moons the player has.
+ * @property {number} creatorPoints - The amount of creator points the player has.
+ * @property {string} color1 - The HEX code of the player's primary color.
+ * @property {string} color2 - The HEX code of the player's secondary color.
+ * @property {number} cubeID - The ID of the currently selected cube icon.
+ * @property {number} shipID - The ID of the currently selected ship icon.
+ * @property {number} ballID - The ID of the currently selected ball icon.
+ * @property {number} ufoID - The ID of the currently selected UFO icon.
+ * @property {number} waveID - The ID of the currently selected wave icon.
+ * @property {number} robotID - The ID of the currently selected robot icon.
+ * @property {number} spiderID - The ID of the currently selected spider icon.
+ * @property {number} swingID - The ID of the currently selected swing icon.
+ * @property {number} jetpackID - The ID of the currently selected jetpack icon.
+ * @property {number} explosionID - The ID of the currently selected explosion animation.
+ * @property {boolean} glow - Whether the player's icon has the "glow" feature enabled.
+ * @property {string} messages - The current state of messaging the player. Returns "all" if anyone can message the person, "friends" if it's limited to friends, and "none" if no one can.
+ * @property {boolean} friendRequests - Whether the player has allowed to receive friend requests.
+ * @property {string} commentHistory - The current state of viewing the player's comment history. Returns "all" if anyone can do it, "friends" if it's limited to friends, and "none" if only the player can.
+ * @property {string|null} mod - Whether the player is a moderator. Returns `null` if not, "mod" if the user is a regular moderator and "elder" if the user is an elder moderator.
+ * @property {string} youtube - The player's YouTube channel ID, used in this template: `https://youtube.com/channel/((youtube))`.
+ * @property {string} twitter - The player's X (formerly Twitter) username, used in this template: `https://x.com/((twitter))`.
+ * @property {string} twitch - The player's Twitch username, used in this template: `https://twitch.tv/((twitch))`.
+ */
+
+module.exports = {
+    /**
+     * Fetches the profile of a specified user.
+     * @param {string} name - The search query (user, account ID or player ID).
+     * @param {("name"|"accountid"|"playerid")} mode - The search mode, defaults to "auto". If "auto" is selected, the search is first attempted by matching the matching the username, then account ID and then player ID.
+     * @returns {Player}
+     */
+    getProfile: async function (name, mode = "auto") {
+        const { gjReq } = require("../gjReq");
+        const { rgbToHEX } = require("../misc/rgbToHEX");
+        const colors = require("../misc/colors.json");
+        if (!name) throw new Error("Please provide an account name, player ID or account ID!")
+        if (!["name", "accountid", "playerid", "auto"].includes(mode)) throw new Error("Please provide a valid search mode! It's either \"name\", \"accountid\", \"playerid\", or \"auto\"")
+
+        function decodeUser(array) {
+            let accName = array[1];
+            let playerID = Number(array[3]);
+            let secretCoins = Number(array[5]);
+            let userCoins = Number(array[7]);
+            let c1 = array[9];
+            let c2 = array[11];
+            let stars = Number(array[15]);
+            let moons = Number(array[17]);
+            let diamonds = Number(array[19]);
+            let demons = Number(array[21]);
+            let cp = Number(array[23]);
+            let msg = array[25];
+            let friendReqs = array[27];
+            let commentHistory = array[29];
+            let yt = array[31];
+            let cube = Number(array[33]);
+            let ship = Number(array[35]);
+            let ball = Number(array[37]);
+            let ufo = Number(array[39]);
+            let wave = Number(array[41]);
+            let robot = Number(array[43]);
+            let spider = Number(array[47]);
+            let swing = Number(array[51]);
+            let jetpack = Number(array[53]);
+            let glow = Boolean(Number(array[45]));
+            let explosion = Number(array[49]);
+            let rank = Number(array[55]);
+            let accID = Number(array[57]);
+            let twitter = array[61];
+            let twitch = array[63];
+            let mod = array[65];
+
+            let msgObj = {
+                0: "all",
+                1: "friends",
+                2: "none"
+            }
+
+            let friendReqsObj = {
+                0: true,
+                1: false
+            }
+
+            let modObj = {
+                0: null,
+                1: "mod",
+                2: "elder"
+            }
+
+            return {
+                username: accName,
+                playerID: playerID,
+                accountID: accID,
+                rank: rank,
+                stars: stars,
+                diamonds: diamonds,
+                secretCoins: secretCoins,
+                userCoins: userCoins,
+                demons: demons,
+                moons: moons,
+                creatorPoints: cp,
+                color1: rgbToHEX(colors[c1]),
+                color2: rgbToHEX(colors[c2]),
+                cubeID: cube,
+                shipID: ship,
+                ballID: ball,
+                ufoID: ufo,
+                waveID: wave,
+                robotID: robot,
+                spiderID: spider,
+                swingID: swing,
+                jetpackID: jetpack,
+                explosionID: explosion,
+                glow: glow,
+                messages: msgObj[msg],
+                friendRequests: friendReqsObj[friendReqs],
+                commentHistory: msgObj[commentHistory],
+                mod: modObj[mod],
+                youtube: yt,
+                twitter: twitter,
+                twitch: twitch
+            }
+        }
+
+        async function accIDSearch() {
+            let res = await gjReq("getGJUserInfo20", {
+                targetAccountID: name,
+                secret: "Wmfd2893gb7"
+            });
+            if (res.data == -1) return {};
+            let accArray = res.data.split(":");
+
+            return decodeUser(accArray);
+        }
+
+        async function nonAccIDSearch() {
+            let search = await gjReq("getGJUsers20", {
+                str: name,
+                secret: "Wmfd2893gb7"
+            });
+            if (search.data == -1) return {};
+            let targetAccID = search.data.split(":")[21];
+
+            let res = await gjReq("getGJUserInfo20", {
+                targetAccountID: targetAccID,
+                secret: "Wmfd2893gb7"
+            });
+            let accArray = res.data.split(":");
+
+            return decodeUser(accArray);
+        }
+
+        if (mode == "accountid") {
+            const user = await new Promise((resolve) => {
+                accIDSearch().then(u => resolve(u));
+            })
+            return user;
+        }
+
+        if (mode == "name" || mode == "playerid") {
+            const user = await new Promise((resolve) => {
+                nonAccIDSearch().then(u => resolve(u));
+            })
+            return user;
+        }
+
+        if (isNaN(name)) {
+            const user = await new Promise((resolve) => {
+                nonAccIDSearch().then(u => resolve(u));
+            })
+            return user;
+        } else {
+            let user;
+            const accIDUser = await new Promise((resolve) => {
+                accIDSearch().then(u => resolve(u));
+            })
+            if (!Object.keys(user).length) {
+                const nonAccIDUser = await new Promise((resolve) => {
+                    nonAccIDSearch().then(u => resolve(u));
+                })
+                user = nonAccIDUser;
+            } else {
+                user = accIDUser;
+            }
+            return user;
+        }
+    }
+}

package/functions/getSongInfo.js

@@ -1,4 +1,19 @@
+/**
+ * @typedef {Object} Song
+ * @property {string} name - The song's name.
+ * @property {number} id - The song's ID.
+ * @property {string} artist - The song artist.
+ * @property {number} artistId - The song artist's ID on Newgrounds.
+ * @property {number} fileSize - The song's file size in megabytes.
+ * @property {string} link - The direct link to download the song file.
+ */
+
 module.exports = {
+    /**
+     * Searches for a song on Newgrounds or in the internal Geometry Dash song library.
+     * @param {number} song - The song ID.
+     * @returns {Song}
+     */
     getSongInfo: async function (song) {
         if (isNaN(song)) throw new Error("Please provide a valid song ID.");
         const { gjReq } = require("../gjReq");
@@ -16,12 +31,12 @@ module.exports = {
         if (link == "CUSTOMURL") link = `https://geometrydashfiles.b-cdn.net/music/${song.toString().trim()}.ogg`;
 
         const result = {
-            "name": rawSong[3],
-            "id": Number(rawSong[1]),
-            "artist": rawSong[7],
-            "artistId": Number(rawSong[5]),
-            "fileSize": `${rawSong[9]} MB`,
-            "link": link
+            name: rawSong[3],
+            id: Number(rawSong[1]),
+            artist: rawSong[7],
+            artistId: Number(rawSong[5]),
+            fileSize: Number(rawSong[9]),
+            link: link
         }
 
         return result;