@redpanda-data/docs-extensions-and-macros 4.9.1 → 4.10.1

package/bin/doc-tools.js

@@ -2,7 +2,7 @@
 
 const { execSync, spawnSync } = require('child_process');
 const os = require('os');
-const { Command } = require('commander');
+const { Command, Option } = require('commander');
 const path = require('path');
 const yaml = require('yaml');
 const fs = require('fs');
@@ -1111,6 +1111,8 @@ automation
       } else {
         env.OUTPUT_JSON_DIR = path.resolve(outputDir, 'examples');
         env.OUTPUT_AUTOGENERATED_DIR = path.resolve(outputDir);
+        // Set property files to go to properties subdirectory
+        env.OUTPUT_ASCIIDOC_DIR = path.resolve(outputDir, 'pages', 'properties');
       }
       
       const r = spawnSync('make', args, { cwd, stdio: 'inherit', env });
@@ -1540,5 +1542,47 @@ automation
     }
   });
 
+automation
+  .command('bundle-openapi')
+  .description('Bundle Redpanda OpenAPI fragments for admin and connect APIs into complete OpenAPI 3.1 documents')
+  .requiredOption('-t, --tag <tag>', 'Git tag to check out (e.g., v24.3.2 or 24.3.2 or dev)')
+  .option('--repo <url>', 'Repository URL', 'https://github.com/redpanda-data/redpanda.git')
+  .addOption(new Option('-s, --surface <surface>', 'Which API surface(s) to bundle').choices(['admin', 'connect', 'both']).makeOptionMandatory())
+  .option('--out-admin <path>', 'Output path for admin API', 'admin/redpanda-admin-api.yaml')
+  .option('--out-connect <path>', 'Output path for connect API', 'connect/redpanda-connect-api.yaml')
+  .option('--admin-major <string>', 'Admin API major version', 'v2.0.0')
+  .option('--use-admin-major-version', 'Use admin major version for info.version instead of git tag', false)
+  .option('--quiet', 'Suppress logs', false)
+  .action(async (options) => {
+    // Verify dependencies
+    requireCmd('git', 'Install Git: https://git-scm.com/downloads');
+    requireCmd('buf', 'buf should be automatically available after npm install');
+    
+    // Check for OpenAPI bundler using the existing detectBundler function
+    try {
+      const { detectBundler } = require('../tools/bundle-openapi.js');
+      detectBundler(true); // quiet mode to avoid duplicate output
+    } catch (err) {
+      fail(err.message);
+    }
+
+    try {
+      const { bundleOpenAPI } = require('../tools/bundle-openapi.js');
+      await bundleOpenAPI({
+        tag: options.tag,
+        repo: options.repo,
+        surface: options.surface,
+        outAdmin: options.outAdmin,
+        outConnect: options.outConnect,
+        adminMajor: options.adminMajor,
+        useAdminMajorVersion: options.useAdminMajorVersion,
+        quiet: options.quiet
+      });
+    } catch (err) {
+      console.error(`❌ ${err.message}`);
+      process.exit(err.message.includes('Validation failed') ? 2 : 1);
+    }
+  });
+
 programCli.addCommand(automation);
 programCli.parse(process.argv);