@eventcatalog/core 3.28.2 → 3.28.4

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

package/dist/analytics/analytics.js

@@ -1,7 +1,7 @@
 import {
   raiseEvent
-} from "../chunk-LVGHWP4C.js";
-import "../chunk-5ZS4S6VX.js";
+} from "../chunk-34MH7O22.js";
+import "../chunk-45JFXFTE.js";
 export {
   raiseEvent
 };

package/dist/analytics/log-build.cjs

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

package/dist/analytics/log-build.js

@@ -1,9 +1,9 @@
 import {
   log_build_default
-} from "../chunk-O4RPLUS4.js";
-import "../chunk-LVGHWP4C.js";
+} from "../chunk-BGEC3Y5J.js";
+import "../chunk-34MH7O22.js";
 import "../chunk-4UVFXLPI.js";
-import "../chunk-5ZS4S6VX.js";
+import "../chunk-45JFXFTE.js";
 import "../chunk-5T63CXKU.js";
 export {
   log_build_default as default

package/dist/{chunk-LVGHWP4C.js → chunk-34MH7O22.js}

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-5ZS4S6VX.js";
+} from "./chunk-45JFXFTE.js";
 
 // src/analytics/analytics.js
 import axios from "axios";

package/dist/{chunk-5ZS4S6VX.js → chunk-45JFXFTE.js}

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

package/dist/{chunk-3LXRFH5D.js → chunk-4FMLF7P3.js}

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

package/dist/{chunk-O4RPLUS4.js → chunk-BGEC3Y5J.js}

@@ -1,6 +1,6 @@
 import {
   raiseEvent
-} from "./chunk-LVGHWP4C.js";
+} from "./chunk-34MH7O22.js";
 import {
   countResources,
   serializeCounts

package/dist/{chunk-7HW6TPKN.js → chunk-TSBHPGIL.js}

@@ -1,6 +1,6 @@
 import {
   logger
-} from "./chunk-3LXRFH5D.js";
+} from "./chunk-4FMLF7P3.js";
 import {
   cleanup,
   getEventCatalogConfigFile

package/dist/constants.cjs

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

package/dist/constants.js

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-5ZS4S6VX.js";
+} from "./chunk-45JFXFTE.js";
 export {
   VERSION
 };

package/dist/eventcatalog.cjs

@@ -114,7 +114,7 @@ var verifyRequiredFieldsAreInCatalogConfigFile = async (projectDirectory) => {
 var import_picocolors = __toESM(require("picocolors"), 1);
 
 // package.json
-var version = "3.28.2";
+var version = "3.28.4";
 
 // 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-O4RPLUS4.js";
-import "./chunk-LVGHWP4C.js";
+} from "./chunk-BGEC3Y5J.js";
+import "./chunk-34MH7O22.js";
 import "./chunk-4UVFXLPI.js";
 import {
   runMigrations
@@ -22,13 +22,13 @@ import {
 } from "./chunk-3KXCGYET.js";
 import {
   generate
-} from "./chunk-7HW6TPKN.js";
+} from "./chunk-TSBHPGIL.js";
 import {
   logger
-} from "./chunk-3LXRFH5D.js";
+} from "./chunk-4FMLF7P3.js";
 import {
   VERSION
-} from "./chunk-5ZS4S6VX.js";
+} from "./chunk-45JFXFTE.js";
 import {
   getEventCatalogConfigFile,
   verifyRequiredFieldsAreInCatalogConfigFile

package/dist/generate.cjs

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

package/dist/generate.js

@@ -1,8 +1,8 @@
 import {
   generate
-} from "./chunk-7HW6TPKN.js";
-import "./chunk-3LXRFH5D.js";
-import "./chunk-5ZS4S6VX.js";
+} from "./chunk-TSBHPGIL.js";
+import "./chunk-4FMLF7P3.js";
+import "./chunk-45JFXFTE.js";
 import "./chunk-5T63CXKU.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.28.2";
+var version = "3.28.4";
 
 // src/constants.ts
 var VERSION = version;

package/dist/utils/cli-logger.js

@@ -1,7 +1,7 @@
 import {
   logger
-} from "../chunk-3LXRFH5D.js";
-import "../chunk-5ZS4S6VX.js";
+} from "../chunk-4FMLF7P3.js";
+import "../chunk-45JFXFTE.js";
 export {
   logger
 };

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

@@ -19,6 +19,18 @@ interface SchemaPropertyProps {
   expand: boolean;
 }
 
+// JSON Schema allows `type` to be a string or an array of strings (e.g. ["object", "null"]).
+// These helpers normalise both forms so the rest of the viewer can treat type checks uniformly.
+function hasType(type: any, candidate: string): boolean {
+  if (Array.isArray(type)) return type.includes(candidate);
+  return type === candidate;
+}
+
+function formatType(type: any): string {
+  if (Array.isArray(type)) return type.join(' | ');
+  return type ?? '';
+}
+
 // Helper function to count properties recursively
 function countProperties(obj: any): number {
   if (!obj || typeof obj !== 'object') return 0;
@@ -196,7 +208,7 @@ function processSchema(schema: any, rootSchema?: any): any {
   }
 
   // Process array items
-  if (schema.type === 'array' && schema.items) {
+  if (hasType(schema.type, 'array') && schema.items) {
     schema = { ...schema, items: processSchema(schema.items, root) };
   }
 
@@ -269,11 +281,11 @@ const SchemaProperty = ({ name, details, isRequired, level, isListItem = false,
     setIsExpanded(expand);
   }, [expand]);
 
-  const hasNestedProperties = details.type === 'object' && details.properties && Object.keys(details.properties).length > 0;
-  const hasArrayItems = details.type === 'array' && details.items;
+  const hasNestedProperties = hasType(details.type, 'object') && details.properties && Object.keys(details.properties).length > 0;
+  const hasArrayItems = hasType(details.type, 'array') && details.items;
   const hasArrayItemProperties =
     hasArrayItems &&
-    ((details.items.type === 'object' && details.items.properties) ||
+    ((hasType(details.items.type, 'object') && details.items.properties) ||
       details.items.allOf ||
       details.items.oneOf ||
       details.items.anyOf ||
@@ -307,8 +319,8 @@ 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">
-                {hasVariants ? (details.variantType === 'anyOf' ? 'anyOf' : 'oneOf') : details.type}
-                {details.type === 'array' && details.items?.type ? `[${details.items.type}]` : ''}
+                {hasVariants ? (details.variantType === 'anyOf' ? 'anyOf' : 'oneOf') : formatType(details.type)}
+                {hasType(details.type, 'array') && details.items?.type ? `[${formatType(details.items.type)}]` : ''}
                 {details.format ? `<${details.format}>` : ''}
                 {details._refPath && (
                   <span className="text-blue-600 dark:text-blue-400 ml-1">→ {details._refName || details._refPath}</span>
@@ -513,9 +525,9 @@ export default function JSONSchemaViewer({
     let display = processedSchema;
     let isArray = false;
 
-    if (processedSchema.type === 'array' && processedSchema.items) {
+    if (hasType(processedSchema.type, 'array') && processedSchema.items) {
       isArray = true;
-      if (processedSchema.items.type === 'object' && processedSchema.items.properties) {
+      if (hasType(processedSchema.items.type, 'object') && processedSchema.items.properties) {
         display = {
           ...processedSchema.items,
           description: processedSchema.description || processedSchema.items.description,
@@ -838,7 +850,9 @@ export default function JSONSchemaViewer({
             <div className="text-[rgb(var(--ec-page-text-muted))] text-sm">
               <p>
                 This array contains items of type:{' '}
-                <span className="font-mono text-blue-600 dark:text-blue-400">{processedSchema.items?.type || 'unknown'}</span>
+                <span className="font-mono text-blue-600 dark:text-blue-400">
+                  {processedSchema.items?.type ? formatType(processedSchema.items.type) : 'unknown'}
+                </span>
               </p>
               {processedSchema.items?.description && (
                 <p className="text-xs mt-2 text-[rgb(var(--ec-page-text-muted))]">{processedSchema.items.description}</p>

package/eventcatalog/src/pages/docs/[type]/[id]/[version]/[docType]/[docId].md.ts

@@ -0,0 +1,75 @@
+// Exposes the raw markdown for a resource doc.
+// Example: /docs/services/OrdersService/1.0.0/adrs/01-some-decision.md
+// Used by llms.txt so LLMs can fetch the markdown directly.
+
+import type { APIRoute } from 'astro';
+import fs from 'fs';
+import { isLLMSTxtEnabled, isResourceDocsEnabled, isSSR } from '@utils/feature';
+import { getResourceDocs, getResourceDocsForResource, type ResourceCollection } from '@utils/collections/resource-docs';
+
+const supportedResourceCollections = new Set<ResourceCollection>([
+  'domains',
+  'services',
+  'events',
+  'commands',
+  'queries',
+  'flows',
+  'containers',
+  'channels',
+  'entities',
+  'data-products',
+]);
+
+export async function getStaticPaths() {
+  if (isSSR() || !isLLMSTxtEnabled() || !isResourceDocsEnabled()) {
+    return [];
+  }
+
+  const docs = await getResourceDocs();
+  const latestDocs = docs.filter((doc) => doc.data.version === doc.data.latestVersion);
+
+  return latestDocs.map((doc) => ({
+    params: {
+      type: doc.data.resourceCollection,
+      id: doc.data.resourceId,
+      version: doc.data.resourceVersion,
+      docType: doc.data.type,
+      docId: doc.data.id,
+    },
+    props: { filePath: doc.filePath },
+  }));
+}
+
+export const GET: APIRoute = async ({ params, props }) => {
+  if (!isLLMSTxtEnabled()) {
+    return new Response('llms.txt is not enabled for this Catalog.', { status: 404 });
+  }
+
+  if (!isResourceDocsEnabled()) {
+    return new Response('Resource docs are not enabled for this Catalog.', { status: 404 });
+  }
+
+  let filePath = (props as { filePath?: string } | undefined)?.filePath;
+
+  if (!filePath && isSSR()) {
+    const type = params.type as ResourceCollection | undefined;
+    if (!type || !supportedResourceCollections.has(type)) {
+      return new Response('Not found', { status: 404 });
+    }
+    const docsForResource = await getResourceDocsForResource(type, params.id ?? '', params.version ?? '');
+    const doc = docsForResource.find(
+      (resourceDoc) =>
+        resourceDoc.data.type === params.docType &&
+        resourceDoc.data.id === params.docId &&
+        resourceDoc.data.version === resourceDoc.data.latestVersion
+    );
+    filePath = doc?.filePath;
+  }
+
+  if (!filePath) {
+    return new Response('Not found', { status: 404 });
+  }
+
+  const file = fs.readFileSync(filePath, 'utf8');
+  return new Response(file, { status: 200, headers: { 'Content-Type': 'text/markdown; charset=utf-8' } });
+};

package/eventcatalog/src/pages/docs/[type]/[id]/[version]/[docType]/[docId].mdx.ts

@@ -0,0 +1,75 @@
+// Exposes the raw mdx for a resource doc.
+// Example: /docs/services/OrdersService/1.0.0/adrs/01-some-decision.mdx
+// Used by llms.txt so LLMs can fetch the markdown directly.
+
+import type { APIRoute } from 'astro';
+import fs from 'fs';
+import { isLLMSTxtEnabled, isResourceDocsEnabled, isSSR } from '@utils/feature';
+import { getResourceDocs, getResourceDocsForResource, type ResourceCollection } from '@utils/collections/resource-docs';
+
+const supportedResourceCollections = new Set<ResourceCollection>([
+  'domains',
+  'services',
+  'events',
+  'commands',
+  'queries',
+  'flows',
+  'containers',
+  'channels',
+  'entities',
+  'data-products',
+]);
+
+export async function getStaticPaths() {
+  if (isSSR() || !isLLMSTxtEnabled() || !isResourceDocsEnabled()) {
+    return [];
+  }
+
+  const docs = await getResourceDocs();
+  const latestDocs = docs.filter((doc) => doc.data.version === doc.data.latestVersion);
+
+  return latestDocs.map((doc) => ({
+    params: {
+      type: doc.data.resourceCollection,
+      id: doc.data.resourceId,
+      version: doc.data.resourceVersion,
+      docType: doc.data.type,
+      docId: doc.data.id,
+    },
+    props: { filePath: doc.filePath },
+  }));
+}
+
+export const GET: APIRoute = async ({ params, props }) => {
+  if (!isLLMSTxtEnabled()) {
+    return new Response('llms.txt is not enabled for this Catalog.', { status: 404 });
+  }
+
+  if (!isResourceDocsEnabled()) {
+    return new Response('Resource docs are not enabled for this Catalog.', { status: 404 });
+  }
+
+  let filePath = (props as { filePath?: string } | undefined)?.filePath;
+
+  if (!filePath && isSSR()) {
+    const type = params.type as ResourceCollection | undefined;
+    if (!type || !supportedResourceCollections.has(type)) {
+      return new Response('Not found', { status: 404 });
+    }
+    const docsForResource = await getResourceDocsForResource(type, params.id ?? '', params.version ?? '');
+    const doc = docsForResource.find(
+      (resourceDoc) =>
+        resourceDoc.data.type === params.docType &&
+        resourceDoc.data.id === params.docId &&
+        resourceDoc.data.version === resourceDoc.data.latestVersion
+    );
+    filePath = doc?.filePath;
+  }
+
+  if (!filePath) {
+    return new Response('Not found', { status: 404 });
+  }
+
+  const file = fs.readFileSync(filePath, 'utf8');
+  return new Response(file, { status: 200, headers: { 'Content-Type': 'text/markdown; charset=utf-8' } });
+};

package/eventcatalog/src/pages/docs/llm/llms-full.txt.ts

@@ -1,7 +1,7 @@
 import { getCollection, type CollectionEntry } from 'astro:content';
 import type { APIRoute } from 'astro';
 import fs from 'fs';
-import { isCustomDocsEnabled } from '@utils/feature';
+import { isCustomDocsEnabled, isResourceDocsEnabled, isLLMSTxtEnabled } from '@utils/feature';
 import { addSchemaToMarkdown } from '@utils/llms';
 
 type AllowedCollections =
@@ -30,8 +30,7 @@ const channels = await getCollection('channels');
 const flows = await getCollection('flows');
 const containers = await getCollection('containers');
 const customDocs = await getCollection('customPages');
-
-import { isLLMSTxtEnabled } from '@utils/feature';
+const resourceDocs = isResourceDocsEnabled() ? await getCollection('resourceDocs') : [];
 
 export const GET: APIRoute = async ({ params, request }) => {
   if (!isLLMSTxtEnabled()) {
@@ -56,6 +55,10 @@ export const GET: APIRoute = async ({ params, request }) => {
     resources.push(...(customDocs as CollectionEntry<AllowedCollections>[]));
   }
 
+  if (isResourceDocsEnabled()) {
+    resources.push(...(resourceDocs as CollectionEntry<AllowedCollections>[]));
+  }
+
   const content = resources
     .map((item) => {
       if (!item.filePath) return '';

package/eventcatalog/src/pages/docs/llm/llms.txt.ts

@@ -2,8 +2,9 @@ import { getCollection } from 'astro:content';
 import config from '@config';
 import type { APIRoute } from 'astro';
 
-import { isCustomDocsEnabled } from '@utils/feature';
+import { isCustomDocsEnabled, isResourceDocsEnabled } from '@utils/feature';
 import { getUbiquitousLanguage } from '@utils/collections/domains';
+import { getResourceDocs } from '@utils/collections/resource-docs';
 
 const events = await getCollection('events');
 const commands = await getCollection('commands');
@@ -22,6 +23,7 @@ const containers = await getCollection('containers');
 const entities = await getCollection('entities');
 
 const customDocs = await getCollection('customPages');
+const resourceDocsList = isResourceDocsEnabled() ? await getResourceDocs() : [];
 
 const ubiquitousLanguages: Record<string, { id: string; version: string; properties: any }[]> = {};
 
@@ -94,6 +96,36 @@ export const GET: APIRoute = async ({ params, request }) => {
   const formatCustomDoc = (item: any, route: string) =>
     `- [${item.data.title}](${baseUrl}/${route}/${item.id.replace('docs\/', '')}.mdx) - ${item.data.summary || ''}`;
 
+  const formatResourceDoc = (doc: any) => {
+    const { resourceCollection, resourceId, resourceVersion, type, id } = doc.data;
+    const title = doc.data.title || id || doc.id;
+    const docUrl = `${baseUrl}/docs/${resourceCollection}/${resourceId}/${resourceVersion}/${type}/${id}.mdx`;
+    return `- [${title}](${docUrl})${doc.data.summary ? ` - ${doc.data.summary}` : ''}`;
+  };
+
+  const renderResourceDocs = () => {
+    const grouped = new Map<string, { resourceCollection: string; resourceId: string; resourceVersion: string; docs: any[] }>();
+
+    for (const doc of resourceDocsList) {
+      const { resourceCollection, resourceId, resourceVersion } = doc.data;
+      const key = `${resourceCollection}:${resourceId}:${resourceVersion}`;
+      let group = grouped.get(key);
+      if (!group) {
+        group = { resourceCollection, resourceId, resourceVersion, docs: [] };
+        grouped.set(key, group);
+      }
+      group.docs.push(doc);
+    }
+
+    return Array.from(grouped.values())
+      .map((group) => {
+        const parentUrl = `${baseUrl}/docs/${group.resourceCollection}/${group.resourceId}/${group.resourceVersion}.mdx`;
+        const heading = `### [${group.resourceId}](${parentUrl}) (${group.resourceCollection})`;
+        return [heading, group.docs.map(formatResourceDoc).join('\n')].join('\n');
+      })
+      .join('\n\n');
+  };
+
   const content = [
     `# ${config.organizationName} EventCatalog Documentation\n`,
     `> ${config.tagline}\n`,
@@ -127,6 +159,7 @@ export const GET: APIRoute = async ({ params, request }) => {
     ...(isCustomDocsEnabled()
       ? ['\n## Custom Docs', customDocs.map((item) => formatCustomDoc(item, 'docs/custom')).join('\n')]
       : []),
+    ...(isResourceDocsEnabled() && resourceDocsList.length > 0 ? ['\n## Resource Docs', renderResourceDocs()] : []),
   ].join('\n');
 
   return new Response(content, {

package/eventcatalog/src/utils/node-graphs/flows-node-graph.ts

@@ -1,6 +1,13 @@
 import { getCollection, type CollectionEntry } from 'astro:content';
 import dagre from 'dagre';
-import { createDagreGraph, calculatedNodes, DEFAULT_NODE_WIDTH, DEFAULT_NODE_HEIGHT } from '@utils/node-graphs/utils/utils';
+import {
+  createDagreGraph,
+  calculatedNodes,
+  DEFAULT_NODE_WIDTH,
+  DEFAULT_NODE_HEIGHT,
+  buildContextMenuForResource,
+  buildContextMenuForService,
+} from '@utils/node-graphs/utils/utils';
 import { MarkerType } from '@xyflow/react';
 import type { Node as NodeType } from '@xyflow/react';
 import { createVersionedMap, findInMap } from '@utils/collections/util';
@@ -101,9 +108,31 @@ export const getNodesAndEdges = async ({ id, defaultFlow, version, mode = 'simpl
       type: step.type,
     } as NodeType;
 
-    if (step.service) node.data.service = { ...step.service, ...step.service.data };
-    if (step.flow) node.data.flow = { ...step.flow, ...step.flow.data };
-    if (step.message) node.data.message = { ...step.message, ...step.message.data };
+    if (step.service) {
+      node.data.service = { ...step.service, ...step.service.data };
+      node.data.contextMenu = buildContextMenuForService({
+        id: step.service.data.id,
+        version: step.service.data.version,
+        specifications: step.service.data.specifications,
+        repository: step.service.data.repository,
+      });
+    }
+    if (step.flow) {
+      node.data.flow = { ...step.flow, ...step.flow.data };
+      node.data.contextMenu = buildContextMenuForResource({
+        collection: 'flows',
+        id: step.flow.data.id,
+        version: step.flow.data.version,
+      });
+    }
+    if (step.message) {
+      node.data.message = { ...step.message, ...step.message.data };
+      node.data.contextMenu = buildContextMenuForResource({
+        collection: step.message.collection,
+        id: step.message.data.id,
+        version: step.message.data.version,
+      });
+    }
     if (step.actor) {
       node.data.actor = { ...step.actor, ...step.actor.data };
       node.data = { ...node.data, ...step.actor };

package/package.json

@@ -7,7 +7,7 @@
   },
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",
-  "version": "3.28.2",
+  "version": "3.28.4",
   "publishConfig": {
     "access": "public"
   },
@@ -103,9 +103,9 @@
     "update-notifier": "^7.3.1",
     "uuid": "^10.0.0",
     "zod": "^4.3.6",
-    "@eventcatalog/linter": "1.0.21",
-    "@eventcatalog/visualiser": "^3.18.3",
-    "@eventcatalog/sdk": "2.20.0"
+    "@eventcatalog/sdk": "2.20.0",
+    "@eventcatalog/visualiser": "^3.18.4",
+    "@eventcatalog/linter": "1.0.21"
   },
   "devDependencies": {
     "@astrojs/check": "^0.9.8",