@eventcatalog/core 3.27.3 → 3.28.0

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

package/dist/analytics/analytics.js

@@ -1,7 +1,7 @@
 import {
   raiseEvent
-} from "../chunk-3T4OXHVX.js";
-import "../chunk-A6E2XEFF.js";
+} from "../chunk-TG2M57NQ.js";
+import "../chunk-PVWE6NFP.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.27.3";
+var version = "3.28.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/log-build.js

@@ -1,9 +1,9 @@
 import {
   log_build_default
-} from "../chunk-HQUSOSSP.js";
-import "../chunk-3T4OXHVX.js";
+} from "../chunk-SVKRN4WR.js";
+import "../chunk-TG2M57NQ.js";
 import "../chunk-4UVFXLPI.js";
-import "../chunk-A6E2XEFF.js";
+import "../chunk-PVWE6NFP.js";
 import "../chunk-5T63CXKU.js";
 export {
   log_build_default as default

package/dist/{chunk-7HCPZQON.js → chunk-BLDIS6WQ.js}

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

package/dist/{chunk-PQX7JOCF.js → chunk-LZGOYFMC.js}

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

package/dist/{chunk-A6E2XEFF.js → chunk-PVWE6NFP.js}

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

package/dist/{chunk-HQUSOSSP.js → chunk-SVKRN4WR.js}

@@ -1,6 +1,6 @@
 import {
   raiseEvent
-} from "./chunk-3T4OXHVX.js";
+} from "./chunk-TG2M57NQ.js";
 import {
   countResources,
   serializeCounts

package/dist/{chunk-3T4OXHVX.js → chunk-TG2M57NQ.js}

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

package/dist/constants.cjs

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

package/dist/constants.js

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-A6E2XEFF.js";
+} from "./chunk-PVWE6NFP.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.27.3";
+var version = "3.28.0";
 
 // 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-HQUSOSSP.js";
-import "./chunk-3T4OXHVX.js";
+} from "./chunk-SVKRN4WR.js";
+import "./chunk-TG2M57NQ.js";
 import "./chunk-4UVFXLPI.js";
 import {
   runMigrations
@@ -22,13 +22,13 @@ import {
 } from "./chunk-3KXCGYET.js";
 import {
   generate
-} from "./chunk-PQX7JOCF.js";
+} from "./chunk-LZGOYFMC.js";
 import {
   logger
-} from "./chunk-7HCPZQON.js";
+} from "./chunk-BLDIS6WQ.js";
 import {
   VERSION
-} from "./chunk-A6E2XEFF.js";
+} from "./chunk-PVWE6NFP.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.27.3";
+var version = "3.28.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/generate.js

@@ -1,8 +1,8 @@
 import {
   generate
-} from "./chunk-PQX7JOCF.js";
-import "./chunk-7HCPZQON.js";
-import "./chunk-A6E2XEFF.js";
+} from "./chunk-LZGOYFMC.js";
+import "./chunk-BLDIS6WQ.js";
+import "./chunk-PVWE6NFP.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.27.3";
+var version = "3.28.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/utils/cli-logger.js

@@ -1,7 +1,7 @@
 import {
   logger
-} from "../chunk-7HCPZQON.js";
-import "../chunk-A6E2XEFF.js";
+} from "../chunk-BLDIS6WQ.js";
+import "../chunk-PVWE6NFP.js";
 export {
   logger
 };

package/eventcatalog/src/components/Tables/Discover/DiscoverTable.tsx

@@ -22,6 +22,7 @@ export type CollectionType =
   | 'commands'
   | 'queries'
   | 'services'
+  | 'external-systems'
   | 'domains'
   | 'flows'
   | 'containers'

package/eventcatalog/src/components/Tables/Discover/columns.tsx

@@ -104,7 +104,10 @@ const createActionsColumn = (collectionType: CollectionType, tableConfiguration:
       const item = info.row.original;
       const href = buildUrl(`/docs/${item.collection}/${item.data.id}/${item.data.version}`);
       const nodeKey = `${item.collection}-${item.data.id}-${item.data.version}`;
-      const badgeLabel = collectionType.charAt(0).toUpperCase() + collectionType.slice(1, -1);
+      const badgeLabel =
+        collectionType === 'external-systems'
+          ? 'External System'
+          : collectionType.charAt(0).toUpperCase() + collectionType.slice(1, -1);
 
       return (
         <div className="flex items-center gap-0.5">
@@ -612,6 +615,7 @@ export const getDiscoverColumns = (collectionType: CollectionType, tableConfigur
     case 'queries':
       return getQueryColumns(tableConfiguration);
     case 'services':
+    case 'external-systems':
       return getServiceColumns(tableConfiguration);
     case 'domains':
       return getDomainColumns(tableConfiguration);

package/eventcatalog/src/content.config.ts

@@ -456,6 +456,7 @@ const services = defineCollection({
       writesTo: z.array(pointer).optional(),
       readsFrom: z.array(pointer).optional(),
       flows: z.array(pointer).optional(),
+      externalSystem: z.boolean().optional(),
       detailsPanel: z
         .object({
           domains: detailPanelPropertySchema.optional(),

package/eventcatalog/src/enterprise/feature.ts

@@ -12,7 +12,9 @@
 import fs from 'fs';
 import { join } from 'path';
 import config from '../../eventcatalog.config.js';
-import { isSSR } from '../utils/feature';
+
+// Inline isSSR to avoid circular dependency with ../utils/feature (which re-exports from this file)
+const isSSR = () => config?.output === 'server';
 
 // These functions check for valid, legally obtained access to premium features
 export const isEventCatalogStarterEnabled = () => process.env.EVENTCATALOG_STARTER === 'true';

package/eventcatalog/src/pages/discover/[type]/_index.data.ts

@@ -13,14 +13,28 @@ export class Page extends HybridPage {
     const { getServices } = await import('@utils/collections/services');
     const { getDataProducts } = await import('@utils/collections/data-products');
 
+    const getInternalServices = async () => (await getServices()).filter((s) => !s.data.externalSystem);
+    const getExternalServices = async () => (await getServices()).filter((s) => s.data.externalSystem);
+
     const loaders = {
       ...pageDataLoader,
       flows: getFlows,
-      services: getServices,
+      services: getInternalServices,
+      'external-systems': getExternalServices,
       'data-products': getDataProducts,
     };
 
-    const itemTypes = ['events', 'commands', 'queries', 'domains', 'services', 'flows', 'containers', 'data-products'] as const;
+    const itemTypes = [
+      'events',
+      'commands',
+      'queries',
+      'domains',
+      'services',
+      'external-systems',
+      'flows',
+      'containers',
+      'data-products',
+    ] as const;
     const allItems = await Promise.all(itemTypes.map((type) => loaders[type]()));
 
     return allItems.flatMap((items, index) => ({
@@ -45,10 +59,14 @@ export class Page extends HybridPage {
     const { getServices } = await import('@utils/collections/services');
     const { getDataProducts } = await import('@utils/collections/data-products');
 
+    const getInternalServices = async () => (await getServices()).filter((s) => !s.data.externalSystem);
+    const getExternalServices = async () => (await getServices()).filter((s) => s.data.externalSystem);
+
     const loaders = {
       ...pageDataLoader,
       flows: getFlows,
-      services: getServices,
+      services: getInternalServices,
+      'external-systems': getExternalServices,
       'data-products': getDataProducts,
     };
 

package/eventcatalog/src/pages/discover/[type]/index.astro

@@ -1,5 +1,12 @@
 ---
-import { QueueListIcon, RectangleGroupIcon, BoltIcon, ChatBubbleLeftIcon, CubeIcon } from '@heroicons/react/24/outline';
+import {
+  QueueListIcon,
+  RectangleGroupIcon,
+  BoltIcon,
+  ChatBubbleLeftIcon,
+  CubeIcon,
+  GlobeAltIcon,
+} from '@heroicons/react/24/outline';
 import ServerIcon from '@heroicons/react/24/outline/ServerIcon';
 import { MagnifyingGlassIcon } from '@heroicons/react/20/solid';
 import { DatabaseIcon } from 'lucide-react';
@@ -30,6 +37,8 @@ const events = await getEvents();
 const queries = await getQueries();
 const commands = await getCommands();
 const services = await getServices();
+const internalServices = services.filter((s) => !s.data.externalSystem);
+const externalServices = services.filter((s) => s.data.externalSystem);
 const domains = await getDomains({ getAllVersions: false });
 const flows = await getFlows();
 const containers = await getContainers();
@@ -96,6 +105,16 @@ const typeConfig: Record<
       { id: 'isDeprecated', label: 'Is Deprecated' },
     ],
   },
+  'external-systems': {
+    label: 'External Systems',
+    propertyOptions: [
+      { id: 'hasSpecifications', label: 'Has Specifications' },
+      { id: 'hasOwners', label: 'Has Owners' },
+      { id: 'hasRepository', label: 'Has Repository' },
+      { id: 'hasDataDependencies', label: 'Has Data Dependencies' },
+      { id: 'isDeprecated', label: 'Is Deprecated' },
+    ],
+  },
   flows: {
     label: 'Flows',
     propertyOptions: [
@@ -125,8 +144,10 @@ const typeConfig: Record<
 
 const currentTypeConfig = typeConfig[type] || typeConfig.events;
 
+// External systems reuse the user's `services.tableConfiguration` so customisations apply to both tabs
+const tableConfigurationKey = type === 'external-systems' ? 'services' : type;
 // @ts-ignore
-const tableConfiguration = config[type as keyof typeof config]?.tableConfiguration ?? { columns: {} };
+const tableConfiguration = config[tableConfigurationKey as keyof typeof config]?.tableConfiguration ?? { columns: {} };
 
 const tabs = [
   {
@@ -139,13 +160,22 @@ const tabs = [
     visible: domains.length > 0,
   },
   {
-    label: `Services (${services.length})`,
+    label: `Services (${internalServices.length})`,
     href: buildUrl('/discover/services'),
     isActive: type === 'services',
     icon: ServerIcon,
     activeColor: 'pink',
-    enabled: services.length > 0,
-    visible: services.length > 0,
+    enabled: internalServices.length > 0,
+    visible: internalServices.length > 0,
+  },
+  {
+    label: `External Systems (${externalServices.length})`,
+    href: buildUrl('/discover/external-systems'),
+    isActive: type === 'external-systems',
+    icon: GlobeAltIcon,
+    activeColor: 'purple',
+    enabled: externalServices.length > 0,
+    visible: externalServices.length > 0,
   },
   {
     label: `Data (${containers.length})`,
@@ -278,23 +308,24 @@ const allSubdomainIds = new Set(
   domains.flatMap((d: any) => (d.data?.domains || []).map((sd: any) => sd.data?.id || sd.id)).filter(Boolean)
 );
 
-// For services, enrich with domain information
-const enrichedData =
-  type === 'services'
-    ? await Promise.all(
-        data.map(async (service: any) => {
-          const serviceDomains = await getDomainsForService(service);
-          return {
-            ...service,
-            enrichedDomains: serviceDomains.map((d: any) => ({
-              id: d.data.id,
-              name: d.data.name,
-              version: d.data.version,
-            })),
-          };
-        })
-      )
-    : data;
+const isServiceLike = type === 'services' || type === 'external-systems';
+
+// For services and external systems, enrich with domain information
+const enrichedData = isServiceLike
+  ? await Promise.all(
+      data.map(async (service: any) => {
+        const serviceDomains = await getDomainsForService(service);
+        return {
+          ...service,
+          enrichedDomains: serviceDomains.map((d: any) => ({
+            id: d.data.id,
+            name: d.data.name,
+            version: d.data.version,
+          })),
+        };
+      })
+    )
+  : data;
 
 const tableData = enrichedData.map((d: any) => ({
   collection: d.collection,
@@ -303,10 +334,10 @@ const tableData = enrichedData.map((d: any) => ({
   hasServices: type === 'domains' ? (d.data?.services || []).length > 0 : false,
   isSubdomain: type === 'domains' ? allSubdomainIds.has(d.data.id) : false,
   // Service-specific properties
-  domains: type === 'services' ? d.enrichedDomains : undefined,
-  hasSpecifications: type === 'services' ? hasSpecifications(d) : false,
-  hasRepository: type === 'services' ? !!d.data?.repository?.url : false,
-  hasDataDependencies: type === 'services' ? (d.data?.writesTo || []).length > 0 || (d.data?.readsFrom || []).length > 0 : false,
+  domains: isServiceLike ? d.enrichedDomains : undefined,
+  hasSpecifications: isServiceLike ? hasSpecifications(d) : false,
+  hasRepository: isServiceLike ? !!d.data?.repository?.url : false,
+  hasDataDependencies: isServiceLike ? (d.data?.writesTo || []).length > 0 || (d.data?.readsFrom || []).length > 0 : false,
   // Data-product-specific properties
   hasInputs: type === 'data-products' ? (d.data?.inputs || []).length > 0 : false,
   hasOutputs: type === 'data-products' ? (d.data?.outputs || []).length > 0 : false,
@@ -371,8 +402,8 @@ const uniqueDomains = domains.map((d) => ({
   version: d.data.version,
 }));
 
-// Show domains filter only for services
-const showDomainsFilter = type === 'services';
+// Show domains filter only for services and external systems
+const showDomainsFilter = isServiceLike;
 
 const title = `${currentTypeConfig.label} (${data.length})`;
 ---

package/eventcatalog/src/stores/sidebar-store/builders/domain.ts

@@ -16,8 +16,11 @@ import { pluralizeMessageType } from '@utils/collections/messages';
 import { getSpecificationsForDomain } from '@utils/collections/domains';
 
 export const buildDomainNode = (domain: CollectionEntry<'domains'>, owners: any[], context: ResourceGroupContext): NavNode => {
-  const servicesInDomain = domain.data.services || [];
+  const allServicesInDomain = domain.data.services || [];
+  const servicesInDomain = allServicesInDomain.filter((service) => !(service as any).data?.externalSystem);
+  const externalSystemsInDomain = allServicesInDomain.filter((service) => (service as any).data?.externalSystem);
   const renderServices = servicesInDomain.length > 0 && shouldRenderSideBarSection(domain, 'services');
+  const renderExternalSystems = externalSystemsInDomain.length > 0 && shouldRenderSideBarSection(domain, 'services');
 
   const dataProductsInDomain = domain.data['data-products'] || [];
   const renderDataProducts = dataProductsInDomain.length > 0 && shouldRenderSideBarSection(domain, 'data-products');
@@ -179,6 +182,12 @@ export const buildDomainNode = (domain: CollectionEntry<'domains'>, owners: any[
         icon: 'Server',
         pages: servicesInDomain.map((service) => `service:${(service as any).data.id}:${(service as any).data.version}`),
       },
+      renderExternalSystems && {
+        type: 'group',
+        title: 'External Integrations',
+        icon: 'Globe',
+        pages: externalSystemsInDomain.map((service) => `service:${(service as any).data.id}:${(service as any).data.version}`),
+      },
       renderDataProducts && {
         type: 'group',
         title: 'Data Products',

package/eventcatalog/src/stores/sidebar-store/builders/service.ts

@@ -63,10 +63,12 @@ export const buildServiceNode = (
   const diagramNavItems = buildDiagramNavItems(serviceDiagrams, context.diagrams);
   const hasDiagrams = diagramNavItems.length > 0;
 
+  const isExternalSystem = !!service.data.externalSystem;
+
   return {
     type: 'item',
     title: service.data.name,
-    badge: 'Service',
+    badge: isExternalSystem ? 'External System' : 'Service',
     summary: service.data.summary,
     pages: [
       buildQuickReferenceSection(

package/eventcatalog/src/stores/sidebar-store/state.ts

@@ -374,11 +374,21 @@ export const getNestedSideBarData = async (): Promise<NavigationData> => {
     pages: domains.map((domain) => `domain:${domain.data.id}:${domain.data.version}`),
   });
 
-  const servicesList = createLeaf(services, {
+  const internalServices = services.filter((service) => !service.data.externalSystem);
+  const externalServices = services.filter((service) => service.data.externalSystem);
+
+  const servicesList = createLeaf(internalServices, {
     type: 'item',
     title: 'Services',
     icon: 'Server',
-    pages: services.map((service) => `service:${service.data.id}:${service.data.version}`),
+    pages: internalServices.map((service) => `service:${service.data.id}:${service.data.version}`),
+  });
+
+  const externalSystemsList = createLeaf(externalServices, {
+    type: 'item',
+    title: 'External Systems',
+    icon: 'Globe',
+    pages: externalServices.map((service) => `service:${service.data.id}:${service.data.version}`),
   });
 
   const eventsList = createLeaf(events, {
@@ -480,6 +490,7 @@ export const getNestedSideBarData = async (): Promise<NavigationData> => {
   const allChildrenKeys = [
     'list:domains',
     'list:services',
+    'list:external-systems',
     'list:messages',
     'list:channels',
     'list:flows',
@@ -491,6 +502,7 @@ export const getNestedSideBarData = async (): Promise<NavigationData> => {
   const allChildrenNodes = [
     domainsList,
     servicesList,
+    externalSystemsList,
     messagesList,
     channelList,
     flowsList,
@@ -515,6 +527,7 @@ export const getNestedSideBarData = async (): Promise<NavigationData> => {
   const allNodes: Record<string, NavNode> = {
     ...(domainsList ? { 'list:domains': domainsList } : {}),
     ...(servicesList ? { 'list:services': servicesList } : {}),
+    ...(externalSystemsList ? { 'list:external-systems': externalSystemsList } : {}),
     ...(eventsList ? { 'list:events': eventsList } : {}),
     ...(commandsList ? { 'list:commands': commandsList } : {}),
     ...(queriesList ? { 'list:queries': queriesList } : {}),

package/package.json

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