@warp-drive/utilities 5.9.0-alpha.2 → 5.9.0-alpha.21

package/dist/unpkg/dev-deprecated/index.js

@@ -1,362 +1,382 @@
-import { getOrSetGlobal } from '@warp-drive/core/types/-private';
+import { getOrSetGlobal } from "@warp-drive/core/types/-private";
 
+//#region src/index.ts
 /**
- * @module
- * @mergeModuleWith <project>
- */
-
-// prevents the final constructed object from needing to add
-// host and namespace which are provided by the final consuming
-// class to the prototype which can result in overwrite errors
-
-const CONFIG = getOrSetGlobal('CONFIG', {
-  host: '',
-  namespace: ''
+* @module
+* @mergeModuleWith <project>
+*/
+/**
+* The global configuration used by {@link buildBaseURL} when a call does
+* not provide its own `host`/`namespace`. Set via {@link setBuildURLConfig}.
+*
+* @public
+*/
+const CONFIG = getOrSetGlobal("CONFIG", {
+	host: "",
+	namespace: ""
 });
-
 /**
- * Sets the global configuration for `buildBaseURL`
- * for host and namespace values for the application.
- *
- * These values may still be overridden by passing
- * them to buildBaseURL directly.
- *
- * This method may be called as many times as needed.
- * host values of `''` or `'/'` are equivalent.
- *
- * Except for the value of `/` as host, host should not
- * end with `/`.
- *
- * namespace should not start or end with a `/`.
- *
- * ```ts
- * type BuildURLConfig = {
- *   host: string;
- *   namespace: string'
- * }
- * ```
- *
- * Example:
- *
- * ```ts
- * import { setBuildURLConfig } from '@warp-drive/utilities';
- *
- * setBuildURLConfig({
- *   host: 'https://api.example.com',
- *   namespace: 'api/v1'
- * });
- * ```
- *
- * @public
- */
+* Sets the global configuration for `buildBaseURL`
+* for host and namespace values for the application.
+*
+* These values may still be overridden by passing
+* them to buildBaseURL directly.
+*
+* This method may be called as many times as needed.
+* host values of `''` or `'/'` are equivalent.
+*
+* Except for the value of `/` as host, host should not
+* end with `/`.
+*
+* namespace should not start or end with a `/`.
+*
+* ```ts
+* type BuildURLConfig = {
+*   host: string;
+*   namespace: string'
+* }
+* ```
+*
+* Example:
+*
+* ```ts
+* import { setBuildURLConfig } from '@warp-drive/utilities';
+*
+* setBuildURLConfig({
+*   host: 'https://api.example.com',
+*   namespace: 'api/v1'
+* });
+* ```
+*
+* @public
+*/
 function setBuildURLConfig(config) {
-  (test => {
-    if (!test) {
-      throw new Error(`setBuildURLConfig: You must pass a config object`);
-    }
-  })(config);
-  (test => {
-    if (!test) {
-      throw new Error(`setBuildURLConfig: You must pass a config object with a 'host' or 'namespace' property`);
-    }
-  })('host' in config || 'namespace' in config);
-  CONFIG.host = config.host || '';
-  CONFIG.namespace = config.namespace || '';
-  (test => {
-    if (!test) {
-      throw new Error(`buildBaseURL: host must NOT end with '/', received '${CONFIG.host}'`);
-    }
-  })(CONFIG.host === '/' || !CONFIG.host.endsWith('/'));
-  (test => {
-    if (!test) {
-      throw new Error(`buildBaseURL: namespace must NOT start with '/', received '${CONFIG.namespace}'`);
-    }
-  })(!CONFIG.namespace.startsWith('/'));
-  (test => {
-    if (!test) {
-      throw new Error(`buildBaseURL: namespace must NOT end with '/', received '${CONFIG.namespace}'`);
-    }
-  })(!CONFIG.namespace.endsWith('/'));
+	((test) => {
+		if (!test) throw new Error(`setBuildURLConfig: You must pass a config object`);
+	})(config);
+	((test) => {
+		if (!test) throw new Error(`setBuildURLConfig: You must pass a config object with a 'host' or 'namespace' property`);
+	})("host" in config || "namespace" in config);
+	CONFIG.host = config.host || "";
+	CONFIG.namespace = config.namespace || "";
+	((test) => {
+		if (!test) throw new Error(`buildBaseURL: host must NOT end with '/', received '${CONFIG.host}'`);
+	})(CONFIG.host === "/" || !CONFIG.host.endsWith("/"));
+	((test) => {
+		if (!test) throw new Error(`buildBaseURL: namespace must NOT start with '/', received '${CONFIG.namespace}'`);
+	})(!CONFIG.namespace.startsWith("/"));
+	((test) => {
+		if (!test) throw new Error(`buildBaseURL: namespace must NOT end with '/', received '${CONFIG.namespace}'`);
+	})(!CONFIG.namespace.endsWith("/"));
 }
-const OPERATIONS_WITH_PRIMARY_RECORDS = new Set(['findRecord', 'findRelatedRecord', 'findRelatedCollection', 'updateRecord', 'deleteRecord']);
+/**
+* {@link buildBaseURL} options for a `findRecord` request.
+*
+* @public
+*/
+/**
+* {@link buildBaseURL} options for a `query` request.
+*
+* @public
+*/
+/**
+* {@link buildBaseURL} options for a `findMany` request.
+*
+* @public
+*/
+/**
+* {@link buildBaseURL} options for a `findRelatedCollection` request.
+*
+* @public
+*/
+/**
+* {@link buildBaseURL} options for a `findRelatedRecord` request.
+*
+* @public
+*/
+/**
+* {@link buildBaseURL} options for a `createRecord` request.
+*
+* @public
+*/
+/**
+* {@link buildBaseURL} options for an `updateRecord` request.
+*
+* @public
+*/
+/**
+* {@link buildBaseURL} options for a `deleteRecord` request.
+*
+* @public
+*/
+/**
+* {@link buildBaseURL} options for building a URL directly from a `resourcePath`
+* without an associated request operation.
+*
+* @public
+*/
+/**
+* The union of all `op`-specific option shapes accepted by {@link buildBaseURL}, one of:
+*
+* - {@link FindRecordUrlOptions}
+* - {@link QueryUrlOptions}
+* - {@link FindManyUrlOptions}
+* - {@link FindRelatedCollectionUrlOptions}
+* - {@link FindRelatedResourceUrlOptions}
+* - {@link CreateRecordUrlOptions}
+* - {@link UpdateRecordUrlOptions}
+* - {@link DeleteRecordUrlOptions}
+* - {@link GenericUrlOptions}
+*
+* @public
+*/
+const OPERATIONS_WITH_PRIMARY_RECORDS = /* @__PURE__ */ new Set([
+	"findRecord",
+	"findRelatedRecord",
+	"findRelatedCollection",
+	"updateRecord",
+	"deleteRecord"
+]);
 function isOperationWithPrimaryRecord(options) {
-  return 'op' in options && OPERATIONS_WITH_PRIMARY_RECORDS.has(options.op);
+	return "op" in options && OPERATIONS_WITH_PRIMARY_RECORDS.has(options.op);
 }
 function hasResourcePath(options) {
-  return 'resourcePath' in options && typeof options.resourcePath === 'string' && options.resourcePath.length > 0;
+	return "resourcePath" in options && typeof options.resourcePath === "string" && options.resourcePath.length > 0;
 }
 function resourcePathForType(options) {
-  (test => {
-    if (!test) {
-      throw new Error(`resourcePathForType: You must pass a valid op as part of options`);
-    }
-  })('op' in options && typeof options.op === 'string');
-  return options.op === 'findMany' ? options.identifiers[0].type : options.identifier.type;
+	((test) => {
+		if (!test) throw new Error(`resourcePathForType: You must pass a valid op as part of options`);
+	})("op" in options && typeof options.op === "string");
+	return options.op === "findMany" ? options.identifiers[0].type : options.identifier.type;
 }
-
 /**
- * Builds a URL for a request based on the provided options.
- * Does not include support for building query params (see `buildQueryParams`)
- * so that it may be composed cleanly with other query-params strategies.
- *
- * Usage:
- *
- * ```ts
- * import { buildBaseURL } from '@warp-drive/utilities';
- *
- * const url = buildBaseURL({
- *   host: 'https://api.example.com',
- *   namespace: 'api/v1',
- *   resourcePath: 'emberDevelopers',
- *   op: 'query',
- *   identifier: { type: 'ember-developer' }
- * });
- *
- * // => 'https://api.example.com/api/v1/emberDevelopers'
- * ```
- *
- * On the surface this may seem like a lot of work to do something simple, but
- * it is designed to be composable with other utilities and interfaces that the
- * average product engineer will never need to see or use.
- *
- * A few notes:
- *
- * - `resourcePath` is optional, but if it is not provided, `identifier.type` will be used.
- * - `host` and `namespace` are optional, but if they are not provided, the values globally
- *    configured via `setBuildURLConfig` will be used.
- * - `op` is required and must be one of the following:
- *   - 'findRecord' 'query' 'findMany' 'findRelatedCollection' 'findRelatedRecord'` 'createRecord' 'updateRecord' 'deleteRecord'
- * - Depending on the value of `op`, `identifier` or `identifiers` will be required.
- *
- * @public
- */
+* Builds a URL for a request based on the provided options.
+* Does not include support for building query params (see `buildQueryParams`)
+* so that it may be composed cleanly with other query-params strategies.
+*
+* Usage:
+*
+* ```ts
+* import { buildBaseURL } from '@warp-drive/utilities';
+*
+* const url = buildBaseURL({
+*   host: 'https://api.example.com',
+*   namespace: 'api/v1',
+*   resourcePath: 'emberDevelopers',
+*   op: 'query',
+*   identifier: { type: 'ember-developer' }
+* });
+*
+* // => 'https://api.example.com/api/v1/emberDevelopers'
+* ```
+*
+* On the surface this may seem like a lot of work to do something simple, but
+* it is designed to be composable with other utilities and interfaces that the
+* average product engineer will never need to see or use.
+*
+* A few notes:
+*
+* - `resourcePath` is optional, but if it is not provided, `identifier.type` will be used.
+* - `host` and `namespace` are optional, but if they are not provided, the values globally
+*    configured via `setBuildURLConfig` will be used.
+* - `op` is required and must be one of the following:
+*   - 'findRecord' 'query' 'findMany' 'findRelatedCollection' 'findRelatedRecord'` 'createRecord' 'updateRecord' 'deleteRecord'
+* - Depending on the value of `op`, `identifier` or `identifiers` will be required.
+*
+* @public
+*/
 function buildBaseURL(urlOptions) {
-  const options = Object.assign({
-    host: CONFIG.host,
-    namespace: CONFIG.namespace
-  }, urlOptions);
-  (test => {
-    if (!test) {
-      throw new Error(`buildBaseURL: You must pass \`op\` as part of options`);
-    }
-  })(hasResourcePath(options) || typeof options.op === 'string' && options.op.length > 0);
-  (test => {
-    if (!test) {
-      throw new Error(`buildBaseURL: You must pass \`identifier\` as part of options`);
-    }
-  })(hasResourcePath(options) || options.op === 'findMany' || options.identifier && typeof options.identifier === 'object');
-  (test => {
-    if (!test) {
-      throw new Error(`buildBaseURL: You must pass \`identifiers\` as part of options`);
-    }
-  })(hasResourcePath(options) || options.op !== 'findMany' || options.identifiers && Array.isArray(options.identifiers) && options.identifiers.length > 0 && options.identifiers.every(i => i && typeof i === 'object'));
-  (test => {
-    if (!test) {
-      throw new Error(`buildBaseURL: You must pass valid \`identifier\` as part of options, expected 'id'`);
-    }
-  })(hasResourcePath(options) || !isOperationWithPrimaryRecord(options) || typeof options.identifier.id === 'string' && options.identifier.id.length > 0);
-  (test => {
-    if (!test) {
-      throw new Error(`buildBaseURL: You must pass \`identifiers\` as part of options`);
-    }
-  })(hasResourcePath(options) || options.op !== 'findMany' || options.identifiers.every(i => typeof i.id === 'string' && i.id.length > 0));
-  (test => {
-    if (!test) {
-      throw new Error(`buildBaseURL: You must pass valid \`identifier\` as part of options, expected 'type'`);
-    }
-  })(hasResourcePath(options) || options.op === 'findMany' || typeof options.identifier.type === 'string' && options.identifier.type.length > 0);
-  (test => {
-    if (!test) {
-      throw new Error(`buildBaseURL: You must pass valid \`identifiers\` as part of options, expected 'type'`);
-    }
-  })(hasResourcePath(options) || options.op !== 'findMany' || typeof options.identifiers[0].type === 'string' && options.identifiers[0].type.length > 0);
-
-  // prettier-ignore
-  const idPath = isOperationWithPrimaryRecord(options) ? encodeURIComponent(options.identifier.id) : '';
-  const resourcePath = options.resourcePath || resourcePathForType(options);
-  const {
-    host,
-    namespace
-  } = options;
-  const fieldPath = 'fieldPath' in options ? options.fieldPath : '';
-  (test => {
-    if (!test) {
-      throw new Error(`buildBaseURL: You tried to build a url for a ${String('op' in options ? options.op + ' ' : '')}request to ${resourcePath} but resourcePath must be set or op must be one of "${['findRecord', 'findRelatedRecord', 'findRelatedCollection', 'updateRecord', 'deleteRecord', 'createRecord', 'query', 'findMany'].join('","')}".`);
-    }
-  })(hasResourcePath(options) || ['findRecord', 'query', 'findMany', 'findRelatedCollection', 'findRelatedRecord', 'createRecord', 'updateRecord', 'deleteRecord'].includes(options.op));
-  (test => {
-    if (!test) {
-      throw new Error(`buildBaseURL: host must NOT end with '/', received '${host}'`);
-    }
-  })(host === '/' || !host.endsWith('/'));
-  (test => {
-    if (!test) {
-      throw new Error(`buildBaseURL: namespace must NOT start with '/', received '${namespace}'`);
-    }
-  })(!namespace.startsWith('/'));
-  (test => {
-    if (!test) {
-      throw new Error(`buildBaseURL: namespace must NOT end with '/', received '${namespace}'`);
-    }
-  })(!namespace.endsWith('/'));
-  (test => {
-    if (!test) {
-      throw new Error(`buildBaseURL: resourcePath must NOT start with '/', received '${resourcePath}'`);
-    }
-  })(!resourcePath.startsWith('/'));
-  (test => {
-    if (!test) {
-      throw new Error(`buildBaseURL: resourcePath must NOT end with '/', received '${resourcePath}'`);
-    }
-  })(!resourcePath.endsWith('/'));
-  (test => {
-    if (!test) {
-      throw new Error(`buildBaseURL: fieldPath must NOT start with '/', received '${fieldPath}'`);
-    }
-  })(!fieldPath.startsWith('/'));
-  (test => {
-    if (!test) {
-      throw new Error(`buildBaseURL: fieldPath must NOT end with '/', received '${fieldPath}'`);
-    }
-  })(!fieldPath.endsWith('/'));
-  (test => {
-    if (!test) {
-      throw new Error(`buildBaseURL: idPath must NOT start with '/', received '${idPath}'`);
-    }
-  })(!idPath.startsWith('/'));
-  (test => {
-    if (!test) {
-      throw new Error(`buildBaseURL: idPath must NOT end with '/', received '${idPath}'`);
-    }
-  })(!idPath.endsWith('/'));
-  const hasHost = host !== '' && host !== '/';
-  const url = [hasHost ? host : '', namespace, resourcePath, idPath, fieldPath].filter(Boolean).join('/');
-  return hasHost ? url : `/${url}`;
+	const options = Object.assign({
+		host: CONFIG.host,
+		namespace: CONFIG.namespace
+	}, urlOptions);
+	((test) => {
+		if (!test) throw new Error(`buildBaseURL: You must pass \`op\` as part of options`);
+	})(hasResourcePath(options) || typeof options.op === "string" && options.op.length > 0);
+	((test) => {
+		if (!test) throw new Error(`buildBaseURL: You must pass \`identifier\` as part of options`);
+	})(hasResourcePath(options) || options.op === "findMany" || options.identifier && typeof options.identifier === "object");
+	((test) => {
+		if (!test) throw new Error(`buildBaseURL: You must pass \`identifiers\` as part of options`);
+	})(hasResourcePath(options) || options.op !== "findMany" || options.identifiers && Array.isArray(options.identifiers) && options.identifiers.length > 0 && options.identifiers.every((i) => i && typeof i === "object"));
+	((test) => {
+		if (!test) throw new Error(`buildBaseURL: You must pass valid \`identifier\` as part of options, expected 'id'`);
+	})(hasResourcePath(options) || !isOperationWithPrimaryRecord(options) || typeof options.identifier.id === "string" && options.identifier.id.length > 0);
+	((test) => {
+		if (!test) throw new Error(`buildBaseURL: You must pass \`identifiers\` as part of options`);
+	})(hasResourcePath(options) || options.op !== "findMany" || options.identifiers.every((i) => typeof i.id === "string" && i.id.length > 0));
+	((test) => {
+		if (!test) throw new Error(`buildBaseURL: You must pass valid \`identifier\` as part of options, expected 'type'`);
+	})(hasResourcePath(options) || options.op === "findMany" || typeof options.identifier.type === "string" && options.identifier.type.length > 0);
+	((test) => {
+		if (!test) throw new Error(`buildBaseURL: You must pass valid \`identifiers\` as part of options, expected 'type'`);
+	})(hasResourcePath(options) || options.op !== "findMany" || typeof options.identifiers[0].type === "string" && options.identifiers[0].type.length > 0);
+	const idPath = isOperationWithPrimaryRecord(options) ? encodeURIComponent(options.identifier.id) : "";
+	const resourcePath = options.resourcePath || resourcePathForType(options);
+	const { host, namespace } = options;
+	const fieldPath = "fieldPath" in options ? options.fieldPath : "";
+	((test) => {
+		if (!test) throw new Error(`buildBaseURL: You tried to build a url for a ${String("op" in options ? options.op + " " : "")}request to ${resourcePath} but resourcePath must be set or op must be one of "${[
+			"findRecord",
+			"findRelatedRecord",
+			"findRelatedCollection",
+			"updateRecord",
+			"deleteRecord",
+			"createRecord",
+			"query",
+			"findMany"
+		].join("\",\"")}".`);
+	})(hasResourcePath(options) || [
+		"findRecord",
+		"query",
+		"findMany",
+		"findRelatedCollection",
+		"findRelatedRecord",
+		"createRecord",
+		"updateRecord",
+		"deleteRecord"
+	].includes(options.op));
+	((test) => {
+		if (!test) throw new Error(`buildBaseURL: host must NOT end with '/', received '${host}'`);
+	})(host === "/" || !host.endsWith("/"));
+	((test) => {
+		if (!test) throw new Error(`buildBaseURL: namespace must NOT start with '/', received '${namespace}'`);
+	})(!namespace.startsWith("/"));
+	((test) => {
+		if (!test) throw new Error(`buildBaseURL: namespace must NOT end with '/', received '${namespace}'`);
+	})(!namespace.endsWith("/"));
+	((test) => {
+		if (!test) throw new Error(`buildBaseURL: resourcePath must NOT start with '/', received '${resourcePath}'`);
+	})(!resourcePath.startsWith("/"));
+	((test) => {
+		if (!test) throw new Error(`buildBaseURL: resourcePath must NOT end with '/', received '${resourcePath}'`);
+	})(!resourcePath.endsWith("/"));
+	((test) => {
+		if (!test) throw new Error(`buildBaseURL: fieldPath must NOT start with '/', received '${fieldPath}'`);
+	})(!fieldPath.startsWith("/"));
+	((test) => {
+		if (!test) throw new Error(`buildBaseURL: fieldPath must NOT end with '/', received '${fieldPath}'`);
+	})(!fieldPath.endsWith("/"));
+	((test) => {
+		if (!test) throw new Error(`buildBaseURL: idPath must NOT start with '/', received '${idPath}'`);
+	})(!idPath.startsWith("/"));
+	((test) => {
+		if (!test) throw new Error(`buildBaseURL: idPath must NOT end with '/', received '${idPath}'`);
+	})(!idPath.endsWith("/"));
+	const hasHost = host !== "" && host !== "/";
+	const url = [
+		hasHost ? host : "",
+		namespace,
+		resourcePath,
+		idPath,
+		fieldPath
+	].filter(Boolean).join("/");
+	return hasHost ? url : `/${url}`;
 }
-const DEFAULT_QUERY_PARAMS_SERIALIZATION_OPTIONS = {
-  arrayFormat: 'comma'
-};
+const DEFAULT_QUERY_PARAMS_SERIALIZATION_OPTIONS = { arrayFormat: "comma" };
 function handleInclude(include) {
-  (test => {
-    if (!test) {
-      throw new Error(`Expected include to be a string or array, got ${typeof include}`);
-    }
-  })(typeof include === 'string' || Array.isArray(include));
-  return typeof include === 'string' ? include.split(',') : include;
+	((test) => {
+		if (!test) throw new Error(`Expected include to be a string or array, got ${typeof include}`);
+	})(typeof include === "string" || Array.isArray(include));
+	return typeof include === "string" ? include.split(",") : include;
 }
-
 /**
- * filter out keys of an object that have falsy values or point to empty arrays
- * returning a new object with only those keys that have truthy values / non-empty arrays
- *
- * @public
- * @param source object to filter keys with empty values from
- * @return A new object with the keys that contained empty values removed
- */
+* filter out keys of an object that have falsy values or point to empty arrays
+* returning a new object with only those keys that have truthy values / non-empty arrays
+*
+* @public
+* @param source object to filter keys with empty values from
+* @return A new object with the keys that contained empty values removed
+*/
 function filterEmpty(source) {
-  const result = {};
-  for (const key in source) {
-    const value = source[key];
-    // Allow `0` and `false` but filter falsy values that indicate "empty"
-    if (value !== undefined && value !== null && value !== '') {
-      if (!Array.isArray(value) || value.length > 0) {
-        result[key] = source[key];
-      }
-    }
-  }
-  return result;
+	const result = {};
+	for (const key in source) {
+		const value = source[key];
+		if (value !== void 0 && value !== null && value !== "") {
+			if (!Array.isArray(value) || value.length > 0) result[key] = source[key];
+		}
+	}
+	return result;
 }
-
 /**
- * Sorts query params by both key and value returning a new URLSearchParams
- * object with the keys inserted in sorted order.
- *
- * Treats `included` specially, splicing it into an array if it is a string and sorting the array.
- *
- * Options:
- * - arrayFormat: 'bracket' | 'indices' | 'repeat' | 'comma'
- *
- * 'bracket': appends [] to the key for every value e.g. `&ids[]=1&ids[]=2`
- * 'indices': appends [i] to the key for every value e.g. `&ids[0]=1&ids[1]=2`
- * 'repeat': appends the key for every value e.g. `&ids=1&ids=2`
- * 'comma' (default): appends the key once with a comma separated list of values e.g. `&ids=1,2`
- *
- * @public
- * @return A {@link URLSearchParams} with keys inserted in sorted order
- */
+* Sorts query params by both key and value returning a new URLSearchParams
+* object with the keys inserted in sorted order.
+*
+* Treats `included` specially, splicing it into an array if it is a string and sorting the array.
+*
+* Options:
+* - arrayFormat: 'bracket' | 'indices' | 'repeat' | 'comma'
+*
+* 'bracket': appends [] to the key for every value e.g. `&ids[]=1&ids[]=2`
+* 'indices': appends [i] to the key for every value e.g. `&ids[0]=1&ids[1]=2`
+* 'repeat': appends the key for every value e.g. `&ids=1&ids=2`
+* 'comma' (default): appends the key once with a comma separated list of values e.g. `&ids=1,2`
+*
+* @public
+* @return A {@link URLSearchParams} with keys inserted in sorted order
+*/
 function sortQueryParams(params, options) {
-  const opts = Object.assign({}, DEFAULT_QUERY_PARAMS_SERIALIZATION_OPTIONS, options);
-  const paramsIsObject = !(params instanceof URLSearchParams);
-  const urlParams = new URLSearchParams();
-  const dictionaryParams = paramsIsObject ? params : {};
-  if (!paramsIsObject) {
-    params.forEach((value, key) => {
-      const hasExisting = key in dictionaryParams;
-      if (!hasExisting) {
-        dictionaryParams[key] = value;
-      } else {
-        const existingValue = dictionaryParams[key];
-        if (Array.isArray(existingValue)) {
-          existingValue.push(value);
-        } else {
-          dictionaryParams[key] = [existingValue, value];
-        }
-      }
-    });
-  }
-  if ('include' in dictionaryParams) {
-    dictionaryParams.include = handleInclude(dictionaryParams.include);
-  }
-  const sortedKeys = Object.keys(dictionaryParams).sort();
-  sortedKeys.forEach(key => {
-    const value = dictionaryParams[key];
-    if (Array.isArray(value)) {
-      value.sort();
-      switch (opts.arrayFormat) {
-        case 'indices':
-          value.forEach((v, i) => {
-            urlParams.append(`${key}[${i}]`, String(v));
-          });
-          return;
-        case 'bracket':
-          value.forEach(v => {
-            urlParams.append(`${key}[]`, String(v));
-          });
-          return;
-        case 'repeat':
-          value.forEach(v => {
-            urlParams.append(key, String(v));
-          });
-          return;
-        case 'comma':
-        default:
-          urlParams.append(key, value.join(','));
-          return;
-      }
-    } else {
-      urlParams.append(key, String(value));
-    }
-  });
-  return urlParams;
+	const opts = Object.assign({}, DEFAULT_QUERY_PARAMS_SERIALIZATION_OPTIONS, options);
+	const paramsIsObject = !(params instanceof URLSearchParams);
+	const urlParams = new URLSearchParams();
+	const dictionaryParams = paramsIsObject ? params : {};
+	if (!paramsIsObject) params.forEach((value, key) => {
+		if (!(key in dictionaryParams)) dictionaryParams[key] = value;
+		else {
+			const existingValue = dictionaryParams[key];
+			if (Array.isArray(existingValue)) existingValue.push(value);
+			else dictionaryParams[key] = [existingValue, value];
+		}
+	});
+	if ("include" in dictionaryParams) dictionaryParams.include = handleInclude(dictionaryParams.include);
+	Object.keys(dictionaryParams).sort().forEach((key) => {
+		const value = dictionaryParams[key];
+		if (Array.isArray(value)) {
+			value.sort();
+			switch (opts.arrayFormat) {
+				case "indices":
+					value.forEach((v, i) => {
+						urlParams.append(`${key}[${i}]`, String(v));
+					});
+					return;
+				case "bracket":
+					value.forEach((v) => {
+						urlParams.append(`${key}[]`, String(v));
+					});
+					return;
+				case "repeat":
+					value.forEach((v) => {
+						urlParams.append(key, String(v));
+					});
+					return;
+				default:
+					urlParams.append(key, value.join(","));
+					return;
+			}
+		} else urlParams.append(key, String(value));
+	});
+	return urlParams;
 }
-
 /**
- * Sorts query params by both key and value, returning a query params string
- *
- * Treats `included` specially, splicing it into an array if it is a string and sorting the array.
- *
- * Options:
- * - arrayFormat: 'bracket' | 'indices' | 'repeat' | 'comma'
- *
- * 'bracket': appends [] to the key for every value e.g. `ids[]=1&ids[]=2`
- * 'indices': appends [i] to the key for every value e.g. `ids[0]=1&ids[1]=2`
- * 'repeat': appends the key for every value e.g. `ids=1&ids=2`
- * 'comma' (default): appends the key once with a comma separated list of values e.g. `ids=1,2`
- *
- * @public
- * @return A sorted query params string without the leading `?`
- */
+* Sorts query params by both key and value, returning a query params string
+*
+* Treats `included` specially, splicing it into an array if it is a string and sorting the array.
+*
+* Options:
+* - arrayFormat: 'bracket' | 'indices' | 'repeat' | 'comma'
+*
+* 'bracket': appends [] to the key for every value e.g. `ids[]=1&ids[]=2`
+* 'indices': appends [i] to the key for every value e.g. `ids[0]=1&ids[1]=2`
+* 'repeat': appends the key for every value e.g. `ids=1&ids=2`
+* 'comma' (default): appends the key once with a comma separated list of values e.g. `ids=1,2`
+*
+* @public
+* @return A sorted query params string without the leading `?`
+*/
 function buildQueryParams(params, options) {
-  return sortQueryParams(params, options).toString();
+	return sortQueryParams(params, options).toString();
 }
-export { buildBaseURL, buildQueryParams, filterEmpty, setBuildURLConfig, sortQueryParams };
+
+//#endregion
+export { buildBaseURL, buildQueryParams, filterEmpty, setBuildURLConfig, sortQueryParams };
+//# sourceMappingURL=index.js.map