@redpanda-data/docs-extensions-and-macros 4.14.0 → 4.14.1

package/extensions/generate-rp-connect-info.js

@@ -216,7 +216,15 @@ module.exports.register = function ({ config }) {
 
       // Warn about missing docs (but not for deprecated or SQL drivers)
       if (deprecated !== 'y' && !connector.includes('sql_driver')) {
-        if (!redpandaConnectUrl) {
+        // Check if this is a cloud-only connector (plugin)
+        // Cloud-only connectors (like 'gateway' and 'a2a_message') are plugins that:
+        // - Only run in Redpanda Cloud (not in self-managed rpk connect)
+        // - Have docs in cloud-docs repo but not in rp-connect-docs pages
+        // - Are marked with cloud: y in CSV but don't ship with OSS binary
+        const isCloudOnly = isCloudSupported === 'y' && !redpandaConnectUrl && redpandaCloudUrl
+
+        // Only warn about missing self-managed docs if it's NOT cloud-only
+        if (!redpandaConnectUrl && !isCloudOnly) {
           logger.warn(`Self-Managed docs missing for: ${connector} of type: ${type}`)
         }
         if (isCloudSupported === 'y' && !redpandaCloudUrl && redpandaConnectUrl) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@redpanda-data/docs-extensions-and-macros",
-  "version": "4.14.0",
+  "version": "4.14.1",
   "description": "Antora extensions and macros developed for Redpanda documentation.",
   "keywords": [
     "antora",
@@ -122,7 +122,7 @@
     "tree-sitter": "^0.22.4",
     "turndown": "^7.2.2",
     "turndown-plugin-gfm": "^1.0.2",
-    "yaml": "^2.7.1",
+    "yaml": "^2.8.2",
     "yargs": "^17.7.2"
   },
   "devDependencies": {

package/tools/redpanda-connect/helpers/renderConnectFields.js

@@ -105,7 +105,7 @@ module.exports = function renderConnectFields(children, prefix = '') {
       // Complex object/array
       else if (typeof child.default === 'object') {
         const defYaml = yaml.stringify(child.default, {
-          defaultStringType: 'PLAIN',
+          defaultStringType: 'QUOTE_DOUBLE',
           defaultKeyType: 'PLAIN',
           lineWidth: 0,
           simpleKeys: false

package/tools/redpanda-connect/helpers/renderLeafField.js

@@ -50,7 +50,7 @@ module.exports = function renderLeafField(field, indentLevel) {
       try {
         // Force block style for all arrays and nested structures
         const rawYaml = yaml.stringify(field.default, {
-          defaultStringType: 'PLAIN',
+          defaultStringType: 'QUOTE_DOUBLE',
           defaultKeyType: 'PLAIN',
           lineWidth: 0,  // Disable line wrapping to prevent flow style
           simpleKeys: false

package/tools/redpanda-connect/helpers/toYaml.js

@@ -8,7 +8,7 @@ const yaml = require('yaml');
  */
 module.exports = function toYaml(obj) {
   return yaml.stringify(obj, {
-    defaultStringType: 'PLAIN',
+    defaultStringType: 'QUOTE_DOUBLE',
     defaultKeyType: 'PLAIN',
     lineWidth: 0,  // Disable line wrapping to prevent flow style
     simpleKeys: false