simply-xp 2.0.0-dev.4 → 2.0.0-dev.5-fix.0

package/lib/src/cards.d.ts

@@ -1,6 +1,31 @@
 /// <reference types="node" />
+import { SKRSContext2D } from "@napi-rs/canvas";
 import { User } from "./leaderboard";
 type HexColor = `#${string}` | `0x${string}`;
+export type CompareCardLocales = {
+    level?: string;
+    versus?: string;
+};
+/**
+ * @property {URL} background - Background image URL
+ * @property {HexColor} color - Avatar border color
+ * @property {HexColor} centerBar - Center bar color
+ * @property {HexColor} centerBarBg - Center bar background color
+ * @property {string} font - ABSOLUTE FILE PATH
+ * @property {boolean} light - Use light theme
+ */
+export interface CompareCardOptions {
+    background?: URL;
+    color?: HexColor;
+    centerBar?: HexColor;
+    centerBarBg?: HexColor;
+    font?: string;
+    light?: boolean;
+}
+export type LeaderboardCardLocales = {
+    level?: string;
+    members?: string;
+};
 /**
  * @property {[HexColor, HexColor]} artworkColors - Gradient colors
  * @property {URL} artworkImage
@@ -10,7 +35,7 @@ type HexColor = `#${string}` | `0x${string}`;
  * @property {string} font - ABSOLUTE FILE PATH
  * @property {boolean} light - Use light theme
  */
-export interface LeaderboardOptions {
+export interface LeaderboardCardOptions {
     artworkColors?: [HexColor, HexColor];
     artworkImage?: URL;
     borderColors?: [HexColor, HexColor];
@@ -19,9 +44,14 @@ export interface LeaderboardOptions {
     font?: string;
     light?: boolean;
 }
+export type RankCardLocales = {
+    level?: string;
+    next_level?: string;
+    xp?: string;
+};
 /**
  * @property {URL} background - Background image URL
- * @property {HexColor} color
+ * @property {HexColor} color - Avatar border color
  * @property {boolean} legacy - Use legacy card design
  * @property {HexColor} lvlbar
  * @property {HexColor} lvlbarBg
@@ -31,39 +61,32 @@ export interface RankCardOptions {
     background?: URL;
     color?: HexColor;
     legacy?: boolean;
+    light?: boolean;
     lvlbar?: HexColor;
     lvlbarBg?: HexColor;
     font?: string;
 }
-export type UserOptions = {
+export type CardUserOptions = {
     id: string;
     username: string;
     avatarURL: string;
 };
-export type LeaderboardLocales = {
-    level?: string;
-    members?: string;
-};
-export type rankLocales = {
-    level?: string;
-    next_level?: string;
-    xp?: string;
-};
 /**
- * Generate a simple user rank card
+ * Generate a simple comparison card
  * @async
  * @param {{id: string, name: string}} guild - (id, name)
- * @param {UserOptions} user - (id, username, avatarURL)
- * @param {RankCardOptions?} options - (background, color, legacy, lvlbar, lvlbarBg, font)
- * @param {rankLocales?} locales - [BETA] Translate the rank card
- * @link [Documentation](https://simplyxp.js.org/docs/rankCard)
+ * @param {CardUserOptions} user1 - User 1
+ * @param {CardUserOptions} user2 - User 2
+ * @param {CompareCardOptions?} options - (background, color, legacy, lvlbar, lvlbarBg, font)
+ * @param {CompareCardLocales?} locales - [BETA] Translate the rank card
+ * @link `Documentation` https://simplyxp.js.org/docs/next/functions/compareCard
  * @returns {Promise<{attachment: Buffer, description: string, name: string}>}
- * @throws {XpFatal} - If parameters are not provided correctly
+ * @throws {XpFatal} - If parameters are not provided correctly or if the user is not found in the database
  */
-export declare function rankCard(guild: {
+export declare function compareCard(guild: {
     id: string;
     name: string;
-}, user: UserOptions, options?: RankCardOptions, locales?: rankLocales): Promise<{
+}, user1: CardUserOptions, user2: CardUserOptions, options?: CompareCardOptions, locales?: CompareCardLocales): Promise<{
     attachment: Buffer;
     description: string;
     name: string;
@@ -72,18 +95,37 @@ export declare function rankCard(guild: {
  * Generate a simple leaderboard card
  * @async
  * @param {Array<User>} data - Array of user data
- * @param {LeaderboardOptions?} options - (artworkColor, artworkImage, light)
+ * @param {LeaderboardCardOptions?} options - (artworkColor, artworkImage, light)
  * @param {{name: string, imageURL: string, memberCount: number}?} guildInfo - Guild info
- * @param {LeaderboardLocales} locales - Locales
- * @link [Documentation](https://simplyxp.js.org/docs/leaderboard)
+ * @param {LeaderboardCardLocales?} locales - Locales
+ * @link `Documentation` https://simplyxp.js.org/docs/next/functions/leaderboard
  * @returns {Promise<{attachment: Buffer, description: string, name: string}>}
  * @throws {XpFatal} - If parameters are not provided correctly
  */
-export declare function leaderboardCard(data: Array<User>, options?: LeaderboardOptions, guildInfo?: {
+export declare function leaderboardCard(data: Array<User>, options?: LeaderboardCardOptions, guildInfo?: {
     name: string;
     imageURL: string;
     memberCount: number;
-}, locales?: LeaderboardLocales): Promise<{
+}, locales?: LeaderboardCardLocales): Promise<{
+    attachment: Buffer;
+    description: string;
+    name: string;
+}>;
+/**
+ * Generate a simple user rank card
+ * @async
+ * @param {{id: string, name: string}} guild - (id, name)
+ * @param {CardUserOptions} user - (id, username, avatarURL)
+ * @param {RankCardOptions?} options - (background, color, legacy, lvlbar, lvlbarBg, font)
+ * @param {RankCardLocales?} locales - [BETA] Translate the rank card
+ * @link `Documentation` https://simplyxp.js.org/docs/next/functions/rankCard
+ * @returns {Promise<{attachment: Buffer, description: string, name: string}>}
+ * @throws {XpFatal} - If parameters are not provided correctly
+ */
+export declare function rankCard(guild: {
+    id: string;
+    name: string;
+}, user: CardUserOptions, options?: RankCardOptions, locales?: RankCardLocales): Promise<{
     attachment: Buffer;
     description: string;
     name: string;
@@ -92,13 +134,7 @@ export declare function leaderboardCard(data: Array<User>, options?: Leaderboard
  * @constructor
  * @private
  */
-export declare function RoundedBox(ctx: {
-    beginPath: () => void;
-    moveTo: (arg0: number, arg1: number) => void;
-    lineTo: (arg0: number, arg1: number) => void;
-    quadraticCurveTo: (arg0: number, arg1: number, arg2: number, arg3: number) => void;
-    closePath: () => void;
-}, x: number, y: number, width: number, height: number, radius: number, roundCorners?: {
+export declare function RoundedBox(ctx: SKRSContext2D, x: number, y: number, width: number, height: number, radius: number, strokeColor?: string, roundCorners?: {
     top?: boolean;
     bottom?: boolean;
 }): void;

package/lib/src/cards.js

@@ -1,23 +1,35 @@
 "use strict";
 /**
- * Generate a simple user rank card
+ * Generate a simple comparison card
  * @async
  * @param {{id: string, name: string}} guild - (id, name)
- * @param {UserOptions} user - (id, username, avatarURL)
- * @param {RankCardOptions?} options - (background, color, legacy, lvlbar, lvlbarBg, font)
- * @param {rankLocales?} locales - [BETA] Translate the rank card
- * @link [Documentation](https://simplyxp.js.org/docs/rankCard)
+ * @param {CardUserOptions} user1 - User 1
+ * @param {CardUserOptions} user2 - User 2
+ * @param {CompareCardOptions?} options - (background, color, legacy, lvlbar, lvlbarBg, font)
+ * @param {CompareCardLocales?} locales - [BETA] Translate the rank card
+ * @link `Documentation` https://simplyxp.js.org/docs/next/functions/compareCard
  * @returns {Promise<{attachment: Buffer, description: string, name: string}>}
- * @throws {XpFatal} - If parameters are not provided correctly
- */async function rankCard(guild,user,options={},locales={}){var e,a,o,t,r,l,n,d;if(!guild)throw new xplogs_1.XpFatal({function:"rankCard()",message:"No Guild Provided"});if(!user)throw new xplogs_1.XpFatal({function:"rankCard()",message:"No User Provided"});options.legacy=!0;let i,s;if(locales?.level||(locales.level="Level"),locales?.next_level||(locales.next_level="Next Level"),locales?.xp||(locales.xp="XP"),xplogs_1.XpLog.debug("rankCard()","LEGACY MODE ENABLED"),xplogs_1.XpLog.info("rankCard()","Modern RankCard is coming in dev.5"),!user?.avatarURL.endsWith(".png")&&!user.avatarURL.endsWith(".jpg")&&!user.avatarURL.endsWith(".webp"))throw new xplogs_1.XpFatal({function:"rankCard()",message:"Invalid avatar image, avatar image must be a png, jpg, or webp"});if(!user||!user.id||!user.username)throw new xplogs_1.XpFatal({function:"rankCard()",message:"Invalid User Provided, user must contain id, username, and avatarURL."});canvas_1.GlobalFonts.registerFromPath(options?.font||(0,path_1.join)(__dirname,"Fonts","BalooBhaijaan-Regular.otf"),"Sans Serif"),cachedRankImage=cachedRankImage||await(0,canvas_1.loadImage)(options?.background||"https://i.ibb.co/dck2Tnt/rank-card.webp").catch(()=>{throw new xplogs_1.XpFatal({function:"rankCard()",message:"Unable to load background image, is it valid?"})}),n=await(0,canvas_1.loadImage)(user.avatarURL).catch(()=>{throw new xplogs_1.XpFatal({function:"rankCard()",message:"Unable to load user's AvatarURL, is it reachable?"})});let c=await database_1.db.findOne({collection:"simply-xps",data:{guild:guild.id,user:user.id}});if(!c){if(!xp_1.xp.auto_create)throw new xplogs_1.XpFatal({function:"rankCard()",message:"User not found in database"});c=await(0,xp_1.create)(user.id,guild.id,user.username)}return d=await database_1.db.find({collection:"simply-xps",data:{guild:guild.id}}),c.position=d.sort((a,b)=>b.xp-a.xp).findIndex(u=>u.user===user.id)+1,options?.legacy?(d=user.username.replace(/[\u007f-\uffff]/g,""),e=options?.color||"#9900ff",a=options?.lvlbar||"#ffffff",options=options?.lvlbarBg||"#ffffff",o=shortener(c.xp)+(" "+locales.xp),t=locales.level+(" "+shortener(c.level)),r=(0,utilities_1.convertFrom)(c.level+1),l=(0,utilities_1.convertFrom)(c.level),l=100*(c.xp-l)/(r-l)*660/100,cachedRankContext&&cachedRankCanvas?(i=cachedRankCanvas,s=cachedRankContext):(i=(0,canvas_1.createCanvas)(1080,400),RoundedBox(s=i.getContext("2d"),0,0,i.width,i.height,50),s.clip(),s.fillStyle="#000000",s.fillRect(0,0,1080,400),s.globalAlpha=.7,s.drawImage(cachedRankImage,-5,0,1090,400),s.restore(),s.fillStyle="#000000",s.globalAlpha=.4,s.fillRect(40,0,240,i.height),s.globalAlpha=1),s.save(),RoundedBox(s,70,30,180,180,50),s.strokeStyle=e,s.lineWidth=15,s.stroke(),s.clip(),s.drawImage(n,70,30,180,180),s.restore(),s.save(),RoundedBox(s,70,320,180,50,20),s.strokeStyle="#BFC85A22",s.stroke(),s.clip(),s.fillStyle=e,s.globalAlpha=1,s.fillRect(70,320,180,50),s.globalAlpha=1,s.fillStyle="#ffffff",s.textAlign="center",dynamicFont(s,o,160,358,160,32),s.restore(),s.save(),RoundedBox(s,70,240,180,50,20),s.strokeStyle="#BFC85A22",s.stroke(),s.clip(),s.fillStyle=e,s.globalAlpha=1,s.fillRect(70,240,180,50),s.globalAlpha=1,s.fillStyle="#ffffff",s.textAlign="center",dynamicFont(s,t,160,278,160,32),s.restore(),s.save(),s.textAlign="left",s.fillStyle="#ffffff",s.shadowColor="#000000",s.shadowBlur=15,s.shadowOffsetX=1,s.shadowOffsetY=1,s.font='39px "Sans Serif"',s.fillText(d,390,80),s.restore(),s.save(),s.textAlign="right",s.fillStyle="#ffffff",s.shadowColor="#000000",s.shadowBlur=15,s.shadowOffsetX=1,s.shadowOffsetY=1,s.font='55px "Sans Serif"',s.fillText("#"+c.position,i.width-55,80),s.restore(),s.save(),RoundedBox(s,390,305,660,70,Number(20)),s.strokeStyle="#BFC85A22",s.stroke(),s.clip(),s.fillStyle="#ffffff",s.textAlign="center",dynamicFont(s,guild.name,720,355,700,45),s.globalAlpha=.2,s.fillRect(390,305,660,70),s.restore(),s.save(),RoundedBox(s,390,145,660,50,20),s.strokeStyle="#BFC85A22",s.stroke(),s.clip(),s.fillStyle=options,s.globalAlpha=.2,s.fillRect(390,145,660,50),s.restore(),s.save(),RoundedBox(s,390,145,l,50,20),s.strokeStyle="#BFC85A22",s.stroke(),s.clip(),s.fillStyle=a,s.globalAlpha=.5,s.fillRect(390,145,l,50),s.restore(),s.save(),s.textAlign="left",s.fillStyle="#ffffff",s.globalAlpha=.8,s.font='30px "Sans Serif"',s.fillText(locales.next_level+": "+shortener(r)+" "+locales.xp,390,230),s.restore(),n="{current} / {needed}".replace(/{needed}/g,shortener(r)).replace(/{current}/g,shortener(c.xp)),s.textAlign="center",s.fillStyle="#474747",s.globalAlpha=1,s.font='30px "Sans Serif"',s.fillText(n,730,180)):i=(0,canvas_1.createCanvas)(1080,360),{attachment:i.toBuffer("image/png"),description:"Simply-XP Rank Card",name:"rank.png"}}
+ * @throws {XpFatal} - If parameters are not provided correctly or if the user is not found in the database
+ */async function compareCard(guild,user1,user2,options={},locales={}){var e,a,o,t,r,l;if(!guild?.id||!guild?.name)throw new xplogs_1.XpFatal({function:"compareCard()",message:"Please provide a guild"});if(!(user1?.id&&user1?.username&&user2?.id&&user2?.username))throw new xplogs_1.XpFatal({function:"compareCard()",message:"Please provide two valid users!"});if(!user1?.avatarURL.endsWith(".png")&&!user1.avatarURL.endsWith(".jpg")&&!user1.avatarURL.endsWith(".webp"))throw new xplogs_1.XpFatal({function:"compareCard()",message:"[USER 1] Avatar image must be a png, jpg, or webp"});if(!user2?.avatarURL.endsWith(".png")&&!user2.avatarURL.endsWith(".jpg")&&!user2.avatarURL.endsWith(".webp"))throw new xplogs_1.XpFatal({function:"compareCard()",message:"[USER 2] Avatar image, avatar image must be a png, jpg, or webp"});canvas_1.GlobalFonts.registerFromPath(options?.font||(0,path_1.join)(__dirname,"Fonts","BalooBhaijaan-Regular.woff2"),"Sans Serif"),locales?.level||(locales.level="Level"),locales?.versus||(locales.versus="vs"),t=await(0,canvas_1.loadImage)(options?.background||"https://i.ibb.co/WnfXZjc/clouds.jpg").catch(()=>{throw new xplogs_1.XpFatal({function:"compareCard()",message:"Unable to load background image, is it valid?"})}),e=await(0,canvas_1.loadImage)(user1.avatarURL).catch(()=>{throw new xplogs_1.XpFatal({function:"compareCard()",message:"[USER 1] Unable to load user's AvatarURL, is it reachable?"})}),a=await(0,canvas_1.loadImage)(user2.avatarURL).catch(()=>{throw new xplogs_1.XpFatal({function:"compareCard()",message:"[USER 2] Unable to load user's AvatarURL, is it reachable?"})});let n=await database_1.db.findOne({collection:"simply-xps",data:{guild:guild.id,user:user1.id}});if(!n){if(!xp_1.xp.auto_create||!user2?.username)throw new xplogs_1.XpFatal({function:"compareCard()",message:"[USER 1] User not found in database"});n=await(0,xp_1.create)(user1.id,guild.id,user1.username)}let s=await database_1.db.findOne({collection:"simply-xps",data:{guild:guild.id,user:user2.id}});if(!s){if(!xp_1.xp.auto_create||!user2?.username)throw new xplogs_1.XpFatal({function:"compareCard()",message:"[USER 2] User not found in database"});s=await(0,xp_1.create)(user2.id,guild.id,user2.username)}return RoundedBox(o=(guild=(0,canvas_1.createCanvas)(1080,400)).getContext("2d"),0,0,guild.width,guild.height,25),o.clip(),o.globalAlpha=.2,o.fillStyle=options?.light?"#ffffff":"#000000",o.fill(),o.globalAlpha=.5,o.drawImage(t,-5,0,1090,400),o.restore(),o.globalAlpha=1,t=user1.username.replace(/[\u007f-\uffff]/g,""),user1=user2.username.replace(/[\u007f-\uffff]/g,""),user2=options?.color||"rgba(255,255,255,0.5)",options=options?.centerBarBg||options?.light?"rgba(255,255,255,0.2)":"rgba(0,0,0,0.2)",r=locales.level+(" "+shortener(n.level)),l=locales.level+(" "+shortener(s.level)),o.save(),o.textAlign="center",o.fillStyle="#ffffff",o.shadowColor="#000000",o.shadowBlur=6,o.shadowOffsetX=1,o.shadowOffsetY=1,o.font='39px "Sans Serif"',o.fillText(`${t} ${locales.versus} `+user1,540,60),o.restore(),o.save(),o.beginPath(),o.arc(160,200,100,0,2*Math.PI,!0),o.closePath(),o.strokeStyle=user2,o.lineWidth=15,o.stroke(),o.clip(),o.drawImage(e,50,90,220,220),o.restore(),o.save(),o.beginPath(),o.arc(920,200,100,0,2*Math.PI,!0),o.closePath(),o.strokeStyle=user2,o.lineWidth=15,o.stroke(),o.clip(),o.drawImage(a,810,90,220,220),o.restore(),o.save(),o.globalAlpha=1,o.fillStyle="#ffffff",o.textAlign="center",o.font='25px "Sans Serif"',o.fillText(r,160,350),o.fillText(l,920,350),o.restore(),o.save(),o.globalAlpha=1,RoundedBox(o,265,330,540,25,10),o.clip(),o.fillStyle=options,o.fill(),{attachment:guild.toBuffer("image/png"),description:"Simply-XP Comparison Card",name:"compareCard.png"}}
 /**
  * Generate a simple leaderboard card
  * @async
  * @param {Array<User>} data - Array of user data
- * @param {LeaderboardOptions?} options - (artworkColor, artworkImage, light)
+ * @param {LeaderboardCardOptions?} options - (artworkColor, artworkImage, light)
  * @param {{name: string, imageURL: string, memberCount: number}?} guildInfo - Guild info
- * @param {LeaderboardLocales} locales - Locales
- * @link [Documentation](https://simplyxp.js.org/docs/leaderboard)
+ * @param {LeaderboardCardLocales?} locales - Locales
+ * @link `Documentation` https://simplyxp.js.org/docs/next/functions/leaderboard
+ * @returns {Promise<{attachment: Buffer, description: string, name: string}>}
+ * @throws {XpFatal} - If parameters are not provided correctly
+ */async function leaderboardCard(data,options={},guildInfo,locales={}){var e,a;if(!data||data.length<1)throw new xplogs_1.XpFatal({function:"leaderboardCard()",message:"There must be at least 1 user in the data array"});!cachedLeaderboardArtwork&&options?.artworkImage&&(cachedLeaderboardArtwork=await(0,canvas_1.loadImage)(options.artworkImage).catch(()=>{throw new xplogs_1.XpFatal({function:"leaderboardCard()",message:"Unable to load artwork image, is it valid?"})})),!cachedLeaderboardImage&&options?.backgroundImage&&(cachedLeaderboardImage=await(0,canvas_1.loadImage)(options.backgroundImage).catch(()=>{throw new xplogs_1.XpFatal({function:"leaderboardCard()",message:"Unable to load background image, is it valid?"})})),canvas_1.GlobalFonts.registerFromPath(options?.font||(0,path_1.join)(__dirname,"Fonts","BalooBhaijaan-Regular.woff2"),"Sans Serif"),locales.level||(locales.level="LEVEL"),locales.members||(locales.members="Members"),data=data.slice(0,8);let o,t,r,l=(r=options?.light?{artworkColors:options?.artworkColors||["#374bff","#5f69ff"],backgroundColor:"#f0f0eb",borderColors:options?.borderColors||["#ffa237","#ffcc6b"],evenColor:"#dcdcdc",oddColor:"#c8c8c8",primaryTextColor:"#000000",secondaryTextColor:"rgba(0,0,0,0.5)"}:{artworkColors:options?.artworkColors||["#374bff","#333793"],backgroundColor:"#141414",borderColors:options?.borderColors||["#ffa237","#b67125"],evenColor:"#1e1e1e",oddColor:"#282828",primaryTextColor:"#ffffff",secondaryTextColor:"rgba(255,255,255,0.5)"},cachedLeaderboardCanvas&&cachedLeaderboardContext?(o=cachedLeaderboardCanvas,t=cachedLeaderboardContext):(o=(0,canvas_1.createCanvas)(1350,1080),RoundedBox(t=o.getContext("2d"),0,0,o.width,o.height,20),t.clip(),(e=t.createLinearGradient(0,0,o.width,0)).addColorStop(0,r.artworkColors[0]),e.addColorStop(1,r.artworkColors[1]),t.fillStyle=e,t.fillRect(0,0,o.width,220),cachedLeaderboardArtwork&&(t.fillStyle="#000000",t.fillRect(0,0,o.width,220),t.globalAlpha=.5,t.drawImage(cachedLeaderboardArtwork,0,0,o.width,220),t.globalAlpha=1),t.fillStyle=options.backgroundColor||r.backgroundColor,t.fillRect(0,220,o.width,1080),cachedLeaderboardImage&&(t.globalAlpha=.9,t.drawImage(cachedLeaderboardImage,0,220,o.width,1080),t.globalAlpha=1)),guildInfo&&guildInfo?.imageURL&&guildInfo?.name&&guildInfo?.memberCount&&(e=await(0,canvas_1.loadImage)(guildInfo.imageURL),t.save(),t.beginPath(),t.arc(150,110,90,0,2*Math.PI,!0),t.closePath(),t.clip(),t.drawImage(e,60,20,180,180),t.restore(),(options=t.createLinearGradient(0,0,0,220)).addColorStop(0,r.borderColors[0]),options.addColorStop(1,r.borderColors[1]),t.strokeStyle=options,t.lineWidth=10,t.beginPath(),t.arc(150,110,90,0,2*Math.PI,!0),t.stroke(),t.fillStyle=r.primaryTextColor,t.font='60px "Sans Serif"',t.fillText(guildInfo.name,270,110),t.fillStyle=r.secondaryTextColor,t.font='40px "Sans Serif"',t.fillText(guildInfo.memberCount+" "+locales.members,270,160)),r.evenColor);for(let e=0;e<data.length;e++)a=300+90*e,1===data.length?RoundedBox(t,30,a,1290,90,20):0===e?RoundedBox(t,30,a,1290,90,20,void 0,{top:!0,bottom:!1}):e===data.length-1?RoundedBox(t,30,a,1290,90,20,void 0,{top:!1,bottom:!0}):RoundedBox(t,30,a,1290,90,0),t.fillStyle=l,t.globalAlpha=cachedLeaderboardImage?.5:1,t.fill(),t.globalAlpha=1,t.textAlign="left",t.font='30px "Sans Serif"',t.fillStyle=r.secondaryTextColor,t.fillText(e+1+".",60,55+a),t.textAlign="left",t.font='40px "Sans Serif"',t.fillStyle=r.primaryTextColor,t.fillText(data[e]?.name||data[e]?.user||"???",120,60+a),t.textAlign="right",t.font='30px "Sans Serif"',t.fillStyle=r.primaryTextColor,t.fillText(shortener(data[e]?.level)||"???",1270,55+a),t.fillStyle=r.secondaryTextColor,t.fillText(locales.level,1270-t.measureText(shortener(data[e]?.level)||"???").width-15,55+a),l=l===r.evenColor?r.oddColor:r.evenColor;return{attachment:o.toBuffer("image/png"),description:"Simply-XP Leaderboard Card",name:"leaderboard.png"}}
+/**
+ * Generate a simple user rank card
+ * @async
+ * @param {{id: string, name: string}} guild - (id, name)
+ * @param {CardUserOptions} user - (id, username, avatarURL)
+ * @param {RankCardOptions?} options - (background, color, legacy, lvlbar, lvlbarBg, font)
+ * @param {RankCardLocales?} locales - [BETA] Translate the rank card
+ * @link `Documentation` https://simplyxp.js.org/docs/next/functions/rankCard
  * @returns {Promise<{attachment: Buffer, description: string, name: string}>}
  * @throws {XpFatal} - If parameters are not provided correctly
- */async function leaderboardCard(data,options={},guildInfo,locales={}){var e,a;if(!data||data.length<1)throw new xplogs_1.XpFatal({function:"leaderboardCard()",message:"There must be at least 1 user in the data array"});!cachedLeaderboardArtwork&&options?.artworkImage&&(cachedLeaderboardArtwork=await(0,canvas_1.loadImage)(options.artworkImage).catch(()=>{throw new xplogs_1.XpFatal({function:"leaderboardCard()",message:"Unable to load artwork image, is it valid?"})})),!cachedLeaderboardImage&&options?.backgroundImage&&(cachedLeaderboardImage=await(0,canvas_1.loadImage)(options.backgroundImage).catch(()=>{throw new xplogs_1.XpFatal({function:"leaderboardCard()",message:"Unable to load background image, is it valid?"})})),canvas_1.GlobalFonts.registerFromPath(options?.font||(0,path_1.join)(__dirname,"Fonts","BalooBhaijaan-Regular.otf"),"Sans Serif"),locales.level||(locales.level="LEVEL"),locales.members||(locales.members="Members"),data=data.slice(0,8);let o,t,r,l=(r=options?.light?{artworkColors:options?.artworkColors||["#374bff","#5f69ff"],backgroundColor:"#f0f0eb",borderColors:options?.borderColors||["#ffa237","#ffcc6b"],evenColor:"#dcdcdc",oddColor:"#c8c8c8",primaryTextColor:"#000000",secondaryTextColor:"rgba(0,0,0,0.5)"}:{artworkColors:options?.artworkColors||["#374bff","#333793"],backgroundColor:"#141414",borderColors:options?.borderColors||["#ffa237","#b67125"],evenColor:"#1e1e1e",oddColor:"#282828",primaryTextColor:"#ffffff",secondaryTextColor:"rgba(255,255,255,0.5)"},cachedLeaderboardCanvas&&cachedLeaderboardContext?(o=cachedLeaderboardCanvas,t=cachedLeaderboardContext):(o=(0,canvas_1.createCanvas)(1350,1080),RoundedBox(t=o.getContext("2d"),0,0,o.width,o.height,20),t.clip(),(e=t.createLinearGradient(0,0,o.width,0)).addColorStop(0,r.artworkColors[0]),e.addColorStop(1,r.artworkColors[1]),t.fillStyle=e,t.fillRect(0,0,o.width,220),cachedLeaderboardArtwork&&(t.fillStyle="#000000",t.fillRect(0,0,o.width,220),t.globalAlpha=.5,t.drawImage(cachedLeaderboardArtwork,0,0,o.width,220),t.globalAlpha=1),t.fillStyle=options.backgroundColor||r.backgroundColor,t.fillRect(0,220,o.width,1080),cachedLeaderboardImage&&(t.globalAlpha=.9,t.drawImage(cachedLeaderboardImage,0,220,o.width,1080),t.globalAlpha=1)),guildInfo&&guildInfo?.imageURL&&guildInfo?.name&&guildInfo?.memberCount&&(e=await(0,canvas_1.loadImage)(guildInfo.imageURL),t.save(),t.beginPath(),t.arc(150,110,90,0,2*Math.PI,!0),t.closePath(),t.clip(),t.drawImage(e,60,20,180,180),t.restore(),(options=t.createLinearGradient(0,0,0,220)).addColorStop(0,r.borderColors[0]),options.addColorStop(1,r.borderColors[1]),t.strokeStyle=options,t.lineWidth=10,t.beginPath(),t.arc(150,110,90,0,2*Math.PI,!0),t.stroke(),t.fillStyle=r.primaryTextColor,t.font='60px "Sans Serif"',t.fillText(guildInfo.name,270,110),t.fillStyle=r.secondaryTextColor,t.font='40px "Sans Serif"',t.fillText(guildInfo.memberCount+" "+locales.members,270,160)),r.evenColor);for(let e=0;e<data.length;e++)a=300+90*e,1===data.length?RoundedBox(t,30,a,1290,90,20):0===e?RoundedBox(t,30,a,1290,90,20,{top:!0,bottom:!1}):e===data.length-1?RoundedBox(t,30,a,1290,90,20,{top:!1,bottom:!0}):RoundedBox(t,30,a,1290,90,0),t.fillStyle=l,t.globalAlpha=cachedLeaderboardImage?.5:1,t.fill(),t.globalAlpha=1,t.textAlign="left",t.font='30px "Sans Serif"',t.fillStyle=r.secondaryTextColor,t.fillText(e+1+".",60,55+a),t.textAlign="left",t.font='40px "Sans Serif"',t.fillStyle=r.primaryTextColor,t.fillText(data[e]?.name||data[e]?.user||"???",120,60+a),t.textAlign="right",t.font='30px "Sans Serif"',t.fillStyle=r.primaryTextColor,t.fillText(shortener(data[e]?.level)||"???",1270,55+a),t.fillStyle=r.secondaryTextColor,t.fillText(locales.level,1270-t.measureText(shortener(data[e]?.level)||"???").width-15,55+a),l=l===r.evenColor?r.oddColor:r.evenColor;return{attachment:o.toBuffer("image/png"),description:"Simply-XP Leaderboard Card",name:"leaderboard.png"}}function RoundedBox(ctx,x,y,width,height,radius,roundCorners={top:!0,bottom:!0}){ctx.beginPath(),ctx.moveTo(x+(roundCorners.top?radius:0),y),ctx.lineTo(x+width-(roundCorners.top?radius:0),y),roundCorners.top&&ctx.quadraticCurveTo(x+width,y,x+width,y+radius),ctx.lineTo(x+width,y+height-(roundCorners.bottom?radius:0)),roundCorners.bottom&&ctx.quadraticCurveTo(x+width,y+height,x+width-radius,y+height),ctx.lineTo(x+(roundCorners.bottom?radius:0),y+height),roundCorners.bottom&&ctx.quadraticCurveTo(x,y+height,x,y+height-radius),ctx.lineTo(x,y+(roundCorners.top?radius:0)),roundCorners.top&&ctx.quadraticCurveTo(x,y,x+radius,y),ctx.closePath()}function shortener(count){var e,a=["","k","M","B","T","Qa","Qi","Sx","Sp"];return count&&0!==count?count===1/0?"∞":(e=Math.floor(Math.log(count)/Math.log(1e3)),a.length<=e?count.toFixed(0)+a[a.length-1]:(count/Math.pow(1e3,e)).toFixed(0===e?0:2)+a[e]):"0"}function dynamicFont(context,text,x,y,maxWidth,maxSize){let e=maxSize;for(;0<e&&(context.font=e+'px "Sans Serif"',!(context.measureText(text).width<maxWidth));)e--;context.textAlign="center",context.fillText(text,x,y)}Object.defineProperty(exports,"__esModule",{value:!0}),exports.RoundedBox=exports.leaderboardCard=exports.rankCard=void 0;const canvas_1=require("@napi-rs/canvas"),xplogs_1=require("./functions/xplogs"),database_1=require("./functions/database"),utilities_1=require("./functions/utilities"),path_1=require("path"),xp_1=require("../xp");let cachedRankImage,cachedRankCanvas,cachedRankContext,cachedLeaderboardArtwork,cachedLeaderboardCanvas,cachedLeaderboardContext,cachedLeaderboardImage;exports.rankCard=rankCard,exports.leaderboardCard=leaderboardCard,exports.RoundedBox=RoundedBox;
+ */async function rankCard(guild,user,options={},locales={}){var e,a,o,t,r,l,n,s,i,d,f;if(!guild)throw new xplogs_1.XpFatal({function:"rankCard()",message:"No Guild Provided"});if(!user)throw new xplogs_1.XpFatal({function:"rankCard()",message:"No User Provided"});let c,p;if(locales?.level||(locales.level="Level"),locales?.next_level||(locales.next_level="Next Level"),locales?.xp||(locales.xp="XP"),xplogs_1.XpLog.debug("rankCard()",`${options?.legacy?"LEGACY":"MODERN"} ENABLED`),!user?.avatarURL.endsWith(".png")&&!user.avatarURL.endsWith(".jpg")&&!user.avatarURL.endsWith(".webp"))throw new xplogs_1.XpFatal({function:"rankCard()",message:"Invalid avatar image, avatar image must be a png, jpg, or webp"});if(!user||!user.id||!user.username)throw new xplogs_1.XpFatal({function:"rankCard()",message:"Invalid User Provided, user must contain id, username, and avatarURL."});canvas_1.GlobalFonts.registerFromPath(options?.font||(0,path_1.join)(__dirname,"Fonts","BalooBhaijaan-Regular.woff2"),"Sans Serif"),cachedRankImage=cachedRankImage||await(0,canvas_1.loadImage)(options?.background||(options?.legacy?"https://i.ibb.co/dck2Tnt/rank-card.webp":"https://i.ibb.co/WnfXZjc/clouds.jpg")).catch(()=>{throw new xplogs_1.XpFatal({function:"rankCard()",message:"Unable to load background image, is it valid?"})}),e=await(0,canvas_1.loadImage)(user.avatarURL).catch(()=>{throw new xplogs_1.XpFatal({function:"rankCard()",message:"Unable to load user's AvatarURL, is it reachable?"})});let g=await database_1.db.findOne({collection:"simply-xps",data:{guild:guild.id,user:user.id}});if(!g){if(!xp_1.xp.auto_create)throw new xplogs_1.XpFatal({function:"rankCard()",message:"User not found in database"});g=await(0,xp_1.create)(user.id,guild.id,user.username)}return a=await database_1.db.find({collection:"simply-xps",data:{guild:guild.id}}),g.position=a.sort((a,b)=>b.xp-a.xp).findIndex(u=>u.user===user.id)+1,cachedRankContext&&cachedRankCanvas?(c=cachedRankCanvas,p=cachedRankContext):(c=(0,canvas_1.createCanvas)(1080,400),RoundedBox(p=c.getContext("2d"),0,0,c.width,c.height,25),p.clip(),options?.legacy?(p.globalAlpha=1,p.fillStyle="#000000",p.fill()):(p.globalAlpha=.2,p.fillStyle=options?.light?"#ffffff":"#000000",p.fill(),p.globalAlpha=.5),p.drawImage(cachedRankImage,-5,0,1090,400),p.restore()),a=user.username.replace(/[\u007f-\uffff]/g,""),o=options?.color||(options?.legacy?"#9900ff":"rgba(255,255,255,0.5)"),t=options?.lvlbar||"#ffffff",r=options?.lvlbarBg||options?.legacy?"#FFFFFF":options?.light?"rgba(255,255,255,0.2)":"rgba(0,0,0,0.2)",l=shortener(g.xp)+(" "+locales.xp),n=locales.level+(" "+shortener(g.level)),s="{current} / {needed}",i=(0,utilities_1.convertFrom)(g.level+1),d=(0,utilities_1.convertFrom)(g.level),d=100*(g.xp-d)/(i-d)*(options?.legacy?660:530)/100,f="326815959358898189"===g.user?"#ade6d8":1===g.position?"#ADD8E6":2===g.position?"#C0C0C0":3===g.position?"#CD7F32":"#ffffff",p.save(),options?.legacy?(p.fillStyle="#000000",p.globalAlpha=.4,p.fillRect(40,0,240,c.height),p.globalAlpha=1,RoundedBox(p,70,30,180,180,50),p.strokeStyle=o,p.lineWidth=15,p.stroke(),p.clip(),p.drawImage(e,70,30,180,180),p.restore(),p.save(),RoundedBox(p,70,320,180,50,20,"#BFC85A22"),p.fillStyle=o,p.globalAlpha=1,p.fillRect(70,320,180,50),p.globalAlpha=1,p.fillStyle="#ffffff",p.textAlign="center",dynamicFont(p,l,160,358,160,32),p.restore(),p.save(),RoundedBox(p,70,240,180,50,20,"#BFC85A22"),p.fillStyle=o,p.globalAlpha=1,p.fillRect(70,240,180,50),p.globalAlpha=1,p.fillStyle="#ffffff",p.textAlign="center",dynamicFont(p,n,160,278,160,32),p.restore(),p.save(),p.textAlign="left",p.fillStyle="#ffffff",p.shadowColor="#000000",p.shadowBlur=15,p.shadowOffsetX=1,p.shadowOffsetY=1,p.font='39px "Sans Serif"',p.fillText(a,390,80),p.restore(),p.save(),p.textAlign="right",p.fillStyle="#ffffff",p.shadowColor="#000000",p.shadowBlur=15,p.shadowOffsetX=1,p.shadowOffsetY=1,p.font='55px "Sans Serif"',p.fillText("#"+g.position,c.width-55,80),p.restore(),p.save(),RoundedBox(p,390,305,660,70,20,"#BFC85A22"),p.fillStyle="#ffffff",p.textAlign="center",dynamicFont(p,guild.name,720,355,700,45),p.globalAlpha=.2,p.fillRect(390,305,660,70),p.restore(),p.save(),RoundedBox(p,390,145,660,50,20,"#BFC85A22"),p.fillStyle=r,p.globalAlpha=.2,p.fillRect(390,145,660,50),p.restore(),p.save(),RoundedBox(p,390,145,d,50,20,"#BFC85A22"),p.fillStyle=t,p.globalAlpha=.5,p.fillRect(390,145,d,50),p.restore(),p.save(),p.textAlign="left",p.fillStyle="#ffffff",p.globalAlpha=.8,p.font='30px "Sans Serif"',p.fillText(locales.next_level+": "+shortener(i)+" "+locales.xp,390,230),p.restore(),options=s.replace(/{needed}/g,shortener(i)).replace(/{current}/g,shortener(g.xp)),p.textAlign="center",p.fillStyle="#474747",p.globalAlpha=1,p.font='30px "Sans Serif"',p.fillText(options,730,180)):(p.globalAlpha=1,p.save(),p.textAlign="center",p.fillStyle="#ffffff",p.shadowColor="#000000",p.shadowBlur=5,p.shadowOffsetX=1,p.shadowOffsetY=1,p.font='39px "Sans Serif"',p.fillText(a,540,80),p.restore(),p.save(),p.beginPath(),p.arc(160,200,100,0,2*Math.PI,!0),p.closePath(),p.strokeStyle=o,p.lineWidth=15,p.stroke(),p.clip(),p.drawImage(e,50,90,220,220),p.restore(),p.save(),p.beginPath(),p.arc(230,130,30,0,2*Math.PI,!0),p.closePath(),p.strokeStyle=o,p.lineWidth=5,p.stroke(),p.clip(),p.beginPath(),p.arc(230,130,30,0,2*Math.PI,!0),p.closePath(),p.fillStyle=f,p.fill(),p.clip(),p.fillStyle="#000000",p.textAlign="center",p.font='25px "Sans Serif"',p.fillText(shortener(g.position,!0),230,138),p.restore(),p.save(),p.fillStyle="#ffffff",p.font='25px "Sans Serif"',p.textAlign="center",p.globalAlpha=1,p.fillText(n,160,350),p.restore(),p.save(),p.globalAlpha=1,RoundedBox(p,265,330,540,25,10),p.clip(),p.fillStyle=r,p.fill(),RoundedBox(p,270,335,d,15,5),p.fillStyle=t,p.fill(),p.restore(),p.save(),p.textAlign="center",p.fillStyle="#ffffff",p.globalAlpha=.6,p.font='20px "Sans Serif"',p.fillText(s.replace(/{needed}/g,shortener(i)).replace(/{current}/g,shortener(g.xp)),540,320),p.save(),p.fillStyle="#ffffff",p.textAlign="center",p.globalAlpha=1,p.font='25px "Sans Serif"',p.fillText(locales.level+" "+shortener(g.level+1),920,350),p.restore()),{attachment:c.toBuffer("image/png"),description:"Simply-XP Rank Card",name:"rank.png"}}function RoundedBox(ctx,x,y,width,height,radius,strokeColor,roundCorners={top:!0,bottom:!0}){ctx.beginPath(),ctx.moveTo(x+(roundCorners.top?radius:0),y),ctx.lineTo(x+width-(roundCorners.top?radius:0),y),roundCorners.top&&ctx.quadraticCurveTo(x+width,y,x+width,y+radius),ctx.lineTo(x+width,y+height-(roundCorners.bottom?radius:0)),roundCorners.bottom&&ctx.quadraticCurveTo(x+width,y+height,x+width-radius,y+height),ctx.lineTo(x+(roundCorners.bottom?radius:0),y+height),roundCorners.bottom&&ctx.quadraticCurveTo(x,y+height,x,y+height-radius),ctx.lineTo(x,y+(roundCorners.top?radius:0)),roundCorners.top&&ctx.quadraticCurveTo(x,y,x+radius,y),ctx.closePath(),strokeColor&&(ctx.strokeStyle=strokeColor,ctx.stroke(),ctx.clip())}function shortener(count,roundedNumber){let e="",a=0;if(!count||0===count)return"0";if(count===1/0)return"∞";for(;1e3<=count&&a<8;)count/=1e3,a++;switch(a){case 1:e="K";break;case 2:e="M";break;case 3:e="B";break;case 4:e="T";break;case 5:e="Qa";break;case 6:e="Qi";break;case 7:e="Sx";break;case 8:e="Sp"}return""+count.toFixed(0===a||roundedNumber?0:2)+e}function dynamicFont(context,text,x,y,maxWidth,maxSize){let e=maxSize;for(;0<e&&(context.font=e+'px "Sans Serif"',!(context.measureText(text).width<maxWidth));)e--;context.textAlign="center",context.fillText(text,x,y)}Object.defineProperty(exports,"__esModule",{value:!0}),exports.RoundedBox=exports.rankCard=exports.leaderboardCard=exports.compareCard=void 0;const canvas_1=require("@napi-rs/canvas"),xplogs_1=require("./functions/xplogs"),database_1=require("./functions/database"),utilities_1=require("./functions/utilities"),path_1=require("path"),xp_1=require("../xp");let cachedRankImage,cachedRankCanvas,cachedRankContext,cachedLeaderboardArtwork,cachedLeaderboardCanvas,cachedLeaderboardContext,cachedLeaderboardImage;exports.compareCard=compareCard,exports.leaderboardCard=leaderboardCard,exports.rankCard=rankCard,exports.RoundedBox=RoundedBox;

package/lib/src/charts.d.ts

@@ -16,7 +16,7 @@ export interface ChartOptions {
  * @async
  * @param {string} guildId
  * @param {ChartOptions?} options
- * @link `Documentation:` https://simplyxp.js.org/docs/charts
+ * @link `Documentation:` https://simplyxp.js.org/docs/next/functions/charts
  * @returns {Promise<{attachment: Buffer, description: string, name: string}>} Chart attachment
  * @throws {XpFatal} If invalid parameters are provided, or if there are not enough users to create a chart
  */

package/lib/src/charts.js

@@ -4,7 +4,7 @@
  * @async
  * @param {string} guildId
  * @param {ChartOptions?} options
- * @link `Documentation:` https://simplyxp.js.org/docs/charts
+ * @link `Documentation:` https://simplyxp.js.org/docs/next/functions/charts
  * @returns {Promise<{attachment: Buffer, description: string, name: string}>} Chart attachment
  * @throws {XpFatal} If invalid parameters are provided, or if there are not enough users to create a chart
- */async function charts(guildId,options={}){var t,r,a,F,o,l,i,s,d,n;if(!guildId)throw new xplogs_1.XpFatal({function:"charts()",message:"No Guild ID Provided"});if(!options)throw new xplogs_1.XpFatal({function:"charts()",message:"No Options Provided"});options.theme||(options.theme="blue"),options.type||(options.type="bar");let f={background:"#FFFFFF",barColor:"#FFFFFF",pieColors:["#FFFFFF","#FFFFFF","#FFFFFF","#FFFFFF","#FFFFFF","#FFFFFF","#FFFFFF","#FFFFFF","#FFFFFF","#FFFFFF"],textColor:"#FFFFFF"};if((t=await(0,leaderboard_1.leaderboard)(guildId,Math.min(Math.max(options?.limit||10,2),10)).catch(XPError=>{throw new xplogs_1.XpFatal({function:"charts()",message:XPError.message})})).length<2)throw new xplogs_1.XpFatal({function:"charts()",message:"Not enough users to create a chart"});switch(t.sort((a,b)=>b.position-a.position),canvas_1.GlobalFonts.registerFromPath(options?.font||(0,path_1.join)(__dirname,"Fonts","BalooBhaijaan-Regular.otf"),"Sans Serif"),options.theme){case"blue":f={background:"#1e1e3c",barColor:"#747fff",pieColors:["#747fff","#55b9f3","#4dc7ec","#3ad5e5","#32e3dd","#2cf2d4","#26ffd2","#30edb4","#3cda96","#48c878"],textColor:"#FFFFFF"};break;case"dark":f={background:"#1e1e1e",barColor:"#747474",pieColors:["#747474","#8f8f8f","#a8a8a8","#c1c1c1","#dadada","#f4f4f4","#ffffff","#ffffff","#ffffff","#ffffff"],textColor:"#FFFFFF"};break;case"discord":f={background:"#36393f",barColor:"#5865F2",pieColors:["#5865F2","#57F287","#FEE75C","#ED4245","#F47FFF","#FFFFFF","#FFFFFF","#FFFFFF","#FFFFFF","#FFFFFF"],textColor:"#FFFFFF"};break;case"green":f={background:"#1e321e",barColor:"#74ff7f",pieColors:["#74ff7f","#55f3a0","#4decb2","#3dd5c3","#32cdd5","#2cc6e6","#26bfee","#30a8e6","#3c91dd","#487ad4"],textColor:"#FFFFFF"};break;case"orange":f={background:"#321e1e",barColor:"#ff9f74",pieColors:["#ff9f74","#f3b055","#ecbe4d","#d5c63d","#cdd532","#c6e62c","#bfe626","#a8e630","#91dd3c","#7ad448"],textColor:"#FFFFFF"};break;case"red":f={background:"#321e1e",barColor:"#ff7474",pieColors:["#ff7474","#f35555","#ec4d4d","#d53d3d","#cd3232","#c62c2c","#bf2626","#a83030","#913c3c","#7a4848"],textColor:"#FFFFFF"};break;case"space":f={background:"#001F3F",barColor:"#192E5B",pieColors:["#192E5B","#1F3F7F","#264FA3","#2C5FC7","#337FEA","#3D8FFF","#4D9FFF","#5DAFFF","#6DBFFF","#7DCFFF"],textColor:"#FFFFFF"};break;case"yellow":f={background:"#32321e",barColor:"#ffff74",pieColors:["#ffff74","#f3f355","#ecf24d","#d5eb3d","#cde532","#c6e02c","#bfe626","#a8df30","#91d93c","#7ad448"],textColor:"#FFFFFF"}}const c=(0,canvas_1.createCanvas)(920,600),h=c.getContext("2d"),u=Math.max(...t.map(user=>user.level));if((0,cards_1.RoundedBox)(h,0,0,c.width,c.height,25),h.clip(),h.fillStyle=f.background,h.fillRect(0,0,c.width,c.height),"space"===options.theme){h.clearRect(0,0,c.width,c.height),(guildId=h.createRadialGradient(c.width/2,c.height/2,1,c.width/2,c.height/2,Math.max(c.width,c.height))).addColorStop(0,"#000000"),guildId.addColorStop(1,"#001F3F"),h.fillStyle=guildId,h.fillRect(0,0,c.width,c.height),(guildId=h.createRadialGradient(150,150,10,150,150,100)).addColorStop(0,"#F2F2F2"),guildId.addColorStop(.8,"#D3D3D3"),guildId.addColorStop(1,"#001F3F"),h.fillStyle=guildId,h.beginPath(),h.arc(150,150,100,0,2*Math.PI),h.fill(),r=["#6B6B6B","#AA8F00","#473E83","#456579"];for(let e=0;e<r.length;e++)a=Math.random()*c.width,F=Math.random()*c.height,o=50*Math.random()+30,h.beginPath(),h.arc(a,F,o,0,2*Math.PI),h.fillStyle=r[e]||"#FFFFFF",h.fill();h.filter="blur(5px)",h.drawImage(c,0,0),h.filter="none";for(let e=0;e<100;e++)l=Math.random()*c.width,i=Math.random()*c.height,s=2*Math.random(),h.beginPath(),h.arc(l,i,s,0,2*Math.PI),h.fillStyle="#FFFFFF",h.fill()}switch(options.type){case"bar":{n=h.measureText(u.toString()).width,d=c.width-n-60-40;const g=c.height-100-40,p=d/t.length-20,x=20+n+40,b=c.height-50-20;await Promise.all(t.map(async(user,index)=>{var e,t,r=user.level/u*g,index=x+index*(20+p),a=b-r,r=(h.fillStyle=f.barColor,h.strokeStyle=f.barColor,h.lineWidth=2,(0,cards_1.RoundedBox)(h,index,a,p,r,10),h.fill(),h.stroke(),index+p/2),index=(h.fillStyle=f.textColor,h.font="22px Sans Serif",user.level.toString()),F=h.measureText(index).width,a=a-10,index=(h.fillText(index,r-F/2,a),user?.name||user.user),F=h.measureText(index).width,a=(h.font=Math.min(Math.floor(p/F*16),18)+"px Sans Serif",F=h.measureText(index).width,30+b);"space"===options.theme&&(e=r-(user=F+10)/2,t=a-18,h.fillStyle="rgba(0, 0, 0, 0.5)",h.fillRect(e,t,user,22)),h.fillStyle=f.textColor,h.fillText(index,r-F/2,a)}))}break;case"doughnut":{d=c.width-40,n=c.height-40;const C=t.reduce((sum,user)=>sum+user.level,0),m=c.width/2,w=c.height/2,S=Math.min(d,n)/3,y=.6*S;let e=-Math.PI/2;await Promise.all(t.map(async(user,index)=>{user=user.level/C,user=e+2*Math.PI*user,h.fillStyle=f.pieColors[index%f.pieColors.length]||"#FFFFFF",h.beginPath(),h.moveTo(m+S*Math.cos(e),w+S*Math.sin(e)),h.arc(m,w,S,e,user),h.lineTo(m+y*Math.cos(user),w+y*Math.sin(user)),h.arc(m,w,y,user,e,!0),h.closePath(),h.fill(),e=user}));const M=c.height-20-20*t.length;h.fillStyle="rgba(0,0,0,0.25)",h.fillRect(15,M-5,200,20*t.length+5),h.font="12px Sans Serif",t.forEach((user,index)=>{var user=user?.name||user.user,e=f.pieColors[index%f.pieColors.length],index=M+20*index;h.fillStyle=e||"#FFFFFF",h.fillRect(20,index,15,15),h.fillStyle=f.textColor,h.fillText(user,40,11.5+index)})}break;case"pie":{d=c.width-40,n=c.height-40;const v=t.reduce((sum,user)=>sum+user.level,0),k=c.width/2,P=c.height/2,I=Math.min(d,n)/3;let e=-Math.PI/2;await Promise.all(t.map(async(user,index)=>{user=user.level/v,user=e+2*Math.PI*user,h.fillStyle=f.pieColors[index%f.pieColors.length]||"#FFFFFF",h.beginPath(),h.moveTo(k,P),h.arc(k,P,I,e,user),h.closePath(),h.fill(),e=user}));const _=c.height-20-20*t.length;h.fillStyle="rgba(0,0,0,0.25)",h.fillRect(15,_-5,200,20*t.length+5),h.font="12px Sans Serif",t.forEach((user,index)=>{var user=user?.name||user.user,e=f.pieColors[index%f.pieColors.length],index=_+20*index;h.fillStyle=e||"#FFFFFF",h.fillRect(20,index,15,15),h.fillStyle=f.textColor,h.fillText(user,40,11.5+index)})}break;default:throw new xplogs_1.XpFatal({function:"charts()",message:"Invalid chart type provided"})}return{attachment:c.toBuffer("image/png"),description:"Chart",name:"chart.png"}}Object.defineProperty(exports,"__esModule",{value:!0}),exports.charts=void 0;const canvas_1=require("@napi-rs/canvas"),path_1=require("path"),leaderboard_1=require("./leaderboard"),cards_1=require("./cards"),xplogs_1=require("./functions/xplogs");exports.charts=charts;
+ */async function charts(guildId,options={}){var F,t,o,r,a,i,l,s,e;if(!guildId)throw new xplogs_1.XpFatal({function:"charts()",message:"No Guild ID Provided"});if(!options)throw new xplogs_1.XpFatal({function:"charts()",message:"No Options Provided"});options.theme&&["blue","dark","discord","green","orange","red","space","yellow"].includes(options.theme)||(xplogs_1.XpLog.warn("charts()","Invalid theme provided, defaulting to discord"),options.theme="discord"),options.type&&["bar","doughnut","pie"].includes(options.type)||(xplogs_1.XpLog.warn("charts()","Invalid type provided, defaulting to bar chart"),options.type="bar");let n={background:"#FFFFFF",barColor:"#FFFFFF",pieColors:["#FFFFFF","#FFFFFF","#FFFFFF","#FFFFFF","#FFFFFF","#FFFFFF","#FFFFFF","#FFFFFF","#FFFFFF","#FFFFFF"],textColor:"#FFFFFF"};if((F=await(0,leaderboard_1.leaderboard)(guildId,Math.min(Math.max(options?.limit||10,2),10)).catch(XPError=>{throw new xplogs_1.XpFatal({function:"charts()",message:XPError.message})})).length<2)throw new xplogs_1.XpFatal({function:"charts()",message:"Not enough users to create a chart"});switch(F.sort((a,b)=>b.position-a.position),canvas_1.GlobalFonts.registerFromPath(options?.font||(0,path_1.join)(__dirname,"Fonts","BalooBhaijaan-Regular.woff2"),"Sans Serif"),options.theme){case"blue":n={background:"#1e1e3c",barColor:"#747fff",pieColors:["#747fff","#2832C2","#59788E","#00d2e7","#281E5D","#a9f5ff","#000e3f","#30edc2","#186c84","#0098ff"],textColor:"#FFFFFF"};break;case"dark":n={background:"#1e1e1e",barColor:"#747474",pieColors:["#1B1D1F","#454C53","#72787F","#999999","#9EA4AA","#CCCCCC","#C9CDD2","#DEDEDE","#E8EBED","#FFFFFF"],textColor:"#FFFFFF"};break;case"discord":n={background:"#36393f",barColor:"#5865F2",pieColors:["#5865F2","#57F287","#FEE75C","#EB459E","#ED4245","#FFFFFF","#000000","#FAA61A","#C04DF9","#00AAFF"],textColor:"#FFFFFF"};break;case"green":n={background:"#1e321e",barColor:"#74ff7f",pieColors:["#00FF00","#008000","#7FFF00","#32CD32","#228B22","#006400","#9ACD32","#00FA9A","#ADFF2F","#7CFC00"],textColor:"#FFFFFF"};break;case"orange":n={background:"#321e1e",barColor:"#ff9f74",pieColors:["#FF8C00","#FF5E0E","#FF4500","#FF6347","#E26310","#F5761A","#FD673A","#FFA500","#FF7F50","#FFD700"],textColor:"#FFFFFF"};break;case"red":n={background:"#321e1e",barColor:"#ff7474",pieColors:["#FF0000","#FF2400","#FF4500","#FF6347","#FF7F50","#FF8C00","#FFA07A","#FFA500","#FFC0CB","#FFD700"],textColor:"#FFFFFF"};break;case"space":n={background:"#001F3F",barColor:"#192E5B",pieColors:["#192E5B","#1F3F7F","#264FA3","#2C5FC7","#337FEA","#3D8FFF","#4D9FFF","#5DAFFF","#6DBFFF","#7DCFFF"],textColor:"#FFFFFF"};break;case"yellow":n={background:"#32321e",barColor:"#ffff74",pieColors:["#FFFD37","#FFEF00","#FDFF00","#DAA520","#F4C430","#E4D00A","#D2B55B","#FFFFE0","#FFFACD","#F5DEB3"],textColor:"#FFFFFF"}}const d=(0,canvas_1.createCanvas)(920,600),h=d.getContext("2d"),c=Math.max(...F.map(user=>user.level));if((0,cards_1.RoundedBox)(h,0,0,d.width,d.height,25),h.clip(),h.fillStyle=n.background,h.fillRect(0,0,d.width,d.height),"space"===options.theme){h.clearRect(0,0,d.width,d.height),(guildId=h.createRadialGradient(d.width/2,d.height/2,1,d.width/2,d.height/2,Math.max(d.width,d.height))).addColorStop(0,"#000000"),guildId.addColorStop(1,"#001F3F"),h.fillStyle=guildId,h.fillRect(0,0,d.width,d.height),(guildId=h.createRadialGradient(150,150,10,150,150,100)).addColorStop(0,"#F2F2F2"),guildId.addColorStop(.8,"#D3D3D3"),guildId.addColorStop(1,"#001F3F"),h.fillStyle=guildId,h.beginPath(),h.arc(150,150,100,0,2*Math.PI),h.fill(),t=["#6B6B6B","#AA8F00","#473E83","#456579"];for(let e=0;e<t.length;e++)o=Math.random()*d.width,r=Math.random()*d.height,a=50*Math.random()+30,h.beginPath(),h.arc(o,r,a,0,2*Math.PI),h.fillStyle=t[e]||"#FFFFFF",h.fill();h.filter="blur(5px)",h.drawImage(d,0,0),h.filter="none";for(let e=0;e<100;e++)i=Math.random()*d.width,l=Math.random()*d.height,s=2*Math.random(),h.beginPath(),h.arc(i,l,s,0,2*Math.PI),h.fillStyle="#FFFFFF",h.fill()}let u=d.width-40,p=d.height-40;switch(options.type){case"bar":{e=h.measureText(c.toString()).width,u=d.width-e-60-40,p=d.height-100-40;const f=u/F.length-20,g=20+e+40,C=d.height-50-20;await Promise.all(F.map(async(user,index)=>{var e,F,t=user.level/c*p,index=g+index*(20+f),o=C-t,t=(h.fillStyle=n.barColor,h.strokeStyle=n.barColor,h.lineWidth=2,(0,cards_1.RoundedBox)(h,index,o,f,t,10),h.fill(),h.stroke(),index+f/2),index=(h.fillStyle=n.textColor,h.font="22px Sans Serif",user.level.toString()),r=h.measureText(index).width,o=o-10,index=(h.fillText(index,t-r/2,o),user?.name||user.user),r=h.measureText(index).width,o=(h.font=Math.min(Math.floor(f/r*16),18)+"px Sans Serif",r=h.measureText(index).width,30+C);"space"===options.theme&&(e=t-(user=r+10)/2,F=o-18,h.fillStyle="rgba(0, 0, 0, 0.5)",h.fillRect(e,F,user,22)),h.fillStyle=n.textColor,h.fillText(index,t-r/2,o)}))}break;case"doughnut":{const x=F.reduce((sum,user)=>sum+user.level,0),m=Math.min(u,p)/3,b=.6*m;let e=-Math.PI/2;const w=d.width/2,D=d.height/2;await Promise.all(F.map(async(user,index)=>{user=user.level/x,user=e+2*Math.PI*user,h.fillStyle=n.pieColors[index%n.pieColors.length]||"#FFFFFF",h.beginPath(),h.moveTo(w+m*Math.cos(e),D+m*Math.sin(e)),h.arc(w,D,m,e,user),h.lineTo(w+b*Math.cos(user),D+b*Math.sin(user)),h.arc(w,D,b,user,e,!0),h.closePath(),h.fill(),e=user}))}break;case"pie":{const y=F.reduce((sum,user)=>sum+user.level,0),S=Math.min(u,p)/3;let e=-Math.PI/2;const v=d.width/2,A=d.height/2;await Promise.all(F.map(async(user,index)=>{user=user.level/y,user=e+2*Math.PI*user,h.fillStyle=n.pieColors[index%n.pieColors.length]||"#FFFFFF",h.beginPath(),h.moveTo(v,A),h.arc(v,A,S,e,user),h.closePath(),h.fill(),e=user}))}break;default:throw new xplogs_1.XpFatal({function:"charts()",message:"Invalid chart type provided"})}if(["doughnut","pie"].includes(options.type)){const E=d.height-20-20*F.length;h.fillStyle="rgba(0,0,0,0.25)",h.fillRect(15,E-5,200,20*F.length+5),h.font="12px Sans Serif",await Promise.all(F.map(async(user,index)=>{var user=user?.name||user.user,e=n.pieColors[index%n.pieColors.length],index=E+20*index;h.fillStyle=e||"#FFFFFF",h.fillRect(20,index,15,15),h.fillStyle=n.textColor,h.fillText(user,40,11.5+index)}))}return{attachment:d.toBuffer("image/png"),description:"Chart",name:"chart.png"}}Object.defineProperty(exports,"__esModule",{value:!0}),exports.charts=void 0;const canvas_1=require("@napi-rs/canvas"),path_1=require("path"),leaderboard_1=require("./leaderboard"),cards_1=require("./cards"),xplogs_1=require("./functions/xplogs");exports.charts=charts;

package/lib/src/connect.d.ts

@@ -11,7 +11,7 @@ export type ConnectionOptions = {
  * @async
  * @param {string} uri
  * @param {ConnectionOptions} options
- * @link `Documentation:` https://simplyxp.js.org/docs/connect
+ * @link `Documentation:` https://simplyxp.js.org/docs/next/functions/connect
  * @returns {Promise<boolean>}
  * @throws {XpFatal} If an invalid type is provided or if the value is not provided.
  */
@@ -19,8 +19,10 @@ export declare function connect(uri: string, options?: ConnectionOptions): Promi
 /**
  * Check database package versions
  * @private
- * @param {"mongodb" | "sqlite"} type
+ * @param {string} type - NPM Package Name (lowercase)
+ * @param {number} min - Minimum Major Version Number
+ * @param {number} max - Maximum Major Version Number (Optional)
  * @returns {Promise<boolean>}
  * @throws {XpFatal} If the package version is not supported
  */
-export declare function checkPackageVersion(type: "mongodb" | "sqlite"): Promise<boolean>;
+export declare function checkPackageVersion(type: string, min: number, max?: number): Promise<boolean>;

package/lib/src/connect.js

@@ -5,30 +5,33 @@
  * @async
  * @param {string} uri
  * @param {ConnectionOptions} options
- * @link `Documentation:` https://simplyxp.js.org/docs/connect
+ * @link `Documentation:` https://simplyxp.js.org/docs/next/functions/connect
  * @returns {Promise<boolean>}
  * @throws {XpFatal} If an invalid type is provided or if the value is not provided.
- */async function connect(uri,options={type:void 0}){var e,{type:o,auto_create:t,auto_purge:r,notify:a,debug:n}=options;if(!uri)throw new xplogs_1.XpFatal({function:"connect()",message:"No URI Provided"});switch(!1===a&&(xp_1.xp.notify=!1),t&&(xp_1.xp.auto_create=!0),r&&(xp_1.xp.auto_purge=!0),n&&(xp_1.xp.debug=!0),o||(options.type="mongodb",xplogs_1.XpLog.warn("connect()","Database type not provided, defaulting to MongoDB")),o){case"mongodb":if(e=(await Promise.resolve().then(()=>__importStar(require("mongodb")))).MongoClient,!await checkPackageVersion("mongodb"))return xplogs_1.XpLog.err("connect()","MongoDB V4 or higher is required");e=await e.connect(uri).catch(error=>{throw new xplogs_1.XpFatal({function:"connect()",message:error.message})}),xp_1.xp.dbType="mongodb",xp_1.xp.database=e||void 0;break;case"sqlite":try{var[s,i]=await Promise.all([Promise.resolve().then(()=>__importStar(require("better-sqlite3"))),checkPackageVersion("sqlite")]);if(!i)return xplogs_1.XpLog.err("connect()","better-sqlite3 V7 or higher is required");xp_1.xp.database=new s.default(uri),xp_1.xp.dbType="sqlite",xp_1.xp.database.exec(`CREATE TABLE IF NOT EXISTS "simply-xps"
+ */async function connect(uri,options={type:void 0}){var e,{type:t,auto_create:o,auto_purge:n,notify:r,debug:a}=options;if(!uri)throw new xplogs_1.XpFatal({function:"connect()",message:"No URI Provided"});switch(!1===r&&(xp_1.xp.notify=!1),o&&(xp_1.xp.auto_create=!0),n&&(xp_1.xp.auto_purge=!0),a&&(xp_1.xp.debug=!0),t||(options.type="mongodb",xplogs_1.XpLog.warn("connect()","Database type not provided, defaulting to MongoDB")),t){case"mongodb":if(e=(await Promise.resolve().then(()=>__importStar(require("mongodb")))).MongoClient,!await checkPackageVersion("mongodb",4,6))return xplogs_1.XpLog.err("connect()","MongoDB Version 4 to 6 is required");e=await e.connect(uri).catch(error=>{throw new xplogs_1.XpFatal({function:"connect()",message:error.message})}),xp_1.xp.dbType="mongodb",xp_1.xp.database=e||void 0;break;case"sqlite":try{var[i,s]=await Promise.all([Promise.resolve().then(()=>__importStar(require("better-sqlite3"))),checkPackageVersion("better-sqlite3",7,9)]);if(!s)return xplogs_1.XpLog.err("connect()","better-sqlite3 Version 7 to 9 is required");xp_1.xp.database=new i.default(uri),xp_1.xp.dbType="sqlite",xp_1.xp.database.exec(`CREATE TABLE IF NOT EXISTS "simply-xps"
                               (
                                   user  TEXT NOT NULL,
                                   guild TEXT NOT NULL,
-                                  name  TEXT    DEFAULT "Unknown",
+                                  name  TEXT    DEFAULT user,
                                   level INTEGER DEFAULT 0,
                                   xp    INTEGER DEFAULT 0
                               )`),xp_1.xp.database.exec(`CREATE TABLE IF NOT EXISTS "simply-xp-levelroles"
                               (
-                                  gid     TEXT UNIQUE,
-                                  lvlrole TEXT NOT NULL
-                              )`)}catch(o){if("object"==typeof o&&null!==o&&void 0!==(e=o).code&&"MODULE_NOT_FOUND"!==e.code)throw new xplogs_1.XpFatal({function:"connect()",message:e.message})}break;default:throw new xplogs_1.XpFatal({function:"connect()",message:"DATABASE TYPE NOT PROVIDED OR INVALID"})}return!!xp_1.xp.database&&(xplogs_1.XpLog.info("connect()","Connected to database!"),!0)}
+                                  gid     TEXT NOT NULL,
+                                  lvlrole TEXT NOT NULL,
+								  timestamp TEXT NOT NULL
+                              )`)}catch(t){if("object"==typeof t&&null!==t&&void 0!==(e=t).code&&"MODULE_NOT_FOUND"!==e.code)throw new xplogs_1.XpFatal({function:"connect()",message:e.message})}break;default:throw new xplogs_1.XpFatal({function:"connect()",message:"DATABASE TYPE NOT PROVIDED OR INVALID"})}return!!xp_1.xp.database&&(xplogs_1.XpLog.info("connect()","Connected to database!"),!0)}
 /**
  * Returns the package manager used
  * @private
  * @returns {Promise<"yarn" | "npm" | "pnpm">}
- */async function getPackageManager(){const e=(await Promise.resolve().then(()=>__importStar(require("fs")))).existsSync;var o=["yarn.lock","pnpm-lock.yaml","pnpm-lock.json","package-lock.json"].filter(lockfile=>e(lockfile));if(1===o.length){if("yarn.lock"===o[0])return xplogs_1.XpLog.debug("getPackageManager()","Using Yarn"),"yarn";if("pnpm-lock.yaml"===o[0]||"pnpm-lock.json"===o[0])return xplogs_1.XpLog.debug("getPackageManager()","Using PNPM"),"pnpm"}return xplogs_1.XpLog.debug("getPackageManager()","Using NPM"),"npm"}
+ */async function getPackageManager(){const e=(await Promise.resolve().then(()=>__importStar(require("fs")))).existsSync;var t=["yarn.lock","pnpm-lock.yaml","pnpm-lock.json","package-lock.json"].filter(lockfile=>e(lockfile));if(1===t.length){if("yarn.lock"===t[0])return xplogs_1.XpLog.debug("getPackageManager()","Using YARN"),"yarn";if("pnpm-lock.yaml"===t[0]||"pnpm-lock.json"===t[0])return xplogs_1.XpLog.debug("getPackageManager()","Using PNPM"),"pnpm"}return xplogs_1.XpLog.debug("getPackageManager()","Using NPM"),"npm"}
 /**
  * Check database package versions
  * @private
- * @param {"mongodb" | "sqlite"} type
+ * @param {string} type - NPM Package Name (lowercase)
+ * @param {number} min - Minimum Major Version Number
+ * @param {number} max - Maximum Major Version Number (Optional)
  * @returns {Promise<boolean>}
  * @throws {XpFatal} If the package version is not supported
- */async function checkPackageVersion(type){var e,o;switch(type){case"mongodb":try{return e=await Promise.resolve().then(()=>__importStar(require("mongodb/package.json"))),4<=parseInt(e.version.substring(0,1))}catch(e){return xplogs_1.XpLog.info("checkPackageVersion()","Installing MongoDB [5.x] | Please wait..."),(0,child_process_1.execSync)(await getPackageManager()+" add mongodb@5.x.x"),xplogs_1.XpLog.warn("checkPackageVersion()","Installed MongoDB. Please restart!"),process.exit(1)}case"sqlite":try{return o=await Promise.resolve().then(()=>__importStar(require("better-sqlite3/package.json"))),7<=parseInt(o.version.substring(0,1))}catch(e){return xplogs_1.XpLog.info("checkPackageVersion()","Installing better-sqlite3 [V8] | Please wait..."),(0,child_process_1.execSync)(await getPackageManager()+" add better-sqlite3@8.x.x"),xplogs_1.XpLog.warn("checkPackageVersion()","Installed better-sqlite3. Please restart!"),process.exit(1)}}}var __createBinding=this&&this.__createBinding||(Object.create?function(o,m,k,k2){void 0===k2&&(k2=k);var e=Object.getOwnPropertyDescriptor(m,k);e&&("get"in e?m.__esModule:!e.writable&&!e.configurable)||(e={enumerable:!0,get:function(){return m[k]}}),Object.defineProperty(o,k2,e)}:function(o,m,k,k2){o[k2=void 0===k2?k:k2]=m[k]}),__setModuleDefault=this&&this.__setModuleDefault||(Object.create?function(o,v){Object.defineProperty(o,"default",{enumerable:!0,value:v})}:function(o,v){o.default=v}),__importStar=this&&this.__importStar||function(mod){var e,o;if(mod&&mod.__esModule)return mod;if(e={},null!=mod)for(o in mod)"default"!==o&&Object.prototype.hasOwnProperty.call(mod,o)&&__createBinding(e,mod,o);return __setModuleDefault(e,mod),e};Object.defineProperty(exports,"__esModule",{value:!0}),exports.checkPackageVersion=exports.connect=void 0;const xplogs_1=require("./functions/xplogs"),child_process_1=require("child_process"),xp_1=require("../xp");exports.connect=connect,exports.checkPackageVersion=checkPackageVersion;
+ */async function checkPackageVersion(type,min,max){try{var e=await Promise.resolve(type+"/package.json").then(s=>__importStar(require(s)));return parseInt(e.version.substring(0,1))>=min&&(!max||parseInt(e.version.substring(0,1))<=max)}catch(e){return xplogs_1.XpLog.info("checkPackageVersion()",`Installing ${type} [V${max||min}] | Please wait...`),(0,child_process_1.execSync)(await getPackageManager()+` add ${type}@${max||min}.x.x`),xplogs_1.XpLog.warn("checkPackageVersion()",`Installed ${type}. Please restart!`),process.exit(1)}}var __createBinding=this&&this.__createBinding||(Object.create?function(o,m,k,k2){void 0===k2&&(k2=k);var e=Object.getOwnPropertyDescriptor(m,k);e&&("get"in e?m.__esModule:!e.writable&&!e.configurable)||(e={enumerable:!0,get:function(){return m[k]}}),Object.defineProperty(o,k2,e)}:function(o,m,k,k2){o[k2=void 0===k2?k:k2]=m[k]}),__setModuleDefault=this&&this.__setModuleDefault||(Object.create?function(o,v){Object.defineProperty(o,"default",{enumerable:!0,value:v})}:function(o,v){o.default=v}),__importStar=this&&this.__importStar||function(mod){var e,t;if(mod&&mod.__esModule)return mod;if(e={},null!=mod)for(t in mod)"default"!==t&&Object.prototype.hasOwnProperty.call(mod,t)&&__createBinding(e,mod,t);return __setModuleDefault(e,mod),e};Object.defineProperty(exports,"__esModule",{value:!0}),exports.checkPackageVersion=exports.connect=void 0;const xplogs_1=require("./functions/xplogs"),child_process_1=require("child_process"),xp_1=require("../xp");exports.connect=connect,exports.checkPackageVersion=checkPackageVersion;

package/lib/src/create.d.ts

@@ -5,7 +5,7 @@ import { UserResult } from "./functions/database";
  * @param {string} userId
  * @param {string} guildId
  * @param {string} username
- * @link `Documentation:` https://simplyxp.js.org/docs/create
+ * @link `Documentation:` https://simplyxp.js.org/docs/next/functions/create
  * @returns {Promise<UserResult>}
  * @throws {XpFatal} If invalid parameters are provided
  */

package/lib/src/create.js

@@ -5,7 +5,7 @@
  * @param {string} userId
  * @param {string} guildId
  * @param {string} username
- * @link `Documentation:` https://simplyxp.js.org/docs/create
+ * @link `Documentation:` https://simplyxp.js.org/docs/next/functions/create
  * @returns {Promise<UserResult>}
  * @throws {XpFatal} If invalid parameters are provided
  */async function create(userId,guildId,username){if(!userId)throw new xplogs_1.XpFatal({function:"create()",message:"User ID was not provided"});if(!guildId)throw new xplogs_1.XpFatal({function:"create()",message:"Guild ID was not provided"});var e;if(username)return await(e=(await Promise.resolve().then(()=>__importStar(require("./functions/database")))).db).findOne({collection:"simply-xps",data:{user:userId,guild:guildId}})||e.createOne({collection:"simply-xps",data:{name:username,user:userId,guild:guildId,level:0,xp:0}});throw new xplogs_1.XpFatal({function:"create()",message:"Username was not provided"})}var __createBinding=this&&this.__createBinding||(Object.create?function(o,m,k,k2){void 0===k2&&(k2=k);var e=Object.getOwnPropertyDescriptor(m,k);e&&("get"in e?m.__esModule:!e.writable&&!e.configurable)||(e={enumerable:!0,get:function(){return m[k]}}),Object.defineProperty(o,k2,e)}:function(o,m,k,k2){o[k2=void 0===k2?k:k2]=m[k]}),__setModuleDefault=this&&this.__setModuleDefault||(Object.create?function(o,v){Object.defineProperty(o,"default",{enumerable:!0,value:v})}:function(o,v){o.default=v}),__importStar=this&&this.__importStar||function(mod){var e,t;if(mod&&mod.__esModule)return mod;if(e={},null!=mod)for(t in mod)"default"!==t&&Object.prototype.hasOwnProperty.call(mod,t)&&__createBinding(e,mod,t);return __setModuleDefault(e,mod),e};Object.defineProperty(exports,"__esModule",{value:!0}),exports.create=void 0;const xplogs_1=require("./functions/xplogs");exports.create=create;

package/lib/src/deprecated/rank.d.ts

@@ -7,7 +7,7 @@ import { RankCardOptions } from "../cards";
  * @param {string} userId
  * @param {string} _guildId
  * @param {RankCardOptions?} options
- * @link `Documentation:` https://simplyxp.js.org/docs/deprecated/rank
+ * @link `Documentation:` https://simplyxp.js.org/docs/next/deprecated/rank
  * @returns {Promise<{attachment: Buffer, description: string, name: string}>}
  * @throws {XpFatal} - If parameters are not provided correctly
  */

package/lib/src/deprecated/rank.js

@@ -6,8 +6,7 @@
  * @param {string} userId
  * @param {string} _guildId
  * @param {RankCardOptions?} options
- * @link `Documentation:` https://simplyxp.js.org/docs/deprecated/rank
+ * @link `Documentation:` https://simplyxp.js.org/docs/next/deprecated/rank
  * @returns {Promise<{attachment: Buffer, description: string, name: string}>}
  * @throws {XpFatal} - If parameters are not provided correctly
- */
-async function rank(message,userId,_guildId,options){var e;try{e=await Promise.resolve().then(()=>__importStar(require("discord.js/package.json"))),parseInt(e.version.split(".")[0])<13?xplogs_1.XpLog.warn("rank()","This may not work with Discord.JS v12 or below."):xplogs_1.XpLog.debug("rank()",`Discord.JS v${e.version} detected.`)}catch(e){throw new xplogs_1.XpFatal({function:"rank()",message:"This function requires Discord.JS, as it is only for Discord bots. | Use rankCard() instead."})}if(!message||!message?.guild)throw new xplogs_1.XpFatal({function:"rank()",message:"Invalid Message Provided"});if(!userId)throw new xplogs_1.XpFatal({function:"rank()",message:"No User ID Provided"});if(xplogs_1.XpLog.warn("rank()","DEPRECATED FUNCTION!! Please use rankCard() instead."),e=await message.guild.members.fetch(userId).catch(()=>null))return(0,cards_1.rankCard)({id:message.guild.id,name:message.guild.name},{id:e.id,username:e.user.username,avatarURL:e.user.displayAvatarURL()},options);throw new xplogs_1.XpFatal({function:"rank()",message:"Member not found"})}var __createBinding=this&&this.__createBinding||(Object.create?function(o,m,k,k2){void 0===k2&&(k2=k);var e=Object.getOwnPropertyDescriptor(m,k);e&&("get"in e?m.__esModule:!e.writable&&!e.configurable)||(e={enumerable:!0,get:function(){return m[k]}}),Object.defineProperty(o,k2,e)}:function(o,m,k,k2){o[k2=void 0===k2?k:k2]=m[k]}),__setModuleDefault=this&&this.__setModuleDefault||(Object.create?function(o,v){Object.defineProperty(o,"default",{enumerable:!0,value:v})}:function(o,v){o.default=v}),__importStar=this&&this.__importStar||function(mod){var e,r;if(mod&&mod.__esModule)return mod;if(e={},null!=mod)for(r in mod)"default"!==r&&Object.prototype.hasOwnProperty.call(mod,r)&&__createBinding(e,mod,r);return __setModuleDefault(e,mod),e};Object.defineProperty(exports,"__esModule",{value:!0}),exports.rank=void 0;const xplogs_1=require("../functions/xplogs"),cards_1=require("../cards");exports.rank=rank;
+ */async function rank(message,userId,_guildId,options){var e;try{e=await Promise.resolve().then(()=>__importStar(require("discord.js/package.json"))),parseInt(e.version.split(".")[0])<13?xplogs_1.XpLog.warn("rank()","This may not work with Discord.JS v12 or below."):xplogs_1.XpLog.debug("rank()",`Discord.JS v${e.version} detected.`)}catch(e){throw new xplogs_1.XpFatal({function:"rank()",message:"This function requires Discord.JS, as it is only for Discord bots. | Use rankCard() instead."})}if(!message||!message?.guild)throw new xplogs_1.XpFatal({function:"rank()",message:"Invalid Message Provided"});if(!userId)throw new xplogs_1.XpFatal({function:"rank()",message:"No User ID Provided"});if(xplogs_1.XpLog.warn("rank()","DEPRECATED FUNCTION!! Please use rankCard() instead."),e=await message.guild.members.fetch(userId).catch(()=>null))return(0,cards_1.rankCard)({id:message.guild.id,name:message.guild.name},{id:e.id,username:e.user.username,avatarURL:e.user.displayAvatarURL()},options);throw new xplogs_1.XpFatal({function:"rank()",message:"Member not found"})}var __createBinding=this&&this.__createBinding||(Object.create?function(o,m,k,k2){void 0===k2&&(k2=k);var e=Object.getOwnPropertyDescriptor(m,k);e&&("get"in e?m.__esModule:!e.writable&&!e.configurable)||(e={enumerable:!0,get:function(){return m[k]}}),Object.defineProperty(o,k2,e)}:function(o,m,k,k2){o[k2=void 0===k2?k:k2]=m[k]}),__setModuleDefault=this&&this.__setModuleDefault||(Object.create?function(o,v){Object.defineProperty(o,"default",{enumerable:!0,value:v})}:function(o,v){o.default=v}),__importStar=this&&this.__importStar||function(mod){var e,r;if(mod&&mod.__esModule)return mod;if(e={},null!=mod)for(r in mod)"default"!==r&&Object.prototype.hasOwnProperty.call(mod,r)&&__createBinding(e,mod,r);return __setModuleDefault(e,mod),e};Object.defineProperty(exports,"__esModule",{value:!0}),exports.rank=void 0;const xplogs_1=require("../functions/xplogs"),cards_1=require("../cards");exports.rank=rank;

package/lib/src/fetch.d.ts

@@ -4,9 +4,9 @@ import { User } from "./leaderboard";
  * @async
  * @param {string} userId
  * @param {string} guildId
- * @param {string} username - Username to use if auto_create is enabled
- * @link `Documentation:` https://simplyxp.js.org/docs/fetch
+ * @param {string?} username - Username to use if auto_create is enabled
+ * @link `Documentation:` https://simplyxp.js.org/docs/next/functions/fetch
  * @returns {Promise<{name: string | null, user: string, guild: string, level: number, position: number, xp: number}>}
  * @throws {XpFatal} If invalid parameters are provided, or if the user data is not found.
  */
-export declare function fetch(userId: string, guildId: string, username: string): Promise<User>;
+export declare function fetch(userId: string, guildId: string, username?: string): Promise<User>;

package/lib/src/fetch.js

@@ -4,8 +4,8 @@
  * @async
  * @param {string} userId
  * @param {string} guildId
- * @param {string} username - Username to use if auto_create is enabled
- * @link `Documentation:` https://simplyxp.js.org/docs/fetch
+ * @param {string?} username - Username to use if auto_create is enabled
+ * @link `Documentation:` https://simplyxp.js.org/docs/next/functions/fetch
  * @returns {Promise<{name: string | null, user: string, guild: string, level: number, position: number, xp: number}>}
  * @throws {XpFatal} If invalid parameters are provided, or if the user data is not found.
  */async function fetch(userId,guildId,username){var e;if(!userId)throw new xplogs_1.XpFatal({function:"create()",message:"User ID was not provided"});if(!guildId)throw new xplogs_1.XpFatal({function:"create()",message:"Guild ID was not provided"});let t=(e=await(await Promise.resolve().then(()=>__importStar(require("./functions/database")))).db.find({collection:"simply-xps",data:{guild:guildId}})).find(u=>u.user===userId);if(!t){if(!xp_1.xp.auto_create||!username)throw new xplogs_1.XpFatal({function:"fetch()",message:"User data not found"});t=await(await Promise.resolve().then(()=>__importStar(require("./create")))).create(guildId,userId,username)}return guildId=e.sort((a,b)=>b.xp-a.xp).findIndex(u=>u.user===userId)+1,{name:t?.name,user:t.user,guild:t.guild,level:t.level,position:guildId,xp:t.xp}}var __createBinding=this&&this.__createBinding||(Object.create?function(o,m,k,k2){void 0===k2&&(k2=k);var e=Object.getOwnPropertyDescriptor(m,k);e&&("get"in e?m.__esModule:!e.writable&&!e.configurable)||(e={enumerable:!0,get:function(){return m[k]}}),Object.defineProperty(o,k2,e)}:function(o,m,k,k2){o[k2=void 0===k2?k:k2]=m[k]}),__setModuleDefault=this&&this.__setModuleDefault||(Object.create?function(o,v){Object.defineProperty(o,"default",{enumerable:!0,value:v})}:function(o,v){o.default=v}),__importStar=this&&this.__importStar||function(mod){var e,t;if(mod&&mod.__esModule)return mod;if(e={},null!=mod)for(t in mod)"default"!==t&&Object.prototype.hasOwnProperty.call(mod,t)&&__createBinding(e,mod,t);return __setModuleDefault(e,mod),e};Object.defineProperty(exports,"__esModule",{value:!0}),exports.fetch=void 0;const xplogs_1=require("./functions/xplogs"),xp_1=require("../xp");exports.fetch=fetch;