Re-generate the clients

⚠️ This guide assumes the Backend definitions have been updated in apps/alerting.

Re-create OpenAPI specification

Start with re-generating the OpenAPI snapshots by running the test in pkg/tests/apis/openapi_test.go.

This will output the OpenAPI JSON spec file(s) in pkg/tests/apis/openapi_snapshots.

Next up run the post-processing of the snapshots with yarn run process-specs, this will copy processed specifications to ./data/openapi/.

These files are built using the yarn run codegen command, make sure to run that in the Grafana Alerting package working directory.

yarn --cwd ./packages/grafana-alerting run codegen.

API clients will be written to src/grafana/api/<version>/api.gen.ts.

Make sure to create a versioned API client for each API version – see src/grafana/api/v0alpha1/api.ts as an example.