@eventcatalog/core 4.0.7 → 4.1.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.0.7";
+var version = "4.1.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/analytics.js

@@ -1,7 +1,7 @@
 import {
   raiseEvent
-} from "../chunk-WDA5QYVD.js";
-import "../chunk-RBBWHWE4.js";
+} from "../chunk-PL4YZUAA.js";
+import "../chunk-OQ36RUHT.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.0.7";
+var version = "4.1.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/log-build.js

@@ -1,9 +1,9 @@
 import {
   log_build_default
-} from "../chunk-ARHL5SPG.js";
-import "../chunk-WDA5QYVD.js";
+} from "../chunk-2T6ESD3L.js";
+import "../chunk-PL4YZUAA.js";
 import "../chunk-DAOXTQVS.js";
-import "../chunk-RBBWHWE4.js";
+import "../chunk-OQ36RUHT.js";
 import "../chunk-6QENHZZP.js";
 export {
   log_build_default as default

package/dist/catalog-to-astro-content-directory.cjs

@@ -149,6 +149,7 @@ var verifyRequiredFieldsAreInCatalogConfigFile = async (projectDirectory) => {
 
 // src/map-catalog-to-astro.js
 var import_node_path2 = __toESM(require("path"), 1);
+var CUSTOM_PAGE_EXTENSIONS = [".astro", ".ts", ".js", ".mjs"];
 var COLLECTION_KEYS = [
   "agents",
   "events",
@@ -171,6 +172,10 @@ function mapCatalogToAstro({ filePath, astroDir, projectDir }) {
   if (!isCatalogRelated(relativeFilePath)) {
     return [];
   }
+  const customPageTargetPaths = getCustomPageTargetPaths(relativeFilePath, astroDir);
+  if (customPageTargetPaths) {
+    return customPageTargetPaths;
+  }
   const baseTargetPaths = getBaseTargetPaths(relativeFilePath);
   const relativeTargetPath = getRelativeTargetPath(relativeFilePath);
   return baseTargetPaths.map((base) => import_node_path2.default.join(astroDir, base, relativeTargetPath));
@@ -185,6 +190,21 @@ function isCollectionKey(key) {
 function isLikeC4Source(filePath) {
   return filePath.endsWith(".c4") || filePath.endsWith(".likec4");
 }
+var hasExtension = (str) => /\.[a-zA-Z0-9]{2,}$/.test(str);
+function getCustomPageTargetPaths(filePath, astroDir) {
+  const filePathArr = filePath.split(import_node_path2.default.sep).filter(Boolean);
+  if (filePathArr[0] !== "pages") {
+    return null;
+  }
+  const customPagePath = import_node_path2.default.join(astroDir, "src", "custom-pages", ...filePathArr.slice(1));
+  if (CUSTOM_PAGE_EXTENSIONS.includes(import_node_path2.default.extname(filePath).toLowerCase())) {
+    return [customPagePath];
+  }
+  if (!hasExtension(filePath)) {
+    return [customPagePath, import_node_path2.default.join(astroDir, "public", "generated", ...filePathArr)];
+  }
+  return [import_node_path2.default.join(astroDir, "public", "generated", ...filePathArr)];
+}
 function isCatalogRelated(filePath) {
   const filePathArr = filePath.split(import_node_path2.default.sep).filter(Boolean);
   if ([
@@ -209,7 +229,6 @@ function isCatalogRelated(filePath) {
 function getBaseTargetPaths(filePath) {
   const filePathArr = filePath.split(import_node_path2.default.sep).filter(Boolean);
   if (isCollectionKey(filePathArr[0])) {
-    const hasExtension = (str) => /\.[a-zA-Z0-9]{2,}$/.test(str);
     if (hasExtension(filePath)) {
       return [import_node_path2.default.join("public", "generated")];
     }
@@ -272,6 +291,17 @@ var copyFiles = async (source, target) => {
     });
   }
 };
+var clearCustomPages = async (target) => {
+  const customPagesDir = path3.join(target, "src", "custom-pages");
+  if (import_fs.default.existsSync(customPagesDir)) import_fs.default.rmSync(customPagesDir, { recursive: true });
+  const staleCodeFiles = await (0, import_glob.glob)(path3.join(target, "public", "generated", "pages", "**/*.{astro,ts,js,mjs}"), {
+    nodir: true,
+    windowsPathsNoEscape: import_node_os2.default.platform() == "win32"
+  });
+  for (const file of staleCodeFiles) {
+    import_fs.default.rmSync(file);
+  }
+};
 var removeGeneratedLikeC4Sources = async (target) => {
   const generatedDir = path3.join(target, "public", "generated");
   const files = await (0, import_glob.glob)(path3.join(generatedDir, "**/*.{c4,likec4}"), {
@@ -290,6 +320,7 @@ var catalogToAstro = async (source, astroDir) => {
   if (!import_fs.default.existsSync(path3.join(source, "eventcatalog.styles.css"))) {
     import_fs.default.writeFileSync(path3.join(source, "eventcatalog.styles.css"), "");
   }
+  await clearCustomPages(astroDir);
   await removeGeneratedLikeC4Sources(astroDir);
   await copyFiles(source, astroDir);
 };

package/dist/catalog-to-astro-content-directory.js

@@ -1,7 +1,7 @@
 import {
   catalogToAstro
-} from "./chunk-WQNKHIDM.js";
-import "./chunk-VC6VUJIX.js";
+} from "./chunk-W3SAPOZU.js";
+import "./chunk-W5JQON7Z.js";
 import "./chunk-6QENHZZP.js";
 export {
   catalogToAstro

package/dist/{chunk-ZOFYLCPF.js → chunk-2PPDVKNK.js}

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

package/dist/{chunk-ARHL5SPG.js → chunk-2T6ESD3L.js}

@@ -1,6 +1,6 @@
 import {
   raiseEvent
-} from "./chunk-WDA5QYVD.js";
+} from "./chunk-PL4YZUAA.js";
 import {
   countResources,
   serializeCounts

package/dist/{chunk-O3Y2G6CY.js → chunk-CAJUIMDJ.js}

@@ -1,6 +1,6 @@
 import {
   mapCatalogToAstro
-} from "./chunk-VC6VUJIX.js";
+} from "./chunk-W5JQON7Z.js";
 
 // src/watcher.js
 import watcher from "@parcel/watcher";

package/dist/{chunk-RBBWHWE4.js → chunk-OQ36RUHT.js}

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

package/dist/{chunk-WDA5QYVD.js → chunk-PL4YZUAA.js}

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

package/dist/{chunk-IMCMPLIJ.js → chunk-RXZKZGDC.js}

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

package/dist/{chunk-WQNKHIDM.js → chunk-W3SAPOZU.js}

@@ -1,6 +1,6 @@
 import {
   mapCatalogToAstro
-} from "./chunk-VC6VUJIX.js";
+} from "./chunk-W5JQON7Z.js";
 import {
   verifyRequiredFieldsAreInCatalogConfigFile
 } from "./chunk-6QENHZZP.js";
@@ -40,6 +40,17 @@ var copyFiles = async (source, target) => {
     });
   }
 };
+var clearCustomPages = async (target) => {
+  const customPagesDir = path.join(target, "src", "custom-pages");
+  if (fs.existsSync(customPagesDir)) fs.rmSync(customPagesDir, { recursive: true });
+  const staleCodeFiles = await glob(path.join(target, "public", "generated", "pages", "**/*.{astro,ts,js,mjs}"), {
+    nodir: true,
+    windowsPathsNoEscape: os.platform() == "win32"
+  });
+  for (const file of staleCodeFiles) {
+    fs.rmSync(file);
+  }
+};
 var removeGeneratedLikeC4Sources = async (target) => {
   const generatedDir = path.join(target, "public", "generated");
   const files = await glob(path.join(generatedDir, "**/*.{c4,likec4}"), {
@@ -58,6 +69,7 @@ var catalogToAstro = async (source, astroDir) => {
   if (!fs.existsSync(path.join(source, "eventcatalog.styles.css"))) {
     fs.writeFileSync(path.join(source, "eventcatalog.styles.css"), "");
   }
+  await clearCustomPages(astroDir);
   await removeGeneratedLikeC4Sources(astroDir);
   await copyFiles(source, astroDir);
 };

package/dist/{chunk-VC6VUJIX.js → chunk-W5JQON7Z.js}

@@ -1,5 +1,6 @@
 // src/map-catalog-to-astro.js
 import path from "path";
+var CUSTOM_PAGE_EXTENSIONS = [".astro", ".ts", ".js", ".mjs"];
 var COLLECTION_KEYS = [
   "agents",
   "events",
@@ -22,6 +23,10 @@ function mapCatalogToAstro({ filePath, astroDir, projectDir }) {
   if (!isCatalogRelated(relativeFilePath)) {
     return [];
   }
+  const customPageTargetPaths = getCustomPageTargetPaths(relativeFilePath, astroDir);
+  if (customPageTargetPaths) {
+    return customPageTargetPaths;
+  }
   const baseTargetPaths = getBaseTargetPaths(relativeFilePath);
   const relativeTargetPath = getRelativeTargetPath(relativeFilePath);
   return baseTargetPaths.map((base) => path.join(astroDir, base, relativeTargetPath));
@@ -36,6 +41,21 @@ function isCollectionKey(key) {
 function isLikeC4Source(filePath) {
   return filePath.endsWith(".c4") || filePath.endsWith(".likec4");
 }
+var hasExtension = (str) => /\.[a-zA-Z0-9]{2,}$/.test(str);
+function getCustomPageTargetPaths(filePath, astroDir) {
+  const filePathArr = filePath.split(path.sep).filter(Boolean);
+  if (filePathArr[0] !== "pages") {
+    return null;
+  }
+  const customPagePath = path.join(astroDir, "src", "custom-pages", ...filePathArr.slice(1));
+  if (CUSTOM_PAGE_EXTENSIONS.includes(path.extname(filePath).toLowerCase())) {
+    return [customPagePath];
+  }
+  if (!hasExtension(filePath)) {
+    return [customPagePath, path.join(astroDir, "public", "generated", ...filePathArr)];
+  }
+  return [path.join(astroDir, "public", "generated", ...filePathArr)];
+}
 function isCatalogRelated(filePath) {
   const filePathArr = filePath.split(path.sep).filter(Boolean);
   if ([
@@ -60,7 +80,6 @@ function isCatalogRelated(filePath) {
 function getBaseTargetPaths(filePath) {
   const filePathArr = filePath.split(path.sep).filter(Boolean);
   if (isCollectionKey(filePathArr[0])) {
-    const hasExtension = (str) => /\.[a-zA-Z0-9]{2,}$/.test(str);
     if (hasExtension(filePath)) {
       return [path.join("public", "generated")];
     }

package/dist/constants.cjs

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

package/dist/constants.js

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

package/dist/eventcatalog.cjs

@@ -144,7 +144,7 @@ var verifyRequiredFieldsAreInCatalogConfigFile = async (projectDirectory) => {
 var import_picocolors = __toESM(require("picocolors"), 1);
 
 // package.json
-var version = "4.0.7";
+var version = "4.1.0";
 
 // src/constants.ts
 var VERSION = version;
@@ -416,6 +416,7 @@ var import_node_fs2 = __toESM(require("fs"), 1);
 
 // src/map-catalog-to-astro.js
 var import_node_path3 = __toESM(require("path"), 1);
+var CUSTOM_PAGE_EXTENSIONS = [".astro", ".ts", ".js", ".mjs"];
 var COLLECTION_KEYS = [
   "agents",
   "events",
@@ -438,6 +439,10 @@ function mapCatalogToAstro({ filePath, astroDir, projectDir }) {
   if (!isCatalogRelated(relativeFilePath)) {
     return [];
   }
+  const customPageTargetPaths = getCustomPageTargetPaths(relativeFilePath, astroDir);
+  if (customPageTargetPaths) {
+    return customPageTargetPaths;
+  }
   const baseTargetPaths = getBaseTargetPaths(relativeFilePath);
   const relativeTargetPath = getRelativeTargetPath(relativeFilePath);
   return baseTargetPaths.map((base) => import_node_path3.default.join(astroDir, base, relativeTargetPath));
@@ -452,6 +457,21 @@ function isCollectionKey(key) {
 function isLikeC4Source(filePath) {
   return filePath.endsWith(".c4") || filePath.endsWith(".likec4");
 }
+var hasExtension = (str) => /\.[a-zA-Z0-9]{2,}$/.test(str);
+function getCustomPageTargetPaths(filePath, astroDir) {
+  const filePathArr = filePath.split(import_node_path3.default.sep).filter(Boolean);
+  if (filePathArr[0] !== "pages") {
+    return null;
+  }
+  const customPagePath = import_node_path3.default.join(astroDir, "src", "custom-pages", ...filePathArr.slice(1));
+  if (CUSTOM_PAGE_EXTENSIONS.includes(import_node_path3.default.extname(filePath).toLowerCase())) {
+    return [customPagePath];
+  }
+  if (!hasExtension(filePath)) {
+    return [customPagePath, import_node_path3.default.join(astroDir, "public", "generated", ...filePathArr)];
+  }
+  return [import_node_path3.default.join(astroDir, "public", "generated", ...filePathArr)];
+}
 function isCatalogRelated(filePath) {
   const filePathArr = filePath.split(import_node_path3.default.sep).filter(Boolean);
   if ([
@@ -476,7 +496,6 @@ function isCatalogRelated(filePath) {
 function getBaseTargetPaths(filePath) {
   const filePathArr = filePath.split(import_node_path3.default.sep).filter(Boolean);
   if (isCollectionKey(filePathArr[0])) {
-    const hasExtension = (str) => /\.[a-zA-Z0-9]{2,}$/.test(str);
     if (hasExtension(filePath)) {
       return [import_node_path3.default.join("public", "generated")];
     }
@@ -635,6 +654,17 @@ var copyFiles = async (source, target) => {
     });
   }
 };
+var clearCustomPages = async (target) => {
+  const customPagesDir = path4.join(target, "src", "custom-pages");
+  if (import_fs.default.existsSync(customPagesDir)) import_fs.default.rmSync(customPagesDir, { recursive: true });
+  const staleCodeFiles = await (0, import_glob2.glob)(path4.join(target, "public", "generated", "pages", "**/*.{astro,ts,js,mjs}"), {
+    nodir: true,
+    windowsPathsNoEscape: import_node_os2.default.platform() == "win32"
+  });
+  for (const file of staleCodeFiles) {
+    import_fs.default.rmSync(file);
+  }
+};
 var removeGeneratedLikeC4Sources = async (target) => {
   const generatedDir = path4.join(target, "public", "generated");
   const files = await (0, import_glob2.glob)(path4.join(generatedDir, "**/*.{c4,likec4}"), {
@@ -653,6 +683,7 @@ var catalogToAstro = async (source, astroDir) => {
   if (!import_fs.default.existsSync(path4.join(source, "eventcatalog.styles.css"))) {
     import_fs.default.writeFileSync(path4.join(source, "eventcatalog.styles.css"), "");
   }
+  await clearCustomPages(astroDir);
   await removeGeneratedLikeC4Sources(astroDir);
   await copyFiles(source, astroDir);
 };

package/dist/eventcatalog.config.d.cts

@@ -260,6 +260,14 @@ interface Config {
     };
     mdxOptimize?: boolean;
     compress?: boolean;
+    pages?: {
+        /**
+         * URL prefix that user-defined pages (pages/*.astro, pages/api/*.ts) are served under,
+         * e.g. pages/reports.astro is served at /custom/reports.
+         * @default 'custom'
+         */
+        prefix?: string;
+    };
     navigation?: {
         pages?: NavigationPage[];
         /**

package/dist/eventcatalog.config.d.ts

@@ -260,6 +260,14 @@ interface Config {
     };
     mdxOptimize?: boolean;
     compress?: boolean;
+    pages?: {
+        /**
+         * URL prefix that user-defined pages (pages/*.astro, pages/api/*.ts) are served under,
+         * e.g. pages/reports.astro is served at /custom/reports.
+         * @default 'custom'
+         */
+        prefix?: string;
+    };
     navigation?: {
         pages?: NavigationPage[];
         /**

package/dist/eventcatalog.js

@@ -1,16 +1,16 @@
 import {
   log_build_default
-} from "./chunk-ARHL5SPG.js";
+} from "./chunk-2T6ESD3L.js";
 import {
   runMigrations
 } from "./chunk-XUAF2H54.js";
 import "./chunk-CA4U2JP7.js";
 import {
   generate
-} from "./chunk-ZOFYLCPF.js";
+} from "./chunk-2PPDVKNK.js";
 import {
   logger
-} from "./chunk-IMCMPLIJ.js";
+} from "./chunk-RXZKZGDC.js";
 import {
   resolve_catalog_dependencies_default
 } from "./chunk-LHR4G2UO.js";
@@ -19,16 +19,16 @@ import {
 } from "./chunk-ZONBICNH.js";
 import {
   watch
-} from "./chunk-O3Y2G6CY.js";
-import "./chunk-WDA5QYVD.js";
+} from "./chunk-CAJUIMDJ.js";
+import "./chunk-PL4YZUAA.js";
 import "./chunk-DAOXTQVS.js";
 import {
   catalogToAstro
-} from "./chunk-WQNKHIDM.js";
-import "./chunk-VC6VUJIX.js";
+} from "./chunk-W3SAPOZU.js";
+import "./chunk-W5JQON7Z.js";
 import {
   VERSION
-} from "./chunk-RBBWHWE4.js";
+} from "./chunk-OQ36RUHT.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.0.7";
+var version = "4.1.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/generate.js

@@ -1,8 +1,8 @@
 import {
   generate
-} from "./chunk-ZOFYLCPF.js";
-import "./chunk-IMCMPLIJ.js";
-import "./chunk-RBBWHWE4.js";
+} from "./chunk-2PPDVKNK.js";
+import "./chunk-RXZKZGDC.js";
+import "./chunk-OQ36RUHT.js";
 import "./chunk-6QENHZZP.js";
 export {
   generate

package/dist/map-catalog-to-astro.cjs

@@ -34,6 +34,7 @@ __export(map_catalog_to_astro_exports, {
 });
 module.exports = __toCommonJS(map_catalog_to_astro_exports);
 var import_node_path = __toESM(require("path"), 1);
+var CUSTOM_PAGE_EXTENSIONS = [".astro", ".ts", ".js", ".mjs"];
 var COLLECTION_KEYS = [
   "agents",
   "events",
@@ -56,6 +57,10 @@ function mapCatalogToAstro({ filePath, astroDir, projectDir }) {
   if (!isCatalogRelated(relativeFilePath)) {
     return [];
   }
+  const customPageTargetPaths = getCustomPageTargetPaths(relativeFilePath, astroDir);
+  if (customPageTargetPaths) {
+    return customPageTargetPaths;
+  }
   const baseTargetPaths = getBaseTargetPaths(relativeFilePath);
   const relativeTargetPath = getRelativeTargetPath(relativeFilePath);
   return baseTargetPaths.map((base) => import_node_path.default.join(astroDir, base, relativeTargetPath));
@@ -70,6 +75,21 @@ function isCollectionKey(key) {
 function isLikeC4Source(filePath) {
   return filePath.endsWith(".c4") || filePath.endsWith(".likec4");
 }
+var hasExtension = (str) => /\.[a-zA-Z0-9]{2,}$/.test(str);
+function getCustomPageTargetPaths(filePath, astroDir) {
+  const filePathArr = filePath.split(import_node_path.default.sep).filter(Boolean);
+  if (filePathArr[0] !== "pages") {
+    return null;
+  }
+  const customPagePath = import_node_path.default.join(astroDir, "src", "custom-pages", ...filePathArr.slice(1));
+  if (CUSTOM_PAGE_EXTENSIONS.includes(import_node_path.default.extname(filePath).toLowerCase())) {
+    return [customPagePath];
+  }
+  if (!hasExtension(filePath)) {
+    return [customPagePath, import_node_path.default.join(astroDir, "public", "generated", ...filePathArr)];
+  }
+  return [import_node_path.default.join(astroDir, "public", "generated", ...filePathArr)];
+}
 function isCatalogRelated(filePath) {
   const filePathArr = filePath.split(import_node_path.default.sep).filter(Boolean);
   if ([
@@ -94,7 +114,6 @@ function isCatalogRelated(filePath) {
 function getBaseTargetPaths(filePath) {
   const filePathArr = filePath.split(import_node_path.default.sep).filter(Boolean);
   if (isCollectionKey(filePathArr[0])) {
-    const hasExtension = (str) => /\.[a-zA-Z0-9]{2,}$/.test(str);
     if (hasExtension(filePath)) {
       return [import_node_path.default.join("public", "generated")];
     }

package/dist/map-catalog-to-astro.js

@@ -1,6 +1,6 @@
 import {
   mapCatalogToAstro
-} from "./chunk-VC6VUJIX.js";
+} from "./chunk-W5JQON7Z.js";
 export {
   mapCatalogToAstro
 };

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

package/dist/utils/cli-logger.js

@@ -1,7 +1,7 @@
 import {
   logger
-} from "../chunk-IMCMPLIJ.js";
-import "../chunk-RBBWHWE4.js";
+} from "../chunk-RXZKZGDC.js";
+import "../chunk-OQ36RUHT.js";
 export {
   logger
 };

package/dist/watcher.cjs

@@ -38,6 +38,7 @@ var import_node_fs = __toESM(require("fs"), 1);
 
 // src/map-catalog-to-astro.js
 var import_node_path = __toESM(require("path"), 1);
+var CUSTOM_PAGE_EXTENSIONS = [".astro", ".ts", ".js", ".mjs"];
 var COLLECTION_KEYS = [
   "agents",
   "events",
@@ -60,6 +61,10 @@ function mapCatalogToAstro({ filePath, astroDir, projectDir }) {
   if (!isCatalogRelated(relativeFilePath)) {
     return [];
   }
+  const customPageTargetPaths = getCustomPageTargetPaths(relativeFilePath, astroDir);
+  if (customPageTargetPaths) {
+    return customPageTargetPaths;
+  }
   const baseTargetPaths = getBaseTargetPaths(relativeFilePath);
   const relativeTargetPath = getRelativeTargetPath(relativeFilePath);
   return baseTargetPaths.map((base) => import_node_path.default.join(astroDir, base, relativeTargetPath));
@@ -74,6 +79,21 @@ function isCollectionKey(key) {
 function isLikeC4Source(filePath) {
   return filePath.endsWith(".c4") || filePath.endsWith(".likec4");
 }
+var hasExtension = (str) => /\.[a-zA-Z0-9]{2,}$/.test(str);
+function getCustomPageTargetPaths(filePath, astroDir) {
+  const filePathArr = filePath.split(import_node_path.default.sep).filter(Boolean);
+  if (filePathArr[0] !== "pages") {
+    return null;
+  }
+  const customPagePath = import_node_path.default.join(astroDir, "src", "custom-pages", ...filePathArr.slice(1));
+  if (CUSTOM_PAGE_EXTENSIONS.includes(import_node_path.default.extname(filePath).toLowerCase())) {
+    return [customPagePath];
+  }
+  if (!hasExtension(filePath)) {
+    return [customPagePath, import_node_path.default.join(astroDir, "public", "generated", ...filePathArr)];
+  }
+  return [import_node_path.default.join(astroDir, "public", "generated", ...filePathArr)];
+}
 function isCatalogRelated(filePath) {
   const filePathArr = filePath.split(import_node_path.default.sep).filter(Boolean);
   if ([
@@ -98,7 +118,6 @@ function isCatalogRelated(filePath) {
 function getBaseTargetPaths(filePath) {
   const filePathArr = filePath.split(import_node_path.default.sep).filter(Boolean);
   if (isCollectionKey(filePathArr[0])) {
-    const hasExtension = (str) => /\.[a-zA-Z0-9]{2,}$/.test(str);
     if (hasExtension(filePath)) {
       return [import_node_path.default.join("public", "generated")];
     }

package/dist/watcher.js

@@ -1,7 +1,7 @@
 import {
   watch
-} from "./chunk-O3Y2G6CY.js";
-import "./chunk-VC6VUJIX.js";
+} from "./chunk-CAJUIMDJ.js";
+import "./chunk-W5JQON7Z.js";
 export {
   watch
 };

package/eventcatalog/src/enterprise/custom-pages/routes.ts

@@ -0,0 +1,142 @@
+/**
+ * Licensed under the EventCatalog Commercial License.
+ * See /packages/core/eventcatalog/src/enterprise/LICENSE
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+
+export interface CustomPageRoute {
+  /** Route pattern including the configured prefix, e.g. /custom/reports/[id] */
+  pattern: string;
+  /** File path relative to the custom pages directory */
+  file: string;
+  type: 'page' | 'endpoint';
+}
+
+export const DEFAULT_CUSTOM_PAGES_PREFIX = 'custom';
+
+/**
+ * Tracks the routable files during dev so route injection re-runs when files
+ * are added or removed. Never a route itself.
+ */
+export const CUSTOM_PAGES_MANIFEST_FILENAME = '.routes-manifest.json';
+
+const CUSTOM_PAGE_EXTENSIONS = /\.(astro|ts|js|mjs|json)$/i;
+
+/**
+ * Top-level route segments owned by EventCatalog. The custom pages prefix
+ * cannot start with any of these — everything else is collision-free because
+ * all user routes live under the prefix.
+ */
+const RESERVED_PREFIXES = [
+  'api',
+  'api-catalog',
+  'architecture',
+  'auth',
+  'diagrams',
+  'directory',
+  'discover',
+  'docs',
+  'icepanel',
+  'miro',
+  'rss',
+  'schemas',
+  'settings',
+  'studio',
+  'unauthorized',
+  'visualiser',
+  '.well-known',
+];
+
+/**
+ * Normalizes and validates the configured prefix (e.g. 'custom', 'internal/tools').
+ * Throws when the prefix is empty, contains unsafe characters or shadows a core route.
+ */
+export const resolveCustomPagesPrefix = (prefix: string | undefined): string => {
+  const normalized = (prefix ?? DEFAULT_CUSTOM_PAGES_PREFIX).replace(/^\/+|\/+$/g, '');
+
+  if (normalized.length === 0) {
+    throw new Error('[EventCatalog] pages.prefix cannot be empty.');
+  }
+
+  if (!/^[a-zA-Z0-9-_]+(\/[a-zA-Z0-9-_]+)*$/.test(normalized)) {
+    throw new Error(
+      `[EventCatalog] pages.prefix "${prefix}" is invalid. Use URL-safe characters (letters, numbers, - and _), optionally separated by "/".`
+    );
+  }
+
+  const firstSegment = normalized.split('/')[0].toLowerCase();
+  if (RESERVED_PREFIXES.includes(firstSegment)) {
+    throw new Error(`[EventCatalog] pages.prefix "${prefix}" is reserved by EventCatalog. Choose a different prefix.`);
+  }
+
+  return normalized;
+};
+
+/**
+ * Derives an Astro route pattern from a file path relative to the custom pages
+ * directory. Dynamic segments ([id], [...slug]) pass through untouched.
+ */
+export const deriveRoutePattern = (relativeFilePath: string, prefix: string): string => {
+  const withoutExtension = relativeFilePath.replace(CUSTOM_PAGE_EXTENSIONS, '');
+  const segments = withoutExtension.split(/[\\/]/).filter(Boolean);
+
+  if (segments[segments.length - 1] === 'index') {
+    segments.pop();
+  }
+
+  return `/${[prefix, ...segments].join('/')}`;
+};
+
+const walkDirectory = (directory: string, relativeTo: string): string[] => {
+  const files: string[] = [];
+
+  for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
+    const fullPath = path.join(directory, entry.name);
+    if (entry.isDirectory()) {
+      files.push(...walkDirectory(fullPath, relativeTo));
+    } else if (entry.isFile()) {
+      files.push(path.relative(relativeTo, fullPath));
+    }
+  }
+
+  return files;
+};
+
+/**
+ * Lists the routable code files in the custom pages directory (sorted, relative paths).
+ * Underscore-prefixed files and directories follow the Astro convention: they are
+ * never routable (partials, helpers, colocated components).
+ */
+export const listCustomPageFiles = (customPagesDir: string): string[] => {
+  if (!fs.existsSync(customPagesDir)) return [];
+
+  return walkDirectory(customPagesDir, customPagesDir)
+    .filter((file) => CUSTOM_PAGE_EXTENSIONS.test(file))
+    .filter((file) => file !== CUSTOM_PAGES_MANIFEST_FILENAME)
+    .filter((file) => !file.split(path.sep).some((segment) => segment.startsWith('_')))
+    .sort();
+};
+
+/**
+ * Reads the custom pages directory and returns the routes to inject.
+ */
+export const getCustomPageRoutes = (customPagesDir: string, prefix: string): CustomPageRoute[] => {
+  const routes: CustomPageRoute[] = [];
+
+  for (const file of listCustomPageFiles(customPagesDir)) {
+    // pages/homepage.astro is the custom landing page, rendered by src/pages/index.astro
+    if (file === 'homepage.astro') continue;
+
+    routes.push({
+      pattern: deriveRoutePattern(file, prefix),
+      file,
+      type: file.toLowerCase().endsWith('.astro') ? 'page' : 'endpoint',
+    });
+  }
+
+  return routes;
+};
+
+export const isApiRoute = (route: CustomPageRoute): boolean => route.file.split(path.sep)[0] === 'api';

package/eventcatalog/src/enterprise/feature.ts

@@ -53,6 +53,9 @@ export const isEventCatalogUpgradeEnabled = () => !isEventCatalogStarterEnabled(
 // Custom landing pages are always enabled now.
 export const isCustomLandingPageEnabled = () => true;
 
+// User-defined pages and API routes (pages/*.astro, pages/api/*.ts)
+export const isCustomPagesEnabled = () => isEventCatalogScaleEnabled();
+
 export const isAuthEnabled = () => {
   const isAuthEnabledInCatalog = config?.auth?.enabled ?? false;
   const directory = process.env.PROJECT_DIR || process.cwd();

package/eventcatalog/src/enterprise/integrations/eventcatalog-features.ts

@@ -4,23 +4,80 @@
  */
 
 import type { AstroIntegration } from 'astro';
+import fs from 'node:fs';
 import path from 'path';
 import config from '../../../eventcatalog.config.js';
 import {
   isEventCatalogChatEnabled,
   isAuthEnabled,
   isEventCatalogScaleEnabled,
-  isEventCatalogStarterEnabled,
   isEventCatalogMCPEnabled,
   isEventCatalogMCPAuthEnabled,
   isFullCatalogAPIEnabled,
   isDevMode,
   isIntegrationsEnabled,
   isCustomDocsEnabled,
+  isCustomPagesEnabled,
   isSSR,
 } from '../../utils/feature';
+import {
+  CUSTOM_PAGES_MANIFEST_FILENAME,
+  getCustomPageRoutes,
+  isApiRoute,
+  listCustomPageFiles,
+  resolveCustomPagesPrefix,
+} from '../custom-pages/routes';
 
 const catalogDirectory = process.env.CATALOG_DIR || process.cwd();
+const customPagesDirectory = path.join(catalogDirectory, 'src/custom-pages');
+
+// Routes are injected at astro:config:setup, so adding or removing a custom page
+// file needs a full Astro restart before its route exists. This manifest is
+// registered via addWatchFile — rewriting it with a changed file list triggers
+// that restart (a Vite-level server.restart() does NOT re-run route injection).
+const customPagesManifest = path.join(customPagesDirectory, CUSTOM_PAGES_MANIFEST_FILENAME);
+
+const writeCustomPagesManifest = () => {
+  const content = JSON.stringify(listCustomPageFiles(customPagesDirectory));
+
+  try {
+    if (fs.existsSync(customPagesManifest) && fs.readFileSync(customPagesManifest, 'utf-8') === content) {
+      return;
+    }
+
+    fs.mkdirSync(customPagesDirectory, { recursive: true });
+    fs.writeFileSync(customPagesManifest, content);
+  } catch (error: any) {
+    console.warn(`[EventCatalog] Could not update the custom pages manifest: ${error.message}`);
+  }
+};
+
+const configureCustomPages = (params: {
+  command: 'dev' | 'build' | 'preview' | 'sync';
+  injectRoute: (route: { pattern: string; entrypoint: string }) => void;
+}) => {
+  const prefix = resolveCustomPagesPrefix(config.pages?.prefix);
+  const routes = getCustomPageRoutes(customPagesDirectory, prefix);
+
+  const apiRoutes = routes.filter(isApiRoute);
+  if (apiRoutes.length > 0 && !isSSR()) {
+    const message = `Custom API routes (${apiRoutes.map((route) => `pages/${route.file}`).join(', ')}) require EventCatalog to run in server mode. Set output: 'server' in your eventcatalog.config.js or remove the pages/api directory.`;
+
+    // The dev server serves endpoints dynamically regardless of output mode,
+    // so only fail the build — but warn early during development.
+    if (params.command === 'build') {
+      throw new Error(`[EventCatalog] ${message}`);
+    }
+    console.warn(`[EventCatalog] ${message}`);
+  }
+
+  for (const route of routes) {
+    params.injectRoute({
+      pattern: route.pattern,
+      entrypoint: path.join(customPagesDirectory, route.file),
+    });
+  }
+};
 
 const configureAuthentication = (params: {
   injectRoute: (route: { pattern: string; entrypoint: string }) => void;
@@ -148,6 +205,18 @@ export default function eventCatalogIntegration(): AstroIntegration {
           });
         }
 
+        // User-defined pages and API routes (Scale plan)
+        if (isCustomPagesEnabled()) {
+          configureCustomPages(params);
+        } else if (listCustomPageFiles(customPagesDirectory).length > 0) {
+          console.warn('[EventCatalog] Custom pages require the Scale plan. The routes for your pages will not be served.');
+        }
+
+        // Keep routes in sync during dev — a manifest change restarts the dev
+        // server so injectRoute runs again with the new file list
+        writeCustomPagesManifest();
+        params.addWatchFile(customPagesManifest);
+
         // Warn if integrations are configured without Scale plan
         if (config.integrations && !isIntegrationsEnabled()) {
           console.warn('[EventCatalog] Integrations require the Scale plan. Analytics integrations will not be loaded.');
@@ -165,6 +234,20 @@ export default function eventCatalogIntegration(): AstroIntegration {
           });
         }
       },
+      'astro:server:setup': ({ server }) => {
+        // When custom page files appear or disappear, refresh the manifest.
+        // A content change restarts the dev server (via addWatchFile above),
+        // which re-runs route injection. Unchanged content writes nothing,
+        // so events from the watcher's initial scan are no-ops.
+        const onCustomPageChange = (file: string) => {
+          if (!path.resolve(file).startsWith(customPagesDirectory + path.sep)) return;
+          if (!/\.(astro|ts|js|mjs)$/i.test(file)) return;
+          writeCustomPagesManifest();
+        };
+
+        server.watcher.on('add', onCustomPageChange);
+        server.watcher.on('unlink', onCustomPageChange);
+      },
     },
   };
 }

package/eventcatalog/src/pages/index.astro

@@ -21,7 +21,7 @@ const props = Astro.props;
 const pathToUserDefinedLandingPage = path.join(process.env.PROJECT_DIR || '', 'pages/homepage.astro');
 
 if (existsSync(pathToUserDefinedLandingPage) && isCustomLandingPageEnabled()) {
-  const customPages = import.meta.glob('/**/homepage.astro', { eager: true });
+  const customPages = import.meta.glob('/src/custom-pages/homepage.astro', { eager: true });
   // @ts-ignore
   CustomContent = Object.values(customPages)[0]?.default || null;
 

package/eventcatalog/src/toolkit/layouts/Layout.astro

@@ -0,0 +1,25 @@
+---
+/**
+ * Public layout shell for user-defined custom pages, imported by catalog
+ * authors as `@catalog/layouts/Layout.astro`.
+ *
+ * The props here are a documented, stable interface — internal layouts can
+ * change freely, this contract cannot.
+ */
+interface Props {
+  title: string;
+  description?: string;
+  /** Render the resource sidebar (domains, services, messages). Defaults to true. */
+  sidebar?: boolean;
+  /** Show the EventCatalog header (search, navigation). Defaults to true. */
+  showHeader?: boolean;
+}
+
+import VerticalSideBarLayout from '@layouts/VerticalSideBarLayout.astro';
+
+const { title, description, sidebar = true, showHeader = true } = Astro.props;
+---
+
+<VerticalSideBarLayout title={title} description={description} showHeader={showHeader} showNestedSideBar={sidebar}>
+  <slot />
+</VerticalSideBarLayout>

package/eventcatalog/src/toolkit/utils/index.ts

@@ -0,0 +1,26 @@
+/**
+ * Public utilities for user-defined custom pages, imported by catalog
+ * authors as `@catalog/utils`.
+ *
+ * These re-exports are a documented, stable interface — internal utils can
+ * change freely, this contract cannot. Getters return hydrated, cached
+ * collection entries (pass { getAllVersions: false } for latest versions only).
+ */
+export { getDomains } from '@utils/collections/domains';
+export { getServices } from '@utils/collections/services';
+export { getSystems } from '@utils/collections/systems';
+export { getEvents } from '@utils/collections/events';
+export { getCommands } from '@utils/collections/commands';
+export { getQueries } from '@utils/collections/queries';
+export { getFlows } from '@utils/collections/flows';
+export { getChannels } from '@utils/collections/channels';
+export { getEntities } from '@utils/collections/entities';
+export { getAgents } from '@utils/collections/agents';
+export { getContainers } from '@utils/collections/containers';
+export { getDataProducts } from '@utils/collections/data-products';
+export { getAdrs } from '@utils/collections/adrs';
+export { getTeams } from '@utils/collections/teams';
+export { getUsers } from '@utils/collections/users';
+
+// Resolve a specific version (semver) or the latest version of items in a collection
+export { getItemsFromCollectionByIdAndSemverOrLatest } from '@utils/collections/util';

package/eventcatalog/src/utils/feature.ts

@@ -25,6 +25,7 @@ export {
   isEventCatalogChatEnabled,
   isEventCatalogUpgradeEnabled,
   isCustomLandingPageEnabled,
+  isCustomPagesEnabled,
   isAuthEnabled,
   isCustomStylesEnabled,
   isEventCatalogMCPEnabled,

package/eventcatalog/tsconfig.json

@@ -9,6 +9,9 @@
       "@icons/*": ["src/icons/*"],
       "@components/*": ["src/components/*"],
       "@catalog/components/*": ["src/custom-defined-components/*"],
+      "@catalog/layouts/*": ["src/toolkit/layouts/*"],
+      "@catalog/utils": ["src/toolkit/utils/index.ts"],
+      "@catalog/utils/*": ["src/toolkit/utils/*"],
       "@catalog/snippets/*": ["src/snippets/*"],
       "@types": ["src/types/index.ts"],
       "@utils/*": ["src/utils/*"],
@@ -22,5 +25,6 @@
     "jsxImportSource": "react",
     "types": ["vitest/globals"]
   },
-  "include": ["src/**/*", "*.config.*"]
+  "include": ["src/**/*", "*.config.*"],
+  "exclude": ["src/custom-pages"]
 }

package/package.json

@@ -7,7 +7,7 @@
   },
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",
-  "version": "4.0.7",
+  "version": "4.1.0",
   "publishConfig": {
     "access": "public"
   },
@@ -116,9 +116,9 @@
     "update-notifier": "^7.3.1",
     "uuid": "^10.0.0",
     "zod": "^4.3.6",
-    "@eventcatalog/linter": "1.1.4",
     "@eventcatalog/sdk": "2.25.0",
-    "@eventcatalog/visualiser": "^4.0.1"
+    "@eventcatalog/visualiser": "^4.0.1",
+    "@eventcatalog/linter": "1.1.4"
   },
   "devDependencies": {
     "@astrojs/check": "^0.9.9",