refactor(document): extract file route builder and normalize query composition

actions/clients/fileRouteBuilder.js

@@ -0,0 +1,33 @@
+const encodeRouteParam = (value) => encodeURIComponent(String(value));
+
+export const buildFileQuery = (path, params = {}, options = {}) => {
+    const { encode = false } = options;
+
+    const entries = Object.entries(params).filter(([, value]) => {
+        return value !== undefined && value !== null;
+    });
+
+    if (entries.length === 0) {
+        return path;
+    }
+
+    const query = entries
+        .map(([key, value]) => {
+            if (!encode) {
+                return `${key}=${String(value)}`;
+            }
+
+            return `${encodeRouteParam(key)}=${encodeRouteParam(value)}`;
+        })
+        .join("&");
+
+    return `${path}?${query}`;
+};
+
+export const withBaseUrl = (baseUrl, route) => {
+    return `${baseUrl}${route}`;
+};
+
+export const appendQuerySuffix = (route, suffix = "") => {
+    return `${route}${suffix}`;
+};

actions/clients/index.js

@@ -1,3 +1,4 @@
 export * from "./relayClient";
 export * from "./endpointClient";
 export * from "./fileClient";
+export * from "./fileRouteBuilder";