tiny-essentials 1.0.0

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

@@ -0,0 +1,58 @@
+'use strict';
+
+var json = require('../../../http/fetch/json.cjs');
+var config = require('../config.cjs');
+var errorValidator = require('../get/errorValidator.cjs');
+
+/**
+ * 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<Object>} Resolves with the user's profile data returned by Discord.
+ *
+ * @throws {Object} 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

@@ -0,0 +1,27 @@
+/**
+ * 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<Object>} Resolves with the user's profile data returned by Discord.
+ *
+ * @throws {Object} 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<Object>;

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

@@ -0,0 +1,54 @@
+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<Object>} Resolves with the user's profile data returned by Discord.
+ *
+ * @throws {Object} 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

@@ -0,0 +1,57 @@
+'use strict';
+
+var json = require('../../../http/fetch/json.cjs');
+var config = require('../config.cjs');
+var errorValidator = require('../get/errorValidator.cjs');
+
+/**
+ * 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<Object>>} Resolves with an array of connection objects.
+ *
+ * @throws {Object} 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

@@ -0,0 +1,26 @@
+/**
+ * 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<Object>>} Resolves with an array of connection objects.
+ *
+ * @throws {Object} 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<Object>>;

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

@@ -0,0 +1,53 @@
+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<Object>>} Resolves with an array of connection objects.
+ *
+ * @throws {Object} 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 });
+        });
+    });
+}

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

@@ -0,0 +1,56 @@
+'use strict';
+
+var json = require('../../../http/fetch/json.cjs');
+var config = require('../config.cjs');
+var errorValidator = require('../get/errorValidator.cjs');
+
+/**
+ * Retrieves a list of guilds (servers) the authenticated user is a member of.
+ *
+ * This function uses the Discord OAuth2 API and requires the `guilds` scope
+ * in the access token. It returns basic information about each guild, such as
+ * name, ID, owner status, permissions, and icon.
+ *
+ * Note: This does NOT include information available only to bots, like full member lists.
+ *
+ * @param {string} access_token - The OAuth2 access token used to authenticate the user.
+ *
+ * @returns {Promise<Array<Object>>} Resolves with an array of guild objects the user is in.
+ *
+ * @throws {Object} If the request fails, rejects with an error object containing `code` and `message`.
+ *
+ * @example
+ * getUserGuilds('your_access_token')
+ *   .then(guilds => {
+ *     guilds.forEach(guild => {
+ *       console.log(`${guild.name} (${guild.id})`);
+ *     });
+ *   })
+ *   .catch(err => console.error('Failed to get guilds:', err));
+ */
+function getUserGuilds(access_token) {
+  return new Promise(function (resolve, reject) {
+    // API URL
+    const apiURL = config.url;
+
+    // Response
+    json(`${apiURL}users/@me/guilds`, {
+      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 = getUserGuilds;

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

@@ -0,0 +1,25 @@
+/**
+ * Retrieves a list of guilds (servers) the authenticated user is a member of.
+ *
+ * This function uses the Discord OAuth2 API and requires the `guilds` scope
+ * in the access token. It returns basic information about each guild, such as
+ * name, ID, owner status, permissions, and icon.
+ *
+ * Note: This does NOT include information available only to bots, like full member lists.
+ *
+ * @param {string} access_token - The OAuth2 access token used to authenticate the user.
+ *
+ * @returns {Promise<Array<Object>>} Resolves with an array of guild objects the user is in.
+ *
+ * @throws {Object} If the request fails, rejects with an error object containing `code` and `message`.
+ *
+ * @example
+ * getUserGuilds('your_access_token')
+ *   .then(guilds => {
+ *     guilds.forEach(guild => {
+ *       console.log(`${guild.name} (${guild.id})`);
+ *     });
+ *   })
+ *   .catch(err => console.error('Failed to get guilds:', err));
+ */
+export default function getUserGuilds(access_token: string): Promise<Array<Object>>;

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

@@ -0,0 +1,52 @@
+import getJsonFetch from '../../../http/fetch/json.mjs';
+import config from '../config.mjs';
+import errorValidator from '../get/errorValidator.mjs';
+/**
+ * Retrieves a list of guilds (servers) the authenticated user is a member of.
+ *
+ * This function uses the Discord OAuth2 API and requires the `guilds` scope
+ * in the access token. It returns basic information about each guild, such as
+ * name, ID, owner status, permissions, and icon.
+ *
+ * Note: This does NOT include information available only to bots, like full member lists.
+ *
+ * @param {string} access_token - The OAuth2 access token used to authenticate the user.
+ *
+ * @returns {Promise<Array<Object>>} Resolves with an array of guild objects the user is in.
+ *
+ * @throws {Object} If the request fails, rejects with an error object containing `code` and `message`.
+ *
+ * @example
+ * getUserGuilds('your_access_token')
+ *   .then(guilds => {
+ *     guilds.forEach(guild => {
+ *       console.log(`${guild.name} (${guild.id})`);
+ *     });
+ *   })
+ *   .catch(err => console.error('Failed to get guilds:', err));
+ */
+export default function getUserGuilds(access_token) {
+    return new Promise(function (resolve, reject) {
+        // API URL
+        const apiURL = config.url;
+        // Response
+        getJsonFetch(`${apiURL}users/@me/guilds`, {
+            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 });
+        });
+    });
+}

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

@@ -0,0 +1,24 @@
+'use strict';
+
+var addGuildMember = require('./addGuildMember.cjs');
+var getGuildWidget = require('./getGuildWidget.cjs');
+var getToken = require('./getToken.cjs');
+var getUser = require('./getUser.cjs');
+var getUserConnections = require('./getUserConnections.cjs');
+var getUserGuilds = require('./getUserGuilds.cjs');
+var refreshToken = require('./refreshToken.cjs');
+var revokeToken = require('./revokeToken.cjs');
+
+// Module Base
+const discord_api = {
+  getToken,
+  getUser,
+  revokeToken,
+  getUserGuilds,
+  getGuildWidget,
+  getUserConnections,
+  addGuildMember,
+  refreshToken,
+};
+
+module.exports = discord_api;

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

@@ -0,0 +1,19 @@
+export default discord_api;
+declare namespace discord_api {
+    export { getToken };
+    export { getUser };
+    export { revokeToken };
+    export { getUserGuilds };
+    export { getGuildWidget };
+    export { getUserConnections };
+    export { addGuildMember };
+    export { refreshToken };
+}
+import getToken from './getToken.mjs';
+import getUser from './getUser.mjs';
+import revokeToken from './revokeToken.mjs';
+import getUserGuilds from './getUserGuilds.mjs';
+import getGuildWidget from './getGuildWidget.mjs';
+import getUserConnections from './getUserConnections.mjs';
+import addGuildMember from './addGuildMember.mjs';
+import refreshToken from './refreshToken.mjs';

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

@@ -0,0 +1,20 @@
+import addGuildMember from './addGuildMember.mjs';
+import getGuildWidget from './getGuildWidget.mjs';
+import getToken from './getToken.mjs';
+import getUser from './getUser.mjs';
+import getUserConnections from './getUserConnections.mjs';
+import getUserGuilds from './getUserGuilds.mjs';
+import refreshToken from './refreshToken.mjs';
+import revokeToken from './revokeToken.mjs';
+// Module Base
+const discord_api = {
+    getToken,
+    getUser,
+    revokeToken,
+    getUserGuilds,
+    getGuildWidget,
+    getUserConnections,
+    addGuildMember,
+    refreshToken,
+};
+export default discord_api;

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

@@ -0,0 +1,77 @@
+'use strict';
+
+var json = require('../../../http/fetch/json.cjs');
+var config = require('../config.cjs');
+var errorValidator = require('../get/errorValidator.cjs');
+
+/**
+ * Refreshes the Discord OAuth2 access token using a valid refresh token.
+ *
+ * This function makes a `POST` request to the Discord API's `/oauth2/token` endpoint
+ * to obtain a new access token and refresh token. It uses the `refresh_token` grant type.
+ *
+ * @param {Object} dsData - The Discord OAuth2 data required for token refresh.
+ * @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 original authorization code (optional but may be required by some flows).
+ * @param {string} dsData.refresh_token - The current valid refresh token.
+ * @param {string} dsData.redirect_uri - The redirect URI used in the original OAuth2 flow.
+ * @param {string} dsData.scope - The scope(s) to request (e.g., 'identify guilds').
+ *
+ * @returns {Promise<Object>} Resolves with a new token object from the Discord API:
+ * {
+ *   access_token: string,
+ *   token_type: string,
+ *   expires_in: number,
+ *   refresh_token: string,
+ *   scope: string
+ * }
+ *
+ * @throws {Object} If the request fails, rejects with an error object containing `code` and `message`.
+ *
+ * @example
+ * refreshToken({
+ *   client_id: '1234567890',
+ *   client_secret: 'mySecret',
+ *   code: 'optional-code',
+ *   refresh_token: 'old-refresh-token',
+ *   redirect_uri: 'https://myapp.com/callback',
+ *   scope: 'identify guilds'
+ * })
+ *   .then(newTokens => console.log('New Access Token:', newTokens.access_token))
+ *   .catch(err => console.error('Failed to refresh token:', err));
+ */
+function refreshToken(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: 'refresh_token',
+        code: dsData.code,
+        refresh_token: dsData.refresh_token,
+        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 = refreshToken;

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

@@ -0,0 +1,45 @@
+/**
+ * Refreshes the Discord OAuth2 access token using a valid refresh token.
+ *
+ * This function makes a `POST` request to the Discord API's `/oauth2/token` endpoint
+ * to obtain a new access token and refresh token. It uses the `refresh_token` grant type.
+ *
+ * @param {Object} dsData - The Discord OAuth2 data required for token refresh.
+ * @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 original authorization code (optional but may be required by some flows).
+ * @param {string} dsData.refresh_token - The current valid refresh token.
+ * @param {string} dsData.redirect_uri - The redirect URI used in the original OAuth2 flow.
+ * @param {string} dsData.scope - The scope(s) to request (e.g., 'identify guilds').
+ *
+ * @returns {Promise<Object>} Resolves with a new token object from the Discord API:
+ * {
+ *   access_token: string,
+ *   token_type: string,
+ *   expires_in: number,
+ *   refresh_token: string,
+ *   scope: string
+ * }
+ *
+ * @throws {Object} If the request fails, rejects with an error object containing `code` and `message`.
+ *
+ * @example
+ * refreshToken({
+ *   client_id: '1234567890',
+ *   client_secret: 'mySecret',
+ *   code: 'optional-code',
+ *   refresh_token: 'old-refresh-token',
+ *   redirect_uri: 'https://myapp.com/callback',
+ *   scope: 'identify guilds'
+ * })
+ *   .then(newTokens => console.log('New Access Token:', newTokens.access_token))
+ *   .catch(err => console.error('Failed to refresh token:', err));
+ */
+export default function refreshToken(dsData: {
+    client_id: string;
+    client_secret: string;
+    code: string;
+    refresh_token: string;
+    redirect_uri: string;
+    scope: string;
+}): Promise<Object>;