tiny-essentials 1.0.0

package/dist/legacy/firebase/discord/firebase_redirect/logout.mjs

@@ -0,0 +1,97 @@
+/**
+ * Handles the logout process by signing out from Firebase Auth,
+ * verifying CSRF token, and redirecting the user.
+ *
+ * The `run` function signs out the user, sends a logout request to the server
+ * along with CSRF protection, and then redirects the user to the specified URL
+ * or executes a custom callback.
+ *
+ * @namespace logout
+ */
+const logout = {
+    /**
+     * Executes the logout process, verifying CSRF token, signing out
+     * the user, and handling redirection.
+     *
+     * @param {string} token - The authentication token used to identify the user.
+     * @param {string} redirect_url - The relative URL to redirect the user after logout.
+     *                                If it starts with "/", it will be adjusted.
+     * @param {string} csrfToken - The CSRF token provided in the request.
+     * @param {string} original_csrfToken - The CSRF token that was initially generated.
+     * @param {function} [callback] - Optional callback to be called after logout.
+     *                                Signature: `(err, redirectFunction)`
+     *                                - If omitted, default redirection is used.
+     *
+     * @example
+     * logout.run(userToken, '/home', csrfToken, originalCsrfToken);
+     *
+     * @example
+     * logout.run(userToken, '/home', csrfToken, originalCsrfToken, (err, redirect) => {
+     *   if (err) {
+     *     console.error('Logout failed:', err);
+     *     return;
+     *   }
+     *   console.log('Logged out successfully');
+     *   redirect(); // manually trigger the redirect
+     * });
+     */
+    run: function (token, redirect_url, csrfToken, original_csrfToken, callback) {
+        // Compare CSRF Token
+        if (original_csrfToken.length < 1 || original_csrfToken === csrfToken) {
+            // Fix Redirect
+            if (typeof redirect_url === 'string') {
+                if (redirect_url.startsWith('/'))
+                    redirect_url = redirect_url.substring(1);
+            }
+            // Nope
+            else
+                redirect_url = '';
+            // Prepare Redirect
+            const final_redirect = function (err) {
+                // The Redirect
+                const start_redirect = function () {
+                    window.location.href = window.location.origin + '/' + redirect_url;
+                };
+                // Default Redirect
+                if (typeof callback !== 'function') {
+                    // Show Error
+                    if (err)
+                        alert(err.message);
+                    // Redirect Now
+                    start_redirect();
+                }
+                // Custom Redirect
+                else
+                    callback(err, start_redirect);
+            };
+            // Sign Out
+            firebase
+                .auth()
+                .signOut()
+                // Success
+                .then(() => {
+                fetch(window.location.pathname, {
+                    method: 'POST',
+                    headers: {
+                        Accept: 'application/json',
+                        'Content-Type': 'application/json',
+                    },
+                    body: JSON.stringify({ token: token, csrfToken: csrfToken }),
+                })
+                    .then((response) => {
+                    response
+                        .json()
+                        .then(() => final_redirect())
+                        .catch(final_redirect);
+                })
+                    .catch(final_redirect);
+            })
+                // Fail
+                .catch(final_redirect);
+        }
+        // Invalid
+        else
+            final_redirect(new Error('Invalid csrfToken!'));
+    },
+};
+export default logout;

package/dist/legacy/firebase/discord/get/authURLGenerator.cjs

@@ -0,0 +1,76 @@
+'use strict';
+
+var encrypt = require('../../../crypto/encrypt.cjs');
+var config = require('../config.cjs');
+
+/**
+ * Generates an authorization URL for either login or webhook requests,
+ * including scopes, state, and redirect URIs. This URL can be used in OAuth2
+ * authentication flows, such as logging in or connecting a webhook.
+ *
+ * @function
+ * @param {Object} tinyCfg - The configuration object containing the app's OAuth2 settings.
+ * @param {Object} jsonState - The state object to be encrypted and passed in the authorization URL.
+ * @param {Object} tinyCrypto - The crypto object used to encrypt the state.
+ * @param {string} type - The type of the request, which determines the URL generation process.
+ *                         Can be `'login'`, `'login_command'`, or `'webhook'`.
+ *
+ * @returns {string} The generated authorization URL for OAuth2 authorization.
+ *
+ * @example
+ * const authUrl = authURLGenerator(tinyCfg, jsonState, tinyCrypto, 'login');
+ * console.log(authUrl);
+ *
+ * @example
+ * const webhookAuthUrl = authURLGenerator(tinyCfg, jsonState, tinyCrypto, 'webhook');
+ * console.log(webhookAuthUrl);
+ */
+function authURLGenerator(tinyCfg, jsonState, tinyCrypto, type) {
+  // Scopes
+  let tinyScopeURI = '';
+
+  // Login
+  let needRedirect = false;
+  if (type === 'login' || type === 'login_command') {
+    // Normal Login
+    if (type === 'login') needRedirect = true;
+
+    // Read Scope
+    if (Array.isArray(tinyCfg.discordScope)) {
+      for (const item in tinyCfg.discordScope) {
+        if (tinyScopeURI) tinyScopeURI += '%20';
+        if (tinyCfg.discordScope[item] === 'applications.commands.update') needRedirect = true;
+        tinyScopeURI += encodeURIComponent(tinyCfg.discordScope[item]);
+      }
+    }
+  }
+
+  // Webhook
+  else if (type === 'webhook') {
+    needRedirect = true;
+    tinyScopeURI += 'webhook.incoming';
+  }
+
+  // Redirect Fixed
+  let tinyRedirect = '';
+  if (needRedirect && typeof tinyCfg.redirect === 'string')
+    tinyRedirect = '&redirect_uri=' + encodeURIComponent(tinyCfg.redirect);
+
+  // State
+  let tinyState = '';
+  let responseType = '';
+  if (needRedirect) {
+    // Crypto
+    tinyState = encrypt.encrypt(tinyCrypto, JSON.stringify(jsonState));
+    tinyState = '&state=' + encodeURIComponent(tinyState);
+    responseType = '&response_type=code';
+  }
+
+  // API URL
+  const apiURL = config.url;
+
+  // Redirect URL
+  return `${apiURL}oauth2/authorize?client_id=${encodeURIComponent(tinyCfg.client_id)}&scope=${tinyScopeURI}${responseType}${tinyRedirect}${tinyState}`;
+}
+
+module.exports = authURLGenerator;

package/dist/legacy/firebase/discord/get/authURLGenerator.d.mts

@@ -0,0 +1,23 @@
+/**
+ * Generates an authorization URL for either login or webhook requests,
+ * including scopes, state, and redirect URIs. This URL can be used in OAuth2
+ * authentication flows, such as logging in or connecting a webhook.
+ *
+ * @function
+ * @param {Object} tinyCfg - The configuration object containing the app's OAuth2 settings.
+ * @param {Object} jsonState - The state object to be encrypted and passed in the authorization URL.
+ * @param {Object} tinyCrypto - The crypto object used to encrypt the state.
+ * @param {string} type - The type of the request, which determines the URL generation process.
+ *                         Can be `'login'`, `'login_command'`, or `'webhook'`.
+ *
+ * @returns {string} The generated authorization URL for OAuth2 authorization.
+ *
+ * @example
+ * const authUrl = authURLGenerator(tinyCfg, jsonState, tinyCrypto, 'login');
+ * console.log(authUrl);
+ *
+ * @example
+ * const webhookAuthUrl = authURLGenerator(tinyCfg, jsonState, tinyCrypto, 'webhook');
+ * console.log(webhookAuthUrl);
+ */
+export default function authURLGenerator(tinyCfg: Object, jsonState: Object, tinyCrypto: Object, type: string): string;

package/dist/legacy/firebase/discord/get/authURLGenerator.mjs

@@ -0,0 +1,67 @@
+import { encrypt } from '../../../crypto/encrypt.mjs';
+import config from '../config.mjs';
+/**
+ * Generates an authorization URL for either login or webhook requests,
+ * including scopes, state, and redirect URIs. This URL can be used in OAuth2
+ * authentication flows, such as logging in or connecting a webhook.
+ *
+ * @function
+ * @param {Object} tinyCfg - The configuration object containing the app's OAuth2 settings.
+ * @param {Object} jsonState - The state object to be encrypted and passed in the authorization URL.
+ * @param {Object} tinyCrypto - The crypto object used to encrypt the state.
+ * @param {string} type - The type of the request, which determines the URL generation process.
+ *                         Can be `'login'`, `'login_command'`, or `'webhook'`.
+ *
+ * @returns {string} The generated authorization URL for OAuth2 authorization.
+ *
+ * @example
+ * const authUrl = authURLGenerator(tinyCfg, jsonState, tinyCrypto, 'login');
+ * console.log(authUrl);
+ *
+ * @example
+ * const webhookAuthUrl = authURLGenerator(tinyCfg, jsonState, tinyCrypto, 'webhook');
+ * console.log(webhookAuthUrl);
+ */
+export default function authURLGenerator(tinyCfg, jsonState, tinyCrypto, type) {
+    // Scopes
+    let tinyScopeURI = '';
+    // Login
+    let needRedirect = false;
+    if (type === 'login' || type === 'login_command') {
+        // Normal Login
+        if (type === 'login')
+            needRedirect = true;
+        // Read Scope
+        if (Array.isArray(tinyCfg.discordScope)) {
+            for (const item in tinyCfg.discordScope) {
+                if (tinyScopeURI)
+                    tinyScopeURI += '%20';
+                if (tinyCfg.discordScope[item] === 'applications.commands.update')
+                    needRedirect = true;
+                tinyScopeURI += encodeURIComponent(tinyCfg.discordScope[item]);
+            }
+        }
+    }
+    // Webhook
+    else if (type === 'webhook') {
+        needRedirect = true;
+        tinyScopeURI += 'webhook.incoming';
+    }
+    // Redirect Fixed
+    let tinyRedirect = '';
+    if (needRedirect && typeof tinyCfg.redirect === 'string')
+        tinyRedirect = '&redirect_uri=' + encodeURIComponent(tinyCfg.redirect);
+    // State
+    let tinyState = '';
+    let responseType = '';
+    if (needRedirect) {
+        // Crypto
+        tinyState = encrypt(tinyCrypto, JSON.stringify(jsonState));
+        tinyState = '&state=' + encodeURIComponent(tinyState);
+        responseType = '&response_type=code';
+    }
+    // API URL
+    const apiURL = config.url;
+    // Redirect URL
+    return `${apiURL}oauth2/authorize?client_id=${encodeURIComponent(tinyCfg.client_id)}&scope=${tinyScopeURI}${responseType}${tinyRedirect}${tinyState}`;
+}

package/dist/legacy/firebase/discord/get/cookie-session.cjs

@@ -0,0 +1,32 @@
+'use strict';
+
+var objType = require('../../../get/objType.cjs');
+
+/**
+ * Retrieves a session value from the request's session object based on the provided key.
+ * If the session object and the specific session key exist and are of the expected type,
+ * the value is returned. Otherwise, `null` is returned.
+ *
+ * @function
+ * @param {Object} req - The request object, which contains the session data.
+ * @param {string} where - The key for which the session value is being retrieved.
+ *
+ * @returns {string|null} The session value associated with the provided key, or `null` if it doesn't exist or isn't valid.
+ *
+ * @example
+ * const userToken = cookieSession(req, 'authToken');
+ * if (userToken) {
+ *   console.log('Session token:', userToken);
+ * } else {
+ *   console.log('No valid token in session');
+ * }
+ */
+function cookieSession(req, where) {
+  // Get Token
+  if (objType(req.session, 'object') && typeof req.session[where] === 'string')
+    return req.session[where];
+  // Nope
+  else return null;
+}
+
+module.exports = cookieSession;

package/dist/legacy/firebase/discord/get/cookie-session.d.mts

@@ -0,0 +1,20 @@
+/**
+ * Retrieves a session value from the request's session object based on the provided key.
+ * If the session object and the specific session key exist and are of the expected type,
+ * the value is returned. Otherwise, `null` is returned.
+ *
+ * @function
+ * @param {Object} req - The request object, which contains the session data.
+ * @param {string} where - The key for which the session value is being retrieved.
+ *
+ * @returns {string|null} The session value associated with the provided key, or `null` if it doesn't exist or isn't valid.
+ *
+ * @example
+ * const userToken = cookieSession(req, 'authToken');
+ * if (userToken) {
+ *   console.log('Session token:', userToken);
+ * } else {
+ *   console.log('No valid token in session');
+ * }
+ */
+export default function cookieSession(req: Object, where: string): string | null;

package/dist/legacy/firebase/discord/get/cookie-session.mjs

@@ -0,0 +1,28 @@
+import objType from '../../../get/objType.mjs';
+/**
+ * Retrieves a session value from the request's session object based on the provided key.
+ * If the session object and the specific session key exist and are of the expected type,
+ * the value is returned. Otherwise, `null` is returned.
+ *
+ * @function
+ * @param {Object} req - The request object, which contains the session data.
+ * @param {string} where - The key for which the session value is being retrieved.
+ *
+ * @returns {string|null} The session value associated with the provided key, or `null` if it doesn't exist or isn't valid.
+ *
+ * @example
+ * const userToken = cookieSession(req, 'authToken');
+ * if (userToken) {
+ *   console.log('Session token:', userToken);
+ * } else {
+ *   console.log('No valid token in session');
+ * }
+ */
+export default function cookieSession(req, where) {
+    // Get Token
+    if (objType(req.session, 'object') && typeof req.session[where] === 'string')
+        return req.session[where];
+    // Nope
+    else
+        return null;
+}

package/dist/legacy/firebase/discord/get/credentials.cjs

@@ -0,0 +1,24 @@
+'use strict';
+
+/**
+ * Generates a Base64-encoded string for HTTP Basic Authentication using the provided `client_id` and `client_secret`.
+ * The string is formatted as `client_id:client_secret`, then encoded in Base64 for use in Authorization headers.
+ *
+ * @function
+ * @param {Object} tinyAuth - The object containing authentication credentials.
+ * @param {string} tinyAuth.client_id - The client ID for the authentication process.
+ * @param {string} tinyAuth.client_secret - The client secret associated with the client ID.
+ *
+ * @returns {string} The Base64-encoded string in the format `client_id:client_secret`.
+ *
+ * @example
+ * const authHeader = credentials({ client_id: 'myClientId', client_secret: 'mySecret' });
+ * console.log(authHeader);  // Outputs: 'bXlDbGllZW50SWQ6bXlTZWNyZXQ='
+ */
+function credentials(tinyAuth) {
+  // Result
+  const result = Buffer.from(`${tinyAuth.client_id}:${tinyAuth.client_secret}`).toString('base64');
+  return result;
+}
+
+module.exports = credentials;

package/dist/legacy/firebase/discord/get/credentials.d.mts

@@ -0,0 +1,19 @@
+/**
+ * Generates a Base64-encoded string for HTTP Basic Authentication using the provided `client_id` and `client_secret`.
+ * The string is formatted as `client_id:client_secret`, then encoded in Base64 for use in Authorization headers.
+ *
+ * @function
+ * @param {Object} tinyAuth - The object containing authentication credentials.
+ * @param {string} tinyAuth.client_id - The client ID for the authentication process.
+ * @param {string} tinyAuth.client_secret - The client secret associated with the client ID.
+ *
+ * @returns {string} The Base64-encoded string in the format `client_id:client_secret`.
+ *
+ * @example
+ * const authHeader = credentials({ client_id: 'myClientId', client_secret: 'mySecret' });
+ * console.log(authHeader);  // Outputs: 'bXlDbGllZW50SWQ6bXlTZWNyZXQ='
+ */
+export default function credentials(tinyAuth: {
+    client_id: string;
+    client_secret: string;
+}): string;

package/dist/legacy/firebase/discord/get/credentials.mjs

@@ -0,0 +1,20 @@
+/**
+ * Generates a Base64-encoded string for HTTP Basic Authentication using the provided `client_id` and `client_secret`.
+ * The string is formatted as `client_id:client_secret`, then encoded in Base64 for use in Authorization headers.
+ *
+ * @function
+ * @param {Object} tinyAuth - The object containing authentication credentials.
+ * @param {string} tinyAuth.client_id - The client ID for the authentication process.
+ * @param {string} tinyAuth.client_secret - The client secret associated with the client ID.
+ *
+ * @returns {string} The Base64-encoded string in the format `client_id:client_secret`.
+ *
+ * @example
+ * const authHeader = credentials({ client_id: 'myClientId', client_secret: 'mySecret' });
+ * console.log(authHeader);  // Outputs: 'bXlDbGllZW50SWQ6bXlTZWNyZXQ='
+ */
+export default function credentials(tinyAuth) {
+    // Result
+    const result = Buffer.from(`${tinyAuth.client_id}:${tinyAuth.client_secret}`).toString('base64');
+    return result;
+}

package/dist/legacy/firebase/discord/get/errorValidator.cjs

@@ -0,0 +1,60 @@
+'use strict';
+
+var objType = require('../../../get/objType.cjs');
+
+/**
+ * Validates the provided data and returns an object with either the parsed data or an error message.
+ * The function checks if the data is an object, array, or an invalid response, and processes it accordingly.
+ * If the data contains a `401 Unauthorized` error, it is handled specifically.
+ *
+ * @function
+ * @param {Object|Array} data - The response data to validate. This can be either an object or an array.
+ *
+ * @returns {Object} The result object containing:
+ *   - `data` (Object|null): The validated data if no error occurred or null if an error was found.
+ *   - `error` (Object|null): The error object if there was an issue, or null if no error was found.
+ *
+ * @example
+ * const response = { error: 'invalid_request', error_description: 'Invalid request format' };
+ * const result = errorValidator(response);
+ * console.log(result); // { data: null, error: { code: 401, message: 'Invalid request format' } }
+ *
+ * @example
+ * const response = [{ id: 1, name: 'John' }];
+ * const result = errorValidator(response);
+ * console.log(result); // { data: [{ id: 1, name: 'John' }], error: null }
+ *
+ * @example
+ * const response = 'Invalid Response';
+ * const result = errorValidator(response);
+ * console.log(result); // { data: null, error: { code: 500, message: 'Invalid HTTP Result!' } }
+ */
+function errorValidator(data) {
+  // Result
+  const result = { data: null, error: null };
+
+  // Exist Object
+  if (objType(data, 'object')) {
+    // Success
+    if (typeof data.message !== 'string' || data.message !== '401: Unauthorized') {
+      // Success Complete
+      if (typeof data.error !== 'string' || typeof data.error_description !== 'string')
+        result.data = data;
+      // Nope
+      else result.error = { code: 401, message: data.error_description };
+    }
+
+    // Nope
+    else result.error = { code: 401, message: data.message };
+  }
+
+  // Exist Array
+  else if (Array.isArray(data)) result.data = data;
+  // Nope
+  else result.error = { code: 500, message: 'Invalid HTTP Result!' };
+
+  // Complete
+  return result;
+}
+
+module.exports = errorValidator;

package/dist/legacy/firebase/discord/get/errorValidator.d.mts

@@ -0,0 +1,28 @@
+/**
+ * Validates the provided data and returns an object with either the parsed data or an error message.
+ * The function checks if the data is an object, array, or an invalid response, and processes it accordingly.
+ * If the data contains a `401 Unauthorized` error, it is handled specifically.
+ *
+ * @function
+ * @param {Object|Array} data - The response data to validate. This can be either an object or an array.
+ *
+ * @returns {Object} The result object containing:
+ *   - `data` (Object|null): The validated data if no error occurred or null if an error was found.
+ *   - `error` (Object|null): The error object if there was an issue, or null if no error was found.
+ *
+ * @example
+ * const response = { error: 'invalid_request', error_description: 'Invalid request format' };
+ * const result = errorValidator(response);
+ * console.log(result); // { data: null, error: { code: 401, message: 'Invalid request format' } }
+ *
+ * @example
+ * const response = [{ id: 1, name: 'John' }];
+ * const result = errorValidator(response);
+ * console.log(result); // { data: [{ id: 1, name: 'John' }], error: null }
+ *
+ * @example
+ * const response = 'Invalid Response';
+ * const result = errorValidator(response);
+ * console.log(result); // { data: null, error: { code: 500, message: 'Invalid HTTP Result!' } }
+ */
+export default function errorValidator(data: Object | any[]): Object;

package/dist/legacy/firebase/discord/get/errorValidator.mjs

@@ -0,0 +1,55 @@
+import objType from '../../../get/objType.mjs';
+/**
+ * Validates the provided data and returns an object with either the parsed data or an error message.
+ * The function checks if the data is an object, array, or an invalid response, and processes it accordingly.
+ * If the data contains a `401 Unauthorized` error, it is handled specifically.
+ *
+ * @function
+ * @param {Object|Array} data - The response data to validate. This can be either an object or an array.
+ *
+ * @returns {Object} The result object containing:
+ *   - `data` (Object|null): The validated data if no error occurred or null if an error was found.
+ *   - `error` (Object|null): The error object if there was an issue, or null if no error was found.
+ *
+ * @example
+ * const response = { error: 'invalid_request', error_description: 'Invalid request format' };
+ * const result = errorValidator(response);
+ * console.log(result); // { data: null, error: { code: 401, message: 'Invalid request format' } }
+ *
+ * @example
+ * const response = [{ id: 1, name: 'John' }];
+ * const result = errorValidator(response);
+ * console.log(result); // { data: [{ id: 1, name: 'John' }], error: null }
+ *
+ * @example
+ * const response = 'Invalid Response';
+ * const result = errorValidator(response);
+ * console.log(result); // { data: null, error: { code: 500, message: 'Invalid HTTP Result!' } }
+ */
+export default function errorValidator(data) {
+    // Result
+    const result = { data: null, error: null };
+    // Exist Object
+    if (objType(data, 'object')) {
+        // Success
+        if (typeof data.message !== 'string' || data.message !== '401: Unauthorized') {
+            // Success Complete
+            if (typeof data.error !== 'string' || typeof data.error_description !== 'string')
+                result.data = data;
+            // Nope
+            else
+                result.error = { code: 401, message: data.error_description };
+        }
+        // Nope
+        else
+            result.error = { code: 401, message: data.message };
+    }
+    // Exist Array
+    else if (Array.isArray(data))
+        result.data = data;
+    // Nope
+    else
+        result.error = { code: 500, message: 'Invalid HTTP Result!' };
+    // Complete
+    return result;
+}

package/dist/legacy/firebase/discord/get/index.cjs

@@ -0,0 +1,17 @@
+'use strict';
+
+var authURLGenerator = require('./authURLGenerator.cjs');
+var cookieSession = require('./cookie-session.cjs');
+var credentials = require('./credentials.cjs');
+var errorValidator = require('./errorValidator.cjs');
+var randomAvatar = require('./randomAvatar.cjs');
+
+const getItems = {
+  cookieSession,
+  authURLGenerator,
+  credentials,
+  errorValidator,
+  randomAvatar,
+};
+
+module.exports = getItems;

package/dist/legacy/firebase/discord/get/index.d.mts

@@ -0,0 +1,13 @@
+export default getItems;
+declare namespace getItems {
+    export { cookieSession };
+    export { authURLGenerator };
+    export { credentials };
+    export { errorValidator };
+    export { randomAvatar };
+}
+import cookieSession from './cookie-session.mjs';
+import authURLGenerator from './authURLGenerator.mjs';
+import credentials from './credentials.mjs';
+import errorValidator from './errorValidator.mjs';
+import randomAvatar from './randomAvatar.mjs';

package/dist/legacy/firebase/discord/get/index.mjs

@@ -0,0 +1,13 @@
+import authURLGenerator from './authURLGenerator.mjs';
+import cookieSession from './cookie-session.mjs';
+import credentials from './credentials.mjs';
+import errorValidator from './errorValidator.mjs';
+import randomAvatar from './randomAvatar.mjs';
+const getItems = {
+    cookieSession,
+    authURLGenerator,
+    credentials,
+    errorValidator,
+    randomAvatar,
+};
+export default getItems;

package/dist/legacy/firebase/discord/get/randomAvatar.cjs

@@ -0,0 +1,37 @@
+'use strict';
+
+var dice = require('../../../libs/dice.cjs');
+
+/**
+ * Generates a random Discord avatar URL or returns a specified avatar URL based on the provided value.
+ * If no value is provided, a random avatar from the Discord CDN is selected.
+ *
+ * @function
+ * @param {string|number|null} [value=null] - The avatar number or string. If provided, it will return the avatar associated with that number or string.
+ * If no value is provided or the value is invalid, a random avatar will be generated.
+ * @param {string} [url='https://cdn.discordapp.com/embed/avatars/'] - The base URL for the Discord avatars. By default, it uses the CDN URL.
+ *
+ * @returns {string} The URL of the avatar image.
+ *
+ * @example
+ * // Returns a random avatar URL
+ * const avatarURL = randomAvatar();
+ * console.log(avatarURL); // Example output: https://cdn.discordapp.com/embed/avatars/1234.png
+ *
+ * @example
+ * // Returns a specific avatar URL based on the value
+ * const avatarURL = randomAvatar(2);
+ * console.log(avatarURL); // Example output: https://cdn.discordapp.com/embed/avatars/2.png
+ */
+function randomAvatar(
+  value = null,
+  url = 'https://cdn.discordapp.com/embed/avatars/',
+) {
+  // Random
+  if (typeof value !== 'number' && typeof value !== 'string')
+    return url + dice.vanilla(4) + '.png';
+  // Nope
+  else return url + 'https://cdn.discordapp.com/embed/avatars/' + value + '.png';
+}
+
+module.exports = randomAvatar;

package/dist/legacy/firebase/discord/get/randomAvatar.d.mts

@@ -0,0 +1,22 @@
+/**
+ * Generates a random Discord avatar URL or returns a specified avatar URL based on the provided value.
+ * If no value is provided, a random avatar from the Discord CDN is selected.
+ *
+ * @function
+ * @param {string|number|null} [value=null] - The avatar number or string. If provided, it will return the avatar associated with that number or string.
+ * If no value is provided or the value is invalid, a random avatar will be generated.
+ * @param {string} [url='https://cdn.discordapp.com/embed/avatars/'] - The base URL for the Discord avatars. By default, it uses the CDN URL.
+ *
+ * @returns {string} The URL of the avatar image.
+ *
+ * @example
+ * // Returns a random avatar URL
+ * const avatarURL = randomAvatar();
+ * console.log(avatarURL); // Example output: https://cdn.discordapp.com/embed/avatars/1234.png
+ *
+ * @example
+ * // Returns a specific avatar URL based on the value
+ * const avatarURL = randomAvatar(2);
+ * console.log(avatarURL); // Example output: https://cdn.discordapp.com/embed/avatars/2.png
+ */
+export default function randomAvatar(value?: string | number | null, url?: string): string;