@eventcatalog/sdk 2.5.4 → 2.6.0

package/dist/eventcatalog.mjs

@@ -1,9 +1,9 @@
 // src/eventcatalog.ts
 import fs10 from "fs";
-import path3, { join as join13 } from "path";
+import path3, { join as join14 } from "path";
 
 // src/index.ts
-import { join as join12 } from "path";
+import { join as join13 } from "path";
 
 // src/events.ts
 import fs2 from "fs/promises";
@@ -77,7 +77,8 @@ var readMdxFile = async (path4) => {
   return { ...frontmatter, markdown };
 };
 var searchFilesForId = async (files, id, version) => {
-  const idRegex = new RegExp(`^id:\\s*(['"]|>-)?\\s*${id}['"]?\\s*$`, "m");
+  const escapedId = id.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const idRegex = new RegExp(`^id:\\s*(['"]|>-)?\\s*${escapedId}['"]?\\s*$`, "m");
   const versionRegex = new RegExp(`^version:\\s*['"]?${version}['"]?\\s*$`, "m");
   const matches = files.map((file) => {
     const content = fsSync.readFileSync(file, "utf-8");
@@ -294,6 +295,12 @@ var getFileFromResource = async (catalogDir, id, file, version) => {
 var getVersionedDirectory = (sourceDirectory, version) => {
   return join2(sourceDirectory, "versioned", version);
 };
+var isLatestVersion = async (catalogDir, id, version) => {
+  const resource = await getResource(catalogDir, id, version);
+  if (!resource) return false;
+  const pathToResource = await getResourcePath(catalogDir, id, version);
+  return !pathToResource?.relativePath.replace(/\\/g, "/").includes("/versioned/");
+};
 
 // src/events.ts
 var getEvent = (directory) => async (id, version, options) => getResource(directory, id, version, { type: "event", ...options });
@@ -635,11 +642,79 @@ var addMessageToChannel = (directory, collection) => async (id, _message, versio
   await writeMessage(pathToResource)(message, { format: extension === ".md" ? "md" : "mdx" });
 };
 
+// src/messages.ts
+import { dirname as dirname5 } from "path";
+import matter4 from "gray-matter";
+var getMessageBySchemaPath = (directory) => async (path4, options) => {
+  const pathToMessage = dirname5(path4);
+  try {
+    const files = await getFiles(`${pathToMessage}/index.{md,mdx}`);
+    if (!files || files.length === 0) {
+      throw new Error(`No message definition file (index.md or index.mdx) found in directory: ${pathToMessage}`);
+    }
+    const messageFile = files[0];
+    const { data } = matter4.read(messageFile);
+    const { id, version } = data;
+    if (!id || !version) {
+      throw new Error(`Message definition file at ${messageFile} is missing 'id' or 'version' in its frontmatter.`);
+    }
+    const message = await getResource(directory, id, version, { type: "message", ...options });
+    if (!message) {
+      throw new Error(`Message resource with id '${id}' and version '${version}' not found, as referenced in ${messageFile}.`);
+    }
+    return message;
+  } catch (error) {
+    console.error(`Failed to get message for schema path ${path4}. Error processing directory ${pathToMessage}:`, error);
+    if (error instanceof Error) {
+      error.message = `Failed to retrieve message from ${pathToMessage}: ${error.message}`;
+      throw error;
+    }
+    throw new Error(`Failed to retrieve message from ${pathToMessage} due to an unknown error.`);
+  }
+};
+var getProducersAndConsumersForMessage = (directory) => async (id, version) => {
+  const services = await getServices(directory)({ latestOnly: true });
+  const message = await getResource(directory, id, version, { type: "message" });
+  const isMessageLatestVersion = await isLatestVersion(directory, id, version);
+  if (!message) {
+    throw new Error(`Message resource with id '${id}' and version '${version}' not found.`);
+  }
+  const producers = [];
+  const consumers = [];
+  for (const service of services) {
+    const servicePublishesMessage = service.sends?.some((_message) => {
+      if (_message.version) {
+        return _message.id === message.id && _message.version === message.version;
+      }
+      if (isMessageLatestVersion && _message.id === message.id) {
+        return true;
+      }
+      return false;
+    });
+    const serviceSubscribesToMessage = service.receives?.some((_message) => {
+      if (_message.version) {
+        return _message.id === message.id && _message.version === message.version;
+      }
+      if (isMessageLatestVersion && _message.id === message.id) {
+        return true;
+      }
+      return false;
+    });
+    if (servicePublishesMessage) {
+      producers.push(service);
+    }
+    if (serviceSubscribesToMessage) {
+      consumers.push(service);
+    }
+  }
+  return { producers, consumers };
+};
+
 // src/custom-docs.ts
-import path2, { join as join9 } from "path";
+import path2, { join as join10 } from "path";
 import fsSync4 from "fs";
 import fs8 from "fs/promises";
-import matter4 from "gray-matter";
+import matter5 from "gray-matter";
 import slugify from "slugify";
 var getCustomDoc = (directory) => async (filePath) => {
   const fullPath = path2.join(directory, filePath);
@@ -663,24 +738,24 @@ var writeCustomDoc = (directory) => async (customDoc, options = { path: "" }) =>
   const withExtension = name.endsWith(".mdx") ? name : `${name}.mdx`;
   const fullPath = path2.join(directory, options.path || "", withExtension);
   fsSync4.mkdirSync(path2.dirname(fullPath), { recursive: true });
-  const document = matter4.stringify(customDoc.markdown.trim(), rest);
+  const document = matter5.stringify(customDoc.markdown.trim(), rest);
   fsSync4.writeFileSync(fullPath, document);
 };
 var rmCustomDoc = (directory) => async (filePath) => {
   const withExtension = filePath.endsWith(".mdx") ? filePath : `${filePath}.mdx`;
-  await fs8.rm(join9(directory, withExtension), { recursive: true });
+  await fs8.rm(join10(directory, withExtension), { recursive: true });
 };
 
 // src/teams.ts
 import fs9 from "fs/promises";
 import fsSync5 from "fs";
-import { join as join10 } from "path";
-import matter5 from "gray-matter";
+import { join as join11 } from "path";
+import matter6 from "gray-matter";
 var getTeam = (catalogDir) => async (id) => {
   const files = await getFiles(`${catalogDir}/${id}.{md,mdx}`);
   if (files.length == 0) return void 0;
   const file = files[0];
-  const { data, content } = matter5.read(file);
+  const { data, content } = matter6.read(file);
   return {
     ...data,
     id: data.id,
@@ -692,7 +767,7 @@ var getTeams = (catalogDir) => async (options) => {
   const files = await getFiles(`${catalogDir}/teams/*.{md,mdx}`);
   if (files.length === 0) return [];
   return files.map((file) => {
-    const { data, content } = matter5.read(file);
+    const { data, content } = matter6.read(file);
     return {
       ...data,
       id: data.id,
@@ -709,23 +784,23 @@ var writeTeam = (catalogDir) => async (team, options = {}) => {
     throw new Error(`Failed to write ${resource.id} (team) as it already exists`);
   }
   const { markdown, ...frontmatter } = resource;
-  const document = matter5.stringify(markdown, frontmatter);
-  fsSync5.mkdirSync(join10(catalogDir, ""), { recursive: true });
-  fsSync5.writeFileSync(join10(catalogDir, "", `${resource.id}.mdx`), document);
+  const document = matter6.stringify(markdown, frontmatter);
+  fsSync5.mkdirSync(join11(catalogDir, ""), { recursive: true });
+  fsSync5.writeFileSync(join11(catalogDir, "", `${resource.id}.mdx`), document);
 };
 var rmTeamById = (catalogDir) => async (id) => {
-  await fs9.rm(join10(catalogDir, `${id}.mdx`), { recursive: true });
+  await fs9.rm(join11(catalogDir, `${id}.mdx`), { recursive: true });
 };
 
 // src/users.ts
 import fsSync6 from "fs";
-import { join as join11 } from "path";
-import matter6 from "gray-matter";
+import { join as join12 } from "path";
+import matter7 from "gray-matter";
 var getUser = (catalogDir) => async (id) => {
   const files = await getFiles(`${catalogDir}/${id}.{md,mdx}`);
   if (files.length == 0) return void 0;
   const file = files[0];
-  const { data, content } = matter6.read(file);
+  const { data, content } = matter7.read(file);
   return {
     ...data,
     id: data.id,
@@ -738,7 +813,7 @@ var getUsers = (catalogDir) => async (options) => {
   const files = await getFiles(`${catalogDir}/users/*.{md,mdx}`);
   if (files.length === 0) return [];
   return files.map((file) => {
-    const { data, content } = matter6.read(file);
+    const { data, content } = matter7.read(file);
     return {
       ...data,
       id: data.id,
@@ -756,12 +831,12 @@ var writeUser = (catalogDir) => async (user, options = {}) => {
     throw new Error(`Failed to write ${resource.id} (user) as it already exists`);
   }
   const { markdown, ...frontmatter } = resource;
-  const document = matter6.stringify(markdown, frontmatter);
-  fsSync6.mkdirSync(join11(catalogDir, ""), { recursive: true });
-  fsSync6.writeFileSync(join11(catalogDir, "", `${resource.id}.mdx`), document);
+  const document = matter7.stringify(markdown, frontmatter);
+  fsSync6.mkdirSync(join12(catalogDir, ""), { recursive: true });
+  fsSync6.writeFileSync(join12(catalogDir, "", `${resource.id}.mdx`), document);
 };
 var rmUserById = (catalogDir) => async (id) => {
-  fsSync6.rmSync(join11(catalogDir, `${id}.mdx`), { recursive: true });
+  fsSync6.rmSync(join12(catalogDir, `${id}.mdx`), { recursive: true });
 };
 
 // src/index.ts
@@ -773,13 +848,13 @@ var index_default = (path4) => {
      * @param version - Optional id of the version to get (supports semver)
      * @returns Event|Undefined
      */
-    getEvent: getEvent(join12(path4)),
+    getEvent: getEvent(join13(path4)),
     /**
      * Returns all events from EventCatalog
      * @param latestOnly - optional boolean, set to true to get only latest versions
      * @returns Event[]|Undefined
      */
-    getEvents: getEvents(join12(path4)),
+    getEvents: getEvents(join13(path4)),
     /**
      * Adds an event to EventCatalog
      *
@@ -787,7 +862,7 @@ var index_default = (path4) => {
      * @param options - Optional options to write the event
      *
      */
-    writeEvent: writeEvent(join12(path4, "events")),
+    writeEvent: writeEvent(join13(path4, "events")),
     /**
      * Adds an event to a service in EventCatalog
      *
@@ -796,26 +871,26 @@ var index_default = (path4) => {
      * @param options - Optional options to write the event
      *
      */
-    writeEventToService: writeEventToService(join12(path4)),
+    writeEventToService: writeEventToService(join13(path4)),
     /**
      * Remove an event to EventCatalog (modeled on the standard POSIX rm utility)
      *
      * @param path - The path to your event, e.g. `/Inventory/InventoryAdjusted`
      *
      */
-    rmEvent: rmEvent(join12(path4, "events")),
+    rmEvent: rmEvent(join13(path4, "events")),
     /**
      * Remove an event by an Event id
      *
      * @param id - The id of the event you want to remove
      *
      */
-    rmEventById: rmEventById(join12(path4)),
+    rmEventById: rmEventById(join13(path4)),
     /**
      * Moves a given event id to the version directory
      * @param directory
      */
-    versionEvent: versionEvent(join12(path4)),
+    versionEvent: versionEvent(join13(path4)),
     /**
      * Adds a file to the given event
      * @param id - The id of the event to add the file to
@@ -823,7 +898,7 @@ var index_default = (path4) => {
      * @param version - Optional version of the event to add the file to
      * @returns
      */
-    addFileToEvent: addFileToEvent(join12(path4)),
+    addFileToEvent: addFileToEvent(join13(path4)),
     /**
      * Adds a schema to the given event
      * @param id - The id of the event to add the schema to
@@ -831,14 +906,14 @@ var index_default = (path4) => {
      * @param version - Optional version of the event to add the schema to
      * @returns
      */
-    addSchemaToEvent: addSchemaToEvent(join12(path4)),
+    addSchemaToEvent: addSchemaToEvent(join13(path4)),
     /**
      * Check to see if an event version exists
      * @param id - The id of the event
      * @param version - The version of the event (supports semver)
      * @returns
      */
-    eventHasVersion: eventHasVersion(join12(path4)),
+    eventHasVersion: eventHasVersion(join13(path4)),
     /**
      * ================================
      *            Commands
@@ -850,13 +925,13 @@ var index_default = (path4) => {
      * @param version - Optional id of the version to get (supports semver)
      * @returns Command|Undefined
      */
-    getCommand: getCommand(join12(path4)),
+    getCommand: getCommand(join13(path4)),
     /**
      * Returns all commands from EventCatalog
      * @param latestOnly - optional boolean, set to true to get only latest versions
      * @returns Command[]|Undefined
      */
-    getCommands: getCommands(join12(path4)),
+    getCommands: getCommands(join13(path4)),
     /**
      * Adds an command to EventCatalog
      *
@@ -864,7 +939,7 @@ var index_default = (path4) => {
      * @param options - Optional options to write the command
      *
      */
-    writeCommand: writeCommand(join12(path4, "commands")),
+    writeCommand: writeCommand(join13(path4, "commands")),
     /**
      * Adds a command to a service in EventCatalog
      *
@@ -873,26 +948,26 @@ var index_default = (path4) => {
      * @param options - Optional options to write the command
      *
      */
-    writeCommandToService: writeCommandToService(join12(path4)),
+    writeCommandToService: writeCommandToService(join13(path4)),
     /**
      * Remove an command to EventCatalog (modeled on the standard POSIX rm utility)
      *
      * @param path - The path to your command, e.g. `/Inventory/InventoryAdjusted`
      *
      */
-    rmCommand: rmCommand(join12(path4, "commands")),
+    rmCommand: rmCommand(join13(path4, "commands")),
     /**
      * Remove an command by an Event id
      *
      * @param id - The id of the command you want to remove
      *
      */
-    rmCommandById: rmCommandById(join12(path4)),
+    rmCommandById: rmCommandById(join13(path4)),
     /**
      * Moves a given command id to the version directory
      * @param directory
      */
-    versionCommand: versionCommand(join12(path4)),
+    versionCommand: versionCommand(join13(path4)),
     /**
      * Adds a file to the given command
      * @param id - The id of the command to add the file to
@@ -900,7 +975,7 @@ var index_default = (path4) => {
      * @param version - Optional version of the command to add the file to
      * @returns
      */
-    addFileToCommand: addFileToCommand(join12(path4)),
+    addFileToCommand: addFileToCommand(join13(path4)),
     /**
      * Adds a schema to the given command
      * @param id - The id of the command to add the schema to
@@ -908,14 +983,14 @@ var index_default = (path4) => {
      * @param version - Optional version of the command to add the schema to
      * @returns
      */
-    addSchemaToCommand: addSchemaToCommand(join12(path4)),
+    addSchemaToCommand: addSchemaToCommand(join13(path4)),
     /**
      * Check to see if a command version exists
      * @param id - The id of the command
      * @param version - The version of the command (supports semver)
      * @returns
      */
-    commandHasVersion: commandHasVersion(join12(path4)),
+    commandHasVersion: commandHasVersion(join13(path4)),
     /**
      * ================================
      *            Queries
@@ -927,13 +1002,13 @@ var index_default = (path4) => {
      * @param version - Optional id of the version to get (supports semver)
      * @returns Query|Undefined
      */
-    getQuery: getQuery(join12(path4)),
+    getQuery: getQuery(join13(path4)),
     /**
      * Returns all queries from EventCatalog
      * @param latestOnly - optional boolean, set to true to get only latest versions
      * @returns Query[]|Undefined
      */
-    getQueries: getQueries(join12(path4)),
+    getQueries: getQueries(join13(path4)),
     /**
      * Adds a query to EventCatalog
      *
@@ -941,7 +1016,7 @@ var index_default = (path4) => {
      * @param options - Optional options to write the event
      *
      */
-    writeQuery: writeQuery(join12(path4, "queries")),
+    writeQuery: writeQuery(join13(path4, "queries")),
     /**
      * Adds a query to a service in EventCatalog
      *
@@ -950,26 +1025,26 @@ var index_default = (path4) => {
      * @param options - Optional options to write the query
      *
      */
-    writeQueryToService: writeQueryToService(join12(path4)),
+    writeQueryToService: writeQueryToService(join13(path4)),
     /**
      * Remove an query to EventCatalog (modeled on the standard POSIX rm utility)
      *
      * @param path - The path to your query, e.g. `/Orders/GetOrder`
      *
      */
-    rmQuery: rmQuery(join12(path4, "queries")),
+    rmQuery: rmQuery(join13(path4, "queries")),
     /**
      * Remove a query by a Query id
      *
      * @param id - The id of the query you want to remove
      *
      */
-    rmQueryById: rmQueryById(join12(path4)),
+    rmQueryById: rmQueryById(join13(path4)),
     /**
      * Moves a given query id to the version directory
      * @param directory
      */
-    versionQuery: versionQuery(join12(path4)),
+    versionQuery: versionQuery(join13(path4)),
     /**
      * Adds a file to the given query
      * @param id - The id of the query to add the file to
@@ -977,7 +1052,7 @@ var index_default = (path4) => {
      * @param version - Optional version of the query to add the file to
      * @returns
      */
-    addFileToQuery: addFileToQuery(join12(path4)),
+    addFileToQuery: addFileToQuery(join13(path4)),
     /**
      * Adds a schema to the given query
      * @param id - The id of the query to add the schema to
@@ -985,14 +1060,14 @@ var index_default = (path4) => {
      * @param version - Optional version of the query to add the schema to
      * @returns
      */
-    addSchemaToQuery: addSchemaToQuery(join12(path4)),
+    addSchemaToQuery: addSchemaToQuery(join13(path4)),
     /**
      * Check to see if an query version exists
      * @param id - The id of the query
      * @param version - The version of the query (supports semver)
      * @returns
      */
-    queryHasVersion: queryHasVersion(join12(path4)),
+    queryHasVersion: queryHasVersion(join13(path4)),
     /**
      * ================================
      *            Channels
@@ -1004,13 +1079,13 @@ var index_default = (path4) => {
      * @param version - Optional id of the version to get (supports semver)
      * @returns Channel|Undefined
      */
-    getChannel: getChannel(join12(path4)),
+    getChannel: getChannel(join13(path4)),
     /**
      * Returns all channels from EventCatalog
      * @param latestOnly - optional boolean, set to true to get only latest versions
      * @returns Channel[]|Undefined
      */
-    getChannels: getChannels(join12(path4)),
+    getChannels: getChannels(join13(path4)),
     /**
      * Adds an channel to EventCatalog
      *
@@ -1018,33 +1093,33 @@ var index_default = (path4) => {
      * @param options - Optional options to write the channel
      *
      */
-    writeChannel: writeChannel(join12(path4, "channels")),
+    writeChannel: writeChannel(join13(path4, "channels")),
     /**
      * Remove an channel to EventCatalog (modeled on the standard POSIX rm utility)
      *
      * @param path - The path to your channel, e.g. `/Inventory/InventoryAdjusted`
      *
      */
-    rmChannel: rmChannel(join12(path4, "channels")),
+    rmChannel: rmChannel(join13(path4, "channels")),
     /**
      * Remove an channel by an Event id
      *
      * @param id - The id of the channel you want to remove
      *
      */
-    rmChannelById: rmChannelById(join12(path4)),
+    rmChannelById: rmChannelById(join13(path4)),
     /**
      * Moves a given channel id to the version directory
      * @param directory
      */
-    versionChannel: versionChannel(join12(path4)),
+    versionChannel: versionChannel(join13(path4)),
     /**
      * Check to see if a channel version exists
      * @param id - The id of the channel
      * @param version - The version of the channel (supports semver)
      * @returns
      */
-    channelHasVersion: channelHasVersion(join12(path4)),
+    channelHasVersion: channelHasVersion(join13(path4)),
     /**
      * Add a channel to an event
      *
@@ -1061,7 +1136,7 @@ var index_default = (path4) => {
      *
      * ```
      */
-    addEventToChannel: addMessageToChannel(join12(path4), "events"),
+    addEventToChannel: addMessageToChannel(join13(path4), "events"),
     /**
      * Add a channel to an command
      *
@@ -1078,7 +1153,7 @@ var index_default = (path4) => {
      *
      * ```
      */
-    addCommandToChannel: addMessageToChannel(join12(path4), "commands"),
+    addCommandToChannel: addMessageToChannel(join13(path4), "commands"),
     /**
      * Add a channel to an query
      *
@@ -1095,7 +1170,7 @@ var index_default = (path4) => {
      *
      * ```
      */
-    addQueryToChannel: addMessageToChannel(join12(path4), "queries"),
+    addQueryToChannel: addMessageToChannel(join13(path4), "queries"),
     /**
      * ================================
      *            SERVICES
@@ -1108,14 +1183,14 @@ var index_default = (path4) => {
      * @param options - Optional options to write the event
      *
      */
-    writeService: writeService(join12(path4, "services")),
+    writeService: writeService(join13(path4, "services")),
     /**
      * Adds a versioned service to EventCatalog
      *
      * @param service - The service to write
      *
      */
-    writeVersionedService: writeVersionedService(join12(path4, "services")),
+    writeVersionedService: writeVersionedService(join13(path4, "services")),
     /**
      * Adds a service to a domain in EventCatalog
      *
@@ -1124,39 +1199,39 @@ var index_default = (path4) => {
      * @param options - Optional options to write the event
      *
      */
-    writeServiceToDomain: writeServiceToDomain(join12(path4, "domains")),
+    writeServiceToDomain: writeServiceToDomain(join13(path4, "domains")),
     /**
      * Returns a service from EventCatalog
      * @param id - The id of the service to retrieve
      * @param version - Optional id of the version to get (supports semver)
      * @returns Service|Undefined
      */
-    getService: getService(join12(path4)),
+    getService: getService(join13(path4)),
     /**
      * Returns all services from EventCatalog
      * @param latestOnly - optional boolean, set to true to get only latest versions
      * @returns Service[]|Undefined
      */
-    getServices: getServices(join12(path4)),
+    getServices: getServices(join13(path4)),
     /**
      * Moves a given service id to the version directory
      * @param directory
      */
-    versionService: versionService(join12(path4)),
+    versionService: versionService(join13(path4)),
     /**
      * Remove a service from EventCatalog (modeled on the standard POSIX rm utility)
      *
      * @param path - The path to your service, e.g. `/InventoryService`
      *
      */
-    rmService: rmService(join12(path4, "services")),
+    rmService: rmService(join13(path4, "services")),
     /**
      * Remove an service by an service id
      *
      * @param id - The id of the service you want to remove
      *
      */
-    rmServiceById: rmServiceById(join12(path4)),
+    rmServiceById: rmServiceById(join13(path4)),
     /**
      * Adds a file to the given service
      * @param id - The id of the service to add the file to
@@ -1164,21 +1239,21 @@ var index_default = (path4) => {
      * @param version - Optional version of the service to add the file to
      * @returns
      */
-    addFileToService: addFileToService(join12(path4)),
+    addFileToService: addFileToService(join13(path4)),
     /**
      * Returns the specifications for a given service
      * @param id - The id of the service to retrieve the specifications for
      * @param version - Optional version of the service
      * @returns
      */
-    getSpecificationFilesForService: getSpecificationFilesForService(join12(path4)),
+    getSpecificationFilesForService: getSpecificationFilesForService(join13(path4)),
     /**
      * Check to see if a service version exists
      * @param id - The id of the service
      * @param version - The version of the service (supports semver)
      * @returns
      */
-    serviceHasVersion: serviceHasVersion(join12(path4)),
+    serviceHasVersion: serviceHasVersion(join13(path4)),
     /**
      * Add an event to a service by it's id.
      *
@@ -1198,7 +1273,7 @@ var index_default = (path4) => {
      *
      * ```
      */
-    addEventToService: addMessageToService(join12(path4)),
+    addEventToService: addMessageToService(join13(path4)),
     /**
      * Add a command to a service by it's id.
      *
@@ -1218,7 +1293,7 @@ var index_default = (path4) => {
      *
      * ```
      */
-    addCommandToService: addMessageToService(join12(path4)),
+    addCommandToService: addMessageToService(join13(path4)),
     /**
      * Add a query to a service by it's id.
      *
@@ -1238,7 +1313,7 @@ var index_default = (path4) => {
      *
      * ```
      */
-    addQueryToService: addMessageToService(join12(path4)),
+    addQueryToService: addMessageToService(join13(path4)),
     /**
      * ================================
      *            Domains
@@ -1251,39 +1326,39 @@ var index_default = (path4) => {
      * @param options - Optional options to write the event
      *
      */
-    writeDomain: writeDomain(join12(path4, "domains")),
+    writeDomain: writeDomain(join13(path4, "domains")),
     /**
      * Returns a domain from EventCatalog
      * @param id - The id of the domain to retrieve
      * @param version - Optional id of the version to get (supports semver)
      * @returns Domain|Undefined
      */
-    getDomain: getDomain(join12(path4, "domains")),
+    getDomain: getDomain(join13(path4, "domains")),
     /**
      * Returns all domains from EventCatalog
      * @param latestOnly - optional boolean, set to true to get only latest versions
      * @returns Domain[]|Undefined
      */
-    getDomains: getDomains(join12(path4)),
+    getDomains: getDomains(join13(path4)),
     /**
      * Moves a given domain id to the version directory
      * @param directory
      */
-    versionDomain: versionDomain(join12(path4, "domains")),
+    versionDomain: versionDomain(join13(path4, "domains")),
     /**
      * Remove a domain from EventCatalog (modeled on the standard POSIX rm utility)
      *
      * @param path - The path to your domain, e.g. `/Payment`
      *
      */
-    rmDomain: rmDomain(join12(path4, "domains")),
+    rmDomain: rmDomain(join13(path4, "domains")),
     /**
      * Remove an service by an domain id
      *
      * @param id - The id of the domain you want to remove
      *
      */
-    rmDomainById: rmDomainById(join12(path4, "domains")),
+    rmDomainById: rmDomainById(join13(path4, "domains")),
     /**
      * Adds a file to the given domain
      * @param id - The id of the domain to add the file to
@@ -1291,28 +1366,28 @@ var index_default = (path4) => {
      * @param version - Optional version of the domain to add the file to
      * @returns
      */
-    addFileToDomain: addFileToDomain(join12(path4, "domains")),
+    addFileToDomain: addFileToDomain(join13(path4, "domains")),
     /**
      * Adds an ubiquitous language dictionary to a domain
      * @param id - The id of the domain to add the ubiquitous language to
      * @param ubiquitousLanguageDictionary - The ubiquitous language dictionary to add
      * @param version - Optional version of the domain to add the ubiquitous language to
      */
-    addUbiquitousLanguageToDomain: addUbiquitousLanguageToDomain(join12(path4, "domains")),
+    addUbiquitousLanguageToDomain: addUbiquitousLanguageToDomain(join13(path4, "domains")),
     /**
      * Get the ubiquitous language dictionary from a domain
      * @param id - The id of the domain to get the ubiquitous language from
      * @param version - Optional version of the domain to get the ubiquitous language from
      * @returns
      */
-    getUbiquitousLanguageFromDomain: getUbiquitousLanguageFromDomain(join12(path4, "domains")),
+    getUbiquitousLanguageFromDomain: getUbiquitousLanguageFromDomain(join13(path4, "domains")),
     /**
      * Check to see if a domain version exists
      * @param id - The id of the domain
      * @param version - The version of the domain (supports semver)
      * @returns
      */
-    domainHasVersion: domainHasVersion(join12(path4)),
+    domainHasVersion: domainHasVersion(join13(path4)),
     /**
      * Adds a given service to a domain
      * @param id - The id of the domain
@@ -1320,7 +1395,7 @@ var index_default = (path4) => {
      * @param version - (Optional) The version of the domain to add the service to
      * @returns
      */
-    addServiceToDomain: addServiceToDomain(join12(path4, "domains")),
+    addServiceToDomain: addServiceToDomain(join13(path4, "domains")),
     /**
      * Adds a given subdomain to a domain
      * @param id - The id of the domain
@@ -1328,7 +1403,7 @@ var index_default = (path4) => {
      * @param version - (Optional) The version of the domain to add the subdomain to
      * @returns
      */
-    addSubDomainToDomain: addSubDomainToDomain(join12(path4, "domains")),
+    addSubDomainToDomain: addSubDomainToDomain(join13(path4, "domains")),
     /**
      * ================================
      *            Teams
@@ -1341,25 +1416,25 @@ var index_default = (path4) => {
      * @param options - Optional options to write the team
      *
      */
-    writeTeam: writeTeam(join12(path4, "teams")),
+    writeTeam: writeTeam(join13(path4, "teams")),
     /**
      * Returns a team from EventCatalog
      * @param id - The id of the team to retrieve
      * @returns Team|Undefined
      */
-    getTeam: getTeam(join12(path4, "teams")),
+    getTeam: getTeam(join13(path4, "teams")),
     /**
      * Returns all teams from EventCatalog
      * @returns Team[]|Undefined
      */
-    getTeams: getTeams(join12(path4)),
+    getTeams: getTeams(join13(path4)),
     /**
      * Remove a team by the team id
      *
      * @param id - The id of the team you want to remove
      *
      */
-    rmTeamById: rmTeamById(join12(path4, "teams")),
+    rmTeamById: rmTeamById(join13(path4, "teams")),
     /**
      * ================================
      *            Users
@@ -1372,25 +1447,25 @@ var index_default = (path4) => {
      * @param options - Optional options to write the user
      *
      */
-    writeUser: writeUser(join12(path4, "users")),
+    writeUser: writeUser(join13(path4, "users")),
     /**
      * Returns a user from EventCatalog
      * @param id - The id of the user to retrieve
      * @returns User|Undefined
      */
-    getUser: getUser(join12(path4, "users")),
+    getUser: getUser(join13(path4, "users")),
     /**
      * Returns all user from EventCatalog
      * @returns User[]|Undefined
      */
-    getUsers: getUsers(join12(path4)),
+    getUsers: getUsers(join13(path4)),
     /**
      * Remove a user by the user id
      *
      * @param id - The id of the user you want to remove
      *
      */
-    rmUserById: rmUserById(join12(path4, "users")),
+    rmUserById: rmUserById(join13(path4, "users")),
     /**
      * ================================
      *            Custom Docs
@@ -1401,32 +1476,32 @@ var index_default = (path4) => {
      * @param path - The path to the custom doc to retrieve
      * @returns CustomDoc|Undefined
      */
-    getCustomDoc: getCustomDoc(join12(path4, "docs")),
+    getCustomDoc: getCustomDoc(join13(path4, "docs")),
     /**
      * Returns all custom docs from EventCatalog
      * @param options - Optional options to get custom docs from a specific path
      * @returns CustomDoc[]|Undefined
      */
-    getCustomDocs: getCustomDocs(join12(path4, "docs")),
+    getCustomDocs: getCustomDocs(join13(path4, "docs")),
     /**
      * Writes a custom doc to EventCatalog
      * @param customDoc - The custom doc to write
      * @param options - Optional options to write the custom doc
      *
      */
-    writeCustomDoc: writeCustomDoc(join12(path4, "docs")),
+    writeCustomDoc: writeCustomDoc(join13(path4, "docs")),
     /**
      * Removes a custom doc from EventCatalog
      * @param path - The path to the custom doc to remove
      *
      */
-    rmCustomDoc: rmCustomDoc(join12(path4, "docs")),
+    rmCustomDoc: rmCustomDoc(join13(path4, "docs")),
     /**
      * Dumps the catalog to a JSON file.
      * @param directory - The directory to dump the catalog to
      * @returns A JSON file with the catalog
      */
-    dumpCatalog: dumpCatalog(join12(path4)),
+    dumpCatalog: dumpCatalog(join13(path4)),
     /**
      * Returns the event catalog configuration file.
      * The event catalog configuration file is the file that contains the configuration for the event catalog.
@@ -1434,7 +1509,7 @@ var index_default = (path4) => {
      * @param directory - The directory of the catalog.
      * @returns A JSON object with the configuration for the event catalog.
      */
-    getEventCatalogConfigurationFile: getEventCatalogConfigurationFile(join12(path4)),
+    getEventCatalogConfigurationFile: getEventCatalogConfigurationFile(join13(path4)),
     /**
      * ================================
      *            Resources Utils
@@ -1443,7 +1518,26 @@ var index_default = (path4) => {
     /**
      * Returns the path to a given resource by id and version
      */
-    getResourcePath
+    getResourcePath,
+    /**
+     * ================================
+     *            General Message Utils
+     * ================================
+     */
+    /**
+     * Returns a message from EventCatalog by a given schema path.
+     *
+     * @param path - The path to the message to retrieve
+     * @returns Message|Undefined
+     */
+    getMessageBySchemaPath: getMessageBySchemaPath(join13(path4)),
+    /**
+     * Returns the producers and consumers (services) for a given message
+     * @param id - The id of the message to get the producers and consumers for
+     * @param version - Optional version of the message
+     * @returns { producers: Service[], consumers: Service[] }
+     */
+    getProducersAndConsumersForMessage: getProducersAndConsumersForMessage(join13(path4))
   };
 };
 
@@ -1451,7 +1545,7 @@ var index_default = (path4) => {
 var DUMP_VERSION = "0.0.1";
 var getEventCatalogVersion = async (catalogDir) => {
   try {
-    const packageJson = fs10.readFileSync(join13(catalogDir, "package.json"), "utf8");
+    const packageJson = fs10.readFileSync(join14(catalogDir, "package.json"), "utf8");
     const packageJsonObject = JSON.parse(packageJson);
     return packageJsonObject["dependencies"]["@eventcatalog/core"];
   } catch (error) {
@@ -1485,7 +1579,7 @@ var filterCollection = (collection, options) => {
 };
 var getEventCatalogConfigurationFile = (directory) => async () => {
   try {
-    const path4 = join13(directory, "eventcatalog.config.js");
+    const path4 = join14(directory, "eventcatalog.config.js");
     const configModule = await import(path4);
     return configModule.default;
   } catch (error) {