tiny-essentials 1.24.0 → 1.24.1

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

@@ -1,59 +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 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<Record<string, any>>>} Resolves with an array of guild objects the user is in.
- *
- * @throws {Record<string, any>} 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

@@ -1,26 +0,0 @@
-/**
- * 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<Record<string, any>>>} Resolves with an array of guild objects the user is in.
- *
- * @throws {Record<string, any>} 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<Record<string, any>>>;
-//# sourceMappingURL=getUserGuilds.d.mts.map

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

@@ -1,53 +0,0 @@
-// @ts-nocheck
-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<Record<string, any>>>} Resolves with an array of guild objects the user is in.
- *
- * @throws {Record<string, any>} 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

@@ -1,27 +0,0 @@
-'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');
-
-// @ts-nocheck
-
-
-// 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

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

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

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

@@ -1,80 +0,0 @@
-'use strict';
-
-var json = require('../../../http/fetch/json.cjs');
-var config = require('../config.cjs');
-var errorValidator = require('../get/errorValidator.cjs');
-
-// @ts-nocheck
-
-
-/**
- * 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<Record<string, any>>} 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 {Record<string, any>} 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

@@ -1,46 +0,0 @@
-/**
- * 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<Record<string, any>>} 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 {Record<string, any>} 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<Record<string, any>>;
-//# sourceMappingURL=refreshToken.d.mts.map

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

@@ -1,74 +0,0 @@
-// @ts-nocheck
-import getJsonFetch from '../../../http/fetch/json.mjs';
-import config from '../config.mjs';
-import errorValidator from '../get/errorValidator.mjs';
-/**
- * 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<Record<string, any>>} 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 {Record<string, any>} 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) {
-    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: '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 });
-        });
-    });
-}

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

@@ -1,64 +0,0 @@
-'use strict';
-
-var json = require('../../../http/fetch/json.cjs');
-var config = require('../config.cjs');
-var errorValidator = require('../get/errorValidator.cjs');
-
-// @ts-nocheck
-
-
-/**
- * Revokes an OAuth2 access token from the Discord API.
- *
- * This function makes a `POST` request to the `/oauth2/token/revoke` endpoint to invalidate
- * a user's access token. This is useful for logout or unlink flows, and requires HTTP Basic Auth
- * using the application's client ID and client secret encoded in base64.
- *
- * @param {string} access_token - The Discord OAuth2 access token to be revoked.
- * @param {Object} tinyAuth - An object with the client_id and client_secret used to generate the Basic Auth credentials.
- * @param {string} tinyAuth.client_id - The Discord application client ID.
- * @param {string} tinyAuth.client_secret - The Discord application client secret.
- *
- * @returns {Promise<Record<string, any>>} Resolves when the token is successfully revoked.
- * The response may not contain any body if successful, so `result.data` may be empty.
- *
- * @throws {Record<string, any>} If the request fails, rejects with an error object containing `code` and `message`.
- *
- * @example
- * revokeToken('user-access-token', {
- *   client_id: '1234567890',
- *   client_secret: 'superSecret'
- * })
- *   .then(() => console.log('Token revoked'))
- *   .catch(err => console.error('Failed to revoke token:', err));
- */
-function revokeToken(access_token, tinyAuth) {
-  return new Promise(function (resolve, reject) {
-    // API URL
-    const apiURL = config.url;
-    const credentials = credentials(tinyAuth);
-
-    // Response
-    json(`${apiURL}oauth2/token/revoke`, {
-      method: 'POST',
-      body: new URLSearchParams({
-        token: access_token,
-      }),
-      headers: {
-        Authorization: `Basic ${credentials}`,
-        '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 = revokeToken;

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

@@ -1,30 +0,0 @@
-/**
- * Revokes an OAuth2 access token from the Discord API.
- *
- * This function makes a `POST` request to the `/oauth2/token/revoke` endpoint to invalidate
- * a user's access token. This is useful for logout or unlink flows, and requires HTTP Basic Auth
- * using the application's client ID and client secret encoded in base64.
- *
- * @param {string} access_token - The Discord OAuth2 access token to be revoked.
- * @param {Object} tinyAuth - An object with the client_id and client_secret used to generate the Basic Auth credentials.
- * @param {string} tinyAuth.client_id - The Discord application client ID.
- * @param {string} tinyAuth.client_secret - The Discord application client secret.
- *
- * @returns {Promise<Record<string, any>>} Resolves when the token is successfully revoked.
- * The response may not contain any body if successful, so `result.data` may be empty.
- *
- * @throws {Record<string, any>} If the request fails, rejects with an error object containing `code` and `message`.
- *
- * @example
- * revokeToken('user-access-token', {
- *   client_id: '1234567890',
- *   client_secret: 'superSecret'
- * })
- *   .then(() => console.log('Token revoked'))
- *   .catch(err => console.error('Failed to revoke token:', err));
- */
-export default function revokeToken(access_token: string, tinyAuth: {
-    client_id: string;
-    client_secret: string;
-}): Promise<Record<string, any>>;
-//# sourceMappingURL=revokeToken.d.mts.map

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

@@ -1,59 +0,0 @@
-// @ts-nocheck
-import getJsonFetch from '../../../http/fetch/json.mjs';
-import config from '../config.mjs';
-import credentials from '../get/credentials.mjs';
-import errorValidator from '../get/errorValidator.mjs';
-/**
- * Revokes an OAuth2 access token from the Discord API.
- *
- * This function makes a `POST` request to the `/oauth2/token/revoke` endpoint to invalidate
- * a user's access token. This is useful for logout or unlink flows, and requires HTTP Basic Auth
- * using the application's client ID and client secret encoded in base64.
- *
- * @param {string} access_token - The Discord OAuth2 access token to be revoked.
- * @param {Object} tinyAuth - An object with the client_id and client_secret used to generate the Basic Auth credentials.
- * @param {string} tinyAuth.client_id - The Discord application client ID.
- * @param {string} tinyAuth.client_secret - The Discord application client secret.
- *
- * @returns {Promise<Record<string, any>>} Resolves when the token is successfully revoked.
- * The response may not contain any body if successful, so `result.data` may be empty.
- *
- * @throws {Record<string, any>} If the request fails, rejects with an error object containing `code` and `message`.
- *
- * @example
- * revokeToken('user-access-token', {
- *   client_id: '1234567890',
- *   client_secret: 'superSecret'
- * })
- *   .then(() => console.log('Token revoked'))
- *   .catch(err => console.error('Failed to revoke token:', err));
- */
-export default function revokeToken(access_token, tinyAuth) {
-    return new Promise(function (resolve, reject) {
-        // API URL
-        const apiURL = config.url;
-        const credentials = credentials(tinyAuth);
-        // Response
-        getJsonFetch(`${apiURL}oauth2/token/revoke`, {
-            method: 'POST',
-            body: new URLSearchParams({
-                token: access_token,
-            }),
-            headers: {
-                Authorization: `Basic ${credentials}`,
-                '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/config.cjs

@@ -1,23 +0,0 @@
-'use strict';
-
-// @ts-nocheck
-
-/**
- * Configuration object containing Discord API and OAuth2 URLs.
- *
- * @typedef {Object} Config
- * @property {string} url - The base URL for the Discord API.
- * @property {string} oauth2 - The OAuth2 authorization URL for Discord.
- */
-
-/**
- * The configuration object for the Discord API and OAuth2.
- *
- * @type {Config}
- */
-const config = {
-  url: 'https://discord.com/api/',
-  oauth2: 'https://discord.com/oauth2/authorize',
-};
-
-module.exports = config;

package/dist/legacy/firebase/discord/config.d.mts

@@ -1,28 +0,0 @@
-export default config;
-/**
- * Configuration object containing Discord API and OAuth2 URLs.
- */
-export type Config = {
-    /**
-     * - The base URL for the Discord API.
-     */
-    url: string;
-    /**
-     * - The OAuth2 authorization URL for Discord.
-     */
-    oauth2: string;
-};
-/**
- * Configuration object containing Discord API and OAuth2 URLs.
- *
- * @typedef {Object} Config
- * @property {string} url - The base URL for the Discord API.
- * @property {string} oauth2 - The OAuth2 authorization URL for Discord.
- */
-/**
- * The configuration object for the Discord API and OAuth2.
- *
- * @type {Config}
- */
-declare const config: Config;
-//# sourceMappingURL=config.d.mts.map

package/dist/legacy/firebase/discord/config.mjs

@@ -1,18 +0,0 @@
-// @ts-nocheck
-/**
- * Configuration object containing Discord API and OAuth2 URLs.
- *
- * @typedef {Object} Config
- * @property {string} url - The base URL for the Discord API.
- * @property {string} oauth2 - The OAuth2 authorization URL for Discord.
- */
-/**
- * The configuration object for the Discord API and OAuth2.
- *
- * @type {Config}
- */
-const config = {
-    url: 'https://discord.com/api/',
-    oauth2: 'https://discord.com/oauth2/authorize',
-};
-export default config;

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

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

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

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

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

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