feat(cli): shallow merge OAS paths

Author: freakyfelt

packages/cli/src/document-transformer.test.ts

@@ -9,12 +9,29 @@ import {
 import { DocumentTransformer } from "./document-transformer.js";
 import { OASDocument, RPCDocument } from "./types";
 
+const healthCheck = {
+	"/health": {
+		get: {
+			operationId: "health",
+			description: "Health check",
+			responses: {
+				200: {
+					description: "OK",
+				},
+			},
+		},
+	},
+};
+
 const rpcDocument: RPCDocument = {
 	yarpc: "1.0.0",
 	info: {
 		title: "Widgets API",
 		version: "1.0.0",
 	},
+	paths: {
+		...healthCheck,
+	},
 	operations: {
 		queries,
 		mutations,
@@ -25,7 +42,10 @@ const rpcDocument: RPCDocument = {
 const oasDocument: OASDocument = {
 	openapi: "3.1.0",
 	info: rpcDocument.info,
-	paths,
+	paths: {
+		...healthCheck,
+		...paths,
+	},
 	components: rpcDocument.components,
 };
 

packages/cli/src/document-transformer.ts

@@ -17,7 +17,7 @@ export class DocumentTransformer {
 	}
 
 	async transform(): Promise<OASDocument> {
-		const { info, operations, yarpc, ...rest } = this.doc;
+		const { info, paths: oasPaths, operations, yarpc, ...rest } = this.doc;
 
 		if (typeof yarpc !== "string") {
 			throw new Error("Missing required yarpc version");
@@ -32,7 +32,10 @@ export class DocumentTransformer {
 		return {
 			openapi: "3.1.0",
 			info,
-			paths,
+			paths: {
+				...oasPaths,
+				...paths,
+			},
 			...rest,
 		};
 	}