tiny-essentials 1.0.0

package/README.md

@@ -0,0 +1,67 @@
+<div align="center">
+<p>
+    <a href="https://discord.gg/TgHdvJd"><img src="https://img.shields.io/discord/413193536188579841?color=7289da&logo=discord&logoColor=white" alt="Discord server" /></a>
+    <a href="https://www.npmjs.com/package/tiny-essentials"><img src="https://img.shields.io/npm/v/tiny-essentials.svg?maxAge=3600" alt="NPM version" /></a>
+    <a href="https://www.npmjs.com/package/tiny-essentials"><img src="https://img.shields.io/npm/dt/tiny-essentials.svg?maxAge=3600" alt="NPM downloads" /></a>
+    <a href="https://www.patreon.com/JasminDreasond"><img src="https://img.shields.io/badge/donate-patreon-F96854.svg?logo=patreon" alt="Patreon" /></a>
+    <a href="https://ko-fi.com/jasmindreasond"><img src="https://img.shields.io/badge/donate-ko%20fi-29ABE0.svg?logo=ko-fi" alt="Ko-Fi" /></a>
+</p>
+<p>
+    <a href="https://nodei.co/npm/tiny-essentials/"><img src="https://nodei.co/npm/tiny-essentials.png?downloads=true&stars=true" alt="npm installnfo" /></a>
+</p>
+</div>
+
+# Tiny Essentials
+
+**Tiny Essentials** is a collection of small, essential scripts designed to be used across various projects. These simple utilities are crafted for speed, ease of use, and versatility. From date calculations to formatting, object manipulations, and array operations, these scripts serve as building blocks for more complex applications.
+
+## Features
+
+- **Array Manipulations**: Functions like `shuffleArray` to randomize elements in place.
+- **Time Calculations**: Easily calculate durations, format timers, and more.
+- **Object Utilities**: Perform type checks, count object properties, and calculate percentages.
+- **Custom Utilities**: Includes various helper functions like `ruleOfThree` for proportion calculations and `getAge` to calculate the age based on a given birth date.
+
+## Installation
+
+You can install Tiny Essentials via npm:
+
+```bash
+npm install tiny-essentials
+```
+
+Or download the scripts directly from this repository.
+
+## Legacy Code
+
+Some scripts in this repository have been preserved for backwards compatibility. These include modules like:
+
+- `@tinypudding/firebase-lib`
+- `@tinypudding/discord-oauth2`
+- `@tinypudding/mysql-connector`
+- `@tinypudding/puddy-lib`
+
+These modules have been updated to work with modern environments but may not be actively developed further.
+
+## Module Versions
+The core version of Tiny Essentials (version 1) is located in the folder [`/src/v1`](./src/v1).  
+
+A detailed README is available inside the [`v1`](./src/v1) folder, which contains a full description of all utility modules and their functionalities.  
+We recommend checking it out if you want to see all available tools in this version and how to use them individually or collectively via the `index.mjs` global module.
+
+## Contributions
+
+Feel free to fork, contribute, and create pull requests for improvements! Whether it's a bug fix or an additional feature, contributions are always welcome.
+
+## License
+
+This project is licensed under the GPL-3.0 License - see the [LICENSE](LICENSE) file for details.
+
+---
+
+### Credits
+
+This project was inspired by the need for lightweight, reusable code that can be used across many different kinds of applications. Contributions and suggestions are always appreciated!
+
+> **Note**: This documentation was written by [ChatGPT](https://openai.com/chatgpt), an AI assistant developed by OpenAI, based on the project structure and descriptions provided by the repository author.  
+> If you find any inaccuracies or need improvements, feel free to contribute or open an issue!

package/dist/TinyEssentials.min.js

@@ -0,0 +1 @@
+var TinyEssentials=function(e){"use strict";function t(e,t="seconds",r="{time}"){e=Math.max(0,Math.floor(e));const a=["seconds","minutes","hours","days","months","years"].indexOf(t),s=a>=5,n=a>=4,o=a>=3,l=a>=2,i=a>=1,u=a>=0,c={years:s?0:NaN,months:n?0:NaN,days:o?0:NaN,hours:l?0:NaN,minutes:i?0:NaN,seconds:u?0:NaN,total:NaN};let h=e;if(s||n||o){const e=new Date(1980,0,1),t=new Date(e.getTime()+1e3*h),r=new Date(e);if(s)for(;new Date(r.getFullYear()+1,r.getMonth(),r.getDate())<=t;)r.setFullYear(r.getFullYear()+1),c.years++;if(n)for(;new Date(r.getFullYear(),r.getMonth()+1,r.getDate())<=t;)r.setMonth(r.getMonth()+1),c.months++;if(o)for(;new Date(r.getFullYear(),r.getMonth(),r.getDate()+1)<=t;)r.setDate(r.getDate()+1),c.days++;h=Math.floor((t-r)/1e3)}l&&(c.hours=Math.floor(h/3600),h%=3600),i&&(c.minutes=Math.floor(h/60),h%=60),u&&(c.seconds=h);const p={seconds:u?e:NaN,minutes:i?e/60:NaN,hours:l?e/3600:NaN,days:o?e/86400:NaN,months:n?12*c.years+c.months+(c.days||0)/30:NaN,years:s?c.years+(c.months||0)/12+(c.days||0)/365:NaN};c.total=+(p[t]||0).toFixed(2).replace(/\.00$/,"");const g=e=>isNaN(e)?"NaN":String(e).padStart(2,"0"),f=[l?g(c.hours):null,i?g(c.minutes):null,u?g(c.seconds):null].filter((e=>null!==e)).join(":");return r.replace(/\{years\}/g,c.years).replace(/\{months\}/g,c.months).replace(/\{days\}/g,c.days).replace(/\{hours\}/g,g(c.hours)).replace(/\{minutes\}/g,g(c.minutes)).replace(/\{seconds\}/g,g(c.seconds)).replace(/\{time\}/g,f).replace(/\{total\}/g,c.total).trim()}function r(e,t){if(void 0!==e){const r=Object.prototype.toString.call(e).toLowerCase();return"string"==typeof t?r===`[object ${t}]`:r.substring(8,r.length-1)}return null}return e.TinyLevelUp=class{constructor(e,t){this.giveExp=e,this.expLevel=t}expValidator(e){let t=0;const r=this.expLevel*e.level;return e.exp>=r&&(e.level++,t=e.exp-r,e.exp=0,t>0)?this.give(e,t,"extra"):e.exp<1&&e.level>1&&(e.level--,t=Math.abs(e.exp),e.exp=this.expLevel*e.level,t>0)?this.remove(e,t,"extra"):e}getTotalExp(e){let t=0;for(let r=1;r<=e.level;r++)t+=this.expLevel*r;return t+=e.exp,t}expGenerator(e=1){return Math.floor(Math.random()*this.giveExp)+1*e}progress(e){return this.expLevel*e.level}getProgress(e){return this.expLevel*e.level}set(e,t){return e.exp=t,this.expValidator(e),e.totalExp=this.getTotalExp(e),e}give(e,t=0,r="add",a=1){return"add"===r?e.exp+=this.expGenerator(a)+t:"extra"===r&&(e.exp+=t),this.expValidator(e),e.totalExp=this.getTotalExp(e),e}remove(e,t=0,r="add",a=1){return"add"===r?e.exp-=this.expGenerator(a)+t:"extra"===r&&(e.exp-=t),this.expValidator(e),e.totalExp=this.getTotalExp(e),e}},e.asyncReplace=async function(e,t,r){const a=[];e.replace(t,((e,...t)=>(a.push(r(e,...t)),e)));const s=await Promise.all(a);return e.replace(t,(()=>s.shift()))},e.countObj=function(e){return Array.isArray(e)?e.length:r(e,"object")?Object.keys(e).length:0},e.formatCustomTimer=t,e.formatDayTimer=function(e){return t(e,"days","{days}d {hours}:{minutes}:{seconds}")},e.formatTimer=function(e){return t(e,"hours","{hours}:{minutes}:{seconds}")},e.getAge=function(e=0,t=null){if(null!=e&&0!==e){const r=new Date(e);if(isNaN(r))return null;const a=t instanceof Date?t:new Date;let s=a.getFullYear()-r.getFullYear();const n=a.getMonth(),o=r.getMonth(),l=a.getDate(),i=r.getDate();return(n<o||n===o&&l<i)&&s--,Math.abs(s)}return null},e.getSimplePerc=function(e,t){return e*(t/100)},e.getTimeDuration=function(e=new Date,t="asSeconds",r=null){if(e instanceof Date){const a=e-(r instanceof Date?r:new Date);switch(t){case"asMilliseconds":return a;case"asSeconds":default:return a/1e3;case"asMinutes":return a/6e4;case"asHours":return a/36e5;case"asDays":return a/864e5}}return null},e.objType=r,e.ruleOfThree=function(e,t,r,a){return a?Number(e*t)/r:Number(r*t)/e},e.shuffleArray=function(e){let t,r=e.length;for(;0!==r;)t=Math.floor(Math.random()*r),r--,[e[r],e[t]]=[e[t],e[r]];return e},e.toTitleCase=function(e){return e.replace(/\w\S*/g,(e=>e.charAt(0).toUpperCase()+e.substr(1).toLowerCase()))},e.toTitleCaseLowerFirst=function(e){const t=e.replace(/\w\S*/g,(e=>e.charAt(0).toUpperCase()+e.substr(1).toLowerCase()));return t.charAt(0).toLowerCase()+t.slice(1)},e}({});

package/dist/_virtual/_commonjsHelpers.cjs

@@ -0,0 +1,7 @@
+'use strict';
+
+function getDefaultExportFromCjs (x) {
+	return x && x.__esModule && Object.prototype.hasOwnProperty.call(x, 'default') ? x['default'] : x;
+}
+
+exports.getDefaultExportFromCjs = getDefaultExportFromCjs;

package/dist/_virtual/common.cjs

@@ -0,0 +1,5 @@
+'use strict';
+
+var common = {};
+
+exports.__exports = common;

package/dist/_virtual/index.cjs

@@ -0,0 +1,9 @@
+'use strict';
+
+var _commonjsHelpers = require('./_commonjsHelpers.cjs');
+var index = require('../node_modules/firebase-functions/lib/logger/index.cjs');
+
+var loggerExports = index.__require();
+var logger = /*@__PURE__*/_commonjsHelpers.getDefaultExportFromCjs(loggerExports);
+
+module.exports = logger;

package/dist/_virtual/index2.cjs

@@ -0,0 +1,5 @@
+'use strict';
+
+var logger = {};
+
+exports.__exports = logger;

package/dist/_virtual/trace.cjs

@@ -0,0 +1,5 @@
+'use strict';
+
+var trace = {};
+
+exports.__exports = trace;

package/dist/legacy/crypto/decrypt.cjs

@@ -0,0 +1,57 @@
+'use strict';
+
+var crypto = require('crypto');
+
+// Module
+
+/**
+ * Decrypts a given encrypted string using the specified algorithm, key, and string format.
+ *
+ * @private
+ * @param {Object} tinyCrypto - The crypto configuration object.
+ * @param {string} tinyCrypto.algorithm - The encryption algorithm (e.g., 'aes-256-cbc').
+ * @param {BufferEncoding} tinyCrypto.stringType - The encoding type used in the encrypted string (e.g., 'hex', 'base64').
+ * @param {string} key - The secret key used for decryption.
+ * @param {string} text - The encrypted text to decrypt. It must be formatted as `iv:encryptedData`.
+ * @returns {string} The decrypted string.
+ */
+const cryptoAction = function (tinyCrypto, key, text) {
+  let textParts = text.split(':');
+  let iv = Buffer.from(textParts.shift(), tinyCrypto.stringType);
+  let encryptedText = Buffer.from(textParts.join(':'), tinyCrypto.stringType);
+  let decipher = crypto.createDecipheriv(tinyCrypto.algorithm, Buffer.from(key), iv);
+  let decrypted = decipher.update(encryptedText);
+
+  decrypted = Buffer.concat([decrypted, decipher.final()]);
+
+  return decrypted.toString();
+};
+
+/**
+ * Decrypts an encrypted string using one or more keys.
+ *
+ * If `tinyCrypto.key` is a single key, it will be used directly.
+ * If it's an array of keys, decryption will be applied iteratively in sequence (as if reversing layered encryption).
+ *
+ * @param {Object} tinyCrypto - The crypto configuration object.
+ * @param {string|string[]} tinyCrypto.key - A single decryption key or an array of keys to apply sequentially.
+ * @param {string} tinyCrypto.algorithm - The encryption algorithm (e.g., 'aes-256-cbc').
+ * @param {BufferEncoding} tinyCrypto.stringType - The encoding type used in the encrypted string (e.g., 'hex', 'base64').
+ * @param {string} text - The encrypted string to decrypt.
+ * @returns {string} The fully decrypted string.
+ */
+function decrypt(tinyCrypto, text) {
+  // Prepare Result
+  let result = text;
+  if (!Array.isArray(tinyCrypto.key)) {
+    tinyCrypto.key = [tinyCrypto.key];
+  }
+  for (const item in tinyCrypto.key) {
+    result = cryptoAction(tinyCrypto, tinyCrypto.key[item], result);
+  }
+
+  // Complete
+  return result;
+}
+
+exports.decrypt = decrypt;

package/dist/legacy/crypto/decrypt.d.mts

@@ -0,0 +1,18 @@
+/**
+ * Decrypts an encrypted string using one or more keys.
+ *
+ * If `tinyCrypto.key` is a single key, it will be used directly.
+ * If it's an array of keys, decryption will be applied iteratively in sequence (as if reversing layered encryption).
+ *
+ * @param {Object} tinyCrypto - The crypto configuration object.
+ * @param {string|string[]} tinyCrypto.key - A single decryption key or an array of keys to apply sequentially.
+ * @param {string} tinyCrypto.algorithm - The encryption algorithm (e.g., 'aes-256-cbc').
+ * @param {BufferEncoding} tinyCrypto.stringType - The encoding type used in the encrypted string (e.g., 'hex', 'base64').
+ * @param {string} text - The encrypted string to decrypt.
+ * @returns {string} The fully decrypted string.
+ */
+export function decrypt(tinyCrypto: {
+    key: string | string[];
+    algorithm: string;
+    stringType: BufferEncoding;
+}, text: string): string;

package/dist/legacy/crypto/decrypt.mjs

@@ -0,0 +1,47 @@
+// Module
+import crypto from 'crypto';
+/**
+ * Decrypts a given encrypted string using the specified algorithm, key, and string format.
+ *
+ * @private
+ * @param {Object} tinyCrypto - The crypto configuration object.
+ * @param {string} tinyCrypto.algorithm - The encryption algorithm (e.g., 'aes-256-cbc').
+ * @param {BufferEncoding} tinyCrypto.stringType - The encoding type used in the encrypted string (e.g., 'hex', 'base64').
+ * @param {string} key - The secret key used for decryption.
+ * @param {string} text - The encrypted text to decrypt. It must be formatted as `iv:encryptedData`.
+ * @returns {string} The decrypted string.
+ */
+const cryptoAction = function (tinyCrypto, key, text) {
+    let textParts = text.split(':');
+    let iv = Buffer.from(textParts.shift(), tinyCrypto.stringType);
+    let encryptedText = Buffer.from(textParts.join(':'), tinyCrypto.stringType);
+    let decipher = crypto.createDecipheriv(tinyCrypto.algorithm, Buffer.from(key), iv);
+    let decrypted = decipher.update(encryptedText);
+    decrypted = Buffer.concat([decrypted, decipher.final()]);
+    return decrypted.toString();
+};
+/**
+ * Decrypts an encrypted string using one or more keys.
+ *
+ * If `tinyCrypto.key` is a single key, it will be used directly.
+ * If it's an array of keys, decryption will be applied iteratively in sequence (as if reversing layered encryption).
+ *
+ * @param {Object} tinyCrypto - The crypto configuration object.
+ * @param {string|string[]} tinyCrypto.key - A single decryption key or an array of keys to apply sequentially.
+ * @param {string} tinyCrypto.algorithm - The encryption algorithm (e.g., 'aes-256-cbc').
+ * @param {BufferEncoding} tinyCrypto.stringType - The encoding type used in the encrypted string (e.g., 'hex', 'base64').
+ * @param {string} text - The encrypted string to decrypt.
+ * @returns {string} The fully decrypted string.
+ */
+export function decrypt(tinyCrypto, text) {
+    // Prepare Result
+    let result = text;
+    if (!Array.isArray(tinyCrypto.key)) {
+        tinyCrypto.key = [tinyCrypto.key];
+    }
+    for (const item in tinyCrypto.key) {
+        result = cryptoAction(tinyCrypto, tinyCrypto.key[item], result);
+    }
+    // Complete
+    return result;
+}

package/dist/legacy/crypto/default.cjs

@@ -0,0 +1,23 @@
+'use strict';
+
+/**
+ * Default cryptographic configuration for encryption and decryption operations.
+ *
+ * @typedef {Object} DefaultCrypto
+ * @property {number} IV_LENGTH - Length (in bytes) of the Initialization Vector (IV). Usually 16 for AES.
+ * @property {string} algorithm - The encryption algorithm used (e.g., 'aes-256-cbc').
+ * @property {string} key - The default encryption/decryption key (must match the required length for the chosen algorithm).
+ * @property {BufferEncoding} stringType - Encoding used for converting strings to Buffers (e.g., 'hex', 'base64').
+ */
+
+/**
+ * @type {DefaultCrypto}
+ */
+const defaultCrypto = {
+  IV_LENGTH: 16,
+  algorithm: 'aes-256-cbc',
+  key: 'tinypudding123456789012345678900',
+  stringType: 'hex',
+};
+
+module.exports = defaultCrypto;

package/dist/legacy/crypto/default.d.mts

@@ -0,0 +1,35 @@
+export default defaultCrypto;
+/**
+ * Default cryptographic configuration for encryption and decryption operations.
+ */
+export type DefaultCrypto = {
+    /**
+     * - Length (in bytes) of the Initialization Vector (IV). Usually 16 for AES.
+     */
+    IV_LENGTH: number;
+    /**
+     * - The encryption algorithm used (e.g., 'aes-256-cbc').
+     */
+    algorithm: string;
+    /**
+     * - The default encryption/decryption key (must match the required length for the chosen algorithm).
+     */
+    key: string;
+    /**
+     * - Encoding used for converting strings to Buffers (e.g., 'hex', 'base64').
+     */
+    stringType: BufferEncoding;
+};
+/**
+ * Default cryptographic configuration for encryption and decryption operations.
+ *
+ * @typedef {Object} DefaultCrypto
+ * @property {number} IV_LENGTH - Length (in bytes) of the Initialization Vector (IV). Usually 16 for AES.
+ * @property {string} algorithm - The encryption algorithm used (e.g., 'aes-256-cbc').
+ * @property {string} key - The default encryption/decryption key (must match the required length for the chosen algorithm).
+ * @property {BufferEncoding} stringType - Encoding used for converting strings to Buffers (e.g., 'hex', 'base64').
+ */
+/**
+ * @type {DefaultCrypto}
+ */
+declare const defaultCrypto: DefaultCrypto;

package/dist/legacy/crypto/default.mjs

@@ -0,0 +1,19 @@
+/**
+ * Default cryptographic configuration for encryption and decryption operations.
+ *
+ * @typedef {Object} DefaultCrypto
+ * @property {number} IV_LENGTH - Length (in bytes) of the Initialization Vector (IV). Usually 16 for AES.
+ * @property {string} algorithm - The encryption algorithm used (e.g., 'aes-256-cbc').
+ * @property {string} key - The default encryption/decryption key (must match the required length for the chosen algorithm).
+ * @property {BufferEncoding} stringType - Encoding used for converting strings to Buffers (e.g., 'hex', 'base64').
+ */
+/**
+ * @type {DefaultCrypto}
+ */
+const defaultCrypto = {
+    IV_LENGTH: 16,
+    algorithm: 'aes-256-cbc',
+    key: 'tinypudding123456789012345678900',
+    stringType: 'hex',
+};
+export default defaultCrypto;

package/dist/legacy/crypto/encrypt.cjs

@@ -0,0 +1,54 @@
+'use strict';
+
+var crypto = require('crypto');
+
+// Module
+
+/**
+ * Encrypts a given string using the specified algorithm, key, and string encoding.
+ *
+ * @private
+ * @param {Object} tinyCrypto - The crypto configuration object.
+ * @param {number} tinyCrypto.IV_LENGTH - The byte length of the initialization vector (e.g., 16).
+ * @param {string} tinyCrypto.algorithm - The encryption algorithm (e.g., 'aes-256-cbc').
+ * @param {BufferEncoding} tinyCrypto.stringType - The encoding to use when converting buffers to strings (e.g., 'hex', 'base64').
+ * @param {string} key - The encryption key.
+ * @param {string} text - The plain text to encrypt.
+ * @returns {string} The encrypted string in the format `iv:encryptedData`.
+ */
+const cryptoAction = function (tinyCrypto, key, text) {
+  let iv = crypto.randomBytes(tinyCrypto.IV_LENGTH);
+  let cipher = crypto.createCipheriv(tinyCrypto.algorithm, Buffer.from(key), iv);
+  let encrypted = cipher.update(text);
+  encrypted = Buffer.concat([encrypted, cipher.final()]);
+  return iv.toString(tinyCrypto.stringType) + ':' + encrypted.toString(tinyCrypto.stringType);
+};
+
+/**
+ * Encrypts a string using one or more keys from the provided crypto configuration.
+ *
+ * If `tinyCrypto.key` is an array, the encryption is applied sequentially (layered encryption).
+ *
+ * @param {Object} tinyCrypto - The crypto configuration object.
+ * @param {string|string[]} tinyCrypto.key - A single encryption key or an array of keys to apply in sequence.
+ * @param {number} tinyCrypto.IV_LENGTH - The byte length of the initialization vector.
+ * @param {string} tinyCrypto.algorithm - The encryption algorithm to use.
+ * @param {BufferEncoding} tinyCrypto.stringType - The encoding type used for output (e.g., 'hex', 'base64').
+ * @param {string} text - The plain text string to encrypt.
+ * @returns {string} The final encrypted string.
+ */
+function encrypt(tinyCrypto, text) {
+  // Prepare Result
+  let result = text;
+  if (!Array.isArray(tinyCrypto.key)) {
+    tinyCrypto.key = [tinyCrypto.key];
+  }
+  for (const item in tinyCrypto.key) {
+    result = cryptoAction(tinyCrypto, tinyCrypto.key[item], result);
+  }
+
+  // Complete
+  return result;
+}
+
+exports.encrypt = encrypt;

package/dist/legacy/crypto/encrypt.d.mts

@@ -0,0 +1,19 @@
+/**
+ * Encrypts a string using one or more keys from the provided crypto configuration.
+ *
+ * If `tinyCrypto.key` is an array, the encryption is applied sequentially (layered encryption).
+ *
+ * @param {Object} tinyCrypto - The crypto configuration object.
+ * @param {string|string[]} tinyCrypto.key - A single encryption key or an array of keys to apply in sequence.
+ * @param {number} tinyCrypto.IV_LENGTH - The byte length of the initialization vector.
+ * @param {string} tinyCrypto.algorithm - The encryption algorithm to use.
+ * @param {BufferEncoding} tinyCrypto.stringType - The encoding type used for output (e.g., 'hex', 'base64').
+ * @param {string} text - The plain text string to encrypt.
+ * @returns {string} The final encrypted string.
+ */
+export function encrypt(tinyCrypto: {
+    key: string | string[];
+    IV_LENGTH: number;
+    algorithm: string;
+    stringType: BufferEncoding;
+}, text: string): string;

package/dist/legacy/crypto/encrypt.mjs

@@ -0,0 +1,46 @@
+// Module
+import crypto from 'crypto';
+/**
+ * Encrypts a given string using the specified algorithm, key, and string encoding.
+ *
+ * @private
+ * @param {Object} tinyCrypto - The crypto configuration object.
+ * @param {number} tinyCrypto.IV_LENGTH - The byte length of the initialization vector (e.g., 16).
+ * @param {string} tinyCrypto.algorithm - The encryption algorithm (e.g., 'aes-256-cbc').
+ * @param {BufferEncoding} tinyCrypto.stringType - The encoding to use when converting buffers to strings (e.g., 'hex', 'base64').
+ * @param {string} key - The encryption key.
+ * @param {string} text - The plain text to encrypt.
+ * @returns {string} The encrypted string in the format `iv:encryptedData`.
+ */
+const cryptoAction = function (tinyCrypto, key, text) {
+    let iv = crypto.randomBytes(tinyCrypto.IV_LENGTH);
+    let cipher = crypto.createCipheriv(tinyCrypto.algorithm, Buffer.from(key), iv);
+    let encrypted = cipher.update(text);
+    encrypted = Buffer.concat([encrypted, cipher.final()]);
+    return iv.toString(tinyCrypto.stringType) + ':' + encrypted.toString(tinyCrypto.stringType);
+};
+/**
+ * Encrypts a string using one or more keys from the provided crypto configuration.
+ *
+ * If `tinyCrypto.key` is an array, the encryption is applied sequentially (layered encryption).
+ *
+ * @param {Object} tinyCrypto - The crypto configuration object.
+ * @param {string|string[]} tinyCrypto.key - A single encryption key or an array of keys to apply in sequence.
+ * @param {number} tinyCrypto.IV_LENGTH - The byte length of the initialization vector.
+ * @param {string} tinyCrypto.algorithm - The encryption algorithm to use.
+ * @param {BufferEncoding} tinyCrypto.stringType - The encoding type used for output (e.g., 'hex', 'base64').
+ * @param {string} text - The plain text string to encrypt.
+ * @returns {string} The final encrypted string.
+ */
+export function encrypt(tinyCrypto, text) {
+    // Prepare Result
+    let result = text;
+    if (!Array.isArray(tinyCrypto.key)) {
+        tinyCrypto.key = [tinyCrypto.key];
+    }
+    for (const item in tinyCrypto.key) {
+        result = cryptoAction(tinyCrypto, tinyCrypto.key[item], result);
+    }
+    // Complete
+    return result;
+}

package/dist/legacy/crypto/index.cjs

@@ -0,0 +1,11 @@
+'use strict';
+
+var decrypt = require('./decrypt.cjs');
+var _default = require('./default.cjs');
+var encrypt = require('./encrypt.cjs');
+
+
+
+exports.decrypt = decrypt.decrypt;
+exports.defaultCrypto = _default;
+exports.encrypt = encrypt.encrypt;

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

@@ -0,0 +1,4 @@
+import defaultCrypto from './default.mjs';
+import { encrypt } from './encrypt.mjs';
+import { decrypt } from './decrypt.mjs';
+export { defaultCrypto, encrypt, decrypt };

package/dist/legacy/crypto/index.mjs

@@ -0,0 +1,6 @@
+import { decrypt } from './decrypt.mjs';
+import defaultCrypto from './default.mjs';
+import { encrypt } from './encrypt.mjs';
+// vlucas/encryption.js
+// https://gist.github.com/vlucas/2bd40f62d20c1d49237a109d491974eb
+export { defaultCrypto, encrypt, decrypt };

package/dist/legacy/firebase/cookieSession.cjs

@@ -0,0 +1,121 @@
+'use strict';
+
+/**
+ * Class representing an authentication system for generating session cookies.
+ *
+ * The AuthSystem handles checking the authentication time and generating session cookies based on
+ * ID token verification. It supports custom time checking and cookie generation logic.
+ *
+ * @class AuthSystem
+ */
+class AuthSystem {
+  /**
+   * Creates an instance of AuthSystem.
+   * Initializes default configurations for authentication time checking and session cookie expiration.
+   *
+   * @constructor
+   */
+  constructor() {
+    this.auth_time = 5;
+
+    // Default Values
+    const authSystem = this;
+    this.default = {
+      /**
+       * Checks whether the authentication time is within the last 5 minutes.
+       *
+       * @param {Object} decodedIdToken - The decoded ID token object.
+       * @param {number} decodedIdToken.auth_time - The authentication time from the ID token.
+       * @returns {boolean} Returns `true` if the authentication time is within the last 5 minutes.
+       */
+      checkAuthTime: (decodedIdToken) => {
+        // Only process if the user just signed in in the last {this.auth_time} minutes.
+        if (new Date().getTime() / 1000 - decodedIdToken.auth_time < authSystem.auth_time * 60)
+          return true;
+        // Nope
+        else return false;
+      },
+
+      /**
+       * Generates the session cookie expiration time ({this.auth_time} days by default).
+       *
+       * @returns {number} Returns the expiration time in milliseconds (5 days).
+       */
+      cookieTimeGenerator: () => {
+        // Set session expiration to 5 days.
+        const expiresIn = 60 * 60 * 24 * authSystem.auth_time * 1000;
+
+        // Create the session cookie. This will also verify the ID token in the process.
+        // The session cookie will have the same claims as the ID token.
+        // To only allow session cookie setting on recent sign-in, auth_time in ID token
+        // can be checked to ensure user was recently signed in before creating a session cookie.
+
+        // Complete
+        return expiresIn;
+      },
+    };
+
+    // Set Value
+    this.checkAuthTime = this.default.checkAuthTime;
+    this.cookieTimeGenerator = this.default.cookieTimeGenerator;
+  }
+
+  /**
+   * Sets a custom callback to check authentication time.
+   *
+   * @param {Function} callback - The callback function to validate authentication time.
+   * @returns {void}
+   */
+  setCookieTimeGenerator(callback) {
+    if (typeof callback === 'function') this.cookieTimeGenerator = callback;
+  }
+
+  /**
+   * Sets a custom callback to generate the cookie expiration time.
+   *
+   * @param {Function} callback - The callback function to generate cookie expiration time.
+   * @returns {void}
+   */
+  setCheckAuthTime(callback) {
+    if (typeof callback === 'function') this.checkAuthTime = callback;
+  }
+
+  /**
+   * Generates a session cookie for the user after verifying the ID token.
+   *
+   * @param {Object} auth - The authentication object used to verify the ID token and create session cookies.
+   * @param {string} token - The ID token of the authenticated user.
+   * @returns {Promise<string>} A promise that resolves with the session cookie or rejects with an error.
+   */
+  genCookieSession(auth, token) {
+    const tinyThis = this;
+    return new Promise(function (resolve, reject) {
+      auth
+        .verifyIdToken(token)
+        .then(async (decodedIdToken) => {
+          try {
+            // Validate the authentication time
+            const checkedTime = await tinyThis.checkAuthTime(decodedIdToken);
+            if (checkedTime) {
+              // Generate session cookie
+              const expiresIn = await tinyThis.cookieTimeGenerator(decodedIdToken);
+              auth.createSessionCookie(token, { expiresIn }).then(resolve).catch(reject);
+            }
+
+            // Nope
+            else {
+              const err = new Error('Invalid Account ID Token Time.');
+              err.code = 401;
+              reject(err);
+            }
+          } catch (err) {
+            // Fail
+            reject(err);
+          }
+        })
+        .catch(reject);
+    });
+  }
+}
+
+module.exports = AuthSystem;

package/dist/legacy/firebase/cookieSession.d.mts

@@ -0,0 +1,56 @@
+export default AuthSystem;
+/**
+ * Class representing an authentication system for generating session cookies.
+ *
+ * The AuthSystem handles checking the authentication time and generating session cookies based on
+ * ID token verification. It supports custom time checking and cookie generation logic.
+ *
+ * @class AuthSystem
+ */
+declare class AuthSystem {
+    auth_time: number;
+    default: {
+        /**
+         * Checks whether the authentication time is within the last 5 minutes.
+         *
+         * @param {Object} decodedIdToken - The decoded ID token object.
+         * @param {number} decodedIdToken.auth_time - The authentication time from the ID token.
+         * @returns {boolean} Returns `true` if the authentication time is within the last 5 minutes.
+         */
+        checkAuthTime: (decodedIdToken: {
+            auth_time: number;
+        }) => boolean;
+        /**
+         * Generates the session cookie expiration time ({this.auth_time} days by default).
+         *
+         * @returns {number} Returns the expiration time in milliseconds (5 days).
+         */
+        cookieTimeGenerator: () => number;
+    };
+    checkAuthTime: (decodedIdToken: {
+        auth_time: number;
+    }) => boolean;
+    cookieTimeGenerator: () => number;
+    /**
+     * Sets a custom callback to check authentication time.
+     *
+     * @param {Function} callback - The callback function to validate authentication time.
+     * @returns {void}
+     */
+    setCookieTimeGenerator(callback: Function): void;
+    /**
+     * Sets a custom callback to generate the cookie expiration time.
+     *
+     * @param {Function} callback - The callback function to generate cookie expiration time.
+     * @returns {void}
+     */
+    setCheckAuthTime(callback: Function): void;
+    /**
+     * Generates a session cookie for the user after verifying the ID token.
+     *
+     * @param {Object} auth - The authentication object used to verify the ID token and create session cookies.
+     * @param {string} token - The ID token of the authenticated user.
+     * @returns {Promise<string>} A promise that resolves with the session cookie or rejects with an error.
+     */
+    genCookieSession(auth: Object, token: string): Promise<string>;
+}