Escapes markdown descriptions (#548)

This avoids accidental closing of comment tags.

Fixes #547

Author: ashsmith

src/utils.ts

@@ -1,7 +1,7 @@
 import { OpenAPI2, OpenAPI3, ReferenceObject } from "./types";
 
 export function comment(text: string): string {
-  const commentText = text.trim();
+  const commentText = text.trim().replace(/\*\//g, "*\\/");
 
   // if single-line comment
   if (commentText.indexOf("\n") === -1) {

tests/utils/index.test.ts

@@ -1,4 +1,4 @@
-import { swaggerVersion } from "../../src/utils";
+import { swaggerVersion, comment } from "../../src/utils";
 
 describe("swaggerVersion", () => {
   it("v2", () => {
@@ -11,3 +11,18 @@ describe("swaggerVersion", () => {
     expect(() => swaggerVersion({} as any)).toThrow();
   });
 });
+
+describe("comment", () => {
+  it("escapes markdown in comments", () => {
+    const text = `Example markdown
+**/some/url/path**`;
+
+    expect(comment(text)).toBe(
+      `/**
+  * Example markdown
+  * **\\/some/url/path**
+  */
+`
+    );
+  });
+});