tiny-essentials 1.24.0 → 1.24.1

package/dist/legacy/crypto/decrypt.mjs

@@ -1,49 +0,0 @@
-// Module
-import { createDecipheriv } 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(':');
-    // @ts-ignore
-    let iv = Buffer.from(textParts.shift(), tinyCrypto.stringType);
-    let encryptedText = Buffer.from(textParts.join(':'), tinyCrypto.stringType);
-    let decipher = 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.
- * @deprecated
- */
-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

@@ -1,23 +0,0 @@
-'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

@@ -1,36 +0,0 @@
-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;
-//# sourceMappingURL=default.d.mts.map

package/dist/legacy/crypto/default.mjs

@@ -1,19 +0,0 @@
-/**
- * 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

@@ -1,55 +0,0 @@
-'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.
- * @deprecated
- */
-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

@@ -1,21 +0,0 @@
-/**
- * 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.
- * @deprecated
- */
-export function encrypt(tinyCrypto: {
-    key: string | string[];
-    IV_LENGTH: number;
-    algorithm: string;
-    stringType: BufferEncoding;
-}, text: string): string;
-//# sourceMappingURL=encrypt.d.mts.map

package/dist/legacy/crypto/encrypt.mjs

@@ -1,47 +0,0 @@
-// Module
-import { createCipheriv, randomBytes } 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 = randomBytes(tinyCrypto.IV_LENGTH);
-    let cipher = 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.
- * @deprecated
- */
-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

@@ -1,11 +0,0 @@
-'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

@@ -1,5 +0,0 @@
-import defaultCrypto from './default.mjs';
-import { encrypt } from './encrypt.mjs';
-import { decrypt } from './decrypt.mjs';
-export { defaultCrypto, encrypt, decrypt };
-//# sourceMappingURL=index.d.mts.map

package/dist/legacy/crypto/index.mjs

@@ -1,6 +0,0 @@
-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

@@ -1,123 +0,0 @@
-'use strict';
-
-// @ts-nocheck
-
-/**
- * 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 {Record<string, any>} 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

@@ -1,57 +0,0 @@
-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 {Record<string, any>} 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: Record<string, any>, token: string): Promise<string>;
-}
-//# sourceMappingURL=cookieSession.d.mts.map

package/dist/legacy/firebase/cookieSession.mjs

@@ -1,115 +0,0 @@
-// @ts-nocheck
-/**
- * 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 {Record<string, any>} 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
-export default AuthSystem;

package/dist/legacy/firebase/database/index.cjs

@@ -1,14 +0,0 @@
-'use strict';
-
-var presence = require('./presence.cjs');
-var saveAsync = require('./saveAsync.cjs');
-
-// @ts-nocheck
-
-
-const database = {
-  presence: presence,
-  SaveAsync: saveAsync,
-};
-
-module.exports = database;

package/dist/legacy/firebase/database/index.d.mts

@@ -1,8 +0,0 @@
-export default database;
-declare namespace database {
-    export { presenceSystem as presence };
-    export { SaveAsync };
-}
-import presenceSystem from './presence.mjs';
-import SaveAsync from './saveAsync.mjs';
-//# sourceMappingURL=index.d.mts.map

package/dist/legacy/firebase/database/index.mjs

@@ -1,8 +0,0 @@
-// @ts-nocheck
-import presenceSystem from './presence.mjs';
-import SaveAsync from './saveAsync.mjs';
-const database = {
-    presence: presenceSystem,
-    SaveAsync,
-};
-export default database;