@putkoff/abstract-utilities 0.1.188 → 0.1.190

package/dist/esm/index.js

@@ -319,6 +319,240 @@ 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
+/**
+ * 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* () {
+        // 1) Try Node.js fs
+        if (typeof process !== 'undefined' &&
+            process.versions != null &&
+            process.versions.node) {
+            try {
+                const fs = yield import('fs');
+                const path = yield import('path');
+                const filePath = path.isAbsolute(relativeOrAbsolutePath)
+                    ? relativeOrAbsolutePath
+                    : path.resolve(process.cwd(), relativeOrAbsolutePath);
+                const text = yield fs.promises.readFile(filePath, 'utf8');
+                return JSON.parse(text);
+            }
+            catch (_a) {
+                // swallow and fall back to browser
+            }
+        }
+        // 2) Try browser fetch
+        const fetchFn = safeGlobalProp('fetch');
+        if (typeof fetchFn !== 'function') {
+            return null;
+        }
+        // Resolve URL against document.baseURI if possible
+        let url = relativeOrAbsolutePath;
+        const baseURI = safeGlobalProp('document', 'baseURI');
+        if (baseURI) {
+            try {
+                url = new URL(relativeOrAbsolutePath, baseURI).href;
+            }
+            catch (_b) {
+                // keep url as-is
+            }
+        }
+        try {
+            const res = yield fetchFn(url);
+            if (!res.ok)
+                return null;
+            return (yield res.json());
+        }
+        catch (_c) {
+            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;
+    });
+}
+
+// Constructs API URL from endpoint
+/**
+ * Unwraps nested { result } fields until you hit a non-object or no more "result" keys.
+ */
+function getResult(obj) {
+    let current = obj;
+    while (current &&
+        typeof current === "object" &&
+        Object.prototype.hasOwnProperty.call(current, "result")) {
+        current = current.result;
+    }
+    return current;
+}
+// Determines HTTP method, defaults to GET or POST based on body
+function getMethod(method = null, body = null) {
+    const validMethods = ['GET', 'POST', 'PUT', 'PATCH', 'PULL'];
+    method = (method || '').toUpperCase();
+    if (!validMethods.includes(method)) {
+        method = body ? 'POST' : 'GET';
+    }
+    return method;
+}
+// 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
+    if (body instanceof FormData) {
+        return result;
+    }
+    // otherwise for POST/PUT/PATCH default to JSON
+    if (['POST', 'PUT', 'PATCH'].includes(method) && !result['Content-Type']) {
+        result['Content-Type'] = 'application/json';
+    }
+    return result;
+}
+// Prepares request body, serializes to JSON for non-GET requests
+function getBody(body = null, method = null) {
+    method = getMethod(method, body);
+    if (method === 'GET') {
+        return undefined;
+    }
+    if (body) {
+        try {
+            return JSON.stringify(body);
+        }
+        catch (err) {
+            return body;
+        }
+    }
+    return undefined;
+}
+// Prepares fetch variables, passes FormData intact
+function getFetchVars(headers = null, method = null, body = null) {
+    method = getMethod(method, body);
+    headers = getHeaders(headers || {}, method, body);
+    // only JSON-stringify non-FormData bodies
+    if (!(body instanceof FormData)) {
+        body = getBody(body, method);
+    }
+    return { method, headers, body };
+}
+/*
+ * parseResult no longer needs to worry about JSON vs HTML redirect errors;
+ * all 401/403 have already been handled above.
+ */
+function parseResult(res) {
+    return __awaiter(this, void 0, void 0, function* () {
+        // runs checkResponse first, will throw if session is expired
+        res = checkResponse(res);
+        if (!res.ok) {
+            // for any other non-401 errors, you can still surface them
+            const errorText = yield res.text();
+            throw new Error(errorText || res.statusText);
+        }
+        // now safely parse JSON
+        return res.json();
+    });
+}
+/**
+ * Intercept 401/403 and force a clean redirect to login
+ * without ever showing an alert.
+ */
+function checkResponse(res) {
+    if (res.status === 401 || res.status === 403) {
+        // 1) clear out the stale token
+        localStorage.removeItem("token");
+        // 2) replace history so "back" doesn’t re-trigger the protected route
+        window.history.replaceState({}, "", "/secure-files");
+        // 3) short-circuit all further fetch logic
+        throw new Error("SessionExpired");
+    }
+    return res;
+}
+function fetchIt(endpoint_1) {
+    return __awaiter(this, arguments, void 0, function* (endpoint, body = null, method = null, headers = null, blob = false, configUrl = false, withCredentials = true, returnJson = true, returnReult = true) {
+        method = (method || "GET").toUpperCase();
+        // 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);
+        const opts = {
+            method,
+            credentials: withCredentials ? "include" : "same-origin",
+            headers,
+            body: body instanceof FormData
+                ? body
+                : body != null && method !== "GET"
+                    ? JSON.stringify(body)
+                    : undefined,
+        };
+        console.debug("➡️ secureFetchIt →", url, opts);
+        const res = yield fetch(url, opts);
+        if (!res.ok) {
+            const err = yield res.text();
+            throw new Error(`HTTP ${res.status}: ${err}`);
+        }
+        if (blob)
+            return res.blob();
+        if (returnReult)
+            return getResult(res.json());
+        if (returnJson)
+            return res.json();
+        return res;
+    });
+}
+// Constructs HTML directory path
+function getHtmlDirectory(directory, filename) {
+    return `${directory}/${filename}.html`;
+}
+// Fetches HTML content
+function fetchIndexHtml(filename_1) {
+    return __awaiter(this, arguments, void 0, function* (filename, directory = 'sf_index', base = 'html') {
+        const url = `/${base}/${directory}/${filename}.html`;
+        const response = yield fetch(url);
+        return yield response.text();
+    });
+}
+// Fetches and injects HTML content into container
+function fetchIndexHtmlContainer(filename_1) {
+    return __awaiter(this, arguments, void 0, function* (filename, doc = document, directory = 'html') {
+        const container = `${filename}-container`;
+        const html = yield fetchIndexHtml(filename, directory);
+        const el = doc.getElementById(container);
+        if (el) {
+            el.innerHTML = html;
+        }
+        else {
+            console.warn(`⚠️ No container found for: #${container}`);
+        }
+    });
+}
+
 function assertPath(path) {
   if (typeof path !== 'string') {
     throw new TypeError('Path must be a string. Received ' + JSON.stringify(path));
@@ -1151,57 +1385,39 @@ function alertit(obj = null) {
     alert(msg);
 }
 
-// src/functions/read_utils/src/read_utils.ts
-/**
- * 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* () {
-        // 1) Try Node.js fs
-        if (typeof process !== 'undefined' &&
-            process.versions != null &&
-            process.versions.node) {
-            try {
-                const fs = yield import('fs');
-                const path = yield import('path');
-                const filePath = path.isAbsolute(relativeOrAbsolutePath)
-                    ? relativeOrAbsolutePath
-                    : path.resolve(process.cwd(), relativeOrAbsolutePath);
-                const text = yield fs.promises.readFile(filePath, 'utf8');
-                return JSON.parse(text);
-            }
-            catch (_a) {
-                // swallow and fall back to browser
-            }
-        }
-        // 2) Try browser fetch
-        const fetchFn = safeGlobalProp('fetch');
-        if (typeof fetchFn !== 'function') {
-            return null;
-        }
-        // Resolve URL against document.baseURI if possible
-        let url = relativeOrAbsolutePath;
-        const baseURI = safeGlobalProp('document', 'baseURI');
-        if (baseURI) {
-            try {
-                url = new URL(relativeOrAbsolutePath, baseURI).href;
-            }
-            catch (_b) {
-                // keep url as-is
-            }
-        }
-        try {
-            const res = yield fetchFn(url);
-            if (!res.ok)
-                return null;
-            return (yield res.json());
-        }
-        catch (_c) {
-            return null;
-        }
-    });
+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 (jsx("button", Object.assign({ className: `${base} ${variantStyles[variant]} ${palette[color]} ${className}` }, rest, { children: children })));
+}
+
+function Checkbox(_a) {
+    var { label } = _a, rest = __rest(_a, ["label"]);
+    return (jsxs("label", { className: 'flex items-center gap-2 mb-4', children: [jsx("input", Object.assign({ type: 'checkbox' }, rest)), jsx("span", { children: label })] }));
+}
+
+function Input(_a) {
+    var { label, trailing } = _a, rest = __rest(_a, ["label", "trailing"]);
+    return (jsxs("label", { className: 'mb-4 block', children: [jsx("span", { className: 'block text-sm font-medium mb-1', children: label }), jsxs("div", { className: 'flex gap-2', children: [jsx("input", Object.assign({ className: 'flex-1 rounded border px-2 py-1 disabled:bg-gray-100' }, rest)), trailing] })] }));
+}
+
+function Spinner() {
+    return (jsx("p", { className: 'animate-pulse', children: "Loading\u2026" }));
 }
 
 // src/functions/config_utils/src/config_utils.ts
@@ -1275,222 +1491,6 @@ function getConfig(key) {
         return key != null ? cfg[key] : cfg;
     });
 }
-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;
-    });
-}
-
-// Constructs API URL from endpoint
-/**
- * Unwraps nested { result } fields until you hit a non-object or no more "result" keys.
- */
-function getResult(obj) {
-    let current = obj;
-    while (current &&
-        typeof current === "object" &&
-        Object.prototype.hasOwnProperty.call(current, "result")) {
-        current = current.result;
-    }
-    return current;
-}
-// Determines HTTP method, defaults to GET or POST based on body
-function getMethod(method = null, body = null) {
-    const validMethods = ['GET', 'POST', 'PUT', 'PATCH', 'PULL'];
-    method = (method || '').toUpperCase();
-    if (!validMethods.includes(method)) {
-        method = body ? 'POST' : 'GET';
-    }
-    return method;
-}
-// 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
-    if (body instanceof FormData) {
-        return result;
-    }
-    // otherwise for POST/PUT/PATCH default to JSON
-    if (['POST', 'PUT', 'PATCH'].includes(method) && !result['Content-Type']) {
-        result['Content-Type'] = 'application/json';
-    }
-    return result;
-}
-// Prepares request body, serializes to JSON for non-GET requests
-function getBody(body = null, method = null) {
-    method = getMethod(method, body);
-    if (method === 'GET') {
-        return undefined;
-    }
-    if (body) {
-        try {
-            return JSON.stringify(body);
-        }
-        catch (err) {
-            return body;
-        }
-    }
-    return undefined;
-}
-// Prepares fetch variables, passes FormData intact
-function getFetchVars(headers = null, method = null, body = null) {
-    method = getMethod(method, body);
-    headers = getHeaders(headers || {}, method, body);
-    // only JSON-stringify non-FormData bodies
-    if (!(body instanceof FormData)) {
-        body = getBody(body, method);
-    }
-    return { method, headers, body };
-}
-/*
- * parseResult no longer needs to worry about JSON vs HTML redirect errors;
- * all 401/403 have already been handled above.
- */
-function parseResult(res) {
-    return __awaiter(this, void 0, void 0, function* () {
-        // runs checkResponse first, will throw if session is expired
-        res = checkResponse(res);
-        if (!res.ok) {
-            // for any other non-401 errors, you can still surface them
-            const errorText = yield res.text();
-            throw new Error(errorText || res.statusText);
-        }
-        // now safely parse JSON
-        return res.json();
-    });
-}
-/**
- * Intercept 401/403 and force a clean redirect to login
- * without ever showing an alert.
- */
-function checkResponse(res) {
-    if (res.status === 401 || res.status === 403) {
-        // 1) clear out the stale token
-        localStorage.removeItem("token");
-        // 2) replace history so "back" doesn’t re-trigger the protected route
-        window.history.replaceState({}, "", "/secure-files");
-        // 3) short-circuit all further fetch logic
-        throw new Error("SessionExpired");
-    }
-    return res;
-}
-function fetchIt(endpoint_1) {
-    return __awaiter(this, arguments, void 0, function* (endpoint, body = null, method = null, headers = null, blob = false, configUrl = false, withCredentials = true, returnJson = true, returnReult = true) {
-        method = (method || "GET").toUpperCase();
-        // 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);
-        const opts = {
-            method,
-            credentials: withCredentials ? "include" : "same-origin",
-            headers,
-            body: body instanceof FormData
-                ? body
-                : body != null && method !== "GET"
-                    ? JSON.stringify(body)
-                    : undefined,
-        };
-        console.debug("➡️ secureFetchIt →", url, opts);
-        const res = yield fetch(url, opts);
-        if (!res.ok) {
-            const err = yield res.text();
-            throw new Error(`HTTP ${res.status}: ${err}`);
-        }
-        if (blob)
-            return res.blob();
-        if (returnReult)
-            return getResult(res.json());
-        if (returnJson)
-            return res.json();
-        return res;
-    });
-}
-// Constructs HTML directory path
-function getHtmlDirectory(directory, filename) {
-    return `${directory}/${filename}.html`;
-}
-// Fetches HTML content
-function fetchIndexHtml(filename_1) {
-    return __awaiter(this, arguments, void 0, function* (filename, directory = 'sf_index', base = 'html') {
-        const url = `/${base}/${directory}/${filename}.html`;
-        const response = yield fetch(url);
-        return yield response.text();
-    });
-}
-// Fetches and injects HTML content into container
-function fetchIndexHtmlContainer(filename_1) {
-    return __awaiter(this, arguments, void 0, function* (filename, doc = document, directory = 'html') {
-        const container = `${filename}-container`;
-        const html = yield fetchIndexHtml(filename, directory);
-        const el = doc.getElementById(container);
-        if (el) {
-            el.innerHTML = html;
-        }
-        else {
-            console.warn(`⚠️ No container found for: #${container}`);
-        }
-    });
-}
-
-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 (jsx("button", Object.assign({ className: `${base} ${variantStyles[variant]} ${palette[color]} ${className}` }, rest, { children: children })));
-}
-
-function Checkbox(_a) {
-    var { label } = _a, rest = __rest(_a, ["label"]);
-    return (jsxs("label", { className: 'flex items-center gap-2 mb-4', children: [jsx("input", Object.assign({ type: 'checkbox' }, rest)), jsx("span", { children: label })] }));
-}
-
-function Input(_a) {
-    var { label, trailing } = _a, rest = __rest(_a, ["label", "trailing"]);
-    return (jsxs("label", { className: 'mb-4 block', children: [jsx("span", { className: 'block text-sm font-medium mb-1', children: label }), jsxs("div", { className: 'flex gap-2', children: [jsx("input", Object.assign({ className: 'flex-1 rounded border px-2 py-1 disabled:bg-gray-100' }, rest)), trailing] })] }));
-}
-
-function Spinner() {
-    return (jsx("p", { className: 'animate-pulse', children: "Loading\u2026" }));
-}
 
 export { API_PREFIX, BASE_URL, Button, Checkbox, DEV_PREFIX, DOMAIN_NAME, Input, PROD_PREFIX, PROTOCOL, SUB_DIR, Spinner, alertit, callStorage, callWindowMethod, checkResponse, create_list_string, currentUsername, currentUsernames, decodeJwt, eatAll, eatEnd, eatInner, eatOuter, ensure_list, fetchIndexHtml, fetchIndexHtmlContainer, fetchIt, geAuthsUtilsDirectory, geBackupsUtilsDirectory, geConstantsUtilsDirectory, geEnvUtilsDirectory, geFetchUtilsDirectory, geFileUtilsDirectory, gePathUtilsDirectory, geStaticDirectory, geStringUtilsDirectory, geTypeUtilsDirectory, getAbsDir, getAbsPath, getAuthorizationHeader, getBaseDir, getBody, getComponentsUtilsDirectory, getConfig, getConfigContent, getConfigVar, getDbConfigsPath, getDistDir, getDocumentProp, getEnvDir, getEnvPath, getFetchVars, getFunctionsDir, getFunctionsUtilsDirectory, getHeaders, getHooksUtilsDirectory, getHtmlDirectory, getLibUtilsDirectory, getMethod, getPublicDir, getResult, getSafeDocument, getSafeLocalStorage, getSafeWindow, getSchemasDirPath, getSchemasPath, getSrcDir, getSubstring, getToken, getWindowHost, getWindowProp, get_basename, get_dirname, get_extname, get_filename, get_splitext, get_window, get_window_location, get_window_parts, get_window_pathname, isLoggedIn, isTokenExpired, loadConfig, make_path, make_sanitized_path, normalizeUrl, parseResult, readJsonFile, requireToken, safeGlobalProp, safeStorage, sanitizeFilename, stripPrefixes, truncateString, tryParse };
 //# sourceMappingURL=index.js.map