Merge pull request #19955 from sennyeya/optic-integration-oa

feat: add support for validating OpenAPI specs against test runs

.changeset/nasty-colts-tickle.md

@@ -0,0 +1,6 @@
+---
+'@backstage/plugin-catalog-backend': patch
+'@backstage/plugin-search-backend': patch
+---
+
+Update the OpenAPI spec with more complete error responses and request bodies using Optic. Also, updates the test cases to use the new `supertest` pass through from `@backstage/backend-openapi-utils`.

.changeset/old-chairs-switch.md

@@ -0,0 +1,7 @@
+---
+'@backstage/repo-tools': minor
+---
+
+Adds a new command `schema openapi test` that performs runtime validation of your OpenAPI specs using your test data. Under the hood, we're using Optic to perform this check, really cool work by them!
+
+To use this new command, you will have to run `yarn add @useoptic/optic` in the root of your repo.

.changeset/tricky-vans-behave.md

@@ -0,0 +1,5 @@
+---
+'@backstage/backend-openapi-utils': patch
+---
+
+Adds a new function `wrapInOpenApiTestServer` that allows for proxied requests at runtime. This will support the new `yarn backstage-repo-tools schema openapi test` command.