@putkoff/abstract-utilities 1.0.103 → 1.0.113

package/dist/types/functions/math_utils/index.d.ts

@@ -1,6 +1,6 @@
-export * from './safe_math';
-export * from './conversions';
-export * from './constants';
-export * from './scaleInterfaces';
-export * from './time_utils';
-export * from './bigint_utils';
+export * from './safe_math.js';
+export * from './conversions.js';
+export * from './constants.js';
+export * from './scaleInterfaces.js';
+export * from './time_utils.js';
+export * from './bigint_utils.js';

package/dist/types/functions/math_utils/index.js

@@ -0,0 +1,6 @@
+export * from './safe_math';
+export * from './conversions';
+export * from './constants';
+export * from './scaleInterfaces';
+export * from './time_utils';
+export * from './bigint_utils';

package/dist/types/functions/math_utils/safe_math.js

@@ -0,0 +1,35 @@
+import { ensure_number } from './../type_utils';
+// take N args and coerce them all to numbers
+export function safeNums(...args) {
+    return args.map(ensure_number);
+}
+// divide the first value by each of the following
+export function safeDivide(...args) {
+    const [head, ...rest] = safeNums(...args);
+    // if we don’t have a head or any divisor is zero, bail
+    if (head === 0 || rest.some((d) => d === 0))
+        return 0;
+    return rest.reduce((acc, d) => acc / d, head);
+}
+// multiply all the values together
+export function safeMultiply(...args) {
+    const nums = safeNums(...args);
+    // if any number is zero, result is zero
+    if (nums.includes(0))
+        return 0;
+    return nums.reduce((acc, n) => acc * n, 1);
+}
+// round a value to two decimals by percent
+export function roundPercentage(x) {
+    const pct = safeMultiply(ensure_number(x), 100);
+    return safeDivide(Math.round(pct), 100);
+}
+export function exponential(i, k) {
+    return i * (10 ** (k));
+}
+export function isZero(obj) {
+    if (obj == 0) {
+        return true;
+    }
+    return false;
+}

package/dist/types/functions/math_utils/scaleInterfaces.js

@@ -0,0 +1,3 @@
+// DO NOT import TimeUnit from chart.js
+// import { TimeUnit } from 'chart.js'  // ❌ remove
+export {};

package/dist/types/functions/math_utils/time_utils.js

@@ -0,0 +1,4 @@
+// Function to check time interval
+export function isTimeInterval(timeObj, interval) {
+    return (Date.now() / 1000 - timeObj) < (interval - 1);
+}

package/dist/types/functions/path_utils/imports.d.ts

@@ -16,6 +16,6 @@ export { _url as url };
  * If you only ever need to strip off “file://” in development, this is enough.
  */
 export declare function fileURLToPath(fileUrl: string): string;
-export { eatOuter, eatInner } from './../string_utils';
-export { ensure_list } from './../type_utils';
+export { eatOuter, eatInner } from './../string_utils/index.js';
+export { ensure_list } from './../type_utils/index.js';
 export declare function getAbsolutePath(): string;

package/dist/types/functions/path_utils/imports.js

@@ -0,0 +1,27 @@
+/**
+ * In the browser we already have a WHATWG URL constructor on window.
+ * Here we re-export it as “url” so other modules can import it.
+ */
+const _url = typeof window !== 'undefined' ? window.URL : undefined;
+export { _url as url };
+/**
+ * Minimal fileURLToPath implementation for browser-side code.
+ * If you only ever need to strip off “file://” in development, this is enough.
+ */
+export function fileURLToPath(fileUrl) {
+    // e.g. fileUrl = "file:///Users/foo/bar.txt"
+    try {
+        const u = new URL(fileUrl);
+        return u.pathname;
+    }
+    catch (_a) {
+        // fallback: just strip file://
+        return fileUrl.replace(/^file:\/\//, '');
+    }
+}
+export { eatOuter, eatInner } from './../string_utils';
+export { ensure_list } from './../type_utils';
+export function getAbsolutePath() {
+    return fileURLToPath(import.meta.url);
+}
+;

package/dist/types/functions/path_utils/index.d.ts

@@ -1 +1 @@
-export * from './src';
+export * from './src/index.js';

package/dist/types/functions/path_utils/index.js

@@ -0,0 +1 @@
+export * from './src';

package/dist/types/functions/path_utils/src/base_dirs.js

@@ -0,0 +1,17 @@
+import { make_path, get_dirname } from './path_utils';
+import { getSrcDir } from './src_dirs';
+export function getBaseDir() {
+    return get_dirname(getSrcDir());
+}
+export function getPublicDir() {
+    return make_path(getBaseDir(), 'public');
+}
+;
+export function getDistDir() {
+    return make_path(getBaseDir(), 'dist');
+}
+;
+export function getEnvDir() {
+    return make_path(getBaseDir(), '.env');
+}
+;

package/dist/types/functions/path_utils/src/function_dirs.js

@@ -0,0 +1,42 @@
+import { make_path, get_dirname } from './path_utils';
+import { getAbsDir } from './paths';
+export function getFunctionsDir() {
+    return get_dirname(getAbsDir());
+}
+;
+export function geAuthsUtilsDirectory() {
+    return make_path(getFunctionsDir(), 'auths');
+}
+;
+export function geBackupsUtilsDirectory() {
+    return make_path(getFunctionsDir(), 'backups');
+}
+;
+export function geConstantsUtilsDirectory() {
+    return make_path(getFunctionsDir(), 'constants');
+}
+;
+export function geEnvUtilsDirectory() {
+    return make_path(getFunctionsDir(), 'env_utils');
+}
+;
+export function geFetchUtilsDirectory() {
+    return make_path(getFunctionsDir(), 'fetch_utils');
+}
+;
+export function geFileUtilsDirectory() {
+    return make_path(getFunctionsDir(), 'file_utils');
+}
+;
+export function gePathUtilsDirectory() {
+    return make_path(getFunctionsDir(), 'path_utils');
+}
+;
+export function geStringUtilsDirectory() {
+    return make_path(getFunctionsDir(), 'string_utils');
+}
+;
+export function geTypeUtilsDirectory() {
+    return make_path(getFunctionsDir(), 'type_utils');
+}
+;

package/dist/types/functions/path_utils/src/index.d.ts

@@ -1,6 +1,6 @@
-export * from './path_utils';
-export * from './paths';
-export * from './function_dirs';
-export * from './src_dirs';
-export * from './base_dirs';
-export * from './misc_dirs';
+export * from './path_utils.js';
+export * from './paths.js';
+export * from './function_dirs.js';
+export * from './src_dirs.js';
+export * from './base_dirs.js';
+export * from './misc_dirs.js';

package/dist/types/functions/path_utils/src/index.js

@@ -0,0 +1,6 @@
+export * from './path_utils';
+export * from './paths';
+export * from './function_dirs';
+export * from './src_dirs';
+export * from './base_dirs';
+export * from './misc_dirs';

package/dist/types/functions/path_utils/src/misc_dirs.js

@@ -0,0 +1,15 @@
+import { getBaseDir, getEnvDir } from './base_dirs';
+import { make_path } from './path_utils';
+export function getEnvPath(string = '.env') {
+    return make_path(getEnvDir(), string);
+}
+;
+export function getDbConfigsPath() {
+    return make_path(getBaseDir(), 'dbConfigs');
+}
+export function getSchemasPath() {
+    return make_path(getDbConfigsPath(), 'schemas');
+}
+export function getSchemasDirPath(subPath) {
+    return make_path(getSchemasPath(), subPath);
+}

package/dist/types/functions/path_utils/src/path_utils.js

@@ -0,0 +1,160 @@
+import * as path from 'path-browserify';
+import { eatOuter, eatInner, ensure_list } from './../imports';
+export function get_dirname(filePath) {
+    if (!filePath)
+        return '';
+    return path.dirname(filePath);
+}
+export function get_basename(filePath) {
+    if (!filePath)
+        return '';
+    return path.basename(filePath);
+}
+export function get_filename(filePath) {
+    if (!filePath)
+        return '';
+    const ext = path.extname(filePath);
+    return path.basename(filePath, ext);
+}
+export function get_extname(filePath) {
+    if (!filePath)
+        return '';
+    return path.extname(filePath);
+}
+export function get_splitext(filePath) {
+    if (!filePath)
+        return { filename: '', extname: '' };
+    const ext = path.extname(filePath);
+    // Get the basename without the extension
+    const filename = path.basename(filePath, ext);
+    return { filename, ext };
+}
+/**
+ * Returns the path of `targetPath` relative to `basePath`.
+ * Normalizes separators for consistent web and server environments.
+ *
+ * @param basePath - The base directory you want to compare from.
+ * @param targetPath - The full path of the file/directory.
+ * @returns A normalized relative path (e.g., "subdir/file.txt").
+ */
+export function get_relative_path(basePath, targetPath) {
+    try {
+        // Compute the relative path using Node's native path.relative
+        let rel = path.relative(basePath, targetPath);
+        // Normalize to POSIX-style slashes for consistency (especially on Windows)
+        rel = rel.split(path.sep).join('/');
+        // Avoid empty string (happens if both paths are identical)
+        return rel || '.';
+    }
+    catch (err) {
+        console.error(`[get_relative_path] Error computing relative path`, err);
+        return targetPath;
+    }
+}
+/**
+ * Join multiple path segments — clean, predictable, bulletproof.
+ *
+ * Accepts ANYTHING that ensure_list can handle:
+ *   • 'a,b,c'
+ *   • ['a', 'b,c']
+ *   • 'a/b/c'
+ *   • '/a/', 'b//c'
+ *   • mixed arrays, comma strings, whatever
+ *
+ * Always returns a clean POSIX path string. Never a list.
+ */
+export function make_path(...parts) {
+    // Normalize incoming segments into a flat list
+    const segments = ensure_list(parts).map(x => String(x));
+    let out = "";
+    for (let i = 0; i < segments.length; i++) {
+        const seg = segments[i];
+        // Normalize a segment:
+        let cleaned = eatOuter(seg, "/"); // trim trailing slashes
+        if (!cleaned)
+            continue;
+        if (out === "") {
+            out = cleaned;
+        }
+        else {
+            cleaned = eatInner(cleaned, "/"); // trim leading slashes
+            out = `${out}/${cleaned}`;
+        }
+    }
+    return out;
+}
+export function sanitizeFilename(filename) {
+    return filename
+        .toLowerCase()
+        .replace(/\s+|-/g, '-') // Replace spaces and hyphens with single hyphen
+        .replace(/_/g, '-') // Replace underscores with hyphens
+        .replace(/[^a-z0-9-.]/g, '') // Remove all non-alphanumeric chars except hyphen and dot
+        .replace(/-+/g, '-') // Collapse multiple hyphens into one
+        .replace(/^-|-$/, ''); // Remove leading/trailing hyphens
+}
+export function make_sanitized_path(...paths) {
+    let real_path = '';
+    for (let i = 0; i < paths.length; i++) {
+        const sanitized = sanitizeFilename(eatOuter(paths[i], '/'));
+        if (i === 0) {
+            real_path = sanitized;
+        }
+        else if (sanitized) { // Only append if there's a non-empty segment
+            real_path = `${real_path}/${sanitized}`;
+        }
+    }
+    return real_path || '';
+}
+export function normalizeUrl(base, p) {
+    if (!p)
+        return base;
+    const cleanBase = base.replace(/\/+$/, ''); // regex literal
+    const cleanPath = p.replace(/^\/+/, '');
+    // collapse multiple “//” into one, but keep the “://” after protocol
+    return `${cleanBase}/${cleanPath}`.replace(/([^:])\/{2,}/g, '$1/');
+}
+export function pathjoin(...parts) {
+    return make_path(...parts);
+}
+export function pathJoin(...parts) {
+    return make_path(...parts);
+}
+export function makepath(...parts) {
+    return make_path(...parts);
+}
+export function makePath(...parts) {
+    return make_path(...parts);
+}
+export function path_join(...parts) {
+    return make_path(...parts);
+}
+export function getSplitext(filePath) {
+    return get_splitext(filePath);
+}
+export function getsplitext(filePath) {
+    return get_splitext(filePath);
+}
+export function getextname(filePath) {
+    return get_extname(filePath);
+}
+export function getExtname(filePath) {
+    return get_extname(filePath);
+}
+export function getfilename(filePath) {
+    return get_filename(filePath);
+}
+export function getFilename(filePath) {
+    return get_filename(filePath);
+}
+export function getbasename(filePath) {
+    return get_basename(filePath);
+}
+export function getBasename(filePath) {
+    return get_basename(filePath);
+}
+export function getdirname(filePath) {
+    return get_dirname(filePath);
+}
+export function getDirname(filePath) {
+    return get_dirname(filePath);
+}

package/dist/types/functions/path_utils/src/paths.js

@@ -0,0 +1,12 @@
+import { getAbsolutePath } from './../imports';
+import { get_dirname, make_path } from './path_utils';
+/**
+ * Returns the absolute path of the current file.
+ */
+export function getAbsDir() {
+    return get_dirname(getAbsolutePath());
+}
+;
+export function getAbsPath(subPath) {
+    return make_path(getAbsDir(), subPath);
+}

package/dist/types/functions/path_utils/src/src_dirs.js

@@ -0,0 +1,25 @@
+import { make_path, get_dirname } from './path_utils';
+import { getFunctionsDir } from './function_dirs';
+export function getSrcDir() {
+    return get_dirname(getFunctionsDir());
+}
+;
+export function geStaticDirectory() {
+    return make_path(getSrcDir(), 'static');
+}
+;
+export function getLibUtilsDirectory() {
+    return make_path(getSrcDir(), 'lib');
+}
+export function getHooksUtilsDirectory() {
+    return make_path(getSrcDir(), 'hooks');
+}
+;
+export function getFunctionsUtilsDirectory() {
+    return make_path(getSrcDir(), 'functions');
+}
+;
+export function getComponentsUtilsDirectory() {
+    return make_path(getSrcDir(), 'components');
+}
+;

package/dist/types/functions/print_utils/imports.d.ts

@@ -1 +1 @@
-export * from './../inspect_utils';
+export * from './../inspect_utils/index.js';

package/dist/types/functions/print_utils/imports.js

@@ -0,0 +1 @@
+export * from './../inspect_utils';

package/dist/types/functions/print_utils/index.d.ts

@@ -1 +1 @@
-export * from './src';
+export * from './src/index.js';

package/dist/types/functions/print_utils/index.js

@@ -0,0 +1 @@
+export * from './src';

package/dist/types/functions/print_utils/src/index.d.ts

@@ -1 +1 @@
-export * from './print_utils';
+export * from './print_utils.js';

package/dist/types/functions/print_utils/src/index.js

@@ -0,0 +1 @@
+export * from './print_utils';

package/dist/types/functions/print_utils/src/print_utils.js

@@ -0,0 +1,14 @@
+import { getLastCaller, inspect } from './../imports';
+export function debugPrint(value, label = null) {
+    const caller = getLastCaller();
+    const header = label !== null && label !== void 0 ? label : (caller
+        ? `${caller.functionName} @ ${caller.file}:${caller.line}`
+        : "object");
+    console.log(`\n🔍 ${header}`);
+    console.log(inspect(value, {
+        depth: null,
+        colors: true,
+        compact: false,
+        maxArrayLength: null,
+    }));
+}

package/dist/types/functions/read_utils/imports.d.ts

@@ -1 +1 @@
-export { safeGlobalProp } from './../safe_utils';
+export { safeGlobalProp } from './../safe_utils/index.js';

package/dist/types/functions/read_utils/imports.js

@@ -0,0 +1 @@
+export { safeGlobalProp } from './../safe_utils';

package/dist/types/functions/read_utils/index.d.ts

@@ -1 +1 @@
-export * from './src';
+export * from './src/index.js';

package/dist/types/functions/read_utils/index.js

@@ -0,0 +1 @@
+export * from './src';

package/dist/types/functions/read_utils/src/index.d.ts

@@ -1,3 +1,3 @@
-export * from './readJsonFile.browser';
-export * from './readJsonFile.node';
-export * from './readJsonFile';
+export * from './readJsonFile.browser.js';
+export * from './readJsonFile.node.js';
+export * from './readJsonFile.js';

package/dist/types/functions/read_utils/src/index.js

@@ -0,0 +1,3 @@
+export * from './readJsonFile.browser';
+export * from './readJsonFile.node';
+export * from './readJsonFile';

package/dist/types/functions/read_utils/src/readJsonFile.browser.js

@@ -0,0 +1,26 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { safeGlobalProp } from "./../imports";
+export function readJsonFileBrowser(url) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const fetchFn = safeGlobalProp("fetch");
+        if (typeof fetchFn !== "function")
+            return null;
+        try {
+            const res = yield fetchFn(url);
+            if (!res.ok)
+                return null;
+            return (yield res.json());
+        }
+        catch (_a) {
+            return null;
+        }
+    });
+}

package/dist/types/functions/read_utils/src/readJsonFile.js

@@ -0,0 +1,35 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+export function readJsonFile(relativeOrAbsolutePath) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        if (typeof process !== "undefined" && ((_a = process.versions) === null || _a === void 0 ? void 0 : _a.node)) {
+            const mod = yield import("./readJsonFile.node");
+            return mod.readJsonFileNode(relativeOrAbsolutePath);
+        }
+        else {
+            const mod = yield import("./readJsonFile.browser");
+            return mod.readJsonFileBrowser(relativeOrAbsolutePath);
+        }
+    });
+}
+export function getConfigContent() {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            // `readJsonFile` should throw if the file isn’t there or isn’t valid JSON
+            const cfg = yield readJsonFile('./config.json');
+            return cfg;
+        }
+        catch (_a) {
+            // swallow errors & return null so callers can detect “no config”
+            return null;
+        }
+    });
+}

package/dist/types/functions/read_utils/src/readJsonFile.node.js

@@ -0,0 +1,13 @@
+import { readFileSync } from "node:fs";
+import { resolve, isAbsolute } from "node:path";
+export function readJsonFileNode(relativeOrAbsolutePath) {
+    try {
+        const filePath = isAbsolute(relativeOrAbsolutePath)
+            ? relativeOrAbsolutePath
+            : resolve(process.cwd(), relativeOrAbsolutePath);
+        return JSON.parse(readFileSync(filePath, "utf8"));
+    }
+    catch (_a) {
+        return null;
+    }
+}

package/dist/types/functions/rndm_utils/imports.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/functions/rndm_utils/imports.js

@@ -0,0 +1 @@
+"use strict";

package/dist/types/functions/rndm_utils/index.d.ts

@@ -1 +1 @@
-export * from './src';
+export * from './src/index.js';

package/dist/types/functions/rndm_utils/index.js

@@ -0,0 +1 @@
+export * from './src';

package/dist/types/functions/rndm_utils/src/index.d.ts

@@ -1 +1 @@
-export * from './utils';
+export * from './utils.js';

package/dist/types/functions/rndm_utils/src/index.js

@@ -0,0 +1 @@
+export * from './utils';

package/dist/types/functions/rndm_utils/src/utils.js

@@ -0,0 +1,12 @@
+// src/functions/rndm_utils/utils.ts
+export function alertit(obj = null) {
+    let msg;
+    try {
+        msg = JSON.stringify(obj);
+    }
+    catch (_a) {
+        // If JSON.stringify fails (circular refs, etc.), fall back to a simple string
+        msg = String(obj);
+    }
+    alert(msg);
+}

package/dist/types/functions/safe_utils/imports.d.ts

@@ -1 +1 @@
-export * from './src';
+export * from './src/index.js';

package/dist/types/functions/safe_utils/imports.js

@@ -0,0 +1 @@
+export * from './src';

package/dist/types/functions/safe_utils/index.d.ts

@@ -1 +1 @@
-export * from './src';
+export * from './src/index.js';

package/dist/types/functions/safe_utils/index.js

@@ -0,0 +1 @@
+export * from './src';

package/dist/types/functions/safe_utils/src/index.d.ts

@@ -1,4 +1,4 @@
-export * from './safe_document';
-export * from './safe_storage';
-export * from './safe_globals';
-export * from './safe_window';
+export * from './safe_document.js';
+export * from './safe_storage.js';
+export * from './safe_globals.js';
+export * from './safe_window.js';

package/dist/types/functions/safe_utils/src/index.js

@@ -0,0 +1,4 @@
+export * from './safe_document';
+export * from './safe_storage';
+export * from './safe_globals';
+export * from './safe_window';

package/dist/types/functions/safe_utils/src/safe_document.js

@@ -0,0 +1,12 @@
+export function getSafeDocument() {
+    return typeof document !== 'undefined' ? document : undefined;
+}
+export function getDocumentProp(...keys) {
+    let obj = getSafeDocument();
+    for (const k of keys) {
+        if (obj == null || typeof obj !== 'object')
+            return undefined;
+        obj = obj[k];
+    }
+    return obj;
+}