SWR

You should have an OpenAPI specification and an Orval config where you define the mode as swr.

Example with SWR

1 module.exports = {
2   petstore: {
3     output: {
4       mode: 'tags-split',
5       target: 'src/petstore.ts',
6       schemas: 'src/model',
7       client: 'swr',
8       mock: true,
9     },
10     input: {
11       target: './petstore.yaml',
12     },
13   },
14 };

Checkout the orval config reference to see all available options.

The SWR model will generate an implementation file with one custom hook per path in your OpenAPI Specification.

Like the following example from this swagger:

1 export const showPetById = (
2   petId: string,
3   options?: AxiosRequestConfig,
4 ): Promise<AxiosResponse<Pet>> => {
5   return axios.get(`/pets/${petId}`, options);
6 };
7 
8 export const getShowPetByIdKey = (petId: string) => [`/pets/${petId}`];
9 Re;
10 
11 export const useShowPetById = <TError = Error>(
12   petId: string,
13   options?: {
14     swr?: SWRConfiguration<AsyncReturnType<typeof showPetById>, TError> & {
15       swrKey?: Key;
16       enabled?: boolean;
17     };
18     axios?: AxiosRequestConfig;
19   },
20 ) => {
21   const { swr: swrOptions, axios: axiosOptions } = options ?? {};
22 
23   const isEnabled = swrOptions?.enabled !== false && !!petId;
24   const swrKey =
25     swrOptions?.swrKey ?? (() => (isEnabled ? getShowPetByIdKey(petId) : null));
26   const swrFn = () => showPetById(petId, axiosOptions);
27 
28   const query = useSwr<AsyncReturnType<typeof swrFn>, TError>(
29     swrKey,
30     swrFn,
31     swrOptions,
32   );
33 
34   return {
35     swrKey,
36     ...query,
37   };
38 };

Checkout here the full example