tiny-essentials 1.24.0 → 1.24.1

package/dist/legacy/firebase/discord/api/addGuildMember.mjs

@@ -1,65 +0,0 @@
-// @ts-nocheck
-import getJsonFetch from '../../../http/fetch/json.mjs';
-import config from '../config.mjs';
-import errorValidator from '../get/errorValidator.mjs';
-/**
- * Adds a member to a Discord guild (server) using a valid OAuth2 access token and a bot token.
- * This method requires the `guilds.join` OAuth2 scope to be granted by the user.
- *
- * @param {string} bot_token - The Bot Token used for authorization (`Bot <token>`).
- * @param {Object} data - The data required to add the member to the guild.
- * @param {string} data.guild_id - The ID of the guild (server) the user should be added to.
- * @param {string} data.user_id - The ID of the user to be added.
- * @param {string} data.access_token - The OAuth2 access token granted by the user.
- * @param {string[]} [data.roles] - An optional array of role IDs to assign to the member.
- * @param {string} [data.nickname] - Optional nickname to assign to the user in the guild.
- * @param {boolean} [data.mute=false] - Whether the user should be server-muted.
- * @param {boolean} [data.deaf=false] - Whether the user should be server-deafened.
- *
- * @returns {Promise<Record<string, any>>} Resolves with the user object if successful, or rejects with an error object.
- *
- * @throws {Record<string, any>} If the request fails or Discord returns an error, rejects with an object containing a `code` and `message`.
- *
- * @example
- * const result = await addGuildMember('your_bot_token', {
- *   guild_id: '1234567890',
- *   user_id: '0987654321',
- *   access_token: 'user_access_token',
- *   roles: ['1122334455'],
- *   nickname: 'CoolUser',
- *   mute: false,
- *   deaf: false,
- * });
- */
-export default function addGuildMember(bot_token, data) {
-    return new Promise(function (resolve, reject) {
-        // API URL
-        const apiURL = config.url;
-        // Response
-        getJsonFetch(`${apiURL}guilds/${encodeURIComponent(data.guild_id)}/members/${encodeURIComponent(data.user_id)}`, {
-            method: 'PUT',
-            body: new URLSearchParams({
-                deaf: data.deaf,
-                mute: data.mute,
-                nick: data.nickname,
-                roles: data.roles,
-                access_token: data.access_token,
-            }),
-            headers: {
-                Authorization: `Bot ${bot_token}`,
-                'Content-Type': 'application/json',
-            },
-        })
-            .then((data) => {
-            // Error Validator
-            const result = errorValidator(data);
-            if (!result.error)
-                resolve(result.data);
-            else
-                reject(result.error);
-        })
-            .catch((err) => {
-            reject({ code: err.response.status, message: err.message });
-        });
-    });
-}

package/dist/legacy/firebase/discord/api/getGuildWidget.cjs

@@ -1,50 +0,0 @@
-'use strict';
-
-var json = require('../../../http/fetch/json.cjs');
-var config = require('../config.cjs');
-var errorValidator = require('../get/errorValidator.cjs');
-
-// @ts-nocheck
-
-
-/**
- * Fetches the public widget data for a Discord guild (server).
- * This includes online members, presence counts, and basic guild information,
- * but only if the widget is enabled in the server settings.
- *
- * @param {string} guildID - The ID of the guild whose widget is to be fetched.
- *
- * @returns {Promise<Record<string, any>>} Resolves with the guild widget data if successful.
- *
- * @throws {Record<string, any>} If the request fails or the widget is disabled, rejects with an object containing a `code` and `message`.
- *
- * @example
- * getGuildWidget('123456789012345678')
- *   .then((data) => console.log(data))
- *   .catch((err) => console.error('Widget error:', err));
- */
-function getGuildWidget(guildID) {
-  return new Promise(function (resolve, reject) {
-    // API URL
-    const apiURL = config.url;
-
-    // Response
-    json(`${apiURL}guilds/${encodeURIComponent(guildID)}/widget.json`, {
-      method: 'GET',
-      headers: {
-        'Content-Type': 'application/json',
-      },
-    })
-      .then((data) => {
-        // Error Validator
-        const result = errorValidator(data);
-        if (!result.error) resolve(result.data);
-        else reject(result.error);
-      })
-      .catch((err) => {
-        reject({ code: err.response.status, message: err.message });
-      });
-  });
-}
-
-module.exports = getGuildWidget;

package/dist/legacy/firebase/discord/api/getGuildWidget.d.mts

@@ -1,18 +0,0 @@
-/**
- * Fetches the public widget data for a Discord guild (server).
- * This includes online members, presence counts, and basic guild information,
- * but only if the widget is enabled in the server settings.
- *
- * @param {string} guildID - The ID of the guild whose widget is to be fetched.
- *
- * @returns {Promise<Record<string, any>>} Resolves with the guild widget data if successful.
- *
- * @throws {Record<string, any>} If the request fails or the widget is disabled, rejects with an object containing a `code` and `message`.
- *
- * @example
- * getGuildWidget('123456789012345678')
- *   .then((data) => console.log(data))
- *   .catch((err) => console.error('Widget error:', err));
- */
-export default function getGuildWidget(guildID: string): Promise<Record<string, any>>;
-//# sourceMappingURL=getGuildWidget.d.mts.map

package/dist/legacy/firebase/discord/api/getGuildWidget.mjs

@@ -1,44 +0,0 @@
-// @ts-nocheck
-import getJsonFetch from '../../../http/fetch/json.mjs';
-import config from '../config.mjs';
-import errorValidator from '../get/errorValidator.mjs';
-/**
- * Fetches the public widget data for a Discord guild (server).
- * This includes online members, presence counts, and basic guild information,
- * but only if the widget is enabled in the server settings.
- *
- * @param {string} guildID - The ID of the guild whose widget is to be fetched.
- *
- * @returns {Promise<Record<string, any>>} Resolves with the guild widget data if successful.
- *
- * @throws {Record<string, any>} If the request fails or the widget is disabled, rejects with an object containing a `code` and `message`.
- *
- * @example
- * getGuildWidget('123456789012345678')
- *   .then((data) => console.log(data))
- *   .catch((err) => console.error('Widget error:', err));
- */
-export default function getGuildWidget(guildID) {
-    return new Promise(function (resolve, reject) {
-        // API URL
-        const apiURL = config.url;
-        // Response
-        getJsonFetch(`${apiURL}guilds/${encodeURIComponent(guildID)}/widget.json`, {
-            method: 'GET',
-            headers: {
-                'Content-Type': 'application/json',
-            },
-        })
-            .then((data) => {
-            // Error Validator
-            const result = errorValidator(data);
-            if (!result.error)
-                resolve(result.data);
-            else
-                reject(result.error);
-        })
-            .catch((err) => {
-            reject({ code: err.response.status, message: err.message });
-        });
-    });
-}

package/dist/legacy/firebase/discord/api/getToken.cjs

@@ -1,70 +0,0 @@
-'use strict';
-
-var json = require('../../../http/fetch/json.cjs');
-var config = require('../config.cjs');
-var errorValidator = require('../get/errorValidator.cjs');
-
-// @ts-nocheck
-
-
-/**
- * Exchanges an authorization code for an access token using Discord's OAuth2 API.
- *
- * This function is used in the OAuth2 authorization code flow.
- * It sends a POST request to the `/oauth2/token` endpoint with the required parameters.
- *
- * @param {Object} dsData - The data required for the token exchange.
- * @param {string} dsData.client_id - Your application's client ID.
- * @param {string} dsData.client_secret - Your application's client secret.
- * @param {string} dsData.code - The authorization code received from Discord.
- * @param {string} dsData.redirect_uri - The redirect URI used during the authorization.
- * @param {string} [dsData.scope] - The OAuth2 scopes being requested (optional but recommended).
- *
- * @returns {Promise<Record<string, any>>} Resolves with the access token data (access_token, token_type, expires_in, refresh_token, scope).
- *
- * @throws {Record<string, any>} If the request fails or Discord returns an error, rejects with an object containing a `code` and `message`.
- *
- * @example
- * getToken({
- *   client_id: '123456789012345678',
- *   client_secret: 's3cr3t',
- *   code: 'authcodefromdiscord',
- *   redirect_uri: 'https://your.app/redirect',
- *   scope: 'identify guilds'
- * })
- * .then(token => console.log('Access Token:', token.access_token))
- * .catch(err => console.error('Token error:', err));
- */
-function getToken(dsData) {
-  return new Promise(function (resolve, reject) {
-    // API URL
-    const apiURL = config.url;
-
-    // Response
-    json(`${apiURL}oauth2/token`, {
-      method: 'POST',
-      body: new URLSearchParams({
-        client_id: dsData.client_id,
-        client_secret: dsData.client_secret,
-        grant_type: 'authorization_code',
-        code: dsData.code,
-        redirect_uri: dsData.redirect_uri,
-        scope: dsData.scope,
-      }),
-      headers: {
-        'Content-Type': 'application/x-www-form-urlencoded',
-      },
-    })
-      .then((data) => {
-        // Error Validator
-        const result = errorValidator(data);
-        if (!result.error) resolve(result.data);
-        else reject(result.error);
-      })
-      .catch((err) => {
-        reject({ code: err.response.status, message: err.message });
-      });
-  });
-}
-
-module.exports = getToken;

package/dist/legacy/firebase/discord/api/getToken.d.mts

@@ -1,36 +0,0 @@
-/**
- * Exchanges an authorization code for an access token using Discord's OAuth2 API.
- *
- * This function is used in the OAuth2 authorization code flow.
- * It sends a POST request to the `/oauth2/token` endpoint with the required parameters.
- *
- * @param {Object} dsData - The data required for the token exchange.
- * @param {string} dsData.client_id - Your application's client ID.
- * @param {string} dsData.client_secret - Your application's client secret.
- * @param {string} dsData.code - The authorization code received from Discord.
- * @param {string} dsData.redirect_uri - The redirect URI used during the authorization.
- * @param {string} [dsData.scope] - The OAuth2 scopes being requested (optional but recommended).
- *
- * @returns {Promise<Record<string, any>>} Resolves with the access token data (access_token, token_type, expires_in, refresh_token, scope).
- *
- * @throws {Record<string, any>} If the request fails or Discord returns an error, rejects with an object containing a `code` and `message`.
- *
- * @example
- * getToken({
- *   client_id: '123456789012345678',
- *   client_secret: 's3cr3t',
- *   code: 'authcodefromdiscord',
- *   redirect_uri: 'https://your.app/redirect',
- *   scope: 'identify guilds'
- * })
- * .then(token => console.log('Access Token:', token.access_token))
- * .catch(err => console.error('Token error:', err));
- */
-export default function getToken(dsData: {
-    client_id: string;
-    client_secret: string;
-    code: string;
-    redirect_uri: string;
-    scope?: string | undefined;
-}): Promise<Record<string, any>>;
-//# sourceMappingURL=getToken.d.mts.map

package/dist/legacy/firebase/discord/api/getToken.mjs

@@ -1,64 +0,0 @@
-// @ts-nocheck
-import getJsonFetch from '../../../http/fetch/json.mjs';
-import config from '../config.mjs';
-import errorValidator from '../get/errorValidator.mjs';
-/**
- * Exchanges an authorization code for an access token using Discord's OAuth2 API.
- *
- * This function is used in the OAuth2 authorization code flow.
- * It sends a POST request to the `/oauth2/token` endpoint with the required parameters.
- *
- * @param {Object} dsData - The data required for the token exchange.
- * @param {string} dsData.client_id - Your application's client ID.
- * @param {string} dsData.client_secret - Your application's client secret.
- * @param {string} dsData.code - The authorization code received from Discord.
- * @param {string} dsData.redirect_uri - The redirect URI used during the authorization.
- * @param {string} [dsData.scope] - The OAuth2 scopes being requested (optional but recommended).
- *
- * @returns {Promise<Record<string, any>>} Resolves with the access token data (access_token, token_type, expires_in, refresh_token, scope).
- *
- * @throws {Record<string, any>} If the request fails or Discord returns an error, rejects with an object containing a `code` and `message`.
- *
- * @example
- * getToken({
- *   client_id: '123456789012345678',
- *   client_secret: 's3cr3t',
- *   code: 'authcodefromdiscord',
- *   redirect_uri: 'https://your.app/redirect',
- *   scope: 'identify guilds'
- * })
- * .then(token => console.log('Access Token:', token.access_token))
- * .catch(err => console.error('Token error:', err));
- */
-export default function getToken(dsData) {
-    return new Promise(function (resolve, reject) {
-        // API URL
-        const apiURL = config.url;
-        // Response
-        getJsonFetch(`${apiURL}oauth2/token`, {
-            method: 'POST',
-            body: new URLSearchParams({
-                client_id: dsData.client_id,
-                client_secret: dsData.client_secret,
-                grant_type: 'authorization_code',
-                code: dsData.code,
-                redirect_uri: dsData.redirect_uri,
-                scope: dsData.scope,
-            }),
-            headers: {
-                'Content-Type': 'application/x-www-form-urlencoded',
-            },
-        })
-            .then((data) => {
-            // Error Validator
-            const result = errorValidator(data);
-            if (!result.error)
-                resolve(result.data);
-            else
-                reject(result.error);
-        })
-            .catch((err) => {
-            reject({ code: err.response.status, message: err.message });
-        });
-    });
-}

package/dist/legacy/firebase/discord/api/getUser.cjs

@@ -1,61 +0,0 @@
-'use strict';
-
-var json = require('../../../http/fetch/json.cjs');
-var config = require('../config.cjs');
-var errorValidator = require('../get/errorValidator.cjs');
-
-// @ts-nocheck
-
-
-/**
- * Retrieves user information from the Discord API.
- *
- * This function is typically used to fetch the authenticated user's information
- * (`@me`) or a specific user's data by their user ID.
- *
- * @param {string} access_token - The access token used for authentication (typically obtained via OAuth2).
- * @param {string} [type='Bearer'] - The token type (usually 'Bearer' for OAuth2 or 'Bot' for bot tokens).
- * @param {string} [user='@me'] - The user ID to fetch. Use '@me' to get the authenticated user's profile.
- * @param {string} [version=''] - Optional API version prefix (e.g., 'v10/') if needed by your API setup.
- *
- * @returns {Promise<Record<string, any>>} Resolves with the user's profile data returned by Discord.
- *
- * @throws {Record<string, any>} If the request fails, rejects with an error object containing `code` and `message`.
- *
- * @example
- * getUser('access_token_here')
- *   .then(user => console.log('Logged in as:', user.username))
- *   .catch(err => console.error('User fetch failed:', err));
- *
- * @example
- * // Using a bot token to fetch another user
- * getUser('bot_token', 'Bot', '123456789012345678')
- *   .then(user => console.log('User info:', user))
- *   .catch(err => console.error('Error:', err));
- */
-function getUser(access_token, type = 'Bearer', user = '@me', version = '') {
-  return new Promise(function (resolve, reject) {
-    // API URL
-    const apiURL = config.url;
-
-    // Response
-    json(`${apiURL}${version}users/${user}`, {
-      method: 'GET',
-      headers: {
-        Authorization: `${type} ${access_token}`,
-        'Content-Type': 'application/json',
-      },
-    })
-      .then((data) => {
-        // Error Validator
-        const result = errorValidator(data);
-        if (!result.error) resolve(result.data);
-        else reject(result.error);
-      })
-      .catch((err) => {
-        reject({ code: err.response.status, message: err.message });
-      });
-  });
-}
-
-module.exports = getUser;

package/dist/legacy/firebase/discord/api/getUser.d.mts

@@ -1,28 +0,0 @@
-/**
- * Retrieves user information from the Discord API.
- *
- * This function is typically used to fetch the authenticated user's information
- * (`@me`) or a specific user's data by their user ID.
- *
- * @param {string} access_token - The access token used for authentication (typically obtained via OAuth2).
- * @param {string} [type='Bearer'] - The token type (usually 'Bearer' for OAuth2 or 'Bot' for bot tokens).
- * @param {string} [user='@me'] - The user ID to fetch. Use '@me' to get the authenticated user's profile.
- * @param {string} [version=''] - Optional API version prefix (e.g., 'v10/') if needed by your API setup.
- *
- * @returns {Promise<Record<string, any>>} Resolves with the user's profile data returned by Discord.
- *
- * @throws {Record<string, any>} If the request fails, rejects with an error object containing `code` and `message`.
- *
- * @example
- * getUser('access_token_here')
- *   .then(user => console.log('Logged in as:', user.username))
- *   .catch(err => console.error('User fetch failed:', err));
- *
- * @example
- * // Using a bot token to fetch another user
- * getUser('bot_token', 'Bot', '123456789012345678')
- *   .then(user => console.log('User info:', user))
- *   .catch(err => console.error('Error:', err));
- */
-export default function getUser(access_token: string, type?: string, user?: string, version?: string): Promise<Record<string, any>>;
-//# sourceMappingURL=getUser.d.mts.map

package/dist/legacy/firebase/discord/api/getUser.mjs

@@ -1,55 +0,0 @@
-// @ts-nocheck
-import getJsonFetch from '../../../http/fetch/json.mjs';
-import config from '../config.mjs';
-import errorValidator from '../get/errorValidator.mjs';
-/**
- * Retrieves user information from the Discord API.
- *
- * This function is typically used to fetch the authenticated user's information
- * (`@me`) or a specific user's data by their user ID.
- *
- * @param {string} access_token - The access token used for authentication (typically obtained via OAuth2).
- * @param {string} [type='Bearer'] - The token type (usually 'Bearer' for OAuth2 or 'Bot' for bot tokens).
- * @param {string} [user='@me'] - The user ID to fetch. Use '@me' to get the authenticated user's profile.
- * @param {string} [version=''] - Optional API version prefix (e.g., 'v10/') if needed by your API setup.
- *
- * @returns {Promise<Record<string, any>>} Resolves with the user's profile data returned by Discord.
- *
- * @throws {Record<string, any>} If the request fails, rejects with an error object containing `code` and `message`.
- *
- * @example
- * getUser('access_token_here')
- *   .then(user => console.log('Logged in as:', user.username))
- *   .catch(err => console.error('User fetch failed:', err));
- *
- * @example
- * // Using a bot token to fetch another user
- * getUser('bot_token', 'Bot', '123456789012345678')
- *   .then(user => console.log('User info:', user))
- *   .catch(err => console.error('Error:', err));
- */
-export default function getUser(access_token, type = 'Bearer', user = '@me', version = '') {
-    return new Promise(function (resolve, reject) {
-        // API URL
-        const apiURL = config.url;
-        // Response
-        getJsonFetch(`${apiURL}${version}users/${user}`, {
-            method: 'GET',
-            headers: {
-                Authorization: `${type} ${access_token}`,
-                'Content-Type': 'application/json',
-            },
-        })
-            .then((data) => {
-            // Error Validator
-            const result = errorValidator(data);
-            if (!result.error)
-                resolve(result.data);
-            else
-                reject(result.error);
-        })
-            .catch((err) => {
-            reject({ code: err.response.status, message: err.message });
-        });
-    });
-}

package/dist/legacy/firebase/discord/api/getUserConnections.cjs

@@ -1,60 +0,0 @@
-'use strict';
-
-var json = require('../../../http/fetch/json.cjs');
-var config = require('../config.cjs');
-var errorValidator = require('../get/errorValidator.cjs');
-
-// @ts-nocheck
-
-
-/**
- * Retrieves the authenticated user's linked connections from the Discord API.
- *
- * This includes external accounts the user has connected to their Discord profile,
- * such as Steam, Twitch, YouTube, GitHub, etc.
- *
- * Requires the `connections` scope to be present in the OAuth2 token.
- *
- * @param {string} access_token - The OAuth2 access token used to authenticate the user.
- *
- * @returns {Promise<Array<Record<string, any>>>} Resolves with an array of connection objects.
- *
- * @throws {Record<string, any>} If the request fails, rejects with an error object containing `code` and `message`.
- *
- * @see {@link https://discord.com/developers/docs/resources/user#get-user-connections} Discord API Reference
- *
- * @example
- * getUserConnections('your_access_token')
- *   .then(connections => {
- *     connections.forEach(conn => {
- *       console.log(`${conn.type}: ${conn.name}`);
- *     });
- *   })
- *   .catch(err => console.error('Failed to get connections:', err));
- */
-function getUserConnections(access_token) {
-  return new Promise(function (resolve, reject) {
-    // API URL
-    const apiURL = config.url;
-
-    // Response
-    json(`${apiURL}users/@me/connections`, {
-      method: 'GET',
-      headers: {
-        Authorization: `Bearer ${access_token}`,
-        'Content-Type': 'application/json',
-      },
-    })
-      .then((data) => {
-        // Error Validator
-        const result = errorValidator(data);
-        if (!result.error) resolve(result.data);
-        else reject(result.error);
-      })
-      .catch((err) => {
-        reject({ code: err.response.status, message: err.message });
-      });
-  });
-}
-
-module.exports = getUserConnections;

package/dist/legacy/firebase/discord/api/getUserConnections.d.mts

@@ -1,27 +0,0 @@
-/**
- * Retrieves the authenticated user's linked connections from the Discord API.
- *
- * This includes external accounts the user has connected to their Discord profile,
- * such as Steam, Twitch, YouTube, GitHub, etc.
- *
- * Requires the `connections` scope to be present in the OAuth2 token.
- *
- * @param {string} access_token - The OAuth2 access token used to authenticate the user.
- *
- * @returns {Promise<Array<Record<string, any>>>} Resolves with an array of connection objects.
- *
- * @throws {Record<string, any>} If the request fails, rejects with an error object containing `code` and `message`.
- *
- * @see {@link https://discord.com/developers/docs/resources/user#get-user-connections} Discord API Reference
- *
- * @example
- * getUserConnections('your_access_token')
- *   .then(connections => {
- *     connections.forEach(conn => {
- *       console.log(`${conn.type}: ${conn.name}`);
- *     });
- *   })
- *   .catch(err => console.error('Failed to get connections:', err));
- */
-export default function getUserConnections(access_token: string): Promise<Array<Record<string, any>>>;
-//# sourceMappingURL=getUserConnections.d.mts.map

package/dist/legacy/firebase/discord/api/getUserConnections.mjs

@@ -1,54 +0,0 @@
-// @ts-nocheck
-import getJsonFetch from '../../../http/fetch/json.mjs';
-import config from '../config.mjs';
-import errorValidator from '../get/errorValidator.mjs';
-/**
- * Retrieves the authenticated user's linked connections from the Discord API.
- *
- * This includes external accounts the user has connected to their Discord profile,
- * such as Steam, Twitch, YouTube, GitHub, etc.
- *
- * Requires the `connections` scope to be present in the OAuth2 token.
- *
- * @param {string} access_token - The OAuth2 access token used to authenticate the user.
- *
- * @returns {Promise<Array<Record<string, any>>>} Resolves with an array of connection objects.
- *
- * @throws {Record<string, any>} If the request fails, rejects with an error object containing `code` and `message`.
- *
- * @see {@link https://discord.com/developers/docs/resources/user#get-user-connections} Discord API Reference
- *
- * @example
- * getUserConnections('your_access_token')
- *   .then(connections => {
- *     connections.forEach(conn => {
- *       console.log(`${conn.type}: ${conn.name}`);
- *     });
- *   })
- *   .catch(err => console.error('Failed to get connections:', err));
- */
-export default function getUserConnections(access_token) {
-    return new Promise(function (resolve, reject) {
-        // API URL
-        const apiURL = config.url;
-        // Response
-        getJsonFetch(`${apiURL}users/@me/connections`, {
-            method: 'GET',
-            headers: {
-                Authorization: `Bearer ${access_token}`,
-                'Content-Type': 'application/json',
-            },
-        })
-            .then((data) => {
-            // Error Validator
-            const result = errorValidator(data);
-            if (!result.error)
-                resolve(result.data);
-            else
-                reject(result.error);
-        })
-            .catch((err) => {
-            reject({ code: err.response.status, message: err.message });
-        });
-    });
-}