@eventcatalog/core 5.7.5 → 5.8.0

package/eventcatalog/src/pages/api/schemas/services/[id]/[version]/[specification]/index.ts

@@ -1,34 +1,32 @@
 import type { APIRoute } from 'astro';
-import { getCollection } from 'astro:content';
-import path from 'node:path';
-import fs from 'node:fs';
+import { getCollection, type CollectionEntry } from 'astro:content';
 import { getSpecificationsForService } from '@utils/collections/services';
+import { getSpecificationMediaType } from '@utils/collections/util';
 import { resourceFileExists, readResourceFile } from '@utils/resource-files';
 
+// The Schema API: kept for the API consumers that already use it. It finds a specification by its type, so it
+// serves the first of each type. The file of every specification is also served next to its page:
+// /docs/{type}/{id}/{version}/{asyncapi|spec|graphql|generic}/{filename}/{file}
+const getFirstSpecificationOfEachType = (service: CollectionEntry<'services'>) =>
+  getSpecificationsForService(service).filter(
+    (specification, index, specifications) => specifications.findIndex((spec) => spec.type === specification.type) === index
+  );
+
 export async function getStaticPaths() {
   const services = await getCollection('services');
-  const servicesWithSpecifications = services.filter((service) => getSpecificationsForService(service).length > 0);
-  return servicesWithSpecifications.reduce<
-    { params: { collection: string; id: string; version: string; specification: string }; props: { schema: string } }[]
-  >(
-    (acc, service) => {
-      const specifications = getSpecificationsForService(service);
-      return [
-        ...acc,
-        ...specifications.map((specification) => ({
-          params: {
-            collection: service.collection,
-            id: service.data.id,
-            version: service.data.version,
-            specification: specification.type,
-          },
-          props: {
-            schema: fs.readFileSync(path.join(path.dirname(service.filePath ?? ''), specification.path ?? ''), 'utf8'),
-          },
-        })),
-      ];
-    },
-    [] as { params: { collection: string; id: string; version: string; specification: string }; props: { schema: string } }[]
+  return services.flatMap((service) =>
+    getFirstSpecificationOfEachType(service).map((specification) => ({
+      params: {
+        collection: service.collection,
+        id: service.data.id,
+        version: service.data.version,
+        specification: specification.type,
+      },
+      props: {
+        schema: readResourceFile(service, specification.path),
+        contentType: getSpecificationMediaType(specification),
+      },
+    }))
   );
 }
 
@@ -36,7 +34,7 @@ export const GET: APIRoute = async ({ props, params }) => {
   // In static mode, props are pre-computed by getStaticPaths
   if (props.schema) {
     return new Response(props.schema, {
-      headers: { 'Content-Type': 'text/plain' },
+      headers: { 'Content-Type': props.contentType },
     });
   }
 
@@ -80,6 +78,6 @@ export const GET: APIRoute = async ({ props, params }) => {
   }
 
   return new Response(schema, {
-    headers: { 'Content-Type': 'text/plain' },
+    headers: { 'Content-Type': getSpecificationMediaType(spec) },
   });
 };

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

@@ -282,6 +282,13 @@ function resolvePointer(pointer: { id: string; version?: string }) {
   };
 }
 
+// Resolve a list of pointers, listing each resource once (a data product can point at the
+// same resource more than once, e.g. one output per data contract)
+function resolvePointers(pointers: { id: string; version?: string }[] = []) {
+  const resolved = pointers.map(resolvePointer).filter((item) => item !== null);
+  return [...new Map(resolved.map((item) => [`${item.collection}:${item.data.id}:${item.data.version}`, item])).values()];
+}
+
 // Build a Set of subdomain IDs (domains that are nested within other domains)
 const allSubdomainIds = new Set(
   domains.flatMap((d: any) => (d.data?.domains || []).map((sd: any) => sd.data?.id || sd.id)).filter(Boolean)
@@ -368,8 +375,8 @@ const tableData = enrichedData.map((d: any) => ({
     flows: d.data?.flows?.map(mapToItem) ?? [],
     servicesThatWriteToContainer: d.data?.servicesThatWriteToContainer?.map(mapToItem) ?? [],
     servicesThatReadFromContainer: d.data?.servicesThatReadFromContainer?.map(mapToItem) ?? [],
-    inputs: d.data?.inputs?.map(resolvePointer).filter(Boolean) ?? [],
-    outputs: d.data?.outputs?.map(resolvePointer).filter(Boolean) ?? [],
+    inputs: resolvePointers(d.data?.inputs),
+    outputs: resolvePointers(d.data?.outputs),
   },
 }));
 

package/eventcatalog/src/pages/docs/[type]/[id]/[version]/asyncapi/[filename]/[file].ts

@@ -0,0 +1,7 @@
+import { isSSR } from '@utils/feature';
+import { createRawSpecificationRoute } from '@utils/raw-specification';
+import { Page } from '../_[filename].data';
+
+// The specification's file, as written, next to its page
+export const prerender = !isSSR();
+export const { getStaticPaths, GET } = createRawSpecificationRoute('asyncapi', Page);

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

@@ -12,6 +12,8 @@ import js from '@asyncapi/react-component/browser/standalone/without-parser.js?u
 import { AsyncApiComponentWP, type ConfigInterface } from '@asyncapi/react-component';
 import VerticalSideBarLayout from '@layouts/VerticalSideBarLayout.astro';
 import CopyAsMarkdown from '@components/CopyAsMarkdown';
+import SpecificationDownloadButton from '@components/SpecificationDownloadButton.astro';
+import { getRawSpecificationUrl } from '@utils/raw-specification';
 import { isEventCatalogChatVisible } from '@utils/feature';
 import Config from '@utils/eventcatalog-config/catalog';
 import { Page } from './_[filename].data';
@@ -23,7 +25,7 @@ export const getStaticPaths = Page.getStaticPaths;
 // Get data
 const pageData = await Page.getData(Astro);
 if (!pageData) return Astro.rewrite('/404');
-const { collection, data, filePath, filename, path: relativeSpecPath, headers = {} } = pageData;
+const { collection, data, filePath, filename, filenameWithoutExtension, path: relativeSpecPath, headers = {} } = pageData;
 
 const fileName = filename || 'asyncapi.yaml';
 const pathToSpec = getAbsoluteFilePathForAstroFile(filePath, fileName);
@@ -149,6 +151,15 @@ const renderedComponent = renderToString(component);
 // Capitalize the first letter of a string
 const pageTitle = `${collection} | ${data.name} | AsyncApi Spec`.replace(/^\w/, (c) => c.toUpperCase());
 
+const downloadUrl = getRawSpecificationUrl({
+  collection,
+  id: data.id,
+  version: data.version,
+  type: 'asyncapi',
+  filename,
+  filenameWithoutExtension,
+});
+
 // Chat configuration
 const chatEnabled = isEventCatalogChatVisible();
 const chatQuery = `Tell me about the AsyncAPI specification for "${data.name}" (version ${data.version})`;
@@ -175,9 +186,10 @@ const pagefindAttributes =
       // https://github.com/CloudCannon/pagefind/issues/437
     }
     <h2 class="hidden">{pageTitle}</h2>
-    {
-      chatEnabled && (
-        <div class="absolute top-3 right-4 z-10">
+    <div class="absolute top-3 right-4 z-10 flex items-center gap-2" data-pagefind-ignore>
+      {(fileExists || isRemote) && <SpecificationDownloadButton href={downloadUrl} filename={filename} />}
+      {
+        chatEnabled && (
           <CopyAsMarkdown
             client:only="react"
             schemas={[]}
@@ -189,9 +201,9 @@ const pagefindAttributes =
             preferChatAsDefault={true}
             chatButtonText="Ask about this specification"
           />
-        </div>
-      )
-    }
+        )
+      }
+    </div>
     {
       failedToParse ? (
         <div class="not-prose mx-auto my-12 max-w-3xl rounded-lg border border-red-300 bg-[rgb(var(--ec-card-bg))] p-6">

package/eventcatalog/src/pages/docs/[type]/[id]/[version]/generic/[filename]/[file].ts

@@ -0,0 +1,7 @@
+import { isSSR } from '@utils/feature';
+import { createRawSpecificationRoute } from '@utils/raw-specification';
+import { Page } from '../_[filename].data';
+
+// The specification's file, as written, next to its page
+export const prerender = !isSSR();
+export const { getStaticPaths, GET } = createRawSpecificationRoute('generic', Page);

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

@@ -10,6 +10,8 @@ import { resolveHeaders } from '@utils/remote-spec';
 import Admonition from '@components/MDX/Admonition';
 import NewVersionBanner from '@components/NewVersionBanner.astro';
 import Badge from '@components/Badge.astro';
+import SpecificationDownloadButton from '@components/SpecificationDownloadButton.astro';
+import { getRawSpecificationUrl } from '@utils/raw-specification';
 import { getResourceTypeBadge } from '@utils/collections/resource-type-badge';
 import { getResourceNoun, getSpecificationCodeLanguage } from '@utils/collections/util';
 
@@ -49,6 +51,15 @@ if (isRemote) {
   content = readResourceFile(pageData, relativeSpecPath) ?? '';
 }
 
+const downloadUrl = getRawSpecificationUrl({
+  collection,
+  id: data.id,
+  version: data.version,
+  type: 'generic',
+  filename,
+  filenameWithoutExtension,
+});
+
 const iconURL = resolveIconUrl(getGenericSpecificationIcon(icon));
 
 // Create comprehensive page title
@@ -80,7 +91,16 @@ const pagefindAttributes =
       <div class="w-full min-w-0 lg:mr-2 xl:pr-12 py-8 bg-[rgb(var(--ec-page-bg))]">
         <!-- Title and subtitle sized like the resource's overview page, kept compact so the source starts high up -->
         <div class="border-b border-[rgb(var(--ec-page-border))] pb-4">
-          <h1 class="text-2xl md:text-4xl font-bold text-[rgb(var(--ec-page-text))]">{data.name}</h1>
+          <div class="flex items-start justify-between gap-4">
+            <h1 class="text-2xl md:text-4xl font-bold text-[rgb(var(--ec-page-text))]">{data.name}</h1>
+            {
+              fileExists && (
+                <div data-pagefind-ignore>
+                  <SpecificationDownloadButton href={downloadUrl} filename={filename} />
+                </div>
+              )
+            }
+          </div>
           <p class="text-base pt-2 text-[rgb(var(--ec-page-text-muted))] font-light">{specificationName}</p>
           <div class="flex flex-wrap gap-1.5 pt-3">
             {badges.map((badge: any) => <Badge badge={badge} />)}

package/eventcatalog/src/pages/docs/[type]/[id]/[version]/graphql/[filename]/[file].ts

@@ -0,0 +1,7 @@
+import { isSSR } from '@utils/feature';
+import { createRawSpecificationRoute } from '@utils/raw-specification';
+import { Page } from '../_[filename].data';
+
+// The specification's file, as written, next to its page
+export const prerender = !isSSR();
+export const { getStaticPaths, GET } = createRawSpecificationRoute('graphql', Page);

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

@@ -10,6 +10,8 @@ import { buildUrl, buildEditUrlForResource } from '@utils/url-builder';
 import Admonition from '@components/MDX/Admonition';
 import NewVersionBanner from '@components/NewVersionBanner.astro';
 import Badge from '@components/Badge.astro';
+import SpecificationDownloadButton from '@components/SpecificationDownloadButton.astro';
+import { getRawSpecificationUrl } from '@utils/raw-specification';
 import { getResourceTypeBadge } from '@utils/collections/resource-type-badge';
 import { getResourceNoun } from '@utils/collections/util';
 
@@ -19,7 +21,7 @@ export const getStaticPaths = Page.getStaticPaths;
 // Get data
 const pageData = await Page.getData(Astro);
 if (!pageData) return Astro.rewrite('/404');
-const { collection, data, filePath, filename, path: relativeSpecPath } = pageData;
+const { collection, data, filePath, filename, filenameWithoutExtension, path: relativeSpecPath } = pageData;
 
 const fileName = filename || 'schema.graphql';
 const pathToSpec = getAbsoluteFilePathForAstroFile(filePath, fileName);
@@ -36,6 +38,15 @@ if (isRemote) {
   content = await fetch(relativeSpecPath).then((res) => res.text());
 }
 
+const downloadUrl = getRawSpecificationUrl({
+  collection,
+  id: data.id,
+  version: data.version,
+  type: 'graphql',
+  filename,
+  filenameWithoutExtension,
+});
+
 // Create comprehensive page title
 const pageTitle = `${collection} | ${data.name} | GraphQL Schema`.replace(/^\w/, (c) => c.toUpperCase());
 
@@ -79,6 +90,13 @@ const pagefindAttributes =
                 </h1>
                 <h2 class="text-lg text-[rgb(var(--ec-page-text-muted))] font-medium mb-1">GraphQL Schema</h2>
               </div>
+              {
+                (fileExists || isRemote) && (
+                  <div data-pagefind-ignore>
+                    <SpecificationDownloadButton href={downloadUrl} filename={filename} />
+                  </div>
+                )
+              }
             </div>
 
             {

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

@@ -0,0 +1,7 @@
+import { isSSR } from '@utils/feature';
+import { createRawSpecificationRoute } from '@utils/raw-specification';
+import { Page } from '../_[filename].data';
+
+// The specification's file, as written, next to its page
+export const prerender = !isSSR();
+export const { getStaticPaths, GET } = createRawSpecificationRoute('openapi', Page);

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

@@ -76,6 +76,10 @@ if (isRemote) {
           // https://github.com/CloudCannon/pagefind/issues/437
         }
         <h2 class="hidden">{pageTitle}</h2>
+        {
+          // No download button here, unlike the other specification pages: Scalar shows its own
+          // "Download OpenAPI Document" link. The file is also served at ./{filename}/{file}.
+        }
         {chatEnabled && (
           <div class="absolute top-3 right-14 z-10">
             <CopyAsMarkdown

package/eventcatalog/src/pages/docs/services/[id]/asyncapi/[filename]/[file].ts

@@ -0,0 +1,7 @@
+import { isSSR } from '@utils/feature';
+import { Page } from '../../../../[type]/[id]/[version]/asyncapi/_[filename].data';
+import { createLatestServiceRawSpecificationRoute } from '../../../_latest-raw-specification-route';
+
+// The file of the service's latest specification, at a URL that doesn't change with each release
+export const prerender = !isSSR();
+export const { getStaticPaths, GET } = createLatestServiceRawSpecificationRoute('asyncapi', Page);

package/eventcatalog/src/pages/docs/services/[id]/graphql/[filename]/[file].ts

@@ -0,0 +1,7 @@
+import { isSSR } from '@utils/feature';
+import { Page } from '../../../../[type]/[id]/[version]/graphql/_[filename].data';
+import { createLatestServiceRawSpecificationRoute } from '../../../_latest-raw-specification-route';
+
+// The file of the service's latest specification, at a URL that doesn't change with each release
+export const prerender = !isSSR();
+export const { getStaticPaths, GET } = createLatestServiceRawSpecificationRoute('graphql', Page);

package/eventcatalog/src/pages/docs/services/[id]/spec/[filename]/[file].ts

@@ -0,0 +1,7 @@
+import { isSSR } from '@utils/feature';
+import { Page } from '../../../../[type]/[id]/[version]/spec/_[filename].data';
+import { createLatestServiceRawSpecificationRoute } from '../../../_latest-raw-specification-route';
+
+// The file of the service's latest specification, at a URL that doesn't change with each release
+export const prerender = !isSSR();
+export const { getStaticPaths, GET } = createLatestServiceRawSpecificationRoute('openapi', Page);

package/eventcatalog/src/pages/docs/services/_latest-raw-specification-route.ts

@@ -0,0 +1,37 @@
+import type { APIContext, APIRoute } from 'astro';
+import type { SpecificationType } from '@utils/collections/util';
+import {
+  getRawSpecificationResponse,
+  isRawSpecificationFile,
+  notFound,
+  toRawSpecificationPaths,
+  type SpecificationPage,
+  type SpecificationPageData,
+  type StaticPath,
+} from '@utils/raw-specification';
+import { getLatestServicePaths, getLatestServiceVersion } from './_latest-version-route';
+
+/**
+ * The route that serves the file of a service's latest version, for links that don't change with each
+ * release: /docs/services/{id}/{asyncapi|spec|graphql}/{filename}/{file}
+ */
+export const createLatestServiceRawSpecificationRoute = (type: SpecificationType, Page: SpecificationPage) => {
+  const getStaticPaths = async () =>
+    (await getLatestServicePaths(toRawSpecificationPaths(await Page.getStaticPaths()))) as StaticPath[];
+
+  const GET: APIRoute = async ({ params, props }: APIContext) => {
+    const version = props.redirectVersion ?? (params.id ? await getLatestServiceVersion(params.id) : undefined);
+    if (!version) return notFound('Specification not found');
+
+    const pageData: SpecificationPageData | undefined = await Page.getData({
+      params: { type: 'services', id: params.id, version, filename: params.filename },
+      props,
+    });
+
+    if (!pageData || !isRawSpecificationFile(pageData, params.file)) return notFound('Specification not found');
+
+    return getRawSpecificationResponse(type, pageData);
+  };
+
+  return { getStaticPaths, GET };
+};

package/eventcatalog/src/stores/sidebar-store/builders/data-product.ts

@@ -119,9 +119,13 @@ export const buildDataProductSections = (
     context.resourceDocCategories
   );
 
-  // Resolve inputs and outputs to their proper sidebar references
-  const resolvedInputs = inputs.map((input) => resolvePointerToRef(input, context)).filter(Boolean) as string[];
-  const resolvedOutputs = outputs.map((output) => resolvePointerToRef(output, context)).filter(Boolean) as string[];
+  // Resolve inputs and outputs to their proper sidebar references. The same resource can be
+  // listed more than once (e.g. one output per data contract), so show each resource only once.
+  const resolveRefs = (pointers: { id: string; version?: string }[]) => [
+    ...new Set(pointers.map((pointer) => resolvePointerToRef(pointer, context)).filter((ref): ref is string => !!ref)),
+  ];
+  const resolvedInputs = resolveRefs(inputs);
+  const resolvedOutputs = resolveRefs(outputs);
 
   // Extract data contracts from outputs that have a contract field
   const dataContracts = outputs

package/eventcatalog/src/utils/raw-specification.ts

@@ -0,0 +1,126 @@
+import type { APIContext, APIRoute } from 'astro';
+import type { CollectionEntry } from 'astro:content';
+import type { CollectionTypes } from '@types';
+import { getSpecificationMediaType, processSpecifications, type SpecificationType } from '@utils/collections/util';
+import { readResourceFile, resourceFileExists } from '@utils/resource-files';
+import { resolveHeaders } from '@utils/remote-spec';
+import { buildUrl } from '@utils/url-builder';
+import Config from '@utils/eventcatalog-config/catalog';
+
+/** The folder each kind of specification page lives in, under /docs/{type}/{id}/{version}/ */
+const PAGE_SEGMENT_BY_SPECIFICATION_TYPE: Record<SpecificationType, string> = {
+  asyncapi: 'asyncapi',
+  openapi: 'spec',
+  graphql: 'graphql',
+  generic: 'generic',
+};
+
+export type StaticPath = { params: Record<string, string | undefined>; props: Record<string, any> };
+
+/** The data a specification page loads: the resource, plus the specification's path and file names */
+export type SpecificationPageData = CollectionEntry<CollectionTypes> & {
+  path: string;
+  filename: string;
+  filenameWithoutExtension: string;
+};
+
+/** A specification page's data loader (the `Page` class in each `_[filename].data.ts`) */
+export type SpecificationPage = {
+  getStaticPaths(): Promise<StaticPath[]>;
+  getData(astro: { params: Record<string, string | undefined>; props: Record<string, any> }): Promise<any>;
+};
+
+/**
+ * The name a specification's file has in its URL: a remote specification's file name without the URL's query
+ * or fragment (orders.yaml?token=abc is orders.yaml), which would otherwise end the URL's path
+ */
+export const getRawSpecificationFileName = (filename: string) => filename.split(/[?#]/, 1)[0];
+
+/** Whether a raw specification URL's `file` names this specification's file */
+export const isRawSpecificationFile = (pageData: SpecificationPageData, file: string | undefined) =>
+  getRawSpecificationFileName(pageData.filename) === file;
+
+/**
+ * The URL of a specification's file, as written (JSON, YAML, GraphQL...): its page's URL followed by the
+ * file's name, e.g. /docs/services/Orders/1.0.0/asyncapi/orders/orders.yaml
+ */
+export const getRawSpecificationUrl = ({
+  collection,
+  id,
+  version,
+  type,
+  filename,
+  filenameWithoutExtension,
+}: {
+  collection: string;
+  id: string;
+  version: string;
+  type: SpecificationType;
+  filename: string;
+  filenameWithoutExtension: string;
+}) =>
+  buildUrl(
+    `/docs/${collection}/${id}/${version}/${PAGE_SEGMENT_BY_SPECIFICATION_TYPE[type]}/${filenameWithoutExtension}/${getRawSpecificationFileName(filename)}`,
+    true
+  );
+
+const isRemote = (path: string) => /^https?:\/\//i.test(path);
+
+export const notFound = (error: string) =>
+  new Response(JSON.stringify({ error }), { status: 404, headers: { 'Content-Type': 'application/json' } });
+
+/** The specification's file, as written, with the media type of its format */
+export const getRawSpecificationResponse = async (
+  type: SpecificationType,
+  pageData: SpecificationPageData
+): Promise<Response> => {
+  const specification = processSpecifications((pageData.data as any).specifications).find(
+    (spec) => spec.type === type && spec.path === pageData.path
+  );
+
+  if (!specification) return notFound('Specification not found');
+
+  const headers = { 'Content-Type': getSpecificationMediaType(specification) };
+
+  if (isRemote(specification.path)) {
+    const allowAnyEnvInHeaders = type === 'asyncapi' && (Config?.asyncAPI?.allowAnyEnvInSpecHeaders ?? false);
+    const response = await fetch(specification.path, {
+      headers: resolveHeaders(specification.headers ?? {}, { allowAnyEnvInHeaders }),
+    }).catch(() => null);
+
+    if (!response?.ok) return notFound('Specification file could not be fetched');
+    return new Response(await response.text(), { headers });
+  }
+
+  const content = readResourceFile(pageData, specification.path);
+  if (content === null) return notFound('Specification file could not be read');
+
+  return new Response(content, { headers });
+};
+
+/**
+ * Each specification page's path, with the specification's file name added as `file`. A local file that
+ * doesn't exist gets no path: a static build would otherwise save the 404's JSON under the file's name.
+ */
+export const toRawSpecificationPaths = (paths: StaticPath[]): StaticPath[] =>
+  paths
+    .filter(({ props }) => isRemote(props.path) || resourceFileExists(props, props.path))
+    .map(({ params, props }) => ({ params: { ...params, file: getRawSpecificationFileName(props.filename) }, props }));
+
+/**
+ * The route that serves a specification's file next to its page:
+ * /docs/{type}/{id}/{version}/{asyncapi|spec|graphql|generic}/{filename}/{file}
+ */
+export const createRawSpecificationRoute = (type: SpecificationType, Page: SpecificationPage) => {
+  const getStaticPaths = async () => toRawSpecificationPaths(await Page.getStaticPaths());
+
+  const GET: APIRoute = async ({ params, props }: APIContext) => {
+    const pageData: SpecificationPageData | undefined = await Page.getData({ params, props });
+
+    if (!pageData || !isRawSpecificationFile(pageData, params.file)) return notFound('Specification not found');
+
+    return getRawSpecificationResponse(type, pageData);
+  };
+
+  return { getStaticPaths, GET };
+};

package/package.json

@@ -7,7 +7,7 @@
   },
   "license": "BUSL-1.1",
   "type": "module",
-  "version": "5.7.5",
+  "version": "5.8.0",
   "publishConfig": {
     "access": "public"
   },
@@ -141,11 +141,11 @@
     "y-protocols": "^1.0.7",
     "yjs": "^13.6.33",
     "zod": "^4.6.6",
-    "@eventcatalog/fitness": "0.1.1",
     "@eventcatalog/exporters": "0.1.4",
-    "@eventcatalog/linter": "1.3.1",
+    "@eventcatalog/fitness": "0.1.1",
     "@eventcatalog/sdk": "2.32.0",
-    "@eventcatalog/visualiser": "^5.2.3"
+    "@eventcatalog/visualiser": "^5.2.4",
+    "@eventcatalog/linter": "1.3.1"
   },
   "devDependencies": {
     "@astrojs/check": "^0.9.10",