feat(openapi-fetch): baseUrl per request

Author: Gruak

packages/openapi-fetch/src/index.d.ts

@@ -109,6 +109,7 @@ export type FetchResponse<T, Options, Media extends MediaType> =
 
 export type RequestOptions<T> = ParamsOption<T> &
   RequestBodyOption<T> & {
+    baseUrl?: string;
     querySerializer?: QuerySerializer<T> | QuerySerializerOptions;
     bodySerializer?: BodySerializer<T>;
     parseAs?: ParseAs;
@@ -253,3 +254,6 @@ export declare function createFinalURL<O>(
 
 /** Merge headers a and b, with b taking priority */
 export declare function mergeHeaders(...allHeaders: (HeadersOptions | undefined)[]): Headers;
+
+/** Remove trailing slash from url */
+export declare function removeTrailingSlash(url: string): string;

packages/openapi-fetch/src/index.js

@@ -40,9 +40,7 @@ export default function createClient(clientOptions) {
     headers: baseHeaders,
     ...baseOptions
   } = { ...clientOptions };
-  if (baseUrl.endsWith("/")) {
-    baseUrl = baseUrl.substring(0, baseUrl.length - 1);
-  }
+  baseUrl = removeTrailingSlash(baseUrl);
   baseHeaders = mergeHeaders(DEFAULT_HEADERS, baseHeaders);
   const middlewares = [];
 
@@ -53,6 +51,7 @@ export default function createClient(clientOptions) {
    */
   async function coreFetch(schemaPath, fetchOptions) {
     const {
+      baseUrl: localBaseUrl,
       fetch = baseFetch,
       headers,
       params = {},
@@ -61,6 +60,9 @@ export default function createClient(clientOptions) {
       bodySerializer = globalBodySerializer ?? defaultBodySerializer,
       ...init
     } = fetchOptions || {};
+    if (localBaseUrl) {
+      baseUrl = removeTrailingSlash(localBaseUrl);
+    }
 
     let querySerializer =
       typeof globalQuerySerializer === "function"
@@ -484,3 +486,14 @@ export function mergeHeaders(...allHeaders) {
   }
   return finalHeaders;
 }
+
+/**
+ * Remove trailing slash from url
+ * @type {import("./index.js").removeTrailingSlash}
+ */
+export function removeTrailingSlash(url) {
+  if (url.endsWith("/")) {
+    return url.substring(0, url.length - 1);
+  }
+  return url;
+}

packages/openapi-fetch/test/index.test.ts

@@ -767,6 +767,29 @@ describe("client", () => {
       expect(getRequestUrl().href).toBe(toAbsoluteURL("/self"));
     });
 
+    it("baseUrl per request", async () => {
+      const localBaseUrl = "https://api.foo.bar/v1";
+      let client = createClient<paths>({ baseUrl });
+
+      const { getRequestUrl } = useMockRequestHandler({
+        baseUrl: localBaseUrl,
+        method: "get",
+        path: "/self",
+        status: 200,
+        body: { message: "OK" },
+      });
+
+      await client.GET("/self", { baseUrl: localBaseUrl });
+
+      // assert baseUrl and path mesh as expected
+      expect(getRequestUrl().href).toBe(toAbsoluteURL("/self", localBaseUrl));
+
+      client = createClient<paths>({ baseUrl });
+      await client.GET("/self", { baseUrl: localBaseUrl });
+      // assert trailing '/' was removed
+      expect(getRequestUrl().href).toBe(toAbsoluteURL("/self", localBaseUrl));
+    });
+
     describe("headers", () => {
       it("persist", async () => {
         const headers: HeadersInit = { Authorization: "Bearer secrettoken" };
@@ -1272,6 +1295,33 @@ describe("client", () => {
         expect(req.headers.get("onFetch")).toBe("exists");
         expect(req.headers.get("onRequest")).toBe("exists");
       });
+
+      it("baseUrl can be overriden", async () => {
+        useMockRequestHandler({
+          baseUrl: "https://api.foo.bar/v1/",
+          method: "get",
+          path: "/self",
+          status: 200,
+          body: {},
+        });
+
+        let requestBaseUrl = "";
+
+        const client = createClient<paths>({
+          baseUrl,
+        });
+        client.use({
+          onRequest({ options }) {
+            requestBaseUrl = options.baseUrl;
+            return undefined;
+          },
+        });
+
+        await client.GET("/self", {
+          baseUrl: "https://api.foo.bar/v1/"
+        });
+        expect(requestBaseUrl).toBe("https://api.foo.bar/v1");
+      });
     });
   });