@eventcatalog/core 3.5.2 → 3.6.0

package/dist/analytics/analytics.cjs

@@ -37,7 +37,7 @@ var import_axios = __toESM(require("axios"), 1);
 var import_os = __toESM(require("os"), 1);
 
 // package.json
-var version = "3.5.2";
+var version = "3.6.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/analytics.js

@@ -1,7 +1,7 @@
 import {
   raiseEvent
-} from "../chunk-WO3AKJVB.js";
-import "../chunk-YOFNY2RC.js";
+} from "../chunk-XTN3M6CM.js";
+import "../chunk-YQ2LO4G6.js";
 export {
   raiseEvent
 };

package/dist/analytics/log-build.cjs

@@ -106,7 +106,7 @@ var import_axios = __toESM(require("axios"), 1);
 var import_os = __toESM(require("os"), 1);
 
 // package.json
-var version = "3.5.2";
+var version = "3.6.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/log-build.js

@@ -1,8 +1,8 @@
 import {
   log_build_default
-} from "../chunk-YTZSPYJN.js";
-import "../chunk-WO3AKJVB.js";
-import "../chunk-YOFNY2RC.js";
+} from "../chunk-O3LNFOFS.js";
+import "../chunk-XTN3M6CM.js";
+import "../chunk-YQ2LO4G6.js";
 import "../chunk-UPONRQSN.js";
 export {
   log_build_default as default

package/dist/{chunk-OKWCSRLE.js → chunk-2DSMO5BZ.js}

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-YOFNY2RC.js";
+} from "./chunk-YQ2LO4G6.js";
 
 // src/utils/cli-logger.ts
 import pc from "picocolors";

package/dist/{chunk-YTZSPYJN.js → chunk-O3LNFOFS.js}

@@ -1,6 +1,6 @@
 import {
   raiseEvent
-} from "./chunk-WO3AKJVB.js";
+} from "./chunk-XTN3M6CM.js";
 import {
   getEventCatalogConfigFile,
   verifyRequiredFieldsAreInCatalogConfigFile

package/dist/{chunk-YVX5C6L3.js → chunk-O7ZZX4CS.js}

@@ -1,6 +1,6 @@
 import {
   logger
-} from "./chunk-OKWCSRLE.js";
+} from "./chunk-2DSMO5BZ.js";
 import {
   cleanup,
   getEventCatalogConfigFile

package/dist/{chunk-WO3AKJVB.js → chunk-XTN3M6CM.js}

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-YOFNY2RC.js";
+} from "./chunk-YQ2LO4G6.js";
 
 // src/analytics/analytics.js
 import axios from "axios";

package/dist/{chunk-YOFNY2RC.js → chunk-YQ2LO4G6.js}

@@ -1,5 +1,5 @@
 // package.json
-var version = "3.5.2";
+var version = "3.6.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/constants.cjs

@@ -25,7 +25,7 @@ __export(constants_exports, {
 module.exports = __toCommonJS(constants_exports);
 
 // package.json
-var version = "3.5.2";
+var version = "3.6.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/constants.js

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-YOFNY2RC.js";
+} from "./chunk-YQ2LO4G6.js";
 export {
   VERSION
 };

package/dist/eventcatalog.cjs

@@ -109,7 +109,7 @@ var verifyRequiredFieldsAreInCatalogConfigFile = async (projectDirectory) => {
 var import_picocolors = __toESM(require("picocolors"), 1);
 
 // package.json
-var version = "3.5.2";
+var version = "3.6.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/eventcatalog.js

@@ -6,8 +6,8 @@ import {
 } from "./chunk-PLNJC7NZ.js";
 import {
   log_build_default
-} from "./chunk-YTZSPYJN.js";
-import "./chunk-WO3AKJVB.js";
+} from "./chunk-O3LNFOFS.js";
+import "./chunk-XTN3M6CM.js";
 import {
   runMigrations
 } from "./chunk-BH3JMNAV.js";
@@ -21,13 +21,13 @@ import {
 } from "./chunk-5VBIXL6C.js";
 import {
   generate
-} from "./chunk-YVX5C6L3.js";
+} from "./chunk-O7ZZX4CS.js";
 import {
   logger
-} from "./chunk-OKWCSRLE.js";
+} from "./chunk-2DSMO5BZ.js";
 import {
   VERSION
-} from "./chunk-YOFNY2RC.js";
+} from "./chunk-YQ2LO4G6.js";
 import "./chunk-UPONRQSN.js";
 
 // src/eventcatalog.ts

package/dist/generate.cjs

@@ -73,7 +73,7 @@ var getEventCatalogConfigFile = async (projectDirectory) => {
 var import_picocolors = __toESM(require("picocolors"), 1);
 
 // package.json
-var version = "3.5.2";
+var version = "3.6.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/generate.js

@@ -1,8 +1,8 @@
 import {
   generate
-} from "./chunk-YVX5C6L3.js";
-import "./chunk-OKWCSRLE.js";
-import "./chunk-YOFNY2RC.js";
+} from "./chunk-O7ZZX4CS.js";
+import "./chunk-2DSMO5BZ.js";
+import "./chunk-YQ2LO4G6.js";
 import "./chunk-UPONRQSN.js";
 export {
   generate

package/dist/utils/cli-logger.cjs

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(cli_logger_exports);
 var import_picocolors = __toESM(require("picocolors"), 1);
 
 // package.json
-var version = "3.5.2";
+var version = "3.6.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/utils/cli-logger.js

@@ -1,7 +1,7 @@
 import {
   logger
-} from "../chunk-OKWCSRLE.js";
-import "../chunk-YOFNY2RC.js";
+} from "../chunk-2DSMO5BZ.js";
+import "../chunk-YQ2LO4G6.js";
 export {
   logger
 };

package/eventcatalog/src/components/EnvironmentDropdown.tsx

@@ -86,7 +86,7 @@ export const EnvironmentDropdown: React.FC<EnvironmentDropdownProps> = ({ enviro
         </svg>
       </button>
       <div
-        className={`${isOpen ? '' : 'hidden'} absolute right-0 mt-2 w-64 bg-[rgb(var(--ec-dropdown-bg))] rounded-md shadow-lg py-1 z-50 border border-[rgb(var(--ec-dropdown-border))] overflow-hidden z-20`}
+        className={`${isOpen ? '' : 'hidden'} absolute right-0 mt-2 w-64 bg-[rgb(var(--ec-dropdown-bg))] rounded-md shadow-lg py-1 border border-[rgb(var(--ec-dropdown-border))] overflow-hidden z-[100]`}
       >
         {environments.map((env) => {
           const isCurrentEnv = currentEnvironment?.name === env.name;

package/eventcatalog/src/components/Search/SearchDataLoader.astro

@@ -5,21 +5,33 @@
  * This component loads the sidebar/search data independently of the sidebar UI.
  * It ensures the search functionality works on all pages, even when the nested
  * sidebar is not rendered (e.g., /discover pages).
+ *
+ * The data is fetched from a static JSON file (/api/sidebar-data.json) instead of
+ * being embedded inline in every HTML page. This significantly reduces build size
+ * for large catalogs.
  */
-import { getNestedSideBarData } from '@stores/sidebar-store/state';
-
-const props = await getNestedSideBarData();
 ---
 
-<script is:inline define:vars={{ props }}>
-  window.sidebarData = props;
-</script>
-
 <script>
-  import { setSidebarData } from '@stores/sidebar-store';
+  import { setSidebarData, sidebarStore } from '@stores/sidebar-store';
+  import { buildUrl } from '@utils/url-builder';
+
+  // Only fetch if we haven't already loaded the data
+  if (!sidebarStore.get()) {
+    const apiUrl = buildUrl('/api/sidebar-data.json', true);
 
-  const data = (window as any).sidebarData;
-  if (data) {
-    setSidebarData(data);
+    fetch(apiUrl)
+      .then((response) => {
+        if (!response.ok) {
+          throw new Error(`Failed to fetch sidebar data: ${response.status}`);
+        }
+        return response.json();
+      })
+      .then((data) => {
+        setSidebarData(data);
+      })
+      .catch((error) => {
+        console.error('Error loading sidebar data:', error);
+      });
   }
 </script>

package/eventcatalog/src/components/Search/SearchModal.tsx

@@ -135,6 +135,9 @@ export default function SearchModal() {
     // Extract all items from nodes
     const allItems = Object.entries(data.nodes)
       .map(([key, node]) => {
+        // Skip reference entries (string values that point to other keys)
+        if (typeof node === 'string') return null;
+
         const url = getUrlForItem(node, key);
         if (!url) return null;
 
@@ -232,6 +235,18 @@ export default function SearchModal() {
     });
   };
 
+  // Helper to resolve a node, following references if needed
+  const resolveNode = (key: string) => {
+    if (!data?.nodes) return null;
+    const node = data.nodes[key];
+    if (!node) return null;
+    // If it's a string reference, follow it
+    if (typeof node === 'string') {
+      return data.nodes[node] as NavNode | undefined;
+    }
+    return node;
+  };
+
   const filteredItems = useMemo(() => {
     if (query === '') {
       // Show favorites when search is empty
@@ -239,8 +254,8 @@ export default function SearchModal() {
         return favorites
           .slice(0, 5)
           .map((fav) => {
-            const node = data?.nodes[fav.nodeKey];
-            if (!node) return null;
+            const node = resolveNode(fav.nodeKey);
+            if (!node || typeof node === 'string') return null;
             const url = getUrlForItem(node, fav.nodeKey);
             if (!url) return null;
 

package/eventcatalog/src/components/SideNav/NestedSideBar/SearchBar.tsx

@@ -29,7 +29,7 @@ type SearchResult = {
 };
 
 type Props = {
-  nodes: Record<string, NavNode>;
+  nodes: Record<string, NavNode | string>;
   onSelectResult: (nodeKey: string, node: NavNode) => void;
   onSearchChange?: (isSearching: boolean) => void;
 };
@@ -41,14 +41,20 @@ export default function SearchBar({ nodes, onSelectResult, onSearchChange }: Pro
 
   // Pre-process searchable nodes to avoid iterating object on every render
   // Filter out unversioned keys (e.g., "domain:OrderService") to avoid duplicates with versioned keys (e.g., "domain:OrderService:1.0.0")
-  const searchableNodes = useMemo(() => {
-    return Object.entries(nodes).filter(([key, node]) => {
-      if (node.type === 'group') return false;
+  const searchableNodes = useMemo((): Array<[string, NavNode]> => {
+    const result: Array<[string, NavNode]> = [];
+    for (const [key, node] of Object.entries(nodes)) {
+      // Skip string references (unversioned aliases that point to versioned keys)
+      if (typeof node === 'string') continue;
+      if (node.type === 'group') continue;
       // Only include versioned keys (those with 3+ parts like "type:id:version")
       // Unversioned keys (2 parts like "type:id") are aliases to latest version and would cause duplicates
       const keyParts = key.split(':');
-      return keyParts.length >= 3;
-    });
+      if (keyParts.length >= 3) {
+        result.push([key, node]);
+      }
+    }
+    return result;
   }, [nodes]);
 
   // Get available badges from nodes

package/eventcatalog/src/components/SideNav/NestedSideBar/index.tsx

@@ -50,10 +50,14 @@ export default function NestedSideBar() {
   const nodeLookup = useMemo(() => {
     const lookup = new Map<string, string>();
 
-    Object.keys(nodes).forEach((key) => {
+    Object.entries(nodes).forEach(([key, value]) => {
+      // Skip keys that are references (string values pointing to other keys)
+      // These are unversioned aliases like "domain:E-Commerce" -> "domain:E-Commerce:1.0.0"
+      if (typeof value === 'string') return;
+
       // Key formats:
       // - "type:id:version" (e.g., "service:OrdersService:0.0.3")
-      // - "type:id" (e.g., "service:OrdersService", "user:john", "team:backend")
+      // - "type:id" (e.g., "user:john", "team:backend") - non-versioned resources
       // - "list:name" (e.g., "list:domains") - skip these
       const parts = key.split(':');
 
@@ -124,11 +128,18 @@ export default function NestedSideBar() {
 
   /**
    * Resolve a child reference to a NavNode
+   * Handles both direct keys and string references (unversioned aliases pointing to versioned keys)
    */
   const resolveRef = useCallback(
     (ref: ChildRef): NavNode | null => {
       if (typeof ref === 'string') {
-        return nodes[ref] ?? null;
+        const node = nodes[ref];
+        if (!node) return null;
+        // If node is a string, it's a reference to another key (e.g., unversioned alias)
+        if (typeof node === 'string') {
+          return (nodes[node] as NavNode) ?? null;
+        }
+        return node;
       }
       return ref;
     },
@@ -151,7 +162,7 @@ export default function NestedSideBar() {
       const stack: NavigationLevel[] = [{ key: null, entries: roots, title: 'Documentation' }];
 
       for (const key of path) {
-        const node = nodes[key];
+        const node = resolveRef(key);
         if (node && node.pages) {
           stack.push({
             key,
@@ -167,7 +178,7 @@ export default function NestedSideBar() {
 
       return stack;
     },
-    [roots, nodes]
+    [roots, resolveRef]
   );
 
   /**
@@ -250,7 +261,7 @@ export default function NestedSideBar() {
    */
   const tryConnectStack = useCallback(
     (targetKey: string, currentStack: NavigationLevel[]): NavigationLevel[] | null => {
-      const targetNode = nodes[targetKey];
+      const targetNode = resolveRef(targetKey);
       if (!targetNode) return null;
 
       // 1. Check if we are already at this level (or above)
@@ -262,7 +273,7 @@ export default function NestedSideBar() {
 
       // 2. Check if it's a child of the current last level
       const lastLevel = currentStack[currentStack.length - 1];
-      const lastNode = lastLevel.key ? nodes[lastLevel.key] : null;
+      const lastNode = lastLevel.key ? resolveRef(lastLevel.key) : null;
 
       // If root level (key=null), we check against roots
       const parentChildren = lastLevel.key === null ? roots : lastNode?.pages;
@@ -289,7 +300,7 @@ export default function NestedSideBar() {
 
       return null;
     },
-    [nodes, roots]
+    [resolveRef, roots]
   );
 
   /**
@@ -308,7 +319,7 @@ export default function NestedSideBar() {
             return connectedStack;
           }
 
-          const foundNode = nodes[foundNodeKey];
+          const foundNode = resolveRef(foundNodeKey);
           if (foundNode && foundNode.pages && foundNode.pages.length > 0) {
             // Fallback: Flattened navigation
             return [
@@ -333,7 +344,7 @@ export default function NestedSideBar() {
       }
       return false;
     },
-    [findNodeKeyByUrl, tryConnectStack, nodes, roots]
+    [findNodeKeyByUrl, tryConnectStack, resolveRef, roots]
   );
 
   /**
@@ -374,7 +385,7 @@ export default function NestedSideBar() {
 
     // 2. If no valid stack from step 1, try just the target (flattened)
     if (!finalStack && targetKey) {
-      const targetNode = nodes[targetKey];
+      const targetNode = resolveRef(targetKey);
       if (targetNode && targetNode.pages && targetNode.pages.length > 0) {
         finalStack = [
           { key: null, entries: roots, title: 'Documentation' },
@@ -391,7 +402,7 @@ export default function NestedSideBar() {
     }
 
     setIsInitialized(true);
-  }, [data, roots, nodes, isInitialized, buildStackFromPath, findNodeKeyByUrl, tryConnectStack]);
+  }, [data, roots, isInitialized, buildStackFromPath, findNodeKeyByUrl, tryConnectStack, resolveRef]);
 
   /**
    * Save state whenever navigation changes
@@ -600,7 +611,7 @@ export default function NestedSideBar() {
    */
   const navigateToFavorite = (favorite: FavoriteItem) => {
     // If it has an href and no children, just navigate to the URL
-    const node = nodes[favorite.nodeKey];
+    const node = resolveRef(favorite.nodeKey);
     if (favorite.href && (!node?.pages || node.pages.length === 0)) {
       window.location.href = favorite.href;
       return;
@@ -1048,7 +1059,7 @@ export default function NestedSideBar() {
                 </div>
                 <div className="flex flex-col gap-0.5 border-l ml-3.5 border-amber-200">
                   {favorites.map((fav, index) => {
-                    const node = nodes[fav.nodeKey];
+                    const node = resolveRef(fav.nodeKey);
                     const isActive = fav.href && currentPath === fav.href;
 
                     return (