feat(fetch): support explode property

.gitignore

@@ -102,4 +102,5 @@ typings/
 
 package-lock.json
 tests/generated/**
-.turbo
+.turbo
+.next

packages/fetch/src/index.ts

@@ -11,7 +11,13 @@ import {
   toObjectString,
   generateBodyOptions,
   isObject,
+  resolveRef,
 } from '@orval/core';
+import {
+  PathItemObject,
+  ParameterObject,
+  ReferenceObject,
+} from 'openapi3-ts/oas30';
 
 export const generateRequestFunction = (
   {
@@ -26,7 +32,7 @@ export const generateRequestFunction = (
     formUrlEncoded,
     override,
   }: GeneratorVerbOptions,
-  { route }: GeneratorOptions,
+  { route, context, pathRoute }: GeneratorOptions,
 ) => {
   const isRequestOptions = override?.requestOptions !== false;
   const isFormData = override?.formData !== false;
@@ -42,18 +48,51 @@ export const generateRequestFunction = (
     ),
     'implementation',
   );
+
+  const spec = context.specs[context.specKey].paths[pathRoute] as
+    | PathItemObject
+    | undefined;
+  const parameters =
+    spec?.[verb]?.parameters || ([] as (ParameterObject | ReferenceObject)[]);
+
+  const explodeParameters = parameters.filter((parameter) => {
+    const { schema } = resolveRef<ParameterObject>(parameter, context);
+
+    return schema.in === 'query' && schema.explode;
+  });
+
+  const explodeParametersNames = explodeParameters.map((parameter) => {
+    const { schema } = resolveRef<ParameterObject>(parameter, context);
+
+    return schema.name;
+  });
+
+  const explodeArrayImplementation =
+    explodeParameters.length > 0
+      ? `const explodeParameters = ${JSON.stringify(explodeParametersNames)};
+
+    if (value instanceof Array && explodeParameters.includes(key)) {
+      value.forEach((v) => normalizedParams.append(key, v === null ? 'null' : v.toString()));
+      return;
+    }
+      `
+      : '';
+
+  const isExplodeParametersOnly =
+    explodeParameters.length === parameters.length;
+
+  const nomalParamsImplementation = `if (value !== undefined) {
+      normalizedParams.append(key, value === null ? 'null' : value.toString())
+    }`;
+
   const getUrlFnImplementation = `export const ${getUrlFnName} = (${getUrlFnProps}) => {
 ${
   queryParams
-    ? `
-  const normalizedParams = new URLSearchParams();
+    ? `  const normalizedParams = new URLSearchParams();
 
   Object.entries(params || {}).forEach(([key, value]) => {
-    if (value === null) {
-      normalizedParams.append(key, 'null');
-    } else if (value !== undefined) {
-      normalizedParams.append(key, value.toString());
-    }
+    ${explodeArrayImplementation}
+    ${!isExplodeParametersOnly ? nomalParamsImplementation : ''}
   });`
     : ''
 }

samples/hono/hono-with-fetch-client/next-app/app/gen/pets/pets.msw.ts

@@ -23,6 +23,7 @@ export const getCreatePetsResponseMock = (
 ): Pet => ({
   id: faker.number.int({ min: undefined, max: undefined }),
   name: faker.word.sample(),
+  tag: faker.word.sample(),
   ...overrideResponse,
 });
 
@@ -31,6 +32,7 @@ export const getUpdatePetsResponseMock = (
 ): Pet => ({
   id: faker.number.int({ min: undefined, max: undefined }),
   name: faker.word.sample(),
+  tag: faker.word.sample(),
   ...overrideResponse,
 });
 
@@ -39,6 +41,7 @@ export const getShowPetByIdResponseMock = (
 ): Pet => ({
   id: faker.number.int({ min: undefined, max: undefined }),
   name: faker.word.sample(),
+  tag: faker.word.sample(),
   ...overrideResponse,
 });
 

samples/hono/hono-with-fetch-client/next-app/app/gen/pets/pets.ts

@@ -23,10 +23,8 @@ export const getListPetsUrl = (params?: ListPetsParams) => {
   const normalizedParams = new URLSearchParams();
 
   Object.entries(params || {}).forEach(([key, value]) => {
-    if (value === null) {
-      normalizedParams.append(key, 'null');
-    } else if (value !== undefined) {
-      normalizedParams.append(key, value.toString());
+    if (value !== undefined) {
+      normalizedParams.append(key, value === null ? 'null' : value.toString());
     }
   });
 

samples/hono/hono-with-fetch-client/next-app/next-env.d.ts

@@ -0,0 +1,5 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+
+// NOTE: This file should not be edited
+// see https://nextjs.org/docs/basic-features/typescript for more information.

samples/next-app-with-fetch/app/gen/pets/pets.ts

@@ -52,10 +52,8 @@ export const getListPetsUrl = (params?: ListPetsParams) => {
   const normalizedParams = new URLSearchParams();
 
   Object.entries(params || {}).forEach(([key, value]) => {
-    if (value === null) {
-      normalizedParams.append(key, 'null');
-    } else if (value !== undefined) {
-      normalizedParams.append(key, value.toString());
+    if (value !== undefined) {
+      normalizedParams.append(key, value === null ? 'null' : value.toString());
     }
   });
 

samples/react-app-with-swr/fetch-client/src/api/endpoints/swaggerPetstore.ts

@@ -23,10 +23,8 @@ export const getListPetsUrl = (params?: ListPetsParams) => {
   const normalizedParams = new URLSearchParams();
 
   Object.entries(params || {}).forEach(([key, value]) => {
-    if (value === null) {
-      normalizedParams.append(key, 'null');
-    } else if (value !== undefined) {
-      normalizedParams.append(key, value.toString());
+    if (value !== undefined) {
+      normalizedParams.append(key, value === null ? 'null' : value.toString());
     }
   });
 

samples/react-query/custom-fetch/src/gen/pets/pets.ts

@@ -68,10 +68,8 @@ export const getListPetsUrl = (params?: ListPetsParams) => {
   const normalizedParams = new URLSearchParams();
 
   Object.entries(params || {}).forEach(([key, value]) => {
-    if (value === null) {
-      normalizedParams.append(key, 'null');
-    } else if (value !== undefined) {
-      normalizedParams.append(key, value.toString());
+    if (value !== undefined) {
+      normalizedParams.append(key, value === null ? 'null' : value.toString());
     }
   });
 

samples/svelte-query/custom-fetch/src/gen/pets/pets.ts

@@ -65,10 +65,8 @@ export const getListPetsUrl = (params?: ListPetsParams) => {
   const normalizedParams = new URLSearchParams();
 
   Object.entries(params || {}).forEach(([key, value]) => {
-    if (value === null) {
-      normalizedParams.append(key, 'null');
-    } else if (value !== undefined) {
-      normalizedParams.append(key, value.toString());
+    if (value !== undefined) {
+      normalizedParams.append(key, value === null ? 'null' : value.toString());
     }
   });
 

samples/swr-with-zod/src/gen/endpoints/pets/pets.ts

@@ -56,10 +56,8 @@ export const getListPetsUrl = (params?: ListPetsParams) => {
   const normalizedParams = new URLSearchParams();
 
   Object.entries(params || {}).forEach(([key, value]) => {
-    if (value === null) {
-      normalizedParams.append(key, 'null');
-    } else if (value !== undefined) {
-      normalizedParams.append(key, value.toString());
+    if (value !== undefined) {
+      normalizedParams.append(key, value === null ? 'null' : value.toString());
     }
   });
 

samples/vue-query/custom-fetch/src/gen/pets/pets.ts

@@ -67,10 +67,8 @@ export const getListPetsUrl = (params?: ListPetsParams) => {
   const normalizedParams = new URLSearchParams();
 
   Object.entries(params || {}).forEach(([key, value]) => {
-    if (value === null) {
-      normalizedParams.append(key, 'null');
-    } else if (value !== undefined) {
-      normalizedParams.append(key, value.toString());
+    if (value !== undefined) {
+      normalizedParams.append(key, value === null ? 'null' : value.toString());
     }
   });
 

tests/configs/fetch.config.ts

@@ -168,4 +168,14 @@ export default defineConfig({
       target: '../specifications/form-url-encoded.yaml',
     },
   },
+  parameters: {
+    output: {
+      target: '../generated/fetch/parameters/endpoints.ts',
+      schemas: '../generated/fetch/parameters/model',
+      client: 'fetch',
+    },
+    input: {
+      target: '../specifications/parameters.yaml',
+    },
+  },
 });

tests/specifications/parameters.yaml

@@ -71,6 +71,15 @@ paths:
           required: false
           schema:
             type: boolean
+        - name: tag
+          in: query
+          description: include pets tag
+          required: false
+          explode: true
+          schema:
+            type: array
+            items:
+              type: string
       responses:
         '200':
           description: A paged array of pets