@dereekb/util 13.34.0 → 13.36.0

package/eslint/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@dereekb/util/eslint",
-  "version": "13.34.0",
+  "version": "13.36.0",
   "peerDependencies": {
-    "@dereekb/util": "13.34.0",
+    "@dereekb/util": "13.36.0",
     "@typescript-eslint/utils": "8.59.3",
     "typescript": "5.9.3"
   },

package/fetch/index.cjs.js

@@ -52,7 +52,7 @@ function _inherits$3(subClass, superClass) {
     if (superClass) _set_prototype_of$3(subClass, superClass);
 }
 function _possible_constructor_return$3(self, call) {
-    if (call && (_type_of$5(call) === "object" || typeof call === "function")) {
+    if (call && (_type_of$6(call) === "object" || typeof call === "function")) {
         return call;
     }
     return _assert_this_initialized$3(self);
@@ -64,7 +64,7 @@ function _set_prototype_of$3(o, p) {
     };
     return _set_prototype_of$3(o, p);
 }
-function _type_of$5(obj) {
+function _type_of$6(obj) {
     "@swc/helpers - typeof";
     return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
 }
@@ -84,7 +84,7 @@ function _is_native_reflect_construct$3() {
         _class_call_check$3(this, FetchRequestFactoryError);
         var _this;
         _this = _call_super$3(this, FetchRequestFactoryError, [
-            "Fetch request failed to build due to an unexpected error: ".concat((typeof error === "undefined" ? "undefined" : _type_of$5(error)) === 'object' ? error.message : error)
+            "Fetch request failed to build due to an unexpected error: ".concat((typeof error === "undefined" ? "undefined" : _type_of$6(error)) === 'object' ? error.message : error)
         ]), _define_property$5(_this, "error", void 0);
         _this.error = error;
         return _this;
@@ -210,7 +210,7 @@ function _object_spread_props$3(target, source) {
     return target;
 }
 function _possible_constructor_return$2(self, call) {
-    if (call && (_type_of$4(call) === "object" || typeof call === "function")) {
+    if (call && (_type_of$5(call) === "object" || typeof call === "function")) {
         return call;
     }
     return _assert_this_initialized$2(self);
@@ -222,7 +222,7 @@ function _set_prototype_of$2(o, p) {
     };
     return _set_prototype_of$2(o, p);
 }
-function _type_of$4(obj) {
+function _type_of$5(obj) {
     "@swc/helpers - typeof";
     return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
 }
@@ -403,7 +403,7 @@ function _object_spread_props$2(target, source) {
 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) {
+function _type_of$4(obj) {
     "@swc/helpers - typeof";
     return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
 }
@@ -904,7 +904,7 @@ function _ts_generator$4(thisArg, body) {
                 value
             ]);
         });
-    } else if ((typeof headers === "undefined" ? "undefined" : _type_of$3(headers)) === 'object') {
+    } else if ((typeof headers === "undefined" ? "undefined" : _type_of$4(headers)) === 'object') {
         // use as a normal object
         tuples = Object.entries(headers);
     }
@@ -1469,7 +1469,7 @@ function _object_spread$2(target) {
     return target;
 }
 function _possible_constructor_return$1(self, call) {
-    if (call && (_type_of$2(call) === "object" || typeof call === "function")) {
+    if (call && (_type_of$3(call) === "object" || typeof call === "function")) {
         return call;
     }
     return _assert_this_initialized$1(self);
@@ -1481,7 +1481,7 @@ function _set_prototype_of$1(o, p) {
     };
     return _set_prototype_of$1(o, p);
 }
-function _type_of$2(obj) {
+function _type_of$3(obj) {
     "@swc/helpers - typeof";
     return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
 }
@@ -2258,6 +2258,10 @@ function _non_iterable_rest$1() {
 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 _type_of$2(obj) {
+    "@swc/helpers - typeof";
+    return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
+}
 function _unsupported_iterable_to_array$1(o, minLen) {
     if (!o) return;
     if (typeof o === "string") return _array_like_to_array$1(o, minLen);
@@ -2266,6 +2270,48 @@ function _unsupported_iterable_to_array$1(o, minLen) {
     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);
 }
+/**
+ * Expands a potentially nested object into bracket-notation query key/value tuples.
+ *
+ * Arrays are addressed by index and object properties by key, recursively, so every leaf
+ * gets its own fully-qualified parameter. Nullish leaves are omitted rather than emitted
+ * as the strings `"null"`/`"undefined"`; all other leaves are stringified.
+ *
+ * @param input - The object to expand.
+ * @returns The bracket-notation key/value tuples.
+ *
+ * @example
+ * ```typescript
+ * toBracketNotationSearchParamTuples({ calendarsToLoad: [{ credentialId: 1, externalId: 'a@b.com' }] });
+ * // => [['calendarsToLoad[0][credentialId]', '1'], ['calendarsToLoad[0][externalId]', 'a@b.com']]
+ * ```
+ */ function toBracketNotationSearchParamTuples(input) {
+    var tuples = [];
+    function expandValue(key, value) {
+        if (value != null) {
+            if (Array.isArray(value)) {
+                value.forEach(function(itemValue, i) {
+                    return expandValue("".concat(key, "[").concat(i, "]"), itemValue);
+                });
+            } else if ((typeof value === "undefined" ? "undefined" : _type_of$2(value)) === 'object') {
+                Object.entries(value).forEach(function(param) {
+                    var _param = _sliced_to_array$1(param, 2), childKey = _param[0], childValue = _param[1];
+                    return expandValue("".concat(key, "[").concat(childKey, "]"), childValue);
+                });
+            } else {
+                tuples.push([
+                    key,
+                    String(value)
+                ]);
+            }
+        }
+    }
+    Object.entries(input !== null && input !== void 0 ? input : {}).forEach(function(param) {
+        var _param = _sliced_to_array$1(param, 2), key = _param[0], value = _param[1];
+        return expandValue(key, value);
+    });
+    return tuples;
+}
 /**
  * Creates URLSearchParams from the input objects. The input objects are merged together.
  *
@@ -2273,10 +2319,11 @@ function _unsupported_iterable_to_array$1(o, minLen) {
  * @param options - Optional configuration for filtering, omitting keys, and space encoding.
  * @returns A URLSearchParams instance built from the merged and filtered input.
  */ function makeUrlSearchParams(input, options) {
-    var _ref = options !== null && options !== void 0 ? options : {}, omitKeys = _ref.omitKeys, filterValues = _ref.filterEmptyValues;
+    var _ref = options !== null && options !== void 0 ? options : {}, omitKeys = _ref.omitKeys, filterValues = _ref.filterEmptyValues, useBracketNotation = _ref.useBracketNotation;
     var mergedInput = Array.isArray(input) ? util.mergeObjects(input) : input;
     var filteredInput = (filterValues !== null && filterValues !== void 0 ? filterValues : true) ? util.filterEmptyPojoValues(mergedInput !== null && mergedInput !== void 0 ? mergedInput : {}) : mergedInput;
-    var searchParams = new URLSearchParams(filteredInput);
+    var searchParamsInput = useBracketNotation ? toBracketNotationSearchParamTuples(filteredInput) : filteredInput;
+    var searchParams = new URLSearchParams(searchParamsInput);
     if (omitKeys != null) {
         util.useIterableOrValue(omitKeys, function(key) {
             return searchParams.delete(key);
@@ -2857,4 +2904,5 @@ exports.rateLimitedFetchHandler = rateLimitedFetchHandler;
 exports.requireOkResponse = requireOkResponse;
 exports.returnNullHandleFetchJsonParseErrorFunction = returnNullHandleFetchJsonParseErrorFunction;
 exports.throwJsonResponseParseErrorFunction = throwJsonResponseParseErrorFunction;
+exports.toBracketNotationSearchParamTuples = toBracketNotationSearchParamTuples;
 exports.updateUrlSearchParams = updateUrlSearchParams;

package/fetch/index.esm.js

@@ -50,7 +50,7 @@ function _inherits$3(subClass, superClass) {
     if (superClass) _set_prototype_of$3(subClass, superClass);
 }
 function _possible_constructor_return$3(self, call) {
-    if (call && (_type_of$5(call) === "object" || typeof call === "function")) {
+    if (call && (_type_of$6(call) === "object" || typeof call === "function")) {
         return call;
     }
     return _assert_this_initialized$3(self);
@@ -62,7 +62,7 @@ function _set_prototype_of$3(o, p) {
     };
     return _set_prototype_of$3(o, p);
 }
-function _type_of$5(obj) {
+function _type_of$6(obj) {
     "@swc/helpers - typeof";
     return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
 }
@@ -82,7 +82,7 @@ function _is_native_reflect_construct$3() {
         _class_call_check$3(this, FetchRequestFactoryError);
         var _this;
         _this = _call_super$3(this, FetchRequestFactoryError, [
-            "Fetch request failed to build due to an unexpected error: ".concat((typeof error === "undefined" ? "undefined" : _type_of$5(error)) === 'object' ? error.message : error)
+            "Fetch request failed to build due to an unexpected error: ".concat((typeof error === "undefined" ? "undefined" : _type_of$6(error)) === 'object' ? error.message : error)
         ]), _define_property$5(_this, "error", void 0);
         _this.error = error;
         return _this;
@@ -208,7 +208,7 @@ function _object_spread_props$3(target, source) {
     return target;
 }
 function _possible_constructor_return$2(self, call) {
-    if (call && (_type_of$4(call) === "object" || typeof call === "function")) {
+    if (call && (_type_of$5(call) === "object" || typeof call === "function")) {
         return call;
     }
     return _assert_this_initialized$2(self);
@@ -220,7 +220,7 @@ function _set_prototype_of$2(o, p) {
     };
     return _set_prototype_of$2(o, p);
 }
-function _type_of$4(obj) {
+function _type_of$5(obj) {
     "@swc/helpers - typeof";
     return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
 }
@@ -401,7 +401,7 @@ function _object_spread_props$2(target, source) {
 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) {
+function _type_of$4(obj) {
     "@swc/helpers - typeof";
     return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
 }
@@ -902,7 +902,7 @@ function _ts_generator$4(thisArg, body) {
                 value
             ]);
         });
-    } else if ((typeof headers === "undefined" ? "undefined" : _type_of$3(headers)) === 'object') {
+    } else if ((typeof headers === "undefined" ? "undefined" : _type_of$4(headers)) === 'object') {
         // use as a normal object
         tuples = Object.entries(headers);
     }
@@ -1467,7 +1467,7 @@ function _object_spread$2(target) {
     return target;
 }
 function _possible_constructor_return$1(self, call) {
-    if (call && (_type_of$2(call) === "object" || typeof call === "function")) {
+    if (call && (_type_of$3(call) === "object" || typeof call === "function")) {
         return call;
     }
     return _assert_this_initialized$1(self);
@@ -1479,7 +1479,7 @@ function _set_prototype_of$1(o, p) {
     };
     return _set_prototype_of$1(o, p);
 }
-function _type_of$2(obj) {
+function _type_of$3(obj) {
     "@swc/helpers - typeof";
     return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
 }
@@ -2256,6 +2256,10 @@ function _non_iterable_rest$1() {
 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 _type_of$2(obj) {
+    "@swc/helpers - typeof";
+    return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
+}
 function _unsupported_iterable_to_array$1(o, minLen) {
     if (!o) return;
     if (typeof o === "string") return _array_like_to_array$1(o, minLen);
@@ -2264,6 +2268,48 @@ function _unsupported_iterable_to_array$1(o, minLen) {
     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);
 }
+/**
+ * Expands a potentially nested object into bracket-notation query key/value tuples.
+ *
+ * Arrays are addressed by index and object properties by key, recursively, so every leaf
+ * gets its own fully-qualified parameter. Nullish leaves are omitted rather than emitted
+ * as the strings `"null"`/`"undefined"`; all other leaves are stringified.
+ *
+ * @param input - The object to expand.
+ * @returns The bracket-notation key/value tuples.
+ *
+ * @example
+ * ```typescript
+ * toBracketNotationSearchParamTuples({ calendarsToLoad: [{ credentialId: 1, externalId: 'a@b.com' }] });
+ * // => [['calendarsToLoad[0][credentialId]', '1'], ['calendarsToLoad[0][externalId]', 'a@b.com']]
+ * ```
+ */ function toBracketNotationSearchParamTuples(input) {
+    var tuples = [];
+    function expandValue(key, value) {
+        if (value != null) {
+            if (Array.isArray(value)) {
+                value.forEach(function(itemValue, i) {
+                    return expandValue("".concat(key, "[").concat(i, "]"), itemValue);
+                });
+            } else if ((typeof value === "undefined" ? "undefined" : _type_of$2(value)) === 'object') {
+                Object.entries(value).forEach(function(param) {
+                    var _param = _sliced_to_array$1(param, 2), childKey = _param[0], childValue = _param[1];
+                    return expandValue("".concat(key, "[").concat(childKey, "]"), childValue);
+                });
+            } else {
+                tuples.push([
+                    key,
+                    String(value)
+                ]);
+            }
+        }
+    }
+    Object.entries(input !== null && input !== void 0 ? input : {}).forEach(function(param) {
+        var _param = _sliced_to_array$1(param, 2), key = _param[0], value = _param[1];
+        return expandValue(key, value);
+    });
+    return tuples;
+}
 /**
  * Creates URLSearchParams from the input objects. The input objects are merged together.
  *
@@ -2271,10 +2317,11 @@ function _unsupported_iterable_to_array$1(o, minLen) {
  * @param options - Optional configuration for filtering, omitting keys, and space encoding.
  * @returns A URLSearchParams instance built from the merged and filtered input.
  */ function makeUrlSearchParams(input, options) {
-    var _ref = options !== null && options !== void 0 ? options : {}, omitKeys = _ref.omitKeys, filterValues = _ref.filterEmptyValues;
+    var _ref = options !== null && options !== void 0 ? options : {}, omitKeys = _ref.omitKeys, filterValues = _ref.filterEmptyValues, useBracketNotation = _ref.useBracketNotation;
     var mergedInput = Array.isArray(input) ? mergeObjects(input) : input;
     var filteredInput = (filterValues !== null && filterValues !== void 0 ? filterValues : true) ? filterEmptyPojoValues(mergedInput !== null && mergedInput !== void 0 ? mergedInput : {}) : mergedInput;
-    var searchParams = new URLSearchParams(filteredInput);
+    var searchParamsInput = useBracketNotation ? toBracketNotationSearchParamTuples(filteredInput) : filteredInput;
+    var searchParams = new URLSearchParams(searchParamsInput);
     if (omitKeys != null) {
         useIterableOrValue(omitKeys, function(key) {
             return searchParams.delete(key);
@@ -2811,4 +2858,4 @@ var fetchJsonRequestInit = fetchJsonRequestInitFunction();
     }
 });
 
-export { DEFAULT_FETCH_HANDLER, DEFAULT_FETCH_PAGE_FACTORY_MAX_PAGE, DEFAULT_FETCH_REQUEST_FACTORY, 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 };
+export { DEFAULT_FETCH_HANDLER, DEFAULT_FETCH_PAGE_FACTORY_MAX_PAGE, DEFAULT_FETCH_REQUEST_FACTORY, 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, toBracketNotationSearchParamTuples, updateUrlSearchParams };

package/fetch/package.json

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

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

@@ -30,7 +30,43 @@ export interface MakeUrlSearchParamsOptions {
      * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/URLSearchParams#interaction_with_url.searchparams | MDN: Interaction with URL.searchParams}
      */
     readonly useUrlSearchSpaceHandling?: boolean;
+    /**
+     * Whether to expand nested arrays and objects into bracket-notation keys instead of
+     * letting `URLSearchParams` stringify them.
+     *
+     * `URLSearchParams` calls `String()` on every value, so by default an array is comma-joined
+     * and a nested object collapses to the useless `[object Object]`. Many APIs instead expect
+     * each leaf addressed by an indexed/keyed path:
+     *
+     * `{ a: [{ b: 1 }] }` becomes `a[0][b]=1` rather than `a=[object Object]`.
+     *
+     * Scalar values are unaffected. Nullish leaves are skipped.
+     *
+     * Defaults to false.
+     */
+    readonly useBracketNotation?: boolean;
 }
+/**
+ * A single URL query parameter, as a key/value tuple.
+ */
+export type UrlSearchParamsKeyValueTuple = [string, string];
+/**
+ * Expands a potentially nested object into bracket-notation query key/value tuples.
+ *
+ * Arrays are addressed by index and object properties by key, recursively, so every leaf
+ * gets its own fully-qualified parameter. Nullish leaves are omitted rather than emitted
+ * as the strings `"null"`/`"undefined"`; all other leaves are stringified.
+ *
+ * @param input - The object to expand.
+ * @returns The bracket-notation key/value tuples.
+ *
+ * @example
+ * ```typescript
+ * toBracketNotationSearchParamTuples({ calendarsToLoad: [{ credentialId: 1, externalId: 'a@b.com' }] });
+ * // => [['calendarsToLoad[0][credentialId]', '1'], ['calendarsToLoad[0][externalId]', 'a@b.com']]
+ * ```
+ */
+export declare function toBracketNotationSearchParamTuples(input: Maybe<object>): UrlSearchParamsKeyValueTuple[];
 /**
  * Creates URLSearchParams from the input objects. The input objects are merged together.
  *

package/oidc/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@dereekb/util/oidc",
-  "version": "13.34.0",
+  "version": "13.36.0",
   "peerDependencies": {
-    "@dereekb/util": "13.34.0"
+    "@dereekb/util": "13.36.0"
   },
   "exports": {
     "./package.json": "./package.json",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/util",
-  "version": "13.34.0",
+  "version": "13.36.0",
   "sideEffects": false,
   "exports": {
     "./test": {

package/test/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@dereekb/util/test",
-  "version": "13.34.0",
+  "version": "13.36.0",
   "peerDependencies": {
-    "@dereekb/util": "13.34.0",
+    "@dereekb/util": "13.36.0",
     "make-error": "^1.3.6"
   },
   "exports": {