@eventcatalog/sdk 2.8.3 → 2.9.0

package/dist/eventcatalog.js

@@ -35,14 +35,14 @@ __export(eventcatalog_exports, {
 });
 module.exports = __toCommonJS(eventcatalog_exports);
 var import_fs = __toESM(require("fs"));
-var import_node_path17 = __toESM(require("path"));
+var import_node_path18 = __toESM(require("path"));
 
 // src/index.ts
-var import_node_path16 = require("path");
+var import_node_path17 = require("path");
 
 // src/events.ts
 var import_promises2 = __toESM(require("fs/promises"));
-var import_node_path3 = require("path");
+var import_node_path4 = require("path");
 
 // src/internal/utils.ts
 var import_glob = require("glob");
@@ -59,26 +59,33 @@ var versionExists = async (catalogDir, id, version) => {
 var findFileById = async (catalogDir, id, version) => {
   const files = await getFiles(`${catalogDir}/**/index.{md,mdx}`);
   const matchedFiles = await searchFilesForId(files, id) || [];
-  const latestVersion = matchedFiles.find((path5) => !path5.includes("versioned"));
+  const latestVersion = matchedFiles.find((path6) => !path6.includes("versioned"));
   if (!version) {
     return latestVersion;
   }
-  const parsedFiles = matchedFiles.map((path5) => {
-    const { data } = import_gray_matter.default.read(path5);
-    return { ...data, path: path5 };
+  const parsedFiles = matchedFiles.map((path6) => {
+    const { data } = import_gray_matter.default.read(path6);
+    return { ...data, path: path6 };
   });
-  const semverRange = (0, import_semver.validRange)(version);
-  if (semverRange && (0, import_semver.valid)(version)) {
-    const match2 = parsedFiles.filter((c) => (0, import_semver.satisfies)(c.version, semverRange));
-    return match2.length > 0 ? match2[0].path : void 0;
+  if (version === "latest") {
+    return latestVersion;
   }
-  const sorted = parsedFiles.sort((a, b) => {
-    return a.version.localeCompare(b.version);
-  });
-  const match = sorted.length > 0 ? [sorted[sorted.length - 1]] : [];
-  if (match.length > 0) {
-    return match[0].path;
+  const exactMatch = parsedFiles.find((c) => c.version === version);
+  if (exactMatch) {
+    return exactMatch.path;
   }
+  const semverRange = (0, import_semver.validRange)(version);
+  if (semverRange) {
+    const match = parsedFiles.filter((c) => {
+      try {
+        return (0, import_semver.satisfies)(c.version, semverRange);
+      } catch (error) {
+        return false;
+      }
+    });
+    return match.length > 0 ? match[0].path : void 0;
+  }
+  return void 0;
 };
 var getFiles = async (pattern, ignore = "") => {
   try {
@@ -106,8 +113,8 @@ var getFiles = async (pattern, ignore = "") => {
     );
   }
 };
-var readMdxFile = async (path5) => {
-  const { data } = import_gray_matter.default.read(path5);
+var readMdxFile = async (path6) => {
+  const { data } = import_gray_matter.default.read(path6);
   const { markdown, ...frontmatter } = data;
   return { ...frontmatter, markdown };
 };
@@ -160,6 +167,7 @@ var import_node_fs2 = __toESM(require("fs"));
 var import_semver2 = require("semver");
 var import_proper_lockfile = require("proper-lockfile");
 var import_node_path2 = require("path");
+var import_node_path3 = __toESM(require("path"));
 var versionResource = async (catalogDir, id) => {
   const files = await getFiles(`${catalogDir}/**/index.{md,mdx}`);
   const matchedFiles = await searchFilesForId(files, id);
@@ -199,8 +207,8 @@ var writeResource = async (catalogDir, resource, options = {
   versionExistingContent: false,
   format: "mdx"
 }) => {
-  const path5 = options.path || `/${resource.id}`;
-  const fullPath = (0, import_path.join)(catalogDir, path5);
+  const path6 = options.path || `/${resource.id}`;
+  const fullPath = (0, import_path.join)(catalogDir, path6);
   const format = options.format || "mdx";
   import_node_fs2.default.mkdirSync(fullPath, { recursive: true });
   const lockPath = (0, import_path.join)(fullPath, `index.${format}`);
@@ -266,6 +274,11 @@ var getResourcePath = async (catalogDir, id, version) => {
     directory: (0, import_path.dirname)(file.replace(catalogDir, ""))
   };
 };
+var getResourceFolderName = async (catalogDir, id, version) => {
+  const paths = await getResourcePath(catalogDir, id, version);
+  if (!paths) return;
+  return paths?.directory.split(import_node_path3.default.sep).filter(Boolean).pop();
+};
 var toResource = async (catalogDir, rawContents) => {
   const { data, content } = (0, import_gray_matter2.default)(rawContents);
   return {
@@ -327,16 +340,16 @@ var rmResourceById = async (catalogDir, id, version, options) => {
     );
   }
 };
-var waitForFileRemoval = async (path5, maxRetries = 50, delay = 10) => {
+var waitForFileRemoval = async (path6, maxRetries = 50, delay = 10) => {
   for (let i = 0; i < maxRetries; i++) {
     try {
-      await import_promises.default.access(path5);
+      await import_promises.default.access(path6);
       await new Promise((resolve2) => setTimeout(resolve2, delay));
     } catch (error) {
       return;
     }
   }
-  throw new Error(`File/directory ${path5} was not removed after ${maxRetries} attempts`);
+  throw new Error(`File/directory ${path6} was not removed after ${maxRetries} attempts`);
 };
 var addFileToResource = async (catalogDir, id, file, version) => {
   const pathToResource = await findFileById(catalogDir, id, version);
@@ -380,11 +393,11 @@ var writeEventToService = (directory) => async (event, service, options = { path
     throw new Error("Service not found");
   }
   let pathForEvent = service.version && service.version !== "latest" ? `${resourcePath.directory}/versioned/${service.version}/events` : `${resourcePath.directory}/events`;
-  pathForEvent = (0, import_node_path3.join)(pathForEvent, event.id);
+  pathForEvent = (0, import_node_path4.join)(pathForEvent, event.id);
   await writeResource(directory, { ...event }, { ...options, path: pathForEvent, type: "event" });
 };
-var rmEvent = (directory) => async (path5) => {
-  await import_promises2.default.rm((0, import_node_path3.join)(directory, path5), { recursive: true });
+var rmEvent = (directory) => async (path6) => {
+  await import_promises2.default.rm((0, import_node_path4.join)(directory, path6), { recursive: true });
 };
 var rmEventById = (directory) => async (id, version, persistFiles) => {
   await rmResourceById(directory, id, version, { type: "event", persistFiles });
@@ -401,7 +414,7 @@ var eventHasVersion = (directory) => async (id, version) => {
 
 // src/commands.ts
 var import_promises3 = __toESM(require("fs/promises"));
-var import_node_path4 = require("path");
+var import_node_path5 = require("path");
 var getCommand = (directory) => async (id, version, options) => getResource(directory, id, version, { type: "command", ...options });
 var getCommands = (directory) => async (options) => getResources(directory, { type: "commands", ...options });
 var writeCommand = (directory) => async (command, options = {
@@ -416,11 +429,11 @@ var writeCommandToService = (directory) => async (command, service, options = {
     throw new Error("Service not found");
   }
   let pathForCommand = service.version && service.version !== "latest" ? `${resourcePath.directory}/versioned/${service.version}/commands` : `${resourcePath.directory}/commands`;
-  pathForCommand = (0, import_node_path4.join)(pathForCommand, command.id);
+  pathForCommand = (0, import_node_path5.join)(pathForCommand, command.id);
   await writeResource(directory, { ...command }, { ...options, path: pathForCommand, type: "command" });
 };
-var rmCommand = (directory) => async (path5) => {
-  await import_promises3.default.rm((0, import_node_path4.join)(directory, path5), { recursive: true });
+var rmCommand = (directory) => async (path6) => {
+  await import_promises3.default.rm((0, import_node_path5.join)(directory, path6), { recursive: true });
 };
 var rmCommandById = (directory) => async (id, version, persistFiles) => rmResourceById(directory, id, version, { type: "command", persistFiles });
 var versionCommand = (directory) => async (id) => versionResource(directory, id);
@@ -435,7 +448,7 @@ var commandHasVersion = (directory) => async (id, version) => {
 
 // src/queries.ts
 var import_promises4 = __toESM(require("fs/promises"));
-var import_node_path5 = require("path");
+var import_node_path6 = require("path");
 var getQuery = (directory) => async (id, version, options) => getResource(directory, id, version, { type: "query", ...options });
 var writeQuery = (directory) => async (query, options = {
   path: "",
@@ -450,11 +463,11 @@ var writeQueryToService = (directory) => async (query, service, options = { path
     throw new Error("Service not found");
   }
   let pathForQuery = service.version && service.version !== "latest" ? `${resourcePath.directory}/versioned/${service.version}/queries` : `${resourcePath.directory}/queries`;
-  pathForQuery = (0, import_node_path5.join)(pathForQuery, query.id);
+  pathForQuery = (0, import_node_path6.join)(pathForQuery, query.id);
   await writeResource(directory, { ...query }, { ...options, path: pathForQuery, type: "query" });
 };
-var rmQuery = (directory) => async (path5) => {
-  await import_promises4.default.rm((0, import_node_path5.join)(directory, path5), { recursive: true });
+var rmQuery = (directory) => async (path6) => {
+  await import_promises4.default.rm((0, import_node_path6.join)(directory, path6), { recursive: true });
 };
 var rmQueryById = (directory) => async (id, version, persistFiles) => {
   await rmResourceById(directory, id, version, { type: "query", persistFiles });
@@ -471,10 +484,10 @@ var queryHasVersion = (directory) => async (id, version) => {
 
 // src/services.ts
 var import_promises5 = __toESM(require("fs/promises"));
-var import_node_path6 = require("path");
+var import_node_path7 = require("path");
 var getService = (directory) => async (id, version) => getResource(directory, id, version, { type: "service" });
-var getServiceByPath = (directory) => async (path5) => {
-  const service = await getResource(directory, void 0, void 0, { type: "service" }, path5);
+var getServiceByPath = (directory) => async (path6) => {
+  const service = await getResource(directory, void 0, void 0, { type: "service" }, path6);
   return service;
 };
 var getServices = (directory) => async (options) => getResources(directory, {
@@ -498,17 +511,17 @@ var writeService = (directory) => async (service, options = {
 };
 var writeVersionedService = (directory) => async (service) => {
   const resource = { ...service };
-  const path5 = getVersionedDirectory(service.id, service.version);
-  return await writeService(directory)(resource, { path: path5 });
+  const path6 = getVersionedDirectory(service.id, service.version);
+  return await writeService(directory)(resource, { path: path6 });
 };
 var writeServiceToDomain = (directory) => async (service, domain, options = { path: "", format: "mdx", override: false }) => {
   let pathForService = domain.version && domain.version !== "latest" ? `/${domain.id}/versioned/${domain.version}/services` : `/${domain.id}/services`;
-  pathForService = (0, import_node_path6.join)(pathForService, service.id);
+  pathForService = (0, import_node_path7.join)(pathForService, service.id);
   await writeResource(directory, { ...service }, { ...options, path: pathForService, type: "service" });
 };
 var versionService = (directory) => async (id) => versionResource(directory, id);
-var rmService = (directory) => async (path5) => {
-  await import_promises5.default.rm((0, import_node_path6.join)(directory, path5), { recursive: true });
+var rmService = (directory) => async (path6) => {
+  await import_promises5.default.rm((0, import_node_path7.join)(directory, path6), { recursive: true });
 };
 var rmServiceById = (directory) => async (id, version, persistFiles) => {
   await rmResourceById(directory, id, version, { type: "service", persistFiles });
@@ -535,7 +548,7 @@ var getSpecificationFilesForService = (directory) => async (id, version) => {
         throw new Error(`Specification file name for ${fileName} is undefined`);
       }
       const rawFile = await getFileFromResource(directory, id, { fileName }, version);
-      return { key, content: rawFile, fileName, path: (0, import_node_path6.join)((0, import_node_path6.dirname)(filePathToService), fileName) };
+      return { key, content: rawFile, fileName, path: (0, import_node_path7.join)((0, import_node_path7.dirname)(filePathToService), fileName) };
     });
     specs = await Promise.all(getSpecs);
   }
@@ -544,7 +557,7 @@ var getSpecificationFilesForService = (directory) => async (id, version) => {
 var addMessageToService = (directory) => async (id, direction, event, version) => {
   let service = await getService(directory)(id, version);
   const servicePath = await getResourcePath(directory, id, version);
-  const extension = (0, import_node_path6.extname)(servicePath?.fullPath || "");
+  const extension = (0, import_node_path7.extname)(servicePath?.fullPath || "");
   if (direction === "sends") {
     if (service.sends === void 0) {
       service.sends = [];
@@ -572,8 +585,8 @@ var addMessageToService = (directory) => async (id, direction, event, version) =
   if (!existingResource) {
     throw new Error(`Cannot find service ${id} in the catalog`);
   }
-  const path5 = existingResource.split(/[\\/]+services/)[0];
-  const pathToResource = (0, import_node_path6.join)(path5, "services");
+  const path6 = existingResource.split(/[\\/]+services/)[0];
+  const pathToResource = (0, import_node_path7.join)(path6, "services");
   await rmServiceById(directory)(id, version);
   await writeService(pathToResource)(service, { format: extension === ".md" ? "md" : "mdx" });
 };
@@ -581,9 +594,9 @@ var serviceHasVersion = (directory) => async (id, version) => {
   const file = await findFileById(directory, id, version);
   return !!file;
 };
-var isService = (directory) => async (path5) => {
-  const service = await getServiceByPath(directory)(path5);
-  const relativePath = (0, import_node_path6.relative)(directory, path5);
+var isService = (directory) => async (path6) => {
+  const service = await getServiceByPath(directory)(path6);
+  const relativePath = (0, import_node_path7.relative)(directory, path6);
   const segments = relativePath.split(/[/\\]+/);
   return !!service && segments.includes("services");
 };
@@ -591,7 +604,7 @@ var toService = (directory) => async (file) => toResource(directory, file);
 var addEntityToService = (directory) => async (id, entity, version) => {
   let service = await getService(directory)(id, version);
   const servicePath = await getResourcePath(directory, id, version);
-  const extension = (0, import_node_path6.extname)(servicePath?.fullPath || "");
+  const extension = (0, import_node_path7.extname)(servicePath?.fullPath || "");
   if (service.entities === void 0) {
     service.entities = [];
   }
@@ -605,15 +618,15 @@ var addEntityToService = (directory) => async (id, entity, version) => {
   if (!existingResource) {
     throw new Error(`Cannot find service ${id} in the catalog`);
   }
-  const path5 = existingResource.split(/[\\/]+services/)[0];
-  const pathToResource = (0, import_node_path6.join)(path5, "services");
+  const path6 = existingResource.split(/[\\/]+services/)[0];
+  const pathToResource = (0, import_node_path7.join)(path6, "services");
   await rmServiceById(directory)(id, version);
   await writeService(pathToResource)(service, { format: extension === ".md" ? "md" : "mdx" });
 };
 var addDataStoreToService = (directory) => async (id, operation, dataStore, version) => {
   let service = await getService(directory)(id, version);
   const servicePath = await getResourcePath(directory, id, version);
-  const extension = (0, import_node_path6.extname)(servicePath?.fullPath || "");
+  const extension = (0, import_node_path7.extname)(servicePath?.fullPath || "");
   if (operation === "writesTo") {
     if (service.writesTo === void 0) {
       service.writesTo = [];
@@ -641,15 +654,15 @@ var addDataStoreToService = (directory) => async (id, operation, dataStore, vers
   if (!existingResource) {
     throw new Error(`Cannot find service ${id} in the catalog`);
   }
-  const path5 = existingResource.split(/[\\/]+services/)[0];
-  const pathToResource = (0, import_node_path6.join)(path5, "services");
+  const path6 = existingResource.split(/[\\/]+services/)[0];
+  const pathToResource = (0, import_node_path7.join)(path6, "services");
   await rmServiceById(directory)(id, version);
   await writeService(pathToResource)(service, { format: extension === ".md" ? "md" : "mdx" });
 };
 
 // src/domains.ts
 var import_promises6 = __toESM(require("fs/promises"));
-var import_node_path7 = __toESM(require("path"));
+var import_node_path8 = __toESM(require("path"));
 var import_node_fs3 = __toESM(require("fs"));
 var import_gray_matter3 = __toESM(require("gray-matter"));
 var getDomain = (directory) => async (id, version) => getResource(directory, id, version, { type: "domain" });
@@ -674,8 +687,8 @@ var writeDomain = (directory) => async (domain, options = {
   return await writeResource(directory, resource, { ...options, type: "domain" });
 };
 var versionDomain = (directory) => async (id) => versionResource(directory, id);
-var rmDomain = (directory) => async (path5) => {
-  await import_promises6.default.rm((0, import_node_path7.join)(directory, path5), { recursive: true });
+var rmDomain = (directory) => async (path6) => {
+  await import_promises6.default.rm((0, import_node_path8.join)(directory, path6), { recursive: true });
 };
 var rmDomainById = (directory) => async (id, version, persistFiles) => rmResourceById(directory, id, version, { type: "domain", persistFiles });
 var addFileToDomain = (directory) => async (id, file, version) => addFileToResource(directory, id, file, version);
@@ -687,7 +700,7 @@ var addUbiquitousLanguageToDomain = (directory) => async (id, ubiquitousLanguage
 };
 var getUbiquitousLanguageFromDomain = (directory) => async (id, version) => {
   const pathToDomain = await findFileById(directory, id, version) || "";
-  const pathToUbiquitousLanguage = import_node_path7.default.join(import_node_path7.default.dirname(pathToDomain), "ubiquitous-language.mdx");
+  const pathToUbiquitousLanguage = import_node_path8.default.join(import_node_path8.default.dirname(pathToDomain), "ubiquitous-language.mdx");
   const fileExists = import_node_fs3.default.existsSync(pathToUbiquitousLanguage);
   if (!fileExists) {
     return void 0;
@@ -702,7 +715,7 @@ var domainHasVersion = (directory) => async (id, version) => {
 var addServiceToDomain = (directory) => async (id, service, version) => {
   let domain = await getDomain(directory)(id, version);
   const domainPath = await getResourcePath(directory, id, version);
-  const extension = import_node_path7.default.extname(domainPath?.fullPath || "");
+  const extension = import_node_path8.default.extname(domainPath?.fullPath || "");
   if (domain.services === void 0) {
     domain.services = [];
   }
@@ -717,7 +730,7 @@ var addServiceToDomain = (directory) => async (id, service, version) => {
 var addSubDomainToDomain = (directory) => async (id, subDomain, version) => {
   let domain = await getDomain(directory)(id, version);
   const domainPath = await getResourcePath(directory, id, version);
-  const extension = import_node_path7.default.extname(domainPath?.fullPath || "");
+  const extension = import_node_path8.default.extname(domainPath?.fullPath || "");
   if (domain.domains === void 0) {
     domain.domains = [];
   }
@@ -732,7 +745,7 @@ var addSubDomainToDomain = (directory) => async (id, subDomain, version) => {
 var addEntityToDomain = (directory) => async (id, entity, version) => {
   let domain = await getDomain(directory)(id, version);
   const domainPath = await getResourcePath(directory, id, version);
-  const extension = import_node_path7.default.extname(domainPath?.fullPath || "");
+  const extension = import_node_path8.default.extname(domainPath?.fullPath || "");
   if (domain.entities === void 0) {
     domain.entities = [];
   }
@@ -747,12 +760,12 @@ var addEntityToDomain = (directory) => async (id, entity, version) => {
 
 // src/channels.ts
 var import_promises7 = __toESM(require("fs/promises"));
-var import_node_path8 = require("path");
+var import_node_path9 = require("path");
 var getChannel = (directory) => async (id, version) => getResource(directory, id, version, { type: "channel" });
 var getChannels = (directory) => async (options) => getResources(directory, { type: "channels", ...options });
 var writeChannel = (directory) => async (channel, options = { path: "" }) => writeResource(directory, { ...channel }, { ...options, type: "channel" });
-var rmChannel = (directory) => async (path5) => {
-  await import_promises7.default.rm((0, import_node_path8.join)(directory, path5), { recursive: true });
+var rmChannel = (directory) => async (path6) => {
+  await import_promises7.default.rm((0, import_node_path9.join)(directory, path6), { recursive: true });
 };
 var rmChannelById = (directory) => async (id, version, persistFiles) => rmResourceById(directory, id, version, { type: "channel", persistFiles });
 var versionChannel = (directory) => async (id) => versionResource(directory, id);
@@ -782,7 +795,7 @@ var addMessageToChannel = (directory, collection) => async (id, _message, versio
   const { getMessage, rmMessageById, writeMessage } = functions[collection];
   const message = await getMessage(directory)(_message.id, _message.version);
   const messagePath = await getResourcePath(directory, _message.id, _message.version);
-  const extension = (0, import_node_path8.extname)(messagePath?.fullPath || "");
+  const extension = (0, import_node_path9.extname)(messagePath?.fullPath || "");
   if (!message) throw new Error(`Message ${_message.id} with version ${_message.version} not found`);
   if (message.channels === void 0) {
     message.channels = [];
@@ -793,18 +806,18 @@ var addMessageToChannel = (directory, collection) => async (id, _message, versio
   if (!existingResource) {
     throw new Error(`Cannot find message ${id} in the catalog`);
   }
-  const path5 = existingResource.split(`/[\\/]+${collection}`)[0];
-  const pathToResource = (0, import_node_path8.join)(path5, collection);
+  const path6 = existingResource.split(`/[\\/]+${collection}`)[0];
+  const pathToResource = (0, import_node_path9.join)(path6, collection);
   await rmMessageById(directory)(_message.id, _message.version, true);
   await writeMessage(pathToResource)(message, { format: extension === ".md" ? "md" : "mdx" });
 };
 
 // src/messages.ts
-var import_node_path9 = require("path");
+var import_node_path10 = require("path");
 var import_gray_matter4 = __toESM(require("gray-matter"));
 var import_semver3 = require("semver");
-var getMessageBySchemaPath = (directory) => async (path5, options) => {
-  const pathToMessage = (0, import_node_path9.dirname)(path5);
+var getMessageBySchemaPath = (directory) => async (path6, options) => {
+  const pathToMessage = (0, import_node_path10.dirname)(path6);
   try {
     const files = await getFiles(`${directory}/${pathToMessage}/index.{md,mdx}`);
     if (!files || files.length === 0) {
@@ -876,18 +889,18 @@ var getProducersAndConsumersForMessage = (directory) => async (id, version, opti
   }
   return { producers, consumers };
 };
-var getConsumersOfSchema = (directory) => async (path5) => {
+var getConsumersOfSchema = (directory) => async (path6) => {
   try {
-    const message = await getMessageBySchemaPath(directory)(path5);
+    const message = await getMessageBySchemaPath(directory)(path6);
     const { consumers } = await getProducersAndConsumersForMessage(directory)(message.id, message.version);
     return consumers;
   } catch (error) {
     return [];
   }
 };
-var getProducersOfSchema = (directory) => async (path5) => {
+var getProducersOfSchema = (directory) => async (path6) => {
   try {
-    const message = await getMessageBySchemaPath(directory)(path5);
+    const message = await getMessageBySchemaPath(directory)(path6);
     const { producers } = await getProducersAndConsumersForMessage(directory)(message.id, message.version);
     return producers;
   } catch (error) {
@@ -896,13 +909,13 @@ var getProducersOfSchema = (directory) => async (path5) => {
 };
 
 // src/custom-docs.ts
-var import_node_path10 = __toESM(require("path"));
+var import_node_path11 = __toESM(require("path"));
 var import_node_fs4 = __toESM(require("fs"));
 var import_promises8 = __toESM(require("fs/promises"));
 var import_gray_matter5 = __toESM(require("gray-matter"));
 var import_slugify = __toESM(require("slugify"));
 var getCustomDoc = (directory) => async (filePath) => {
-  const fullPath = import_node_path10.default.join(directory, filePath);
+  const fullPath = import_node_path11.default.join(directory, filePath);
   const fullPathWithExtension = fullPath.endsWith(".mdx") ? fullPath : `${fullPath}.mdx`;
   const fileExists = import_node_fs4.default.existsSync(fullPathWithExtension);
   if (!fileExists) {
@@ -921,26 +934,26 @@ var writeCustomDoc = (directory) => async (customDoc, options = { path: "" }) =>
   const { fileName, ...rest } = customDoc;
   const name = fileName || (0, import_slugify.default)(customDoc.title, { lower: true });
   const withExtension = name.endsWith(".mdx") ? name : `${name}.mdx`;
-  const fullPath = import_node_path10.default.join(directory, options.path || "", withExtension);
-  import_node_fs4.default.mkdirSync(import_node_path10.default.dirname(fullPath), { recursive: true });
+  const fullPath = import_node_path11.default.join(directory, options.path || "", withExtension);
+  import_node_fs4.default.mkdirSync(import_node_path11.default.dirname(fullPath), { recursive: true });
   const document = import_gray_matter5.default.stringify(customDoc.markdown.trim(), rest);
   import_node_fs4.default.writeFileSync(fullPath, document);
 };
 var rmCustomDoc = (directory) => async (filePath) => {
   const withExtension = filePath.endsWith(".mdx") ? filePath : `${filePath}.mdx`;
-  await import_promises8.default.rm((0, import_node_path10.join)(directory, withExtension), { recursive: true });
+  await import_promises8.default.rm((0, import_node_path11.join)(directory, withExtension), { recursive: true });
 };
 
 // src/teams.ts
 var import_promises9 = __toESM(require("fs/promises"));
 var import_node_fs6 = __toESM(require("fs"));
-var import_node_path12 = require("path");
+var import_node_path13 = require("path");
 var import_gray_matter7 = __toESM(require("gray-matter"));
-var import_node_path13 = __toESM(require("path"));
+var import_node_path14 = __toESM(require("path"));
 
 // src/users.ts
 var import_node_fs5 = __toESM(require("fs"));
-var import_node_path11 = require("path");
+var import_node_path12 = require("path");
 var import_gray_matter6 = __toESM(require("gray-matter"));
 var getUser = (catalogDir) => async (id) => {
   const files = await getFiles(`${catalogDir}/${id}.{md,mdx}`);
@@ -978,11 +991,11 @@ var writeUser = (catalogDir) => async (user, options = {}) => {
   }
   const { markdown, ...frontmatter } = resource;
   const document = import_gray_matter6.default.stringify(markdown, frontmatter);
-  import_node_fs5.default.mkdirSync((0, import_node_path11.join)(catalogDir, ""), { recursive: true });
-  import_node_fs5.default.writeFileSync((0, import_node_path11.join)(catalogDir, "", `${resource.id}.mdx`), document);
+  import_node_fs5.default.mkdirSync((0, import_node_path12.join)(catalogDir, ""), { recursive: true });
+  import_node_fs5.default.writeFileSync((0, import_node_path12.join)(catalogDir, "", `${resource.id}.mdx`), document);
 };
 var rmUserById = (catalogDir) => async (id) => {
-  import_node_fs5.default.rmSync((0, import_node_path11.join)(catalogDir, `${id}.mdx`), { recursive: true });
+  import_node_fs5.default.rmSync((0, import_node_path12.join)(catalogDir, `${id}.mdx`), { recursive: true });
 };
 
 // src/teams.ts
@@ -1020,11 +1033,11 @@ var writeTeam = (catalogDir) => async (team, options = {}) => {
   }
   const { markdown, ...frontmatter } = resource;
   const document = import_gray_matter7.default.stringify(markdown, frontmatter);
-  import_node_fs6.default.mkdirSync((0, import_node_path12.join)(catalogDir, ""), { recursive: true });
-  import_node_fs6.default.writeFileSync((0, import_node_path12.join)(catalogDir, "", `${resource.id}.mdx`), document);
+  import_node_fs6.default.mkdirSync((0, import_node_path13.join)(catalogDir, ""), { recursive: true });
+  import_node_fs6.default.writeFileSync((0, import_node_path13.join)(catalogDir, "", `${resource.id}.mdx`), document);
 };
 var rmTeamById = (catalogDir) => async (id) => {
-  await import_promises9.default.rm((0, import_node_path12.join)(catalogDir, `${id}.mdx`), { recursive: true });
+  await import_promises9.default.rm((0, import_node_path13.join)(catalogDir, `${id}.mdx`), { recursive: true });
 };
 var getOwnersForResource = (catalogDir) => async (id, version) => {
   const resource = await getResource(catalogDir, id, version);
@@ -1032,11 +1045,11 @@ var getOwnersForResource = (catalogDir) => async (id, version) => {
   if (!resource) return [];
   if (!resource.owners) return [];
   for (const owner of resource.owners) {
-    const team = await getTeam(import_node_path13.default.join(catalogDir, "teams"))(owner);
+    const team = await getTeam(import_node_path14.default.join(catalogDir, "teams"))(owner);
     if (team) {
       owners.push(team);
     } else {
-      const user = await getUser(import_node_path13.default.join(catalogDir, "users"))(owner);
+      const user = await getUser(import_node_path14.default.join(catalogDir, "users"))(owner);
       if (user) {
         owners.push(user);
       }
@@ -1047,7 +1060,7 @@ var getOwnersForResource = (catalogDir) => async (id, version) => {
 
 // src/entities.ts
 var import_promises10 = __toESM(require("fs/promises"));
-var import_node_path14 = require("path");
+var import_node_path15 = require("path");
 var getEntity = (directory) => async (id, version) => getResource(directory, id, version, { type: "entity" });
 var getEntities = (directory) => async (options) => getResources(directory, { type: "entities", latestOnly: options?.latestOnly });
 var writeEntity = (directory) => async (entity, options = {
@@ -1055,8 +1068,8 @@ var writeEntity = (directory) => async (entity, options = {
   override: false,
   format: "mdx"
 }) => writeResource(directory, { ...entity }, { ...options, type: "entity" });
-var rmEntity = (directory) => async (path5) => {
-  await import_promises10.default.rm((0, import_node_path14.join)(directory, path5), { recursive: true });
+var rmEntity = (directory) => async (path6) => {
+  await import_promises10.default.rm((0, import_node_path15.join)(directory, path6), { recursive: true });
 };
 var rmEntityById = (directory) => async (id, version, persistFiles) => {
   await rmResourceById(directory, id, version, { type: "entity", persistFiles });
@@ -1069,7 +1082,7 @@ var entityHasVersion = (directory) => async (id, version) => {
 
 // src/containers.ts
 var import_promises11 = __toESM(require("fs/promises"));
-var import_node_path15 = require("path");
+var import_node_path16 = require("path");
 var getContainer = (directory) => async (id, version) => getResource(directory, id, version, { type: "container" });
 var getContainers = (directory) => async (options) => getResources(directory, { type: "containers", latestOnly: options?.latestOnly });
 var writeContainer = (directory) => async (data, options = {
@@ -1078,8 +1091,8 @@ var writeContainer = (directory) => async (data, options = {
   format: "mdx"
 }) => writeResource(directory, { ...data }, { ...options, type: "container" });
 var versionContainer = (directory) => async (id) => versionResource(directory, id);
-var rmContainer = (directory) => async (path5) => {
-  await import_promises11.default.rm((0, import_node_path15.join)(directory, path5), { recursive: true });
+var rmContainer = (directory) => async (path6) => {
+  await import_promises11.default.rm((0, import_node_path16.join)(directory, path6), { recursive: true });
 };
 var rmContainerById = (directory) => async (id, version, persistFiles) => {
   await rmResourceById(directory, id, version, { type: "container", persistFiles });
@@ -1095,7 +1108,7 @@ var writeContainerToService = (directory) => async (container, service, options
     throw new Error("Service not found");
   }
   let pathForContainer = service.version && service.version !== "latest" ? `${resourcePath.directory}/versioned/${service.version}/containers` : `${resourcePath.directory}/containers`;
-  pathForContainer = (0, import_node_path15.join)(pathForContainer, container.id);
+  pathForContainer = (0, import_node_path16.join)(pathForContainer, container.id);
   await writeResource(directory, { ...container }, { ...options, path: pathForContainer, type: "container" });
 };
 
@@ -1111,7 +1124,7 @@ var addFileToDataStore = addFileToContainer;
 var writeDataStoreToService = writeContainerToService;
 
 // src/index.ts
-var index_default = (path5) => {
+var index_default = (path6) => {
   return {
     /**
      * Returns an events from EventCatalog
@@ -1119,13 +1132,13 @@ var index_default = (path5) => {
      * @param version - Optional id of the version to get (supports semver)
      * @returns Event|Undefined
      */
-    getEvent: getEvent((0, import_node_path16.join)(path5)),
+    getEvent: getEvent((0, import_node_path17.join)(path6)),
     /**
      * Returns all events from EventCatalog
      * @param latestOnly - optional boolean, set to true to get only latest versions
      * @returns Event[]|Undefined
      */
-    getEvents: getEvents((0, import_node_path16.join)(path5)),
+    getEvents: getEvents((0, import_node_path17.join)(path6)),
     /**
      * Adds an event to EventCatalog
      *
@@ -1133,7 +1146,7 @@ var index_default = (path5) => {
      * @param options - Optional options to write the event
      *
      */
-    writeEvent: writeEvent((0, import_node_path16.join)(path5, "events")),
+    writeEvent: writeEvent((0, import_node_path17.join)(path6, "events")),
     /**
      * Adds an event to a service in EventCatalog
      *
@@ -1142,26 +1155,26 @@ var index_default = (path5) => {
      * @param options - Optional options to write the event
      *
      */
-    writeEventToService: writeEventToService((0, import_node_path16.join)(path5)),
+    writeEventToService: writeEventToService((0, import_node_path17.join)(path6)),
     /**
      * 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((0, import_node_path16.join)(path5, "events")),
+    rmEvent: rmEvent((0, import_node_path17.join)(path6, "events")),
     /**
      * Remove an event by an Event id
      *
      * @param id - The id of the event you want to remove
      *
      */
-    rmEventById: rmEventById((0, import_node_path16.join)(path5)),
+    rmEventById: rmEventById((0, import_node_path17.join)(path6)),
     /**
      * Moves a given event id to the version directory
      * @param directory
      */
-    versionEvent: versionEvent((0, import_node_path16.join)(path5)),
+    versionEvent: versionEvent((0, import_node_path17.join)(path6)),
     /**
      * Adds a file to the given event
      * @param id - The id of the event to add the file to
@@ -1169,7 +1182,7 @@ var index_default = (path5) => {
      * @param version - Optional version of the event to add the file to
      * @returns
      */
-    addFileToEvent: addFileToEvent((0, import_node_path16.join)(path5)),
+    addFileToEvent: addFileToEvent((0, import_node_path17.join)(path6)),
     /**
      * Adds a schema to the given event
      * @param id - The id of the event to add the schema to
@@ -1177,14 +1190,14 @@ var index_default = (path5) => {
      * @param version - Optional version of the event to add the schema to
      * @returns
      */
-    addSchemaToEvent: addSchemaToEvent((0, import_node_path16.join)(path5)),
+    addSchemaToEvent: addSchemaToEvent((0, import_node_path17.join)(path6)),
     /**
      * 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((0, import_node_path16.join)(path5)),
+    eventHasVersion: eventHasVersion((0, import_node_path17.join)(path6)),
     /**
      * ================================
      *            Commands
@@ -1196,13 +1209,13 @@ var index_default = (path5) => {
      * @param version - Optional id of the version to get (supports semver)
      * @returns Command|Undefined
      */
-    getCommand: getCommand((0, import_node_path16.join)(path5)),
+    getCommand: getCommand((0, import_node_path17.join)(path6)),
     /**
      * Returns all commands from EventCatalog
      * @param latestOnly - optional boolean, set to true to get only latest versions
      * @returns Command[]|Undefined
      */
-    getCommands: getCommands((0, import_node_path16.join)(path5)),
+    getCommands: getCommands((0, import_node_path17.join)(path6)),
     /**
      * Adds an command to EventCatalog
      *
@@ -1210,7 +1223,7 @@ var index_default = (path5) => {
      * @param options - Optional options to write the command
      *
      */
-    writeCommand: writeCommand((0, import_node_path16.join)(path5, "commands")),
+    writeCommand: writeCommand((0, import_node_path17.join)(path6, "commands")),
     /**
      * Adds a command to a service in EventCatalog
      *
@@ -1219,26 +1232,26 @@ var index_default = (path5) => {
      * @param options - Optional options to write the command
      *
      */
-    writeCommandToService: writeCommandToService((0, import_node_path16.join)(path5)),
+    writeCommandToService: writeCommandToService((0, import_node_path17.join)(path6)),
     /**
      * 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((0, import_node_path16.join)(path5, "commands")),
+    rmCommand: rmCommand((0, import_node_path17.join)(path6, "commands")),
     /**
      * Remove an command by an Event id
      *
      * @param id - The id of the command you want to remove
      *
      */
-    rmCommandById: rmCommandById((0, import_node_path16.join)(path5)),
+    rmCommandById: rmCommandById((0, import_node_path17.join)(path6)),
     /**
      * Moves a given command id to the version directory
      * @param directory
      */
-    versionCommand: versionCommand((0, import_node_path16.join)(path5)),
+    versionCommand: versionCommand((0, import_node_path17.join)(path6)),
     /**
      * Adds a file to the given command
      * @param id - The id of the command to add the file to
@@ -1246,7 +1259,7 @@ var index_default = (path5) => {
      * @param version - Optional version of the command to add the file to
      * @returns
      */
-    addFileToCommand: addFileToCommand((0, import_node_path16.join)(path5)),
+    addFileToCommand: addFileToCommand((0, import_node_path17.join)(path6)),
     /**
      * Adds a schema to the given command
      * @param id - The id of the command to add the schema to
@@ -1254,14 +1267,14 @@ var index_default = (path5) => {
      * @param version - Optional version of the command to add the schema to
      * @returns
      */
-    addSchemaToCommand: addSchemaToCommand((0, import_node_path16.join)(path5)),
+    addSchemaToCommand: addSchemaToCommand((0, import_node_path17.join)(path6)),
     /**
      * 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((0, import_node_path16.join)(path5)),
+    commandHasVersion: commandHasVersion((0, import_node_path17.join)(path6)),
     /**
      * ================================
      *            Queries
@@ -1273,13 +1286,13 @@ var index_default = (path5) => {
      * @param version - Optional id of the version to get (supports semver)
      * @returns Query|Undefined
      */
-    getQuery: getQuery((0, import_node_path16.join)(path5)),
+    getQuery: getQuery((0, import_node_path17.join)(path6)),
     /**
      * Returns all queries from EventCatalog
      * @param latestOnly - optional boolean, set to true to get only latest versions
      * @returns Query[]|Undefined
      */
-    getQueries: getQueries((0, import_node_path16.join)(path5)),
+    getQueries: getQueries((0, import_node_path17.join)(path6)),
     /**
      * Adds a query to EventCatalog
      *
@@ -1287,7 +1300,7 @@ var index_default = (path5) => {
      * @param options - Optional options to write the event
      *
      */
-    writeQuery: writeQuery((0, import_node_path16.join)(path5, "queries")),
+    writeQuery: writeQuery((0, import_node_path17.join)(path6, "queries")),
     /**
      * Adds a query to a service in EventCatalog
      *
@@ -1296,26 +1309,26 @@ var index_default = (path5) => {
      * @param options - Optional options to write the query
      *
      */
-    writeQueryToService: writeQueryToService((0, import_node_path16.join)(path5)),
+    writeQueryToService: writeQueryToService((0, import_node_path17.join)(path6)),
     /**
      * 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((0, import_node_path16.join)(path5, "queries")),
+    rmQuery: rmQuery((0, import_node_path17.join)(path6, "queries")),
     /**
      * Remove a query by a Query id
      *
      * @param id - The id of the query you want to remove
      *
      */
-    rmQueryById: rmQueryById((0, import_node_path16.join)(path5)),
+    rmQueryById: rmQueryById((0, import_node_path17.join)(path6)),
     /**
      * Moves a given query id to the version directory
      * @param directory
      */
-    versionQuery: versionQuery((0, import_node_path16.join)(path5)),
+    versionQuery: versionQuery((0, import_node_path17.join)(path6)),
     /**
      * Adds a file to the given query
      * @param id - The id of the query to add the file to
@@ -1323,7 +1336,7 @@ var index_default = (path5) => {
      * @param version - Optional version of the query to add the file to
      * @returns
      */
-    addFileToQuery: addFileToQuery((0, import_node_path16.join)(path5)),
+    addFileToQuery: addFileToQuery((0, import_node_path17.join)(path6)),
     /**
      * Adds a schema to the given query
      * @param id - The id of the query to add the schema to
@@ -1331,14 +1344,14 @@ var index_default = (path5) => {
      * @param version - Optional version of the query to add the schema to
      * @returns
      */
-    addSchemaToQuery: addSchemaToQuery((0, import_node_path16.join)(path5)),
+    addSchemaToQuery: addSchemaToQuery((0, import_node_path17.join)(path6)),
     /**
      * 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((0, import_node_path16.join)(path5)),
+    queryHasVersion: queryHasVersion((0, import_node_path17.join)(path6)),
     /**
      * ================================
      *            Channels
@@ -1350,13 +1363,13 @@ var index_default = (path5) => {
      * @param version - Optional id of the version to get (supports semver)
      * @returns Channel|Undefined
      */
-    getChannel: getChannel((0, import_node_path16.join)(path5)),
+    getChannel: getChannel((0, import_node_path17.join)(path6)),
     /**
      * Returns all channels from EventCatalog
      * @param latestOnly - optional boolean, set to true to get only latest versions
      * @returns Channel[]|Undefined
      */
-    getChannels: getChannels((0, import_node_path16.join)(path5)),
+    getChannels: getChannels((0, import_node_path17.join)(path6)),
     /**
      * Adds an channel to EventCatalog
      *
@@ -1364,33 +1377,33 @@ var index_default = (path5) => {
      * @param options - Optional options to write the channel
      *
      */
-    writeChannel: writeChannel((0, import_node_path16.join)(path5, "channels")),
+    writeChannel: writeChannel((0, import_node_path17.join)(path6, "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((0, import_node_path16.join)(path5, "channels")),
+    rmChannel: rmChannel((0, import_node_path17.join)(path6, "channels")),
     /**
      * Remove an channel by an Event id
      *
      * @param id - The id of the channel you want to remove
      *
      */
-    rmChannelById: rmChannelById((0, import_node_path16.join)(path5)),
+    rmChannelById: rmChannelById((0, import_node_path17.join)(path6)),
     /**
      * Moves a given channel id to the version directory
      * @param directory
      */
-    versionChannel: versionChannel((0, import_node_path16.join)(path5)),
+    versionChannel: versionChannel((0, import_node_path17.join)(path6)),
     /**
      * 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((0, import_node_path16.join)(path5)),
+    channelHasVersion: channelHasVersion((0, import_node_path17.join)(path6)),
     /**
      * Add a channel to an event
      *
@@ -1407,7 +1420,7 @@ var index_default = (path5) => {
      *
      * ```
      */
-    addEventToChannel: addMessageToChannel((0, import_node_path16.join)(path5), "events"),
+    addEventToChannel: addMessageToChannel((0, import_node_path17.join)(path6), "events"),
     /**
      * Add a channel to an command
      *
@@ -1424,7 +1437,7 @@ var index_default = (path5) => {
      *
      * ```
      */
-    addCommandToChannel: addMessageToChannel((0, import_node_path16.join)(path5), "commands"),
+    addCommandToChannel: addMessageToChannel((0, import_node_path17.join)(path6), "commands"),
     /**
      * Add a channel to an query
      *
@@ -1441,7 +1454,7 @@ var index_default = (path5) => {
      *
      * ```
      */
-    addQueryToChannel: addMessageToChannel((0, import_node_path16.join)(path5), "queries"),
+    addQueryToChannel: addMessageToChannel((0, import_node_path17.join)(path6), "queries"),
     /**
      * ================================
      *            SERVICES
@@ -1454,14 +1467,14 @@ var index_default = (path5) => {
      * @param options - Optional options to write the event
      *
      */
-    writeService: writeService((0, import_node_path16.join)(path5, "services")),
+    writeService: writeService((0, import_node_path17.join)(path6, "services")),
     /**
      * Adds a versioned service to EventCatalog
      *
      * @param service - The service to write
      *
      */
-    writeVersionedService: writeVersionedService((0, import_node_path16.join)(path5, "services")),
+    writeVersionedService: writeVersionedService((0, import_node_path17.join)(path6, "services")),
     /**
      * Adds a service to a domain in EventCatalog
      *
@@ -1470,45 +1483,45 @@ var index_default = (path5) => {
      * @param options - Optional options to write the event
      *
      */
-    writeServiceToDomain: writeServiceToDomain((0, import_node_path16.join)(path5, "domains")),
+    writeServiceToDomain: writeServiceToDomain((0, import_node_path17.join)(path6, "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((0, import_node_path16.join)(path5)),
+    getService: getService((0, import_node_path17.join)(path6)),
     /**
      * Returns a service from EventCatalog by it's path.
      * @param path - The path to the service to retrieve
      * @returns Service|Undefined
      */
-    getServiceByPath: getServiceByPath((0, import_node_path16.join)(path5)),
+    getServiceByPath: getServiceByPath((0, import_node_path17.join)(path6)),
     /**
      * Returns all services from EventCatalog
      * @param latestOnly - optional boolean, set to true to get only latest versions
      * @returns Service[]|Undefined
      */
-    getServices: getServices((0, import_node_path16.join)(path5)),
+    getServices: getServices((0, import_node_path17.join)(path6)),
     /**
      * Moves a given service id to the version directory
      * @param directory
      */
-    versionService: versionService((0, import_node_path16.join)(path5)),
+    versionService: versionService((0, import_node_path17.join)(path6)),
     /**
      * Remove a service from EventCatalog (modeled on the standard POSIX rm utility)
      *
      * @param path - The path to your service, e.g. `/InventoryService`
      *
      */
-    rmService: rmService((0, import_node_path16.join)(path5, "services")),
+    rmService: rmService((0, import_node_path17.join)(path6, "services")),
     /**
      * Remove an service by an service id
      *
      * @param id - The id of the service you want to remove
      *
      */
-    rmServiceById: rmServiceById((0, import_node_path16.join)(path5)),
+    rmServiceById: rmServiceById((0, import_node_path17.join)(path6)),
     /**
      * Adds a file to the given service
      * @param id - The id of the service to add the file to
@@ -1516,21 +1529,21 @@ var index_default = (path5) => {
      * @param version - Optional version of the service to add the file to
      * @returns
      */
-    addFileToService: addFileToService((0, import_node_path16.join)(path5)),
+    addFileToService: addFileToService((0, import_node_path17.join)(path6)),
     /**
      * 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((0, import_node_path16.join)(path5)),
+    getSpecificationFilesForService: getSpecificationFilesForService((0, import_node_path17.join)(path6)),
     /**
      * 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((0, import_node_path16.join)(path5)),
+    serviceHasVersion: serviceHasVersion((0, import_node_path17.join)(path6)),
     /**
      * Add an event to a service by it's id.
      *
@@ -1550,7 +1563,7 @@ var index_default = (path5) => {
      *
      * ```
      */
-    addEventToService: addMessageToService((0, import_node_path16.join)(path5)),
+    addEventToService: addMessageToService((0, import_node_path17.join)(path6)),
     /**
      * Add a data store to a service by it's id.
      *
@@ -1567,7 +1580,7 @@ var index_default = (path5) => {
      *
      * ```
      */
-    addDataStoreToService: addDataStoreToService((0, import_node_path16.join)(path5)),
+    addDataStoreToService: addDataStoreToService((0, import_node_path17.join)(path6)),
     /**
      * Add a command to a service by it's id.
      *
@@ -1587,7 +1600,7 @@ var index_default = (path5) => {
      *
      * ```
      */
-    addCommandToService: addMessageToService((0, import_node_path16.join)(path5)),
+    addCommandToService: addMessageToService((0, import_node_path17.join)(path6)),
     /**
      * Add a query to a service by it's id.
      *
@@ -1607,7 +1620,7 @@ var index_default = (path5) => {
      *
      * ```
      */
-    addQueryToService: addMessageToService((0, import_node_path16.join)(path5)),
+    addQueryToService: addMessageToService((0, import_node_path17.join)(path6)),
     /**
      * Add an entity to a service by its id.
      *
@@ -1625,7 +1638,7 @@ var index_default = (path5) => {
      *
      * ```
      */
-    addEntityToService: addEntityToService((0, import_node_path16.join)(path5)),
+    addEntityToService: addEntityToService((0, import_node_path17.join)(path6)),
     /**
      * Check to see if a service exists by it's path.
      *
@@ -1642,13 +1655,13 @@ var index_default = (path5) => {
      * @param path - The path to the service to check
      * @returns boolean
      */
-    isService: isService((0, import_node_path16.join)(path5)),
+    isService: isService((0, import_node_path17.join)(path6)),
     /**
      * Converts a file to a service.
      * @param file - The file to convert to a service.
      * @returns The service.
      */
-    toService: toService((0, import_node_path16.join)(path5)),
+    toService: toService((0, import_node_path17.join)(path6)),
     /**
      * ================================
      *            Domains
@@ -1661,39 +1674,39 @@ var index_default = (path5) => {
      * @param options - Optional options to write the event
      *
      */
-    writeDomain: writeDomain((0, import_node_path16.join)(path5, "domains")),
+    writeDomain: writeDomain((0, import_node_path17.join)(path6, "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((0, import_node_path16.join)(path5, "domains")),
+    getDomain: getDomain((0, import_node_path17.join)(path6, "domains")),
     /**
      * Returns all domains from EventCatalog
      * @param latestOnly - optional boolean, set to true to get only latest versions
      * @returns Domain[]|Undefined
      */
-    getDomains: getDomains((0, import_node_path16.join)(path5)),
+    getDomains: getDomains((0, import_node_path17.join)(path6)),
     /**
      * Moves a given domain id to the version directory
      * @param directory
      */
-    versionDomain: versionDomain((0, import_node_path16.join)(path5, "domains")),
+    versionDomain: versionDomain((0, import_node_path17.join)(path6, "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((0, import_node_path16.join)(path5, "domains")),
+    rmDomain: rmDomain((0, import_node_path17.join)(path6, "domains")),
     /**
      * Remove an service by an domain id
      *
      * @param id - The id of the domain you want to remove
      *
      */
-    rmDomainById: rmDomainById((0, import_node_path16.join)(path5, "domains")),
+    rmDomainById: rmDomainById((0, import_node_path17.join)(path6, "domains")),
     /**
      * Adds a file to the given domain
      * @param id - The id of the domain to add the file to
@@ -1701,28 +1714,28 @@ var index_default = (path5) => {
      * @param version - Optional version of the domain to add the file to
      * @returns
      */
-    addFileToDomain: addFileToDomain((0, import_node_path16.join)(path5, "domains")),
+    addFileToDomain: addFileToDomain((0, import_node_path17.join)(path6, "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((0, import_node_path16.join)(path5, "domains")),
+    addUbiquitousLanguageToDomain: addUbiquitousLanguageToDomain((0, import_node_path17.join)(path6, "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((0, import_node_path16.join)(path5, "domains")),
+    getUbiquitousLanguageFromDomain: getUbiquitousLanguageFromDomain((0, import_node_path17.join)(path6, "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((0, import_node_path16.join)(path5)),
+    domainHasVersion: domainHasVersion((0, import_node_path17.join)(path6)),
     /**
      * Adds a given service to a domain
      * @param id - The id of the domain
@@ -1730,7 +1743,7 @@ var index_default = (path5) => {
      * @param version - (Optional) The version of the domain to add the service to
      * @returns
      */
-    addServiceToDomain: addServiceToDomain((0, import_node_path16.join)(path5, "domains")),
+    addServiceToDomain: addServiceToDomain((0, import_node_path17.join)(path6, "domains")),
     /**
      * Adds a given subdomain to a domain
      * @param id - The id of the domain
@@ -1738,7 +1751,7 @@ var index_default = (path5) => {
      * @param version - (Optional) The version of the domain to add the subdomain to
      * @returns
      */
-    addSubDomainToDomain: addSubDomainToDomain((0, import_node_path16.join)(path5, "domains")),
+    addSubDomainToDomain: addSubDomainToDomain((0, import_node_path17.join)(path6, "domains")),
     /**
      * Adds an entity to a domain
      * @param id - The id of the domain
@@ -1746,7 +1759,7 @@ var index_default = (path5) => {
      * @param version - (Optional) The version of the domain to add the entity to
      * @returns
      */
-    addEntityToDomain: addEntityToDomain((0, import_node_path16.join)(path5, "domains")),
+    addEntityToDomain: addEntityToDomain((0, import_node_path17.join)(path6, "domains")),
     /**
      * ================================
      *            Teams
@@ -1759,25 +1772,25 @@ var index_default = (path5) => {
      * @param options - Optional options to write the team
      *
      */
-    writeTeam: writeTeam((0, import_node_path16.join)(path5, "teams")),
+    writeTeam: writeTeam((0, import_node_path17.join)(path6, "teams")),
     /**
      * Returns a team from EventCatalog
      * @param id - The id of the team to retrieve
      * @returns Team|Undefined
      */
-    getTeam: getTeam((0, import_node_path16.join)(path5, "teams")),
+    getTeam: getTeam((0, import_node_path17.join)(path6, "teams")),
     /**
      * Returns all teams from EventCatalog
      * @returns Team[]|Undefined
      */
-    getTeams: getTeams((0, import_node_path16.join)(path5, "teams")),
+    getTeams: getTeams((0, import_node_path17.join)(path6, "teams")),
     /**
      * Remove a team by the team id
      *
      * @param id - The id of the team you want to remove
      *
      */
-    rmTeamById: rmTeamById((0, import_node_path16.join)(path5, "teams")),
+    rmTeamById: rmTeamById((0, import_node_path17.join)(path6, "teams")),
     /**
      * ================================
      *            Users
@@ -1790,25 +1803,25 @@ var index_default = (path5) => {
      * @param options - Optional options to write the user
      *
      */
-    writeUser: writeUser((0, import_node_path16.join)(path5, "users")),
+    writeUser: writeUser((0, import_node_path17.join)(path6, "users")),
     /**
      * Returns a user from EventCatalog
      * @param id - The id of the user to retrieve
      * @returns User|Undefined
      */
-    getUser: getUser((0, import_node_path16.join)(path5, "users")),
+    getUser: getUser((0, import_node_path17.join)(path6, "users")),
     /**
      * Returns all user from EventCatalog
      * @returns User[]|Undefined
      */
-    getUsers: getUsers((0, import_node_path16.join)(path5)),
+    getUsers: getUsers((0, import_node_path17.join)(path6)),
     /**
      * Remove a user by the user id
      *
      * @param id - The id of the user you want to remove
      *
      */
-    rmUserById: rmUserById((0, import_node_path16.join)(path5, "users")),
+    rmUserById: rmUserById((0, import_node_path17.join)(path6, "users")),
     /**
      * ================================
      *            Custom Docs
@@ -1819,32 +1832,32 @@ var index_default = (path5) => {
      * @param path - The path to the custom doc to retrieve
      * @returns CustomDoc|Undefined
      */
-    getCustomDoc: getCustomDoc((0, import_node_path16.join)(path5, "docs")),
+    getCustomDoc: getCustomDoc((0, import_node_path17.join)(path6, "docs")),
     /**
      * Returns all custom docs from EventCatalog
      * @param options - Optional options to get custom docs from a specific path
      * @returns CustomDoc[]|Undefined
      */
-    getCustomDocs: getCustomDocs((0, import_node_path16.join)(path5, "docs")),
+    getCustomDocs: getCustomDocs((0, import_node_path17.join)(path6, "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((0, import_node_path16.join)(path5, "docs")),
+    writeCustomDoc: writeCustomDoc((0, import_node_path17.join)(path6, "docs")),
     /**
      * Removes a custom doc from EventCatalog
      * @param path - The path to the custom doc to remove
      *
      */
-    rmCustomDoc: rmCustomDoc((0, import_node_path16.join)(path5, "docs")),
+    rmCustomDoc: rmCustomDoc((0, import_node_path17.join)(path6, "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((0, import_node_path16.join)(path5)),
+    dumpCatalog: dumpCatalog((0, import_node_path17.join)(path6)),
     /**
      * Returns the event catalog configuration file.
      * The event catalog configuration file is the file that contains the configuration for the event catalog.
@@ -1852,7 +1865,7 @@ var index_default = (path5) => {
      * @param directory - The directory of the catalog.
      * @returns A JSON object with the configuration for the event catalog.
      */
-    getEventCatalogConfigurationFile: getEventCatalogConfigurationFile((0, import_node_path16.join)(path5)),
+    getEventCatalogConfigurationFile: getEventCatalogConfigurationFile((0, import_node_path17.join)(path6)),
     /**
      * ================================
      *            Resources Utils
@@ -1862,6 +1875,10 @@ var index_default = (path5) => {
      * Returns the path to a given resource by id and version
      */
     getResourcePath,
+    /**
+     * Returns the folder name of a given resource
+     */
+    getResourceFolderName,
     /**
      * ================================
      *            General Message Utils
@@ -1873,33 +1890,33 @@ var index_default = (path5) => {
      * @param path - The path to the message to retrieve
      * @returns Message|Undefined
      */
-    getMessageBySchemaPath: getMessageBySchemaPath((0, import_node_path16.join)(path5)),
+    getMessageBySchemaPath: getMessageBySchemaPath((0, import_node_path17.join)(path6)),
     /**
      * 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((0, import_node_path16.join)(path5)),
+    getProducersAndConsumersForMessage: getProducersAndConsumersForMessage((0, import_node_path17.join)(path6)),
     /**
      * Returns the consumers of a given schema path
      * @param path - The path to the schema to get the consumers for
      * @returns Service[]
      */
-    getConsumersOfSchema: getConsumersOfSchema((0, import_node_path16.join)(path5)),
+    getConsumersOfSchema: getConsumersOfSchema((0, import_node_path17.join)(path6)),
     /**
      * Returns the producers of a given schema path
      * @param path - The path to the schema to get the producers for
      * @returns Service[]
      */
-    getProducersOfSchema: getProducersOfSchema((0, import_node_path16.join)(path5)),
+    getProducersOfSchema: getProducersOfSchema((0, import_node_path17.join)(path6)),
     /**
      * Returns the owners for a given resource (e.g domain, service, event, command, query, etc.)
      * @param id - The id of the resource to get the owners for
      * @param version - Optional version of the resource
      * @returns { owners: User[] }
      */
-    getOwnersForResource: getOwnersForResource((0, import_node_path16.join)(path5)),
+    getOwnersForResource: getOwnersForResource((0, import_node_path17.join)(path6)),
     /**
      * ================================
      *            Entities
@@ -1911,13 +1928,13 @@ var index_default = (path5) => {
      * @param version - Optional id of the version to get (supports semver)
      * @returns Entity|Undefined
      */
-    getEntity: getEntity((0, import_node_path16.join)(path5)),
+    getEntity: getEntity((0, import_node_path17.join)(path6)),
     /**
      * Returns all entities from EventCatalog
      * @param latestOnly - optional boolean, set to true to get only latest versions
      * @returns Entity[]|Undefined
      */
-    getEntities: getEntities((0, import_node_path16.join)(path5)),
+    getEntities: getEntities((0, import_node_path17.join)(path6)),
     /**
      * Adds an entity to EventCatalog
      *
@@ -1925,33 +1942,33 @@ var index_default = (path5) => {
      * @param options - Optional options to write the entity
      *
      */
-    writeEntity: writeEntity((0, import_node_path16.join)(path5, "entities")),
+    writeEntity: writeEntity((0, import_node_path17.join)(path6, "entities")),
     /**
      * Remove an entity from EventCatalog (modeled on the standard POSIX rm utility)
      *
      * @param path - The path to your entity, e.g. `/User`
      *
      */
-    rmEntity: rmEntity((0, import_node_path16.join)(path5, "entities")),
+    rmEntity: rmEntity((0, import_node_path17.join)(path6, "entities")),
     /**
      * Remove an entity by an entity id
      *
      * @param id - The id of the entity you want to remove
      *
      */
-    rmEntityById: rmEntityById((0, import_node_path16.join)(path5)),
+    rmEntityById: rmEntityById((0, import_node_path17.join)(path6)),
     /**
      * Moves a given entity id to the version directory
      * @param id - The id of the entity to version
      */
-    versionEntity: versionEntity((0, import_node_path16.join)(path5)),
+    versionEntity: versionEntity((0, import_node_path17.join)(path6)),
     /**
      * Check to see if an entity version exists
      * @param id - The id of the entity
      * @param version - The version of the entity (supports semver)
      * @returns
      */
-    entityHasVersion: entityHasVersion((0, import_node_path16.join)(path5)),
+    entityHasVersion: entityHasVersion((0, import_node_path17.join)(path6)),
     /**
      * ================================
      *            Data Stores
@@ -1963,42 +1980,42 @@ var index_default = (path5) => {
      * @param options - Optional options to write the data store
      *
      */
-    writeDataStore: writeDataStore((0, import_node_path16.join)(path5, "containers")),
+    writeDataStore: writeDataStore((0, import_node_path17.join)(path6, "containers")),
     /**
      * Returns a data store from EventCatalog
      * @param id - The id of the data store to retrieve
      * @param version - Optional id of the version to get (supports semver)
      * @returns Container|Undefined
      */
-    getDataStore: getDataStore((0, import_node_path16.join)(path5)),
+    getDataStore: getDataStore((0, import_node_path17.join)(path6)),
     /**
      * Returns all data stores from EventCatalog
      * @param latestOnly - optional boolean, set to true to get only latest versions
      * @returns Container[]|Undefined
      */
-    getDataStores: getDataStores((0, import_node_path16.join)(path5)),
+    getDataStores: getDataStores((0, import_node_path17.join)(path6)),
     /**
      * Version a data store by its id
      * @param id - The id of the data store to version
      */
-    versionDataStore: versionDataStore((0, import_node_path16.join)(path5, "containers")),
+    versionDataStore: versionDataStore((0, import_node_path17.join)(path6, "containers")),
     /**
      * Remove a data store by its path
      * @param path - The path to the data store to remove
      */
-    rmDataStore: rmDataStore((0, import_node_path16.join)(path5, "containers")),
+    rmDataStore: rmDataStore((0, import_node_path17.join)(path6, "containers")),
     /**
      * Remove a data store by its id
      * @param id - The id of the data store to remove
      */
-    rmDataStoreById: rmDataStoreById((0, import_node_path16.join)(path5)),
+    rmDataStoreById: rmDataStoreById((0, import_node_path17.join)(path6)),
     /**
      * Check to see if a data store version exists
      * @param id - The id of the data store
      * @param version - The version of the data store (supports semver)
      * @returns
      */
-    dataStoreHasVersion: dataStoreHasVersion((0, import_node_path16.join)(path5)),
+    dataStoreHasVersion: dataStoreHasVersion((0, import_node_path17.join)(path6)),
     /**
      * Adds a file to a data store by its id
      * @param id - The id of the data store to add the file to
@@ -2006,14 +2023,14 @@ var index_default = (path5) => {
      * @param version - Optional version of the data store to add the file to
      * @returns
      */
-    addFileToDataStore: addFileToDataStore((0, import_node_path16.join)(path5)),
+    addFileToDataStore: addFileToDataStore((0, import_node_path17.join)(path6)),
     /**
      * Writes a data store to a service by its id
      * @param dataStore - The data store to write
      * @param service - The service to write the data store to
      * @returns
      */
-    writeDataStoreToService: writeDataStoreToService((0, import_node_path16.join)(path5))
+    writeDataStoreToService: writeDataStoreToService((0, import_node_path17.join)(path6))
   };
 };
 
@@ -2021,7 +2038,7 @@ var index_default = (path5) => {
 var DUMP_VERSION = "0.0.1";
 var getEventCatalogVersion = async (catalogDir) => {
   try {
-    const packageJson = import_fs.default.readFileSync((0, import_node_path17.join)(catalogDir, "package.json"), "utf8");
+    const packageJson = import_fs.default.readFileSync((0, import_node_path18.join)(catalogDir, "package.json"), "utf8");
     const packageJsonObject = JSON.parse(packageJson);
     return packageJsonObject["dependencies"]["@eventcatalog/core"];
   } catch (error) {
@@ -2034,7 +2051,7 @@ var hydrateResource = async (catalogDir, resources = [], { attachSchema = false
       const resourcePath = await getResourcePath(catalogDir, resource.id, resource.version);
       let schema = "";
       if (resource.schemaPath && resourcePath?.fullPath) {
-        const pathToSchema = import_node_path17.default.join(import_node_path17.default.dirname(resourcePath?.fullPath), resource.schemaPath);
+        const pathToSchema = import_node_path18.default.join(import_node_path18.default.dirname(resourcePath?.fullPath), resource.schemaPath);
         if (import_fs.default.existsSync(pathToSchema)) {
           schema = import_fs.default.readFileSync(pathToSchema, "utf8");
         }
@@ -2055,8 +2072,8 @@ var filterCollection = (collection, options) => {
 };
 var getEventCatalogConfigurationFile = (directory) => async () => {
   try {
-    const path5 = (0, import_node_path17.join)(directory, "eventcatalog.config.js");
-    const configModule = await import(path5);
+    const path6 = (0, import_node_path18.join)(directory, "eventcatalog.config.js");
+    const configModule = await import(path6);
     return configModule.default;
   } catch (error) {
     console.error("Error getting event catalog configuration file", error);