const moment = require("moment"); module.exports = { /** * Asynchronously iterates over a collection and executes a callback function for each item. * * @param {any[]} collection - The collection to iterate over. * @param {(item: any) => Promise} callback - The async callback function to execute for each item in the collection. * @returns {Promise} A promise that resolves when all items in the collection have been processed. */ async asyncForEach(collection, callback) { const allPromises = collection.map(async key => { await callback(key); }); return await Promise.all(allPromises); }, /** * Sorts an array by the specified key in ascending order. * * @param {any[]} array - The array to sort. * @param {string} key - The key to sort the array by. * @returns {any[]} The sorted array. */ sortByKey(array, key) { return array.sort(function (a, b) { const x = a[key]; const y = b[key]; return x < y ? 1 : x > y ? -1 : 0; }); }, /** * Shuffles the elements of the provided array in-place. * * @param {any[]} pArray - The array to shuffle. * @returns {any[]} The shuffled array. */ shuffle(pArray) { const array = []; pArray.forEach(element => array.push(element)); let currentIndex = array.length, temporaryValue, randomIndex; while (currentIndex !== 0) { randomIndex = Math.floor(Math.random() * currentIndex); currentIndex -= 1; temporaryValue = array[currentIndex]; array[currentIndex] = array[randomIndex]; array[randomIndex] = temporaryValue; } return array; }, /** * Generates a random integer between the specified minimum and maximum values (inclusive). * * @param {number} [min=0] - The minimum value (inclusive). * @param {number} [max=100] - The maximum value (inclusive). * @returns {number} A random integer between min and max. */ randomNum(min = 0, max = 100) { min = Math.floor(min); max = Math.floor(max); return Math.floor(Math.random() * (max - min + 1) + min); }, /** * Formats a date for the specified client and locale. * * @param {Object} client - The client object containing language data. * @param {string} date - The date to format. * @param {string} [format=null] - The date format to use. If not provided, the default format for the client's language will be used. * @param {string} [locale=client.defaultLanguage.name] - The locale to use for formatting the date. * @returns {string} The formatted date. */ printDate(client, date, format = null, locale = client.defaultLanguage.name) { const languageData = client.languages.find(language => language.name === locale); if (format === "" || format === null) format = languageData.defaultMomentFormat; return moment(new Date(date)).locale(languageData.moment).format(format); }, /** * Formats a time value relative to the current time. * * @param {Object} client - The client object containing language data. * @param {string|number|Date} time - The time value to format. * @param {boolean} [type=false] - If true, formats the time as "X time ago", otherwise formats it as "in X time". * @param {boolean} [prefix=true] - If true, includes a prefix like "in" or "ago" in the formatted time. * @param {string} [locale=client.defaultLanguage.name] - The locale to use for formatting the time. * @returns {string} The formatted time value. */ convertTime(client, time, type = false, prefix = true, locale = client.defaultLanguage.name) { const languageData = client.languages.find(language => language.name === locale); const m = moment(time).locale(languageData.moment); return type ? m.toNow(!prefix) : m.fromNow(!prefix); }, /** * Generates the appropriate noun form based on the given number and noun forms. * * @param {number} number - The number to use for determining the noun form. * @param {string} one - The noun form for the singular case. * @param {string} two - The noun form for the dual case. * @param {string} five - The noun form for the plural case. * @returns {string} The appropriate noun form based on the given number. */ getNoun(number, one, two, five) { let n = Math.abs(number); n %= 100; if (n >= 5 && n <= 20) return five; n %= 10; if (n === 1) return one; if (n >= 2 && n <= 4) return two; return five; }, /** * Function to apply text on a canvas with dynamic font size based on the width constraint. * * @param {import("@napi-rs/canvas").Canvas} canvas - The canvas object where the text will be applied. * @param {string} text - The string of text that needs to be applied on the canvas. * @param {number} defaultFontSize - The initial font size for the text. It is expected to decrease with each iteration. * @param {number} width - The maximum width that the text can occupy before it has to shrink down. * @param {string} font - The name of the font used for drawing the text on the canvas. * * @return {string} - The final calculated font size in a format 'px '. */ applyText(canvas, text, defaultFontSize, width, font) { const ctx = canvas.getContext("2d"); do ctx.font = `${(defaultFontSize -= 1)}px ${font}`; while (ctx.measureText(text).width > width); return ctx.font; }, };