@eventcatalog/core 3.7.0 → 3.7.2

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.7.0";
+var version = "3.7.2";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/analytics.js

@@ -1,7 +1,7 @@
 import {
   raiseEvent
-} from "../chunk-6DINZHVK.js";
-import "../chunk-WFIM5UXN.js";
+} from "../chunk-GQZVIS3Z.js";
+import "../chunk-WAX3S32H.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.7.0";
+var version = "3.7.2";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/log-build.js

@@ -1,8 +1,8 @@
 import {
   log_build_default
-} from "../chunk-2CIYDOFG.js";
-import "../chunk-6DINZHVK.js";
-import "../chunk-WFIM5UXN.js";
+} from "../chunk-M7EPRGHR.js";
+import "../chunk-GQZVIS3Z.js";
+import "../chunk-WAX3S32H.js";
 import "../chunk-UPONRQSN.js";
 export {
   log_build_default as default

package/dist/{chunk-TWL75YK3.js → chunk-7CTNGTBB.js}

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

package/dist/{chunk-6DINZHVK.js → chunk-GQZVIS3Z.js}

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

package/dist/{chunk-2CIYDOFG.js → chunk-M7EPRGHR.js}

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

package/dist/{chunk-VA6OWAKW.js → chunk-O6SRHGZ7.js}

@@ -1,6 +1,6 @@
 import {
   logger
-} from "./chunk-TWL75YK3.js";
+} from "./chunk-7CTNGTBB.js";
 import {
   cleanup,
   getEventCatalogConfigFile

package/dist/{chunk-WFIM5UXN.js → chunk-WAX3S32H.js}

@@ -1,5 +1,5 @@
 // package.json
-var version = "3.7.0";
+var version = "3.7.2";
 
 // 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.7.0";
+var version = "3.7.2";
 
 // src/constants.ts
 var VERSION = version;

package/dist/constants.js

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-WFIM5UXN.js";
+} from "./chunk-WAX3S32H.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.7.0";
+var version = "3.7.2";
 
 // 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-2CIYDOFG.js";
-import "./chunk-6DINZHVK.js";
+} from "./chunk-M7EPRGHR.js";
+import "./chunk-GQZVIS3Z.js";
 import {
   runMigrations
 } from "./chunk-BH3JMNAV.js";
@@ -21,13 +21,13 @@ import {
 } from "./chunk-5VBIXL6C.js";
 import {
   generate
-} from "./chunk-VA6OWAKW.js";
+} from "./chunk-O6SRHGZ7.js";
 import {
   logger
-} from "./chunk-TWL75YK3.js";
+} from "./chunk-7CTNGTBB.js";
 import {
   VERSION
-} from "./chunk-WFIM5UXN.js";
+} from "./chunk-WAX3S32H.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.7.0";
+var version = "3.7.2";
 
 // src/constants.ts
 var VERSION = version;

package/dist/generate.js

@@ -1,8 +1,8 @@
 import {
   generate
-} from "./chunk-VA6OWAKW.js";
-import "./chunk-TWL75YK3.js";
-import "./chunk-WFIM5UXN.js";
+} from "./chunk-O6SRHGZ7.js";
+import "./chunk-7CTNGTBB.js";
+import "./chunk-WAX3S32H.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.7.0";
+var version = "3.7.2";
 
 // src/constants.ts
 var VERSION = version;

package/dist/utils/cli-logger.js

@@ -1,7 +1,7 @@
 import {
   logger
-} from "../chunk-TWL75YK3.js";
-import "../chunk-WFIM5UXN.js";
+} from "../chunk-7CTNGTBB.js";
+import "../chunk-WAX3S32H.js";
 export {
   logger
 };

package/eventcatalog/src/components/SchemaExplorer/JSONSchemaViewer.tsx

@@ -157,32 +157,32 @@ function processSchema(schema: any, rootSchema?: any): any {
     return mergeAllOfSchemas({ ...schema, processSchema: (s: any) => processSchema(s, root) });
   }
 
-  if (schema.oneOf) {
-    const processedVariants = schema.oneOf.map((variant: any) => {
+  if (schema.oneOf || schema.anyOf) {
+    const variantsArray = schema.oneOf || schema.anyOf;
+    const variantType = schema.oneOf ? 'oneOf' : 'anyOf';
+
+    const processedVariants = variantsArray.map((variant: any, index: number) => {
       const processedVariant = processSchema(variant, root);
       return {
-        title: processedVariant.title || variant.title || 'Unnamed Variant',
+        title: processedVariant.title || variant.title || processedVariant.$id || `Option ${index + 1}`,
+        description: processedVariant.description || variant.description,
         required: processedVariant.required || variant.required || [],
         properties: processedVariant.properties || {},
+        type: processedVariant.type || variant.type || 'object',
         ...processedVariant,
       };
     });
 
-    const allProperties: Record<string, any> = {};
-    processedVariants.forEach((variant: any) => {
-      if (variant.properties) {
-        Object.assign(allProperties, variant.properties);
-      }
-    });
-
     return {
       ...schema,
       type: schema.type || 'object',
-      properties: {
-        ...(schema.properties || {}),
-        ...allProperties,
-      },
+      properties: schema.properties
+        ? Object.fromEntries(
+            Object.entries(schema.properties).map(([key, prop]: [string, any]) => [key, processSchema(prop, root)])
+          )
+        : {},
       variants: processedVariants,
+      variantType,
     };
   }
 
@@ -203,9 +203,66 @@ function processSchema(schema: any, rootSchema?: any): any {
   return schema;
 }
 
+// NestedVariantSelector component for handling variants within array items
+const NestedVariantSelector = ({
+  variants,
+  variantType,
+  level,
+  expand,
+}: {
+  variants: any[];
+  variantType?: string;
+  level: number;
+  expand: boolean;
+}) => {
+  const [selectedIndex, setSelectedIndex] = useState(0);
+  const selectedVariant = variants[selectedIndex];
+
+  return (
+    <div className="mt-2">
+      <div className="p-2 bg-[rgb(var(--ec-accent-subtle,var(--ec-content-hover)))] border border-[rgb(var(--ec-page-border))] rounded-md">
+        <div className="flex flex-col sm:flex-row sm:items-center gap-2">
+          <span className="text-xs font-medium text-[rgb(var(--ec-page-text))]">
+            {variantType === 'anyOf' ? 'Any of' : 'One of'} {variants.length} options:
+          </span>
+          <select
+            value={selectedIndex}
+            onChange={(e) => setSelectedIndex(parseInt(e.target.value))}
+            className="form-select text-xs border-[rgb(var(--ec-input-border))] bg-[rgb(var(--ec-input-bg))] text-[rgb(var(--ec-input-text))] rounded-md shadow-sm focus:border-[rgb(var(--ec-accent))] focus:ring focus:ring-[rgb(var(--ec-accent)/0.2)] py-1"
+          >
+            {variants.map((variant: any, index: number) => (
+              <option key={index} value={index}>
+                {variant.title}
+              </option>
+            ))}
+          </select>
+        </div>
+        {selectedVariant?.description && (
+          <p className="text-xs text-[rgb(var(--ec-page-text-muted))] mt-1">{selectedVariant.description}</p>
+        )}
+      </div>
+      {selectedVariant?.properties && (
+        <div className="mt-2">
+          {Object.entries(selectedVariant.properties).map(([propName, propDetails]: [string, any]) => (
+            <SchemaProperty
+              key={`${selectedIndex}-${propName}`}
+              name={propName}
+              details={propDetails}
+              isRequired={selectedVariant.required?.includes(propName) ?? false}
+              level={level}
+              expand={expand}
+            />
+          ))}
+        </div>
+      )}
+    </div>
+  );
+};
+
 // SchemaProperty component
 const SchemaProperty = ({ name, details, isRequired, level, isListItem = false, expand }: SchemaPropertyProps) => {
   const [isExpanded, setIsExpanded] = useState(expand);
+  const [selectedVariantIndex, setSelectedVariantIndex] = useState(0);
   const contentId = useRef(`prop-${name}-${level}-${Math.random().toString(36).substring(2, 7)}`).current;
 
   useEffect(() => {
@@ -219,8 +276,11 @@ const SchemaProperty = ({ name, details, isRequired, level, isListItem = false,
     ((details.items.type === 'object' && details.items.properties) ||
       details.items.allOf ||
       details.items.oneOf ||
+      details.items.anyOf ||
+      details.items.variants ||
       details.items.$ref);
-  const isCollapsible = hasNestedProperties || hasArrayItemProperties;
+  const hasVariants = details.variants && details.variants.length > 0;
+  const isCollapsible = hasNestedProperties || hasArrayItemProperties || hasVariants;
 
   const indentationClass = `pl-${level * 3}`;
 
@@ -247,7 +307,7 @@ const SchemaProperty = ({ name, details, isRequired, level, isListItem = false,
             <div>
               <span className="font-semibold text-[rgb(var(--ec-page-text))] text-sm">{name}</span>
               <span className="ml-1.5 text-[rgb(var(--ec-accent))] font-mono text-xs">
-                {details.type}
+                {hasVariants ? (details.variantType === 'anyOf' ? 'anyOf' : 'oneOf') : details.type}
                 {details.type === 'array' && details.items?.type ? `[${details.items.type}]` : ''}
                 {details.format ? `<${details.format}>` : ''}
                 {details._refPath && (
@@ -325,9 +385,53 @@ const SchemaProperty = ({ name, details, isRequired, level, isListItem = false,
             )}
           </div>
 
-          {(hasNestedProperties || hasArrayItems) && (
+          {(hasNestedProperties || hasArrayItems || hasVariants) && (
             <div id={contentId} className={`nested-content mt-1 ${isCollapsible && !isExpanded ? 'hidden' : ''}`}>
+              {hasVariants && (
+                <div className="mt-2 mb-2 p-2 bg-[rgb(var(--ec-accent-subtle,var(--ec-content-hover)))] border border-[rgb(var(--ec-page-border))] rounded-md">
+                  <div className="flex flex-col sm:flex-row sm:items-center gap-2">
+                    <span className="text-xs font-medium text-[rgb(var(--ec-page-text))]">
+                      {details.variantType === 'anyOf' ? 'Any of' : 'One of'} {details.variants.length} options:
+                    </span>
+                    <select
+                      value={selectedVariantIndex}
+                      onChange={(e) => setSelectedVariantIndex(parseInt(e.target.value))}
+                      className="form-select text-xs border-[rgb(var(--ec-input-border))] bg-[rgb(var(--ec-input-bg))] text-[rgb(var(--ec-input-text))] rounded-md shadow-sm focus:border-[rgb(var(--ec-accent))] focus:ring focus:ring-[rgb(var(--ec-accent)/0.2)] py-1"
+                    >
+                      {details.variants.map((variant: any, index: number) => (
+                        <option key={index} value={index}>
+                          {variant.title}
+                        </option>
+                      ))}
+                    </select>
+                  </div>
+                  {details.variants[selectedVariantIndex]?.description && (
+                    <p className="text-xs text-[rgb(var(--ec-page-text-muted))] mt-1">
+                      {details.variants[selectedVariantIndex].description}
+                    </p>
+                  )}
+                </div>
+              )}
+
+              {hasVariants && details.variants[selectedVariantIndex]?.properties && (
+                <div className="mt-1">
+                  {Object.entries(details.variants[selectedVariantIndex].properties).map(
+                    ([nestedName, nestedDetails]: [string, any]) => (
+                      <SchemaProperty
+                        key={`${selectedVariantIndex}-${nestedName}`}
+                        name={nestedName}
+                        details={nestedDetails}
+                        isRequired={details.variants[selectedVariantIndex]?.required?.includes(nestedName) ?? false}
+                        level={level + 1}
+                        expand={expand}
+                      />
+                    )
+                  )}
+                </div>
+              )}
+
               {hasNestedProperties &&
+                !hasVariants &&
                 details.properties &&
                 Object.entries(details.properties).map(([nestedName, nestedDetails]: [string, any]) => (
                   <SchemaProperty
@@ -355,11 +459,21 @@ const SchemaProperty = ({ name, details, isRequired, level, isListItem = false,
                         expand={expand}
                       />
                     ))}
-                  {(details.items.allOf || details.items.oneOf || details.items.$ref) && !details.items.properties && (
-                    <div className="text-xs text-[rgb(var(--ec-page-text-muted))] mt-1">
-                      Complex array item schema detected. The properties should be processed by the parent SchemaViewer.
-                    </div>
+                  {details.items.variants && details.items.variants.length > 0 && (
+                    <NestedVariantSelector
+                      variants={details.items.variants}
+                      variantType={details.items.variantType}
+                      level={level + 1}
+                      expand={expand}
+                    />
                   )}
+                  {(details.items.allOf || details.items.oneOf || details.items.anyOf || details.items.$ref) &&
+                    !details.items.properties &&
+                    !details.items.variants && (
+                      <div className="text-xs text-[rgb(var(--ec-page-text-muted))] mt-1">
+                        Complex array item schema detected. The properties should be processed by the parent SchemaViewer.
+                      </div>
+                    )}
                 </div>
               )}
             </div>
@@ -421,7 +535,7 @@ export default function JSONSchemaViewer({
     return { displaySchema: display, isRootArray: isArray };
   }, [processedSchema]);
 
-  const { description, properties, required = [], variants } = displaySchema;
+  const { description, properties, required = [], variants, variantType } = displaySchema;
   const totalProperties = useMemo(() => countProperties(displaySchema), [displaySchema]);
 
   // Search functionality
@@ -667,14 +781,16 @@ export default function JSONSchemaViewer({
         )}
         {description && <p className="text-[rgb(var(--ec-page-text-muted))] text-xs mb-5">{description}</p>}
 
-        {variants && (
-          <div className="mb-4">
-            <div className="flex items-center space-x-2">
-              <span className="text-sm text-[rgb(var(--ec-page-text-muted))]">(one of)</span>
+        {variants && variants.length > 0 && (
+          <div className="mb-4 p-3 bg-[rgb(var(--ec-accent-subtle,var(--ec-content-hover)))] border border-[rgb(var(--ec-page-border))] rounded-md">
+            <div className="flex flex-col sm:flex-row sm:items-center gap-2">
+              <span className="text-sm font-medium text-[rgb(var(--ec-page-text))]">
+                {variantType === 'anyOf' ? 'Any of' : 'One of'} {variants.length} options:
+              </span>
               <select
                 value={selectedVariantIndex}
                 onChange={(e) => setSelectedVariantIndex(parseInt(e.target.value))}
-                className="form-select text-sm border-[rgb(var(--ec-input-border))] bg-[rgb(var(--ec-input-bg))] text-[rgb(var(--ec-input-text))] rounded-md shadow-sm focus:border-[rgb(var(--ec-accent))] focus:ring focus:ring-[rgb(var(--ec-accent)/0.2)]"
+                className="form-select text-sm border-[rgb(var(--ec-input-border))] bg-[rgb(var(--ec-input-bg))] text-[rgb(var(--ec-input-text))] rounded-md shadow-sm focus:border-[rgb(var(--ec-accent))] focus:ring focus:ring-[rgb(var(--ec-accent)/0.2)] flex-1 sm:flex-initial"
               >
                 {variants.map((variant: any, index: number) => (
                   <option key={index} value={index}>
@@ -683,27 +799,41 @@ export default function JSONSchemaViewer({
                 ))}
               </select>
             </div>
+            {variants[selectedVariantIndex]?.description && (
+              <p className="text-xs text-[rgb(var(--ec-page-text-muted))] mt-2">{variants[selectedVariantIndex].description}</p>
+            )}
           </div>
         )}
 
-        {properties ? (
-          <div ref={propertiesContainerRef}>
-            {Object.entries(properties).map(([name, details]: [string, any]) => (
-              <SchemaProperty
-                key={name}
-                name={name}
-                details={details}
-                isRequired={
-                  variants ? variants[selectedVariantIndex]?.required?.includes(name) || false : required.includes(name)
-                }
-                level={0}
-                expand={expandAll}
-              />
-            ))}
-          </div>
-        ) : !isRootArray ? (
-          <p className="text-[rgb(var(--ec-page-text-muted))] text-sm">Schema does not contain any properties.</p>
-        ) : (
+        {(() => {
+          // Determine which properties to display
+          const propsToDisplay =
+            variants && variants.length > 0 && variants[selectedVariantIndex]?.properties
+              ? { ...properties, ...variants[selectedVariantIndex].properties }
+              : properties;
+          const requiredProps = variants && variants.length > 0 ? variants[selectedVariantIndex]?.required || [] : required;
+
+          if (propsToDisplay && Object.keys(propsToDisplay).length > 0) {
+            return (
+              <div ref={propertiesContainerRef}>
+                {Object.entries(propsToDisplay).map(([name, details]: [string, any]) => (
+                  <SchemaProperty
+                    key={`${selectedVariantIndex}-${name}`}
+                    name={name}
+                    details={details}
+                    isRequired={requiredProps.includes(name)}
+                    level={0}
+                    expand={expandAll}
+                  />
+                ))}
+              </div>
+            );
+          } else if (!isRootArray) {
+            return <p className="text-[rgb(var(--ec-page-text-muted))] text-sm">Schema does not contain any properties.</p>;
+          }
+          return null;
+        })()}
+        {!properties && !variants && isRootArray && (
           <div className="text-center py-8">
             <div className="text-[rgb(var(--ec-page-text-muted))] text-sm">
               <p>

package/eventcatalog/src/pages/schemas/explorer/_index.data.ts

@@ -4,6 +4,7 @@ import { getEvents } from '@utils/collections/events';
 import { getCommands } from '@utils/collections/commands';
 import { getQueries } from '@utils/collections/queries';
 import { getServices, getSpecificationsForService } from '@utils/collections/services';
+import { getDomains, getSpecificationsForDomain } from '@utils/collections/domains';
 import { getOwner } from '@utils/collections/owners';
 import { buildUrl } from '@utils/url-builder';
 import { resourceFileExists, readResourceFile } from '@utils/resource-files';
@@ -133,7 +134,58 @@ async function fetchAllSchemas() {
   // Flatten and filter out null values
   const flatServicesWithSpecs = servicesWithSpecs.flat().filter((service) => service !== null);
 
-  return [...messagesWithSchemas, ...flatServicesWithSpecs];
+  // Fetch all domains
+  const domains = await getDomains({ getAllVersions: true });
+
+  // Filter domains with specifications and read spec content - only keep essential data
+  const domainsWithSpecs = await Promise.all(
+    domains.map(async (domain) => {
+      try {
+        const specifications = getSpecificationsForDomain(domain);
+
+        if (specifications.length === 0) {
+          return null;
+        }
+
+        return await Promise.all(
+          specifications.map(async (spec) => {
+            if (!resourceFileExists(domain, spec.path)) {
+              return null;
+            }
+
+            const schemaContent = readResourceFile(domain, spec.path) ?? '';
+            const schemaExtension = spec.type;
+            const enrichedOwners = await enrichOwners(domain.data.owners || []);
+
+            return {
+              collection: 'domains',
+              data: {
+                id: `${domain.data.id}`,
+                name: `${domain.data.name} - ${spec.name}`,
+                version: domain.data.version,
+                summary: domain.data.summary,
+                schemaPath: spec.path,
+                owners: enrichedOwners,
+              },
+              schemaContent,
+              schemaExtension,
+              specType: spec.type,
+              specName: spec.name,
+              specFilenameWithoutExtension: spec.filenameWithoutExtension,
+            };
+          })
+        );
+      } catch (error) {
+        console.error(`Error reading specifications for domain ${domain.data.id}:`, error);
+        return null;
+      }
+    })
+  );
+
+  // Flatten and filter out null values for domains
+  const flatDomainsWithSpecs = domainsWithSpecs.flat().filter((domain) => domain !== null);
+
+  return [...messagesWithSchemas, ...flatServicesWithSpecs, ...flatDomainsWithSpecs];
 }
 
 export class Page extends HybridPage {

package/eventcatalog/src/stores/sidebar-store/builders/domain.ts

@@ -12,6 +12,7 @@ import {
 } from './shared';
 import { isVisualiserEnabled } from '@utils/feature';
 import { pluralizeMessageType } from '@utils/collections/messages';
+import { getSpecificationsForDomain } from '@utils/collections/domains';
 
 export const buildDomainNode = (domain: CollectionEntry<'domains'>, owners: any[], context: ResourceGroupContext): NavNode => {
   const servicesInDomain = domain.data.services || [];
@@ -48,6 +49,14 @@ export const buildDomainNode = (domain: CollectionEntry<'domains'>, owners: any[
   const diagramNavItems = buildDiagramNavItems(domainDiagrams, context.diagrams);
   const hasDiagrams = diagramNavItems.length > 0;
 
+  // Specifications
+  const specifications = getSpecificationsForDomain(domain);
+  const hasSpecifications = specifications.length > 0;
+  const openAPISpecifications = specifications.filter((specification) => specification.type === 'openapi');
+  const asyncAPISpecifications = specifications.filter((specification) => specification.type === 'asyncapi');
+  const graphQLSpecifications = specifications.filter((specification) => specification.type === 'graphql');
+  const renderSpecifications = hasSpecifications && shouldRenderSideBarSection(domain, 'specifications');
+
   return {
     type: 'item',
     title: domain.data.name,
@@ -87,6 +96,37 @@ export const buildDomainNode = (domain: CollectionEntry<'domains'>, owners: any[
         icon: 'FileImage',
         pages: diagramNavItems,
       },
+      renderSpecifications && {
+        type: 'group',
+        title: 'API & Contracts',
+        icon: 'FileCode',
+        pages: [
+          ...openAPISpecifications.map((specification) => ({
+            type: 'item',
+            title: specification.name,
+            leftIcon: '/icons/openapi-black.svg',
+            href: buildUrl(
+              `/docs/domains/${domain.data.id}/${domain.data.version}/spec/${specification.filenameWithoutExtension}`
+            ),
+          })),
+          ...asyncAPISpecifications.map((specification) => ({
+            type: 'item',
+            title: specification.name,
+            leftIcon: '/icons/asyncapi-black.svg',
+            href: buildUrl(
+              `/docs/domains/${domain.data.id}/${domain.data.version}/asyncapi/${specification.filenameWithoutExtension}`
+            ),
+          })),
+          ...graphQLSpecifications.map((specification) => ({
+            type: 'item',
+            title: specification.name,
+            leftIcon: '/icons/graphql-black.svg',
+            href: buildUrl(
+              `/docs/domains/${domain.data.id}/${domain.data.version}/graphql/${specification.filenameWithoutExtension}`
+            ),
+          })),
+        ],
+      },
       renderSubDomains && {
         type: 'group',
         title: 'Subdomains',

package/eventcatalog/src/utils/collections/domains.ts

@@ -4,7 +4,7 @@ import path from 'path';
 import type { CollectionMessageTypes } from '@types';
 import type { Service } from './types';
 import utils from '@eventcatalog/sdk';
-import { createVersionedMap, findInMap } from '@utils/collections/util';
+import { createVersionedMap, findInMap, processSpecifications } from '@utils/collections/util';
 
 const PROJECT_DIR = process.env.PROJECT_DIR || process.cwd();
 const CACHE_ENABLED = process.env.DISABLE_EVENTCATALOG_CACHE !== 'true';
@@ -383,3 +383,7 @@ export const getDomainsForService = async (service: Service): Promise<Domain[]>
 export const domainHasEntities = (domain: Domain): boolean => {
   return (domain.data.entities && domain.data.entities.length > 0) || false;
 };
+
+export const getSpecificationsForDomain = (domain: Domain) => {
+  return processSpecifications(domain.data.specifications as any);
+};

package/eventcatalog/src/utils/collections/services.ts

@@ -6,7 +6,7 @@ import type { CollectionMessageTypes, CollectionTypes } from '@types';
 const PROJECT_DIR = process.env.PROJECT_DIR || process.cwd();
 import utils, { type Domain } from '@eventcatalog/sdk';
 import { getDomains, getDomainsForService } from './domains';
-import { createVersionedMap, findInMap } from '@utils/collections/util';
+import { createVersionedMap, findInMap, processSpecifications } from '@utils/collections/util';
 
 export type Service = CollectionEntry<'services'>;
 
@@ -174,31 +174,7 @@ export const getConsumersOfMessage = (services: Service[], message: CollectionEn
 };
 
 export const getSpecificationsForService = (service: CollectionEntry<CollectionTypes>) => {
-  const specifications = Array.isArray(service.data.specifications) ? service.data.specifications : [];
-
-  if (service.data.specifications && !Array.isArray(service.data.specifications)) {
-    if (service.data.specifications.asyncapiPath) {
-      specifications.push({
-        type: 'asyncapi',
-        path: service.data.specifications.asyncapiPath,
-        name: 'AsyncAPI',
-      });
-    }
-    if (service.data.specifications.openapiPath) {
-      specifications.push({
-        type: 'openapi',
-        path: service.data.specifications.openapiPath,
-        name: 'OpenAPI',
-      });
-    }
-  }
-
-  return specifications.map((spec) => ({
-    ...spec,
-    name: spec.name || (spec.type === 'asyncapi' ? 'AsyncAPI' : 'OpenAPI'),
-    filename: path.basename(spec.path),
-    filenameWithoutExtension: path.basename(spec.path, path.extname(spec.path)),
-  }));
+  return processSpecifications(service.data.specifications as any);
 };
 // Get services for channel
 export const getProducersAndConsumersForChannel = async (channel: CollectionEntry<'channels'>) => {

package/eventcatalog/src/utils/collections/util.ts

@@ -1,6 +1,70 @@
 import type { CollectionTypes } from '@types';
 import type { CollectionEntry } from 'astro:content';
 import semver, { coerce, compare, eq, satisfies as satisfiesRange } from 'semver';
+import path from 'node:path';
+
+// --- SPECIFICATION HELPERS ---
+
+export type SpecificationType = 'asyncapi' | 'openapi' | 'graphql';
+
+export interface SpecificationInput {
+  type: SpecificationType;
+  path: string;
+  name?: string;
+}
+
+export interface ProcessedSpecification {
+  type: SpecificationType;
+  path: string;
+  name: string;
+  filename: string;
+  filenameWithoutExtension: string;
+}
+
+export const getDefaultSpecificationName = (type: string): string => {
+  switch (type) {
+    case 'asyncapi':
+      return 'AsyncAPI';
+    case 'openapi':
+      return 'OpenAPI';
+    case 'graphql':
+      return 'GraphQL';
+    default:
+      return 'Specification';
+  }
+};
+
+interface LegacySpecificationFormat {
+  asyncapiPath?: string;
+  openapiPath?: string;
+  graphqlPath?: string;
+}
+
+export const processSpecifications = (
+  specifications: SpecificationInput[] | LegacySpecificationFormat | undefined
+): ProcessedSpecification[] => {
+  const specs: SpecificationInput[] = Array.isArray(specifications) ? [...specifications] : [];
+
+  // Handle legacy object format
+  if (specifications && !Array.isArray(specifications)) {
+    if (specifications.asyncapiPath) {
+      specs.push({ type: 'asyncapi', path: specifications.asyncapiPath, name: 'AsyncAPI' });
+    }
+    if (specifications.openapiPath) {
+      specs.push({ type: 'openapi', path: specifications.openapiPath, name: 'OpenAPI' });
+    }
+    if (specifications.graphqlPath) {
+      specs.push({ type: 'graphql', path: specifications.graphqlPath, name: 'GraphQL' });
+    }
+  }
+
+  return specs.map((spec) => ({
+    ...spec,
+    name: spec.name || getDefaultSpecificationName(spec.type),
+    filename: path.basename(spec.path),
+    filenameWithoutExtension: path.basename(spec.path, path.extname(spec.path)),
+  }));
+};
 
 export const getPreviousVersion = (version: string, versions: string[]) => {
   const index = versions.indexOf(version);

package/package.json

@@ -6,7 +6,7 @@
     "url": "https://github.com/event-catalog/eventcatalog.git"
   },
   "type": "module",
-  "version": "3.7.0",
+  "version": "3.7.2",
   "publishConfig": {
     "access": "public"
   },
@@ -23,9 +23,9 @@
     "@ai-sdk/react": "^3.0.17",
     "@astrojs/markdown-remark": "^6.3.10",
     "@astrojs/mdx": "^4.3.13",
-    "@astrojs/node": "^9.5.1",
+    "@astrojs/node": "^9.5.2",
     "@astrojs/react": "^4.4.2",
-    "@astrojs/rss": "^4.0.14",
+    "@astrojs/rss": "^4.0.15",
     "@astrojs/tailwind": "^6.0.2",
     "@asyncapi/avro-schema-parser": "3.0.24",
     "@asyncapi/parser": "3.4.0",
@@ -55,7 +55,7 @@
     "@tanstack/react-table": "^8.17.3",
     "@xyflow/react": "^12.3.6",
     "ai": "^6.0.17",
-    "astro": "^5.16.8",
+    "astro": "^5.16.10",
     "astro-compress": "^2.3.8",
     "astro-expressive-code": "^0.41.3",
     "astro-seo": "^0.8.4",