OpenAPI React Query Codegen

Node.js library that generates React Query (also called TanStack Query) hooks based on an OpenAPI specification file.

Features

• Supports generation of custom react hooks that use React Query's useQuery and useMutation hooks
• Supports generation of query keys for query caching
• Supports the option to use pure TypeScript clients generated by OpenAPI Typescript Codegen

Install

$ npm i -D @davstack/openapi-react-query-codegen

Usage

$ openapi-rq --help

Usage: openapi-rq [options]

Generate React Query code based on OpenAPI

Options:
  -V, --version              output the version number
  -i, --input <value>        OpenAPI specification, can be a path, url or string content (required)
  -o, --output <value>       Output directory (default: "openapi")
  -c, --client <value>       HTTP client to generate [fetch, xhr, node, axios, angular] (default: "fetch")
  --useUnionTypes            Use union types (default: false)
  --exportSchemas <value>    Write schemas to disk (default: false)
  --indent <value>           Indentation options [4, 2, tabs] (default: "4")
  --postfixServices <value>  Service name postfix (default: "Service")
  --postfixModels <value>    Modal name postfix
  --request <value>          Path to custom request file
  -h, --help                 display help for command

Example Usage

Command

$ openapi-rq -i ./petstore.yaml

Output directory structure

- openapi
  - queries
    - index.ts <- custom react hooks
  - requests <- output code generated by OpenAPI Typescript Codegen

In your app

1// App.tsx
2import {
3  usePetServiceFindPetsByStatus,
4} from "../openapi/queries";
5function App() {
6  const { data } = usePetServiceFindPetsByStatus({ status: ["available"] });
7
8  return (
9    <div className="App">
10      <h1>Pet List</h1>
11      <ul>
12        {data?.map((pet) => (
13          <li key={pet.id}>{pet.name}</li>
14        ))}
15      </ul>
16    </div>
17  );
18}
19
20export default App;

You can also use pure TS clients.

1import { useQuery } from "@tanstack/react-query";
2import { PetService } from '../openapi/requests/services/PetService';
3import {
4  usePetServiceFindPetsByStatusKey,
5} from "../openapi/queries";
6
7function App() {
8  // You can still use the auto-generated query key
9  const { data } = useQuery([usePetServiceFindPetsByStatusKey], () => {
10    // Do something here
11  
12    return PetService.findPetsByStatus(['available']);
13  });
14
15  return (
16    <div className="App">
17      {/* .... */}
18    </div>
19  );
20}
21
22export default App;

License

MIT