@eventcatalog/sdk 0.0.3 → 0.0.4

package/dist/services.mjs

@@ -0,0 +1,133 @@
+// src/services.ts
+import matter from "gray-matter";
+
+// src/internal/utils.ts
+import { glob } from "glob";
+import fs from "fs/promises";
+import { copy } from "fs-extra";
+import { join } from "path";
+var versionExists = async (catalogDir, id, version) => {
+  const files = await getFiles(`${catalogDir}/**/index.md`);
+  const matchedFiles = await searchFilesForId(files, id, version) || [];
+  return matchedFiles.length > 0;
+};
+var findFileById = async (catalogDir, id, version) => {
+  const files = await getFiles(`${catalogDir}/**/index.md`);
+  const matchedFiles = await searchFilesForId(files, id) || [];
+  if (!version) {
+    return matchedFiles.find((path) => !path.includes("versioned"));
+  }
+  return matchedFiles.find((path) => path.includes(`versioned/${version}`));
+};
+var getFiles = async (pattern) => {
+  try {
+    const files = await glob(pattern, { ignore: "node_modules/**" });
+    return files;
+  } catch (error) {
+    throw new Error(`Error finding files: ${error}`);
+  }
+};
+var searchFilesForId = async (files, id, version) => {
+  const idRegex = new RegExp(`^id:\\s*['"]?${id}['"]?\\s*$`, "m");
+  const versionRegex = new RegExp(`^version:\\s*['"]?${version}['"]?\\s*$`, "m");
+  const matches = await Promise.all(
+    files.map(async (file) => {
+      const content = await fs.readFile(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");
+  await fs.mkdir(tmpDirectory, { recursive: true });
+  await copy(source, tmpDirectory, {
+    overwrite: true,
+    filter
+  });
+  await copy(tmpDirectory, target, {
+    overwrite: true,
+    filter
+  });
+  await fs.rm(tmpDirectory, { recursive: true });
+};
+
+// src/services.ts
+import fs2 from "fs/promises";
+import { dirname, join as join2 } from "path";
+var getService = (directory) => async (id, version) => {
+  const file = await findFileById(directory, id, version);
+  if (!file) throw new Error(`No service found for the given id: ${id}` + (version ? ` and version ${version}` : ""));
+  const { data, content } = matter.read(file);
+  return {
+    ...data,
+    markdown: content.trim()
+  };
+};
+var writeService = (directory) => async (service, options = { path: "" }) => {
+  const path = options.path || `/${service.id}`;
+  const exists = await versionExists(directory, service.id, service.version);
+  if (exists) {
+    throw new Error(`Failed to write service as the version ${service.version} already exists`);
+  }
+  const { markdown, ...frontmatter } = service;
+  const document = matter.stringify(markdown.trim(), frontmatter);
+  await fs2.mkdir(join2(directory, path), { recursive: true });
+  await fs2.writeFile(join2(directory, path, "index.md"), document);
+};
+var versionService = (directory) => async (id) => {
+  const files = await getFiles(`${directory}/**/index.md`);
+  const matchedFiles = await searchFilesForId(files, id);
+  if (matchedFiles.length === 0) {
+    throw new Error(`No service found with id: ${id}`);
+  }
+  const file = matchedFiles[0];
+  const eventDirectory = dirname(file);
+  const { data: { version = "0.0.1" } = {} } = matter.read(file);
+  const targetDirectory = join2(eventDirectory, "versioned", version);
+  await fs2.mkdir(targetDirectory, { recursive: true });
+  await copyDir(directory, eventDirectory, targetDirectory, (src) => {
+    return !src.includes("versioned");
+  });
+  await fs2.readdir(eventDirectory).then(async (resourceFiles) => {
+    await Promise.all(
+      resourceFiles.map(async (file2) => {
+        if (file2 !== "versioned") {
+          await fs2.rm(join2(eventDirectory, file2), { recursive: true });
+        }
+      })
+    );
+  });
+};
+var rmService = (directory) => async (path) => {
+  await fs2.rm(join2(directory, path), { recursive: true });
+};
+var rmServiceById = (directory) => async (id, version) => {
+  const files = await getFiles(`${directory}/**/index.md`);
+  const matchedFiles = await searchFilesForId(files, id, version);
+  if (matchedFiles.length === 0) {
+    throw new Error(`No service found with id: ${id}`);
+  }
+  await Promise.all(matchedFiles.map((file) => fs2.rm(file)));
+};
+var addFileToService = (directory) => async (id, file, version) => {
+  const pathToEvent = await findFileById(directory, id, version);
+  if (!pathToEvent) throw new Error("Cannot find directory to write file to");
+  const contentDirectory = dirname(pathToEvent);
+  await fs2.writeFile(join2(contentDirectory, file.fileName), file.content);
+};
+export {
+  addFileToService,
+  getService,
+  rmService,
+  rmServiceById,
+  versionService,
+  writeService
+};
+//# sourceMappingURL=services.mjs.map

package/dist/services.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/services.ts","../src/internal/utils.ts"],"sourcesContent":["import matter from 'gray-matter';\nimport { copyDir, findFileById, getFiles, searchFilesForId, versionExists } from './internal/utils';\nimport type { Service } from './types';\nimport fs from 'node:fs/promises';\nimport { dirname, join } from 'node:path';\n\n/**\n * Returns a service from EventCatalog.\n *\n * You can optionally specify a version to get a specific version of the service\n *\n * @example\n * ```ts\n * import utils from '@eventcatalog/utils';\n *\n * const { getService } = utils('/path/to/eventcatalog');\n *\n * // Gets the latest version of the event\n * cont event = await getService('InventoryService');\n *\n * // Gets a version of the event\n * cont event = await getService('InventoryService', '0.0.1');\n * ```\n */\nexport const getService =\n  (directory: string) =>\n  async (id: string, version?: string): Promise<Service> => {\n    const file = await findFileById(directory, id, version);\n\n    if (!file) throw new Error(`No service found for the given id: ${id}` + (version ? ` and version ${version}` : ''));\n\n    const { data, content } = matter.read(file);\n\n    return {\n      ...data,\n      markdown: content.trim(),\n    } as Service;\n  };\n\n/**\n * Write an event to EventCatalog.\n *\n * You can optionally overide the path of the event.\n *\n * @example\n * ```ts\n * import utils from '@eventcatalog/utils';\n *\n * const { writeService } = utils('/path/to/eventcatalog');\n *\n * // Write a service\n * // Event would be written to services/InventoryService\n * await writeService({\n *   id: 'InventoryService',\n *   name: 'Inventory Service',\n *   version: '0.0.1',\n *   summary: 'Service that handles the inventory',\n *   markdown: '# Hello world',\n * });\n *\n * // Write an event to the catalog but override the path\n * // Event would be written to services/Inventory/InventoryService\n * await writeService({\n *    id: 'InventoryService',\n *    name: 'Inventory Adjusted',\n *    version: '0.0.1',\n *    summary: 'This is a summary',\n *    markdown: '# Hello world',\n * }, { path: \"/Inventory/InventoryService\"});\n * ```\n */\nexport const writeService =\n  (directory: string) =>\n  async (service: Service, options: { path: string } = { path: '' }) => {\n    // Get the path\n    const path = options.path || `/${service.id}`;\n    const exists = await versionExists(directory, service.id, service.version);\n\n    if (exists) {\n      throw new Error(`Failed to write service as the version ${service.version} already exists`);\n    }\n\n    const { markdown, ...frontmatter } = service;\n    const document = matter.stringify(markdown.trim(), frontmatter);\n    await fs.mkdir(join(directory, path), { recursive: true });\n    await fs.writeFile(join(directory, path, 'index.md'), document);\n  };\n\n/**\n * Version a service by it's id.\n *\n * Takes the latest service and moves it to a versioned directory.\n * All files with this service are also versioned. (e.g /services/InventoryService/openapi.yml)\n *\n * @example\n * ```ts\n * import utils from '@eventcatalog/utils';\n *\n * const { versionService } = utils('/path/to/eventcatalog');\n *\n * // moves the latest InventoryService service to a versioned directory\n * // the version within that service is used as the version number.\n * await versionService('InventoryService');\n *\n * ```\n */\nexport const versionService = (directory: string) => async (id: string) => {\n  // Find all the events in the directory\n  const files = await getFiles(`${directory}/**/index.md`);\n  const matchedFiles = await searchFilesForId(files, id);\n\n  if (matchedFiles.length === 0) {\n    throw new Error(`No service found with id: ${id}`);\n  }\n\n  // Service that is in the route of the project\n  const file = matchedFiles[0];\n  const eventDirectory = dirname(file);\n  const { data: { version = '0.0.1' } = {} } = matter.read(file);\n  const targetDirectory = join(eventDirectory, 'versioned', version);\n\n  await fs.mkdir(targetDirectory, { recursive: true });\n\n  // Copy the service to the versioned directory\n  await copyDir(directory, eventDirectory, targetDirectory, (src) => {\n    return !src.includes('versioned');\n  });\n\n  // Remove all the files in the root of the resource as they have now been versioned\n  await fs.readdir(eventDirectory).then(async (resourceFiles) => {\n    await Promise.all(\n      resourceFiles.map(async (file) => {\n        if (file !== 'versioned') {\n          await fs.rm(join(eventDirectory, file), { recursive: true });\n        }\n      })\n    );\n  });\n};\n\n/**\n * Delete a service at it's given path.\n *\n * @example\n * ```ts\n * import utils from '@eventcatalog/utils';\n *\n * const { rmService } = utils('/path/to/eventcatalog');\n *\n * // Removes the service at services/InventoryService\n * await rmService('/InventoryService');\n * ```\n */\nexport const rmService = (directory: string) => async (path: string) => {\n  await fs.rm(join(directory, path), { recursive: true });\n};\n\n/**\n * Delete a service by it's id.\n *\n * Optionally specify a version to delete a specific version of the service.\n *\n * @example\n * ```ts\n * import utils from '@eventcatalog/utils';\n *\n * const { rmServiceById } = utils('/path/to/eventcatalog');\n *\n * // deletes the latest InventoryService event\n * await rmServiceById('InventoryService');\n *\n * // deletes a specific version of the InventoryService event\n * await rmServiceById('InventoryService', '0.0.1');\n * ```\n */\nexport const rmServiceById = (directory: string) => async (id: string, version?: string) => {\n  // Find all the events in the directory\n  const files = await getFiles(`${directory}/**/index.md`);\n\n  const matchedFiles = await searchFilesForId(files, id, version);\n\n  if (matchedFiles.length === 0) {\n    throw new Error(`No service found with id: ${id}`);\n  }\n\n  await Promise.all(matchedFiles.map((file) => fs.rm(file)));\n};\n\n/**\n * Add a file to a service by it's id.\n *\n * Optionally specify a version to add a file to a specific version of the service.\n *\n * @example\n * ```ts\n * import utils from '@eventcatalog/utils';\n *\n * const { addFileToService } = utils('/path/to/eventcatalog');\n *\n * // adds a file to the latest InventoryService event\n * await addFileToService('InventoryService', { content: 'Hello world', fileName: 'hello.txt' });\n *\n * // adds a file to a specific version of the InventoryService event\n * await addFileToService('InventoryService', { content: 'Hello world', fileName: 'hello.txt' }, '0.0.1');\n *\n * ```\n */\nexport const addFileToService =\n  (directory: string) => async (id: string, file: { content: string; fileName: string }, version?: string) => {\n    const pathToEvent = await findFileById(directory, id, version);\n    if (!pathToEvent) throw new Error('Cannot find directory to write file to');\n    const contentDirectory = dirname(pathToEvent);\n    await fs.writeFile(join(contentDirectory, file.fileName), file.content);\n  };\n","import { glob } from 'glob';\nimport fs from 'node:fs/promises';\nimport { copy, CopyFilterAsync, CopyFilterSync } from 'fs-extra';\nimport { join } from 'node:path';\n\n/**\n * Returns true if a given version of a resource id exists in the catalog\n */\nexport const versionExists = async (catalogDir: string, id: string, version: string) => {\n  const files = await getFiles(`${catalogDir}/**/index.md`);\n  const matchedFiles = (await searchFilesForId(files, id, version)) || [];\n  return matchedFiles.length > 0;\n};\n\nexport const findFileById = async (catalogDir: string, id: string, version?: string): Promise<string | undefined> => {\n  const files = await getFiles(`${catalogDir}/**/index.md`);\n  const matchedFiles = (await searchFilesForId(files, id)) || [];\n\n  // Return the latest one\n  if (!version) {\n    return matchedFiles.find((path) => !path.includes('versioned'));\n  }\n\n  // Find the versioned event\n  return matchedFiles.find((path) => path.includes(`versioned/${version}`));\n};\n\nexport const getFiles = async (pattern: string) => {\n  try {\n    const files = await glob(pattern, { ignore: 'node_modules/**' });\n    return files;\n  } catch (error) {\n    throw new Error(`Error finding files: ${error}`);\n  }\n};\n\nexport const searchFilesForId = async (files: string[], id: string, version?: string) => {\n  const idRegex = new RegExp(`^id:\\\\s*['\"]?${id}['\"]?\\\\s*$`, 'm');\n  const versionRegex = new RegExp(`^version:\\\\s*['\"]?${version}['\"]?\\\\s*$`, 'm');\n\n  const matches = await Promise.all(\n    files.map(async (file) => {\n      const content = await fs.readFile(file, 'utf-8');\n      const hasIdMatch = content.match(idRegex);\n\n      // Check version if provided\n      if (version && !content.match(versionRegex)) {\n        return undefined;\n      }\n\n      if (hasIdMatch) {\n        return file;\n      }\n    })\n  );\n\n  return matches.filter(Boolean).filter((file) => file !== undefined);\n};\n\n/**\n * Function to copy a directory from source to target, uses a tmp directory\n * @param catalogDir\n * @param source\n * @param target\n * @param filter\n */\nexport const copyDir = async (catalogDir: string, source: string, target: string, filter?: CopyFilterAsync | CopyFilterSync) => {\n  const tmpDirectory = join(catalogDir, 'tmp');\n  await fs.mkdir(tmpDirectory, { recursive: true });\n\n  // Copy everything over\n  await copy(source, tmpDirectory, {\n    overwrite: true,\n    filter,\n  });\n\n  await copy(tmpDirectory, target, {\n    overwrite: true,\n    filter,\n  });\n\n  // Remove the tmp directory\n  await fs.rm(tmpDirectory, { recursive: true });\n};\n"],"mappings":"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","names":["fs","join","file"]}

package/dist/test/events.test.js

@@ -16066,7 +16066,7 @@ var VitestIndex = /* @__PURE__ */ Object.freeze({
 var expectTypeOf = dist.expectTypeOf;
 
 // src/index.ts
-var import_node_path4 = require("path");
+var import_node_path5 = require("path");
 
 // src/events.ts
 var import_gray_matter = __toESM(require("gray-matter"));
@@ -16197,6 +16197,72 @@ var addSchemaToEvent = (directory) => async (id, schema, version) => {
   await addFileToEvent(directory)(id, { content: schema.schema, fileName: schema.fileName }, version);
 };
 
+// src/services.ts
+var import_gray_matter2 = __toESM(require("gray-matter"));
+var import_promises3 = __toESM(require("fs/promises"));
+var import_node_path4 = require("path");
+var getService = (directory) => async (id, version) => {
+  const file = await findFileById(directory, id, version);
+  if (!file) throw new Error(`No service found for the given id: ${id}` + (version ? ` and version ${version}` : ""));
+  const { data, content } = import_gray_matter2.default.read(file);
+  return {
+    ...data,
+    markdown: content.trim()
+  };
+};
+var writeService = (directory) => async (service, options = { path: "" }) => {
+  const path3 = options.path || `/${service.id}`;
+  const exists = await versionExists(directory, service.id, service.version);
+  if (exists) {
+    throw new Error(`Failed to write service as the version ${service.version} already exists`);
+  }
+  const { markdown, ...frontmatter } = service;
+  const document = import_gray_matter2.default.stringify(markdown.trim(), frontmatter);
+  await import_promises3.default.mkdir((0, import_node_path4.join)(directory, path3), { recursive: true });
+  await import_promises3.default.writeFile((0, import_node_path4.join)(directory, path3, "index.md"), document);
+};
+var versionService = (directory) => async (id) => {
+  const files = await getFiles(`${directory}/**/index.md`);
+  const matchedFiles = await searchFilesForId(files, id);
+  if (matchedFiles.length === 0) {
+    throw new Error(`No service found with id: ${id}`);
+  }
+  const file = matchedFiles[0];
+  const eventDirectory = (0, import_node_path4.dirname)(file);
+  const { data: { version = "0.0.1" } = {} } = import_gray_matter2.default.read(file);
+  const targetDirectory = (0, import_node_path4.join)(eventDirectory, "versioned", version);
+  await import_promises3.default.mkdir(targetDirectory, { recursive: true });
+  await copyDir(directory, eventDirectory, targetDirectory, (src) => {
+    return !src.includes("versioned");
+  });
+  await import_promises3.default.readdir(eventDirectory).then(async (resourceFiles) => {
+    await Promise.all(
+      resourceFiles.map(async (file2) => {
+        if (file2 !== "versioned") {
+          await import_promises3.default.rm((0, import_node_path4.join)(eventDirectory, file2), { recursive: true });
+        }
+      })
+    );
+  });
+};
+var rmService = (directory) => async (path3) => {
+  await import_promises3.default.rm((0, import_node_path4.join)(directory, path3), { recursive: true });
+};
+var rmServiceById = (directory) => async (id, version) => {
+  const files = await getFiles(`${directory}/**/index.md`);
+  const matchedFiles = await searchFilesForId(files, id, version);
+  if (matchedFiles.length === 0) {
+    throw new Error(`No service found with id: ${id}`);
+  }
+  await Promise.all(matchedFiles.map((file) => import_promises3.default.rm(file)));
+};
+var addFileToService = (directory) => async (id, file, version) => {
+  const pathToEvent = await findFileById(directory, id, version);
+  if (!pathToEvent) throw new Error("Cannot find directory to write file to");
+  const contentDirectory = (0, import_node_path4.dirname)(pathToEvent);
+  await import_promises3.default.writeFile((0, import_node_path4.join)(contentDirectory, file.fileName), file.content);
+};
+
 // src/index.ts
 var src_default = (path3) => {
   return {
@@ -16206,7 +16272,7 @@ var src_default = (path3) => {
      * @param version - Optional id of the version to get
      * @returns
      */
-    getEvent: getEvent((0, import_node_path4.join)(path3, "events")),
+    getEvent: getEvent((0, import_node_path5.join)(path3, "events")),
     /**
      * Adds an event to EventCatalog
      *
@@ -16214,26 +16280,26 @@ var src_default = (path3) => {
      * @param options - Optional options to write the event
      *
      */
-    writeEvent: writeEvent((0, import_node_path4.join)(path3, "events")),
+    writeEvent: writeEvent((0, import_node_path5.join)(path3, "events")),
     /**
      * 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_path4.join)(path3, "events")),
+    rmEvent: rmEvent((0, import_node_path5.join)(path3, "events")),
     /**
      * Remove an event by an Event id
      *
      * @param id - The id of the event you want to remove
      *
      */
-    rmEventById: rmEventById((0, import_node_path4.join)(path3, "events")),
+    rmEventById: rmEventById((0, import_node_path5.join)(path3, "events")),
     /**
      * Moves a given event id to the version directory
      * @param directory
      */
-    versionEvent: versionEvent((0, import_node_path4.join)(path3, "events")),
+    versionEvent: versionEvent((0, import_node_path5.join)(path3, "events")),
     /**
      * Adds a file to the given event
      * @param id - The id of the event to add the file to
@@ -16241,7 +16307,7 @@ var src_default = (path3) => {
      * @param version - Optional version of the event to add the file to
      * @returns
      */
-    addFileToEvent: addFileToEvent((0, import_node_path4.join)(path3, "events")),
+    addFileToEvent: addFileToEvent((0, import_node_path5.join)(path3, "events")),
     /**
      * Adds a schema to the given event
      * @param id - The id of the event to add the schema to
@@ -16249,20 +16315,68 @@ var src_default = (path3) => {
      * @param version - Optional version of the event to add the schema to
      * @returns
      */
-    addSchemaToEvent: addSchemaToEvent((0, import_node_path4.join)(path3, "events"))
+    addSchemaToEvent: addSchemaToEvent((0, import_node_path5.join)(path3, "events")),
+    /**
+     * ================================
+     *            SERVICES
+     * ================================
+     */
+    /**
+     * Adds a service to EventCatalog
+     *
+     * @param service - The service to write
+     * @param options - Optional options to write the event
+     *
+     */
+    writeService: writeService((0, import_node_path5.join)(path3, "services")),
+    /**
+     * Returns a service from EventCatalog
+     * @param id - The id of the service to retrieve
+     * @param version - Optional id of the version to get
+     * @returns
+     */
+    getService: getService((0, import_node_path5.join)(path3, "services")),
+    /**
+     * Moves a given service id to the version directory
+     * @param directory
+     */
+    versionService: versionService((0, import_node_path5.join)(path3, "services")),
+    /**
+     * 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_path5.join)(path3, "services")),
+    /**
+     * Remove an service by an service id
+     *
+     * @param id - The id of the service you want to remove
+     *
+     */
+    rmServiceById: rmServiceById((0, import_node_path5.join)(path3, "services")),
+    /**
+     * 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((0, import_node_path5.join)(path3, "services"))
   };
 };
 
 // src/test/events.test.ts
-var import_node_path5 = __toESM(require("path"));
+var import_node_path6 = __toESM(require("path"));
 var import_node_fs = __toESM(require("fs"));
-var CATALOG_PATH = import_node_path5.default.join(__dirname, "catalog");
+var CATALOG_PATH = import_node_path6.default.join(__dirname, "catalog-events");
 var { writeEvent: writeEvent2, getEvent: getEvent2, rmEvent: rmEvent2, rmEventById: rmEventById2, versionEvent: versionEvent2, addFileToEvent: addFileToEvent2, addSchemaToEvent: addSchemaToEvent2 } = src_default(CATALOG_PATH);
 beforeEach(() => {
   import_node_fs.default.rmSync(CATALOG_PATH, { recursive: true, force: true });
   import_node_fs.default.mkdirSync(CATALOG_PATH, { recursive: true });
 });
 afterEach(() => {
+  import_node_fs.default.rmSync(CATALOG_PATH, { recursive: true, force: true });
 });
 describe("Events SDK", () => {
   describe("getEvent", () => {
@@ -16334,7 +16448,7 @@ describe("Events SDK", () => {
         markdown: "# Hello world"
       });
       const event = await getEvent2("InventoryAdjusted");
-      globalExpect(import_node_fs.default.existsSync(import_node_path5.default.join(CATALOG_PATH, "events/InventoryAdjusted", "index.md"))).toBe(true);
+      globalExpect(import_node_fs.default.existsSync(import_node_path6.default.join(CATALOG_PATH, "events/InventoryAdjusted", "index.md"))).toBe(true);
       globalExpect(event).toEqual({
         id: "InventoryAdjusted",
         name: "Inventory Adjusted",
@@ -16354,7 +16468,7 @@ describe("Events SDK", () => {
         },
         { path: "/Inventory/InventoryAdjusted" }
       );
-      globalExpect(import_node_fs.default.existsSync(import_node_path5.default.join(CATALOG_PATH, "events/Inventory/InventoryAdjusted", "index.md"))).toBe(true);
+      globalExpect(import_node_fs.default.existsSync(import_node_path6.default.join(CATALOG_PATH, "events/Inventory/InventoryAdjusted", "index.md"))).toBe(true);
     });
     it("throws an error when trying to write an event that already exists", async () => {
       const createEvent = async () => writeEvent2({
@@ -16385,9 +16499,9 @@ describe("Events SDK", () => {
         summary: "This is a summary",
         markdown: "# Hello world"
       });
-      globalExpect(import_node_fs.default.existsSync(import_node_path5.default.join(CATALOG_PATH, "events/InventoryAdjusted", "index.md"))).toBe(true);
+      globalExpect(import_node_fs.default.existsSync(import_node_path6.default.join(CATALOG_PATH, "events/InventoryAdjusted", "index.md"))).toBe(true);
       await rmEvent2("/InventoryAdjusted");
-      globalExpect(import_node_fs.default.existsSync(import_node_path5.default.join(CATALOG_PATH, "events/InventoryAdjusted", "index.md"))).toBe(false);
+      globalExpect(import_node_fs.default.existsSync(import_node_path6.default.join(CATALOG_PATH, "events/InventoryAdjusted", "index.md"))).toBe(false);
     });
   });
   describe("rmEventById", () => {
@@ -16399,9 +16513,9 @@ describe("Events SDK", () => {
         summary: "This is a summary",
         markdown: "# Hello world"
       });
-      globalExpect(import_node_fs.default.existsSync(import_node_path5.default.join(CATALOG_PATH, "events/InventoryAdjusted", "index.md"))).toBe(true);
+      globalExpect(import_node_fs.default.existsSync(import_node_path6.default.join(CATALOG_PATH, "events/InventoryAdjusted", "index.md"))).toBe(true);
       await rmEventById2("InventoryAdjusted");
-      globalExpect(import_node_fs.default.existsSync(import_node_path5.default.join(CATALOG_PATH, "events/InventoryAdjusted", "index.md"))).toBe(false);
+      globalExpect(import_node_fs.default.existsSync(import_node_path6.default.join(CATALOG_PATH, "events/InventoryAdjusted", "index.md"))).toBe(false);
     });
     it("removes an event from eventcatalog by id and version", async () => {
       await writeEvent2({
@@ -16411,9 +16525,9 @@ describe("Events SDK", () => {
         summary: "This is a summary",
         markdown: "# Hello world"
       });
-      globalExpect(import_node_fs.default.existsSync(import_node_path5.default.join(CATALOG_PATH, "events/InventoryAdjusted", "index.md"))).toBe(true);
+      globalExpect(import_node_fs.default.existsSync(import_node_path6.default.join(CATALOG_PATH, "events/InventoryAdjusted", "index.md"))).toBe(true);
       await rmEventById2("InventoryAdjusted", "0.0.1");
-      globalExpect(import_node_fs.default.existsSync(import_node_path5.default.join(CATALOG_PATH, "events/InventoryAdjusted", "index.md"))).toBe(false);
+      globalExpect(import_node_fs.default.existsSync(import_node_path6.default.join(CATALOG_PATH, "events/InventoryAdjusted", "index.md"))).toBe(false);
     });
     it("if version is given, only removes that version and not any other versions of the event", async () => {
       await writeEvent2({
@@ -16431,11 +16545,11 @@ describe("Events SDK", () => {
         summary: "This is a summary",
         markdown: "# Hello world"
       });
-      globalExpect(import_node_fs.default.existsSync(import_node_path5.default.join(CATALOG_PATH, "events/InventoryAdjusted", "index.md"))).toBe(true);
-      globalExpect(import_node_fs.default.existsSync(import_node_path5.default.join(CATALOG_PATH, "events/InventoryAdjusted/versioned/0.0.1", "index.md"))).toBe(true);
+      globalExpect(import_node_fs.default.existsSync(import_node_path6.default.join(CATALOG_PATH, "events/InventoryAdjusted", "index.md"))).toBe(true);
+      globalExpect(import_node_fs.default.existsSync(import_node_path6.default.join(CATALOG_PATH, "events/InventoryAdjusted/versioned/0.0.1", "index.md"))).toBe(true);
       await rmEventById2("InventoryAdjusted", "0.0.1");
-      globalExpect(import_node_fs.default.existsSync(import_node_path5.default.join(CATALOG_PATH, "events/InventoryAdjusted", "index.md"))).toBe(true);
-      globalExpect(import_node_fs.default.existsSync(import_node_path5.default.join(CATALOG_PATH, "events/InventoryAdjusted/versioned/0.0.2", "index.md"))).toBe(false);
+      globalExpect(import_node_fs.default.existsSync(import_node_path6.default.join(CATALOG_PATH, "events/InventoryAdjusted", "index.md"))).toBe(true);
+      globalExpect(import_node_fs.default.existsSync(import_node_path6.default.join(CATALOG_PATH, "events/InventoryAdjusted/versioned/0.0.2", "index.md"))).toBe(false);
     });
   });
   describe("versionEvent", () => {
@@ -16448,8 +16562,8 @@ describe("Events SDK", () => {
         markdown: "# Hello world"
       });
       await versionEvent2("InventoryAdjusted");
-      globalExpect(import_node_fs.default.existsSync(import_node_path5.default.join(CATALOG_PATH, "events/InventoryAdjusted/versioned/0.0.2", "index.md"))).toBe(true);
-      globalExpect(import_node_fs.default.existsSync(import_node_path5.default.join(CATALOG_PATH, "events/InventoryAdjusted", "index.md"))).toBe(false);
+      globalExpect(import_node_fs.default.existsSync(import_node_path6.default.join(CATALOG_PATH, "events/InventoryAdjusted/versioned/0.0.2", "index.md"))).toBe(true);
+      globalExpect(import_node_fs.default.existsSync(import_node_path6.default.join(CATALOG_PATH, "events/InventoryAdjusted", "index.md"))).toBe(false);
     });
     it("adds the given event to the versioned directory and all files that are associated to it", async () => {
       await writeEvent2({
@@ -16459,12 +16573,12 @@ describe("Events SDK", () => {
         summary: "This is a summary",
         markdown: "# Hello world"
       });
-      await import_node_fs.default.writeFileSync(import_node_path5.default.join(CATALOG_PATH, "events/InventoryAdjusted", "schema.json"), "SCHEMA!");
+      await import_node_fs.default.writeFileSync(import_node_path6.default.join(CATALOG_PATH, "events/InventoryAdjusted", "schema.json"), "SCHEMA!");
       await versionEvent2("InventoryAdjusted");
-      globalExpect(import_node_fs.default.existsSync(import_node_path5.default.join(CATALOG_PATH, "events/InventoryAdjusted/versioned/0.0.2", "index.md"))).toBe(true);
-      globalExpect(import_node_fs.default.existsSync(import_node_path5.default.join(CATALOG_PATH, "events/InventoryAdjusted/versioned/0.0.2", "schema.json"))).toBe(true);
-      globalExpect(import_node_fs.default.existsSync(import_node_path5.default.join(CATALOG_PATH, "events/InventoryAdjusted", "index.md"))).toBe(false);
-      globalExpect(import_node_fs.default.existsSync(import_node_path5.default.join(CATALOG_PATH, "events/InventoryAdjusted", "schema.json"))).toBe(false);
+      globalExpect(import_node_fs.default.existsSync(import_node_path6.default.join(CATALOG_PATH, "events/InventoryAdjusted/versioned/0.0.2", "index.md"))).toBe(true);
+      globalExpect(import_node_fs.default.existsSync(import_node_path6.default.join(CATALOG_PATH, "events/InventoryAdjusted/versioned/0.0.2", "schema.json"))).toBe(true);
+      globalExpect(import_node_fs.default.existsSync(import_node_path6.default.join(CATALOG_PATH, "events/InventoryAdjusted", "index.md"))).toBe(false);
+      globalExpect(import_node_fs.default.existsSync(import_node_path6.default.join(CATALOG_PATH, "events/InventoryAdjusted", "schema.json"))).toBe(false);
     });
   });
   describe("addFileToEvent", () => {
@@ -16478,7 +16592,7 @@ describe("Events SDK", () => {
         markdown: "# Hello world"
       });
       await addFileToEvent2("InventoryAdjusted", file);
-      globalExpect(import_node_fs.default.existsSync(import_node_path5.default.join(CATALOG_PATH, "events/InventoryAdjusted", "test.txt"))).toBe(true);
+      globalExpect(import_node_fs.default.existsSync(import_node_path6.default.join(CATALOG_PATH, "events/InventoryAdjusted", "test.txt"))).toBe(true);
     });
     it("takes a given file and version and writes the file to the correct location", async () => {
       const file = { content: "hello", fileName: "test.txt" };
@@ -16491,7 +16605,7 @@ describe("Events SDK", () => {
       });
       await versionEvent2("InventoryAdjusted");
       await addFileToEvent2("InventoryAdjusted", file, "0.0.1");
-      globalExpect(import_node_fs.default.existsSync(import_node_path5.default.join(CATALOG_PATH, "events/InventoryAdjusted/versioned/0.0.1", "test.txt"))).toBe(true);
+      globalExpect(import_node_fs.default.existsSync(import_node_path6.default.join(CATALOG_PATH, "events/InventoryAdjusted/versioned/0.0.1", "test.txt"))).toBe(true);
     });
     it("throws an error when trying to write to a event that does not exist", () => {
       const file = { content: "hello", fileName: "test.txt" };
@@ -16520,7 +16634,7 @@ describe("Events SDK", () => {
         markdown: "# Hello world"
       });
       await addSchemaToEvent2("InventoryAdjusted", file);
-      globalExpect(import_node_fs.default.existsSync(import_node_path5.default.join(CATALOG_PATH, "events/InventoryAdjusted", "schema.json"))).toBe(true);
+      globalExpect(import_node_fs.default.existsSync(import_node_path6.default.join(CATALOG_PATH, "events/InventoryAdjusted", "schema.json"))).toBe(true);
     });
     it("takes a given file and version and writes the file to the correct location", async () => {
       const schema = `{
@@ -16544,7 +16658,7 @@ describe("Events SDK", () => {
       });
       await versionEvent2("InventoryAdjusted");
       await addSchemaToEvent2("InventoryAdjusted", file, "0.0.1");
-      globalExpect(import_node_fs.default.existsSync(import_node_path5.default.join(CATALOG_PATH, "events/InventoryAdjusted/versioned/0.0.1", "schema.json"))).toBe(true);
+      globalExpect(import_node_fs.default.existsSync(import_node_path6.default.join(CATALOG_PATH, "events/InventoryAdjusted/versioned/0.0.1", "schema.json"))).toBe(true);
     });
     it("throws an error when trying to write to a event that does not exist", () => {
       const file = { schema: "hello", fileName: "test.txt" };