@putkoff/abstract-utilities 0.1.236 → 0.1.238

package/dist/esm/index.js

@@ -1759,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_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, parseResult, path_to_url, processKeywords, readJsonFile, removeToken, requireToken, roundPercentage, safeDivide, safeGlobalProp, safeMultiply, safeNums, safeStorage, sanitizeFilename, stripPrefixes, truncateString, tryParse, urlJoin, url_to_path };
+// 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