try adding a convert step

Author: tiffanyqi

openapi/openapi.config.yaml

@@ -1,34 +1,34 @@
 apis:
   annotations:
     root: ./src/annotations.openapi.yaml
-    output: ./out/annotations-api.json
+    output: ./out/annotations-api.yaml
   data-pipelines:
     root: ./src/data-pipelines.openapi.yaml
-    output: ./out/data-pipelines-api.json
+    output: ./out/data-pipelines-api.yaml
   export:
     root: ./src/export.openapi.yaml
-    output: ./out/event-export-api.json
+    output: ./out/event-export-api.yaml
   gdpr:
     root: ./src/gdpr.openapi.yaml
-    output: ./out/gdpr-api-2.json
+    output: ./out/gdpr-api-2.yaml
   identity:
     root: ./src/identity.openapi.yaml
-    output: ./out/identity-api.json
+    output: ./out/identity-api.yaml
   ingestion:
     root: ./src/ingestion.openapi.yaml
-    output: ./out/ingestion-api.json
+    output: ./out/ingestion-api.yaml
   lexicon-schemas:
     root: ./src/lexicon-schemas.openapi.yaml
-    output: ./out/lexicon-schemas-api.json
+    output: ./out/lexicon-schemas-api.yaml
   query:
     root: ./src/query.openapi.yaml
-    output: ./out/query-api.json
+    output: ./out/query-api.yaml
   service-accounts:
     root: ./src/service-accounts.openapi.yaml
-    output: ./out/service-accounts-api.json
+    output: ./out/service-accounts-api.yaml
   warehouse-connectors:
     root: ./src/warehouse-connectors.openapi.yaml
-    output: ./out/warehouse-connectors-api.json
+    output: ./out/warehouse-connectors-api.yaml
 
 extends:
   - recommended

openapi/publish.js

@@ -8,11 +8,11 @@ const env = { ...process.env, DEBUG: "rdme*" };
 const execFile = util.promisify(require("node:child_process").execFile);
 
 const README_API_KEY = process.env.README_API_KEY;
+const README_VERSION = process.env.README_VERSION;
 if (!README_API_KEY) {
   console.error(`README_API_KEY not set`);
   process.exit(1);
 }
-const README_VERSION = process.env.README_VERSION;
 if (!README_VERSION) {
   console.error(`README_VERSION not set`);
   process.exit(1);
@@ -29,6 +29,21 @@ async function execAndLog(cmd, args) {
   }
 }
 
+function getSlugFromJson(file) {
+  const splitFile = file.split(`.json`);
+  return splitFile[0];
+}
+
+function getSlugFromYaml(file) {
+  const splitFile = file.split(`.yaml`);
+  return splitFile[0];
+}
+
+function convertSlugToJson(file) {
+  const slug = getSlugFromYaml(file);
+  return `${slug}.json`;
+}
+
 async function updateSpecs() {
   // fetch IDs of openapi specs via readme API
   const res = await fetch(
@@ -45,7 +60,7 @@ async function updateSpecs() {
   const outBase = path.resolve(__dirname, `out`);
   const filenames = fs
     .readdirSync(outBase)
-    .filter((fn) => fn.endsWith(`.json`));
+    .filter((fn) => fn.endsWith(`.yaml`));
 
   if (!remoteSpecMetas) {
     console.error(`!!! No remote specs found, please double check the API`);
@@ -57,7 +72,7 @@ async function updateSpecs() {
     const fullPath = path.join(outBase, specFile);
     const yamlStr = fs.readFileSync(fullPath, "utf8");
     const spec = YAML.parse(yamlStr);
-    const specMeta = remoteSpecMetas.data.find((m) => m.filename === specFile);
+    const specMeta = remoteSpecMetas.data.find((m) => getSlugFromJson(m.filename) === getSlugFromYaml(specFile));
     if (!specMeta) {
       console.log(`!!! No spec found for "${spec.info.title}". Please upload it as found in the developer.mixpanel.com runbook.`);
       continue;
@@ -66,8 +81,21 @@ async function updateSpecs() {
     // validate and publish spec
     console.log(`Updating ${spec.info.title} (${specFile}`);
     await execAndLog('npx', ['rdme', 'openapi:validate', fullPath]);
+    // this converts the file to json, since it does this step directly in readme anyway
+    await execAndLog(
+      'npx', ['rdme', 'openapi', 'convert', fullPath, `--out=openapi/out/${convertSlugToJson(specFile)}`], {env}
+    );
+    // publish the json version
     await execAndLog(
-      'npx', ['rdme', 'openapi', 'upload', fullPath, `--key=${README_API_KEY}`, `--slug=${specFile}`], {env}
+      'npx', [
+        'rdme',
+        'openapi',
+        'upload',
+        `${convertSlugToJson(fullPath)}`,
+        `--key=${README_API_KEY}`,
+        `--slug=${convertSlugToJson(specFile)}`,
+        `--confirm-overwrite`
+      ], {env}
     );
   }
 }