@eventcatalog/core 4.11.0 → 4.11.1

package/dist/eventcatalog.cjs

@@ -29,10 +29,10 @@ var importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
 // src/eventcatalog.ts
 var import_commander = require("commander");
 var import_node_child_process2 = require("child_process");
-var import_node_path18 = require("path");
+var import_node_path19 = require("path");
 var import_node_http = __toESM(require("http"), 1);
 var import_fs3 = __toESM(require("fs"), 1);
-var import_node_path19 = __toESM(require("path"), 1);
+var import_node_path20 = __toESM(require("path"), 1);
 var import_node_url = require("url");
 
 // src/generate.js
@@ -144,7 +144,7 @@ var verifyRequiredFieldsAreInCatalogConfigFile = async (projectDirectory) => {
 var import_picocolors = __toESM(require("picocolors"), 1);
 
 // package.json
-var version = "4.11.0";
+var version = "4.11.1";
 
 // src/constants.ts
 var VERSION = version;
@@ -1361,22 +1361,22 @@ function getAvroTypeName(type) {
 function walkAvroRecord(schema, prefix, fields) {
   if (!schema.fields || !Array.isArray(schema.fields)) return;
   for (const field of schema.fields) {
-    const path19 = prefix ? `${prefix}.${field.name}` : field.name;
+    const path20 = prefix ? `${prefix}.${field.name}` : field.name;
     const isOptional = Array.isArray(field.type) && field.type.includes("null");
     const typeName = getAvroTypeName(field.type);
     fields.push({
-      path: path19,
+      path: path20,
       type: typeName,
       description: field.doc || "",
       required: !isOptional
     });
     const innerType = Array.isArray(field.type) ? field.type.find((t) => typeof t === "object" && t.type === "record") : typeof field.type === "object" && field.type.type === "record" ? field.type : null;
     if (innerType) {
-      walkAvroRecord(innerType, path19, fields);
+      walkAvroRecord(innerType, path20, fields);
     }
     const arrayType = Array.isArray(field.type) ? field.type.find((t) => typeof t === "object" && t.type === "array") : typeof field.type === "object" && field.type.type === "array" ? field.type : null;
     if (arrayType && typeof arrayType.items === "object" && arrayType.items.type === "record") {
-      walkAvroRecord(arrayType.items, `${path19}[]`, fields);
+      walkAvroRecord(arrayType.items, `${path20}[]`, fields);
     }
   }
 }
@@ -1407,32 +1407,32 @@ function walkJsonSchema(node, prefix, requiredList, rootSchema, fields) {
   }
   if (!node.properties) return;
   for (const [name, prop] of Object.entries(node.properties)) {
-    const path19 = prefix ? `${prefix}.${name}` : name;
+    const path20 = prefix ? `${prefix}.${name}` : name;
     const isRequired = requiredList.includes(name);
     if (prop.$ref) {
       const resolved = resolveLocalRef(prop.$ref, rootSchema);
       if (resolved) {
         const rawRefType = resolved.type || "object";
         const type2 = Array.isArray(rawRefType) ? [...rawRefType].sort().join(" | ") : rawRefType;
-        fields.push({ path: path19, type: type2, description: resolved.description || "", required: isRequired });
+        fields.push({ path: path20, type: type2, description: resolved.description || "", required: isRequired });
         if (resolved.properties) {
-          walkJsonSchema(resolved, path19, resolved.required || [], rootSchema, fields);
+          walkJsonSchema(resolved, path20, resolved.required || [], rootSchema, fields);
         }
       } else {
-        fields.push({ path: path19, type: "$ref", description: "", required: isRequired });
+        fields.push({ path: path20, type: "$ref", description: "", required: isRequired });
       }
       continue;
     }
     const rawType = prop.type || (prop.enum ? "enum" : prop.$ref ? "$ref" : "object");
     const typeList = Array.isArray(rawType) ? rawType : [rawType];
     const type = Array.isArray(rawType) ? [...rawType].sort().join(" | ") : rawType;
-    fields.push({ path: path19, type, description: prop.description || "", required: isRequired });
+    fields.push({ path: path20, type, description: prop.description || "", required: isRequired });
     if (typeList.includes("object") && prop.properties) {
-      walkJsonSchema(prop, path19, prop.required || [], rootSchema, fields);
+      walkJsonSchema(prop, path20, prop.required || [], rootSchema, fields);
     }
     if (typeList.includes("array") && prop.items) {
       if (prop.items.type === "object" && prop.items.properties) {
-        walkJsonSchema(prop.items, `${path19}[]`, prop.items.required || [], rootSchema, fields);
+        walkJsonSchema(prop.items, `${path20}[]`, prop.items.required || [], rootSchema, fields);
       }
     }
   }
@@ -1941,11 +1941,117 @@ var linkCoreNodeModules = ({
   import_fs2.default.symlinkSync(installedCoreNodeModules, coreNodeModules, process.platform === "win32" ? "junction" : "dir");
 };
 
+// src/copy-core.ts
+var import_node_fs8 = __toESM(require("fs"), 1);
+var import_node_path12 = __toESM(require("path"), 1);
+var IGNORED_CORE_DIRECTORIES = /* @__PURE__ */ new Set([".astro", "dist", "node_modules", "__tests__"]);
+var COLOCATED_TEST_SUFFIXES = [
+  ".spec.js",
+  ".spec.jsx",
+  ".spec.cjs",
+  ".spec.mjs",
+  ".spec.ts",
+  ".spec.tsx",
+  ".spec.cts",
+  ".spec.mts",
+  ".test.js",
+  ".test.jsx",
+  ".test.cjs",
+  ".test.mjs",
+  ".test.ts",
+  ".test.tsx",
+  ".test.cts",
+  ".test.mts"
+];
+var isColocatedTestFile = (fileName) => COLOCATED_TEST_SUFFIXES.some((suffix) => fileName.endsWith(suffix));
+var shouldCopyCoreEntry = (sourceRoot, sourcePath) => {
+  const relativePath = import_node_path12.default.relative(sourceRoot, sourcePath);
+  if (relativePath === "") return true;
+  const pathParts = relativePath.split(import_node_path12.default.sep);
+  if (pathParts.some((part) => IGNORED_CORE_DIRECTORIES.has(part))) return false;
+  const fileName = pathParts[pathParts.length - 1] ?? "";
+  return !isColocatedTestFile(fileName);
+};
+var PRUNE_SKIPPED_DIRECTORIES = /* @__PURE__ */ new Set([".astro", "dist", "node_modules"]);
+var pruneExcludedCoreEntries = (coreDir) => {
+  if (!import_node_fs8.default.existsSync(coreDir)) return;
+  const visit = (directory) => {
+    for (const entry of import_node_fs8.default.readdirSync(directory, { withFileTypes: true })) {
+      const entryPath = import_node_path12.default.join(directory, entry.name);
+      if (entry.name === "__tests__" || isColocatedTestFile(entry.name)) {
+        import_node_fs8.default.rmSync(entryPath, { recursive: true, force: true });
+        continue;
+      }
+      if (entry.isDirectory() && !PRUNE_SKIPPED_DIRECTORIES.has(entry.name)) {
+        visit(entryPath);
+      }
+    }
+  };
+  visit(coreDir);
+};
+
+// eventcatalog/src/plugins/empty-collection-warning.mjs
+var KNOWN_EVENTCATALOG_COLLECTIONS = /* @__PURE__ */ new Set([
+  "events",
+  "commands",
+  "queries",
+  "examples",
+  "services",
+  "agents",
+  "adrs",
+  "channels",
+  "users",
+  "teams",
+  "domains",
+  "systems",
+  "flows",
+  "pages",
+  "changelogs",
+  "containers",
+  "data-products",
+  "ubiquitousLanguages",
+  "entities",
+  "customPages",
+  "resourceDocs",
+  "resourceDocCategories",
+  "designs",
+  "diagrams",
+  "schemas",
+  "sidebars"
+]);
+var EMPTY_COLLECTION_MESSAGE = /^The collection ("(?:\\.|[^"\\])*") does not exist or is empty\. Please check your content config file for errors\.$/;
+var ANSI_PATTERN = /\u001B(?:[@-Z\\-_]|\[[0-?]*[ -/]*[@-~])/g;
+var ASTRO_CONTENT_WARN_PREFIX = /^[^[\]]*\[WARN\]\s+\[content\](?:\s+\[[^\]]+\])*\s*$/;
+function collectionNameFromEmptyWarning(message) {
+  const match = message.match(EMPTY_COLLECTION_MESSAGE);
+  if (!match) return null;
+  try {
+    const name = JSON.parse(match[1]);
+    return typeof name === "string" ? name : null;
+  } catch {
+    return null;
+  }
+}
+function isIntentionalEmptyCollectionMessage(message) {
+  const name = collectionNameFromEmptyWarning(message);
+  return name !== null && KNOWN_EVENTCATALOG_COLLECTIONS.has(name);
+}
+function isIntentionalEmptyCollectionLine(line) {
+  const plain = line.replace(ANSI_PATTERN, "").replace(/\r/g, "").trim();
+  const marker = 'The collection "';
+  const start = plain.indexOf(marker);
+  if (start === -1) return false;
+  const message = plain.slice(start).trim();
+  if (!isIntentionalEmptyCollectionMessage(message)) return false;
+  const before = plain.slice(0, start).trim();
+  return before.length === 0 || ASTRO_CONTENT_WARN_PREFIX.test(before);
+}
+
 // src/astro-output.ts
 var createAstroLineFilter = () => {
   return (line) => {
     const isIgnoredGetStaticPathsWarning = line.includes("[router]") && line.includes("getStaticPaths() ignored in dynamic page");
-    return line.includes("[glob-loader]") || isIgnoredGetStaticPathsWarning || /^\s*The collection ".*" does not exist or is empty\. Please check your content config file for errors\.\s*$/.test(line);
+    return line.includes("[glob-loader]") || isIgnoredGetStaticPathsWarning || isIntentionalEmptyCollectionLine(line);
   };
 };
 var createAstroDevLineFilter = () => {
@@ -1958,18 +2064,18 @@ var createAstroDevLineFilter = () => {
 // src/federation/federate.ts
 var import_node_crypto5 = require("crypto");
 var import_promises10 = __toESM(require("fs/promises"), 1);
-var import_node_path17 = __toESM(require("path"), 1);
+var import_node_path18 = __toESM(require("path"), 1);
 var import_sdk3 = __toESM(require("@eventcatalog/sdk"), 1);
 
 // src/federation/content-cache.ts
 var import_node_crypto2 = require("crypto");
 var import_promises5 = __toESM(require("fs/promises"), 1);
-var import_node_path12 = __toESM(require("path"), 1);
+var import_node_path13 = __toESM(require("path"), 1);
 var getContentHash = (content) => `sha256:${(0, import_node_crypto2.createHash)("sha256").update(content).digest("hex")}`;
 var isContentHash = (key) => /^sha256:[a-f0-9]{64}$/i.test(key);
 var createFederationContentCache = (projectDirectory, options = {}) => {
-  const cacheDirectory = import_node_path12.default.join(projectDirectory, ".eventcatalog-cache", "federation", "content");
-  const getCachePath = (key) => import_node_path12.default.join(cacheDirectory, encodeURIComponent(key));
+  const cacheDirectory = import_node_path13.default.join(projectDirectory, ".eventcatalog-cache", "federation", "content");
+  const getCachePath = (key) => import_node_path13.default.join(cacheDirectory, encodeURIComponent(key));
   return {
     async get(key) {
       if (options.read === false || !isContentHash(key)) return void 0;
@@ -2160,20 +2266,20 @@ var isFederationEnabled = () => (0, import_license.isEventCatalogEnterpriseEnabl
 
 // src/federation/output-transaction.ts
 var import_promises6 = __toESM(require("fs/promises"), 1);
-var import_node_path13 = __toESM(require("path"), 1);
+var import_node_path14 = __toESM(require("path"), 1);
 var getSafePublicPath = (publicDirectory, relativePath) => {
-  const normalizedPath = import_node_path13.default.posix.normalize(relativePath);
-  const unsafe = relativePath.length === 0 || relativePath.includes("\0") || relativePath.includes("\\") || import_node_path13.default.posix.isAbsolute(relativePath) || /^[a-zA-Z]:\//.test(relativePath) || normalizedPath !== relativePath || normalizedPath === ".." || normalizedPath.startsWith("../");
+  const normalizedPath = import_node_path14.default.posix.normalize(relativePath);
+  const unsafe = relativePath.length === 0 || relativePath.includes("\0") || relativePath.includes("\\") || import_node_path14.default.posix.isAbsolute(relativePath) || /^[a-zA-Z]:\//.test(relativePath) || normalizedPath !== relativePath || normalizedPath === ".." || normalizedPath.startsWith("../");
   if (unsafe) return void 0;
-  const destinationPath = import_node_path13.default.resolve(publicDirectory, relativePath);
-  const relativeDestinationPath = import_node_path13.default.relative(publicDirectory, destinationPath);
-  return relativeDestinationPath !== "" && relativeDestinationPath !== ".." && !relativeDestinationPath.startsWith(`..${import_node_path13.default.sep}`) && !import_node_path13.default.isAbsolute(relativeDestinationPath) ? destinationPath : void 0;
+  const destinationPath = import_node_path14.default.resolve(publicDirectory, relativePath);
+  const relativeDestinationPath = import_node_path14.default.relative(publicDirectory, destinationPath);
+  return relativeDestinationPath !== "" && relativeDestinationPath !== ".." && !relativeDestinationPath.startsWith(`..${import_node_path14.default.sep}`) && !import_node_path14.default.isAbsolute(relativeDestinationPath) ? destinationPath : void 0;
 };
 var beginFederationOutputTransaction = async (projectDirectory, outDir, relativePublicPaths) => {
-  const transactionDirectory = await import_promises6.default.mkdtemp(import_node_path13.default.join(projectDirectory, ".eventcatalog-federation-transaction-"));
-  const previousOutDir = import_node_path13.default.join(transactionDirectory, "federated");
-  const publicBackupDirectory = import_node_path13.default.join(transactionDirectory, "public");
-  const publicDirectory = import_node_path13.default.resolve(projectDirectory, "public");
+  const transactionDirectory = await import_promises6.default.mkdtemp(import_node_path14.default.join(projectDirectory, ".eventcatalog-federation-transaction-"));
+  const previousOutDir = import_node_path14.default.join(transactionDirectory, "federated");
+  const publicBackupDirectory = import_node_path14.default.join(transactionDirectory, "public");
+  const publicDirectory = import_node_path14.default.resolve(projectDirectory, "public");
   const publicSnapshots = [];
   const missingPublicDirectories = /* @__PURE__ */ new Set();
   let hadPreviousOutDir = false;
@@ -2184,8 +2290,8 @@ var beginFederationOutputTransaction = async (projectDirectory, outDir, relative
       try {
         const stat = await import_promises6.default.lstat(destinationPath);
         if (!stat.isFile()) continue;
-        const backupPath = import_node_path13.default.join(publicBackupDirectory, `${publicSnapshots.length}`);
-        await import_promises6.default.mkdir(import_node_path13.default.dirname(backupPath), { recursive: true });
+        const backupPath = import_node_path14.default.join(publicBackupDirectory, `${publicSnapshots.length}`);
+        await import_promises6.default.mkdir(import_node_path14.default.dirname(backupPath), { recursive: true });
         await import_promises6.default.copyFile(destinationPath, backupPath);
         publicSnapshots.push({ backupPath, destinationPath, state: "file" });
       } catch (error) {
@@ -2193,7 +2299,7 @@ var beginFederationOutputTransaction = async (projectDirectory, outDir, relative
         if (code === "ENOTDIR") continue;
         if (code !== "ENOENT") throw error;
         publicSnapshots.push({ destinationPath, state: "missing" });
-        let directory = import_node_path13.default.dirname(destinationPath);
+        let directory = import_node_path14.default.dirname(destinationPath);
         while (directory !== publicDirectory) {
           try {
             await import_promises6.default.lstat(directory);
@@ -2203,7 +2309,7 @@ var beginFederationOutputTransaction = async (projectDirectory, outDir, relative
             if (directoryCode === "ENOTDIR") break;
             if (directoryCode !== "ENOENT") throw directoryError;
             missingPublicDirectories.add(directory);
-            directory = import_node_path13.default.dirname(directory);
+            directory = import_node_path14.default.dirname(directory);
           }
         }
       }
@@ -2239,7 +2345,7 @@ var beginFederationOutputTransaction = async (projectDirectory, outDir, relative
           continue;
         }
         await attempt(async () => {
-          await import_promises6.default.mkdir(import_node_path13.default.dirname(snapshot.destinationPath), { recursive: true });
+          await import_promises6.default.mkdir(import_node_path14.default.dirname(snapshot.destinationPath), { recursive: true });
           await import_promises6.default.copyFile(snapshot.backupPath, snapshot.destinationPath);
         });
       }
@@ -2276,7 +2382,7 @@ var withFederationOutputTransaction = async (projectDirectory, outDir, relativeP
 // src/federation/public-assets.ts
 var import_node_crypto3 = require("crypto");
 var import_promises7 = __toESM(require("fs/promises"), 1);
-var import_node_path14 = __toESM(require("path"), 1);
+var import_node_path15 = __toESM(require("path"), 1);
 var getContentHash2 = (content) => `sha256:${(0, import_node_crypto3.createHash)("sha256").update(content).digest("hex")}`;
 var getFileHash = async (filePath) => {
   try {
@@ -2288,13 +2394,13 @@ var getFileHash = async (filePath) => {
   }
 };
 var getSafePath = (directory, relativePath) => {
-  const normalizedPath = import_node_path14.default.posix.normalize(relativePath);
-  const unsafe = relativePath.length === 0 || relativePath.includes("\0") || relativePath.includes("\\") || import_node_path14.default.posix.isAbsolute(relativePath) || /^[a-zA-Z]:\//.test(relativePath) || normalizedPath !== relativePath || normalizedPath === ".." || normalizedPath.startsWith("../");
+  const normalizedPath = import_node_path15.default.posix.normalize(relativePath);
+  const unsafe = relativePath.length === 0 || relativePath.includes("\0") || relativePath.includes("\\") || import_node_path15.default.posix.isAbsolute(relativePath) || /^[a-zA-Z]:\//.test(relativePath) || normalizedPath !== relativePath || normalizedPath === ".." || normalizedPath.startsWith("../");
   if (unsafe) return void 0;
-  const resolvedDirectory = import_node_path14.default.resolve(directory);
-  const resolvedPath = import_node_path14.default.resolve(resolvedDirectory, relativePath);
-  const relativeResolvedPath = import_node_path14.default.relative(resolvedDirectory, resolvedPath);
-  if (relativeResolvedPath === "" || relativeResolvedPath === ".." || relativeResolvedPath.startsWith(`..${import_node_path14.default.sep}`) || import_node_path14.default.isAbsolute(relativeResolvedPath)) {
+  const resolvedDirectory = import_node_path15.default.resolve(directory);
+  const resolvedPath = import_node_path15.default.resolve(resolvedDirectory, relativePath);
+  const relativeResolvedPath = import_node_path15.default.relative(resolvedDirectory, resolvedPath);
+  if (relativeResolvedPath === "" || relativeResolvedPath === ".." || relativeResolvedPath.startsWith(`..${import_node_path15.default.sep}`) || import_node_path15.default.isAbsolute(relativeResolvedPath)) {
     return void 0;
   }
   return resolvedPath;
@@ -2302,16 +2408,16 @@ var getSafePath = (directory, relativePath) => {
 var listFiles = async (directory, relativeDirectory = "") => {
   let entries;
   try {
-    entries = await import_promises7.default.readdir(import_node_path14.default.join(directory, relativeDirectory), { withFileTypes: true });
+    entries = await import_promises7.default.readdir(import_node_path15.default.join(directory, relativeDirectory), { withFileTypes: true });
   } catch (error) {
     if (error.code === "ENOENT") return [];
     throw error;
   }
   const files = await Promise.all(
     entries.map(async (entry) => {
-      const relativePath = import_node_path14.default.join(relativeDirectory, entry.name);
+      const relativePath = import_node_path15.default.join(relativeDirectory, entry.name);
       if (entry.isDirectory()) return listFiles(directory, relativePath);
-      return entry.isFile() ? [relativePath.split(import_node_path14.default.sep).join("/")] : [];
+      return entry.isFile() ? [relativePath.split(import_node_path15.default.sep).join("/")] : [];
     })
   );
   return files.flat().sort();
@@ -2326,19 +2432,19 @@ var pathExists = async (filePath) => {
   }
 };
 var hasBlockingParent = async (publicDirectory, destinationPath) => {
-  let currentPath = import_node_path14.default.dirname(destinationPath);
+  let currentPath = import_node_path15.default.dirname(destinationPath);
   while (currentPath !== publicDirectory) {
     try {
       if (!(await import_promises7.default.lstat(currentPath)).isDirectory()) return true;
     } catch (error) {
       if (error.code !== "ENOENT") throw error;
     }
-    currentPath = import_node_path14.default.dirname(currentPath);
+    currentPath = import_node_path15.default.dirname(currentPath);
   }
   return false;
 };
 var pruneEmptyDirectories = async (publicDirectory, filePath) => {
-  let currentPath = import_node_path14.default.dirname(filePath);
+  let currentPath = import_node_path15.default.dirname(filePath);
   while (currentPath !== publicDirectory) {
     try {
       await import_promises7.default.rmdir(currentPath);
@@ -2346,7 +2452,7 @@ var pruneEmptyDirectories = async (publicDirectory, filePath) => {
       if (!["ENOENT", "ENOTEMPTY"].includes(error.code ?? "")) throw error;
       if (error.code === "ENOTEMPTY") return;
     }
-    currentPath = import_node_path14.default.dirname(currentPath);
+    currentPath = import_node_path15.default.dirname(currentPath);
   }
 };
 var composePublicAssets = async ({
@@ -2356,8 +2462,8 @@ var composePublicAssets = async ({
   previousFiles = {},
   collisionPaths = /* @__PURE__ */ new Set()
 }) => {
-  const publicDirectory = import_node_path14.default.resolve(projectDirectory, "public");
-  const federatedPublicDirectory = import_node_path14.default.resolve(federatedDirectory, "public");
+  const publicDirectory = import_node_path15.default.resolve(projectDirectory, "public");
+  const federatedPublicDirectory = import_node_path15.default.resolve(federatedDirectory, "public");
   const sourceFiles = await listFiles(federatedPublicDirectory);
   const sourceFileSet = new Set(sourceFiles);
   const managedFiles = /* @__PURE__ */ new Set();
@@ -2393,7 +2499,7 @@ var composePublicAssets = async ({
     const asset = publicAssetsByPath.get(relativePath);
     if (!asset) throw new Error(`Cannot identify the source of federated public asset "${relativePath}"`);
     const content = await import_promises7.default.readFile(sourcePath);
-    await import_promises7.default.mkdir(import_node_path14.default.dirname(destinationPath), { recursive: true });
+    await import_promises7.default.mkdir(import_node_path15.default.dirname(destinationPath), { recursive: true });
     await import_promises7.default.writeFile(destinationPath, content);
     files[relativePath] = { source: asset.resolvedFrom.source, hash: getContentHash2(content) };
     copied += 1;
@@ -2406,17 +2512,17 @@ var composePublicAssets = async ({
 // src/federation/filesystem-source-provider.ts
 var import_node_crypto4 = require("crypto");
 var import_promises8 = __toESM(require("fs/promises"), 1);
-var import_node_path15 = __toESM(require("path"), 1);
+var import_node_path16 = __toESM(require("path"), 1);
 var import_sdk = __toESM(require("@eventcatalog/sdk"), 1);
 var FILESYSTEM_SOURCE_PREFIX = "file:";
 var isWithinDirectory = (directory, target) => {
-  const relativePath = import_node_path15.default.relative(directory, target);
-  return relativePath === "" || !relativePath.startsWith(`..${import_node_path15.default.sep}`) && relativePath !== ".." && !import_node_path15.default.isAbsolute(relativePath);
+  const relativePath = import_node_path16.default.relative(directory, target);
+  return relativePath === "" || !relativePath.startsWith(`..${import_node_path16.default.sep}`) && relativePath !== ".." && !import_node_path16.default.isAbsolute(relativePath);
 };
 var assertPortableRelativePath = (filePath, label, allowRoot = true) => {
   const portablePath = filePath.replaceAll("\\", "/");
-  const normalizedPath = import_node_path15.default.posix.normalize(portablePath);
-  const isUnsafe = filePath.includes("\\") || filePath.includes("\0") || import_node_path15.default.posix.isAbsolute(normalizedPath) || /^[a-zA-Z]:\//.test(normalizedPath) || normalizedPath === ".." || normalizedPath.startsWith("../") || !allowRoot && (normalizedPath === "." || normalizedPath === "");
+  const normalizedPath = import_node_path16.default.posix.normalize(portablePath);
+  const isUnsafe = filePath.includes("\\") || filePath.includes("\0") || import_node_path16.default.posix.isAbsolute(normalizedPath) || /^[a-zA-Z]:\//.test(normalizedPath) || normalizedPath === ".." || normalizedPath.startsWith("../") || !allowRoot && (normalizedPath === "." || normalizedPath === "");
   if (isUnsafe) throw new Error(`${label} "${filePath}" escapes its filesystem source`);
   return normalizedPath;
 };
@@ -2426,13 +2532,13 @@ var getSourceRoot = (projectDirectory, source) => {
   }
   const locator = source.source.slice(FILESYSTEM_SOURCE_PREFIX.length);
   if (!locator.trim()) throw new Error(`Filesystem federation source "${source.id}" requires a path after "file:".`);
-  return import_node_path15.default.resolve(projectDirectory, locator);
+  return import_node_path16.default.resolve(projectDirectory, locator);
 };
 var getCatalogDirectory = async (projectDirectory, source) => {
   if (source.ref) throw new Error(`Filesystem federation source "${source.id}" does not support "ref".`);
   const sourceRoot = getSourceRoot(projectDirectory, source);
   const catalogPath = assertPortableRelativePath(source.path ?? ".", "Catalog path");
-  const catalogDirectory = import_node_path15.default.resolve(sourceRoot, ...catalogPath.split("/"));
+  const catalogDirectory = import_node_path16.default.resolve(sourceRoot, ...catalogPath.split("/"));
   if (!isWithinDirectory(sourceRoot, catalogDirectory)) {
     throw new Error(`Catalog path "${source.path}" escapes source "${source.id}"`);
   }
@@ -2454,7 +2560,7 @@ var getCatalogDirectory = async (projectDirectory, source) => {
 };
 var getArtifactPath = async (catalogDirectory, source, artifactPath) => {
   const normalizedPath = assertPortableRelativePath(artifactPath, "Federated artifact path", false);
-  const filePath = import_node_path15.default.resolve(catalogDirectory, ...normalizedPath.split("/"));
+  const filePath = import_node_path16.default.resolve(catalogDirectory, ...normalizedPath.split("/"));
   if (!isWithinDirectory(catalogDirectory, filePath)) {
     throw new Error(`Federated artifact path "${artifactPath}" escapes source "${source.id}"`);
   }
@@ -2494,7 +2600,7 @@ var createFileSystemSourceProvider = (projectDirectory) => ({
 var import_node_child_process = require("child_process");
 var import_promises9 = __toESM(require("fs/promises"), 1);
 var import_node_os4 = __toESM(require("os"), 1);
-var import_node_path16 = __toESM(require("path"), 1);
+var import_node_path17 = __toESM(require("path"), 1);
 var import_node_util = require("util");
 var import_sdk2 = __toESM(require("@eventcatalog/sdk"), 1);
 var execFileAsync = (0, import_node_util.promisify)(import_node_child_process.execFile);
@@ -2505,8 +2611,8 @@ var parseGitHubSource = (source) => {
 };
 var assertSafeCatalogPath = (source) => {
   const catalogPath = source.path ?? ".";
-  const normalized = import_node_path16.default.posix.normalize(catalogPath.replaceAll("\\", "/"));
-  if (catalogPath.includes("\\") || import_node_path16.default.posix.isAbsolute(normalized) || normalized === ".." || normalized.startsWith("../")) {
+  const normalized = import_node_path17.default.posix.normalize(catalogPath.replaceAll("\\", "/"));
+  if (catalogPath.includes("\\") || import_node_path17.default.posix.isAbsolute(normalized) || normalized === ".." || normalized.startsWith("../")) {
     throw new Error(`Catalog path "${catalogPath}" escapes source "${source.id}"`);
   }
 };
@@ -2549,8 +2655,8 @@ var getGitEnvironment = (token) => {
 };
 var createCheckout = (executeFile, token) => async (source, ref, callback) => {
   const { owner, repository } = parseGitHubSource(source);
-  const catalogPath = import_node_path16.default.posix.normalize(source.path ?? ".");
-  const directory = await import_promises9.default.mkdtemp(import_node_path16.default.join(import_node_os4.default.tmpdir(), "eventcatalog-federation-"));
+  const catalogPath = import_node_path17.default.posix.normalize(source.path ?? ".");
+  const directory = await import_promises9.default.mkdtemp(import_node_path17.default.join(import_node_os4.default.tmpdir(), "eventcatalog-federation-"));
   const env = getGitEnvironment(token);
   try {
     const git = (args) => executeFile("git", args, { cwd: directory, env, encoding: "utf8" });
@@ -2570,16 +2676,16 @@ var createCheckout = (executeFile, token) => async (source, ref, callback) => {
 var generateIndex = async (source, ref, checkout, executeFile) => checkout(source, ref, async (directory) => {
   const { stdout } = await executeFile("git", ["rev-parse", "HEAD"], { cwd: directory, encoding: "utf8" });
   const commit = stdout.trim();
-  const catalogDirectory = import_node_path16.default.resolve(directory, source.path ?? ".");
-  const relativeCatalogDirectory = import_node_path16.default.relative(directory, catalogDirectory);
-  if (relativeCatalogDirectory.startsWith("..") || import_node_path16.default.isAbsolute(relativeCatalogDirectory)) {
+  const catalogDirectory = import_node_path17.default.resolve(directory, source.path ?? ".");
+  const relativeCatalogDirectory = import_node_path17.default.relative(directory, catalogDirectory);
+  if (relativeCatalogDirectory.startsWith("..") || import_node_path17.default.isAbsolute(relativeCatalogDirectory)) {
     throw new Error(`Catalog path "${source.path}" escapes source "${source.id}"`);
   }
   const index = await (0, import_sdk2.default)(catalogDirectory).buildIndex({ source: source.id, commit });
   return { bytes: Buffer.from(JSON.stringify(index)), index, commit, generated: true };
 });
 var fetchPublishedIndex = async (source, ref, fetcher, token) => {
-  const indexPath = import_node_path16.default.posix.join(source.path ?? ".", "catalog.index.json");
+  const indexPath = import_node_path17.default.posix.join(source.path ?? ".", "catalog.index.json");
   const bytes = await fetchBytes(source, ref, indexPath, fetcher, token);
   if (!bytes) return void 0;
   const index = (0, import_sdk2.parseIndex)(JSON.parse(bytes.toString("utf8")));
@@ -2602,7 +2708,7 @@ var createGitHubSourceProvider = (options = {}) => {
     },
     async fetchContent({ source, commit, path: artifactPath }) {
       assertSafeCatalogPath(source);
-      const catalogPath = import_node_path16.default.posix.join(source.path ?? ".", artifactPath);
+      const catalogPath = import_node_path17.default.posix.join(source.path ?? ".", artifactPath);
       const content = await fetchBytes(source, commit, catalogPath, fetcher, token);
       if (!content) throw new Error(`Federated artifact not found for "${source.id}": ${artifactPath}`);
       return content;
@@ -2713,8 +2819,8 @@ var pathExists2 = async (filePath) => {
   }
 };
 var cleanupPreviousFederation = async (projectDirectory, onProgress) => {
-  const outDir = import_node_path17.default.join(projectDirectory, "federated");
-  const lockPath = import_node_path17.default.join(projectDirectory, "eventcatalog.lock");
+  const outDir = import_node_path18.default.join(projectDirectory, "federated");
+  const lockPath = import_node_path18.default.join(projectDirectory, "eventcatalog.lock");
   const previousLock = await readLock(lockPath);
   const hadFederatedOutput = await pathExists2(outDir);
   const hadLock = previousLock !== void 0;
@@ -2779,8 +2885,8 @@ var federateCatalog = async (projectDirectory, options = {}) => {
       throw new Error(`Failed to federate source "${source.id}": ${message}`, { cause: error });
     }
   }
-  const outDir = import_node_path17.default.join(projectDirectory, "federated");
-  const lockPath = import_node_path17.default.join(projectDirectory, "eventcatalog.lock");
+  const outDir = import_node_path18.default.join(projectDirectory, "federated");
+  const lockPath = import_node_path18.default.join(projectDirectory, "eventcatalog.lock");
   const previousLock = await readLock(lockPath);
   const resources = resolvedSources.reduce((total, source) => total + source.resolved.index.resources.length, 0);
   const remoteIndexes = resolvedSources.map(({ resolved }) => resolved.index);
@@ -2876,16 +2982,31 @@ var federateCatalog = async (projectDirectory, options = {}) => {
   return result;
 };
 
+// src/update-check.ts
+var import_semver = require("semver");
+var resolveInstalledCoreVersion = (runningVersion, declaredDependency) => {
+  if ((0, import_semver.valid)(runningVersion)) return runningVersion;
+  if (declaredDependency && (0, import_semver.valid)(declaredDependency)) return declaredDependency;
+  return null;
+};
+var getEventCatalogUpdateMessage = (current, latest) => {
+  if (!latest || !(0, import_semver.valid)(current) || !(0, import_semver.valid)(latest) || !(0, import_semver.gt)(latest, current)) {
+    return null;
+  }
+  return `EventCatalog update available ${current} \u2192 ${latest}
+Run npm i @eventcatalog/core to update`;
+};
+
 // src/eventcatalog.ts
 var import_license2 = require("@eventcatalog/license");
-var currentDir = import_node_path19.default.dirname((0, import_node_url.fileURLToPath)(importMetaUrl));
+var currentDir = import_node_path20.default.dirname((0, import_node_url.fileURLToPath)(importMetaUrl));
 var program = new import_commander.Command().version(VERSION);
-var dir = import_node_path19.default.resolve(process.env.PROJECT_DIR || process.cwd());
-var core = import_node_path19.default.resolve(process.env.CATALOG_DIR || (0, import_node_path18.join)(dir, ".eventcatalog-core"));
-var eventCatalogDir = import_node_path19.default.resolve((0, import_node_path18.join)(currentDir, "../eventcatalog/"));
+var dir = import_node_path20.default.resolve(process.env.PROJECT_DIR || process.cwd());
+var core = import_node_path20.default.resolve(process.env.CATALOG_DIR || (0, import_node_path19.join)(dir, ".eventcatalog-core"));
+var eventCatalogDir = import_node_path20.default.resolve((0, import_node_path19.join)(currentDir, "../eventcatalog/"));
 var getInstalledEventCatalogVersion = () => {
   try {
-    const pkg = import_fs3.default.readFileSync((0, import_node_path18.join)(dir, "package.json"), "utf8");
+    const pkg = import_fs3.default.readFileSync((0, import_node_path19.join)(dir, "package.json"), "utf8");
     const json = JSON.parse(pkg);
     return json.dependencies["@eventcatalog/core"];
   } catch (error) {
@@ -2951,12 +3072,12 @@ var startDevPrewarm = ({
 var buildDevSearchIndex = async ({ config }) => {
   const result = await buildSearchIndex({
     projectDir: dir,
-    outDir: import_node_path19.default.join(core, "public"),
-    searchOutputPath: import_node_path19.default.join(core, "public", "pagefind"),
+    outDir: import_node_path20.default.join(core, "public"),
+    searchOutputPath: import_node_path20.default.join(core, "public", "pagefind"),
     config,
     isServer: false
   });
-  logger.info(`Indexed ${result.records} page(s) into ${import_node_path19.default.relative(core, result.outputPath)}`, "search");
+  logger.info(`Indexed ${result.records} page(s) into ${import_node_path20.default.relative(core, result.outputPath)}`, "search");
 };
 var warnIfIndexedSearchUsesAuth = async () => {
   if (!await isAuthEnabled()) {
@@ -3070,13 +3191,10 @@ var copyCore = () => {
   }
   import_fs3.default.cpSync(eventCatalogDir, core, {
     recursive: true,
-    filter: (src) => {
-      const relativePath = import_node_path19.default.relative(eventCatalogDir, src);
-      const pathParts = relativePath.split(import_node_path19.default.sep);
-      return !pathParts.some((part) => [".astro", "dist", "node_modules"].includes(part));
-    }
+    filter: (src) => shouldCopyCoreEntry(eventCatalogDir, src)
   });
-  const coreNodeModules = import_node_path19.default.join(core, "node_modules");
+  pruneExcludedCoreEntries(core);
+  const coreNodeModules = import_node_path20.default.join(core, "node_modules");
   const installedCoreNodeModules = resolveInstalledCoreNodeModules(currentDir);
   linkCoreNodeModules({ coreNodeModules, installedCoreNodeModules });
 };
@@ -3084,13 +3202,13 @@ var clearCore = () => {
   if (import_fs3.default.existsSync(core)) import_fs3.default.rmSync(core, { recursive: true });
 };
 var checkForUpdate = () => {
-  const installedVersion = getInstalledEventCatalogVersion();
-  if (!installedVersion) return;
-  const majorVersion = parseInt(installedVersion.replace(/[^0-9.]/g, "").split(".")[0], 10);
+  const declaredVersion = getInstalledEventCatalogVersion();
+  if (!declaredVersion) return;
+  const majorVersion = parseInt(declaredVersion.replace(/[^0-9.]/g, "").split(".")[0], 10);
   if (majorVersion < 3) {
     const v3Message = `\u{1F680} EventCatalog V3 is now available in beta!
 
-You are currently on version ${installedVersion}.
+You are currently on version ${declaredVersion}.
 V3 brings exciting new features and improvements.
 
 Upgrade now: npm i @eventcatalog/core@beta`;
@@ -3105,11 +3223,12 @@ Upgrade now: npm i @eventcatalog/core@beta`;
     );
     return;
   }
+  const installedVersion = resolveInstalledCoreVersion(VERSION, declaredVersion);
+  if (!installedVersion) return;
   const pkg = { name: "@eventcatalog/core", version: installedVersion };
   const notifier = (0, import_update_notifier.default)({ pkg, updateCheckInterval: 0 });
-  if (notifier.update) {
-    const message = `EventCatalog update available ${notifier.update.current} \u2192 ${notifier.update.latest}
-Run npm i @eventcatalog/core to update`;
+  const message = getEventCatalogUpdateMessage(installedVersion, notifier.update?.latest);
+  if (message) {
     console.log(
       (0, import_boxen.default)(message, {
         padding: 1,
@@ -3135,8 +3254,8 @@ program.command("dev").description("Run development server of EventCatalog").opt
   logger.info("Setting up EventCatalog...", "eventcatalog");
   const isServer = await isOutputServer();
   logger.info(isServer ? "EventCatalog is running in Server Mode" : "EventCatalog is running in Static Mode", "config");
-  if (import_fs3.default.existsSync(import_node_path19.default.join(dir, ".env"))) {
-    import_dotenv.default.config({ path: import_node_path19.default.join(dir, ".env") });
+  if (import_fs3.default.existsSync(import_node_path20.default.join(dir, ".env"))) {
+    import_dotenv.default.config({ path: import_node_path20.default.join(dir, ".env") });
   }
   if (options.debug) {
     logger.info("Debug mode enabled", "debug");
@@ -3222,8 +3341,8 @@ program.command("build").description("Run build of EventCatalog").action(async (
   logger.info("Building EventCatalog...", "build");
   const isServer = await isOutputServer();
   logger.info(isServer ? "EventCatalog is running in Server Mode" : "EventCatalog is running in Static Mode", "config");
-  if (import_fs3.default.existsSync(import_node_path19.default.join(dir, ".env"))) {
-    import_dotenv.default.config({ path: import_node_path19.default.join(dir, ".env") });
+  if (import_fs3.default.existsSync(import_node_path20.default.join(dir, ".env"))) {
+    import_dotenv.default.config({ path: import_node_path20.default.join(dir, ".env") });
   }
   await verifyRequiredFieldsAreInCatalogConfigFile(dir);
   copyCore();
@@ -3274,7 +3393,7 @@ program.command("build").description("Run build of EventCatalog").action(async (
   if (await isIndexedSearchEnabled()) {
     await warnIfIndexedSearchUsesAuth();
     const config = await getEventCatalogConfigFile(dir);
-    const outDir = import_node_path19.default.resolve(dir, await getProjectOutDir());
+    const outDir = import_node_path20.default.resolve(dir, await getProjectOutDir());
     logger.info("Building indexed search...", "search");
     const result = await buildSearchIndex({
       projectDir: dir,
@@ -3282,7 +3401,7 @@ program.command("build").description("Run build of EventCatalog").action(async (
       config,
       isServer
     });
-    logger.info(`Indexed ${result.records} page(s) into ${import_node_path19.default.relative(dir, result.outputPath)}`, "search");
+    logger.info(`Indexed ${result.records} page(s) into ${import_node_path20.default.relative(dir, result.outputPath)}`, "search");
   }
 });
 var previewCatalog = async ({
@@ -3309,7 +3428,7 @@ var startServerCatalog = async ({
   isEventCatalogStarter = false,
   isEventCatalogScale = false
 }) => {
-  const serverEntryPath = import_node_path19.default.join(dir, "dist", "server", "entry.mjs");
+  const serverEntryPath = import_node_path20.default.join(dir, "dist", "server", "entry.mjs");
   await runCommandWithFilteredOutput({
     command: `node "${serverEntryPath}"`,
     cwd: core,
@@ -3326,8 +3445,8 @@ var startServerCatalog = async ({
 program.command("preview").description("Serves the contents of your eventcatalog build directory").action(async (options, command) => {
   logger.welcome();
   logger.info("Starting preview of your build...", "preview");
-  if (import_fs3.default.existsSync(import_node_path19.default.join(dir, ".env"))) {
-    import_dotenv.default.config({ path: import_node_path19.default.join(dir, ".env") });
+  if (import_fs3.default.existsSync(import_node_path20.default.join(dir, ".env"))) {
+    import_dotenv.default.config({ path: import_node_path20.default.join(dir, ".env") });
   }
   const canEmbedPages = await (0, import_license2.isFeatureEnabled)(
     "@eventcatalog/backstage-plugin-eventcatalog",
@@ -3345,8 +3464,8 @@ program.command("preview").description("Serves the contents of your eventcatalog
 program.command("start").description("Serves the contents of your eventcatalog build directory").action(async (options, command) => {
   logger.welcome();
   logger.info("Starting preview of your build...", "preview");
-  if (import_fs3.default.existsSync(import_node_path19.default.join(dir, ".env"))) {
-    import_dotenv.default.config({ path: import_node_path19.default.join(dir, ".env") });
+  if (import_fs3.default.existsSync(import_node_path20.default.join(dir, ".env"))) {
+    import_dotenv.default.config({ path: import_node_path20.default.join(dir, ".env") });
   }
   const canEmbedPages = await (0, import_license2.isFeatureEnabled)(
     "@eventcatalog/backstage-plugin-eventcatalog",
@@ -3373,22 +3492,22 @@ program.command("start").description("Serves the contents of your eventcatalog b
 program.command("export").description("Export your EventCatalog using the SDK dumpCatalog function").option("--include-markdown", "Include markdown content in the export", false).action(async (options) => {
   logger.welcome();
   logger.info("Exporting EventCatalog...", "export");
-  if (import_fs3.default.existsSync(import_node_path19.default.join(dir, ".env"))) {
-    import_dotenv.default.config({ path: import_node_path19.default.join(dir, ".env") });
+  if (import_fs3.default.existsSync(import_node_path20.default.join(dir, ".env"))) {
+    import_dotenv.default.config({ path: import_node_path20.default.join(dir, ".env") });
   }
   const { default: initSDK } = await import("@eventcatalog/sdk");
   const sdk = initSDK(dir);
   const catalog = await sdk.dumpCatalog({ includeMarkdown: options.includeMarkdown });
-  const exportsDir = import_node_path19.default.join(dir, "exports");
+  const exportsDir = import_node_path20.default.join(dir, "exports");
   ensureDir(exportsDir);
   const date = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
-  const exportFile = import_node_path19.default.join(exportsDir, `catalog-${date}.json`);
+  const exportFile = import_node_path20.default.join(exportsDir, `catalog-${date}.json`);
   import_fs3.default.writeFileSync(exportFile, JSON.stringify(catalog, null, 2), "utf-8");
   logger.info(`Catalog exported to ${exportFile}`, "export");
 });
 program.command("generate [siteDir]").description("Start the generator scripts.").action(async () => {
-  if (import_fs3.default.existsSync(import_node_path19.default.join(dir, ".env"))) {
-    import_dotenv.default.config({ path: import_node_path19.default.join(dir, ".env") });
+  if (import_fs3.default.existsSync(import_node_path20.default.join(dir, ".env"))) {
+    import_dotenv.default.config({ path: import_node_path20.default.join(dir, ".env") });
   }
   await generate(dir);
 });
@@ -3461,7 +3580,7 @@ var reportFederationProgress = (event, verbose = false) => {
       }
       return;
     case "hydrating":
-      logger.info(`Hydrating federated content into ${import_node_path19.default.relative(dir, event.outDir)}/...`, "federation");
+      logger.info(`Hydrating federated content into ${import_node_path20.default.relative(dir, event.outDir)}/...`, "federation");
       return;
     case "hydrate:cache":
       if (event.files === 1 || event.files % 25 === 0) {
@@ -3484,13 +3603,13 @@ var reportFederationProgress = (event, verbose = false) => {
         `Federation complete: ${event.result.sources} sources, ${event.result.resources} remote resources, ${event.result.hydrate.written} files written (${event.result.hydrate.fetched} downloaded, ${event.result.hydrate.written - event.result.hydrate.fetched} cached)`,
         "federation"
       );
-      logger.info(`Recorded resolved source state in ${import_node_path19.default.relative(dir, event.result.lockPath)}`, "federation");
+      logger.info(`Recorded resolved source state in ${import_node_path20.default.relative(dir, event.result.lockPath)}`, "federation");
   }
 };
 program.command("federate").description("Fetch, resolve, and hydrate the catalogs configured in federation.sources.").option("--no-cache", "Download all federation content and refresh the cache.").option("-v, --verbose", "Show detailed federation diagnostics.").action(async (commandOptions) => {
   logger.welcome();
-  if (import_fs3.default.existsSync(import_node_path19.default.join(dir, ".env"))) {
-    import_dotenv.default.config({ path: import_node_path19.default.join(dir, ".env") });
+  if (import_fs3.default.existsSync(import_node_path20.default.join(dir, ".env"))) {
+    import_dotenv.default.config({ path: import_node_path20.default.join(dir, ".env") });
   }
   logger.info("Starting federation...", "federation");
   let cleanedPreviousOutput = false;