refactor: add some convenience methods to the framework lib/string an…

…d lib/url files

src/framework/lib/string.js

@@ -8,6 +8,8 @@ module.exports = {
   decode: decodeFromBase,
   deflate,
   inflate,
+  stripFirstNCharsFromString,
+  stripLastNCharsFromString,
 };
 
 function convertBackSlashToForwardSlash(str) {
@@ -76,3 +78,11 @@ function encode(str, opts) {
 
   return encoded;
 }
+
+function stripFirstNCharsFromString(str, n = 1) {
+  return str.substring(n);
+}
+
+function stripLastNCharsFromString(str, n = 1) {
+  return str.substring(0, str.length - n);
+}

src/framework/lib/url.js

@@ -0,0 +1,28 @@
+const { stripFirstNCharsFromString, stripLastNCharsFromString } = require("./string");
+
+module.exports = {
+  getValidUrl,
+  normalizeUrlPath,
+};
+
+
+function getValidUrl(baseUrl, path, apiBasePath) {
+  path = normalizeUrlPath(path) || "";
+  apiBasePath = normalizeUrlPath(apiBasePath) || "";
+
+  return baseUrl + (apiBasePath ? `/${apiBasePath}` : "") + `/${path}`;
+}
+
+function normalizeUrlPath(path) {
+  path = String(path);
+
+  if(path.startsWith("/")) {
+    path = stripFirstNCharsFromString(path, 1);
+  }
+
+  if(path.endsWith("/")) {
+    path = stripLastNCharsFromString(path, 1);
+  }
+
+  return path;
+}