homebox/frontend/lib/api/base/urls.ts

const parts = {
  host: "http://localhost.com",
  prefix: "/api/v1",
};

export function overrideParts(host: string, prefix: string) {
  parts.host = host;
  parts.prefix = prefix;
}

export type QueryValue = string | string[] | number | number[] | boolean | null | undefined;

/**
 * route is a the main URL builder for the API. It will use a predefined host and prefix (global)
 * in the urls.ts file and then append the passed in path parameter uring the `URL` class from the
 * browser. It will also append any query parameters passed in as the second parameter.
 *
 * The default host `http://localhost.com` is removed from the path if it is present. This allows us
 * to bootstrap the API with different hosts as needed (like for testing) but still allows us to use
 * relative URLs in pruduction because the API and client bundle are served from the same server/host.
 */
export function route(rest: string, params: Record<string, QueryValue> = {}): string {
  const url = new URL(parts.prefix + rest, parts.host);

  for (const [key, value] of Object.entries(params)) {
    if (Array.isArray(value)) {
      for (const item of value) {
        url.searchParams.append(key, String(item));
      }
    } else {
      url.searchParams.append(key, String(value));
    }
  }

  return url.toString().replace("http://localhost.com", "");
}