feat(lib/dev-hub-url): allow overriding dev hub & doc base URLs

- Rename `generateDevHubHref` to `getDevHubUrl` and move to
  `src/lib/dev-hub-url.js`
- Rename `generateDocsHref` to `getDocUrl` and move to
  `src/lib/dev-hub-url.js`
- Expose public `setDevHubBaseUrl` so that consumers of this project may
  change the base URL used for dev hub & doc links.

Fixes #1579

Author: florian-sanders-cc

src/lib/dev-hub-url.js

@@ -0,0 +1,43 @@
+/**
+ * If you change the base URL here, you should probably also change it in places where it's still hard coded:
+ * - README.md,
+ * - CONTRIBUTING.md,
+ * - sandbox/index.html,
+ * - test/utils.test.js.
+ */
+let devHubBaseUrl = 'https://www.clever.cloud/developers';
+
+/** @param {string} value */
+export function setDevHubBaseUrl(value) {
+  devHubBaseUrl = value.replace(/\/$/, '');
+}
+
+/**
+ * Rely on this helper for every reference to the docs website
+ *
+ * @param {string} [path]
+ * @returns {string} href
+ */
+export function getDocUrl(path = '') {
+  const docsBaseUrl = devHubBaseUrl + '/doc';
+
+  if (path === '') {
+    return docsBaseUrl;
+  }
+
+  return path.startsWith('/') ? `${docsBaseUrl}${path}` : `${docsBaseUrl}/${path}`;
+}
+
+/**
+ * Rely on this helper for every reference to the developer hub website
+ *
+ * @param {string} path
+ * @returns {string}
+ */
+export function getDevHubUrl(path = '') {
+  if (path === '') {
+    return devHubBaseUrl;
+  }
+
+  return path.startsWith('/') ? `${devHubBaseUrl}${path}` : `${devHubBaseUrl}/${path}`;
+}

src/lib/utils.js

@@ -1,12 +1,3 @@
-/**
- * If you change the base URL here, you should probably also change it in places where it's still hard coded:
- * - README.md,
- * - CONTRIBUTING.md,
- * - sandbox/index.html,
- * - test/utils.test.js.
- */
-const CC_DEV_HUB_BASE_URL = 'https://www.clever.cloud/developers/';
-
 /**
  * @param {Record<string, any>} a
  * @param {Record<string, any>} b
@@ -256,39 +247,6 @@ export function sleep(delay) {
   });
 }
 
-/**
- * Rely on this helper for every reference to the Clever Cloud docs website
- *
- * @param {string} [path]
- * @returns {string} href
- */
-export function generateDocsHref(path = '') {
-  /**
-   * Ensure "/doc" is appended after the base URL, then append the provided path
-   * If you change the base URL here, you should probably also change it in places where it's still hard coded:
-   * - README.md,
-   * - CONTRIBUTING.md,
-   * - sandbox/index.html,
-   * - test/utils.test.js.
-   */
-  const CC_DOCS_BASE_URL = CC_DEV_HUB_BASE_URL.replace(/\/$/, '') + '/doc/';
-  // if a '/' is present at the beginning, the path is considered absolute and it is appended right after the origin
-  // we want the path to always be appended after the existing path of the base URL so we remove the first '/' so that it's considered relative
-  return new URL(path.replace(/^\//, ''), CC_DOCS_BASE_URL).href;
-}
-
-/**
- * Rely on this helper for every reference to the Clever Cloud developer hub website
- *
- * @param {string} [path]
- * @returns {string} href
- */
-export function generateDevHubHref(path = '') {
-  // if a '/' is present at the beginning, the path is considered absolute and it is appended right after the origin
-  // we want the path to always be appended after the existing path of the base URL so we remove the first '/' so that it's considered relative
-  return new URL(path.replace(/^\//, ''), CC_DEV_HUB_BASE_URL).href;
-}
-
 /**
  * Checks if a given DOM element is currently visible within a given container's bounds.
  *