@eventcatalog/core 4.12.1 → 4.12.3

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

package/dist/analytics/analytics.js

@@ -1,7 +1,7 @@
 import {
   raiseEvent
-} from "../chunk-HH6GPY4H.js";
-import "../chunk-HHZFKWX7.js";
+} from "../chunk-ZYTCBNB3.js";
+import "../chunk-HPC6KUDQ.js";
 export {
   raiseEvent
 };

package/dist/analytics/log-build.cjs

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

package/dist/analytics/log-build.js

@@ -1,9 +1,9 @@
 import {
   log_build_default
-} from "../chunk-UWSBZYF5.js";
-import "../chunk-HH6GPY4H.js";
+} from "../chunk-M577VUOX.js";
 import "../chunk-ZAZHAVKB.js";
-import "../chunk-HHZFKWX7.js";
+import "../chunk-ZYTCBNB3.js";
+import "../chunk-HPC6KUDQ.js";
 import "../chunk-RFIXKATC.js";
 export {
   log_build_default as default

package/dist/{chunk-DZZDBFUM.js → chunk-5BPN6QEC.js}

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

package/dist/{chunk-HHZFKWX7.js → chunk-HPC6KUDQ.js}

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

package/dist/{chunk-UWSBZYF5.js → chunk-M577VUOX.js}

@@ -1,11 +1,11 @@
-import {
-  raiseEvent
-} from "./chunk-HH6GPY4H.js";
 import {
   countResources,
   hashCatalogContent,
   serializeCounts
 } from "./chunk-ZAZHAVKB.js";
+import {
+  raiseEvent
+} from "./chunk-ZYTCBNB3.js";
 import {
   getEventCatalogConfigFile,
   verifyRequiredFieldsAreInCatalogConfigFile

package/dist/{chunk-EVXNBTRA.js → chunk-TV3YAWKQ.js}

@@ -1,6 +1,6 @@
 import {
   logger
-} from "./chunk-DZZDBFUM.js";
+} from "./chunk-5BPN6QEC.js";
 import {
   cleanup,
   getEventCatalogConfigFile

package/dist/{chunk-HH6GPY4H.js → chunk-ZYTCBNB3.js}

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

package/dist/constants.cjs

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

package/dist/constants.js

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

package/dist/eventcatalog.cjs

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

package/dist/eventcatalog.js

@@ -1,7 +1,6 @@
 import {
   log_build_default
-} from "./chunk-UWSBZYF5.js";
-import "./chunk-HH6GPY4H.js";
+} from "./chunk-M577VUOX.js";
 import "./chunk-ZAZHAVKB.js";
 import {
   runMigrations
@@ -11,17 +10,18 @@ import {
   FederationConflictError,
   FederationDiagnosticError,
   federateCatalog
-} from "./chunk-WRLNLWPW.js";
-import {
-  getFederationDiagnosticCounts,
-  getVisibleFederationDiagnostics
-} from "./chunk-JJPB6EOZ.js";
-import "./chunk-FV56YFM4.js";
+} from "./chunk-U4YJSTGV.js";
 import "./chunk-WRNH5C3U.js";
 import "./chunk-5EPNFDT5.js";
 import "./chunk-A2RZR3U4.js";
 import "./chunk-SDZQJTJW.js";
 import "./chunk-352FGP6W.js";
+import "./chunk-R7Z5ALYI.js";
+import {
+  getFederationDiagnosticCounts,
+  getVisibleFederationDiagnostics
+} from "./chunk-JJPB6EOZ.js";
+import "./chunk-FV56YFM4.js";
 import {
   getProjectOutDir,
   isAuthEnabled,
@@ -30,10 +30,10 @@ import {
 } from "./chunk-MDWB5HLO.js";
 import {
   generate
-} from "./chunk-EVXNBTRA.js";
+} from "./chunk-TV3YAWKQ.js";
 import {
   logger
-} from "./chunk-DZZDBFUM.js";
+} from "./chunk-5BPN6QEC.js";
 import {
   resolve_catalog_dependencies_default
 } from "./chunk-36RYTYT5.js";
@@ -47,7 +47,7 @@ import {
 import {
   watch
 } from "./chunk-U63GDPPY.js";
-import "./chunk-R7Z5ALYI.js";
+import "./chunk-ZYTCBNB3.js";
 import {
   getAstroConfigPath
 } from "./chunk-VIJJ7JKH.js";
@@ -63,7 +63,7 @@ import {
 } from "./chunk-LFQJXLHG.js";
 import {
   VERSION
-} from "./chunk-HHZFKWX7.js";
+} from "./chunk-HPC6KUDQ.js";
 import {
   getEventCatalogConfigFile,
   verifyRequiredFieldsAreInCatalogConfigFile

package/dist/federation/federate.js

@@ -2,15 +2,15 @@ import {
   FederationConflictError,
   FederationDiagnosticError,
   federateCatalog
-} from "../chunk-WRLNLWPW.js";
-import "../chunk-JJPB6EOZ.js";
-import "../chunk-FV56YFM4.js";
+} from "../chunk-U4YJSTGV.js";
 import "../chunk-WRNH5C3U.js";
 import "../chunk-5EPNFDT5.js";
 import "../chunk-A2RZR3U4.js";
 import "../chunk-SDZQJTJW.js";
 import "../chunk-352FGP6W.js";
 import "../chunk-R7Z5ALYI.js";
+import "../chunk-JJPB6EOZ.js";
+import "../chunk-FV56YFM4.js";
 import "../chunk-RFIXKATC.js";
 export {
   FederationConflictError,

package/dist/generate.cjs

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

package/dist/generate.js

@@ -1,8 +1,8 @@
 import {
   generate
-} from "./chunk-EVXNBTRA.js";
-import "./chunk-DZZDBFUM.js";
-import "./chunk-HHZFKWX7.js";
+} from "./chunk-TV3YAWKQ.js";
+import "./chunk-5BPN6QEC.js";
+import "./chunk-HPC6KUDQ.js";
 import "./chunk-RFIXKATC.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.12.1";
+var version = "4.12.3";
 
 // src/constants.ts
 var VERSION = version;

package/dist/utils/cli-logger.js

@@ -1,7 +1,7 @@
 import {
   logger
-} from "../chunk-DZZDBFUM.js";
-import "../chunk-HHZFKWX7.js";
+} from "../chunk-5BPN6QEC.js";
+import "../chunk-HPC6KUDQ.js";
 export {
   logger
 };

package/eventcatalog/src/content.config.ts

@@ -276,6 +276,10 @@ const flows = defineCollection({
               message: pointer.optional(),
               agent: pointer.optional(),
               service: pointer.optional(),
+              // Catalog system reference. `systems` matches how authors write the
+              // pointer (same shape as `service`); `system` is accepted as an alias.
+              systems: pointer.optional(),
+              system: pointer.optional(),
               flow: pointer.optional(),
               container: pointer.optional(),
               dataProduct: pointer.optional(),
@@ -325,6 +329,8 @@ const flows = defineCollection({
                 data.message,
                 data.agent,
                 data.service,
+                data.systems,
+                data.system,
                 data.flow,
                 data.container,
                 data.dataProduct,

package/eventcatalog/src/utils/git.ts

@@ -1,9 +1,86 @@
+import { execFileSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
 import shell from 'shelljs';
 
+type Commit = { timestamp: number; author: string };
+
+const COMMIT_MARKER = '\x1e';
+
+const newestCommitsByRepository = new Map<string, Map<string, Commit> | undefined>();
+
 export function hasGit() {
   return !!shell.which('git');
 }
 
+const runGit = (args: string[]) => {
+  try {
+    return execFileSync('git', ['-c', 'log.showSignature=false', ...args], {
+      encoding: 'utf8',
+      maxBuffer: 1024 * 1024 * 1024,
+      stdio: ['ignore', 'pipe', 'ignore'],
+    });
+  } catch {
+    return undefined;
+  }
+};
+
+const parseCommit = (header: string): Commit => {
+  const [timestamp, ...author] = header.split(',');
+  return { timestamp: Number(timestamp) * 1_000, author: author.join(',') };
+};
+
+// --no-renames and combined merge diffs list the same commits for a path as a per-file `git log -- <file>`.
+const readNewestCommits = (): Map<string, Commit> | undefined => {
+  const root = runGit(['rev-parse', '--show-toplevel'])?.trim();
+  if (!root) return undefined;
+
+  const output =
+    runGit(['log', `--format=${COMMIT_MARKER}%ct,%an`, '--name-only', '--no-renames', '--diff-merges=combined', '-z']) ?? '';
+
+  const realRoot = fs.realpathSync(root);
+  const commits = new Map<string, Commit>();
+  let current: Commit | undefined;
+  for (const token of output.split('\0')) {
+    const entry = token.startsWith('\n') ? token.slice(1) : token;
+    if (entry.startsWith(COMMIT_MARKER)) {
+      current = parseCommit(entry.slice(COMMIT_MARKER.length));
+    } else if (entry && current) {
+      const file = path.join(realRoot, entry);
+      if (!commits.has(file)) commits.set(file, current);
+    }
+  }
+  return commits;
+};
+
+const getNewestCommits = () => {
+  const cwd = process.cwd();
+  if (!newestCommitsByRepository.has(cwd)) {
+    newestCommitsByRepository.set(cwd, readNewestCommits());
+  }
+  return newestCommitsByRepository.get(cwd);
+};
+
+const toRealPath = (filePath: string) => {
+  const absolutePath = path.resolve(filePath);
+  try {
+    return path.join(fs.realpathSync(path.dirname(absolutePath)), path.basename(absolutePath));
+  } catch {
+    return absolutePath;
+  }
+};
+
+const readCommit = (filePath: string, age: 'newest' | 'oldest'): Commit => {
+  const followArgs = age === 'oldest' ? ['--follow', '--diff-filter=A'] : [];
+  const output = runGit(['log', '--format=RESULT:%ct,%an', '--max-count=1', ...followArgs, '--', filePath])?.trim() ?? '';
+
+  const match = output.match(/(?:^|\n)RESULT:(?<header>\d+,.*)(?:$|\n)/);
+  if (!match?.groups) {
+    throw new Error(`Failed to retrieve the git history for file "${filePath}" with unexpected output: ${output}`);
+  }
+  return parseCommit(match.groups.header);
+};
+
 export function getGitHistory(
   filePath: string,
   {
@@ -23,36 +100,19 @@ export function getGitHistory(
     throw new Error('Git is not installed');
   }
 
-  const resultFormat = includeAuthor ? 'RESULT:%ct,%an' : 'RESULT:%ct';
-
-  const args = [`--format=${resultFormat}`, '--max-count=1', age === 'oldest' ? '--follow --diff-filter=A' : undefined]
-    .filter(Boolean)
-    .join(' ');
-
-  const command = `git -c log.showSignature=false log ${args} -- "${filePath}"`;
-
-  const result = shell.exec(command, { silent: true });
-
-  const regex = includeAuthor
-    ? /(?:^|\n)RESULT:(?<timestamp>\d+),(?<author>.+)(?:$|\n)/
-    : /(?:^|\n)RESULT:(?<timestamp>\d+)(?:$|\n)/;
-
-  const output = result.stdout.trim();
-
-  const match = output.match(regex);
-
-  if (!match) {
-    throw new Error(`Failed to retrieve the git history for file "${filePath}" with unexpected output: ${output}`);
+  let commit: Commit | undefined;
+  if (age === 'newest') {
+    const newestCommits = getNewestCommits();
+    if (!newestCommits) {
+      throw new Error(`Failed to retrieve the git history for file "${filePath}": not a git repository`);
+    }
+    commit = newestCommits.get(toRealPath(filePath));
   }
-
-  const timestampInSeconds = Number(match.groups?.timestamp);
-  const timestamp = timestampInSeconds * 1_000;
-  const date = new Date(timestamp);
-  const author = match.groups?.author;
+  commit ??= readCommit(filePath, age);
 
   return {
-    timestamp,
-    date,
-    author,
+    timestamp: commit.timestamp,
+    date: new Date(commit.timestamp),
+    author: includeAuthor ? commit.author : undefined,
   };
 }

package/eventcatalog/src/utils/node-graphs/catalog-force-graph.ts

@@ -245,6 +245,7 @@ export const getCatalogForceGraph = async (): Promise<{ nodes: CatalogGraphNode[
     const key = nodeKey('flows', flow.data.id);
     for (const step of (flow.data as any).steps ?? []) {
       addLink(key, nodeKey('services', refId(step.service)!), 'references');
+      addLink(key, nodeKey('systems', refId(step.systems || step.system)!), 'references');
       addLink(key, nodeKey('agents', refId(step.agent)!), 'references');
       addLink(key, nodeKey('flows', refId(step.flow)!), 'has sub-flow');
       addLink(key, nodeKey('containers', refId(step.container)!), 'references');

package/eventcatalog/src/utils/node-graphs/export-mermaid.ts

@@ -35,6 +35,8 @@ const NODE_SHAPE_MAP: Record<string, [string, string]> = {
   domain: ['[', ']'],
   flows: ['([', '])'], // stadium (rounded)
   flow: ['([', '])'],
+  systems: ['[[', ']]'],
+  system: ['[[', ']]'],
   step: ['[', ']'], // rectangle
   user: ['((', '))'], // circle
   actor: ['((', '))'], // circle
@@ -72,6 +74,8 @@ const NODE_STYLE_CLASSES: Record<string, string> = {
   domain: 'fill:#eab308,stroke:#a16207,color:#000',
   flows: 'fill:#14b8a6,stroke:#0f766e,color:#fff',
   flow: 'fill:#14b8a6,stroke:#0f766e,color:#fff',
+  systems: 'fill:#8b5cf6,stroke:#6d28d9,color:#fff',
+  system: 'fill:#8b5cf6,stroke:#6d28d9,color:#fff',
   step: 'fill:#374151,stroke:#1f2937,color:#fff',
   user: 'fill:#8b5cf6,stroke:#6d28d9,color:#fff',
   actor: 'fill:#eab308,stroke:#a16207,color:#000',
@@ -181,6 +185,13 @@ export function getNodeLabel(node: Node): string {
     return formatLabelWithVersion(name, version);
   }
 
+  if (type === 'systems' || type === 'system') {
+    const system = (data as any).system;
+    const name = system?.name || system?.id || node.id;
+    const version = system?.data?.version || system?.version;
+    return formatLabelWithVersion(name, version);
+  }
+
   if (type === 'flows' || type === 'flow') {
     const flow = (data as any).flow;
     const name = flow?.name || flow?.id || node.id;

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

@@ -6,6 +6,7 @@ import {
   DEFAULT_NODE_HEIGHT,
   buildContextMenuForResource,
   buildContextMenuForService,
+  buildContextMenuForSystem,
   layoutDagreGraph,
 } from '@utils/node-graphs/utils/utils';
 import { MarkerType } from '@xyflow/react';
@@ -29,6 +30,7 @@ interface Maps {
   flowMap: Map<string, any[]>;
   containerMap: Map<string, any[]>;
   dataProductMap: Map<string, any[]>;
+  systemMap: Map<string, any[]>;
 }
 
 const getServiceNode = (step: any, serviceMap: Map<string, any[]>) => {
@@ -78,6 +80,16 @@ const getDataProductNode = (step: any, dataProductMap: Map<string, any[]>) => {
   };
 };
 
+const getSystemNode = (step: any, systemMap: Map<string, any[]>) => {
+  const pointer = step.systems || step.system;
+  const system = findInMap(systemMap, pointer.id, pointer.version);
+  return {
+    ...step,
+    type: system ? 'systems' : 'step',
+    system,
+  };
+};
+
 const getMessageNode = (step: any, messageMap: Map<string, any[]>) => {
   const message = findInMap(messageMap, step.message.id, step.message.version);
   return {
@@ -129,6 +141,7 @@ const buildFlowGraphInternal = (
   const hydratedSteps = steps.map((step: any) => {
     if (step.agent) return getAgentNode(step, maps.agentMap);
     if (step.service) return getServiceNode(step, maps.serviceMap);
+    if (step.systems || step.system) return getSystemNode(step, maps.systemMap);
     if (step.flow) return getFlowNode(step, maps.flowMap);
     if (step.container) return getContainerNode(step, maps.containerMap);
     if (step.dataProduct) return getDataProductNode(step, maps.dataProductMap);
@@ -171,6 +184,13 @@ const buildFlowGraphInternal = (
         repository: step.service.data.repository,
       });
     }
+    if (step.system?.data) {
+      node.data.system = { ...step.system.data };
+      node.data.contextMenu = buildContextMenuForSystem({
+        id: step.system.data.id,
+        version: step.system.data.version,
+      });
+    }
     if (step.flow) {
       node.data.flow = { ...step.flow, ...step.flow.data };
       node.data.contextMenu = buildContextMenuForResource({
@@ -274,7 +294,7 @@ const buildFlowGraphInternal = (
 export const getNodesAndEdges = async ({ id, defaultFlow, version, mode = 'simple', renderAllEdges = false }: Props) => {
   const graph = defaultFlow || createDagreGraph({ ranksep: 360, nodesep: 200 });
 
-  const [flows, events, commands, queries, agents, services, containers, dataProducts] = await Promise.all([
+  const [flows, events, commands, queries, agents, services, containers, dataProducts, systems] = await Promise.all([
     getCollection('flows'),
     getCollection('events'),
     getCollection('commands'),
@@ -283,6 +303,7 @@ export const getNodesAndEdges = async ({ id, defaultFlow, version, mode = 'simpl
     getCollection('services'),
     getCollection('containers'),
     getCollection('data-products'),
+    getCollection('systems'),
   ]);
 
   const flow = flows.find((flow) => flow.data.id === id && flow.data.version === version);
@@ -302,6 +323,7 @@ export const getNodesAndEdges = async ({ id, defaultFlow, version, mode = 'simpl
     flowMap: createVersionedMap(flows),
     containerMap: createVersionedMap(containers),
     dataProductMap: createVersionedMap(dataProducts),
+    systemMap: createVersionedMap(systems),
   };
 
   const subFlowCache = new Map<string, { nodes: any[]; edges: any[] }>();

package/package.json

@@ -7,7 +7,7 @@
   },
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",
-  "version": "4.12.1",
+  "version": "4.12.3",
   "publishConfig": {
     "access": "public"
   },
@@ -133,9 +133,9 @@
     "update-notifier": "^7.3.1",
     "uuid": "^11.1.1",
     "zod": "^4.3.6",
-    "@eventcatalog/linter": "1.1.20",
-    "@eventcatalog/sdk": "2.29.1",
-    "@eventcatalog/visualiser": "^4.1.4"
+    "@eventcatalog/linter": "1.1.21",
+    "@eventcatalog/sdk": "2.29.2",
+    "@eventcatalog/visualiser": "^4.1.5"
   },
   "devDependencies": {
     "@astrojs/check": "^0.9.10",

package/dist/{chunk-WRLNLWPW.js → chunk-U4YJSTGV.js}

@@ -1,10 +1,3 @@
-import {
-  getFederationDiagnostics,
-  resolveFederationRules
-} from "./chunk-JJPB6EOZ.js";
-import {
-  isFederationEnabled
-} from "./chunk-FV56YFM4.js";
 import {
   withFederationOutputTransaction
 } from "./chunk-WRNH5C3U.js";
@@ -17,6 +10,13 @@ import {
 import {
   createFederationContentCache
 } from "./chunk-R7Z5ALYI.js";
+import {
+  getFederationDiagnostics,
+  resolveFederationRules
+} from "./chunk-JJPB6EOZ.js";
+import {
+  isFederationEnabled
+} from "./chunk-FV56YFM4.js";
 import {
   getEventCatalogConfigFile
 } from "./chunk-RFIXKATC.js";