@putkoff/abstract-utilities 0.1.236 → 0.1.238

package/dist/cjs/index.js

@@ -1762,6 +1762,76 @@ function roundPercentage(x) {
     return safeDivide(Math.round(pct), 100);
 }
 
+// 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");
+
 Object.defineProperty(exports, "useCallback", {
     enumerable: true,
     get: function () { return react.useCallback; }
@@ -1799,6 +1869,7 @@ exports.assure_array = assure_array;
 exports.assure_list = assure_list;
 exports.assure_number = assure_number;
 exports.assure_string = assure_string;
+exports.buildUrl = buildUrl;
 exports.callStorage = callStorage;
 exports.callWindowMethod = callWindowMethod;
 exports.capitalize = capitalize;
@@ -1809,11 +1880,17 @@ exports.cleanText = cleanText;
 exports.create_list_string = create_list_string;
 exports.currentUsername = currentUsername;
 exports.currentUsernames = currentUsernames;
+exports.decodeFormComponent = decodeFormComponent;
 exports.decodeJwt = decodeJwt;
+exports.decodeMaybeDouble = decodeMaybeDouble;
+exports.decodeSafe = decodeSafe;
+exports.decodeShareBlob = decodeShareBlob;
 exports.eatAll = eatAll;
 exports.eatEnd = eatEnd;
 exports.eatInner = eatInner;
 exports.eatOuter = eatOuter;
+exports.encode = encode;
+exports.encodeTextForUrl = encodeTextForUrl;
 exports.ensureArray = ensureArray;
 exports.ensureList = ensureList;
 exports.ensureNumber = ensureNumber;
@@ -1900,6 +1977,7 @@ exports.isType = isType;
 exports.make_path = make_path;
 exports.make_sanitized_path = make_sanitized_path;
 exports.normalizeUrl = normalizeUrl;
+exports.parseQuery = parseQuery;
 exports.parseResult = parseResult;
 exports.path_to_url = path_to_url;
 exports.processKeywords = processKeywords;