@redpanda-data/docs-extensions-and-macros 5.7.0 → 5.7.1

package/extensions/add-faq-structured-data.js

@@ -1,5 +1,7 @@
 'use strict'
 
+const { raiseListenerLimit } = require('./util/raise-listener-limit')
+
 /**
  * Generates FAQPage JSON-LD structured data for SEO.
  *
@@ -147,6 +149,7 @@ function generateFaqJsonLd(faqs, baseUrl) {
 }
 
 module.exports.register = function () {
+  raiseListenerLimit(this)
   const logger = this.getLogger('add-faq-structured-data-extension')
   let playbook
 

package/extensions/add-git-dates.js

@@ -1,5 +1,7 @@
 'use strict'
 
+const { raiseListenerLimit } = require('./util/raise-listener-limit')
+
 /**
  * Adds Git commit dates to pages as attributes.
  *
@@ -179,6 +181,7 @@ async function getTreeFiles (git, gitdir, oid, prefix, cache, treeCache) {
 }
 
 module.exports.register = function () {
+  raiseListenerLimit(this)
   const logger = this.getLogger('add-git-dates-extension')
   const context = this
 

package/extensions/add-global-attributes.js

@@ -1,3 +1,4 @@
+const { raiseListenerLimit } = require('./util/raise-listener-limit')
 /* Example use in the playbook
 * antora:
     extensions:
@@ -12,6 +13,7 @@ const _ = require('lodash');
 const ATTRIBUTES_PATH = 'modules/ROOT/partials/';  // Default path within the 'shared' component
 
 module.exports.register = function ({ config }) {
+  raiseListenerLimit(this)
   const logger = this.getLogger('global-attributes-extension');
 
   /**

package/extensions/add-llms-directive.js

@@ -1,5 +1,7 @@
 'use strict'
 
+const { raiseListenerLimit } = require('./util/raise-listener-limit')
+
 /**
  * Adds llms.txt directive to HTML pages for agent-friendly documentation.
  *
@@ -16,6 +18,7 @@
 const { formatLlmsDirective } = require('../extension-utils/llms-utils')
 
 module.exports.register = function () {
+  raiseListenerLimit(this)
   const logger = this.getLogger('add-llms-directive-extension')
 
   this.on('pagesComposed', ({ contentCatalog }) => {

package/extensions/add-markdown-urls-to-sitemap.js

@@ -1,5 +1,7 @@
 'use strict'
 
+const { raiseListenerLimit } = require('./util/raise-listener-limit')
+
 /**
  * Adds markdown URL entries to sitemap.xml files for AI-friendly documentation.
  *
@@ -21,6 +23,7 @@ const { parseStringPromise } = require('xml2js')
 const { toMarkdownUrl } = require('../extension-utils/url-utils')
 
 module.exports.register = function () {
+  raiseListenerLimit(this)
   const logger = this.getLogger('add-markdown-urls-to-sitemap-extension')
 
   this.on('beforePublish', async ({ siteCatalog }) => {

package/extensions/add-pages-to-root.js

@@ -1,4 +1,6 @@
+const { raiseListenerLimit } = require('./util/raise-listener-limit')
 module.exports.register = function ({ config }) {
+  raiseListenerLimit(this)
   this.on('beforePublish', ({ siteCatalog, contentCatalog }) => {
     const logger = this.getLogger('add-pages-to-site-root');
     if (!config || !config.files || !config.files.length) {

package/extensions/aggregate-terms.js

@@ -1,3 +1,4 @@
+const { raiseListenerLimit } = require('./util/raise-listener-limit')
 /* Example use in the playbook
 * antora:
     extensions:
@@ -10,6 +11,7 @@ const path = require('path');
 const TERMS_PATH = 'modules/terms/partials/';  // Default path within the 'shared' component
 
 module.exports.register = function ({ config }) {
+  raiseListenerLimit(this)
   const logger = this.getLogger('term-aggregation-extension');
 
   /**

package/extensions/algolia-indexer/index.js

@@ -1,6 +1,7 @@
 'use strict'
 
 const generateIndex = require('./generate-index')
+const { raiseListenerLimit } = require('../util/raise-listener-limit')
 const algoliasearch = require('algoliasearch')
 const http = require('http')
 const https = require('https')
@@ -21,6 +22,7 @@ function register ({
     ...unknownOptions
   }
 }) {
+  raiseListenerLimit(this)
   const logger = this.getLogger('algolia-indexer-extension')
 
   // Validate required environment variables

package/extensions/archive-attachments.js

@@ -1,3 +1,4 @@
+const { raiseListenerLimit } = require('./util/raise-listener-limit')
 "use strict";
 
 const fs = require("fs");
@@ -35,6 +36,7 @@ async function createTarInMemory(tempDir) {
 }
 
 module.exports.register = function ({ config }) {
+  raiseListenerLimit(this)
   const logger = this.getLogger("archive-attachments-extension");
   const archives = config.data?.archives || [];
 

package/extensions/collect-bloblang-samples.js

@@ -1,6 +1,8 @@
+const { raiseListenerLimit } = require('./util/raise-listener-limit')
 const yaml = require('js-yaml');
 
 module.exports.register = function () {
+  raiseListenerLimit(this)
   const logger = this.getLogger('collect-bloblang-samples');
 
   this.on('contentClassified', ({ contentCatalog }) => {

package/extensions/compute-end-of-life.js

@@ -1,8 +1,11 @@
 'use strict';
 
+const { raiseListenerLimit } = require('./util/raise-listener-limit')
+
 const calculateEOL = require('./util/calculate-eol.js');
 
 module.exports.register = function ({ config }) {
+  raiseListenerLimit(this)
   this.on('contentClassified', ({ contentCatalog }) => {
     const logger = this.getLogger("compute-end-of-life-extension");
 

package/extensions/conditional-home-redirect.js

@@ -8,7 +8,10 @@
 
 'use strict'
 
+const { raiseListenerLimit } = require('./util/raise-listener-limit')
+
 module.exports.register = function () {
+  raiseListenerLimit(this)
   const logger = this.getLogger('conditional-home-redirect')
   let shouldRedirect = false
 

package/extensions/convert-llms-to-txt.js

@@ -1,5 +1,7 @@
 'use strict';
 
+const { raiseListenerLimit } = require('./util/raise-listener-limit')
+
 const { toMarkdownUrl } = require('../extension-utils/url-utils');
 const { stripMarkdownMetadata } = require('../extension-utils/llms-utils');
 
@@ -20,6 +22,7 @@ const { stripMarkdownMetadata } = require('../extension-utils/llms-utils');
  * Must run after convert-to-markdown extension to access page.markdownContents.
  */
 module.exports.register = function () {
+  raiseListenerLimit(this)
   const logger = this.getLogger('convert-llms-to-txt-extension');
   let siteUrl = '';
 

package/extensions/convert-to-markdown.js

@@ -1,3 +1,4 @@
+const { raiseListenerLimit } = require('./util/raise-listener-limit')
 const path = require('path')
 const os = require('os')
 const yaml = require('js-yaml')
@@ -187,6 +188,7 @@ function generateFrontmatter(page) {
 }
 
 module.exports.register = function () {
+  raiseListenerLimit(this)
   const logger = this.getLogger('convert-to-markdown-extension')
   let playbook
 

package/extensions/find-related-docs.js

@@ -1,6 +1,9 @@
 'use strict';
 
+const { raiseListenerLimit } = require('./util/raise-listener-limit')
+
 module.exports.register = function ({ config }) {
+  raiseListenerLimit(this)
   const logger = this.getLogger('related-docs-extension');
 
   this.on('documentsConverted', async ({ contentCatalog, siteCatalog }) => {

package/extensions/find-related-labs.js

@@ -1,6 +1,9 @@
 'use strict';
 
+const { raiseListenerLimit } = require('./util/raise-listener-limit')
+
 module.exports.register = function ({ config }) {
+  raiseListenerLimit(this)
   const logger = this.getLogger('related-labs-extension');
 
   this.on('documentsConverted', async ({ contentCatalog, siteCatalog }) => {

package/extensions/generate-fields-only-pages.js

@@ -1,5 +1,7 @@
 'use strict'
 
+const { raiseListenerLimit } = require('./util/raise-listener-limit')
+
 const fs = require('fs')
 const path = require('path')
 const os = require('os')
@@ -121,6 +123,7 @@ const DEFAULTS = {
 }
 
 module.exports.register = function ({ config }) {
+  raiseListenerLimit(this)
   const logger = this.getLogger('generate-fields-only-pages-extension')
 
   // Merge config with defaults

package/extensions/generate-index-data.js

@@ -1,7 +1,10 @@
 'use strict';
+
+const { raiseListenerLimit } = require('./util/raise-listener-limit')
 const _ = require('lodash');
 
 module.exports.register = function ({ config }) {
+  raiseListenerLimit(this)
   const logger = this.getLogger('generate-index-data-extension');
 
   this.on('documentsConverted', async ({ contentCatalog, siteCatalog }) => {

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

@@ -1,5 +1,7 @@
 'use strict'
 
+const { raiseListenerLimit } = require('./util/raise-listener-limit')
+
 /**
  * Redpanda Connect Category Aggregation Extension
  *
@@ -11,6 +13,7 @@
  * Ensure generate-rp-connect-info is listed BEFORE this extension in your playbook.
  */
 module.exports.register = function ({ config }) {
+  raiseListenerLimit(this)
   const logger = this.getLogger('redpanda-connect-category-aggregation-extension')
 
   this.on('contentClassified', ({ contentCatalog }) => {

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

@@ -1,4 +1,6 @@
 'use strict'
+
+const { raiseListenerLimit } = require('./util/raise-listener-limit')
 const fs = require('fs')
 const path = require('path')
 const Papa = require('papaparse')
@@ -11,6 +13,7 @@ const DEFAULTS = {
 }
 
 module.exports.register = function ({ config }) {
+  raiseListenerLimit(this)
   const logger = this.getLogger('redpanda-connect-info-extension')
   const { getAntoraValue } = require('../cli-utils/antora-utils')
 

package/extensions/git-full-clone.js

@@ -1,5 +1,7 @@
 'use strict'
 
+const { raiseListenerLimit } = require('./util/raise-listener-limit')
+
 const { execSync } = require('child_process')
 const fs = require('fs')
 const path = require('path')
@@ -33,6 +35,7 @@ const { getGitHubToken } = require('../cli-utils/github-token')
  */
 
 module.exports.register = function ({ config, playbook }) {
+  raiseListenerLimit(this)
   const logger = this.getLogger('git-full-clone-extension')
 
   logger.info('✓ git-full-clone extension loaded')

package/extensions/modify-connect-tag-playbook.js

@@ -1,8 +1,11 @@
 'use strict';
 
+const { raiseListenerLimit } = require('./util/raise-listener-limit')
+
 const GetLatestConnectTag = require('./version-fetcher/get-latest-connect');
 
 module.exports.register = function ({ config }) {
+  raiseListenerLimit(this)
   const logger = this.getLogger('modify-connect-tag-playbook-extension');
 
   this.on('contextStarted', async ({ playbook }) => {

package/extensions/process-context-switcher.js

@@ -17,7 +17,10 @@
 
 'use strict';
 
+const { raiseListenerLimit } = require('./util/raise-listener-limit')
+
 module.exports.register = function ({ config }) {
+  raiseListenerLimit(this)
   const logger = this.getLogger('context-switcher-extension');
 
   this.on('documentsConverted', async ({ contentCatalog }) => {

package/extensions/produce-redirects.js

@@ -1,11 +1,14 @@
 'use strict';
 
+const { raiseListenerLimit } = require('./util/raise-listener-limit')
+
 const File = require('vinyl')
 const { posix: path } = require('path')
 
 const ENCODED_SPACE_RX = /%20/g
 
 module.exports.register = function () {
+  raiseListenerLimit(this)
   this.once('contextStarted', () => {
     const { publishFiles: produceRedirectsDelegate } = this.getFunctions()
     this.replaceFunctions({

package/extensions/replace-attributes-in-attachments.js

@@ -1,5 +1,7 @@
 'use strict';
 
+const { raiseListenerLimit } = require('./util/raise-listener-limit')
+
 const semver = require('semver');
 const micromatch = require('micromatch');
 const formatVersion = require('./util/format-version.js');
@@ -24,6 +26,7 @@ const sanitize = require('./util/sanitize-attributes.js');
  *         - ...
  */
 module.exports.register = function ({ config }) {
+  raiseListenerLimit(this)
   const logger = this.getLogger('replace-attributes-extension');
   const replacements = config.data?.replacements || [];
 

package/extensions/resolve-xrefs-in-attachments.js

@@ -1,5 +1,7 @@
 'use strict'
 
+const { raiseListenerLimit } = require('./util/raise-listener-limit')
+
 /**
  * Resolves AsciiDoc xrefs in JSON attachment files to HTML links.
  *
@@ -19,6 +21,7 @@
  */
 
 module.exports.register = function () {
+  raiseListenerLimit(this)
   const logger = this.getLogger('resolve-xrefs-in-attachments')
 
   this.on('contentClassified', ({ contentCatalog }) => {

package/extensions/set-available-attachment-versions.js

@@ -1,5 +1,7 @@
 'use strict'
 
+const { raiseListenerLimit } = require('./util/raise-listener-limit')
+
 const semver = require('semver')
 
 /**
@@ -34,6 +36,7 @@ const PROPERTIES_JSON_RX = /^redpanda-properties-(v\d+\.\d+\.\d+(?:-[\w.]+)?)\.j
 const CONNECT_JSON_RX = /^connect-(\d+\.\d+\.\d+(?:-[\w.]+)?)\.json$/
 
 module.exports.register = function () {
+  raiseListenerLimit(this)
   const logger = this.getLogger('set-available-attachment-versions-extension')
 
   this.once('contentClassified', ({ contentCatalog }) => {

package/extensions/unified-navigation.js

@@ -1,5 +1,7 @@
 'use strict'
 
+const { raiseListenerLimit } = require('./util/raise-listener-limit')
+
 const yaml = require('js-yaml')
 
 /**
@@ -35,6 +37,7 @@ const yaml = require('js-yaml')
  */
 
 module.exports.register = function () {
+  raiseListenerLimit(this)
   const logger = this.getLogger('unified-navigation-extension')
 
   this.on('navigationBuilt', ({ contentCatalog }) => {

package/extensions/unlisted-pages.js

@@ -1,6 +1,9 @@
 'use strict';
 
+const { raiseListenerLimit } = require('./util/raise-listener-limit')
+
 module.exports.register = function ({ config }) {
+  raiseListenerLimit(this)
   const { addToNavigation, unlistedPagesHeading = 'Unlisted Pages' } = config;
   const logger = this.getLogger('unlisted-pages-extension');
 

package/extensions/unpublish-pages.js

@@ -1,6 +1,9 @@
 'use strict';
 
+const { raiseListenerLimit } = require('./util/raise-listener-limit')
+
 module.exports.register = function () {
+  raiseListenerLimit(this)
   const logger = this.getLogger('unpublish-pages-extension');
 
   this.on('documentsConverted', ({ siteCatalog, contentCatalog }) => {

package/extensions/util/raise-listener-limit.js

@@ -0,0 +1,28 @@
+'use strict'
+
+// Antora's GeneratorContext is one shared EventEmitter for every registered
+// extension, and Redpanda playbooks register enough of them that per-event
+// listener counts legitimately exceed Node's default threshold of 10. Node
+// then prints MaxListenersExceededWarning ("Possible EventEmitter memory
+// leak detected. 11 contentClassified listeners added to [GeneratorContext]")
+// in build logs even though each extension adds exactly one listener per
+// event per build.
+//
+// Every extension in this package raises the limit before subscribing, so
+// the suppression holds no matter which subset of extensions a playbook
+// registers or in what order. The cap is bounded rather than unlimited (0)
+// to keep Node's leak detection meaningful for pathological cases.
+const GENERATOR_CONTEXT_MAX_LISTENERS = 64
+
+function raiseListenerLimit (context) {
+  if (
+    typeof context.getMaxListeners === 'function' &&
+    typeof context.setMaxListeners === 'function' &&
+    context.getMaxListeners() !== 0 &&
+    context.getMaxListeners() < GENERATOR_CONTEXT_MAX_LISTENERS
+  ) {
+    context.setMaxListeners(GENERATOR_CONTEXT_MAX_LISTENERS)
+  }
+}
+
+module.exports = { raiseListenerLimit, GENERATOR_CONTEXT_MAX_LISTENERS }

package/extensions/validate-attributes.js

@@ -6,7 +6,10 @@
 
 'use strict';
 
+const { raiseListenerLimit } = require('./util/raise-listener-limit')
+
 module.exports.register = function ({ config }) {
+  raiseListenerLimit(this)
   const logger = this.getLogger('attribute-validation-extension');
 
   this.on('documentsConverted', async ({ contentCatalog, siteCatalog }) => {

package/extensions/version-fetcher/set-latest-version.js

@@ -1,6 +1,9 @@
 'use strict';
 
+const { raiseListenerLimit } = require('../util/raise-listener-limit')
+
 module.exports.register = function ({ config }) {
+  raiseListenerLimit(this)
   const GetLatestRedpandaVersion = require('./get-latest-redpanda-version');
   const GetLatestConsoleVersion = require('./get-latest-console-version');
   const GetLatestDockerTag = require('./fetch-latest-docker-tag');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@redpanda-data/docs-extensions-and-macros",
-  "version": "5.7.0",
+  "version": "5.7.1",
   "description": "Antora extensions and macros developed for Redpanda documentation.",
   "keywords": [
     "antora",