@putkoff/abstract-utilities 1.0.50 → 1.0.63

package/dist/cjs/index.js

@@ -1,11 +1,9 @@
 'use strict';
 
-var react = require('react');
 var path$1 = require('path');
 var fs$1 = require('node:fs');
 var fsp = require('node:fs/promises');
 var path$2 = require('node:path');
-var jsxRuntime = require('react/jsx-runtime');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 function _interopNamespaceDefault(e) {
@@ -29,167 +27,6 @@ var fs__namespace = /*#__PURE__*/_interopNamespaceDefault(fs$1);
 var fsp__namespace = /*#__PURE__*/_interopNamespaceDefault(fsp);
 var path__namespace = /*#__PURE__*/_interopNamespaceDefault(path$2);
 
-function getSafeDocument() {
-    return typeof document !== 'undefined' ? document : undefined;
-}
-function getDocumentProp(...keys) {
-    let obj = getSafeDocument();
-    for (const k of keys) {
-        if (obj == null || typeof obj !== 'object')
-            return undefined;
-        obj = obj[k];
-    }
-    return obj;
-}
-
-/**
- * Safely walk `globalThis` (or window/document) by a chain of property names.
- * Returns `undefined` if any step is missing.
- */
-function safeGlobalProp(...path) {
-    let obj = globalThis;
-    for (const key of path) {
-        if (obj == null || typeof obj !== "object" || !(key in obj)) {
-            return undefined;
-        }
-        obj = obj[key];
-    }
-    return obj;
-}
-
-/**
- * Returns `window` if running in a browser, otherwise `undefined`.
- */
-function getSafeLocalStorage() {
-    if (typeof window === 'undefined')
-        return undefined;
-    try {
-        return window.localStorage;
-    }
-    catch (_a) {
-        return undefined; // e.g. Safari private-mode block
-    }
-}
-/**
- * Call a Storage method by name, silencing any errors or missing storage.
- *
- * @param method  One of the keys of the Storage interface: "getItem", "setItem", etc.
- * @param args    The arguments you’d normally pass to that method.
- * @returns       The method’s return value, or undefined if storage/method isn’t available.
- */
-function callStorage(method, ...args) {
-    const storage = getSafeLocalStorage();
-    if (!storage)
-        return undefined;
-    const fn = storage[method];
-    if (typeof fn !== 'function')
-        return undefined;
-    try {
-        // @ts-ignore – TS can’t infer that this is callable
-        return fn.apply(storage, args);
-    }
-    catch (_a) {
-        return undefined;
-    }
-}
-/**
- * Safely call storage methods (`localStorage` or `sessionStorage`) without blowing up.
- * Returns `undefined` on any error.
- */
-function safeStorage(storageName, method, ...args) {
-    try {
-        const store = safeGlobalProp(storageName);
-        if (!store || typeof store[method] !== "function")
-            return undefined;
-        // @ts-ignore
-        return store[method](...args);
-    }
-    catch (_a) {
-        return undefined;
-    }
-}
-
-/**
- * Returns the global window object if it exists, otherwise undefined.
- */
-function getSafeWindow() {
-    return typeof window !== 'undefined' ? window : undefined;
-}
-/**
- * Safely call a method on window by name.
- *
- * @param method  The Window method to call (e.g. "alert", "open", etc.).
- * @param args    Arguments to pass to that method.
- * @returns       The method’s return value, or undefined if
- *                 window/method isn’t available or throws.
- */
-function callWindowMethod(method, ...args) {
-    const w = getSafeWindow();
-    if (!w)
-        return undefined;
-    const fn = w[method];
-    if (typeof fn !== 'function')
-        return undefined;
-    try {
-        // cast to any so TS doesn’t complain about apply/invoke
-        return fn(...args);
-    }
-    catch (_a) {
-        return undefined;
-    }
-}
-/** implementation */
-function getWindowProp(...keys) {
-    let obj = getSafeWindow();
-    for (const k of keys) {
-        if (obj == null || typeof obj !== 'object')
-            return undefined;
-        obj = obj[k];
-    }
-    return obj;
-}
-function getWindowHost() {
-    return getWindowProp('location', 'host');
-}
-
-/**
-***Changes**:
-*- Updated import path for `InputProps` to `../../types/interfaces`.
-*
-*3. **Token Utilities** (`src/functions/auth/token_utils.ts`):
-*   Copy from `/var/www/abstractendeavors/my-login-app/src/functions/auth_utils/token_utils.ts`.
-*
-*/
-/** Read raw JWT from LocalStorage (or null if absent) */
-function getToken() {
-    return callStorage('getItem', 'token');
-}
-function isLoggedIn() {
-    const tok = getToken();
-    return !!tok && !isTokenExpired(tok !== null && tok !== void 0 ? tok : "");
-}
-/**
- * Add a Bearer Authorization header.
- * A shallow copy of headers is returned so callers can keep chaining.
- */
-function getAuthorizationHeader(headers = {}, token = null) {
-    token = token !== null && token !== void 0 ? token : getToken();
-    headers = headers || {};
-    if (token)
-        headers["Authorization"] = `Bearer ${token}`;
-    return Object.assign({}, headers);
-}
-/** Throw + redirect if there’s no valid token; otherwise return it. */
-function requireToken() {
-    const tok = getToken();
-    if (!tok || isTokenExpired(tok)) {
-        console.warn("→ No token or expired token, redirecting to login…");
-        localStorage.removeItem("token");
-        window.location.href = '/';
-        throw new Error("Redirecting to login…");
-    }
-    return tok;
-}
 /** True if token is structurally bad or its exp ≤ now. */
 function isTokenExpired(token) {
     try {
@@ -200,47 +37,6 @@ function isTokenExpired(token) {
         return true; // treat malformed token as expired
     }
 }
-/** Convenience wrapper: return username from the JWT (or null). */
-function currentUsername() {
-    const tok = getToken();
-    if (!tok)
-        return null;
-    try {
-        const { username } = decodeJwt(tok);
-        return username !== null && username !== void 0 ? username : null;
-    }
-    catch (_a) {
-        return null;
-    }
-}
-function currentUsernames() {
-    var _a;
-    const tok = getToken();
-    if (!tok)
-        return null;
-    try {
-        const parts = tok.split(".");
-        if (parts.length !== 3)
-            return null;
-        let b64 = parts[1].replace(/-/g, "+").replace(/_/g, "/");
-        b64 = b64.padEnd(Math.ceil(b64.length / 4) * 4, "=");
-        const jsonText = atob(b64);
-        const payload = JSON.parse(jsonText);
-        return (_a = payload.username) !== null && _a !== void 0 ? _a : null;
-    }
-    catch (_b) {
-        return null;
-    }
-}
-/** Remove the JWT from LocalStorage */
-function removeToken() {
-    try {
-        callStorage('removeItem', 'token');
-    }
-    catch (err) {
-        console.warn("Failed to remove token:", err);
-    }
-}
 /* ------------------------------------------------------------------ */
 /*  internals                                                         */
 /* ------------------------------------------------------------------ */
@@ -329,18 +125,6 @@ PERFORMANCE OF THIS SOFTWARE.
 /* global Reflect, Promise, SuppressedError, Symbol, Iterator */
 
 
-function __rest(s, e) {
-    var t = {};
-    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
-        t[p] = s[p];
-    if (s != null && typeof Object.getOwnPropertySymbols === "function")
-        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
-            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
-                t[p[i]] = s[p[i]];
-        }
-    return t;
-}
-
 function __awaiter(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) {
@@ -356,100 +140,6 @@ typeof SuppressedError === "function" ? SuppressedError : function (error, suppr
     return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
 };
 
-// src/functions/read_utils/src/read_utils.ts
-let fs = null;
-let path = null;
-function getFsModules() {
-    return __awaiter(this, void 0, void 0, function* () {
-        var _a;
-        if (!fs && !path && typeof process !== "undefined" && ((_a = process.versions) === null || _a === void 0 ? void 0 : _a.node)) {
-            try {
-                // prevent bundlers from resolving these at build time
-                fs = (new Function("return require('fs')"))();
-                path = (new Function("return require('path')"))();
-            }
-            catch (_b) {
-                fs = null;
-                path = null;
-            }
-        }
-        return { fs, path };
-    });
-}
-/**
- * Reads a JSON file, either via Node’s fs (if available)
- * or via window.fetch in the browser. Never throws — returns
- * the parsed object or null on any error.
- */
-function readJsonFile(relativeOrAbsolutePath) {
-    return __awaiter(this, void 0, void 0, function* () {
-        var _a;
-        // 1) Try Node.js fs (only at runtime, not bundled)
-        if (typeof process !== "undefined" && ((_a = process.versions) === null || _a === void 0 ? void 0 : _a.node)) {
-            try {
-                const { fs, path } = yield getFsModules();
-                if (fs && path) {
-                    const filePath = path.isAbsolute(relativeOrAbsolutePath)
-                        ? relativeOrAbsolutePath
-                        : path.resolve(process.cwd(), relativeOrAbsolutePath);
-                    const text = fs.readFileSync(filePath, "utf8");
-                    return JSON.parse(text);
-                }
-            }
-            catch (_b) {
-                // swallow and fall back
-            }
-        }
-        // 2) Try browser fetch
-        const fetchFn = safeGlobalProp("fetch");
-        if (typeof fetchFn !== "function") {
-            return null;
-        }
-        let url = relativeOrAbsolutePath;
-        const baseURI = safeGlobalProp("document", "baseURI");
-        if (baseURI) {
-            try {
-                url = new URL(relativeOrAbsolutePath, baseURI).href;
-            }
-            catch (_c) {
-                /* keep url as-is */
-            }
-        }
-        try {
-            const res = yield fetchFn(url);
-            if (!res.ok)
-                return null;
-            return (yield res.json());
-        }
-        catch (_d) {
-            return null;
-        }
-    });
-}
-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;
-        }
-    });
-}
-// 2) Pull a single key out of that object
-function getConfigVar() {
-    return __awaiter(this, arguments, void 0, function* (key = null) {
-        const cfg = yield getConfigContent();
-        if (cfg && typeof cfg === 'object' && key in cfg) {
-            return cfg[key];
-        }
-        return undefined;
-    });
-}
-
 /**
  * Unwraps nested { result } fields until you hit a non-object or no more "result" keys.
  */
@@ -474,18 +164,13 @@ function getMethod(method = null, body = null) {
 // Gets headers, skips JSON headers when body is FormData
 function getHeaders(headers = {}, method = null, body = null) {
     const result = Object.assign({}, headers);
-    // inject auth if missing
-    if (!result.Authorization) {
-        const token = getToken();
-        Object.assign(result, getAuthorizationHeader(result, token));
-    }
-    method = getMethod(method, body);
-    // if it’s a multipart FormData, let the browser set the boundary header
+    // let browser set boundary
     if (body instanceof FormData) {
         return result;
     }
-    // otherwise for POST/PUT/PATCH default to JSON
-    if (['POST', 'PUT', 'PATCH'].includes(method) && !result['Content-Type']) {
+    const upper = method === null || method === void 0 ? void 0 : method.toUpperCase();
+    if (['POST', 'PUT', 'PATCH'].includes(upper !== null && upper !== void 0 ? upper : '') &&
+        !result['Content-Type']) {
         result['Content-Type'] = 'application/json';
     }
     return result;
@@ -555,7 +240,7 @@ function fetchIt(endpoint_1) {
         // 2) choose the URL
         let url = endpoint;
         // 3) prepare headers & body
-        headers = Object.assign(Object.assign(Object.assign({}, (body instanceof FormData ? {} : { "Content-Type": "application/json" })), getAuthorizationHeader()), headers);
+        headers = Object.assign(Object.assign({}, (body instanceof FormData ? {} : { "Content-Type": "application/json" })), headers);
         const opts = {
             method,
             credentials: withCredentials ? "include" : "same-origin",
@@ -690,6 +375,9 @@ function url_to_path(urlStr, all_paths) {
     }
     return null;
 }
+function urljoin(...parts) {
+    return urlJoin(...parts);
+}
 
 function assertPath(path) {
   if (typeof path !== 'string') {
@@ -1193,39 +881,126 @@ posix.posix = posix;
 
 var pathBrowserify = posix;
 
-function ensure_list(obj) {
-    const objArray = Array.isArray(obj) ? obj : [obj];
-    return objArray;
-}
-// coerce any single value into a number (0 if it can't)
-function ensure_number(x) {
-    const n = Number(x);
-    return isNaN(n) ? 0 : n;
-}
-function ensure_array(input) {
-    if (typeof input === 'string') {
-        return [input];
-    }
-    if (Array.isArray(input)) {
-        return input.map(item => ensure_string(item));
+function split_outside_brackets(s) {
+    let depth = 0;
+    let start = 0;
+    const out = [];
+    for (let i = 0; i < s.length; i++) {
+        const c = s[i];
+        if (c === "[")
+            depth++;
+        else if (c === "]")
+            depth--;
+        // split only when NOT inside brackets
+        if (c === "," && depth === 0) {
+            out.push(s.slice(start, i));
+            start = i + 1;
+        }
     }
-    return [];
+    out.push(s.slice(start));
+    return out;
+}
+function parse_nested_list(s) {
+    // strip outer brackets
+    const inner = s.slice(1, -1).trim();
+    const parts = split_outside_brackets(inner);
+    const result = [];
+    for (let p of parts) {
+        p = p.trim();
+        if (p.startsWith("[") && p.endsWith("]")) {
+            // recursively parse nested list
+            result.push(parse_nested_list(p));
+        }
+        else {
+            result.push(p);
+        }
+    }
+    return result;
+}
+
+function ensure_list(obj) {
+    if (obj == null)
+        return [];
+    if (Array.isArray(obj)) {
+        return obj.flatMap(item => ensure_list(item));
+    }
+    const s = String(obj).trim();
+    if (s.startsWith("[") && s.endsWith("]")) {
+        return parse_nested_list(s);
+    }
+    return split_outside_brackets(s).map(x => x.trim());
+}
+// coerce any single value into a number (0 if it can't)
+function ensure_number(x) {
+    const n = Number(x);
+    return isNaN(n) ? 0 : n;
 }
 function ensure_string(obj) {
     return String(obj);
 }
-const assureList = ensure_list;
-const assureString = ensure_string;
-const assureNumber = ensure_number;
-const assureArray = ensure_array;
-const assure_list = ensure_list;
-const assure_string = ensure_string;
-const assure_number = ensure_number;
-const assure_array = ensure_array;
-const ensureList = ensure_list;
-const ensureString = ensure_string;
-const ensureNumber = ensure_number;
-const ensureArray = ensure_array;
+function ensurelist(obj) {
+    return ensure_list(obj);
+}
+function assureList(obj) {
+    return ensure_list(obj);
+}
+function assure_list(obj) {
+    return ensure_list(obj);
+}
+function ensureList(obj) {
+    return ensure_list(obj);
+}
+function assurelist(obj) {
+    return ensure_list(obj);
+}
+function ensurenumber(x) {
+    return ensure_number(x);
+}
+function assureNumber(x) {
+    return ensure_number(x);
+}
+function ensureNumber(x) {
+    return ensure_number(x);
+}
+function assurenumber(x) {
+    return ensure_number(x);
+}
+function assure_number(x) {
+    return ensure_number(x);
+}
+function ensurestring(obj) {
+    return ensure_string(obj);
+}
+function ensureString(obj) {
+    return ensure_string(obj);
+}
+function assureString(obj) {
+    return ensure_string(obj);
+}
+function assurestring(obj) {
+    return ensure_string(obj);
+}
+function assure_string(obj) {
+    return ensure_string(obj);
+}
+function assurearray(obj) {
+    return ensure_list(obj);
+}
+function ensurearray(obj) {
+    return ensure_list(obj);
+}
+function ensure_array(obj) {
+    return ensure_list(obj);
+}
+function ensureArray(obj) {
+    return ensure_list(obj);
+}
+function assure_array(obj) {
+    return ensure_list(obj);
+}
+function assureArray(obj) {
+    return ensure_list(obj);
+}
 
 function cleanText(input) {
     // Replace delimiters with spaces and split
@@ -1692,71 +1467,80 @@ function stripPrefixes(str, bases = []) {
     }
     return str;
 }
-/**
- * Removes characters from the beginning of the string
- * if they are found in the list of characters.
- *
- * @param str - The input string.
- * @param listObjects - A string or an array of characters to remove.
- * @returns The modified string.
- */
-function eatInner(str, listObjects) {
-    if (!Array.isArray(listObjects)) {
-        listObjects = [listObjects];
+function tryEatPrefix(str, length, ...objs) {
+    str = String(str);
+    objs = ensure_list(objs);
+    const prefix = str.slice(0, length);
+    if (length < 0) {
+        const start = str.length + length;
+        const actualPrefix = str.slice(start);
+        return objs.includes(actualPrefix) ? [str.slice(0, start), true] : [str, false];
+    }
+    if (objs.includes(prefix)) {
+        return [str.slice(length), true];
     }
-    // Ensure str is a string
+    return [str, false];
+}
+/** Python-equivalent eatInner */
+function eatInner(str, listObjects) {
     str = String(str);
-    // Remove characters from the beginning while they are in listObjects
-    while (str.length > 0 && listObjects.includes(str[0])) {
+    const chars = Array.isArray(listObjects) ? listObjects : [listObjects];
+    // Keep removing from left while leftmost char is in the set
+    while (str.length > 0 && chars.includes(str[0])) {
         str = str.slice(1);
     }
     return str;
 }
-/**
- * Removes characters from the end of the string
- * if they are found in the list of characters.
- *
- * @param str - The input string.
- * @param listObjects - A string or an array of characters to remove.
- * @returns The modified string.
- */
+/** Python-equivalent eatOuter */
 function eatOuter(str, listObjects) {
-    if (!Array.isArray(listObjects)) {
-        listObjects = [listObjects];
-    }
-    // Ensure str is a string
     str = String(str);
-    // Remove characters from the end while they are in listObjects
-    while (str.length > 0 && listObjects.includes(str[str.length - 1])) {
+    const chars = Array.isArray(listObjects) ? listObjects : [listObjects];
+    if (!str || chars.length === 0)
+        return str;
+    for (let i = 0; i < str.length; i++) {
+        if (!str)
+            return str;
+        const last = str[str.length - 1];
+        if (!chars.includes(last)) {
+            return str;
+        }
         str = str.slice(0, -1);
     }
     return str;
 }
-/**
- * Removes characters from both the beginning and the end of the string
- * if they are found in the list of characters.
- *
- * @param str - The input string.
- * @param listObjects - A string or an array of characters to remove.
- * @returns The modified string.
- */
+/** Python-equivalent eatAll */
 function eatAll(str, listObjects) {
-    return eatOuter(eatInner(str, listObjects), listObjects);
-}
-function eatEnd(obj, endings = ['/']) {
-    let result = obj;
-    let modified = true;
-    while (modified) {
-        modified = false;
-        for (const ending of endings) {
-            if (result.endsWith(ending)) {
-                result = result.slice(0, -ending.length);
-                modified = true;
-                break;
-            }
+    str = String(str);
+    const chars = Array.isArray(listObjects) ? listObjects : [listObjects];
+    str = eatInner(str, chars);
+    str = eatOuter(str, chars);
+    return str;
+}
+// Plug in the actual version from your project
+function get_alpha_ints(opts) {
+    // REPLACE WITH YOUR REAL IMPLEMENTATION
+    return [];
+}
+/** Python-equivalent eatElse */
+function eatElse(stringObj, chars, ints = true, alpha = true, lower = true, capitalize = true, string = true, listObj = true) {
+    stringObj = String(stringObj);
+    const alphaInts = get_alpha_ints();
+    let ls = ensure_list(chars || []).concat(alphaInts);
+    while (true) {
+        if (!stringObj)
+            return stringObj;
+        const startOk = !ls.includes(stringObj[0]);
+        const endOk = !ls.includes(stringObj[stringObj.length - 1]);
+        const shouldEat = startOk || endOk;
+        if (!shouldEat)
+            return stringObj;
+        if (stringObj && startOk) {
+            stringObj = stringObj.length === 1 ? "" : stringObj.slice(1);
+        }
+        if (stringObj && endOk) {
+            stringObj = stringObj.length === 1 ? "" : stringObj.slice(0, -1);
         }
     }
-    return result;
 }
 function tryParse(obj) {
     try {
@@ -1780,6 +1564,15 @@ function create_list_string(array_obj) {
     }
     return string;
 }
+function eatall(str, listObjects) {
+    return eatAll(str, listObjects);
+}
+function eatinner(str, listObjects) {
+    return eatInner(str, listObjects);
+}
+function eatouter(str, listObjects) {
+    return eatOuter(str, listObjects);
+}
 
 /**
  * In the browser we already have a WHATWG URL constructor on window.
@@ -1814,9 +1607,11 @@ function get_basename(filePath) {
         return '';
     return pathBrowserify.basename(filePath);
 }
-function get_filename(file_path) {
-    const ext = pathBrowserify.extname(file_path);
-    return pathBrowserify.basename(file_path, ext);
+function get_filename(filePath) {
+    if (!filePath)
+        return '';
+    const ext = pathBrowserify.extname(filePath);
+    return pathBrowserify.basename(filePath, ext);
 }
 function get_extname(filePath) {
     if (!filePath)
@@ -1854,32 +1649,36 @@ function get_relative_path(basePath, targetPath) {
     }
 }
 /**
- * Join multiple path segments, normalizing leading/trailing slashes.
+ * 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
  *
- * Usage:
- *   make_path('/foo','bar','baz')
- *   make_path(['/foo','bar','baz'])
+ * Always returns a clean POSIX path string. Never a list.
  */
-function make_path(...paths) {
-    // If someone passed a single array, unwrap it:
-    const pathArray = (paths.length === 1 && Array.isArray(paths[0])
-        ? paths[0]
-        : paths);
-    let real_path = '';
-    for (let i = 0; i < pathArray.length; i++) {
-        let segment = pathArray[i];
-        if (i === 0) {
-            real_path = segment;
+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 {
-            // remove any leading slash on this segment
-            segment = segment.replace(/^\/+/, '');
-            // remove any trailing slash on the accumulator
-            real_path = real_path.replace(/\/+$/, '');
-            real_path = `${real_path}/${segment}`;
+            cleaned = eatInner(cleaned, "/"); // trim leading slashes
+            out = `${out}/${cleaned}`;
         }
     }
-    return real_path;
+    return out;
 }
 function sanitizeFilename(filename) {
     return filename
@@ -1893,7 +1692,7 @@ function sanitizeFilename(filename) {
 function make_sanitized_path(...paths) {
     let real_path = '';
     for (let i = 0; i < paths.length; i++) {
-        const sanitized = sanitizeFilename(eatInner(paths[i], ['/']));
+        const sanitized = sanitizeFilename(eatOuter(paths[i], '/'));
         if (i === 0) {
             real_path = sanitized;
         }
@@ -1911,6 +1710,51 @@ function normalizeUrl(base, p) {
     // collapse multiple “//” into one, but keep the “://” after protocol
     return `${cleanBase}/${cleanPath}`.replace(/([^:])\/{2,}/g, '$1/');
 }
+function pathjoin(...parts) {
+    return make_path(...parts);
+}
+function pathJoin(...parts) {
+    return make_path(...parts);
+}
+function makepath(...parts) {
+    return make_path(...parts);
+}
+function makePath(...parts) {
+    return make_path(...parts);
+}
+function path_join(...parts) {
+    return make_path(...parts);
+}
+function getSplitext(filePath) {
+    return get_splitext(filePath);
+}
+function getsplitext(filePath) {
+    return get_splitext(filePath);
+}
+function getextname(filePath) {
+    return get_extname(filePath);
+}
+function getExtname(filePath) {
+    return get_extname(filePath);
+}
+function getfilename(filePath) {
+    return get_filename(filePath);
+}
+function getFilename(filePath) {
+    return get_filename(filePath);
+}
+function getbasename(filePath) {
+    return get_basename(filePath);
+}
+function getBasename(filePath) {
+    return get_basename(filePath);
+}
+function getdirname(filePath) {
+    return get_dirname(filePath);
+}
+function getDirname(filePath) {
+    return get_dirname(filePath);
+}
 
 /**
  * Returns the absolute path of the current file.
@@ -2205,39 +2049,221 @@ const fromMps = (v, dist_unit, time_unit) => mpsToSpeed(v, dist_unit, time_unit)
 const isFiniteNum = (x) => Number.isFinite(x);
 const fmt = (n, digits = 2) => isFiniteNum(n) ? n.toFixed(digits) : "N/A";
 
-function Button(_a) {
-    var { children, color = 'gray', variant = 'default', className = '' } = _a, rest = __rest(_a, ["children", "color", "variant", "className"]);
-    const base = 'rounded px-3 py-1 text-sm font-medium focus:outline-none focus:ring-2 focus:ring-offset-2 transition-colors duration-150';
-    const variantStyles = {
-        default: '',
-        icon: 'p-1 bg-transparent hover:bg-gray-100',
-        primary: 'text-white',
-        secondary: '',
-    };
-    const palette = {
-        gray: variant === 'primary'
-            ? 'bg-gray-600 hover:bg-gray-700 focus:ring-gray-500'
-            : 'bg-gray-200 hover:bg-gray-300 focus:ring-gray-400',
-        green: 'bg-green-600 text-white hover:bg-green-700 focus:ring-green-500',
-        blue: variant === 'primary'
-            ? 'bg-blue-600 hover:bg-blue-700 focus:ring-blue-500'
-            : 'bg-blue-200 hover:bg-blue-300 focus:ring-blue-400',
-    };
-    return (jsxRuntime.jsx("button", Object.assign({ className: `${base} ${variantStyles[variant]} ${palette[color]} ${className}` }, rest, { children: children })));
+function getSafeDocument() {
+    return typeof document !== 'undefined' ? document : undefined;
+}
+function getDocumentProp(...keys) {
+    let obj = getSafeDocument();
+    for (const k of keys) {
+        if (obj == null || typeof obj !== 'object')
+            return undefined;
+        obj = obj[k];
+    }
+    return obj;
 }
 
-function Checkbox(_a) {
-    var { label } = _a, rest = __rest(_a, ["label"]);
-    return (jsxRuntime.jsxs("label", { className: 'flex items-center gap-2 mb-4', children: [jsxRuntime.jsx("input", Object.assign({ type: 'checkbox' }, rest)), jsxRuntime.jsx("span", { children: label })] }));
+/**
+ * Safely walk `globalThis` (or window/document) by a chain of property names.
+ * Returns `undefined` if any step is missing.
+ */
+function safeGlobalProp(...path) {
+    let obj = globalThis;
+    for (const key of path) {
+        if (obj == null || typeof obj !== "object" || !(key in obj)) {
+            return undefined;
+        }
+        obj = obj[key];
+    }
+    return obj;
+}
+
+/**
+ * Returns `window` if running in a browser, otherwise `undefined`.
+ */
+function getSafeLocalStorage() {
+    if (typeof window === 'undefined')
+        return undefined;
+    try {
+        return window.localStorage;
+    }
+    catch (_a) {
+        return undefined; // e.g. Safari private-mode block
+    }
+}
+/**
+ * Call a Storage method by name, silencing any errors or missing storage.
+ *
+ * @param method  One of the keys of the Storage interface: "getItem", "setItem", etc.
+ * @param args    The arguments you’d normally pass to that method.
+ * @returns       The method’s return value, or undefined if storage/method isn’t available.
+ */
+function callStorage(method, ...args) {
+    const storage = getSafeLocalStorage();
+    if (!storage)
+        return undefined;
+    const fn = storage[method];
+    if (typeof fn !== 'function')
+        return undefined;
+    try {
+        // @ts-ignore – TS can’t infer that this is callable
+        return fn.apply(storage, args);
+    }
+    catch (_a) {
+        return undefined;
+    }
+}
+/**
+ * Safely call storage methods (`localStorage` or `sessionStorage`) without blowing up.
+ * Returns `undefined` on any error.
+ */
+function safeStorage(storageName, method, ...args) {
+    try {
+        const store = safeGlobalProp(storageName);
+        if (!store || typeof store[method] !== "function")
+            return undefined;
+        // @ts-ignore
+        return store[method](...args);
+    }
+    catch (_a) {
+        return undefined;
+    }
 }
 
-function Input(_a) {
-    var { label, trailing } = _a, rest = __rest(_a, ["label", "trailing"]);
-    return (jsxRuntime.jsxs("label", { className: 'mb-4 block', children: [jsxRuntime.jsx("span", { className: 'block text-sm font-medium mb-1', children: label }), jsxRuntime.jsxs("div", { className: 'flex gap-2', children: [jsxRuntime.jsx("input", Object.assign({ className: 'flex-1 rounded border px-2 py-1 disabled:bg-gray-100' }, rest)), trailing] })] }));
+/**
+ * Returns the global window object if it exists, otherwise undefined.
+ */
+function getSafeWindow() {
+    return typeof window !== 'undefined' ? window : undefined;
+}
+/**
+ * Safely call a method on window by name.
+ *
+ * @param method  The Window method to call (e.g. "alert", "open", etc.).
+ * @param args    Arguments to pass to that method.
+ * @returns       The method’s return value, or undefined if
+ *                 window/method isn’t available or throws.
+ */
+function callWindowMethod(method, ...args) {
+    const w = getSafeWindow();
+    if (!w)
+        return undefined;
+    const fn = w[method];
+    if (typeof fn !== 'function')
+        return undefined;
+    try {
+        // cast to any so TS doesn’t complain about apply/invoke
+        return fn(...args);
+    }
+    catch (_a) {
+        return undefined;
+    }
+}
+/** implementation */
+function getWindowProp(...keys) {
+    let obj = getSafeWindow();
+    for (const k of keys) {
+        if (obj == null || typeof obj !== 'object')
+            return undefined;
+        obj = obj[k];
+    }
+    return obj;
+}
+function getWindowHost() {
+    return getWindowProp('location', 'host');
 }
 
-function Spinner() {
-    return (jsxRuntime.jsx("p", { className: 'animate-pulse', children: "Loading\u2026" }));
+// src/functions/read_utils/src/read_utils.ts
+let fs = null;
+let path = null;
+function getFsModules() {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        if (!fs && !path && typeof process !== "undefined" && ((_a = process.versions) === null || _a === void 0 ? void 0 : _a.node)) {
+            try {
+                // prevent bundlers from resolving these at build time
+                fs = (new Function("return require('fs')"))();
+                path = (new Function("return require('path')"))();
+            }
+            catch (_b) {
+                fs = null;
+                path = null;
+            }
+        }
+        return { fs, path };
+    });
+}
+/**
+ * Reads a JSON file, either via Node’s fs (if available)
+ * or via window.fetch in the browser. Never throws — returns
+ * the parsed object or null on any error.
+ */
+function readJsonFile(relativeOrAbsolutePath) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        // 1) Try Node.js fs (only at runtime, not bundled)
+        if (typeof process !== "undefined" && ((_a = process.versions) === null || _a === void 0 ? void 0 : _a.node)) {
+            try {
+                const { fs, path } = yield getFsModules();
+                if (fs && path) {
+                    const filePath = path.isAbsolute(relativeOrAbsolutePath)
+                        ? relativeOrAbsolutePath
+                        : path.resolve(process.cwd(), relativeOrAbsolutePath);
+                    const text = fs.readFileSync(filePath, "utf8");
+                    return JSON.parse(text);
+                }
+            }
+            catch (_b) {
+                // swallow and fall back
+            }
+        }
+        // 2) Try browser fetch
+        const fetchFn = safeGlobalProp("fetch");
+        if (typeof fetchFn !== "function") {
+            return null;
+        }
+        let url = relativeOrAbsolutePath;
+        const baseURI = safeGlobalProp("document", "baseURI");
+        if (baseURI) {
+            try {
+                url = new URL(relativeOrAbsolutePath, baseURI).href;
+            }
+            catch (_c) {
+                /* keep url as-is */
+            }
+        }
+        try {
+            const res = yield fetchFn(url);
+            if (!res.ok)
+                return null;
+            return (yield res.json());
+        }
+        catch (_d) {
+            return null;
+        }
+    });
+}
+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;
+        }
+    });
+}
+// 2) Pull a single key out of that object
+function getConfigVar() {
+    return __awaiter(this, arguments, void 0, function* (key = null) {
+        const cfg = yield getConfigContent();
+        if (cfg && typeof cfg === 'object' && key in cfg) {
+            return cfg[key];
+        }
+        return undefined;
+    });
 }
 
 // src/functions/config_utils/src/config_utils.ts
@@ -2348,28 +2374,10 @@ function get_keyword_string(keywords) {
     return allString;
 }
 
-Object.defineProperty(exports, "useCallback", {
-    enumerable: true,
-    get: function () { return react.useCallback; }
-});
-Object.defineProperty(exports, "useEffect", {
-    enumerable: true,
-    get: function () { return react.useEffect; }
-});
-Object.defineProperty(exports, "useRef", {
-    enumerable: true,
-    get: function () { return react.useRef; }
-});
-Object.defineProperty(exports, "useState", {
-    enumerable: true,
-    get: function () { return react.useState; }
-});
 exports.API_PREFIX = API_PREFIX;
 exports.ATTOSECOND = ATTOSECOND;
 exports.BASE_URL = BASE_URL;
-exports.Button = Button;
 exports.CENTISECOND = CENTISECOND;
-exports.Checkbox = Checkbox;
 exports.DAY = DAY;
 exports.DAY_IN_S = DAY_IN_S;
 exports.DECISECOND = DECISECOND;
@@ -2382,7 +2390,6 @@ exports.FEET_PER_METER = FEET_PER_METER;
 exports.FEMTOSECOND = FEMTOSECOND;
 exports.HOUR = HOUR;
 exports.HOUR_IN_S = HOUR_IN_S;
-exports.Input = Input;
 exports.KMS_PER_METER = KMS_PER_METER;
 exports.MEDIA_TYPES = MEDIA_TYPES;
 exports.METERS_PER_FOOT = METERS_PER_FOOT;
@@ -2410,7 +2417,6 @@ exports.SECONDS_PER_HOUR = SECONDS_PER_HOUR;
 exports.SECONDS_PER_MINUTE = SECONDS_PER_MINUTE;
 exports.SUB_DIR = SUB_DIR;
 exports.SpeedConverter = SpeedConverter;
-exports.Spinner = Spinner;
 exports.TIME_ALIASES = TIME_ALIASES;
 exports.TIME_FACTORS = TIME_FACTORS;
 exports.TimeConverter = TimeConverter;
@@ -2426,6 +2432,10 @@ exports.assure_array = assure_array;
 exports.assure_list = assure_list;
 exports.assure_number = assure_number;
 exports.assure_string = assure_string;
+exports.assurearray = assurearray;
+exports.assurelist = assurelist;
+exports.assurenumber = assurenumber;
+exports.assurestring = assurestring;
 exports.callStorage = callStorage;
 exports.callWindowMethod = callWindowMethod;
 exports.canonDist = canonDist;
@@ -2441,14 +2451,15 @@ exports.convertDistance = convertDistance;
 exports.convertSpeed = convertSpeed;
 exports.convertTime = convertTime;
 exports.create_list_string = create_list_string;
-exports.currentUsername = currentUsername;
-exports.currentUsernames = currentUsernames;
 exports.decodeJwt = decodeJwt;
 exports.distanceToMeters = distanceToMeters;
 exports.eatAll = eatAll;
-exports.eatEnd = eatEnd;
+exports.eatElse = eatElse;
 exports.eatInner = eatInner;
 exports.eatOuter = eatOuter;
+exports.eatall = eatall;
+exports.eatinner = eatinner;
+exports.eatouter = eatouter;
 exports.ensureArray = ensureArray;
 exports.ensureList = ensureList;
 exports.ensureNumber = ensureNumber;
@@ -2457,6 +2468,10 @@ exports.ensure_array = ensure_array;
 exports.ensure_list = ensure_list;
 exports.ensure_number = ensure_number;
 exports.ensure_string = ensure_string;
+exports.ensurearray = ensurearray;
+exports.ensurelist = ensurelist;
+exports.ensurenumber = ensurenumber;
+exports.ensurestring = ensurestring;
 exports.exponential = exponential;
 exports.fetchIndexHtml = fetchIndexHtml;
 exports.fetchIndexHtmlContainer = fetchIndexHtmlContainer;
@@ -2483,8 +2498,8 @@ exports.getAllFileTypes = getAllFileTypes;
 exports.getAllFileTypesSync = getAllFileTypesSync;
 exports.getAlphaNum = getAlphaNum;
 exports.getAlphas = getAlphas;
-exports.getAuthorizationHeader = getAuthorizationHeader;
 exports.getBaseDir = getBaseDir;
+exports.getBasename = getBasename;
 exports.getBody = getBody;
 exports.getChar = getChar;
 exports.getCleanArray = getCleanArray;
@@ -2493,11 +2508,14 @@ exports.getConfig = getConfig;
 exports.getConfigContent = getConfigContent;
 exports.getConfigVar = getConfigVar;
 exports.getDbConfigsPath = getDbConfigsPath;
+exports.getDirname = getDirname;
 exports.getDistDir = getDistDir;
 exports.getDocumentProp = getDocumentProp;
 exports.getEnvDir = getEnvDir;
 exports.getEnvPath = getEnvPath;
+exports.getExtname = getExtname;
 exports.getFetchVars = getFetchVars;
+exports.getFilename = getFilename;
 exports.getFunctionsDir = getFunctionsDir;
 exports.getFunctionsUtilsDirectory = getFunctionsUtilsDirectory;
 exports.getHeaders = getHeaders;
@@ -2516,9 +2534,9 @@ exports.getSafeLocalStorage = getSafeLocalStorage;
 exports.getSafeWindow = getSafeWindow;
 exports.getSchemasDirPath = getSchemasDirPath;
 exports.getSchemasPath = getSchemasPath;
+exports.getSplitext = getSplitext;
 exports.getSrcDir = getSrcDir;
 exports.getSubstring = getSubstring;
-exports.getToken = getToken;
 exports.getWindowHost = getWindowHost;
 exports.getWindowProp = getWindowProp;
 exports.get_all_file_types = get_all_file_types;
@@ -2539,8 +2557,12 @@ exports.get_window = get_window;
 exports.get_window_location = get_window_location;
 exports.get_window_parts = get_window_parts;
 exports.get_window_pathname = get_window_pathname;
+exports.getbasename = getbasename;
+exports.getdirname = getdirname;
+exports.getextname = getextname;
+exports.getfilename = getfilename;
+exports.getsplitext = getsplitext;
 exports.isFiniteNum = isFiniteNum;
-exports.isLoggedIn = isLoggedIn;
 exports.isMediaType = isMediaType;
 exports.isNum = isNum;
 exports.isStrInString = isStrInString;
@@ -2548,17 +2570,20 @@ exports.isTokenExpired = isTokenExpired;
 exports.isType = isType;
 exports.is_media_type = is_media_type;
 exports.loadConfig = loadConfig;
+exports.makePath = makePath;
 exports.make_path = make_path;
 exports.make_sanitized_path = make_sanitized_path;
+exports.makepath = makepath;
 exports.metersToDistance = metersToDistance;
 exports.mpsToSpeed = mpsToSpeed;
 exports.normalizeUrl = normalizeUrl;
 exports.parseResult = parseResult;
+exports.pathJoin = pathJoin;
+exports.path_join = path_join;
 exports.path_to_url = path_to_url;
+exports.pathjoin = pathjoin;
 exports.processKeywords = processKeywords;
 exports.readJsonFile = readJsonFile;
-exports.removeToken = removeToken;
-exports.requireToken = requireToken;
 exports.roundPercentage = roundPercentage;
 exports.safeDivide = safeDivide;
 exports.safeGlobalProp = safeGlobalProp;
@@ -2573,9 +2598,11 @@ exports.timeToSeconds = timeToSeconds;
 exports.toMeters = toMeters;
 exports.toSeconds = toSeconds;
 exports.truncateString = truncateString;
+exports.tryEatPrefix = tryEatPrefix;
 exports.tryParse = tryParse;
 exports.urlJoin = urlJoin;
 exports.url_to_path = url_to_path;
+exports.urljoin = urljoin;
 exports.velocityFromMs = velocityFromMs;
 exports.velocityToMs = velocityToMs;
 //# sourceMappingURL=index.js.map