tiny-essentials 1.3.2 → 1.5.0

package/dist/legacy/firebase/getDBAsync.d.mts

@@ -8,3 +8,4 @@
  * @throws {Error} If an error occurs during the database operation, the promise will be rejected with the error.
  */
 export default function getDBAsync(data: firebase.database.Reference, type?: string): Promise<firebase.database.DataSnapshot>;
+//# sourceMappingURL=getDBAsync.d.mts.map

package/dist/legacy/firebase/getDBData.d.mts

@@ -1 +1,2 @@
 export default function getDBData(data: any, type: any): Promise<any>;
+//# sourceMappingURL=getDBData.d.mts.map

package/dist/legacy/firebase/getDBValue.d.mts

@@ -7,3 +7,4 @@
  * @returns {any} The value stored in the snapshot, or `null` if the data is invalid or doesn't contain a valid value.
  */
 export default function getDBValue(data: firebase.database.DataSnapshot): any;
+//# sourceMappingURL=getDBValue.d.mts.map

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

@@ -49,3 +49,4 @@ import getDBData from './getDBData.mjs';
 import transactionDBAsync from './transactionDBAsync.mjs';
 import databaseEscape from './databaseEscape.mjs';
 import isEmulator from './isEmulator.mjs';
+//# sourceMappingURL=index.d.mts.map

package/dist/legacy/firebase/isEmulator.d.mts

@@ -6,3 +6,4 @@
  * @returns {boolean} `true` if the Firebase Functions are running in the emulator, `false` otherwise.
  */
 export default function isEmulator(): boolean;
+//# sourceMappingURL=isEmulator.d.mts.map

package/dist/legacy/firebase/logger.d.mts

@@ -5,3 +5,4 @@ declare namespace fbLogger {
     function warn(...args: any[]): Promise<Record<string, any>>;
     function error(...args: any[]): Promise<Record<string, any>>;
 }
+//# sourceMappingURL=logger.d.mts.map

package/dist/legacy/firebase/mySQL.d.mts

@@ -8,3 +8,4 @@
  * @returns {Promise} Resolves with the connection object or rejects with an error.
  */
 export default function mySQL(mysql: Record<string, any>, databases: any[] | string, cfg: Record<string, any>): Promise<any>;
+//# sourceMappingURL=mySQL.d.mts.map

package/dist/legacy/firebase/mysqlConnector/create.d.mts

@@ -34,3 +34,4 @@
  * ]);
  */
 export default function create(mysql: Record<string, any>, proxyType: string, databases: Record<string, any> | Record<string, any>[], cfg: Record<string, any>): Promise<Record<string, any>>;
+//# sourceMappingURL=create.d.mts.map

package/dist/legacy/firebase/mysqlConnector/index.d.mts

@@ -9,3 +9,4 @@ import nextPrev from './nextPrev.mjs';
 import pagination from './pagination.mjs';
 import sameUser from './sameUser.mjs';
 import create from './create.mjs';
+//# sourceMappingURL=index.d.mts.map

package/dist/legacy/firebase/mysqlConnector/nextPrev.d.mts

@@ -29,3 +29,4 @@ export default function nextPrev(db: Record<string, any>, tiny_search: {
         positionVar: string;
     };
 }): Promise<Object | null>;
+//# sourceMappingURL=nextPrev.d.mts.map

package/dist/legacy/firebase/mysqlConnector/pagination.d.mts

@@ -31,3 +31,4 @@ export default function pagination(db: Record<string, any>, data: {
     count?: number | undefined;
     count_rows?: boolean | undefined;
 }): Promise<Record<string, any>>;
+//# sourceMappingURL=pagination.d.mts.map

package/dist/legacy/firebase/mysqlConnector/sameUser.d.mts

@@ -10,3 +10,4 @@
 export default function sameUser(database: string, login: {
     data: Object;
 }): Object | null;
+//# sourceMappingURL=sameUser.d.mts.map

package/dist/legacy/firebase/transactionDBAsync.d.mts

@@ -9,3 +9,4 @@
  * @returns {Promise} Resolves with the result of the transaction or rejects with an error if the transaction fails.
  */
 export default function transactionDBAsync(data: Record<string, any>, callback: Function): Promise<any>;
+//# sourceMappingURL=transactionDBAsync.d.mts.map

package/dist/legacy/get/countObj.d.mts

@@ -9,3 +9,4 @@
  * @returns {number} The count of elements (array) or properties (object), or 0 if not applicable.
  */
 export default function countObj(obj: any): number;
+//# sourceMappingURL=countObj.d.mts.map

package/dist/legacy/get/decimalColor.d.mts

@@ -10,3 +10,4 @@
  * @returns {number} The decimal representation of the color, or 0 if invalid.
  */
 export default function decimalColor(color: string | number, errCallback?: Function): number;
+//# sourceMappingURL=decimalColor.d.mts.map

package/dist/legacy/get/objType.d.mts

@@ -17,3 +17,4 @@
  * @returns {boolean|string|null} Returns true/false if checking, or type string/null if querying.
  */
 export default function objType(obj: any, type?: string): boolean | string | null;
+//# sourceMappingURL=objType.d.mts.map

package/dist/legacy/get/pagination.d.mts

@@ -23,3 +23,4 @@
  *   - `pages` {number} - Total number of pages.
  */
 export default function pagination(query: string, page: number, total: number, url?: string, extraClass?: string, extraClass2?: string): Record<string, any>;
+//# sourceMappingURL=pagination.d.mts.map

package/dist/legacy/get/queryUrlByName.d.mts

@@ -18,3 +18,4 @@
  * @returns {string|null} The decoded value of the parameter, or `null` if not found.
  */
 export default function queryUrlByName(name: string, url: string): string | null;
+//# sourceMappingURL=queryUrlByName.d.mts.map

package/dist/legacy/get/queryUrlJSON.d.mts

@@ -21,3 +21,4 @@
 export default function queryUrlJSON(url?: string): {
     [x: string]: string | string[];
 };
+//# sourceMappingURL=queryUrlJSON.d.mts.map

package/dist/legacy/get/super_string_filter.d.mts

@@ -23,3 +23,4 @@
  * @returns {string[]} A filtered array of strings that passed at least one validator.
  */
 export default function super_string_filter(list: string[], validator_list: (string | Object)[]): string[];
+//# sourceMappingURL=super_string_filter.d.mts.map

package/dist/legacy/get/versionCheck.d.mts

@@ -15,3 +15,4 @@ export default function versionCheck(pkg: {
     name: string;
     version: string;
 }): Promise<Record<string, any>>;
+//# sourceMappingURL=versionCheck.d.mts.map

package/dist/legacy/http/HTTP-1.0.d.mts

@@ -6,3 +6,4 @@ declare namespace http_base {
     function send(res: import("express").Response, http_code: number, callback?: (arg0: number) => void): any;
     function sendAsync(res: import("express").Response, http_code: number, callback?: (arg0: number) => Promise<any>): Promise<any>;
 }
+//# sourceMappingURL=HTTP-1.0.d.mts.map

package/dist/legacy/http/auth.d.mts

@@ -39,3 +39,4 @@ export default function auth(data: {
     password: string;
     customError?: Function | undefined;
 }, callback?: Function): Function;
+//# sourceMappingURL=auth.d.mts.map

package/dist/legacy/http/check_domain.d.mts

@@ -8,3 +8,4 @@ declare namespace check_domain {
     function validator(req: Record<string, any>, the_domain: string): boolean;
     function get(req: Record<string, any>): string | null;
 }
+//# sourceMappingURL=check_domain.d.mts.map

package/dist/legacy/http/csrfTokenAnalyze.d.mts

@@ -19,3 +19,4 @@
  * });
  */
 export default function csrfTokenAnalyze(req: Record<string, any>, res: Record<string, any>, callback?: Function): boolean;
+//# sourceMappingURL=csrfTokenAnalyze.d.mts.map

package/dist/legacy/http/domainValidator.d.mts

@@ -28,3 +28,4 @@
  * }
  */
 export default function domainValidator(req: Record<string, any>, cfg: Record<string, any>): Record<string, any>;
+//# sourceMappingURL=domainValidator.d.mts.map

package/dist/legacy/http/errorsCallback.d.mts

@@ -27,3 +27,4 @@
  * }));
  */
 export default function errorsCallback(callback: Function): Function;
+//# sourceMappingURL=errorsCallback.d.mts.map

package/dist/legacy/http/fetch/json.d.mts

@@ -20,3 +20,4 @@
  *   .catch(err => console.error('Fetch error:', err));
  */
 export default function getJsonFetch(...args: any[]): Promise<any>;
+//# sourceMappingURL=json.d.mts.map

package/dist/legacy/http/fetch/text.d.mts

@@ -19,3 +19,4 @@
  *   .catch(err => console.error('Fetch error:', err));
  */
 export default function getTextFetch(...args: any[]): Promise<string>;
+//# sourceMappingURL=text.d.mts.map

package/dist/legacy/http/fileCache.d.mts

@@ -33,3 +33,4 @@ export default function fileCache(res: object, next: Function, data: {
     timezone?: string | undefined;
     contentType?: string | undefined;
 }): void;
+//# sourceMappingURL=fileCache.d.mts.map

package/dist/legacy/http/getDomainURL.d.mts

@@ -16,3 +16,4 @@
  * getDomainURL(req, 8080);          // Uses domain from request object
  */
 export default function getDomainURL(domain: string | object, port?: number, httpResult?: string): string;
+//# sourceMappingURL=getDomainURL.d.mts.map

package/dist/legacy/http/userIP.d.mts

@@ -17,3 +17,4 @@ export default function userIp(req: import("express").Request, options?: Record<
     value: string[] | null;
     type: string | null;
 };
+//# sourceMappingURL=userIP.d.mts.map

package/dist/legacy/index.d.mts

@@ -87,3 +87,4 @@ import capitalize from './libs/capitalize.mjs';
 import getJsonFetch from './http/fetch/json.mjs';
 import getTextFetch from './http/fetch/text.mjs';
 import csrfTokenAnalyze from './http/csrfTokenAnalyze.mjs';
+//# sourceMappingURL=index.d.mts.map

package/dist/legacy/libs/arraySortPositions.d.mts

@@ -14,3 +14,4 @@
  * arr.sort(arraySortPositions('pos', true)); // Descending: [{pos: 3}, {pos: 2}, {pos: 1}]
  */
 export default function arraySortPositions(item: string, isReverse?: boolean): (a: Object, b: Object) => number;
+//# sourceMappingURL=arraySortPositions.d.mts.map

package/dist/legacy/libs/capitalize.d.mts

@@ -11,3 +11,4 @@
  * capitalize("my little pony"); // "My Little Pony"
  */
 export default function capitalize(text: string): string;
+//# sourceMappingURL=capitalize.d.mts.map

package/dist/legacy/libs/convertBytes.d.mts

@@ -15,3 +15,4 @@ declare namespace convertList {
     let eb: number;
 }
 declare const sequence: string[];
+//# sourceMappingURL=convertBytes.d.mts.map

package/dist/legacy/libs/custom_module_loader.d.mts

@@ -3,3 +3,4 @@ declare namespace custom_module_manager {
     function validator(custom_modules: Record<string, any>, type: string): boolean;
     function run(custom_modules: Object | Function[], db_prepare: any, hookType: string, options?: Record<string, any>): Promise<void>;
 }
+//# sourceMappingURL=custom_module_loader.d.mts.map

package/dist/legacy/libs/dice.d.mts

@@ -3,3 +3,4 @@ declare namespace tinyDice {
     function vanilla(obj: number): number;
     function getClientVanilla(obj: number): string;
 }
+//# sourceMappingURL=dice.d.mts.map

package/dist/legacy/libs/markdown.d.mts

@@ -73,3 +73,4 @@ declare namespace markdownManager {
     }
     function parseMarkdown(markdownText: string, type?: "result" | "bbcode"): string;
 }
+//# sourceMappingURL=markdown.d.mts.map

package/dist/legacy/libs/percentage.d.mts

@@ -2,3 +2,4 @@ export default percentageBase;
 declare namespace percentageBase {
     function run(preco: number, porcentagem: number): number;
 }
+//# sourceMappingURL=percentage.d.mts.map

package/dist/legacy/libs/regex/getLetter.d.mts

@@ -10,3 +10,4 @@ export function oneLetter(type?: string): RegExp;
  * @returns {RegExp} The regular expression to match one or more letters.
  */
 export function multiLetters(type?: string): RegExp;
+//# sourceMappingURL=getLetter.d.mts.map

package/dist/legacy/libs/replaceAsync.d.mts

@@ -13,3 +13,4 @@
  * });
  */
 export default function asyncReplace(str: string, regex: RegExp, asyncFn: Function): Promise<string>;
+//# sourceMappingURL=replaceAsync.d.mts.map

package/dist/legacy/libs/rule3.d.mts

@@ -3,3 +3,4 @@ declare namespace ruleOfThree {
     function getClient(): string;
     function execute(val1: number, val2: number, val3: number, inverse: boolean): number;
 }
+//# sourceMappingURL=rule3.d.mts.map

package/dist/legacy/libs/userLevel.d.mts

@@ -112,3 +112,4 @@ declare class TinyLevelUp {
         totalExp: number;
     };
 }
+//# sourceMappingURL=userLevel.d.mts.map

package/dist/legacy/momentjs/getAge.d.mts

@@ -6,3 +6,4 @@
  * @returns {number|null} The age in years, or null if `timeData` is not provided.
  */
 export default function getAge(timeData?: number | string, now?: moment.Moment | null): number | null;
+//# sourceMappingURL=getAge.d.mts.map

package/dist/legacy/momentjs/index.d.mts

@@ -1,3 +1,4 @@
 import timeDuration from './timeDuration.mjs';
 import getAge from './getAge.mjs';
 export { timeDuration, getAge };
+//# sourceMappingURL=index.d.mts.map

package/dist/legacy/momentjs/timeDuration.d.mts

@@ -7,3 +7,4 @@
  * @returns {number|null} The calculated duration in the specified unit (default: seconds), or `null` if `timeData` is not provided.
  */
 export default function timeDuration(timeData?: number, durationType?: string, now?: moment.Moment | null): number | null;
+//# sourceMappingURL=timeDuration.d.mts.map

package/dist/legacy/socket.io/antiFlood/index.d.mts

@@ -1,3 +1,4 @@
 import verify from './verify.mjs';
 import install from './install.mjs';
 export { verify, install };
+//# sourceMappingURL=index.d.mts.map

package/dist/legacy/socket.io/antiFlood/install.d.mts

@@ -10,3 +10,4 @@
  * @returns {void} This function does not return a value, it just sets the authorization logic for socket connections.
  */
 export default function install(io: Record<string, any>, ioCache: Record<string, any>): void;
+//# sourceMappingURL=install.d.mts.map

package/dist/legacy/socket.io/antiFlood/verify.d.mts

@@ -11,3 +11,4 @@
  * @returns {void} This function does not return anything, it modifies the floodPanel and blocklist.
  */
 export default function verify(socket: Record<string, any>, ioCache: Record<string, any>): void;
+//# sourceMappingURL=verify.d.mts.map

package/dist/legacy/socket.io/cookie-session.d.mts

@@ -7,3 +7,4 @@
  * @returns {Promise<Record<string, any>>} A promise that resolves with the session object once the session is processed.
  */
 export default function cookieSession(socket: Record<string, any>, sessionModule: Function): Promise<Record<string, any>>;
+//# sourceMappingURL=cookie-session.d.mts.map

package/dist/legacy/socket.io/discord.d.mts

@@ -8,3 +8,4 @@
  * @returns {Promise<Record<string, any>>} A promise that resolves with the user data and updates the cache.
  */
 export default function discord(socket: Record<string, any>, ioCache: Record<string, any>, token: string): Promise<Record<string, any>>;
+//# sourceMappingURL=discord.d.mts.map

package/dist/legacy/socket.io/index.d.mts

@@ -7,3 +7,4 @@ declare const socketIo: {
 import * as antiFlood from './antiFlood/index.mjs';
 import cookieSession from './cookie-session.mjs';
 import discord from './discord.mjs';
+//# sourceMappingURL=index.d.mts.map

package/dist/v1/basics/array.d.mts

@@ -8,3 +8,4 @@
  * @returns {string[]} The same array instance, now shuffled in place.
  */
 export function shuffleArray(items: string[]): string[];
+//# sourceMappingURL=array.d.mts.map

package/dist/v1/basics/clock.d.mts

@@ -35,3 +35,4 @@ export function formatTimer(seconds: number): string;
  * @returns {string} The formatted timer string in "Xd HH:MM:SS" format.
  */
 export function formatDayTimer(seconds: number): string;
+//# sourceMappingURL=clock.d.mts.map

package/dist/v1/basics/index.d.mts

@@ -15,3 +15,4 @@ import { shuffleArray } from './array.mjs';
 import { toTitleCase } from './text.mjs';
 import { toTitleCaseLowerFirst } from './text.mjs';
 export { extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst };
+//# sourceMappingURL=index.d.mts.map

package/dist/v1/basics/objFilter.cjs

@@ -23,64 +23,64 @@ var buffer = require('buffer');
  */
 const typeValidator = {
   items: {
-    /** Checks if the value is undefined. */
+    /** @param {*} val @returns {val is undefined} */
     undefined: (val) => typeof val === 'undefined',
 
-    /** Checks if the value is null. */
+    /** @param {*} val @returns {val is null} */
     null: (val) => val === null,
 
-    /** Checks if the value is a boolean. */
+    /** @param {*} val @returns {val is boolean} */
     boolean: (val) => typeof val === 'boolean',
 
-    /** Checks if the value is a number. */
+    /** @param {*} val @returns {val is number} */
     number: (val) => typeof val === 'number' && !isNaN(val),
 
-    /** Checks if the value is a bigint. */
+    /** @param {*} val @returns {val is bigint} */
     bigint: (val) => typeof val === 'bigint',
 
-    /** Checks if the value is a string. */
+    /** @param {*} val @returns {val is string} */
     string: (val) => typeof val === 'string',
 
-    /** Checks if the value is a symbol. */
+    /** @param {*} val @returns {val is symbol} */
     symbol: (val) => typeof val === 'symbol',
 
-    /** Checks if the value is a function. */
+    /** @param {*} val @returns {val is Function} */
     function: (val) => typeof val === 'function',
 
-    /** Checks if the value is an array. */
+    /** @param {*} val @returns {val is Array<any>} */
     array: (val) => Array.isArray(val),
 
-    /** Checks if the value is a Date object. */
+    /** @param {*} val @returns {val is Date} */
     date: (val) => val instanceof Date,
 
-    /** Checks if the value is a regular expression. */
+    /** @param {*} val @returns {val is RegExp} */
     regexp: (val) => val instanceof RegExp,
 
-    /** Checks if the value is a Map. */
+    /** @param {*} val @returns {val is Map<any, any>} */
     map: (val) => val instanceof Map,
 
-    /** Checks if the value is a Set. */
+    /** @param {*} val @returns {val is Set<any>} */
     set: (val) => val instanceof Set,
 
-    /** Checks if the value is a WeakMap. */
+    /** @param {*} val @returns {val is WeakMap<object, any>} */
     weakmap: (val) => val instanceof WeakMap,
 
-    /** Checks if the value is a WeakSet. */
+    /** @param {*} val @returns {val is WeakSet<object>} */
     weakset: (val) => val instanceof WeakSet,
 
-    /** Checks if the value is a Promise. */
+    /** @param {*} val @returns {val is Promise<any>} */
     promise: (val) => val instanceof Promise,
 
-    /** Checks if the value is a Buffer. */
+    /** @param {*} val @returns {val is Buffer} */
     buffer: (val) => typeof buffer.Buffer !== 'undefined' && buffer.Buffer.isBuffer(val),
 
-    /** Checks if the value is a File. */
+    /** @param {*} val @returns {val is File} */
     file: (val) => typeof File !== 'undefined' && val instanceof File,
 
-    /** Checks if the value is a Html Element. */
+    /** @param {*} val @returns {val is HTMLElement} */
     htmlelement: (val) => typeof HTMLElement !== 'undefined' && val instanceof HTMLElement,
 
-    /** Checks if the value is a non-null plain object or instance of a class. */
+    /** @param {*} val @returns {val is object} */
     object: (val) => typeof val === 'object' && val !== null,
   },
 
@@ -207,7 +207,8 @@ function cloneObjTypeOrder() {
 const getType = (val) => {
   if (val === null) return 'null';
   for (const name of typeValidator.order)
-    if (!typeValidator.items[name] || typeValidator.items[name](val)) return name;
+    if (typeof typeValidator.items[name] !== 'function' || typeValidator.items[name](val))
+      return name;
   return 'unknown';
 };
 
@@ -232,10 +233,32 @@ function objType(obj, type) {
   return result;
 }
 
+/**
+ * Checks the type of a given object and returns the validation value if a known type is detected.
+ *
+ * @param {*} obj - The object to check or identify.
+ * @returns {{ valid:*; type: string | null }} - Returns the type result.
+ */
+function checkObj(obj) {
+  /** @type {{ valid:*; type: string | null }} */
+  const data = { valid: null, type: null };
+  for (const name of typeValidator.order) {
+    if (typeof typeValidator.items[name] === 'function') {
+      const result = typeValidator.items[name](obj);
+      if (result) {
+        data.valid = result;
+        data.type = name;
+        break;
+      }
+    }
+  }
+  return data;
+}
+
 /**
  * Counts the number of elements in an array or the number of properties in an object.
  *
- * @param {*} obj - The array or object to count.
+ * @param {Array<*>|Record<string|number, any>} obj - The array or object to count.
  * @returns {number} - The count of items (array elements or object keys), or `0` if the input is neither an array nor an object.
  *
  * @example
@@ -252,6 +275,7 @@ function countObj(obj) {
   return 0;
 }
 
+exports.checkObj = checkObj;
 exports.cloneObjTypeOrder = cloneObjTypeOrder;
 exports.countObj = countObj;
 exports.extendObjType = extendObjType;

package/dist/v1/basics/objFilter.d.mts

@@ -52,10 +52,20 @@ export function cloneObjTypeOrder(): string[];
  * objType(undefined); // null
  */
 export function objType(obj: any, type?: string): boolean | string | null;
+/**
+ * Checks the type of a given object and returns the validation value if a known type is detected.
+ *
+ * @param {*} obj - The object to check or identify.
+ * @returns {{ valid:*; type: string | null }} - Returns the type result.
+ */
+export function checkObj(obj: any): {
+    valid: any;
+    type: string | null;
+};
 /**
  * Counts the number of elements in an array or the number of properties in an object.
  *
- * @param {*} obj - The array or object to count.
+ * @param {Array<*>|Record<string|number, any>} obj - The array or object to count.
  * @returns {number} - The count of items (array elements or object keys), or `0` if the input is neither an array nor an object.
  *
  * @example
@@ -63,7 +73,7 @@ export function objType(obj: any, type?: string): boolean | string | null;
  * countObj({ a: 1, b: 2 }); // 2
  * countObj('not an object'); // 0
  */
-export function countObj(obj: any): number;
+export function countObj(obj: Array<any> | Record<string | number, any>): number;
 /**
  * An object containing type validation functions and their evaluation order.
  *
@@ -85,3 +95,4 @@ export type TypeValidator = {
      */
     order: string[];
 };
+//# sourceMappingURL=objFilter.d.mts.map