Code Generation

OpenAPI

Right now, we have a first version of a code generator from OpenApi schemas over at rtk-incubator/rtk-query-codegen.

You can create an api by running:

curl -o petstore.json https://petstore3.swagger.io/api/v3/openapi.json
npx @rtk-incubator/rtk-query-codegen-openapi petstore.json > petstore-api.generated.ts

We recommend placing these generated types in one file that you do not modify (so you can constantly re-generate it when your API definition changes) and creating a second file to enhance it with additional info:

petstore-api.ts

import { api as generatedApi } from './petstore-api.generated';

export const api = generatedApi.enhanceEndpoints({
  addEntityTypes: ['Pet'],
  endpoints: {
    // basic notation: just specify properties to be overridden
    getPetById: {
      provides: (response) => [{ type: 'Pet', id: response.id }],
    },
    findPetsByStatus: {
      provides: (response) => [
        { type: 'Pet', id: 'LIST' },
        ...response.map((pet) => ({ type: 'Pet' as const, id: pet.id })),
      ],
    },
    // alternate notation: callback that gets passed in `endpoint` - you can freely modify the object here
    addPet: (endpoint) => {
      endpoint.invalidates = (response) => [{ type: 'Pet', id: response.id }];
    },
    updatePet: {
      invalidates: (response) => [{ type: 'Pet', id: response.id }],
    },
    deletePet: {
      invalidates: (_, arg) => [{ type: 'Pet', id: arg.petId }],
    },
  },
});

export const {
  useGetPetByIdQuery,
  useFindPetsByStatusQuery,
  useAddPetMutation,
  useUpdatePetMutation,
  useDeletePetMutation,
} = api;

Code Generation#

OpenAPI#

Code Generation

OpenAPI