@eventcatalog/core 3.0.0-beta.2 → 3.0.0-beta.4

package/dist/analytics/analytics.cjs

@@ -37,7 +37,7 @@ var import_axios = __toESM(require("axios"), 1);
 var import_os = __toESM(require("os"), 1);
 
 // package.json
-var version = "3.0.0-beta.2";
+var version = "3.0.0-beta.4";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/analytics.js

@@ -1,7 +1,7 @@
 import {
   raiseEvent
-} from "../chunk-JSONCD7V.js";
-import "../chunk-H4QHE5YZ.js";
+} from "../chunk-HNU3YCIL.js";
+import "../chunk-FEE4ODCC.js";
 export {
   raiseEvent
 };

package/dist/analytics/log-build.cjs

@@ -106,7 +106,7 @@ var import_axios = __toESM(require("axios"), 1);
 var import_os = __toESM(require("os"), 1);
 
 // package.json
-var version = "3.0.0-beta.2";
+var version = "3.0.0-beta.4";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/log-build.js

@@ -1,8 +1,8 @@
 import {
   log_build_default
-} from "../chunk-PQL6O5YA.js";
-import "../chunk-JSONCD7V.js";
-import "../chunk-H4QHE5YZ.js";
+} from "../chunk-P4GSM347.js";
+import "../chunk-HNU3YCIL.js";
+import "../chunk-FEE4ODCC.js";
 import "../chunk-UPONRQSN.js";
 export {
   log_build_default as default

package/dist/chunk-5L44ZUV2.js

@@ -0,0 +1,44 @@
+import {
+  VERSION
+} from "./chunk-FEE4ODCC.js";
+
+// src/utils/cli-logger.ts
+import pc from "picocolors";
+var getTimestamp = () => {
+  const now = /* @__PURE__ */ new Date();
+  return now.toLocaleTimeString("en-US", { hour12: false });
+};
+var formatMessage = (tag, message, tagColor) => {
+  return `${pc.dim(getTimestamp())} ${tagColor(`[${tag}]`)} ${message}`;
+};
+var logger = {
+  welcome: () => {
+    console.log();
+    console.log(pc.magenta(pc.bold("\u{1F680} EventCatalog")) + pc.dim(`  (v${VERSION})`));
+    console.log(pc.dim("https://eventcatalog.dev"));
+    console.log();
+    console.log(
+      pc.dim("If you like the project, we would appreciate a star on GitHub \u2764\uFE0F - ") + pc.bold("https://github.com/event-catalog/eventcatalog/stargazers")
+    );
+    console.log();
+  },
+  info: (message, tag = "info") => {
+    console.log(formatMessage(tag, message, pc.blue));
+  },
+  success: (message, tag = "success") => {
+    console.log(formatMessage(tag, message, pc.green));
+  },
+  error: (message, tag = "error") => {
+    console.log(formatMessage(tag, message, pc.red));
+  },
+  warning: (message, tag = "warn") => {
+    console.log(formatMessage(tag, message, pc.yellow));
+  },
+  dim: (message) => {
+    console.log(pc.dim(message));
+  }
+};
+
+export {
+  logger
+};

package/dist/{chunk-H4QHE5YZ.js → chunk-FEE4ODCC.js}

@@ -1,5 +1,5 @@
 // package.json
-var version = "3.0.0-beta.2";
+var version = "3.0.0-beta.4";
 
 // src/constants.ts
 var VERSION = version;

package/dist/{chunk-JSONCD7V.js → chunk-HNU3YCIL.js}

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

package/dist/{chunk-PQL6O5YA.js → chunk-P4GSM347.js}

@@ -1,6 +1,6 @@
 import {
   raiseEvent
-} from "./chunk-JSONCD7V.js";
+} from "./chunk-HNU3YCIL.js";
 import {
   getEventCatalogConfigFile,
   verifyRequiredFieldsAreInCatalogConfigFile

package/dist/{chunk-3W6JYTHP.js → chunk-UKOXBJ2K.js}

@@ -1,3 +1,6 @@
+import {
+  logger
+} from "./chunk-5L44ZUV2.js";
 import {
   cleanup,
   getEventCatalogConfigFile
@@ -22,7 +25,7 @@ var generate = async (PROJECT_DIRECTORY) => {
     const config = await getEventCatalogConfigFile(PROJECT_DIRECTORY);
     const { generators = [] } = config;
     if (!generators.length) {
-      console.log("No configured generators found, skipping generation");
+      logger.info("No configured generators found, skipping generation", "generator");
       return;
     }
     for (const generator of generators) {
@@ -39,7 +42,8 @@ var generate = async (PROJECT_DIRECTORY) => {
         const generator2 = getDefaultExport(importedGenerator);
         await generator2({ eventCatalogConfig: {} }, pluginConfig);
       } catch (error) {
-        console.error("Error loading plugin:", error);
+        logger.error("Error loading plugin:", "generator");
+        console.error(error);
         await cleanup(PROJECT_DIRECTORY);
         return;
       }

package/dist/constants.cjs

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

package/dist/constants.js

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

package/dist/eventcatalog.cjs

@@ -105,6 +105,51 @@ var verifyRequiredFieldsAreInCatalogConfigFile = async (projectDirectory) => {
   }
 };
 
+// src/utils/cli-logger.ts
+var import_picocolors = __toESM(require("picocolors"), 1);
+
+// package.json
+var version = "3.0.0-beta.4";
+
+// src/constants.ts
+var VERSION = version;
+
+// src/utils/cli-logger.ts
+var getTimestamp = () => {
+  const now = /* @__PURE__ */ new Date();
+  return now.toLocaleTimeString("en-US", { hour12: false });
+};
+var formatMessage = (tag, message, tagColor) => {
+  return `${import_picocolors.default.dim(getTimestamp())} ${tagColor(`[${tag}]`)} ${message}`;
+};
+var logger = {
+  welcome: () => {
+    console.log();
+    console.log(import_picocolors.default.magenta(import_picocolors.default.bold("\u{1F680} EventCatalog")) + import_picocolors.default.dim(`  (v${VERSION})`));
+    console.log(import_picocolors.default.dim("https://eventcatalog.dev"));
+    console.log();
+    console.log(
+      import_picocolors.default.dim("If you like the project, we would appreciate a star on GitHub \u2764\uFE0F - ") + import_picocolors.default.bold("https://github.com/event-catalog/eventcatalog/stargazers")
+    );
+    console.log();
+  },
+  info: (message, tag = "info") => {
+    console.log(formatMessage(tag, message, import_picocolors.default.blue));
+  },
+  success: (message, tag = "success") => {
+    console.log(formatMessage(tag, message, import_picocolors.default.green));
+  },
+  error: (message, tag = "error") => {
+    console.log(formatMessage(tag, message, import_picocolors.default.red));
+  },
+  warning: (message, tag = "warn") => {
+    console.log(formatMessage(tag, message, import_picocolors.default.yellow));
+  },
+  dim: (message) => {
+    console.log(import_picocolors.default.dim(message));
+  }
+};
+
 // src/generate.js
 function getDefaultExport(importedModule) {
   if (importedModule === null || typeof importedModule !== "object") {
@@ -123,7 +168,7 @@ var generate = async (PROJECT_DIRECTORY) => {
     const config = await getEventCatalogConfigFile(PROJECT_DIRECTORY);
     const { generators = [] } = config;
     if (!generators.length) {
-      console.log("No configured generators found, skipping generation");
+      logger.info("No configured generators found, skipping generation", "generator");
       return;
     }
     for (const generator of generators) {
@@ -140,7 +185,8 @@ var generate = async (PROJECT_DIRECTORY) => {
         const generator2 = getDefaultExport(importedGenerator);
         await generator2({ eventCatalogConfig: {} }, pluginConfig);
       } catch (error) {
-        console.error("Error loading plugin:", error);
+        logger.error("Error loading plugin:", "generator");
+        console.error(error);
         await cleanup(PROJECT_DIRECTORY);
         return;
       }
@@ -155,14 +201,6 @@ var generate = async (PROJECT_DIRECTORY) => {
 // src/analytics/analytics.js
 var import_axios = __toESM(require("axios"), 1);
 var import_os = __toESM(require("os"), 1);
-
-// package.json
-var version = "3.0.0-beta.2";
-
-// src/constants.ts
-var VERSION = version;
-
-// src/analytics/analytics.js
 async function raiseEvent(eventData) {
   const url = "https://queue.simpleanalyticscdn.com/events";
   const userAgent = `@eventcatalog/eventcatalog@${VERSION} (${import_os.default.platform()}; ${import_os.default.arch()}; Node/${process.version})`;
@@ -687,7 +725,7 @@ var createAuthFileIfNotExists = async (hasRequiredLicense) => {
   const isSRR = await isOutputServer();
   try {
     if (authEnabled && hasRequiredLicense && isSRR) {
-      console.log("Creating auth file");
+      logger.info("Creating auth file", "auth");
       import_fs2.default.writeFileSync(
         (0, import_node_path7.join)(core, "src/pages/api/[...auth].ts"),
         `import { AstroAuth } from 'auth-astro/server';
@@ -731,14 +769,17 @@ Run npm i @eventcatalog/core to update`;
   }
 };
 program.command("dev").description("Run development server of EventCatalog").option("-d, --debug", "Output EventCatalog application information into your terminal").option("--force-recreate", "Recreate the eventcatalog-core directory", false).action(async (options, command) => {
-  console.log("Setting up EventCatalog....");
+  logger.welcome();
+  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_fs2.default.existsSync(import_node_path8.default.join(dir, ".env"))) {
     import_dotenv.default.config({ path: import_node_path8.default.join(dir, ".env") });
   }
   if (options.debug) {
-    console.log("Debug mode enabled");
-    console.log("PROJECT_DIR", dir);
-    console.log("CATALOG_DIR", core);
+    logger.info("Debug mode enabled", "debug");
+    logger.info(`PROJECT_DIR: ${dir}`, "debug");
+    logger.info(`CATALOG_DIR: ${core}`, "debug");
   }
   if (options.forceRecreate) clearCore();
   copyCore();
@@ -786,7 +827,10 @@ program.command("dev").description("Run development server of EventCatalog").opt
   }
 });
 program.command("build").description("Run build of EventCatalog").action(async (options, command) => {
-  console.log("Building EventCatalog...");
+  logger.welcome();
+  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_fs2.default.existsSync(import_node_path8.default.join(dir, ".env"))) {
     import_dotenv.default.config({ path: import_node_path8.default.join(dir, ".env") });
   }
@@ -850,7 +894,8 @@ var startServerCatalog = ({
   );
 };
 program.command("preview").description("Serves the contents of your eventcatalog build directory").action(async (options, command) => {
-  console.log("Starting preview of your build...");
+  logger.welcome();
+  logger.info("Starting preview of your build...", "preview");
   if (import_fs2.default.existsSync(import_node_path8.default.join(dir, ".env"))) {
     import_dotenv.default.config({ path: import_node_path8.default.join(dir, ".env") });
   }
@@ -865,7 +910,8 @@ program.command("preview").description("Serves the contents of your eventcatalog
   previewCatalog({ command, canEmbedPages: canEmbedPages || isEventCatalogScale, isEventCatalogStarter, isEventCatalogScale });
 });
 program.command("start").description("Serves the contents of your eventcatalog build directory").action(async (options, command) => {
-  console.log("Starting preview of your build...");
+  logger.welcome();
+  logger.info("Starting preview of your build...", "preview");
   if (import_fs2.default.existsSync(import_node_path8.default.join(dir, ".env"))) {
     import_dotenv.default.config({ path: import_node_path8.default.join(dir, ".env") });
   }

package/dist/eventcatalog.js

@@ -6,8 +6,8 @@ import {
 } from "./chunk-PLNJC7NZ.js";
 import {
   log_build_default
-} from "./chunk-PQL6O5YA.js";
-import "./chunk-JSONCD7V.js";
+} from "./chunk-P4GSM347.js";
+import "./chunk-HNU3YCIL.js";
 import {
   runMigrations
 } from "./chunk-BH3JMNAV.js";
@@ -17,16 +17,19 @@ import {
   checkAndConvertMdToMdx
 } from "./chunk-R2BJ7MJG.js";
 import "./chunk-55D645EH.js";
-import {
-  VERSION
-} from "./chunk-H4QHE5YZ.js";
 import {
   isAuthEnabled,
   isOutputServer
 } from "./chunk-5VBIXL6C.js";
 import {
   generate
-} from "./chunk-3W6JYTHP.js";
+} from "./chunk-UKOXBJ2K.js";
+import {
+  logger
+} from "./chunk-5L44ZUV2.js";
+import {
+  VERSION
+} from "./chunk-FEE4ODCC.js";
 import "./chunk-UPONRQSN.js";
 
 // src/eventcatalog.ts
@@ -96,7 +99,7 @@ var createAuthFileIfNotExists = async (hasRequiredLicense) => {
   const isSRR = await isOutputServer();
   try {
     if (authEnabled && hasRequiredLicense && isSRR) {
-      console.log("Creating auth file");
+      logger.info("Creating auth file", "auth");
       fs.writeFileSync(
         join(core, "src/pages/api/[...auth].ts"),
         `import { AstroAuth } from 'auth-astro/server';
@@ -140,14 +143,17 @@ Run npm i @eventcatalog/core to update`;
   }
 };
 program.command("dev").description("Run development server of EventCatalog").option("-d, --debug", "Output EventCatalog application information into your terminal").option("--force-recreate", "Recreate the eventcatalog-core directory", false).action(async (options, command) => {
-  console.log("Setting up EventCatalog....");
+  logger.welcome();
+  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 (fs.existsSync(path.join(dir, ".env"))) {
     dotenv.config({ path: path.join(dir, ".env") });
   }
   if (options.debug) {
-    console.log("Debug mode enabled");
-    console.log("PROJECT_DIR", dir);
-    console.log("CATALOG_DIR", core);
+    logger.info("Debug mode enabled", "debug");
+    logger.info(`PROJECT_DIR: ${dir}`, "debug");
+    logger.info(`CATALOG_DIR: ${core}`, "debug");
   }
   if (options.forceRecreate) clearCore();
   copyCore();
@@ -195,7 +201,10 @@ program.command("dev").description("Run development server of EventCatalog").opt
   }
 });
 program.command("build").description("Run build of EventCatalog").action(async (options, command) => {
-  console.log("Building EventCatalog...");
+  logger.welcome();
+  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 (fs.existsSync(path.join(dir, ".env"))) {
     dotenv.config({ path: path.join(dir, ".env") });
   }
@@ -259,7 +268,8 @@ var startServerCatalog = ({
   );
 };
 program.command("preview").description("Serves the contents of your eventcatalog build directory").action(async (options, command) => {
-  console.log("Starting preview of your build...");
+  logger.welcome();
+  logger.info("Starting preview of your build...", "preview");
   if (fs.existsSync(path.join(dir, ".env"))) {
     dotenv.config({ path: path.join(dir, ".env") });
   }
@@ -274,7 +284,8 @@ program.command("preview").description("Serves the contents of your eventcatalog
   previewCatalog({ command, canEmbedPages: canEmbedPages || isEventCatalogScale, isEventCatalogStarter, isEventCatalogScale });
 });
 program.command("start").description("Serves the contents of your eventcatalog build directory").action(async (options, command) => {
-  console.log("Starting preview of your build...");
+  logger.welcome();
+  logger.info("Starting preview of your build...", "preview");
   if (fs.existsSync(path.join(dir, ".env"))) {
     dotenv.config({ path: path.join(dir, ".env") });
   }

package/dist/generate.cjs

@@ -69,6 +69,51 @@ var getEventCatalogConfigFile = async (projectDirectory) => {
   }
 };
 
+// src/utils/cli-logger.ts
+var import_picocolors = __toESM(require("picocolors"), 1);
+
+// package.json
+var version = "3.0.0-beta.4";
+
+// src/constants.ts
+var VERSION = version;
+
+// src/utils/cli-logger.ts
+var getTimestamp = () => {
+  const now = /* @__PURE__ */ new Date();
+  return now.toLocaleTimeString("en-US", { hour12: false });
+};
+var formatMessage = (tag, message, tagColor) => {
+  return `${import_picocolors.default.dim(getTimestamp())} ${tagColor(`[${tag}]`)} ${message}`;
+};
+var logger = {
+  welcome: () => {
+    console.log();
+    console.log(import_picocolors.default.magenta(import_picocolors.default.bold("\u{1F680} EventCatalog")) + import_picocolors.default.dim(`  (v${VERSION})`));
+    console.log(import_picocolors.default.dim("https://eventcatalog.dev"));
+    console.log();
+    console.log(
+      import_picocolors.default.dim("If you like the project, we would appreciate a star on GitHub \u2764\uFE0F - ") + import_picocolors.default.bold("https://github.com/event-catalog/eventcatalog/stargazers")
+    );
+    console.log();
+  },
+  info: (message, tag = "info") => {
+    console.log(formatMessage(tag, message, import_picocolors.default.blue));
+  },
+  success: (message, tag = "success") => {
+    console.log(formatMessage(tag, message, import_picocolors.default.green));
+  },
+  error: (message, tag = "error") => {
+    console.log(formatMessage(tag, message, import_picocolors.default.red));
+  },
+  warning: (message, tag = "warn") => {
+    console.log(formatMessage(tag, message, import_picocolors.default.yellow));
+  },
+  dim: (message) => {
+    console.log(import_picocolors.default.dim(message));
+  }
+};
+
 // src/generate.js
 function getDefaultExport(importedModule) {
   if (importedModule === null || typeof importedModule !== "object") {
@@ -87,7 +132,7 @@ var generate = async (PROJECT_DIRECTORY) => {
     const config = await getEventCatalogConfigFile(PROJECT_DIRECTORY);
     const { generators = [] } = config;
     if (!generators.length) {
-      console.log("No configured generators found, skipping generation");
+      logger.info("No configured generators found, skipping generation", "generator");
       return;
     }
     for (const generator of generators) {
@@ -104,7 +149,8 @@ var generate = async (PROJECT_DIRECTORY) => {
         const generator2 = getDefaultExport(importedGenerator);
         await generator2({ eventCatalogConfig: {} }, pluginConfig);
       } catch (error) {
-        console.error("Error loading plugin:", error);
+        logger.error("Error loading plugin:", "generator");
+        console.error(error);
         await cleanup(PROJECT_DIRECTORY);
         return;
       }

package/dist/generate.js

@@ -1,6 +1,8 @@
 import {
   generate
-} from "./chunk-3W6JYTHP.js";
+} from "./chunk-UKOXBJ2K.js";
+import "./chunk-5L44ZUV2.js";
+import "./chunk-FEE4ODCC.js";
 import "./chunk-UPONRQSN.js";
 export {
   generate

package/dist/utils/cli-logger.cjs

@@ -0,0 +1,82 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/utils/cli-logger.ts
+var cli_logger_exports = {};
+__export(cli_logger_exports, {
+  logger: () => logger
+});
+module.exports = __toCommonJS(cli_logger_exports);
+var import_picocolors = __toESM(require("picocolors"), 1);
+
+// package.json
+var version = "3.0.0-beta.4";
+
+// src/constants.ts
+var VERSION = version;
+
+// src/utils/cli-logger.ts
+var getTimestamp = () => {
+  const now = /* @__PURE__ */ new Date();
+  return now.toLocaleTimeString("en-US", { hour12: false });
+};
+var formatMessage = (tag, message, tagColor) => {
+  return `${import_picocolors.default.dim(getTimestamp())} ${tagColor(`[${tag}]`)} ${message}`;
+};
+var logger = {
+  welcome: () => {
+    console.log();
+    console.log(import_picocolors.default.magenta(import_picocolors.default.bold("\u{1F680} EventCatalog")) + import_picocolors.default.dim(`  (v${VERSION})`));
+    console.log(import_picocolors.default.dim("https://eventcatalog.dev"));
+    console.log();
+    console.log(
+      import_picocolors.default.dim("If you like the project, we would appreciate a star on GitHub \u2764\uFE0F - ") + import_picocolors.default.bold("https://github.com/event-catalog/eventcatalog/stargazers")
+    );
+    console.log();
+  },
+  info: (message, tag = "info") => {
+    console.log(formatMessage(tag, message, import_picocolors.default.blue));
+  },
+  success: (message, tag = "success") => {
+    console.log(formatMessage(tag, message, import_picocolors.default.green));
+  },
+  error: (message, tag = "error") => {
+    console.log(formatMessage(tag, message, import_picocolors.default.red));
+  },
+  warning: (message, tag = "warn") => {
+    console.log(formatMessage(tag, message, import_picocolors.default.yellow));
+  },
+  dim: (message) => {
+    console.log(import_picocolors.default.dim(message));
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  logger
+});

package/dist/utils/cli-logger.d.cts

@@ -0,0 +1,10 @@
+declare const logger: {
+    welcome: () => void;
+    info: (message: string, tag?: string) => void;
+    success: (message: string, tag?: string) => void;
+    error: (message: string, tag?: string) => void;
+    warning: (message: string, tag?: string) => void;
+    dim: (message: string) => void;
+};
+
+export { logger };

package/dist/utils/cli-logger.d.ts

@@ -0,0 +1,10 @@
+declare const logger: {
+    welcome: () => void;
+    info: (message: string, tag?: string) => void;
+    success: (message: string, tag?: string) => void;
+    error: (message: string, tag?: string) => void;
+    warning: (message: string, tag?: string) => void;
+    dim: (message: string) => void;
+};
+
+export { logger };

package/dist/utils/cli-logger.js

@@ -0,0 +1,7 @@
+import {
+  logger
+} from "../chunk-5L44ZUV2.js";
+import "../chunk-FEE4ODCC.js";
+export {
+  logger
+};

package/eventcatalog/src/components/Search/SearchModal.tsx

@@ -20,6 +20,7 @@ import {
   ArrowUturnLeftIcon,
   StarIcon,
   Square2StackIcon,
+  ArrowsRightLeftIcon,
 } from '@heroicons/react/24/outline';
 import { StarIcon as StarIconSolid, CircleStackIcon } from '@heroicons/react/24/solid';
 import { useStore } from '@nanostores/react';
@@ -33,7 +34,7 @@ const typeIcons: any = {
   Command: ChatBubbleLeftIcon,
   Query: QueryIcon,
   Entity: CubeIcon,
-  Channel: QueueListIcon,
+  Channel: ArrowsRightLeftIcon,
   Team: UserGroupIcon,
   User: UserIcon,
   Language: BookOpenIcon,
@@ -68,8 +69,6 @@ function classNames(...classes: (string | boolean | undefined)[]) {
 
 // Helper to construct URL from key if href is missing
 const getUrlForItem = (node: any, key: string) => {
-  if (node.href) return node.href;
-
   const parts = key.split(':');
   if (parts.length < 2) return null; // Need at least type:id
 
@@ -83,8 +82,16 @@ const getUrlForItem = (node: any, key: string) => {
   // Only show items that have a version to avoid duplicates
   if (!version) return null;
 
+  // If node has href, use it, otherwise construct from key
+  if (node.href) return node.href;
+
   // Pluralize type for URL if needed
-  const pluralType = ['event', 'command', 'query', 'domain', 'service', 'flow', 'container'].includes(type) ? type + 's' : type; // users/teams already have href usually, but safe fallback
+  let pluralType = type;
+  if (['event', 'command', 'domain', 'service', 'flow', 'container', 'channel'].includes(type)) {
+    pluralType = type + 's';
+  } else if (type === 'query') {
+    pluralType = 'queries';
+  }
 
   return `/docs/${pluralType}/${id}/${version}`;
 };
@@ -171,6 +178,7 @@ export default function SearchModal() {
       Team: 0,
       Container: 0,
       Design: 0,
+      Channel: 0,
     };
 
     itemsToCount.forEach((item) => {
@@ -195,6 +203,7 @@ export default function SearchModal() {
     if (counts.Service > 0) dynamicFilters.push({ id: 'Service', name: `Services (${counts.Service})` });
     if (counts.Message > 0) dynamicFilters.push({ id: 'Message', name: `Messages (${counts.Message})` });
     if (counts.Container > 0) dynamicFilters.push({ id: 'Container', name: `Containers (${counts.Container})` });
+    if (counts.Channel > 0) dynamicFilters.push({ id: 'Channel', name: `Channels (${counts.Channel})` });
     if (counts.Design > 0) dynamicFilters.push({ id: 'Design', name: `Designs (${counts.Design})` });
     if (counts.Team > 0) dynamicFilters.push({ id: 'Team', name: `Teams & Users (${counts.Team})` });
 
@@ -224,7 +233,7 @@ export default function SearchModal() {
   const filteredItems = useMemo(() => {
     if (query === '') {
       // Show favorites when search is empty
-      if (favorites.length > 0) {
+      if (favorites.length > 0 && activeFilter === 'all') {
         return favorites
           .slice(0, 5)
           .map((fav) => {
@@ -375,14 +384,14 @@ export default function SearchModal() {
                                   <p className={classNames('text-sm font-medium', active ? 'text-gray-900' : 'text-gray-700')}>
                                     {item.name}
                                   </p>
-                                  <div className="flex items-start gap-2">
+                                  <div className="flex items-center gap-2">
                                     <p
                                       className={classNames('text-sm flex-shrink-0', active ? 'text-gray-700' : 'text-gray-500')}
                                     >
                                       {item.type}
                                     </p>
                                     {item.rawNode.summary && (
-                                      <p className={classNames('text-xs truncate', active ? 'text-gray-600' : 'text-gray-400')}>
+                                      <p className={classNames('text-sm truncate', active ? 'text-gray-600' : 'text-gray-400')}>
                                         • {item.rawNode.summary}
                                       </p>
                                     )}

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

@@ -14,6 +14,8 @@ import {
   Database,
   Waypoints,
   SquareMousePointer,
+  ListOrdered,
+  ArrowLeftRight,
 } from 'lucide-react';
 import type { NavNode } from './sidebar-builder';
 
@@ -28,6 +30,7 @@ const getBadgeClasses = (badge: string): string => {
     query: 'bg-purple-100 text-purple-700',
     message: 'bg-indigo-100 text-indigo-700',
     design: 'bg-teal-100 text-teal-700',
+    channel: 'bg-indigo-100 text-indigo-700',
   };
   return badgeColors[badge.toLowerCase()] || 'bg-gray-100 text-gray-600';
 };
@@ -77,6 +80,7 @@ export default function SearchBar({ nodes, onSelectResult, onSearchChange }: Pro
   };
 
   const filterTypes = [
+    { key: 'channel', label: 'Channels', badge: 'Channel', icon: ArrowLeftRight },
     { key: 'command', label: 'Commands', badge: 'Command', icon: MessageSquare },
     { key: 'container', label: 'Data Stores', badge: 'Container', icon: Database },
     { key: 'design', label: 'Designs', badge: 'Design', icon: SquareMousePointer },

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

@@ -25,6 +25,7 @@ const getBadgeClasses = (badge: string): string => {
     query: 'bg-purple-100 text-purple-700',
     message: 'bg-indigo-100 text-indigo-700',
     design: 'bg-teal-100 text-teal-700',
+    channel: 'bg-indigo-100 text-indigo-700',
   };
   return badgeColors[badge.toLowerCase()] || 'bg-gray-100 text-gray-600';
 };
@@ -786,17 +787,17 @@ export default function NestedSideBar() {
         </div>
         <div className="flex items-center gap-1 flex-shrink-0">
           {canFavorite && (
-            <button
+            <div
               onClick={handleStarClick}
               className={cn(
-                'flex items-center justify-center w-5 h-5 rounded transition-colors',
+                'flex items-center justify-center w-5 h-5 rounded transition-colors cursor-pointer',
                 isFav
                   ? 'text-amber-400 hover:text-amber-500'
                   : 'text-gray-300 opacity-0 group-hover:opacity-100 hover:text-amber-400'
               )}
             >
               <Star className={cn('w-3.5 h-3.5', isFav && 'fill-current')} />
-            </button>
+            </div>
           )}
           {itemHasChildren && (
             <span className="flex items-center justify-center w-5 h-5 text-gray-400 group-hover:text-black group-hover:translate-x-0.5 transition-transform">
@@ -1038,15 +1039,15 @@ export default function NestedSideBar() {
                               {fav.badge}
                             </span>
                           )}
-                          <button
+                          <div
                             onClick={(e) => {
                               e.stopPropagation();
                               if (node) toggleFavorite(fav.nodeKey, node);
                             }}
-                            className="flex items-center justify-center w-5 h-5 text-amber-400 hover:text-amber-500 rounded transition-colors"
+                            className="flex items-center justify-center w-5 h-5 text-amber-400 hover:text-amber-500 rounded transition-colors cursor-pointer"
                           >
                             <Star className="w-3.5 h-3.5 fill-current" />
-                          </button>
+                          </div>
                           {node?.pages && node.pages.length > 0 && (
                             <span className="flex items-center justify-center w-5 h-5 text-gray-400 group-hover:text-black">
                               <ChevronRight className="w-4 h-4" />

package/eventcatalog/src/components/SideNav/NestedSideBar/sidebar-builder.ts

@@ -15,6 +15,7 @@ import { buildContainerNode } from './builders/container';
 import { buildFlowNode } from './builders/flow';
 import config from '@config';
 import { getDesigns } from '@utils/collections/designs';
+import { getChannels } from '@utils/collections/channels';
 
 export type { NavigationData, NavNode, ChildRef };
 
@@ -29,16 +30,18 @@ export const getNestedSideBarData = async (): Promise<NavigationData> => {
     return memoryCache;
   }
 
-  const [domains, services, { events, commands, queries }, containers, flows, users, teams, designs] = await Promise.all([
-    getDomains({ getAllVersions: false, includeServicesInSubdomains: false }),
-    getServices({ getAllVersions: false }),
-    getMessages({ getAllVersions: false }),
-    getContainers({ getAllVersions: false }),
-    getFlows({ getAllVersions: false }),
-    getUsers(),
-    getTeams(),
-    getDesigns(),
-  ]);
+  const [domains, services, { events, commands, queries }, containers, flows, users, teams, designs, channels] =
+    await Promise.all([
+      getDomains({ getAllVersions: false, includeServicesInSubdomains: false }),
+      getServices({ getAllVersions: false }),
+      getMessages({ getAllVersions: false }),
+      getContainers({ getAllVersions: false }),
+      getFlows({ getAllVersions: false }),
+      getUsers(),
+      getTeams(),
+      getDesigns(),
+      getChannels({ getAllVersions: false }),
+    ]);
 
   // Calculate derived lists to avoid extra fetches
   const allSubDomainIds = new Set(domains.flatMap((d) => (d.data.domains || []).map((sd: any) => sd.data.id)));
@@ -178,6 +181,30 @@ export const getNestedSideBarData = async (): Promise<NavigationData> => {
     {} as Record<string, NavNode>
   );
 
+  const channelNodes = channels.reduce(
+    (acc, channel) => {
+      acc[`channel:${channel.data.id}:${channel.data.version}`] = {
+        type: 'item',
+        title: channel.data.name,
+        badge: 'Channel',
+        summary: channel.data.summary,
+        href: buildUrl(`/docs/${channel.collection}/${channel.data.id}/${channel.data.version}`),
+      };
+
+      if (channel.data.latestVersion === channel.data.version) {
+        acc[`channel:${channel.data.id}`] = {
+          type: 'item',
+          title: channel.data.name,
+          badge: 'Channel',
+          summary: channel.data.summary,
+          href: buildUrl(`/docs/${channel.collection}/${channel.data.id}/${channel.data.version}`),
+        };
+      }
+      return acc;
+    },
+    {} as Record<string, NavNode>
+  );
+
   const teamNodes = teams.reduce(
     (acc, team) => {
       acc[`team:${team.data.id}`] = {
@@ -273,6 +300,13 @@ export const getNestedSideBarData = async (): Promise<NavigationData> => {
     pages: users.map((user) => `user:${user.data.id}`),
   });
 
+  const channelList = createLeaf(channels, {
+    type: 'item',
+    title: 'Channels',
+    icon: 'ArrowRightLeft',
+    pages: channels.map((channel) => `channel:${channel.data.id}:${channel.data.version}`),
+  });
+
   const messagesChildren = ['list:events', 'list:commands', 'list:queries'].filter(
     (key, index) => [eventsList, commandsList, queriesList][index] !== undefined
   );
@@ -303,12 +337,22 @@ export const getNestedSideBarData = async (): Promise<NavigationData> => {
     'list:domains',
     'list:services',
     'list:messages',
+    'list:channels',
     'list:flows',
     'list:containers',
     'list:designs',
     'list:people',
   ];
-  const allChildrenNodes = [domainsList, servicesList, messagesList, flowsList, containersList, designsList, peopleList];
+  const allChildrenNodes = [
+    domainsList,
+    servicesList,
+    messagesList,
+    channelList,
+    flowsList,
+    containersList,
+    designsList,
+    peopleList,
+  ];
 
   const validAllChildren = allChildrenKeys.filter((_, idx) => allChildrenNodes[idx] !== undefined);
 
@@ -334,6 +378,7 @@ export const getNestedSideBarData = async (): Promise<NavigationData> => {
     ...(designsList ? { 'list:designs': designsList } : {}),
     ...(teamsList ? { 'list:teams': teamsList } : {}),
     ...(usersList ? { 'list:users': usersList } : {}),
+    ...(channelList ? { 'list:channels': channelList as NavNode } : {}),
     ...(peopleList ? { 'list:people': peopleList as NavNode } : {}),
     ...(allList ? { 'list:all': allList as NavNode } : {}),
   };
@@ -343,6 +388,7 @@ export const getNestedSideBarData = async (): Promise<NavigationData> => {
     ...domainNodes,
     ...serviceNodes,
     ...messageNodes,
+    ...channelNodes,
     ...containerNodes,
     ...flowNodes,
     ...userNodes,

package/eventcatalog/src/pages/auth/login.astro

@@ -167,7 +167,7 @@ const providerConfig = {
 
               <div class="text-center">
                 <a
-                  href="#"
+                  href="https://www.eventcatalog.dev/docs/development/authentication/introduction"
                   class="inline-flex items-center px-6 py-3 border border-transparent text-sm font-medium rounded-lg text-white bg-purple-600 hover:bg-purple-700 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-purple-500 transition-colors duration-200"
                 >
                   Read Authentication Documentation
@@ -237,7 +237,7 @@ const providerConfig = {
 
               <div class="text-center">
                 <a
-                  href="#"
+                  href="https://www.eventcatalog.dev/docs/development/authentication/introduction"
                   class="inline-flex items-center px-6 py-3 border border-transparent text-sm font-medium rounded-lg text-white bg-purple-600 hover:bg-purple-700 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-purple-500 transition-colors duration-200"
                 >
                   Read Authentication Documentation

package/package.json

@@ -6,7 +6,7 @@
     "url": "https://github.com/event-catalog/eventcatalog.git"
   },
   "type": "module",
-  "version": "3.0.0-beta.2",
+  "version": "3.0.0-beta.4",
   "publishConfig": {
     "access": "public"
   },
@@ -87,6 +87,7 @@
     "nanostores": "^1.1.0",
     "pagefind": "^1.3.0",
     "pako": "^2.1.0",
+    "picocolors": "^1.1.1",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "react-markdown": "^10.1.0",