@eventcatalog/core 3.36.3 → 3.36.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.36.3";
+var version = "3.36.4";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/analytics.js

@@ -1,7 +1,7 @@
 import {
   raiseEvent
-} from "../chunk-4U6TPQGC.js";
-import "../chunk-DTE424XY.js";
+} from "../chunk-HF27CRFY.js";
+import "../chunk-NV7DNZ3X.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.36.3";
+var version = "3.36.4";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/log-build.js

@@ -1,9 +1,9 @@
 import {
   log_build_default
-} from "../chunk-ZE3NM2MH.js";
-import "../chunk-4U6TPQGC.js";
+} from "../chunk-7WJEUZFM.js";
 import "../chunk-4UVFXLPI.js";
-import "../chunk-DTE424XY.js";
+import "../chunk-HF27CRFY.js";
+import "../chunk-NV7DNZ3X.js";
 import "../chunk-5T63CXKU.js";
 export {
   log_build_default as default

package/dist/{chunk-6L5LHQ3C.js → chunk-6JY6QF7D.js}

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

package/dist/{chunk-ZE3NM2MH.js → chunk-7WJEUZFM.js}

@@ -1,10 +1,10 @@
-import {
-  raiseEvent
-} from "./chunk-4U6TPQGC.js";
 import {
   countResources,
   serializeCounts
 } from "./chunk-4UVFXLPI.js";
+import {
+  raiseEvent
+} from "./chunk-HF27CRFY.js";
 import {
   getEventCatalogConfigFile,
   verifyRequiredFieldsAreInCatalogConfigFile

package/dist/{chunk-4U6TPQGC.js → chunk-HF27CRFY.js}

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

package/dist/{chunk-DTE424XY.js → chunk-NV7DNZ3X.js}

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

package/dist/{chunk-SPFT3VTV.js → chunk-XTJ636IF.js}

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

package/dist/constants.cjs

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

package/dist/constants.js

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

package/dist/docs/api/09-flow-api.md

@@ -261,7 +261,45 @@ Flows allow you to create [service nodes](/docs/services). Services link to your
 
 _[See example of Message node in a workflow](https://demo.eventcatalog.dev/visualiser/flows/CancelSubscription/0.0.1)._
 
+#### Container Nodes
 
+<AddedIn version="3.36.3" />
+
+Flows allow you to create [container (data store) nodes](/docs/development/guides/data/introduction). Containers link to your defined data stores in EventCatalog. The container's sidebar will automatically show a "Flows" section linking back to any flow that references it.
+
+```md title="Example"
+---
+  steps:
+    - id: "orders_db"
+      title: "Orders DB"
+      container:
+        id: "orders-db"
+        version: "1.0.0"
+      next_step:
+        id: "next_step"
+        label: "Persist order records"
+---
+```
+
+#### Data Product Nodes
+
+<AddedIn version="3.36.3" />
+
+Flows allow you to create [data product nodes](/docs/development/guides/data-products/introduction). Data products link to your defined data products in EventCatalog. The data product's sidebar will automatically show a "Flows" section linking back to any flow that references it.
+
+```md title="Example"
+---
+  steps:
+    - id: "order_analytics"
+      title: "Order Analytics"
+      dataProduct:
+        id: "order-analytics"
+        version: "1.0.0"
+      next_step:
+        id: "next_step"
+        label: "Prepare fulfillment KPIs"
+---
+```
 
 ## Optional fields {#optional-fields}
 

package/dist/docs/api/11-data-api.md

@@ -235,7 +235,12 @@ Options:
 | `changelog` | `object` | No | An object with a `visible` property to show/hide the changelog button |  
 | `owners` | `object` | No | An object with a `visible` property to show/hide the owners section |  
 | `attachments` | `object` | No | An object with a `visible` property to show/hide the attachments section |  
-| `repository` | `object` | No | An object with a `visible` property to show/hide the repository section |  
+| `repository` | `object` | No | An object with a `visible` property to show/hide the repository section |
+| `flows` | `object` | No | An object with a `visible` property to show/hide the flows section |
+
+**`flows`** <AddedIn version="3.36.3" />
+
+Shows which flows reference this data store as a step. Flows are surfaced automatically when a [flow step](/docs/development/guides/flows/flow-nodes) uses the `container` node type to reference this resource.
 
 ### `attachments` {#attachments}
 

package/dist/docs/development/guides/flows/01-introduction.md

@@ -12,7 +12,7 @@ import AddedIn from '@site/src/components/MDX/AddedIn';
 
 <AddedIn version="2.5.0" />
 
-Flows are a way to document business workflows in your organization. You can reuse your documented resources (e.g services, messages, data stores) in your flows.
+Flows are a way to document business workflows in your organization. You can reuse your documented resources (e.g services, messages, data stores, data products) in your flows.
 
 An example of a flow would be when a user makes a payment to an e-commence system, this interaction triggers many parts of the architecture (services, external services, commands, queries and events):
 

package/dist/docs/development/guides/flows/03-flow-nodes.md

@@ -13,9 +13,7 @@ import AddedIn from '@site/src/components/MDX/AddedIn';
 
 Flow nodes are the building blocks of flows. They are used to represent the different steps in a flow.
 
-With flow nodes you can reference your services, events, commands and queries, external systems, users (actors) or even create your own custom nodes.
-
-EventCatalog (> 2.34.2) you can also reference flows as a node type.
+With flow nodes you can reference your services, events, commands and queries, external systems, users (actors), data stores (containers), data products, or create your own custom nodes.
 
 ## Common step properties
 
@@ -31,7 +29,7 @@ Every flow step (regardless of node type) supports these properties:
 | `next_steps` | [Step reference](#connecting-steps)[] | No | Multiple next steps for branching (cannot be used with `next_step`) |
 
 :::tip Type exclusivity rule
-Each step can only use **one** node type property. You cannot combine `message`, `service`, `flow`, `actor`, `custom`, or `externalSystem` on the same step.
+Each step can only use **one** node type property. You cannot combine `message`, `service`, `flow`, `container`, `dataProduct`, `actor`, `custom`, or `externalSystem` on the same step.
 :::
 
 ## Connecting steps {#connecting-steps}
@@ -67,6 +65,8 @@ next_steps:
 - [message](#message) — Represents an event, command or query resource in EventCatalog
 - [service](#service) — Represents a service resource in EventCatalog
 - [flow](#flow) — Represents a flow in EventCatalog (added in EventCatalog 2.34.2)
+- [container](#container) — Represents a data store (container) resource in EventCatalog
+- [dataProduct](#dataproduct) — Represents a data product resource in EventCatalog
 - [custom](#custom) — A custom node type with configurable title, summary, icon, properties and more
 
 
@@ -202,6 +202,60 @@ Click a flow node in the visualiser to expand the referenced flow's steps inline
 
 ---
 
+### container
+
+<AddedIn version="3.36.3" />
+
+Represents and refers to a data store (container) resource in EventCatalog. When a flow references a container, the container's sidebar automatically shows a "Flows" section linking back to the referencing flow.
+
+#### Container properties
+
+| Property | Type | Required | Description |
+|----------|------|----------|-------------|
+| `id` | `string` | **Yes** | The id of the container in your catalog |
+| `version` | `string` | No | The version to reference (defaults to `latest`) |
+
+```yml
+steps:
+  - id: "orders_db"
+    title: "Orders DB"
+    container:
+      id: "orders-db"
+      version: "1.0.0"
+    next_step:
+      id: "next_step"
+      label: "Persist order records"
+```
+
+---
+
+### dataProduct
+
+<AddedIn version="3.36.3" />
+
+Represents and refers to a data product resource in EventCatalog. When a flow references a data product, the data product's sidebar automatically shows a "Flows" section linking back to the referencing flow.
+
+#### Data product properties
+
+| Property | Type | Required | Description |
+|----------|------|----------|-------------|
+| `id` | `string` | **Yes** | The id of the data product in your catalog |
+| `version` | `string` | No | The version to reference (defaults to `latest`) |
+
+```yml
+steps:
+  - id: "order_analytics"
+    title: "Order Analytics"
+    dataProduct:
+      id: "order-analytics"
+      version: "1.0.0"
+    next_step:
+      id: "next_step"
+      label: "Prepare fulfillment KPIs"
+```
+
+---
+
 ### custom
 
 <AddedIn version="2.30.6" />

package/dist/eventcatalog.cjs

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

package/dist/eventcatalog.js

@@ -1,7 +1,7 @@
 import {
-  runMigrations
-} from "./chunk-XUAF2H54.js";
-import "./chunk-CA4U2JP7.js";
+  log_build_default
+} from "./chunk-7WJEUZFM.js";
+import "./chunk-4UVFXLPI.js";
 import {
   resolve_catalog_dependencies_default
 } from "./chunk-WAJIJEI3.js";
@@ -12,10 +12,10 @@ import {
   watch
 } from "./chunk-K3ZVEX2Y.js";
 import {
-  log_build_default
-} from "./chunk-ZE3NM2MH.js";
-import "./chunk-4U6TPQGC.js";
-import "./chunk-4UVFXLPI.js";
+  runMigrations
+} from "./chunk-XUAF2H54.js";
+import "./chunk-CA4U2JP7.js";
+import "./chunk-HF27CRFY.js";
 import {
   catalogToAstro
 } from "./chunk-YDXB3BD2.js";
@@ -28,13 +28,13 @@ import {
 } from "./chunk-ULZYHF3V.js";
 import {
   generate
-} from "./chunk-6L5LHQ3C.js";
+} from "./chunk-6JY6QF7D.js";
 import {
   logger
-} from "./chunk-SPFT3VTV.js";
+} from "./chunk-XTJ636IF.js";
 import {
   VERSION
-} from "./chunk-DTE424XY.js";
+} from "./chunk-NV7DNZ3X.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.36.3";
+var version = "3.36.4";
 
 // src/constants.ts
 var VERSION = version;

package/dist/generate.js

@@ -1,8 +1,8 @@
 import {
   generate
-} from "./chunk-6L5LHQ3C.js";
-import "./chunk-SPFT3VTV.js";
-import "./chunk-DTE424XY.js";
+} from "./chunk-6JY6QF7D.js";
+import "./chunk-XTJ636IF.js";
+import "./chunk-NV7DNZ3X.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.36.3";
+var version = "3.36.4";
 
 // src/constants.ts
 var VERSION = version;

package/dist/utils/cli-logger.js

@@ -1,7 +1,7 @@
 import {
   logger
-} from "../chunk-SPFT3VTV.js";
-import "../chunk-DTE424XY.js";
+} from "../chunk-XTJ636IF.js";
+import "../chunk-NV7DNZ3X.js";
 export {
   logger
 };

package/eventcatalog/src/components/MDX/Flow/Flow.astro

@@ -6,10 +6,15 @@ import AstroNodeGraph from '../NodeGraph/AstroNodeGraph';
 import { getVersionFromCollection } from '@utils/collections/versions';
 import { isVisualiserEnabled, isEventCatalogChatEnabled, isDevMode } from '@utils/feature';
 import { loadSavedLayout, applyLayoutToNodes, buildResourceKey } from '@utils/node-graphs/layout-persistence';
+import { randomUUID } from 'node:crypto';
+import { parseMdxBooleanProp } from '@utils/markdown';
 
 const isChatEnabled = isEventCatalogChatEnabled();
 
-const { id, version = 'latest', maxHeight, includeKey = true, mode = 'simple', walkthrough = true, search = true } = Astro.props;
+const { id, version = 'latest', maxHeight, mode = 'simple' } = Astro.props;
+const includeKey = parseMdxBooleanProp(Astro.props.legend ?? Astro.props.includeKey, true);
+const search = parseMdxBooleanProp(Astro.props.search, false);
+const walkthrough = parseMdxBooleanProp(Astro.props.walkthrough, false);
 
 // Find the flow for the given id and version
 const flows = await getFlows();
@@ -28,6 +33,7 @@ const { nodes, edges } = await getNodesAndEdges({
 const resourceKey = buildResourceKey('flows', id, flow.data.version);
 const savedLayout = await loadSavedLayout(resourceKey);
 const nodesWithLayout = applyLayoutToNodes(nodes, savedLayout);
+const portalId = `${id}-${flow.data.version}-flow-${randomUUID()}-portal`;
 ---
 
 {
@@ -45,7 +51,7 @@ const nodesWithLayout = applyLayoutToNodes(nodes, savedLayout);
 
 <div
   class="h-[30em] my-6 mb-12 w-full relative border border-[rgb(var(--ec-page-border))] rounded-md"
-  id={`${id}-portal`}
+  id={portalId}
   style={{
     maxHeight: maxHeight ? `${maxHeight}em` : `30em`,
   }}
@@ -57,12 +63,10 @@ const nodesWithLayout = applyLayoutToNodes(nodes, savedLayout);
     id={id}
     nodes={nodesWithLayout}
     edges={edges}
-    hrefLabel={'View in visualizer'}
-    href={isVisualiserEnabled() ? `/visualiser/flows/${id}/${version}` : undefined}
-    linkTo={'visualiser'}
+    mode={mode}
     includeKey={includeKey}
-    footerLabel=`Flow diagram - ${flow.data.name} - v(${flow.data.version})`
     client:only="react"
+    portalId={portalId}
     showFlowWalkthrough={walkthrough}
     showSearch={search}
     isChatEnabled={isChatEnabled}

package/eventcatalog/src/enterprise/custom-documentation/pages/docs/custom/index.astro

@@ -9,7 +9,7 @@ import mdxComponents from '@components/MDX/components';
 import { getOwner } from '@utils/collections/owners';
 import { buildUrl, buildEditUrlForResource } from '@utils/url-builder';
 import { resourceToCollectionMap } from '@utils/collections/util';
-import { getMDXComponentsByName } from '@utils/markdown';
+import { getMDXComponentsByName, parseMdxBooleanProp } from '@utils/markdown';
 import { getAdjacentPages, getNavigationItems } from '@enterprise/custom-documentation/utils/custom-docs';
 import CustomDocsNav from '@enterprise/custom-documentation/components/CustomDocsNav/CustomDocsNav.astro';
 import NodeGraph from '@components/MDX/NodeGraph/NodeGraph.astro';
@@ -22,7 +22,10 @@ const doc = props.data;
 const { Content, headings } = await render(props as any);
 const currentSlug = props.id;
 
-const nodeGraphs = getMDXComponentsByName(props.body, 'NodeGraph') || [];
+const nodeGraphs =
+  getMDXComponentsByName(props.body, 'NodeGraph')?.filter((nodeGraph: any) => {
+    return nodeGraph.id && nodeGraph.version && nodeGraph.type;
+  }) || [];
 
 const { prev, next } = await getAdjacentPages(currentSlug);
 
@@ -152,8 +155,10 @@ const editUrl =
                     version={nodeGraph.version}
                     collection={collection}
                     title={nodeGraph.title}
-                    mode="simple"
+                    mode={nodeGraph.mode || 'simple'}
                     linksToVisualiser={true}
+                    showSearch={parseMdxBooleanProp(nodeGraph.search, true)}
+                    showLegend={parseMdxBooleanProp(nodeGraph.legend, true)}
                     href={
                       isVisualiserEnabled()
                         ? {

package/eventcatalog/src/pages/docs/[type]/[id]/[version]/index.astro

@@ -43,7 +43,7 @@ import {
   isRSSEnabled,
   isExportPDFEnabled,
 } from '@utils/feature';
-import { getMDXComponentsByName } from '@utils/markdown';
+import { getMDXComponentsByName, parseMdxBooleanProp } from '@utils/markdown';
 
 import type { CollectionTypes } from '@types';
 
@@ -265,10 +265,40 @@ const generatePromptForResource = (props: any) => {
 };
 
 // Handle node graphs in the markdown
-let nodeGraphs = getMDXComponentsByName(props.body || '', 'NodeGraph') || [];
+const currentPageNodeGraph = {
+  id: props.data.id,
+  version: props.data.version,
+  type: collectionToResourceMap[props.collection as keyof typeof collectionToResourceMap],
+};
+
+let nodeGraphs =
+  getMDXComponentsByName(props.body || '', 'NodeGraph')?.map((nodeGraph: any) => {
+    const graph = nodeGraph.id === undefined ? { ...currentPageNodeGraph, ...nodeGraph } : nodeGraph;
+
+    return {
+      ...graph,
+      search: parseMdxBooleanProp(nodeGraph.search, true),
+      legend: parseMdxBooleanProp(nodeGraph.legend, true),
+    };
+  }) || [];
+const flowEmbeds = getMDXComponentsByName(props.body || '', 'Flow') || [];
 
 // Get props for the node graph (when no id is passed, we assume its the current page)
-const nodeGraphPropsForPage = nodeGraphs.find((nodeGraph: any) => nodeGraph.id === undefined) || ({} as any);
+const hasCurrentFlowEmbed =
+  props.collection === 'flows' &&
+  flowEmbeds.some((flowEmbed: any) => {
+    const flowId = flowEmbed.id;
+    const flowVersion = flowEmbed.version || 'latest';
+
+    return flowId === props.data.id && (flowVersion === 'latest' || flowVersion === props.data.version);
+  });
+const hasCurrentPageNodeGraph = nodeGraphs.some((nodeGraph: any) => {
+  return (
+    nodeGraph.id === currentPageNodeGraph.id &&
+    nodeGraph.version === currentPageNodeGraph.version &&
+    nodeGraph.type === currentPageNodeGraph.type
+  );
+});
 
 const shouldRenderVersionList =
   shouldRenderSideBarSection(props, 'versions') && props.data.versions && props.data.versions.length > 1;
@@ -287,15 +317,14 @@ const httpMethodStyle = httpOperation?.method
   ? httpMethodColors[httpOperation.method.toUpperCase()] || { background: '#6b7280', color: '#ffffff' }
   : undefined;
 
-// This will render the graph for this page
-nodeGraphs.push({
-  id: props.data.id,
-  version: props.data.version,
-  type: collectionToResourceMap[props.collection as keyof typeof collectionToResourceMap],
-  ...nodeGraphPropsForPage,
-  search: nodeGraphPropsForPage?.search ? nodeGraphPropsForPage.search === 'true' : true,
-  legend: nodeGraphPropsForPage?.legend ? nodeGraphPropsForPage.legend === 'true' : true,
-});
+// This will render the graph for this page. Flow pages can already render their graph explicitly via <Flow />.
+if (!hasCurrentFlowEmbed && !hasCurrentPageNodeGraph) {
+  nodeGraphs.push({
+    ...currentPageNodeGraph,
+    search: true,
+    legend: true,
+  });
+}
 ---
 
 <VerticalSideBarLayout title={pageTitle} description={props.data.summary}>

package/eventcatalog/src/utils/markdown.ts

@@ -2,15 +2,15 @@
 // rarely used, but useful for components that need to know how many times
 // the user wants to render a component in a markdown file
 export const getMDXComponentsByName = (document: string, componentName: string) => {
-  // Define regex pattern to match <SchemaViewer ... />
-  const pattern = new RegExp(`<${componentName}\\s+([^>]*)\\/>`, 'g');
+  // Define regex pattern to match self-closing MDX components with or without props.
+  const pattern = new RegExp(`<${componentName}(\\s+[^>]*)?\\s*\\/>`, 'g');
 
   // Find all matches of the pattern
   const matches = [...document.matchAll(pattern)];
 
   // Extract the properties of each SchemaViewer
   const components = matches.map((match) => {
-    const propsString = match[1];
+    const propsString = match[1] || '';
     const props = {};
 
     // Use regex to extract key-value pairs from propsString
@@ -28,3 +28,8 @@ export const getMDXComponentsByName = (document: string, componentName: string)
 
   return components;
 };
+
+export const parseMdxBooleanProp = (value: unknown, defaultValue: boolean) => {
+  if (value === undefined) return defaultValue;
+  return value === true || value === 'true';
+};

package/package.json

@@ -7,7 +7,7 @@
   },
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",
-  "version": "3.36.3",
+  "version": "3.36.4",
   "publishConfig": {
     "access": "public"
   },
@@ -107,7 +107,7 @@
     "uuid": "^10.0.0",
     "zod": "^4.3.6",
     "@eventcatalog/linter": "1.0.23",
-    "@eventcatalog/visualiser": "^3.20.2",
+    "@eventcatalog/visualiser": "^3.20.3",
     "@eventcatalog/sdk": "2.21.1"
   },
   "devDependencies": {