tiny-essentials 1.24.0 → 1.24.1

package/dist/legacy/libs/rule3.mjs

@@ -1,55 +0,0 @@
-/**
- * Rule of Three utility.
- * Performs direct or inverse proportional calculation.
- */
-const ruleOfThree = {
-    /**
-     * Returns the client-side version of the `execute` function as a string.
-     * Useful for embedding logic in the frontend.
-     *
-     * @returns {string} Function as string.
-     */
-    getClient: function () {
-        return ruleOfThree.execute.toString();
-    },
-    /**
-     * Executes a Rule of Three calculation.
-     *
-     * @param {number} val1 - The first reference value (numerator in direct proportion, denominator in inverse).
-     * @param {number} val2 - The second reference value (denominator in direct proportion, numerator in inverse).
-     * @param {number} val3 - The third value (numerator in direct proportion, denominator in inverse).
-     * @param {boolean} inverse - Whether the calculation should use inverse proportion (true for inverse, false for direct).
-     * @returns {number} The result of the Rule of Three operation.
-     * @deprecated
-     *
-     * Rule of Three Formula (Direct Proportion):
-     *      val1 / val2 = val3 / result
-     *
-     * For Inverse Proportion:
-     *      val1 / val3 = val2 / result
-     *
-     * Visual Representation:
-     *
-     * For Direct Proportion:
-     *      val1      val2
-     *      -----  =  ------
-     *      val3      result
-     *
-     * For Inverse Proportion:
-     *      val1      val2
-     *      -----  =  ------
-     *      val3      result
-     *
-     * @example
-     * // Direct proportion:
-     * ruleOfThree.execute(2, 6, 3, false); // → 9
-     *
-     * @example
-     * // Inverse proportion:
-     * ruleOfThree.execute(2, 6, 3, true); // → 4
-     */
-    execute: function (val1, val2, val3, inverse) {
-        return inverse ? Number(val1 * val2) / val3 : Number(val3 * val2) / val1;
-    },
-};
-export default ruleOfThree;

package/dist/legacy/momentjs/getAge.cjs

@@ -1,29 +0,0 @@
-'use strict';
-
-var moment = require('moment');
-
-/**
- * Calculates the age based on the given date.
- *
- * @param {number|string} timeData - The birth date in a format accepted by moment.js (e.g., Unix timestamp, ISO 8601 string, etc.).
- * @param {moment.Moment|null} [now=null] - The moment object representing the current date. Defaults to the current date and time if not provided.
- * @returns {number|null} The age in years, or null if `timeData` is not provided.
- * @deprecated
- */
-function getAge(timeData = 0, now = null) {
-  // Number
-  if (typeof timeData !== 'undefined') {
-    if (!now) now = moment();
-
-    const birthday = moment(timeData);
-    const age = Math.abs(birthday.diff(now, 'years'));
-    return age;
-  }
-
-  // Nope
-  else {
-    return null;
-  }
-}
-
-module.exports = getAge;

package/dist/legacy/momentjs/getAge.d.mts

@@ -1,11 +0,0 @@
-/**
- * Calculates the age based on the given date.
- *
- * @param {number|string} timeData - The birth date in a format accepted by moment.js (e.g., Unix timestamp, ISO 8601 string, etc.).
- * @param {moment.Moment|null} [now=null] - The moment object representing the current date. Defaults to the current date and time if not provided.
- * @returns {number|null} The age in years, or null if `timeData` is not provided.
- * @deprecated
- */
-export default function getAge(timeData?: number | string, now?: moment.Moment | null): number | null;
-import moment from 'moment';
-//# sourceMappingURL=getAge.d.mts.map

package/dist/legacy/momentjs/getAge.mjs

@@ -1,23 +0,0 @@
-import moment from 'moment';
-/**
- * Calculates the age based on the given date.
- *
- * @param {number|string} timeData - The birth date in a format accepted by moment.js (e.g., Unix timestamp, ISO 8601 string, etc.).
- * @param {moment.Moment|null} [now=null] - The moment object representing the current date. Defaults to the current date and time if not provided.
- * @returns {number|null} The age in years, or null if `timeData` is not provided.
- * @deprecated
- */
-export default function getAge(timeData = 0, now = null) {
-    // Number
-    if (typeof timeData !== 'undefined') {
-        if (!now)
-            now = moment();
-        const birthday = moment(timeData);
-        const age = Math.abs(birthday.diff(now, 'years'));
-        return age;
-    }
-    // Nope
-    else {
-        return null;
-    }
-}

package/dist/legacy/momentjs/index.cjs

@@ -1,9 +0,0 @@
-'use strict';
-
-var timeDuration = require('./timeDuration.cjs');
-var getAge = require('./getAge.cjs');
-
-
-
-exports.timeDuration = timeDuration;
-exports.getAge = getAge;

package/dist/legacy/momentjs/index.d.mts

@@ -1,4 +0,0 @@
-import timeDuration from './timeDuration.mjs';
-import getAge from './getAge.mjs';
-export { timeDuration, getAge };
-//# sourceMappingURL=index.d.mts.map

package/dist/legacy/momentjs/index.mjs

@@ -1,3 +0,0 @@
-import timeDuration from './timeDuration.mjs';
-import getAge from './getAge.mjs';
-export { timeDuration, getAge };

package/dist/legacy/momentjs/timeDuration.cjs

@@ -1,31 +0,0 @@
-'use strict';
-
-var moment = require('moment');
-
-/**
- * Calculates the time duration between the current time and a given time offset.
- *
- * @param {number} timeData - The time offset in milliseconds. Can be positive or negative.
- * @param {string} [durationType='asSeconds'] - The type of duration to return. Default is `'asSeconds'`. Can be any valid moment.js duration type (e.g., `'asMilliseconds'`, `'asMinutes'`, `'asHours'`, etc.).
- * @param {moment.Moment|null} [now=null] - The moment object representing the current date and time. Defaults to the current date and time if not provided.
- * @returns {number|null} The calculated duration in the specified unit (default: seconds), or `null` if `timeData` is not provided.
- * @deprecated
- */
-function timeDuration(timeData = 0, durationType = 'asSeconds', now = null) {
-  // Number
-  if (typeof timeData !== 'undefined') {
-    if (!now) now = moment();
-
-    var duration = moment.duration(now.clone().add(timeData, 'milliseconds').diff(now.clone()));
-    // @ts-ignore
-    const result = duration[durationType]();
-
-    // Complete
-    return result;
-  }
-
-  // Nope
-  else return null;
-}
-
-module.exports = timeDuration;

package/dist/legacy/momentjs/timeDuration.d.mts

@@ -1,12 +0,0 @@
-/**
- * Calculates the time duration between the current time and a given time offset.
- *
- * @param {number} timeData - The time offset in milliseconds. Can be positive or negative.
- * @param {string} [durationType='asSeconds'] - The type of duration to return. Default is `'asSeconds'`. Can be any valid moment.js duration type (e.g., `'asMilliseconds'`, `'asMinutes'`, `'asHours'`, etc.).
- * @param {moment.Moment|null} [now=null] - The moment object representing the current date and time. Defaults to the current date and time if not provided.
- * @returns {number|null} The calculated duration in the specified unit (default: seconds), or `null` if `timeData` is not provided.
- * @deprecated
- */
-export default function timeDuration(timeData?: number, durationType?: string, now?: moment.Moment | null): number | null;
-import moment from 'moment';
-//# sourceMappingURL=timeDuration.d.mts.map

package/dist/legacy/momentjs/timeDuration.mjs

@@ -1,25 +0,0 @@
-import moment from 'moment';
-/**
- * Calculates the time duration between the current time and a given time offset.
- *
- * @param {number} timeData - The time offset in milliseconds. Can be positive or negative.
- * @param {string} [durationType='asSeconds'] - The type of duration to return. Default is `'asSeconds'`. Can be any valid moment.js duration type (e.g., `'asMilliseconds'`, `'asMinutes'`, `'asHours'`, etc.).
- * @param {moment.Moment|null} [now=null] - The moment object representing the current date and time. Defaults to the current date and time if not provided.
- * @returns {number|null} The calculated duration in the specified unit (default: seconds), or `null` if `timeData` is not provided.
- * @deprecated
- */
-export default function timeDuration(timeData = 0, durationType = 'asSeconds', now = null) {
-    // Number
-    if (typeof timeData !== 'undefined') {
-        if (!now)
-            now = moment();
-        var duration = moment.duration(now.clone().add(timeData, 'milliseconds').diff(now.clone()));
-        // @ts-ignore
-        const result = duration[durationType]();
-        // Complete
-        return result;
-    }
-    // Nope
-    else
-        return null;
-}

package/dist/legacy/socket.io/antiFlood/index.cjs

@@ -1,9 +0,0 @@
-'use strict';
-
-var install = require('./install.cjs');
-var verify = require('./verify.cjs');
-
-
-
-exports.install = install;
-exports.verify = verify;

package/dist/legacy/socket.io/antiFlood/index.d.mts

@@ -1,4 +0,0 @@
-import verify from './verify.mjs';
-import install from './install.mjs';
-export { verify, install };
-//# sourceMappingURL=index.d.mts.map

package/dist/legacy/socket.io/antiFlood/index.mjs

@@ -1,3 +0,0 @@
-import install from './install.mjs';
-import verify from './verify.mjs';
-export { verify, install };

package/dist/legacy/socket.io/antiFlood/install.cjs

@@ -1,34 +0,0 @@
-'use strict';
-
-var userIP = require('../../http/userIP.cjs');
-
-/**
- * Installs the authorization middleware for socket connections.
- *
- * This middleware checks the user's IP address and allows or denies the socket connection based on whether
- * the IP is in the block list or not.
- *
- * @param {*} io - The Socket.IO server instance.
- * @param {Object} ioCache - The cache object containing blocked IPs.
- * @param {Array<*>} ioCache.blocklick - The list of blocked IP addresses.
- * @returns {void} This function does not return a value, it just sets the authorization logic for socket connections.
- * @deprecated
- */
-function install(io, ioCache) {
-  // @ts-ignore
-  io.set('authorization', function (socket, callback) {
-    // Get User IP
-    const ip = userIP(socket.handshake);
-
-    // Check if the IP is blocked
-    if (!Array.isArray(ioCache.blocklick) || ioCache.blocklick.indexOf(ip) < 0) {
-      // Allow the socket to connect
-      callback(null, true);
-    } else {
-      // Prevent the socket handshake with an error
-      callback('socket.io is not accepting connections from this page', false);
-    }
-  });
-}
-
-module.exports = install;

package/dist/legacy/socket.io/antiFlood/install.d.mts

@@ -1,16 +0,0 @@
-/**
- * Installs the authorization middleware for socket connections.
- *
- * This middleware checks the user's IP address and allows or denies the socket connection based on whether
- * the IP is in the block list or not.
- *
- * @param {*} io - The Socket.IO server instance.
- * @param {Object} ioCache - The cache object containing blocked IPs.
- * @param {Array<*>} ioCache.blocklick - The list of blocked IP addresses.
- * @returns {void} This function does not return a value, it just sets the authorization logic for socket connections.
- * @deprecated
- */
-export default function install(io: any, ioCache: {
-    blocklick: Array<any>;
-}): void;
-//# sourceMappingURL=install.d.mts.map

package/dist/legacy/socket.io/antiFlood/install.mjs

@@ -1,29 +0,0 @@
-import userIp from '../../http/userIP.mjs';
-/**
- * Installs the authorization middleware for socket connections.
- *
- * This middleware checks the user's IP address and allows or denies the socket connection based on whether
- * the IP is in the block list or not.
- *
- * @param {*} io - The Socket.IO server instance.
- * @param {Object} ioCache - The cache object containing blocked IPs.
- * @param {Array<*>} ioCache.blocklick - The list of blocked IP addresses.
- * @returns {void} This function does not return a value, it just sets the authorization logic for socket connections.
- * @deprecated
- */
-export default function install(io, ioCache) {
-    // @ts-ignore
-    io.set('authorization', function (socket, callback) {
-        // Get User IP
-        const ip = userIp(socket.handshake);
-        // Check if the IP is blocked
-        if (!Array.isArray(ioCache.blocklick) || ioCache.blocklick.indexOf(ip) < 0) {
-            // Allow the socket to connect
-            callback(null, true);
-        }
-        else {
-            // Prevent the socket handshake with an error
-            callback('socket.io is not accepting connections from this page', false);
-        }
-    });
-}

package/dist/legacy/socket.io/antiFlood/verify.cjs

@@ -1,95 +0,0 @@
-'use strict';
-
-var userIP = require('../../http/userIP.cjs');
-
-/** @typedef {Record<string, { timeout: number, tries: number }>} FloodTimeout */
-
-/**
- * Panel
- *
- * @type {FloodTimeout}
- */
-
-const floodPanel = {};
-
-/**
- * Periodically decrements the timeout for each IP in the flood panel and removes expired entries.
- * This is set to run every second.
- */
-setInterval(function () {
-  // IP Cache
-  for (const item in floodPanel) {
-    floodPanel[item].timeout--;
-    if (floodPanel[item].timeout < 0) delete floodPanel[item];
-  }
-}, 1000);
-
-/**
- * Verifies the IP address of a user socket for flooding attempts.
- *
- * This function checks how many times an IP has attempted to interact with the socket.
- * If the attempts exceed a threshold, the IP is temporarily banned and disconnected.
- *
- * @param {Record<string, any>} socket - The socket object representing the connection.
- * @param {Object} ioCache - The cache object that holds the blocklist and flood panel data.
- * @param {Array<*>} ioCache.blocklick - The list of blocked IPs.
- * @returns {void} This function does not return anything, it modifies the floodPanel and blocklist.
- * @deprecated
- */
-function verify(socket, ioCache) {
-  // Get User IP
-  const ipData = userIP(socket.handshake);
-  const ip = ipData.value ? ipData.value[0] : '';
-
-  /**
-   * Verifies the IP for flooding attempts and manages timeout and blocklist.
-   */
-  const verifyIP = function () {
-    // Create Item if it doesn't exist
-    if (!floodPanel[ip]) {
-      floodPanel[ip] = {
-        tries: 0,
-        timeout: 2,
-      };
-
-      // Remove Ban if any
-      const indexBan = ioCache.blocklick.indexOf(ip);
-      if (indexBan > -1) ioCache.blocklick.splice(indexBan, 1);
-    }
-
-    // Add Try for the current IP
-    floodPanel[ip].tries++;
-
-    // If tries exceed limit, block the IP
-    if (floodPanel[ip].tries > 1000) {
-      floodPanel[ip].timeout = 86400; // Set timeout to 24 hours
-      ioCache.blocklick.push(ip); // Add to blocklist
-
-      socket.disconnect(); // Disconnect the socket
-    }
-  };
-
-  // Create Blocklist if it doesn't exist
-  if (!Array.isArray(ioCache.blocklick)) {
-    ioCache.blocklick = [];
-  }
-
-  // Catch-all Event Listener
-  var onevent = socket.onevent;
-  socket.onevent = function (/** @type {{ data: string[]; }} */ packet) {
-    var args = packet.data || [];
-    onevent.call(this, packet); // original call
-    packet.data = ['*'].concat(args);
-    onevent.call(this, packet); // additional call to catch-all
-  };
-
-  // Verify Action on All Events
-  socket.on('*', function () {
-    return verifyIP();
-  });
-
-  // First Verify IP
-  return verifyIP();
-}
-
-module.exports = verify;

package/dist/legacy/socket.io/antiFlood/verify.d.mts

@@ -1,20 +0,0 @@
-/**
- * Verifies the IP address of a user socket for flooding attempts.
- *
- * This function checks how many times an IP has attempted to interact with the socket.
- * If the attempts exceed a threshold, the IP is temporarily banned and disconnected.
- *
- * @param {Record<string, any>} socket - The socket object representing the connection.
- * @param {Object} ioCache - The cache object that holds the blocklist and flood panel data.
- * @param {Array<*>} ioCache.blocklick - The list of blocked IPs.
- * @returns {void} This function does not return anything, it modifies the floodPanel and blocklist.
- * @deprecated
- */
-export default function verify(socket: Record<string, any>, ioCache: {
-    blocklick: Array<any>;
-}): void;
-export type FloodTimeout = Record<string, {
-    timeout: number;
-    tries: number;
-}>;
-//# sourceMappingURL=verify.d.mts.map

package/dist/legacy/socket.io/antiFlood/verify.mjs

@@ -1,79 +0,0 @@
-import userIp from '../../http/userIP.mjs';
-/** @typedef {Record<string, { timeout: number, tries: number }>} FloodTimeout */
-/**
- * Panel
- *
- * @type {FloodTimeout}
- */
-const floodPanel = {};
-/**
- * Periodically decrements the timeout for each IP in the flood panel and removes expired entries.
- * This is set to run every second.
- */
-setInterval(function () {
-    // IP Cache
-    for (const item in floodPanel) {
-        floodPanel[item].timeout--;
-        if (floodPanel[item].timeout < 0)
-            delete floodPanel[item];
-    }
-}, 1000);
-/**
- * Verifies the IP address of a user socket for flooding attempts.
- *
- * This function checks how many times an IP has attempted to interact with the socket.
- * If the attempts exceed a threshold, the IP is temporarily banned and disconnected.
- *
- * @param {Record<string, any>} socket - The socket object representing the connection.
- * @param {Object} ioCache - The cache object that holds the blocklist and flood panel data.
- * @param {Array<*>} ioCache.blocklick - The list of blocked IPs.
- * @returns {void} This function does not return anything, it modifies the floodPanel and blocklist.
- * @deprecated
- */
-export default function verify(socket, ioCache) {
-    // Get User IP
-    const ipData = userIp(socket.handshake);
-    const ip = ipData.value ? ipData.value[0] : '';
-    /**
-     * Verifies the IP for flooding attempts and manages timeout and blocklist.
-     */
-    const verifyIP = function () {
-        // Create Item if it doesn't exist
-        if (!floodPanel[ip]) {
-            floodPanel[ip] = {
-                tries: 0,
-                timeout: 2,
-            };
-            // Remove Ban if any
-            const indexBan = ioCache.blocklick.indexOf(ip);
-            if (indexBan > -1)
-                ioCache.blocklick.splice(indexBan, 1);
-        }
-        // Add Try for the current IP
-        floodPanel[ip].tries++;
-        // If tries exceed limit, block the IP
-        if (floodPanel[ip].tries > 1000) {
-            floodPanel[ip].timeout = 86400; // Set timeout to 24 hours
-            ioCache.blocklick.push(ip); // Add to blocklist
-            socket.disconnect(); // Disconnect the socket
-        }
-    };
-    // Create Blocklist if it doesn't exist
-    if (!Array.isArray(ioCache.blocklick)) {
-        ioCache.blocklick = [];
-    }
-    // Catch-all Event Listener
-    var onevent = socket.onevent;
-    socket.onevent = function (/** @type {{ data: string[]; }} */ packet) {
-        var args = packet.data || [];
-        onevent.call(this, packet); // original call
-        packet.data = ['*'].concat(args);
-        onevent.call(this, packet); // additional call to catch-all
-    };
-    // Verify Action on All Events
-    socket.on('*', function () {
-        return verifyIP();
-    });
-    // First Verify IP
-    return verifyIP();
-}

package/dist/legacy/socket.io/cookie-session.cjs

@@ -1,27 +0,0 @@
-'use strict';
-
-/**
- * Handles the cookie session for a socket connection by simulating an Express request and response.
- * This function uses the provided session module to manage session data for the socket connection.
- *
- * @param {Record<string, any>} socket - The socket object representing the connection.
- * @param {Function} sessionModule - The session module function, typically used with Express, that handles session logic.
- * @returns {Promise<Record<string, any>>} A promise that resolves with the session object once the session is processed.
- * @deprecated
- */
-function cookieSession(socket, sessionModule) {
-  return new Promise((resolve) => {
-    // Express Simulator
-    /** @type {Record<*,*>} */
-    let req = {
-      connection: { encrypted: false },
-      headers: { cookie: socket.request.headers.cookie },
-    };
-    let res = { getHeader: () => {}, setHeader: () => {} };
-
-    // Session
-    return sessionModule(req, res, async () => resolve(req.session));
-  });
-}
-
-module.exports = cookieSession;

package/dist/legacy/socket.io/cookie-session.d.mts

@@ -1,11 +0,0 @@
-/**
- * Handles the cookie session for a socket connection by simulating an Express request and response.
- * This function uses the provided session module to manage session data for the socket connection.
- *
- * @param {Record<string, any>} socket - The socket object representing the connection.
- * @param {Function} sessionModule - The session module function, typically used with Express, that handles session logic.
- * @returns {Promise<Record<string, any>>} A promise that resolves with the session object once the session is processed.
- * @deprecated
- */
-export default function cookieSession(socket: Record<string, any>, sessionModule: Function): Promise<Record<string, any>>;
-//# sourceMappingURL=cookie-session.d.mts.map

package/dist/legacy/socket.io/cookie-session.mjs

@@ -1,22 +0,0 @@
-/**
- * Handles the cookie session for a socket connection by simulating an Express request and response.
- * This function uses the provided session module to manage session data for the socket connection.
- *
- * @param {Record<string, any>} socket - The socket object representing the connection.
- * @param {Function} sessionModule - The session module function, typically used with Express, that handles session logic.
- * @returns {Promise<Record<string, any>>} A promise that resolves with the session object once the session is processed.
- * @deprecated
- */
-export default function cookieSession(socket, sessionModule) {
-    return new Promise((resolve) => {
-        // Express Simulator
-        /** @type {Record<*,*>} */
-        let req = {
-            connection: { encrypted: false },
-            headers: { cookie: socket.request.headers.cookie },
-        };
-        let res = { getHeader: () => { }, setHeader: () => { } };
-        // Session
-        return sessionModule(req, res, async () => resolve(req.session));
-    });
-}

package/dist/legacy/socket.io/discord.cjs

@@ -1,62 +0,0 @@
-'use strict';
-
-var getUser = require('../firebase/discord/api/getUser.cjs');
-
-/**
- * Handles the Discord OAuth2 authentication for a user, stores user data in an in-memory cache,
- * and manages the user's socket connection and disconnection events.
- *
- * @param {Record<string, any>} socket - The socket object representing the user's connection.
- * @param {Record<string, any>} ioCache - The shared cache that stores user data and connections.
- * @param {string} token - The OAuth2 token used to fetch user data from Discord.
- * @returns {Promise<Record<string, any>>} A promise that resolves with the user data and updates the cache.
- * @deprecated
- */
-function discord(socket, ioCache, token) {
-  return new Promise((resolve, reject) => {
-    // Get Discord oAuth
-    getUser(token)
-      .then((user) => {
-        // Create Users Cache
-        if (!ioCache.users) ioCache.users = {};
-        if (!ioCache.ids) ioCache.ids = {};
-        if (typeof ioCache.totalUsers !== 'number') ioCache.totalUsers = 0;
-
-        // User Data
-        if (!ioCache.users[user.id]) {
-          ioCache.users[user.id] = {
-            ids: {},
-          };
-
-          ioCache.ids[socket.id] = user.id;
-          ioCache.totalUsers++;
-        }
-
-        // Update Discord Data
-        ioCache.users[user.id].data = user;
-
-        // ID Data
-        ioCache.users[user.id].ids[socket.id] = { socket: socket };
-
-        // Disconnect
-        socket.on('disconnect', function () {
-          if (ioCache.users[user.id]) {
-            // IDs
-            delete ioCache.users[user.id].ids[socket.id];
-            delete ioCache.ids[socket.id];
-
-            if (Object.keys(ioCache.users[user.id].ids).length < 1) {
-              delete ioCache.users[user.id];
-              ioCache.totalUsers--;
-            }
-          }
-        });
-
-        // Complete
-        resolve(ioCache.users[user.id]);
-      })
-      .catch(reject);
-  });
-}
-
-module.exports = discord;

package/dist/legacy/socket.io/discord.d.mts

@@ -1,12 +0,0 @@
-/**
- * Handles the Discord OAuth2 authentication for a user, stores user data in an in-memory cache,
- * and manages the user's socket connection and disconnection events.
- *
- * @param {Record<string, any>} socket - The socket object representing the user's connection.
- * @param {Record<string, any>} ioCache - The shared cache that stores user data and connections.
- * @param {string} token - The OAuth2 token used to fetch user data from Discord.
- * @returns {Promise<Record<string, any>>} A promise that resolves with the user data and updates the cache.
- * @deprecated
- */
-export default function discord(socket: Record<string, any>, ioCache: Record<string, any>, token: string): Promise<Record<string, any>>;
-//# sourceMappingURL=discord.d.mts.map