tiny-essentials 1.24.0 → 1.24.1

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

@@ -1,29 +0,0 @@
-// @ts-nocheck
-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 {Record<string, any>} 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

@@ -1,26 +0,0 @@
-'use strict';
-
-// @ts-nocheck
-
-/**
- * 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

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

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

@@ -1,21 +0,0 @@
-// @ts-nocheck
-/**
- * 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

@@ -1,63 +0,0 @@
-'use strict';
-
-var objFilter = require('../../../../v1/basics/objFilter.cjs');
-
-// @ts-nocheck
-
-
-/**
- * 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 {Record<string, any>} 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 (objFilter.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

@@ -1,29 +0,0 @@
-/**
- * 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 {Record<string, any>} 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[]): Record<string, any>;
-//# sourceMappingURL=errorValidator.d.mts.map

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

@@ -1,56 +0,0 @@
-// @ts-nocheck
-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 {Record<string, any>} 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

@@ -1,20 +0,0 @@
-'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');
-
-// @ts-nocheck
-
-
-const getItems = {
-  cookieSession,
-  authURLGenerator,
-  credentials,
-  errorValidator,
-  randomAvatar,
-};
-
-module.exports = getItems;

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

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

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

@@ -1,14 +0,0 @@
-// @ts-nocheck
-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

@@ -1,40 +0,0 @@
-'use strict';
-
-var dice = require('../../../libs/dice.cjs');
-
-// @ts-nocheck
-
-
-/**
- * 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

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

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

@@ -1,31 +0,0 @@
-// @ts-nocheck
-import tinyDice from '../../../libs/dice.mjs';
-/**
- * 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 = null, url = 'https://cdn.discordapp.com/embed/avatars/') {
-    // Random
-    if (typeof value !== 'number' && typeof value !== 'string')
-        return url + tinyDice.vanilla(4) + '.png';
-    // Nope
-    else
-        return url + 'https://cdn.discordapp.com/embed/avatars/' + value + '.png';
-}

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

@@ -1,18 +0,0 @@
-'use strict';
-
-var login = require('./login.cjs');
-var logout = require('./logout.cjs');
-var redirect = require('./redirect.cjs');
-var refreshToken = require('./refreshToken.cjs');
-
-// @ts-nocheck
-
-
-const getItems = {
-  login,
-  logout,
-  redirect,
-  refreshToken,
-};
-
-module.exports = getItems;

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

@@ -1,12 +0,0 @@
-export default getItems;
-declare namespace getItems {
-    export { login };
-    export { logout };
-    export { redirect };
-    export { refreshToken };
-}
-import login from './login.mjs';
-import logout from './logout.mjs';
-import redirect from './redirect.mjs';
-import refreshToken from './refreshToken.mjs';
-//# sourceMappingURL=index.d.mts.map

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

@@ -1,12 +0,0 @@
-// @ts-nocheck
-import login from './login.mjs';
-import logout from './logout.mjs';
-import redirect from './redirect.mjs';
-import refreshToken from './refreshToken.mjs';
-const getItems = {
-    login,
-    logout,
-    redirect,
-    refreshToken,
-};
-export default getItems;

package/dist/legacy/firebase/discord/http/login.cjs

@@ -1,130 +0,0 @@
-'use strict';
-
-var _ = require('lodash');
-var objFilter = require('../../../../v1/basics/objFilter.cjs');
-var _default = require('../../../crypto/default.cjs');
-var HTTP1_0 = require('../../../http/HTTP-1.0.cjs');
-var getDomainURL = require('../../../http/getDomainURL.cjs');
-var authURLGenerator = require('../get/authURLGenerator.cjs');
-
-// @ts-nocheck
-
-
-/**
- * Handles the login process by checking the configuration, generating authentication URLs, and redirecting the user to the appropriate destination.
- * Depending on the configuration type, it handles various authentication methods like login, login_command, and webhook.
- *
- * @function
- * @param {Record<string, any>} req - The request object, typically provided by the web framework (e.g., Express).
- * @param {Record<string, any>} res - The response object, typically provided by the web framework (e.g., Express).
- * @param {Record<string, any>} cfg - The configuration object that includes various settings for the login process.
- * @param {boolean} existSession - A flag indicating whether the user already has an active session.
- *
- * @returns {void} This function does not return anything. It sends a redirect response to the user based on the configuration.
- *
- * @throws {Error} If any validation or configuration fails, an error response will be sent.
- *
- * @example
- * // Example usage with Express:
- * app.get('/login', (req, res) => {
- *   login(req, res, config, sessionExists);
- * });
- */
-function login(req, res, cfg, existSession) {
-  // Send Error
-  const sendError = function (data) {
-    if (typeof cfg.errorCallback !== 'function') return HTTP1_0.send(res, data.code);
-    else return cfg.errorCallback(data, req, res);
-  };
-
-  // Detect Config
-  if (
-    objFilter.objType(cfg, 'object') &&
-    typeof cfg.type === 'string' &&
-    (cfg.type === 'login' || cfg.type === 'login_command' || cfg.type === 'webhook')
-  ) {
-    // Create Settings
-    const tinyCrypto = _.defaultsDeep({}, cfg.crypto, _default);
-
-    // Detect Config
-    if (objFilter.objType(tinyCrypto, 'object')) {
-      // Create Settings
-      const tinyCfg = _.defaultsDeep({}, cfg.auth, {
-        redirect: 'http://localhost/redirect',
-        discordScope: [],
-        client_id: '',
-      });
-
-      // Validate Config
-      if (objFilter.objType(tinyCfg, 'object')) {
-        // Default Values State
-        let tinyState = _.defaultsDeep({}, cfg.state, {
-          csrfToken: '',
-          redirect: '',
-          type: cfg.type,
-        });
-
-        // Validate
-        if (typeof tinyState.type !== 'string') tinyState.type = cfg.type;
-
-        // Validate State
-        if (objFilter.objType(tinyState, 'object')) {
-          // Create Settings
-          const tinyQuery = _.defaultsDeep({}, cfg.query, {
-            redirect: 'redirect',
-          });
-
-          // Exist Cfg
-          if (objFilter.objType(tinyQuery, 'object')) {
-            // Get Domain
-            const tinyDomain = getDomainURL(req, cfg.port);
-
-            // Redirect
-            let returnRedirect = tinyDomain + '/';
-            if (objFilter.objType(req.query, 'object')) {
-              if (typeof req.query[tinyQuery.redirect] === 'string') {
-                req.query[tinyQuery.redirect] = req.query[tinyQuery.redirect].trim();
-                if (!req.query[tinyQuery.redirect].startsWith('http')) {
-                  if (req.query[tinyQuery.redirect].startsWith('/'))
-                    req.query[tinyQuery.redirect] = req.query[tinyQuery.redirect].substring(1);
-
-                  // Return Redirect
-                  tinyState.redirect = req.query[tinyQuery.redirect];
-                  returnRedirect = req.query[tinyQuery.redirect];
-
-                  // Fix Redirect
-                  returnRedirect = tinyDomain + '/' + returnRedirect;
-                } else tinyState.redirect = '';
-              } else {
-                tinyState.redirect = '';
-                delete req.query[tinyQuery.redirect];
-              }
-            } else tinyState.redirect = '';
-
-            // Don't exist session
-            if (!existSession || cfg.type === 'login_command' || cfg.type === 'webhook') {
-              // Redirect Result
-              const redirect_discord = authURLGenerator(tinyCfg, tinyState, tinyCrypto, cfg.type);
-              return res.redirect(redirect_discord);
-            }
-
-            // Yes
-            else return res.redirect(returnRedirect);
-          }
-          // Nope
-          else return sendError({ code: 400, message: 'Invalide Request!' });
-        }
-        // Error
-        else return sendError({ code: 400, message: 'Invalide State Config!' });
-      }
-      // Error
-      else return sendError({ code: 500, message: 'Invalide System Config!' });
-    }
-    // Nope
-    else return sendError({ code: 500, message: 'Invalid Crypto Values!' });
-  }
-  // Nope
-  else return sendError({ code: 500, message: 'Invalid Config Values!' });
-}
-
-module.exports = login;

package/dist/legacy/firebase/discord/http/login.d.mts

@@ -1,22 +0,0 @@
-/**
- * Handles the login process by checking the configuration, generating authentication URLs, and redirecting the user to the appropriate destination.
- * Depending on the configuration type, it handles various authentication methods like login, login_command, and webhook.
- *
- * @function
- * @param {Record<string, any>} req - The request object, typically provided by the web framework (e.g., Express).
- * @param {Record<string, any>} res - The response object, typically provided by the web framework (e.g., Express).
- * @param {Record<string, any>} cfg - The configuration object that includes various settings for the login process.
- * @param {boolean} existSession - A flag indicating whether the user already has an active session.
- *
- * @returns {void} This function does not return anything. It sends a redirect response to the user based on the configuration.
- *
- * @throws {Error} If any validation or configuration fails, an error response will be sent.
- *
- * @example
- * // Example usage with Express:
- * app.get('/login', (req, res) => {
- *   login(req, res, config, sessionExists);
- * });
- */
-export default function login(req: Record<string, any>, res: Record<string, any>, cfg: Record<string, any>, existSession: boolean): void;
-//# sourceMappingURL=login.d.mts.map