From 70481539c0c670062732f33dd57e316be6fee67d Mon Sep 17 00:00:00 2001
From: Jason Stirnaman <jstirnaman@influxdata.com>
Date: Mon, 16 Mar 2026 13:19:26 -0500
Subject: [PATCH] fix(api-docs): auto-generate API content before Cypress tests

The API reference tests require generated content pages that are
gitignored. Add a before() hook that detects missing content and
runs the generation pipeline, then waits for Hugo to rebuild.
---
 cypress/e2e/content/api-reference.cy.js | 29 +++++++++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/cypress/e2e/content/api-reference.cy.js b/cypress/e2e/content/api-reference.cy.js
index 33313938b..318684d91 100644
--- a/cypress/e2e/content/api-reference.cy.js
+++ b/cypress/e2e/content/api-reference.cy.js
@@ -9,10 +9,39 @@
  * 3. Hugo-native tag page rendering
  * 4. Related links from OpenAPI x-related → frontmatter → rendered HTML
  *
+ * Prerequisites:
+ * - Hugo server running (started automatically by the test runner)
+ * - API docs generated (auto-generated if missing)
+ *
  * Run with:
  * node cypress/support/run-e2e-specs.js --spec "cypress/e2e/content/api-reference.cy.js" content/influxdb3/core/reference/api/_index.md
  */
 
+// Sentinel file: if this exists, API docs have been generated.
+const SENTINEL = 'content/influxdb3/core/api/write-data/_index.md';
+
+before(() => {
+  cy.task('readFile', SENTINEL).then((content) => {
+    if (content) return; // Already generated
+
+    cy.log('**API content not found — generating from OpenAPI specs…**');
+
+    // Step 1: post-process specs (apply tag configs + overlays → _build/)
+    cy.exec('node api-docs/scripts/dist/post-process-specs.js', {
+      timeout: 30000,
+    });
+
+    // Step 2: generate Hugo content pages + article data
+    cy.exec(
+      'node api-docs/scripts/dist/generate-openapi-articles.js --skip-fetch',
+      { timeout: 120000 }
+    );
+
+    // Wait for Hugo to rebuild after new files appear
+    cy.request({ url: '/influxdb3/core/api/write-data/', retryOnStatusCodeFailure: true, timeout: 60000 });
+  });
+});
+
 describe('API reference content', () => {
   // API section index pages (generated from article data)
   const subjects = [