@eventcatalog/core 3.7.1 → 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.1";
+var version = "3.7.2";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/analytics.js

@@ -1,7 +1,7 @@
 import {
   raiseEvent
-} from "../chunk-BVJJ3COQ.js";
-import "../chunk-MIHGWXCX.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.1";
+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-B6NBNZGS.js";
-import "../chunk-BVJJ3COQ.js";
-import "../chunk-MIHGWXCX.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-PV5ER42D.js → chunk-7CTNGTBB.js}

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

package/dist/{chunk-BVJJ3COQ.js → chunk-GQZVIS3Z.js}

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

package/dist/{chunk-B6NBNZGS.js → chunk-M7EPRGHR.js}

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

package/dist/{chunk-44EDP7IH.js → chunk-O6SRHGZ7.js}

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

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

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

package/dist/constants.js

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-MIHGWXCX.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.1";
+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-B6NBNZGS.js";
-import "./chunk-BVJJ3COQ.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-44EDP7IH.js";
+} from "./chunk-O6SRHGZ7.js";
 import {
   logger
-} from "./chunk-PV5ER42D.js";
+} from "./chunk-7CTNGTBB.js";
 import {
   VERSION
-} from "./chunk-MIHGWXCX.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.1";
+var version = "3.7.2";
 
 // src/constants.ts
 var VERSION = version;

package/dist/generate.js

@@ -1,8 +1,8 @@
 import {
   generate
-} from "./chunk-44EDP7IH.js";
-import "./chunk-PV5ER42D.js";
-import "./chunk-MIHGWXCX.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.1";
+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-PV5ER42D.js";
-import "../chunk-MIHGWXCX.js";
+} from "../chunk-7CTNGTBB.js";
+import "../chunk-WAX3S32H.js";
 export {
   logger
 };

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.1",
+  "version": "3.7.2",
   "publishConfig": {
     "access": "public"
   },