@eventcatalog/sdk 2.0.1 → 2.1.0

package/dist/index.mjs

@@ -1,5 +1,5 @@
 // src/index.ts
-import { join as join11 } from "node:path";
+import { join as join12 } from "node:path";
 
 // src/events.ts
 import fs2 from "node:fs/promises";
@@ -20,13 +20,13 @@ 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((path) => !path.includes("versioned"));
+  const latestVersion = matchedFiles.find((path2) => !path2.includes("versioned"));
   if (!version) {
     return latestVersion;
   }
-  const parsedFiles = matchedFiles.map((path) => {
-    const { data } = matter.read(path);
-    return { ...data, path };
+  const parsedFiles = matchedFiles.map((path2) => {
+    const { data } = matter.read(path2);
+    return { ...data, path: path2 };
   });
   const semverRange = validRange(version);
   if (semverRange && valid(version)) {
@@ -50,6 +50,11 @@ var getFiles = async (pattern, ignore = "") => {
     throw new Error(`Error finding files: ${error}`);
   }
 };
+var readMdxFile = async (path2) => {
+  const { data } = matter.read(path2);
+  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");
@@ -127,8 +132,8 @@ var writeResource = async (catalogDir, resource, options = {
   override: false,
   versionExistingContent: false
 }) => {
-  const path = options.path || `/${resource.id}`;
-  const fullPath = join2(catalogDir, path);
+  const path2 = options.path || `/${resource.id}`;
+  const fullPath = join2(catalogDir, path2);
   fsSync2.mkdirSync(fullPath, { recursive: true });
   const lockPath = join2(fullPath, "index.mdx");
   if (!fsSync2.existsSync(lockPath)) {
@@ -171,9 +176,15 @@ var getResource = async (catalogDir, id, version, options) => {
     markdown: content.trim()
   };
 };
-var getResources = async (catalogDir, { type, latestOnly = false, ignore = [] }) => {
+var getResources = async (catalogDir, {
+  type,
+  latestOnly = false,
+  ignore = [],
+  pattern = ""
+}) => {
   const ignoreList = latestOnly ? `**/versioned/**` : "";
-  const files = await getFiles(`${catalogDir}/**/${type}/**/index.{md,mdx}`, [ignoreList, ...ignore]);
+  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);
@@ -229,8 +240,8 @@ var writeEventToService = (directory) => async (event, service, options = { path
   pathForEvent = join3(pathForEvent, event.id);
   await writeResource(directory, { ...event }, { ...options, path: pathForEvent, type: "event" });
 };
-var rmEvent = (directory) => async (path) => {
-  await fs2.rm(join3(directory, path), { recursive: true });
+var rmEvent = (directory) => async (path2) => {
+  await fs2.rm(join3(directory, path2), { recursive: true });
 };
 var rmEventById = (directory) => async (id, version, persistFiles) => {
   await rmResourceById(directory, id, version, { type: "event", persistFiles });
@@ -256,8 +267,8 @@ var writeCommandToService = (directory) => async (command, service, options = {
   pathForEvent = join4(pathForEvent, command.id);
   await writeResource(directory, { ...command }, { ...options, path: pathForEvent, type: "command" });
 };
-var rmCommand = (directory) => async (path) => {
-  await fs3.rm(join4(directory, path), { recursive: true });
+var rmCommand = (directory) => async (path2) => {
+  await fs3.rm(join4(directory, path2), { recursive: true });
 };
 var rmCommandById = (directory) => async (id, version, persistFiles) => rmResourceById(directory, id, version, { type: "command", persistFiles });
 var versionCommand = (directory) => async (id) => versionResource(directory, id);
@@ -281,8 +292,8 @@ var writeQueryToService = (directory) => async (query, service, options = { path
   pathForQuery = join5(pathForQuery, query.id);
   await writeResource(directory, { ...query }, { ...options, path: pathForQuery, type: "query" });
 };
-var rmQuery = (directory) => async (path) => {
-  await fs4.rm(join5(directory, path), { recursive: true });
+var rmQuery = (directory) => async (path2) => {
+  await fs4.rm(join5(directory, path2), { recursive: true });
 };
 var rmQueryById = (directory) => async (id, version, persistFiles) => {
   await rmResourceById(directory, id, version, { type: "query", persistFiles });
@@ -318,8 +329,8 @@ var writeService = (directory) => async (service, options = { path: "" }) => {
 };
 var writeVersionedService = (directory) => async (service) => {
   const resource = { ...service };
-  const path = getVersionedDirectory(service.id, service.version);
-  return await writeService(directory)(resource, { path });
+  const path2 = getVersionedDirectory(service.id, service.version);
+  return await writeService(directory)(resource, { path: path2 });
 };
 var writeServiceToDomain = (directory) => async (service, domain, options = { path: "" }) => {
   let pathForService = domain.version && domain.version !== "latest" ? `/${domain.id}/versioned/${domain.version}/services` : `/${domain.id}/services`;
@@ -327,8 +338,8 @@ var writeServiceToDomain = (directory) => async (service, domain, options = { pa
   await writeResource(directory, { ...service }, { ...options, path: pathForService, type: "service" });
 };
 var versionService = (directory) => async (id) => versionResource(directory, id);
-var rmService = (directory) => async (path) => {
-  await fs5.rm(join6(directory, path), { recursive: true });
+var rmService = (directory) => async (path2) => {
+  await fs5.rm(join6(directory, path2), { 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);
@@ -381,8 +392,8 @@ var addMessageToService = (directory) => async (id, direction, event, version) =
   if (!existingResource) {
     throw new Error(`Cannot find service ${id} in the catalog`);
   }
-  const path = existingResource.split("/services")[0];
-  const pathToResource = join6(path, "services");
+  const path2 = existingResource.split("/services")[0];
+  const pathToResource = join6(path2, "services");
   await rmServiceById(directory)(id, version);
   await writeService(pathToResource)(service);
 };
@@ -408,8 +419,8 @@ var writeDomain = (directory) => async (domain, options = { path: "" }) => {
   return await writeResource(directory, resource, { ...options, type: "domain" });
 };
 var versionDomain = (directory) => async (id) => versionResource(directory, id);
-var rmDomain = (directory) => async (path) => {
-  await fs6.rm(join7(directory, path), { recursive: true });
+var rmDomain = (directory) => async (path2) => {
+  await fs6.rm(join7(directory, path2), { 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);
@@ -437,8 +448,8 @@ 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 (path) => {
-  await fs7.rm(join8(directory, path), { recursive: true });
+var rmChannel = (directory) => async (path2) => {
+  await fs7.rm(join8(directory, path2), { recursive: true });
 };
 var rmChannelById = (directory) => async (id, version, persistFiles) => rmResourceById(directory, id, version, { type: "channel", persistFiles });
 var versionChannel = (directory) => async (id) => versionResource(directory, id);
@@ -477,22 +488,58 @@ var addMessageToChannel = (directory, collection) => async (id, _message, versio
   if (!existingResource) {
     throw new Error(`Cannot find message ${id} in the catalog`);
   }
-  const path = existingResource.split(`/${collection}`)[0];
-  const pathToResource = join8(path, collection);
+  const path2 = existingResource.split(`/${collection}`)[0];
+  const pathToResource = join8(path2, collection);
   await rmMessageById(directory)(_message.id, _message.version, true);
   await writeMessage(pathToResource)(message);
 };
 
-// src/teams.ts
-import fs8 from "node:fs/promises";
+// src/custom-docs.ts
+import path, { join as join9 } from "node:path";
 import fsSync3 from "node:fs";
-import { join as join9 } from "node:path";
+import fs8 from "node:fs/promises";
 import matter3 from "gray-matter";
+import slugify from "slugify";
+var getCustomDoc = (directory) => async (filePath) => {
+  const fullPath = path.join(directory, filePath);
+  const fullPathWithExtension = fullPath.endsWith(".mdx") ? fullPath : `${fullPath}.mdx`;
+  const fileExists = fsSync3.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 = path.join(directory, options.path || "", withExtension);
+  fsSync3.mkdirSync(path.dirname(fullPath), { recursive: true });
+  const document = matter3.stringify(customDoc.markdown.trim(), rest);
+  fsSync3.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 fsSync4 from "node:fs";
+import { join as join10 } from "node:path";
+import matter4 from "gray-matter";
 var getTeam = (catalogDir) => async (id) => {
   const files = await getFiles(`${catalogDir}/${id}.md`);
   if (files.length == 0) return void 0;
   const file = files[0];
-  const { data, content } = matter3.read(file);
+  const { data, content } = matter4.read(file);
   return {
     ...data,
     id: data.id,
@@ -504,7 +551,7 @@ var getTeams = (catalogDir) => async (options) => {
   const files = await getFiles(`${catalogDir}/teams/*.md`);
   if (files.length === 0) return [];
   return files.map((file) => {
-    const { data, content } = matter3.read(file);
+    const { data, content } = matter4.read(file);
     return {
       ...data,
       id: data.id,
@@ -521,23 +568,23 @@ var writeTeam = (catalogDir) => async (team, options = {}) => {
     throw new Error(`Failed to write ${resource.id} (team) as it already exists`);
   }
   const { markdown, ...frontmatter } = resource;
-  const document = matter3.stringify(markdown, frontmatter);
-  fsSync3.mkdirSync(join9(catalogDir, ""), { recursive: true });
-  fsSync3.writeFileSync(join9(catalogDir, "", `${resource.id}.md`), document);
+  const document = matter4.stringify(markdown, frontmatter);
+  fsSync4.mkdirSync(join10(catalogDir, ""), { recursive: true });
+  fsSync4.writeFileSync(join10(catalogDir, "", `${resource.id}.md`), document);
 };
 var rmTeamById = (catalogDir) => async (id) => {
-  await fs8.rm(join9(catalogDir, `${id}.md`), { recursive: true });
+  await fs9.rm(join10(catalogDir, `${id}.md`), { recursive: true });
 };
 
 // src/users.ts
-import fsSync4 from "node:fs";
-import { join as join10 } from "node:path";
-import matter4 from "gray-matter";
+import fsSync5 from "node:fs";
+import { join as join11 } from "node:path";
+import matter5 from "gray-matter";
 var getUser = (catalogDir) => async (id) => {
   const files = await getFiles(`${catalogDir}/${id}.md`);
   if (files.length == 0) return void 0;
   const file = files[0];
-  const { data, content } = matter4.read(file);
+  const { data, content } = matter5.read(file);
   return {
     ...data,
     id: data.id,
@@ -550,7 +597,7 @@ var getUsers = (catalogDir) => async (options) => {
   const files = await getFiles(`${catalogDir}/users/*.md`);
   if (files.length === 0) return [];
   return files.map((file) => {
-    const { data, content } = matter4.read(file);
+    const { data, content } = matter5.read(file);
     return {
       ...data,
       id: data.id,
@@ -568,16 +615,16 @@ var writeUser = (catalogDir) => async (user, options = {}) => {
     throw new Error(`Failed to write ${resource.id} (user) as it already exists`);
   }
   const { markdown, ...frontmatter } = resource;
-  const document = matter4.stringify(markdown, frontmatter);
-  fsSync4.mkdirSync(join10(catalogDir, ""), { recursive: true });
-  fsSync4.writeFileSync(join10(catalogDir, "", `${resource.id}.md`), document);
+  const document = matter5.stringify(markdown, frontmatter);
+  fsSync5.mkdirSync(join11(catalogDir, ""), { recursive: true });
+  fsSync5.writeFileSync(join11(catalogDir, "", `${resource.id}.md`), document);
 };
 var rmUserById = (catalogDir) => async (id) => {
-  fsSync4.rmSync(join10(catalogDir, `${id}.md`), { recursive: true });
+  fsSync5.rmSync(join11(catalogDir, `${id}.md`), { recursive: true });
 };
 
 // src/index.ts
-var index_default = (path) => {
+var index_default = (path2) => {
   return {
     /**
      * Returns an events from EventCatalog
@@ -585,13 +632,13 @@ var index_default = (path) => {
      * @param version - Optional id of the version to get (supports semver)
      * @returns Event|Undefined
      */
-    getEvent: getEvent(join11(path)),
+    getEvent: getEvent(join12(path2)),
     /**
      * Returns all events from EventCatalog
      * @param latestOnly - optional boolean, set to true to get only latest versions
      * @returns Event[]|Undefined
      */
-    getEvents: getEvents(join11(path)),
+    getEvents: getEvents(join12(path2)),
     /**
      * Adds an event to EventCatalog
      *
@@ -599,7 +646,7 @@ var index_default = (path) => {
      * @param options - Optional options to write the event
      *
      */
-    writeEvent: writeEvent(join11(path, "events")),
+    writeEvent: writeEvent(join12(path2, "events")),
     /**
      * Adds an event to a service in EventCatalog
      *
@@ -608,26 +655,26 @@ var index_default = (path) => {
      * @param options - Optional options to write the event
      *
      */
-    writeEventToService: writeEventToService(join11(path, "services")),
+    writeEventToService: writeEventToService(join12(path2, "services")),
     /**
      * 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(join11(path, "events")),
+    rmEvent: rmEvent(join12(path2, "events")),
     /**
      * Remove an event by an Event id
      *
      * @param id - The id of the event you want to remove
      *
      */
-    rmEventById: rmEventById(join11(path)),
+    rmEventById: rmEventById(join12(path2)),
     /**
      * Moves a given event id to the version directory
      * @param directory
      */
-    versionEvent: versionEvent(join11(path)),
+    versionEvent: versionEvent(join12(path2)),
     /**
      * Adds a file to the given event
      * @param id - The id of the event to add the file to
@@ -635,7 +682,7 @@ var index_default = (path) => {
      * @param version - Optional version of the event to add the file to
      * @returns
      */
-    addFileToEvent: addFileToEvent(join11(path)),
+    addFileToEvent: addFileToEvent(join12(path2)),
     /**
      * Adds a schema to the given event
      * @param id - The id of the event to add the schema to
@@ -643,14 +690,14 @@ var index_default = (path) => {
      * @param version - Optional version of the event to add the schema to
      * @returns
      */
-    addSchemaToEvent: addSchemaToEvent(join11(path)),
+    addSchemaToEvent: addSchemaToEvent(join12(path2)),
     /**
      * 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(join11(path)),
+    eventHasVersion: eventHasVersion(join12(path2)),
     /**
      * ================================
      *            Commands
@@ -662,13 +709,13 @@ var index_default = (path) => {
      * @param version - Optional id of the version to get (supports semver)
      * @returns Command|Undefined
      */
-    getCommand: getCommand(join11(path)),
+    getCommand: getCommand(join12(path2)),
     /**
      * Returns all commands from EventCatalog
      * @param latestOnly - optional boolean, set to true to get only latest versions
      * @returns Command[]|Undefined
      */
-    getCommands: getCommands(join11(path)),
+    getCommands: getCommands(join12(path2)),
     /**
      * Adds an command to EventCatalog
      *
@@ -676,7 +723,7 @@ var index_default = (path) => {
      * @param options - Optional options to write the command
      *
      */
-    writeCommand: writeCommand(join11(path, "commands")),
+    writeCommand: writeCommand(join12(path2, "commands")),
     /**
      * Adds a command to a service in EventCatalog
      *
@@ -685,26 +732,26 @@ var index_default = (path) => {
      * @param options - Optional options to write the command
      *
      */
-    writeCommandToService: writeCommandToService(join11(path, "services")),
+    writeCommandToService: writeCommandToService(join12(path2, "services")),
     /**
      * 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(join11(path, "commands")),
+    rmCommand: rmCommand(join12(path2, "commands")),
     /**
      * Remove an command by an Event id
      *
      * @param id - The id of the command you want to remove
      *
      */
-    rmCommandById: rmCommandById(join11(path)),
+    rmCommandById: rmCommandById(join12(path2)),
     /**
      * Moves a given command id to the version directory
      * @param directory
      */
-    versionCommand: versionCommand(join11(path)),
+    versionCommand: versionCommand(join12(path2)),
     /**
      * Adds a file to the given command
      * @param id - The id of the command to add the file to
@@ -712,7 +759,7 @@ var index_default = (path) => {
      * @param version - Optional version of the command to add the file to
      * @returns
      */
-    addFileToCommand: addFileToCommand(join11(path)),
+    addFileToCommand: addFileToCommand(join12(path2)),
     /**
      * Adds a schema to the given command
      * @param id - The id of the command to add the schema to
@@ -720,14 +767,14 @@ var index_default = (path) => {
      * @param version - Optional version of the command to add the schema to
      * @returns
      */
-    addSchemaToCommand: addSchemaToCommand(join11(path)),
+    addSchemaToCommand: addSchemaToCommand(join12(path2)),
     /**
      * 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(join11(path)),
+    commandHasVersion: commandHasVersion(join12(path2)),
     /**
      * ================================
      *            Queries
@@ -739,13 +786,13 @@ var index_default = (path) => {
      * @param version - Optional id of the version to get (supports semver)
      * @returns Query|Undefined
      */
-    getQuery: getQuery(join11(path)),
+    getQuery: getQuery(join12(path2)),
     /**
      * Returns all queries from EventCatalog
      * @param latestOnly - optional boolean, set to true to get only latest versions
      * @returns Query[]|Undefined
      */
-    getQueries: getQueries(join11(path)),
+    getQueries: getQueries(join12(path2)),
     /**
      * Adds a query to EventCatalog
      *
@@ -753,7 +800,7 @@ var index_default = (path) => {
      * @param options - Optional options to write the event
      *
      */
-    writeQuery: writeQuery(join11(path, "queries")),
+    writeQuery: writeQuery(join12(path2, "queries")),
     /**
      * Adds a query to a service in EventCatalog
      *
@@ -762,26 +809,26 @@ var index_default = (path) => {
      * @param options - Optional options to write the query
      *
      */
-    writeQueryToService: writeQueryToService(join11(path, "services")),
+    writeQueryToService: writeQueryToService(join12(path2, "services")),
     /**
      * 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(join11(path, "queries")),
+    rmQuery: rmQuery(join12(path2, "queries")),
     /**
      * Remove a query by a Query id
      *
      * @param id - The id of the query you want to remove
      *
      */
-    rmQueryById: rmQueryById(join11(path)),
+    rmQueryById: rmQueryById(join12(path2)),
     /**
      * Moves a given query id to the version directory
      * @param directory
      */
-    versionQuery: versionQuery(join11(path)),
+    versionQuery: versionQuery(join12(path2)),
     /**
      * Adds a file to the given query
      * @param id - The id of the query to add the file to
@@ -789,7 +836,7 @@ var index_default = (path) => {
      * @param version - Optional version of the query to add the file to
      * @returns
      */
-    addFileToQuery: addFileToQuery(join11(path)),
+    addFileToQuery: addFileToQuery(join12(path2)),
     /**
      * Adds a schema to the given query
      * @param id - The id of the query to add the schema to
@@ -797,14 +844,14 @@ var index_default = (path) => {
      * @param version - Optional version of the query to add the schema to
      * @returns
      */
-    addSchemaToQuery: addSchemaToQuery(join11(path)),
+    addSchemaToQuery: addSchemaToQuery(join12(path2)),
     /**
      * 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(join11(path)),
+    queryHasVersion: queryHasVersion(join12(path2)),
     /**
      * ================================
      *            Channels
@@ -816,13 +863,13 @@ var index_default = (path) => {
      * @param version - Optional id of the version to get (supports semver)
      * @returns Channel|Undefined
      */
-    getChannel: getChannel(join11(path)),
+    getChannel: getChannel(join12(path2)),
     /**
      * Returns all channels from EventCatalog
      * @param latestOnly - optional boolean, set to true to get only latest versions
      * @returns Channel[]|Undefined
      */
-    getChannels: getChannels(join11(path)),
+    getChannels: getChannels(join12(path2)),
     /**
      * Adds an channel to EventCatalog
      *
@@ -830,33 +877,33 @@ var index_default = (path) => {
      * @param options - Optional options to write the channel
      *
      */
-    writeChannel: writeChannel(join11(path, "channels")),
+    writeChannel: writeChannel(join12(path2, "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(join11(path, "channels")),
+    rmChannel: rmChannel(join12(path2, "channels")),
     /**
      * Remove an channel by an Event id
      *
      * @param id - The id of the channel you want to remove
      *
      */
-    rmChannelById: rmChannelById(join11(path)),
+    rmChannelById: rmChannelById(join12(path2)),
     /**
      * Moves a given channel id to the version directory
      * @param directory
      */
-    versionChannel: versionChannel(join11(path)),
+    versionChannel: versionChannel(join12(path2)),
     /**
      * 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(join11(path)),
+    channelHasVersion: channelHasVersion(join12(path2)),
     /**
      * Add a channel to an event
      *
@@ -873,7 +920,7 @@ var index_default = (path) => {
      *
      * ```
      */
-    addEventToChannel: addMessageToChannel(join11(path), "events"),
+    addEventToChannel: addMessageToChannel(join12(path2), "events"),
     /**
      * Add a channel to an command
      *
@@ -890,7 +937,7 @@ var index_default = (path) => {
      *
      * ```
      */
-    addCommandToChannel: addMessageToChannel(join11(path), "commands"),
+    addCommandToChannel: addMessageToChannel(join12(path2), "commands"),
     /**
      * Add a channel to an query
      *
@@ -907,7 +954,7 @@ var index_default = (path) => {
      *
      * ```
      */
-    addQueryToChannel: addMessageToChannel(join11(path), "queries"),
+    addQueryToChannel: addMessageToChannel(join12(path2), "queries"),
     /**
      * ================================
      *            SERVICES
@@ -920,14 +967,14 @@ var index_default = (path) => {
      * @param options - Optional options to write the event
      *
      */
-    writeService: writeService(join11(path, "services")),
+    writeService: writeService(join12(path2, "services")),
     /**
      * Adds a versioned service to EventCatalog
      *
      * @param service - The service to write
      *
      */
-    writeVersionedService: writeVersionedService(join11(path, "services")),
+    writeVersionedService: writeVersionedService(join12(path2, "services")),
     /**
      * Adds a service to a domain in EventCatalog
      *
@@ -936,39 +983,39 @@ var index_default = (path) => {
      * @param options - Optional options to write the event
      *
      */
-    writeServiceToDomain: writeServiceToDomain(join11(path, "domains")),
+    writeServiceToDomain: writeServiceToDomain(join12(path2, "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(join11(path)),
+    getService: getService(join12(path2)),
     /**
      * Returns all services from EventCatalog
      * @param latestOnly - optional boolean, set to true to get only latest versions
      * @returns Service[]|Undefined
      */
-    getServices: getServices(join11(path)),
+    getServices: getServices(join12(path2)),
     /**
      * Moves a given service id to the version directory
      * @param directory
      */
-    versionService: versionService(join11(path)),
+    versionService: versionService(join12(path2)),
     /**
      * Remove a service from EventCatalog (modeled on the standard POSIX rm utility)
      *
      * @param path - The path to your service, e.g. `/InventoryService`
      *
      */
-    rmService: rmService(join11(path, "services")),
+    rmService: rmService(join12(path2, "services")),
     /**
      * Remove an service by an service id
      *
      * @param id - The id of the service you want to remove
      *
      */
-    rmServiceById: rmServiceById(join11(path)),
+    rmServiceById: rmServiceById(join12(path2)),
     /**
      * Adds a file to the given service
      * @param id - The id of the service to add the file to
@@ -976,21 +1023,21 @@ var index_default = (path) => {
      * @param version - Optional version of the service to add the file to
      * @returns
      */
-    addFileToService: addFileToService(join11(path)),
+    addFileToService: addFileToService(join12(path2)),
     /**
      * 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(join11(path)),
+    getSpecificationFilesForService: getSpecificationFilesForService(join12(path2)),
     /**
      * 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(join11(path)),
+    serviceHasVersion: serviceHasVersion(join12(path2)),
     /**
      * Add an event to a service by it's id.
      *
@@ -1010,7 +1057,7 @@ var index_default = (path) => {
      *
      * ```
      */
-    addEventToService: addMessageToService(join11(path)),
+    addEventToService: addMessageToService(join12(path2)),
     /**
      * Add a command to a service by it's id.
      *
@@ -1030,7 +1077,7 @@ var index_default = (path) => {
      *
      * ```
      */
-    addCommandToService: addMessageToService(join11(path)),
+    addCommandToService: addMessageToService(join12(path2)),
     /**
      * Add a query to a service by it's id.
      *
@@ -1050,7 +1097,7 @@ var index_default = (path) => {
      *
      * ```
      */
-    addQueryToService: addMessageToService(join11(path)),
+    addQueryToService: addMessageToService(join12(path2)),
     /**
      * ================================
      *            Domains
@@ -1063,39 +1110,39 @@ var index_default = (path) => {
      * @param options - Optional options to write the event
      *
      */
-    writeDomain: writeDomain(join11(path, "domains")),
+    writeDomain: writeDomain(join12(path2, "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(join11(path, "domains")),
+    getDomain: getDomain(join12(path2, "domains")),
     /**
      * Returns all domains from EventCatalog
      * @param latestOnly - optional boolean, set to true to get only latest versions
      * @returns Domain[]|Undefined
      */
-    getDomains: getDomains(join11(path)),
+    getDomains: getDomains(join12(path2)),
     /**
      * Moves a given domain id to the version directory
      * @param directory
      */
-    versionDomain: versionDomain(join11(path, "domains")),
+    versionDomain: versionDomain(join12(path2, "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(join11(path, "domains")),
+    rmDomain: rmDomain(join12(path2, "domains")),
     /**
      * Remove an service by an domain id
      *
      * @param id - The id of the domain you want to remove
      *
      */
-    rmDomainById: rmDomainById(join11(path, "domains")),
+    rmDomainById: rmDomainById(join12(path2, "domains")),
     /**
      * Adds a file to the given domain
      * @param id - The id of the domain to add the file to
@@ -1103,14 +1150,14 @@ var index_default = (path) => {
      * @param version - Optional version of the domain to add the file to
      * @returns
      */
-    addFileToDomain: addFileToDomain(join11(path, "domains")),
+    addFileToDomain: addFileToDomain(join12(path2, "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(join11(path)),
+    domainHasVersion: domainHasVersion(join12(path2)),
     /**
      * Adds a given service to a domain
      * @param id - The id of the domain
@@ -1118,7 +1165,7 @@ var index_default = (path) => {
      * @param version - (Optional) The version of the domain to add the service to
      * @returns
      */
-    addServiceToDomain: addServiceToDomain(join11(path, "domains")),
+    addServiceToDomain: addServiceToDomain(join12(path2, "domains")),
     /**
      * ================================
      *            Teams
@@ -1131,25 +1178,25 @@ var index_default = (path) => {
      * @param options - Optional options to write the team
      *
      */
-    writeTeam: writeTeam(join11(path, "teams")),
+    writeTeam: writeTeam(join12(path2, "teams")),
     /**
      * Returns a team from EventCatalog
      * @param id - The id of the team to retrieve
      * @returns Team|Undefined
      */
-    getTeam: getTeam(join11(path, "teams")),
+    getTeam: getTeam(join12(path2, "teams")),
     /**
      * Returns all teams from EventCatalog
      * @returns Team[]|Undefined
      */
-    getTeams: getTeams(join11(path)),
+    getTeams: getTeams(join12(path2)),
     /**
      * Remove a team by the team id
      *
      * @param id - The id of the team you want to remove
      *
      */
-    rmTeamById: rmTeamById(join11(path, "teams")),
+    rmTeamById: rmTeamById(join12(path2, "teams")),
     /**
      * ================================
      *            Users
@@ -1162,25 +1209,55 @@ var index_default = (path) => {
      * @param options - Optional options to write the user
      *
      */
-    writeUser: writeUser(join11(path, "users")),
+    writeUser: writeUser(join12(path2, "users")),
     /**
      * Returns a user from EventCatalog
      * @param id - The id of the user to retrieve
      * @returns User|Undefined
      */
-    getUser: getUser(join11(path, "users")),
+    getUser: getUser(join12(path2, "users")),
     /**
      * Returns all user from EventCatalog
      * @returns User[]|Undefined
      */
-    getUsers: getUsers(join11(path)),
+    getUsers: getUsers(join12(path2)),
     /**
      * Remove a user by the user id
      *
      * @param id - The id of the user you want to remove
      *
      */
-    rmUserById: rmUserById(join11(path, "users"))
+    rmUserById: rmUserById(join12(path2, "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(path2, "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(path2, "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(path2, "docs")),
+    /**
+     * Removes a custom doc from EventCatalog
+     * @param path - The path to the custom doc to remove
+     *
+     */
+    rmCustomDoc: rmCustomDoc(join12(path2, "docs"))
   };
 };
 export {