feat(api-ref): show schema of a tag (#7297)

www/apps/api-reference/app/api/schema/route.ts

@@ -0,0 +1,73 @@
+import { NextResponse } from "next/server"
+import { SchemaObject, Version } from "../../../types/openapi"
+import path from "path"
+import { existsSync, promises as fs } from "fs"
+import { parseDocument } from "yaml"
+
+export async function GET(request: Request) {
+  const { searchParams } = new URL(request.url)
+  let name = searchParams.get("name")
+  const area = searchParams.get("area")
+  const version = (searchParams.get("version") as Version) || "1"
+
+  if (!name) {
+    return NextResponse.json(
+      {
+        success: false,
+        message: `Name is required.`,
+      },
+      {
+        status: 400,
+      }
+    )
+  }
+
+  if (area !== "admin" && area !== "store") {
+    return NextResponse.json(
+      {
+        success: false,
+        message: `area ${area} is not allowed`,
+      },
+      {
+        status: 400,
+      }
+    )
+  }
+
+  name = name
+    .replace("#/components/schemas/", "")
+    .replaceAll("./components/schemas/", "")
+
+  const schemaPath = path.join(
+    process.cwd(),
+    version === "1" ? "specs" : "specs-v2",
+    area,
+    "components",
+    "schemas",
+    name
+  )
+
+  if (!existsSync(schemaPath)) {
+    return NextResponse.json(
+      {
+        success: false,
+        message: `Schema ${name} doesn't exist.`,
+      },
+      {
+        status: 404,
+      }
+    )
+  }
+
+  const schemaContent = await fs.readFile(schemaPath, "utf-8")
+  const schema = parseDocument(schemaContent).toJS() as SchemaObject
+
+  return NextResponse.json(
+    {
+      schema,
+    },
+    {
+      status: 200,
+    }
+  )
+}