@putkoff/abstract-utilities 0.1.235 → 0.1.238

package/dist/cjs/index.js

@@ -1,6 +1,7 @@
 'use strict';
 
 var react = require('react');
+var path = require('path');
 var jsxRuntime = require('react/jsx-runtime');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
@@ -561,6 +562,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));
@@ -1678,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; }
@@ -1715,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;
@@ -1725,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;
@@ -1796,6 +1957,8 @@ exports.get_basename = get_basename;
 exports.get_dirname = get_dirname;
 exports.get_extname = get_extname;
 exports.get_filename = get_filename;
+exports.get_full_path = get_full_path;
+exports.get_full_url = get_full_url;
 exports.get_key_value = get_key_value;
 exports.get_keyword_string = get_keyword_string;
 exports.get_relative_path = get_relative_path;
@@ -1814,7 +1977,9 @@ 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;
 exports.readJsonFile = readJsonFile;
 exports.removeToken = removeToken;
@@ -1829,4 +1994,6 @@ exports.sanitizeFilename = sanitizeFilename;
 exports.stripPrefixes = stripPrefixes;
 exports.truncateString = truncateString;
 exports.tryParse = tryParse;
+exports.urlJoin = urlJoin;
+exports.url_to_path = url_to_path;
 //# sourceMappingURL=index.js.map