tiny-essentials 1.8.3 → 1.8.5

package/dist/legacy/get/objType.mjs

@@ -1,41 +1,2 @@
-// @ts-nocheck
-/**
- * Checks the internal type of an object using `Object.prototype.toString`.
- *
- * - If `type` is provided, returns `true` if it matches the object's internal type (case-insensitive).
- * - If `type` is omitted, returns the object's internal type as a lowercase string.
- *
- * Examples:
- * ```js
- * objType([], 'array'); // true
- * objType({}, 'object'); // true
- * objType('hello'); // "string"
- * objType(undefined); // null
- * ```
- *
- * @param {*} obj - The value to check the type of.
- * @param {string} [type] - Optional string to compare the object's type against.
- * @returns {boolean|string|null} Returns true/false if checking, or type string/null if querying.
- */
-export default function objType(obj, type) {
-    // Is Defined
-    if (typeof obj !== 'undefined') {
-        // Check Obj Type
-        if (typeof type === 'string') {
-            if (Object.prototype.toString.call(obj).toLowerCase() === `[object ${type}]`)
-                return true;
-            else
-                return false;
-        }
-        // Get Obj Type
-        else {
-            // Result
-            const result = Object.prototype.toString.call(obj).toLowerCase();
-            // Send Result
-            return result.substring(8, result.length - 1);
-        }
-    }
-    // Nope
-    else
-        return null;
-}
+import { objType } from '../../v1/basics/objFilter.mjs';
+export default objType;

package/dist/legacy/get/pagination.cjs

@@ -2,8 +2,20 @@
 
 var queryUrlJSON = require('./queryUrlJSON.cjs');
 
-// @ts-nocheck
-
+/**
+ *  @typedef {{
+ *  url: string; // The updated URL prefix to use for each page link.
+ *   extraClass: string; // Additional class name passed through.
+ *   extraClass2: string; // Additional class name passed through.
+ *   page: number; // The current page.
+ *   pagination: number[]; // An array of page numbers to be displayed.
+ *   previous: boolean; // Whether there are previous pages.
+ *   next: boolean; // Whether there are next pages.
+ *   firstPagination: boolean; // `true` if page 1 is not in the visible pagination and should be shown separately.
+ *   lastPagination: boolean; // `true` if the last page is not in the visible pagination and should be shown separately.
+ *   pages: number; // Total number of pages.
+ * }} PaginationData
+ */
 
 /**
  * Generates pagination metadata for a given query and current page.
@@ -17,17 +29,8 @@ var queryUrlJSON = require('./queryUrlJSON.cjs');
  * @param {string} [extraClass=''] - Additional class name for styling the pagination container.
  * @param {string} [extraClass2=''] - Additional class name for individual page links.
  *
- * @returns {Record<string, any>} Pagination metadata including:
- *   - `url` {string} - The updated URL prefix to use for each page link.
- *   - `extraClass` {string} - Additional class name passed through.
- *   - `extraClass2` {string} - Additional class name passed through.
- *   - `page` {number} - The current page.
- *   - `pagination` {number[]} - An array of page numbers to be displayed.
- *   - `previous` {boolean} - Whether there are previous pages.
- *   - `next` {boolean} - Whether there are next pages.
- *   - `firstPagination` {boolean} - `true` if page 1 is not in the visible pagination and should be shown separately.
- *   - `lastPagination` {boolean} - `true` if the last page is not in the visible pagination and should be shown separately.
- *   - `pages` {number} - Total number of pages.
+ * @returns {PaginationData} Pagination metadata
+
  */
 function pagination(
   query,
@@ -60,39 +63,41 @@ function pagination(
     } else url += finalURLResult('?');
   }
 
-  // Pagination
-
-  const pagination = [];
+  /** @type {PaginationData} */
   const data = {
     url: url,
     extraClass: extraClass,
     extraClass2: extraClass2,
+    next: false,
+    previous: false,
+    page: -1,
+    pages: -1,
+    pagination: [],
+    firstPagination: true,
+    lastPagination: true,
   };
 
-  data.next = false;
-  data.previous = false;
   for (let i = page - 1; i > page - 5; i--) {
     if (i > 0) {
-      pagination.push(i);
+      data.pagination.push(i);
       data.previous = true;
     }
   }
-  pagination.reverse();
-  pagination.push(page);
+  data.pagination.reverse();
+  data.pagination.push(page);
   for (let i = page + 1; i < page + 5; i++) {
     if (i <= total) {
-      pagination.push(i);
+      data.pagination.push(i);
       data.next = true;
     }
   }
 
   // Build Data and send it
   data.page = page;
-  data.pagination = pagination;
 
-  if (pagination.indexOf(1) < 0) data.firstPagination = true;
+  if (data.pagination.indexOf(1) < 0) data.firstPagination = true;
   else data.firstPagination = false;
-  if (pagination.indexOf(total) < 0) data.lastPagination = true;
+  if (data.pagination.indexOf(total) < 0) data.lastPagination = true;
   else data.lastPagination = false;
 
   data.pages = total;

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

@@ -1,3 +1,17 @@
+/**
+ *  @typedef {{
+ *  url: string; // The updated URL prefix to use for each page link.
+ *   extraClass: string; // Additional class name passed through.
+ *   extraClass2: string; // Additional class name passed through.
+ *   page: number; // The current page.
+ *   pagination: number[]; // An array of page numbers to be displayed.
+ *   previous: boolean; // Whether there are previous pages.
+ *   next: boolean; // Whether there are next pages.
+ *   firstPagination: boolean; // `true` if page 1 is not in the visible pagination and should be shown separately.
+ *   lastPagination: boolean; // `true` if the last page is not in the visible pagination and should be shown separately.
+ *   pages: number; // Total number of pages.
+ * }} PaginationData
+ */
 /**
  * Generates pagination metadata for a given query and current page.
  * It builds a list of pages to display and determines whether "next" and "previous" buttons should be shown.
@@ -10,17 +24,20 @@
  * @param {string} [extraClass=''] - Additional class name for styling the pagination container.
  * @param {string} [extraClass2=''] - Additional class name for individual page links.
  *
- * @returns {Record<string, any>} Pagination metadata including:
- *   - `url` {string} - The updated URL prefix to use for each page link.
- *   - `extraClass` {string} - Additional class name passed through.
- *   - `extraClass2` {string} - Additional class name passed through.
- *   - `page` {number} - The current page.
- *   - `pagination` {number[]} - An array of page numbers to be displayed.
- *   - `previous` {boolean} - Whether there are previous pages.
- *   - `next` {boolean} - Whether there are next pages.
- *   - `firstPagination` {boolean} - `true` if page 1 is not in the visible pagination and should be shown separately.
- *   - `lastPagination` {boolean} - `true` if the last page is not in the visible pagination and should be shown separately.
- *   - `pages` {number} - Total number of pages.
+ * @returns {PaginationData} Pagination metadata
+
  */
-export default function pagination(query: string, page: number, total: number, url?: string, extraClass?: string, extraClass2?: string): Record<string, any>;
+export default function pagination(query: string, page: number, total: number, url?: string, extraClass?: string, extraClass2?: string): PaginationData;
+export type PaginationData = {
+    url: string;
+    extraClass: string;
+    extraClass2: string;
+    page: number;
+    pagination: number[];
+    previous: boolean;
+    next: boolean;
+    firstPagination: boolean;
+    lastPagination: boolean;
+    pages: number;
+};
 //# sourceMappingURL=pagination.d.mts.map

package/dist/legacy/get/pagination.mjs

@@ -1,5 +1,18 @@
-// @ts-nocheck
 import queryUrlJSON from './queryUrlJSON.mjs';
+/**
+ *  @typedef {{
+ *  url: string; // The updated URL prefix to use for each page link.
+ *   extraClass: string; // Additional class name passed through.
+ *   extraClass2: string; // Additional class name passed through.
+ *   page: number; // The current page.
+ *   pagination: number[]; // An array of page numbers to be displayed.
+ *   previous: boolean; // Whether there are previous pages.
+ *   next: boolean; // Whether there are next pages.
+ *   firstPagination: boolean; // `true` if page 1 is not in the visible pagination and should be shown separately.
+ *   lastPagination: boolean; // `true` if the last page is not in the visible pagination and should be shown separately.
+ *   pages: number; // Total number of pages.
+ * }} PaginationData
+ */
 /**
  * Generates pagination metadata for a given query and current page.
  * It builds a list of pages to display and determines whether "next" and "previous" buttons should be shown.
@@ -12,17 +25,8 @@ import queryUrlJSON from './queryUrlJSON.mjs';
  * @param {string} [extraClass=''] - Additional class name for styling the pagination container.
  * @param {string} [extraClass2=''] - Additional class name for individual page links.
  *
- * @returns {Record<string, any>} Pagination metadata including:
- *   - `url` {string} - The updated URL prefix to use for each page link.
- *   - `extraClass` {string} - Additional class name passed through.
- *   - `extraClass2` {string} - Additional class name passed through.
- *   - `page` {number} - The current page.
- *   - `pagination` {number[]} - An array of page numbers to be displayed.
- *   - `previous` {boolean} - Whether there are previous pages.
- *   - `next` {boolean} - Whether there are next pages.
- *   - `firstPagination` {boolean} - `true` if page 1 is not in the visible pagination and should be shown separately.
- *   - `lastPagination` {boolean} - `true` if the last page is not in the visible pagination and should be shown separately.
- *   - `pages` {number} - Total number of pages.
+ * @returns {PaginationData} Pagination metadata
+
  */
 export default function pagination(query, page, total, url = '', extraClass = '', extraClass2 = '') {
     // Fix URL
@@ -53,37 +57,40 @@ export default function pagination(query, page, total, url = '', extraClass = ''
         else
             url += finalURLResult('?');
     }
-    // Pagination
-    const pagination = [];
+    /** @type {PaginationData} */
     const data = {
         url: url,
         extraClass: extraClass,
         extraClass2: extraClass2,
+        next: false,
+        previous: false,
+        page: -1,
+        pages: -1,
+        pagination: [],
+        firstPagination: true,
+        lastPagination: true,
     };
-    data.next = false;
-    data.previous = false;
     for (let i = page - 1; i > page - 5; i--) {
         if (i > 0) {
-            pagination.push(i);
+            data.pagination.push(i);
             data.previous = true;
         }
     }
-    pagination.reverse();
-    pagination.push(page);
+    data.pagination.reverse();
+    data.pagination.push(page);
     for (let i = page + 1; i < page + 5; i++) {
         if (i <= total) {
-            pagination.push(i);
+            data.pagination.push(i);
             data.next = true;
         }
     }
     // Build Data and send it
     data.page = page;
-    data.pagination = pagination;
-    if (pagination.indexOf(1) < 0)
+    if (data.pagination.indexOf(1) < 0)
         data.firstPagination = true;
     else
         data.firstPagination = false;
-    if (pagination.indexOf(total) < 0)
+    if (data.pagination.indexOf(total) < 0)
         data.lastPagination = true;
     else
         data.lastPagination = false;

package/dist/legacy/get/queryUrlByName.cjs

@@ -1,7 +1,5 @@
 'use strict';
 
-// @ts-nocheck
-
 /**
  * Extracts the value of a specific query parameter from a URL.
  *

package/dist/legacy/get/queryUrlByName.mjs

@@ -1,4 +1,3 @@
-// @ts-nocheck
 /**
  * Extracts the value of a specific query parameter from a URL.
  *

package/dist/legacy/get/queryUrlJSON.cjs

@@ -1,7 +1,5 @@
 'use strict';
 
-// @ts-nocheck
-
 /**
  * Parses the query string from a URL into a JSON object.
  *
@@ -32,6 +30,8 @@ function queryUrlJSON(url) {
     question === -1 || hash === question + 1
       ? url.substring(hash)
       : url.substring(question + 1, hash);
+
+  /** @type {Record<string, *>} */
   var result = {};
   query.split('&').forEach((part) => {
     if (!part) return;

package/dist/legacy/get/queryUrlJSON.mjs

@@ -1,4 +1,3 @@
-// @ts-nocheck
 /**
  * Parses the query string from a URL into a JSON object.
  *
@@ -31,6 +30,7 @@ export default function queryUrlJSON(url) {
     var query = question === -1 || hash === question + 1
         ? url.substring(hash)
         : url.substring(question + 1, hash);
+    /** @type {Record<string, *>} */
     var result = {};
     query.split('&').forEach((part) => {
         if (!part)

package/dist/legacy/get/super_string_filter.cjs

@@ -1,9 +1,6 @@
 'use strict';
 
-var objType = require('./objType.cjs');
-
-// @ts-nocheck
-
+var objFilter = require('../../v1/basics/objFilter.cjs');
 
 /**
  * Filters a list of strings by comparing each item against a list of validators.
@@ -47,36 +44,47 @@ function super_string_filter(list, validator_list) {
       }
 
       // Object
-      else if (objType(validator_list[item2], 'object')) {
+      else if (objFilter.objType(validator_list[item2], 'object')) {
         // Validator
         const tiny_validator = {};
 
         // Starts With
         tiny_validator.starts = {};
+        // @ts-ignore
         tiny_validator.starts.enabled = typeof validator_list[item2].starts === 'string';
+        // @ts-ignore
         if (tiny_validator.starts.enabled) {
+          // @ts-ignore
           tiny_validator.starts.result = list[item].startsWith(validator_list[item2].starts);
         }
 
         // Ends With
         tiny_validator.ends = {};
+        // @ts-ignore
         tiny_validator.ends.enabled = typeof validator_list[item2].ends === 'string';
+        // @ts-ignore
         if (tiny_validator.ends.enabled) {
+          // @ts-ignore
           tiny_validator.ends.result = list[item].endsWith(validator_list[item2].ends);
         }
 
         // RegExp
         tiny_validator.regexp = {};
-        tiny_validator.regexp.enabled = objType(validator_list[item2].regexp, 'regexp');
+        // @ts-ignore
+        tiny_validator.regexp.enabled = objFilter.objType(validator_list[item2].regexp, 'regexp');
+        // @ts-ignore
         if (tiny_validator.regexp.enabled) {
+          // @ts-ignore
           tiny_validator.regexp.result = list[item].match(validator_list[item2].regexp);
         }
 
         // Check Validator
         let allowed_timezone = true;
         for (const item3 in tiny_validator) {
+          // @ts-ignore
           if (tiny_validator[item3].enabled) {
             // Invalid Result
+            // @ts-ignore
             if (!tiny_validator[item3].result) {
               allowed_timezone = false;
               break;

package/dist/legacy/get/super_string_filter.mjs

@@ -1,4 +1,3 @@
-// @ts-nocheck
 import objType from './objType.mjs';
 /**
  * Filters a list of strings by comparing each item against a list of validators.
@@ -44,27 +43,38 @@ export default function super_string_filter(list, validator_list) {
                 const tiny_validator = {};
                 // Starts With
                 tiny_validator.starts = {};
+                // @ts-ignore
                 tiny_validator.starts.enabled = typeof validator_list[item2].starts === 'string';
+                // @ts-ignore
                 if (tiny_validator.starts.enabled) {
+                    // @ts-ignore
                     tiny_validator.starts.result = list[item].startsWith(validator_list[item2].starts);
                 }
                 // Ends With
                 tiny_validator.ends = {};
+                // @ts-ignore
                 tiny_validator.ends.enabled = typeof validator_list[item2].ends === 'string';
+                // @ts-ignore
                 if (tiny_validator.ends.enabled) {
+                    // @ts-ignore
                     tiny_validator.ends.result = list[item].endsWith(validator_list[item2].ends);
                 }
                 // RegExp
                 tiny_validator.regexp = {};
+                // @ts-ignore
                 tiny_validator.regexp.enabled = objType(validator_list[item2].regexp, 'regexp');
+                // @ts-ignore
                 if (tiny_validator.regexp.enabled) {
+                    // @ts-ignore
                     tiny_validator.regexp.result = list[item].match(validator_list[item2].regexp);
                 }
                 // Check Validator
                 let allowed_timezone = true;
                 for (const item3 in tiny_validator) {
+                    // @ts-ignore
                     if (tiny_validator[item3].enabled) {
                         // Invalid Result
+                        // @ts-ignore
                         if (!tiny_validator[item3].result) {
                             allowed_timezone = false;
                             break;

package/dist/legacy/get/versionCheck.cjs

@@ -4,14 +4,15 @@ var latestVersion = require('latest-version');
 var compareVersions = require('compare-versions');
 var moment = require('moment');
 
-// @ts-nocheck
+// Modules
 
-
-// Check Version
-const check_version = {
-  v: null,
-  t: null,
-};
+/**
+ * @typedef {{
+ *  needUpdate: boolean; // `true` if the current version is outdated, `false` otherwise.
+ *   now: string; // The current version of the package.
+ *   new: string; // The latest version of the package available on npm.
+ * }} VersionCheck
+ */
 
 /**
  * Checks if the package version is up-to-date by comparing it with the latest version available on npm.
@@ -21,12 +22,13 @@ const check_version = {
  * @param {string} pkg.name - The name of the package.
  * @param {string} pkg.version - The current version of the package.
  *
- * @returns {Promise<Record<string, any>>} The result object containing:
- *   - `needUpdate`: {boolean} - `true` if the current version is outdated, `false` otherwise.
- *   - `now`: {string} - The current version of the package.
- *   - `new`: {string} - The latest version of the package available on npm.
+ * @returns {Promise<VersionCheck>} The result object
+
  */
 async function versionCheck(pkg) {
+  /** @type {{ t: import('moment').Moment, v: string }} */
+  const check_version = {};
+
   // Time Now
   const now = moment();
 
@@ -36,15 +38,12 @@ async function versionCheck(pkg) {
     check_version.v = await latestVersion(pkg.name);
   }
 
-  // Insert Version
-  const result = { needUpdate: compareVersions.compare(pkg.version, check_version.v, '<') };
-
   // Allowed Show Version
-  result.now = pkg.version;
-  result.new = check_version.v;
-
-  // Return
-  return result;
+  return {
+    now: pkg.version,
+    new: check_version.v,
+    needUpdate: compareVersions.compare(pkg.version, check_version.v, '<'),
+  };
 }
 
 module.exports = versionCheck;

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

@@ -1,3 +1,10 @@
+/**
+ * @typedef {{
+ *  needUpdate: boolean; // `true` if the current version is outdated, `false` otherwise.
+ *   now: string; // The current version of the package.
+ *   new: string; // The latest version of the package available on npm.
+ * }} VersionCheck
+ */
 /**
  * Checks if the package version is up-to-date by comparing it with the latest version available on npm.
  * The version check is cached and updated every hour.
@@ -6,13 +13,16 @@
  * @param {string} pkg.name - The name of the package.
  * @param {string} pkg.version - The current version of the package.
  *
- * @returns {Promise<Record<string, any>>} The result object containing:
- *   - `needUpdate`: {boolean} - `true` if the current version is outdated, `false` otherwise.
- *   - `now`: {string} - The current version of the package.
- *   - `new`: {string} - The latest version of the package available on npm.
+ * @returns {Promise<VersionCheck>} The result object
+
  */
 export default function versionCheck(pkg: {
     name: string;
     version: string;
-}): Promise<Record<string, any>>;
+}): Promise<VersionCheck>;
+export type VersionCheck = {
+    needUpdate: boolean;
+    now: string;
+    new: string;
+};
 //# sourceMappingURL=versionCheck.d.mts.map

package/dist/legacy/get/versionCheck.mjs

@@ -1,13 +1,14 @@
-// @ts-nocheck
 // Modules
 import latestVersion from 'latest-version';
 import { compare } from 'compare-versions';
 import moment from 'moment';
-// Check Version
-const check_version = {
-    v: null,
-    t: null,
-};
+/**
+ * @typedef {{
+ *  needUpdate: boolean; // `true` if the current version is outdated, `false` otherwise.
+ *   now: string; // The current version of the package.
+ *   new: string; // The latest version of the package available on npm.
+ * }} VersionCheck
+ */
 /**
  * Checks if the package version is up-to-date by comparing it with the latest version available on npm.
  * The version check is cached and updated every hour.
@@ -16,12 +17,12 @@ const check_version = {
  * @param {string} pkg.name - The name of the package.
  * @param {string} pkg.version - The current version of the package.
  *
- * @returns {Promise<Record<string, any>>} The result object containing:
- *   - `needUpdate`: {boolean} - `true` if the current version is outdated, `false` otherwise.
- *   - `now`: {string} - The current version of the package.
- *   - `new`: {string} - The latest version of the package available on npm.
+ * @returns {Promise<VersionCheck>} The result object
+
  */
 export default async function versionCheck(pkg) {
+    /** @type {{ t: import('moment').Moment, v: string }} */
+    const check_version = {};
     // Time Now
     const now = moment();
     // Check Version
@@ -29,11 +30,10 @@ export default async function versionCheck(pkg) {
         check_version.t = now.add(1, 'hours');
         check_version.v = await latestVersion(pkg.name);
     }
-    // Insert Version
-    const result = { needUpdate: compare(pkg.version, check_version.v, '<') };
     // Allowed Show Version
-    result.now = pkg.version;
-    result.new = check_version.v;
-    // Return
-    return result;
+    return {
+        now: pkg.version,
+        new: check_version.v,
+        needUpdate: compare(pkg.version, check_version.v, '<'),
+    };
 }

package/dist/legacy/http/HTTP-1.0.cjs

@@ -1,7 +1,5 @@
 'use strict';
 
-// @ts-nocheck
-
 /**
  * @module http_base
  *
@@ -77,9 +75,9 @@ const http_base = {
    * @function send
    * @param {import('express').Response} res - Express response object.
    * @param {number} http_code - HTTP status code to send.
-   * @param {function(number): void} [callback] - Optional callback to handle response body manually.
+   * @param {function(number): import('express').Response} [callback] - Optional callback to handle response body manually.
    *
-   * @returns {*} The result of `res.send()` or the callback function.
+   * @returns {import('express').Response} The result of `res.send()` or the callback function.
    *
    * @example
    * http_base.send(res, 404); // Sends 404 Not Found with empty body

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

@@ -3,7 +3,7 @@ declare namespace http_base {
     let list: {
         [x: number]: string;
     };
-    function send(res: import("express").Response, http_code: number, callback?: (arg0: number) => void): any;
+    function send(res: import("express").Response, http_code: number, callback?: (arg0: number) => import("express").Response): import("express").Response;
     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/HTTP-1.0.mjs

@@ -1,4 +1,3 @@
-// @ts-nocheck
 /**
  * @module http_base
  *
@@ -68,9 +67,9 @@ const http_base = {
      * @function send
      * @param {import('express').Response} res - Express response object.
      * @param {number} http_code - HTTP status code to send.
-     * @param {function(number): void} [callback] - Optional callback to handle response body manually.
+     * @param {function(number): import('express').Response} [callback] - Optional callback to handle response body manually.
      *
-     * @returns {*} The result of `res.send()` or the callback function.
+     * @returns {import('express').Response} The result of `res.send()` or the callback function.
      *
      * @example
      * http_base.send(res, 404); // Sends 404 Not Found with empty body

package/dist/legacy/http/auth.cjs

@@ -1,7 +1,5 @@
 'use strict';
 
-// @ts-nocheck
-
 /**
  * Creates an Express middleware for Basic HTTP Authentication.
  *
@@ -15,10 +13,10 @@
  * @param {Object} data - Configuration object.
  * @param {string} data.login - The expected username.
  * @param {string} data.password - The expected password.
- * @param {Function} [data.customError] - Optional function `(req, res) => {}` called on auth failure.
+ * @param {function(import('express').Request, import('express').Response): import('express').Response} [data.customError] - Optional function `(req, res) => {}` called on auth failure.
  * @param {Function} [callback] - Optional fallback function `(req, res, next) => {}` executed after customError.
  *
- * @returns {Function} Express middleware function.
+ * @returns {function(import('express').Request, import('express').Response, import('express').NextFunction): void} Express middleware function.
  *
  * @example
  * import express from 'express';