@eventcatalog/core 4.10.9 → 4.10.10

package/dist/analytics/analytics.cjs

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(analytics_exports);
 var import_os = __toESM(require("os"), 1);
 
 // package.json
-var version = "4.10.9";
+var version = "4.10.10";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/analytics.js

@@ -1,7 +1,7 @@
 import {
   raiseEvent
-} from "../chunk-5WB6CXZH.js";
-import "../chunk-3EEFSHHW.js";
+} from "../chunk-QXANW76J.js";
+import "../chunk-PR77FB54.js";
 export {
   raiseEvent
 };

package/dist/analytics/log-build.cjs

@@ -140,7 +140,7 @@ var verifyRequiredFieldsAreInCatalogConfigFile = async (projectDirectory) => {
 var import_os = __toESM(require("os"), 1);
 
 // package.json
-var version = "4.10.9";
+var version = "4.10.10";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/log-build.js

@@ -1,9 +1,9 @@
 import {
   log_build_default
-} from "../chunk-ONRJA5DX.js";
-import "../chunk-5WB6CXZH.js";
+} from "../chunk-K45ABG6N.js";
+import "../chunk-QXANW76J.js";
 import "../chunk-ZAZHAVKB.js";
-import "../chunk-3EEFSHHW.js";
+import "../chunk-PR77FB54.js";
 import "../chunk-6QENHZZP.js";
 export {
   log_build_default as default

package/dist/{chunk-ONRJA5DX.js → chunk-K45ABG6N.js}

@@ -1,6 +1,6 @@
 import {
   raiseEvent
-} from "./chunk-5WB6CXZH.js";
+} from "./chunk-QXANW76J.js";
 import {
   countResources,
   hashCatalogContent,

package/dist/{chunk-3EEFSHHW.js → chunk-PR77FB54.js}

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

package/dist/{chunk-5WB6CXZH.js → chunk-QXANW76J.js}

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-3EEFSHHW.js";
+} from "./chunk-PR77FB54.js";
 
 // src/analytics/analytics.js
 import os from "os";

package/dist/{chunk-EG62NTWS.js → chunk-U52FCZQ6.js}

@@ -1,6 +1,12 @@
+import {
+  withFederationOutputTransaction
+} from "./chunk-WRNH5C3U.js";
+import {
+  composePublicAssets
+} from "./chunk-5EPNFDT5.js";
 import {
   createFederationSourceProvider
-} from "./chunk-A2RZR3U4.js";
+} from "./chunk-6K7XZAYI.js";
 import {
   createFederationContentCache
 } from "./chunk-R7Z5ALYI.js";
@@ -11,12 +17,6 @@ import {
 import {
   isFederationEnabled
 } from "./chunk-FV56YFM4.js";
-import {
-  withFederationOutputTransaction
-} from "./chunk-WRNH5C3U.js";
-import {
-  composePublicAssets
-} from "./chunk-5EPNFDT5.js";
 import {
   getEventCatalogConfigFile
 } from "./chunk-6QENHZZP.js";

package/dist/{chunk-BYPWHDX6.js → chunk-U6R6BFJ5.js}

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

package/dist/{chunk-WD5UW4A4.js → chunk-Y6VX2CGL.js}

@@ -1,6 +1,6 @@
 import {
   logger
-} from "./chunk-BYPWHDX6.js";
+} from "./chunk-U6R6BFJ5.js";
 import {
   cleanup,
   getEventCatalogConfigFile

package/dist/constants.cjs

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

package/dist/constants.js

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-3EEFSHHW.js";
+} from "./chunk-PR77FB54.js";
 export {
   VERSION
 };

package/dist/eventcatalog.cjs

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

package/dist/eventcatalog.js

@@ -1,18 +1,21 @@
-import {
-  log_build_default
-} from "./chunk-ONRJA5DX.js";
-import "./chunk-5WB6CXZH.js";
-import "./chunk-ZAZHAVKB.js";
 import {
   runMigrations
 } from "./chunk-XUAF2H54.js";
 import "./chunk-CA4U2JP7.js";
+import {
+  log_build_default
+} from "./chunk-K45ABG6N.js";
+import "./chunk-QXANW76J.js";
+import "./chunk-ZAZHAVKB.js";
 import {
   FederationConflictError,
   FederationDiagnosticError,
   federateCatalog
-} from "./chunk-EG62NTWS.js";
-import "./chunk-A2RZR3U4.js";
+} from "./chunk-U52FCZQ6.js";
+import "./chunk-WRNH5C3U.js";
+import "./chunk-5EPNFDT5.js";
+import "./chunk-6K7XZAYI.js";
+import "./chunk-352FGP6W.js";
 import "./chunk-R7Z5ALYI.js";
 import {
   getFederationDiagnosticCounts,
@@ -20,9 +23,6 @@ import {
 } from "./chunk-JJPB6EOZ.js";
 import "./chunk-FV56YFM4.js";
 import "./chunk-SDZQJTJW.js";
-import "./chunk-352FGP6W.js";
-import "./chunk-WRNH5C3U.js";
-import "./chunk-5EPNFDT5.js";
 import {
   getProjectOutDir,
   isAuthEnabled,
@@ -31,10 +31,10 @@ import {
 } from "./chunk-B7HCX5HM.js";
 import {
   generate
-} from "./chunk-WD5UW4A4.js";
+} from "./chunk-Y6VX2CGL.js";
 import {
   logger
-} from "./chunk-BYPWHDX6.js";
+} from "./chunk-U6R6BFJ5.js";
 import {
   resolve_catalog_dependencies_default
 } from "./chunk-LHR4G2UO.js";
@@ -54,7 +54,7 @@ import {
 import "./chunk-W5JQON7Z.js";
 import {
   VERSION
-} from "./chunk-3EEFSHHW.js";
+} from "./chunk-PR77FB54.js";
 import {
   linkCoreNodeModules,
   resolveInstalledCoreNodeModules

package/dist/federation/federate.js

@@ -2,15 +2,15 @@ import {
   FederationConflictError,
   FederationDiagnosticError,
   federateCatalog
-} from "../chunk-EG62NTWS.js";
-import "../chunk-A2RZR3U4.js";
+} from "../chunk-U52FCZQ6.js";
+import "../chunk-WRNH5C3U.js";
+import "../chunk-5EPNFDT5.js";
+import "../chunk-6K7XZAYI.js";
+import "../chunk-352FGP6W.js";
 import "../chunk-R7Z5ALYI.js";
 import "../chunk-JJPB6EOZ.js";
 import "../chunk-FV56YFM4.js";
 import "../chunk-SDZQJTJW.js";
-import "../chunk-352FGP6W.js";
-import "../chunk-WRNH5C3U.js";
-import "../chunk-5EPNFDT5.js";
 import "../chunk-6QENHZZP.js";
 export {
   FederationConflictError,

package/dist/federation/source-provider.js

@@ -1,8 +1,8 @@
 import {
   createFederationSourceProvider
-} from "../chunk-A2RZR3U4.js";
-import "../chunk-SDZQJTJW.js";
+} from "../chunk-6K7XZAYI.js";
 import "../chunk-352FGP6W.js";
+import "../chunk-SDZQJTJW.js";
 export {
   createFederationSourceProvider
 };

package/dist/generate.cjs

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

package/dist/generate.js

@@ -1,8 +1,8 @@
 import {
   generate
-} from "./chunk-WD5UW4A4.js";
-import "./chunk-BYPWHDX6.js";
-import "./chunk-3EEFSHHW.js";
+} from "./chunk-Y6VX2CGL.js";
+import "./chunk-U6R6BFJ5.js";
+import "./chunk-PR77FB54.js";
 import "./chunk-6QENHZZP.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 = "4.10.9";
+var version = "4.10.10";
 
 // src/constants.ts
 var VERSION = version;

package/dist/utils/cli-logger.js

@@ -1,7 +1,7 @@
 import {
   logger
-} from "../chunk-BYPWHDX6.js";
-import "../chunk-3EEFSHHW.js";
+} from "../chunk-U6R6BFJ5.js";
+import "../chunk-PR77FB54.js";
 export {
   logger
 };

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

@@ -24,7 +24,8 @@ import ExamplesViewer from './ExamplesViewer';
 import VersionHistoryModal from './VersionHistoryModal';
 import SchemaCodeModal from './SchemaCodeModal';
 import SchemaViewerModal from './SchemaViewerModal';
-import { copyToClipboard, downloadSchema, getSchemaTypeLabel, ICON_SPECS, extractServiceName } from './utils';
+import { copyToClipboard, downloadSchema, getSchemaTypeLabel, ICON_SPECS, getSchemaRelationshipReference } from './utils';
+import { createSchemaDetailsLoader, useSchemaDetails } from './useSchemaDetails';
 import { parseProtobufSchema } from '@utils/protobuf-schema';
 import type { SchemaItem, VersionDiff, Owner, Producer, Consumer } from './types';
 
@@ -39,7 +40,7 @@ interface SchemaDetailsPanelProps {
 }
 
 export default function SchemaDetailsPanel({
-  message,
+  message: metadataMessage,
   availableVersions,
   selectedVersion,
   onVersionChange,
@@ -47,6 +48,9 @@ export default function SchemaDetailsPanel({
   showOwners = true,
   showProducersConsumers = true,
 }: SchemaDetailsPanelProps) {
+  const [loadDetails] = useState(createSchemaDetailsLoader);
+  const content = useSchemaDetails(metadataMessage, loadDetails);
+  const message = content.message!;
   const [copiedId, setCopiedId] = useState<string | null>(null);
   const [activeTab, setActiveTab] = useState<'code' | 'schema' | 'diff' | 'api' | 'examples'>('code');
   const [isDiffModalOpen, setIsDiffModalOpen] = useState(false);
@@ -88,18 +92,23 @@ export default function SchemaDetailsPanel({
     setIsDiffModalOpen(false);
   }, [schemaResourceKey, defaultFromVersion, defaultToVersion]);
 
-  const diffFromItem = useMemo(
+  const diffFromMetadata = useMemo(
     () => uniqueAvailableVersions.find((version) => version.data.version === diffFromVersion),
     [diffFromVersion, uniqueAvailableVersions]
   );
-  const diffToItem = useMemo(
+  const diffToMetadata = useMemo(
     () => uniqueAvailableVersions.find((version) => version.data.version === diffToVersion),
     [diffToVersion, uniqueAvailableVersions]
   );
+  const comparing = activeTab === 'diff' || isDiffModalOpen;
+  const fromContent = useSchemaDetails(diffFromMetadata, loadDetails, comparing);
+  const toContent = useSchemaDetails(diffToMetadata, loadDetails, comparing);
+  const diffFromItem = fromContent.message;
+  const diffToItem = toContent.message;
   const hasDiffFromContent = !!diffFromItem?.schemaContent?.trim();
   const hasDiffToContent = !!diffToItem?.schemaContent?.trim();
   const selectedDiff: VersionDiff | null = useMemo(() => {
-    if (!diffFromItem || !diffToItem) return null;
+    if (!comparing || !diffFromItem || !diffToItem) return null;
     if (diffFromItem.data.version === diffToItem.data.version) return null;
     if (!diffFromItem.schemaContent?.trim() || !diffToItem.schemaContent?.trim()) return null;
 
@@ -126,7 +135,7 @@ export default function SchemaDetailsPanel({
       fromContent: diffFromItem.schemaContent,
       toContent: diffToItem.schemaContent,
     };
-  }, [diffFromItem, diffToItem]);
+  }, [comparing, diffFromItem, diffToItem]);
   const selectedDiffs = selectedDiff ? [selectedDiff] : [];
 
   // Check if this is a JSON schema
@@ -359,7 +368,9 @@ export default function SchemaDetailsPanel({
 
         {/* Tab content */}
         <div className="flex-1 min-h-0 overflow-hidden p-6">
-          {activeTab === 'examples' && examples.length > 0 ? (
+          {content.loading || content.error ? (
+            <SchemaLoadingState loading={content.loading} error={content.error} retry={content.retry} />
+          ) : activeTab === 'examples' && examples.length > 0 ? (
             <ExamplesViewer examples={examples} />
           ) : activeTab === 'api' ? (
             <ApiContentViewer
@@ -416,7 +427,16 @@ export default function SchemaDetailsPanel({
                 </button>
               </div>
               <div className="min-h-0 flex-1 overflow-hidden">
-                {diffFromVersion === diffToVersion ? (
+                {fromContent.loading || toContent.loading || fromContent.error || toContent.error ? (
+                  <SchemaLoadingState
+                    loading={fromContent.loading || toContent.loading}
+                    error={fromContent.error || toContent.error}
+                    retry={() => {
+                      fromContent.retry();
+                      toContent.retry();
+                    }}
+                  />
+                ) : diffFromVersion === diffToVersion ? (
                   <div className="flex h-full items-center justify-center text-[rgb(var(--ec-page-text-muted))]">
                     <p className="text-sm">Select two different versions</p>
                   </div>
@@ -525,11 +545,11 @@ export default function SchemaDetailsPanel({
               </div>
               <div className="space-y-1">
                 {producers.map((producer: Producer, idx: number) => {
-                  const serviceName = extractServiceName(producer.id);
+                  const { id: serviceName, version } = getSchemaRelationshipReference(producer);
                   return (
                     <a
                       key={`${producer.id}-${idx}`}
-                      href={buildUrl(`/docs/services/${serviceName}/${producer.version}`)}
+                      href={buildUrl(`/docs/services/${serviceName}/${version}`)}
                       className="flex items-center gap-2 rounded-lg px-2 py-1.5 text-xs font-medium text-[rgb(var(--ec-page-text-muted))] transition-colors hover:bg-[rgb(var(--ec-page-bg)/0.55)] hover:text-[rgb(var(--ec-accent))]"
                     >
                       <ServerIcon className="h-3.5 w-3.5 flex-shrink-0 text-[rgb(var(--ec-page-text-muted))]" />
@@ -551,11 +571,11 @@ export default function SchemaDetailsPanel({
               </div>
               <div className="space-y-1">
                 {consumers.map((consumer: Consumer, idx: number) => {
-                  const serviceName = extractServiceName(consumer.id);
+                  const { id: serviceName, version } = getSchemaRelationshipReference(consumer);
                   return (
                     <a
                       key={`${consumer.id}-${idx}`}
-                      href={buildUrl(`/docs/services/${serviceName}/${consumer.version}`)}
+                      href={buildUrl(`/docs/services/${serviceName}/${version}`)}
                       className="flex items-center gap-2 rounded-lg px-2 py-1.5 text-xs font-medium text-[rgb(var(--ec-page-text-muted))] transition-colors hover:bg-[rgb(var(--ec-page-bg)/0.55)] hover:text-[rgb(var(--ec-accent))]"
                     >
                       <ServerIcon className="h-3.5 w-3.5 flex-shrink-0 text-[rgb(var(--ec-page-text-muted))]" />
@@ -615,3 +635,29 @@ export default function SchemaDetailsPanel({
     </div>
   );
 }
+
+function SchemaLoadingState({ loading, error, retry }: { loading: boolean; error?: string; retry: () => void }) {
+  if (!error) {
+    if (!loading) return null;
+    return (
+      <div role="status" className="flex h-full items-center justify-center gap-2 text-sm text-[rgb(var(--ec-page-text-muted))]">
+        <span
+          aria-hidden="true"
+          className="h-4 w-4 rounded-full border-2 border-[rgb(var(--ec-page-border))] border-t-[rgb(var(--ec-page-text-muted))] motion-safe:animate-spin"
+        />
+        <span>Loading schema…</span>
+      </div>
+    );
+  }
+
+  return (
+    <div className="flex h-full flex-col items-center justify-center gap-3 text-[rgb(var(--ec-page-text-muted))]" role="alert">
+      <p>{error}</p>
+      {error && (
+        <button type="button" onClick={retry} className="text-[rgb(var(--ec-accent))] hover:underline">
+          Try again
+        </button>
+      )}
+    </div>
+  );
+}

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

@@ -36,10 +36,10 @@ function getSpecFile(item: SchemaItem): string {
  * multiple specs of the same type (e.g. two OpenAPI specs).
  */
 function getGroupKey(item: SchemaItem): string {
-  if (item.collection === 'services') {
-    return `${item.data.id}__${item.specType || 'unknown'}__${getSpecFile(item)}`;
+  if (item.collection === 'services' || item.collection === 'domains') {
+    return `${item.collection}__${item.data.id}__${item.specType || 'unknown'}__${getSpecFile(item)}`;
   }
-  return item.data.id;
+  return `${item.collection}__${item.data.id}`;
 }
 
 interface SchemaExplorerProps {
@@ -110,7 +110,7 @@ export default function SchemaExplorer({ schemas, apiAccessEnabled = false }: Sc
     params.set('version', message.data.version);
     params.set('collection', message.collection);
 
-    if (message.collection === 'services') {
+    if (message.collection === 'services' || message.collection === 'domains') {
       params.set('specType', message.specType || 'unknown');
       const specFile = getSpecFile(message);
       if (specFile) {
@@ -242,7 +242,7 @@ export default function SchemaExplorer({ schemas, apiAccessEnabled = false }: Sc
         const versionMatch = msg.data.version === version;
         const collectionMatch = !collection || msg.collection === collection;
 
-        if (msg.collection === 'services') {
+        if (msg.collection === 'services' || msg.collection === 'domains') {
           const specTypeMatch = !specType || msg.specType === specType;
           const msgSpecFile = getSpecFile(msg);
           const specFilenameMatch = !specFilename || msgSpecFile === specFilename;

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

@@ -11,6 +11,8 @@ interface SchemaListItemProps {
 }
 
 function getNamespace(message: SchemaItem): string | null {
+  if (message.data.producerName) return message.data.producerName;
+
   const producers = message.data.producers || [];
   const firstProducer = producers[0];
 

package/eventcatalog/src/components/SchemaExplorer/types.ts

@@ -20,7 +20,7 @@ export interface Owner {
 }
 
 export interface SchemaItem {
-  collection: CollectionMessageTypes | 'services' | 'data-products';
+  collection: CollectionMessageTypes | 'services' | 'domains' | 'data-products';
   data: {
     id: string;
     name: string;
@@ -29,9 +29,12 @@ export interface SchemaItem {
     schemaPath?: string;
     producers?: Producer[];
     consumers?: Consumer[];
+    producerName?: string;
     owners?: Owner[];
   };
   schemaContent?: string;
+  /** Internal URL for loading this version's content without embedding it in the page. */
+  contentUrl?: string;
   schemaExtension?: string;
   specType?: string;
   specName?: string;
@@ -44,6 +47,12 @@ export interface SchemaItem {
   examples?: MessageExample[];
 }
 
+export interface SchemaDetails {
+  schemaContent: string;
+  examples: MessageExample[];
+  data?: Pick<SchemaItem['data'], 'producers' | 'consumers'>;
+}
+
 export interface VersionDiff {
   fromVersion: string;
   toVersion: string;

package/eventcatalog/src/components/SchemaExplorer/useSchemaDetails.ts

@@ -0,0 +1,69 @@
+import { useEffect, useMemo, useState } from 'react';
+import type { SchemaDetails, SchemaItem } from './types';
+
+// Scoped to the explorer component's lifetime by the caller. Also deduplicates
+// requests when the selected version is one of the comparison versions.
+export const createSchemaDetailsLoader = () => {
+  const requests = new Map<string, Promise<SchemaDetails>>();
+  const resolved = new Map<string, SchemaDetails>();
+  const load = (url: string): Promise<SchemaDetails> => {
+    const existing = requests.get(url);
+    if (existing) return existing;
+    const request = fetch(url)
+      .then(async (response) => {
+        if (!response.ok) throw new Error('Unable to load schema content. Please try again.');
+        const details = await response.json();
+        if (typeof details.schemaContent !== 'string' || !Array.isArray(details.examples)) {
+          throw new Error('Unable to load schema content. Please try again.');
+        }
+        resolved.set(url, details);
+        return details as SchemaDetails;
+      })
+      .catch((error) => {
+        requests.delete(url);
+        throw error;
+      });
+    requests.set(url, request);
+    return request;
+  };
+  return Object.assign(load, { peek: (url: string) => resolved.get(url) });
+};
+
+export function useSchemaDetails(
+  item: SchemaItem | undefined,
+  load: ReturnType<typeof createSchemaDetailsLoader>,
+  enabled = true
+) {
+  const url = enabled ? item?.contentUrl : undefined;
+  const [attempt, setAttempt] = useState(0);
+  const [state, setState] = useState<{ url: string; details?: SchemaDetails; error?: string }>();
+
+  useEffect(() => {
+    if (!url || load.peek(url)) return;
+    let current = true;
+    setState(undefined);
+    load(url).then(
+      (details) => current && setState({ url, details }),
+      () => current && setState({ url, error: 'Unable to load schema content. Please try again.' })
+    );
+    return () => {
+      current = false;
+    };
+  }, [url, load, attempt]);
+
+  const matchingState = state?.url === url ? state : undefined;
+  const details = url ? matchingState?.details || load.peek(url) : undefined;
+  const message = useMemo(
+    () => (item && details ? { ...item, ...details, data: { ...item.data, ...details.data } } : item),
+    [item, details]
+  );
+  return {
+    message,
+    loading: !!url && !details && !matchingState?.error,
+    error: details ? undefined : matchingState?.error,
+    retry: () => {
+      setState(undefined);
+      setAttempt((value) => value + 1);
+    },
+  };
+}

package/eventcatalog/src/components/SchemaExplorer/utils.ts

@@ -41,6 +41,18 @@ export function extractServiceName(refId: string): string {
   return match ? match[1] : refId;
 }
 
+/** Resolve both enriched collection entries and compact explorer references. */
+export function getSchemaRelationshipReference(reference: {
+  id: string;
+  version?: string;
+  data?: { id: string; version: string };
+}) {
+  return {
+    id: reference.data?.id ?? reference.id,
+    version: reference.data?.version ?? reference.version,
+  };
+}
+
 export const getLanguageForHighlight = (extension?: string): string => {
   if (!extension) return 'json';
   const ext = extension.toLowerCase();

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

@@ -1,272 +1,6 @@
 import { isSSR } from '@utils/feature';
 import { HybridPage } from '@utils/page-loaders/hybrid-page';
-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 { getDataProducts } from '@utils/collections/data-products';
-import { getOwner } from '@utils/collections/owners';
-import { buildUrl } from '@utils/url-builder';
-import { resourceFileExists, readResourceFile } from '@utils/resource-files';
-import { getExamplesForResource } from '@utils/collections/examples';
-import { getCollection } from 'astro:content';
-import path from 'path';
-
-// Helper function to enrich owners with full details
-async function enrichOwners(ownersRaw: any[]) {
-  if (!ownersRaw || ownersRaw.length === 0) return [];
-
-  const owners = await Promise.all(ownersRaw.map(getOwner));
-  const filteredOwners = owners.filter((o) => o !== undefined);
-
-  return filteredOwners.map((o) => ({
-    id: o.data.id,
-    name: o.data.name,
-    type: o.collection,
-    href: buildUrl(`/docs/${o.collection}/${o.data.id}`),
-  }));
-}
-
-async function fetchAllSchemas() {
-  // Fetch all messages
-  const events = await getEvents({ getAllVersions: true });
-  const commands = await getCommands({ getAllVersions: true });
-  const queries = await getQueries({ getAllVersions: true });
-  const schemaEntries = await getCollection('schemas');
-
-  // Fetch all services
-  const services = await getServices({ getAllVersions: true });
-
-  // Combine all messages
-  const allMessages = [...events, ...commands, ...queries];
-  const messagesBySchemaReference = new Map(
-    allMessages.map((message) => [`${message.collection}:${message.data.id}:${message.data.version}`, message])
-  );
-
-  // Read message schemas from the generated schemas collection.
-  const messagesWithSchemas = await Promise.all(
-    schemaEntries.map(async (schema) => {
-      const message = messagesBySchemaReference.get(
-        `${schema.data.message.collectionName}:${schema.data.message.id}:${schema.data.message.version}`
-      );
-      const schemaPath = schema.data.file || schema.data.source.path || '';
-      const schemaExtension = path.extname(schemaPath).slice(1) || schema.data.format;
-
-      if (message) {
-        try {
-          const enrichedOwners = await enrichOwners(schema.data.message.owners || []);
-
-          return {
-            collection: message.collection,
-            data: {
-              id: message.data.id,
-              name: schema.data.message.name || message.data.name,
-              version: message.data.version,
-              summary: schema.data.message.summary || message.data.summary,
-              schemaPath,
-              producers: message.data.producers || [],
-              consumers: message.data.consumers || [],
-              owners: enrichedOwners,
-            },
-            schemaContent: schema.data.content || '',
-            schemaExtension,
-            examples: getExamplesForResource(message),
-          };
-        } catch (error) {
-          console.error(`Error reading schema metadata for ${message.data.id}:`, error);
-          const enrichedOwners = await enrichOwners(schema.data.message.owners || []);
-          return {
-            collection: message.collection,
-            data: {
-              id: message.data.id,
-              name: schema.data.message.name || schema.data.name || message.data.name,
-              version: message.data.version,
-              summary: schema.data.message.summary || message.data.summary,
-              schemaPath,
-              producers: message.data.producers || [],
-              consumers: message.data.consumers || [],
-              owners: enrichedOwners,
-            },
-            schemaContent: schema.data.content || '',
-            schemaExtension,
-          };
-        }
-      }
-
-      return {
-        collection: schema.data.message.collectionName,
-        data: {
-          id: schema.data.message.id,
-          name: schema.data.message.name || schema.data.name || schema.data.message.id,
-          version: schema.data.message.version,
-          summary: schema.data.message.summary,
-          schemaPath,
-          owners: await enrichOwners(schema.data.message.owners || []),
-          producers: [],
-          consumers: [],
-        },
-        schemaContent: schema.data.content || '',
-        schemaExtension,
-        examples: [],
-      };
-    })
-  );
-
-  // Filter services with specifications and read spec content - only keep essential data
-  const servicesWithSpecs = await Promise.all(
-    services.map(async (service) => {
-      try {
-        const specifications = getSpecificationsForService(service);
-
-        if (specifications.length === 0) {
-          return null;
-        }
-
-        return await Promise.all(
-          specifications.map(async (spec) => {
-            if (!resourceFileExists(service, spec.path)) {
-              return null;
-            }
-
-            const schemaContent = readResourceFile(service, spec.path) ?? '';
-            const schemaExtension = spec.type;
-            const enrichedOwners = await enrichOwners(service.data.owners || []);
-
-            return {
-              collection: 'services',
-              data: {
-                id: `${service.data.id}`,
-                name: `${service.data.name} - ${spec.name}`,
-                version: service.data.version,
-                summary: service.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 service ${service.data.id}:`, error);
-        return null;
-      }
-    })
-  );
-
-  // Flatten and filter out null values
-  const flatServicesWithSpecs = servicesWithSpecs.flat().filter((service) => service !== null);
-
-  // 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);
-
-  // Fetch all data products and extract contracts from outputs
-  const dataProducts = await getDataProducts({ getAllVersions: true });
-
-  // Filter data products with contracts in outputs and read contract content
-  const dataProductsWithContracts = await Promise.all(
-    dataProducts.map(async (dataProduct) => {
-      try {
-        const outputs = dataProduct.data.outputs || [];
-        const outputsWithContracts = outputs.filter((output) => output.contract);
-
-        if (outputsWithContracts.length === 0) {
-          return null;
-        }
-
-        return await Promise.all(
-          outputsWithContracts.map(async (output) => {
-            const contract = output.contract!;
-            if (!resourceFileExists(dataProduct, contract.path)) {
-              return null;
-            }
-
-            const schemaContent = readResourceFile(dataProduct, contract.path) ?? '';
-            const schemaExtension = path.extname(contract.path).slice(1) || 'json';
-            const enrichedOwners = await enrichOwners(dataProduct.data.owners || []);
-
-            return {
-              collection: 'data-products',
-              data: {
-                id: `${dataProduct.data.id}__${contract.path}`,
-                name: contract.name,
-                version: dataProduct.data.version,
-                summary: `Data contract for ${dataProduct.data.name}`,
-                schemaPath: contract.path,
-                owners: enrichedOwners,
-              },
-              schemaContent,
-              schemaExtension,
-              contractType: contract.type,
-              dataProductId: dataProduct.data.id,
-              dataProductVersion: dataProduct.data.version,
-            };
-          })
-        );
-      } catch (error) {
-        console.error(`Error reading contracts for data product ${dataProduct.data.id}:`, error);
-        return null;
-      }
-    })
-  );
-
-  // Flatten and filter out null values for data product contracts
-  const flatDataProductContracts = dataProductsWithContracts.flat().filter((contract) => contract !== null);
-
-  return [...messagesWithSchemas, ...flatServicesWithSpecs, ...flatDomainsWithSpecs, ...flatDataProductContracts];
-}
+import { getSchemaMetadata } from '@utils/schema-explorer';
 
 export class Page extends HybridPage {
   static get prerender(): boolean {
@@ -278,7 +12,7 @@ export class Page extends HybridPage {
       return [];
     }
 
-    const allSchemas = await fetchAllSchemas();
+    const allSchemas = await getSchemaMetadata();
 
     return [
       {
@@ -291,7 +25,7 @@ export class Page extends HybridPage {
   }
 
   protected static async fetchData(_params: any) {
-    const allSchemas = await fetchAllSchemas();
+    const allSchemas = await getSchemaMetadata();
     return {
       schemas: allSchemas,
     };

package/eventcatalog/src/pages/schemas/explorer/content/[key].json.ts

@@ -0,0 +1,17 @@
+import type { APIRoute } from 'astro';
+import { isSSR } from '@utils/feature';
+import { getSchemaRegistry, getSchemaDetails } from '@utils/schema-explorer';
+
+export const prerender = !isSSR();
+
+export async function getStaticPaths() {
+  return [...(await getSchemaRegistry()).keys()].map((key) => ({ params: { key } }));
+}
+
+export const GET: APIRoute = async ({ params }) => {
+  const details = params.key ? await getSchemaDetails(params.key) : undefined;
+  if (!details) return new Response('Schema not found', { status: 404 });
+  return new Response(JSON.stringify(details), {
+    headers: { 'Content-Type': 'application/json' },
+  });
+};

package/eventcatalog/src/utils/schema-explorer.ts

@@ -0,0 +1,276 @@
+import { createHash } from 'node:crypto';
+import type { SchemaItem, SchemaDetails, Producer, Consumer } from '@components/SchemaExplorer/types';
+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 { getDataProducts } from '@utils/collections/data-products';
+import { getOwner } from '@utils/collections/owners';
+import { buildUrl } from '@utils/url-builder';
+import { resourceFileExists, readResourceFile } from '@utils/resource-files';
+import { getExamplesForResource } from '@utils/collections/examples';
+import { getCollection } from 'astro:content';
+import path from 'path';
+
+// Helper function to enrich owners with full details
+async function enrichOwners(ownersRaw: any[]) {
+  if (!ownersRaw || ownersRaw.length === 0) return [];
+
+  const owners = await Promise.all(ownersRaw.map(getOwner));
+  const filteredOwners = owners.filter((o) => o !== undefined);
+
+  return filteredOwners.map((o) => ({
+    id: o.data.id,
+    name: o.data.name,
+    type: o.collection,
+    href: buildUrl(`/docs/${o.collection}/${o.data.id}`),
+  }));
+}
+
+async function buildRegistry() {
+  // Fetch all messages
+  const events = await getEvents({ getAllVersions: true, hydrateServices: false });
+  const commands = await getCommands({ getAllVersions: true, hydrateServices: false });
+  const queries = await getQueries({ getAllVersions: true, hydrateServices: false });
+  const schemaEntries = await getCollection('schemas');
+
+  // Fetch all services
+  const services = await getServices({ getAllVersions: true });
+
+  // Combine all messages
+  const allMessages = [...events, ...commands, ...queries];
+  const messagesBySchemaReference = new Map(
+    allMessages.map((message) => [`${message.collection}:${message.data.id}:${message.data.version}`, message])
+  );
+
+  // Read message schemas from the generated schemas collection.
+  const messagesWithSchemas = await Promise.all(
+    schemaEntries.map(async (schema) => {
+      const message = messagesBySchemaReference.get(
+        `${schema.data.message.collectionName}:${schema.data.message.id}:${schema.data.message.version}`
+      );
+      const schemaPath = schema.data.file || schema.data.source.path || '';
+      const schemaExtension = path.extname(schemaPath).slice(1) || schema.data.format;
+      // The collection types describe raw content references. With
+      // hydrateServices: false, the loaders return compact { id, version } pairs.
+      const producers = (message?.data.producers || []) as unknown as Producer[];
+      const consumers = (message?.data.consumers || []) as unknown as Consumer[];
+
+      return {
+        collection: schema.data.message.collectionName,
+        data: {
+          id: schema.data.message.id,
+          name: schema.data.message.name || message?.data.name || schema.data.name || schema.data.message.id,
+          version: schema.data.message.version,
+          summary: schema.data.message.summary || message?.data.summary,
+          schemaPath,
+          owners: await enrichOwners(schema.data.message.owners || []),
+          // The list shows only the first producer's label; keep this bounded
+          // regardless of how many resources reference the message.
+          producerName: producers[0]?.id,
+        },
+        loadDetails: () => {
+          let examples: SchemaDetails['examples'] = [];
+          if (message) {
+            try {
+              examples = getExamplesForResource(message);
+            } catch (error) {
+              console.error(`Error reading examples for ${message.data.id}:`, error);
+            }
+          }
+          return {
+            schemaContent: schema.data.content || '',
+            examples,
+            data: { producers, consumers },
+          };
+        },
+        schemaExtension,
+      };
+    })
+  );
+
+  // Filter services with specifications and read spec content - only keep essential data
+  const servicesWithSpecs = await Promise.all(
+    services.map(async (service) => {
+      try {
+        const specifications = getSpecificationsForService(service);
+
+        if (specifications.length === 0) {
+          return null;
+        }
+
+        return await Promise.all(
+          specifications.map(async (spec) => {
+            if (!resourceFileExists(service, spec.path)) {
+              return null;
+            }
+
+            const schemaExtension = spec.type;
+            const enrichedOwners = await enrichOwners(service.data.owners || []);
+
+            return {
+              collection: 'services',
+              data: {
+                id: `${service.data.id}`,
+                name: `${service.data.name} - ${spec.name}`,
+                version: service.data.version,
+                summary: service.data.summary,
+                schemaPath: spec.path,
+                owners: enrichedOwners,
+              },
+              loadDetails: () => ({ schemaContent: readResourceFile(service, spec.path) ?? '', examples: [] }),
+              schemaExtension,
+              specType: spec.type,
+              specName: spec.name,
+              specFilenameWithoutExtension: spec.filenameWithoutExtension,
+            };
+          })
+        );
+      } catch (error) {
+        console.error(`Error reading specifications for service ${service.data.id}:`, error);
+        return null;
+      }
+    })
+  );
+
+  // Flatten and filter out null values
+  const flatServicesWithSpecs = servicesWithSpecs.flat().filter((service) => service !== null);
+
+  // 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 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,
+              },
+              loadDetails: () => ({ schemaContent: readResourceFile(domain, spec.path) ?? '', examples: [] }),
+              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);
+
+  // Fetch all data products and extract contracts from outputs
+  const dataProducts = await getDataProducts({ getAllVersions: true });
+
+  // Filter data products with contracts in outputs and read contract content
+  const dataProductsWithContracts = await Promise.all(
+    dataProducts.map(async (dataProduct) => {
+      try {
+        const outputs = dataProduct.data.outputs || [];
+        const outputsWithContracts = outputs.filter((output) => output.contract);
+
+        if (outputsWithContracts.length === 0) {
+          return null;
+        }
+
+        return await Promise.all(
+          outputsWithContracts.map(async (output) => {
+            const contract = output.contract!;
+            if (!resourceFileExists(dataProduct, contract.path)) {
+              return null;
+            }
+
+            const schemaExtension = path.extname(contract.path).slice(1) || 'json';
+            const enrichedOwners = await enrichOwners(dataProduct.data.owners || []);
+
+            return {
+              collection: 'data-products',
+              data: {
+                id: `${dataProduct.data.id}__${contract.path}`,
+                name: contract.name,
+                version: dataProduct.data.version,
+                summary: `Data contract for ${dataProduct.data.name}`,
+                schemaPath: contract.path,
+                owners: enrichedOwners,
+              },
+              loadDetails: () => ({ schemaContent: readResourceFile(dataProduct, contract.path) ?? '', examples: [] }),
+              schemaExtension,
+              contractType: contract.type,
+              dataProductId: dataProduct.data.id,
+              dataProductVersion: dataProduct.data.version,
+            };
+          })
+        );
+      } catch (error) {
+        console.error(`Error reading contracts for data product ${dataProduct.data.id}:`, error);
+        return null;
+      }
+    })
+  );
+
+  // Flatten and filter out null values for data product contracts
+  const flatDataProductContracts = dataProductsWithContracts.flat().filter((contract) => contract !== null);
+
+  return new Map(
+    [...messagesWithSchemas, ...flatServicesWithSpecs, ...flatDomainsWithSpecs, ...flatDataProductContracts].map((entry) => {
+      const { loadDetails, ...item } = entry;
+      const key = createHash('sha256')
+        .update(
+          JSON.stringify([
+            item.collection,
+            item.data.id,
+            item.data.version,
+            item.data.schemaPath,
+            'specType' in item ? item.specType : '',
+          ])
+        )
+        .digest('hex');
+      return [
+        key,
+        { item: { ...item, contentUrl: buildUrl(`/schemas/explorer/content/${key}.json`, true) } as SchemaItem, loadDetails },
+      ];
+    })
+  );
+}
+
+// Share metadata during production rendering; dev rebuilds it to reflect content edits.
+let registry: ReturnType<typeof buildRegistry> | undefined;
+export const getSchemaRegistry = () => {
+  if (import.meta.env.DEV || process.env.DISABLE_EVENTCATALOG_CACHE === 'true') return buildRegistry();
+  return (registry ??= buildRegistry().catch((error) => {
+    registry = undefined;
+    throw error;
+  }));
+};
+export const getSchemaMetadata = async (): Promise<SchemaItem[]> =>
+  [...(await getSchemaRegistry()).values()].map(({ item }) => item);
+export const getSchemaDetails = async (key: string): Promise<SchemaDetails | undefined> =>
+  (await getSchemaRegistry()).get(key)?.loadDetails();

package/package.json

@@ -7,7 +7,7 @@
   },
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",
-  "version": "4.10.9",
+  "version": "4.10.10",
   "publishConfig": {
     "access": "public"
   },
@@ -118,9 +118,9 @@
     "update-notifier": "^7.3.1",
     "uuid": "^11.1.1",
     "zod": "^4.3.6",
-    "@eventcatalog/linter": "1.1.18",
+    "@eventcatalog/sdk": "2.29.0",
     "@eventcatalog/visualiser": "^4.1.4",
-    "@eventcatalog/sdk": "2.29.0"
+    "@eventcatalog/linter": "1.1.18"
   },
   "devDependencies": {
     "@astrojs/check": "^0.9.10",

package/dist/{chunk-A2RZR3U4.js → chunk-6K7XZAYI.js}

@@ -1,9 +1,9 @@
-import {
-  createFileSystemSourceProvider
-} from "./chunk-SDZQJTJW.js";
 import {
   createGitHubSourceProvider
 } from "./chunk-352FGP6W.js";
+import {
+  createFileSystemSourceProvider
+} from "./chunk-SDZQJTJW.js";
 
 // src/federation/source-provider.ts
 var createFederationSourceProvider = (projectDirectory, providers = {}) => {