JaBa/helpers/functions.js

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<void>} callback - The async callback function to execute for each item in the collection.
	 * @returns {Promise<void>} 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 '<size>px <family>'.
	 */
	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;
	},
};