From ce3f9c2412339ea5b722d5967c68a9f847f95609 Mon Sep 17 00:00:00 2001
From: jpmarceau <39384459+jpmarceau@users.noreply.github.com>
Date: Thu, 13 Feb 2025 08:41:50 -0500
Subject: [PATCH] docs(headless-react): add strings stating the beta status of
 ssr commerce (#4960)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

https://coveord.atlassian.net/browse/DOC-16522

The `(Open Beta)` string will appear in titles for everything under `SSR
Commerce`.

![Screenshot 2025-02-12 at 9 32
43 AM](https://github.com/user-attachments/assets/8ae91295-7421-4f7f-a022-4c854e197563)
---
 packages/headless-react/README.md               |  2 +-
 .../headless-react/typedoc/COMMERCEREADME.md    |  4 ++--
 packages/headless-react/typedoc/lib/index.tsx   |  4 ++++
 .../typedoc/lib/insertBetaNote.ts               | 17 +++++++++++++++++
 4 files changed, 24 insertions(+), 3 deletions(-)
 create mode 100644 packages/headless-react/typedoc/lib/insertBetaNote.ts

diff --git a/packages/headless-react/README.md b/packages/headless-react/README.md
index 2414eacac9b..89eaf88d5b2 100644
--- a/packages/headless-react/README.md
+++ b/packages/headless-react/README.md
@@ -3,7 +3,7 @@
 `@coveo/headless-react` provides React utilities for server-side rendering with headless controllers. This package includes two sub-packages:
 
 - `@coveo/headless-react/ssr`: For general server-side rendering with headless controllers.
-- `@coveo/headless-react/ssr-commerce`: For implementing a commerce storefront with server-side rendering.
+- `@coveo/headless-react/ssr-commerce`: (Open Beta) For implementing a commerce storefront with server-side rendering.
 
 ## Learn more
 
diff --git a/packages/headless-react/typedoc/COMMERCEREADME.md b/packages/headless-react/typedoc/COMMERCEREADME.md
index 7d043d19f28..db9e3c61fe2 100644
--- a/packages/headless-react/typedoc/COMMERCEREADME.md
+++ b/packages/headless-react/typedoc/COMMERCEREADME.md
@@ -1,6 +1,6 @@
-# Headless React Utils for SSR
+# Headless React Utils for SSR (Open Beta)
 
-`@coveo/headless-react/ssr-commerce` provides React utilities for server-side rendering with Headless Commerce controllers.
+`@coveo/headless-react/ssr-commerce` is currently in Open Beta and provides React utilities for server-side rendering with Headless Commerce controllers.
 
 ## Learn more
 
diff --git a/packages/headless-react/typedoc/lib/index.tsx b/packages/headless-react/typedoc/lib/index.tsx
index 2c2a2b2b9d0..e6ff99a2818 100644
--- a/packages/headless-react/typedoc/lib/index.tsx
+++ b/packages/headless-react/typedoc/lib/index.tsx
@@ -5,6 +5,7 @@ import {fileURLToPath} from 'node:url';
 // eslint-disable-next-line n/no-unpublished-import
 import {Application, JSX, RendererEvent, Converter} from 'typedoc';
 import {insertAtomicSearchBox} from './insertAtomicSearchBox.js';
+import {insertBetaNote} from './insertBetaNote.js';
 import {insertCoveoLogo} from './insertCoveoLogo.js';
 import {insertCustomComments} from './insertCustomComments.js';
 import {insertOneTrust} from './insertOneTrust.js';
@@ -39,6 +40,9 @@ export function load(app: Application) {
       <script>
         <JSX.Raw html={`(${insertOneTrust.toString()})();`} />
       </script>
+      <script>
+        <JSX.Raw html={`(${insertBetaNote.toString()})();`} />
+      </script>
       <script>
         <JSX.Raw
           html={`(${insertCoveoLogo.toString()})('${event.relativeURL('assets/coveo-docs-logo.svg')}');`}
diff --git a/packages/headless-react/typedoc/lib/insertBetaNote.ts b/packages/headless-react/typedoc/lib/insertBetaNote.ts
new file mode 100644
index 00000000000..85558ff3623
--- /dev/null
+++ b/packages/headless-react/typedoc/lib/insertBetaNote.ts
@@ -0,0 +1,17 @@
+export function insertBetaNote() {
+  document.addEventListener('DOMContentLoaded', () => {
+    const breadcrumbs = document.querySelector('ul.tsd-breadcrumb');
+    if (breadcrumbs) {
+      const IsSSRCommercePage = Array.from(
+        breadcrumbs.querySelectorAll('a')
+      ).find((link) => link.textContent?.trim() === 'SSR Commerce');
+
+      if (IsSSRCommercePage) {
+        const h1Element = document.querySelector('h1');
+        if (h1Element) {
+          h1Element.textContent += ' (Open Beta)';
+        }
+      }
+    }
+  });
+}