@dereekb/util 13.6.1 → 13.6.3

package/fetch/index.cjs.js

@@ -281,12 +281,12 @@ var FetchTimeoutError = /*#__PURE__*/ function(BaseError) {
     };
 }
 
-function _array_like_to_array$2(arr, len) {
+function _array_like_to_array$3(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
     for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
     return arr2;
 }
-function _array_with_holes$2(arr) {
+function _array_with_holes$3(arr) {
     if (Array.isArray(arr)) return arr;
 }
 function asyncGeneratorStep$4(gen, resolve, reject, _next, _throw, key, arg) {
@@ -338,7 +338,7 @@ function _instanceof$1(left, right) {
         return left instanceof right;
     }
 }
-function _iterable_to_array_limit$2(arr, i) {
+function _iterable_to_array_limit$3(arr, i) {
     var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
     if (_i == null) return;
     var _arr = [];
@@ -362,7 +362,7 @@ function _iterable_to_array_limit$2(arr, i) {
     }
     return _arr;
 }
-function _non_iterable_rest$2() {
+function _non_iterable_rest$3() {
     throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
 function _object_spread$3(target) {
@@ -399,20 +399,20 @@ function _object_spread_props$2(target, source) {
     }
     return target;
 }
-function _sliced_to_array$2(arr, i) {
-    return _array_with_holes$2(arr) || _iterable_to_array_limit$2(arr, i) || _unsupported_iterable_to_array$2(arr, i) || _non_iterable_rest$2();
+function _sliced_to_array$3(arr, i) {
+    return _array_with_holes$3(arr) || _iterable_to_array_limit$3(arr, i) || _unsupported_iterable_to_array$3(arr, i) || _non_iterable_rest$3();
 }
 function _type_of$3(obj) {
     "@swc/helpers - typeof";
     return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
 }
-function _unsupported_iterable_to_array$2(o, minLen) {
+function _unsupported_iterable_to_array$3(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$2(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$3(o, minLen);
     var n = Object.prototype.toString.call(o).slice(8, -1);
     if (n === "Object" && o.constructor) n = o.constructor.name;
     if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$2(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$3(o, minLen);
 }
 function _ts_generator$4(thisArg, body) {
     var f, y, t, _ = {
@@ -877,7 +877,7 @@ function _ts_generator$4(thisArg, body) {
         var tuples = headersToHeadersTuple(headers);
         var visitedKeysSet = new Set();
         tuples.forEach(function(param) {
-            var _param = _sliced_to_array$2(param, 2), key = _param[0], value = _param[1];
+            var _param = _sliced_to_array$3(param, 2), key = _param[0], value = _param[1];
             if (!visitedKeysSet.has(key)) {
                 headersMap.delete(key); // delete all existing values to "override" them
                 visitedKeysSet.add(key);
@@ -1733,12 +1733,12 @@ var FetchPageLimitReachedError = /*#__PURE__*/ function(FetchRequestFactoryError
     };
 }
 
-function _array_like_to_array$1(arr, len) {
+function _array_like_to_array$2(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
     for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
     return arr2;
 }
-function _array_with_holes$1(arr) {
+function _array_with_holes$2(arr) {
     if (Array.isArray(arr)) return arr;
 }
 function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
@@ -1783,7 +1783,7 @@ function _define_property$1(obj, key, value) {
     }
     return obj;
 }
-function _iterable_to_array_limit$1(arr, i) {
+function _iterable_to_array_limit$2(arr, i) {
     var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
     if (_i == null) return;
     var _arr = [];
@@ -1807,7 +1807,7 @@ function _iterable_to_array_limit$1(arr, i) {
     }
     return _arr;
 }
-function _non_iterable_rest$1() {
+function _non_iterable_rest$2() {
     throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
 function _object_spread$1(target) {
@@ -1844,16 +1844,16 @@ function _object_spread_props$1(target, source) {
     }
     return target;
 }
-function _sliced_to_array$1(arr, i) {
-    return _array_with_holes$1(arr) || _iterable_to_array_limit$1(arr, i) || _unsupported_iterable_to_array$1(arr, i) || _non_iterable_rest$1();
+function _sliced_to_array$2(arr, i) {
+    return _array_with_holes$2(arr) || _iterable_to_array_limit$2(arr, i) || _unsupported_iterable_to_array$2(arr, i) || _non_iterable_rest$2();
 }
-function _unsupported_iterable_to_array$1(o, minLen) {
+function _unsupported_iterable_to_array$2(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$1(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$2(o, minLen);
     var n = Object.prototype.toString.call(o).slice(8, -1);
     if (n === "Object" && o.constructor) n = o.constructor.name;
     if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$1(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$2(o, minLen);
 }
 function _ts_generator(thisArg, body) {
     var f, y, t, _ = {
@@ -2000,7 +2000,7 @@ function _ts_generator(thisArg, body) {
                                 return [
                                     2,
                                     util.performAsyncTasks(itemIndexPairs, function(param) {
-                                        var _param = _sliced_to_array$1(param, 2), item = _param[0], i = _param[1];
+                                        var _param = _sliced_to_array$2(param, 2), item = _param[0], i = _param[1];
                                         return iterateEachPageItem(item, i, fetchPageResult);
                                     }, _object_spread$1({
                                         sequential: true
@@ -2212,6 +2212,52 @@ function iterateFetchPages(config) {
     })();
 }
 
+function _array_like_to_array$1(arr, len) {
+    if (len == null || len > arr.length) len = arr.length;
+    for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
+    return arr2;
+}
+function _array_with_holes$1(arr) {
+    if (Array.isArray(arr)) return arr;
+}
+function _iterable_to_array_limit$1(arr, i) {
+    var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
+    if (_i == null) return;
+    var _arr = [];
+    var _n = true;
+    var _d = false;
+    var _s, _e;
+    try {
+        for(_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true){
+            _arr.push(_s.value);
+            if (i && _arr.length === i) break;
+        }
+    } catch (err) {
+        _d = true;
+        _e = err;
+    } finally{
+        try {
+            if (!_n && _i["return"] != null) _i["return"]();
+        } finally{
+            if (_d) throw _e;
+        }
+    }
+    return _arr;
+}
+function _non_iterable_rest$1() {
+    throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _sliced_to_array$1(arr, i) {
+    return _array_with_holes$1(arr) || _iterable_to_array_limit$1(arr, i) || _unsupported_iterable_to_array$1(arr, i) || _non_iterable_rest$1();
+}
+function _unsupported_iterable_to_array$1(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array$1(o, minLen);
+    var n = Object.prototype.toString.call(o).slice(8, -1);
+    if (n === "Object" && o.constructor) n = o.constructor.name;
+    if (n === "Map" || n === "Set") return Array.from(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$1(o, minLen);
+}
 /**
  * Creates URLSearchParams from the input objects. The input objects are merged together.
  *
@@ -2246,6 +2292,70 @@ function iterateFetchPages(config) {
     var str = params.toString();
     return (options === null || options === void 0 ? void 0 : options.useUrlSearchSpaceHandling) ? str.replace(/\+/g, '%20') : str;
 }
+/**
+ * Updates or adds query parameters on an existing URL string.
+ *
+ * Parses the URL's existing query string, merges in the new parameters (new values
+ * override existing keys), and returns the rebuilt URL. Respects all
+ * {@link MakeUrlSearchParamsOptions} such as `omitKeys`, `filterEmptyValues`, and
+ * `useUrlSearchSpaceHandling`.
+ *
+ * @example
+ * ```typescript
+ * // Add params to a URL with no query string
+ * updateUrlSearchParams('https://example.com/form', { name: 'Alice', age: 30 });
+ * // => 'https://example.com/form?name=Alice&age=30'
+ *
+ * // Override an existing param
+ * updateUrlSearchParams('https://example.com?page=1&sort=asc', { page: 2 });
+ * // => 'https://example.com?page=2&sort=asc'
+ *
+ * // Use percent-encoded spaces for redirect URLs
+ * updateUrlSearchParams('https://example.com', { scope: 'openid profile' }, { useUrlSearchSpaceHandling: true });
+ * // => 'https://example.com?scope=openid%20profile'
+ * ```
+ *
+ * @param url - the URL string to update
+ * @param params - new search parameters to merge into the URL
+ * @param options - optional configuration for filtering, omitting keys, and space encoding
+ * @returns the URL string with updated query parameters
+ */ function updateUrlSearchParams(url, params, options) {
+    var _url_split = _sliced_to_array$1(url.split('?', 2), 2), basePath = _url_split[0], existingQuery = _url_split[1];
+    var existingParams = existingQuery ? new URLSearchParams(existingQuery) : new URLSearchParams();
+    var newParams = makeUrlSearchParams(params, options);
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        // Merge: new params override existing
+        for(var _iterator = newParams.entries()[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var _step_value = _sliced_to_array$1(_step.value, 2), key = _step_value[0], value = _step_value[1];
+            existingParams.set(key, value);
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    // Apply omitKeys to the merged result
+    if ((options === null || options === void 0 ? void 0 : options.omitKeys) != null) {
+        util.useIterableOrValue(options.omitKeys, function(key) {
+            return existingParams.delete(key);
+        }, false);
+    }
+    var queryString = existingParams.toString();
+    if (options === null || options === void 0 ? void 0 : options.useUrlSearchSpaceHandling) {
+        queryString = queryString.replace(/\+/g, '%20');
+    }
+    return queryString ? "".concat(basePath, "?").concat(queryString) : basePath;
+}
 /**
  * Merges an array of MakeUrlSearchParamsOptions into a single MakeUrlSearchParamsOptions value.
  *
@@ -2735,3 +2845,4 @@ exports.rateLimitedFetchHandler = rateLimitedFetchHandler;
 exports.requireOkResponse = requireOkResponse;
 exports.returnNullHandleFetchJsonParseErrorFunction = returnNullHandleFetchJsonParseErrorFunction;
 exports.throwJsonResponseParseErrorFunction = throwJsonResponseParseErrorFunction;
+exports.updateUrlSearchParams = updateUrlSearchParams;

package/fetch/index.esm.js

@@ -279,12 +279,12 @@ var FetchTimeoutError = /*#__PURE__*/ function(BaseError) {
     };
 }
 
-function _array_like_to_array$2(arr, len) {
+function _array_like_to_array$3(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
     for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
     return arr2;
 }
-function _array_with_holes$2(arr) {
+function _array_with_holes$3(arr) {
     if (Array.isArray(arr)) return arr;
 }
 function asyncGeneratorStep$4(gen, resolve, reject, _next, _throw, key, arg) {
@@ -336,7 +336,7 @@ function _instanceof$1(left, right) {
         return left instanceof right;
     }
 }
-function _iterable_to_array_limit$2(arr, i) {
+function _iterable_to_array_limit$3(arr, i) {
     var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
     if (_i == null) return;
     var _arr = [];
@@ -360,7 +360,7 @@ function _iterable_to_array_limit$2(arr, i) {
     }
     return _arr;
 }
-function _non_iterable_rest$2() {
+function _non_iterable_rest$3() {
     throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
 function _object_spread$3(target) {
@@ -397,20 +397,20 @@ function _object_spread_props$2(target, source) {
     }
     return target;
 }
-function _sliced_to_array$2(arr, i) {
-    return _array_with_holes$2(arr) || _iterable_to_array_limit$2(arr, i) || _unsupported_iterable_to_array$2(arr, i) || _non_iterable_rest$2();
+function _sliced_to_array$3(arr, i) {
+    return _array_with_holes$3(arr) || _iterable_to_array_limit$3(arr, i) || _unsupported_iterable_to_array$3(arr, i) || _non_iterable_rest$3();
 }
 function _type_of$3(obj) {
     "@swc/helpers - typeof";
     return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
 }
-function _unsupported_iterable_to_array$2(o, minLen) {
+function _unsupported_iterable_to_array$3(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$2(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$3(o, minLen);
     var n = Object.prototype.toString.call(o).slice(8, -1);
     if (n === "Object" && o.constructor) n = o.constructor.name;
     if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$2(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$3(o, minLen);
 }
 function _ts_generator$4(thisArg, body) {
     var f, y, t, _ = {
@@ -875,7 +875,7 @@ function _ts_generator$4(thisArg, body) {
         var tuples = headersToHeadersTuple(headers);
         var visitedKeysSet = new Set();
         tuples.forEach(function(param) {
-            var _param = _sliced_to_array$2(param, 2), key = _param[0], value = _param[1];
+            var _param = _sliced_to_array$3(param, 2), key = _param[0], value = _param[1];
             if (!visitedKeysSet.has(key)) {
                 headersMap.delete(key); // delete all existing values to "override" them
                 visitedKeysSet.add(key);
@@ -1731,12 +1731,12 @@ var FetchPageLimitReachedError = /*#__PURE__*/ function(FetchRequestFactoryError
     };
 }
 
-function _array_like_to_array$1(arr, len) {
+function _array_like_to_array$2(arr, len) {
     if (len == null || len > arr.length) len = arr.length;
     for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
     return arr2;
 }
-function _array_with_holes$1(arr) {
+function _array_with_holes$2(arr) {
     if (Array.isArray(arr)) return arr;
 }
 function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
@@ -1781,7 +1781,7 @@ function _define_property$1(obj, key, value) {
     }
     return obj;
 }
-function _iterable_to_array_limit$1(arr, i) {
+function _iterable_to_array_limit$2(arr, i) {
     var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
     if (_i == null) return;
     var _arr = [];
@@ -1805,7 +1805,7 @@ function _iterable_to_array_limit$1(arr, i) {
     }
     return _arr;
 }
-function _non_iterable_rest$1() {
+function _non_iterable_rest$2() {
     throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
 function _object_spread$1(target) {
@@ -1842,16 +1842,16 @@ function _object_spread_props$1(target, source) {
     }
     return target;
 }
-function _sliced_to_array$1(arr, i) {
-    return _array_with_holes$1(arr) || _iterable_to_array_limit$1(arr, i) || _unsupported_iterable_to_array$1(arr, i) || _non_iterable_rest$1();
+function _sliced_to_array$2(arr, i) {
+    return _array_with_holes$2(arr) || _iterable_to_array_limit$2(arr, i) || _unsupported_iterable_to_array$2(arr, i) || _non_iterable_rest$2();
 }
-function _unsupported_iterable_to_array$1(o, minLen) {
+function _unsupported_iterable_to_array$2(o, minLen) {
     if (!o) return;
-    if (typeof o === "string") return _array_like_to_array$1(o, minLen);
+    if (typeof o === "string") return _array_like_to_array$2(o, minLen);
     var n = Object.prototype.toString.call(o).slice(8, -1);
     if (n === "Object" && o.constructor) n = o.constructor.name;
     if (n === "Map" || n === "Set") return Array.from(n);
-    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$1(o, minLen);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$2(o, minLen);
 }
 function _ts_generator(thisArg, body) {
     var f, y, t, _ = {
@@ -1998,7 +1998,7 @@ function _ts_generator(thisArg, body) {
                                 return [
                                     2,
                                     performAsyncTasks(itemIndexPairs, function(param) {
-                                        var _param = _sliced_to_array$1(param, 2), item = _param[0], i = _param[1];
+                                        var _param = _sliced_to_array$2(param, 2), item = _param[0], i = _param[1];
                                         return iterateEachPageItem(item, i, fetchPageResult);
                                     }, _object_spread$1({
                                         sequential: true
@@ -2210,6 +2210,52 @@ function iterateFetchPages(config) {
     })();
 }
 
+function _array_like_to_array$1(arr, len) {
+    if (len == null || len > arr.length) len = arr.length;
+    for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
+    return arr2;
+}
+function _array_with_holes$1(arr) {
+    if (Array.isArray(arr)) return arr;
+}
+function _iterable_to_array_limit$1(arr, i) {
+    var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
+    if (_i == null) return;
+    var _arr = [];
+    var _n = true;
+    var _d = false;
+    var _s, _e;
+    try {
+        for(_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true){
+            _arr.push(_s.value);
+            if (i && _arr.length === i) break;
+        }
+    } catch (err) {
+        _d = true;
+        _e = err;
+    } finally{
+        try {
+            if (!_n && _i["return"] != null) _i["return"]();
+        } finally{
+            if (_d) throw _e;
+        }
+    }
+    return _arr;
+}
+function _non_iterable_rest$1() {
+    throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _sliced_to_array$1(arr, i) {
+    return _array_with_holes$1(arr) || _iterable_to_array_limit$1(arr, i) || _unsupported_iterable_to_array$1(arr, i) || _non_iterable_rest$1();
+}
+function _unsupported_iterable_to_array$1(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array$1(o, minLen);
+    var n = Object.prototype.toString.call(o).slice(8, -1);
+    if (n === "Object" && o.constructor) n = o.constructor.name;
+    if (n === "Map" || n === "Set") return Array.from(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$1(o, minLen);
+}
 /**
  * Creates URLSearchParams from the input objects. The input objects are merged together.
  *
@@ -2244,6 +2290,70 @@ function iterateFetchPages(config) {
     var str = params.toString();
     return (options === null || options === void 0 ? void 0 : options.useUrlSearchSpaceHandling) ? str.replace(/\+/g, '%20') : str;
 }
+/**
+ * Updates or adds query parameters on an existing URL string.
+ *
+ * Parses the URL's existing query string, merges in the new parameters (new values
+ * override existing keys), and returns the rebuilt URL. Respects all
+ * {@link MakeUrlSearchParamsOptions} such as `omitKeys`, `filterEmptyValues`, and
+ * `useUrlSearchSpaceHandling`.
+ *
+ * @example
+ * ```typescript
+ * // Add params to a URL with no query string
+ * updateUrlSearchParams('https://example.com/form', { name: 'Alice', age: 30 });
+ * // => 'https://example.com/form?name=Alice&age=30'
+ *
+ * // Override an existing param
+ * updateUrlSearchParams('https://example.com?page=1&sort=asc', { page: 2 });
+ * // => 'https://example.com?page=2&sort=asc'
+ *
+ * // Use percent-encoded spaces for redirect URLs
+ * updateUrlSearchParams('https://example.com', { scope: 'openid profile' }, { useUrlSearchSpaceHandling: true });
+ * // => 'https://example.com?scope=openid%20profile'
+ * ```
+ *
+ * @param url - the URL string to update
+ * @param params - new search parameters to merge into the URL
+ * @param options - optional configuration for filtering, omitting keys, and space encoding
+ * @returns the URL string with updated query parameters
+ */ function updateUrlSearchParams(url, params, options) {
+    var _url_split = _sliced_to_array$1(url.split('?', 2), 2), basePath = _url_split[0], existingQuery = _url_split[1];
+    var existingParams = existingQuery ? new URLSearchParams(existingQuery) : new URLSearchParams();
+    var newParams = makeUrlSearchParams(params, options);
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        // Merge: new params override existing
+        for(var _iterator = newParams.entries()[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var _step_value = _sliced_to_array$1(_step.value, 2), key = _step_value[0], value = _step_value[1];
+            existingParams.set(key, value);
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    // Apply omitKeys to the merged result
+    if ((options === null || options === void 0 ? void 0 : options.omitKeys) != null) {
+        useIterableOrValue(options.omitKeys, function(key) {
+            return existingParams.delete(key);
+        }, false);
+    }
+    var queryString = existingParams.toString();
+    if (options === null || options === void 0 ? void 0 : options.useUrlSearchSpaceHandling) {
+        queryString = queryString.replace(/\+/g, '%20');
+    }
+    return queryString ? "".concat(basePath, "?").concat(queryString) : basePath;
+}
 /**
  * Merges an array of MakeUrlSearchParamsOptions into a single MakeUrlSearchParamsOptions value.
  *
@@ -2689,4 +2799,4 @@ var fetchJsonRequestInit = fetchJsonRequestInitFunction();
     }
 });
 
-export { DEFAULT_FETCH_HANDLER, DEFAULT_FETCH_REQUEST_FACTORY, FETCH_PAGE_FACTORY_DEFAULT_MAX_PAGE, FetchPageLimitReachedError, FetchPageNoNextPageError, FetchRequestFactoryError, FetchResponseError, FetchTimeoutError, JsonResponseParseError, configureFetch, fetchApiFetchService, fetchFileFromUrl, fetchJsonBodyString, fetchJsonFunction, fetchJsonRequestInit, fetchJsonRequestInitFunction, fetchOk, fetchPageFactory, fetchRequestFactory, fetchService, fetchTimeout, fetchURL, fetchURLQueryKeyValueStringTuples, fetchURLSearchParamsObjectToURLSearchParams, fetchUploadFile, headersToHeadersTuple, isFetchRequest, isURL, isURLSearchParams, iterateFetchPages, iterateFetchPagesByEachItem, iterateFetchPagesByItems, makeFileForFetch, makeUrlSearchParams, makeUrlSearchParamsString, mergeMakeUrlSearchParamsOptions, mergeRequestHeaders, mergeRequestInits, parseFetchFileResponse, queryParamsToSearchParams, rateLimitedFetchHandler, requireOkResponse, returnNullHandleFetchJsonParseErrorFunction, throwJsonResponseParseErrorFunction };
+export { DEFAULT_FETCH_HANDLER, DEFAULT_FETCH_REQUEST_FACTORY, FETCH_PAGE_FACTORY_DEFAULT_MAX_PAGE, FetchPageLimitReachedError, FetchPageNoNextPageError, FetchRequestFactoryError, FetchResponseError, FetchTimeoutError, JsonResponseParseError, configureFetch, fetchApiFetchService, fetchFileFromUrl, fetchJsonBodyString, fetchJsonFunction, fetchJsonRequestInit, fetchJsonRequestInitFunction, fetchOk, fetchPageFactory, fetchRequestFactory, fetchService, fetchTimeout, fetchURL, fetchURLQueryKeyValueStringTuples, fetchURLSearchParamsObjectToURLSearchParams, fetchUploadFile, headersToHeadersTuple, isFetchRequest, isURL, isURLSearchParams, iterateFetchPages, iterateFetchPagesByEachItem, iterateFetchPagesByItems, makeFileForFetch, makeUrlSearchParams, makeUrlSearchParamsString, mergeMakeUrlSearchParamsOptions, mergeRequestHeaders, mergeRequestInits, parseFetchFileResponse, queryParamsToSearchParams, rateLimitedFetchHandler, requireOkResponse, returnNullHandleFetchJsonParseErrorFunction, throwJsonResponseParseErrorFunction, updateUrlSearchParams };

package/fetch/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@dereekb/util/fetch",
-  "version": "13.6.1",
+  "version": "13.6.3",
   "peerDependencies": {
-    "@dereekb/util": "13.6.1",
+    "@dereekb/util": "13.6.3",
     "make-error": "^1.3.0",
     "fast-content-type-parse": "^3.0.0"
   },

package/fetch/src/lib/fetch.url.d.ts

@@ -52,6 +52,35 @@ export declare function makeUrlSearchParams(input: Maybe<ArrayOrValue<Maybe<obje
  * @returns the encoded query string (without a leading `?`)
  */
 export declare function makeUrlSearchParamsString(input: Maybe<ArrayOrValue<Maybe<object | Record<string, string | number>>>>, options?: Maybe<MakeUrlSearchParamsOptions>): string;
+/**
+ * Updates or adds query parameters on an existing URL string.
+ *
+ * Parses the URL's existing query string, merges in the new parameters (new values
+ * override existing keys), and returns the rebuilt URL. Respects all
+ * {@link MakeUrlSearchParamsOptions} such as `omitKeys`, `filterEmptyValues`, and
+ * `useUrlSearchSpaceHandling`.
+ *
+ * @example
+ * ```typescript
+ * // Add params to a URL with no query string
+ * updateUrlSearchParams('https://example.com/form', { name: 'Alice', age: 30 });
+ * // => 'https://example.com/form?name=Alice&age=30'
+ *
+ * // Override an existing param
+ * updateUrlSearchParams('https://example.com?page=1&sort=asc', { page: 2 });
+ * // => 'https://example.com?page=2&sort=asc'
+ *
+ * // Use percent-encoded spaces for redirect URLs
+ * updateUrlSearchParams('https://example.com', { scope: 'openid profile' }, { useUrlSearchSpaceHandling: true });
+ * // => 'https://example.com?scope=openid%20profile'
+ * ```
+ *
+ * @param url - the URL string to update
+ * @param params - new search parameters to merge into the URL
+ * @param options - optional configuration for filtering, omitting keys, and space encoding
+ * @returns the URL string with updated query parameters
+ */
+export declare function updateUrlSearchParams(url: string, params: Maybe<ArrayOrValue<Maybe<object | Record<string, string | number>>>>, options?: Maybe<MakeUrlSearchParamsOptions>): string;
 /**
  * Merges an array of MakeUrlSearchParamsOptions into a single MakeUrlSearchParamsOptions value.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/util",
-  "version": "13.6.1",
+  "version": "13.6.3",
   "exports": {
     "./test": {
       "module": "./test/index.esm.js",

package/test/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@dereekb/util/test",
-  "version": "13.6.1",
+  "version": "13.6.3",
   "peerDependencies": {
-    "@dereekb/util": "13.6.1",
+    "@dereekb/util": "13.6.3",
     "make-error": "^1.3.0"
   },
   "exports": {