@eventcatalog/core 4.3.4 → 4.4.0

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

package/dist/analytics/analytics.js

@@ -1,7 +1,7 @@
 import {
   raiseEvent
-} from "../chunk-5L4FYIAY.js";
-import "../chunk-OPFRJOPV.js";
+} from "../chunk-P7BFML7F.js";
+import "../chunk-JSOK4BIG.js";
 export {
   raiseEvent
 };

package/dist/analytics/log-build.cjs

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

package/dist/analytics/log-build.js

@@ -1,9 +1,9 @@
 import {
   log_build_default
-} from "../chunk-QFXV3GDK.js";
+} from "../chunk-57CTITPR.js";
 import "../chunk-K2XIENVT.js";
-import "../chunk-5L4FYIAY.js";
-import "../chunk-OPFRJOPV.js";
+import "../chunk-P7BFML7F.js";
+import "../chunk-JSOK4BIG.js";
 import "../chunk-6QENHZZP.js";
 export {
   log_build_default as default

package/dist/{chunk-QFXV3GDK.js → chunk-57CTITPR.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-K2XIENVT.js";
 import {
   raiseEvent
-} from "./chunk-5L4FYIAY.js";
+} from "./chunk-P7BFML7F.js";
 import {
   getEventCatalogConfigFile,
   verifyRequiredFieldsAreInCatalogConfigFile

package/dist/{chunk-OPFRJOPV.js → chunk-JSOK4BIG.js}

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

package/dist/{chunk-CQQE7NTL.js → chunk-LNOQKTI4.js}

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

package/dist/{chunk-5L4FYIAY.js → chunk-P7BFML7F.js}

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

package/dist/{chunk-XTC5VFLE.js → chunk-UWBPGWUW.js}

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

package/dist/constants.cjs

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

package/dist/constants.js

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

package/dist/docs/api/02-config.md

@@ -704,12 +704,20 @@ module.exports = {
 
 - Type: `boolean`
 
-Setting this to true will automatically compress all your CSS, HTML, SVG, JavaScript, JSON and image files in the Astro outDir folder.
+Setting this to true will automatically compress your HTML, SVG, JavaScript, JSON and image files in the Astro outDir folder.
 
 This is disabled by default from EventCatalog v2.61.9.
 
 **This only works for static builds.**
 
+<AddedIn version="4.4.0" />
+
+`astro-compress` is no longer bundled with EventCatalog. Install it in your EventCatalog project before enabling compression:
+
+```bash
+npm install --save-dev astro-compress
+```
+
 ```js title="eventcatalog.config.js"
 module.exports = {
   compress: true

package/dist/docs/development/deployment/build-and-deploy.md

@@ -46,7 +46,13 @@ npx eventcatalog dev --debug -- --env=production --port=3000
 
 You can opt into our build step which will compress your static assets. 
 
-You can enable this by setting the [compress option](/docs/api/config#compress) to `true` in your `eventcatalog.config.js` file.
+First install the compression integration in your EventCatalog project:
+
+```bash
+npm install --save-dev astro-compress
+```
+
+Then set the [compress option](/docs/api/config#compress) to `true` in your `eventcatalog.config.js` file.
 
 :::info "Why is compression disabled by default?"
 Compression can increase your build time and the amount of memory required to build your catalog.

package/dist/docs/development/guides/98-versioning-resources.md

@@ -10,7 +10,6 @@ description: Learn how versioning works for EventCatalog resources.
 ---
 
 import ProjectTree from '@site/src/components/MDX/ProjectTree';
-import AddedIn from '@site/src/components/MDX/AddedIn';
 
 EventCatalog resources can be versioned when you want to preserve how a resource looked at a point in time.
 
@@ -111,20 +110,6 @@ For example:
 
 This lets users compare the current resource with previous versions when they need historical context.
 
-### Stable URLs for the latest version
-
-<AddedIn version="4.3.3" />
-
-For services, the URLs for the latest version and its sub-pages (changelog, specifications, and attached documentation) stay versionless and never change as the service is versioned up.
-
-| Page | URL |
-|------|-----|
-| Overview | `/docs/services/Orders` |
-| Changelog | `/docs/services/Orders/changelog` |
-| OpenAPI spec | `/docs/services/Orders/spec/openapi` |
-
-Share these links freely. When `Orders` moves from `1.0.0` to `2.0.0`, the versionless URLs keep resolving to whatever is latest, so the link never rots. Historical versions keep their versioned URLs, for example `/docs/services/Orders/1.0.0/changelog`.
-
 ## Referencing versions
 
 When one resource references another resource, you can include a `version` field when you want to point to a specific version.

package/dist/docs/development/guides/resources/services/07-versioning-and-lifecycle/01-version-services.md

@@ -8,8 +8,6 @@ title: Version services
 description: Learn how to version services
 ---
 
-import AddedIn from '@site/src/components/MDX/AddedIn';
-
 All content in EventCatalog can be versioned. This allows you to keep historic versions of content which can give context to users why things are changing.
 
 ## How to version a service

package/dist/docs/plugins/openapi/03-features.md

@@ -99,12 +99,16 @@ routes: [{ prefix: '/api', suffix: '/events' }]
 routes: [{ match: '/api/*/track' }]
 ```
 
-#### How consumers are created and updated
+#### How consumers are looked up and updated
 
-When the generator runs, each consumer service is looked up by `id` and `version`. If a consumer service does not yet exist, it is created automatically with a basic `<NodeGraph />` page. New consumers are placed inside the configured `domain` if one is defined.
+When the generator runs, each consumer service is looked up by `id` and `version`. The consumer service must already exist in the catalog. If it cannot be found, the consumer entry is skipped; the generator does not create a service page or add the consumer to the configured `domain`.
 
 If the consumer already exists in the catalog, it is updated in-place so its existing markdown, location, and metadata are preserved. The `sends` list on the consumer is merged with the incoming messages, with deduplication applied. If a consumer entry already tracks a versioned message, its version is updated to the latest value from the spec.
 
+:::note
+If another generator creates the consumer service, place that generator before the OpenAPI generator that references it. Otherwise, the consumer relationship is skipped for that generation run.
+:::
+
 ---
 
 ### Mapping messages as commands, queries or events

package/dist/eventcatalog.cjs

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

package/dist/eventcatalog.config.d.cts

@@ -264,6 +264,10 @@ interface Config {
         allowAnyEnvInSpecHeaders?: boolean;
     };
     mdxOptimize?: boolean;
+    /**
+     * Compress static build output using astro-compress installed in the EventCatalog project.
+     * @default false
+     */
     compress?: boolean;
     pages?: {
         /**

package/dist/eventcatalog.config.d.ts

@@ -264,6 +264,10 @@ interface Config {
         allowAnyEnvInSpecHeaders?: boolean;
     };
     mdxOptimize?: boolean;
+    /**
+     * Compress static build output using astro-compress installed in the EventCatalog project.
+     * @default false
+     */
     compress?: boolean;
     pages?: {
         /**

package/dist/eventcatalog.js

@@ -1,6 +1,6 @@
 import {
   log_build_default
-} from "./chunk-QFXV3GDK.js";
+} from "./chunk-57CTITPR.js";
 import "./chunk-K2XIENVT.js";
 import {
   runMigrations
@@ -14,10 +14,10 @@ import {
 } from "./chunk-B7HCX5HM.js";
 import {
   generate
-} from "./chunk-XTC5VFLE.js";
+} from "./chunk-UWBPGWUW.js";
 import {
   logger
-} from "./chunk-CQQE7NTL.js";
+} from "./chunk-LNOQKTI4.js";
 import {
   resolve_catalog_dependencies_default
 } from "./chunk-LHR4G2UO.js";
@@ -27,7 +27,7 @@ import {
 import {
   watch
 } from "./chunk-CAJUIMDJ.js";
-import "./chunk-5L4FYIAY.js";
+import "./chunk-P7BFML7F.js";
 import {
   createAstroDevLineFilter,
   createAstroLineFilter
@@ -38,7 +38,7 @@ import {
 import "./chunk-W5JQON7Z.js";
 import {
   VERSION
-} from "./chunk-OPFRJOPV.js";
+} from "./chunk-JSOK4BIG.js";
 import {
   linkCoreNodeModules,
   resolveInstalledCoreNodeModules

package/dist/generate.cjs

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

package/dist/generate.js

@@ -1,8 +1,8 @@
 import {
   generate
-} from "./chunk-XTC5VFLE.js";
-import "./chunk-CQQE7NTL.js";
-import "./chunk-OPFRJOPV.js";
+} from "./chunk-UWBPGWUW.js";
+import "./chunk-LNOQKTI4.js";
+import "./chunk-JSOK4BIG.js";
 import "./chunk-6QENHZZP.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.3.4";
+var version = "4.4.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/utils/cli-logger.js

@@ -1,7 +1,7 @@
 import {
   logger
-} from "../chunk-CQQE7NTL.js";
-import "../chunk-OPFRJOPV.js";
+} from "../chunk-LNOQKTI4.js";
+import "../chunk-JSOK4BIG.js";
 export {
   logger
 };

package/eventcatalog/astro.config.mjs

@@ -15,6 +15,7 @@ import remarkComment from 'remark-comment';
 import rehypeSlug from 'rehype-slug';
 import rehypeAutolinkHeadings from 'rehype-autolink-headings';
 import { eventCatalogLikeC4 } from './src/plugins/likec4';
+import { loadAstroCompressIntegration } from './src/plugins/astro-compress';
 import { astroTrailingSlashEndpointFix } from './src/plugins/astro-trailing-slash-endpoint-fix';
 
 import rehypeExpressiveCode from 'rehype-expressive-code';
@@ -107,12 +108,7 @@ export default defineConfig({
         rehypePlugins: mdxRehypePlugins,
       }),
     }),
-    effectiveOutput !== 'server' &&
-      compress &&
-      (await import('astro-compress')).default({
-        Logger: 0,
-        CSS: false,
-      }),
+    effectiveOutput !== 'server' && compress && (await loadAstroCompressIntegration(projectDirectory)),
     ecstudioWatcher(),
     eventCatalogIntegration(),
   ].filter(Boolean),

package/eventcatalog/src/components/SideNav/NestedSideBar/index.tsx

@@ -749,7 +749,7 @@ export default function NestedSideBar() {
       }) ?? [];
 
     const groupId = groupKey || group.collapseKey || `${currentLevel.key ?? 'root'}:group:${group.title}`;
-    const canCollapse = canCollapseGroup(visibleChildren.length);
+    const canCollapse = canCollapseGroup(visibleChildren.length, isTopLevel);
     const isCollapsed = isGroupCollapsed(canCollapse, groupId, sectionCollapsePreferences);
 
     // When a group's children are subtle subgroups (e.g. Resources > Services/Flows/Data Stores),

package/eventcatalog/src/components/SideNav/NestedSideBar/utils.spec.ts

@@ -14,9 +14,13 @@ describe('sidebar group presentation', () => {
     expect(getGroupLabel(title, 10)).toBe(title);
   });
 
-  it('only allows groups with more than five children to collapse', () => {
-    expect(canCollapseGroup(5)).toBe(false);
-    expect(canCollapseGroup(6)).toBe(true);
+  it('keeps top-level groups expanded', () => {
+    expect(canCollapseGroup(6, true)).toBe(false);
+  });
+
+  it('only allows nested groups with more than five children to collapse', () => {
+    expect(canCollapseGroup(5, false)).toBe(false);
+    expect(canCollapseGroup(6, false)).toBe(true);
   });
 });
 

package/eventcatalog/src/components/SideNav/NestedSideBar/utils.ts

@@ -7,7 +7,8 @@ export type SectionCollapsePreferences = {
   expanded: Set<string>;
 };
 
-export const canCollapseGroup = (childCount: number): boolean => childCount > SIDEBAR_GROUP_COLLAPSE_THRESHOLD;
+export const canCollapseGroup = (childCount: number, isTopLevel: boolean): boolean =>
+  !isTopLevel && childCount > SIDEBAR_GROUP_COLLAPSE_THRESHOLD;
 
 export const getGroupLabel = (title: string, childCount: number): string =>
   GROUP_TITLES_WITHOUT_COUNT.has(title) ? title : `${title} (${childCount})`;

package/eventcatalog/src/plugins/astro-compress.ts

@@ -0,0 +1,36 @@
+import type { AstroIntegration } from 'astro';
+import { createRequire } from 'node:module';
+import { join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+
+const astroCompressInstallMessage = `Compression is enabled, but astro-compress is not installed.
+
+Install it in your EventCatalog project:
+
+  npm install --save-dev astro-compress`;
+
+type AstroCompressModule = {
+  default?: (options: { Logger: number; CSS: boolean }) => AstroIntegration;
+};
+
+export const loadAstroCompressIntegration = async (projectDirectory: string): Promise<AstroIntegration> => {
+  let astroCompressPath: string;
+
+  try {
+    const requireFromCatalog = createRequire(join(projectDirectory, 'package.json'));
+    astroCompressPath = requireFromCatalog.resolve('astro-compress');
+  } catch (error) {
+    throw new Error(`${astroCompressInstallMessage}\n\n${error instanceof Error ? error.message : String(error)}`);
+  }
+
+  const astroCompress = (await import(/* @vite-ignore */ pathToFileURL(astroCompressPath).href)) as AstroCompressModule;
+
+  if (typeof astroCompress.default !== 'function') {
+    throw new Error('The installed astro-compress package does not have a default integration export.');
+  }
+
+  return astroCompress.default({
+    Logger: 0,
+    CSS: false,
+  });
+};

package/package.json

@@ -7,7 +7,7 @@
   },
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",
-  "version": "4.3.4",
+  "version": "4.4.0",
   "publishConfig": {
     "access": "public"
   },
@@ -62,7 +62,6 @@
     "@xyflow/react": "^12.3.6",
     "ai": "^6.0.17",
     "astro": "^7.1.1",
-    "astro-compress": "^2.4.0",
     "astro-expressive-code": "^0.44.0",
     "astro-seo": "^0.8.4",
     "auth-astro": "^4.2.0",