@putkoff/abstract-utilities 0.1.235 → 0.1.238

package/dist/esm/index.js

@@ -1,4 +1,5 @@
 export { useCallback, useEffect, useRef, useState } from 'react';
+import path from 'path';
 import { jsx, jsxs } from 'react/jsx-runtime';
 
 function getSafeDocument() {
@@ -558,6 +559,89 @@ function fetchIndexHtmlContainer(filename_1) {
     });
 }
 
+function urlJoin(...parts) {
+    var _a;
+    const s = (parts.length === 1 && Array.isArray(parts[0]) ? parts[0] : parts);
+    let r = "";
+    for (let i = 0; i < s.length; i++) {
+        let d = ((_a = s[i]) !== null && _a !== void 0 ? _a : "").toString();
+        if (!d)
+            continue;
+        if (i === 0)
+            r = d;
+        else {
+            d = d.replace(/^\/+/, "");
+            r = r.replace(/\/+$/, "");
+            r = `${r}/${d}`;
+        }
+    }
+    return r;
+}
+/**
+ * Returns a full URL.
+ * If partial_url is already absolute (starts with http), it is returned as is.
+ * Otherwise, it is combined with the base URL.
+ */
+function get_full_url(partial_url, domain = null) {
+    if (typeof partial_url !== 'string') {
+        throw new Error('partial_url must be a string');
+    }
+    // If it already starts with http, assume it is absolute.
+    if (partial_url.startsWith('http')) {
+        return partial_url;
+    }
+    return urlJoin(domain, partial_url);
+}
+/**
+ * Returns a full file system path.
+ * If partial_path is already absolute, it is returned as is.
+ * Otherwise, it is joined with the base directory.
+ */
+function get_full_path(partial_path, parent_dir = null) {
+    if (typeof partial_path !== 'string') {
+        throw new Error('partial_path must be a string');
+    }
+    if (path.isAbsolute(partial_path)) {
+        return partial_path;
+    }
+    return urlJoin(parent_dir, partial_path);
+}
+/**
+ * Converts a local file system path into its corresponding URL.
+ * It checks against the known directories in all_paths and replaces the matching base.
+ */
+function path_to_url(filePath, all_paths) {
+    if (typeof filePath !== 'string') {
+        throw new Error('filePath must be a string');
+    }
+    for (const key in all_paths) {
+        const mapping = all_paths[key];
+        const normalizedBase = path.normalize(mapping.path);
+        if (filePath.startsWith(normalizedBase)) {
+            const relativePath = filePath.substring(normalizedBase.length);
+            return urlJoin(mapping.url, relativePath.replace(/\\/g, '/'));
+        }
+    }
+    return null;
+}
+/**
+ * Converts a URL into its corresponding local file system path.
+ * It checks against the known URL prefixes in all_paths and replaces the matching base.
+ */
+function url_to_path(urlStr, all_paths) {
+    if (typeof urlStr !== 'string') {
+        throw new Error('urlStr must be a string');
+    }
+    for (const key in all_paths) {
+        const mapping = all_paths[key];
+        if (urlStr.startsWith(mapping.url)) {
+            const relativeUrl = urlStr.substring(mapping.url.length);
+            return urlJoin(mapping.path, relativeUrl);
+        }
+    }
+    return null;
+}
+
 function assertPath(path) {
   if (typeof path !== 'string') {
     throw new TypeError('Path must be a string. Received ' + JSON.stringify(path));
@@ -1675,5 +1759,75 @@ function roundPercentage(x) {
     return safeDivide(Math.round(pct), 100);
 }
 
-export { API_PREFIX, BASE_URL, Button, Checkbox, DEV_PREFIX, DOMAIN_NAME, Input, PROD_PREFIX, PROTOCOL, SUB_DIR, Spinner, alertIt, alertit, assureArray, assureList, assureNumber, assureString, assure_array, assure_list, assure_number, assure_string, callStorage, callWindowMethod, capitalize, capitalize_str, checkResponse, cleanArray, cleanText, create_list_string, currentUsername, currentUsernames, decodeJwt, eatAll, eatEnd, eatInner, eatOuter, ensureArray, ensureList, ensureNumber, ensureString, ensure_array, ensure_list, ensure_number, ensure_string, fetchIndexHtml, fetchIndexHtmlContainer, fetchIt, formatNumber, geAuthsUtilsDirectory, geBackupsUtilsDirectory, geConstantsUtilsDirectory, geEnvUtilsDirectory, geFetchUtilsDirectory, geFileUtilsDirectory, gePathUtilsDirectory, geStaticDirectory, geStringUtilsDirectory, geTypeUtilsDirectory, get, getAbsDir, getAbsPath, getAlphaNum, getAlphas, getAuthorizationHeader, getBaseDir, getBody, getChar, getCleanArray, getComponentsUtilsDirectory, getConfigContent, getConfigJson, getConfigVar, getDbConfigsPath, getDistDir, getDocumentProp, getEnvDir, getEnvPath, getFetchVars, getFunctionsDir, getFunctionsUtilsDirectory, getHeaders, getHooksUtilsDirectory, getHtmlDirectory, getLibUtilsDirectory, getMethod, getNums, getPublicDir, getResult, getSafeDocument, getSafeLocalStorage, getSafeWindow, getSchemasDirPath, getSchemasPath, getSrcDir, getSubstring, getToken, getWindowHost, getWindowProp, get_basename, get_dirname, get_extname, get_filename, get_key_value, get_keyword_string, get_relative_path, get_result, get_safe_path, get_splitext, get_window, get_window_location, get_window_parts, get_window_pathname, isLoggedIn, isNum, isStrInString, isTokenExpired, isType, make_path, make_sanitized_path, normalizeUrl, parseResult, processKeywords, readJsonFile, removeToken, requireToken, roundPercentage, safeDivide, safeGlobalProp, safeMultiply, safeNums, safeStorage, sanitizeFilename, stripPrefixes, truncateString, tryParse };
+// urlTools.ts
+// Minimal, safe encoders/decoders + helpers to build/parse URLs
+/** Encode a single query value/key safely */
+const encode = (v) => encodeURIComponent(String(v !== null && v !== void 0 ? v : ""));
+/** Decode a single query value/key safely (never throws) */
+const decodeSafe = (v) => {
+    if (v == null)
+        return "";
+    try {
+        return decodeURIComponent(v);
+    }
+    catch (_a) {
+        // handles bad % sequences or already-decoded strings
+        return v;
+    }
+};
+/** Decode strings that might be double-encoded (up to 2 passes) */
+const decodeMaybeDouble = (v) => {
+    const once = decodeSafe(v);
+    const twice = decodeSafe(once);
+    return twice.length < once.length ? twice : once;
+};
+/** Convert + to spaces (legacy www-form behavior) then decode */
+const decodeFormComponent = (v) => decodeSafe(v.replace(/\+/g, " "));
+/** Build a URL with query params (skips null/undefined) */
+const buildUrl = (base, params) => {
+    const u = new URL(base, typeof window !== "undefined" ? window.location.origin : "http://localhost");
+    if (params) {
+        for (const [k, val] of Object.entries(params)) {
+            if (val === null || val === undefined)
+                continue;
+            // arrays -> multiple entries
+            if (Array.isArray(val)) {
+                val.forEach(v => u.searchParams.append(k, String(v)));
+            }
+            else {
+                u.searchParams.set(k, String(val));
+            }
+        }
+    }
+    return u.toString();
+};
+/** Parse a query string into an object (first value wins; arrays if repeat=true) */
+const parseQuery = (qs, opts) => {
+    var _a;
+    const { repeat = false, form = false } = opts || {};
+    const out = {};
+    const s = qs.startsWith("?") ? qs.slice(1) : qs;
+    if (!s)
+        return out;
+    for (const part of s.split("&")) {
+        if (!part)
+            continue;
+        const [kRaw, vRaw = ""] = part.split("=");
+        const K = form ? decodeFormComponent(kRaw) : decodeSafe(kRaw);
+        const V = form ? decodeFormComponent(vRaw) : decodeSafe(vRaw);
+        if (repeat) {
+            ((_a = out[K]) !== null && _a !== void 0 ? _a : (out[K] = [])).push(V);
+        }
+        else {
+            out[K] = V;
+        }
+    }
+    return out;
+};
+/** Quick helper: percent-encode whole strings for placement in URLs */
+const encodeTextForUrl = (text) => encode(text);
+/** Quick helper: decode long blobs coming from share-intents/UTMs */
+const decodeShareBlob = (blob) => decodeMaybeDouble(blob).replace(/\r\n/g, "\n");
+
+export { API_PREFIX, BASE_URL, Button, Checkbox, DEV_PREFIX, DOMAIN_NAME, Input, PROD_PREFIX, PROTOCOL, SUB_DIR, Spinner, alertIt, alertit, assureArray, assureList, assureNumber, assureString, assure_array, assure_list, assure_number, assure_string, buildUrl, callStorage, callWindowMethod, capitalize, capitalize_str, checkResponse, cleanArray, cleanText, create_list_string, currentUsername, currentUsernames, decodeFormComponent, decodeJwt, decodeMaybeDouble, decodeSafe, decodeShareBlob, eatAll, eatEnd, eatInner, eatOuter, encode, encodeTextForUrl, ensureArray, ensureList, ensureNumber, ensureString, ensure_array, ensure_list, ensure_number, ensure_string, fetchIndexHtml, fetchIndexHtmlContainer, fetchIt, formatNumber, geAuthsUtilsDirectory, geBackupsUtilsDirectory, geConstantsUtilsDirectory, geEnvUtilsDirectory, geFetchUtilsDirectory, geFileUtilsDirectory, gePathUtilsDirectory, geStaticDirectory, geStringUtilsDirectory, geTypeUtilsDirectory, get, getAbsDir, getAbsPath, getAlphaNum, getAlphas, getAuthorizationHeader, getBaseDir, getBody, getChar, getCleanArray, getComponentsUtilsDirectory, getConfigContent, getConfigJson, getConfigVar, getDbConfigsPath, getDistDir, getDocumentProp, getEnvDir, getEnvPath, getFetchVars, getFunctionsDir, getFunctionsUtilsDirectory, getHeaders, getHooksUtilsDirectory, getHtmlDirectory, getLibUtilsDirectory, getMethod, getNums, getPublicDir, getResult, getSafeDocument, getSafeLocalStorage, getSafeWindow, getSchemasDirPath, getSchemasPath, getSrcDir, getSubstring, getToken, getWindowHost, getWindowProp, get_basename, get_dirname, get_extname, get_filename, get_full_path, get_full_url, get_key_value, get_keyword_string, get_relative_path, get_result, get_safe_path, get_splitext, get_window, get_window_location, get_window_parts, get_window_pathname, isLoggedIn, isNum, isStrInString, isTokenExpired, isType, make_path, make_sanitized_path, normalizeUrl, parseQuery, parseResult, path_to_url, processKeywords, readJsonFile, removeToken, requireToken, roundPercentage, safeDivide, safeGlobalProp, safeMultiply, safeNums, safeStorage, sanitizeFilename, stripPrefixes, truncateString, tryParse, urlJoin, url_to_path };
 //# sourceMappingURL=index.js.map