@eventcatalog/sdk 2.2.1 → 2.2.3

package/dist/eventcatalog.mjs

@@ -0,0 +1,1414 @@
+// src/eventcatalog.ts
+import fs10 from "fs";
+import path3, { join as join13 } from "node:path";
+
+// src/index.ts
+import { join as join12 } from "node:path";
+
+// src/events.ts
+import fs2 from "node:fs/promises";
+import { join as join3 } from "node:path";
+
+// src/internal/utils.ts
+import { globSync } from "glob";
+import fsSync from "node:fs";
+import { copy } from "fs-extra";
+import { join } from "node:path";
+import matter from "gray-matter";
+import { satisfies, validRange, valid } from "semver";
+var versionExists = async (catalogDir, id, version) => {
+  const files = await getFiles(`${catalogDir}/**/index.{md,mdx}`);
+  const matchedFiles = await searchFilesForId(files, id, version) || [];
+  return matchedFiles.length > 0;
+};
+var findFileById = async (catalogDir, id, version) => {
+  const files = await getFiles(`${catalogDir}/**/index.{md,mdx}`);
+  const matchedFiles = await searchFilesForId(files, id) || [];
+  const latestVersion = matchedFiles.find((path4) => !path4.includes("versioned"));
+  if (!version) {
+    return latestVersion;
+  }
+  const parsedFiles = matchedFiles.map((path4) => {
+    const { data } = matter.read(path4);
+    return { ...data, path: path4 };
+  });
+  const semverRange = validRange(version);
+  if (semverRange && valid(version)) {
+    const match2 = parsedFiles.filter((c) => satisfies(c.version, semverRange));
+    return match2.length > 0 ? match2[0].path : void 0;
+  }
+  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;
+  }
+};
+var getFiles = async (pattern, ignore = "") => {
+  try {
+    const ignoreList = Array.isArray(ignore) ? ignore : [ignore];
+    const files = globSync(pattern, { ignore: ["node_modules/**", ...ignoreList] });
+    return files;
+  } catch (error) {
+    throw new Error(`Error finding files: ${error}`);
+  }
+};
+var readMdxFile = async (path4) => {
+  const { data } = matter.read(path4);
+  const { markdown, ...frontmatter } = data;
+  return { ...frontmatter, markdown };
+};
+var searchFilesForId = async (files, id, version) => {
+  const idRegex = new RegExp(`^id:\\s*(['"]|>-)?\\s*${id}['"]?\\s*$`, "m");
+  const versionRegex = new RegExp(`^version:\\s*['"]?${version}['"]?\\s*$`, "m");
+  const matches = files.map((file) => {
+    const content = fsSync.readFileSync(file, "utf-8");
+    const hasIdMatch = content.match(idRegex);
+    if (version && !content.match(versionRegex)) {
+      return void 0;
+    }
+    if (hasIdMatch) {
+      return file;
+    }
+  });
+  return matches.filter(Boolean).filter((file) => file !== void 0);
+};
+var copyDir = async (catalogDir, source, target, filter) => {
+  const tmpDirectory = join(catalogDir, "tmp");
+  fsSync.mkdirSync(tmpDirectory, { recursive: true });
+  await copy(source, tmpDirectory, {
+    overwrite: true,
+    filter
+  });
+  await copy(tmpDirectory, target, {
+    overwrite: true,
+    filter
+  });
+  fsSync.rmSync(tmpDirectory, { recursive: true });
+};
+var uniqueVersions = (messages) => {
+  const uniqueSet = /* @__PURE__ */ new Set();
+  return messages.filter((message) => {
+    const key = `${message.id}-${message.version}`;
+    if (!uniqueSet.has(key)) {
+      uniqueSet.add(key);
+      return true;
+    }
+    return false;
+  });
+};
+
+// src/internal/resources.ts
+import { dirname, join as join2 } from "path";
+import matter2 from "gray-matter";
+import fs from "node:fs/promises";
+import fsSync2 from "node:fs";
+import { satisfies as satisfies2 } from "semver";
+import { lock, unlock } from "proper-lockfile";
+var versionResource = async (catalogDir, id) => {
+  const files = await getFiles(`${catalogDir}/**/index.{md,mdx}`);
+  const matchedFiles = await searchFilesForId(files, id);
+  if (matchedFiles.length === 0) {
+    throw new Error(`No resource found with id: ${id}`);
+  }
+  const file = matchedFiles[0];
+  const sourceDirectory = dirname(file);
+  const { data: { version = "0.0.1" } = {} } = matter2.read(file);
+  const targetDirectory = getVersionedDirectory(sourceDirectory, version);
+  fsSync2.mkdirSync(targetDirectory, { recursive: true });
+  await copyDir(catalogDir, sourceDirectory, targetDirectory, (src) => {
+    return !src.includes("versioned");
+  });
+  await fs.readdir(sourceDirectory).then(async (resourceFiles) => {
+    await Promise.all(
+      resourceFiles.map(async (file2) => {
+        if (file2 !== "versioned") {
+          fsSync2.rmSync(join2(sourceDirectory, file2), { recursive: true });
+        }
+      })
+    );
+  });
+};
+var writeResource = async (catalogDir, resource, options = {
+  path: "",
+  type: "",
+  override: false,
+  versionExistingContent: false
+}) => {
+  const path4 = options.path || `/${resource.id}`;
+  const fullPath = join2(catalogDir, path4);
+  fsSync2.mkdirSync(fullPath, { recursive: true });
+  const lockPath = join2(fullPath, "index.mdx");
+  if (!fsSync2.existsSync(lockPath)) {
+    fsSync2.writeFileSync(lockPath, "");
+  }
+  try {
+    await lock(lockPath, {
+      retries: 5,
+      stale: 1e4
+      // 10 seconds
+    });
+    const exists = await versionExists(catalogDir, resource.id, resource.version);
+    if (exists && !options.override) {
+      throw new Error(`Failed to write ${resource.id} (${options.type}) as the version ${resource.version} already exists`);
+    }
+    const { markdown, ...frontmatter } = resource;
+    if (options.versionExistingContent && !exists) {
+      const currentResource = await getResource(catalogDir, resource.id);
+      if (currentResource) {
+        if (satisfies2(resource.version, `>${currentResource.version}`)) {
+          await versionResource(catalogDir, resource.id);
+        } else {
+          throw new Error(`New version ${resource.version} is not greater than current version ${currentResource.version}`);
+        }
+      }
+    }
+    const document = matter2.stringify(markdown.trim(), frontmatter);
+    fsSync2.writeFileSync(lockPath, document);
+  } finally {
+    await unlock(lockPath).catch(() => {
+    });
+  }
+};
+var getResource = async (catalogDir, id, version, options) => {
+  const file = await findFileById(catalogDir, id, version);
+  if (!file) return;
+  const { data, content } = matter2.read(file);
+  return {
+    ...data,
+    markdown: content.trim()
+  };
+};
+var getResourcePath = async (catalogDir, id, version) => {
+  const file = await findFileById(catalogDir, id, version);
+  if (!file) return;
+  return {
+    fullPath: file,
+    relativePath: file.replace(catalogDir, ""),
+    directory: dirname(file.replace(catalogDir, ""))
+  };
+};
+var getResources = async (catalogDir, {
+  type,
+  latestOnly = false,
+  ignore = [],
+  pattern = ""
+}) => {
+  const ignoreList = latestOnly ? `**/versioned/**` : "";
+  const filePattern = pattern || `${catalogDir}/**/${type}/**/index.{md,mdx}`;
+  const files = await getFiles(filePattern, [ignoreList, ...ignore]);
+  if (files.length === 0) return;
+  return files.map((file) => {
+    const { data, content } = matter2.read(file);
+    return {
+      ...data,
+      markdown: content.trim()
+    };
+  });
+};
+var rmResourceById = async (catalogDir, id, version, options) => {
+  const files = await getFiles(`${catalogDir}/**/index.{md,mdx}`);
+  const matchedFiles = await searchFilesForId(files, id, version);
+  if (matchedFiles.length === 0) {
+    throw new Error(`No ${options?.type || "resource"} found with id: ${id}`);
+  }
+  if (options?.persistFiles) {
+    await Promise.all(
+      matchedFiles.map(async (file) => {
+        await fs.rm(file, { recursive: true });
+      })
+    );
+  } else {
+    await Promise.all(
+      matchedFiles.map(async (file) => {
+        const directory = dirname(file);
+        await fs.rm(directory, { recursive: true, force: true });
+      })
+    );
+  }
+};
+var addFileToResource = async (catalogDir, id, file, version) => {
+  const pathToResource = await findFileById(catalogDir, id, version);
+  if (!pathToResource) throw new Error("Cannot find directory to write file to");
+  fsSync2.writeFileSync(join2(dirname(pathToResource), file.fileName), file.content);
+};
+var getFileFromResource = async (catalogDir, id, file, version) => {
+  const pathToResource = await findFileById(catalogDir, id, version);
+  if (!pathToResource) throw new Error("Cannot find directory of resource");
+  const exists = await fs.access(join2(dirname(pathToResource), file.fileName)).then(() => true).catch(() => false);
+  if (!exists) throw new Error(`File ${file.fileName} does not exist in resource ${id} v(${version})`);
+  return fsSync2.readFileSync(join2(dirname(pathToResource), file.fileName), "utf-8");
+};
+var getVersionedDirectory = (sourceDirectory, version) => {
+  return join2(sourceDirectory, "versioned", version);
+};
+
+// src/events.ts
+var getEvent = (directory) => async (id, version) => getResource(directory, id, version, { type: "event" });
+var getEvents = (directory) => async (options) => getResources(directory, { type: "events", ...options });
+var writeEvent = (directory) => async (event, options = { path: "", override: false }) => writeResource(directory, { ...event }, { ...options, type: "event" });
+var writeEventToService = (directory) => async (event, service, options = { path: "" }) => {
+  const resourcePath = await getResourcePath(directory, service.id, service.version);
+  if (!resourcePath) {
+    throw new Error("Service not found");
+  }
+  let pathForEvent = service.version && service.version !== "latest" ? `${resourcePath.directory}/versioned/${service.version}/events` : `${resourcePath.directory}/events`;
+  pathForEvent = join3(pathForEvent, event.id);
+  await writeResource(directory, { ...event }, { ...options, path: pathForEvent, type: "event" });
+};
+var rmEvent = (directory) => async (path4) => {
+  await fs2.rm(join3(directory, path4), { recursive: true });
+};
+var rmEventById = (directory) => async (id, version, persistFiles) => {
+  await rmResourceById(directory, id, version, { type: "event", persistFiles });
+};
+var versionEvent = (directory) => async (id) => versionResource(directory, id);
+var addFileToEvent = (directory) => async (id, file, version) => addFileToResource(directory, id, file, version);
+var addSchemaToEvent = (directory) => async (id, schema, version) => {
+  await addFileToEvent(directory)(id, { content: schema.schema, fileName: schema.fileName }, version);
+};
+var eventHasVersion = (directory) => async (id, version) => {
+  const file = await findFileById(directory, id, version);
+  return !!file;
+};
+
+// src/commands.ts
+import fs3 from "node:fs/promises";
+import { join as join4 } from "node:path";
+var getCommand = (directory) => async (id, version) => getResource(directory, id, version, { type: "command" });
+var getCommands = (directory) => async (options) => getResources(directory, { type: "commands", ...options });
+var writeCommand = (directory) => async (command, options = { path: "" }) => writeResource(directory, { ...command }, { ...options, type: "command" });
+var writeCommandToService = (directory) => async (command, service, options = { path: "" }) => {
+  const resourcePath = await getResourcePath(directory, service.id, service.version);
+  if (!resourcePath) {
+    throw new Error("Service not found");
+  }
+  let pathForCommand = service.version && service.version !== "latest" ? `${resourcePath.directory}/versioned/${service.version}/commands` : `${resourcePath.directory}/commands`;
+  pathForCommand = join4(pathForCommand, command.id);
+  await writeResource(directory, { ...command }, { ...options, path: pathForCommand, type: "command" });
+};
+var rmCommand = (directory) => async (path4) => {
+  await fs3.rm(join4(directory, path4), { recursive: true });
+};
+var rmCommandById = (directory) => async (id, version, persistFiles) => rmResourceById(directory, id, version, { type: "command", persistFiles });
+var versionCommand = (directory) => async (id) => versionResource(directory, id);
+var addFileToCommand = (directory) => async (id, file, version) => addFileToResource(directory, id, file, version);
+var addSchemaToCommand = (directory) => async (id, schema, version) => {
+  await addFileToCommand(directory)(id, { content: schema.schema, fileName: schema.fileName }, version);
+};
+var commandHasVersion = (directory) => async (id, version) => {
+  const file = await findFileById(directory, id, version);
+  return !!file;
+};
+
+// src/queries.ts
+import fs4 from "node:fs/promises";
+import { join as join5 } from "node:path";
+var getQuery = (directory) => async (id, version) => getResource(directory, id, version, { type: "query" });
+var writeQuery = (directory) => async (query, options = { path: "" }) => writeResource(directory, { ...query }, { ...options, type: "query" });
+var getQueries = (directory) => async (options) => getResources(directory, { type: "queries", ...options });
+var writeQueryToService = (directory) => async (query, service, options = { path: "" }) => {
+  const resourcePath = await getResourcePath(directory, service.id, service.version);
+  if (!resourcePath) {
+    throw new Error("Service not found");
+  }
+  let pathForQuery = service.version && service.version !== "latest" ? `${resourcePath.directory}/versioned/${service.version}/queries` : `${resourcePath.directory}/queries`;
+  pathForQuery = join5(pathForQuery, query.id);
+  await writeResource(directory, { ...query }, { ...options, path: pathForQuery, type: "query" });
+};
+var rmQuery = (directory) => async (path4) => {
+  await fs4.rm(join5(directory, path4), { recursive: true });
+};
+var rmQueryById = (directory) => async (id, version, persistFiles) => {
+  await rmResourceById(directory, id, version, { type: "query", persistFiles });
+};
+var versionQuery = (directory) => async (id) => versionResource(directory, id);
+var addFileToQuery = (directory) => async (id, file, version) => addFileToResource(directory, id, file, version);
+var addSchemaToQuery = (directory) => async (id, schema, version) => {
+  await addFileToQuery(directory)(id, { content: schema.schema, fileName: schema.fileName }, version);
+};
+var queryHasVersion = (directory) => async (id, version) => {
+  const file = await findFileById(directory, id, version);
+  return !!file;
+};
+
+// src/services.ts
+import fs5 from "node:fs/promises";
+import { join as join6, dirname as dirname3 } from "node:path";
+var getService = (directory) => async (id, version) => getResource(directory, id, version, { type: "service" });
+var getServices = (directory) => async (options) => getResources(directory, {
+  type: "services",
+  ignore: ["**/events/**", "**/commands/**", "**/queries/**"],
+  ...options
+});
+var writeService = (directory) => async (service, options = { path: "" }) => {
+  const resource = { ...service };
+  if (Array.isArray(service.sends)) {
+    resource.sends = uniqueVersions(service.sends);
+  }
+  if (Array.isArray(service.receives)) {
+    resource.receives = uniqueVersions(service.receives);
+  }
+  return await writeResource(directory, resource, { ...options, type: "service" });
+};
+var writeVersionedService = (directory) => async (service) => {
+  const resource = { ...service };
+  const path4 = getVersionedDirectory(service.id, service.version);
+  return await writeService(directory)(resource, { path: path4 });
+};
+var writeServiceToDomain = (directory) => async (service, domain, options = { path: "" }) => {
+  let pathForService = domain.version && domain.version !== "latest" ? `/${domain.id}/versioned/${domain.version}/services` : `/${domain.id}/services`;
+  pathForService = join6(pathForService, service.id);
+  await writeResource(directory, { ...service }, { ...options, path: pathForService, type: "service" });
+};
+var versionService = (directory) => async (id) => versionResource(directory, id);
+var rmService = (directory) => async (path4) => {
+  await fs5.rm(join6(directory, path4), { recursive: true });
+};
+var rmServiceById = (directory) => async (id, version, persistFiles) => rmResourceById(directory, id, version, { type: "service", persistFiles });
+var addFileToService = (directory) => async (id, file, version) => addFileToResource(directory, id, file, version);
+var getSpecificationFilesForService = (directory) => async (id, version) => {
+  let service = await getService(directory)(id, version);
+  const filePathToService = await findFileById(directory, id, version);
+  if (!filePathToService) throw new Error("Cannot find directory of service");
+  let specs = [];
+  if (service.specifications) {
+    const serviceSpecifications = service.specifications;
+    const specificationFiles = Object.keys(serviceSpecifications);
+    const getSpecs = specificationFiles.map(async (specFile) => {
+      const fileName = serviceSpecifications[specFile];
+      if (!fileName) {
+        throw new Error(`Specification file name for ${specFile} is undefined`);
+      }
+      const rawFile = await getFileFromResource(directory, id, { fileName }, version);
+      return { key: specFile, content: rawFile, fileName, path: join6(dirname3(filePathToService), fileName) };
+    });
+    specs = await Promise.all(getSpecs);
+  }
+  return specs;
+};
+var addMessageToService = (directory) => async (id, direction, event, version) => {
+  let service = await getService(directory)(id, version);
+  if (direction === "sends") {
+    if (service.sends === void 0) {
+      service.sends = [];
+    }
+    for (let i = 0; i < service.sends.length; i++) {
+      if (service.sends[i].id === event.id && service.sends[i].version === event.version) {
+        return;
+      }
+    }
+    service.sends.push({ id: event.id, version: event.version });
+  } else if (direction === "receives") {
+    if (service.receives === void 0) {
+      service.receives = [];
+    }
+    for (let i = 0; i < service.receives.length; i++) {
+      if (service.receives[i].id === event.id && service.receives[i].version === event.version) {
+        return;
+      }
+    }
+    service.receives.push({ id: event.id, version: event.version });
+  } else {
+    throw new Error(`Direction ${direction} is invalid, only 'receives' and 'sends' are supported`);
+  }
+  const existingResource = await findFileById(directory, id, version);
+  if (!existingResource) {
+    throw new Error(`Cannot find service ${id} in the catalog`);
+  }
+  const path4 = existingResource.split("/services")[0];
+  const pathToResource = join6(path4, "services");
+  await rmServiceById(directory)(id, version);
+  await writeService(pathToResource)(service);
+};
+var serviceHasVersion = (directory) => async (id, version) => {
+  const file = await findFileById(directory, id, version);
+  return !!file;
+};
+
+// src/domains.ts
+import fs6 from "node:fs/promises";
+import path, { join as join7 } from "node:path";
+import fsSync3 from "node:fs";
+import matter3 from "gray-matter";
+var getDomain = (directory) => async (id, version) => getResource(directory, id, version, { type: "domain" });
+var getDomains = (directory) => async (options) => getResources(directory, {
+  type: "domains",
+  ignore: ["**/services/**", "**/events/**", "**/commands/**", "**/queries/**", "**/flows/**"],
+  ...options
+});
+var writeDomain = (directory) => async (domain, options = { path: "" }) => {
+  const resource = { ...domain };
+  if (Array.isArray(domain.services)) {
+    resource.services = uniqueVersions(domain.services);
+  }
+  return await writeResource(directory, resource, { ...options, type: "domain" });
+};
+var versionDomain = (directory) => async (id) => versionResource(directory, id);
+var rmDomain = (directory) => async (path4) => {
+  await fs6.rm(join7(directory, path4), { 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);
+var addUbiquitousLanguageToDomain = (directory) => async (id, ubiquitousLanguageDictionary, version) => {
+  const content = matter3.stringify("", {
+    ...ubiquitousLanguageDictionary
+  });
+  await addFileToResource(directory, id, { content, fileName: "ubiquitous-language.mdx" }, version);
+};
+var getUbiquitousLanguageFromDomain = (directory) => async (id, version) => {
+  const pathToDomain = await findFileById(directory, id, version) || "";
+  const pathToUbiquitousLanguage = path.join(path.dirname(pathToDomain), "ubiquitous-language.mdx");
+  const fileExists = fsSync3.existsSync(pathToUbiquitousLanguage);
+  if (!fileExists) {
+    return void 0;
+  }
+  const content = await readMdxFile(pathToUbiquitousLanguage);
+  return content;
+};
+var domainHasVersion = (directory) => async (id, version) => {
+  const file = await findFileById(directory, id, version);
+  return !!file;
+};
+var addServiceToDomain = (directory) => async (id, service, version) => {
+  let domain = await getDomain(directory)(id, version);
+  if (domain.services === void 0) {
+    domain.services = [];
+  }
+  const serviceExistsInList = domain.services.some((s) => s.id === service.id && s.version === service.version);
+  if (serviceExistsInList) {
+    return;
+  }
+  domain.services.push(service);
+  await rmDomainById(directory)(id, version, true);
+  await writeDomain(directory)(domain);
+};
+
+// src/channels.ts
+import fs7 from "node:fs/promises";
+import { join as join8 } from "node: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 (path4) => {
+  await fs7.rm(join8(directory, path4), { recursive: true });
+};
+var rmChannelById = (directory) => async (id, version, persistFiles) => rmResourceById(directory, id, version, { type: "channel", persistFiles });
+var versionChannel = (directory) => async (id) => versionResource(directory, id);
+var channelHasVersion = (directory) => async (id, version) => {
+  const file = await findFileById(directory, id, version);
+  return !!file;
+};
+var addMessageToChannel = (directory, collection) => async (id, _message, version) => {
+  let channel = await getChannel(directory)(id, version);
+  const functions = {
+    events: {
+      getMessage: getEvent,
+      rmMessageById: rmEventById,
+      writeMessage: writeEvent
+    },
+    commands: {
+      getMessage: getCommand,
+      rmMessageById: rmCommandById,
+      writeMessage: writeCommand
+    },
+    queries: {
+      getMessage: getQuery,
+      rmMessageById: rmQueryById,
+      writeMessage: writeQuery
+    }
+  };
+  const { getMessage, rmMessageById, writeMessage } = functions[collection];
+  const message = await getMessage(directory)(_message.id, _message.version);
+  if (!message) throw new Error(`Message ${_message.id} with version ${_message.version} not found`);
+  if (message.channels === void 0) {
+    message.channels = [];
+  }
+  const channelInfo = { id, version: channel.version, ..._message.parameters && { parameters: _message.parameters } };
+  message.channels.push(channelInfo);
+  const existingResource = await findFileById(directory, _message.id, _message.version);
+  if (!existingResource) {
+    throw new Error(`Cannot find message ${id} in the catalog`);
+  }
+  const path4 = existingResource.split(`/${collection}`)[0];
+  const pathToResource = join8(path4, collection);
+  await rmMessageById(directory)(_message.id, _message.version, true);
+  await writeMessage(pathToResource)(message);
+};
+
+// src/custom-docs.ts
+import path2, { join as join9 } from "node:path";
+import fsSync4 from "node:fs";
+import fs8 from "node:fs/promises";
+import matter4 from "gray-matter";
+import slugify from "slugify";
+var getCustomDoc = (directory) => async (filePath) => {
+  const fullPath = path2.join(directory, filePath);
+  const fullPathWithExtension = fullPath.endsWith(".mdx") ? fullPath : `${fullPath}.mdx`;
+  const fileExists = fsSync4.existsSync(fullPathWithExtension);
+  if (!fileExists) {
+    return void 0;
+  }
+  return readMdxFile(fullPathWithExtension);
+};
+var getCustomDocs = (directory) => async (options) => {
+  if (options?.path) {
+    const pattern = `${directory}/${options.path}/**/*.{md,mdx}`;
+    return getResources(directory, { type: "docs", pattern });
+  }
+  return getResources(directory, { type: "docs", pattern: `${directory}/**/*.{md,mdx}` });
+};
+var writeCustomDoc = (directory) => async (customDoc, options = { path: "" }) => {
+  const { fileName, ...rest } = customDoc;
+  const name = fileName || slugify(customDoc.title, { lower: true });
+  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);
+  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 });
+};
+
+// src/teams.ts
+import fs9 from "node:fs/promises";
+import fsSync5 from "node:fs";
+import { join as join10 } from "node:path";
+import matter5 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);
+  return {
+    ...data,
+    id: data.id,
+    name: data.name,
+    markdown: content.trim()
+  };
+};
+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);
+    return {
+      ...data,
+      id: data.id,
+      name: data.name,
+      markdown: content.trim()
+    };
+  });
+};
+var writeTeam = (catalogDir) => async (team, options = {}) => {
+  const resource = { ...team };
+  const currentTeam = await getTeam(catalogDir)(resource.id);
+  const exists = currentTeam !== void 0;
+  if (exists && !options.override) {
+    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);
+};
+var rmTeamById = (catalogDir) => async (id) => {
+  await fs9.rm(join10(catalogDir, `${id}.mdx`), { recursive: true });
+};
+
+// src/users.ts
+import fsSync6 from "node:fs";
+import { join as join11 } from "node:path";
+import matter6 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);
+  return {
+    ...data,
+    id: data.id,
+    name: data.name,
+    avatarUrl: data.avatarUrl,
+    markdown: content.trim()
+  };
+};
+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);
+    return {
+      ...data,
+      id: data.id,
+      name: data.name,
+      avatarUrl: data.avatarUrl,
+      markdown: content.trim()
+    };
+  });
+};
+var writeUser = (catalogDir) => async (user, options = {}) => {
+  const resource = { ...user };
+  const currentUser = await getUser(catalogDir)(resource.id);
+  const exists = currentUser !== void 0;
+  if (exists && !options.override) {
+    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);
+};
+var rmUserById = (catalogDir) => async (id) => {
+  fsSync6.rmSync(join11(catalogDir, `${id}.mdx`), { recursive: true });
+};
+
+// src/index.ts
+var index_default = (path4) => {
+  return {
+    /**
+     * Returns an events from EventCatalog
+     * @param id - The id of the event to retrieve
+     * @param version - Optional id of the version to get (supports semver)
+     * @returns Event|Undefined
+     */
+    getEvent: getEvent(join12(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)),
+    /**
+     * Adds an event to EventCatalog
+     *
+     * @param event - The event to write
+     * @param options - Optional options to write the event
+     *
+     */
+    writeEvent: writeEvent(join12(path4, "events")),
+    /**
+     * Adds an event to a service in EventCatalog
+     *
+     * @param event - The event to write to the service
+     * @param service - The service and it's id to write to the event to
+     * @param options - Optional options to write the event
+     *
+     */
+    writeEventToService: writeEventToService(join12(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")),
+    /**
+     * Remove an event by an Event id
+     *
+     * @param id - The id of the event you want to remove
+     *
+     */
+    rmEventById: rmEventById(join12(path4)),
+    /**
+     * Moves a given event id to the version directory
+     * @param directory
+     */
+    versionEvent: versionEvent(join12(path4)),
+    /**
+     * Adds a file to the given event
+     * @param id - The id of the event to add the file to
+     * @param file - File contents to add including the content and the file name
+     * @param version - Optional version of the event to add the file to
+     * @returns
+     */
+    addFileToEvent: addFileToEvent(join12(path4)),
+    /**
+     * Adds a schema to the given event
+     * @param id - The id of the event to add the schema to
+     * @param schema - Schema contents to add including the content and the file name
+     * @param version - Optional version of the event to add the schema to
+     * @returns
+     */
+    addSchemaToEvent: addSchemaToEvent(join12(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)),
+    /**
+     * ================================
+     *            Commands
+     * ================================
+     */
+    /**
+     * Returns a command from EventCatalog
+     * @param id - The id of the command to retrieve
+     * @param version - Optional id of the version to get (supports semver)
+     * @returns Command|Undefined
+     */
+    getCommand: getCommand(join12(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)),
+    /**
+     * Adds an command to EventCatalog
+     *
+     * @param command - The command to write
+     * @param options - Optional options to write the command
+     *
+     */
+    writeCommand: writeCommand(join12(path4, "commands")),
+    /**
+     * Adds a command to a service in EventCatalog
+     *
+     * @param command - The command to write to the service
+     * @param service - The service and it's id to write to the command to
+     * @param options - Optional options to write the command
+     *
+     */
+    writeCommandToService: writeCommandToService(join12(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")),
+    /**
+     * Remove an command by an Event id
+     *
+     * @param id - The id of the command you want to remove
+     *
+     */
+    rmCommandById: rmCommandById(join12(path4)),
+    /**
+     * Moves a given command id to the version directory
+     * @param directory
+     */
+    versionCommand: versionCommand(join12(path4)),
+    /**
+     * Adds a file to the given command
+     * @param id - The id of the command to add the file to
+     * @param file - File contents to add including the content and the file name
+     * @param version - Optional version of the command to add the file to
+     * @returns
+     */
+    addFileToCommand: addFileToCommand(join12(path4)),
+    /**
+     * Adds a schema to the given command
+     * @param id - The id of the command to add the schema to
+     * @param schema - Schema contents to add including the content and the file name
+     * @param version - Optional version of the command to add the schema to
+     * @returns
+     */
+    addSchemaToCommand: addSchemaToCommand(join12(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)),
+    /**
+     * ================================
+     *            Queries
+     * ================================
+     */
+    /**
+     * Returns a query from EventCatalog
+     * @param id - The id of the query to retrieve
+     * @param version - Optional id of the version to get (supports semver)
+     * @returns Query|Undefined
+     */
+    getQuery: getQuery(join12(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)),
+    /**
+     * Adds a query to EventCatalog
+     *
+     * @param query - The query to write
+     * @param options - Optional options to write the event
+     *
+     */
+    writeQuery: writeQuery(join12(path4, "queries")),
+    /**
+     * Adds a query to a service in EventCatalog
+     *
+     * @param query - The query to write to the service
+     * @param service - The service and it's id to write to the query to
+     * @param options - Optional options to write the query
+     *
+     */
+    writeQueryToService: writeQueryToService(join12(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")),
+    /**
+     * Remove a query by a Query id
+     *
+     * @param id - The id of the query you want to remove
+     *
+     */
+    rmQueryById: rmQueryById(join12(path4)),
+    /**
+     * Moves a given query id to the version directory
+     * @param directory
+     */
+    versionQuery: versionQuery(join12(path4)),
+    /**
+     * Adds a file to the given query
+     * @param id - The id of the query to add the file to
+     * @param file - File contents to add including the content and the file name
+     * @param version - Optional version of the query to add the file to
+     * @returns
+     */
+    addFileToQuery: addFileToQuery(join12(path4)),
+    /**
+     * Adds a schema to the given query
+     * @param id - The id of the query to add the schema to
+     * @param schema - Schema contents to add including the content and the file name
+     * @param version - Optional version of the query to add the schema to
+     * @returns
+     */
+    addSchemaToQuery: addSchemaToQuery(join12(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)),
+    /**
+     * ================================
+     *            Channels
+     * ================================
+     */
+    /**
+     * Returns a channel from EventCatalog
+     * @param id - The id of the channel to retrieve
+     * @param version - Optional id of the version to get (supports semver)
+     * @returns Channel|Undefined
+     */
+    getChannel: getChannel(join12(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)),
+    /**
+     * Adds an channel to EventCatalog
+     *
+     * @param command - The channel to write
+     * @param options - Optional options to write the channel
+     *
+     */
+    writeChannel: writeChannel(join12(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")),
+    /**
+     * Remove an channel by an Event id
+     *
+     * @param id - The id of the channel you want to remove
+     *
+     */
+    rmChannelById: rmChannelById(join12(path4)),
+    /**
+     * Moves a given channel id to the version directory
+     * @param directory
+     */
+    versionChannel: versionChannel(join12(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)),
+    /**
+     * Add a channel to an event
+     *
+     * Optionally specify a version to add the channel to a specific version of the event.
+     *
+     * @example
+     * ```ts
+     * import utils from '@eventcatalog/utils';
+     *
+     * const { addEventToChannel } = utils('/path/to/eventcatalog');
+     *
+     * // adds a new event (InventoryUpdatedEvent) to the inventory.{env}.events channel
+     * await addEventToChannel('inventory.{env}.events channel', { id: 'InventoryUpdatedEvent', version: '2.0.0', parameters: { env: 'dev' } });
+     *
+     * ```
+     */
+    addEventToChannel: addMessageToChannel(join12(path4), "events"),
+    /**
+     * Add a channel to an command
+     *
+     * Optionally specify a version to add the channel to a specific version of the command.
+     *
+     * @example
+     * ```ts
+     * import utils from '@eventcatalog/utils';
+     *
+     * const { addCommandToChannel } = utils('/path/to/eventcatalog');
+     *
+     * // adds a new command (UpdateInventory) to the inventory.{env}.events channel
+     * await addCommandToChannel('inventory.{env}.events channel', { id: 'UpdateInventory', version: '2.0.0', parameters: { env: 'dev' } });
+     *
+     * ```
+     */
+    addCommandToChannel: addMessageToChannel(join12(path4), "commands"),
+    /**
+     * Add a channel to an query
+     *
+     * Optionally specify a version to add the channel to a specific version of the query.
+     *
+     * @example
+     * ```ts
+     * import utils from '@eventcatalog/utils';
+     *
+     * const { addQueryToChannel } = utils('/path/to/eventcatalog');
+     *
+     * // adds a new query (GetInventory) to the inventory.{env}.events channel
+     * await addQueryToChannel('inventory.{env}.events channel', { id: 'GetInventory', version: '2.0.0', parameters: { env: 'dev' } });
+     *
+     * ```
+     */
+    addQueryToChannel: addMessageToChannel(join12(path4), "queries"),
+    /**
+     * ================================
+     *            SERVICES
+     * ================================
+     */
+    /**
+     * Adds a service to EventCatalog
+     *
+     * @param service - The service to write
+     * @param options - Optional options to write the event
+     *
+     */
+    writeService: writeService(join12(path4, "services")),
+    /**
+     * Adds a versioned service to EventCatalog
+     *
+     * @param service - The service to write
+     *
+     */
+    writeVersionedService: writeVersionedService(join12(path4, "services")),
+    /**
+     * Adds a service to a domain in EventCatalog
+     *
+     * @param service - The service to write
+     * @param domain - The domain to add the service to
+     * @param options - Optional options to write the event
+     *
+     */
+    writeServiceToDomain: writeServiceToDomain(join12(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)),
+    /**
+     * Returns all services from EventCatalog
+     * @param latestOnly - optional boolean, set to true to get only latest versions
+     * @returns Service[]|Undefined
+     */
+    getServices: getServices(join12(path4)),
+    /**
+     * Moves a given service id to the version directory
+     * @param directory
+     */
+    versionService: versionService(join12(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")),
+    /**
+     * Remove an service by an service id
+     *
+     * @param id - The id of the service you want to remove
+     *
+     */
+    rmServiceById: rmServiceById(join12(path4)),
+    /**
+     * Adds a file to the given service
+     * @param id - The id of the service to add the file to
+     * @param file - File contents to add including the content and the file name
+     * @param version - Optional version of the service to add the file to
+     * @returns
+     */
+    addFileToService: addFileToService(join12(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)),
+    /**
+     * 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)),
+    /**
+     * Add an event to a service by it's id.
+     *
+     * Optionally specify a version to add the event to a specific version of the service.
+     *
+     * @example
+     * ```ts
+     * import utils from '@eventcatalog/utils';
+     *
+     * const { addEventToService } = utils('/path/to/eventcatalog');
+     *
+     * // adds a new event (InventoryUpdatedEvent) that the InventoryService will send
+     * await addEventToService('InventoryService', 'sends', { event: 'InventoryUpdatedEvent', version: '2.0.0' });
+     *
+     * // adds a new event (OrderComplete) that the InventoryService will receive
+     * await addEventToService('InventoryService', 'receives', { event: 'OrderComplete', version: '2.0.0' });
+     *
+     * ```
+     */
+    addEventToService: addMessageToService(join12(path4)),
+    /**
+     * Add a command to a service by it's id.
+     *
+     * Optionally specify a version to add the event to a specific version of the service.
+     *
+     * @example
+     * ```ts
+     * import utils from '@eventcatalog/utils';
+     *
+     * const { addCommandToService } = utils('/path/to/eventcatalog');
+     *
+     * // adds a new command (UpdateInventoryCommand) that the InventoryService will send
+     * await addCommandToService('InventoryService', 'sends', { command: 'UpdateInventoryCommand', version: '2.0.0' });
+     *
+     * // adds a new command (VerifyInventory) that the InventoryService will receive
+     * await addCommandToService('InventoryService', 'receives', { command: 'VerifyInventory', version: '2.0.0' });
+     *
+     * ```
+     */
+    addCommandToService: addMessageToService(join12(path4)),
+    /**
+     * Add a query to a service by it's id.
+     *
+     * Optionally specify a version to add the event to a specific version of the service.
+     *
+     * @example
+     * ```ts
+     * import utils from '@eventcatalog/utils';
+     *
+     * const { addQueryToService } = utils('/path/to/eventcatalog');
+     *
+     * // adds a new query (UpdateInventory) that the InventoryService will send
+     * await addQueryToService('InventoryService', 'sends', { command: 'UpdateInventory', version: '2.0.0' });
+     *
+     * // adds a new command (VerifyInventory) that the InventoryService will receive
+     * await addQueryToService('InventoryService', 'receives', { command: 'VerifyInventory', version: '2.0.0' });
+     *
+     * ```
+     */
+    addQueryToService: addMessageToService(join12(path4)),
+    /**
+     * ================================
+     *            Domains
+     * ================================
+     */
+    /**
+     * Adds a domain to EventCatalog
+     *
+     * @param domain - The domain to write
+     * @param options - Optional options to write the event
+     *
+     */
+    writeDomain: writeDomain(join12(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")),
+    /**
+     * Returns all domains from EventCatalog
+     * @param latestOnly - optional boolean, set to true to get only latest versions
+     * @returns Domain[]|Undefined
+     */
+    getDomains: getDomains(join12(path4)),
+    /**
+     * Moves a given domain id to the version directory
+     * @param directory
+     */
+    versionDomain: versionDomain(join12(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")),
+    /**
+     * Remove an service by an domain id
+     *
+     * @param id - The id of the domain you want to remove
+     *
+     */
+    rmDomainById: rmDomainById(join12(path4, "domains")),
+    /**
+     * Adds a file to the given domain
+     * @param id - The id of the domain to add the file to
+     * @param file - File contents to add including the content and the file name
+     * @param version - Optional version of the domain to add the file to
+     * @returns
+     */
+    addFileToDomain: addFileToDomain(join12(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")),
+    /**
+     * 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")),
+    /**
+     * 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)),
+    /**
+     * Adds a given service to a domain
+     * @param id - The id of the domain
+     * @param service - The id and version of the service to add
+     * @param version - (Optional) The version of the domain to add the service to
+     * @returns
+     */
+    addServiceToDomain: addServiceToDomain(join12(path4, "domains")),
+    /**
+     * ================================
+     *            Teams
+     * ================================
+     */
+    /**
+     * Adds a team to EventCatalog
+     *
+     * @param team - The team to write
+     * @param options - Optional options to write the team
+     *
+     */
+    writeTeam: writeTeam(join12(path4, "teams")),
+    /**
+     * Returns a team from EventCatalog
+     * @param id - The id of the team to retrieve
+     * @returns Team|Undefined
+     */
+    getTeam: getTeam(join12(path4, "teams")),
+    /**
+     * Returns all teams from EventCatalog
+     * @returns Team[]|Undefined
+     */
+    getTeams: getTeams(join12(path4)),
+    /**
+     * Remove a team by the team id
+     *
+     * @param id - The id of the team you want to remove
+     *
+     */
+    rmTeamById: rmTeamById(join12(path4, "teams")),
+    /**
+     * ================================
+     *            Users
+     * ================================
+     */
+    /**
+     * Adds a user to EventCatalog
+     *
+     * @param user - The user to write
+     * @param options - Optional options to write the user
+     *
+     */
+    writeUser: writeUser(join12(path4, "users")),
+    /**
+     * Returns a user from EventCatalog
+     * @param id - The id of the user to retrieve
+     * @returns User|Undefined
+     */
+    getUser: getUser(join12(path4, "users")),
+    /**
+     * Returns all user from EventCatalog
+     * @returns User[]|Undefined
+     */
+    getUsers: getUsers(join12(path4)),
+    /**
+     * Remove a user by the user id
+     *
+     * @param id - The id of the user you want to remove
+     *
+     */
+    rmUserById: rmUserById(join12(path4, "users")),
+    /**
+     * ================================
+     *            Custom Docs
+     * ================================
+     */
+    /**
+     * Returns a custom doc from EventCatalog
+     * @param path - The path to the custom doc to retrieve
+     * @returns CustomDoc|Undefined
+     */
+    getCustomDoc: getCustomDoc(join12(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")),
+    /**
+     * 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")),
+    /**
+     * Removes a custom doc from EventCatalog
+     * @param path - The path to the custom doc to remove
+     *
+     */
+    rmCustomDoc: rmCustomDoc(join12(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))
+  };
+};
+
+// src/eventcatalog.ts
+var DUMP_VERSION = "0.0.1";
+var getEventCatalogVersion = async (catalogDir) => {
+  try {
+    const packageJson = fs10.readFileSync(join13(catalogDir, "package.json"), "utf8");
+    const packageJsonObject = JSON.parse(packageJson);
+    return packageJsonObject["dependencies"]["@eventcatalog/core"];
+  } catch (error) {
+    return "unknown";
+  }
+};
+var hydrateResource = async (catalogDir, resources, { attachSchema = false } = {}) => {
+  return await Promise.all(
+    resources.map(async (resource) => {
+      const resourcePath = await getResourcePath(catalogDir, resource.id, resource.version);
+      let schema = "";
+      if (resource.schemaPath && resourcePath?.fullPath) {
+        const pathToSchema = path3.join(path3.dirname(resourcePath?.fullPath), resource.schemaPath);
+        if (fs10.existsSync(pathToSchema)) {
+          schema = fs10.readFileSync(pathToSchema, "utf8");
+        }
+      }
+      const eventcatalog = schema ? { directory: resourcePath?.directory, schema } : { directory: resourcePath?.directory };
+      return {
+        ...resource,
+        _eventcatalog: eventcatalog
+      };
+    })
+  );
+};
+var filterCollection = (collection, options) => {
+  return collection.map((item) => ({
+    ...item,
+    markdown: options?.includeMarkdown ? item.markdown : void 0
+  }));
+};
+var dumpCatalog = (directory) => async (options) => {
+  const { getDomains: getDomains2, getServices: getServices2, getEvents: getEvents2, getQueries: getQueries2, getCommands: getCommands2, getChannels: getChannels2, getTeams: getTeams2, getUsers: getUsers2 } = index_default(directory);
+  const { includeMarkdown = true } = options || {};
+  const domains = await getDomains2();
+  const services = await getServices2();
+  const events = await getEvents2();
+  const commands = await getCommands2();
+  const queries = await getQueries2();
+  const teams = await getTeams2();
+  const users = await getUsers2();
+  const channels = await getChannels2();
+  const [
+    hydratedDomains,
+    hydratedServices,
+    hydratedEvents,
+    hydratedQueries,
+    hydratedCommands,
+    hydratedTeams,
+    hydratedUsers,
+    hydratedChannels
+  ] = await Promise.all([
+    hydrateResource(directory, domains),
+    hydrateResource(directory, services),
+    hydrateResource(directory, events),
+    hydrateResource(directory, queries),
+    hydrateResource(directory, commands),
+    hydrateResource(directory, teams),
+    hydrateResource(directory, users),
+    hydrateResource(directory, channels)
+  ]);
+  return {
+    version: DUMP_VERSION,
+    catalogVersion: await getEventCatalogVersion(directory),
+    createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+    resources: {
+      domains: filterCollection(hydratedDomains, { includeMarkdown }),
+      services: filterCollection(hydratedServices, { includeMarkdown }),
+      messages: {
+        events: filterCollection(hydratedEvents, { includeMarkdown }),
+        queries: filterCollection(hydratedQueries, { includeMarkdown }),
+        commands: filterCollection(hydratedCommands, { includeMarkdown })
+      },
+      teams: filterCollection(hydratedTeams, { includeMarkdown }),
+      users: filterCollection(hydratedUsers, { includeMarkdown }),
+      channels: filterCollection(hydratedChannels, { includeMarkdown })
+    }
+  };
+};
+export {
+  dumpCatalog
+};
+//# sourceMappingURL=eventcatalog.mjs.map