tiny-essentials 1.24.0 → 1.24.2

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

@@ -1,112 +0,0 @@
-'use strict';
-
-// @ts-nocheck
-
-/**
- * Handles Firebase authentication using a custom token, CSRF protection,
- * and final redirection logic after login.
- *
- * This function signs in the user with a custom Firebase token, waits for
- * the auth state to change, retrieves the ID token, sends it to the current
- * server endpoint along with a CSRF token, and then redirects the user to
- * the specified URL or executes a callback.
- *
- * @namespace login
- */
-const login = {
-  /**
-   * Executes the login process with Firebase Auth and handles redirection.
-   *
-   * @param {string} token - The Firebase custom token used for authentication.
-   * @param {string} redirect_url - The relative URL to redirect the user after login.
-   *                                If it starts with "/", it will be adjusted.
-   * @param {string} csrfToken - A CSRF protection token to be sent to the backend.
-   * @param {function} [callback] - Optional callback to be called after authentication.
-   *                                Signature: `(err, redirectFunction, user)`
-   *                                - If omitted, default redirection is used.
-   *
-   * @example
-   * login.run(firebaseToken, '/dashboard', csrfToken);
-   *
-   * @example
-   * login.run(firebaseToken, '/dashboard', csrfToken, (err, redirect, user) => {
-   *   if (err) {
-   *     console.error('Login failed:', err);
-   *     return;
-   *   }
-   *   console.log('Logged in as', user.displayName);
-   *   redirect(); // manually trigger the redirect
-   * });
-   */
-  run: function (token, redirect_url, csrfToken, callback) {
-    // Fix Redirect
-    if (typeof redirect_url === 'string') {
-      if (redirect_url.startsWith('/')) redirect_url = redirect_url.substring(1);
-      else if (redirect_url.startsWith(window.location.origin))
-        redirect_url = redirect_url.substring(window.location.origin.length + 1);
-    }
-
-    // Nope
-    else redirect_url = '';
-
-    // Prepare Redirect
-    const final_redirect = function (err, user) {
-      // The Redirect
-      const start_redirect = function () {
-        window.location.href = window.location.origin + '/' + redirect_url;
-      };
-
-      // Default Redirect
-      if (typeof callback !== 'function') {
-        // Show Error
-        if (err) alert(err.message);
-        // Redirect Now
-        start_redirect();
-      }
-
-      // Custom Redirect
-      else callback(err, start_redirect, user);
-    };
-
-    // Firebase Auth
-    firebase.auth().onAuthStateChanged(function (user) {
-      if (user) {
-        user
-          .getIdToken()
-          .then(function (idToken) {
-            // Fetch
-            fetch(window.location.pathname, {
-              method: 'POST',
-              headers: {
-                Accept: 'application/json',
-                'Content-Type': 'application/json',
-              },
-              body: JSON.stringify({ token: idToken, csrfToken: csrfToken }),
-            })
-              .then((response) => {
-                response
-                  .json()
-                  .then((data) => {
-                    // Show Error Message
-                    if (!data.success) final_redirect(new Error(data.error));
-                    // Complete
-                    else final_redirect(null, user);
-                  })
-                  .catch(final_redirect);
-              })
-              .catch(final_redirect);
-          })
-          .catch(final_redirect);
-      }
-    });
-
-    // Sign In
-    firebase
-      .auth()
-      .signInWithCustomToken(token)
-      // Fail
-      .catch(final_redirect);
-  },
-};
-
-module.exports = login;

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

@@ -1,5 +0,0 @@
-export default login;
-declare namespace login {
-    function run(token: string, redirect_url: string, csrfToken: string, callback?: Function): void;
-}
-//# sourceMappingURL=login.d.mts.map

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

@@ -1,108 +0,0 @@
-// @ts-nocheck
-/**
- * Handles Firebase authentication using a custom token, CSRF protection,
- * and final redirection logic after login.
- *
- * This function signs in the user with a custom Firebase token, waits for
- * the auth state to change, retrieves the ID token, sends it to the current
- * server endpoint along with a CSRF token, and then redirects the user to
- * the specified URL or executes a callback.
- *
- * @namespace login
- */
-const login = {
-    /**
-     * Executes the login process with Firebase Auth and handles redirection.
-     *
-     * @param {string} token - The Firebase custom token used for authentication.
-     * @param {string} redirect_url - The relative URL to redirect the user after login.
-     *                                If it starts with "/", it will be adjusted.
-     * @param {string} csrfToken - A CSRF protection token to be sent to the backend.
-     * @param {function} [callback] - Optional callback to be called after authentication.
-     *                                Signature: `(err, redirectFunction, user)`
-     *                                - If omitted, default redirection is used.
-     *
-     * @example
-     * login.run(firebaseToken, '/dashboard', csrfToken);
-     *
-     * @example
-     * login.run(firebaseToken, '/dashboard', csrfToken, (err, redirect, user) => {
-     *   if (err) {
-     *     console.error('Login failed:', err);
-     *     return;
-     *   }
-     *   console.log('Logged in as', user.displayName);
-     *   redirect(); // manually trigger the redirect
-     * });
-     */
-    run: function (token, redirect_url, csrfToken, callback) {
-        // Fix Redirect
-        if (typeof redirect_url === 'string') {
-            if (redirect_url.startsWith('/'))
-                redirect_url = redirect_url.substring(1);
-            else if (redirect_url.startsWith(window.location.origin))
-                redirect_url = redirect_url.substring(window.location.origin.length + 1);
-        }
-        // Nope
-        else
-            redirect_url = '';
-        // Prepare Redirect
-        const final_redirect = function (err, user) {
-            // The Redirect
-            const start_redirect = function () {
-                window.location.href = window.location.origin + '/' + redirect_url;
-            };
-            // Default Redirect
-            if (typeof callback !== 'function') {
-                // Show Error
-                if (err)
-                    alert(err.message);
-                // Redirect Now
-                start_redirect();
-            }
-            // Custom Redirect
-            else
-                callback(err, start_redirect, user);
-        };
-        // Firebase Auth
-        firebase.auth().onAuthStateChanged(function (user) {
-            if (user) {
-                user
-                    .getIdToken()
-                    .then(function (idToken) {
-                    // Fetch
-                    fetch(window.location.pathname, {
-                        method: 'POST',
-                        headers: {
-                            Accept: 'application/json',
-                            'Content-Type': 'application/json',
-                        },
-                        body: JSON.stringify({ token: idToken, csrfToken: csrfToken }),
-                    })
-                        .then((response) => {
-                        response
-                            .json()
-                            .then((data) => {
-                            // Show Error Message
-                            if (!data.success)
-                                final_redirect(new Error(data.error));
-                            // Complete
-                            else
-                                final_redirect(null, user);
-                        })
-                            .catch(final_redirect);
-                    })
-                        .catch(final_redirect);
-                })
-                    .catch(final_redirect);
-            }
-        });
-        // Sign In
-        firebase
-            .auth()
-            .signInWithCustomToken(token)
-            // Fail
-            .catch(final_redirect);
-    },
-};
-export default login;

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

@@ -1,102 +0,0 @@
-'use strict';
-
-// @ts-nocheck
-
-/**
- * Handles the logout process by signing out from Firebase Auth,
- * verifying CSRF token, and redirecting the user.
- *
- * The `run` function signs out the user, sends a logout request to the server
- * along with CSRF protection, and then redirects the user to the specified URL
- * or executes a custom callback.
- *
- * @namespace logout
- */
-const logout = {
-  /**
-   * Executes the logout process, verifying CSRF token, signing out
-   * the user, and handling redirection.
-   *
-   * @param {string} token - The authentication token used to identify the user.
-   * @param {string} redirect_url - The relative URL to redirect the user after logout.
-   *                                If it starts with "/", it will be adjusted.
-   * @param {string} csrfToken - The CSRF token provided in the request.
-   * @param {string} original_csrfToken - The CSRF token that was initially generated.
-   * @param {function} [callback] - Optional callback to be called after logout.
-   *                                Signature: `(err, redirectFunction)`
-   *                                - If omitted, default redirection is used.
-   *
-   * @example
-   * logout.run(userToken, '/home', csrfToken, originalCsrfToken);
-   *
-   * @example
-   * logout.run(userToken, '/home', csrfToken, originalCsrfToken, (err, redirect) => {
-   *   if (err) {
-   *     console.error('Logout failed:', err);
-   *     return;
-   *   }
-   *   console.log('Logged out successfully');
-   *   redirect(); // manually trigger the redirect
-   * });
-   */
-  run: function (token, redirect_url, csrfToken, original_csrfToken, callback) {
-    // Compare CSRF Token
-    if (original_csrfToken.length < 1 || original_csrfToken === csrfToken) {
-      // Fix Redirect
-      if (typeof redirect_url === 'string') {
-        if (redirect_url.startsWith('/')) redirect_url = redirect_url.substring(1);
-      }
-
-      // Nope
-      else redirect_url = '';
-
-      // Prepare Redirect
-      const final_redirect = function (err) {
-        // The Redirect
-        const start_redirect = function () {
-          window.location.href = window.location.origin + '/' + redirect_url;
-        };
-
-        // Default Redirect
-        if (typeof callback !== 'function') {
-          // Show Error
-          if (err) alert(err.message);
-          // Redirect Now
-          start_redirect();
-        }
-
-        // Custom Redirect
-        else callback(err, start_redirect);
-      };
-
-      // Sign Out
-      firebase
-        .auth()
-        .signOut()
-        // Success
-        .then(() => {
-          fetch(window.location.pathname, {
-            method: 'POST',
-            headers: {
-              Accept: 'application/json',
-              'Content-Type': 'application/json',
-            },
-            body: JSON.stringify({ token: token, csrfToken: csrfToken }),
-          })
-            .then((response) => {
-              response
-                .json()
-                .then(() => final_redirect())
-                .catch(final_redirect);
-            })
-            .catch(final_redirect);
-        })
-        // Fail
-        .catch(final_redirect);
-    }
-    // Invalid
-    else final_redirect(new Error('Invalid csrfToken!'));
-  },
-};
-
-module.exports = logout;

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

@@ -1,5 +0,0 @@
-export default logout;
-declare namespace logout {
-    function run(token: string, redirect_url: string, csrfToken: string, original_csrfToken: string, callback?: Function): void;
-}
-//# sourceMappingURL=logout.d.mts.map

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

@@ -1,98 +0,0 @@
-// @ts-nocheck
-/**
- * Handles the logout process by signing out from Firebase Auth,
- * verifying CSRF token, and redirecting the user.
- *
- * The `run` function signs out the user, sends a logout request to the server
- * along with CSRF protection, and then redirects the user to the specified URL
- * or executes a custom callback.
- *
- * @namespace logout
- */
-const logout = {
-    /**
-     * Executes the logout process, verifying CSRF token, signing out
-     * the user, and handling redirection.
-     *
-     * @param {string} token - The authentication token used to identify the user.
-     * @param {string} redirect_url - The relative URL to redirect the user after logout.
-     *                                If it starts with "/", it will be adjusted.
-     * @param {string} csrfToken - The CSRF token provided in the request.
-     * @param {string} original_csrfToken - The CSRF token that was initially generated.
-     * @param {function} [callback] - Optional callback to be called after logout.
-     *                                Signature: `(err, redirectFunction)`
-     *                                - If omitted, default redirection is used.
-     *
-     * @example
-     * logout.run(userToken, '/home', csrfToken, originalCsrfToken);
-     *
-     * @example
-     * logout.run(userToken, '/home', csrfToken, originalCsrfToken, (err, redirect) => {
-     *   if (err) {
-     *     console.error('Logout failed:', err);
-     *     return;
-     *   }
-     *   console.log('Logged out successfully');
-     *   redirect(); // manually trigger the redirect
-     * });
-     */
-    run: function (token, redirect_url, csrfToken, original_csrfToken, callback) {
-        // Compare CSRF Token
-        if (original_csrfToken.length < 1 || original_csrfToken === csrfToken) {
-            // Fix Redirect
-            if (typeof redirect_url === 'string') {
-                if (redirect_url.startsWith('/'))
-                    redirect_url = redirect_url.substring(1);
-            }
-            // Nope
-            else
-                redirect_url = '';
-            // Prepare Redirect
-            const final_redirect = function (err) {
-                // The Redirect
-                const start_redirect = function () {
-                    window.location.href = window.location.origin + '/' + redirect_url;
-                };
-                // Default Redirect
-                if (typeof callback !== 'function') {
-                    // Show Error
-                    if (err)
-                        alert(err.message);
-                    // Redirect Now
-                    start_redirect();
-                }
-                // Custom Redirect
-                else
-                    callback(err, start_redirect);
-            };
-            // Sign Out
-            firebase
-                .auth()
-                .signOut()
-                // Success
-                .then(() => {
-                fetch(window.location.pathname, {
-                    method: 'POST',
-                    headers: {
-                        Accept: 'application/json',
-                        'Content-Type': 'application/json',
-                    },
-                    body: JSON.stringify({ token: token, csrfToken: csrfToken }),
-                })
-                    .then((response) => {
-                    response
-                        .json()
-                        .then(() => final_redirect())
-                        .catch(final_redirect);
-                })
-                    .catch(final_redirect);
-            })
-                // Fail
-                .catch(final_redirect);
-        }
-        // Invalid
-        else
-            final_redirect(new Error('Invalid csrfToken!'));
-    },
-};
-export default logout;

package/dist/legacy/firebase/discord/get/authURLGenerator.cjs

@@ -1,79 +0,0 @@
-'use strict';
-
-var encrypt = require('../../../crypto/encrypt.cjs');
-var config = require('../config.cjs');
-
-// @ts-nocheck
-
-
-/**
- * Generates an authorization URL for either login or webhook requests,
- * including scopes, state, and redirect URIs. This URL can be used in OAuth2
- * authentication flows, such as logging in or connecting a webhook.
- *
- * @function
- * @param {Record<string, any>} tinyCfg - The configuration object containing the app's OAuth2 settings.
- * @param {Record<string, any>} jsonState - The state object to be encrypted and passed in the authorization URL.
- * @param {Record<string, any>} tinyCrypto - The crypto object used to encrypt the state.
- * @param {string} type - The type of the request, which determines the URL generation process.
- *                         Can be `'login'`, `'login_command'`, or `'webhook'`.
- *
- * @returns {string} The generated authorization URL for OAuth2 authorization.
- *
- * @example
- * const authUrl = authURLGenerator(tinyCfg, jsonState, tinyCrypto, 'login');
- * console.log(authUrl);
- *
- * @example
- * const webhookAuthUrl = authURLGenerator(tinyCfg, jsonState, tinyCrypto, 'webhook');
- * console.log(webhookAuthUrl);
- */
-function authURLGenerator(tinyCfg, jsonState, tinyCrypto, type) {
-  // Scopes
-  let tinyScopeURI = '';
-
-  // Login
-  let needRedirect = false;
-  if (type === 'login' || type === 'login_command') {
-    // Normal Login
-    if (type === 'login') needRedirect = true;
-
-    // Read Scope
-    if (Array.isArray(tinyCfg.discordScope)) {
-      for (const item in tinyCfg.discordScope) {
-        if (tinyScopeURI) tinyScopeURI += '%20';
-        if (tinyCfg.discordScope[item] === 'applications.commands.update') needRedirect = true;
-        tinyScopeURI += encodeURIComponent(tinyCfg.discordScope[item]);
-      }
-    }
-  }
-
-  // Webhook
-  else if (type === 'webhook') {
-    needRedirect = true;
-    tinyScopeURI += 'webhook.incoming';
-  }
-
-  // Redirect Fixed
-  let tinyRedirect = '';
-  if (needRedirect && typeof tinyCfg.redirect === 'string')
-    tinyRedirect = '&redirect_uri=' + encodeURIComponent(tinyCfg.redirect);
-
-  // State
-  let tinyState = '';
-  let responseType = '';
-  if (needRedirect) {
-    // Crypto
-    tinyState = encrypt.encrypt(tinyCrypto, JSON.stringify(jsonState));
-    tinyState = '&state=' + encodeURIComponent(tinyState);
-    responseType = '&response_type=code';
-  }
-
-  // API URL
-  const apiURL = config.url;
-
-  // Redirect URL
-  return `${apiURL}oauth2/authorize?client_id=${encodeURIComponent(tinyCfg.client_id)}&scope=${tinyScopeURI}${responseType}${tinyRedirect}${tinyState}`;
-}
-
-module.exports = authURLGenerator;

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

@@ -1,24 +0,0 @@
-/**
- * Generates an authorization URL for either login or webhook requests,
- * including scopes, state, and redirect URIs. This URL can be used in OAuth2
- * authentication flows, such as logging in or connecting a webhook.
- *
- * @function
- * @param {Record<string, any>} tinyCfg - The configuration object containing the app's OAuth2 settings.
- * @param {Record<string, any>} jsonState - The state object to be encrypted and passed in the authorization URL.
- * @param {Record<string, any>} tinyCrypto - The crypto object used to encrypt the state.
- * @param {string} type - The type of the request, which determines the URL generation process.
- *                         Can be `'login'`, `'login_command'`, or `'webhook'`.
- *
- * @returns {string} The generated authorization URL for OAuth2 authorization.
- *
- * @example
- * const authUrl = authURLGenerator(tinyCfg, jsonState, tinyCrypto, 'login');
- * console.log(authUrl);
- *
- * @example
- * const webhookAuthUrl = authURLGenerator(tinyCfg, jsonState, tinyCrypto, 'webhook');
- * console.log(webhookAuthUrl);
- */
-export default function authURLGenerator(tinyCfg: Record<string, any>, jsonState: Record<string, any>, tinyCrypto: Record<string, any>, type: string): string;
-//# sourceMappingURL=authURLGenerator.d.mts.map

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

@@ -1,68 +0,0 @@
-// @ts-nocheck
-import { encrypt } from '../../../crypto/encrypt.mjs';
-import config from '../config.mjs';
-/**
- * Generates an authorization URL for either login or webhook requests,
- * including scopes, state, and redirect URIs. This URL can be used in OAuth2
- * authentication flows, such as logging in or connecting a webhook.
- *
- * @function
- * @param {Record<string, any>} tinyCfg - The configuration object containing the app's OAuth2 settings.
- * @param {Record<string, any>} jsonState - The state object to be encrypted and passed in the authorization URL.
- * @param {Record<string, any>} tinyCrypto - The crypto object used to encrypt the state.
- * @param {string} type - The type of the request, which determines the URL generation process.
- *                         Can be `'login'`, `'login_command'`, or `'webhook'`.
- *
- * @returns {string} The generated authorization URL for OAuth2 authorization.
- *
- * @example
- * const authUrl = authURLGenerator(tinyCfg, jsonState, tinyCrypto, 'login');
- * console.log(authUrl);
- *
- * @example
- * const webhookAuthUrl = authURLGenerator(tinyCfg, jsonState, tinyCrypto, 'webhook');
- * console.log(webhookAuthUrl);
- */
-export default function authURLGenerator(tinyCfg, jsonState, tinyCrypto, type) {
-    // Scopes
-    let tinyScopeURI = '';
-    // Login
-    let needRedirect = false;
-    if (type === 'login' || type === 'login_command') {
-        // Normal Login
-        if (type === 'login')
-            needRedirect = true;
-        // Read Scope
-        if (Array.isArray(tinyCfg.discordScope)) {
-            for (const item in tinyCfg.discordScope) {
-                if (tinyScopeURI)
-                    tinyScopeURI += '%20';
-                if (tinyCfg.discordScope[item] === 'applications.commands.update')
-                    needRedirect = true;
-                tinyScopeURI += encodeURIComponent(tinyCfg.discordScope[item]);
-            }
-        }
-    }
-    // Webhook
-    else if (type === 'webhook') {
-        needRedirect = true;
-        tinyScopeURI += 'webhook.incoming';
-    }
-    // Redirect Fixed
-    let tinyRedirect = '';
-    if (needRedirect && typeof tinyCfg.redirect === 'string')
-        tinyRedirect = '&redirect_uri=' + encodeURIComponent(tinyCfg.redirect);
-    // State
-    let tinyState = '';
-    let responseType = '';
-    if (needRedirect) {
-        // Crypto
-        tinyState = encrypt(tinyCrypto, JSON.stringify(jsonState));
-        tinyState = '&state=' + encodeURIComponent(tinyState);
-        responseType = '&response_type=code';
-    }
-    // API URL
-    const apiURL = config.url;
-    // Redirect URL
-    return `${apiURL}oauth2/authorize?client_id=${encodeURIComponent(tinyCfg.client_id)}&scope=${tinyScopeURI}${responseType}${tinyRedirect}${tinyState}`;
-}

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

@@ -1,35 +0,0 @@
-'use strict';
-
-var objFilter = require('../../../../v1/basics/objFilter.cjs');
-
-// @ts-nocheck
-
-
-/**
- * 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');
- * }
- */
-function cookieSession(req, where) {
-  // Get Token
-  if (objFilter.objType(req.session, 'object') && typeof req.session[where] === 'string')
-    return req.session[where];
-  // Nope
-  else return null;
-}
-
-module.exports = cookieSession;

package/dist/legacy/firebase/discord/get/cookie-session.d.mts

@@ -1,21 +0,0 @@
-/**
- * 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: Record<string, any>, where: string): string | null;
-//# sourceMappingURL=cookie-session.d.mts.map