feat: add openapi gen to core

packages/core-tools/src/routes.ts

@@ -79,20 +79,16 @@ export async function gatherRouteInformation(path: string): Promise<RouteWithMet
  * Generate documentation snippet for one route
  * @param routeWithInfo A route instance with its meta information
  * @param outDirectorySchemasPath Path to directory that will contain relevant schemas for the route
- * @param schemasToCopy Schemas identified as relevant for this route
  * @param tagsToKeep Tags / keywords that can be used for grouping routes
  */
 export function generateOpenAPIForRoute(
   routeWithInfo: RouteWithMetaInformation,
   outDirectorySchemasPath: string,
-  schemasToCopy: string[],
   tagsToKeep: string[],
 ): OpenAPIV3.PathItemObject {
   const route = routeWithInfo.route;
   const openapiPath: OpenAPIV3.PathItemObject = {};
 
-  schemasToCopy.push(route.requestBodyName, route.responseBodyName);
-
   openapiPath[route.method.toLowerCase() as OpenAPIV3.HttpMethods] = {
     summary: capitalize(routeWithInfo.description.shortText?.replace(/(Route to |Route for )/gim, '')),
     description: routeWithInfo.description.text,
@@ -133,7 +129,6 @@ export function generateOpenAPIForRoute(
   };
 
   for (const error of route.errors) {
-    schemasToCopy.push(error.name);
     openapiPath[route.method.toLowerCase() as OpenAPIV3.HttpMethods]!.responses![error.statusCode] = {
       description:
         error.message ?? capitalize(error.name.replaceAll(/([A-Z][a-z])/g, ' $1').replace('SC ', '')),
@@ -155,7 +150,7 @@ export function generateOpenAPIForRoute(
         required: true,
         schema: {
           // TODO make this less of a hack and search copied schemas for the first occurring definition
-          $ref: `schemas/SCSearchResponse.json#/definitions/${schemaDefinition}`,
+          $ref: `schema/SCSearchResponse.json#/definitions/${schemaDefinition}`,
         },
       };
       openapiPath[route.method.toLowerCase() as OpenAPIV3.HttpMethods]?.parameters?.push(openapiParameter);