chore(): start moving some packages to the core directory (#7215)

packages/cli/oas/oas-github-ci/scripts/build-openapi.js

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+
+const fs = require("fs/promises")
+const os = require("os")
+const path = require("path")
+const execa = require("execa")
+
+const isDryRun = process.argv.indexOf("--dry-run") !== -1
+const withFullFile = process.argv.indexOf("--with-full-file") !== -1
+const v2 = process.argv.indexOf("--v2") !== -1
+const basePath = path.resolve(__dirname, `../`)
+const repoRootPath = path.resolve(basePath, `../../../`)
+const docsApiPath = v2 ? path.resolve(repoRootPath, "www/apps/api-reference/specs-v2") : 
+  path.resolve(repoRootPath, "www/apps/api-reference/specs")
+
+const run = async () => {
+  const oasOutDir = isDryRun ? await getTmpDirectory() : docsApiPath
+  for (const apiType of ["store", "admin"]) {
+    await generateOASSource(oasOutDir, apiType)
+    const oasSrcFile = path.resolve(oasOutDir, `${apiType}.oas.json`)
+    const docsOutDir = path.resolve(oasOutDir, apiType)
+    await generateDocs(oasSrcFile, docsOutDir, isDryRun)
+  }
+}
+
+const generateOASSource = async (outDir, apiType) => {
+  const commandParams = ["oas", `--type=${apiType}`, `--out-dir=${outDir}`, "--local"]
+  if (v2) {
+    commandParams.push(`--v2`)
+  }
+  const { all: logs } = await execa(
+    "medusa-oas",
+    commandParams,
+    { cwd: basePath, all: true }
+  )
+  console.log(logs)
+}
+
+const generateDocs = async (srcFile, outDir, isDryRun) => {
+  let params = [
+    "docs",
+    `--src-file=${srcFile}`,
+    `--out-dir=${outDir}`,
+    `--clean`,
+    `--split`,
+  ]
+  if (isDryRun) {
+    params.push("--dry-run")
+  }
+  await runMedusaOasCommand(params)
+  if (withFullFile && !isDryRun) {
+    console.log("Generating full file...")
+    params = [
+      "docs",
+      `--src-file=${srcFile}`,
+      `--out-dir=${outDir}`,
+      `--main-file-name=openapi.full.yaml`
+    ]
+    await runMedusaOasCommand(params)
+    console.log("Finished generating full file.")
+  }
+}
+
+const runMedusaOasCommand = async (params) => {
+  const { all: logs } = await execa("medusa-oas", params, {
+    cwd: basePath,
+    all: true,
+  })
+  console.log(logs)
+}
+
+const getTmpDirectory = async () => {
+  /**
+   * RUNNER_TEMP: GitHub action, the path to a temporary directory on the runner.
+   */
+  const tmpDir = process.env["RUNNER_TEMP"] ?? os.tmpdir()
+  return await fs.mkdtemp(tmpDir)
+}
+
+void (async () => {
+  try {
+    await run()
+  } catch (err) {
+    console.log(err)
+    process.exit(1)
+  }
+})()