@chriscdn/build-url 1.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2023 Christopher Meyer
+Copyright (c) googlicius
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,97 @@
+# chriscdn/build-url
+
+## Motivation
+
+A small utility for generating URLs.
+
+This package is a fork of [@googlicius/build-url](https://github.com/googlicius/build-url). Full credit to googlicius for the concept, source code, and documentation. 👍
+
+I forked this package for two reasons:
+
+- to provide an ES6 build, and
+- to fix [this issue](https://github.com/googlicius/build-url/issues/3).
+
+## Installation
+
+Using npm:
+
+```bash
+npm install https://github.com/chriscdn/build-url
+```
+
+Using yarn:
+
+```bash
+yarn add https://github.com/chriscdn/build-url
+```
+
+## Usage
+
+Create a url:
+
+```js
+import buildUrl from "@googlicius/build-url";
+
+buildUrl("http://my-website.com/post", {
+  queryParams: {
+    page: 2,
+  },
+});
+
+// Output: http://my-website.com/post?page=2
+```
+
+Add another query parameter:
+
+```js
+buildUrl("http://my-website.com/post?page=2", {
+  queryParams: {
+    sort: "title:asc",
+  },
+});
+
+// Output: http://my-website.com/post?page=2&sort=title%3Aasc
+```
+
+Input url/path is omitted:
+
+```js
+buildUrl({
+  queryParams: {
+    sort: "title:asc",
+  },
+});
+
+// Output: /?sort=title%3Aasc
+```
+
+Remove a query parameter:
+
+```js
+buildUrl("images?page=2&sort=title:asc", {
+  queryParams: {
+    page: null,
+  },
+});
+
+// Output: /images?sort=title%3Aasc
+```
+
+Return an absolute url:
+
+```js
+// Assume that current url is: http://awesome-website.com
+
+buildUrl("/posts", {
+  returnAbsoluteUrl: true,
+  queryParams: {
+    page: 2,
+  },
+});
+
+// Output: http://awesome-website.com/posts?page=2
+```
+
+## License
+
+MIT

package/__tests__/build-url.test.ts

@@ -0,0 +1,128 @@
+import buildUrl from "../src/index";
+
+describe("Build Url test", () => {
+  test("Add a query param", () => {
+    const url = buildUrl("http://my-website.com/post", {
+      queryParams: {
+        page: 2,
+      },
+    });
+
+    expect(url).toEqual("http://my-website.com/post?page=2");
+  });
+
+  test("Add a zero query param", () => {
+    const url = buildUrl("http://my-website.com/post", {
+      queryParams: {
+        page: 0,
+      },
+    });
+
+    expect(url).toEqual("http://my-website.com/post?page=0");
+  });
+
+  test("Add another query param", () => {
+    const url = buildUrl("http://my-website.com/post?page=2", {
+      queryParams: {
+        sort: "title:asc",
+      },
+    });
+
+    expect(url).toEqual("http://my-website.com/post?page=2&sort=title%3Aasc");
+  });
+
+  test("Url is omitted", () => {
+    const url = buildUrl({
+      queryParams: {
+        page: 2,
+        sort: "title:desc",
+      },
+    });
+
+    expect(url).toEqual("/?page=2&sort=title%3Adesc");
+  });
+
+  test("Url is relative path", () => {
+    const url = buildUrl("images", {
+      queryParams: {
+        page: 3,
+        sort: "title:desc",
+      },
+    });
+
+    expect(url).toEqual("/images?page=3&sort=title%3Adesc");
+  });
+
+  test("Changes value of an existing query param", () => {
+    const url = buildUrl("images?page=2", {
+      queryParams: {
+        page: 3,
+        sort: "title:desc",
+      },
+    });
+
+    expect(url).toEqual("/images?page=3&sort=title%3Adesc");
+  });
+
+  test("Delete existing query param", () => {
+    const url = buildUrl("images?page=2&sort=title:asc", {
+      queryParams: {
+        page: null,
+      },
+    });
+
+    expect(url).toEqual("/images?sort=title%3Aasc");
+  });
+
+  test("Add hash", () => {
+    const url = buildUrl("/posts", {
+      hash: "my-hash",
+    });
+
+    expect(url).toEqual("/posts#my-hash");
+  });
+
+  test("Replace hash", () => {
+    const url = buildUrl("/posts?page=2#first-hash", {
+      hash: "#second-hash",
+    });
+
+    expect(url).toEqual("/posts?page=2#second-hash");
+  });
+
+  test("Add path", () => {
+    const url = buildUrl({ path: "posts" });
+    const url2 = buildUrl({ path: "/posts" });
+    const url3 = buildUrl("http://my-website.com", {
+      path: "posts",
+    });
+
+    expect(url).toEqual("/posts");
+    expect(url2).toEqual("/posts");
+    expect(url3).toEqual("http://my-website.com/posts");
+  });
+
+  test("Replace path", () => {
+    const url = buildUrl("posts?page=2", {
+      path: "stories",
+    });
+    const url2 = buildUrl("http://my-website.com/posts?page=2", {
+      path: "stories",
+    });
+
+    expect(url).toEqual("/stories?page=2");
+    expect(url2).toEqual("http://my-website.com/stories?page=2");
+  });
+
+  test("Delete path", () => {
+    const url = buildUrl("posts?page=2", {
+      path: null,
+    });
+    const url2 = buildUrl("http://my-website.com/posts?page=2", {
+      path: null,
+    });
+
+    expect(url).toEqual("/?page=2");
+    expect(url2).toEqual("http://my-website.com/?page=2");
+  });
+});

package/jest.config.js

@@ -0,0 +1,5 @@
+/** @type {import('ts-jest').JestConfigWithTsJest} */
+export default {
+  preset: "ts-jest",
+  testEnvironment: "node",
+};

package/lib/index.cjs

@@ -0,0 +1,2 @@
+module.exports=function(e,a){var r,n=!1;try{r=new URL(e)}catch(a){if(n=!0,"string"==typeof e){var t="undefined"==typeof window?"http://example.com":window.location.origin;r=new URL(t+"/"+e.replace(/^\/|\/$/g,""))}else r="undefined"==typeof window?new URL("http://example.com"):new URL(window.location.href)}var l="string"==typeof e?a:e;if(null!=l&&l.queryParams)for(var o in l.queryParams)if(Object.prototype.hasOwnProperty.call(l.queryParams,o)){var h=l.queryParams[o];null==h?r.searchParams.delete(o):r.searchParams.set(o,h)}return null!=l&&l.path&&(r.pathname=l.path),null===(null==l?void 0:l.path)&&(r.pathname=""),null!=l&&l.hash&&(r.hash=l.hash),!n||null!=l&&l.returnAbsoluteUrl?r.toString():r.pathname+r.search+r.hash};
+//# sourceMappingURL=index.cjs.map

package/lib/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../src/index.ts"],"sourcesContent":["export interface UrlOptions {\n  queryParams?: {\n    [x: string]: any;\n  };\n  hash?: string;\n  path?: string | null;\n  returnAbsoluteUrl?: boolean;\n}\n\nconst isEmpty = (value: any) => value === null || value === undefined;\n// ||(typeof value === \"string\" && value.trim().length === 0);\n\nexport default function buildUrl(\n  inputUrl?: string | UrlOptions,\n  options?: UrlOptions\n) {\n  let url: URL;\n  let isValidInputUrl = false;\n\n  try {\n    url = new URL(inputUrl as string);\n  } catch (error) {\n    isValidInputUrl = true;\n\n    if (typeof inputUrl === \"string\") {\n      const host =\n        typeof window === \"undefined\"\n          ? \"http://example.com\"\n          : window.location.origin;\n\n      url = new URL(`${host}/${inputUrl.replace(/^\\/|\\/$/g, \"\")}`);\n    } else {\n      url =\n        typeof window === \"undefined\"\n          ? new URL(\"http://example.com\")\n          : new URL(window.location.href);\n    }\n  }\n\n  const _options = typeof inputUrl === \"string\" ? options : inputUrl;\n\n  if (_options?.queryParams) {\n    for (const key in _options.queryParams) {\n      if (Object.prototype.hasOwnProperty.call(_options.queryParams, key)) {\n        const element = _options.queryParams[key];\n\n        if (isEmpty(element)) {\n          url.searchParams.delete(key);\n        } else {\n          url.searchParams.set(key, element);\n        }\n      }\n    }\n  }\n\n  if (_options?.path) {\n    url.pathname = _options.path;\n  }\n\n  if (_options?.path === null) {\n    url.pathname = \"\";\n  }\n\n  if (_options?.hash) {\n    url.hash = _options.hash;\n  }\n\n  if (isValidInputUrl && !_options?.returnAbsoluteUrl) {\n    return url.pathname + url.search + url.hash;\n  }\n\n  return url.toString();\n}\n"],"names":["inputUrl","options","url","isValidInputUrl","URL","error","host","window","location","origin","replace","href","_options","queryParams","key","Object","prototype","hasOwnProperty","call","element","value","searchParams","set","path","pathname","hash","returnAbsoluteUrl","toString","search"],"mappings":"eAYwB,SACtBA,EACAC,GAEA,IAAIC,EACAC,GAAkB,EAEtB,IACED,EAAM,IAAIE,IAAIJ,EACf,CAAC,MAAOK,GAGP,GAFAF,GAAkB,EAEM,iBAAbH,EAAuB,CAChC,IAAMM,EACc,oBAAXC,OACH,qBACAA,OAAOC,SAASC,OAEtBP,EAAM,IAAIE,IAAOE,MAAQN,EAASU,QAAQ,WAAY,IACvD,MACCR,EACoB,oBAAXK,OACH,IAAIH,IAAI,sBACR,IAAIA,IAAIG,OAAOC,SAASG,KAEjC,CAED,IAAMC,EAA+B,iBAAbZ,EAAwBC,EAAUD,EAE1D,GAAIY,MAAAA,GAAAA,EAAUC,YACZ,IAAK,IAAMC,KAAOF,EAASC,YACzB,GAAIE,OAAOC,UAAUC,eAAeC,KAAKN,EAASC,YAAaC,GAAM,CACnE,IAAMK,EAAUP,EAASC,YAAYC,GAnCbM,MAqCZD,EACVjB,EAAImB,aAAmB,OAACP,GAExBZ,EAAImB,aAAaC,IAAIR,EAAKK,EAE7B,CAgBL,aAZIP,GAAAA,EAAUW,OACZrB,EAAIsB,SAAWZ,EAASW,MAGH,QAAnBX,MAAAA,OAAAA,EAAAA,EAAUW,QACZrB,EAAIsB,SAAW,UAGbZ,GAAAA,EAAUa,OACZvB,EAAIuB,KAAOb,EAASa,OAGlBtB,SAAoBS,GAAAA,EAAUc,kBAI3BxB,EAAIyB,WAHFzB,EAAIsB,SAAWtB,EAAI0B,OAAS1B,EAAIuB,IAI3C"}

package/lib/index.d.ts

@@ -0,0 +1,9 @@
+export interface UrlOptions {
+    queryParams?: {
+        [x: string]: any;
+    };
+    hash?: string;
+    path?: string | null;
+    returnAbsoluteUrl?: boolean;
+}
+export default function buildUrl(inputUrl?: string | UrlOptions, options?: UrlOptions): string;

package/lib/index.modern.js

@@ -0,0 +1,2 @@
+function e(e,t){let a,n=!1;try{a=new URL(e)}catch(t){if(n=!0,"string"==typeof e){const t="undefined"==typeof window?"http://example.com":window.location.origin;a=new URL(`${t}/${e.replace(/^\/|\/$/g,"")}`)}else a="undefined"==typeof window?new URL("http://example.com"):new URL(window.location.href)}const r="string"==typeof e?t:e;if(null!=r&&r.queryParams)for(const e in r.queryParams)if(Object.prototype.hasOwnProperty.call(r.queryParams,e)){const t=r.queryParams[e];null==t?a.searchParams.delete(e):a.searchParams.set(e,t)}return null!=r&&r.path&&(a.pathname=r.path),null===(null==r?void 0:r.path)&&(a.pathname=""),null!=r&&r.hash&&(a.hash=r.hash),!n||null!=r&&r.returnAbsoluteUrl?a.toString():a.pathname+a.search+a.hash}export{e as default};
+//# sourceMappingURL=index.modern.js.map

package/lib/index.modern.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.modern.js","sources":["../src/index.ts"],"sourcesContent":["export interface UrlOptions {\n  queryParams?: {\n    [x: string]: any;\n  };\n  hash?: string;\n  path?: string | null;\n  returnAbsoluteUrl?: boolean;\n}\n\nconst isEmpty = (value: any) => value === null || value === undefined;\n// ||(typeof value === \"string\" && value.trim().length === 0);\n\nexport default function buildUrl(\n  inputUrl?: string | UrlOptions,\n  options?: UrlOptions\n) {\n  let url: URL;\n  let isValidInputUrl = false;\n\n  try {\n    url = new URL(inputUrl as string);\n  } catch (error) {\n    isValidInputUrl = true;\n\n    if (typeof inputUrl === \"string\") {\n      const host =\n        typeof window === \"undefined\"\n          ? \"http://example.com\"\n          : window.location.origin;\n\n      url = new URL(`${host}/${inputUrl.replace(/^\\/|\\/$/g, \"\")}`);\n    } else {\n      url =\n        typeof window === \"undefined\"\n          ? new URL(\"http://example.com\")\n          : new URL(window.location.href);\n    }\n  }\n\n  const _options = typeof inputUrl === \"string\" ? options : inputUrl;\n\n  if (_options?.queryParams) {\n    for (const key in _options.queryParams) {\n      if (Object.prototype.hasOwnProperty.call(_options.queryParams, key)) {\n        const element = _options.queryParams[key];\n\n        if (isEmpty(element)) {\n          url.searchParams.delete(key);\n        } else {\n          url.searchParams.set(key, element);\n        }\n      }\n    }\n  }\n\n  if (_options?.path) {\n    url.pathname = _options.path;\n  }\n\n  if (_options?.path === null) {\n    url.pathname = \"\";\n  }\n\n  if (_options?.hash) {\n    url.hash = _options.hash;\n  }\n\n  if (isValidInputUrl && !_options?.returnAbsoluteUrl) {\n    return url.pathname + url.search + url.hash;\n  }\n\n  return url.toString();\n}\n"],"names":["buildUrl","inputUrl","options","url","isValidInputUrl","URL","error","host","window","location","origin","replace","href","_options","queryParams","key","Object","prototype","hasOwnProperty","call","element","value","searchParams","delete","set","path","pathname","hash","returnAbsoluteUrl","toString","search"],"mappings":"SAYwBA,EACtBC,EACAC,GAEA,IAAIC,EACAC,GAAkB,EAEtB,IACED,EAAM,IAAIE,IAAIJ,EACf,CAAC,MAAOK,GAGP,GAFAF,GAAkB,EAEM,iBAAbH,EAAuB,CAChC,MAAMM,EACc,oBAAXC,OACH,qBACAA,OAAOC,SAASC,OAEtBP,EAAM,IAAIE,IAAI,GAAGE,KAAQN,EAASU,QAAQ,WAAY,MACvD,MACCR,EACoB,oBAAXK,OACH,IAAIH,IAAI,sBACR,IAAIA,IAAIG,OAAOC,SAASG,KAEjC,CAED,MAAMC,EAA+B,iBAAbZ,EAAwBC,EAAUD,EAE1D,GAAIY,MAAAA,GAAAA,EAAUC,YACZ,IAAK,MAAMC,KAAOF,EAASC,YACzB,GAAIE,OAAOC,UAAUC,eAAeC,KAAKN,EAASC,YAAaC,GAAM,CACnE,MAAMK,EAAUP,EAASC,YAAYC,GAnCbM,MAqCZD,EACVjB,EAAImB,aAAaC,OAAOR,GAExBZ,EAAImB,aAAaE,IAAIT,EAAKK,EAE7B,CAgBL,OAZY,MAARP,GAAAA,EAAUY,OACZtB,EAAIuB,SAAWb,EAASY,MAGH,QAAX,MAARZ,OAAQ,EAARA,EAAUY,QACZtB,EAAIuB,SAAW,IAGL,MAARb,GAAAA,EAAUc,OACZxB,EAAIwB,KAAOd,EAASc,OAGlBvB,GAA4B,MAARS,GAAAA,EAAUe,kBAI3BzB,EAAI0B,WAHF1B,EAAIuB,SAAWvB,EAAI2B,OAAS3B,EAAIwB,IAI3C"}

package/lib/index.module.js

@@ -0,0 +1,2 @@
+function a(a,e){var r,n=!1;try{r=new URL(a)}catch(e){if(n=!0,"string"==typeof a){var t="undefined"==typeof window?"http://example.com":window.location.origin;r=new URL(t+"/"+a.replace(/^\/|\/$/g,""))}else r="undefined"==typeof window?new URL("http://example.com"):new URL(window.location.href)}var l="string"==typeof a?e:a;if(null!=l&&l.queryParams)for(var o in l.queryParams)if(Object.prototype.hasOwnProperty.call(l.queryParams,o)){var h=l.queryParams[o];null==h?r.searchParams.delete(o):r.searchParams.set(o,h)}return null!=l&&l.path&&(r.pathname=l.path),null===(null==l?void 0:l.path)&&(r.pathname=""),null!=l&&l.hash&&(r.hash=l.hash),!n||null!=l&&l.returnAbsoluteUrl?r.toString():r.pathname+r.search+r.hash}export{a as default};
+//# sourceMappingURL=index.module.js.map

package/lib/index.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.module.js","sources":["../src/index.ts"],"sourcesContent":["export interface UrlOptions {\n  queryParams?: {\n    [x: string]: any;\n  };\n  hash?: string;\n  path?: string | null;\n  returnAbsoluteUrl?: boolean;\n}\n\nconst isEmpty = (value: any) => value === null || value === undefined;\n// ||(typeof value === \"string\" && value.trim().length === 0);\n\nexport default function buildUrl(\n  inputUrl?: string | UrlOptions,\n  options?: UrlOptions\n) {\n  let url: URL;\n  let isValidInputUrl = false;\n\n  try {\n    url = new URL(inputUrl as string);\n  } catch (error) {\n    isValidInputUrl = true;\n\n    if (typeof inputUrl === \"string\") {\n      const host =\n        typeof window === \"undefined\"\n          ? \"http://example.com\"\n          : window.location.origin;\n\n      url = new URL(`${host}/${inputUrl.replace(/^\\/|\\/$/g, \"\")}`);\n    } else {\n      url =\n        typeof window === \"undefined\"\n          ? new URL(\"http://example.com\")\n          : new URL(window.location.href);\n    }\n  }\n\n  const _options = typeof inputUrl === \"string\" ? options : inputUrl;\n\n  if (_options?.queryParams) {\n    for (const key in _options.queryParams) {\n      if (Object.prototype.hasOwnProperty.call(_options.queryParams, key)) {\n        const element = _options.queryParams[key];\n\n        if (isEmpty(element)) {\n          url.searchParams.delete(key);\n        } else {\n          url.searchParams.set(key, element);\n        }\n      }\n    }\n  }\n\n  if (_options?.path) {\n    url.pathname = _options.path;\n  }\n\n  if (_options?.path === null) {\n    url.pathname = \"\";\n  }\n\n  if (_options?.hash) {\n    url.hash = _options.hash;\n  }\n\n  if (isValidInputUrl && !_options?.returnAbsoluteUrl) {\n    return url.pathname + url.search + url.hash;\n  }\n\n  return url.toString();\n}\n"],"names":["buildUrl","inputUrl","options","url","isValidInputUrl","URL","error","host","window","location","origin","replace","href","_options","queryParams","key","Object","prototype","hasOwnProperty","call","element","value","searchParams","set","path","pathname","hash","returnAbsoluteUrl","toString","search"],"mappings":"AAYwB,SAAAA,EACtBC,EACAC,GAEA,IAAIC,EACAC,GAAkB,EAEtB,IACED,EAAM,IAAIE,IAAIJ,EACf,CAAC,MAAOK,GAGP,GAFAF,GAAkB,EAEM,iBAAbH,EAAuB,CAChC,IAAMM,EACc,oBAAXC,OACH,qBACAA,OAAOC,SAASC,OAEtBP,EAAM,IAAIE,IAAOE,MAAQN,EAASU,QAAQ,WAAY,IACvD,MACCR,EACoB,oBAAXK,OACH,IAAIH,IAAI,sBACR,IAAIA,IAAIG,OAAOC,SAASG,KAEjC,CAED,IAAMC,EAA+B,iBAAbZ,EAAwBC,EAAUD,EAE1D,GAAIY,MAAAA,GAAAA,EAAUC,YACZ,IAAK,IAAMC,KAAOF,EAASC,YACzB,GAAIE,OAAOC,UAAUC,eAAeC,KAAKN,EAASC,YAAaC,GAAM,CACnE,IAAMK,EAAUP,EAASC,YAAYC,GAnCbM,MAqCZD,EACVjB,EAAImB,aAAmB,OAACP,GAExBZ,EAAImB,aAAaC,IAAIR,EAAKK,EAE7B,CAgBL,aAZIP,GAAAA,EAAUW,OACZrB,EAAIsB,SAAWZ,EAASW,MAGH,QAAnBX,MAAAA,OAAAA,EAAAA,EAAUW,QACZrB,EAAIsB,SAAW,UAGbZ,GAAAA,EAAUa,OACZvB,EAAIuB,KAAOb,EAASa,OAGlBtB,SAAoBS,GAAAA,EAAUc,kBAI3BxB,EAAIyB,WAHFzB,EAAIsB,SAAWtB,EAAI0B,OAAS1B,EAAIuB,IAI3C"}

package/lib/index.umd.js

@@ -0,0 +1,2 @@
+!function(e,n){"object"==typeof exports&&"undefined"!=typeof module?module.exports=n():"function"==typeof define&&define.amd?define(n):(e||self).buildUrl=n()}(this,function(){return function(e,n){var a,t=!1;try{a=new URL(e)}catch(n){if(t=!0,"string"==typeof e){var r="undefined"==typeof window?"http://example.com":window.location.origin;a=new URL(r+"/"+e.replace(/^\/|\/$/g,""))}else a="undefined"==typeof window?new URL("http://example.com"):new URL(window.location.href)}var o="string"==typeof e?n:e;if(null!=o&&o.queryParams)for(var l in o.queryParams)if(Object.prototype.hasOwnProperty.call(o.queryParams,l)){var i=o.queryParams[l];null==i?a.searchParams.delete(l):a.searchParams.set(l,i)}return null!=o&&o.path&&(a.pathname=o.path),null===(null==o?void 0:o.path)&&(a.pathname=""),null!=o&&o.hash&&(a.hash=o.hash),!t||null!=o&&o.returnAbsoluteUrl?a.toString():a.pathname+a.search+a.hash}});
+//# sourceMappingURL=index.umd.js.map

package/lib/index.umd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.umd.js","sources":["../src/index.ts"],"sourcesContent":["export interface UrlOptions {\n  queryParams?: {\n    [x: string]: any;\n  };\n  hash?: string;\n  path?: string | null;\n  returnAbsoluteUrl?: boolean;\n}\n\nconst isEmpty = (value: any) => value === null || value === undefined;\n// ||(typeof value === \"string\" && value.trim().length === 0);\n\nexport default function buildUrl(\n  inputUrl?: string | UrlOptions,\n  options?: UrlOptions\n) {\n  let url: URL;\n  let isValidInputUrl = false;\n\n  try {\n    url = new URL(inputUrl as string);\n  } catch (error) {\n    isValidInputUrl = true;\n\n    if (typeof inputUrl === \"string\") {\n      const host =\n        typeof window === \"undefined\"\n          ? \"http://example.com\"\n          : window.location.origin;\n\n      url = new URL(`${host}/${inputUrl.replace(/^\\/|\\/$/g, \"\")}`);\n    } else {\n      url =\n        typeof window === \"undefined\"\n          ? new URL(\"http://example.com\")\n          : new URL(window.location.href);\n    }\n  }\n\n  const _options = typeof inputUrl === \"string\" ? options : inputUrl;\n\n  if (_options?.queryParams) {\n    for (const key in _options.queryParams) {\n      if (Object.prototype.hasOwnProperty.call(_options.queryParams, key)) {\n        const element = _options.queryParams[key];\n\n        if (isEmpty(element)) {\n          url.searchParams.delete(key);\n        } else {\n          url.searchParams.set(key, element);\n        }\n      }\n    }\n  }\n\n  if (_options?.path) {\n    url.pathname = _options.path;\n  }\n\n  if (_options?.path === null) {\n    url.pathname = \"\";\n  }\n\n  if (_options?.hash) {\n    url.hash = _options.hash;\n  }\n\n  if (isValidInputUrl && !_options?.returnAbsoluteUrl) {\n    return url.pathname + url.search + url.hash;\n  }\n\n  return url.toString();\n}\n"],"names":["inputUrl","options","url","isValidInputUrl","URL","error","host","window","location","origin","replace","href","_options","queryParams","key","Object","prototype","hasOwnProperty","call","element","value","searchParams","set","path","pathname","hash","returnAbsoluteUrl","toString","search"],"mappings":"kOAYwB,SACtBA,EACAC,GAEA,IAAIC,EACAC,GAAkB,EAEtB,IACED,EAAM,IAAIE,IAAIJ,EACf,CAAC,MAAOK,GAGP,GAFAF,GAAkB,EAEM,iBAAbH,EAAuB,CAChC,IAAMM,EACc,oBAAXC,OACH,qBACAA,OAAOC,SAASC,OAEtBP,EAAM,IAAIE,IAAOE,MAAQN,EAASU,QAAQ,WAAY,IACvD,MACCR,EACoB,oBAAXK,OACH,IAAIH,IAAI,sBACR,IAAIA,IAAIG,OAAOC,SAASG,KAEjC,CAED,IAAMC,EAA+B,iBAAbZ,EAAwBC,EAAUD,EAE1D,GAAIY,MAAAA,GAAAA,EAAUC,YACZ,IAAK,IAAMC,KAAOF,EAASC,YACzB,GAAIE,OAAOC,UAAUC,eAAeC,KAAKN,EAASC,YAAaC,GAAM,CACnE,IAAMK,EAAUP,EAASC,YAAYC,GAnCbM,MAqCZD,EACVjB,EAAImB,aAAmB,OAACP,GAExBZ,EAAImB,aAAaC,IAAIR,EAAKK,EAE7B,CAgBL,aAZIP,GAAAA,EAAUW,OACZrB,EAAIsB,SAAWZ,EAASW,MAGH,QAAnBX,MAAAA,OAAAA,EAAAA,EAAUW,QACZrB,EAAIsB,SAAW,UAGbZ,GAAAA,EAAUa,OACZvB,EAAIuB,KAAOb,EAASa,OAGlBtB,SAAoBS,GAAAA,EAAUc,kBAI3BxB,EAAIyB,WAHFzB,EAAIsB,SAAWtB,EAAI0B,OAAS1B,EAAIuB,IAI3C"}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@chriscdn/build-url",
+  "version": "1.0.0",
+  "license": "MIT",
+  "type": "module",
+  "source": "./src/index.ts",
+  "main": "./lib/index.cjs",
+  "module": "./lib/index.module.js",
+  "unpkg": "./lib/index.umd.js",
+  "exports": {
+    "require": "./lib/index.cjs",
+    "default": "./lib/index.modern.js"
+  },
+  "types": "./lib/index.d.ts",
+  "scripts": {
+    "build": "rm -rf ./lib/ && microbundle",
+    "dev": "microbundle watch",
+    "test": "jest"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.11",
+    "jest": "^29.7.0",
+    "microbundle": "^0.15.1",
+    "ts-jest": "^29.1.1"
+  }
+}

package/src/index.ts

@@ -0,0 +1,73 @@
+export interface UrlOptions {
+  queryParams?: {
+    [x: string]: any;
+  };
+  hash?: string;
+  path?: string | null;
+  returnAbsoluteUrl?: boolean;
+}
+
+const isEmpty = (value: any) => value === null || value === undefined;
+// ||(typeof value === "string" && value.trim().length === 0);
+
+export default function buildUrl(
+  inputUrl?: string | UrlOptions,
+  options?: UrlOptions
+) {
+  let url: URL;
+  let isValidInputUrl = false;
+
+  try {
+    url = new URL(inputUrl as string);
+  } catch (error) {
+    isValidInputUrl = true;
+
+    if (typeof inputUrl === "string") {
+      const host =
+        typeof window === "undefined"
+          ? "http://example.com"
+          : window.location.origin;
+
+      url = new URL(`${host}/${inputUrl.replace(/^\/|\/$/g, "")}`);
+    } else {
+      url =
+        typeof window === "undefined"
+          ? new URL("http://example.com")
+          : new URL(window.location.href);
+    }
+  }
+
+  const _options = typeof inputUrl === "string" ? options : inputUrl;
+
+  if (_options?.queryParams) {
+    for (const key in _options.queryParams) {
+      if (Object.prototype.hasOwnProperty.call(_options.queryParams, key)) {
+        const element = _options.queryParams[key];
+
+        if (isEmpty(element)) {
+          url.searchParams.delete(key);
+        } else {
+          url.searchParams.set(key, element);
+        }
+      }
+    }
+  }
+
+  if (_options?.path) {
+    url.pathname = _options.path;
+  }
+
+  if (_options?.path === null) {
+    url.pathname = "";
+  }
+
+  if (_options?.hash) {
+    url.hash = _options.hash;
+  }
+
+  if (isValidInputUrl && !_options?.returnAbsoluteUrl) {
+    return url.pathname + url.search + url.hash;
+  }
+
+  return url.toString();
+}