@eventcatalog/core 3.12.8 → 3.13.0-beta.1

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.12.8";
+var version = "3.13.0-beta.1";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/analytics.js

@@ -1,7 +1,7 @@
 import {
   raiseEvent
-} from "../chunk-6MBAYHHT.js";
-import "../chunk-ROHEB5DM.js";
+} from "../chunk-NXATPLVB.js";
+import "../chunk-VXTATPGX.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.12.8";
+var version = "3.13.0-beta.1";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/log-build.js

@@ -1,9 +1,9 @@
 import {
   log_build_default
-} from "../chunk-JUWMXGCI.js";
-import "../chunk-6MBAYHHT.js";
+} from "../chunk-V3GX7FC3.js";
+import "../chunk-NXATPLVB.js";
 import "../chunk-4UVFXLPI.js";
-import "../chunk-ROHEB5DM.js";
+import "../chunk-VXTATPGX.js";
 import "../chunk-UPONRQSN.js";
 export {
   log_build_default as default

package/dist/{chunk-DINAMVEI.js → chunk-7RCUF3VG.js}

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

package/dist/{chunk-GOLMKUV3.js → chunk-AY2OEUWV.js}

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

package/dist/{chunk-6MBAYHHT.js → chunk-NXATPLVB.js}

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

package/dist/{chunk-JUWMXGCI.js → chunk-V3GX7FC3.js}

@@ -1,6 +1,6 @@
 import {
   raiseEvent
-} from "./chunk-6MBAYHHT.js";
+} from "./chunk-NXATPLVB.js";
 import {
   countResources,
   serializeCounts

package/dist/{chunk-ROHEB5DM.js → chunk-VXTATPGX.js}

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

package/dist/constants.js

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-ROHEB5DM.js";
+} from "./chunk-VXTATPGX.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.12.8";
+var version = "3.13.0-beta.1";
 
 // 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-JUWMXGCI.js";
-import "./chunk-6MBAYHHT.js";
+} from "./chunk-V3GX7FC3.js";
+import "./chunk-NXATPLVB.js";
 import "./chunk-4UVFXLPI.js";
 import {
   runMigrations
@@ -22,13 +22,13 @@ import {
 } from "./chunk-5VBIXL6C.js";
 import {
   generate
-} from "./chunk-GOLMKUV3.js";
+} from "./chunk-AY2OEUWV.js";
 import {
   logger
-} from "./chunk-DINAMVEI.js";
+} from "./chunk-7RCUF3VG.js";
 import {
   VERSION
-} from "./chunk-ROHEB5DM.js";
+} from "./chunk-VXTATPGX.js";
 import {
   verifyRequiredFieldsAreInCatalogConfigFile
 } from "./chunk-UPONRQSN.js";

package/dist/generate.cjs

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

package/dist/generate.js

@@ -1,8 +1,8 @@
 import {
   generate
-} from "./chunk-GOLMKUV3.js";
-import "./chunk-DINAMVEI.js";
-import "./chunk-ROHEB5DM.js";
+} from "./chunk-AY2OEUWV.js";
+import "./chunk-7RCUF3VG.js";
+import "./chunk-VXTATPGX.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.12.8";
+var version = "3.13.0-beta.1";
 
 // src/constants.ts
 var VERSION = version;

package/dist/utils/cli-logger.js

@@ -1,7 +1,7 @@
 import {
   logger
-} from "../chunk-DINAMVEI.js";
-import "../chunk-ROHEB5DM.js";
+} from "../chunk-7RCUF3VG.js";
+import "../chunk-VXTATPGX.js";
 export {
   logger
 };

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

@@ -3,7 +3,7 @@ const { file: designPath, filePath, search = true, title } = Astro.props;
 import fs from 'fs';
 import { getAbsoluteFilePathForAstroFile } from '@utils/files';
 import Admonition from '@components/MDX/Admonition';
-import NodeGraph from '../NodeGraph/NodeGraph';
+import AstroNodeGraph from '../NodeGraph/AstroNodeGraph';
 
 import { isVisualiserEnabled, isEventCatalogChatEnabled, isDevMode } from '@utils/feature';
 import { loadSavedLayout, applyLayoutToNodes, buildResourceKey } from '@utils/node-graphs/layout-persistence';
@@ -54,7 +54,7 @@ const nodesWithLayout = design ? applyLayoutToNodes(design.nodes || [], savedLay
       />
 
       <div>
-        <NodeGraph
+        <AstroNodeGraph
           id={id}
           title={title ?? design.name}
           nodes={nodesWithLayout}

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

@@ -2,7 +2,7 @@
 import { getDomains } from '@utils/collections/domains';
 import { getNodesAndEdges } from '@utils/node-graphs/domain-entity-map.ts';
 import Admonition from '@components/MDX/Admonition';
-import NodeGraph from '../NodeGraph/NodeGraph';
+import AstroNodeGraph from '../NodeGraph/AstroNodeGraph';
 import { getVersionFromCollection } from '@utils/collections/versions';
 import { getServices } from '@utils/collections/services';
 import { isEventCatalogChatEnabled, isDevMode } from '@utils/feature';
@@ -70,7 +70,7 @@ const nodesWithLayout = applyLayoutToNodes(nodes as any[], savedLayout);
 </div>
 
 <div>
-  <NodeGraph
+  <AstroNodeGraph
     id={id}
     nodes={nodesWithLayout}
     edges={edges}

package/eventcatalog/src/components/MDX/File.tsx

@@ -1,12 +1,12 @@
-import fs from 'fs';
-import path from 'path';
+import { resourceFileExists, readResourceFile, getResourceFilePath } from '@utils/resource-files';
 
-const File = ({ file, catalog, title }: any) => {
+const File = ({ file, filePath, title }: any) => {
   try {
-    const exists = fs.existsSync(path.join(catalog.filePath, file));
+    const item = { filePath };
+    const exists = resourceFileExists(item, file);
 
     if (exists) {
-      const text = fs.readFileSync(path.join(catalog.filePath, file), 'utf-8');
+      const text = readResourceFile(item, file);
       return (
         <div className="not-prose">
           <pre className="expressive-code" data-language="json">
@@ -23,7 +23,7 @@ const File = ({ file, catalog, title }: any) => {
                 </code>
               </pre>
               <div className="copy">
-                <button title="Copy to clipboard" data-copied="Copied!" data-code={text}>
+                <button title="Copy to clipboard" data-copied="Copied!" data-code={text ?? ''}>
                   <div></div>
                 </button>
               </div>
@@ -32,7 +32,7 @@ const File = ({ file, catalog, title }: any) => {
         </div>
       );
     } else {
-      return <div className="italic">Tried to load file from {path.join(catalog.filePath, file)}, but no file can be found</div>;
+      return <div className="italic">Tried to load file from {getResourceFilePath(item, file)}, but no file can be found</div>;
     }
   } catch (error) {
     console.log('Failed to load file', error);

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

@@ -2,7 +2,7 @@
 import { getFlows } from '@utils/collections/flows';
 import { getNodesAndEdges } from '@utils/node-graphs/flows-node-graph';
 import Admonition from '@components/MDX/Admonition';
-import NodeGraph from '../NodeGraph/NodeGraph';
+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';
@@ -53,7 +53,7 @@ const nodesWithLayout = applyLayoutToNodes(nodes, savedLayout);
 </div>
 
 <div>
-  <NodeGraph
+  <AstroNodeGraph
     id={id}
     nodes={nodesWithLayout}
     edges={edges}

package/eventcatalog/src/components/MDX/NodeGraph/AstroNodeGraph.tsx

@@ -0,0 +1,104 @@
+/**
+ * Astro adapter for @eventcatalog/visualiser
+ *
+ * This component wraps the framework-agnostic NodeGraph from @eventcatalog/visualiser
+ * and provides Astro-specific integration including:
+ * - Navigation using Astro's navigate function
+ * - Layout persistence via Astro API routes
+ * - URL building with Astro's URL utilities
+ */
+
+import { useCallback } from 'react';
+import { NodeGraph } from '@eventcatalog/visualiser';
+import '@eventcatalog/visualiser/styles.css';
+import type { Node, Edge } from '@xyflow/react';
+
+interface AstroNodeGraphProps {
+  id: string;
+  nodes: Node[];
+  edges: Edge[];
+  title?: string;
+  href?: string;
+  hrefLabel?: string;
+  linkTo?: 'docs' | 'visualiser';
+  includeKey?: boolean;
+  footerLabel?: string;
+  linksToVisualiser?: boolean;
+  links?: { label: string; url: string }[];
+  mode?: 'full' | 'simple';
+  portalId?: string;
+  showFlowWalkthrough?: boolean;
+  showSearch?: boolean;
+  zoomOnScroll?: boolean;
+  designId?: string;
+  isChatEnabled?: boolean;
+  maxTextSize?: number;
+  isDevMode?: boolean;
+  resourceKey?: string;
+}
+
+const AstroNodeGraph = ({ isDevMode = false, resourceKey, ...otherProps }: AstroNodeGraphProps) => {
+  // Astro-specific navigation handler
+  const handleNavigate = useCallback((url: string) => {
+    // Use window.location for navigation since we can't import astro:transitions/client in a React component
+    window.location.href = url;
+  }, []);
+
+  // Astro-specific URL builder
+  const handleBuildUrl = useCallback((path: string) => {
+    // Simple URL builder - just return the path as-is
+    // The consuming app (core) should handle base URLs if needed
+    return path;
+  }, []);
+
+  // Layout persistence: Save layout to Astro API route
+  const handleSaveLayout = useCallback(
+    async (key: string, positions: Record<string, { x: number; y: number }>): Promise<boolean> => {
+      if (!key) return false;
+
+      try {
+        const response = await fetch('/api/dev/visualizer-layout/save', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ resourceKey: key, positions }),
+        });
+        const result = await response.json();
+        return result.success === true;
+      } catch {
+        return false;
+      }
+    },
+    []
+  );
+
+  // Layout persistence: Reset layout via Astro API route
+  const handleResetLayout = useCallback(async (key: string): Promise<boolean> => {
+    if (!key) return false;
+
+    try {
+      const response = await fetch('/api/dev/visualizer-layout/reset', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ resourceKey: key }),
+      });
+      const result = await response.json();
+      return result.success === true;
+    } catch {
+      return false;
+    }
+  }, []);
+
+  return (
+    <NodeGraph
+      {...otherProps}
+      resourceKey={resourceKey}
+      isDevMode={isDevMode}
+      onNavigate={handleNavigate}
+      onBuildUrl={handleBuildUrl}
+      onSaveLayout={handleSaveLayout}
+      onResetLayout={handleResetLayout}
+    />
+  );
+};
+
+export default AstroNodeGraph;

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

@@ -1,5 +1,5 @@
 ---
-import NodeGraphNew from './NodeGraph';
+import AstroNodeGraph from './AstroNodeGraph';
 import { getNodesAndEdges as getNodesAndEdgesForService } from '@utils/node-graphs/services-node-graph';
 import {
   getNodesAndEdgesForCommands,
@@ -148,7 +148,7 @@ const nodesWithLayout = applyLayoutToNodes(nodes as any[], savedLayout);
 ---
 
 <div>
-  <NodeGraphNew
+  <AstroNodeGraph
     id={id}
     nodes={nodesWithLayout}
     edges={edges}

package/eventcatalog/src/components/MDX/NodeGraph/README.md

@@ -0,0 +1,85 @@
+# NodeGraph - Astro Adapter for @eventcatalog/visualiser
+
+## Overview
+
+This directory contains the Astro-specific adapter for the `@eventcatalog/visualiser` package. The visualiser package is framework-agnostic, and this adapter provides Astro-specific integrations.
+
+## Components
+
+### AstroNodeGraph.tsx
+
+The main adapter component that wraps the `NodeGraph` from `@eventcatalog/visualiser` and provides:
+
+- **Navigation**: Uses Astro's `navigate` function from `astro:transitions/client`
+- **URL Building**: Uses Astro's `buildUrl` utility for consistent URL generation
+- **Layout Persistence**: Integrates with Astro API routes for saving/resetting custom node layouts (dev mode only)
+  - `/api/dev/visualiser-layout/save` - Saves node positions
+  - `/api/dev/visualiser-layout/reset` - Resets node positions to defaults
+
+### NodeGraph.astro
+
+The Astro component that serves as the entry point for rendering node graphs. It:
+- Fetches nodes and edges based on the collection type (services, events, domains, etc.)
+- Applies saved layout positions when available (dev mode feature)
+- Renders the `AstroNodeGraph` component with `client:only="react"`
+
+### NodeGraphPortal.tsx
+
+A simple portal component that creates the DOM container where the React component will render. Used by MDX components to embed node graphs in documentation.
+
+## Usage
+
+### In Astro Pages
+
+```astro
+---
+import NodeGraph from '@components/MDX/NodeGraph/NodeGraph.astro';
+---
+
+<div id="my-graph-portal"></div>
+<NodeGraph
+  id="my-graph"
+  collection="services"
+  version="1.0.0"
+  mode="full"
+  linkTo="visualiser"
+/>
+```
+
+### In MDX Content
+
+```mdx
+<NodeGraph id="my-service" collection="services" version="1.0.0" />
+```
+
+## Integration with @eventcatalog/visualiser
+
+The `AstroNodeGraph` component directly uses the `NodeGraph` component from `@eventcatalog/visualiser` and provides the framework-specific callbacks:
+
+```typescript
+<NodeGraph
+  {...props}
+  onNavigate={handleNavigate}
+  onBuildUrl={handleBuildUrl}
+  onSaveLayout={handleSaveLayout}
+  onResetLayout={handleResetLayout}
+/>
+```
+
+### Known Limitations
+
+Currently, the `onSaveLayout` and `onResetLayout` callbacks are passed through with a `@ts-expect-error` comment because the visualiser package's outer `NodeGraph` component doesn't expose these props in its TypeScript interface, even though the internal `NodeGraphBuilder` component does accept them.
+
+**TODO**: Update the `@eventcatalog/visualiser` package to expose `onSaveLayout` and `onResetLayout` in the `NodeGraphProps` interface and forward them to `NodeGraphBuilder`.
+
+## Migration Notes
+
+This adapter replaces the old monolithic `NodeGraph.tsx` component that was previously in this directory. The old component has been:
+- Refactored into the framework-agnostic `@eventcatalog/visualiser` package
+- Wrapped by this new `AstroNodeGraph` adapter for Astro-specific integrations
+
+Benefits of this architecture:
+- The visualiser can be used in other frameworks (Next.js, Remix, etc.)
+- Astro-specific concerns are isolated to this adapter
+- Easier to test and maintain
+- Clear separation of concerns

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

@@ -1,20 +1,17 @@
 ---
 import fs from 'fs';
-import path from 'path';
 import { Code } from 'astro-expressive-code/components';
 import { getAbsoluteFilePathForAstroFile } from '@utils/files';
+import { getResourceFilePath } from '@utils/resource-files';
 
 interface Props {
   file?: string;
-  catalog: {
-    filePath: string;
-  };
   title?: string;
   filePath: string;
   lang?: string;
 }
 
-const { file = 'schema.json', catalog, title, filePath, lang = 'json' } = Astro.props;
+const { file = 'schema.json', title, filePath, lang = 'json' } = Astro.props;
 
 let code: string | null = null;
 
@@ -32,6 +29,6 @@ if (exists) {
       <Code code={code} title={title || file} lang={lang} />
     </div>
   ) : (
-    <div class="italic">Tried to load schema from {path.join(catalog.filePath, file)}, but no schema can be found</div>
+    <div class="italic">Tried to load schema from {getResourceFilePath({ filePath }, file)}, but no schema can be found</div>
   )
 }

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

@@ -564,13 +564,8 @@ nodeGraphs.push({
       }
     </style>
 
-    <script define:vars={{ props, config }}>
-      // Fix to pass information to componets that are client side only
-      // and require catalog information
+    <script define:vars={{ config }}>
       window.eventcatalog = {};
-      // @ts-ignore
-      window.eventcatalog[`${props.collection}-${props.data.id}`] = props.catalog;
-
       window.eventcatalog.mermaid = config.mermaid;
     </script>
 

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

@@ -17,7 +17,7 @@ export const getStaticPaths = Page.getStaticPaths;
 const props = await Page.getData(Astro);
 
 // @ts-ignore
-const { collection, data, catalog, filePath, filename, path: relativeSpecPath } = props;
+const { collection, data, filePath, filename, path: relativeSpecPath } = props;
 const fileName = filename || 'openapi.yml';
 
 const pathToSpec = getAbsoluteFilePathForAstroFile(filePath, fileName);
@@ -59,7 +59,7 @@ if (isRemote) {
         <DocumentMinusIcon className="mx-auto h-12 w-12 text-gray-400" />
         <h3 class="mt-2 text-sm font-semibold text-gray-900">No OpenAPI spec file found</h3>
         <p class="mt-1 text-xs text-gray-400">
-          Could not find OpenAPI file for {data.name} in {`/${catalog.path}`}
+          Could not find OpenAPI file for {data.name} in {`/${collection}/${data.id}`}
         </p>
       </div>
     ) : (

package/eventcatalog/src/pages/visualiser/designs/[id]/index.astro

@@ -1,5 +1,5 @@
 ---
-import NodeGraph from '@components/MDX/NodeGraph/NodeGraph';
+import AstroNodeGraph from '@components/MDX/NodeGraph/AstroNodeGraph';
 import { ClientRouter } from 'astro:transitions';
 import VerticalSideBarLayout from '@layouts/VerticalSideBarLayout.astro';
 import { isEventCatalogChatEnabled } from '@utils/feature';
@@ -20,7 +20,7 @@ const { data } = props;
   <div class="bg-gray-100/50 m-4">
     <div class="h-[calc(100vh-130px)] w-full relative border border-gray-200" id={`${data.id}-portal`} transition:animate="fade">
     </div>
-    <NodeGraph
+    <AstroNodeGraph
       id={data.id}
       nodes={data.nodes}
       edges={data.edges}

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

@@ -1,21 +1,11 @@
 import { getCollection } from 'astro:content';
 import type { CollectionEntry } from 'astro:content';
-import path from 'path';
 import { getItemsFromCollectionByIdAndSemverOrLatest, createVersionedMap, satisfies } from './util';
 import type { CollectionMessageTypes } from '@types';
-import utils from '@eventcatalog/sdk';
 
-const PROJECT_DIR = process.env.PROJECT_DIR || process.cwd();
 const CACHE_ENABLED = process.env.DISABLE_EVENTCATALOG_CACHE !== 'true';
 
-type Channel = CollectionEntry<'channels'> & {
-  catalog: {
-    path: string;
-    filePath: string;
-    type: string;
-    publicPath: string;
-  };
-};
+type Channel = CollectionEntry<'channels'>;
 
 interface Props {
   getAllVersions?: boolean;
@@ -74,8 +64,6 @@ export const getChannels = async ({ getAllVersions = true }: Props = {}): Promis
     return true;
   });
 
-  const { getResourceFolderName } = utils(process.env.PROJECT_DIR ?? '');
-
   // 5. Enrich channels
   const processedChannels = await Promise.all(
     targetChannels.map(async (channel) => {
@@ -105,13 +93,6 @@ export const getChannels = async ({ getAllVersions = true }: Props = {}): Promis
         };
       });
 
-      const folderName = await getResourceFolderName(
-        process.env.PROJECT_DIR ?? '',
-        channel.data.id,
-        channel.data.version.toString()
-      );
-      const channelFolderName = folderName ?? channel.id.replace(`-${channel.data.version}`, '');
-
       return {
         ...channel,
         data: {
@@ -120,12 +101,6 @@ export const getChannels = async ({ getAllVersions = true }: Props = {}): Promis
           latestVersion,
           messages,
         },
-        catalog: {
-          path: path.join(channel.collection, channel.id.replace('/index.mdx', '')),
-          filePath: path.join(process.cwd(), 'src', 'catalog-files', channel.collection, channel.id.replace('/index.mdx', '')),
-          publicPath: path.join('/generated', channel.collection, channelFolderName),
-          type: 'event',
-        },
       };
     })
   );