tiny-essentials 1.24.0 → 1.24.2

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

@@ -1,124 +0,0 @@
-// @ts-nocheck
-import _ from 'lodash';
-import objType from '../../../get/objType.mjs';
-import defaultCrypto from '../../../crypto/default.mjs';
-import http_status from '../../../http/HTTP-1.0.mjs';
-import getDomainURL from '../../../http/getDomainURL.mjs';
-import authURLGenerator from '../get/authURLGenerator.mjs';
-/**
- * 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, res, cfg, existSession) {
-    // Send Error
-    const sendError = function (data) {
-        if (typeof cfg.errorCallback !== 'function')
-            return http_status.send(res, data.code);
-        else
-            return cfg.errorCallback(data, req, res);
-    };
-    // Detect Config
-    if (objType(cfg, 'object') &&
-        typeof cfg.type === 'string' &&
-        (cfg.type === 'login' || cfg.type === 'login_command' || cfg.type === 'webhook')) {
-        // Create Settings
-        const tinyCrypto = _.defaultsDeep({}, cfg.crypto, defaultCrypto);
-        // Detect Config
-        if (objType(tinyCrypto, 'object')) {
-            // Create Settings
-            const tinyCfg = _.defaultsDeep({}, cfg.auth, {
-                redirect: 'http://localhost/redirect',
-                discordScope: [],
-                client_id: '',
-            });
-            // Validate Config
-            if (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 (objType(tinyState, 'object')) {
-                    // Create Settings
-                    const tinyQuery = _.defaultsDeep({}, cfg.query, {
-                        redirect: 'redirect',
-                    });
-                    // Exist Cfg
-                    if (objType(tinyQuery, 'object')) {
-                        // Get Domain
-                        const tinyDomain = getDomainURL(req, cfg.port);
-                        // Redirect
-                        let returnRedirect = tinyDomain + '/';
-                        if (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!' });
-}

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

@@ -1,158 +0,0 @@
-'use strict';
-
-var _ = require('lodash');
-var objFilter = require('../../../../v1/basics/objFilter.cjs');
-var revokeToken = require('../api/revokeToken.cjs');
-var getUser = require('../api/getUser.cjs');
-
-// @ts-nocheck
-
-
-/**
- * Handles the logout process for the user by revoking the token and redirecting.
- *
- * @param {Record<string, any>} req - The HTTP request object.
- * @param {string|number} access_token - The access token of the user to be revoked.
- * @param {Record<string, any>} cfg - Configuration object containing settings for the logout process.
- * @param {boolean} existSession - A flag indicating whether a session exists.
- *
- * @returns {Promise<Record<string, any>>} Resolves with a result object or rejects with an error.
- *
- * @throws {Record<string, any>} Rejects with an error if configuration or token values are invalid.
- *
- * @example
- * logout(req, 'userAccessToken', cfg, true)
- *   .then(result => {
- *     // Handle successful logout
- *   })
- *   .catch(err => {
- *     // Handle error during logout
- *   });
- */
-async function logout(req, access_token, cfg, existSession) {
-  return new Promise(function (resolve, reject) {
-    // Detect Config
-    if (objFilter.objType(cfg, 'object')) {
-      // Create Settings
-      const tinyQuery = _.defaultsDeep({}, cfg.query, {
-        csrfToken: 'csrfToken',
-        redirect: 'redirect',
-      });
-
-      const tinyState = _.defaultsDeep({}, cfg.state, {
-        csrfToken: '',
-        redirect: '',
-      });
-
-      // Exist Query Setting
-      if (objFilter.objType(tinyQuery, 'object')) {
-        // Exist Query
-        if (
-          typeof tinyState.csrfToken !== 'string' ||
-          tinyState.csrfToken.length < 1 ||
-          (objFilter.objType(req.query, 'object') &&
-            typeof cfg.csrfToken === 'string' &&
-            tinyState.csrfToken === cfg.csrfToken)
-        ) {
-          // Result
-          const result = {
-            data: null,
-            existSession: existSession,
-            complete: false,
-            state: { csrfToken: cfg.csrfToken },
-          };
-
-          // Prepare Final Redirect
-          result.redirect = '/';
-
-          // Redirect
-          if (typeof tinyState.redirect === 'string' && tinyState.redirect.length > 0) {
-            if (tinyState.redirect.startsWith('/'))
-              result.redirect = tinyState.redirect.substring(1);
-            else result.redirect = tinyState.redirect;
-          }
-
-          // Get Query
-          else if (typeof req.query[tinyQuery.redirect] === 'string') {
-            if (req.query[tinyQuery.redirect].startsWith('/'))
-              result.redirect = req.query[tinyQuery.redirect].substring(1);
-            else result.redirect = req.query[tinyQuery.redirect];
-          }
-
-          // Exist Session
-          if (existSession) {
-            // Exist Token
-            if (
-              (typeof access_token === 'string' && access_token.length > 0) ||
-              (typeof access_token === 'number' && !isNaN(access_token))
-            ) {
-              // Prepare Auth
-              const tinyAuth = _.defaultsDeep({}, cfg.auth, {
-                client_id: '',
-                client_secret: '',
-                redirect_uri: '',
-              });
-
-              // Exist Client ID
-              if (
-                (typeof tinyAuth.client_id === 'string' && tinyAuth.client_id.length > 0) ||
-                (typeof tinyAuth.client_id === 'number' && !isNaN(tinyAuth.client_id))
-              ) {
-                // Exist Client Secret
-                if (
-                  (typeof tinyAuth.client_secret === 'string' &&
-                    tinyAuth.client_secret.length > 0) ||
-                  (typeof tinyAuth.client_secret === 'number' && !isNaN(tinyAuth.client_secret))
-                ) {
-                  // End Discord
-                  const end_discord_session = function () {
-                    // Get API HTTP and Revoke the Token
-                    revokeToken(access_token, tinyAuth)
-                      .then((data) => {
-                        result.data = data;
-                        resolve(result);
-                      })
-                      .catch((err) => {
-                        result.err = err;
-                        reject(result);
-                      });
-                  };
-
-                  // Don't need user info
-                  if (typeof access_token !== 'string' || access_token.length < 1)
-                    end_discord_session();
-                  // Yes
-                  else {
-                    // Get User
-                    getUser(access_token)
-                      .then((data) => {
-                        result.user = data;
-                        end_discord_session();
-                      })
-                      .catch(reject);
-                  }
-                }
-                // Nope
-                else reject({ code: 401, message: 'Invalid Client Secret!' });
-              }
-              // Nope
-              else reject({ code: 401, message: 'Invalid Client ID!' });
-            }
-            // Nope
-            else reject({ code: 401, message: 'Invalid Token Data!' });
-          }
-          // Nope
-          else resolve(result);
-        }
-        // Nope
-        else reject({ code: 401, message: 'Invalid csrfToken!' });
-      }
-      // Nope
-      else reject({ code: 401, message: 'Invalid query setting!' });
-    }
-    // Nope
-    else reject({ code: 500, message: 'Invalid Config Values!' });
-  });
-}
-
-module.exports = logout;

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

@@ -1,23 +0,0 @@
-/**
- * Handles the logout process for the user by revoking the token and redirecting.
- *
- * @param {Record<string, any>} req - The HTTP request object.
- * @param {string|number} access_token - The access token of the user to be revoked.
- * @param {Record<string, any>} cfg - Configuration object containing settings for the logout process.
- * @param {boolean} existSession - A flag indicating whether a session exists.
- *
- * @returns {Promise<Record<string, any>>} Resolves with a result object or rejects with an error.
- *
- * @throws {Record<string, any>} Rejects with an error if configuration or token values are invalid.
- *
- * @example
- * logout(req, 'userAccessToken', cfg, true)
- *   .then(result => {
- *     // Handle successful logout
- *   })
- *   .catch(err => {
- *     // Handle error during logout
- *   });
- */
-export default function logout(req: Record<string, any>, access_token: string | number, cfg: Record<string, any>, existSession: boolean): Promise<Record<string, any>>;
-//# sourceMappingURL=logout.d.mts.map

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

@@ -1,144 +0,0 @@
-// @ts-nocheck
-import _ from 'lodash';
-import objType from '../../../get/objType.mjs';
-import revokeToken from '../api/revokeToken.mjs';
-import getUser from '../api/getUser.mjs';
-/**
- * Handles the logout process for the user by revoking the token and redirecting.
- *
- * @param {Record<string, any>} req - The HTTP request object.
- * @param {string|number} access_token - The access token of the user to be revoked.
- * @param {Record<string, any>} cfg - Configuration object containing settings for the logout process.
- * @param {boolean} existSession - A flag indicating whether a session exists.
- *
- * @returns {Promise<Record<string, any>>} Resolves with a result object or rejects with an error.
- *
- * @throws {Record<string, any>} Rejects with an error if configuration or token values are invalid.
- *
- * @example
- * logout(req, 'userAccessToken', cfg, true)
- *   .then(result => {
- *     // Handle successful logout
- *   })
- *   .catch(err => {
- *     // Handle error during logout
- *   });
- */
-export default async function logout(req, access_token, cfg, existSession) {
-    return new Promise(function (resolve, reject) {
-        // Detect Config
-        if (objType(cfg, 'object')) {
-            // Create Settings
-            const tinyQuery = _.defaultsDeep({}, cfg.query, {
-                csrfToken: 'csrfToken',
-                redirect: 'redirect',
-            });
-            const tinyState = _.defaultsDeep({}, cfg.state, {
-                csrfToken: '',
-                redirect: '',
-            });
-            // Exist Query Setting
-            if (objType(tinyQuery, 'object')) {
-                // Exist Query
-                if (typeof tinyState.csrfToken !== 'string' ||
-                    tinyState.csrfToken.length < 1 ||
-                    (objType(req.query, 'object') &&
-                        typeof cfg.csrfToken === 'string' &&
-                        tinyState.csrfToken === cfg.csrfToken)) {
-                    // Result
-                    const result = {
-                        data: null,
-                        existSession: existSession,
-                        complete: false,
-                        state: { csrfToken: cfg.csrfToken },
-                    };
-                    // Prepare Final Redirect
-                    result.redirect = '/';
-                    // Redirect
-                    if (typeof tinyState.redirect === 'string' && tinyState.redirect.length > 0) {
-                        if (tinyState.redirect.startsWith('/'))
-                            result.redirect = tinyState.redirect.substring(1);
-                        else
-                            result.redirect = tinyState.redirect;
-                    }
-                    // Get Query
-                    else if (typeof req.query[tinyQuery.redirect] === 'string') {
-                        if (req.query[tinyQuery.redirect].startsWith('/'))
-                            result.redirect = req.query[tinyQuery.redirect].substring(1);
-                        else
-                            result.redirect = req.query[tinyQuery.redirect];
-                    }
-                    // Exist Session
-                    if (existSession) {
-                        // Exist Token
-                        if ((typeof access_token === 'string' && access_token.length > 0) ||
-                            (typeof access_token === 'number' && !isNaN(access_token))) {
-                            // Prepare Auth
-                            const tinyAuth = _.defaultsDeep({}, cfg.auth, {
-                                client_id: '',
-                                client_secret: '',
-                                redirect_uri: '',
-                            });
-                            // Exist Client ID
-                            if ((typeof tinyAuth.client_id === 'string' && tinyAuth.client_id.length > 0) ||
-                                (typeof tinyAuth.client_id === 'number' && !isNaN(tinyAuth.client_id))) {
-                                // Exist Client Secret
-                                if ((typeof tinyAuth.client_secret === 'string' &&
-                                    tinyAuth.client_secret.length > 0) ||
-                                    (typeof tinyAuth.client_secret === 'number' && !isNaN(tinyAuth.client_secret))) {
-                                    // End Discord
-                                    const end_discord_session = function () {
-                                        // Get API HTTP and Revoke the Token
-                                        revokeToken(access_token, tinyAuth)
-                                            .then((data) => {
-                                            result.data = data;
-                                            resolve(result);
-                                        })
-                                            .catch((err) => {
-                                            result.err = err;
-                                            reject(result);
-                                        });
-                                    };
-                                    // Don't need user info
-                                    if (typeof access_token !== 'string' || access_token.length < 1)
-                                        end_discord_session();
-                                    // Yes
-                                    else {
-                                        // Get User
-                                        getUser(access_token)
-                                            .then((data) => {
-                                            result.user = data;
-                                            end_discord_session();
-                                        })
-                                            .catch(reject);
-                                    }
-                                }
-                                // Nope
-                                else
-                                    reject({ code: 401, message: 'Invalid Client Secret!' });
-                            }
-                            // Nope
-                            else
-                                reject({ code: 401, message: 'Invalid Client ID!' });
-                        }
-                        // Nope
-                        else
-                            reject({ code: 401, message: 'Invalid Token Data!' });
-                    }
-                    // Nope
-                    else
-                        resolve(result);
-                }
-                // Nope
-                else
-                    reject({ code: 401, message: 'Invalid csrfToken!' });
-            }
-            // Nope
-            else
-                reject({ code: 401, message: 'Invalid query setting!' });
-        }
-        // Nope
-        else
-            reject({ code: 500, message: 'Invalid Config Values!' });
-    });
-}

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

@@ -1,191 +0,0 @@
-'use strict';
-
-var _ = require('lodash');
-var _default = require('../../../crypto/default.cjs');
-var objFilter = require('../../../../v1/basics/objFilter.cjs');
-var decrypt = require('../../../crypto/decrypt.cjs');
-var getToken = require('../api/getToken.cjs');
-var getUser = require('../api/getUser.cjs');
-
-// @ts-nocheck
-
-
-/**
- * Handles the redirection logic for the OAuth flow, including state validation, token retrieval, and user session management.
- * This function is used for handling Discord OAuth redirects and session creation or restoration.
- *
- * @param {Record<string, any>} req - The request object from the client, which contains query parameters such as `state`, `code`, and `csrfToken`.
- * @param {Record<string, any>} cfg - The configuration object containing settings like `crypto`, `auth`, and `discordScope`.
- * @param {boolean} existSession - Indicates if the user already has an active session.
- *
- * @returns {Promise<Record<string, any>>} - A promise that resolves with an object containing the redirection URL and session information.
- * If a new session is created, it also includes user data and the token request.
- *
- * @throws {Record<string, any>} - Throws an error with a `code` and `message` if any validation fails (e.g., missing token, invalid state).
- *
- * @example
- * // Example usage of redirect function
- * redirect(req, cfg, true)
- *   .then((result) => {
- *     console.log('Redirection successful', result);
- *   })
- *   .catch((err) => {
- *     console.error('Error during redirect', err);
- *   });
- */
-async function redirect(req, cfg, existSession) {
-  return new Promise(function (resolve, reject) {
-    // Detect Config
-    if (objFilter.objType(cfg, 'object')) {
-      // 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: '',
-          client_secret: '',
-          first_get_user: true,
-        });
-
-        // Check Type
-        if (req.query.state.type === 'login_command') {
-          tinyCfg.discordScope = ['applications.commands', 'applications.commands.update'];
-        }
-
-        // Detect Query
-        if (objFilter.objType(req.query, 'object')) {
-          // Get State
-          if (typeof req.query.state === 'string') {
-            // Crypto
-            req.query.state = decrypt.decrypt(tinyCrypto, req.query.state);
-
-            // Convert
-            try {
-              req.query.state = JSON.parse(req.query.state);
-            } catch (err) {
-              req.query.state = {};
-            }
-          } else {
-            req.query.state = {};
-          }
-
-          // Detect State
-          if (objFilter.objType(req.query.state, 'object')) {
-            // Check Session
-            if (
-              typeof tinyCfg.csrfToken !== 'string' ||
-              tinyCfg.csrfToken.length < 1 ||
-              (typeof req.query.state.csrfToken === 'string' &&
-                req.query.state.csrfToken === tinyCfg.csrfToken)
-            ) {
-              // Prepare Resolve Data
-              const resolveData = { newSession: false, state: req.query.state };
-
-              // Final Redirect
-              resolveData.redirect = '/';
-              if (typeof req.query.state.redirect === 'string') {
-                resolveData.redirect += req.query.state.redirect;
-              }
-
-              // Exist Session
-              if (!existSession || req.query.state.type === 'webhook') {
-                if (
-                  (typeof req.query.code === 'string' && req.query.code.length > 0) ||
-                  (typeof req.query.code === 'number' && !isNaN(req.query.code))
-                ) {
-                  // Discord Token
-                  getToken({
-                    client_id: tinyCfg.client_id,
-                    client_secret: tinyCfg.client_secret,
-                    code: req.query.code,
-                    redirect_uri: tinyCfg.redirect,
-                    scope: tinyCfg.discordScope.join(' '),
-                  })
-                    // Success
-                    .then((json) => {
-                      // Valid Json Data
-                      if (objFilter.objType(json, 'object')) {
-                        // Check Token
-                        if (
-                          typeof json.access_token === 'string' ||
-                          typeof json.access_token === 'number'
-                        ) {
-                          // Token
-                          resolveData.tokenRequest = json;
-
-                          // Login Type
-                          if (req.query.state.type === 'login') {
-                            // Check New Session
-                            resolveData.newSession = true;
-
-                            // Get User Data
-                            if (tinyCfg.first_get_user) {
-                              // Get User
-                              getUser(json.access_token)
-                                // Get User
-                                .then((dsUser) => {
-                                  // Validate Data
-                                  if (objFilter.objType(dsUser, 'object')) {
-                                    resolveData.user = dsUser;
-                                    resolve(resolveData);
-                                  }
-
-                                  // Nope
-                                  else reject({ code: 500, message: 'Invalid JSON User Data!' });
-                                })
-                                // Fail
-                                .catch(reject);
-                            }
-
-                            // Nope
-                            else {
-                              // Return Result
-                              resolve(resolveData);
-                            }
-                          }
-
-                          // Webhook Type
-                          else if (req.query.state.type === 'webhook') {
-                            // Guild ID
-                            if (typeof req.query.guild_id === 'string')
-                              resolveData.guild_id = req.query.guild_id;
-
-                            // Return Result
-                            resolve(resolveData);
-                          }
-
-                          // Unknown
-                          else reject({ code: 400, message: 'Invalid State Type!' });
-                        }
-                        // Nope
-                        else reject({ code: 500, message: 'Invalid User Token Data!' });
-                      }
-                      // Nope
-                      else reject({ code: 500, message: 'Invalid JSON Token Data!' });
-                    })
-
-                    // Fail
-                    .catch(reject);
-                } else reject({ code: 401, message: 'Invalid Discord Code!' });
-              } else resolve({ newSession: false });
-            } else reject({ code: 401, message: 'Incorrect csrfToken!' });
-          }
-          // Nope
-          else reject({ code: 401, message: 'Invalid State Query!' });
-        }
-        // Nope
-        else reject({ code: 401, message: 'Invalid Query URL!' });
-      }
-      // Nope
-      else reject({ code: 500, message: 'Invalid Crypto Values!' });
-    }
-    // Nope
-    else reject({ code: 500, message: 'Invalid Config Values!' });
-  });
-}
-
-module.exports = redirect;

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

@@ -1,25 +0,0 @@
-/**
- * Handles the redirection logic for the OAuth flow, including state validation, token retrieval, and user session management.
- * This function is used for handling Discord OAuth redirects and session creation or restoration.
- *
- * @param {Record<string, any>} req - The request object from the client, which contains query parameters such as `state`, `code`, and `csrfToken`.
- * @param {Record<string, any>} cfg - The configuration object containing settings like `crypto`, `auth`, and `discordScope`.
- * @param {boolean} existSession - Indicates if the user already has an active session.
- *
- * @returns {Promise<Record<string, any>>} - A promise that resolves with an object containing the redirection URL and session information.
- * If a new session is created, it also includes user data and the token request.
- *
- * @throws {Record<string, any>} - Throws an error with a `code` and `message` if any validation fails (e.g., missing token, invalid state).
- *
- * @example
- * // Example usage of redirect function
- * redirect(req, cfg, true)
- *   .then((result) => {
- *     console.log('Redirection successful', result);
- *   })
- *   .catch((err) => {
- *     console.error('Error during redirect', err);
- *   });
- */
-export default function redirect(req: Record<string, any>, cfg: Record<string, any>, existSession: boolean): Promise<Record<string, any>>;
-//# sourceMappingURL=redirect.d.mts.map